@scanton/phase2s 1.1.0 → 1.9.0

package/dist/src/cli/lint.js

@@ -0,0 +1,171 @@
+/**
+ * phase2s lint — validate a 5-pillar spec before running it.
+ *
+ * Runs a set of structural checks on a parsed spec and reports errors (blocking)
+ * and warnings (advisory). Designed to catch broken specs before the 20-minute
+ * dark-factory run begins.
+ *
+ * Pure check functions are exported for testing. runLint() handles all IO.
+ * Exit code reflects result: 0 = no errors (warnings OK), 1 = one or more errors.
+ */
+import { execFile } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import chalk from "chalk";
+import { parseSpec } from "../core/spec-parser.js";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Specs with more sub-tasks than this threshold get a large-spec warning. */
+const MAX_SUBTASKS_WARNING = 8;
+// ---------------------------------------------------------------------------
+// Pure validation (exported for testing)
+// ---------------------------------------------------------------------------
+/**
+ * Validate a parsed Spec for structural completeness.
+ * Returns all issues found — does not fail fast.
+ */
+export function lintSpec(spec) {
+    const issues = [];
+    // ── Errors (blocking — goal executor will fail or produce wrong results) ──
+    if (!spec.title || spec.title === "Untitled Spec") {
+        issues.push({
+            severity: "error",
+            message: "spec has no title",
+            fix: "Add a # Title line at the top of the spec file",
+        });
+    }
+    if (!spec.problemStatement || spec.problemStatement.trim() === "") {
+        issues.push({
+            severity: "error",
+            message: "## Problem Statement section is empty",
+            fix: "Describe what problem this spec solves",
+        });
+    }
+    if (spec.decomposition.length === 0) {
+        issues.push({
+            severity: "error",
+            message: "## Decomposition section has no sub-tasks",
+            fix: "Add at least one sub-task with ### Name, Input, Output, and Success Criteria",
+        });
+    }
+    if (spec.acceptanceCriteria.length === 0) {
+        issues.push({
+            severity: "error",
+            message: "## Acceptance Criteria section is empty",
+            fix: "Add at least one criterion — the goal executor checks these to determine success",
+        });
+    }
+    // ── Warnings (advisory — goal executor will run but may produce poor results) ──
+    if (spec.evalCommand === "npm test") {
+        issues.push({
+            severity: "warn",
+            message: 'evalCommand is "npm test" (the default) — confirm this is correct for your project',
+            fix: 'Add "eval: <your-test-command>" to the spec if your project uses a different test runner',
+        });
+    }
+    if (spec.decomposition.length > MAX_SUBTASKS_WARNING) {
+        issues.push({
+            severity: "warn",
+            message: `spec has ${spec.decomposition.length} sub-tasks — large specs are unreliable`,
+            fix: "Consider breaking this into multiple smaller specs (2-3 sub-tasks each) and running them sequentially",
+        });
+    }
+    for (const subtask of spec.decomposition) {
+        if (!subtask.successCriteria || subtask.successCriteria.trim() === "") {
+            issues.push({
+                severity: "warn",
+                message: `sub-task "${subtask.name || "<unnamed>"}" has no Success Criteria`,
+                fix: "Add a Success Criteria line so satori knows when the sub-task is done",
+            });
+        }
+        if (!subtask.name || subtask.name.trim() === "") {
+            issues.push({
+                severity: "warn",
+                message: "a sub-task has an empty name",
+                fix: "Give each sub-task a descriptive name under ### heading",
+            });
+        }
+    }
+    const errorCount = issues.filter((i) => i.severity === "error").length;
+    return { ok: errorCount === 0, issues };
+}
+// ---------------------------------------------------------------------------
+// runLint — entry point
+// ---------------------------------------------------------------------------
+/**
+ * Read a spec file, parse it, run lintSpec(), and print results.
+ * Returns true if there are no errors (may have warnings).
+ * Returns false if any errors were found.
+ */
+export async function runLint(specFilePath) {
+    const absPath = resolve(specFilePath);
+    if (!existsSync(absPath)) {
+        console.error(chalk.red(`  ✗  File not found: ${specFilePath}`));
+        return false;
+    }
+    let content;
+    try {
+        content = readFileSync(absPath, "utf8");
+    }
+    catch (err) {
+        console.error(chalk.red(`  ✗  Could not read ${specFilePath}: ${err.message}`));
+        return false;
+    }
+    const spec = parseSpec(content);
+    const result = lintSpec(spec);
+    // Check evalCommand's first word is on PATH.
+    // Skip when evalCommand equals the default ("npm test") — most dev machines
+    // have npm, and the existing "npm test (default)" warning already covers that.
+    // Guard against empty evalBin (parseSpec always returns a default, but be safe).
+    const evalBin = spec.evalCommand.split(/\s+/)[0];
+    if (evalBin && spec.evalCommand !== "npm test") {
+        const binOnPath = await new Promise((resolve) => {
+            execFile("which", [evalBin], { shell: false }, (err) => resolve(!err));
+        });
+        if (!binOnPath) {
+            result.issues.push({
+                severity: "warn",
+                message: `evalCommand uses "${evalBin}" which was not found on PATH (note: shell virtualenv activation is not applied here — run \`which ${evalBin}\` in your shell to verify)`,
+                fix: `Install ${evalBin} or update evalCommand to a command that is available on PATH`,
+            });
+            // ok is unchanged — PATH warnings are advisory only, not blocking errors
+        }
+    }
+    const errors = result.issues.filter((i) => i.severity === "error");
+    const warns = result.issues.filter((i) => i.severity === "warn");
+    console.log(chalk.bold(`\n  Linting ${specFilePath}\n`));
+    console.log(chalk.dim(`  Title:    ${spec.title}`));
+    console.log(chalk.dim(`  Sub-tasks: ${spec.decomposition.length}`));
+    console.log(chalk.dim(`  Criteria:  ${spec.acceptanceCriteria.length}`));
+    console.log(chalk.dim(`  Eval:      ${spec.evalCommand}`));
+    console.log("");
+    if (result.issues.length === 0) {
+        console.log(chalk.green("  ✓  Spec looks good. Ready to run phase2s goal."));
+        console.log("");
+        return true;
+    }
+    for (const issue of result.issues) {
+        if (issue.severity === "error") {
+            console.log(chalk.red(`  ✗  ${issue.message}`));
+        }
+        else {
+            console.log(chalk.yellow(`  ⚠  ${issue.message}`));
+        }
+        if (issue.fix) {
+            console.log(chalk.dim(`       ${issue.fix}`));
+        }
+    }
+    console.log("");
+    if (errors.length > 0) {
+        const plural = errors.length === 1 ? "error" : "errors";
+        const warnNote = warns.length > 0 ? `, ${warns.length} warning${warns.length === 1 ? "" : "s"}` : "";
+        console.log(chalk.red(`  ${errors.length} ${plural}${warnNote} found. Fix errors before running phase2s goal.`));
+    }
+    else {
+        console.log(chalk.yellow(`  ${warns.length} warning${warns.length === 1 ? "" : "s"} — spec is runnable but review the notes above.`));
+    }
+    console.log("");
+    return result.ok;
+}
+//# sourceMappingURL=lint.js.map

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

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

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

@@ -0,0 +1,62 @@
+/**
+ * Run log report viewer.
+ *
+ * Parses a structured JSONL run log (produced by RunLogger) and renders a
+ * chalk-colored human-readable summary of the dark factory run.
+ *
+ * Usage: phase2s report <logfile.jsonl>
+ *
+ * The report shows:
+ * - Spec filename
+ * - Pre-execution review verdict (if applicable)
+ * - Per-attempt: sub-task status + duration, eval command, criteria verdicts
+ * - Final outcome + total duration
+ */
+import type { RunEvent } from "../core/run-logger.js";
+export interface SubtaskReport {
+    index: number;
+    name: string;
+    status: "passed" | "failed";
+    durationMs?: number;
+    failureContext?: string;
+}
+export interface AttemptReport {
+    attempt: number;
+    subtasks: SubtaskReport[];
+    evalCommand?: string;
+    criteria: Array<{
+        criterion: string;
+        passed: boolean;
+    }>;
+}
+export interface RunReport {
+    specFile: string;
+    maxAttempts: number;
+    challenged: boolean;
+    challengeVerdict?: string;
+    attempts: AttemptReport[];
+    finalSuccess: boolean;
+    finalAttempts: number;
+    durationMs?: number;
+    error?: string;
+}
+/**
+ * Parse a JSONL run log file into a list of timestamped RunEvents.
+ * Throws if the file cannot be read.
+ */
+export declare function parseRunLog(logPath: string): Array<RunEvent & {
+    ts: string;
+}>;
+/**
+ * Build a structured RunReport from a list of timestamped RunEvents.
+ * Unknown or out-of-order events are silently ignored.
+ */
+export declare function buildRunReport(events: Array<RunEvent & {
+    ts: string;
+}>): RunReport;
+/**
+ * Format a RunReport as a chalk-colored string for terminal display.
+ * Safe to call in non-TTY contexts — chalk auto-detects color support.
+ */
+export declare function formatRunReport(report: RunReport): string;
+//# sourceMappingURL=report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/cli/report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAMtD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAO7E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CA+FlF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CA2DzD"}

package/dist/src/cli/report.js

@@ -0,0 +1,188 @@
+/**
+ * Run log report viewer.
+ *
+ * Parses a structured JSONL run log (produced by RunLogger) and renders a
+ * chalk-colored human-readable summary of the dark factory run.
+ *
+ * Usage: phase2s report <logfile.jsonl>
+ *
+ * The report shows:
+ * - Spec filename
+ * - Pre-execution review verdict (if applicable)
+ * - Per-attempt: sub-task status + duration, eval command, criteria verdicts
+ * - Final outcome + total duration
+ */
+import { readFileSync } from "node:fs";
+import { basename } from "node:path";
+import chalk from "chalk";
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse a JSONL run log file into a list of timestamped RunEvents.
+ * Throws if the file cannot be read.
+ */
+export function parseRunLog(logPath) {
+    const raw = readFileSync(logPath, "utf8");
+    return raw
+        .trim()
+        .split("\n")
+        .filter(Boolean)
+        .map((line) => JSON.parse(line));
+}
+/**
+ * Build a structured RunReport from a list of timestamped RunEvents.
+ * Unknown or out-of-order events are silently ignored.
+ */
+export function buildRunReport(events) {
+    const report = {
+        specFile: "",
+        maxAttempts: 3,
+        challenged: false,
+        attempts: [],
+        finalSuccess: false,
+        finalAttempts: 0,
+    };
+    let startTs = null;
+    let currentAttempt = null;
+    // Track start times for duration computation
+    const subtaskStartTimes = new Map(); // key: `${attempt}:${index}`
+    const subtaskNames = new Map(); // key: index
+    for (const raw of events) {
+        const ts = new Date(raw.ts);
+        const event = raw;
+        switch (event.event) {
+            case "goal_started":
+                report.specFile = event.specFile;
+                report.maxAttempts = event.maxAttempts;
+                startTs = ts;
+                break;
+            case "plan_review_completed":
+                if (event.verdict !== "APPROVED") {
+                    report.challenged = true;
+                    report.challengeVerdict = event.verdict;
+                }
+                break;
+            case "attempt_started":
+                currentAttempt = {
+                    attempt: event.attempt,
+                    subtasks: [],
+                    criteria: [],
+                };
+                report.attempts.push(currentAttempt);
+                break;
+            case "subtask_started":
+                subtaskNames.set(event.index, event.name);
+                subtaskStartTimes.set(`${event.attempt}:${event.index}`, ts);
+                break;
+            case "subtask_completed": {
+                if (!currentAttempt)
+                    break;
+                const name = subtaskNames.get(event.index) ?? `Sub-task ${event.index + 1}`;
+                const startTime = subtaskStartTimes.get(`${event.attempt}:${event.index}`);
+                const durationMs = startTime ? ts.getTime() - startTime.getTime() : undefined;
+                currentAttempt.subtasks.push({
+                    index: event.index,
+                    name,
+                    status: event.status,
+                    durationMs,
+                    failureContext: event.failureContext,
+                });
+                break;
+            }
+            case "eval_started":
+                if (currentAttempt)
+                    currentAttempt.evalCommand = event.command;
+                break;
+            case "criteria_checked":
+                if (currentAttempt) {
+                    for (const [criterion, passed] of Object.entries(event.results)) {
+                        currentAttempt.criteria.push({ criterion, passed: Boolean(passed) });
+                    }
+                }
+                break;
+            case "goal_completed":
+                report.finalSuccess = event.success;
+                report.finalAttempts = event.attempts;
+                if (startTs) {
+                    report.durationMs = ts.getTime() - startTs.getTime();
+                }
+                break;
+            case "goal_error":
+                report.error = event.message;
+                break;
+            default:
+                // plan_review_started, eval_completed — no action needed for report
+                break;
+        }
+    }
+    return report;
+}
+/**
+ * Format a RunReport as a chalk-colored string for terminal display.
+ * Safe to call in non-TTY contexts — chalk auto-detects color support.
+ */
+export function formatRunReport(report) {
+    const lines = [];
+    const specName = basename(report.specFile);
+    lines.push(chalk.bold(`Goal: ${specName}`));
+    if (report.error) {
+        lines.push(chalk.red(`\nError: ${report.error}`));
+        return lines.join("\n");
+    }
+    if (report.challenged) {
+        const verdict = report.challengeVerdict ?? "CHALLENGED";
+        lines.push("");
+        lines.push(`  ${chalk.yellow("⚠")}  Pre-execution review: ${chalk.yellow(verdict)}`);
+        lines.push(chalk.dim("  Run was halted before execution."));
+        return lines.join("\n");
+    }
+    for (const attempt of report.attempts) {
+        lines.push(`\n  ${chalk.dim(`Attempt ${attempt.attempt}/${report.maxAttempts}`)}`);
+        for (const subtask of attempt.subtasks) {
+            const icon = subtask.status === "passed"
+                ? chalk.green("✓")
+                : chalk.red("✗");
+            const dur = subtask.durationMs !== undefined
+                ? chalk.dim(` (${formatDuration(subtask.durationMs)})`)
+                : "";
+            lines.push(`    ${icon} ${subtask.name}${dur}`);
+        }
+        if (attempt.evalCommand) {
+            lines.push(chalk.dim(`\n  Eval: ${attempt.evalCommand}`));
+        }
+        if (attempt.criteria.length > 0) {
+            lines.push("\n  Criteria:");
+            for (const c of attempt.criteria) {
+                const icon = c.passed ? chalk.green("✓") : chalk.red("✗");
+                lines.push(`    ${icon} ${c.criterion}`);
+            }
+        }
+    }
+    const dur = report.durationMs !== undefined
+        ? chalk.dim(` — ${formatDuration(report.durationMs)}`)
+        : "";
+    const attemptsStr = `${report.finalAttempts} attempt${report.finalAttempts !== 1 ? "s" : ""}`;
+    if (report.finalSuccess) {
+        lines.push(`\n${chalk.green("✓")} ${chalk.bold("Goal complete")} — ${attemptsStr}${dur}`);
+    }
+    else if (report.finalAttempts > 0) {
+        lines.push(`\n${chalk.red("✗")} ${chalk.bold("Goal failed")} — ${attemptsStr}${dur}`);
+    }
+    else {
+        lines.push(`\n${chalk.dim("Goal did not run.")}`);
+    }
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function formatDuration(ms) {
+    const totalSeconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    if (minutes === 0)
+        return `${seconds}s`;
+    return `${minutes}m ${seconds}s`;
+}
+//# sourceMappingURL=report.js.map

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

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

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

@@ -0,0 +1,35 @@
+/**
+ * phase2s upgrade — self-update command.
+ *
+ * Checks npm registry for the latest published version and offers to install
+ * it via `npm install -g @scanton/phase2s`.
+ *
+ * Pure functions (checkLatestVersion, isUpdateAvailable, parseVersion) are
+ * exported for testing. runUpgrade() handles all IO.
+ */
+export interface VersionParts {
+    major: number;
+    minor: number;
+    patch: number;
+}
+/**
+ * Parse a semver string into major/minor/patch numbers.
+ * Returns null if the string is not a valid semver.
+ */
+export declare function parseVersion(version: string): VersionParts | null;
+/**
+ * Returns true if `latest` is strictly newer than `current`.
+ * Returns false if they are equal or `current` is newer.
+ * Returns false (safe default) if either version is unparseable.
+ */
+export declare function isUpdateAvailable(current: string, latest: string): boolean;
+/**
+ * Fetch the latest published version of a package from the npm registry.
+ * Returns null if the request fails or the response is unparseable.
+ * Times out after 5 seconds.
+ */
+export declare function checkLatestVersion(packageName: string, registryBase?: string): Promise<string | null>;
+export declare function runUpgrade(currentVersion: string, opts?: {
+    check?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=upgrade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../../src/cli/upgrade.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAKjE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAO1E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,YAAY,SAA+B,GAC1C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4BxB;AAMD,wBAAsB,UAAU,CAC9B,cAAc,EAAE,MAAM,EACtB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7B,OAAO,CAAC,IAAI,CAAC,CA+Df"}

package/dist/src/cli/upgrade.js

@@ -0,0 +1,126 @@
+/**
+ * phase2s upgrade — self-update command.
+ *
+ * Checks npm registry for the latest published version and offers to install
+ * it via `npm install -g @scanton/phase2s`.
+ *
+ * Pure functions (checkLatestVersion, isUpdateAvailable, parseVersion) are
+ * exported for testing. runUpgrade() handles all IO.
+ */
+import { get } from "node:https";
+import { spawnSync } from "node:child_process";
+import { createInterface } from "node:readline";
+import chalk from "chalk";
+// ---------------------------------------------------------------------------
+// Pure helpers (exported for testing)
+// ---------------------------------------------------------------------------
+/**
+ * Parse a semver string into major/minor/patch numbers.
+ * Returns null if the string is not a valid semver.
+ */
+export function parseVersion(version) {
+    const clean = version.replace(/^v/, "");
+    const parts = clean.split(".").map(Number);
+    if (parts.length !== 3 || parts.some((n) => isNaN(n) || n < 0))
+        return null;
+    return { major: parts[0], minor: parts[1], patch: parts[2] };
+}
+/**
+ * Returns true if `latest` is strictly newer than `current`.
+ * Returns false if they are equal or `current` is newer.
+ * Returns false (safe default) if either version is unparseable.
+ */
+export function isUpdateAvailable(current, latest) {
+    const c = parseVersion(current);
+    const l = parseVersion(latest);
+    if (!c || !l)
+        return false;
+    if (l.major !== c.major)
+        return l.major > c.major;
+    if (l.minor !== c.minor)
+        return l.minor > c.minor;
+    return l.patch > c.patch;
+}
+/**
+ * Fetch the latest published version of a package from the npm registry.
+ * Returns null if the request fails or the response is unparseable.
+ * Times out after 5 seconds.
+ */
+export function checkLatestVersion(packageName, registryBase = "https://registry.npmjs.org") {
+    return new Promise((resolve) => {
+        const url = `${registryBase}/${encodeURIComponent(packageName)}/latest`;
+        const req = get(url, { headers: { Accept: "application/json" } }, (res) => {
+            let data = "";
+            res.on("data", (chunk) => {
+                data += chunk.toString();
+            });
+            res.on("end", () => {
+                try {
+                    const json = JSON.parse(data);
+                    resolve(typeof json.version === "string" ? json.version : null);
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+            res.on("error", () => resolve(null));
+        });
+        req.on("error", () => resolve(null));
+        req.setTimeout(5000, () => {
+            req.destroy();
+            resolve(null);
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// runUpgrade — entry point
+// ---------------------------------------------------------------------------
+export async function runUpgrade(currentVersion, opts = {}) {
+    process.stdout.write(chalk.dim("  Checking for updates...\n"));
+    const latest = await checkLatestVersion("@scanton/phase2s");
+    if (!latest) {
+        console.log(chalk.yellow("  Could not reach npm registry. Check your network connection."));
+        return;
+    }
+    if (!isUpdateAvailable(currentVersion, latest)) {
+        console.log(chalk.green(`  You're on the latest version`) +
+            chalk.dim(` (v${currentVersion})`));
+        return;
+    }
+    console.log(chalk.bold(`\n  phase2s v${currentVersion}`) +
+        chalk.dim(" → ") +
+        chalk.green(`v${latest} available`));
+    if (opts.check) {
+        // --check: just report, don't prompt
+        console.log(chalk.dim(`  Run: npm install -g @scanton/phase2s`));
+        return;
+    }
+    // Interactive prompt
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise((resolve) => {
+        rl.question(chalk.cyan("  Upgrade now? [y/N] "), (ans) => {
+            rl.close();
+            resolve(ans.trim().toLowerCase());
+        });
+    });
+    if (answer !== "y" && answer !== "yes") {
+        console.log(chalk.dim("  Skipped. Run `npm install -g @scanton/phase2s` when ready."));
+        return;
+    }
+    console.log(chalk.dim("\n  Running: npm install -g @scanton/phase2s\n"));
+    const result = spawnSync("npm", ["install", "-g", "@scanton/phase2s"], {
+        stdio: "inherit",
+        shell: false,
+    });
+    if (result.status === 0) {
+        console.log(chalk.green(`\n  Upgraded to v${latest}. Restart phase2s to use the new version.`));
+    }
+    else {
+        console.log(chalk.red("\n  npm install failed. Try running manually:") +
+            chalk.bold("\n  npm install -g @scanton/phase2s"));
+        if (result.error) {
+            console.log(chalk.dim(`  Error: ${result.error.message}`));
+        }
+    }
+}
+//# sourceMappingURL=upgrade.js.map

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

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