fix: surface agents bootstrap truncation warning

galiniliev · galiniliev · commit 1e74e7a5e422 · 2026-05-20T02:43:49.000Z
diff --git a/src/agents/bootstrap-budget.test.ts b/src/agents/bootstrap-budget.test.ts
@@ -326,6 +326,28 @@ describe("bootstrap prompt warnings", () => {
     expect(lines).toContain("+1 more truncated file(s).");
   });
 
+  it("warns explicitly when AGENTS.md bootstrap policy is truncated", () => {
+    const analysis = analyzeBootstrapBudget({
+      files: [
+        {
+          name: "AGENTS.md",
+          path: "/tmp/AGENTS.md",
+          missing: false,
+          rawChars: 150,
+          injectedChars: 100,
+          truncated: true,
+        },
+      ],
+      bootstrapMaxChars: 120,
+      bootstrapTotalMaxChars: 200,
+    });
+    const lines = formatBootstrapTruncationWarningLines({ analysis });
+
+    expect(lines).toContain(
+      "AGENTS.md was truncated; read the full AGENTS.md before relying on scoped policy.",
+    );
+  });
+
   it("disambiguates duplicate file names in warning lines", () => {
     const analysis = analyzeBootstrapBudget({
       files: [
@@ -390,6 +412,7 @@ describe("bootstrap prompt warnings", () => {
     expect(always.warningShown).toBe(true);
     expect(always.lines).toStrictEqual([
       "AGENTS.md: 150 raw -> 100 injected (~33% removed; max/file).",
+      "AGENTS.md was truncated; read the full AGENTS.md before relying on scoped policy.",
       "If unintentional, raise agents.defaults.bootstrapMaxChars and/or agents.defaults.bootstrapTotalMaxChars.",
     ]);
   });
diff --git a/src/agents/bootstrap-budget.ts b/src/agents/bootstrap-budget.ts
@@ -68,6 +68,10 @@ function formatWarningCause(cause: BootstrapTruncationCause): string {
   return cause === "per-file-limit" ? "max/file" : "max/total";
 }
 
+function isAgentsBootstrapName(name: string): boolean {
+  return name.toLowerCase() === "agents.md";
+}
+
 function normalizeSeenSignatures(signatures?: string[]): string[] {
   if (!Array.isArray(signatures) || signatures.length === 0) {
     return [];
@@ -293,6 +297,9 @@ export function formatBootstrapTruncationWarningLines(params: {
       `+${params.analysis.truncatedFiles.length - topFiles.length} more truncated file(s).`,
     );
   }
+  if (params.analysis.truncatedFiles.some((file) => isAgentsBootstrapName(file.name))) {
+    lines.push("AGENTS.md was truncated; read the full AGENTS.md before relying on scoped policy.");
+  }
   lines.push(
     "If unintentional, raise agents.defaults.bootstrapMaxChars and/or agents.defaults.bootstrapTotalMaxChars.",
   );
diff --git a/src/agents/pi-embedded-helpers/bootstrap.ts b/src/agents/pi-embedded-helpers/bootstrap.ts
@@ -207,7 +207,7 @@ function buildAgentsPolicyDigest(content: string, budget: number): PolicyDigest
 
   const lines = candidates
     .filter((candidate) => selected.has(candidate.index))
-    .sort((a, b) => a.index - b.index)
+    .toSorted((a, b) => a.index - b.index)
     .map((candidate) => candidate.line);
   return {
     text: lines.join("\n"),
