@nameczz/skill-sync 0.1.0

package/dist/src/sessionUsage.js

@@ -0,0 +1,180 @@
+import { createHash } from "node:crypto";
+import { existsSync } from "node:fs";
+import { mkdir, open, readFile, readdir, stat, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+import { extractSkillFilePathIdsFromText } from "./skillMentions.js";
+import { readUsageEvents, recordUsageEvent } from "./usage.js";
+import { expandHome } from "./paths.js";
+const STATE_FILE = "usage-session-scan.json";
+const STATE_SCHEMA_VERSION = 2;
+const INITIAL_SCAN_BYTES = 5 * 1024 * 1024;
+const MAX_SEEN_KEYS = 1000;
+const MAX_SESSION_FILES = 20;
+const RECENT_WINDOW_MS = 24 * 60 * 60 * 1000;
+const INITIAL_RECENT_WINDOW_MS = 7 * RECENT_WINDOW_MS;
+export async function recordUsageFromCodexSessions(config, options = {}) {
+    const { state, isInitialScan } = await readSessionState(config.cacheDir);
+    const files = await findCandidateSessionFiles(options, {
+        maxSessionFiles: isInitialScan ? Number.POSITIVE_INFINITY : MAX_SESSION_FILES,
+        recentWindowMs: isInitialScan ? INITIAL_RECENT_WINDOW_MS : RECENT_WINDOW_MS
+    });
+    if (files.length === 0) {
+        return { scannedFiles: 0, recorded: 0, skillIds: [] };
+    }
+    const seen = new Set(state.seen);
+    const existingEvents = new Set((await readUsageEvents(config.syncRepo)).map((event) => `${event.skillId}:${event.invokedAt}`));
+    const recordedSkillIds = new Set();
+    let recorded = 0;
+    for (const filePath of files) {
+        const stats = await stat(filePath).catch(() => null);
+        if (!stats?.isFile()) {
+            continue;
+        }
+        const previous = state.files[filePath];
+        const initialScanBytes = options.initialScanBytes ?? INITIAL_SCAN_BYTES;
+        const start = previous ? Math.min(previous.offset, stats.size) : Math.max(0, stats.size - initialScanBytes);
+        const lines = await readJsonlTail(filePath, start, stats.size);
+        for (const line of lines) {
+            for (const signal of toSessionUsageSignals(line, config)) {
+                for (const skillId of signal.skillIds) {
+                    const key = usageSeenKey(filePath, signal.timestamp, skillId, signal.message);
+                    if (seen.has(key)) {
+                        continue;
+                    }
+                    seen.add(key);
+                    if (existingEvents.has(`${skillId}:${signal.timestamp}`)) {
+                        continue;
+                    }
+                    await recordUsageEvent(config, skillId, { invokedAt: signal.timestamp });
+                    existingEvents.add(`${skillId}:${signal.timestamp}`);
+                    recorded += 1;
+                    recordedSkillIds.add(skillId);
+                }
+            }
+        }
+        state.files[filePath] = { offset: stats.size };
+    }
+    state.seen = [...seen].slice(-MAX_SEEN_KEYS);
+    await writeSessionState(config.cacheDir, state);
+    return {
+        scannedFiles: files.length,
+        recorded,
+        skillIds: [...recordedSkillIds].sort((a, b) => a.localeCompare(b))
+    };
+}
+async function findCandidateSessionFiles(options, scanPolicy) {
+    const env = options.env ?? process.env;
+    const home = options.homeDir ?? homedir();
+    const codexHome = path.resolve(expandHome(env.SKILL_SYNC_CODEX_HOME ?? env.CSM_CODEX_HOME ?? env.CODEX_HOME ?? "~/.codex", home));
+    const sessionsDir = path.join(codexHome, "sessions");
+    if (!existsSync(sessionsDir)) {
+        return [];
+    }
+    const allFiles = await listJsonlFiles(sessionsDir);
+    const threadId = options.threadId === undefined ? env.CODEX_THREAD_ID : options.threadId ?? undefined;
+    const now = options.now ?? (() => new Date());
+    const cutoff = now().getTime() - scanPolicy.recentWindowMs;
+    const candidates = await Promise.all(allFiles.map(async (filePath) => {
+        const stats = await stat(filePath).catch(() => null);
+        if (!stats?.isFile()) {
+            return null;
+        }
+        return { filePath, mtimeMs: stats.mtimeMs };
+    }));
+    return candidates
+        .filter((entry) => entry !== null)
+        .filter((entry) => (threadId ? path.basename(entry.filePath).includes(threadId) : entry.mtimeMs >= cutoff))
+        .sort((a, b) => b.mtimeMs - a.mtimeMs)
+        .slice(0, scanPolicy.maxSessionFiles)
+        .map((entry) => entry.filePath);
+}
+async function listJsonlFiles(root) {
+    const entries = await readdir(root, { withFileTypes: true }).catch(() => []);
+    const files = [];
+    for (const entry of entries) {
+        const entryPath = path.join(root, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...(await listJsonlFiles(entryPath)));
+            continue;
+        }
+        if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+            files.push(entryPath);
+        }
+    }
+    return files;
+}
+async function readJsonlTail(filePath, start, end) {
+    if (end <= start) {
+        return [];
+    }
+    const length = end - start;
+    const handle = await open(filePath, "r");
+    try {
+        const buffer = Buffer.alloc(length);
+        const result = await handle.read(buffer, 0, length, start);
+        const lines = buffer.subarray(0, result.bytesRead).toString("utf8").split(/\r?\n/);
+        if (start > 0) {
+            lines.shift();
+        }
+        return lines.map((line) => line.trim()).filter(Boolean);
+    }
+    finally {
+        await handle.close();
+    }
+}
+function toSessionUsageSignals(line, config) {
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        return [];
+    }
+    if (!parsed || typeof parsed !== "object") {
+        return [];
+    }
+    const event = parsed;
+    if (typeof event.timestamp !== "string" || Number.isNaN(new Date(event.timestamp).getTime())) {
+        return [];
+    }
+    const payload = event.payload;
+    if (!payload || typeof payload !== "object") {
+        return [];
+    }
+    const payloadType = payload.type;
+    if (event.type === "response_item" && payloadType === "function_call") {
+        const args = payload.arguments;
+        if (typeof args !== "string" || !args.trim()) {
+            return [];
+        }
+        return [{ timestamp: event.timestamp, message: args, skillIds: extractSkillFilePathIdsFromText(args, config) }];
+    }
+    return [];
+}
+async function readSessionState(cacheDir) {
+    const filePath = path.join(cacheDir, STATE_FILE);
+    const raw = await readFile(filePath, "utf8").catch(() => "");
+    if (!raw.trim()) {
+        return { state: { schemaVersion: STATE_SCHEMA_VERSION, files: {}, seen: [] }, isInitialScan: true };
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed.schemaVersion === STATE_SCHEMA_VERSION && parsed.files && typeof parsed.files === "object" && Array.isArray(parsed.seen)) {
+            return { state: parsed, isInitialScan: false };
+        }
+    }
+    catch {
+        // Ignore corrupt local cache and rebuild it from current session tails.
+    }
+    return { state: { schemaVersion: STATE_SCHEMA_VERSION, files: {}, seen: [] }, isInitialScan: true };
+}
+async function writeSessionState(cacheDir, state) {
+    await mkdir(cacheDir, { recursive: true });
+    await writeFile(path.join(cacheDir, STATE_FILE), `${JSON.stringify(state, null, 2)}\n`, "utf8");
+}
+function usageSeenKey(filePath, timestamp, skillId, message) {
+    const messageHash = createHash("sha256").update(message).digest("hex").slice(0, 16);
+    return `${filePath}:${timestamp}:${skillId}:${messageHash}`;
+}
+//# sourceMappingURL=sessionUsage.js.map

package/dist/src/sessionUsage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionUsage.js","sourceRoot":"","sources":["../../src/sessionUsage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAE1D,MAAM,UAAU,GAAG,yBAAyB,CAAC;AAC7C,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAC/B,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC3C,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC7C,MAAM,wBAAwB,GAAG,CAAC,GAAG,gBAAgB,CAAC;AAoBtD,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,MAAmB,EAAE,UAA+B,EAAE;IACvG,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,MAAM,yBAAyB,CAAC,OAAO,EAAE;QACrD,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB;QAC7E,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,gBAAgB;KAC5E,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAC/H,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC3C,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;YACrB,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,kBAAkB,CAAC;QACxE,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,GAAG,gBAAgB,CAAC,CAAC;QAC5G,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,MAAM,MAAM,IAAI,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;gBACzD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;oBAC9E,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBAClB,SAAS;oBACX,CAAC;oBAED,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACd,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC;wBACzD,SAAS;oBACX,CAAC;oBAED,MAAM,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;oBACzE,cAAc,CAAC,GAAG,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;oBACrD,QAAQ,IAAI,CAAC,CAAC;oBACd,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,CAAC;IAC7C,MAAM,iBAAiB,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAEhD,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,MAAM;QAC1B,QAAQ;QACR,QAAQ,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,OAA4B,EAC5B,UAA+D;IAE/D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,qBAAqB,IAAI,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,UAAU,IAAI,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IAClI,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAErD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC;IACtG,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,cAAc,CAAC;IAE3D,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9C,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,UAAU;SACd,MAAM,CAAC,CAAC,KAAK,EAAkD,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;SACjF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC;SAC1G,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;SACrC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,eAAe,CAAC;SACpC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACjD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,KAAa,EAAE,GAAW;IACvE,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnF,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;QAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1D,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY,EAAE,MAAmB;IAC9D,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,MAAoE,CAAC;IACnF,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC7F,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,WAAW,GAAI,OAA8B,CAAC,IAAI,CAAC;IACzD,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,WAAW,KAAK,eAAe,EAAE,CAAC;QACtE,MAAM,IAAI,GAAI,OAAmC,CAAC,SAAS,CAAC;QAC5D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,+BAA+B,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAClH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QAChB,OAAO,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,oBAAoB,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IACtG,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;QACpD,IAAI,MAAM,CAAC,aAAa,KAAK,oBAAoB,IAAI,MAAM,CAAC,KAAK,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACpI,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;QACjD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;IAC1E,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,oBAAoB,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;AACtG,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAAwB;IACzE,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,SAAiB,EAAE,OAAe,EAAE,OAAe;IACzF,MAAM,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpF,OAAO,GAAG,QAAQ,IAAI,SAAS,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;AAC9D,CAAC"}

package/dist/src/skillDependencies.d.ts

@@ -0,0 +1,2 @@
+import type { DependencyInstallResult } from "./types.js";
+export declare function ensureSkillDependenciesInstalled(skillPath: string): Promise<DependencyInstallResult>;

package/dist/src/skillDependencies.js

@@ -0,0 +1,56 @@
+import { existsSync } from "node:fs";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import path from "node:path";
+const execFileAsync = promisify(execFile);
+const managerPrecedence = [
+    { packageManager: "pnpm", lockFile: "pnpm-lock.yaml" },
+    { packageManager: "yarn", lockFile: "yarn.lock" },
+    { packageManager: "bun", lockFile: "bun.lockb" },
+    { packageManager: "bun", lockFile: "bun.lock" },
+    { packageManager: "npm", lockFile: "package-lock.json" }
+];
+export async function ensureSkillDependenciesInstalled(skillPath) {
+    const packageJsonPath = path.join(skillPath, "package.json");
+    if (!existsSync(packageJsonPath)) {
+        return {
+            status: "skipped-no-package-json",
+            packageManager: null,
+            command: "",
+            message: "No package.json found; skipped dependency installation."
+        };
+    }
+    const nodeModulesPath = path.join(skillPath, "node_modules");
+    if (existsSync(nodeModulesPath)) {
+        return {
+            status: "skipped-existing-node-modules",
+            packageManager: null,
+            command: "",
+            message: "node_modules already exists; skipped dependency installation."
+        };
+    }
+    const packageManager = detectPackageManager(skillPath);
+    const command = `${packageManager} install`;
+    try {
+        await execFileAsync(packageManager, ["install"], { cwd: skillPath });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Dependency install failed for ${path.basename(skillPath)} using ${command}: ${message}`);
+    }
+    return {
+        status: "installed",
+        packageManager,
+        command,
+        message: `Installed dependencies with ${command}.`
+    };
+}
+function detectPackageManager(skillPath) {
+    for (const entry of managerPrecedence) {
+        if (existsSync(path.join(skillPath, entry.lockFile))) {
+            return entry.packageManager;
+        }
+    }
+    return "npm";
+}
+//# sourceMappingURL=skillDependencies.js.map

package/dist/src/skillDependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillDependencies.js","sourceRoot":"","sources":["../../src/skillDependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAO1C,MAAM,iBAAiB,GAA4B;IACjD,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE;IACtD,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE;IACjD,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE;IAChD,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE;IAC/C,EAAE,cAAc,EAAE,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE;CACzD,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gCAAgC,CAAC,SAAiB;IACtE,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAC7D,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,MAAM,EAAE,yBAAyB;YACjC,cAAc,EAAE,IAAI;YACpB,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,yDAAyD;SACnE,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAC7D,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,OAAO;YACL,MAAM,EAAE,+BAA+B;YACvC,cAAc,EAAE,IAAI;YACpB,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,+DAA+D;SACzE,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,GAAG,cAAc,UAAU,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,cAAc,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IACvE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,UAAU,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,cAAc;QACd,OAAO;QACP,OAAO,EAAE,+BAA+B,OAAO,GAAG;KACnD,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,SAAiB;IAC7C,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;QACtC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACrD,OAAO,KAAK,CAAC,cAAc,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/skillMentions.d.ts

@@ -0,0 +1,3 @@
+import type { LocalConfig } from "./types.js";
+export declare function extractSkillIdsFromText(text: string, config: LocalConfig): string[];
+export declare function extractSkillFilePathIdsFromText(text: string, config: LocalConfig): string[];

package/dist/src/skillMentions.js

@@ -0,0 +1,111 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { validateSkillId } from "./paths.js";
+export function extractSkillIdsFromText(text, config) {
+    const candidates = new Set();
+    const roots = [config.codexSkillsDir, config.agentsSkillsDir].map((root) => path.resolve(root));
+    for (const skillId of extractSkillFilePathIdsFromText(text, config)) {
+        addValidSkillId(candidates, skillId);
+    }
+    for (const skillId of extractRelativeSkillIds(text, [".codex/skills/", ".agents/skills/"])) {
+        addValidSkillId(candidates, skillId);
+    }
+    for (const skillId of extractDollarSkillIds(text, roots)) {
+        addValidSkillId(candidates, skillId);
+    }
+    return [...candidates].sort((a, b) => a.localeCompare(b));
+}
+export function extractSkillFilePathIdsFromText(text, config) {
+    const candidates = new Set();
+    const roots = [config.codexSkillsDir, config.agentsSkillsDir].map((root) => path.resolve(root));
+    for (const rawPath of extractSkillFilePaths(text)) {
+        const decodedPath = decodeSkillPath(rawPath);
+        if (!decodedPath) {
+            continue;
+        }
+        const absolutePath = path.isAbsolute(decodedPath) ? path.resolve(decodedPath) : decodedPath;
+        for (const root of roots) {
+            if (!path.isAbsolute(absolutePath)) {
+                continue;
+            }
+            const skillDir = path.dirname(absolutePath);
+            const relative = path.relative(root, skillDir);
+            if (!relative || relative.startsWith("..") || path.isAbsolute(relative)) {
+                continue;
+            }
+            addValidSkillId(candidates, relative.split(path.sep).join("/"));
+        }
+    }
+    return [...candidates].sort((a, b) => a.localeCompare(b));
+}
+function extractSkillFilePaths(text) {
+    const paths = [];
+    const markdownLinkPattern = /\]\(([^)\s]+?\/SKILL\.md)(?:#[^)]+)?\)/g;
+    const plainPathPattern = /((?:file:\/\/)?(?:~|\/|[A-Za-z]:[\\/])[^\s'"()<>]*?\/SKILL\.md)/g;
+    for (const match of text.matchAll(markdownLinkPattern)) {
+        if (match[1]) {
+            paths.push(match[1]);
+        }
+    }
+    for (const match of text.matchAll(plainPathPattern)) {
+        if (match[1]) {
+            paths.push(match[1]);
+        }
+    }
+    return paths;
+}
+function extractRelativeSkillIds(text, rootMarkers) {
+    const skillIds = [];
+    for (const marker of rootMarkers) {
+        let index = text.indexOf(marker);
+        while (index !== -1) {
+            const start = index + marker.length;
+            const endMarker = "/SKILL.md";
+            const end = text.indexOf(endMarker, start);
+            if (end !== -1) {
+                skillIds.push(text.slice(start, end));
+            }
+            index = text.indexOf(marker, start);
+        }
+    }
+    return skillIds;
+}
+function extractDollarSkillIds(text, roots) {
+    const skillIds = new Set();
+    const pattern = /(^|[^\w/.-])\$([A-Za-z0-9][A-Za-z0-9_-]*(?:\/[A-Za-z0-9][A-Za-z0-9_-]*)*)\b/g;
+    for (const match of text.matchAll(pattern)) {
+        const candidate = match[2];
+        if (!candidate) {
+            continue;
+        }
+        let skillId;
+        try {
+            skillId = validateSkillId(candidate);
+        }
+        catch {
+            continue;
+        }
+        if (roots.some((root) => existsSync(path.join(root, ...skillId.split("/"), "SKILL.md")))) {
+            skillIds.add(skillId);
+        }
+    }
+    return [...skillIds];
+}
+function decodeSkillPath(rawPath) {
+    const withoutFileProtocol = rawPath.startsWith("file://") ? rawPath.slice("file://".length) : rawPath;
+    try {
+        return decodeURIComponent(withoutFileProtocol);
+    }
+    catch {
+        return withoutFileProtocol;
+    }
+}
+function addValidSkillId(candidates, skillId) {
+    try {
+        candidates.add(validateSkillId(skillId));
+    }
+    catch {
+        // Ignore non-user skill roots and malformed paths.
+    }
+}
+//# sourceMappingURL=skillMentions.js.map

package/dist/src/skillMentions.js.map

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

package/dist/src/status.d.ts

@@ -0,0 +1,3 @@
+import type { LocalConfig, StatusReport, SyncState } from "./types.js";
+export declare function buildStatusReport(config: LocalConfig): Promise<StatusReport>;
+export declare function deriveSyncState(lastSyncedHash: string | null, currentLocalHash: string | null, currentRepoHash: string | null): SyncState;

package/dist/src/status.js

@@ -0,0 +1,134 @@
+import { repoSkillsDir } from "./paths.js";
+import { readSkillsMetadata } from "./metadata.js";
+import { scanSkills } from "./scanner.js";
+import { getLastUsageBySkill } from "./usage.js";
+export async function buildStatusReport(config) {
+    const metadata = await readSkillsMetadata(config.syncRepo);
+    const managedRecords = metadata.skills.filter((skill) => skill.status === "managed");
+    const codexSkills = await scanSkills(config.codexSkillsDir, "codex");
+    const agentsSkills = await scanSkills(config.agentsSkillsDir, "agents");
+    const localSkills = [...codexSkills, ...agentsSkills].sort(compareScannedSkills);
+    const repoSkills = await scanSkills(repoSkillsDir(config.syncRepo), "repo");
+    const localById = groupLocalSkills(localSkills);
+    const repoById = new Map(repoSkills.map((skill) => [skill.id, skill]));
+    const managedIds = new Set(managedRecords.map((skill) => skill.id));
+    const allSkillIds = uniqueSkillIds([...managedRecords, ...localSkills, ...repoSkills].map((skill) => skill.id));
+    const lastUsedBySkill = await getLastUsageBySkill(config.syncRepo, allSkillIds);
+    const managed = managedRecords.map((record) => {
+        const localCandidates = localById.get(record.id) ?? [];
+        return refreshRecord(record, findLocalSkill(record, localById), localCandidates, repoById.get(record.id), lastUsedBySkill.get(record.id) ?? null);
+    });
+    const unmanagedLocal = withLastUsedAt(localSkills.filter((skill) => !managedIds.has(skill.id)), lastUsedBySkill);
+    const repoOnly = withLastUsedAt(repoSkills.filter((skill) => !managedIds.has(skill.id)), lastUsedBySkill);
+    return {
+        syncRepo: config.syncRepo,
+        codexSkillsDir: config.codexSkillsDir,
+        agentsSkillsDir: config.agentsSkillsDir,
+        managed,
+        unmanagedLocal,
+        repoOnly
+    };
+}
+function uniqueSkillIds(skillIds) {
+    return [...new Set(skillIds)].sort((a, b) => a.localeCompare(b));
+}
+function withLastUsedAt(skills, lastUsedBySkill) {
+    return skills.map((skill) => ({
+        ...skill,
+        lastUsedAt: lastUsedBySkill.get(skill.id) ?? null
+    }));
+}
+function compareScannedSkills(a, b) {
+    return a.id.localeCompare(b.id) || a.source.localeCompare(b.source);
+}
+function refreshRecord(record, local, localCandidates, repo, lastUsedAt) {
+    const currentLocalHash = currentLocalHashForCandidates(local, localCandidates);
+    const currentRepoHash = repo?.hash ?? null;
+    const installed = localCandidates.length > 0;
+    const localSources = localCandidates
+        .map((candidate) => candidate.source)
+        .filter((source) => source === "codex" || source === "agents")
+        .sort((a, b) => a.localeCompare(b));
+    const localCopiesDiffer = localCandidateHashes(localCandidates).length > 1;
+    return {
+        ...record,
+        lastUsedAt,
+        name: repo?.name ?? local?.name ?? record.name,
+        description: repo?.description ?? local?.description ?? record.description,
+        localSource: local?.source === "codex" || local?.source === "agents" ? local.source : record.localSource ?? null,
+        localSources,
+        localCopiesDiffer,
+        localModifiedAt: latestLocalModifiedAt(localCandidates),
+        installed,
+        syncState: localCopiesDiffer ? "conflict" : deriveSyncState(record.lastSyncedHash, currentLocalHash, currentRepoHash),
+        currentLocalHash,
+        currentRepoHash
+    };
+}
+function currentLocalHashForCandidates(local, localCandidates) {
+    const hashes = localCandidateHashes(localCandidates);
+    if (hashes.length === 1) {
+        return hashes[0] ?? null;
+    }
+    return local?.hash ?? null;
+}
+function localCandidateHashes(localCandidates) {
+    return [...new Set(localCandidates.map((candidate) => candidate.hash))].sort();
+}
+function latestLocalModifiedAt(localCandidates) {
+    if (localCandidates.length === 0) {
+        return null;
+    }
+    return localCandidates
+        .map((skill) => skill.modifiedAt)
+        .sort((a, b) => new Date(b).getTime() - new Date(a).getTime())[0] ?? null;
+}
+function groupLocalSkills(skills) {
+    const grouped = new Map();
+    for (const skill of skills) {
+        const existing = grouped.get(skill.id) ?? [];
+        existing.push(skill);
+        grouped.set(skill.id, existing);
+    }
+    return grouped;
+}
+function findLocalSkill(record, localById) {
+    const candidates = localById.get(record.id) ?? [];
+    if (record.localSource) {
+        const preferred = candidates.find((skill) => skill.source === record.localSource);
+        if (preferred) {
+            return preferred;
+        }
+    }
+    return candidates.find((skill) => skill.source === "codex") ?? candidates.find((skill) => skill.source === "agents");
+}
+export function deriveSyncState(lastSyncedHash, currentLocalHash, currentRepoHash) {
+    if (!currentLocalHash && currentRepoHash) {
+        return "missing_local";
+    }
+    if (currentLocalHash && !currentRepoHash) {
+        return "missing_repo";
+    }
+    if (!currentLocalHash && !currentRepoHash) {
+        return "missing_repo";
+    }
+    if (currentLocalHash === currentRepoHash) {
+        return "clean";
+    }
+    if (!lastSyncedHash) {
+        return "conflict";
+    }
+    const localChanged = currentLocalHash !== lastSyncedHash;
+    const repoChanged = currentRepoHash !== lastSyncedHash;
+    if (localChanged && repoChanged) {
+        return "conflict";
+    }
+    if (localChanged) {
+        return "local_modified";
+    }
+    if (repoChanged) {
+        return "repo_modified";
+    }
+    return "clean";
+}
+//# sourceMappingURL=status.js.map

package/dist/src/status.js.map

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

package/dist/src/stopSyncingSkill.d.ts

@@ -0,0 +1,2 @@
+import type { LocalConfig, SkillRecord } from "./types.js";
+export declare function stopSyncingSkill(config: LocalConfig, skillId: string): Promise<SkillRecord>;

package/dist/src/stopSyncingSkill.js

@@ -0,0 +1,31 @@
+import { existsSync } from "node:fs";
+import { rm } from "node:fs/promises";
+import path from "node:path";
+import { repoSkillsDir } from "./paths.js";
+import { readSkillsMetadata, writeSkillsMetadata } from "./metadata.js";
+import { validateSkillId } from "./paths.js";
+export async function stopSyncingSkill(config, skillId) {
+    const id = validateSkillId(skillId);
+    const metadata = await readSkillsMetadata(config.syncRepo);
+    const index = metadata.skills.findIndex((record) => record.id === id);
+    if (index === -1) {
+        throw new Error(`Managed skill not found in metadata: ${id}`);
+    }
+    const existing = metadata.skills[index] ?? null;
+    if (!existing) {
+        throw new Error(`Managed skill not found in metadata: ${id}`);
+    }
+    const skillsPath = repoSkillsDir(config.syncRepo);
+    const repoPath = path.join(skillsPath, ...id.split("/"));
+    if (existsSync(repoPath)) {
+        await rm(repoPath, { recursive: true, force: true });
+    }
+    const [removed] = metadata.skills.splice(index, 1);
+    await writeSkillsMetadata(config.syncRepo, metadata);
+    return {
+        ...removed,
+        status: "managed",
+        updatedAt: new Date().toISOString()
+    };
+}
+//# sourceMappingURL=stopSyncingSkill.js.map

package/dist/src/stopSyncingSkill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stopSyncingSkill.js","sourceRoot":"","sources":["../../src/stopSyncingSkill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAmB,EAAE,OAAe;IACzE,MAAM,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACtE,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wCAAwC,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,wCAAwC,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACnD,MAAM,mBAAmB,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAErD,OAAO;QACL,GAAG,OAAO;QACV,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/src/sync.d.ts

@@ -0,0 +1,48 @@
+import type { LocalConfig, LocalSkillSource } from "./types.js";
+import { type GitBranchSyncStatus } from "./git.js";
+export type SyncSelection = {
+    skillId: string;
+    source?: LocalSkillSource;
+};
+export type SyncResult = {
+    skillIds: string[];
+    updatedRepoSkillIds: string[];
+    committed: boolean;
+    pushed: boolean;
+    commitHash: string | null;
+    commitMessage: string;
+    gitStatus: string;
+};
+export type PullRepositoryResult = {
+    pulled: true;
+    preSync: SyncResult | null;
+    gitStatus: string;
+    gitBranchStatus: GitBranchSyncStatus;
+};
+export type RepositoryConflictSource = "github" | "syncRepo" | LocalSkillSource;
+export type RepositoryConflictVersion = {
+    source: RepositoryConflictSource;
+    label: string;
+    path: string;
+    exists: boolean;
+    content: string | null;
+};
+export type RepositorySkillConflict = {
+    skillId: string;
+    files: string[];
+    versions: RepositoryConflictVersion[];
+};
+export type RepositoryConflictsResult = {
+    gitBranchStatus: GitBranchSyncStatus;
+    conflicts: RepositorySkillConflict[];
+};
+export type RepositoryConflictResolution = {
+    skillId: string;
+    source: RepositoryConflictSource;
+};
+export declare function syncSelectedSkills(config: LocalConfig, selections: SyncSelection[]): Promise<SyncResult>;
+export declare function syncSingleSkill(config: LocalConfig, skillId: string): Promise<SyncResult>;
+export declare function syncRepositoryChanges(config: LocalConfig): Promise<SyncResult>;
+export declare function pullRepositoryChanges(config: LocalConfig): Promise<PullRepositoryResult>;
+export declare function listRepositoryConflicts(config: LocalConfig): Promise<RepositoryConflictsResult>;
+export declare function resolveRepositoryConflicts(config: LocalConfig, resolutions: RepositoryConflictResolution[]): Promise<PullRepositoryResult>;