@simway/spica 0.0.0-stage → 0.1.2

package/dist/contractProjector.js

@@ -0,0 +1,269 @@
+import { idFieldToEntityName } from "./admValidator.js";
+/**
+ * Projects a validated AstRoot into a visual Mermaid Domain AggregateNode Map (graph TD).
+ * Renders aggregate subgraphs, internal commands/states, entity foreign-key dependencies,
+ * and cross-aggregate domain event flow edges.
+ */
+export function projectDomainAggregateMap(model) {
+    const lines = ["graph TD"];
+    const foreignKeyEdges = [];
+    const eventFlowEdges = [];
+    const aggregateNames = new Set(model.aggregates.map((a) => a.name));
+    for (const agg of model.aggregates) {
+        const states = agg.states || [];
+        const stateStr = states.length > 0 ? states.join(" | ") : "Unspecified";
+        lines.push(`    subgraph ${agg.name} [AggregateNode: ${agg.name}]`);
+        lines.push(`        ${agg.name}_States["States: ${stateStr}"]`);
+        for (const cmd of agg.commands ?? []) {
+            lines.push(`        ${cmd.name}["CommandNode: ${cmd.name}"] --> ${agg.name}_States`);
+        }
+        lines.push("    end");
+        // Collect cross-aggregate references from entity fields (Foreign Keys)
+        for (const ent of agg.entities ?? []) {
+            for (const field of ent.fields) {
+                const targetEntity = idFieldToEntityName(field.name);
+                if (targetEntity && targetEntity !== agg.name && targetEntity !== agg.rootEntity) {
+                    const cardinality = field.isList ? "1..*" : field.required ? "1..1" : "0..1";
+                    foreignKeyEdges.push(`    ${targetEntity} -.->|"${field.name} (${cardinality})"| ${agg.name}`);
+                }
+            }
+        }
+        // Collect cross-aggregate domain event flow edges
+        for (const cmd of agg.commands ?? []) {
+            // 1. Explicit triggerEvent: e.g. "Loan.BookReturned" or "BookReturned"
+            if (cmd.triggerEvent) {
+                const parts = cmd.triggerEvent.split(".");
+                if (parts.length === 2 && aggregateNames.has(parts[0])) {
+                    eventFlowEdges.push(`    ${parts[0]} ==>|"triggers on ${parts[1]}"| ${agg.name}`);
+                }
+                else {
+                    // If triggerEvent doesn't specify source aggregate prefix, search all aggregates for matching command/emits
+                    for (const otherAgg of model.aggregates) {
+                        if (otherAgg.name === agg.name)
+                            continue;
+                        const matches = (otherAgg.commands ?? []).some((c) => c.emits === cmd.triggerEvent || `${c.name}Event` === cmd.triggerEvent);
+                        if (matches) {
+                            eventFlowEdges.push(`    ${otherAgg.name} ==>|"triggers on ${cmd.triggerEvent}"| ${agg.name}`);
+                        }
+                    }
+                }
+            }
+            // 2. Policies declaring cross-aggregate source
+            for (const policyName of cmd.policies || []) {
+                const policy = (agg.policies || []).find((p) => p.name === policyName);
+                if (!policy)
+                    continue;
+                if (policy.sourceAggregate && aggregateNames.has(policy.sourceAggregate) && policy.sourceAggregate !== agg.name) {
+                    const eventLabel = policy.sourceEvent || policy.name;
+                    eventFlowEdges.push(`    ${policy.sourceAggregate} ==>|"triggers on ${eventLabel}"| ${agg.name}`);
+                }
+                else if (policy.intentTrace || policy.description) {
+                    const text = `${policy.intentTrace || ""} ${policy.description || ""}`;
+                    // Match patterns like: "on Loan.BookReturned" or "when Loan emits ReturnBook"
+                    const match = text.match(/(?:on|when|from)\s+([A-Z][a-zA-Z0-9]+)\.([A-Z][a-zA-Z0-9]+)/);
+                    if (match && aggregateNames.has(match[1]) && match[1] !== agg.name) {
+                        eventFlowEdges.push(`    ${match[1]} ==>|"triggers on ${match[2]}"| ${agg.name}`);
+                    }
+                }
+            }
+        }
+    }
+    // Append structural foreign-key edges
+    if (foreignKeyEdges.length > 0) {
+        lines.push("");
+        const uniqueFkEdges = Array.from(new Set(foreignKeyEdges));
+        lines.push(...uniqueFkEdges);
+    }
+    // Append reactive event-flow edges
+    if (eventFlowEdges.length > 0) {
+        lines.push("");
+        const uniqueEventEdges = Array.from(new Set(eventFlowEdges));
+        lines.push(...uniqueEventEdges);
+    }
+    return lines.join("\n");
+}
+/**
+ * Projects a validated AstRoot into a formal UML Class Diagram (Mermaid classDiagram)
+ * with explicit composition (*--) and association (-->) semantics.
+ */
+export function projectClassDiagram(model) {
+    const lines = ["classDiagram"];
+    for (const agg of model.aggregates) {
+        for (const ent of agg.entities ?? []) {
+            lines.push(`    class ${ent.name} {`);
+            for (const field of ent.fields) {
+                const listMarker = field.isList ? "[]" : "";
+                lines.push(`        +${field.type}${listMarker} ${field.name}`);
+            }
+            lines.push("    }");
+            // Internal aggregate composition (rootEntity owns child entities)
+            if (ent.name !== agg.rootEntity) {
+                lines.push(`    ${agg.rootEntity} "1" *-- "0..*" ${ent.name} : contains`);
+            }
+            // Foreign entity associations
+            for (const field of ent.fields) {
+                const targetEntity = idFieldToEntityName(field.name);
+                if (targetEntity && targetEntity !== ent.name) {
+                    const cardinality = field.isList ? "\"0..*\"" : field.required ? "\"1\"" : "\"0..1\"";
+                    lines.push(`    ${ent.name} --> ${cardinality} ${targetEntity} : ${field.name}`);
+                }
+            }
+        }
+        for (const vo of agg.valueObjects || []) {
+            lines.push(`    class ${vo.name} {`);
+            lines.push("        <<ValueObjectNode>>");
+            if (vo.fields && vo.fields.length > 0) {
+                for (const field of vo.fields) {
+                    const listMarker = field.isList ? "[]" : "";
+                    lines.push(`        +${field.type}${listMarker} ${field.name}`);
+                }
+            }
+            else if (vo.values && vo.values.length > 0) {
+                for (const val of vo.values) {
+                    lines.push(`        +${val}`);
+                }
+            }
+            lines.push("    }");
+            lines.push(`    ${agg.rootEntity} ..> ${vo.name} : uses`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Projects a validated AstRoot into a formal UML State Machine Diagram (Mermaid stateDiagram-v2)
+ * for lifecycle soundness, state reachability, guard evaluation, and command triggers.
+ */
+export function projectStateMachineDiagram(model) {
+    const lines = ["stateDiagram-v2"];
+    for (const agg of model.aggregates) {
+        const states = agg.states || [];
+        if (states.length === 0)
+            continue;
+        lines.push(`    state "${agg.name} Lifecycle" as ${agg.name}Lifecycle {`);
+        // Process explicit transitions if present
+        const explicitTransitions = agg.transitions ?? [];
+        if (explicitTransitions.length > 0) {
+            for (const tr of explicitTransitions) {
+                const guard = tr.guardCondition ? ` [${tr.guardCondition}]` : "";
+                const from = tr.fromState === "" || tr.fromState === "[*]" ? "[*]" : tr.fromState;
+                lines.push(`        ${from} --> ${tr.toState} : ${tr.trigger}${guard}`);
+            }
+        }
+        else {
+            // Derive transitions deterministically from commands
+            for (const cmd of agg.commands ?? []) {
+                const isCreation = cmd.isCreation ?? (cmd.requiredState === "");
+                const policies = cmd.policies || [];
+                const guard = policies.length > 0 ? ` [${policies.join(", ")}]` : "";
+                if (isCreation && cmd.targetState) {
+                    lines.push(`        [*] --> ${cmd.targetState} : ${cmd.name}${guard}`);
+                }
+                else if (cmd.requiredState && cmd.targetState) {
+                    lines.push(`        ${cmd.requiredState} --> ${cmd.targetState} : ${cmd.name}${guard}`);
+                }
+            }
+        }
+        lines.push("    }");
+    }
+    return lines.join("\n");
+}
+/**
+ * Helper to produce a valid Mermaid identifier from arbitrary strings.
+ */
+function toMermaidId(str) {
+    const sanitized = str.replace(/[^a-zA-Z0-9]/g, "");
+    if (!sanitized)
+        return "systemObj";
+    return sanitized.charAt(0).toLowerCase() + sanitized.slice(1);
+}
+/**
+ * Projects a validated AstRoot into Simon Brown's C4 Model Level 1 (System Context Diagram)
+ * using Mermaid's native C4Context syntax with explicit integration transport protocols.
+ */
+export function projectSystemContextDiagram(model) {
+    const lines = ["C4Context"];
+    const rawDomain = model.domainName || "System";
+    const systemName = model.systemName || `${rawDomain} System`;
+    const systemId = toMermaidId(systemName);
+    const systemDesc = model.systemDescription || `Core domain platform for ${rawDomain}`;
+    lines.push(`    title System Context: ${systemName}`);
+    // Resolve Human Actors (from explicit model.actors or dynamically extracted from commands)
+    const actorMap = new Map();
+    for (const act of model.actors || []) {
+        if (/^(system|internal|cron|scheduler|timer)$/i.test(act.name))
+            continue;
+        actorMap.set(act.name, act.description || `User interacting with ${systemName}`);
+    }
+    // Extract from commands only if model.actors was not provided, ignoring internal automated processes
+    if (!model.actors || model.actors.length === 0) {
+        for (const agg of model.aggregates) {
+            for (const cmd of agg.commands ?? []) {
+                if (cmd.actor && !/^(system|internal|cron|scheduler|timer)$/i.test(cmd.actor) && !actorMap.has(cmd.actor)) {
+                    actorMap.set(cmd.actor, `ActorNode executing ${cmd.name} operations`);
+                }
+            }
+        }
+    }
+    // If still no actors, scan aggregates for human persona names (e.g. Patron, User, Customer, Member, Admin)
+    if (actorMap.size === 0) {
+        for (const agg of model.aggregates) {
+            if (/user|member|customer|patron|operator|admin|client|guest|buyer|seller|driver|passenger|patient|doctor|student|teacher/i.test(agg.name)) {
+                actorMap.set(agg.name, `Primary human persona for ${agg.name}`);
+            }
+        }
+    }
+    // Fallback if no human personas detected
+    if (actorMap.size === 0) {
+        actorMap.set("User", `Primary user interacting with ${systemName}`);
+    }
+    // Emit Person definitions
+    for (const [name, desc] of actorMap.entries()) {
+        const actId = toMermaidId(name);
+        lines.push(`    Person(${actId}, "${name}", "${desc}")`);
+    }
+    // Emit Primary System definition
+    lines.push(`    System(${systemId}, "${systemName}", "${systemDesc}")`);
+    // Emit External Systems
+    const extSystems = model.externalSystems || [];
+    for (const ext of extSystems) {
+        const extId = toMermaidId(ext.name);
+        const desc = ext.description || "External third-party service or bounded context";
+        lines.push(`    System_Ext(${extId}, "${ext.name}", "${desc}")`);
+    }
+    // Relationships: Actors -> System (with standard C4 transport technology)
+    for (const [name] of actorMap.entries()) {
+        const actId = toMermaidId(name);
+        lines.push(`    Rel(${actId}, ${systemId}, "Interacts with", "Web UI / API")`);
+    }
+    // Relationships: System -> External Systems (with parsed or derived technology badge)
+    for (const ext of extSystems) {
+        const extId = toMermaidId(ext.name);
+        const rawRel = ext.relationship || "Integrates with";
+        let label = rawRel;
+        let tech = ext.technology || "";
+        if (!tech) {
+            // Check for bracketed technology hint: "Sends pickup notices [Async/Kafka]"
+            const bracketMatch = rawRel.match(/^(.*?)\s*\[(.*?)\]$/);
+            if (bracketMatch) {
+                label = bracketMatch[1].trim();
+                tech = bracketMatch[2].trim();
+            }
+            else {
+                // Derive technology from relationship keywords
+                const lower = rawRel.toLowerCase();
+                if (/event|notify|alert|publish|async|kafka|queue|stream|webhook/i.test(lower)) {
+                    tech = "Async Event";
+                }
+                else if (/api|charge|pay|verify|gateway|http|rest/i.test(lower)) {
+                    tech = "HTTPS/REST";
+                }
+                else {
+                    tech = "Integration";
+                }
+            }
+        }
+        lines.push(`    Rel(${systemId}, ${extId}, "${label}", "${tech}")`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=contractProjector.js.map

package/dist/contractProjector.js.map

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

package/dist/dddCrewParser.d.ts

@@ -0,0 +1,11 @@
+import { AstRoot } from "./schema.js";
+export declare class DddCrewParseError extends Error {
+    readonly code = "E_DDD_CREW_PARSE_ERROR";
+    readonly line?: number;
+    constructor(message: string, line?: number);
+}
+/**
+ * Parses canonical DDD Crew Aggregate Design Canvas Markdown (v1.1) into a strictly validated AstRoot ADM AST.
+ */
+export declare function parseDddCrewMarkdown(markdown: string): AstRoot;
+//# sourceMappingURL=dddCrewParser.d.ts.map

package/dist/dddCrewParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dddCrewParser.d.ts","sourceRoot":"","sources":["../src/dddCrewParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAmK,MAAM,aAAa,CAAC;AAEvM,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,4BAA4B;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAK3C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CA0a9D"}