@codedrifters/configulator 0.0.351 → 0.0.353

package/lib/index.mjs

@@ -11863,7 +11863,7 @@ function buildMeetingAnalystSubAgent(tier) {
       "| `planning` | Sprint/plan updates, task issues, requirement drafts | Extract every task assignment. Phase 4 updates the active sprint-plan doc directly and creates one issue per assigned task. |",
       "| `review` | Retro notes, follow-up issues, status updates, requirement revisions | Mark completed tasks in the active sprint-plan doc. Capture retrospective learnings inside the meeting notes \u2014 do not spawn a separate retro document. |",
       "| `brainstorm` | Future-feature candidates, research topics, very few Firm decisions | Lower the bar for Open Questions. Do **not** create requirement or ADR issues from brainstorm output unless the item is explicitly marked **Firm**. Prefer research/discovery issues for promising ideas. |",
-      "| `standup` | Action items, blockers, status updates | Do not produce requirement, ADR, or BDR drafts. Phase 3 (Draft) is almost always skipped. Focus on action-item issues and sprint-plan status updates. |",
+      "| `standup` | Action items, blockers, status updates | Do not produce requirement, ADR, or BDR drafts. Phase 3 (Draft) is almost always skipped. Capture action items in the notes `## Action Items` table; file issues only for agent-workable doc deliverables (per the **Action-item filing policy**) and apply sprint-plan status updates. |",
       "| `external` | Customer/competitive intel, people/company profiles, lead capture | Default every attendee outside the team into **People of Interest**. Default every organization mentioned into **Companies of Interest** (signal threshold still applies). Capture stated customer pain points as candidate **BR** (business requirements), not FR. |",
       "| `other` | General meeting extraction | Apply the default workflow with no type-specific overrides. |",
       "",
@@ -11925,6 +11925,61 @@ function buildMeetingAnalystSubAgent(tier) {
       "",
       "---",
       "",
+      "## Action-item filing policy",
+      "",
+      "Not every action item should become a GitHub issue. The pipeline",
+      "can only ever close issues whose deliverable an automated agent",
+      "(or this repo's existing channels) can produce. Filing an issue",
+      "for a task only a human can do \u2014 in the real world or in a system",
+      "this pipeline cannot touch \u2014 creates queue noise that no worker or",
+      "orchestrator can ever resolve. Apply the **agent-workability",
+      "test** below in phases 1, 3, and 4.",
+      "",
+      "### Agent-workability test",
+      "",
+      "An action item is **agent-workable** only when completing it",
+      "produces a documentation deliverable an automated agent can author",
+      "in this repo's docs tree \u2014 a requirement document, an ADR, a docs",
+      "page, a BCM capability model, a research note, or a roadmap /",
+      "product-doc update. Route agent-workable items through their",
+      "**dedicated downstream channel** (`req:write`, `docs:write`,",
+      "`bcm:*`, `research:scope`, roadmap/product-doc follow-up). Never",
+      "file them as a generic `action-item` / `type:chore` issue.",
+      "",
+      "An action item is **human-owned** when it requires a person to act",
+      "in the real world or in a system this pipeline cannot reach.",
+      "Typical cues:",
+      "",
+      '- **send / email / schedule / invite / call** \u2014 e.g. "send out',
+      `  company invoices", "invite X to next week's call".`,
+      '- **install / configure / provision / set up** \u2014 e.g. "install and',
+      '  configure Claude", "get codebase read access".',
+      "- **decide / approve / choose / prioritise** (a human judgement",
+      "  call, not a documented decision record).",
+      '- **communicate / notify / give a heads-up** \u2014 e.g. "give Dr. Y a',
+      '  heads-up".',
+      "- **get / request access or credentials**, **pay / invoice**.",
+      "- **build or change code in another repo**, **design in an",
+      "  external tool** (Figma, etc.).",
+      "",
+      "Record human-owned items **only** in the notes `## Action Items`",
+      "table (who / what / when) \u2014 that table is the **system of record**",
+      "for human follow-ups. Do **not** file a GitHub issue for them.",
+      "",
+      "When an item is ambiguous, default to **human-owned**",
+      "(notes-only): a missed issue is cheaper than queue noise the",
+      "pipeline can never close.",
+      "",
+      "**Consumer tuning.** When the project supplies",
+      "`AgentConfigOptions.meetings.actionItemFiling`, an",
+      "**Action-item filing policy** subsection is rendered into the",
+      "meetings taxonomy with any extra human-owned / agent-workable cues",
+      "and a note when the split is disabled. Apply those overrides on",
+      "top of the built-in cues above; if the split is disabled, fall",
+      "back to filing a follow-up issue for every non-draft action item.",
+      "",
+      "---",
+      "",
       ...PROJECT_CONTEXT_MAINTAINER_SECTION,
       "## Traceability",
       "",
@@ -11956,7 +12011,7 @@ function buildMeetingAnalystSubAgent(tier) {
       "",
       "   | Artifact | Type | Issue/Path |",
       "   |----------|------|------------|",
-      "   | <title> | requirement / ADR / action-item / profile | #<N> or <path> |",
+      "   | <title> | requirement / ADR / docs / profile / research | #<N> or <path> |",
       "   ```",
       "",
       "2. **Update the meeting notes** with a similar `## Related Issues` section",
@@ -12021,7 +12076,7 @@ function buildMeetingAnalystSubAgent(tier) {
       `   | **Decisions** | "We decided...", "Let's go with...", explicit choices |`,
       '   | **Requirements** | Feature descriptions, acceptance criteria, "it should..." |',
       "   | **Technology discussions** | Platform comparisons, architecture options, tool evaluations |",
-      '   | **Action items** | "[Person] will...", "Next step is...", assigned tasks |',
+      '   | **Action items** | "[Person] will...", "Next step is...", assigned tasks. Tag each with its **disposition** (`agent-workable` vs `human-owned`) per the **Action-item filing policy**. |',
       '   | **Open questions** | "We need to figure out...", unresolved debates |',
       "   | **People of interest** | Industry contacts, domain experts mentioned |",
       "   | **Companies of interest** | Competitors, vendors, partners discussed |",
@@ -12036,7 +12091,10 @@ function buildMeetingAnalystSubAgent(tier) {
       "   - Decisions Made (with category and confidence: Firm / Tentative / Needs confirmation)",
       "   - Requirements Identified (with category and priority estimate)",
       "   - Technology Discussions (with status: Decided / Leaning toward / Open)",
-      "   - Action Items (with assignee and due date if stated)",
+      "   - Action Items (with assignee and due date if stated, and a",
+      "     **disposition** tag \u2014 `agent-workable` or `human-owned` \u2014 per",
+      "     the **Action-item filing policy** so Phase 4 can route each",
+      "     item without re-classifying it)",
       "   - Open Questions",
       "   - People of Interest (with context and whether a profile exists)",
       "   - Companies of Interest (with type and context)",
@@ -12166,7 +12224,11 @@ function buildMeetingAnalystSubAgent(tier) {
       "   - Agenda / topics covered",
       "   - Key Discussion Points (organized by topic)",
       "   - Decisions (numbered, with rationale)",
-      "   - Action Items (table: who, what, when)",
+      "   - Action Items (table: who, what, when). This table is the",
+      "     **system of record for human follow-ups** \u2014 human-owned",
+      "     action items live here and are never filed as GitHub issues",
+      "     (see the **Action-item filing policy**). Capture every",
+      "     action item here regardless of disposition.",
       "   - Open Questions",
       "   - Follow-up items",
       "4. **Plan the `notes/` tree index update \u2014 do not commit it",
@@ -12214,6 +12276,11 @@ function buildMeetingAnalystSubAgent(tier) {
       "This phase only exists if the extraction identified requirements, architectural",
       "decisions, or strategy changes. If this issue exists, execute it.",
       "",
+      "Draft proposals only for **agent-workable** deliverables (per the",
+      "**Action-item filing policy**). Action items tagged `human-owned`",
+      "in the extraction are not drafted here \u2014 they stay in the notes",
+      "`## Action Items` table and produce no follow-up issue.",
+      "",
       "### Steps",
       "",
       "1. Read the extraction file from Phase 1 at",
@@ -12253,8 +12320,27 @@ function buildMeetingAnalystSubAgent(tier) {
       "   gated by areas.",
       "3. Create ADR issues if technology decisions need formal records.",
       "   Include a `## Traceability` section in each. Not gated by areas.",
-      "4. Create action item issues for tasks that are not document-related.",
-      "   Include a `## Traceability` section in each. Not gated by areas.",
+      "4. **Route action items per the Action-item filing policy \u2014 do",
+      "   not file a generic `action-item` issue per task.** Read each",
+      "   action item's `disposition` tag from the extraction (re-apply",
+      "   the **agent-workability test** if the tag is missing):",
+      "   - **Agent-workable** (yields a doc deliverable an agent can",
+      "     author): file it through its **dedicated downstream channel**",
+      "     \u2014 a `req:write` issue for a requirement, a `docs:write` issue",
+      "     for a docs page, `bcm:*` for a capability model, a",
+      "     `research:scope` issue for a research note, or a roadmap /",
+      "     product-doc follow-up. Use the matching template from the",
+      "     issue-templates page; include a `## Traceability` section.",
+      "     Issue creation is not gated by areas.",
+      "   - **Human-owned** (send/schedule/install/decide/communicate/",
+      "     get-access/build-elsewhere): record it **only** in the notes",
+      "     `## Action Items` table (step 8 already carries the table",
+      "     forward). **File no GitHub issue.** When ambiguous, treat the",
+      "     item as human-owned.",
+      "   If the project disabled the split via",
+      "   `meetings.actionItemFiling.enabled: false`, fall back to filing",
+      "   a follow-up issue for every action item not already covered by",
+      "   a Phase 3 draft.",
       "5. Cross-reference the meeting in any existing documents that were",
       "   discussed **and that live under an in-scope `docRoot`**. For",
       "   discussed documents under an out-of-scope `docRoot`, open a",
@@ -12291,7 +12377,10 @@ function buildMeetingAnalystSubAgent(tier) {
       "- Use `gh` CLI for all GitHub operations",
       "- Apply the appropriate `meeting:*` phase label to each phase issue",
       "- Use `type:docs` for documentation-producing issues, `type:chore` for",
-      "  maintenance/organizational tasks",
+      "  maintenance/organizational tasks the pipeline can action",
+      "- Do **not** file issues for human-owned action items \u2014 per the",
+      "  **Action-item filing policy** they live only in the notes",
+      "  `## Action Items` table",
       "- Use `status:` labels to track progress (`status:ready`, `status:in-progress`, `status:done`)",
       "- Reference the source meeting transcript in all created issues",
       "- Link phase issues with `Depends on: #N` to enforce ordering",
@@ -12362,7 +12451,10 @@ var processMeetingSkill = {
     "1. Resolve the basename, partition, and any sibling files using",
     "   the **Basename-pairing algorithm** above",
     "2. Execute Phase 1 (Extract) \u2014 categorize the available content into",
-    "   decisions, requirements, action items, open questions, and more",
+    "   decisions, requirements, action items, open questions, and more.",
+    "   Tag each action item's disposition (`agent-workable` vs",
+    "   `human-owned`) per the agent's **Action-item filing policy** so",
+    "   Phase 4 keeps human-owned tasks out of the issue queue",
     "3. Write the extraction to",
     "   `<meetingsRoot>/insights/{type}/<basename>.md`",
     "4. Create downstream phase issues using `gh issue create`:",
@@ -12432,7 +12524,18 @@ function buildMeetingAnalysisBundle(tier = AGENT_MODEL.BALANCED) {
           "direct edits to the doc-root sub-folders declared in the project's",
           "**Area \u2192 doc-root mapping** table. When both fields are absent",
           "the pipeline falls back to the default workflow (kind `other`,",
-          "no area gating)."
+          "no area gating).",
+          "",
+          "Phase 4 applies an **agent-workability split** to action items:",
+          "items that yield a documentation deliverable an agent can author",
+          "are filed through their dedicated downstream channel",
+          "(`req:write`, `docs:write`, `bcm:*`, `research:scope`, roadmap",
+          "follow-up); human-owned tasks (send / schedule / install /",
+          "decide / communicate / get-access / build-elsewhere) are",
+          "recorded **only** in the notes `## Action Items` table, which is",
+          "the **system of record for human follow-ups** \u2014 no GitHub issue",
+          "is filed for them. Consumers tune or disable the split via",
+          "`AgentConfigOptions.meetings.actionItemFiling`."
         ].join("\n"),
         platforms: {
           cursor: { exclude: true }
@@ -13577,6 +13680,9 @@ var DEFAULT_BUNDLE_OVERRIDES = {
   "regulatory:research": {
     acceptanceCriteria: { smallMax: 3, mediumMax: 10 }
   },
+  "standards:research": {
+    acceptanceCriteria: { smallMax: 3, mediumMax: 10 }
+  },
   "software:map": {
     acceptanceCriteria: { smallMax: 3, mediumMax: 12 },
     sources: { smallMax: 2, mediumMax: 15 }
@@ -13790,6 +13896,31 @@ function renderScopeGateSection(gate, excludeBundles = []) {
       "alphabetical order on the label name** \u2014 first-wins, deterministic."
     );
   }
+  lines.push(
+    "",
+    "### Reconfiguring the thresholds",
+    "",
+    "Every threshold above is configurable per repo \u2014 the global",
+    "`acceptance-criteria` / `sources` classification bands and each",
+    "per-phase-label override. Retune them in the project's",
+    "configulator config so the gate fits this repo's issue shapes:",
+    "",
+    "- `AgentConfigOptions.scopeGate.acceptanceCriteria` /",
+    "  `AgentConfigOptions.scopeGate.sources` \u2014 the global",
+    "  `smallMax` / `mediumMax` bands applied to every issue.",
+    "- `AgentConfigOptions.scopeGate.bundleOverrides.<phase-label>` \u2014",
+    "  a per-phase-label override for **any** phase label, not just",
+    "  the ones shipped above. The map deep-merges with the shipped",
+    "  defaults (consumer-wins-per-key): add a key to raise a new",
+    "  label's AC / sources ceiling, set an existing key to replace a",
+    "  shipped default, or set a key to `undefined` to drop a shipped",
+    "  default and classify that label against the global bands.",
+    "",
+    "Each override entry's `acceptanceCriteria` and `sources` axes are",
+    "independent \u2014 override one and the other falls through to the",
+    "global band. Malformed thresholds (negative, non-integer, or",
+    "`mediumMax <= smallMax`) fail the build at synth time."
+  );
   lines.push(
     "",
     "### Decomposition-proposal template",
@@ -17656,7 +17787,11 @@ var prReviewerSubAgent = {
     "",
     "The PR is **eligible** only when **all** of the following hold:",
     "",
-    '1. `mergeable == "MERGEABLE"` (no merge conflicts).',
+    '1. `mergeable == "MERGEABLE"` (no merge conflicts). A',
+    '   `mergeable == "CONFLICTING"` PR is **not** an automatic',
+    "   disqualification \u2014 see the **already-`CONFLICTING` handling**",
+    "   below, which may auto-correct it via delegation before falling",
+    "   back to a hard reject.",
     "2. No **failing** required checks in `statusCheckRollup` \u2014 CI must be",
     "   green or still pending. Any `FAILURE`, `TIMED_OUT`, `CANCELLED`, or",
     "   `ERROR` conclusion on a required check disqualifies the PR. If the",
@@ -17668,8 +17803,9 @@ var prReviewerSubAgent = {
     "3. The PR body contains a linked issue via one of the closing keywords:",
     "   `Closes #N`, `Fixes #N`, or `Resolves #N` (case-insensitive).",
     "",
-    "If **any** check fails, post a short comment explaining the reason and",
-    "stop. Do not proceed to full review.",
+    "If the **CI** check (2) or the **linked-issue** check (3) fails, post",
+    "a short comment explaining the reason and stop. Do not proceed to",
+    "full review.",
     "",
     "```bash",
     "gh pr comment <pr-number> --body '<reason>'",
@@ -17677,10 +17813,50 @@ var prReviewerSubAgent = {
     "",
     "Typical reasons:",
     "",
-    "- `Not reviewable: merge conflicts \u2014 please rebase onto the default branch.`",
     "- `Not reviewable: required CI check <name> is failing.`",
     "- `Not reviewable: PR body is missing a linked issue (Closes #N / Fixes #N / Resolves #N).`",
     "",
+    "### Already-`CONFLICTING` handling (auto-correct, then reject)",
+    "",
+    'When the merge check (1) reports `mergeable == "CONFLICTING"`, do',
+    "**not** unconditionally reject. A bot-authored PR that is already",
+    "conflicting when the orchestrator finds it is exactly the case the",
+    "conflict-resolution delegation flow exists to auto-correct \u2014 there",
+    "is no reason to make a human rebase it by hand when `issue-worker`",
+    "can. Before rejecting, evaluate checks (2) and (3) above first: a",
+    "`CONFLICTING` PR that **also** has failing CI or no linked issue is",
+    "rejected for that reason via the comment-and-stop path above, since",
+    "the delegation cannot succeed without a linked issue and green-able",
+    "CI anyway.",
+    "",
+    "Otherwise, hand off to the **Shared Procedure: Conflict-Resolution",
+    "Delegation** section. It evaluates the guards (auto-merge mode, the",
+    "delegation invocation guard, a free `review:fixing` lease, no",
+    "generated / projen / lockfile conflicts), classifies the conflicting",
+    "files, and either delegates a rebase to `issue-worker` or falls",
+    "through to its own fallback. Invoke it with this entry point's",
+    "parameters:",
+    "",
+    "- **Entry point:** `already-conflicting`. There is no failed",
+    "  `gh pr update-branch` to read conflicting paths from \u2014 identify",
+    "  the conflicting files from the PR's merge state as documented in",
+    "  the shared procedure's entry-point step (a local rebase attempt",
+    "  whose `<<<<<<<` / `=======` / `>>>>>>>` markers name the",
+    "  conflicting files). The guards and classification are identical to",
+    "  the Phase 4 entry point.",
+    "- **On the procedure returning `delegated`:** a rebase has been",
+    "  delegated to `issue-worker`; stop this pass. A human re-invokes",
+    "  the reviewer once the worker pushes the rebased branch.",
+    "- **On the procedure returning `skipped` (a guard denied delegation",
+    "  or the guards failed):** fall back to the original hard reject \u2014",
+    "  post the merge-conflict rejection comment and stop. Use this",
+    "  comment **only** in the skipped case, never before the shared",
+    "  procedure has had its chance to auto-correct:",
+    "",
+    "```bash",
+    "gh pr comment <pr-number> --body 'Not reviewable: merge conflicts \u2014 please rebase onto the default branch.'",
+    "```",
+    "",
     "## Phase 2: Gather Context",
     "",
     "```bash",
@@ -18382,37 +18558,215 @@ var prReviewerSubAgent = {
     "##### Conflict-resolution delegation (BEHIND + conflicts)",
     "",
     "When `gh pr update-branch <pr-number>` fails because the merge would",
-    "produce conflicts, the reviewer **may** delegate conflict resolution to",
-    "`issue-worker` via the existing feedback-mode delegation contract (the",
-    "same path Phase 4's in-scope-fix delegation uses). The reviewer never",
-    "hand-resolves conflicts itself \u2014 branch mutations always belong to",
-    "`issue-worker`.",
+    "produce conflicts, hand off to the **Shared Procedure:",
+    "Conflict-Resolution Delegation** section below. That procedure owns",
+    "the guards, the `shared-index` vs `generic` classification, the two",
+    "typed recipes, and the fallback \u2014 defined once and shared with the",
+    "Phase 1.5 already-`CONFLICTING` entry point. Invoke it with this",
+    "entry point's parameters:",
+    "",
+    "- **Entry point:** `update-branch-conflict`. The set of conflicting",
+    "  files is the list reported by the failed `gh pr update-branch`",
+    "  (cross-referenced with `gh pr view <pr-number> --json files`).",
+    "- **On the procedure returning `delegated`:** record",
+    "  `Branch updated: delegated (PR #<n>)` for the per-PR report.",
+    "- **On the procedure returning `skipped` (a guard denied delegation",
+    "  or the guards failed):** the procedure has already posted the",
+    "  fallback comment and recorded",
+    "  `Branch updated: failed (conflicts; <short reason>)`. Stop.",
+    "",
+    "#### Mode `human-required`",
+    "",
+    "Do **not** run `gh pr merge --auto`. Instead, hand the PR off to a",
+    "human reviewer:",
+    "",
+    "1. Apply the `review:awaiting-human` label so the PR is discoverable",
+    "   in the human-review queue:",
+    "",
+    "   ```bash",
+    "   gh pr edit <pr-number> --add-label 'review:awaiting-human'",
+    "   ```",
+    "",
+    "2. **If `matched_rule == 6`** (size threshold was the sole trigger),",
+    "   run the `Update the branch when `mergeStateStatus` is `BEHIND``",
+    "   step from the `Mode auto-merge` branch above before exiting. The",
+    "   eligibility gate documented in that sub-section explicitly permits",
+    "   `gh pr update-branch` on size-only human-required PRs so the bot",
+    "   keeps the branch fresh against the default branch while the human",
+    "   reviews. Skip this sub-step for `matched_rule` in 2\u20135 \u2014 the gate",
+    "   denies `update-branch` there and the human owns branch-lifecycle.",
+    "",
+    "3. Exit cleanly after the acceptance-criteria check completes and any",
+    "   summary comment the reviewer posts. Proceed to Phase 5 only if a",
+    "   merge occurred \u2014 in `human-required` mode the reviewer stops at",
+    "   the hand-off and does not poll for merge.",
+    "",
+    "The reason captured in Phase 2.75 should be included in any summary",
+    "comment so maintainers know why human review was required (path hit,",
+    "issue type, size threshold, label, or default).",
+    "",
+    "### If any criterion is missing, partial, or CI is failing",
+    "",
+    "Post a plain comment (not a formal review block) with grouped findings:",
+    "",
+    "```bash",
+    "gh pr comment <pr-number> --body '<grouped findings>'",
+    "```",
+    "",
+    "Group findings by severity (**Blocking** / **Suggested** / **Nitpick**).",
+    "For each blocking finding, cite the unmet acceptance criterion and the",
+    "file or function the gap lives in. Do **not** merge, and do **not** push",
+    "any commits to the PR's branch.",
+    "",
+    "Rationale for using a plain comment rather than `gh pr review",
+    "--request-changes`: it is lighter-weight, doesn't require the author to",
+    "dismiss a formal review, and composes cleanly with the multi-PR loop.",
+    "",
+    "## Phase 4.5: Update Sticky Summary",
+    "",
+    "On **every pass**, create or update a single **`## Reviewer notes`**",
+    "comment on the PR. This sticky comment is the human-facing single",
+    "source of truth for the PR's state \u2014 one comment per PR, edited in",
+    "place across passes, never duplicated. Do not post a fresh",
+    '"pass N summary" on each iteration.',
+    "",
+    "### Step 1: Find the existing sticky comment (if any)",
+    "",
+    "List PR-level comments and look for one authored by the reviewer",
+    "whose body starts with `## Reviewer notes`:",
+    "",
+    "```bash",
+    "gh api repos/{{repository.owner}}/{{repository.name}}/issues/<pr-number>/comments",
+    "```",
+    "",
+    "If multiple candidates exist (an older run double-posted before this",
+    "phase existed), keep the earliest and plan to delete the duplicates",
+    "on a later pass. Never delete another author's comment.",
+    "",
+    "### Step 2: Compose the sticky body",
+    "",
+    "The body uses the following shape:",
+    "",
+    "```",
+    "## Reviewer notes",
+    "",
+    "**Mode:** auto-merge | human-required \u2014 <reason from Phase 2.75>",
+    "**AC status:** <met / partial / missing> (evidence links)",
+    "**CI status:** green | pending | red",
+    "**Outstanding:** <list of comments still open with their classification and author>",
+    "**Pushbacks:** <list of disputes with reasons>",
+    "**Last pass:** <ISO timestamp>",
+    "```",
+    "",
+    "Populate each field from the phases above:",
+    "",
+    "- **Mode / reason** \u2014 the mode and reason recorded in Phase 2.75.",
+    "- **AC status** \u2014 the checklist produced in Phase 3 (met, partial,",
+    "  or missing), with links to the files or tests that provide the",
+    "  evidence.",
+    "- **CI status** \u2014 the verdict from the **CI Verification** section",
+    "  (primary check-runs read, or the Actions-runs fallback when",
+    "  check-runs returns a fine-grained-PAT 403).",
+    "- **Outstanding** \u2014 the comments still carrying a non-terminal",
+    "  reviewer reaction from Phase 3.5 (typically `eyes` for queued",
+    "  in-scope items and `nit` / `question` items that remain open).",
+    "  List each as `<classification>: <author> \u2014 <short summary> (<url>)`.",
+    "- **Pushbacks** \u2014 every comment the reviewer reacted",
+    "  `thinking_face` to on this or any prior pass, with the reason",
+    "  captured in the pushback reply. Empty list when there are none.",
+    "- **Last pass** \u2014 the ISO 8601 timestamp of this run.",
+    "",
+    "### Step 3: Create or edit in place",
+    "",
+    "If no existing sticky comment was found in Step 1, create one:",
+    "",
+    "```bash",
+    "gh pr comment <pr-number> --body '<sticky body>'",
+    "```",
+    "",
+    "If an existing sticky comment was found, edit it in place using the",
+    "comment id. Do not delete and re-create \u2014 editing preserves the",
+    "comment's URL and any reactions humans have added to the summary:",
+    "",
+    "```bash",
+    "gh api repos/{{repository.owner}}/{{repository.name}}/issues/comments/<sticky-comment-id> \\",
+    "  -X PATCH -f body='<sticky body>'",
+    "```",
+    "",
+    "The sticky summary must be updated on every pass through Phase 4.5,",
+    "including passes that ended in a pushback-gated skip, a",
+    "`NEEDS_CHANGES` findings comment, or the `human-required` hand-off.",
+    "Humans rely on the sticky comment to see the current state of the",
+    "PR at a glance \u2014 it must never go stale while the reviewer is",
+    "actively processing the PR.",
+    "",
+    "## Shared Procedure: Conflict-Resolution Delegation",
+    "",
+    "This procedure resolves a PR that cannot land because its head",
+    "branch conflicts with the default branch. It is invoked from **two**",
+    "entry points, both of which reuse the identical guards,",
+    "classification, typed recipes, and fallback defined here \u2014 the flow",
+    "is defined **once** and shared:",
+    "",
+    "- **Phase 4 `update-branch-conflict`** \u2014 a PR that was MERGEABLE at",
+    "  Phase 1.5 went BEHIND, and `gh pr update-branch` then failed",
+    "  because the merge would conflict.",
+    "- **Phase 1.5 `already-conflicting`** \u2014 the orchestrator handed the",
+    "  reviewer a PR that is **already** `CONFLICTING` (its",
+    '  `mergeable == "CONFLICTING"`) before any review work began.',
+    "",
+    "The reviewer **may** delegate conflict resolution to `issue-worker`",
+    "via the feedback-mode delegation contract (the same path Phase 4's",
+    "in-scope-fix delegation uses). The reviewer never hand-resolves",
+    "conflicts itself \u2014 branch mutations always belong to `issue-worker`.",
+    "",
+    "### Entry-point parameters",
+    "",
+    "The caller supplies which entry point it is and how the conflicting",
+    "files are identified. Everything after this step is identical across",
+    "both entry points.",
+    "",
+    "- **`update-branch-conflict`** \u2014 the conflicting-file set is the",
+    "  list reported by the failed `gh pr update-branch` (cross-referenced",
+    "  with `gh pr view <pr-number> --json files`).",
+    "- **`already-conflicting`** \u2014 there is no failed `update-branch` to",
+    "  read conflicting paths from. Identify the conflicting files from",
+    "  the PR's merge state instead: attempt a local rebase of the head",
+    "  branch onto the default branch in a scratch checkout (or read the",
+    "  conflicting paths git reports) and collect the files that carry",
+    "  `<<<<<<<` / `=======` / `>>>>>>>` conflict markers. Use that set",
+    "  as the conflicting-file list. The reviewer inspects these markers",
+    "  read-only to classify; it does **not** stage, commit, or push any",
+    "  resolution \u2014 the actual rebase-and-resolve is delegated to",
+    "  `issue-worker` exactly as in the other entry point.",
+    "",
+    "### Guards",
     "",
     "Delegate **only when all** of the following hold. If any guard fails,",
-    "fall through to the fallback at the end of this sub-section instead.",
+    "fall through to the **Fallback** at the end of this procedure and",
+    "return `skipped`.",
     "",
     "1. **Review mode is `auto-merge`.** Never delegate conflict",
     "   resolution on `human-required` PRs \u2014 pushing worker-resolved",
     "   merge content into them expands the diff under review without",
-    "   the human reviewer's consent. (Unlike the `update-branch` step",
-    "   above, which permits a size-only `human-required` carve-out, the",
+    "   the human reviewer's consent. (Unlike the `update-branch` step,",
+    "   which permits a size-only `human-required` carve-out, the",
     "   conflict-resolution delegation flow is auto-merge-only across",
     "   the board: a worker rebase push is a stronger branch mutation",
     "   than the merge-commit `gh pr update-branch` performs.)",
     "2. **Delegation invocation guard permits the hand-off** \u2014 the PR",
     "   carries the `origin:issue-worker` label, **or** the reviewer was",
     "   invoked with `--allow-human-author`. The same guard used for the",
-    "   in-scope-fix delegation flow above applies here unchanged.",
+    "   in-scope-fix delegation flow applies here unchanged.",
     "3. **The `review:fixing` lease is currently free.** If",
     "   `review:fixing` is already on the PR, another delegation is",
     "   in-flight; skip conflict-resolution delegation, log the contention",
     "   to the sticky summary, and fall through to the fallback.",
-    "4. **No conflicting file is generated or projen-managed.** Run",
-    "   `gh pr view <pr-number> --json files --jq '.files[].path'` and",
-    "   inspect the conflicting paths reported by the failed",
-    "   `update-branch`. If **any** conflicting path matches one of the",
-    "   following globs, the conflict is unsafe to resolve mechanically",
-    "   and the reviewer must skip delegation:",
+    "4. **No conflicting file is generated or projen-managed.** Inspect",
+    "   the conflicting paths from the entry-point step above. If **any**",
+    "   conflicting path matches one of the following globs, the conflict",
+    "   is unsafe to resolve mechanically and the reviewer must skip",
+    "   delegation:",
     "    - `**/*.lock` and `pnpm-lock.yaml` / `yarn.lock` / `package-lock.json`",
     "    - `**/.projen/**`",
     "    - any file whose first 5 lines contain the marker",
@@ -18423,17 +18777,18 @@ var prReviewerSubAgent = {
     "   and conflicts there should be resolved by re-running synth, not by",
     "   merging the conflict markers.",
     "",
+    "### Classify each conflicting file",
+    "",
     "When every guard above passes, **classify each conflicting file**",
     "before composing the fix-list. The classification picks one of two",
     "typed recipes \u2014 a precise `shared-index` resolver when every",
     "conflict is a row-insert race on a registry / index / feature-matrix",
     "file, or the generic rebase recipe in every other case.",
     "",
-    "**Classification step.** For each conflicting path reported by the",
-    "failed `update-branch`, decide whether the file is `shared-index` or",
-    "`generic` against these criteria (the shared-index glob set comes",
-    "from the `shared-editing-safety` rule \u2014 see the bundle's",
-    "`shared-editing.ts` for the canonical constant):",
+    "**Classification step.** For each conflicting path, decide whether",
+    "the file is `shared-index` or `generic` against these criteria (the",
+    "shared-index glob set comes from the `shared-editing-safety` rule \u2014",
+    "see the bundle's `shared-editing.ts` for the canonical constant):",
     "",
     "- `shared-index` \u2014 the path matches one of the shared-editing glob",
     "  patterns:",
@@ -18468,6 +18823,8 @@ var prReviewerSubAgent = {
     "  (see step 3 below). The worker performs a hand-merge of the",
     "  conflict markers.",
     "",
+    "### Hand off to `issue-worker`",
+    "",
     "Hand off to `issue-worker` with the chosen single synthetic",
     "fix-list item:",
     "",
@@ -18555,146 +18912,24 @@ var prReviewerSubAgent = {
     "",
     "7. **Do not re-enable auto-merge in the same pass.** After delegation,",
     "   exit and let a human re-invoke the reviewer. The next pass will",
-    "   re-evaluate `mergeStateStatus` against the rebased branch and",
-    "   re-enable auto-merge through the normal flow above.",
+    "   re-evaluate `mergeStateStatus` (or `mergeable`) against the",
+    "   rebased branch and re-enable auto-merge through the normal flow.",
+    "",
+    "Return `delegated` to the caller when delegation completes",
+    "(regardless of the worker's outcome \u2014 the delegation itself is the",
+    "action taken).",
     "",
-    "Record `Branch updated: delegated (PR #<n>)` for the per-PR report",
-    "when delegation completes (regardless of the worker's outcome \u2014 the",
-    "delegation itself is the action taken).",
+    "### Fallback",
     "",
     "**Fallback when delegation is not permitted or guards fail.** Post a",
     "short comment explaining why the branch could not be updated",
     "automatically and stop. Do not push commits, do not force, do not",
-    "retry. Record `Branch updated: failed (conflicts; <short reason>)`.",
-    "",
-    "```bash",
-    "gh pr comment <pr-number> --body 'Auto-merge queued; branch is BEHIND <default-branch> with conflicts. <short reason delegation was skipped \u2014 e.g. human-required mode, generated-file conflicts, or in-flight review:fixing lease>. A human (or the next reviewer pass after rebase) will need to resolve.'",
-    "```",
-    "",
-    "#### Mode `human-required`",
-    "",
-    "Do **not** run `gh pr merge --auto`. Instead, hand the PR off to a",
-    "human reviewer:",
-    "",
-    "1. Apply the `review:awaiting-human` label so the PR is discoverable",
-    "   in the human-review queue:",
-    "",
-    "   ```bash",
-    "   gh pr edit <pr-number> --add-label 'review:awaiting-human'",
-    "   ```",
-    "",
-    "2. **If `matched_rule == 6`** (size threshold was the sole trigger),",
-    "   run the `Update the branch when `mergeStateStatus` is `BEHIND``",
-    "   step from the `Mode auto-merge` branch above before exiting. The",
-    "   eligibility gate documented in that sub-section explicitly permits",
-    "   `gh pr update-branch` on size-only human-required PRs so the bot",
-    "   keeps the branch fresh against the default branch while the human",
-    "   reviews. Skip this sub-step for `matched_rule` in 2\u20135 \u2014 the gate",
-    "   denies `update-branch` there and the human owns branch-lifecycle.",
-    "",
-    "3. Exit cleanly after the acceptance-criteria check completes and any",
-    "   summary comment the reviewer posts. Proceed to Phase 5 only if a",
-    "   merge occurred \u2014 in `human-required` mode the reviewer stops at",
-    "   the hand-off and does not poll for merge.",
-    "",
-    "The reason captured in Phase 2.75 should be included in any summary",
-    "comment so maintainers know why human review was required (path hit,",
-    "issue type, size threshold, label, or default).",
-    "",
-    "### If any criterion is missing, partial, or CI is failing",
-    "",
-    "Post a plain comment (not a formal review block) with grouped findings:",
-    "",
-    "```bash",
-    "gh pr comment <pr-number> --body '<grouped findings>'",
-    "```",
-    "",
-    "Group findings by severity (**Blocking** / **Suggested** / **Nitpick**).",
-    "For each blocking finding, cite the unmet acceptance criterion and the",
-    "file or function the gap lives in. Do **not** merge, and do **not** push",
-    "any commits to the PR's branch.",
-    "",
-    "Rationale for using a plain comment rather than `gh pr review",
-    "--request-changes`: it is lighter-weight, doesn't require the author to",
-    "dismiss a formal review, and composes cleanly with the multi-PR loop.",
-    "",
-    "## Phase 4.5: Update Sticky Summary",
-    "",
-    "On **every pass**, create or update a single **`## Reviewer notes`**",
-    "comment on the PR. This sticky comment is the human-facing single",
-    "source of truth for the PR's state \u2014 one comment per PR, edited in",
-    "place across passes, never duplicated. Do not post a fresh",
-    '"pass N summary" on each iteration.',
-    "",
-    "### Step 1: Find the existing sticky comment (if any)",
-    "",
-    "List PR-level comments and look for one authored by the reviewer",
-    "whose body starts with `## Reviewer notes`:",
+    "retry. Record `Branch updated: failed (conflicts; <short reason>)`",
+    "and return `skipped` to the caller.",
     "",
     "```bash",
-    "gh api repos/{{repository.owner}}/{{repository.name}}/issues/<pr-number>/comments",
-    "```",
-    "",
-    "If multiple candidates exist (an older run double-posted before this",
-    "phase existed), keep the earliest and plan to delete the duplicates",
-    "on a later pass. Never delete another author's comment.",
-    "",
-    "### Step 2: Compose the sticky body",
-    "",
-    "The body uses the following shape:",
-    "",
+    "gh pr comment <pr-number> --body 'Branch is BEHIND <default-branch> with conflicts. <short reason delegation was skipped \u2014 e.g. human-required mode, generated-file conflicts, or in-flight review:fixing lease>. A human (or the next reviewer pass after rebase) will need to resolve.'",
     "```",
-    "## Reviewer notes",
-    "",
-    "**Mode:** auto-merge | human-required \u2014 <reason from Phase 2.75>",
-    "**AC status:** <met / partial / missing> (evidence links)",
-    "**CI status:** green | pending | red",
-    "**Outstanding:** <list of comments still open with their classification and author>",
-    "**Pushbacks:** <list of disputes with reasons>",
-    "**Last pass:** <ISO timestamp>",
-    "```",
-    "",
-    "Populate each field from the phases above:",
-    "",
-    "- **Mode / reason** \u2014 the mode and reason recorded in Phase 2.75.",
-    "- **AC status** \u2014 the checklist produced in Phase 3 (met, partial,",
-    "  or missing), with links to the files or tests that provide the",
-    "  evidence.",
-    "- **CI status** \u2014 the verdict from the **CI Verification** section",
-    "  (primary check-runs read, or the Actions-runs fallback when",
-    "  check-runs returns a fine-grained-PAT 403).",
-    "- **Outstanding** \u2014 the comments still carrying a non-terminal",
-    "  reviewer reaction from Phase 3.5 (typically `eyes` for queued",
-    "  in-scope items and `nit` / `question` items that remain open).",
-    "  List each as `<classification>: <author> \u2014 <short summary> (<url>)`.",
-    "- **Pushbacks** \u2014 every comment the reviewer reacted",
-    "  `thinking_face` to on this or any prior pass, with the reason",
-    "  captured in the pushback reply. Empty list when there are none.",
-    "- **Last pass** \u2014 the ISO 8601 timestamp of this run.",
-    "",
-    "### Step 3: Create or edit in place",
-    "",
-    "If no existing sticky comment was found in Step 1, create one:",
-    "",
-    "```bash",
-    "gh pr comment <pr-number> --body '<sticky body>'",
-    "```",
-    "",
-    "If an existing sticky comment was found, edit it in place using the",
-    "comment id. Do not delete and re-create \u2014 editing preserves the",
-    "comment's URL and any reactions humans have added to the summary:",
-    "",
-    "```bash",
-    "gh api repos/{{repository.owner}}/{{repository.name}}/issues/comments/<sticky-comment-id> \\",
-    "  -X PATCH -f body='<sticky body>'",
-    "```",
-    "",
-    "The sticky summary must be updated on every pass through Phase 4.5,",
-    "including passes that ended in a pushback-gated skip, a",
-    "`NEEDS_CHANGES` findings comment, or the `human-required` hand-off.",
-    "Humans rely on the sticky comment to see the current state of the",
-    "PR at a glance \u2014 it must never go stale while the reviewer is",
-    "actively processing the PR.",
     "",
     "## Phase 5: Branch Cleanup and Issue Closure Verification",
     "",
@@ -29975,13 +30210,20 @@ function renderFocusSection(focus) {
 
 // src/agent/bundles/meeting-types.ts
 var DEFAULT_AGENDA_TEMPLATE_ROOT = "<meetingsRoot>/_agenda-templates";
+function actionItemFilingHasOverride(filing) {
+  if (!filing) {
+    return false;
+  }
+  return filing.enabled === false || (filing.humanOwnedCues ?? []).length > 0 || (filing.agentWorkableCues ?? []).length > 0;
+}
 function renderMeetingTypesSection(meetings) {
   if (!meetings) {
     return "";
   }
   const types = meetings.meetingTypes ?? [];
   const areas = meetings.meetingAreas ?? [];
-  if (types.length === 0 && areas.length === 0) {
+  const filingOverride = actionItemFilingHasOverride(meetings.actionItemFiling) ? meetings.actionItemFiling : void 0;
+  if (types.length === 0 && areas.length === 0 && !filingOverride) {
     return "";
   }
   const sections = [];
@@ -29991,6 +30233,9 @@ function renderMeetingTypesSection(meetings) {
   if (areas.length > 0) {
     sections.push(renderMeetingAreas(areas));
   }
+  if (filingOverride) {
+    sections.push(renderActionItemFiling(filingOverride));
+  }
   return sections.join("\n\n");
 }
 function renderMeetingTypes(types, agendaTemplateRoot) {
@@ -30044,6 +30289,54 @@ function renderMeetingAreas(areas) {
   }
   return lines.join("\n");
 }
+function renderActionItemFiling(filing) {
+  const lines = [
+    "## Action-item filing policy",
+    "",
+    "This project tunes the Phase 4 (Link) agent-workability split",
+    "through `AgentConfigOptions.meetings.actionItemFiling`. See the",
+    "**Action-item filing policy** section of the `meeting-analyst`",
+    "agent for the full baked-in test.",
+    ""
+  ];
+  if (filing.enabled === false) {
+    lines.push(
+      "- **Split disabled.** Phase 4 falls back to the legacy behaviour:",
+      "  file a follow-up issue for every action item that is not",
+      "  already covered by a requirement or ADR draft, including",
+      "  human-owned tasks. The notes `## Action Items` table is still",
+      "  written, but it is no longer the sole record for human",
+      "  follow-ups."
+    );
+  } else {
+    lines.push(
+      "- **Split enabled** (default). Agent-workable doc deliverables are",
+      "  filed through their dedicated downstream channel; human-owned",
+      "  tasks are recorded only in the notes `## Action Items` table."
+    );
+  }
+  const humanCues = filing.humanOwnedCues ?? [];
+  if (humanCues.length > 0) {
+    lines.push(
+      "",
+      "**Additional human-owned cues** (recorded notes-only, never",
+      "filed), in addition to the bundle's built-in list:",
+      "",
+      ...humanCues.map((cue) => `- ${cue}`)
+    );
+  }
+  const agentCues = filing.agentWorkableCues ?? [];
+  if (agentCues.length > 0) {
+    lines.push(
+      "",
+      "**Additional agent-workable cues** (filed through the matching",
+      "downstream channel), in addition to the bundle's built-in list:",
+      "",
+      ...agentCues.map((cue) => `- ${cue}`)
+    );
+  }
+  return lines.join("\n");
+}
 
 // src/agent/bundles/priority-rules.ts
 function renderPriorityRulesSection(rules) {