@cairnkeep/cli 2.6.0 → 2.8.0

package/opencode/command/graphify.md

@@ -1,6 +1,6 @@
 ---
 description: "Build, rebuild, query, and inspect the project knowledge graph in .planning/graphs/"
-argument-hint: "[build [--force]|query <term>|status|diff]"
+argument-hint: "[build [--force]|query <term>|explain <symbol>|path <from> <to>|status|diff]"
 tools:
   read: true
   bash: true
@@ -9,7 +9,9 @@ tools:
 
 **STOP -- DO NOT READ THIS FILE. You are already reading it. This prompt was injected into your context by OpenCode's command system. Using the Read tool on this file wastes tokens. Begin executing Step 1 immediately.**
 
-**graphify CLI:** the `graphify` subcommand is exposed by `gsd-tools` (on PATH). Invoke as `gsd-tools graphify …` as documented in this command and in `docs/CLI-TOOLS.md`. Other GSD queries use `gsd-tools <subcmd>` where a handler exists.
+**graph workflow:** Cairnkeep owns this surface through `cairn graph`. The
+operator installs only the isolated `graphify` executable; do not invoke
+Graphify's harness installer.
 
 ## Output heading
 
@@ -17,32 +19,13 @@ Begin the final user-facing response with `GRAPHIFY`. Do not emit a standalone
 banner before owner I/O: in headless OpenCode, content-only output can end the
 turn before the command reaches its tools.
 
-## Step 1 -- Config Gate
+## Step 1 -- Capability ownership
 
-**First action:** invoke the Read tool for `.planning/config.json`; do not emit
-text before this tool call.
-
-Check if graphify is enabled by reading `.planning/config.json` directly using the Read tool.
-
-**DO NOT use the gsd-tools config get-value command** -- it hard-exits on missing keys.
-
-1. Read `.planning/config.json` using the Read tool
-2. If the file does not exist: display the disabled message below and **STOP**
-3. Parse the JSON content. Check if `config.graphify && config.graphify.enabled === true`
-4. If `graphify.enabled` is NOT explicitly `true`: display the disabled message below and **STOP**
-5. If `graphify.enabled` is `true`: proceed to Step 2
-
-**Disabled message:**
-
-```
-GRAPHIFY
-
-Knowledge graph is disabled. To activate:
-
-  gsd-tools config-set graphify.enabled true
-
-Then run /graphify build to create the initial graph.
-```
+Do not implement a separate configuration gate in the prompt. Every
+`cairn graph` operation enforces the typed `graph` capability and its legacy
+`graphify.enabled` compatibility default before Graphify or graph-file I/O.
+Proceed directly to Step 2; if the owner reports a disabled capability, display
+its fixed remediation message and **STOP**.
 
 ---
 
@@ -62,6 +45,8 @@ empty or unknown argument. Apply the same exact matching rule to every row:
 |----------|--------|
 | `build` or `build --force` | Run inline build (Step 3) |
 | `query <term>` | Run inline query (Step 2a) |
+| `explain <symbol>` | Explain one exact symbol (Step 2d) |
+| `path <from> <to>` | Find the shortest path between two exact symbols (Step 2e) |
 | `status` | Run inline status check (Step 2b) |
 | `diff` | Run inline diff check (Step 2c) |
 | No argument or unknown | Show usage message |
@@ -76,6 +61,8 @@ Usage: /graphify <mode>
 Modes:
   build [--force] Build or rebuild the knowledge graph
   query <term>    Search the graph for a term
+  explain <symbol> Explain one exact symbol and its relationships
+  path <from> <to> Find the shortest path between two exact symbols
   status          Show graph freshness and statistics
   diff            Show changes since last build
 ```
@@ -86,29 +73,42 @@ Modes:
 the result and do not continue until the tool returns:
 
 ```bash
-gsd-tools graphify query <term>
+cairn graph query <term>
 ```
 
-Parse the JSON output and display results:
-- If the output contains `"disabled": true`, display the disabled message from Step 1 and **STOP**
-- If the output contains `"error"` field, display the error message and **STOP**
-- If no nodes found, display: `No graph matches for '<term>'. Try /graphify build to create or rebuild the graph.`
-- Otherwise, display matched nodes grouped by type, with edge relationships and confidence tiers (EXTRACTED/INFERRED/AMBIGUOUS)
+Pass the parsed term as exactly one argument and display the result verbatim.
+On failure, display the error without retrying or changing configuration.
 
 **STOP** after displaying results. Do not spawn an agent.
 
+### Step 2d -- Explain
+
+**Invoke the shell tool** with `cairn graph explain <symbol>`, passing the
+parsed symbol as exactly one argument. Display Graphify's explanation verbatim.
+On failure, display the error and suggest `/graphify build` only when the
+published graph is missing.
+
+**STOP** after displaying the result. Do not spawn an agent.
+
+### Step 2e -- Path
+
+**Invoke the shell tool** with `cairn graph path <from> <to>`, passing each
+parsed symbol as exactly one argument. Display Graphify's path result verbatim.
+On failure, display the error and suggest `/graphify build` only when the
+published graph is missing.
+
+**STOP** after displaying the result. Do not spawn an agent.
+
 ### Step 2b -- Status
 
 **Invoke the shell tool** with this exact command; do not print the command as
 the result and do not continue until the tool returns:
 
 ```bash
-gsd-tools graphify status
+cairn graph status
 ```
 
-Parse the JSON output and display:
-- If `exists: false`, display the message field
-- Otherwise show last build time, node/edge/hyperedge counts, and STALE or FRESH indicator
+Display the local node/edge counts and freshness result verbatim.
 
 **STOP** after displaying status. Do not spawn an agent.
 
@@ -118,14 +118,11 @@ Parse the JSON output and display:
 the result and do not continue until the tool returns:
 
 ```bash
-gsd-tools graphify diff
+cairn graph diff
 ```
 
-Parse the JSON output and display:
-- If `no_baseline: true`, display the message field
-- Otherwise show node and edge change counts (added/removed/changed)
-
-If no snapshot exists, suggest running `build` twice (first to create, second to generate a diff baseline).
+Display the node and edge change counts verbatim. If no snapshot exists,
+suggest rebuilding after the next code change.
 
 **STOP** after displaying diff. Do not spawn an agent.
 
@@ -137,20 +134,14 @@ If no snapshot exists, suggest running `build` twice (first to create, second to
 the result and do not continue until the tool returns:
 
 ```bash
-gsd-tools graphify build [--force]
+cairn graph build [--force]
 ```
 
-Parse the JSON output and display:
-- If the output contains `"disabled": true`, display the disabled message from Step 1 and **STOP**
-- If the output contains an `"error"` field, display the error and the `stage` field when present, then **STOP**
-- Otherwise display the build summary using `status.last_build`, `status.node_count`, `status.edge_count`, `status.hyperedge_count`, whether the snapshot was saved, and whether a forced clean rebuild was used
-
-This command now performs the full pipeline directly:
-- runs `graphify update .` with legacy fallback to `graphify . --update`
-- when `--force` is present, clears `graphify-out/`, published graph artifacts, and `.planning/graphs/.last-build-snapshot.json` first
-- validates `graphify-out/graph.json`
-- copies `graph.json`, `graph.html`, and `GRAPH_REPORT.md` into `.planning/graphs/`
-- writes `.planning/graphs/.last-build-snapshot.json`
+Display the build summary verbatim. This managed path runs Graphify's local
+code-only `update`, strips provider credentials from its subprocess
+environment, validates the resulting graph, atomically publishes available
+artifacts into `.planning/graphs/`, and snapshots the previous graph for diff.
+`--force` permits a rebuilt graph with fewer nodes after code deletion.
 
 **STOP** after displaying the build result. Do not spawn an agent.
 
@@ -158,7 +149,6 @@ This command now performs the full pipeline directly:
 
 ## Anti-Patterns
 
-1. DO NOT spawn an agent for graphify operations -- build/query/status/diff are handled directly
+1. DO NOT spawn an agent for graphify operations -- build/query/explain/path/status/diff are handled directly
 2. DO NOT modify graph files directly outside the graphify CLI path
-3. DO NOT skip the config gate check
-4. DO NOT use gsd-tools config get-value for the config gate -- it exits on missing keys
+3. DO NOT duplicate capability parsing in the prompt -- `cairn graph` owns it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cairnkeep/cli",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "A durable, harness-agnostic memory + context layer for coding agents and MCP clients.",
   "license": "Apache-2.0",
   "type": "module",
@@ -18,6 +18,7 @@
     "claude/",
     "opencode/",
     "pi/",
+    "kimi/",
     "examples/anythingllm/",
     "examples/overlay-distribution/",
     "examples/eval/",

package/pi/prompts/graphify.md

@@ -0,0 +1,32 @@
+---
+description: Build, query, and inspect the local project graph through Cairnkeep
+argument-hint: "[build [--force]|query <term>|status|diff|explain <symbol>|path <from> <to>]"
+---
+
+<!-- managed-by:cairnkeep -->
+# Cairnkeep graph
+
+Handle this request through Cairnkeep's public graph owner. The invocation
+arguments are:
+
+```text
+$ARGUMENTS
+```
+
+Accept exactly one of these forms:
+
+- `build`
+- `build --force`
+- `query <term>`
+- `status`
+- `diff`
+- `explain <symbol>`
+- `path <from> <to>`
+
+Invoke the shell tool exactly once with the corresponding `cairn graph ...`
+command. Pass each term or symbol as one safely quoted argument. Return the
+command output verbatim and stop.
+
+If the arguments do not match a supported form, show the supported forms and
+stop without invoking a tool. Do not call the Graphify executable, edit graph
+artifacts, spawn another agent, or implement graph logic in this prompt.

package/schemas/eval-report.schema.json

@@ -9,7 +9,7 @@
     "schema_version": { "const": 1 },
     "experiment_id": { "$ref": "#/$defs/identifier" },
     "status": { "enum": ["partial", "final"] },
-    "experiment_kind": { "enum": ["two_pass", "ablation"] },
+    "experiment_kind": { "enum": ["two_pass", "ablation", "skill_candidate"] },
     "task_set_digest": { "$ref": "#/$defs/digest" },
     "adapter_config_digest": { "$ref": "#/$defs/digest" },
     "source_revision": { "$ref": "#/$defs/commit" },

package/schemas/skill-adapter.schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/cairnkeep/cairnkeep/main/schemas/skill-adapter.schema.json",
+  "title": "Cairnkeep skill proposal adapter configuration v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "id", "command", "limits"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "id": { "$ref": "#/$defs/identifier" },
+    "command": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["program", "args"],
+      "properties": {
+        "program": { "type": "string", "minLength": 1, "maxLength": 4096 },
+        "args": { "type": "array", "maxItems": 128, "items": { "type": "string", "maxLength": 16384 } }
+      }
+    },
+    "environment_allowlist": {
+      "type": "array",
+      "maxItems": 64,
+      "default": [],
+      "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]{0,127}$" }
+    },
+    "limits": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["elapsed_ms", "stdout_bytes"],
+      "properties": {
+        "elapsed_ms": { "type": "integer", "minimum": 1, "maximum": 3600000 },
+        "stdout_bytes": { "type": "integer", "minimum": 1, "maximum": 4194304 }
+      }
+    }
+  },
+  "$defs": {
+    "identifier": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[a-z0-9][a-z0-9._-]*$" }
+  }
+}

package/schemas/skill-proposal-protocol.schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/cairnkeep/cairnkeep/main/schemas/skill-proposal-protocol.schema.json",
+  "title": "Cairnkeep skill proposal adapter protocol v1",
+  "oneOf": [{ "$ref": "#/$defs/request" }, { "$ref": "#/$defs/response" }],
+  "$defs": {
+    "identifier": { "type": "string", "minLength": 1, "maxLength": 128, "pattern": "^[a-z0-9][a-z0-9._-]*$" },
+    "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "timestamp": { "type": "string", "format": "date-time" },
+    "relativePath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024,
+      "pattern": "^(?!/)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))(?!.*\\\\)(?!.*//)(?!.*[\\u0000-\\u001f\\u007f])(?:.*\\/)?SKILL\\.md$"
+    },
+    "occurrence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["session_id", "session_digest", "ended_at", "outcome", "evidence"],
+      "properties": {
+        "session_id": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "session_digest": { "$ref": "#/$defs/digest" },
+        "ended_at": { "$ref": "#/$defs/timestamp" },
+        "outcome": { "enum": ["failure", "resolution", "abandonment"] },
+        "tool_name": { "type": "string", "minLength": 1, "maxLength": 256 },
+        "evidence": { "type": "string", "maxLength": 4096 }
+      }
+    },
+    "candidate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema_version", "id", "project_id", "status", "note_id", "source_digest", "title", "description", "failure_family", "failure_count", "resolution_count", "occurrences", "lessons", "caveats", "created_at", "reviewed_at"],
+      "properties": {
+        "schema_version": { "const": 1 },
+        "id": { "$ref": "#/$defs/identifier" },
+        "project_id": { "$ref": "#/$defs/identifier" },
+        "status": { "const": "approved" },
+        "note_id": { "$ref": "#/$defs/identifier" },
+        "source_digest": { "$ref": "#/$defs/digest" },
+        "title": { "type": "string", "minLength": 1, "maxLength": 512 },
+        "description": { "type": "string", "maxLength": 4096 },
+        "failure_family": { "$ref": "#/$defs/identifier" },
+        "failure_count": { "type": "integer", "minimum": 2, "maximum": 1024 },
+        "resolution_count": { "type": "integer", "minimum": 1, "maximum": 1024 },
+        "occurrences": { "type": "array", "minItems": 2, "maxItems": 64, "items": { "$ref": "#/$defs/occurrence" } },
+        "lessons": { "type": "array", "maxItems": 16, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } },
+        "caveats": { "type": "array", "maxItems": 16, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } },
+        "created_at": { "$ref": "#/$defs/timestamp" },
+        "reviewed_at": { "$ref": "#/$defs/timestamp" }
+      }
+    },
+    "edit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["operation", "anchor", "content", "rationale"],
+      "properties": {
+        "operation": { "enum": ["add", "replace", "delete"] },
+        "anchor": { "oneOf": [{ "type": "string", "minLength": 1, "maxLength": 16384 }, { "type": "null" }] },
+        "content": { "type": "string", "maxLength": 65536 },
+        "rationale": { "type": "string", "minLength": 1, "maxLength": 2048 }
+      }
+    },
+    "request": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema_version", "operation", "candidate", "candidate_digest", "target", "edit_budget"],
+      "properties": {
+        "schema_version": { "const": 1 },
+        "operation": { "const": "propose" },
+        "candidate": { "$ref": "#/$defs/candidate" },
+        "candidate_digest": { "$ref": "#/$defs/digest" },
+        "target": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "baseline_digest", "content"],
+          "properties": {
+            "path": { "$ref": "#/$defs/relativePath" },
+            "baseline_digest": { "$ref": "#/$defs/digest" },
+            "content": { "type": "string", "maxLength": 262144 }
+          }
+        },
+        "edit_budget": { "type": "integer", "minimum": 1, "maximum": 16 }
+      }
+    },
+    "response": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema_version", "status"],
+      "properties": {
+        "schema_version": { "const": 1 },
+        "status": { "enum": ["completed", "adapter_error"] },
+        "error_code": { "$ref": "#/$defs/identifier" },
+        "edits": { "type": "array", "maxItems": 16, "default": [], "items": { "$ref": "#/$defs/edit" } }
+      }
+    }
+  }
+}

package/scripts/bootstrap.sh

@@ -104,7 +104,8 @@ echo "Next steps (full guide: docs/operating.md):"
 echo "  1. cp .ai/env.example .ai/.env  and edit"
 echo "  2. Register the memory server: claude mcp add cairn-memory -s user -- cairn memory-server"
 echo "  3. Install the operating layer (commands/agents/hooks): cairn sync --apply"
-echo "     For Pi trajectory capture, also run: cairn sync-pi --apply"
+echo "     For Pi trajectory + /graphify, also run: cairn sync-pi --apply"
+echo "     For Kimi /graphify, also run: cairn sync-kimi --apply"
 echo "     From a source clone, use bin/cairn in place of cairn."
 echo "  4. Launch: $target/.ai/start-claude.sh"
 echo "     Kimi memory-client launch: $target/.ai/start-kimi.sh"

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 skill 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,11 @@ _cairn_complete() {
         *) COMPREPLY=( $(compgen -W "validate run ablate report prune delete" -- "$current") ) ;;
       esac
       ;;
+    skill) COMPREPLY=( $(compgen -W "harvest list show review propose evaluate apply rollback --project --minimum-occurrences --kind --id --candidate --approve --target --adapter --edit-budget --proposal --exploration-task-set --confirmation-task-set --output --repetitions --seed --minimum-improvement --evaluation --application --confirm --yes --json" -- "$current") ) ;;
+    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 +83,16 @@ _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'
+    'skill:review and evaluate evidence-backed skill improvements'
+    '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 +108,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 +141,23 @@ _cairn() {
         *) _values 'eval command' validate run ablate report prune delete ;;
       esac
       ;;
+    skill)
+      case $words[3] in
+        harvest) _arguments '--project[project root]:directory:_files -/' '--minimum-occurrences[minimum recurring failures]:count:' '--json[emit JSON]' ;;
+        list) _arguments '--project[project root]:directory:_files -/' '--kind[artifact kind]:kind:(candidate proposal evaluation application)' '--json[emit JSON]' ;;
+        show) _arguments '--project[project root]:directory:_files -/' '--kind[artifact kind]:kind:(candidate proposal evaluation application)' '--id[artifact ID]:artifact ID:' '--json[emit JSON]' ;;
+        review) _arguments '--project[project root]:directory:_files -/' '--candidate[candidate ID]:candidate ID:' '--approve[approve evidence]' '--json[emit JSON]' ;;
+        propose) _arguments '--project[project root]:directory:_files -/' '--candidate[candidate ID]:candidate ID:' '--target[existing SKILL.md]:file:_files' '--adapter[proposal adapter configuration]:file:_files' '--edit-budget[maximum edits]:count:' '--json[emit JSON]' ;;
+        evaluate) _arguments '--project[project root]:directory:_files -/' '--proposal[proposal ID]:proposal ID:' '--exploration-task-set[exploration task set]:file:_files' '--confirmation-task-set[confirmation task set]:file:_files' '--adapter[evaluation adapter configuration]:file:_files' '--output[report root]:directory:_files -/' '--repetitions[repetition count]:count:' '--seed[deterministic seed]:seed:' '--minimum-improvement[distinct improved tasks]:count:' '--yes[confirm execution]' '--json[emit JSON]' ;;
+        apply) _arguments '--project[project root]:directory:_files -/' '--proposal[proposal ID]:proposal ID:' '--evaluation[evaluation ID]:evaluation ID:' '--confirm[exact proposal digest]:digest:' '--json[emit JSON]' ;;
+        rollback) _arguments '--project[project root]:directory:_files -/' '--application[application ID]:application ID:' '--confirm[confirm rollback]' '--json[emit JSON]' ;;
+        *) _values 'skill command' harvest list show review propose evaluate apply rollback ;;
+      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 +168,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 skill 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 skill 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 +206,34 @@ 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 skill; and not __fish_seen_subcommand_from harvest list show review propose evaluate apply rollback" -a "harvest list show review propose evaluate apply rollback"
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from harvest list show review propose evaluate apply rollback" -l project -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from harvest list show review propose evaluate apply rollback" -l json
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from harvest" -l minimum-occurrences -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from list show" -l kind -r -a "candidate proposal evaluation application"
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from show" -l id -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from review propose" -l candidate -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from review" -l approve
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from propose" -l target -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from propose evaluate" -l adapter -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from propose" -l edit-budget -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from evaluate apply" -l proposal -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from evaluate" -l exploration-task-set -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from evaluate" -l confirmation-task-set -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from evaluate" -l output -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from evaluate" -l repetitions -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from evaluate" -l seed -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from evaluate" -l minimum-improvement -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from evaluate" -l yes
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from apply" -l evaluation -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from apply" -l confirm -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from rollback" -l application -r
+complete -c cairn -n "__fish_seen_subcommand_from skill; and __fish_seen_subcommand_from rollback" -l confirm
+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"