@chrisdudek/yg 2.5.0 → 2.5.1

package/dist/bin.js

@@ -440,7 +440,7 @@ When code anchors (\`anchors\` in an aspect entry in \`yg-node.yaml\`) are prese
 
 - [ ] 1. Read \`schemas/yg-flow.yaml\`
 - [ ] 2. Create \`flows/<name>/\` directory
-- [ ] 3. Write \`yg-flow.yaml\` \u2014 declare participants and flow-level aspects
+- [ ] 3. Write \`yg-flow.yaml\` \u2014 declare nodes (participant list) and flow-level aspects
 - [ ] 4. Write \`description.md\` with required sections: Business context, Trigger, Goal, Participants, Paths (at least Happy path), Invariants across all paths
 - [ ] 5. \`yg validate\`
 
@@ -493,7 +493,7 @@ yg drift-sync --node <path> [--recursive] | --all
 | Information specific to this node | Local node artifact (check \`yg-config.yaml artifacts\` for types) |
 | Rule that applies to many nodes | Aspect (content \`.md\` files in \`aspects/<id>/\`) |
 | Architectural invariant for a node type | Required aspect in \`yg-config.yaml node_types\` |
-| Business process participation | Flow (\`yg-flow.yaml participants\`) |
+| Business process participation | Flow (\`yg-flow.yaml nodes\`) |
 | Process-level requirement | Flow \`aspects\` + aspect directory |
 | Context shared across a domain | Parent node artifact |
 | Technology stack | Node artifact at appropriate hierarchy level |
@@ -1509,13 +1509,17 @@ async function parseFlow(flowDir, flowYamlPath) {
   if (!raw.name || typeof raw.name !== "string" || raw.name.trim() === "") {
     throw new Error(`yg-flow.yaml at ${flowYamlPath}: missing or empty 'name'`);
   }
-  const nodes = raw.nodes;
+  const nodes = raw.nodes ?? raw.participants;
   if (!Array.isArray(nodes) || nodes.length === 0) {
-    throw new Error(`yg-flow.yaml at ${flowYamlPath}: 'nodes' must be a non-empty array`);
+    throw new Error(
+      `yg-flow.yaml at ${flowYamlPath}: 'nodes' (or 'participants') must be a non-empty array`
+    );
   }
   const nodePaths = nodes.filter((n) => typeof n === "string");
   if (nodePaths.length === 0) {
-    throw new Error(`yg-flow.yaml at ${flowYamlPath}: 'nodes' must contain string node paths`);
+    throw new Error(
+      `yg-flow.yaml at ${flowYamlPath}: 'nodes' (or 'participants') must contain string node paths`
+    );
   }
   let aspects;
   if (raw.aspects !== void 0) {
@@ -1732,19 +1736,20 @@ async function scanAspectsDirectory(dirPath, aspectsRoot, aspects) {
   }
 }
 async function loadFlows(flowsDir) {
+  let entries;
   try {
-    const entries = await readdir4(flowsDir, { withFileTypes: true });
-    const flows = [];
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      const flowYamlPath = path9.join(flowsDir, entry.name, "yg-flow.yaml");
-      const flow = await parseFlow(path9.join(flowsDir, entry.name), flowYamlPath);
-      flows.push(flow);
-    }
-    return flows;
+    entries = await readdir4(flowsDir, { withFileTypes: true });
   } catch {
     return [];
   }
+  const flows = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const flowYamlPath = path9.join(flowsDir, entry.name, "yg-flow.yaml");
+    const flow = await parseFlow(path9.join(flowsDir, entry.name), flowYamlPath);
+    flows.push(flow);
+  }
+  return flows;
 }
 async function loadSchemas(schemasDir) {
   try {