@halyard/cli 0.1.1 → 0.2.0

package/dist/lib/skill-fingerprint.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Content fingerprint for a skill folder plus a minimal SKILL.md front-matter
+ * parser. The fingerprint covers the whole tree (skills ship helper scripts
+ * and templates next to SKILL.md), so any edit anywhere in the folder is a
+ * change; the manifest it is built from travels with the upload so a later
+ * write-back can tell which file drifted.
+ */
+export interface SkillFileEntry {
+    /** Path relative to the skill directory, posix separators. */
+    path: string;
+    size: number;
+    sha256: string;
+    /** The file's bytes, kept so the upload can carry them (see skill-files.ts). */
+    bytes: Buffer;
+}
+export interface SkillFingerprint {
+    /** sha256 over the sorted manifest (`<path>\0<sha256>\n` per file). */
+    treeHash: string;
+    files: SkillFileEntry[];
+    /** Newest mtime across the tree — the source-side "last modified" time. */
+    modifiedAt: Date;
+    /** Files left out of the manifest (and so never uploaded) because they exceed MAX_FILE_BYTES. */
+    skippedPaths: string[];
+    /** Files hashed (`files` may be a prefix of them when the tree is larger than MAX_FILES). */
+    fileCount: number;
+    /** The walk stopped early (WALK_FILE_BUDGET / WALK_BYTE_BUDGET): the hash covers a prefix of the tree. */
+    truncated: boolean;
+}
+export declare function fingerprintSkillDir(dir: string): SkillFingerprint;
+export interface ParsedSkillMarkdown {
+    /** Top-level front-matter fields, values as written (block scalars joined). */
+    frontmatter: Record<string, string>;
+    /**
+     * The verbatim text between the opening `---` line and the closing `---`
+     * line (CRLF normalised, nothing else touched); absent when the file has
+     * no front-matter block. The server parses this itself, so nothing the
+     * flat `frontmatter` map cannot express is lost.
+     */
+    frontmatterRaw?: string;
+    /** Markdown after the front-matter block (the whole file when there is none). */
+    body: string;
+    name?: string;
+    description?: string;
+    /** Things the author probably wants to know about (e.g. an unterminated front-matter block). */
+    warnings: string[];
+}
+/**
+ * Parse SKILL.md front-matter without a YAML dependency. Handles what skill
+ * files actually use: `key: value` scalars (optionally quoted), `|` / `>`
+ * block scalars, and nested blocks (`metadata:` maps, lists), which are kept
+ * as their raw indented text. Anything unparseable is left out rather than
+ * failing the sync.
+ */
+export declare function parseSkillMarkdown(raw: string): ParsedSkillMarkdown;
+//# sourceMappingURL=skill-fingerprint.d.ts.map

package/dist/lib/skill-fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-fingerprint.d.ts","sourceRoot":"","sources":["../../src/lib/skill-fingerprint.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,2EAA2E;IAC3E,UAAU,EAAE,IAAI,CAAA;IAChB,iGAAiG;IACjG,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,6FAA6F;IAC7F,SAAS,EAAE,MAAM,CAAA;IACjB,0GAA0G;IAC1G,SAAS,EAAE,OAAO,CAAA;CACnB;AAgBD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAgEjE;AAuBD,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gGAAgG;IAChG,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAqCnE"}

package/dist/lib/skill-fingerprint.js

@@ -0,0 +1,204 @@
+import { createHash } from 'node:crypto';
+import { readdirSync, readFileSync, realpathSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+const IGNORED_DIRS = new Set(['.git', 'node_modules', '__pycache__', '.venv', 'venv']);
+const IGNORED_FILES = new Set(['.DS_Store', 'Thumbs.db']);
+/** Anything larger is not skill content (binaries, datasets); left out of the manifest. */
+const MAX_FILE_BYTES = 1024 * 1024;
+/** Bound on manifest size; the server rejects more. */
+const MAX_FILES = 500;
+/**
+ * Hard stop for the walk so a skill that symlinks into a large tree cannot
+ * stall the session-start hook: after this many files or bytes the walk ends
+ * and the fingerprint is flagged `truncated`.
+ */
+const WALK_FILE_BUDGET = 2000;
+const WALK_BYTE_BUDGET = 32 * 1024 * 1024;
+export function fingerprintSkillDir(dir) {
+    const files = [];
+    const skippedPaths = [];
+    let modifiedAt = 0;
+    let bytes = 0;
+    let truncated = false;
+    const seenDirs = new Set();
+    const overBudget = () => {
+        if (files.length < WALK_FILE_BUDGET && bytes < WALK_BYTE_BUDGET)
+            return false;
+        truncated = true;
+        return true;
+    };
+    const walk = (current, prefix) => {
+        const real = canonical(current);
+        if (seenDirs.has(real))
+            return; // symlink cycle
+        seenDirs.add(real);
+        for (const name of listSorted(current)) {
+            if (overBudget())
+                return;
+            const full = join(current, name);
+            let stat;
+            try {
+                stat = statSync(full);
+            }
+            catch {
+                continue; // dangling symlink or vanished file
+            }
+            if (stat.isDirectory()) {
+                if (!IGNORED_DIRS.has(name))
+                    walk(full, `${prefix}${name}/`);
+                continue;
+            }
+            if (!stat.isFile() || IGNORED_FILES.has(name))
+                continue;
+            if (stat.size > MAX_FILE_BYTES) {
+                skippedPaths.push(`${prefix}${name}`);
+                continue;
+            }
+            let content;
+            try {
+                content = readFileSync(full);
+            }
+            catch {
+                continue; // unreadable helper file: SKILL.md itself is read (and fails loudly) by the caller
+            }
+            bytes += content.length;
+            modifiedAt = Math.max(modifiedAt, stat.mtimeMs);
+            files.push({
+                path: `${prefix}${name}`,
+                size: stat.size,
+                sha256: sha256(content),
+                bytes: content,
+            });
+        }
+    };
+    walk(dir, '');
+    files.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+    const manifest = files.map((f) => `${f.path}\0${f.sha256}\n`).join('');
+    return {
+        treeHash: sha256(Buffer.from(manifest)),
+        files: files.slice(0, MAX_FILES),
+        modifiedAt: new Date(modifiedAt || Date.now()),
+        skippedPaths,
+        fileCount: files.length,
+        truncated,
+    };
+}
+/** Directory entries in a stable order; an unreadable directory contributes nothing. */
+function listSorted(dir) {
+    try {
+        return readdirSync(dir).sort();
+    }
+    catch {
+        return [];
+    }
+}
+function sha256(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+function canonical(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return path;
+    }
+}
+/**
+ * Parse SKILL.md front-matter without a YAML dependency. Handles what skill
+ * files actually use: `key: value` scalars (optionally quoted), `|` / `>`
+ * block scalars, and nested blocks (`metadata:` maps, lists), which are kept
+ * as their raw indented text. Anything unparseable is left out rather than
+ * failing the sync.
+ */
+export function parseSkillMarkdown(raw) {
+    const text = raw.replace(/\r\n/g, '\n');
+    const frontmatter = {};
+    const warnings = [];
+    if (!text.startsWith('---\n'))
+        return { frontmatter, body: text, warnings };
+    // The closing line must be exactly `---` (trailing whitespace allowed).
+    const close = /\n---[ \t]*(?:\n|$)/.exec(text.slice(4));
+    const end = close ? close.index + 4 : -1;
+    if (end === -1) {
+        warnings.push('front-matter block is not terminated by a `---` line; treating the whole file as body');
+        return { frontmatter, body: text, warnings };
+    }
+    const block = text.slice(4, end);
+    const afterClose = text.indexOf('\n', end + 1);
+    const body = afterClose === -1 ? '' : text.slice(afterClose + 1);
+    const lines = block.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        const match = /^([A-Za-z0-9_-]+):(?:[ \t]+(.*))?$/.exec(line);
+        if (!match)
+            continue;
+        const key = match[1] ?? '';
+        const inline = (match[2] ?? '').trim();
+        const { value, consumed } = readValue(inline, lines, i + 1);
+        frontmatter[key] = value;
+        i += consumed;
+    }
+    const name = frontmatter['name']?.trim() || undefined;
+    const description = frontmatter['description']?.trim() || undefined;
+    if (!name)
+        warnings.push('front-matter has no `name`; using the folder name');
+    if (!description)
+        warnings.push('front-matter has no `description`');
+    return { frontmatter, frontmatterRaw: block, body, name, description, warnings };
+}
+/** Resolve a front-matter value: inline scalar, block scalar, or nested block. */
+function readValue(inline, lines, from) {
+    const continuation = collectIndented(lines, from);
+    if (inline === '|' || inline === '|-' || inline === '>' || inline === '>-') {
+        const stripped = dedent(continuation.lines);
+        const joined = inline.startsWith('|') ? stripped.join('\n') : foldLines(stripped);
+        return { value: joined.trim(), consumed: continuation.count };
+    }
+    if (inline === '' && continuation.count > 0) {
+        return { value: dedent(continuation.lines).join('\n'), consumed: continuation.count };
+    }
+    return { value: scalar(inline), consumed: 0 };
+}
+function collectIndented(lines, from) {
+    const out = [];
+    let i = from;
+    while (i < lines.length) {
+        const line = lines[i] ?? '';
+        if (line.trim() !== '' && !/^[ \t]/.test(line))
+            break;
+        out.push(line);
+        i++;
+    }
+    // Trailing blank lines belong to the next key, not the block.
+    while (out.length > 0 && (out[out.length - 1] ?? '').trim() === '')
+        out.pop();
+    return { lines: out, count: out.length };
+}
+function dedent(lines) {
+    const indents = lines
+        .filter((l) => l.trim() !== '')
+        .map((l) => /^[ \t]*/.exec(l)?.[0].length ?? 0);
+    const min = indents.length > 0 ? Math.min(...indents) : 0;
+    return lines.map((l) => l.slice(Math.min(min, /^[ \t]*/.exec(l)?.[0].length ?? 0)));
+}
+/** YAML folded style: newlines become spaces, blank lines become newlines. */
+function foldLines(lines) {
+    return lines
+        .join('\n')
+        .split(/\n{2,}/)
+        .map((paragraph) => paragraph.split('\n').join(' ').trim())
+        .join('\n');
+}
+/** Inline scalar: strip a trailing comment and surrounding quotes. */
+function scalar(value) {
+    const doubleQuoted = /^"((?:[^"\\]|\\.)*)"(?:\s+#.*)?$/.exec(value);
+    if (doubleQuoted) {
+        return (doubleQuoted[1] ?? '').replace(/\\"/g, '"').replace(/\\n/g, '\n').replace(/\\\\/g, '\\');
+    }
+    const singleQuoted = /^'((?:[^']|'')*)'(?:\s+#.*)?$/.exec(value);
+    if (singleQuoted)
+        return (singleQuoted[1] ?? '').replace(/''/g, "'");
+    const hash = value.indexOf(' #');
+    return (hash === -1 ? value : value.slice(0, hash)).trim();
+}
+//# sourceMappingURL=skill-fingerprint.js.map

package/dist/lib/skill-fingerprint.js.map

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

package/dist/lib/skills-discovery.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Where coding-agent harnesses look for skills. A skill is a directory that
+ * directly contains a `SKILL.md` (the Agent Skills format, agentskills.io).
+ * Every harness reads its own `.<tool>/skills` directory; most also read
+ * `.agents/skills` (the cross-client convention) and `.claude/skills` for
+ * compatibility, so the same folder is routinely reachable from several of
+ * these — often through symlinks. Discovery de-duplicates by real path.
+ */
+export type SkillScope = 'user' | 'project';
+export interface SkillLocation {
+    /** Harness that reads this directory. */
+    harness: string;
+    /** Directory relative to the scope root (home dir or repo root), posix separators. */
+    dir: string;
+}
+/**
+ * Order is load-bearing: when a skill's real directory lies outside every
+ * scanned location (a symlink to somewhere else) the first location that
+ * sees it names its `relativePath`, which becomes its ledger key and server
+ * identity. Append new harnesses at the end; never reorder.
+ */
+/** User-level skill directories, relative to $HOME. */
+export declare const USER_SKILL_LOCATIONS: readonly SkillLocation[];
+/** Repo-level skill directories, relative to the repository root. */
+export declare const PROJECT_SKILL_LOCATIONS: readonly SkillLocation[];
+export declare const SKILL_FILE = "SKILL.md";
+export interface DiscoveredSkill {
+    scope: SkillScope;
+    /** Absolute path of the skill directory as found (may sit behind a symlink). */
+    dir: string;
+    /** Canonical absolute path (symlinks resolved) — the de-dupe key within a scope. */
+    realDir: string;
+    /** Skill directory relative to the scope root, posix separators. */
+    relativePath: string;
+    /** Every relative path the skill was found at (symlink aliases), `relativePath` first. */
+    locations: string[];
+    /** Harnesses whose directories contain the skill. */
+    harnesses: string[];
+    /** Directory basename; the spec says the frontmatter `name` must match it. */
+    folderName: string;
+}
+export interface DiscoverSkillsOptions {
+    scope: SkillScope;
+    /** Home directory (user scope) or repository root (project scope). */
+    rootDir: string;
+    /** Defaults to the scope's built-in location table. */
+    locations?: readonly SkillLocation[];
+}
+/**
+ * Discover skills under one scope root. Skill directories sit directly under
+ * a location (`.claude/skills/<name>/SKILL.md`); up to two levels of grouping
+ * are allowed so grouped layouts (`~/.claude/skills/synced/<uuid>/<name>`,
+ * Gemini's nested dirs) are found too. Dot-directories are skipped
+ * (`~/.codex/skills/.system` holds Codex's bundled skills, not the user's).
+ */
+export declare function discoverSkills(options: DiscoverSkillsOptions): DiscoveredSkill[];
+//# sourceMappingURL=skills-discovery.d.ts.map

package/dist/lib/skills-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-discovery.d.ts","sourceRoot":"","sources":["../../src/lib/skills-discovery.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,CAAA;AAE3C,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAA;IACf,sFAAsF;IACtF,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;GAKG;AAEH,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,EAAE,SAAS,aAAa,EAcxD,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,EAAE,SAAS,aAAa,EAa3D,CAAA;AAED,eAAO,MAAM,UAAU,aAAa,CAAA;AAEpC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,CAAA;IACjB,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAA;IACX,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAA;IACf,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAA;IACpB,0FAA0F;IAC1F,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,qDAAqD;IACrD,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,UAAU,CAAA;IACjB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,SAAS,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,eAAe,EAAE,CAyChF"}

package/dist/lib/skills-discovery.js

@@ -0,0 +1,157 @@
+import { existsSync, readdirSync, realpathSync, statSync } from 'node:fs';
+import { basename, join } from 'node:path';
+/**
+ * Order is load-bearing: when a skill's real directory lies outside every
+ * scanned location (a symlink to somewhere else) the first location that
+ * sees it names its `relativePath`, which becomes its ledger key and server
+ * identity. Append new harnesses at the end; never reorder.
+ */
+/** User-level skill directories, relative to $HOME. */
+export const USER_SKILL_LOCATIONS = [
+    { harness: 'claude', dir: '.claude/skills' },
+    { harness: 'agents', dir: '.agents/skills' },
+    { harness: 'codex', dir: '.codex/skills' },
+    { harness: 'cursor', dir: '.cursor/skills' },
+    { harness: 'gemini', dir: '.gemini/skills' },
+    { harness: 'copilot', dir: '.copilot/skills' },
+    { harness: 'opencode', dir: '.config/opencode/skills' },
+    { harness: 'amp', dir: '.config/agents/skills' },
+    { harness: 'windsurf', dir: '.codeium/windsurf/skills' },
+    { harness: 'grok', dir: '.grok/skills' },
+    { harness: 'kiro', dir: '.kiro/skills' },
+    { harness: 'cline', dir: '.cline/skills' },
+    { harness: 'factory', dir: '.factory/skills' },
+];
+/** Repo-level skill directories, relative to the repository root. */
+export const PROJECT_SKILL_LOCATIONS = [
+    { harness: 'claude', dir: '.claude/skills' },
+    { harness: 'agents', dir: '.agents/skills' },
+    { harness: 'codex', dir: '.codex/skills' },
+    { harness: 'cursor', dir: '.cursor/skills' },
+    { harness: 'gemini', dir: '.gemini/skills' },
+    { harness: 'copilot', dir: '.github/skills' },
+    { harness: 'opencode', dir: '.opencode/skills' },
+    { harness: 'windsurf', dir: '.windsurf/skills' },
+    { harness: 'grok', dir: '.grok/skills' },
+    { harness: 'kiro', dir: '.kiro/skills' },
+    { harness: 'cline', dir: '.cline/skills' },
+    { harness: 'factory', dir: '.factory/skills' },
+];
+export const SKILL_FILE = 'SKILL.md';
+/**
+ * Discover skills under one scope root. Skill directories sit directly under
+ * a location (`.claude/skills/<name>/SKILL.md`); up to two levels of grouping
+ * are allowed so grouped layouts (`~/.claude/skills/synced/<uuid>/<name>`,
+ * Gemini's nested dirs) are found too. Dot-directories are skipped
+ * (`~/.codex/skills/.system` holds Codex's bundled skills, not the user's).
+ */
+export function discoverSkills(options) {
+    const { scope, rootDir } = options;
+    const locations = options.locations ?? (scope === 'user' ? USER_SKILL_LOCATIONS : PROJECT_SKILL_LOCATIONS);
+    const byRealDir = new Map();
+    // A sighting is the real location (not a symlink alias) when its canonical
+    // path is exactly the canonical root plus its relative path.
+    const canonicalRoot = canonical(rootDir);
+    const primaryIsReal = new Map();
+    for (const location of locations) {
+        const base = join(rootDir, ...location.dir.split('/'));
+        if (!isDirectory(base))
+            continue;
+        for (const relative of listSkillDirs(base)) {
+            const dir = join(base, ...relative.split('/'));
+            const realDir = canonical(dir);
+            const relativePath = `${location.dir}/${relative}`;
+            const isReal = realDir === join(canonicalRoot, ...relativePath.split('/'));
+            const existing = byRealDir.get(realDir);
+            if (existing) {
+                if (isReal && !primaryIsReal.get(realDir)) {
+                    promote(existing, { dir, relativePath });
+                    primaryIsReal.set(realDir, true);
+                }
+                addSighting(existing, relativePath, location.harness);
+                continue;
+            }
+            primaryIsReal.set(realDir, isReal);
+            byRealDir.set(realDir, {
+                scope,
+                dir,
+                realDir,
+                relativePath,
+                locations: [relativePath],
+                harnesses: [location.harness],
+                folderName: basename(realDir),
+            });
+        }
+    }
+    return [...byRealDir.values()].sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+}
+/** Record another path / harness the same skill directory was seen through. */
+function addSighting(skill, relativePath, harness) {
+    if (!skill.locations.includes(relativePath))
+        skill.locations.push(relativePath);
+    if (!skill.harnesses.includes(harness))
+        skill.harnesses.push(harness);
+}
+/** Make the real directory (not a symlink alias) the canonical path of a skill. */
+function promote(skill, real) {
+    skill.dir = real.dir;
+    skill.relativePath = real.relativePath;
+    skill.locations = [real.relativePath, ...skill.locations.filter((l) => l !== real.relativePath)];
+}
+/** Grouping levels scanned below a location root (`<group>/<subgroup>/<name>`). */
+const MAX_GROUP_DEPTH = 2;
+/**
+ * Relative skill dirs (posix) under a location root: `<name>`, `<group>/<name>`
+ * or `<group>/<subgroup>/<name>`. A skill directory is a leaf — its subfolders
+ * are its files, never nested skills — and the walk stops at `MAX_GROUP_DEPTH`.
+ */
+function listSkillDirs(base, depth = 0) {
+    const found = [];
+    for (const entry of listVisibleDirs(base)) {
+        const dir = join(base, entry);
+        if (hasSkillFile(dir)) {
+            found.push(entry);
+        }
+        else if (depth < MAX_GROUP_DEPTH) {
+            for (const nested of listSkillDirs(dir, depth + 1))
+                found.push(`${entry}/${nested}`);
+        }
+    }
+    return found;
+}
+function listVisibleDirs(dir) {
+    try {
+        return readdirSync(dir)
+            .filter((name) => !name.startsWith('.'))
+            .filter((name) => isDirectory(join(dir, name)))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+function hasSkillFile(dir) {
+    try {
+        return statSync(join(dir, SKILL_FILE)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function isDirectory(path) {
+    try {
+        return existsSync(path) && statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function canonical(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return path;
+    }
+}
+//# sourceMappingURL=skills-discovery.js.map

package/dist/lib/skills-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-discovery.js","sourceRoot":"","sources":["../../src/lib/skills-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACzE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAoB1C;;;;;GAKG;AAEH,uDAAuD;AACvD,MAAM,CAAC,MAAM,oBAAoB,GAA6B;IAC5D,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE;IAC5C,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE;IAC5C,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE;IAC1C,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE;IAC5C,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE;IAC5C,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,iBAAiB,EAAE;IAC9C,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,yBAAyB,EAAE;IACvD,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,uBAAuB,EAAE;IAChD,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,0BAA0B,EAAE;IACxD,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE;IACxC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE;IACxC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE;IAC1C,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,iBAAiB,EAAE;CAC/C,CAAA;AAED,qEAAqE;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAA6B;IAC/D,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE;IAC5C,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE;IAC5C,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE;IAC1C,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE;IAC5C,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE;IAC5C,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,EAAE;IAC7C,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,kBAAkB,EAAE;IAChD,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,kBAAkB,EAAE;IAChD,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE;IACxC,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE;IACxC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE;IAC1C,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,iBAAiB,EAAE;CAC/C,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAA;AA0BpC;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;IAClC,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAA;IAC1F,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAA;IACpD,2EAA2E;IAC3E,6DAA6D;IAC7D,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;IACxC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAmB,CAAA;IAEhD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;QACtD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YAAE,SAAQ;QAChC,KAAK,MAAM,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;YAC9C,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;YAC9B,MAAM,YAAY,GAAG,GAAG,QAAQ,CAAC,GAAG,IAAI,QAAQ,EAAE,CAAA;YAClD,MAAM,MAAM,GAAG,OAAO,KAAK,IAAI,CAAC,aAAa,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;YAC1E,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACvC,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC1C,OAAO,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAA;oBACxC,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;gBAClC,CAAC;gBACD,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;gBACrD,SAAQ;YACV,CAAC;YACD,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YAClC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE;gBACrB,KAAK;gBACL,GAAG;gBACH,OAAO;gBACP,YAAY;gBACZ,SAAS,EAAE,CAAC,YAAY,CAAC;gBACzB,SAAS,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAC7B,UAAU,EAAE,QAAQ,CAAC,OAAO,CAAC;aAC9B,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAA;AAC7F,CAAC;AAED,+EAA+E;AAC/E,SAAS,WAAW,CAAC,KAAsB,EAAE,YAAoB,EAAE,OAAe;IAChF,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IAC/E,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AACvE,CAAC;AAED,mFAAmF;AACnF,SAAS,OAAO,CAAC,KAAsB,EAAE,IAA2C;IAClF,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;IACpB,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAA;IACtC,KAAK,CAAC,SAAS,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,YAAY,CAAC,CAAC,CAAA;AAClG,CAAC;AAED,mFAAmF;AACnF,MAAM,eAAe,GAAG,CAAC,CAAA;AAEzB;;;;GAIG;AACH,SAAS,aAAa,CAAC,IAAY,EAAE,KAAK,GAAG,CAAC;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,MAAM,KAAK,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAC7B,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACnB,CAAC;aAAM,IAAI,KAAK,GAAG,eAAe,EAAE,CAAC;YACnC,KAAK,MAAM,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,MAAM,EAAE,CAAC,CAAA;QACtF,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,GAAG,CAAC;aACpB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;aACvC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;aAC9C,IAAI,EAAE,CAAA;IACX,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/lib/skills-sync.d.ts

@@ -0,0 +1,66 @@
+import { type SkillSyncResult, type SkillUpload } from './api-client.js';
+import { type DiscoveredSkill, type SkillScope } from './skills-discovery.js';
+/**
+ * The "discover, fingerprint, upload what changed" pipeline behind
+ * `halyard skills sync` and the session-start hook. Change detection is
+ * two-tier: the org-keyed ledger in ~/.halyard/sync-state.json skips
+ * unchanged skills with no network at all, and the server compares the
+ * fingerprint again for anything the ledger missed (fresh machine, --force).
+ */
+export type SkillScopeSelection = SkillScope | 'all';
+export interface SkillsSyncOptions {
+    homeDir: string;
+    /** Repository root for project-scope discovery; omit when not in a repo. */
+    projectRoot?: string;
+    scope: SkillScopeSelection;
+    /** Org bucket for the ledger (orgId, or `api-key:<id>`). */
+    stateKey: string;
+    authHeaders: Record<string, string>;
+    apiUrl: string;
+    dryRun: boolean;
+    /** Ignore the local ledger and let the server decide what changed. */
+    force: boolean;
+    log: (line: string) => void;
+    fetchImpl?: typeof fetch;
+}
+export interface PreparedSkill {
+    skill: DiscoveredSkill;
+    upload: SkillUpload;
+    /** Ledger key: `<scope>:<scopeKey>:<relativePath>`. */
+    ledgerKey: string;
+    /** Non-fatal problems worth telling the author about. */
+    warnings: string[];
+}
+export interface SkillsSyncSummary {
+    found: number;
+    created: number;
+    updated: number;
+    unchanged: number;
+    /** Skipped by the local ledger (already synced at this fingerprint). */
+    skipped: number;
+    /** Unreadable locally, rejected by the server, or lost to a request failure. */
+    failed: number;
+    results: SkillSyncResult[];
+}
+/** Discover every skill in the selected scopes. */
+export declare function discoverSelectedSkills(options: {
+    scope: SkillScopeSelection;
+    homeDir: string;
+    projectRoot?: string;
+}): DiscoveredSkill[];
+/**
+ * Identity of a repo for project-scope skills: the normalized origin remote
+ * (`github.com/owner/repo`) so the same skill synced from two machines is one
+ * entry. A repo with no remote has no shared identity, so it gets a
+ * machine-local one — `local:<basename>:<hash of the real path>` — rather
+ * than a bare basename that every other remote-less `api` repo would share.
+ */
+export declare function projectScopeKey(projectRoot: string): string;
+/**
+ * Read, parse and fingerprint one discovered skill into its upload payload.
+ * Throws when the skill cannot be uploaded at all (unreadable, or a body the
+ * server would reject); softer problems come back as `warnings`.
+ */
+export declare function prepareSkill(skill: DiscoveredSkill, scopeKey: string): PreparedSkill;
+export declare function runSkillsSync(options: SkillsSyncOptions): Promise<SkillsSyncSummary>;
+//# sourceMappingURL=skills-sync.d.ts.map

package/dist/lib/skills-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-sync.d.ts","sourceRoot":"","sources":["../../src/lib/skills-sync.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAMpF,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,uBAAuB,CAAA;AAS9B;;;;;;GAMG;AAEH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,KAAK,CAAA;AAEpD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,mBAAmB,CAAA;IAC1B,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,sEAAsE;IACtE,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,eAAe,CAAA;IACtB,MAAM,EAAE,WAAW,CAAA;IACnB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAA;IACf,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,eAAe,EAAE,CAAA;CAC3B;AAUD,mDAAmD;AACnD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,KAAK,EAAE,mBAAmB,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,eAAe,EAAE,CASpB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAW3D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAsDpF;AAuID,wBAAsB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuC1F"}