@cairnkeep/cli 2.15.3 → 2.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/CHANGELOG.md +36 -0
  2. package/CONTRIBUTING.md +12 -0
  3. package/README.md +84 -589
  4. package/docs/README.md +79 -0
  5. package/docs/agents.md +173 -0
  6. package/docs/ecosystem.md +23 -0
  7. package/docs/harness-compatibility.md +4 -3
  8. package/docs/learning/CURRICULUM-MAP.md +2 -2
  9. package/docs/learning/FEATURE-GUIDE.md +6 -6
  10. package/docs/learning/README.md +3 -0
  11. package/docs/learning/lessons/L00-why-cairnkeep.md +3 -1
  12. package/docs/learning/lessons/L01-safe-trial.md +3 -3
  13. package/docs/learning/lessons/L02-installation.md +2 -2
  14. package/docs/learning/lessons/L03-first-project.md +9 -10
  15. package/docs/learning/lessons/L19-validated-skill-improvement.md +1 -1
  16. package/docs/learning/lessons/L20-mcp-tool-profiles.md +1 -1
  17. package/docs/learning/lessons/L21-context-packs.md +1 -1
  18. package/docs/learning/lessons/L22-native-windows.md +2 -2
  19. package/docs/learning/lessons/L23-guided-setup.md +18 -5
  20. package/docs/learning/lessons/L24-okf-exchange.md +1 -1
  21. package/docs/learning/lessons/L25-playbooks.md +2 -2
  22. package/docs/learning/video-scripts/V25-playbooks.md +1 -1
  23. package/docs/native-windows.md +5 -0
  24. package/docs/operating.md +24 -5
  25. package/docs/quickstart.md +15 -6
  26. package/docs/releasing.md +27 -19
  27. package/examples/eval/bundled-fake.json +1 -1
  28. package/mcp-memory-server/dist/playbook-cli.js +12 -5
  29. package/package.json +1 -1
  30. package/scripts/cairn-cli.mjs +1 -0
  31. package/scripts/setup.mjs +92 -13
  32. package/scripts/terminal-prompts.mjs +172 -0
  33. package/scripts/test-cli-dispatch.sh +4 -0
  34. package/scripts/test-docs-navigation.sh +63 -0
  35. package/scripts/test-learning-docs.sh +1 -1
  36. package/scripts/test-package-install.sh +1 -1
  37. package/scripts/test-phase17-artifact-lifecycle.sh +1 -1
  38. package/scripts/test-playbook-instructions.sh +4 -2
  39. package/scripts/test-release-sbom.sh +41 -16
  40. package/scripts/test-setup-preflight.mjs +130 -0
  41. package/scripts/test-windows-native.mjs +1 -1
  42. package/scripts/verify-docs-parity.sh +28 -28
  43. package/templates/playbook-agent-instructions.md.template +5 -4
package/CHANGELOG.md CHANGED
@@ -5,6 +5,42 @@ All notable user-facing changes are documented here. This project follows
5
5
 
6
6
  ## [Unreleased]
7
7
 
8
+ ## [2.16.0] - 2026-08-27
9
+
10
+ ### Added
11
+
12
+ - Add dependency-free terminal selectors to `cairn setup`: arrow-key choices
13
+ for Git and memory, Space-toggle checkboxes for harnesses, and a selectable
14
+ final confirmation. Escape and Ctrl-C cancel safely.
15
+
16
+ ### Changed
17
+
18
+ - Keep the existing text-question fallback for limited terminals and preserve
19
+ every deterministic setup flag for scripts, CI, policies, and overlays.
20
+ - Treat redirected output as non-interactive even when standard input is still
21
+ a TTY, preventing hidden prompts in automation.
22
+
23
+ ### Fixed
24
+
25
+ - Keep capability-logging smoke fixtures relative to the test date so the
26
+ retention contract cannot fail merely because a hard-coded date aged out.
27
+
28
+ ## [2.15.4] - 2026-08-19
29
+
30
+ ### Changed
31
+
32
+ - Make the managed project-memory retrieval contract explicit that retrieval
33
+ is the first tool or command, including before `pwd`, `ls`, inventory, or
34
+ search commands.
35
+ - Put the bounded complexity, familiarity, and risk values directly in the
36
+ managed playbook commands so agents do not need to guess them.
37
+
38
+ ### Fixed
39
+
40
+ - Support event-scoped playbook help such as
41
+ `cairn playbook check start --help` while continuing to reject ambiguous or
42
+ unknown help forms.
43
+
8
44
  ## [2.15.3] - 2026-08-18
9
45
 
10
46
  ### Changed
package/CONTRIBUTING.md CHANGED
@@ -37,6 +37,18 @@ npm run check:public
37
37
  Some integration verifiers require optional sibling tools or configured API
38
38
  endpoints. They are not part of the default offline test suite.
39
39
 
40
+ ## Repository map
41
+
42
+ - `mcp-memory-server/` contains the MCP server, storage owners, schemas, and
43
+ Node-based CLI implementations.
44
+ - `bin/cairn` is the installed command entry point.
45
+ - `templates/` contains project scaffolding and managed instruction assets.
46
+ - `claude/`, `opencode/`, `pi/`, and `kimi/` contain harness-specific operating
47
+ assets.
48
+ - `scripts/` contains sync, lifecycle, packaging, and contract checks.
49
+ - `docs/` contains the versioned user and operator references indexed from
50
+ [the documentation hub](docs/README.md).
51
+
40
52
  ## Pull requests
41
53
 
42
54
  - Create a focused branch from `main`.