@jtf19/vibecoding-kit 0.1.0

package/examples/golden-path/diff-coverage.json

@@ -0,0 +1,66 @@
+{
+  "version": 1,
+  "artifact_kind": "diff-coverage-evidence",
+  "status": "provided",
+  "diff_coverage_ref": "diff-golden-path-demo",
+  "planned_files": [
+    "examples/golden-path/README.md",
+    "examples/golden-path/product-spec.md",
+    "examples/golden-path/implementation-plan.md",
+    "examples/golden-path/test-evidence.json",
+    "examples/golden-path/diff-coverage.json"
+  ],
+  "changed_files": [
+    "examples/golden-path/README.md",
+    "examples/golden-path/product-spec.md",
+    "examples/golden-path/implementation-plan.md",
+    "examples/golden-path/test-evidence.json",
+    "examples/golden-path/diff-coverage.json"
+  ],
+  "unexpected_files": [],
+  "missing_files": [],
+  "task_coverage": [
+    {
+      "task_ref": "task-golden-path-demo",
+      "status": "covered",
+      "changed_files": [
+        {
+          "path": "examples/golden-path/README.md",
+          "operation": "docs",
+          "digest": "sha256:golden-path-readme-fixture"
+        },
+        {
+          "path": "examples/golden-path/product-spec.md",
+          "operation": "docs",
+          "digest": "sha256:golden-path-product-spec-fixture"
+        },
+        {
+          "path": "examples/golden-path/implementation-plan.md",
+          "operation": "docs",
+          "digest": "sha256:golden-path-implementation-plan-fixture"
+        },
+        {
+          "path": "examples/golden-path/test-evidence.json",
+          "operation": "add",
+          "digest": "sha256:golden-path-test-evidence-fixture"
+        },
+        {
+          "path": "examples/golden-path/diff-coverage.json",
+          "operation": "add",
+          "digest": "sha256:golden-path-diff-coverage-fixture"
+        }
+      ]
+    }
+  ],
+  "boundary_assertions": {
+    "runtime_read_git_diff": false,
+    "command_execution": false,
+    "test_execution": false,
+    "git": false,
+    "git_write": false,
+    "commit": false,
+    "push": false,
+    "pr": false,
+    "merge": false
+  }
+}

package/examples/golden-path/implementation-plan.md

@@ -0,0 +1,62 @@
+---
+artifact_kind: implementation-plan
+version: 1
+source_skill: vibe-writing-plans
+status: draft
+next_skill: vibe-test-driven-development
+---
+
+# Implementation Plan
+
+## Goal
+
+Create a minimal team-mode demo that proves Vibecoding Kit can validate local evidence envelopes without requiring the full compliance chain.
+
+## Architecture Binding
+
+- architecture_artifact: none
+- architecture_gate: not required for team-mode demo
+
+## Implementation Task Registry
+
+- task_id: task-golden-path-demo
+  required: true
+  status: planned
+  source_refs: req-golden-path-demo, story-golden-path-demo
+  expected_files: examples/golden-path/README.md, examples/golden-path/product-spec.md, examples/golden-path/implementation-plan.md, examples/golden-path/test-evidence.json, examples/golden-path/diff-coverage.json
+  allowed_paths: examples/golden-path/**
+  expected_operations: add, docs
+  required_scenario_refs:
+  test_required: true
+  risk: low
+  rollback: remove examples/golden-path demo artifacts only
+
+## Tasks
+
+- id: task-golden-path-demo
+  owner: examples/golden-path
+  layer: docs / examples / developer UX
+  dependency_direction: examples -> runtime CLI contract
+  acceptance: team-mode demo artifacts bind the same task_ref and validate through deterministic runtime gates.
+  verification: local evidence envelope binds task_refs without runtime executing tests or reading git diff.
+
+## Delivery Traceability
+
+- traceability_artifact: none
+- traceability_ref: none
+
+## Evidence
+
+- evidence_sources: user_or_ci_supplied_only
+- not_verified: runtime does not execute tests or read git diff
+
+## Boundary
+
+- writes: false
+- state_directory_created: false
+- command_execution: false
+- test_execution: false
+- skill_execution: false
+- subagent: false
+- mcp: false
+- git: false

package/examples/golden-path/product-spec.md

@@ -0,0 +1,96 @@
+---
+artifact_kind: product-spec
+version: 1
+source_skill: vibe-product-spec
+status: draft
+next_skill: vibe-planning
+---
+
+# Product Spec Artifact
+
+## Goal
+
+- product_goal: Demonstrate the smallest team-mode evidence loop for Vibecoding Kit.
+- release_slice: Golden path demo for onboarding and local readiness validation.
+- priority: P0
+
+## Input
+
+- discovery_artifact: none
+- users_and_scenarios: maintainers and new team adopters validating the minimum workflow path.
+- constraints: keep the demo local, deterministic, and smaller than full-chain fixtures.
+
+## Output Fields
+
+- user_stories:
+  - story-golden-path-demo: As a new adopter, I can run a minimal team-mode example before adopting full compliance.
+- functional_requirements:
+  - req-golden-path-demo: Provide a minimal product spec, implementation plan, test evidence, and diff coverage bundle.
+- non_functional_requirements:
+  - nfr-readonly-boundary: The demo must not execute tests, read git diff, or perform git writes.
+- acceptance_criteria:
+  - methodology gate accepts this product spec.
+  - completion evidence bundle can consume this artifact with local evidence envelopes.
+- out_of_scope:
+  - Full product discovery, UI design, architecture design, delivery traceability, commit readiness, and release automation.
+- open_questions:
+  - none
+- next_skill: vibe-planning
+
+## Non Goals
+
+- out_of_scope: This demo is not a replacement for full compliance mode.
+
+## Risks
+
+- product_risks: Users may treat the demo as proof of test execution; documentation must preserve the runtime boundary.
+- delivery_risks: Example artifact refs must stay aligned with implementation evidence.
+- unresolved_decisions: none
+
+## Acceptance
+
+- acceptance_criteria:
+  - product_spec_gate_ok
+  - team_mode_completion_bundle_readiness_reported
+- fail_conditions:
+  - missing task refs
+  - evidence boundary escalation
+  - runtime performs tests or git operations
+- release_readiness_signal: demo commands return deterministic JSON readiness output.
+
+## Reference Registry
+
+reference_registry:
+  requirement_refs:
+    - req-golden-path-demo
+  product_story_refs:
+    - story-golden-path-demo
+
+## Evidence
+
+- evidence_sources: examples/golden-path/test-evidence.json, examples/golden-path/diff-coverage.json
+- not_verified: runtime does not execute tests, read git diff, or prove external provenance.
+
+## Boundary
+
+- writes: false
+- state_directory_created: false
+- command_execution: false
+- skill_execution: false
+- subagent: false
+- mcp: false
+- git: false
+
+## Handoff
+
+current_skill: vibe-product-spec
+next_skill: vibe-planning
+reason: team-mode demo has enough product scope for implementation planning.
+handoff:
+  goal: Provide the smallest local evidence loop for new adopters.
+  scope: examples/golden-path artifacts only.
+  key_decisions: Keep full compliance artifacts out of the minimal demo.
+  files: examples/golden-path/product-spec.md, examples/golden-path/implementation-plan.md, examples/golden-path/test-evidence.json, examples/golden-path/diff-coverage.json
+  risks: Do not imply runtime executed tests or git operations.
+  acceptance: methodology gate and completion readiness output are deterministic.
+stop_condition: none

package/examples/golden-path/test-evidence.json

@@ -0,0 +1,29 @@
+{
+  "version": 1,
+  "artifact_kind": "test-evidence",
+  "status": "provided",
+  "test_evidence_ref": "test-golden-path-demo",
+  "runs": [
+    {
+      "id": "test-golden-path-demo",
+      "command": "node tools/vibe-runtime/index.mjs completion --evidence-bundle --from-product-spec examples/golden-path/product-spec.md --from-plan examples/golden-path/implementation-plan.md --from-test-evidence examples/golden-path/test-evidence.json --from-diff-coverage examples/golden-path/diff-coverage.json --json",
+      "exit_code": 0,
+      "timestamp": "2026-03-14T00:00:00.000Z",
+      "output_digest": "sha256:golden-path-demo-output-fixture",
+      "task_refs": ["task-golden-path-demo"],
+      "scenario_refs": ["scenario-golden-path-demo"],
+      "status": "pass"
+    }
+  ],
+  "boundary_assertions": {
+    "runtime_executed_command": false,
+    "command_execution": false,
+    "test_execution": false,
+    "git": false,
+    "git_write": false,
+    "commit": false,
+    "push": false,
+    "pr": false,
+    "merge": false
+  }
+}

package/examples/runtime-fixtures/architecture-design.md

@@ -0,0 +1,128 @@
+---
+artifact_kind: architecture-design
+version: 1
+source_skill: vibe-planning
+status: accepted
+next_skill: vibe-writing-plans
+---
+
+# Architecture Design Fixture
+
+## Goal
+
+- architecture_goal: Insert a delivery methodology gate between UI contract and implementation planning.
+- risk_class: medium contract extension with read-only runtime behavior.
+- delivery_slice: Architecture artifact, traceability artifact, and completion evidence digest binding.
+
+## Input
+
+- product_spec_artifact: examples/runtime-fixtures/product-spec.md
+- ui_design_artifact: examples/runtime-fixtures/ui-design-contract.md
+- constraints: Local-only deterministic gates; no git, test, browser, subagent, MCP, platform API, or state write.
+
+## Architecture Decision Frame
+
+- responsibility_owner: tools/vibe-runtime/runtime-delivery-methodology-gates.mjs owns delivery artifact validation.
+- layer_and_dependency_direction: runtime-interaction-command delegates to command wrapper; command wrapper delegates to core gate; core reads local files only.
+- data_flow: local architecture or traceability artifact -> parser -> checks -> digest-bound envelope -> manual follow-up.
+- state_lifecycle: none; no .vibecoding-state creation.
+- contract_sync: templates, fixtures, docs, doctor, runtime-check, release-check, CLI usage, completion bundle.
+- blast_radius: templates, skills, runtime methodology gate, completion evidence bundle, validation and release smoke.
+- evolution_path: new delivery gate module keeps architecture/traceability rules separate from product/UI rules.
+- complexity_pressure: avoids expanding runtime index and avoids common cross-domain mutable helper state.
+- architecture_decisions: Use deterministic marker checks first; semantic traceability scoring remains out of scope.
+
+## Module Ownership
+
+- owners: tools/vibe-runtime/runtime-delivery-methodology-gates.mjs
+- new_modules: runtime-delivery-methodology-gates.mjs, runtime-delivery-methodology-command.mjs
+- entrypoints: tools/vibe-runtime/index.mjs remains thin through existing interaction dispatch.
+
+## Layer And Dependency Direction
+
+- layers: CLI args -> interaction command -> delivery command wrapper -> delivery gate core.
+- allowed_dependencies: command wrapper may import gate core; gate core may import local read/digest helpers.
+- forbidden_dependencies: gate core must not import doctor, runtime-check, release-check, git, platform, or execution modules.
+
+## Data Flow
+
+- inputs: architecture-design.md and delivery-traceability.yaml.
+- transformations: parse frontmatter/YAML markers and required fields.
+- io_boundaries: read local files inside root only.
+- outputs: JSON/text envelope with checks, blocked_reasons, source_bindings, and gate_digest.
+- error_envelope: missing files, unsupported kind, missing fields, and unsafe boundary markers become blocked reasons or explicit errors.
+
+## State Lifecycle
+
+- state_created_by: none
+- state_validated_by: deterministic runtime gate only
+- state_consumed_by: completion evidence bundle and human workflow handoff
+- persistence: none
+
+## Contract Sync
+
+- cli_args: methodology --gate uses existing --kind and --from-file; completion bundle adds local artifact inputs.
+- json_envelope: delivery_methodology_gate and expanded completion_evidence_bundle.
+- artifact_templates: architecture-design.md and delivery-traceability.yaml.
+- docs: README, runtime contract, workflow chaining, acceptance checklist, release guide, runtime README.
+- doctor_runtime_release_checks: doctor, runtime-check, release-check fast smoke.
+
+## Blast Radius
+
+- touched_layers: templates, skills, runtime read-only command, validation, docs, release smoke.
+- commands: methodology --gate, completion --evidence-bundle.
+- fixtures: examples/runtime-fixtures.
+- release_smoke: fast suite reads fixtures and checks read-only boundaries.
+
+## Verification Strategy
+
+- verification_strategy: Run fixture methodology gates, expanded completion bundle smoke, doctor, runtime-check, architecture-check, and release fast.
+- static_checks: node tools/vibe-runtime-check/index.mjs
+- smoke_checks: node tools/vibe-release-check/index.mjs --suite fast --quiet
+- manual_checks: confirm no git write automation was added.
+
+## Risks
+
+- architecture_risks: Structure can pass while semantic architecture quality remains weak.
+- delivery_risks: CLI usage, docs, and smoke manifest can drift if not checked together.
+- rollback_notes: Remove delivery gate module, template, fixture, completion inputs, and release smoke if contract must be reverted.
+
+## Non Goals
+
+- out_of_scope: Browser execution, test execution, semantic scoring, git automation, PR creation, and state persistence.
+
+## Reference Registry
+
+reference_registry:
+  architecture_decision_refs:
+    - adr-delivery-methodology-gate
+
+## Evidence
+
+- evidence_sources: This fixture and release fast smoke.
+- not_verified: No production source behavior is executed by this artifact.
+
+## Boundary
+
+- writes: false
+- state_directory_created: false
+- command_execution: false
+- test_execution: false
+- skill_execution: false
+- subagent: false
+- mcp: false
+- git: false
+
+## Handoff
+
+current_skill: vibe-planning
+next_skill: vibe-writing-plans
+reason: Architecture owner, data flow, state lifecycle, and verification strategy are explicit enough for implementation planning.
+handoff:
+  goal: Plan the delivery gate and evidence bundle implementation.
+  scope: Runtime delivery methodology and completion evidence contract.
+  key_decisions: Keep validation deterministic, local-only, and no-git.
+  files: tools/vibe-runtime/runtime-delivery-methodology-gates.mjs
+  risks: Semantic architecture quality is not scored.
+  acceptance: architecture-design fixture passes methodology gate.
+stop_condition: none

package/examples/runtime-fixtures/commit-readiness.json

@@ -0,0 +1,31 @@
+{
+  "version": 1,
+  "artifact_kind": "commit-readiness-evidence",
+  "status": "provided",
+  "commit_readiness_ref": "commit-readiness-local",
+  "commit_subject": {
+    "suggested": "Add delivery evidence chain gates",
+    "commit_execution_authorized": false
+  },
+  "readiness": {
+    "completion_bundle_digest_required": true,
+    "diff_coverage_evidence_bound": true,
+    "manual_git_decision_required": true,
+    "runtime_git_execution_authorized": false
+  },
+  "boundary_assertions": {
+    "git": false,
+    "git_write": false,
+    "git_add": false,
+    "commit": false,
+    "push": false,
+    "pr": false,
+    "merge": false,
+    "tag": false,
+    "history_rewrite": false,
+    "command_execution": false,
+    "test_execution": false,
+    "subagent": false,
+    "mcp": false
+  }
+}

package/examples/runtime-fixtures/delivery-traceability.yaml

@@ -0,0 +1,32 @@
+version: 1
+artifact_kind: delivery-traceability
+source_skill: vibe-writing-plans
+status: accepted
+next_skill: vibe-test-driven-development
+
+# Evidence
+evidence_sources:
+  - examples/runtime-fixtures/evidence.json
+
+# Boundary
+boundary:
+  writes: false
+  state_directory_created: false
+  command_execution: false
+  test_execution: false
+  skill_execution: false
+  subagent: false
+  mcp: false
+  git: false
+links:
+  - id: trace-product-ui-architecture-gate
+    requirement_ref: req-product-ui-delivery-chain
+    product_story_ref: story-maintainer-validates-delivery-chain
+    ui_flow_ref: flow-runtime-artifact-gate-review
+    architecture_decision_ref: adr-delivery-methodology-gate
+    implementation_task_ref: task-extend-completion-bundle
+    test_evidence_ref: test-release-fast-delivery-chain
+    scenario_ref: product-gate-happy-path
+    product_acceptance_ref: acceptance-product-ui-delivery-chain
+    commit_readiness_ref: commit-readiness-local
+    status: verified

package/examples/runtime-fixtures/diff-coverage.json

@@ -0,0 +1,73 @@
+{
+  "version": 1,
+  "artifact_kind": "diff-coverage-evidence",
+  "status": "provided",
+  "diff_coverage_ref": "diff-delivery-chain-fixture",
+  "planned_files": [
+    "templates/architecture-design.md",
+    "templates/delivery-traceability.yaml",
+    "tools/vibe-runtime/runtime-delivery-methodology-gates.mjs",
+    "tools/vibe-runtime/runtime-completion-evidence-bundle.mjs",
+    "examples/runtime-fixtures/architecture-design.md",
+    "examples/runtime-fixtures/delivery-traceability.yaml"
+  ],
+  "changed_files": [
+    "templates/architecture-design.md",
+    "templates/delivery-traceability.yaml",
+    "tools/vibe-runtime/runtime-delivery-methodology-gates.mjs",
+    "tools/vibe-runtime/runtime-completion-evidence-bundle.mjs",
+    "examples/runtime-fixtures/architecture-design.md",
+    "examples/runtime-fixtures/delivery-traceability.yaml"
+  ],
+  "unexpected_files": [],
+  "missing_files": [],
+  "task_coverage": [
+    {
+      "task_ref": "task-extend-completion-bundle",
+      "status": "covered",
+      "changed_files": [
+        {
+          "path": "templates/architecture-design.md",
+          "operation": "modify",
+          "digest": "sha256:templates-architecture-design-fixture"
+        },
+        {
+          "path": "templates/delivery-traceability.yaml",
+          "operation": "modify",
+          "digest": "sha256:templates-delivery-traceability-fixture"
+        },
+        {
+          "path": "tools/vibe-runtime/runtime-delivery-methodology-gates.mjs",
+          "operation": "modify",
+          "digest": "sha256:runtime-delivery-methodology-gates-fixture"
+        },
+        {
+          "path": "tools/vibe-runtime/runtime-completion-evidence-bundle.mjs",
+          "operation": "modify",
+          "digest": "sha256:runtime-completion-evidence-bundle-fixture"
+        },
+        {
+          "path": "examples/runtime-fixtures/architecture-design.md",
+          "operation": "modify",
+          "digest": "sha256:examples-architecture-design-fixture"
+        },
+        {
+          "path": "examples/runtime-fixtures/delivery-traceability.yaml",
+          "operation": "modify",
+          "digest": "sha256:examples-delivery-traceability-fixture"
+        }
+      ]
+    }
+  ],
+  "boundary_assertions": {
+    "runtime_read_git_diff": false,
+    "command_execution": false,
+    "test_execution": false,
+    "git": false,
+    "git_write": false,
+    "commit": false,
+    "push": false,
+    "pr": false,
+    "merge": false
+  }
+}

package/examples/runtime-fixtures/evidence.json

@@ -0,0 +1,20 @@
+{
+  "version": 1,
+  "artifact_kind": "engineering-evidence",
+  "status": "provided",
+  "checks": [
+    {
+      "command": "node tools/vibe-runtime/index.mjs methodology --gate --kind product-spec --from-file examples/runtime-fixtures/product-spec.md --json",
+      "status": "pass",
+      "summary": "product methodology gate returned ok true"
+    },
+    {
+      "command": "node tools/vibe-runtime/index.mjs methodology --gate --kind scenario-acceptance --from-file examples/runtime-fixtures/scenario-acceptance.yaml --json",
+      "status": "pass",
+      "summary": "scenario acceptance gate returned ok true"
+    }
+  ],
+  "not_verified": [
+    "No browser, git, subagent, MCP, platform API, or external network action was executed by this evidence fixture."
+  ]
+}

package/examples/runtime-fixtures/implementation-plan.md

@@ -0,0 +1,54 @@
+# Implementation Plan Fixture
+
+## Goal
+
+Implement the delivery methodology evidence chain without adding runtime execution or git automation.
+
+## Architecture Binding
+
+- architecture_artifact: examples/runtime-fixtures/architecture-design.md
+- architecture_gate: methodology --gate --kind architecture-design
+
+## Implementation Task Registry
+
+- task_id: task-extend-completion-bundle
+  required: true
+  status: planned
+  source_refs: req-product-ui-delivery-chain, story-maintainer-validates-delivery-chain, adr-delivery-methodology-gate
+  expected_files: tools/vibe-runtime/runtime-completion-evidence-bundle.mjs, tools/vibe-runtime/runtime-delivery-methodology-gates.mjs, templates/architecture-design.md, templates/delivery-traceability.yaml, examples/runtime-fixtures/architecture-design.md, examples/runtime-fixtures/delivery-traceability.yaml
+  allowed_paths: tools/vibe-runtime/**, templates/**, examples/runtime-fixtures/**
+  expected_operations: add, modify, docs
+  required_scenario_refs: product-gate-happy-path
+  test_required: true
+  risk: medium
+  rollback: revert delivery chain runtime, fixture, and template changes only
+
+## Tasks
+
+- id: task-extend-completion-bundle
+  owner: tools/vibe-runtime/runtime-completion-evidence-bundle.mjs
+  layer: runtime read-only aggregation
+  dependency_direction: command wrapper -> bundle core -> local artifact readers
+  acceptance: expanded completion bundle binds architecture, traceability, plan, test, diff coverage, and commit readiness digests.
+  verification: release fast smoke checks deterministic JSON markers.
+
+## Delivery Traceability
+
+- traceability_artifact: examples/runtime-fixtures/delivery-traceability.yaml
+- traceability_ref: trace-product-ui-architecture-gate
+
+## Evidence
+
+- evidence_sources: examples/runtime-fixtures/evidence.json, examples/runtime-fixtures/test-evidence.json, examples/runtime-fixtures/diff-coverage.json
+- not_verified: runtime does not execute tests or read git diff
+
+## Boundary
+
+- writes: false
+- state_directory_created: false
+- command_execution: false
+- test_execution: false
+- skill_execution: false
+- subagent: false
+- mcp: false
+- git: false

package/examples/runtime-fixtures/negative/commit-readiness-boundary-escalated.json

@@ -0,0 +1,27 @@
+{
+  "version": 1,
+  "artifact_kind": "commit-readiness-evidence",
+  "status": "provided",
+  "commit_readiness_ref": "commit-readiness-local",
+  "commit_subject": {
+    "suggested": "Escalated commit boundary fixture",
+    "commit_execution_authorized": true
+  },
+  "readiness": {
+    "manual_git_decision_required": false,
+    "runtime_git_execution_authorized": true
+  },
+  "boundary_assertions": {
+    "git": false,
+    "git_write": true,
+    "git_add": false,
+    "commit": false,
+    "push": false,
+    "pr": false,
+    "merge": false,
+    "tag": false,
+    "history_rewrite": false,
+    "command_execution": false,
+    "test_execution": false
+  }
+}

package/examples/runtime-fixtures/negative/delivery-traceability-bad-ref.yaml

@@ -0,0 +1,32 @@
+version: 1
+artifact_kind: delivery-traceability
+source_skill: vibe-writing-plans
+status: accepted
+next_skill: vibe-test-driven-development
+
+# Evidence
+evidence_sources:
+  - examples/runtime-fixtures/evidence.json
+
+# Boundary
+boundary:
+  writes: false
+  state_directory_created: false
+  command_execution: false
+  test_execution: false
+  skill_execution: false
+  subagent: false
+  mcp: false
+  git: false
+links:
+  - id: trace-product-ui-architecture-gate-bad-ref
+    requirement_ref: req-product-ui-delivery-chain
+    product_story_ref: story-maintainer-validates-delivery-chain
+    ui_flow_ref: flow-runtime-artifact-gate-review
+    architecture_decision_ref: adr-delivery-methodology-gate
+    implementation_task_ref: task-extend-completion-bundle
+    test_evidence_ref: test-release-fast-delivery-chain
+    scenario_ref: scenario-does-not-exist
+    product_acceptance_ref: acceptance-product-ui-delivery-chain
+    commit_readiness_ref: commit-readiness-local
+    status: verified