@exellix/ai-tasks 9.1.0 → 10.0.0

package/dist/utils/runTaskRequestShape.js

@@ -55,11 +55,11 @@ function collectRunTaskObservabilityHints(req) {
     if (req.executionMode === "trace")
         return [];
     const hints = [];
-    const pipe = req.executionPipeline;
-    if (pipe?.some((s) => s.phase === "pre" && s.type === SYNTHESIZED_CONTEXT)) {
-        hints.push('Observability: PRE "synthesized-context" invokes xynthesis; use executionMode: "trace" for synthesis diagnostics.');
+    const units = req.nodePlan?.executionUnits ?? [];
+    if (units.some((u) => u.unitKind === "externalPreUtility" && (u.strategyKey === "synthesis" || u.actionKey === "synthesis"))) {
+        hints.push('Observability: PRE synthesis invokes xynthesis; use executionMode: "trace" for synthesis diagnostics.');
     }
-    if (pipe?.some((s) => s.phase === "post" && (s.type === "audit" || s.type === "polish"))) {
+    if (units.some((u) => u.unitKind === "externalPostUtility")) {
         hints.push('Observability: POST audit/polish invokes xynthesis; use executionMode: "trace" for per-step LLM observations.');
     }
     if (req.aiScoping && req.aiScoping.length > 0) {
@@ -84,28 +84,6 @@ export function emitRunTaskRequestWarnings(req) {
             fieldEvidence("inputs.present", req.inputs !== undefined),
         ]);
     }
-    const pipeline = req.executionPipeline;
-    if (pipeline?.length) {
-        const pre = pipeline.filter((s) => s.phase === "pre");
-        const synthPre = pre.filter((s) => s.type === SYNTHESIZED_CONTEXT);
-        if (synthPre.length > 1) {
-            emitAiTasksDiagnosticWarning(AI_TASKS_DIAGNOSTIC_CODES.EXECUTION_PIPELINE_MULTIPLE_SYNTH_PRE, `executionPipeline: ${synthPre.length} PRE steps with type "${SYNTHESIZED_CONTEXT}"; only the first is executed — consolidate extra PRE steps.`, [
-                fieldEvidence("executionPipeline.pre.synthesizedContext.count", synthPre.length),
-                fieldEvidence("executionPipeline.pre.synthesizedContext.allowed", 1),
-            ]);
-        }
-        for (const s of pre) {
-            if (s.type !== SYNTHESIZED_CONTEXT) {
-                emitAiTasksDiagnosticWarning(AI_TASKS_DIAGNOSTIC_CODES.EXECUTION_PIPELINE_UNSUPPORTED_PRE, `executionPipeline: PRE step type "${String(s.type)}" is not supported — runTask throws at execution (only "${SYNTHESIZED_CONTEXT}" is allowed).`, [fieldEvidence("executionPipeline.pre.type", s.type)]);
-            }
-        }
-        const post = pipeline.filter((s) => s.phase === "post");
-        for (const s of post) {
-            if (s.type !== "audit" && s.type !== "polish") {
-                emitAiTasksDiagnosticWarning(AI_TASKS_DIAGNOSTIC_CODES.EXECUTION_PIPELINE_UNSUPPORTED_POST, `executionPipeline: POST step type "${String(s.type)}" is not supported — ignored (only "audit" and "polish").`, [fieldEvidence("executionPipeline.post.type", s.type)]);
-            }
-        }
-    }
     for (const message of collectRunTaskObservabilityHints(req)) {
         emitAiTasksDiagnosticWarning(AI_TASKS_DIAGNOSTIC_CODES.RUN_TASK_OBSERVABILITY_HINT, message, [
             fieldEvidence("executionMode", req.executionMode ?? "default"),

package/dist/utils/runTaskRequestShape.js.map

@@ -1 +1 @@
-{"version":3,"file":"runTaskRequestShape.js","sourceRoot":"","sources":["../../src/utils/runTaskRequestShape.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runTaskRequestShape.js","sourceRoot":"","sources":["../../src/utils/runTaskRequestShape.ts"],"names":[],"mappings":"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"}

package/dist/utils/skillTemplateVariables.d.ts

@@ -7,8 +7,9 @@ export declare function passthroughJobTemplateVariables(variables: unknown): Rec
 /**
  * Merges caller fields into a single template `variables` map (optional host helper — **not** used on `runTask` MAIN).
  *
- * Normative precedence: see `RUNTASK_REQUEST.md`. Graph-engine 5.13+ should compile scopes into
- * `variables` (job) + `executionMemory.taskVariables` instead of relying on this merge at invoke time.
+ * Normative precedence: see `RUNTASK_REQUEST.md`. Graph-engine should compile job scope into
+ * `variables` / `executionMemory.jobVariables` and node scope into `nodePlan.invokeContract.taskVariable`
+ * instead of relying on this merge at invoke time.
  */
 export declare function mergeSkillTemplateVariables(req: {
     variables?: Record<string, unknown>;

package/dist/utils/skillTemplateVariables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skillTemplateVariables.d.ts","sourceRoot":"","sources":["../../src/utils/skillTemplateVariables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAErG;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK3F;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;CACnD,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmD1B"}
+{"version":3,"file":"skillTemplateVariables.d.ts","sourceRoot":"","sources":["../../src/utils/skillTemplateVariables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAErG;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK3F;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;CACnD,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmD1B"}

package/dist/utils/skillTemplateVariables.js

@@ -11,8 +11,9 @@ export function passthroughJobTemplateVariables(variables) {
 /**
  * Merges caller fields into a single template `variables` map (optional host helper — **not** used on `runTask` MAIN).
  *
- * Normative precedence: see `RUNTASK_REQUEST.md`. Graph-engine 5.13+ should compile scopes into
- * `variables` (job) + `executionMemory.taskVariables` instead of relying on this merge at invoke time.
+ * Normative precedence: see `RUNTASK_REQUEST.md`. Graph-engine should compile job scope into
+ * `variables` / `executionMemory.jobVariables` and node scope into `nodePlan.invokeContract.taskVariable`
+ * instead of relying on this merge at invoke time.
  */
 export function mergeSkillTemplateVariables(req) {
     const job = req.jobContext && typeof req.jobContext === "object" && !Array.isArray(req.jobContext)

package/dist/utils/skillTemplateVariables.js.map

@@ -1 +1 @@
-{"version":3,"file":"skillTemplateVariables.js","sourceRoot":"","sources":["../../src/utils/skillTemplateVariables.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skillTemplateVariables.js","sourceRoot":"","sources":["../../src/utils/skillTemplateVariables.ts"],"names":[],"mappings":"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"}

package/dist/validation/validateProfessionalAnswerContract.d.ts

@@ -0,0 +1,8 @@
+import type { RunTaskRequest } from "../types/task-types.js";
+import type { RunTaskValidationIssue } from "./types.js";
+/**
+ * `professional-answer` requires `nodePlan.invokeContract.taskVariable.question`
+ * (Rendrix prompt `{{taskVariables.question}}`). Node design must not live on `input` or `executionMemory`.
+ */
+export declare function validateProfessionalAnswerContract(request: RunTaskRequest, issues: RunTaskValidationIssue[]): void;
+//# sourceMappingURL=validateProfessionalAnswerContract.d.ts.map

package/dist/validation/validateProfessionalAnswerContract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateProfessionalAnswerContract.d.ts","sourceRoot":"","sources":["../../src/validation/validateProfessionalAnswerContract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAgBzD;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,sBAAsB,EAAE,GAC/B,IAAI,CA0BN"}

package/dist/validation/validateProfessionalAnswerContract.js

@@ -0,0 +1,45 @@
+import { isProfessionalAnswerSkillKey } from "../node-execution/compileProfessionalAnswerRequest.js";
+import { collectForbiddenWireFieldPaths } from "../node-execution/rejectForbiddenWireFields.js";
+import { isNonEmptyString, pushIssue } from "./helpers.js";
+function isRecord(v) {
+    return !!v && typeof v === "object" && !Array.isArray(v);
+}
+function readPlanTaskVariableQuestion(request) {
+    const contract = request.nodePlan?.invokeContract;
+    if (!isRecord(contract))
+        return undefined;
+    const taskVariable = contract.taskVariable;
+    if (!isRecord(taskVariable))
+        return undefined;
+    return isNonEmptyString(taskVariable.question)
+        ? String(taskVariable.question).trim()
+        : undefined;
+}
+/**
+ * `professional-answer` requires `nodePlan.invokeContract.taskVariable.question`
+ * (Rendrix prompt `{{taskVariables.question}}`). Node design must not live on `input` or `executionMemory`.
+ */
+export function validateProfessionalAnswerContract(request, issues) {
+    if (!isProfessionalAnswerSkillKey(String(request.skillKey ?? "")))
+        return;
+    for (const path of collectForbiddenWireFieldPaths(request)) {
+        if (path === "question" ||
+            path === "input.question" ||
+            path === "input.outputContract" ||
+            path === "executionMemory.taskVariables") {
+            pushIssue(issues, {
+                code: "PROFESSIONAL_ANSWER_FORBIDDEN_WIRE_FIELD",
+                path,
+                message: `professional-answer: forbidden on wire when nodePlan is set — ${path}. Use nodePlan.invokeContract.taskVariable instead.`,
+            });
+        }
+    }
+    if (!readPlanTaskVariableQuestion(request)) {
+        pushIssue(issues, {
+            code: "PROFESSIONAL_ANSWER_MISSING_TASK_VARIABLE_QUESTION",
+            path: "nodePlan.invokeContract.taskVariable.question",
+            message: "professional-answer requires nodePlan.invokeContract.taskVariable.question (Rendrix {{taskVariables.question}}).",
+        });
+    }
+}
+//# sourceMappingURL=validateProfessionalAnswerContract.js.map

package/dist/validation/validateProfessionalAnswerContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateProfessionalAnswerContract.js","sourceRoot":"","sources":["../../src/validation/validateProfessionalAnswerContract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,uDAAuD,CAAC;AACrG,OAAO,EAAE,8BAA8B,EAAE,MAAM,gDAAgD,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG3D,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,4BAA4B,CAAC,OAAuB;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC;IAC3C,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,OAAO,gBAAgB,CAAC,YAAY,CAAC,QAAQ,CAAC;QAC5C,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE;QACtC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAChD,OAAuB,EACvB,MAAgC;IAEhC,IAAI,CAAC,4BAA4B,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAAE,OAAO;IAE1E,KAAK,MAAM,IAAI,IAAI,8BAA8B,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,IACE,IAAI,KAAK,UAAU;YACnB,IAAI,KAAK,gBAAgB;YACzB,IAAI,KAAK,sBAAsB;YAC/B,IAAI,KAAK,+BAA+B,EACxC,CAAC;YACD,SAAS,CAAC,MAAM,EAAE;gBAChB,IAAI,EAAE,0CAA0C;gBAChD,IAAI;gBACJ,OAAO,EAAE,iEAAiE,IAAI,qDAAqD;aACpI,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,CAAC,4BAA4B,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,SAAS,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,oDAAoD;YAC1D,IAAI,EAAE,+CAA+C;YACrD,OAAO,EACL,kHAAkH;SACrH,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/validation/validateRunTaskConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateRunTaskConfig.d.ts","sourceRoot":"","sources":["../../src/validation/validateRunTaskConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAmB,MAAM,wBAAwB,CAAC;AAgB7F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AA4E1D;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,uBAAuB,CA2GtF"}
+{"version":3,"file":"validateRunTaskConfig.d.ts","sourceRoot":"","sources":["../../src/validation/validateRunTaskConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAc7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG1D;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,uBAAuB,CA0GtF"}

package/dist/validation/validateRunTaskConfig.js

@@ -1,71 +1,9 @@
-import { SYNTHESIZED_CONTEXT } from "../types/task-types.js";
 import { validateNodeExecutionPlan } from "@x12i/graphenix-plan-format";
 import { rejectForbiddenWireFields } from "../node-execution/rejectForbiddenWireFields.js";
-import { collectExecutionPipelineWarnings } from "../utils/runTaskRequestShape.js";
 import { resolveRunTaskRuntimeKnobs } from "../internal/resolveRunTaskRuntimeKnobs.js";
 import { collectSmartInputValidationIssues } from "./collectSmartInputValidationIssues.js";
-import { finalizeValidationResult, isNonEmptyString, pushIssue, validateLlmCallFields, validateModelConfigFields, validateRunTaskModelConfig, validateRootLlmCallModelScope, } from "./helpers.js";
-function validateExecutionPipeline(pipeline, issues) {
-    if (!pipeline?.length)
-        return;
-    const mainSteps = pipeline.filter((s) => s.phase === "main");
-    if (mainSteps.length !== 1) {
-        pushIssue(issues, {
-            code: "PIPELINE_MAIN_COUNT",
-            path: "executionPipeline",
-            message: `executionPipeline must contain exactly one step with phase "main"; got ${mainSteps.length}.`,
-        });
-    }
-    for (const w of collectExecutionPipelineWarnings(pipeline)) {
-        pushIssue(issues, {
-            code: "PIPELINE_UNSUPPORTED_STEP",
-            severity: "warning",
-            path: "executionPipeline",
-            message: w,
-        });
-    }
-    for (let i = 0; i < pipeline.length; i++) {
-        const step = pipeline[i];
-        if (step.phase === "pre" && step.type === SYNTHESIZED_CONTEXT) {
-            const cfg = (step.config ?? {});
-            validateModelConfigFields(cfg.modelConfig, `executionPipeline[${i}].config.modelConfig`, issues);
-            validateLlmCallFields(cfg.llmCall, `executionPipeline[${i}].config.llmCall`, issues);
-        }
-        if (step.phase === "post" && (step.type === "audit" || step.type === "polish")) {
-            const cfg = step.config;
-            if (cfg && typeof cfg === "object") {
-                validateModelConfigFields(cfg.modelConfig, `executionPipeline[${i}].config.modelConfig`, issues);
-                validateLlmCallFields(cfg.llmCall, `executionPipeline[${i}].config.llmCall`, issues);
-                const llm = cfg.llmCall;
-                if (llm && typeof llm === "object" && !Array.isArray(llm)) {
-                    const nested = llm;
-                    if (nested.audit) {
-                        validateLlmCallFields(nested.audit, `executionPipeline[${i}].config.llmCall.audit`, issues);
-                    }
-                    if (nested.synthesis) {
-                        validateLlmCallFields(nested.synthesis, `executionPipeline[${i}].config.llmCall.synthesis`, issues);
-                    }
-                }
-            }
-        }
-    }
-}
-function validateSynthesisPreRequirements(request, issues) {
-    const pipeline = request.executionPipeline;
-    if (!pipeline?.some((s) => s.phase === "pre" && s.type === SYNTHESIZED_CONTEXT))
-        return;
-    const hasContext = request.includeContextInPrompt === true ||
-        pipeline.some((s) => s.phase === "pre" &&
-            s.type === SYNTHESIZED_CONTEXT &&
-            s.config?.autoEnableContext === true);
-    if (!hasContext) {
-        pushIssue(issues, {
-            code: "SYNTHESIS_PRE_REQUIRES_CONTEXT",
-            path: "includeContextInPrompt",
-            message: 'PRE "synthesized-context" requires includeContextInPrompt: true or synthesisConfig.autoEnableContext: true on the PRE step.',
-        });
-    }
-}
+import { finalizeValidationResult, isNonEmptyString, pushIssue, validateLlmCallFields, validateRunTaskModelConfig, validateRootLlmCallModelScope, } from "./helpers.js";
+import { validateProfessionalAnswerContract } from "./validateProfessionalAnswerContract.js";
 /**
  * Validate **static** `RunTaskRequest` configuration (model, pipeline, correlation ids, smartInput shape).
  * Does **not** check whether memory paths resolve — use {@link validateRunTaskInvoke} for that.
@@ -165,8 +103,7 @@ export function validateRunTaskConfig(request) {
             });
         }
     }
-    validateExecutionPipeline(resolved.executionPipeline, issues);
-    validateSynthesisPreRequirements(resolved, issues);
+    validateProfessionalAnswerContract(resolved, issues);
     if (resolved.aiScopingOptions?.llmCall) {
         validateLlmCallFields(resolved.aiScopingOptions.llmCall, "aiScopingOptions.llmCall", issues);
     }

package/dist/validation/validateRunTaskConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"validateRunTaskConfig.js","sourceRoot":"","sources":["../../src/validation/validateRunTaskConfig.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validateRunTaskConfig.js","sourceRoot":"","sources":["../../src/validation/validateRunTaskConfig.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gDAAgD,CAAC;AAC3F,OAAO,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAC;AACvF,OAAO,EAAE,iCAAiC,EAAE,MAAM,wCAAwC,CAAC;AAC3F,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,SAAS,EACT,qBAAqB,EAErB,0BAA0B,EAC1B,6BAA6B,GAC9B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,kCAAkC,EAAE,MAAM,yCAAyC,CAAC;AAE7F;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAuB;IAC3D,MAAM,MAAM,GAAkD,EAAE,CAAC;IACjE,MAAM,QAAQ,GAAG,OAAO,CAAC;IACzB,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvB,SAAS,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,oBAAoB;YAC1B,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,uDAAuD;SACjE,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,SAAS,CAAC,MAAM,EAAE;gBAChB,IAAI,EAAE,sBAAsB;gBAC5B,IAAI,EAAG,CAAwB,CAAC,KAAK,IAAI,UAAU;gBACnD,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;aACpD,CAAC,CAAC;QACL,CAAC;QACD,MAAM,UAAU,GAAG,yBAAyB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACtB,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;gBACpC,SAAS,CAAC,MAAM,EAAE;oBAChB,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,UAAU;oBAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAEjD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzC,SAAS,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,wCAAwC;SAClD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,SAAS,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,kFAAkF,QAAQ,EAAE;SACtG,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1C,SAAS,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,mDAAmD,QAAQ,EAAE;SACvE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,SAAS,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,sBAAsB;YAC5B,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,oDAAoD,QAAQ,EAAE;SACxE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACjD,SAAS,CAAC,MAAM,EAAE;YAChB,IAAI,EAAE,8BAA8B;YACpC,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EACL,gFAAgF,GAAG,QAAQ;SAC9F,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,0BAA0B,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,SAAS,CAAC,MAAM,EAAE;gBAChB,IAAI,EAAE,uBAAuB;gBAC7B,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;aACpD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,iCAAiC,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEjF,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvB,0BAA0B,CAAC,QAAQ,CAAC,WAAW,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;QACxE,6BAA6B,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChF,CAAC;IACD,qBAAqB,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAE3D,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACrC,IAAI,OAAO,QAAQ,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YAC7G,SAAS,CAAC,MAAM,EAAE;gBAChB,IAAI,EAAE,oBAAoB;gBAC1B,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,kDAAkD;aAC5D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,kCAAkC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAErD,IAAI,QAAQ,CAAC,gBAAgB,EAAE,OAAO,EAAE,CAAC;QACvC,qBAAqB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,0BAA0B,EAAE,MAAM,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/documenations/record-and-template-variables.md

@@ -1,32 +1,40 @@
 # Record fields and template variables (`runTask`)
 
-This document describes how **task input** and **record-shaped** payloads reach gateway templates and skills, and how that relates to NARRIX pre-processing.
+How **task input**, **execution memory buckets**, and **record-shaped** payloads reach gateway templates and skills — and how that relates to NARRIX pre-processing.
+
+## Scope buckets (graph-engine 5.13+)
+
+| Scope | Authoring / wire | Template tokens |
+|--------|------------------|-----------------|
+| **Job / graph** | `executionMemory.jobVariables` (legacy top-level `variables` ≡ job bag on MAIN) | `{{jobVariables.*}}` |
+| **Node / task** | `executionMemory.taskVariables` | `{{taskVariables.*}}` |
+| **Payload** | top-level `input`, `xynthesized`, `smartInput` | `{{input}}`, `{{smartInput}}`, … |
+
+Node-scoped values such as **`question`** for `skills/professional-answer` belong in **`executionMemory.taskVariables.question`**, not in `variables` or merged into `input` alone.
 
 ## Default: forward opaque fields (no allowlist)
 
-For the **MAIN** LLM path, `mergeSkillTemplateVariables` builds the `variables` object sent to the executor / gateway:
+On the **MAIN** LLM path, `mergeSkillTemplateVariables` builds the job-scope **`variables`** object for legacy templates. It does **not** fold `executionMemory.taskVariables` into that bag.
 
 - **`jobContext`** is merged first (lowest precedence).
-- Explicit **`variables`** are merged on top.
-- When **`input`** is a plain object, **every enumerable key** on `input` is copied into **`variables.inputs`** (merged with any existing `variables.inputs`). If `input.question` is a string and `variables.question` is unset, it is also copied to **`variables.question`**.
-
-There is **no** stripping of unknown or “enrichment” keys such as **`mitreAttack`**, nested blobs, or vendor-specific fields, as long as they live on the **`input`** object (or on nested objects under `input`, e.g. `input.record.mitreAttack`).
+- Explicit **`variables`** (job scope) are merged on top.
+- When **`input`** is a plain object, enumerable keys are copied into **`variables.inputs`**.
 
-**Implication:** templates that reference `inputs.record.mitreAttack`, `inputs.mitreAttack`, etc. receive the same JSON shape the caller passed on `RunTaskRequest.input`, unless a **future** explicit blocklist is added (none by default).
+There is **no** stripping of unknown keys on **`input`** (e.g. `input.record.mitreAttack`).
 
 ## Reserved / runtime-owned names (conventions)
 
-These are **not** automatically stripped today, but **callers should avoid** using them on `input` for domain data if they conflict with runtime-injected fields:
+Avoid using these on **`input`** for domain data when they conflict with runtime injection:
 
-- **`aiScoped`** — may be injected by the AI scoping pre-step when `aiScoping` is configured.
-- **`question`** — special-cased for template convenience (`variables.question`).
+- **`aiScoped`** — injected by the AI scoping pre-step when configured.
+- **`outputContract`** — belongs on the run request / `taskVariable`, not inside `input` for `professional-answer`.
 
-Memory surfaces (**`jobMemory`**, **`taskMemory`**, **`executionMemory`**) use their own keys (`_narrix`, `webContext`, `synthesizedContext`, `synthesizedInput`, `webContextMarkdown`, etc.). Domain records are usually under **`input`**, **`jobMemory.record`**, **`jobMemory.currentRecord`**, or **`executionMemory.input.raw`** / **`executionMemory.input.record`** depending on orchestration; see NARRIX adapter tests and [run-task-execution-flow.md](./run-task-execution-flow.md).
+Memory surfaces (**`jobMemory`**, **`taskMemory`**, **`executionMemory`**) use their own keys (`_narrix`, `webContext`, `synthesizedContext`, `taskVariables`, `jobVariables`, etc.). Domain records are usually under **`input`**, **`executionMemory.input`** (flat MAIN bucket — not `input.raw`), or NARRIX attachments. See [run-task-execution-flow.md](./run-task-execution-flow.md).
 
 ## NARRIX `record` medium
 
-For **`medium: "record"`**, the object passed to Narrix is produced by **`@woroces/memory-narrix-adapter`** from configured memory paths. That adapter returns the **resolved record object**; enrichment fields on that object are preserved **unless** a future blocklist is introduced in the adapter or caller.
+For **`medium: "record"`**, the object passed to Narrix is produced by **`@woroces/memory-narrix-adapter`** from configured memory paths. Enrichment fields on that object are preserved unless a future blocklist is introduced.
 
 ## Regression expectation
 
-A record that includes **`mitreAttack`** on the task **`input`** (e.g. under **`input.record`**) is reflected unchanged under **`variables.inputs`** for the MAIN skill invocation.
+A record that includes **`mitreAttack`** on task **`input`** (e.g. under **`input.record`**) is reflected unchanged under **`variables.inputs`** for the MAIN skill invocation when using the legacy merge helper.

package/documenations/run-task-execution-flow.md

@@ -144,7 +144,7 @@ flowchart LR
 
 ## Diagnostics, trace mode, and observability digest
 
-**Current `runTask` implementation (`task-sdk.ts`)** does **not** implement **`request.diagnostics`**, **`appendRunLog`**, **`RunLogEntry` buffering**, or a Logxer-shaped sink on the request. Orchestrators that merge **`runLog`** / **`exellixRunLog`** / **`logxerRunId`** / **`logxerCorrelationId`** into **`response.metadata`** own that contract — see [.docs/investigation/external-packages-assignments.md](../.docs/investigation/external-packages-assignments.md).
+**Current `runTask` implementation (`task-sdk.ts`)** does **not** implement **`request.diagnostics`**, **`appendRunLog`**, **`RunLogEntry` buffering**, or a Logxer-shaped sink on the request. Orchestrators that merge **`runLog`** / **`exellixRunLog`** / **`logxerRunId`** / **`logxerCorrelationId`** into **`response.metadata`** own that contract — see [external-packages-assignments.md](../../archived/ai-tasks/.docs/investigation/external-packages-assignments.md).
 
 - **`executionMode: "trace"`**: forwards trace-related flags to **`@exellix/ai-skills`** `runSkill`; see **`RunSkillDiagnostics`** / **`SkillDiagnosticsTrace`** on that package. Structured **SDK log lines** use **`@x12i/logxer`** from ai-skills execution — not the orchestrator run-log row shape.
 - **`extractAiTasksObservabilityFromRunTaskResponse`**: builds a versioned **`AiTasksObservabilityDigest`** from `metadata` + execution memory for graph UIs (optional attachment).

package/documenations/skill-orchestration-strategy-cr-fr.md

@@ -0,0 +1,147 @@
+# Skill execution strategy model — CR/FR (ai-tasks + consumers)
+
+Filed by: `@exellix/ai-tasks` (runtime), `@exellix/graph-engine` (compile/plan), `@exellix/xynthesis` (sidekick actions)  
+Status: Draft — target architecture agreed in product discussion (2026-06-13)  
+Baseline: `@exellix/ai-tasks` 9.x+, graph-engine 8.1.x nodePlan path  
+Related: [run-task-execution-flow.md](./run-task-execution-flow.md), [funcx-pre-post-sidekick-actions.md](./funcx-pre-post-sidekick-actions.md), [graph-engine-runtask-contract-alignment-investigation.md](./upstream-feature-requests/graph-engine-runtask-contract-alignment-investigation.md)
+
+## 0. Executive summary
+
+The runtime today mixes three different concepts under “PRE/POST strategy”:
+
+| Concept | What it should mean | What the code calls it today |
+|---------|---------------------|------------------------------|
+| Pre-SKILL actions | web-scope, Narrix, memory enrichment | `narrixMode`, NARRIX units, web scoper |
+| PRE strategy (fan-out) | plan/split → N MAIN instances with sub-inputs | Not implemented; planner only merges prompt vars into one MAIN |
+| PRE step (context synthesis) | Build prompt context before MAIN | `externalPreUtility` synthesis; catalog `ai-task-strategies-pre` (misnamed) |
+| POST strategy (fan-in) | merge N MAIN outputs → one answer | Not implemented; FuncX `post/craft-final` exists upstream but unwired |
+| POST strategy (self-improve) | audit loop + feedback + pick-best | Partially: audit POST step + separate optimizer execution strategy |
+
+**Goal:** Align naming, catalogs, and runtime so engineers can reason in two layers:
+
+```
+[Layer 1 — pre-SKILL]  web-scope → narrix / pre-actions
+[Layer 2 — in-SKILL]   PRE strategy → MAIN (1..N) → POST strategy
+```
+
+## 1. Target architecture (normative)
+
+### 1.1 Layer 1 — Pre-SKILL actions (outside skill boundary)
+
+`web-scope? → narrix / other pre-actions → enter SKILL`
+
+Purpose: enrich memory/evidence before the skill runs. Controls: `narrixMode`, `request.narrix`, web scoping, graph-level utilities. Not in scope: splitting work, multiple MAIN, audit loops.
+
+### 1.2 Layer 2 — Inside SKILL
+
+`PRE strategy? → MAIN (1 or N) → POST strategy?`
+
+**Pattern A — Map-reduce (fan-out / fan-in)**
+
+| Phase | Role | Examples |
+|-------|------|----------|
+| PRE strategy | Decide how many MAIN runs and sub-inputs | `plan`, `split` |
+| MAIN | N independent skill invocations | same `skillKey`, different input per shard |
+| POST strategy | Combine partial answers | `merge`, `craft-final`, `synthesis` |
+
+**Pattern B — Self-improving loop (no PRE strategy)**
+
+MAIN → audit gate → retry if allowed → pick best (optional merge of top candidates).
+
+Invariants:
+
+- PRE/POST strategy keys describe orchestration of MAIN, not memory-source selection.
+- `narrixMode` is orthogonal to PRE/POST strategy.
+- Pattern A and B may compose (e.g. split → 3 MAIN each with audit loop → merge).
+
+## 2. Gap taxonomy
+
+| Kind | Meaning |
+|------|---------|
+| CR | Existing behavior or naming contradicts the target model; fix or deprecate |
+| FR | New capability required to reach the target model |
+
+## 3. Change requests (CR)
+
+### CR-AITASKS-1 — Rename / re-scope `ai-task-strategies-pre` catalog
+
+Treat as **synthesis input source** (`ai-task-synthesis-input-strategies` alias). UI/docs: “Synthesis input source”, not “Pre strategy”.
+
+### CR-AITASKS-2 — Disentangle `executionStrategies` planner/optimizer from PRE/POST strategy
+
+Document as MAIN wrappers (prompt shaping + lightweight retry), not fan-out PRE strategy.
+
+### CR-AITASKS-3 — synthesized-context PRE step is not PRE strategy
+
+Reserve `synthesis` on `aiTaskStrategies.pre` for “enable synthesized-context step”. POST merge uses distinct keys (`merge`, `craft-final`).
+
+### CR-AITASKS-4 — nodePlan `externalPostUtility` audit path incomplete
+
+Wire real `reRunMain` and `contextMarkdown` on nodePlan audit units.
+
+### CR-AITASKS-5 — Exactly-one MAIN invariant blocks Pattern A
+
+Document until FR-AITASKS-1 ships.
+
+### CR-GRAPH-1 — `preStrategyKey` / `postStrategyKey` semantics
+
+Define allowed orchestration keys per pattern; compile into typed `nodePlan.executionUnits`.
+
+## 4. Feature requests (FR)
+
+### FR-AITASKS-1 — PRE orchestration fan-out (`plan`, `split`)
+
+### FR-AITASKS-2 — MAIN shard execution policy (sequential first)
+
+### FR-AITASKS-3 — POST orchestration fan-in (`merge`, `pick-best`)
+
+### FR-AITASKS-4 — Canonical PRE/POST orchestration catalogs
+
+`ai-task-pre-orchestration-strategies`, `ai-task-post-orchestration-strategies`
+
+### FR-AITASKS-5 — Unify audit-loop POST strategy (Pattern B)
+
+### FR-AITASKS-6 — Compose Pattern A + B (P2)
+
+### FR-GRAPH-1 — Compile `aiTaskOrchestration` → nodePlan units
+
+### FR-XYN-1 — Sidekick actions for orchestration (`execution/split`, extended `execution/plan`)
+
+## 5. Phasing
+
+**Phase 1 (P0):** CR-AITASKS-1/2/5, FR-AITASKS-4/5, CR-AITASKS-4, legacy removal, skill support templates, synthesis context wiring.
+
+**Phase 2 (P0):** FR-AITASKS-1/3, FR-XYN-1, FR-GRAPH-1.
+
+**Phase 3 (P2):** FR-AITASKS-6.
+
+## Phase 2 (implemented in ai-tasks 10.x)
+
+Fan-out/fan-in orchestration runtime:
+
+- **PRE** `externalPreUtility` with `strategyKey: plan | split` → `executionMemory.orchestration.shards`
+- **MAIN** single `mainSkill` unit runs all shards sequentially when no `unitParams.shardId`; or one unit per shard from graph-engine compile
+- **POST** `externalPostUtility` with `strategyKey: merge | pick-best` → FuncX `post/craft-final` / `post/pick-best`
+- **Web scope (Layer 1)** standalone `externalPreUtility` `strategyKey: webScope` or `narrix.enableWebScope` on narrative preprocessor
+
+Graph-engine (FR-GRAPH-1) still compiles `aiTaskOrchestration` into frozen `nodePlan.executionUnits`; runtime accepts compiled plans.
+
+**Graphenix validator note:** `@x12i/graphenix-plan-format` may reject unknown `strategyKey` on units until graph-engine/graphenix allowlist is updated for `split`, `plan`, `merge`, `pick-best`, `webScope`. Runtime implements these keys; coordinate a graphenix minor release if validation blocks compiled plans.
+
+## Phase 2 (deferred — graph-engine / xynthesis only)
+
+- FR-GRAPH-1: compile `aiTaskOrchestration` → typed units (consumer repo)
+- FR-XYN-1: dedicated `execution/split` sidekick action (deterministic split works without it)
+- FR-AITASKS-6: Pattern A + B composition at scale
+
+## 6. Skill support templates (ai-skills)
+
+Skill catalog rows declare **support-role templates** for actions that help MAIN:
+
+- **MAIN:** `instructionsText` / `promptText`
+- **Synthesis context step:** `supportTemplates.synthesisContext[strategyKey]` (keyed by synthesis **input** strategy)
+- **PRE orchestration:** `supportTemplates.preOrchestration[plan|split]` (Phase 2)
+- **POST orchestration:** `supportTemplates.postOrchestration[merge|pick-best]` (Phase 2)
+- **Audit loop:** `auditInstructionsText` / `auditPromptText`
+
+See [RUNTASK_REQUEST.md](../RUNTASK_REQUEST.md) glossary.

package/documenations/upstream-feature-requests/README.md

@@ -11,16 +11,20 @@ Fix reports filed for sibling packages. Hand these to the package owners; after
 | `@exellix/xynthesis` 4.3 | [xynthesis-orchestrator-invoke-contract-4.2.md](./xynthesis-orchestrator-invoke-contract-4.2.md) | **partial** — `reasoningEffort` shipped in 4.3.0; ai-profiles 2.1 import fixed in **4.3.1** (see CR above) |
 | `@exellix/xynthesis` 4.4 | [**xynthesis-execution-strategies-option-a.md**](./xynthesis-execution-strategies-option-a.md) | **shipped** — execution-strategy sidekick actions; ai-tasks 8.5+ uses xynthesis (FuncX path deprecated) |
 | `@x12i/ai-profiles` 2.1 | — | **shipped** — `catalogLane` required; sync `isKnownProfileOrShortcut` removed (safer — resolve at invoke) |
-| `@exellix/ai-tasks` | [ai-tasks-wrap-up-after-upstream.md](./ai-tasks-wrap-up-after-upstream.md) | **done** in 8.4 — no legacy tiers; resolve at invoke via `resolveAIProfile` |
+| `@exellix/ai-tasks` | [ai-tasks-wrap-up-after-upstream.md](../../../archived/ai-tasks/documenations/upstream-feature-requests/superseded/ai-tasks-wrap-up-after-upstream.md) | **done** in 8.4 — no legacy tiers; resolve at invoke via `resolveAIProfile` |
 
 ## FuncX generic hosting (xynthesis domain)
 
 | Package | Document | Status |
 |---------|----------|--------|
-| `@x12i/funcx` **4.4.0** | [**funcx-generic-xynthesis-hosting.md**](./funcx-generic-xynthesis-hosting.md) | **partial** — execution/research envelope + built-ins **shipped**; template-vars helper, `runGenericExecution`, sampling on `RunOptions` **open** |
-| `@x12i/funcx` | [**funcx-pre-post-sidekick-actions.md**](./funcx-pre-post-sidekick-actions.md) | **open** — `pre/synthesize`, `post/*` built-ins; execution wire-only (FR-PRE-POST-6) |
-| `@exellix/xynthesis` | `sidekickFuncxCatalogMap.ts`, `sidekickFuncxEnvelope.ts` | **shipped** — Catalox `funcx.functionId` on seeds; `XYNTHESIS_FUNCX_SIDEKICK=1` gates `run()` (not wired in gateway yet) |
-| `@exellix/ai-tasks` | `auditChecklistFuncxEnvelope.ts`, [funcx-scoping-integration-gaps.md](../funcx-scoping-integration-gaps.md) §6 | **partial** — envelopes + adapters; 8.5+ uses xynthesis actions for execution/web-scope |
+| `@x12i/funcx` **4.9.13** | [**funcx-4.9.13-open-items.md**](./funcx-4.9.13-open-items.md) | **No open FuncX items** @ 4.9.13 — consumer follow-up only |
+| `@x12i/funcx` **4.9.11** | [funcx-4.9.11-open-items.md](../../../archived/ai-tasks/documenations/upstream-feature-requests/superseded/funcx-4.9.11-open-items.md) | Superseded — historical open list |
+| `@x12i/funcx` **4.9.9** | [**funcx-4.9.9-residual-upstream-cr-fr.md**](../../../archived/ai-tasks/documenations/upstream-feature-requests/superseded/funcx-4.9.9-residual-upstream-cr-fr.md) | Superseded for filing — historical @ 4.9.9 |
+| `@x12i/funcx` | [**funcx-gap-analysis-cr-fr.md**](./funcx-gap-analysis-cr-fr.md) | Full history + closed items; §10 = 4.9.11 recheck |
+| `@x12i/funcx` **4.4.0+** | [**funcx-generic-xynthesis-hosting.md**](./funcx-generic-xynthesis-hosting.md) | **mostly shipped** @ 4.9.9 — FR-GEN-1, FR-GEN-4 closed |
+| `@x12i/funcx` | [**funcx-pre-post-sidekick-actions.md**](./funcx-pre-post-sidekick-actions.md) | **mostly shipped** @ 4.9.9 — built-ins callable; CR-FUNCX-2 + FR-GEN-11 remain |
+| `@exellix/xynthesis` | `invokeFuncxRun.ts`, `sidekickFuncxCatalogMap.ts` | **shipped** — FuncX `run()` only in gateway + execution strategy (no flag) |
+| `@exellix/ai-tasks` | `runAuditFuncxCall.ts`, `parseAuditChecklistOutput` | **shipped** — audit checklist/merge via FuncX only |
 
 ## Older / parallel tracks
 

package/documenations/upstream-feature-requests/ai-skills-orchestrator-invoke-contract-5.9.md

@@ -144,7 +144,7 @@ Still valuable; see [`ai-skills-llm-observability.md` §1](./ai-skills-llm-obser
 
 ## After this ships — ai-tasks follow-up
 
-See [`ai-tasks-wrap-up-after-upstream.md`](./ai-tasks-wrap-up-after-upstream.md):
+See [`ai-tasks-wrap-up-after-upstream.md`](../../../archived/ai-tasks/documenations/upstream-feature-requests/superseded/ai-tasks-wrap-up-after-upstream.md):
 
 - Add `reasoningEffort` to `LlmCallConfig` / tuning passthrough → `buildAiSkillsModelConfigForMain`.
 - Stop forwarding any `maxTokens` / `maxTokensCap` to `runSkill`.

package/documenations/upstream-feature-requests/funcx-4.9.13-open-items.md

@@ -0,0 +1,62 @@
+# `@x12i/funcx` — open items @ 4.9.13
+
+**Validated:** `@x12i/funcx` **4.9.13** (live OpenRouter, 2026-06-12)  
+**Filed by:** `@exellix/ai-tasks` + `@exellix/xynthesis`  
+**Evidence:** `temp/funcx-functions/` (`live-run-summary.md`, `_live-results.json`)
+
+**No open FuncX upstream items remain** from the 4.9.11 tracker. All four prior gaps are closed in the package @ 4.9.13.
+
+---
+
+## Recheck results
+
+| Suite | Result |
+|-------|--------|
+| Mock (`npm run test:mock`) | **10/10** |
+| Live batch, `transportRetries: 0` | **9/10** — `pre/synthesize` `fetch failed` @ ~30s |
+| Live `pre/synthesize` + `transportRetries: 2` | **OK** (~5s) |
+| `post/audit-checklist` output | Markdown string (`### Checks` / `### Overall feedback`) |
+| `post/audit-merge` output | Plain text string |
+
+---
+
+## Closed @ 4.9.13 (was open @ 4.9.11)
+
+| Id | Was | Fixed in |
+|----|-----|----------|
+| **CR-FUNCX-5** | Opaque `fetch failed`; flaky `pre/synthesize` | **4.9.9** `error.cause` on `NxAiApiError`; **4.9.12** embedder retry docs; **4.9.13** `RunOptions.transportRetries` |
+| **FR-GEN-3** | Output types drifted from runtime | **4.9.12** — `getFuncxOutputSchema` CI; **4.9.13** manifest `outputSchemaType: "string"` for checklist + merge |
+| **FR-GEN-9** | No FuncX parity CI | **4.9.12+** — `sidekickPromptParity.test.ts`, `@x12i/funcx/fixtures` + `promptHash`, `normalizePromptForParity` / `hashSidekickPrompt` exports |
+| **FR-GEN-11** | Thin merge prompt | **4.9.13** — `post-audit-merge` Catalox `prompt.md` includes `original_input`, rich `candidate_a/b` checks; golden envelope in fixtures |
+
+---
+
+## Consumer follow-up (mono-repo)
+
+**Shipped @ 4.9.13 cutover (2026-06):**
+
+| Task | Status |
+|------|--------|
+| `transportRetries: 2` in `invokeFuncxRun.ts` | **Done** |
+| FR-GEN-9 parity CI (`sidekickFuncxPromptParity.unit.ts` vs `@x12i/funcx/content-seed`) | **Done** — wired in `xynthesis` `npm test` |
+| FuncX-only sidekick / execution-strategy / audit (no `XYNTHESIS_FUNCX_SIDEKICK` flag) | **Done** |
+| Structured-only PRE synthesis (no markdown path) | **Done** |
+| Catalox seed from `@x12i/funcx/content-seed` | **Done** |
+| Delete disk sidekick templates under `xynthesis/templates/` | **Done** (finalize retained) |
+| Delete audit Handlebars templates (`system.md`, `user.txt`, `synthesis.md`) | **Done** (`feedback-injection.md` kept) |
+
+**Out of scope here:** live golden e2e with OpenRouter (run `xynthesis` `test:integration` when key is available).
+
+---
+
+## Evidence snippets
+
+**`transportRetries` (4.9.13 README):**
+
+```ts
+await run("pre-synthesize", envelope, { client, transportRetries: 2 });
+```
+
+**Rich merge fixture** — `@x12i/funcx/fixtures/sidekicks/post-audit-merge-envelope.json` includes `candidateA`/`candidateB` with `cycle`, `score`, `failedChecks[]`, `passedChecks[]`, `customSynthesisGuidelines`.
+
+**Output types** — `postAuditChecklistOutput = string`, `postAuditMergeOutput = string` in `@x12i/funcx/functions` `.d.ts`.