Repo Doctor
Repository hygiene checks for swamp repos — hardcoded absolute home paths in model/workflow sources (test fixtures and the Linuxbrew prefix exempted), pulled extensions whose source files are missing, generated .swamp artifacts not covered by .gitignore, and workflow wiring drift: scripts missing an exec bit/shebang, declared schedules with no live registration, and dead step dependencies that skip silently or dereference the outputs of a failed step. Writes a combined markdown report plus per-check structured resources.
checkWorkflowWiring now also lints dead step dependencies: a dependsOn whose condition a skipped dependency cannot satisfy (silent skip, green run), and a condition that runs the dependent after a failed dependency whose steps..outputs it dereferences. Schedule detection probes the unauthenticated /health when /api/v1/health is auth-gated (an oauth serve answered 401, so the declared-vs-live diff had silently degraded to the YAML view). The hardcoded-path check skips _test.ts fixtures and exempts /home/linuxbrew via the new excludeSourceSuffixes/allowedHomeRoots globals, removing 21 false errors on a clean checkout. 15 new unit tests.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| projectDir? | string | Swamp repo root to audit. Defaults to the current directory so the model stays portable across machines. |
| sourceDirs? | array | Repo-relative directories scanned for hardcoded absolute paths |
| excludeSourceSuffixes? | array | Path suffixes skipped by the hardcoded-home-path check; test fixtures embed synthetic absolute paths on purpose |
| allowedHomeRoots? | array | Home roots that are standard tool locations rather than a person (the Linuxbrew prefix); matches under them are not reported |
| includeWorkflows? | boolean | Also scan workflows/ for hardcoded absolute paths |
| scaffoldingDirs? | array | Repo-relative directories holding generated agent scaffolding to typecheck |
| denoBin? | string | deno executable used for scaffolding typechecks; falls back to DENO_BIN and ~/.swamp/deno/deno |
| workflowDirs? | array | Repo-relative directories scanned for workflow YAML |
| swampBin? | string | swamp executable used to read live workflow registrations; falls back to SWAMP_BIN |
| serveUrl? | string | swamp serve base URL probed for live schedules at /api/v1/health, then the unauthenticated /health; unreachable is not an error |
Resources
Files
Add workflow-wiring pre-flight checks: inspect referenced scripts for exec bits/shebangs, compare declared workflow schedules with live registration, and report drift in the combined report.
Modified 1 behaviors. updated labels
Document checkScaffolding in the README. No behavior change from 2026.10.21.1.
Add checkScaffolding: typecheck the generated agent scaffolding (.kilo/plugins, .opencode/plugins, .pi/extensions) with deno check and report findings separately from project-owned code. Adds scaffoldingDirs and denoBin global args (both defaulted) and a scaffolding resource. Ported from myswamp 697f65e.
Modified 1 behaviors
Relicense from AGPL-3.0-only to MIT.
Declare license: AGPL-3.0-only in the manifest; no model, workflow, or schema changes.
updated labels
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented0/1missing
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Docs keep secrets in a vault1/1earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License2/2earned
- Verified public repository2/2earned