@aivorynet/slaide 1.0.0

package/dist/install/detect.js

@@ -0,0 +1,82 @@
+// Copyright 2026 AIVory, Inc.
+// SPDX-License-Identifier: Apache-2.0
+// Detect which AI coding CLIs are installed on this machine. Mirrors the proven approach
+// from the sibling agent-manager: per CLI a set of candidate binary names; resolve each on
+// PATH (where.exe + PowerShell on Windows, `command -v` + common dirs on Unix); validate by
+// running `<bin> --version`. No third-party deps, just node:child_process.
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const isWin = process.platform === 'win32';
+/** Resolve an executable name on the Windows PATH (where.exe, then PowerShell Get-Command). */
+function findWindows(name) {
+    const where = spawnSync('where.exe', [name], { encoding: 'utf8', timeout: 5000, windowsHide: true });
+    if (where.status === 0 && where.stdout.trim()) {
+        const lines = where.stdout
+            .split(/\r?\n/)
+            .map((l) => l.trim())
+            .filter(Boolean);
+        return lines.find((l) => /\.(cmd|exe)$/i.test(l)) ?? lines[0];
+    }
+    const ps = spawnSync('powershell', ['-NoProfile', '-NonInteractive', '-Command', `(Get-Command '${name}' -ErrorAction SilentlyContinue).Source`], { encoding: 'utf8', timeout: 6000, windowsHide: true });
+    const out = (ps.stdout || '').trim();
+    return ps.status === 0 && out ? out.split(/\r?\n/)[0].trim() : null;
+}
+const UNIX_DIRS = ['/opt/homebrew/bin', '/usr/local/bin', '/usr/bin', '/bin'];
+/** Resolve an executable name on the Unix PATH (login shell `command -v`, then common dirs). */
+function findUnix(name) {
+    const sh = spawnSync('sh', ['-lc', `command -v ${name}`], { encoding: 'utf8', timeout: 5000 });
+    const out = (sh.stdout || '').trim();
+    if (sh.status === 0 && out)
+        return out.split(/\r?\n/)[0].trim();
+    const home = homedir();
+    const dirs = [...UNIX_DIRS, join(home, '.local/bin'), join(home, '.npm-global/bin'), join(home, '.bun/bin')];
+    for (const d of dirs) {
+        const p = join(d, name);
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+function findOnPath(name) {
+    return isWin ? findWindows(name) : findUnix(name);
+}
+/** Run `<bin> --version` and return the first non-empty output line, or null if it fails. */
+function probeVersion(bin, flag, timeoutMs) {
+    // .cmd shims on Windows must be run through cmd; on Unix spawn the binary directly.
+    const r = isWin
+        ? spawnSync('cmd', ['/c', bin, flag], { encoding: 'utf8', timeout: timeoutMs, windowsHide: true })
+        : spawnSync(bin, [flag], { encoding: 'utf8', timeout: timeoutMs });
+    const out = `${r.stdout || ''}\n${r.stderr || ''}`;
+    const line = out
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .find(Boolean);
+    if (r.status === 0 || line)
+        return line ?? '';
+    return null;
+}
+/** Detect a single CLI: resolve any of its binaries on PATH and validate with --version. */
+export function detectOne(spec, timeoutMs = 10000) {
+    for (const name of spec.binaries) {
+        const bin = findOnPath(name);
+        if (!bin)
+            continue;
+        const version = probeVersion(bin, spec.versionFlag, timeoutMs);
+        if (version != null)
+            return { id: spec.id, displayName: spec.displayName, bin, version };
+    }
+    return null;
+}
+/** Detect every CLI in the list; returns only the installed ones, in spec order. */
+export function detectClis(specs, timeoutMs = 10000) {
+    const found = [];
+    for (const spec of specs) {
+        const d = detectOne(spec, timeoutMs);
+        if (d)
+            found.push(d);
+    }
+    return found;
+}
+//# sourceMappingURL=detect.js.map

package/dist/install/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/install/detect.ts"],"names":[],"mappings":"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"}

package/dist/install/index.d.ts

@@ -0,0 +1,20 @@
+import { type DetectedCli } from './detect.js';
+import { type Scope } from './registry.js';
+export interface InstallOptions {
+    cli?: string[];
+    scope: Scope;
+    projectDir: string;
+    skills: boolean | undefined;
+    mcp: boolean | undefined;
+    yes: boolean;
+    list: boolean;
+    dryRun: boolean;
+    json: boolean;
+}
+/** Map --scope (project|global|<dir>) onto a scope + install root. */
+export declare function parseScopeArg(value: string | undefined, cwd: string): {
+    scope: Scope;
+    projectDir: string;
+};
+export declare function listDetected(): DetectedCli[];
+export declare function runInstall(opts: InstallOptions): Promise<number>;

package/dist/install/index.js

@@ -0,0 +1,126 @@
+// Copyright 2026 AIVory, Inc.
+// SPDX-License-Identifier: Apache-2.0
+// `slaide install`: detect the AI coding CLIs on this machine, let the user pick, copy the
+// slaide authoring skill into each, and (opt-out) register the slaide MCP server. Interactive
+// when run in a terminal; fully flag-driven (--cli/--scope/--skills/--mcp/--yes/--list/--json)
+// for scripts and CI. No third-party deps: prompts use node:readline/promises.
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+import { detectClis } from './detect.js';
+import { ADAPTERS, allSpecs, getAdapter } from './registry.js';
+import { skillSourceDir, readSkillName } from './skills.js';
+/** Map --scope (project|global|<dir>) onto a scope + install root. */
+export function parseScopeArg(value, cwd) {
+    if (!value || value === 'project')
+        return { scope: 'project', projectDir: cwd };
+    if (value === 'global')
+        return { scope: 'global', projectDir: cwd };
+    return { scope: 'project', projectDir: resolve(value) }; // a path -> project install into it
+}
+export function listDetected() {
+    return detectClis(allSpecs());
+}
+function isInteractive(opts) {
+    return !!process.stdin.isTTY && !opts.yes;
+}
+async function ask(question) {
+    const { createInterface } = await import('node:readline/promises');
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        return (await rl.question(question)).trim();
+    }
+    finally {
+        rl.close();
+    }
+}
+async function promptSelect(detected) {
+    console.log('Detected AI coding CLIs:');
+    detected.forEach((d, i) => console.log(`  ${i + 1}) ${d.displayName}  (${d.version.split(/\s/)[0]})`));
+    const ans = await ask('Install for which? (comma-separated numbers, or "all"): ');
+    if (!ans || /^all$/i.test(ans))
+        return detected;
+    const picks = ans
+        .split(',')
+        .map((s) => parseInt(s.trim(), 10))
+        .filter((n) => n >= 1 && n <= detected.length)
+        .map((n) => detected[n - 1]);
+    return picks.length ? picks : detected;
+}
+async function promptYesNo(question, def) {
+    const ans = await ask(`${question} ${def ? '[Y/n]' : '[y/N]'} `);
+    if (!ans)
+        return def;
+    return /^y/i.test(ans);
+}
+/** Resolve which adapters to act on, from --cli or an interactive pick. */
+async function chooseClis(opts, detected) {
+    if (opts.cli && opts.cli.length) {
+        return opts.cli.map((id) => {
+            const adapter = getAdapter(id);
+            if (!adapter)
+                throw new Error(`unknown CLI "${id}". Known: ${ADAPTERS.map((a) => a.id).join(', ')}`);
+            return { adapter, detected: detected.find((d) => d.id === id) ?? null };
+        });
+    }
+    if (!detected.length)
+        throw new Error('no supported AI coding CLIs detected. Pass --cli <id> to install anyway.');
+    const picks = isInteractive(opts) ? await promptSelect(detected) : detected;
+    return picks.map((d) => ({ adapter: getAdapter(d.id), detected: d }));
+}
+export async function runInstall(opts) {
+    // Detection probes every CLI with `--version` (slow). Skip it when the CLIs are named
+    // explicitly and MCP registration is off, since a skill copy needs no detection.
+    const needDetect = opts.list || !(opts.cli && opts.cli.length) || opts.mcp !== false;
+    const detected = needDetect ? listDetected() : [];
+    if (opts.list) {
+        console.log(JSON.stringify(detected, null, 2));
+        return 0;
+    }
+    let chosen;
+    try {
+        chosen = await chooseClis(opts, detected);
+    }
+    catch (e) {
+        console.error('error: ' + e.message);
+        return 1;
+    }
+    // Decide skill + MCP once for the whole run.
+    let doSkills = opts.skills;
+    if (doSkills === undefined)
+        doSkills = isInteractive(opts) ? await promptYesNo('Install the slaide authoring skill?', true) : true;
+    let doMcp = opts.mcp;
+    if (doMcp === undefined)
+        doMcp = isInteractive(opts) ? await promptYesNo('Register the slaide MCP server?', true) : true;
+    const skillSrcDir = skillSourceDir();
+    const skillName = readSkillName(skillSrcDir);
+    const homeDir = homedir();
+    const summary = [];
+    for (const { adapter, detected: det } of chosen) {
+        const ctx = { scope: opts.scope, projectDir: opts.projectDir, homeDir, skillName, skillSrcDir, dryRun: opts.dryRun };
+        const row = { cli: adapter.id, displayName: adapter.displayName, detected: needDetect ? !!det : null };
+        if (doSkills) {
+            const r = adapter.installSkill(ctx);
+            row.skill = { dest: r.dest, files: r.files, notes: r.notes };
+        }
+        if (doMcp) {
+            const r = adapter.registerMcp(ctx, det);
+            row.mcp = { registered: r.registered, method: r.method, detail: r.detail };
+        }
+        summary.push(row);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(summary, null, 2));
+    }
+    else {
+        for (const row of summary) {
+            const tag = opts.dryRun ? '[dry-run] ' : '';
+            console.log(`${tag}${row.displayName}${row.detected === false ? ' (not detected)' : ''}`);
+            if (row.skill)
+                console.log(`  skill -> ${row.skill.dest} (${row.skill.files} files)${row.skill.notes.length ? '; ' + row.skill.notes.join('; ') : ''}`);
+            if (row.mcp)
+                console.log(`  mcp   -> ${row.mcp.registered ? 'registered (' + row.mcp.method + ')' : 'skipped: ' + row.mcp.detail}`);
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=index.js.map

package/dist/install/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/install/index.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,sCAAsC;AACtC,2FAA2F;AAC3F,8FAA8F;AAC9F,+FAA+F;AAC/F,+EAA+E;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAoD,MAAM,eAAe,CAAC;AACjH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAc5D,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,KAAyB,EAAE,GAAW;IAClE,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IAChF,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IACpE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,oCAAoC;AAC/F,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,aAAa,CAAC,IAAoB;IACzC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,GAAG,CAAC,QAAgB;IACjC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;IACnE,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAuB;IACjD,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,WAAW,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACvG,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,0DAA0D,CAAC,CAAC;IAClF,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChD,MAAM,KAAK,GAAG,GAAG;SACd,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;SAClC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC;SAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,GAAY;IACvD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;IACjE,IAAI,CAAC,GAAG;QAAE,OAAO,GAAG,CAAC;IACrB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAOD,2EAA2E;AAC3E,KAAK,UAAU,UAAU,CAAC,IAAoB,EAAE,QAAuB;IACrE,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACzB,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;YAC/B,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,EAAE,aAAa,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAClH,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC5E,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAoB;IACnD,sFAAsF;IACtF,iFAAiF;IACjF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC;IACrF,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAElD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,MAAgB,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,SAAS,GAAI,CAAW,CAAC,OAAO,CAAC,CAAC;QAChD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,6CAA6C;IAC7C,IAAI,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,QAAQ,KAAK,SAAS;QAAE,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,qCAAqC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnI,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC;IACrB,IAAI,KAAK,KAAK,SAAS;QAAE,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,iCAAiC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEzH,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;IAE1B,MAAM,OAAO,GAAU,EAAE,CAAC;IAC1B,KAAK,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,MAAM,EAAE,CAAC;QAChD,MAAM,GAAG,GAAmB,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QACrI,MAAM,GAAG,GAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5G,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YACpC,GAAG,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QAC/D,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACxC,GAAG,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7E,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1F,IAAI,GAAG,CAAC,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,UAAU,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxJ,IAAI,GAAG,CAAC,GAAG;gBAAE,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACtI,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/install/registry.d.ts

@@ -0,0 +1,33 @@
+import type { CliSpec, DetectedCli } from './detect.js';
+export type Scope = 'project' | 'global';
+export interface InstallContext {
+    scope: Scope;
+    projectDir: string;
+    homeDir: string;
+    skillName: string;
+    skillSrcDir: string;
+    dryRun: boolean;
+}
+export interface SkillInstallResult {
+    installed: boolean;
+    dest: string;
+    files: number;
+    notes: string[];
+}
+export interface McpRegisterResult {
+    registered: boolean;
+    method: 'cli' | 'file' | 'skipped';
+    detail: string;
+}
+export interface CliAdapter {
+    id: string;
+    displayName: string;
+    spec: CliSpec;
+    /** Where SKILL.md lands for this scope (a folder, or a file for rule-based CLIs). */
+    skillTarget(ctx: InstallContext): string;
+    installSkill(ctx: InstallContext): SkillInstallResult;
+    registerMcp(ctx: InstallContext, detected: DetectedCli | null): McpRegisterResult;
+}
+export declare const ADAPTERS: CliAdapter[];
+export declare function allSpecs(): CliSpec[];
+export declare function getAdapter(id: string): CliAdapter | undefined;

package/dist/install/registry.js

@@ -0,0 +1,169 @@
+// Copyright 2026 AIVory, Inc.
+// SPDX-License-Identifier: Apache-2.0
+// One adapter per supported AI coding CLI: where its skill files live, how to drop them, and
+// how to register the slaide MCP server. New CLI = one entry here. MCP registration shells out
+// to the CLI's own `mcp add` so the CLI merges its own config (we never hand-edit and clobber).
+import { spawnSync } from 'node:child_process';
+import { join, relative } from 'node:path';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { copyDir, mergePointerFile } from './skills.js';
+const isWin = process.platform === 'win32';
+const SENTINEL = '<!-- slaide-skill -->';
+const MCP_ARGS = ['npx', '-y', '@aivorynet/slaide', 'mcp']; // the stdio MCP launcher, shared by all CLIs
+/** Run a CLI subcommand (e.g. `claude mcp add ...`), routing .cmd shims through cmd on Windows. */
+function runCli(bin, args, cwd) {
+    const r = isWin
+        ? spawnSync('cmd', ['/c', bin, ...args], { encoding: 'utf8', cwd, windowsHide: true, timeout: 20000 })
+        : spawnSync(bin, args, { encoding: 'utf8', cwd, timeout: 20000 });
+    const out = `${r.stdout || ''}${r.stderr || ''}`.trim();
+    return { ok: r.status === 0, out };
+}
+/** Copy the skill folder; the common case for skills-folder CLIs. */
+function copySkill(ctx, dest, notes = []) {
+    const r = copyDir(ctx.skillSrcDir, dest, ctx.dryRun);
+    return { installed: true, dest, files: r.files, notes };
+}
+/** Register via the CLI's own `mcp add`. cmdArgs is everything after the binary. */
+function mcpViaCli(detected, cmdArgs, ctx) {
+    if (!detected)
+        return { registered: false, method: 'skipped', detail: 'CLI not detected' };
+    if (ctx.dryRun)
+        return { registered: true, method: 'cli', detail: `${detected.bin} ${cmdArgs.join(' ')}` };
+    const cwd = ctx.scope === 'project' ? ctx.projectDir : undefined;
+    const r = runCli(detected.bin, cmdArgs, cwd);
+    return r.ok
+        ? { registered: true, method: 'cli', detail: 'mcp add' }
+        : { registered: false, method: 'cli', detail: r.out.split(/\r?\n/)[0] || 'mcp add failed' };
+}
+const claude = {
+    id: 'claude',
+    displayName: 'Claude Code',
+    spec: { id: 'claude', displayName: 'Claude Code', binaries: ['claude', 'claude.cmd', 'claude.exe'], versionFlag: '--version', installHint: 'npm i -g @anthropic-ai/claude-code' },
+    skillTarget(ctx) {
+        const base = ctx.scope === 'project' ? ctx.projectDir : ctx.homeDir;
+        return join(base, '.claude', 'skills', ctx.skillName);
+    },
+    installSkill(ctx) {
+        return copySkill(ctx, this.skillTarget(ctx));
+    },
+    registerMcp(ctx, detected) {
+        const scope = ctx.scope === 'project' ? 'project' : 'user';
+        return mcpViaCli(detected, ['mcp', 'add', ctx.skillName, '-s', scope, '--', ...MCP_ARGS], ctx);
+    },
+};
+const codex = {
+    id: 'codex',
+    displayName: 'Codex CLI',
+    spec: { id: 'codex', displayName: 'Codex CLI', binaries: ['codex', 'codex.cmd', 'codex.exe'], versionFlag: '--version', installHint: 'npm i -g @openai/codex' },
+    skillTarget(ctx) {
+        const base = ctx.scope === 'project' ? ctx.projectDir : ctx.homeDir;
+        return join(base, '.codex', 'skills', ctx.skillName);
+    },
+    installSkill(ctx) {
+        const dest = this.skillTarget(ctx);
+        const notes = [];
+        if (ctx.scope === 'project') {
+            const block = `slaide deck authoring. See .codex/skills/${ctx.skillName}/SKILL.md`;
+            if (mergePointerFile(join(ctx.projectDir, 'AGENTS.md'), block, SENTINEL, ctx.dryRun))
+                notes.push('AGENTS.md pointer added');
+        }
+        return copySkill(ctx, dest, notes);
+    },
+    registerMcp(ctx, detected) {
+        // codex stores MCP servers globally (~/.codex/config.toml); there is no per-project scope.
+        const r = mcpViaCli(detected, ['mcp', 'add', ctx.skillName, '--', ...MCP_ARGS], ctx);
+        if (r.registered && ctx.scope === 'project')
+            r.detail = 'mcp add (codex registers globally)';
+        return r;
+    },
+};
+const gemini = {
+    id: 'gemini',
+    displayName: 'Gemini CLI',
+    spec: { id: 'gemini', displayName: 'Gemini CLI', binaries: ['gemini', 'gemini.cmd', 'gemini.exe'], versionFlag: '--version', installHint: 'npm i -g @google/gemini-cli' },
+    skillTarget(ctx) {
+        const base = ctx.scope === 'project' ? ctx.projectDir : ctx.homeDir;
+        return join(base, '.gemini', 'skills', ctx.skillName);
+    },
+    installSkill(ctx) {
+        const dest = this.skillTarget(ctx);
+        const res = copySkill(ctx, dest);
+        // GEMINI.md imports context with @path; point it at the freshly copied SKILL.md.
+        const mdFile = ctx.scope === 'project' ? join(ctx.projectDir, 'GEMINI.md') : join(ctx.homeDir, '.gemini', 'GEMINI.md');
+        const importPath = './' + relative(join(mdFile, '..'), join(dest, 'SKILL.md')).split('\\').join('/');
+        const block = `slaide deck authoring. See @${importPath}`;
+        if (mergePointerFile(mdFile, block, SENTINEL, ctx.dryRun))
+            res.notes.push('GEMINI.md pointer added');
+        return res;
+    },
+    registerMcp(ctx, detected) {
+        const scope = ctx.scope === 'project' ? 'project' : 'user';
+        return mcpViaCli(detected, ['mcp', 'add', ctx.skillName, '-s', scope, '-t', 'stdio', ...MCP_ARGS], ctx);
+    },
+};
+// Cursor uses project rule files (.cursor/rules/*.mdc) and a JSON MCP config; no `mcp add` CLI.
+const cursor = {
+    id: 'cursor',
+    displayName: 'Cursor',
+    spec: { id: 'cursor', displayName: 'Cursor', binaries: ['cursor-agent', 'cursor-agent.cmd', 'agent', 'agent.exe'], versionFlag: '--version', installHint: 'https://cursor.com' },
+    skillTarget(ctx) {
+        return join(ctx.projectDir, '.cursor', 'rules', `${ctx.skillName}.mdc`);
+    },
+    installSkill(ctx) {
+        const dest = this.skillTarget(ctx);
+        const body = readFileSync(join(ctx.skillSrcDir, 'SKILL.md'), 'utf8').replace(/^---[\s\S]*?---\n/, '');
+        const mdc = `---\ndescription: Author and render slaide presentations\nglobs: ["**/*.slaide", "**/*.slaide.yaml", "**/*.slaidec"]\nalwaysApply: false\n---\n${body}`;
+        if (!ctx.dryRun) {
+            mkdirSync(join(dest, '..'), { recursive: true });
+            writeFileSync(dest, mdc, 'utf8');
+        }
+        return { installed: true, dest, files: 1, notes: [] };
+    },
+    registerMcp(ctx, detected) {
+        return mcpFileJson(join(ctx.scope === 'project' ? ctx.projectDir : ctx.homeDir, '.cursor', 'mcp.json'), ctx);
+    },
+};
+// Aider has no skills/MCP concept; it reads CONVENTIONS.md. Drop the skill and point at it.
+const aider = {
+    id: 'aider',
+    displayName: 'Aider',
+    spec: { id: 'aider', displayName: 'Aider', binaries: ['aider', 'aider.exe'], versionFlag: '--version', installHint: 'pip install aider-chat' },
+    skillTarget(ctx) {
+        return join(ctx.projectDir, '.aider', 'skills', ctx.skillName);
+    },
+    installSkill(ctx) {
+        const dest = this.skillTarget(ctx);
+        const res = copySkill(ctx, dest);
+        const block = `slaide deck authoring. See .aider/skills/${ctx.skillName}/SKILL.md`;
+        if (mergePointerFile(join(ctx.projectDir, 'CONVENTIONS.md'), block, SENTINEL, ctx.dryRun))
+            res.notes.push('CONVENTIONS.md pointer added');
+        return res;
+    },
+    registerMcp() {
+        return { registered: false, method: 'skipped', detail: 'aider has no MCP support' };
+    },
+};
+/** Merge an mcpServers entry into a JSON config (read-modify-write, preserving other keys). */
+function mcpFileJson(file, ctx) {
+    if (ctx.dryRun)
+        return { registered: true, method: 'file', detail: file };
+    try {
+        const obj = existsSync(file) ? JSON.parse(readFileSync(file, 'utf8') || '{}') : {};
+        obj.mcpServers = obj.mcpServers || {};
+        obj.mcpServers[ctx.skillName] = { command: 'npx', args: ['-y', '@aivorynet/slaide', 'mcp'] };
+        mkdirSync(join(file, '..'), { recursive: true });
+        writeFileSync(file, JSON.stringify(obj, null, 2), 'utf8');
+        return { registered: true, method: 'file', detail: file };
+    }
+    catch (e) {
+        return { registered: false, method: 'file', detail: e.message };
+    }
+}
+export const ADAPTERS = [claude, codex, gemini, cursor, aider];
+export function allSpecs() {
+    return ADAPTERS.map((a) => a.spec);
+}
+export function getAdapter(id) {
+    return ADAPTERS.find((a) => a.id === id);
+}
+//# sourceMappingURL=registry.js.map

package/dist/install/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/install/registry.ts"],"names":[],"mappings":"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"}

package/dist/install/skills.d.ts

@@ -0,0 +1,17 @@
+/** The `core/` package root, from src/install/ (tsx dev) or dist/install/ (published). */
+export declare function coreRoot(): string;
+/** Absolute path to the bundled skill folder; throws a clear error if it is missing. */
+export declare function skillSourceDir(name?: string): string;
+/** The skill's declared name (SKILL.md frontmatter `name:`), defaulting to the folder default. */
+export declare function readSkillName(srcDir: string): string;
+export interface CopyResult {
+    files: number;
+    dest: string;
+}
+/** Recursively copy a directory (overwriting). Counts files; dryRun reports without writing. */
+export declare function copyDir(srcDir: string, destDir: string, dryRun?: boolean): CopyResult;
+/**
+ * Append a block to a context file once, delimited by a sentinel so re-runs are idempotent and
+ * existing content is preserved. Returns true if it wrote (or would write, in dryRun).
+ */
+export declare function mergePointerFile(file: string, block: string, sentinel: string, dryRun?: boolean): boolean;

package/dist/install/skills.js

@@ -0,0 +1,72 @@
+// Copyright 2026 AIVory, Inc.
+// SPDX-License-Identifier: Apache-2.0
+// Locate the bundled slaide authoring skill and copy it into a target CLI's skills folder,
+// plus merge a small pointer block into context files (GEMINI.md / AGENTS.md / CONVENTIONS.md)
+// without clobbering what is already there.
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve, join } from 'node:path';
+import { existsSync, mkdirSync, readdirSync, copyFileSync, readFileSync, writeFileSync } from 'node:fs';
+/** The `core/` package root, from src/install/ (tsx dev) or dist/install/ (published). */
+export function coreRoot() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), '..', '..');
+}
+/** Absolute path to the bundled skill folder; throws a clear error if it is missing. */
+export function skillSourceDir(name = 'slaide') {
+    const dir = join(coreRoot(), 'skills', name);
+    if (!existsSync(join(dir, 'SKILL.md'))) {
+        throw new Error(`slaide skill source not found at ${dir}. In a checkout run the skill sync ` +
+            `(npx tsx scripts/dev/sync-skill.ts); in a published install ensure slaide shipped its "skills" folder.`);
+    }
+    return dir;
+}
+/** The skill's declared name (SKILL.md frontmatter `name:`), defaulting to the folder default. */
+export function readSkillName(srcDir) {
+    try {
+        const head = readFileSync(join(srcDir, 'SKILL.md'), 'utf8').slice(0, 600);
+        const m = head.match(/^name:\s*([A-Za-z0-9_-]+)/m);
+        if (m)
+            return m[1];
+    }
+    catch {
+        /* fall through to default */
+    }
+    return 'slaide';
+}
+/** Recursively copy a directory (overwriting). Counts files; dryRun reports without writing. */
+export function copyDir(srcDir, destDir, dryRun = false) {
+    let files = 0;
+    const walk = (src, dest) => {
+        if (!dryRun)
+            mkdirSync(dest, { recursive: true });
+        for (const ent of readdirSync(src, { withFileTypes: true })) {
+            const s = join(src, ent.name);
+            const d = join(dest, ent.name);
+            if (ent.isDirectory())
+                walk(s, d);
+            else {
+                if (!dryRun)
+                    copyFileSync(s, d);
+                files++;
+            }
+        }
+    };
+    walk(srcDir, destDir);
+    return { files, dest: destDir };
+}
+/**
+ * Append a block to a context file once, delimited by a sentinel so re-runs are idempotent and
+ * existing content is preserved. Returns true if it wrote (or would write, in dryRun).
+ */
+export function mergePointerFile(file, block, sentinel, dryRun = false) {
+    const existing = existsSync(file) ? readFileSync(file, 'utf8') : '';
+    if (existing.includes(sentinel))
+        return false; // already present
+    const sep = existing && !existing.endsWith('\n') ? '\n\n' : existing ? '\n' : '';
+    const next = existing + sep + sentinel + '\n' + block + '\n';
+    if (!dryRun) {
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, next, 'utf8');
+    }
+    return true;
+}
+//# sourceMappingURL=skills.js.map

package/dist/install/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/install/skills.ts"],"names":[],"mappings":"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"}

package/dist/master-io.d.ts

@@ -0,0 +1,7 @@
+import type { Master } from './types.js';
+/** Schema header prepended to every emitted master (drives YAML LSP autocompletion). */
+export declare const MASTER_SCHEMA_HEADER = "# yaml-language-server: $schema=https://getslaide.com/schema/v1.json\n";
+/** Serialize a Master to canonical `*.slaide.yaml` text (schema header + stable key order). */
+export declare function serializeMaster(master: Master): string;
+/** Parse `*.slaide.yaml` master text into a Master object (inverse of serializeMaster). */
+export declare function parseMaster(text: string): Master;

package/dist/master-io.js

@@ -0,0 +1,55 @@
+// Copyright 2026 AIVory, Inc.
+// SPDX-License-Identifier: Apache-2.0
+// Master (theme) YAML (de)serialization — the single read/write path for a *.slaide.yaml
+// master. `serializeMaster()` is the canonical writer (schema header + stable top-level key
+// order) used by BOTH the importer (core/src/import/emit.ts) and the editor's master
+// write-back; it is the inverse of `parseMaster()` / `loadMaster()`, so an in-place theme
+// edit round-trips losslessly (load → serialize → reload deep-equals the original).
+import yaml from 'js-yaml';
+/** Schema header prepended to every emitted master (drives YAML LSP autocompletion). */
+export const MASTER_SCHEMA_HEADER = '# yaml-language-server: $schema=https://getslaide.com/schema/v1.json\n';
+/** Canonical top-level key order — keeps emitted masters readable + diff-stable. Any key not
+ *  listed here is appended afterwards in its existing order, so nothing is ever dropped. */
+const KEY_ORDER = [
+    'schema',
+    'name',
+    'description',
+    'canvas',
+    'fonts',
+    'typeScale',
+    'colors',
+    'gradients',
+    'tokens',
+    'backgrounds',
+    'layouts',
+    'variants',
+    'transitions',
+    'animations',
+    'chrome',
+    'ui',
+];
+/** Reorder a master's top-level keys into the canonical order (deterministic output). */
+function orderKeys(master) {
+    const src = master;
+    const out = {};
+    for (const k of KEY_ORDER)
+        if (src[k] !== undefined)
+            out[k] = src[k];
+    for (const k of Object.keys(src))
+        if (!(k in out) && src[k] !== undefined)
+            out[k] = src[k];
+    return out;
+}
+/** Serialize a Master to canonical `*.slaide.yaml` text (schema header + stable key order). */
+export function serializeMaster(master) {
+    return MASTER_SCHEMA_HEADER + yaml.dump(orderKeys(master), { lineWidth: 200 });
+}
+/** Parse `*.slaide.yaml` master text into a Master object (inverse of serializeMaster). */
+export function parseMaster(text) {
+    const obj = yaml.load(text);
+    if (!obj || typeof obj !== 'object' || Array.isArray(obj)) {
+        throw new Error('Master YAML is not a valid mapping');
+    }
+    return obj;
+}
+//# sourceMappingURL=master-io.js.map

package/dist/master-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-io.js","sourceRoot":"","sources":["../src/master-io.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,sCAAsC;AACtC,yFAAyF;AACzF,4FAA4F;AAC5F,qFAAqF;AACrF,0FAA0F;AAC1F,oFAAoF;AACpF,OAAO,IAAI,MAAM,SAAS,CAAC;AAG3B,wFAAwF;AACxF,MAAM,CAAC,MAAM,oBAAoB,GAAG,wEAAwE,CAAC;AAE7G;4FAC4F;AAC5F,MAAM,SAAS,GAAsB;IACnC,QAAQ;IACR,MAAM;IACN,aAAa;IACb,QAAQ;IACR,OAAO;IACP,WAAW;IACX,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,aAAa;IACb,SAAS;IACT,UAAU;IACV,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,IAAI;CACL,CAAC;AAEF,yFAAyF;AACzF,SAAS,SAAS,CAAC,MAAc;IAC/B,MAAM,GAAG,GAAG,MAA4C,CAAC;IACzD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACrE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3F,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,oBAAoB,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,GAAa,CAAC;AACvB,CAAC"}