@ansible-flow/core 0.85.0 → 0.87.0

package/dist/chunks/{chunk-7GLSXIZ3.js → chunk-W2CSOAIB.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-TH6ICGA5.js";
 import {
   optionA
-} from "./chunk-CXVJWFGT.js";
+} from "./chunk-2MJKBPGG.js";
 import {
   resolvePattern
 } from "./chunk-LPBLGBDT.js";
@@ -280,4 +280,4 @@ export {
   simulateRun,
   simulateScenario
 };
-//# sourceMappingURL=chunk-7GLSXIZ3.js.map
+//# sourceMappingURL=chunk-W2CSOAIB.js.map

package/dist/chunks/{chunk-UXIXXEIW.js → chunk-WSARMPYU.js}

@@ -1,6 +1,6 @@
 import {
   CHECKSUM_PREFIX
-} from "./chunk-CXVJWFGT.js";
+} from "./chunk-2MJKBPGG.js";
 import {
   checksum
 } from "./chunk-BAZIS67B.js";
@@ -22,4 +22,4 @@ export {
   GENERATED_MARK,
   generatedState
 };
-//# sourceMappingURL=chunk-UXIXXEIW.js.map
+//# sourceMappingURL=chunk-WSARMPYU.js.map

package/dist/engine/bypass.js

@@ -1,7 +1,7 @@
 import {
   withoutDisabled
-} from "../chunks/chunk-ZAYNYPCX.js";
-import "../chunks/chunk-T5UB4MBB.js";
+} from "../chunks/chunk-ARA3VJR2.js";
+import "../chunks/chunk-TOTSB4HG.js";
 import "../chunks/chunk-SN7X6FYV.js";
 import "../chunks/chunk-24G5UVEF.js";
 import "../chunks/chunk-CORZL72E.js";
@@ -11,6 +11,7 @@ import "../chunks/chunk-GK3SD3WE.js";
 import "../chunks/chunk-H6ARLMMI.js";
 import "../chunks/chunk-TG3C3GIL.js";
 import "../chunks/chunk-WISXIO3I.js";
+import "../chunks/chunk-FIKPXL6E.js";
 import "../chunks/chunk-WG7O3OBV.js";
 import "../chunks/chunk-NUGJSYSP.js";
 import "../chunks/chunk-XRGZNPPO.js";
@@ -23,6 +24,7 @@ import "../chunks/chunk-HFHXHOBC.js";
 import "../chunks/chunk-RKLF3DLT.js";
 import "../chunks/chunk-GTHXWNCC.js";
 import "../chunks/chunk-OEQXGULI.js";
+import "../chunks/chunk-T6SZLRDM.js";
 import "../chunks/chunk-BVEW6MKL.js";
 import "../chunks/chunk-BUPWGYNF.js";
 import "../chunks/chunk-WKETMTKT.js";

package/dist/engine/engines.js

@@ -1,15 +1,15 @@
 import {
   engineFor
-} from "../chunks/chunk-J7KCGVHU.js";
-import "../chunks/chunk-CXVJWFGT.js";
+} from "../chunks/chunk-HPRG2672.js";
+import "../chunks/chunk-2MJKBPGG.js";
 import "../chunks/chunk-OEEHAY5X.js";
 import "../chunks/chunk-LPBLGBDT.js";
 import "../chunks/chunk-6MLYGFT6.js";
-import "../chunks/chunk-ZAYNYPCX.js";
+import "../chunks/chunk-ARA3VJR2.js";
 import "../chunks/chunk-56VTJ6YF.js";
 import "../chunks/chunk-BAZIS67B.js";
 import "../chunks/chunk-X3DEH47B.js";
-import "../chunks/chunk-T5UB4MBB.js";
+import "../chunks/chunk-TOTSB4HG.js";
 import "../chunks/chunk-SN7X6FYV.js";
 import "../chunks/chunk-24G5UVEF.js";
 import "../chunks/chunk-CORZL72E.js";
@@ -20,6 +20,7 @@ import "../chunks/chunk-GK3SD3WE.js";
 import "../chunks/chunk-H6ARLMMI.js";
 import "../chunks/chunk-TG3C3GIL.js";
 import "../chunks/chunk-WISXIO3I.js";
+import "../chunks/chunk-FIKPXL6E.js";
 import "../chunks/chunk-WG7O3OBV.js";
 import "../chunks/chunk-NUGJSYSP.js";
 import "../chunks/chunk-XRGZNPPO.js";
@@ -32,6 +33,7 @@ import "../chunks/chunk-HFHXHOBC.js";
 import "../chunks/chunk-RKLF3DLT.js";
 import "../chunks/chunk-GTHXWNCC.js";
 import "../chunks/chunk-OEQXGULI.js";
+import "../chunks/chunk-T6SZLRDM.js";
 import "../chunks/chunk-AJRIS5VY.js";
 import "../chunks/chunk-GQ2W4RTY.js";
 import "../chunks/chunk-BVEW6MKL.js";

package/dist/engine/files.js

@@ -1,16 +1,16 @@
 import {
   GENERATED_MARK,
   generatedState
-} from "../chunks/chunk-UXIXXEIW.js";
-import "../chunks/chunk-CXVJWFGT.js";
+} from "../chunks/chunk-WSARMPYU.js";
+import "../chunks/chunk-2MJKBPGG.js";
 import "../chunks/chunk-OEEHAY5X.js";
 import "../chunks/chunk-LPBLGBDT.js";
 import "../chunks/chunk-6MLYGFT6.js";
-import "../chunks/chunk-ZAYNYPCX.js";
+import "../chunks/chunk-ARA3VJR2.js";
 import "../chunks/chunk-56VTJ6YF.js";
 import "../chunks/chunk-BAZIS67B.js";
 import "../chunks/chunk-X3DEH47B.js";
-import "../chunks/chunk-T5UB4MBB.js";
+import "../chunks/chunk-TOTSB4HG.js";
 import "../chunks/chunk-SN7X6FYV.js";
 import "../chunks/chunk-24G5UVEF.js";
 import "../chunks/chunk-CORZL72E.js";
@@ -21,6 +21,7 @@ import "../chunks/chunk-GK3SD3WE.js";
 import "../chunks/chunk-H6ARLMMI.js";
 import "../chunks/chunk-TG3C3GIL.js";
 import "../chunks/chunk-WISXIO3I.js";
+import "../chunks/chunk-FIKPXL6E.js";
 import "../chunks/chunk-WG7O3OBV.js";
 import "../chunks/chunk-NUGJSYSP.js";
 import "../chunks/chunk-XRGZNPPO.js";
@@ -33,6 +34,7 @@ import "../chunks/chunk-HFHXHOBC.js";
 import "../chunks/chunk-RKLF3DLT.js";
 import "../chunks/chunk-GTHXWNCC.js";
 import "../chunks/chunk-OEQXGULI.js";
+import "../chunks/chunk-T6SZLRDM.js";
 import "../chunks/chunk-AJRIS5VY.js";
 import "../chunks/chunk-GQ2W4RTY.js";
 import "../chunks/chunk-BVEW6MKL.js";

package/dist/engine/optionA.js

@@ -1,15 +1,15 @@
 import {
   CHECKSUM_PREFIX,
   optionA
-} from "../chunks/chunk-CXVJWFGT.js";
+} from "../chunks/chunk-2MJKBPGG.js";
 import "../chunks/chunk-OEEHAY5X.js";
 import "../chunks/chunk-LPBLGBDT.js";
 import "../chunks/chunk-6MLYGFT6.js";
-import "../chunks/chunk-ZAYNYPCX.js";
+import "../chunks/chunk-ARA3VJR2.js";
 import "../chunks/chunk-56VTJ6YF.js";
 import "../chunks/chunk-BAZIS67B.js";
 import "../chunks/chunk-X3DEH47B.js";
-import "../chunks/chunk-T5UB4MBB.js";
+import "../chunks/chunk-TOTSB4HG.js";
 import "../chunks/chunk-SN7X6FYV.js";
 import "../chunks/chunk-24G5UVEF.js";
 import "../chunks/chunk-CORZL72E.js";
@@ -20,6 +20,7 @@ import "../chunks/chunk-GK3SD3WE.js";
 import "../chunks/chunk-H6ARLMMI.js";
 import "../chunks/chunk-TG3C3GIL.js";
 import "../chunks/chunk-WISXIO3I.js";
+import "../chunks/chunk-FIKPXL6E.js";
 import "../chunks/chunk-WG7O3OBV.js";
 import "../chunks/chunk-NUGJSYSP.js";
 import "../chunks/chunk-XRGZNPPO.js";
@@ -32,6 +33,7 @@ import "../chunks/chunk-HFHXHOBC.js";
 import "../chunks/chunk-RKLF3DLT.js";
 import "../chunks/chunk-GTHXWNCC.js";
 import "../chunks/chunk-OEQXGULI.js";
+import "../chunks/chunk-T6SZLRDM.js";
 import "../chunks/chunk-AJRIS5VY.js";
 import "../chunks/chunk-GQ2W4RTY.js";
 import "../chunks/chunk-BVEW6MKL.js";

package/dist/engine/partial.js

@@ -1,6 +1,6 @@
 import {
   planCommand
-} from "../chunks/chunk-T5UB4MBB.js";
+} from "../chunks/chunk-TOTSB4HG.js";
 import "../chunks/chunk-SN7X6FYV.js";
 import "../chunks/chunk-24G5UVEF.js";
 import "../chunks/chunk-CORZL72E.js";
@@ -12,6 +12,7 @@ import "../chunks/chunk-GK3SD3WE.js";
 import "../chunks/chunk-H6ARLMMI.js";
 import "../chunks/chunk-TG3C3GIL.js";
 import "../chunks/chunk-WISXIO3I.js";
+import "../chunks/chunk-FIKPXL6E.js";
 import {
   CONTINUES_ON
 } from "../chunks/chunk-WG7O3OBV.js";
@@ -28,6 +29,7 @@ import "../chunks/chunk-HFHXHOBC.js";
 import "../chunks/chunk-RKLF3DLT.js";
 import "../chunks/chunk-GTHXWNCC.js";
 import "../chunks/chunk-OEQXGULI.js";
+import "../chunks/chunk-T6SZLRDM.js";
 import "../chunks/chunk-BVEW6MKL.js";
 import "../chunks/chunk-BUPWGYNF.js";
 import "../chunks/chunk-WKETMTKT.js";

package/dist/engine/partial.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../../../src/core/engine/partial.ts"],
   "sourcesContent": ["// AFD-244: the flow a partial run executes. \"Run from Here\" starts the hosts at a top-level step\n// instead of the flow's first one; \"Run This Step\" runs that step alone. The flow is trimmed the\n// way Delete trims it (no healing: the steps before are not passed through, they are not there):\n// the start node is wired to the chosen step and the steps the run does not reach are taken out.\n// A step that read an output of a step taken out would find no value, so it runs as its TODO\n// stub, and the run says which steps those are. Skeleton runs only (product-owner decision): a\n// real run on part of a flow could act on data that was never made.\nimport { parse, stringify } from 'yaml';\nimport { type FlowCommand, planCommand } from '../flow/commands';\nimport { CONTINUES_ON } from '../flow/heal';\nimport { createIdFactory } from '../flow/ids';\nimport { buildModel, ROOT } from '../flow/model';\nimport type { FlowDocument, FlowNode, Ulid } from '../flow/types';\nimport { descendantIds } from '../flow/walk';\n\nexport interface PartialRun {\n  /** The step the hosts start at. */\n  node: Ulid;\n  /** Run that step alone. */\n  only: boolean;\n}\n\nexport interface PartialFlow {\n  doc: FlowDocument;\n  /** How many top-level steps the run leaves out. */\n  skipped: number;\n  /** Steps run as stubs because they read a step that is left out, with what they read. */\n  stubbed: { node: Ulid; title: string; reads: string[] }[];\n}\n\n/** Why a partial run cannot start at this node, or undefined when it can. */\nexport function partialProblem(doc: FlowDocument, node: Ulid): string | undefined {\n  const model = buildModel(doc);\n  const entry = model.nodes.get(node);\n  if (!entry) return 'No such node';\n  if (entry.level !== ROOT) return 'A run starts at a step of the top level: open the top level';\n  if (entry.node.type === 'start' || entry.node.type === 'end')\n    return 'A run starts at a step, not at a start or end node';\n  if (!(model.levels.get(ROOT)?.nodes ?? []).some((n) => n?.type === 'start'))\n    return 'The flow has no start node';\n  return undefined;\n}\n\n// IDs for the wires made for the run only; the flow file never sees them.\nconst noIds = { newId: createIdFactory() };\n\nexport function partialFlow(doc: FlowDocument, run: PartialRun): PartialFlow | { error: string } {\n  const problem = partialProblem(doc, run.node);\n  if (problem) return { error: problem };\n  const model = buildModel(doc);\n  const root = model.levels.get(ROOT);\n  const nodes = (root?.nodes ?? []).filter((n): n is FlowNode => !!n?.id);\n  const edges = (root?.edges ?? []).filter((e) => !!e?.from && !!e.to);\n  const start = nodes.find((n) => n.type === 'start') as FlowNode;\n  const target = model.nodes.get(run.node)?.node as FlowNode;\n\n  // What the run reaches: the step alone, or everything after it.\n  const reached = new Set<Ulid>([run.node]);\n  if (!run.only)\n    for (const stack = [run.node]; stack.length > 0; ) {\n      const at = stack.pop() as Ulid;\n      for (const e of edges)\n        if (e.from.node === at && !reached.has(e.to.node)) {\n          reached.add(e.to.node);\n          stack.push(e.to.node);\n        }\n    }\n  const skipped = nodes.filter((n) => n.id !== start.id && n.type !== 'end' && !reached.has(n.id));\n\n  const cmds: FlowCommand[] = [];\n  // The steps left out go first: the wire that is then made from Start cannot close a loop.\n  if (skipped.length > 0) cmds.push({ kind: 'deleteNodes', ids: skipped.map((n) => n.id) });\n  let text = stringify(doc);\n  try {\n    for (const c of cmds) text = planCommand(text, c, noIds).text;\n    // Start now leads to the chosen step, and nowhere else.\n    for (;;) {\n      const now = buildModel(parse(text) as FlowDocument).levels.get(ROOT);\n      const out = (now?.edges ?? []).find((e) => e?.from?.node === start.id);\n      if (!out) break;\n      if (out.to.node === run.node && out.to.port === 'in') break;\n      text = planCommand(text, { kind: 'disconnect', edge: out.id }, noIds).text;\n    }\n    const wired = buildModel(parse(text) as FlowDocument).levels.get(ROOT);\n    if (!(wired?.edges ?? []).some((e) => e?.from?.node === start.id)) {\n      text = planCommand(\n        text,\n        {\n          kind: 'connect',\n          from: { node: start.id, port: 'ok_hosts' },\n          to: { node: run.node, port: 'in' },\n        },\n        noIds,\n      ).text;\n    }\n    // One step alone: its hosts go on to a successful end, when the flow has one.\n    if (run.only) {\n      const now = buildModel(parse(text) as FlowDocument).levels.get(ROOT);\n      const port = CONTINUES_ON[target.type];\n      const end = (now?.nodes ?? []).find((n) => n?.type === 'end' && n.outcome !== 'failed');\n      const free =\n        port && !(now?.edges ?? []).some((e) => e?.from?.node === run.node && e.from.port === port);\n      if (port && end && free)\n        text = planCommand(\n          text,\n          { kind: 'connect', from: { node: run.node, port }, to: { node: end.id, port: 'in' } },\n          noIds,\n        ).text;\n    }\n  } catch (e) {\n    return {\n      error: `The flow cannot be trimmed for this run: ${e instanceof Error ? e.message : String(e)}`,\n    };\n  }\n\n  const out = parse(text) as FlowDocument;\n  // A field that read a step left out has lost its `from` (deleteNodes): its step runs as a stub.\n  const before = model;\n  const after = buildModel(out);\n  const stubbed: PartialFlow['stubbed'] = [];\n  for (const { node } of after.nodes.values()) {\n    const was = before.nodes.get(node.id)?.node;\n    if (!was) continue;\n    const reads = Object.entries(was.inputs ?? {})\n      .filter(([name, f]) => !!f?.from && !node.inputs?.[name]?.from)\n      .map(([, f]) => f?.from as string);\n    if (reads.length === 0) continue;\n    // A subflow hands its inputs to the steps inside it: they are stubs too.\n    const inside = new Set([node.id, ...descendantIds(node)]);\n    let any = false;\n    for (const id of inside) {\n      const n = after.nodes.get(id)?.node;\n      if (n?.impl) {\n        delete (n as { impl?: unknown }).impl;\n        any = true;\n      }\n    }\n    if (any) stubbed.push({ node: node.id, title: node.title, reads });\n  }\n  return { doc: out, skipped: skipped.length, stubbed };\n}\n\n/** \"from Validate\" or \"Validate alone\", with what was left out, for the run's panel. */\nexport function partialLine(title: string, only: boolean, flow: PartialFlow): string {\n  const what = only ? `Ran \"${title}\" alone` : `Ran from \"${title}\"`;\n  const left = flow.skipped\n    ? `; ${flow.skipped} step${flow.skipped === 1 ? '' : 's'} before it did not run`\n    : '';\n  const stubs = flow.stubbed.length\n    ? `. As stubs, since they read a step that did not run: ${flow.stubbed.map((s) => s.title).join(', ')}`\n    : '';\n  return `${what}${left}${stubs}`;\n}\n"],
-  "mappings": "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",
+  "mappings": "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",
   "names": ["out"]
 }

package/dist/engine/preview.js

@@ -1,15 +1,15 @@
 import {
   engineFor
-} from "../chunks/chunk-J7KCGVHU.js";
-import "../chunks/chunk-CXVJWFGT.js";
+} from "../chunks/chunk-HPRG2672.js";
+import "../chunks/chunk-2MJKBPGG.js";
 import "../chunks/chunk-OEEHAY5X.js";
 import "../chunks/chunk-LPBLGBDT.js";
 import "../chunks/chunk-6MLYGFT6.js";
-import "../chunks/chunk-ZAYNYPCX.js";
+import "../chunks/chunk-ARA3VJR2.js";
 import "../chunks/chunk-56VTJ6YF.js";
 import "../chunks/chunk-BAZIS67B.js";
 import "../chunks/chunk-X3DEH47B.js";
-import "../chunks/chunk-T5UB4MBB.js";
+import "../chunks/chunk-TOTSB4HG.js";
 import "../chunks/chunk-SN7X6FYV.js";
 import "../chunks/chunk-24G5UVEF.js";
 import "../chunks/chunk-CORZL72E.js";
@@ -20,6 +20,7 @@ import "../chunks/chunk-GK3SD3WE.js";
 import "../chunks/chunk-H6ARLMMI.js";
 import "../chunks/chunk-TG3C3GIL.js";
 import "../chunks/chunk-WISXIO3I.js";
+import "../chunks/chunk-FIKPXL6E.js";
 import "../chunks/chunk-WG7O3OBV.js";
 import "../chunks/chunk-NUGJSYSP.js";
 import "../chunks/chunk-XRGZNPPO.js";
@@ -32,6 +33,7 @@ import "../chunks/chunk-HFHXHOBC.js";
 import "../chunks/chunk-RKLF3DLT.js";
 import "../chunks/chunk-GTHXWNCC.js";
 import "../chunks/chunk-OEQXGULI.js";
+import "../chunks/chunk-T6SZLRDM.js";
 import "../chunks/chunk-AJRIS5VY.js";
 import "../chunks/chunk-GQ2W4RTY.js";
 import "../chunks/chunk-BVEW6MKL.js";

package/dist/engine/preview.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../../../../src/core/engine/preview.ts"],
   "sourcesContent": ["// What a node compiles to, for the inspector (mockup 03), plus the engine's findings for the canvas.\nimport type { FlowDocument, Ulid } from '../flow/types';\nimport type { Finding } from '../flow/validate';\nimport { engineFor } from './engines';\n\nexport interface CodePreview {\n  /** Generated play text per node (its own lines from its level file). */\n  plays: Record<Ulid, string>;\n  /** Engine findings the validator does not already report. */\n  findings: Finding[];\n}\n\nexport function codePreview(doc: FlowDocument, source: string): CodePreview {\n  const result = engineFor(doc).generate(doc, { source });\n  const plays: Record<Ulid, string> = {};\n  for (const [node, range] of Object.entries(result.plays)) {\n    const file = result.files.find((f) => f.name === range.file);\n    if (file) plays[node] = file.text.split('\\n').slice(range.start, range.end).join('\\n');\n  }\n  return {\n    plays,\n    findings: result.findings.filter((f) => f.code !== 'codegen-no-targets'),\n  };\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYO,SAAS,YAAY,KAAmB,QAA6B;AAC1E,QAAM,SAAS,UAAU,GAAG,EAAE,SAAS,KAAK,EAAE,OAAO,CAAC;AACtD,QAAM,QAA8B,CAAC;AACrC,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,OAAO,KAAK,GAAG;AACxD,UAAM,OAAO,OAAO,MAAM,KAAK,CAAC,MAAM,EAAE,SAAS,MAAM,IAAI;AAC3D,QAAI,KAAM,OAAM,IAAI,IAAI,KAAK,KAAK,MAAM,IAAI,EAAE,MAAM,MAAM,OAAO,MAAM,GAAG,EAAE,KAAK,IAAI;AAAA,EACvF;AACA,SAAO;AAAA,IACL;AAAA,IACA,UAAU,OAAO,SAAS,OAAO,CAAC,MAAM,EAAE,SAAS,oBAAoB;AAAA,EACzE;AACF;",
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYO,SAAS,YAAY,KAAmB,QAA6B;AAC1E,QAAM,SAAS,UAAU,GAAG,EAAE,SAAS,KAAK,EAAE,OAAO,CAAC;AACtD,QAAM,QAA8B,CAAC;AACrC,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,OAAO,KAAK,GAAG;AACxD,UAAM,OAAO,OAAO,MAAM,KAAK,CAAC,MAAM,EAAE,SAAS,MAAM,IAAI;AAC3D,QAAI,KAAM,OAAM,IAAI,IAAI,KAAK,KAAK,MAAM,IAAI,EAAE,MAAM,MAAM,OAAO,MAAM,GAAG,EAAE,KAAK,IAAI;AAAA,EACvF;AACA,SAAO;AAAA,IACL;AAAA,IACA,UAAU,OAAO,SAAS,OAAO,CAAC,MAAM,EAAE,SAAS,oBAAoB;AAAA,EACzE;AACF;",
   "names": []
 }

package/dist/engine/writePlan.js

@@ -1,31 +1,31 @@
 import {
   planGenerated
-} from "../chunks/chunk-JTWR3TGG.js";
-import "../chunks/chunk-J7KCGVHU.js";
-import "../chunks/chunk-UXIXXEIW.js";
-import "../chunks/chunk-CXVJWFGT.js";
+} from "../chunks/chunk-2P3JEHLH.js";
+import "../chunks/chunk-HPRG2672.js";
+import "../chunks/chunk-WSARMPYU.js";
+import "../chunks/chunk-2MJKBPGG.js";
 import "../chunks/chunk-OEEHAY5X.js";
 import "../chunks/chunk-LPBLGBDT.js";
 import "../chunks/chunk-6MLYGFT6.js";
-import "../chunks/chunk-ZAYNYPCX.js";
+import "../chunks/chunk-ARA3VJR2.js";
 import "../chunks/chunk-56VTJ6YF.js";
 import "../chunks/chunk-BAZIS67B.js";
 import "../chunks/chunk-X3DEH47B.js";
-import "../chunks/chunk-T5UB4MBB.js";
+import "../chunks/chunk-TOTSB4HG.js";
 import "../chunks/chunk-SN7X6FYV.js";
 import "../chunks/chunk-24G5UVEF.js";
 import "../chunks/chunk-CORZL72E.js";
 import "../chunks/chunk-75QLJHZ5.js";
 import "../chunks/chunk-LMTTJDCC.js";
-import "../chunks/chunk-2QQC4IZ7.js";
+import "../chunks/chunk-PNLY5IWM.js";
 import "../chunks/chunk-OREXQ4IZ.js";
 import "../chunks/chunk-KSM4O2XL.js";
-import "../chunks/chunk-T6SZLRDM.js";
 import "../chunks/chunk-7D55CRGU.js";
 import "../chunks/chunk-GK3SD3WE.js";
 import "../chunks/chunk-H6ARLMMI.js";
 import "../chunks/chunk-TG3C3GIL.js";
 import "../chunks/chunk-WISXIO3I.js";
+import "../chunks/chunk-FIKPXL6E.js";
 import "../chunks/chunk-WG7O3OBV.js";
 import "../chunks/chunk-NUGJSYSP.js";
 import "../chunks/chunk-XRGZNPPO.js";
@@ -38,6 +38,7 @@ import "../chunks/chunk-HFHXHOBC.js";
 import "../chunks/chunk-RKLF3DLT.js";
 import "../chunks/chunk-GTHXWNCC.js";
 import "../chunks/chunk-OEQXGULI.js";
+import "../chunks/chunk-T6SZLRDM.js";
 import "../chunks/chunk-AJRIS5VY.js";
 import "../chunks/chunk-GQ2W4RTY.js";
 import "../chunks/chunk-BVEW6MKL.js";

package/dist/flow/commands.d.ts

@@ -152,6 +152,16 @@ export type FlowCommand = {
     field: ContractField | null;
     /** New name for the field (rename keeps the definition). */
     rename?: string;
+}
+/**
+ * AFD-287: a fact an earlier step sets (set_fact) read by `reader`: an output of that name on
+ * the setter (a fact needs no `from:`) and an input of the reader from it, in one edit.
+ */
+ | {
+    kind: 'useFact';
+    reader: Ulid;
+    setter: Ulid;
+    name: string;
 } | {
     kind: 'updateFlow';
     patch: FlowPatch;

package/dist/flow/commands.js

@@ -6,7 +6,7 @@ import {
   planCommand,
   shadowedKeys,
   testedFinding
-} from "../chunks/chunk-T5UB4MBB.js";
+} from "../chunks/chunk-TOTSB4HG.js";
 import "../chunks/chunk-SN7X6FYV.js";
 import "../chunks/chunk-24G5UVEF.js";
 import "../chunks/chunk-CORZL72E.js";
@@ -16,6 +16,7 @@ import "../chunks/chunk-GK3SD3WE.js";
 import "../chunks/chunk-H6ARLMMI.js";
 import "../chunks/chunk-TG3C3GIL.js";
 import "../chunks/chunk-WISXIO3I.js";
+import "../chunks/chunk-FIKPXL6E.js";
 import "../chunks/chunk-WG7O3OBV.js";
 import "../chunks/chunk-NUGJSYSP.js";
 import "../chunks/chunk-XRGZNPPO.js";
@@ -28,6 +29,7 @@ import "../chunks/chunk-HFHXHOBC.js";
 import "../chunks/chunk-RKLF3DLT.js";
 import "../chunks/chunk-GTHXWNCC.js";
 import "../chunks/chunk-OEQXGULI.js";
+import "../chunks/chunk-T6SZLRDM.js";
 import "../chunks/chunk-BVEW6MKL.js";
 import "../chunks/chunk-BUPWGYNF.js";
 import "../chunks/chunk-WKETMTKT.js";

package/dist/flow/facts.d.ts

@@ -0,0 +1,6 @@
+import type { FlowModel } from './model';
+import type { FlowNode } from './types';
+/** The facts a set_fact step sets: its parameters' keys (`cacheable` is an option). */
+export declare function setFactNames(impl: FlowNode['impl']): string[];
+/** The nearest step that runs before `reader` and sets `name` with set_fact. */
+export declare function factSetter(model: FlowModel, reader: FlowNode, name: string): FlowNode | undefined;

package/dist/flow/facts.js

@@ -0,0 +1,13 @@
+import {
+  factSetter,
+  setFactNames
+} from "../chunks/chunk-FIKPXL6E.js";
+import "../chunks/chunk-T6SZLRDM.js";
+import "../chunks/chunk-BUPWGYNF.js";
+import "../chunks/chunk-WKETMTKT.js";
+import "../chunks/chunk-2OD7UZ7V.js";
+export {
+  factSetter,
+  setFactNames
+};
+//# sourceMappingURL=facts.js.map

package/dist/flow/facts.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/flow/merge.d.ts

@@ -0,0 +1,27 @@
+import type { FlowDocument, Ulid } from './types';
+export type MergeSide = 'ours' | 'theirs';
+export interface MergeConflict {
+    /** Stable across merges of the same versions: choices are given by it. */
+    id: string;
+    kind: 'value' | 'removed' | 'wire' | 'format';
+    /** Where and what, in words: "Say hello: settings.timeout". */
+    label: string;
+    node?: Ulid;
+    annotation?: Ulid;
+    edge?: Ulid;
+    /** The field, dotted (`settings.timeout`); absent for a whole step, wire or the format. */
+    field?: string;
+    base?: unknown;
+    ours?: unknown;
+    theirs?: unknown;
+}
+export interface FlowMerge {
+    /** The merged flow, each conflict as its choice says (ours until chosen). */
+    doc: FlowDocument;
+    conflicts: MergeConflict[];
+}
+/**
+ * Merges what `ours` and `theirs` changed since `base`. `choices` settle conflicts by id (ours
+ * when not given). Flows without IDs are matched by the IDs their keys give (Complete IDs).
+ */
+export declare function mergeFlows(baseDoc: FlowDocument, oursDoc: FlowDocument, theirsDoc: FlowDocument, choices?: Record<string, MergeSide>): FlowMerge;