@pellux/goodvibes-sdk 0.33.18 → 0.33.20

package/dist/contracts/artifacts/operator-contract.json

@@ -3,7 +3,7 @@
   "product": {
     "id": "goodvibes",
     "surface": "operator",
-    "version": "0.33.18"
+    "version": "0.33.20"
   },
   "auth": {
     "modes": [

package/dist/platform/agents/completion-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"completion-report.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/completion-report.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"completion-report.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/completion-report.ts"],"names":[],"mappings":"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"}

package/dist/platform/agents/completion-report.js

@@ -10,16 +10,46 @@ function isWellFormedConstraint(c) {
         typeof obj['text'] === 'string' && obj['text'].length > 0 &&
         obj['source'] === 'prompt');
 }
-/** Returns true if a ConstraintFinding entry is well-formed. */
-function isWellFormedConstraintFinding(f) {
+function evidenceToString(evidence) {
+    if (typeof evidence === 'string') {
+        const trimmed = evidence.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    if (typeof evidence === 'number' || typeof evidence === 'boolean') {
+        return String(evidence);
+    }
+    if (Array.isArray(evidence) || (typeof evidence === 'object' && evidence !== null)) {
+        try {
+            const serialized = JSON.stringify(evidence);
+            return serialized.length > 0 && serialized !== 'null' ? serialized : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+/** Normalizes a ConstraintFinding entry, tolerating common model evidence shapes. */
+function normalizeConstraintFinding(f) {
     if (typeof f !== 'object' || f === null)
-        return false;
+        return null;
     const obj = f;
     const severity = obj['severity'];
-    return (typeof obj['constraintId'] === 'string' && obj['constraintId'].length > 0 &&
-        typeof obj['satisfied'] === 'boolean' &&
-        typeof obj['evidence'] === 'string' && obj['evidence'].length > 0 &&
-        (severity === undefined || severity === 'critical' || severity === 'major' || severity === 'minor'));
+    const evidence = evidenceToString(obj['evidence']);
+    if (typeof obj['constraintId'] !== 'string' || obj['constraintId'].length === 0 ||
+        typeof obj['satisfied'] !== 'boolean' ||
+        evidence === null) {
+        return null;
+    }
+    const finding = {
+        constraintId: obj['constraintId'],
+        satisfied: obj['satisfied'],
+        evidence,
+    };
+    if (severity === 'critical' || severity === 'major' || severity === 'minor') {
+        finding.severity = severity;
+    }
+    return finding;
 }
 function filterWellFormed(raw, guard) {
     if (raw === undefined)
@@ -38,6 +68,24 @@ function filterWellFormed(raw, guard) {
     }
     return { items, dropped, malformedContainer: false };
 }
+function normalizeConstraintFindingList(raw) {
+    if (raw === undefined)
+        return { items: [], dropped: 0, malformedContainer: false };
+    if (!Array.isArray(raw))
+        return { items: [], dropped: 0, malformedContainer: true };
+    const items = [];
+    let dropped = 0;
+    for (const item of raw) {
+        const normalized = normalizeConstraintFinding(item);
+        if (normalized) {
+            items.push(normalized);
+        }
+        else {
+            dropped += 1;
+        }
+    }
+    return { items, dropped, malformedContainer: false };
+}
 function appendEngineerIssue(report, issue) {
     const existing = Array.isArray(report['issues'])
         ? report['issues'].filter((item) => typeof item === 'string')
@@ -136,13 +184,13 @@ function applyConstraintDefaults(parsed) {
         }
     }
     if (next['archetype'] === 'reviewer') {
-        const normalized = filterWellFormed(next['constraintFindings'], isWellFormedConstraintFinding);
+        const normalized = normalizeConstraintFindingList(next['constraintFindings']);
         next['constraintFindings'] = normalized.items;
         if (normalized.malformedContainer) {
-            appendReviewerIssue(next, 'Malformed constraintFindings field ignored: expected an array.');
+            appendReviewerIssue(next, 'Malformed constraintFindings field ignored: expected an array of {constraintId:string,satisfied:boolean,evidence:string,severity?:critical|major|minor}.');
         }
         else if (normalized.dropped > 0) {
-            appendReviewerIssue(next, `Malformed constraintFindings ignored: ${normalized.dropped} entr${normalized.dropped === 1 ? 'y' : 'ies'}.`);
+            appendReviewerIssue(next, `Malformed constraintFindings ignored: ${normalized.dropped} entr${normalized.dropped === 1 ? 'y' : 'ies'}; expected {constraintId:string,satisfied:boolean,evidence:string,severity?:critical|major|minor}.`);
         }
     }
     return next;

package/dist/platform/agents/wrfc-prompt-addenda.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrfc-prompt-addenda.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/wrfc-prompt-addenda.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAerF,wBAAgB,+BAA+B,IAAI,MAAM,CAiCxD;AAGD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,IAAI,MAAM,CAqBxD;AAGD;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAgBrD"}
+{"version":3,"file":"wrfc-prompt-addenda.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/wrfc-prompt-addenda.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAerF,wBAAgB,+BAA+B,IAAI,MAAM,CAiCxD;AAGD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,IAAI,MAAM,CAuCxD;AAGD;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAgBrD"}

package/dist/platform/agents/wrfc-prompt-addenda.js

@@ -67,6 +67,24 @@ The engineer's \`EngineerReport.constraints\` is the authoritative list of user-
 2. Cite concrete evidence — a file and line, a diff observation, or a test behavior. "Looks fine" is not evidence.
 3. Emit a \`constraintFindings[]\` entry referencing \`constraintId\`.
 
+**Exact JSON shape required:**
+\`\`\`json
+{
+  "constraintFindings": [
+    {
+      "constraintId": "c1",
+      "satisfied": true,
+      "evidence": "Concrete proof as a single string.",
+      "severity": "major"
+    }
+  ]
+}
+\`\`\`
+
+- \`constraintId\`, \`satisfied\`, and \`evidence\` are required.
+- \`evidence\` must be a non-empty string, not an object or array.
+- \`severity\` is optional and only valid as \`"critical"\`, \`"major"\`, or \`"minor"\`.
+
 **Severity rules for unsatisfied constraints**:
 - A violated hard limit (size, perf target, explicitly forbidden API) → **critical**.
 - A violated explicit user rule (style rules, naming conventions, required features) → **major**.

package/dist/platform/agents/wrfc-reporting.d.ts

@@ -1,11 +1,15 @@
 import type { CompletionReport, Constraint, ConstraintFinding, ReviewerReport } from './completion-report.js';
 import type { QualityGateResult } from './wrfc-types.js';
+type ReviewableCompletionReport = CompletionReport & {
+    reviewableOutput?: string | undefined;
+};
 export declare function extractScoreFromText(text: string): number | null;
 export declare function extractPassedFromText(text: string, score: number, threshold: number): boolean;
 export declare function extractIssuesFromText(text: string): ReviewerReport['issues'];
-export declare function parseEngineerCompletionReport(rawOutput: string, _template?: string): CompletionReport;
+export declare function parseEngineerCompletionReport(rawOutput: string, _template?: string): ReviewableCompletionReport;
 export declare function parseReviewerCompletionReport(chainId: string, rawOutput: string, threshold: number): ReviewerReport;
-export declare function buildReviewTask(chainId: string, originalTask: string, report: CompletionReport, threshold: number, constraints?: Constraint[]): string;
+export declare function buildReviewTask(chainId: string, originalTask: string, report: ReviewableCompletionReport, threshold: number, constraints?: Constraint[]): string;
 export declare function buildFixTask(chainId: string, originalTask: string, review: ReviewerReport, threshold: number, fixAttempts: number, constraints?: Constraint[], constraintFindings?: ConstraintFinding[]): string;
 export declare function buildGateFailureTask(chainId: string, task: string, failedGates: readonly QualityGateResult[], constraints?: readonly Constraint[]): string;
+export {};
 //# sourceMappingURL=wrfc-reporting.d.ts.map

package/dist/platform/agents/wrfc-reporting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrfc-reporting.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/wrfc-reporting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAkB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG9H,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAOzD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBhE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAK7F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAa5E;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAiBrG;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,cAAc,CA6BhB;AAID,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,gBAAgB,EACxB,SAAS,EAAE,MAAM,EACjB,WAAW,GAAE,UAAU,EAAO,GAC7B,MAAM,CAkDR;AA0FD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,UAAU,EAAO,EAC9B,kBAAkB,GAAE,iBAAiB,EAAO,GAC3C,MAAM,CA6DR;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,SAAS,iBAAiB,EAAE,EACzC,WAAW,GAAE,SAAS,UAAU,EAAO,GACtC,MAAM,CAuCR"}
+{"version":3,"file":"wrfc-reporting.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/wrfc-reporting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,iBAAiB,EAAkB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG9H,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAQzD,KAAK,0BAA0B,GAAG,gBAAgB,GAAG;IACnD,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBhE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAK7F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAa5E;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,0BAA0B,CAkB/G;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,cAAc,CA6BhB;AAID,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,0BAA0B,EAClC,SAAS,EAAE,MAAM,EACjB,WAAW,GAAE,UAAU,EAAO,GAC7B,MAAM,CAuDR;AAiGD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,UAAU,EAAO,EAC9B,kBAAkB,GAAE,iBAAiB,EAAO,GAC3C,MAAM,CA6DR;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,SAAS,iBAAiB,EAAE,EACzC,WAAW,GAAE,SAAS,UAAU,EAAO,GACtC,MAAM,CAuCR"}

package/dist/platform/agents/wrfc-reporting.js

@@ -4,6 +4,7 @@ import { logger } from '../utils/logger.js';
 const REVIEW_BRIEF_ITEM_LIMIT = 6;
 const REVIEW_BRIEF_FILE_LIMIT = 8;
 const REVIEW_BRIEF_TEXT_LIMIT = 220;
+const REVIEWABLE_OUTPUT_LIMIT = 16_000;
 export function extractScoreFromText(text) {
     const scorePattern = /\*{0,2}(?:overall\s+)?score\s*:?\s*\*{0,2}\s*(\d+(?:\.\d+)?)\s*\/\s*10/i;
     const matchScore = text.match(scorePattern);
@@ -54,11 +55,12 @@ export function extractIssuesFromText(text) {
 export function parseEngineerCompletionReport(rawOutput, _template) {
     const report = parseCompletionReport(rawOutput);
     if (report)
-        return report;
+        return { ...report, reviewableOutput: rawOutput };
     return {
         version: 1,
         archetype: 'engineer',
         summary: rawOutput.slice(0, 500) || '(no output)',
+        reviewableOutput: rawOutput,
         gatheredContext: [],
         plannedActions: [],
         appliedChanges: [],
@@ -110,14 +112,18 @@ export function buildReviewTask(chainId, originalTask, report, threshold, constr
         `Engineer report digest:`,
         ...lines,
         ``,
+        `Engineer reviewable output (authoritative for non-file deliverables and no-write tasks):`,
+        formatReviewableOutput(report),
+        ``,
         `Instructions:`,
         `1. Review the complete current result against the original WRFC ask above. Do not narrow the review to the latest fix, files touched in the last child turn, or functions mentioned in the digest.`,
-        `2. Read the referenced files directly before scoring. Do not rely on this digest alone.`,
-        `3. Inspect the engineer's gatheredContext, plannedActions, appliedChanges, and decisions for discipline and coherence.`,
-        `4. Verify the implementation meets all stated requirements and that prior passing behavior was not regressed by later fix loops.`,
-        `5. Score the implementation using the 10-dimension review rubric.`,
-        `6. The passing score threshold is ${threshold}/10.`,
-        `7. Return a structured ReviewerReport JSON block in your final response.`,
+        `2. If the original ask requested a non-file deliverable or explicitly said not to write files, review the Engineer reviewable output as the deliverable. Do not fail only because no files exist.`,
+        `3. Read referenced files directly when files were created or modified. Do not rely on the digest alone for file-backed work.`,
+        `4. Inspect the engineer's gatheredContext, plannedActions, appliedChanges, decisions, and reviewable output for discipline and coherence.`,
+        `5. Verify the implementation meets all stated requirements and that prior passing behavior was not regressed by later fix loops.`,
+        `6. Score the implementation using the 10-dimension review rubric.`,
+        `7. The passing score threshold is ${threshold}/10.`,
+        `8. Return a structured ReviewerReport JSON block in your final response.`,
         ``,
         `The ReviewerReport must include:`,
         `- version: 1`,
@@ -126,6 +132,7 @@ export function buildReviewTask(chainId, originalTask, report, threshold, constr
         `- passed: <boolean>`,
         `- dimensions: array of { name, score, maxScore, issues[] }`,
         `- issues: array of { severity, description, file?, line?, pointValue }`,
+        `- constraintFindings: array of exactly { constraintId: string, satisfied: boolean, evidence: string, severity?: "critical" | "major" | "minor" }`,
     ];
     if (constraints.length === 0) {
         return base.join('\n');
@@ -151,6 +158,14 @@ function truncateReviewText(text, max = REVIEW_BRIEF_TEXT_LIMIT) {
         return normalized;
     return `${normalized.slice(0, max - 3)}...`;
 }
+function formatReviewableOutput(report) {
+    const output = typeof report.reviewableOutput === 'string' ? report.reviewableOutput.trim() : '';
+    if (output.length === 0)
+        return '(no reviewable output recorded)';
+    if (output.length <= REVIEWABLE_OUTPUT_LIMIT)
+        return output;
+    return `${output.slice(0, REVIEWABLE_OUTPUT_LIMIT)}\n\n[truncated from ${output.length} characters; inspect agent fullOutput directly if more detail is required]`;
+}
 function formatInlineList(items, limit) {
     if (items.length === 0)
         return 'none';

package/dist/platform/tools/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAmB,YAAY,EAAE,MAAM,cAAc,CAAC;AAI7D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAqB7D,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,MAAM,CAAC,CAAC;IAC1D,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG,SAAS,CAAC;IAChE,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,GAAG,SAAS,CAAC;IACrE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;CAC3C,GAAG,IAAI,CAkkBP"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAmB,YAAY,EAAE,MAAM,cAAc,CAAC;AAK7D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAqB7D,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,aAAa,GAAG,MAAM,CAAC,CAAC;IAC1D,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG,SAAS,CAAC;IAChE,eAAe,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,GAAG,SAAS,CAAC;IACrE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;CAC3C,GAAG,IAAI,CAwmBP"}

package/dist/platform/tools/agent/index.js

@@ -5,6 +5,7 @@ import { AGENT_TEMPLATES, AgentManager } from './manager.js';
 import { evaluateOrchestrationSpawn } from '../../runtime/orchestration/spawn-policy.js';
 import { summarizeError } from '../../utils/error-display.js';
 import { toRecord } from '../../utils/record-coerce.js';
+import { evaluateWrfcBatchPolicy, isRootReviewRoleTask } from './wrfc-batch-policy.js';
 export { AGENT_TEMPLATES, AgentManager } from './manager.js';
 // ---------------------------------------------------------------------------
 // Tool implementation
@@ -49,6 +50,12 @@ export function createAgentTool(config) {
                     if (!input.task || typeof input.task !== 'string' || input.task.trim() === '') {
                         return { success: false, error: 'Missing required parameter for spawn: task' };
                     }
+                    if (!input.parentAgentId && input.dangerously_disable_wrfc && isRootReviewRoleTask({ task: input.task, template: input.template })) {
+                        return {
+                            success: false,
+                            error: 'Root reviewer/tester/verifier agents are not valid independent roots. Start one WRFC owner chain for the deliverable, or spawn genuinely independent sidecar research/implementation tasks.',
+                        };
+                    }
                     if (input.template && !AGENT_TEMPLATES[input.template]) {
                         // Also allow custom archetypes loaded from .goodvibes/agents/*.md
                         const customArchetype = archetypeLoader.loadArchetype(input.template);
@@ -374,6 +381,39 @@ export function createAgentTool(config) {
                     if (input.tasks.length > 20) {
                         return { success: false, error: 'batch-spawn limited to 20 tasks per batch.' };
                     }
+                    const batchPolicy = evaluateWrfcBatchPolicy(input);
+                    if (batchPolicy.kind === 'collapse-to-wrfc') {
+                        let record;
+                        try {
+                            record = manager.spawn(batchPolicy.ownerInput);
+                        }
+                        catch (error) {
+                            return {
+                                success: false,
+                                error: `Failed to collapse role-decomposition batch into a WRFC owner chain: ${summarizeError(error)}`,
+                            };
+                        }
+                        return {
+                            success: true,
+                            output: JSON.stringify({
+                                agents: [{
+                                        id: record.id,
+                                        task: record.task.slice(0, 80),
+                                        template: record.template,
+                                        cohort: record.cohort,
+                                        wrfcId: record.wrfcId ?? null,
+                                        wrfcRole: record.wrfcRole ?? null,
+                                    }],
+                                count: 1,
+                                cohort: input.cohort,
+                                skipped: 0,
+                                collapsedToWrfc: true,
+                                collapsedTaskCount: input.tasks.length,
+                                reason: batchPolicy.reason,
+                                roleTaskIndexes: batchPolicy.roleTaskIndexes ?? [],
+                            }),
+                        };
+                    }
                     const currentCount = manager.list().filter(a => a.status === 'pending' || a.status === 'running').length;
                     const spawnDecision = evaluateOrchestrationSpawn({
                         configManager: config.configManager,

package/dist/platform/tools/agent/manager.d.ts.map

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

package/dist/platform/tools/agent/manager.js

@@ -7,6 +7,7 @@ import { evaluateOrchestrationSpawn } from '../../runtime/orchestration/spawn-po
 import { logger } from '../../utils/logger.js';
 import { summarizeError } from '../../utils/error-display.js';
 import { splitModelRegistryKey } from '../../providers/registry-helpers.js';
+import { isRootReviewRoleTask } from './wrfc-batch-policy.js';
 export const AGENT_TEMPLATES = {
     engineer: {
         description: 'Full-stack implementation agent',
@@ -98,6 +99,9 @@ export class AgentManager {
             throw new Error('AgentManager requires configManager');
         }
         const template = input.template ?? 'general';
+        if (!input.parentAgentId && input.dangerously_disable_wrfc && isRootReviewRoleTask({ task, template })) {
+            throw new Error('Root reviewer/tester/verifier agents are not valid independent roots. Start one WRFC owner chain for the deliverable, or spawn genuinely independent sidecar research/implementation tasks.');
+        }
         const archetype = this.archetypeLoader.loadArchetype(template);
         const templateDef = AGENT_TEMPLATES[template] ?? AGENT_TEMPLATES.general;
         const defaultTools = archetype ? archetype.tools : templateDef.defaultTools;

package/dist/platform/tools/agent/schema.js

@@ -5,7 +5,7 @@
 export const AGENT_TOOL_SCHEMA = {
     name: 'agent',
     description: 'Manages in-process subagents. Modes: spawn (create a new agent task), ' +
-        'batch-spawn (spawn multiple agents at once from a tasks array), ' +
+        'batch-spawn (spawn multiple genuinely independent sidecar agents at once from a tasks array; review/test/verification role decomposition is WRFC and is collapsed to one owner chain), ' +
         'status (check agent progress by ID), cancel (stop a running agent), ' +
         'list (show all agents and their status), ' +
         'templates (list available agent templates with default tool sets), ' +
@@ -194,7 +194,7 @@ export const AGENT_TOOL_SCHEMA = {
                         dangerously_disable_wrfc: { type: 'boolean', description: 'Skip WRFC review.' },
                     },
                 },
-                description: 'Array of tasks to spawn as agents (mode: batch-spawn). Max 20.',
+                description: 'Array of genuinely independent tasks to spawn as agents (mode: batch-spawn). Max 20. Do not place tester/reviewer/verifier role phases here for one deliverable; those are WRFC lifecycle children owned by one owner chain.',
             },
             // mode: spawn, batch-spawn, list, cohort-status, cohort-report
             cohort: {

package/dist/platform/tools/agent/wrfc-batch-policy.d.ts

@@ -0,0 +1,13 @@
+import type { AgentInput } from './schema.js';
+type BatchTask = NonNullable<AgentInput['tasks']>[number];
+export interface WrfcBatchPolicyDecision {
+    readonly kind: 'independent' | 'collapse-to-wrfc';
+    readonly reason?: string | undefined;
+    readonly ownerInput?: AgentInput | undefined;
+    readonly roleTaskIndexes?: readonly number[] | undefined;
+}
+export declare function isRootReviewRoleTemplate(template: string | undefined): boolean;
+export declare function isRootReviewRoleTask(task: Pick<BatchTask, 'task' | 'template'>): boolean;
+export declare function evaluateWrfcBatchPolicy(input: AgentInput): WrfcBatchPolicyDecision;
+export {};
+//# sourceMappingURL=wrfc-batch-policy.d.ts.map

package/dist/platform/tools/agent/wrfc-batch-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrfc-batch-policy.d.ts","sourceRoot":"","sources":["../../../../src/platform/tools/agent/wrfc-batch-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,KAAK,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAsB1D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,kBAAkB,CAAC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CAC1D;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE9E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG,OAAO,CAIxF;AA8BD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,GAAG,uBAAuB,CAoElF"}

package/dist/platform/tools/agent/wrfc-batch-policy.js

@@ -0,0 +1,108 @@
+const ROOT_REVIEW_ROLE_TEMPLATES = new Set([
+    'reviewer',
+    'tester',
+    'verifier',
+    'review',
+    'test',
+    'qa',
+]);
+const IMPLEMENTATION_TEMPLATES = new Set(['engineer', 'general']);
+const ROLE_PREFIX_RE = /^\s*(?:\[?\s*)?(?:reviewer|tester|verifier|qa|quality\s+assurance|test|review|verify|validator)\b[\]\s:;-]*/i;
+const ROLE_ACTION_RE = /\b(?:test|tests|testing|review|reviews|reviewing|verify|verifies|verifying|verification|validate|validates|validating|validation|qa)\s+(?:the|this|that|implementation|solution|feature|deliverable|code|changes|work|output|result|patch|diff)\b/i;
+const IMPLEMENTATION_ACTION_RE = /\b(?:build|implement|create|add|write|fix|repair|update|refactor|change|modify|deliver|make)\b/i;
+export function isRootReviewRoleTemplate(template) {
+    return ROOT_REVIEW_ROLE_TEMPLATES.has((template ?? '').trim().toLowerCase());
+}
+export function isRootReviewRoleTask(task) {
+    if (isRootReviewRoleTemplate(task.template))
+        return true;
+    const text = task.task.trim();
+    return ROLE_PREFIX_RE.test(text) || ROLE_ACTION_RE.test(text);
+}
+function isImplementationLikeTask(task) {
+    const template = (task.template ?? '').trim().toLowerCase();
+    return IMPLEMENTATION_TEMPLATES.has(template) || IMPLEMENTATION_ACTION_RE.test(task.task);
+}
+function uniqueStrings(values) {
+    const unique = [...new Set(values.flatMap((value) => value ?? []).filter((value) => value.trim().length > 0))];
+    return unique.length > 0 ? unique : undefined;
+}
+function formatTask(task, index) {
+    const template = task.template ?? 'general';
+    return `${index + 1}. [${template}] ${task.task}`;
+}
+function buildCollapsedContext(input, tasks, roleTaskIndexes) {
+    const roleIndexText = roleTaskIndexes.map((index) => index + 1).join(', ');
+    const existing = input.context?.trim();
+    return [
+        existing ? `Caller context:\n${existing}` : null,
+        'SDK WRFC topology enforcement collapsed this batch because root review/test/verification tasks are lifecycle phases, not independent root agents.',
+        `Collapsed role-task indexes: ${roleIndexText}.`,
+        'The WRFC owner must keep one root chain for the original deliverable. The controller owns engineer, reviewer, tester/verifier, and fixer child lifecycle agents after owner output exists.',
+        'Original batch:',
+        ...tasks.map(formatTask),
+    ].filter((line) => Boolean(line)).join('\n');
+}
+export function evaluateWrfcBatchPolicy(input) {
+    const tasks = input.tasks ?? [];
+    if (input.mode !== 'batch-spawn' || tasks.length <= 1) {
+        return { kind: 'independent' };
+    }
+    const roleTaskIndexes = tasks
+        .map((task, index) => isRootReviewRoleTask(task) ? index : -1)
+        .filter((index) => index >= 0);
+    if (roleTaskIndexes.length === 0) {
+        return { kind: 'independent' };
+    }
+    const primaryIndex = tasks.findIndex((task, index) => !roleTaskIndexes.includes(index) && isImplementationLikeTask(task));
+    const ownerTask = tasks[primaryIndex >= 0 ? primaryIndex : 0];
+    const ownerTemplate = isRootReviewRoleTemplate(ownerTask.template)
+        ? 'engineer'
+        : ownerTask.template ?? input.template ?? 'engineer';
+    const template = isRootReviewRoleTemplate(ownerTemplate) ? 'engineer' : ownerTemplate;
+    const ownerInput = {
+        mode: 'spawn',
+        task: ownerTask.task,
+        template,
+        model: ownerTask.model ?? input.model,
+        provider: ownerTask.provider ?? input.provider,
+        fallbackModels: ownerTask.fallbackModels ?? input.fallbackModels,
+        routing: ownerTask.routing ?? input.routing,
+        executionIntent: ownerTask.executionIntent ?? input.executionIntent,
+        reasoningEffort: ownerTask.reasoningEffort ?? input.reasoningEffort,
+        tools: ownerTask.tools ?? input.tools,
+        restrictTools: ownerTask.restrictTools ?? input.restrictTools,
+        context: buildCollapsedContext(input, tasks, roleTaskIndexes),
+        successCriteria: uniqueStrings([
+            ownerTask.successCriteria,
+            input.successCriteria,
+            ...tasks.map((task) => task.successCriteria),
+            ['Keep the WRFC work as one owner chain; review, test, verification, and fix work must be WRFC lifecycle children, not sibling root agents.'],
+        ]),
+        requiredEvidence: uniqueStrings([
+            ownerTask.requiredEvidence,
+            input.requiredEvidence,
+            ...tasks.map((task) => task.requiredEvidence),
+        ]),
+        writeScope: uniqueStrings([
+            ownerTask.writeScope,
+            input.writeScope,
+            ...tasks.map((task) => task.writeScope),
+        ]),
+        executionProtocol: ownerTask.executionProtocol ?? input.executionProtocol,
+        reviewMode: 'wrfc',
+        communicationLane: ownerTask.communicationLane ?? input.communicationLane,
+        parentAgentId: ownerTask.parentAgentId ?? input.parentAgentId,
+        orchestrationGraphId: ownerTask.orchestrationGraphId ?? input.orchestrationGraphId,
+        orchestrationNodeId: ownerTask.orchestrationNodeId ?? input.orchestrationNodeId,
+        parentNodeId: ownerTask.parentNodeId ?? input.parentNodeId,
+        dangerously_disable_wrfc: false,
+        cohort: input.cohort,
+    };
+    return {
+        kind: 'collapse-to-wrfc',
+        reason: 'batch-spawn contained root review/test/verification role tasks for the same deliverable',
+        ownerInput,
+        roleTaskIndexes,
+    };
+}

package/dist/platform/version.js

@@ -1,6 +1,6 @@
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-let version = '0.33.18';
+let version = '0.33.20';
 try {
     const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', '..', 'package.json'), 'utf-8'));
     version = pkg.version ?? version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-sdk",
-  "version": "0.33.18",
+  "version": "0.33.20",
   "description": "TypeScript SDK for building GoodVibes operator, peer, web, mobile, and daemon-connected apps with typed contracts, auth, realtime events, and transport layers.",
   "keywords": [
     "goodvibes",
@@ -449,14 +449,14 @@
   "sideEffects": false,
   "type": "module",
   "dependencies": {
-    "@pellux/goodvibes-contracts": "0.33.18",
-    "@pellux/goodvibes-daemon-sdk": "0.33.18",
-    "@pellux/goodvibes-errors": "0.33.18",
-    "@pellux/goodvibes-operator-sdk": "0.33.18",
-    "@pellux/goodvibes-peer-sdk": "0.33.18",
-    "@pellux/goodvibes-transport-core": "0.33.18",
-    "@pellux/goodvibes-transport-http": "0.33.18",
-    "@pellux/goodvibes-transport-realtime": "0.33.18"
+    "@pellux/goodvibes-contracts": "0.33.20",
+    "@pellux/goodvibes-daemon-sdk": "0.33.20",
+    "@pellux/goodvibes-errors": "0.33.20",
+    "@pellux/goodvibes-operator-sdk": "0.33.20",
+    "@pellux/goodvibes-peer-sdk": "0.33.20",
+    "@pellux/goodvibes-transport-core": "0.33.20",
+    "@pellux/goodvibes-transport-http": "0.33.20",
+    "@pellux/goodvibes-transport-realtime": "0.33.20"
   },
   "optionalDependencies": {
     "@agentclientprotocol/sdk": "^0.21.0",