@libar-dev/architect 1.0.0-pre.3

package/dist/cli/generate-docs.js

@@ -0,0 +1,370 @@
+#!/usr/bin/env node
+/**
+ * @architect
+ * @architect-core @architect-cli
+ * @architect-pattern Documentation Generator CLI
+ * @architect-status completed
+ * @architect-uses Orchestrator, Generator Registry
+ * @architect-used-by npm scripts, CI pipelines
+ * @architect-usecase "When generating documentation from command line"
+ * @architect-usecase "When integrating doc generation into npm scripts"
+ * @architect-extract-shapes CLIConfig
+ *
+ * ## architect-generate - Single Entry Point for All Documentation Generation
+ *
+ * Replaces multiple specialized CLIs with one unified interface that supports
+ * multiple generators in a single run.
+ *
+ * ### When to Use
+ *
+ * - Generating any documentation from annotated TypeScript source
+ * - Running multiple generators in one command
+ * - Using a project config file for reproducible builds
+ *
+ * ### Key Concepts
+ *
+ * - **Multi-Generator**: Run patterns, adrs, overview, custom generators together
+ * - **Explicit Registration**: Generators must be registered before use
+ */
+// ─── Error Convention ───────────────────────────────────────────────────
+// CLI modules use throw/catch + process.exit(). Pipeline modules use Result<T,E>.
+// See src/cli/error-handler.ts for the unified handler.
+// ────────────────────────────────────────────────────────────────────────
+import * as path from 'path';
+import { generatorRegistry } from '../generators/registry.js';
+import { generateDocumentation, generateFromConfig } from '../generators/orchestrator.js';
+import { loadProjectConfig } from '../config/config-loader.js';
+import { registerReferenceGenerators } from '../generators/built-in/reference-generators.js';
+import { printVersionAndExit } from './version.js';
+// Import built-in generators (registers patterns, adrs, overview)
+import '../generators/built-in/index.js';
+function parseArgs(argv = process.argv.slice(2)) {
+    const config = {
+        input: [],
+        exclude: [],
+        output: 'docs/architecture',
+        baseDir: process.cwd(),
+        generators: ['patterns'],
+        overwrite: false,
+        features: [],
+        workflowPath: null,
+        listGenerators: false,
+        help: false,
+        version: false,
+        // PR Changes options
+        gitDiffBase: null,
+        changedFiles: [],
+        releaseFilter: null,
+        generatorsExplicit: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const nextArg = argv[i + 1];
+        switch (arg) {
+            case '-i':
+            case '--input':
+                if (!nextArg || nextArg.startsWith('-')) {
+                    throw new Error(`${arg} requires a value`);
+                }
+                config.input.push(nextArg);
+                i++;
+                break;
+            case '-e':
+            case '--exclude':
+                if (!nextArg || nextArg.startsWith('-')) {
+                    throw new Error(`${arg} requires a value`);
+                }
+                config.exclude.push(nextArg);
+                i++;
+                break;
+            case '-o':
+            case '--output':
+                if (!nextArg || nextArg.startsWith('-')) {
+                    throw new Error(`${arg} requires a value`);
+                }
+                config.output = nextArg;
+                i++;
+                break;
+            case '-b':
+            case '--base-dir':
+                if (!nextArg || nextArg.startsWith('-')) {
+                    throw new Error(`${arg} requires a value`);
+                }
+                config.baseDir = nextArg;
+                i++;
+                break;
+            case '-g':
+            case '--generators':
+                if (!nextArg || nextArg.startsWith('-')) {
+                    throw new Error(`${arg} requires a value`);
+                }
+                // Replace default if generators are specified
+                if (config.generators.length === 1 && config.generators[0] === 'patterns') {
+                    config.generators = [];
+                }
+                config.generators.push(nextArg);
+                config.generatorsExplicit = true;
+                i++;
+                break;
+            case '-f':
+            case '--overwrite':
+                config.overwrite = true;
+                break;
+            case '--features':
+                if (!nextArg || nextArg.startsWith('-')) {
+                    throw new Error(`${arg} requires a value`);
+                }
+                config.features.push(nextArg);
+                i++;
+                break;
+            case '-w':
+            case '--workflow':
+                if (!nextArg || nextArg.startsWith('-')) {
+                    throw new Error(`${arg} requires a value`);
+                }
+                config.workflowPath = nextArg;
+                i++;
+                break;
+            case '--list-generators':
+                config.listGenerators = true;
+                break;
+            case '-h':
+            case '--help':
+                config.help = true;
+                break;
+            case '-v':
+            case '--version':
+                config.version = true;
+                break;
+            // PR Changes options
+            case '--git-diff-base':
+                if (!nextArg || nextArg.startsWith('-')) {
+                    throw new Error(`${arg} requires a value (e.g., main, develop)`);
+                }
+                config.gitDiffBase = nextArg;
+                i++;
+                break;
+            case '--changed-files':
+                if (!nextArg || nextArg.startsWith('-')) {
+                    throw new Error(`${arg} requires a value`);
+                }
+                config.changedFiles.push(nextArg);
+                i++;
+                break;
+            case '--release-filter':
+                if (!nextArg || nextArg.startsWith('-')) {
+                    throw new Error(`${arg} requires a value (e.g., v0.2.0)`);
+                }
+                config.releaseFilter = nextArg;
+                i++;
+                break;
+            default:
+                throw new Error(`Unknown option: ${arg ?? ''}`);
+        }
+    }
+    return config;
+}
+function showHelp() {
+    console.log(`
+Usage: architect-generate [options]
+
+Generate documentation from annotated TypeScript source code.
+
+Options:
+  -i, --input <pattern>        Glob patterns for TypeScript files (repeatable)
+  -e, --exclude <pattern>      Glob patterns to exclude (repeatable)
+  -o, --output <dir>           Output directory (default: docs/architecture)
+  -b, --base-dir <dir>         Base directory for relative paths (default: cwd)
+  -g, --generators <names>     Generators to run (repeatable, default: patterns)
+  -w, --workflow <file>        Workflow config JSON file (default: 6-phase-standard)
+  -f, --overwrite              Overwrite existing files
+  --features <pattern>         Glob pattern for .feature files
+  --list-generators            List available generators and exit
+  -h, --help                   Show this help message
+  -v, --version                Show version number
+
+PR Changes Options (for -g pr-changes):
+  --git-diff-base <branch>     Base branch for git diff (e.g., main)
+  --changed-files <file>       Explicit file list (repeatable, overrides git)
+  --release-filter <version>   Filter by release version (e.g., v0.2.0)
+
+  When architect.config.ts or architect.config.js provides sources, --input is optional.
+  CLI flags override config when both are provided.
+
+Examples:
+  architect-generate -i "src/**/*.ts" -o docs
+  architect-generate -i "src/**/*.ts" -g patterns -g adrs -f
+  architect-generate --list-generators
+
+PR Changes Examples:
+  architect-generate -g pr-changes --git-diff-base main -o docs-living -f
+  architect-generate -g pr-changes --release-filter v0.2.0 -o docs-living -f
+  architect-generate -g pr-changes --changed-files src/foo.ts --changed-files src/bar.ts -o docs
+`);
+}
+async function main() {
+    const opts = parseArgs();
+    // Show version
+    if (opts.version) {
+        printVersionAndExit('architect-generate');
+    }
+    // Show help
+    if (opts.help) {
+        showHelp();
+        return;
+    }
+    const baseDir = path.resolve(opts.baseDir);
+    // List generators
+    if (opts.listGenerators) {
+        const configResult = await loadProjectConfig(baseDir);
+        if (!configResult.ok) {
+            console.error(`Error loading config: ${configResult.error.message}`);
+            process.exit(1);
+        }
+        if (configResult.value.project.referenceDocConfigs.length > 0) {
+            registerReferenceGenerators(generatorRegistry, configResult.value.project.referenceDocConfigs);
+        }
+        console.log('Available generators:');
+        const available = generatorRegistry.available();
+        if (available.length === 0) {
+            console.log('  (none registered)');
+            console.log('');
+            console.log('Tip: Ensure built-in generators are imported in your code.');
+        }
+        else {
+            for (const name of available) {
+                const gen = generatorRegistry.get(name);
+                console.log(`  - ${name}: ${gen?.description ?? '(no description)'}`);
+            }
+        }
+        return;
+    }
+    // Load project config
+    const configResult = await loadProjectConfig(baseDir);
+    if (!configResult.ok) {
+        console.error(`Error loading config: ${configResult.error.message}`);
+        process.exit(1);
+    }
+    const resolvedConfig = configResult.value;
+    if (resolvedConfig.isDefault) {
+        console.log('  (No architect.config.ts or architect.config.js found; using defaults)');
+    }
+    // Determine generators to run (CLI -g overrides config)
+    const effectiveGenerators = (opts.generatorsExplicit ? opts.generators : [...resolvedConfig.project.generators]).flatMap((g) => g.split(','));
+    const input = opts.input;
+    const exclude = opts.exclude.length > 0 ? opts.exclude : undefined;
+    const features = opts.features.length > 0 ? opts.features : undefined;
+    let result;
+    if (input.length > 0) {
+        // CLI flags provided — explicit overrides take precedence over config
+        console.log('Scanning source files...');
+        result = await generateDocumentation({
+            input,
+            ...(exclude ? { exclude } : {}),
+            baseDir,
+            outputDir: opts.output,
+            generators: effectiveGenerators,
+            overwrite: opts.overwrite,
+            ...(features ? { features } : {}),
+            ...(opts.workflowPath ? { workflowPath: opts.workflowPath } : {}),
+            ...(opts.gitDiffBase ? { gitDiffBase: opts.gitDiffBase } : {}),
+            ...(opts.changedFiles.length > 0 ? { changedFiles: opts.changedFiles } : {}),
+            ...(opts.releaseFilter ? { releaseFilter: opts.releaseFilter } : {}),
+        });
+    }
+    else if (resolvedConfig.project.sources.typescript.length > 0) {
+        // No CLI input — use config-based sources
+        console.log('Using sources from project config...');
+        console.log('Scanning source files...');
+        result = await generateFromConfig(resolvedConfig, {
+            generators: effectiveGenerators,
+            ...(opts.gitDiffBase ? { gitDiffBase: opts.gitDiffBase } : {}),
+            ...(opts.changedFiles.length > 0 ? { changedFiles: opts.changedFiles } : {}),
+            ...(opts.releaseFilter ? { releaseFilter: opts.releaseFilter } : {}),
+        });
+    }
+    else {
+        console.error('Error: No source files specified.');
+        console.error('');
+        console.error('Either provide --input flags or configure sources in architect.config.ts or architect.config.js:');
+        console.error('');
+        console.error('  // architect.config.ts (or .js)');
+        console.error('  import { defineConfig } from "@libar-dev/architect/config";');
+        console.error('  export default defineConfig({');
+        console.error('    sources: { typescript: ["src/**/*.ts"] }');
+        console.error('  });');
+        process.exit(1);
+    }
+    if (!result.ok) {
+        console.error(`Error: ${result.error}`);
+        process.exit(1);
+    }
+    const { patterns, files, warnings, errors } = result.value;
+    // Report scan/extraction warnings
+    for (const warning of warnings) {
+        if (warning.type === 'scan') {
+            console.warn(`  ⚠ ${warning.message}`);
+            // Display detailed error information if available
+            if (warning.details && warning.details.length > 0) {
+                for (const detail of warning.details) {
+                    const location = detail.line !== undefined
+                        ? `:${detail.line}${detail.column !== undefined ? `:${detail.column}` : ''}`
+                        : '';
+                    console.warn(`    - ${detail.file}${location}`);
+                    console.warn(`      ${detail.message}`);
+                }
+            }
+        }
+    }
+    console.log(`  Found ${patterns.length} patterns`);
+    // Report extraction warnings
+    for (const warning of warnings) {
+        if (warning.type === 'extraction') {
+            console.warn(`  ⚠ ${warning.message}`);
+        }
+    }
+    console.log('Extracting patterns...');
+    console.log(`  Extracted ${patterns.length} patterns`);
+    // Run generators and report results
+    const generatorNames = [...new Set(effectiveGenerators)];
+    for (const generatorName of generatorNames) {
+        const trimmedName = generatorName.trim();
+        console.log(`\nRunning generator: ${trimmedName}`);
+        // Check for generator errors
+        const generatorErrors = errors.filter((e) => e.generator === trimmedName);
+        if (generatorErrors.length > 0) {
+            for (const error of generatorErrors) {
+                console.error(`  ✗ ${error.message}`);
+            }
+            continue;
+        }
+        // Report files written by this generator
+        const generatorFiles = files.filter((f) => f.generator === trimmedName);
+        const writtenFiles = generatorFiles.filter((f) => f.written);
+        const skippedFiles = generatorFiles.filter((f) => !f.written);
+        for (const file of writtenFiles) {
+            console.log(`  ✓ ${file.path}`);
+        }
+        for (const file of skippedFiles) {
+            console.warn(`  ⚠ Skipping ${file.path} (exists, use -f to overwrite)`);
+        }
+    }
+    // Report any file write errors
+    const fileWriteErrors = errors.filter((e) => e.type === 'file-write');
+    if (fileWriteErrors.length > 0) {
+        console.error('\nFile write errors:');
+        for (const error of fileWriteErrors) {
+            console.error(`  ✗ ${error.message}`);
+        }
+    }
+    // Summary
+    const successCount = files.filter((f) => f.written).length;
+    const skippedCount = files.filter((f) => !f.written).length;
+    console.log('\n✅ Documentation generation complete!');
+    console.log(`   ${successCount} files written${skippedCount > 0 ? `, ${skippedCount} skipped` : ''}`);
+}
+void main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=generate-docs.js.map

package/dist/cli/generate-docs.js.map

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

package/dist/cli/lint-patterns.d.ts

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+/**
+ * @architect
+ * @architect-cli
+ * @architect-pattern LintPatternsCLI
+ * @architect-status completed
+ * @architect-uses LintEngine, LintRules, PatternScanner
+ * @architect-extract-shapes LintCLIConfig
+ *
+ * ## LintPatternsCLI - Pattern Annotation Quality Checker
+ *
+ * Validates pattern annotations for quality and completeness.
+ * Use in CI to enforce documentation standards.
+ *
+ * ### When to Use
+ *
+ * - Use in CI pipelines to enforce annotation quality
+ * - Use locally to check annotations before committing
+ * - Use with `--strict` flag to treat warnings as errors
+ */
+import { type LintSeverity } from '../lint/index.js';
+/**
+ * CLI configuration
+ */
+export interface LintCLIConfig {
+    /** Glob patterns for input files */
+    input: string[];
+    /** Glob patterns to exclude */
+    exclude: string[];
+    /** Base directory for path resolution */
+    baseDir: string;
+    /** Treat warnings as errors */
+    strict: boolean;
+    /** Output format */
+    format: 'pretty' | 'json';
+    /** Only show errors (suppress warnings/info) */
+    quiet: boolean;
+    /** Minimum severity to report */
+    minSeverity: LintSeverity;
+    /** Show help */
+    help: boolean;
+    /** Show version */
+    version: boolean;
+}
+/**
+ * Parse command line arguments
+ *
+ * @param argv - Command line arguments (defaults to process.argv.slice(2))
+ * @returns Parsed CLI configuration
+ * @throws Error if required flags are missing values
+ */
+export declare function parseArgs(argv?: string[]): LintCLIConfig;
+/**
+ * Print usage information
+ */
+export declare function printHelp(): void;
+//# sourceMappingURL=lint-patterns.d.ts.map

package/dist/cli/lint-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-patterns.d.ts","sourceRoot":"","sources":["../../src/cli/lint-patterns.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAYH,OAAO,EAQL,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB;IACpB,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,gDAAgD;IAChD,KAAK,EAAE,OAAO,CAAC;IACf,iCAAiC;IACjC,WAAW,EAAE,YAAY,CAAC;IAC1B,gBAAgB;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,mBAAmB;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,aAAa,CAkE/E;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CA0ChC"}