@demlik/tea 0.7.0 → 0.9.0

package/dist/chart/report/index.d.ts

@@ -0,0 +1,116 @@
+import { WalkCounts } from '../index.js';
+export { edgeKey } from '../index.js';
+import { a as ImportedChart, L as LogEntry, b as LaneStatus, I as ImportedLane, W as WorkflowImportOptions } from '../../fold-Blbhru48.js';
+export { c as ImportedEdge, d as ImportedNode, e as ImportedPhase, f as LeafStates, g as PhaseStand, P as PhaseStanding, T as TaskState, h as TimelineStep, U as UnreplayableLogError, i as WorkflowImportError, j as bareEvent, k as chartFromWorkflow, l as chartFromWorkflowText, m as deriveLaneStatus, n as endPolarityOf, o as eventAlphabet, p as foldLane, q as initialOf, r as initialStates, s as laneTerminalReached, t as originOf, u as parseEventsJsonl, v as parseHistoryJson, w as parseStatusJson, x as phaseStandings, y as statesOf, z as stepTask, A as timeline, B as trippedTasks, C as walkedEdgeKey } from '../../fold-Blbhru48.js';
+import '../../core-Bjc0bS8j.js';
+import '../../graph-CcjWZVrd.js';
+
+interface DrawOptions {
+    /** The state the task is in right now — lit. */
+    readonly current?: string;
+    /** Edges the log actually walked, keyed `${from}|${event}|${to}`. */
+    readonly walked?: WalkCounts;
+}
+/**
+ * One task's region as a mermaid `stateDiagram-v2` block, with the current node
+ * lit, the walked edges marked and the two endings drawn apart.
+ *
+ * `polarity` is always on: a lane's whole point is that `shipped` and `frozen`
+ * are not the same ending, and a report that painted them alike would be lying
+ * in the place a reader looks first. It is an OPTION on the renderer rather
+ * than a default because a chart drawing is something a reviewer approves —
+ * see `ChartMermaidOptions.polarity`.
+ */
+declare function drawTask(chart: ImportedChart, opts?: DrawOptions): string;
+/**
+ * The edges a log walked, counted — the input `drawTask` marks from.
+ *
+ * Reads each step's DECLARED `edge` rather than recomputing one from
+ * `from`/`event`/`to`: a resume edge is drawn to its fallback and walked to
+ * wherever `was` pointed, so the observed target names an edge the drawing does
+ * not have. `TimelineStep.edge` is the edge that actually fired.
+ */
+declare function walkedEdges(steps: readonly {
+    readonly edge: string;
+}[]): WalkCounts;
+
+/** The lane the report is about. `workflow` is the PARSED document, or an import. */
+interface LaneReportInput {
+    /** `workflow.json`, parsed — or an already-imported lane, reused as is. */
+    readonly workflow: unknown;
+    readonly entries: readonly LogEntry[];
+    /**
+     * `lane status`'s answer.
+     *
+     * OPTIONAL, and that is the whole shape of the two input paths: a caller
+     * shelling out to `fabrika` hands over the CLI's own derivation and the
+     * report never second-guesses it; a caller holding only the two files omits
+     * it and the same derivation runs here.
+     */
+    readonly status?: LaneStatus;
+    /** Heading for the block. Defaults to the document's `id`. */
+    readonly title?: string;
+}
+interface LaneReport {
+    readonly markdown: string;
+}
+/**
+ * What this task is waiting on — or `null` at a final.
+ *
+ * DERIVED, entirely: the events this state routes, grouped by the origin each
+ * one DECLARES, in declaration order. Nothing here knows a state name, an event
+ * name or a job title, so a consumer that renames half its states changes this
+ * output correctly and a consumer with a completely different cast is served by
+ * the same function.
+ *
+ * The degradation is the point of the second half. Provenance is not in
+ * `workflow.json` — it is stated at the import boundary or not at all — so a
+ * chart imported without it must say what it actually knows, which is WHICH
+ * EVENTS the state accepts. It never says who sends them.
+ */
+declare function waitingOn(chart: ImportedChart, state: string): string | null;
+/**
+ * A lane, as one markdown block.
+ *
+ * The diagram half is behind {@link drawTask}, which is a translation onto
+ * `chartMermaid` — the package's one chart renderer.
+ */
+declare function laneReport(input: LaneReportInput): LaneReport;
+
+/** Everything a report needs, however it was obtained. */
+interface LaneSource {
+    readonly workflow: ImportedLane;
+    readonly entries: readonly LogEntry[];
+    /** Present only on the CLI path — the driver's own answer, not ours. */
+    readonly status?: LaneStatus;
+}
+/**
+ * PATH 1 — the two files.
+ *
+ * @param workflowJson the bytes of `<lane>/workflow.json`
+ * @param eventsJsonl  the bytes of `<lane>/events.jsonl` (`""` for a fresh lane)
+ * @param options      {@link WorkflowImportOptions} — carried straight through
+ *                     to the importer, which is the one place it is read.
+ */
+declare function laneFromFiles(workflowJson: string, eventsJsonl: string, options?: WorkflowImportOptions): LaneSource;
+/**
+ * PATH 2 — the CLI's stdout.
+ *
+ *     const dir  = ".fabrika/lanes/5842";
+ *     const src  = laneFromCli(
+ *       readFileSync(`${dir}/workflow.json`, "utf8"),
+ *       execFileSync("fabrika", ["lane", "status",  "--lane", "5842"], { encoding: "utf8" }),
+ *       execFileSync("fabrika", ["lane", "history", "--lane", "5842"], { encoding: "utf8" }),
+ *     );
+ *     console.log(laneReport(reportInput(src)).markdown);
+ *
+ * @param workflowJson the bytes of `<lane>/workflow.json`
+ * @param statusStdout `fabrika lane status`'s stdout — `JSON.stringify(status, null, 2)`
+ * @param historyStdout `fabrika lane history`'s stdout — the log as a JSON array
+ * @param options {@link WorkflowImportOptions} — the same seam as path 1's.
+ */
+declare function laneFromCli(workflowJson: string, statusStdout: string, historyStdout: string, options?: WorkflowImportOptions): LaneSource;
+/** A `LaneSource` as the report's input. One line, so neither path spells it. */
+declare function reportInput(source: LaneSource, title?: string): LaneReportInput;
+
+export { type DrawOptions, ImportedChart, ImportedLane, type LaneReport, type LaneReportInput, type LaneSource, LaneStatus, LogEntry, WalkCounts, WorkflowImportOptions, drawTask, laneFromCli, laneFromFiles, laneReport, reportInput, waitingOn, walkedEdges };

package/dist/chart/report/index.js

@@ -0,0 +1,32 @@
+import { parseEventsJsonl, chartFromWorkflowText, parseStatusJson, parseHistoryJson } from '../../chunk-5KJKJOFC.js';
+export { UnreplayableLogError, WorkflowImportError, bareEvent, chartFromWorkflow, chartFromWorkflowText, deriveLaneStatus, drawTask, endPolarityOf, eventAlphabet, foldLane, initialOf, initialStates, laneReport, laneTerminalReached, originOf, parseEventsJsonl, parseHistoryJson, parseStatusJson, phaseStandings, statesOf, stepTask, timeline, trippedTasks, waitingOn, walkedEdgeKey, walkedEdges } from '../../chunk-5KJKJOFC.js';
+export { edgeKey } from '../../chunk-E6GEDSF4.js';
+import '../../chunk-UOC2PL46.js';
+import '../../chunk-B5VXOFMZ.js';
+
+// src/chart/report/sources.ts
+function laneFromFiles(workflowJson, eventsJsonl, options = {}) {
+  return {
+    workflow: chartFromWorkflowText(workflowJson, options),
+    entries: parseEventsJsonl(eventsJsonl)
+  };
+}
+function laneFromCli(workflowJson, statusStdout, historyStdout, options = {}) {
+  return {
+    workflow: chartFromWorkflowText(workflowJson, options),
+    entries: parseHistoryJson(historyStdout),
+    status: parseStatusJson(statusStdout)
+  };
+}
+function reportInput(source, title) {
+  return {
+    workflow: source.workflow,
+    entries: source.entries,
+    ...source.status === void 0 ? {} : { status: source.status },
+    ...title === void 0 ? {} : { title }
+  };
+}
+
+export { laneFromCli, laneFromFiles, reportInput };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/chart/report/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/chart/report/sources.ts"],"names":[],"mappings":";;;;;;;AAsDO,SAAS,aAAA,CACd,YAAA,EACA,WAAA,EACA,OAAA,GAAiC,EAAC,EACtB;AACZ,EAAA,OAAO;AAAA,IACL,QAAA,EAAU,qBAAA,CAAsB,YAAA,EAAc,OAAO,CAAA;AAAA,IACrD,OAAA,EAAS,iBAAiB,WAAW;AAAA,GACvC;AACF;AAkBO,SAAS,YACd,YAAA,EACA,YAAA,EACA,aAAA,EACA,OAAA,GAAiC,EAAC,EACtB;AACZ,EAAA,OAAO;AAAA,IACL,QAAA,EAAU,qBAAA,CAAsB,YAAA,EAAc,OAAO,CAAA;AAAA,IACrD,OAAA,EAAS,iBAAiB,aAAa,CAAA;AAAA,IACvC,MAAA,EAAQ,gBAAgB,YAAY;AAAA,GACtC;AACF;AAGO,SAAS,WAAA,CACd,QACA,KAAA,EACiB;AACjB,EAAA,OAAO;AAAA,IACL,UAAU,MAAA,CAAO,QAAA;AAAA,IACjB,SAAS,MAAA,CAAO,OAAA;AAAA,IAChB,GAAI,OAAO,MAAA,KAAW,MAAA,GAAY,EAAC,GAAI,EAAE,MAAA,EAAQ,MAAA,CAAO,MAAA,EAAO;AAAA,IAC/D,GAAI,KAAA,KAAU,MAAA,GAAY,EAAC,GAAI,EAAE,KAAA;AAAM,GACzC;AACF","file":"index.js","sourcesContent":["// ═══════════════════════════════════════════════════════════════════════════\n// THE TWO INPUT PATHS.\n//\n// Both produce the same `LaneReportInput`, and both take TEXT rather than doing\n// their own I/O — so this module has no `node:fs` in it, runs in a worker or a\n// Durable Object, and the caller keeps the one decision that is genuinely\n// theirs (which bytes, from where).\n//\n//   THE FILE PATH — `workflow.json` + `events.jsonl` off disk. What a tool\n//   running inside the repo already has: the lane directory is right there.\n//   Status is DERIVED, because there is nothing to be handed.\n//\n//   THE CLI PATH — `fabrika lane status` + `fabrika lane history` stdout, plus\n//   the `workflow.json` bytes. This is the one that matters: it means a\n//   standalone inspector can shell out to `fabrika` and need ZERO phoenix\n//   changes, because both verbs already print JSON on stdout and have done\n//   since they were written. Status here is the CLI's OWN derivation, carried\n//   verbatim — the report reads, it does not re-decide.\n//\n// `workflow.json` is read as a file on BOTH paths, deliberately. `lane print`\n// looks like the CLI answer for topology and is not: it emits, per state, the\n// event NAMES a cell exists for and never the targets, so no edge can be drawn\n// from it. The document is local, gitignored and sitting next to the log.\n// ═══════════════════════════════════════════════════════════════════════════\nimport {\n  type LaneStatus,\n  type LogEntry,\n  parseEventsJsonl,\n  parseHistoryJson,\n  parseStatusJson,\n} from \"./fold\";\nimport type { LaneReportInput } from \"./report\";\nimport {\n  chartFromWorkflowText,\n  type ImportedLane,\n  type WorkflowImportOptions,\n} from \"./workflow\";\n\n/** Everything a report needs, however it was obtained. */\nexport interface LaneSource {\n  readonly workflow: ImportedLane;\n  readonly entries: readonly LogEntry[];\n  /** Present only on the CLI path — the driver's own answer, not ours. */\n  readonly status?: LaneStatus;\n}\n\n/**\n * PATH 1 — the two files.\n *\n * @param workflowJson the bytes of `<lane>/workflow.json`\n * @param eventsJsonl  the bytes of `<lane>/events.jsonl` (`\"\"` for a fresh lane)\n * @param options      {@link WorkflowImportOptions} — carried straight through\n *                     to the importer, which is the one place it is read.\n */\nexport function laneFromFiles(\n  workflowJson: string,\n  eventsJsonl: string,\n  options: WorkflowImportOptions = {},\n): LaneSource {\n  return {\n    workflow: chartFromWorkflowText(workflowJson, options),\n    entries: parseEventsJsonl(eventsJsonl),\n  };\n}\n\n/**\n * PATH 2 — the CLI's stdout.\n *\n *     const dir  = \".fabrika/lanes/5842\";\n *     const src  = laneFromCli(\n *       readFileSync(`${dir}/workflow.json`, \"utf8\"),\n *       execFileSync(\"fabrika\", [\"lane\", \"status\",  \"--lane\", \"5842\"], { encoding: \"utf8\" }),\n *       execFileSync(\"fabrika\", [\"lane\", \"history\", \"--lane\", \"5842\"], { encoding: \"utf8\" }),\n *     );\n *     console.log(laneReport(reportInput(src)).markdown);\n *\n * @param workflowJson the bytes of `<lane>/workflow.json`\n * @param statusStdout `fabrika lane status`'s stdout — `JSON.stringify(status, null, 2)`\n * @param historyStdout `fabrika lane history`'s stdout — the log as a JSON array\n * @param options {@link WorkflowImportOptions} — the same seam as path 1's.\n */\nexport function laneFromCli(\n  workflowJson: string,\n  statusStdout: string,\n  historyStdout: string,\n  options: WorkflowImportOptions = {},\n): LaneSource {\n  return {\n    workflow: chartFromWorkflowText(workflowJson, options),\n    entries: parseHistoryJson(historyStdout),\n    status: parseStatusJson(statusStdout),\n  };\n}\n\n/** A `LaneSource` as the report's input. One line, so neither path spells it. */\nexport function reportInput(\n  source: LaneSource,\n  title?: string,\n): LaneReportInput {\n  return {\n    workflow: source.workflow,\n    entries: source.entries,\n    ...(source.status === undefined ? {} : { status: source.status }),\n    ...(title === undefined ? {} : { title }),\n  };\n}\n"]}