@codedrifters/configulator 0.0.155 → 0.0.156

package/lib/index.js

@@ -192,6 +192,7 @@ __export(index_exports, {
   MonorepoProject: () => MonorepoProject,
   PROD_DEPLOY_NAME: () => PROD_DEPLOY_NAME,
   PnpmWorkspace: () => PnpmWorkspace,
+  ProjectMetadata: () => ProjectMetadata,
   ROOT_CI_TASK_NAME: () => ROOT_CI_TASK_NAME,
   ROOT_TURBO_TASK_NAME: () => ROOT_TURBO_TASK_NAME,
   ResetTask: () => ResetTask,
@@ -213,6 +214,7 @@ __export(index_exports, {
   jestBundle: () => jestBundle,
   pnpmBundle: () => pnpmBundle,
   projenBundle: () => projenBundle,
+  resolveTemplateVariables: () => resolveTemplateVariables,
   turborepoBundle: () => turborepoBundle,
   typescriptBundle: () => typescriptBundle,
   vitestBundle: () => vitestBundle
@@ -220,7 +222,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/agent/agent-config.ts
-var import_projen7 = require("projen");
+var import_projen8 = require("projen");
 
 // src/agent/types.ts
 var AGENT_RULE_SCOPE = {
@@ -343,6 +345,9 @@ var baseBundle = {
       content: [
         "# Project Overview",
         "",
+        "**Repository:** {{repository.owner}}/{{repository.name}}",
+        "**Default branch:** {{repository.defaultBranch}}",
+        "",
         "## Important Notes",
         "",
         "- **Never edit generated files** \u2014 they are marked with `// ~~ Generated by projen`",
@@ -1303,8 +1308,78 @@ var BUILT_IN_BUNDLES = [
   projenBundle
 ];
 
-// src/agent/renderers/claude-renderer.ts
+// src/projects/project-metadata.ts
 var import_projen5 = require("projen");
+var import_javascript2 = require("projen/lib/javascript");
+var GITHUB_HTTPS_RE = /(?:https?:\/\/|git\+https:\/\/)github\.com\/([^/]+)\/([^/.]+)(?:\.git)?/;
+var GITHUB_SSH_RE = /git@github\.com:([^/]+)\/([^/.]+)(?:\.git)?/;
+function parseGitHubUrl(url) {
+  const httpsMatch = url.match(GITHUB_HTTPS_RE);
+  if (httpsMatch) {
+    return { owner: httpsMatch[1], name: httpsMatch[2] };
+  }
+  const sshMatch = url.match(GITHUB_SSH_RE);
+  if (sshMatch) {
+    return { owner: sshMatch[1], name: sshMatch[2] };
+  }
+  return { owner: void 0, name: void 0 };
+}
+var ProjectMetadata = class _ProjectMetadata extends import_projen5.Component {
+  /**
+   * Returns the ProjectMetadata instance for a project, or undefined
+   * if the component has not been added.
+   */
+  static of(project) {
+    const isProjectMetadata = (c) => c instanceof _ProjectMetadata;
+    return project.components.find(isProjectMetadata);
+  }
+  constructor(project, options = {}) {
+    super(project);
+    this.metadata = this.resolveMetadata(options);
+  }
+  /**
+   * Merges explicit options with auto-detected values.
+   * Auto-detection reads the repository URL from package.json
+   * (via Projen's NodePackage manifest) and parses GitHub owner/name.
+   * Explicit options always take precedence over auto-detected values.
+   */
+  resolveMetadata(options) {
+    const autoDetected = this.autoDetectRepository();
+    return {
+      repository: {
+        owner: options.repository?.owner ?? autoDetected.owner,
+        name: options.repository?.name ?? autoDetected.name,
+        defaultBranch: options.repository?.defaultBranch ?? "main"
+      },
+      githubProject: options.githubProject,
+      organization: options.organization,
+      slack: options.slack,
+      labels: options.labels,
+      milestones: options.milestones,
+      docsPath: options.docsPath,
+      deployment: options.deployment
+    };
+  }
+  /**
+   * Attempts to auto-detect repository owner and name from the Projen
+   * project's package.json repository field.
+   */
+  autoDetectRepository() {
+    if (!(this.project instanceof import_javascript2.NodeProject)) {
+      return { owner: void 0, name: void 0 };
+    }
+    const manifest = this.project.package.manifest;
+    const repoField = manifest.repository;
+    if (!repoField) {
+      return { owner: void 0, name: void 0 };
+    }
+    const url = typeof repoField === "string" ? repoField : repoField.url ?? "";
+    return parseGitHubUrl(url);
+  }
+};
+
+// src/agent/renderers/claude-renderer.ts
+var import_projen6 = require("projen");
 var import_textfile2 = require("projen/lib/textfile");
 var GENERATED_MARKER = "<!-- ~~ Generated by @codedrifters/configulator. Edits welcome \u2014 please contribute improvements back. ~~ -->";
 var ClaudeRenderer = class _ClaudeRenderer {
@@ -1465,7 +1540,7 @@ var ClaudeRenderer = class _ClaudeRenderer {
       hasContent = true;
     }
     if (!hasContent) return;
-    new import_projen5.JsonFile(component, ".claude/settings.json", { obj });
+    new import_projen6.JsonFile(component, ".claude/settings.json", { obj });
   }
   static buildSandboxObj(sandbox) {
     const obj = {};
@@ -1603,7 +1678,7 @@ var CopilotRenderer = class {
 };
 
 // src/agent/renderers/cursor-renderer.ts
-var import_projen6 = require("projen");
+var import_projen7 = require("projen");
 var import_textfile3 = require("projen/lib/textfile");
 var GENERATED_MARKER2 = "# ~~ Generated by @codedrifters/configulator. Edits welcome \u2014 please contribute improvements back. ~~";
 var CursorRenderer = class _CursorRenderer {
@@ -1698,7 +1773,7 @@ var CursorRenderer = class _CursorRenderer {
       if (config.env) server.env = { ...config.env };
       servers[name] = server;
     }
-    new import_projen6.JsonFile(component, ".cursor/mcp.json", { obj });
+    new import_projen7.JsonFile(component, ".cursor/mcp.json", { obj });
   }
   static renderHooks(component, settings) {
     if (!settings?.hooks) return;
@@ -1736,7 +1811,7 @@ var CursorRenderer = class _CursorRenderer {
     }
     if (stop?.length) hooks.stop = stop.map((h) => ({ command: h.command }));
     if (Object.keys(hooks).length === 0) return;
-    new import_projen6.JsonFile(component, ".cursor/hooks.json", {
+    new import_projen7.JsonFile(component, ".cursor/hooks.json", {
       obj: { version: 1, hooks }
     });
   }
@@ -1754,8 +1829,57 @@ var CursorRenderer = class _CursorRenderer {
   }
 };
 
+// src/agent/template-resolver.ts
+var FALLBACKS = {
+  "repository.owner": "<owner>",
+  "repository.name": "<repo>",
+  "repository.defaultBranch": "main",
+  "organization.name": "<organization>",
+  "organization.githubOrg": "<org>",
+  "githubProject.name": "<project-name>",
+  "githubProject.number": "<project-number>",
+  "githubProject.nodeId": "<project-node-id>",
+  docsPath: "<docs-path>"
+};
+var TEMPLATE_RE = /\{\{(\w+(?:\.\w+)*)\}\}/g;
+function getNestedValue(obj, path) {
+  const parts = path.split(".");
+  let current = obj;
+  for (const part of parts) {
+    if (current == null || typeof current !== "object") {
+      return void 0;
+    }
+    current = current[part];
+  }
+  if (current == null) {
+    return void 0;
+  }
+  return String(current);
+}
+function resolveTemplateVariables(template, metadata) {
+  if (!TEMPLATE_RE.test(template)) {
+    return { resolved: template, unresolvedKeys: [] };
+  }
+  const unresolvedKeys = [];
+  TEMPLATE_RE.lastIndex = 0;
+  const resolved = template.replace(TEMPLATE_RE, (_match, key) => {
+    if (metadata) {
+      const value = getNestedValue(
+        metadata,
+        key
+      );
+      if (value !== void 0) {
+        return value;
+      }
+    }
+    unresolvedKeys.push(key);
+    return FALLBACKS[key] ?? `<${key}>`;
+  });
+  return { resolved, unresolvedKeys };
+}
+
 // src/agent/agent-config.ts
-var AgentConfig = class _AgentConfig extends import_projen7.Component {
+var AgentConfig = class _AgentConfig extends import_projen8.Component {
   /**
    * Find the AgentConfig component on a project.
    */
@@ -1774,12 +1898,20 @@ var AgentConfig = class _AgentConfig extends import_projen7.Component {
     const skills = this.resolveSkills();
     const subAgents = this.resolveSubAgents();
     const mcpServers = this.options.mcpServers ?? {};
+    const projectMetadata = ProjectMetadata.of(this.project);
+    const metadata = projectMetadata?.metadata;
+    const resolvedRules = this.resolveTemplates(rules, metadata);
+    const resolvedSkills = this.resolveSkillTemplates(skills, metadata);
+    const resolvedSubAgents = this.resolveSubAgentTemplates(
+      subAgents,
+      metadata
+    );
     if (platforms.includes(AGENT_PLATFORM.CURSOR)) {
       CursorRenderer.render(
         this,
-        rules,
-        skills,
-        subAgents,
+        resolvedRules,
+        resolvedSkills,
+        resolvedSubAgents,
         mcpServers,
         this.options.cursorSettings
       );
@@ -1787,18 +1919,28 @@ var AgentConfig = class _AgentConfig extends import_projen7.Component {
     if (platforms.includes(AGENT_PLATFORM.CLAUDE)) {
       ClaudeRenderer.render(
         this,
-        rules,
-        skills,
-        subAgents,
+        resolvedRules,
+        resolvedSkills,
+        resolvedSubAgents,
         mcpServers,
         this.options.claudeSettings
       );
     }
     if (platforms.includes(AGENT_PLATFORM.CODEX)) {
-      CodexRenderer.render(this, rules, skills, subAgents);
+      CodexRenderer.render(
+        this,
+        resolvedRules,
+        resolvedSkills,
+        resolvedSubAgents
+      );
     }
     if (platforms.includes(AGENT_PLATFORM.COPILOT)) {
-      CopilotRenderer.render(this, rules, skills, subAgents);
+      CopilotRenderer.render(
+        this,
+        resolvedRules,
+        resolvedSkills,
+        resolvedSubAgents
+      );
     }
   }
   resolvePlatforms() {
@@ -1901,13 +2043,65 @@ ${extra}`
     }
     return [...agentMap.values()];
   }
+  /**
+   * Resolves template variables in rule content using project metadata.
+   * Emits synthesis warnings for rules with unresolved variables.
+   */
+  resolveTemplates(rules, metadata) {
+    return rules.map((rule) => {
+      const { resolved, unresolvedKeys } = resolveTemplateVariables(
+        rule.content,
+        metadata
+      );
+      if (unresolvedKeys.length > 0) {
+        this.project.logger.warn(
+          `AgentConfig: ProjectMetadata not found; rule '${rule.name}' using default values`
+        );
+      }
+      return resolved !== rule.content ? { ...rule, content: resolved } : rule;
+    });
+  }
+  /**
+   * Resolves template variables in skill instructions using project metadata.
+   */
+  resolveSkillTemplates(skills, metadata) {
+    return skills.map((skill) => {
+      const { resolved, unresolvedKeys } = resolveTemplateVariables(
+        skill.instructions,
+        metadata
+      );
+      if (unresolvedKeys.length > 0) {
+        this.project.logger.warn(
+          `AgentConfig: ProjectMetadata not found; skill '${skill.name}' using default values`
+        );
+      }
+      return resolved !== skill.instructions ? { ...skill, instructions: resolved } : skill;
+    });
+  }
+  /**
+   * Resolves template variables in sub-agent prompts using project metadata.
+   */
+  resolveSubAgentTemplates(subAgents, metadata) {
+    return subAgents.map((agent) => {
+      const { resolved, unresolvedKeys } = resolveTemplateVariables(
+        agent.prompt,
+        metadata
+      );
+      if (unresolvedKeys.length > 0) {
+        this.project.logger.warn(
+          `AgentConfig: ProjectMetadata not found; sub-agent '${agent.name}' using default values`
+        );
+      }
+      return resolved !== agent.prompt ? { ...agent, prompt: resolved } : agent;
+    });
+  }
 };
 
 // src/aws/aws-deployment-config.ts
 var import_node_path = require("path");
 var import_utils8 = __toESM(require_lib());
-var import_projen8 = require("projen");
-var AwsDeploymentConfig = class _AwsDeploymentConfig extends import_projen8.Component {
+var import_projen9 = require("projen");
+var AwsDeploymentConfig = class _AwsDeploymentConfig extends import_projen9.Component {
   constructor(project) {
     super(project);
     /**
@@ -2024,8 +2218,8 @@ var AwsDeploymentConfig = class _AwsDeploymentConfig extends import_projen8.Comp
 
 // src/aws/aws-deployment-target.ts
 var import_utils9 = __toESM(require_lib());
-var import_projen9 = require("projen");
-var AwsDeploymentTarget = class _AwsDeploymentTarget extends import_projen9.Component {
+var import_projen10 = require("projen");
+var AwsDeploymentTarget = class _AwsDeploymentTarget extends import_projen10.Component {
   constructor(project, options) {
     super(project);
     /**
@@ -2240,12 +2434,12 @@ var VERSION_KEYS_SKIP = [
 
 // src/jsii/jsii-faker.ts
 var spec = __toESM(require("@jsii/spec"));
-var import_projen10 = require("projen");
+var import_projen11 = require("projen");
 var ProjenBaseFqn = {
   TYPESCRIPT_PROJECT: "projen.typescript.TypeScriptProject",
   TYPESCRIPT_PROJECT_OPTIONS: "projen.typescript.TypeScriptProjectOptions"
 };
-var JsiiFaker = class _JsiiFaker extends import_projen10.Component {
+var JsiiFaker = class _JsiiFaker extends import_projen11.Component {
   constructor(project) {
     super(project);
     this.project = project;
@@ -2256,7 +2450,7 @@ var JsiiFaker = class _JsiiFaker extends import_projen10.Component {
       };
     };
     this._assemblyName = this.project.package.packageName;
-    new import_projen10.JsonFile(project, ".jsii", {
+    new import_projen11.JsonFile(project, ".jsii", {
       obj: () => {
         return {
           name: this._assemblyName,
@@ -2294,23 +2488,23 @@ var JsiiFaker = class _JsiiFaker extends import_projen10.Component {
 };
 
 // src/projects/monorepo-project.ts
-var import_javascript3 = require("projen/lib/javascript");
+var import_javascript4 = require("projen/lib/javascript");
 var import_typescript3 = require("projen/lib/typescript");
 var import_ts_deepmerge2 = require("ts-deepmerge");
 
 // src/tasks/reset-task.ts
-var import_projen12 = require("projen");
+var import_projen13 = require("projen");
 
 // src/projects/typescript-project.ts
-var import_projen11 = require("projen");
-var import_javascript2 = require("projen/lib/javascript");
+var import_projen12 = require("projen");
+var import_javascript3 = require("projen/lib/javascript");
 var import_release = require("projen/lib/release");
 var import_ts_deepmerge = require("ts-deepmerge");
 var TestRunner = {
   JEST: "jest",
   VITEST: "vitest"
 };
-var TypeScriptProject = class extends import_projen11.typescript.TypeScriptProject {
+var TypeScriptProject = class extends import_projen12.typescript.TypeScriptProject {
   constructor(userOptions) {
     const pnpmVersion = userOptions.parent && userOptions.parent instanceof MonorepoProject ? userOptions.parent.pnpmVersion : VERSION.PNPM_VERSION;
     const pnpmWorkspace = userOptions.parent && userOptions.parent instanceof MonorepoProject ? PnpmWorkspace.of(userOptions.parent) : void 0;
@@ -2328,7 +2522,7 @@ var TypeScriptProject = class extends import_projen11.typescript.TypeScriptProje
       /**
        * Packaging options
        */
-      packageManager: import_javascript2.NodePackageManager.PNPM,
+      packageManager: import_javascript3.NodePackageManager.PNPM,
       pnpmVersion,
       licensed: userOptions.license !== void 0 || false,
       copyrightOwner: "CodeDrifters",
@@ -2346,7 +2540,7 @@ var TypeScriptProject = class extends import_projen11.typescript.TypeScriptProje
           jestConfig: {
             roots: [`<rootDir>/src`],
             transform: {
-              ["^.+\\.[t]sx?$"]: new import_javascript2.Transform("@swc/jest")
+              ["^.+\\.[t]sx?$"]: new import_javascript3.Transform("@swc/jest")
             },
             moduleFileExtensions: ["js", "ts"]
           }
@@ -2381,7 +2575,7 @@ var TypeScriptProject = class extends import_projen11.typescript.TypeScriptProje
         exclude: Object.keys(pnpmWorkspace?.defaultCatalog || {}),
         ...userOptions.parent && userOptions.parent instanceof MonorepoProject ? {
           workflowOptions: {
-            schedule: import_javascript2.UpgradeDependenciesSchedule.WEEKLY
+            schedule: import_javascript3.UpgradeDependenciesSchedule.WEEKLY
           },
           cooldown: 1
         } : {}
@@ -2470,7 +2664,7 @@ var TypeScriptProject = class extends import_projen11.typescript.TypeScriptProje
 };
 
 // src/tasks/reset-task.ts
-var ResetTask = class _ResetTask extends import_projen12.Component {
+var ResetTask = class _ResetTask extends import_projen13.Component {
   constructor(project, options = {}) {
     super(project);
     this.project = project;
@@ -2543,12 +2737,12 @@ var ResetTask = class _ResetTask extends import_projen12.Component {
 };
 
 // src/vscode/vscode.ts
-var import_projen13 = require("projen");
-var VSCodeConfig = class extends import_projen13.Component {
+var import_projen14 = require("projen");
+var VSCodeConfig = class extends import_projen14.Component {
   constructor(project) {
     super(project);
-    const vsConfig = new import_projen13.vscode.VsCode(project);
-    const vsSettings = new import_projen13.vscode.VsCodeSettings(vsConfig);
+    const vsConfig = new import_projen14.vscode.VsCode(project);
+    const vsSettings = new import_projen14.vscode.VsCodeSettings(vsConfig);
     vsSettings.addSetting("editor.tabSize", 2);
     vsSettings.addSetting("editor.detectIndentation", false);
     vsSettings.addSetting("editor.bracketPairColorization.enabled", true);
@@ -2787,7 +2981,7 @@ var MonorepoProject = class extends import_typescript3.TypeScriptAppProject {
       depsUpgradeOptions: {
         exclude: ["@codedrifters/configulator"],
         workflowOptions: {
-          schedule: import_javascript3.UpgradeDependenciesSchedule.DAILY
+          schedule: import_javascript4.UpgradeDependenciesSchedule.DAILY
         },
         cooldown: 1
       },
@@ -2843,7 +3037,7 @@ var MonorepoProject = class extends import_typescript3.TypeScriptAppProject {
        * Use PNPM instead of the default (Yarn). Much of the ecosystem depends
        * on PNPM and making monorepos PNPM only simplifies many configurations.
        */
-      packageManager: import_javascript3.NodePackageManager.PNPM,
+      packageManager: import_javascript4.NodePackageManager.PNPM,
       /**
        * Some additional pre-build steps if we're using turbo's remote cache.
        * Set GIT_BRANCH_NAME so Turborepo remote cache hashes match between local and CI.
@@ -2920,6 +3114,12 @@ var MonorepoProject = class extends import_typescript3.TypeScriptAppProject {
     if (options.approveMergeUpgradeOptions) {
       addApproveMergeUpgradeWorkflow(this, options.approveMergeUpgradeOptions);
     }
+    if (options.projectMetadata !== false) {
+      new ProjectMetadata(
+        this,
+        typeof options.projectMetadata === "object" ? options.projectMetadata : {}
+      );
+    }
     if (options.agentConfig) {
       new AgentConfig(this, options.agentConfigOptions);
     }
@@ -2981,9 +3181,9 @@ var MonorepoProject = class extends import_typescript3.TypeScriptAppProject {
 
 // src/typescript/typescript-config.ts
 var import_node_path2 = require("path");
-var import_projen14 = require("projen");
+var import_projen15 = require("projen");
 var import_path2 = require("projen/lib/util/path");
-var TypeScriptConfig = class extends import_projen14.Component {
+var TypeScriptConfig = class extends import_projen15.Component {
   constructor(project) {
     super(project);
     let tsPaths = {};
@@ -3011,12 +3211,12 @@ var TypeScriptConfig = class extends import_projen14.Component {
 
 // src/workflows/aws-deploy-workflow.ts
 var import_utils10 = __toESM(require_lib());
-var import_projen15 = require("projen");
+var import_projen16 = require("projen");
 var import_build = require("projen/lib/build");
 var import_github = require("projen/lib/github");
 var import_workflows_model4 = require("projen/lib/github/workflows-model");
 var PROD_DEPLOY_NAME = "prod-deploy";
-var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen15.Component {
+var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen16.Component {
   constructor(project, options = {}) {
     super(project);
     this.project = project;
@@ -3298,6 +3498,7 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen15.Compone
   MonorepoProject,
   PROD_DEPLOY_NAME,
   PnpmWorkspace,
+  ProjectMetadata,
   ROOT_CI_TASK_NAME,
   ROOT_TURBO_TASK_NAME,
   ResetTask,
@@ -3319,6 +3520,7 @@ var AwsDeployWorkflow = class _AwsDeployWorkflow extends import_projen15.Compone
   jestBundle,
   pnpmBundle,
   projenBundle,
+  resolveTemplateVariables,
   turborepoBundle,
   typescriptBundle,
   vitestBundle