Skip to content

Commit e47d1f5

Browse files
docs: refresh fallow.md status snapshot post-PR #41 + drop shipped golden-queries from roadmap.md "Next" (#42)
- fallow.md: stamp 2026-05-02; add a one-liner to 'Adjacent — also shipped post-refresh' for PR #41 (cli/* → application/* engine lift) so the architectural prereq for HTTP serve is tracked. - roadmap.md: golden queries are operational (scripts/query-golden.ts runs in 'bun run check' + CI on every PR) — per docs-governance Rule 2, shipped items leave the forward-looking 'Next' section. Canonical home stays docs/golden-queries.md (referenced from CONTRIBUTING + benchmark.md).
1 parent 0134944 commit e47d1f5

2 files changed

Lines changed: 2 additions & 2 deletions

File tree

docs/research/fallow.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
88
---
99

10-
## Status snapshot (as of 2026-05-01)
10+
## Status snapshot (as of 2026-05-02)
1111

1212
Adoption-candidate ship status. The tier tables in § 1 are preserved as the original assessment record; this snapshot is the single source of truth for "what's open." Update on every PR that closes a row.
1313

@@ -32,6 +32,7 @@ Adoption-candidate ship status. The tier tables in § 1 are preserved as the ori
3232
- **Recipes-as-content registry** — bundled recipes are now `<id>.{sql,md}` file pairs in `templates/recipes/`; project teams ship internal SQL via git-tracked `<projectRoot>/.codemap/recipes/<id>.{sql,md}`. PR [#37](https://github.com/stainless-code/codemap/pull/37). Catalog gains `source` / `body` / `shadows` fields so agents see project overrides at session start; YAML frontmatter actions on `.md` mean project recipes feel first-class. Load-time DML/DDL deny-list + runtime `PRAGMA query_only=1` backstop.
3333
- **Targeted-read CLI**`codemap show <name>` + `codemap snippet <name>` for precise lookup-by-symbol-name without composing SQL. PR [#39](https://github.com/stainless-code/codemap/pull/39). Both verbs share the same flag set (`--kind`, `--in <path>`) and an agent-friendly `{matches, disambiguation?}` envelope; `snippet` adds `source` / `stale` / `missing` per match (read + flag, no auto-reindex side-effects). Registered as MCP tools too — every read verb maps to a tool. PR also shipped defence-in-depth security fixes (LIKE-wildcard escape on `--in`, path-traversal rejection in `agents-init`, non-blocking `bun audit` CI job).
3434
- **Doc-governance Rule 10** added during PR [#29](https://github.com/stainless-code/codemap/pull/29) — every core-surface change must update both `templates/agents/` (ships to npm) and `.agents/` (this clone) in lockstep.
35+
- **`cli/*``application/*` engine lift (internal)** — PR [#41](https://github.com/stainless-code/codemap/pull/41) closed the last layer-reversal imports `application/mcp-server.ts` had on `cli/*` (called out in the PR #35 self-audit). New engines `context-engine` / `validate-engine`; `query-recipes` moved to `application/`; envelope builders + helpers consolidated in `audit-engine` / `show-engine`. Pure refactor — no behavior or public API change — but unblocks the HTTP transport (B-tier `serve`) since that engine reuse is now clean.
3536

3637
**Open-questions resolution** (from § 6 below):
3738

docs/roadmap.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,6 @@ Forward-looking plans only — **not** a mirror of `src/`. **Doc index:** [READM
88

99
- **Community language adapters** — optional packages (e.g. Tree-sitter) with a **peerDependency** on `@stainless-code/codemap` and a public **registration** API beyond built-ins in [`src/adapters/`](../src/adapters/).
1010
- **Agent tooling** — evaluate [TanStack Intent](https://tanstack.com/intent/latest/docs/overview) for versioned skills in `node_modules` (optional; **`codemap agents init`** remains the default).
11-
- **Golden queries** — design & policy: [golden-queries.md](./golden-queries.md); Tier A in CI, Tier B via `CODEMAP_*` (see [benchmark § Fixtures](./benchmark.md#fixtures)).
1211

1312
---
1413

0 commit comments

Comments
 (0)