@ritualai/cli 0.25.0 → 0.36.8

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 (61) hide show
  1. package/dist/commands/build.js +89 -0
  2. package/dist/commands/build.js.map +1 -0
  3. package/dist/commands/init.js +93 -109
  4. package/dist/commands/init.js.map +1 -1
  5. package/dist/commands/uninstall.js +6 -1
  6. package/dist/commands/uninstall.js.map +1 -1
  7. package/dist/index.js +18 -0
  8. package/dist/index.js.map +1 -1
  9. package/dist/lib/agents/configure-mcp.js +63 -0
  10. package/dist/lib/agents/configure-mcp.js.map +1 -1
  11. package/dist/lib/agents/launch.js +70 -0
  12. package/dist/lib/agents/launch.js.map +1 -0
  13. package/dist/lib/agents/providers.js +8 -2
  14. package/dist/lib/agents/providers.js.map +1 -1
  15. package/dist/lib/final-cta-box.js +22 -10
  16. package/dist/lib/final-cta-box.js.map +1 -1
  17. package/dist/lib/help-style.js +65 -0
  18. package/dist/lib/help-style.js.map +1 -0
  19. package/dist/lib/onboarding-state.js +9 -8
  20. package/dist/lib/onboarding-state.js.map +1 -1
  21. package/dist/lib/uninstall-plan.js +18 -1
  22. package/dist/lib/uninstall-plan.js.map +1 -1
  23. package/dist/lib/workspace-explainer.js +42 -111
  24. package/dist/lib/workspace-explainer.js.map +1 -1
  25. package/dist/lib/workspace-flow.js +4 -1
  26. package/dist/lib/workspace-flow.js.map +1 -1
  27. package/package.json +1 -1
  28. package/skills/claude-code/ritual/.ritual-bundle.json +3 -2
  29. package/skills/claude-code/ritual/SKILL.md +8 -0
  30. package/skills/claude-code/ritual/references/build-flow.md +474 -414
  31. package/skills/claude-code/ritual/references/cli-output-contract.md +90 -34
  32. package/skills/claude-code/ritual/references/lite-flow.md +484 -421
  33. package/skills/codex/ritual/.ritual-bundle.json +3 -2
  34. package/skills/codex/ritual/SKILL.md +8 -0
  35. package/skills/codex/ritual/references/build-flow.md +474 -414
  36. package/skills/codex/ritual/references/cli-output-contract.md +90 -34
  37. package/skills/codex/ritual/references/lite-flow.md +484 -421
  38. package/skills/cursor/ritual/.ritual-bundle.json +3 -2
  39. package/skills/cursor/ritual/SKILL.md +8 -0
  40. package/skills/cursor/ritual/references/build-flow.md +474 -414
  41. package/skills/cursor/ritual/references/cli-output-contract.md +90 -34
  42. package/skills/cursor/ritual/references/lite-flow.md +484 -421
  43. package/skills/gemini/ritual/.ritual-bundle.json +3 -2
  44. package/skills/gemini/ritual/SKILL.md +8 -0
  45. package/skills/gemini/ritual/references/build-flow.md +474 -414
  46. package/skills/gemini/ritual/references/cli-output-contract.md +90 -34
  47. package/skills/gemini/ritual/references/lite-flow.md +484 -421
  48. package/skills/kiro/ritual/.ritual-bundle.json +3 -2
  49. package/skills/kiro/ritual/SKILL.md +8 -0
  50. package/skills/kiro/ritual/references/build-flow.md +474 -414
  51. package/skills/kiro/ritual/references/cli-output-contract.md +90 -34
  52. package/skills/kiro/ritual/references/lite-flow.md +484 -421
  53. package/skills/vscode/ritual/.ritual-bundle.json +3 -2
  54. package/skills/vscode/ritual/SKILL.md +8 -0
  55. package/skills/vscode/ritual/references/build-flow.md +474 -414
  56. package/skills/vscode/ritual/references/cli-output-contract.md +90 -34
  57. package/skills/vscode/ritual/references/lite-flow.md +484 -421
  58. package/dist/lib/build-flow-explainer.js +0 -226
  59. package/dist/lib/build-flow-explainer.js.map +0 -1
  60. package/dist/lib/persona-picker.js +0 -171
  61. package/dist/lib/persona-picker.js.map +0 -1
@@ -1,4 +1,5 @@
1
1
  {
2
- "cliVersion": "0.25.0",
3
- "builtAt": "2026-06-09T00:58:35.759Z"
2
+ "cliVersion": "0.36.8",
3
+ "builtAt": "2026-06-12T04:36:24.525Z",
4
+ "skillsHash": "49c0dd37dafd"
4
5
  }
@@ -3,6 +3,7 @@ name: ritual
3
3
  description: "Use when an engineer wants a coding agent to plan or build a feature, refactor, or implementation-heavy change that depends on context the agent can't infer on its own — strategic intent, constraints, prior decisions, and trade-offs that live in the user's head. Ritual runs a structured exploration to surface that context through targeted discovery questions, combines it with codebase signals and prior explorations, and delivers a validated build brief (sub-problems, recommendations, dependencies) — additional context to fold into plan mode before the agent writes code. Prefer this over jumping straight to implementation or plan mode when the problem is ambiguous, cross-cutting, or has non-obvious constraints. Subcommands: build (full planning-to-sync cycle — default for new features), resume (continue an in-flight exploration), lineage (file-path KG history — what decisions shaped this code), context-pulse (readiness and context-debt scoring — is this safe to build yet?)."
4
4
  argument-hint: "[subcommand] <args> (e.g. 'build Reduce T2 churn in Q3', 'resume', 'lineage src/checkout/views.py', 'context-pulse Add billing export')"
5
5
  user-invocable: true
6
+ stamp: 49c0dd37dafd
6
7
  ---
7
8
 
8
9
  # /ritual
@@ -19,6 +20,13 @@ Before executing any subcommand, read and follow:
19
20
 
20
21
  Do not reintroduce `/ritual recon`. Use plain-language repo inspection, `/ritual resume`, or `/ritual lineage` depending on intent.
21
22
 
23
+ **Skill freshness (once per session, silent unless stale):** this file's frontmatter may carry a
24
+ `stamp:` value (injected when the bundle was built — absent on dev/source copies). On the FIRST
25
+ `mcp__ritual__ping` of a session, pass it as `skill_stamp`. If the response says
26
+ `skillFreshness: "stale"`, relay its one-line hint ("Skill update available — run
27
+ `ritual init --skills-only` to refresh") exactly once, no pause, and continue with the current flow.
28
+ No stamp, or `in-sync`/`unknown` → say nothing. Never block on this.
29
+
22
30
  ## Contract strength — load-bearing for all subcommands
23
31
 
24
32
  Every section in this SKILL or its reference files labeled **load-bearing**, **forbidden behavior**, **anti-pattern**, **rendering contract**, or **fire-on-trigger** is **contract-strength**, not guidance.