youmd 0.6.21 → 0.6.27

package/dist/commands/stack.js

@@ -0,0 +1,863 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stackCommand = stackCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const api_1 = require("../lib/api");
+const projectContext_1 = require("../lib/projectContext");
+const host_link_1 = require("../lib/host-link");
+const youstack_1 = require("../lib/youstack");
+const capability_router_1 = require("../lib/capability-router");
+const stackEval_1 = require("../lib/stackEval");
+const stackImprove_1 = require("../lib/stackImprove");
+const stackUpdate_1 = require("../lib/stackUpdate");
+const stackInstall_1 = require("../lib/stackInstall");
+const heartbeat_1 = require("../lib/heartbeat");
+const ACCENT = chalk_1.default.hex("#C46A3A");
+const DIM = chalk_1.default.dim;
+function printHelp() {
+    console.log("");
+    console.log("  " + chalk_1.default.bold("youmd stack") + DIM(" -- local YouStack manifest tools"));
+    console.log("");
+    console.log("  " + ACCENT("Commands"));
+    console.log("    " + chalk_1.default.cyan("inspect") + DIM("              Show the local stack manifest summary"));
+    console.log("    " + chalk_1.default.cyan("doctor") + DIM("               Run read-only stack health diagnostics"));
+    console.log("    " + chalk_1.default.cyan("smoke") + DIM("                Run read-only local manifest/file checks"));
+    console.log("    " + chalk_1.default.cyan("capabilities") + DIM("         List declared local capabilities"));
+    console.log("    " + chalk_1.default.cyan("route \"...\"") + DIM("          Pick the best local capability for a request"));
+    console.log("    " + chalk_1.default.cyan("link") + DIM("                 Generate host adapter files from the manifest"));
+    console.log("    " + chalk_1.default.cyan("guard") + DIM("                Check safety contract (T0-T3) and capability consistency"));
+    console.log("    " + chalk_1.default.cyan("eval") + DIM("                 Run golden-prompt eval suite (--init to scaffold)"));
+    console.log("    " + chalk_1.default.cyan("improve") + DIM("              Gather signals + write proposals to journal/ (--mode propose|auto_pr)"));
+    console.log("    " + chalk_1.default.cyan("update") + DIM("               Check for a newer upstream version (--apply to write it)"));
+    console.log("    " + chalk_1.default.cyan("install <user>/<slug>") + DIM(" Install a public stack from the registry"));
+    console.log("    " + chalk_1.default.cyan("proposals") + DIM("            List open maintainer proposals for your stacks"));
+    console.log("    " + chalk_1.default.cyan("proposals approve <id>") + DIM(" Approve a maintainer proposal"));
+    console.log("    " + chalk_1.default.cyan("proposals reject <id>") + DIM("  Reject a maintainer proposal"));
+    console.log("    " + chalk_1.default.cyan("consent") + DIM("              Show your brainScope consent settings"));
+    console.log("    " + chalk_1.default.cyan("consent grant <scope>") + DIM("  Grant a brainScope (consolidate|fleet_aggregate|journal_mine)"));
+    console.log("    " + chalk_1.default.cyan("consent revoke <scope>") + DIM(" Revoke a brainScope"));
+    console.log("");
+    console.log("  " + DIM("Options: ") + chalk_1.default.cyan("--path <manifest-or-dir>") + DIM(", ") + chalk_1.default.cyan("--hosts claude-code,codex,cursor") + DIM(", ") + chalk_1.default.cyan("--target <dir>") + DIM(", ") + chalk_1.default.cyan("--dry-run") + DIM(", ") + chalk_1.default.cyan("--verify") + DIM(", ") + chalk_1.default.cyan("--json") + DIM(", ") + chalk_1.default.cyan("--init") + DIM(", ") + chalk_1.default.cyan("--mode propose|auto_pr") + DIM(", ") + chalk_1.default.cyan("--apply") + DIM(", ") + chalk_1.default.cyan("--force") + DIM(", ") + chalk_1.default.cyan("--dir <path>"));
+    console.log("");
+    console.log("  " + DIM("Canonical layout: ") + chalk_1.default.cyan("stacks/<slug>/youstack.json") + DIM(" (legacy youstack.json, .you/, and youstacks/ still load)"));
+    console.log("");
+}
+function printValidation(validation) {
+    for (const warning of validation.warnings) {
+        console.log("  " + chalk_1.default.yellow("WARN") + " " + warning);
+    }
+    for (const error of validation.errors) {
+        console.log("  " + chalk_1.default.red("FAIL") + " " + error);
+    }
+}
+function capabilityLabel(capability) {
+    const mode = capability.localOnly ? "local" : capability.mcpTool || capability.apiEndpoint ? "api/mcp" : "mixed";
+    const policy = capability.mutationPolicy || "unspecified";
+    return `${capability.id} ${DIM(`[${mode}; ${policy}]`)}`;
+}
+async function stackCommand(subcommand, args = [], options = {}) {
+    const cmd = subcommand || "help";
+    if (cmd === "help" || cmd === "--help" || cmd === "-h") {
+        printHelp();
+        return;
+    }
+    // ── P9: stack install ────────────────────────────────────────────────────────
+    if (cmd === "install") {
+        const ref = args[0] ?? "";
+        const slash = ref.indexOf("/");
+        if (!ref || slash <= 0 || slash === ref.length - 1) {
+            console.log("");
+            console.log(chalk_1.default.yellow("  usage: youmd stack install <user>/<slug>"));
+            console.log("  " + DIM("example: youmd stack install houston/coding-stack"));
+            console.log("");
+            process.exitCode = 1;
+            return;
+        }
+        const user = ref.slice(0, slash);
+        const slug = ref.slice(slash + 1);
+        const { BrailleSpinner } = await Promise.resolve().then(() => __importStar(require("../lib/render")));
+        const spinner = new BrailleSpinner(`fetching ${ACCENT(ref)} from registry`);
+        spinner.start();
+        try {
+            const result = await (0, stackInstall_1.installStack)(user, slug, {
+                dir: options.dir,
+                force: options.force,
+            });
+            spinner.stop();
+            if (options.json) {
+                console.log(JSON.stringify({
+                    slug: result.slug,
+                    targetDir: result.targetDir,
+                    filesWritten: result.filesWritten,
+                    hostLinks: result.hostLinks,
+                }, null, 2));
+                return;
+            }
+            console.log("");
+            console.log("  " + ACCENT("youstack install") + " " + chalk_1.default.bold(ref));
+            console.log("  " + DIM("slug: ") + chalk_1.default.cyan(result.slug));
+            console.log("  " + DIM("dir:  ") + result.targetDir);
+            console.log("");
+            for (const f of result.filesWritten) {
+                console.log("  " + chalk_1.default.green("WROTE") + " " + f);
+            }
+            if (result.hostLinks.length > 0) {
+                console.log("");
+                for (const link of result.hostLinks) {
+                    console.log("  " + chalk_1.default.green("LINKED") + " " + link);
+                }
+            }
+            console.log("");
+            console.log("  " + chalk_1.default.green("installed.") + " " + DIM(`run \`youmd stack doctor --path ${result.targetDir}\` to validate.`));
+            console.log("");
+        }
+        catch (err) {
+            spinner.fail("install failed");
+            const e = err;
+            console.log("");
+            if (e.code === "not_found") {
+                console.log(chalk_1.default.red("  not found: ") + e.message);
+            }
+            else if (e.code === "conflict") {
+                console.log(chalk_1.default.red("  conflict: ") + e.message);
+            }
+            else if (e.code === "invalid_manifest") {
+                console.log(chalk_1.default.red("  invalid manifest: ") + e.message);
+                if (e.validationErrors) {
+                    for (const ve of e.validationErrors) {
+                        console.log("    " + DIM(ve));
+                    }
+                }
+            }
+            else {
+                console.log(chalk_1.default.red("  error: ") + e.message);
+            }
+            console.log("");
+            process.exitCode = 1;
+        }
+        return;
+    }
+    // ── L26: stack proposals ─────────────────────────────────────────────────────
+    if (cmd === "proposals") {
+        const sub = args[0]; // "approve" | "reject" | undefined
+        const { BrailleSpinner } = await Promise.resolve().then(() => __importStar(require("../lib/render")));
+        if (sub === "approve" || sub === "reject") {
+            const id = args[1];
+            if (!id) {
+                console.log("");
+                console.log(chalk_1.default.yellow(`  usage: youmd stack proposals ${sub} <id>`));
+                console.log("");
+                process.exitCode = 1;
+                return;
+            }
+            const decision = sub === "approve" ? "approved" : "rejected";
+            const spinner = new BrailleSpinner(`submitting ${sub} decision`);
+            spinner.start();
+            try {
+                const res = await (0, api_1.setProposalDecision)(id, decision);
+                spinner.stop();
+                if (!res.ok) {
+                    const msg = (0, api_1.apiErrorMessage)(res.data) ?? `request failed (${res.status})`;
+                    console.log("");
+                    console.log(chalk_1.default.red(`  proposals ${sub}: `) + msg);
+                    console.log("");
+                    process.exitCode = 1;
+                    return;
+                }
+                console.log("");
+                console.log("  " + chalk_1.default.green(sub === "approve" ? "approved" : "rejected") + " proposal " + ACCENT(id));
+                console.log("");
+            }
+            catch (err) {
+                spinner.fail(`proposals ${sub} failed`);
+                console.log("");
+                console.log(chalk_1.default.red("  error: ") + (err instanceof Error ? err.message : String(err)));
+                console.log("");
+                process.exitCode = 1;
+            }
+            return;
+        }
+        // list
+        const spinner = new BrailleSpinner("fetching maintainer proposals");
+        spinner.start();
+        try {
+            const res = await (0, api_1.listMaintainerProposals)();
+            spinner.stop();
+            if (!res.ok) {
+                const msg = (0, api_1.apiErrorMessage)(res.data) ?? `request failed (${res.status})`;
+                console.log("");
+                console.log(chalk_1.default.red("  proposals: ") + msg);
+                console.log("");
+                process.exitCode = 1;
+                return;
+            }
+            const { proposals } = res.data;
+            console.log("");
+            if (!proposals || proposals.length === 0) {
+                console.log("  " + chalk_1.default.dim("no proposals — your stacks are clean"));
+                console.log("");
+                return;
+            }
+            console.log("  " + ACCENT("maintainer proposals") + DIM(` (${proposals.length})`));
+            console.log("");
+            const idW = 20, stackW = 16, skillW = 24, evW = 5, stateW = 10;
+            console.log("  " +
+                chalk_1.default.bold("id".padEnd(idW)) +
+                chalk_1.default.bold("stack".padEnd(stackW)) +
+                chalk_1.default.bold("skill".padEnd(skillW)) +
+                chalk_1.default.bold("ev".padEnd(evW)) +
+                chalk_1.default.bold("state".padEnd(stateW)));
+            console.log("  " + DIM("-".repeat(idW + stackW + skillW + evW + stateW)));
+            for (const p of proposals) {
+                const shortId = String(p.proposalId).slice(-12);
+                const stateColor = p.humanApprovalState === "approved" ? chalk_1.default.green :
+                    p.humanApprovalState === "rejected" ? chalk_1.default.red :
+                        chalk_1.default.dim;
+                console.log("  " +
+                    chalk_1.default.cyan(shortId.padEnd(idW)) +
+                    String(p.stackSlug).slice(0, stackW - 1).padEnd(stackW) +
+                    String(p.skillName).slice(0, skillW - 1).padEnd(skillW) +
+                    String(p.evidenceCount).padEnd(evW) +
+                    stateColor(String(p.humanApprovalState).padEnd(stateW)));
+            }
+            console.log("");
+            console.log("  " + DIM("use `youmd stack proposals approve <id>` or `youmd stack proposals reject <id>`"));
+            console.log("");
+        }
+        catch (err) {
+            spinner.fail("proposals fetch failed");
+            console.log("");
+            console.log(chalk_1.default.red("  error: ") + (err instanceof Error ? err.message : String(err)));
+            console.log("");
+            process.exitCode = 1;
+        }
+        return;
+    }
+    // ── L26: stack consent ───────────────────────────────────────────────────────
+    if (cmd === "consent") {
+        const sub = args[0]; // "grant" | "revoke" | undefined
+        const { BrailleSpinner } = await Promise.resolve().then(() => __importStar(require("../lib/render")));
+        if (sub === "grant" || sub === "revoke") {
+            const scope = args[1];
+            if (!scope) {
+                console.log("");
+                console.log(chalk_1.default.yellow(`  usage: youmd stack consent ${sub} <scope>`));
+                console.log("  " + DIM("scopes: consolidate, fleet_aggregate, journal_mine"));
+                console.log("");
+                process.exitCode = 1;
+                return;
+            }
+            const granted = sub === "grant";
+            const spinner = new BrailleSpinner(`${granted ? "granting" : "revoking"} ${scope}`);
+            spinner.start();
+            try {
+                const res = await (0, api_1.setBrainConsent)(scope, granted);
+                spinner.stop();
+                if (!res.ok) {
+                    const msg = (0, api_1.apiErrorMessage)(res.data) ?? `request failed (${res.status})`;
+                    console.log("");
+                    console.log(chalk_1.default.red(`  consent ${sub}: `) + msg);
+                    console.log("");
+                    process.exitCode = 1;
+                    return;
+                }
+                console.log("");
+                console.log("  " +
+                    (granted ? chalk_1.default.green("granted") : chalk_1.default.red("revoked")) +
+                    " " + ACCENT(scope));
+                console.log("");
+            }
+            catch (err) {
+                spinner.fail(`consent ${sub} failed`);
+                console.log("");
+                console.log(chalk_1.default.red("  error: ") + (err instanceof Error ? err.message : String(err)));
+                console.log("");
+                process.exitCode = 1;
+            }
+            return;
+        }
+        // list
+        const spinner = new BrailleSpinner("fetching brain consent settings");
+        spinner.start();
+        try {
+            const res = await (0, api_1.listBrainConsent)();
+            spinner.stop();
+            if (!res.ok) {
+                const msg = (0, api_1.apiErrorMessage)(res.data) ?? `request failed (${res.status})`;
+                console.log("");
+                console.log(chalk_1.default.red("  consent: ") + msg);
+                console.log("");
+                process.exitCode = 1;
+                return;
+            }
+            const { consents } = res.data;
+            console.log("");
+            console.log("  " + ACCENT("brain consent settings"));
+            console.log("");
+            const scopeW = 22, grantedW = 10, explicitW = 12;
+            console.log("  " +
+                chalk_1.default.bold("scope".padEnd(scopeW)) +
+                chalk_1.default.bold("granted".padEnd(grantedW)) +
+                chalk_1.default.bold("explicit".padEnd(explicitW)));
+            console.log("  " + DIM("-".repeat(scopeW + grantedW + explicitW)));
+            for (const c of consents) {
+                const grantedStr = c.granted ? chalk_1.default.green("yes") : chalk_1.default.red("no");
+                const explicitStr = c.explicit ? chalk_1.default.cyan("yes") : chalk_1.default.dim("no (default)");
+                console.log("  " +
+                    String(c.scope).padEnd(scopeW) +
+                    (c.granted ? chalk_1.default.green("yes".padEnd(grantedW)) : chalk_1.default.red("no".padEnd(grantedW))) +
+                    (c.explicit ? chalk_1.default.cyan("yes") : chalk_1.default.dim("no (default)")));
+                void grantedStr;
+                void explicitStr;
+            }
+            console.log("");
+            console.log("  " + DIM("use `youmd stack consent revoke <scope>` or `youmd stack consent grant <scope>`"));
+            console.log("");
+        }
+        catch (err) {
+            spinner.fail("consent fetch failed");
+            console.log("");
+            console.log(chalk_1.default.red("  error: ") + (err instanceof Error ? err.message : String(err)));
+            console.log("");
+            process.exitCode = 1;
+        }
+        return;
+    }
+    let loaded;
+    try {
+        loaded = (0, youstack_1.loadYouStackManifest)(options.path);
+    }
+    catch (error) {
+        console.log("");
+        console.log(chalk_1.default.red("  youmd stack: ") + (error instanceof Error ? error.message : String(error)));
+        console.log("");
+        process.exitCode = 1;
+        return;
+    }
+    if (cmd === "inspect") {
+        if (options.json) {
+            console.log(JSON.stringify(loaded, null, 2));
+            return;
+        }
+        const manifest = loaded.manifest;
+        console.log("");
+        console.log("  " + ACCENT("youstack") + " " + chalk_1.default.bold(manifest.name));
+        console.log("  " + DIM("slug: ") + chalk_1.default.cyan(manifest.slug));
+        if (manifest.domain)
+            console.log("  " + DIM("domain: ") + manifest.domain);
+        if (manifest.aliases?.length)
+            console.log("  " + DIM("aliases: ") + manifest.aliases.join(", "));
+        if (manifest.tags?.length)
+            console.log("  " + DIM("tags: ") + manifest.tags.join(", "));
+        console.log("  " + DIM("version: ") + manifest.version);
+        console.log("  " + DIM("visibility: ") + manifest.visibility);
+        console.log("  " + DIM("manifest: ") + loaded.manifestPath);
+        const readiness = (0, youstack_1.getYouStackReadiness)(loaded);
+        console.log("  " + DIM("readiness: ") + `${readiness.status} (${readiness.reason})`);
+        console.log("");
+        console.log("  " + DIM("files: ") + String(manifest.files?.length || 0));
+        console.log("  " + DIM("brain scopes: ") + String(manifest.brainScopes?.length || 0));
+        console.log("  " + DIM("capabilities: ") + String((0, youstack_1.getYouStackCapabilities)(manifest).length));
+        console.log("  " + DIM("adapters: ") + Object.keys(manifest.adapters || {}).join(", "));
+        console.log("  " + DIM("improvement: ") + (manifest.improvement?.mode || "not declared"));
+        console.log("  " + DIM("update: ") + (manifest.update?.channel || "not declared"));
+        console.log("");
+        printValidation(loaded.validation);
+        if (loaded.validation.ok) {
+            console.log("  " + chalk_1.default.green("OK") + " manifest schema is valid");
+        }
+        console.log("");
+        return;
+    }
+    if (cmd === "capabilities") {
+        const capabilities = (0, youstack_1.getYouStackCapabilities)(loaded.manifest);
+        const readiness = (0, youstack_1.getYouStackReadiness)(loaded);
+        if (options.json) {
+            console.log(JSON.stringify({ readiness, capabilities }, null, 2));
+            return;
+        }
+        console.log("");
+        console.log("  " + ACCENT("youstack capabilities") + DIM(` (${capabilities.length})`));
+        console.log("  " + DIM("readiness: ") + `${readiness.status} (${readiness.reason})`);
+        console.log("");
+        for (const capability of capabilities) {
+            console.log("  " + chalk_1.default.cyan(capabilityLabel(capability)));
+            if (capability.intent)
+                console.log("    " + DIM(capability.intent));
+            if (capability.requiredScopes?.length) {
+                console.log("    " + DIM("scopes: ") + capability.requiredScopes.join(", "));
+            }
+        }
+        console.log("");
+        return;
+    }
+    if (cmd === "doctor") {
+        const result = (0, youstack_1.runYouStackDoctor)(loaded);
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+            if (!result.ok)
+                process.exitCode = 1;
+            return;
+        }
+        console.log("");
+        console.log("  " + ACCENT("youstack doctor") + DIM(" -- read-only diagnostics"));
+        console.log("");
+        for (const diagnostic of result.diagnostics) {
+            console.log("  " + chalk_1.default.cyan("INFO") + " " + diagnostic);
+        }
+        // P20: one dim line per actually-active shadowing (env over session,
+        // canonical stack over legacy, repo project-context over global overlay).
+        for (const shadow of (0, projectContext_1.detectShadowing)()) {
+            console.log("  " + DIM(`shadowed: ${shadow.message}`));
+        }
+        console.log("");
+        // P11: empirical Claude Code discovery gate — per-skill pass/fail for
+        // the SKILL.md files `youmd stack link` would emit for claude-code.
+        if (result.discovery.length > 0) {
+            for (const check of result.discovery) {
+                if (check.ok) {
+                    console.log("  " + chalk_1.default.green("PASS") + " claude discovery: " + check.path);
+                }
+                else {
+                    console.log("  " + chalk_1.default.red("FAIL") + " claude discovery: " + check.path);
+                    for (const problem of check.problems) {
+                        console.log("       " + DIM(problem));
+                    }
+                }
+            }
+            console.log("");
+        }
+        for (const recommendation of result.recommendations) {
+            console.log("  " + ACCENT("NEXT") + " " + recommendation);
+        }
+        printValidation(result);
+        console.log("");
+        if (result.ok) {
+            console.log("  " + chalk_1.default.green("Doctor passed.") + " " + DIM("No brain data was modified, no connected tools were invoked, and no files were changed."));
+        }
+        else {
+            console.log("  " + chalk_1.default.red("Doctor failed.") + " " + DIM("Fix the manifest errors above and rerun."));
+            process.exitCode = 1;
+        }
+        // Heartbeat: append NEXT dim line when stack wants to improve.
+        try {
+            const signal = await (0, heartbeat_1.getHeartbeatSignal)();
+            if (signal.active) {
+                console.log("  " + DIM("NEXT: " + signal.message));
+            }
+        }
+        catch { /* advisory only — never break doctor */ }
+        console.log("");
+        return;
+    }
+    if (cmd === "route") {
+        const request = args.join(" ").trim();
+        if (!request) {
+            console.log("");
+            console.log(chalk_1.default.yellow("  usage: youmd stack route \"start this repo with my preferences\""));
+            console.log("");
+            process.exitCode = 1;
+            return;
+        }
+        const route = (0, youstack_1.routeYouStackRequest)(loaded.manifest, request);
+        // Resolve transport availability for the matched capability via the canonical router.
+        const transport = (0, capability_router_1.resolveCapability)(loaded.manifest, { capability: route.capability.id });
+        const readiness = (0, youstack_1.getYouStackReadiness)(loaded);
+        if (options.json) {
+            console.log(JSON.stringify({ readiness, ...route, transports: transport.transports }, null, 2));
+            return;
+        }
+        console.log("");
+        console.log("  " + ACCENT("route") + " " + chalk_1.default.cyan(route.capability.id));
+        console.log("  " + DIM("readiness: ") + `${readiness.status} (${readiness.reason})`);
+        console.log("  " + DIM("request: ") + request);
+        if (route.capability.intent) {
+            console.log("  " + DIM("intent: ") + route.capability.intent);
+        }
+        console.log("  " + DIM("policy: ") + (route.capability.mutationPolicy || "unspecified"));
+        const http = transport.transports.http ? chalk_1.default.green("yes") : chalk_1.default.dim("no");
+        const mcp = transport.transports.mcp ? chalk_1.default.green("yes") : chalk_1.default.dim("no");
+        console.log("  " + DIM("transports: ") + `http=${http}  mcp=${mcp}`);
+        if (route.capability.skill)
+            console.log("  " + DIM("skill: ") + route.capability.skill);
+        if (route.capability.mcpTool)
+            console.log("  " + DIM("mcp: ") + route.capability.mcpTool);
+        if (route.capability.apiEndpoint)
+            console.log("  " + DIM("api: ") + route.capability.apiEndpoint);
+        console.log("");
+        return;
+    }
+    if (cmd === "smoke") {
+        const result = (0, youstack_1.runYouStackSmoke)(loaded);
+        const readiness = (0, youstack_1.getYouStackReadiness)(loaded);
+        if (options.json) {
+            console.log(JSON.stringify({ readiness, ...result }, null, 2));
+            if (!result.ok)
+                process.exitCode = 1;
+            return;
+        }
+        console.log("");
+        console.log("  " + ACCENT("youstack smoke") + DIM(" -- read-only"));
+        console.log("  " + DIM("readiness: ") + `${readiness.status} (${readiness.reason})`);
+        console.log("");
+        for (const check of result.checks) {
+            console.log("  " + chalk_1.default.green("OK") + " " + check);
+        }
+        printValidation(result);
+        console.log("");
+        if (result.ok) {
+            console.log("  " + chalk_1.default.green("Smoke passed.") + " " + DIM("No brain data was modified, no connected tools were invoked, and no files were changed."));
+        }
+        else {
+            console.log("  " + chalk_1.default.red("Smoke failed.") + " " + DIM("Fix the manifest errors above and rerun."));
+            process.exitCode = 1;
+        }
+        console.log("");
+        return;
+    }
+    if (cmd === "link") {
+        const hosts = options.hosts
+            ? options.hosts.split(",").map((host) => host.trim()).filter(Boolean)
+            : undefined;
+        let results;
+        try {
+            results = (0, youstack_1.linkYouStackAdapters)(loaded, {
+                hosts,
+                targetDir: options.target,
+                dryRun: options.dryRun,
+            });
+        }
+        catch (error) {
+            console.log("");
+            console.log(chalk_1.default.red("  link failed: ") + (error instanceof Error ? error.message : String(error)));
+            console.log("");
+            process.exitCode = 1;
+            return;
+        }
+        // P11 release gate: --verify checks every emitted SKILL.md against the
+        // Claude Code discovery contract and exits non-zero on failures.
+        let verification;
+        if (options.verify) {
+            verification = (0, host_link_1.verifySkillDiscovery)(results);
+            if (!verification.ok)
+                process.exitCode = 1;
+        }
+        if (options.json) {
+            console.log(JSON.stringify({ results, verification }, null, 2));
+            return;
+        }
+        console.log("");
+        console.log("  " + ACCENT("youstack link") + (options.dryRun ? DIM(" -- dry run") : ""));
+        console.log("");
+        for (const result of results) {
+            const status = result.wrote ? chalk_1.default.green("WROTE") : chalk_1.default.yellow("WOULD WRITE");
+            console.log("  " + status + " " + chalk_1.default.cyan(result.host) + DIM(" -> ") + result.targetPath);
+        }
+        console.log("");
+        if (verification) {
+            for (const check of verification.checks) {
+                if (check.ok) {
+                    console.log("  " + chalk_1.default.green("PASS") + " skill discovery: " + check.path);
+                }
+                else {
+                    console.log("  " + chalk_1.default.red("FAIL") + " skill discovery: " + check.path);
+                    for (const problem of check.problems) {
+                        console.log("       " + DIM(problem));
+                    }
+                }
+            }
+            console.log("");
+            if (!verification.ok) {
+                console.log("  " + chalk_1.default.red("Verification failed.") + " " + DIM("Fix the SKILL.md issues above and rerun."));
+                console.log("");
+                return;
+            }
+        }
+        if (!options.dryRun) {
+            console.log("  " + chalk_1.default.green("Adapter files generated.") + " " + DIM("No brain data or connected tools were touched."));
+            console.log("");
+        }
+        return;
+    }
+    if (cmd === "guard") {
+        const guardResult = (0, youstack_1.runStackGuard)(loaded.manifest, loaded.manifestPath);
+        if (options.json) {
+            console.log(JSON.stringify(guardResult, null, 2));
+            if (!guardResult.ok)
+                process.exitCode = 1;
+            return;
+        }
+        console.log("");
+        console.log("  " + ACCENT("youstack guard") + DIM(` -- T0-T3 safety contract (${guardResult.tier})`));
+        console.log("  " + DIM("manifest: ") + loaded.manifestPath);
+        console.log("");
+        for (const check of guardResult.checks) {
+            if (check.status === "PASS") {
+                const inferNote = check.inferred
+                    ? DIM(` (inferred from: ${check.inferredFrom.join(", ")})`)
+                    : "";
+                console.log("  " + chalk_1.default.green("PASS") + " " + chalk_1.default.cyan(check.capability) + " — " + check.message + inferNote);
+            }
+            else {
+                const inferNote = check.inferred
+                    ? DIM(` (inferred from: ${check.inferredFrom.join(", ")})`)
+                    : "";
+                console.log("  " + chalk_1.default.red("VIOLATION") + " " + chalk_1.default.cyan(check.capability) + " — " + check.message + inferNote);
+                console.log("       " + DIM(`tier rule: ${check.tierRule}`));
+            }
+        }
+        if (guardResult.contractViolations.length > 0) {
+            console.log("");
+            console.log("  " + ACCENT("contract violations:"));
+            for (const violation of guardResult.contractViolations) {
+                console.log("  " + chalk_1.default.red("FAIL") + " " + violation.reason);
+                console.log("       " + DIM(`tier rule: ${violation.tierRule}`));
+            }
+        }
+        if (guardResult.warnings.length > 0) {
+            console.log("");
+            for (const warning of guardResult.warnings) {
+                console.log("  " + chalk_1.default.yellow("WARN") + " " + warning);
+            }
+        }
+        console.log("");
+        if (guardResult.ok) {
+            console.log("  " + chalk_1.default.green("Guard passed.") + " " +
+                DIM(`${guardResult.tier} contract is self-consistent and no inferred capabilities exceed the declared tier.`));
+        }
+        else {
+            console.log("  " + chalk_1.default.red("Guard failed.") + " " +
+                DIM("Fix the violations above and rerun `youmd stack guard`."));
+            process.exitCode = 1;
+        }
+        console.log("");
+        return;
+    }
+    if (cmd === "eval") {
+        if (options.init) {
+            // Write example golden.json
+            const golden = (0, stackEval_1.buildInitGoldenFile)(loaded.manifest);
+            const filePath = (0, stackEval_1.writeGoldenFile)(loaded.rootDir, golden);
+            if (options.json) {
+                console.log(JSON.stringify({ wrote: filePath, entries: golden.entries.length }, null, 2));
+                return;
+            }
+            console.log("");
+            console.log("  " + ACCENT("youstack eval --init"));
+            console.log("  " + chalk_1.default.green("WROTE") + " " + filePath);
+            console.log("  " + DIM(`${golden.entries.length} example entries. Edit to add real assertions, then run \`youmd stack eval\`.`));
+            console.log("");
+            return;
+        }
+        // Run the eval suite
+        let goldenFile;
+        try {
+            goldenFile = (0, stackEval_1.readGoldenFile)(loaded.rootDir);
+        }
+        catch (error) {
+            console.log("");
+            console.log(chalk_1.default.red("  eval: ") + (error instanceof Error ? error.message : String(error)));
+            console.log("");
+            process.exitCode = 1;
+            return;
+        }
+        const evalResults = (0, stackEval_1.runEval)(loaded.manifest, goldenFile);
+        const resultsPath = (0, stackEval_1.writeEvalResults)(loaded.rootDir, evalResults);
+        if (options.json) {
+            console.log(JSON.stringify(evalResults, null, 2));
+            if (evalResults.failures.length > 0)
+                process.exitCode = 1;
+            return;
+        }
+        console.log("");
+        console.log("  " + ACCENT("youstack eval") + DIM(` -- ${evalResults.total} prompts`));
+        console.log("  " + DIM("golden: ") + (0, stackEval_1.goldenFilePath)(loaded.rootDir));
+        console.log("  " + DIM("results: ") + resultsPath);
+        console.log("");
+        for (const entry of goldenFile.entries) {
+            const failure = evalResults.failures.find((f) => f.label === entry.label);
+            if (!failure) {
+                console.log("  " + chalk_1.default.green("PASS") + " " + entry.label);
+            }
+            else {
+                console.log("  " + ACCENT("FAIL") + " " + entry.label);
+                for (const diff of failure.diff) {
+                    console.log("       " + DIM(diff));
+                }
+                console.log("       " + DIM(`routed to: ${failure.actual.routedTo}`));
+            }
+        }
+        console.log("");
+        const passCount = chalk_1.default.green(`${evalResults.passed} passed`);
+        const failCount = evalResults.failures.length > 0
+            ? ACCENT(`${evalResults.failures.length} failed`)
+            : chalk_1.default.dim("0 failed");
+        console.log("  " + passCount + DIM(" / ") + failCount + DIM(` of ${evalResults.total} total`));
+        console.log("");
+        if (evalResults.failures.length > 0) {
+            console.log("  " + chalk_1.default.red("Eval failed.") + " " + DIM("Fix routing assertions or update golden.json."));
+            console.log("");
+            process.exitCode = 1;
+        }
+        else {
+            console.log("  " + chalk_1.default.green("Eval passed.") + " " + DIM("All prompts routed as expected."));
+            console.log("");
+        }
+        return;
+    }
+    if (cmd === "improve") {
+        const rawMode = options.mode ?? "propose";
+        if (rawMode !== "propose" && rawMode !== "auto_pr") {
+            console.log("");
+            console.log(chalk_1.default.red("  stack improve: ") + `--mode must be "propose" or "auto_pr" (got: ${rawMode})`);
+            console.log("");
+            process.exitCode = 1;
+            return;
+        }
+        const improveMode = rawMode;
+        const result = (0, stackImprove_1.runStackImprove)(loaded.manifest, loaded.rootDir, improveMode);
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+            if (result.refused)
+                process.exitCode = 1;
+            return;
+        }
+        console.log("");
+        console.log("  " + ACCENT("youstack improve") + DIM(` -- mode: ${result.mode}`));
+        console.log("  " + DIM("manifest: ") + loaded.manifestPath);
+        console.log("");
+        if (result.refused) {
+            console.log("  " + chalk_1.default.red("REFUSED") + " " + result.refused);
+            console.log("");
+            process.exitCode = 1;
+            return;
+        }
+        console.log("  " + DIM("journal: ") + result.journalPath);
+        if (result.appended) {
+            console.log("  " + DIM("(appended to existing entry — idempotent re-run)"));
+        }
+        else {
+            console.log("  " + chalk_1.default.green("WROTE") + " " + result.journalPath);
+        }
+        console.log("");
+        if (result.summary.signals.length > 0) {
+            console.log("  " + ACCENT("signals:"));
+            for (const sig of result.summary.signals) {
+                console.log("    " + chalk_1.default.cyan(sig.name) + DIM(" = ") + sig.value);
+            }
+            console.log("");
+        }
+        if (result.summary.proposals.length === 0) {
+            console.log("  " + chalk_1.default.green("no proposals") + DIM(" — stack looks healthy"));
+        }
+        else {
+            console.log("  " + ACCENT("proposals:"));
+            for (const p of result.summary.proposals) {
+                console.log("  " + chalk_1.default.cyan(p.id));
+                console.log("    " + p.description);
+                console.log("    " + DIM(p.rationale));
+            }
+        }
+        if (result.prUrl) {
+            console.log("");
+            if (result.prUrl === "no-gh") {
+                console.log("  " + chalk_1.default.yellow("gh CLI not found") + DIM(" — patch printed to journal only"));
+            }
+            else if (result.prUrl.startsWith("pr-failed:")) {
+                console.log("  " + chalk_1.default.yellow("PR creation failed:") + " " + result.prUrl.replace("pr-failed: ", ""));
+            }
+            else {
+                console.log("  " + chalk_1.default.green("PR opened:") + " " + chalk_1.default.cyan(result.prUrl));
+            }
+        }
+        console.log("");
+        return;
+    }
+    // ── L17: stack update ───────────────────────────────────────────────────────
+    if (cmd === "update") {
+        const info = await (0, stackUpdate_1.checkStackUpdate)(loaded);
+        if (options.json) {
+            console.log(JSON.stringify(info, null, 2));
+            return;
+        }
+        console.log("");
+        console.log("  " + ACCENT("youstack update"));
+        console.log("  " + DIM("manifest: ") + loaded.manifestPath);
+        console.log("");
+        console.log("  " + DIM("current: ") + info.currentVersion);
+        console.log("  " + DIM("latest:  ") + (info.latestVersion ?? DIM("unknown")));
+        console.log("  " + DIM("source:  ") + info.source);
+        console.log("");
+        console.log("  " + (info.updateAvailable ? chalk_1.default.green("update available") : chalk_1.default.dim("up to date")));
+        if (info.changelogHint) {
+            console.log("  " + DIM("hint: ") + info.changelogHint);
+        }
+        console.log("");
+        if (options.apply) {
+            if (!info.updateAvailable) {
+                console.log("  " + DIM("nothing to apply — already at latest"));
+                console.log("");
+                return;
+            }
+            const applyResult = await (0, stackUpdate_1.applyStackUpdate)(loaded);
+            if (applyResult.error) {
+                console.log("  " + chalk_1.default.red("apply failed: ") + applyResult.error);
+                console.log("");
+                process.exitCode = 1;
+                return;
+            }
+            for (const wrote of applyResult.wrote) {
+                console.log("  " + chalk_1.default.green("WROTE") + " " + wrote);
+            }
+            console.log("");
+            console.log("  " + chalk_1.default.green("applied.") + " " + DIM("re-run `youmd stack doctor` to validate the new manifest."));
+            console.log("");
+        }
+        else if (info.updateAvailable) {
+            console.log("  " + DIM("run `youmd stack update --apply` to write the new manifest."));
+            console.log("");
+        }
+        return;
+    }
+    console.log("");
+    console.log(chalk_1.default.yellow(`  unknown stack command: ${cmd}`));
+    printHelp();
+    process.exitCode = 1;
+}
+//# sourceMappingURL=stack.js.map