@libar-dev/architect 1.0.0-pre.3 → 1.0.0-pre.4

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

@@ -1,485 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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

@@ -1,55 +0,0 @@
-/**
- * @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

@@ -1 +0,0 @@
-{"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"}