this repo has no description
Update blackbox test instructions for Elixir appview [CL-290]
Replace section 8 (AppView tests) with Docker-based setup matching
the new Elixir/Phoenix appview. Remove TOML config, --config-dir flags,
and SQLite references.
+22
-60
+21
-60
AGENT-BLACKBOX-TEST.md
+21
-60
AGENT-BLACKBOX-TEST.md
···
590
590
591
591
## 8. AppView
592
592
593
-
The AppView is a separate binary (`opake-appview`) that indexes grants and keyrings from the AT Protocol firehose. These tests require a running Jetstream instance or network access to the public Jetstream relays.
594
-
595
-
### 8.1 Configuration
593
+
The AppView is an Elixir/Phoenix service (`appview/`) that indexes grants and keyrings from the AT Protocol firehose. These tests require Docker (for PostgreSQL) or a running Postgres instance.
596
594
597
-
Create a minimal config:
595
+
### 8.1 Start AppView (Docker)
598
596
599
597
```bash
600
-
cat > /tmp/opake-appview-test/appview.toml <<EOF
601
-
jetstream_url = "wss://jetstream2.us-east.bsky.network/subscribe"
602
-
listen = "127.0.0.1:6100"
603
-
db_path = "/tmp/opake-appview-test/appview.db"
604
-
EOF
598
+
cd appview
599
+
docker compose --profile full up --build -d
600
+
# Entrypoint auto-creates DB and runs migrations
601
+
sleep 5
605
602
```
606
603
607
-
### 8.2 Status (cold start)
608
-
609
-
```bash
610
-
opake-appview --config-dir /tmp/opake-appview-test status
611
-
# Cursor: (none — indexer has not run)
612
-
# Grants: 0
613
-
# Keyrings: 0
614
-
```
615
-
616
-
### 8.3 Start indexer + API
617
-
618
-
```bash
619
-
opake-appview --config-dir /tmp/opake-appview-test run -v &
620
-
APPVIEW_PID=$!
621
-
sleep 3
622
-
```
623
-
624
-
**Verify:**
625
-
- Logs show "opake-appview listening on 127.0.0.1:6100"
626
-
- Logs show Jetstream connection established
627
-
628
-
### 8.4 Health endpoint
604
+
### 8.2 Health endpoint
629
605
630
606
```bash
631
607
curl -s http://127.0.0.1:6100/api/health | jq .
···
640
616
- `indexerConnected` is `true`
641
617
- `cursorAgeSecs` is small (< 60)
642
618
643
-
### 8.5 Inbox and keyrings require auth
619
+
### 8.3 Inbox and keyrings require auth
644
620
645
621
```bash
646
622
curl -s -o /dev/null -w '%{http_code}' http://127.0.0.1:6100/api/inbox?did=did:plc:test
···
650
626
# 401
651
627
```
652
628
653
-
### 8.6 Share triggers indexing
629
+
### 8.4 Share triggers indexing
654
630
655
631
With the AppView still running, create a share grant using the CLI (from section 4.2):
656
632
···
660
636
661
637
Wait a few seconds for the firehose to deliver the event.
662
638
663
-
```bash
664
-
opake-appview --config-dir /tmp/opake-appview-test status
665
-
# Grants: should be ≥ 1
666
-
```
667
-
668
-
### 8.7 Status (after indexing)
669
-
670
-
```bash
671
-
opake-appview --config-dir /tmp/opake-appview-test status
672
-
# Cursor: 2026-03-02T...
673
-
# Lag: <small number>s
674
-
# Grants: <non-zero>
675
-
# Keyrings: <number>
676
-
```
677
-
678
-
### 8.8 Config dir matches CLI
679
-
680
-
Both binaries should resolve the same config directory:
639
+
### 8.5 Status (after indexing)
681
640
682
641
```bash
683
-
# Both use OPAKE_DATA_DIR
684
-
OPAKE_DATA_DIR=/tmp/opake-appview-test opake-appview status
685
-
# should find /tmp/opake-appview-test/appview.toml
686
-
687
-
# --config-dir flag works the same way
688
-
opake-appview --config-dir /tmp/opake-appview-test status
642
+
docker compose exec appview bin/opake_appview eval "OpakeAppview.Release.status()"
643
+
# Cursor:
644
+
# Position: ...
645
+
# Time: 2026-...
646
+
# Lag: <small number>s
647
+
# Counts:
648
+
# Grants: <non-zero>
649
+
# Keyrings: <number>
689
650
```
690
651
691
-
### 8.9 Cleanup
652
+
### 8.6 Cleanup
692
653
693
654
```bash
694
-
kill $APPVIEW_PID 2>/dev/null
695
-
rm -rf /tmp/opake-appview-test
655
+
cd appview
656
+
docker compose --profile full down -v
696
657
```
697
658
698
659
---
+1
CHANGELOG.md
+1
CHANGELOG.md
···
12
12
- Remove bearer token authentication fallback from AppView [#26](https://issues.opake.app/issues/26.html)s
13
13
14
14
### Added
15
+
- Rewrite opake-appview in Elixir/Phoenix with PostgreSQL [#290](https://issues.opake.app/issues/290.html)
15
16
- Add web sharing UI with grant management [#149](https://issues.opake.app/issues/149.html)
16
17
- Add user banner to profile dropdown and cache profile images in IndexedDB [#288](https://issues.opake.app/issues/288.html)
17
18
- Add split-panel preview, UI cleanup, and fix document name flicker [#286](https://issues.opake.app/issues/286.html)