Rotorsoft / act-root / 34358860953

100%

push

github

feat(act-diagram): export the pipeline stages the IDE plugins need (#1659)

* docs(act-diagram): document the exports the package actually has

The README's Functions table listed ten entries; src/index.ts exports
two of them. The other eight — extractModel, buildModel, navigateToCode,
topoSort, computeLayout, parseMultiFileResponse, stripFences,
deriveProjectName — exist only under internal snake_case names and are
never re-exported, so the "Bring-your-own pipeline" snippet documenting
them did not compile. Same shape as #1621 on act-http/webhook, and
larger.

Re-exporting them would have been the other way out, but the package
parses Act source and ActDiagram owns that pipeline end to end. Handing
out the individual stages is public surface this tool does not need, so
the table now lists validate and emptyModel, says plainly that the rest
is internal, and the pipeline snippet is gone rather than made to work.
A Types section replaces the exports that were only ever documented by
that snippet's imports.

Closes #1650

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QPx2Qu7ZHDTSpoWYJvX4RJ

* docs(act-diagram): say why the pipeline stages stay internal, not that they always will

The first pass declared "no plan to add one", which is a roadmap
commitment rather than a fact about the code, and act-diagram has real
IDE consumers — the Neovim and VS Code plugins — whose needs are not
mine to foreclose in a README.

What is a fact: the stages are absent from the exports map, so they
cannot be imported even by path, and the plugins drive the diagram
through the component and the postMessage protocol instead. The section
now says that, names the plugins as the case the component surface
exists for, and points a host that genuinely needs a stage at an issue
and the RFC gate rather than at a deep import.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https:... (continued)

4353 of 4353 branches covered (100.0%)

Branch coverage included in aggregate %.

9419 of 9419 relevant lines covered (100.0%)

1186.47 hits per line