truecourse-ai/truecourse

View on GitHub

Turns the documentation you already write into tests that run. A failing test means your product and your docs disagree, and names the section.

Stars: 530
Forks: 43
Open beginner issues: 0
Indexed issues: 38
Avg merge: 15h 18m
Merged PRs (30d): 31

Dominant language: TypeScript
License: MIT
Last GitHub push: Sep 14, 2026
Latest indexed: Sep 15, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: good first issue

Open All

38 open issues indexed

Add dismiss violations functionality Open

good first issue

truecourse-ai/truecourse#8 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Add ability to create custom rules and enable/disable rules Open

good first issue

truecourse-ai/truecourse#9 · 3 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Add to GitHub copilot skills Open

truecourse-ai/truecourse#42 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Default port reserved by docker Open

truecourse-ai/truecourse#44 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Llm model provider needed for vscode skills Open

truecourse-ai/truecourse#50 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
`contracts generate` exits 1 with "No contracts were written" on soft validation issues (unresolved cross-references) — but contracts were actually written Open

truecourse-ai/truecourse#492 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
verify: stash sweeps away untracked .truecourse/contracts/, causing ENOENT right after a successful contracts generate Open

truecourse-ai/truecourse#542 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
verify hard-fails when no contracts exist (generate → verify pipeline breaks) Open

truecourse-ai/truecourse#590 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
analyze crashes with "Invalid string length" on repos that vendor minified JS Open

truecourse-ai/truecourse#591 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Spec tab "Diff" mode silently drops in-place claim edits (server diffByKey detects only added/removed keys, never "changed") Open

truecourse-ai/truecourse#594 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
contracts generate fails on Windows: spawn ENAMETOOLONG (--append-system-prompt exceeds command-line limit) Open

truecourse-ai/truecourse#660 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
`analyze`: no resume / partial re-run — a rate-limit near the end forces a full ~2.8M-token re-run Open

truecourse-ai/truecourse#791 · 21 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
bug: analyze ignores the configured LLM violation model Open

truecourse-ai/truecourse#799 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 15, 2026
LLM call guards: judge progress (TTFT + stall), not wall-clock duration Open

truecourse-ai/truecourse#805 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 15, 2026
spec scan reads only .md — rst/asciidoc spec corpora produce an empty universe Open

truecourse-ai/truecourse#806 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
Empty corpus reads as success: scan says 'nothing changed' and generate says 'every section already guarded' over zero docs Open

truecourse-ai/truecourse#807 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
Nonzero claude exit discards stdout/stderr — errors surface as blank 'claude exited 1:' Open

truecourse-ai/truecourse#810 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Retire the CLAUDE_CODE_* env namespace Open

truecourse-ai/truecourse#822 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
Affected-only test execution — domain split works, selection needs a fail-open design Open

truecourse-ai/truecourse#825 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
API mode: OpenAI-family providers reject every stage schema — guard generate and spec scan produce nothing Open

truecourse-ai/truecourse#836 · 1 comment · 0 reactions · 0 assignees · Indexed Sep 15, 2026
guard generate: authoring stage fails 100% on API transport — array-rooted schema vs OpenAI json_object mode (0.7.4-next.2) Open

truecourse-ai/truecourse#838 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
guard generate aborts on library-only packages with no `bin`/`main` — discards a coverage report the pipeline can already produce Open

truecourse-ai/truecourse#839 · 0 comments · 0 reactions · 0 assignees · Indexed Sep 15, 2026
External APIs: 22 'detected but not declared' rows on first setup — inventory shown before relevance is known Open

truecourse-ai/truecourse#844 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 15, 2026
A flow should only show the drivers it belongs to — never 'no code path does this' for every other driver Open

truecourse-ai/truecourse#849 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
guard setup proposes a CLI-only recipe even when the engine derives hundreds of API journeys Open

truecourse-ai/truecourse#850 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
Relevance filter keeps repo-internal non-spec docs (docs/findings, test fixtures) — 'ours' is answered, 'is it spec material' is not Open

truecourse-ai/truecourse#851 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 15, 2026
Cold-run guard generate estimate overshoots by ~120× (claim-derived flow bound) Open

truecourse-ai/truecourse#854 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
guard run streams every drift as multi-line log output mid-run — results belong to the report, live output to the counter Open

truecourse-ai/truecourse#856 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
Coarse generate stages freeze mid-call — no liveness heartbeat, no unit counters for few-large-call stages Open

truecourse-ai/truecourse#857 · 3 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
guard generate leaves self-heal work silently pending — the retry loop must complete in-run, never depend on an unprompted second run Open

truecourse-ai/truecourse#861 · 4 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
cli driver: daemon/service flows need boot-style lifecycle steps — a service flow must be testable, not an eternal infra error Open

truecourse-ai/truecourse#862 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
fidelity/triage LLM calls: 120s budget is mis-sized and a lost call loses its flow attribution Open

truecourse-ai/truecourse#863 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
externals detector: the repo's own product domain becomes a detected external service — self-reference must be filtered Open

truecourse-ai/truecourse#864 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
surface matching: stdio protocols are not HTTP APIs — a flow must only match the api surface when an actual HTTP server exists Open

truecourse-ai/truecourse#865 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
externals detector: aiServices SDK registry predates the Vercel AI SDK — @ai-sdk/* imports are invisible, so Anthropic goes undetected Open

truecourse-ai/truecourse#866 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
externals detector: no detection source for spawned binaries — programs the code executes (claude, dotnet, docker) are invisible to the externals model Open

truecourse-ai/truecourse#867 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026
one scenario per flow holds testable claims hostage — a flow must author as many tests as its claims require Open

truecourse-ai/truecourse#868 · 1 comment · 0 reactions · 1 assignee · Indexed Sep 15, 2026
cli authoring must receive the command grammar — flags are parsed facts, not things the model guesses Open

truecourse-ai/truecourse#869 · 0 comments · 0 reactions · 1 assignee · Indexed Sep 15, 2026

truecourse-ai/truecourse

Get new issues in your inbox