@codedrifters/configulator 0.0.181 → 0.0.183

package/lib/index.mjs

@@ -197,6 +197,17 @@ var AGENT_MODEL = {
   BALANCED: "balanced",
   POWERFUL: "powerful"
 };
+function resolveModelAlias(model) {
+  if (!model || model === AGENT_MODEL.INHERIT) {
+    return void 0;
+  }
+  const mapping = {
+    [AGENT_MODEL.POWERFUL]: "opus",
+    [AGENT_MODEL.BALANCED]: "sonnet",
+    [AGENT_MODEL.FAST]: "haiku"
+  };
+  return mapping[model] ?? model;
+}
 var MCP_TRANSPORT = {
   STDIO: "stdio",
   HTTP: "http",
@@ -943,6 +954,297 @@ var jestBundle = {
   }
 };
 
+// src/agent/bundles/meeting-analysis.ts
+var meetingAnalystSubAgent = {
+  name: "meeting-analyst",
+  description: "Processes meeting transcripts through a 4-phase pipeline: extract, notes, draft, and link",
+  model: AGENT_MODEL.POWERFUL,
+  maxTurns: 80,
+  platforms: { cursor: { exclude: true } },
+  prompt: [
+    "# Meeting Analyst Agent",
+    "",
+    "You process meeting transcripts through a structured 4-phase pipeline.",
+    "Each phase runs as a **separate agent session**, triggered by its own",
+    "GitHub issue with a `meeting:*` phase label. You handle exactly **one",
+    "phase per session** \u2014 read the issue to determine which phase to execute.",
+    "",
+    "## Execution Model",
+    "",
+    "1. Each meeting produces up to 4 GitHub issues (one per phase)",
+    "2. Each issue carries a `meeting:*` label identifying the phase",
+    "3. You pick up one issue, execute that phase, commit/push, then close the issue",
+    "4. Phase 1 (Extract) creates the downstream phase issues for phases 2-4",
+    "5. Each downstream issue includes `Depends on: #N` linking to its predecessor",
+    "",
+    "## Design Principles",
+    "",
+    "1. **Extract, don't interpret.** Capture what was said and decided. Flag",
+    "   ambiguity as open items rather than resolving it.",
+    "2. **Route to the right category.** Meeting content maps to requirements,",
+    "   ADRs, product docs, and business strategy. Each output goes to the",
+    "   correct location per the project's taxonomy.",
+    "3. **Preserve provenance.** Every extracted item links back to the meeting",
+    "   source so reviewers can check context.",
+    "4. **Create issues, not documents.** For requirements and ADRs, create",
+    "   GitHub issues that other agents or humans will pick up. Do not write",
+    "   final requirement documents yourself.",
+    "5. **Bi-directional traceability.** Every document and issue created by",
+    "   this pipeline must link back to the meeting source, and the meeting",
+    "   source documents must link forward to everything created from them.",
+    "",
+    "---",
+    "",
+    "## Traceability",
+    "",
+    "All outputs must be bi-directionally linked so any artifact can be traced",
+    "back to the meeting that produced it and forward to everything it spawned.",
+    "",
+    "### Backward links (created artifact \u2192 meeting source)",
+    "",
+    "Every GitHub issue and document created by this pipeline must include a",
+    "`## Traceability` section with:",
+    "",
+    "```markdown",
+    "## Traceability",
+    "",
+    "- **Source meeting:** <path to transcript or meeting notes>",
+    "- **Extraction:** <path to extraction file>",
+    "- **Phase issue:** #<N> (the phase issue that created this artifact)",
+    "```",
+    "",
+    "### Forward links (meeting source \u2192 created artifacts)",
+    "",
+    "After Phase 4 (Link) creates all follow-up issues and documents:",
+    "",
+    "1. **Update the extraction file** with a `## Downstream Artifacts` section",
+    "   listing every issue and document created from this meeting:",
+    "",
+    "   ```markdown",
+    "   ## Downstream Artifacts",
+    "",
+    "   | Artifact | Type | Issue/Path |",
+    "   |----------|------|------------|",
+    "   | <title> | requirement / ADR / action-item / profile | #<N> or <path> |",
+    "   ```",
+    "",
+    "2. **Update the meeting notes** with a similar `## Related Issues` section",
+    "   listing all issues created from this meeting.",
+    "",
+    "3. **Comment on the extract issue** with a summary linking to all created",
+    "   artifacts.",
+    "",
+    "### Within-pipeline links",
+    "",
+    "- Phase issues link to predecessors via `Depends on: #N`",
+    "- Phase issues reference the extraction file path in their body",
+    "- Draft documents reference both the extraction and the meeting notes",
+    "",
+    "---",
+    "",
+    "## Phase 1: Extract (`meeting:extract`)",
+    "",
+    "**Goal:** Read the meeting transcript and categorize all substantive content.",
+    "",
+    "### Steps",
+    "",
+    "1. Read the transcript file specified in the issue body.",
+    "2. Identify and categorize content into these buckets:",
+    "",
+    "   | Bucket | What to look for |",
+    "   |--------|-----------------|",
+    `   | **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 |',
+    '   | **Open questions** | "We need to figure out...", unresolved debates |',
+    "   | **People of interest** | Industry contacts, domain experts mentioned |",
+    "   | **Companies of interest** | Competitors, vendors, partners discussed |",
+    "   | **Strategic direction** | Business model changes, market positioning |",
+    "   | **Product direction** | Roadmap changes, feature prioritization |",
+    "",
+    "3. Write the extraction to a markdown file with structured sections:",
+    "   - Attendees",
+    "   - 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)",
+    "   - Open Questions",
+    "   - People of Interest (with context and whether a profile exists)",
+    "   - Companies of Interest (with type and context)",
+    "   - Strategic / Product Direction",
+    "",
+    "4. **Create downstream phase issues** using `gh issue create`:",
+    "   - Always create a `meeting:notes` issue (blocked on this extract issue)",
+    "   - If requirements OR decisions/ADRs identified, create a `meeting:draft` issue",
+    "     (blocked on the notes issue)",
+    "   - Always create a `meeting:link` issue \u2014 blocked on the draft issue if one",
+    "     was created, otherwise blocked on the notes issue",
+    "",
+    "5. Commit, push, and close the extract issue.",
+    "",
+    "---",
+    "",
+    "## Phase 2: Notes (`meeting:notes`)",
+    "",
+    "**Goal:** Transform the extraction into structured meeting notes.",
+    "",
+    "### Steps",
+    "",
+    "1. Read the extraction file referenced in the issue body (output of Phase 1).",
+    "2. Write structured meeting notes with these sections:",
+    "   - Meeting metadata (title, date, attendees)",
+    "   - Agenda / topics covered",
+    "   - Key Discussion Points (organized by topic)",
+    "   - Decisions (numbered, with rationale)",
+    "   - Action Items (table: who, what, when)",
+    "   - Open Questions",
+    "   - Follow-up items",
+    "3. Commit, push, and close the notes issue.",
+    "",
+    "---",
+    "",
+    "## Phase 3: Draft (`meeting:draft`)",
+    "",
+    "**Goal:** Draft proposals for requirements, ADRs, and product/strategy updates.",
+    "",
+    "This phase only exists if the extraction identified requirements, architectural",
+    "decisions, or strategy changes. If this issue exists, execute it.",
+    "",
+    "### Steps",
+    "",
+    "1. Read the extraction file from Phase 1.",
+    "2. Check existing requirement registries and ADR registries for duplicates.",
+    "3. Draft requirement proposals with:",
+    "   - Category (FR, BR, NFR, etc.)",
+    "   - Summary (2-3 sentences)",
+    "   - Draft acceptance criteria",
+    "   - Related existing requirements",
+    "4. Draft ADR proposals for technology decisions with:",
+    "   - Context and problem statement",
+    "   - Options discussed",
+    "   - Stated preferences or decisions",
+    "   - Status: Proposed or Decided",
+    "5. Summarize product/strategy document updates needed.",
+    "6. Commit, push, and close the draft issue.",
+    "",
+    "---",
+    "",
+    "## Phase 4: Link (`meeting:link`)",
+    "",
+    "**Goal:** Create GitHub issues for follow-up work, cross-reference the",
+    "meeting into existing documentation, and complete bi-directional traceability.",
+    "",
+    "### Steps",
+    "",
+    "1. Read the drafts from Phase 3 (if they exist) and the extraction from Phase 1.",
+    "2. Create requirement issues using `gh issue create` with appropriate labels.",
+    "   Include a `## Traceability` section in each issue body linking back to",
+    "   the source meeting and extraction file.",
+    "3. Create ADR issues if technology decisions need formal records.",
+    "   Include a `## Traceability` section in each.",
+    "4. Create action item issues for tasks that are not document-related.",
+    "   Include a `## Traceability` section in each.",
+    "5. Cross-reference the meeting in any existing documents that were discussed.",
+    "6. Apply direct product/strategy doc updates for items flagged as **Firm**",
+    "   confidence in the extraction.",
+    "7. **Update the extraction file** with a `## Downstream Artifacts` section",
+    "   listing every issue and document created from this meeting.",
+    "8. **Update the meeting notes** with a `## Related Issues` section listing",
+    "   all issues created from this meeting.",
+    "9. Comment on the parent extract issue with a summary linking to all",
+    "   created artifacts.",
+    "10. Commit and push (if any file changes were made), then close the link issue.",
+    "",
+    "---",
+    "",
+    "## GitHub Integration",
+    "",
+    "- 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",
+    "- 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",
+    "",
+    "## When to Shorten the Pipeline",
+    "",
+    "- **Short meetings** (<30 min, <2000 words): combine extract + notes into one session",
+    "- **No requirements or decisions**: Phase 1 skips creating the `meeting:draft` issue",
+    "- **Only action items**: extract + notes + link (3 phase issues)"
+  ].join("\n")
+};
+var processMeetingSkill = {
+  name: "process-meeting",
+  description: "Process a meeting transcript through the 4-phase meeting analysis pipeline",
+  disableModelInvocation: true,
+  userInvocable: true,
+  context: "fork",
+  agent: "meeting-analyst",
+  platforms: { cursor: { exclude: true } },
+  instructions: [
+    "# Process Meeting Transcript",
+    "",
+    "Kick off meeting transcript processing by executing Phase 1 (Extract)",
+    "and creating downstream phase issues for the remaining phases.",
+    "",
+    "## Usage",
+    "",
+    "/process-meeting <path-to-transcript>",
+    "",
+    "## Steps",
+    "",
+    "1. Read the provided transcript file",
+    "2. Execute Phase 1 (Extract) \u2014 categorize transcript content into",
+    "   decisions, requirements, action items, open questions, and more",
+    "3. Write the extraction to a markdown file",
+    "4. Create downstream phase issues using `gh issue create`:",
+    "   - `meeting:notes` issue (always)",
+    "   - `meeting:draft` issue (if requirements or decisions were found)",
+    "   - `meeting:link` issue (always)",
+    "5. Each downstream issue includes `Depends on:` linking to its predecessor",
+    "6. Commit and push the extraction file",
+    "",
+    "## Input",
+    "",
+    "Provide a path to a meeting transcript file (text or markdown).",
+    "The transcript should contain speaker-attributed dialogue.",
+    "",
+    "## Output",
+    "",
+    "- An extraction markdown file with categorized meeting content",
+    "- Phase issues with `meeting:*` labels for downstream agent sessions",
+    "  to pick up (notes, draft, link)"
+  ].join("\n")
+};
+var meetingAnalysisBundle = {
+  name: "meeting-analysis",
+  description: "Meeting transcript processing workflow with 4-phase pipeline (extract, notes, draft, link)",
+  appliesWhen: () => true,
+  rules: [
+    {
+      name: "meeting-processing-workflow",
+      description: "Describes the 4-phase meeting processing pipeline, extraction taxonomy, and labeling conventions",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# Meeting Processing Workflow",
+        "",
+        "Use `/process-meeting <path>` to process a meeting transcript through a",
+        "4-phase pipeline (extract \u2192 notes \u2192 draft \u2192 link). Each phase runs as a",
+        "separate agent session tracked by a GitHub issue with a `meeting:*` label.",
+        "See the `meeting-analyst` agent definition for full workflow details."
+      ].join("\n"),
+      platforms: {
+        cursor: { exclude: true }
+      },
+      tags: ["workflow"]
+    }
+  ],
+  skills: [processMeetingSkill],
+  subAgents: [meetingAnalystSubAgent]
+};
+
 // src/pnpm/pnpm-workspace.ts
 import { relative } from "path";
 import { Component, YamlFile } from "projen";
@@ -1959,7 +2261,8 @@ var BUILT_IN_BUNDLES = [
   awsCdkBundle,
   projenBundle,
   githubWorkflowBundle,
-  slackBundle
+  slackBundle,
+  meetingAnalysisBundle
 ];
 
 // src/agent/bundles/scope.ts
@@ -2291,6 +2594,7 @@ var ClaudeRenderer = class _ClaudeRenderer {
   }
   static renderSkills(component, skills) {
     for (const skill of skills) {
+      if (skill.platforms?.claude?.exclude) continue;
       const lines = [];
       lines.push("---");
       lines.push(`name: "${skill.name}"`);
@@ -2301,8 +2605,9 @@ var ClaudeRenderer = class _ClaudeRenderer {
       if (skill.userInvocable === false) {
         lines.push(`user-invocable: false`);
       }
-      if (skill.model) {
-        lines.push(`model: "${skill.model}"`);
+      const resolvedSkillModel = resolveModelAlias(skill.model);
+      if (resolvedSkillModel) {
+        lines.push(`model: "${resolvedSkillModel}"`);
       }
       if (skill.effort) {
         lines.push(`effort: "${skill.effort}"`);
@@ -2344,8 +2649,9 @@ var ClaudeRenderer = class _ClaudeRenderer {
       lines.push(`name: ${agent.name}`);
       lines.push(`description: >-`);
       lines.push(`  ${agent.description}`);
-      if (agent.model) {
-        lines.push(`model: ${agent.model}`);
+      const resolvedModel = resolveModelAlias(agent.model);
+      if (resolvedModel) {
+        lines.push(`model: ${resolvedModel}`);
       }
       if (agent.tools && agent.tools.length > 0) {
         lines.push(`tools:`);
@@ -2458,6 +2764,7 @@ var CursorRenderer = class _CursorRenderer {
   }
   static renderSkills(component, skills) {
     for (const skill of skills) {
+      if (skill.platforms?.cursor?.exclude) continue;
       const lines = [];
       lines.push("---");
       lines.push(`name: "${skill.name}"`);
@@ -2499,9 +2806,6 @@ var CursorRenderer = class _CursorRenderer {
       lines.push(`name: ${agent.name}`);
       lines.push(`description: >-`);
       lines.push(`  ${agent.description}`);
-      if (agent.model) {
-        lines.push(`model: ${agent.model}`);
-      }
       if (agent.platforms?.cursor?.readonly) {
         lines.push(`readonly: true`);
       }
@@ -3816,6 +4120,198 @@ function addBuildCompleteJob(buildWorkflow) {
   });
 }
 
+// src/workflows/sync-labels.ts
+import { Component as Component14, YamlFile as YamlFile2 } from "projen";
+import { JobPermission as JobPermission4 } from "projen/lib/github/workflows-model";
+var DEFAULT_STATUS_LABELS = [
+  {
+    name: "status:ready",
+    color: "0E8A16",
+    description: "Task is ready for pickup"
+  },
+  {
+    name: "status:in-progress",
+    color: "FBCA04",
+    description: "Actively being worked on"
+  },
+  {
+    name: "status:blocked",
+    color: "D93F0B",
+    description: "Blocked on a dependency or question"
+  },
+  {
+    name: "status:done",
+    color: "6F42C1",
+    description: "Task completed and closed"
+  },
+  {
+    name: "status:deferred",
+    color: "C2E0C6",
+    description: "Intentionally parked \u2014 not ready for pickup"
+  },
+  {
+    name: "status:needs-attention",
+    color: "FF0000",
+    description: "Requires human review"
+  }
+];
+var DEFAULT_PRIORITY_LABELS = [
+  {
+    name: "priority:critical",
+    color: "B60205",
+    description: "Critical priority \u2014 address immediately"
+  },
+  {
+    name: "priority:high",
+    color: "D93F0B",
+    description: "High priority \u2014 pick before normal"
+  },
+  {
+    name: "priority:medium",
+    color: "E4E669",
+    description: "Medium priority"
+  },
+  {
+    name: "priority:low",
+    color: "D4C5F9",
+    description: "Low priority \u2014 skip if higher-priority work exists"
+  },
+  {
+    name: "priority:trivial",
+    color: "EDEDED",
+    description: "Trivial priority \u2014 address when convenient"
+  }
+];
+var DEFAULT_TYPE_LABELS = [
+  {
+    name: "type:feat",
+    color: "1D76DB",
+    description: "New feature or functionality"
+  },
+  {
+    name: "type:fix",
+    color: "D73A4A",
+    description: "Bug fix"
+  },
+  {
+    name: "type:docs",
+    color: "0075CA",
+    description: "Documentation only"
+  },
+  {
+    name: "type:style",
+    color: "BFD4F2",
+    description: "Code style (formatting, whitespace) \u2014 no logic change"
+  },
+  {
+    name: "type:refactor",
+    color: "A2EEEF",
+    description: "Code restructure \u2014 no feature or fix"
+  },
+  {
+    name: "type:perf",
+    color: "F9D0C4",
+    description: "Performance improvement"
+  },
+  {
+    name: "type:test",
+    color: "BFD4F2",
+    description: "Adding or updating tests"
+  },
+  {
+    name: "type:build",
+    color: "E6CCF5",
+    description: "Build system or external dependencies"
+  },
+  {
+    name: "type:ci",
+    color: "D4C5F9",
+    description: "CI configuration changes"
+  },
+  {
+    name: "type:chore",
+    color: "E6E6E6",
+    description: "Maintenance tasks (deps, tooling, config)"
+  },
+  {
+    name: "type:revert",
+    color: "EDEDED",
+    description: "Revert a previous commit"
+  },
+  {
+    name: "type:release",
+    color: "0E8A16",
+    description: "Release preparation and version bumps"
+  },
+  {
+    name: "type:hotfix",
+    color: "B60205",
+    description: "Urgent production fix"
+  }
+];
+var DEFAULT_WORKFLOW_NAME2 = "sync-labels";
+var LABELS_CONFIG_PATH = ".github/labels.yml";
+function addSyncLabelsWorkflow(project, options) {
+  const workflowName = options.workflowName ?? DEFAULT_WORKFLOW_NAME2;
+  const deleteOtherLabels = options.deleteOtherLabels ?? true;
+  const allLabels = [
+    ...DEFAULT_STATUS_LABELS,
+    ...DEFAULT_PRIORITY_LABELS,
+    ...DEFAULT_TYPE_LABELS,
+    ...options.labels ?? []
+  ];
+  new LabelsFile(project, allLabels);
+  const workflow = project.github?.addWorkflow(workflowName);
+  if (!workflow) {
+    return;
+  }
+  workflow.on({
+    push: {
+      branches: ["main"],
+      paths: [LABELS_CONFIG_PATH]
+    },
+    workflowDispatch: {}
+  });
+  workflow.addJobs({
+    sync: {
+      name: "Sync labels",
+      runsOn: ["ubuntu-latest"],
+      permissions: {
+        contents: JobPermission4.READ,
+        issues: JobPermission4.WRITE
+      },
+      steps: [
+        {
+          name: "Checkout",
+          uses: "actions/checkout@v6"
+        },
+        {
+          name: "Sync labels",
+          uses: "EndBug/label-sync@v2",
+          with: {
+            "config-file": LABELS_CONFIG_PATH,
+            "delete-other-labels": deleteOtherLabels,
+            token: "${{ secrets.GITHUB_TOKEN }}"
+          }
+        }
+      ]
+    }
+  });
+}
+var LabelsFile = class extends Component14 {
+  constructor(project, labels) {
+    super(project);
+    new YamlFile2(project, LABELS_CONFIG_PATH, {
+      obj: labels.map((l) => ({
+        name: l.name,
+        color: l.color,
+        description: l.description
+      })),
+      committed: true
+    });
+  }
+};
+
 // src/projects/monorepo-project.ts
 var CONFIGULATOR_PACKAGE_NAME = "@codedrifters/configulator";
 var postInstallDependenciesMap = /* @__PURE__ */ new WeakMap();
@@ -4065,6 +4561,12 @@ var MonorepoProject = class extends TypeScriptAppProject {
         typeof options.agentConfig === "object" ? options.agentConfig : {}
       );
     }
+    if (options.syncLabels !== false) {
+      addSyncLabelsWorkflow(
+        this,
+        typeof options.syncLabels === "object" ? options.syncLabels : {}
+      );
+    }
     if (this.buildWorkflow) {
       addBuildCompleteJob(this.buildWorkflow);
     }
@@ -4123,9 +4625,9 @@ var MonorepoProject = class extends TypeScriptAppProject {
 
 // src/typescript/typescript-config.ts
 import { relative as relative4 } from "path";
-import { Component as Component14 } from "projen";
+import { Component as Component15 } from "projen";
 import { ensureRelativePathStartsWithDot } from "projen/lib/util/path";
-var TypeScriptConfig = class extends Component14 {
+var TypeScriptConfig = class extends Component15 {
   constructor(project) {
     super(project);
     let tsPaths = {};
@@ -4153,12 +4655,12 @@ var TypeScriptConfig = class extends Component14 {
 
 // src/workflows/aws-deploy-workflow.ts
 var import_utils11 = __toESM(require_lib());
-import { Component as Component15 } from "projen";
+import { Component as Component16 } from "projen";
 import { BuildWorkflow } from "projen/lib/build";
 import { GitHub as GitHub2 } from "projen/lib/github";
-import { JobPermission as JobPermission4 } from "projen/lib/github/workflows-model";
+import { JobPermission as JobPermission5 } from "projen/lib/github/workflows-model";
 var PROD_DEPLOY_NAME = "prod-deploy";
-var AwsDeployWorkflow = class _AwsDeployWorkflow extends Component15 {
+var AwsDeployWorkflow = class _AwsDeployWorkflow extends Component16 {
   constructor(project, options = {}) {
     super(project);
     this.project = project;
@@ -4385,8 +4887,8 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends Component15 {
         ],
         runsOn: ["ubuntu-latest"],
         permissions: {
-          contents: JobPermission4.READ,
-          idToken: JobPermission4.WRITE
+          contents: JobPermission5.READ,
+          idToken: JobPermission5.WRITE
         },
         concurrency: deployJobName,
         if: jobCondition,
@@ -4432,6 +4934,9 @@ export {
   BUILT_IN_BUNDLES,
   CLAUDE_RULE_TARGET,
   COMPLETE_JOB_ID,
+  DEFAULT_PRIORITY_LABELS,
+  DEFAULT_STATUS_LABELS,
+  DEFAULT_TYPE_LABELS,
   JsiiFaker,
   MCP_TRANSPORT,
   MERGE_METHODS,
@@ -4456,13 +4961,16 @@ export {
   Vitest,
   addApproveMergeUpgradeWorkflow,
   addBuildCompleteJob,
+  addSyncLabelsWorkflow,
   awsCdkBundle,
   baseBundle,
   getLatestEligibleVersion,
   githubWorkflowBundle,
   jestBundle,
+  meetingAnalysisBundle,
   pnpmBundle,
   projenBundle,
+  resolveModelAlias,
   resolveTemplateVariables,
   slackBundle,
   turborepoBundle,