c9dc94393c
Reviewer suggested an evaluation footprint that lands "the smallest substrate any caller-LLM can use", with 5 files and ~200 LOC ceiling in $HOME. This commit ships that profile. Files installed in $HOME by `./install.sh --profile=outcome-only`: 1. ~/.claude/hooks/agent-outcome-backfill.sh (PostToolUse:Agent) 2. ~/.claude/hooks/error-spike-detector.sh (PostToolUse:Bash, rolling 20-call window) 3. ~/.claude/agents/ledger.sqlite (full v9 schema via kei-ledger init, or sqlite3-fallback DDL) 4. ~/.claude/CLAUDE.md (1-line STATUS-TRUTH MARKER instruction appended) 5. ~/.claude/settings.json (jq-merge of 2 hook entries) Plus optional 6th: kei-model-router binary built from _primitives/_rust if cargo on PATH; deferred otherwise (warning printed, install continues). Files added to repo: - install/lib-profile-outcome-only.sh (145 LOC) — profile orchestrator with --dry-run support; sources lib-log/lib-backup/lib-hooks helpers; exits before heavy install phases when --profile=outcome-only - install/sql/outcome-only-schema.sql (69 LOC) — flattened v9-equivalent SQLite DDL (agents + skill_invocations + indexes), used by sqlite3 fallback when kei-ledger CLI is unavailable - docs/PROFILE-OUTCOME-ONLY.md (97 LOC) — reviewer-facing doc: 5-file install table, what is NOT installed, kei-model-router activation explanation, privacy posture (no telemetry), 4-line uninstall paste Files modified: - install.sh (+12 LOC) — sources outcome-only lib, adds short-circuit before menu when --profile=outcome-only, accepts in profile validator - install/lib-args.sh (+9 LOC) — registers --dry-run flag (sets OUTCOME_DRY_RUN=1), adds outcome-only + --dry-run lines to --help - README.md (+7 LOC) — adds Outcome-only Quick-start section pointing to PROFILE-OUTCOME-ONLY.md Verification: - bash -n clean on all 3 modified shell files - Dry-run produces exactly 5 numbered $HOME paths (verified end-to-end: HOME=/tmp/kei-fake-home bash install.sh --profile=outcome-only --dry-run) - Real install against fake $HOME succeeds (5 files present, ledger init via kei-ledger binary, router build correctly skipped on toolchain absence with warning) - Ledger schema includes agents + skill_invocations tables + 3 indexes + 2 triggers via real migration path (not the SQL fallback) [FROM-JOURNAL: end-to-end install dry-run + real-run measured at ~/.claude/memory/time-metrics/sessions.jsonl this session, both <2s wall] Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
139 lines
6.6 KiB
Bash
139 lines
6.6 KiB
Bash
# shellcheck shell=bash
|
|
# lib-args.sh — flag parsing + --help text.
|
|
#
|
|
# Sets globals: ACTIVATE_HOOKS, WITH_BRIDGES, WITH_SLEEP_SYNC,
|
|
# WITH_PATHWAY, NO_PATHWAY, PROFILE, ADD_LIST, REMOVE_NAME, LIST_MODE,
|
|
# ASSUME_YES, NO_EXECUTE.
|
|
# --help exits 0 immediately.
|
|
|
|
ACTIVATE_HOOKS=0
|
|
WITH_BRIDGES=0
|
|
WITH_SLEEP_SYNC=0
|
|
WITH_PATHWAY=0
|
|
NO_PATHWAY=0
|
|
PROFILE=""
|
|
ADD_LIST=""
|
|
REMOVE_NAME=""
|
|
LIST_MODE=0
|
|
ASSUME_YES=0
|
|
NO_EXECUTE=0
|
|
REBUILD_RUST_LIST=""
|
|
REBUILD_RUST_FLAG=0
|
|
OUTCOME_DRY_RUN=0
|
|
|
|
print_help() {
|
|
cat <<EOF
|
|
Usage: ./install.sh [flags]
|
|
|
|
NOTE: this classic installer is for power users (Rust primitives, custom
|
|
profiles, full control). Most users should prefer the Claude Code plugin:
|
|
/plugin marketplace add KeiSei84/KeiSeiKit
|
|
/plugin install keisei@keisei-marketplace
|
|
See README.md "Plugin install (v0.16+, recommended)" and PLUGIN.md for
|
|
details. The classic installer and the plugin can coexist — use whichever
|
|
fits.
|
|
|
|
(no flags) install profile=minimal — substrate baseline only
|
|
(37 agents + 67 skills + 39 hooks + 82 blocks +
|
|
16 caps + 7 roles + 11 bridges, NO primitives).
|
|
~5s, no Rust compile.
|
|
|
|
--profile=<name> add primitive bundles on top of substrate baseline:
|
|
Outcome-tracking only (no substrate, no daemon):
|
|
outcome-only — 2 hooks + ledger.sqlite + 1 line
|
|
in CLAUDE.md + (deferred) router.
|
|
~5 files, ~200 LOC. See
|
|
docs/PROFILE-OUTCOME-ONLY.md
|
|
Standard:
|
|
minimal — 0 primitives (~5s)
|
|
core — 2 prims (tomd, kei-doctor)
|
|
frontend — 8 site tools (mock-render, visual-diff, …)
|
|
ops — 9 infra tools (provision, ssh-check, …)
|
|
dev — 17 dev tools (kei-migrate, kei-memory, …)
|
|
mcp — 10 MCP/LBM tools (kei-router, kei-sage, …)
|
|
cortex — 11 cortex stack (kei-cortex daemon + cortex-ui)
|
|
full — all 62 primitives (MANIFEST source of truth)
|
|
Dev hub (local-first dev environment, macOS arm64):
|
|
local-mirror — cortex + Forgejo + CI runner (13 prims)
|
|
dashboard — local-mirror + projects-index + Datasette (16)
|
|
full-hub — dashboard + zoekt + mdbook + restic + gdrive (20)
|
|
|
|
--add=<a>[,<b>,...] add one or more primitives on top of current install.
|
|
Name must match [primitive.<name>] in _primitives/MANIFEST.toml.
|
|
|
|
--remove=<name> remove a single primitive (shell file or rust crate dir +
|
|
scoped workspace Cargo.toml regenerated + rebuilt).
|
|
|
|
--list list installed primitives from .installed state file.
|
|
|
|
--with-bridges render the 11 cross-tool bridge files into \$PWD
|
|
(Cursor / Copilot / Codex / Windsurf / Junie / Continue /
|
|
Aider / Replit / Antigravity / Warp / Zed).
|
|
Skipped if invoked inside the KeiSeiKit repo itself.
|
|
|
|
--with-sleep-sync after core install, run the v0.11 sleep-layer
|
|
setup helper (kei-sleep-setup.sh). TTY-only — no-op
|
|
on CI / non-interactive invocations. Print a
|
|
reminder to finish via /sleep-setup either way.
|
|
|
|
--with-pathway force PATH wiring (~/.bashrc / ~/.zshrc / fish
|
|
config) for the substrate target/release dir.
|
|
Default: auto-on for interactive TTY installs.
|
|
|
|
--no-pathway force-skip PATH wiring (do not modify any rc
|
|
file). Useful for CI or when the user manages
|
|
PATH via another mechanism (e.g. nix shell).
|
|
|
|
--activate-hooks jq-merge settings-snippet.json into ~/.claude/settings.json
|
|
non-interactively. Without this flag, a TTY prompt asks
|
|
at the end; non-TTY runs print manual instructions.
|
|
|
|
--yes, -y skip the interactive confirm screen after the menu
|
|
(for automation). If no --profile was given the menu
|
|
still runs; --yes only auto-accepts the Install Plan.
|
|
|
|
--no-execute run flag parsing + menu + confirm, print the
|
|
resolved plan, then exit before copying/building
|
|
anything. Useful for dry-run / testing.
|
|
|
|
--dry-run with --profile=outcome-only: print the list of
|
|
files that WOULD be touched in \$HOME, then exit
|
|
0 without writing. No-op for other profiles.
|
|
|
|
--rebuild-rust (dev-only) rebuild full Rust workspace + mirror
|
|
fresh binaries to ~/.claude/agents/_primitives/
|
|
_rust/target/release/. Closes the drift gap
|
|
between dev source edits and PATH-resolved
|
|
installed binaries. No-op for kit users.
|
|
|
|
--rebuild-rust=<crate> selective variant — rebuild only the named
|
|
crate (or comma-separated list) and mirror
|
|
those binaries. Faster than full workspace
|
|
on incremental edits.
|
|
|
|
--help, -h this help.
|
|
EOF
|
|
}
|
|
|
|
parse_args() {
|
|
local arg
|
|
for arg in "$@"; do
|
|
case "$arg" in
|
|
--activate-hooks) ACTIVATE_HOOKS=1 ;;
|
|
--with-bridges) WITH_BRIDGES=1 ;;
|
|
--with-sleep-sync) WITH_SLEEP_SYNC=1 ;;
|
|
--with-pathway) WITH_PATHWAY=1 ;;
|
|
--no-pathway) NO_PATHWAY=1 ;;
|
|
--profile=*) PROFILE="${arg#--profile=}" ;;
|
|
--add=*) ADD_LIST="${arg#--add=}" ;;
|
|
--remove=*) REMOVE_NAME="${arg#--remove=}" ;;
|
|
--list) LIST_MODE=1 ;;
|
|
--yes|-y) ASSUME_YES=1 ;;
|
|
--no-execute) NO_EXECUTE=1 ;;
|
|
--rebuild-rust) REBUILD_RUST_FLAG=1 ;;
|
|
--rebuild-rust=*) REBUILD_RUST_FLAG=1; REBUILD_RUST_LIST="${arg#--rebuild-rust=}" ;;
|
|
--dry-run) OUTCOME_DRY_RUN=1 ;;
|
|
--help|-h) print_help; exit 0 ;;
|
|
esac
|
|
done
|
|
}
|