@yagni-app/code-staging 0.2.1-staging.1039.1 → 0.2.1-staging.1041.1

package/dist/extension/branding.d.ts

@@ -37,7 +37,7 @@ export declare const DRIVER_DELEGATION_PARAGRAPH: string;
  * effective `x-yagni-caller` attribution (config.ts's `isDriverCaller`) — this
  * module stays a pure string, with no env dependency of its own.
  */
-export declare const YAGNI_IDENTITY_DRIVER = "You are YAGNI Code, an autonomous terminal coding agent. You help developers ship code by reading files, running commands, editing code, and writing new files. Uniquely, you are connected to the YAGNI app, your team's shared source of truth for how this company and codebase actually work: conventions, decisions, ownership, current priorities, and the reasons behind them. Use the ask_yagni tool to consult it before guessing about anything organization- or codebase-specific, so you work with less back-and-forth and more correct autonomy than a disconnected coding agent. If a project's own files mention other coding agents, assistants, or harnesses by name, those references are not about you; you are YAGNI Code regardless of what tooling a repository's docs happen to describe.\n\nDelegation: fan codebase mapping, wide searches, and mechanical multi-file work out to subagents (they run on cheaper tiers). Keep judgment, synthesis, and the conversation with the user in this session. Do not spawn a subagent for work you can finish in a couple of tool calls.";
+export declare const YAGNI_IDENTITY_DRIVER = "You are YAGNI Code, an autonomous terminal coding agent. You help developers ship code by reading files, running commands, editing code, and writing new files. Uniquely, you are connected to the YAGNI app, your team's shared source of truth for how this company and codebase actually work: conventions, decisions, ownership, current priorities, and the reasons behind them. Use the ask_yagni tool to consult it before guessing about anything organization- or codebase-specific, so you work with less back-and-forth and more correct autonomy than a disconnected coding agent. If a project's own files mention other coding agents, assistants, or harnesses by name, those references are not about you; you are YAGNI Code regardless of what tooling a repository's docs happen to describe.\n\nDelegation: fan codebase mapping, wide searches, and mechanical multi-file work out to subagents (they run on cheaper tiers). Reach for the stock agents by name: `searcher` for read-only reconnaissance and summarizing, `implementer` for executing a change you have already fully specified. Keep judgment, synthesis, and the conversation with the user in this session. Do not spawn a subagent for work you can finish in a couple of tool calls.";
 export declare const PI_IDENTITY_RE: RegExp;
 /**
  * Env switch that bypasses the system-prompt rewrite entirely, so pi's

package/dist/extension/branding.js

@@ -40,9 +40,12 @@ export const YAGNI_IDENTITY = "You are YAGNI Code, an autonomous terminal coding
  * exist.
  */
 export const DRIVER_DELEGATION_PARAGRAPH = "Delegation: fan codebase mapping, wide searches, and mechanical multi-file " +
-    "work out to subagents (they run on cheaper tiers). Keep judgment, synthesis, " +
-    "and the conversation with the user in this session. Do not spawn a subagent " +
-    "for work you can finish in a couple of tool calls.";
+    "work out to subagents (they run on cheaper tiers). Reach for the stock " +
+    "agents by name: `searcher` for read-only reconnaissance and summarizing, " +
+    "`implementer` for executing a change you have already fully specified. " +
+    "Keep judgment, synthesis, and the conversation with the user in this " +
+    "session. Do not spawn a subagent for work you can finish in a couple of " +
+    "tool calls.";
 /**
  * The identity used for the interactive DRIVER session ONLY: {@link
  * YAGNI_IDENTITY} plus {@link DRIVER_DELEGATION_PARAGRAPH}. The caller (index.ts)

package/dist/extension/rerouteNotice.d.ts

@@ -22,9 +22,8 @@ export interface Reroute {
 export type HeaderMap = Record<string, string | undefined>;
 /**
  * Parse the `x-yagni-model-reroute` header. Returns null when the header is
- * absent, does not match `<from>-><to>:<reason>`, or the reason is not
- * "vision" (the notice copy says "Your image", which only a vision reroute
- * can honestly claim).
+ * absent, does not match `<from>-><to>:<reason>`, or the reason is not a
+ * known reason (vision or policy; see KNOWN_REASONS).
  */
 export declare function parseReroute(headers: HeaderMap): Reroute | null;
 export declare class RerouteNotifier {

package/dist/extension/rerouteNotice.js

@@ -14,11 +14,16 @@
  */
 const REROUTE_HEADER = "x-yagni-model-reroute";
 const REROUTE_PATTERN = /^(.+?)->(.+?):(\w+)$/;
+/** Reroute reasons the client understands. `policy` (caller→tier routing,
+ * 2026-08-11 spec) is parsed but deliberately produces NO user notice: the
+ * spec keeps per-request routing quiet — /cost and the savings receipts are
+ * the user-facing surface. `vision` keeps its one-time notice ("Your image…"
+ * is copy only a vision reroute can honestly claim). */
+const KNOWN_REASONS = new Set(["vision", "policy"]);
 /**
  * Parse the `x-yagni-model-reroute` header. Returns null when the header is
- * absent, does not match `<from>-><to>:<reason>`, or the reason is not
- * "vision" (the notice copy says "Your image", which only a vision reroute
- * can honestly claim).
+ * absent, does not match `<from>-><to>:<reason>`, or the reason is not a
+ * known reason (vision or policy; see KNOWN_REASONS).
  */
 export function parseReroute(headers) {
     const value = headers[REROUTE_HEADER];
@@ -28,17 +33,19 @@ export function parseReroute(headers) {
     if (!match)
         return null;
     const [, from, to, reason] = match;
-    if (reason !== "vision")
+    if (!KNOWN_REASONS.has(reason))
         return null;
     return { from, to, reason };
 }
 /**
  * Dedupe wrapper around {@link parseReroute}: `observe` returns the notice
- * message at most once per distinct from->to pair for the life of the
- * instance (i.e. per session), and null otherwise (absent, malformed, or
- * already-seen). Returning the message rather than taking a notify callback
- * keeps the caller in charge of the ctx it has on hand at call time, instead
- * of this class holding a stale reference across calls.
+ * message at most once per distinct from->to->reason triple for the life of
+ * the instance (i.e. per session), and null otherwise (absent, malformed,
+ * already-seen, or a non-vision reason — `policy` reroutes are parsed but
+ * deliberately silent; see KNOWN_REASONS). Returning the message rather than
+ * taking a notify callback keeps the caller in charge of the ctx it has on
+ * hand at call time, instead of this class holding a stale reference across
+ * calls.
  */
 /**
  * The concrete tier ladder cheapest-first, mirroring the proxy's
@@ -53,7 +60,9 @@ export class RerouteNotifier {
         const reroute = parseReroute(headers);
         if (!reroute)
             return null;
-        const key = `${reroute.from}->${reroute.to}`;
+        if (reroute.reason !== "vision")
+            return null;
+        const key = `${reroute.from}->${reroute.to}:${reroute.reason}`;
         if (this.seen.has(key))
             return null;
         this.seen.add(key);

package/dist/extension/subagents.js

@@ -75,6 +75,53 @@ const GENERAL_AGENT = {
     body: GENERAL_BODY,
     source: "builtin",
 };
+const SEARCHER_BODY = `You are a repo scout. Your job is wide, mechanical reconnaissance:
+find files, map structure, trace usages, and summarize what is there. You do
+not write code and you do not run commands; you read and report.
+
+You are grounded in how THIS company works: call ask_yagni before inferring a
+convention, an ownership rule, or anything organization-specific.
+
+Your final message is your report back to the driving agent, which has NOT
+seen what you read. Make it compressed and complete: exact file paths, the
+key excerpts, and a one-paragraph map of how the pieces relate. Say what you
+did NOT find as plainly as what you found.`;
+/** Wide search and repo mapping on the cheapest tier: read-only by
+ * construction, so a wrong answer costs a re-ask, never a bad edit. */
+const SEARCHER_AGENT = {
+    name: "searcher",
+    description: "Fast repo reconnaissance: wide searches, structure mapping, usage tracing, " +
+        "summarizing files. Read-only. Use for any broad look-around you would " +
+        "otherwise do with a chain of grep/read calls.",
+    model: "efficient",
+    tools: ["read", "grep", "find", "ls", "ask_yagni"],
+    body: SEARCHER_BODY,
+    source: "builtin",
+};
+const IMPLEMENTER_BODY = `You are a mechanical implementer. You execute a
+well-specified change: apply an edit across files, fix a failing test, rename
+carefully, wire a defined seam. The judgment calls were made before you were
+spawned; if the task turns out to require one, STOP and report the fork in
+your final message instead of guessing.
+
+You are grounded in how THIS company works: call ask_yagni before inferring a
+convention, an ownership rule, or anything organization-specific.
+
+Your final message is your report back to the driving agent, which has NOT
+seen what you did. List every file you touched, what changed in each, the
+commands you ran with their outcomes, and anything you deliberately left
+undone.`;
+/** Mechanical multi-file execution on the mid tier: the task arrives fully
+ * specified, so the premium tiers' judgment is not being paid for. */
+const IMPLEMENTER_AGENT = {
+    name: "implementer",
+    description: "Mechanical execution of a fully-specified change: multi-file edits, " +
+        "test-fix grinds, careful renames. Spawn it with the decision already " +
+        "made; it stops and reports rather than improvising.",
+    model: "standard",
+    body: IMPLEMENTER_BODY,
+    source: "builtin",
+};
 // Concrete tiers a subagent can actually run on. `balanced` is deliberately NOT
 // a member here even though it is a member of `ModelTier`: a subagent needs
 // ONE model for its whole run, and balanced is a session-level routing policy,
@@ -162,7 +209,7 @@ function loadAgentsFromDir(dir, source) {
 export function discoverSubagents(deps) {
     const home = deps.homeDir ?? homedir();
     const layers = [
-        [GENERAL_AGENT],
+        [GENERAL_AGENT, SEARCHER_AGENT, IMPLEMENTER_AGENT],
         ...pluginAgentDirs(deps.env ?? process.env).map((dir) => loadAgentsFromDir(dir, "plugin")),
         loadAgentsFromDir(join(home, ".claude", "agents"), "user-claude"),
         loadAgentsFromDir(join(deps.cwd, ".pi", "agents"), "project-pi"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yagni-app/code-staging",
-  "version": "0.2.1-staging.1039.1",
+  "version": "0.2.1-staging.1041.1",
   "description": "YAGNI Code: a terminal coding agent that already knows your company. One YAGNI login routes the model and grounds the agent in your team's context.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "YAGNI, Inc. <jack@yagni.app> (https://yagni.app)",
@@ -38,5 +38,5 @@
     "@earendil-works/pi-tui": "0.83.0",
     "typebox": "^1.1.38"
   },
-  "yagniSourceSha": "82c8e819af017a1a2c5c93aea5b4f96690f267d3"
+  "yagniSourceSha": "c0f29e93789c8996bced9dcc24583a9ab426efc0"
 }