cgraphx 1.4.3 → 2.0.1

package/dist/cli/fatal-handler.js

@@ -0,0 +1,109 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeFatal = describeFatal;
+exports.installFatalHandlers = installFatalHandlers;
+/**
+ * Last-resort handlers for uncaught exceptions and unhandled rejections.
+ *
+ * Reaching one of these means a fault escaped every boundary (per-request
+ * try/catch in command actions, schema-bootstrap's own error types, the
+ * timeline hook layer's fail-silent contract) — i.e. the process is in an
+ * undefined state. Node's default in that case is to print and exit
+ * non-zero; this module restores that safe default after logging a
+ * BOUNDED, hang-proof line.
+ *
+ * Two properties are load-bearing and covered by tests:
+ *   1. {@link describeFatal} never reads `error.stack` and never hands the
+ *      raw Error to `console.*`. The lazy stack getter can loop forever
+ *      inside this handler; touching it could block the very `exit()`
+ *      below. Name + message are plain string properties and are always
+ *      safe.
+ *   2. We write synchronously to fd 2 and then exit, so the message is
+ *      flushed even though `process.exit()` doesn't drain async streams.
+ *
+ * Migrated from cgraphx 1.x (src/bin/fatal-handler.ts) — the handler is
+ * generic process-level infrastructure, independent of the code-graph
+ * layer that 2.0 removes.
+ */
+const fs = __importStar(require("fs"));
+/**
+ * Render an uncaught value for the last-resort log WITHOUT triggering
+ * stack formatting. Pure and total — never throws, never touches `.stack`.
+ */
+function describeFatal(value) {
+    if (value instanceof Error) {
+        const name = typeof value.name === 'string' && value.name ? value.name : 'Error';
+        // `message` is a plain own/proto string property — reading it does NOT
+        // format the stack.
+        const message = typeof value.message === 'string' ? value.message : '';
+        return message ? `${name}: ${message}` : name;
+    }
+    try {
+        return String(value);
+    }
+    catch {
+        // e.g. an object with a throwing `toString` / `Symbol.toPrimitive`.
+        return '<unstringifiable value>';
+    }
+}
+/** Best-effort synchronous stderr write that can never keep a doomed process alive. */
+function writeStderr(line) {
+    try {
+        fs.writeSync(2, line);
+    }
+    catch {
+        /* stderr closed/gone — nothing more we can safely do */
+    }
+}
+/**
+ * Install the uncaught-exception / unhandled-rejection handlers. Both
+ * log a bounded line and then exit non-zero (Node's default fatal
+ * semantics).
+ */
+function installFatalHandlers(deps = {}) {
+    const target = deps.target ?? process;
+    const exit = deps.exit ?? ((code) => process.exit(code));
+    const write = deps.write ?? writeStderr;
+    target.on('uncaughtException', (error) => {
+        write(`[cgraphx] Uncaught exception: ${describeFatal(error)}\n`);
+        exit(1);
+    });
+    target.on('unhandledRejection', (reason) => {
+        write(`[cgraphx] Unhandled rejection: ${describeFatal(reason)}\n`);
+        exit(1);
+    });
+}
+//# sourceMappingURL=fatal-handler.js.map

package/dist/cli/fatal-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fatal-handler.js","sourceRoot":"","sources":["../../src/cli/fatal-handler.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,sCAcC;AA0BD,oDAcC;AAnFD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,uCAAyB;AAEzB;;;GAGG;AACH,SAAgB,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QACjF,uEAAuE;QACvE,oBAAoB;QACpB,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,OAAO,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAChD,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;QACpE,OAAO,yBAAyB,CAAC;IACnC,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,wDAAwD;IAC1D,CAAC;AACH,CAAC;AAYD;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,OAAyB,EAAE;IAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC;IAExC,MAAM,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAc,EAAE,EAAE;QAChD,KAAK,CAAC,iCAAiC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,CAAC,CAAC,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAe,EAAE,EAAE;QAClD,KAAK,CAAC,kCAAkC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,CAAC,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * cgraphx CLI — 2.0 main entry.
+ *
+ * Compiled to `./dist/cli/index.js` and wired as the `cgraphx` bin in
+ * package.json. The 2.0 command surface is the three reused subsystems
+ * (docs / db / timeline), the `init` / `status` project commands, the
+ * self-update `upgrade`, and the Claude Code `install` / `uninstall`
+ * flow.
+ *
+ * What was cut vs. the cgraphx 1.x lineage:
+ *   - every code-graph command (explore / query / node / callers /
+ *     callees / affected / index / sync / files / context / search / …)
+ *   - the MCP `serve` command (no server in 2.0)
+ *   - usage collection and the preAction usage-record hook (no collection in 2.0)
+ *   - `prompt-hook` (was a graph-front-load hook; no graph in 2.0)
+ *   - the WASM-runtime-flag re-exec (no extraction parser in 2.0)
+ *   - the Node 25 hard-block (the V8 turboshaft bug it guarded only fired
+ *     while compiling the extraction parser)
+ *
+ * What was kept: commander-based framing, ANSI helpers, the
+ * `installFatalHandlers` last-resort handler, the Node floor check, the
+ * no-args-runs-installer affordance, and the `-v` / `-version`
+ * spellings.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/cli/index.js

@@ -0,0 +1,284 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * cgraphx CLI — 2.0 main entry.
+ *
+ * Compiled to `./dist/cli/index.js` and wired as the `cgraphx` bin in
+ * package.json. The 2.0 command surface is the three reused subsystems
+ * (docs / db / timeline), the `init` / `status` project commands, the
+ * self-update `upgrade`, and the Claude Code `install` / `uninstall`
+ * flow.
+ *
+ * What was cut vs. the cgraphx 1.x lineage:
+ *   - every code-graph command (explore / query / node / callers /
+ *     callees / affected / index / sync / files / context / search / …)
+ *   - the MCP `serve` command (no server in 2.0)
+ *   - usage collection and the preAction usage-record hook (no collection in 2.0)
+ *   - `prompt-hook` (was a graph-front-load hook; no graph in 2.0)
+ *   - the WASM-runtime-flag re-exec (no extraction parser in 2.0)
+ *   - the Node 25 hard-block (the V8 turboshaft bug it guarded only fired
+ *     while compiling the extraction parser)
+ *
+ * What was kept: commander-based framing, ANSI helpers, the
+ * `installFatalHandlers` last-resort handler, the Node floor check, the
+ * no-args-runs-installer affordance, and the `-v` / `-version`
+ * spellings.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const path = __importStar(require("node:path"));
+const fs = __importStar(require("node:fs"));
+const cli_1 = require("../core/markdown/cli");
+const cli_2 = require("../core/dbquery/cli");
+const cli_3 = require("../core/timeline/cli");
+const cli_4 = require("../core/features/cli");
+// 组合根例外(仅此一处):cli/index.ts 作为组装入口可经 web 门面接入
+// `cgraphx web`;src/web/ 自身只依赖 src/core/,不反向依赖 cli。
+const web_1 = require("../web");
+const node_version_check_1 = require("./node-version-check");
+const fatal_handler_1 = require("./fatal-handler");
+const directory_1 = require("../core/directory");
+// -----------------------------------------------------------------------------
+// Node.js version floor.
+//
+// `engines` in package.json only *warns* on install (unless engine-strict),
+// so we hard-block here to actually keep users off unsupported versions.
+// The Node 25 special-case from cgraphx 1.x is intentionally gone — that
+// block existed solely because of a V8 turboshaft JIT bug that fired while
+// compiling the 1.x extraction parser, which 2.0 no longer ships.
+// -----------------------------------------------------------------------------
+const nodeVersion = process.versions.node;
+const nodeMajor = parseInt(nodeVersion.split('.')[0] ?? '0', 10);
+if (nodeMajor < node_version_check_1.MIN_NODE_MAJOR) {
+    process.stderr.write((0, node_version_check_1.buildNodeTooOldBanner)(nodeVersion) + '\n');
+    if (!process.env.CGRAPHX_ALLOW_UNSAFE_NODE) {
+        process.exit(1);
+    }
+    // Override active — banner shown for visibility, continuing.
+}
+// Last-resort fatal handlers. See ./fatal-handler.ts for the rationale
+// (the bounded, hang-proof log line is load-bearing).
+(0, fatal_handler_1.installFatalHandlers)();
+// -----------------------------------------------------------------------------
+// No-args → interactive installer (same affordance as cgraphx 1.x).
+// -----------------------------------------------------------------------------
+if (process.argv.length === 2) {
+    Promise.resolve().then(() => __importStar(require('./installer'))).then(({ runInstaller }) => runInstaller())
+        .catch((err) => {
+        console.error('Installation failed:', err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+}
+else {
+    main();
+}
+// Dynamic import helper — tsc compiles import() to require() in CJS mode,
+// which fails for ESM-only packages (@clack/prompts). Same trick as the
+// installer.
+// eslint-disable-next-line @typescript-eslint/no-implied-eval
+const importESM = new Function('specifier', 'return import(specifier)');
+/**
+ * Confirmation gate for `upgrade`'s auto project-install when the current
+ * directory doesn't look like a cgraphx project (no `.cgraphx/` / `.claude/`).
+ * Non-interactive stdin declines (safe default for scripts); a cancelled
+ * prompt or a prompt failure also declines — upgrade degrades to
+ * "package updated, run install yourself", never crashes on a prompt.
+ */
+async function confirmProjectInstall(message) {
+    if (!process.stdin.isTTY)
+        return false;
+    try {
+        const clack = await importESM('@clack/prompts');
+        const ans = await clack.confirm({ message, initialValue: false });
+        return clack.isCancel(ans) ? false : ans;
+    }
+    catch {
+        return false;
+    }
+}
+function main() {
+    const program = new commander_1.Command();
+    // Version from package.json. Reading it at runtime keeps a single source
+    // of truth — `npm version` bumps flow through without touching this file.
+    const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+    // Intercept lowercase `-v` and single-dash `-version` before commander parses
+    // (its `--version` short flag is capital `-V`, and its parser rejects a
+    // multi-character single-dash flag). The bare `cgraphx version` subcommand
+    // is registered further down so the affordance also shows up in `--help`.
+    const firstArg = process.argv[2];
+    if (firstArg === '-v' || firstArg === '-version') {
+        console.log(packageJson.version);
+        return;
+    }
+    // ===========================================================================
+    // ANSI helpers (avoid chalk ESM issues).
+    // ===========================================================================
+    const colors = {
+        reset: '\x1b[0m',
+        bold: '\x1b[1m',
+        dim: '\x1b[2m',
+        red: '\x1b[31m',
+        green: '\x1b[32m',
+        yellow: '\x1b[33m',
+        blue: '\x1b[34m',
+        cyan: '\x1b[36m',
+    };
+    const chalk = {
+        bold: (s) => `${colors.bold}${s}${colors.reset}`,
+        dim: (s) => `${colors.dim}${s}${colors.reset}`,
+        red: (s) => `${colors.red}${s}${colors.reset}`,
+        green: (s) => `${colors.green}${s}${colors.reset}`,
+        yellow: (s) => `${colors.yellow}${s}${colors.reset}`,
+        blue: (s) => `${colors.blue}${s}${colors.reset}`,
+        cyan: (s) => `${colors.cyan}${s}${colors.reset}`,
+    };
+    program
+        .name('cgraphx')
+        .description('Local markdown knowledge base, database query, and developer timeline toolkit for AI coding agents.')
+        .version(packageJson.version);
+    // ===========================================================================
+    // Subsystem command groups (B-3 / B-4 / B-5).
+    // ===========================================================================
+    (0, cli_1.registerDocsCommands)(program);
+    (0, cli_2.registerDbCommands)(program);
+    (0, cli_3.registerTimelineCommands)(program);
+    (0, cli_4.registerFeaturesCommands)(program);
+    // web — 本地只读浏览服务(顶层命令,经 web 门面注册;组合根例外见上方 import)。
+    (0, web_1.registerWebCommand)(program);
+    // ===========================================================================
+    // (init / status / uninit were folded into install / uninstall — see the
+    // installer. `install` creates `.cgraphx/` + applies schemas; `uninstall`
+    // removes it. There is no separate data-layer command in 2.0.)
+    // ===========================================================================
+    // ===========================================================================
+    // upgrade — inline registration (matches cgraphx 1.x; no register()
+    // wrapper). Dynamic import keeps startup fast and isolates the network
+    // module.
+    // ===========================================================================
+    program
+        .command('upgrade [version]')
+        .description('Update cgraphx and refresh the current project (pull the package, then auto-run install)')
+        .option('--check', 'Check whether an update is available without installing')
+        .option('-f, --force', 'Reinstall even if already on the target version')
+        .option('--no-install', 'Only update the package; skip refreshing the current project')
+        .action(async (versionArg, options) => {
+        const up = await Promise.resolve().then(() => __importStar(require('./upgrade')));
+        const projectRoot = process.cwd();
+        const method = up.detectInstallMethod({
+            filename: __filename,
+            platform: process.platform,
+            cwd: projectRoot,
+        });
+        const pin = versionArg || process.env.CGRAPHX_VERSION || undefined;
+        const code = await up.runUpgrade({
+            version: pin,
+            check: options.check,
+            force: options.force,
+            install: options.install,
+        }, {
+            currentVersion: packageJson.version,
+            method,
+            resolveLatest: () => up.resolveLatestVersion(),
+            run: up.defaultRun,
+            log: (m) => console.log(m),
+            warn: (m) => console.log(chalk.yellow(m)),
+            error: (m) => console.error(chalk.red(m)),
+            platform: process.platform,
+            projectRoot,
+            unsafeRootReason: (dir) => (0, directory_1.unsafeIndexRootReason)(dir),
+            projectMarkerPresent: (dir) => fs.existsSync((0, directory_1.getCodeGraphDir)(dir)) ||
+                fs.existsSync(path.join(dir, '.claude')),
+            confirmInstall: confirmProjectInstall,
+            currentCliEntry: __filename,
+            nodeExecPath: process.execPath,
+            npmGlobalRoot: () => up.resolveNpmGlobalRoot(process.platform),
+            runInstall: up.defaultRunInstall,
+        });
+        process.exit(code);
+    });
+    // ===========================================================================
+    // version — bare-noun form of `--version`.
+    // ===========================================================================
+    program
+        .command('version')
+        .description('Print the installed cgraphx version (also: -v, --version)')
+        .action(() => {
+        console.log(packageJson.version);
+    });
+    // ===========================================================================
+    // install / uninstall — delegate to the installer (B-9).
+    // ===========================================================================
+    program
+        .command('install')
+        .description('Install cgraphx into the current project (skills, hooks, statusLine, .cgraphx/)')
+        .option('-t, --target <ids>', 'Target agent(s) (2.0 ships only Claude)')
+        .option('-y, --yes', 'Non-interactive: use defaults (all subsystems, no prompts)')
+        .action(async (opts) => {
+        const { runInstallerWithOptions } = await Promise.resolve().then(() => __importStar(require('./installer')));
+        try {
+            await runInstallerWithOptions({
+                target: opts.target,
+                yes: opts.yes,
+            });
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    program
+        .command('uninstall')
+        .description('Remove cgraphx from the current project (skills, config, .cgraphx/)')
+        .option('-t, --target <ids>', 'Target agent(s) (2.0 ships only Claude)')
+        .option('-y, --yes', 'Non-interactive: no prompts (also deletes .cgraphx/ without confirming)')
+        .option('--keep-data', 'Keep the .cgraphx/ data directory (default: remove it)')
+        .action(async (opts) => {
+        const { runUninstaller } = await Promise.resolve().then(() => __importStar(require('./installer')));
+        try {
+            await runUninstaller({
+                target: opts.target,
+                yes: opts.yes,
+                keepData: opts.keepData,
+            });
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    program.parse();
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/installer/claude-assets.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Deploy the `.claude/` template (skills / agents / commands / hooks /
+ * plugins) shipped with cgraphx into a target project's `.claude/` directory.
+ *
+ * Template source: `dist/.claude-template/` (populated by `copy-assets` from
+ * `<repo-root>/.claude/{skills,agents,commands,hooks,plugins}`). The template
+ * excludes `settings.json`, `settings.local.json`, dotfiles, and
+ * `node_modules/` — those are either user-owned, platform-specific, or
+ * contain binary artifacts. Project guides (coding standards, glossaries,
+ * DDL references, etc.) are NOT shipped — users author those themselves
+ * under `docs/` (the `knowledge-write` skill indexes that location).
+ *
+ * Conflict policy: **same-name overwrites unconditionally**.
+ *   - File in template, NOT in target → created
+ *   - File in template AND in target → overwritten (regardless of content;
+ *     the cgraphx version is the source of truth — skills are tools, not
+ *     user-owned)
+ *   - File in target but NOT in template → untouched (user's custom skills,
+ *     commands stay; only files shipped by cgraphx get synced)
+ *
+ * Rationale: cgraphx skills are tools maintained by the project, just like
+ * the CLI itself — upgrades should propagate. If a user wants their own
+ * version, they should ship it under a different filename. The filename is
+ * the contract; the content is cgraphx's responsibility.
+ *
+ * Uninstall policy: the template files are NOT removed on uninstall —
+ * `cgraphx uninstall` only removes hooks / statusLine entries
+ * from settings.json. (Removing user files is destructive; a separate
+ * `--purge-claude-assets` flag is a later-stage decision.)
+ */
+export type ClaudeAssetAction = 'created' | 'overwritten' | 'not-found' | 'removed';
+export interface ClaudeAssetChange {
+    /** Project-relative path under `.claude/`, e.g. `skills/execute-plan/SKILL.md`. */
+    path: string;
+    action: ClaudeAssetAction;
+}
+/**
+ * Deploy the `.claude/` template into `<targetClaudeDir>`.
+ *
+ * @param targetClaudeDir  Absolute path to the destination `.claude/`
+ *                         (e.g. `/path/to/project/.claude`).
+ * @returns Per-file outcomes. Empty array when no template exists.
+ */
+export declare function deployClaudeAssets(targetClaudeDir: string): ClaudeAssetChange[];
+/**
+ * 读取模板根目录的 `deprecated-assets.json`,删除目标 `.claude/` 下对应的
+ * 旧路径。幂等:路径不存在则跳过。install 和 uninstall 都调用,确保升级
+ * 后改名/移除的包自带资产(如 `skills/code-impact-docgen`)不会残留。
+ *
+ * 只删清单里列出的路径,绝不 rm -rf 整个分类目录——用户自建的同名
+ * 内容不受影响(清单只收录包曾经部署过的路径)。
+ *
+ * @param targetClaudeDir  目标 `.claude/` 绝对路径
+ * @param overrideTemplateDir  可选模板目录(测试用 fixture;默认 dist 内嵌)
+ */
+export declare function cleanDeprecatedAssets(targetClaudeDir: string, overrideTemplateDir?: string): ClaudeAssetChange[];
+/**
+ * Read the workflow-guidance content shipped at the template root
+ * (`dist/.claude-template/CLAUDE.md`, authored as
+ * `assets/claude-template/CLAUDE.md` and copied by `copy-assets`).
+ *
+ * The Claude target wraps this content in a `<!-- CGRAPHX_START/END -->`
+ * marker block and upserts it into the project's `.claude/CLAUDE.md` (see
+ * `targets/claude.ts`) instead of deploying it verbatim — that keeps it
+ * regenerable on reinstall and strippable on uninstall without clobbering
+ * any surrounding user content. `deployClaudeAssets` correspondingly skips
+ * the template-root CLAUDE.md.
+ *
+ * @param overrideDir  Optional template directory; tests point this at a
+ *                     fixture. Defaults to the baked-in `dist/.claude-template/`.
+ * @returns The file content, or `null` when the template dir or the file is
+ *          absent (e.g. running from source before a build). Callers treat
+ *          `null` as "skip the instructions write" rather than failing.
+ */
+export declare function readTemplateClaudeMd(overrideDir?: string): string | null;
+/**
+ * Remove the `.claude/` assets this package deploys — the inverse of
+ * `deployClaudeAssets`. Driven by the package's own template manifest (NOT a
+ * hardcoded list): we enumerate the immediate children of each top-level
+ * category dir the template ships (`skills/<name>`, `commands/<name>.md`,
+ * `agents/<name>.md`, `hooks/<name>`, `plugins/<name>`, …) and remove the
+ * matching path under `<targetClaudeDir>`.
+ *
+ * Two consequences worth noting:
+ *  - Removing by top-level unit (a whole skill dir, a command file) makes the
+ *    internal file count irrelevant — a skill that gained/lost files across
+ *    versions is still cleanly removed, with no orphans.
+ *  - Anything the user added that ISN'T in this version's manifest (e.g. a
+ *    copied-and-renamed skill) is left untouched — we never `rm -rf` a whole
+ *    category dir.
+ *
+ * The template-root `CLAUDE.md` is excluded here — it's owned by the marker
+ * block in `.claude/CLAUDE.md`, which the Claude target strips separately.
+ *
+ * @param overrideTemplateDir  Optional template dir (tests pass a fixture;
+ *                             defaults to the baked-in `dist/.claude-template/`).
+ * @returns One `removed` entry per path actually deleted, or a single
+ *          `not-found` when there's no template to derive a manifest from.
+ */
+export declare function removeClaudeAssets(targetClaudeDir: string, overrideTemplateDir?: string): ClaudeAssetChange[];
+//# sourceMappingURL=claude-assets.d.ts.map

package/dist/cli/installer/claude-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-assets.d.ts","sourceRoot":"","sources":["../../../src/cli/installer/claude-assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAKH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAUpF,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AA8CD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAmC/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EACvB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,iBAAiB,EAAE,CA6BrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQxE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,EACvB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,iBAAiB,EAAE,CA2DrB"}