@ccgrapher/ingest

Reconstructs a workflow spec from existing TypeScript orchestration code.

import { ingest } from "@ccgrapher/ingest";

const { spec, warnings } = ingest(readFileSync("orchestration.ts", "utf8"));

The other direction: what does my workflow actually do, rather than what did I intend? Uses ts-morph to recover nodes, dependencies and concurrency from real code, which is where a fake-edge audit finds waste that was never in a diagram.

Edges come from dataflow, not from naming: whichever awaited result reaches the next call's arguments is the dependency, whatever the binding holding it is called. Where a value moves by a route it cannot follow, it recovers no edge and says so, because an edgeless graph lints clean and would otherwise pass silently.

Round-tripping is lossless — spec -> codegen -> ingest -> spec returns a deeply-equal spec, asserted for every fixture in the test suite.

Part of ccgrapher. Apache-2.0 — see LICENSE and NOTICE.