@codewizard-dt/bootstrap 2.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (186) hide show
  1. package/.github/workflows/build.yml +88 -0
  2. package/.github/workflows/security.yml +24 -0
  3. package/.gitleaks.toml +15 -0
  4. package/README.md +472 -0
  5. package/bin/cli.js +47 -0
  6. package/lib/README.md +27 -0
  7. package/lib/hooks/README.md +316 -0
  8. package/lib/hooks/env-file-guard.js +45 -0
  9. package/lib/hooks/git-protected-ops-block.js +77 -0
  10. package/lib/hooks/lib/serena-languages.js +158 -0
  11. package/lib/hooks/lib/serena.js +787 -0
  12. package/lib/hooks/mv-absolute-path-block.js +53 -0
  13. package/lib/hooks/serena-bash-grep-block.js +501 -0
  14. package/lib/hooks/serena-edit-guard.js +74 -0
  15. package/lib/hooks/serena-first-glob-guard.js +94 -0
  16. package/lib/hooks/serena-first-guard.js +74 -0
  17. package/lib/hooks/serena-first-read-guard.js +167 -0
  18. package/lib/hooks/serena-pre-delegation.js +117 -0
  19. package/lib/hooks/serena-session-reset.js +45 -0
  20. package/lib/hooks/serena-usage-tracker.js +186 -0
  21. package/lib/hooks/serena-write-guard.js +58 -0
  22. package/lib/prompts/README.md +16 -0
  23. package/lib/prompts/migrate-wiki.md +111 -0
  24. package/lib/prompts/setup-deployment.md +322 -0
  25. package/lib/prompts/setup-design-system.md +162 -0
  26. package/lib/prompts/setup-strict-typechecks.md +139 -0
  27. package/lib/scripts/README.md +49 -0
  28. package/lib/scripts/bootstrap-serena.sh +145 -0
  29. package/lib/scripts/build-mcp-guide.sh +108 -0
  30. package/lib/scripts/install-global.sh +78 -0
  31. package/lib/scripts/install-mcps.sh +131 -0
  32. package/lib/scripts/lib.sh +154 -0
  33. package/lib/scripts/merge-gitignore.sh +65 -0
  34. package/lib/scripts/migrate-project.sh +273 -0
  35. package/lib/scripts/setup-deployment.sh +104 -0
  36. package/lib/scripts/setup-project.sh +55 -0
  37. package/lib/scripts/setup-runner.sh +99 -0
  38. package/lib/scripts/setup-strict-typechecks.sh +29 -0
  39. package/lib/scripts/startup.sh +42 -0
  40. package/lib/scripts/sync-wiki-scaffold.sh +104 -0
  41. package/lib/scripts/templates/CLAUDE-env-safety.md +3 -0
  42. package/lib/scripts/templates/CLAUDE-wiki.md +60 -0
  43. package/lib/scripts/templates/gitignore +136 -0
  44. package/lib/scripts/templates/guides/stubs/00-header.md +15 -0
  45. package/lib/scripts/templates/guides/stubs/brave-search.md +20 -0
  46. package/lib/scripts/templates/guides/stubs/context7.md +26 -0
  47. package/lib/scripts/templates/guides/stubs/playwright.md +26 -0
  48. package/lib/scripts/templates/guides/stubs/serena.md +219 -0
  49. package/lib/scripts/templates/wiki/conventions.md +100 -0
  50. package/lib/scripts/templates/wiki/dashboard.html +1733 -0
  51. package/lib/scripts/templates/wiki/hot.md +21 -0
  52. package/lib/scripts/templates/wiki/index.md +46 -0
  53. package/lib/scripts/templates/wiki/knowledge/concepts/.gitkeep +0 -0
  54. package/lib/scripts/templates/wiki/knowledge/entities/components/.gitkeep +0 -0
  55. package/lib/scripts/templates/wiki/knowledge/entities/organisations/.gitkeep +0 -0
  56. package/lib/scripts/templates/wiki/knowledge/entities/people/.gitkeep +0 -0
  57. package/lib/scripts/templates/wiki/knowledge/entities/tools/.gitkeep +0 -0
  58. package/lib/scripts/templates/wiki/knowledge/sources/.gitkeep +0 -0
  59. package/lib/scripts/templates/wiki/log.md +14 -0
  60. package/lib/scripts/templates/wiki/work/bugs/.gitkeep +0 -0
  61. package/lib/scripts/templates/wiki/work/bugs/archive/index.md +6 -0
  62. package/lib/scripts/templates/wiki/work/bugs/index.md +12 -0
  63. package/lib/scripts/templates/wiki/work/bugs/lifecycle.md +39 -0
  64. package/lib/scripts/templates/wiki/work/decisions/.gitkeep +0 -0
  65. package/lib/scripts/templates/wiki/work/decisions/archive/index.md +6 -0
  66. package/lib/scripts/templates/wiki/work/decisions/index.md +12 -0
  67. package/lib/scripts/templates/wiki/work/decisions/lifecycle.md +42 -0
  68. package/lib/scripts/templates/wiki/work/requirements/.gitkeep +0 -0
  69. package/lib/scripts/templates/wiki/work/requirements/archive/index.md +6 -0
  70. package/lib/scripts/templates/wiki/work/requirements/index.md +12 -0
  71. package/lib/scripts/templates/wiki/work/requirements/lifecycle.md +34 -0
  72. package/lib/scripts/templates/wiki/work/roadmaps/.gitkeep +0 -0
  73. package/lib/scripts/templates/wiki/work/roadmaps/archive/index.md +6 -0
  74. package/lib/scripts/templates/wiki/work/roadmaps/index.md +12 -0
  75. package/lib/scripts/templates/wiki/work/roadmaps/lifecycle.md +32 -0
  76. package/lib/scripts/templates/wiki/work/tasks/.gitkeep +0 -0
  77. package/lib/scripts/templates/wiki/work/tasks/archive/index.md +6 -0
  78. package/lib/scripts/templates/wiki/work/tasks/index.md +12 -0
  79. package/lib/scripts/templates/wiki/work/tasks/lifecycle.md +39 -0
  80. package/lib/scripts/templates/wiki/work/uat/.gitkeep +0 -0
  81. package/lib/scripts/templates/wiki/work/uat/archive/index.md +6 -0
  82. package/lib/scripts/templates/wiki/work/uat/index.md +12 -0
  83. package/lib/scripts/templates/wiki/work/uat/lifecycle.md +48 -0
  84. package/lib/scripts/templates/wiki/work/uat/screenshots/.gitkeep +0 -0
  85. package/lib/scripts/update-project.sh +75 -0
  86. package/lib/scripts/wiki-dashboard-server.js +146 -0
  87. package/lib/skills/README.md +146 -0
  88. package/lib/skills/anti-slop/SKILL.md +183 -0
  89. package/lib/skills/bug-close/SKILL.md +136 -0
  90. package/lib/skills/bug-file/SKILL.md +114 -0
  91. package/lib/skills/bug-triage/SKILL.md +140 -0
  92. package/lib/skills/company-align/SKILL.md +203 -0
  93. package/lib/skills/debug-logs/SKILL.md +129 -0
  94. package/lib/skills/decision-create/SKILL.md +220 -0
  95. package/lib/skills/decision-finalize/SKILL.md +181 -0
  96. package/lib/skills/decision-next/SKILL.md +129 -0
  97. package/lib/skills/decision-walkthrough/SKILL.md +169 -0
  98. package/lib/skills/demo/SKILL.md +183 -0
  99. package/lib/skills/elevator-pitch/SKILL.md +125 -0
  100. package/lib/skills/eval-create/SKILL.md +344 -0
  101. package/lib/skills/eval-gap/SKILL.md +150 -0
  102. package/lib/skills/eval-run/SKILL.md +214 -0
  103. package/lib/skills/extract-feature/SKILL.md +344 -0
  104. package/lib/skills/flashcard/SKILL.md +513 -0
  105. package/lib/skills/frontend-taste/SKILL.md +184 -0
  106. package/lib/skills/gap-assess/SKILL.md +97 -0
  107. package/lib/skills/git-commit/SKILL.md +164 -0
  108. package/lib/skills/lint/SKILL.md +99 -0
  109. package/lib/skills/marp-slideshow/SKILL.md +212 -0
  110. package/lib/skills/mermaid-flowchart/SKILL.md +194 -0
  111. package/lib/skills/now/SKILL.md +36 -0
  112. package/lib/skills/port-feature/SKILL.md +315 -0
  113. package/lib/skills/power-mode/SKILL.md +184 -0
  114. package/lib/skills/primer/SKILL.md +84 -0
  115. package/lib/skills/project-readme/SKILL.md +166 -0
  116. package/lib/skills/req-compile/SKILL.md +131 -0
  117. package/lib/skills/req-create/SKILL.md +124 -0
  118. package/lib/skills/req-extract-decisions/SKILL.md +241 -0
  119. package/lib/skills/req-finalize/SKILL.md +251 -0
  120. package/lib/skills/req-retire/SKILL.md +185 -0
  121. package/lib/skills/req-update/SKILL.md +265 -0
  122. package/lib/skills/research/SKILL.md +250 -0
  123. package/lib/skills/research-company/SKILL.md +345 -0
  124. package/lib/skills/roadmap-add/SKILL.md +238 -0
  125. package/lib/skills/roadmap-create/SKILL.md +223 -0
  126. package/lib/skills/roadmap-next/SKILL.md +132 -0
  127. package/lib/skills/security-audit/SKILL.md +246 -0
  128. package/lib/skills/serena-config/SKILL.md +92 -0
  129. package/lib/skills/simplify/SKILL.md +227 -0
  130. package/lib/skills/tackle/SKILL.md +156 -0
  131. package/lib/skills/task-add/SKILL.md +208 -0
  132. package/lib/skills/task-audit/SKILL.md +294 -0
  133. package/lib/skills/task-trash/SKILL.md +115 -0
  134. package/lib/skills/task-update/SKILL.md +136 -0
  135. package/lib/skills/uat-auto/SKILL.md +69 -0
  136. package/lib/skills/uat-auto-plus/SKILL.md +115 -0
  137. package/lib/skills/uat-generate/SKILL.md +289 -0
  138. package/lib/skills/uat-skip/SKILL.md +169 -0
  139. package/lib/skills/uat-walk/SKILL.md +164 -0
  140. package/lib/skills/uat-walk/UAT-CORE.md +140 -0
  141. package/lib/skills/update-docs/SKILL.md +75 -0
  142. package/lib/skills/wiki-archive/SKILL.md +96 -0
  143. package/lib/skills/wiki-ingest/SKILL.md +139 -0
  144. package/lib/skills/wiki-lint/SKILL.md +131 -0
  145. package/lib/skills/wiki-query/SKILL.md +71 -0
  146. package/lib/skills/wiki-rotate-log/SKILL.md +90 -0
  147. package/lib/skills/wiki-tidy/SKILL.md +107 -0
  148. package/package.json +32 -0
  149. package/raw/.gitkeep +0 -0
  150. package/raw/design-principles.md +65 -0
  151. package/raw/guides/command-anti-patterns.md +79 -0
  152. package/raw/guides/deployment-strategy.md +448 -0
  153. package/raw/guides/evals-framework.md +452 -0
  154. package/raw/guides/mcp-tools.md +335 -0
  155. package/raw/guides/task-spec.md +79 -0
  156. package/raw/guides/type-checking-templates/README.md +112 -0
  157. package/raw/guides/type-checking-templates/eslint/eslint.config.ts +105 -0
  158. package/raw/guides/type-checking-templates/python/mypy.ini +69 -0
  159. package/raw/guides/type-checking-templates/python/pyproject.toml +164 -0
  160. package/raw/guides/type-checking-templates/python/pyrightconfig.json +67 -0
  161. package/raw/guides/type-checking-templates/tsconfig/tsconfig.app.jsonc +45 -0
  162. package/raw/guides/type-checking-templates/tsconfig/tsconfig.lib.jsonc +44 -0
  163. package/raw/guides/type-checking-templates/tsconfig/tsconfig.node-esm.jsonc +40 -0
  164. package/raw/guides/type-checking-templates/tsconfig/tsconfig.node.jsonc +34 -0
  165. package/raw/guides/type-checking-templates/tsconfig/tsconfig.vite-root.json +8 -0
  166. package/raw/harness-notes.md +20 -0
  167. package/raw/house-style/components/Badge.tsx +16 -0
  168. package/raw/house-style/components/Button.tsx +32 -0
  169. package/raw/house-style/components/Card.tsx +26 -0
  170. package/raw/house-style/components/Chip.tsx +57 -0
  171. package/raw/house-style/components/IconButton.tsx +67 -0
  172. package/raw/house-style/components/Modal.tsx +18 -0
  173. package/raw/house-style/components/Stepper.tsx +141 -0
  174. package/raw/house-style/components/icons.tsx +128 -0
  175. package/raw/house-style/preview/src/index.css +46 -0
  176. package/raw/house-style/tokens/tailwind.preset.ts +49 -0
  177. package/raw/house-style/tokens/tokens.json +62 -0
  178. package/raw/llm-wiki-2.md +162 -0
  179. package/raw/llm-wiki.md +75 -0
  180. package/raw/research/dark-mode-theme/index.md +85 -0
  181. package/raw/research/dark-mode-theme/sources.md +49 -0
  182. package/raw/research/serena-mcp-disconnect/index.md +81 -0
  183. package/raw/research/serena-mcp-disconnect/sources.md +87 -0
  184. package/raw/research/wiki-tooling-improvements/index.md +126 -0
  185. package/raw/research/wiki-tooling-improvements/sources.md +73 -0
  186. package/raw/software-factory-case-study.pdf +0 -0
@@ -0,0 +1,21 @@
1
+ ---
2
+ title: Hot Cache
3
+ updated: YYYY-MM-DD
4
+ ---
5
+
6
+ # Hot Cache
7
+
8
+ Session-handoff summary of what changed most recently — the small file an agent reads first to get oriented fast. **Fully regenerated at the end of every wiki-writing session, never appended to.** Keep it under ~500 words; if a fact stops being "recent", it drops off (its durable form lives in a knowledge or work page).
9
+
10
+ _Last updated: YYYY-MM-DD_
11
+
12
+ ## Key Recent Facts
13
+ - _(the handful of things a fresh session most needs to know right now)_
14
+
15
+ ## Recent Changes
16
+ - Created: _(new pages/files from the last session)_
17
+ - Updated: _(pages/files revised in the last session)_
18
+ - Flagged: _(contradictions, stale claims, or open questions raised)_
19
+
20
+ ## Active Threads
21
+ - _(in-flight work — roadmaps mid-execution, tasks in progress, waves pending)_
@@ -0,0 +1,46 @@
1
+ ---
2
+ title: Wiki Index
3
+ updated: 2026-06-11
4
+ ---
5
+
6
+ # Wiki Index — Home Map
7
+
8
+ The page catalog and home Map of Content for this wiki. **Read this first on every query**, then drill into the linked pages. Updated on every ingest and every filed answer.
9
+
10
+ Conventions that govern every page (atomic pages, stable IDs, typed links, frontmatter namespace): see [conventions](conventions.md). Operation history: see [log](log.md).
11
+
12
+ Entry format: `- [Title](path) — one-line summary`.
13
+
14
+ The wiki is split into two domains with opposite organizing laws:
15
+ - **Knowledge** — timeless, link-navigated synthesis (sources, concepts, entities). Pages are listed individually below.
16
+ - **Work** — stateful, status-navigated lifecycle artifacts (requirements, decisions, roadmaps, tasks, uat, bugs). Items are **not** listed here — each family keeps its own `index.md` of active items; this page links to those.
17
+
18
+ ---
19
+
20
+ ## Knowledge
21
+
22
+ ### Sources
23
+ _(none yet)_ — one summary page per ingested `raw/` source. See [knowledge/sources/](knowledge/sources/).
24
+
25
+ ### Concepts
26
+ _(none yet)_ — patterns, ideas, conventions, recurring themes. See [knowledge/concepts/](knowledge/concepts/).
27
+
28
+ ### Entities
29
+ _(none yet)_ — one page per entity, filed by sub-type:
30
+ - People — [knowledge/entities/people/](knowledge/entities/people/)
31
+ - Organisations — [knowledge/entities/organisations/](knowledge/entities/organisations/)
32
+ - Tools — [knowledge/entities/tools/](knowledge/entities/tools/)
33
+ - Components — [knowledge/entities/components/](knowledge/entities/components/) (this project's own modules, services, scripts)
34
+
35
+ ---
36
+
37
+ ## Work
38
+
39
+ Each family's `index.md` lists its **active items only** (completed/terminal items drop off the list; files never move — status lives in frontmatter).
40
+
41
+ - **Requirements** — REQ-NNN. [Active index](work/requirements/index.md) · [lifecycle](work/requirements/lifecycle.md)
42
+ - **Decisions** — DEC-NNNN (per-decision `#DM`). [Active index](work/decisions/index.md) · [lifecycle](work/decisions/lifecycle.md)
43
+ - **Roadmaps** — ROADMAP-NNN. [Active index](work/roadmaps/index.md) · [lifecycle](work/roadmaps/lifecycle.md)
44
+ - **Tasks** — TASK-NNN. [Active index](work/tasks/index.md) · [lifecycle](work/tasks/lifecycle.md)
45
+ - **UAT** — UAT-NNN, one per task. [Active index](work/uat/index.md) · [lifecycle](work/uat/lifecycle.md)
46
+ - **Bugs** — BUG-NNNN. [Active index](work/bugs/index.md) · [lifecycle](work/bugs/lifecycle.md)
@@ -0,0 +1,14 @@
1
+ # Wiki Log
2
+
3
+ Append-only record of wiki operations — ingests, queries filed back, lint passes, scaffolding. **Never edit existing entries**; only append new ones at the bottom.
4
+
5
+ Entry format (consistent prefix keeps the log greppable — `grep "^## \[" log.md | tail -5`):
6
+
7
+ ```
8
+ ## [YYYY-MM-DD] <op> | <subject>
9
+ 1–3 sentences on what happened.
10
+ ```
11
+
12
+ Operations: `scaffold`, `ingest`, `query`, `lint`, `decision`, `task`, `bug`, `requirement`, `roadmap`.
13
+
14
+ ---
File without changes
@@ -0,0 +1,6 @@
1
+ # Bugs Archive
2
+
3
+ Terminal bug files (`closed`, `wontfix`, `duplicate`, or `cannot-reproduce`) moved here by `/wiki-archive` to reduce directory clutter. **Append-only** — archived items never move again.
4
+
5
+ | ID | Title | Final Status | Archived |
6
+ |----|-------|--------------|----------|
@@ -0,0 +1,12 @@
1
+ ---
2
+ title: Bugs Index
3
+ updated: 2026-06-11
4
+ ---
5
+
6
+ # Bugs — Active Items
7
+
8
+ Lists **only active** bugs (`open`, `triaged`, `in-progress`). When a bug leaves the active set (`closed`, `wontfix`, `duplicate`, `cannot-reproduce`), delete its line here — the file itself never moves; status lives in its frontmatter. See the [lifecycle](lifecycle.md).
9
+
10
+ Entry format: `- [BUG-NNNN — Title](BUG-NNNN-slug.md) — one-line summary · status · P0–P3`
11
+
12
+ _(none yet)_
@@ -0,0 +1,39 @@
1
+ ---
2
+ title: Bugs Lifecycle
3
+ updated: 2026-06-11
4
+ ---
5
+
6
+ # Bugs Lifecycle
7
+
8
+ Bug reports with reproduction, impact, root-cause, and resolution. ID scheme: **BUG-NNNN** (4-digit, zero-padded, globally unique). Filename: `BUG-NNNN-slug.md`.
9
+
10
+ Active files are **never moved** after creation; state lives in the `status:` frontmatter field. Terminal items (`closed`, `wontfix`, `duplicate`, `cannot-reproduce`) may be moved to [`archive/`](archive/) by `/wiki-archive`. The active set is tracked in [`index.md`](index.md).
11
+
12
+ ## Frontmatter schema
13
+
14
+ | Key | Required | Notes |
15
+ |-----|----------|-------|
16
+ | `id` | yes | `BUG-NNNN` |
17
+ | `title` | yes | short slug/summary |
18
+ | `status` | yes | `open \| triaged \| in-progress \| closed \| wontfix \| duplicate \| cannot-reproduce` |
19
+ | `severity` | yes | `critical \| high \| medium \| low` |
20
+ | `priority` | yes | `P0 \| P1 \| P2 \| P3` |
21
+ | `created` / `updated` | yes | `YYYY-MM-DD` |
22
+ | `reporter` | yes | who filed it |
23
+ | `assignee` | no | `unassigned` until triage |
24
+ | `tags` | no | discovery only |
25
+
26
+ Closing requires a Root Cause Analysis, a fix commit, and a regression test (`/bug-close` gate).
27
+
28
+ ## Status transitions
29
+
30
+ ```
31
+ open ──▶ triaged ──▶ in-progress ──▶ closed
32
+ └──▶ wontfix | duplicate | cannot-reproduce
33
+ ```
34
+
35
+ - **open** — filed (`/bug-file`); required-on-report fields present.
36
+ - **triaged** — priority/severity/assignee set (`/bug-triage`); decision to fix, defer, or reject.
37
+ - **in-progress** — actively being fixed.
38
+ - **closed** — fixed and verified (`/bug-close`): root cause + fix commit + regression test recorded.
39
+ - **wontfix / duplicate / cannot-reproduce** — terminal rejections; reason recorded in the body.
@@ -0,0 +1,6 @@
1
+ # Decisions Archive
2
+
3
+ Decision group files where all decisions are `accepted` or `superseded`, moved here by `/wiki-archive` to reduce directory clutter. **Append-only** — archived items never move again.
4
+
5
+ | ID | Title | Final Status | Archived |
6
+ |----|-------|--------------|----------|
@@ -0,0 +1,12 @@
1
+ ---
2
+ title: Decisions Index
3
+ updated: 2026-06-11
4
+ ---
5
+
6
+ # Decisions — Active Items
7
+
8
+ Lists **only active** Decision Groups — a group stays listed while at least one of its decisions is `proposed`. When every block is `accepted` or `superseded`, delete the group's line here — the file itself never moves; per-decision status lives in each block. See the [lifecycle](lifecycle.md).
9
+
10
+ Entry format: `- [DEC-NNNN — Title](DEC-NNNN-slug.md) — one-line summary · D1 proposed, D2 accepted, …`
11
+
12
+ _(none yet)_
@@ -0,0 +1,42 @@
1
+ ---
2
+ title: Decisions Lifecycle
3
+ updated: 2026-06-11
4
+ ---
5
+
6
+ # Decisions Lifecycle
7
+
8
+ Architecture Decision Records. Each file is a **Decision Group** containing one or more `## DM. <title>` decision blocks. ID scheme: **DEC-NNNN** (4-digit, zero-padded) for the group; **DEC-NNNN#DM** for an individual decision (e.g. `DEC-0001#D2`). Filename: `DEC-NNNN-slug.md`.
9
+
10
+ Active files are **never moved** after creation; per-decision state lives in each block's `status` field. When all decisions in a group are `accepted` or `superseded`, the group may be moved to [`archive/`](archive/) by `/wiki-archive`. The active set is tracked in [`index.md`](index.md) — a group stays listed while at least one of its decisions is `proposed`.
11
+
12
+ ## Frontmatter / per-decision schema
13
+
14
+ Group frontmatter:
15
+
16
+ | Key | Required | Notes |
17
+ |-----|----------|-------|
18
+ | `id` | yes | `DEC-NNNN` |
19
+ | `title` | yes | decision-group title |
20
+ | `created` / `updated` | yes | `YYYY-MM-DD` |
21
+ | `tags` | yes | umbrella tags for the group |
22
+
23
+ Per-decision block (`## D1.`, `## D2.` …) metadata:
24
+
25
+ | Field | Required | Notes |
26
+ |-------|----------|-------|
27
+ | Status | yes | `proposed \| accepted \| superseded` |
28
+ | Date | yes | `YYYY-MM-DD` |
29
+ | Deciders | yes | who decided |
30
+ | Consulted / Informed | no | E-C-A-D-R inputs |
31
+ | Supersedes | no | `DEC-NNNN#DM \| none` |
32
+ | Tags | yes | decision-area tags |
33
+
34
+ ## Status transitions
35
+
36
+ ```
37
+ proposed ──▶ accepted ──▶ superseded
38
+ ```
39
+
40
+ - **proposed** — drafted in a Decision Group (`/decision-create`); comparison tables + mermaid flowchart, no commitment.
41
+ - **accepted** — finalized per-decision via `/decision-finalize` after an E-C-A-D-R audit. Siblings in the same group are untouched.
42
+ - **superseded** — replaced by a later accepted decision; the new block sets `Supersedes:` and the old block is marked `superseded by DEC-NNNN#DM`. Both blocks updated atomically; old block preserved.
@@ -0,0 +1,6 @@
1
+ # Requirements Archive
2
+
3
+ Terminal requirement files (`retired`) moved here by `/wiki-archive` to reduce directory clutter. **Append-only** — archived items never move again.
4
+
5
+ | ID | Title | Final Status | Archived |
6
+ |----|-------|--------------|----------|
@@ -0,0 +1,12 @@
1
+ ---
2
+ title: Requirements Index
3
+ updated: 2026-06-11
4
+ ---
5
+
6
+ # Requirements — Active Items
7
+
8
+ Lists **only active** requirements (`draft`, `approved`). When an item leaves the active set (`retired`), delete its line here — the file itself never moves; status lives in its frontmatter. See the [lifecycle](lifecycle.md).
9
+
10
+ Entry format: `- [REQ-NNN — Title](REQ-NNN-slug.md) — one-line summary · status`
11
+
12
+ _(none yet)_
@@ -0,0 +1,34 @@
1
+ ---
2
+ title: Requirements Lifecycle
3
+ updated: 2026-06-11
4
+ ---
5
+
6
+ # Requirements Lifecycle
7
+
8
+ Requirements (PRDs) capture the problem, personas, user stories, success metrics, and non-goals for a body of work. ID scheme: **REQ-NNN** (3-digit, zero-padded, globally unique). Filename: `REQ-NNN-slug.md`.
9
+
10
+ Active files are **never moved** after creation; state lives in the `status:` frontmatter field. Terminal items (`retired`) may be moved to [`archive/`](archive/) by `/wiki-archive`. The active set is tracked in [`index.md`](index.md).
11
+
12
+ ## Frontmatter schema
13
+
14
+ | Key | Required | Notes |
15
+ |-----|----------|-------|
16
+ | `id` | yes | `REQ-NNN` |
17
+ | `title` | yes | short requirement name |
18
+ | `status` | yes | `draft \| approved \| retired` |
19
+ | `created` / `updated` | yes | `YYYY-MM-DD` |
20
+ | `owner` | yes | accountable person/role |
21
+ | `stakeholders` | no | consulted/informed list |
22
+ | `tags` | no | discovery only |
23
+
24
+ Approved requirements are amended via append-only `## Amendment N` blocks, never edited in place.
25
+
26
+ ## Status transitions
27
+
28
+ ```
29
+ draft ──▶ approved ──▶ retired
30
+ ```
31
+
32
+ - **draft** — under construction (`/req-create`); edited freely.
33
+ - **approved** — completeness-audited and locked (`/req-finalize`); changes are append-only amendments (`/req-update`).
34
+ - **retired** — superseded or no longer in force; preserved for history.
@@ -0,0 +1,6 @@
1
+ # Roadmaps Archive
2
+
3
+ Terminal roadmap files (`done`) moved here by `/wiki-archive` to reduce directory clutter. **Append-only** — archived items never move again.
4
+
5
+ | ID | Title | Final Status | Archived |
6
+ |----|-------|--------------|----------|
@@ -0,0 +1,12 @@
1
+ ---
2
+ title: Roadmaps Index
3
+ updated: 2026-06-11
4
+ ---
5
+
6
+ # Roadmaps — Active Items
7
+
8
+ Lists **only active** roadmaps (`active`). When a roadmap completes (`done`), delete its line here — the file itself never moves; status lives in its frontmatter. See the [lifecycle](lifecycle.md).
9
+
10
+ Entry format: `- [ROADMAP-NNN — Title](ROADMAP-NNN-slug.md) — one-line summary · N/M items checked`
11
+
12
+ _(none yet)_
@@ -0,0 +1,32 @@
1
+ ---
2
+ title: Roadmaps Lifecycle
3
+ updated: 2026-06-11
4
+ ---
5
+
6
+ # Roadmaps Lifecycle
7
+
8
+ Execution-plan roadmaps: a goal, phases, and a hybrid checklist where each item is either a **task link** (`[TASK-NNN](../tasks/TASK-NNN-slug.md)`) or an **inline** checkbox item. ID scheme: **ROADMAP-NNN** (3-digit, zero-padded). Filename: `ROADMAP-NNN-slug.md`.
9
+
10
+ Active files are **never moved** after creation; state lives in the `status:` frontmatter field. Terminal items (`done`) may be moved to [`archive/`](archive/) by `/wiki-archive`. The active set is tracked in [`index.md`](index.md).
11
+
12
+ ## Frontmatter schema
13
+
14
+ | Key | Required | Notes |
15
+ |-----|----------|-------|
16
+ | `id` | yes | `ROADMAP-NNN` |
17
+ | `title` | yes | roadmap goal |
18
+ | `status` | yes | `active \| done` |
19
+ | `created` / `updated` | yes | `YYYY-MM-DD` |
20
+ | `owner` | no | accountable person/role |
21
+ | `linked_requirements` | no | `REQ-NNN` back-links |
22
+ | `linked_decisions` | no | `DEC-NNNN` back-links |
23
+ | `tags` | no | discovery only |
24
+
25
+ ## Status transitions
26
+
27
+ ```
28
+ active ──▶ done
29
+ ```
30
+
31
+ - **active** — at least one unchecked item remains. Items are added with `/roadmap-add`; task-linked items auto-check when their task completes.
32
+ - **done** — every checklist item is checked. Completion is implicit; flip `status` to `done` when the last box is ticked.
File without changes
@@ -0,0 +1,6 @@
1
+ # Tasks Archive
2
+
3
+ Terminal task files (`done` or `trashed`) moved here by `/wiki-archive` to reduce directory clutter. **Append-only** — archived items never move again.
4
+
5
+ | ID | Title | Final Status | Archived |
6
+ |----|-------|--------------|----------|
@@ -0,0 +1,12 @@
1
+ ---
2
+ title: Tasks Index
3
+ updated: 2026-06-11
4
+ ---
5
+
6
+ # Tasks — Active Items
7
+
8
+ Lists **only active** tasks (`todo`, `in-progress`). When a task leaves the active set (`done`, `trashed`), delete its line here — the file itself never moves; status lives in its frontmatter. See the [lifecycle](lifecycle.md).
9
+
10
+ Entry format: `- [TASK-NNN — Title](TASK-NNN-slug.md) — one-line summary · status`
11
+
12
+ _(none yet)_
@@ -0,0 +1,39 @@
1
+ ---
2
+ title: Tasks Lifecycle
3
+ updated: 2026-06-11
4
+ ---
5
+
6
+ # Tasks Lifecycle
7
+
8
+ Execution-ready task files with `## Steps` checklists. ID scheme: **TASK-NNN** (3-digit, zero-padded). Filename: `TASK-NNN-slug.md`. UAT test files mirror task naming (**UAT-NNN**) and live in the sibling [`../uat/`](../uat/) family.
9
+
10
+ Active files are **never moved** after creation; state lives in the `status:` frontmatter field. Terminal items (`done`, `trashed`) may be moved to [`archive/`](archive/) by `/wiki-archive`. The active set is tracked in [`index.md`](index.md).
11
+
12
+ ## Frontmatter schema
13
+
14
+ | Key | Required | Notes |
15
+ |-----|----------|-------|
16
+ | `id` | yes | `TASK-NNN` |
17
+ | `title` | yes | task title |
18
+ | `status` | yes | `todo \| in-progress \| done \| trashed` |
19
+ | `created` / `updated` | yes | `YYYY-MM-DD` |
20
+ | `depends_on` | no | `TASK-NNN` IDs that must finish first |
21
+ | `blocks` | no | `TASK-NNN` IDs this one gates |
22
+ | `parallel_safe_with` | no | `TASK-NNN` IDs safe to run concurrently |
23
+ | `uat` | no | link to the matching `../uat/UAT-NNN-slug.md` |
24
+ | `tags` | no | discovery only |
25
+
26
+ ## Status transitions
27
+
28
+ ```
29
+ todo ──▶ in-progress ──▶ done
30
+ │ │
31
+ └────────────┴──▶ trashed
32
+ ```
33
+
34
+ - **todo** — created by `/task-add`; not yet started.
35
+ - **in-progress** — being executed (`/tackle`). `/tackle` runs **static gates only** (typecheck, `bash -n`, lint, unit tests); runtime/E2E verification is the UAT phase.
36
+ - **done** — implementation complete and its UAT passed (`/uat-walk` / `/uat-auto`) or was explicitly skipped (`/uat-skip`).
37
+ - **trashed** — terminal; abandoned via `/task-trash` with the reason recorded in the file. The matching UAT is trashed alongside.
38
+
39
+ A task reaches **done** only when its UAT is all-pass or skipped — see the [UAT lifecycle](../uat/lifecycle.md).
File without changes
@@ -0,0 +1,6 @@
1
+ # UAT Archive
2
+
3
+ Terminal UAT files (`passed`, `skipped`, or `trashed`) moved here by `/wiki-archive` to reduce directory clutter. **Append-only** — archived items never move again.
4
+
5
+ | ID | Title | Final Status | Archived |
6
+ |----|-------|--------------|----------|
@@ -0,0 +1,12 @@
1
+ ---
2
+ title: UAT Index
3
+ updated: 2026-06-11
4
+ ---
5
+
6
+ # UAT — Active Items
7
+
8
+ Lists **only active** UAT files (`pending`, `in-progress`, `failed`). When a UAT leaves the active set (`passed`, `skipped`, `trashed`), delete its line here — the file itself never moves; status lives in its frontmatter. See the [lifecycle](lifecycle.md).
9
+
10
+ Entry format: `- [UAT-NNN — Title](UAT-NNN-slug.md) — verifies TASK-NNN · status`
11
+
12
+ _(none yet)_
@@ -0,0 +1,48 @@
1
+ ---
2
+ title: UAT Lifecycle
3
+ updated: 2026-06-11
4
+ ---
5
+
6
+ # UAT Lifecycle
7
+
8
+ User-acceptance test files, one per task. ID scheme: **UAT-NNN** (3-digit, zero-padded) — the number **mirrors the task it verifies** (`UAT-014` ↔ `TASK-014`). Filename: `UAT-NNN-slug.md`.
9
+
10
+ Active files are **never moved** after creation; state lives in the `status:` frontmatter field. Terminal items (`passed`, `skipped`, `trashed`) may be moved to [`archive/`](archive/) by `/wiki-archive`. The active set is tracked in [`index.md`](index.md).
11
+
12
+ ## Frontmatter schema
13
+
14
+ | Key | Required | Notes |
15
+ |-----|----------|-------|
16
+ | `id` | yes | `UAT-NNN` |
17
+ | `title` | yes | UAT title |
18
+ | `status` | yes | `pending \| in-progress \| passed \| failed \| skipped \| trashed` |
19
+ | `task` | yes | `TASK-NNN` back-link to the task under test |
20
+ | `created` / `updated` | yes | `YYYY-MM-DD` |
21
+ | `tags` | no | discovery only |
22
+
23
+ The body carries an `implements::[[TASK-NNN]]` typed link; the task carries a `uat:` frontmatter link back (`../uat/UAT-NNN-slug.md`).
24
+
25
+ ## Per-test markers
26
+
27
+ Each test in the file carries a status marker: `[ ]` (not run), `[x]` (pass), `[FAIL: …]`, `[SKIP: …]`.
28
+
29
+ ## Status transitions
30
+
31
+ ```
32
+ pending ──▶ in-progress ──▶ passed
33
+ │ ▲
34
+ ├──▶ failed ───┘ (rerun after fixes)
35
+ pending ──▶ skipped (/uat-skip — intentional skip, skeleton documents why)
36
+ any ──▶ trashed (/task-trash — task abandoned; reason recorded)
37
+ ```
38
+
39
+ - **pending** — created by `/uat-generate`; not yet executed.
40
+ - **in-progress** — being walked (`/uat-walk`) or run headlessly (`/uat-auto`).
41
+ - **passed** — every test `[x]`; the matching task flips to `done`.
42
+ - **failed** — one or more `[FAIL: …]` markers after a full run; flips back to `in-progress` on rerun.
43
+ - **skipped** — UAT deliberately not run (`/uat-skip`); the file records why.
44
+ - **trashed** — terminal; the task was trashed (`/task-trash`); reason recorded in the file.
45
+
46
+ A task reaches **done** only when its UAT is `passed` or `skipped`. See the [tasks lifecycle](../tasks/lifecycle.md).
47
+
48
+ Screenshots and other binary evidence live in [`screenshots/`](screenshots/) (exempt from page conventions).
@@ -0,0 +1,75 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+
4
+ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
5
+ . "$SCRIPT_DIR/lib.sh"
6
+
7
+ if [ $# -ne 1 ]; then
8
+ echo "Usage: $0 <path-to-project>"
9
+ exit 1
10
+ fi
11
+
12
+ PROJECT_DIR="$(resolve_project_dir "$1")" || exit 1
13
+
14
+ echo "Updating project: $PROJECT_DIR"
15
+ echo ""
16
+
17
+ # 0. Detect legacy .docs/ artifact content (pre-wiki layout) and warn.
18
+ # update never touches these files — migration is a separate, explicit step.
19
+ LEGACY_FAMILIES=(tasks uat adr prd bugs roadmaps)
20
+ LEGACY_FOUND=()
21
+ for fam in "${LEGACY_FAMILIES[@]}"; do
22
+ dir="$PROJECT_DIR/.docs/$fam"
23
+ if [ -d "$dir" ]; then
24
+ count=$(find "$dir" -name '*.md' -type f | wc -l | tr -d ' ')
25
+ if [ "$count" -gt 0 ]; then
26
+ LEGACY_FOUND+=(".docs/$fam ($count file(s))")
27
+ fi
28
+ fi
29
+ done
30
+
31
+ if [ ${#LEGACY_FOUND[@]} -gt 0 ]; then
32
+ echo "=================================================================="
33
+ echo " WARNING: legacy .docs/ artifact content detected"
34
+ echo "=================================================================="
35
+ for entry in "${LEGACY_FOUND[@]}"; do
36
+ echo " - $entry"
37
+ done
38
+ echo ""
39
+ echo " This project was bootstrapped with the old .docs/ layout."
40
+ echo " 'update' will scaffold the new wiki/ structure but will NOT"
41
+ echo " touch these files. To migrate them into wiki/work/, run:"
42
+ echo ""
43
+ echo " npx @codewizard-dt/bootstrap migrate"
44
+ echo ""
45
+ if [ -t 0 ]; then
46
+ read -r -p "Continue with update anyway? [y/N]: " REPLY
47
+ case "$REPLY" in
48
+ [yY]) ;;
49
+ *) echo "Aborted."; exit 0 ;;
50
+ esac
51
+ else
52
+ echo " Non-interactive mode: continuing with update."
53
+ fi
54
+ echo ""
55
+ fi
56
+
57
+ # 0b. Detect other legacy detritus (informational only — no auto-delete)
58
+ if [ -d "$PROJECT_DIR/.claude/commands" ]; then
59
+ echo "Note: legacy .claude/commands/ directory found — slash commands are now"
60
+ echo " global skills. Remove manually when ready: rm -rf .claude/commands/"
61
+ echo ""
62
+ fi
63
+ if [ -d "$PROJECT_DIR/.claude/skills" ]; then
64
+ echo "Note: project-local .claude/skills/ found — skills are installed globally"
65
+ echo " to ~/.claude/skills/ now. Remove manually when ready: rm -rf .claude/skills/"
66
+ echo ""
67
+ fi
68
+
69
+ # Shared setup/update sequence: MCPs, skills+hooks, wiki scaffold, MCP guide, Serena.
70
+ run_project_sync "$PROJECT_DIR" "$SCRIPT_DIR"
71
+
72
+ # Done
73
+ echo "============================="
74
+ echo " Update complete!"
75
+ echo "============================="