bigpowers 2.65.1 → 2.67.0

package/skills/release-branch/SKILL.md

@@ -13,7 +13,6 @@ description: Make the merge/PR/keep/discard decision for a feature branch, verif
 Finalize a completed feature branch: verify coverage gates, integrate onto `main`, and clean up the worktree.
 
 ## Additional modes
-
 - `--hotfix`: Cherry-pick to main + tag. Skip PR in solo.
 - `--squash-state`: Squash `chore(state):` commits before merge.
 
@@ -76,9 +75,7 @@ bash scripts/land-branch.sh <task-slug> "feat(scope): description"
 
 ### 6. Create PR (team-pr only)
 
-See [REFERENCE.md](REFERENCE.md) for the full PR body template and gh commands.
-
-### 7. Merge (team-pr only)
+Create the pull request, then merge via `gh`:
 
 ```bash
 gh pr merge --squash --delete-branch
@@ -94,22 +91,32 @@ gh pr merge --squash --delete-branch
 mv specs/epics/eNN-slug specs/epics/archive/
 ```
 
-### 7b. CI verification (solo-local and team-pr)
+### 7b. CI verification & agent lock release (e39s02)
 
 > **HARD GATE** — Do NOT declare success until CI completes. A push that fails CI is a regression, not a release.
 
-After push (solo-local step 5 or team-pr step 7), run the CI polling script:
+After push, run CI polling:
 
 ```bash
 bash scripts/wait-for-ci.sh --timeout 600 --interval 30
 ```
 
-The script auto-discovers workflow runs for the pushed commit and polls until completion.
-See [REFERENCE.md](REFERENCE.md) for exit code semantics and git-only fallback.
+Then release the story lock:
+
+```bash
+LOCK="specs/agent-locks.yaml"; STORY="<story-id>"
+[ -f "$LOCK" ] && python3 -c "
+import yaml
+d=yaml.safe_load(open('$LOCK'))
+if d:d['locks']=[l for l in d['locks'] if l.get('story_id')!='$STORY']
+yaml.dump(d,open('$LOCK','w'),default_flow_style=False)
+print(f'LOCK RELEASED: $STORY')
+"||echo "No lock for $STORY — idempotent"
+```
 
 - [ ] CI workflow passes after push (wait-for-ci.sh exit 0)
 - [ ] `release.ci_verified: true` documented in state.yaml
-- On failure: `handoff.next_skill = fix-bug` with the CI failure URL
+- On failure: `handoff.next_skill = fix-bug` with CI failure URL
 
 ### 8. Clean up worktree
 
@@ -130,16 +137,13 @@ bash scripts/record-cycle-time.sh append \
   --file specs/metrics/cycle-times.yaml
 ```
 
-This replaces the previous hand-arithmetic approach (story_end minus story_start).
-See [REFERENCE.md](REFERENCE.md) for the git-hours model and field definitions.
-
 ### 9. Return to main
 
 ```bash
 git checkout main && git status && pwd
 ```
 
-Report: "Branch released. Integrate mode: <solo-local|team-pr>. cwd: $(pwd) on $(git branch --show-current)."
+Report: "Branch released."
 
 ## Verify
 

package/skills/verify-work/SKILL.md

@@ -109,6 +109,13 @@ phases:
     closed: true
 ```
 
+### 5b. OKF wiki LINT (e39s08)
+
+```bash
+for p in specs/skills-wiki/skills/*.md; do s="skills/$(basename "$p" .md)/SKILL.md"; [ -f "$s" ]&&[ "$p" -ot "$s" ]&&echo "STALE: $p"; done
+for p in specs/conventions-wiki/*.md; do [ "$(basename "$p")" = "index.md" ]&&continue; grep -q "$(basename "$p" .md)" CONVENTIONS.md||echo "ORPHAN: $p"; done
+```
+
 > **HARD GATE** — Verification evidence MUST be persisted before marking the story done. No evidence = not verified.
 
 ## --cli mode
@@ -132,15 +139,12 @@ BINARY=$(grep '^BIN\s*=' Makefile 2>/dev/null | awk '{print $3}')
 3. Happy-path: run documented example command from README.md → assert non-empty output
 4. Edge case: `$BINARY --invalid-flag` → assert exit code ≠ 0 and error message printed
 
-No "stop server" or "clear caches" steps are executed in `--cli` mode. Steps 3–6 of the default process (mechanical gates, UAT, gaps loop) still run unchanged.
+No "stop server" / "clear caches" in `--cli` mode. Steps 3–6 still run unchanged.
 
 ## Verify
 
 → verify: `find specs/verifications -maxdepth 1 -name '*-verify.yaml' 2>/dev/null | head -1 | grep -q . && echo "Evidence persisted" || echo "No evidence yet"`
 
-See [REFERENCE.md](REFERENCE.md) for cold-start and gaps template.
-
 ## Handoff
-
-Gate: READY -> next: audit-code
+READY -> next: audit-code
 Writes: state.yaml handoff.next_skill = audit-code

package/skills-lock.json

@@ -23,7 +23,7 @@
     },
     "build-epic": {
       "description": "Eight-step epic build cycle — reads state.yaml, execution-status.yaml, and one epic capsule; updates status via bp-yaml-set or direct edit. Resume mode runs one step per invocation. Use instead of ad-hoc execute-plan for release work.",
-      "sha256": "96fd5e0cc63a9962",
+      "sha256": "230ac9d30cae1a63",
       "path": "skills/build-epicSKILL.md"
     },
     "change-request": {
@@ -128,7 +128,7 @@
     },
     "gate-trace": {
       "description": "\"Deterministic traceability quality gate — reads coverage matrix + blind-spot data, applies decision rules with oracle confidence downgrade, emits PASS/CONCERNS/FAIL/WAIVED verdict. Use before release-branch to gate merges on traceability.\"# story: e38s06",
-      "sha256": "7326525dc3d5d51f",
+      "sha256": "81deb2549867386b",
       "path": "skills/gate-traceSKILL.md"
     },
     "grill-me": {
@@ -163,9 +163,14 @@
     },
     "kickoff-branch": {
       "description": "Create a git worktree and feature branch, then verify a clean test baseline before any code is written. Use when starting a new feature or task, when user wants to work in isolation from main, or mentions \"start a branch\" or \"new worktree\".",
-      "sha256": "2857dac9f23bd7be",
+      "sha256": "928d87bae8cc4ddf",
       "path": "skills/kickoff-branchSKILL.md"
     },
+    "maintain-wiki": {
+      "description": "\"Agent-maintained OKF wiki — INGEST source docs, LINT for issues, QUERY across concept pages. Run as part of build-epic Step 8 and verify-work Phase 3.\"# story: e39s07",
+      "sha256": "c54c6170db6fe3f9",
+      "path": "skills/maintain-wikiSKILL.md"
+    },
     "map-codebase": {
       "description": "\"Derives the tech-stack doc from scratch by scanning the codebase — analyzes stack, architecture, and gray areas (error handling, API shapes) and persists findings into specs/tech-architecture/tech-stack.md. Run when the tech doc doesn't exist yet; use survey-context to consume it once it does.\"",
       "sha256": "cfd8a71a3cdb63af",
@@ -203,7 +208,7 @@
     },
     "plan-tests": {
       "description": "\"Design a risk-scaled test architecture for an epic before implementation begins. Produces prioritized scenarios, test level distribution, and fixture plans based on TEA and bigpowers principles.\"",
-      "sha256": "3f43a105b860105a",
+      "sha256": "ed22b3feb985eabb",
       "path": "skills/plan-testsSKILL.md"
     },
     "plan-work": {
@@ -223,7 +228,7 @@
     },
     "release-branch": {
       "description": "Make the merge/PR/keep/discard decision for a feature branch, verify coverage gates, create the PR with gh, and clean up the worktree. Use when a feature is done and ready to ship, or when user says \"release\", \"merge\", or \"open a PR\".",
-      "sha256": "354267f0f4b593b5",
+      "sha256": "73a9aebff3fb4dc0",
       "path": "skills/release-branchSKILL.md"
     },
     "request-review": {
@@ -348,7 +353,7 @@
     },
     "verify-work": {
       "description": "Multi-phase UAT gate — cold-start smoke, build, typecheck, lint, tests, step-by-step manual verification, gaps-closure loop. Use after execute-plan or develop-tdd, before audit-code.",
-      "sha256": "030622528b2bf5ed",
+      "sha256": "300e5a7c7695e33f",
       "path": "skills/verify-workSKILL.md"
     },
     "visual-dashboard": {

package/tests/fixtures/v1.x-project/CLAUDE.md

@@ -0,0 +1,4 @@
+# CLAUDE.md — v1.x Project
+## Commands
+- npm test
+- npm start

package/tests/fixtures/v1.x-project/CONVENTIONS.md

@@ -0,0 +1,4 @@
+# CONVENTIONS.md — v1.x
+## Naming
+- kebab-case for files
+- camelCase for functions

package/tests/fixtures/v2.0.0-project/CLAUDE.md

@@ -0,0 +1,4 @@
+# CLAUDE.md — v2.0.0
+## Commands
+- npm test
+- npm start

package/tests/fixtures/v2.0.0-project/CONVENTIONS.md

@@ -0,0 +1,3 @@
+# CONVENTIONS.md — v2.0.0
+## Naming
+- kebab-case

package/tests/fixtures/v2.20-project/CLAUDE.md

@@ -0,0 +1,4 @@
+# CLAUDE.md — v2.20
+## Commands
+- npm test
+- npm run lint

package/tests/fixtures/v2.20-project/CONVENTIONS.md

@@ -0,0 +1,4 @@
+# CONVENTIONS.md — v2.20
+## Naming
+- kebab-case
+- YAML cockpit

package/tests/run-golden-migrate-version.sh

@@ -0,0 +1,155 @@
+#!/usr/bin/env bash
+# story: e44s06
+# G-06: migrate-version golden tests — detection + stamp + YAML validity
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+FIXTURES="$SCRIPT_DIR/fixtures"
+CHECK_GAP="$REPO_ROOT/scripts/check-spec-version-gap.sh"
+VALIDATE_YAML="$REPO_ROOT/scripts/validate-specs-yaml.sh"
+
+GREEN='\033[0;32m'; RED='\033[0;31m'; CYAN='\033[0;36m'; NC='\033[0m'
+PASS=0; FAIL=0
+
+pass() { echo -e "  ${GREEN}PASS${NC} $1"; PASS=$((PASS+1)); }
+fail() { echo -e "  ${RED}FAIL${NC} $1"; FAIL=$((FAIL+1)); }
+
+echo -e "${CYAN}═══ G-06: migrate-version Golden Tests ═══${NC}"
+
+# ── Test 1: v1.x detection ──────────────────────────────────────────────
+echo ""
+echo -e "${CYAN}── G-06: v1.x detection ──${NC}"
+tmp1="$(mktemp -d)"
+cp -r "$FIXTURES/v1.x-project/"* "$tmp1/"
+cd "$tmp1"
+git init --quiet && git config user.email "test@b.dev" && git config user.name "T" && git add -A && git commit -m "i" --quiet
+
+bash "$CHECK_GAP" --skip-block --json 2>&1 || true
+echo ""
+
+# Verify STATE.md exists, state.yaml does not
+if [ -f "$tmp1/specs/STATE.md" ] && [ ! -f "$tmp1/specs/state.yaml" ]; then
+  pass "v1.x: Markdown-era detected (STATE.md present, state.yaml absent)"
+else
+  fail "v1.x: expected Markdown-era signal"
+fi
+rm -rf "$tmp1"
+
+# ── Test 2: v2.0.0 detection ────────────────────────────────────────────
+echo ""
+echo -e "${CYAN}── G-06: v2.0.0 detection ──${NC}"
+tmp2="$(mktemp -d)"
+cp -r "$FIXTURES/v2.0.0-project/"* "$tmp2/"
+cd "$tmp2"
+git init --quiet && git config user.email "test@b.dev" && git config user.name "T" && git add -A && git commit -m "i" --quiet
+
+bash "$CHECK_GAP" --skip-block --json 2>&1 || true
+echo ""
+
+# Verify state.yaml exists but no bigpowers_version stamp
+if [ -f "$tmp2/specs/state.yaml" ]; then
+  stamped="$(python3 -c "import yaml; d=yaml.safe_load(open('$tmp2/specs/state.yaml')); print(d.get('bigpowers_version','MISSING'))" 2>/dev/null)" || stamped="ERR"
+  if [ "$stamped" = "MISSING" ]; then
+    pass "v2.0.0: YAML cockpit without bigpowers_version stamp"
+  else
+    fail "v2.0.0: expected no stamp, got '$stamped'"
+  fi
+else
+  fail "v2.0.0: state.yaml missing"
+fi
+rm -rf "$tmp2"
+
+# ── Test 3: v2.20 detection ─────────────────────────────────────────────
+echo ""
+echo -e "${CYAN}── G-06: v2.20 detection ──${NC}"
+tmp3="$(mktemp -d)"
+cp -r "$FIXTURES/v2.20-project/"* "$tmp3/"
+cd "$tmp3"
+git init --quiet && git config user.email "test@b.dev" && git config user.name "T" && git add -A && git commit -m "i" --quiet
+
+bash "$CHECK_GAP" --skip-block --json 2>&1 || true
+echo ""
+
+if [ -f "$tmp3/specs/state.yaml" ]; then
+  has_capsule="$(python3 -c "import yaml; d=yaml.safe_load(open('$tmp3/specs/state.yaml')); print('yes' if d.get('epic_cycle') else 'no')" 2>/dev/null)" || has_capsule="ERR"
+  stamped="$(python3 -c "import yaml; d=yaml.safe_load(open('$tmp3/specs/state.yaml')); print(d.get('bigpowers_version','MISSING'))" 2>/dev/null)" || stamped="ERR"
+  if [ "$has_capsule" = "yes" ] && [ "$stamped" = "MISSING" ]; then
+    pass "v2.20: capsule era with epic_cycle, no stamp"
+  elif [ "$has_capsule" != "yes" ]; then
+    fail "v2.20: expected epic_cycle, got '$has_capsule'"
+  else
+    fail "v2.20: expected no stamp, got '$stamped'"
+  fi
+else
+  fail "v2.20: state.yaml missing"
+fi
+rm -rf "$tmp3"
+
+# ── Test 4: stamp-only migration (v2.20, no migrations needed) ──────────
+echo ""
+echo -e "${CYAN}── G-06: stamp-only migration ──${NC}"
+tmp4="$(mktemp -d)"
+cp -r "$FIXTURES/v2.20-project/"* "$tmp4/"
+cd "$tmp4"
+git init --quiet && git config user.email "test@b.dev" && git config user.name "T" && git add -A && git commit -m "i" --quiet
+
+bash "$REPO_ROOT/scripts/migrate-version.sh" --project "$tmp4" --force --no-commit 2>&1 | tail -3 || true
+
+if [ -f "$tmp4/specs/state.yaml" ]; then
+  stamped="$(python3 -c "import yaml; d=yaml.safe_load(open('$tmp4/specs/state.yaml')); print(d.get('bigpowers_version','MISSING'))" 2>/dev/null)" || stamped="ERR"
+  installed="$(node -e "console.log(require('$REPO_ROOT/package.json').version)" 2>/dev/null)"
+  if [ "$stamped" = "$installed" ]; then
+    pass "v2.20: stamp-only migration produced bigpowers_version=$stamped"
+  else
+    fail "v2.20: stamp check — expected $installed, got $stamped"
+  fi
+else
+  fail "v2.20: state.yaml missing after migration"
+fi
+
+# Validate YAML
+if bash "$VALIDATE_YAML" "$tmp4/specs" 2>&1 | grep -qv 'PARSE ERROR'; then
+  pass "v2.20: validate-specs-yaml"
+else
+  fail "v2.20: validate-specs-yaml had parse errors"
+fi
+rm -rf "$tmp4"
+
+# ── Test 5: v2.0.0 migration roundtrip ──────────────────────────────────
+echo ""
+echo -e "${CYAN}── G-06: v2.0.0 migration roundtrip ──${NC}"
+tmp5="$(mktemp -d)"
+cp -r "$FIXTURES/v2.0.0-project/"* "$tmp5/"
+cd "$tmp5"
+git init --quiet && git config user.email "test@b.dev" && git config user.name "T" && git add -A && git commit -m "i" --quiet
+
+bash "$REPO_ROOT/scripts/migrate-version.sh" --project "$tmp5" --force --no-commit 2>&1 | tail -5 || true
+
+if [ -f "$tmp5/specs/state.yaml" ]; then
+  installed="$(node -e "console.log(require('$REPO_ROOT/package.json').version)" 2>/dev/null)"
+  stamped="$(python3 -c "import yaml; d=yaml.safe_load(open('$tmp5/specs/state.yaml')); print(d.get('bigpowers_version','MISSING'))" 2>/dev/null)" || stamped="ERR"
+  if [ "$stamped" = "$installed" ]; then
+    pass "v2.0.0: stamp = $stamped after migration"
+  else
+    fail "v2.0.0: stamp check — expected $installed, got $stamped"
+  fi
+else
+  fail "v2.0.0: state.yaml missing after migration"
+fi
+
+if python3 -c "import yaml; yaml.safe_load(open('$tmp5/specs/state.yaml')); print('OK')" 2>/dev/null | grep -q OK; then
+  pass "v2.0.0: state.yaml is valid YAML after migration"
+else
+  fail "v2.0.0: state.yaml parse error after migration"
+fi
+rm -rf "$tmp5"
+
+echo ""
+echo -e "${CYAN}────────────────────────────────────${NC}"
+echo -e "G-06 Results: ${GREEN}${PASS} passed${NC}, ${RED}${FAIL} failed${NC}"
+if [ $FAIL -gt 0 ]; then
+  exit 1
+fi
+echo -e "${GREEN}G-06: OK${NC}"
+exit 0