@xenonbyte/da-vinci-workflow 0.1.26 → 0.2.2

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@xenonbyte/da-vinci-workflow",
-  "version": "0.1.26",
+  "version": "0.2.2",
   "description": "Requirement-to-design-to-code workflow skill for Codex, Claude, and Gemini",
   "bin": {
     "da-vinci": "bin/da-vinci.js",
-    "design-supervisor": "bin/design-supervisor.js"
+    "design-supervisor": "bin/design-supervisor.js",
+    "da-vinci-tui": "bin/da-vinci-tui.js"
   },
   "files": [
     "SKILL.md",
@@ -18,6 +19,7 @@
     "examples",
     "bin",
     "lib",
+    "tui",
     "scripts/postinstall.js",
     "scripts/validate-assets.js"
   ],
@@ -43,11 +45,19 @@
     "test:icon-aliases": "node scripts/test-icon-aliases.js",
     "test:supervisor-review-cli": "node scripts/test-supervisor-review-cli.js",
     "test:supervisor-review-integration": "node scripts/test-supervisor-review-integration.js",
+    "test:command-assets": "node scripts/test-command-asset-generation.js",
+    "test:lint-planning": "node scripts/test-lint-planning.js",
+    "test:sidecars-diff": "node scripts/test-sidecars-diff.js",
+    "test:verify-scaffold": "node scripts/test-verify-scaffold.js",
+    "test:audit-execution-signals": "node scripts/test-audit-execution-signals.js",
+    "test:workflow-persisted-state": "node scripts/test-workflow-persisted-state.js",
     "test:install": "node scripts/test-install.js",
     "test:package-contents": "node scripts/test-package-contents.js",
     "quality:ci:core": "npm run test",
+    "quality:ci:contracts": "npm run test:mode-consistency && npm run test:command-assets",
+    "quality:ci:e2e": "npm run test:lint-planning && npm run test:sidecars-diff && npm run test:verify-scaffold && npm run test:workflow-persisted-state && npm run test:audit-execution-signals",
     "quality:reviewer-bridge-smoke": "npm run test:supervisor-review-integration",
-    "quality:ci": "npm run quality:ci:core"
+    "quality:ci": "npm run quality:ci:core && npm run quality:ci:contracts && npm run quality:ci:e2e"
   },
   "engines": {
     "node": ">=18"

package/references/artifact-templates.md

@@ -678,6 +678,12 @@ Use this structure:
 - [ ] Check requirement coverage
 - [ ] Check Pencil coverage
 
+## Metadata Hints (Machine-readable)
+- Spec slice: `<slice-id>`
+- Binding links: `<implementation-page> -> <pencil-page>`
+- Code areas: `<repo path or module>`
+- Verification intent: `<verify-bindings|verify-implementation|verify-structure|verify-coverage>`
+
 ## Context Delta
 - Add concise checkpoint-adjacent entries when `task checkpoint` or execution planning decisions change
 - Required fields: `time`, `checkpoint_type`, `goal`, `decision`, `constraints`, `impact`, `status`, `next_action`
@@ -690,6 +696,12 @@ Use this structure:
 
 Prefer top-level task groups. They are required for execution checkpoints.
 
+Additional guidance:
+
+- keep top-level task groups in `X. Title` form to support task-group execution metadata
+- include explicit verification actions so `lint-tasks` and `verify-coverage` can consume intent deterministically
+- keep task text concrete enough that coverage tools can map behavior and state work
+
 Recommended path:
 
 - `.da-vinci/changes/<change-id>/tasks.md`
@@ -712,6 +724,12 @@ Use this structure:
 ## Shared Bindings
 - shared layout or component -> Pencil region
 
+## Machine-readable Hints
+- source path: `.da-vinci/designs/<name>.pen`
+- binding row shape: `<implementation> -> <source> -> <pencil page> (<screen-id>)`
+- missing implementation state: annotate in `## Notes` with `missing implementation`
+- missing design-source state: annotate in `## Notes` with `missing design source`
+
 ## Notes
 - intentional deviations
 - pages without Pencil coverage yet
@@ -754,6 +772,14 @@ Use this structure:
 - PASS / WARN / BLOCK
 - Next action
 
+## Structure Coverage
+- mapped design hierarchy evidence
+- heuristic fallback flag and confidence
+
+## Test Coverage
+- explicit test evidence summary
+- open gaps
+
 ## Context Delta
 - Add concise entries after each `execution checkpoint`
 - Required fields: `time`, `checkpoint_type`, `goal`, `decision`, `constraints`, `impact`, `status`, `next_action`

package/references/checkpoints.md

@@ -32,6 +32,20 @@ Context-delta rule:
 - when an artifact should opt in without those headings, add `- Context Delta Required: true` (accepted truthy values: `true`, `yes`, `on`, `1`)
 - when `supersedes` references parseable timestamps in different textual formats, treat them as the same point-in-time reference
 
+Execution-chain enforcement defaults:
+
+- planning lint surfaces (`lint-spec`, `scope-check`, `lint-tasks`, `lint-bindings`) are advisory by default
+- explicit `--strict` upgrades planning warnings to blocking command exits
+- verification surfaces (`verify-bindings`, `verify-implementation`, `verify-structure`, `verify-coverage`) are completion-critical; blocking findings should prevent completion
+- integrity audit consumes planning-signal `BLOCK` as warning-level advisory evidence
+- completion audit consumes verification-signal `BLOCK` as failure-level evidence
+
+Persisted-state fallback rule:
+
+- `workflow-status` may consume persisted `.da-vinci/state/workflow.json` only when fingerprint and freshness checks pass
+- when persisted state conflicts with artifact truth, fallback to derived state and record reconciliation notes
+- task-group execution metadata should be derived from `tasks.md` and refreshed into `.da-vinci/state/task-groups/<change-id>.json`
+
 ## Visual Contract Rule
 
 Before broad Pencil page generation:

package/references/modes.md

@@ -123,3 +123,13 @@ Best for:
 - new feature pages
 - changing existing pages
 - scoped UX or workflow changes
+
+## Execution-Chain Tooling Across Modes
+
+For all modes, use the same planning/verification surfaces:
+
+- planning lint: `lint-spec`, `scope-check`, `lint-tasks`, `lint-bindings`
+- deterministic sidecars: `generate-sidecars` (`spec.index.json`, `tasks.index.json`, `page-map.index.json`, `bindings.index.json`)
+- verification: `verify-bindings`, `verify-implementation`, `verify-structure`, `verify-coverage`
+- planning diff: `diff-spec`
+- workflow routing: `workflow-status`, `next-step` (prompt-first `continue` consumes these first)