skills-console 0.4.0

package/dist/adapters/filesystem/skill-scanner.js

@@ -0,0 +1,157 @@
+import { createHash } from 'node:crypto';
+import { lstat, readFile, readdir, realpath, stat } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+import { parseSkillManifest } from './frontmatter.js';
+const SKIPPED_DIRECTORIES = new Set(['.git', 'node_modules', 'dist', 'vendor']);
+function stableId(...parts) {
+    return createHash('sha1').update(parts.join('\0')).digest('hex').slice(0, 16);
+}
+function diagnostic(input) {
+    return {
+        id: stableId(input.code, input.path ?? '', input.skillName ?? '', input.message),
+        ...input,
+    };
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function scanSkillRoot(root) {
+    const installations = [];
+    const diagnostics = [];
+    if (!root.exists || !root.readable) {
+        if (root.exists && !root.readable) {
+            diagnostics.push(diagnostic({
+                code: 'root-unreadable',
+                severity: 'error',
+                message: 'Skill root exists but is not readable.',
+                path: root.path,
+                skillName: undefined,
+            }));
+        }
+        return { installations, diagnostics };
+    }
+    async function visitDirectory(path, depth, ancestors) {
+        let resolvedPath;
+        try {
+            resolvedPath = await realpath(path);
+        }
+        catch {
+            diagnostics.push(diagnostic({
+                code: 'broken-symlink',
+                severity: 'error',
+                message: 'Unable to resolve directory or symbolic link.',
+                path,
+                skillName: undefined,
+            }));
+            return;
+        }
+        if (ancestors.has(resolvedPath)) {
+            diagnostics.push(diagnostic({
+                code: 'symlink-cycle',
+                severity: 'error',
+                message: 'Symbolic-link cycle detected while scanning.',
+                path,
+                skillName: undefined,
+            }));
+            return;
+        }
+        const manifestPath = join(path, 'SKILL.md');
+        if (await exists(manifestPath)) {
+            try {
+                const [content, directoryStat, manifestStat] = await Promise.all([
+                    readFile(manifestPath, 'utf8'),
+                    lstat(path),
+                    stat(manifestPath),
+                ]);
+                const manifest = parseSkillManifest(content);
+                const directoryName = basename(path);
+                const skillName = manifest.name ?? directoryName;
+                const itemDiagnostics = manifest.errors.map((message) => diagnostic({
+                    code: 'invalid-manifest',
+                    severity: 'error',
+                    message,
+                    path: manifestPath,
+                    skillName,
+                }));
+                if (manifest.name && manifest.name !== directoryName) {
+                    itemDiagnostics.push(diagnostic({
+                        code: 'name-directory-mismatch',
+                        severity: 'warning',
+                        message: `Manifest name "${manifest.name}" does not match directory "${directoryName}".`,
+                        path: manifestPath,
+                        skillName,
+                    }));
+                }
+                installations.push({
+                    id: stableId(root.id, path),
+                    skillName,
+                    directoryName,
+                    description: manifest.description ?? 'No description available.',
+                    manifestPath,
+                    path,
+                    realPath: resolvedPath,
+                    scope: root.scope,
+                    rootKind: root.kind,
+                    agentIds: root.agentIds,
+                    linkKind: directoryStat.isSymbolicLink() ? 'symlink' : 'directory',
+                    mutable: root.mutable,
+                    source: manifest.source,
+                    modifiedAtMs: manifestStat.mtimeMs,
+                    isEffective: true,
+                    diagnostics: itemDiagnostics,
+                });
+                diagnostics.push(...itemDiagnostics);
+            }
+            catch (error) {
+                diagnostics.push(diagnostic({
+                    code: 'manifest-unreadable',
+                    severity: 'error',
+                    message: error instanceof Error ? error.message : 'Unable to read SKILL.md.',
+                    path: manifestPath,
+                    skillName: basename(path),
+                }));
+            }
+            return;
+        }
+        if (depth >= root.maxDepth) {
+            return;
+        }
+        let entries;
+        try {
+            entries = await readdir(path, { withFileTypes: true });
+        }
+        catch (error) {
+            diagnostics.push(diagnostic({
+                code: 'directory-unreadable',
+                severity: 'error',
+                message: error instanceof Error ? error.message : 'Unable to read directory.',
+                path,
+                skillName: undefined,
+            }));
+            return;
+        }
+        const nextAncestors = new Set(ancestors).add(resolvedPath);
+        await Promise.all(entries
+            .filter((entry) => !SKIPPED_DIRECTORIES.has(entry.name) &&
+            !root.excludedDirectoryNames.includes(entry.name))
+            .filter((entry) => entry.isDirectory() || entry.isSymbolicLink())
+            .map((entry) => visitDirectory(join(path, entry.name), depth + 1, nextAncestors)));
+    }
+    await visitDirectory(root.path, 0, new Set());
+    installations.sort((a, b) => a.skillName.localeCompare(b.skillName));
+    return { installations, diagnostics };
+}
+export async function scanSkillRoots(roots) {
+    const results = await Promise.all(roots.map(scanSkillRoot));
+    return {
+        installations: results.flatMap((result) => result.installations),
+        diagnostics: results.flatMap((result) => result.diagnostics),
+    };
+}
+//# sourceMappingURL=skill-scanner.js.map

package/dist/adapters/filesystem/skill-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-scanner.js","sourceRoot":"","sources":["../../../src/adapters/filesystem/skill-scanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AACvC,OAAO,EAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAC,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAC,QAAQ,EAAE,IAAI,EAAC,MAAM,WAAW,CAAC;AAOzC,OAAO,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AAEpD,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAOhF,SAAS,QAAQ,CAAC,GAAG,KAAe;IAClC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,UAAU,CAAC,KAA6B;IAC/C,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC;QAChF,GAAG,KAAK;KACT,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAe;IACjD,MAAM,aAAa,GAAwB,EAAE,CAAC;IAC9C,MAAM,WAAW,GAAiB,EAAE,CAAC;IAErC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;gBACT,IAAI,EAAE,iBAAiB;gBACvB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,wCAAwC;gBACjD,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,SAAS,EAAE,SAAS;aACrB,CAAC,CACH,CAAC;QACJ,CAAC;QACD,OAAO,EAAC,aAAa,EAAE,WAAW,EAAC,CAAC;IACtC,CAAC;IAED,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,KAAa,EAAE,SAAsB;QAC/E,IAAI,YAAoB,CAAC;QACzB,IAAI,CAAC;YACH,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;gBACT,IAAI,EAAE,gBAAgB;gBACtB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,+CAA+C;gBACxD,IAAI;gBACJ,SAAS,EAAE,SAAS;aACrB,CAAC,CACH,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;gBACT,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,8CAA8C;gBACvD,IAAI;gBACJ,SAAS,EAAE,SAAS;aACrB,CAAC,CACH,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC5C,IAAI,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;oBAC/D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;oBAC9B,KAAK,CAAC,IAAI,CAAC;oBACX,IAAI,CAAC,YAAY,CAAC;iBACnB,CAAC,CAAC;gBACH,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;gBAC7C,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACrC,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,IAAI,aAAa,CAAC;gBACjD,MAAM,eAAe,GAAiB,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACpE,UAAU,CAAC;oBACT,IAAI,EAAE,kBAAkB;oBACxB,QAAQ,EAAE,OAAO;oBACjB,OAAO;oBACP,IAAI,EAAE,YAAY;oBAClB,SAAS;iBACV,CAAC,CACH,CAAC;gBAEF,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBACrD,eAAe,CAAC,IAAI,CAClB,UAAU,CAAC;wBACT,IAAI,EAAE,yBAAyB;wBAC/B,QAAQ,EAAE,SAAS;wBACnB,OAAO,EAAE,kBAAkB,QAAQ,CAAC,IAAI,+BAA+B,aAAa,IAAI;wBACxF,IAAI,EAAE,YAAY;wBAClB,SAAS;qBACV,CAAC,CACH,CAAC;gBACJ,CAAC;gBAED,aAAa,CAAC,IAAI,CAAC;oBACjB,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC;oBAC3B,SAAS;oBACT,aAAa;oBACb,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,2BAA2B;oBAChE,YAAY;oBACZ,IAAI;oBACJ,QAAQ,EAAE,YAAY;oBACtB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,QAAQ,EAAE,aAAa,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW;oBAClE,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,YAAY,EAAE,YAAY,CAAC,OAAO;oBAClC,WAAW,EAAE,IAAI;oBACjB,WAAW,EAAE,eAAe;iBAC7B,CAAC,CAAC;gBACH,WAAW,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;oBACT,IAAI,EAAE,qBAAqB;oBAC3B,QAAQ,EAAE,OAAO;oBACjB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B;oBAC5E,IAAI,EAAE,YAAY;oBAClB,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC;iBAC1B,CAAC,CACH,CAAC;YACJ,CAAC;YAED,OAAO;QACT,CAAC;QAED,IAAI,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAC,aAAa,EAAE,IAAI,EAAC,CAAC,CAAC;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;gBACT,IAAI,EAAE,sBAAsB;gBAC5B,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B;gBAC7E,IAAI;gBACJ,SAAS,EAAE,SAAS;aACrB,CAAC,CACH,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC3D,MAAM,OAAO,CAAC,GAAG,CACf,OAAO;aACJ,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YACpC,CAAC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CACpD;aACA,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;aAChE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACrE,OAAO,EAAC,aAAa,EAAE,WAAW,EAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAkB;IACrD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5D,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC;QAChE,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC;KAC7D,CAAC;AACJ,CAAC"}

package/dist/adapters/filesystem/skills-lock.d.ts

@@ -0,0 +1,2 @@
+import type { EnvironmentInfo, SkillInstallation } from '../../domain/types.js';
+export declare function enrichInstallationsFromSkillsLocks(installations: SkillInstallation[], environment: EnvironmentInfo): Promise<void>;

package/dist/adapters/filesystem/skills-lock.js

@@ -0,0 +1,44 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+function optionalString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+async function readLock(path) {
+    try {
+        const parsed = JSON.parse(await readFile(path, 'utf8'));
+        if (!parsed.skills || typeof parsed.skills !== 'object') {
+            return new Map();
+        }
+        return new Map(Object.entries(parsed.skills));
+    }
+    catch {
+        return new Map();
+    }
+}
+export async function enrichInstallationsFromSkillsLocks(installations, environment) {
+    const lockPaths = {
+        project: join(environment.projectRoot, 'skills-lock.json'),
+        user: process.env.XDG_STATE_HOME
+            ? join(process.env.XDG_STATE_HOME, 'skills', '.skill-lock.json')
+            : join(environment.homeDir, '.agents', '.skill-lock.json'),
+    };
+    const [projectLock, userLock] = await Promise.all([
+        readLock(lockPaths.project),
+        readLock(lockPaths.user),
+    ]);
+    const locks = {
+        project: projectLock,
+        user: userLock,
+    };
+    for (const installation of installations) {
+        if (!installation.mutable || installation.source) {
+            continue;
+        }
+        const entry = locks[installation.scope].get(installation.skillName);
+        if (!entry) {
+            continue;
+        }
+        installation.source = optionalString(entry.sourceUrl) ?? optionalString(entry.source);
+    }
+}
+//# sourceMappingURL=skills-lock.js.map

package/dist/adapters/filesystem/skills-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-lock.js","sourceRoot":"","sources":["../../../src/adapters/filesystem/skills-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAkB/B,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9E,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAe,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxD,OAAO,IAAI,GAAG,EAAE,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kCAAkC,CACtD,aAAkC,EAClC,WAA4B;IAE5B,MAAM,SAAS,GAA0B;QACvC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,kBAAkB,CAAC;QAC1D,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;YAC9B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,EAAE,kBAAkB,CAAC;YAChE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,kBAAkB,CAAC;KAC7D,CAAC;IACF,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAChD,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC;QAC3B,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC;KACzB,CAAC,CAAC;IACH,MAAM,KAAK,GAA0C;QACnD,OAAO,EAAE,WAAW;QACpB,IAAI,EAAE,QAAQ;KACf,CAAC;IAEF,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;QACzC,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YACjD,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QACD,YAAY,CAAC,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxF,CAAC;AACH,CAAC"}

package/dist/adapters/skills-cli/command-builder.d.ts

@@ -0,0 +1,7 @@
+import type { InstallRequest, RemoveRequest, SkillsCliRuntime, SkillsCommandPlan, UpdateRequest } from './types.js';
+export declare const TESTED_SKILLS_VERSION = "1.5.17";
+export declare function bundledSkillsRuntime(): SkillsCliRuntime;
+export declare function buildSourcePreviewPlan(source: string, cwd: string, runtime?: SkillsCliRuntime): SkillsCommandPlan;
+export declare function buildInstallPlan(request: InstallRequest, runtime?: SkillsCliRuntime): SkillsCommandPlan;
+export declare function buildUpdatePlan(request: UpdateRequest, runtime?: SkillsCliRuntime): SkillsCommandPlan;
+export declare function buildRemovePlan(request: RemoveRequest, runtime?: SkillsCliRuntime): SkillsCommandPlan;

package/dist/adapters/skills-cli/command-builder.js

@@ -0,0 +1,144 @@
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { redactSensitiveText } from '../../platform/redaction.js';
+export const TESTED_SKILLS_VERSION = '1.5.17';
+const SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const AGENT_ID_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function quoteForDisplay(value) {
+    const redacted = redactSensitiveText(value);
+    return /^[a-zA-Z0-9_./:@%+=,-]+$/.test(redacted)
+        ? redacted
+        : `'${redacted.replaceAll("'", `'\\''`)}'`;
+}
+function commandDisplay(prefix, args) {
+    return [...prefix, ...args].map(quoteForDisplay).join(' ');
+}
+function assertSource(source) {
+    if (!source.trim()) {
+        throw new Error('A skill source is required.');
+    }
+    if (/[\u0000-\u001f\u007f]/.test(source)) {
+        throw new Error('Skill source contains control characters.');
+    }
+}
+function assertSkillNames(skillNames) {
+    if (skillNames.length === 0) {
+        throw new Error('Select at least one skill.');
+    }
+    for (const skillName of skillNames) {
+        if (!SKILL_NAME_PATTERN.test(skillName)) {
+            throw new Error(`Invalid skill name: ${skillName}`);
+        }
+    }
+}
+function assertAgentIds(agentIds) {
+    if (agentIds.length === 0) {
+        throw new Error('Select at least one target agent.');
+    }
+    for (const agentId of agentIds) {
+        if (!AGENT_ID_PATTERN.test(agentId)) {
+            throw new Error(`Invalid agent id: ${agentId}`);
+        }
+    }
+}
+function createPlan(runtime, input) {
+    return {
+        kind: input.kind,
+        executable: runtime.executable,
+        args: [...runtime.prefixArgs, ...input.commandArgs],
+        cwd: input.cwd,
+        environment: runtime.environment,
+        displayCommand: commandDisplay(runtime.displayPrefix, input.commandArgs),
+        mutatesFilesystem: input.mutatesFilesystem,
+        skillNames: input.skillNames ?? [],
+        agentIds: input.agentIds ?? [],
+        scope: input.scope,
+        source: input.source,
+    };
+}
+export function bundledSkillsRuntime() {
+    const require = createRequire(import.meta.url);
+    const packageJsonPath = require.resolve('skills/package.json');
+    const cliPath = join(dirname(packageJsonPath), 'bin', 'cli.mjs');
+    return {
+        executable: process.execPath,
+        prefixArgs: [cliPath],
+        displayPrefix: ['npx', `skills@${TESTED_SKILLS_VERSION}`],
+        environment: {
+            DISABLE_TELEMETRY: '1',
+            DO_NOT_TRACK: '1',
+        },
+        version: TESTED_SKILLS_VERSION,
+    };
+}
+export function buildSourcePreviewPlan(source, cwd, runtime = bundledSkillsRuntime()) {
+    assertSource(source);
+    const normalizedSource = source.trim();
+    return createPlan(runtime, {
+        kind: 'preview',
+        commandArgs: ['add', normalizedSource, '--list'],
+        cwd,
+        mutatesFilesystem: false,
+        source: normalizedSource,
+    });
+}
+export function buildInstallPlan(request, runtime = bundledSkillsRuntime()) {
+    assertSource(request.source);
+    assertSkillNames(request.skillNames);
+    assertAgentIds(request.agentIds);
+    const commandArgs = ['add', request.source.trim()];
+    for (const skillName of request.skillNames) {
+        commandArgs.push('--skill', skillName);
+    }
+    commandArgs.push('--agent', ...request.agentIds);
+    if (request.scope === 'user') {
+        commandArgs.push('--global');
+    }
+    if (request.mode === 'copy') {
+        commandArgs.push('--copy');
+    }
+    commandArgs.push('--yes');
+    return createPlan(runtime, {
+        kind: 'install',
+        commandArgs,
+        cwd: request.cwd,
+        mutatesFilesystem: true,
+        skillNames: request.skillNames,
+        agentIds: request.agentIds,
+        scope: request.scope,
+        source: request.source.trim(),
+    });
+}
+export function buildUpdatePlan(request, runtime = bundledSkillsRuntime()) {
+    assertSkillNames(request.skillNames);
+    const commandArgs = ['update', ...request.skillNames];
+    commandArgs.push(request.scope === 'user' ? '--global' : '--project');
+    commandArgs.push('--yes');
+    return createPlan(runtime, {
+        kind: 'update',
+        commandArgs,
+        cwd: request.cwd,
+        mutatesFilesystem: true,
+        skillNames: request.skillNames,
+        scope: request.scope,
+    });
+}
+export function buildRemovePlan(request, runtime = bundledSkillsRuntime()) {
+    assertSkillNames(request.skillNames);
+    assertAgentIds(request.agentIds);
+    const commandArgs = ['remove', ...request.skillNames, '--agent', ...request.agentIds];
+    if (request.scope === 'user') {
+        commandArgs.push('--global');
+    }
+    commandArgs.push('--yes');
+    return createPlan(runtime, {
+        kind: 'remove',
+        commandArgs,
+        cwd: request.cwd,
+        mutatesFilesystem: true,
+        skillNames: request.skillNames,
+        agentIds: request.agentIds,
+        scope: request.scope,
+    });
+}
+//# sourceMappingURL=command-builder.js.map

package/dist/adapters/skills-cli/command-builder.js.map

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

package/dist/adapters/skills-cli/executor.d.ts

@@ -0,0 +1,20 @@
+import type { Readable } from 'node:stream';
+import type { CommandExecution, CommandOutput, SkillsCommandPlan } from './types.js';
+export interface SpawnedProcess {
+    stdout: Readable;
+    stderr: Readable;
+    kill(signal?: NodeJS.Signals): boolean;
+    once(event: 'error', listener: (error: Error) => void): this;
+    once(event: 'close', listener: (exitCode: number | null, signal: NodeJS.Signals | null) => void): this;
+}
+export type SpawnProcess = (executable: string, args: string[], options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    shell: false;
+    stdio: ['ignore', 'pipe', 'pipe'];
+}) => SpawnedProcess;
+export declare function executeSkillsCommand(plan: SkillsCommandPlan, options?: {
+    signal?: AbortSignal;
+    onOutput?: (output: CommandOutput) => void;
+    spawnProcess?: SpawnProcess;
+}): Promise<CommandExecution>;

package/dist/adapters/skills-cli/executor.js

@@ -0,0 +1,51 @@
+import { spawn } from 'node:child_process';
+const defaultSpawn = (executable, args, options) => spawn(executable, args, options);
+export function executeSkillsCommand(plan, options = {}) {
+    return new Promise((resolve, reject) => {
+        const startedAt = Date.now();
+        const child = (options.spawnProcess ?? defaultSpawn)(plan.executable, plan.args, {
+            cwd: plan.cwd,
+            env: { ...process.env, ...plan.environment },
+            shell: false,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.setEncoding('utf8');
+        child.stderr.setEncoding('utf8');
+        child.stdout.on('data', (chunk) => {
+            stdout += chunk;
+            options.onOutput?.({ stream: 'stdout', text: chunk });
+        });
+        child.stderr.on('data', (chunk) => {
+            stderr += chunk;
+            options.onOutput?.({ stream: 'stderr', text: chunk });
+        });
+        const abort = () => {
+            child.kill('SIGINT');
+        };
+        if (options.signal) {
+            if (options.signal.aborted) {
+                abort();
+            }
+            else {
+                options.signal.addEventListener('abort', abort, { once: true });
+            }
+        }
+        child.once('error', (error) => {
+            options.signal?.removeEventListener('abort', abort);
+            reject(error);
+        });
+        child.once('close', (exitCode, signal) => {
+            options.signal?.removeEventListener('abort', abort);
+            resolve({
+                exitCode: exitCode ?? 1,
+                signal,
+                stdout,
+                stderr,
+                durationMs: Date.now() - startedAt,
+            });
+        });
+    });
+}
+//# sourceMappingURL=executor.js.map

package/dist/adapters/skills-cli/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/adapters/skills-cli/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,oBAAoB,CAAC;AA+BzC,MAAM,YAAY,GAAiB,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC/D,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,OAAO,CAAmB,CAAC;AAErD,MAAM,UAAU,oBAAoB,CAClC,IAAuB,EACvB,OAAO,GAIH,EAAE;IAEN,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,YAAY,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE;YAC/E,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,EAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,EAAC;YAC1C,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC;YAChB,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAC,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC;YAChB,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAC,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC3B,KAAK,EAAE,CAAC;YACV,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAC,IAAI,EAAE,IAAI,EAAC,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5B,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACpD,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;YACvC,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACpD,OAAO,CAAC;gBACN,QAAQ,EAAE,QAAQ,IAAI,CAAC;gBACvB,MAAM;gBACN,MAAM;gBACN,MAAM;gBACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACnC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/adapters/skills-cli/source-parser.d.ts

@@ -0,0 +1,3 @@
+import type { SourceSkill } from './types.js';
+export declare function stripAnsi(value: string): string;
+export declare function parseSourceSkills(output: string): SourceSkill[];

package/dist/adapters/skills-cli/source-parser.js

@@ -0,0 +1,38 @@
+const ANSI_PATTERN = /[\u001B\u009B][[\]()#;?]*(?:(?:(?:[a-zA-Z\d]*(?:;[-a-zA-Z\d\/#&.:=?%@~_]+)*)?\u0007)|(?:(?:\d{1,4}(?:[;:]\d{0,4})*)?[\dA-PR-TZcf-nq-uy=><~]))/g;
+const SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export function stripAnsi(value) {
+    return value.replace(ANSI_PATTERN, '');
+}
+export function parseSourceSkills(output) {
+    const lines = stripAnsi(output).split(/\r?\n/);
+    const start = lines.findIndex((line) => line.includes('Available Skills'));
+    if (start < 0) {
+        return [];
+    }
+    const skills = [];
+    for (let index = start + 1; index < lines.length; index += 1) {
+        const line = lines[index] ?? '';
+        if (line.includes('Use --skill')) {
+            break;
+        }
+        const match = /^│\s{4}([a-z0-9][a-z0-9-]{0,63})\s*$/.exec(line);
+        if (!match?.[1] || !SKILL_NAME_PATTERN.test(match[1])) {
+            continue;
+        }
+        let description = '';
+        for (let descriptionIndex = index + 1; descriptionIndex < lines.length; descriptionIndex += 1) {
+            const candidate = lines[descriptionIndex] ?? '';
+            if (/^│\s{4}[a-z0-9]/.test(candidate) || candidate.includes('Use --skill')) {
+                break;
+            }
+            const descriptionMatch = /^│\s{6}(.+?)\s*$/.exec(candidate);
+            if (descriptionMatch?.[1]) {
+                description = descriptionMatch[1];
+                break;
+            }
+        }
+        skills.push({ name: match[1], description });
+    }
+    return [...new Map(skills.map((skill) => [skill.name, skill])).values()];
+}
+//# sourceMappingURL=source-parser.js.map

package/dist/adapters/skills-cli/source-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-parser.js","sourceRoot":"","sources":["../../../src/adapters/skills-cli/source-parser.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,gJAAgJ,CAAC;AACtK,MAAM,kBAAkB,GAAG,4BAA4B,CAAC;AAExD,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC3E,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,IAAI,KAAK,GAAG,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACjC,MAAM;QACR,CAAC;QACD,MAAM,KAAK,GAAG,sCAAsC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,SAAS;QACX,CAAC;QAED,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,KAAK,IAAI,gBAAgB,GAAG,KAAK,GAAG,CAAC,EAAE,gBAAgB,GAAG,KAAK,CAAC,MAAM,EAAE,gBAAgB,IAAI,CAAC,EAAE,CAAC;YAC9F,MAAM,SAAS,GAAG,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;YAChD,IAAI,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC3E,MAAM;YACR,CAAC;YACD,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5D,IAAI,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1B,WAAW,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;gBAClC,MAAM;YACR,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAC,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/adapters/skills-cli/types.d.ts

@@ -0,0 +1,56 @@
+import type { Scope } from '../../domain/types.js';
+export type OperationKind = 'preview' | 'install' | 'update' | 'remove' | 'repair';
+export interface SkillsCliRuntime {
+    executable: string;
+    prefixArgs: string[];
+    displayPrefix: string[];
+    environment: Record<string, string>;
+    version: string;
+}
+export interface SkillsCommandPlan {
+    kind: OperationKind;
+    executable: string;
+    args: string[];
+    cwd: string;
+    environment: Record<string, string>;
+    displayCommand: string;
+    mutatesFilesystem: boolean;
+    skillNames: string[];
+    agentIds: string[];
+    scope: Scope | undefined;
+    source: string | undefined;
+}
+export interface InstallRequest {
+    source: string;
+    skillNames: string[];
+    agentIds: string[];
+    scope: Scope;
+    mode: 'symlink' | 'copy';
+    cwd: string;
+}
+export interface UpdateRequest {
+    skillNames: string[];
+    scope: Scope;
+    cwd: string;
+}
+export interface RemoveRequest {
+    skillNames: string[];
+    agentIds: string[];
+    scope: Scope;
+    cwd: string;
+}
+export interface CommandOutput {
+    stream: 'stdout' | 'stderr';
+    text: string;
+}
+export interface CommandExecution {
+    exitCode: number;
+    signal: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+}
+export interface SourceSkill {
+    name: string;
+    description: string;
+}

package/dist/adapters/skills-cli/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/skills-cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/skills-cli/types.ts"],"names":[],"mappings":""}

package/dist/application/backup-manager.d.ts

@@ -0,0 +1,7 @@
+import type { SkillsCommandPlan } from '../adapters/skills-cli/types.js';
+import type { OperationSnapshot, RestoreResult } from '../domain/operations.js';
+import type { Inventory } from '../domain/types.js';
+export declare function createOperationSnapshot(plan: SkillsCommandPlan, inventory: Inventory, dataRoot: string): Promise<OperationSnapshot>;
+export declare function finalizeOperationSnapshot(snapshot: OperationSnapshot, plan: SkillsCommandPlan, before: Inventory, after: Inventory): Promise<OperationSnapshot>;
+export declare function loadOperationSnapshot(snapshotId: string, dataRoot: string): Promise<OperationSnapshot>;
+export declare function restoreOperationSnapshot(snapshot: OperationSnapshot): Promise<RestoreResult>;