@grafema/cli 0.3.18 → 0.3.21

package/dist/commands/wtf.js.map

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

package/dist/utils/quickstart.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared utilities for project initialization and quickstart.
+ *
+ * Used by both `grafema init` and `grafema analyze --quickstart`.
+ */
+/** All file extensions supported by Grafema's analyzers. */
+export declare const SUPPORTED_EXTENSIONS: string[];
+/**
+ * Scan a project directory for supported file extensions.
+ * Returns a Map of extension → file count for detected extensions.
+ */
+export declare function scanExtensions(projectPath: string): Map<string, number>;
+/**
+ * Generate config YAML content.
+ *
+ * If `detectedExtensions` is provided and non-empty, only includes those extensions.
+ * Otherwise falls back to all supported extensions (same as `grafema init`).
+ */
+export declare function generateSmartConfig(detectedExtensions?: Map<string, number>): string;
+/**
+ * Write config file to .grafema/config.yaml, creating the directory if needed.
+ */
+export declare function writeConfig(projectPath: string, configContent: string): void;
+/**
+ * Add Grafema entries to .gitignore if it exists and doesn't already have them.
+ */
+export declare function updateGitignore(projectPath: string): boolean;
+/**
+ * Format detected extensions as a human-readable string.
+ * Groups by language and shows total file count per language.
+ *
+ * Example: "TypeScript (342 files), JavaScript (18 files), Python (5 files)"
+ */
+export declare function formatDetected(detected: Map<string, number>): string;
+//# sourceMappingURL=quickstart.d.ts.map

package/dist/utils/quickstart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickstart.d.ts","sourceRoot":"","sources":["../../src/utils/quickstart.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,UAmBhC,CAAC;AAaF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAoCvE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAoCpF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAM5E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAa5D;AAiBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAWpE"}

package/dist/utils/quickstart.js

@@ -0,0 +1,175 @@
+/**
+ * Shared utilities for project initialization and quickstart.
+ *
+ * Used by both `grafema init` and `grafema analyze --quickstart`.
+ */
+import { join } from 'path';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync } from 'fs';
+import { stringify as stringifyYAML } from 'yaml';
+import { GRAFEMA_VERSION, getSchemaVersion } from '@grafema/util';
+/** All file extensions supported by Grafema's analyzers. */
+export const SUPPORTED_EXTENSIONS = [
+    // JavaScript / TypeScript
+    'js', 'jsx', 'mjs', 'cjs', 'ts', 'tsx',
+    // Rust
+    'rs',
+    // Java / Kotlin
+    'java', 'kt', 'kts',
+    // Python
+    'py', 'pyi',
+    // Go
+    'go',
+    // Haskell
+    'hs',
+    // C / C++
+    'c', 'h', 'cpp', 'hpp', 'cc', 'cxx', 'hxx', 'hh', 'inl', 'ipp', 'tpp', 'txx',
+    // Swift / Objective-C
+    'swift', 'm', 'mm',
+    // BEAM (Elixir / Erlang)
+    'ex', 'exs', 'erl', 'hrl',
+];
+/** Directories to skip during project scanning. */
+const SKIP_DIRS = new Set([
+    'node_modules', 'dist', 'build', 'target', 'vendor',
+    '.git', '.grafema', 'coverage', '.next', '.nuxt',
+    '__pycache__', '.tox', '.venv',
+]);
+const SUPPORTED_SET = new Set(SUPPORTED_EXTENSIONS);
+const MAX_DEPTH = 10;
+const MAX_FILES = 50_000;
+/**
+ * Scan a project directory for supported file extensions.
+ * Returns a Map of extension → file count for detected extensions.
+ */
+export function scanExtensions(projectPath) {
+    const counts = new Map();
+    let filesScanned = 0;
+    function walk(dir, depth) {
+        if (depth > MAX_DEPTH || filesScanned >= MAX_FILES)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return; // Permission denied or similar — skip
+        }
+        for (const entry of entries) {
+            if (filesScanned >= MAX_FILES)
+                return;
+            if (entry.isDirectory()) {
+                if (!SKIP_DIRS.has(entry.name) && !entry.name.startsWith('.')) {
+                    walk(join(dir, entry.name), depth + 1);
+                }
+            }
+            else if (entry.isFile()) {
+                filesScanned++;
+                const dot = entry.name.lastIndexOf('.');
+                if (dot !== -1) {
+                    const ext = entry.name.slice(dot + 1);
+                    if (SUPPORTED_SET.has(ext)) {
+                        counts.set(ext, (counts.get(ext) ?? 0) + 1);
+                    }
+                }
+            }
+        }
+    }
+    walk(projectPath, 0);
+    return counts;
+}
+/**
+ * Generate config YAML content.
+ *
+ * If `detectedExtensions` is provided and non-empty, only includes those extensions.
+ * Otherwise falls back to all supported extensions (same as `grafema init`).
+ */
+export function generateSmartConfig(detectedExtensions) {
+    const exts = (detectedExtensions && detectedExtensions.size > 0)
+        ? [...detectedExtensions.keys()]
+        : SUPPORTED_EXTENSIONS;
+    const extensions = `*.{${exts.join(',')}}`;
+    const config = {
+        version: getSchemaVersion(GRAFEMA_VERSION),
+        root: '..',
+        include: [`**/${extensions}`],
+        exclude: [
+            '**/*.test.*',
+            '**/__tests__/**',
+            '**/node_modules/**',
+            '**/dist/**',
+            '**/build/**',
+            '**/target/**',
+            '**/vendor/**',
+            '**/.git/**',
+        ],
+    };
+    const yaml = stringifyYAML(config, {
+        lineWidth: 0,
+    });
+    return `# Grafema Configuration
+# Documentation: https://github.com/grafema/grafema#configuration
+# Supported: JS/TS, Rust, Java, Kotlin, Python, Go, Haskell, C/C++, Swift, Elixir/Erlang
+
+${yaml}
+# services:  # Explicit service definitions (overrides auto-discovery)
+#   - name: "api"
+#     path: "."
+#     entryPoint: "src/index.ts"
+`;
+}
+/**
+ * Write config file to .grafema/config.yaml, creating the directory if needed.
+ */
+export function writeConfig(projectPath, configContent) {
+    const grafemaDir = join(projectPath, '.grafema');
+    if (!existsSync(grafemaDir)) {
+        mkdirSync(grafemaDir, { recursive: true });
+    }
+    writeFileSync(join(grafemaDir, 'config.yaml'), configContent);
+}
+/**
+ * Add Grafema entries to .gitignore if it exists and doesn't already have them.
+ */
+export function updateGitignore(projectPath) {
+    const gitignorePath = join(projectPath, '.gitignore');
+    if (existsSync(gitignorePath)) {
+        const gitignore = readFileSync(gitignorePath, 'utf-8');
+        if (!gitignore.includes('.grafema/graph.rfdb')) {
+            writeFileSync(gitignorePath, gitignore + '\n# Grafema\n.grafema/graph.rfdb\n.grafema/rfdb.sock\n');
+            return true;
+        }
+    }
+    return false;
+}
+/** Map of extension to human-readable language name. */
+const EXT_LANGUAGE = {
+    js: 'JavaScript', jsx: 'JavaScript', mjs: 'JavaScript', cjs: 'JavaScript',
+    ts: 'TypeScript', tsx: 'TypeScript',
+    rs: 'Rust',
+    java: 'Java', kt: 'Kotlin', kts: 'Kotlin',
+    py: 'Python', pyi: 'Python',
+    go: 'Go',
+    hs: 'Haskell',
+    c: 'C', h: 'C/C++', cpp: 'C++', hpp: 'C++', cc: 'C++', cxx: 'C++', hxx: 'C++', hh: 'C++',
+    inl: 'C++', ipp: 'C++', tpp: 'C++', txx: 'C++',
+    swift: 'Swift', m: 'Objective-C', mm: 'Objective-C++',
+    ex: 'Elixir', exs: 'Elixir', erl: 'Erlang', hrl: 'Erlang',
+};
+/**
+ * Format detected extensions as a human-readable string.
+ * Groups by language and shows total file count per language.
+ *
+ * Example: "TypeScript (342 files), JavaScript (18 files), Python (5 files)"
+ */
+export function formatDetected(detected) {
+    // Group counts by language
+    const langCounts = new Map();
+    for (const [ext, count] of detected) {
+        const lang = EXT_LANGUAGE[ext] ?? ext;
+        langCounts.set(lang, (langCounts.get(lang) ?? 0) + count);
+    }
+    // Sort by count descending
+    const sorted = [...langCounts.entries()].sort((a, b) => b[1] - a[1]);
+    return sorted.map(([lang, count]) => `${lang} (${count} files)`).join(', ');
+}
+//# sourceMappingURL=quickstart.js.map

package/dist/utils/quickstart.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grafema/cli",
-  "version": "0.3.18",
+  "version": "0.3.21",
   "description": "CLI for Grafema code analysis toolkit",
   "type": "module",
   "main": "./dist/cli.js",
@@ -35,9 +35,9 @@
   "dependencies": {
     "commander": "^13.0.0",
     "yaml": "^2.8.2",
-    "@grafema/api": "0.3.18",
-    "@grafema/util": "0.3.18",
-    "@grafema/types": "0.3.18"
+    "@grafema/api": "0.3.21",
+    "@grafema/util": "0.3.21",
+    "@grafema/types": "0.3.21"
   },
   "optionalDependencies": {
     "@grafema/grafema-darwin-arm64": "0.3.16",

package/src/cli.ts

@@ -33,6 +33,7 @@ import { explainCommand } from './commands/explain.js';
 import { fileCommand } from './commands/file.js';
 import { setupSkillCommand } from './commands/setup-skill.js';
 import { gitIngestCommand } from './commands/git-ingest.js';
+import { registryCommand } from './commands/registry.js';
 
 // Read version from package.json
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -74,5 +75,6 @@ program.addCommand(explainCommand);
 program.addCommand(fileCommand);
 program.addCommand(setupSkillCommand);
 program.addCommand(gitIngestCommand);
+program.addCommand(registryCommand);
 
 program.parse();

package/src/commands/analyze.ts

@@ -21,6 +21,7 @@ export const analyzeCommand = new Command('analyze')
   .option('--log-file <path>', 'Write all log output to a file')
   .option('--strict', 'Enable strict mode (fail on unresolved references)')
   .option('--no-auto-start', 'Do not auto-start RFDB server (require manual start)')
+  .option('--quickstart', 'Auto-initialize if no config exists (scan project, generate config)')
   .addHelpText('after', `
 Examples:
   grafema analyze                Analyze current project
@@ -32,5 +33,6 @@ Examples:
   grafema analyze --log-file out.log  Write all logs to a file
   grafema analyze --strict       Fail on unresolved references (debugging)
   grafema analyze --no-auto-start  Require manual server start
+  grafema analyze --quickstart   Auto-init and analyze (no grafema init needed)
 `)
   .action(analyzeAction);

package/src/commands/analyzeAction.ts

@@ -19,8 +19,10 @@ import {
   findAnalyzerBinary,
   ensureBinary,
   ManifestGenerator,
+  ManifestResolver,
 } from '@grafema/util';
 import type { LogLevel } from '@grafema/util';
+import { scanExtensions, generateSmartConfig, writeConfig, updateGitignore, formatDetected } from '../utils/quickstart.js';
 
 export interface NodeEdgeCountBackend {
   nodeCount: () => Promise<number>;
@@ -148,7 +150,7 @@ async function ensureLanguageBinaries(configPath: string, log: (...args: unknown
   }
 }
 
-export async function analyzeAction(path: string, options: { service?: string; entrypoint?: string; clear?: boolean; quiet?: boolean; verbose?: boolean; debug?: boolean; logLevel?: string; logFile?: string; strict?: boolean; autoStart?: boolean }): Promise<void> {
+export async function analyzeAction(path: string, options: { service?: string; entrypoint?: string; clear?: boolean; quiet?: boolean; verbose?: boolean; debug?: boolean; logLevel?: string; logFile?: string; strict?: boolean; autoStart?: boolean; quickstart?: boolean }): Promise<void> {
   const projectPath = resolve(path);
   const grafemaDir = join(projectPath, '.grafema');
   const dbPath = join(grafemaDir, 'graph.rfdb');
@@ -191,7 +193,24 @@ export async function analyzeAction(path: string, options: { service?: string; e
   debug(`Using orchestrator: ${orchestratorBinary}`);
 
   // Find config file for the orchestrator
-  const configPath = findConfigFile(projectPath);
+  let configPath = findConfigFile(projectPath);
+  if (!configPath && options.quickstart) {
+    // Quickstart: auto-generate config by scanning the project
+    const detected = scanExtensions(projectPath);
+    const configContent = generateSmartConfig(detected);
+    writeConfig(projectPath, configContent);
+    updateGitignore(projectPath);
+
+    if (detected.size > 0) {
+      info(`Quickstart: detected ${formatDetected(detected)}`);
+    } else {
+      info('Quickstart: no supported files detected, using all extensions');
+    }
+    info('Created .grafema/config.yaml');
+    info('');
+
+    configPath = findConfigFile(projectPath);
+  }
   if (!configPath) {
     console.error('');
     console.error('No grafema config file found.');
@@ -200,7 +219,7 @@ export async function analyzeAction(path: string, options: { service?: string; e
     console.error(`  ${join(projectPath, 'grafema.config.yaml')}`);
     console.error(`  ${join(projectPath, '.grafema', 'config.yaml')}`);
     console.error('');
-    console.error('Create a config file with at least:');
+    console.error('Run with --quickstart to auto-generate, or create manually:');
     console.error('  root: "."');
     console.error('  include:');
     console.error('    - "**/*.js"');
@@ -300,6 +319,20 @@ export async function analyzeAction(path: string, options: { service?: string; e
       } catch (err) {
         debug(`Manifest generation skipped: ${err instanceof Error ? err.message : String(err)}`);
       }
+
+      // Auto-load registry manifests for cross-package resolution
+      const registryDir = join(projectPath, 'registry');
+      if (existsSync(registryDir)) {
+        try {
+          const resolver = new ManifestResolver();
+          const loaded = resolver.loadFromRegistry(registryDir);
+          if (loaded > 0) {
+            info(`  Registry: ${loaded} package manifests loaded`);
+          }
+        } catch (err) {
+          debug(`Registry loading skipped: ${err instanceof Error ? err.message : String(err)}`);
+        }
+      }
     } else {
       console.error('');
       console.error(`Analysis failed with exit code ${exitCode}`);

package/src/commands/init.ts

@@ -4,77 +4,15 @@
 
 import { Command } from 'commander';
 import { resolve, join } from 'path';
-import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
+import { existsSync } from 'fs';
 import { spawn } from 'child_process';
 import { createInterface } from 'readline';
 import { fileURLToPath } from 'url';
-import { stringify as stringifyYAML } from 'yaml';
-import { GRAFEMA_VERSION, getSchemaVersion } from '@grafema/util';
 import { installSkill } from './setup-skill.js';
+import { generateSmartConfig, writeConfig, updateGitignore } from '../utils/quickstart.js';
 
 const __dirname = fileURLToPath(new URL('.', import.meta.url));
 
-/** All file extensions supported by Grafema's analyzers. */
-const SUPPORTED_EXTENSIONS = [
-  // JavaScript / TypeScript
-  'js', 'jsx', 'mjs', 'cjs', 'ts', 'tsx',
-  // Rust
-  'rs',
-  // Java / Kotlin
-  'java', 'kt', 'kts',
-  // Python
-  'py', 'pyi',
-  // Go
-  'go',
-  // Haskell
-  'hs',
-  // C / C++
-  'c', 'h', 'cpp', 'hpp', 'cc', 'cxx', 'hxx', 'hh', 'inl', 'ipp', 'tpp', 'txx',
-  // Swift / Objective-C
-  'swift', 'm', 'mm',
-  // BEAM (Elixir / Erlang)
-  'ex', 'exs', 'erl', 'hrl',
-];
-
-/**
- * Generate config.yaml content.
- * Minimal config — the Rust orchestrator has its own built-in analysis pipeline.
- * Includes all supported extensions; orchestrator skips languages with no matching files.
- */
-function generateConfigYAML(): string {
-  const extensions = `*.{${SUPPORTED_EXTENSIONS.join(',')}}`;
-  const config = {
-    version: getSchemaVersion(GRAFEMA_VERSION),
-    root: '..',
-    include: [`**/${extensions}`],
-    exclude: [
-      '**/*.test.*',
-      '**/__tests__/**',
-      '**/node_modules/**',
-      '**/dist/**',
-      '**/build/**',
-      '**/target/**',
-      '**/vendor/**',
-      '**/.git/**',
-    ],
-  };
-
-  const yaml = stringifyYAML(config, {
-    lineWidth: 0,
-  });
-
-  return `# Grafema Configuration
-# Documentation: https://github.com/grafema/grafema#configuration
-# Supported: JS/TS, Rust, Java, Kotlin, Python, Go, Haskell, C/C++, Swift, Elixir/Erlang
-
-${yaml}
-# services:  # Explicit service definitions (overrides auto-discovery)
-#   - name: "api"
-#     path: "."
-#     entryPoint: "src/index.ts"
-`;
-}
-
 /**
  * Ask user a yes/no question. Returns true for yes (default), false for no.
  */
@@ -187,27 +125,14 @@ Examples:
       return;
     }
 
-    // Create .grafema directory
-    if (!existsSync(grafemaDir)) {
-      mkdirSync(grafemaDir, { recursive: true });
-    }
-
-    // Write config
-    const configContent = generateConfigYAML();
-    writeFileSync(configPath, configContent);
+    // Write config (generateSmartConfig with no args = all extensions, same as before)
+    const configContent = generateSmartConfig();
+    writeConfig(projectPath, configContent);
     console.log('✓ Created .grafema/config.yaml');
 
     // Add to .gitignore if exists
-    const gitignorePath = join(projectPath, '.gitignore');
-    if (existsSync(gitignorePath)) {
-      const gitignore = readFileSync(gitignorePath, 'utf-8');
-      if (!gitignore.includes('.grafema/graph.rfdb')) {
-        writeFileSync(
-          gitignorePath,
-          gitignore + '\n# Grafema\n.grafema/graph.rfdb\n.grafema/rfdb.sock\n'
-        );
-        console.log('✓ Updated .gitignore');
-      }
+    if (updateGitignore(projectPath)) {
+      console.log('✓ Updated .gitignore');
     }
 
     // Auto-install Agent Skill for AI-assisted development

package/src/commands/registry.ts

@@ -0,0 +1,138 @@
+/**
+ * Registry command — build and manage the local manifest registry.
+ *
+ * grafema registry build [--packages <names>] [--all] [--force] [--verbose]
+ * grafema registry list
+ * grafema registry status
+ */
+
+import { Command } from 'commander';
+import { resolve, join } from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { parse as parseYaml } from 'yaml';
+import { RegistryBuilder } from '@grafema/util';
+import type { RegistryIndex } from '@grafema/util';
+
+function getRegistryDir(path: string): string {
+  return join(resolve(path), 'registry');
+}
+
+const buildCommand = new Command('build')
+  .description('Build manifest registry for npm dependencies')
+  .argument('[path]', 'Project path', '.')
+  .option('-p, --packages <names>', 'Comma-separated package names to build')
+  .option('-a, --all', 'Build all discovered dependencies')
+  .option('-f, --force', 'Rebuild even if manifest exists')
+  .option('-v, --verbose', 'Show detailed output')
+  .option('--skip <names>', 'Comma-separated package names to skip')
+  .option('--timeout <ms>', 'Max per-package timeout in ms (adaptive by default)', '600000')
+  .option('--max-files <count>', 'Skip packages exceeding this file count', '5000')
+  .action(async (path: string, options: {
+    packages?: string;
+    all?: boolean;
+    force?: boolean;
+    verbose?: boolean;
+    skip?: string;
+    timeout?: string;
+    maxFiles?: string;
+  }) => {
+    const projectPath = resolve(path);
+    const registryDir = getRegistryDir(path);
+
+    const builder = new RegistryBuilder({
+      projectPath,
+      registryDir,
+      force: options.force,
+      verbose: options.verbose,
+      skip: options.skip?.split(',').map(s => s.trim()) ?? [],
+      timeout: parseInt(options.timeout ?? '120000', 10),
+      maxFiles: parseInt(options.maxFiles ?? '5000', 10),
+    });
+
+    if (options.packages) {
+      const names = options.packages.split(',').map(s => s.trim());
+      await builder.buildPackages(names);
+    } else if (options.all) {
+      await builder.buildAll();
+    } else {
+      console.error('Specify --packages <names> or --all');
+      process.exit(1);
+    }
+
+    // Write index and print summary
+    const indexPath = builder.writeIndex();
+    builder.printSummary();
+    console.log(`\nIndex: ${indexPath}`);
+  });
+
+const listCommand = new Command('list')
+  .description('List packages in the local registry')
+  .argument('[path]', 'Project path', '.')
+  .action((path: string) => {
+    const registryDir = getRegistryDir(path);
+    const indexPath = join(registryDir, 'index.yaml');
+
+    if (!existsSync(indexPath)) {
+      console.log('No registry found. Run `grafema registry build --all` first.');
+      return;
+    }
+
+    const index = parseYaml(readFileSync(indexPath, 'utf-8')) as RegistryIndex;
+    if (!index?.entries?.length) {
+      console.log('Registry is empty.');
+      return;
+    }
+
+    console.log(`Registry: ${index.entries.length} packages (analyzer ${index.analyzer_version})\n`);
+
+    const nameWidth = Math.max(...index.entries.map(e => e.name.length), 7);
+    console.log(`${'Package'.padEnd(nameWidth)}  Version     Exports  Confidence  Source`);
+    console.log(`${'─'.repeat(nameWidth)}  ──────────  ───────  ──────────  ──────`);
+
+    for (const entry of index.entries) {
+      console.log(
+        `${entry.name.padEnd(nameWidth)}  ${entry.version.padEnd(10)}  ${String(entry.total_exports).padStart(7)}  ${entry.confidence.toFixed(2).padStart(10)}  ${entry.source_type}`,
+      );
+    }
+  });
+
+const statusCommand = new Command('status')
+  .description('Show registry build status vs installed dependencies')
+  .argument('[path]', 'Project path', '.')
+  .action((path: string) => {
+    const projectPath = resolve(path);
+    const registryDir = getRegistryDir(path);
+
+    const builder = new RegistryBuilder({ projectPath, registryDir });
+    const deps = builder.discoverDependencies();
+
+    const indexPath = join(registryDir, 'index.yaml');
+    const builtNames = new Set<string>();
+    if (existsSync(indexPath)) {
+      const index = parseYaml(readFileSync(indexPath, 'utf-8')) as RegistryIndex;
+      if (index?.entries) {
+        for (const e of index.entries) builtNames.add(e.name);
+      }
+    }
+
+    const built = deps.filter(d => builtNames.has(d));
+    const missing = deps.filter(d => !builtNames.has(d));
+
+    console.log(`Dependencies: ${deps.length} total, ${built.length} in registry, ${missing.length} missing\n`);
+
+    if (missing.length > 0) {
+      console.log('Missing from registry:');
+      for (const name of missing) {
+        console.log(`  ${name}`);
+      }
+      console.log(`\nRun: grafema registry build --packages ${missing.join(',')}`);
+    } else {
+      console.log('All dependencies have manifests in the registry.');
+    }
+  });
+
+export const registryCommand = new Command('registry')
+  .description('Manage local manifest registry for npm dependencies')
+  .addCommand(buildCommand)
+  .addCommand(listCommand)
+  .addCommand(statusCommand);

package/src/commands/trace.ts

@@ -156,6 +156,7 @@ Examples:
 
         const narrative = renderTraceNarrative(results, variable.name || variable.id, {
           detail: options.detail || 'normal',
+          hintStyle: 'cli',
         });
         console.log(narrative);
 

package/src/commands/wtf.ts

@@ -23,6 +23,7 @@ import { Spinner } from '../utils/spinner.js';
 interface WtfCommandOptions {
   project: string;
   depth: string;
+  detail: 'summary' | 'normal' | 'full';
   json?: boolean;
 }
 
@@ -31,12 +32,14 @@ export const wtfCommand = new Command('wtf')
   .argument('<symbol>', 'Variable, constant, or parameter name to trace')
   .option('-p, --project <path>', 'Project path', '.')
   .option('-d, --depth <n>', 'Max trace depth', '10')
+  .option('--detail <level>', 'Level of detail: summary, normal (default), full', 'normal')
   .option('-j, --json', 'Output as JSON')
   .addHelpText('after', `
 Examples:
   grafema wtf req.user              Trace where req.user comes from
   grafema wtf config.apiKey         Where does this value originate?
   grafema wtf userId --depth 5      Limit trace depth
+  grafema wtf token --detail full   Show complete chain (no compression)
   grafema wtf token --json          Output as JSON
 `)
   .action(async (symbol: string, options: WtfCommandOptions) => {
@@ -130,7 +133,7 @@ Examples:
       } else {
         console.log(`${found.name} (${found.type}) — ${found.file}${found.line ? ':' + found.line : ''}`);
         console.log('');
-        const narrative = renderTraceNarrative(results, found.name, { detail: 'normal' });
+        const narrative = renderTraceNarrative(results, found.name, { detail: options.detail || 'normal', hintStyle: 'cli' });
         console.log(narrative);
       }
     } finally {