@codedrifters/configulator 0.0.255 → 0.0.257

package/lib/index.d.ts

@@ -1019,6 +1019,314 @@ interface PriorityRule {
      */
     readonly rationale: string;
 }
+/*******************************************************************************
+ *
+ * Focus Scoring
+ *
+ ******************************************************************************/
+/**
+ * Match predicate for a single focus area. At least one sub-field
+ * should be set; multiple sub-fields on the same match combine as a
+ * logical OR (any one matching contributes the focus area's weight).
+ *
+ * @see FocusArea
+ */
+interface FocusAreaMatch {
+    /** Any of these labels present on the issue matches. */
+    readonly labels?: ReadonlyArray<string>;
+    /**
+     * Case-insensitive substrings matched against the issue title.
+     * A hit on any single keyword fires the match.
+     */
+    readonly titleKeywords?: ReadonlyArray<string>;
+    /**
+     * Case-insensitive substrings matched against the issue body.
+     * A hit on any single keyword fires the match.
+     */
+    readonly bodyKeywords?: ReadonlyArray<string>;
+}
+/**
+ * A single scored focus area — a named customer, segment,
+ * organization, software product, regulation, or person the project
+ * cares about right now. Matching issues receive this area's
+ * `weight` as a priority boost at triage time.
+ *
+ * @see FocusConfig
+ * @see ./bundles/focus.ts#renderFocusSection
+ */
+interface FocusArea {
+    /** Human-readable name for the focus area (e.g. "Acme Corp"). */
+    readonly name: string;
+    /**
+     * Consuming-repo-defined vocabulary describing what kind of entity
+     * this focus area represents (e.g. `"customer"`, `"segment"`,
+     * `"organization"`, `"software"`, `"regulation"`, `"person"`).
+     * The `AgentExpansionRules.allowedTypes` /
+     * `AgentExpansionRules.forbiddenTypes` lists gate what values
+     * agents are permitted to introduce.
+     */
+    readonly type: string;
+    /**
+     * Provenance. `"human"` entries are curated by a maintainer;
+     * `"agent"` entries were appended by an agent under the
+     * agent-expansion rules and must carry a `discoveredIn` reference.
+     */
+    readonly source: "human" | "agent";
+    /**
+     * Issue reference (e.g. `"#123"`) that introduced the focus area.
+     * Required when `source` is `"agent"` so the provenance of every
+     * agent-appended entry is auditable; optional for human entries.
+     */
+    readonly discoveredIn?: string;
+    /** Match predicate that decides which issues this area applies to. */
+    readonly match: FocusAreaMatch;
+    /**
+     * Positive integer weight contributed to the issue's focus score
+     * when the match fires. Consuming repos typically cap this with
+     * `AgentExpansionRules.maxWeight` (default 8 in openhi's reference
+     * implementation).
+     */
+    readonly weight: number;
+}
+/**
+ * Guard-rails on what agents are allowed to append to `focus.json`
+ * without human review. The agent-expansion contract is append-only:
+ * agents never modify or remove existing entries.
+ */
+interface AgentExpansionRules {
+    /**
+     * Hard cap on the `weight` an agent may set on a newly appended
+     * focus area. Human curators may use higher weights.
+     */
+    readonly maxWeight: number;
+    /**
+     * Whitelist of `FocusArea.type` values agents are permitted to
+     * introduce. Any type outside this list must be added by a human.
+     */
+    readonly allowedTypes: ReadonlyArray<string>;
+    /**
+     * Explicit blocklist of `FocusArea.type` values agents must never
+     * introduce, even if the list accidentally overlaps
+     * `allowedTypes`. `forbiddenTypes` wins on conflict.
+     */
+    readonly forbiddenTypes: ReadonlyArray<string>;
+    /**
+     * Optional cap on the number of entries in each keyword array
+     * (`match.labels`, `match.titleKeywords`, `match.bodyKeywords`)
+     * on an agent-appended focus area. Prevents runaway keyword
+     * expansion. Human entries are not subject to this cap.
+     */
+    readonly maxKeywords?: number;
+}
+/**
+ * Top-level configuration for the focus-scoring engine. The schema
+ * and agent-expansion rules live in the configulator bundle; the
+ * actual `focus.json` file is authored and curated in the consuming
+ * repo.
+ *
+ * When supplied via `AgentConfigOptions.focus`, the `base` bundle
+ * appends a "Focus scoring" subsection to the
+ * `issue-label-conventions` rule that teaches agents how to read
+ * `focus.json`, how focus weight interacts with the
+ * `priority:*` taxonomy, and what they may and may not append to
+ * the file.
+ *
+ * @see FocusArea
+ * @see AgentExpansionRules
+ * @see ./bundles/focus.ts#renderFocusSection
+ */
+interface FocusConfig {
+    /**
+     * Path to the focus file relative to the repo root.
+     * @default ".claude/focus.json"
+     */
+    readonly focusFilePath?: string;
+    /**
+     * Schema version the consuming repo's `focus.json` conforms to.
+     * Bump when the schema changes in a backwards-incompatible way.
+     * @default 1
+     */
+    readonly schemaVersion?: number;
+    /**
+     * Cumulative focus-score thresholds that map into the
+     * `priority:*` taxonomy. An issue whose total focus score
+     * (sum of matched focus-area weights) reaches `high` is boosted
+     * to `priority:high`; reaching `medium` keeps it at
+     * `priority:medium`. Scores below `medium` do not affect the
+     * inferred priority.
+     *
+     * @remarks `high` and `medium` must be integers. The JSON schema
+     * at `schemas/focus.schema.json` enforces this for `focus.json`.
+     */
+    readonly thresholds?: {
+        readonly high: number;
+        readonly medium: number;
+    };
+    /**
+     * Guard-rails that govern what agents may append to `focus.json`.
+     * When omitted, the rendered rule documents that agents must
+     * **not** append to `focus.json` without human review.
+     */
+    readonly agentExpansionRules?: AgentExpansionRules;
+}
+/*******************************************************************************
+ *
+ * Meetings Config
+ *
+ ******************************************************************************/
+/**
+ * Scope classifier for a meeting type. Used by the `meeting-analysis`
+ * bundle to reason about where a given meeting belongs (internal vs
+ * external) and, for external meetings, the nature of the other party.
+ *
+ * - `internal-recurring` — recurring internal meeting (weekly standup,
+ *   team sync, planning cadence).
+ * - `internal-oneoff` — one-off internal meeting (brainstorm, kickoff,
+ *   retro).
+ * - `external-customer` — meeting with an existing paying customer.
+ * - `external-prospect` — meeting with a sales prospect not yet under
+ *   contract.
+ * - `external-partner` — meeting with a partner (integration, vendor,
+ *   channel).
+ * - `external-other` — any external meeting that does not fit the
+ *   customer / prospect / partner buckets.
+ */
+type MeetingScope = "internal-recurring" | "internal-oneoff" | "external-customer" | "external-prospect" | "external-partner" | "external-other";
+/**
+ * A single meeting-type taxonomy entry declared by the consuming repo.
+ * Each entry names a kind of meeting the project recognizes
+ * (`founders-weekly`, `customer-discovery`, etc.) and supplies the
+ * per-type metadata agents need to route, default, and template that
+ * meeting.
+ *
+ * When `AgentConfigOptions.meetings.meetingTypes` is non-empty, the
+ * `meeting-analysis` bundle renders a "Recognized meeting types"
+ * subsection listing every declared type so agents pick from the
+ * project's vocabulary rather than guessing.
+ *
+ * @see MeetingsConfig
+ * @see ./bundles/meeting-types.ts#renderMeetingTypesSection
+ */
+interface MeetingType {
+    /**
+     * Stable machine identifier for the meeting type. Used as the
+     * `meeting_type` frontmatter value on meeting notes and as the key
+     * that the future `agenda` bundle will look up when selecting a
+     * pre-meeting template.
+     * @example 'founders-weekly', 'customer-discovery', 'sprint-review'
+     */
+    readonly id: string;
+    /** Human-readable label shown in generated rule content. */
+    readonly label: string;
+    /**
+     * Scope classification — whether the meeting is internal (recurring
+     * or one-off) or external (customer / prospect / partner / other).
+     */
+    readonly scope: MeetingScope;
+    /**
+     * Default scheduled duration in minutes. Optional; agents may use
+     * this when proposing calendar holds or when validating a
+     * transcript's recorded duration against the type's expected
+     * duration.
+     */
+    readonly defaultDurationMinutes?: number;
+    /**
+     * Path to a pre-meeting agenda skeleton for this type, resolved
+     * relative to `MeetingsConfig.agendaTemplateRoot`. Optional — a
+     * type without a template simply has no canned agenda.
+     * @example 'founders-weekly.md', 'customer-discovery/v2.md'
+     */
+    readonly agendaTemplatePath?: string;
+    /**
+     * Human-readable cadence descriptor. Free-form text — agents
+     * surface the string verbatim rather than parsing it.
+     * @example 'weekly', 'every 2 weeks', 'one-off'
+     */
+    readonly cadence?: string;
+}
+/**
+ * A single meeting-area entry. Meeting areas provide a coarse
+ * routing map from an `area` frontmatter value on a meeting note to
+ * the sub-tree of the docs root where phase-4 direct edits should
+ * land.
+ *
+ * Example: declaring `{ id: 'product-engineering', label: 'Product &
+ * Engineering', docRoot: 'product' }` tells the `meeting-analysis`
+ * bundle that a meeting whose frontmatter carries
+ * `area: product-engineering` should have its direct edits routed
+ * under `<docsRoot>/product/`.
+ *
+ * When `AgentConfigOptions.meetings.meetingAreas` is non-empty, the
+ * `meeting-analysis` bundle renders an "Area → doc-root mapping"
+ * subsection documenting every declared area and its resolved
+ * destination.
+ *
+ * @see MeetingsConfig
+ * @see ./bundles/meeting-types.ts#renderMeetingTypesSection
+ */
+interface MeetingArea {
+    /**
+     * Stable machine identifier for the area. Matches the `area`
+     * frontmatter value on meeting notes.
+     * @example 'product-engineering', 'go-to-market', 'operations'
+     */
+    readonly id: string;
+    /** Human-readable label shown in generated rule content. */
+    readonly label: string;
+    /**
+     * Destination folder for phase-4 direct edits on meeting notes
+     * carrying this area. Interpreted **relative to the resolved
+     * docs root** (`AgentPathsConfig.docsRoot`, default
+     * `docs/src/content/docs`). Do not include a leading slash.
+     * @example 'product', 'gtm', 'operations'
+     */
+    readonly docRoot: string;
+}
+/**
+ * Meeting-analysis injection points — the set of typed
+ * configurations agents consult when classifying, routing, and
+ * templating a meeting. Every field is optional.
+ *
+ * - `meetingTypes` — the set of meeting types the repo recognizes.
+ * - `meetingAreas` — maps `area` frontmatter to doc-root sub-trees.
+ * - `agendaTemplateRoot` — where pre-meeting agenda skeletons live.
+ *
+ * When supplied, the `meeting-analysis` bundle conditionally renders
+ * two new subsections into the `meeting-processing-workflow` rule —
+ * "Recognized meeting types" (when `meetingTypes` is non-empty) and
+ * "Area → doc-root mapping" (when `meetingAreas` is non-empty).
+ *
+ * @see MeetingType
+ * @see MeetingArea
+ * @see ./bundles/meeting-types.ts#renderMeetingTypesSection
+ */
+interface MeetingsConfig {
+    /**
+     * Meeting-type taxonomy. An empty or missing list means the
+     * consuming repo does not classify meetings by type; the
+     * `meeting-analysis` bundle falls back to its generic 4-phase
+     * behaviour.
+     */
+    readonly meetingTypes?: ReadonlyArray<MeetingType>;
+    /**
+     * Meeting-area map. An empty or missing list means the consuming
+     * repo does not route meetings by area; phase-4 direct edits
+     * continue to land under the default meetings root.
+     */
+    readonly meetingAreas?: ReadonlyArray<MeetingArea>;
+    /**
+     * Root folder containing pre-meeting agenda-template skeletons.
+     * Resolved at issue-creation time by the (future) `agenda` bundle
+     * when selecting a template for a given `meeting_type`.
+     *
+     * When unset, the `meeting-analysis` bundle documents the default
+     * of `<meetingsRoot>/_agenda-templates` — consumers that wire a
+     * custom `AgentPathsConfig.meetingsRoot` inherit the override
+     * automatically.
+     * @default "<meetingsRoot>/_agenda-templates"
+     */
+    readonly agendaTemplateRoot?: string;
+}
 /*******************************************************************************
  *
  * AgentConfig Options
@@ -1131,6 +1439,46 @@ interface AgentConfigOptions {
      * @see ./bundles/priority-rules.ts#renderPriorityRulesSection
      */
     readonly priorityRules?: ReadonlyArray<PriorityRule>;
+    /**
+     * Focus-scoring configuration. Declares the path to the consuming
+     * repo's `focus.json` file, score thresholds, and the
+     * agent-expansion rules that govern what agents may append to the
+     * file.
+     *
+     * When set, the `base` bundle appends a "Focus scoring"
+     * subsection to the `issue-label-conventions` rule that teaches
+     * agents (a) how to read `focus.json`, (b) how focus weight
+     * interacts with the `priority:*` taxonomy, and (c) the
+     * agent-driven expansion contract. The actual `focus.json` file
+     * is authored and curated in the consuming repo — configulator
+     * ships the schema and agent instructions only.
+     *
+     * @see FocusConfig
+     * @see FocusArea
+     * @see AgentExpansionRules
+     * @see ./bundles/focus.ts#renderFocusSection
+     */
+    readonly focus?: FocusConfig;
+    /**
+     * Meeting-analysis injection points — typed configs the
+     * `meeting-analysis` bundle consults when classifying, routing, and
+     * templating meetings. Supplies the meeting-type taxonomy, the
+     * area → doc-root routing map, and the agenda-template root used
+     * by the (future) `agenda` bundle.
+     *
+     * When `meetingTypes` is non-empty, the `meeting-analysis` bundle
+     * appends a "Recognized meeting types" subsection to the
+     * `meeting-processing-workflow` rule. When `meetingAreas` is
+     * non-empty, it appends an "Area → doc-root mapping" subsection.
+     * When both are empty or unset, the generated rule content is
+     * unchanged from the no-config baseline.
+     *
+     * @see MeetingsConfig
+     * @see MeetingType
+     * @see MeetingArea
+     * @see ./bundles/meeting-types.ts#renderMeetingTypesSection
+     */
+    readonly meetings?: MeetingsConfig;
 }
 
 /**
@@ -1403,6 +1751,47 @@ declare const prReviewBundle: AgentRuleBundle;
  */
 declare const projenBundle: AgentRuleBundle;
 
+/**
+ * Render the markdown subsection appended to the
+ * `issue-label-conventions` rule when `AgentConfigOptions.focus` is
+ * supplied. Returns an empty string when `focus` is undefined so
+ * callers can unconditionally concatenate the result.
+ *
+ * The section documents three things for agents:
+ *
+ * 1. How to read `focus.json` at triage time
+ * 2. How focus weight interacts with the `priority:*` taxonomy
+ * 3. The agent-driven expansion contract (what agents may append)
+ *
+ * Configulator ships this rule content plus a JSON Schema that
+ * validates the `focus.json` file; the file itself is authored and
+ * curated in the consuming repo.
+ */
+declare function renderFocusSection(focus: FocusConfig | undefined): string;
+
+/**
+ * Render the markdown subsections appended to the
+ * `meeting-processing-workflow` rule when `AgentConfigOptions.meetings`
+ * is supplied. Returns an empty string when the supplied config has
+ * nothing to render (no meeting types and no meeting areas) so callers
+ * can unconditionally concatenate the result.
+ *
+ * Two subsections are rendered, each gated on its own input array:
+ *
+ * 1. **Recognized meeting types** — rendered when `meetingTypes` is
+ *    non-empty. Lists every declared type with its scope, optional
+ *    cadence, default duration, and agenda template path. Also
+ *    documents the resolved `agendaTemplateRoot`.
+ * 2. **Area → doc-root mapping** — rendered when `meetingAreas` is
+ *    non-empty. Lists every declared area with its `id`, label, and
+ *    docs-root-relative destination folder.
+ *
+ * Bundles consume the rendered string by appending it to their own
+ * rule content. A caller that has no meeting types and no meeting
+ * areas receives an empty string and can safely concatenate.
+ */
+declare function renderMeetingTypesSection(meetings: MeetingsConfig | undefined): string;
+
 /**
  * Render the markdown subsection appended to the
  * `issue-label-conventions` rule when `AgentConfigOptions.priorityRules`
@@ -4137,5 +4526,5 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_AGENT_PATHS, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, STARLIGHT_ROLE, StarlightProject, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, renderPriorityRulesSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, validateStarlightSingleton, vitestBundle };
-export type { AgentConfigOptions, AgentModel, AgentPathsConfig, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, LayoutEnforcement, LayoutViolation, McpServerConfig, McpTransport, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, PriorityRule, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedProjectMetadata, SlackMetadata, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AstroConfig, AstroOutput, AstroProject, AwsCdkProject, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, AwsTeardownWorkflow, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_AGENT_PATHS, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, STARLIGHT_ROLE, StarlightProject, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, renderFocusSection, renderMeetingTypesSection, renderPriorityRulesSection, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, validateStarlightSingleton, vitestBundle };
+export type { AgentConfigOptions, AgentExpansionRules, AgentModel, AgentPathsConfig, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AstroConfigOptions, AstroIntegrationSpec, AstroProjectOptions, AwsAccount, AwsCdkProjectOptions, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, AwsTeardownWorkflowOptions, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, FocusArea, FocusAreaMatch, FocusConfig, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, LayoutEnforcement, LayoutViolation, McpServerConfig, McpTransport, MeetingArea, MeetingScope, MeetingType, MeetingsConfig, MergeMethod, MonorepoLayoutRoot, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, PriorityRule, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedAgentPaths, ResolvedProjectMetadata, SlackMetadata, StarlightEditLink, StarlightLogo, StarlightProjectOptions, StarlightRole, StarlightSidebarItem, StarlightSingletonViolation, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };

package/lib/index.js

@@ -243,6 +243,8 @@ __export(index_exports, {
   pnpmBundle: () => pnpmBundle,
   prReviewBundle: () => prReviewBundle,
   projenBundle: () => projenBundle,
+  renderFocusSection: () => renderFocusSection,
+  renderMeetingTypesSection: () => renderMeetingTypesSection,
   renderPriorityRulesSection: () => renderPriorityRulesSection,
   requirementsAnalystBundle: () => requirementsAnalystBundle,
   requirementsReviewerBundle: () => requirementsReviewerBundle,
@@ -14581,6 +14583,190 @@ var vitestBundle = {
   }
 };
 
+// src/agent/bundles/focus.ts
+var DEFAULT_FOCUS_FILE_PATH = ".claude/focus.json";
+var DEFAULT_SCHEMA_VERSION = 1;
+function renderFocusSection(focus) {
+  if (!focus) {
+    return "";
+  }
+  const focusFilePath = focus.focusFilePath ?? DEFAULT_FOCUS_FILE_PATH;
+  const schemaVersion = focus.schemaVersion ?? DEFAULT_SCHEMA_VERSION;
+  const lines = [
+    "## Focus scoring",
+    "",
+    "This project runs a **focus-scoring engine** alongside the generic",
+    "`priority:*` inference above. Focus scoring boosts the priority of",
+    "issues that match the project's currently-declared focus areas \u2014",
+    "named customers, segments, organizations, software products,",
+    "regulations, or people the project cares about right now.",
+    "",
+    "### Reading `focus.json`",
+    "",
+    `The focus file lives at \`${focusFilePath}\` and conforms to schema`,
+    `version \`${schemaVersion}\`. Each entry declares a match predicate`,
+    "(any combination of `labels`, `titleKeywords`, `bodyKeywords`) and",
+    "a positive integer `weight`. At triage time:",
+    "",
+    `1. Read \`${focusFilePath}\`. If the file is missing or empty,`,
+    "   skip focus scoring entirely \u2014 the generic priority heuristics",
+    "   apply unchanged.",
+    "2. For each focus area, test its match predicate against the",
+    "   issue's labels, title, and body. A match on **any** sub-field",
+    "   (labels / title keywords / body keywords) fires the area and",
+    "   contributes its `weight` to the issue's focus score.",
+    "3. Keyword matching is case-insensitive substring matching \u2014",
+    '   `titleKeywords: ["Acme"]` matches an issue titled',
+    "   `feat: onboard acme corp`.",
+    "4. Sum all matched weights to produce the issue's **focus score**.",
+    ""
+  ];
+  lines.push("### How focus score interacts with `priority:*`");
+  lines.push("");
+  if (focus.thresholds) {
+    const { high, medium } = focus.thresholds;
+    lines.push(`A focus score of \`${high}\` or more boosts the`);
+    const mediumBand = high - medium === 1 ? `A focus score of \`${medium}\` keeps` : `A focus score of \`${medium}\` up to \`${high - 1}\` keeps`;
+    lines.push(
+      "issue to `priority:high`.",
+      `${mediumBand} the issue at \`priority:medium\`. Scores below`,
+      `\`${medium}\` do **not** alter the priority that`,
+      "the generic heuristics would otherwise infer."
+    );
+  } else {
+    lines.push(
+      "This project has not declared explicit focus-score thresholds.",
+      "Treat any non-zero focus score as a soft signal to lift one",
+      "priority tier (never above `priority:high`) unless the generic",
+      "heuristics already pin a higher tier."
+    );
+  }
+  lines.push("");
+  lines.push(
+    "Focus scoring **never lowers** an issue's priority \u2014 the generic",
+    "heuristics set the floor, and focus weight can only lift it.",
+    "`priority:critical` is never set by focus scoring alone; the",
+    "generic heuristics own that tier."
+  );
+  lines.push("");
+  lines.push("### Agent-driven expansion");
+  lines.push("");
+  if (focus.agentExpansionRules) {
+    const rules = focus.agentExpansionRules;
+    const allowedList = rules.allowedTypes.map((t) => `\`${t}\``).join(", ");
+    const forbiddenList = rules.forbiddenTypes.map((t) => `\`${t}\``).join(", ");
+    lines.push(
+      `Agents may **append** new focus areas to \`${focusFilePath}\``,
+      "when they discover a relevant entity during work, subject to",
+      "these guard-rails:"
+    );
+    lines.push("");
+    lines.push(
+      `- **Max weight.** Agent-appended entries must set \`weight\` to`,
+      `  \`${rules.maxWeight}\` or less. Higher weights require a human.`
+    );
+    lines.push(
+      "- **Allowed types.** Agents may only introduce entries whose",
+      `  \`type\` is one of: ${allowedList || "(none)"}.`
+    );
+    if (rules.forbiddenTypes.length > 0) {
+      lines.push(
+        "- **Forbidden types.** Even inside `allowedTypes`, agents must",
+        `  never introduce entries whose \`type\` is one of: ${forbiddenList}.`
+      );
+    }
+    if (rules.maxKeywords !== void 0) {
+      lines.push(
+        "- **Max keywords per match field.** Agent-appended entries",
+        `  may list at most \`${rules.maxKeywords}\` items in each of`,
+        "  `match.labels`, `match.titleKeywords`, and `match.bodyKeywords`."
+      );
+    }
+    lines.push(
+      '- **Provenance.** Agent-appended entries must set `source: "agent"`',
+      '  and `discoveredIn: "#<issue>"` referencing the issue that',
+      "  surfaced the focus area."
+    );
+    lines.push(
+      "- **Append-only.** Never modify or remove existing entries.",
+      "  Human curators own edits and deletions."
+    );
+  } else {
+    lines.push(
+      `Agents must **not** append to \`${focusFilePath}\`. This project`,
+      "has not declared agent-expansion rules \u2014 all focus-area curation",
+      "is performed by humans. If you discover a relevant entity that",
+      "is not covered by an existing focus area, raise it in the issue",
+      "or PR discussion instead of editing the focus file."
+    );
+  }
+  return lines.join("\n");
+}
+
+// src/agent/bundles/meeting-types.ts
+var DEFAULT_AGENDA_TEMPLATE_ROOT = "<meetingsRoot>/_agenda-templates";
+function renderMeetingTypesSection(meetings) {
+  if (!meetings) {
+    return "";
+  }
+  const types = meetings.meetingTypes ?? [];
+  const areas = meetings.meetingAreas ?? [];
+  if (types.length === 0 && areas.length === 0) {
+    return "";
+  }
+  const sections = [];
+  if (types.length > 0) {
+    sections.push(renderMeetingTypes(types, meetings.agendaTemplateRoot));
+  }
+  if (areas.length > 0) {
+    sections.push(renderMeetingAreas(areas));
+  }
+  return sections.join("\n\n");
+}
+function renderMeetingTypes(types, agendaTemplateRoot) {
+  const resolvedRoot = agendaTemplateRoot ?? DEFAULT_AGENDA_TEMPLATE_ROOT;
+  const lines = [
+    "## Recognized meeting types",
+    "",
+    "This project declares a meeting-type taxonomy through",
+    "`AgentConfigOptions.meetings.meetingTypes`. When classifying a",
+    "meeting transcript, pick the `id` from this list that best fits the",
+    "meeting; do **not** invent new type identifiers. Agenda-template",
+    `paths below are resolved relative to \`${resolvedRoot}\`.`,
+    "",
+    "| ID | Label | Scope | Cadence | Default duration | Agenda template |",
+    "|----|-------|-------|---------|------------------|-----------------|"
+  ];
+  for (const type of types) {
+    const cadence = type.cadence ? `\`${type.cadence}\`` : "\u2014";
+    const duration = type.defaultDurationMinutes !== void 0 ? `${type.defaultDurationMinutes} min` : "\u2014";
+    const template = type.agendaTemplatePath ? `\`${type.agendaTemplatePath}\`` : "\u2014";
+    lines.push(
+      `| \`${type.id}\` | ${type.label} | \`${type.scope}\` | ${cadence} | ${duration} | ${template} |`
+    );
+  }
+  return lines.join("\n");
+}
+function renderMeetingAreas(areas) {
+  const lines = [
+    "## Area \u2192 doc-root mapping",
+    "",
+    "This project declares a meeting-area routing map through",
+    "`AgentConfigOptions.meetings.meetingAreas`. When a meeting note's",
+    "frontmatter carries an `area:` value matching an `id` below, route",
+    "phase-4 direct edits into the corresponding sub-tree of the docs",
+    "root (`AgentPathsConfig.docsRoot`). Meetings whose `area` does not",
+    "match any declared entry fall back to the default meetings root.",
+    "",
+    "| Area ID | Label | Doc-root sub-folder |",
+    "|---------|-------|---------------------|"
+  ];
+  for (const area of areas) {
+    lines.push(`| \`${area.id}\` | ${area.label} | \`${area.docRoot}\` |`);
+  }
+  return lines.join("\n");
+}
+
 // src/agent/bundles/priority-rules.ts
 function renderPriorityRulesSection(rules) {
   if (rules.length === 0) {
@@ -15554,6 +15740,38 @@ ${section}`
         });
       }
     }
+    if (this.options.focus) {
+      const issueLabelRule = ruleMap.get("issue-label-conventions");
+      if (issueLabelRule) {
+        const section = renderFocusSection(this.options.focus);
+        if (section.length > 0) {
+          ruleMap.set("issue-label-conventions", {
+            ...issueLabelRule,
+            content: `${issueLabelRule.content}
+
+---
+
+${section}`
+          });
+        }
+      }
+    }
+    if (this.options.meetings) {
+      const meetingRule = ruleMap.get("meeting-processing-workflow");
+      if (meetingRule) {
+        const section = renderMeetingTypesSection(this.options.meetings);
+        if (section.length > 0) {
+          ruleMap.set("meeting-processing-workflow", {
+            ...meetingRule,
+            content: `${meetingRule.content}
+
+---
+
+${section}`
+          });
+        }
+      }
+    }
     return [...ruleMap.values()].sort((a, b) => {
       if (a.name === "project-overview") return -1;
       if (b.name === "project-overview") return 1;
@@ -18365,6 +18583,8 @@ var TypeScriptConfig = class extends import_projen22.Component {
   pnpmBundle,
   prReviewBundle,
   projenBundle,
+  renderFocusSection,
+  renderMeetingTypesSection,
   renderPriorityRulesSection,
   requirementsAnalystBundle,
   requirementsReviewerBundle,