@shruubi/agentconfig 0.2.0 → 0.3.0

package/README.md

@@ -47,6 +47,15 @@ agentconfig sync
 
 Default source root is `~/.agentconfig`. Override with `AGENTCONFIG_HOME`.
 
+## Default mappings
+
+The default template includes common locations for agent instructions, rules, skills, and (where supported) agents, commands, and hooks.
+
+- Claude Code hooks are synced via `claude/settings.json`, plus agents and commands via `claude/agents/` and `claude/commands/`.
+- Codex skills are synced to `.agents/skills/` (global uses `${CODEX_HOME:-~/.codex}` root with a relative `../.agents/skills/`).
+- Cursor hooks are synced via `cursor/hooks.json` and `cursor/hooks/`.
+- OpenCode agents and commands are synced via `agents/` and `commands/`.
+
 ## Tests
 
 ```bash

package/dist/config.js

@@ -18,6 +18,90 @@ function getConfigPath(root) {
 function isErrnoException(error) {
     return typeof error === "object" && error !== null && "code" in error;
 }
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isMappingFile(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return typeof value.source === "string" && typeof value.target === "string";
+}
+function isAgentScopeConfig(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    if (typeof value.root !== "string") {
+        return false;
+    }
+    if (!Array.isArray(value.files)) {
+        return false;
+    }
+    return value.files.every((entry) => isMappingFile(entry));
+}
+function isAgentConfigEntry(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    if (typeof value.displayName !== "string") {
+        return false;
+    }
+    if (value.global !== undefined && !isAgentScopeConfig(value.global)) {
+        return false;
+    }
+    if (value.project !== undefined && !isAgentScopeConfig(value.project)) {
+        return false;
+    }
+    return true;
+}
+function isAgentConfigFile(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    if (typeof value.version !== "number") {
+        return false;
+    }
+    const defaults = value.defaults;
+    if (!isRecord(defaults)) {
+        return false;
+    }
+    if (defaults.mode !== "auto" && defaults.mode !== "link" && defaults.mode !== "copy") {
+        return false;
+    }
+    if (typeof defaults.profile !== "string") {
+        return false;
+    }
+    if (typeof defaults.sourceRoot !== "string") {
+        return false;
+    }
+    const agents = value.agents;
+    if (!isRecord(agents)) {
+        return false;
+    }
+    if (!Object.values(agents).every((entry) => isAgentConfigEntry(entry))) {
+        return false;
+    }
+    const profiles = value.profiles;
+    if (profiles !== undefined) {
+        if (!isRecord(profiles)) {
+            return false;
+        }
+        for (const profile of Object.values(profiles)) {
+            if (!isRecord(profile)) {
+                return false;
+            }
+            if (profile.files !== undefined) {
+                if (!Array.isArray(profile.files)) {
+                    return false;
+                }
+                if (!profile.files.every((entry) => isMappingFile(entry))) {
+                    return false;
+                }
+            }
+        }
+    }
+    return true;
+}
 function formatYamlError(error, configPath) {
     if (error instanceof Error) {
         const linePos = error.linePos?.[0];
@@ -48,6 +132,9 @@ async function readConfig(root) {
     if (!parsed || typeof parsed !== "object") {
         throw new errors_1.AgentConfigError(`Invalid config format in ${configPath}`, errors_1.ExitCodes.Validation);
     }
+    if (!isAgentConfigFile(parsed)) {
+        throw new errors_1.AgentConfigError(`Invalid config format in ${configPath}`, errors_1.ExitCodes.Validation);
+    }
     return parsed;
 }
 async function writeConfig(root, config) {

package/dist/filesystem.js

@@ -7,6 +7,8 @@ exports.ensureDir = ensureDir;
 exports.fileExists = fileExists;
 exports.readLinkTarget = readLinkTarget;
 exports.hashFile = hashFile;
+exports.hashDirectory = hashDirectory;
+exports.hashPath = hashPath;
 exports.listEntries = listEntries;
 exports.copyFileOrDir = copyFileOrDir;
 const crypto_1 = __importDefault(require("crypto"));
@@ -58,6 +60,39 @@ async function hashFile(target) {
     });
     return hash.digest("hex");
 }
+async function hashDirectory(target) {
+    const entries = await promises_1.default.readdir(target);
+    entries.sort((a, b) => a.localeCompare(b));
+    const hash = crypto_1.default.createHash("sha256");
+    for (const entry of entries) {
+        const fullPath = path_1.default.join(target, entry);
+        const stat = await promises_1.default.lstat(fullPath);
+        if (stat.isDirectory()) {
+            hash.update(`dir:${entry}:`);
+            hash.update(await hashDirectory(fullPath));
+            continue;
+        }
+        if (stat.isSymbolicLink()) {
+            const linkTarget = await promises_1.default.readlink(fullPath);
+            hash.update(`link:${entry}:${linkTarget}`);
+            continue;
+        }
+        hash.update(`file:${entry}:`);
+        hash.update(await hashFile(fullPath));
+    }
+    return hash.digest("hex");
+}
+async function hashPath(target) {
+    const stat = await promises_1.default.lstat(target);
+    if (stat.isDirectory()) {
+        return await hashDirectory(target);
+    }
+    if (stat.isSymbolicLink()) {
+        const linkTarget = await promises_1.default.readlink(target);
+        return crypto_1.default.createHash("sha256").update(`link:${linkTarget}`).digest("hex");
+    }
+    return await hashFile(target);
+}
 async function listEntries(target) {
     return await promises_1.default.readdir(target);
 }

package/dist/status.js

@@ -45,7 +45,7 @@ async function getStatus(stateRoot) {
             results.push({ path: record.path, status: "drifted", reason: "content changed" });
             continue;
         }
-        const currentHash = await (0, filesystem_1.hashFile)(record.path);
+        const currentHash = await (0, filesystem_1.hashPath)(record.path);
         if (currentHash !== record.hash) {
             results.push({ path: record.path, status: "drifted", reason: "content changed" });
             continue;

package/dist/sync.js

@@ -23,6 +23,7 @@ async function syncConfigs(options) {
     const skippedMappings = [];
     let conflictState = { policy: conflictPolicy ?? null, canAsk: true };
     for (const mapping of resolvedMappings) {
+        let allowNonEmptyDir = false;
         const targetExists = await (0, filesystem_1.fileExists)(mapping.target);
         if (targetExists && !force && !isManaged(mapping.target, existingState)) {
             const decision = await resolveConflictPolicy(mapping.target, conflictState);
@@ -39,13 +40,17 @@ async function syncConfigs(options) {
                 if (!dryRun) {
                     await backupTarget(mapping.target, sourceRoot);
                 }
+                allowNonEmptyDir = true;
+            }
+            if (decision.action === "overwrite") {
+                allowNonEmptyDir = true;
             }
         }
         if (dryRun) {
             continue;
         }
         try {
-            await applyMapping(mapping, warnings);
+            await applyMapping(mapping, warnings, { allowNonEmptyDir });
         }
         catch (error) {
             if (error instanceof errors_1.AgentConfigError) {
@@ -173,13 +178,14 @@ async function canCreateSymlink() {
         await promises_1.default.rm(tempRoot, { recursive: true, force: true });
     }
 }
-async function applyMapping(mapping, warnings) {
+async function applyMapping(mapping, warnings, options) {
+    const allowNonEmptyDir = options?.allowNonEmptyDir ?? false;
     const sourceExists = await (0, filesystem_1.fileExists)(mapping.source);
     if (!sourceExists) {
         throw new errors_1.AgentConfigError(`Missing source: ${mapping.source}`, errors_1.ExitCodes.Validation);
     }
     if (mapping.mode === "copy") {
-        await applyCopyMapping(mapping);
+        await applyCopyMapping(mapping, { allowNonEmptyDir });
         return;
     }
     await (0, filesystem_1.ensureDir)(path_1.default.dirname(mapping.target));
@@ -194,7 +200,7 @@ async function applyMapping(mapping, warnings) {
                 await promises_1.default.unlink(mapping.target);
             }
             else if (existing.isDirectory) {
-                const removed = await removeEmptyDirectory(mapping.target);
+                const removed = await removeDirectory(mapping.target, allowNonEmptyDir);
                 if (!removed) {
                     throw new errors_1.AgentConfigError(`Refusing to replace non-empty directory: ${mapping.target}`, errors_1.ExitCodes.Filesystem);
                 }
@@ -210,21 +216,28 @@ async function applyMapping(mapping, warnings) {
             throw error;
         }
         warnings.push(`Symlink failed for ${mapping.target}; falling back to copy`);
-        await applyCopyMapping(mapping);
+        await applyCopyMapping(mapping, { allowNonEmptyDir });
     }
 }
-async function applyCopyMapping(mapping) {
+async function applyCopyMapping(mapping, options) {
+    const allowNonEmptyDir = options?.allowNonEmptyDir ?? false;
     const sourceStat = await promises_1.default.lstat(mapping.source);
     const existing = await getTargetInfo(mapping.target);
     if (sourceStat.isDirectory()) {
         if (existing && !existing.isDirectory) {
             await promises_1.default.unlink(mapping.target);
         }
+        if (existing?.isDirectory) {
+            const removed = await removeDirectory(mapping.target, allowNonEmptyDir);
+            if (!removed) {
+                throw new errors_1.AgentConfigError(`Refusing to replace non-empty directory: ${mapping.target}`, errors_1.ExitCodes.Filesystem);
+            }
+        }
         await (0, filesystem_1.copyFileOrDir)(mapping.source, mapping.target);
         return;
     }
     if (existing?.isDirectory) {
-        const removed = await removeEmptyDirectory(mapping.target);
+        const removed = await removeDirectory(mapping.target, allowNonEmptyDir);
         if (!removed) {
             throw new errors_1.AgentConfigError(`Refusing to replace non-empty directory: ${mapping.target}`, errors_1.ExitCodes.Filesystem);
         }
@@ -262,6 +275,13 @@ async function removeEmptyDirectory(target) {
     await promises_1.default.rmdir(target);
     return true;
 }
+async function removeDirectory(target, allowNonEmptyDir) {
+    if (!allowNonEmptyDir) {
+        return await removeEmptyDirectory(target);
+    }
+    await promises_1.default.rm(target, { recursive: true, force: true });
+    return true;
+}
 function isManaged(target, state) {
     if (!state) {
         return false;
@@ -281,7 +301,7 @@ async function buildState(stateRoot, mode, projectRoot, mappings, previousState)
             mode: modeValue,
             size: stat.size,
             mtimeMs: stat.mtimeMs,
-            hash: modeValue === "copy" ? await (0, filesystem_1.hashFile)(mapping.target) : null,
+            hash: modeValue === "copy" ? await (0, filesystem_1.hashPath)(mapping.target) : null,
             linkTarget: modeValue === "link" ? await (0, filesystem_1.readLinkTarget)(mapping.target) : null
         };
         files[mapping.target] = record;

package/dist/templates.js

@@ -16,6 +16,9 @@ function createDefaultConfig() {
                     root: "~/.claude",
                     files: [
                         { source: "agent.md", target: "CLAUDE.md" },
+                        { source: "claude/settings.json", target: "settings.json" },
+                        { source: "claude/agents/", target: "agents/" },
+                        { source: "claude/commands/", target: "commands/" },
                         { source: "skills/", target: "skills/" }
                     ]
                 },
@@ -23,6 +26,9 @@ function createDefaultConfig() {
                     root: "<project-root>",
                     files: [
                         { source: "agent.md", target: "CLAUDE.md" },
+                        { source: "claude/settings.json", target: ".claude/settings.json" },
+                        { source: "claude/agents/", target: ".claude/agents/" },
+                        { source: "claude/commands/", target: ".claude/commands/" },
                         { source: "rules/", target: ".claude/rules/" },
                         { source: "skills/", target: ".claude/skills/" }
                     ]
@@ -34,14 +40,14 @@ function createDefaultConfig() {
                     root: "${CODEX_HOME:-~/.codex}",
                     files: [
                         { source: "agent.md", target: "AGENTS.md" },
-                        { source: "skills/", target: "skills/" }
+                        { source: "skills/", target: "../.agents/skills/" }
                     ]
                 },
                 project: {
                     root: "<project-root>",
                     files: [
                         { source: "agent.md", target: "AGENTS.md" },
-                        { source: "skills/", target: ".codex/skills/" }
+                        { source: "skills/", target: ".agents/skills/" }
                     ]
                 }
             },
@@ -49,12 +55,18 @@ function createDefaultConfig() {
                 displayName: "Cursor",
                 global: {
                     root: "~/.cursor",
-                    files: [{ source: "skills/", target: "skills/" }]
+                    files: [
+                        { source: "cursor/hooks.json", target: "hooks.json" },
+                        { source: "cursor/hooks/", target: "hooks/" },
+                        { source: "skills/", target: "skills/" }
+                    ]
                 },
                 project: {
                     root: "<project-root>",
                     files: [
                         { source: "agent.md", target: "AGENTS.md" },
+                        { source: "cursor/hooks.json", target: ".cursor/hooks.json" },
+                        { source: "cursor/hooks/", target: ".cursor/hooks/" },
                         { source: "rules/", target: ".cursor/rules/" },
                         { source: "skills/", target: ".cursor/skills/" }
                     ]
@@ -66,6 +78,8 @@ function createDefaultConfig() {
                     root: "~/.config/opencode",
                     files: [
                         { source: "agent.md", target: "AGENTS.md" },
+                        { source: "agents/", target: "agents/" },
+                        { source: "commands/", target: "commands/" },
                         { source: "rules/", target: "rules/" },
                         { source: "skills/", target: "skills/" }
                     ]
@@ -74,6 +88,8 @@ function createDefaultConfig() {
                     root: "<project-root>",
                     files: [
                         { source: "agent.md", target: "AGENTS.md" },
+                        { source: "agents/", target: ".opencode/agents/" },
+                        { source: "commands/", target: ".opencode/commands/" },
                         { source: "rules/", target: ".opencode/rules/" },
                         { source: "skills/", target: ".opencode/skills/" }
                     ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shruubi/agentconfig",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Sync a single agent config source to multiple coding agents",
   "license": "MIT",
   "repository": {
@@ -15,7 +15,7 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "bin": {
     "agentconfig": "dist/cli.js"
@@ -28,7 +28,10 @@
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "prepare": "husky",
-    "test": "npm run build && node --test",
+    "test": "npm run build && npm run test:compile && node --test dist-test/tests/*.js",
+    "test:compile": "tsc -p tsconfig.test.json",
+    "test:dev": "node --test --import tsx tests/*.ts",
+    "test:dev:watch": "node --test --watch --import tsx tests/*.ts",
     "dev": "tsc -w"
   },
   "dependencies": {
@@ -44,6 +47,7 @@
     "lint-staged": "^15.2.11",
     "prettier": "^3.5.2",
     "typescript-eslint": "^8.26.0",
+    "tsx": "^4.19.2",
     "typescript": "^5.7.3"
   },
   "lint-staged": {