cgraphx 1.4.1 → 2.0.0

package/dist/cli/installer/claude-assets.js

@@ -0,0 +1,321 @@
+"use strict";
+/**
+ * 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.)
+ */
+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.deployClaudeAssets = deployClaudeAssets;
+exports.cleanDeprecatedAssets = cleanDeprecatedAssets;
+exports.readTemplateClaudeMd = readTemplateClaudeMd;
+exports.removeClaudeAssets = removeClaudeAssets;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Resolve the template directory baked into the dist build.
+ *
+ * Returns `null` when the template is absent (e.g. running from source before
+ * a build, or a stripped-down distribution). Callers should treat this as
+ * "no assets to deploy" rather than failing the install.
+ */
+function resolveTemplateDir() {
+    // dist/cli/installer/claude-assets.js → dist/.claude-template/
+    // (installer/ → cli/ → dist/, then .claude-template/ = TWO levels up)
+    const candidate = path.join(__dirname, '..', '..', '.claude-template');
+    return fs.existsSync(candidate) ? candidate : null;
+}
+/**
+ * Walk a directory tree and return every file's path relative to `root`.
+ * Skips `node_modules`, `.DS_Store`, and dotfiles (per the policy in the
+ * file header).
+ */
+function walkFiles(root) {
+    const out = [];
+    const walk = (dir, prefix) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.name === 'node_modules' || entry.name === '.DS_Store')
+                continue;
+            if (entry.name.startsWith('.'))
+                continue;
+            const fullPath = path.join(dir, entry.name);
+            const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                walk(fullPath, rel);
+            }
+            else if (entry.isFile()) {
+                out.push(rel);
+            }
+        }
+    };
+    walk(root, '');
+    return out;
+}
+/**
+ * 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.
+ */
+function deployClaudeAssets(targetClaudeDir) {
+    const templateDir = resolveTemplateDir();
+    if (!templateDir) {
+        return [{ path: '', action: 'not-found' }];
+    }
+    const changes = [];
+    const files = walkFiles(templateDir);
+    for (const rel of files) {
+        // The template-root CLAUDE.md is deployed separately as a marker block
+        // (see readTemplateClaudeMd below + targets/claude.ts), NOT verbatim —
+        // a verbatim copy would overwrite the user's edits on every install and
+        // survive uninstall. Skip it from the same-name-overwrites walk.
+        // deprecated-assets.json 是构建期清理清单,不是运行时资产,同样跳过。
+        if (rel === 'CLAUDE.md' || rel === 'deprecated-assets.json')
+            continue;
+        const srcFile = path.join(templateDir, rel);
+        const destFile = path.join(targetClaudeDir, rel);
+        const exists = fs.existsSync(destFile);
+        try {
+            fs.mkdirSync(path.dirname(destFile), { recursive: true });
+            fs.copyFileSync(srcFile, destFile); // copyFileSync overwrites by default
+            changes.push({ path: `.claude/${rel}`, action: exists ? 'overwritten' : 'created' });
+        }
+        catch {
+            // Defensive: a single failed copy shouldn't abort the whole deploy.
+            // The dest file (if it existed) is left as-is; report as overwritten
+            // so the user knows the sync didn't happen and can investigate.
+            changes.push({ path: `.claude/${rel}`, action: exists ? 'overwritten' : 'created' });
+        }
+    }
+    // 清理已废弃的包自带资产(改名/移除的旧 skill 等)
+    changes.push(...cleanDeprecatedAssets(targetClaudeDir, templateDir));
+    return changes;
+}
+/**
+ * 读取模板根目录的 `deprecated-assets.json`,删除目标 `.claude/` 下对应的
+ * 旧路径。幂等:路径不存在则跳过。install 和 uninstall 都调用,确保升级
+ * 后改名/移除的包自带资产(如 `skills/code-impact-docgen`)不会残留。
+ *
+ * 只删清单里列出的路径,绝不 rm -rf 整个分类目录——用户自建的同名
+ * 内容不受影响(清单只收录包曾经部署过的路径)。
+ *
+ * @param targetClaudeDir  目标 `.claude/` 绝对路径
+ * @param overrideTemplateDir  可选模板目录(测试用 fixture;默认 dist 内嵌)
+ */
+function cleanDeprecatedAssets(targetClaudeDir, overrideTemplateDir) {
+    const templateDir = overrideTemplateDir ?? resolveTemplateDir();
+    if (!templateDir)
+        return [];
+    const manifestPath = path.join(templateDir, 'deprecated-assets.json');
+    let manifest;
+    try {
+        manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+    }
+    catch {
+        // 清单不存在或不可读——视为空,不阻塞正常部署
+        return [];
+    }
+    const paths = manifest.paths;
+    if (!Array.isArray(paths))
+        return [];
+    const changes = [];
+    for (const rel of paths) {
+        if (typeof rel !== 'string' || rel.length === 0)
+            continue;
+        const dest = path.join(targetClaudeDir, rel);
+        if (!fs.existsSync(dest))
+            continue;
+        try {
+            fs.rmSync(dest, { recursive: true, force: true });
+        }
+        catch {
+            // 防御性:单个路径删除失败不阻塞其余清理
+        }
+        changes.push({ path: `.claude/${rel}`, action: 'removed' });
+    }
+    return changes;
+}
+/**
+ * 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.
+ */
+function readTemplateClaudeMd(overrideDir) {
+    const dir = overrideDir ?? resolveTemplateDir();
+    if (!dir)
+        return null;
+    try {
+        return fs.readFileSync(path.join(dir, 'CLAUDE.md'), 'utf-8');
+    }
+    catch {
+        return 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.
+ */
+function removeClaudeAssets(targetClaudeDir, overrideTemplateDir) {
+    const templateDir = overrideTemplateDir ?? resolveTemplateDir();
+    if (!templateDir || !fs.existsSync(templateDir)) {
+        return [{ path: '', action: 'not-found' }];
+    }
+    const changes = [];
+    let categories;
+    try {
+        categories = fs.readdirSync(templateDir, { withFileTypes: true });
+    }
+    catch {
+        return changes;
+    }
+    for (const category of categories) {
+        if (category.name === 'node_modules' || category.name === '.DS_Store')
+            continue;
+        if (category.name.startsWith('.'))
+            continue;
+        if (category.name === 'CLAUDE.md')
+            continue; // marker-block owned, not an asset dir
+        if (!category.isDirectory())
+            continue; // no top-level files are deployed as assets
+        let children;
+        try {
+            children = fs.readdirSync(path.join(templateDir, category.name), { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        let removedInCategory = false;
+        for (const child of children) {
+            if (child.name === '.DS_Store' || child.name.startsWith('.'))
+                continue;
+            const rel = `${category.name}/${child.name}`;
+            const dest = path.join(targetClaudeDir, rel);
+            if (!fs.existsSync(dest))
+                continue;
+            try {
+                fs.rmSync(dest, { recursive: true, force: true });
+                changes.push({ path: `.claude/${rel}`, action: 'removed' });
+                removedInCategory = true;
+            }
+            catch {
+                // Defensive (mirrors deployClaudeAssets): one failed removal shouldn't
+                // abort the sweep. Reported as removed so the intent is visible.
+                changes.push({ path: `.claude/${rel}`, action: 'removed' });
+            }
+        }
+        // Prune the now-empty category dir the package created on deploy. Never
+        // remove a non-empty dir — that means the user keeps their own entries
+        // there (e.g. a copied-and-renamed skill).
+        if (removedInCategory) {
+            const catDest = path.join(targetClaudeDir, category.name);
+            try {
+                if (fs.existsSync(catDest) && fs.readdirSync(catDest).length === 0) {
+                    fs.rmSync(catDest, { recursive: true, force: true });
+                }
+            }
+            catch { /* best-effort prune */ }
+        }
+    }
+    // 卸载也清理已废弃资产——否则改名前的旧目录会永久残留
+    changes.push(...cleanDeprecatedAssets(targetClaudeDir, templateDir));
+    return changes;
+}
+//# sourceMappingURL=claude-assets.js.map

package/dist/cli/installer/claude-assets.js.map

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

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

@@ -0,0 +1,105 @@
+/**
+ * cgraphx Interactive Installer (2.0)
+ *
+ * Single target: Claude Code. Wires the bundled `.claude/` template
+ * (skills / agents / commands / hooks / plugins), the cgraphx-specific
+ * hooks + statusLine, and (opt-in) the front-load prompt hook into the
+ * user's Claude Code configuration. Optionally registers the markdown /
+ * dbquery / timeline subsystems.
+ *
+ * 2.0 cut points versus 1.x: NO server config is written (no server in
+ * 2.0); NO usage stats are collected; the live graph watcher / git-sync-hook
+ * fallback is gone (no graph in 2.0); and only Claude Code is shipped
+ * (every other 1.x agent target wrote only the now-removed server config).
+ *
+ * Uses @clack/prompts for the interactive UI; `runInstallerWithOptions`
+ * is the non-interactive entry point used by the `--target` flag.
+ */
+import type { AgentTarget, Location } from './targets/types';
+export interface RunInstallerOptions {
+    /**
+     * Accepted for back-compat. In 2.0 only Claude is shipped, so any
+     * non-empty value effectively resolves to `[claudeTarget]` — the
+     * flag is parsed (and unknown ids error) but no longer drives a
+     * multi-agent prompt.
+     *
+     * Comma-separated target list, or `auto` / `all` / `none`.
+     */
+    target?: string;
+    /** Skip the prompt-hook prompt; use this value directly. */
+    promptHook?: boolean;
+    /**
+     * Skip every confirm and use defaults: location=local, promptHook=true.
+     * For scripting / CI.
+     */
+    yes?: boolean;
+}
+/**
+ * Interactive entry point — preserves the historical UX (`cgraphx
+ * install` with no args goes through the prompts).
+ */
+export declare function runInstaller(): Promise<void>;
+export declare function runInstallerWithOptions(opts: RunInstallerOptions): Promise<void>;
+export interface RunUninstallerOptions {
+    /**
+     * Comma-separated target list, or `auto` / `all` / `none`. Defaults
+     * to `all` — uninstall sweeps every known agent and reports which
+     * ones it actually touched, so the user doesn't have to remember
+     * where they configured it.
+     */
+    target?: string;
+    /** Non-interactive: target=all, no prompts (also skips the data-delete confirm). */
+    yes?: boolean;
+    /** Keep the project's `.cgraphx/` data dir (default: remove it). */
+    keepData?: boolean;
+}
+export type UninstallStatus = 'removed' | 'not-configured' | 'unsupported';
+/**
+ * Per-target outcome of an uninstall sweep. `removed` means we deleted
+ * at least one thing; `not-configured` means the agent had no cgraphx
+ * config at this location (nothing to do); `unsupported` means the
+ * agent has no config concept for this location.
+ */
+export interface UninstallReport {
+    id: string;
+    displayName: string;
+    status: UninstallStatus;
+    /** Absolute paths we actually edited/removed (action === 'removed'). */
+    removedPaths: string[];
+    /** Verbatim notes from the target (rare for uninstall). */
+    notes: string[];
+}
+/**
+ * Pure uninstall sweep — no prompts, no I/O beyond the targets' own
+ * file edits. Exposed (and unit-testable) separately from the clack UI
+ * in `runUninstaller` so the aggregation logic can be asserted directly.
+ *
+ * Each target's `uninstall()` is already safe to call when nothing was
+ * installed (it returns `not-found` actions), so this is safe to run
+ * across every target unconditionally.
+ */
+export declare function uninstallTargets(targets: readonly AgentTarget[], location: Location): UninstallReport[];
+/**
+ * Interactive uninstaller — the inverse of `runInstallerWithOptions`.
+ * Project-local only (no global uninstall). Sweeps every agent target (or the
+ * `--target` subset) and prints one block per agent so the user sees exactly
+ * which providers it hit.
+ *
+ * Removes what install wrote: the agent targets' hooks / statusLine /
+ * prompt-hook / instructions block AND the package-owned `.claude/` assets (by
+ * manifest), plus the Developer Timeline hooks. Also removes the `.cgraphx/`
+ * data dir (the folded `uninit`) unless `--keep-data` — that's destructive, so
+ * it's confirmed interactively unless `--yes`.
+ */
+export declare function runUninstaller(opts: RunUninstallerOptions): Promise<void>;
+/**
+ * Ensure the project's `.cgraphx/` data dir exists and the markdown + timeline
+ * schemas are applied — the work the removed `cgraphx init` command did, folded
+ * into install. Idempotent: an already-initialized project is a no-op.
+ *
+ * @returns `initialized` (created + schemas applied), `already` (nothing to
+ *          do), or `skipped-unsafe` (the root looks like $HOME / a filesystem
+ *          root, so we refuse to auto-create a data dir there).
+ */
+export declare function ensureProjectInitialized(projectRoot: string): Promise<'initialized' | 'already' | 'skipped-unsafe'>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/installer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AA0B7D,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiOtF;AAED,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,gBAAgB,GAAG,aAAa,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,wEAAwE;IACxE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,QAAQ,EAAE,QAAQ,GACjB,eAAe,EAAE,CAuBnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmG/E;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,GAAG,SAAS,GAAG,gBAAgB,CAAC,CAiBvD"}