Repository navigation
Commit 99c14e2
committed
docs(opencode): record which build the fleet runs, and why not opencode2
The choice of the Homebrew stable line over the opencode2 nightly was made
2026-08-19 and never written down. CLA-381 captured the incident that prompted
it - a Transport stream error from nightly 0.0.0-next-17403 exiting 1 and
stopping the whole daemon - but not the decision, so a day later the question
"opencode or opencode2?" had to be re-derived from PATH, doctor and finally
opencode's own session log.
Records four things that existed only on the filesystem or in people's heads:
- the adapter execs a bare `opencode`, so PATH decides and switching builds is
a code change, not a setting;
- which build ran is read off opencode's own `version=` log line, never
inferred from PATH;
- `~/.config/clankerbar/bin/opencode` is an abandoned symlink to opencode2,
inert only because that directory is on nobody's PATH;
- the stable line has its own defect (anomalyco/opencode#43622) that makes a
session exit 0 having produced nothing, which is what our dead implement
phases were, and upgrading within 1.18.x does not escape it.
No decision record exists for the switch back to stable, so the page states
that in as many words and marks its rationale as reconstructed from CLA-381,
noting that CLA-381's note warns about both builds rather than endorsing
stable. It is correctable by whoever made the call.
Also repoints two stale signposts for the quiet-death signature, both of which
sent readers to the tool-schema page: the README's docs index AND its in-body
paragraph, which additionally called the signature "opencode-go" when CLA-401
disconfirmed the gateway. The tool-schema page's own closing section still
presented that gateway hypothesis as live, so it now records it as closed and
points at the client defect instead.1 parent 3bd65a3 commit 99c14e2
3 files changed
Lines changed: 98 additions & 10 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
940 | 940 | | |
941 | 941 | | |
942 | 942 | | |
943 | | - | |
944 | | - | |
945 | | - | |
946 | | - | |
| 943 | + | |
| 944 | + | |
| 945 | + | |
| 946 | + | |
| 947 | + | |
| 948 | + | |
947 | 949 | | |
948 | 950 | | |
949 | 951 | | |
| |||
1147 | 1149 | | |
1148 | 1150 | | |
1149 | 1151 | | |
1150 | | - | |
| 1152 | + | |
| 1153 | + | |
1151 | 1154 | | |
1152 | 1155 | | |
1153 | 1156 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
103 | 103 | | |
104 | 104 | | |
105 | 105 | | |
106 | | - | |
107 | | - | |
108 | | - | |
109 | | - | |
110 | | - | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
111 | 114 | | |
0 commit comments