wyrm-mcp 7.2.1 → 7.2.2

package/dist/session-seen.js

@@ -1,59 +1,11 @@
-/**
- * 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 AGPL-3.0-or-later — dual-licensed; commercial terms: ghosts.lk@proton.me. 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(`
+class d{db;constructor(e){this.db=e}mark(e,t,s,n){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(sessionId, artifactId, kind, mode);
-    }
-    /** Bulk-mark inlined artifacts for a session. */
-    markBulk(sessionId, items) {
-        const stmt = this.db.prepare(`
+    `).run(e,t,s,n)}markBulk(e,t){const s=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
-    `);
-        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
+    `);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};

package/dist/setup.js

@@ -1,261 +1,2 @@
 #!/usr/bin/env node
-/**
- * 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 AGPL-3.0-or-later — dual-licensed; commercial terms: ghosts.lk@proton.me. 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
+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)});

package/dist/skill-author.js

@@ -1,168 +1,5 @@
-/**
- * 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 AGPL-3.0-or-later — dual-licensed; commercial terms: ghosts.lk@proton.me. 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
+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};