@libar-dev/architect 1.0.0-pre.3

package/dist/renderable/codecs/decision-doc.js

@@ -0,0 +1,485 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern DecisionDocCodec
+ * @architect-status completed
+ * @architect-arch-role projection
+ * @architect-arch-context renderer
+ * @architect-arch-layer application
+ *
+ * ## Decision Doc Codec
+ *
+ * Parses decision documents (ADR/PDR in .feature format) and extracts content
+ * for documentation generation. Provides parsing utilities for source mapping
+ * tables, self-reference markers, and rule block extraction.
+ *
+ * ### When to Use
+ *
+ * - When extracting content from decision documents for doc generation
+ * - When parsing Rule: blocks for Context/Decision/Consequences sections
+ * - When extracting DocStrings (fenced code blocks) with language tags
+ * - When parsing source mapping tables from decision descriptions
+ *
+ * ### Source Mapping Table Format
+ *
+ * ```
+ * | Section | Source File | Extraction Method |
+ * | Intro & Context | THIS DECISION | Decision rule description |
+ * | API Types | src/types.ts | @extract-shapes tag |
+ * ```
+ *
+ * ### Self-Reference Markers
+ *
+ * - `THIS DECISION` - Extract from the current decision document
+ * - `THIS DECISION (Rule: X)` - Extract specific Rule: block
+ * - `THIS DECISION (DocString)` - Extract fenced code blocks
+ */
+import { parseDescriptionWithDocStrings, partitionRulesByPrefix, } from './helpers.js';
+import { normalizeLineEndings } from '../../utils/string-utils.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// Self-Reference Constants
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Self-reference marker indicating content should be extracted from current document
+ */
+export const SELF_REFERENCE_MARKER = 'THIS DECISION';
+/**
+ * Pattern for self-reference with specific Rule: block
+ * Matches: "THIS DECISION (Rule: SomeName)"
+ */
+export const SELF_REFERENCE_RULE_PATTERN = /^THIS DECISION \(Rule:\s*([^)]+)\)$/i;
+/**
+ * Pattern for self-reference to DocStrings
+ * Matches: "THIS DECISION (DocString)"
+ */
+export const SELF_REFERENCE_DOCSTRING_PATTERN = /^THIS DECISION \(DocString\)$/i;
+// ═══════════════════════════════════════════════════════════════════════════
+// Rule Partitioning (Uses shared helper from helpers.ts)
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Partition decision rules by semantic prefix
+ *
+ * Wrapper around shared partitionRulesByPrefix that doesn't warn about "other" rules.
+ * Decision docs may have additional rules like "Proof of Concept" or "Expected Output"
+ * that are valid but don't fit the standard ADR sections.
+ *
+ * @param rules - Business rules from the extracted pattern
+ * @param _patternName - Pattern name for context (unused, kept for API compatibility)
+ * @returns Partitioned rules by category
+ */
+export function partitionDecisionRules(rules, _patternName) {
+    // Note: Unlike ADR codec, we don't warn about "other" rules
+    return partitionRulesByPrefix(rules, { warnOnOther: false });
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// DocString Extraction
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Extract DocStrings (fenced code blocks) from text content
+ *
+ * Supports two formats:
+ * - Gherkin DocStrings: """language\ncontent\n"""
+ * - Markdown code fences: ```language\ncontent\n```
+ *
+ * @param text - Text content that may contain DocStrings
+ * @returns Array of extracted DocStrings with language tags
+ *
+ * @example
+ * ```typescript
+ * const docStrings = extractDocStrings(`
+ *   Some text...
+ *
+ *   """bash
+ *   npm install
+ *   """
+ *
+ *   More text...
+ *
+ *   """typescript
+ *   const x = 1;
+ *   """
+ * `);
+ * // Returns: [
+ * //   { language: 'bash', content: 'npm install' },
+ * //   { language: 'typescript', content: 'const x = 1;' }
+ * // ]
+ * ```
+ */
+export function extractDocStrings(text) {
+    if (!text || text.trim().length === 0) {
+        return [];
+    }
+    // Normalize line endings (Windows CRLF -> LF)
+    const normalized = normalizeLineEndings(text);
+    const docStrings = [];
+    // Extract Gherkin DocStrings (""" format)
+    const gherkinDocStringPattern = /"""(\w*)\n([\s\S]*?)"""/g;
+    let match;
+    while ((match = gherkinDocStringPattern.exec(normalized)) !== null) {
+        const langMatch = match[1] ?? '';
+        const language = langMatch.length > 0 ? langMatch : 'text';
+        const content = (match[2] ?? '').trim();
+        if (content) {
+            docStrings.push({ language, content });
+        }
+    }
+    // Extract markdown code fences (``` format)
+    const markdownCodePattern = /```(\w*)\n([\s\S]*?)```/g;
+    while ((match = markdownCodePattern.exec(normalized)) !== null) {
+        const langMatch = match[1] ?? '';
+        const language = langMatch.length > 0 ? langMatch : 'text';
+        const content = (match[2] ?? '').trim();
+        if (content) {
+            docStrings.push({ language, content });
+        }
+    }
+    return docStrings;
+}
+/**
+ * Extract DocStrings from business rules
+ *
+ * Iterates through rule descriptions and extracts all embedded DocStrings.
+ *
+ * @param rules - Business rules to extract DocStrings from
+ * @returns Array of extracted DocStrings with language tags
+ */
+export function extractDocStringsFromRules(rules) {
+    if (!rules || rules.length === 0) {
+        return [];
+    }
+    const docStrings = [];
+    for (const rule of rules) {
+        if (rule.description) {
+            docStrings.push(...extractDocStrings(rule.description));
+        }
+    }
+    return docStrings;
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Source Mapping Table Parsing
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Parse a source mapping table from markdown text
+ *
+ * Expected format:
+ * ```
+ * | Section | Source File | Extraction Method |
+ * | Intro & Context | THIS DECISION (Rule: Context above) | Decision rule description |
+ * | API Types | src/types.ts | @extract-shapes tag |
+ * ```
+ *
+ * The table must have headers: Section, Source File (or Source), Extraction Method (or Extraction)
+ *
+ * @param text - Text content that may contain a source mapping table
+ * @returns Array of source mapping entries, empty if no table found
+ *
+ * @example
+ * ```typescript
+ * const mappings = parseSourceMappingTable(`
+ *   **Source Mapping for Process Guard:**
+ *
+ *   | Section | Source File | Extraction Method |
+ *   | Intro & Context | THIS DECISION | Decision rule description |
+ *   | API Types | src/types.ts | @extract-shapes tag |
+ * `);
+ * // Returns: [
+ * //   { section: 'Intro & Context', sourceFile: 'THIS DECISION', extractionMethod: 'Decision rule description' },
+ * //   { section: 'API Types', sourceFile: 'src/types.ts', extractionMethod: '@extract-shapes tag' }
+ * // ]
+ * ```
+ */
+export function parseSourceMappingTable(text) {
+    if (!text || text.trim().length === 0) {
+        return [];
+    }
+    // Normalize line endings
+    const normalized = normalizeLineEndings(text);
+    // Find all markdown tables in the text
+    const lines = normalized.split('\n');
+    const mappings = [];
+    let inTable = false;
+    let headerIndices = null;
+    for (const currentLine of lines) {
+        const line = currentLine.trim();
+        // Check if this line looks like a table row
+        if (line.startsWith('|') && line.endsWith('|')) {
+            const cells = line
+                .split('|')
+                .slice(1, -1) // Remove first and last empty strings from split
+                .map((cell) => cell.trim());
+            // Check if this is a header row
+            if (!inTable) {
+                // Look for header columns (case-insensitive)
+                const sectionIdx = cells.findIndex((c) => c.toLowerCase() === 'section');
+                const sourceIdx = cells.findIndex((c) => c.toLowerCase() === 'source file' || c.toLowerCase() === 'source');
+                const extractionIdx = cells.findIndex((c) => c.toLowerCase() === 'extraction method' ||
+                    c.toLowerCase() === 'extraction' ||
+                    c.toLowerCase() === 'how');
+                if (sectionIdx !== -1 && sourceIdx !== -1 && extractionIdx !== -1) {
+                    headerIndices = {
+                        section: sectionIdx,
+                        sourceFile: sourceIdx,
+                        extraction: extractionIdx,
+                    };
+                    inTable = true;
+                    continue;
+                }
+            }
+            else {
+                // Check if this is the separator row (contains only dashes and pipes)
+                if (cells.every((cell) => /^[-:]+$/.test(cell))) {
+                    continue;
+                }
+                // This is a data row - extract the mapping
+                if (headerIndices) {
+                    const section = cells[headerIndices.section] ?? '';
+                    const sourceFile = cells[headerIndices.sourceFile] ?? '';
+                    const extractionMethod = cells[headerIndices.extraction] ?? '';
+                    // Only add if we have valid data
+                    if (section && sourceFile && extractionMethod) {
+                        mappings.push({
+                            section,
+                            sourceFile,
+                            extractionMethod,
+                        });
+                    }
+                }
+            }
+        }
+        else if (inTable) {
+            // End of table
+            inTable = false;
+            headerIndices = null;
+        }
+    }
+    return mappings;
+}
+/**
+ * Parse source mapping tables from business rules
+ *
+ * Searches through rule descriptions for source mapping tables.
+ *
+ * @param rules - Business rules to search for source mapping tables
+ * @returns Array of source mapping entries from all rules
+ */
+export function parseSourceMappingsFromRules(rules) {
+    if (!rules || rules.length === 0) {
+        return [];
+    }
+    const mappings = [];
+    for (const rule of rules) {
+        if (rule.description) {
+            mappings.push(...parseSourceMappingTable(rule.description));
+        }
+    }
+    return mappings;
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Self-Reference Resolution
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Check if a source file reference is a self-reference
+ *
+ * @param sourceFile - The source file path to check
+ * @returns True if the reference is to the current decision document, false for null/undefined
+ */
+export function isSelfReference(sourceFile) {
+    if (!sourceFile)
+        return false;
+    return (sourceFile === SELF_REFERENCE_MARKER ||
+        SELF_REFERENCE_RULE_PATTERN.test(sourceFile) ||
+        SELF_REFERENCE_DOCSTRING_PATTERN.test(sourceFile));
+}
+/**
+ * Parse a self-reference to extract the referenced element
+ *
+ * @param sourceFile - The source file reference to parse
+ * @returns Object with type and optional name, or null if not a self-reference
+ *
+ * @example
+ * ```typescript
+ * parseSelfReference('THIS DECISION');
+ * // Returns: { type: 'document' }
+ *
+ * parseSelfReference('THIS DECISION (Rule: Context above)');
+ * // Returns: { type: 'rule', name: 'Context above' }
+ *
+ * parseSelfReference('THIS DECISION (DocString)');
+ * // Returns: { type: 'docstring' }
+ *
+ * parseSelfReference('src/types.ts');
+ * // Returns: null
+ * ```
+ */
+export function parseSelfReference(sourceFile) {
+    if (sourceFile === SELF_REFERENCE_MARKER) {
+        return { type: 'document' };
+    }
+    const ruleMatch = SELF_REFERENCE_RULE_PATTERN.exec(sourceFile);
+    if (ruleMatch?.[1]) {
+        return { type: 'rule', name: ruleMatch[1].trim() };
+    }
+    if (SELF_REFERENCE_DOCSTRING_PATTERN.test(sourceFile)) {
+        return { type: 'docstring' };
+    }
+    return null;
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Rule Block Content Extraction
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Find a specific rule by name (flexible matching)
+ *
+ * Matching strategy (in order):
+ * 1. Exact match on full name
+ * 2. Rule name contains search term
+ * 3. Both start with the same word (e.g., "Context above" matches "Context - ...")
+ *
+ * @param rules - Rules to search
+ * @param ruleName - Name to search for (case-insensitive)
+ * @returns The matching rule or undefined
+ */
+export function findRuleByName(rules, ruleName) {
+    if (!rules || rules.length === 0) {
+        return undefined;
+    }
+    const nameLower = ruleName.toLowerCase().trim();
+    // First try exact match
+    const exactMatch = rules.find((r) => r.name.toLowerCase() === nameLower);
+    if (exactMatch) {
+        return exactMatch;
+    }
+    // Then try partial match (rule name contains search term)
+    const partialMatch = rules.find((r) => r.name.toLowerCase().includes(nameLower));
+    if (partialMatch) {
+        return partialMatch;
+    }
+    // Try prefix match - both start with the same word
+    // This handles cases like "Context above" matching "Context - Manual..."
+    const firstWord = nameLower.split(/[\s-]+/)[0];
+    if (firstWord && firstWord.length > 2) {
+        return rules.find((r) => r.name.toLowerCase().startsWith(firstWord));
+    }
+    return undefined;
+}
+/**
+ * Extract content from a rule's description
+ *
+ * Returns the description text with DocStrings parsed as code blocks.
+ *
+ * @param rule - The rule to extract content from
+ * @returns Array of SectionBlocks representing the rule content
+ */
+export function extractRuleContent(rule) {
+    if (!rule.description) {
+        return [];
+    }
+    return parseDescriptionWithDocStrings(rule.description);
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Full Decision Document Parsing
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Parse a complete decision document
+ *
+ * Extracts all relevant content from an ADR/PDR pattern including:
+ * - Partitioned rules (Context/Decision/Consequences/Other)
+ * - DocStrings with language tags
+ * - Source mapping entries
+ *
+ * @param patternName - The pattern name
+ * @param description - The feature description
+ * @param rules - Business rules from the pattern
+ * @returns Parsed decision document content
+ *
+ * @example
+ * ```typescript
+ * const content = parseDecisionDocument(
+ *   'DocGenerationProofOfConcept',
+ *   pattern.directive.description ?? '',
+ *   pattern.rules
+ * );
+ * ```
+ */
+export function parseDecisionDocument(patternName, description, rules) {
+    const partitionedRules = partitionDecisionRules(rules, patternName);
+    // Collect DocStrings from all sources
+    const docStrings = [];
+    // DocStrings from description
+    docStrings.push(...extractDocStrings(description));
+    // DocStrings from all rules
+    docStrings.push(...extractDocStringsFromRules(rules));
+    // Parse source mappings from description AND rules
+    // The description may contain a source mapping table (e.g., in decision documents)
+    const sourceMappings = [
+        ...parseSourceMappingTable(description),
+        ...parseSourceMappingsFromRules(rules),
+    ];
+    return {
+        patternName,
+        description,
+        rules: partitionedRules,
+        docStrings,
+        sourceMappings,
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Extraction Method Dispatch
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Known extraction methods and their descriptions
+ */
+export const EXTRACTION_METHODS = {
+    DECISION_RULE_DESCRIPTION: 'Decision rule description',
+    EXTRACT_SHAPES: '@extract-shapes tag',
+    RULE_BLOCKS: 'Rule blocks',
+    SCENARIO_OUTLINE_EXAMPLES: 'Scenario Outline Examples',
+    JSDOC_SECTION: 'JSDoc section',
+    CREATE_VIOLATION_PATTERNS: 'createViolation() patterns',
+    FENCED_CODE_BLOCK: 'Fenced code block',
+};
+/**
+ * Normalize an extraction method string to a known type
+ *
+ * @param method - The extraction method string from the source mapping
+ * @returns Normalized method key or 'unknown'
+ */
+export function normalizeExtractionMethod(method) {
+    const methodLower = method.toLowerCase().trim();
+    if (methodLower.includes('decision rule') || methodLower.includes('rule description')) {
+        return 'DECISION_RULE_DESCRIPTION';
+    }
+    if (methodLower.includes('@extract-shapes') || methodLower.includes('extract-shapes')) {
+        return 'EXTRACT_SHAPES';
+    }
+    if (methodLower.includes('rule block')) {
+        return 'RULE_BLOCKS';
+    }
+    if (methodLower.includes('scenario outline') || methodLower.includes('examples')) {
+        return 'SCENARIO_OUTLINE_EXAMPLES';
+    }
+    if (methodLower.includes('jsdoc')) {
+        return 'JSDOC_SECTION';
+    }
+    if (methodLower.includes('createviolation') || methodLower.includes('violation')) {
+        return 'CREATE_VIOLATION_PATTERNS';
+    }
+    if (methodLower.includes('fenced') || methodLower.includes('code block')) {
+        return 'FENCED_CODE_BLOCK';
+    }
+    return 'unknown';
+}
+/**
+ * Convert ExtractedDocStrings to CodeBlock SectionBlocks
+ *
+ * @param docStrings - Extracted DocStrings
+ * @returns Array of CodeBlock sections
+ */
+export function docStringsToCodeBlocks(docStrings) {
+    return docStrings.map((ds) => ({
+        type: 'code',
+        language: ds.language,
+        content: ds.content,
+    }));
+}
+//# sourceMappingURL=decision-doc.js.map

package/dist/renderable/codecs/decision-doc.js.map

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

package/dist/renderable/codecs/design-review.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @architect
+ * @architect-core
+ * @architect-pattern DesignReviewCodec
+ * @architect-status active
+ * @architect-implements DesignReviewGeneration
+ * @architect-arch-role projection
+ * @architect-arch-context renderer
+ * @architect-arch-layer application
+ * @architect-include codec-transformation
+ * @architect-uses MasterDataset, SequenceIndex, MermaidDiagramUtils
+ * @architect-convention codec-registry
+ * @architect-product-area:Generation
+ *
+ * ## DesignReviewCodec
+ *
+ * Transforms MasterDataset into a RenderableDocument containing design review
+ * artifacts: sequence diagrams, component diagrams, type definition tables,
+ * and design question templates.
+ *
+ * **Purpose:** Auto-generate design review documents from sequence annotations
+ * on Gherkin specs. Diagrams stay synchronized with spec changes.
+ *
+ * **Output Files:** `architect/design-reviews/{pattern-name}.md`
+ *
+ * ### Factory Pattern
+ *
+ * ```typescript
+ * const codec = createDesignReviewCodec({ patternName: 'SetupCommand' });
+ * const doc = codec.decode(dataset);
+ * ```
+ */
+import { z } from 'zod';
+import { MasterDatasetSchema } from '../../validation-schemas/master-dataset.js';
+import { type BaseCodecOptions } from './types/base.js';
+import { RenderableDocumentOutputSchema } from './shared-schema.js';
+/**
+ * Options for DesignReviewCodec
+ */
+export interface DesignReviewCodecOptions extends BaseCodecOptions {
+    /** Pattern name to generate the design review for (required) */
+    patternName: string;
+    /** Include the annotation convention section (default: true) */
+    includeAnnotationConvention?: boolean;
+    /** Include the component diagram (default: true) */
+    includeComponentDiagram?: boolean;
+}
+/**
+ * Create a DesignReviewCodec with the given options.
+ *
+ * @param options - Codec configuration (patternName is required)
+ * @returns Configured Zod codec that transforms MasterDataset → RenderableDocument
+ */
+export declare function createDesignReviewCodec(options: DesignReviewCodecOptions): z.ZodCodec<typeof MasterDatasetSchema, typeof RenderableDocumentOutputSchema>;
+//# sourceMappingURL=design-review.d.ts.map

package/dist/renderable/codecs/design-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-review.d.ts","sourceRoot":"","sources":["../../../src/renderable/codecs/design-review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,mBAAmB,EAIpB,MAAM,4CAA4C,CAAC;AAapD,OAAO,EAAE,KAAK,gBAAgB,EAAsC,MAAM,iBAAiB,CAAC;AAC5F,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAOpE;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IAEpB,gEAAgE;IAChE,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC,oDAAoD;IACpD,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAgBD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,CAAC,CAAC,QAAQ,CAAC,OAAO,mBAAmB,EAAE,OAAO,8BAA8B,CAAC,CAY/E"}