capture-spec-drift

name	capture-spec-drift
description	Detect impl→spec drift heuristically (LLM-driven) and hand off each finding to the livespec propose-change operation with user consent. Invoked as livespec-orchestrator-beads-fabro:capture-spec-drift.

capture-spec-drift — Codex binding

Thin Codex binding for the capture-spec-drift operation of the livespec-orchestrator-beads-fabro plugin. The complete harness-neutral driving prose — the Spec Reader baseline load, the impl-tree survey, the per-finding consent, and the cross-boundary propose-change handoff — is the plugin's own artifact at $PLUGIN_ROOT/prose/capture-spec-drift.md. FIRST resolve $PLUGIN_ROOT (next section), THEN read that prose file in full, then execute it end-to-end, binding its harness-neutral vocabulary to this runtime per ## Runtime bindings below. This binding adds NO operation behavior of its own.

Resolving the plugin root ($PLUGIN_ROOT)

Codex does NOT textually substitute a plugin-root token into SKILL prose, so resolve it explicitly, once, in this order:

1. If LIVESPEC_ORCH_PLUGIN_ROOT is set and non-empty, use it (explicit override for nonstandard dev setups).
2. Else if ./.claude-plugin/scripts/bin exists under the cwd AND ./.claude-plugin validates as this orchestrator plugin checkout (matching plugin manifest name), use $(pwd)/.claude-plugin.
3. Else use the newest valid installed cache root under $HOME/.codex/plugins/cache/livespec-orchestrator-beads-fabro/livespec-orchestrator-beads-fabro/<version>.
4. Else resolve the installed plugin's source.path from codex plugin list --json -m livespec-orchestrator-beads-fabro using a robust executable lookup (command -v codex, $HOME/.local/bin/codex, then $HOME/.bun/bin/codex). (the install flattens ./.claude-plugin, so that path carries scripts/ directly).

PLUGIN_ROOT="${LIVESPEC_ORCH_PLUGIN_ROOT:-}"
PLUGIN_ROOT_DIAGNOSTICS=""
if [ -z "$PLUGIN_ROOT" ] && [ -d "./.claude-plugin/scripts/bin" ]; then
  CANDIDATE_PLUGIN_ROOT="$(pwd)/.claude-plugin"
  if [ -f "$CANDIDATE_PLUGIN_ROOT/plugin.json" ] && python3 - "$CANDIDATE_PLUGIN_ROOT/plugin.json" <<'PY'
import json
import sys

try:
    with open(sys.argv[1], encoding="utf-8") as f:
        data = json.load(f)
except Exception:
    sys.exit(1)
sys.exit(0 if data.get("name") == "livespec-orchestrator-beads-fabro" else 1)
PY
  then
    PLUGIN_ROOT="$CANDIDATE_PLUGIN_ROOT"
  fi
fi
if [ -z "$PLUGIN_ROOT" ]; then
  CODEX_CACHE_PARENT="$HOME/.codex/plugins/cache/livespec-orchestrator-beads-fabro/livespec-orchestrator-beads-fabro"
  if [ -d "$CODEX_CACHE_PARENT" ]; then
    CANDIDATE_PLUGIN_ROOT="$(find "$CODEX_CACHE_PARENT" -mindepth 1 -maxdepth 1 -type d | sort -V | tail -n 1)"
    if [ -n "$CANDIDATE_PLUGIN_ROOT" ] && [ -d "$CANDIDATE_PLUGIN_ROOT/scripts/bin" ]; then
      PLUGIN_ROOT=
    
      PLUGIN_ROOT_DIAGNOSTICS=
    
  
    PLUGIN_ROOT_DIAGNOSTICS=
  

 [ -z  ]; 
  CODEX_BIN=
  CODEX_TRIED=
    -v codex >/dev/null 2>&1; 
    CODEX_BIN=
   [ -x  ]; 
    CODEX_BIN=
   [ -x  ]; 
    CODEX_BIN=
  
    PLUGIN_ROOT_DIAGNOSTICS=
  
   [ -n  ]; 
    PLUGIN_ROOT=installedpluginIdlivespec-orchestrator-beads-fabro@livespec-orchestrator-beads-fabropath
     [ -z  ]; 
      PLUGIN_ROOT_DIAGNOSTICS=
       [ -s /tmp/livespec-orchestrator-beads-fabro-codex-plugin-list.err ]; 
        PLUGIN_ROOT_DIAGNOSTICS=
      
    
  

 [ -z  ] || [ ! -d  ]; 
    >&2
   [ -n  ]; 
       >&2
  
    >&2
    >&2
    >&2
   1

If resolution fails, STOP and surface those install instructions rather than improvising paths. Then read the prose:

cat "$PLUGIN_ROOT/prose/capture-spec-drift.md"

Runtime bindings

• "the propose-change operation" — the livespec:propose-change Codex skill (the cross-boundary handoff to livespec core), invoked by name; equivalently the core propose-change CLI. The prose's the propose-change operation --spec-target … --topic … --body … invocation maps to that skill's --spec-target … --topic … --body … surface.
• "ask the user" / "confirm with the user" / "surface" / "narrate" — conversational narration in this session (ask one question at a time).
• "read <file>" — reading the file directly. Python snippets (e.g. the Spec Reader read_current_specification call) — run via the shell tool against the bundled livespec_orchestrator_beads_fabro package (the wrappers self-bootstrap the import path).
• "the capture-impl-gaps operation" — the capture-impl-gaps skill in this plugin (invoke it by name).