@cairnkeep/cli 2.5.0 → 2.7.0

package/scripts/completion.sh

@@ -11,7 +11,7 @@ _cairn_complete() {
   COMPREPLY=()
   current=${COMP_WORDS[COMP_CWORD]}
   previous=${COMP_WORDS[COMP_CWORD-1]:-}
-  commands="bootstrap memory-server sync sync-pi doctor trajectory artifact capabilities notes eval memory audit-timer uninstall completion version help"
+  commands="bootstrap memory-server sync sync-pi sync-kimi doctor trajectory artifact capabilities notes eval graph memory audit-timer uninstall completion version help"
   if (( COMP_CWORD == 1 )); then
     COMPREPLY=( $(compgen -W "$commands" -- "$current") )
     return
@@ -20,6 +20,7 @@ _cairn_complete() {
     bootstrap) COMPREPLY=( $(compgen -W "--untracked" -- "$current") ) ;;
     sync) COMPREPLY=( $(compgen -W "--apply --live-root" -- "$current") ) ;;
     sync-pi) COMPREPLY=( $(compgen -W "--apply --live-root" -- "$current") ) ;;
+    sync-kimi) COMPREPLY=( $(compgen -W "--apply --live-root" -- "$current") ) ;;
     doctor) COMPREPLY=( $(compgen -W "--repair" -- "$current") ) ;;
     trajectory) COMPREPLY=( $(compgen -W "list show prune --json --dry-run" -- "$current") ) ;;
     artifact) COMPREPLY=( $(compgen -W "list show delete prune --kind --session --json --dry-run --include-protected" -- "$current") ) ;;
@@ -62,9 +63,10 @@ _cairn_complete() {
         *) COMPREPLY=( $(compgen -W "validate run ablate report prune delete" -- "$current") ) ;;
       esac
       ;;
+    graph) COMPREPLY=( $(compgen -W "build query status diff explain path --force" -- "$current") ) ;;
     memory) COMPREPLY=( $(compgen -W "path export import" -- "$current") ) ;;
     audit-timer) COMPREPLY=( $(compgen -W "--on-calendar --para-root --render-only" -- "$current") ) ;;
-    uninstall) COMPREPLY=( $(compgen -W "--dry-run --yes --purge-memory --live-root --pi-live-root" -- "$current") ) ;;
+    uninstall) COMPREPLY=( $(compgen -W "--dry-run --yes --purge-memory --live-root --pi-live-root --kimi-live-root" -- "$current") ) ;;
     completion) COMPREPLY=( $(compgen -W "bash zsh fish" -- "$current") ) ;;
   esac
 }
@@ -80,13 +82,15 @@ _cairn() {
     'bootstrap:scaffold a project'
     'memory-server:run the memory MCP server'
     'sync:install the Claude operating layer'
-    'sync-pi:install the Pi trajectory extension'
+    'sync-pi:install the Pi trajectory extension and graph prompt'
+    'sync-kimi:install the Kimi graph Skill'
     'doctor:check runtime dependencies and endpoints'
     'trajectory:inspect and prune local session trajectories'
     'artifact:inspect, delete, and prune local artifacts'
     'capabilities:inspect and manage project capability state'
     'notes:distill and search local hindsight notes'
     'eval:run and inspect default-off local evaluations'
+    'graph:inspect a published Graphify graph'
     'memory:manage the durable memory store'
     'audit-timer:install a memory and wiki audit timer'
     'uninstall:remove installed Cairnkeep components safely'
@@ -102,6 +106,7 @@ _cairn() {
     bootstrap) _arguments '--untracked[keep scaffold out of Git]' '*:project directory:_files -/' ;;
     sync) _arguments '--apply[apply changes]' '--live-root[project Claude root]:directory:_files -/' ;;
     sync-pi) _arguments '--apply[apply changes]' '--live-root[Pi agent root]:directory:_files -/' ;;
+    sync-kimi) _arguments '--apply[apply changes]' '--live-root[Kimi Code root]:directory:_files -/' ;;
     doctor) _arguments '--repair[repair trajectory metadata and indexes]' ;;
     trajectory) _values 'trajectory command' list show prune ;;
     artifact)
@@ -134,9 +139,10 @@ _cairn() {
         *) _values 'eval command' validate run ablate report prune delete ;;
       esac
       ;;
+    graph) _values 'graph command' build query status diff explain path '--force[allow a smaller graph after code deletion]' ;;
     memory) _values 'memory command' path export import ;;
     audit-timer) _arguments '--on-calendar[systemd calendar]:calendar:' '--para-root[PARA root]:directory:_files -/' '--render-only[render directory]:directory:_files -/' ;;
-    uninstall) _arguments '--dry-run[show changes]' '--yes[skip confirmation]' '--purge-memory[delete memory]' '--live-root[project Claude root]:directory:_files -/' '--pi-live-root[Pi agent root]:directory:_files -/' '*:project directory:_files -/' ;;
+    uninstall) _arguments '--dry-run[show changes]' '--yes[skip confirmation]' '--purge-memory[delete memory]' '--live-root[project Claude root]:directory:_files -/' '--pi-live-root[Pi agent root]:directory:_files -/' '--kimi-live-root[Kimi Code root]:directory:_files -/' '*:project directory:_files -/' ;;
     completion) _values 'shell' bash zsh fish ;;
     *) _arguments '*:argument:_files' ;;
   esac
@@ -147,13 +153,15 @@ EOF
   fish)
     cat <<'EOF'
 complete -c cairn -f
-for command in bootstrap memory-server sync sync-pi doctor trajectory artifact capabilities notes eval memory audit-timer uninstall completion version help
-    complete -c cairn -n "not __fish_seen_subcommand_from bootstrap memory-server sync sync-pi doctor trajectory artifact capabilities notes eval memory audit-timer uninstall completion version help" -a $command
+for command in bootstrap memory-server sync sync-pi sync-kimi doctor trajectory artifact capabilities notes eval graph memory audit-timer uninstall completion version help
+    complete -c cairn -n "not __fish_seen_subcommand_from bootstrap memory-server sync sync-pi sync-kimi doctor trajectory artifact capabilities notes eval graph memory audit-timer uninstall completion version help" -a $command
 end
 complete -c cairn -n "__fish_seen_subcommand_from sync" -l apply
 complete -c cairn -n "__fish_seen_subcommand_from sync" -l live-root -r
 complete -c cairn -n "__fish_seen_subcommand_from sync-pi" -l apply
 complete -c cairn -n "__fish_seen_subcommand_from sync-pi" -l live-root -r
+complete -c cairn -n "__fish_seen_subcommand_from sync-kimi" -l apply
+complete -c cairn -n "__fish_seen_subcommand_from sync-kimi" -l live-root -r
 complete -c cairn -n "__fish_seen_subcommand_from bootstrap" -l untracked
 complete -c cairn -n "__fish_seen_subcommand_from memory" -a "path export import"
 complete -c cairn -n "__fish_seen_subcommand_from doctor" -l repair
@@ -183,8 +191,11 @@ complete -c cairn -n "__fish_seen_subcommand_from eval; and __fish_seen_subcomma
 complete -c cairn -n "__fish_seen_subcommand_from eval; and __fish_seen_subcommand_from prune" -l older-than-days -r
 complete -c cairn -n "__fish_seen_subcommand_from eval; and __fish_seen_subcommand_from prune delete" -l dry-run
 complete -c cairn -n "__fish_seen_subcommand_from eval; and __fish_seen_subcommand_from validate run ablate report prune delete" -l json
+complete -c cairn -n "__fish_seen_subcommand_from graph" -a "build query status diff explain path"
+complete -c cairn -n "__fish_seen_subcommand_from graph; and __fish_seen_subcommand_from build" -l force
 complete -c cairn -n "__fish_seen_subcommand_from completion" -a "bash zsh fish"
 complete -c cairn -n "__fish_seen_subcommand_from uninstall" -l pi-live-root -r
+complete -c cairn -n "__fish_seen_subcommand_from uninstall" -l kimi-live-root -r
 EOF
     ;;
   *)

package/scripts/smoke-bash32.sh

@@ -31,6 +31,7 @@ SCRIPTS=(
   scripts/sync-opencode-explore-assets.sh
   scripts/sync-opencode-wiki-assets.sh
   scripts/sync-pi-assets.sh
+  scripts/sync-kimi-assets.sh
 )
 
 fails=0

package/scripts/sync-kimi-assets.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+Usage: sync-kimi-assets.sh [--check|--apply] [--live-root PATH]
+
+Compare or sync Cairnkeep's thin graph Skill against the live Kimi Code tree.
+
+Options:
+  --check            Verify managed live assets match the repo copies (default)
+  --apply            Install managed assets, then verify
+  --live-root PATH   Override the Kimi Code root (default: $KIMI_CODE_HOME or ~/.kimi-code)
+  -h, --help         Show this help text
+EOF
+}
+
+ROOT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)
+SOURCE_ROOT="$ROOT_DIR/kimi"
+LIVE_ROOT="${KIMI_CODE_HOME:-$HOME/.kimi-code}"
+MODE="check"
+ASSETS=("skills/graphify/SKILL.md")
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --check) MODE="check"; shift ;;
+    --apply) MODE="apply"; shift ;;
+    --live-root) LIVE_ROOT="$2"; shift 2 ;;
+    -h|--help) usage; exit 0 ;;
+    *) echo "Unknown argument: $1" >&2; usage >&2; exit 2 ;;
+  esac
+done
+
+ensure_sources() {
+  local rel
+  for rel in "${ASSETS[@]}"; do
+    [[ -f "$SOURCE_ROOT/$rel" ]] || {
+      echo "Missing repo-managed source asset: $SOURCE_ROOT/$rel" >&2
+      return 2
+    }
+  done
+}
+
+check_assets() {
+  local rel
+  local failed=0
+  for rel in "${ASSETS[@]}"; do
+    if [[ ! -f "$LIVE_ROOT/$rel" ]]; then
+      echo "Missing live Kimi asset under $LIVE_ROOT: $rel" >&2
+      failed=1
+    elif ! cmp -s "$SOURCE_ROOT/$rel" "$LIVE_ROOT/$rel"; then
+      echo "Out-of-sync live Kimi asset under $LIVE_ROOT: $rel" >&2
+      failed=1
+    fi
+  done
+  return "$failed"
+}
+
+ensure_sources
+
+if [[ "$MODE" == "apply" ]]; then
+  updated=0
+  unchanged=0
+  for rel in "${ASSETS[@]}"; do
+    mkdir -p "$(dirname "$LIVE_ROOT/$rel")"
+    if [[ -f "$LIVE_ROOT/$rel" ]] && cmp -s "$SOURCE_ROOT/$rel" "$LIVE_ROOT/$rel"; then
+      unchanged=$((unchanged + 1))
+    else
+      install -m 0644 "$SOURCE_ROOT/$rel" "$LIVE_ROOT/$rel"
+      updated=$((updated + 1))
+    fi
+  done
+  printf 'Applied %s Kimi asset(s); %s already matched.\n' "$updated" "$unchanged"
+fi
+
+check_assets
+printf 'Kimi graph Skill is in sync under %s\n' "$LIVE_ROOT"

package/scripts/sync-pi-assets.sh

@@ -5,8 +5,8 @@ usage() {
   cat <<'EOF'
 Usage: sync-pi-assets.sh [--check|--apply] [--live-root PATH]
 
-Compare or sync the repo-managed Pi extension assets against the live Pi agent
-configuration tree.
+Compare or sync the repo-managed Pi extension and prompt assets against the
+live Pi agent configuration tree.
 
 Options:
   --check            Verify managed live assets match the rendered repo copies (default)
@@ -20,7 +20,10 @@ ROOT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)
 SOURCE_ROOT="$ROOT_DIR/pi"
 LIVE_ROOT="${PI_CODING_AGENT_DIR:-$HOME/.pi/agent}"
 MODE="check"
-ASSET="extensions/cairnkeep-trajectory.ts"
+ASSETS=(
+  "extensions/cairnkeep-trajectory.ts"
+  "prompts/graphify.md"
+)
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
@@ -33,40 +36,58 @@ while [[ $# -gt 0 ]]; do
 done
 
 render_asset() {
-  sed "s|@@INFRA_ROOT@@|$ROOT_DIR|g" "$SOURCE_ROOT/$ASSET"
+  local rel="$1"
+  if [[ "$rel" == "extensions/cairnkeep-trajectory.ts" ]]; then
+    sed "s|@@INFRA_ROOT@@|$ROOT_DIR|g" "$SOURCE_ROOT/$rel"
+  else
+    cat "$SOURCE_ROOT/$rel"
+  fi
+}
+
+ensure_sources() {
+  local rel
+  for rel in "${ASSETS[@]}"; do
+    [[ -f "$SOURCE_ROOT/$rel" ]] || {
+      echo "Missing repo-managed source asset: $SOURCE_ROOT/$rel" >&2
+      return 2
+    }
+  done
 }
 
-check_asset() {
-  [[ -f "$SOURCE_ROOT/$ASSET" ]] || {
-    echo "Missing repo-managed source asset: $SOURCE_ROOT/$ASSET" >&2
-    return 2
-  }
-  [[ -f "$LIVE_ROOT/$ASSET" ]] || {
-    echo "Missing live Pi extension under $LIVE_ROOT: $ASSET" >&2
-    return 1
-  }
-  cmp -s <(render_asset) "$LIVE_ROOT/$ASSET" || {
-    echo "Out-of-sync live Pi extension under $LIVE_ROOT: $ASSET" >&2
-    return 1
-  }
+check_assets() {
+  local rel
+  local failed=0
+  for rel in "${ASSETS[@]}"; do
+    if [[ ! -f "$LIVE_ROOT/$rel" ]]; then
+      echo "Missing live Pi asset under $LIVE_ROOT: $rel" >&2
+      failed=1
+    elif ! cmp -s <(render_asset "$rel") "$LIVE_ROOT/$rel"; then
+      echo "Out-of-sync live Pi asset under $LIVE_ROOT: $rel" >&2
+      failed=1
+    fi
+  done
+  return "$failed"
 }
 
+ensure_sources
+
 if [[ "$MODE" == "apply" ]]; then
-  [[ -f "$SOURCE_ROOT/$ASSET" ]] || {
-    echo "Missing repo-managed source asset: $SOURCE_ROOT/$ASSET" >&2
-    exit 2
-  }
-  mkdir -p "$(dirname "$LIVE_ROOT/$ASSET")"
-  if [[ -f "$LIVE_ROOT/$ASSET" ]] && cmp -s <(render_asset) "$LIVE_ROOT/$ASSET"; then
-    echo "Applied 0 Pi extension asset(s); 1 already matched."
-  else
+  updated=0
+  unchanged=0
+  for rel in "${ASSETS[@]}"; do
+    mkdir -p "$(dirname "$LIVE_ROOT/$rel")"
+    if [[ -f "$LIVE_ROOT/$rel" ]] && cmp -s <(render_asset "$rel") "$LIVE_ROOT/$rel"; then
+      unchanged=$((unchanged + 1))
+      continue
+    fi
     rendered_tmp=$(mktemp)
-    render_asset > "$rendered_tmp"
-    install -m 0644 "$rendered_tmp" "$LIVE_ROOT/$ASSET"
+    render_asset "$rel" > "$rendered_tmp"
+    install -m 0644 "$rendered_tmp" "$LIVE_ROOT/$rel"
     rm -f "$rendered_tmp"
-    echo "Applied 1 Pi extension asset(s); 0 already matched."
-  fi
+    updated=$((updated + 1))
+  done
+  printf 'Applied %s Pi asset(s); %s already matched.\n' "$updated" "$unchanged"
 fi
 
-check_asset
-printf 'Pi extension assets are in sync under %s\n' "$LIVE_ROOT"
+check_assets
+printf 'Pi extension and graph prompt are in sync under %s\n' "$LIVE_ROOT"

package/scripts/test-bootstrap-untracked.sh

@@ -54,7 +54,29 @@ git -C "$tmp/repo" init -q
 "$ROOT/scripts/bootstrap.sh" --untracked "$tmp/repo" >/dev/null
 [[ -f "$tmp/repo/.ai/start-claude.sh" ]] || fail "scaffold missing"
 [[ -x "$tmp/repo/.ai/start-kimi.sh" ]] || fail "Kimi launcher missing"
+[[ -x "$tmp/repo/.ai/start-qwen.sh" ]] || fail "Qwen launcher missing"
 [[ -f "$tmp/repo/.planning/config.json" ]] || fail "planning layer missing"
+graph_policy="$tmp/repo/.planning/graphs/policy.md"
+grep -qF '`uv tool install graphifyy`' "$graph_policy" ||
+  fail "Graphify policy must install the CLI in an isolated uv tool environment"
+if grep -qF '`uv pip install graphifyy && graphify install`' "$graph_policy"; then
+  fail "Graphify policy must not install Graphify-owned skills or hooks"
+fi
+if ! grep -qF 'Do not run' "$graph_policy" ||
+  ! grep -qF '`graphify install`: Cairnkeep owns' "$graph_policy"; then
+  fail "Graphify policy must explain that Cairnkeep owns the harness wiring"
+fi
+grep -qF '`/graphify build`' "$graph_policy" ||
+  fail "Graphify policy must name Cairnkeep's installed build command"
+grep -qF '`cairn sync-kimi' "$graph_policy" ||
+  fail "Graphify policy must identify the Kimi thin adapter"
+grep -qF '`cairn sync-pi' "$graph_policy" ||
+  fail "Graphify policy must identify the Pi thin adapter"
+grep -qF '`cairn graph build`' "$graph_policy" ||
+  fail "Graphify policy must provide the portable CLI equivalent"
+if grep -qF '/gsd-graphify' "$graph_policy"; then
+  fail "Graphify policy must not name the GSD-internal command"
+fi
 [[ -f "$tmp/repo/.agentfs/.gitignore" ]] || fail "project-memory ignore guard missing"
 [[ -z "$(git -C "$tmp/repo" status --porcelain)" ]] || fail "scaffold visible to git"
 grep -qxF "/.ai/" "$tmp/repo/.git/info/exclude" || fail "missing /.ai/ exclude entry"
@@ -67,7 +89,7 @@ grep -qxF "/.agentfs/" "$tmp/repo/.git/info/exclude" || fail "missing /.agentfs/
 printf '%s\n' '{"schema_version":1,"capabilities":{"wiki":false},"logging":{"callbacks":true}}' >"$tmp/repo/.ai/capabilities.json"
 chmod 600 "$tmp/repo/.ai/capabilities.json"
 printf '%s\n' '# operator-owned environment' >"$tmp/repo/.ai/env.example"
-asset_paths='.ai/start-claude.sh .ai/start-opencode.sh .ai/start-pi.sh .ai/start-kimi.sh .ai/env.example .ai/trajectory-redaction.json .ai/capabilities.json .agentfs/.gitignore .planning/config.json .planning/wiki/index.md .planning/wiki/policy.md .planning/wiki/CONTRADICTIONS.md .planning/wiki/LOG.md .planning/alignment/policy.md .planning/alignment/gap-register.yaml .planning/graphs/policy.md .planning/graphs/.gitignore .planning/security/policy.md'
+asset_paths='.ai/start-claude.sh .ai/start-opencode.sh .ai/start-pi.sh .ai/start-kimi.sh .ai/start-qwen.sh .ai/env.example .ai/trajectory-redaction.json .ai/capabilities.json .agentfs/.gitignore .planning/config.json .planning/wiki/index.md .planning/wiki/policy.md .planning/wiki/CONTRADICTIONS.md .planning/wiki/LOG.md .planning/alignment/policy.md .planning/alignment/gap-register.yaml .planning/graphs/policy.md .planning/graphs/.gitignore .planning/security/policy.md'
 mkdir -p "$tmp/assets-before"
 for path in $asset_paths; do
   cp "$tmp/repo/$path" "$tmp/assets-before/${path//\//__}"

package/scripts/test-cli-dispatch.sh

@@ -11,15 +11,19 @@ tmp=$(mktemp -d); trap 'rm -rf "$tmp"' EXIT
 "$cairn" help | grep -q "cairn audit-timer" || fail "help missing audit-timer"
 "$cairn" help | grep -q "cairn sync" || fail "help missing sync"
 "$cairn" help | grep -q "cairn sync-pi" || fail "help missing sync-pi"
+"$cairn" help | grep -q "cairn sync-kimi" || fail "help missing sync-kimi"
 "$cairn" help | grep -q "cairn memory-server" || fail "help missing memory-server"
 "$cairn" help | grep -q "cairn notes" || fail "help missing notes"
 "$cairn" help | grep -q "cairn artifact <list|show|delete|prune>" || fail "help missing artifact"
 "$cairn" help | grep -q "cairn capabilities <list|status|enable|disable|reset|logging>" || fail "help missing capabilities"
+"$cairn" help | grep -q "cairn graph <build|query|status|diff|explain|path>" || fail "help missing graph"
 "$cairn" sync --help >/dev/null 2>&1 || fail "cairn sync dispatch"
 "$cairn" sync-pi --help >/dev/null 2>&1 || fail "cairn sync-pi dispatch"
+"$cairn" sync-kimi --help >/dev/null 2>&1 || fail "cairn sync-kimi dispatch"
 env -u CAIRN_NOTE_DISTILLATION "$cairn" notes --help >/dev/null 2>&1 || fail "cairn notes dispatch"
 "$cairn" artifact --help | grep -q "cairn artifact list" || fail "cairn artifact dispatch"
 "$cairn" capabilities --help >"$tmp/capabilities-help" 2>/dev/null || fail "cairn capabilities dispatch"
+"$cairn" graph --help | grep -q "cairn graph explain <symbol>" || fail "cairn graph dispatch"
 grep -qxF 'MCP capability changes require a memory-server restart. Operating capability' "$tmp/capabilities-help" || fail "capability help missing exact restart wording"
 grep -qxF 'changes apply on the next invocation.' "$tmp/capabilities-help" || fail "capability help missing exact invocation wording"
 if grep -Eq '^  cairn capabilities (guard|start|finish|doctor)' "$tmp/capabilities-help"; then

package/scripts/test-completion.sh

@@ -71,14 +71,19 @@ grep -q '#compdef cairn' "$tmp/zsh"
 grep -q 'complete -c cairn' "$tmp/fish"
 for shell in bash zsh; do
   grep -q 'sync-pi' "$tmp/$shell"
+  grep -q 'sync-kimi' "$tmp/$shell"
   grep -q -- '--live-root' "$tmp/$shell"
 done
 grep -q 'sync-pi' "$tmp/fish"
+grep -q 'sync-kimi' "$tmp/fish"
+grep -q 'not __fish_seen_subcommand_from .*sync-pi sync-kimi' "$tmp/fish"
 grep -q -- '-l live-root' "$tmp/fish"
 for shell in bash zsh fish; do
   grep -q 'notes' "$tmp/$shell"
   grep -q 'distill.*search-error.*promote.*doctor\|distill search-error promote doctor' "$tmp/$shell"
   grep -q 'artifact' "$tmp/$shell"
+  grep -q 'graph' "$tmp/$shell"
+  grep -q 'build.*query.*status.*diff.*explain.*path\|build query status diff explain path' "$tmp/$shell"
   grep -q 'list.*show.*delete.*prune' "$tmp/$shell"
   grep -q -- '--json\|-l json' "$tmp/$shell"
   grep -q -- '--dry-run\|-l dry-run' "$tmp/$shell"

package/scripts/test-graph-harness-adapters.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# Contract test: Pi and Kimi expose thin graph adapters owned by `cairn graph`.
+set -euo pipefail
+
+ROOT=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)
+tmp=$(mktemp -d)
+trap 'rm -rf "$tmp"' EXIT
+fail() { echo "FAIL: $1" >&2; exit 1; }
+
+PI_SOURCE="$ROOT/pi/prompts/graphify.md"
+KIMI_SOURCE="$ROOT/kimi/skills/graphify/SKILL.md"
+
+[[ -f "$PI_SOURCE" ]] || fail "Pi /graphify prompt source is missing"
+[[ -f "$KIMI_SOURCE" ]] || fail "Kimi graphify skill source is missing"
+
+for adapter in "$PI_SOURCE" "$KIMI_SOURCE"; do
+  grep -qF 'cairn graph' "$adapter" || fail "adapter does not delegate to cairn graph: $adapter"
+  if grep -Ei '(^|[^/[:alnum:]_-])graphify[[:space:]]+(build|update|query|status|diff|explain|path)' "$adapter" >/dev/null; then
+    fail "adapter invokes Graphify directly: $adapter"
+  fi
+  if grep -Ei '(^|[[:space:]`])(curl|git|node|npm|npx|python|python3)[[:space:]]' "$adapter" >/dev/null; then
+    fail "adapter introduces a second executable delegate: $adapter"
+  fi
+done
+
+grep -qF '$ARGUMENTS' "$PI_SOURCE" || fail "Pi prompt does not forward command arguments"
+grep -qF 'name: graphify' "$KIMI_SOURCE" || fail "Kimi skill does not register as graphify"
+grep -qF '$ARGUMENTS' "$KIMI_SOURCE" || fail "Kimi skill does not forward command arguments"
+
+PI_LIVE="$tmp/pi"
+"$ROOT/scripts/sync-pi-assets.sh" --apply --live-root "$PI_LIVE" >"$tmp/pi-first"
+[[ -f "$PI_LIVE/extensions/cairnkeep-trajectory.ts" ]] || fail "Pi sync omitted trajectory extension"
+cmp -s "$PI_SOURCE" "$PI_LIVE/prompts/graphify.md" || fail "Pi sync changed graphify prompt bytes"
+"$ROOT/scripts/sync-pi-assets.sh" --apply --live-root "$PI_LIVE" >"$tmp/pi-second"
+grep -qF 'Applied 0 Pi asset(s); 2 already matched.' "$tmp/pi-second" || fail "Pi sync is not idempotent"
+
+KIMI_LIVE="$tmp/kimi"
+"$ROOT/scripts/sync-kimi-assets.sh" --apply --live-root "$KIMI_LIVE" >"$tmp/kimi-first"
+cmp -s "$KIMI_SOURCE" "$KIMI_LIVE/skills/graphify/SKILL.md" || fail "Kimi sync changed graphify skill bytes"
+"$ROOT/scripts/sync-kimi-assets.sh" --apply --live-root "$KIMI_LIVE" >"$tmp/kimi-second"
+grep -qF 'Applied 0 Kimi asset(s); 1 already matched.' "$tmp/kimi-second" || fail "Kimi sync is not idempotent"
+
+"$ROOT/bin/cairn" help | grep -qF 'cairn sync-kimi' || fail "CLI help omits sync-kimi"
+"$ROOT/bin/cairn" sync-kimi --help >/dev/null || fail "CLI does not dispatch sync-kimi"
+
+echo "PASS: thin Pi and Kimi graph adapters delegate only to cairn graph"

package/scripts/test-launcher-hooks.sh

@@ -425,14 +425,18 @@ pi_launcher="$repo/.ai/start-pi.sh"
 [[ -x "$pi_launcher" ]] || fail "Pi launcher not scaffolded"
 kimi_launcher="$repo/.ai/start-kimi.sh"
 [[ -x "$kimi_launcher" ]] || fail "Kimi launcher not scaffolded"
+qwen_launcher="$repo/.ai/start-qwen.sh"
+[[ -x "$qwen_launcher" ]] || fail "Qwen launcher not scaffolded"
 
 # OpenCode's run mode ends a turn after content-only output. Commands that need
 # owner I/O must therefore make their first response action a tool call rather
 # than requiring a standalone banner before the config gate.
 ! grep -qF '**Before ANY tool calls**, display this banner:' "$ROOT/opencode/command/graphify.md" \
   || fail "OpenCode graphify can stop after its pre-tool banner"
-grep -qF '**First action:** invoke the Read tool' "$ROOT/opencode/command/graphify.md" \
-  || fail "OpenCode graphify does not require the config-gate tool call first"
+! grep -qF '**First action:** invoke the Read tool' "$ROOT/opencode/command/graphify.md" \
+  || fail "OpenCode graphify still duplicates the Cairnkeep-owned capability gate"
+grep -qF '`cairn graph` operation enforces the typed `graph` capability' "$ROOT/opencode/command/graphify.md" \
+  || fail "OpenCode graphify does not delegate its capability gate to the owner"
 grep -qF '**Invoke the shell tool** with this exact command' "$ROOT/opencode/command/graphify.md" \
   || fail "OpenCode graphify does not require real shell delegation"
 grep -qF '<argument>$ARGUMENTS</argument>' "$ROOT/opencode/command/graphify.md" \
@@ -471,12 +475,18 @@ cat > "$tmp/bin/kimi" <<'FAKE'
 { echo "args:$*"; echo "prelaunch:${PRELAUNCH_RAN:-0}"; echo "extra:${CAIRN_EXTRA_SETTINGS:-}"; } > "$KIMI_LOG"
 exit "${FAKE_EXIT:-0}"
 FAKE
-chmod +x "$tmp/bin/claude" "$tmp/bin/opencode" "$tmp/bin/kimi"
+cat > "$tmp/bin/qwen" <<'FAKE'
+#!/usr/bin/env bash
+{ echo "args:$*"; echo "prelaunch:${PRELAUNCH_RAN:-0}"; echo "extra:${CAIRN_EXTRA_SETTINGS:-}"; } > "$QWEN_LOG"
+exit "${FAKE_EXIT:-0}"
+FAKE
+chmod +x "$tmp/bin/claude" "$tmp/bin/opencode" "$tmp/bin/kimi" "$tmp/bin/qwen"
 ln -s "$ROOT/bin/cairn" "$tmp/bin/cairn"
 export PATH="$tmp/bin:$PATH"
 export CLAUDE_LOG="$tmp/claude.log"
 export OPENCODE_LOG="$tmp/opencode.log"
 export KIMI_LOG="$tmp/kimi.log"
+export QWEN_LOG="$tmp/qwen.log"
 
 # Claude sync has three exact installation states. Normal sync and an explicit
 # overlay request with the master off must contain no capability hook bytes or
@@ -540,6 +550,10 @@ grep -qx "capability-registration:0" "$OPENCODE_LOG" || fail "OpenCode baseline
 grep -qx "args:--foo bar" "$KIMI_LOG" || fail "Kimi baseline did not pass args through"
 grep -qx "prelaunch:0" "$KIMI_LOG" || fail "Kimi prelaunch marker leaked without a hook"
 
+"$qwen_launcher" --foo bar >/dev/null 2>&1 || fail "Qwen baseline launch failed"
+grep -qx "args:--foo bar" "$QWEN_LOG" || fail "Qwen baseline did not pass args through"
+grep -qx "prelaunch:0" "$QWEN_LOG" || fail "Qwen prelaunch marker leaked without a hook"
+
 # Invalid/off master values stay on the legacy direct-exec path: one harness
 # process, unchanged argv/config environment, and no isolated assets or store.
 legacy_claude="$tmp/legacy-claude"
@@ -636,6 +650,12 @@ grep -qx "args:--plan" "$KIMI_LOG" || fail "Kimi pre-launch changed harness argv
 grep -qx "prelaunch:1" "$KIMI_LOG" || fail "Kimi pre-launch env not visible to harness"
 grep -qx "extra:$tmp/settings.json" "$KIMI_LOG" || fail "Kimi pre-launch environment was not preserved"
 
+rm -f "$QWEN_LOG"
+"$qwen_launcher" --approval-mode plan >/dev/null 2>&1 || fail "Qwen launch with pre-launch failed"
+grep -qx "args:--approval-mode plan" "$QWEN_LOG" || fail "Qwen pre-launch changed harness argv"
+grep -qx "prelaunch:1" "$QWEN_LOG" || fail "Qwen pre-launch env not visible to harness"
+grep -qx "extra:$tmp/settings.json" "$QWEN_LOG" || fail "Qwen pre-launch environment was not preserved"
+
 # 3. pre-launch.sh non-zero aborts the launch before the harness runs.
 rm -f "$CLAUDE_LOG"
 cat > "$repo/.ai/pre-launch.sh" <<'EOF'
@@ -647,6 +667,9 @@ if "$launcher" >/dev/null 2>&1; then fail "non-zero pre-launch should abort the
 rm -f "$KIMI_LOG"
 if "$kimi_launcher" >/dev/null 2>&1; then fail "non-zero pre-launch should abort Kimi"; fi
 [[ ! -f "$KIMI_LOG" ]] || fail "Kimi ran despite pre-launch abort"
+rm -f "$QWEN_LOG"
+if "$qwen_launcher" >/dev/null 2>&1; then fail "non-zero pre-launch should abort Qwen"; fi
+[[ ! -f "$QWEN_LOG" ]] || fail "Qwen ran despite pre-launch abort"
 rm -f "$repo/.ai/pre-launch.sh"
 
 # 4. post-exit.sh runs after the harness with $CAIRN_EXIT_STATUS.
@@ -666,6 +689,13 @@ status=$?
 grep -qx "args:--auto" "$KIMI_LOG" || fail "Kimi launcher changed arguments"
 grep -qx "post:8" "$tmp/post.log" || fail "Kimi launcher post-exit status missing"
 
+rm -f "$tmp/post.log" "$QWEN_LOG"
+FAKE_EXIT=10 "$qwen_launcher" --output-format json >/dev/null 2>&1 && fail "Qwen launcher should propagate harness exit code"
+status=$?
+[[ "$status" -eq 10 ]] || fail "expected exit 10 from Qwen launcher, got $status"
+grep -qx "args:--output-format json" "$QWEN_LOG" || fail "Qwen launcher changed arguments"
+grep -qx "post:10" "$tmp/post.log" || fail "Qwen launcher post-exit status missing"
+
 # 5. Pi launcher preserves the same env/pre/post seams and passes arguments
 # unchanged; Pi has no generic settings-file flag so CAIRN_EXTRA_SETTINGS is ignored.
 rm -f "$repo/.ai/pre-launch.sh" "$repo/.ai/post-exit.sh"

package/scripts/test-learning-docs.sh

@@ -6,11 +6,10 @@ cd "$ROOT"
 
 version=$(node -p "require('./package.json').version")
 landing=docs/learning/README.md
-production=docs/learning/PRODUCTION-PLAN.md
 coverage=docs/learning/CURRICULUM-MAP.md
 feature_guide=docs/learning/FEATURE-GUIDE.md
 
-[[ -f "$landing" && -f "$production" && -f "$coverage" && -f "$feature_guide" ]]
+[[ -f "$landing" && -f "$coverage" && -f "$feature_guide" ]]
 grep -qF 'docs/learning/README.md' README.md
 grep -qF "**Baseline:** Cairnkeep $version" "$coverage"
 grep -qF "**Baseline:** Cairnkeep $version" "$feature_guide"
@@ -33,17 +32,11 @@ for number in $(seq -w 0 17); do
   if grep -q '^\*\*Status:\*\* Ready' "$lesson"; then
     ready=$((ready + 1))
     grep -qF "Tested with:** Cairnkeep $version" "$lesson"
-    script=$(sed -n 's|.*(\.\./video-scripts/\([^)]*\)).*|docs/learning/video-scripts/\1|p' "$lesson")
-    [[ -n "$script" && -f "$script" ]] || {
-      echo "ready lesson has no presenter script: $lesson" >&2
-      exit 1
-    }
     grep -q '^## Common failures$' "$lesson"
     grep -q '^## Privacy and trust boundary$' "$lesson"
   elif grep -q '^\*\*Status:\*\* Brief' "$lesson"; then
     brief=$((brief + 1))
     grep -q '^## Acceptance criteria$' "$lesson"
-    grep -q '^## Planned video$' "$lesson"
   else
     echo "lesson has an unsupported status: $lesson" >&2
     exit 1
@@ -91,4 +84,4 @@ for (const file of markdownFiles("docs/learning")) {
 }
 NODE
 
-echo "PASS: learning path structure, readiness, scripts, and version alignment"
+echo "PASS: public learning path structure, readiness, links, and version alignment"

package/scripts/test-package-install.sh

@@ -44,6 +44,7 @@ bootstrap_output=$(cairn bootstrap "$tmp/project")
 [[ -x "$tmp/project/.ai/start-claude.sh" ]] || fail "bootstrap did not install an executable Claude launcher"
 [[ -x "$tmp/project/.ai/start-pi.sh" ]] || fail "bootstrap did not install an executable Pi launcher"
 [[ -x "$tmp/project/.ai/start-kimi.sh" ]] || fail "bootstrap did not install an executable Kimi launcher"
+[[ -x "$tmp/project/.ai/start-qwen.sh" ]] || fail "bootstrap did not install an executable Qwen launcher"
 [[ -f "$tmp/project/.planning/config.json" ]] || fail "bootstrap did not install the planning scaffold"
 
 (cd "$tmp/project" && cairn doctor) >/dev/null || fail "installed package failed cairn doctor"
@@ -217,12 +218,20 @@ NODE
   fail "npm tarball omitted the default AnythingLLM sync script"
 [[ -f "$installed_root/pi/extensions/cairnkeep-trajectory.ts" ]] || \
   fail "npm tarball omitted the Pi trajectory extension"
+[[ -f "$installed_root/pi/prompts/graphify.md" ]] || \
+  fail "npm tarball omitted the Pi graph prompt"
+[[ -f "$installed_root/kimi/skills/graphify/SKILL.md" ]] || \
+  fail "npm tarball omitted the Kimi graph Skill"
 [[ -x "$installed_root/scripts/sync-pi-assets.sh" ]] || \
   fail "npm tarball omitted the Pi sync command"
+[[ -x "$installed_root/scripts/sync-kimi-assets.sh" ]] || \
+  fail "npm tarball omitted the Kimi sync command"
 [[ -f "$installed_root/templates/start-pi.sh.template" ]] || \
   fail "npm tarball omitted the Pi launcher template"
 [[ -f "$installed_root/templates/start-kimi.sh.template" ]] || \
   fail "npm tarball omitted the Kimi launcher template"
+[[ -f "$installed_root/templates/start-qwen.sh.template" ]] || \
+  fail "npm tarball omitted the Qwen launcher template"
 [[ -f "$installed_root/schemas/note.schema.json" ]] || \
   fail "npm tarball omitted the note schema"
 [[ -f "$installed_root/schemas/memory-node.schema.json" ]] || \

package/scripts/test-trajectory-hooks.sh

@@ -127,6 +127,8 @@ pi_live="$tmp/pi-live"
 render "$ROOT/pi/extensions/cairnkeep-trajectory.ts" "$tmp/expected-pi-capture.ts"
 cmp -s "$tmp/expected-pi-capture.ts" "$pi_live/extensions/cairnkeep-trajectory.ts" \
   || fail "installed Pi trajectory extension differs from rendered source"
+cmp -s "$ROOT/pi/prompts/graphify.md" "$pi_live/prompts/graphify.md" \
+  || fail "installed Pi graph prompt differs from source"
 [[ $(find "$pi_live" -type f -name 'cairnkeep-trajectory.ts' | wc -l) -eq 1 ]] \
   || fail "Pi trajectory extension is duplicated"
 
@@ -136,7 +138,9 @@ cmp -s "$tmp/expected-pi-capture.ts" "$pi_live/extensions/cairnkeep-trajectory.t
   || fail "Claude memory-capture hook registration is missing or duplicated"
 [[ $(grep -c 'plugins/memory-capture.ts' "$ROOT/scripts/sync-opencode-plugin-assets.sh") -eq 1 ]] \
   || fail "OpenCode memory-capture plugin asset is missing or duplicated"
-[[ $(grep -c 'extensions/cairnkeep-trajectory.ts' "$ROOT/scripts/sync-pi-assets.sh") -eq 1 ]] \
+[[ $(grep -c '^  "extensions/cairnkeep-trajectory.ts"' "$ROOT/scripts/sync-pi-assets.sh") -eq 1 ]] \
   || fail "Pi trajectory extension asset is missing or duplicated"
+[[ $(grep -c '^  "prompts/graphify.md"' "$ROOT/scripts/sync-pi-assets.sh") -eq 1 ]] \
+  || fail "Pi graph prompt asset is missing or duplicated"
 
 echo "PASS: Claude/OpenCode/Pi trajectory hooks and flag-off regression"