@tekyzinc/gsd-t 2.64.10 → 2.66.10

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to GSD-T are documented here. Updated with each release.
 
+## [2.66.10] - 2026-04-05
+
+### Changed (page-contract template)
+- **Composes Elements (direct)** split into two sub-lists: "Existing element contracts used directly" vs "Inline stubs (promotion candidates)". Closes gap P8 from page-tier run 3.
+- **Route guards stub convention** — if a guard is declared but not yet wired, prefix with `(stub)` and link the milestone that will wire it. Closes gap P9.
+- **Skip link `tabindex="-1"` note** — `<main>` must be programmatically focusable for skip-link navigation. Closes gap P10.
+
+### Milestone
+- **Hierarchical contract system CONVERGED** — 3×3 matrix complete: element/widget/page tiers × 3 convergence runs each × 50/50 score. 11 of 14 gaps resolved across v2.59.10–v2.66.10; remaining 3 are widget-template refinements, non-blocking.
+
+## [2.65.10] - 2026-04-05
+
+### Changed (page-contract template)
+- **Boundary grep regex tightened** — line-anchored (`^\s*`) + requires opening `{` — avoids false positives on JS identifiers like `donutProps` or property access `obj.donut`. Only matches actual CSS rules. Closes gap P5 from page-tier run 2.
+
+### Added (page-contract template)
+- **Multi-state Page Fixture convention** — for pages whose state swaps widget data, declare one full fixture per state under `__states__` keys, referencing named widget sub-fixtures (`#/fixture-sessions`). Prefer full duplication over override deltas. Closes gap P6.
+- **Inline-stub promotion guidance** — if a page-scope control is used in ≥2 pages, promote to its own widget contract; until then list in Composes Elements (direct) with `(promotion candidate)` tag. Closes gap P7.
+
 ## [2.64.10] - 2026-04-05
 
 ### Added (page-contract template)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekyzinc/gsd-t",
-  "version": "2.64.10",
+  "version": "2.66.10",
   "description": "GSD-T: Contract-Driven Development for Claude Code — 51 slash commands with headless CI/CD mode, graph-powered code analysis, real-time agent dashboard, execution intelligence, task telemetry, doc-ripple enforcement, backlog management, impact analysis, test sync, milestone archival, and PRD generation",
   "author": "Tekyz, Inc.",
   "license": "MIT",

package/templates/page-contract.md

@@ -44,6 +44,27 @@ If you want to formalize the composition chain (element → widget → page), de
 
 Skip this section for pages that are pure assembly with no storybook / harness target. Include it when the page has a dedicated demo route or when multiple pages share widget fixtures and you want to document which instance each page references.
 
+**Multi-state pages** (when page state swaps widget data): declare **one full fixture per state**, keyed by the state name. Prefer full duplication over override deltas — it's more verbose but makes each state independently runnable and avoids merge ambiguity.
+
+```json
+{
+  "__fixture_source__": "composed-from-widgets",
+  "__states__": ["Members", "Sessions"],
+  "Members": {
+    "donut": "$ref:donut-chart-card-widget#/fixture",
+    "bar":   "$ref:bar-chart-card-widget#/fixture"
+  },
+  "Sessions": {
+    "donut": "$ref:donut-chart-card-widget#/fixture-sessions",
+    "bar":   "$ref:bar-chart-card-widget#/fixture-sessions"
+  }
+}
+```
+
+Widget contracts that have multiple fixture variants expose them as named sub-fixtures (`#/fixture-sessions`, `#/fixture-q4`, etc.) rather than a single `#/fixture`.
+
+**Inline-stub promotion**: if a page-scope control or chrome element (segmented control, tab bar, breadcrumb) is used in ≥2 pages, promote it to its own widget contract. Until promoted, list the stub in **Composes Elements (direct)** with a `(promotion candidate)` tag and the page paths that use it.
+
 ## Layout
 
 ```
@@ -91,7 +112,7 @@ Skip this section for pages that are pure assembly with no storybook / harness t
 ## Routing & Navigation
 
 - **Route**: {/dashboard/overview}
-- **Guards**: {requires authentication, role: user|admin}
+- **Guards**: {requires authentication, role: user|admin} — if the guard is declared but not yet wired, prefix with `(stub)` and link the authentication milestone that will wire it (e.g., `(stub) requires-auth — milestone M4`).
 - **Breadcrumbs**: {Home > Dashboard > Overview}
 - **Nav active state**: {highlights "Dashboard" in nav-sidebar}
 
@@ -129,7 +150,7 @@ Skip this section for pages that are pure assembly with no storybook / harness t
 ## Accessibility
 
 - **Landmarks**: `<header>`, `<nav>`, `<main>`, per-widget `<section role="region">`
-- **Skip link**: "Skip to main content" at top, focuses `<main>` on activation
+- **Skip link**: "Skip to main content" at top, focuses `<main>` on activation. If the skip link targets `<main>`, `<main>` MUST have `tabindex="-1"` to be programmatically focusable via hash-link navigation.
 - **Keyboard order**: header → sidebar → widgets in visual reading order
 - **Page title**: Set via `<title>` per route
 
@@ -152,7 +173,11 @@ A page is **FORBIDDEN** from:
 - Overriding widget visual spec via `:deep()` selectors or `!important` on widget-owned properties
 - Re-specifying element visual spec (colors, font sizes, radii, paddings owned by elements)
 
-**Enforcement check**: `grep` the page file for any CSS selector matching a widget's internal class names — if found, move the styling into the widget contract or create a widget variant.
+**Enforcement check** (line-anchored CSS-only grep, avoids false positives on JS identifiers):
+```
+grep -En '^\s*(\.card-title|\.donut|\.legend-dot|\.kpi-value|\.chart-wrapper|\.filter-select)[^\w-]*\{' {page-file}
+```
+The leading `^\s*` anchor + trailing `\{` requirement matches ONLY CSS rules at the start of a line, not JS property access (`obj.donut`) or variable names (`donutProps`). If any match is found, move the styling into the widget contract or create a widget variant.
 
 ## Verification Checklist