youmd 0.6.19 → 0.6.26

package/dist/commands/skill.js

@@ -45,6 +45,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.skillCommand = skillCommand;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const readline = __importStar(require("readline"));
+const yaml = __importStar(require("js-yaml"));
 const chalk_1 = __importDefault(require("chalk"));
 const skill_catalog_1 = require("../lib/skill-catalog");
 const skills_1 = require("../lib/skills");
@@ -53,6 +56,7 @@ const render_1 = require("../lib/render");
 const config_1 = require("../lib/config");
 const api_1 = require("../lib/api");
 const skills_2 = require("../lib/skills");
+const host_link_1 = require("../lib/host-link");
 const ACCENT = chalk_1.default.hex("#C46A3A");
 const DIM = chalk_1.default.dim;
 // ─── Personality spinner labels ──────────────────────────────────────
@@ -107,7 +111,7 @@ function truncateAtWord(text, max) {
     return (lastSpace > max * 0.5 ? truncated.slice(0, lastSpace) : truncated) + "...";
 }
 // ─── Subcommands ──────────────────────────────────────────────────────
-const RECOMMENDED_SKILLS = new Set(["claude-md-generator", "voice-sync"]);
+const RECOMMENDED_SKILLS = new Set(["youstack-start", "claude-md-generator", "voice-sync"]);
 async function listSkills() {
     const catalog = (0, skill_catalog_1.readSkillCatalog)();
     console.log("");
@@ -165,7 +169,7 @@ async function listSkills() {
     if (installed === 0) {
         console.log("");
         console.log(DIM("  get started: ") +
-            chalk_1.default.cyan("youmd skill install claude-md-generator"));
+            chalk_1.default.cyan("youmd skill install youstack-start"));
     }
     console.log("");
 }
@@ -184,11 +188,10 @@ async function installSkillCmd(args) {
         console.log("");
         const spinner = new render_1.BrailleSpinner(randomSpinner("install"));
         spinner.start();
-        await new Promise((r) => setTimeout(r, 300));
         let installed = 0;
         for (const entry of toInstall) {
             let result = (0, skills_1.installSkill)(entry.name);
-            if (!result.ok && (entry.source.startsWith("github:") || entry.source.startsWith("https://"))) {
+            if (!result.ok && (0, skills_1.isRemoteSkillSource)(entry.source)) {
                 result = await (0, skills_1.installSkillAsync)(entry.name);
             }
             if (result.ok)
@@ -213,7 +216,6 @@ async function installSkillCmd(args) {
             console.log("");
             const regSpinner = new render_1.BrailleSpinner("checking the skill registry");
             regSpinner.start();
-            await new Promise((r) => setTimeout(r, 200));
             try {
                 const regRes = await (0, api_1.browseSkills)();
                 if (regRes.ok) {
@@ -228,8 +230,7 @@ async function installSkillCmd(args) {
                             fs.mkdirSync(skillDir, { recursive: true });
                             fs.writeFileSync(path.join(skillDir, "SKILL.md"), contentRes.data.content);
                             // Render with identity
-                            const { renderSkillTemplate, loadIdentityData: loadId } = require("../lib/skill-renderer");
-                            const rendered = renderSkillTemplate(contentRes.data.content, loadId());
+                            const rendered = (0, skill_renderer_1.renderSkillTemplate)(contentRes.data.content, (0, skill_renderer_1.loadIdentityData)());
                             fs.writeFileSync(path.join(skillDir, "RENDERED.md"), rendered);
                             // Add to catalog and mark installed
                             (0, skill_catalog_1.addSkillEntry)((0, skill_catalog_1.readSkillCatalog)(), {
@@ -289,10 +290,9 @@ async function installSkillCmd(args) {
     console.log("");
     const spinner = new render_1.BrailleSpinner(randomSpinner("install"));
     spinner.start();
-    await new Promise((r) => setTimeout(r, 300));
     // Try sync install, fall back to async for remote sources
     let result = (0, skills_1.installSkill)(entry.name);
-    if (!result.ok && (entry.source.startsWith("github:") || entry.source.startsWith("https://"))) {
+    if (!result.ok && (0, skills_1.isRemoteSkillSource)(entry.source)) {
         result = await (0, skills_1.installSkillAsync)(entry.name);
     }
     if (result.ok) {
@@ -324,7 +324,6 @@ async function removeSkillCmd(args) {
         console.log("");
         const spinner = new render_1.BrailleSpinner(randomSpinner("remove"));
         spinner.start();
-        await new Promise((r) => setTimeout(r, 200));
         let removed = 0;
         for (const entry of toRemove) {
             const result = (0, skills_1.removeSkill)(entry.name);
@@ -345,7 +344,6 @@ async function removeSkillCmd(args) {
     console.log("");
     const spinner = new render_1.BrailleSpinner(randomSpinner("remove"));
     spinner.start();
-    await new Promise((r) => setTimeout(r, 200));
     const result = (0, skills_1.removeSkill)(name);
     if (result.ok) {
         spinner.stop("removed");
@@ -355,7 +353,7 @@ async function removeSkillCmd(args) {
     }
     console.log("");
 }
-async function useSkillCmd(args) {
+async function skillUseCmd(args) {
     const name = args[0];
     if (!name) {
         console.log("");
@@ -366,8 +364,7 @@ async function useSkillCmd(args) {
     console.log("");
     const spinner = new render_1.BrailleSpinner(randomSpinner("use"));
     spinner.start();
-    await new Promise((r) => setTimeout(r, 400));
-    const result = (0, skills_1.useSkill)(name);
+    const result = (0, skills_1.applySkill)(name);
     if (!result.ok) {
         spinner.fail(result.error);
         console.log("");
@@ -381,7 +378,7 @@ async function useSkillCmd(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("youmd chat") + DIM(" or edit .youmd/preferences/"));
+            console.log(DIM("  fill these via ") + chalk_1.default.cyan("you") + DIM(" or edit .youmd/preferences/"));
         }
         else {
             console.log(DIM(`  ${total}/${total} identity fields resolved.`));
@@ -408,7 +405,6 @@ async function syncSkillsCmd() {
     console.log("");
     const spinner = new render_1.BrailleSpinner(randomSpinner("sync"));
     spinner.start();
-    await new Promise((r) => setTimeout(r, 400));
     const result = (0, skills_1.syncAllSkills)();
     if (result.synced.length > 0) {
         spinner.stop(`${result.synced.length} skills synced`);
@@ -433,7 +429,7 @@ function addSkillCmd(args) {
     if (!name || !source) {
         console.log("");
         console.log(chalk_1.default.yellow("  usage: youmd skill add <name> <source>"));
-        console.log(DIM("  source: local:/path/to/skill.md or github:owner/repo/path"));
+        console.log(DIM("  source: local:/path/to/skill.md, github:owner/repo/path, or registry:<name>"));
         console.log("");
         return;
     }
@@ -454,7 +450,6 @@ function addSkillCmd(args) {
     console.log("");
 }
 async function createSkillCmd(args) {
-    const readline = require("readline");
     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("");
@@ -513,7 +508,6 @@ async function createSkillCmd(args) {
         "",
     ].join("\n");
     // Write to ~/.youmd/skills/<name>/SKILL.md
-    const os = require("os");
     const skillDir = path.join(os.homedir(), ".youmd", "skills", slug);
     fs.mkdirSync(skillDir, { recursive: true });
     fs.writeFileSync(path.join(skillDir, "SKILL.md"), skillContent);
@@ -561,7 +555,7 @@ function pushSkillCmd(args) {
         console.log("");
         return;
     }
-    const skillPath = path.join(require("os").homedir(), ".youmd", "skills", entry.name, "SKILL.md");
+    const skillPath = path.join(os.homedir(), ".youmd", "skills", entry.name, "SKILL.md");
     if (!fs.existsSync(skillPath)) {
         console.log(chalk_1.default.yellow(`  SKILL.md not found for "${name}". install first.`));
         return;
@@ -600,7 +594,6 @@ async function linkSkillsCmd(args) {
     console.log("");
     const spinner = new render_1.BrailleSpinner(randomSpinner("link"));
     spinner.start();
-    await new Promise((r) => setTimeout(r, 300));
     const result = (0, skills_1.linkToAgent)(target);
     if (result.ok) {
         spinner.stop(result.path);
@@ -639,11 +632,10 @@ async function initProjectCmd(args = []) {
     if (toInstall.length > 0) {
         const installSpinner = new render_1.BrailleSpinner(randomSpinner("install"));
         installSpinner.start();
-        await new Promise((r) => setTimeout(r, 300));
         let installed = 0;
         for (const entry of toInstall) {
             let result = (0, skills_1.installSkill)(entry.name);
-            if (!result.ok && (entry.source.startsWith("github:") || entry.source.startsWith("https://"))) {
+            if (!result.ok && (0, skills_1.isRemoteSkillSource)(entry.source)) {
                 result = await (0, skills_1.installSkillAsync)(entry.name);
             }
             if (result.ok)
@@ -653,7 +645,6 @@ async function initProjectCmd(args = []) {
     }
     const spinner = new render_1.BrailleSpinner(randomSpinner("init"));
     spinner.start();
-    await new Promise((r) => setTimeout(r, 500));
     const result = (0, skills_1.initProject)({ mode });
     spinner.stop();
     console.log("");
@@ -702,7 +693,7 @@ function metricsCmd() {
         console.log("");
     }
 }
-function improveCmd() {
+async function improveCmd() {
     const metrics = (0, skills_1.getMetrics)();
     const catalog = (0, skill_catalog_1.readSkillCatalog)();
     const identity = (0, skill_renderer_1.loadIdentityData)();
@@ -711,19 +702,90 @@ function improveCmd() {
     console.log("");
     const installed = catalog.skills.filter((s) => s.installed);
     const notInstalled = catalog.skills.filter((s) => !s.installed);
+    // ─── Live outcome insights (L10) ──────────────────────────────────
+    let liveInsights = null;
+    if ((0, config_1.isAuthenticated)()) {
+        const insightSpinner = new render_1.BrailleSpinner("fetching outcome telemetry");
+        insightSpinner.start();
+        try {
+            const res = await (0, api_1.getSkillInsights)();
+            if (res.ok && Array.isArray(res.data?.insights) && res.data.insights.length > 0) {
+                liveInsights = res.data.insights;
+                insightSpinner.stop(`${liveInsights.length} skill${liveInsights.length === 1 ? "" : "s"} with outcome data`);
+            }
+            else {
+                insightSpinner.stop("no outcome data yet");
+            }
+        }
+        catch {
+            insightSpinner.stop("offline — using local metrics");
+        }
+    }
+    // ─── Fleet snapshot (L22) ────────────────────────────────────────
+    let fleetLines = [];
+    if ((0, config_1.isAuthenticated)()) {
+        try {
+            const fleetRes = await (0, api_1.getFleetSnapshot)();
+            if (fleetRes.ok && Array.isArray(fleetRes.data?.skills)) {
+                fleetLines = fleetRes.data.skills
+                    .filter((s) => s.fleetInstallCount !== null)
+                    .map((s) => DIM(`  ${s.skill}: shared by ~${s.fleetInstallCount} others`));
+            }
+        }
+        catch {
+            // fleet data is best-effort — silently skip on error
+        }
+    }
+    // ─── Live outcome table ───────────────────────────────────────────
+    if (liveInsights && liveInsights.length > 0) {
+        console.log("  " + ACCENT("outcome history:"));
+        console.log("");
+        const maxName = Math.max(...liveInsights.map((s) => s.skill.length), 5);
+        const headerStr = `  ${"skill".padEnd(maxName + 2)}` +
+            `${"uses".padStart(6)}  ` +
+            `${"success rate".padEnd(13)}  ` +
+            `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);
+            const rateColored = s.successRate >= 0.8
+                ? chalk_1.default.green(rateStr)
+                : ACCENT(rateStr);
+            const lastUsed = s.lastUsedAt > 0
+                ? new Date(s.lastUsedAt).toISOString().slice(0, 10)
+                : "never";
+            console.log(`  ${chalk_1.default.cyan(s.skill.padEnd(maxName + 2))}` +
+                `${String(s.uses).padStart(6)}  ` +
+                `${rateColored.padEnd(13)}  ` +
+                `${DIM(lastUsed)}`);
+            if (s.successRate < 0.8 && s.failure + s.partial > 0) {
+                lowPerformers.push(s);
+            }
+        }
+        console.log("");
+        for (const s of lowPerformers) {
+            const failCount = s.failure + s.partial;
+            console.log(DIM(`    consider revising ${s.skill} — ${failCount} failure${failCount === 1 ? "" : "s"} recently`));
+        }
+        if (lowPerformers.length > 0)
+            console.log("");
+    }
     // ─── Activity Analysis ────────────────────────────────────────────
     const totalUses = Object.values(metrics.skills).reduce((sum, s) => sum + s.uses, 0);
     console.log("  " + ACCENT("overview: ") +
-        `${installed.length} installed, ${totalUses} total uses, ` +
+        `${installed.length} installed, ${totalUses} total local uses, ` +
         `${Object.keys(metrics.identityFields).length} identity fields tracked`);
     console.log("");
-    // Most used
+    // Most used (local — only show when no live insights available)
     const mostUsed = Object.entries(metrics.skills)
         .filter(([, data]) => data.uses > 0)
         .sort((a, b) => b[1].uses - a[1].uses)
         .slice(0, 5);
-    if (mostUsed.length > 0) {
-        console.log("  " + ACCENT("most active:"));
+    if (mostUsed.length > 0 && !liveInsights) {
+        console.log("  " + ACCENT("most active (local):"));
         for (const [name, data] of mostUsed) {
             const bar = ACCENT("\u2588".repeat(Math.min(data.uses, 20))) + DIM("\u2591".repeat(Math.max(0, 20 - data.uses)));
             console.log(`    ${chalk_1.default.cyan(name.padEnd(24))} ${bar} ${data.uses}`);
@@ -781,7 +843,7 @@ function improveCmd() {
         for (const f of missing) {
             console.log(`    ${chalk_1.default.yellow(f)}`);
         }
-        console.log(DIM("\n  fill via ") + chalk_1.default.cyan("youmd chat") + DIM(" or edit .youmd/preferences/"));
+        console.log(DIM("\n  fill via ") + chalk_1.default.cyan("you") + DIM(" or edit .youmd/preferences/"));
         console.log("");
     }
     else if (allFields.size > 0) {
@@ -805,17 +867,23 @@ function improveCmd() {
     if (identity.voice.overall && !(0, skill_catalog_1.findSkill)(catalog, "voice-sync")?.installed) {
         proposals.push("install voice-sync — you have voice data that could propagate to all agents");
     }
-    // Propose running sync if skills are installed but metrics show 0 syncs
-    const syncCount = Object.values(metrics.skills).reduce((sum, s) => sum + s.uses, 0);
-    if (installed.length > 0 && syncCount === 0) {
-        proposals.push("run \"youmd skill sync\" — installed skills haven't been synced yet");
-    }
-    // Propose linking if skills installed but no .claude/skills/youmd exists
-    if (installed.length > 0) {
-        const claudeSkillsDir = path.join(process.cwd(), ".claude", "skills", "youmd");
-        if (!fs.existsSync(claudeSkillsDir)) {
-            proposals.push("run \"youmd skill link claude\" — skills aren't linked to this project's agent");
-        }
+    // Propose running sync only when identity actually changed after the last
+    // skill sync (lastSyncedAt is recorded by the sync paths in lib/skills).
+    // Previously this keyed off total uses, which is unrelated to sync state.
+    const identityChangedAt = (0, skills_1.getIdentityLastChangedAt)();
+    const lastSyncedAtMs = metrics.lastSyncedAt ? Date.parse(metrics.lastSyncedAt) : NaN;
+    if (installed.length > 0 &&
+        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");
+    }
+    // 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");
     }
     if (proposals.length > 0) {
         console.log("  " + chalk_1.default.bold("proposals:"));
@@ -828,6 +896,13 @@ function improveCmd() {
         console.log("  " + chalk_1.default.green("\u2713") + DIM(" no improvements to suggest right now."));
         console.log("");
     }
+    // \u2500\u2500\u2500 Fleet context (L22) \u2014 one dim line per skill with fleet data \u2500\u2500\u2500\u2500\u2500
+    if (fleetLines.length > 0) {
+        for (const line of fleetLines) {
+            console.log(line);
+        }
+        console.log("");
+    }
 }
 function searchCmd(args) {
     const query = args.join(" ");
@@ -863,7 +938,6 @@ async function browseCmd() {
     console.log("");
     const spinner = new render_1.BrailleSpinner("scanning the skill registry");
     spinner.start();
-    await new Promise((r) => setTimeout(r, 300));
     try {
         const res = await (0, api_1.browseSkills)();
         if (!res.ok) {
@@ -888,7 +962,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 add <name> registry:<name>`));
+        console.log(DIM(`  install with: youmd skill install <name>`));
     }
     catch {
         spinner.fail("registry unreachable");
@@ -928,7 +1002,6 @@ async function publishSkillCmd(args) {
     console.log("");
     const spinner = new render_1.BrailleSpinner("publishing to the skill registry");
     spinner.start();
-    await new Promise((r) => setTimeout(r, 400));
     try {
         const res = await (0, api_1.publishSkill)({
             name: entry.name,
@@ -942,10 +1015,10 @@ 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 add ${entry.name} registry:${entry.name}`));
+            console.log(DIM(`  others can install with: youmd skill install ${entry.name}`));
         }
         else {
-            spinner.fail(String(res.data?.error || "publish failed"));
+            spinner.fail((0, api_1.apiErrorMessage)(res.data) || "publish failed");
         }
     }
     catch (err) {
@@ -963,7 +1036,6 @@ async function remoteStatusCmd() {
     console.log("");
     const spinner = new render_1.BrailleSpinner("fetching your skill profile from the cloud");
     spinner.start();
-    await new Promise((r) => setTimeout(r, 300));
     try {
         const res = await (0, api_1.getMySkills)();
         if (!res.ok) {
@@ -1070,10 +1142,10 @@ function exportSkillsCmd(args) {
             continue;
         // Export the raw SKILL.md
         const outPath = path.join(outputDir, `${entry.name}.md`);
-        const raw = fs.readFileSync(path.join(require("os").homedir(), ".youmd", "skills", entry.name, "SKILL.md"), "utf-8");
+        const raw = fs.readFileSync(path.join(os.homedir(), ".youmd", "skills", entry.name, "SKILL.md"), "utf-8");
         fs.writeFileSync(outPath, raw);
         // Also export the rendered version
-        const renderedPath = path.join(require("os").homedir(), ".youmd", "skills", entry.name, "RENDERED.md");
+        const renderedPath = path.join(os.homedir(), ".youmd", "skills", entry.name, "RENDERED.md");
         if (fs.existsSync(renderedPath)) {
             fs.writeFileSync(path.join(outputDir, `${entry.name}.rendered.md`), fs.readFileSync(renderedPath, "utf-8"));
         }
@@ -1081,7 +1153,6 @@ function exportSkillsCmd(args) {
         exported++;
     }
     // Write catalog.yaml
-    const yaml = require("js-yaml");
     const exportCatalog = {
         version: 1,
         exported: new Date().toISOString(),
@@ -1116,7 +1187,7 @@ async function skillCommand(subcommand, ...args) {
             break;
         case "use":
         case "run":
-            await useSkillCmd(args);
+            await skillUseCmd(args);
             break;
         case "sync":
             await syncSkillsCmd();
@@ -1139,7 +1210,7 @@ async function skillCommand(subcommand, ...args) {
             await initProjectCmd(args);
             break;
         case "improve":
-            improveCmd();
+            await improveCmd();
             break;
         case "metrics":
         case "stats":