@cairnkeep/cli 2.17.0 → 2.17.1

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable user-facing changes are documented here. This project follows
 
 ## [Unreleased]
 
+## [2.17.1] - 2026-08-31
+
+### Fixed
+
+- Release TTY stdin after every interactive `cairn setup` selector so setup
+  returns to the shell after completion, including through SSH terminals that
+  report stdin as already flowing.
+- Keep the context-usage receipt smoke fixture relative to the test run so its
+  doctor assertion cannot fail merely because a hard-coded timestamp aged out.
+
 ## [2.17.0] - 2026-08-29
 
 ### Added

package/docs/ecosystem.md

@@ -14,7 +14,6 @@ graph workflows have their own explicit companion requirements.
 
 | Tool | What it adds | Integration |
 |---|---|---|
-| [lean-ctx](https://github.com/yvgude/lean-ctx) | Compressed file reads, searches, shell output, and directory maps | Register it as an MCP server in the chosen harness |
 | [token-miser](https://github.com/cairnkeep/token-miser) | Model routing and compact codebase exploration | Configure `CAIRN_ROUTE_ENDPOINT` and/or `CAIRN_EXPLORE_BINARY` |
 | [rtk](https://github.com/rtk-ai/rtk) | Token-reduced output for common Git, npm, and Cargo commands | Install as a shell-level proxy; Cairnkeep wiring is not required |
 

package/docs/learning/CURRICULUM-MAP.md

@@ -1,6 +1,6 @@
 # Curriculum Coverage Map
 
-**Baseline:** Cairnkeep 2.17.0
+**Baseline:** Cairnkeep 2.17.1
 **Last reviewed:** 2026-08-19
 
 This map prevents the course from drifting behind the product. It assigns each

package/docs/learning/FEATURE-GUIDE.md

@@ -1,6 +1,6 @@
 # Cairnkeep feature guide
 
-**Baseline:** Cairnkeep 2.17.0
+**Baseline:** Cairnkeep 2.17.1
 
 This is the step-back map for choosing and operating Cairnkeep features. The
 [course labs](https://github.com/cairnkeep/cairnkeep-course-labs) provide one

package/docs/learning/lessons/L00-why-cairnkeep.md

@@ -3,7 +3,7 @@
 **Status:** Ready
 **Track:** Quickstart
 **Time:** 10 minutes
-**Tested with:** Cairnkeep 2.17.0
+**Tested with:** Cairnkeep 2.17.1
 
 ## Outcome
 

package/docs/learning/lessons/L01-safe-trial.md

@@ -3,7 +3,7 @@
 **Status:** Ready
 **Track:** Quickstart
 **Time:** 15 minutes
-**Tested with:** Cairnkeep 2.17.0
+**Tested with:** Cairnkeep 2.17.1
 
 ## Outcome
 
@@ -26,7 +26,7 @@ ephemeral; the named course volume is persistent.
 1. Pull the public image:
 
    ```bash
-   podman pull ghcr.io/cairnkeep/cairnkeep:2.17.0
+   podman pull ghcr.io/cairnkeep/cairnkeep:2.17.1
    ```
 
 2. Start the stdio server with a read-only root filesystem and no Linux
@@ -38,7 +38,7 @@ ephemeral; the named course volume is persistent.
      --read-only --cap-drop=all --security-opt=no-new-privileges \
      --tmpfs=/tmp:rw,noexec,nosuid,size=64m,mode=1777 \
      --volume cairnkeep-course-data:/data:Z,U \
-     ghcr.io/cairnkeep/cairnkeep:2.17.0 stdio
+     ghcr.io/cairnkeep/cairnkeep:2.17.1 stdio
    ```
 
 3. The process waits quietly for MCP input. Press `Ctrl-C` after confirming it

package/docs/learning/lessons/L02-installation.md

@@ -3,7 +3,7 @@
 **Status:** Ready
 **Track:** Quickstart
 **Time:** 25 minutes
-**Tested with:** Cairnkeep 2.17.0 and Node.js 22 or newer
+**Tested with:** Cairnkeep 2.17.1 and Node.js 22 or newer
 
 ## Outcome
 
@@ -47,7 +47,7 @@ sync. Codex project trust remains an explicit operator decision.
 2. Install Cairnkeep:
 
    ```bash
-   npm install --global @cairnkeep/cli@2.17.0
+   npm install --global @cairnkeep/cli@2.17.1
    cairn --version
    ```
 

package/docs/learning/lessons/L03-first-project.md

@@ -3,7 +3,7 @@
 **Status:** Ready
 **Track:** Quickstart
 **Time:** 25 minutes
-**Tested with:** Cairnkeep 2.17.0
+**Tested with:** Cairnkeep 2.17.1
 
 ## Outcome
 

package/docs/learning/lessons/L19-validated-skill-improvement.md

@@ -3,7 +3,7 @@
 **Status:** Ready
 **Track:** Evidence and Evaluation
 **Time:** 50 minutes
-**Tested with:** Cairnkeep 2.17.0
+**Tested with:** Cairnkeep 2.17.1
 
 ## Outcome
 

package/docs/learning/lessons/L20-mcp-tool-profiles.md

@@ -1,7 +1,7 @@
 # L20 - Least-authority MCP tool profiles
 
 **Status:** Ready
-**Tested with:** Cairnkeep 2.17.0 and Node.js 22 or newer
+**Tested with:** Cairnkeep 2.17.1 and Node.js 22 or newer
 **Time:** 25 minutes
 
 ## Outcome

package/docs/learning/lessons/L21-context-packs.md

@@ -1,7 +1,7 @@
 # L21 - Immutable context packs and skill approval
 
 **Status:** Ready
-**Tested with:** Cairnkeep 2.17.0 and Node.js 22 or newer
+**Tested with:** Cairnkeep 2.17.1 and Node.js 22 or newer
 **Time:** 40 minutes
 
 ## Outcome

package/docs/learning/lessons/L22-native-windows.md

@@ -3,7 +3,7 @@
 **Status:** Ready
 **Track:** Operator
 **Time:** 30 minutes
-**Tested with:** Cairnkeep 2.17.0, Windows x64, and Node.js 22 or newer
+**Tested with:** Cairnkeep 2.17.1, Windows x64, and Node.js 22 or newer
 
 ## Outcome
 
@@ -16,7 +16,7 @@ perform a reversible uninstall without relying on WSL or Git Bash.
 From PowerShell:
 
 ```powershell
-npm install --global @cairnkeep/cli@2.17.0
+npm install --global @cairnkeep/cli@2.17.1
 cairn version
 
 $Lab = Join-Path $env:TEMP 'Cairnkeep Windows Lab'

package/docs/learning/lessons/L23-guided-setup.md

@@ -3,7 +3,7 @@
 **Status:** Ready
 **Track:** Quickstart and Operator
 **Time:** 35 minutes
-**Tested with:** Cairnkeep 2.17.0; Pi 0.84.1; Node.js 22, 24, and 26
+**Tested with:** Cairnkeep 2.17.1; Pi 0.84.1; Node.js 22, 24, and 26
 
 ## Outcome
 

package/docs/learning/lessons/L24-okf-exchange.md

@@ -1,7 +1,7 @@
 # L24 - Reviewed knowledge exchange
 
 **Status:** Ready
-**Tested with:** Cairnkeep 2.17.0 and Node.js 22 or newer
+**Tested with:** Cairnkeep 2.17.1 and Node.js 22 or newer
 **Time:** 35 minutes
 
 ## Outcome

package/docs/learning/lessons/L25-playbooks.md

@@ -1,7 +1,7 @@
 # L25 - Bounded workflow playbooks
 
 **Status:** Ready
-**Tested with:** Cairnkeep 2.17.0 and Node.js 22 or newer
+**Tested with:** Cairnkeep 2.17.1 and Node.js 22 or newer
 **Time:** 35 minutes
 
 ## Outcome

package/examples/eval/bundled-fake.json

@@ -1 +1 @@
-{"identifier":"cairn-offline-fake-v1","package_version":"2.17.0","schema_version":1,"task_set_digest":"13e95379f35839593047ec34521a65a8fa3ab92bd3993bca9dc8bf5c4a9ff36f"}
+{"identifier":"cairn-offline-fake-v1","package_version":"2.17.1","schema_version":1,"task_set_digest":"13e95379f35839593047ec34521a65a8fa3ab92bd3993bca9dc8bf5c4a9ff36f"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cairnkeep/cli",
-  "version": "2.17.0",
+  "version": "2.17.1",
   "description": "A durable, harness-agnostic memory + context layer for coding agents and MCP clients.",
   "license": "Apache-2.0",
   "type": "module",
@@ -73,6 +73,6 @@
     "rag"
   ],
   "devDependencies": {
-    "@cyclonedx/cyclonedx-npm": "6.0.0"
+    "@cyclonedx/cyclonedx-npm": "6.0.1"
   }
 }

package/scripts/terminal-prompts.mjs

@@ -37,7 +37,6 @@ async function runKeypressPrompt({ input, output, draw, accept }) {
   let settled = false;
   let keypressHandler = null;
   let rawChanged = false;
-  let resumed = false;
   let cursorHidden = false;
 
   const render = () => {
@@ -59,7 +58,6 @@ async function runKeypressPrompt({ input, output, draw, accept }) {
     }
     if (wasPaused && typeof input.resume === "function") {
       input.resume();
-      resumed = true;
     }
     output.write("\x1b[?25l");
     cursorHidden = true;
@@ -92,7 +90,11 @@ async function runKeypressPrompt({ input, output, draw, accept }) {
     clear();
     if (cursorHidden) output.write("\x1b[?25h");
     if (rawChanged) input.setRawMode(false);
-    if (resumed && typeof input.pause === "function") input.pause();
+    // A TTY can report itself as already flowing before the first prompt (for
+    // example through an SSH pseudo-terminal). Leaving it flowing keeps Node's
+    // event loop alive after setup has printed its final result. Always pause
+    // prompt input after removing our listener; the next selector resumes it.
+    if (typeof input.pause === "function") input.pause();
   }
 }
 

package/scripts/test-release-sbom.sh

@@ -19,7 +19,7 @@ const manifest = JSON.parse(fs.readFileSync(process.argv[2], "utf8"));
 const lock = JSON.parse(fs.readFileSync(process.argv[3], "utf8"));
 const candidateWorkflow = fs.readFileSync(process.argv[4], "utf8");
 const publishWorkflow = fs.readFileSync(process.argv[5], "utf8");
-const expected = "6.0.0";
+const expected = "6.0.1";
 
 if (manifest.devDependencies?.["@cyclonedx/cyclonedx-npm"] !== expected) {
   throw new Error(`package.json must pin @cyclonedx/cyclonedx-npm exactly to ${expected}`);

package/scripts/test-setup-preflight.mjs

@@ -300,6 +300,19 @@ async function testTerminalSelectors(prompts) {
   await assert.rejects(cancelled, (error) => error?.status === 130 && /cancelled/i.test(error.message));
   assert.equal(input.isRaw, false);
   assert.equal(input.isPaused(), true);
+
+  const flowingInput = new FakeTTY();
+  flowingInput.paused = false;
+  const flowing = prompts.selectOnePrompt({
+    message: "Release flowing input",
+    choices: [{ value: "done", label: "Done" }],
+    input: flowingInput,
+    output: output.stream,
+  });
+  setImmediate(() => flowingInput.emit("keypress", "", { name: "return" }));
+  assert.equal(await flowing, "done");
+  assert.equal(flowingInput.isRaw, false);
+  assert.equal(flowingInput.isPaused(), true, "terminal prompt must release flowing stdin so the CLI can exit");
 }
 
 async function testStructuredSetupSelectors(setup, fixture) {

package/templates/PROJECT-INSTRUCTIONS.md.template

@@ -38,5 +38,4 @@ Scopes defined in `.opencode/memory.json`:
 ## Tool Roles
 - AgentFS is the durable structured memory layer.
 - AnythingLLM is the long-form document retrieval layer.
-- `lean-ctx` is the default context layer (reads, search, exploration), not durable project memory.
 - RTK is a recommended companion for shell-heavy sessions (git, listings, failing builds); Token Savior is not default.