@kya-os/cli 1.8.1 → 2.0.0

package/dist/utils/cli-kit/fs-safe.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Atomic, symlink-safe file replace.
+ *
+ * The destination and its temp sibling may live in an untrusted working
+ * tree (e.g. a cloned repo). A tracked symlink planted at the predictable
+ * `<path>.mcpi-tmp` sibling would otherwise make a plain writeFileSync
+ * follow it and clobber an arbitrary file the caller can write. So: unlink
+ * any pre-existing temp (rmSync removes the link itself, never its
+ * target), then create it with O_EXCL (`wx`) so a planted or racing
+ * symlink makes the write fail closed instead of being followed.
+ * renameSync replaces the destination without following a symlink there.
+ */
+export declare function writeFileAtomicSafe(path: string, content: string, mode?: number): void;
+//# sourceMappingURL=fs-safe.d.ts.map

package/dist/utils/cli-kit/fs-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-safe.d.ts","sourceRoot":"","sources":["../../../src/utils/cli-kit/fs-safe.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,SAAQ,GACX,IAAI,CAKN"}

package/dist/utils/cli-kit/fs-safe.js

@@ -0,0 +1,20 @@
+import { renameSync, rmSync, writeFileSync } from "fs";
+/**
+ * Atomic, symlink-safe file replace.
+ *
+ * The destination and its temp sibling may live in an untrusted working
+ * tree (e.g. a cloned repo). A tracked symlink planted at the predictable
+ * `<path>.mcpi-tmp` sibling would otherwise make a plain writeFileSync
+ * follow it and clobber an arbitrary file the caller can write. So: unlink
+ * any pre-existing temp (rmSync removes the link itself, never its
+ * target), then create it with O_EXCL (`wx`) so a planted or racing
+ * symlink makes the write fail closed instead of being followed.
+ * renameSync replaces the destination without following a symlink there.
+ */
+export function writeFileAtomicSafe(path, content, mode = 0o644) {
+    const tempPath = `${path}.mcpi-tmp`;
+    rmSync(tempPath, { force: true });
+    writeFileSync(tempPath, content, { flag: "wx", mode });
+    renameSync(tempPath, path);
+}
+//# sourceMappingURL=fs-safe.js.map

package/dist/utils/cli-kit/fs-safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-safe.js","sourceRoot":"","sources":["../../../src/utils/cli-kit/fs-safe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,OAAe,EACf,IAAI,GAAG,KAAK;IAEZ,MAAM,QAAQ,GAAG,GAAG,IAAI,WAAW,CAAC;IACpC,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/utils/cli-kit/index.d.ts

@@ -0,0 +1,15 @@
+export { writeFileAtomicSafe } from "./fs-safe.js";
+export { upsertMarkerBlock } from "./marker-block.js";
+export type { UpsertResult } from "./marker-block.js";
+export { mergeJsonFile } from "./json-file.js";
+export type { MergeJsonResult } from "./json-file.js";
+export { renderSteps, statusLabel } from "./step-report.js";
+export type { StepStatus, StepResult } from "./step-report.js";
+export { SLUG_PATTERN, isValidSlug, stateDir } from "./paths.js";
+export { ensureSecureDir, writeSecureFile } from "./secure-storage.js";
+export { pollForClaimStatus } from "./claim-polling.js";
+export type { ClaimPollingOptions } from "./claim-polling.js";
+export { openUrlInBrowser } from "./browser.js";
+export type { OpenUrlInBrowserOptions, OpenUrlInBrowserResult, } from "./browser.js";
+export { runDiagnosticChecks } from "./diagnostics.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/cli-kit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/cli-kit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EACV,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils/cli-kit/index.js

@@ -0,0 +1,10 @@
+export { writeFileAtomicSafe } from "./fs-safe.js";
+export { upsertMarkerBlock } from "./marker-block.js";
+export { mergeJsonFile } from "./json-file.js";
+export { renderSteps, statusLabel } from "./step-report.js";
+export { SLUG_PATTERN, isValidSlug, stateDir } from "./paths.js";
+export { ensureSecureDir, writeSecureFile } from "./secure-storage.js";
+export { pollForClaimStatus } from "./claim-polling.js";
+export { openUrlInBrowser } from "./browser.js";
+export { runDiagnosticChecks } from "./diagnostics.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/cli-kit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/cli-kit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAMhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils/cli-kit/json-file.d.ts

@@ -0,0 +1,21 @@
+export type MergeJsonResult = "created" | "updated" | "unchanged" | "skipped-invalid" | "would-change";
+/**
+ * Merge `patch` into a JSON file at `path`, preserving every other key.
+ *
+ * A file we cannot parse (or that doesn't hold a plain object) is left
+ * untouched and reported "skipped-invalid": clobbering a caller's existing
+ * config is worse than leaving the patch unapplied. Already-applied patches
+ * report "unchanged" without writing.
+ *
+ * `path` is used as given, with no containment check against a base
+ * directory (unlike `upsertMarkerBlock`, this function takes a fully
+ * resolved path, not a `cwd` + relative segment) — resolving it safely is
+ * the caller's responsibility.
+ */
+export declare function mergeJsonFile(path: string, patch: Record<string, unknown>, options?: {
+    dryRun?: boolean;
+}): {
+    result: MergeJsonResult;
+    path: string;
+};
+//# sourceMappingURL=json-file.d.ts.map

package/dist/utils/cli-kit/json-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file.d.ts","sourceRoot":"","sources":["../../../src/utils/cli-kit/json-file.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,SAAS,GACT,WAAW,GACX,iBAAiB,GACjB,cAAc,CAAC;AAEnB;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAoC3C"}

package/dist/utils/cli-kit/json-file.js

@@ -0,0 +1,51 @@
+import { existsSync, mkdirSync, readFileSync } from "fs";
+import { dirname } from "path";
+import { writeFileAtomicSafe } from "./fs-safe.js";
+/**
+ * Merge `patch` into a JSON file at `path`, preserving every other key.
+ *
+ * A file we cannot parse (or that doesn't hold a plain object) is left
+ * untouched and reported "skipped-invalid": clobbering a caller's existing
+ * config is worse than leaving the patch unapplied. Already-applied patches
+ * report "unchanged" without writing.
+ *
+ * `path` is used as given, with no containment check against a base
+ * directory (unlike `upsertMarkerBlock`, this function takes a fully
+ * resolved path, not a `cwd` + relative segment) — resolving it safely is
+ * the caller's responsibility.
+ */
+export function mergeJsonFile(path, patch, options = {}) {
+    if (existsSync(path)) {
+        let settings;
+        try {
+            const parsed = JSON.parse(readFileSync(path, "utf-8"));
+            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+                return { result: "skipped-invalid", path };
+            }
+            settings = parsed;
+        }
+        catch {
+            return { result: "skipped-invalid", path };
+        }
+        const alreadyApplied = Object.entries(patch).every(([key, value]) => settings[key] === value);
+        if (alreadyApplied) {
+            return { result: "unchanged", path };
+        }
+        if (options.dryRun) {
+            return { result: "would-change", path };
+        }
+        Object.assign(settings, patch);
+        writeFileAtomicSafe(path, JSON.stringify(settings, null, 2) + "\n");
+        return { result: "updated", path };
+    }
+    if (options.dryRun) {
+        return { result: "would-change", path };
+    }
+    const dir = dirname(path);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileAtomicSafe(path, JSON.stringify(patch, null, 2) + "\n");
+    return { result: "created", path };
+}
+//# sourceMappingURL=json-file.js.map

package/dist/utils/cli-kit/json-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-file.js","sourceRoot":"","sources":["../../../src/utils/cli-kit/json-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AASnD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,KAA8B,EAC9B,UAAgC,EAAE;IAElC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,QAAiC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;YACvD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACnE,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;YAC7C,CAAC;YACD,QAAQ,GAAG,MAAiC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;QAC7C,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAChD,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,KAAK,CAC1C,CAAC;QACF,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACvC,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;QAC1C,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/B,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACpE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACjE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACrC,CAAC"}

package/dist/utils/cli-kit/marker-block.d.ts

@@ -0,0 +1,26 @@
+export type UpsertResult = "created" | "updated" | "unchanged" | "would-change";
+/**
+ * Insert or replace a delimited block in a file, generalized over the
+ * target file, the start/end markers, and the block content — so a
+ * consumer can manage its own marker pair (e.g. `<!-- mcpi:dco:start -->`)
+ * in its own target file (e.g. `CLAUDE.md`) without duplicating this
+ * splice/append logic.
+ *
+ * Creates the file with just the block when missing, replaces an existing
+ * managed block in place, or appends with a blank-line separator when no
+ * managed block exists yet. A no-op write (content already matches) is
+ * reported as "unchanged" rather than touching the file.
+ *
+ * `relativePath` must never carry attacker- or config-file-influenced
+ * segments without validation upstream: it's resolved against `cwd` and
+ * rejected if it would escape it (e.g. `../../.ssh/authorized_keys`),
+ * but a crafted value that stays inside `cwd` (e.g. overwriting an
+ * unrelated tracked file) is still the caller's responsibility to guard.
+ */
+export declare function upsertMarkerBlock(cwd: string, relativePath: string, startMarker: string, endMarker: string, block: string, options?: {
+    dryRun?: boolean;
+}): {
+    result: UpsertResult;
+    path: string;
+};
+//# sourceMappingURL=marker-block.d.ts.map

package/dist/utils/cli-kit/marker-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker-block.d.ts","sourceRoot":"","sources":["../../../src/utils/cli-kit/marker-block.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;AAEhF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA2CxC"}

package/dist/utils/cli-kit/marker-block.js

@@ -0,0 +1,61 @@
+import { existsSync, mkdirSync, readFileSync } from "fs";
+import { dirname, resolve, sep } from "path";
+import { writeFileAtomicSafe } from "./fs-safe.js";
+/**
+ * Insert or replace a delimited block in a file, generalized over the
+ * target file, the start/end markers, and the block content — so a
+ * consumer can manage its own marker pair (e.g. `<!-- mcpi:dco:start -->`)
+ * in its own target file (e.g. `CLAUDE.md`) without duplicating this
+ * splice/append logic.
+ *
+ * Creates the file with just the block when missing, replaces an existing
+ * managed block in place, or appends with a blank-line separator when no
+ * managed block exists yet. A no-op write (content already matches) is
+ * reported as "unchanged" rather than touching the file.
+ *
+ * `relativePath` must never carry attacker- or config-file-influenced
+ * segments without validation upstream: it's resolved against `cwd` and
+ * rejected if it would escape it (e.g. `../../.ssh/authorized_keys`),
+ * but a crafted value that stays inside `cwd` (e.g. overwriting an
+ * unrelated tracked file) is still the caller's responsibility to guard.
+ */
+export function upsertMarkerBlock(cwd, relativePath, startMarker, endMarker, block, options = {}) {
+    const resolvedCwd = resolve(cwd);
+    const path = resolve(resolvedCwd, relativePath);
+    if (path !== resolvedCwd && !path.startsWith(resolvedCwd + sep)) {
+        throw new Error(`Invalid relativePath "${relativePath}": resolves outside cwd "${cwd}"`);
+    }
+    if (!existsSync(path)) {
+        if (options.dryRun) {
+            return { result: "would-change", path };
+        }
+        const dir = dirname(path);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileAtomicSafe(path, block + "\n");
+        return { result: "created", path };
+    }
+    const existing = readFileSync(path, "utf-8");
+    const startIdx = existing.indexOf(startMarker);
+    const endIdx = existing.indexOf(endMarker);
+    let next;
+    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+        const before = existing.slice(0, startIdx);
+        const after = existing.slice(endIdx + endMarker.length);
+        next = before + block + after;
+    }
+    else {
+        const separator = existing.endsWith("\n") ? "\n" : "\n\n";
+        next = existing + separator + block + "\n";
+    }
+    if (next === existing) {
+        return { result: "unchanged", path };
+    }
+    if (options.dryRun) {
+        return { result: "would-change", path };
+    }
+    writeFileAtomicSafe(path, next);
+    return { result: "updated", path };
+}
+//# sourceMappingURL=marker-block.js.map

package/dist/utils/cli-kit/marker-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker-block.js","sourceRoot":"","sources":["../../../src/utils/cli-kit/marker-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAInD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAW,EACX,YAAoB,EACpB,WAAmB,EACnB,SAAiB,EACjB,KAAa,EACb,UAAgC,EAAE;IAElC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAChD,IAAI,IAAI,KAAK,WAAW,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,GAAG,GAAG,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CACb,yBAAyB,YAAY,4BAA4B,GAAG,GAAG,CACxE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;QAC1C,CAAC;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,mBAAmB,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;QACxC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAE3C,IAAI,IAAY,CAAC;IACjB,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAChC,CAAC;SAAM,CAAC;QACN,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1D,IAAI,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC;IAC7C,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IACD,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACrC,CAAC"}

package/dist/utils/cli-kit/paths.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Slugs are often sourced from a file or env var an untrusted cloned repo
+ * can influence, and become a path segment under a state directory, so
+ * every source must pass this same shape check.
+ */
+export declare const SLUG_PATTERN: RegExp;
+export declare function isValidSlug(slug: string): boolean;
+/**
+ * Absolute path to a namespaced state directory under the user's home,
+ * e.g. `stateDir("mcpi", "keys")` -> `~/.mcpi/keys`. Each CLI (mcpi,
+ * kya-id, ...) picks its own namespace so their on-disk state never
+ * collides.
+ */
+export declare function stateDir(namespace: string, ...segments: string[]): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/cli-kit/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/utils/cli-kit/paths.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAyB,CAAC;AAEnD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEzE"}

package/dist/utils/cli-kit/paths.js

@@ -0,0 +1,21 @@
+import { homedir } from "os";
+import { join, resolve } from "path";
+/**
+ * Slugs are often sourced from a file or env var an untrusted cloned repo
+ * can influence, and become a path segment under a state directory, so
+ * every source must pass this same shape check.
+ */
+export const SLUG_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+export function isValidSlug(slug) {
+    return SLUG_PATTERN.test(slug);
+}
+/**
+ * Absolute path to a namespaced state directory under the user's home,
+ * e.g. `stateDir("mcpi", "keys")` -> `~/.mcpi/keys`. Each CLI (mcpi,
+ * kya-id, ...) picks its own namespace so their on-disk state never
+ * collides.
+ */
+export function stateDir(namespace, ...segments) {
+    return resolve(join(homedir(), `.${namespace}`, ...segments));
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/cli-kit/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/utils/cli-kit/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAErC;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,sBAAsB,CAAC;AAEnD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,SAAiB,EAAE,GAAG,QAAkB;IAC/D,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,SAAS,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/utils/cli-kit/secure-storage.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Create (or reuse) a directory with 0700 permissions, recursively.
+ */
+export declare function ensureSecureDir(path: string, mode?: number): void;
+/**
+ * Write credential/key material with 0600 permissions.
+ *
+ * The mode is set on write to avoid any window where the file exists with
+ * looser permissions, then re-asserted with chmod: the write-time mode
+ * option is ignored when the file already exists, so a pre-existing file
+ * with looser permissions would otherwise keep them.
+ */
+export declare function writeSecureFile(path: string, content: string, mode?: number): void;
+//# sourceMappingURL=secure-storage.d.ts.map

package/dist/utils/cli-kit/secure-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-storage.d.ts","sourceRoot":"","sources":["../../../src/utils/cli-kit/secure-storage.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAQ,GAAG,IAAI,CAEhE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,SAAQ,GACX,IAAI,CAGN"}

package/dist/utils/cli-kit/secure-storage.js

@@ -0,0 +1,20 @@
+import { chmodSync, mkdirSync, writeFileSync } from "fs";
+/**
+ * Create (or reuse) a directory with 0700 permissions, recursively.
+ */
+export function ensureSecureDir(path, mode = 0o700) {
+    mkdirSync(path, { recursive: true, mode });
+}
+/**
+ * Write credential/key material with 0600 permissions.
+ *
+ * The mode is set on write to avoid any window where the file exists with
+ * looser permissions, then re-asserted with chmod: the write-time mode
+ * option is ignored when the file already exists, so a pre-existing file
+ * with looser permissions would otherwise keep them.
+ */
+export function writeSecureFile(path, content, mode = 0o600) {
+    writeFileSync(path, content, { mode });
+    chmodSync(path, mode);
+}
+//# sourceMappingURL=secure-storage.js.map

package/dist/utils/cli-kit/secure-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-storage.js","sourceRoot":"","sources":["../../../src/utils/cli-kit/secure-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAEzD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAI,GAAG,KAAK;IACxD,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,OAAe,EACf,IAAI,GAAG,KAAK;IAEZ,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/utils/cli-kit/step-report.d.ts

@@ -0,0 +1,16 @@
+export type StepStatus = "done" | "skipped" | "failed" | "action-required" | "would-change";
+export interface StepResult {
+    id: string;
+    title: string;
+    status: StepStatus;
+    detail?: string;
+}
+export declare function statusLabel(status: StepStatus): string;
+/**
+ * Render a step-report list as aligned `title  status` lines, with a
+ * detail line under any step that isn't "done" or "skipped". Returns
+ * lines rather than printing them, so a consumer composes its own
+ * header/footer around the shared body.
+ */
+export declare function renderSteps(steps: StepResult[]): string[];
+//# sourceMappingURL=step-report.d.ts.map

package/dist/utils/cli-kit/step-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-report.d.ts","sourceRoot":"","sources":["../../../src/utils/cli-kit/step-report.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,SAAS,GACT,QAAQ,GACR,iBAAiB,GACjB,cAAc,CAAC;AAEnB,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAatD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAazD"}

package/dist/utils/cli-kit/step-report.js

@@ -0,0 +1,36 @@
+import chalk from "chalk";
+export function statusLabel(status) {
+    switch (status) {
+        case "done":
+            return chalk.green("done");
+        case "skipped":
+            return chalk.gray("skipped");
+        case "would-change":
+            return chalk.cyan("would change");
+        case "action-required":
+            return chalk.yellow("action required");
+        case "failed":
+            return chalk.red("failed");
+    }
+}
+/**
+ * Render a step-report list as aligned `title  status` lines, with a
+ * detail line under any step that isn't "done" or "skipped". Returns
+ * lines rather than printing them, so a consumer composes its own
+ * header/footer around the shared body.
+ */
+export function renderSteps(steps) {
+    if (steps.length === 0) {
+        return [];
+    }
+    const width = Math.max(...steps.map((s) => s.title.length));
+    const lines = [];
+    for (const step of steps) {
+        lines.push(`  ${step.title.padEnd(width)}  ${statusLabel(step.status)}`);
+        if (step.detail && step.status !== "done" && step.status !== "skipped") {
+            lines.push(`  ${" ".repeat(width)}  ${chalk.gray(step.detail)}`);
+        }
+    }
+    return lines;
+}
+//# sourceMappingURL=step-report.js.map

package/dist/utils/cli-kit/step-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-report.js","sourceRoot":"","sources":["../../../src/utils/cli-kit/step-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAgB1B,MAAM,UAAU,WAAW,CAAC,MAAkB;IAC5C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7B,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,KAAK,cAAc;YACjB,OAAO,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACpC,KAAK,iBAAiB;YACpB,OAAO,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACzC,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAmB;IAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzE,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACvE,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/dco/agent-metadata.d.ts

@@ -1,6 +1,6 @@
 /**
  * Persistent agent metadata written at registration time so later commands
- * (notably `mcpi dco setup`) know the agent's public name, slug, and URL
+ * (notably `dco setup`) know the agent's public name, slug, and URL
  * without another API round trip. Lives next to identity.json but contains
  * no key material (claimUrl may embed a short-lived claim capability; the
  * whole .mcpi directory is gitignored).

package/dist/utils/dco/agent-metadata.js

@@ -1,6 +1,6 @@
 import { existsSync, mkdirSync, readFileSync } from "fs";
 import { join } from "path";
-import { writeFileAtomicSafe } from "./fs-safe.js";
+import { writeFileAtomicSafe } from "../cli-kit/index.js";
 const AGENT_METADATA_FILE = "agent.json";
 function agentMetadataPath(cwd) {
     return join(cwd, ".mcpi", AGENT_METADATA_FILE);

package/dist/utils/dco/agent-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-metadata.js","sourceRoot":"","sources":["../../../src/utils/dco/agent-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAmBnD,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEzC,SAAS,iBAAiB,CAAC,GAAW;IACpC,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,OAAO,MAAuB,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,IAAmB;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAkB,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,sEAAsE;QACtE,mEAAmE;QACnE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACvC,MAAkC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnD,CAAC;IACH,CAAC;IACD,uEAAuE;IACvE,mBAAmB,CACjB,iBAAiB,CAAC,GAAG,CAAC,EACtB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CACvC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"agent-metadata.js","sourceRoot":"","sources":["../../../src/utils/dco/agent-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAmB1D,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEzC,SAAS,iBAAiB,CAAC,GAAW;IACpC,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,OAAO,MAAuB,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,IAAmB;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAkB,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,sEAAsE;QACtE,mEAAmE;QACnE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACvC,MAAkC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnD,CAAC;IACH,CAAC;IACD,uEAAuE;IACvE,mBAAmB,CACjB,iBAAiB,CAAC,GAAG,CAAC,EACtB,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CACvC,CAAC;AACJ,CAAC"}

package/dist/utils/dco/claude-config.d.ts

@@ -1,3 +1,4 @@
+import { type MergeJsonResult, type UpsertResult as CliKitUpsertResult } from "../cli-kit/index.js";
 /**
  * Claude Code integration: a managed block in CLAUDE.md instructs the agent
  * harness to attribute PRs to the registered agent, and .claude/settings.json
@@ -6,37 +7,40 @@
  * The PR byline can only be influenced through instructions because the PR
  * body is composed by the model at PR time; commit trailers are enforced
  * mechanically by the git hook instead (see git-config.ts).
+ *
+ * The block used to interpolate a specific agent's name/URL/DID as literal
+ * strings. That was wrong for any repo that receives dispatched work from
+ * more than one agent: CLAUDE.md is committed, so the literal values only
+ * ever reflected whichever agent happened to run `dco setup` first, and
+ * every other agent's PRs in that repo would carry a false attribution with
+ * no way to correct it short of re-running `dco setup` (which a dispatch
+ * flow generally can't do per task). The block below is agent-agnostic
+ * instead: it tells the agent to run `dco whoami` and use whatever
+ * that reports, so the byline is always whichever identity is actually
+ * configured in the current checkout. See resolve-agent.ts.
  */
 export declare const CLAUDE_MD_START = "<!-- mcpi:dco:start -->";
 export declare const CLAUDE_MD_END = "<!-- mcpi:dco:end -->";
 export interface AttributionBlockParams {
-    agentName: string;
-    agentUrl: string;
-    /**
-     * The agent's DID (e.g. `did:key:z6Mk...`). Included as a machine-readable
-     * companion to the human-readable byline so PR metadata resolves back to a
-     * specific KYA-OS registered agent identity, not just a display name.
-     */
-    agentDid?: string;
     /**
      * When the git hook could not be installed (foreign hook, unsafe
      * core.hooksPath, or install failure), trailer duty falls back to
      * instructions.
      */
     includeTrailerInstructions?: boolean;
-    humanName?: string;
-    humanEmail?: string;
-    agentEmail?: string;
 }
-export declare function buildAttributionBlock(params: AttributionBlockParams): string;
-export type UpsertResult = "created" | "updated" | "unchanged" | "would-change";
+export declare const DID_PATTERN: RegExp;
+export declare const MAX_DID_LENGTH = 200;
+export declare function isValidDid(value: string): boolean;
+export declare function buildAttributionBlock(params?: AttributionBlockParams): string;
+export type UpsertResult = CliKitUpsertResult;
 export declare function upsertClaudeMdBlock(cwd: string, block: string, options?: {
     dryRun?: boolean;
 }): {
     result: UpsertResult;
     path: string;
 };
-export type SettingsResult = "created" | "updated" | "unchanged" | "skipped-invalid" | "would-change";
+export type SettingsResult = MergeJsonResult;
 /**
  * Set includeCoAuthoredBy: false in .claude/settings.json, preserving every
  * other key. A file we cannot parse is left untouched: clobbering a user's

package/dist/utils/dco/claude-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-config.d.ts","sourceRoot":"","sources":["../../../src/utils/dco/claude-config.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,eAAO,MAAM,eAAe,4BAA4B,CAAC;AACzD,eAAO,MAAM,aAAa,0BAA0B,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA6BD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CA4B5E;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;AAEhF,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAiCxC;AAED,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,SAAS,GACT,WAAW,GACX,iBAAiB,GACjB,cAAc,CAAC;AAEnB;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAqC1C"}
+{"version":3,"file":"claude-config.d.ts","sourceRoot":"","sources":["../../../src/utils/dco/claude-config.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,YAAY,IAAI,kBAAkB,EACxC,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,eAAe,4BAA4B,CAAC;AACzD,eAAO,MAAM,aAAa,0BAA0B,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAQD,eAAO,MAAM,WAAW,QAAuC,CAAC;AAChE,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,sBAA2B,GAAG,MAAM,CAqBjF;AAED,MAAM,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAE9C,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CASxC;AAED,MAAM,MAAM,cAAc,GAAG,eAAe,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAG1C"}