Some checks are pending
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / preflight (push) Waiting to run
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / vps-smoke (push) Waiting to run
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:frustration-matrix,kei-frustration-loop,kei-skill-importer,kei-projects-index,kei-projects-watcher,kei-gdrive-import,kei-leak-matrix,kei-skills,kei-gateway,kei-cron-scheduler,kei-export-trajectories,kei-backend-daytona,kei-d… (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:kei-compute-baremetal,kei-compute-vultr,kei-compute-linode,kei-compute-digitalocean,kei-svc-systemd,kei-llm-bridge-mlx name:hosted-sleep-compute]) (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:kei-diff,kei-scheduler,kei-watch,kei-prune,kei-discover,kei-brain-view,kei-hibernate,kei-ledger-sign,kei-fork name:wave13-15]) (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:kei-git-gitea,kei-git-forgejo,kei-git-gitlab,kei-git-bitbucket,kei-memory-sled,kei-memory-redis,kei-memory-postgres,kei-memory-sqlite,kei-auth-google,kei-auth-apple,kei-auth-magiclink,kei-auth-webauthn,kei-notify-slack,kei-n… (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:kei-ledger,kei-migrate,kei-changelog,kei-memory,kei-store,kei-conflict-scan,kei-refactor-engine,kei-graph-check,kei-shared,kei-dna-index,kei-pet name:core]) (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:kei-machine-probe,kei-llm-ollama,kei-llm-llamacpp,kei-llm-mlx,kei-llm-router,kei-model name:llm-stack]) (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:kei-router,kei-sage,kei-task,kei-chat-store,kei-crossdomain,kei-search-core,kei-content-store,kei-social-store,kei-curator,kei-auth,kei-artifact name:mcp-lbm]) (push) Blocked by required conditions
CI (Forgejo Actions — self-hosted runner on Mac, host mode) / rust-primitives (map[crates:keisei,kei-forge,kei-runtime,kei-runtime-core,kei-atom-discovery,kei-agent-runtime,kei-capability,kei-provision,kei-entity-store,kei-pipe,kei-cache,kei-spawn,kei-replay name:atom-substrate]) (push) Blocked by required conditions
Closes the "hooks only fire on Claude" gap. Phase C extends KeiSeiKit safety
enforcement (no-github-push, safety-guard, destructive-guard, citation-verify,
numeric-claims-guard) to any MCP-capable LLM CLI through a 3-tier honesty model.
## 3-tier model
TIER 1 (full native): claude (existing), grok (port hooks to grok settings.json)
TIER 2 (MCP-wrapped): copilot (--excluded-tools=shell + force kei_bash via MCP)
TIER 3 (advisory): agy + kimi (cannot disable native shell; prompt-level only)
## Design (Constructor Pattern)
1. hooks/_lib/policy-chain.toml — SSoT: which hooks gate which tool (bash/edit/write)
2. _primitives/_rust/kei-mcp/src/handlers/safe_tools.rs — new module, 3 built-in
MCP tools that synthesize Claude PreToolUse JSON, run hook chain, abort on
exit-2, exec on all-pass. Same input contract → hooks reused as-is, no rewrite.
3. tools.rs short-circuit: kei_bash/kei_edit/kei_write dispatched before atom layer
4. 6 wire scripts: orchestrator + one per CLI (Constructor Pattern, no mixin)
5. bin/kei mcp-wire arm
6. docs/encyclopedia/cross-cli-policy.md — honest 3-tier matrix + verification
## Double-enforcement guard
If kei-mcp invoked from a process with $CLAUDECODE=1 or $GROKCODE=1, the chain
SKIPS — native hooks already fired. Wire scripts set these env vars in the
MCP server registration for claude/grok respectively. On copilot/agy/kimi the
env is unset → chain runs.
## Smoke (verified live)
Block: kei_bash{command: forbidden-push-pattern}
→ JSON-RPC error -32603 with full "BLOCK — RULE 0.1 NO GITHUB PUSH" stderr ✓
Pass: kei_bash{command: "echo HELLO-FROM-KEI-BASH"}
→ result.content[0].text = "HELLO-FROM-KEI-BASH" ✓
tools/list: 4 built-ins present (spawn_agent + kei_bash + kei_edit + kei_write) ✓
## Tests
kei-mcp: 3/3 (tools_list assertions updated for atoms+4 built-ins).
Build clean with toml = "0.8" dep added.
## Out of scope (deferred)
- Codex CLI wiring (not installed locally)
- ACP middleware proxy (transport, not middleware — ruled out at research)
- Container/firejail sandboxing for agy/kimi (heavy; documented limit instead)
- Native Rust PatternGate migration (optimization, separate phase)
106 lines
3 KiB
Bash
Executable file
106 lines
3 KiB
Bash
Executable file
#!/usr/bin/env bash
|
|
# kei-mcp-wire — orchestrator for cross-CLI MCP enforcement setup.
|
|
#
|
|
# Phase C cube — wires kei-mcp (with kei_bash/kei_edit/kei_write tools) into
|
|
# each installed LLM CLI's MCP config, plus per-CLI tool-restriction config
|
|
# where the CLI supports it.
|
|
#
|
|
# Usage:
|
|
# kei mcp-wire # detect installed CLIs + wire each
|
|
# kei mcp-wire <cli> # wire one: claude/grok/copilot/agy/kimi
|
|
# kei mcp-wire --check # diff: current vs target (no writes)
|
|
# kei mcp-wire --dry-run # preview changes without applying
|
|
# kei mcp-wire --list # show enforcement tier per CLI
|
|
#
|
|
# Enforcement tiers (3-tier honesty model):
|
|
# TIER 1 — full native: claude (existing hooks), grok (ports our hooks
|
|
# to ~/.grok/settings.json — same JSON shape)
|
|
# TIER 2 — MCP-wrapped: copilot (disable native shell + force kei_bash)
|
|
# TIER 3 — advisory: agy + kimi (cannot disable native shell;
|
|
# MCP available but enforcement is prompt-only)
|
|
|
|
set -eu
|
|
|
|
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
|
DRY_RUN=0
|
|
CHECK=0
|
|
LIST=0
|
|
TARGET=""
|
|
|
|
usage() { sed -n '2,17p' "$0" | sed 's|^# \{0,1\}||'; }
|
|
|
|
for arg in "$@"; do
|
|
case "$arg" in
|
|
--dry-run) DRY_RUN=1 ;;
|
|
--check) CHECK=1 ;;
|
|
--list) LIST=1 ;;
|
|
--help|-h) usage; exit 0 ;;
|
|
*) TARGET="$arg" ;;
|
|
esac
|
|
done
|
|
|
|
export KEI_WIRE_DRY_RUN="$DRY_RUN"
|
|
export KEI_WIRE_CHECK="$CHECK"
|
|
|
|
declare -A TIERS=(
|
|
[claude]="TIER 1: full native"
|
|
[grok]="TIER 1: full native (ports our hooks)"
|
|
[copilot]="TIER 2: MCP-wrapped (disable native shell)"
|
|
[agy]="TIER 3: advisory (no native-shell disable)"
|
|
[kimi]="TIER 3: advisory (confirmation model only)"
|
|
)
|
|
|
|
backend_bin() {
|
|
case "$1" in
|
|
claude) echo "claude" ;;
|
|
grok) echo "grok" ;;
|
|
agy|antigravity) echo "agy" ;;
|
|
copilot) echo "copilot" ;;
|
|
kimi) echo "kimi" ;;
|
|
*) return 1 ;;
|
|
esac
|
|
}
|
|
|
|
if [ "$LIST" = "1" ]; then
|
|
echo "Cross-CLI enforcement tiers:"
|
|
for cli in claude grok copilot agy kimi; do
|
|
bin=$(backend_bin "$cli")
|
|
if command -v "$bin" >/dev/null 2>&1; then
|
|
mark="✓"
|
|
else
|
|
mark="✗"
|
|
fi
|
|
printf " %s %-8s %s\n" "$mark" "$cli" "${TIERS[$cli]}"
|
|
done
|
|
exit 0
|
|
fi
|
|
|
|
wire_one() {
|
|
local cli="$1" wire_script="$SCRIPT_DIR/kei-mcp-wire-$cli.sh"
|
|
if [ ! -x "$wire_script" ]; then
|
|
echo "[kei-mcp-wire] no wire script for: $cli (expected $wire_script)" >&2
|
|
return 2
|
|
fi
|
|
local bin
|
|
bin=$(backend_bin "$cli") || { echo "unknown cli: $cli" >&2; return 2; }
|
|
if ! command -v "$bin" >/dev/null 2>&1; then
|
|
echo "[kei-mcp-wire] $cli not installed (skipping)"
|
|
return 0
|
|
fi
|
|
echo
|
|
echo "──── $cli (${TIERS[$cli]}) ────"
|
|
"$wire_script"
|
|
}
|
|
|
|
if [ -n "$TARGET" ]; then
|
|
wire_one "$TARGET"
|
|
exit $?
|
|
fi
|
|
|
|
# No target → wire all installed CLIs.
|
|
echo "kei-mcp-wire: detecting installed CLIs..."
|
|
for cli in claude grok copilot agy kimi; do
|
|
wire_one "$cli"
|
|
done
|
|
echo
|
|
echo "done. See \`kei mcp-wire --list\` for per-CLI enforcement tier."
|