@ngockhoale/ukit 1.5.5 → 1.5.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngockhoale/ukit",
-  "version": "1.5.5",
+  "version": "1.5.6",
   "description": "Install/update an index-first AI workspace for Claude Code, Antigravity, OpenAI Codex, and OpenCode.",
   "license": "MIT",
   "type": "module",

package/src/cli/commands/diff.js

@@ -18,6 +18,7 @@ export async function runDiff({ packageRoot, projectRoot, packageVersion, argv =
   const toolsArg = parseToolsArg(argv);
   const selectedOptionalTools = resolveOptionalToolKeys(toolsArg);
   const selectedAdapterItemIds = toSelectedAdapterItemIds(selectedOptionalTools);
+  const withCodegraph = argv.includes('--with-codegraph');
 
   const pathConfig = buildPathConfig({ packageRoot, projectRoot });
 
@@ -26,6 +27,7 @@ export async function runDiff({ packageRoot, projectRoot, packageVersion, argv =
     pathConfig,
     dryRun: true,
     selectedAdapterItemIds,
+    withCodegraph,
   });
 
   console.log('[UKit] Diff preview:');

package/src/cli/commands/install.js

@@ -198,6 +198,7 @@ export async function pruneDeselectedAdapters({
 export async function runInstall({ packageRoot, projectRoot, packageVersion, argv = [] }) {
   const toolsArg = parseToolsArg(argv);
   const selectedOptionalTools = resolveOptionalToolKeys(toolsArg);
+  const withCodegraph = argv.includes('--with-codegraph');
 
   const pruneResult = await pruneDeselectedAdapters({
     projectRoot,
@@ -213,6 +214,7 @@ export async function runInstall({ packageRoot, projectRoot, packageVersion, arg
     dryRun: false,
     selectedAdapterItemIds,
     retainedManagedRelativePaths: pruneResult?.retainedManagedPaths ?? [],
+    withCodegraph,
   });
 
   const { create, update, unchanged, skip } = result.summary;

package/src/cli/index.js

@@ -92,6 +92,10 @@ export async function runCli({ argv, packageRoot, projectRoot, packageVersion })
     console.log('                     Values: claude, antigravity, codex, opencode');
     console.log('                     Example: ukit install --tools=claude,codex,opencode');
     console.log('                     Use --tools=none to disable all optional adapters');
+    console.log('  --with-codegraph   Enable CodeGraph MCP integration in CLAUDE.md');
+    console.log('                     Adds routing rules that prefer codegraph_* tools for');
+    console.log('                     symbol search, context building, and impact analysis.');
+    console.log('                     Omit this flag to remove the section on reinstall.');
     console.log('');
     console.log('Maintainer / debug examples:');
     console.log('  ukit index build');

package/src/core/runInstallPipeline.js

@@ -217,6 +217,7 @@ export async function runInstallPipeline({
   dryRun,
   selectedAdapterItemIds,
   retainedManagedRelativePaths = [],
+  withCodegraph = false,
 }) {
   // Check for an existing install before making any changes.
   // cleanupLegacyPaths() is only safe to run on reinstalls: on a fresh install
@@ -239,6 +240,7 @@ export async function runInstallPipeline({
     stackContext,
     packageVersion,
     providerContext,
+    withCodegraph,
   });
 
   const plan = await buildInstallPlan({

package/src/render/buildVariables.js

@@ -1,4 +1,17 @@
-export function buildTemplateVariables({ projectContext, stackContext, packageVersion, providerContext }) {
+const CODEGRAPH_SECTION = `
+## CodeGraph Integration (active)
+
+CodeGraph MCP is enabled for this project. When \`codegraph_*\` tools appear in your tool list:
+- **Symbol search** → \`codegraph_search\` (replaces \`node .claude/ukit/index/query-index.mjs\`)
+- **Context building** → \`codegraph_context\` (replaces \`resolve-context.mjs\`)
+- **Impact analysis** → \`codegraph_impact\` (replaces \`impact-context.mjs\`)
+- **Call graph** → \`codegraph_trace\`, \`codegraph_callers\`, \`codegraph_callees\` (new capability, no UKit equivalent)
+
+UKit routing, memory, and skill activation remain primary. CodeGraph is the index query layer only.
+To disable: rerun \`ukit install\` without \`--with-codegraph\`.
+`;
+
+export function buildTemplateVariables({ projectContext, stackContext, packageVersion, providerContext, withCodegraph = false }) {
   return {
     project: {
       name: projectContext.project.name,
@@ -35,5 +48,6 @@ export function buildTemplateVariables({ projectContext, stackContext, packageVe
     user: {
       profile: 'default',
     },
+    codegraphSection: withCodegraph ? CODEGRAPH_SECTION : '',
   };
 }

package/templates/CLAUDE.md

@@ -165,3 +165,4 @@ DuraOne skill chỉ active khi pack `duraone` được cài hoặc `.claude/skil
   - `.claude/skills/duraone/references/sql.md`
   - `.claude/skills/duraone/references/workflow.md`
 - Khi không active: dùng generic coding standards + project-specific patterns từ index.
+{{codegraphSection}}

package/templates/ukit/storage/config.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.5.5",
+  "version": "1.5.6",
   "agent": "claude-code",
   "autonomy": {
     "level": "balanced",