2825b82a80038a9202571bcfda1e04db67bbbeb5
All three Greptile findings were valid against the code; each is fixed at its cause rather than at the symptom, and each fix is covered by a test that fails when the fix is reverted. **Check could silently write.** `check` was matched only as the first argument, and leftover positional arguments were never inspected. So `docsgen --repo-root .. check` — and any misspelled subcommand — fell through to the write path and overwrote the artifact the check promises not to touch. That is the exact guarantee the mode exists to provide, so the failure was silent and in the wrong direction. Extracted argument handling into a testable `parseOptions` and made a leftover positional argument an error with usage text. Switched the flag set from `ExitOnError` to `ContinueOnError` so the error surfaces as a value rather than a process exit, which is what makes it testable. **Obsolete detection claimed files it does not own.** It treated every sibling `.json` as docsgen's and reported it obsolete, so checking an artifact in a mixed-use directory produced a false stale result, and the documented target layout — which anticipates further named artifacts in `docs/data/generated/` (catalog.json, AsyncAPI output) — would have been reported stale as soon as a second artifact legitimately existed. Ownership is now declared rather than inferred: `generatedArtifacts` maps each directory docsgen owns end-to-end to the names it produces there, and a directory docsgen does not own is never judged. A new unit test pins both halves — the orphan inside an owned directory is still caught, and a foreign `.json` in an arbitrary `--out` directory is not. **Provenance traversal stopped at one level.** Refs were walked only inside the top-level contract schemas, so a definition reachable solely through another definition resolved to "no authoritative definition found" — the diagnostic lying about the code it points at. Replaced the single pass with a breadth-first walk that follows discovered definitions transitively, seeded with every published contract first so a definition reachable from several contracts is attributed to the alphabetically first rather than to whichever the walk happened to reach. `walkSchemaRefs` now iterates map keys in sorted order for the same reason. `schemaProvenance` takes its roots as a parameter, which is what makes the transitive case testable without real types. Verified by mutation: with each fix reverted in turn, its test fails — `parseOptions(["--repo-root" ".." "check"]) returned nil error`, `obsoleteArtifacts() = [...someone-elses.json is obsolete...]`, and `provenance[Leaf] = ""`. Control run passes unmutated, and the file is byte-identical after restoration. Also confirmed end to end that the previously silent invocation now exits non-zero with usage instead of writing, and that the committed artifact is untouched by it. `task check`: exit 0, 0 failures.
Description
Archie connects events from your systems to agents that can investigate, reason, and act.
Define what an event means, map its data into a workflow, and give that workflow an agent equipped for the job: its own execution environment, tools, and identity.
https://archie.catlow.cloud
133 MiB
0 Stars
1 Watchers
0 Forks
Releases
11
Archie v1.62.0
Latest
Languages
Go
76.8%
Vue
13.1%
TypeScript
7.8%
JavaScript
1.2%
Shell
0.6%
Other
0.4%