Subsystems

Derived from packages/core/src: 32 subsystems, 748 files, 146k lines, 154 cross-subsystem edges.

This page is the exhaustive record: every subsystem, every cross-subsystem edge, and a file:line witness for each claim. For the shape of the system rather than its inventory, see the hand-drawn map on Internals.

Subsystems

Subsystem	Purpose	Tier	Files	Lines	Fan-in	Fan-out
loop	The drive-to-green engine: turns, tools, gate settling, steering, adapters	core	177	49k	8	24
rule-packs	The ESLint rule packs the gate enforces, grouped by stack	core	191	23k	3	3
render	Terminal UI — status bar, menus, wizards, markdown, diffs, spinners	core	45	11k	7	7
cli	Argument parsing, the interactive REPL, and per-mode wiring	core	29	10k	2	20
agent	Tool schemas, the model-as-agent wrapper, and the malformed-tool-call repair ladder	core	11	5k	9	9
site-plugins	Built-in site experts (Reddit…) that read a site’s structured data through the Chrome bridge	optional	34	4k	1	4
inference	OpenAI-compatible provider: streaming, tool calls, reasoning, token usage	core	12	3k	10	4
config	tsforge.config.json, profiles, recipes, agent specs, and external plugins	core	14	3k	10	9
meta-rules	Gate rules that need no AST — config shape, CI wiring, supply chain	core	42	3k	1	2
self-harness	Lets the harness propose, trial, and keep edits to its own prompts and rules	optional	15	3k	2	9
scaffold	Stands up a new project from an archetype and configures its gate	optional	20	3k	3	3
(root)	CLI entry, model registry, session persistence — the loose files in src/	core	6	3k	6	16
gate	Composes and runs the deterministic gate: linter, stages, tool paths	core	16	3k	5	8
editor	The terminal input-line editor behind the REPL prompt	core	10	2k	2	2
reviewers	Independent review panel that grades a change before it is trusted	optional	9	2k	1	3
eval	Run scoring, failure classification, and the quality judge	optional	10	2k	4	4
lib	Shared primitives — fs, json, guards, scope globs, SSRF checks, clipboard	core	21	2k	26	0
files	Reading, creating, and hash-anchored editing of workspace files	core	9	2k	5	1
policy	Decides which actions are allowed in the current mode before they run	core	5	2k	5	3
mcp	Model Context Protocol client that exposes external servers as tools	optional	11	2k	4	1
chrome-bridge	Localhost WebSocket bridge to the tsforge Chrome extension — read-only research in the user’s browser	optional	9	1k	4	1
architecture ⚠️	Derives this map from source so the docs cannot drift from the code	optional	8	1k	0	0
lsp	TypeScript language service powering navigation and write-time diagnostics	optional	3	<1k	5	0
browser	Headless Chromium oracle that render-checks a page as a gate stage	optional	3	<1k	1	1
infer-rules	Scans a repo for its conventions and turns them into rule overrides	core	7	<1k	5	2
validate	Runs the gate command and parses tool output into structured errors	core	7	<1k	7	2
spec	Task and spec shapes, spec parsing, and test generation from intent	core	6	<1k	6	6
stack-detection	Detects the project’s stack and picks which rule packs apply	core	4	<1k	8	1
setup	Onboarding wizard that writes a project’s initial tsforge config	optional	4	<1k	2	5
codebase	Structural workspace map and hub ranking used to seed prompt context	core	6	<1k	2	4
proptest ⚠️	Derives property-based test inputs from TypeScript types	optional	3	<1k	0	0
constitution ⚠️	Baseline system-role text and the reference ESLint constitution	optional	1	<1k	0	0

⚠️ marks a subsystem with no imports in either direction inside src/. That does not make it dead — it may be reached only from tests/ or scripts/ — but it does mean the running harness never pulls it in.

Mutual dependencies

Pairs that import each other, with the line proving each direction. Only mutual pairs are listed: longer cycles exist in a graph this dense, and enumerating them buries the ones someone can actually go and break.

Pair	One way	The other
(root) ↔ cli	cli.ts:30 → ./cli/args	cli/config-menu.ts:10 → ../models-config
(root) ↔ gate	cli.ts:32 → ./gate/gate-runner	gate/core-gate.ts:3 → ../update-check
(root) ↔ inference	classify.ts:1 → ./inference	inference/image-gen.ts:4 → ../models-config
(root) ↔ loop	cli.ts:13 → ./loop	loop/expert-handoff.ts:21 → ../models-config
agent ↔ inference	agent/agent-runner.ts:18 → ../inference	inference/wire.ts:9 → ../agent
agent ↔ loop	agent/agent-runner.ts:21 → ../loop/loop.types	loop/context-hygiene.ts:12 → ../agent/agent.constants
agent ↔ policy	agent/agent-runner.ts:20 → ../policy	policy/classify.ts:1 → ../agent
agent ↔ spec	agent/agent.types.ts:1 → ../spec	spec/generate-tests.ts:5 → ../agent
cli ↔ render	cli/banner.ts:9 → ../render	render/command-menu.ts:2 → ../cli/commands
config ↔ rule-packs	config/external-plugins.ts:5 → ../rule-packs	rule-packs/index.ts:135 → ../config/plugin-fingerprint
editor ↔ render	editor/completion.ts:8 → ../render/file-menu	render/frame/input-seq.ts:1 → ../../editor/segments
eval ↔ loop	eval/failure-class.ts:1 → ../loop/loop.types	loop/loop.types.ts:7 → ../eval/failure-class
inference ↔ loop	inference/wire.ts:10 → ../loop/context-hygiene	loop/assistant-message.ts:1 → ../inference
loop ↔ render	loop/gate/panel.ts:3 → ../../render/frame/ansi-plain	render/agent-tree.ts:8 → ../loop/loop.types
loop ↔ self-harness	loop/feedback/rule-docs.ts:3 → ../../self-harness/overlay	self-harness/build-evidence.ts:3 → ../loop
loop ↔ spec	loop/feedback/feedback.ts:2 → ../../spec	spec/generate-tests.ts:4 → ../loop
spec ↔ validate	spec/generate-tests.ts:8 → ../validate	validate/accept.ts:1 → ../spec

Adapter seams

The interfaces an adapter fills in. The core loop may not import an adapter — @typescript-eslint/no-restricted-imports in eslint.config.js enforces it — so everything stack-specific arrives through one of these.

Seam	Declared	Files referencing it
IStackAdapter	loop/planning/stack-adapter.ts:14	6
IConventionProvider	loop/conventions-provider.ts:10	17
IPlanSchema	loop/planning/plan-types.ts:45	8
IGate	gate/gate-runner.ts:25	22
IProductPlan	loop/planning/plan-types.ts:32	10

Entry points

Async functions returning an exit code, declared under the CLI — the commands.

Function	Declared
agentsMode	cli.ts:384
greenfieldMode	cli.ts:685
harnessDiagnoseMode	cli/harness-diagnose-mode.ts:211
harnessReviewMode	cli/harness-review-mode.ts:700
main	cli.ts:801
mapMode	cli.ts:520
recipesMode	cli.ts:539
repl	cli/repl.ts:1175
reviewMode	cli.ts:203
runOnce	cli.ts:105
runTraceCommand	cli/repl-commands.ts:160
scaffoldMode	cli.ts:767
setupMode	cli.ts:528
traceMode	cli.ts:590

Imports that leave src/

src/ reaching into scripts/ inverts the house rule that scripts orchestrate and src/ decides — logic imported this way sits where tests are not looking.

From	Import	Target
scaffold	scaffold/io.ts:11	scripts/boot-check.ts

What this map does not cover

Stated so a gap is not mistaken for a clean result:

• Dynamic import() and createRequire are not followed — only static imports.
• tests/ and scripts/ are not scanned; only imports into them are noted above.
• Coupling through shared global state or the filesystem is invisible here.
• Only mutual dependency pairs are reported, not longer cycles.