@lawaty/lacode 0.4.1 → 0.5.0

package/dist/agents.js

@@ -30,6 +30,7 @@ var ORPHAN_TMP_MS = 60 * 1e3;
 var CATALOG_TTL_MS = 10 * 60 * 1e3;
 var STUCK_MIN_AGE_MS = 5 * 60 * 1e3;
 var STUCK_IDLE_MS = 3 * 60 * 1e3;
+var MAX_CLAIM_AGE_MS = 30 * 60 * 1e3;
 var HANG_COOLDOWN_MS = 10 * 60 * 1e3;
 var UNAVAILABLE_COOLDOWN_MS = 60 * 1e3;
 var MAX_SLOTS = 4;
@@ -45,6 +46,9 @@ var USER_MODELS_PATH = join2(USER_CONFIG_DIR, "pool.json");
 var USER_MODELS_TXT = join2(USER_CONFIG_DIR, "pool.txt");
 var CHILD_MEMORY_MS = 30 * 6e4;
 
+// src/lib/manager-directive.ts
+var MANAGER_AGENT_NAME = "manager";
+
 // src/agents.ts
 var POOLED_BASES = ["explore", "implement", "context"];
 var AGENTS = {
@@ -454,6 +458,30 @@ You own exactly these five files and nothing else:
   during work that are not already recorded in the project's own decision
   log. Concise; variable length.
 
+A sixth file sits in the same directory and is not yours:
+\`.opencode/context/manager.md\`. It is the client's own statement of intent
+\u2014 what is being worked on, what comes next, what they have settled, and
+what every agent should keep in mind. It deliberately says nothing about
+where code lives: your five files and the source itself are the only
+authority on that, and this file never contradicts them. It has no fixed
+schema \u2014 read the whole file, because every heading in it is direction.
+
+You never create, edit, rename, or delete it \u2014 not at bootstrap, not in an
+update, not in a review, and not when a run of your own concludes the work
+has moved on. The client edits it, or asks a live agent to edit it on
+their explicit instruction. Either way it is their hand, never yours.
+
+Read it before you write anything. Its \`## Current\` and \`## Next\`
+sections tell you what is actually being worked on, and \`## Confirmed\`
+tells you which of your facts the client has ratified. A fact you are
+writing that appears under \`## Confirmed\` may be stated plainly, without
+a confidence marker; anything else follows your normal rules \u2014 infer
+carefully, mark uncertainty. Never copy its content into the five files.
+
+A missing or empty section is not an instruction. It means the client has
+not said, not that you may assume anything \u2014 proceed exactly as you would
+without the file.
+
 Never create, modify, or delete anything outside \`.opencode/context/\`. The
 \`edit\` permission enforces this. Do not attempt to work around it with bash.
 
@@ -488,6 +516,11 @@ Then write the five files. For each significant subsystem, give a short
 reason. This is the single most valuable thing you produce: where an agent
 should open its editor next.
 
+manager.md is created for the client by the plugin, not by you; if it is
+missing anyway, mention once in your final report that they can add it
+themselves to record what is being worked on, what comes next, and what
+they have ratified. Never create it.
+
 # Incremental update
 
 Trigger: \`.opencode/context/\` exists and work has just been done here.
@@ -515,6 +548,14 @@ that is already stated in another context file \u2014 one fact has one home, and
 the other files link to it. If nothing material changed, make no edits and
 report "no update needed".
 
+Before editing, re-read manager.md: its \`## Current\` and \`## Next\`
+sections tell you what the client is actually working on, and its
+\`## Confirmed\` section settles which of your facts are ratified. If what
+you are about to write would place the code somewhere the client never
+described, trust the code, make the edit the code justifies, and report
+the gap in your final message \u2014 never reconcile the two sides silently,
+and never edit manager.md to close it.
+
 # Minimal exploration
 
 Default shape:
@@ -609,9 +650,14 @@ Audit the five files for:
 - duplicated information \u2014 one canonical place per fact
 - missing canonical entry points for significant subsystems
 - unsupported assumptions \u2014 anything unmarked that you cannot verify
+- manager.md, if present: is \`## Current\` and \`## Next\` still true of
+  recent work, is every \`## Confirmed\` entry still true of the code, has
+  it outgrown roughly 150 lines \u2014 report findings, but never edit, prune,
+  or reorganize it; that is the client's call
 
-Fix problems only in \`.opencode/context/\`. Never modify source code during a
-review. Report what you found, what you fixed, and what you could not verify.
+Fix problems only in the five files you own \u2014 never in manager.md, which
+belongs to the client. Never modify source code during a review. Report
+what you found, what you fixed, and what you could not verify.
 
 # Reporting
 
@@ -629,7 +675,9 @@ Finish with a short report:
       "edit": {
         "*": "deny",
         "*/.opencode/context/**": "allow",
-        ".opencode/context/**": "allow"
+        ".opencode/context/**": "allow",
+        "*/.opencode/context/manager.md": "deny",
+        ".opencode/context/manager.md": "deny"
       },
       "bash": {
         "*": "deny",
@@ -677,6 +725,68 @@ Finish with a short report:
     }
   }
 };
+var MANAGER_AGENT = {
+  description: "Records and edits the client's .opencode/context/manager.md. Run only by the /manager-directive command; no agent or subagent can spawn it.",
+  mode: "subagent",
+  hidden: true,
+  temperature: 0.1,
+  prompt: `# Role
+
+You maintain one file and nothing else: \`.opencode/context/manager.md\`, the
+client's own statement of intent. You are not a coding agent and you touch no
+other path.
+
+You are run only by the \`/manager-directive\` command. The client tells you what
+they want recorded or changed in the file; you apply that to the file and report
+what you changed. You have no permission to edit anything else, and you need
+none.
+
+# The file
+
+It records what is being worked on (\`## Current\`), what comes next
+(\`## Next\`), what the client has ratified (\`## Confirmed\`), and standing
+direction (\`## Instructions\`). The client may use any headings \u2014 every heading
+is direction, and the four above are a convenience, not a schema.
+
+# How to apply a directive
+
+- Do what the client asked. "Append", "rewrite Current", "move X to Confirmed",
+  "add a heading" all mean exactly that; a bare sentence goes under the most
+  fitting existing heading, and you create one only if none fits.
+- Never invent facts, never record your own inference as the client's, and never
+  tidy, reorder or delete content the client did not ask you to touch.
+- \`## Current\` is rewritten, not appended to, so it does not become a running
+  history.
+- Keep the file concise. If it is growing past roughly 150 lines, say so.
+
+# Reporting
+
+Report briefly what you changed and where. Do not edit any other file.`,
+  permission: {
+    // Read is scoped to the one file too: the directive is about manager.md, and
+    // nothing else is any of this agent's business.
+    read: {
+      "*": "deny",
+      ".opencode/context/manager.md": "allow",
+      "*/.opencode/context/manager.md": "allow"
+    },
+    glob: "deny",
+    grep: "deny",
+    list: "deny",
+    edit: {
+      "*": "deny",
+      ".opencode/context/manager.md": "allow",
+      "*/.opencode/context/manager.md": "allow"
+    },
+    bash: "deny",
+    webfetch: "deny",
+    websearch: "deny",
+    question: "allow",
+    task: {
+      "*": "deny"
+    }
+  }
+};
 function buildAgentSet() {
   const set = { ...AGENTS };
   for (const base of POOLED_BASES) {
@@ -692,6 +802,7 @@ function buildAgentSet() {
       set[`${base}-${slot}`] = variant;
     }
   }
+  set[MANAGER_AGENT_NAME] = MANAGER_AGENT;
   return set;
 }
 function applyAgents(cfg, agents = buildAgentSet(), opts = {}) {
@@ -711,6 +822,7 @@ function applyAgents(cfg, agents = buildAgentSet(), opts = {}) {
 }
 export {
   AGENTS,
+  MANAGER_AGENT,
   POOLED_BASES,
   applyAgents,
   buildAgentSet

package/dist/commands.js

@@ -1,3 +1,6 @@
+// src/lib/manager-directive.ts
+var MANAGER_AGENT_NAME = "manager";
+
 // src/commands.ts
 var COMMANDS = {
   "context-init": {
@@ -19,7 +22,13 @@ Remember: write conclusions, not inventories. Link to the project's existing
 documentation instead of duplicating it.
 
 Report what you created or updated, what you deliberately left out, and
-anything that contradicts the code or existing docs.`
+anything that contradicts the code or existing docs.
+
+If \`.opencode/context/manager.md\` does not exist, mention in your final
+report that the client can add it themselves \u2014 their own file with
+\`## Current\`, \`## Next\`, \`## Confirmed\` and \`## Instructions\` \u2014 for what
+is being worked on, what comes next, what they have ratified, and standing
+direction. Never create it.`
   },
   "context-update": {
     description: "Incrementally update .opencode/context/ after recent work via the context agent.",
@@ -50,8 +59,9 @@ timestamp-only edits. If nothing material changed, make no edits and report
     subtask: true,
     template: `Context review.
 
-Everything outside \`.opencode/context/\` is read-only for this run. Do not
-modify source code under any circumstances.
+Everything outside the five context files is read-only for this run \u2014
+including \`manager.md\`, which belongs to the client. Do not modify source
+code under any circumstances.
 
 Audit the five context files for:
 
@@ -64,9 +74,22 @@ Audit the five context files for:
 - missing canonical entry points for significant subsystems
 - unsupported assumptions \u2014 anything stated as fact that you cannot verify,
   or that lacks a confidence marker
+- \`manager.md\`, if present: is \`## Current\` and \`## Next\` still true of
+  recent work, is every \`## Confirmed\` entry still true of the code, has it
+  outgrown roughly 150 lines \u2014 report findings, but never edit it
 
 Fix what you find in \`.opencode/context/\` only, then report: findings, fixes,
 and anything you could not verify.`
+  },
+  "manager-directive": {
+    description: "Apply a client instruction to .opencode/context/manager.md. Client-only \u2014 runs the manager agent, the only writer of that file.",
+    agent: MANAGER_AGENT_NAME,
+    subtask: true,
+    template: `Apply this instruction to \`.opencode/context/manager.md\`, and edit only that file:
+
+$ARGUMENTS
+
+Follow the rules for the file in your system prompt, then report what you changed.`
   },
   "lacode-doctor": {
     description: "Check the LaCode setup \u2014 pool slots, model resolution, and the OmniRoute gateway. Report only; changes nothing.",
@@ -94,7 +117,8 @@ Print one PASS/FAIL line per check below, with the exact fix for any FAIL.
    trap: an id that is a valid gateway route but is NOT in the plugin's
    \`omniroute.models\` allowlist fails with
    \`ProviderModelNotFoundError: Model not found\`; the fix is to add that id to
-   the \`models\` array, or use the always-registered \`auto\`.
+   the \`models\` array, or set it as \`combo\` \u2014 the combo id is registered
+   whether or not the gateway advertises it, so it needs no allowlist entry.
 
 Change nothing. Print a final one-line summary of failures.`
   }
@@ -113,26 +137,49 @@ function applyCommands(cfg, commands = COMMANDS) {
   }
   return { added, kept };
 }
+var INSTRUCTION_MARKER = "<!-- lacode:context-map-instruction:v1 -->";
+var INSTRUCTION_OPT_OUT = "<!-- lacode:context-map-instruction:off -->";
 var STANDING_INSTRUCTION = `## Repository context map
 
 This project may keep a navigation map in \`.opencode/context/\`. Before broad
 exploration, check whether it exists (\`ls .opencode/context\` \u2014 never the \`glob\`
-tool, which skips hidden directories). If it does, read only the file relevant to
-the task \u2014 architecture.md, contexts.md, conventions.md, workflows.md,
-decisions.md \u2014 then start from the canonical entry points it lists.
-
-Source code is authoritative: if the map disagrees with the code, trust the code,
-say so, and never edit source to match the map. Never edit \`.opencode/context/\`
-yourself \u2014 the context agent owns it. Say in your final report if your
-work revealed something that belongs in the map.`;
+tool, which skips hidden directories). If \`manager.md\` exists there, read it
+first: it is the client's own statement of intent \u2014 what is being worked on,
+what comes next, \`## Confirmed\` lists what the client has ratified, and
+\`## Instructions\` holds standing managerial directions. It outranks every
+other context file and every inference of yours about what matters right now.
+It says nothing about where code lives, so it cannot contradict the code;
+treat its \`## Confirmed\` entries as settled decisions, not as a licence to
+skip reading the code. Any heading in it is direction, so read the whole
+file rather than only the sections above. The rest of the map remains usable,
+just unratified where \`## Confirmed\` does not cover it. Then read only the
+file relevant to the task \u2014 \`architecture.md\`, \`contexts.md\`,
+\`conventions.md\`, \`workflows.md\`, \`decisions.md\` \u2014 and start from the
+canonical entry points it lists.
+
+Source code is authoritative: if the map disagrees with the code,
+trust the code and say so; never edit source to match it.
+Never edit the five context files yourself \u2014 the context agent owns them.
+\`manager.md\` is the client's own file and the context agent is explicitly
+permission-denied from writing it. You may write it only when the client
+explicitly asks you to in this conversation, and then only what they asked
+for; never on your own initiative, and never to "keep it up to date". Say in
+your final report if your work revealed something that belongs to the map, or
+if \`manager.md\` and the code disagree.`;
 function applyInstructions(cfg) {
-  const existing = cfg.instructions;
-  if (Array.isArray(existing) && existing.length > 0) return { added: false };
-  cfg.instructions = [STANDING_INSTRUCTION];
+  const existing = Array.isArray(cfg.instructions) ? cfg.instructions : [];
+  const texts = existing.filter((e) => typeof e === "string");
+  if (texts.some((e) => e.includes(INSTRUCTION_OPT_OUT))) return { added: false };
+  if (texts.some((e) => e.includes(INSTRUCTION_MARKER))) return { added: false };
+  cfg.instructions = [...existing, `${INSTRUCTION_MARKER}
+
+${STANDING_INSTRUCTION}`];
   return { added: true };
 }
 export {
   COMMANDS,
+  INSTRUCTION_MARKER,
+  INSTRUCTION_OPT_OUT,
   STANDING_INSTRUCTION,
   applyCommands,
   applyInstructions