solveos-cli 0.1.0

package/dist/lib/artifacts.js

@@ -0,0 +1,382 @@
+/**
+ * Artifact management for solveos-cli.
+ *
+ * Handles creating, reading, writing, and archiving files in the
+ * .solveos/ directory. All cycle state persists as markdown and JSON
+ * files — no databases, no cloud, no accounts.
+ */
+import { readFile, writeFile, mkdir, cp, rm, access, readdir } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { DEFAULT_CONFIG } from "./config.js";
+import { validatePath, sanitizeFilename } from "./security.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const SOLVEOS_DIR = ".solveos";
+const BRIEF_FILE = "BRIEF.md";
+const STATE_FILE = "STATE.md";
+const CONFIG_FILE = "config.json";
+const SUBDIRS = [
+    "research",
+    "validations",
+    "reviews",
+    "history",
+    "notes",
+];
+// ---------------------------------------------------------------------------
+// Path Safety
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a path within .solveos/ and validate it doesn't escape.
+ * Delegates to the security module's validatePath.
+ */
+function safePath(projectDir, ...segments) {
+    const base = resolve(projectDir, SOLVEOS_DIR);
+    return validatePath(base, join(...segments));
+}
+/**
+ * Get the .solveos/ directory path for a project.
+ */
+function solveosDir(projectDir) {
+    return resolve(projectDir, SOLVEOS_DIR);
+}
+// ---------------------------------------------------------------------------
+// Existence Checks
+// ---------------------------------------------------------------------------
+/**
+ * Check if a .solveos/ directory exists and is valid.
+ */
+export async function projectExists(projectDir) {
+    try {
+        await access(solveosDir(projectDir));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a file exists.
+ */
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Project Initialization
+// ---------------------------------------------------------------------------
+/**
+ * Create the .solveos/ directory structure.
+ * Safe to run multiple times — does not overwrite existing files.
+ */
+export async function initProject(projectDir) {
+    const base = solveosDir(projectDir);
+    // Create base directory and subdirectories
+    await mkdir(base, { recursive: true });
+    for (const sub of SUBDIRS) {
+        await mkdir(join(base, sub), { recursive: true });
+    }
+    // Write default config if it doesn't exist
+    const configPath = join(base, CONFIG_FILE);
+    if (!(await fileExists(configPath))) {
+        await writeFile(configPath, JSON.stringify(DEFAULT_CONFIG, null, 2) + "\n", "utf-8");
+    }
+    // Write initial STATE.md if it doesn't exist
+    const statePath = join(base, STATE_FILE);
+    if (!(await fileExists(statePath))) {
+        const initialState = {
+            current_state: "INIT",
+            cycle_number: 1,
+            gates_skipped: [],
+            gates_completed: [],
+            plan_validation_passes: 0,
+            blockers: [],
+            transitions_log: [],
+            created_at: new Date().toISOString(),
+            updated_at: new Date().toISOString(),
+        };
+        await writeState(projectDir, initialState);
+    }
+}
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+/**
+ * Read .solveos/config.json. Returns defaults for any missing fields.
+ */
+export async function readConfig(projectDir) {
+    const configPath = safePath(projectDir, CONFIG_FILE);
+    try {
+        const raw = await readFile(configPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        return {
+            ...DEFAULT_CONFIG,
+            ...parsed,
+            gates: { ...DEFAULT_CONFIG.gates, ...parsed.gates },
+            hooks: { ...DEFAULT_CONFIG.hooks, ...parsed.hooks },
+        };
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+}
+/**
+ * Write .solveos/config.json.
+ */
+export async function writeConfig(projectDir, config) {
+    const configPath = safePath(projectDir, CONFIG_FILE);
+    await writeFile(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+// ---------------------------------------------------------------------------
+// State (STATE.md)
+// ---------------------------------------------------------------------------
+/**
+ * Read and parse .solveos/STATE.md.
+ * STATE.md uses a JSON frontmatter block between `---` markers.
+ */
+export async function readState(projectDir) {
+    const statePath = safePath(projectDir, STATE_FILE);
+    try {
+        const raw = await readFile(statePath, "utf-8");
+        return parseStateMd(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write structured state to .solveos/STATE.md.
+ * Format: YAML-like frontmatter (JSON) between --- markers, then human-readable summary.
+ */
+export async function writeState(projectDir, state) {
+    const statePath = safePath(projectDir, STATE_FILE);
+    const content = renderStateMd(state);
+    await writeFile(statePath, content, "utf-8");
+}
+/**
+ * Parse STATE.md content into CycleStateData.
+ */
+function parseStateMd(content) {
+    const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!fmMatch) {
+        throw new Error("STATE.md is missing frontmatter block");
+    }
+    return JSON.parse(fmMatch[1]);
+}
+/**
+ * Render CycleStateData to STATE.md markdown.
+ */
+function renderStateMd(state) {
+    const json = JSON.stringify(state, null, 2);
+    const lines = [
+        "---",
+        json,
+        "---",
+        "",
+        `# Cycle ${state.cycle_number} — State`,
+        "",
+        `**Current State:** ${state.current_state}`,
+        `**Updated:** ${state.updated_at}`,
+        "",
+    ];
+    if (state.gates_completed.length > 0) {
+        lines.push("## Gates Completed");
+        for (const g of state.gates_completed) {
+            lines.push(`- [x] ${g}`);
+        }
+        lines.push("");
+    }
+    if (state.gates_skipped.length > 0) {
+        lines.push("## Gates Skipped");
+        for (const g of state.gates_skipped) {
+            lines.push(`- [~] ${g}`);
+        }
+        lines.push("");
+    }
+    if (state.plan_validation_passes > 0) {
+        lines.push(`**Plan Validation Passes:** ${state.plan_validation_passes}`);
+        lines.push("");
+    }
+    if (state.blockers.length > 0) {
+        lines.push("## Blockers");
+        for (const b of state.blockers) {
+            lines.push(`- ${b}`);
+        }
+        lines.push("");
+    }
+    if (state.transitions_log && state.transitions_log.length > 0) {
+        lines.push("## Transitions Log");
+        lines.push("");
+        lines.push("| # | From | To | At | Gate Skipped | Gate Completed |");
+        lines.push("|---|------|----|----|--------------|----------------|");
+        for (let i = 0; i < state.transitions_log.length; i++) {
+            const entry = state.transitions_log[i];
+            const skipped = entry.gate_skipped ?? "—";
+            const completed = entry.gate_completed ?? "—";
+            lines.push(`| ${i + 1} | ${entry.from} | ${entry.to} | ${entry.at} | ${skipped} | ${completed} |`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Plan Brief (BRIEF.md)
+// ---------------------------------------------------------------------------
+/**
+ * Read .solveos/BRIEF.md and return its raw content, or null if not found.
+ */
+export async function readBrief(projectDir) {
+    const briefPath = safePath(projectDir, BRIEF_FILE);
+    try {
+        return await readFile(briefPath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write a Plan Brief to .solveos/BRIEF.md.
+ * Accepts either a PlanBrief object (rendered to markdown) or raw markdown string.
+ */
+export async function writeBrief(projectDir, brief) {
+    const briefPath = safePath(projectDir, BRIEF_FILE);
+    const content = typeof brief === "string" ? brief : renderBriefMd(brief);
+    await writeFile(briefPath, content, "utf-8");
+}
+/**
+ * Render a PlanBrief object to markdown matching the Plan Brief template.
+ */
+function renderBriefMd(brief) {
+    const lines = [
+        "# Plan Brief",
+        "",
+        "## Problem",
+        "",
+        brief.problem,
+        "",
+        "## Audience",
+        "",
+        brief.audience,
+        "",
+        "## Goal",
+        "",
+        brief.goal,
+        "",
+        "## Appetite",
+        "",
+        brief.appetite,
+        "",
+        "## Constraints",
+        "",
+    ];
+    for (const c of brief.constraints) {
+        lines.push(`- ${c}`);
+    }
+    lines.push("");
+    lines.push("## Success Criteria");
+    lines.push("");
+    for (const sc of brief.success_criteria) {
+        lines.push(`- [ ] ${sc}`);
+    }
+    lines.push("");
+    lines.push("## Core Assumption");
+    lines.push("");
+    lines.push(brief.core_assumption);
+    lines.push("");
+    lines.push("## Rabbit Holes");
+    lines.push("");
+    for (const rh of brief.rabbit_holes) {
+        lines.push(`- ${rh}`);
+    }
+    lines.push("");
+    lines.push("## Out of Scope");
+    lines.push("");
+    for (const oos of brief.out_of_scope) {
+        lines.push(`- ${oos}`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Cycle Archival
+// ---------------------------------------------------------------------------
+/**
+ * Archive the current cycle to .solveos/history/cycle-{n}/.
+ * Copies BRIEF.md, STATE.md, and validations/ to the archive.
+ * Clears current BRIEF.md and validations/ after archiving.
+ */
+export async function archiveCycle(projectDir, cycleNumber) {
+    const base = solveosDir(projectDir);
+    const archiveDir = safePath(projectDir, "history", `cycle-${cycleNumber}`);
+    // Create archive directory
+    await mkdir(archiveDir, { recursive: true });
+    // Copy BRIEF.md if it exists
+    const briefPath = join(base, BRIEF_FILE);
+    if (await fileExists(briefPath)) {
+        await cp(briefPath, join(archiveDir, BRIEF_FILE));
+    }
+    // Copy STATE.md
+    const statePath = join(base, STATE_FILE);
+    if (await fileExists(statePath)) {
+        await cp(statePath, join(archiveDir, STATE_FILE));
+    }
+    // Copy validations/ directory
+    const validationsDir = join(base, "validations");
+    const archiveValidationsDir = join(archiveDir, "validations");
+    if (await fileExists(validationsDir)) {
+        try {
+            const files = await readdir(validationsDir);
+            if (files.length > 0) {
+                await cp(validationsDir, archiveValidationsDir, { recursive: true });
+            }
+        }
+        catch {
+            // validations/ may be empty, that's fine
+        }
+    }
+    // Clear current BRIEF.md (remove it)
+    if (await fileExists(briefPath)) {
+        await rm(briefPath);
+    }
+    // Clear validations/ contents
+    try {
+        const files = await readdir(validationsDir);
+        for (const file of files) {
+            await rm(join(validationsDir, file));
+        }
+    }
+    catch {
+        // Already empty or doesn't exist
+    }
+}
+// ---------------------------------------------------------------------------
+// Research & Validation Artifact Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Write a research summary to .solveos/research/{topic}-research.md.
+ */
+export async function writeResearch(projectDir, topic, content) {
+    const filename = `${sanitizeFilename(topic)}-research.md`;
+    const filePath = safePath(projectDir, "research", filename);
+    await writeFile(filePath, content, "utf-8");
+}
+/**
+ * Write a validation artifact.
+ */
+export async function writeValidation(projectDir, filename, content) {
+    const filePath = safePath(projectDir, "validations", sanitizeFilename(filename));
+    await writeFile(filePath, content, "utf-8");
+}
+/**
+ * Write a review artifact.
+ */
+export async function writeReview(projectDir, filename, content) {
+    const filePath = safePath(projectDir, "reviews", sanitizeFilename(filename));
+    await writeFile(filePath, content, "utf-8");
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/lib/artifacts.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Configuration loading and defaults for solveos-cli.
+ *
+ * Reads .solveos/config.json if it exists, merges with defaults,
+ * and returns a fully typed Config object.
+ */
+import type { Config } from "../types.js";
+/** Default configuration — matches templates/config-default.json. */
+export declare const DEFAULT_CONFIG: Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,qEAAqE;AACrE,eAAO,MAAM,cAAc,EAAE,MAoB5B,CAAC"}

package/dist/lib/config.js

@@ -0,0 +1,29 @@
+/**
+ * Configuration loading and defaults for solveos-cli.
+ *
+ * Reads .solveos/config.json if it exists, merges with defaults,
+ * and returns a fully typed Config object.
+ */
+/** Default configuration — matches templates/config-default.json. */
+export const DEFAULT_CONFIG = {
+    mode: "interactive",
+    gates: {
+        research: true,
+        plan_validation: true,
+        build_validation: true,
+        review_pre_ship: true,
+        review_post_ship: true,
+    },
+    plan_validation_max_passes: 3,
+    granularity: "standard",
+    auto_advance: false,
+    domain: "software",
+    runtime: "auto",
+    hooks: {
+        context_monitor: true,
+        context_monitor_threshold: 60,
+        brief_anchor: true,
+        brief_anchor_interval: 10,
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAW;IACpC,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE;QACL,QAAQ,EAAE,IAAI;QACd,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,IAAI;QACtB,eAAe,EAAE,IAAI;QACrB,gBAAgB,EAAE,IAAI;KACvB;IACD,0BAA0B,EAAE,CAAC;IAC7B,WAAW,EAAE,UAAU;IACvB,YAAY,EAAE,KAAK;IACnB,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,MAAM;IACf,KAAK,EAAE;QACL,eAAe,EAAE,IAAI;QACrB,yBAAyB,EAAE,EAAE;QAC7B,YAAY,EAAE,IAAI;QAClB,qBAAqB,EAAE,EAAE;KAC1B;CACF,CAAC"}

package/dist/lib/runtime-adapters/claude-code.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Claude Code runtime adapter for solveos-cli.
+ *
+ * Handles detection and installation of commands, agents, and hooks
+ * into Claude Code's directory structure.
+ *
+ * Claude Code conventions:
+ * - Skills (commands): .claude/skills/<name>/SKILL.md -> /name
+ * - Agents:           .claude/agents/<name>.md -> @name / auto-delegation
+ * - Hooks:            .claude/settings.json -> hooks object
+ * - Legacy commands:  .claude/commands/<name>.md -> /name (still works)
+ *
+ * We use the skills format as it's the current standard and takes
+ * precedence over legacy commands.
+ */
+import type { RuntimeAdapter } from "../../types.js";
+export declare const claudeCode: RuntimeAdapter;
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/lib/runtime-adapters/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/lib/runtime-adapters/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,gBAAgB,CAAC;AAuDnE,eAAO,MAAM,UAAU,EAAE,cAoExB,CAAC"}

package/dist/lib/runtime-adapters/claude-code.js

@@ -0,0 +1,125 @@
+/**
+ * Claude Code runtime adapter for solveos-cli.
+ *
+ * Handles detection and installation of commands, agents, and hooks
+ * into Claude Code's directory structure.
+ *
+ * Claude Code conventions:
+ * - Skills (commands): .claude/skills/<name>/SKILL.md -> /name
+ * - Agents:           .claude/agents/<name>.md -> @name / auto-delegation
+ * - Hooks:            .claude/settings.json -> hooks object
+ * - Legacy commands:  .claude/commands/<name>.md -> /name (still works)
+ *
+ * We use the skills format as it's the current standard and takes
+ * precedence over legacy commands.
+ */
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { join, basename } from "node:path";
+import { detectRuntime } from "../runtime-detect.js";
+/**
+ * Transform OpenCode-style command frontmatter to Claude Code skill frontmatter.
+ *
+ * OpenCode: ---\ndescription: ...\n---
+ * Claude Code: ---\nname: solveos-{name}\ndescription: ...\ndisable-model-invocation: true\n---
+ *
+ * We set disable-model-invocation: true so skills are only invoked via
+ * explicit /solveos-{name} command (not auto-applied by the model).
+ */
+function transformCommandToSkill(content, commandName) {
+    const skillName = `solveos-${commandName}`;
+    // Parse existing frontmatter
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n/);
+    if (!frontmatterMatch) {
+        // No frontmatter — add skill frontmatter
+        return `---\nname: ${skillName}\ndescription: solveOS ${commandName} command\ndisable-model-invocation: true\n---\n\n${content}`;
+    }
+    const frontmatter = frontmatterMatch[1];
+    const body = content.slice(frontmatterMatch[0].length);
+    // Extract description from existing frontmatter
+    const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
+    const description = descMatch ? descMatch[1].trim() : `solveOS ${commandName} command`;
+    // Build Claude Code skill frontmatter
+    return `---\nname: ${skillName}\ndescription: ${description}\ndisable-model-invocation: true\n---\n\n${body}`;
+}
+/**
+ * Transform OpenCode-style agent frontmatter to Claude Code agent frontmatter.
+ *
+ * OpenCode: ---\ndescription: ...\nmode: subagent\n---
+ * Claude Code: ---\nname: ...\ndescription: ...\n---
+ */
+function transformAgentForClaudeCode(content, agentName) {
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n/);
+    if (!frontmatterMatch) {
+        return `---\nname: ${agentName}\ndescription: solveOS ${agentName} agent\n---\n\n${content}`;
+    }
+    const frontmatter = frontmatterMatch[1];
+    const body = content.slice(frontmatterMatch[0].length);
+    // Extract description
+    const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
+    const description = descMatch ? descMatch[1].trim() : `solveOS ${agentName} agent`;
+    return `---\nname: ${agentName}\ndescription: ${description}\n---\n\n${body}`;
+}
+export const claudeCode = {
+    async detect() {
+        const cwd = process.cwd();
+        const result = await detectRuntime(cwd);
+        if (result && result.runtime === "claude-code") {
+            return {
+                detected: true,
+                name: "Claude Code",
+                configPath: result.configPath,
+            };
+        }
+        return {
+            detected: false,
+            name: "Claude Code",
+        };
+    },
+    async installCommands(sourceDir) {
+        const cwd = process.cwd();
+        const skillsBase = join(cwd, ".claude", "skills");
+        // sourceDir is the commands/solveos/ directory
+        const files = await readdir(sourceDir);
+        for (const file of files) {
+            if (!file.endsWith(".md"))
+                continue;
+            const commandName = basename(file, ".md");
+            const sourcePath = join(sourceDir, file);
+            // Claude Code skills live in directories: .claude/skills/solveos-{name}/SKILL.md
+            const skillDir = join(skillsBase, `solveos-${commandName}`);
+            await mkdir(skillDir, { recursive: true });
+            const content = await readFile(sourcePath, "utf-8");
+            const transformed = transformCommandToSkill(content, commandName);
+            await writeFile(join(skillDir, "SKILL.md"), transformed, "utf-8");
+        }
+    },
+    async installAgents(sourceDir) {
+        const cwd = process.cwd();
+        const targetDir = join(cwd, ".claude", "agents");
+        await mkdir(targetDir, { recursive: true });
+        const files = await readdir(sourceDir);
+        for (const file of files) {
+            if (!file.endsWith(".md"))
+                continue;
+            const agentName = basename(file, ".md");
+            const sourcePath = join(sourceDir, file);
+            const content = await readFile(sourcePath, "utf-8");
+            const transformed = transformAgentForClaudeCode(content, agentName);
+            await writeFile(join(targetDir, file), transformed, "utf-8");
+        }
+    },
+    async installHooks(_sourceDir) {
+        // Claude Code hooks are configured in .claude/settings.json, not as
+        // standalone files. For now, we don't auto-configure hooks because
+        // Claude Code hooks use a different mechanism (shell commands, HTTP
+        // endpoints, or prompt-based handlers) than OpenCode's TypeScript plugins.
+        //
+        // Users can manually configure hooks in .claude/settings.json. The
+        // solveOS state files (.solveos/STATE.md, BRIEF.md) are still readable
+        // by any hook script the user configures.
+        //
+        // Future: generate a .claude/hooks/ directory with shell scripts that
+        // read solveOS state and provide context monitor / brief anchor functionality.
+    },
+};
+//# sourceMappingURL=claude-code.js.map

package/dist/lib/runtime-adapters/claude-code.js.map

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

package/dist/lib/runtime-adapters/cursor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Cursor runtime adapter for solveos-cli.
+ *
+ * Handles detection and installation of commands, agents, and hooks
+ * into Cursor's directory structure.
+ *
+ * Cursor conventions:
+ * - Skills (commands): .cursor/skills/<name>/SKILL.md -> /name
+ * - Agents:           .cursor/agents/<name>.md -> auto-delegation
+ * - Hooks:            .cursor/hooks.json -> event-based config
+ * - Rules:            .cursor/rules/<name>.mdc -> contextual instructions
+ *
+ * Cursor also reads from .claude/ and .codex/ for cross-tool compatibility,
+ * but we install to .cursor/ for clarity and priority.
+ */
+import type { RuntimeAdapter } from "../../types.js";
+export declare const cursor: RuntimeAdapter;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/lib/runtime-adapters/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../../src/lib/runtime-adapters/cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,gBAAgB,CAAC;AA8CnE,eAAO,MAAM,MAAM,EAAE,cAiEpB,CAAC"}