frontend-harness 0.1.0 → 0.2.0

package/dist/runtime/plan/proposal.js

@@ -0,0 +1,251 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isRecord, parseBoundedString, parseStringArray as parseBoundedStringArray } from "../common/parsing.js";
+const AGENT_PROPOSAL_PARSE_OPTIONS = {
+    prefix: "agent proposal",
+    maxLength: 500
+};
+export function readAgentPlanningProposal(projectRoot, file) {
+    const fullPath = path.resolve(projectRoot, file);
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(fullPath, "utf8"));
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`agent proposal file must contain valid JSON: ${file}: ${detail}`);
+    }
+    return parseAgentPlanningProposal(parsed, file);
+}
+function parseAgentPlanningProposal(value, file) {
+    if (!isRecord(value) || Array.isArray(value)) {
+        throw new Error(`agent proposal file must contain a JSON object: ${file}`);
+    }
+    return parseAgentPlanningProposalEnvelope(value, file);
+}
+function parseAgentPlanningProposalEnvelope(value, file) {
+    const allowedKeys = new Set(["contractVersion", "proposal"]);
+    for (const key of Object.keys(value)) {
+        if (!allowedKeys.has(key)) {
+            throw new Error(`agent proposal file contains unsupported field: ${key}`);
+        }
+    }
+    if (value["contractVersion"] !== 1) {
+        throw new Error("agent proposal contractVersion must be 1");
+    }
+    if (!isRecord(value["proposal"]) || Array.isArray(value["proposal"])) {
+        throw new Error(`agent proposal file proposal must be a JSON object: ${file}`);
+    }
+    const proposal = parseAgentPlanningProposalObject(value["proposal"], new Set([
+        "intentSuggestion",
+        "constraintHints",
+        "componentHints",
+        "planningEvidence"
+    ]), "agent proposal file proposal");
+    return {
+        contractVersion: 1,
+        ...proposal
+    };
+}
+function parseAgentPlanningProposalObject(value, allowedKeys, label) {
+    for (const key of Object.keys(value)) {
+        if (!allowedKeys.has(key)) {
+            throw new Error(`${label} contains unsupported field: ${key}`);
+        }
+    }
+    const proposal = {};
+    if (value["intentSuggestion"] !== undefined) {
+        proposal.intentSuggestion = parseAgentProposalString(value["intentSuggestion"], "intentSuggestion");
+    }
+    if (value["constraintHints"] !== undefined) {
+        proposal.constraintHints = parseStringArray(value["constraintHints"], "constraintHints");
+    }
+    if (value["componentHints"] !== undefined) {
+        proposal.componentHints = parseComponentHints(value["componentHints"]);
+    }
+    if (value["planningEvidence"] !== undefined) {
+        proposal.planningEvidence = parsePlanningEvidence(value["planningEvidence"]);
+    }
+    return proposal;
+}
+function parseWorkflowSuggestion(value) {
+    const workflow = parseAgentProposalString(value, "workflow candidate kind");
+    const allowed = [
+        "ui_implementation",
+        "prd_knowledge",
+        "api_integration",
+        "frontend_test",
+        "bug_fix",
+        "frontend_review",
+        "requirement_change",
+        "documentation",
+        "maintenance"
+    ];
+    if (!allowed.includes(workflow)) {
+        throw new Error(`agent proposal workflow candidate kind must be one of: ${allowed.join(", ")}`);
+    }
+    return workflow;
+}
+function parseStringArray(value, label) {
+    return parseBoundedStringArray(value, label, {
+        ...AGENT_PROPOSAL_PARSE_OPTIONS,
+        maxItems: 10
+    });
+}
+function parseComponentHints(value) {
+    if (!Array.isArray(value)) {
+        throw new Error("agent proposal componentHints must be an array");
+    }
+    if (value.length > 10) {
+        throw new Error("agent proposal componentHints cannot contain more than 10 items");
+    }
+    return value.map((item, index) => {
+        if (!isRecord(item) || Array.isArray(item)) {
+            throw new Error(`agent proposal componentHints[${index}] must be an object`);
+        }
+        const allowedKeys = new Set(["name", "responsibility"]);
+        for (const key of Object.keys(item)) {
+            if (!allowedKeys.has(key)) {
+                throw new Error(`agent proposal componentHints[${index}] contains unsupported field: ${key}`);
+            }
+        }
+        return {
+            ...(item["name"] !== undefined ? { name: parseAgentProposalString(item["name"], `componentHints[${index}].name`) } : {}),
+            ...(item["responsibility"] !== undefined
+                ? { responsibility: parseAgentProposalString(item["responsibility"], `componentHints[${index}].responsibility`) }
+                : {})
+        };
+    });
+}
+function parsePlanningEvidence(value) {
+    if (!isRecord(value) || Array.isArray(value)) {
+        throw new Error("agent proposal planningEvidence must be an object");
+    }
+    const allowedKeys = new Set(["workflowCandidates", "targetCandidates", "verificationCandidates", "ambiguities"]);
+    for (const key of Object.keys(value)) {
+        if (!allowedKeys.has(key)) {
+            throw new Error(`agent proposal planningEvidence contains unsupported field: ${key}`);
+        }
+    }
+    const evidence = {};
+    if (value["workflowCandidates"] !== undefined) {
+        evidence.workflowCandidates = parseWorkflowCandidates(value["workflowCandidates"]);
+    }
+    if (value["targetCandidates"] !== undefined) {
+        evidence.targetCandidates = parseTargetCandidates(value["targetCandidates"]);
+    }
+    if (value["verificationCandidates"] !== undefined) {
+        evidence.verificationCandidates = parseVerificationCandidates(value["verificationCandidates"]);
+    }
+    if (value["ambiguities"] !== undefined) {
+        evidence.ambiguities = parseAmbiguities(value["ambiguities"]);
+    }
+    return evidence;
+}
+function parseWorkflowCandidates(value) {
+    if (!Array.isArray(value)) {
+        throw new Error("agent proposal planningEvidence.workflowCandidates must be an array");
+    }
+    if (value.length > 10) {
+        throw new Error("agent proposal planningEvidence.workflowCandidates cannot contain more than 10 items");
+    }
+    return value.map((item, index) => {
+        if (!isRecord(item) || Array.isArray(item)) {
+            throw new Error(`agent proposal planningEvidence.workflowCandidates[${index}] must be an object`);
+        }
+        const allowedKeys = new Set(["kind", "confidence", "reasons"]);
+        for (const key of Object.keys(item)) {
+            if (!allowedKeys.has(key)) {
+                throw new Error(`agent proposal planningEvidence.workflowCandidates[${index}] contains unsupported field: ${key}`);
+            }
+        }
+        const kind = parseWorkflowSuggestion(item["kind"]);
+        const confidence = parseProbability(item["confidence"], `planningEvidence.workflowCandidates[${index}].confidence`);
+        const reasons = parseStringArray(item["reasons"], `planningEvidence.workflowCandidates[${index}].reasons`);
+        return { kind, confidence, reasons };
+    });
+}
+function parseTargetCandidates(value) {
+    if (!Array.isArray(value)) {
+        throw new Error("agent proposal planningEvidence.targetCandidates must be an array");
+    }
+    if (value.length > 20) {
+        throw new Error("agent proposal planningEvidence.targetCandidates cannot contain more than 20 items");
+    }
+    return value.map((item, index) => {
+        if (!isRecord(item) || Array.isArray(item)) {
+            throw new Error(`agent proposal planningEvidence.targetCandidates[${index}] must be an object`);
+        }
+        const allowedKeys = new Set(["path", "role", "confidence"]);
+        for (const key of Object.keys(item)) {
+            if (!allowedKeys.has(key)) {
+                throw new Error(`agent proposal planningEvidence.targetCandidates[${index}] contains unsupported field: ${key}`);
+            }
+        }
+        return {
+            path: parseAgentProposalString(item["path"], `planningEvidence.targetCandidates[${index}].path`),
+            role: parseAgentProposalString(item["role"], `planningEvidence.targetCandidates[${index}].role`),
+            confidence: parseProbability(item["confidence"], `planningEvidence.targetCandidates[${index}].confidence`)
+        };
+    });
+}
+function parseVerificationCandidates(value) {
+    if (!Array.isArray(value)) {
+        throw new Error("agent proposal planningEvidence.verificationCandidates must be an array");
+    }
+    if (value.length > 20) {
+        throw new Error("agent proposal planningEvidence.verificationCandidates cannot contain more than 20 items");
+    }
+    return value.map((item, index) => {
+        if (!isRecord(item) || Array.isArray(item)) {
+            throw new Error(`agent proposal planningEvidence.verificationCandidates[${index}] must be an object`);
+        }
+        const allowedKeys = new Set(["kind", "reason"]);
+        for (const key of Object.keys(item)) {
+            if (!allowedKeys.has(key)) {
+                throw new Error(`agent proposal planningEvidence.verificationCandidates[${index}] contains unsupported field: ${key}`);
+            }
+        }
+        return {
+            kind: parseAgentProposalString(item["kind"], `planningEvidence.verificationCandidates[${index}].kind`),
+            reason: parseAgentProposalString(item["reason"], `planningEvidence.verificationCandidates[${index}].reason`)
+        };
+    });
+}
+function parseAmbiguities(value) {
+    if (!Array.isArray(value)) {
+        throw new Error("agent proposal planningEvidence.ambiguities must be an array");
+    }
+    if (value.length > 20) {
+        throw new Error("agent proposal planningEvidence.ambiguities cannot contain more than 20 items");
+    }
+    return value.map((item, index) => {
+        if (!isRecord(item) || Array.isArray(item)) {
+            throw new Error(`agent proposal planningEvidence.ambiguities[${index}] must be an object`);
+        }
+        const allowedKeys = new Set(["question", "severity"]);
+        for (const key of Object.keys(item)) {
+            if (!allowedKeys.has(key)) {
+                throw new Error(`agent proposal planningEvidence.ambiguities[${index}] contains unsupported field: ${key}`);
+            }
+        }
+        const severity = parseAgentProposalString(item["severity"], `planningEvidence.ambiguities[${index}].severity`);
+        if (!["low", "medium", "high"].includes(severity)) {
+            throw new Error("agent proposal planningEvidence ambiguity severity must be one of: low, medium, high");
+        }
+        return {
+            question: parseAgentProposalString(item["question"], `planningEvidence.ambiguities[${index}].question`),
+            severity: severity
+        };
+    });
+}
+function parseProbability(value, label) {
+    if (typeof value !== "number" || Number.isNaN(value) || value < 0 || value > 1) {
+        throw new Error(`agent proposal ${label} must be a number between 0 and 1`);
+    }
+    return value;
+}
+function parseAgentProposalString(value, label) {
+    return parseBoundedString(value, label, AGENT_PROPOSAL_PARSE_OPTIONS);
+}
+//# sourceMappingURL=proposal.js.map

package/dist/runtime/plan/proposal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal.js","sourceRoot":"","sources":["../../../src/runtime/plan/proposal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAY7B,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,IAAI,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAEjH,MAAM,4BAA4B,GAAG;IACnC,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,GAAG;CACN,CAAC;AAEX,MAAM,UAAU,yBAAyB,CAAC,WAAmB,EAAE,IAAY;IACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACjD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,gDAAgD,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,0BAA0B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc,EAAE,IAAY;IAC9D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,mDAAmD,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,kCAAkC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,kCAAkC,CAAC,KAA8B,EAAE,IAAY;IACtF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,iBAAiB,EAAE,UAAU,CAAC,CAAC,CAAC;IAC7D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,mDAAmD,GAAG,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,uDAAuD,IAAI,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,QAAQ,GAAG,gCAAgC,CAC/C,KAAK,CAAC,UAAU,CAAC,EACjB,IAAI,GAAG,CAAC;QACN,kBAAkB;QAClB,iBAAiB;QACjB,gBAAgB;QAChB,kBAAkB;KACnB,CAAC,EACF,8BAA8B,CAC/B,CAAC;IACF,OAAO;QACL,eAAe,EAAE,CAAC;QAClB,GAAG,QAAQ;KACwC,CAAC;AACxD,CAAC;AAED,SAAS,gCAAgC,CACvC,KAA8B,EAC9B,WAAwB,EACxB,KAAa;IAEb,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,gCAAgC,GAAG,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAC3C,IAAI,KAAK,CAAC,kBAAkB,CAAC,KAAK,SAAS,EAAE,CAAC;QAC5C,QAAQ,CAAC,gBAAgB,GAAG,wBAAwB,CAAC,KAAK,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC,CAAC;IACtG,CAAC;IACD,IAAI,KAAK,CAAC,iBAAiB,CAAC,KAAK,SAAS,EAAE,CAAC;QAC3C,QAAQ,CAAC,eAAe,GAAG,gBAAgB,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,SAAS,EAAE,CAAC;QAC1C,QAAQ,CAAC,cAAc,GAAG,mBAAmB,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,KAAK,CAAC,kBAAkB,CAAC,KAAK,SAAS,EAAE,CAAC;QAC5C,QAAQ,CAAC,gBAAgB,GAAG,qBAAqB,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,MAAM,QAAQ,GAAG,wBAAwB,CAAC,KAAK,EAAE,yBAAyB,CAAC,CAAC;IAC5E,MAAM,OAAO,GAA2B;QACtC,mBAAmB;QACnB,eAAe;QACf,iBAAiB;QACjB,eAAe;QACf,SAAS;QACT,iBAAiB;QACjB,oBAAoB;QACpB,eAAe;QACf,aAAa;KACd,CAAC;IACF,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAgC,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,0DAA0D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC;IACD,OAAO,QAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,KAAa;IACrD,OAAO,uBAAuB,CAAC,KAAK,EAAE,KAAK,EAAE;QAC3C,GAAG,4BAA4B;QAC/B,QAAQ,EAAE,EAAE;KACb,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,qBAAqB,CAAC,CAAC;QAC/E,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;QACxD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,iCAAiC,GAAG,EAAE,CAAC,CAAC;YAChG,CAAC;QACH,CAAC;QACD,OAAO;YACL,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,kBAAkB,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxH,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,SAAS;gBACtC,CAAC,CAAC,EAAE,cAAc,EAAE,wBAAwB,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,kBAAkB,KAAK,kBAAkB,CAAC,EAAE;gBACjH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,aAAa,CAAC,CAAC,CAAC;IACjH,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,+DAA+D,GAAG,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAC3C,IAAI,KAAK,CAAC,oBAAoB,CAAC,KAAK,SAAS,EAAE,CAAC;QAC9C,QAAQ,CAAC,kBAAkB,GAAG,uBAAuB,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,KAAK,CAAC,kBAAkB,CAAC,KAAK,SAAS,EAAE,CAAC;QAC5C,QAAQ,CAAC,gBAAgB,GAAG,qBAAqB,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,KAAK,CAAC,wBAAwB,CAAC,KAAK,SAAS,EAAE,CAAC;QAClD,QAAQ,CAAC,sBAAsB,GAAG,2BAA2B,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,CAAC,KAAK,SAAS,EAAE,CAAC;QACvC,QAAQ,CAAC,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;IAC1G,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,sDAAsD,KAAK,qBAAqB,CAAC,CAAC;QACpG,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;QAC/D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,sDAAsD,KAAK,iCAAiC,GAAG,EAAE,CAAC,CAAC;YACrH,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,uCAAuC,KAAK,cAAc,CAAC,CAAC;QACpH,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,uCAAuC,KAAK,WAAW,CAAC,CAAC;QAC3G,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,oDAAoD,KAAK,qBAAqB,CAAC,CAAC;QAClG,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;QAC5D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,oDAAoD,KAAK,iCAAiC,GAAG,EAAE,CAAC,CAAC;YACnH,CAAC;QACH,CAAC;QACD,OAAO;YACL,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,qCAAqC,KAAK,QAAQ,CAAC;YAChG,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,qCAAqC,KAAK,QAAQ,CAAC;YAChG,UAAU,EAAE,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,qCAAqC,KAAK,cAAc,CAAC;SAC3G,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAc;IACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,0FAA0F,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,0DAA0D,KAAK,qBAAqB,CAAC,CAAC;QACxG,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,0DAA0D,KAAK,iCAAiC,GAAG,EAAE,CAAC,CAAC;YACzH,CAAC;QACH,CAAC;QACD,OAAO;YACL,IAAI,EAAE,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,2CAA2C,KAAK,QAAQ,CAAC;YACtG,MAAM,EAAE,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,2CAA2C,KAAK,UAAU,CAAC;SAC7G,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,+CAA+C,KAAK,qBAAqB,CAAC,CAAC;QAC7F,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;QACtD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,+CAA+C,KAAK,iCAAiC,GAAG,EAAE,CAAC,CAAC;YAC9G,CAAC;QACH,CAAC;QACD,MAAM,QAAQ,GAAG,wBAAwB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,gCAAgC,KAAK,YAAY,CAAC,CAAC;QAC/G,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;QAC1G,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,wBAAwB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,gCAAgC,KAAK,YAAY,CAAC;YACvG,QAAQ,EAAE,QAAsC;SACjD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,KAAa;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,mCAAmC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc,EAAE,KAAa;IAC7D,OAAO,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,4BAA4B,CAAC,CAAC;AACxE,CAAC"}

package/dist/runtime/plan/workflow.d.ts

@@ -0,0 +1,8 @@
+import type { AgentPlanningDecision, FrontendWorkflowKind, FrontendWorkflowPolicy } from "../../schemas/types.js";
+export interface WorkflowInputSignals {
+    prd?: string;
+    ui?: string;
+}
+export declare function inferTaskIntent(scope: string, workflowKind: FrontendWorkflowKind): string;
+export declare function inferFrontendWorkflow(scope: string, input: WorkflowInputSignals, proposal: AgentPlanningDecision | null): FrontendWorkflowPolicy;
+export declare function verificationForWorkflow(kind: FrontendWorkflowKind | undefined): string[];

package/dist/runtime/plan/workflow.js

@@ -0,0 +1,228 @@
+export function inferTaskIntent(scope, workflowKind) {
+    const normalized = scope.toLowerCase();
+    if (workflowKind === "frontend_review") {
+        return "frontend_review";
+    }
+    if (workflowKind === "documentation") {
+        return "update_documentation";
+    }
+    if (workflowKind === "maintenance") {
+        return "maintain_project";
+    }
+    if (workflowKind === "bug_fix" || /\b(fix|bug)\b|\u4fee\u590d|\u9519\u8bef|\u62a5\u9519|\u7f3a\u9677/.test(normalized)) {
+        return "fix_bug";
+    }
+    if (workflowKind === "frontend_test" || /\b(test|e2e|playwright|vitest)\b|\u6d4b\u8bd5|\u7aef\u5230\u7aef|\u96c6\u6210\u6d4b\u8bd5/.test(normalized)) {
+        return "add_test";
+    }
+    if (/\brefactor\b|\u91cd\u6784/.test(normalized)) {
+        return "refactor";
+    }
+    return "implement_page";
+}
+export function inferFrontendWorkflow(scope, input, proposal) {
+    const normalized = scope.toLowerCase();
+    const hasAttachedUiSource = Boolean(input.ui);
+    const hasUiImplementationSignal = /\b(stitch|figma|html|design|page|screen|component|view|dashboard)\b|\u9875\u9762|\u754c\u9762|\u7ec4\u4ef6|\u89c6\u56fe|\u770b\u677f|\u8bbe\u8ba1/.test(normalized);
+    const hasUiSource = hasAttachedUiSource || /\b(ui|stitch|figma|html|design|page|screen|component|view|dashboard)\b|\u9875\u9762|\u754c\u9762|\u7ec4\u4ef6|\u89c6\u56fe|\u770b\u677f|\u8bbe\u8ba1/.test(normalized);
+    const hasPrdSource = Boolean(input.prd) || /\b(prd|product|requirement|requirements|knowledge|document)\b|\u4ea7\u54c1|\u9700\u6c42|\u77e5\u8bc6\u5e93|\u6587\u6863/.test(normalized);
+    const hasReviewSignal = /\b(review|code review|audit|handoff)\b|\u8bc4\u5ba1|\u4ee3\u7801\u5ba1\u67e5|\u5ba1\u67e5|\u5ba1\u6838|\u590d\u6838|\u4ea4\u4ed8/.test(normalized);
+    const hasBugSignal = /\b(bug|fix|regression|error)\b|\u4fee\u590d|\u9519\u8bef|\u62a5\u9519|\u7f3a\u9677/.test(normalized);
+    const hasTestSignal = /\b(e2e|integration test|test|playwright|vitest)\b|\u6d4b\u8bd5|\u7aef\u5230\u7aef|\u96c6\u6210\u6d4b\u8bd5/.test(normalized);
+    const hasApiSignal = /\b(api|swagger|endpoint|interface|request|dto)\b|\u63a5\u53e3|\u8bf7\u6c42|\u5bf9\u63a5|\u8054\u8c03/.test(normalized);
+    const hasRequirementChange = /\b(requirement changes?|changed [a-z0-9 -]*requirements?|update [a-z0-9 -]*requirements?|sync [a-z0-9 -]*requirements?)\b|\u9700\u6c42\u53d8\u66f4|\u53d8\u66f4\u9700\u6c42|\u540c\u6b65\u9700\u6c42/.test(normalized);
+    const hasDocumentationSignal = /\b(readme|docs?|documentation|guide|manual|agents\.md|claude\.md)\b|\u6587\u6863|\u8bf4\u660e|\u6307\u5357/.test(normalized);
+    const hasExplicitDocumentationTarget = /\b(readme|docs?|guide|manual|agents\.md|claude\.md)\b|\u6587\u6863|\u8bf4\u660e|\u6307\u5357/.test(normalized);
+    const hasMaintenanceSignal = /\b(cli|runtime|config|package|script|scaffold|harness|protocol|workflow|planning|planner|resolver|policy|maintenance|refactor)\b|\u811a\u624b\u67b6|\u534f\u8bae|\u89c4\u5212|\u5206\u6d3e|\u7ef4\u62a4|\u91cd\u6784|\u51c6\u786e\u6027/.test(normalized);
+    const hasPlannerMaintenanceSignal = /\b(plan|planning|planner|resolver|policy|runtime|harness|workflow)\b|\u89c4\u5212|\u5206\u6d3e/.test(normalized);
+    const systemKind = hasReviewSignal
+        ? "frontend_review"
+        : hasBugSignal
+            ? "bug_fix"
+            : hasRequirementChange
+                ? "requirement_change"
+                : hasTestSignal
+                    ? "frontend_test"
+                    : hasApiSignal
+                        ? "api_integration"
+                        : hasMaintenanceSignal && hasPlannerMaintenanceSignal && !hasAttachedUiSource && !hasExplicitDocumentationTarget
+                            ? "maintenance"
+                            : hasMaintenanceSignal && !hasAttachedUiSource && !hasUiImplementationSignal && !hasExplicitDocumentationTarget
+                                ? "maintenance"
+                                : hasDocumentationSignal && !hasAttachedUiSource && !hasUiImplementationSignal
+                                    ? "documentation"
+                                    : hasMaintenanceSignal && !hasAttachedUiSource && !hasUiImplementationSignal
+                                        ? "maintenance"
+                                        : hasPrdSource && !hasUiSource
+                                            ? "prd_knowledge"
+                                            : "ui_implementation";
+    const evidenceKind = selectEvidenceWorkflowKind(systemKind, proposal?.planningEvidence);
+    const kind = evidenceKind ?? systemKind;
+    return workflowPolicy(kind, { hasPrdSource, hasUiSource });
+}
+export function verificationForWorkflow(kind) {
+    if (kind === "frontend_test") {
+        return ["targeted test", "typecheck"];
+    }
+    if (kind === "bug_fix") {
+        return ["regression test", "typecheck"];
+    }
+    if (kind === "frontend_review") {
+        return ["typecheck", "test", "build"];
+    }
+    if (kind === "api_integration") {
+        return ["typecheck", "integration test or API mock"];
+    }
+    if (kind === "requirement_change") {
+        return ["typecheck", "affected regression test"];
+    }
+    if (kind === "prd_knowledge") {
+        return ["knowledge review"];
+    }
+    if (kind === "documentation") {
+        return ["documentation review"];
+    }
+    if (kind === "maintenance") {
+        return ["regression test", "typecheck", "build"];
+    }
+    return ["typecheck"];
+}
+function selectEvidenceWorkflowKind(systemKind, evidence) {
+    const candidates = [...(evidence?.workflowCandidates ?? [])].sort((left, right) => right.confidence - left.confidence);
+    const primary = candidates[0];
+    const runnerUp = candidates[1];
+    const margin = primary && runnerUp ? primary.confidence - runnerUp.confidence : primary?.confidence ?? 0;
+    if (!primary || primary.confidence < 0.75 || margin < 0.2) {
+        return null;
+    }
+    if (primary.kind === systemKind) {
+        return primary.kind;
+    }
+    if (systemKind === "ui_implementation") {
+        return primary.kind;
+    }
+    if (primary.confidence >= 0.9 && systemKind !== "bug_fix" && systemKind !== "requirement_change") {
+        return primary.kind;
+    }
+    return null;
+}
+function workflowPolicy(kind, inputSignals) {
+    const policies = {
+        ui_implementation: {
+            kind,
+            summary: "Implement or adapt frontend UI while preserving project semantics, component boundaries, and validation evidence.",
+            requiredKnowledgeActions: inputSignals.hasUiSource
+                ? ["Capture reusable UI semantics, component responsibilities, and design assumptions in project knowledge when they affect future work."]
+                : ["Reuse existing project knowledge before inventing new UI semantics."],
+            implementationConstraints: [
+                "Treat imported MCP/Stitch/Figma/HTML output as source material, not project-ready code.",
+                "Normalize generated UI into project components, naming, state, routing, and styling conventions."
+            ],
+            verificationFocus: ["typecheck", "component behavior", "responsive rendering", "visual regressions when UI source is provided"]
+        },
+        prd_knowledge: {
+            kind,
+            summary: "Convert PRD or requirement material into durable project knowledge before implementation.",
+            requiredKnowledgeActions: [
+                "Promote stable product concepts, terminology, permissions, workflows, and acceptance rules into .frontend-harness/knowledge/.",
+                "Keep raw PRD text separate from distilled project knowledge."
+            ],
+            implementationConstraints: [
+                "Do not implement product behavior until PRD-derived assumptions are explicit.",
+                "Mark unknown product decisions as blockers or assumptions instead of guessing."
+            ],
+            verificationFocus: ["knowledge coverage", "acceptance criteria traceability", "terminology consistency"]
+        },
+        api_integration: {
+            kind,
+            summary: "Integrate frontend behavior with API contracts using project knowledge plus Swagger/API evidence.",
+            requiredKnowledgeActions: [
+                "Reference relevant domain knowledge before mapping request parameters, DTOs, and response states.",
+                "Promote durable API assumptions when Swagger or backend behavior clarifies product rules."
+            ],
+            implementationConstraints: [
+                "Do not invent API fields, enum values, pagination contracts, or error shapes.",
+                "Keep request mapping, loading, empty, and error states inside the project API/state conventions."
+            ],
+            verificationFocus: ["typecheck", "API mapping", "loading/empty/error states", "integration tests or mocks"]
+        },
+        frontend_test: {
+            kind,
+            summary: "Add or update frontend E2E/integration coverage for user-visible behavior.",
+            requiredKnowledgeActions: [
+                "Use project knowledge to choose behavior-level assertions instead of implementation-detail assertions.",
+                "Promote durable testing conventions only when they apply beyond the current task."
+            ],
+            implementationConstraints: [
+                "Prefer behavior-focused integration or E2E tests over brittle snapshot-only checks.",
+                "Keep fixtures and mocks aligned with known API/product contracts."
+            ],
+            verificationFocus: ["targeted test", "typecheck", "critical user path", "failure diagnostics"]
+        },
+        bug_fix: {
+            kind,
+            summary: "Fix a frontend bug with evidence, minimal scope, and regression coverage proportional to risk.",
+            requiredKnowledgeActions: [
+                "Check project knowledge for intended behavior before changing code.",
+                "Promote the resolved product or technical rule if the bug revealed durable knowledge."
+            ],
+            implementationConstraints: [
+                "Reproduce or explain the bug before patching when evidence is available.",
+                "Keep the fix scoped to the failing behavior and avoid unrelated refactors."
+            ],
+            verificationFocus: ["regression test", "typecheck", "affected workflow", "repair evidence"]
+        },
+        frontend_review: {
+            kind,
+            summary: "Review frontend project changes or project health before handoff, with findings grounded in code and validation evidence.",
+            requiredKnowledgeActions: [
+                "Check project-local skills and knowledge before judging conventions.",
+                "Promote durable review findings only when they represent reusable project guidance."
+            ],
+            implementationConstraints: [
+                "Treat review plans as an inspection boundary, not as instructions to create new UI components.",
+                "Fix only evidence-backed, safe, scoped issues discovered during review."
+            ],
+            verificationFocus: ["typecheck", "test", "build", "review findings"]
+        },
+        requirement_change: {
+            kind,
+            summary: "Apply requirement changes and keep implementation, tests, and knowledge synchronized.",
+            requiredKnowledgeActions: [
+                "Update project knowledge for changed product rules before or alongside code changes.",
+                "Record obsolete assumptions so future agents do not reuse stale behavior."
+            ],
+            implementationConstraints: [
+                "Identify impacted UI, API mapping, tests, and knowledge before editing.",
+                "Do not leave previous requirement behavior undocumented when it changes."
+            ],
+            verificationFocus: ["changed acceptance criteria", "knowledge sync", "affected regression tests", "typecheck"]
+        },
+        documentation: {
+            kind,
+            summary: "Update project documentation or agent protocol text without inventing implementation files.",
+            requiredKnowledgeActions: [
+                "Keep documentation aligned with current product behavior and protocol boundaries."
+            ],
+            implementationConstraints: [
+                "Edit documentation targets directly; do not create frontend component files for documentation-only work.",
+                "Preserve generated protocol blocks unless running protocol initialization."
+            ],
+            verificationFocus: ["documentation accuracy", "typecheck when package contracts change"]
+        },
+        maintenance: {
+            kind,
+            summary: "Maintain project tooling, runtime, CLI, configuration, or planning behavior.",
+            requiredKnowledgeActions: [
+                "Record durable product or protocol behavior changes when they affect future agent work."
+            ],
+            implementationConstraints: [
+                "Keep maintenance changes scoped to runtime/tooling behavior and matching tests.",
+                "Do not infer UI component work from project maintenance wording alone."
+            ],
+            verificationFocus: ["regression test", "typecheck", "build"]
+        }
+    };
+    return policies[kind];
+}
+//# sourceMappingURL=workflow.js.map

package/dist/runtime/plan/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../src/runtime/plan/workflow.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,YAAkC;IAC/E,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,YAAY,KAAK,iBAAiB,EAAE,CAAC;QACvC,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,IAAI,YAAY,KAAK,eAAe,EAAE,CAAC;QACrC,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,IAAI,YAAY,KAAK,aAAa,EAAE,CAAC;QACnC,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IACD,IAAI,YAAY,KAAK,SAAS,IAAI,mEAAmE,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACvH,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,YAAY,KAAK,eAAe,IAAI,2FAA2F,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACrJ,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,2BAA2B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACjD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,KAA2B,EAC3B,QAAsC;IAEtC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,mBAAmB,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9C,MAAM,yBAAyB,GAC7B,mJAAmJ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvK,MAAM,WAAW,GACf,mBAAmB,IAAI,sJAAsJ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjM,MAAM,YAAY,GAChB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,yHAAyH,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnK,MAAM,eAAe,GAAG,kIAAkI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5K,MAAM,YAAY,GAAG,oFAAoF,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3H,MAAM,aAAa,GAAG,4GAA4G,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpJ,MAAM,YAAY,GAAG,sGAAsG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7I,MAAM,oBAAoB,GACxB,sMAAsM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1N,MAAM,sBAAsB,GAC1B,4GAA4G,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChI,MAAM,8BAA8B,GAClC,8FAA8F,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClH,MAAM,oBAAoB,GACxB,yOAAyO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7P,MAAM,2BAA2B,GAC/B,gGAAgG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpH,MAAM,UAAU,GAAyB,eAAe;QACtD,CAAC,CAAC,iBAAiB;QACnB,CAAC,CAAC,YAAY;YACZ,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,oBAAoB;gBACpB,CAAC,CAAC,oBAAoB;gBACtB,CAAC,CAAC,aAAa;oBACb,CAAC,CAAC,eAAe;oBACjB,CAAC,CAAC,YAAY;wBACd,CAAC,CAAC,iBAAiB;wBACnB,CAAC,CAAC,oBAAoB,IAAI,2BAA2B,IAAI,CAAC,mBAAmB,IAAI,CAAC,8BAA8B;4BAC9G,CAAC,CAAC,aAAa;4BACjB,CAAC,CAAC,oBAAoB,IAAI,CAAC,mBAAmB,IAAI,CAAC,yBAAyB,IAAI,CAAC,8BAA8B;gCAC7G,CAAC,CAAC,aAAa;gCACjB,CAAC,CAAC,sBAAsB,IAAI,CAAC,mBAAmB,IAAI,CAAC,yBAAyB;oCAC5E,CAAC,CAAC,eAAe;oCACjB,CAAC,CAAC,oBAAoB,IAAI,CAAC,mBAAmB,IAAI,CAAC,yBAAyB;wCAC1E,CAAC,CAAC,aAAa;wCACf,CAAC,CAAC,YAAY,IAAI,CAAC,WAAW;4CAC5B,CAAC,CAAC,eAAe;4CACjB,CAAC,CAAC,mBAAmB,CAAC;IACpC,MAAM,YAAY,GAAG,0BAA0B,CAAC,UAAU,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IACxF,MAAM,IAAI,GAAG,YAAY,IAAI,UAAU,CAAC;IAExC,OAAO,cAAc,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAsC;IAC5E,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;QAC7B,OAAO,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/B,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/B,OAAO,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,IAAI,KAAK,oBAAoB,EAAE,CAAC;QAClC,OAAO,CAAC,WAAW,EAAE,0BAA0B,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;QAC7B,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;QAC7B,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAC3B,OAAO,CAAC,iBAAiB,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,CAAC,WAAW,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,0BAA0B,CACjC,UAAgC,EAChC,QAA2C;IAE3C,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IACvH,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,UAAU,IAAI,CAAC,CAAC;IACzG,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,IAAI,CAAC;IACtB,CAAC;IACD,IAAI,UAAU,KAAK,mBAAmB,EAAE,CAAC;QACvC,OAAO,OAAO,CAAC,IAAI,CAAC;IACtB,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,IAAI,GAAG,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,oBAAoB,EAAE,CAAC;QACjG,OAAO,OAAO,CAAC,IAAI,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CACrB,IAA0B,EAC1B,YAA6D;IAE7D,MAAM,QAAQ,GAAyD;QACrE,iBAAiB,EAAE;YACjB,IAAI;YACJ,OAAO,EAAE,mHAAmH;YAC5H,wBAAwB,EAAE,YAAY,CAAC,WAAW;gBAChD,CAAC,CAAC,CAAC,sIAAsI,CAAC;gBAC1I,CAAC,CAAC,CAAC,qEAAqE,CAAC;YAC3E,yBAAyB,EAAE;gBACzB,yFAAyF;gBACzF,kGAAkG;aACnG;YACD,iBAAiB,EAAE,CAAC,WAAW,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,+CAA+C,CAAC;SAChI;QACD,aAAa,EAAE;YACb,IAAI;YACJ,OAAO,EAAE,2FAA2F;YACpG,wBAAwB,EAAE;gBACxB,+HAA+H;gBAC/H,8DAA8D;aAC/D;YACD,yBAAyB,EAAE;gBACzB,+EAA+E;gBAC/E,gFAAgF;aACjF;YACD,iBAAiB,EAAE,CAAC,oBAAoB,EAAE,kCAAkC,EAAE,yBAAyB,CAAC;SACzG;QACD,eAAe,EAAE;YACf,IAAI;YACJ,OAAO,EAAE,mGAAmG;YAC5G,wBAAwB,EAAE;gBACxB,mGAAmG;gBACnG,2FAA2F;aAC5F;YACD,yBAAyB,EAAE;gBACzB,+EAA+E;gBAC/E,kGAAkG;aACnG;YACD,iBAAiB,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,4BAA4B,EAAE,4BAA4B,CAAC;SAC5G;QACD,aAAa,EAAE;YACb,IAAI;YACJ,OAAO,EAAE,4EAA4E;YACrF,wBAAwB,EAAE;gBACxB,wGAAwG;gBACxG,mFAAmF;aACpF;YACD,yBAAyB,EAAE;gBACzB,qFAAqF;gBACrF,mEAAmE;aACpE;YACD,iBAAiB,EAAE,CAAC,eAAe,EAAE,WAAW,EAAE,oBAAoB,EAAE,qBAAqB,CAAC;SAC/F;QACD,OAAO,EAAE;YACP,IAAI;YACJ,OAAO,EAAE,gGAAgG;YACzG,wBAAwB,EAAE;gBACxB,qEAAqE;gBACrE,uFAAuF;aACxF;YACD,yBAAyB,EAAE;gBACzB,0EAA0E;gBAC1E,4EAA4E;aAC7E;YACD,iBAAiB,EAAE,CAAC,iBAAiB,EAAE,WAAW,EAAE,mBAAmB,EAAE,iBAAiB,CAAC;SAC5F;QACD,eAAe,EAAE;YACf,IAAI;YACJ,OAAO,EAAE,2HAA2H;YACpI,wBAAwB,EAAE;gBACxB,sEAAsE;gBACtE,qFAAqF;aACtF;YACD,yBAAyB,EAAE;gBACzB,gGAAgG;gBAChG,yEAAyE;aAC1E;YACD,iBAAiB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC;SACrE;QACD,kBAAkB,EAAE;YAClB,IAAI;YACJ,OAAO,EAAE,uFAAuF;YAChG,wBAAwB,EAAE;gBACxB,sFAAsF;gBACtF,2EAA2E;aAC5E;YACD,yBAAyB,EAAE;gBACzB,yEAAyE;gBACzE,0EAA0E;aAC3E;YACD,iBAAiB,EAAE,CAAC,6BAA6B,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,WAAW,CAAC;SAC/G;QACD,aAAa,EAAE;YACb,IAAI;YACJ,OAAO,EAAE,6FAA6F;YACtG,wBAAwB,EAAE;gBACxB,mFAAmF;aACpF;YACD,yBAAyB,EAAE;gBACzB,0GAA0G;gBAC1G,4EAA4E;aAC7E;YACD,iBAAiB,EAAE,CAAC,wBAAwB,EAAE,yCAAyC,CAAC;SACzF;QACD,WAAW,EAAE;YACX,IAAI;YACJ,OAAO,EAAE,8EAA8E;YACvF,wBAAwB,EAAE;gBACxB,yFAAyF;aAC1F;YACD,yBAAyB,EAAE;gBACzB,iFAAiF;gBACjF,wEAAwE;aACzE;YACD,iBAAiB,EAAE,CAAC,iBAAiB,EAAE,WAAW,EAAE,OAAO,CAAC;SAC7D;KACF,CAAC;IACF,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/runtime/plan.d.ts

@@ -1,9 +1,9 @@
-import type { AgentDecisionCheckResult, ComponentItem, ExecutionGuidanceStep, ExecutionUnit, TaskUnderstanding } from "../schemas/types.js";
+import type { AgentProposalCheckResult, ComponentItem, ExecutionGuidanceStep, ExecutionUnit, PlanMeta, TaskUnderstanding } from "../schemas/types.js";
 export interface PlanInput {
     taskText: string;
     prd?: string;
     ui?: string;
-    agentDecision?: string;
+    agentProposal?: string;
 }
 export interface PlanOutput {
     task: TaskUnderstanding;
@@ -13,6 +13,7 @@ export interface PlanOutput {
     componentGraphPath: string;
     guidancePath: string;
     statePath: string;
+    meta: PlanMeta;
 }
 export declare function createPlan(projectRoot: string, input: PlanInput): PlanOutput;
-export declare function checkAgentPlanningDecision(projectRoot: string, file: string | undefined): AgentDecisionCheckResult;
+export declare function checkAgentPlanningProposal(projectRoot: string, file: string | undefined): AgentProposalCheckResult;