wyrm-mcp 7.3.2 → 7.4.0

package/dist/session-seen.js

@@ -1,11 +1,59 @@
-class d{db;constructor(e){this.db=e}mark(e,t,s,n){this.db.prepare(`
+/**
+ * session_seen_artifacts helper (spec 014).
+ *
+ * Tracks which (kind, id) pairs have been fully-rendered to a session so
+ * subsequent wyrm_context_build calls within the same session can elide
+ * them to stub references. Backed by the migration-12 table.
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd.
+ * @license Proprietary — (c) 2026 Ghost Protocol (Pvt) Ltd. All rights reserved. See LICENSE.
+ */
+export class SessionSeen {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Mark an artifact as shown to the given session. */
+    mark(sessionId, artifactId, kind, mode) {
+        this.db.prepare(`
       INSERT INTO session_seen_artifacts (session_id, artifact_id, artifact_kind, render_mode)
       VALUES (?, ?, ?, ?)
       ON CONFLICT(session_id, artifact_id, artifact_kind)
       DO UPDATE SET shown_at = datetime('now'), render_mode = excluded.render_mode
-    `).run(e,t,s,n)}markBulk(e,t){const s=this.db.prepare(`
+    `).run(sessionId, artifactId, kind, mode);
+    }
+    /** Bulk-mark inlined artifacts for a session. */
+    markBulk(sessionId, items) {
+        const stmt = this.db.prepare(`
       INSERT INTO session_seen_artifacts (session_id, artifact_id, artifact_kind, render_mode)
       VALUES (?, ?, ?, ?)
       ON CONFLICT(session_id, artifact_id, artifact_kind)
       DO UPDATE SET shown_at = datetime('now'), render_mode = excluded.render_mode
-    `);this.db.transaction(i=>{for(const r of i)s.run(e,r.id,r.kind,r.mode)})(t)}getSeen(e){const t=this.db.prepare("SELECT artifact_id, artifact_kind FROM session_seen_artifacts WHERE session_id = ? AND render_mode = 'inline'").all(e);return new Set(t.map(s=>`${s.artifact_kind}:${s.artifact_id}`))}prune(e=7){return this.db.prepare("DELETE FROM session_seen_artifacts WHERE shown_at < datetime('now', ? || ' days')").run(`-${e}`).changes??0}count(){return this.db.prepare("SELECT COUNT(*) as n FROM session_seen_artifacts").get().n}}export{d as SessionSeen};
+    `);
+        const tx = this.db.transaction((rows) => {
+            for (const r of rows)
+                stmt.run(sessionId, r.id, r.kind, r.mode);
+        });
+        tx(items);
+    }
+    /** Return the set of "kind:id" keys already shown in this session, in inline mode. */
+    getSeen(sessionId) {
+        const rows = this.db
+            .prepare(`SELECT artifact_id, artifact_kind FROM session_seen_artifacts WHERE session_id = ? AND render_mode = 'inline'`)
+            .all(sessionId);
+        return new Set(rows.map((r) => `${r.artifact_kind}:${r.artifact_id}`));
+    }
+    /** Prune rows older than `olderThanDays`. Returns the count removed. */
+    prune(olderThanDays = 7) {
+        const result = this.db
+            .prepare(`DELETE FROM session_seen_artifacts WHERE shown_at < datetime('now', ? || ' days')`)
+            .run(`-${olderThanDays}`);
+        return result.changes ?? 0;
+    }
+    /** Row count for stats / diagnostics. */
+    count() {
+        const row = this.db.prepare('SELECT COUNT(*) as n FROM session_seen_artifacts').get();
+        return row.n;
+    }
+}
+//# sourceMappingURL=session-seen.js.map

package/dist/setup.js

@@ -1,2 +1,261 @@
 #!/usr/bin/env node
-import{detectClients as m,autoConfigureAll as u,removeFromAll as $,configureSpecific as p,reconfAll as h,getStatusSummary as y,findWyrmServerPath as b,getDefaultDbPath as v,loadWyrmMeta as k}from"./autoconfig.js";import{c as o,icons as r,BANNER as I,MINI_BANNER as i,printError as f,printSection as a}from"./cli.js";function w(s){const e=s.slice(2);if(e.length===0)return{command:"auto"};const n={command:"auto"};for(let l=0;l<e.length;l++)switch(e[l]){case"--check":case"-c":case"check":case"status":n.command="check";break;case"--remove":case"-r":case"remove":case"uninstall":n.command="remove";break;case"--only":case"-o":case"only":n.command="only",e[l+1]&&(n.clientIds=e[l+1].split(",").map(t=>t.trim()),l++);break;case"--reconf":case"--reconfigure":case"reconf":n.command="reconf";break;case"--list":case"-l":case"list":n.command="list";break;case"--server":case"-s":e[l+1]&&(n.serverPath=e[l+1],l++);break;case"--db":case"-d":e[l+1]&&(n.dbPath=e[l+1],l++);break;case"--help":case"-h":case"help":n.command="help";break}return n}function g(s){console.log("");const e=s.filter(c=>c.action==="configured"),n=s.filter(c=>c.action==="updated"),l=s.filter(c=>c.action==="skipped"),t=s.filter(c=>c.action==="failed");for(const c of e)console.log(`  ${r.success} ${c.client.icon} ${o.green(c.client.name)} \u2014 ${o.success("configured")}`),c.backup&&console.log(`    ${o.dim(`backup \u2192 ${c.backup}`)}`);for(const c of n)console.log(`  ${r.sync} ${c.client.icon} ${o.blue(c.client.name)} \u2014 ${o.cyan("updated")}`),c.backup&&console.log(`    ${o.dim(`backup \u2192 ${c.backup}`)}`);for(const c of l)console.log(`  ${o.dim(`  \u25CB ${c.client.icon} ${c.client.name} \u2014 ${c.message}`)}`);for(const c of t)console.log(`  ${r.error} ${c.client.icon} ${o.red(c.client.name)} \u2014 ${o.error(c.message)}`);console.log("");const d=e.length+n.length;d>0?(console.log(`  ${o.success(`${r.dragon} Wyrm connected to ${d} AI client(s)`)}`),console.log(`  ${o.dim("Switch AIs anytime \u2014 run wyrm-setup again to reconnect")}`)):t.length>0?console.log(`  ${o.error("Some configurations failed. Check errors above.")}`):console.log(`  ${o.dim("No AI clients detected. Install one and try again.")}`),console.log("")}function A(){console.log(i),console.log(""),console.log(`${o.bold("Usage:")} wyrm-setup ${o.dim("[command] [options]")}`),console.log(""),console.log(`${o.bold("Commands:")}`),console.log(`  ${o.cyan("(no args)")}      Auto-detect and configure all AI clients`),console.log(`  ${o.cyan("check")}          Show current configuration status`),console.log(`  ${o.cyan("list")}           List all supported AI clients`),console.log(`  ${o.cyan("remove")}         Remove Wyrm from all AI clients`),console.log(`  ${o.cyan("reconf")}         Re-configure previously configured clients`),console.log(`  ${o.cyan("only X,Y")}       Configure specific clients only`),console.log(`  ${o.cyan("help")}           Show this help message`),console.log(""),console.log(`${o.bold("Options:")}`),console.log(`  ${o.cyan("--server P")}     Override Wyrm MCP server path`),console.log(`  ${o.cyan("--db P")}         Override Wyrm database path`),console.log(""),console.log(`${o.bold("Client IDs:")}`);const s=m();for(const e of s)console.log(`  ${e.icon} ${o.cyan(e.id.padEnd(18))} ${e.name}`);console.log(""),console.log(`${o.bold("Examples:")}`),console.log(`  wyrm-setup                                   ${o.dim("# Auto-configure everything")}`),console.log(`  wyrm-setup check                             ${o.dim("# See what's configured")}`),console.log(`  wyrm-setup only vscode-copilot,cursor         ${o.dim("# Only VS Code + Cursor")}`),console.log(`  wyrm-setup --server /path/to/wyrm/dist/index.js  ${o.dim("# Custom server path")}`),console.log(`  wyrm-setup remove                            ${o.dim("# Remove from all clients")}`),console.log("")}function C(){console.log(i),console.log(""),a("Supported AI Clients"),console.log("");const s=m();for(const e of s){const n=e.detected?e.configured?o.success("\u25CF connected"):o.yellow("\u25D0 available"):o.dim("\u25CB not found"),l=e.version?` ${o.dim(`v${e.version}`)}`:"";console.log(`  ${e.icon} ${o.bold(e.name.padEnd(20))} ${o.cyan(e.id.padEnd(18))} ${n}${l}`),console.log(`    ${o.dim(`Config: ${e.configPath}`)}`)}console.log("")}async function P(){const s=w(process.argv);switch(s.command){case"help":A();break;case"check":{console.log(i),console.log(""),console.log(y());break}case"list":C();break;case"auto":{console.log(I),a("Auto-Configure"),console.log("");const e=s.serverPath||b(),n=s.dbPath||v();console.log(`  ${r.sword} Server: ${o.cyan(e)}`),console.log(`  ${r.treasure} DB:     ${o.cyan(n)}`),console.log(""),console.log(`  ${o.dim("Scanning for AI clients...")}`);const l=u({serverPath:e,dbPath:n});g(l);break}case"only":{(!s.clientIds||s.clientIds.length===0)&&(f("No client IDs specified. Use: wyrm-setup only vscode-copilot,cursor"),process.exit(1)),console.log(i),a(`Configure: ${s.clientIds.join(", ")}`);const e=p(s.clientIds,{serverPath:s.serverPath,dbPath:s.dbPath});g(e);break}case"remove":{console.log(i),a("Remove Wyrm from AI Clients"),console.log(""),console.log(`  ${o.warning("Removing Wyrm configuration from all AI clients...")}`);const e=$(),n=e.filter(t=>t.action==="configured"),l=e.filter(t=>t.action==="skipped");for(const t of n)console.log(`  ${r.check} ${t.client.icon} ${t.client.name} \u2014 removed`),t.backup&&console.log(`    ${o.dim(`backup \u2192 ${t.backup}`)}`);for(const t of l)console.log(`  ${o.dim(`  \u25CB ${t.client.icon} ${t.client.name} \u2014 ${t.message}`)}`);console.log(""),n.length>0&&console.log(`  ${o.success(`Removed from ${n.length} client(s). Run wyrm-setup to reconnect.`)}`),console.log("");break}case"reconf":{console.log(i),a("Re-Configure");const e=k();console.log(e?`  ${o.dim(`Restoring config for: ${e.configuredClients.join(", ")}`)}`:`  ${o.dim("No previous config found \u2014 running full auto-configure")}`);const n=h();g(n);break}}}P().catch(s=>{f(`Setup failed: ${s}`),process.exit(1)});
+/**
+ * Wyrm Setup CLI - Auto-configure Wyrm for any AI client
+ *
+ * Usage:
+ *   wyrm-setup              Auto-detect and configure all AI clients
+ *   wyrm-setup --check      Show current configuration status
+ *   wyrm-setup --remove     Remove Wyrm from all AI clients
+ *   wyrm-setup --only X,Y   Configure specific clients only
+ *   wyrm-setup --server P   Override server path
+ *   wyrm-setup --db P       Override database path
+ *   wyrm-setup --reconf     Re-configure previously configured clients
+ *   wyrm-setup --list       List all supported AI clients
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd.
+ * @license Proprietary — (c) 2026 Ghost Protocol (Pvt) Ltd. All rights reserved. See LICENSE.
+ * @module setup
+ * @version 3.0.0
+ */
+import { detectClients, autoConfigureAll, removeFromAll, configureSpecific, reconfAll, getStatusSummary, findWyrmServerPath, getDefaultDbPath, loadWyrmMeta, } from './autoconfig.js';
+import { c, icons, BANNER, MINI_BANNER, printError, printSection } from './cli.js';
+function parseArgs(argv) {
+    const args = argv.slice(2); // Skip node and script path
+    if (args.length === 0) {
+        return { command: 'auto' };
+    }
+    const result = { command: 'auto' };
+    for (let i = 0; i < args.length; i++) {
+        switch (args[i]) {
+            case '--check':
+            case '-c':
+            case 'check':
+            case 'status':
+                result.command = 'check';
+                break;
+            case '--remove':
+            case '-r':
+            case 'remove':
+            case 'uninstall':
+                result.command = 'remove';
+                break;
+            case '--only':
+            case '-o':
+            case 'only':
+                result.command = 'only';
+                if (args[i + 1]) {
+                    result.clientIds = args[i + 1].split(',').map(s => s.trim());
+                    i++;
+                }
+                break;
+            case '--reconf':
+            case '--reconfigure':
+            case 'reconf':
+                result.command = 'reconf';
+                break;
+            case '--list':
+            case '-l':
+            case 'list':
+                result.command = 'list';
+                break;
+            case '--server':
+            case '-s':
+                if (args[i + 1]) {
+                    result.serverPath = args[i + 1];
+                    i++;
+                }
+                break;
+            case '--db':
+            case '-d':
+                if (args[i + 1]) {
+                    result.dbPath = args[i + 1];
+                    i++;
+                }
+                break;
+            case '--help':
+            case '-h':
+            case 'help':
+                result.command = 'help';
+                break;
+        }
+    }
+    return result;
+}
+// ==================== OUTPUT ====================
+function printResults(results) {
+    console.log('');
+    const configured = results.filter(r => r.action === 'configured');
+    const updated = results.filter(r => r.action === 'updated');
+    const skipped = results.filter(r => r.action === 'skipped');
+    const failed = results.filter(r => r.action === 'failed');
+    for (const r of configured) {
+        console.log(`  ${icons.success} ${r.client.icon} ${c.green(r.client.name)} — ${c.success('configured')}`);
+        if (r.backup)
+            console.log(`    ${c.dim(`backup → ${r.backup}`)}`);
+    }
+    for (const r of updated) {
+        console.log(`  ${icons.sync} ${r.client.icon} ${c.blue(r.client.name)} — ${c.cyan('updated')}`);
+        if (r.backup)
+            console.log(`    ${c.dim(`backup → ${r.backup}`)}`);
+    }
+    for (const r of skipped) {
+        console.log(`  ${c.dim(`  ○ ${r.client.icon} ${r.client.name} — ${r.message}`)}`);
+    }
+    for (const r of failed) {
+        console.log(`  ${icons.error} ${r.client.icon} ${c.red(r.client.name)} — ${c.error(r.message)}`);
+    }
+    console.log('');
+    const successCount = configured.length + updated.length;
+    if (successCount > 0) {
+        console.log(`  ${c.success(`${icons.dragon} Wyrm connected to ${successCount} AI client(s)`)}`);
+        console.log(`  ${c.dim('Switch AIs anytime — run wyrm-setup again to reconnect')}`);
+    }
+    else if (failed.length > 0) {
+        console.log(`  ${c.error('Some configurations failed. Check errors above.')}`);
+    }
+    else {
+        console.log(`  ${c.dim('No AI clients detected. Install one and try again.')}`);
+    }
+    console.log('');
+}
+function printHelp() {
+    console.log(MINI_BANNER);
+    console.log('');
+    console.log(`${c.bold('Usage:')} wyrm-setup ${c.dim('[command] [options]')}`);
+    console.log('');
+    console.log(`${c.bold('Commands:')}`);
+    console.log(`  ${c.cyan('(no args)')}      Auto-detect and configure all AI clients`);
+    console.log(`  ${c.cyan('check')}          Show current configuration status`);
+    console.log(`  ${c.cyan('list')}           List all supported AI clients`);
+    console.log(`  ${c.cyan('remove')}         Remove Wyrm from all AI clients`);
+    console.log(`  ${c.cyan('reconf')}         Re-configure previously configured clients`);
+    console.log(`  ${c.cyan('only X,Y')}       Configure specific clients only`);
+    console.log(`  ${c.cyan('help')}           Show this help message`);
+    console.log('');
+    console.log(`${c.bold('Options:')}`);
+    console.log(`  ${c.cyan('--server P')}     Override Wyrm MCP server path`);
+    console.log(`  ${c.cyan('--db P')}         Override Wyrm database path`);
+    console.log('');
+    console.log(`${c.bold('Client IDs:')}`);
+    const clients = detectClients();
+    for (const cl of clients) {
+        console.log(`  ${cl.icon} ${c.cyan(cl.id.padEnd(18))} ${cl.name}`);
+    }
+    console.log('');
+    console.log(`${c.bold('Examples:')}`);
+    console.log(`  wyrm-setup                                   ${c.dim('# Auto-configure everything')}`);
+    console.log(`  wyrm-setup check                             ${c.dim('# See what\'s configured')}`);
+    console.log(`  wyrm-setup only vscode-copilot,cursor         ${c.dim('# Only VS Code + Cursor')}`);
+    console.log(`  wyrm-setup --server /path/to/wyrm/dist/index.js  ${c.dim('# Custom server path')}`);
+    console.log(`  wyrm-setup remove                            ${c.dim('# Remove from all clients')}`);
+    console.log('');
+}
+function printClientList() {
+    console.log(MINI_BANNER);
+    console.log('');
+    printSection('Supported AI Clients');
+    console.log('');
+    const clients = detectClients();
+    for (const cl of clients) {
+        const status = cl.detected
+            ? cl.configured
+                ? c.success('● connected')
+                : c.yellow('◐ available')
+            : c.dim('○ not found');
+        const versionStr = cl.version ? ` ${c.dim(`v${cl.version}`)}` : '';
+        console.log(`  ${cl.icon} ${c.bold(cl.name.padEnd(20))} ${c.cyan(cl.id.padEnd(18))} ${status}${versionStr}`);
+        console.log(`    ${c.dim(`Config: ${cl.configPath}`)}`);
+    }
+    console.log('');
+}
+// ==================== MAIN ====================
+async function main() {
+    const args = parseArgs(process.argv);
+    switch (args.command) {
+        case 'help':
+            printHelp();
+            break;
+        case 'check': {
+            console.log(MINI_BANNER);
+            console.log('');
+            console.log(getStatusSummary());
+            break;
+        }
+        case 'list':
+            printClientList();
+            break;
+        case 'auto': {
+            console.log(BANNER);
+            printSection('Auto-Configure');
+            console.log('');
+            const serverPath = args.serverPath || findWyrmServerPath();
+            const dbPath = args.dbPath || getDefaultDbPath();
+            console.log(`  ${icons.sword} Server: ${c.cyan(serverPath)}`);
+            console.log(`  ${icons.treasure} DB:     ${c.cyan(dbPath)}`);
+            console.log('');
+            console.log(`  ${c.dim('Scanning for AI clients...')}`);
+            const results = autoConfigureAll({
+                serverPath,
+                dbPath,
+            });
+            printResults(results);
+            break;
+        }
+        case 'only': {
+            if (!args.clientIds || args.clientIds.length === 0) {
+                printError('No client IDs specified. Use: wyrm-setup only vscode-copilot,cursor');
+                process.exit(1);
+            }
+            console.log(MINI_BANNER);
+            printSection(`Configure: ${args.clientIds.join(', ')}`);
+            const results = configureSpecific(args.clientIds, {
+                serverPath: args.serverPath,
+                dbPath: args.dbPath,
+            });
+            printResults(results);
+            break;
+        }
+        case 'remove': {
+            console.log(MINI_BANNER);
+            printSection('Remove Wyrm from AI Clients');
+            console.log('');
+            console.log(`  ${c.warning('Removing Wyrm configuration from all AI clients...')}`);
+            const results = removeFromAll();
+            const removed = results.filter(r => r.action === 'configured');
+            const skipped = results.filter(r => r.action === 'skipped');
+            for (const r of removed) {
+                console.log(`  ${icons.check} ${r.client.icon} ${r.client.name} — removed`);
+                if (r.backup)
+                    console.log(`    ${c.dim(`backup → ${r.backup}`)}`);
+            }
+            for (const r of skipped) {
+                console.log(`  ${c.dim(`  ○ ${r.client.icon} ${r.client.name} — ${r.message}`)}`);
+            }
+            console.log('');
+            if (removed.length > 0) {
+                console.log(`  ${c.success(`Removed from ${removed.length} client(s). Run wyrm-setup to reconnect.`)}`);
+            }
+            console.log('');
+            break;
+        }
+        case 'reconf': {
+            console.log(MINI_BANNER);
+            printSection('Re-Configure');
+            const meta = loadWyrmMeta();
+            if (meta) {
+                console.log(`  ${c.dim(`Restoring config for: ${meta.configuredClients.join(', ')}`)}`);
+            }
+            else {
+                console.log(`  ${c.dim('No previous config found — running full auto-configure')}`);
+            }
+            const results = reconfAll();
+            printResults(results);
+            break;
+        }
+    }
+}
+main().catch((err) => {
+    printError(`Setup failed: ${err}`);
+    process.exit(1);
+});
+//# sourceMappingURL=setup.js.map

package/dist/skill-author.js

@@ -1,5 +1,168 @@
-import{existsSync as a,mkdirSync as m,writeFileSync as g,readFileSync as d,rmSync as h,statSync as y}from"fs";import{join as s}from"path";import{homedir as p}from"os";import{createHash as S}from"crypto";function u(){return process.env.WYRM_SKILLS_DIR||s(p(),".copilot","skills")}function l(t){return String(t).trim().toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"").slice(0,48)}const k=6;function C(t){const n=[],e=[],r=l(t.name);(!r||!/^[a-z0-9][a-z0-9-]{1,48}$/.test(r))&&n.push(`name must slugify to kebab-case [a-z0-9-] (got "${t.name}" \u2192 "${r}")`);const o=(t.description||"").trim();o.length<12&&n.push("description too short (< 12 chars) \u2014 needed for discovery/recall"),o.length>280&&n.push("description too long (> 280 chars) \u2014 keep it a one-liner for ranking");const i=(t.body||"").trim();i?/^#{1,2}\s+\S/m.test(i)||e.push("body has no markdown heading \u2014 add a clear title"):n.push("body is empty");const f=(i.match(/^##\s+\S/gm)||[]).length;return f>k&&e.push(`body has ${f} top-level sections \u2014 may not be atomic; consider splitting into smaller skills`),i.length>12e3&&e.push(`body is ${i.length} chars \u2014 atomic skills are usually focused; consider trimming or splitting`),{ok:n.length===0,errors:n,warnings:e,slug:r}}function $(t){const e=["---",`name: ${l(t.name)}`,`description: ${c(t.description.trim())}`];return t.argumentHint&&e.push(`argument-hint: ${c(t.argumentHint)}`),t.userInvocable!==void 0&&e.push(`user-invocable: ${t.userInvocable?"true":"false"}`),t.category&&e.push(`category: ${c(t.category)}`),t.tags&&t.tags.length&&e.push(`tags: [${t.tags.map(r=>c(r)).join(", ")}]`),e.push("---"),`${e.join(`
-`)}
-
-${t.body.trim()}
-`}function c(t){const n=String(t);return/^[\w][\w .,/()&'+-]*$/.test(n)&&!/^(true|false|null|yes|no|on|off)$/i.test(n)?n:JSON.stringify(n)}function D(t,n={}){const e=l(t.name);if(!e)throw new Error(`skill name "${t.name}" does not produce a valid slug`);const r=s(n.skillsDir??u(),e),o=s(r,"SKILL.md"),i=a(o);if(i&&!n.force)throw new Error(`skill "${e}" already exists at ${o} (pass force to overwrite)`);return m(r,{recursive:!0}),g(o,$(t),"utf-8"),{slug:e,path:o,action:i?"overwritten":"created"}}function K(t,n={}){const e=l(t);if(!e)return{slug:"",removed:!1};const r=s(n.skillsDir??u(),e);return a(s(r,"SKILL.md"))?(h(r,{recursive:!0,force:!0}),{slug:e,removed:!0}):{slug:e,removed:!1}}function _(t,n={}){const e=s(n.skillsDir??u(),l(t),"SKILL.md");return a(e)?d(e,"utf-8"):null}function v(t){return S("sha256").update(t,"utf-8").digest("hex")}function z(t){const n=[];if(t.skillPath&&n.push(t.skillPath),t.name){const e=l(t.name);e&&n.push(s(t.skillsDir??u(),e,"SKILL.md"))}for(const e of n)try{if(e&&a(e)&&b(e)){const r=d(e,"utf-8");return{content:r,sha256:v(r)}}}catch{}return null}function b(t){try{return y(t).isFile()}catch{return!1}}export{$ as buildSkillMarkdown,D as deploySkill,u as getSkillsDir,_ as readSkill,z as readSkillContent,K as removeSkill,v as skillContentSha,l as slugify,C as validateAtomicSkill};
+/**
+ * Wyrm Skill Author — clean authoring + deploy pipeline for ATOMIC skills.
+ *
+ * Wyrm is a memory layer, not an LLM — so the *intelligence* (writing focused,
+ * correct skill content) comes from the calling agent. Wyrm's job is to make
+ * that deploy CLEAN and ATOMIC: it validates the skill against atomic best
+ * practices (one focused capability, discoverable description, proper
+ * frontmatter), writes a well-formed `<slug>/SKILL.md`, and registers it so it's
+ * immediately discoverable via `wyrm_skill_search`. Idempotent + reversible.
+ *
+ * "Atomic" = one skill, one responsibility. The validator nudges authors away
+ * from kitchen-sink mega-skills toward small composable ones.
+ *
+ * @copyright 2026 Ghost Protocol (Pvt) Ltd.
+ * @license Proprietary — (c) 2026 Ghost Protocol (Pvt) Ltd. All rights reserved. See LICENSE.
+ */
+import { existsSync, mkdirSync, writeFileSync, readFileSync, rmSync, statSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { createHash } from 'crypto';
+/** Where skills live. Overridable for tests / non-default layouts. */
+export function getSkillsDir() {
+    return process.env.WYRM_SKILLS_DIR || join(homedir(), '.copilot', 'skills');
+}
+/** Normalize a free-form name to a kebab-case skill slug. */
+export function slugify(name) {
+    return String(name)
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 48);
+}
+const MAX_ATOMIC_SECTIONS = 6; // > this many top-level "## " sections smells non-atomic
+/**
+ * Validate a skill against atomic best practices. Errors block deploy; warnings
+ * are advisory (e.g. "this looks like more than one skill — consider splitting").
+ */
+export function validateAtomicSkill(spec) {
+    const errors = [];
+    const warnings = [];
+    const slug = slugify(spec.name);
+    if (!slug || !/^[a-z0-9][a-z0-9-]{1,48}$/.test(slug)) {
+        errors.push(`name must slugify to kebab-case [a-z0-9-] (got "${spec.name}" → "${slug}")`);
+    }
+    const desc = (spec.description || '').trim();
+    if (desc.length < 12)
+        errors.push('description too short (< 12 chars) — needed for discovery/recall');
+    if (desc.length > 280)
+        errors.push('description too long (> 280 chars) — keep it a one-liner for ranking');
+    const body = (spec.body || '').trim();
+    if (!body)
+        errors.push('body is empty');
+    else if (!/^#{1,2}\s+\S/m.test(body))
+        warnings.push('body has no markdown heading — add a clear title');
+    const sectionCount = (body.match(/^##\s+\S/gm) || []).length;
+    if (sectionCount > MAX_ATOMIC_SECTIONS) {
+        warnings.push(`body has ${sectionCount} top-level sections — may not be atomic; consider splitting into smaller skills`);
+    }
+    if (body.length > 12_000) {
+        warnings.push(`body is ${body.length} chars — atomic skills are usually focused; consider trimming or splitting`);
+    }
+    return { ok: errors.length === 0, errors, warnings, slug };
+}
+/** Build a well-formed SKILL.md (YAML frontmatter + body) from a spec. */
+export function buildSkillMarkdown(spec) {
+    const slug = slugify(spec.name);
+    const fm = ['---', `name: ${slug}`, `description: ${escapeYaml(spec.description.trim())}`];
+    if (spec.argumentHint)
+        fm.push(`argument-hint: ${escapeYaml(spec.argumentHint)}`);
+    if (spec.userInvocable !== undefined)
+        fm.push(`user-invocable: ${spec.userInvocable ? 'true' : 'false'}`);
+    if (spec.category)
+        fm.push(`category: ${escapeYaml(spec.category)}`);
+    if (spec.tags && spec.tags.length)
+        fm.push(`tags: [${spec.tags.map(t => escapeYaml(t)).join(', ')}]`);
+    fm.push('---');
+    return `${fm.join('\n')}\n\n${spec.body.trim()}\n`;
+}
+/** Quote a YAML scalar only when it could otherwise be mis-parsed. */
+function escapeYaml(v) {
+    const s = String(v);
+    return /^[\w][\w .,/()&'+-]*$/.test(s) && !/^(true|false|null|yes|no|on|off)$/i.test(s) ? s : JSON.stringify(s);
+}
+/**
+ * Write `<skillsDir>/<slug>/SKILL.md`. Refuses to clobber an existing skill
+ * unless `force` is set (so a deploy can't silently destroy a hand-edited skill).
+ */
+export function deploySkill(spec, opts = {}) {
+    const slug = slugify(spec.name);
+    // Guard: an empty slug would resolve to the skills ROOT — never write/operate there.
+    if (!slug)
+        throw new Error(`skill name "${spec.name}" does not produce a valid slug`);
+    const dir = join(opts.skillsDir ?? getSkillsDir(), slug);
+    const file = join(dir, 'SKILL.md');
+    const existed = existsSync(file);
+    if (existed && !opts.force) {
+        throw new Error(`skill "${slug}" already exists at ${file} (pass force to overwrite)`);
+    }
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(file, buildSkillMarkdown(spec), 'utf-8');
+    return { slug, path: file, action: existed ? 'overwritten' : 'created' };
+}
+/** Remove a deployed skill's directory. Reversible counterpart to deploySkill. */
+export function removeSkill(name, opts = {}) {
+    const slug = slugify(name);
+    // Guard: an empty slug → join(skillsDir, '') === the skills ROOT. rmSync there
+    // would wipe EVERY skill. Refuse outright.
+    if (!slug)
+        return { slug: '', removed: false };
+    const dir = join(opts.skillsDir ?? getSkillsDir(), slug);
+    if (!existsSync(join(dir, 'SKILL.md')))
+        return { slug, removed: false };
+    rmSync(dir, { recursive: true, force: true });
+    return { slug, removed: true };
+}
+/** Read back a deployed skill's raw markdown (for verification). */
+export function readSkill(name, opts = {}) {
+    const file = join(opts.skillsDir ?? getSkillsDir(), slugify(name), 'SKILL.md');
+    return existsSync(file) ? readFileSync(file, 'utf-8') : null;
+}
+/** Hex sha256 of a skill body — the idempotency/dedup key for content sync. */
+export function skillContentSha(content) {
+    return createHash('sha256').update(content, 'utf-8').digest('hex');
+}
+/**
+ * Read a skill's SKILL.md body for registry storage (migration 25).
+ *
+ * Resolution order:
+ *   1. an explicit `skill_path` (the column the registry already stores) when
+ *      it points at a readable file;
+ *   2. fallback `<skillsDir>/<slug>/SKILL.md`.
+ *
+ * Returns NULL on any unreadable/missing file — callers must NEVER fail a
+ * registration or a backfill because the file is gone (the row stays content-
+ * NULL and the operator can re-backfill later). All filesystem errors are
+ * swallowed; this is a best-effort read.
+ */
+export function readSkillContent(opts) {
+    const candidates = [];
+    if (opts.skillPath)
+        candidates.push(opts.skillPath);
+    if (opts.name) {
+        const slug = slugify(opts.name);
+        if (slug)
+            candidates.push(join(opts.skillsDir ?? getSkillsDir(), slug, 'SKILL.md'));
+    }
+    for (const file of candidates) {
+        try {
+            if (file && existsSync(file) && statIsFile(file)) {
+                const content = readFileSync(file, 'utf-8');
+                return { content, sha256: skillContentSha(content) };
+            }
+        }
+        catch { /* best-effort: try the next candidate */ }
+    }
+    return null;
+}
+/** True when `path` exists and is a regular file (not a dir). */
+function statIsFile(path) {
+    try {
+        return statSync(path).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=skill-author.js.map