Add @llm4ts/flow/Flow: implementPlanFlow absorbs the plan → branch →
per-task coder/review/commit spine previously hand-assembled in every
example, and completeAndPublish replaces the example-local helper. The
implement and issue-pr examples now compose it; the unused runner
ExampleFlow module is deleted and the spine gains its first test with
reusable fake-git/fake-service patterns.
Introduce makeApiConnector and a CLI versionProbe in core Connector so all
six API providers and eight CLI connectors derive health checks, structured
output, and capabilities from one seam instead of repeating them (~900
lines removed; Antigravity and Gemini CLI keep their bespoke probes).
Consolidate connector identity in Models (connectorProvider,
connectorDefaultBaseUrl), removing the runner round-trip mapping whose
silent fallback enriched unknown API connectors with OpenAI's base URL.
Document the OpenAI availability probe's always-true failure branch as
llm4zio v4.2.0 parity.
Thin FlowRunner into a composition edge: the read-only-reasoning default
moves to core ConnectorConfig (defaultReasoningConfig), FlowLlmError.from
replaces eleven copied error wraps, runWithBundle lets tests resolve
connectors once, and TerminalSurface.palette becomes required alongside the
new colorized spinner surface, OSC/C1 sanitization, and stage-stack status
restoration.
Delete dead public surface (LlmService accessor functions, per-provider
layer constructors, six pass-through streaming aliases) per ADR 0002, and
unify the duplicated FNV-1a hashers behind Plan.stableHash.
Ship in-memory PlainFileStore and Workspace fakes in flow, moving the
persistence, review-survey, and pack tests into the flow package.
DevEx: the llm4ts CLI gains --help, --version, and a doctor subcommand that
reports connector and credential health; missing-API-key and
command-not-found errors now name the fix; LLM4TS_PROVIDER/LLM4TS_MODEL
resolution and the script helpers (resolveFlowInput, runFlowMain) move from
examples into @llm4ts/runner; the root README leads with the consumer
quickstart.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>