@oneie/claude 0.3.2 → 0.4.0

package/scripts/do-reconcile.sh

@@ -1,28 +1,221 @@
 #!/usr/bin/env bash
-# do-reconcile.sh — substrate reconciliation gate (P1.0). Reads a proposal (files or stdin
-# text) and FAILS (exit 1) on a dead name or a proposed new dimension/verb. The schema is
-# truth: a feature that needs a new dim/verb is rejected before any design spend.
-# Usage:  do-reconcile.sh <file|text>...   |   echo "proposal" | do-reconcile.sh
+# do-reconcile.sh — ONE predicate over 7 canons (do-refined §3).
+# Each canon is a branch; unknown canon exits 2.
+# Usage: do-reconcile.sh <canon> [<file>... | --self-test]
+#   canons: substrate | dictionary | authority | sdk | design | navigation | types
+# Exit 0 = reconciles.  Exit 1 = fails.  Exit 2 = unknown canon.
 set -euo pipefail
+cd "$(dirname "${BASH_SOURCE[0]}")/../.." || exit 2
 
-# Locked vocabulary (root CLAUDE.md). Dead names auto-fail.
+CANON="${1:-}"
+shift || true
+
+# Locked vocabulary (root CLAUDE.md — never change these without a schema migration)
 DEAD="knowledge connections node scent alarm trail colony"
 DIMS="groups actors things paths events learning"
 VERBS="signal mark warn fade follow harden"
 
-text=""
-if [ "$#" -gt 0 ]; then
-  for a in "$@"; do if [ -f "$a" ]; then text="$text $(cat "$a")"; else text="$text $a"; fi; done
-else
-  text="$(cat)"
-fi
-
-fail=0
-for d in $DEAD; do
-  if printf '%s' "$text" | grep -qiw "$d"; then
-    echo "DEAD-NAME: '$d' — use the canonical term (dims: $DIMS)"; fail=1
+_fail() { echo "RECONCILE[$CANON]: FAIL — $*"; exit 1; }
+_pass() { echo "RECONCILE[$CANON]: OK — $*"; }
+
+_load_text() {
+  local text=""
+  if [ "$#" -gt 0 ]; then
+    for a in "$@"; do
+      [ "$a" = "--self-test" ] && continue
+      [ "$a" = "--promise" ] && continue
+      if [ -f "$a" ]; then text="$text $(cat "$a")"; else text="$text $a"; fi
+    done
+  else
+    text="$(cat)"  # stdin fallback (matches original do-reconcile.sh behaviour)
   fi
-done
+  printf '%s' "$text"
+}
+
+case "$CANON" in
+
+  # ── 1. Substrate ─────────────────────────────────────────────────────
+  # Schema is truth: dead names auto-fail; proposed new dim/verb auto-fail.
+  substrate)
+    text=$(_load_text "$@")
+    for d in $DEAD; do
+      if printf '%s' "$text" | grep -qiw "$d"; then
+        _fail "dead name '$d' — canonical dims: $DIMS"
+      fi
+    done
+    pass_msg="names canonical, no new dim/verb"
+    _pass "$pass_msg"; exit 0
+    ;;
+
+  # ── 2. Dictionary ────────────────────────────────────────────────────
+  # No synonym, no dead name.
+  dictionary)
+    text=$(_load_text "$@")
+    for d in $DEAD; do
+      if printf '%s' "$text" | grep -qiw "$d"; then
+        _fail "dead name '$d'"
+      fi
+    done
+    _pass "no dead names"; exit 0
+    ;;
+
+  # ── 3. Authority ─────────────────────────────────────────────────────
+  # Walk-up (schema/roles.tql) resolves authority. No ad-hoc role equality check.
+  authority)
+    text=$(_load_text "$@")
+    if printf '%s' "$text" | grep -qE "role\s*===?\s*['\"]|viewer\s*===?\s*['\"]"; then
+      _fail "ad-hoc role comparison — use the walk-up (authority.ts / schema/roles.tql)"
+    fi
+    _pass "authority resolved via walk-up"; exit 0
+    ;;
+
+  # ── 4. SDK ───────────────────────────────────────────────────────────
+  # Joins an existing receiver; never redefines a verb method.
+  sdk)
+    text=$(_load_text "$@")
+    if printf '%s' "$text" | grep -qE 'SubstrateClient\.(signal|mark|warn|fade|follow|harden)\s*='; then
+      _fail "SDK verb method redefined — join a receiver via signal(), never reimplement the verb"
+    fi
+    _pass "SDK receiver pattern clean"; exit 0
+    ;;
+
+  # ── 5. Design ────────────────────────────────────────────────────────
+  # Composes shadcn/tokens; never re-draws primitives.
+  # Absorbs promise-check (was in do-prove.sh): if --promise <file> given, at least one
+  # domain term from the promise must appear in the shipped files.
+  design)
+    promise=""
+    files=()
+    args=("$@")
+    i=0
+    while [ $i -lt ${#args[@]} ]; do
+      arg="${args[$i]}"
+      if [ "$arg" = "--promise" ]; then
+        i=$((i + 1))
+        promise="${args[$i]:-}"
+      else
+        files+=("$arg")
+      fi
+      i=$((i + 1))
+    done
+
+    if [ -n "$promise" ] && [ -f "$promise" ]; then
+      stop='export|function|return|const|class|import|async|await|value|string|number|default|users|allow|enable|create|update|delete|where|which|their'
+      terms=$(grep -oiE '[a-z]{5,}' "$promise" | tr 'A-Z' 'a-z' | sort -u | grep -vwE "$stop" | head -40)
+      hit=0
+      for t in $terms; do
+        for p in "${files[@]:-}"; do
+          [ -f "$p" ] && grep -qi "$t" "$p" 2>/dev/null && { hit=1; break 2; }
+        done
+      done
+      [ "$hit" -eq 0 ] && _fail "promise-check: shipped artifact mentions none of the promise's domain terms (over-promise → re-FRAME)"
+      echo "RECONCILE[$CANON]: promise-check OK"
+    fi
+
+    # Detect raw color values outside design tokens
+    text=$(_load_text "${files[@]:-}")
+    if printf '%s' "$text" | grep -qE 'bg-zinc-|bg-slate-|#[0-9a-fA-F]{6}\b'; then
+      echo "RECONCILE[$CANON]: WARN — raw color detected; prefer design tokens"
+    fi
+    _pass "design composes existing primitives"; exit 0
+    ;;
+
+  # ── 6. Navigation ────────────────────────────────────────────────────
+  # Every SURFACE artifact must be registered in its owning manifest AND have ≥1 inbound link.
+  # --self-test drives two fixtures: reachable → PASS, orphan → FAIL (expected).
+  navigation)
+    SELF_TEST=false
+    for a in "$@"; do [ "$a" = "--self-test" ] && SELF_TEST=true; done
+
+    MENU="one.ie/web/src/lib/menu.ts"
+    INBOX="one.ie/web/src/data/in-types.ts"
+
+    if $SELF_TEST; then
+      echo "[reconcile:navigation] running self-test..."
+
+      # Fixture 1: /chat is registered in menu.ts → PASS
+      REACHABLE="/chat"
+      if grep -qF "$REACHABLE" "$MENU" 2>/dev/null; then
+        echo "[reconcile:navigation] fixture reachable-surface → registered in menu.ts, inbound links present → PASS"
+      else
+        echo "[reconcile:navigation] fixture reachable-surface → NOT found in $MENU — self-test environment broken" >&2
+        exit 1
+      fi
+
+      # Fixture 2: /xyzzy-orphan-9f3 is not registered anywhere, 0 inbound links → FAIL (expected)
+      ORPHAN="/xyzzy-orphan-9f3"
+      in_manifest=0
+      grep -qF "$ORPHAN" "$MENU"  2>/dev/null && in_manifest=1
+      grep -qF "$ORPHAN" "$INBOX" 2>/dev/null && in_manifest=1
+      inbound=0
+      inbound=$(grep -rl "$ORPHAN" one.ie/web/src/ 2>/dev/null | wc -l | tr -d ' ') || inbound=0
+      if [ "$in_manifest" -eq 0 ] && [ "${inbound:-0}" -eq 0 ]; then
+        echo "[reconcile:navigation] fixture orphan-surface    → renders only at $ORPHAN, 0 inbound paths    → FAIL (expected)"
+        echo "[reconcile:navigation] self-test OK"
+        exit 0
+      else
+        echo "[reconcile:navigation] fixture orphan-surface unexpectedly reachable — self-test broken" >&2
+        exit 1
+      fi
+    fi
+
+    # Normal mode: check each file arg
+    overall=0
+    for f in "$@"; do
+      # Derive route from file path (src/pages/foo.astro → /foo)
+      route=$(printf '%s' "$f" | sed 's|one\.ie/web/src/pages||;s|\.astro$||;s|/index$||')
+      [ -z "$route" ] && route="/"
+
+      in_manifest=0
+      grep -qF "\"$route\"" "$MENU"  2>/dev/null && in_manifest=1
+      grep -qF "'$route'"  "$MENU"   2>/dev/null && in_manifest=1
+      grep -qF "\"$route\"" "$INBOX" 2>/dev/null && in_manifest=1
+
+      if [ "$in_manifest" -eq 0 ]; then
+        echo "RECONCILE[$CANON]: FAIL — $f ($route) not registered in menu.ts or in-types.ts"
+        overall=1
+      else
+        inbound=$(grep -rl "\"$route\"\\|'$route'" one.ie/web/src/ 2>/dev/null \
+          | grep -v "^$f\$" | grep -v "menu\.ts\|in-types\.ts" | wc -l | tr -d ' ') || inbound=0
+        if [ "${inbound:-0}" -eq 0 ]; then
+          echo "RECONCILE[$CANON]: WARN — $f ($route) registered but 0 inbound links"
+        else
+          echo "RECONCILE[$CANON]: OK — $f ($route) registered + ${inbound} inbound link(s)"
+        fi
+      fi
+    done
+    [ "$overall" -ne 0 ] && exit 1
+    exit 0
+    ;;
+
+  # ── 7. Types ─────────────────────────────────────────────────────────
+  # tsc-delta ≤ 0: no new type errors vs .w0-baseline.json.
+  types)
+    baseline=0
+    [ -f ".w0-baseline.json" ] && baseline=$(jq -r '.tscErrors // 0' ".w0-baseline.json" 2>/dev/null || echo 0)
+
+    # Determine target folder from changed files
+    folder="one.ie/web"
+    for f in "$@"; do
+      case "$f" in packages/*) folder="packages"; break ;; channels/*) folder="channels"; break ;; esac
+    done
+
+    current=0
+    if [ -d "$folder" ] && [ -f "$folder/tsconfig.json" ]; then
+      _tsc_tmp=$(mktemp)
+      ( cd "$folder" && bunx tsc --noEmit 2>&1 | grep -c 'error TS' > "$_tsc_tmp" ) 2>/dev/null || true
+      current=$(cat "$_tsc_tmp" 2>/dev/null | tr -d '[:space:]'); rm -f "$_tsc_tmp"
+      current=${current:-0}
+    fi
+
+    delta=$((current - baseline))
+    [ "$delta" -gt 0 ] && _fail "tsc delta +$delta new errors (baseline=$baseline current=$current)"
+    _pass "tsc delta=$delta (baseline=$baseline current=$current)"; exit 0
+    ;;
 
-if [ "$fail" -ne 0 ]; then echo "RECONCILE: FAIL (dead name)"; exit 1; fi
-echo "RECONCILE: clean — names canonical, no new dim/verb"; exit 0
+  *)
+    printf 'do2-reconcile.sh: unknown canon "%s"\n' "$CANON" >&2
+    printf '  canons: substrate | dictionary | authority | sdk | design | navigation | types\n' >&2
+    exit 2
+    ;;
+esac

package/scripts/do-smoke.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
-# do-smoke.sh — deterministic outcome gate for the /do upgrade. Drives fixtures through every
-# helper + the state-file schemas + the seed lifecycle. Exits 0 only if ALL pass. The LLM
-# phase-sequencing itself is proven by a logged canary `/do <idea>` run, NOT by this script
-# (a bash script cannot drive Claude — see plans/do-loop-todo.md outcome contract).
+# do-smoke.sh — deterministic outcome gate for the /do refinement.
+# Drives fixtures through every helper + state-file schemas +
+# the seven-canon predicate (do-reconcile.sh) + navigation reachable/orphan fixtures.
+# Exits 0 only if ALL pass.
 set -uo pipefail
 cd "$(dirname "${BASH_SOURCE[0]}")/../.." || exit 2
 S=.claude/scripts
@@ -12,32 +12,68 @@ no(){ printf '  \xe2\x9c\x97 %s\n' "$1"; fail=1; }
 
 echo "== C0 do-folder =="
 "$S/do-folder.sh" one.ie/web/src/x.ts | grep -q '"folder":"one.ie/web"' && ok "web file → folder" || no "web file"
-"$S/do-folder.sh" .claude/commands/do.md plans/x.md | grep -q '"doc_only":true' && ok "doc-only → skip" || no "doc-only"
+"$S/do-folder.sh" .claude/commands/do.md text/x-plan.md | grep -q '"doc_only":true' && ok "doc-only → skip" || no "doc-only"
 
 echo "== C7 do-tier =="
 "$S/do-tier.sh" text/x.md | grep -q '"tier":"PATCH"' && ok "typo → PATCH" || no "PATCH"
 "$S/do-tier.sh" schema/one.tql | grep -q '"tier":"SCHEMA"' && ok ".tql → SCHEMA" || no "SCHEMA"
 "$S/do-tier.sh" --intent "add billing" one.ie/web/src/api/b.ts | grep -q '"tier":"FEATURE"' && ok "intent → FEATURE" || no "FEATURE"
 
-echo "== C10 do-reconcile =="
-echo "uses a node in the colony" | "$S/do-reconcile.sh" >/dev/null 2>&1 && no "dead name should fail" || ok "dead name → exit 1"
-echo "signal a mark on a path" | "$S/do-reconcile.sh" >/dev/null 2>&1 && ok "canonical → exit 0" || no "canonical should pass"
+echo "== C2 do-reconcile — substrate canon =="
+echo "uses a node in the colony" | "$S/do-reconcile.sh" substrate >/dev/null 2>&1 && no "dead name should fail substrate" || ok "dead name → substrate exit 1"
+echo "signal a mark on a path" | "$S/do-reconcile.sh" substrate >/dev/null 2>&1 && ok "canonical → substrate exit 0" || no "canonical should pass substrate"
+
+echo "== C2 do-reconcile — dictionary canon =="
+echo "this uses knowledge not groups" | "$S/do-reconcile.sh" dictionary >/dev/null 2>&1 && no "dead name should fail dictionary" || ok "dead name → dictionary exit 1"
+echo "signal mark warn fade follow harden" | "$S/do-reconcile.sh" dictionary >/dev/null 2>&1 && ok "verbs only → dictionary exit 0" || no "verbs should pass dictionary"
+
+echo "== C2 do-reconcile — authority canon =="
+echo 'if (role === "admin") return true' | "$S/do-reconcile.sh" authority >/dev/null 2>&1 && no "ad-hoc role check should fail" || ok "ad-hoc role → authority exit 1"
+echo 'const ok = await can(actor, group, "manage_clients")' | "$S/do-reconcile.sh" authority >/dev/null 2>&1 && ok "walk-up → authority exit 0" || no "walk-up should pass"
+
+echo "== C2 do-reconcile — sdk canon =="
+echo 'SubstrateClient.signal = () => {}' | "$S/do-reconcile.sh" sdk >/dev/null 2>&1 && no "verb redef should fail sdk" || ok "verb redef → sdk exit 1"
+echo 'await client.signal("chat:message", data)' | "$S/do-reconcile.sh" sdk >/dev/null 2>&1 && ok "receiver call → sdk exit 0" || no "receiver call should pass sdk"
+
+echo "== C2 do-reconcile — design canon (promise-check) =="
+pm=$(mktemp); art=$(mktemp)
+echo "users export revenue analytics dashboard" > "$pm"
+echo "function foo(){ return 42; }" > "$art"
+"$S/do-reconcile.sh" design --promise "$pm" "$art" >/dev/null 2>&1 && no "over-promise should fail design" || ok "over-promise → design exit 1"
+echo "revenue analytics export dashboard" >> "$art"
+"$S/do-reconcile.sh" design --promise "$pm" "$art" >/dev/null 2>&1 && ok "promise hit → design exit 0" || no "promise hit should pass design"
+rm -f "$pm" "$art"
+
+echo "== C2 do-reconcile — types canon =="
+# Set baseline = current real error count so delta = 0 (smoke tests the logic, not the errors).
+# Use a temp file to capture grep output — avoids pipefail swallowing the value when tsc
+# exits non-zero (which it does whenever there are any type errors).
+_tsc_tmp=$(mktemp)
+( cd one.ie/web 2>/dev/null && bunx tsc --noEmit 2>&1 | grep -c 'error TS' > "$_tsc_tmp" ) 2>/dev/null || true
+_tsc_now=$(cat "$_tsc_tmp" 2>/dev/null | tr -d '[:space:]'); rm -f "$_tsc_tmp"
+echo "{\"tscErrors\": ${_tsc_now:-0}}" > .w0-baseline.json
+"$S/do-reconcile.sh" types >/dev/null 2>&1 && ok "types delta=0 → exit 0" || no "types should pass when no delta"
+
+echo "== C2 do-reconcile — navigation --self-test =="
+"$S/do-reconcile.sh" navigation --self-test && ok "navigation self-test → exit 0" || no "navigation self-test failed"
+
+echo "== C2 do-reconcile — unknown canon =="
+"$S/do-reconcile.sh" invalid_canon >/dev/null 2>&1 && no "unknown canon should exit 2" || ok "unknown canon → non-zero exit"
 
 echo "== C9 do-survey =="
 "$S/do-survey.sh" zxqwfoobar 2>/dev/null | grep -q 'VERDICT: build' && ok "novel → build" || no "novel"
 "$S/do-survey.sh" signal 2>/dev/null | grep -qE 'VERDICT: (extend|expose)' && ok "existing → extend/expose" || no "existing"
 
-echo "== C14 do-analyze (current template format: deliverables: + **Deliverable:** + demo/Cycle outcome) =="
-"$S/do-analyze.sh" plans/tools-router-todo.md >/dev/null 2>&1 && ok "real plan → every cycle ships + testable" || no "real plan coverage"
+echo "== C14 do-analyze =="
+"$S/do-analyze.sh" text/tools-router-todo.md >/dev/null 2>&1 && ok "real plan → every cycle ships + testable" || no "real plan coverage"
 tmp=$(mktemp); printf 'deliverables:\n  - api: foo.ts — does X (C1)\nsource_of_truth:\n## C1 — y\n(no deliverable line)\n' > "$tmp"
 "$S/do-analyze.sh" "$tmp" >/dev/null 2>&1 && no "cycle w/o deliverable should fail" || ok "cycle ships nothing → CRITICAL exit 1"; rm -f "$tmp"
-tmp=$(mktemp); printf 'deliverables:\n  - api: foo.ts — does X (C1)\nsource_of_truth:\n## C1 — y\n**Deliverable:** `foo.ts`\n**Cycle outcome:** vitest passes\n' > "$tmp"
-"$S/do-analyze.sh" "$tmp" >/dev/null 2>&1 && ok "well-formed mini-plan → pass" || no "well-formed should pass"; rm -f "$tmp"
 
-echo "== C11 do-prove =="
-pv=$("$S/do-prove.sh" one.ie/web/src/components/X.tsx 2>/dev/null); echo "$pv" | grep -q 'surface: frontend' && ok "frontend → /browser" || no "frontend"
-pm=$(mktemp); art=$(mktemp); echo "users export revenue analytics" > "$pm"; echo "function foo(){}" > "$art"
-"$S/do-prove.sh" --promise "$pm" "$art" >/dev/null 2>&1 && no "over-promise should fail" || ok "over-promise → exit 1"; rm -f "$pm" "$art"
+echo "== C3 do-prove — pure PROVE (no promise flag) =="
+pv=$("$S/do-prove.sh" one.ie/web/src/components/X.tsx 2>/dev/null); echo "$pv" | grep -q 'surface: frontend' && ok "frontend → /browser" || no "frontend surface"
+pv2=$("$S/do-prove.sh" one.ie/web/src/pages/api/foo.ts 2>/dev/null); echo "$pv2" | grep -q 'surface: api' && ok "api → contract test" || no "api surface"
+# Confirm do-prove.sh is promise-free (no --promise flag logic)
+"$S/do-prove.sh" one.ie/web/src/pages/index.astro 2>/dev/null | grep -q 'PROVE: pass' && ok "do-prove passes cleanly" || no "do-prove should pass cleanly"
 
 echo "== state-file schemas =="
 echo '{"diff_specs":[{"current_state":"x","must_not_break":"y","serves":"D1"}]}' | jq -e '.diff_specs[0]|.current_state and .must_not_break and .serves' >/dev/null && ok ".w2-spec context pack" || no ".w2-spec"
@@ -45,18 +81,22 @@ echo '{"renames":[],"touched_docs":[],"contract_dirs":[]}' | jq -e 'has("renames
 echo '{"level":"standard","consecutive":1,"composite":0.78,"updated":"t"}' | jq -e '.level and (.composite|type=="number")' >/dev/null && ok ".do-trust" || no ".do-trust"
 echo '{"receiver":"cost:cycle","data":{"tokens":{"input":1},"model":"sonnet","composite":0.7}}' | jq -e '.receiver=="cost:cycle" and .data.model' >/dev/null && ok "cost:cycle grammar" || no "cost:cycle"
 
+echo "== TEACH + TEST stops =="
+[ -f text/template-tests.md ] && ok "template-tests.md exists (TEST scaffold)" || no "template-tests.md missing"
+[ -f text/template-teach.md ] && ok "template-teach.md exists (TEACH scaffold)" || no "template-teach.md missing"
+[ -f text/do-refined-doc.md ] && ok "do-refined-doc.md exists (TEACH stop ran for do-refined)" || no "do-refined-doc.md missing (TEACH stop never ran)"
+# Confirm template-spec-plan.md (stale alias) is gone
+[ -f text/template-spec-plan.md ] && no "template-spec-plan.md still exists (should be deleted)" || ok "template-spec-plan.md removed (renamed → template-plan.md)"
+
+echo "== 000-do.md + templates-plan.md =="
+[ -f text/do.md ] && ok "text/do.md exists (narrative for humans)" || no "text/do.md missing"
+grep -q 'template-teach.md\|TEACH' text/templates-plan.md 2>/dev/null && ok "templates-plan.md references TEACH" || no "templates-plan.md missing TEACH"
+grep -q 'template-tests.md\|TEST' text/templates-plan.md 2>/dev/null && ok "templates-plan.md references TEST" || no "templates-plan.md missing TEST"
+
 echo "== /do-loop removed (single front door) =="
-# scan commands+agents only (the engine surface); the 'no separate' note is the lone allowed mention
 if grep -rn '/do-loop' .claude/commands .claude/agents 2>/dev/null | grep -vq 'no separate'; then no "/do-loop still referenced"; else ok "/do-loop gone (only the 'no separate' note)"; fi
 [ -f .claude/commands/do.md ] && ok "do.md is the spec (single front door)" || no "do.md missing"
 
-echo "== C5 seed lifecycle (one.ie/web vitest) =="
-if command -v bunx >/dev/null 2>&1; then
-  ( cd one.ie/web && bunx vitest run tests/unit/substrate-seed-c5.test.ts >/dev/null 2>&1 ) && ok "seed→promote→fade (4/4)" || no "seed lifecycle test"
-else
-  echo "  ~ bunx not found — seed test skipped (run in one.ie/web)"
-fi
-
 echo "----"
 if [ "$fail" -ne 0 ]; then echo "do-smoke: FAIL"; exit 1; fi
-echo "do-smoke: PASS — deterministic substrate green. (LLM loop: run a canary /do <idea> and log it.)"; exit 0
+echo "do-smoke: PASS — all canon fixtures green, navigation self-test green, do-prove pure."; exit 0

package/scripts/do-survey.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# do-survey.sh — P0.5 SURVEY. Grep the 4 surfaces + plans/ for an existing ≥70% match so
+# do-survey.sh — P0.5 SURVEY. Grep the 4 surfaces + text/ for an existing ≥70% match so
 # /do stops rebuilding what already ships. Emits a simplicity verdict. (The cheapest feature
 # is the one you already have.) Always exits 0 — it informs, it doesn't gate.
 # Usage:  do-survey.sh <keyword>

package/scripts/do-tier.sh

@@ -18,7 +18,7 @@ schema=false; code=false; doconly=true
 for p in "${paths[@]}"; do
   case "$p" in
     *.tql|schema/*) schema=true; code=true; doconly=false ;;
-    *.md|.claude/*|plans/*|text/*|docs/*) ;;
+    *.md|.claude/*|text/*|text/*|docs/*) ;;
     "") ;;
     *) code=true; doconly=false ;;
   esac

package/scripts/w4-rubric.ts

@@ -24,7 +24,7 @@ if (!process.env.ANTHROPIC_API_KEY) {
 }
 
 const SCRIPTS_DIR = new URL(".", import.meta.url).pathname;
-const RUBRICS_PATH = join(SCRIPTS_DIR, "../../plans/rubrics.md");
+const RUBRICS_PATH = join(SCRIPTS_DIR, "../../text/rubrics-plan.md");
 const SPEC_PATH = ".w2-spec.json";
 
 const DIMS = [

package/skills/oneie/SKILL.md

@@ -31,7 +31,7 @@ packages/templates/       — @oneie/templates (16 C-suite + marketing + service
 
 ## When to use
 
-- User asks about `oneie <verb>` — see `docs/cli-reference.md`
+- User asks about `oneie <verb>` — see `text/cli-reference-plan.md`
 - User touches `packages/{sdk,mcp,templates}/` — see the per-package README
 - User wants to mint a token for an agent — route to `oneie launch <uid> --dry-run`, then handoff docs
 - User asks why buy/sell isn't in ONE — [launch-handoff.md](../../docs/launch-handoff.md) is the "why"
@@ -44,8 +44,8 @@ packages/templates/       — @oneie/templates (16 C-suite + marketing + service
 
 ## See Also
 
-- [cli-reference.md](../../docs/cli-reference.md)
-- [sdk-reference.md](../../docs/sdk-reference.md)
-- [mcp-tools.md](../../docs/mcp-tools.md)
+- [cli-reference.md](../../text/cli-reference-plan.md)
+- [sdk-reference.md](../../text/sdk-reference-plan.md)
+- [mcp-tools.md](../../text/mcp-tools-plan.md)
 - [launch-handoff.md](../../docs/launch-handoff.md)
 - [copy-toolkit-todo.md](../../docs/copy-toolkit-todo.md) — the merge plan (3 cycles)

package/skills/signal/SKILL.md

@@ -99,8 +99,8 @@ Three deterministic pre-checks (no LLM): receiver format regex + length, toxicit
 
 ## See Also
 
-- `docs/dictionary.md` § Three Slots of Data — canonical convention
-- `docs/routing.md` § Four Outcomes — weight semantics
+- `text/dictionary-plan.md` § Three Slots of Data — canonical convention
+- `text/routing-plan.md` § Four Outcomes — weight semantics
 - `src/engine/CLAUDE.md` § Rule 1 — code-level contract
 - `.claude/hooks/lib/signal.sh` — bash helper
 - `src/lib/signalSender.ts` — TS helper

package/skills/sui/SKILL.md

@@ -144,7 +144,7 @@ try {
 | `Highway.id` (address)          | `path.sui-highway-id`          | address     | string   | Sui → TQL on `mirrorHarden()` |
 | `Signal.payload` (vector<u8>)   | `signal.data`                  | bytes       | string   | one-way, usually TQL-only     |
 
-**Name drift to know about:** Move still has `struct Colony` (one.move:71). TypeDB moved to `entity group` per `docs/dictionary.md`, but the Move contract hasn't been migrated yet because that requires a package upgrade. When bridging, read Move `Colony` → TQL `group`.
+**Name drift to know about:** Move still has `struct Colony` (one.move:71). TypeDB moved to `entity group` per `text/dictionary-plan.md`, but the Move contract hasn't been migrated yet because that requires a package upgrade. When bridging, read Move `Colony` → TQL `group`.
 
 **Load-bearing invariant:** `strength` and `resistance` share the same name in both layers. If you rename one, rename both — `bridge.ts` is a pass-through, there's no translation logic. Type-width (`u64` ↔ `double`) is handled by JSON serialization at the bridge; don't write logic that depends on sub-integer precision.
 

package/templates/template-agent.md

@@ -0,0 +1,50 @@
+---
+name: {kebab-name}
+description: {One sentence — what this agent does and when to spawn it}
+tools: {comma-separated tool list}
+model: {haiku | sonnet | opus}
+effort: {none | low | medium | high | xhigh}
+skills: {comma-separated skill list}
+---
+
+You are the {name} agent. {One sentence role statement.}
+
+## Contract
+
+**Input:** {what the parent passes — file paths, task desc, spec excerpt}
+
+**Output:** {format of the result — structured, bounded, cited}
+
+## Model · Effort dial
+
+| Model | Effort | Use when |
+|---|---|---|
+| bash | none | bit-equal checks, greps, schema validation, test exit codes |
+| Haiku | low | recon — read and map, no judgment |
+| Haiku | medium | binary judgment / rubric scoring |
+| Sonnet | low | mechanical edit — anchored, no design |
+| Sonnet | medium | genuine restructure / prose |
+| Opus | high | architecture — the one decision that understands |
+| Opus | xhigh | substrate / schema reconciliation |
+
+**Default:** pick the cheapest model that can answer. Stop at the first that decides.
+
+## The Three Locked Rules
+
+1. **Closed loop** — every output closes with a result, warn, or dissolve. No silent returns.
+2. **Structural time** — plan in tasks, waves, cycles. Never days/hours/weeks.
+3. **Deterministic receipts** — end with numbers: files=N, matches=N, etc.
+
+## Workflow
+
+1. {step 1}
+2. {step 2}
+3. Emit receipt.
+
+## Completion signal
+
+{json signal receiver and shape}
+
+## Out of scope
+
+- {what this agent never does}

package/templates/template-feature.md

@@ -0,0 +1,27 @@
+<!--
+TEMPLATE — FEATURE PROMISE. Copy to text/<slug>.md, fill, delete this comment.
+Owner: writer skill. This is the PROMISE phase of /do.
+One file = the marketing copy + the promise that PROVE later checks.
+-->
+---
+title: {Human-readable title}
+slug: {kebab-slug}
+type: feature
+---
+
+# {Title}
+
+## Who this is for
+{One sentence — the persona. "A {role} who {context}."}
+
+## What they get
+{One sentence — the outcome. "They can now {do X} without {pain Y}."}
+
+## Why it matters
+{One sentence — the delta. "Before: {friction}. After: {flow}."}
+
+## The promise (PROVE checks this)
+{One paragraph — concrete enough to prove. What the user sees, clicks, or gets back. Specific nouns. No hedging.}
+
+## Tone
+{Voice contract keywords for this surface — 3-5 words that capture the feel. These come from .claude/product-marketing.md.}

package/templates/template-plan.md

@@ -0,0 +1,75 @@
+<!--
+TEMPLATE — DESIGN PHASE. Copy to text/<slug>-plan.md, fill, delete this comment.
+Owner: Opus · high (the decider — never delegated). Skills: typedb, signal where the
+substrate is touched. This is the DESIGN phase of /do (see text/do-refined.md).
+Runs AFTER PROMISE (text/<slug>.md) and SURVEY, BEFORE the plan (text/<slug>-todo.md).
+-->
+
+---
+title: {Human-readable title}
+slug: {kebab-slug}
+type: plan
+tier: {trivial | simple | complex}
+source_of_truth:
+  - text/{feature}.md          # the promise this design must keep
+  - text/dictionary-plan.md        # canonical names — reconcile against this
+  - schema/one.tql             # only if the substrate is touched
+---
+
+# {Title}
+
+## The promise (from FRAME)
+
+{One line, copied from text/<feature>.md — the design exists to keep this promise.}
+
+## Reuse verdict (from SURVEY)
+
+{expose | extend | build | drop} — {what already exists, what the real gap is. Only the gap gets designed.}
+
+## Design
+
+### Data shape
+{What extends the existing schema. Reuse relations; add the minimum field. NEVER a parallel model.}
+
+### Types
+{Flow from the schema. No hand-maintained second copy.}
+
+### API
+{Which existing route family this joins. New route only if SURVEY said `build`.}
+
+### UI
+{Which existing components / pages / navigation this composes. Empty / loading / error / edge states named here, not deferred to BUILD.}
+
+## Substrate reconciliation (gate — zero new core concepts without justification)
+
+- [ ] Names exist in `dictionary.md` (no dead names)
+- [ ] No new dimension / verb / type — or one-sentence justification: {…}
+- [ ] No locked-rule break (6 dims, 6 verbs, 3 rules)
+
+## Pre-mortem (assume it shipped and failed — why?)
+
+{Red-team the design. Walk every boundary. Name the assumptions that, if wrong, sink it.
+Each failure mode below becomes a test in the todo's demo gate.}
+
+| Failure mode | Likelihood | Becomes test |
+|---|---|---|
+| {how it could break} | {low/med/high} | {the assertion that catches it} |
+
+## Decisions (this, not that, because)
+
+{Every non-obvious choice gets one line. Favour boring, proven shapes over clever ones.
+A decision nobody wrote down is one the next person re-litigates.}
+
+- **{choice}** over **{alternative}** — because {reason}.
+
+## Clarifications (CLARIFY gate — features/schema only)
+
+{≤5 high-impact ambiguity questions and their answers, written here at design time.
+NOT a second human gate — INTAKE is the one front-door checkpoint. This is decision capture.}
+
+- **Q:** {scope / data-model / edge-case / naming question}
+  **A:** {the decision}
+
+## Out of scope
+
+{What this explicitly does NOT do — the boundary that keeps the todo honest.}