@codedrifters/configulator 0.0.239 → 0.0.241

package/lib/index.d.mts

@@ -3597,6 +3597,32 @@ declare class ProjectMetadata extends Component {
     private autoDetectRepository;
 }
 
+/**
+ * Resolve a sub-project's `outdir` from its package name.
+ *
+ * Given a scoped package name like `@codedrifters/foo`, returns
+ * `<root>/@codedrifters/foo` where `<root>` comes from
+ * {@link MONOREPO_LAYOUT}. The scope segment is preserved verbatim —
+ * including the leading `@` — so the resulting path mirrors the npm
+ * name exactly (e.g. `packages/@codedrifters/foo`).
+ *
+ * Throws when the package name is unscoped or empty. Callers must
+ * either supply a scoped name or pass `outdir` explicitly.
+ *
+ * @param packageName - The npm package name. Typically sourced from
+ *   `userOptions.packageName ?? userOptions.name` — both are valid
+ *   inputs because projen itself falls back from `packageName` to
+ *   `name` when rendering `package.json`.
+ * @param root - Which top-level monorepo folder to place the
+ *   sub-project under (e.g. `packages`, `apps`, `sites`).
+ */
+declare function resolveOutdirFromPackageName(packageName: string | undefined, root: MonorepoLayoutRoot): string;
+/**
+ * Convenience wrapper that resolves an `outdir` for a `TypeScriptProject`
+ * under the canonical `packages/` root.
+ */
+declare function resolveTypeScriptProjectOutdir(packageName: string | undefined): string;
+
 /**
  * A single Starlight social icon link.
  */
@@ -3738,4 +3764,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, type SlackMetadata, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightSidebarItem, 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, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, vitestBundle };
+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, type SlackMetadata, type StarlightEditLink, type StarlightLogo, StarlightProject, type StarlightProjectOptions, type StarlightSidebarItem, 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, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, vitestBundle };

package/lib/index.d.ts

@@ -3646,6 +3646,32 @@ declare class ProjectMetadata extends Component {
     private autoDetectRepository;
 }
 
+/**
+ * Resolve a sub-project's `outdir` from its package name.
+ *
+ * Given a scoped package name like `@codedrifters/foo`, returns
+ * `<root>/@codedrifters/foo` where `<root>` comes from
+ * {@link MONOREPO_LAYOUT}. The scope segment is preserved verbatim —
+ * including the leading `@` — so the resulting path mirrors the npm
+ * name exactly (e.g. `packages/@codedrifters/foo`).
+ *
+ * Throws when the package name is unscoped or empty. Callers must
+ * either supply a scoped name or pass `outdir` explicitly.
+ *
+ * @param packageName - The npm package name. Typically sourced from
+ *   `userOptions.packageName ?? userOptions.name` — both are valid
+ *   inputs because projen itself falls back from `packageName` to
+ *   `name` when rendering `package.json`.
+ * @param root - Which top-level monorepo folder to place the
+ *   sub-project under (e.g. `packages`, `apps`, `sites`).
+ */
+declare function resolveOutdirFromPackageName(packageName: string | undefined, root: MonorepoLayoutRoot): string;
+/**
+ * Convenience wrapper that resolves an `outdir` for a `TypeScriptProject`
+ * under the canonical `packages/` root.
+ */
+declare function resolveTypeScriptProjectOutdir(packageName: string | undefined): string;
+
 /**
  * A single Starlight social icon link.
  */
@@ -3787,5 +3813,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, StarlightProject, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, vitestBundle };
+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, StarlightProject, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, bcmWriterBundle, companyProfileBundle, formatLayoutViolation, getLatestEligibleVersion, githubWorkflowBundle, industryDiscoveryBundle, jestBundle, maintenanceAuditBundle, meetingAnalysisBundle, orchestratorBundle, peopleProfileBundle, pnpmBundle, prReviewBundle, projenBundle, requirementsAnalystBundle, requirementsReviewerBundle, requirementsWriterBundle, researchPipelineBundle, resolveModelAlias, resolveOutdirFromPackageName, resolveTemplateVariables, resolveTypeScriptProjectOutdir, slackBundle, softwareProfileBundle, turborepoBundle, typescriptBundle, validateMonorepoLayout, 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, StarlightSidebarItem, StarlightSocialLink, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };

package/lib/index.js

@@ -245,7 +245,9 @@ __export(index_exports, {
   requirementsWriterBundle: () => requirementsWriterBundle,
   researchPipelineBundle: () => researchPipelineBundle,
   resolveModelAlias: () => resolveModelAlias,
+  resolveOutdirFromPackageName: () => resolveOutdirFromPackageName,
   resolveTemplateVariables: () => resolveTemplateVariables,
+  resolveTypeScriptProjectOutdir: () => resolveTypeScriptProjectOutdir,
   slackBundle: () => slackBundle,
   softwareProfileBundle: () => softwareProfileBundle,
   turborepoBundle: () => turborepoBundle,
@@ -850,6 +852,91 @@ var baseBundle = {
       ].join("\n"),
       tags: ["workflow"]
     },
+    {
+      name: "monorepo-layout",
+      description: "Canonical monorepo top-level folders (docs, apps, packages, sites), the @ownerscope/<name> scoping rule, the docs-singleton carve-out, and the scaffolding skills that place new sub-projects",
+      scope: AGENT_RULE_SCOPE.ALWAYS,
+      content: [
+        "# Monorepo Layout",
+        "",
+        "Every monorepo built with `@codedrifters/configulator` uses a single,",
+        "fixed top-level folder layout. Agents, scaffolding skills, pnpm-workspace",
+        "globs, Turbo filters, and CI cache keys all assume these roots.",
+        "",
+        "## Four Canonical Top-Level Folders",
+        "",
+        "| Folder | Purpose | Examples |",
+        "|--------|---------|----------|",
+        "| `/docs` | **Single** Starlight site covering the entire monorepo. The one site that lives outside `/sites`. | Monorepo-wide developer docs, ADRs, how-to guides. |",
+        "| `/apps/@scope/<name>` | Deployable applications \u2014 anything that runs or ships as a running process. | AWS CDK stacks, mobile apps (iOS/Android), backend services. |",
+        "| `/packages/@scope/<name>` | Shared libraries \u2014 published npm packages and workspace-internal libraries. | `@codedrifters/configulator`, `@codedrifters/constructs`, `@codedrifters/utils`. |",
+        "| `/sites/@scope/<name>` | User-facing web front ends that are **not** the monorepo-wide docs site. | Marketing sites, SPAs, per-client static sites. |",
+        "",
+        "No other top-level folder is part of this contract. Generated roots",
+        "(`.projen/`, `.github/`, `node_modules/`, `.turbo/`, etc.) are orthogonal",
+        "and unchanged.",
+        "",
+        "## Scoping Rule",
+        "",
+        "Every sub-project under `apps/`, `packages/`, or `sites/` is named",
+        "`@ownerscope/<name>`, where **scope is the owning party** (not a category).",
+        "",
+        "- `@codedrifters/configulator` \u2014 a shared library owned by CodeDrifters \u2192 `packages/@codedrifters/configulator`",
+        "- `@codedrifters/infrastructure-stack` \u2014 an AWS CDK app owned by CodeDrifters \u2192 `apps/@codedrifters/infrastructure-stack`",
+        "- `@clientA/iphone-app` \u2014 a mobile app owned by Client A \u2192 `apps/@clientA/iphone-app`",
+        "- `@clientB/marketing-site` \u2014 a marketing site owned by Client B \u2192 `sites/@clientB/marketing-site`",
+        "",
+        "The scope identifies **who owns the sub-project**, not what kind of",
+        "sub-project it is. Kind is captured by the top-level folder (`apps/`,",
+        "`packages/`, `sites/`). Never scope by category (e.g. `@apps/foo`,",
+        "`@libs/bar`) \u2014 the top-level folder already carries that information.",
+        "",
+        "## Docs-Singleton Carve-Out",
+        "",
+        "There is **exactly one** Starlight docs site per monorepo, and it lives",
+        "at `/docs`. It is **not** `sites/@scope/docs`.",
+        "",
+        "- The docs site is monorepo-wide. Sub-project documentation belongs",
+        "  inside that single site (under `docs/content/`), not in a per-package",
+        "  `docs/` folder.",
+        "- Configulator's `StarlightProject` defaults its `outdir` to `/docs`.",
+        "- `/sites` is reserved for end-user-facing web front ends (marketing",
+        "  sites, SPAs, client-facing apps). It deliberately does not host the",
+        "  dev-docs site.",
+        "",
+        "## Project-Type \u2192 `outdir` Mapping",
+        "",
+        "Configulator project types default their `outdir` according to the",
+        "following table. Override `outdir` explicitly only when you have a",
+        "genuine reason \u2014 the defaults cover the common path.",
+        "",
+        "| Configulator project type | Default `outdir` |",
+        "|---------------------------|------------------|",
+        "| `TypeScriptProject` | `packages/<scope>/<name>` |",
+        "| `AwsCdkProject` | `apps/<scope>/<name>` |",
+        "| `AstroProject` | `sites/<scope>/<name>` |",
+        "| `StarlightProject` (role = docs) | `docs/` |",
+        "",
+        "`<scope>` is parsed from the sub-project's package name (everything",
+        "after `@` and before `/`). `<name>` is the unscoped part of the",
+        "package name.",
+        "",
+        "## Placing New Sub-Projects",
+        "",
+        "Never hand-roll a sub-project path. Use one of the scaffolding skills,",
+        "which take `@scope/<name>` as input, validate it, and place the new",
+        "project in the correct folder:",
+        "",
+        "- `/create-package` \u2014 scaffolds a new `TypeScriptProject` under `packages/<scope>/<name>`",
+        "- `/create-app` \u2014 scaffolds a new `AwsCdkProject` under `apps/<scope>/<name>`",
+        "- `/create-site` \u2014 scaffolds a new `AstroProject` under `sites/<scope>/<name>`",
+        "",
+        "The monorepo-wide docs site at `/docs` is a singleton and is created",
+        "once per repo via `StarlightProject` \u2014 it is not scaffolded per",
+        "sub-project."
+      ].join("\n"),
+      tags: ["project"]
+    },
     {
       name: "issue-conventions",
       description: "Issue title prefixes, GitHub issue type mapping, prerequisite issues",
@@ -16407,6 +16494,40 @@ var MonorepoProject = class extends import_typescript3.TypeScriptAppProject {
   }
 };
 
+// src/projects/resolve-outdir.ts
+function parseScopedName(input) {
+  if (!input.startsWith("@")) {
+    return void 0;
+  }
+  const slashIndex = input.indexOf("/");
+  if (slashIndex < 2) {
+    return void 0;
+  }
+  const scope = input.slice(0, slashIndex);
+  const name = input.slice(slashIndex + 1);
+  if (name.length === 0 || name.includes("/")) {
+    return void 0;
+  }
+  return { scope, name };
+}
+function resolveOutdirFromPackageName(packageName, root) {
+  if (packageName === void 0 || packageName.length === 0) {
+    throw new Error(
+      "Cannot derive outdir: packageName (or name) is required when outdir is omitted. Either pass a scoped `packageName` / `name` like `@scope/foo`, or set `outdir` explicitly."
+    );
+  }
+  const parsed = parseScopedName(packageName);
+  if (parsed === void 0) {
+    throw new Error(
+      `Cannot derive outdir from unscoped packageName "${packageName}". Either use a scoped name like \`@scope/foo\`, or set \`outdir\` explicitly. Configulator places sub-projects at "${root}/<scope>/<name>".`
+    );
+  }
+  return `${root}/${parsed.scope}/${parsed.name}`;
+}
+function resolveTypeScriptProjectOutdir(packageName) {
+  return resolveOutdirFromPackageName(packageName, MONOREPO_LAYOUT.PACKAGES);
+}
+
 // src/projects/typescript-project.ts
 var TestRunner = {
   JEST: "jest",
@@ -16422,6 +16543,9 @@ var TypeScriptProject = class extends import_projen16.typescript.TypeScriptProje
     const parent = userOptions.parent;
     const pnpmVersion = parent.pnpmVersion;
     const pnpmWorkspace = PnpmWorkspace.of(parent);
+    const resolvedOutdir = userOptions.outdir ?? resolveTypeScriptProjectOutdir(
+      userOptions.packageName ?? userOptions.name
+    );
     const testRunner = userOptions.testRunner ?? TestRunner.JEST;
     const useJest = testRunner === TestRunner.JEST;
     const defaultOptions = {
@@ -16429,6 +16553,12 @@ var TypeScriptProject = class extends import_projen16.typescript.TypeScriptProje
        * This is a standard, so don't require it to passed in everywhere.
        */
       defaultReleaseBranch: "main",
+      /**
+       * Outdir defaults to `packages/<scope>/<name>` when the caller
+       * omits it. Explicit overrides in `userOptions` always win via
+       * the merge below.
+       */
+      outdir: resolvedOutdir,
       /**
        * Enable reset task by default.
        */
@@ -16499,10 +16629,7 @@ var TypeScriptProject = class extends import_projen16.typescript.TypeScriptProje
        * (version, dependencies) changes.
        */
       releaseTrigger: import_release.ReleaseTrigger.continuous({
-        paths: [
-          `${userOptions.outdir}/src/**`,
-          `${userOptions.outdir}/package.json`
-        ]
+        paths: [`${resolvedOutdir}/src/**`, `${resolvedOutdir}/package.json`]
       })
     };
     const options = (0, import_ts_deepmerge2.merge)(defaultOptions, userOptions);
@@ -17546,7 +17673,9 @@ var TypeScriptConfig = class extends import_projen22.Component {
   requirementsWriterBundle,
   researchPipelineBundle,
   resolveModelAlias,
+  resolveOutdirFromPackageName,
   resolveTemplateVariables,
+  resolveTypeScriptProjectOutdir,
   slackBundle,
   softwareProfileBundle,
   turborepoBundle,