@cairnkeep/cli 2.5.0 → 2.7.0

package/scripts/test-uninstall.sh

@@ -82,12 +82,14 @@ chmod +x "$SB/bin/"*
 export HOME="$SB/home" XDG_CONFIG_HOME="$SB/home/.config" PATH="$SB/bin:$PATH"
 LIVE="$SB/live"
 PI_LIVE="$SB/pi-live"
+KIMI_LIVE="$SB/kimi-live"
 
 echo "test-uninstall"
 
 # --- install the operating layer -------------------------------------------
 "$ROOT_DIR/scripts/sync-claude-assets.sh" --apply --live-root "$LIVE" >/dev/null 2>&1
 "$ROOT_DIR/scripts/sync-pi-assets.sh" --apply --live-root "$PI_LIVE" >/dev/null 2>&1
+"$ROOT_DIR/scripts/sync-kimi-assets.sh" --apply --live-root "$KIMI_LIVE" >/dev/null 2>&1
 md_installed=$(find "$LIVE" -type f -name '*.md' | wc -l | tr -d ' ')
 check "assets installed" "$([[ $md_installed -gt 0 ]] && echo yes || echo no)" "yes"
 check "managed hooks registered" "$(managed_hook_count "$LIVE/settings.json")" "5"
@@ -105,6 +107,8 @@ fs.writeFileSync(path, JSON.stringify(settings, null, 2) + "\n")
 NODE
 cp "$LIVE/settings.json" "$SB/settings.before.json"
 cp "$PI_LIVE/extensions/cairnkeep-trajectory.ts" "$SB/pi.before.ts"
+cp "$PI_LIVE/prompts/graphify.md" "$SB/pi-graph.before.md"
+cp "$KIMI_LIVE/skills/graphify/SKILL.md" "$SB/kimi-graph.before.md"
 mkdir -p "$SB/home/.cairnkeep/notes/projects/example/hindsight"
 printf 'durable note bytes\n' >"$SB/home/.cairnkeep/notes/projects/example/hindsight/failure.md"
 mkdir -p "$SB/home/.cairnkeep/notes/.cairnkeep/history/project-notes/knowledge/example" \
@@ -204,10 +208,12 @@ overlay_before=$(tree_hash "$PROJECT_DATA/.ai/capability-contract")
 project_before=$(tree_hash "$PROJECT_DATA")
 
 # --- dry-run must change nothing -------------------------------------------
-"$ROOT_DIR/scripts/uninstall.sh" --dry-run --live-root "$LIVE" --pi-live-root "$PI_LIVE" "$PROJECT_DATA" >/dev/null 2>&1
+"$ROOT_DIR/scripts/uninstall.sh" --dry-run --live-root "$LIVE" --pi-live-root "$PI_LIVE" --kimi-live-root "$KIMI_LIVE" "$PROJECT_DATA" >/dev/null 2>&1
 check "dry-run leaves assets" "$(find "$LIVE" -type f -name '*.md' | wc -l | tr -d ' ')" "$md_installed"
 check "dry-run makes no bundle" "$(ls -d "$SB/home/.cairnkeep-uninstall-"* 2>/dev/null | wc -l | tr -d ' ')" "0"
 check "dry-run leaves Pi extension" "$([[ -f "$PI_LIVE/extensions/cairnkeep-trajectory.ts" ]] && echo yes || echo no)" "yes"
+check "dry-run leaves Pi graph prompt" "$([[ -f "$PI_LIVE/prompts/graphify.md" ]] && echo yes || echo no)" "yes"
+check "dry-run leaves Kimi graph Skill" "$([[ -f "$KIMI_LIVE/skills/graphify/SKILL.md" ]] && echo yes || echo no)" "yes"
 check "dry-run leaves settings identical" "$(cmp -s "$SB/settings.before.json" "$LIVE/settings.json" && echo yes || echo no)" "yes"
 check "dry-run leaves artifact bytes exact" "$(cmp -s "$SB/artifacts.before.db" "$PROJECT_DATA/.agentfs/artifacts.db" && echo yes || echo no)" "yes"
 check "dry-run leaves eval tree, bytes, and modes exact" "$(tree_identity "$PROJECT_DATA/.agentfs/eval")" "$eval_before"
@@ -216,11 +222,13 @@ check "dry-run leaves adjacent project exact" "$(tree_identity "$ADJACENT_PROJEC
 check "dry-run leaves project state byte-identical" "$(tree_hash "$PROJECT_DATA")" "$project_before"
 
 # --- real uninstall ---------------------------------------------------------
-"$ROOT_DIR/scripts/uninstall.sh" --yes --live-root "$LIVE" --pi-live-root "$PI_LIVE" "$PROJECT_DATA" >/dev/null 2>&1
+"$ROOT_DIR/scripts/uninstall.sh" --yes --live-root "$LIVE" --pi-live-root "$PI_LIVE" --kimi-live-root "$KIMI_LIVE" "$PROJECT_DATA" >/dev/null 2>&1
 check "assets removed" "$(find "$LIVE" -type f -name '*.md' | wc -l | tr -d ' ')" "0"
 check "managed hooks de-registered" "$(managed_hook_count "$LIVE/settings.json")" "0"
 check "unrelated hook preserved" "$(grep -cF 'keep-me.sh' "$LIVE/settings.json" 2>/dev/null || true)" "1"
 check "Pi extension removed" "$([[ -e "$PI_LIVE/extensions/cairnkeep-trajectory.ts" ]] && echo no || echo yes)" "yes"
+check "Pi graph prompt removed" "$([[ -e "$PI_LIVE/prompts/graphify.md" ]] && echo no || echo yes)" "yes"
+check "Kimi graph Skill removed" "$([[ -e "$KIMI_LIVE/skills/graphify/SKILL.md" ]] && echo no || echo yes)" "yes"
 check "default uninstall keeps notes" "$(sha256sum "$SB/home/.cairnkeep/notes/projects/example/hindsight/failure.md" | cut -d' ' -f1)" "$note_before"
 check "default uninstall keeps all typed and journal bytes" "$(tree_hash "$SB/home/.cairnkeep")" "$store_before"
 check "default uninstall keeps artifact bytes exact" "$(cmp -s "$SB/artifacts.before.db" "$PROJECT_DATA/.agentfs/artifacts.db" && echo yes || echo no)" "yes"
@@ -243,6 +251,8 @@ bash "$BK/revert.sh" >/dev/null 2>&1
 check "assets restored" "$(find "$LIVE" -type f -name '*.md' | wc -l | tr -d ' ')" "$md_installed"
 check "settings.json identical" "$(cmp -s "$SB/settings.before.json" "$LIVE/settings.json" && echo yes || echo no)" "yes"
 check "Pi extension restored" "$(cmp -s "$SB/pi.before.ts" "$PI_LIVE/extensions/cairnkeep-trajectory.ts" && echo yes || echo no)" "yes"
+check "Pi graph prompt restored" "$(cmp -s "$SB/pi-graph.before.md" "$PI_LIVE/prompts/graphify.md" && echo yes || echo no)" "yes"
+check "Kimi graph Skill restored" "$(cmp -s "$SB/kimi-graph.before.md" "$KIMI_LIVE/skills/graphify/SKILL.md" && echo yes || echo no)" "yes"
 check "capability config bytes restored" "$(cmp -s "$SB/capabilities.before.json" "$PROJECT_DATA/.ai/capabilities.json" && echo yes || echo no)" "yes"
 check "capability overlay bytes restored" "$(tree_hash "$PROJECT_DATA/.ai/capability-contract")" "$overlay_before"
 check "capability hook registrations restored" "$(capability_hook_count "$CLAUDE_OVERLAY/settings.json")" "5"

package/scripts/uninstall.sh

@@ -22,6 +22,7 @@ TPL="$CAIRN_ROOT/templates"
 
 LIVE_ROOT="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
 PI_LIVE_ROOT="${PI_CODING_AGENT_DIR:-$HOME/.pi/agent}"
+KIMI_LIVE_ROOT="${KIMI_CODE_HOME:-$HOME/.kimi-code}"
 STORE_DIR="${CAIRN_AGENTFS_BASE_DIR:-$HOME/.cairnkeep}"
 STORE_DIR="${STORE_DIR/#\~/$HOME}"
 DRY_RUN=0
@@ -40,6 +41,7 @@ PROJECT_AI_FILES=(
   start-opencode.sh
   start-pi.sh
   start-kimi.sh
+  start-qwen.sh
   env.example
   trajectory-redaction.json
   capabilities.json
@@ -48,7 +50,7 @@ PROJECT_AI_FILES=(
 usage() {
   cat <<'EOF'
 Usage: uninstall.sh [--dry-run] [--yes] [--purge-memory] [--live-root PATH]
-                    [--pi-live-root PATH] [PROJECT ...]
+                    [--pi-live-root PATH] [--kimi-live-root PATH] [PROJECT ...]
 
 Reverse cairnkeep's install. Everything removed/edited is backed up into
 $HOME/.cairnkeep-uninstall-<ts>/ with a revert.sh before any change.
@@ -59,6 +61,7 @@ $HOME/.cairnkeep-uninstall-<ts>/ with a revert.sh before any change.
                    trajectories in each PROJECT. Backed up first; off by default.
   --live-root PATH Claude root to clean (default: $CLAUDE_CONFIG_DIR or ~/.claude).
   --pi-live-root PATH Pi agent root to clean (default: $PI_CODING_AGENT_DIR or ~/.pi/agent).
+  --kimi-live-root PATH Kimi Code root to clean (default: $KIMI_CODE_HOME or ~/.kimi-code).
   PROJECT ...      Also revert `cairn bootstrap` in these project dirs
                    (.ai/, .planning/, and any .git/info/exclude entries).
   -h, --help       Show this help.
@@ -72,6 +75,7 @@ while [[ $# -gt 0 ]]; do
     --purge-memory) PURGE_MEMORY=1; shift ;;
     --live-root) LIVE_ROOT="$2"; shift 2 ;;
     --pi-live-root) PI_LIVE_ROOT="$2"; shift 2 ;;
+    --kimi-live-root) KIMI_LIVE_ROOT="$2"; shift 2 ;;
     -h|--help) usage; exit 0 ;;
     -*) echo "Unknown option: $1" >&2; usage >&2; exit 2 ;;
     *) PROJECTS+=("$1"); shift ;;
@@ -136,6 +140,7 @@ echo "cairn uninstall"
 [[ $DRY_RUN -eq 1 ]] && echo "(dry run — nothing will change)"
 echo "  live root:    $LIVE_ROOT"
 echo "  Pi live root: $PI_LIVE_ROOT"
+echo "  Kimi root:    $KIMI_LIVE_ROOT"
 echo "  memory store: $STORE_DIR ($([[ $PURGE_MEMORY -eq 1 ]] && echo 'WILL be purged' || echo 'kept'))"
 [[ ${#PROJECTS[@]} -gt 0 ]] && echo "  projects:     ${PROJECTS[*]}"
 
@@ -149,10 +154,13 @@ fi
 echo "Operating layer (assets):"
 while IFS= read -r dst; do remove_path "$dst"; done < <(asset_dests)
 
-# The Pi adapter is one precisely owned extension; do not touch any other Pi
-# configuration or extensions in the same user root.
-echo "Pi extension:"
+# These are precisely owned adapter paths; do not touch neighboring harness
+# configuration in either user root.
+echo "Pi adapters:"
 remove_path "$PI_LIVE_ROOT/extensions/cairnkeep-trajectory.ts"
+remove_path "$PI_LIVE_ROOT/prompts/graphify.md"
+echo "Kimi adapter:"
+remove_path "$KIMI_LIVE_ROOT/skills/graphify/SKILL.md"
 
 # 2. settings.json hook registrations (back up whole file, then de-register).
 SETTINGS="$LIVE_ROOT/settings.json"

package/templates/graph-policy.md.template

@@ -31,7 +31,26 @@ This repository uses `.planning/graphs/` as an optional, local, machine-facing d
 ## Maintenance
 
 - Enable Graphify explicitly in `.planning/config.json`.
-- Install it locally with `uv pip install graphifyy && graphify install` before first use.
-- Use `/gsd-graphify build` to create or refresh the graph after meaningful topology or architecture-doc changes.
-- Use `/gsd-graphify status`, `/gsd-graphify query <term>`, and `/gsd-graphify diff` to inspect freshness and focused subgraphs.
-- Planner and query consumers should treat stale graphs as approximate context, not proof.
+- Install only the isolated Graphify CLI with `uv tool install graphifyy` before
+  first use (`pipx install graphifyy` is an equivalent fallback). Do not run
+  `graphify install`: Cairnkeep owns the installed commands and harness wiring,
+  so Graphify-owned skills, instructions, and hooks would duplicate them.
+- Claude Code and OpenCode receive the `/graphify` command with their operating
+  layers. Kimi Code receives the equivalent thin Skill after `cairn sync-kimi
+  --apply`, and Pi receives the equivalent thin prompt after `cairn sync-pi
+  --apply`. Both delegate exclusively to portable forms such as
+  `cairn graph build`, `cairn graph explain <symbol>`, and
+  `cairn graph path <from> <to>`.
+- Use `/graphify build` to create or refresh the graph after meaningful
+  code-topology changes. The managed build is local code-only extraction; it
+  does not send documents to a semantic extraction backend.
+- Use `/graphify status`, `/graphify query <term>`, and `/graphify diff` to
+  inspect freshness and focused subgraphs.
+- Use `/graphify explain <symbol>` for one exact function, class, or file, and
+  `/graphify path <from> <to>` for the shortest structural route between two
+  exact symbols.
+- Prefer exact symbol names or narrowly scoped terms when querying. Treat broad
+  prose-query results as discovery hints and verify them against canonical
+  source files.
+- Planner and query consumers should treat stale graphs as approximate context,
+  not proof.

package/templates/start-qwen.sh.template

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+# Cairnkeep launcher for Qwen Code. Loads this repo's private .ai/.env, runs
+# the optional pre/post seams, and launches Qwen from the project root. Qwen
+# reads user ~/.qwen/settings.json plus project .qwen/settings.json and
+# .mcp.json configuration.
+set -euo pipefail
+ROOT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)
+
+if [[ -f "$ROOT_DIR/.ai/.env" ]]; then
+  set -a
+  # shellcheck disable=SC1091
+  . "$ROOT_DIR/.ai/.env"
+  set +a
+fi
+if [[ -f "$ROOT_DIR/.ai/pre-launch.sh" ]]; then
+  # shellcheck disable=SC1091
+  . "$ROOT_DIR/.ai/pre-launch.sh"
+fi
+
+cd "$ROOT_DIR"
+
+if [[ -f "$ROOT_DIR/.ai/post-exit.sh" ]]; then
+  set +e
+  qwen "$@"
+  CAIRN_EXIT_STATUS=$?
+  set -e
+  export CAIRN_EXIT_STATUS
+  # shellcheck disable=SC1091
+  . "$ROOT_DIR/.ai/post-exit.sh" || true
+  exit "$CAIRN_EXIT_STATUS"
+fi
+exec qwen "$@"

package/docs/learning/PRODUCTION-PLAN.md

@@ -1,153 +0,0 @@
-# Learning Path Production Plan
-
-This plan grows the course in small publishable waves. Each wave produces a
-useful learner outcome on its own and leaves the public material in a coherent
-state.
-
-## Guiding principles
-
-- Demonstrate value before architecture.
-- Keep public lessons provider-neutral and free of private configuration.
-- Teach local storage first; remote storage must always be an explicit choice.
-- Write the canonical lesson before recording the video.
-- Use short videos that can be replaced independently after product changes.
-- Treat commands, expected output, and recovery instructions as tested product
-  surfaces rather than informal prose.
-- Keep default-off evidence and evaluation features out of the quickstart.
-- Never convert framework-fixture results into product-performance claims.
-
-## Wave 0 - Course foundation
-
-**Deliverables**
-
-- Stable lesson IDs L00-L17.
-- Quickstart, practitioner, evidence-and-evaluation, and operator tracks.
-- Lesson, video, and instructor templates.
-- Complete L00-L03 lesson and recording scripts.
-- Briefs and acceptance criteria for L04-L17.
-- A release-reviewed feature-to-lesson coverage map.
-
-**Exit gate**
-
-- A new learner can follow L00-L03 on a clean machine or stop safely after the
-  container trial.
-- Every command is current and no optional service is presented as mandatory.
-
-## Wave 1 - Pilot the quickstart
-
-1. Rehearse L00-L03 without recording and log confusing steps.
-2. Run the lessons on one clean Linux environment and one macOS environment.
-3. Record the four short videos from the supplied scripts.
-4. Ask two learners to complete the track without live assistance.
-5. Fix every repeated point of confusion before public promotion.
-
-**Artifacts:** four videos, four blog-ready lessons, one learner feedback form.
-
-**Exit gate:** both pilot learners reach a successful `/remember` and `/recall`
-round trip and can explain where their memory is stored.
-
-## Wave 2 - Daily practitioner value
-
-Expand L04-L06 and L13 in this order:
-
-1. L04 memory keys, scopes, search, history, and review.
-2. L05 wiki, alignment, session hooks, and derived-knowledge boundaries.
-3. L06 `/repo-review` and `/security-audit` against a deliberately vulnerable
-   toy repository.
-4. L13 structured evidence, redaction, deterministic hindsight, compaction,
-   artifact inspection, and cleanup against synthetic sessions.
-
-Use the public `cairnkeep-course-labs` repository created for this wave. Its
-synthetic Trail Ledger project, prominent safety boundary, eight tagged
-checkpoints, executable verification, offline evaluation route, and
-`solutions/review-target` branch are the shared demo source. Expand lesson prose
-and presenter scripts against those immutable starts rather than copying the
-demo into this repository.
-
-**Exit gate:** a learner can complete all labs from a fresh clone, and CI resets
-and verifies every starter state.
-
-## Wave 3 - Safe operation
-
-Expand L07-L08 and add a backup/restore lab:
-
-- Draw the local stdio and explicit remote HTTP data flows.
-- Demonstrate `cairn memory path`, export, import, and rollback.
-- Explain identity, project, and global routing without using real credentials.
-- Test the multiple-machine procedure with disposable stores before recording.
-
-**Exit gate:** the learner can predict the storage destination before starting
-a session and can restore a snapshot without losing the pre-existing store.
-
-## Wave 4 - Optional accelerators
-
-Expand L09-L10 as independent modules:
-
-- Optional document RAG, workspace selection, query, and sync.
-- token-miser/FastContext exploration, citations, caching, and failure modes.
-
-Each lesson begins and ends with the reminder that Cairnkeep works without the
-optional component.
-
-**Exit gate:** disabling either integration returns the learner to a healthy
-standalone Cairnkeep workflow.
-
-## Wave 5 - Evidence governance and measurement
-
-Expand L14-L17 in dependency order:
-
-1. L14 typed nodes, hard filters, logical note addresses, and import replay.
-2. L15 capability precedence, omission, restart boundaries, and value-free
-   callbacks.
-3. L16 offline two-pass fixtures, one-capability ablation, report reading,
-   missingness, uncertainty, retention, and claim boundaries.
-4. L17 current-versus-design-only ownership and approval boundaries.
-
-The first L16 lab must use only the committed deterministic fixture. A separate
-live-evaluation course artifact may be introduced only after its provenance and
-claim anchors pass the repository's runtime-evidence verifier.
-
-**Exit gate:** the learner can inspect effective state and retained evidence,
-execute the fixture safely, and state exactly why it does not prove a quality or
-efficiency gain.
-
-## Wave 6 - Operators and platform teams
-
-Expand L11-L12:
-
-- Rootless containers, persistent volumes, authenticated HTTP, and isolation.
-- Overlay manifests, private package delivery, bootstrap policy, fleet updates,
-  rollback, and release gates.
-
-**Exit gate:** the operator can explain every host mount, network boundary,
-credential source, storage destination, and rollback action.
-
-## Wave 7 - Publication and maintenance
-
-1. Publish a landing article linking to the four tracks.
-2. Publish videos as a playlist with lesson IDs in every title.
-3. Add release compatibility metadata to each completed lesson.
-4. Run a command-verification pass for every Cairnkeep minor release.
-5. Reconcile `cairn help`, the changelog, and the curriculum coverage map for
-   every minor release.
-6. Review learner feedback monthly during the pilot, then quarterly.
-
-## How we will work together
-
-For each lesson, follow this loop:
-
-1. **Select:** choose the next lesson from the current wave.
-2. **Discover:** collect real learner questions and one convincing use case.
-3. **Draft:** complete the lesson using the template.
-4. **Verify:** execute every command from a clean starting state.
-5. **Script:** derive the video script from the verified lesson.
-6. **Rehearse:** read it aloud while performing the demo once without recording.
-7. **Record:** capture the short lesson in sections, not one continuous take.
-8. **Pilot:** give the written lesson to a learner before publishing the video.
-9. **Improve:** incorporate observed failures and publish both formats together.
-
-The immediate next step is an unrecorded L00-L03 rehearsal using
-`course-00-app` and `course-01-bootstrap`. Then expand L04-L06 and L13 against
-`course-02-memory`, `course-03-quality`, and `course-05-evidence`. Use the
-checklist in the [instructor guide](instructor-guide.md) and record questions
-rather than polishing video production prematurely.

package/docs/learning/instructor-guide.md

@@ -1,66 +0,0 @@
-# Instructor Guide
-
-## Before each lesson
-
-- Confirm the lesson is marked **Ready**, not **Brief**.
-- Run every command against the current Cairnkeep release.
-- Use a disposable repository and synthetic names, URLs, tokens, and data.
-- Hide notifications, shell history, credentials, bookmarks, and unrelated
-  repositories before screen recording.
-- Increase terminal font size and keep one command per visible line.
-- Prepare a clean start snapshot and a known-good completed snapshot.
-- Rehearse the failure-recovery section, not only the happy path.
-- For L13-L16, prove every optional flag starts disabled and clean up only the
-  disposable evidence or experiment root created by the lesson.
-- Label deterministic evaluation fixtures as framework evidence, never product
-  quality or efficiency evidence.
-
-## Recommended recording format
-
-Record each video as independent segments:
-
-1. **Hook:** the concrete problem in 20-40 seconds.
-2. **Outcome:** what the learner will be able to verify.
-3. **Concept:** only the mental model required for the exercise.
-4. **Demo:** commands and observable results.
-5. **Boundary:** storage, privacy, or trust implication.
-6. **Recap:** result and next lesson.
-
-Aim for 8-15 minutes. If a script exceeds 15 minutes, split the lesson rather
-than speaking faster.
-
-## Recording conventions
-
-- Say command intent before typing the command.
-- Pause after important output so it can be read.
-- Never paste a real token, cookie, endpoint, email, or repository name.
-- Describe output rather than claiming every learner will see identical text.
-- Keep mistakes that teach a recovery step; remove unrelated typing mistakes.
-- Refer to lessons by stable ID, for example “L02”, so links survive title edits.
-
-## Pilot feedback
-
-Ask each pilot learner:
-
-1. Where did you first become uncertain?
-2. Which command did you run without understanding its effect?
-3. Where do you believe memory is stored?
-4. What would prevent you from using this in a real project tomorrow?
-5. Which result made the value clear?
-
-Record observations without collecting project content, prompts, credentials,
-or memory values.
-
-## Definition of done
-
-A lesson is **Ready** only when:
-
-- prerequisites and cleanup are explicit;
-- all commands were executed from the documented starting state;
-- verification distinguishes success from partial installation;
-- common failures have actionable recovery steps;
-- storage and privacy implications are stated;
-- the video script matches the verified lesson;
-- a learner other than the author completed it without hidden instructions.
-- the command surface and lesson assignment agree with the
-  [curriculum coverage map](CURRICULUM-MAP.md).

package/docs/learning/templates/video-script-template.md

@@ -1,50 +0,0 @@
-# LXX Video Script - Title
-
-**Target duration:** NN minutes
-**Companion lesson:** link
-
-## Recording setup
-
-- Screen and terminal state.
-- Files or browser tabs prepared in advance.
-- Sensitive information that must be hidden.
-
-## 00:00 - Hook
-
-**Say:** Presenter wording.
-
-**Show:** Exact visual or terminal state.
-
-## 00:30 - Outcome
-
-**Say:** What the learner will prove.
-
-**Show:** Final result briefly, without teaching it yet.
-
-## 01:00 - Mental model
-
-**Say:** Minimum required explanation.
-
-**Show:** Diagram, slide, or command help.
-
-## 02:00 - Demonstration
-
-For every step include:
-
-- **Say:** intent before action;
-- **Do:** command or interaction;
-- **Point out:** the one important result.
-
-## NN:NN - Boundary and recovery
-
-Explain storage/privacy implications and demonstrate one common recovery.
-
-## NN:NN - Recap
-
-Restate the verified outcome and name the next lesson by ID.
-
-## Editing notes
-
-- Chapters and on-screen captions.
-- Sections safe to re-record independently.
-- Links for the description.

package/docs/learning/video-scripts/L00-why-cairnkeep.md

@@ -1,80 +0,0 @@
-# L00 Video Script - Why Cairnkeep?
-
-**Target duration:** 7 minutes
-**Companion lesson:** [L00](../lessons/L00-why-cairnkeep.md)
-
-## Recording setup
-
-- Show only the trust-ladder table from the lesson.
-- Prepare one slide containing the question: “What should survive this session?”
-- No terminal or private project is required.
-
-## 00:00 - Hook
-
-**Say:** “A coding agent can solve a difficult problem today and make the same
-mistake tomorrow. The missing piece is often not more context. It is a small,
-reviewed record of what the project already learned.”
-
-**Show:** The question slide.
-
-## 00:35 - Outcome
-
-**Say:** “In this lesson you will learn where Cairnkeep fits, what it should
-remember, and what must remain in the repository or another canonical system.”
-
-**Show:** The lesson outcome.
-
-## 01:00 - Trust ladder
-
-**Say:** “Follow information through a trust ladder. The current conversation is
-working context. Optional captured evidence and hindsight notes preserve bounded
-local observations, but they are not automatically trusted memory. Cairnkeep
-memory holds concise operational facts. The project wiki is derived, cited
-knowledge. Code, tests, specifications, policies, and issue trackers remain
-canonical.”
-
-**Show:** Reveal one table row at a time.
-
-**Say:** “If these disagree, the canonical source wins. Cairnkeep helps the
-agent find and apply knowledge; it does not redefine truth.”
-
-## 02:40 - Memory versus RAG
-
-**Say:** “Document RAG and codebase exploration answer a different question:
-which source material is relevant right now? Cairnkeep can integrate with those
-retrieval paths, but it does not require them. A decision such as ‘use
-transactional migrations’ is a memory. The complete migration policy remains a
-document.”
-
-**Show:** Memory on the left, document retrieval on the right.
-
-## 03:40 - Classification exercise
-
-**Say:** “Consider four statements. A confirmed API behavior can become memory
-and should still be traceable to code or a specification. A complete API
-specification remains canonical. A debugging hypothesis stays in the session
-until confirmed. A verified operational prohibition is a durable constraint.”
-
-**Show:** The four L00 exercise statements and reveal answers after a pause.
-
-## 05:10 - Boundary
-
-**Say:** “Cairnkeep does not store every sentence from a session. The default
-stdio setup stores memory on this computer. Structured capture, notes,
-artifacts, evaluation, remote storage, model extraction, embeddings, and
-document RAG are separate explicit choices.”
-
-**Show:** “Local by default. Optional means opt-in.”
-
-## 06:10 - Recap
-
-**Say:** “Remember three things: durable memory is selective, evidence is not
-automatically trusted memory, and canonical sources still win. Optional layers
-are not prerequisites. In L01 we will inspect the published container without
-installing the complete workflow.”
-
-## Editing notes
-
-- Chapters: Problem, Trust ladder, Memory vs retrieval, Exercise, Boundary.
-- Link L00 and L01 in the description.
-- Re-record the version-independent slide only if the conceptual model changes.

package/docs/learning/video-scripts/L01-safe-trial.md

@@ -1,78 +0,0 @@
-# L01 Video Script - Try it safely
-
-**Target duration:** 8 minutes
-**Companion lesson:** [L01](../lessons/L01-safe-trial.md)
-
-## Recording setup
-
-- Use a terminal with no registry credentials or unrelated containers visible.
-- Remove any prior `cairnkeep-course-data` volume before recording.
-- Put the complete Podman command in a prepared text file to avoid typing errors.
-
-## 00:00 - Hook
-
-**Say:** “Before installing commands or changing a coding harness, we can inspect
-how the Cairnkeep server is packaged and what it is allowed to persist.”
-
-**Show:** An empty terminal and `podman --version`.
-
-## 00:30 - Outcome
-
-**Say:** “We will run the server as an unprivileged, read-only container, expose
-no network port, and identify the single named volume that would hold memory.”
-
-## 01:00 - Pull the image
-
-**Say:** “I am pinning the course version rather than using `latest`, so this
-recording and the written instructions refer to the same artifact.”
-
-**Do:** Run the L01 `podman pull` command.
-
-**Point out:** The exact image name and version, without dwelling on layer output.
-
-## 02:00 - Explain the isolation flags
-
-**Say:** “The root filesystem is read-only, Linux capabilities are dropped,
-new privileges are disabled, and only a constrained temporary directory plus a
-named data volume are writable. No home directory or project is mounted.”
-
-**Show:** Highlight the command in sections before running it.
-
-## 03:15 - Start and stop
-
-**Do:** Run the direct Podman stdio command.
-
-**Say:** “The quiet process is expected. It is waiting for MCP messages on
-standard input; it is not a web application.”
-
-**Do:** Pause for two seconds, then press `Ctrl-C`.
-
-## 04:30 - Inspect persistence
-
-**Do:** Run `podman volume inspect cairnkeep-course-data`.
-
-**Say:** “The container was disposable. The named volume is separate and would
-survive replacement of the container. Removing that volume would remove its
-stored databases.”
-
-## 05:40 - Boundary and recovery
-
-**Say:** “This test exposed no port and contacted no remote Cairnkeep server.
-If your environment blocks GHCR or Podman, skip this optional trial and use the
-npm installation in L02.”
-
-**Do:** Run `podman volume exists cairnkeep-course-data` and show status `0`.
-
-## 06:50 - Cleanup and recap
-
-**Do:** Run `podman volume rm cairnkeep-course-data`.
-
-**Say:** “Never run that cleanup against a real memory volume. We proved three
-things: the server runs unprivileged, stdio exposes no listener, and persistence
-is explicit. In L02 we install the complete local workflow.”
-
-## Editing notes
-
-- Blur unrelated image and volume names if they appear.
-- Add a warning caption before volume removal.
-- Link the Containers documentation and L02.