@jtf19/vibecoding-kit 0.1.0

package/examples/runtime-fixtures/negative/diff-coverage-changed-file-without-task-ref.json

@@ -0,0 +1,40 @@
+{
+  "version": 1,
+  "artifact_kind": "diff-coverage-evidence",
+  "status": "provided",
+  "diff_coverage_ref": "diff-task-unexplained-file-fixture",
+  "planned_files": [
+    "tools/vibe-runtime/runtime-completion-evidence-bundle.mjs",
+    "tools/vibe-runtime/unplanned-change.mjs"
+  ],
+  "changed_files": [
+    "tools/vibe-runtime/runtime-completion-evidence-bundle.mjs",
+    "tools/vibe-runtime/unplanned-change.mjs"
+  ],
+  "unexpected_files": [],
+  "missing_files": [],
+  "task_coverage": [
+    {
+      "task_ref": "task-extend-completion-bundle",
+      "status": "covered",
+      "changed_files": [
+        {
+          "path": "tools/vibe-runtime/runtime-completion-evidence-bundle.mjs",
+          "operation": "modify",
+          "digest": "sha256:runtime-completion-evidence-bundle-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/negative/diff-coverage-operation-mismatch.json

@@ -0,0 +1,38 @@
+{
+  "version": 1,
+  "artifact_kind": "diff-coverage-evidence",
+  "status": "provided",
+  "diff_coverage_ref": "diff-operation-mismatch-fixture",
+  "planned_files": [
+    "tools/vibe-runtime/runtime-completion-evidence-bundle.mjs"
+  ],
+  "changed_files": [
+    "tools/vibe-runtime/runtime-completion-evidence-bundle.mjs"
+  ],
+  "unexpected_files": [],
+  "missing_files": [],
+  "task_coverage": [
+    {
+      "task_ref": "task-extend-completion-bundle",
+      "status": "covered",
+      "changed_files": [
+        {
+          "path": "tools/vibe-runtime/runtime-completion-evidence-bundle.mjs",
+          "operation": "delete",
+          "digest": "sha256:operation-mismatch-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/negative/diff-coverage-required-task-missing.json

@@ -0,0 +1,24 @@
+{
+  "version": 1,
+  "artifact_kind": "diff-coverage-evidence",
+  "status": "provided",
+  "diff_coverage_ref": "diff-required-task-missing-fixture",
+  "planned_files": [
+    "tools/vibe-runtime/runtime-completion-evidence-bundle.mjs"
+  ],
+  "changed_files": [],
+  "unexpected_files": [],
+  "missing_files": [],
+  "task_coverage": [],
+  "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/negative/diff-coverage-unexpected-file.json

@@ -0,0 +1,20 @@
+{
+  "version": 1,
+  "artifact_kind": "diff-coverage-evidence",
+  "status": "provided",
+  "diff_coverage_ref": "diff-delivery-chain-fixture",
+  "planned_files": ["tools/vibe-runtime/runtime-completion-evidence-bundle.mjs"],
+  "changed_files": [
+    "tools/vibe-runtime/runtime-completion-evidence-bundle.mjs",
+    "unexpected/generated-file.txt"
+  ],
+  "unexpected_files": ["unexpected/generated-file.txt"],
+  "missing_files": [],
+  "boundary_assertions": {
+    "runtime_read_git_diff": false,
+    "command_execution": false,
+    "test_execution": false,
+    "git": false,
+    "git_write": false
+  }
+}

package/examples/runtime-fixtures/negative/test-evidence-missing-output-digest.json

@@ -0,0 +1,23 @@
+{
+  "version": 1,
+  "artifact_kind": "test-evidence",
+  "status": "provided",
+  "test_evidence_ref": "test-release-fast-delivery-chain",
+  "runs": [
+    {
+      "id": "test-release-fast-delivery-chain",
+      "command": "node tools/vibe-release-check/index.mjs --suite fast --quiet",
+      "exit_code": 0,
+      "timestamp": "2026-03-14T00:00:00.000Z",
+      "scenario_refs": ["product-gate-happy-path"],
+      "status": "pass"
+    }
+  ],
+  "boundary_assertions": {
+    "runtime_executed_command": false,
+    "command_execution": false,
+    "test_execution": false,
+    "git": false,
+    "git_write": false
+  }
+}

package/examples/runtime-fixtures/negative/test-evidence-risky-task-missing.json

@@ -0,0 +1,29 @@
+{
+  "version": 1,
+  "artifact_kind": "test-evidence",
+  "status": "provided",
+  "test_evidence_ref": "test-risky-task-missing-fixture",
+  "runs": [
+    {
+      "id": "test-risky-task-missing-fixture",
+      "command": "node tools/vibe-release-check/index.mjs --suite fast --quiet",
+      "exit_code": 0,
+      "timestamp": "2026-03-14T00:00:00.000Z",
+      "output_digest": "sha256:risky-task-missing-fixture",
+      "task_refs": ["task-does-not-exist"],
+      "scenario_refs": ["product-gate-happy-path"],
+      "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/product-acceptance.md

@@ -0,0 +1,86 @@
+---
+artifact_kind: product-acceptance
+version: 1
+source_skill: vibe-product-acceptance
+status: accepted
+next_skill: vibe-verification-before-completion
+---
+
+# Product Acceptance Fixture
+
+## Goal
+
+- product_claim: Product/UI artifact gates are ready as local read-only completion evidence.
+- acceptance_scope: Product spec, UI contract, scenario DSL, and boundary claims.
+- ship_decision: pass
+
+## Input
+
+- product_spec_artifact: examples/runtime-fixtures/product-spec.md
+- ui_design_contract_artifact: examples/runtime-fixtures/ui-design-contract.md
+- scenario_acceptance_artifact: examples/runtime-fixtures/scenario-acceptance.yaml
+- engineering_evidence: examples/runtime-fixtures/evidence.json
+
+## Output Fields
+
+- product_claim: Artifact gates validate product/UI workflow contracts before completion.
+- scenario_coverage: Happy-path runtime gate scenario is covered by scenario-acceptance.yaml.
+- user_flow_evidence: CLI and JSON flows are represented by fixtures and smoke commands.
+- ui_state_evidence: Success and blocked states are represented by gate outcome and blockers.
+- accessibility_evidence: Text output uses labels rather than color-only status.
+- metric_readiness: Gate pass/block and digest are observable local signals.
+- experience_gaps: Visual quality and browser behavior are intentionally not verified.
+- not_verified: Browser rendering, screenshots, external platform behavior.
+- ship_decision: pass
+- next_skill: vibe-verification-before-completion
+
+## Non Goals
+
+- not_in_scope: Replacing engineering verification or commit readiness.
+
+## Risks
+
+- experience_risks: Product acceptance may be mistaken for test execution.
+- release_risks: Release docs must say smoke checks are read-only.
+- unresolved_decisions: none
+
+## Acceptance
+
+- pass_conditions: Product spec, UI design, scenario DSL, and product acceptance gates pass.
+- fail_conditions: Missing scenario evidence or unsafe boundary assertions.
+- blocked_conditions: Product or UI artifact lacks source binding, evidence, or handoff.
+
+## Reference Registry
+
+reference_registry:
+  product_acceptance_refs:
+    - acceptance-product-ui-delivery-chain
+
+## Evidence
+
+- evidence_sources: Static fixture and release smoke commands.
+- not_verified: No browser, test runner, git, subagent, MCP, or platform API was run by this artifact.
+
+## Boundary
+
+- writes: false
+- state_directory_created: false
+- command_execution: false
+- skill_execution: false
+- subagent: false
+- mcp: false
+- git: false
+
+## Handoff
+
+current_skill: vibe-product-acceptance
+next_skill: vibe-verification-before-completion
+reason: Product acceptance evidence is present and can feed completion verification.
+handoff:
+  goal: Verify completion evidence before reporting done.
+  scope: Local evidence bundle only.
+  key_decisions: Keep git and release actions manual.
+  files: examples/runtime-fixtures/evidence.json
+  risks: Engineering verification still needs separate evidence.
+  acceptance: completion --evidence-bundle summarizes product and engineering readiness.
+stop_condition: none

package/examples/runtime-fixtures/product-discovery.md

@@ -0,0 +1,84 @@
+---
+artifact_kind: product-discovery
+version: 1
+source_skill: vibe-product-discovery
+status: accepted
+next_skill: vibe-product-spec
+---
+
+# Product Discovery Fixture
+
+## Goal
+
+- problem: Users need a visible way to confirm runtime product artifact checks before implementation.
+- target_users: maintainers using Vibecoding workflow skills
+- value_hypothesis: Standard artifacts reduce ambiguous handoffs between product, UI, and engineering workflows.
+- mvp_slice: Validate one product artifact locally through a read-only gate.
+
+## Input
+
+- original_request: Add product and UI artifact gates.
+- context: Runtime commands already support read-only methodology checks.
+- constraints: Do not execute workflows, tests, git, browser, subagents, MCP, or platform APIs.
+
+## Output Fields
+
+- scenarios: Maintainer runs a local gate against a product spec fixture.
+- current_alternatives: Free-form markdown that cannot be checked deterministically.
+- success_metrics: Gate returns a deterministic digest and actionable gaps.
+- anti_metrics: Gate mutates state or runs implementation commands.
+- mvp_slice: One local artifact and one read-only gate command.
+- non_goals: No automated implementation, browser validation, or git action.
+- risks: Artifact fields may drift unless checked by runtime-check.
+- decision: continue
+- next_skill: vibe-product-spec
+
+## Non Goals
+
+- not_in_scope: Visual regression, browser automation, or code generation.
+
+## Risks
+
+- product_risks: Users may confuse contract completeness with product quality.
+- assumptions: Local artifact content is user-provided evidence.
+- open_questions: none
+
+## Acceptance
+
+- discovery_complete_when: Required fields and handoff are present.
+- blocked_when: Problem, users, MVP slice, or evidence is missing.
+
+## Reference Registry
+
+reference_registry:
+  requirement_refs:
+    - req-product-ui-delivery-chain
+
+## Evidence
+
+- evidence_sources: This fixture is static local evidence for release smoke.
+- not_verified: No user research was run.
+
+## Boundary
+
+- writes: false
+- state_directory_created: false
+- command_execution: false
+- skill_execution: false
+- subagent: false
+- mcp: false
+- git: false
+
+## Handoff
+
+current_skill: vibe-product-discovery
+next_skill: vibe-product-spec
+reason: Discovery is bounded and ready for product specification.
+handoff:
+  goal: Define checkable product/UI workflow artifacts.
+  scope: Local artifact contract only.
+  key_decisions: Keep gates read-only.
+  files: templates/product-spec.md
+  risks: Contract completeness does not prove runtime behavior.
+  acceptance: Product spec artifact passes methodology gate.
+stop_condition: none

package/examples/runtime-fixtures/product-spec.md

@@ -0,0 +1,88 @@
+---
+artifact_kind: product-spec
+version: 1
+source_skill: vibe-product-spec
+status: accepted
+next_skill: vibe-ui-design
+---
+
+# Product Spec Fixture
+
+## Goal
+
+- product_goal: Provide a read-only product artifact gate that validates a local spec before planning.
+- release_slice: Add standard artifact contract checks for product spec and UI handoff.
+- priority: P1 because product workflow output must become reusable runtime evidence.
+
+## Input
+
+- discovery_artifact: examples/runtime-fixtures/product-discovery.md
+- users_and_scenarios: Maintainer checks product spec completeness before implementation planning.
+- constraints: Local-only, deterministic, no writes, no command execution, no git.
+
+## Output Fields
+
+- product_goal: Validate product spec artifacts as workflow contracts.
+- users_and_scenarios: Maintainers and assistant sessions using product/UI workflow skills.
+- user_stories: As a maintainer, I can gate a product spec file and see missing fields before planning.
+- functional_requirements: Gate checks frontmatter, sections, required fields, evidence, boundary, and handoff.
+- non_functional_requirements: Deterministic digest, root-relative file binding, and no runtime state writes.
+- acceptance_criteria: Passing artifact returns ok true, gate_outcome pass, and a gate digest.
+- priority: P1 product workflow contract.
+- release_slice: Product spec and UI design gate smoke fixtures.
+- out_of_scope: Running tests, writing state, browser validation, git automation.
+- open_questions: none
+- next_skill: vibe-ui-design
+
+## Non Goals
+
+- out_of_scope: Product quality scoring and automated implementation.
+
+## Risks
+
+- product_risks: Empty but syntactically present sections could still be weak evidence.
+- delivery_risks: CLI help and validation tools may drift from command behavior.
+- unresolved_decisions: none
+
+## Acceptance
+
+- acceptance_criteria: Runtime methodology gate passes this fixture.
+- fail_conditions: Missing evidence, boundary, next_skill, or required requirement fields.
+- release_readiness_signal: release-check fast suite can smoke this fixture.
+
+## Reference Registry
+
+reference_registry:
+  requirement_refs:
+    - req-product-ui-delivery-chain
+  product_story_refs:
+    - story-maintainer-validates-delivery-chain
+
+## Evidence
+
+- evidence_sources: Static fixture for methodology gate smoke.
+- not_verified: No implementation test was executed by this artifact.
+
+## 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-ui-design
+reason: Product requirements are checkable and UI contract is needed.
+handoff:
+  goal: Define UI states and interaction contract for artifact gates.
+  scope: UI contract fixture and gate evidence.
+  key_decisions: Keep validation deterministic and read-only.
+  files: templates/ui-design-contract.md
+  risks: UI quality is not visually judged by this gate.
+  acceptance: UI design artifact passes methodology gate.
+stop_condition: none

package/examples/runtime-fixtures/scenario-acceptance.yaml

@@ -0,0 +1,32 @@
+version: 1
+artifact_kind: scenario-acceptance
+source_skill: vibe-product-acceptance
+status: accepted
+next_skill: vibe-product-acceptance
+boundary:
+  writes: false
+  state_directory_created: false
+  command_execution: false
+  skill_execution: false
+  subagent: false
+  mcp: false
+  git: false
+scenarios:
+  - id: product-gate-happy-path
+    user: Vibecoding maintainer
+    given:
+      - product spec and UI contract artifacts exist under the project root
+    when:
+      - user runs methodology --gate with a product artifact file
+    then:
+      - runtime returns a deterministic gate digest and no writes
+    ui_states:
+      - success
+      - blocked
+    evidence:
+      required:
+        - release_smoke_output
+        - json_envelope
+      optional:
+        - manual_observation
+    status: pass

package/examples/runtime-fixtures/test-evidence.json

@@ -0,0 +1,29 @@
+{
+  "version": 1,
+  "artifact_kind": "test-evidence",
+  "status": "provided",
+  "test_evidence_ref": "test-release-fast-delivery-chain",
+  "runs": [
+    {
+      "id": "test-release-fast-delivery-chain",
+      "command": "node tools/vibe-release-check/index.mjs --suite fast --quiet",
+      "exit_code": 0,
+      "timestamp": "2026-03-14T00:00:00.000Z",
+      "output_digest": "sha256:release-fast-delivery-chain-fixture",
+      "task_refs": ["task-extend-completion-bundle"],
+      "scenario_refs": ["product-gate-happy-path"],
+      "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/ui-design-contract.md

@@ -0,0 +1,87 @@
+---
+artifact_kind: ui-design-contract
+version: 1
+source_skill: vibe-ui-design
+status: accepted
+next_skill: vibe-planning
+---
+
+# UI Design Contract Fixture
+
+## Goal
+
+- design_goal: Make product artifact gate results understandable in one terminal or JSON envelope.
+- primary_user_flow: User runs methodology gate, reads pass/block result, then fixes artifact gaps manually.
+- target_surfaces: CLI text output and JSON envelope.
+
+## Input
+
+- product_spec_artifact: examples/runtime-fixtures/product-spec.md
+- user_stories: Maintainer checks contract gaps before planning.
+- design_constraints: No browser, no screenshots, no visual scoring.
+
+## Output Fields
+
+- screens: CLI result screen and JSON envelope consumer.
+- user_flow: Run command, inspect checks, fix artifact, rerun gate.
+- information_architecture: Stage, kind, artifact, source skill, next skill, check count, blockers, digest, boundary.
+- components: Summary header, source binding block, checks list, boundary line, manual action.
+- ui_states: loading is not applicable; success, blocked, and invalid input states are represented.
+- copy_rules: Text must say read-only and never imply workflow execution.
+- interaction_rules: User manually reruns command after editing local artifact.
+- responsive_rules: Terminal output stays line-oriented and JSON stays machine-readable.
+- accessibility: Plain text output preserves semantic labels and does not rely on color.
+- design_acceptance: Text and JSON expose blockers and boundary assertions.
+- open_questions: none
+- next_skill: vibe-planning
+
+## Non Goals
+
+- not_in_scope: Browser UI, screenshot comparison, generated design mockups.
+
+## Risks
+
+- usability_risks: Too many checks may be noisy unless blockers are concise.
+- accessibility_risks: Color-only status must not be introduced.
+- open_questions: none
+
+## Acceptance
+
+- design_acceptance: CLI text includes outcome, blockers, digest, and manual action.
+- ui_state_acceptance: Pass and blocked states are both representable.
+- accessibility_acceptance: Plain labels are available in text and JSON.
+
+## Reference Registry
+
+reference_registry:
+  ui_flow_refs:
+    - flow-runtime-artifact-gate-review
+
+## Evidence
+
+- evidence_sources: Static fixture for UI methodology gate smoke.
+- not_verified: No browser rendering or visual review was run.
+
+## Boundary
+
+- writes: false
+- state_directory_created: false
+- command_execution: false
+- skill_execution: false
+- subagent: false
+- mcp: false
+- git: false
+
+## Handoff
+
+current_skill: vibe-ui-design
+next_skill: vibe-planning
+reason: UI contract is defined and ready for implementation planning.
+handoff:
+  goal: Plan runtime gate implementation without expanding execution paths.
+  scope: CLI wrapper and read-only envelope.
+  key_decisions: Text output stays deterministic and no visual scoring is performed.
+  files: tools/vibe-runtime/runtime-product-methodology-command.mjs
+  risks: CLI usage docs can drift.
+  acceptance: Runtime smoke validates the UI design fixture.
+stop_condition: none

package/hooks/post-tool-compact/README.md

@@ -0,0 +1,47 @@
+# Post Tool Compact Hook
+
+## 状态
+
+第一阶段预留，不实现自动压缩。
+
+## 目标
+
+后续接入命令输出压缩工具，用于减少 agent 看到的大段日志、测试输出、构建输出和搜索结果。
+
+## 后续参考
+
+- `distill`：轻量命令输出压缩。
+- `token-savior`：更完整的 compactors、hook 初始化和 MCP 工具能力。
+
+## 第一阶段边界
+
+当前只保留目录和说明，避免过早引入复杂 hook、MCP 或 memory 系统。
+
+该 hook 不是自动压缩 runtime，也不会替 agent 决定是否丢弃上下文。需要压缩时，仍应显式进入 `vibe-context-compact`，输出可交接的 handoff 后再继续下一步。
+
+## 第二阶段边界
+
+第二阶段可以使用 `tools/vibe-compact/` 做本地文本整理，但它仍是手动或显式调用的辅助工具，不是长期 memory，也不是跨会话索引。
+
+## 长输出处理路径
+
+当命令输出、测试日志、构建日志或搜索结果过长时，按顺序处理：
+
+1. 先判断当前任务是否仍需要完整日志。
+2. 如果只需要交接状态，显式进入 `vibe-context-compact`。
+3. 如果需要本地整理文本，可显式运行 `tools/vibe-compact/index.mjs`。
+4. 将整理后的目标、状态、风险、下一步写入 `Workflow Handoff`。
+5. 根据 `next_skill` 决定是否继续，不能自动进入下一阶段。
+
+示例：
+
+```bash
+node tools/vibe-compact/index.mjs --input .tmp/long-output.txt --format markdown
+```
+
+## 禁止事项
+
+- 不自动压缩用户未要求丢弃的上下文。
+- 不自动删除原始日志。
+- 不把压缩结果当作长期 memory。
+- 不在没有 `Workflow Handoff` 的情况下继续推进。