@nameczz/skill-sync 0.1.0

package/dist/src/importSkill.js

@@ -0,0 +1,58 @@
+import { existsSync } from "node:fs";
+import { rm } from "node:fs/promises";
+import path from "node:path";
+import { copySkillDirectory } from "./copy.js";
+import { hashDirectory } from "./hash.js";
+import { readSkillFrontmatter } from "./frontmatter.js";
+import { repoSkillsDir, resolveSkillPath, validateSkillId } from "./paths.js";
+import { upsertSkillRecord } from "./metadata.js";
+export async function importLocalSkill(config, skillId, options = {}) {
+    const id = validateSkillId(skillId);
+    const localSource = options.source ?? findExistingLocalSource(config, id);
+    const localPath = resolveSkillPath(localRootForSource(config, localSource), id);
+    const targetPath = resolveSkillPath(repoSkillsDir(config.syncRepo), id);
+    if (!existsSync(path.join(localPath, "SKILL.md"))) {
+        throw new Error(`Local skill not found: ${localPath}`);
+    }
+    if (existsSync(targetPath)) {
+        if (!options.force) {
+            throw new Error(`Repo skill already exists: ${targetPath}. Re-run with --force to overwrite.`);
+        }
+        await rm(targetPath, { recursive: true, force: true });
+    }
+    await copySkillDirectory(localPath, targetPath);
+    const hash = await hashDirectory(targetPath);
+    const frontmatter = await readSkillFrontmatter(targetPath);
+    const now = new Date().toISOString();
+    const record = {
+        id,
+        name: frontmatter.name,
+        description: frontmatter.description,
+        status: "managed",
+        localSource,
+        installed: true,
+        syncState: "clean",
+        lastSyncedHash: hash,
+        currentRepoHash: hash,
+        currentLocalHash: hash,
+        lastUsedAt: null,
+        createdAt: now,
+        updatedAt: now
+    };
+    await upsertSkillRecord(config.syncRepo, record);
+    return record;
+}
+function findExistingLocalSource(config, id) {
+    const sources = ["codex", "agents"];
+    for (const source of sources) {
+        const candidate = resolveSkillPath(localRootForSource(config, source), id);
+        if (existsSync(path.join(candidate, "SKILL.md"))) {
+            return source;
+        }
+    }
+    return "codex";
+}
+function localRootForSource(config, source) {
+    return source === "agents" ? config.agentsSkillsDir : config.codexSkillsDir;
+}
+//# sourceMappingURL=importSkill.js.map

package/dist/src/importSkill.js.map

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

package/dist/src/init.d.ts

@@ -0,0 +1,5 @@
+import type { InitConfigOptions } from "./config.js";
+export declare function initialize(options?: InitConfigOptions): Promise<{
+    config: import("./types.js").LocalConfig;
+    gitInitialized: boolean;
+}>;

package/dist/src/init.js

@@ -0,0 +1,13 @@
+import { mkdir } from "node:fs/promises";
+import { createLocalConfig } from "./config.js";
+import { ensureRepoMetadata } from "./metadata.js";
+import { ensureGitRepository } from "./git.js";
+export async function initialize(options = {}) {
+    const config = await createLocalConfig(options);
+    await mkdir(config.codexSkillsDir, { recursive: true });
+    await mkdir(config.agentsSkillsDir, { recursive: true });
+    await ensureRepoMetadata(config.syncRepo);
+    const gitInitialized = await ensureGitRepository(config.syncRepo);
+    return { config, gitInitialized };
+}
+//# sourceMappingURL=init.js.map

package/dist/src/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAA6B,EAAE;IAC9D,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,KAAK,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,KAAK,CAAC,MAAM,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,cAAc,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;AACpC,CAAC"}

package/dist/src/installSkill.d.ts

@@ -0,0 +1,6 @@
+import type { InstallRepoSkillResult, LocalConfig, LocalSkillSource } from "./types.js";
+export type InstallOptions = {
+    force?: boolean;
+    source?: LocalSkillSource;
+};
+export declare function installRepoSkill(config: LocalConfig, skillId: string, options?: InstallOptions): Promise<InstallRepoSkillResult>;

package/dist/src/installSkill.js

@@ -0,0 +1,62 @@
+import { existsSync } from "node:fs";
+import { rm } from "node:fs/promises";
+import path from "node:path";
+import { ensureSkillDependenciesInstalled } from "./skillDependencies.js";
+import { copySkillDirectory } from "./copy.js";
+import { hashDirectory } from "./hash.js";
+import { readSkillsMetadata, upsertSkillRecord } from "./metadata.js";
+import { repoSkillsDir, resolveSkillPath, validateSkillId } from "./paths.js";
+import { readSkillFrontmatter } from "./frontmatter.js";
+export async function installRepoSkill(config, skillId, options = {}) {
+    const id = validateSkillId(skillId);
+    const metadata = await readSkillsMetadata(config.syncRepo);
+    const existing = metadata.skills.find((skill) => skill.id === id && skill.status === "managed");
+    if (!existing) {
+        throw new Error(`Managed skill not found in metadata: ${id}`);
+    }
+    const sourcePath = resolveSkillPath(repoSkillsDir(config.syncRepo), id);
+    const localSource = options.source ?? existing.localSource ?? "codex";
+    const targetPath = resolveSkillPath(localRootForSource(config, localSource), id);
+    if (!existsSync(path.join(sourcePath, "SKILL.md"))) {
+        throw new Error(`Repo skill not found: ${sourcePath}`);
+    }
+    if (existsSync(targetPath)) {
+        if (!options.force) {
+            throw new Error(`Local skill already exists: ${targetPath}. Re-run with --force to overwrite.`);
+        }
+        await rm(targetPath, { recursive: true, force: true });
+    }
+    await copySkillDirectory(sourcePath, targetPath);
+    const hash = await hashDirectory(sourcePath);
+    const frontmatter = await readSkillFrontmatter(sourcePath);
+    const now = new Date().toISOString();
+    const record = {
+        ...existing,
+        name: frontmatter.name,
+        description: frontmatter.description,
+        localSource,
+        installed: true,
+        syncState: "clean",
+        lastSyncedHash: hash,
+        currentRepoHash: hash,
+        currentLocalHash: hash,
+        lastUsedAt: existing.lastUsedAt ?? null,
+        updatedAt: now
+    };
+    const dependencyInstall = await installDependencies(targetPath, record.id);
+    await upsertSkillRecord(config.syncRepo, record);
+    return { record, dependencyInstall };
+}
+function localRootForSource(config, source) {
+    return source === "agents" ? config.agentsSkillsDir : config.codexSkillsDir;
+}
+async function installDependencies(skillPath, skillId) {
+    try {
+        return await ensureSkillDependenciesInstalled(skillPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to install dependencies for ${skillId}: ${message}`);
+    }
+}
+//# sourceMappingURL=installSkill.js.map

package/dist/src/installSkill.js.map

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

package/dist/src/json.d.ts

@@ -0,0 +1,2 @@
+export declare function readJsonFile<T>(filePath: string): Promise<T>;
+export declare function writeJsonFile(filePath: string, value: unknown): Promise<void>;

package/dist/src/json.js

@@ -0,0 +1,11 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+export async function readJsonFile(filePath) {
+    const raw = await readFile(filePath, "utf8");
+    return JSON.parse(raw);
+}
+export async function writeJsonFile(filePath, value) {
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+//# sourceMappingURL=json.js.map

package/dist/src/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB;IACpD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,KAAc;IAClE,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC3E,CAAC"}

package/dist/src/metadata.d.ts

@@ -0,0 +1,11 @@
+import type { SkillRecord, SkillsMetadata } from "./types.js";
+export type LegacyArchiveCleanupResult = {
+    removedArchiveDir: boolean;
+    removedSkillIds: string[];
+};
+export declare function emptySkillsMetadata(): SkillsMetadata;
+export declare function ensureRepoMetadata(syncRepo: string): Promise<void>;
+export declare function readSkillsMetadata(syncRepo: string): Promise<SkillsMetadata>;
+export declare function cleanupLegacyArchiveArtifacts(syncRepo: string): Promise<LegacyArchiveCleanupResult>;
+export declare function writeSkillsMetadata(syncRepo: string, metadata: SkillsMetadata): Promise<void>;
+export declare function upsertSkillRecord(syncRepo: string, record: SkillRecord): Promise<void>;

package/dist/src/metadata.js

@@ -0,0 +1,115 @@
+import { existsSync } from "node:fs";
+import { repoSettingsPath, repoSkillsMetadataPath, repoUsageEventsPath } from "./paths.js";
+import { readJsonFile, writeJsonFile } from "./json.js";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+export function emptySkillsMetadata() {
+    return { schemaVersion: 1, skills: [] };
+}
+export async function ensureRepoMetadata(syncRepo) {
+    const now = new Date().toISOString();
+    await mkdir(path.join(syncRepo, "skills"), { recursive: true });
+    await mkdir(path.join(syncRepo, "metadata"), { recursive: true });
+    await ensureGitignore(syncRepo);
+    if (!existsSync(repoSettingsPath(syncRepo))) {
+        const settings = {
+            schemaVersion: 1,
+            createdAt: now,
+            updatedAt: now
+        };
+        await writeJsonFile(repoSettingsPath(syncRepo), settings);
+    }
+    if (!existsSync(repoSkillsMetadataPath(syncRepo))) {
+        await writeJsonFile(repoSkillsMetadataPath(syncRepo), emptySkillsMetadata());
+    }
+    if (!existsSync(repoUsageEventsPath(syncRepo))) {
+        await writeFile(repoUsageEventsPath(syncRepo), "", "utf8");
+    }
+}
+async function ensureGitignore(syncRepo) {
+    const gitignorePath = path.join(syncRepo, ".gitignore");
+    const localCachePattern = ".skill-sync/";
+    const legacyLocalCachePattern = ".codex-skill-manager/";
+    if (!existsSync(gitignorePath)) {
+        await writeFile(gitignorePath, `${localCachePattern}\n${legacyLocalCachePattern}\n`, "utf8");
+        return;
+    }
+    const current = await readFile(gitignorePath, "utf8");
+    const lines = current.split(/\r?\n/).map((line) => line.trim());
+    const missingPatterns = [localCachePattern, legacyLocalCachePattern].filter((pattern) => !lines.includes(pattern));
+    if (missingPatterns.length === 0) {
+        return;
+    }
+    const separator = current.endsWith("\n") || current.length === 0 ? "" : "\n";
+    await writeFile(gitignorePath, `${current}${separator}${missingPatterns.join("\n")}\n`, "utf8");
+}
+export async function readSkillsMetadata(syncRepo) {
+    if (!existsSync(repoSkillsMetadataPath(syncRepo))) {
+        return emptySkillsMetadata();
+    }
+    const metadata = await readJsonFile(repoSkillsMetadataPath(syncRepo));
+    if (metadata.schemaVersion !== 1 || !Array.isArray(metadata.skills)) {
+        throw new Error(`Invalid skills metadata at ${repoSkillsMetadataPath(syncRepo)}.`);
+    }
+    return {
+        schemaVersion: 1,
+        skills: metadata.skills
+            .filter((candidate) => candidate.status !== "archived")
+            .map(normalizeManagedRecord)
+    };
+}
+export async function cleanupLegacyArchiveArtifacts(syncRepo) {
+    const archiveDir = path.join(syncRepo, "archive");
+    const metadataPath = repoSkillsMetadataPath(syncRepo);
+    const removedArchiveDir = existsSync(archiveDir);
+    await rm(archiveDir, { recursive: true, force: true });
+    if (!existsSync(metadataPath)) {
+        return { removedArchiveDir, removedSkillIds: [] };
+    }
+    const metadata = await readJsonFile(metadataPath);
+    if (metadata.schemaVersion !== 1 || !Array.isArray(metadata.skills)) {
+        return { removedArchiveDir, removedSkillIds: [] };
+    }
+    const removedSkillIds = metadata.skills
+        .filter((record) => record.status === "archived")
+        .map((record) => record.id)
+        .filter((id) => typeof id === "string");
+    const cleaned = metadata.skills.filter((record) => record.status !== "archived").map(normalizeManagedRecord);
+    const isChanged = cleaned.length !== metadata.skills.length ||
+        cleaned.some((record, index) => {
+            const original = metadata.skills[index];
+            return record.id !== original?.id || record.status !== original?.status || record.lastUsedAt !== (original?.lastUsedAt ?? null) || Boolean(original && "archivedAt" in original);
+        });
+    if (!isChanged) {
+        return { removedArchiveDir, removedSkillIds };
+    }
+    await writeSkillsMetadata(syncRepo, { schemaVersion: 1, skills: cleaned });
+    return { removedArchiveDir, removedSkillIds };
+}
+export async function writeSkillsMetadata(syncRepo, metadata) {
+    const cleaned = {
+        schemaVersion: 1,
+        skills: metadata.skills.map(normalizeManagedRecord).sort((a, b) => a.id.localeCompare(b.id))
+    };
+    await writeJsonFile(repoSkillsMetadataPath(syncRepo), cleaned);
+}
+export async function upsertSkillRecord(syncRepo, record) {
+    const metadata = await readSkillsMetadata(syncRepo);
+    const index = metadata.skills.findIndex((skill) => skill.id === record.id);
+    if (index === -1) {
+        metadata.skills.push(record);
+    }
+    else {
+        metadata.skills[index] = record;
+    }
+    await writeSkillsMetadata(syncRepo, metadata);
+}
+function normalizeManagedRecord(candidate) {
+    const { archivedAt: _archivedAt, ...record } = candidate;
+    return {
+        ...record,
+        status: "managed",
+        lastUsedAt: record.lastUsedAt ?? null
+    };
+}
+//# sourceMappingURL=metadata.js.map

package/dist/src/metadata.js.map

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

package/dist/src/paths.d.ts

@@ -0,0 +1,22 @@
+export type PathOptions = {
+    homeDir?: string;
+    env?: NodeJS.ProcessEnv;
+};
+export declare function expandHome(input: string, homeDir?: string): string;
+export declare function getDefaultConfigDir(options?: PathOptions): string;
+export declare function getLegacyConfigDir(options?: PathOptions): string;
+export declare function getDefaultCacheDir(options?: PathOptions): string;
+export declare function getDefaultSyncRepo(options?: PathOptions): string;
+export declare function getDefaultCodexSkillsDir(options?: PathOptions): string;
+export declare function getDefaultAgentsSkillsDir(options?: PathOptions): string;
+export declare function configFilePath(configDir: string): string;
+export declare function repoSkillsDir(syncRepo: string): string;
+export declare function repoMetadataDir(syncRepo: string): string;
+export declare function getDefaultCodexArchiveSessionsDir(options?: PathOptions): string;
+export declare function repoSettingsPath(syncRepo: string): string;
+export declare function repoSkillsMetadataPath(syncRepo: string): string;
+export declare function repoUsageEventsPath(syncRepo: string): string;
+export declare function validateSkillId(skillId: string): string;
+export declare function resolveSkillPath(root: string, skillId: string): string;
+export declare function assertInside(targetPath: string, rootPath: string): void;
+export declare function toSkillId(root: string, skillPath: string): string;

package/dist/src/paths.js

@@ -0,0 +1,103 @@
+import path from "node:path";
+import { homedir } from "node:os";
+export function expandHome(input, homeDir = homedir()) {
+    if (input === "~") {
+        return homeDir;
+    }
+    if (input.startsWith("~/")) {
+        return path.join(homeDir, input.slice(2));
+    }
+    return input;
+}
+export function getDefaultConfigDir(options = {}) {
+    const env = options.env ?? process.env;
+    const home = options.homeDir ?? homedir();
+    return path.resolve(expandHome(env.SKILL_SYNC_CONFIG_DIR ?? env.CSM_CONFIG_DIR ?? "~/.skill-sync", home));
+}
+export function getLegacyConfigDir(options = {}) {
+    const env = options.env ?? process.env;
+    const home = options.homeDir ?? homedir();
+    return path.resolve(expandHome(env.CSM_CONFIG_DIR ?? "~/.codex-skill-manager", home));
+}
+export function getDefaultCacheDir(options = {}) {
+    const env = options.env ?? process.env;
+    const home = options.homeDir ?? homedir();
+    return path.resolve(expandHome(env.SKILL_SYNC_CACHE_DIR ?? env.CSM_CACHE_DIR ?? "~/.skill-sync/cache", home));
+}
+export function getDefaultSyncRepo(options = {}) {
+    const env = options.env ?? process.env;
+    const home = options.homeDir ?? homedir();
+    return path.resolve(expandHome(env.SKILL_SYNC_REPO ?? env.CSM_SYNC_REPO ?? "~/skill-sync", home));
+}
+export function getDefaultCodexSkillsDir(options = {}) {
+    const env = options.env ?? process.env;
+    const home = options.homeDir ?? homedir();
+    return path.resolve(expandHome(env.SKILL_SYNC_CODEX_SKILLS_DIR ?? env.CSM_CODEX_SKILLS_DIR ?? "~/.codex/skills", home));
+}
+export function getDefaultAgentsSkillsDir(options = {}) {
+    const env = options.env ?? process.env;
+    const home = options.homeDir ?? homedir();
+    return path.resolve(expandHome(env.SKILL_SYNC_AGENTS_SKILLS_DIR ?? env.CSM_AGENTS_SKILLS_DIR ?? "~/.agents/skills", home));
+}
+export function configFilePath(configDir) {
+    return path.join(configDir, "config.json");
+}
+export function repoSkillsDir(syncRepo) {
+    return path.join(syncRepo, "skills");
+}
+export function repoMetadataDir(syncRepo) {
+    return path.join(syncRepo, "metadata");
+}
+export function getDefaultCodexArchiveSessionsDir(options = {}) {
+    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));
+    return path.join(codexHome, "archived_sessions");
+}
+export function repoSettingsPath(syncRepo) {
+    return path.join(repoMetadataDir(syncRepo), "settings.json");
+}
+export function repoSkillsMetadataPath(syncRepo) {
+    return path.join(repoMetadataDir(syncRepo), "skills.json");
+}
+export function repoUsageEventsPath(syncRepo) {
+    return path.join(repoMetadataDir(syncRepo), "usage-events.jsonl");
+}
+export function validateSkillId(skillId) {
+    const normalized = skillId.replaceAll("\\", "/").replace(/^\/+|\/+$/g, "");
+    if (!normalized) {
+        throw new Error("Skill id cannot be empty.");
+    }
+    const parts = normalized.split("/");
+    if (parts.some((part) => part === "." || part === ".." || part.length === 0)) {
+        throw new Error(`Skill id "${skillId}" contains an invalid path segment.`);
+    }
+    if (normalized.startsWith(".") || normalized.includes("/.")) {
+        throw new Error(`Skill id "${skillId}" cannot target hidden directories.`);
+    }
+    if (path.isAbsolute(skillId)) {
+        throw new Error(`Skill id "${skillId}" must be relative, not absolute.`);
+    }
+    return normalized;
+}
+export function resolveSkillPath(root, skillId) {
+    const safeId = validateSkillId(skillId);
+    const target = path.resolve(root, ...safeId.split("/"));
+    assertInside(target, root);
+    return target;
+}
+export function assertInside(targetPath, rootPath) {
+    const relative = path.relative(path.resolve(rootPath), path.resolve(targetPath));
+    if (relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative))) {
+        return;
+    }
+    throw new Error(`Path escapes allowed root: ${targetPath}`);
+}
+export function toSkillId(root, skillPath) {
+    const relative = path.relative(root, skillPath);
+    if (!relative || relative.startsWith("..") || path.isAbsolute(relative)) {
+        throw new Error(`Cannot derive skill id outside root: ${skillPath}`);
+    }
+    return relative.split(path.sep).join("/");
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/paths.js.map

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

package/dist/src/removeLocalSkill.d.ts

@@ -0,0 +1,5 @@
+import type { LocalConfig, LocalSkillSource, SkillRecord } from "./types.js";
+export type RemoveLocalOptions = {
+    source?: LocalSkillSource;
+};
+export declare function removeLocalSkill(config: LocalConfig, skillId: string, options?: RemoveLocalOptions): Promise<SkillRecord>;

package/dist/src/removeLocalSkill.js

@@ -0,0 +1,79 @@
+import { existsSync } from "node:fs";
+import { rm } from "node:fs/promises";
+import { deriveSyncState } from "./status.js";
+import { resolveSkillPath, validateSkillId } from "./paths.js";
+import { readSkillsMetadata, writeSkillsMetadata } from "./metadata.js";
+import { hashDirectory } from "./hash.js";
+export async function removeLocalSkill(config, skillId, options = {}) {
+    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];
+    const targetSource = resolveRemoveSource(config, id, existing, options.source);
+    if (targetSource.length === 0) {
+        throw new Error(`No local copy found for ${id}.`);
+    }
+    const removedSources = new Set();
+    for (const source of targetSource) {
+        const localPath = resolveSkillPath(config[source === "codex" ? "codexSkillsDir" : "agentsSkillsDir"], id);
+        if (existsSync(localPath)) {
+            await rm(localPath, { recursive: true, force: true });
+            removedSources.add(source);
+        }
+    }
+    if (removedSources.size === 0) {
+        throw new Error(`No local copy found for ${id}.`);
+    }
+    const now = new Date().toISOString();
+    const stillInstalled = Boolean(existsSync(resolveSkillPath(config.codexSkillsDir, id)) ||
+        existsSync(resolveSkillPath(config.agentsSkillsDir, id)));
+    const remainingLocalPath = stillInstalled
+        ? existsSync(resolveSkillPath(config.codexSkillsDir, id))
+            ? resolveSkillPath(config.codexSkillsDir, id)
+            : resolveSkillPath(config.agentsSkillsDir, id)
+        : null;
+    const remainingLocalHash = remainingLocalPath ? await hashDirectory(remainingLocalPath) : null;
+    const remainingSource = existsSync(resolveSkillPath(config.codexSkillsDir, id))
+        ? "codex"
+        : existsSync(resolveSkillPath(config.agentsSkillsDir, id))
+            ? "agents"
+            : null;
+    const localSource = stillInstalled ? remainingSource : null;
+    const updated = {
+        ...existing,
+        installed: stillInstalled,
+        localSource,
+        currentLocalHash: remainingLocalHash,
+        syncState: deriveSyncState(existing.lastSyncedHash, remainingLocalHash, existing.currentRepoHash),
+        updatedAt: now
+    };
+    metadata.skills[index] = updated;
+    await writeSkillsMetadata(config.syncRepo, metadata);
+    return updated;
+}
+function resolveRemoveSource(config, id, record, source) {
+    if (source === "codex" || source === "agents") {
+        return [source];
+    }
+    const codexPath = resolveSkillPath(config.codexSkillsDir, id);
+    const agentsPath = resolveSkillPath(config.agentsSkillsDir, id);
+    const existsInCodex = existsSync(codexPath);
+    const existsInAgents = existsSync(agentsPath);
+    if (existsInCodex && existsInAgents) {
+        return ["codex", "agents"];
+    }
+    if (existsInCodex) {
+        return ["codex"];
+    }
+    if (existsInAgents) {
+        return ["agents"];
+    }
+    if (record.localSource === "codex" || record.localSource === "agents") {
+        return [record.localSource];
+    }
+    return [];
+}
+//# sourceMappingURL=removeLocalSkill.js.map

package/dist/src/removeLocalSkill.js.map

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

package/dist/src/resolveConflict.d.ts

@@ -0,0 +1,10 @@
+import type { LocalConfig, SkillRecord } from "./types.js";
+import type { SyncResult } from "./sync.js";
+export type ConflictResolutionStrategy = "codex" | "agents" | "repo";
+export type ResolveConflictResult = {
+    record: SkillRecord;
+    result?: SyncResult;
+};
+export declare function resolveConflict(config: LocalConfig, skillId: string, options: {
+    strategy: ConflictResolutionStrategy;
+}): Promise<ResolveConflictResult>;