cgraphx 1.4.1 → 2.0.0

package/dist/cli/index.js

@@ -0,0 +1,248 @@
+#!/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");
+// -----------------------------------------------------------------------------
+// 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();
+}
+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 to the latest release (or a specific version)')
+        .option('--check', 'Check whether an update is available without installing')
+        .option('-f, --force', 'Reinstall even if already on the target version')
+        .action(async (versionArg, options) => {
+        const up = await Promise.resolve().then(() => __importStar(require('./upgrade')));
+        const method = up.detectInstallMethod({
+            filename: __filename,
+            platform: process.platform,
+            cwd: process.cwd(),
+        });
+        const pin = versionArg || process.env.CGRAPHX_VERSION || undefined;
+        const code = await up.runUpgrade({ version: pin, check: options.check, force: options.force }, {
+            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,
+        });
+        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 (prompt-hook on, no prompts)')
+        .option('--prompt-hook <bool>', 'Wire the front-load prompt hook (true) or skip it (false)')
+        .action(async (opts) => {
+        const { runInstallerWithOptions } = await Promise.resolve().then(() => __importStar(require('./installer')));
+        const promptHook = opts.promptHook === undefined
+            ? undefined
+            : opts.promptHook === 'true';
+        try {
+            await runInstallerWithOptions({
+                target: opts.target,
+                promptHook,
+                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 / prompt-hook 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"}