@bevel-software/platform-core-backend 0.34.0 → 0.36.1

package/dist/modules/agent-guide/agent-guide.tools.js

@@ -1,10 +1,14 @@
 import { GET_AGENT_GUIDE_TOOL, TOOL_DESCRIPTION_CAP } from '../tool-registry/index.js';
 import { ToolError, toolDef } from '../tool-helpers/index.js';
-import { AGENT_GUIDE_FILE, joinGuideSections } from './agent-guide.js';
+import { AGENT_GUIDE_FILE, START_HERE_SECTION_ID, WHOLE_GUIDE_SECTION, joinGuideSections, } from './agent-guide.js';
 export { GET_AGENT_GUIDE_TOOL };
 /**
- * The one tool that returns the guide on its own — whole, or one section by
- * id. It takes nothing else: the guide is the platform's text for this
+ * The one tool that returns the guide on its own: the start section when no
+ * section is named, one section by id, or the whole guide (`all`). Start
+ * section by default because this is the call every tool description tells
+ * an agent, and each sub-agent it starts, to make first: answering it with
+ * the whole guide made the most-read text the platform has also its longest.
+ * It takes nothing else: the guide is the platform's text for this
  * deployment, the same for every caller and every branch, and reading it
  * touches no file — so no `branch`, no `sessionId`, and no access gate. The
  * other way to the same text is a `read_file` of `AGENTS.md` at the
@@ -21,25 +25,28 @@ export { GET_AGENT_GUIDE_TOOL };
 export function registerAgentGuideTool(registry, router, toolAuth, toolHandler, sections) {
     const build = async () => {
         const list = await sections();
-        const describe = (sectionList) => "The platform's guide to this knowledge base: its layout, where a new file goes, the rules every file tool " +
-            'shares, access control, skills and tool manuals. ALWAYS call this first and read the guide before you do ' +
-            'anything else in the platform. Returns `{ guide }` as markdown: the whole guide, or one section when ' +
-            '`section` names one. The same text comes back from `read_file` on `' +
+        const describe = (sectionList) => "The platform's guide to this knowledge base. ALWAYS call this first, before anything else in the " +
+            'platform. With no `section` it returns the start section: the default branch every file tool takes, the ' +
+            'first-call rules, and which section answers which question. Then fetch only the section a task needs, by ' +
+            '`section`; only `"' +
+            WHOLE_GUIDE_SECTION +
+            '"` returns the whole guide. `read_file` on `' +
             AGENT_GUIDE_FILE +
-            "` at the KB root, after the knowledge base's own " +
+            "` at the KB root answers with the same start section (after the knowledge base's own " +
             AGENT_GUIDE_FILE +
-            ` when it has one. Sections: ${sectionList}.`;
+            ` when it has one). Returns \`{ guide }\` as markdown. Sections: ${sectionList}.`;
         // The description stays under the cap WHATEVER a distribution adds, in
         // three steps: every id with its title; every id alone; as many ids as
         // fit and a count of the rest. An id a client cut off the end would be a
         // section an agent cannot ask for — so nothing is ever cut: the one
-        // complete list of sections is `sections` on the whole-guide response,
-        // which the description names when it cannot carry them all itself.
+        // complete list of sections is `sections` on the answer to a call
+        // without one, which the description names when it cannot carry them
+        // all itself.
         const titled = describe(list.map((s) => `\`${s.id}\` (${s.title})`).join(', '));
         const ids = list.map((s) => `\`${s.id}\``);
         const counted = (shown) => describe(shown === 0
-            ? `${ids.length}, named under \`sections\` in the whole-guide response`
-            : [...ids.slice(0, shown), `and ${ids.length - shown} more, all named under \`sections\` in the whole-guide response`].join(', '));
+            ? `${ids.length}, named under \`sections\` in the answer`
+            : [...ids.slice(0, shown), `and ${ids.length - shown} more, all named under \`sections\` in the answer`].join(', '));
         let description = titled.length <= TOOL_DESCRIPTION_CAP ? titled : describe(ids.join(', '));
         for (let shown = ids.length; description.length > TOOL_DESCRIPTION_CAP && shown > 0; shown--) {
             description = counted(shown - 1);
@@ -53,8 +60,10 @@ export function registerAgentGuideTool(registry, router, toolAuth, toolHandler,
                 properties: {
                     section: {
                         type: 'string',
-                        description: 'Optional: the id of one section to read instead of the whole guide (the ids are listed in this ' +
-                            'description, and every one under `sections` in the whole-guide response). Omit it for the whole guide.',
+                        description: 'Optional: the id of one section to read (the ids are listed in this description, and every one under ' +
+                            '`sections` in the answer), or `"' +
+                            WHOLE_GUIDE_SECTION +
+                            '"` for the whole guide. Omit it for the start section.',
                     },
                 },
                 additionalProperties: false,
@@ -62,18 +71,18 @@ export function registerAgentGuideTool(registry, router, toolAuth, toolHandler,
             outputs: {
                 type: 'object',
                 properties: {
-                    guide: { type: 'string', description: 'The guide, or the one section asked for, as markdown.' },
+                    guide: { type: 'string', description: 'The section asked for (the start section by default), or the whole guide, as markdown.' },
                     sections: {
                         type: 'array',
-                        description: 'Without `section`: every section of the guide, in order, by id and heading — the complete list.',
+                        description: `Without \`section\`, or with \`"${WHOLE_GUIDE_SECTION}"\`: every section of the guide, in order, by id and heading — the complete list.`,
                         items: {
                             type: 'object',
                             properties: { id: { type: 'string' }, title: { type: 'string' } },
                             required: ['id', 'title'],
                         },
                     },
-                    section: { type: 'string', description: 'With `section`: the id of the section returned.' },
-                    title: { type: 'string', description: 'With `section`: its heading.' },
+                    section: { type: 'string', description: 'The id of the one section returned.' },
+                    title: { type: 'string', description: 'Its heading.' },
                 },
                 required: ['guide'],
             },
@@ -84,23 +93,28 @@ export function registerAgentGuideTool(registry, router, toolAuth, toolHandler,
     registry.registerExternalTool(build);
     router.post(`/agent/tools/${GET_AGENT_GUIDE_TOOL}`, toolAuth, toolHandler(async (args, ctx) => {
         const list = await sections();
+        const index = list.map((s) => ({ id: s.id, title: s.title }));
         const wanted = typeof args.section === 'string' ? args.section.trim() : '';
-        // A connection made as an agent configuration is told so at the top of the
-        // whole guide: the catalog it describes is narrowed to that agent.
-        // Everything is told nothing new, so its guide is the same text.
+        // A distribution that dropped the start section gets the whole guide by
+        // default, as before there was one: never an answer with nothing in it.
+        const start = list.find((s) => s.id === START_HERE_SECTION_ID);
+        // A connection made as an agent configuration is told so at the top of
+        // the guide's first answer and of the whole guide: the catalog it
+        // describes is narrowed to that agent. Everything is told nothing new,
+        // so its guide is the same text.
         const connection = ctx.connectionScope?.describe() ?? null;
-        if (!wanted) {
-            const guide = joinGuideSections(list);
-            return {
-                guide: connection ? `> ${connection}\n\n${guide}` : guide,
-                sections: list.map((s) => ({ id: s.id, title: s.title })),
-                ...(connection ? { connection } : {}),
-            };
-        }
+        const told = (guide) => ({
+            guide: connection ? `> ${connection}\n\n${guide}` : guide,
+            ...(connection ? { connection } : {}),
+        });
+        if (wanted === WHOLE_GUIDE_SECTION || (!wanted && !start))
+            return { ...told(joinGuideSections(list)), sections: index };
+        if (!wanted)
+            return { ...told(start.body), section: start.id, title: start.title, sections: index };
         const one = list.find((s) => s.id === wanted);
         if (!one) {
             throw new ToolError(`The guide has no section "${wanted}". Sections: ${list.map((s) => `\`${s.id}\``).join(', ')}. ` +
-                'Omit `section` for the whole guide.', 400);
+                `Omit \`section\` for the start section, or pass \`"${WHOLE_GUIDE_SECTION}"\` for the whole guide.`, 400);
         }
         return { guide: one.body, section: one.id, title: one.title };
     }));

package/dist/modules/agent-guide/agent-guide.tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-guide.tools.js","sourceRoot":"","sources":["../../../src/modules/agent-guide/agent-guide.tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-guide.tools.js","sourceRoot":"","sources":["../../../src/modules/agent-guide/agent-guide.tools.ts"],"names":[],"mappings":"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"}

package/dist/modules/agent-guide/guide-budget.d.ts

@@ -0,0 +1,51 @@
+/**
+ * How much each layer of what an agent is told may cost, in tokens.
+ *
+ * Three layers (openspec/changes/agent-guide-layers/design.md): what every
+ * connection carries (the handshake instructions and the tool list), what an
+ * agent reads on first contact (the start section `get_agent_guide` answers
+ * with), and what it fetches only when a task needs it (every other section).
+ * A line in the first layer costs every conversation and every sub-agent; a
+ * line in the last costs only the tasks that fetch it. The budgets are what
+ * keeps the guide from growing into a document every agent loads whole and
+ * reads little of, which is what a customer's agent did fifteen times in one
+ * day.
+ *
+ * Counted with the `o200k_base` encoding by `__tests__/guide-budget.test.ts`.
+ * It is a real tokenizer that runs offline; it is not Claude's own, which
+ * usually counts somewhat more for the same text, so these are ceilings to
+ * compare against each other and over time rather than a model's bill.
+ *
+ * Every number is one a reviewer may move. The point of pinning them is that
+ * growing the guide is a decision someone takes, not a paragraph someone
+ * appends: a section that needs more room says why in the pull request that
+ * raises its line here.
+ */
+/** The encoding the budgets are counted in. */
+export declare const GUIDE_TOKEN_ENCODING = "o200k_base";
+/** The platform's part of the handshake instructions: the header and the shared file rules. */
+export declare const INSTRUCTIONS_TOKEN_BUDGET = 2000;
+/**
+ * The platform's own tools as the hosted endpoint lists them to an MCP client:
+ * each name, description (with its `Call:` line and, on the four
+ * knowledge-base tools, the purpose prefix) and input schema. Measured over
+ * every registrar the root mounts, the change-request readers and `open_page`
+ * included: 46 tools, 17,278 tokens at 0.35.0 (an earlier figure of 15,710
+ * left those five out).
+ */
+export declare const TOOL_LIST_TOKEN_BUDGET = 17500;
+/** The ceiling for a section a distribution adds, which core's checks cannot see: the same as core's own. */
+export declare const SECTION_TOKEN_BUDGET = 2500;
+/**
+ * Each core section's budget, by id. A section without a line here fails the
+ * budget test: a new section starts by saying what it may cost.
+ */
+export declare const SECTION_TOKEN_BUDGETS: Readonly<Record<string, number>>;
+/**
+ * Every core section at once: what `section: "all"` returns. 23,000 since the
+ * `onboarding` section (about 1,200) was added; 21,500 before.
+ */
+export declare const WHOLE_GUIDE_TOKEN_BUDGET = 23000;
+/** One task: the start section plus the sections it routes the task to. */
+export declare const TASK_TOKEN_BUDGET = 6000;
+//# sourceMappingURL=guide-budget.d.ts.map

package/dist/modules/agent-guide/guide-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-budget.d.ts","sourceRoot":"","sources":["../../../src/modules/agent-guide/guide-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,eAAe,CAAC;AAEjD,+FAA+F;AAC/F,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,6GAA6G;AAC7G,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBjE,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,OAAQ,CAAC"}

package/dist/modules/agent-guide/guide-budget.js

@@ -0,0 +1,71 @@
+/**
+ * How much each layer of what an agent is told may cost, in tokens.
+ *
+ * Three layers (openspec/changes/agent-guide-layers/design.md): what every
+ * connection carries (the handshake instructions and the tool list), what an
+ * agent reads on first contact (the start section `get_agent_guide` answers
+ * with), and what it fetches only when a task needs it (every other section).
+ * A line in the first layer costs every conversation and every sub-agent; a
+ * line in the last costs only the tasks that fetch it. The budgets are what
+ * keeps the guide from growing into a document every agent loads whole and
+ * reads little of, which is what a customer's agent did fifteen times in one
+ * day.
+ *
+ * Counted with the `o200k_base` encoding by `__tests__/guide-budget.test.ts`.
+ * It is a real tokenizer that runs offline; it is not Claude's own, which
+ * usually counts somewhat more for the same text, so these are ceilings to
+ * compare against each other and over time rather than a model's bill.
+ *
+ * Every number is one a reviewer may move. The point of pinning them is that
+ * growing the guide is a decision someone takes, not a paragraph someone
+ * appends: a section that needs more room says why in the pull request that
+ * raises its line here.
+ */
+/** The encoding the budgets are counted in. */
+export const GUIDE_TOKEN_ENCODING = 'o200k_base';
+/** The platform's part of the handshake instructions: the header and the shared file rules. */
+export const INSTRUCTIONS_TOKEN_BUDGET = 2_000;
+/**
+ * The platform's own tools as the hosted endpoint lists them to an MCP client:
+ * each name, description (with its `Call:` line and, on the four
+ * knowledge-base tools, the purpose prefix) and input schema. Measured over
+ * every registrar the root mounts, the change-request readers and `open_page`
+ * included: 46 tools, 17,278 tokens at 0.35.0 (an earlier figure of 15,710
+ * left those five out).
+ */
+export const TOOL_LIST_TOKEN_BUDGET = 17_500;
+/** The ceiling for a section a distribution adds, which core's checks cannot see: the same as core's own. */
+export const SECTION_TOKEN_BUDGET = 2_500;
+/**
+ * Each core section's budget, by id. A section without a line here fails the
+ * budget test: a new section starts by saying what it may cost.
+ */
+export const SECTION_TOKEN_BUDGETS = Object.freeze({
+    'start-here': 1_200,
+    onboarding: SECTION_TOKEN_BUDGET,
+    'how-agents-find-things': SECTION_TOKEN_BUDGET,
+    'for-git-users': SECTION_TOKEN_BUDGET,
+    glossary: SECTION_TOKEN_BUDGET,
+    'directory-structure': SECTION_TOKEN_BUDGET,
+    'where-a-new-file-goes': SECTION_TOKEN_BUDGET,
+    'working-with-files': SECTION_TOKEN_BUDGET,
+    'access-control': SECTION_TOKEN_BUDGET,
+    'drafts-and-change-requests': SECTION_TOKEN_BUDGET,
+    skills: SECTION_TOKEN_BUDGET,
+    tools: SECTION_TOKEN_BUDGET,
+    'tool-manuals': SECTION_TOKEN_BUDGET,
+    // The page contract is long by nature (the frame, the bridge, the link
+    // rules, pages that load live data), and an agent fetches it only to build
+    // a page.
+    'html-views': 5_500,
+    conventions: SECTION_TOKEN_BUDGET,
+    'new-knowledge-base': SECTION_TOKEN_BUDGET,
+});
+/**
+ * Every core section at once: what `section: "all"` returns. 23,000 since the
+ * `onboarding` section (about 1,200) was added; 21,500 before.
+ */
+export const WHOLE_GUIDE_TOKEN_BUDGET = 23_000;
+/** One task: the start section plus the sections it routes the task to. */
+export const TASK_TOKEN_BUDGET = 6_000;
+//# sourceMappingURL=guide-budget.js.map

package/dist/modules/agent-guide/guide-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-budget.js","sourceRoot":"","sources":["../../../src/modules/agent-guide/guide-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAEjD,+FAA+F;AAC/F,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,6GAA6G;AAC7G,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAqC,MAAM,CAAC,MAAM,CAAC;IACnF,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,oBAAoB;IAChC,wBAAwB,EAAE,oBAAoB;IAC9C,eAAe,EAAE,oBAAoB;IACrC,QAAQ,EAAE,oBAAoB;IAC9B,qBAAqB,EAAE,oBAAoB;IAC3C,uBAAuB,EAAE,oBAAoB;IAC7C,oBAAoB,EAAE,oBAAoB;IAC1C,gBAAgB,EAAE,oBAAoB;IACtC,4BAA4B,EAAE,oBAAoB;IAClD,MAAM,EAAE,oBAAoB;IAC5B,KAAK,EAAE,oBAAoB;IAC3B,cAAc,EAAE,oBAAoB;IACpC,uEAAuE;IACvE,2EAA2E;IAC3E,UAAU;IACV,YAAY,EAAE,KAAK;IACnB,WAAW,EAAE,oBAAoB;IACjC,oBAAoB,EAAE,oBAAoB;CAC3C,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE/C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC"}

package/dist/modules/agent-guide/index.d.ts

@@ -1,4 +1,5 @@
-export { AGENT_GUIDE_FILE, CORE_SECTION_IDS, NEW_KNOWLEDGE_BASE_SECTION_ID, PLATFORM_GUIDE_SEPARATOR, WORKING_WITH_FILES_SECTION_ID, agentGuideSections, composeAgentGuide, coreAgentGuideSections, isAgentGuidePath, isManagedGuide, joinGuideSections, withPlatformGuideAppended, type AgentGuideContext, type AgentGuideHook, type AgentGuideReader, type AgentGuideSection, type AgentGuideSectionsReader, type RenderedGuideSection, } from './agent-guide.js';
+export { AGENT_GUIDE_FILE, CORE_SECTION_IDS, NEW_KNOWLEDGE_BASE_SECTION_ID, PLATFORM_GUIDE_SEPARATOR, START_HERE_SECTION_ID, WHOLE_GUIDE_SECTION, WORKING_WITH_FILES_SECTION_ID, agentGuideSections, composeAgentGuide, coreAgentGuideSections, guideStartText, isAgentGuidePath, isManagedGuide, joinGuideSections, withPlatformGuideAppended, type AgentGuideContext, type AgentGuideHook, type AgentGuideReader, type AgentGuideSection, type AgentGuideSectionsReader, type RenderedGuideSection, } from './agent-guide.js';
 export { GET_AGENT_GUIDE_TOOL, registerAgentGuideTool } from './agent-guide.tools.js';
+export { GUIDE_TOKEN_ENCODING, INSTRUCTIONS_TOKEN_BUDGET, SECTION_TOKEN_BUDGET, SECTION_TOKEN_BUDGETS, TASK_TOKEN_BUDGET, TOOL_LIST_TOKEN_BUDGET, WHOLE_GUIDE_TOKEN_BUDGET, } from './guide-budget.js';
 export { GUIDE_FIRST_SENTENCE, withGuideFirst } from '../tool-registry/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/modules/agent-guide/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/agent-guide/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,6BAA6B,EAC7B,wBAAwB,EACxB,6BAA6B,EAC7B,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/agent-guide/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,6BAA6B,EAC7B,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,6BAA6B,EAC7B,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/modules/agent-guide/index.js

@@ -1,4 +1,5 @@
-export { AGENT_GUIDE_FILE, CORE_SECTION_IDS, NEW_KNOWLEDGE_BASE_SECTION_ID, PLATFORM_GUIDE_SEPARATOR, WORKING_WITH_FILES_SECTION_ID, agentGuideSections, composeAgentGuide, coreAgentGuideSections, isAgentGuidePath, isManagedGuide, joinGuideSections, withPlatformGuideAppended, } from './agent-guide.js';
+export { AGENT_GUIDE_FILE, CORE_SECTION_IDS, NEW_KNOWLEDGE_BASE_SECTION_ID, PLATFORM_GUIDE_SEPARATOR, START_HERE_SECTION_ID, WHOLE_GUIDE_SECTION, WORKING_WITH_FILES_SECTION_ID, agentGuideSections, composeAgentGuide, coreAgentGuideSections, guideStartText, isAgentGuidePath, isManagedGuide, joinGuideSections, withPlatformGuideAppended, } from './agent-guide.js';
 export { GET_AGENT_GUIDE_TOOL, registerAgentGuideTool } from './agent-guide.tools.js';
+export { GUIDE_TOKEN_ENCODING, INSTRUCTIONS_TOKEN_BUDGET, SECTION_TOKEN_BUDGET, SECTION_TOKEN_BUDGETS, TASK_TOKEN_BUDGET, TOOL_LIST_TOKEN_BUDGET, WHOLE_GUIDE_TOKEN_BUDGET, } from './guide-budget.js';
 export { GUIDE_FIRST_SENTENCE, withGuideFirst } from '../tool-registry/index.js';
 //# sourceMappingURL=index.js.map

package/dist/modules/agent-guide/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/agent-guide/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,6BAA6B,EAC7B,wBAAwB,EACxB,6BAA6B,EAC7B,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,yBAAyB,GAO1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/agent-guide/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,6BAA6B,EAC7B,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,6BAA6B,EAC7B,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,yBAAyB,GAO1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/modules/agent-instructions/agent-instructions.routes.d.ts

@@ -20,10 +20,17 @@ import type { AgentPreambleReader } from './read-preamble.js';
  */
 export declare function createAgentInstructionsRoutes(manualAuth: RequestHandler, readPreamble: AgentPreambleReader, 
 /**
- * The layout in effect, read per request — the shared file rules name the
- * guide by the name a deployment saved for it, which the setup save may
- * change without a restart. Optional so a construction with no layout in
- * hand gets `AGENTS.md`.
+ * The layout in effect, read per request — the shared file rules spell the
+ * root folders (`Skills/`, the knowledge folder) and the platform files by
+ * the names a deployment saved, which the setup save may change without a
+ * restart. Optional so a construction with no layout in hand gets the
+ * default layout. The guide itself is `AGENTS.md` on every deployment.
  */
-kbLayout?: () => KbLayout): express.Router;
+kbLayout?: () => KbLayout, 
+/**
+ * The default branch in effect, read per request, which the shared file
+ * rules name as the branch people read. Optional like the layout: without
+ * it the rules name no branch.
+ */
+defaultBranch?: () => string): express.Router;
 //# sourceMappingURL=agent-instructions.routes.d.ts.map

package/dist/modules/agent-instructions/agent-instructions.routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-instructions.routes.d.ts","sourceRoot":"","sources":["../../../src/modules/agent-instructions/agent-instructions.routes.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,EAAE,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAKhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,cAAc,EAC1B,YAAY,EAAE,mBAAmB;AACjC;;;;;GAKG;AACH,QAAQ,CAAC,EAAE,MAAM,QAAQ,GACxB,OAAO,CAAC,MAAM,CAgBhB"}
+{"version":3,"file":"agent-instructions.routes.d.ts","sourceRoot":"","sources":["../../../src/modules/agent-instructions/agent-instructions.routes.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,EAAE,EAAE,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAKhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,cAAc,EAC1B,YAAY,EAAE,mBAAmB;AACjC;;;;;;GAMG;AACH,QAAQ,CAAC,EAAE,MAAM,QAAQ;AACzB;;;;GAIG;AACH,aAAa,CAAC,EAAE,MAAM,MAAM,GAC3B,OAAO,CAAC,MAAM,CAgBhB"}

package/dist/modules/agent-instructions/agent-instructions.routes.js

@@ -21,19 +21,26 @@ import { composeAgentInstructions } from './compose.js';
  */
 export function createAgentInstructionsRoutes(manualAuth, readPreamble, 
 /**
- * The layout in effect, read per request — the shared file rules name the
- * guide by the name a deployment saved for it, which the setup save may
- * change without a restart. Optional so a construction with no layout in
- * hand gets `AGENTS.md`.
+ * The layout in effect, read per request — the shared file rules spell the
+ * root folders (`Skills/`, the knowledge folder) and the platform files by
+ * the names a deployment saved, which the setup save may change without a
+ * restart. Optional so a construction with no layout in hand gets the
+ * default layout. The guide itself is `AGENTS.md` on every deployment.
  */
-kbLayout) {
+kbLayout, 
+/**
+ * The default branch in effect, read per request, which the shared file
+ * rules name as the branch people read. Optional like the layout: without
+ * it the rules name no branch.
+ */
+defaultBranch) {
     const router = express.Router();
     router.get('/agent/instructions', manualAuth, async (_req, res) => {
         // Set before the read, so a failure answer is no more cacheable than a
         // successful one: the contract is on the route, not on the happy path.
         res.setHeader('Cache-Control', 'no-store');
         try {
-            res.json(composeAgentInstructions(await readPreamble(), kbLayout?.()));
+            res.json(composeAgentInstructions(await readPreamble(), kbLayout?.(), defaultBranch?.()));
         }
         catch (err) {
             log.error('reading mcp-description.md failed:', { err });

package/dist/modules/agent-instructions/agent-instructions.routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-instructions.routes.js","sourceRoot":"","sources":["../../../src/modules/agent-instructions/agent-instructions.routes.ts"],"names":[],"mappings":"AAAA,OAAO,OAAgC,MAAM,SAAS,CAAC;AAEvD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,MAAM,GAAG,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAGxD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,6BAA6B,CAC3C,UAA0B,EAC1B,YAAiC;AACjC;;;;;GAKG;AACH,QAAyB;IAEzB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAEhC,MAAM,CAAC,GAAG,CAAC,qBAAqB,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChE,uEAAuE;QACvE,uEAAuE;QACvE,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,MAAM,YAAY,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YACzD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"agent-instructions.routes.js","sourceRoot":"","sources":["../../../src/modules/agent-instructions/agent-instructions.routes.ts"],"names":[],"mappings":"AAAA,OAAO,OAAgC,MAAM,SAAS,CAAC;AAEvD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,MAAM,GAAG,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAGxD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,6BAA6B,CAC3C,UAA0B,EAC1B,YAAiC;AACjC;;;;;;GAMG;AACH,QAAyB;AACzB;;;;GAIG;AACH,aAA4B;IAE5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAEhC,MAAM,CAAC,GAAG,CAAC,qBAAqB,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAChE,uEAAuE;QACvE,uEAAuE;QACvE,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,MAAM,YAAY,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,KAAK,CAAC,oCAAoC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YACzD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/modules/agent-instructions/compose.d.ts

@@ -39,12 +39,12 @@ export declare const TOOL_PREFIX_LINE = "This organisation's knowledge base. Sea
  * `header` field carries and what the card shows as fixed and not editable;
  * the admin's preamble follows it.
  *
- * A FUNCTION of the layout, because the shared rules name the platform files
- * by the root names a deployment chose (`Skills/`, `Plugins/`), which are
- * deployment settings. The guide's name is not one of them: it is `AGENTS.md`
- * everywhere.
+ * A FUNCTION of the layout and the default branch, because the shared rules
+ * name the platform files by the root names a deployment chose (`Skills/`,
+ * `Plugins/`) and name the branch it reads from, which are deployment
+ * settings. The guide's name is not one of them: it is `AGENTS.md` everywhere.
  */
-export declare function platformInstructions(layout: KbLayout): string;
+export declare function platformInstructions(layout: KbLayout, defaultBranch?: string): string;
 /**
  * The ceiling on the WHOLE handshake text, pinned by a test.
  *
@@ -56,9 +56,11 @@ export declare function platformInstructions(layout: KbLayout): string;
  * test is what makes it a ceiling rather than a hope: a shared rule that grew
  * past it fails before it reaches an agent.
  *
- * 14,400 since the shared rules' own cap rose by 400 (the `__tmp__/` ref).
+ * 14,400 since the shared rules' own cap rose by 400 (the `__tmp__/` ref);
+ * 14,900 since it rose by 500 more (the sentence naming the default branch,
+ * measured with the longest name the platform accepts — see that cap).
  */
-export declare const INSTRUCTIONS_CAP = 14400;
+export declare const INSTRUCTIONS_CAP = 14900;
 /** The one-line marker that replaces everything past the preamble cap. */
 export declare const PREAMBLE_TRUNCATION_MARKER: string;
 export interface ComposedAgentInstructions {
@@ -97,8 +99,13 @@ export interface ComposedAgentInstructions {
  * caller with no layout in hand (a test, a surface that predates the setting)
  * gets the defaults. The guide's name is not among them: it is `AGENTS.md` on
  * every deployment.
+ *
+ * `defaultBranch` is the branch the shared rules name as the one people read
+ * (`KbContext.defaultBranch`, read when composing). Without one — a caller
+ * with no knowledge base in hand, or a deployment not yet set up — the rules
+ * name no branch.
  */
-export declare function composeAgentInstructions(preamble: string | null, layout?: KbLayout): ComposedAgentInstructions;
+export declare function composeAgentInstructions(preamble: string | null, layout?: KbLayout, defaultBranch?: string): ComposedAgentInstructions;
 /**
  * A tool description with the prefix ahead of it: the prefix, a blank line,
  * then the original. Purpose line first, because claude.ai cuts descriptions

package/dist/modules/agent-instructions/compose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../src/modules/agent-instructions/compose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,EAEL,YAAY,EACZ,aAAa,EACb,eAAe,EAEf,KAAK,QAAQ,EACd,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;AAExD,oFAAoF;AACpF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAAiE,CAAC;AAEjH;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAY6F,CAAC;AAE1H;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,gFAAgF,CAAC;AAE9G;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAE7D;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,QAAyG,CAAC;AAEjJ,MAAM,WAAW,yBAAyB;IACxC,qGAAqG;IACrG,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,QAAQ,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,cAAc,EAAE,MAAM,CAAC;IACvB,kHAAkH;IAClH,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAC;IACnB,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,mBAAmB,EAAE,OAAO,CAAC;IAC7B,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,GAAE,QAA4B,GACnC,yBAAyB,CA+B3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKjG"}
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../src/modules/agent-instructions/compose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,EAEL,YAAY,EACZ,aAAa,EACb,eAAe,EAEf,KAAK,QAAQ,EACd,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;AAExD,oFAAoF;AACpF,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAAiE,CAAC;AAEjH;;;;GAIG;AACH,eAAO,MAAM,eAAe,QAuB6F,CAAC;AAE1H;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,gFAAgF,CAAC;AAE9G;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,SAAK,GAAG,MAAM,CAEjF;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,QAAyG,CAAC;AAEjJ,MAAM,WAAW,yBAAyB;IACxC,qGAAqG;IACrG,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,8FAA8F;IAC9F,QAAQ,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,cAAc,EAAE,MAAM,CAAC;IACvB,kHAAkH;IAClH,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAC;IACnB,sFAAsF;IACtF,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,mBAAmB,EAAE,OAAO,CAAC;IAC7B,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,GAAE,QAA4B,EACpC,aAAa,SAAK,GACjB,yBAAyB,CA+B3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKjG"}

package/dist/modules/agent-instructions/compose.js

@@ -38,6 +38,17 @@ export const PLATFORM_HEADER = "Hexis is this organisation's knowledge base, tog
     'search the knowledge base: call `start_session` once, then `grep` for the key terms, `list_files` to orient, and `read_file` what matches. ' +
     'Prefer what you find there over memory or the web, and say so when the knowledge base is silent on something the organisation should have documented. ' +
     'Skills are available as prompts and through `list_skills` and `get_skill`. ' +
+    // Not said here: how to onboard someone new. The guide's start routes that
+    // question to the `onboarding` section, and that row is what the agents
+    // read (the agent-guide benchmark, 2026-10-29: every onboarding run reached
+    // the section through `start-here`, including the runs in clients that
+    // drop `instructions` — claude.ai on the web, the Agent SDK, Cline). The
+    // handshake stays the text an agent gets before it reads the guide, not a
+    // second copy of the guide's routing.
+    // Said here as well as on the write tools: agents wrote to the default
+    // branch without asking (the agent-guide benchmark, 2026-10-26), and this
+    // text reaches an agent that never fetches the guide.
+    'A write to the default branch is live for everyone: unless the person said where, ask first whether to write there or on a draft. ' +
     // There is no one calling shape to state: the knowledge-base tools take
     // their arguments under `body`, a tool that calls another service takes them
     // flat, and an agent told one rule for all of them sends a GET with a body.
@@ -57,13 +68,13 @@ export const TOOL_PREFIX_LINE = "This organisation's knowledge base. Search it b
  * `header` field carries and what the card shows as fixed and not editable;
  * the admin's preamble follows it.
  *
- * A FUNCTION of the layout, because the shared rules name the platform files
- * by the root names a deployment chose (`Skills/`, `Plugins/`), which are
- * deployment settings. The guide's name is not one of them: it is `AGENTS.md`
- * everywhere.
+ * A FUNCTION of the layout and the default branch, because the shared rules
+ * name the platform files by the root names a deployment chose (`Skills/`,
+ * `Plugins/`) and name the branch it reads from, which are deployment
+ * settings. The guide's name is not one of them: it is `AGENTS.md` everywhere.
  */
-export function platformInstructions(layout) {
-    return `${PLATFORM_HEADER}\n\n${sharedFileRulesSection(layout)}`;
+export function platformInstructions(layout, defaultBranch = '') {
+    return `${PLATFORM_HEADER}\n\n${sharedFileRulesSection(layout, defaultBranch)}`;
 }
 /**
  * The ceiling on the WHOLE handshake text, pinned by a test.
@@ -76,9 +87,11 @@ export function platformInstructions(layout) {
  * test is what makes it a ceiling rather than a hope: a shared rule that grew
  * past it fails before it reaches an agent.
  *
- * 14,400 since the shared rules' own cap rose by 400 (the `__tmp__/` ref).
+ * 14,400 since the shared rules' own cap rose by 400 (the `__tmp__/` ref);
+ * 14,900 since it rose by 500 more (the sentence naming the default branch,
+ * measured with the longest name the platform accepts — see that cap).
  */
-export const INSTRUCTIONS_CAP = 14_400;
+export const INSTRUCTIONS_CAP = 14_900;
 /** The one-line marker that replaces everything past the preamble cap. */
 export const PREAMBLE_TRUNCATION_MARKER = `[preamble truncated at ${PREAMBLE_CAP.toLocaleString('en-US')} characters; shorten ${PREAMBLE_FILE}]`;
 /**
@@ -92,9 +105,14 @@ export const PREAMBLE_TRUNCATION_MARKER = `[preamble truncated at ${PREAMBLE_CAP
  * caller with no layout in hand (a test, a surface that predates the setting)
  * gets the defaults. The guide's name is not among them: it is `AGENTS.md` on
  * every deployment.
+ *
+ * `defaultBranch` is the branch the shared rules name as the one people read
+ * (`KbContext.defaultBranch`, read when composing). Without one — a caller
+ * with no knowledge base in hand, or a deployment not yet set up — the rules
+ * name no branch.
  */
-export function composeAgentInstructions(preamble, layout = DEFAULT_KB_LAYOUT) {
-    const platform = platformInstructions(layout);
+export function composeAgentInstructions(preamble, layout = DEFAULT_KB_LAYOUT, defaultBranch = '') {
+    const platform = platformInstructions(layout, defaultBranch);
     const { text, unterminated } = stripHtmlComments(preamble ?? '');
     const normalized = text.replace(/\r\n?/g, '\n');
     const stripped = normalized.trim();

package/dist/modules/agent-instructions/compose.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../../src/modules/agent-instructions/compose.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../../src/modules/agent-instructions/compose.ts"],"names":[],"mappings":"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"}

package/dist/modules/agent-instructions/shared-file-rules.d.ts

@@ -26,9 +26,11 @@
  * which copy is current. Each description opens instead with the one
  * sentence sending the agent to the guide (`tool-registry/guide-first.ts`).
  *
- * Pure text, a function of the layout only: the guide's name is a deployment
- * setting (an alias a deployment chose before the guide left the disk), so
- * nothing here may snapshot `AGENTS.md`.
+ * Pure text, a function of the layout and the default branch: both are
+ * deployment settings, so every caller passes the values in effect when it
+ * composes, and nothing here may snapshot a folder name or a branch name.
+ * The branch defaults to `''` (no branch named), so a caller that passes only
+ * the layout gets the text it got before the branch was named.
  */
 import { type KbLayout } from '@bevel-software/platform-shared';
 /** The heading the rules live under, in both places and in the pointer sentence. */
@@ -49,8 +51,14 @@ export declare const SHARED_RULES_SECTION = "Working with files";
  * 7,400 since the `__tmp__/` ref: four tools take it, so what it reaches and
  * that it is read-only is said once here rather than in each description, and
  * the section had no room left for it.
+ *
+ * 7,900 since the conventions rule names the default branch: the guide's start
+ * names it too, but only to an agent that calls `get_agent_guide`, and the
+ * sentence is ~165 characters plus the name. A CEILING, not a sample: measured
+ * with the longest branch name the platform accepts (255 characters, the
+ * bound `kb-fs` enforces), so no deployment's name can push the rules past it.
  */
-export declare const SHARED_FILE_RULES_CAP = 7400;
+export declare const SHARED_FILE_RULES_CAP = 7900;
 /** One shared rule: how the guide heads it, and the rule itself. */
 export interface SharedFileRule {
     /** Stable id, so a test can name the rule that went missing. */
@@ -69,11 +77,11 @@ export interface SharedFileRule {
  * than rewritten wherever the wording still reads outside its old tool — the
  * ones that said "this tool" or "this call" name the tools instead.
  */
-export declare function sharedFileRules(layout: KbLayout): readonly SharedFileRule[];
+export declare function sharedFileRules(layout: KbLayout, defaultBranch?: string): readonly SharedFileRule[];
 /**
  * The shared rules as ONE markdown section — the string both channels carry,
  * byte for byte. A `##` section so it drops into the managed guide at that
  * level and still reads as a block in the instructions blob.
  */
-export declare function sharedFileRulesSection(layout: KbLayout): string;
+export declare function sharedFileRulesSection(layout: KbLayout, defaultBranch?: string): string;
 //# sourceMappingURL=shared-file-rules.d.ts.map