@detergent-software/atk 8.6.2-dev.1 → 8.7.0-dev.10

package/build/lib/write-file.d.ts

@@ -1,3 +1,11 @@
+/** How a file is written. */
+export interface WriteOptions {
+    /**
+     * Write a temp file next to it and rename it over the file, so a process that reads the file
+     * while it is written (a tool rewriting its own config) never sees it half written.
+     */
+    atomic?: boolean;
+}
 /**
  * Write a binary file verbatim, but skip the write when the content is unchanged.
  *
@@ -26,8 +34,9 @@ export declare function writeBinaryFile(filePath: string, content: Buffer): Prom
  *
  * @param filePath - Absolute path of the file to write.
  * @param data - Value to serialize as JSON.
+ * @param options - How to write it.
  */
-export declare function writeJsonFile(filePath: string, data: unknown): Promise<void>;
+export declare function writeJsonFile(filePath: string, data: unknown, options?: WriteOptions): Promise<void>;
 /**
  * Write a text file verbatim, but skip the write when the content is unchanged.
  *
@@ -36,8 +45,9 @@ export declare function writeJsonFile(filePath: string, data: unknown): Promise<
  *
  * @param filePath - Absolute path of the file to write.
  * @param content - Exact content to write.
+ * @param options - How to write it.
  */
-export declare function writeTextFile(filePath: string, content: string): Promise<void>;
+export declare function writeTextFile(filePath: string, content: string, options?: WriteOptions): Promise<void>;
 /**
  * Write a TOML file in a git-friendly, idempotent way.
  *
@@ -45,10 +55,13 @@ export declare function writeTextFile(filePath: string, content: string): Promis
  * content already matches the file, and CRLF line endings are preserved when
  * the existing file uses them. Indentation is not applicable (tables are
  * emitted flush-left). Comments and custom formatting in an existing file are
- * NOT preserved — the document is re-serialized canonically.
+ * NOT preserved — the document is re-serialized canonically. `writeConfigFile`
+ * edits an existing file in place instead, and comes here only for a new file
+ * or a change it can't make that way.
  *
  * @param filePath - Absolute path of the file to write.
  * @param data - Object to serialize as TOML.
+ * @param options - How to write it.
  */
-export declare function writeTomlFile(filePath: string, data: Record<string, unknown>): Promise<void>;
+export declare function writeTomlFile(filePath: string, data: Record<string, unknown>, options?: WriteOptions): Promise<void>;
 //# sourceMappingURL=write-file.d.ts.map

package/build/lib/write-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-file.d.ts","sourceRoot":"","sources":["../../src/lib/write-file.ts"],"names":[],"mappings":"AAYA;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYtF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAYlF;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpF;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlG"}
+{"version":3,"file":"write-file.d.ts","sourceRoot":"","sources":["../../src/lib/write-file.ts"],"names":[],"mappings":"AAOA,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AASD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYtF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAY9G;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/build/lib/write-file.js

@@ -1,6 +1,8 @@
+import { randomBytes } from 'node:crypto';
 import { existsSync } from 'node:fs';
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { chmod, mkdir, readFile, realpath, rename, stat, unlink, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
+import { setTimeout as sleep } from 'node:timers/promises';
 import { stringify as stringifyToml } from 'smol-toml';
 /**
  * Default indentation for brand-new JSON files that ATK creates (no existing
@@ -47,8 +49,9 @@ export async function writeBinaryFile(filePath, content) {
  *
  * @param filePath - Absolute path of the file to write.
  * @param data - Value to serialize as JSON.
+ * @param options - How to write it.
  */
-export async function writeJsonFile(filePath, data) {
+export async function writeJsonFile(filePath, data, options = {}) {
     const existing = await readIfExists(filePath);
     const indent = existing === undefined ? DEFAULT_JSON_INDENT : detectIndent(existing);
     const eol = existing !== undefined && existing.includes('\r\n') ? '\r\n' : '\n';
@@ -56,7 +59,7 @@ export async function writeJsonFile(filePath, data) {
     // escapes any newline inside string values, so a global `\n` → eol swap only
     // touches structural newlines.
     const content = JSON.stringify(data, null, indent).replace(/\n/g, eol) + eol;
-    await writeFileIfChanged(filePath, content, existing);
+    await writeFileIfChanged(filePath, content, existing, options);
 }
 /**
  * Write a text file verbatim, but skip the write when the content is unchanged.
@@ -66,10 +69,11 @@ export async function writeJsonFile(filePath, data) {
  *
  * @param filePath - Absolute path of the file to write.
  * @param content - Exact content to write.
+ * @param options - How to write it.
  */
-export async function writeTextFile(filePath, content) {
+export async function writeTextFile(filePath, content, options = {}) {
     const existing = await readIfExists(filePath);
-    await writeFileIfChanged(filePath, content, existing);
+    await writeFileIfChanged(filePath, content, existing, options);
 }
 /**
  * Write a TOML file in a git-friendly, idempotent way.
@@ -78,19 +82,22 @@ export async function writeTextFile(filePath, content) {
  * content already matches the file, and CRLF line endings are preserved when
  * the existing file uses them. Indentation is not applicable (tables are
  * emitted flush-left). Comments and custom formatting in an existing file are
- * NOT preserved — the document is re-serialized canonically.
+ * NOT preserved — the document is re-serialized canonically. `writeConfigFile`
+ * edits an existing file in place instead, and comes here only for a new file
+ * or a change it can't make that way.
  *
  * @param filePath - Absolute path of the file to write.
  * @param data - Object to serialize as TOML.
+ * @param options - How to write it.
  */
-export async function writeTomlFile(filePath, data) {
+export async function writeTomlFile(filePath, data, options = {}) {
     const existing = await readIfExists(filePath);
     const eol = existing !== undefined && existing.includes('\r\n') ? '\r\n' : '\n';
     // smol-toml emits `\n` as the structural line separator and escapes any
     // newline inside string values, so a global `\n` → eol swap only touches
     // structural newlines.
     const content = stringifyToml(data).replace(/\n/g, eol);
-    await writeFileIfChanged(filePath, content, existing);
+    await writeFileIfChanged(filePath, content, existing, options);
 }
 /**
  * Detect the per-level indentation unit of an existing JSON document.
@@ -116,17 +123,60 @@ async function readIfExists(filePath) {
         return undefined;
     return readFile(filePath, 'utf-8');
 }
+/**
+ * Write `content` to a temp file next to `filePath` and rename it over the file. A symlink is
+ * written through to its target, and the file keeps its mode (a `.claude.json` kept at 0600
+ * because it holds MCP secrets stays 0600); a new file gets 0600. Windows refuses a rename while another process (an
+ * antivirus scan, the tool reading it) has the file open, so a refused rename is retried briefly.
+ * The temp file is removed when the write fails.
+ */
+async function writeFileAtomic(filePath, content) {
+    const target = existsSync(filePath) ? await realpath(filePath) : filePath;
+    // A new file is private to its owner: what a tool rewrites while it runs can hold secrets.
+    const mode = existsSync(target) ? (await stat(target)).mode & 0o777 : 0o600;
+    const tempPath = `${target}.tmp.${process.pid}.${randomBytes(4).toString('hex')}`;
+    try {
+        await writeFile(tempPath, content, { encoding: 'utf-8', mode });
+        await chmod(tempPath, mode);
+        await renameWithRetry(tempPath, target);
+    }
+    catch (error) {
+        await unlink(tempPath).catch(() => undefined);
+        throw error;
+    }
+}
 /**
  * Write `content` to `filePath` only if it differs from `existing`, creating
  * the parent directory as needed. A no-op when the content already matches.
  */
-async function writeFileIfChanged(filePath, content, existing) {
+async function writeFileIfChanged(filePath, content, existing, { atomic = false } = {}) {
     if (existing === content)
         return;
     const dir = dirname(filePath);
     if (!existsSync(dir)) {
         await mkdir(dir, { recursive: true });
     }
-    await writeFile(filePath, content, 'utf-8');
+    if (!atomic) {
+        await writeFile(filePath, content, 'utf-8');
+        return;
+    }
+    await writeFileAtomic(filePath, content);
+}
+/** How often, and how far apart, a rename Windows refused is tried again. */
+const RENAME_RETRIES = 10;
+const RENAME_RETRY_MS = 50;
+async function renameWithRetry(from, to) {
+    for (let attempt = 0;; attempt++) {
+        try {
+            await rename(from, to);
+            return;
+        }
+        catch (error) {
+            const code = error.code;
+            if (attempt >= RENAME_RETRIES || (code !== 'EPERM' && code !== 'EBUSY' && code !== 'EACCES'))
+                throw error;
+            await sleep(RENAME_RETRY_MS);
+        }
+    }
 }
 //# sourceMappingURL=write-file.js.map

package/build/lib/write-file.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@detergent-software/atk",
-	"version": "8.6.2-dev.1",
+	"version": "8.7.0-dev.10",
 	"description": "Agentic Tool Kit — CLI for managing AI coding tool assets.",
 	"type": "module",
 	"bin": {

package/tool-adapters/claude-code.json

@@ -34,5 +34,49 @@
 			"enabledListKey": "enabledMcpjsonServers",
 			"fileless": true
 		}
+	},
+	"userConfigDir": {
+		"env": "CLAUDE_CONFIG_DIR",
+		"dir": ".claude",
+		"files": [".claude.json", ".claude.json.lock"]
+	},
+	"userPlacements": {
+		"skill": {
+			"path": ".claude/skills/{name}/",
+			"entrypointName": "SKILL.md"
+		},
+		"agent": {
+			"path": ".claude/agents/{name}.md"
+		},
+		"rule": {
+			"path": ".claude/rules/{name}.md"
+		},
+		"hook": {
+			"path": ".claude/hooks/{name}.sh",
+			"configFile": ".claude/settings.json",
+			"configKey": "hooks",
+			"configHookMerge": true,
+			"configCommand": "\"${CLAUDE_CONFIG_DIR:-$HOME/.claude}/hooks/{name}.sh\""
+		},
+		"memory-template": {
+			"path": ".claude/CLAUDE.md"
+		},
+		"mcp-config": {
+			"path": "",
+			"configFile": ".claude.json",
+			"configKey": "mcpServers",
+			"configMerge": true,
+			"configFragment": true,
+			"configLockFile": ".claude.json.lock",
+			"fileless": true
+		}
+	},
+	"scopeClash": {
+		"skill": "user",
+		"agent": "project",
+		"rule": "both",
+		"hook": "both",
+		"memory-template": "both",
+		"mcp-config": "project"
 	}
 }

package/tool-adapters/codex-cli.json

@@ -27,5 +27,33 @@
 			"configMerge": true,
 			"fileless": true
 		}
+	},
+	"userConfigDir": {
+		"env": "CODEX_HOME",
+		"dir": ".codex"
+	},
+	"userPlacements": {
+		"skill": {
+			"path": ".codex/skills/{name}/",
+			"entrypointName": "SKILL.md"
+		},
+		"memory-template": {
+			"path": ".codex/AGENTS.md"
+		},
+		"mcp-config": {
+			"path": "",
+			"configFile": ".codex/config.toml",
+			"configFormat": "toml",
+			"configFragment": true,
+			"configFragmentKey": "mcpServers",
+			"configKey": "mcp_servers",
+			"configMerge": true,
+			"fileless": true
+		}
+	},
+	"scopeClash": {
+		"skill": "both",
+		"memory-template": "both",
+		"mcp-config": "project"
 	}
 }

package/tool-adapters/copilot-cli.json

@@ -21,8 +21,52 @@
 			"path": "",
 			"fileless": true,
 			"configMerge": true,
-			"configFile": "./copilot/mcp-config.json",
-			"configKey": "servers"
+			"configFile": ".vscode/mcp.json",
+			"configKey": "servers",
+			"configFragment": true,
+			"configFragmentKey": "mcpServers"
 		}
+	},
+	"userConfigDir": {
+		"env": "XDG_CONFIG_HOME",
+		"dir": ".copilot",
+		"subdir": ".copilot",
+		"keep": [".copilot/hooks/"]
+	},
+	"userPlacements": {
+		"skill": {
+			"path": ".copilot/skills/{name}/",
+			"entrypointName": "SKILL.md"
+		},
+		"agent": {
+			"path": ".copilot/agents/{name}.agent.md"
+		},
+		"rule": {
+			"path": ".copilot/instructions/{name}.instructions.md"
+		},
+		"hook": {
+			"path": ".copilot/hooks/{name}.json"
+		},
+		"memory-template": {
+			"path": ".copilot/copilot-instructions.md"
+		},
+		"mcp-config": {
+			"path": "",
+			"fileless": true,
+			"configMerge": true,
+			"configFile": ".copilot/mcp-config.json",
+			"configKey": "mcpServers",
+			"configFragment": true,
+			"configFragmentKey": "servers",
+			"configEntryDefaults": { "tools": ["*"] },
+			"configCommandEntryDefaults": { "args": [] }
+		}
+	},
+	"scopeClash": {
+		"skill": "project",
+		"agent": "user",
+		"rule": "both",
+		"hook": "both",
+		"mcp-config": "project"
 	}
 }