@exellix/ai-tasks 8.5.2 → 8.6.1

package/documenations/upstream-feature-requests/funcx-pre-post-sidekick-actions.md

@@ -1,301 +1,213 @@
 # `@x12i/funcx` — built-in functions for xynthesis **pre-actions** and **post-actions**
 
 **Filed by:** `@exellix/ai-tasks` + `@exellix/xynthesis`  
-**Blocks:** Catalox-only sidekick path (`runXynthesisAiAction`), ai-tasks audit/polish migration off inline templates  
-**Related:** [funcx-generic-xynthesis-hosting.md](./funcx-generic-xynthesis-hosting.md), [funcx-catalog-hosting-checklist.md](../funcx-catalog-hosting-checklist.md)
+**Baseline:** `@x12i/funcx` **4.4.0** — execution/research generics **shipped**; pre/post ids below are **not** in registry yet  
+**Blocks:** `XYNTHESIS_FUNCX_SIDEKICK=1` production use, ai-tasks audit/polish off Handlebars  
+**Related:** [funcx-generic-xynthesis-hosting.md](./funcx-generic-xynthesis-hosting.md) (4.4.0 baseline + execution FRs)
 
 ---
 
 ## 0. Problem
 
-Today xynthesis **pre-actions** (synthesis) and **post-actions** (audit, fix, pick-best, craft-final) load prompts from:
+**Shipped in FuncX 4.4.0:** `run("execution/plan" | "execution/evaluate-result" | "research/plan-questions", GenericExecutionEnvelope)` with Catalox content under `genericExecutionResearch` seed.
 
-1. On-disk `xynthesis/templates/{actionType}/`, or  
-2. Catalox catalogs `pre-actions` / `post-actions` (same template bodies, seeded from disk).
+**Not shipped:** Sidekick pre/post capabilities (`pre/synthesize`, `post/audit`, …). Today:
 
-The LLM hop uses **`FuncxInvoker.ask(systemPrompt, userPrompt)`** — a **transport-only** use of FuncX. Prompt text is assembled in xynthesis (`sidekickPromptTemplate.ts` + rendrix), **not** resolved from a FuncX **function id** via `run(functionId, envelope)`.
+1. xynthesis loads `xynthesis/templates/{actionType}/` or Catalox `pre-actions` / `post-actions` (same bodies).
+2. LLM hop = **`FuncxInvoker.ask(systemPrompt, userPrompt)`** (transport only).
+3. ai-tasks often builds its **own** audit/polish prompts (`loadAuditTemplates`, `DEFAULT_SYSTEM`).
 
-**ai-tasks** often bypasses even that path: it loads **its own** audit/polish templates and calls `executeXynthesisAction` with pre-built prompts.
-
-**Target:** Each sidekick action has a **first-class FuncX function** (like `execution/plan`). xynthesis calls `run(functionId, envelope, runOptions)`; Catalox `pre-actions` / `post-actions` items **reference** the same `functionId` for content overrides, not duplicate template hosting.
+**Target:** Register pre/post built-ins like execution family → `run(functionId, SidekickGenericEnvelope, runOptions)`; Catalox items keep `funcx.functionId` for overrides only.
 
 ---
 
-## 1. Canonical mapping (FuncX ↔ Catalox ↔ sidekick)
+## 1. Consumer mapping (shipped in xynthesis)
+
+**Source:** `xynthesis/src/catalog/sidekickFuncxCatalogMap.ts`  
+**Envelopes:** `xynthesis/src/sidekickFuncxEnvelope.ts`  
+**Flag:** `XYNTHESIS_FUNCX_SIDEKICK=1` (`isSidekickFuncxEnabled()`)
 
-| Phase | Sidekick `actionType` | Catalox catalog | Catalox item id | Proposed FuncX `functionId` | Hyphen alias |
-|-------|----------------------|-----------------|-----------------|----------------------------|--------------|
-| PRE | `synthesis` | `pre-actions` | `synthesis` | `pre/synthesize` | `pre-synthesize` |
-| PRE | `execution-plan` | `pre-actions` | `execution-plan` | `execution/plan` | `execution-plan` |
-| PRE | `plan-web-scope-questions` | `pre-actions` | `plan-web-scope-questions` | `research/plan-questions` | `research-plan-questions` |
-| POST | `audit` | `post-actions` | `audit` | `post/audit` | `post-audit` |
-| POST | `fix` | `post-actions` | `fix` | `post/fix` | `post-fix` |
-| POST | `pick-best` | `post-actions` | `pick-best` | `post/pick-best` | `post-pick-best` |
-| POST | `craft-final` | `post-actions` | `craft-final` | `post/craft-final` | `post-craft-final` |
-| POST | `execution-evaluate-result` | `post-actions` | `execution-evaluate-result` | `execution/evaluate-result` | `execution-evaluate-result` |
+| Phase | Sidekick `actionType` | Catalox catalog | Item id | FuncX `functionId` | Hyphen alias (router) | In FuncX 4.4 registry? |
+|-------|----------------------|-----------------|---------|-------------------|----------------------|-------------------------|
+| PRE | `synthesis` | `pre-actions` | `synthesis` | `pre/synthesize` | `pre-synthesize` | **No** |
+| PRE | `execution-plan` | `pre-actions` | `execution-plan` | `execution/plan` | `execution-plan` | **Yes** |
+| PRE | `plan-web-scope-questions` | `pre-actions` | `plan-web-scope-questions` | `research/plan-questions` | `research-plan-questions` | **Yes** |
+| POST | `audit` | `post-actions` | `audit` | `post/audit` | `post-audit` | **No** |
+| POST | `fix` | `post-actions` | `fix` | `post/fix` | `post-fix` | **No** |
+| POST | `pick-best` | `post-actions` | `pick-best` | `post/pick-best` | `post-pick-best` | **No** |
+| POST | `craft-final` | `post-actions` | `craft-final` | `post/craft-final` | `post-craft-final` | **No** |
+| POST | `execution-evaluate-result` | `post-actions` | `execution-evaluate-result` | `execution/evaluate-result` | `execution-evaluate-result` | **Yes** |
 
-**ai-tasks pipeline audit (weighted checks, markdown output)** — separate from sidekick JSON audit until unified:
+**ai-tasks-only POST pipeline** (not `SidekickActionType` today):
 
-| Capability | Proposed FuncX id | Catalox (optional) |
-|------------|-------------------|-------------------|
-| Checklist audit evaluator | `post/audit-checklist` | `post-actions` item `audit-checklist` |
-| Audit-cycle synthesis merge | `post/audit-merge` | `post-actions` item `audit-merge` or reuse `pre/synthesize` with `args.profile: "audit-merge"` |
+| Capability | FuncX id | Catalox item | Envelope builder | In registry? |
+|------------|----------|--------------|------------------|--------------|
+| Checklist audit | `post/audit-checklist` | `audit-checklist` | `ai-tasks/.../auditChecklistFuncxEnvelope.ts` | **No** |
+| Audit merge | `post/audit-merge` | `audit-merge` | same module | **No** |
 
-Constants and envelope builders live in xynthesis: `src/catalog/sidekickFuncxCatalogMap.ts`, `src/sidekickFuncxEnvelope.ts`.
+Catalox seed writes `funcx: { functionId, contentVersion: "0.0.0-pending-funcx" }` on every mapped sidekick item (`buildXynthesisSeedPayloads.ts`).
 
 ---
 
-## 2. Wire contract — sidekick generic envelope
+## 2. Wire contract — `SidekickGenericEnvelope`
 
-Extend (or sibling-type) **`GenericExecutionEnvelope`** for sidekick actions:
+**Defined in xynthesis** (not exported from `@x12i/funcx` 4.4.0). FuncX `run()` should accept this object as the **request** body (same as passing `GenericExecutionEnvelope` for execution ids).
 
 ```ts
 type SidekickGenericEnvelope = {
-  /** Directive: question / objective / instruction (maps to SidekickInput.task). */
-  goal: string;
-  /** Action-specific payload (see §3 per function). */
-  input: Record<string, unknown>;
-  /** Shared sidekick context. */
+  goal: string;                    // SidekickInput.task
+  input: Record<string, unknown>; // action-specific (§3)
   context: {
     templateCores: string[];
     taskType?: string;
     metadata?: Record<string, unknown>;
-    /** Optimizer-only / evaluate-only fields when applicable. */
-    result?: unknown;
+    result?: unknown;              // optimizer context when needed
     iterationIndex?: number;
+    identity?: ActivityRunContext;
   };
-  /** Template customization — NOT merged into LLM attribution tags by default. */
-  args?: {
-    templateMode?: "structured" | "markdown";
-    customGuidelines?: string;
-    synthesisPromptOverride?: string;
-    /** Checklist audit: passNumber, cycle, maxCycles, … */
-    [key: string]: unknown;
-  };
-  attribution?: GenericFuncxAttribution;
+  args?: Record<string, unknown>;  // templateMode, customGuidelines, …
+  attribution?: SidekickFuncxAttribution;
 };
 ```
 
-**Template context tokens** (FR-GEN-1 superset) — FuncX must render from envelope, matching xynthesis rendrix vars today:
-
-| Token | Envelope source |
-|-------|-----------------|
-| `task`, `question` | `goal` (both aliases for synthesis compat) |
-| `local_raw` | `input.localRaw` stringified |
-| `supporting_raw` | `input.supportingRaw` stringified |
-| `rendered_downstream_instructions` | `input.renderedInstructions` |
-| `rendered_downstream_prompt` | `input.renderedPrompt` |
-| `ai_output` | `input.aiOutput` |
-| `used_instructions` | `input.usedInstructions` |
-| `used_prompt` | `input.usedPrompt` |
-| `prior_audit_json` | `JSON.stringify(input.priorAudit)` |
-| `candidates_json` | `JSON.stringify(input.candidates)` |
-| `prior_context` | `input.priorContext` |
-| `metadata_json` | `JSON.stringify(context.metadata ?? {})` |
-| `template_cores_json` | `JSON.stringify(context.templateCores)` |
-| `goal`, `input_json`, `context_json`, `args_json` | FR-GEN-1 generic tokens (execution-strategy family) |
-
-**Ask (FuncX):** export `buildSidekickTemplateContext(envelope): Record<string, string>` alongside `buildGenericExecutionTemplateContext`.
-
----
-
-## 3. Per-function specifications
-
-### FR-PRE-1 — `pre/synthesize` (PRE synthesis)
-
-**Canonical content:** `xynthesis/templates/synthesis/system-structured.md` + `user-structured.md` (and markdown variants).
-
-**Envelope `input`:**
+**Builders (shipped):**
 
-| Field | Type | Required |
-|-------|------|----------|
-| `localRaw` | any | no |
-| `supportingRaw` | any | no |
-| `renderedInstructions` | string | no |
-| `renderedPrompt` | string | no |
+- `buildSidekickGenericEnvelope(input, options?)` — synthesis, audit, fix, pick-best, craft-final
+- `buildExecutionStrategyGenericEnvelope(req)` — planner / optimizer / web-scope (merges `strategyArgs` → `args`)
 
-**Output JSON** (matches `parseAndValidateSynthesizedPromptPayload` / `SynthesisPayload`):
+**Attribution:** `buildSidekickFuncxAttribution({ funcxFunctionId, jobId, taskId, agentId })` — align with FuncX `buildAskAttribution(implId, envelope)`.
 
-- `templateCores`, `task`, `synthesized` (`SynthesizedContext`), optional `notes`, `unknowns`, `assumptions`
+### 2.1 Template tokens (for Catalox instructions)
 
-**`args`:** `templateMode`, `customGuidelines`, `synthesisPromptOverride`, `maxItemsPerSide`, `maxItemContentChars`
+FuncX 4.4 renders instructions with `input` = **full envelope**. For parity with xynthesis rendrix disk templates, implement **FR-GEN-1** `envelopeToTemplateVariables` (see generic hosting doc).
 
-**Response format:** `json_object`
+| xynthesis rendrix (disk) | FuncX / rendrix on envelope (`input` = envelope) |
+|--------------------------|--------------------------------------------------|
+| `goal` | `input.goal` |
+| `task`, `question` | `input.goal` (aliases in sidekick templates) |
+| `local_raw`, `supporting_raw` | `input.local_raw`, `input.supporting_raw` (strings; builders stringify) |
+| `rendered_downstream_instructions` | `input.renderedInstructions` |
+| `rendered_downstream_prompt` | `input.renderedPrompt` |
+| `ai_output` | `input.aiOutput` |
+| `used_instructions`, `used_prompt` | `input.usedInstructions`, `input.usedPrompt` |
+| `prior_audit_json` | stringify `input.priorAudit` |
+| `candidates_json` | stringify `input.candidates` |
+| `metadata_json` | stringify `context.metadata` |
+| `template_cores_json` | stringify `context.templateCores` |
+| `goal`, `input_json`, `context_json`, `args_json` | execution family (§3.6) |
 
 ---
 
-### FR-POST-1 — `post/audit` (sidekick JSON audit)
-
-**Canonical content:** `xynthesis/templates/audit/*`
+## 3. Per-function specifications (to implement in FuncX)
 
-**Envelope `input`:**
+Register in router + `content-seed/functions/` (new bundle or extend `genericExecutionResearch` / dedicated `xynthesisSidekick.seed.json`). Follow **4.4.0 patterns**: `meta.json`, IO schemas, `executeFuncxFromContent`, `buildAskAttribution`, `responseFormat: json_object` where noted.
 
-| Field | Type | Required |
-|-------|------|----------|
-| `aiOutput` | string | yes |
-| `usedInstructions` | string | no |
-| `usedPrompt` | string | no |
+### FR-PRE-POST-1 — `pre/synthesize` (P0)
 
-**Output JSON** (matches `parseAuditPayload`):
+**Canonical content:** `xynthesis/templates/synthesis/system-structured.md`, `user-structured.md` (+ markdown pair).
 
-- `verdict`: `"pass" | "fail" | "mixed"`
-- `findings[]`: `{ id, label, content, severity? }`
-- plus sidekick base fields (`notes`, `unknowns`, `assumptions`, …)
+**`input`:** `localRaw`, `supportingRaw`, `renderedInstructions`, `renderedPrompt`, plus string mirrors `local_raw`, `supporting_raw`.
 
----
+**Output:** matches `parseAndValidateSynthesizedPromptPayload` / `SynthesisPayload` (`templateCores`, `task`, `synthesized`, `notes`, `unknowns`, `assumptions`).
 
-### FR-POST-2 — `post/audit-checklist` (ai-tasks weighted audit)
+**`args`:** `templateMode`, `customGuidelines`, `synthesisPromptOverride`, `maxItemsPerSide`, `maxItemContentChars`.
 
-**Canonical content:** migrate from ai-tasks `templates/post-steps/audit/` (Handlebars → FuncX templates with same variables).
+### FR-PRE-POST-2 — `post/audit-checklist` + `post/audit-merge` (P1)
 
-**Envelope `input`:**
+**Checklist** — migrate ai-tasks `templates/post-steps/audit/`:
 
-| Field | Type | Required |
-|-------|------|----------|
-| `candidateOutput` | string | yes |
-| `originalInput` | string | yes |
-| `promptContext` | string | no |
-| `mustChecks` | `{ check, weight }[]` | yes |
-| `shouldChecks` | `{ check, weight }[]` | yes |
-| `previousFeedback` | string | no |
+**`input`:** `candidateOutput`, `originalInput`, `promptContext`, `mustChecks`, `shouldChecks`, `previousFeedback`, `previousCycle` (see `buildAuditChecklistFuncxEnvelope`).
 
-**Output:** structured markdown (`### Checks`, `### Overall feedback`) — parsed by ai-tasks `parseAuditOutputFromMarkdown` until FuncX ships JSON schema variant.
+**Output:** markdown `### Checks` / `### Overall feedback` until JSON schema exists.
 
-**`args`:** `customAuditGuidelines`, `passNumber`, `cycle`, `maxCycles`
+**`args`:** `customAuditGuidelines`, `passNumber`, `cycle`, `maxCycles`.
 
----
+**Merge** — `buildAuditMergeFuncxEnvelope`: `input.candidateA`, `input.candidateB`, `context.task`.
 
-### FR-POST-3 — `post/fix` (polish / fix)
+### FR-PRE-POST-3 — `post/audit` (P0)
 
-**Canonical content:** `xynthesis/templates/fix/*`
+**Content:** `xynthesis/templates/audit/*`. **`input`:** `aiOutput`, `usedInstructions?`, `usedPrompt?`. **Output:** `parseAuditPayload` shape (`verdict`, `findings[]`, …).
 
-**Envelope `input`:** `aiOutput`, `usedInstructions?`, `usedPrompt?`, `priorAudit?` (AuditPayload)
+### FR-PRE-POST-4 — `post/fix` (P0)
 
-**Output JSON:** `fixes[]` with `{ id, label, corrected, rationale? }` per `parseFixPayload`
+**Note:** sidekick action is **`fix`** (polish), not `post/polish`. **Content:** `xynthesis/templates/fix/*`. **Output:** `parseFixPayload` (`fixes[]`).
 
----
+### FR-PRE-POST-5 — `post/pick-best`, `post/craft-final` (P0)
 
-### FR-POST-4 — `post/pick-best`
+Per `parsePickBestPayload` / `parseCraftFinalPayload` and existing disk templates.
 
-**Envelope `input`:** `candidates[]` (`{ id, content }`), `usedInstructions?`
+### FR-PRE-POST-6 — Execution ids (P0 — wire only)
 
-**Output JSON:** `selected`, `rankings[]` per `parsePickBestPayload`
-
----
+**Already in FuncX 4.4.0.** Remaining work:
 
-### FR-POST-5 — `post/craft-final`
+- [ ] xynthesis: stop `buildExecutionStrategyPrompts` + `ask` when `XYNTHESIS_FUNCX_SIDEKICK=1`
+- [ ] Call `run(resolveSidekickFuncxFunctionId(action), buildExecutionStrategyGenericEnvelope(req), runOptions)`
+- [ ] Catalox `contentVersion` ≥ seed version after parity (FR-GEN-9)
 
-**Envelope `input`:** `aiOutput`, `usedInstructions?`, `usedPrompt?`, `priorContext?`
-
-**Output JSON:** per `parseCraftFinalPayload` (`finalOutput`, `rationale?`, …)
+No new FuncX function definitions required if `fx/execution-plan/*` matches xynthesis templates.
 
 ---
 
-### FR-PRE-POST-6 — Execution-strategy ids (already exist — wire only)
-
-**No new FuncX content required** if seeds match xynthesis templates (FR-GEN-9). xynthesis must **stop** re-rendering `executionStrategyPromptTemplate.ts` and call:
-
-- `run("execution/plan", envelope)` 
-- `run("execution/evaluate-result", envelope)` 
-- `run("research/plan-questions", envelope)`
-
-Catalox `pre-actions` / `post-actions` items for these actions gain `funcx.functionId` pointing at built-ins; templates in Catalox become **overrides** only.
+## 4. Catalox catalog shape (consumer — shipped)
 
----
-
-## 4. Catalox catalog shape (consumer-side, after FuncX ships)
-
-Each `XynthesisActionItem` in `pre-actions` / `post-actions` should include:
-
-```json
-{
-  "actionType": "audit",
-  "funcx": {
-    "functionId": "post/audit",
-    "contentVersion": "1.0.0"
-  },
-  "templates": { "structured": { "system": "...", "user": "..." } },
-  "actionOutputDefaults": { ... },
-  "outputIntent": { ... }
-}
+```ts
+// XynthesisActionItem (cataloxXynthesisBootstrap.ts)
+funcx?: {
+  functionId: string;      // slash form from sidekickFuncxCatalogMap
+  contentVersion?: string;   // "0.0.0-pending-funcx" until FuncX seed synced
+};
 ```
 
-**Resolution order (xynthesis):**
+**Resolution order (target):**
 
-1. If `XYNTHESIS_FUNCX_SIDEKICK=1` (new flag): `run(item.funcx.functionId, buildSidekickGenericEnvelope(input), runOptions)`.
-2. Else if `XYNTHESIS_CATALOX_ACTIONS=1`: Catalox templates + rendrix (today).
-3. Else: disk templates (dev/tests).
+1. `XYNTHESIS_FUNCX_SIDEKICK=1` → `run(item.funcx.functionId, envelope, runOptions)` — prompts from FuncX/Catalox only.
+2. `XYNTHESIS_CATALOX_ACTIONS=1` → Catalox templates + rendrix (**today**).
+3. Else → disk templates (dev/tests).
 
-When (1) is active, Catalox `templates` are **ignored for prompt text** unless FuncX catalog points at Catalox-hosted function content (FuncX content-seed parity).
+When (1) is on, Catalox `templates` are **fallback overrides** only if FuncX resolver supports content overrides (same as other `fx/*` functions).
 
 ---
 
-## 5. FuncX package asks (summary tracker)
+## 5. FuncX package tracker (pre/post only)
 
-| FR id | Topic | Priority |
-|-------|--------|----------|
-| **FR-PRE-POST-1** | Register **`pre/synthesize`**, **`post/audit`**, **`post/fix`**, **`post/pick-best`**, **`post/craft-final`** built-ins | **P0** |
-| **FR-PRE-POST-2** | Register **`post/audit-checklist`**, **`post/audit-merge`** for ai-tasks POST pipeline | **P1** |
-| **FR-PRE-POST-3** | **`buildSidekickTemplateContext(envelope)`** export | **P0** |
-| **FR-PRE-POST-4** | Output JSON schemas = xynthesis parser contracts (§3) | **P0** |
-| **FR-PRE-POST-5** | `runSidekickGeneric(opts)` or extend FR-GEN-5 `runGenericExecution` for sidekick envelope | **P1** |
-| **FR-PRE-POST-6** | Content-seed from `xynthesis/templates/{synthesis,audit,fix,...}` + CI drift vs Catalox | **P1** |
-| **FR-PRE-POST-7** | Wire existing **`execution/*`** + **`research/plan-questions`** as canonical for pre/post catalog items (deprecate xynthesis duplicate render path) | **P0** |
+Depends on [funcx-generic-xynthesis-hosting.md](./funcx-generic-xynthesis-hosting.md) **FR-GEN-1, FR-GEN-4, FR-GEN-5** for shared template + `run()` ergonomics.
 
-Depends on [funcx-generic-xynthesis-hosting.md](./funcx-generic-xynthesis-hosting.md) **FR-GEN-1–5** for `RunOptions`, usage return shape, and generic template context.
+| FR id | Topic | Status @ 4.4.0 |
+|-------|--------|----------------|
+| **FR-PRE-POST-1** | `pre/synthesize` built-in + seed | **Open** |
+| **FR-PRE-POST-2** | `post/audit-checklist`, `post/audit-merge` | **Open** (envelope **shipped** in ai-tasks) |
+| **FR-PRE-POST-3** | `post/audit` | **Open** |
+| **FR-PRE-POST-4** | `post/fix` | **Open** |
+| **FR-PRE-POST-5** | `post/pick-best`, `post/craft-final` | **Open** |
+| **FR-PRE-POST-6** | Wire execution/* + research/plan-questions from xynthesis | **Open** (built-ins **shipped**) |
+| **FR-PRE-POST-7** | `buildSidekickTemplateContext` or FR-GEN-1 covering sidekick | **Open** |
+| **FR-PRE-POST-8** | Export `SidekickGenericEnvelope` type from `@x12i/funcx/functions` (optional) | **Open** |
 
 ---
 
-## 6. Acceptance criteria (end-to-end)
+## 6. Acceptance criteria
 
-- [ ] With `XYNTHESIS_FUNCX_SIDEKICK=1`, `runSidekickGatewayCall` never calls `loadSidekickTemplates` for registered actions; prompts come from FuncX `run()`.
-- [ ] Catalox `pre-actions` / `post-actions` items include `funcx.functionId`; validation fails if missing when FuncX mode enabled.
-- [ ] ai-tasks `runAuditPostStep` builds `post/audit-checklist` envelope — no `loadAuditTemplates` / `DEFAULT_SYSTEM`.
-- [ ] ai-tasks PRE structured synthesis uses `pre/synthesize` via xynthesis (not local template load + `executeXynthesisAction`).
-- [ ] Golden fixture: same envelope → FuncX rendered prompts hash-equal to current xynthesis rendrix output (FR-GEN-9 parity).
-- [ ] `sidekickAction` on Activix / `InvokeAttemptSummary` records FuncX `functionId`, not only transport `ask`.
+- [ ] `XYNTHESIS_FUNCX_SIDEKICK=1` → `runSidekickGatewayCall` / `runExecutionPlan` use `run()`, not `loadSidekickTemplates`.
+- [ ] Catalox items keep `funcx.functionId`; validator fails if missing when FuncX mode required.
+- [ ] ai-tasks `runAuditPostStep` uses `post/audit-checklist` envelope (no `loadAuditTemplates` / `DEFAULT_SYSTEM`).
+- [ ] Golden: FR-GEN-1 normalized prompt hash matches current xynthesis rendrix output.
+- [ ] `InvokeAttemptSummary` / Activix record FuncX `functionId`, not only transport `xynthesis/synthesis` on `ask`.
 
 ---
 
-## 7. Convergence (mermaid)
-
-```mermaid
-flowchart TB
-  subgraph ai_tasks
-    AT[buildSidekick envelope data]
-  end
-  subgraph xynthesis
-    XY[runSidekickGatewayCall / runXynthesisAiAction]
-    MAP[sidekickFuncxCatalogMap]
-    ENV[buildSidekickGenericEnvelope]
-  end
-  subgraph funcx
-    RUN["run(functionId, envelope)"]
-    TPL[Catalox / content-seed templates]
-  end
-  subgraph catalox
-    PRE[pre-actions catalog]
-    POST[post-actions catalog]
-  end
-  AT --> XY
-  XY --> MAP
-  MAP --> ENV
-  ENV --> RUN
-  RUN --> TPL
-  PRE -.->|funcx.functionId + optional override| MAP
-  POST -.->|funcx.functionId + optional override| MAP
-```
+## 7. Non-goals
 
----
-
-## 8. Non-goals
-
-- ai-skills MAIN gateway (`instructions` / `prompt` on `RunTaskRequest`).
-- Moving template **cores** (`{{core:analysis}}`) into FuncX — still rendrix/ai-skills concern; synthesis **input** may include pre-rendered downstream blocks only.
+- ai-skills MAIN gateway.
+- FuncX ownership of template **cores** — cores stay rendrix; synthesis `input` may include pre-rendered downstream text only.
 
 ---
 
-## 9. Version note
+## 8. Version note
+
+| Package | Version |
+|---------|---------|
+| `@x12i/funcx` | **4.4.0** — implement FR-PRE-POST-1..5 in **4.5.x** (suggested) |
+| `@exellix/xynthesis` | **4.4.3** — map + envelopes shipped; gateway wiring pending |
+| `@exellix/ai-tasks` | **8.5.2** — checklist envelopes shipped |
 
-- **@x12i/funcx** ≥ **4.4.0** (xynthesis dep): `run`, `getRunJsonResult`, `GenericExecutionEnvelope`, `Client.ask`.
-- New built-ins require FuncX release + content-seed; xynthesis gates behind **`XYNTHESIS_FUNCX_SIDEKICK=1`** until parity tests pass.
+Implement **pre/post content** in FuncX *after* reading §1 of [funcx-generic-xynthesis-hosting.md](./funcx-generic-xynthesis-hosting.md) (do not re-invent envelope / attribution / `getRunJsonResult`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/ai-tasks",
-  "version": "8.5.2",
+  "version": "8.6.1",
   "description": "Task orchestration for the Exellix stack: runTask() with local handlers or LLM-backed execution, task-scoped memory/context enrichment, and executor dispatch via @exellix/ai-skills. ERC-compliant.",
   "type": "module",
   "main": "dist/index.js",
@@ -60,7 +60,7 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@exellix/ai-skills": "^6.0.0",
+    "@exellix/ai-skills": "^6.1.0",
     "@exellix/memorix-narrix-adapter": "^2.0.0",
     "@exellix/narrix-adapter-chat": "^2.0.0",
     "@exellix/narrix-adapter-docs": "^2.0.0",
@@ -72,7 +72,7 @@
     "@exellix/narrix-ingest": "^2.0.0",
     "@exellix/narrix-runner": "^2.0.0",
     "@exellix/narrix-web-scoper": "^2.0.0",
-    "@exellix/xynthesis": "^4.4.3",
+    "@exellix/xynthesis": "^4.4.5",
     "@x12i/activix": "^8.5.0",
     "@x12i/ai-profiles": "^2.1.0",
     "@x12i/catalox": "^5.1.3",