opencode-autoresearch 3.1.0 → 3.3.1

package/skills/autoresearch/references/self-improve-loop.md

@@ -0,0 +1,255 @@
+# Self-Improvement Loop
+
+Use this reference when Auto Research should run on its own codebase or when setting up long-running recursive improvement cycles.
+
+## Overview
+
+The self-improvement loop is a **meta-orchestration layer** that sits above the standard improve-verify loop. It enables Auto Research to iteratively improve itself, its documentation, its test coverage, or any other measurable property of the autoresearch repository.
+
+```mermaid
+flowchart TD
+    subgraph Meta["Meta-Orchestrator"]
+        M1[Define Meta-Goal] --> M2[Spawn Child Loop]
+        M2 --> M3[Evaluate Child Result]
+        M3 --> M4{Child Succeeded?}
+        M4 -->|yes| M5[Extract Patterns]
+        M4 -->|no| M6[Adapt Strategy]
+        M5 --> M7[Update Memory]
+        M6 --> M2
+        M7 --> M8{Meta Stop?}
+        M8 -->|no| M2
+        M8 -->|yes| M9[Final Meta-Report]
+    end
+
+    subgraph Child["Child Loop (Standard AR)"]
+        C1[Baseline] --> C2[Iterate]
+        C2 --> C3[Verify]
+        C3 --> C4{Keep?}
+        C4 -->|yes| C5[Record]
+        C4 -->|no| C6[Discard]
+        C5 --> C7{Stop?}
+        C6 --> C7
+        C7 -->|no| C2
+        C7 -->|yes| C8[Child Report]
+    end
+
+    M2 -.->|launches| C1
+    C8 -.->|feeds into| M3
+```
+
+## Activation Contract
+
+When invoked for self-improvement:
+
+1. Read `references/core-principles.md`
+2. Read `references/loop-workflow.md`
+3. Read `references/subagent-orchestration.md`
+4. Read this document (`references/self-improve-loop.md`)
+5. Read `references/state-management.md` for artifact semantics
+6. Read `references/results-logging.md` for record format
+
+## Meta-Goal Definition
+
+The meta-goal must be measurable and bounded:
+
+- **Target**: What property of autoresearch should improve?
+- **Metric**: Numeric measurement (e.g., test coverage %, doc completeness score)
+- **Direction**: `lower` or `higher`
+- **Verify**: Mechanical command that measures the metric
+- **Guard**: Command that catches regressions in core functionality
+- **Scope**: Which files/subsystems are in scope
+
+### Example Meta-Goals
+
+```bash
+# Improve documentation coverage
+autoresearch init \
+  --goal "All public APIs have documentation" \
+  --metric "doc_coverage_pct" \
+  --direction "higher" \
+  --verify "node scripts/measure-doc-coverage.js" \
+  --guard "npm run typecheck && npm run build"
+
+# Improve test coverage
+autoresearch init \
+  --goal "Increase branch coverage" \
+  --metric "branch_coverage" \
+  --direction "higher" \
+  --verify "npm run test:coverage" \
+  --guard "npm test"
+
+# Reduce complexity
+autoresearch init \
+  --goal "Reduce cyclomatic complexity" \
+  --metric "avg_complexity" \
+  --direction "lower" \
+  --verify "npx complexity-report src/" \
+  --guard "npm test"
+```
+
+## Recursive Loop Phases
+
+### Phase 1: Meta-Setup
+
+1. Define meta-goal, metric, direction, verify, guard, and scope.
+2. Baseline the current state of the autoresearch repository.
+3. Initialize `autoresearch-memory.md` with known patterns and strategies.
+4. Set iteration cap and wall-clock duration for the meta-loop.
+5. Determine child loop parameters (iterations per child, stop conditions).
+
+### Phase 2: Child Loop Execution
+
+Each child loop is a standard Auto Research run:
+
+1. Inherit meta-goal as child goal.
+2. Run the standard improve-verify loop for N iterations or until child stop condition.
+3. Produce child report: iterations, keeps, discards, best metric, patterns found.
+
+### Phase 3: Meta-Evaluation
+
+After each child loop completes:
+
+1. Evaluate child success: Did metric improve? Were there regressions?
+2. Extract reusable patterns from child results.
+3. Update strategy based on pattern analysis.
+4. Decide: spawn another child, adapt approach, or meta-stop.
+
+### Phase 4: Memory Update
+
+Persist learnings across meta-iterations:
+
+1. Append successful patterns to `autoresearch-memory.md`.
+2. Update `.autoresearch/state.json` with meta-run progress.
+3. Record meta-iteration in `autoresearch-results.tsv` with `meta:` prefix.
+
+## Memory Format
+
+The memory file tracks patterns that persist across runs:
+
+```markdown
+# Auto Research Memory
+
+## Successful Patterns
+
+### Pattern: Incremental doc improvements
+- Context: Adding mermaid diagrams to README
+- Approach: One diagram per iteration, verify render
+- Result: 3/3 kept, no regressions
+- Confidence: high
+
+### Pattern: Test-first for new features
+- Context: Adding self-improvement loop
+- Approach: Write test, implement, verify
+- Result: 5/7 kept, 2 discards due to edge cases
+- Confidence: medium
+
+## Failed Approaches
+
+### Approach: Large rewrite of state manager
+- Context: Trying to simplify run-manager.ts
+- Result: 0/3 kept, multiple guard failures
+- Lesson: Prefer incremental changes over rewrites
+
+## Strategy Recommendations
+
+- For docs: incremental, one section per iteration
+- For tests: test-first, small units
+- For refactoring: typecheck-first, then test
+```
+
+## Meta-Stop Conditions
+
+Stop the recursive loop when:
+
+1. **Goal met**: Metric reaches target threshold.
+2. **Diminishing returns**: N consecutive child loops with no improvement.
+3. **Iteration cap**: Meta-iteration cap reached.
+4. **Duration elapsed**: Wall-clock cap exceeded.
+5. **User request**: Explicit stop requested.
+6. **Needs human**: Child loop surfaces blocker requiring human input.
+
+## Meta-Iteration Record Format
+
+Meta-iterations are recorded with a `meta:` prefix in the results log:
+
+```tsv
+timestamp	iteration	decision	metric_value	verify_status	guard_status	hypothesis	change_summary	labels	note
+2024-01-15T10:00:00Z	meta:001	keep	68.5	pass	pass	strategy:incremental_docs	Child loop 001 completed with 5/7 kept	doc,meta	Pattern: one diagram per iteration
+```
+
+## Background Self-Improvement
+
+For overnight or long-running self-improvement:
+
+```bash
+autoresearch init \
+  --goal "Improve AutoResearch documentation and test coverage" \
+  --metric "combined_score" \
+  --direction "higher" \
+  --verify "node scripts/combined-score.js" \
+  --guard "npm run typecheck && npm test" \
+  --mode "background" \
+  --iterations "50" \
+  --duration "8h" \
+  --scope "src/,docs/,wiki/,skills/"
+
+autoresearch launch
+```
+
+The background supervisor (`autoresearch status`) will:
+
+1. Check child loop status periodically.
+2. Spawn new child loops when previous ones complete.
+3. Stop if meta-stop conditions are met.
+4. Resume from `.autoresearch/state.json` on restart.
+
+## Safety
+
+Self-improvement loops have additional guardrails:
+
+1. **Scope enforcement**: Only modify files within declared scope.
+2. **Guard command**: Must pass before any keep decision.
+3. **Backup state**: Archive `.autoresearch/state.json` before each meta-iteration.
+4. **Human checkpoint**: Optional `needs_human` flag after N meta-iterations.
+5. **Rollback strategy**: Documented in memory for each pattern.
+
+## Subagent Pool for Self-Improvement
+
+The standing pool for self-improvement includes:
+
+| Role | Purpose |
+| --- | --- |
+| `meta_orchestrator` | Owns meta-goal and child loop decisions |
+| `child_orchestrator` | Runs standard loop within child context |
+| `pattern_analyst` | Extracts patterns from child results |
+| `strategy_advisor` | Recommends tactic changes |
+| `regression_guard` | Extra verification for self-modification |
+| `doc_reviewer` | Reviews documentation changes |
+| `test_designer` | Designs tests for new functionality |
+
+## Example Full Recursive Session
+
+```text
+$ autoresearch init --goal "Improve README and add mermaid diagrams" \
+  --metric "doc_completeness" --direction higher \
+  --verify "node scripts/score-docs.js" --mode background
+
+[meta-001] Child loop launched: 10 iterations
+[child-001] Baseline: doc_completeness = 42
+[child-001] iter 001: keep (diagram added, score 48)
+[child-001] iter 002: keep (diagram added, score 53)
+[child-001] iter 003: discard (diagram broken)
+[child-001] iter 004: keep (diagram fixed, score 55)
+...
+[child-001] Complete: 7/10 kept, best score 61
+
+[meta-001] Pattern: SVG diagrams > mermaid for banners
+[meta-001] Pattern: One section per iteration is optimal
+[meta-002] Strategy adapted: Focus on wiki next
+[meta-002] Child loop launched: 10 iterations
+...
+
+[meta-stop] Goal threshold reached (80/100)
+[meta-complete] Report: autoresearch-report.md
+[meta-complete] Memory: autoresearch-memory.md
+```

package/skills/autoresearch/references/state-management.md

@@ -1,6 +1,6 @@
 # State Management
 
-`autoresearch-state.json` is the run checkpoint.
+`.autoresearch/state.json` is the run checkpoint.
 
 ## Core Fields
 
@@ -28,7 +28,7 @@
 
 ## Resume Semantics
 
-- `python scripts/autoresearch_runtime_ctl.py resume` clears `stop_requested` and marks the background run active again.
+- `autoresearch resume` clears `stop_requested` and marks the background run active again.
 - Resume does not create a new run; it continues the existing state snapshot.
 - Resume should re-anchor the standing pool with the latest metric, last iteration, and active role guidance before the next handoff.
 - Completed runs are not resumable; return to the previous state by starting a new run.
@@ -36,4 +36,4 @@
 
 ## Completion Semantics
 
-- `python scripts/autoresearch_runtime_ctl.py complete` moves a background run to `completed`, clears `background_active`, and ends the detached session lifecycle.
+- `autoresearch complete` moves a background run to `completed`, clears `background_active`, and ends the detached session lifecycle.

package/skills/autoresearch/references/subagent-orchestration.md

@@ -26,7 +26,7 @@ Use this reference when a run should be subagent-first.
 
 ## State Ownership
 
-- Only the orchestrator records iterations, mutates `autoresearch-state.json`, and decides whether the latest step is `keep`, `discard`, or `needs_human`.
+- Only the orchestrator records iterations, mutates `.autoresearch/state.json`, and decides whether the latest step is `keep`, `discard`, or `needs_human`.
 - Subagents may disagree, critique, or verify, but their output is supporting evidence.
 - If several subagents contribute to one change, roll that evidence into one orchestrator-owned iteration result.
 

package/dist/complete.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=complete.d.ts.map

package/dist/complete.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../src/complete.ts"],"names":[],"mappings":""}

package/dist/complete.js

@@ -1,36 +0,0 @@
-import { completeRun, buildSupervisorSnapshot } from "./run-manager.js";
-import { resolvePath, printJson } from "./helpers.js";
-import { REPORT_DEFAULT } from "./constants.js";
-import { writeFileSync } from "fs";
-async function main() {
-    const args = process.argv.slice(2);
-    const get = (name) => args[args.indexOf(`--${name}`) + 1] ?? undefined;
-    try {
-        const state = await completeRun(get("repo"), get("state-path"));
-        printJson({ status: "completed", run_id: state.run_id });
-        const reportPath = resolvePath(get("repo") ?? ".", get("report-path"), REPORT_DEFAULT);
-        await buildSupervisorSnapshot(get("repo"), get("results-path"), get("state-path"));
-        const lines = [
-            "# Auto Research Report",
-            "",
-            `Run: ${state.run_id}`,
-            `Status: ${state.status}`,
-            `Goal: ${state.goal}`,
-            `Metric: ${state.metric?.name ?? "unknown"}`,
-            `Iterations: ${state.stats?.total_iterations ?? 0}`,
-            `Kept: ${state.stats?.kept ?? 0} | Discarded: ${state.stats?.discarded ?? 0}`,
-        ];
-        writeFileSync(reportPath, lines.join("\n") + "\n", "utf-8");
-        printJson({ report_path: reportPath });
-    }
-    catch (exc) {
-        console.error(exc.message);
-        return 2;
-    }
-    return 0;
-}
-main().then((code) => process.exit(code)).catch((err) => {
-    console.error(err);
-    process.exit(1);
-});
-//# sourceMappingURL=complete.js.map

package/dist/complete.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"complete.js","sourceRoot":"","sources":["../src/complete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAEnC,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAsB,EAAE,CAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QAChE,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAEzD,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,CAAC,aAAa,CAAC,EAAE,cAAc,CAAC,CAAC;QACvF,MAAM,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QACnF,MAAM,KAAK,GAAG;YACZ,wBAAwB;YACxB,EAAE;YACF,QAAQ,KAAK,CAAC,MAAM,EAAE;YACtB,WAAW,KAAK,CAAC,MAAM,EAAE;YACzB,SAAS,KAAK,CAAC,IAAI,EAAE;YACrB,WAAW,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,SAAS,EAAE;YAC5C,eAAe,KAAK,CAAC,KAAK,EAAE,gBAAgB,IAAI,CAAC,EAAE;YACnD,SAAS,KAAK,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,iBAAiB,KAAK,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC,EAAE;SAC9E,CAAC;QACF,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5D,SAAS,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACtD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/init.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=init.d.ts.map

package/dist/init.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":""}

package/dist/init.js

@@ -1,48 +0,0 @@
-import { initializeRun } from "./run-manager.js";
-import { printJson } from "./helpers.js";
-async function main() {
-    const args = process.argv.slice(2);
-    const get = (name) => args[args.indexOf(`--${name}`) + 1] ?? undefined;
-    const has = (name) => args.includes(`--${name}`);
-    const goal = get("goal");
-    const metric = get("metric");
-    const direction = get("direction") ?? "lower";
-    const verify = get("verify");
-    const mode = get("mode") ?? "foreground";
-    const repo = get("repo");
-    if (!goal || !metric || !verify) {
-        console.error("--goal, --metric, and --verify are required");
-        return 2;
-    }
-    const config = {
-        goal,
-        metric,
-        direction,
-        verify,
-        mode,
-        scope: get("scope"),
-        guard: get("guard"),
-        iterations: get("iterations") ? parseInt(get("iterations")) : undefined,
-        duration: get("duration"),
-        memory_path: get("memory-path"),
-        required_keep_labels: get("required-keep-labels")?.split(" "),
-        required_stop_labels: get("required-stop-labels")?.split(" "),
-        run_tag: get("run-tag"),
-        stop_condition: get("stop-condition"),
-        baseline: get("baseline"),
-    };
-    try {
-        const state = await initializeRun(repo, get("results-path"), get("state-path"), config, has("fresh-start"));
-        printJson(state);
-    }
-    catch (exc) {
-        console.error(exc.message);
-        return 2;
-    }
-    return 0;
-}
-main().then((code) => process.exit(code)).catch((err) => {
-    console.error(err);
-    process.exit(1);
-});
-//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAsB,EAAE,CAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;IACnD,MAAM,GAAG,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAElE,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC;IAC9C,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC;IACzC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAEzB,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAc;QACxB,IAAI;QACJ,MAAM;QACN,SAAS;QACT,MAAM;QACN,IAAI;QACJ,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC;QACnB,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC;QACnB,UAAU,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QACxE,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC;QACzB,WAAW,EAAE,GAAG,CAAC,aAAa,CAAC;QAC/B,oBAAoB,EAAE,GAAG,CAAC,sBAAsB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC;QAC7D,oBAAoB,EAAE,GAAG,CAAC,sBAAsB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC;QAC7D,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC;QACvB,cAAc,EAAE,GAAG,CAAC,gBAAgB,CAAC;QACrC,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC;KAC1B,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,aAAa,CAC/B,IAAI,EACJ,GAAG,CAAC,cAAc,CAAC,EACnB,GAAG,CAAC,YAAY,CAAC,EACjB,MAAM,EACN,GAAG,CAAC,aAAa,CAAC,CACnB,CAAC;QACF,SAAS,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACtD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/launch.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=launch.d.ts.map

package/dist/launch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../src/launch.ts"],"names":[],"mappings":""}

package/dist/launch.js

@@ -1,51 +0,0 @@
-import { initializeRun } from "./run-manager.js";
-import { resolvePath, printJson } from "./helpers.js";
-import { LAUNCH_DEFAULT } from "./constants.js";
-import { writeFileSync } from "fs";
-async function main() {
-    const args = process.argv.slice(2);
-    const get = (name) => args[args.indexOf(`--${name}`) + 1] ?? undefined;
-    const has = (name) => args.includes(`--${name}`);
-    const goal = get("goal");
-    const metric = get("metric");
-    const direction = get("direction") ?? "lower";
-    const verify = get("verify");
-    const repo = get("repo");
-    if (!goal || !metric || !verify) {
-        console.error("--goal, --metric, and --verify are required for launch");
-        return 2;
-    }
-    const config = {
-        goal,
-        metric,
-        direction,
-        verify,
-        mode: "background",
-        scope: get("scope"),
-        guard: get("guard"),
-        iterations: get("iterations") ? parseInt(get("iterations")) : undefined,
-        duration: get("duration"),
-        memory_path: get("memory-path"),
-        required_keep_labels: get("required-keep-labels")?.split(" "),
-        required_stop_labels: get("required-stop-labels")?.split(" "),
-        run_tag: get("run-tag"),
-        stop_condition: get("stop-condition"),
-        baseline: get("baseline"),
-    };
-    try {
-        const state = await initializeRun(repo, get("results-path"), get("state-path"), config, has("fresh-start"));
-        const launchPath = resolvePath(repo, get("launch-path"), LAUNCH_DEFAULT);
-        writeFileSync(launchPath, JSON.stringify({ run_id: state.run_id, goal: state.goal, mode: "background" }, null, 2) + "\n", "utf-8");
-        printJson({ status: "launched", run_id: state.run_id, launch_path: launchPath });
-    }
-    catch (exc) {
-        console.error(exc.message);
-        return 2;
-    }
-    return 0;
-}
-main().then((code) => process.exit(code)).catch((err) => {
-    console.error(err);
-    process.exit(1);
-});
-//# sourceMappingURL=launch.js.map

package/dist/launch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"launch.js","sourceRoot":"","sources":["../src/launch.ts"],"names":[],"mappings":"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"}

package/dist/record.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=record.d.ts.map

package/dist/record.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../src/record.ts"],"names":[],"mappings":""}

package/dist/record.js

@@ -1,26 +0,0 @@
-import { appendIteration } from "./run-manager.js";
-import { printJson, normalizeResultStatus } from "./helpers.js";
-async function main() {
-    const args = process.argv.slice(2);
-    const get = (name) => args[args.indexOf(`--${name}`) + 1] ?? undefined;
-    const decision = get("decision");
-    const changeSummary = get("change-summary");
-    if (!decision || !changeSummary) {
-        console.error("--decision and --change-summary are required");
-        return 2;
-    }
-    try {
-        const state = await appendIteration(get("repo"), get("results-path"), get("state-path"), decision, get("metric-value"), normalizeResultStatus(get("verify-status") ?? "pass", "verify_status"), normalizeResultStatus(get("guard-status") ?? "skip", "guard_status"), get("hypothesis"), changeSummary, get("labels")?.split(" "), get("note"), get("iteration") ? parseInt(get("iteration")) : undefined);
-        printJson(state);
-    }
-    catch (exc) {
-        console.error(exc.message);
-        return 2;
-    }
-    return 0;
-}
-main().then((code) => process.exit(code)).catch((err) => {
-    console.error(err);
-    process.exit(1);
-});
-//# sourceMappingURL=record.js.map

package/dist/record.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"record.js","sourceRoot":"","sources":["../src/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEhE,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAsB,EAAE,CAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;IAEnD,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;IACjC,MAAM,aAAa,GAAG,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,IAAI,CAAC,aAAa,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,eAAe,CACjC,GAAG,CAAC,MAAM,CAAC,EACX,GAAG,CAAC,cAAc,CAAC,EACnB,GAAG,CAAC,YAAY,CAAC,EACjB,QAAQ,EACR,GAAG,CAAC,cAAc,CAAC,EACnB,qBAAqB,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,MAAM,EAAE,eAAe,CAAC,EACtE,qBAAqB,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,MAAM,EAAE,cAAc,CAAC,EACpE,GAAG,CAAC,YAAY,CAAC,EACjB,aAAa,EACb,GAAG,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,EACzB,GAAG,CAAC,MAAM,CAAC,EACX,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAC3D,CAAC;QACF,SAAS,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACtD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/resume.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=resume.d.ts.map

package/dist/resume.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../src/resume.ts"],"names":[],"mappings":""}

package/dist/resume.js

@@ -1,20 +0,0 @@
-import { resumeBackgroundRun } from "./run-manager.js";
-import { printJson } from "./helpers.js";
-async function main() {
-    const args = process.argv.slice(2);
-    const get = (name) => args[args.indexOf(`--${name}`) + 1] ?? undefined;
-    try {
-        const state = await resumeBackgroundRun(get("repo"), get("state-path"));
-        printJson({ status: "resumed", run_id: state.run_id });
-    }
-    catch (exc) {
-        console.error(exc.message);
-        return 2;
-    }
-    return 0;
-}
-main().then((code) => process.exit(code)).catch((err) => {
-    console.error(err);
-    process.exit(1);
-});
-//# sourceMappingURL=resume.js.map

package/dist/resume.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resume.js","sourceRoot":"","sources":["../src/resume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAsB,EAAE,CAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QACxE,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACtD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/status.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":""}

package/dist/status.js

@@ -1,20 +0,0 @@
-import { buildSupervisorSnapshot } from "./run-manager.js";
-import { printJson } from "./helpers.js";
-async function main() {
-    const args = process.argv.slice(2);
-    const get = (name) => args[args.indexOf(`--${name}`) + 1] ?? undefined;
-    try {
-        const snapshot = await buildSupervisorSnapshot(get("repo"), get("results-path"), get("state-path"));
-        printJson(snapshot);
-    }
-    catch (exc) {
-        console.error(exc.message);
-        return 2;
-    }
-    return 0;
-}
-main().then((code) => process.exit(code)).catch((err) => {
-    console.error(err);
-    process.exit(1);
-});
-//# sourceMappingURL=status.js.map

package/dist/status.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAsB,EAAE,CAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QACpG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACtD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/stop.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=stop.d.ts.map

package/dist/stop.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../src/stop.ts"],"names":[],"mappings":""}

package/dist/stop.js

@@ -1,20 +0,0 @@
-import { setStopRequested } from "./run-manager.js";
-import { printJson } from "./helpers.js";
-async function main() {
-    const args = process.argv.slice(2);
-    const get = (name) => args[args.indexOf(`--${name}`) + 1] ?? undefined;
-    try {
-        const state = await setStopRequested(get("repo"), get("state-path"));
-        printJson({ status: "stop_requested", run_id: state.run_id });
-    }
-    catch (exc) {
-        console.error(exc.message);
-        return 2;
-    }
-    return 0;
-}
-main().then((code) => process.exit(code)).catch((err) => {
-    console.error(err);
-    process.exit(1);
-});
-//# sourceMappingURL=stop.js.map

package/dist/stop.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stop.js","sourceRoot":"","sources":["../src/stop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAsB,EAAE,CAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QACrE,SAAS,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACtD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}