@scanton/phase2s 1.0.0 → 1.8.0

package/README.md

@@ -228,7 +228,7 @@ phase2s skills --json # machine-readable for scripts
 - [x] Codex CLI provider (ChatGPT subscription, no API key required)
 - [x] 29 built-in skills across 6 categories
 - [x] File sandbox: tools reject paths outside project directory, including symlink escapes
-- [x] 399 tests covering all tools, core modules, agent integration, and goal executor
+- [x] 582 tests covering all tools, core modules, agent integration, goal executor, state server, run logs, MCP goal tool, notification gateway, run report viewer, onboarding wizard, glob tool filtering, OpenRouter provider, Gemini provider, installation health checks, self-update, skills search, and spec linting
 - [x] CI: runs `npm test` on every push and PR
 - [x] OpenAI API provider with live tool calling
 - [x] Anthropic API provider — Claude 3.5 Sonnet and family
@@ -254,6 +254,23 @@ phase2s skills --json # machine-readable for scripts
 - [x] `phase2s goal <spec.md>` — dark factory: spec in, feature out
 - [x] 5-pillar spec format — `/deep-specify` output feeds directly into `phase2s goal`
 - [x] Real Codex streaming (JSONL stdout parsing) — step-by-step feedback for multi-step tasks
+- [x] MCP state server — `state_read`/`state_write`/`state_clear` as Claude Code tools
+- [x] `phase2s goal --resume` — dark factory continuity: resumes from last completed sub-task after interruption
+- [x] `phase2s__goal` MCP tool — Claude Code can trigger the dark factory directly, no terminal needed
+- [x] Structured JSONL run logs — per-sub-task observability at `.phase2s/runs/<timestamp>.jsonl`
+- [x] `--review-before-run` — adversarial pre-execution review before the dark factory starts
+- [x] Notification gateway — `phase2s goal --notify` sends macOS system notification + optional Slack webhook on completion
+- [x] `phase2s report <log.jsonl>` — chalk-colored run summary: sub-task timeline, durations, criteria verdicts, total time
+- [x] `phase2s__report` MCP tool — Claude Code can summarize a run log after triggering the dark factory
+- [x] `phase2s init` — interactive onboarding wizard: provider choice, API key, model tiers, Slack/Discord/Teams webhooks, pre-fills from existing config
+- [x] Discord + Microsoft Teams notification channels for dark factory runs (`--notify`)
+- [x] Glob/wildcard patterns in `tools` and `deny` config (`file_*` matches `file_read` and `file_write`)
+- [x] OpenRouter provider — 50+ models (GPT-4o, Claude, Gemini, Llama) under a single `OPENROUTER_API_KEY`
+- [x] `phase2s doctor` — installation health check: Node version, provider binary, auth, config, working dir
+- [x] `phase2s upgrade` — self-update: checks npm registry, prompts to install, `--check` for CI
+- [x] `phase2s skills [query]` — filter the skill list by name or description (`phase2s skills security`)
+- [x] Google Gemini provider — free tier, `gemini-2.0-flash` default, OpenAI-compatible endpoint, no new SDK dependency
+- [x] `phase2s lint <spec.md>` — validate a spec before a dark factory run: catches structural errors before the 20-minute agent loop begins
 
 ---
 

package/dist/src/cli/doctor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * phase2s doctor — installation health check.
+ *
+ * Runs a set of diagnostic checks and reports pass/fail with fix instructions.
+ * Designed to answer "why isn't phase2s working?" without reading source code.
+ *
+ * Pure check functions are exported for testing. runDoctor() handles all IO.
+ */
+export interface CheckResult {
+    name: string;
+    ok: boolean;
+    detail: string;
+    /** Printed below the ✗ line when ok is false. */
+    fix?: string;
+}
+/**
+ * Check that Node.js >= 20 is running.
+ */
+export declare function checkNodeVersion(): CheckResult;
+/**
+ * Check that the provider binary is available in PATH (codex-cli and ollama only).
+ * Returns ok:true immediately for providers that don't need a binary.
+ */
+export declare function checkProviderBinary(provider: string, codexPath?: string): CheckResult;
+/**
+ * Check authentication / API key availability for the configured provider.
+ */
+export declare function checkAuth(provider: string, config?: Record<string, unknown>): CheckResult;
+/**
+ * Check that .phase2s.yaml exists and contains a valid provider value.
+ * Returns ok:true if the file is absent (config is optional).
+ */
+export declare function checkConfigFile(configPath: string): CheckResult;
+/**
+ * Check that the .phase2s/ working directory is writable (or can be created).
+ */
+export declare function checkWorkDir(dirPath: string): CheckResult;
+export declare function runDoctor(): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/src/cli/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAU9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAU,GAAG,WAAW,CA2BtF;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,WAAW,CAyEb;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAgC/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAezD;AAMD,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAoD/C"}

package/dist/src/cli/doctor.js

@@ -0,0 +1,244 @@
+/**
+ * phase2s doctor — installation health check.
+ *
+ * Runs a set of diagnostic checks and reports pass/fail with fix instructions.
+ * Designed to answer "why isn't phase2s working?" without reading source code.
+ *
+ * Pure check functions are exported for testing. runDoctor() handles all IO.
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync, accessSync, mkdirSync, constants } from "node:fs";
+import { resolve, join } from "node:path";
+import chalk from "chalk";
+import { parse as parseYaml } from "yaml";
+import { readFileSync } from "node:fs";
+// ---------------------------------------------------------------------------
+// Pure check functions (exported for testing)
+// ---------------------------------------------------------------------------
+/**
+ * Check that Node.js >= 20 is running.
+ */
+export function checkNodeVersion() {
+    const version = process.version; // e.g. "v22.1.0"
+    const major = parseInt(version.slice(1).split(".")[0], 10);
+    const ok = major >= 20;
+    return {
+        name: "Node.js version",
+        ok,
+        detail: `${version} (required: >= 20)`,
+        fix: ok ? undefined : `Upgrade Node.js to v20 or later: https://nodejs.org`,
+    };
+}
+/**
+ * Check that the provider binary is available in PATH (codex-cli and ollama only).
+ * Returns ok:true immediately for providers that don't need a binary.
+ */
+export function checkProviderBinary(provider, codexPath = "codex") {
+    if (provider === "codex-cli") {
+        const result = spawnSync(codexPath, ["--version"], { stdio: "pipe" });
+        const ok = !result.error && result.status === 0;
+        return {
+            name: "codex CLI",
+            ok,
+            detail: ok ? `found (${codexPath})` : "not found in PATH",
+            fix: ok ? undefined : "npm install -g @openai/codex",
+        };
+    }
+    if (provider === "ollama") {
+        const result = spawnSync("ollama", ["list"], { stdio: "pipe" });
+        const ok = !result.error && result.status === 0;
+        return {
+            name: "ollama",
+            ok,
+            detail: ok ? "found" : "not found in PATH",
+            fix: ok
+                ? undefined
+                : "Install from https://ollama.com then run: ollama serve",
+        };
+    }
+    // Other providers need no binary
+    return { name: "provider binary", ok: true, detail: "N/A" };
+}
+/**
+ * Check authentication / API key availability for the configured provider.
+ */
+export function checkAuth(provider, config = {}) {
+    switch (provider) {
+        case "codex-cli": {
+            const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
+            const codexDir = join(home, ".codex");
+            const ok = existsSync(codexDir);
+            return {
+                name: "codex authentication",
+                ok,
+                detail: ok ? `~/.codex/ found` : "~/.codex/ not found",
+                fix: ok ? undefined : "Run: codex auth",
+            };
+        }
+        case "openai-api": {
+            const key = config.apiKey ?? process.env.OPENAI_API_KEY;
+            const ok = Boolean(key);
+            return {
+                name: "OpenAI API key",
+                ok,
+                detail: ok ? "set" : "missing",
+                fix: ok ? undefined : "Set OPENAI_API_KEY or run phase2s init",
+            };
+        }
+        case "anthropic": {
+            const key = config.anthropicApiKey ?? process.env.ANTHROPIC_API_KEY;
+            const ok = Boolean(key);
+            return {
+                name: "Anthropic API key",
+                ok,
+                detail: ok ? "set" : "missing",
+                fix: ok ? undefined : "Set ANTHROPIC_API_KEY or run phase2s init",
+            };
+        }
+        case "openrouter": {
+            const key = config.openrouterApiKey ?? process.env.OPENROUTER_API_KEY;
+            const ok = Boolean(key);
+            return {
+                name: "OpenRouter API key",
+                ok,
+                detail: ok ? "set" : "missing",
+                fix: ok ? undefined : "Set OPENROUTER_API_KEY or run phase2s init",
+            };
+        }
+        case "gemini": {
+            const key = config.geminiApiKey ?? process.env.GEMINI_API_KEY;
+            const present = Boolean(key);
+            const validPrefix = !key || key.startsWith("AIza");
+            return {
+                name: "Gemini API key",
+                ok: present,
+                detail: !present
+                    ? "missing"
+                    : !validPrefix
+                        ? "set (note: Gemini keys normally start with AIza — verify key is correct)"
+                        : "set",
+                fix: !present
+                    ? "Set GEMINI_API_KEY or run phase2s init. Get a free key at https://aistudio.google.com/apikey"
+                    : !validPrefix
+                        ? "Verify you are using a Gemini API key from https://aistudio.google.com/apikey"
+                        : undefined,
+            };
+        }
+        case "ollama":
+            return { name: "auth", ok: true, detail: "N/A (no auth required)" };
+        default:
+            return { name: "auth", ok: true, detail: "unknown provider" };
+    }
+}
+/**
+ * Check that .phase2s.yaml exists and contains a valid provider value.
+ * Returns ok:true if the file is absent (config is optional).
+ */
+export function checkConfigFile(configPath) {
+    if (!existsSync(configPath)) {
+        return {
+            name: ".phase2s.yaml",
+            ok: true,
+            detail: "not present (using defaults — run phase2s init to create one)",
+        };
+    }
+    try {
+        const raw = readFileSync(configPath, "utf8");
+        const parsed = parseYaml(raw);
+        const provider = parsed?.provider;
+        const knownProviders = ["codex-cli", "openai-api", "anthropic", "ollama", "openrouter", "gemini"];
+        if (provider && !knownProviders.includes(provider)) {
+            return {
+                name: ".phase2s.yaml",
+                ok: false,
+                detail: `unknown provider: ${provider}`,
+                fix: `Valid providers: ${knownProviders.join(", ")}`,
+            };
+        }
+        const providerStr = provider ? `provider: ${provider}` : "no provider set (using default)";
+        return { name: ".phase2s.yaml", ok: true, detail: providerStr };
+    }
+    catch {
+        return {
+            name: ".phase2s.yaml",
+            ok: false,
+            detail: "could not be parsed",
+            fix: "Run phase2s init to regenerate it, or check for YAML syntax errors",
+        };
+    }
+}
+/**
+ * Check that the .phase2s/ working directory is writable (or can be created).
+ */
+export function checkWorkDir(dirPath) {
+    try {
+        if (!existsSync(dirPath)) {
+            mkdirSync(dirPath, { recursive: true });
+        }
+        accessSync(dirPath, constants.W_OK);
+        return { name: ".phase2s/", ok: true, detail: "writable" };
+    }
+    catch {
+        return {
+            name: ".phase2s/",
+            ok: false,
+            detail: "not writable",
+            fix: `Check permissions on ${dirPath}`,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// runDoctor — entry point
+// ---------------------------------------------------------------------------
+export async function runDoctor() {
+    console.log(chalk.bold("\n  Phase2S doctor\n"));
+    // Load existing config to inform checks (best-effort — errors are surfaced by checkConfigFile)
+    const configPath = resolve(".phase2s.yaml");
+    let existingConfig = {};
+    let provider = "codex-cli";
+    try {
+        if (existsSync(configPath)) {
+            const raw = readFileSync(configPath, "utf8");
+            const parsed = parseYaml(raw);
+            if (parsed && typeof parsed === "object") {
+                existingConfig = parsed;
+                provider = parsed.provider ?? "codex-cli";
+            }
+        }
+    }
+    catch {
+        // checkConfigFile will report this; we continue with defaults
+    }
+    const checks = [
+        checkNodeVersion(),
+        checkProviderBinary(provider, existingConfig.codexPath ?? "codex"),
+        checkAuth(provider, existingConfig),
+        checkConfigFile(configPath),
+        checkWorkDir(resolve(".phase2s")),
+    ];
+    // Filter out N/A checks (provider binary for non-binary providers)
+    const relevant = checks.filter((c) => c.detail !== "N/A");
+    let failCount = 0;
+    for (const check of relevant) {
+        if (check.ok) {
+            console.log(chalk.green(`  ✓  ${check.name}`) + chalk.dim(`  ${check.detail}`));
+        }
+        else {
+            failCount++;
+            console.log(chalk.red(`  ✗  ${check.name}`) + chalk.dim(`  ${check.detail}`));
+            if (check.fix) {
+                console.log(chalk.dim(`       ${check.fix}`));
+            }
+        }
+    }
+    console.log("");
+    if (failCount === 0) {
+        console.log(chalk.green("  All checks passed. Phase2S is ready."));
+    }
+    else {
+        const plural = failCount === 1 ? "issue" : "issues";
+        console.log(chalk.yellow(`  ${failCount} ${plural} found. Run phase2s init to reconfigure.`));
+    }
+    console.log("");
+}
+//# sourceMappingURL=doctor.js.map

package/dist/src/cli/doctor.js.map

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

package/dist/src/cli/goal.d.ts

@@ -6,19 +6,56 @@
  * output, retries failed sub-tasks with failure context, and loops until all
  * criteria pass or max attempts are exhausted.
  *
- * Usage: phase2s goal <spec-file> [--max-attempts <n>]
+ * Usage: phase2s goal <spec-file> [--max-attempts <n>] [--resume] [--review-before-run]
+ *
+ * With --resume: reads existing state from .phase2s/state/<hash>.json
+ * (relative to the spec file directory), skips completed sub-tasks, and
+ * injects saved failure context for failed ones. Starts fresh if no state
+ * exists.
+ *
+ * With --review-before-run: runs the spec through adversarial review (fresh
+ * Agent instance, adversarial SKILL.md template) before execution begins.
+ * Halts and returns challenged: true if verdict is CHALLENGED or
+ * NEEDS_CLARIFICATION.
  */
 import { Agent } from "../core/agent.js";
 import { type Spec, type SubTask } from "../core/spec-parser.js";
+import { type NotifyOptions } from "../core/notify.js";
 export interface GoalOptions {
     maxAttempts?: string;
+    resume?: boolean;
+    reviewBeforeRun?: boolean;
+    /**
+     * If true, use notification config from loadConfig().
+     * If a NotifyOptions object, override with those settings.
+     * Notification is sent after the run completes (success, failure, or challenge).
+     */
+    notify?: boolean | NotifyOptions;
 }
 export interface GoalResult {
     success: boolean;
     attempts: number;
     criteriaResults: Record<string, boolean>;
+    /** Absolute path to the structured JSONL run log. */
+    runLogPath: string;
+    /** One-liner summary for MCP response text. */
+    summary: string;
+    /** Total wall-clock duration of the run in milliseconds. */
+    durationMs: number;
+    /** true if pre-execution adversarial review halted the run. */
+    challenged?: boolean;
+    /** Full adversarial review text when challenged is true. */
+    challengeResponse?: string;
 }
 export declare function runGoal(specFile: string, options?: GoalOptions): Promise<GoalResult>;
+/**
+ * Build a pre-execution adversarial review prompt.
+ *
+ * Injects the spec's decomposition and acceptance criteria as the "plan" to
+ * challenge, then appends the adversarial SKILL.md template which instructs
+ * the model to review what came before it and emit a structured verdict.
+ */
+export declare function buildAdversarialPrompt(spec: Spec, adversarialTemplate: string): string;
 export declare function buildSatoriContext(subtask: SubTask, constraints: Spec["constraints"], failureContext?: string): string;
 export declare function checkCriteria(criteria: string[], evalOutput: string, agent: Agent): Promise<Record<string, boolean>>;
 export declare function analyzeFailures(failing: string[], evalOutput: string, spec: Spec, agent: Agent): Promise<string>;

package/dist/src/cli/goal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"goal.d.ts","sourceRoot":"","sources":["../../../src/cli/goal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,OAAO,EAAa,KAAK,IAAI,EAAE,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAI5E,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiH9F;AAMD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,EAChC,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAwBR;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwClC;AAeD,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EAAE,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EAAE,EACjB,aAAa,EAAE,OAAO,EAAE,EACxB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,OAAO,EAAE,CAAC,CA8BpB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlF"}
+{"version":3,"file":"goal.d.ts","sourceRoot":"","sources":["../../../src/cli/goal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,OAAO,EAAa,KAAK,IAAI,EAAE,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAG5E,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAO7F,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAmT9F;AA8CD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAyBtF;AAMD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC,EAChC,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CAwBR;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwClC;AAeD,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EAAE,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EAAE,EACjB,aAAa,EAAE,OAAO,EAAE,EACxB,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,OAAO,EAAE,CAAC,CA8BpB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBlF"}