arkaik 0.1.0 → 0.1.2

package/dist/io.js

@@ -6,33 +6,6 @@ var __export = (target, all) => {
 
 // src/lib/bundle-io.ts
 import { existsSync, readFileSync } from "node:fs";
-function readBundle(filePath) {
-  if (!existsSync(filePath)) throw new Error(`File not found: ${filePath}`);
-  let parsed;
-  try {
-    parsed = JSON.parse(readFileSync(filePath, "utf8"));
-  } catch (e) {
-    throw new Error(`Cannot parse JSON \u2014 ${e.message}`);
-  }
-  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-    throw new Error("Bundle must be a JSON object.");
-  }
-  return parsed;
-}
-function nodesByIdOf(bundle) {
-  const nodes = Array.isArray(bundle.nodes) ? bundle.nodes : [];
-  const map2 = /* @__PURE__ */ new Map();
-  for (const n of nodes) {
-    if (n !== null && typeof n === "object" && typeof n.id === "string") {
-      map2.set(n.id, n);
-    }
-  }
-  return map2;
-}
-
-// src/lib/journal-io.ts
-import { appendFileSync, existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
 
 // ../../node_modules/zod/v4/classic/external.js
 var external_exports = {};
@@ -14549,19 +14522,58 @@ function date4(params) {
 config(en_default());
 
 // ../schema/src/ids.ts
-var SPECIES_IDS = ["flow", "view", "data-model", "api-endpoint", "acceptance"];
+var SPECIES_IDS = ["flow", "view", "data-model", "api-endpoint", "acceptance", "decision"];
 var STATUS_IDS = [
   "idea",
+  "discovery",
   "backlog",
-  "prioritized",
   "development",
   "releasing",
   "live",
-  "archived",
-  "blocked"
+  "archived"
 ];
 var PLATFORM_IDS = ["web", "ios", "android"];
-var EDGE_TYPE_IDS = ["composes", "calls", "displays", "queries", "covers"];
+var EDGE_TYPE_IDS = ["composes", "calls", "displays", "queries", "covers", "supersedes", "generates", "impacts"];
+var VALID_EDGE_SEMANTICS = {
+  composes: [
+    ["flow", "view"],
+    ["flow", "flow"],
+    ["view", "flow"],
+    ["view", "view"]
+  ],
+  // `calls` names the initiator, which is why it runs in both directions
+  // between a view and an endpoint: view → api is the outbound/write
+  // affordance, api → view the inbound/read one a server opens itself (a
+  // webhook, an SSE channel, a push). Both project onto the View card
+  // (docs/graph-model.md § Edge Types). Consumers that walk `calls` must
+  // therefore not assume it points down into the system layer — see
+  // `buildProductUsageIndex` in ./products.ts, which restricts hops by
+  // target species for exactly this reason.
+  calls: [
+    ["view", "api-endpoint"],
+    ["flow", "api-endpoint"],
+    ["api-endpoint", "api-endpoint"],
+    ["api-endpoint", "view"]
+  ],
+  displays: [["view", "data-model"]],
+  queries: [["api-endpoint", "data-model"]],
+  covers: [
+    ["acceptance", "view"],
+    ["acceptance", "flow"]
+  ],
+  // Decision edges (cycle 2). `generates` and `impacts` are deliberately
+  // disjoint: an acceptance is *generated* by a decision, never merely
+  // impacted, so `impacts` does not admit an acceptance target
+  // (docs/superpowers/specs/2026-08-03-decisions-species-design.md §3).
+  supersedes: [["decision", "decision"]],
+  generates: [["decision", "acceptance"]],
+  impacts: [
+    ["decision", "flow"],
+    ["decision", "view"],
+    ["decision", "data-model"],
+    ["decision", "api-endpoint"]
+  ]
+};
 var VALUE_TIER_IDS = ["functional", "emotional", "life-changing", "social-impact"];
 var VALUE_IDS = [
   // functional (14)
@@ -14600,6 +14612,106 @@ var VALUE_IDS = [
   "self-transcendence"
 ];
 
+// ../schema/src/legacy-status.ts
+var LEGACY_STATUS_IDS = ["prioritized", "blocked"];
+var LEGACY_STATUS_ALIASES = {
+  prioritized: "backlog",
+  blocked: "development"
+};
+var STATUS_VOCABULARY_VERSION = 3;
+var BLOCKED_BY_MIGRATION_NOTE = "migrated from legacy blocked status";
+function normalizeStatus(value) {
+  if (STATUS_IDS.includes(value)) return value;
+  return LEGACY_STATUS_ALIASES[value];
+}
+var LEGACY_ALIAS_REMAP = { ...LEGACY_STATUS_ALIASES };
+var LEGACY_VOCABULARY_REMAP = {
+  backlog: "idea",
+  ...LEGACY_STATUS_ALIASES
+};
+function migrateNode(node, remap) {
+  let changed = false;
+  let wasBlocked = node.status === "blocked";
+  const mappedStatus = remap[node.status];
+  const status = mappedStatus ?? node.status;
+  if (mappedStatus !== void 0) changed = true;
+  let metadata = node.metadata;
+  const platformStatuses = node.metadata?.platformStatuses;
+  if (platformStatuses !== void 0) {
+    let anyMapped = false;
+    const next = {};
+    for (const [platform, value] of Object.entries(platformStatuses)) {
+      if (value === "blocked") wasBlocked = true;
+      const mapped = remap[value];
+      next[platform] = mapped ?? value;
+      if (mapped !== void 0) anyMapped = true;
+    }
+    if (anyMapped) {
+      metadata = { ...metadata, platformStatuses: next };
+      changed = true;
+    }
+  }
+  const refs = node.metadata?.refs;
+  if (Array.isArray(refs)) {
+    let anyMapped = false;
+    const nextRefs = refs.map((ref) => {
+      if (ref.status_mapped === void 0) return ref;
+      const mapped = remap[ref.status_mapped];
+      if (mapped === void 0) return ref;
+      anyMapped = true;
+      return { ...ref, status_mapped: mapped };
+    });
+    if (anyMapped) {
+      metadata = { ...metadata, refs: nextRefs };
+      changed = true;
+    }
+  }
+  if (wasBlocked && !metadata?.blocked_by) {
+    metadata = { ...metadata, blocked_by: BLOCKED_BY_MIGRATION_NOTE };
+    changed = true;
+  }
+  if (!changed) return node;
+  return { ...node, status, ...metadata !== void 0 ? { metadata } : {} };
+}
+function migrateStatusVocabulary(bundle) {
+  const current = typeof bundle.schema_version === "number" && bundle.schema_version >= STATUS_VOCABULARY_VERSION;
+  const remap = current ? LEGACY_ALIAS_REMAP : LEGACY_VOCABULARY_REMAP;
+  const nodes = bundle.nodes.map((node) => migrateNode(node, remap));
+  if (current) {
+    const untouched = nodes.every((node, i) => node === bundle.nodes[i]);
+    return untouched ? bundle : { ...bundle, nodes };
+  }
+  return { ...bundle, schema_version: STATUS_VOCABULARY_VERSION, nodes };
+}
+
+// ../schema/src/decision.ts
+var DECISION_STATUS_IDS = [
+  "proposed",
+  "approved",
+  "enacted",
+  "rejected",
+  "deprecated",
+  "superseded"
+];
+function lifecycleStatusForDecision(decisionStatus) {
+  switch (decisionStatus) {
+    case "proposed":
+      return "discovery";
+    case "approved":
+      return "backlog";
+    case "enacted":
+      return "live";
+    case "rejected":
+    case "deprecated":
+    case "superseded":
+      return "archived";
+  }
+}
+function decisionStatusOf(node) {
+  const raw = node.metadata?.decision_status;
+  return DECISION_STATUS_IDS.includes(raw) ? raw : "proposed";
+}
+
 // ../schema/src/enums.ts
 var SpeciesSchema = external_exports.enum(SPECIES_IDS).meta({
   id: "Species",
@@ -14609,6 +14721,10 @@ var StatusSchema = external_exports.enum(STATUS_IDS).meta({
   id: "Status",
   description: "Lifecycle status of a node."
 });
+var AnyStatusSchema = external_exports.enum([...STATUS_IDS, ...LEGACY_STATUS_IDS]).meta({
+  id: "AnyStatus",
+  description: "Lifecycle status as stored: the current vocabulary, or a legacy id (prioritized, blocked) accepted from pre-v3 bundles and migrated on load."
+});
 var PlatformSchema = external_exports.enum(PLATFORM_IDS).meta({
   id: "Platform",
   description: "Target platform."
@@ -14625,6 +14741,10 @@ var ValueSchema = external_exports.enum(VALUE_IDS).meta({
   id: "Value",
   description: "A Bain B2C Elements-of-Value element served by an acceptance (spec \xA73.2)."
 });
+var DecisionStatusSchema = external_exports.enum(DECISION_STATUS_IDS).meta({
+  id: "DecisionStatus",
+  description: "Decision nodes only: proposed \u2192 approved (agreed, not yet reality) \u2192 enacted (in effect); terminal: rejected, deprecated, superseded. Not a lifecycle status \u2014 the node's status field is kept in sync (proposed\u2192discovery, approved\u2192backlog, enacted\u2192live, terminals\u2192archived)."
+});
 
 // ../schema/src/id-gen.ts
 var SPECIES_PREFIXES = {
@@ -14632,7 +14752,8 @@ var SPECIES_PREFIXES = {
   view: "V-",
   "data-model": "DM-",
   "api-endpoint": "API-",
-  acceptance: "AC-"
+  acceptance: "AC-",
+  decision: "DEC-"
 };
 
 // ../schema/src/playlist.ts
@@ -14730,6 +14851,7 @@ function parseJournalLines(text) {
 var NODE_REF_FIELDS = {
   "node.updated": ["node_id"],
   "node.status_changed": ["node_id"],
+  "decision.status_changed": ["node_id"],
   "node.deleted": ["node_id"],
   "edge.added": ["source_id", "target_id"],
   "ref.added": ["node_id"],
@@ -14738,6 +14860,12 @@ var NODE_REF_FIELDS = {
   "idea.proposed": ["node_id"],
   "request.filed": ["node_id"]
 };
+function statusesAgree(last, snapshot) {
+  if (last === snapshot) return true;
+  if (typeof snapshot !== "string") return false;
+  if (last === "backlog" && snapshot === "idea") return true;
+  return (normalizeStatus(last) ?? last) === (normalizeStatus(snapshot) ?? snapshot);
+}
 function crossCheckJournal(bundle) {
   const findings = [];
   const journalRaw = bundle.journal;
@@ -14756,9 +14884,15 @@ function crossCheckJournal(bundle) {
   const nodesRaw = Array.isArray(bundle.nodes) ? bundle.nodes : [];
   const edgesRaw = Array.isArray(bundle.edges) ? bundle.edges : [];
   const snapshotNodeStatus = /* @__PURE__ */ new Map();
+  const snapshotDecisionStatus = /* @__PURE__ */ new Map();
   for (const n of nodesRaw) {
     const id = str(n?.id);
-    if (id !== void 0) snapshotNodeStatus.set(id, n.status);
+    if (id !== void 0) {
+      snapshotNodeStatus.set(id, n.status);
+      const metadata = n.metadata;
+      const decisionStatus = metadata && typeof metadata === "object" && !Array.isArray(metadata) ? metadata.decision_status : void 0;
+      snapshotDecisionStatus.set(id, decisionStatus ?? "proposed");
+    }
   }
   const snapshotEdgeIds = /* @__PURE__ */ new Set();
   for (const e of edgesRaw) {
@@ -14807,6 +14941,7 @@ function crossCheckJournal(bundle) {
   const ordered = orderEvents(valid.map((v) => v.ev));
   const created = /* @__PURE__ */ new Set();
   const lastProjectStatus = /* @__PURE__ */ new Map();
+  const lastDecisionStatus = /* @__PURE__ */ new Map();
   for (const ev of ordered) {
     if (ev.type === "node.created") {
       const nid = str(ev.node_id);
@@ -14817,6 +14952,12 @@ function crossCheckJournal(bundle) {
         const to = str(ev.to);
         if (to !== void 0) lastProjectStatus.set(nid, to);
       }
+    } else if (ev.type === "decision.status_changed") {
+      const nid = str(ev.node_id);
+      if (nid) {
+        const to = str(ev.to);
+        if (to !== void 0) lastDecisionStatus.set(nid, to);
+      }
     }
   }
   for (const { ev, index } of valid) {
@@ -14834,6 +14975,19 @@ function crossCheckJournal(bundle) {
         }
       }
     }
+    if (ev.type === "deliverable.shipped" && Array.isArray(ev.node_ids)) {
+      ev.node_ids.forEach((raw, i) => {
+        const ref = str(raw);
+        if (ref !== void 0 && !everNodes.has(ref)) {
+          findings.push({
+            path: `journal[${index}].node_ids[${i}]`,
+            rule: "journal-dangling-node-ref",
+            message: `journal[${index}] (${ev.type}): references node "${ref}" that never existed in the snapshot or journal.`,
+            severity: "error"
+          });
+        }
+      });
+    }
     if (ev.type === "edge.removed") {
       const ref = str(ev.edge_id);
       if (ref !== void 0 && !everEdges.has(ref)) {
@@ -14856,7 +15010,7 @@ function crossCheckJournal(bundle) {
       });
     }
     const last = lastProjectStatus.get(nodeId);
-    if (last !== void 0 && last !== status) {
+    if (last !== void 0 && !statusesAgree(last, status)) {
       findings.push({
         path: "journal",
         rule: "journal-status-mismatch",
@@ -14865,6 +15019,18 @@ function crossCheckJournal(bundle) {
       });
     }
   }
+  for (const [nodeId, last] of lastDecisionStatus) {
+    if (!snapshotDecisionStatus.has(nodeId)) continue;
+    const current = snapshotDecisionStatus.get(nodeId) ?? "proposed";
+    if (last !== current) {
+      findings.push({
+        path: "journal",
+        rule: "journal-decision-status-mismatch",
+        message: `Node "${nodeId}": journal's last decision.status_changed.to "${last}" disagrees with snapshot decision_status "${String(current)}".`,
+        severity: "error"
+      });
+    }
+  }
   return findings;
 }
 
@@ -14895,10 +15061,19 @@ var NodeStatusChangedEventSchema = external_exports.object({
   ...envelope,
   type: external_exports.literal("node.status_changed"),
   node_id: external_exports.string(),
-  from: StatusSchema,
-  to: StatusSchema,
+  // History is never rewritten (docs/spec/journal.md): pre-v3 events keep
+  // their legacy status ids, so strict per-type validation must accept them.
+  from: AnyStatusSchema,
+  to: AnyStatusSchema,
   platform: PlatformSchema.optional()
 }).catchall(external_exports.unknown());
+var DecisionStatusChangedEventSchema = external_exports.object({
+  ...envelope,
+  type: external_exports.literal("decision.status_changed"),
+  node_id: external_exports.string(),
+  from: DecisionStatusSchema,
+  to: DecisionStatusSchema
+}).catchall(external_exports.unknown());
 var NodeDeletedEventSchema = external_exports.object({ ...envelope, type: external_exports.literal("node.deleted"), node_id: external_exports.string() }).catchall(external_exports.unknown());
 var EdgeAddedEventSchema = external_exports.object({
   ...envelope,
@@ -14916,6 +15091,16 @@ var ReleaseTaggedEventSchema = external_exports.object({
   notes: external_exports.string().optional(),
   platform: PlatformSchema.optional()
 }).catchall(external_exports.unknown());
+var DeliverableShippedEventSchema = external_exports.object({
+  ...envelope,
+  type: external_exports.literal("deliverable.shipped"),
+  deliverable_id: external_exports.string(),
+  title: external_exports.string(),
+  summary: external_exports.string().optional(),
+  url: external_exports.string().optional(),
+  node_ids: external_exports.array(external_exports.string()).optional(),
+  platform: PlatformSchema.optional()
+}).catchall(external_exports.unknown());
 var IdeaProposedEventSchema = external_exports.object({
   ...envelope,
   type: external_exports.literal("idea.proposed"),
@@ -14953,10 +15138,12 @@ var KnownJournalEventSchema = external_exports.union([
   NodeCreatedEventSchema,
   NodeUpdatedEventSchema,
   NodeStatusChangedEventSchema,
+  DecisionStatusChangedEventSchema,
   NodeDeletedEventSchema,
   EdgeAddedEventSchema,
   EdgeRemovedEventSchema,
   ReleaseTaggedEventSchema,
+  DeliverableShippedEventSchema,
   IdeaProposedEventSchema,
   RequestFiledEventSchema,
   RefAddedEventSchema,
@@ -14967,7 +15154,8 @@ var KnownJournalEventSchema = external_exports.union([
 // ../schema/src/bundle.ts
 var PlatformStatusMapSchema = external_exports.partialRecord(
   PlatformSchema,
-  StatusSchema
+  // legacy-tolerant: migrateStatusVocabulary normalizes on load
+  AnyStatusSchema
 ).meta({ id: "PlatformStatusMap", description: "Per-platform status overrides for view nodes." });
 var PlatformNotesMapSchema = external_exports.partialRecord(
   PlatformSchema,
@@ -14990,7 +15178,8 @@ var RefSchema = external_exports.object({
   external_status: external_exports.string().optional().meta({
     description: 'Mirrored external state, verbatim (e.g. "open", "merged", "In Progress").'
   }),
-  status_mapped: StatusSchema.optional().meta({
+  // legacy-tolerant: migrateStatusVocabulary normalizes on load
+  status_mapped: AnyStatusSchema.optional().meta({
     description: "Optional mapping of external_status into the arkaik lifecycle. Advisory display data \u2014 never mutates node.status."
   }),
   platform: PlatformSchema.optional().meta({ description: "Optional scoping to one platform variant." }),
@@ -14998,6 +15187,9 @@ var RefSchema = external_exports.object({
 }).meta({ id: "Ref", description: "A typed external reference on a node (docs/spec/bundle-format.md \xA7 References)." });
 var NodeMetadataSchema = external_exports.object({
   stage: external_exports.string().optional(),
+  blocked_by: external_exports.string().optional().meta({
+    description: "Non-empty = blocked at the current status. A node id (rendered as a link) or free text naming the dependency."
+  }),
   playlist: FlowPlaylistSchema.optional(),
   platformNotes: PlatformNotesMapSchema.optional(),
   platformStatuses: PlatformStatusMapSchema.optional(),
@@ -15008,6 +15200,21 @@ var NodeMetadataSchema = external_exports.object({
   }),
   values: external_exports.array(ValueSchema).optional().meta({
     description: "Acceptance nodes only: 1..n Bain value elements served (the Why)."
+  }),
+  product: external_exports.string().optional().meta({
+    description: "Product membership (docs/spec/bundle-format.md \xA7 Products); flow, view, and acceptance only."
+  }),
+  decision_status: DecisionStatusSchema.optional().meta({
+    description: "Decision nodes only: proposed | approved | enacted | rejected | deprecated | superseded. The node's lifecycle status is kept in sync (spec \xA72)."
+  }),
+  context: external_exports.string().optional().meta({
+    description: "Decision nodes only: Context \u2014 the Why (markdown)."
+  }),
+  consequences: external_exports.string().optional().meta({
+    description: "Decision nodes only: Consequences \u2014 the How (markdown)."
+  }),
+  decided_at: external_exports.string().optional().meta({
+    description: "Decision nodes only: ISO 8601 date the decision was made."
   })
 }).catchall(external_exports.unknown()).meta({ id: "NodeMetadata", description: "Optional metadata for a node." });
 var NodeSchema = external_exports.object({
@@ -15016,7 +15223,8 @@ var NodeSchema = external_exports.object({
   species: SpeciesSchema,
   title: external_exports.string().meta({ description: "Human-readable node title." }),
   description: external_exports.string().optional().meta({ description: "Optional description of the node's purpose." }),
-  status: StatusSchema,
+  // legacy-tolerant: migrateStatusVocabulary normalizes on load
+  status: AnyStatusSchema,
   platforms: external_exports.array(PlatformSchema).meta({ description: "One or more target platforms." }),
   metadata: NodeMetadataSchema.optional()
 }).meta({ id: "Node" });
@@ -15028,6 +15236,18 @@ var EdgeSchema = external_exports.object({
   edge_type: EdgeTypeSchema,
   metadata: external_exports.record(external_exports.string(), external_exports.unknown()).optional().meta({ description: "Optional edge metadata." })
 }).meta({ id: "Edge" });
+var MapDisplayOptionsSchema = external_exports.object({
+  images: external_exports.boolean().optional().meta({ description: "Screenshot (or cover) art on view cards." }),
+  flow_platforms: external_exports.string().optional().meta({
+    description: "A flow card's platform delivery: rings (default) | bars."
+  }),
+  view_platforms: external_exports.string().optional().meta({
+    description: "A view card's platform availability: chips (default) | rows."
+  }),
+  minimap_color: external_exports.string().optional().meta({
+    description: "What a minimap node's fill encodes: status (default) | species."
+  })
+}).catchall(external_exports.unknown()).meta({ id: "MapDisplayOptions", description: "How a map draws its cards (docs/spec/maps.md \xA7 Display Options)." });
 var MapDefinitionSchema = external_exports.object({
   id: external_exports.string().meta({
     description: "Kebab-case, unique within the project; built-in ids (journey, system) are reserved."
@@ -15046,13 +15266,32 @@ var MapDefinitionSchema = external_exports.object({
   root_node_id: external_exports.string().optional().meta({
     description: "Scope anchor: the subgraph is the undirected neighborhood reachable from this node."
   }),
+  product: external_exports.string().optional().meta({ description: "Product scope; absent = every product." }),
   depth: external_exports.number().optional().meta({ description: "Traversal bound from the root; absent = unbounded." }),
-  layout: external_exports.object({ direction: external_exports.string().optional() }).catchall(external_exports.unknown()).optional().meta({ description: "Renderer layout hints (e.g. direction: DOWN | RIGHT)." })
+  layout: external_exports.object({ direction: external_exports.string().optional() }).catchall(external_exports.unknown()).optional().meta({ description: "Renderer layout hints (e.g. direction: DOWN | RIGHT)." }),
+  display: MapDisplayOptionsSchema.optional().meta({
+    description: "Card rendering; the human twin is project.metadata.map_display[id]."
+  })
 }).catchall(external_exports.unknown()).meta({ id: "MapDefinition", description: "A stored map definition (docs/spec/maps.md \xA7 MapDefinition)." });
+var ProductDefinitionSchema = external_exports.object({
+  id: external_exports.string().meta({ description: "Kebab-case, unique within the project." }),
+  title: external_exports.string().meta({ description: "Display title." }),
+  description: external_exports.string().optional().meta({ description: "What this product is." }),
+  platforms: external_exports.array(PlatformSchema).meta({
+    description: "The platforms this product can ship on; empty means availability is not tracked."
+  }),
+  root_node_id: external_exports.string().optional().meta({ description: "This product's journey anchor." })
+}).catchall(external_exports.unknown()).meta({ id: "ProductDefinition", description: "A product definition (docs/spec/bundle-format.md \xA7 Products)." });
 var ProjectMetadataSchema = external_exports.object({
   view_card_variant: external_exports.enum(["compact", "large"]).optional(),
   maps: external_exports.array(MapDefinitionSchema).optional().meta({
     description: "Stored map definitions (docs/spec/maps.md \xA7 Storage) \u2014 additive; unknown fields preserved."
+  }),
+  map_display: external_exports.record(external_exports.string(), MapDisplayOptionsSchema).optional().meta({
+    description: "Per-map display overrides keyed by map id (docs/spec/maps.md \xA7 Display Options) \u2014 the only path open to the built-in maps."
+  }),
+  products: external_exports.array(ProductDefinitionSchema).optional().meta({
+    description: "Product definitions (docs/spec/bundle-format.md \xA7 Products) \u2014 additive; unknown fields preserved."
   })
 }).catchall(external_exports.unknown()).meta({ id: "ProjectMetadata", description: "Optional project-level UI settings." });
 var ProjectSchema = external_exports.object({
@@ -15089,11 +15328,31 @@ var ProjectBundleSchema = external_exports.object({
 });
 
 // ../schema/src/maps.ts
+var MAP_FLOW_PLATFORMS_MODES = ["rings", "bars"];
+var MAP_VIEW_PLATFORMS_MODES = ["chips", "rows"];
+var MAP_MINIMAP_COLOR_MODES = ["status", "species"];
 var BUILT_IN_MAP_IDS = ["journey", "system"];
 function isBuiltInMapId(id) {
   return BUILT_IN_MAP_IDS.includes(id);
 }
 
+// ../schema/src/products.ts
+var PRODUCT_MEMBERSHIP_SPECIES = ["flow", "view", "acceptance"];
+function resolveProducts(project) {
+  const stored = project?.metadata?.products;
+  if (!Array.isArray(stored)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const products = [];
+  for (const entry of stored) {
+    if (typeof entry !== "object" || entry === null || Array.isArray(entry)) continue;
+    const candidate = entry;
+    if (typeof candidate.id !== "string" || candidate.id.trim() === "" || seen.has(candidate.id)) continue;
+    seen.add(candidate.id);
+    products.push(candidate);
+  }
+  return products;
+}
+
 // ../schema/src/validate.ts
 var VALID_STAGES = ["beta", "monitoring", "deprecated"];
 var VALID_VIEW_CARD_VARIANTS = ["compact", "large"];
@@ -15105,25 +15364,6 @@ function estimateDataUriBytes(dataUri) {
   const padding = payload.endsWith("==") ? 2 : payload.endsWith("=") ? 1 : 0;
   return Math.floor(payload.length * 3 / 4) - padding;
 }
-var VALID_EDGE_SEMANTICS = {
-  composes: [
-    ["flow", "view"],
-    ["flow", "flow"],
-    ["view", "flow"],
-    ["view", "view"]
-  ],
-  calls: [
-    ["view", "api-endpoint"],
-    ["flow", "api-endpoint"],
-    ["api-endpoint", "api-endpoint"]
-  ],
-  displays: [["view", "data-model"]],
-  queries: [["api-endpoint", "data-model"]],
-  covers: [
-    ["acceptance", "view"],
-    ["acceptance", "flow"]
-  ]
-};
 function isIsoDate(value) {
   return typeof value === "string" && !Number.isNaN(Date.parse(value));
 }
@@ -15219,7 +15459,9 @@ function validateBundle(input) {
     }
     const platforms = node.platforms;
     if (!platforms || platforms.length === 0) {
-      error51(`${base}.platforms`, "platforms-non-empty", `Node ${nodeId}: platforms array is empty or missing`);
+      if (species !== "decision") {
+        error51(`${base}.platforms`, "platforms-non-empty", `Node ${nodeId}: platforms array is empty or missing`);
+      }
     } else {
       for (const p of platforms) {
         if (!PLATFORM_IDS.includes(p)) {
@@ -15341,6 +15583,25 @@ function validateBundle(input) {
         }
       });
     }
+    const decisionStatus = md.decision_status;
+    if (decisionStatus !== void 0 && species !== "decision") {
+      warn(
+        `${base}.metadata.decision_status`,
+        "decision-status-wrong-species",
+        `decision_status is meaningful on decision nodes only; "${nodeId}" is a ${species}.`
+      );
+    }
+    if (species === "decision") {
+      const effective = decisionStatusOf({ metadata: node.metadata });
+      const expected = lifecycleStatusForDecision(effective);
+      if (node.status !== expected) {
+        warn(
+          `${base}.status`,
+          "decision-lifecycle-mismatch",
+          `Decision "${nodeId}" is ${effective}, whose lifecycle status should be "${expected}", but status is "${node.status}" (spec \xA72).`
+        );
+      }
+    }
     if (species === "flow") {
       const playlist = md.playlist;
       if (!node.metadata || !playlist || !playlist.entries) {
@@ -15358,6 +15619,38 @@ function validateBundle(input) {
       `project.root_node_id "${rootNodeId}" does not reference an existing node`
     );
   }
+  const checkMapDisplay = (display, path, subject) => {
+    if (typeof display !== "object" || display === null || Array.isArray(display)) return;
+    const options = display;
+    const modes = [
+      ["flow_platforms", MAP_FLOW_PLATFORMS_MODES],
+      ["view_platforms", MAP_VIEW_PLATFORMS_MODES],
+      ["minimap_color", MAP_MINIMAP_COLOR_MODES]
+    ];
+    for (const [key, allowed] of modes) {
+      const value = options[key];
+      if (value !== void 0 && (typeof value !== "string" || !allowed.includes(value))) {
+        warn(
+          `${path}.${key}`,
+          "map-unknown-display",
+          `${subject} sets ${key} to "${String(value)}"; expected one of ${allowed.join(", ")} (renderers fall back to the default)`
+        );
+      }
+    }
+    if (options.images !== void 0 && typeof options.images !== "boolean") {
+      warn(
+        `${path}.images`,
+        "map-unknown-display",
+        `${subject} sets images to a non-boolean value (renderers fall back to the default)`
+      );
+    }
+  };
+  const mapDisplayOverrides = projectMetadata?.map_display;
+  if (typeof mapDisplayOverrides === "object" && mapDisplayOverrides !== null && !Array.isArray(mapDisplayOverrides)) {
+    for (const [mapId, display] of Object.entries(mapDisplayOverrides)) {
+      checkMapDisplay(display, `project.metadata.map_display.${mapId}`, `Map "${mapId}"`);
+    }
+  }
   const storedMaps = projectMetadata?.maps;
   if (Array.isArray(storedMaps)) {
     const seenMapIds = /* @__PURE__ */ new Set();
@@ -15405,8 +15698,122 @@ function validateBundle(input) {
           }
         });
       }
+      checkMapDisplay(map2.display, `${path}.display`, `Map "${mapId ?? index}"`);
     });
   }
+  const storedProducts = projectMetadata?.products;
+  const declaredProductIds = /* @__PURE__ */ new Set();
+  if (Array.isArray(storedProducts)) {
+    const seenProductIds = /* @__PURE__ */ new Set();
+    storedProducts.forEach((definition, index) => {
+      if (typeof definition !== "object" || definition === null || Array.isArray(definition)) return;
+      const product = definition;
+      const path = `project.metadata.products[${index}]`;
+      const productId = typeof product.id === "string" ? product.id : void 0;
+      if (productId === void 0) return;
+      if (seenProductIds.has(productId)) {
+        warn(`${path}.id`, "product-duplicate-id", `Duplicate product id "${productId}" \u2014 the first wins`);
+      } else {
+        seenProductIds.add(productId);
+        if (productId.trim() !== "") declaredProductIds.add(productId);
+      }
+      if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(productId)) {
+        warn(`${path}.id`, "product-invalid-id", `Product id "${productId}" is not kebab-case`);
+      }
+    });
+  }
+  const hasProducts = declaredProductIds.size > 0;
+  const anchorsByAcceptance = /* @__PURE__ */ new Map();
+  for (const edge of edges) {
+    if (edge.edge_type !== "covers") continue;
+    const source = typeof edge.source_id === "string" ? edge.source_id : void 0;
+    const target = typeof edge.target_id === "string" ? edge.target_id : void 0;
+    if (source === void 0 || target === void 0) continue;
+    const list = anchorsByAcceptance.get(source) ?? [];
+    list.push(target);
+    anchorsByAcceptance.set(source, list);
+  }
+  const menuByProduct = /* @__PURE__ */ new Map();
+  if (hasProducts) {
+    for (const definition of resolveProducts({ metadata: projectMetadata })) {
+      menuByProduct.set(
+        definition.id,
+        new Set(Array.isArray(definition.platforms) ? definition.platforms : [])
+      );
+    }
+  }
+  const productByNodeId = /* @__PURE__ */ new Map();
+  const indexByNodeId = /* @__PURE__ */ new Map();
+  nodes.forEach((node, index) => {
+    const nodeId = typeof node.id === "string" ? node.id : `#${index}`;
+    const species = node.species;
+    const base = `nodes[${index}]`;
+    indexByNodeId.set(nodeId, index);
+    const metadata = node.metadata ?? {};
+    const membership = typeof metadata.product === "string" ? metadata.product : void 0;
+    const storesMembership = species !== void 0 && PRODUCT_MEMBERSHIP_SPECIES.includes(species);
+    if (membership !== void 0 && !storesMembership) {
+      const detail = SPECIES_IDS.includes(species) ? `${species} membership is derived from consumers and must not be stored` : "metadata.product is only meaningful on flow, view, and acceptance nodes";
+      warn(`${base}.metadata.product`, "product-membership-wrong-species", `Node ${nodeId}: ${detail}`);
+      return;
+    }
+    if (!storesMembership) return;
+    if (membership === void 0) {
+      if (!hasProducts) return;
+      if (species === "acceptance") {
+        if (!anchorsByAcceptance.has(nodeId)) {
+          warn(
+            `${base}.metadata.product`,
+            "acceptance-product-unassigned",
+            `Acceptance ${nodeId} covers nothing and names no product \u2014 it will show only under "All products"`
+          );
+        }
+      } else {
+        warn(
+          `${base}.metadata.product`,
+          "unassigned-membership",
+          `Node ${nodeId}: no product membership \u2014 it will show only under "All products"`
+        );
+      }
+      return;
+    }
+    productByNodeId.set(nodeId, membership);
+    if (!declaredProductIds.has(membership)) {
+      warn(
+        `${base}.metadata.product`,
+        "product-unknown-reference",
+        `Node ${nodeId}: product "${membership}" is not declared on the project`
+      );
+      return;
+    }
+    const menu = menuByProduct.get(membership);
+    const nodePlatforms = Array.isArray(node.platforms) ? node.platforms : [];
+    if (menu) {
+      for (const platform of nodePlatforms) {
+        if (typeof platform === "string" && !menu.has(platform)) {
+          warn(
+            `${base}.platforms`,
+            "product-platform-not-in-menu",
+            `Node ${nodeId}: platform "${platform}" is not in product "${membership}"'s menu`
+          );
+        }
+      }
+    }
+  });
+  if (hasProducts) {
+    for (const [acceptanceId, anchors] of anchorsByAcceptance) {
+      const acceptanceIndex = indexByNodeId.get(acceptanceId);
+      if (acceptanceIndex === void 0) continue;
+      const spanned = new Set(anchors.map((id) => productByNodeId.get(id)).filter((id) => Boolean(id)));
+      if (spanned.size > 1) {
+        warn(
+          `nodes[${acceptanceIndex}].metadata.product`,
+          "acceptance-covers-span-products",
+          `Acceptance ${acceptanceId} covers anchors in ${[...spanned].sort().join(" and ")} \u2014 statuses may conflate products`
+        );
+      }
+    }
+  }
   const edgeIds = /* @__PURE__ */ new Set();
   const edgeSignatures = /* @__PURE__ */ new Set();
   const composesSet = /* @__PURE__ */ new Set();
@@ -15563,7 +15970,36 @@ function validateBundle(input) {
 var ENCODING = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
 var ENCODING_LEN = ENCODING.length;
 
+// src/lib/bundle-io.ts
+function readBundle(filePath) {
+  if (!existsSync(filePath)) throw new Error(`File not found: ${filePath}`);
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync(filePath, "utf8"));
+  } catch (e) {
+    throw new Error(`Cannot parse JSON \u2014 ${e.message}`);
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new Error("Bundle must be a JSON object.");
+  }
+  const record2 = parsed;
+  if (!Array.isArray(record2.nodes)) return record2;
+  return migrateStatusVocabulary(record2);
+}
+function nodesByIdOf(bundle) {
+  const nodes = Array.isArray(bundle.nodes) ? bundle.nodes : [];
+  const map2 = /* @__PURE__ */ new Map();
+  for (const n of nodes) {
+    if (n !== null && typeof n === "object" && typeof n.id === "string") {
+      map2.set(n.id, n);
+    }
+  }
+  return map2;
+}
+
 // src/lib/journal-io.ts
+import { appendFileSync, existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
 var JOURNAL_SIDECAR = "journal.jsonl";
 function journalPathFor(bundlePath) {
   return join(dirname(bundlePath), JOURNAL_SIDECAR);