@lawaty/lacode 0.0.0-stage → 0.1.0

package/dist/commands.js

@@ -0,0 +1,109 @@
+// src/commands.ts
+var COMMANDS = {
+  "context-init": {
+    description: "Bootstrap the repository context map (.opencode/context/) via the context-manager agent.",
+    agent: "context-manager",
+    subtask: true,
+    template: `Bootstrap the repository context map.
+
+If \`.opencode/context/\` already exists, do NOT start over \u2014 verify and refresh
+it in place (correct stale entries, fill gaps) using the review procedure in
+your system prompt.
+
+Otherwise follow the bootstrap procedure in your system prompt: progressive
+exploration (README \u2192 existing docs \u2192 manifests \u2192 top-level structure \u2192 build
+and framework config \u2192 entry points \u2192 selective source), then write the five
+context files inside their size targets.
+
+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.`
+  },
+  "context-update": {
+    description: "Incrementally update .opencode/context/ after recent work via the context-manager agent.",
+    agent: "context-manager",
+    subtask: true,
+    template: `Incremental context update.
+
+Focus: $ARGUMENTS
+
+If no focus was given, establish the recent work yourself (git status, git
+diff, git log) and start from those changed files plus their immediate
+architectural neighborhood.
+
+Follow the incremental-update procedure in your system prompt: update a
+context file only if this work introduced or revealed information that will
+materially help future agents \u2014 a new boundary or module, a new or moved
+canonical entry point, a changed workflow, a new convention, an architectural
+decision, a new dependency between subsystems, a renamed or moved subsystem,
+or a previously undocumented invariant.
+
+Do not edit documentation just because source files changed. No
+timestamp-only edits. If nothing material changed, make no edits and report
+"no update needed".`
+  },
+  "context-review": {
+    description: "Audit .opencode/context/ for staleness, contradictions, excess size, duplication, and missing entry points.",
+    agent: "context-manager",
+    subtask: true,
+    template: `Context review.
+
+Everything outside \`.opencode/context/\` is read-only for this run. Do not
+modify source code under any circumstances.
+
+Audit the five context files for:
+
+- stale information \u2014 verify claims against the actual code
+- contradictions between context files, or between the map and the code
+- excessive size \u2014 consolidate toward the per-file targets in your system
+  prompt
+- duplicated information \u2014 one canonical place per fact; link to the
+  project's own docs rather than restating them
+- missing canonical entry points for significant subsystems
+- unsupported assumptions \u2014 anything stated as fact that you cannot verify,
+  or that lacks a confidence marker
+
+Fix what you find in \`.opencode/context/\` only, then report: findings, fixes,
+and anything you could not verify.`
+  }
+};
+function applyCommands(cfg, commands = COMMANDS) {
+  const target = cfg.command ??= {};
+  const added = [];
+  const kept = [];
+  for (const [name, def] of Object.entries(commands)) {
+    if (target[name] !== void 0) {
+      kept.push(name);
+      continue;
+    }
+    target[name] = JSON.parse(JSON.stringify(def));
+    added.push(name);
+  }
+  return { added, kept };
+}
+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-manager agent owns it. Say in your final report if your
+work revealed something that belongs in the map.`;
+function applyInstructions(cfg) {
+  const existing = cfg.instructions;
+  if (Array.isArray(existing) && existing.length > 0) return { added: false };
+  cfg.instructions = [STANDING_INSTRUCTION];
+  return { added: true };
+}
+export {
+  COMMANDS,
+  STANDING_INSTRUCTION,
+  applyCommands,
+  applyInstructions
+};