jumbo-cli 1.0.1 → 2.0.1

package/README.md

@@ -2,224 +2,238 @@
   <img src="jumbo-logo.svg" alt="Jumbo" width="200">
 </p>
 
-<h1 align="center">Jumbo - Memory for Coding Agents</h1>
+# Jumbo
+**Memory and context orchestration for coding agents**
 
-<p align="center">
-  Use Jumbo. <br>
-  Focus on goals, not context.
-</p>
+Jumbo is a CLI tool that gives your coding agents persistent memory and structured project context, turning them from makers of workable prototypes into builders of production-quality software.
 
-<p align="center">
-  <a href="#quick-start">Quick Start</a> •
-  <a href="#installation">Installation</a> •
-  <a href="#usage">Usage</a> •
-  <a href="#faqs">FAQs</a>
-</p>
+_An elephant never forgets. Neither should <img src="assets/claude-logo.svg" alt="Claude Code" height="16"> <img src="assets/codex-logo.svg" alt="Codex" height="16"> <img src="assets/gemini-logo.svg" alt="Gemini" height="16"> <img src="assets/github-copilot-logo.svg" alt="Copilot CLI" height="16"> <img src="assets/mistral-logo.svg" alt="Mistral Vibe CLI" height="16"> <img src="assets/cursor-logo.svg" alt="Cursor" height="16"> <img src="assets/vscode-logo.svg" alt="VS Code" height="16"> <img src="assets/amp-logo.svg" alt="Amp" height="16"> <img src="assets/warp-logo.svg" alt="Warp" height="16">_
 
----
 
 ## Can we address the elephant in the room?
+<sub style="color:#898989">(a.k.a. What problems does this solve?)</sub>
 
-Face it, working with coding agents is not ALL fun.  
-One step back for every two forward is not a productivity boost.  
-It's a hassle.
+Working with coding agents is amazing. But let's be honest, it' not without frustration. Here are the common issues:
 
-Context engineering alleviates the pain, but has you focused on the wrong things.
+- **Agent Amnesia**: It's a thing. Every session that came before is forgotten. You spend time and energy getting the agent caught up before you even start thinking about your goals.
 
+- **Slop**: AI without guardrails can produce code that *kind of* works, but it’s rarely production-ready. Worse, it can leave behind a mess that takes hours to untangle. That’s not a productivity boost — it’s a hassle.
+
+- **Vendor lock-in**: If an agent harness holds your memory, switching tools means losing that context. With new models and tools shipping every week, switching is inevitable. Your context should move with you.
 
 ## How does Jumbo help?
 
-Jumbo is a CLI tool that gives your coding agent memory like an... well, <span style="font-size: 1.5rem;">🐘</span>. <br>
-It keeps your agent on track, and you focused on what you want to build.
+Jumbo was created to address these frustrations and unlock the full joy of coding with agents.
 
-### Seen in Action
+- **Memory:** Details about your project are saved, so your agents always have the correct context. Agent Amnesia is, well...forgotten. 
 
-**Before Jumbo:**
+- **Quality:** Your coding agents write shippable code on the first shot. You save time and tokens.  
+  
+- **Interoperability:** Jumbo is harness- and model-agnostic.   
 
-```
-Monday - Claude Code CLI:
-You: 
-   "I'm building an Event Driven distributed system..."
-Claude: 
-   *helps for 2 hours*
+- **Portability:** Switch to new models when they're released. Your context stays with you.
 
-Tuesday - New chat:
-You: 
-   "Continue working on my Event Driven distributed system"
-Claude: 
-   "What Event Driven distributed system? Can you describe your project?"
-You: 
-   *spends 20 minutes re-explaining everything*
-```
+- **Orchestration:** Run different agents in parallel. Optimize for capability and cost. Jumbo keeps everything in sync.
 
-**After Jumbo:**
+Those solve the core problems. These make Jumbo pleasant to use:
 
-```
-Monday - Claude Code CLI:
-You: 
-   "I'm building an Event Driven distributed system..."
-Claude: 
-   *helps for 2 hours*
+- **Extended context windows**: Run agents longer without context rot.<sup>*</sup>
 
-Tuesday - New chat (or different AI tool):
-You: 
-   "Hi"  
-Claude:
-   "Hi! I can see we have 2 planned goals ready to work on:
+- **Automatic**: Hooks into your agent session and orchestrates the flow. It just works.
 
-     - Model the Auth domain
-     - Implement Auth abstractions
+- **Full control**: Jumbo's memories are yours. Stay in control and manage your data directly from the terminal.
 
-    Would you like to start with one of these goals, or did you have something else in mind?"
-```
+- **Private**: All data stays local. Nothing leaves your machine.
 
-### Seen in Benefits
-- **Tracks project details**  
-Important aspects of you project are stored, retrievable, and mutable.  
-<sub>(see below)</sub>
+- **Fast**: No network calls. No lag. Everything runs locally.
 
-- **Delivers optimized context**  
-Agents receive the context they need to work aligned with YOUR criteria.
+<sup>*</sup> <sub>Only works for harnesses that support hooks.</sub>
 
-- **Portable**  
-Switch models, or move from CLI to IDE, without interruption. Jumbo stays with you project and knows exactly where you left off.
 
-- **Extends context windows**  
-Optimal context delivery lets agents work longer.
+## Quick Start
 
-- **Automatic**  
-Hooks into your agent session and orchestrates the flow. It just works.
+<p style="background: #000000; padding: 15px 15px 15px 15px; font-size:16px; color: #eeeeee; font-family: 'Courier New', Courier, monospace; font-weight:bold">
+> <span style="color: #f9c741;">npm</span> <span style="color: #ababab;">-g</span> jumbo-cli
+<br>
+> <span style="color: #f9c741;">jumbo</span> init
+<br>
+> <span style="color: #f9c741;">claude</span>
+<p>
 
-- **Full control**  
-Jumbo's memories are yours. Stay in control and manage your data directly from the terminal.
+Jumbo will automatically orient the agent about your project and available goals.
 
-- **Private**  
-All data stays local. Nothing leaves your machine.
+See the [Getting started](docs/getting-started/quickstart.md) guide for the full workflow.
 
-- **Fast**  
-No network calls. No lag. Works instantaneously.  
+## Compatibility
+Jumbo seamlessly integrates with all frontier harnesses and models. Use them interchangeably or in parallel. 
 
+It also works with any agent that supports [AGENTS.md](https://agents.md) and truly excels with harnesses that support [open agent skills](https://agentskills.io). 
 
-## What's in the trunk?  
-Jumbo models memories as the following aggregates:
+Use Jumbo in a harness that supports hooks and you'll never think about context windows again.
 
-- **Project**  
-What you are building and who it's for.
-- **Architecture**  
-Your solution design, structure and patterns applied.
-- **Components**  
-The parts comprising your solution and their roles.
-- **Dependencies**  
-What your project relies on.
-- **Decisions**  
-A history of why you chose what you chose.
-- **Guidelines**  
-The preferences, best practices, and the standards you adhere to.
-- **Invariants**  
-The rules you simply won't compromise on.
-- **Goals**  
-What you're working on—now, next and later.
-- **Sessions**  
-The state of the project.
-- **Context Packets**  
-Optimized context packets delivered to your AI agents.
+## How does it work?
+It's simple. You just define your goals — describe your objective, criteria, and scope. Then run your agents and Jumbo guides them through the workflow:
 
+1. **Refine:** Your agent collaborates with Jumbo to couple all relevant memories to your goal and build a context packet ready for the agent to implement.
+2. **Implement:** Jumbo serves a curated context packet to your agent when it starts work on your goal.
+3. **Review:** Your agent reviews the goal against criteria and project specification. Non-passing goals are rejected and queued for reimplementation.
+4. **Codify:** Agents update documentation, change logs, and register any missing details that need to be preserved for future goals.
 
----
+You don't have to remember all these steps. Jumbo hooks into your agent sessions and guides the entire flow.
 
-## Quick Start
+Every time you start Claude Code (or similar) Jumbo will orient the agent about the state of your project. The agent will prompt you with an overview of planned work and ask what you want to work on. Just point at a goal and watch the magic happen.
+
+
+## What's in the trunk?
+Jumbo remembers:
+
+Your domain:
+- **Project**: What you are building and who it's for. 
+- **Relations**: The connections between all Jumbo's memories.
+- **Audiences**: Who uses your project and their priorities.
+- **Audience Pains**: The problems your audiences face that you aim to solve.
+- **Value Propositions**: How your product addresses each audience pain. 
+
+Your solution:
+- **Architecture**: Your solution design, structure, and patterns applied.
+- **Components**: The parts comprising your solution and their roles.
+- **Dependencies**: Third-party packages and external services your project relies on. 
+- **Decisions**: History of why you chose what you chose.
+- **Guidelines**: Preferences, best practices, and the standards you adhere to.
+- **Invariants**: Rules you simply won't compromise on.  
+- **Relations**: The graph that ties it all together.  
+
+Your operations:
+- **Goals**: The specifics - objective, criteria, scope, boundaries, and contextual relations.
+- **Sessions**: Manage work continuity with pause, resume, compact, and multi-agent support.
+
+## Architecture
 
-```bash
-# Install globally
-npm install -g jumbo-cli
+Jumbo follows **Clean Screaming Architecture** — four layers, strict dependency rules, and file names that tell you exactly what they do.
 
-# Initialize in your project
-jumbo init
-```
+- **Domain**: Aggregates, events, and policies. Zero dependencies on anything outside.
+- **Application**: Command handlers, controllers, and gateway abstractions. Orchestrates the workflows.
+- **Infrastructure**: Event store, SQLite projections, and gateway implementations. The concrete stuff.
+- **Presentation**: CLI commands and output builders. Parses input, formats output, stays in its lane.
 
-That's it. Jumbo will guide you through the rest. Fire up your coding agent next and they'll use Jumbo automatically.
+Dependencies always point inward. Swap out the infrastructure and nothing else notices.
 
----
+Core patterns:
+
+- **Event Sourcing**: Every state change is a domain event, appended to an immutable JSONL log. Full history, full replay.
+- **CQRS**: Writes produce events through command handlers. Reads come from SQLite views. Each side is optimized independently.
+- **DDD**: One aggregate per bounded context. Domain events live next to their entity. Business rules stay pure.
+- **Gateway Pattern**: Controllers talk to abstractions. Infrastructure provides the implementations. Wired up at startup via Inversify.
+
+Data lives in two stores:
+
+- **Event store**: Append-only JSONL files. Human-readable. The source of truth.
+- **SQLite**: Fast read views projected from the event stream. Rebuildable anytime with `jumbo db rebuild`.
+
+When your agent starts a goal, Jumbo assembles a context packet on the fly — pulling in the components, decisions, guidelines, invariants, and architecture linked to that goal through relations. No stale caches. Always current.
+
+### Built with
+
+- **Core Libraries:**
+  - [`better-sqlite3`](https://github.com/WiseLibs/better-sqlite3) : Read-model projections
+  - [`commander`](https://github.com/tj/commander.js) : CLI framework
+  - [`inversify`](https://github.com/inversify/monorepo) + [`reflect-metadata`](https://github.com/rbuckton/reflect-metadata) : Dependency injection
+  - [`yaml`](https://github.com/eemeli/yaml) : Context serialization
+- **Terminal UI:**
+  - [`ink`](https://github.com/vadimdemedes/ink) + [`react`](https://github.com/facebook/react) : Interactive terminal UI
+  - [`inquirer`](https://github.com/SBoudrias/Inquirer.js) : CLI prompts
+  - [`chalk`](https://github.com/chalk/chalk) : Terminal styling
+  - [`boxen`](https://github.com/sindresorhus/boxen) : Terminal boxes
+- **Utilities:**
+  - [`date-fns`](https://github.com/date-fns/date-fns) : Date formatting
+  - [`fast-glob`](https://github.com/mrmlnc/fast-glob) : File pattern matching
+  - [`fs-extra`](https://github.com/jprichardson/node-fs-extra) : File system utilities
+  - [`jsonc-parser`](https://github.com/microsoft/node-jsonc-parser) : JSON with comments parsing
+  - [`ulid`](https://github.com/ulid/javascript) : Time-sortable unique IDs
+  - [`uuid`](https://github.com/uuidjs/uuid) : Unique identifiers
+
+Spread some ❤️ and sponsor the projects or buy them a cup of coffee. I have.
 
 ## Documentation
 
 | Resource | Description |
-|----------|-------------|
+| --- | --- |
 | [Quickstart](docs/getting-started/quickstart.md) | Get running in 5 minutes |
 | [Installation](docs/getting-started/installation.md) | Prerequisites and setup |
 | [Concepts](docs/getting-started/concepts.md) | Understand sessions, goals, and context |
+| [What Jumbo Creates](docs/getting-started/what-jumbo-creates.md) | Generated files, folders, and local state |
 | [Goal Management](docs/guides/goal-management.md) | Complete guide to tracking work |
+| [Project Initialization](docs/guides/project-initialization.md) | Configure Jumbo for your project |
+| [Session Management](docs/guides/session-management.md) | Manage pause, resume, and session continuity |
+| [Dependency Migration](docs/guides/dependency-migration.md) | Migrate legacy coupling flags to relations |
+| [Advanced Workflows](docs/guides/advanced-workflows.md) | Command chaining and multi-agent collaboration patterns |
 | [Command Reference](docs/reference/) | Full command documentation |
 
----
-
-## Dependencies
-
-Jumbo is built with:
-
-| Package | Purpose |
-|---------|---------|
-| better-sqlite3 | Local event store and projections |
-| commander | CLI framework |
-| chalk | Terminal styling |
-| yaml | Context serialization |
-| inversify | Dependency injection |
-| ulid | Time-sortable unique IDs |
-
----
 
 ## FAQs
 
-**How does jumbo integrate with my AI agent?**
+<details>
+<summary>How does jumbo integrate with my AI agent?</summary>
 
-Through hooks. Your agent calls `jumbo session start` at the beginning of a session, and `jumbo` injects relevant project context. A richer context packet is delivered to the agent when it starts work on a goal. New insights are captured in the natural flow of your agent conversations.
+Through hooks, with fallback to AGENTS.md. Your agent calls `jumbo session start` at the beginning of a session, and Jumbo injects relevant project context. A richer context packet is delivered to the agent when it starts work on a goal. New insights are captured in the natural flow of your agent conversations.
+</details>
 
-**What if I change agents or models?**
+<details>
+<summary>What if I change agents or models?</summary>
 
-Change agents and models at will. `jumbo` just picks up where you left off.
+Change agents and models at will. Jumbo just picks up where you left off.
+</details>
 
-**What coding agents does jumbo work with?**
+<details>
+<summary>What coding agents does jumbo work with?</summary>
 
-`jumbo` has been battle tested with Claude Code CLI, Gemini CLI, and Copilot CLI. More to be verified soon...
+Jumbo has been battle-tested with Claude Code, GitHub Copilot, and Gemini. More are to be verified soon...
+</details>
 
-**What IDEs are supported?**
+<details>
+<summary>What IDEs are supported?</summary>
 
-Theoretically, any IDE with an integrated coding agent should work. VS Code running GitHub Copilot has been tested and works well with all supported models. Cursor to be verified soon...
+Theoretically, any IDE with an integrated coding agent that supports hooks or AGENTS.md should work. VS Code running GitHub Copilot has been tested and works well with all supported models. Cursor is to be verified soon...
+</details>
 
-**Where is data stored?**
+<details>
+<summary>Where is data stored?</summary>
 
-Locally, in `.jumbo/` within your project. Nothing leaves your machine unless you want it to.
+Locally, in `.jumbo/` in your project. Nothing leaves your machine unless you want it to.
+</details>
 
-**Can I control what data Jumbo captures?**  
+<details>
+<summary>Can I control what data Jumbo captures?</summary>
 
-Absolutely. You control how you want your agent to interact with Jumbo. Stay in-the-loop by approving each command, or run with pre-approved Jumbo commands for an automated experience.
+Absolutely. You can manage Jumbo directly from the CLI. You control how you want your agent to interact with Jumbo. Stay in the loop by approving each command, or run with pre-approved Jumbo commands for an automated experience.
+</details>
 
-**Is Jumbo going to hijack my agent?**  
+<details>
+<summary>Is Jumbo going to hijack my agent?</summary> 
 
 Not at all. Jumbo prescribes an opinionated workflow that you can always bypass. It works alongside your agent to enhance its capabilities.  
+</details>
 
-**Why not just use markdown files?**  
+<details>
+<summary>Why not just use markdown files?</summary>  
 
 Jumbo goes beyond static markdown files. It's an immutable event stream—capturing your entire project history, always current and auditable. You stay in your flow, never repeat yourself—only add new information when you need to. Markdown is a snapshot in time, Jumbo is your project's living memory.
+</details>
 
-**Can I share context across a team?**
-
-Not yet. A teams version is coming soon.
-
-If you're feeling bold, you can try committing `.jumbo/` directory to your repository—not recommended though. Without very tight coordination you're bound to encounter problems. `jumbo` uses Event Sourcing under the hood, working asynchronously will definitely result in out-of-sequence events. 
+<details>
+<summary>Can I share context across a team?</summary>
 
-<!-- **Why not just use comments or docs?**
+Jumbo adds the `.jumbo/` folder to your `.gitignore` by default. Jumbo employs the event sourcing pattern under the hood, and it is likely to result in conflicts if shared between the team.
 
-You can do that, but the amount of context window consumed while your agent crawls your repo for background information leaves little context budget for executing the task precisely. You risk auto-compression and the agent going awry. gure out how to execute a given task, leaves little   They also don't capture vital lessons learned in the context of your 'conversations'  Jumbo is dynamic—it knows what you're working on *right now* and surfaces relevant context automatically. Jumbo let's you focus on what you want to achieve, the background just comes automatically.
+Love Jumbo and want to use it in your team? A cloud version is coming soon. Sign up to get notified when it's launched [here](https://jumbocontext.com/herd).
+</details>
 
----
 
 ## License
 
 [AGPL-3.0](LICENSE)
 
----
 
 <p align="center">
-  Built with 🪄 in Copenhagen for devs who are tired of repeating themselves, by devs who are tired of the same.
+  Built in Copenhagen for devs who are tired of repeating themselves, by a dev who was tired of the same.
 </p>

package/assets/amp-logo.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 281 124" fill="#000000" xmlns="http://www.w3.org/2000/svg"><path d="M236.014 0C260.431 9.71106e-05 280.602 17.4115 280.603 44.7432C280.602 73.5337 260.065 94.1657 233.52 94.166C224.158 94.166 215.639 92.4222 208.63 88.4902C202.886 85.2698 198.203 80.6054 194.919 74.3379L188.115 121.822L187.946 123.016H174.214L174.448 121.423L191.772 2.49414H205.372L203.937 11.3369C212.143 3.86078 223.2 0.000153635 236.014 0ZM47.082 0.154297C56.4435 0.154297 65.0012 1.8991 72.0488 5.84863C77.8222 9.08305 82.5323 13.7713 85.8271 20.085L88.1201 3.69238L88.2861 2.49316H101.863L89.1611 90.6328L88.9873 91.8262H75.4092L76.7227 82.8555C68.5854 90.4564 57.3981 94.3231 44.5889 94.3232C20.1709 94.3232 0.000167223 76.9087 0 49.5771C0.000149745 20.7854 20.54 0.154871 47.082 0.154297ZM116.234 90.6357L116.061 91.8271H102.485L115.351 3.68555L115.521 2.49414H129.083L116.234 90.6357ZM140.673 90.6357L140.499 91.8271H126.924L139.789 3.68555L139.96 2.49414H153.521L140.673 90.6357ZM177.958 2.49414L165.108 90.6357L164.935 91.8271H151.36L164.225 3.68555L164.396 2.49414H177.958ZM48.4854 11.9844C27.8638 11.985 14.0133 28.3799 14.0127 48.9521C14.0127 57.7907 16.8094 66.1771 22.3145 72.334C27.7973 78.4657 36.0631 82.4932 47.2402 82.4932C67.8534 82.4925 81.7122 65.9487 81.7129 45.3682C81.7129 35.4076 78.2493 27.0792 72.4131 21.2441C66.5794 15.4088 58.2871 11.9844 48.4854 11.9844ZM233.362 11.8291C212.749 11.8297 198.89 28.3716 198.89 48.9521C198.89 58.9123 202.356 67.2403 208.189 73.0742C214.023 78.9107 222.315 82.3358 232.116 82.3359C252.738 82.3355 266.589 65.9407 266.59 45.3682C266.59 36.5296 263.795 28.1424 258.29 21.9863C252.807 15.8551 244.542 11.8291 233.362 11.8291Z"/></svg>

package/assets/claude-logo.svg

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Generated by Pixelmator Pro 3.6.17 -->
+<svg width="1200" height="1200" viewBox="0 0 1200 1200" xmlns="http://www.w3.org/2000/svg">
+    <g id="g314">
+        <path id="path147" fill="#d97757" stroke="none" d="M 233.959793 800.214905 L 468.644287 668.536987 L 472.590637 657.100647 L 468.644287 650.738403 L 457.208069 650.738403 L 417.986633 648.322144 L 283.892639 644.69812 L 167.597321 639.865845 L 54.926208 633.825623 L 26.577238 627.785339 L 3.3e-05 592.751709 L 2.73832 575.27533 L 26.577238 559.248352 L 60.724873 562.228149 L 136.187973 567.382629 L 249.422867 575.194763 L 331.570496 580.026978 L 453.261841 592.671082 L 472.590637 592.671082 L 475.328857 584.859009 L 468.724915 580.026978 L 463.570557 575.194763 L 346.389313 495.785217 L 219.543671 411.865906 L 153.100723 363.543762 L 117.181267 339.060425 L 99.060455 316.107361 L 91.248367 266.01355 L 123.865784 230.093994 L 167.677887 233.073853 L 178.872513 236.053772 L 223.248367 270.201477 L 318.040283 343.570496 L 441.825592 434.738342 L 459.946411 449.798706 L 467.194672 444.64447 L 468.080597 441.020203 L 459.946411 427.409485 L 392.617493 305.718323 L 320.778564 181.932983 L 288.80542 130.630859 L 280.348999 99.865845 C 277.369171 87.221436 275.194641 76.590698 275.194641 63.624268 L 312.322174 13.20813 L 332.8591 6.604126 L 382.389313 13.20813 L 403.248352 31.328979 L 434.013519 101.71814 L 483.865753 212.537048 L 561.181274 363.221497 L 583.812134 407.919434 L 595.892639 449.315491 L 600.40271 461.959839 L 608.214783 461.959839 L 608.214783 454.711609 L 614.577271 369.825623 L 626.335632 265.61084 L 637.771851 131.516846 L 641.718201 93.745117 L 660.402832 48.483276 L 697.530334 24.000122 L 726.52356 37.852417 L 750.362549 72 L 747.060486 94.067139 L 732.886047 186.201416 L 705.100708 330.52356 L 686.979919 427.167847 L 697.530334 427.167847 L 709.61084 415.087341 L 758.496704 350.174561 L 840.644348 247.490051 L 876.885925 206.738342 L 919.167847 161.71814 L 946.308838 140.29541 L 997.61084 140.29541 L 1035.38269 196.429626 L 1018.469849 254.416199 L 965.637634 321.422852 L 921.825562 378.201538 L 859.006714 462.765259 L 819.785278 530.41626 L 823.409424 535.812073 L 832.75177 534.92627 L 974.657776 504.724915 L 1051.328979 490.872559 L 1142.818848 475.167786 L 1184.214844 494.496582 L 1188.724854 514.147644 L 1172.456421 554.335693 L 1074.604126 578.496765 L 959.838989 601.449829 L 788.939636 641.879272 L 786.845764 643.409485 L 789.261841 646.389343 L 866.255127 653.637634 L 899.194702 655.409424 L 979.812134 655.409424 L 1129.932861 666.604187 L 1169.154419 692.537109 L 1192.671265 724.268677 L 1188.724854 748.429688 L 1128.322144 779.194641 L 1046.818848 759.865845 L 856.590759 714.604126 L 791.355774 698.335754 L 782.335693 698.335754 L 782.335693 703.731567 L 836.69812 756.885986 L 936.322205 846.845581 L 1061.073975 962.81897 L 1067.436279 991.490112 L 1051.409424 1014.120911 L 1034.496704 1011.704712 L 924.885986 929.234924 L 882.604126 892.107544 L 786.845764 811.48999 L 780.483276 811.48999 L 780.483276 819.946289 L 802.550415 852.241699 L 919.087341 1027.409424 L 925.127625 1081.127686 L 916.671204 1098.604126 L 886.469849 1109.154419 L 853.288696 1103.114136 L 785.073914 1007.355835 L 714.684631 899.516785 L 657.906067 802.872498 L 650.979858 806.81897 L 617.476624 1167.704834 L 601.771851 1186.147705 L 565.530212 1200 L 535.328857 1177.046997 L 519.302124 1139.919556 L 535.328857 1066.550537 L 554.657776 970.792053 L 570.362488 894.68457 L 584.536926 800.134277 L 592.993347 768.724976 L 592.429626 766.630859 L 585.503479 767.516968 L 514.22821 865.369263 L 405.825531 1011.865906 L 320.053711 1103.677979 L 299.516815 1111.812256 L 263.919525 1093.369263 L 267.221497 1060.429688 L 287.114136 1031.114136 L 405.825531 880.107361 L 477.422913 786.52356 L 523.651062 732.483276 L 523.328918 724.671265 L 520.590698 724.671265 L 205.288605 929.395935 L 149.154434 936.644409 L 124.993355 914.01355 L 127.973183 876.885986 L 139.409409 864.80542 L 234.201385 799.570435 L 233.879227 799.8927 Z"/>
+    </g>
+</svg>

package/assets/codex-logo.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 10 11" fill="none">
+  <path d="M8.33301 5.79411C8.33301 3.95316 6.84062 2.46077 4.99967 2.46077C3.15873 2.46077 1.66634 3.95316 1.66634 5.79411C1.66634 7.63506 3.15873 9.12744 4.99967 9.12744C6.84062 9.12744 8.33301 7.63506 8.33301 5.79411ZM6.66634 6.41911C6.89646 6.41911 7.08301 6.60566 7.08301 6.83577C7.08301 7.06589 6.89646 7.25244 6.66634 7.25244H5.41634C5.18622 7.25244 4.99967 7.06589 4.99967 6.83577C4.99967 6.60566 5.18622 6.41911 5.41634 6.41911H6.66634ZM3.3269 4.39518C3.51191 4.28418 3.74861 4.33339 3.875 4.5026L3.8986 4.538L4.5236 5.57967L4.54964 5.63053C4.59421 5.73493 4.59421 5.85328 4.54964 5.95768L4.5236 6.00855L3.8986 7.05021C3.78019 7.24749 3.52421 7.31142 3.3269 7.19303C3.12963 7.07462 3.0657 6.81864 3.18408 6.62134L3.68009 5.79411L3.18408 4.96688L3.16414 4.92904C3.07439 4.73792 3.14197 4.50618 3.3269 4.39518ZM9.16634 5.79411C9.16634 8.09529 7.30086 9.96078 4.99967 9.96078C2.69849 9.96078 0.833008 8.09529 0.833008 5.79411C0.833008 3.49292 2.69849 1.62744 4.99967 1.62744C7.30086 1.62744 9.16634 3.49292 9.16634 5.79411Z" fill="#000"/>
+</svg>

package/assets/cursor-logo.svg

@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg id="Ebene_1" xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0 0 466.73 533.32">
+  <!-- Generator: Adobe Illustrator 29.6.1, SVG Export Plug-In . SVG Version: 2.1.1 Build 9)  -->
+  <defs>
+    <style>
+      .st0 {
+        fill: #72716d;
+      }
+
+      .st1 {
+        fill: #55544f;
+      }
+
+      .st2 {
+        fill: #fff;
+      }
+
+      .st3 {
+        fill: #43413c;
+      }
+
+      .st4 {
+        fill: #d6d5d2;
+      }
+    </style>
+  </defs>
+  <path class="st0" d="M233.37,266.66l231.16,133.46c-1.42,2.46-3.48,4.56-6.03,6.03l-216.06,124.74c-5.61,3.24-12.53,3.24-18.14,0L8.24,406.15c-2.55-1.47-4.61-3.57-6.03-6.03l231.16-133.46h0Z"/>
+  <path class="st1" d="M233.37,0v266.66L2.21,400.12c-1.42-2.46-2.21-5.3-2.21-8.24v-250.44c0-5.89,3.14-11.32,8.24-14.27L224.29,2.43c2.81-1.62,5.94-2.43,9.07-2.43h.01Z"/>
+  <path class="st3" d="M464.52,133.2c-1.42-2.46-3.48-4.56-6.03-6.03L242.43,2.43c-2.8-1.62-5.93-2.43-9.06-2.43v266.66l231.16,133.46c1.42-2.46,2.21-5.3,2.21-8.24v-250.44c0-2.95-.78-5.77-2.21-8.24h-.01Z"/>
+  <path class="st4" d="M448.35,142.54c1.31,2.26,1.49,5.16,0,7.74l-209.83,363.42c-1.41,2.46-5.16,1.45-5.16-1.38v-239.48c0-1.91-.51-3.75-1.44-5.36l216.42-124.95h.01Z"/>
+  <path class="st2" d="M448.35,142.54l-216.42,124.95c-.92-1.6-2.26-2.96-3.92-3.92L20.62,143.83c-2.46-1.41-1.45-5.16,1.38-5.16h419.65c2.98,0,5.4,1.61,6.7,3.87Z"/>
+</svg>

package/assets/gemini-logo.svg

@@ -0,0 +1 @@
+<svg height="1em" style="flex:none;line-height:1" viewBox="0 0 24 24" width="1em" xmlns="http://www.w3.org/2000/svg"><title>Gemini</title><path d="M20.616 10.835a14.147 14.147 0 01-4.45-3.001 14.111 14.111 0 01-3.678-6.452.503.503 0 00-.975 0 14.134 14.134 0 01-3.679 6.452 14.155 14.155 0 01-4.45 3.001c-.65.28-1.318.505-2.002.678a.502.502 0 000 .975c.684.172 1.35.397 2.002.677a14.147 14.147 0 014.45 3.001 14.112 14.112 0 013.679 6.453.502.502 0 00.975 0c.172-.685.397-1.351.677-2.003a14.145 14.145 0 013.001-4.45 14.113 14.113 0 016.453-3.678.503.503 0 000-.975 13.245 13.245 0 01-2.003-.678z" fill="#3186FF"></path><path d="M20.616 10.835a14.147 14.147 0 01-4.45-3.001 14.111 14.111 0 01-3.678-6.452.503.503 0 00-.975 0 14.134 14.134 0 01-3.679 6.452 14.155 14.155 0 01-4.45 3.001c-.65.28-1.318.505-2.002.678a.502.502 0 000 .975c.684.172 1.35.397 2.002.677a14.147 14.147 0 014.45 3.001 14.112 14.112 0 013.679 6.453.502.502 0 00.975 0c.172-.685.397-1.351.677-2.003a14.145 14.145 0 013.001-4.45 14.113 14.113 0 016.453-3.678.503.503 0 000-.975 13.245 13.245 0 01-2.003-.678z" fill="url(#lobe-icons-gemini-fill-0)"></path><path d="M20.616 10.835a14.147 14.147 0 01-4.45-3.001 14.111 14.111 0 01-3.678-6.452.503.503 0 00-.975 0 14.134 14.134 0 01-3.679 6.452 14.155 14.155 0 01-4.45 3.001c-.65.28-1.318.505-2.002.678a.502.502 0 000 .975c.684.172 1.35.397 2.002.677a14.147 14.147 0 014.45 3.001 14.112 14.112 0 013.679 6.453.502.502 0 00.975 0c.172-.685.397-1.351.677-2.003a14.145 14.145 0 013.001-4.45 14.113 14.113 0 016.453-3.678.503.503 0 000-.975 13.245 13.245 0 01-2.003-.678z" fill="url(#lobe-icons-gemini-fill-1)"></path><path d="M20.616 10.835a14.147 14.147 0 01-4.45-3.001 14.111 14.111 0 01-3.678-6.452.503.503 0 00-.975 0 14.134 14.134 0 01-3.679 6.452 14.155 14.155 0 01-4.45 3.001c-.65.28-1.318.505-2.002.678a.502.502 0 000 .975c.684.172 1.35.397 2.002.677a14.147 14.147 0 014.45 3.001 14.112 14.112 0 013.679 6.453.502.502 0 00.975 0c.172-.685.397-1.351.677-2.003a14.145 14.145 0 013.001-4.45 14.113 14.113 0 016.453-3.678.503.503 0 000-.975 13.245 13.245 0 01-2.003-.678z" fill="url(#lobe-icons-gemini-fill-2)"></path><defs><linearGradient gradientUnits="userSpaceOnUse" id="lobe-icons-gemini-fill-0" x1="7" x2="11" y1="15.5" y2="12"><stop stop-color="#08B962"></stop><stop offset="1" stop-color="#08B962" stop-opacity="0"></stop></linearGradient><linearGradient gradientUnits="userSpaceOnUse" id="lobe-icons-gemini-fill-1" x1="8" x2="11.5" y1="5.5" y2="11"><stop stop-color="#F94543"></stop><stop offset="1" stop-color="#F94543" stop-opacity="0"></stop></linearGradient><linearGradient gradientUnits="userSpaceOnUse" id="lobe-icons-gemini-fill-2" x1="3.5" x2="17.5" y1="13.5" y2="12"><stop stop-color="#FABC12"></stop><stop offset=".46" stop-color="#FABC12" stop-opacity="0"></stop></linearGradient></defs></svg>

package/assets/github-copilot-logo.svg

@@ -0,0 +1 @@
+<svg viewBox="0 0 512 416" xmlns="http://www.w3.org/2000/svg" fill-rule="evenodd" clip-rule="evenodd" stroke-linejoin="round" stroke-miterlimit="2"><path d="M181.33 266.143c0-11.497 9.32-20.818 20.818-20.818 11.498 0 20.819 9.321 20.819 20.818v38.373c0 11.497-9.321 20.818-20.819 20.818-11.497 0-20.818-9.32-20.818-20.818v-38.373zM308.807 245.325c-11.477 0-20.798 9.321-20.798 20.818v38.373c0 11.497 9.32 20.818 20.798 20.818 11.497 0 20.818-9.32 20.818-20.818v-38.373c0-11.497-9.32-20.818-20.818-20.818z" fill-rule="nonzero"/><path d="M512.002 246.393v57.384c-.02 7.411-3.696 14.638-9.67 19.011C431.767 374.444 344.695 416 256 416c-98.138 0-196.379-56.542-246.33-93.21-5.975-4.374-9.65-11.6-9.671-19.012v-57.384a35.347 35.347 0 016.857-20.922l15.583-21.085c8.336-11.312 20.757-14.31 33.98-14.31 4.988-56.953 16.794-97.604 45.024-127.354C155.194 5.77 226.56 0 256 0c29.441 0 100.807 5.77 154.557 62.722 28.19 29.75 40.036 70.401 45.025 127.354 13.263 0 25.602 2.936 33.958 14.31l15.583 21.127c4.476 6.077 6.878 13.345 6.878 20.88zm-97.666-26.075c-.677-13.058-11.292-18.19-22.338-21.824-11.64 7.309-25.848 10.183-39.46 10.183-14.454 0-41.432-3.47-63.872-25.869-5.667-5.625-9.527-14.454-12.155-24.247a212.902 212.902 0 00-20.469-1.088c-6.098 0-13.099.349-20.551 1.088-2.628 9.793-6.509 18.622-12.155 24.247-22.4 22.4-49.418 25.87-63.872 25.87-13.612 0-27.86-2.855-39.501-10.184-11.005 3.613-21.558 8.828-22.277 21.824-1.17 24.555-1.272 49.11-1.375 73.645-.041 12.318-.082 24.658-.288 36.976.062 7.166 4.374 13.818 10.882 16.774 52.97 24.124 103.045 36.278 149.137 36.278 46.01 0 96.085-12.154 149.014-36.278 6.508-2.956 10.84-9.608 10.881-16.774.637-36.832.124-73.809-1.642-110.62h.041zM107.521 168.97c8.643 8.623 24.966 14.392 42.56 14.392 13.448 0 39.03-2.874 60.156-24.329 9.28-8.951 15.05-31.35 14.413-54.079-.657-18.231-5.769-33.28-13.448-39.665-8.315-7.371-27.203-10.574-48.33-8.644-22.399 2.238-41.267 9.588-50.875 19.833-20.798 22.728-16.323 80.317-4.476 92.492zm130.556-56.008c.637 3.51.965 7.35 1.273 11.517 0 2.875 0 5.77-.308 8.952 6.406-.636 11.847-.636 16.959-.636s10.553 0 16.959.636c-.329-3.182-.329-6.077-.329-8.952.329-4.167.657-8.007 1.294-11.517-6.735-.637-12.812-.965-17.924-.965s-11.21.328-17.924.965zm49.275-8.008c-.637 22.728 5.133 45.128 14.413 54.08 21.105 21.454 46.708 24.328 60.155 24.328 17.596 0 33.918-5.769 42.561-14.392 11.847-12.175 16.322-69.764-4.476-92.492-9.608-10.245-28.476-17.595-50.875-19.833-21.127-1.93-40.015 1.273-48.33 8.644-7.679 6.385-12.791 21.434-13.448 39.665z"/></svg>

package/assets/mistral-logo.svg

@@ -0,0 +1,19 @@
+<svg width="191" height="135" viewBox="0 0 191 135" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_134_208)">
+<path d="M54.3221 0H27.1531V27.0892H54.3221V0Z" fill="#FFD800"/>
+<path d="M162.984 0H135.815V27.0892H162.984V0Z" fill="#FFD800"/>
+<path d="M81.4823 27.0913H27.1531V54.1805H81.4823V27.0913Z" fill="#FFAF00"/>
+<path d="M162.99 27.0913H108.661V54.1805H162.99V27.0913Z" fill="#FFAF00"/>
+<path d="M162.972 54.168H27.1531V81.2572H162.972V54.168Z" fill="#FF8205"/>
+<path d="M54.3221 81.2593H27.1531V108.349H54.3221V81.2593Z" fill="#FA500F"/>
+<path d="M108.661 81.2593H81.4917V108.349H108.661V81.2593Z" fill="#FA500F"/>
+<path d="M162.984 81.2593H135.815V108.349H162.984V81.2593Z" fill="#FA500F"/>
+<path d="M81.4879 108.339H-0.00146484V135.429H81.4879V108.339Z" fill="#E10500"/>
+<path d="M190.159 108.339H108.661V135.429H190.159V108.339Z" fill="#E10500"/>
+</g>
+<defs>
+<clipPath id="clip0_134_208">
+<rect width="190.141" height="135" fill="white"/>
+</clipPath>
+</defs>
+</svg>

package/assets/skills/codify-jumbo-goal/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: codify-jumbo-goal
+description: Use when a Jumbo goal has been approved by QA review and needs architectural reconciliation before closing. Captures new learnings, updates stale entities, and ensures documentation reflects the work performed.
+---
+
+# Codify Jumbo Goal
+
+**Prompt:** Perform architectural reconciliation for an approved Jumbo goal — capture new learnings, review registered entities for staleness, update documentation, then close the goal.
+
+## Why Codification Matters
+
+After a goal passes QA review, the codebase has changed but the project's registered knowledge may not reflect those changes. Codification is the checkpoint where new invariants, decisions, components, and guidelines discovered during implementation get captured. Skipping codification causes knowledge drift — future agents operate with stale or incomplete context.
+
+## Protocol
+
+### 1. Initiate Codification
+
+```bash
+jumbo goal codify --id <goal-id>
+```
+
+Review the goal's objective and status. The goal must be in a reviewable state.
+
+### 2. Capture New Learnings
+
+Reflect on the implementation interaction with the user during this goal. Ask:
+
+- Did it surface any **NEW** invariants, guidelines, decisions, components, dependencies, or architectural patterns not yet captured?
+- Were you corrected in a way that reveals a missing rule?
+
+Only propose additions that are:
+- **Universal** (applicable beyond this specific goal)
+- **Dense** (one sentence, no examples unless the example IS the rule)
+- **Actionable** (changes how code is written or decisions are made)
+
+If nothing qualifies, say so. Avoid restating what's already captured.
+
+Use `jumbo --help` for command details on registering new entities.
+
+### 3. Review Registered Entities for Staleness
+
+The goal may have changed the codebase in ways that affect registered entities. For each entity type below, consider whether any existing registrations need updating based on the work performed.
+
+#### Components
+Did any component descriptions, responsibilities, or paths change? Were any components deprecated or removed?
+```bash
+jumbo component update --id <id> --description "..." --responsibility "..."
+jumbo component deprecate --id <id> --reason "..."
+jumbo component add --name "..." --type "..." --description "..." --responsibility "..." --path "..."
+```
+
+#### Decisions
+Were any architectural decisions made, superseded, or invalidated by this work?
+```bash
+jumbo decision add --title "..." --context "..." --rationale "..."
+jumbo decision update --id <id> --rationale "..."
+jumbo decision supersede --id <id> --new-decision-id <new-id>
+```
+
+#### Invariants
+Were any invariants introduced, weakened, strengthened, or made obsolete?
+```bash
+jumbo invariant add --title "..." --description "..." --enforcement "..."
+jumbo invariant update --id <id> --description "..." --enforcement "..."
+jumbo invariant remove --id <id>
+```
+
+#### Guidelines
+Were any coding, testing, or documentation guidelines introduced or changed?
+```bash
+jumbo guideline add --category "..." --title "..." --description "..."
+jumbo guideline update --guideline-id <id> --description "..."
+jumbo guideline remove --guideline-id <id>
+```
+
+#### Dependencies
+Were any dependencies added, removed, or changed?
+```bash
+jumbo dependency add --consumer-id <id> --provider-id <id> --contract "..."
+jumbo dependency update --id <id> --contract "..."
+jumbo dependency remove --id <id>
+```
+
+#### Architecture
+Did this work change the architecture style, principles, or patterns?
+```bash
+jumbo architecture update --style "..." --principles "..."
+```
+
+#### Relations
+Should any new relations be established between entities touched by this goal?
+```bash
+jumbo relation add --from-type <type> --from-id <id> --to-type <type> --to-id <id> --type <type> --strength <level>
+```
+
+### 4. Update Documentation
+
+Evaluate whether changes should be reflected in user documentation:
+- Did the changes introduce any new features, modify existing behavior, or fix bugs that users should be aware of?
+- If yes, propose updates to `~/docs/*` and update the `CHANGELOG.md`.
+
+### 5. Close the Goal
+
+After completing the reconciliation above, close the goal:
+
+```bash
+jumbo goal close --id <goal-id>
+```
+
+## Rules
+
+1. **Never skip entity review.** Every entity category must be evaluated for staleness after implementation.
+2. **Only capture universal learnings.** Do not register goal-specific observations as project-wide invariants or guidelines.
+3. **Keep additions dense.** One sentence per entity. No examples unless the example IS the rule.
+4. **Always check documentation impact.** Implementation changes that affect user-facing behavior must be documented.
+5. **Close the goal last.** Only run `jumbo goal close` after all reconciliation steps are complete.