monarch-code-graph 0.3.4

package/README.md

@@ -0,0 +1,485 @@
+<p align="center">
+  <img src="../../logo.png" alt="Monarch Logo" width="150" />
+</p>
+
+<h1 align="center">Monarch CLI</h1>
+
+<p align="center">
+  Command-line interface for Monarch - static codebase flow mapping and visualization.
+</p>
+
+## Installation
+
+### Global Installation (Recommended)
+
+Install globally to use `monarch` as a command anywhere:
+
+```bash
+# Using npm
+npm install -g monarch-code-graph
+
+# Using pnpm
+pnpm add -g monarch-code-graph
+
+# Using yarn
+yarn global add monarch-code-graph
+```
+
+After installation, the `monarch` command will be available globally:
+
+```bash
+monarch --version
+monarch --help
+```
+
+### Local Installation
+
+Install as a dev dependency in your project:
+
+```bash
+npm install --save-dev monarch-code-graph
+```
+
+Then run via npx or package.json scripts:
+
+```bash
+npx monarch analyze ./src
+```
+
+### From Source
+
+If you're developing Monarch or want the latest version:
+
+```bash
+# Clone the repository
+git clone https://github.com/your-username/monarch.git
+cd monarch
+
+# Install dependencies
+pnpm install
+
+# Build all packages
+pnpm build
+
+# Link CLI globally
+cd packages/cli
+pnpm link --global
+```
+
+## Commands
+
+### `monarch run` (Recommended)
+
+**All-in-one command** that analyzes your codebase, detects changes, and starts the visualization server. This is the recommended way to use Monarch during development.
+
+```bash
+monarch run [path] [options]
+```
+
+**Alias:** `monarch r`
+
+**What it does:**
+1. Checks if a graph artifact already exists
+2. If exists, analyzes the codebase and compares for changes
+3. If no changes detected, skips regeneration (fast!)
+4. If changes detected, generates a new artifact
+5. Starts the visualization server
+6. Opens the browser (with `--open` flag)
+
+**Arguments:**
+| Argument | Description | Default |
+|----------|-------------|---------|
+| `path` | Path to the codebase to analyze | `.` (current directory) |
+
+**Options:**
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-o, --output <path>` | Output artifact file path | `monarch-graph.json` |
+| `-e, --exporter <name>` | Exporter to use (`mock`, `codeql-ts`) | `mock` |
+| `-p, --port <number>` | Port for visualization server | `3000` |
+| `--open` | Open browser automatically | `false` |
+| `-f, --force` | Force regeneration even if no changes | `false` |
+
+**Examples:**
+```bash
+# Quick start - analyze and visualize
+monarch run ./src --open
+
+# Run on custom port
+monarch run ./src -p 8080 --open
+
+# Force regeneration
+monarch run ./src --force
+
+# With custom output file
+monarch r ./src -o my-graph.json
+```
+
+---
+
+### `monarch init`
+
+Initialize a new Monarch project in the current directory.
+
+```bash
+monarch init [options]
+```
+
+**Options:**
+| Option | Description |
+|--------|-------------|
+| `-f, --force` | Overwrite existing configuration |
+
+**Example:**
+```bash
+# Create monarch.json configuration file
+monarch init
+
+# Overwrite existing config
+monarch init --force
+```
+
+This creates a `monarch.json` configuration file and suggests `.gitignore` entries.
+
+---
+
+### `monarch analyze`
+
+Analyze a codebase and generate a flow artifact.
+
+```bash
+monarch analyze [path] [options]
+```
+
+**Alias:** `monarch a`
+
+**Arguments:**
+| Argument | Description | Default |
+|----------|-------------|---------|
+| `path` | Path to the codebase to analyze | `.` (current directory) |
+
+**Options:**
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-o, --output <path>` | Output artifact file path | `monarch-graph.json` |
+| `-e, --exporter <name>` | Exporter to use (`mock`, `codeql-ts`) | `mock` |
+| `-w, --watch` | Watch for changes and re-analyze | `false` |
+
+**Examples:**
+```bash
+# Analyze current directory
+monarch analyze
+
+# Analyze a specific path
+monarch analyze ./src
+
+# Specify output file
+monarch analyze ./src -o my-graph.json
+
+# Use CodeQL exporter (requires CodeQL CLI)
+monarch analyze ./src --exporter codeql-ts
+
+# Short alias
+monarch a ./src -o graph.json
+```
+
+**Exporters:**
+
+| Exporter | Description | Requirements |
+|----------|-------------|--------------|
+| `mock` | Fast regex-based TypeScript analysis | None |
+| `codeql-ts` | Production-grade CodeQL analysis | [CodeQL CLI](https://github.com/github/codeql-cli-binaries) |
+
+---
+
+### `monarch diff`
+
+Compare two graph artifacts and show changes.
+
+```bash
+monarch diff <baseline> <current> [options]
+```
+
+**Alias:** `monarch d`
+
+**Arguments:**
+| Argument | Description |
+|----------|-------------|
+| `baseline` | Path to the baseline artifact |
+| `current` | Path to the current artifact |
+
+**Options:**
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-f, --format <type>` | Output format (`text`, `json`, `markdown`) | `text` |
+| `--exit-on-changes` | Exit with code 1 if changes detected | `false` |
+| `--only <type>` | Show only specific changes (`functions`, `modules`, `edges`) | - |
+
+**Examples:**
+```bash
+# Compare two artifacts (text output)
+monarch diff baseline.json current.json
+
+# JSON output for programmatic use
+monarch diff baseline.json current.json --format json
+
+# Markdown output for reports
+monarch diff baseline.json current.json --format markdown
+
+# CI mode - fail if changes detected
+monarch diff baseline.json current.json --exit-on-changes
+
+# Show only function changes
+monarch diff baseline.json current.json --only functions
+```
+
+**Exit Codes:**
+| Code | Meaning |
+|------|---------|
+| `0` | No changes detected (or `--exit-on-changes` not set) |
+| `1` | Changes detected (with `--exit-on-changes`) or error |
+
+---
+
+### `monarch serve`
+
+Start the visualization UI server.
+
+```bash
+monarch serve [options]
+```
+
+**Alias:** `monarch s`
+
+**Options:**
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-p, --port <number>` | Port to serve on | `3000` |
+| `-a, --artifact <path>` | Artifact file path | `monarch-graph.json` |
+| `--open` | Open browser automatically | `false` |
+
+**Examples:**
+```bash
+# Start server with defaults
+monarch serve
+
+# Custom port
+monarch serve --port 8080
+
+# Specify artifact and open browser
+monarch serve --artifact my-graph.json --open
+
+# Short alias
+monarch s -p 4000
+```
+
+---
+
+### `monarch list`
+
+List contents of a graph artifact.
+
+```bash
+monarch list [artifact] [options]
+```
+
+**Alias:** `monarch ls`
+
+**Arguments:**
+| Argument | Description | Default |
+|----------|-------------|---------|
+| `artifact` | Path to artifact file | `monarch-graph.json` |
+
+**Options:**
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-t, --type <type>` | Filter by type (`functions`, `modules`, `components`, `edges`) | - |
+| `--json` | Output as JSON | `false` |
+
+**Examples:**
+```bash
+# List all contents
+monarch list
+
+# List specific artifact
+monarch list my-graph.json
+
+# Show only functions
+monarch list --type functions
+
+# JSON output
+monarch list --json
+
+# Show only modules as JSON
+monarch list --type modules --json
+
+# Short alias
+monarch ls my-graph.json -t edges
+```
+
+## Configuration File
+
+Create a `monarch.json` file in your project root:
+
+```json
+{
+  "exporter": "mock",
+  "output": "monarch-graph.json",
+  "include": [
+    "src/**/*.ts",
+    "src/**/*.tsx"
+  ],
+  "exclude": [
+    "**/*.test.ts",
+    "**/*.spec.ts",
+    "**/node_modules/**"
+  ]
+}
+```
+
+## CI/CD Integration
+
+### GitHub Actions
+
+Add to your workflow:
+
+```yaml
+name: CodeFlow Analysis
+
+on: [push, pull_request]
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'pnpm'
+
+      - run: pnpm install
+
+      - name: Generate artifact
+        run: npx monarch analyze ./src -o artifact.json
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: monarch-artifact
+          path: artifact.json
+```
+
+### PR Diff Workflow
+
+```yaml
+- name: Generate current
+  run: npx monarch analyze ./src -o current.json
+
+# ... checkout base branch and generate baseline ...
+
+- name: Compare
+  run: npx monarch diff baseline.json current.json --format markdown >> $GITHUB_STEP_SUMMARY
+```
+
+## Programmatic Usage
+
+The CLI can also be used programmatically:
+
+```typescript
+import { analyzeCommand, diffCommand } from 'monarch-cli';
+
+// Analyze
+await analyzeCommand('./src', {
+  output: 'graph.json',
+  exporter: 'mock',
+  watch: false,
+});
+
+// Diff
+await diffCommand('baseline.json', 'current.json', {
+  format: 'json',
+  exitOnChanges: false,
+});
+```
+
+## Building from Source
+
+```bash
+# Clone repository
+git clone https://github.com/your-username/monarch.git
+cd monarch
+
+# Install dependencies
+pnpm install
+
+# Build all packages (required - CLI depends on other packages)
+pnpm build
+
+# Run CLI directly
+node packages/cli/dist/cli.js --help
+
+# Or link globally
+cd packages/cli
+pnpm link --global
+monarch --help
+```
+
+## Development
+
+```bash
+# Run tests
+pnpm --filter monarch-cli test
+
+# Watch mode
+pnpm --filter monarch-cli test:watch
+
+# Type check
+pnpm --filter monarch-cli typecheck
+
+# Build only CLI
+pnpm --filter monarch-cli build
+```
+
+## Troubleshooting
+
+### "Command not found: monarch"
+
+Ensure global npm/pnpm binaries are in your PATH:
+
+```bash
+# npm
+export PATH="$PATH:$(npm config get prefix)/bin"
+
+# pnpm
+export PATH="$PATH:$(pnpm config get prefix)/bin"
+```
+
+### CodeQL Exporter Fails
+
+1. Verify CodeQL CLI is installed:
+   ```bash
+   codeql --version
+   ```
+
+2. If not installed, download from [CodeQL CLI Binaries](https://github.com/github/codeql-cli-binaries)
+
+3. Ensure the target project has JavaScript/TypeScript files
+
+### Artifact File Not Found
+
+The default artifact path is `monarch-graph.json` in the current directory. Specify the path explicitly:
+
+```bash
+monarch list ./path/to/artifact.json
+monarch serve --artifact ./path/to/artifact.json
+```
+
+## License
+
+Proprietary License - All rights reserved. See [LICENSE](../../LICENSE) for details.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { analyzeCommand } from './commands/analyze.js';
+import { diffCommand } from './commands/diff.js';
+import { serveCommand } from './commands/serve.js';
+import { initCommand } from './commands/init.js';
+import { listCommand } from './commands/list.js';
+import { helpCommand } from './commands/help.js';
+import { runCommand } from './commands/run.js';
+import { graphCommand } from './commands/graph.js';
+const program = new Command();
+program
+    .name('monarch')
+    .description('Monarch - Static codebase flow mapping and visualization')
+    .version('0.1.0')
+    .addHelpCommand(false);
+// Initialize a new Monarch project
+program
+    .command('init')
+    .description('Initialize a new Monarch project in the current directory')
+    .option('-f, --force', 'Overwrite existing configuration', false)
+    .action(initCommand);
+// Analyze a codebase and generate flow artifact
+program
+    .command('analyze')
+    .alias('a')
+    .description('Analyze a codebase and generate flow artifact')
+    .argument('[path]', 'Path to the codebase', '.')
+    .option('-o, --output <path>', 'Output artifact path', 'monarch-graph.json')
+    .option('-e, --exporter <name>', 'Exporter to use (mock, codeql-ts)', 'mock')
+    .option('-w, --watch', 'Watch for changes and re-analyze', false)
+    .action(analyzeCommand);
+// Compare two artifacts
+program
+    .command('diff')
+    .alias('d')
+    .description('Compare two graph artifacts and show changes')
+    .argument('<baseline>', 'Path to baseline artifact')
+    .argument('<current>', 'Path to current artifact')
+    .option('-f, --format <type>', 'Output format (text, json, markdown)', 'text')
+    .option('--exit-on-changes', 'Exit with code 1 if changes detected', false)
+    .option('--only <type>', 'Show only specific changes (functions, modules, edges)')
+    .action(diffCommand);
+// Start visualization server
+program
+    .command('serve')
+    .alias('s')
+    .description('Start the visualization UI server')
+    .option('-p, --port <number>', 'Port to serve on', '3000')
+    .option('-a, --artifact <path>', 'Artifact file path', 'monarch-graph.json')
+    .option('--open', 'Open browser automatically', false)
+    .action(serveCommand);
+// List contents of an artifact
+program
+    .command('list')
+    .alias('ls')
+    .description('List contents of a graph artifact')
+    .argument('[artifact]', 'Path to artifact file', 'monarch-graph.json')
+    .option('-t, --type <type>', 'Filter by type (functions, modules, components, edges)')
+    .option('--json', 'Output as JSON', false)
+    .action(listCommand);
+// Run: analyze, detect changes, and start server (all-in-one)
+program
+    .command('run')
+    .alias('r')
+    .description('Analyze codebase, detect changes, and start visualization server')
+    .argument('[path]', 'Path to the codebase', '.')
+    .option('-o, --output <path>', 'Output artifact path', 'monarch-graph.json')
+    .option('-e, --exporter <name>', 'Exporter to use (mock, codeql-ts)', 'mock')
+    .option('-p, --port <number>', 'Port for visualization server', '3000')
+    .option('--open', 'Open browser automatically', false)
+    .option('-f, --force', 'Force regeneration even if no changes', false)
+    .action(runCommand);
+// Graph: render ASCII graph in terminal
+program
+    .command('graph')
+    .alias('g')
+    .description('Render ASCII graph visualization in terminal')
+    .argument('[artifact]', 'Path to artifact file', 'monarch-graph.json')
+    .option('-l, --level <level>', 'View level (components, modules, functions)', 'modules')
+    .option('-x, --expand <name>', 'Expand a specific component or module by name')
+    .option('--expand-type <type>', 'Type of item to expand (component, module)')
+    .option('--list', 'List expandable components and modules', false)
+    .option('--no-color', 'Disable colored output')
+    .option('-w, --width <cols>', 'Max output width in columns')
+    .action(graphCommand);
+// Comprehensive help command
+program
+    .command('help')
+    .description('Show detailed help for Monarch or a specific command')
+    .argument('[command]', 'Command to get help for')
+    .action(helpCommand);
+// Show custom help when no command is provided
+if (process.argv.length === 2) {
+    helpCommand();
+    process.exit(0);
+}
+// Parse and execute
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/commands/analyze.d.ts

@@ -0,0 +1,8 @@
+interface AnalyzeOptions {
+    output: string;
+    exporter: string;
+    watch: boolean;
+}
+export declare function analyzeCommand(targetPath: string, options: AnalyzeOptions): Promise<void>;
+export {};
+//# sourceMappingURL=analyze.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/commands/analyze.ts"],"names":[],"mappings":"AAOA,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CA6Ef"}

package/dist/commands/analyze.js

@@ -0,0 +1,76 @@
+import fs from 'fs';
+import path from 'path';
+import ora from 'ora';
+import { MockExporter, applyElkLayout } from '@codeflow/analyzer';
+import { log, formatPath, formatNumber } from '../utils/output.js';
+export async function analyzeCommand(targetPath, options) {
+    const absolutePath = path.resolve(targetPath);
+    if (!fs.existsSync(absolutePath)) {
+        log.error(`Path does not exist: ${formatPath(absolutePath)}`);
+        process.exit(1);
+    }
+    log.title('Monarch Analysis');
+    log.info(`Target: ${formatPath(absolutePath)}`);
+    log.info(`Exporter: ${options.exporter}`);
+    log.info(`Output: ${formatPath(options.output)}`);
+    const spinner = ora('Analyzing codebase...').start();
+    try {
+        let artifact;
+        if (options.exporter === 'mock') {
+            const exporter = new MockExporter(absolutePath);
+            await exporter.prepare();
+            spinner.text = 'Scanning files...';
+            await exporter.analyze();
+            spinner.text = 'Generating artifact...';
+            artifact = await exporter.export();
+            await exporter.cleanup();
+        }
+        else if (options.exporter === 'codeql-ts') {
+            spinner.text = 'Creating CodeQL database...';
+            // Dynamic import to avoid loading CodeQL dependencies if not needed
+            const { CodeQLExporter } = await import('@codeflow/analyzer');
+            const exporter = new CodeQLExporter(absolutePath);
+            await exporter.prepare();
+            spinner.text = 'Running CodeQL queries...';
+            await exporter.analyze();
+            spinner.text = 'Generating artifact...';
+            artifact = await exporter.export();
+            await exporter.cleanup();
+        }
+        else {
+            spinner.fail(`Unknown exporter: ${options.exporter}`);
+            process.exit(1);
+        }
+        // Apply layout
+        spinner.text = 'Computing layout...';
+        artifact = await applyElkLayout(artifact);
+        // Ensure output directory exists
+        const outputDir = path.dirname(path.resolve(options.output));
+        if (!fs.existsSync(outputDir)) {
+            fs.mkdirSync(outputDir, { recursive: true });
+        }
+        // Write artifact
+        const outputPath = path.resolve(options.output);
+        fs.writeFileSync(outputPath, JSON.stringify(artifact, null, 2));
+        spinner.succeed('Analysis complete!');
+        // Print summary
+        console.log('');
+        log.success(`Graph saved to ${formatPath(outputPath)}`);
+        console.log('');
+        log.info(`Functions:  ${formatNumber(artifact.nodes.functions.length)}`);
+        log.info(`Modules:    ${formatNumber(artifact.nodes.modules.length)}`);
+        log.info(`Components: ${formatNumber(artifact.nodes.components.length)}`);
+        log.info(`Call edges: ${formatNumber(artifact.edges.calls.length)}`);
+        log.info(`Dataflow:   ${formatNumber(artifact.edges.dataflow.length)}`);
+        if (options.watch) {
+            log.info('\nWatching for changes... (press Ctrl+C to stop)');
+            // TODO: Implement file watching
+        }
+    }
+    catch (error) {
+        spinner.fail('Analysis failed');
+        log.error(String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=analyze.js.map

package/dist/commands/analyze.js.map

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