@angriff36/manifest 2.18.0

package/packages/cli/dist/commands/diagram.js

@@ -0,0 +1,176 @@
+/**
+ * manifest diagram command
+ *
+ * Generates Mermaid diagrams from Manifest IR:
+ *   - ER diagrams (entity-relationship)
+ *   - State machine diagrams (from entity transitions)
+ *   - Sequence diagrams (from command execution flows)
+ *
+ * Accepts .manifest source files or precompiled .ir.json files.
+ * Outputs .mmd files (or optionally markdown-wrapped code blocks).
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import { glob } from 'glob';
+import chalk from 'chalk';
+import ora from 'ora';
+// Import from the main Manifest package
+async function loadCompiler() {
+    const module = await import('@angriff36/manifest/ir-compiler');
+    return { compileToIR: module.compileToIR };
+}
+async function loadMermaidProjection() {
+    const module = await import('@angriff36/manifest/projections/mermaid');
+    return { MermaidProjection: module.MermaidProjection };
+}
+/**
+ * Load IR from a file (either .manifest source or .ir.json).
+ */
+async function loadIR(filePath) {
+    const resolved = path.resolve(process.cwd(), filePath);
+    const content = await fs.readFile(resolved, 'utf-8');
+    if (filePath.endsWith('.manifest')) {
+        const { compileToIR } = await loadCompiler();
+        const result = await compileToIR(content, { sourcePath: resolved });
+        if (!result.ir) {
+            const errors = (result.diagnostics || [])
+                .filter((d) => d.severity === 'error')
+                .map((d) => d.message)
+                .join('\n');
+            throw new Error(`Compilation failed:\n${errors}`);
+        }
+        return result.ir;
+    }
+    return JSON.parse(content);
+}
+/**
+ * Get all input files (manifest or IR).
+ */
+async function getInputFiles(source) {
+    const resolved = path.resolve(process.cwd(), source);
+    const stat = await fs.stat(resolved).catch(() => null);
+    if (!stat) {
+        throw new Error(`Source not found: ${source}`);
+    }
+    if (stat.isFile()) {
+        return [resolved];
+    }
+    // Directory: find both .manifest and .ir.json files
+    const manifestFiles = await glob('**/*.manifest', { cwd: resolved });
+    const irFiles = await glob('**/*.ir.json', { cwd: resolved });
+    const all = [...manifestFiles, ...irFiles];
+    return all.map(f => path.join(resolved, f));
+}
+/**
+ * Map diagram type to Mermaid projection surface name.
+ */
+function typeToSurface(type) {
+    switch (type) {
+        case 'er': return 'mermaid.er';
+        case 'state': return 'mermaid.state';
+        case 'sequence': return 'mermaid.sequence';
+        case 'all': return 'mermaid.all';
+        default: return 'mermaid.all';
+    }
+}
+/**
+ * Generate Mermaid diagrams from IR or .manifest source files.
+ */
+export async function diagramCommand(source, options = {}) {
+    const spinner = ora('Preparing to generate diagrams').start();
+    const diagramType = options.type || 'all';
+    const outputDir = path.resolve(process.cwd(), options.output || 'diagrams');
+    try {
+        if (!source) {
+            spinner.fail('Source argument is required (path to .manifest file, .ir.json file, or directory)');
+            process.exitCode = 1;
+            return;
+        }
+        // Collect all IRs
+        const files = await getInputFiles(source);
+        if (files.length === 0) {
+            spinner.warn('No .manifest or .ir.json files found');
+            return;
+        }
+        spinner.text = `Loading ${files.length} file(s)...`;
+        // Merge all IRs into one
+        const mergedIR = {
+            version: '1.0',
+            provenance: {
+                contentHash: '',
+                compilerVersion: '',
+                schemaVersion: '',
+                compiledAt: new Date().toISOString(),
+            },
+            modules: [],
+            values: [],
+            entities: [],
+            enums: [],
+            stores: [],
+            events: [],
+            commands: [],
+            policies: [],
+        };
+        for (const file of files) {
+            const ir = await loadIR(file);
+            if (!mergedIR.provenance.compilerVersion) {
+                mergedIR.provenance = ir.provenance;
+            }
+            mergedIR.modules.push(...ir.modules);
+            mergedIR.entities.push(...ir.entities);
+            mergedIR.stores.push(...ir.stores);
+            mergedIR.events.push(...ir.events);
+            mergedIR.commands.push(...ir.commands);
+            mergedIR.policies.push(...ir.policies);
+        }
+        // Create output directory
+        await fs.mkdir(outputDir, { recursive: true });
+        // Load and invoke the Mermaid projection
+        spinner.text = 'Generating diagrams...';
+        const { MermaidProjection } = await loadMermaidProjection();
+        const projection = new MermaidProjection();
+        const surface = typeToSurface(diagramType);
+        const result = projection.generate(mergedIR, {
+            surface,
+            entity: options.entity,
+            options: {
+                markdown: options.markdown ?? false,
+                includeProperties: true,
+                entity: options.entity,
+            },
+        });
+        // Show diagnostics
+        for (const d of result.diagnostics) {
+            if (d.severity === 'error') {
+                console.error(chalk.red(`  Error: ${d.message}`));
+            }
+            else if (d.severity === 'warning') {
+                console.warn(chalk.yellow(`  Warning: ${d.message}`));
+            }
+            else {
+                console.log(chalk.gray(`  Info: ${d.message}`));
+            }
+        }
+        // Write artifacts
+        let artifactCount = 0;
+        for (const artifact of result.artifacts) {
+            if (!artifact.pathHint)
+                continue;
+            const outputPath = path.resolve(outputDir, path.basename(artifact.pathHint));
+            await fs.writeFile(outputPath, artifact.code, 'utf-8');
+            console.log(chalk.gray(`  -> ${path.relative(process.cwd(), outputPath)}`));
+            artifactCount++;
+        }
+        if (artifactCount === 0) {
+            spinner.warn('No diagrams generated (check diagnostics above)');
+        }
+        else {
+            spinner.succeed(`Generated ${artifactCount} diagram(s) -> ${chalk.cyan(path.relative(process.cwd(), outputDir))}`);
+        }
+    }
+    catch (error) {
+        spinner.fail(`Diagram generation failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=diagram.js.map

package/packages/cli/dist/commands/diagram.js.map

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

package/packages/cli/dist/commands/docs.d.ts

@@ -0,0 +1,18 @@
+/**
+ * manifest docs command
+ *
+ * Generates a static documentation site from Manifest IR.
+ * Each entity gets a reference page with property tables, command signatures,
+ * policy rules, constraint details, and event listings.
+ */
+interface DocsOptions {
+    output?: string;
+    format?: 'html' | 'markdown';
+    title?: string;
+}
+/**
+ * Generate documentation from IR or .manifest source files.
+ */
+export declare function docsCommand(source: string | undefined, options?: DocsOptions): Promise<void>;
+export {};
+//# sourceMappingURL=docs.d.ts.map

package/packages/cli/dist/commands/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAq0BD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAmFf"}