domain-knowledge-kit 0.2.16 → 0.2.19

package/dist/features/agent/dkk-artifacts.js

@@ -0,0 +1,328 @@
+/**
+ * Canonical identification of DKK-managed AI assistant artifacts in a
+ * consumer's repo. Used by `dkk update` to safely sweep stale files and
+ * prune stale settings.json entries without touching user-authored content.
+ *
+ * Naming convention (single source of truth — keep changes here):
+ *
+ * - **Files** in `.claude/skills/`, `.claude/agents/`, `.claude/commands/`
+ *   are DKK-managed if their first path segment matches `dkk-*`.
+ * - **Hooks** in `.claude/hooks/` are identified by basename — only those
+ *   whose `.mjs` filename appears in the bundled settings.json template's
+ *   hook command strings are owned by DKK.
+ * - **Skill directories** in `.github/skills/` are DKK-managed if they
+ *   match `dkk-*`.
+ * - **permissions.allow** entries are DKK-managed iff they appear verbatim
+ *   in the bundled settings.json template's `permissions.allow`.
+ * - **LEGACY_DKK_PATHS** captures artifact paths that prior versions of
+ *   DKK installed and that current versions no longer ship — `update`
+ *   removes them so users on old releases don't carry stale files forever.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { basename, join, relative } from "node:path";
+import { packageClaudeDir, packageSkillsDir } from "../../shared/paths.js";
+import { extractHookBasename } from "./commands/init.js";
+/**
+ * Repo-relative paths that previous DKK versions installed but the current
+ * release no longer ships. `dkk update` removes any of these still present
+ * in a target repo. Append new entries here when a template file is
+ * renamed or retired.
+ */
+export const LEGACY_DKK_PATHS = [
+    ".github/skills/dkk-domain-knowledge",
+];
+/**
+ * Walk `tools/dkk/claude/` in the running DKK package and return the set of
+ * artifact basenames the template currently ships. Derived at runtime so
+ * future template additions don't require code changes here.
+ */
+export function dkkClaudeFiles() {
+    const inv = { hooks: [], skills: [], agents: [], commands: [] };
+    const src = packageClaudeDir();
+    if (!existsSync(src))
+        return inv;
+    inv.hooks = listFilesIfDir(join(src, "hooks"));
+    inv.skills = listDirsIfDir(join(src, "skills"));
+    inv.agents = listFilesIfDir(join(src, "agents"));
+    inv.commands = listFilesIfDir(join(src, "commands"));
+    return inv;
+}
+/**
+ * Skill directories the bundled `.github/skills/` template installs (e.g.
+ * `dkk-flow-implementer`). Returned as bare directory names.
+ */
+export function dkkGithubSkillDirs() {
+    const src = packageSkillsDir();
+    if (!existsSync(src))
+        return [];
+    return listDirsIfDir(src);
+}
+/**
+ * `permissions.allow` entries the bundled `settings.json` template ships.
+ * Empty array if the template is missing or unparseable — callers should
+ * treat that as "DKK doesn't own any permissions" rather than erroring.
+ */
+export function dkkPermissionAllowEntries() {
+    const settings = readBundledSettings();
+    if (!settings)
+        return [];
+    return settings.permissions?.allow ?? [];
+}
+/**
+ * Hook script basenames referenced by the bundled `settings.json` template
+ * (e.g. `session-start-prime.mjs`). Used to identify DKK-owned hook entries
+ * in a consumer's settings.json so they can be pruned cleanly.
+ */
+export function dkkHookBasenames() {
+    const settings = readBundledSettings();
+    if (!settings?.hooks)
+        return [];
+    const out = new Set();
+    for (const entries of Object.values(settings.hooks)) {
+        for (const entry of entries) {
+            for (const hook of entry.hooks ?? []) {
+                const b = extractHookBasename(hook.command);
+                if (b)
+                    out.add(b);
+            }
+        }
+    }
+    return [...out];
+}
+/**
+ * Read and parse the bundled `settings.json` template. Returns `null` if
+ * the file is missing or unparseable (failures are silent — see callers).
+ */
+function readBundledSettings() {
+    const path = join(packageClaudeDir(), "settings.json");
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function listFilesIfDir(dir) {
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir).filter((n) => {
+        try {
+            return statSync(join(dir, n)).isFile();
+        }
+        catch {
+            return false;
+        }
+    });
+}
+function listDirsIfDir(dir) {
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir).filter((n) => {
+        try {
+            return statSync(join(dir, n)).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/**
+ * Walk a target repo's `.claude/` and `.github/skills/` trees and return
+ * the set of paths the predicates flag as DKK-managed.
+ */
+export function scanInstalledArtifacts(root) {
+    const hookBasenames = new Set(dkkHookBasenames());
+    const scan = {
+        dkkPrefixedClaude: [],
+        dkkHooks: [],
+        githubSkillDirs: [],
+        legacy: [],
+    };
+    // .claude/skills, .claude/agents, .claude/commands — match dkk-* prefix.
+    for (const sub of ["skills", "agents", "commands"]) {
+        const dir = join(root, ".claude", sub);
+        if (!existsSync(dir))
+            continue;
+        for (const name of readdirSync(dir)) {
+            if (!name.startsWith("dkk-"))
+                continue;
+            const path = join(dir, name);
+            // skills/ is nested (one dir per skill); agents/ + commands/ are flat files.
+            if (sub === "skills") {
+                // Push the directory itself; sweep deletes recursively.
+                scan.dkkPrefixedClaude.push(path);
+            }
+            else {
+                scan.dkkPrefixedClaude.push(path);
+            }
+        }
+    }
+    // .claude/hooks — match basenames the bundled template defines.
+    const hooksDir = join(root, ".claude", "hooks");
+    if (existsSync(hooksDir)) {
+        for (const name of readdirSync(hooksDir)) {
+            if (hookBasenames.has(name))
+                scan.dkkHooks.push(join(hooksDir, name));
+        }
+    }
+    // .github/skills/dkk-*
+    const ghSkills = join(root, ".github", "skills");
+    if (existsSync(ghSkills)) {
+        for (const name of readdirSync(ghSkills)) {
+            if (!name.startsWith("dkk-"))
+                continue;
+            scan.githubSkillDirs.push(join(ghSkills, name));
+        }
+    }
+    // Legacy paths.
+    for (const legacyRel of LEGACY_DKK_PATHS) {
+        const abs = join(root, legacyRel);
+        if (existsSync(abs))
+            scan.legacy.push(abs);
+    }
+    return scan;
+}
+/**
+ * Compute the add / replace / remove triage between the bundled template
+ * and a target repo. Paths are returned as repo-relative POSIX paths.
+ *
+ * `toAdd` and `toReplace` are derived by enumerating the bundled template's
+ * shipped files; `toRemove` is the set of installed DKK-managed paths that
+ * have no counterpart in the new template.
+ */
+export function computeArtifactDiff(root) {
+    const diff = { toAdd: [], toReplace: [], toRemove: [] };
+    const claudeSrc = packageClaudeDir();
+    const skillsSrc = packageSkillsDir();
+    const inv = dkkClaudeFiles();
+    const installed = scanInstalledArtifacts(root);
+    const expectedInstalled = new Set();
+    // Hooks: flat files.
+    for (const name of inv.hooks) {
+        const srcPath = join(claudeSrc, "hooks", name);
+        const destPath = join(root, ".claude", "hooks", name);
+        expectedInstalled.add(destPath);
+        if (!existsSync(destPath)) {
+            diff.toAdd.push(toRel(root, destPath));
+        }
+        else if (!filesEqual(srcPath, destPath)) {
+            diff.toReplace.push(toRel(root, destPath));
+        }
+    }
+    // settings.json is intentionally left out of the diff: the prune+merge
+    // phase handles it independently and its content always differs from a
+    // fresh template (user customisations + additive merge state). Including
+    // it here would either always show "replace" on every run (noisy) or
+    // misleadingly suggest the file will be force-overwritten.
+    // Skills: nested (skill/<file>).
+    for (const skillName of inv.skills) {
+        const skillSrc = join(claudeSrc, "skills", skillName);
+        const skillDest = join(root, ".claude", "skills", skillName);
+        expectedInstalled.add(skillDest);
+        if (!existsSync(skillDest)) {
+            diff.toAdd.push(toRel(root, skillDest));
+            continue;
+        }
+        // Compare each file inside the skill dir.
+        let anyDiff = false;
+        for (const fileName of readdirSync(skillSrc)) {
+            const f = join(skillSrc, fileName);
+            try {
+                if (!statSync(f).isFile())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            const df = join(skillDest, fileName);
+            if (!existsSync(df) || !filesEqual(f, df)) {
+                anyDiff = true;
+                break;
+            }
+        }
+        if (anyDiff)
+            diff.toReplace.push(toRel(root, skillDest));
+    }
+    // Agents + commands: flat files.
+    for (const [sub, names] of [["agents", inv.agents], ["commands", inv.commands]]) {
+        for (const name of names) {
+            const srcPath = join(claudeSrc, sub, name);
+            const destPath = join(root, ".claude", sub, name);
+            expectedInstalled.add(destPath);
+            if (!existsSync(destPath)) {
+                diff.toAdd.push(toRel(root, destPath));
+            }
+            else if (!filesEqual(srcPath, destPath)) {
+                diff.toReplace.push(toRel(root, destPath));
+            }
+        }
+    }
+    // .github/skills/<dkk-*>
+    if (existsSync(skillsSrc)) {
+        for (const skillName of dkkGithubSkillDirs()) {
+            const skillSrcDir = join(skillsSrc, skillName);
+            const skillDestDir = join(root, ".github", "skills", skillName);
+            expectedInstalled.add(skillDestDir);
+            if (!existsSync(skillDestDir)) {
+                diff.toAdd.push(toRel(root, skillDestDir));
+                continue;
+            }
+            let anyDiff = false;
+            for (const fileName of readdirSync(skillSrcDir)) {
+                const f = join(skillSrcDir, fileName);
+                try {
+                    if (!statSync(f).isFile())
+                        continue;
+                }
+                catch {
+                    continue;
+                }
+                const df = join(skillDestDir, fileName);
+                if (!existsSync(df) || !filesEqual(f, df)) {
+                    anyDiff = true;
+                    break;
+                }
+            }
+            if (anyDiff)
+                diff.toReplace.push(toRel(root, skillDestDir));
+        }
+    }
+    // toRemove: any installed dkk-managed path not present in `expectedInstalled`,
+    // plus everything in `legacy` (which by definition is no longer shipped).
+    // De-duplicate because a legacy path can match both the `dkk-*` prefix
+    // predicate AND the LEGACY_DKK_PATHS list.
+    const seenRemove = new Set();
+    const candidates = [
+        ...installed.dkkPrefixedClaude,
+        ...installed.dkkHooks,
+        ...installed.githubSkillDirs,
+        ...installed.legacy,
+    ];
+    for (const path of candidates) {
+        if (expectedInstalled.has(path))
+            continue;
+        if (seenRemove.has(path))
+            continue;
+        seenRemove.add(path);
+        diff.toRemove.push(toRel(root, path));
+    }
+    return diff;
+}
+function filesEqual(a, b) {
+    try {
+        return readFileSync(a, "utf-8") === readFileSync(b, "utf-8");
+    }
+    catch {
+        return false;
+    }
+}
+function toRel(root, abs) {
+    return relative(root, abs).replace(/\\/g, "/");
+}
+/** True if `name` (basename or first path segment) starts with `dkk-`. */
+export function isDkkPrefixed(path) {
+    return basename(path).startsWith("dkk-");
+}
+//# sourceMappingURL=dkk-artifacts.js.map

package/dist/features/agent/dkk-artifacts.js.map

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

package/dist/features/agent/install-mode.d.ts

@@ -0,0 +1,34 @@
+export type InstallMode = "global" | "local" | "npx" | "unknown";
+export interface InstallInfo {
+    /** How the running dkk binary was installed. */
+    mode: InstallMode;
+    /** Absolute path to the package root of the running install. */
+    packageRoot: string;
+    /** Absolute path to the npm global prefix's `node_modules` if resolvable, else null. */
+    globalNodeModules: string | null;
+}
+/**
+ * Inspect the running dkk binary's location and return its install mode.
+ *
+ * Resolution order:
+ *   1. Path lives under `~/.npm/_npx/` → `npx`. npx installs are transient
+ *      caches; upgrading them is meaningless.
+ *   2. Path lives under the npm global `node_modules/` (resolved by
+ *      `npm root -g`) → `global`.
+ *   3. Otherwise treat as `local` — covers devDependency installs and
+ *      direct `tsx src/cli.ts` (dev) invocations alike. Callers that care
+ *      about the difference can re-check by looking for a host
+ *      `package.json` that depends on the package.
+ *   4. If `npm root -g` fails (npm not on PATH, unlikely) → `unknown`.
+ */
+export declare function detectInstallMode(): InstallInfo;
+/**
+ * Query the npm registry for the latest published version of `pkgName`.
+ *
+ * Uses `npm view <pkg> version` because it respects the user's npm config
+ * (registry overrides, auth tokens, proxies) without us having to
+ * re-implement any of that. Returns `null` on failure — callers should
+ * treat that as "can't check" rather than failing the whole command.
+ */
+export declare function fetchLatestVersion(): string | null;
+//# sourceMappingURL=install-mode.d.ts.map

package/dist/features/agent/install-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-mode.d.ts","sourceRoot":"","sources":["../../../src/features/agent/install-mode.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,IAAI,EAAE,WAAW,CAAC;IAClB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAkB/C;AAgBD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAYlD"}

package/dist/features/agent/install-mode.js

@@ -0,0 +1,78 @@
+/**
+ * Detect how the running `dkk` binary was installed.
+ *
+ * `dkk update` needs to know this to pick the right `npm install`
+ * incantation (global vs. local devDep) and to refuse upgrade attempts
+ * under `npx`, where there's no persistent install to upgrade.
+ */
+import { execFileSync } from "node:child_process";
+import { sep, normalize } from "node:path";
+import { homedir } from "node:os";
+import { packageRoot } from "../../shared/paths.js";
+import { pkgName } from "../../version.js";
+/**
+ * Inspect the running dkk binary's location and return its install mode.
+ *
+ * Resolution order:
+ *   1. Path lives under `~/.npm/_npx/` → `npx`. npx installs are transient
+ *      caches; upgrading them is meaningless.
+ *   2. Path lives under the npm global `node_modules/` (resolved by
+ *      `npm root -g`) → `global`.
+ *   3. Otherwise treat as `local` — covers devDependency installs and
+ *      direct `tsx src/cli.ts` (dev) invocations alike. Callers that care
+ *      about the difference can re-check by looking for a host
+ *      `package.json` that depends on the package.
+ *   4. If `npm root -g` fails (npm not on PATH, unlikely) → `unknown`.
+ */
+export function detectInstallMode() {
+    const pkgRoot = normalize(packageRoot());
+    const globalNm = resolveGlobalNodeModules();
+    const npxPrefix = normalize(`${homedir()}${sep}.npm${sep}_npx${sep}`);
+    if (pkgRoot.startsWith(npxPrefix)) {
+        return { mode: "npx", packageRoot: pkgRoot, globalNodeModules: globalNm };
+    }
+    if (globalNm && pkgRoot.startsWith(normalize(globalNm) + sep)) {
+        return { mode: "global", packageRoot: pkgRoot, globalNodeModules: globalNm };
+    }
+    if (!globalNm) {
+        return { mode: "unknown", packageRoot: pkgRoot, globalNodeModules: null };
+    }
+    return { mode: "local", packageRoot: pkgRoot, globalNodeModules: globalNm };
+}
+function resolveGlobalNodeModules() {
+    try {
+        const out = execFileSync("npm", ["root", "-g"], {
+            encoding: "utf-8",
+            timeout: 10_000,
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        const path = out.trim();
+        return path.length > 0 ? path : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Query the npm registry for the latest published version of `pkgName`.
+ *
+ * Uses `npm view <pkg> version` because it respects the user's npm config
+ * (registry overrides, auth tokens, proxies) without us having to
+ * re-implement any of that. Returns `null` on failure — callers should
+ * treat that as "can't check" rather than failing the whole command.
+ */
+export function fetchLatestVersion() {
+    try {
+        const out = execFileSync("npm", ["view", pkgName, "version"], {
+            encoding: "utf-8",
+            timeout: 15_000,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const v = out.trim();
+        return /^\d+\.\d+\.\d+/.test(v) ? v : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=install-mode.js.map

package/dist/features/agent/install-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-mode.js","sourceRoot":"","sources":["../../../src/features/agent/install-mode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAa3C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,wBAAwB,EAAE,CAAC;IAE5C,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,OAAO,EAAE,GAAG,GAAG,OAAO,GAAG,OAAO,GAAG,EAAE,CAAC,CAAC;IACtE,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;IAC5E,CAAC;IAED,IAAI,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;IAC/E,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAC5E,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,wBAAwB;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE;YAC9C,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE;YAC5D,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACrB,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/features/agent/mcp-register.d.ts

@@ -0,0 +1,20 @@
+export type McpRegisterOutcome = {
+    status: "already-registered";
+    via: "project" | "claude-cli";
+} | {
+    status: "registered";
+    via: "claude-cli" | "mcp-json";
+} | {
+    status: "skipped";
+    reason: string;
+} | {
+    status: "failed";
+    reason: string;
+};
+/**
+ * Detect existing registration → register via `claude mcp add` → fall back
+ * to writing `.mcp.json`. Returns a structured outcome rather than logging
+ * so callers can format the result as part of a larger summary.
+ */
+export declare function ensureMcpRegistered(root: string): McpRegisterOutcome;
+//# sourceMappingURL=mcp-register.d.ts.map

package/dist/features/agent/mcp-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-register.d.ts","sourceRoot":"","sources":["../../../src/features/agent/mcp-register.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,oBAAoB,CAAC;IAAC,GAAG,EAAE,SAAS,GAAG,YAAY,CAAA;CAAE,GAC/D;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,YAAY,GAAG,UAAU,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AASzC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA6BpE"}

package/dist/features/agent/mcp-register.js

@@ -0,0 +1,116 @@
+/**
+ * Register the DKK MCP server with Claude Code, with a fallback for
+ * environments where the `claude` CLI is unavailable.
+ *
+ * Order of attempts:
+ *
+ * 1. If a `dkk` MCP server is already present in the project's `.mcp.json`,
+ *    skip — we don't want to overwrite a user's customised entry.
+ * 2. If `which claude` succeeds, run `claude mcp add dkk -- dkk mcp`.
+ *    This writes into the user's Claude config (`~/.claude.json` or
+ *    equivalent), which is the canonical place for project-agnostic
+ *    Claude Code config.
+ * 3. Fallback: merge `{ "mcpServers": { "dkk": { "command": "dkk", "args": ["mcp"] } } }`
+ *    into the project's `.mcp.json`, preserving any other servers
+ *    already registered there.
+ *
+ * Failures are reported but never throw — `dkk update` continues even if
+ * MCP registration can't be completed automatically.
+ */
+import { execFileSync, spawnSync } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const SERVER_NAME = "dkk";
+/**
+ * Detect existing registration → register via `claude mcp add` → fall back
+ * to writing `.mcp.json`. Returns a structured outcome rather than logging
+ * so callers can format the result as part of a larger summary.
+ */
+export function ensureMcpRegistered(root) {
+    if (isRegisteredInProject(root)) {
+        return { status: "already-registered", via: "project" };
+    }
+    if (isRegisteredInClaudeCli()) {
+        return { status: "already-registered", via: "claude-cli" };
+    }
+    if (hasClaudeCli()) {
+        const result = spawnSync("claude", ["mcp", "add", SERVER_NAME, "--", "dkk", "mcp"], {
+            stdio: ["ignore", "pipe", "pipe"],
+            encoding: "utf-8",
+            timeout: 20_000,
+        });
+        if (result.status === 0) {
+            return { status: "registered", via: "claude-cli" };
+        }
+        // Fall through to .mcp.json if `claude mcp add` failed for some reason;
+        // we'd rather have a working entry than fail loudly here.
+    }
+    try {
+        writeToMcpJson(root);
+        return { status: "registered", via: "mcp-json" };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { status: "failed", reason: msg };
+    }
+}
+function isRegisteredInProject(root) {
+    const path = join(root, ".mcp.json");
+    if (!existsSync(path))
+        return false;
+    try {
+        const config = JSON.parse(readFileSync(path, "utf-8"));
+        return Boolean(config.mcpServers && SERVER_NAME in config.mcpServers);
+    }
+    catch {
+        return false;
+    }
+}
+function hasClaudeCli() {
+    try {
+        execFileSync("which", ["claude"], {
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 5_000,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isRegisteredInClaudeCli() {
+    if (!hasClaudeCli())
+        return false;
+    try {
+        const out = execFileSync("claude", ["mcp", "list"], {
+            stdio: ["ignore", "pipe", "ignore"],
+            encoding: "utf-8",
+            timeout: 10_000,
+        });
+        // `claude mcp list` prints one server per line; match a token-bounded
+        // `dkk` rather than a substring so we don't false-positive on
+        // names like `dkk-extended`.
+        return new RegExp(`(^|\\s|:)${SERVER_NAME}(\\s|:|$)`, "m").test(out);
+    }
+    catch {
+        return false;
+    }
+}
+function writeToMcpJson(root) {
+    const path = join(root, ".mcp.json");
+    let config = {};
+    if (existsSync(path)) {
+        try {
+            config = JSON.parse(readFileSync(path, "utf-8"));
+        }
+        catch {
+            // Corrupt .mcp.json — refuse to clobber it.
+            throw new Error(`.mcp.json exists but is not valid JSON; cannot merge dkk entry`);
+        }
+    }
+    if (!config.mcpServers)
+        config.mcpServers = {};
+    config.mcpServers[SERVER_NAME] = { command: "dkk", args: ["mcp"] };
+    writeFileSync(path, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+//# sourceMappingURL=mcp-register.js.map

package/dist/features/agent/mcp-register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-register.js","sourceRoot":"","sources":["../../../src/features/agent/mcp-register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAajC,MAAM,WAAW,GAAG,KAAK,CAAC;AAE1B;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;IAC1D,CAAC;IAED,IAAI,uBAAuB,EAAE,EAAE,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;IAC7D,CAAC;IAED,IAAI,YAAY,EAAE,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE;YAClF,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;QACrD,CAAC;QACD,wEAAwE;QACxE,0DAA0D;IAC5D,CAAC;IAED,IAAI,CAAC;QACH,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAiB,CAAC;QACvE,OAAO,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,WAAW,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE;YAChC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACnC,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB;IAC9B,IAAI,CAAC,YAAY,EAAE;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE;YAClD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACnC,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC;QACH,sEAAsE;QACtE,8DAA8D;QAC9D,6BAA6B;QAC7B,OAAO,IAAI,MAAM,CAAC,YAAY,WAAW,WAAW,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrC,IAAI,MAAM,GAAiB,EAAE,CAAC;IAC9B,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAiB,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;YAC5C,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC;IAC/C,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IACnE,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC"}

package/dist/features/agent/settings-prune.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Prune DKK-owned entries from a Claude `settings.json` payload.
+ *
+ * Used by `dkk update` to clear stale entries (e.g. hooks for scripts that
+ * have been renamed or removed) before re-applying the additive merge with
+ * the new template. User-authored entries are preserved untouched.
+ *
+ * Decision boundaries (see [[dkk-artifacts]] for the predicate source of
+ * truth):
+ *
+ * - A `permissions.allow` entry is DKK-owned iff it appears verbatim in
+ *   the bundled template's allow list. Exact string equality is the right
+ *   bar because the template's allow patterns are stable identifiers.
+ * - A `hooks.<event>` sub-entry is DKK-owned iff **every** `hooks[].command`
+ *   inside it resolves via {@link extractHookBasename} to a DKK basename.
+ *   Mixed entries (some DKK, some user-authored) are left intact and
+ *   reported as warnings — pruning them partially would mutate
+ *   user-authored data.
+ */
+import { type ClaudeSettings } from "./commands/init.js";
+export interface PruneResult {
+    pruned: ClaudeSettings;
+    /** Human-readable summary of what was removed. */
+    removed: string[];
+    /** Hook entries that contained a mix of DKK + user-owned commands; left intact. */
+    mixedHookWarnings: string[];
+}
+export declare function pruneDkkEntries(settings: ClaudeSettings, dkkAllow: ReadonlySet<string>, dkkHookBasenames: ReadonlySet<string>): PruneResult;
+//# sourceMappingURL=settings-prune.d.ts.map

package/dist/features/agent/settings-prune.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-prune.d.ts","sourceRoot":"","sources":["../../../src/features/agent/settings-prune.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,cAAc,CAAC;IACvB,kDAAkD;IAClD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mFAAmF;IACnF,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAC7B,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,GACpC,WAAW,CAmDb"}