@codedrifters/configulator 0.0.182 → 0.0.184

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/lib/index.d.mts CHANGED
@@ -51,6 +51,12 @@ declare const AGENT_MODEL: {
51
51
  readonly POWERFUL: "powerful";
52
52
  };
53
53
  type AgentModel = (typeof AGENT_MODEL)[keyof typeof AGENT_MODEL];
54
+ /**
55
+ * Maps abstract AGENT_MODEL values to Claude Code model aliases.
56
+ * Returns undefined for "inherit" (omit the field entirely).
57
+ * Cursor omits the model field to use its default model selection.
58
+ */
59
+ declare function resolveModelAlias(model: string | undefined): string | undefined;
54
60
  /**
55
61
  * MCP server transport type.
56
62
  */
@@ -209,6 +215,15 @@ interface AgentSkill {
209
215
  * @default 'bash'
210
216
  */
211
217
  readonly shell?: string;
218
+ /** Per-platform overrides. Use `exclude: true` to skip a platform. */
219
+ readonly platforms?: {
220
+ readonly claude?: {
221
+ readonly exclude?: boolean;
222
+ };
223
+ readonly cursor?: {
224
+ readonly exclude?: boolean;
225
+ };
226
+ };
212
227
  }
213
228
  /**
214
229
  * Platform-specific overrides for a sub-agent definition.
@@ -327,6 +342,21 @@ interface AgentSubAgent {
327
342
  /** Optional per-platform overrides for this sub-agent. */
328
343
  readonly platforms?: AgentSubAgentPlatformOverrides;
329
344
  }
345
+ /**
346
+ * An executable procedure (shell script) that ships with a bundle.
347
+ * Rendered to .claude/procedures/{name} as an executable file.
348
+ */
349
+ interface AgentProcedure {
350
+ /**
351
+ * Filename for the procedure (e.g., 'check-blocked.sh').
352
+ * Used as the filename in .claude/procedures/.
353
+ */
354
+ readonly name: string;
355
+ /** Human-readable description of what this procedure does. */
356
+ readonly description: string;
357
+ /** Script content as a single string. Lines are split on newlines for rendering. */
358
+ readonly content: string;
359
+ }
330
360
  /**
331
361
  * MCP server configuration. Cross-platform — rendered to .claude/settings.json
332
362
  * (Claude Code) and .cursor/mcp.json (Cursor).
@@ -407,6 +437,8 @@ interface AgentRuleBundle {
407
437
  readonly skills?: ReadonlyArray<AgentSkill>;
408
438
  /** Sub-agents included in this bundle. */
409
439
  readonly subAgents?: ReadonlyArray<AgentSubAgent>;
440
+ /** Executable procedures (shell scripts) included in this bundle. */
441
+ readonly procedures?: ReadonlyArray<AgentProcedure>;
410
442
  /**
411
443
  * Claude Code permission entries contributed by this bundle.
412
444
  * Allow and deny entries are merged with the default and user-supplied
@@ -753,6 +785,10 @@ interface AgentConfigOptions {
753
785
  * Custom sub-agent definitions.
754
786
  */
755
787
  readonly subAgents?: ReadonlyArray<AgentSubAgent>;
788
+ /**
789
+ * Custom procedure definitions (executable shell scripts).
790
+ */
791
+ readonly procedures?: ReadonlyArray<AgentProcedure>;
756
792
  /**
757
793
  * MCP server configurations. Cross-platform — rendered to the appropriate
758
794
  * config file for each platform.
@@ -858,6 +894,7 @@ declare class AgentConfig extends Component {
858
894
  private bundleRulesFor;
859
895
  private resolveSkills;
860
896
  private resolveSubAgents;
897
+ private resolveProcedures;
861
898
  /**
862
899
  * Resolves template variables in rule content using project metadata.
863
900
  * Emits synthesis warnings for rules with unresolved variables.
@@ -871,6 +908,10 @@ declare class AgentConfig extends Component {
871
908
  * Resolves template variables in sub-agent prompts using project metadata.
872
909
  */
873
910
  private resolveSubAgentTemplates;
911
+ /**
912
+ * Resolves template variables in procedure content using project metadata.
913
+ */
914
+ private resolveProcedureTemplates;
874
915
  /**
875
916
  * Collects Claude permission entries from all active bundles.
876
917
  */
@@ -898,6 +939,19 @@ declare const githubWorkflowBundle: AgentRuleBundle;
898
939
  */
899
940
  declare const jestBundle: AgentRuleBundle;
900
941
 
942
+ /**
943
+ * Meeting analysis bundle — included by default.
944
+ * Provides a 4-phase meeting transcript processing workflow.
945
+ */
946
+ declare const meetingAnalysisBundle: AgentRuleBundle;
947
+
948
+ /*******************************************************************************
949
+ *
950
+ * Bundle definition
951
+ *
952
+ ******************************************************************************/
953
+ declare const orchestratorBundle: AgentRuleBundle;
954
+
901
955
  /**
902
956
  * PNPM bundle — auto-detected when the PnpmWorkspace component is present.
903
957
  */
@@ -2919,4 +2973,4 @@ declare const COMPLETE_JOB_ID = "complete";
2919
2973
  */
2920
2974
  declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
2921
2975
 
2922
- export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, type AgentConfigOptions, type AgentModel, type AgentPlatform, type AgentPlatformOverrides, type AgentRule, type AgentRuleBundle, type AgentRuleScope, type AgentSkill, type AgentSubAgent, type AgentSubAgentPlatformOverrides, type ApproveMergeUpgradeOptions, type AwsAccount, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, 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_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, type LabelDefinition, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, type McpServerConfig, type McpTransport, type MergeMethod, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedProjectMetadata, type SlackMetadata, 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, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, pnpmBundle, projenBundle, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
2976
+ 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, type AwsAccount, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, type AwsDeploymentTargetOptions, type AwsLocalDeploymentConfig, type AwsOrganization, type AwsRegion, 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_TYPE_LABELS, type DeployWorkflowOptions, type DeploymentMetadata, type GitBranch, type GitHubBoardMetadata, type GitHubProjectMetadata, type GitHubSprintMetadata, type IDependencyResolver, JsiiFaker, type LabelDefinition, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, type McpServerConfig, type McpTransport, type MergeMethod, MonorepoProject, type MonorepoProjectOptions, type OrganizationMetadata, PROD_DEPLOY_NAME, PnpmWorkspace, type PnpmWorkspaceOptions, ProjectMetadata, type ProjectMetadataOptions, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, type RemoteCacheOptions, type RepositoryMetadata, ResetTask, type ResetTaskOptions, type ResolvedProjectMetadata, type SlackMetadata, 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, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, projenBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
package/lib/index.d.ts CHANGED
@@ -100,6 +100,12 @@ declare const AGENT_MODEL: {
100
100
  readonly POWERFUL: "powerful";
101
101
  };
102
102
  type AgentModel = (typeof AGENT_MODEL)[keyof typeof AGENT_MODEL];
103
+ /**
104
+ * Maps abstract AGENT_MODEL values to Claude Code model aliases.
105
+ * Returns undefined for "inherit" (omit the field entirely).
106
+ * Cursor omits the model field to use its default model selection.
107
+ */
108
+ declare function resolveModelAlias(model: string | undefined): string | undefined;
103
109
  /**
104
110
  * MCP server transport type.
105
111
  */
@@ -258,6 +264,15 @@ interface AgentSkill {
258
264
  * @default 'bash'
259
265
  */
260
266
  readonly shell?: string;
267
+ /** Per-platform overrides. Use `exclude: true` to skip a platform. */
268
+ readonly platforms?: {
269
+ readonly claude?: {
270
+ readonly exclude?: boolean;
271
+ };
272
+ readonly cursor?: {
273
+ readonly exclude?: boolean;
274
+ };
275
+ };
261
276
  }
262
277
  /**
263
278
  * Platform-specific overrides for a sub-agent definition.
@@ -376,6 +391,21 @@ interface AgentSubAgent {
376
391
  /** Optional per-platform overrides for this sub-agent. */
377
392
  readonly platforms?: AgentSubAgentPlatformOverrides;
378
393
  }
394
+ /**
395
+ * An executable procedure (shell script) that ships with a bundle.
396
+ * Rendered to .claude/procedures/{name} as an executable file.
397
+ */
398
+ interface AgentProcedure {
399
+ /**
400
+ * Filename for the procedure (e.g., 'check-blocked.sh').
401
+ * Used as the filename in .claude/procedures/.
402
+ */
403
+ readonly name: string;
404
+ /** Human-readable description of what this procedure does. */
405
+ readonly description: string;
406
+ /** Script content as a single string. Lines are split on newlines for rendering. */
407
+ readonly content: string;
408
+ }
379
409
  /**
380
410
  * MCP server configuration. Cross-platform — rendered to .claude/settings.json
381
411
  * (Claude Code) and .cursor/mcp.json (Cursor).
@@ -456,6 +486,8 @@ interface AgentRuleBundle {
456
486
  readonly skills?: ReadonlyArray<AgentSkill>;
457
487
  /** Sub-agents included in this bundle. */
458
488
  readonly subAgents?: ReadonlyArray<AgentSubAgent>;
489
+ /** Executable procedures (shell scripts) included in this bundle. */
490
+ readonly procedures?: ReadonlyArray<AgentProcedure>;
459
491
  /**
460
492
  * Claude Code permission entries contributed by this bundle.
461
493
  * Allow and deny entries are merged with the default and user-supplied
@@ -802,6 +834,10 @@ interface AgentConfigOptions {
802
834
  * Custom sub-agent definitions.
803
835
  */
804
836
  readonly subAgents?: ReadonlyArray<AgentSubAgent>;
837
+ /**
838
+ * Custom procedure definitions (executable shell scripts).
839
+ */
840
+ readonly procedures?: ReadonlyArray<AgentProcedure>;
805
841
  /**
806
842
  * MCP server configurations. Cross-platform — rendered to the appropriate
807
843
  * config file for each platform.
@@ -907,6 +943,7 @@ declare class AgentConfig extends Component {
907
943
  private bundleRulesFor;
908
944
  private resolveSkills;
909
945
  private resolveSubAgents;
946
+ private resolveProcedures;
910
947
  /**
911
948
  * Resolves template variables in rule content using project metadata.
912
949
  * Emits synthesis warnings for rules with unresolved variables.
@@ -920,6 +957,10 @@ declare class AgentConfig extends Component {
920
957
  * Resolves template variables in sub-agent prompts using project metadata.
921
958
  */
922
959
  private resolveSubAgentTemplates;
960
+ /**
961
+ * Resolves template variables in procedure content using project metadata.
962
+ */
963
+ private resolveProcedureTemplates;
923
964
  /**
924
965
  * Collects Claude permission entries from all active bundles.
925
966
  */
@@ -947,6 +988,19 @@ declare const githubWorkflowBundle: AgentRuleBundle;
947
988
  */
948
989
  declare const jestBundle: AgentRuleBundle;
949
990
 
991
+ /**
992
+ * Meeting analysis bundle — included by default.
993
+ * Provides a 4-phase meeting transcript processing workflow.
994
+ */
995
+ declare const meetingAnalysisBundle: AgentRuleBundle;
996
+
997
+ /*******************************************************************************
998
+ *
999
+ * Bundle definition
1000
+ *
1001
+ ******************************************************************************/
1002
+ declare const orchestratorBundle: AgentRuleBundle;
1003
+
950
1004
  /**
951
1005
  * PNPM bundle — auto-detected when the PnpmWorkspace component is present.
952
1006
  */
@@ -2968,5 +3022,5 @@ declare const COMPLETE_JOB_ID = "complete";
2968
3022
  */
2969
3023
  declare function addBuildCompleteJob(buildWorkflow: BuildWorkflow): void;
2970
3024
 
2971
- export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TYPE_LABELS, JsiiFaker, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, pnpmBundle, projenBundle, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
2972
- export type { AgentConfigOptions, AgentModel, AgentPlatform, AgentPlatformOverrides, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AwsAccount, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, McpServerConfig, McpTransport, MergeMethod, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedProjectMetadata, SlackMetadata, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };
3025
+ export { AGENT_MODEL, AGENT_PLATFORM, AGENT_RULE_SCOPE, AgentConfig, AwsDeployWorkflow, AwsDeploymentConfig, AwsDeploymentTarget, BUILT_IN_BUNDLES, CLAUDE_RULE_TARGET, COMPLETE_JOB_ID, DEFAULT_PRIORITY_LABELS, DEFAULT_STATUS_LABELS, DEFAULT_TYPE_LABELS, JsiiFaker, MCP_TRANSPORT, MERGE_METHODS, MIMIMUM_RELEASE_AGE, MINIMUM_RELEASE_AGE, MonorepoProject, PROD_DEPLOY_NAME, PnpmWorkspace, ProjectMetadata, ROOT_CI_TASK_NAME, ROOT_TURBO_TASK_NAME, ResetTask, TestRunner, TurboRepo, TurboRepoTask, TypeScriptConfig, TypeScriptProject, VERSION, VERSION_KEYS_SKIP, VERSION_NPM_PACKAGES, VSCodeConfig, Vitest, addApproveMergeUpgradeWorkflow, addBuildCompleteJob, addSyncLabelsWorkflow, awsCdkBundle, baseBundle, getLatestEligibleVersion, githubWorkflowBundle, jestBundle, meetingAnalysisBundle, orchestratorBundle, pnpmBundle, projenBundle, resolveModelAlias, resolveTemplateVariables, slackBundle, turborepoBundle, typescriptBundle, vitestBundle };
3026
+ export type { AgentConfigOptions, AgentModel, AgentPlatform, AgentPlatformOverrides, AgentProcedure, AgentRule, AgentRuleBundle, AgentRuleScope, AgentSkill, AgentSubAgent, AgentSubAgentPlatformOverrides, ApproveMergeUpgradeOptions, AwsAccount, AwsDeploymentTargetOptions, AwsLocalDeploymentConfig, AwsOrganization, AwsRegion, CiDeploymentConfig, ClassTypeOptions, ClaudeAutoModeConfig, ClaudeHookAction, ClaudeHookEntry, ClaudeHooksConfig, ClaudePermissionsConfig, ClaudeRuleTarget, ClaudeSandboxConfig, ClaudeSettingsConfig, CopilotHandoff, CursorHookAction, CursorHooksConfig, CursorSettingsConfig, DeployWorkflowOptions, DeploymentMetadata, GitBranch, GitHubBoardMetadata, GitHubProjectMetadata, GitHubSprintMetadata, IDependencyResolver, LabelDefinition, McpServerConfig, McpTransport, MergeMethod, MonorepoProjectOptions, OrganizationMetadata, PnpmWorkspaceOptions, ProjectMetadataOptions, RemoteCacheOptions, RepositoryMetadata, ResetTaskOptions, ResolvedProjectMetadata, SlackMetadata, SyncLabelsOptions, TemplateResolveResult, TurboRepoOptions, TurboRepoTaskOptions, TypeScriptProjectOptions, VersionKey, VitestConfigOptions, VitestOptions };