diff --git a/docs/backlog/181-chore-v06-pr-g-iso-9001-2026-watch-item-t-v06-013.md b/docs/backlog/181-chore-v06-pr-g-iso-9001-2026-watch-item-t-v06-013.md index 8db82864..12eabea7 100644 --- a/docs/backlog/181-chore-v06-pr-g-iso-9001-2026-watch-item-t-v06-013.md +++ b/docs/backlog/181-chore-v06-pr-g-iso-9001-2026-watch-item-t-v06-013.md @@ -7,7 +7,7 @@ title: "chore: ISO 9001:2026 watch item" aliases: - "chore: ISO 9001:2026 watch item" - "chore(v06): PR-G ISO 9001:2026 watch item (T-V06-013)" -state: open +state: closed state_reason: null url: https://github.com/Luis85/agentic-workflow/pull/181 author: Luis85 @@ -16,8 +16,8 @@ labels: milestone: null assignees: [] created_at: 2026-05-02T09:41:04Z -updated_at: 2026-05-14T03:20:44Z -closed_at: null +updated_at: 2026-05-14T09:33:54Z +closed_at: 2026-05-14T09:26:44Z comments_count: 0 events_count: 2 locked: false @@ -25,9 +25,9 @@ feature_slug: null stage: null roadmap_status: planned draft: false -merged: false -merged_at: null -merge_commit_sha: 7fc083a7865fe9f02ef2649b96d324b32063fea9 +merged: true +merged_at: 2026-05-14T09:26:44Z +merge_commit_sha: dbf41c21296833dc1623649b1985df37f47fa0a9 base_ref: develop head_ref: chore/v06-iso-9001-watch review_count: 0 diff --git a/docs/backlog/377-arch-deepening-opportunities-in-scripts-and-sites.md b/docs/backlog/377-arch-deepening-opportunities-in-scripts-and-sites.md index d11ae65b..d0c8f369 100644 --- a/docs/backlog/377-arch-deepening-opportunities-in-scripts-and-sites.md +++ b/docs/backlog/377-arch-deepening-opportunities-in-scripts-and-sites.md @@ -6,8 +6,8 @@ type_locked: false title: "arch: deepening opportunities in scripts/ and sites/ — frontmatter, check-runner, markdown reader" aliases: - "arch: deepening opportunities in scripts/ and sites/ — frontmatter, check-runner, markdown reader" -state: open -state_reason: null +state: closed +state_reason: completed url: https://github.com/Luis85/agentic-workflow/issues/377 author: Luis85 labels: @@ -21,8 +21,8 @@ labels: milestone: null assignees: [] created_at: 2026-05-08T14:40:08Z -updated_at: 2026-05-09T16:51:10Z -closed_at: null +updated_at: 2026-05-14T15:31:56Z +closed_at: 2026-05-14T15:31:56Z comments_count: 1 events_count: 0 locked: false diff --git a/docs/backlog/453-improvement-add-claude-plugin-validate-to-ci-pipeline.md b/docs/backlog/453-improvement-add-claude-plugin-validate-to-ci-pipeline.md index 6942d5ee..827b2961 100644 --- a/docs/backlog/453-improvement-add-claude-plugin-validate-to-ci-pipeline.md +++ b/docs/backlog/453-improvement-add-claude-plugin-validate-to-ci-pipeline.md @@ -6,8 +6,8 @@ type_locked: false title: "improvement: add claude plugin validate to CI pipeline" aliases: - "improvement: add claude plugin validate to CI pipeline" -state: open -state_reason: null +state: closed +state_reason: completed url: https://github.com/Luis85/agentic-workflow/issues/453 author: Luis85 labels: @@ -19,8 +19,8 @@ labels: milestone: null assignees: [] created_at: 2026-05-09T23:00:50Z -updated_at: 2026-05-09T23:03:03Z -closed_at: null +updated_at: 2026-05-14T10:29:11Z +closed_at: 2026-05-14T10:29:11Z comments_count: 0 events_count: 0 locked: false diff --git a/docs/backlog/490-chore-deps-bump-octokit-rest-from-21-1-1-to-22-0-1.md b/docs/backlog/490-chore-deps-bump-octokit-rest-from-21-1-1-to-22-0-1.md index 16d59ead..49275475 100644 --- a/docs/backlog/490-chore-deps-bump-octokit-rest-from-21-1-1-to-22-0-1.md +++ b/docs/backlog/490-chore-deps-bump-octokit-rest-from-21-1-1-to-22-0-1.md @@ -81,7 +81,7 @@ Bumps [@octokit/rest](https://github.com/octokit/rest.js) from 21.1.1 to 22.0.1.
  • c04acc8 chore(deps): update vitest monorepo to v4 (major) (#536)
  • e6dd306 chore(deps): update dependency undici to v7 ([[474-redesign-claude-code-plugin-install-flow-to-support]])
  • 5f380d0 build(deps-dev): Bump form-data from 4.0.2 to 4.0.4 in /docs (#520)
  • -
  • dc6827d build(deps-dev): Bump tar-fs from 2.1.2 to 2.1.3 in /docs (#516)
  • +
  • dc6827d build(deps-dev): Bump tar-fs from 2.1.2 to 2.1.3 in /docs ([[516-feat-add-check-registry-and-migrate-frontmatter-markdown]])
  • 77530ab fix(deps): update octokit monorepo (major) ([[504-fix-site-make-docs-backlog-the-default-feature-tracker]])
  • d07b719 build(deps): Bump vite from 6.2.5 to 6.3.4 ([[509-fix-ci-fix-pages-yml-trigger-main-paths-add-workflow-call]])
  • Additional commits viewable in compare view
  • diff --git a/docs/backlog/491-research-publishing-audit-redesign-publishing-pipeline-npm.md b/docs/backlog/491-research-publishing-audit-redesign-publishing-pipeline-npm.md index 2cacce84..ed8a72d5 100644 --- a/docs/backlog/491-research-publishing-audit-redesign-publishing-pipeline-npm.md +++ b/docs/backlog/491-research-publishing-audit-redesign-publishing-pipeline-npm.md @@ -6,8 +6,8 @@ type_locked: false title: "research(publishing): audit & redesign publishing pipeline — npm · Claude plugin · product page" aliases: - "research(publishing): audit & redesign publishing pipeline — npm · Claude plugin · product page" -state: open -state_reason: null +state: closed +state_reason: completed url: https://github.com/Luis85/agentic-workflow/issues/491 author: Luis85 labels: @@ -19,8 +19,8 @@ labels: milestone: null assignees: [] created_at: 2026-05-11T12:29:47Z -updated_at: 2026-05-11T12:32:40Z -closed_at: null +updated_at: 2026-05-14T10:20:20Z +closed_at: 2026-05-14T10:20:20Z comments_count: 0 events_count: 0 locked: false diff --git a/docs/backlog/496-fix-site-update-feature-tracker-ts-defaultissuesdir-after.md b/docs/backlog/496-fix-site-update-feature-tracker-ts-defaultissuesdir-after.md index 7fb857b0..07da53f6 100644 --- a/docs/backlog/496-fix-site-update-feature-tracker-ts-defaultissuesdir-after.md +++ b/docs/backlog/496-fix-site-update-feature-tracker-ts-defaultissuesdir-after.md @@ -6,8 +6,8 @@ type_locked: false title: "fix(site): update feature-tracker.ts defaultIssuesDir after issues/ consolidation" aliases: - "fix(site): update feature-tracker.ts defaultIssuesDir after issues/ consolidation" -state: open -state_reason: null +state: closed +state_reason: completed url: https://github.com/Luis85/agentic-workflow/issues/496 author: Luis85 labels: @@ -18,8 +18,8 @@ labels: milestone: null assignees: [] created_at: 2026-05-11T21:34:16Z -updated_at: 2026-05-13T21:07:26Z -closed_at: null +updated_at: 2026-05-14T10:07:07Z +closed_at: 2026-05-14T10:07:07Z comments_count: 0 events_count: 0 locked: false diff --git a/docs/backlog/500-chore-backlog-sync-issues-and-pull-requests.md b/docs/backlog/500-chore-backlog-sync-issues-and-pull-requests.md index fff3a9bb..8b7b41dc 100644 --- a/docs/backlog/500-chore-backlog-sync-issues-and-pull-requests.md +++ b/docs/backlog/500-chore-backlog-sync-issues-and-pull-requests.md @@ -6,7 +6,7 @@ type_locked: false title: "chore(backlog): sync issues and pull requests" aliases: - "chore(backlog): sync issues and pull requests" -state: open +state: closed state_reason: null url: https://github.com/Luis85/agentic-workflow/pull/500 author: Luis85 @@ -14,8 +14,8 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-12T21:10:56Z -updated_at: 2026-05-14T04:06:16Z -closed_at: null +updated_at: 2026-05-14T11:29:47Z +closed_at: 2026-05-14T11:29:44Z comments_count: 0 events_count: 0 locked: false @@ -23,9 +23,9 @@ feature_slug: null stage: null roadmap_status: planned draft: false -merged: false -merged_at: null -merge_commit_sha: 0efe385d10e84cbbb997fbf40f705e8f4514de5d +merged: true +merged_at: 2026-05-14T11:29:44Z +merge_commit_sha: 33dee4608c1d486f205b851402dccd3ce99f1389 base_ref: develop head_ref: automation/backlog-sync review_count: null diff --git a/docs/backlog/503-feat-ooda-stages-1-5-ooda-loop-plugin-idea-research.md b/docs/backlog/503-feat-ooda-stages-1-5-ooda-loop-plugin-idea-research.md index dfab0e9f..c7269a15 100644 --- a/docs/backlog/503-feat-ooda-stages-1-5-ooda-loop-plugin-idea-research.md +++ b/docs/backlog/503-feat-ooda-stages-1-5-ooda-loop-plugin-idea-research.md @@ -14,7 +14,7 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:13:07Z -updated_at: 2026-05-14T04:04:26Z +updated_at: 2026-05-14T12:37:19Z closed_at: null comments_count: 0 events_count: 0 @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: 5d4057a6c8b91df20b09d367e6dbedc1bba69583 +merge_commit_sha: c71c2c2bf440e87457b2b455135b99b20277bc50 base_ref: develop head_ref: claude/create-plugin-concept-issues-TeFk9 review_count: null diff --git a/docs/backlog/504-fix-site-make-docs-backlog-the-default-feature-tracker.md b/docs/backlog/504-fix-site-make-docs-backlog-the-default-feature-tracker.md index abb2875e..2ff074ef 100644 --- a/docs/backlog/504-fix-site-make-docs-backlog-the-default-feature-tracker.md +++ b/docs/backlog/504-fix-site-make-docs-backlog-the-default-feature-tracker.md @@ -6,7 +6,7 @@ type_locked: false title: "fix(site): make docs/backlog/ the default feature-tracker source (#496)" aliases: - "fix(site): make docs/backlog/ the default feature-tracker source (#496)" -state: open +state: closed state_reason: null url: https://github.com/Luis85/agentic-workflow/pull/504 author: Luis85 @@ -14,8 +14,8 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:24:34Z -updated_at: 2026-05-14T03:23:55Z -closed_at: null +updated_at: 2026-05-14T10:07:08Z +closed_at: 2026-05-14T10:07:06Z comments_count: 0 events_count: 0 locked: false @@ -23,9 +23,9 @@ feature_slug: null stage: null roadmap_status: planned draft: false -merged: false -merged_at: null -merge_commit_sha: 074a826493de43cea5bb48541973e0795aa2cfc9 +merged: true +merged_at: 2026-05-14T10:07:06Z +merge_commit_sha: 6c73898ba19ccdb6a49b4832718b2efb09a62bbf base_ref: develop head_ref: claude/triage-github-issues-x6zn1 review_count: null diff --git a/docs/backlog/505-feat-ci-add-claude-plugin-validate-step-453.md b/docs/backlog/505-feat-ci-add-claude-plugin-validate-step-453.md index 4dbfb6aa..05f6490a 100644 --- a/docs/backlog/505-feat-ci-add-claude-plugin-validate-step-453.md +++ b/docs/backlog/505-feat-ci-add-claude-plugin-validate-step-453.md @@ -6,7 +6,7 @@ type_locked: false title: "feat(ci): add claude plugin validate step (#453)" aliases: - "feat(ci): add claude plugin validate step (#453)" -state: open +state: closed state_reason: null url: https://github.com/Luis85/agentic-workflow/pull/505 author: Luis85 @@ -14,8 +14,8 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:31:37Z -updated_at: 2026-05-14T03:21:27Z -closed_at: null +updated_at: 2026-05-14T10:29:12Z +closed_at: 2026-05-14T10:29:10Z comments_count: 0 events_count: 0 locked: false @@ -23,9 +23,9 @@ feature_slug: null stage: null roadmap_status: planned draft: false -merged: false -merged_at: null -merge_commit_sha: b61fe5220683d90f3dd7246c7dad158d27d3ee1b +merged: true +merged_at: 2026-05-14T10:29:10Z +merge_commit_sha: 2683b6366e04a722f4f7e3c2f51a7e21bec44de2 base_ref: develop head_ref: feat/p1-ci-plugin-validate review_count: null diff --git a/docs/backlog/506-feat-plugin-expose-specorator-scripts-via-bin-449.md b/docs/backlog/506-feat-plugin-expose-specorator-scripts-via-bin-449.md index ce03e9d4..3a109029 100644 --- a/docs/backlog/506-feat-plugin-expose-specorator-scripts-via-bin-449.md +++ b/docs/backlog/506-feat-plugin-expose-specorator-scripts-via-bin-449.md @@ -14,7 +14,7 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:34:08Z -updated_at: 2026-05-14T03:23:51Z +updated_at: 2026-05-14T16:17:59Z closed_at: null comments_count: 0 events_count: 0 @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: e5563e6e344e5516f2ceed1d5f0287f8b5a72d3a +merge_commit_sha: 6b5a9b5569018e6fe2ebcb8f26f73a9553bcb1a4 base_ref: develop head_ref: feat/p1-plugin-bin-scripts review_count: null diff --git a/docs/backlog/507-feat-plugin-add-hooks-json-settings-json-extend-validator.md b/docs/backlog/507-feat-plugin-add-hooks-json-settings-json-extend-validator.md index f389b2aa..b978520d 100644 --- a/docs/backlog/507-feat-plugin-add-hooks-json-settings-json-extend-validator.md +++ b/docs/backlog/507-feat-plugin-add-hooks-json-settings-json-extend-validator.md @@ -14,7 +14,7 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:38:25Z -updated_at: 2026-05-14T03:24:20Z +updated_at: 2026-05-14T16:20:46Z closed_at: null comments_count: 0 events_count: 0 @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: 5f2b1248fe89967a2a9dba313ed2894cc7754d0f +merge_commit_sha: 8a3f1d11dcb44bf3f2e114a19cec090ac25d5bfb base_ref: develop head_ref: feat/p1-plugin-foundations review_count: null diff --git a/docs/backlog/508-feat-orch-orchestrator-first-plugin-spec-idea-research.md b/docs/backlog/508-feat-orch-orchestrator-first-plugin-spec-idea-research.md index 3ba1b489..a46d20cd 100644 --- a/docs/backlog/508-feat-orch-orchestrator-first-plugin-spec-idea-research.md +++ b/docs/backlog/508-feat-orch-orchestrator-first-plugin-spec-idea-research.md @@ -14,7 +14,7 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:38:42Z -updated_at: 2026-05-14T03:24:52Z +updated_at: 2026-05-14T12:29:46Z closed_at: null comments_count: 0 events_count: 0 @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: feedb366c635fdc085fb6945acc7e643abba2474 +merge_commit_sha: cbe17187730950672df8afa84745e57b56a10980 base_ref: develop head_ref: claude/issue-501-JM4TJ review_count: null diff --git a/docs/backlog/509-fix-ci-fix-pages-yml-trigger-main-paths-add-workflow-call.md b/docs/backlog/509-fix-ci-fix-pages-yml-trigger-main-paths-add-workflow-call.md index f7945c92..90fa932e 100644 --- a/docs/backlog/509-fix-ci-fix-pages-yml-trigger-main-paths-add-workflow-call.md +++ b/docs/backlog/509-fix-ci-fix-pages-yml-trigger-main-paths-add-workflow-call.md @@ -6,7 +6,7 @@ type_locked: false title: "fix(ci): fix pages.yml trigger — main+paths, add workflow_call (#491)" aliases: - "fix(ci): fix pages.yml trigger — main+paths, add workflow_call (#491)" -state: open +state: closed state_reason: null url: https://github.com/Luis85/agentic-workflow/pull/509 author: Luis85 @@ -14,8 +14,8 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:40:58Z -updated_at: 2026-05-14T03:27:56Z -closed_at: null +updated_at: 2026-05-14T10:20:21Z +closed_at: 2026-05-14T10:20:18Z comments_count: 0 events_count: 0 locked: false @@ -23,9 +23,9 @@ feature_slug: null stage: null roadmap_status: planned draft: false -merged: false -merged_at: null -merge_commit_sha: aed5f967e2c6d4c8c9a472eef64ea10de681c504 +merged: true +merged_at: 2026-05-14T10:20:18Z +merge_commit_sha: 34ccffa784efda768a22166d470d5cef2bf2ee15 base_ref: develop head_ref: feat/p1-pages-trigger-fix review_count: null diff --git a/docs/backlog/510-feat-scripts-generate-plugin-schema-json-from-manifest-md.md b/docs/backlog/510-feat-scripts-generate-plugin-schema-json-from-manifest-md.md index cda34fe8..2535b2d0 100644 --- a/docs/backlog/510-feat-scripts-generate-plugin-schema-json-from-manifest-md.md +++ b/docs/backlog/510-feat-scripts-generate-plugin-schema-json-from-manifest-md.md @@ -14,7 +14,7 @@ labels: [] milestone: null assignees: [] created_at: 2026-05-13T21:42:29Z -updated_at: 2026-05-14T03:22:15Z +updated_at: 2026-05-14T17:29:39Z closed_at: null comments_count: 0 events_count: 0 @@ -25,7 +25,7 @@ roadmap_status: planned draft: false merged: false merged_at: null -merge_commit_sha: 95cd4e5ba4fe2e3d2259043965ec0a20d43dc40c +merge_commit_sha: 4fdcd3e7976f3be9e5b2e429cc4748ecd60248da base_ref: develop head_ref: feat/p1-schema-generation review_count: null diff --git a/docs/backlog/511-docs-v06-close-out-stages-8-10-test-review-release-prep-for.md b/docs/backlog/511-docs-v06-close-out-stages-8-10-test-review-release-prep-for.md new file mode 100644 index 00000000..1bf53ca1 --- /dev/null +++ b/docs/backlog/511-docs-v06-close-out-stages-8-10-test-review-release-prep-for.md @@ -0,0 +1,72 @@ +--- +number: 511 +kind: pull-request +type: pull-request +type_locked: false +title: "docs(v06): close out stages 8-10 — test, review, release prep for v0.8.1" +aliases: + - "docs(v06): close out stages 8-10 — test, review, release prep for v0.8.1" +state: open +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/511 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T11:18:53Z +updated_at: 2026-05-14T16:20:34Z +closed_at: null +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: planned +draft: false +merged: false +merged_at: null +merge_commit_sha: ecc28a04a0e2a9f84b7e3b830bcbde873d07dd3f +base_ref: develop +head_ref: feat/v081-release-readiness +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/planned +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/511 + +## Summary + +- Closes out the `version-0-6-plan` workflow Stages 8–10 for v0.8.1 consolidation patch prep +- **Stage 8 (Testing):** `test-plan.md` + `test-report.md` — 10/12 REQs pass; REQ-V06-010 deferred (PR-H), REQ-V06-011 partial (ISO watch-item S3); `npm run verify` green +- **Stage 9 (Review):** `traceability.md` + `review.md` — Verdict: **Approved with conditions** (3 S3/S4, no S1/S2); all conditions resolved or tracked +- **Stage 10 (Release, prepare):** `release-notes.md` targeting v0.8.1, `CHANGELOG.md` updated; `workflow-state.md` advanced to `learning`; PR-D scope-cut corrected; no tag/publish yet + +## What changes + +- `specs/version-0-6-plan/test-plan.md` — new +- `specs/version-0-6-plan/test-report.md` — new +- `specs/version-0-6-plan/traceability.md` — new +- `specs/version-0-6-plan/review.md` — new +- `specs/version-0-6-plan/release-notes.md` — new (v0.8.1 target) +- `specs/version-0-6-plan/implementation-log.md` — T-V06-013 entry backfilled +- `specs/version-0-6-plan/workflow-state.md` — advanced to `learning`, PR-D corrected, `implementation-log.md` marked complete +- `CHANGELOG.md` — v0.8.1 entry added + +## No irreversible actions + +Tag, npm publish, and GitHub Release are **not** done here. Those require explicit human authorisation. + +## Test plan + +- [x] `npm run verify` — green (119.4s) +- [ ] Human review of release-notes.md targeting v0.8.1 + +🤖 Generated with [Claude Code](https://claude.com/claude-code) diff --git a/docs/backlog/512-feat-positioning-evidence-first-public-copy-for-v0-8-1-t.md b/docs/backlog/512-feat-positioning-evidence-first-public-copy-for-v0-8-1-t.md new file mode 100644 index 00000000..afac924f --- /dev/null +++ b/docs/backlog/512-feat-positioning-evidence-first-public-copy-for-v0-8-1-t.md @@ -0,0 +1,69 @@ +--- +number: 512 +kind: pull-request +type: pull-request +type_locked: false +title: "feat(positioning): evidence-first public copy for v0.8.1 (T-V06-012)" +aliases: + - "feat(positioning): evidence-first public copy for v0.8.1 (T-V06-012)" +state: open +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/512 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T11:23:51Z +updated_at: 2026-05-14T16:18:59Z +closed_at: null +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: planned +draft: false +merged: false +merged_at: null +merge_commit_sha: 690d03999f70455aeaef75032ca32decfbd036b8 +base_ref: develop +head_ref: feat/v081-product-page +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/planned +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/512 + +## Summary + +Closes T-V06-012 (SPEC-V06-007 — evidence-first public positioning). Updates product page and README with evidence-backed claims for work shipped in the v0.6 plan. + +- **Product page lead** (`sites/src/pages/index.astro`): updated from generic workflow description to cite live verified examples, cross-tool adapters (Copilot/Codex/Cursor), adoption profiles, and OWASP-aligned agentic security review path +- **README "What You Get"**: four new bullet points linking to the shipped artifacts (`examples/`, `docs/adapters.md`, `docs/adoption-profiles/`, `docs/agentic-security-review.md`) +- **README Roadmap**: v0.6 marked Done; v0.8.1 entry added as in-progress consolidation patch + +## What is intentionally absent + +Hook-pack positioning omitted per scope-cut verdict (PR-D/T-V06-008/009 shipped advisory but public claims wait for v0.7 per `workflow-state.md` note from 2026-05-02). + +## Traceability + +- Satisfies: REQ-V06-010 (SPEC-V06-007), NFR-V06-005 +- Closes: FINDING-V06-002 from `specs/version-0-6-plan/review.md` + +## Test plan + +- [x] `npm run verify` — green (114.2s) +- [x] `npm run sites:build` — green (7.36s, 1 page built) +- [x] Product page lead updated and evidence-backed (no unsupported claims) +- [x] Hook-pack claims absent + +🤖 Generated with [Claude Code](https://claude.com/claude-code) diff --git a/docs/backlog/513-refactor-split-repo-ts-into-paths-ts-fs-md-ts-focused.md b/docs/backlog/513-refactor-split-repo-ts-into-paths-ts-fs-md-ts-focused.md new file mode 100644 index 00000000..25129cc3 --- /dev/null +++ b/docs/backlog/513-refactor-split-repo-ts-into-paths-ts-fs-md-ts-focused.md @@ -0,0 +1,63 @@ +--- +number: 513 +kind: pull-request +type: pull-request +type_locked: false +title: "refactor: split repo.ts into paths.ts + fs-md.ts focused modules" +aliases: + - "refactor: split repo.ts into paths.ts + fs-md.ts focused modules" +state: closed +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/513 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T12:31:29Z +updated_at: 2026-05-14T12:41:20Z +closed_at: 2026-05-14T12:41:18Z +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: shipped +draft: false +merged: true +merged_at: 2026-05-14T12:41:18Z +merge_commit_sha: 19dbea1ca07a4da28a2c05fed2334a1c31c8872e +base_ref: develop +head_ref: refactor/issue-377-repo-split +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/shipped +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/513 + +## Summary +- Creates `scripts/lib/paths.ts` with path helpers (`toPosix`, `findRepoRoot`) +- Creates `scripts/lib/fs-md.ts` with fs helpers (`readText`, `writeText`, `replaceGeneratedBlock`) +- Moves `failIfErrors` from `repo.ts` to `diagnostics.ts` where it logically belongs (all its dependencies are already there) +- Reduces `repo.ts` to backward-compat barrel + inline `repoRoot`/`relativeToRoot`/`walkFiles`/`markdownFiles`/frontmatter/YAML helpers +- Regenerates `docs/scripts/` to reflect new module structure +- Imports become self-documenting; no behavior change — all existing callers continue to work via barrel re-exports + +## Triage +- **Type:** refactor +- **Priority:** normal +- Part of [[377-arch-deepening-opportunities-in-scripts-and-sites]] + +## Test plan +- [x] `npx tsc -p tsconfig.scripts.json --noEmit` — clean (no circular deps) +- [x] `check:cli-contract` — passes (`SPECORATOR_ROOT` and `findRepoRoot` remain visible in `repo.ts` source) +- [x] `npm run verify` — green (all 518 tests pass, all checks pass) + +🤖 Implemented via issue-377 plan diff --git a/docs/backlog/514-refactor-add-parsemarkdown-seam-consolidate-link-heading.md b/docs/backlog/514-refactor-add-parsemarkdown-seam-consolidate-link-heading.md new file mode 100644 index 00000000..1b2a1260 --- /dev/null +++ b/docs/backlog/514-refactor-add-parsemarkdown-seam-consolidate-link-heading.md @@ -0,0 +1,57 @@ +--- +number: 514 +kind: pull-request +type: pull-request +type_locked: false +title: "refactor: add parseMarkdown seam — consolidate link/heading extraction" +aliases: + - "refactor: add parseMarkdown seam — consolidate link/heading extraction" +state: closed +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/514 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T12:32:31Z +updated_at: 2026-05-14T12:43:58Z +closed_at: 2026-05-14T12:43:56Z +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: shipped +draft: false +merged: true +merged_at: 2026-05-14T12:43:56Z +merge_commit_sha: e8371b792ed8da9258129bb205023168247dc6e6 +base_ref: develop +head_ref: refactor/issue-377-markdown-seam +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/shipped +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/514 + +## Summary +- Introduces `scripts/lib/markdown-parser.ts` with `parseMarkdown(text) → MarkdownDoc` +- Refactors `markdown-links.ts` `collectAnchors` to use `parseMarkdown` (removes duplicate heading-regex loop) +- Refactors `quality-metrics.ts` `collectEarsCoverage` to use `parseMarkdown(text).body` (strips frontmatter before scanning, preventing YAML key-name false matches) +- Adds `tests/scripts/markdown-parser.test.ts` with 11 tests — unit coverage + live consumer verification for both production consumers +- Regenerates `docs/scripts/` for the new module + +## Triage +- **Type:** refactor +- **Priority:** normal +- Part of [[377-arch-deepening-opportunities-in-scripts-and-sites]] + +🤖 Implemented via issue-377 plan diff --git a/docs/backlog/515-refactor-introduce-typed-artifact-reader-backed-by-zod.md b/docs/backlog/515-refactor-introduce-typed-artifact-reader-backed-by-zod.md new file mode 100644 index 00000000..44c42711 --- /dev/null +++ b/docs/backlog/515-refactor-introduce-typed-artifact-reader-backed-by-zod.md @@ -0,0 +1,83 @@ +--- +number: 515 +kind: pull-request +type: pull-request +type_locked: false +title: "refactor: introduce typed artifact reader backed by Zod schemas" +aliases: + - "refactor: introduce typed artifact reader backed by Zod schemas" +state: closed +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/515 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T13:15:05Z +updated_at: 2026-05-14T16:27:20Z +closed_at: 2026-05-14T16:27:16Z +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: shipped +draft: false +merged: true +merged_at: 2026-05-14T16:27:16Z +merge_commit_sha: b54f074cccb010df2e130d2a2d8275491b05d6db +base_ref: develop +head_ref: refactor/issue-377-artifact-reader +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/shipped +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/515 + +## Summary + +- Introduces `scripts/lib/artifact-reader.ts` with `readArtifact` and `readArtifactOrNull` — the typed seam mandated by ADR-0042 +- Migrates 12 `extractFrontmatter` / `parseSimpleYaml` call-sites to the new API with co-located Zod schemas +- Marks `extractFrontmatter` and `parseSimpleYaml` as `@internal` in `repo.ts`; `check-claude-plugin.ts` carries a documented exception (`// @internal: parsing raw text snippet — readArtifact does not apply`) +- Adds 8 unit tests in `tests/scripts/artifact-reader.test.ts` covering the happy path, ZodError on invalid data, and null/throw behaviour for missing files +- Installs `zod@^4` as a runtime dependency (ADR-0023 approved Zod as runtime validator) + +## Consumers migrated + +| File | Schema | Notes | +|---|---|---| +| `scripts/lib/adr.ts` | `AdrFrontmatterSchema` | file-based | +| `scripts/check-token-budget.ts` | `SkillFrontmatterSchema` | `description: z.unknown()` (block-scalar) | +| `scripts/check-backlog.ts` | `BacklogRawSchema` (passthrough) | passes raw to full YAML parser | +| `scripts/sync-backlog.ts` | `BacklogRawSchema` (passthrough) | same | +| `scripts/lib/release-package-contract.ts` | `DocStubFrontmatterSchema` | file-based | +| `scripts/lib/release-stubify.ts` | `StubifyFrontmatterSchema` | text-based; `schema.parse()` only | +| `scripts/lib/obsidian.ts` | `ObsidianFrontmatterSchema` (passthrough) | raw content validated separately | +| `scripts/lib/roadmaps.ts` | `RoadmapStateFrontmatterSchema` + evidence schemas | file-based | +| `scripts/lib/traceability.ts` | `TraceabilityStateFrontmatterSchema` + artifact schema | text-based | +| `scripts/lib/spec-state.ts` | `WorkflowStateFrontmatterSchema` | text-based | +| `scripts/lib/agent-artifacts.ts` | `AgentFrontmatterSchema`, `SkillFrontmatterSchema` | file-based | +| `scripts/lib/quality-metrics.ts` | `WorkflowStateFrontmatterSchema` | file-based | +| `scripts/check-frontmatter.ts` | `AnyFrontmatterSchema` (passthrough) | dynamic key checking | + +## Test plan + +- [x] `npm run verify` green (537/537 tests, lint, typecheck, all checks) +- [x] Unit tests: `readArtifact` valid, `readArtifact` ZodError, `readArtifact` missing file, `readArtifactOrNull` null on missing, `readArtifactOrNull` returns data, `readArtifactOrNull` throws on invalid, no frontmatter + required field, no frontmatter + all optional +- [x] Branch pushed from worktree `.worktrees/issue-377-artifact-reader` + +## References + +- Closes part of [[377-arch-deepening-opportunities-in-scripts-and-sites]] +- Implements ADR-0042 (typed artifact reader seam) +- ADR-0023 (Zod as runtime validator) + +🤖 Generated with [Claude Code](https://claude.com/claude-code) diff --git a/docs/backlog/516-feat-add-check-registry-and-migrate-frontmatter-markdown.md b/docs/backlog/516-feat-add-check-registry-and-migrate-frontmatter-markdown.md new file mode 100644 index 00000000..e7726757 --- /dev/null +++ b/docs/backlog/516-feat-add-check-registry-and-migrate-frontmatter-markdown.md @@ -0,0 +1,58 @@ +--- +number: 516 +kind: pull-request +type: pull-request +type_locked: false +title: "feat: add Check registry and migrate frontmatter/markdown-link checks" +aliases: + - "feat: add Check registry and migrate frontmatter/markdown-link checks" +state: closed +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/516 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T14:54:25Z +updated_at: 2026-05-14T16:37:35Z +closed_at: 2026-05-14T16:37:33Z +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: shipped +draft: false +merged: true +merged_at: 2026-05-14T16:37:33Z +merge_commit_sha: 04259ca36da39edc5c5e8be9fefc722e3d0ec78d +base_ref: develop +head_ref: feat/issue-377-check-runner +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/shipped +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/516 + +## Summary +- Introduces `Check` interface (`id`, `match(file): boolean`, `run(ctx): Promise`) in `scripts/lib/check-contract.ts` +- Adds `registry: Check[]` + `registerCheck()` to `scripts/lib/tasks.ts` — all 5 existing exports preserved +- Rewrites `scripts/lib/changed-checks.ts` to derive run-set from registry (no hardcoded paths) +- Migrates `check-frontmatter.ts` and `check-markdown-links.ts` as first 2 live adapters +- CLI entry-point guard prevents side-effects when imported by registry consumers + +## Triage +- **Type:** enhancement / refactor +- **Priority:** normal (Wave 3 of issue [[377-arch-deepening-opportunities-in-scripts-and-sites]]) + +Partial implementation of [[377-arch-deepening-opportunities-in-scripts-and-sites]] (Wave 3 — check-runner seam) + +🤖 Resolved via `/issue:tackle 377` Wave 3 diff --git a/docs/backlog/517-refactor-extract-analyzeartifact-shared-core-from-quality.md b/docs/backlog/517-refactor-extract-analyzeartifact-shared-core-from-quality.md new file mode 100644 index 00000000..e2e9b8ad --- /dev/null +++ b/docs/backlog/517-refactor-extract-analyzeartifact-shared-core-from-quality.md @@ -0,0 +1,57 @@ +--- +number: 517 +kind: pull-request +type: pull-request +type_locked: false +title: "refactor: extract analyzeArtifact shared core from quality-metrics and release-readiness" +aliases: + - "refactor: extract analyzeArtifact shared core from quality-metrics and release-readiness" +state: closed +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/517 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T14:54:31Z +updated_at: 2026-05-14T16:59:24Z +closed_at: 2026-05-14T16:59:21Z +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: shipped +draft: false +merged: true +merged_at: 2026-05-14T16:59:21Z +merge_commit_sha: 73e63f2733654aeb25a68efddfeba584c9cf6c65 +base_ref: develop +head_ref: refactor/issue-377-artifact-analysis +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/shipped +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/517 + +## Summary +- Creates `scripts/lib/artifact-analysis.ts` with `analyzeArtifact(filePath): ArtifactReport | null` shared core +- `quality-metrics.ts` uses `hasFrontmatter()` from shared module (eliminates `safeExtractFrontmatter`) +- `release-readiness.ts` gains `analyzeReleaseNotesArtifact()` as second consumer stub (wiring tracked via TODO) +- `completenessScore` uses 0–100 range (DoD said 0.0–1.0; 0–100 chosen for readability — documented in JSDoc) + +## Triage +- **Type:** refactor +- **Priority:** normal (Wave 3 of issue [[377-arch-deepening-opportunities-in-scripts-and-sites]]) + +Partial implementation of [[377-arch-deepening-opportunities-in-scripts-and-sites]] (Wave 3 — artifact-analysis merge) + +🤖 Resolved via `/issue:tackle 377` Wave 3 diff --git a/docs/backlog/518-refactor-extract-shared-parsefrontmatter-for-astro-content.md b/docs/backlog/518-refactor-extract-shared-parsefrontmatter-for-astro-content.md new file mode 100644 index 00000000..554c3cf0 --- /dev/null +++ b/docs/backlog/518-refactor-extract-shared-parsefrontmatter-for-astro-content.md @@ -0,0 +1,61 @@ +--- +number: 518 +kind: pull-request +type: pull-request +type_locked: false +title: "refactor: extract shared parseFrontmatter for Astro content loaders" +aliases: + - "refactor: extract shared parseFrontmatter for Astro content loaders" +state: closed +state_reason: null +url: https://github.com/Luis85/agentic-workflow/pull/518 +author: Luis85 +labels: [] +milestone: null +assignees: [] +created_at: 2026-05-14T14:54:37Z +updated_at: 2026-05-14T15:31:57Z +closed_at: 2026-05-14T15:31:55Z +comments_count: 0 +events_count: 0 +locked: false +feature_slug: null +stage: null +roadmap_status: shipped +draft: false +merged: true +merged_at: 2026-05-14T15:31:55Z +merge_commit_sha: e861f6846fcab071c4028fdd6786017e8a6be97d +base_ref: develop +head_ref: refactor/issue-377-sites-loader +review_count: null +review_comments_count: null +commit_count: null +changed_files: null +additions: null +deletions: null +tags: + - kind/pull-request + - type/pull-request + - status/shipped +--- + +Source: https://github.com/Luis85/agentic-workflow/pull/518 + +## Summary +- Creates `sites/src/content/loaders/parse-frontmatter.ts` — self-contained, no `scripts/lib` imports +- Consolidates inline `parseFrontmatter` from `adr-loader.ts`, `glossary-loader.ts`, `feature-tracker.ts`, `workflow-states-loader.ts` +- Superset signature: `parseFrontmatter(text, { stripInlineComments? }): { frontmatter, body } | null` +- Astro build green; 529 tests passed + +## Known gaps (follow-up) +- `user-manuals-loader.ts` still has its own inline `parseFrontmatter` (tracked as follow-up F-03) +- Unit tests for `parse-frontmatter.ts` in isolation (follow-up F-02) + +## Triage +- **Type:** refactor +- **Priority:** normal (Wave 3 of issue [[377-arch-deepening-opportunities-in-scripts-and-sites]]) + +Partial implementation of [[377-arch-deepening-opportunities-in-scripts-and-sites]] (Wave 3 — sites content-loader dedup) + +🤖 Resolved via `/issue:tackle 377` Wave 3