@hassangameryt/freeflow 0.3.0 → 0.5.0

package/evals/scripts/validate-release-metadata.sh

@@ -1,486 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-usage() {
-  cat >&2 <<'EOF'
-Usage:
-  validate-release-metadata.sh [--mode local|prepublish|release]
-                               [--release-version VERSION]
-                               [--format text|json]
-
-Default:
-  validate-release-metadata.sh --mode prepublish --release-version 0.3.0 --format text
-EOF
-}
-
-fail_usage() {
-  usage
-  printf 'FAIL: %s\n' "$1" >&2
-  exit 2
-}
-
-script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-repo_root="$(git -C "$script_dir" rev-parse --show-toplevel)"
-plugin_root="$repo_root"
-
-mode="prepublish"
-release_version="0.3.0"
-format="text"
-
-while [ "$#" -gt 0 ]; do
-  case "$1" in
-    --mode)
-      mode="${2:-}"
-      shift 2
-      ;;
-    --release-version)
-      release_version="${2:-}"
-      shift 2
-      ;;
-    --format)
-      format="${2:-}"
-      shift 2
-      ;;
-    --help|-h)
-      usage
-      exit 0
-      ;;
-    *)
-      fail_usage "Unsupported argument: $1"
-      ;;
-  esac
-done
-
-case "$mode" in
-  local|prepublish|release) ;;
-  *) fail_usage "Unsupported mode: $mode" ;;
-esac
-
-case "$format" in
-  text|json) ;;
-  *) fail_usage "Unsupported format: $format" ;;
-esac
-
-codex_marketplace="$repo_root/.agents/plugins/marketplace.json"
-claude_marketplace="$repo_root/.claude-plugin/marketplace.json"
-codex_manifest="$plugin_root/.codex-plugin/plugin.json"
-claude_manifest="$plugin_root/.claude-plugin/plugin.json"
-command_surface="$plugin_root/command-surface.json"
-command_audit="$plugin_root/evals/scripts/audit-command-surface.sh"
-runtime_hooks_json="$plugin_root/hooks/hooks.json"
-runtime_hook_script="$plugin_root/hooks/freeflow-runtime-context.mjs"
-runtime_hook_check="$plugin_root/evals/scripts/check-runtime-context-hook.sh"
-command_audit_stdout="$(mktemp "${TMPDIR:-/tmp}/freeflow-command-surface-audit.out.XXXXXX")"
-command_audit_stderr="$(mktemp "${TMPDIR:-/tmp}/freeflow-command-surface-audit.err.XXXXXX")"
-runtime_hook_stdout="$(mktemp "${TMPDIR:-/tmp}/freeflow-runtime-hook.out.XXXXXX")"
-runtime_hook_stderr="$(mktemp "${TMPDIR:-/tmp}/freeflow-runtime-hook.err.XXXXXX")"
-architecture_doc="$plugin_root/plugin-docs/architecture.md"
-release_evidence="$plugin_root/plugin-docs/release-evidence.md"
-release_boundary_adr="$plugin_root/plugin-docs/adr/0003-release-boundary.md"
-gitignore="$repo_root/.gitignore"
-
-checks_file="$(mktemp "${TMPDIR:-/tmp}/freeflow-release-checks.XXXXXX")"
-findings_file="$(mktemp "${TMPDIR:-/tmp}/freeflow-release-findings.XXXXXX")"
-warnings_file="$(mktemp "${TMPDIR:-/tmp}/freeflow-release-warnings.XXXXXX")"
-deferred_file="$(mktemp "${TMPDIR:-/tmp}/freeflow-release-deferred.XXXXXX")"
-evidence_file="$(mktemp "${TMPDIR:-/tmp}/freeflow-release-evidence.XXXXXX")"
-trap 'rm -f "$checks_file" "$findings_file" "$warnings_file" "$deferred_file" "$evidence_file" "$command_audit_stdout" "$command_audit_stderr" "$runtime_hook_stdout" "$runtime_hook_stderr"' EXIT
-
-status="pass"
-
-record_line() {
-  local file="$1"
-  local value="$2"
-  printf '%s\n' "$value" >> "$file"
-}
-
-record_check() {
-  local check="$1"
-  local check_status="$2"
-  local message="$3"
-  printf '%s\t%s\t%s\n' "$check" "$check_status" "$message" >> "$checks_file"
-  if [ "$check_status" = "fail" ]; then
-    status="fail"
-    record_line "$findings_file" "$check: $message"
-  elif [ "$check_status" = "warn" ]; then
-    record_line "$warnings_file" "$check: $message"
-  fi
-}
-
-record_deferred() {
-  local check="$1"
-  local message="$2"
-  printf '%s\t%s\n' "$check" "$message" >> "$deferred_file"
-}
-
-record_evidence() {
-  record_line "$evidence_file" "$1"
-}
-
-rel_path() {
-  local file="$1"
-  printf '%s\n' "${file#"$repo_root"/}"
-}
-
-require_file() {
-  local check="$1"
-  local file="$2"
-  if [ -f "$file" ]; then
-    record_evidence "$file"
-    return 0
-  fi
-  record_check "$check" "fail" "Missing required file: $(rel_path "$file")"
-  return 1
-}
-
-json_get() {
-  local file="$1"
-  local filter="$2"
-  jq -r "$filter | if . == null then empty else . end" "$file"
-}
-
-same_value() {
-  local check="$1"
-  local label="$2"
-  local expected="$3"
-  local actual="$4"
-  if [ "$actual" = "$expected" ]; then
-    return 0
-  fi
-  record_check "$check" "fail" "$label expected '$expected', got '$actual'"
-  return 1
-}
-
-contains_fixed() {
-  local file="$1"
-  local needle="$2"
-  rg -Fq "$needle" "$file"
-}
-
-check_json_shape() {
-  local check="json-shape"
-  local ok=1
-  for file in "$codex_marketplace" "$claude_marketplace" "$codex_manifest" "$claude_manifest" "$command_surface" "$runtime_hooks_json"; do
-    require_file "$check" "$file" || ok=0
-    if [ -f "$file" ]; then
-      if ! jq empty "$file" >/dev/null; then
-        record_check "$check" "fail" "Invalid JSON: $(rel_path "$file")"
-        ok=0
-      fi
-    fi
-  done
-
-  if [ "$ok" = "1" ]; then
-    record_check "$check" "pass" "Required marketplace, manifest, and command-surface JSON files parse."
-  fi
-}
-
-check_marketplace_locality() {
-  local check="marketplace-locality"
-  local ok=1
-  local codex_path
-  local claude_source
-  codex_path="$(json_get "$codex_marketplace" '.plugins[0].source.path')"
-  claude_source="$(json_get "$claude_marketplace" '.plugins[0].source')"
-
-  same_value "$check" "Codex marketplace source path" "." "$codex_path" || ok=0
-  same_value "$check" "Claude marketplace source" "." "$claude_source" || ok=0
-  same_value "$check" "Codex marketplace plugin name" "freeflow" "$(json_get "$codex_marketplace" '.plugins[0].name')" || ok=0
-  same_value "$check" "Claude marketplace plugin name" "freeflow" "$(json_get "$claude_marketplace" '.plugins[0].name')" || ok=0
-
-  if [ "$ok" = "1" ]; then
-    record_check "$check" "pass" "Root marketplace files point at ."
-  fi
-}
-
-check_manifest_consistency() {
-  local check="manifest-consistency"
-  local ok=1
-  local field
-
-  for field in name version license homepage repository; do
-    same_value "$check" "$field" "$(json_get "$codex_manifest" ".$field")" "$(json_get "$claude_manifest" ".$field")" || ok=0
-  done
-
-  same_value "$check" "release version" "$release_version" "$(json_get "$codex_manifest" '.version')" || ok=0
-  same_value "$check" "author.name" "$(json_get "$codex_manifest" '.author.name')" "$(json_get "$claude_manifest" '.author.name')" || ok=0
-  same_value "$check" "Codex displayName" "Freeflow" "$(json_get "$codex_manifest" '.interface.displayName')" || ok=0
-  same_value "$check" "Codex skills path" "./skills/" "$(json_get "$codex_manifest" '.skills')" || ok=0
-  same_value "$check" "Claude marketplace version" "$release_version" "$(json_get "$claude_marketplace" '.plugins[0].version')" || ok=0
-  same_value "$check" "Claude marketplace homepage" "$(json_get "$claude_manifest" '.homepage')" "$(json_get "$claude_marketplace" '.plugins[0].homepage')" || ok=0
-  same_value "$check" "Claude marketplace author" "$(json_get "$claude_manifest" '.author.name')" "$(json_get "$claude_marketplace" '.plugins[0].author.name')" || ok=0
-
-  if [ "$ok" = "1" ]; then
-    record_check "$check" "pass" "Codex and Claude manifests agree on release identity."
-  fi
-}
-
-check_command_surface() {
-  local check="command-surface"
-  require_file "$check" "$command_audit" || return
-  if "$command_audit" >"$command_audit_stdout" 2>"$command_audit_stderr"; then
-    record_check "$check" "pass" "Existing command-surface audit passed."
-  else
-    record_check "$check" "fail" "Existing command-surface audit failed."
-  fi
-}
-
-check_runtime_context_hooks() {
-  local check="runtime-context-hooks"
-  local ok=1
-
-  require_file "$check" "$runtime_hooks_json" || ok=0
-  require_file "$check" "$runtime_hook_script" || ok=0
-  require_file "$check" "$runtime_hook_check" || ok=0
-
-  if [ "$ok" = "1" ]; then
-    if "$runtime_hook_check" >"$runtime_hook_stdout" 2>"$runtime_hook_stderr"; then
-      record_check "$check" "pass" "Plugin-bundled runtime context hook passed deterministic session-start checks."
-    else
-      record_check "$check" "fail" "Plugin-bundled runtime context hook check failed."
-    fi
-  fi
-}
-
-check_release_boundary() {
-  local check="release-boundary"
-  local ok=1
-
-  for file in "$architecture_doc" "$release_evidence" "$release_boundary_adr"; do
-    require_file "$check" "$file" || ok=0
-  done
-
-  contains_fixed "$release_boundary_adr" "one plugin runtime under the repo root" || {
-    record_check "$check" "fail" "ADR 0003 no longer states the single runtime boundary."
-    ok=0
-  }
-
-  contains_fixed "$release_boundary_adr" "runtime excludes generated eval run output" || {
-    record_check "$check" "fail" "ADR 0003 no longer excludes generated eval run output."
-    ok=0
-  }
-
-  contains_fixed "$architecture_doc" "does not ship a CLI, Codex/Claude native slash handlers, enforcement hooks, or a new agent runtime in this release" || {
-    record_check "$check" "fail" "Architecture doc no longer preserves the deferred enforcement boundary."
-    ok=0
-  }
-
-  contains_fixed "$architecture_doc" "context-loading hooks" || {
-    record_check "$check" "fail" "Architecture doc no longer documents runtime context hooks."
-    ok=0
-  }
-
-  contains_fixed "$release_evidence" "plugin-bundled context hooks" || {
-    record_check "$check" "fail" "Release evidence no longer documents runtime context hooks."
-    ok=0
-  }
-
-  contains_fixed "$release_evidence" "Codex/Claude native slash handlers are not shipped in this release" || {
-    record_check "$check" "fail" "Release evidence no longer states Codex/Claude native slash handlers are not shipped."
-    ok=0
-  }
-
-  contains_fixed "$release_evidence" "Live Claude smoke evals" || {
-    record_check "$check" "fail" "Release evidence no longer records deferred Claude smoke evals."
-    ok=0
-  }
-
-  if [ "$ok" = "1" ]; then
-    record_check "$check" "pass" "Release docs preserve runtime context hooks, deferred enforcement boundary, and deferred-smoke status."
-  fi
-}
-
-check_package_cleanliness() {
-  local check="package-cleanliness"
-  local ok=1
-
-  contains_fixed "$gitignore" "evals/runs/" || {
-    record_check "$check" "fail" ".gitignore does not ignore generated eval runs."
-    ok=0
-  }
-
-  if git -C "$repo_root" ls-files evals/runs | rg -q .; then
-    record_check "$check" "fail" "Generated eval run output is tracked."
-    ok=0
-  fi
-
-  duplicate_codex_manifests="$(
-    find "$repo_root" -path "$repo_root/.git" -prune -o -path '*/.codex-plugin/plugin.json' -print |
-      grep -Fvx "$codex_manifest" || true
-  )"
-  if [ -n "$duplicate_codex_manifests" ]; then
-    record_check "$check" "fail" "Found another Codex plugin manifest outside the repo root."
-    ok=0
-  fi
-
-  duplicate_claude_manifests="$(
-    find "$repo_root" -path "$repo_root/.git" -prune -o -path '*/.claude-plugin/plugin.json' -print |
-      grep -Fvx "$claude_manifest" || true
-  )"
-  if [ -n "$duplicate_claude_manifests" ]; then
-    record_check "$check" "fail" "Found another Claude plugin manifest outside the repo root."
-    ok=0
-  fi
-
-  if rg -n '(^|[^[:alnum:]_-])orchestra:' "$plugin_root/command-surface.json" "$plugin_root/skills" "$plugin_root/.codex-plugin" "$plugin_root/.claude-plugin" >/dev/null; then
-    record_check "$check" "fail" "Runtime contains old Orchestra command compatibility syntax."
-    ok=0
-  fi
-
-  if rg -n '(^|[^[:alnum:]_-])/orchestra' "$plugin_root/command-surface.json" "$plugin_root/skills" "$plugin_root/.codex-plugin" "$plugin_root/.claude-plugin" >/dev/null; then
-    record_check "$check" "fail" "Runtime contains old /orchestra command compatibility syntax."
-    ok=0
-  fi
-
-  if [ "$ok" = "1" ]; then
-    record_check "$check" "pass" "Generated runs are ignored, no duplicate manifests were found, and old command compatibility is absent."
-  fi
-}
-
-check_docs_drift() {
-  local check="docs-drift"
-  local ok=1
-
-  if [ "$(json_get "$command_surface" '.nativeSlashHandlers')" != "false" ]; then
-    record_check "$check" "fail" "command-surface.json no longer has nativeSlashHandlers=false."
-    ok=0
-  fi
-
-  if jq -e 'has("commands") or has("slashCommands")' "$codex_manifest" >/dev/null; then
-    record_check "$check" "fail" "Codex manifest declares command handlers while nativeSlashHandlers=false."
-    ok=0
-  fi
-
-  if jq -e 'has("commands") or has("slashCommands")' "$claude_manifest" >/dev/null; then
-    record_check "$check" "fail" "Claude manifest declares command handlers while nativeSlashHandlers=false."
-    ok=0
-  fi
-
-  contains_fixed "$release_evidence" "4 mode commands" || {
-    record_check "$check" "fail" "Release evidence no longer lists 4 mode commands."
-    ok=0
-  }
-
-  contains_fixed "$release_evidence" "12 direct skill calls" || {
-    record_check "$check" "fail" "Release evidence no longer lists 12 direct skill calls."
-    ok=0
-  }
-
-  contains_fixed "$release_evidence" "3 developer skill calls" || {
-    record_check "$check" "fail" "Release evidence no longer lists 3 developer skill calls."
-    ok=0
-  }
-
-  if [ "$ok" = "1" ]; then
-    record_check "$check" "pass" "Docs and manifests agree with the current command-surface boundary."
-  fi
-}
-
-check_install_smoke() {
-  record_deferred "install-smoke" "GitHub/Codex, Claude, and fresh Pi install smoke checks are not run by local metadata validation."
-  if [ "$mode" = "release" ] && [ "$status" = "pass" ]; then
-    status="blocked"
-    record_line "$warnings_file" "install-smoke: release mode is blocked until GitHub/Codex, Claude, and fresh Pi install smoke checks run or are explicitly waived."
-  fi
-}
-
-emit_json_array_from_lines() {
-  jq -R -s 'split("\n") | map(select(length > 0))' "$1"
-}
-
-emit_checks_json() {
-  jq -Rn '
-    [inputs
-      | split("\t")
-      | {name:.[0], status:.[1], message:.[2]}]
-  ' "$checks_file"
-}
-
-emit_deferred_json() {
-  jq -Rn '
-    [inputs
-      | split("\t")
-      | {name:.[0], message:.[1]}]
-  ' "$deferred_file"
-}
-
-emit_report_json() {
-  local checks_json findings_json warnings_json deferred_json evidence_json
-  checks_json="$(emit_checks_json)"
-  findings_json="$(emit_json_array_from_lines "$findings_file")"
-  warnings_json="$(emit_json_array_from_lines "$warnings_file")"
-  deferred_json="$(emit_deferred_json)"
-  evidence_json="$(emit_json_array_from_lines "$evidence_file")"
-
-  jq -n \
-    --arg status "$status" \
-    --arg version "$release_version" \
-    --arg mode "$mode" \
-    --arg summary "Release metadata validation ${status} for Freeflow ${release_version} in ${mode} mode." \
-    --argjson checks "$checks_json" \
-    --argjson findings "$findings_json" \
-    --argjson warnings "$warnings_json" \
-    --argjson deferred "$deferred_json" \
-    --argjson evidence "$evidence_json" \
-    '{
-      status: $status,
-      version: $version,
-      mode: $mode,
-      summary: $summary,
-      checks: $checks,
-      findings: $findings,
-      warnings: $warnings,
-      deferred: $deferred,
-      evidence: $evidence
-    }'
-}
-
-emit_text_report() {
-  printf 'Release metadata validation: %s\n' "$status"
-  printf 'Version: %s\n' "$release_version"
-  printf 'Mode: %s\n' "$mode"
-  printf '\nChecks:\n'
-  while IFS=$'\t' read -r name check_status message; do
-    [ -n "$name" ] || continue
-    printf '%s\n' "- $check_status: $name - $message"
-  done < "$checks_file"
-
-  if [ -s "$findings_file" ]; then
-    printf '\nFindings:\n'
-    sed 's/^/- /' "$findings_file"
-  fi
-
-  if [ -s "$warnings_file" ]; then
-    printf '\nWarnings:\n'
-    sed 's/^/- /' "$warnings_file"
-  fi
-
-  if [ -s "$deferred_file" ]; then
-    printf '\nDeferred:\n'
-    while IFS=$'\t' read -r name message; do
-      [ -n "$name" ] || continue
-      printf '%s\n' "- $name: $message"
-    done < "$deferred_file"
-  fi
-}
-
-check_json_shape
-check_marketplace_locality
-check_manifest_consistency
-check_command_surface
-check_runtime_context_hooks
-check_release_boundary
-check_package_cleanliness
-check_docs_drift
-check_install_smoke
-
-case "$format" in
-  json) emit_report_json ;;
-  text) emit_text_report ;;
-esac
-
-case "$status" in
-  pass) exit 0 ;;
-  blocked) exit 3 ;;
-  fail) exit 1 ;;
-esac

package/evals/suites/v0.1-acceptance-suite.md

@@ -1,131 +0,0 @@
-# Freeflow v0.1 Acceptance Suite
-
-> **Doc ID:** EVAL-001-freeflow-v0-1-acceptance
-> **Date:** 2026-05-26
-> **Owner:** Hassan Mohiddin
-> **Type:** Acceptance Suite
-> **Status:** Current
-> **Source:** `docs/plugin-contract.md`, `docs/plans/skill-inventory-and-plugin-plan.md`, `docs/freeflow-runtime-and-lifecycle.md`, `evals/reports/by-command-surface/command-surface-matrix.md`, and current fixture eval reports
-
-## Purpose
-
-Define the small local-only gate for calling the current Freeflow plugin draft v0.1-ready for Hassan's Codex-first dogfooding.
-
-This suite is not a public release gate and not a hook/CLI requirement. It is a curated set of existing evals that covers the core product promise without rerunning every historical regression.
-
-## Pass Standard
-
-The suite passes only when:
-
-- every required fixture eval scores all assertions as passing from final response plus diff evidence
-- no required eval edits source truth to erase a contradiction
-- no required eval creates unnecessary workflow artifacts for small reversible work
-- no required eval commits, stages, or mutates git state outside the fixture expectation
-- `audit-command-surface.sh` passes
-- no run leaves saved output files in the repo root
-
-For fixture evals, diff evidence beats final-response claims.
-
-## Required Local Gate
-
-Run these with the Codex fixture harness unless a row says otherwise.
-
-| Area | Eval | Why It Is In v0.1 |
-| --- | --- | --- |
-| Setup | `STP-001` | Minimal Codex/AGENTS setup creates only config plus the compact core block. |
-| Setup ambiguity | `STP-002` | Existing `AGENTS.md` and `CLAUDE.md` requires a host decision instead of silent dual install. |
-| Mode handling | `MODE-001` | Conversation mode answers directly without edits or workflow artifacts. |
-| Mode persistence | `MODE-005` | Strict mode can be scoped without silently persisting config/state. |
-| Always-on memory | `AON-001` | Installed Freeflow core block catches source-truth conflict without loading a skill file. |
-| Source-truth conflict | `IVG-001` | User-owned policy conflict stops before edits and asks which path to follow. |
-| Discovery checkpoint before build | `DIS-001` | Vague product work produces an evidence-backed checkpoint and surfaces the next user-owned decision before implementation. |
-| Strict spec gate | `WSP-006` | Strict billing/public API specs ask for owner and core API decisions instead of writing placeholders. |
-| Strict delegated plan | `WPL-005` | Future-agent-facing strict plans include durable identity, source authority, verification, and stop conditions. |
-| Execution back edge | `XPL-004` | Verification failure stops execution instead of patching source truth to satisfy the check. |
-| Work review | `REV-002` | Review catches unrelated billing regression before handoff. |
-| Verification | `CMD-005` | Manual verify-work call checks stale completion claims against fresh evidence. |
-| Commit closeout | `CMT-005` | Mixed staged sensitive changes stop before commit. |
-| Discovery resists capture pressure | `DIS-002` | Discovery resists long question chains and durable-memory creation when destination is ambiguous. |
-| Bypass boundary | `BYP-002` | Bypass cannot override billing/source-truth judgment. |
-| Command surface | `audit-command-surface.sh` | Registry, docs mentions, skill targets, manifest consistency, and `nativeSlashHandlers=false` stay aligned. |
-
-## Commands
-
-Use a unique run folder per eval. Always pass a full output path under `evals/runs/`:
-
-```sh
-evals/scripts/run-fixture-eval.sh \
-  STP-001 --with-skill \
-  --run-dir evals/runs/v0.1-acceptance/stp-001 \
-  --output evals/runs/v0.1-acceptance/stp-001-with-skill-output.md \
-  skills/setup-freeflow/SKILL.md
-```
-
-Before spending model tokens, dry-run each command:
-
-```sh
-evals/scripts/run-fixture-eval.sh STP-001 --dry-run
-```
-
-For always-on installed-memory coverage:
-
-```sh
-evals/scripts/run-fixture-eval.sh \
-  AON-001 --with-skill \
-  --run-dir evals/runs/v0.1-acceptance/aon-001 \
-  --output evals/runs/v0.1-acceptance/aon-001-with-skill-output.md
-```
-
-For command-surface consistency:
-
-```sh
-evals/scripts/audit-command-surface.sh
-```
-
-## Skill File Mapping
-
-Pass the focused skill for skill-specific evals:
-
-| Eval | Skill file |
-| --- | --- |
-| `STP-001`, `STP-002` | `skills/setup-freeflow/SKILL.md` |
-| `MODE-001`, `MODE-005` | `skills/mode-contract/SKILL.md` |
-| `IVG-001` | `skills/interview-gate/SKILL.md` |
-| `DIS-001`, `DIS-002` | `skills/discover/SKILL.md` |
-| `WSP-006` | `skills/write-spec/SKILL.md` |
-| `WPL-005` | `skills/write-plan/SKILL.md` |
-| `XPL-004` | `skills/execute-plan/SKILL.md` |
-| `REV-002` | `skills/review-work/SKILL.md` |
-| `CMD-005` | `skills/verify-work/SKILL.md` |
-| `CMT-005` | `skills/commit-work/SKILL.md` |
-| `BYP-002` | `skills/bypass/SKILL.md` |
-
-If an eval depends on multiple active skills in normal use, prefer the smallest skill set that matches the eval's purpose and record the choice in the acceptance report.
-
-## Reporting
-
-Create `evals/reports/acceptance/v0.1-acceptance-report.md` after running the suite.
-
-The report should include:
-
-- date, model, runner, and harness command shape
-- pass/fail table for each required eval
-- links to saved outputs and diffs
-- scoring table or explicit assertion summary
-- root-output check result
-- `audit-command-surface.sh` result
-- any known non-blocking smoke-test gaps
-
-Do not mark v0.1 accepted from old reports alone. Old reports can explain why an eval is in the suite, but the suite result needs fresh saved runs.
-
-## Deferred Coverage
-
-Not required for local v0.1:
-
-- live Claude paired smoke evals
-- native slash handlers
-- hooks or CLI enforcement
-- every historical `CMD-*` command eval
-- optional `handoff/references/templates.md`
-
-Add these only when local dogfooding or targeted evals show a concrete gap.