@codedrifters/configulator 0.0.252 → 0.0.254

package/lib/index.d.mts

@@ -846,6 +846,85 @@ interface ClaudeSettingsConfig {
      */
     readonly respectGitignore?: boolean;
 }
+/*******************************************************************************
+ *
+ * Agent Paths Config
+ *
+ ******************************************************************************/
+/**
+ * Consumer-facing overrides for the output-path roots used by agent
+ * bundles. Every field is optional; unset fields cascade from their
+ * parent root (resolved by `resolveAgentPaths()` in
+ * `./bundles/paths.ts`).
+ *
+ * Bundles read these values indirectly through `DEFAULT_AGENT_PATHS`
+ * (module-eval-time defaults) today. Per-project propagation through
+ * `AgentConfig.resolveRules` lands in a follow-up change.
+ */
+interface AgentPathsConfig {
+    /**
+     * Root folder for the monorepo-wide Starlight docs site content.
+     * @default "docs/src/content/docs"
+     */
+    readonly docsRoot?: string;
+    /**
+     * Root folder for all research outputs (scopes, slices,
+     * deliverables) produced by the `research-analyst` pipeline.
+     * @default "docs/research"
+     */
+    readonly researchRoot?: string;
+    /**
+     * Root folder for profile documents (people, companies, software,
+     * industries).
+     * @default "<docsRoot>/profiles"
+     */
+    readonly profilesRoot?: string;
+    /**
+     * Root folder for meeting notes and transcripts produced by the
+     * `meeting-analyst` pipeline.
+     * @default "<docsRoot>/meetings"
+     */
+    readonly meetingsRoot?: string;
+    /**
+     * Root folder for final requirement documents produced by the
+     * `requirements-writer` agent.
+     * @default "<docsRoot>/requirements"
+     */
+    readonly requirementsRoot?: string;
+    /**
+     * Root folder where the `requirements-analyst` writes requirement
+     * proposals before they are promoted into the final requirements
+     * tree.
+     * @default "<researchRoot>/requirements"
+     */
+    readonly researchRequirementsRoot?: string;
+    /**
+     * Root folder for BCM (Business Capability Model) capability-model
+     * documents produced by the `bcm-writer` agent.
+     * @default "<docsRoot>/concepts"
+     */
+    readonly bcmRoot?: string;
+    /**
+     * Root folder for people profiles.
+     * @default "<profilesRoot>/people"
+     */
+    readonly peopleRoot?: string;
+    /**
+     * Root folder for company profiles.
+     * @default "<profilesRoot>/companies"
+     */
+    readonly companiesRoot?: string;
+    /**
+     * Root folder for software profiles.
+     * @default "<profilesRoot>/software"
+     */
+    readonly softwareRoot?: string;
+    /**
+     * Root folder for industry profiles.
+     * @default "<profilesRoot>/industries"
+     */
+    readonly industriesRoot?: string;
+}
 /*******************************************************************************
  *
  * AgentConfig Options
@@ -932,6 +1011,18 @@ interface AgentConfigOptions {
      * file visibility control.
      */
     readonly cursorSettings?: CursorSettingsConfig;
+    /**
+     * Overrides for the output-path roots used by agent bundles
+     * (requirements, BCM, profiles, meetings, research). Unset fields
+     * fall back to the defaults captured in
+     * `bundles/paths.ts#DEFAULT_AGENT_PATHS`.
+     *
+     * This option is the first of the Group A framework injection
+     * points from epic #414. Per-project propagation of these values
+     * into bundle rule content lands in a follow-up — setting it today
+     * does not yet alter generated rules.
+     */
+    readonly paths?: AgentPathsConfig;
 }
 
 /**
@@ -1119,6 +1210,56 @@ declare const meetingAnalysisBundle: AgentRuleBundle;
  ******************************************************************************/
 declare const orchestratorBundle: AgentRuleBundle;
 
+/**
+ * Fully-resolved agent output-path roots. Every property is required.
+ *
+ * This is the shape that bundle code consumes at module-eval time via
+ * `DEFAULT_AGENT_PATHS`, and the shape that `resolveAgentPaths()`
+ * returns when consumers supply a partial `AgentPathsConfig` override.
+ */
+interface ResolvedAgentPaths {
+    readonly docsRoot: string;
+    readonly researchRoot: string;
+    readonly profilesRoot: string;
+    readonly meetingsRoot: string;
+    readonly requirementsRoot: string;
+    readonly researchRequirementsRoot: string;
+    readonly bcmRoot: string;
+    readonly peopleRoot: string;
+    readonly companiesRoot: string;
+    readonly softwareRoot: string;
+    readonly industriesRoot: string;
+}
+/**
+ * Canonical default values for every agent path. These mirror the
+ * hardcoded paths that bundles used before `AgentPathsConfig` existed,
+ * so `DEFAULT_AGENT_PATHS.*` can be substituted into bundle rule
+ * content at module-eval time without changing the generated
+ * `.claude/rules/*.md` snapshot.
+ *
+ * Consumers override the defaults by passing an `AgentPathsConfig`
+ * through `AgentConfigOptions.paths` and resolving it with
+ * `resolveAgentPaths()`. Per-project propagation into bundle rule
+ * content is a follow-up — this export is the first step: interface +
+ * resolver land in this PR; the `AgentConfig.resolveRules` wiring lands
+ * next.
+ */
+declare const DEFAULT_AGENT_PATHS: ResolvedAgentPaths;
+/**
+ * Resolve a partial `AgentPathsConfig` into a fully-populated
+ * `ResolvedAgentPaths`. Unset fields cascade from their parent root:
+ *
+ * - `profilesRoot`, `meetingsRoot`, `requirementsRoot`, and `bcmRoot`
+ *   derive from `docsRoot` when not explicitly set.
+ * - `researchRequirementsRoot` derives from `researchRoot` when not
+ *   explicitly set.
+ * - `peopleRoot`, `companiesRoot`, `softwareRoot`, and `industriesRoot`
+ *   derive from the resolved `profilesRoot` when not explicitly set,
+ *   so that overriding `docsRoot` alone (or overriding `profilesRoot`
+ *   alone) propagates correctly through every dependent root.
+ */
+declare function resolveAgentPaths(paths?: AgentPathsConfig): ResolvedAgentPaths;
+
 /**
  * People-profile bundle — enabled by default.
  *
@@ -2018,7 +2159,7 @@ declare const VERSION: {
     /**
      * Version of Astro to pin for AstroProject scaffolding.
      */
-    readonly ASTRO_VERSION: "6.1.7";
+    readonly ASTRO_VERSION: "6.1.8";
     /**
      * CDK CLI for workflows and command line operations.
      *
@@ -3876,4 +4017,4 @@ declare const COMPLETE_JOB_ID = "complete";
  */
 declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
 
-export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedProjectMetadata, STARLIGHT_ROLE, type SlackMetadata, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightRole, type StarlightSidebarItem, type StarlightSingletonViolation, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, validateStarlightSingleton, vitestBundle };
+export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPathsConfig, type AgentPlatform, type AgentPlatformOverrides, type AgentProcedure, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, AstroConfig, type AstroConfigOptions, type AstroIntegrationSpec, AstroOutput, AstroProject, type AstroProjectOptions, type AwsAccount, AwsCdkProject, type AwsCdkProjectOptions, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, AwsTeardownWorkflow, type AwsTeardownWorkflowOptions, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, type CiDeploymentConfig, type ClassTypeOptions, type ClaudeAutoModeConfig, type ClaudeHookAction, type ClaudeHookEntry, type ClaudeHooksConfig, type ClaudePermissionsConfig, type ClaudeRuleTarget, type ClaudeSandboxConfig, type ClaudeSettingsConfig, type CopilotHandoff, type CursorHookAction, type CursorHooksConfig, type CursorSettingsConfig, DEFAULT_AGENT_PATHS, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TEARDOWN_BRANCH_PATTERNS, DEFAULT_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, LAYOUT_ENFORCEMENT, LAYOUT_ROOT_BY_PROJECT_TYPE, type LabelDefinition, type LayoutEnforcement, type LayoutViolation, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MONOREPO_LAYOUT, type McpServerConfig, type McpTransport, type MergeMethod, type MonorepoLayoutRoot, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, REQUIREMENTS_WRITER_PATHS, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedAgentPaths, type ResolvedProjectMetadata, STARLIGHT_ROLE, type SlackMetadata, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightRole, type StarlightSidebarItem, type StarlightSingletonViolation, type StarlightSocialLink, type SyncLabelsOptions, type TemplateResolveResult, TestRunner, TurboRepo, type TurboRepoOptions, TurboRepoTask, type TurboRepoTaskOptions, TypeScriptConfig, TypeScriptProject, type TypeScriptProjectOptions, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, type VersionKey, Vitest, type VitestConfigOptions, type VitestOptions, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, formatStarlightSingletonViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAgentPaths, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, validateStarlightSingleton, vitestBundle };

package/lib/index.d.ts

@@ -895,6 +895,85 @@ interface ClaudeSettingsConfig {
      */
     readonly respectGitignore?: boolean;
 }
+/*******************************************************************************
+ *
+ * Agent Paths Config
+ *
+ ******************************************************************************/
+/**
+ * Consumer-facing overrides for the output-path roots used by agent
+ * bundles. Every field is optional; unset fields cascade from their
+ * parent root (resolved by `resolveAgentPaths()` in
+ * `./bundles/paths.ts`).
+ *
+ * Bundles read these values indirectly through `DEFAULT_AGENT_PATHS`
+ * (module-eval-time defaults) today. Per-project propagation through
+ * `AgentConfig.resolveRules` lands in a follow-up change.
+ */
+interface AgentPathsConfig {
+    /**
+     * Root folder for the monorepo-wide Starlight docs site content.
+     * @default "docs/src/content/docs"
+     */
+    readonly docsRoot?: string;
+    /**
+     * Root folder for all research outputs (scopes, slices,
+     * deliverables) produced by the `research-analyst` pipeline.
+     * @default "docs/research"
+     */
+    readonly researchRoot?: string;
+    /**
+     * Root folder for profile documents (people, companies, software,
+     * industries).
+     * @default "<docsRoot>/profiles"
+     */
+    readonly profilesRoot?: string;
+    /**
+     * Root folder for meeting notes and transcripts produced by the
+     * `meeting-analyst` pipeline.
+     * @default "<docsRoot>/meetings"
+     */
+    readonly meetingsRoot?: string;
+    /**
+     * Root folder for final requirement documents produced by the
+     * `requirements-writer` agent.
+     * @default "<docsRoot>/requirements"
+     */
+    readonly requirementsRoot?: string;
+    /**
+     * Root folder where the `requirements-analyst` writes requirement
+     * proposals before they are promoted into the final requirements
+     * tree.
+     * @default "<researchRoot>/requirements"
+     */
+    readonly researchRequirementsRoot?: string;
+    /**
+     * Root folder for BCM (Business Capability Model) capability-model
+     * documents produced by the `bcm-writer` agent.
+     * @default "<docsRoot>/concepts"
+     */
+    readonly bcmRoot?: string;
+    /**
+     * Root folder for people profiles.
+     * @default "<profilesRoot>/people"
+     */
+    readonly peopleRoot?: string;
+    /**
+     * Root folder for company profiles.
+     * @default "<profilesRoot>/companies"
+     */
+    readonly companiesRoot?: string;
+    /**
+     * Root folder for software profiles.
+     * @default "<profilesRoot>/software"
+     */
+    readonly softwareRoot?: string;
+    /**
+     * Root folder for industry profiles.
+     * @default "<profilesRoot>/industries"
+     */
+    readonly industriesRoot?: string;
+}
 /*******************************************************************************
  *
  * AgentConfig Options
@@ -981,6 +1060,18 @@ interface AgentConfigOptions {
      * file visibility control.
      */
     readonly cursorSettings?: CursorSettingsConfig;
+    /**
+     * Overrides for the output-path roots used by agent bundles
+     * (requirements, BCM, profiles, meetings, research). Unset fields
+     * fall back to the defaults captured in
+     * `bundles/paths.ts#DEFAULT_AGENT_PATHS`.
+     *
+     * This option is the first of the Group A framework injection
+     * points from epic #414. Per-project propagation of these values
+     * into bundle rule content lands in a follow-up — setting it today
+     * does not yet alter generated rules.
+     */
+    readonly paths?: AgentPathsConfig;
 }
 
 /**
@@ -1168,6 +1259,56 @@ declare const meetingAnalysisBundle: AgentRuleBundle;
  ******************************************************************************/
 declare const orchestratorBundle: AgentRuleBundle;
 
+/**
+ * Fully-resolved agent output-path roots. Every property is required.
+ *
+ * This is the shape that bundle code consumes at module-eval time via
+ * `DEFAULT_AGENT_PATHS`, and the shape that `resolveAgentPaths()`
+ * returns when consumers supply a partial `AgentPathsConfig` override.
+ */
+interface ResolvedAgentPaths {
+    readonly docsRoot: string;
+    readonly researchRoot: string;
+    readonly profilesRoot: string;
+    readonly meetingsRoot: string;
+    readonly requirementsRoot: string;
+    readonly researchRequirementsRoot: string;
+    readonly bcmRoot: string;
+    readonly peopleRoot: string;
+    readonly companiesRoot: string;
+    readonly softwareRoot: string;
+    readonly industriesRoot: string;
+}
+/**
+ * Canonical default values for every agent path. These mirror the
+ * hardcoded paths that bundles used before `AgentPathsConfig` existed,
+ * so `DEFAULT_AGENT_PATHS.*` can be substituted into bundle rule
+ * content at module-eval time without changing the generated
+ * `.claude/rules/*.md` snapshot.
+ *
+ * Consumers override the defaults by passing an `AgentPathsConfig`
+ * through `AgentConfigOptions.paths` and resolving it with
+ * `resolveAgentPaths()`. Per-project propagation into bundle rule
+ * content is a follow-up — this export is the first step: interface +
+ * resolver land in this PR; the `AgentConfig.resolveRules` wiring lands
+ * next.
+ */
+declare const DEFAULT_AGENT_PATHS: ResolvedAgentPaths;
+/**
+ * Resolve a partial `AgentPathsConfig` into a fully-populated
+ * `ResolvedAgentPaths`. Unset fields cascade from their parent root:
+ *
+ * - `profilesRoot`, `meetingsRoot`, `requirementsRoot`, and `bcmRoot`
+ *   derive from `docsRoot` when not explicitly set.
+ * - `researchRequirementsRoot` derives from `researchRoot` when not
+ *   explicitly set.
+ * - `peopleRoot`, `companiesRoot`, `softwareRoot`, and `industriesRoot`
+ *   derive from the resolved `profilesRoot` when not explicitly set,
+ *   so that overriding `docsRoot` alone (or overriding `profilesRoot`
+ *   alone) propagates correctly through every dependent root.
+ */
+declare function resolveAgentPaths(paths?: AgentPathsConfig): ResolvedAgentPaths;
+
 /**
  * People-profile bundle — enabled by default.
  *
@@ -2067,7 +2208,7 @@ declare const VERSION: {
     /**
      * Version of Astro to pin for AstroProject scaffolding.
      */
-    readonly ASTRO_VERSION: "6.1.7";
+    readonly ASTRO_VERSION: "6.1.8";
     /**
      * CDK CLI for workflows and command line operations.
      *
@@ -3925,5 +4066,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_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, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveAstroProjectOutdir, resolveAwsCdkProjectOutdir, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, validateStarlightSingleton, vitestBundle };
-export type { AgentConfigOptions, AgentModel, 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, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, 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, 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, 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

@@ -190,6 +190,7 @@ __export(index_exports, {
   BUILT_IN_BUNDLES: () => BUILT_IN_BUNDLES,
   CLAUDE_RULE_TARGET: () => CLAUDE_RULE_TARGET,
   COMPLETE_JOB_ID: () => COMPLETE_JOB_ID,
+  DEFAULT_AGENT_PATHS: () => DEFAULT_AGENT_PATHS,
   DEFAULT_PRIORITY_LABELS: () => DEFAULT_PRIORITY_LABELS,
   DEFAULT_STATUS_LABELS: () => DEFAULT_STATUS_LABELS,
   DEFAULT_TEARDOWN_BRANCH_PATTERNS: () => DEFAULT_TEARDOWN_BRANCH_PATTERNS,
@@ -246,6 +247,7 @@ __export(index_exports, {
   requirementsReviewerBundle: () => requirementsReviewerBundle,
   requirementsWriterBundle: () => requirementsWriterBundle,
   researchPipelineBundle: () => researchPipelineBundle,
+  resolveAgentPaths: () => resolveAgentPaths,
   resolveAstroProjectOutdir: () => resolveAstroProjectOutdir,
   resolveAwsCdkProjectOutdir: () => resolveAwsCdkProjectOutdir,
   resolveModelAlias: () => resolveModelAlias,
@@ -1432,6 +1434,47 @@ var baseBundle = {
   ]
 };
 
+// src/agent/bundles/paths.ts
+var DEFAULT_AGENT_PATHS = Object.freeze({
+  docsRoot: "docs/src/content/docs",
+  researchRoot: "docs/research",
+  profilesRoot: "docs/src/content/docs/profiles",
+  meetingsRoot: "docs/src/content/docs/meetings",
+  requirementsRoot: "docs/src/content/docs/requirements",
+  researchRequirementsRoot: "docs/research/requirements",
+  bcmRoot: "docs/src/content/docs/concepts",
+  peopleRoot: "docs/src/content/docs/profiles/people",
+  companiesRoot: "docs/src/content/docs/profiles/companies",
+  softwareRoot: "docs/src/content/docs/profiles/software",
+  industriesRoot: "docs/src/content/docs/profiles/industries"
+});
+function resolveAgentPaths(paths) {
+  const docsRoot = paths?.docsRoot ?? DEFAULT_AGENT_PATHS.docsRoot;
+  const researchRoot = paths?.researchRoot ?? DEFAULT_AGENT_PATHS.researchRoot;
+  const profilesRoot = paths?.profilesRoot ?? `${docsRoot}/profiles`;
+  const meetingsRoot = paths?.meetingsRoot ?? `${docsRoot}/meetings`;
+  const requirementsRoot = paths?.requirementsRoot ?? `${docsRoot}/requirements`;
+  const bcmRoot = paths?.bcmRoot ?? `${docsRoot}/concepts`;
+  const researchRequirementsRoot = paths?.researchRequirementsRoot ?? `${researchRoot}/requirements`;
+  const peopleRoot = paths?.peopleRoot ?? `${profilesRoot}/people`;
+  const companiesRoot = paths?.companiesRoot ?? `${profilesRoot}/companies`;
+  const softwareRoot = paths?.softwareRoot ?? `${profilesRoot}/software`;
+  const industriesRoot = paths?.industriesRoot ?? `${profilesRoot}/industries`;
+  return {
+    docsRoot,
+    researchRoot,
+    profilesRoot,
+    meetingsRoot,
+    requirementsRoot,
+    researchRequirementsRoot,
+    bcmRoot,
+    peopleRoot,
+    companiesRoot,
+    softwareRoot,
+    industriesRoot
+  };
+}
+
 // src/agent/bundles/project-context.ts
 var PROJECT_CONTEXT_PATH = "docs/src/content/docs/project-context.md";
 var SUBPROJECT_ROLE_GUIDANCE = [
@@ -1677,7 +1720,7 @@ var bcmWriterSubAgent = {
     "",
     "| Placeholder | Meaning | Default |",
     "|-------------|---------|---------|",
-    "| `<BCM_DOC_ROOT>` | Root folder for all BCM capability-model documents | `docs/src/content/docs/concepts/` |",
+    `| \`<BCM_DOC_ROOT>\` | Root folder for all BCM capability-model documents | \`${DEFAULT_AGENT_PATHS.bcmRoot}/\` |`,
     "| `<OUTLINE_ROOT>` | Working-directory root for outline files produced in Phase 1 | `docs/src/content/docs/concepts/.outlines/` |",
     "| `<REGISTRY_INDEX>` | Capability registry `_index.md` file that lists every BCM doc | `<BCM_DOC_ROOT>/_index.md` |",
     "| `<CAPABILITY_MAP>` | Capability-map file that shows the L1/L2/L3 hierarchy | `<BCM_DOC_ROOT>/capability-map.md` |",
@@ -12642,7 +12685,7 @@ var researchAnalystSubAgent = {
     "",
     "| Placeholder | Meaning | Default |",
     "|-------------|---------|---------|",
-    "| `<RESEARCH_ROOT>` | Root folder for all research outputs | `docs/research/` |",
+    `| \`<RESEARCH_ROOT>\` | Root folder for all research outputs | \`${DEFAULT_AGENT_PATHS.researchRoot}/\` |`,
     "| `<SCOPE_DIR>` | Scope files | `<RESEARCH_ROOT>/scopes/` |",
     "| `<SLICES_DIR>` | Slice note files | `<RESEARCH_ROOT>/slices/` |",
     "| `<DELIVERABLES_DIR>` | Final verified deliverables | `<RESEARCH_ROOT>/deliverables/` |",
@@ -14324,7 +14367,7 @@ var VERSION = {
   /**
    * Version of Astro to pin for AstroProject scaffolding.
    */
-  ASTRO_VERSION: "6.1.7",
+  ASTRO_VERSION: "6.1.8",
   /**
    * CDK CLI for workflows and command line operations.
    *
@@ -18215,6 +18258,7 @@ var TypeScriptConfig = class extends import_projen22.Component {
   BUILT_IN_BUNDLES,
   CLAUDE_RULE_TARGET,
   COMPLETE_JOB_ID,
+  DEFAULT_AGENT_PATHS,
   DEFAULT_PRIORITY_LABELS,
   DEFAULT_STATUS_LABELS,
   DEFAULT_TEARDOWN_BRANCH_PATTERNS,
@@ -18271,6 +18315,7 @@ var TypeScriptConfig = class extends import_projen22.Component {
   requirementsReviewerBundle,
   requirementsWriterBundle,
   researchPipelineBundle,
+  resolveAgentPaths,
   resolveAstroProjectOutdir,
   resolveAwsCdkProjectOutdir,
   resolveModelAlias,