youmd 0.8.11 → 0.8.13

package/dist/commands/skill.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * youmd skill — identity-aware agent skill system.
+ * you skill — identity-aware agent skill system.
  *
  * Subcommand router following the project.ts pattern.
  * Manages skill lifecycle: install, remove, use, sync, link, init-project.
@@ -147,8 +147,9 @@ function flagString(flags, key) {
 }
 function resolveInventoryScript() {
     const candidates = [
-        process.env.YOUMD_AGENT_STACK_INVENTORY_SCRIPT,
+        process.env.YOU_AGENT_STACK_INVENTORY_SCRIPT || 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((0, config_1.getSkillsDir)(), "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"),
@@ -341,6 +342,13 @@ function inventorySampleNames(rows) {
         .filter(Boolean)
         .slice(0, 24);
 }
+function inventoryCatalogRows(snapshot) {
+    return (snapshot.missingFromCatalog || []).flatMap((row) => {
+        if (typeof row === "string")
+            return [{ name: row }];
+        return [row];
+    });
+}
 function buildAgentStackInventorySyncPayload(snapshot, jsonPath, htmlPath, syncRepo = true) {
     const totals = snapshot.totals || {};
     return {
@@ -353,7 +361,7 @@ function buildAgentStackInventorySyncPayload(snapshot, jsonPath, htmlPath, syncR
         reportJsonPath: jsonPath,
         reportHtmlPath: htmlPath,
         source: "youmd-cli",
-        agentName: "youmd skill inventory",
+        agentName: "you skill inventory",
         totals: {
             uniqueSkillNames: safeInventoryCount(totals.uniqueSkillNames),
             uniqueRealSkillFiles: safeInventoryCount(totals.uniqueRealSkillFiles),
@@ -416,11 +424,11 @@ const RECOMMENDED_SKILLS = new Set([
 async function listSkills() {
     const catalog = (0, skill_catalog_1.readSkillCatalog)();
     console.log("");
-    console.log("  " + chalk_1.default.bold("youmd skills") + DIM(` (${catalog.skills.length} in catalog)`));
+    console.log("  " + chalk_1.default.bold("you skills") + DIM(` (${catalog.skills.length} in catalog)`));
     console.log("");
     if (catalog.skills.length === 0) {
         console.log(DIM("  no skills registered."));
-        console.log(DIM("  run ") + chalk_1.default.cyan("youmd skill add <name> <source>") + DIM(" to add one."));
+        console.log(DIM("  run ") + chalk_1.default.cyan("you skill add <name> <source>") + DIM(" to add one."));
         console.log("");
         return;
     }
@@ -470,7 +478,7 @@ async function listSkills() {
     if (installed === 0) {
         console.log("");
         console.log(DIM("  get started: ") +
-            chalk_1.default.cyan("youmd skill install youstack-start"));
+            chalk_1.default.cyan("you skill install youstack-start"));
     }
     console.log("");
 }
@@ -501,8 +509,8 @@ async function installSkillCmd(args) {
     }
     if (!name) {
         console.log("");
-        console.log(chalk_1.default.yellow("  usage: youmd skill install <name>"));
-        console.log(DIM("  or:    youmd skill install all"));
+        console.log(chalk_1.default.yellow("  usage: you skill install <name>"));
+        console.log(DIM("  or:    you skill install all"));
         console.log("");
         return;
     }
@@ -574,8 +582,8 @@ async function installSkillCmd(args) {
         }
         console.log("");
         console.log(chalk_1.default.yellow(`  skill "${name}" not found in catalog or registry.`));
-        console.log(DIM("  run ") + chalk_1.default.cyan("youmd skill list") + DIM(" to see available skills."));
-        console.log(DIM("  or:  ") + chalk_1.default.cyan("youmd skill browse") + DIM(" to check the registry."));
+        console.log(DIM("  run ") + chalk_1.default.cyan("you skill list") + DIM(" to see available skills."));
+        console.log(DIM("  or:  ") + chalk_1.default.cyan("you skill browse") + DIM(" to check the registry."));
         console.log("");
         return;
     }
@@ -638,8 +646,8 @@ async function removeSkillCmd(args) {
     }
     if (!name) {
         console.log("");
-        console.log(chalk_1.default.yellow("  usage: youmd skill remove <name>"));
-        console.log(DIM("  or:    youmd skill remove all"));
+        console.log(chalk_1.default.yellow("  usage: you skill remove <name>"));
+        console.log(DIM("  or:    you skill remove all"));
         console.log("");
         return;
     }
@@ -659,7 +667,7 @@ async function skillUseCmd(args) {
     const name = args[0];
     if (!name) {
         console.log("");
-        console.log(chalk_1.default.yellow("  usage: youmd skill use <name>"));
+        console.log(chalk_1.default.yellow("  usage: you skill use <name>"));
         console.log("");
         return;
     }
@@ -680,7 +688,7 @@ async function skillUseCmd(args) {
             console.log("");
             console.log(ACCENT(`  ${filled}/${total} identity fields resolved.`) +
                 DIM(` missing: ${missing.join(", ")}`));
-            console.log(DIM("  fill these via ") + chalk_1.default.cyan("you") + DIM(" or edit .youmd/preferences/"));
+            console.log(DIM("  fill these via ") + chalk_1.default.cyan("you") + DIM(" or edit .you/preferences/"));
         }
         else {
             console.log(DIM(`  ${total}/${total} identity fields resolved.`));
@@ -761,7 +769,7 @@ function addSkillCmd(args) {
     const source = args[1];
     if (!name || !source) {
         console.log("");
-        console.log(chalk_1.default.yellow("  usage: youmd skill add <name> <source>"));
+        console.log(chalk_1.default.yellow("  usage: you skill add <name> <source>"));
         console.log(DIM("  source: local:/path/to/skill.md, github:owner/repo/path, or registry:<name>"));
         console.log("");
         return;
@@ -779,14 +787,14 @@ function addSkillCmd(args) {
     console.log("");
     console.log(chalk_1.default.green("  \u2713") + ` ${chalk_1.default.bold(name)} added to catalog`);
     console.log(DIM(`  source: ${source}`));
-    console.log(DIM("  run ") + chalk_1.default.cyan(`youmd skill install ${name}`) + DIM(" to install."));
+    console.log(DIM("  run ") + chalk_1.default.cyan(`you skill install ${name}`) + DIM(" to install."));
     console.log("");
 }
 async function createSkillCmd(args) {
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     const ask = (q) => new Promise((res) => rl.question(q, (a) => res(a.trim())));
     console.log("");
-    console.log("  " + chalk_1.default.bold("youmd skill create"));
+    console.log("  " + chalk_1.default.bold("you skill create"));
     console.log(DIM("  scaffold a new identity-aware skill\n"));
     // Name
     let name = args[0] || "";
@@ -840,8 +848,8 @@ async function createSkillCmd(args) {
         "3. (step 3)",
         "",
     ].join("\n");
-    // Write to ~/.youmd/skills/<name>/SKILL.md
-    const skillDir = path.join(os.homedir(), ".youmd", "skills", slug);
+    // Write to ~/.you/skills/<name>/SKILL.md
+    const skillDir = path.join((0, config_1.getSkillsDir)(), slug);
     fs.mkdirSync(skillDir, { recursive: true });
     fs.writeFileSync(path.join(skillDir, "SKILL.md"), skillContent);
     // Add to catalog
@@ -861,15 +869,15 @@ async function createSkillCmd(args) {
     console.log(DIM(`  ${path.join(skillDir, "SKILL.md")}`));
     console.log("");
     console.log(DIM("  edit the SKILL.md, then:"));
-    console.log(`    ${chalk_1.default.cyan(`youmd skill use ${slug}`)}   ${DIM("render with your identity")}`);
-    console.log(`    ${chalk_1.default.cyan(`youmd skill link claude`)} ${DIM("link to your project")}`);
+    console.log(`    ${chalk_1.default.cyan(`you skill use ${slug}`)}   ${DIM("render with your identity")}`);
+    console.log(`    ${chalk_1.default.cyan(`you skill link claude`)} ${DIM("link to your project")}`);
     console.log("");
 }
 function pushSkillCmd(args) {
     const name = args[0];
     if (!name) {
         console.log("");
-        console.log(chalk_1.default.yellow("  usage: youmd skill push <name>"));
+        console.log(chalk_1.default.yellow("  usage: you skill push <name>"));
         console.log("");
         return;
     }
@@ -888,7 +896,7 @@ function pushSkillCmd(args) {
         console.log("");
         return;
     }
-    const skillPath = path.join(os.homedir(), ".youmd", "skills", entry.name, "SKILL.md");
+    const skillPath = (0, skills_2.getSkillDir)(entry.name);
     if (!fs.existsSync(skillPath)) {
         console.log(chalk_1.default.yellow(`  SKILL.md not found for "${name}". install first.`));
         return;
@@ -949,7 +957,7 @@ function parseInitProjectMode(args) {
 }
 async function initProjectCmd(args = []) {
     console.log("");
-    console.log("  " + chalk_1.default.bold("youmd skill init-project"));
+    console.log("  " + chalk_1.default.bold("you skill init-project"));
     const mode = parseInitProjectMode(args);
     // Detect existing .youmd-project
     const youmdProjectPath = path.join(process.cwd(), ".youmd-project");
@@ -1173,7 +1181,7 @@ async function improveCmd() {
         for (const f of missing) {
             console.log(`    ${chalk_1.default.yellow(f)}`);
         }
-        console.log(DIM("\n  fill via ") + chalk_1.default.cyan("you") + DIM(" or edit .youmd/preferences/"));
+        console.log(DIM("\n  fill via ") + chalk_1.default.cyan("you") + DIM(" or edit .you/preferences/"));
         console.log("");
     }
     else if (allFields.size > 0) {
@@ -1206,14 +1214,14 @@ async function improveCmd() {
         identityChangedAt !== null &&
         (Number.isNaN(lastSyncedAtMs) || identityChangedAt > lastSyncedAtMs)) {
         proposals.push(Number.isNaN(lastSyncedAtMs)
-            ? "run \"youmd skill sync\" — installed skills haven't been synced against your identity yet"
-            : "run \"youmd skill sync\" — your identity changed after the last skill sync");
+            ? "run \"you skill sync\" — installed skills haven't been synced against your identity yet"
+            : "run \"you skill sync\" — your identity changed after the last skill sync");
     }
     // Propose linking if skills are installed but not linked into the Claude
     // Code discovery layout (.claude/skills/<name>/SKILL.md)
     if (installed.length > 0 &&
         !(0, host_link_1.hasLinkedClaudeSkills)(process.cwd(), installed.map((s) => s.name))) {
-        proposals.push("run \"youmd skill link claude\" — skills aren't linked to this project's agent");
+        proposals.push("run \"you skill link claude\" — skills aren't linked to this project's agent");
     }
     if (proposals.length > 0) {
         console.log("  " + chalk_1.default.bold("proposals:"));
@@ -1288,8 +1296,8 @@ function inventoryDiffCmd(args) {
     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(chalk_1.default.yellow("  usage: you skill inventory diff --left mac-mini.json --right laptop.json"));
+        console.log(DIM("  or:    you skill inventory diff mac-mini.json laptop.json"));
         console.log("");
         return;
     }
@@ -1345,7 +1353,7 @@ function inventoryDiffCmd(args) {
 }
 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 outDir = path.resolve(flagString(flags, "out-dir") || path.join((0, config_1.getWritableHomeBundleDir)(), "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))))
@@ -1359,14 +1367,14 @@ async function inventoryStatusCmd(args) {
             console.log(JSON.stringify({
                 success: false,
                 error: "not_authenticated",
-                repair: "youmd login",
+                repair: "you 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(chalk_1.default.yellow("  not authenticated. run: ") + chalk_1.default.cyan("you login"));
+        console.log(DIM("  then: ") + chalk_1.default.cyan("you skill inventory status"));
         console.log("");
         return;
     }
@@ -1425,7 +1433,7 @@ async function inventoryStatusCmd(args) {
     }
     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(DIM("  repair: ") + chalk_1.default.cyan(`you skill inventory --out-dir ${outDir} --register-catalog --sync`));
     }
     console.log("");
     if (inventories.length === 0) {
@@ -1469,9 +1477,9 @@ async function inventoryStatusCmd(args) {
     }
     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(DIM("  refresh: ") + chalk_1.default.cyan(`you skill inventory --out-dir ${outDir} --register-catalog --sync`));
+    console.log(DIM("  verify:  ") + chalk_1.default.cyan("you machine verify --write-report --sync-report"));
+    console.log(DIM("  exact diff needs two local JSON files: ") + chalk_1.default.cyan("you skill inventory diff macbook.json mac-mini.json"));
     console.log("");
 }
 async function inventoryCmd(args) {
@@ -1490,9 +1498,10 @@ async function inventoryCmd(args) {
         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(DIM("    ~/.you/skills/agent-stack-inventory/scripts/local-agent-stack-inventory.mjs"));
+        console.log(DIM("    ~/.youmd/skills/agent-stack-inventory/scripts/local-agent-stack-inventory.mjs (legacy)"));
         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(DIM("  run ") + chalk_1.default.cyan("you skill install agent-stack-inventory") + DIM(" or sync your shared skills, then retry."));
         console.log("");
         return;
     }
@@ -1501,6 +1510,7 @@ async function inventoryCmd(args) {
     const date = flagString(flags, "date");
     const shouldSync = flags.sync === true;
     const shouldSyncRepo = flags["no-repo-sync"] !== true;
+    const shouldRegisterCatalog = flags["register-catalog"] === true;
     const startedAt = Date.now();
     const scriptArgs = [script, "--out-dir", outDir, "--progress"];
     if (workspace)
@@ -1530,6 +1540,15 @@ async function inventoryCmd(args) {
         renderInventoryPhaseTimings(parsed);
         console.log("");
     }
+    if (shouldRegisterCatalog && parsed) {
+        const catalog = (0, skill_catalog_1.readSkillCatalog)();
+        const result = (0, skill_catalog_1.addInventorySkillsToCatalog)(catalog, inventoryCatalogRows(parsed));
+        const label = result.added > 0 ? chalk_1.default.green(`${result.added} added`) : DIM("no new entries");
+        console.log(`  ${DIM("catalog")} ${label}${result.skipped ? DIM(` · ${result.skipped} already known/skipped`) : ""}`);
+        if (result.skills.length > 0) {
+            console.log(`  ${DIM("catalog samples")} ${result.skills.slice(0, 8).map((name) => chalk_1.default.cyan(name)).join(DIM(", "))}`);
+        }
+    }
     let htmlPath = latest ? latest.replace(/\.json$/, ".html") : undefined;
     let jsonPath = latest || undefined;
     try {
@@ -1549,7 +1568,7 @@ async function inventoryCmd(args) {
     }
     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."));
+            console.log(DIM("  sync skipped: run `you login` or set YOU_API_KEY to persist this machine inventory."));
         }
         else {
             try {
@@ -1581,7 +1600,7 @@ function searchCmd(args) {
     const query = args.join(" ");
     if (!query) {
         console.log("");
-        console.log(chalk_1.default.yellow("  usage: youmd skill search <query>"));
+        console.log(chalk_1.default.yellow("  usage: you skill search <query>"));
         console.log("");
         return;
     }
@@ -1604,7 +1623,7 @@ function searchCmd(args) {
 async function browseCmd() {
     if (!(0, config_1.isAuthenticated)()) {
         console.log("");
-        console.log(chalk_1.default.yellow("  not authenticated. run: youmd login"));
+        console.log(chalk_1.default.yellow("  not authenticated. run: you login"));
         console.log("");
         return;
     }
@@ -1622,7 +1641,7 @@ async function browseCmd() {
         spinner.stop(`${skills.length} skill${skills.length === 1 ? "" : "s"} in registry`);
         if (skills.length === 0) {
             console.log(DIM("  no skills published yet."));
-            console.log(DIM("  be the first: ") + chalk_1.default.cyan("youmd skill publish <name>"));
+            console.log(DIM("  be the first: ") + chalk_1.default.cyan("you skill publish <name>"));
             console.log("");
             return;
         }
@@ -1635,7 +1654,7 @@ async function browseCmd() {
             console.log(`    ${DIM("v" + s.version)} ${DIM(s.scope)} ${DIM(`[${s.identityFields.join(", ")}]`)}`);
         }
         console.log("");
-        console.log(DIM(`  install with: youmd skill install <name>`));
+        console.log(DIM(`  install with: you skill install <name>`));
     }
     catch {
         spinner.fail("registry unreachable");
@@ -1646,14 +1665,14 @@ async function publishSkillCmd(args) {
     const name = args[0];
     if (!name) {
         console.log("");
-        console.log(chalk_1.default.yellow("  usage: youmd skill publish <name>"));
+        console.log(chalk_1.default.yellow("  usage: you skill publish <name>"));
         console.log(DIM("  publishes an installed skill to the you.md registry."));
         console.log("");
         return;
     }
     if (!(0, config_1.isAuthenticated)()) {
         console.log("");
-        console.log(chalk_1.default.yellow("  not authenticated. run: youmd login"));
+        console.log(chalk_1.default.yellow("  not authenticated. run: you login"));
         console.log("");
         return;
     }
@@ -1688,7 +1707,7 @@ async function publishSkillCmd(args) {
             spinner.stop(res.data.updated ? "updated" : "published");
             console.log("");
             console.log(chalk_1.default.green("  \u2713") + ` ${chalk_1.default.bold(entry.name)} is live on the registry`);
-            console.log(DIM(`  others can install with: youmd skill install ${entry.name}`));
+            console.log(DIM(`  others can install with: you skill install ${entry.name}`));
         }
         else {
             spinner.fail((0, api_1.apiErrorMessage)(res.data) || "publish failed");
@@ -1702,7 +1721,7 @@ async function publishSkillCmd(args) {
 async function remoteStatusCmd() {
     if (!(0, config_1.isAuthenticated)()) {
         console.log("");
-        console.log(chalk_1.default.yellow("  not authenticated. run: youmd login"));
+        console.log(chalk_1.default.yellow("  not authenticated. run: you login"));
         console.log("");
         return;
     }
@@ -1739,7 +1758,7 @@ function infoCmd(args) {
     const name = args[0];
     if (!name) {
         console.log("");
-        console.log(chalk_1.default.yellow("  usage: youmd skill info <name>"));
+        console.log(chalk_1.default.yellow("  usage: you skill info <name>"));
         console.log("");
         return;
     }
@@ -1815,10 +1834,10 @@ function exportSkillsCmd(args) {
             continue;
         // Export the raw SKILL.md
         const outPath = path.join(outputDir, `${entry.name}.md`);
-        const raw = fs.readFileSync(path.join(os.homedir(), ".youmd", "skills", entry.name, "SKILL.md"), "utf-8");
+        const raw = fs.readFileSync((0, skills_2.getSkillDir)(entry.name), "utf-8");
         fs.writeFileSync(outPath, raw);
         // Also export the rendered version
-        const renderedPath = path.join(os.homedir(), ".youmd", "skills", entry.name, "RENDERED.md");
+        const renderedPath = path.join((0, config_1.getSkillsDir)(), entry.name, "RENDERED.md");
         if (fs.existsSync(renderedPath)) {
             fs.writeFileSync(path.join(outputDir, `${entry.name}.rendered.md`), fs.readFileSync(renderedPath, "utf-8"));
         }
@@ -1918,7 +1937,7 @@ async function skillCommand(subcommand, ...args) {
             const catalog = (0, skill_catalog_1.readSkillCatalog)();
             const installed = catalog.skills.filter((s) => s.installed);
             console.log("");
-            console.log("  " + chalk_1.default.bold("youmd skill") + DIM(" — identity-aware agent skills"));
+            console.log("  " + chalk_1.default.bold("you skill") + DIM(" — identity-aware agent skills"));
             console.log("");
             if (installed.length > 0) {
                 // Quick identity coverage