solveos-cli 0.1.0

package/commands/solveos/validate-build.md

@@ -0,0 +1,155 @@
+---
+description: Validate build output against Plan Brief success criteria — catches gaps before shipping
+---
+
+# /solveos:validate-build — Build Validation Gate
+
+You are running the **Build Validation gate** of the solveOS cycle. This gate checks whether what was built actually matches what was planned. It catches the gap between intention and execution before it reaches users.
+
+## Prerequisites
+
+1. Check that `.solveos/` exists. If not: "No solveOS project found. Run `/solveos:new` first."
+2. Read `.solveos/STATE.md`:
+   - Valid entry states: `BUILDING` (build in progress or complete) or `VALIDATING_BUILD` (re-entering after fixes)
+   - If state is `INIT` or `PLANNING`: "Nothing to validate yet. Run `/solveos:build` first."
+   - If state is `SHIPPED` or later: "This cycle is already shipped."
+3. Read `.solveos/BRIEF.md` — especially the **success criteria**. These are what you're validating against.
+   - If no brief exists: "No Plan Brief found. Run `/solveos:plan` first."
+4. Read `.solveos/config.json` to check if the build validation gate is enabled.
+   - If `gates.build_validation` is `false`: "The build validation gate is disabled in your config. You can still run it — do you want to proceed?"
+5. Read any existing validation output from `.solveos/validations/build-validation.md` for context on previous validation attempts.
+
+## Step 1: Gather Build Context
+
+Before validating, understand what was built:
+
+1. **Ask the user** to describe what was completed, or point to the relevant files/output:
+   > "What was built? Please describe the output or point me to the relevant files so I can validate against your Plan Brief."
+
+2. **Read the build output** — examine the files, code, documents, or artifacts that were produced during the Build phase.
+
+3. **Read any test results** — if tests were run, check their output.
+
+4. **Read the Plan Brief success criteria** — enumerate each criterion that needs to be checked.
+
+## Step 2: Validate Against the 3 Build Validation Questions
+
+Invoke the **solveos-build-validator** agent behavior. Evaluate the build output against these three questions:
+
+### Question 1: Does it work?
+
+- Does the output function as intended, without critical failures?
+- Can the primary use case be completed end-to-end?
+- Are there crashes, errors, or broken paths?
+- Does it handle expected inputs correctly?
+
+### Question 2: Does it match the plan?
+
+For **each success criterion** from the Plan Brief, assess:
+
+| Criterion | Status | Notes |
+|-----------|--------|-------|
+| {criterion from BRIEF.md} | Pass / Fail / Partial | {what works, what doesn't} |
+
+- **Pass:** Criterion fully met
+- **Partial:** Criterion partially met — describe what's missing
+- **Fail:** Criterion not met — describe what's wrong
+
+Also check for **scope drift**:
+- Was anything added that wasn't in the plan? (scope creep)
+- Was anything cut from the plan? (scope reduction)
+- Were there any modifications to the original scope? If so, were they justified?
+
+### Question 3: Is it stable enough to ship?
+
+- Are remaining issues known, bounded, and acceptable?
+- Would the audience described in the Plan Brief have a good experience?
+- Are there any time bombs (things that will break soon but work now)?
+- Is technical debt bounded and documented?
+
+## Step 3: Catalog Known Issues
+
+For any issues found, catalog them:
+
+| Issue | Severity | Decision |
+|-------|----------|----------|
+| {description} | Critical / High / Medium / Low | Fix now / Defer / Accept |
+
+**Severity definitions:**
+- **Critical:** Blocks the primary use case. Must fix before shipping.
+- **High:** Significantly degrades experience. Should fix before shipping.
+- **Medium:** Noticeable but not blocking. Can defer with documentation.
+- **Low:** Minor polish. Safe to accept or defer.
+
+**Decision guidance:**
+- **Fix now:** Return to Build phase to address this before proceeding.
+- **Defer:** Document as known issue, add to next cycle's backlog.
+- **Accept:** Acceptable for the stated audience and appetite.
+
+## Step 4: Write Build Validation Output
+
+Write the results to `.solveos/validations/build-validation.md` using the Build Validation template format with all sections filled in.
+
+If a previous `build-validation.md` exists (from a prior validation attempt), rename it to `build-validation-{n}.md` before writing the new one, so history is preserved.
+
+## Step 5: Decide and Transition
+
+Present the results to the user and recommend a routing decision. **The user decides — not you.**
+
+### If all criteria pass (no critical/high issues):
+
+> "Build validation passed. All success criteria are met.
+>
+> Options:
+> 1. Run `/solveos:review` for a pre-ship review (recommended if enabled)
+> 2. Run `/solveos:ship` to ship directly
+>
+> What would you like to do?"
+
+Update `STATE.md`:
+- Mark `BUILD_VALIDATION` as a completed gate
+- Transition state based on user's choice (toward `REVIEWING_PRE` or `READY_TO_SHIP`)
+- Update `updated_at`
+
+### If issues found (needs iteration):
+
+> "Build validation found {n} issues:
+> - {critical/high count} require fixing before shipping
+> - {medium/low count} can be deferred or accepted
+>
+> I recommend returning to Build to fix the critical/high issues.
+>
+> Options:
+> 1. Run `/solveos:build` to fix the issues (returns to Build phase)
+> 2. Accept the issues and proceed to Review/Ship (document as known issues)
+>
+> What would you like to do?"
+
+Update `STATE.md`:
+- If returning to Build: transition to `BUILDING`
+- If accepting and proceeding: mark `BUILD_VALIDATION` as completed with accepted issues noted
+- Update `updated_at`
+
+### If major plan gaps found (needs re-planning):
+
+> "Build validation found fundamental gaps between the plan and the output:
+> - {gap description}
+>
+> The issue isn't the build — it's the plan. I recommend:
+> 1. Run `/solveos:plan` to revise the Plan Brief
+> 2. Accept the deviation and proceed with what was built
+>
+> What would you like to do?"
+
+Update `STATE.md`:
+- If re-planning: transition to `PLANNING`
+- Add the fundamental gap to blockers
+- Update `updated_at`
+
+## Important Rules
+
+- **Check every success criterion individually** — don't summarize. Each criterion gets its own Pass / Fail / Partial assessment.
+- **Be specific about failures** — "tests fail" is not actionable; "the `calculateTotal` function returns NaN for empty arrays because it doesn't handle the edge case" is actionable.
+- **Scope drift is not automatically bad** — justified additions are fine if documented. Unjustified scope creep or silent scope reduction is a problem.
+- **The human decides the routing** — present options and a recommendation, but never auto-transition.
+- **Severity matters for routing** — critical issues block shipping; low issues don't. Don't treat all issues equally.

package/commands/solveos/validate-plan.md

@@ -0,0 +1,115 @@
+---
+description: Validate the Plan Brief before building — catches ambiguity early
+---
+
+# /solveos:validate-plan — Plan Validation Gate
+
+You are running the **Plan Validation gate** of the solveOS cycle. This gate catches plan ambiguity before it becomes expensive build errors. Ambiguity in the brief becomes guesswork during build.
+
+## Prerequisites
+
+1. Check that `.solveos/` exists. If not: "No solveOS project found. Run `/solveos:new` first."
+2. Read `.solveos/STATE.md`:
+   - Valid entry states: `PLANNING` (plan complete, ready to validate) or `VALIDATING_PLAN` (re-entering after refinement)
+   - If state is `INIT`: "No plan to validate. Run `/solveos:plan` first."
+3. Read `.solveos/BRIEF.md` — this is what you're validating.
+   - If no brief exists: "No Plan Brief found. Run `/solveos:plan` first."
+4. Read `.solveos/config.json` for `plan_validation_max_passes` (default 3).
+5. Read any existing validation logs from `.solveos/validations/plan-validation-*.md` for context on previous passes.
+
+## Step 1: Check Pass Count
+
+Read `plan_validation_passes` from `STATE.md`.
+
+- If passes >= `plan_validation_max_passes`:
+  > "You've reached the maximum validation passes ({max}). The brief may need fundamental rethinking rather than incremental refinement.
+  >
+  > Options:
+  > 1. Run `/solveos:research` to investigate the problem space more deeply
+  > 2. Run `/solveos:build` to proceed with the current brief (accepting known gaps)
+  > 3. Start over with `/solveos:plan` from scratch"
+  
+  Wait for the user's decision. Do not force another validation pass.
+
+## Step 2: Validate Against the 3 Core Questions
+
+Invoke the **solveos-plan-validator** agent behavior. Evaluate the Plan Brief against these three questions:
+
+### Question 1: Is the problem correctly stated?
+- Is this the actual problem, or a symptom of a deeper issue?
+- Is the audience named specifically (not "users" or "everyone")?
+- Could someone outside the project understand what's wrong?
+- Is the problem free of embedded solutions?
+
+### Question 2: Is the plan feasible?
+- Can the goal be achieved within the stated constraints and appetite?
+- Do the constraints conflict with each other?
+- Is the appetite realistic for the stated goal?
+- Are there hidden dependencies not listed in constraints?
+
+### Question 3: Is it specific enough to build from?
+- Could someone who didn't write the brief execute it and produce the same result?
+- Would two people interpret the success criteria the same way?
+- Are there ambiguous terms that need definition?
+- Is every success criterion testable?
+
+### Additional Checks
+- **Are success criteria measurable and falsifiable?** (Can you construct a test for each one?)
+- **What would you cut if scope had to be reduced by 50%?** (Forces prioritization)
+- **What is the single biggest unacknowledged risk?** (Surfaces hidden assumptions)
+
+## Step 3: Write Validation Log
+
+Write the results to `.solveos/validations/plan-validation-{n}.md` where `{n}` is the current pass number (1, 2, 3...).
+
+Use the Plan Validation Log template format with all sections filled in.
+
+## Step 4: Decide and Transition
+
+Based on the validation results:
+
+### If gaps were found (needs refinement):
+1. Present the specific gaps to the user:
+   > "I found {n} gaps in the Plan Brief:
+   > 1. {gap description} — suggested fix: {suggestion}
+   > 2. {gap description} — suggested fix: {suggestion}
+   >
+   > Run `/solveos:plan` to refine the brief, then `/solveos:validate-plan` again."
+
+2. Update `STATE.md`:
+   - Transition back to `PLANNING` (for refinement)
+   - Increment `plan_validation_passes`
+   - Update `updated_at`
+
+### If validated (ready to build):
+1. Confirm:
+   > "Plan Brief validated — no critical gaps remain. The brief is specific enough to build from.
+   >
+   > Run `/solveos:build` to start executing."
+
+2. Update `STATE.md`:
+   - Mark `PLAN_VALIDATION` as a completed gate
+   - Transition state toward `BUILDING`
+   - Update `updated_at`
+
+### If needs escalation (fundamental issues):
+1. Explain:
+   > "The Plan Brief has fundamental issues that incremental refinement won't fix:
+   > - {issue description}
+   >
+   > I recommend:
+   > 1. `/solveos:research` — investigate the problem space more deeply
+   > 2. `/solveos:plan` — start a fresh brief from scratch"
+
+2. Update `STATE.md` with escalation note in blockers.
+
+## Refining Loop Summary
+
+```
+Pass 1: Catches obvious gaps (vague goals, missing constraints, unmeasurable criteria)
+Pass 2: Catches structural issues (goal/constraint conflicts, feasibility concerns)
+Pass 3: Catches alignment gaps (two readers would interpret differently)
+After max: Escalate (suggest research or fundamental rethink)
+```
+
+Each pass builds on previous ones. Validation logs from earlier passes provide context for what was already caught and (hopefully) fixed.

package/dist/bin/install.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * solveos-cli installer entry point.
+ *
+ * Usage: npx solveos-cli@latest [--runtime opencode|claude-code|cursor|gemini]
+ *
+ * Detects the active AI coding assistant, installs slash commands and agents,
+ * and initializes the .solveos/ project directory.
+ */
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/bin/install.d.ts.map

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

package/dist/bin/install.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+/**
+ * solveos-cli installer entry point.
+ *
+ * Usage: npx solveos-cli@latest [--runtime opencode|claude-code|cursor|gemini]
+ *
+ * Detects the active AI coding assistant, installs slash commands and agents,
+ * and initializes the .solveos/ project directory.
+ */
+import { resolve, join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { readdir } from "node:fs/promises";
+import { detectRuntime } from "../lib/runtime-detect.js";
+import { opencode } from "../lib/runtime-adapters/opencode.js";
+import { claudeCode } from "../lib/runtime-adapters/claude-code.js";
+import { cursor } from "../lib/runtime-adapters/cursor.js";
+import { gemini } from "../lib/runtime-adapters/gemini-cli.js";
+import { initProject, projectExists } from "../lib/artifacts.js";
+// ---------------------------------------------------------------------------
+// Resolve package root (where commands/, agents/, templates/ live)
+// ---------------------------------------------------------------------------
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// From dist/bin/install.js -> go up two levels to package root
+const PACKAGE_ROOT = resolve(__dirname, "..", "..");
+// ---------------------------------------------------------------------------
+// Adapter registry
+// ---------------------------------------------------------------------------
+const ADAPTERS = {
+    opencode,
+    "claude-code": claudeCode,
+    cursor,
+    gemini,
+};
+// ---------------------------------------------------------------------------
+// CLI argument parsing (minimal — no dep needed)
+// ---------------------------------------------------------------------------
+function parseArgs(argv) {
+    const runtimeIndex = argv.indexOf("--runtime");
+    if (runtimeIndex !== -1 && argv[runtimeIndex + 1]) {
+        return { runtime: argv[runtimeIndex + 1] };
+    }
+    return {};
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+    const cwd = process.cwd();
+    const args = parseArgs(process.argv);
+    console.log("");
+    console.log("  solveos-cli — Install the solveOS framework");
+    console.log("  ─────────────────────────────────────────────");
+    console.log("");
+    // Step 1: Detect or select runtime
+    let runtimeName;
+    let runtimeDisplayName;
+    if (args.runtime) {
+        runtimeName = args.runtime;
+        runtimeDisplayName = args.runtime;
+        console.log(`  Runtime: ${runtimeDisplayName} (from --runtime flag)`);
+    }
+    else {
+        const detected = await detectRuntime(cwd);
+        if (detected) {
+            runtimeName = detected.runtime;
+            runtimeDisplayName = detected.name;
+            console.log(`  Detected runtime: ${runtimeDisplayName}`);
+            console.log(`  Config: ${detected.configPath}`);
+        }
+        else {
+            console.log("  No supported AI coding assistant detected.");
+            console.log("");
+            console.log("  Supported runtimes:");
+            console.log("    - OpenCode  (.opencode/ or opencode.json)");
+            console.log("    - Claude Code  (.claude/ or CLAUDE.md)");
+            console.log("    - Cursor  (.cursor/ or .cursorrules)");
+            console.log("    - Gemini CLI  (.gemini/)");
+            console.log("");
+            console.log("  Use --runtime <name> to specify manually:");
+            console.log("    npx solveos-cli --runtime opencode");
+            console.log("");
+            process.exit(1);
+        }
+    }
+    console.log("");
+    // Step 2: Get adapter
+    const adapter = ADAPTERS[runtimeName];
+    if (!adapter) {
+        console.log(`  Runtime "${runtimeName}" is not yet supported.`);
+        console.log("  Currently supported: opencode, claude-code, cursor, gemini");
+        console.log("");
+        process.exit(1);
+    }
+    // Step 3: Install commands
+    const commandsDir = join(PACKAGE_ROOT, "commands", "solveos");
+    try {
+        const commandFiles = await readdir(commandsDir);
+        const mdFiles = commandFiles.filter((f) => f.endsWith(".md"));
+        console.log(`  Installing ${mdFiles.length} commands...`);
+        await adapter.installCommands(commandsDir);
+        for (const f of mdFiles) {
+            console.log(`    /solveos-${f.replace(".md", "")}`);
+        }
+    }
+    catch (err) {
+        console.log(`  Warning: Could not install commands: ${err}`);
+    }
+    // Step 4: Install agents
+    const agentsDir = join(PACKAGE_ROOT, "agents");
+    try {
+        const agentFiles = await readdir(agentsDir);
+        const mdFiles = agentFiles.filter((f) => f.endsWith(".md"));
+        console.log(`  Installing ${mdFiles.length} agents...`);
+        await adapter.installAgents(agentsDir);
+        for (const f of mdFiles) {
+            console.log(`    @${f.replace(".md", "")}`);
+        }
+    }
+    catch (err) {
+        console.log(`  Warning: Could not install agents: ${err}`);
+    }
+    // Step 5: Install hooks (stub for now)
+    await adapter.installHooks("");
+    // Step 6: Initialize .solveos/ project directory
+    console.log("");
+    if (await projectExists(cwd)) {
+        console.log("  .solveos/ directory already exists (preserving existing state)");
+    }
+    else {
+        await initProject(cwd);
+        console.log("  Created .solveos/ directory");
+    }
+    // Step 7: Print quickstart guide
+    console.log("");
+    console.log("  ─────────────────────────────────────────────");
+    console.log("  Installation complete!");
+    console.log("");
+    console.log("  Available commands:");
+    console.log("    /solveos-new      Start a new project or cycle");
+    console.log("    /solveos-plan     Create a Plan Brief");
+    console.log("    /solveos-build    Execute against the plan");
+    console.log("    /solveos-ship     Ship and archive the cycle");
+    console.log("    /solveos-status   Show current cycle status");
+    console.log("    /solveos-next     Suggest the next step");
+    console.log("");
+    console.log("  Quick start:");
+    console.log("    1. Run /solveos-new to initialize a project");
+    console.log("    2. Run /solveos-plan to create your Plan Brief");
+    console.log("    3. Run /solveos-build to execute");
+    console.log("    4. Run /solveos-ship when done");
+    console.log("");
+}
+main().catch((err) => {
+    console.error("Installation failed:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=install.js.map

package/dist/bin/install.js.map

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

package/dist/hooks/brief-anchor.d.ts

@@ -0,0 +1,68 @@
+/**
+ * solveOS Brief Anchor — OpenCode plugin.
+ *
+ * Periodically reminds the AI agent to check work against the Plan Brief
+ * during the Build phase. Triggers after every N tool calls (configurable),
+ * injecting a reminder to verify alignment with success criteria and
+ * out-of-scope boundaries.
+ *
+ * Implements the solveOS principle: "The brief is your compass."
+ *
+ * Installed to: .opencode/plugins/solveos-brief-anchor.ts
+ * Events: tool.execute.after
+ */
+/**
+ * Extract success criteria from a Plan Brief markdown string.
+ * Looks for `- [ ] criterion` lines under ## Success Criteria.
+ */
+export declare function extractSuccessCriteria(brief: string): string[];
+/**
+ * Extract out-of-scope items from a Plan Brief markdown string.
+ */
+export declare function extractOutOfScope(brief: string): string[];
+/**
+ * Generate a brief anchor reminder with the actual criteria and boundaries.
+ */
+export declare function generateReminder(criteria: string[], outOfScope: string[]): string;
+/**
+ * Generate a minimal reminder when no brief is found.
+ */
+export declare function generateMinimalReminder(): string;
+export interface AnchorState {
+    toolCallCount: number;
+    sessionId: string | null;
+}
+export declare function createAnchorState(): AnchorState;
+/**
+ * Check if a reminder should be emitted based on current tool call count.
+ */
+export declare function shouldRemind(state: AnchorState, interval: number): boolean;
+/**
+ * The OpenCode plugin export.
+ *
+ * Subscribes to tool.execute.after events to count tool calls during Build.
+ * At configurable intervals, logs a brief anchor reminder.
+ */
+export declare const SolveosBriefAnchor: (ctx: {
+    directory: string;
+    worktree: string;
+    client: {
+        app: {
+            log: (opts: {
+                body: {
+                    service: string;
+                    level: string;
+                    message: string;
+                };
+            }) => Promise<void>;
+        };
+    };
+}) => Promise<{
+    "tool.execute.after"?: undefined;
+} | {
+    "tool.execute.after": (input: {
+        tool: string;
+        sessionID?: string;
+    }, _output: unknown) => Promise<void>;
+}>;
+//# sourceMappingURL=brief-anchor.d.ts.map

package/dist/hooks/brief-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief-anchor.d.ts","sourceRoot":"","sources":["../../src/hooks/brief-anchor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoEH;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAsB9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBzD;AAqBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CA2BjF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAUhD;AAMD,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,IAAI,WAAW,CAK/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1E;AAMD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAU,KAAK;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,GAAG,EAAE;YAAE,GAAG,EAAE,CAAC,IAAI,EAAE;gBAAE,IAAI,EAAE;oBAAE,OAAO,EAAE,MAAM,CAAC;oBAAC,KAAK,EAAE,MAAM,CAAC;oBAAC,OAAO,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC;CAClH;;;kCAYY;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,WAClC,OAAO;EAsCrB,CAAC"}