Skip to content

Commit 3d971ee

Browse files
committed
docs
1 parent e11419d commit 3d971ee

9 files changed

Lines changed: 103 additions & 9 deletions

File tree

.cortexkit/.gitignore

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# >>> cortexkit:magic-context
2+
magic-context/
3+
# <<< cortexkit:magic-context

.gitignore

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,3 +34,7 @@ logs/
3434
tsconfig.tsbuildinfo
3535
/.opencode/magic-context
3636
/coordination_notes
37+
/coordination_notes
38+
coordination_notes/.rate-limits.json
39+
coordination_notes/.pending.json
40+
coordination_notes/.digests.json

.mcp.json

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
{
2+
"mcpServers": {
3+
"codegraph": {
4+
"type": "stdio",
5+
"command": "codegraph",
6+
"args": ["serve", "--mcp"]
7+
}
8+
}
9+
}

.opencode/oh-my-openagent.jsonc

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,58 @@
2626
"agent-harness-0367cd71": {
2727
"access": "allow",
2828
"intent_budget": "plan"
29+
},
30+
"opencode-release-watch-9c1578db": {
31+
"access": "deny",
32+
"intent_budget": "plan"
33+
},
34+
"aft-5fc3f7ed": {
35+
"access": "allow",
36+
"intent_budget": "plan"
37+
},
38+
"anthropic-auth-1369fa0e": {
39+
"access": "allow",
40+
"intent_budget": "plan"
41+
},
42+
"magic-context-6deb493e": {
43+
"access": "allow",
44+
"intent_budget": "plan"
45+
},
46+
"openai-auth-bf478581": {
47+
"access": "allow",
48+
"intent_budget": "plan"
49+
},
50+
"opencode-gemini-ec2cac67": {
51+
"access": "allow",
52+
"intent_budget": "impl"
53+
},
54+
"spacegame-06f6bd29": {
55+
"access": "allow",
56+
"intent_budget": "impl"
57+
},
58+
"unitysupermcp-7b6c0482": {
59+
"access": "allow",
60+
"intent_budget": "plan"
61+
},
62+
"webgameecs-cf2943b8": {
63+
"access": "allow",
64+
"intent_budget": "impl"
65+
},
66+
"rsg-4abd5985": {
67+
"access": "allow",
68+
"intent_budget": "question"
69+
},
70+
"orbital-client-ca4c25a7": {
71+
"access": "allow",
72+
"intent_budget": "question"
73+
},
74+
"art3d-pipeline-6e240ea8": {
75+
"access": "allow",
76+
"intent_budget": "impl"
77+
},
78+
"opencode-release-watch-4543544f": {
79+
"access": "allow",
80+
"intent_budget": "plan"
2981
}
3082
}
3183
}

AGENTS.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,11 +32,13 @@ Run `bun typecheck` from `packages/opencode` (never `tsc` directly) before build
3232

3333
`@cortexkit/orw` runs at `~/opencode-release-watch/` via launchd (30-min poll). On each new upstream release it AI-merges `fork/local` onto the release tag using `claude-opus-4-8`, builds a native CLI (TUI/web only — desktop disabled), and auto-installs to `~/.opencode/bin/opencode`. `~/.opencode/bin/opencode` is prepended to PATH and takes precedence — `which opencode` resolves here. `/opt/homebrew/bin/opencode` holds the vanilla upstream Homebrew version as a manual fallback only.
3434

35-
After pushing new commits to `fork/local` with no upstream release, trigger a rebuild manually:
35+
After pushing new commits to `fork/local` with no upstream release, trigger a rebuild manually through the hardened wrapper — **never** call `bunx @cortexkit/orw check` directly (that bypasses the independent smoke gate and is what shipped the broken v1.18.2 `plugin-not-defined` build):
3636
```bash
37-
cd ~/opencode-release-watch && bunx @cortexkit/orw check --force
37+
cd ~/opencode-release-watch && run/orw-check check --force
3838
```
3939

40+
The wrapper pins the ORW version, refuses to run unless `install_cli=false`, and independently verifies the built artifact (exact `--version` match + isolated `GET /agent` HTTP 200 smoke on an ephemeral port with temp XDG dirs) before ever reporting success. To re-verify the artifact already recorded in state without rebuilding, run `run/orw-check verify`.
41+
4042
Operator runbook: `agent-harness/docs/runbooks/OpenCode-Release-Watcher.md`
4143

4244
## Commits and PR Titles

README.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -78,8 +78,13 @@ packages/opencode/dist/opencode-<platform>/bin/opencode
7878
Uses [`@cortexkit/orw`](https://github.com/cortexkit/orw) to stay current with upstream releases. Polls every 30 min, AI-merges `fork/local` onto each new release tag, builds a native CLI, and installs automatically.
7979

8080
```bash
81-
# Manual check/build
82-
cd ~/opencode-release-watch && bunx @cortexkit/orw check --force
81+
# Manual check/build — routes through the hardened wrapper, which independently
82+
# verifies the artifact (version match + isolated GET /agent smoke) before
83+
# reporting success. Never call `bunx @cortexkit/orw check` directly.
84+
cd ~/opencode-release-watch && run/orw-check check --force
85+
86+
# Re-verify the artifact already recorded in state (no rebuild)
87+
cd ~/opencode-release-watch && run/orw-check verify
8388

8489
# Rollback
8590
~/opencode-release-watch/rollback.sh

coordination_notes/.digests.json

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
{
22
"entries": [
33
{
4-
"key": "agent-harness-0367cd71:opencode-228cc625:53804f35-6e33-4a1d-81b3-cf03342c2ef8:f8fff472e0685a930d9b1a659a3026121f400e00fb536eba370c4c6cc482ab9b",
5-
"digest": "f8fff472e0685a930d9b1a659a3026121f400e00fb536eba370c4c6cc482ab9b",
6-
"fromProjectId": "agent-harness-0367cd71",
4+
"key": "opencode-gemini-ec2cac67:opencode-228cc625:9ab8bcfc-3652-4df0-9cfa-49f5320d1d53:b33b8b64ac8428db2683af9c81f1fa861ac40e635c1621246cf138fc081f46e4",
5+
"digest": "b33b8b64ac8428db2683af9c81f1fa861ac40e635c1621246cf138fc081f46e4",
6+
"fromProjectId": "opencode-gemini-ec2cac67",
77
"toProjectId": "opencode-228cc625",
8-
"correlationId": "53804f35-6e33-4a1d-81b3-cf03342c2ef8",
9-
"recordedAt": 1783928161623,
8+
"correlationId": "9ab8bcfc-3652-4df0-9cfa-49f5320d1d53",
9+
"recordedAt": 1784398133565,
1010
"ttlMs": 3600000
1111
}
1212
]

coordination_notes/.pending.json

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,20 @@
1313
"reservedPath": "/Volumes/Topper2TB/Git/opencode/coordination_notes/agent-harness-0367cd71/.delivering-128aef5a-7947-41f3-98b1-bdf9013989dd.md",
1414
"dispatchedAt": 1783928162173,
1515
"state": "history_confirmed"
16+
},
17+
{
18+
"messageId": "49bf3b02-3415-41f3-b7e8-f0ae23866a8b",
19+
"sessionId": "ses_08a09462cffeAASqrV4J87MvcD",
20+
"reservedPath": "/Volumes/Topper2TB/Git/opencode/coordination_notes/opencode-gemini-ec2cac67/.delivering-49bf3b02-3415-41f3-b7e8-f0ae23866a8b.md",
21+
"dispatchedAt": 1784390535951,
22+
"state": "history_confirmed"
23+
},
24+
{
25+
"messageId": "17e5cd0d-a8ec-409c-98d4-118d435d3fa6",
26+
"sessionId": "ses_08a09462cffeAASqrV4J87MvcD",
27+
"reservedPath": "/Volumes/Topper2TB/Git/opencode/coordination_notes/opencode-gemini-ec2cac67/.delivering-17e5cd0d-a8ec-409c-98d4-118d435d3fa6.md",
28+
"dispatchedAt": 1784398133737,
29+
"state": "history_confirmed"
1630
}
1731
]
1832
}

coordination_notes/.rate-limits.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,11 @@
44
"pairKey": "agent-harness-0367cd71:opencode-228cc625",
55
"count": 2,
66
"windowStart": 1783928146907
7+
},
8+
{
9+
"pairKey": "opencode-gemini-ec2cac67:opencode-228cc625",
10+
"count": 1,
11+
"windowStart": 1784398133564
712
}
813
]
914
}

0 commit comments

Comments
 (0)