@codedrifters/configulator 0.0.351 → 0.0.352

package/lib/index.js

@@ -12200,7 +12200,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. |",
       "",
@@ -12262,6 +12262,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",
       "",
@@ -12293,7 +12348,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",
@@ -12358,7 +12413,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 |",
@@ -12373,7 +12428,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)",
@@ -12503,7 +12561,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",
@@ -12551,6 +12613,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",
@@ -12590,8 +12657,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",
@@ -12628,7 +12714,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",
@@ -12699,7 +12788,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`:",
@@ -12769,7 +12861,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 }
@@ -13914,6 +14017,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 }
@@ -14127,6 +14233,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",
@@ -30312,13 +30443,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 = [];
@@ -30328,6 +30466,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) {
@@ -30381,6 +30522,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) {