Skip to content

docs(feature-map): add SQL Tracer, fold #563's edits into the sources, fail on a stale page - #570

Merged
huyplb merged 2 commits into
mainfrom
docs/feature-map-tracer
Oct 31, 2026
Merged

huyplb merged 2 commits into
mainfrom
docs/feature-map-tracer

Conversation

@huyplb

@huyplb huyplb commented Oct 31, 2026 •

Copy link
Copy Markdown
Contributor

What

Checks

  • A/B: a one-character hand edit to the page fails the new test, and a rebuild passes it.
  • The page opens in a browser with no console errors, all 11 diagrams render, and the SQL Tracer card shows.
  • tsc, lint and doc-paths.test.ts pass.

🤖 Generated with Claude Code


Note

Low Risk
Documentation and generated HTML only, plus a CI guard test; no runtime product code changes.

Overview
Updates the feature map docs and generated HTML to match main at b12bcd5607: 34 features, 158 routes, 18 server modules, 57 e2e specs (~550 unit tests), plus refreshed system/workflow mermaid diagrams (including app.write / GET reads before workspace scope and the data compare → migrate path with the 2,000-row cap).

Adds utilities.trace (SQL Tracer) to the interactive inventory in docs/feature-map/data.js and rebuilds docs/feature-map.html. Prior hand-edits to the HTML (#563) are moved into data.js (e.g. Redis/MongoDB No password, route/coverage counts, e2e group list) so the next npm run docs:feature-map run does not drop them. FEATURE_MAP.md documents that the HTML must not be edited directly.

feature-map-build.test.ts now asserts the committed page equals buildStaticPage(buildBoardPage(readSources())), failing with a message to run npm run docs:feature-map when stale.

Reviewed by Cursor Bugbot for commit 311396a. Bugbot is set up for automated code reviews on this repo. Configure here.

…urces, fail on a stale page

#563 edited docs/feature-map.html by hand after #567 moved its sources into
docs/feature-map/, so the next `npm run docs:feature-map` would have dropped
those edits, and the page's diagrams were already behind FEATURE_MAP.md.

- data.js: utilities.trace (SQL Tracer, #564); No password for Redis/MongoDB;
  Compare 2,000 rows and the shared migrate cap; force-migrate and
  compare-window e2e; routes, unit-test and e2e-group counts re-measured on
  main b12bcd5 (158 routes, 18 server modules, 57 specs in 35 groups).
- template.html and FEATURE_MAP.md: the same counts; 34 features.
- docs/feature-map.html rebuilt, so it also takes the newer diagrams.
- feature-map-build.test.ts: fails while the committed page differs from the
  build (A/B: a one-character hand edit fails it, a rebuild passes).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Comment thread docs/feature-map/data.js
];

const E2E_GROUPS = ['PostgreSQL', 'MySQL', 'MariaDB', 'SQL Server', 'Oracle', 'DB2', 'SQLite', 'Azure SQL', 'ClickHouse', 'Redshift', 'CockroachDB', 'YugabyteDB', 'TiDB', 'DuckDB', 'Smoke', 'Sign-in', 'One admin or several', 'Workspaces', 'SQL Editor (14 specs)', 'Send feedback', 'Browse', 'History', 'Revert', 'Revert edges', 'Access SQLite', 'Workflow', 'Utilities', 'DB Access', 'Access all', 'Migrations in Git', 'Execute gate', 'Backup & Restore', 'Backup commands'];
const E2E_GROUPS = ['PostgreSQL', 'MySQL', 'MariaDB', 'SQL Server', 'Oracle', 'DB2', 'SQLite', 'Azure SQL', 'ClickHouse', 'Redshift', 'CockroachDB', 'YugabyteDB', 'TiDB', 'DuckDB', 'Smoke', 'Sign-in', 'One admin or several', 'Workspaces', 'Demo role', 'SQL Editor (19 specs)', 'Send feedback', 'Browse', 'History', 'Revert', 'Revert edges', 'Force-migrate', 'Access SQLite', 'Workflow', 'Utilities', 'DB Access', 'Access all', 'Migrations in Git', 'Execute gate', 'Backup & Restore', 'Backup commands'];
@huyplb
huyplb merged commit d72c51c into main Oct 31, 2026
12 checks passed
@huyplb
huyplb deleted the docs/feature-map-tracer branch October 31, 2026 19:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant