@grafema/cli 0.2.4-beta → 0.2.6-beta

package/dist/plugins/pluginLoader.js

@@ -0,0 +1,101 @@
+/**
+ * Plugin loading — resolves built-in and custom plugins from config.
+ *
+ * Handles:
+ * - ESM resolve hook for custom plugin @grafema/* imports
+ * - Loading custom plugins from .grafema/plugins/
+ * - Creating plugin instances from config phases
+ */
+import { join } from 'path';
+import { existsSync, readdirSync } from 'fs';
+import { pathToFileURL } from 'url';
+import { register } from 'node:module';
+import { BUILTIN_PLUGINS } from './builtinPlugins.js';
+/**
+ * Register ESM resolve hook so custom plugins can import @grafema/* packages.
+ *
+ * Plugins in .grafema/plugins/ do `import { Plugin } from '@grafema/core'`,
+ * but @grafema/core isn't in the target project's node_modules/.
+ * This hook redirects those imports to the CLI's bundled packages.
+ *
+ * Uses module.register() (stable Node.js 20.6+ API).
+ * Safe to call multiple times — subsequent calls add redundant hooks
+ * that short-circuit on the same specifiers.
+ */
+let pluginResolverRegistered = false;
+export function registerPluginResolver() {
+    if (pluginResolverRegistered)
+        return;
+    pluginResolverRegistered = true;
+    const grafemaPackages = {};
+    for (const pkg of ['@grafema/core', '@grafema/types']) {
+        try {
+            grafemaPackages[pkg] = import.meta.resolve(pkg);
+        }
+        catch {
+            // Package not available from CLI context — skip
+        }
+    }
+    register(new URL('./pluginResolver.js', import.meta.url), { data: { grafemaPackages } });
+}
+/**
+ * Load custom plugins from .grafema/plugins/ directory
+ */
+export async function loadCustomPlugins(projectPath, log) {
+    const pluginsDir = join(projectPath, '.grafema', 'plugins');
+    if (!existsSync(pluginsDir)) {
+        return {};
+    }
+    // Ensure @grafema/* imports resolve for custom plugins (REG-380)
+    registerPluginResolver();
+    const customPlugins = {};
+    try {
+        const files = readdirSync(pluginsDir).filter((f) => f.endsWith('.js') || f.endsWith('.mjs') || f.endsWith('.cjs'));
+        for (const file of files) {
+            try {
+                const pluginPath = join(pluginsDir, file);
+                const pluginUrl = pathToFileURL(pluginPath).href;
+                const module = await import(pluginUrl);
+                const PluginClass = module.default || module[file.replace(/\.[cm]?js$/, '')];
+                if (PluginClass && typeof PluginClass === 'function') {
+                    const pluginName = PluginClass.name || file.replace(/\.[cm]?js$/, '');
+                    customPlugins[pluginName] = () => {
+                        const instance = new PluginClass();
+                        instance.config.sourceFile = pluginPath;
+                        return instance;
+                    };
+                    log(`Loaded custom plugin: ${pluginName}`);
+                }
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                console.warn(`Failed to load plugin ${file}: ${message}`);
+            }
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.warn(`Error loading custom plugins: ${message}`);
+    }
+    return customPlugins;
+}
+export function createPlugins(config, customPlugins = {}, verbose = false) {
+    const plugins = [];
+    const phases = ['discovery', 'indexing', 'analysis', 'enrichment', 'validation'];
+    for (const phase of phases) {
+        const names = config[phase] || [];
+        for (const name of names) {
+            // Check built-in first, then custom
+            const factory = BUILTIN_PLUGINS[name] || customPlugins[name];
+            if (factory) {
+                plugins.push(factory());
+            }
+            else if (verbose) {
+                // Only show plugin warning in verbose mode
+                console.warn(`Plugin not found: ${name} (skipping). Check .grafema/config.yaml or add to .grafema/plugins/`);
+            }
+        }
+    }
+    return plugins;
+}
+//# sourceMappingURL=pluginLoader.js.map

package/dist/plugins/pluginLoader.js.map

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

package/dist/plugins/pluginResolver.js

@@ -0,0 +1,38 @@
+/**
+ * ESM resolve hook for custom Grafema plugins.
+ *
+ * Allows plugins in .grafema/plugins/ to `import { Plugin } from '@grafema/core'`
+ * without requiring @grafema/core in the target project's node_modules/.
+ *
+ * The hook maps @grafema/* bare specifiers to the actual package URLs
+ * within the CLI's dependency tree.
+ *
+ * Registered via module.register() before loading custom plugins.
+ * Must be plain JS — loader hooks run in a separate thread.
+ */
+
+/** @type {Record<string, string>} package name → resolved file URL */
+let grafemaPackages = {};
+
+/**
+ * Called once when the hook is registered via module.register().
+ * @param {{ grafemaPackages: Record<string, string> }} data
+ */
+export function initialize(data) {
+  grafemaPackages = data.grafemaPackages;
+}
+
+/**
+ * Resolve hook — intercepts bare specifier imports for @grafema/* packages
+ * and redirects them to the CLI's bundled versions.
+ *
+ * Only exact package name matches are handled (e.g. '@grafema/core').
+ * All other specifiers pass through to the default resolver.
+ */
+export function resolve(specifier, context, next) {
+  if (grafemaPackages[specifier]) {
+    return { url: grafemaPackages[specifier], shortCircuit: true };
+  }
+
+  return next(specifier, context);
+}

package/dist/utils/codePreview.d.ts

@@ -9,6 +9,7 @@ export interface CodePreviewOptions {
     line: number;
     contextBefore?: number;
     contextAfter?: number;
+    projectPath?: string;
 }
 export interface CodePreviewResult {
     lines: string[];

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

@@ -1 +1 @@
-{"version":3,"file":"codePreview.d.ts","sourceRoot":"","sources":["../../src/utils/codePreview.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,IAAI,CA0BpF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAC1B,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,EAAE,CAeV"}
+{"version":3,"file":"codePreview.d.ts","sourceRoot":"","sources":["../../src/utils/codePreview.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,IAAI,CA4BpF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAC1B,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,EAAE,CAeV"}

package/dist/utils/codePreview.js

@@ -5,17 +5,19 @@
  * for displaying in the explorer UI.
  */
 import { readFileSync, existsSync } from 'fs';
+import { isAbsolute, join } from 'path';
 /**
  * Get a code preview snippet from a source file.
  * Returns lines around the specified line number with context.
  */
 export function getCodePreview(options) {
-    const { file, line, contextBefore = 2, contextAfter = 12 } = options;
-    if (!existsSync(file)) {
+    const { file, line, contextBefore = 2, contextAfter = 12, projectPath } = options;
+    const absoluteFile = projectPath && !isAbsolute(file) ? join(projectPath, file) : file;
+    if (!existsSync(absoluteFile)) {
         return null;
     }
     try {
-        const content = readFileSync(file, 'utf-8');
+        const content = readFileSync(absoluteFile, 'utf-8');
         const allLines = content.split('\n');
         // Calculate range (1-indexed)
         const startLine = Math.max(1, line - contextBefore);
@@ -49,3 +51,4 @@ export function formatCodePreview(preview, highlightLine) {
         return `${prefix}${paddedNum} | ${displayLine}`;
     });
 }
+//# sourceMappingURL=codePreview.js.map

package/dist/utils/codePreview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codePreview.js","sourceRoot":"","sources":["../../src/utils/codePreview.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAgBxC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B;IACxD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,GAAG,CAAC,EAAE,YAAY,GAAG,EAAE,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAElF,MAAM,YAAY,GAAG,WAAW,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvF,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAErC,8BAA8B;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,aAAa,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,YAAY,CAAC,CAAC;QAE/D,wDAAwD;QACxD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QAErD,OAAO;YACL,KAAK;YACL,SAAS;YACT,OAAO;SACR,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA0B,EAC1B,aAAsB;IAEtB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACrC,MAAM,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;IAE/C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,MAAM,OAAO,GAAG,SAAS,GAAG,KAAK,CAAC;QAClC,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAErD,2BAA2B;QAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAExE,OAAO,GAAG,MAAM,GAAG,SAAS,MAAM,WAAW,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/errorFormatter.js

@@ -30,3 +30,4 @@ export function exitWithError(title, nextSteps) {
     }
     process.exit(1);
 }
+//# sourceMappingURL=errorFormatter.js.map

package/dist/utils/errorFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorFormatter.js","sourceRoot":"","sources":["../../src/utils/errorFormatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,SAAoB;IAC/D,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAE5B,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/utils/formatNode.d.ts

@@ -25,7 +25,7 @@ export interface DisplayableNode {
     type: string;
     /** Human-readable name */
     name: string;
-    /** Absolute file path */
+    /** Source file path (relative to project root, or absolute for legacy) */
     file: string;
     /** Line number (optional) */
     line?: number;

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

@@ -1 +1 @@
-{"version":3,"file":"formatNode.d.ts","sourceRoot":"","sources":["../../src/utils/formatNode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAyBhE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAoB3F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,WAAW,EAAE,MAAM,GAClB,MAAM,CAIR"}
+{"version":3,"file":"formatNode.d.ts","sourceRoot":"","sources":["../../src/utils/formatNode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAyBhE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAoB3F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,WAAW,EAAE,MAAM,GAClB,MAAM,CAIR"}

package/dist/utils/formatNode.js

@@ -4,7 +4,7 @@
  * Provides consistent formatting for node display across all CLI commands.
  * Semantic IDs are shown as the PRIMARY identifier, with location as secondary.
  */
-import { relative } from 'path';
+import { isAbsolute, relative } from 'path';
 /**
  * Get the display name for a node based on its type.
  *
@@ -77,6 +77,7 @@ export function formatNodeInline(node) {
 export function formatLocation(file, line, projectPath) {
     if (!file)
         return '';
-    const relPath = relative(projectPath, file);
+    const relPath = isAbsolute(file) ? relative(projectPath, file) : file;
     return line ? `${relPath}:${line}` : relPath;
 }
+//# sourceMappingURL=formatNode.js.map

package/dist/utils/formatNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatNode.js","sourceRoot":"","sources":["../../src/utils/formatNode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAoC5C;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAqB;IACtD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,YAAY;YACf,+BAA+B;YAC/B,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC7B,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACvC,CAAC;YACD,MAAM;QACR,KAAK,cAAc;YACjB,yCAAyC;YACzC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC5B,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACtC,CAAC;YACD,MAAM;IACV,CAAC;IACD,gEAAgE;IAChE,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IACD,sDAAsD;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,sCAAsC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAqB,EAAE,OAA0B;IACjF,MAAM,EAAE,WAAW,EAAE,YAAY,GAAG,IAAI,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAClE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,8CAA8C;IAC9C,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC7C,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC,CAAC;IAErD,2BAA2B;IAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,SAAS,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAExC,8BAA8B;IAC9B,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC9D,IAAI,GAAG,EAAE,CAAC;YACR,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,eAAe,GAAG,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAqB;IACpD,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAwB,EACxB,IAAwB,EACxB,WAAmB;IAEnB,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/C,CAAC"}

package/dist/utils/pathUtils.d.ts

@@ -0,0 +1,2 @@
+export declare function toRelativeDisplay(file: string, projectPath: string): string;
+//# sourceMappingURL=pathUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pathUtils.d.ts","sourceRoot":"","sources":["../../src/utils/pathUtils.ts"],"names":[],"mappings":"AAMA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/utils/pathUtils.js

@@ -0,0 +1,9 @@
+/**
+ * Convert a node file path to relative display format.
+ * Handles both legacy absolute paths and new relative paths (REG-408).
+ */
+import { relative, isAbsolute } from 'path';
+export function toRelativeDisplay(file, projectPath) {
+    return isAbsolute(file) ? relative(projectPath, file) : file;
+}
+//# sourceMappingURL=pathUtils.js.map

package/dist/utils/pathUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathUtils.js","sourceRoot":"","sources":["../../src/utils/pathUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAE5C,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,WAAmB;IACjE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC"}

package/dist/utils/progressRenderer.d.ts

@@ -0,0 +1,119 @@
+/**
+ * ProgressRenderer - Formats and displays analysis progress for CLI.
+ *
+ * Consumes ProgressInfo events from Orchestrator and renders them as
+ * user-friendly progress output with phase tracking, elapsed time,
+ * and spinner animation.
+ *
+ * @example
+ * ```typescript
+ * const renderer = new ProgressRenderer({ isInteractive: true });
+ * orchestrator.run({
+ *   onProgress: (info) => renderer.update(info),
+ * });
+ * console.log(renderer.finish(elapsed));
+ * ```
+ */
+import type { ProgressInfo } from '@grafema/core';
+/**
+ * Options for creating a ProgressRenderer instance.
+ */
+export interface ProgressRendererOptions {
+    /** Whether output is to a TTY (enables spinner and line overwriting) */
+    isInteractive?: boolean;
+    /** Minimum milliseconds between display updates (default: 100) */
+    throttle?: number;
+    /** Custom write function for output (default: process.stdout.write) */
+    write?: (text: string) => void;
+}
+/**
+ * ProgressRenderer - Formats and displays analysis progress for CLI.
+ *
+ * Consumes ProgressInfo events from Orchestrator and renders them as
+ * user-friendly progress output with phase tracking, elapsed time,
+ * and spinner animation.
+ */
+export declare class ProgressRenderer {
+    private phases;
+    private currentPhaseIndex;
+    private currentPhase;
+    private currentPlugin;
+    private message;
+    private totalFiles;
+    private processedFiles;
+    private servicesAnalyzed;
+    private spinnerIndex;
+    private isInteractive;
+    private startTime;
+    private lastDisplayTime;
+    private displayThrottle;
+    private write;
+    private spinnerFrames;
+    private activePlugins;
+    private nodeCount;
+    private edgeCount;
+    constructor(options?: ProgressRendererOptions);
+    /**
+     * Process a progress event from Orchestrator.
+     * Updates internal state and displays formatted output if throttle allows.
+     */
+    update(info: ProgressInfo): void;
+    /**
+     * Update graph statistics (called separately from progress events).
+     * This allows real-time node/edge count updates.
+     */
+    setStats(nodeCount: number, edgeCount: number): void;
+    /**
+     * Format and display current state to console.
+     */
+    private display;
+    private formatOutput;
+    /**
+     * Format elapsed time as human-readable string.
+     */
+    private formatElapsed;
+    private formatInteractive;
+    private formatNonInteractive;
+    /**
+     * Format node/edge counts if available.
+     */
+    private formatStats;
+    /**
+     * Format large numbers with K/M suffix.
+     */
+    private formatNumber;
+    /**
+     * Get formatted phase label with number, e.g., "[3/5] Analysis..."
+     */
+    private getPhaseLabel;
+    /**
+     * Format progress details based on current phase.
+     */
+    private formatPhaseProgress;
+    /**
+     * Format plugin list, truncating if more than 3 plugins.
+     */
+    private formatPluginList;
+    /**
+     * Get final summary message after analysis complete.
+     * @param durationSeconds - Total duration of analysis
+     * @returns Formatted completion message
+     */
+    finish(durationSeconds: number): string;
+    /**
+     * Expose internal state for testing.
+     * @internal
+     */
+    getState(): {
+        phaseIndex: number;
+        phase: string;
+        processedFiles: number;
+        totalFiles: number;
+        servicesAnalyzed: number;
+        spinnerIndex: number;
+        activePlugins: string[];
+        nodeCount: number;
+        edgeCount: number;
+    };
+}
+//# sourceMappingURL=progressRenderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progressRenderer.d.ts","sourceRoot":"","sources":["../../src/utils/progressRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA+E;IAC7F,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,aAAa,CAAsD;IAC3E,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAa;gBAElB,OAAO,CAAC,EAAE,uBAAuB;IAO7C;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IA+ChC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpD;;OAEG;IACH,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;IACH,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;OAIG;IACH,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM;IAIvC;;;OAGG;IACH,QAAQ,IAAI;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB;CAaF"}

package/dist/utils/progressRenderer.js

@@ -0,0 +1,245 @@
+/**
+ * ProgressRenderer - Formats and displays analysis progress for CLI.
+ *
+ * Consumes ProgressInfo events from Orchestrator and renders them as
+ * user-friendly progress output with phase tracking, elapsed time,
+ * and spinner animation.
+ *
+ * @example
+ * ```typescript
+ * const renderer = new ProgressRenderer({ isInteractive: true });
+ * orchestrator.run({
+ *   onProgress: (info) => renderer.update(info),
+ * });
+ * console.log(renderer.finish(elapsed));
+ * ```
+ */
+/**
+ * ProgressRenderer - Formats and displays analysis progress for CLI.
+ *
+ * Consumes ProgressInfo events from Orchestrator and renders them as
+ * user-friendly progress output with phase tracking, elapsed time,
+ * and spinner animation.
+ */
+export class ProgressRenderer {
+    phases = ['discovery', 'indexing', 'analysis', 'enrichment', 'validation'];
+    currentPhaseIndex = -1;
+    currentPhase = '';
+    currentPlugin = '';
+    message = '';
+    totalFiles = 0;
+    processedFiles = 0;
+    servicesAnalyzed = 0;
+    spinnerIndex = 0;
+    isInteractive;
+    startTime;
+    lastDisplayTime = 0;
+    displayThrottle;
+    write;
+    spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    activePlugins = [];
+    nodeCount = 0;
+    edgeCount = 0;
+    constructor(options) {
+        this.isInteractive = options?.isInteractive ?? process.stdout.isTTY ?? false;
+        this.displayThrottle = options?.throttle ?? 100;
+        this.startTime = Date.now();
+        this.write = options?.write ?? ((text) => process.stdout.write(text));
+    }
+    /**
+     * Process a progress event from Orchestrator.
+     * Updates internal state and displays formatted output if throttle allows.
+     */
+    update(info) {
+        // Update phase tracking
+        if (info.phase && info.phase !== this.currentPhase) {
+            this.currentPhase = info.phase;
+            const idx = this.phases.indexOf(info.phase);
+            if (idx !== -1) {
+                this.currentPhaseIndex = idx;
+            }
+            // Reset phase-specific state
+            this.activePlugins = [];
+        }
+        // Update state from progress info
+        if (info.currentPlugin !== undefined) {
+            this.currentPlugin = info.currentPlugin;
+            // Track active plugins for enrichment/validation display
+            if ((this.currentPhase === 'enrichment' || this.currentPhase === 'validation') &&
+                info.currentPlugin && !this.activePlugins.includes(info.currentPlugin)) {
+                this.activePlugins.push(info.currentPlugin);
+            }
+        }
+        if (info.message !== undefined) {
+            this.message = info.message;
+        }
+        if (info.totalFiles !== undefined) {
+            this.totalFiles = info.totalFiles;
+        }
+        if (info.processedFiles !== undefined) {
+            this.processedFiles = info.processedFiles;
+        }
+        if (info.servicesAnalyzed !== undefined) {
+            this.servicesAnalyzed = info.servicesAnalyzed;
+        }
+        // Update spinner
+        this.spinnerIndex = (this.spinnerIndex + 1) % this.spinnerFrames.length;
+        // Check throttling
+        const now = Date.now();
+        if (now - this.lastDisplayTime < this.displayThrottle) {
+            return;
+        }
+        this.lastDisplayTime = now;
+        this.display();
+    }
+    /**
+     * Update graph statistics (called separately from progress events).
+     * This allows real-time node/edge count updates.
+     */
+    setStats(nodeCount, edgeCount) {
+        this.nodeCount = nodeCount;
+        this.edgeCount = edgeCount;
+    }
+    /**
+     * Format and display current state to console.
+     */
+    display() {
+        const output = this.formatOutput();
+        if (this.isInteractive) {
+            // TTY mode: overwrite previous line, pad with spaces to clear old content
+            const padded = output.padEnd(80, ' ');
+            this.write(`\r${padded}`);
+        }
+        else {
+            // Non-TTY mode: append newline
+            this.write(`${output}\n`);
+        }
+    }
+    formatOutput() {
+        if (this.isInteractive) {
+            return this.formatInteractive();
+        }
+        else {
+            return this.formatNonInteractive();
+        }
+    }
+    /**
+     * Format elapsed time as human-readable string.
+     */
+    formatElapsed() {
+        const elapsed = (Date.now() - this.startTime) / 1000;
+        if (elapsed < 60) {
+            return `${elapsed.toFixed(1)}s`;
+        }
+        const minutes = Math.floor(elapsed / 60);
+        const seconds = Math.floor(elapsed % 60);
+        return `${minutes}m${seconds}s`;
+    }
+    formatInteractive() {
+        const spinner = this.spinnerFrames[this.spinnerIndex];
+        const elapsed = this.formatElapsed();
+        const phaseLabel = this.getPhaseLabel();
+        const progress = this.formatPhaseProgress();
+        const stats = this.formatStats();
+        // Format: ⠋ [3/5] Analysis... 150/4047 modules | 12.5s | 1.2M nodes
+        return `${spinner} ${phaseLabel}${progress} | ${elapsed}${stats}`;
+    }
+    formatNonInteractive() {
+        const elapsed = this.formatElapsed();
+        return `[${this.currentPhase}] ${this.message || this.formatPhaseProgress()} (${elapsed})`;
+    }
+    /**
+     * Format node/edge counts if available.
+     */
+    formatStats() {
+        if (this.nodeCount === 0 && this.edgeCount === 0) {
+            return '';
+        }
+        const nodes = this.formatNumber(this.nodeCount);
+        const edges = this.formatNumber(this.edgeCount);
+        return ` | ${nodes} nodes, ${edges} edges`;
+    }
+    /**
+     * Format large numbers with K/M suffix.
+     */
+    formatNumber(n) {
+        if (n >= 1_000_000) {
+            return `${(n / 1_000_000).toFixed(1)}M`;
+        }
+        if (n >= 1_000) {
+            return `${(n / 1_000).toFixed(1)}K`;
+        }
+        return String(n);
+    }
+    /**
+     * Get formatted phase label with number, e.g., "[3/5] Analysis..."
+     */
+    getPhaseLabel() {
+        const phaseNum = this.currentPhaseIndex + 1;
+        const totalPhases = this.phases.length;
+        const phaseName = this.currentPhase.charAt(0).toUpperCase() + this.currentPhase.slice(1);
+        return `[${phaseNum}/${totalPhases}] ${phaseName}...`;
+    }
+    /**
+     * Format progress details based on current phase.
+     */
+    formatPhaseProgress() {
+        switch (this.currentPhase) {
+            case 'discovery':
+                if (this.servicesAnalyzed > 0) {
+                    return ` ${this.servicesAnalyzed} services found`;
+                }
+                return '';
+            case 'indexing':
+            case 'analysis':
+                if (this.totalFiles > 0) {
+                    return ` ${this.processedFiles}/${this.totalFiles} modules`;
+                }
+                return '';
+            case 'enrichment':
+            case 'validation':
+                if (this.activePlugins.length > 0) {
+                    return ` (${this.formatPluginList(this.activePlugins)})`;
+                }
+                return '';
+            default:
+                return '';
+        }
+    }
+    /**
+     * Format plugin list, truncating if more than 3 plugins.
+     */
+    formatPluginList(plugins) {
+        if (plugins.length <= 3) {
+            return plugins.join(', ');
+        }
+        // Truncate to 3 plugins + "..."
+        return plugins.slice(0, 3).join(', ') + ', ...';
+    }
+    /**
+     * Get final summary message after analysis complete.
+     * @param durationSeconds - Total duration of analysis
+     * @returns Formatted completion message
+     */
+    finish(durationSeconds) {
+        return `Analysis complete in ${durationSeconds.toFixed(2)}s`;
+    }
+    /**
+     * Expose internal state for testing.
+     * @internal
+     */
+    getState() {
+        return {
+            phaseIndex: this.currentPhaseIndex,
+            phase: this.currentPhase,
+            processedFiles: this.processedFiles,
+            totalFiles: this.totalFiles,
+            servicesAnalyzed: this.servicesAnalyzed,
+            spinnerIndex: this.spinnerIndex,
+            activePlugins: [...this.activePlugins],
+            nodeCount: this.nodeCount,
+            edgeCount: this.edgeCount,
+        };
+    }
+}
+//# sourceMappingURL=progressRenderer.js.map

package/dist/utils/progressRenderer.js.map

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