@pellux/goodvibes-sdk 0.18.3 → 0.18.11

package/dist/platform/agents/archetypes.d.ts

@@ -0,0 +1,68 @@
+/** A named agent archetype loaded from a .goodvibes/agents/*.md file
+ *  or from built-in templates. */
+export interface AgentArchetype {
+    /** Archetype identifier (filename without extension, or template key). */
+    name: string;
+    /** Human-readable description. */
+    description: string;
+    /** Tool names the agent has access to. */
+    tools: string[];
+    /** Model override (optional). */
+    model?: string;
+    /** Provider override (optional). */
+    provider?: string;
+    /** System prompt injected at agent start (optional). */
+    systemPrompt?: string;
+    /** True if loaded from a markdown file, false if built-in. */
+    isCustom: boolean;
+    /** Where this archetype came from. */
+    origin: 'builtin' | 'local-markdown';
+    /** Source path when loaded from a markdown file. */
+    sourcePath?: string;
+    /** Validation or schema issues discovered while loading. */
+    validationIssues?: readonly string[];
+    /** Brief preview of the archetype body. */
+    preview?: string;
+    /** Lazy @ references discovered in the body. */
+    includes?: readonly string[];
+    /** Markdown headings discovered in the body. */
+    sections?: readonly string[];
+}
+/** Loads and caches agent archetypes from .goodvibes/agents/*.md files.
+ *
+ * Progressive loading:
+ *  - `listArchetypes()` returns all known archetypes (frontmatter only);
+ *    full body (system_prompt) is populated on first call to `loadArchetype()`.
+ *  - Falls back to built-in templates when no .md file is found.
+ */
+export declare class ArchetypeLoader {
+    /** Map from archetype name -> AgentArchetype (may be partially loaded) */
+    private cache;
+    /** Map from archetype name -> raw markdown body (lazy) */
+    private bodyCache;
+    /** Whether the directory scan has been run */
+    private scanned;
+    /** Directory to scan for .md files */
+    private dir;
+    constructor(dir?: string);
+    /** Scan the agents directory and populate cache with frontmatter-only entries.
+   *  Called automatically on first access. */
+    private scan;
+    /** Load a named archetype with full content (including system prompt).
+     *  Returns null if not found in files or built-ins. */
+    loadArchetype(name: string): AgentArchetype | null;
+    /** List all known archetypes (frontmatter only, no body loading). */
+    listArchetypes(): AgentArchetype[];
+    /** Merge archetype config with runtime overrides.
+     *  Override properties take precedence over archetype defaults.
+     *  Returns null if the named archetype is not found. */
+    mergeWithOverrides(name: string, overrides: {
+        model?: string;
+        provider?: string;
+        tools?: string[];
+    }): AgentArchetype | null;
+    /** Clear all cached archetypes and force re-scan on next access.
+     *  Primarily for testing. */
+    clear(): void;
+}
+//# sourceMappingURL=archetypes.d.ts.map

package/dist/platform/agents/archetypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetypes.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/archetypes.ts"],"names":[],"mappings":"AAeA;kCACkC;AAClC,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,MAAM,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACrC,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAmKD;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,KAAK,CAAqC;IAClD,0DAA0D;IAC1D,OAAO,CAAC,SAAS,CAA6B;IAC9C,8CAA8C;IAC9C,OAAO,CAAC,OAAO,CAAS;IACxB,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,CAAC,EAAE,MAAM;IAQxB;8CAC0C;IAC1C,OAAO,CAAC,IAAI;IAyEZ;2DACuD;IACvD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAkBlD,qEAAqE;IACrE,cAAc,IAAI,cAAc,EAAE;IAKlC;;4DAEwD;IACxD,kBAAkB,CAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,GACA,cAAc,GAAG,IAAI;IAYxB;iCAC6B;IAC7B,KAAK,IAAI,IAAI;CAKd"}

package/dist/platform/agents/archetypes.js

@@ -0,0 +1,272 @@
+import { readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../utils/logger.js';
+import { summarizeError } from '../utils/error-display.js';
+import { collectMarkdownReferences, extractMarkdownPreview, extractMarkdownSections, materializeMarkdownBody, } from '../utils/markdown-disclosure.js';
+// ---------------------------------------------------------------------------
+// Built-in fallback templates
+// Mirrors the AGENT_TEMPLATES in src/tools/agent/index.ts so that
+// archetypes.ts has no circular dependency on the tool module.
+// ---------------------------------------------------------------------------
+const BUILT_IN_ARCHETYPES = [
+    {
+        name: 'engineer',
+        description: 'Full-stack implementation agent',
+        tools: ['read', 'write', 'edit', 'find', 'exec', 'analyze', 'inspect', 'fetch', 'registry'],
+        isCustom: false,
+        origin: 'builtin',
+    },
+    {
+        name: 'reviewer',
+        description: 'Code review and quality assessment',
+        tools: ['read', 'find', 'analyze', 'inspect', 'fetch', 'registry'],
+        isCustom: false,
+        origin: 'builtin',
+    },
+    {
+        name: 'tester',
+        description: 'Test writing and execution',
+        tools: ['read', 'write', 'find', 'exec', 'analyze', 'inspect'],
+        isCustom: false,
+        origin: 'builtin',
+    },
+    {
+        name: 'researcher',
+        description: 'Codebase exploration and analysis',
+        tools: ['read', 'find', 'analyze', 'inspect', 'fetch', 'registry'],
+        isCustom: false,
+        origin: 'builtin',
+    },
+    {
+        name: 'general',
+        description: 'General purpose agent',
+        tools: ['read', 'write', 'edit', 'find', 'exec', 'analyze', 'inspect', 'fetch', 'registry'],
+        isCustom: false,
+        origin: 'builtin',
+    },
+];
+function parseSimpleYaml(yaml) {
+    const result = {};
+    const lines = yaml.split('\n');
+    let i = 0;
+    let currentKey = null;
+    let collectingList = false;
+    const listBuffer = [];
+    const flushList = () => {
+        if (currentKey && collectingList) {
+            result[currentKey] = listBuffer.slice();
+        }
+        collectingList = false;
+        listBuffer.length = 0;
+    };
+    while (i < lines.length) {
+        const line = lines[i];
+        i++;
+        // Skip comments and blank lines
+        if (!line.trim() || line.trim().startsWith('#')) {
+            if (collectingList)
+                flushList();
+            continue;
+        }
+        // List item under current key
+        const listItemMatch = line.match(/^\s+-\s+(.+)$/);
+        if (listItemMatch && collectingList) {
+            listBuffer.push(listItemMatch[1].trim());
+            continue;
+        }
+        // Key: value line
+        const kvMatch = line.match(/^([\w_]+):\s*(.*)$/);
+        if (kvMatch) {
+            // Flush any pending list
+            if (collectingList)
+                flushList();
+            currentKey = kvMatch[1];
+            const rawValue = kvMatch[2].trim();
+            if (!rawValue) {
+                // Value will be on following list lines
+                collectingList = true;
+                continue;
+            }
+            // Inline list: [a, b, c]
+            const inlineListMatch = rawValue.match(/^\[(.*)\]$/);
+            if (inlineListMatch) {
+                result[currentKey] = inlineListMatch[1]
+                    .split(',')
+                    .map((s) => s.trim())
+                    .filter(Boolean);
+                continue;
+            }
+            // Multi-line string with | (just take first line for simple values)
+            const stripped = rawValue.replace(/^['"]|['"]$/g, '');
+            result[currentKey] = stripped;
+        }
+    }
+    // Flush any trailing list
+    if (collectingList)
+        flushList();
+    return result;
+}
+/** Extract `--- frontmatter ---` + body from markdown text.
+ *  Returns null if no frontmatter block is present. */
+function extractFrontmatter(content) {
+    const trimmed = content.trimStart();
+    if (!trimmed.startsWith('---'))
+        return null;
+    const secondDash = trimmed.indexOf('\n---', 3);
+    if (secondDash === -1)
+        return null;
+    const raw = trimmed.slice(3, secondDash).trim();
+    const body = trimmed.slice(secondDash + 4).trimStart();
+    return { raw, body };
+}
+function validateArchetype(archetype) {
+    const issues = [];
+    if (!archetype.name.trim())
+        issues.push('missing name');
+    if (!archetype.description.trim())
+        issues.push('missing description');
+    if (archetype.tools.length === 0)
+        issues.push('no tools declared');
+    const uniqueTools = new Set(archetype.tools.map((tool) => tool.trim()).filter(Boolean));
+    if (uniqueTools.size !== archetype.tools.length)
+        issues.push('duplicate or empty tool declarations');
+    return issues;
+}
+// ---------------------------------------------------------------------------
+// ArchetypeLoader
+// ---------------------------------------------------------------------------
+/** Loads and caches agent archetypes from .goodvibes/agents/*.md files.
+ *
+ * Progressive loading:
+ *  - `listArchetypes()` returns all known archetypes (frontmatter only);
+ *    full body (system_prompt) is populated on first call to `loadArchetype()`.
+ *  - Falls back to built-in templates when no .md file is found.
+ */
+export class ArchetypeLoader {
+    /** Map from archetype name -> AgentArchetype (may be partially loaded) */
+    cache = new Map();
+    /** Map from archetype name -> raw markdown body (lazy) */
+    bodyCache = new Map();
+    /** Whether the directory scan has been run */
+    scanned = false;
+    /** Directory to scan for .md files */
+    dir;
+    constructor(dir) {
+        this.dir = dir ?? '';
+    }
+    // -------------------------------------------------------------------------
+    // Scanning
+    // -------------------------------------------------------------------------
+    /** Scan the agents directory and populate cache with frontmatter-only entries.
+   *  Called automatically on first access. */
+    scan() {
+        if (this.scanned)
+            return;
+        this.scanned = true;
+        // Seed with built-ins first so they act as fallbacks
+        for (const builtin of BUILT_IN_ARCHETYPES) {
+            this.cache.set(builtin.name, { ...builtin });
+        }
+        if (!this.dir) {
+            logger.debug('ArchetypeLoader: no archetype directory configured, using built-ins only');
+            return;
+        }
+        let files;
+        try {
+            files = readdirSync(this.dir).filter((f) => f.endsWith('.md'));
+        }
+        catch {
+            // Directory doesn't exist — built-ins are the only archetypes
+            logger.debug('ArchetypeLoader: agents dir not found, using built-ins', { dir: this.dir });
+            return;
+        }
+        for (const file of files) {
+            try {
+                const filePath = join(this.dir, file);
+                const content = readFileSync(filePath, 'utf-8');
+                const parsed = extractFrontmatter(content);
+                if (!parsed)
+                    continue;
+                const fm = parseSimpleYaml(parsed.raw);
+                const name = fm.name ?? file.replace(/\.md$/, '');
+                const archetype = {
+                    name,
+                    description: fm.description ?? '',
+                    tools: fm.tools ?? [],
+                    model: fm.model,
+                    provider: fm.provider,
+                    // systemPrompt intentionally omitted here — lazy loaded
+                    isCustom: true,
+                    origin: 'local-markdown',
+                    sourcePath: filePath,
+                };
+                // Store body for lazy loading
+                if (fm.system_prompt) {
+                    // If system_prompt is inline in frontmatter, set it directly
+                    archetype.systemPrompt = fm.system_prompt;
+                }
+                else {
+                    // Otherwise, the markdown body is the system prompt
+                    this.bodyCache.set(name, parsed.body);
+                    archetype.preview = extractMarkdownPreview(parsed.body);
+                    archetype.includes = collectMarkdownReferences(parsed.body);
+                    archetype.sections = extractMarkdownSections(parsed.body);
+                }
+                archetype.validationIssues = validateArchetype(archetype);
+                this.cache.set(name, archetype);
+            }
+            catch (err) {
+                logger.error('ArchetypeLoader: failed to parse agent file', {
+                    file,
+                    error: summarizeError(err),
+                });
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    /** Load a named archetype with full content (including system prompt).
+     *  Returns null if not found in files or built-ins. */
+    loadArchetype(name) {
+        this.scan();
+        const archetype = this.cache.get(name);
+        if (!archetype)
+            return null;
+        // Lazy-load body as system prompt if not yet resolved
+        if (!archetype.systemPrompt && this.bodyCache.has(name)) {
+            const body = this.bodyCache.get(name);
+            archetype.systemPrompt = archetype.sourcePath
+                ? materializeMarkdownBody(archetype.sourcePath, body)
+                : body;
+            this.bodyCache.delete(name);
+        }
+        return { ...archetype };
+    }
+    /** List all known archetypes (frontmatter only, no body loading). */
+    listArchetypes() {
+        this.scan();
+        return Array.from(this.cache.values()).map((a) => ({ ...a }));
+    }
+    /** Merge archetype config with runtime overrides.
+     *  Override properties take precedence over archetype defaults.
+     *  Returns null if the named archetype is not found. */
+    mergeWithOverrides(name, overrides) {
+        const archetype = this.loadArchetype(name);
+        if (!archetype)
+            return null;
+        return {
+            ...archetype,
+            model: overrides.model ?? archetype.model,
+            provider: overrides.provider ?? archetype.provider,
+            tools: overrides.tools ?? archetype.tools,
+        };
+    }
+    /** Clear all cached archetypes and force re-scan on next access.
+     *  Primarily for testing. */
+    clear() {
+        this.cache.clear();
+        this.bodyCache.clear();
+        this.scanned = false;
+    }
+}

package/dist/platform/agents/communication-policy.d.ts

@@ -0,0 +1,21 @@
+import type { CommunicationKind, CommunicationScope } from '../runtime/events/communication.js';
+export type AgentCommunicationRole = 'orchestrator' | 'planner' | 'engineer' | 'reviewer' | 'fixer' | 'verifier' | 'researcher' | 'integrator' | 'general';
+export interface AgentCommunicationMetadata {
+    agentId: string;
+    role: AgentCommunicationRole;
+    parentAgentId?: string;
+    cohort?: string;
+    wrfcId?: string;
+}
+export declare function communicationRoleForTemplate(template?: string): AgentCommunicationRole;
+export interface CommunicationDecision {
+    allowed: boolean;
+    reason?: string;
+}
+export declare function evaluateCommunicationRoute(input: {
+    from: AgentCommunicationMetadata;
+    to: AgentCommunicationMetadata;
+    kind: CommunicationKind;
+    scope: CommunicationScope;
+}): CommunicationDecision;
+//# sourceMappingURL=communication-policy.d.ts.map

package/dist/platform/agents/communication-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"communication-policy.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/communication-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAEhG,MAAM,MAAM,sBAAsB,GAC9B,cAAc,GACd,SAAS,GACT,UAAU,GACV,UAAU,GACV,OAAO,GACP,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAatF;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAcD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,IAAI,EAAE,0BAA0B,CAAC;IACjC,EAAE,EAAE,0BAA0B,CAAC;IAC/B,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,kBAAkB,CAAC;CAC3B,GAAG,qBAAqB,CAwCxB"}

package/dist/platform/agents/communication-policy.js

@@ -0,0 +1,55 @@
+export function communicationRoleForTemplate(template) {
+    switch (template) {
+        case 'engineer':
+            return 'engineer';
+        case 'reviewer':
+            return 'reviewer';
+        case 'researcher':
+            return 'researcher';
+        case 'general':
+            return 'general';
+        default:
+            return 'general';
+    }
+}
+function isParentChild(from, to) {
+    return from.parentAgentId === to.agentId || to.parentAgentId === from.agentId;
+}
+function sharesCohort(from, to) {
+    return !!from.cohort && from.cohort === to.cohort;
+}
+function sharesWrfc(from, to) {
+    return !!from.wrfcId && from.wrfcId === to.wrfcId;
+}
+export function evaluateCommunicationRoute(input) {
+    const { from, to, kind, scope } = input;
+    if (scope === 'broadcast' && from.role !== 'orchestrator' && from.role !== 'planner') {
+        return { allowed: false, reason: 'broadcast is reserved for coordinators' };
+    }
+    if (from.role === 'orchestrator' || from.role === 'planner') {
+        return { allowed: true };
+    }
+    if (to.role === 'orchestrator') {
+        if (['status', 'question', 'finding', 'handoff', 'escalation', 'completion'].includes(kind)) {
+            return { allowed: true };
+        }
+        return { allowed: false, reason: 'agents may only report structured updates upward to the orchestrator' };
+    }
+    if (isParentChild(from, to)) {
+        if (['directive', 'status', 'question', 'finding', 'handoff', 'completion', 'escalation'].includes(kind)) {
+            return { allowed: true };
+        }
+    }
+    if (sharesWrfc(from, to)) {
+        if ((from.role === 'reviewer' && ['review', 'finding', 'directive'].includes(kind)) ||
+            (from.role === 'fixer' && ['status', 'question', 'handoff', 'completion'].includes(kind)) ||
+            (from.role === 'engineer' && ['status', 'question', 'handoff', 'completion'].includes(kind)) ||
+            (from.role === 'verifier' && ['finding', 'escalation', 'completion'].includes(kind))) {
+            return { allowed: true };
+        }
+    }
+    if (sharesCohort(from, to) && ['status', 'question', 'finding', 'handoff'].includes(kind)) {
+        return { allowed: true };
+    }
+    return { allowed: false, reason: 'communication route is outside the allowed role and topology policy' };
+}

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

@@ -0,0 +1,77 @@
+/**
+ * Structured completion reports — per-archetype output contracts.
+ * Agents include these in their final output. The WrfcController extracts them.
+ */
+/** Base fields shared by all completion reports. */
+export interface BaseCompletionReport {
+    version: 1;
+    archetype: string;
+    summary: string;
+    wrfcId?: string;
+}
+/** Engineer agent completion report. */
+export interface EngineerReport extends BaseCompletionReport {
+    archetype: 'engineer';
+    gatheredContext: string[];
+    plannedActions: string[];
+    appliedChanges: string[];
+    filesCreated: string[];
+    filesModified: string[];
+    filesDeleted: string[];
+    decisions: Array<{
+        what: string;
+        why: string;
+    }>;
+    issues: string[];
+    uncertainties: string[];
+}
+/** Reviewer agent completion report. */
+export interface ReviewerReport extends BaseCompletionReport {
+    archetype: 'reviewer';
+    score: number;
+    passed: boolean;
+    dimensions: Array<{
+        name: string;
+        score: number;
+        maxScore: number;
+        issues: string[];
+    }>;
+    issues: Array<{
+        severity: 'critical' | 'major' | 'minor' | 'suggestion';
+        description: string;
+        file?: string;
+        line?: number;
+        pointValue: number;
+    }>;
+}
+/** Tester agent completion report. */
+export interface TesterReport extends BaseCompletionReport {
+    archetype: 'tester';
+    testsWritten: string[];
+    testsPassed: number;
+    testsFailed: number;
+    coverage?: {
+        lines: number;
+        branches: number;
+        functions: number;
+    };
+    failures: Array<{
+        test: string;
+        error: string;
+    }>;
+}
+/** Generic completion report for other archetypes. */
+export interface GenericReport extends BaseCompletionReport {
+    /** Archetype name. For non-standard archetypes (not engineer/reviewer/tester). */
+    archetype: string;
+    result: string;
+}
+export type CompletionReport = EngineerReport | ReviewerReport | TesterReport | GenericReport;
+/**
+ * Parse a completion report from raw LLM output.
+ * Looks for a JSON block delimited by ```json\n{...}\n``` or a bare JSON object
+ * with a "version": 1 field.
+ * Returns null if no valid report found.
+ */
+export declare function parseCompletionReport(rawOutput: string): CompletionReport | null;
+//# sourceMappingURL=completion-report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completion-report.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/completion-report.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAe,SAAQ,oBAAoB;IAC1D,SAAS,EAAE,UAAU,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAe,SAAQ,oBAAoB;IAC1D,SAAS,EAAE,UAAU,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,CAAC;QACZ,QAAQ,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,CAAC;QACxD,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,sCAAsC;AACtC,MAAM,WAAW,YAAa,SAAQ,oBAAoB;IACxD,SAAS,EAAE,QAAQ,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,CAAC;AAE9F;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAyChF"}

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

@@ -0,0 +1,61 @@
+/**
+ * Structured completion reports — per-archetype output contracts.
+ * Agents include these in their final output. The WrfcController extracts them.
+ */
+/**
+ * Parse a completion report from raw LLM output.
+ * Looks for a JSON block delimited by ```json\n{...}\n``` or a bare JSON object
+ * with a "version": 1 field.
+ * Returns null if no valid report found.
+ */
+export function parseCompletionReport(rawOutput) {
+    // Strategy 1: Find ```json ... ``` block
+    const jsonBlockMatch = rawOutput.match(/```json\s*\n(\{[\s\S]*?\})\s*\n```/);
+    if (jsonBlockMatch) {
+        try {
+            const parsed = JSON.parse(jsonBlockMatch[1]);
+            if (parsed.version === 1 && parsed.archetype)
+                return parsed;
+        }
+        catch { /* fall through */ }
+    }
+    // Strategy 2: Brace-counting extraction — find "version": 1, walk backward for opening {,
+    // then forward counting braces to find the matching }. Avoids greedy regex over-matching.
+    const versionIdx = rawOutput.indexOf('"version"');
+    if (versionIdx !== -1) {
+        // Walk backward to find opening brace
+        let openBrace = -1;
+        for (let i = versionIdx - 1; i >= 0; i--) {
+            if (rawOutput[i] === '{') {
+                openBrace = i;
+                break;
+            }
+        }
+        if (openBrace !== -1) {
+            // Walk forward with brace counting to find matching close
+            let depth = 0;
+            let closeBrace = -1;
+            for (let i = openBrace; i < rawOutput.length; i++) {
+                if (rawOutput[i] === '{')
+                    depth++;
+                else if (rawOutput[i] === '}') {
+                    depth--;
+                    if (depth === 0) {
+                        closeBrace = i;
+                        break;
+                    }
+                }
+            }
+            if (closeBrace !== -1) {
+                const candidate = rawOutput.slice(openBrace, closeBrace + 1);
+                try {
+                    const parsed = JSON.parse(candidate);
+                    if (parsed.version === 1 && parsed.archetype)
+                        return parsed;
+                }
+                catch { /* fall through */ }
+            }
+        }
+    }
+    return null;
+}

package/dist/platform/agents/orchestrator-utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Summarize tool call arguments into a brief display string for progress labels.
+ * Extracts the most informative single string arg (path, cmd, etc.) and
+ * truncates to 30 characters.
+ */
+export declare function summarizeToolArgs(args: Record<string, unknown>): string;
+//# sourceMappingURL=orchestrator-utils.d.ts.map

package/dist/platform/agents/orchestrator-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-utils.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/orchestrator-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAiBvE"}

package/dist/platform/agents/orchestrator-utils.js

@@ -0,0 +1,23 @@
+/**
+ * Summarize tool call arguments into a brief display string for progress labels.
+ * Extracts the most informative single string arg (path, cmd, etc.) and
+ * truncates to 30 characters.
+ */
+export function summarizeToolArgs(args) {
+    // Extract the most informative single arg
+    for (const key of ['path', 'file', 'cmd', 'pattern', 'url', 'query']) {
+        const val = args[key];
+        if (typeof val === 'string' && val.length > 0) {
+            const trimmed = val.length > 30 ? val.slice(0, 27) + '\u2026' : val;
+            return ` \u2014 ${trimmed}`;
+        }
+    }
+    // Fallback: first string value found
+    for (const val of Object.values(args)) {
+        if (typeof val === 'string' && val.length > 0) {
+            const trimmed = val.length > 30 ? val.slice(0, 27) + '\u2026' : val;
+            return ` \u2014 ${trimmed}`;
+        }
+    }
+    return '';
+}

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

@@ -0,0 +1,8 @@
+export declare const WRFC_GATE_TIMEOUT_MS = 120000;
+export declare function loadPackageScripts(cwd: string): Promise<Record<string, string>>;
+export declare function getSkippedGateReason(gateName: string, cwd: string, pkgScripts: Record<string, string>): string | null;
+export declare function executeGateCommand(command: string): Promise<{
+    passed: boolean;
+    output: string;
+}>;
+//# sourceMappingURL=wrfc-gates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wrfc-gates.d.ts","sourceRoot":"","sources":["../../../src/platform/agents/wrfc-gates.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,SAAU,CAAC;AAE5C,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CASrF;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,MAAM,GAAG,IAAI,CAgBf;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BtG"}