release: v0.2.0 reliability, portability, and observability

.github/workflows/cross-platform.yml

@@ -0,0 +1,88 @@
+name: Cross-platform runtime
+
+on:
+  pull_request:
+    branches: [main, master]
+  push:
+    branches: [main, master]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  portable-runtime:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        node-version: [20, 22]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+      - run: npm ci
+      - name: Validate routing policy
+        run: npm run validate:routing
+      - name: Validate budget policy
+        run: npm run validate:budget
+      - name: Validate feature contract
+        run: npm run validate:feature
+      - name: Validate documentation links
+        run: node scripts/check-doc-links.mjs
+      - name: Test v0.2 reliability features
+        run: node tests/reliability-v020-tests.mjs
+      - name: Test budget enforcement
+        run: node tests/budget-tests.mjs
+      - name: Test budget edge cases
+        run: node tests/budget-audit-tests.mjs
+      - name: Test routing
+        run: node tests/routing-tests.mjs
+      - name: Test runtime
+        shell: bash
+        run: |
+          set +e
+          node tests/runtime-tests.mjs 2>&1 | tee runtime-test.log
+          status=${PIPESTATUS[0]}
+          set -e
+          exit "$status"
+      - name: Upload runtime-test diagnostics
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: runtime-test-${{ matrix.os }}-node-${{ matrix.node-version }}
+          path: runtime-test.log
+      - name: Test plugin integration
+        run: node tests/tool-integration-tests.mjs
+      - name: Test bypass detection
+        run: node tests/bypass-detection.mjs
+      - name: Test installer in POSIX shell
+        shell: bash
+        run: |
+          set -euo pipefail
+          test_home="$PWD/.installer-test-home"
+          test_bin="$PWD/.installer-test-bin"
+          mkdir -p "$test_home" "$test_bin"
+          : > "$test_home/.bashrc"
+          cat > "$test_bin/opencode" <<'EOF'
+          #!/usr/bin/env bash
+          exit 0
+          EOF
+          chmod +x "$test_bin/opencode"
+          HOME="$test_home" PATH="$test_bin:$PATH" bash scripts/install.sh
+          grep -F 'OPENCODE_CONFIG_DIR=' "$test_home/.bashrc"
+          rm -rf "$test_home" "$test_bin"
+
+  bash-installation:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npm run validate

.github/workflows/opencode-patch-compat.yml

@@ -0,0 +1,140 @@
+name: OpenCode patch compatibility
+
+on:
+  pull_request:
+    branches: [main, master]
+    paths:
+      - patches/opencode-subagent-failure-exposure.patch
+      - config/supported-opencode.json
+      - scripts/check-opencode-patch-contract.mjs
+      - .github/workflows/opencode-patch-compat.yml
+  workflow_dispatch:
+    inputs:
+      opencode_ref:
+        description: Optional OpenCode branch, tag, or commit. Empty uses the pinned supported revision.
+        required: false
+        default: ''
+  schedule:
+    - cron: '23 6 * * 1'
+
+permissions:
+  contents: read
+
+jobs:
+  supported-compatibility:
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+    steps:
+      - name: Check out agent loop
+        uses: actions/checkout@v4
+
+      - name: Resolve supported revision
+        id: supported
+        shell: bash
+        env:
+          REQUESTED_REF: ${{ inputs.opencode_ref }}
+        run: |
+          set -euo pipefail
+          configured_ref=$(node -e "const fs=require('fs'); const value=JSON.parse(fs.readFileSync('config/supported-opencode.json','utf8')); process.stdout.write(value.ref)")
+          selected_ref=${REQUESTED_REF:-$configured_ref}
+          echo "ref=$selected_ref" >> "$GITHUB_OUTPUT"
+          echo "Testing OpenCode revision $selected_ref"
+
+      - name: Check out supported OpenCode
+        uses: actions/checkout@v4
+        with:
+          repository: anomalyco/opencode
+          ref: ${{ steps.supported.outputs.ref }}
+          path: upstream-opencode
+          fetch-depth: 1
+
+      - name: Verify patch applies
+        working-directory: upstream-opencode
+        run: git apply --check ../patches/opencode-subagent-failure-exposure.patch
+
+      - name: Apply patch
+        working-directory: upstream-opencode
+        run: git apply ../patches/opencode-subagent-failure-exposure.patch
+
+      - name: Set up Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: '1.3.14'
+
+      - name: Install upstream dependencies
+        working-directory: upstream-opencode
+        run: bun install --frozen-lockfile
+
+      - name: Build native standalone OpenCode
+        working-directory: upstream-opencode
+        shell: bash
+        run: |
+          set +e
+          bun ./packages/opencode/script/build.ts --single --skip-install --skip-embed-web-ui 2>&1 | tee ../opencode-build.log
+          status=${PIPESTATUS[0]}
+          set -e
+          exit "$status"
+
+      - name: Verify patched source contracts
+        run: node scripts/check-opencode-patch-contract.mjs upstream-opencode
+
+      - name: Record tested revision
+        if: always()
+        shell: bash
+        run: |
+          git -C upstream-opencode rev-parse HEAD > opencode-tested-revision.txt
+          printf 'requested_ref=%s\n' '${{ steps.supported.outputs.ref }}' >> opencode-tested-revision.txt
+          printf 'tested_at=%s\n' "$(date -u +%FT%TZ)" >> opencode-tested-revision.txt
+
+      - name: Upload compatibility evidence
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: opencode-supported-compatibility
+          path: |
+            opencode-tested-revision.txt
+            opencode-build.log
+
+  upstream-dev-probe:
+    if: github.event_name != 'workflow_dispatch' || inputs.opencode_ref == ''
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/checkout@v4
+        with:
+          repository: anomalyco/opencode
+          ref: dev
+          path: upstream-opencode-dev
+          fetch-depth: 1
+      - name: Probe patch against moving dev branch
+        id: probe
+        working-directory: upstream-opencode-dev
+        shell: bash
+        run: |
+          set +e
+          git apply --check ../patches/opencode-subagent-failure-exposure.patch > ../opencode-dev-patch-check.txt 2>&1
+          status=$?
+          set -e
+          if [ "$status" -eq 0 ]; then
+            echo "compatible=true" >> "$GITHUB_OUTPUT"
+            echo "### Upstream dev probe: compatible" >> "$GITHUB_STEP_SUMMARY"
+          else
+            echo "compatible=false" >> "$GITHUB_OUTPUT"
+            echo "### Upstream dev probe: patch rebase needed" >> "$GITHUB_STEP_SUMMARY"
+            echo "The pinned supported revision remains the release target. See the uploaded probe artifact for details." >> "$GITHUB_STEP_SUMMARY"
+          fi
+          exit 0
+      - name: Record upstream revision
+        if: always()
+        shell: bash
+        run: |
+          git -C upstream-opencode-dev rev-parse HEAD > opencode-dev-probe.txt
+          printf 'patch_compatible=%s\n' '${{ steps.probe.outputs.compatible }}' >> opencode-dev-probe.txt
+          cat opencode-dev-patch-check.txt >> opencode-dev-probe.txt
+      - name: Upload upstream probe evidence
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: opencode-dev-probe
+          path: opencode-dev-probe.txt

.gitignore

@@ -55,6 +55,7 @@ Thumbs.db
 !.opencode/command/feature.md
 .opencode/node_modules/
 .opencode/agent-loop-logs/
+.opencode/agent-loop-state/
 *.bak
 
 # Benchmark output (gitignored temp location)

.opencode/plugins/agent-loop.js

@@ -40,6 +40,7 @@ function concise(result) {
     review: result.review,
     requiresUserInput: result.requiresUserInput === true,
     logPath: result.logPath,
+    eventLogPath: result.eventLogPath || undefined,
     budget: result.budget || undefined,
     steps
   };
@@ -52,10 +53,10 @@ export default async function AgentLoopPlugin() {
         description: 'Run the OpenCode agent-loop runtime for a development task. Use for non-trivial build/test/review work; do not use for simple questions.',
         args: {
           task: tool.schema.string().min(1).describe('The complete user request to run through the agent loop.'),
-          mode: tool.schema.enum(['build', 'test', 'review', 'smoke', 'escalate']).optional().describe('Which role to run: build, test, review, smoke (model test), or escalate (GPT-5.5 diagnosis)'),
-          maxRetries: tool.schema.number().int().min(0).max(5).optional().describe('Maximum task-level retry cycles. Provider failover is handled separately.'),
+          mode: tool.schema.enum(['build', 'test', 'review', 'smoke', 'escalate']).optional().describe('Which role to run: build, test, review, smoke (model test), or escalate (GPT-5.6 diagnosis)'),
+          maxRetries: tool.schema.number().int().min(0).max(5).optional().describe('Maximum same-model retries for transient failures. Provider failover begins after these retries are exhausted.'),
           models: tool.schema.array(tool.schema.string()).optional().describe('Pre-verified model IDs from a prior smoke call to restrict which models are used.'),
-          taskId: tool.schema.string().min(1).max(128).optional().describe('Stable task ID used to share token and cost budgets across build, test, and review calls.')
+          taskId: tool.schema.string().min(1).max(128).optional().describe('Stable task ID used to share token and cost budgets across smoke, build, test, review, fix, and escalation calls.')
         },
         async execute(args, context) {
           if (process.env.AGENT_LOOP_CHILD === '1') {
@@ -89,7 +90,7 @@ export default async function AgentLoopPlugin() {
             const result = await runAgentLoop({
               task,
               mode: args.mode || 'build',
-              maxRetries: args.maxRetries || 0,
+              maxRetries: args.maxRetries,
               cwd: context.directory,
               parentSessionId: context.sessionID,
               signal: context.abort,

CHANGELOG.md

@@ -2,18 +2,41 @@
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-07-22
+
 ### Added
 
-- Added configurable per-task token and cost budgets with live OpenCode usage tracking, model-registry pricing estimates, failover interruption, and structured budget output. Closes #4.
-- Added the referenced free-first configuration schema and automated budget/feature contract validation.
-- Added bounded in-memory budget-ledger retention with configurable TTL and task-count limits.
+- Added configurable token, cost, and workflow-call budgets shared by one stable task ID.
+- Added atomic budget persistence across OpenCode and plugin restarts with TTL and task-count retention limits.
+- Added same-model transient retries with exponential backoff and jitter before provider failover.
+- Added provider adapters for provider identity, aliases, timeout selection, local-model recognition, and error normalization.
+- Added a custom provider-adapter example and extension documentation.
+- Added a versioned structured event schema, append-only JSONL event stream, recursive redaction, and query utility. Closes #5.
+- Added Linux, macOS, Windows, WSL, and Git Bash guidance plus a cross-platform Node CI matrix. Closes #6.
+- Added scheduled and manually configurable patched-OpenCode compatibility builds.
+- Added portable task-checkpoint paths.
+- Added a workflow-call ceiling and reduced parent-orchestrator turn cap.
+- Added v0.2 configuration, event, feature-contract, and reliability validation.
+
+### Changed
+
+- Routed every `/feature` worker stage through the budget-enforced `agent_loop` tool.
+- Moved provider-specific runtime behavior behind the provider-adapter interface. Closes #7.
+- Updated runtime state layout under `.opencode/agent-loop-state/`.
+- Updated package and policy schema versions to 0.2.0 and 2.0.0 respectively.
+- Updated architecture, configuration, platform, troubleshooting, event, and provider documentation.
 
 ### Fixed
 
-- Treat local-unmetered models as zero-cost and account for a final usage event even when the JSON stream has no trailing newline.
-- Route `/feature` delegation through the budget-enforced `agent_loop` tool and require one stable task ID across all stages.
-- Continue recording usage emitted during worker shutdown after a budget-triggered termination.
-- Mark budget totals explicitly as delegated-worker scope so parent-orchestrator usage is not misrepresented.
+- Made the public `maxRetries` option perform actual same-model retries for transient failures.
+- Corrected timeout selection for local/Ollama model IDs without a slash.
+- Removed the hardcoded `/usr/local/bin/opencode` executable path so PATH resolution works across operating systems.
+- Treat local-unmetered models as zero-cost.
+- Account for final usage events emitted without a trailing newline or during budget-triggered shutdown.
+- Stop retries, failover, and escalation immediately after `BUDGET_EXCEEDED`.
+- Prevent replacement task IDs from being used to evade an exhausted feature budget.
+- Strengthened recursive redaction for structured event and attempt logs.
+- Clarified that exact parent-orchestrator token and dollar usage is unavailable, while parent workflow calls and turns are bounded.
 
 ## [0.1.1] - 2026-07-22