@hassangameryt/freeflow 0.1.0 → 0.3.0

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

@@ -0,0 +1,486 @@
+#!/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

@@ -0,0 +1,131 @@
+# 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.