From 9945290bdd769a2ac2bc4e191818c94f2de0872f Mon Sep 17 00:00:00 2001 From: Jeroen Schweitzer Date: Wed, 6 May 2026 17:47:52 +0200 Subject: [PATCH] wire dart doc into staged CI workflow (T-17) Adds a docs job to .gitea/workflows/test.yml that runs `dart doc --validate-links` and uploads doc/api/ as an artefact. Runs in parallel with unit; documents the public lib/ surface and fails the build on broken references. Stays inert with the rest of the workflow until Gitea Actions activates per D-32. Co-Authored-By: Claude --- .gitea/workflows/test.yml | 14 +++ .pql/pql-plan.json | 252 +++++++++++++++++++++----------------- CHANGELOG.md | 4 + 3 files changed, 158 insertions(+), 112 deletions(-) diff --git a/.gitea/workflows/test.yml b/.gitea/workflows/test.yml index a0055e69..a292681f 100644 --- a/.gitea/workflows/test.yml +++ b/.gitea/workflows/test.yml @@ -69,3 +69,17 @@ jobs: - run: (cd app && flutter pub get) - run: (cd tools/ui && npm install && npx playwright install --with-deps chromium) - run: ci/test_e2e.sh + + docs: + name: dart doc (lib API) + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + - uses: subosito/flutter-action@v2 + with: { channel: stable, cache: true } + - run: dart pub get + - run: dart doc --validate-links + - uses: actions/upload-artifact@v4 + with: + name: dart-api-docs + path: doc/api/ diff --git a/.pql/pql-plan.json b/.pql/pql-plan.json index adb00d01..af3982f5 100644 --- a/.pql/pql-plan.json +++ b/.pql/pql-plan.json @@ -1,5 +1,5 @@ { - "exported_at": "2026-05-06T15:18:24Z", + "exported_at": "2026-05-06T15:47:52Z", "decisions": [ { "id": "D-1", @@ -9,7 +9,7 @@ "status": "active", "date": "2026-04-20", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-3", @@ -19,7 +19,7 @@ "status": "active", "date": "2026-04-20", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-4", @@ -29,7 +29,7 @@ "status": "active", "date": "2026-04-20", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-5", @@ -39,7 +39,7 @@ "status": "active", "date": "2026-04-20", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-6", @@ -49,7 +49,7 @@ "status": "active", "date": "2026-04-20", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-7", @@ -59,7 +59,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-8", @@ -69,7 +69,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-9", @@ -79,7 +79,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-10", @@ -89,7 +89,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-11", @@ -99,7 +99,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-12", @@ -109,7 +109,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-13", @@ -119,7 +119,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-14", @@ -129,7 +129,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-15", @@ -139,7 +139,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/extensions.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-16", @@ -149,7 +149,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/extensions.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-17", @@ -159,7 +159,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/extensions.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-18", @@ -169,7 +169,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/extensions.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-19", @@ -179,7 +179,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/extensions.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-20", @@ -189,7 +189,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/accessibility.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-21", @@ -199,7 +199,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/accessibility.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-22", @@ -209,7 +209,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/accessibility.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-23", @@ -219,7 +219,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/testing.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-24", @@ -229,7 +229,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/testing.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-25", @@ -239,7 +239,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/testing.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-26", @@ -249,7 +249,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/testing.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-27", @@ -259,7 +259,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/testing.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-28", @@ -269,7 +269,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/testing.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-29", @@ -279,7 +279,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/testing.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-30", @@ -289,7 +289,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/testing.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-31", @@ -299,7 +299,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/tooling.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-32", @@ -309,7 +309,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/tooling.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-33", @@ -319,7 +319,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/tooling.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-34", @@ -329,7 +329,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/process.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-35", @@ -339,7 +339,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/process.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-36", @@ -349,7 +349,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/process.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-37", @@ -359,7 +359,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/process.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-38", @@ -369,7 +369,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/process.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-39", @@ -379,7 +379,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/process.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-40", @@ -389,7 +389,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/process.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-41", @@ -399,7 +399,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-42", @@ -409,7 +409,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/tooling.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-43", @@ -419,7 +419,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-44", @@ -429,7 +429,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-45", @@ -439,7 +439,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-46", @@ -449,7 +449,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/extensions.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-47", @@ -459,7 +459,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-48", @@ -469,7 +469,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-49", @@ -479,7 +479,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-50", @@ -489,7 +489,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-51", @@ -499,7 +499,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-52", @@ -509,7 +509,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-53", @@ -519,7 +519,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-54", @@ -529,7 +529,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-55", @@ -539,7 +539,7 @@ "status": "active", "date": "2026-04-23", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-56", @@ -549,7 +549,7 @@ "status": "active", "date": "2026-04-23", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-57", @@ -559,7 +559,7 @@ "status": "active", "date": "2026-04-23", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-58", @@ -569,7 +569,7 @@ "status": "active", "date": "2026-04-23", "file_path": "decisions/tooling.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-59", @@ -579,7 +579,7 @@ "status": "active", "date": "2026-04-25", "file_path": "decisions/tooling.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-60", @@ -589,7 +589,7 @@ "status": "active", "date": "2026-04-26", "file_path": "decisions/tooling.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-61", @@ -599,7 +599,7 @@ "status": "active", "date": "2026-04-26", "file_path": "decisions/tooling.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-62", @@ -609,7 +609,7 @@ "status": "active", "date": "2026-04-26", "file_path": "decisions/tooling.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-63", @@ -619,7 +619,7 @@ "status": "active", "date": "2026-04-26", "file_path": "decisions/tooling.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-64", @@ -629,7 +629,7 @@ "status": "active", "date": "2026-05-03", "file_path": "decisions/architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "D-65", @@ -639,7 +639,7 @@ "status": "active", "date": "2026-04-26", "file_path": "decisions/tooling.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-1", @@ -648,7 +648,7 @@ "title": "Authorisation granularity on the IPC socket", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-2", @@ -657,7 +657,7 @@ "title": "Back-pressure on event streams", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-3", @@ -666,7 +666,7 @@ "title": "Event persistence + audit/undo", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-4", @@ -675,7 +675,7 @@ "title": "`.canvas` schema compatibility with Obsidian", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-5", @@ -684,7 +684,7 @@ "title": "IPC wire-format stability + `schema_version:`", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-6", @@ -693,7 +693,7 @@ "title": "Window chrome — native frame vs frameless custom", "status": "resolved", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-7", @@ -702,7 +702,7 @@ "title": "macOS app bundle signing / notarisation", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-8", @@ -711,7 +711,7 @@ "title": "Extension API shape — widgets, subcommands, both?", "status": "open", "file_path": "decisions/questions-extensions.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-9", @@ -720,7 +720,7 @@ "title": "Lua runtime vendoring", "status": "open", "file_path": "decisions/questions-extensions.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-10", @@ -729,7 +729,7 @@ "title": "Extension manifest `schema_version:`", "status": "open", "file_path": "decisions/questions-extensions.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-11", @@ -738,7 +738,7 @@ "title": "Coverage gates — hard thresholds vs soft reporting", "status": "open", "file_path": "decisions/questions-testing.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-12", @@ -747,7 +747,7 @@ "title": "Screen-reader automation (axe-core via Playwright)", "status": "open", "file_path": "decisions/questions-testing.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-13", @@ -756,7 +756,7 @@ "title": "Web production-mode a11y", "status": "open", "file_path": "decisions/questions-accessibility.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-14", @@ -765,7 +765,7 @@ "title": "i18n plurals / gender / date-format tooling", "status": "open", "file_path": "decisions/questions-accessibility.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-15", @@ -774,7 +774,7 @@ "title": "Editor tab — full LSP vs tree-sitter-only highlight", "status": "open", "file_path": "decisions/questions-process.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-16", @@ -783,7 +783,7 @@ "title": "`tree-sitter-dart` grammar maintenance", "status": "open", "file_path": "decisions/questions-process.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-17", @@ -792,7 +792,7 @@ "title": "Icon set growth", "status": "open", "file_path": "decisions/questions-process.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-18", @@ -801,7 +801,7 @@ "title": "Theme hot-reload in release builds", "status": "open", "file_path": "decisions/questions-process.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-19", @@ -810,7 +810,7 @@ "title": "(withdrawn)", "status": "resolved", "file_path": "decisions/questions-process.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-20", @@ -819,7 +819,7 @@ "title": "Kernel DB service — namespaced SQL access?", "status": "open", "file_path": "decisions/questions-process.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-21", @@ -828,7 +828,7 @@ "title": "Pql absorbs planning vs keeps separate", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-22", @@ -837,7 +837,7 @@ "title": "Ticket persistence strategy", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-23", @@ -846,7 +846,7 @@ "title": "SSH-remote development — run clide against a remote workspace", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-25", @@ -855,7 +855,7 @@ "title": "Body text face — mono everywhere vs Josefin Sans UI + mono code", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-26", @@ -864,7 +864,7 @@ "title": "Small screen layout (\u003c 1000px)", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-27", @@ -873,7 +873,7 @@ "title": "Two-editor split", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-28", @@ -882,7 +882,7 @@ "title": "Terminal strip scope — shell only or logs/errors/tests", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-29", @@ -891,7 +891,7 @@ "title": "Branch picker location", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-30", @@ -900,7 +900,7 @@ "title": "Focus behavior when editor is dirty and viewer is peeked", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "Q-31", @@ -909,7 +909,7 @@ "title": "XWayland fallback for frameless — proper Wayland protocol needed", "status": "open", "file_path": "decisions/questions-architecture.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "R-2", @@ -919,7 +919,7 @@ "status": "active", "date": "2026-04-20", "file_path": "decisions/rejected.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "R-3", @@ -929,7 +929,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/rejected.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "R-4", @@ -939,7 +939,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/rejected.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "R-5", @@ -949,7 +949,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/rejected.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "R-6", @@ -959,7 +959,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/rejected.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "R-7", @@ -969,7 +969,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/rejected.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "R-8", @@ -979,7 +979,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/rejected.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "R-9", @@ -989,7 +989,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/rejected.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "R-10", @@ -999,7 +999,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/rejected.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "R-11", @@ -1009,7 +1009,7 @@ "status": "active", "date": "2026-04-21", "file_path": "decisions/rejected.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" }, { "id": "R-12", @@ -1019,7 +1019,7 @@ "status": "active", "date": "2026-04-22", "file_path": "decisions/rejected.md", - "synced_at": "2026-05-06 15:06:40" + "synced_at": "2026-05-06 15:37:42" } ], "decision_refs": [ @@ -2000,11 +2000,11 @@ "parent_id": "T-8", "title": "add dart doc generation to CI", "description": "Wire `dart doc` into the CI pipeline so the public API surface (everything in lib/*.dart barrel exports) renders to HTML on every push to main.\n\n**Acceptance:**\n- New CI step in `.gitea/workflows/test.yml` runs `dart doc lib/` and uploads the generated `doc/api/` artefact.\n- Documentation comments on public APIs are validated (no broken references); `dart doc --validate-links` part of the run.\n- Generated docs published somewhere browsable — Gitea Pages, GitHub Pages once the repo moves, or an S3-style static host (decision deferred until Gitea actions land per D-32).\n\n**Not in scope:** writing missing docstrings (separate sweep), private-API docs, package.json-style metadata for pub.dev (we never publish to pub.dev — single binary).", - "status": "ready", + "status": "done", "priority": "medium", "decision_ref": "D-32", "created_at": "2026-04-22 13:26:29", - "updated_at": "2026-05-06 15:08:22" + "updated_at": "2026-05-06 15:45:51" }, { "id": "T-18", @@ -2593,10 +2593,10 @@ "type": "task", "title": "ship matching bold weight to restore semantic bold rendering", "description": "Workaround in T-70 / `lib/src/terminal/src/ui/painter.dart` suppresses bold rendering entirely because Flutter`s synthetic bold drifts glyph advance widths and breaks the monospace cell grid. We lose semantic bold (bash prompts, emphasis in TUIs) as a side effect.\n\n**Acceptance:**\n- A bold-weight monospace face ships alongside the regular weight, with verified-equal advance widths at clide`s render size (cell-grid stable on bold).\n- The painter`s `bold: false` override is reverted; bold attributes from terminal escapes render visually bold.\n- Test: render a known-mixed-weight buffer and assert paragraph maxIntrinsicWidth matches the regular-weight measurement (cell drift = 0).\n\n**Options to evaluate:**\n- Re-add JetBrainsMono-Bold.ttf once we`ve verified its advance widths actually equal the Regular file at our cellSize. (We dropped it because the synthetic-bold issue obscured whether the bundled Bold actually matched.)\n- Switch to a variable JetBrainsMono and request a specific weight axis position.\n- Pick a different mono font whose Bold has guaranteed-equal advance (Berkeley Mono, IBM Plex Mono).\n\nLink-back: T-70 is the workaround; this is the proper fix.", - "status": "backlog", + "status": "ready", "priority": "medium", "created_at": "2026-05-05 12:53:21", - "updated_at": "2026-05-06 15:09:20" + "updated_at": "2026-05-06 15:39:53" }, { "id": "T-74", @@ -2724,11 +2724,11 @@ "type": "bug", "title": "kill secondary Claude tmux sessions on tab close and on app shutdown", "description": "D-41 lifecycle contract: \"closing a secondary kills that tmux session\" and \"secondary numbering (-1, -2, ...) resets between clide runs since ephemeral state is lost\" — the second clause only holds if non-primary tmux sessions are reaped on app shutdown.\n\nNeither happens today.\n\n**Gap 1 — tab close is UI-only.** `ClaudeSessionHostState` (lib/builtin/claude/src/claude_session_host.dart:18) builds tabs via MultitabController; closing a secondary just removes the entry. No `tmux kill-session` shellout anywhere in lib/builtin/claude/ or lib/src/pty/ (verified by grep for `kill-session` / `killSession` / `tmux kill`).\n\n**Gap 2 — app shutdown leaks secondaries.** Nothing reaps `clide-claude-\u003crepohash\u003e-N` sessions when the app exits. Repro: spawn two secondaries, quit clide, `tmux -L clide list-sessions` still shows them. Confirmed live: 4 sessions on the clide socket (primary + -1, -2, -3) survived prior runs.\n\n**Acceptance:**\n- Closing a secondary tab in the Claude pane runs `tmux -L clide kill-session -t \u003cname\u003e` for that secondary's session name (use existing `secondarySessionName(repoRoot, n)`).\n- App shutdown enumerates `clide-claude-\u003crepohash\u003e-*` sessions on the clide socket and kills the non-primary ones. Primary is left detached (D-41 explicit).\n- `_nextSecondary` index policy: keep the in-process counter for the running app; cold-start always begins at 1 because secondary sessions are gone.\n- Add a test that exercises the close path and asserts the kill-session command was invoked (mock the tmux runner).\n\n**Out of scope:** primary lifecycle (unchanged — survives shutdown by design), general-purpose terminal panes (no tmux wrapping per D-41), Windows behaviour.", - "status": "in_progress", + "status": "done", "priority": "high", "decision_ref": "D-41", "created_at": "2026-05-06 13:46:07", - "updated_at": "2026-05-06 15:06:40" + "updated_at": "2026-05-06 15:39:53" }, { "id": "T-88", @@ -4222,6 +4222,34 @@ "field": "description", "new_value": "D-59 (bundled git via dugite-native) costs out: \"Must track dugite-native releases for security updates.\" Up to today this lived only in the D-record prose with no tracking — clean-house v1 flagged it as RULE-SUNSET-WITHOUT-TICKET.\n\n**Acceptance:**\n- A periodic check (manual or scheduled) compares the bundled `native/dugite/` SHA against the latest release at https://github.com/desktop/dugite-native/releases.\n- When a new release lands with a CVE label or fixes a CVE-tagged git release, schedule a bump; otherwise track the version drift.\n- Bumps follow D-63: rebuild with the new SHA, update `BUILD.md`, update `assets/licenses.yaml` if the dugite or git version changed, refresh the binary in `native/dugite/`.\n\n**Periodicity:** quarterly check is enough during normal operation; faster on git CVE announcements (subscribe to https://github.com/git/git/security/advisories, https://github.com/desktop/dugite-native/security/advisories).\n\n**Out of scope:** the rebuild itself is T-25 (CI reproducible build for libtree-sitter.so) — same shape applies to dugite. This ticket is the calendar; T-25 is the machine.", "changed_at": "2026-05-06 15:10:35" + }, + { + "ticket_id": "T-17", + "field": "status", + "old_value": "ready", + "new_value": "in_progress", + "changed_at": "2026-05-06 15:39:53" + }, + { + "ticket_id": "T-73", + "field": "status", + "old_value": "backlog", + "new_value": "ready", + "changed_at": "2026-05-06 15:39:53" + }, + { + "ticket_id": "T-87", + "field": "status", + "old_value": "in_progress", + "new_value": "done", + "changed_at": "2026-05-06 15:39:53" + }, + { + "ticket_id": "T-17", + "field": "status", + "old_value": "in_progress", + "new_value": "done", + "changed_at": "2026-05-06 15:45:51" } ] } diff --git a/CHANGELOG.md b/CHANGELOG.md index 9e6c1303..b52a8bd0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -18,6 +18,10 @@ heading, and (b) bumping `pubspec.yaml` `version:` in the same commit. ### Added +- Staged `dart doc` CI job — generates and uploads an HTML API + reference for the public `lib/` surface, with `--validate-links` to + fail the build on broken references. Inert with the rest of the + workflow until Gitea Actions activates. - Mouse wheel scrolling in Claude pane — converts scroll events to PgUp/PgDown so Claude Code (and other TUI apps) scroll their history naturally.