@osovv/vv-opencode 1.2.8 → 1.2.11

package/dist/plugins/tool-history-compaction/prune.js

@@ -0,0 +1,70 @@
+// FILE: src/plugins/tool-history-compaction/prune.ts
+// VERSION: 0.1.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Deterministic head/marker/tail pruning of over-budget tool outputs with code-point-safe slicing, min-savings guard, and marker-based idempotence.
+//   SCOPE: Code-point counting and slicing, the fixed prune marker, the prune decision function, and already-compacted detection.
+//   DEPENDS: [src/plugins/tool-history-compaction/config.ts]
+//   LINKS: [M-PLUGIN-TOOL-HISTORY-COMPACTION]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   PRUNE_MARKER - Fixed marker substituted for every pruned output middle.
+//   countCodePoints - Unicode code-point count without splitting surrogate pairs.
+//   codePointSlice - Slice text by code points.
+//   pruneOutput - Return the pruned form when eligible, otherwise null.
+//   alreadyCompacted - Whether text already carries the prune marker.
+//   PruneResult - Pruned output plus measured savings.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v0.1.0 - Established the DSH-style head/marker/tail prune engine.]
+// END_CHANGE_SUMMARY
+// START_BLOCK_CONSTANTS
+/** Fixed marker substituted for every pruned output middle. */
+export const PRUNE_MARKER = "[... tool output pruned ...]";
+// END_BLOCK_CONSTANTS
+// START_BLOCK_MEASURE
+/** Count Unicode code points without splitting surrogate pairs. */
+export function countCodePoints(text) {
+    return Array.from(text).length;
+}
+/** Slice text by code points, never splitting a surrogate pair. */
+export function codePointSlice(text, start, end) {
+    return Array.from(text).slice(start, end).join("");
+}
+// END_BLOCK_MEASURE
+// START_BLOCK_DETECT
+/** Whether text already carries the prune marker (previous compaction pass). */
+export function alreadyCompacted(text) {
+    return typeof text === "string" && text.includes(PRUNE_MARKER);
+}
+/**
+ * Prune an over-budget output to head + marker + tail.
+ * Returns null when the output is ineligible: non-string, pruning disabled,
+ * under threshold, already compacted, or savings below minSavingsChars.
+ * @param text - tool output text.
+ * @param config - resolved compaction config.
+ * @returns pruned form or null.
+ */
+export function pruneOutput(text, config) {
+    if (typeof text !== "string" || text.length === 0)
+        return null;
+    if (config.outputMaxChars <= 0)
+        return null;
+    if (alreadyCompacted(text))
+        return null;
+    const length = countCodePoints(text);
+    if (length <= config.outputMaxChars)
+        return null;
+    const head = codePointSlice(text, 0, config.headChars);
+    const tail = codePointSlice(text, length - config.tailChars, length);
+    const output = head + PRUNE_MARKER + tail;
+    const savings = length - countCodePoints(output);
+    if (savings < config.minSavingsChars)
+        return null;
+    return { output, savings };
+}
+// END_BLOCK_PRUNE
+//# sourceMappingURL=prune.js.map

package/dist/plugins/tool-history-compaction/prune.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prune.js","sourceRoot":"","sources":["../../../src/plugins/tool-history-compaction/prune.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,iBAAiB;AACjB,wBAAwB;AACxB,+JAA+J;AAC/J,kIAAkI;AAClI,6DAA6D;AAC7D,8CAA8C;AAC9C,kBAAkB;AAClB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,4EAA4E;AAC5E,kFAAkF;AAClF,gDAAgD;AAChD,wEAAwE;AACxE,sEAAsE;AACtE,uDAAuD;AACvD,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,qFAAqF;AACrF,qBAAqB;AAIrB,wBAAwB;AACxB,+DAA+D;AAC/D,MAAM,CAAC,MAAM,YAAY,GAAG,8BAA8B,CAAC;AAC3D,sBAAsB;AAEtB,sBAAsB;AACtB,mEAAmE;AACnE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AACjC,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW;IACrE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrD,CAAC;AACD,oBAAoB;AAEpB,qBAAqB;AACrB,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACjE,CAAC;AASD;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAmC;IAC3E,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,MAAM,CAAC,cAAc,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,gBAAgB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAExC,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,MAAM,IAAI,MAAM,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IAEjD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,OAAO,GAAG,MAAM,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IAElD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AACD,kBAAkB"}

package/dist/plugins/tool-history-compaction/read-slim.d.ts

@@ -0,0 +1,27 @@
+import type { ToolHistoryCompactionConfig } from "./config.js";
+export interface ReadInputLike {
+    filePath?: unknown;
+    path?: unknown;
+    file?: unknown;
+}
+/** Recover the file path from read input aliases; unknown values yield undefined. */
+export declare function fileFromReadInput(input: ReadInputLike | undefined): string | undefined;
+/**
+ * Recover the covered line range ("first-last") from a line-numbered output.
+ * Returns undefined when the output is not deterministically line-numbered.
+ */
+export declare function rangeFromReadOutput(output: string | undefined): string | undefined;
+export interface SlimReadResult {
+    output: string;
+    savings: number;
+}
+/**
+ * Collapse an old read output to [Read <file>, lines X-Y] when the file is
+ * recoverable and the savings clear the min-savings guard. Returns null when
+ * not applicable; the caller falls back to output pruning (never fabricates).
+ * @param input - part.state.input.
+ * @param output - part.state.output.
+ * @param config - resolved compaction config.
+ * @returns slim form or null.
+ */
+export declare function slimReadOutput(input: unknown, output: unknown, config: ToolHistoryCompactionConfig): SlimReadResult | null;

package/dist/plugins/tool-history-compaction/read-slim.js

@@ -0,0 +1,91 @@
+// FILE: src/plugins/tool-history-compaction/read-slim.ts
+// VERSION: 0.1.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Collapse old read tool outputs to a compact [Read <file>, lines X-Y] header, recovering the file from the input and the line range from the output when deterministically available.
+//   SCOPE: Read input file extraction, line-numbered output range recovery, savings-gated slim decision, and idempotence detection.
+//   DEPENDS: [src/plugins/tool-history-compaction/config.ts]
+//   LINKS: [M-PLUGIN-TOOL-HISTORY-COMPACTION]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   fileFromReadInput - Recover the file path from read input aliases.
+//   ReadInputLike - Read input object with filePath/path/file aliases.
+//   rangeFromReadOutput - Recover the covered line range from a line-numbered output.
+//   slimReadOutput - Return the [Read <file>] form when eligible, otherwise null (fallback to pruning).
+//   SlimReadResult - Slim form plus measured savings.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v0.1.0 - Established old-read collapse with fail-closed fallback.]
+// END_CHANGE_SUMMARY
+import { countCodePoints } from "./prune.js";
+// START_BLOCK_RANGE
+// Matches a line-numbered output line: OpenCode "N| content" / "N: content"
+// and hashline anchored "N#ID#ANCHOR|content". Never fabricates a number.
+const LINE_NUMBER_PREFIX = /^\s*(\d+)(?:#[^|:]*)?(?:\||:)/;
+/** Recover the file path from read input aliases; unknown values yield undefined. */
+export function fileFromReadInput(input) {
+    if (!input || typeof input !== "object")
+        return undefined;
+    for (const key of ["filePath", "path", "file"]) {
+        const value = input[key];
+        if (typeof value === "string" && value.length > 0)
+            return value;
+    }
+    return undefined;
+}
+// END_BLOCK_FILE
+// START_BLOCK_RANGE_FN
+/**
+ * Recover the covered line range ("first-last") from a line-numbered output.
+ * Returns undefined when the output is not deterministically line-numbered.
+ */
+export function rangeFromReadOutput(output) {
+    if (typeof output !== "string" || output.length === 0)
+        return undefined;
+    let first;
+    let last;
+    for (const line of output.split("\n")) {
+        const match = LINE_NUMBER_PREFIX.exec(line);
+        if (match) {
+            const number = Number.parseInt(match[1] ?? "0", 10);
+            if (first === undefined)
+                first = number;
+            last = number;
+        }
+    }
+    if (first === undefined || last === undefined || first > last)
+        return undefined;
+    return `${first}-${last}`;
+}
+function alreadySlimmed(output) {
+    return output.startsWith("[Read ");
+}
+/**
+ * Collapse an old read output to [Read <file>, lines X-Y] when the file is
+ * recoverable and the savings clear the min-savings guard. Returns null when
+ * not applicable; the caller falls back to output pruning (never fabricates).
+ * @param input - part.state.input.
+ * @param output - part.state.output.
+ * @param config - resolved compaction config.
+ * @returns slim form or null.
+ */
+export function slimReadOutput(input, output, config) {
+    if (typeof output !== "string" || output.length === 0)
+        return null;
+    if (alreadySlimmed(output))
+        return null;
+    const file = fileFromReadInput(input);
+    if (file === undefined)
+        return null;
+    const range = rangeFromReadOutput(output);
+    const slim = range === undefined ? `[Read ${file}]` : `[Read ${file}, lines ${range}]`;
+    const savings = countCodePoints(output) - countCodePoints(slim);
+    if (savings < config.minSavingsChars)
+        return null;
+    return { output: slim, savings };
+}
+// END_BLOCK_SLIM
+//# sourceMappingURL=read-slim.js.map

package/dist/plugins/tool-history-compaction/read-slim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-slim.js","sourceRoot":"","sources":["../../../src/plugins/tool-history-compaction/read-slim.ts"],"names":[],"mappings":"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"}

package/dist/plugins/tool-history-compaction/retention.d.ts

@@ -0,0 +1,10 @@
+/** Knowledge-tool substrings: results that stay relevant for the whole session. */
+export declare const DEFAULT_RETAIN_TOOLS: readonly string[];
+export type RetainTools = readonly string[];
+/**
+ * Whether a tool name matches any retain substring, case-insensitively.
+ * @param tool - tool name from a message part.
+ * @param retainTools - configured retain substrings.
+ * @returns true when the tool output must never be compacted.
+ */
+export declare function isRetainedTool(tool: string | undefined, retainTools: RetainTools): boolean;

package/dist/plugins/tool-history-compaction/retention.js

@@ -0,0 +1,45 @@
+// FILE: src/plugins/tool-history-compaction/retention.ts
+// VERSION: 0.1.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Classify tool outputs into knowledge (retained) versus ephemeral (compaction-eligible) by case-insensitive substring matching on the tool name.
+//   SCOPE: The pure isRetainedTool predicate; the default retention list is re-exported from the shared lib table.
+//   DEPENDS: [src/lib/plugin-toggle-config.ts]
+//   LINKS: [M-PLUGIN-TOOL-HISTORY-COMPACTION]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   DEFAULT_RETAIN_TOOLS - Default knowledge-tool substrings (re-exported from the shared lib table).
+//   RetainTools - Readonly array of case-insensitive tool-name substrings.
+//   isRetainedTool - Whether a tool name matches any retain substring.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v0.1.0 - Established the knowledge-versus-ephemeral retention classification; defaults owned by the shared lib table.]
+// END_CHANGE_SUMMARY
+import { DEFAULT_TOOL_HISTORY_COMPACTION_RETAIN_TOOLS } from "../../lib/plugin-toggle-config.js";
+// START_BLOCK_DEFAULTS
+/** Knowledge-tool substrings: results that stay relevant for the whole session. */
+export const DEFAULT_RETAIN_TOOLS = DEFAULT_TOOL_HISTORY_COMPACTION_RETAIN_TOOLS;
+// END_BLOCK_DEFAULTS
+// START_BLOCK_MATCH
+/**
+ * Whether a tool name matches any retain substring, case-insensitively.
+ * @param tool - tool name from a message part.
+ * @param retainTools - configured retain substrings.
+ * @returns true when the tool output must never be compacted.
+ */
+export function isRetainedTool(tool, retainTools) {
+    if (typeof tool !== "string" || tool.length === 0)
+        return false;
+    const lower = tool.toLowerCase();
+    for (const pattern of retainTools) {
+        if (pattern.length > 0 && lower.includes(pattern.toLowerCase())) {
+            return true;
+        }
+    }
+    return false;
+}
+// END_BLOCK_MATCH
+//# sourceMappingURL=retention.js.map

package/dist/plugins/tool-history-compaction/retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.js","sourceRoot":"","sources":["../../../src/plugins/tool-history-compaction/retention.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,iBAAiB;AACjB,wBAAwB;AACxB,6JAA6J;AAC7J,mHAAmH;AACnH,+CAA+C;AAC/C,8CAA8C;AAC9C,kBAAkB;AAClB,sBAAsB;AACtB,sBAAsB;AACtB,EAAE;AACF,mBAAmB;AACnB,sGAAsG;AACtG,2EAA2E;AAC3E,uEAAuE;AACvE,iBAAiB;AACjB,EAAE;AACF,uBAAuB;AACvB,yIAAyI;AACzI,qBAAqB;AACrB,OAAO,EAAE,4CAA4C,EAAE,MAAM,mCAAmC,CAAC;AAEjG,uBAAuB;AACvB,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAAsB,4CAA4C,CAAC;AAIpG,qBAAqB;AAErB,oBAAoB;AACpB;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAwB,EAAE,WAAwB;IAC/E,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AACD,kBAAkB"}

package/dist/plugins/tool-history-compaction/transform.d.ts

@@ -0,0 +1,15 @@
+import type { Part } from "@opencode-ai/sdk";
+import type { ToolHistoryCompactionConfig } from "./config.js";
+export interface TransformMessage {
+    info: unknown;
+    parts: Part[];
+}
+/**
+ * Deterministically rewrite eligible tool part outputs in place.
+ * Model-agnostic: the current model is not needed. Non-destructive to inputs,
+ * part structure, and ordering. Idempotent: already-compacted parts are skipped
+ * by their markers, so a second pass is a no-op.
+ * @param messages - the transform hook's in-memory message list.
+ * @param config - resolved compaction config.
+ */
+export declare function compactMessages(messages: TransformMessage[], config: ToolHistoryCompactionConfig): void;

package/dist/plugins/tool-history-compaction/transform.js

@@ -0,0 +1,93 @@
+// FILE: src/plugins/tool-history-compaction/transform.ts
+// VERSION: 0.1.0
+// START_MODULE_CONTRACT
+//   PURPOSE: Apply tool-history compaction to the in-memory message list the model is about to receive: walk messages newest-first, protect the recent tail, dispatch retained/read/other tools to the right compaction layer, and mutate only completed tool part outputs.
+//   SCOPE: Completed-tool-part detection, protected-tail accounting, retention dispatch, read-slim and prune application, and idempotent in-place output rewrites.
+//   DEPENDS: [src/plugins/tool-history-compaction/config.ts, src/plugins/tool-history-compaction/retention.ts, src/plugins/tool-history-compaction/prune.ts, src/plugins/tool-history-compaction/read-slim.ts]
+//   LINKS: [M-PLUGIN-TOOL-HISTORY-COMPACTION]
+//   ROLE: RUNTIME
+//   MAP_MODE: EXPORTS
+// END_MODULE_CONTRACT
+//
+// START_MODULE_MAP
+//   TransformMessage - One message entry in the transform hook output.
+//   compactMessages - Deterministically rewrite eligible tool part outputs in place.
+// END_MODULE_MAP
+//
+// START_CHANGE_SUMMARY
+//   LAST_CHANGE: [v0.1.0 - Established the transform core with protected tail, retention dispatch, and idempotence.]
+// END_CHANGE_SUMMARY
+import { pruneOutput } from "./prune.js";
+import { slimReadOutput } from "./read-slim.js";
+import { isRetainedTool } from "./retention.js";
+function isCompletedToolPart(part) {
+    return part.type === "tool" && part.state.status === "completed";
+}
+function isCompactedByOpencode(part) {
+    const time = part.state.time;
+    return (typeof time === "object" && time !== null && "compacted" in time && time.compacted !== undefined);
+}
+function isReadTool(tool) {
+    return tool.toLowerCase() === "read";
+}
+// END_BLOCK_GUARDS
+// START_BLOCK_COMPACT
+/**
+ * Deterministically rewrite eligible tool part outputs in place.
+ * Model-agnostic: the current model is not needed. Non-destructive to inputs,
+ * part structure, and ordering. Idempotent: already-compacted parts are skipped
+ * by their markers, so a second pass is a no-op.
+ * @param messages - the transform hook's in-memory message list.
+ * @param config - resolved compaction config.
+ */
+export function compactMessages(messages, config) {
+    let remainingProtection = config.protectLastCalls;
+    let firstMessage = true;
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const message = messages[i];
+        if (!message)
+            continue;
+        for (let j = message.parts.length - 1; j >= 0; j--) {
+            const part = message.parts[j];
+            if (!part || part.type !== "tool")
+                continue;
+            if (!isCompletedToolPart(part))
+                continue;
+            if (isCompactedByOpencode(part))
+                continue;
+            const withinTail = firstMessage || remainingProtection > 0;
+            if (withinTail) {
+                if (!firstMessage)
+                    remainingProtection -= 1;
+                continue;
+            }
+            if (isRetainedTool(part.tool, config.retainTools))
+                continue;
+            const output = part.state.output;
+            let rewritten;
+            if (config.readSlim && isReadTool(part.tool)) {
+                const slim = slimReadOutput(part.state.input, output, config);
+                if (slim) {
+                    rewritten = slim.output;
+                }
+                else {
+                    const pruned = pruneOutput(output, config);
+                    if (pruned)
+                        rewritten = pruned.output;
+                }
+            }
+            else {
+                const pruned = pruneOutput(output, config);
+                if (pruned)
+                    rewritten = pruned.output;
+            }
+            if (rewritten !== undefined && rewritten !== output) {
+                part.state.output = rewritten;
+            }
+        }
+        if (firstMessage)
+            firstMessage = false;
+    }
+}
+// END_BLOCK_COMPACT
+//# sourceMappingURL=transform.js.map

package/dist/plugins/tool-history-compaction/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../src/plugins/tool-history-compaction/transform.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osovv/vv-opencode",
-  "version": "1.2.8",
+  "version": "1.2.11",
   "description": "A curated, opinionated set of OpenCode plugins for spec-first, review-driven, safer agentic development.",
   "type": "module",
   "main": "./dist/index.js",
@@ -73,6 +73,10 @@
     "./plugins/web-tools": {
       "types": "./dist/plugins/web-tools/index.d.ts",
       "import": "./dist/plugins/web-tools/index.js"
+    },
+    "./plugins/tool-history-compaction": {
+      "types": "./dist/plugins/tool-history-compaction/index.d.ts",
+      "import": "./dist/plugins/tool-history-compaction/index.js"
     }
   },
   "scripts": {

package/schemas/vvoc/v3.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://cdn.jsdelivr.net/npm/@osovv/vv-opencode@1.2.8/schemas/vvoc/v3.json",
+  "$id": "https://cdn.jsdelivr.net/npm/@osovv/vv-opencode@1.2.11/schemas/vvoc/v3.json",
   "title": "vvoc config",
   "description": "Canonical vvoc configuration document.",
   "type": "object",
@@ -162,6 +162,20 @@
                 }
               }
             }
+          },
+          {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "enabled": { "type": "boolean" },
+              "protectLastCalls": { "type": "integer", "minimum": 0 },
+              "minSavingsChars": { "type": "integer", "minimum": 0 },
+              "outputMaxChars": { "type": "integer", "minimum": 0 },
+              "headChars": { "type": "integer", "minimum": 0 },
+              "tailChars": { "type": "integer", "minimum": 0 },
+              "readSlim": { "type": "boolean" },
+              "retainTools": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+            }
           }
         ]
       }

package/templates/agents/vv-controller.md

@@ -98,6 +98,7 @@ next safe step. Make it sufficient to resume without rediscovering settled facts
 <final_response_format>
 - Start with the outcome.
 - For review, analysis, planning, or investigation, start with findings or the plan.
+- Before claiming completion, read the goal back line by line and mark each line met / partly / not met, then name the edge you did not check.
 - Mention changed files and verification only when implementation occurred.
 - Mention assumptions, skipped checks, blockers, or residual risks when they materially affect the
   outcome.