monarch-code-graph 0.3.4

package/dist/commands/diff.d.ts

@@ -0,0 +1,8 @@
+interface DiffOptions {
+    format: 'text' | 'json' | 'markdown';
+    exitOnChanges: boolean;
+    only?: 'functions' | 'modules' | 'edges';
+}
+export declare function diffCommand(baselinePath: string, currentPath: string, options: DiffOptions): Promise<void>;
+export {};
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAMA,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IACrC,aAAa,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;CAC1C;AA0BD,wBAAsB,WAAW,CAC/B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/dist/commands/diff.js

@@ -0,0 +1,203 @@
+import fs from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import { isCodeFlowArtifact } from '@codeflow/shared';
+import { log, formatPath, formatDiff } from '../utils/output.js';
+export async function diffCommand(baselinePath, currentPath, options) {
+    const baseline = loadArtifact(baselinePath, 'Baseline');
+    const current = loadArtifact(currentPath, 'Current');
+    if (!baseline || !current) {
+        process.exit(1);
+    }
+    const diff = calculateDiff(baseline, current);
+    switch (options.format) {
+        case 'json':
+            console.log(JSON.stringify(diff, null, 2));
+            break;
+        case 'markdown':
+            printMarkdownDiff(diff, baselinePath, currentPath, options.only);
+            break;
+        default:
+            printTextDiff(diff, baselinePath, currentPath, options.only);
+    }
+    if (options.exitOnChanges && diff.hasChanges) {
+        process.exit(1);
+    }
+}
+function loadArtifact(filePath, label) {
+    const absolutePath = path.resolve(filePath);
+    if (!fs.existsSync(absolutePath)) {
+        log.error(`${label} artifact not found: ${formatPath(absolutePath)}`);
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(absolutePath, 'utf-8');
+        const artifact = JSON.parse(content);
+        if (!isCodeFlowArtifact(artifact)) {
+            log.error(`${label} file is not a valid Monarch artifact`);
+            return null;
+        }
+        return artifact;
+    }
+    catch (error) {
+        log.error(`Failed to parse ${label} artifact: ${error}`);
+        return null;
+    }
+}
+function calculateDiff(baseline, current) {
+    const baselineFnIds = new Set(baseline.nodes.functions.map((fn) => fn.id));
+    const currentFnIds = new Set(current.nodes.functions.map((fn) => fn.id));
+    const addedFunctions = current.nodes.functions
+        .filter((fn) => !baselineFnIds.has(fn.id))
+        .map((fn) => `${fn.name} (${fn.file}:${fn.startLine})`);
+    const removedFunctions = baseline.nodes.functions
+        .filter((fn) => !currentFnIds.has(fn.id))
+        .map((fn) => `${fn.name} (${fn.file}:${fn.startLine})`);
+    const baselineModIds = new Set(baseline.nodes.modules.map((m) => m.id));
+    const currentModIds = new Set(current.nodes.modules.map((m) => m.id));
+    const addedModules = current.nodes.modules
+        .filter((m) => !baselineModIds.has(m.id))
+        .map((m) => m.path);
+    const removedModules = baseline.nodes.modules
+        .filter((m) => !currentModIds.has(m.id))
+        .map((m) => m.path);
+    const edgeKey = (e) => `${e.from}->${e.to}`;
+    const baselineCallEdges = new Set(baseline.edges.calls.map(edgeKey));
+    const currentCallEdges = new Set(current.edges.calls.map(edgeKey));
+    const addedCallEdges = current.edges.calls
+        .filter((e) => !baselineCallEdges.has(edgeKey(e)))
+        .map((e) => formatEdge(e, current));
+    const removedCallEdges = baseline.edges.calls
+        .filter((e) => !currentCallEdges.has(edgeKey(e)))
+        .map((e) => formatEdge(e, baseline));
+    const baselineDataflowEdges = new Set(baseline.edges.dataflow.map(edgeKey));
+    const currentDataflowEdges = new Set(current.edges.dataflow.map(edgeKey));
+    const addedDataflowEdges = current.edges.dataflow
+        .filter((e) => !baselineDataflowEdges.has(edgeKey(e)))
+        .map((e) => formatEdge(e, current));
+    const removedDataflowEdges = baseline.edges.dataflow
+        .filter((e) => !currentDataflowEdges.has(edgeKey(e)))
+        .map((e) => formatEdge(e, baseline));
+    const hasChanges = addedFunctions.length > 0 ||
+        removedFunctions.length > 0 ||
+        addedModules.length > 0 ||
+        removedModules.length > 0 ||
+        addedCallEdges.length > 0 ||
+        removedCallEdges.length > 0 ||
+        addedDataflowEdges.length > 0 ||
+        removedDataflowEdges.length > 0;
+    return {
+        hasChanges,
+        summary: {
+            functionsAdded: addedFunctions.length,
+            functionsRemoved: removedFunctions.length,
+            modulesAdded: addedModules.length,
+            modulesRemoved: removedModules.length,
+            callEdgesAdded: addedCallEdges.length,
+            callEdgesRemoved: removedCallEdges.length,
+            dataflowEdgesAdded: addedDataflowEdges.length,
+            dataflowEdgesRemoved: removedDataflowEdges.length,
+        },
+        details: {
+            addedFunctions,
+            removedFunctions,
+            addedModules,
+            removedModules,
+            addedCallEdges,
+            removedCallEdges,
+            addedDataflowEdges,
+            removedDataflowEdges,
+        },
+    };
+}
+function formatEdge(edge, artifact) {
+    const fromFn = artifact.nodes.functions.find((fn) => fn.id === edge.from);
+    const toFn = artifact.nodes.functions.find((fn) => fn.id === edge.to);
+    return `${fromFn?.name || edge.from} → ${toFn?.name || edge.to}`;
+}
+function printTextDiff(diff, baselinePath, currentPath, only) {
+    log.title('Monarch Graph Diff');
+    console.log(chalk.dim(`Baseline: ${baselinePath}`));
+    console.log(chalk.dim(`Current:  ${currentPath}`));
+    console.log('');
+    if (!diff.hasChanges) {
+        log.success('No changes detected');
+        return;
+    }
+    console.log(chalk.bold('Summary:'));
+    if (!only || only === 'functions') {
+        console.log(`  Functions:      ${formatDiff(diff.summary.functionsAdded, diff.summary.functionsRemoved)}`);
+    }
+    if (!only || only === 'modules') {
+        console.log(`  Modules:        ${formatDiff(diff.summary.modulesAdded, diff.summary.modulesRemoved)}`);
+    }
+    if (!only || only === 'edges') {
+        console.log(`  Call Edges:     ${formatDiff(diff.summary.callEdgesAdded, diff.summary.callEdgesRemoved)}`);
+        console.log(`  Dataflow Edges: ${formatDiff(diff.summary.dataflowEdgesAdded, diff.summary.dataflowEdgesRemoved)}`);
+    }
+    console.log('');
+    if ((!only || only === 'functions') && diff.details.addedFunctions.length > 0) {
+        console.log(chalk.green.bold('Added Functions:'));
+        diff.details.addedFunctions.forEach((fn) => console.log(chalk.green(`  + ${fn}`)));
+        console.log('');
+    }
+    if ((!only || only === 'functions') && diff.details.removedFunctions.length > 0) {
+        console.log(chalk.red.bold('Removed Functions:'));
+        diff.details.removedFunctions.forEach((fn) => console.log(chalk.red(`  - ${fn}`)));
+        console.log('');
+    }
+    if ((!only || only === 'modules') && diff.details.addedModules.length > 0) {
+        console.log(chalk.green.bold('Added Modules:'));
+        diff.details.addedModules.forEach((m) => console.log(chalk.green(`  + ${m}`)));
+        console.log('');
+    }
+    if ((!only || only === 'modules') && diff.details.removedModules.length > 0) {
+        console.log(chalk.red.bold('Removed Modules:'));
+        diff.details.removedModules.forEach((m) => console.log(chalk.red(`  - ${m}`)));
+        console.log('');
+    }
+    if ((!only || only === 'edges') && diff.details.addedCallEdges.length > 0) {
+        console.log(chalk.green.bold('Added Call Edges:'));
+        diff.details.addedCallEdges.forEach((e) => console.log(chalk.green(`  + ${e}`)));
+        console.log('');
+    }
+    if ((!only || only === 'edges') && diff.details.removedCallEdges.length > 0) {
+        console.log(chalk.red.bold('Removed Call Edges:'));
+        diff.details.removedCallEdges.forEach((e) => console.log(chalk.red(`  - ${e}`)));
+        console.log('');
+    }
+}
+function printMarkdownDiff(diff, baselinePath, currentPath, only) {
+    console.log('# Monarch Graph Diff\n');
+    console.log(`- **Baseline:** \`${baselinePath}\``);
+    console.log(`- **Current:** \`${currentPath}\`\n`);
+    if (!diff.hasChanges) {
+        console.log('✅ No changes detected\n');
+        return;
+    }
+    console.log('## Summary\n');
+    console.log('| Category | Added | Removed |');
+    console.log('|----------|-------|---------|');
+    if (!only || only === 'functions') {
+        console.log(`| Functions | ${diff.summary.functionsAdded} | ${diff.summary.functionsRemoved} |`);
+    }
+    if (!only || only === 'modules') {
+        console.log(`| Modules | ${diff.summary.modulesAdded} | ${diff.summary.modulesRemoved} |`);
+    }
+    if (!only || only === 'edges') {
+        console.log(`| Call Edges | ${diff.summary.callEdgesAdded} | ${diff.summary.callEdgesRemoved} |`);
+        console.log(`| Dataflow Edges | ${diff.summary.dataflowEdgesAdded} | ${diff.summary.dataflowEdgesRemoved} |`);
+    }
+    console.log('');
+    if ((!only || only === 'functions') && diff.details.addedFunctions.length > 0) {
+        console.log('### Added Functions\n');
+        diff.details.addedFunctions.forEach((fn) => console.log(`- \`${fn}\``));
+        console.log('');
+    }
+    if ((!only || only === 'functions') && diff.details.removedFunctions.length > 0) {
+        console.log('### Removed Functions\n');
+        diff.details.removedFunctions.forEach((fn) => console.log(`- \`${fn}\``));
+        console.log('');
+    }
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

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

package/dist/commands/graph.d.ts

@@ -0,0 +1,12 @@
+import { type ViewLevel } from '../utils/ascii-graph.js';
+interface GraphOptions {
+    level: ViewLevel;
+    expand?: string;
+    expandType?: 'component' | 'module';
+    list: boolean;
+    noColor: boolean;
+    width?: string;
+}
+export declare function graphCommand(artifactPath: string, options: GraphOptions): Promise<void>;
+export {};
+//# sourceMappingURL=graph.d.ts.map

package/dist/commands/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,yBAAyB,CAAC;AAEjC,UAAU,YAAY;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IACpC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CA4Df"}

package/dist/commands/graph.js

@@ -0,0 +1,72 @@
+import fs from 'fs';
+import path from 'path';
+import { isCodeFlowArtifact } from '@codeflow/shared';
+import { log, formatPath } from '../utils/output.js';
+import { renderAsciiGraph, renderExpandedView, listExpandableItems, } from '../utils/ascii-graph.js';
+export async function graphCommand(artifactPath, options) {
+    const absolutePath = path.resolve(artifactPath);
+    // Load artifact
+    if (!fs.existsSync(absolutePath)) {
+        log.error(`Artifact not found: ${formatPath(absolutePath)}`);
+        log.info('Run `monarch analyze` or `monarch run` first to generate a graph');
+        process.exit(1);
+    }
+    let artifact;
+    try {
+        const content = fs.readFileSync(absolutePath, 'utf-8');
+        artifact = JSON.parse(content);
+        if (!isCodeFlowArtifact(artifact)) {
+            log.error('Invalid artifact file');
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        log.error(`Failed to read artifact: ${error}`);
+        process.exit(1);
+    }
+    const maxWidth = options.width ? parseInt(options.width, 10) : process.stdout.columns || 80;
+    const colorize = !options.noColor;
+    // List mode - show expandable items
+    if (options.list) {
+        console.log(listExpandableItems(artifact));
+        return;
+    }
+    // Expand mode - show specific component or module
+    if (options.expand) {
+        const expandType = options.expandType || detectExpandType(artifact, options.expand);
+        if (!expandType) {
+            log.error(`Could not find "${options.expand}" as a component or module.`);
+            log.info('Use --list to see available components and modules.');
+            process.exit(1);
+        }
+        const output = renderExpandedView(artifact, options.expand, expandType, {
+            maxWidth,
+            colorize,
+            showEdgeCounts: true,
+        });
+        console.log(output);
+        return;
+    }
+    // Default mode - show graph at specified level
+    const output = renderAsciiGraph(artifact, options.level, {
+        maxWidth,
+        colorize,
+        showEdgeCounts: true,
+    });
+    console.log(output);
+}
+/**
+ * Try to detect if the given name is a component or module
+ */
+function detectExpandType(artifact, name) {
+    // Check components first
+    const component = artifact.nodes.components.find((c) => c.name === name || c.id === name);
+    if (component)
+        return 'component';
+    // Check modules
+    const module = artifact.nodes.modules.find((m) => m.path === name || m.id === name || m.path.endsWith(name));
+    if (module)
+        return 'module';
+    return null;
+}
+//# sourceMappingURL=graph.js.map

package/dist/commands/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAyB,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GAEpB,MAAM,yBAAyB,CAAC;AAWjC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,YAAoB,EACpB,OAAqB;IAErB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEhD,gBAAgB;IAChB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,KAAK,CAAC,uBAAuB,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,QAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACvD,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,GAAG,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,KAAK,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IAC5F,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC;IAElC,oCAAoC;IACpC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,kDAAkD;IAClD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAEpF,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,GAAG,CAAC,KAAK,CAAC,mBAAmB,OAAO,CAAC,MAAM,6BAA6B,CAAC,CAAC;YAC1E,GAAG,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;YAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE;YACtE,QAAQ;YACR,QAAQ;YACR,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,OAAO;IACT,CAAC;IAED,+CAA+C;IAC/C,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE;QACvD,QAAQ;QACR,QAAQ;QACR,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CACvB,QAA0B,EAC1B,IAAY;IAEZ,yBAAyB;IACzB,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAC9C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,CACxC,CAAC;IACF,IAAI,SAAS;QAAE,OAAO,WAAW,CAAC;IAElC,gBAAgB;IAChB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CACjE,CAAC;IACF,IAAI,MAAM;QAAE,OAAO,QAAQ,CAAC;IAE5B,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/commands/help.d.ts

@@ -0,0 +1,2 @@
+export declare function helpCommand(command?: string): void;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AA2IA,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAUlD"}

package/dist/commands/help.js

@@ -0,0 +1,234 @@
+import chalk from 'chalk';
+const commands = {
+    init: {
+        name: 'init',
+        description: 'Initialize a new Monarch project in the current directory',
+        usage: 'monarch init [options]',
+        options: [
+            { flag: '-f, --force', description: 'Overwrite existing configuration', default: 'false' },
+        ],
+        examples: [
+            'monarch init',
+            'monarch init --force',
+        ],
+    },
+    analyze: {
+        name: 'analyze',
+        alias: 'a',
+        description: 'Analyze a codebase and generate a flow artifact containing functions, modules, call edges, and dataflow relationships',
+        usage: 'monarch analyze [path] [options]',
+        options: [
+            { flag: '-o, --output <path>', description: 'Output artifact file path', default: 'monarch-graph.json' },
+            { flag: '-e, --exporter <name>', description: 'Exporter to use (mock, codeql-ts)', default: 'mock' },
+            { flag: '-w, --watch', description: 'Watch for changes and re-analyze', default: 'false' },
+        ],
+        examples: [
+            'monarch analyze',
+            'monarch analyze ./src',
+            'monarch analyze ./src -o graph.json',
+            'monarch analyze ./src --exporter codeql-ts',
+            'monarch a ./src -o graph.json',
+        ],
+    },
+    diff: {
+        name: 'diff',
+        alias: 'd',
+        description: 'Compare two graph artifacts and show changes in functions, modules, and edges. Useful for tracking code structure changes between versions',
+        usage: 'monarch diff <baseline> <current> [options]',
+        options: [
+            { flag: '-f, --format <type>', description: 'Output format (text, json, markdown)', default: 'text' },
+            { flag: '--exit-on-changes', description: 'Exit with code 1 if changes detected (for CI)', default: 'false' },
+            { flag: '--only <type>', description: 'Show only specific changes (functions, modules, edges)' },
+        ],
+        examples: [
+            'monarch diff baseline.json current.json',
+            'monarch diff baseline.json current.json --format json',
+            'monarch diff baseline.json current.json --format markdown',
+            'monarch diff baseline.json current.json --exit-on-changes',
+            'monarch d old.json new.json --only functions',
+        ],
+    },
+    serve: {
+        name: 'serve',
+        alias: 's',
+        description: 'Start an HTTP server to serve the artifact and visualization UI',
+        usage: 'monarch serve [options]',
+        options: [
+            { flag: '-p, --port <number>', description: 'Port to serve on', default: '3000' },
+            { flag: '-a, --artifact <path>', description: 'Artifact file path', default: 'monarch-graph.json' },
+            { flag: '--open', description: 'Open browser automatically', default: 'false' },
+        ],
+        examples: [
+            'monarch serve',
+            'monarch serve --port 8080',
+            'monarch serve --artifact my-graph.json --open',
+            'monarch s -p 4000',
+        ],
+    },
+    list: {
+        name: 'list',
+        alias: 'ls',
+        description: 'List and inspect contents of a graph artifact including metadata, functions, modules, components, and edges',
+        usage: 'monarch list [artifact] [options]',
+        options: [
+            { flag: '-t, --type <type>', description: 'Filter by type (functions, modules, components, edges)' },
+            { flag: '--json', description: 'Output as JSON', default: 'false' },
+        ],
+        examples: [
+            'monarch list',
+            'monarch list my-graph.json',
+            'monarch list --type functions',
+            'monarch list --json',
+            'monarch ls -t modules --json',
+        ],
+    },
+    run: {
+        name: 'run',
+        alias: 'r',
+        description: 'All-in-one command that analyzes the codebase, detects changes from the previous graph, updates the artifact if needed, and starts the visualization server. Perfect for development workflow.',
+        usage: 'monarch run [path] [options]',
+        options: [
+            { flag: '-o, --output <path>', description: 'Output artifact file path', default: 'monarch-graph.json' },
+            { flag: '-e, --exporter <name>', description: 'Exporter to use (mock, codeql-ts)', default: 'mock' },
+            { flag: '-p, --port <number>', description: 'Port for visualization server', default: '3000' },
+            { flag: '--open', description: 'Open browser automatically', default: 'false' },
+            { flag: '-f, --force', description: 'Force regeneration even if no changes detected', default: 'false' },
+        ],
+        examples: [
+            'monarch run',
+            'monarch run ./src',
+            'monarch run ./src --open',
+            'monarch run ./src -p 8080 --open',
+            'monarch r ./src -o my-graph.json --force',
+        ],
+    },
+    graph: {
+        name: 'graph',
+        alias: 'g',
+        description: 'Render an ASCII graph visualization directly in the terminal. Supports different view levels (components, modules, functions) and can expand specific containers to show their internal structure.',
+        usage: 'monarch graph [artifact] [options]',
+        options: [
+            { flag: '-l, --level <level>', description: 'View level (components, modules, functions)', default: 'modules' },
+            { flag: '-x, --expand <name>', description: 'Expand a specific component or module by name' },
+            { flag: '--expand-type <type>', description: 'Type of item to expand (component, module)' },
+            { flag: '--list', description: 'List expandable components and modules', default: 'false' },
+            { flag: '--no-color', description: 'Disable colored output' },
+            { flag: '-w, --width <cols>', description: 'Max output width in columns' },
+        ],
+        examples: [
+            'monarch graph',
+            'monarch graph --level components',
+            'monarch graph --level functions',
+            'monarch graph --list',
+            'monarch graph --expand src-utils',
+            'monarch graph -x auth.ts --expand-type module',
+            'monarch g -l components',
+        ],
+    },
+};
+export function helpCommand(command) {
+    if (command && commands[command]) {
+        printCommandHelp(commands[command]);
+    }
+    else if (command) {
+        console.error(chalk.red(`Unknown command: ${command}`));
+        console.log(`\nRun ${chalk.cyan('monarch help')} to see all available commands.`);
+        process.exit(1);
+    }
+    else {
+        printGeneralHelp();
+    }
+}
+function printGeneralHelp() {
+    console.log(chalk.bold.cyan(`
+ __  __                            _
+|  \\/  | ___  _ __   __ _ _ __ ___| |__
+| |\\/| |/ _ \\| '_ \\ / _\` | '__/ __| '_ \\
+| |  | | (_) | | | | (_| | | | (__| | | |
+|_|  |_|\\___/|_| |_|\\__,_|_|  \\___|_| |_|
+`));
+    console.log(chalk.bold('Monarch') + ' - Static codebase flow mapping and visualization\n');
+    console.log(chalk.dim('Analyze TypeScript/JavaScript codebases to extract function call graphs'));
+    console.log(chalk.dim('and dataflow relationships for visualization and change tracking.\n'));
+    console.log(chalk.bold.underline('USAGE'));
+    console.log(`  ${chalk.cyan('monarch')} ${chalk.yellow('<command>')} ${chalk.dim('[options]')}\n`);
+    console.log(chalk.bold.underline('COMMANDS'));
+    console.log();
+    const commandList = [
+        { cmd: 'run', alias: 'r', desc: 'Analyze, detect changes, and start server (recommended)' },
+        { cmd: 'init', alias: '', desc: 'Initialize a new Monarch project' },
+        { cmd: 'analyze', alias: 'a', desc: 'Analyze codebase and generate artifact' },
+        { cmd: 'graph', alias: 'g', desc: 'Render ASCII graph in terminal' },
+        { cmd: 'diff', alias: 'd', desc: 'Compare two artifacts for changes' },
+        { cmd: 'serve', alias: 's', desc: 'Start visualization server' },
+        { cmd: 'list', alias: 'ls', desc: 'List artifact contents' },
+        { cmd: 'help', alias: '', desc: 'Show help for a command' },
+    ];
+    for (const { cmd, alias, desc } of commandList) {
+        const aliasStr = alias ? chalk.dim(` (${alias})`) : '';
+        console.log(`  ${chalk.cyan(cmd.padEnd(10))}${aliasStr.padEnd(8)} ${desc}`);
+    }
+    console.log();
+    console.log(chalk.bold.underline('QUICK START'));
+    console.log();
+    console.log(chalk.dim('  # Fastest way: analyze and visualize in one command'));
+    console.log(`  ${chalk.green('$')} monarch run ./src --open`);
+    console.log();
+    console.log(chalk.dim('  # Or step by step:'));
+    console.log(`  ${chalk.green('$')} monarch init`);
+    console.log(`  ${chalk.green('$')} monarch analyze ./src`);
+    console.log(`  ${chalk.green('$')} monarch serve --open`);
+    console.log();
+    console.log(chalk.dim('  # Compare changes between versions'));
+    console.log(`  ${chalk.green('$')} monarch diff baseline.json current.json`);
+    console.log();
+    console.log(chalk.bold.underline('EXPORTERS'));
+    console.log();
+    console.log(`  ${chalk.cyan('mock')}       Fast regex-based analysis (default, no dependencies)`);
+    console.log(`  ${chalk.cyan('codeql-ts')}  Production-grade CodeQL analysis (requires CodeQL CLI)`);
+    console.log();
+    console.log(chalk.bold.underline('EXAMPLES'));
+    console.log();
+    console.log(chalk.dim('  # Analyze with custom output'));
+    console.log(`  ${chalk.green('$')} monarch analyze ./src -o my-graph.json`);
+    console.log();
+    console.log(chalk.dim('  # Use CodeQL for production analysis'));
+    console.log(`  ${chalk.green('$')} monarch analyze ./src --exporter codeql-ts`);
+    console.log();
+    console.log(chalk.dim('  # CI pipeline with diff check'));
+    console.log(`  ${chalk.green('$')} monarch diff baseline.json current.json --exit-on-changes`);
+    console.log();
+    console.log(chalk.bold.underline('MORE INFORMATION'));
+    console.log();
+    console.log(`  Run ${chalk.cyan('monarch help <command>')} for detailed help on a specific command.`);
+    console.log(`  Documentation: ${chalk.underline('https://github.com/your-username/monarch')}`);
+    console.log();
+}
+function printCommandHelp(cmd) {
+    const aliasStr = cmd.alias ? ` ${chalk.dim(`(alias: ${cmd.alias})`)}` : '';
+    console.log();
+    console.log(chalk.bold.cyan(`monarch ${cmd.name}`) + aliasStr);
+    console.log();
+    console.log(cmd.description);
+    console.log();
+    console.log(chalk.bold.underline('USAGE'));
+    console.log(`  ${chalk.cyan(cmd.usage)}`);
+    console.log();
+    if (cmd.options.length > 0) {
+        console.log(chalk.bold.underline('OPTIONS'));
+        console.log();
+        const maxFlagLen = Math.max(...cmd.options.map(o => o.flag.length));
+        for (const opt of cmd.options) {
+            const defaultStr = opt.default !== undefined ? chalk.dim(` [default: ${opt.default}]`) : '';
+            console.log(`  ${chalk.yellow(opt.flag.padEnd(maxFlagLen + 2))} ${opt.description}${defaultStr}`);
+        }
+        console.log();
+    }
+    console.log(chalk.bold.underline('EXAMPLES'));
+    console.log();
+    for (const example of cmd.examples) {
+        console.log(`  ${chalk.green('$')} ${example}`);
+    }
+    console.log();
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,6 @@
+interface InitOptions {
+    force: boolean;
+}
+export declare function initCommand(options: InitOptions): Promise<void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,UAAU,WAAW;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAUD,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BrE"}

package/dist/commands/init.js

@@ -0,0 +1,37 @@
+import fs from 'fs';
+import path from 'path';
+import { log, formatPath } from '../utils/output.js';
+const DEFAULT_CONFIG = {
+    version: '1.0',
+    exporter: 'mock',
+    output: 'monarch-graph.json',
+    include: ['src/**/*.ts', 'src/**/*.tsx'],
+    exclude: ['**/*.test.ts', '**/*.spec.ts', '**/node_modules/**'],
+};
+export async function initCommand(options) {
+    const configPath = path.resolve('monarch.json');
+    if (fs.existsSync(configPath) && !options.force) {
+        log.error(`Configuration file already exists: ${formatPath(configPath)}`);
+        log.info('Use --force to overwrite');
+        process.exit(1);
+    }
+    // Create config file
+    fs.writeFileSync(configPath, JSON.stringify(DEFAULT_CONFIG, null, 2));
+    log.success(`Created configuration file: ${formatPath(configPath)}`);
+    // Create .gitignore entry suggestion
+    const gitignorePath = path.resolve('.gitignore');
+    const gitignoreEntry = '\n# Monarch\nmonarch-graph.json\n.monarch/\n';
+    if (fs.existsSync(gitignorePath)) {
+        const content = fs.readFileSync(gitignorePath, 'utf-8');
+        if (!content.includes('monarch-graph.json')) {
+            log.info(`Consider adding to ${formatPath('.gitignore')}:`);
+            log.dim(gitignoreEntry.trim());
+        }
+    }
+    log.title('Monarch initialized successfully!');
+    log.info('Next steps:');
+    log.dim('  1. Run `monarch analyze` to generate your first graph');
+    log.dim('  2. Run `monarch serve` to visualize the graph');
+    log.dim('  3. Run `monarch diff <old> <new>` to compare graphs');
+}
+//# sourceMappingURL=init.js.map