@codedrifters/configulator 0.0.244 → 0.0.245

package/lib/index.d.mts

@@ -1534,6 +1534,14 @@ interface ResolvedProjectMetadata {
     readonly milestones?: ReadonlyArray<string>;
     readonly docsPath?: string;
     readonly deployment?: DeploymentMetadata;
+    /**
+     * Markdown block appended to the `project-context` maintainer seed
+     * template. Resolved to the grouped sub-project list skeleton when
+     * the root project is a `MonorepoProject` with layout enforcement
+     * on (`layoutEnforcement !== "off"`); empty otherwise. Consumed by
+     * the `{{monorepoLayoutSeedBlock}}` template variable.
+     */
+    readonly monorepoLayoutSeedBlock?: string;
 }
 
 /**
@@ -3636,6 +3644,19 @@ declare class ProjectMetadata extends Component {
      * Explicit options always take precedence over auto-detected values.
      */
     private resolveMetadata;
+    /**
+     * Return the maintainer-seed addendum for the `project-context`
+     * bundle, or an empty string when the root project either has no
+     * layout-enforcement opinion or has opted out (`layoutEnforcement:
+     * "off"`).
+     *
+     * Uses duck-typing on the root project's `layoutEnforcement`
+     * property to avoid a circular import with `MonorepoProject`. The
+     * concrete `MonorepoProject` class exposes this property as a
+     * string; anything else resolves to the empty string so repos that
+     * predate the monorepo layout contract see no change.
+     */
+    private resolveMonorepoLayoutSeedBlock;
     /**
      * Attempts to auto-detect repository owner and name from the Projen
      * project's package.json repository field.

package/lib/index.d.ts

@@ -1583,6 +1583,14 @@ interface ResolvedProjectMetadata {
     readonly milestones?: ReadonlyArray<string>;
     readonly docsPath?: string;
     readonly deployment?: DeploymentMetadata;
+    /**
+     * Markdown block appended to the `project-context` maintainer seed
+     * template. Resolved to the grouped sub-project list skeleton when
+     * the root project is a `MonorepoProject` with layout enforcement
+     * on (`layoutEnforcement !== "off"`); empty otherwise. Consumed by
+     * the `{{monorepoLayoutSeedBlock}}` template variable.
+     */
+    readonly monorepoLayoutSeedBlock?: string;
 }
 
 /**
@@ -3685,6 +3693,19 @@ declare class ProjectMetadata extends Component {
      * Explicit options always take precedence over auto-detected values.
      */
     private resolveMetadata;
+    /**
+     * Return the maintainer-seed addendum for the `project-context`
+     * bundle, or an empty string when the root project either has no
+     * layout-enforcement opinion or has opted out (`layoutEnforcement:
+     * "off"`).
+     *
+     * Uses duck-typing on the root project's `layoutEnforcement`
+     * property to avoid a circular import with `MonorepoProject`. The
+     * concrete `MonorepoProject` class exposes this property as a
+     * string; anything else resolves to the empty string so repos that
+     * predate the monorepo layout contract see no change.
+     */
+    private resolveMonorepoLayoutSeedBlock;
     /**
      * Attempts to auto-detect repository owner and name from the Projen
      * project's package.json repository field.

package/lib/index.js

@@ -997,6 +997,28 @@ var baseBundle = {
 
 // src/agent/bundles/project-context.ts
 var PROJECT_CONTEXT_PATH = "docs/project-context.md";
+var SUBPROJECT_ROLE_GUIDANCE = [
+  "### Sub-project roles",
+  "",
+  "When the repository follows the configulator monorepo layout,",
+  "every sub-project's role is derivable from the first segment of",
+  "its `outdir` path. No other lookup is required.",
+  "",
+  "- `apps/<scope>/<name>` \u2014 deployable application (CDK stack,",
+  "  mobile app, backend service).",
+  "- `packages/<scope>/<name>` \u2014 shared library (published npm",
+  "  package or workspace-internal library).",
+  "- `sites/<scope>/<name>` \u2014 user-facing web front end that is",
+  "  not the monorepo-wide docs site.",
+  "- `docs/` \u2014 the single Starlight documentation site for the",
+  "  whole monorepo (exactly one per repo; lives at `/docs`, not",
+  "  under `sites/`).",
+  "",
+  "Repositories that have not adopted the layout contract may use a",
+  "different folder structure \u2014 in that case fall back to whatever",
+  `\`${PROJECT_CONTEXT_PATH}\` documents explicitly.`,
+  ""
+];
 var PROJECT_CONTEXT_READER_SECTION = [
   "## Project Context",
   "",
@@ -1011,6 +1033,7 @@ var PROJECT_CONTEXT_READER_SECTION = [
   "",
   "You are a **read-only consumer** of this file. Do not edit it.",
   "",
+  ...SUBPROJECT_ROLE_GUIDANCE,
   "---",
   ""
 ];
@@ -1023,6 +1046,7 @@ var PROJECT_CONTEXT_MAINTAINER_SECTION = [
   "key stakeholders. Use it to judge relevance when scanning source",
   "material in this session.",
   "",
+  ...SUBPROJECT_ROLE_GUIDANCE,
   "### Seed on first use",
   "",
   `If \`${PROJECT_CONTEXT_PATH}\` does not exist, create it from this`,
@@ -1052,7 +1076,7 @@ var PROJECT_CONTEXT_MAINTAINER_SECTION = [
   "",
   "## Key Stakeholders",
   "TODO: named people or teams and what they care about.",
-  "",
+  "{{monorepoLayoutSeedBlock}}",
   "## References",
   "TODO: links to BCM docs, competitive analysis, product roadmap, and",
   "other authoritative sources.",
@@ -1077,6 +1101,26 @@ var PROJECT_CONTEXT_MAINTAINER_SECTION = [
   "---",
   ""
 ];
+var MONOREPO_LAYOUT_SEED_BLOCK = [
+  "",
+  "## Sub-Projects",
+  "",
+  "TODO: one bullet per sub-project, grouped by role. The role is",
+  "derivable from the first segment of each sub-project's `outdir`.",
+  "",
+  "### Applications (`apps/`)",
+  "TODO: deployable applications (CDK stacks, mobile apps, services).",
+  "",
+  "### Packages (`packages/`)",
+  "TODO: shared libraries (published npm packages, workspace-internal libraries).",
+  "",
+  "### Sites (`sites/`)",
+  "TODO: user-facing web front ends (marketing sites, SPAs, client apps).",
+  "",
+  "### Docs (`docs/`)",
+  "TODO: the single monorepo-wide Starlight documentation site.",
+  ""
+].join("\n");
 
 // src/agent/bundles/bcm-writer.ts
 var bcmWriterSubAgent = {
@@ -12603,9 +12647,30 @@ var ProjectMetadata = class _ProjectMetadata extends import_projen2.Component {
       labels: options.labels,
       milestones: options.milestones,
       docsPath: options.docsPath,
-      deployment: options.deployment
+      deployment: options.deployment,
+      monorepoLayoutSeedBlock: this.resolveMonorepoLayoutSeedBlock()
     };
   }
+  /**
+   * Return the maintainer-seed addendum for the `project-context`
+   * bundle, or an empty string when the root project either has no
+   * layout-enforcement opinion or has opted out (`layoutEnforcement:
+   * "off"`).
+   *
+   * Uses duck-typing on the root project's `layoutEnforcement`
+   * property to avoid a circular import with `MonorepoProject`. The
+   * concrete `MonorepoProject` class exposes this property as a
+   * string; anything else resolves to the empty string so repos that
+   * predate the monorepo layout contract see no change.
+   */
+  resolveMonorepoLayoutSeedBlock() {
+    const root = this.project.root;
+    const enforcement = root.layoutEnforcement;
+    if (typeof enforcement !== "string" || enforcement === "off") {
+      return "";
+    }
+    return MONOREPO_LAYOUT_SEED_BLOCK;
+  }
   /**
    * Attempts to auto-detect repository owner and name from the Projen
    * project's package.json repository field.
@@ -14625,7 +14690,12 @@ var FALLBACKS = {
   "githubProject.name": "<project-name>",
   "githubProject.number": "<project-number>",
   "githubProject.nodeId": "<project-node-id>",
-  docsPath: "<docs-path>"
+  docsPath: "<docs-path>",
+  // The monorepo-layout seed block is additive: when absent, the
+  // seeded `project-context.md` template reads cleanly without it.
+  // Fall back to an empty string so no placeholder text leaks into
+  // rendered prompts for repos that predate the layout contract.
+  monorepoLayoutSeedBlock: ""
 };
 var TEMPLATE_RE = /\{\{(\w+(?:\.\w+)*)\}\}/g;
 function getNestedValue(obj, path2) {