youmd 0.8.7 → 0.8.11

package/dist/commands/skill.js

@@ -48,6 +48,7 @@ const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const readline = __importStar(require("readline"));
 const yaml = __importStar(require("js-yaml"));
+const child_process_1 = require("child_process");
 const chalk_1 = __importDefault(require("chalk"));
 const skill_catalog_1 = require("../lib/skill-catalog");
 const skills_1 = require("../lib/skills");
@@ -110,6 +111,300 @@ function truncateAtWord(text, max) {
     const lastSpace = truncated.lastIndexOf(" ");
     return (lastSpace > max * 0.5 ? truncated.slice(0, lastSpace) : truncated) + "...";
 }
+function sourcePrefix(source) {
+    const idx = source.indexOf(":");
+    return idx > 0 ? source.slice(0, idx) : "path";
+}
+function parseFlagArgs(args) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (!arg.startsWith("--")) {
+            positional.push(arg);
+            continue;
+        }
+        const eq = arg.indexOf("=");
+        if (eq > 0) {
+            flags[arg.slice(2, eq)] = arg.slice(eq + 1);
+            continue;
+        }
+        const key = arg.slice(2);
+        const next = args[i + 1];
+        if (next && !next.startsWith("--")) {
+            flags[key] = next;
+            i += 1;
+        }
+        else {
+            flags[key] = true;
+        }
+    }
+    return { positional, flags };
+}
+function flagString(flags, key) {
+    const value = flags[key];
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function resolveInventoryScript() {
+    const candidates = [
+        process.env.YOUMD_AGENT_STACK_INVENTORY_SCRIPT,
+        path.join(os.homedir(), ".agent-shared", "claude-skills", "agent-stack-inventory", "scripts", "local-agent-stack-inventory.mjs"),
+        path.join(os.homedir(), ".youmd", "skills", "agent-stack-inventory", "scripts", "local-agent-stack-inventory.mjs"),
+        path.resolve(__dirname, "../../scripts/local-agent-stack-inventory.mjs"),
+        path.resolve(__dirname, "../../../scripts/local-agent-stack-inventory.mjs"),
+    ].filter(Boolean);
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+function readInventorySnapshot(file) {
+    return JSON.parse(fs.readFileSync(file, "utf-8"));
+}
+function inventoryNames(snapshot) {
+    return new Set((snapshot.uniqueSkills || []).map((skill) => skill.name).filter(Boolean));
+}
+function sortInventoryJsonPaths(files) {
+    return files.sort((a, b) => {
+        const delta = fs.statSync(b).mtimeMs - fs.statSync(a).mtimeMs;
+        if (delta !== 0)
+            return delta;
+        return path.basename(b).localeCompare(path.basename(a));
+    });
+}
+function findLatestInventoryJson(outDir, sinceMs = 0) {
+    if (!fs.existsSync(outDir))
+        return null;
+    const files = sortInventoryJsonPaths(fs.readdirSync(outDir)
+        .filter((file) => /^local-agent-stack-inventory-.*\.json$/.test(file))
+        .map((file) => path.join(outDir, file))
+        .filter((file) => {
+        try {
+            return fs.statSync(file).mtimeMs >= sinceMs - 1000;
+        }
+        catch {
+            return false;
+        }
+    }));
+    return files[0] || null;
+}
+function renderInventoryTotals(totals) {
+    const rows = [
+        ["unique skill names", totals.uniqueSkillNames],
+        ["real SKILL.md files", totals.uniqueRealSkillFiles],
+        ["direct host exposures", totals.directExposureSkillRecords],
+        ["You.md catalog skills", totals.youmdCatalogSkills],
+        ["missing from You.md catalog", totals.missingFromYoumdCatalog],
+        ["DRY review cases", totals.duplicateNameDifferentRealpaths],
+        ["healthy mirror clusters", totals.sameRealpathMirrors],
+        ["project/context signals", totals.projectSignals],
+    ];
+    const maxLabel = Math.max(...rows.map(([label]) => label.length));
+    for (const [label, value] of rows) {
+        if (typeof value !== "number")
+            continue;
+        console.log(`  ${DIM(label.padEnd(maxLabel + 2))}${chalk_1.default.cyan(value.toLocaleString())}`);
+    }
+}
+function renderInventoryPhaseTimings(snapshot) {
+    const timings = (snapshot.phaseTimings || [])
+        .filter((phase) => typeof phase.durationMs === "number")
+        .sort((a, b) => (b.durationMs || 0) - (a.durationMs || 0))
+        .slice(0, 4);
+    if (timings.length === 0)
+        return;
+    console.log(`  ${DIM("slowest phases")}`);
+    for (const phase of timings) {
+        const seconds = Math.max(0, Math.round((phase.durationMs || 0) / 1000));
+        const label = phase.label || phase.phase || "unknown phase";
+        const status = phase.failed ? ACCENT(" failed") : "";
+        console.log(`    ${DIM(label.padEnd(50))}${chalk_1.default.cyan(`${seconds}s`)}${status}`);
+    }
+}
+function runInventoryScript(scriptArgs, spinner) {
+    return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)(process.execPath, scriptArgs, {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const stdout = [];
+        const stderr = [];
+        let progressBuffer = "";
+        child.stdout.on("data", (chunk) => {
+            stdout.push(chunk);
+        });
+        child.stderr.on("data", (chunk) => {
+            const text = chunk.toString("utf-8");
+            stderr.push(chunk);
+            progressBuffer += text;
+            const lines = progressBuffer.split(/\r?\n/);
+            progressBuffer = lines.pop() || "";
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed.startsWith("youmd-inventory-progress "))
+                    continue;
+                try {
+                    const event = JSON.parse(trimmed.slice("youmd-inventory-progress ".length));
+                    if (event.label && event.event === "start") {
+                        spinner.update(event.label);
+                    }
+                    else if (event.label && event.event === "failed") {
+                        spinner.update(`${event.label} failed`);
+                    }
+                }
+                catch {
+                    // Non-JSON stderr is collected for failure output below.
+                }
+            }
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve(Buffer.concat(stdout).toString("utf-8"));
+                return;
+            }
+            const detail = Buffer.concat(stderr).toString("utf-8").trim();
+            reject(new Error(detail || `inventory exited with code ${code}`));
+        });
+    });
+}
+function compactDate(value) {
+    if (typeof value === "string" && value)
+        return value.replace(/\.\d{3}Z$/, "Z");
+    if (typeof value === "number" && Number.isFinite(value))
+        return new Date(value).toISOString().replace(/\.\d{3}Z$/, "Z");
+    return "unknown";
+}
+function inventoryTotalsFromSynced(row) {
+    return {
+        uniqueSkillNames: row.uniqueSkillNames,
+        uniqueRealSkillFiles: row.uniqueRealSkillFiles,
+        directExposureSkillRecords: row.directExposureSkillRecords,
+        canonicalSkillFiles: row.canonicalSkillFiles,
+        youmdCatalogSkills: row.youmdCatalogSkills,
+        missingFromYoumdCatalog: row.missingFromYoumdCatalog,
+        duplicateNameDifferentRealpaths: row.duplicateNameDifferentRealpaths,
+        sameRealpathMirrors: row.sameRealpathMirrors,
+        projectSignals: row.projectSignals,
+    };
+}
+function inventoryDelta(localValue, remoteValue) {
+    if (typeof localValue !== "number" || typeof remoteValue !== "number")
+        return DIM("?");
+    const delta = remoteValue - localValue;
+    if (delta === 0)
+        return chalk_1.default.green("0");
+    return delta > 0 ? chalk_1.default.green(`+${delta}`) : ACCENT(String(delta));
+}
+function renderInventoryDrift(drift) {
+    if (!drift?.baseline)
+        return;
+    console.log("");
+    console.log(`  ${DIM("drift baseline")} ${chalk_1.default.cyan(drift.baseline.hostName)}${DIM(` · ${compactDate(drift.baseline.generatedAt)} · ${drift.baseline.counts.uniqueSkillNames} skills`)}`);
+    console.log(`  ${DIM("drift summary ")} ` +
+        `${chalk_1.default.cyan(String(drift.summary.machineCount))} machines · ` +
+        `${drift.summary.driftCount > 0 ? ACCENT(String(drift.summary.driftCount)) : chalk_1.default.green("0")} drift · ` +
+        `${drift.summary.staleCount > 0 ? ACCENT(String(drift.summary.staleCount)) : chalk_1.default.green("0")} stale · ` +
+        `${drift.summary.unsafeCount > 0 ? ACCENT(String(drift.summary.unsafeCount)) : chalk_1.default.green("0")} unsafe`);
+    const issueRows = drift.machines.filter((machine) => machine.status !== "baseline" && machine.issues.length > 0).slice(0, 4);
+    for (const machine of issueRows) {
+        console.log(`  ${ACCENT(machine.status.padEnd(8))} ${chalk_1.default.cyan(machine.hostName)} ${DIM(machine.issues.slice(0, 2).join("; "))}`);
+    }
+}
+function inventoryHostName(snapshot) {
+    if (typeof snapshot.host === "string" && snapshot.host.trim())
+        return snapshot.host.trim();
+    if (snapshot.host && typeof snapshot.host === "object" && snapshot.host.hostname) {
+        return snapshot.host.hostname;
+    }
+    return os.hostname();
+}
+function inventorySnapshotLabel(snapshot, fallback) {
+    const host = inventoryHostName(snapshot);
+    return host || fallback;
+}
+function safeInventoryCount(value) {
+    return Number.isFinite(value) ? Math.max(0, Math.trunc(value)) : 0;
+}
+function inventorySampleNames(rows) {
+    if (!Array.isArray(rows))
+        return [];
+    return rows
+        .flatMap((row) => {
+        if (typeof row === "string")
+            return [row];
+        if (row?.name)
+            return [row.name];
+        return [];
+    })
+        .map((name) => name.trim())
+        .filter(Boolean)
+        .slice(0, 24);
+}
+function buildAgentStackInventorySyncPayload(snapshot, jsonPath, htmlPath, syncRepo = true) {
+    const totals = snapshot.totals || {};
+    return {
+        inventorySchemaVersion: snapshot.inventorySchemaVersion || "local-agent-stack-inventory/v1",
+        generatedAt: snapshot.generatedAt || new Date().toISOString(),
+        hostName: inventoryHostName(snapshot),
+        platform: `${os.platform()} ${os.release()}`,
+        rootDir: snapshot.roots?.workspace || snapshot.repoRoot || process.cwd(),
+        secretValuesExposed: false,
+        reportJsonPath: jsonPath,
+        reportHtmlPath: htmlPath,
+        source: "youmd-cli",
+        agentName: "youmd skill inventory",
+        totals: {
+            uniqueSkillNames: safeInventoryCount(totals.uniqueSkillNames),
+            uniqueRealSkillFiles: safeInventoryCount(totals.uniqueRealSkillFiles),
+            directExposureSkillRecords: safeInventoryCount(totals.directExposureSkillRecords),
+            canonicalSkillFiles: safeInventoryCount(totals.canonicalSkillFiles),
+            youmdCatalogSkills: safeInventoryCount(totals.youmdCatalogSkills),
+            missingFromYoumdCatalog: safeInventoryCount(totals.missingFromYoumdCatalog),
+            duplicateNameDifferentRealpaths: safeInventoryCount(totals.duplicateNameDifferentRealpaths),
+            sameRealpathMirrors: safeInventoryCount(totals.sameRealpathMirrors),
+            projectSignals: safeInventoryCount(totals.projectSignals),
+        },
+        ownershipRollup: snapshot.ownershipRollup || {},
+        syncPolicyRollup: snapshot.syncPolicyRollup || {},
+        provenanceRollup: snapshot.provenanceRollup || {},
+        missingCatalogSamples: inventorySampleNames(snapshot.missingFromCatalog),
+        duplicateNameSamples: inventorySampleNames(snapshot.dryAudit?.duplicateNameDifferentRealpaths),
+        mirrorSamples: inventorySampleNames(snapshot.dryAudit?.sameRealpathMirrors),
+        syncRepo,
+    };
+}
+function buildSkillSyncActivityMetadata(synced, errors) {
+    const catalog = (0, skill_catalog_1.readSkillCatalog)();
+    const entries = [];
+    for (const name of synced) {
+        const entry = (0, skill_catalog_1.findSkill)(catalog, name);
+        if (entry)
+            entries.push(entry);
+    }
+    const sharedSkills = entries
+        .filter((entry) => entry.source.startsWith("shared:"))
+        .map((entry) => entry.name)
+        .sort();
+    const sourcePrefixes = {};
+    const scopes = {};
+    for (const entry of entries) {
+        const prefix = sourcePrefix(entry.source);
+        sourcePrefixes[prefix] = (sourcePrefixes[prefix] ?? 0) + 1;
+        scopes[entry.scope] = (scopes[entry.scope] ?? 0) + 1;
+    }
+    return {
+        syncedCount: synced.length,
+        errorCount: errors.length,
+        skills: synced.slice(0, 20),
+        sharedSkillCount: sharedSkills.length,
+        sharedSkills: sharedSkills.slice(0, 20),
+        sourcePrefixes,
+        scopes,
+        canonicalSharedRoot: "~/.agent-shared/claude-skills",
+        secretValuesExposed: false,
+    };
+}
 // ─── Subcommands ──────────────────────────────────────────────────────
 const RECOMMENDED_SKILLS = new Set([
     "youstack-start",
@@ -428,6 +723,37 @@ async function syncSkillsCmd() {
             console.log(`  ${ACCENT("\u2717")} ${DIM(err)}`);
         }
     }
+    if ((0, config_1.isAuthenticated)()) {
+        try {
+            const metadata = buildSkillSyncActivityMetadata(result.synced, result.errors);
+            const sharedSkillCount = metadata.sharedSkillCount;
+            await (0, api_1.recordBrainActivity)({
+                activityId: `skill-sync:${os.hostname()}`,
+                source: "skill-sync",
+                channel: "skills",
+                kind: result.errors.length > 0 ? "warn" : sharedSkillCount > 0 ? "shared-skill-sync" : "synced",
+                status: result.errors.length > 0 ? "warn" : "ok",
+                title: sharedSkillCount > 0
+                    ? `${result.synced.length} skills synced · ${sharedSkillCount} shared`
+                    : `${result.synced.length} skills synced`,
+                detail: result.errors.length > 0
+                    ? `${result.errors.length} sync warning${result.errors.length === 1 ? "" : "s"}`
+                    : sharedSkillCount > 0
+                        ? `shared skills propagated from ~/.agent-shared: ${metadata.sharedSkills.slice(0, 5).join(", ")}`
+                        : "installed skills re-rendered against the latest identity bundle",
+                sourceHost: os.hostname(),
+                sourceAgent: "youmd CLI",
+                sourceRuntime: process.version,
+                entityType: sharedSkillCount > 0 ? "sharedSkillSync" : "skillSync",
+                entityId: os.hostname(),
+                metadata,
+            });
+        }
+        catch (err) {
+            if (process.env.DEBUG)
+                console.error(`[skill sync] brain activity failed: ${err}`);
+        }
+    }
     console.log("");
 }
 function addSkillCmd(args) {
@@ -708,6 +1034,7 @@ async function improveCmd() {
     const notInstalled = catalog.skills.filter((s) => !s.installed);
     // ─── Live outcome insights (L10) ──────────────────────────────────
     let liveInsights = null;
+    const lowPerformers = [];
     if ((0, config_1.isAuthenticated)()) {
         const insightSpinner = new render_1.BrailleSpinner("fetching outcome telemetry");
         insightSpinner.start();
@@ -751,7 +1078,6 @@ async function improveCmd() {
             `last used`;
         console.log(DIM(headerStr));
         console.log(DIM("  " + "-".repeat(headerStr.length - 2)));
-        const lowPerformers = [];
         for (const s of liveInsights) {
             const ratePct = Math.round(s.successRate * 100);
             const rateStr = `${ratePct}%`.padStart(4);
@@ -907,6 +1233,349 @@ async function improveCmd() {
         }
         console.log("");
     }
+    if ((0, config_1.isAuthenticated)()) {
+        try {
+            await (0, api_1.recordBrainActivity)({
+                activityId: `skill-improve:${os.hostname()}`,
+                source: "skill-improve",
+                channel: "skills",
+                kind: proposals.length > 0 || lowPerformers.length > 0 ? "proposed" : "checked",
+                status: proposals.length > 0 || lowPerformers.length > 0 ? "warn" : "ok",
+                title: proposals.length > 0 || lowPerformers.length > 0
+                    ? `skill improvement analysis found ${proposals.length + lowPerformers.length} signal${proposals.length + lowPerformers.length === 1 ? "" : "s"}`
+                    : "skill improvement analysis clean",
+                detail: proposals.length > 0
+                    ? proposals.slice(0, 3).join(" · ")
+                    : lowPerformers.length > 0
+                        ? `low performers: ${lowPerformers.map((s) => s.skill).slice(0, 5).join(", ")}`
+                        : "no immediate skill improvements suggested",
+                entityType: "skillImprovementAnalysis",
+                entityId: os.hostname(),
+                sourceHost: os.hostname(),
+                sourceAgent: "youmd CLI",
+                sourceRuntime: process.version,
+                metadata: {
+                    installedCount: installed.length,
+                    notInstalledCount: notInstalled.length,
+                    localUseCount: totalUses,
+                    identityFieldCount: allFields.size,
+                    missingIdentityFields: missing.slice(0, 20),
+                    proposalCount: proposals.length,
+                    proposals: proposals.slice(0, 12),
+                    lowPerformerCount: lowPerformers.length,
+                    lowPerformers: lowPerformers.slice(0, 12).map((skill) => ({
+                        skill: skill.skill,
+                        uses: skill.uses,
+                        successRate: skill.successRate,
+                        failure: skill.failure,
+                        partial: skill.partial,
+                    })),
+                    liveInsightCount: liveInsights?.length ?? 0,
+                    fleetLineCount: fleetLines.length,
+                    secretValuesExposed: false,
+                },
+            });
+        }
+        catch (err) {
+            if (process.env.DEBUG)
+                console.error(`[skill improve] brain activity failed: ${err}`);
+        }
+    }
+}
+function inventoryDiffCmd(args) {
+    const { positional, flags } = parseFlagArgs(args);
+    const leftPath = flagString(flags, "left") || positional[0];
+    const rightPath = flagString(flags, "right") || positional[1];
+    if (!leftPath || !rightPath) {
+        console.log("");
+        console.log(chalk_1.default.yellow("  usage: youmd skill inventory diff --left mac-mini.json --right laptop.json"));
+        console.log(DIM("  or:    youmd skill inventory diff mac-mini.json laptop.json"));
+        console.log("");
+        return;
+    }
+    const left = readInventorySnapshot(path.resolve(leftPath));
+    const right = readInventorySnapshot(path.resolve(rightPath));
+    const leftNames = inventoryNames(left);
+    const rightNames = inventoryNames(right);
+    const onlyLeft = [...leftNames].filter((name) => !rightNames.has(name)).sort();
+    const onlyRight = [...rightNames].filter((name) => !leftNames.has(name)).sort();
+    console.log("");
+    console.log("  " + chalk_1.default.bold("skill inventory diff"));
+    console.log("");
+    console.log(`  ${DIM("left ")}${chalk_1.default.cyan(inventorySnapshotLabel(left, path.basename(leftPath)))}${DIM(left.generatedAt ? ` · ${left.generatedAt}` : "")}`);
+    console.log(`  ${DIM("right")}${chalk_1.default.cyan(" " + inventorySnapshotLabel(right, path.basename(rightPath)))}${DIM(right.generatedAt ? ` · ${right.generatedAt}` : "")}`);
+    console.log("");
+    const totalRows = [
+        ["unique skill names", left.totals?.uniqueSkillNames, right.totals?.uniqueSkillNames],
+        ["real SKILL.md files", left.totals?.uniqueRealSkillFiles, right.totals?.uniqueRealSkillFiles],
+        ["direct host exposures", left.totals?.directExposureSkillRecords, right.totals?.directExposureSkillRecords],
+        ["You.md catalog skills", left.totals?.youmdCatalogSkills, right.totals?.youmdCatalogSkills],
+        ["missing from catalog", left.totals?.missingFromYoumdCatalog, right.totals?.missingFromYoumdCatalog],
+        ["DRY review cases", left.totals?.duplicateNameDifferentRealpaths, right.totals?.duplicateNameDifferentRealpaths],
+        ["mirror clusters", left.totals?.sameRealpathMirrors, right.totals?.sameRealpathMirrors],
+    ];
+    const maxLabel = Math.max(...totalRows.map(([label]) => label.length));
+    for (const [label, leftValue, rightValue] of totalRows) {
+        const delta = typeof leftValue === "number" && typeof rightValue === "number"
+            ? rightValue - leftValue
+            : undefined;
+        const deltaText = typeof delta === "number"
+            ? delta === 0
+                ? DIM(" 0")
+                : delta > 0
+                    ? chalk_1.default.green(` +${delta}`)
+                    : ACCENT(` ${delta}`)
+            : "";
+        console.log(`  ${DIM(label.padEnd(maxLabel + 2))}` +
+            `${String(leftValue ?? "?").padStart(6)} ${DIM("->")} ${String(rightValue ?? "?").padStart(6)}${deltaText}`);
+    }
+    console.log("");
+    console.log(`  ${DIM("skills only in left: ")}${onlyLeft.length}`);
+    for (const name of onlyLeft.slice(0, 20))
+        console.log(`    ${ACCENT("-")} ${name}`);
+    if (onlyLeft.length > 20)
+        console.log(DIM(`    ... ${onlyLeft.length - 20} more`));
+    console.log("");
+    console.log(`  ${DIM("skills only in right: ")}${onlyRight.length}`);
+    for (const name of onlyRight.slice(0, 20))
+        console.log(`    ${chalk_1.default.green("+")} ${name}`);
+    if (onlyRight.length > 20)
+        console.log(DIM(`    ... ${onlyRight.length - 20} more`));
+    console.log("");
+}
+async function inventoryStatusCmd(args) {
+    const { flags } = parseFlagArgs(args);
+    const outDir = path.resolve(flagString(flags, "out-dir") || path.join(os.homedir(), ".youmd", "agent-stack-inventory"));
+    const limitRaw = flagString(flags, "limit");
+    const limit = limitRaw && Number.isFinite(Number(limitRaw))
+        ? Math.max(1, Math.min(50, Math.trunc(Number(limitRaw))))
+        : 12;
+    const jsonOutput = flags.json === true;
+    const latestPath = findLatestInventoryJson(outDir);
+    const local = latestPath ? readInventorySnapshot(latestPath) : null;
+    const localTotals = local?.totals || {};
+    if (!(0, config_1.isAuthenticated)()) {
+        if (jsonOutput) {
+            console.log(JSON.stringify({
+                success: false,
+                error: "not_authenticated",
+                repair: "youmd login",
+                secretValuesExposed: false,
+            }, null, 2));
+            return;
+        }
+        console.log("");
+        console.log(chalk_1.default.yellow("  not authenticated. run: ") + chalk_1.default.cyan("youmd login"));
+        console.log(DIM("  then: ") + chalk_1.default.cyan("youmd skill inventory status"));
+        console.log("");
+        return;
+    }
+    const [res, driftRes] = await Promise.all([
+        (0, api_1.getAgentStackInventories)({ limit }),
+        (0, api_1.getAgentStackInventoryDrift)({ limit }),
+    ]);
+    if (!res.ok) {
+        const message = (0, api_1.apiErrorMessage)(res.data) || `HTTP ${res.status}`;
+        if (jsonOutput) {
+            console.log(JSON.stringify({
+                success: false,
+                error: message,
+                secretValuesExposed: false,
+            }, null, 2));
+            return;
+        }
+        console.log("");
+        console.log(chalk_1.default.yellow(`  inventory status unavailable: ${message}`));
+        console.log("");
+        return;
+    }
+    const inventories = res.data?.inventories ?? [];
+    const drift = driftRes.ok ? driftRes.data : null;
+    if (jsonOutput) {
+        console.log(JSON.stringify({
+            success: true,
+            local: local
+                ? {
+                    path: latestPath,
+                    hostName: inventoryHostName(local),
+                    generatedAt: local.generatedAt,
+                    rootDir: local.roots?.workspace || local.repoRoot,
+                    totals: localTotals,
+                }
+                : null,
+            inventories,
+            drift,
+            secretValuesExposed: false,
+        }, null, 2));
+        return;
+    }
+    console.log("");
+    console.log("  " + chalk_1.default.bold("skill inventory status"));
+    console.log("");
+    if (local && latestPath) {
+        console.log(`  ${DIM("local latest")} ${chalk_1.default.cyan(inventoryHostName(local))}${DIM(local.generatedAt ? ` · ${compactDate(local.generatedAt)}` : "")}`);
+        console.log(`  ${DIM("local json  ")} ${chalk_1.default.cyan(latestPath)}`);
+        if (localTotals) {
+            console.log(`  ${DIM("local counts")} ` +
+                `${chalk_1.default.cyan(String(localTotals.uniqueSkillNames ?? "?"))} skills · ` +
+                `${chalk_1.default.cyan(String(localTotals.uniqueRealSkillFiles ?? "?"))} files · ` +
+                `${ACCENT(String(localTotals.missingFromYoumdCatalog ?? 0))} catalog gaps · ` +
+                `${ACCENT(String(localTotals.duplicateNameDifferentRealpaths ?? 0))} DRY reviews`);
+        }
+    }
+    else {
+        console.log(chalk_1.default.yellow("  local latest: missing"));
+        console.log(DIM("  repair: ") + chalk_1.default.cyan(`youmd skill inventory --out-dir ${outDir} --sync`));
+    }
+    console.log("");
+    if (inventories.length === 0) {
+        console.log(chalk_1.default.yellow("  no synced machine inventories found yet."));
+    }
+    else {
+        const rows = inventories.map((row) => {
+            const totals = inventoryTotalsFromSynced(row);
+            const localHost = local ? inventoryHostName(local) : "";
+            const sameHost = localHost && row.hostName === localHost;
+            return {
+                row,
+                totals,
+                marker: sameHost ? "*" : " ",
+            };
+        });
+        console.log(`  ${DIM("synced machines")} ${chalk_1.default.cyan(String(inventories.length))}${DIM(` · limit ${limit}`)}`);
+        console.log("");
+        console.log(`  ${DIM("  host".padEnd(26))}` +
+            `${DIM("updated".padEnd(22))}` +
+            `${DIM("skills".padStart(8))}` +
+            `${DIM(" files".padStart(8))}` +
+            `${DIM(" gaps".padStart(8))}` +
+            `${DIM(" dry".padStart(7))}` +
+            `${DIM(" Δskills".padStart(10))}`);
+        for (const { row, totals, marker } of rows) {
+            const host = `${marker} ${row.hostName}`.slice(0, 25).padEnd(26);
+            const updated = compactDate(row.updatedAt).slice(0, 21).padEnd(22);
+            console.log(`  ${chalk_1.default.cyan(host)}` +
+                `${DIM(updated)}` +
+                `${String(totals.uniqueSkillNames ?? "?").padStart(8)}` +
+                `${String(totals.uniqueRealSkillFiles ?? "?").padStart(8)}` +
+                `${String(totals.missingFromYoumdCatalog ?? "?").padStart(8)}` +
+                `${String(totals.duplicateNameDifferentRealpaths ?? "?").padStart(7)}` +
+                `${inventoryDelta(localTotals.uniqueSkillNames, totals.uniqueSkillNames).padStart(10)}`);
+            if (row.rootDir)
+                console.log(`  ${DIM("  root")} ${DIM(row.rootDir)}`);
+        }
+        console.log("");
+        console.log(DIM("  * matches this machine's local latest host name"));
+    }
+    renderInventoryDrift(drift);
+    console.log("");
+    console.log(DIM("  refresh: ") + chalk_1.default.cyan(`youmd skill inventory --out-dir ${outDir} --sync`));
+    console.log(DIM("  verify:  ") + chalk_1.default.cyan("youmd machine verify --write-report --sync-report"));
+    console.log(DIM("  exact diff needs two local JSON files: ") + chalk_1.default.cyan("youmd skill inventory diff macbook.json mac-mini.json"));
+    console.log("");
+}
+async function inventoryCmd(args) {
+    if (args[0] === "diff") {
+        inventoryDiffCmd(args.slice(1));
+        return;
+    }
+    if (args[0] === "status" || args[0] === "remote" || args[0] === "machines") {
+        await inventoryStatusCmd(args.slice(1));
+        return;
+    }
+    const { flags } = parseFlagArgs(args);
+    const script = resolveInventoryScript();
+    if (!script) {
+        console.log("");
+        console.log(chalk_1.default.yellow("  agent-stack-inventory script not found on this machine."));
+        console.log(DIM("  expected one of:"));
+        console.log(DIM("    ~/.agent-shared/claude-skills/agent-stack-inventory/scripts/local-agent-stack-inventory.mjs"));
+        console.log(DIM("    ~/.youmd/skills/agent-stack-inventory/scripts/local-agent-stack-inventory.mjs"));
+        console.log("");
+        console.log(DIM("  run ") + chalk_1.default.cyan("youmd skill install agent-stack-inventory") + DIM(" or sync your shared skills, then retry."));
+        console.log("");
+        return;
+    }
+    const outDir = path.resolve(flagString(flags, "out-dir") || process.cwd());
+    const workspace = flagString(flags, "workspace");
+    const date = flagString(flags, "date");
+    const shouldSync = flags.sync === true;
+    const shouldSyncRepo = flags["no-repo-sync"] !== true;
+    const startedAt = Date.now();
+    const scriptArgs = [script, "--out-dir", outDir, "--progress"];
+    if (workspace)
+        scriptArgs.push("--workspace", path.resolve(workspace));
+    if (date)
+        scriptArgs.push("--date", date);
+    console.log("");
+    const spinner = new render_1.BrailleSpinner("mapping the local skill mesh");
+    spinner.start();
+    let output = "";
+    try {
+        output = await runInventoryScript(scriptArgs, spinner);
+    }
+    catch (err) {
+        spinner.fail("inventory failed");
+        const message = err instanceof Error ? err.message : String(err);
+        console.log(DIM(`  ${message}`));
+        console.log("");
+        return;
+    }
+    const latest = findLatestInventoryJson(outDir, startedAt);
+    const parsed = latest ? readInventorySnapshot(latest) : null;
+    spinner.stop("inventory generated");
+    console.log("");
+    if (parsed?.totals) {
+        renderInventoryTotals(parsed.totals);
+        renderInventoryPhaseTimings(parsed);
+        console.log("");
+    }
+    let htmlPath = latest ? latest.replace(/\.json$/, ".html") : undefined;
+    let jsonPath = latest || undefined;
+    try {
+        const scriptResult = JSON.parse(output);
+        htmlPath = scriptResult.html || htmlPath;
+        jsonPath = scriptResult.json || jsonPath;
+        if (scriptResult.html)
+            console.log(`  ${DIM("html")} ${chalk_1.default.cyan(scriptResult.html)}`);
+        if (scriptResult.json)
+            console.log(`  ${DIM("json")} ${chalk_1.default.cyan(scriptResult.json)}`);
+    }
+    catch {
+        if (latest) {
+            console.log(`  ${DIM("json")} ${chalk_1.default.cyan(latest)}`);
+            console.log(`  ${DIM("html")} ${chalk_1.default.cyan(latest.replace(/\.json$/, ".html"))}`);
+        }
+    }
+    if (shouldSync && parsed) {
+        if (!(0, config_1.isAuthenticated)()) {
+            console.log(DIM("  sync skipped: run `youmd login` or set YOUMD_API_KEY to persist this machine inventory."));
+        }
+        else {
+            try {
+                const res = await (0, api_1.syncAgentStackInventory)(buildAgentStackInventorySyncPayload(parsed, jsonPath, htmlPath, shouldSyncRepo));
+                if (res.ok && res.data?.success) {
+                    const action = res.data.created ? "created" : "updated";
+                    console.log(`  ${DIM("sync")} ${chalk_1.default.green(action)} You.md agent stack inventory`);
+                    if (res.data.repoSync?.attempted) {
+                        const label = res.data.repoSync.ok ? chalk_1.default.green("synced repo snapshot") : ACCENT("repo snapshot skipped");
+                        console.log(`  ${DIM("repo")} ${label}${res.data.repoSync.error ? DIM(`: ${res.data.repoSync.error}`) : ""}`);
+                    }
+                    else if (!shouldSyncRepo) {
+                        console.log(`  ${DIM("repo")} ${DIM("snapshot sync disabled by --no-repo-sync")}`);
+                    }
+                }
+                else {
+                    console.log(`  ${DIM("sync skipped:")} ${(0, api_1.apiErrorMessage)(res.data) || `HTTP ${res.status}`}`);
+                }
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                console.log(`  ${DIM("sync skipped:")} ${message}`);
+            }
+        }
+    }
+    console.log("");
 }
 function searchCmd(args) {
     const query = args.join(" ");
@@ -1216,6 +1885,10 @@ async function skillCommand(subcommand, ...args) {
         case "improve":
             await improveCmd();
             break;
+        case "inventory":
+        case "audit":
+            await inventoryCmd(args);
+            break;
         case "metrics":
         case "stats":
             metricsCmd();
@@ -1283,6 +1956,11 @@ async function skillCommand(subcommand, ...args) {
             console.log(`    ${chalk_1.default.cyan("link <agent>".padEnd(28))} ${DIM("link to claude | cursor | codex")}`);
             console.log(`    ${chalk_1.default.cyan("init-project [--mode auto|additive|zero-touch|scaffold]".padEnd(28))} ${DIM("bootstrap AGENTS/CLAUDE + project-context/ + .you/ + links")}`);
             console.log(`    ${chalk_1.default.cyan("improve".padEnd(28))} ${DIM("review metrics, find gaps, propose changes")}`);
+            console.log(`    ${chalk_1.default.cyan("inventory [--out-dir dir]".padEnd(28))} ${DIM("map local/global skills, mirrors, catalog gaps, and DRY risks")}`);
+            console.log(`    ${chalk_1.default.cyan("inventory --sync".padEnd(28))} ${DIM("persist safe inventory metadata to Convex + repo snapshot")}`);
+            console.log(`    ${chalk_1.default.cyan("inventory --no-repo-sync".padEnd(28))} ${DIM("skip GitHub snapshot push when syncing inventory")}`);
+            console.log(`    ${chalk_1.default.cyan("inventory status".padEnd(28))} ${DIM("show synced machine inventory summaries and count drift")}`);
+            console.log(`    ${chalk_1.default.cyan("inventory diff <a> <b>".padEnd(28))} ${DIM("compare two machine inventory JSON snapshots")}`);
             console.log(`    ${chalk_1.default.cyan("metrics".padEnd(28))} ${DIM("usage stats and effectiveness scores")}`);
             console.log(`    ${chalk_1.default.cyan("search <query>".padEnd(28))} ${DIM("search skills by name or description")}`);
             console.log(`    ${chalk_1.default.cyan("browse".padEnd(28))} ${DIM("browse the public skill registry")}`);