openfleet 0.3.15 → 0.4.1

package/dist/index.js

@@ -2,30 +2,33 @@
 // src/config.ts
 import * as path from "path";
 var OPENFLEET_DIR = path.join(process.cwd(), ".openfleet");
+var PUBLIC_DIR = path.join(OPENFLEET_DIR, "public");
+var PRIVATE_DIR = path.join(OPENFLEET_DIR, "private");
 var PATHS = {
   agentsMd: path.join(process.cwd(), "AGENTS.md"),
   root: OPENFLEET_DIR,
-  statusFile: path.join(OPENFLEET_DIR, "status.md"),
+  public: PUBLIC_DIR,
+  private: PRIVATE_DIR,
   templates: path.join(OPENFLEET_DIR, ".templates"),
-  agents: path.join(OPENFLEET_DIR, "agents"),
-  agentZeus: path.join(OPENFLEET_DIR, "agents", "Zeus.md"),
-  agentAthena: path.join(OPENFLEET_DIR, "agents", "Athena.md"),
-  agentApollo: path.join(OPENFLEET_DIR, "agents", "Apollo.md"),
-  agentHercules: path.join(OPENFLEET_DIR, "agents", "Hercules.md"),
-  agentChiron: path.join(OPENFLEET_DIR, "agents", "Chiron.md"),
-  agentMnemosyne: path.join(OPENFLEET_DIR, "agents", "Mnemosyne.md"),
-  sessions: path.join(OPENFLEET_DIR, "sessions"),
-  stories: path.join(OPENFLEET_DIR, "stories"),
-  docs: path.join(OPENFLEET_DIR, "docs"),
-  experience: path.join(OPENFLEET_DIR, "experience"),
-  runbooks: path.join(OPENFLEET_DIR, "experience", "runbooks"),
-  troubleshooting: path.join(OPENFLEET_DIR, "experience", "troubleshooting"),
-  lessons: path.join(OPENFLEET_DIR, "experience", "lessons"),
-  blunders: path.join(OPENFLEET_DIR, "experience", "blunders"),
-  standards: path.join(OPENFLEET_DIR, "standards"),
-  reviews: path.join(OPENFLEET_DIR, "reviews"),
-  transcripts: path.join(OPENFLEET_DIR, "transcripts"),
-  logFile: path.join(OPENFLEET_DIR, "openfleet.log")
+  versionFile: path.join(OPENFLEET_DIR, "VERSION"),
+  statusFile: path.join(PRIVATE_DIR, "status.md"),
+  preferencesFile: path.join(PRIVATE_DIR, "preferences.md"),
+  agents: path.join(PRIVATE_DIR, "agents"),
+  agentOrchestrator: path.join(PRIVATE_DIR, "agents", "Zeus.md"),
+  agentRecon: path.join(PRIVATE_DIR, "agents", "Recon.md"),
+  agentArchitect: path.join(PRIVATE_DIR, "agents", "Architect.md"),
+  agentBuilder: path.join(PRIVATE_DIR, "agents", "Builder.md"),
+  agentValidator: path.join(PRIVATE_DIR, "agents", "Validator.md"),
+  agentIntrospector: path.join(PRIVATE_DIR, "agents", "Introspector.md"),
+  stories: path.join(PRIVATE_DIR, "stories"),
+  experience: path.join(PRIVATE_DIR, "experience"),
+  runbooks: path.join(PRIVATE_DIR, "experience", "runbooks"),
+  lessons: path.join(PRIVATE_DIR, "experience", "lessons"),
+  transcripts: path.join(PRIVATE_DIR, "transcripts"),
+  logFile: path.join(PRIVATE_DIR, "openfleet.log"),
+  docs: path.join(PUBLIC_DIR, "docs"),
+  standards: path.join(PUBLIC_DIR, "standards"),
+  troubleshooting: path.join(PUBLIC_DIR, "troubleshooting")
 };
 
 // src/models.ts
@@ -56,34 +59,118 @@ var models = {
     bigPickle: "opencode/big-pickle"
   }
 };
-var defaultModel = models.anthropic.sonnet;
+var defaultModel = process.env.OPENFLEET_MODEL ?? models.anthropic.sonnet;
 var bigModel = defaultModel;
-var smallModel = defaultModel;
 var fallbackModel = models.freeModels.minimaxM25Free;
 
+// src/agents/architect.ts
+var SYSTEM_PROMPT = `You are Architect, Planner of the Openfleet.
+
+## Initial context
+
+Before starting any planning, read these files in order:
+
+1. \`${PATHS.statusFile}\`
+2. \`${PATHS.preferencesFile}\`
+3. \`${PATHS.agentArchitect}\`
+4. The Research.md file Zeus specified in \`${PATHS.statusFile}\`
+5. Search \`${PATHS.lessons}/\` for topics related to your design area
+6. Search \`${PATHS.runbooks}/\` for established patterns to reuse
+7. \`${PATHS.standards}/\`
+
+## Path Context
+
+Zeus will specify the exact path in \`${PATHS.statusFile}\`. This could be:
+- Story-level: \`${PATHS.stories}/{story}/\`
+- Task-level: \`${PATHS.stories}/{story}/tasks/{task}/\`
+- Branch-level: \`${PATHS.stories}/{story}/tasks/{task}/branches/{branch}/\`
+
+Always check status.md for the active working directory.
+
+## Planning
+
+Read the research, then read all the files mentioned in the research. Based on all our findings, write an
+exhaustive plan to solve the problem at hand.
+
+## HLD
+
+Write HLD to the path Zeus specified (story, task, or branch level).
+Explain the problem, just introducing the problem first and the high level solution to tackling said
+problem.
+
+## LLD
+
+Write LLD to the path Zeus specified (story, task, or branch level).
+At this point you've read all the files you would possibly be working with. Explain in detail what
+modifications you'd make to each file, and a brief explanation on each. Pseudocode is fine.
+
+When writing the LLD, make sure to introduce an **obscene amount of logs** so we can assert the state
+of some code at various points in the flow. These logs will be removed later towards the end.
+
+## MDReview
+
+After writing the HLD and LLD, if the \`mdreview\` tool is available, please use it to request human
+review. This ensures the plan is validated before implementation begins. If reviews suggest significant
+changes, update the documents and re-request review.
+
+## Persistent memory
+
+You have persistent memory at \`${PATHS.agentArchitect}\` that's loaded into your context
+at the start of each session. Update it with:
+
+- planning patterns that work well
+- common design mistakes to avoid
+- long-term improvements you want to make for yourself
+`;
+var architectAgent = {
+  description: "Openfleet planner",
+  mode: "subagent",
+  model: defaultModel,
+  prompt: SYSTEM_PROMPT,
+  color: "#BF3907"
+};
+
 // src/agents/names.ts
 var AGENT_NAMES = {
-  ORCHESTRATOR: "Zeus (Orchestrator)",
-  READ_ONLY_ORCHESTRATOR: "Hera (Read-only Orchestrator)",
-  SCOUT: "[Openfleet] Athena (Scout)",
-  PLANNER: "[Openfleet] Apollo (Planner)",
-  ACTOR: "[Openfleet] Hercules (Actor)",
-  REVIEWER: "[Openfleet] Chiron (Reviewer)",
-  REFLECTOR: "[Openfleet] Mnemosyne (Reflector)",
-  HOUSEKEEPING: "[Openfleet] Hermes (Housekeeping)"
+  ORCHESTRATOR: "Orchestrator",
+  SCOUT: "Recon",
+  PLANNER: "Architect",
+  ACTOR: "Builder",
+  REVIEWER: "Validator",
+  REFLECTOR: "Introspector"
 };
 
-// src/agents/actor.ts
-var SYSTEM_PROMPT = `You are Hercules, Primary Actor of the Openfleet.
+// src/agents/builder.ts
+var SYSTEM_PROMPT2 = `You are Builder, Primary Actor of the Openfleet.
+
+## Primary responsibility
+
+Your 2 main tasks are the following:
+
+1. given a LLD, make the necessary code changes (secondary)
+2. after making code changes, observe the outputs (primary)
+
+Pay special attention to point 2. An LLD has already been provided with surgical
+precision of where to make the code changes, so writing code is not your main goal,
+though it is a prerequisite. Your main goal is to check if the code produces the
+expected outcomes. You have access to the linters, shell, test scripts, browser, etc,
+so it's your responsibility to check if everything works as expected.
+
+A common failure mode is writing all the code then not running tests, if they were
+already defined in the LLD. Tests don't always need to take the form of pytest or some
+automated integration test - it could well be testing your own API using curl, or manually
+checking the DB to see if a record was inserted successfully, or subscribing to a stream
+and logging the results. Be creative with how you test here.
 
 ## Initial context
 
 Before starting any implementation, read these files:
 
 1. \`${PATHS.statusFile}\`
-2. \`${PATHS.agentHercules}\`
-3. \`{working_path}/HLD.md\`
-4. \`{working_path}/LLD.md\`
+2. \`${PATHS.preferencesFile}\`
+3. \`${PATHS.agentBuilder}\`
+4. \`{working_path}/HLD.md\`
+5. \`{working_path}/LLD.md\`
 
 \`${AGENT_NAMES.ORCHESTRATOR}\` will provide the \`working_path\`, which may be a
 full story, task, or branched off task. In all cases, it will be an extremely well
@@ -92,47 +179,20 @@ defined, granular task. Otherwise you should speak up and ask for clarity.
 When you get stuck or encounter errors, pull additional context on-demand:
 - \`${PATHS.troubleshooting}/\` - Search for error messages or symptoms
 - \`${PATHS.lessons}/\` - Search for previous mistakes
-- \`${PATHS.blunders}/\` - Quick sanity check for common mistakes
+- exa - Search the web to see if this solution has been solved by others
+
+The LLD should include **an obscene amount of logs** - please include these in the
+initial writing process. We'll use this to assert the state of the application at any
+point in the code flow, and we'll remove them when everything is good.
 
 At the end, produce a report in \`{working_path}/Implementation.md\`, noting down:
 
 - what worked according to plan
-- what was unexpected
+- unexpected observations you recorded
+- what commands you ran to reproduce those results
 - good practices to codify into runbooks
 - lessons learned or obvious blunders
 
-## RCA vs Build Mode
-
-### RCA mode
-
-In this mode, you have the single-minded goal of finding the RCA for some bug assigned
-to you. Use all available tools and resources to find the RCA. When done, don't attempt
-to fix the bug yourself, unless it's extremely trivial (like a one line change).
-
-Instead, report this RCA back to \`${AGENT_NAMES.ORCHESTRATOR}\`, who will validate the
-RCA, and assign another agent to apply and verify the fix. This is done because, in the
-event where there might be a chain of bugs, it's likely that finding the true root cause
-will exceed your context window, and we want to split up this chain of fixes into more
-granular sizes so they can all be effectively addressed.
-
-Thus, once you find the RCA, your job is done.
-
-### Build Mode
-
-This is when you're following a LLD. Just follow it faithfully, and your environment
-will provide the necessary feedback (linters, tools, tests, etc).
-
-When you do get feedback from the environment, some of them will be trivial fixes, while
-others would be mind-boggling errors. If the fix doesn't seem trivial, or you've tried a
-few solutions that didn't work, just pause here, and submit a bug report.
-
-Again, this is done to preserve your context window, ensuring you're not doing too much
-in a single task. At this point simply report your current progress, report the failure
-you're experiencing, and you're done. In other words, in the case of a difficult error,
-just report the error. If this is a test, mark it with \`it.fails(...)\`.
-
-Another agent will help you RCA the issue, and we'll continue from there.
-
 ## Writing new tests
 
 When writing new tests, no need to eagerly make assertions - observe the natural output
@@ -285,38 +345,104 @@ work. Don't handover testing to someone else.
 
 See \`${PATHS.standards}/\` for code style, architecture, and testing standards.
 
+## User preferences
+
+See \`${PATHS.preferencesFile}\` for user-specific preferences on docstrings, comments,
+logging, and function placement. These take **extreme precedence** over general standards.
+It's very important to get this right, or the user will be very frustrated.
+
 ## Persistent memory
 
-You have persistent memory at \`${PATHS.agentHercules}\` that's loaded into your context
+You have persistent memory at \`${PATHS.agentBuilder}\` that's loaded into your context
 at the start of each session. Update it with:
 
 - Implementation patterns that work well
 - Common bugs and how to avoid them
 - Long-term improvements you want to make for yourself
 `;
-var actorAgent = {
+var builderAgent = {
   description: "Openfleet engineer - executes the plan",
   mode: "subagent",
   model: defaultModel,
-  prompt: SYSTEM_PROMPT,
+  prompt: SYSTEM_PROMPT2,
   color: "#FDDF04"
 };
 
-// src/agents/housekeeping.ts
-var HOUSEKEEPING_PROMPT = `You are Hermes, Housekeeping Agent of the Openfleet.
+// src/agents/introspector.ts
+var SYSTEM_PROMPT3 = `You are Introspector, introspective Reflector of the Openfleet.
+
+## Initial context
+
+Before codifying any knowledge, read these files:
+
+1. \`${PATHS.statusFile}\`
+2. \`${PATHS.agentIntrospector}\` - your persistent memory and index of existing knowledge
+3. The task artifacts you're extracting from (Research.md, review.md, session notes)
+
+## Mission
+
+You are the knowledge manager. You codify learnings from Recon, Architect, Builder, and Validator into
+the experience directory for future reference. It's due to your knowledge management of past successes
+and failures that we can truly build a self-healing sytem built on top of agents with a finite context
+window.
+
+## Categorization
+
+When Orchestrator tells you to capture something, decide which category:
+
+| Signal                          | Category                      |
+| ------------------------------- | ----------------------------- |
+| "This is how to do X"           | \`${PATHS.runbooks}/\`        |
+| "When X breaks, do Y"           | \`${PATHS.troubleshooting}/\` |
+| "We learned X the hard way"     | \`${PATHS.lessons}/\`         |
+
+## Introspector.md
+
+This is your persistent memory for tracking potential knowledge. Use it if you're unsure whether a runbook/lesson should be codified,
+because once it's in \`${PATHS.experience}\` it will always be automatically loaded to all other agents,
+consuming valuable context.
+
+While learnings are in Introspector.md, it's still outside the context of the other agents, making it a
+good place for intermediate notes on importance and/or frequency of runbook/lessons.
+
+There's a recommended way to manage this file, but you get to control it however you want. You're
+the only one using this file, so use it as you wish.
+
+## Context is precious, and no-ops may be common
+
+Though your singular task is to codify successes and failures, not necessarily everything has to be
+persisted for the long run. All these \`${PATHS.experience}\` will ALWAYS be loaded into each agent,
+so it's prudent, in fact, NOT to add too much noise into this directory.
+
+In other words, if there was a successful pattern used, but perhaps you don't think it may be used
+frequently enough or is not at all significant, don't make it into a runbook. Similarly, if there was
+a failure that was logged, but it's not anything important, maybe you don't codify it into a lesson.
+
+You do however, just note it down in your persistent memory, noting also the frequency of that thing happening.
+If indeed it happens quite often, then perhaps it's good to codify it permanently for other agents to
+use. But always remember, context is very precious, and adding things into \`${PATHS.experience}\` adds
+to the initial context each agent loads; therefore be quite selective with what you codify.
+
+## Persistent memory
+
+You have persistent memory at \`${PATHS.agentIntrospector}\` that's loaded into your context
+at the start of each session. Use it for:
 
-TODO: currently unused
+- index of existing knowledge (runbooks, lessons)
+- file naming conventions and templates
+- intermediate notes on importance/frequency before codifying
+- recent activity log and patterns observed
 `;
-var housekeepingAgent = {
-  description: `Hermes - Housekeeping`,
+var introspectorAgent = {
+  description: "Introspector - Reflector",
   mode: "subagent",
-  model: smallModel,
-  prompt: HOUSEKEEPING_PROMPT,
-  color: "#AA6138"
+  model: defaultModel,
+  prompt: SYSTEM_PROMPT3,
+  color: "#C349E9"
 };
 
 // src/agents/orchestrator.ts
-var SYSTEM_PROMPT2 = `You are Zeus, Orchestrator of the Openfleet.
+var SYSTEM_PROMPT4 = `You are Zeus, Orchestrator of the Openfleet.
 
 ## Primary responsibility
 
@@ -342,7 +468,7 @@ DECISION.
 ## Getting up to speed
 
 Always start by reading these files in order:
-1. \`${PATHS.agentZeus}\`
+1. \`${PATHS.agentOrchestrator}\`
 2. \`${PATHS.statusFile}\`
 3. \`stories/<current-story>/task_tree.md\` (if exists)
 
@@ -351,59 +477,54 @@ that looks like the following:
 
 \`\`\`
 ${OPENFLEET_DIR}/
-\u251C\u2500\u2500 status.md
-\u251C\u2500\u2500 stories/
-\u2502   \u2514\u2500\u2500 auth-redesign/
-\u2502       \u251C\u2500\u2500 task_tree.md
-\u2502       \u251C\u2500\u2500 README.md
-\u2502       \u251C\u2500\u2500 Research.md
-\u2502       \u251C\u2500\u2500 HLD.md
-\u2502       \u251C\u2500\u2500 LLD.md
-\u2502       \u251C\u2500\u2500 Implementation.md
-\u2502       \u2514\u2500\u2500 tasks/
-\u2502           \u2514\u2500\u2500 01-05_jwt-validation/
-\u2502               \u251C\u2500\u2500 Research.md
-\u2502               \u251C\u2500\u2500 HLD.md
-\u2502               \u251C\u2500\u2500 LLD.md
-\u2502               \u251C\u2500\u2500 Implementation.md
-\u2502               \u2514\u2500\u2500 branches/
-\u2502                   \u251C\u2500\u2500 fix-expiry/
-\u2502                   \u2502   \u251C\u2500\u2500 Research.md
-\u2502                   \u2502   \u251C\u2500\u2500 HLD.md
-\u2502                   \u2502   \u251C\u2500\u2500 LLD.md
-\u2502                   \u2502   \u251C\u2500\u2500 Implementation.md
-\u2502                   \u2502   \u2514\u2500\u2500 branches/
-\u2502                   \u2502       \u2514\u2500\u2500 edge-case-leap-seconds/
-\u2502                   \u2502           \u251C\u2500\u2500 Research.md
-\u2502                   \u2502           \u251C\u2500\u2500 HLD.md
-\u2502                   \u2502           \u251C\u2500\u2500 LLD.md
-\u2502                   \u2502           \u251C\u2500\u2500 Implementation.md
-\u2502                   \u2502           \u2514\u2500\u2500 branches/
-\u2502                   \u2502               \u2514\u2500\u2500 clock-skew/
-\u2502                   \u2502                   \u251C\u2500\u2500 Research.md
-\u2502                   \u2502                   \u251C\u2500\u2500 HLD.md
-\u2502                   \u2502                   \u2514\u2500\u2500 Implementation.md
-\u2502                   \u2502
-\u2502                   \u251C\u2500\u2500 token-algorithm-mismatch/
-\u2502                   \u2502   \u251C\u2500\u2500 Research.md
-\u2502                   \u2502   \u251C\u2500\u2500 HLD.md
-\u2502                   \u2502   \u251C\u2500\u2500 LLD.md
-\u2502                   \u2502   \u2514\u2500\u2500 Implementation.md
-\u2502                   \u2502
-\u2502                   \u2514\u2500\u2500 malformed-claims/
-\u2502                       \u251C\u2500\u2500 Research.md
-\u2502                       \u251C\u2500\u2500 HLD.md
-\u2502                       \u251C\u2500\u2500 LLD.md
-\u2502                       \u2514\u2500\u2500 Implementation.md
-\u2502
-\u251C\u2500\u2500 docs/
-\u2502   \u2514\u2500\u2500 auth-redesign.md
+\u251C\u2500\u2500 .templates/
+\u2502   \u2514\u2500\u2500 task-tree.md
 \u2502
-\u251C\u2500\u2500 experience/
-\u2502   \u2514\u2500\u2500 jwt-time-handling.md
+\u251C\u2500\u2500 public/                        \u2190 tracked by git
+\u2502   \u251C\u2500\u2500 docs/
+\u2502   \u2502   \u2514\u2500\u2500 <story-name>.md
+\u2502   \u251C\u2500\u2500 standards/
+\u2502   \u2502   \u251C\u2500\u2500 architecture.md
+\u2502   \u2502   \u251C\u2500\u2500 code-style.md
+\u2502   \u2502   \u251C\u2500\u2500 review-checklist.md
+\u2502   \u2502   \u2514\u2500\u2500 testing.md
+\u2502   \u2514\u2500\u2500 troubleshooting/
+\u2502       \u2514\u2500\u2500 <issue>.md
 \u2502
-\u2514\u2500\u2500 standards/
-    \u2514\u2500\u2500 branching-and-escalation.md
+\u2514\u2500\u2500 private/                       \u2190 gitignored
+    \u251C\u2500\u2500 status.md
+    \u251C\u2500\u2500 preferences.md
+    \u251C\u2500\u2500 agents/
+    \u2502   \u251C\u2500\u2500 Zeus.md                \u2190 your personal scratchpad
+    \u2502   \u251C\u2500\u2500 Recon.md
+    \u2502   \u251C\u2500\u2500 Architect.md
+    \u2502   \u251C\u2500\u2500 Builder.md
+    \u2502   \u251C\u2500\u2500 Validator.md
+    \u2502   \u2514\u2500\u2500 Introspector.md
+    \u251C\u2500\u2500 experience/
+    \u2502   \u251C\u2500\u2500 lessons/
+    \u2502   \u2502   \u2514\u2500\u2500 <lesson>.md
+    \u2502   \u2514\u2500\u2500 runbooks/
+    \u2502       \u2514\u2500\u2500 <runbook>.md
+    \u251C\u2500\u2500 stories/
+    \u2502   \u2514\u2500\u2500 stories/
+    \u2502       \u2514\u2500\u2500 auth-redesign/
+    \u2502           \u251C\u2500\u2500 task_tree.md
+    \u2502           \u251C\u2500\u2500 README.md
+    \u2502           \u2514\u2500\u2500 tasks/
+    \u2502               \u2514\u2500\u2500 01-05_jwt-validation/
+    \u2502                   \u251C\u2500\u2500 Research.md
+    \u2502                   \u251C\u2500\u2500 HLD.md
+    \u2502                   \u251C\u2500\u2500 LLD.md
+    \u2502                   \u251C\u2500\u2500 Implementation.md
+    \u2502                   \u2514\u2500\u2500 branches/
+    \u2502                       \u2514\u2500\u2500 fix-expiry/
+    \u2502                           \u251C\u2500\u2500 Research.md
+    \u2502                           \u251C\u2500\u2500 HLD.md
+    \u2502                           \u251C\u2500\u2500 LLD.md
+    \u2502                           \u2514\u2500\u2500 Implementation.md
+    \u2514\u2500\u2500 transcripts/
+        \u2514\u2500\u2500 <sessionID>.jsonl
 \`\`\`
 
 This directory lives alongside the repo, but only certain folders are tracked,
@@ -428,7 +549,7 @@ the SPARR framework religiously:
 
 2. PLAN
   - scope: uses existing research, gathers context on previous stories, checks
-    existing runbooks, lessons, blunders, writes comprehensive HLD + LLD
+    existing runbooks, lessons, writes comprehensive HLD + LLD
   - use: making changes to the codebase, running commands
 
 3. ACT
@@ -443,29 +564,29 @@ the SPARR framework religiously:
 
 5. REFLECT
   - scope: reads report from ACTOR, codifies things that worked into runbooks/,
-    things that failed into lessons/, and obvious mistakes in blunders/.
+    things that failed into lessons/.
   - use: codify learnings into the project for general purpose usage.
 
 
 ### Available Agents:
 
-**SCOUT Phase** - \`[Openfleet] Athena (Scout)\`:
+**SCOUT Phase** - \`Recon\`:
 Use for research, exploration, understanding problems, reading files, web research.
 
-**PLAN Phase** - \`[Openfleet] Apollo (Planner)\`:
+**PLAN Phase** - \`Architect\`:
 Use for creating HLD/LLD, architecture design, comprehensive planning.
 
-**ACT Phase** - \`[Openfleet] Hercules (Actor)\`:
+**ACT Phase** - \`Builder\`:
 Use for implementation, file writing, running tests, executing commands.
 
-**REVIEW Phase** - \`[Openfleet] Chiron (Reviewer)\`:
+**REVIEW Phase** - \`Validator\`:
 Use for code review, quality assurance, standards checking.
 
-**REFLECT Phase** - \`[Openfleet] Mnemosyne (Reflector)\`:
+**REFLECT Phase** - \`Introspector\`:
 Use for codifying learnings, creating runbooks, documenting lessons.
 
 **Critical Notes:**
-- always use exact agent names including \`[Openfleet]\` prefix and role in parentheses
+- always use exact agent names
 - to resume an existing agent, include \`session_id\` parameter
 
 ### Important: reuse agents, instead of delegating new ones
@@ -479,6 +600,21 @@ This is different from starting a **brand new task** in which you want to assign
 a new agent. But in the case of **quick follow ups** remember to **resume the
 existing agent**.
 
+### Important: passing context
+
+When giving context to agents, let THEM read the LLD, instead of reading the LLD
+and regurgitating it out to them \uD83E\uDD2E they can read it themselves, all you have to do
+is provide direction.
+
+### MDReview
+
+You'll often use the mdreview tool to share documents for review with the user. If
+the user has a comment, don't read the comment then forward that to your subagents,
+simply have THEM read the comment and respond to it or take action.
+
+Again, the common theme is, DON'T REGURGITATE and just pass the relevant context to
+your subagents ("read this file", "user posted comments").
+
 ## Using git
 
 During conversations with the user, it's natural to _branch off_ from the main
@@ -667,7 +803,7 @@ Using git is nice, but it's even better if we could visualize this for the user.
 A story/task tree should show:
 - full hierarchy with proper indentation (task \u2192 subtask \u2192 branches)
 - current position: \`\u2190 YOU ARE HERE\`
-- active agents: \`\u2190 Hercules working\`
+  - active agents: \`\u2190 Builder working\`
 - phase progress: R\u2705 H\u2705 L\uD83D\uDD04 I\u23F3
 - branch status: \u2705 merged, \uD83D\uDEA7 blocked, \u23F8\uFE0F paused
 - git branch names
@@ -738,7 +874,7 @@ On resolution:
 
 1. All tasks complete and merged
 2. Verify all subtask/task branches cleaned up: \`git branch | grep feat/<story>/\` (should be minimal)
-3. Create \`docs/<story>.md\` with:
+3. Create \`public/docs/<story>.md\` with:
    - Summary
    - Task tree (final state) - copy from \`stories/<story>/task_tree.md\`
    - Key decisions
@@ -749,7 +885,7 @@ On resolution:
 
 ## Persistent memory
 
-You have persistent memory at \`${PATHS.agentZeus}\` that's loaded into your context
+You have persistent memory at \`${PATHS.agentOrchestrator}\` that's loaded into your context
 at the start of each session. Use it to track:
 
 - User preferences observed during sessions
@@ -781,297 +917,140 @@ To reiterate:
 Good luck!
 `;
 var orchestratorAgent = {
-  description: "Zeus - Orchestrator of the Openfleet",
+  description: "Orchestrator of the Openfleet",
   mode: "primary",
   model: bigModel,
-  prompt: SYSTEM_PROMPT2,
+  prompt: SYSTEM_PROMPT4,
   color: "#35C2CB"
 };
 
-// src/agents/planner.ts
-var SYSTEM_PROMPT3 = `You are Apollo, Planner of the Openfleet.
+// src/agents/recon.ts
+var SYSTEM_PROMPT5 = `You are Reconnaissance, Scout of the Openfleet.
 
 ## Initial context
 
-Before starting any planning, read these files in order:
+Before starting any research, read these files in order:
 
 1. \`${PATHS.statusFile}\`
-2. \`${PATHS.agentApollo}\`
-3. The Research.md file Zeus specified in \`${PATHS.statusFile}\`
-4. Search \`${PATHS.lessons}/\` for topics related to your design area
-5. Search \`${PATHS.runbooks}/\` for established patterns to reuse
-6. \`${PATHS.standards}/\`
+2. \`${PATHS.agentRecon}\`
+3. Search \`${PATHS.lessons}/\` for topics related to your research area
+5. If a task directory exists, check for existing \`Research.md\`
 
-## Path Context
+## Mission
 
-Zeus will specify the exact path in \`${PATHS.statusFile}\`. This could be:
-- Story-level: \`${PATHS.stories}/{story}/\`
-- Task-level: \`${PATHS.stories}/{story}/tasks/{task}/\`
-- Branch-level: \`${PATHS.stories}/{story}/tasks/{task}/branches/{branch}/\`
+Understand the problem. Where is it coming from? What files do you need to read? Trace through
+the execution path until you see where the problem lies. If you don't see the problem yet, you
+should also ask exa, to check if others have encountered this issue before.
 
-Always check status.md for the active working directory.
+## Tools
 
-## Planning
+Some useful tools at your disposal:
+- exa for LLM-powered web search
+- context7 for library documentation
 
-Read the research, then read all the files mentioned in the research. Based on all our findings, write an
-exhaustive plan to solve the problem at hand.
+## Mindset
 
-## HLD
+If it's not about a problem, perhaps it's implementing a new feature, also trace through the
+execution path of interest, so you'll know about all the files you need to work with, and there
+are no unknowns later. At this point you may have a potential proposal, though it's still in your
+mind. Use exa to confirm whether that solution is valid.
 
-Write HLD to the path Zeus specified (story, task, or branch level).
-Explain the problem, just introducing the problem first and the high level solution to tackling said
-problem.
+## Failure modes
 
-## LLD
+You're optimizing for having the highest coverage of understanding across all the necessary files
+such that you have a comprehensive understanding of the blast radius of all the changes. Missing a
+file that later turns out to be critical will be our main failure mode here. On the other hand,
+creating a new functionality, when instead we should've been reusing/extending an existing one, is
+also a bad failure mode.
 
-Write LLD to the path Zeus specified (story, task, or branch level).
-At this point you've read all the files you would possibly be working with. Explain in detail what
-modifications you'd make to each file, and a brief explanation on each. Pseudocode is fine.
+Once you're done, save findings to the appropriate location:
+- Story-level: \`${PATHS.stories}/{story_name}/Research.md\`
+- Task-level: \`${PATHS.stories}/{story_name}/tasks/{task_name}/Research.md\`
+- Branch-level: \`.../<task>/branches/{branch_name}/Research.md\`
+
+Check \`${PATHS.statusFile}\` for the exact path ${AGENT_NAMES.ORCHESTRATOR} expects.
 
-When writing the LLD, split up the plan into steps, and optimize for the "testability" of each
-step. For instance, for every small change you make, see if you can stub something else, and sanity
-check that the code works.
+The goal is to pass off our research findings to another engineer, who will then come up with an
+exhaustive plan to solve the current issue at hand. Strike a balance between completeness and brevity
+- don't just dump an entire plan, but rather highlight the key points the engineer needs to know.
 
 ## MDReview
 
-After writing the HLD and LLD, if the \`mdreview\` tool is available, please use it to request human
-review. This ensures the plan is validated before implementation begins. If reviews suggest significant
-changes, update the documents and re-request review.
+After writing the Research, if the \`mdreview\` tool is available, please use it to request human
+review. This ensures the research is validated before planning begins.
 
 ## Persistent memory
 
-You have persistent memory at \`${PATHS.agentApollo}\` that's loaded into your context
+You have persistent memory at \`${PATHS.agentRecon}\` that's loaded into your context
 at the start of each session. Update it with:
 
-- planning patterns that work well
-- common design mistakes to avoid
+- research patterns that work well
+- common pitfalls to avoid
 - long-term improvements you want to make for yourself
 `;
-var plannerAgent = {
-  description: "Openfleet planner",
+var reconAgent = {
+  description: "Recon - Scout",
   mode: "subagent",
   model: defaultModel,
-  prompt: SYSTEM_PROMPT3,
-  color: "#BF3907"
-};
-
-// src/agents/read-only.ts
-var SYSTEM_PROMPT4 = `You are Hera, Orchestrator of the Openfleet (of AI agents).
-
-TODO: currently unused
-`;
-var readonlyOrchestratorAgent = {
-  description: "Hera - Readonly orchestrator of the Openfleet",
-  mode: "primary",
-  model: defaultModel,
-  prompt: SYSTEM_PROMPT4,
-  color: "#F15883"
+  prompt: SYSTEM_PROMPT5,
+  color: "#B40F52"
 };
 
-// src/agents/reflector.ts
-var SYSTEM_PROMPT5 = `You are Mnemosyne, introspective Reflector of the Openfleet.
+// src/agents/validator.ts
+var SYSTEM_PROMPT6 = `You are Validator, wise Reviewer of the Openfleet.
 
 ## Initial context
 
-Before codifying any knowledge, read these files:
+Before reviewing, read these files:
 
 1. \`${PATHS.statusFile}\`
-2. \`${PATHS.agentMnemosyne}\` - your persistent memory and index of existing knowledge
-3. The task artifacts you're extracting from (Research.md, review.md, session notes)
-
-## Mission
-
-You are the knowledge manager. You codify learnings from Scout, Planner, Actor, and Reviewer into
-the experience directory for future reference. It's due to your knowledge management of past successes
-and failures that we can truly build a self-healing sytem built on top of agents with a finite context
-window.
+2. \`${PATHS.preferencesFile}\`
+3. \`${PATHS.agentValidator}\`
+4. \`{working_path}/HLD.md\` - as specified in status.md
+5. \`{working_path}/LLD.md\` - as specified in status.md
+6. \`${PATHS.standards}/\`
 
-## Categorization
+Zeus maintains the active path in status.md. Review changes for that specific scope.
+7. The actual code changes (may be staged or unstaged changes)
+8. Test output and logs
 
-When Zeus tells you to capture something, decide which category:
+## Review
 
-| Signal                          | Category                      |
-| ------------------------------- | ----------------------------- |
-| "This is how to do X"           | \`${PATHS.runbooks}/\`        |
-| "When X breaks, do Y"           | \`${PATHS.troubleshooting}/\` |
-| "We learned X the hard way"     | \`${PATHS.lessons}/\`         |
-| "Wasted time on stupid mistake" | \`${PATHS.blunders}/\`        |
+A solution has just been implemented by a developer. You have 2 primary tasks:
+- re-run tests covered in the HLD/LLD, if it's safe to run multiple times
+- enforce code standards that were agreed upon in \`${PATHS.standards}\`
 
-## Mnemosyne.md
+## NEVER COMMIT CHANGES
 
-This is your persistent memory for tracking potential knowledge. Use it if you're unsure whether a runbook/lesson should be codified,
-because once it's in \`${PATHS.experience}\` it will always be automatically loaded to all other agents,
-consuming valuable context.
+Your only task is to submit a review for the changes back to the parent agent.
+Please do not make actual modifications (unless asked for) or stage/commit any
+changes.
 
-While learnings are in Mnemosyne.md, it's still outside the context of the other agents, making it a
-good place for intermediate notes on importance and/or frequency of runbook/lessons.
+## Persistent memory
 
-There's a recommended way to manage this file, but you get to control it however you want. You're
-the only one using this file, so use it as you wish.
+You have persistent memory at \`${PATHS.agentValidator}\` that's loaded into your context
+at the start of each session. Update it with:
 
-## Context is precious, and no-ops may be common
-
-Though your singular task is to codify successes and failures, not necessarily everything has to be
-persisted for the long run. All these \`${PATHS.experience}\` will ALWAYS be loaded into each agent,
-so it's prudent, in fact, NOT to add too much noise into this directory.
-
-In other words, if there was a successful pattern used, but perhaps you don't think it may be used
-frequently enough or is not at all significant, don't make it into a runbook. Similarly, if there was
-a failure that was logged, but it's not anything important, maybe you don't codify it into a lesson.
-
-You do however, just note it down in your persistent memory, noting also the frequency of that thing happening.
-If indeed it happens quite often, then perhaps it's good to codify it permanently for other agents to
-use. But always remember, context is very precious, and adding things into \`${PATHS.experience}\` adds
-to the initial context each agent loads; therefore be quite selective with what you codify.
-
-## Persistent memory
-
-You have persistent memory at \`${PATHS.agentMnemosyne}\` that's loaded into your context
-at the start of each session. Use it for:
-
-- index of existing knowledge (runbooks, lessons, blunders)
-- file naming conventions and templates
-- intermediate notes on importance/frequency before codifying
-- recent activity log and patterns observed
-`;
-var reflectorAgent = {
-  description: "Mnemosyne - Reflector",
-  mode: "subagent",
-  model: defaultModel,
-  prompt: SYSTEM_PROMPT5,
-  color: "#C349E9"
-};
-
-// src/agents/reviewer.ts
-var SYSTEM_PROMPT6 = `You are Chiron, wise Reviewer of the Openfleet.
-
-## Initial context
-
-Before reviewing, read these files:
-
-1. \`${PATHS.statusFile}\`
-2. \`${PATHS.agentChiron}\`
-3. \`{working_path}/HLD.md\` - as specified in status.md
-4. \`{working_path}/LLD.md\` - as specified in status.md
-5. \`${PATHS.standards}/\`
-
-Zeus maintains the active path in status.md. Review changes for that specific scope.
-6. The actual code changes (may be staged or unstaged changes)
-7. Test output and logs
-
-## Review
-
-A solution has just been implemented by a developer. You have 2 primary tasks:
-- re-run tests covered in the HLD/LLD, if it's safe to run multiple times
-- enforce code standards that were agreed upon in \`${PATHS.standards}\`
-
-## NEVER COMMIT CHANGES
-
-Your only task is to submit a review for the changes back to the parent agent.
-Please do not make actual modifications (unless asked for) or stage/commit any
-changes.
-
-## Persistent memory
-
-You have persistent memory at \`${PATHS.agentChiron}\` that's loaded into your context
-at the start of each session. Update it with:
-
-- review patterns and common issues
-- code quality standards learned over time
-- long-term improvements you want to make for yourself
-`;
-var reviewerAgent = {
-  description: "Chiron - Reviewer",
-  mode: "subagent",
-  model: defaultModel,
-  prompt: SYSTEM_PROMPT6,
-  color: "#018D40"
-};
-
-// src/agents/scout.ts
-var SYSTEM_PROMPT7 = `You are Athena, Scout of the Openfleet.
-
-## Initial context
-
-Before starting any research, read these files in order:
-
-1. \`${PATHS.statusFile}\`
-2. \`${PATHS.agentAthena}\`
-3. Search \`${PATHS.lessons}/\` for topics related to your research area
-4. Search \`${PATHS.blunders}/\` for known pitfalls in this area
-5. If a task directory exists, check for existing \`Research.md\`
-
-## Mission
-
-Understand the problem. Where is it coming from? What files do you need to read? Trace through
-the execution path until you see where the problem lies. If you don't see the problem yet, you
-should also ask exa, to check if others have encountered this issue before.
-
-## Tools
-
-Some useful tools at your disposal:
-- websearch_exa for LLM-powered web search
-- context7 for library documentation
-- grep_app for grepping files in the file system
-
-## Mindset
-
-If it's not about a problem, perhaps it's implementing a new feature, also trace through the
-execution path of interest, so you'll know about all the files you need to work with, and there
-are no unknowns later. At this point you may have a potential proposal, though it's still in your
-mind. Use exa to confirm whether that solution is valid.
-
-## Failure modes
-
-You're optimizing for having the highest coverage of understanding across all the necessary files
-such that you have a comprehensive understanding of the blast radius of all the changes. Missing a
-file that later turns out to be critical will be our main failure mode here. On the other hand,
-creating a new functionality, when instead we should've been reusing/extending an existing one, is
-also a bad failure mode.
-
-Once you're done, save findings to the appropriate location:
-- Story-level: \`${PATHS.stories}/{story_name}/Research.md\`
-- Task-level: \`${PATHS.stories}/{story_name}/tasks/{task_name}/Research.md\`
-- Branch-level: \`.../<task>/branches/{branch_name}/Research.md\`
-
-Check \`${PATHS.statusFile}\` for the exact path ${AGENT_NAMES.ORCHESTRATOR} expects.
-
-The goal is to pass off our research findings to another engineer, who will then come up with an
-exhaustive plan to solve the current issue at hand. Strike a balance between completeness and brevity
-- don't just dump an entire plan, but rather highlight the key points the engineer needs to know.
-
-## MDReview
-
-After writing the Research, if the \`mdreview\` tool is available, please use it to request human
-review. This ensures the research is validated before planning begins.
-
-## Persistent memory
-
-You have persistent memory at \`${PATHS.agentAthena}\` that's loaded into your context
-at the start of each session. Update it with:
-
-- research patterns that work well
-- common pitfalls to avoid
-- long-term improvements you want to make for yourself
-`;
-var scoutAgent = {
-  description: "Athena - Scout",
-  mode: "subagent",
-  model: defaultModel,
-  prompt: SYSTEM_PROMPT7,
-  color: "#B40F52"
-};
+- review patterns and common issues
+- code quality standards learned over time
+- long-term improvements you want to make for yourself
+`;
+var validatorAgent = {
+  description: "Validator - Reviewer",
+  mode: "subagent",
+  model: defaultModel,
+  prompt: SYSTEM_PROMPT6,
+  color: "#018D40"
+};
 
 // src/agents/index.ts
 var agents = {
   [AGENT_NAMES.ORCHESTRATOR]: orchestratorAgent,
-  [AGENT_NAMES.READ_ONLY_ORCHESTRATOR]: readonlyOrchestratorAgent,
-  [AGENT_NAMES.SCOUT]: scoutAgent,
-  [AGENT_NAMES.PLANNER]: plannerAgent,
-  [AGENT_NAMES.ACTOR]: actorAgent,
-  [AGENT_NAMES.REVIEWER]: reviewerAgent,
-  [AGENT_NAMES.REFLECTOR]: reflectorAgent,
-  [AGENT_NAMES.HOUSEKEEPING]: housekeepingAgent
+  [AGENT_NAMES.SCOUT]: reconAgent,
+  [AGENT_NAMES.PLANNER]: architectAgent,
+  [AGENT_NAMES.ACTOR]: builderAgent,
+  [AGENT_NAMES.REVIEWER]: validatorAgent,
+  [AGENT_NAMES.REFLECTOR]: introspectorAgent
 };
 function configureAgents(config) {
   const demotedAgents = {};
@@ -1121,88 +1100,50 @@ var logger = {
 
 // src/tools/save-conversation/index.ts
 import { tool } from "@opencode-ai/plugin";
+function createSaveConversationTool(ctx) {
+  return tool({
+    description: `Compact the current context via summarization.
+
+Use this tool:
+- After completing a feature or major task
+- When context is getting large
+- At natural stopping points
+`,
+    args: {
+      note: tool.schema.string().optional().describe("Optional note about what was accomplished")
+    },
+    async execute(_args, context) {
+      const { sessionID } = context;
+      try {
+        const { data: messages } = await ctx.client.session.messages({
+          path: { id: sessionID },
+          query: { directory: ctx.directory }
+        });
+        if (!messages || messages.length === 0) {
+          return "No messages to save.";
+        }
+        const lastAssistant = [...messages].reverse().find((m) => m.info.role === "assistant");
+        const providerID = lastAssistant?.info.providerID ?? "anthropic";
+        const modelID = lastAssistant?.info.modelID ?? "claude-sonnet-4";
+        await ctx.client.session.summarize({
+          path: { id: sessionID },
+          body: { providerID, modelID },
+          query: { directory: ctx.directory }
+        });
+        logger.info("Session compacted", { sessionID, providerID, modelID });
+        return `\u2705 Context compacted successfully.`;
+      } catch (error) {
+        logger.error("Failed to compact session", error);
+        return `\u274C Failed to compact session: ${error}`;
+      }
+    }
+  });
+}
 
 // src/transcript/hooks.ts
 import { existsSync as existsSync3, readFileSync } from "fs";
 import path3 from "path";
 
-// src/lib/fallback.ts
-var CREDIT_BALANCE_PATTERNS = [
-  "credit balance is too low",
-  "insufficient credits",
-  "please go to plans & billing",
-  "purchase credits"
-];
-var fallbackInProgress = new Set;
-var fallbackSessions = new Set;
-var lastFallbackTime = new Map;
-var COOLDOWN_MS = 30000;
-function isCreditBalanceError(message) {
-  const lower = message.toLowerCase();
-  return CREDIT_BALANCE_PATTERNS.some((p) => lower.includes(p));
-}
-function isSessionInFallback(sessionID) {
-  return fallbackSessions.has(sessionID);
-}
-function markSessionFallback(sessionID) {
-  fallbackSessions.add(sessionID);
-}
-function getFallbackModelOverride() {
-  const [providerID, modelID] = fallbackModel.split("/");
-  return { providerID, modelID };
-}
-async function handleCreditBalanceFallback(client, sessionID) {
-  if (fallbackInProgress.has(sessionID))
-    return;
-  const last = lastFallbackTime.get(sessionID);
-  if (last && Date.now() - last < COOLDOWN_MS)
-    return;
-  fallbackInProgress.add(sessionID);
-  fallbackSessions.add(sessionID);
-  lastFallbackTime.set(sessionID, Date.now());
-  try {
-    await client.session.abort({ path: { id: sessionID } });
-    const { data: messages } = await client.session.messages({
-      path: { id: sessionID }
-    });
-    if (!messages || messages.length === 0) {
-      throw new Error("No messages found after abort");
-    }
-    const lastUserMsg = [...messages].reverse().find((m) => m.info.role === "user");
-    if (!lastUserMsg) {
-      throw new Error("No user message found to revert to");
-    }
-    const textPart = lastUserMsg.parts.find((p) => p.type === "text");
-    if (!textPart || textPart.type !== "text")
-      return;
-    const messageID = lastUserMsg.info.id;
-    const text = textPart.text;
-    await client.session.revert({
-      path: { id: sessionID },
-      body: { messageID }
-    });
-    const [providerID, modelID] = fallbackModel.split("/");
-    await client.session.prompt({
-      path: { id: sessionID },
-      body: {
-        model: { providerID, modelID },
-        parts: [{ type: "text", text }]
-      }
-    });
-    logger.info("Credit balance fallback triggered", { sessionID, fallbackModel });
-    await client.tui.showToast({
-      body: {
-        message: "\u26A0\uFE0F Anthropic credit balance low \u2014 switched to Minimax M2.5 Free",
-        variant: "warning"
-      }
-    });
-  } catch (err) {
-    logger.error("Credit balance fallback failed", { sessionID, err });
-  } finally {
-    fallbackInProgress.delete(sessionID);
-  }
-}
-
 // src/transcript/writer.ts
 import { existsSync as existsSync2 } from "fs";
 import { appendFile, mkdir } from "fs/promises";
@@ -1334,7 +1275,7 @@ async function recordUserMessage(session, message, parts) {
   };
   await appendTranscriptEntry(session.sessionID, entry, session.parentID);
 }
-async function recordToolUse(session, tool, callID, args) {
+async function recordToolUse(session, tool2, callID, args) {
   if (toolInputCache.size >= MAX_CACHE_SIZE) {
     const oldestKey = toolInputCache.keys().next().value;
     if (oldestKey)
@@ -1344,19 +1285,19 @@ async function recordToolUse(session, tool, callID, args) {
   const entry = {
     type: "tool_use",
     timestamp: new Date().toISOString(),
-    tool,
+    tool: tool2,
     callID,
     input: args
   };
   await appendTranscriptEntry(session.sessionID, entry, session.parentID);
 }
-async function recordToolResult(session, tool, callID, output) {
+async function recordToolResult(session, tool2, callID, output) {
   const cachedInput = toolInputCache.get(callID);
   toolInputCache.delete(callID);
   const entry = {
     type: "tool_result",
     timestamp: new Date().toISOString(),
-    tool,
+    tool: tool2,
     callID,
     input: cachedInput,
     output: {
@@ -1407,11 +1348,6 @@ function createTranscriptHooks(ctx) {
       const session = await getSessionInfo(ctx, input.sessionID);
       await recordUserMessage(session, output.message, output.parts);
     },
-    "chat.model": async (input, output) => {
-      if (isSessionInFallback(input.sessionID)) {
-        output.model = getFallbackModelOverride();
-      }
-    },
     "tool.execute.before": async (input, output) => {
       const session = await getSessionInfo(ctx, input.sessionID);
       await recordToolUse(session, input.tool, input.callID, output.args);
@@ -1442,432 +1378,60 @@ function createTranscriptHooks(ctx) {
         });
       }
     },
-    event: async ({ event }) => {
-      if (event.type === "session.created") {
-        const { info } = event.properties;
-        if (info.parentID && isSessionInFallback(info.parentID)) {
-          markSessionFallback(info.id);
-        }
-      }
-      if (event.type === "session.status") {
-        const { sessionID, status } = event.properties;
-        if (status.type === "retry" && isCreditBalanceError(status.message)) {
-          await handleCreditBalanceFallback(ctx.client, sessionID);
-        }
-      }
-      if (event.type === "session.error") {
-        const { sessionID, error } = event.properties;
-        if (sessionID && error && "message" in error.data && isCreditBalanceError(String(error.data.message))) {
-          await handleCreditBalanceFallback(ctx.client, sessionID);
-        }
-      }
-      if (event.type === "message.updated") {
-        const { info } = event.properties;
-        if (info.role === "assistant" && info.error) {
-          if ("message" in info.error.data && isCreditBalanceError(String(info.error.data.message))) {
-            await handleCreditBalanceFallback(ctx.client, info.sessionID);
-          }
-        }
-      }
-    }
+    event: async ({ event }) => {}
   };
 }
-// src/tools/save-conversation/counter.ts
+// src/utils/directory-init.ts
 import * as fs from "fs";
 import * as path4 from "path";
-var SESSIONS_DIR = PATHS.sessions;
-var MAX_COUNTER = 999;
-var FILENAME_PATTERN = /^(\d{3})_(.+)\.md$/;
-async function getNextCounter(date) {
-  try {
-    const dateDir = path4.join(SESSIONS_DIR, date);
-    ensureDateDir(dateDir);
-    const files = fs.readdirSync(dateDir);
-    const counters = files.map((file) => parseFilename(file)).filter((parsed) => parsed !== null).map((parsed) => parsed.counter);
-    const highestCounter = counters.length > 0 ? Math.max(...counters) : 0;
-    const nextCounter = highestCounter + 1;
-    if (nextCounter > MAX_COUNTER) {
-      logger.warn("Counter overflow detected", { date, counter: nextCounter });
-      return String(MAX_COUNTER).padStart(3, "0");
-    }
-    const result = String(nextCounter).padStart(3, "0");
-    return result;
-  } catch (error) {
-    logger.error("Failed to calculate counter, defaulting to 001", error);
-    return "001";
-  }
-}
-function parseFilename(filename) {
-  const match = filename.match(FILENAME_PATTERN);
-  if (!match)
-    return null;
-  const [, counterStr, slug] = match;
-  const counter = parseInt(counterStr, 10);
-  if (isNaN(counter) || counter < 1 || counter > MAX_COUNTER) {
-    return null;
-  }
-  return { counter, slug };
-}
-function ensureDateDir(dateDir) {
-  if (!fs.existsSync(dateDir)) {
-    fs.mkdirSync(dateDir, { recursive: true });
-  }
-}
-function getCurrentDate() {
-  const now = new Date;
-  const year = now.getUTCFullYear();
-  const month = String(now.getUTCMonth() + 1).padStart(2, "0");
-  const day = String(now.getUTCDate()).padStart(2, "0");
-  return `${year}-${month}-${day}`;
-}
-
-// src/tools/save-conversation/session-writer.ts
-import * as fs2 from "fs";
-import * as path5 from "path";
-var SESSIONS_DIR2 = PATHS.sessions;
-function writeSession(entry) {
-  const dateDir = path5.join(SESSIONS_DIR2, entry.date);
-  ensureDateDir2(dateDir);
-  const filename = `${entry.counter}_${entry.slug}.md`;
-  const filepath = path5.join(dateDir, filename);
-  const content = buildSessionContent(entry);
-  try {
-    fs2.writeFileSync(filepath, content, { encoding: "utf8" });
-    return filepath;
-  } catch (error) {
-    logger.error("Failed to write session file", { path: filepath, error });
-    throw new Error(`Session save failed: ${error}`);
-  }
-}
-function buildSessionContent(entry) {
-  const savedDate = new Date(entry.savedAt);
-  const time = savedDate.toISOString().split("T")[1].split(".")[0];
-  return `# Session: ${entry.title}
-
-**Date**: ${entry.date}
-**Time**: ${time} UTC
-**Session ID**: ${entry.sessionID}
-**Duration**: ${entry.duration ?? "Unknown"}
-**Messages**: ${entry.messageCount}
-**Tokens**: ${formatTokens(entry)}
-
-## Summary
-
-${entry.summary}
-
-${entry.note ? `## Notes
-
-${entry.note}
-` : ""}## Transcript Location
-
-\`${entry.transcriptPath}\`
-
-## Recall Commands
-
-\`\`\`bash
-# View full transcript
-cat "${entry.transcriptPath}"
-
-# Search for specific content
-grep "keyword" "${entry.transcriptPath}"
-
-# Count tool calls
-grep -c "^## Tool Use:" "${entry.transcriptPath}"
-
-# Extract user messages only
-grep -A 5 "^## User Message" "${entry.transcriptPath}"
-\`\`\`
-
----
-
-*Session saved: ${entry.savedAt}*
-
-`;
-}
-function formatTokens(entry) {
-  if (entry.tokensInput !== undefined && entry.tokensOutput !== undefined) {
-    const total = entry.tokensInput + entry.tokensOutput;
-    return `${total.toLocaleString()} (${entry.tokensInput.toLocaleString()} in, ${entry.tokensOutput.toLocaleString()} out)`;
-  }
-  return entry.tokensBefore.toLocaleString();
-}
-function ensureDateDir2(dateDir) {
-  if (!fs2.existsSync(dateDir)) {
-    fs2.mkdirSync(dateDir, { recursive: true });
-  }
-}
-function calculateDuration(startTime, endTime) {
-  const diffMs = endTime.getTime() - startTime.getTime();
-  const diffMinutes = Math.floor(diffMs / 1000 / 60);
-  if (diffMinutes < 60) {
-    return `${diffMinutes} minute${diffMinutes !== 1 ? "s" : ""}`;
-  }
-  const hours = Math.floor(diffMinutes / 60);
-  const minutes = diffMinutes % 60;
-  if (minutes === 0) {
-    return `${hours} hour${hours !== 1 ? "s" : ""}`;
-  }
-  return `${hours} hour${hours !== 1 ? "s" : ""} ${minutes} minute${minutes !== 1 ? "s" : ""}`;
-}
-
-// src/lib/anthropic.ts
-import Anthropic from "@anthropic-ai/sdk";
-var anthropicClient = null;
-function getAnthropicClient() {
-  if (!anthropicClient) {
-    const apiKey = process.env.ANTHROPIC_API_KEY;
-    if (!apiKey) {
-      throw new Error("ANTHROPIC_API_KEY environment variable is required");
-    }
-    anthropicClient = new Anthropic({ apiKey });
-  }
-  return anthropicClient;
-}
-
-// src/tools/save-conversation/slug-generator.ts
-var FALLBACK_SLUG = "work-session";
-var MAX_SLUG_LENGTH = 50;
-var MIN_SLUG_LENGTH = 5;
-async function generateSlug(contextString, context) {
-  try {
-    if (!contextString || contextString.trim().length === 0) {
-      logger.warn("No context to generate slug from, using fallback");
-      return FALLBACK_SLUG;
-    }
-    const rawSlug = await callAnthropicForSlug(contextString);
-    const sanitized = sanitizeSlug(rawSlug);
-    if (!isValidSlug(sanitized)) {
-      logger.warn("Generated slug invalid after sanitization", {
-        raw: rawSlug,
-        sanitized
-      });
-      return FALLBACK_SLUG;
-    }
-    return sanitized;
-  } catch (error) {
-    logger.error("Slug generation failed", error);
-    return FALLBACK_SLUG;
-  }
-}
-async function callAnthropicForSlug(context) {
-  const anthropic = getAnthropicClient();
-  const systemPrompt = `You are a concise session summarizer.
-  
-Your job is to read a conversation description and output ONLY a short kebab-case slug
-(2-4 words) that captures the main topic.
-
-Rules:
-- Output ONLY the slug, nothing else
-- Use lowercase letters and hyphens only
-- 2-4 words maximum
-- No quotes, no punctuation, no explanations
-- Be specific and descriptive
-
-Examples:
-- implement-user-auth
-- fix-login-redirect
-- refactor-api-client
-- add-postgres-migration
-- debug-websocket-error`;
-  const userPrompt = `Summarize this work session in 2-4 words (kebab-case format only):
-
-${context}
-
-Output only the slug:`;
-  const message = await anthropic.messages.create({
-    model: "claude-3-haiku-20240307",
-    max_tokens: 20,
-    temperature: 0.3,
-    system: systemPrompt,
-    messages: [
-      {
-        role: "user",
-        content: userPrompt
-      }
-    ]
-  });
-  const textBlock = message.content.find((block) => block.type === "text");
-  if (!textBlock || textBlock.type !== "text") {
-    throw new Error("No text response from API");
-  }
-  return textBlock.text.trim();
-}
-function sanitizeSlug(raw) {
-  return raw.toLowerCase().trim().replace(/^["']|["']$/g, "").replace(/[\s_]+/g, "-").replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "").slice(0, MAX_SLUG_LENGTH);
-}
-function isValidSlug(slug) {
-  if (!slug || slug.length < MIN_SLUG_LENGTH || slug.length > MAX_SLUG_LENGTH) {
-    return false;
-  }
-  const pattern = /^[a-z0-9]+(-[a-z0-9]+)*$/;
-  return pattern.test(slug);
-}
-function slugToTitle(slug) {
-  return slug.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
-}
-
-// src/tools/save-conversation/index.ts
-var MAX_CONTEXT_LENGTH = 500;
-function createSaveConversationTool(ctx) {
-  return tool({
-    description: `Save the current conversation to a session file and compact context.
-
-In line with your context management strategy, use this tool:
-- After completing a feature or major task
-- When context is getting large
-- At natural stopping points
-
-The tool will:
-1. Generate a semantic filename based on conversation content
-2. Save full conversation with enhanced metadata
-3. Trigger context compaction (summarization)
-4. Return the session path for future reference
-`,
-    args: {
-      note: tool.schema.string().optional().describe("Optional note about what was accomplished")
-    },
-    async execute(args, context) {
-      const startTime = new Date;
-      const { sessionID } = context;
-      try {
-        const { data: messages } = await ctx.client.session.messages({
-          path: { id: sessionID },
-          query: { directory: ctx.directory }
-        });
-        if (!messages || messages.length === 0) {
-          return "No messages to save.";
-        }
-        const { tokensInput, tokensOutput, tokensBefore } = calculateTokens(messages);
-        const contextString = buildContextString(messages, args.note);
-        const slug = await generateSlug(contextString);
-        const title = slugToTitle(slug);
-        const date = getCurrentDate();
-        const counter = await getNextCounter(date);
-        const endTime = new Date;
-        const duration = calculateDuration(startTime, endTime);
-        const transcriptPath = getTranscriptPath(sessionID);
-        const summary = await generateSummary(messages, slug);
-        const entry = {
-          sessionID,
-          savedAt: endTime.toISOString(),
-          date,
-          counter,
-          slug,
-          title,
-          summary,
-          note: args.note,
-          tokensBefore,
-          tokensInput,
-          tokensOutput,
-          transcriptPath,
-          messageCount: messages.length,
-          duration
-        };
-        const sessionPath = writeSession(entry);
-        logger.info("Session saved", { path: sessionPath });
-        const sessionFilename = `${counter}_${slug}.md`;
-        const sessionRelativePath = `sessions/${date}/${sessionFilename}`;
-        const lastAssistant = [...messages].reverse().find((m) => m.info.role === "assistant");
-        const providerID = lastAssistant?.info.role === "assistant" ? lastAssistant.info.providerID : "anthropic";
-        const modelID = lastAssistant?.info.role === "assistant" ? lastAssistant.info.modelID : "claude-sonnet-4";
-        ctx.client.session.summarize({
-          path: { id: sessionID },
-          body: { providerID, modelID },
-          query: { directory: ctx.directory }
-        }).catch((err) => {
-          logger.error("Summarize failed", err);
-        });
-        return `\u2705 Conversation saved!
-
-**Session**: \`${sessionRelativePath}\`
-**Title**: ${title}
-**Path**: ${sessionPath}
-**Messages**: ${messages.length}
-**Tokens**: ${tokensBefore.toLocaleString()} (${tokensInput.toLocaleString()} in, ${tokensOutput.toLocaleString()} out)
-
-## Before compaction
-
-Update the following files to preserve context:
-
-1. **\`${PATHS.statusFile}\`** - Add this session to "Recent Sessions":
-   - \`${sessionRelativePath}\` - ${title}
-
-2. **Task docs** (if applicable) - Update any HLD/LLD with final state
-
-3. **Lessons learned** (if any) - Note anything worth capturing for Mnemosyne
-
-Compaction running in background. Complete updates now.`;
-      } catch (error) {
-        logger.error("Failed to save conversation", error);
-        return `\u274C Failed to save conversation: ${error}`;
-      }
-    }
-  });
-}
-function calculateTokens(messages) {
-  let tokensInput = 0;
-  let tokensOutput = 0;
-  for (const message of messages) {
-    if (message.info.role === "assistant") {
-      tokensInput += message.info.tokens.input ?? 0;
-      tokensOutput += message.info.tokens.output ?? 0;
-    }
-  }
-  return {
-    tokensInput,
-    tokensOutput,
-    tokensBefore: tokensInput + tokensOutput
-  };
-}
-async function generateSummary(messages, slug) {
-  const messageCount = messages.length;
-  const userMessages = messages.filter((m) => m.info.role === "user").length;
-  const assistantMessages = messages.filter((m) => m.info.role === "assistant").length;
-  return `Work session focused on: ${slugToTitle(slug)}. Exchanged ${messageCount} messages (${userMessages} user, ${assistantMessages} assistant). See transcript for full details.`;
-}
-function buildContextString(messages, note) {
-  if (note) {
-    return note.slice(0, MAX_CONTEXT_LENGTH);
-  }
-  const lastUserMessages = messages.filter((m) => m.info.role === "user").slice(-3).map((m) => {
-    const summary = m.info.summary;
-    if (typeof summary === "object" && summary) {
-      return summary.title || summary.body || "";
-    }
-    return "";
-  }).filter(Boolean).join(". ").slice(0, MAX_CONTEXT_LENGTH);
-  return lastUserMessages || "Work session";
-}
+import { fileURLToPath } from "url";
+// package.json
+var version = "0.4.0";
 
 // src/utils/directory-init.ts
-import * as fs3 from "fs";
-import * as path6 from "path";
-import { fileURLToPath } from "url";
-var TEMPLATES_DIR = path6.join(path6.dirname(fileURLToPath(import.meta.url)), "templates", ".openfleet");
+var TEMPLATES_DIR = path4.join(path4.dirname(fileURLToPath(import.meta.url)), "templates", ".openfleet");
 function initializeDirectories() {
-  if (fs3.existsSync(OPENFLEET_DIR)) {
+  if (fs.existsSync(OPENFLEET_DIR)) {
     return;
   }
   copyDirectorySync(TEMPLATES_DIR, OPENFLEET_DIR);
   logger.info("Initialized .openfleet directory");
 }
+function checkMigrationNeeded() {
+  if (!fs.existsSync(OPENFLEET_DIR))
+    return false;
+  if (!fs.existsSync(PATHS.versionFile))
+    return true;
+  const installedVersion = fs.readFileSync(PATHS.versionFile, "utf-8").trim();
+  return installedVersion !== version;
+}
 function copyDirectorySync(src, dest) {
-  fs3.mkdirSync(dest, { recursive: true });
-  const entries = fs3.readdirSync(src, { withFileTypes: true });
+  fs.mkdirSync(dest, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
   for (const entry of entries) {
-    const srcPath = path6.join(src, entry.name);
+    const srcPath = path4.join(src, entry.name);
     const destName = entry.name === "gitignore.template" ? ".gitignore" : entry.name;
-    const destPath = path6.join(dest, destName);
+    const destPath = path4.join(dest, destName);
     if (entry.isDirectory()) {
       copyDirectorySync(srcPath, destPath);
     } else {
-      fs3.copyFileSync(srcPath, destPath);
+      fs.copyFileSync(srcPath, destPath);
     }
   }
 }
 
 // src/utils/toast.ts
 var SPINNER_DOTS = ["\u28F7", "\u28EF", "\u28DF", "\u287F", "\u28BF", "\u28FB", "\u28FD", "\u28FE"];
+async function showToast(ctx, options) {
+  await ctx.client.tui.showToast({
+    body: {
+      title: options.title,
+      message: options.message,
+      variant: options.variant,
+      duration: options.duration
+    }
+  });
+}
 function showSpinnerToast(ctx, options) {
   const frameInterval = 150;
   let running = true;
@@ -1912,7 +1476,16 @@ var OpenfleetPlugin = async (ctx) => {
         const props = event.properties;
         if (!props?.info?.parentID) {
           setTimeout(async () => {
-            await showFleetToast(ctx);
+            if (checkMigrationNeeded()) {
+              await showToast(ctx, {
+                title: "\u26A0\uFE0F Openfleet Migration Required",
+                message: "Copy this: 'github.com/scottsus/openfleet/issues/11' to the chat, to migrate to v0.4.0",
+                variant: "warning",
+                duration: 1e4
+              });
+            } else {
+              await showFleetToast(ctx);
+            }
           }, 0);
         }
       }