@codedrifters/configulator 0.0.211 → 0.0.213

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.
@@ -20,9 +20,10 @@ regardless of which specific agent bundles a project enables.
20
20
 
21
21
  Families in this tier:
22
22
 
23
- - **`status:*`** — workflow state (`ready`, `in-progress`, `blocked`,
24
- `done`, `deferred`, `needs-attention`). Required by every agent that
25
- transitions issues through the workflow.
23
+ - **`status:*`** — workflow state (`ready`, `in-progress`,
24
+ `ready-for-review`, `blocked`, `done`, `deferred`,
25
+ `needs-attention`). Required by every agent that transitions issues
26
+ through the workflow.
26
27
  - **`priority:*`** — scheduling priority (`critical`, `high`, `medium`,
27
28
  `low`, `trivial`). Required by the orchestrator to sequence work.
28
29
  - **`type:*`** — conventional-commit work type (`feat`, `fix`, `docs`,
package/lib/index.d.mts CHANGED
@@ -1018,12 +1018,12 @@ declare const baseBundle: AgentRuleBundle;
1018
1018
  declare const bcmWriterBundle: AgentRuleBundle;
1019
1019
 
1020
1020
  /**
1021
- * Company-profile bundle — opt-in only.
1021
+ * Company-profile bundle — enabled by default.
1022
1022
  *
1023
- * Consuming projects enable it explicitly with
1024
- * `includeBundles: ["company-profile"]`. `appliesWhen` always returns
1025
- * `false` so the bundle never auto-detects company research is a
1026
- * deliberate project-level choice, not a universal default.
1023
+ * Consuming projects can disable it with
1024
+ * `excludeBundles: ["company-profile"]`. `appliesWhen` always returns
1025
+ * `true` per this batch's directive that bundles assume peers are
1026
+ * present.
1027
1027
  *
1028
1028
  * Ships a sub-agent (`company-profile-analyst`), a user-invocable skill
1029
1029
  * (`/profile-company`), and `type:company-profile` plus `company:*`
@@ -1037,12 +1037,12 @@ declare const companyProfileBundle: AgentRuleBundle;
1037
1037
  declare const githubWorkflowBundle: AgentRuleBundle;
1038
1038
 
1039
1039
  /**
1040
- * Industry-discovery bundle — opt-in only.
1040
+ * Industry-discovery bundle — enabled by default.
1041
1041
  *
1042
- * Consuming projects enable it explicitly with
1043
- * `includeBundles: ["industry-discovery"]`. `appliesWhen` always returns
1044
- * `false` so the bundle never auto-detects industry discovery is a
1045
- * deliberate project-level choice, not a universal default.
1042
+ * Consuming projects can disable it with
1043
+ * `excludeBundles: ["industry-discovery"]`. `appliesWhen` always returns
1044
+ * `true` per this batch's directive that bundles assume peers are
1045
+ * present.
1046
1046
  *
1047
1047
  * Ships a sub-agent (`industry-discovery-analyst`), a user-invocable
1048
1048
  * skill (`/discover-industries`), and `type:industry-discovery` plus
@@ -1059,8 +1059,12 @@ declare const industryDiscoveryBundle: AgentRuleBundle;
1059
1059
  declare const jestBundle: AgentRuleBundle;
1060
1060
 
1061
1061
  /**
1062
- * Maintenance-audit bundle — opt-in via
1063
- * `includeBundles: ["maintenance-audit"]`.
1062
+ * Maintenance-audit bundle — enabled by default.
1063
+ *
1064
+ * Consuming projects can disable it with
1065
+ * `excludeBundles: ["maintenance-audit"]`. `appliesWhen` always returns
1066
+ * `true` per this batch's directive that bundles assume peers are
1067
+ * present.
1064
1068
  *
1065
1069
  * Provides a 2-phase documentation-maintenance pipeline (scan → fix)
1066
1070
  * designed for any project with structured doc registries and
@@ -1085,12 +1089,12 @@ declare const meetingAnalysisBundle: AgentRuleBundle;
1085
1089
  declare const orchestratorBundle: AgentRuleBundle;
1086
1090
 
1087
1091
  /**
1088
- * People-profile bundle — opt-in only.
1092
+ * People-profile bundle — enabled by default.
1089
1093
  *
1090
- * Consuming projects enable it explicitly with
1091
- * `includeBundles: ["people-profile"]`. `appliesWhen` always returns
1092
- * `false` so the bundle never auto-detects person research is a
1093
- * deliberate project-level choice, not a universal default.
1094
+ * Consuming projects can disable it with
1095
+ * `excludeBundles: ["people-profile"]`. `appliesWhen` always returns
1096
+ * `true` per this batch's directive that bundles assume peers are
1097
+ * present.
1094
1098
  *
1095
1099
  * Ships a sub-agent (`people-profile-analyst`), a user-invocable skill
1096
1100
  * (`/profile-person`), and `type:people-profile` plus `people:*` phase
@@ -1129,12 +1133,12 @@ declare const projenBundle: AgentRuleBundle;
1129
1133
  declare const requirementsAnalystBundle: AgentRuleBundle;
1130
1134
 
1131
1135
  /**
1132
- * Research-pipeline bundle — opt-in only.
1136
+ * Research-pipeline bundle — enabled by default.
1133
1137
  *
1134
- * Consuming projects enable it explicitly with
1135
- * `includeBundles: ["research-pipeline"]`. `appliesWhen` always returns
1136
- * `false` so the bundle never auto-detects research pipelines are a
1137
- * deliberate project-level choice, not a universal default.
1138
+ * Consuming projects can disable it with
1139
+ * `excludeBundles: ["research-pipeline"]`. `appliesWhen` always returns
1140
+ * `true` per this batch's directive that bundles assume peers are
1141
+ * present.
1138
1142
  *
1139
1143
  * Ships a sub-agent (`research-analyst`), a user-invocable skill
1140
1144
  * (`/research`), and `type:research` plus `research:*` phase labels.
@@ -1148,12 +1152,12 @@ declare const researchPipelineBundle: AgentRuleBundle;
1148
1152
  declare const slackBundle: AgentRuleBundle;
1149
1153
 
1150
1154
  /**
1151
- * Software-profile bundle — opt-in only.
1155
+ * Software-profile bundle — enabled by default.
1152
1156
  *
1153
- * Consuming projects enable it explicitly with
1154
- * `includeBundles: ["software-profile"]`. `appliesWhen` always returns
1155
- * `false` so the bundle never auto-detects software research is a
1156
- * deliberate project-level choice, not a universal default.
1157
+ * Consuming projects can disable it with
1158
+ * `excludeBundles: ["software-profile"]`. `appliesWhen` always returns
1159
+ * `true` per this batch's directive that bundles assume peers are
1160
+ * present.
1157
1161
  *
1158
1162
  * Ships a sub-agent (`software-profile-analyst`), a user-invocable skill
1159
1163
  * (`/profile-software`), and `type:software-profile` plus `software:*`
package/lib/index.d.ts CHANGED
@@ -1067,12 +1067,12 @@ declare const baseBundle: AgentRuleBundle;
1067
1067
  declare const bcmWriterBundle: AgentRuleBundle;
1068
1068
 
1069
1069
  /**
1070
- * Company-profile bundle — opt-in only.
1070
+ * Company-profile bundle — enabled by default.
1071
1071
  *
1072
- * Consuming projects enable it explicitly with
1073
- * `includeBundles: ["company-profile"]`. `appliesWhen` always returns
1074
- * `false` so the bundle never auto-detects company research is a
1075
- * deliberate project-level choice, not a universal default.
1072
+ * Consuming projects can disable it with
1073
+ * `excludeBundles: ["company-profile"]`. `appliesWhen` always returns
1074
+ * `true` per this batch's directive that bundles assume peers are
1075
+ * present.
1076
1076
  *
1077
1077
  * Ships a sub-agent (`company-profile-analyst`), a user-invocable skill
1078
1078
  * (`/profile-company`), and `type:company-profile` plus `company:*`
@@ -1086,12 +1086,12 @@ declare const companyProfileBundle: AgentRuleBundle;
1086
1086
  declare const githubWorkflowBundle: AgentRuleBundle;
1087
1087
 
1088
1088
  /**
1089
- * Industry-discovery bundle — opt-in only.
1089
+ * Industry-discovery bundle — enabled by default.
1090
1090
  *
1091
- * Consuming projects enable it explicitly with
1092
- * `includeBundles: ["industry-discovery"]`. `appliesWhen` always returns
1093
- * `false` so the bundle never auto-detects industry discovery is a
1094
- * deliberate project-level choice, not a universal default.
1091
+ * Consuming projects can disable it with
1092
+ * `excludeBundles: ["industry-discovery"]`. `appliesWhen` always returns
1093
+ * `true` per this batch's directive that bundles assume peers are
1094
+ * present.
1095
1095
  *
1096
1096
  * Ships a sub-agent (`industry-discovery-analyst`), a user-invocable
1097
1097
  * skill (`/discover-industries`), and `type:industry-discovery` plus
@@ -1108,8 +1108,12 @@ declare const industryDiscoveryBundle: AgentRuleBundle;
1108
1108
  declare const jestBundle: AgentRuleBundle;
1109
1109
 
1110
1110
  /**
1111
- * Maintenance-audit bundle — opt-in via
1112
- * `includeBundles: ["maintenance-audit"]`.
1111
+ * Maintenance-audit bundle — enabled by default.
1112
+ *
1113
+ * Consuming projects can disable it with
1114
+ * `excludeBundles: ["maintenance-audit"]`. `appliesWhen` always returns
1115
+ * `true` per this batch's directive that bundles assume peers are
1116
+ * present.
1113
1117
  *
1114
1118
  * Provides a 2-phase documentation-maintenance pipeline (scan → fix)
1115
1119
  * designed for any project with structured doc registries and
@@ -1134,12 +1138,12 @@ declare const meetingAnalysisBundle: AgentRuleBundle;
1134
1138
  declare const orchestratorBundle: AgentRuleBundle;
1135
1139
 
1136
1140
  /**
1137
- * People-profile bundle — opt-in only.
1141
+ * People-profile bundle — enabled by default.
1138
1142
  *
1139
- * Consuming projects enable it explicitly with
1140
- * `includeBundles: ["people-profile"]`. `appliesWhen` always returns
1141
- * `false` so the bundle never auto-detects person research is a
1142
- * deliberate project-level choice, not a universal default.
1143
+ * Consuming projects can disable it with
1144
+ * `excludeBundles: ["people-profile"]`. `appliesWhen` always returns
1145
+ * `true` per this batch's directive that bundles assume peers are
1146
+ * present.
1143
1147
  *
1144
1148
  * Ships a sub-agent (`people-profile-analyst`), a user-invocable skill
1145
1149
  * (`/profile-person`), and `type:people-profile` plus `people:*` phase
@@ -1178,12 +1182,12 @@ declare const projenBundle: AgentRuleBundle;
1178
1182
  declare const requirementsAnalystBundle: AgentRuleBundle;
1179
1183
 
1180
1184
  /**
1181
- * Research-pipeline bundle — opt-in only.
1185
+ * Research-pipeline bundle — enabled by default.
1182
1186
  *
1183
- * Consuming projects enable it explicitly with
1184
- * `includeBundles: ["research-pipeline"]`. `appliesWhen` always returns
1185
- * `false` so the bundle never auto-detects research pipelines are a
1186
- * deliberate project-level choice, not a universal default.
1187
+ * Consuming projects can disable it with
1188
+ * `excludeBundles: ["research-pipeline"]`. `appliesWhen` always returns
1189
+ * `true` per this batch's directive that bundles assume peers are
1190
+ * present.
1187
1191
  *
1188
1192
  * Ships a sub-agent (`research-analyst`), a user-invocable skill
1189
1193
  * (`/research`), and `type:research` plus `research:*` phase labels.
@@ -1197,12 +1201,12 @@ declare const researchPipelineBundle: AgentRuleBundle;
1197
1201
  declare const slackBundle: AgentRuleBundle;
1198
1202
 
1199
1203
  /**
1200
- * Software-profile bundle — opt-in only.
1204
+ * Software-profile bundle — enabled by default.
1201
1205
  *
1202
- * Consuming projects enable it explicitly with
1203
- * `includeBundles: ["software-profile"]`. `appliesWhen` always returns
1204
- * `false` so the bundle never auto-detects software research is a
1205
- * deliberate project-level choice, not a universal default.
1206
+ * Consuming projects can disable it with
1207
+ * `excludeBundles: ["software-profile"]`. `appliesWhen` always returns
1208
+ * `true` per this batch's directive that bundles assume peers are
1209
+ * present.
1206
1210
  *
1207
1211
  * Ships a sub-agent (`software-profile-analyst`), a user-invocable skill
1208
1212
  * (`/profile-software`), and `type:software-profile` plus `software:*`
package/lib/index.js CHANGED
@@ -792,9 +792,10 @@ var baseBundle = {
792
792
  "|-------|----------|",
793
793
  "| `status:ready` | The issue is fully specified, has no open blockers, and is available for a worker to pick up. |",
794
794
  "| `status:blocked` | The issue cannot be started yet \u2014 either it declares `Depends on: #N` on an open issue, or it is an epic with one or more open children. |",
795
- "| `status:in-progress` | A worker has claimed the issue and a branch exists. Set when the worker starts; cleared only on completion or failure. |",
795
+ "| `status:in-progress` | A worker has claimed the issue and a branch exists. Set when the worker starts; cleared only when the worker opens a PR or the issue fails. |",
796
+ "| `status:ready-for-review` | A PR has been opened for this issue and is awaiting review and merge. Replaces `status:in-progress` at the moment the PR opens. |",
796
797
  "| `status:needs-attention` | Automated triage has flagged the issue for human review (stale, failed worker, or ambiguous state). Humans reset this label manually. |",
797
- "| `status:done` | The change has shipped. Usually set when the PR merges and the issue closes. |",
798
+ "| `status:done` | The change has shipped. Set when the PR merges and the issue closes. |",
798
799
  "",
799
800
  "### Blocking Rules",
800
801
  "",
@@ -816,9 +817,9 @@ var baseBundle = {
816
817
  " either blocking rule applies.",
817
818
  "- **Worker claims the issue** \u2192 remove `status:ready`, add",
818
819
  " `status:in-progress`. A branch must exist before this transition.",
819
- "- **Worker opens a PR** \u2192 leave `status:in-progress` in place until the",
820
- " PR merges. Do not pre-flip to `status:done`.",
821
- "- **PR merges / issue closes** \u2192 remove `status:in-progress`, add",
820
+ "- **Worker opens a PR** \u2192 remove `status:in-progress`, add",
821
+ " `status:ready-for-review`. The PR URL should be posted on the issue.",
822
+ "- **PR merges / issue closes** \u2192 remove `status:ready-for-review`, add",
822
823
  " `status:done`.",
823
824
  "- **Dependency resolves** \u2192 if the issue was `status:blocked` solely because",
824
825
  " of the dependency-blocking rule, remove `status:blocked` and add",
@@ -835,8 +836,9 @@ var baseBundle = {
835
836
  " by CI. Those are expected self-healing behaviors, not failures.",
836
837
  "",
837
838
  "An issue must always carry exactly one of `status:ready`, `status:blocked`,",
838
- "`status:in-progress`, or `status:done`. The `status:needs-attention` label",
839
- "is additive \u2014 it coexists with whichever of those four applies."
839
+ "`status:in-progress`, `status:ready-for-review`, or `status:done`. The",
840
+ "`status:needs-attention` label is additive \u2014 it coexists with whichever of",
841
+ "those five applies."
840
842
  ].join("\n"),
841
843
  tags: ["workflow"]
842
844
  },
@@ -2113,8 +2115,8 @@ var profileCompanySkill = {
2113
2115
  };
2114
2116
  var companyProfileBundle = {
2115
2117
  name: "company-profile",
2116
- description: "Company research and profiling pipeline: research, draft profile, followup. Opt-in only; domain-neutral; filesystem-durable between phases.",
2117
- appliesWhen: () => false,
2118
+ description: "Company research and profiling pipeline: research, draft profile, followup. Enabled by default; domain-neutral; filesystem-durable between phases.",
2119
+ appliesWhen: () => true,
2118
2120
  rules: [
2119
2121
  {
2120
2122
  name: "company-profile-workflow",
@@ -2779,8 +2781,8 @@ var discoverIndustriesSkill = {
2779
2781
  };
2780
2782
  var industryDiscoveryBundle = {
2781
2783
  name: "industry-discovery",
2782
- description: "Industry-vertical discovery pipeline: discover candidates, evaluate against a fit rubric, plan downstream research. Opt-in only; domain-neutral; filesystem-durable between phases.",
2783
- appliesWhen: () => false,
2784
+ description: "Industry-vertical discovery pipeline: discover candidates, evaluate against a fit rubric, plan downstream research. Enabled by default; domain-neutral; filesystem-durable between phases.",
2785
+ appliesWhen: () => true,
2784
2786
  rules: [
2785
2787
  {
2786
2788
  name: "industry-discovery-workflow",
@@ -3322,8 +3324,8 @@ var maintenanceAuditSkill = {
3322
3324
  };
3323
3325
  var maintenanceAuditBundle = {
3324
3326
  name: "maintenance-audit",
3325
- description: "Documentation-maintenance agent bundle. 2-phase pipeline (scan, fix) with maint:* phase labels for auditing registries and cross-references and applying idempotent fixes.",
3326
- appliesWhen: () => false,
3327
+ description: "Documentation-maintenance agent bundle. 2-phase pipeline (scan, fix) with maint:* phase labels for auditing registries and cross-references and applying idempotent fixes. Enabled by default.",
3328
+ appliesWhen: () => true,
3327
3329
  rules: [
3328
3330
  {
3329
3331
  name: "maintenance-audit-workflow",
@@ -4358,11 +4360,14 @@ var issueWorkerSubAgent = {
4358
4360
  "",
4359
4361
  "## Phase 8: Update Status",
4360
4362
  "",
4361
- "After the PR is created:",
4363
+ "After the PR is created, transition the issue to the review phase:",
4362
4364
  "```bash",
4363
- 'gh issue edit <number> --remove-label "status:in-progress" --add-label "status:done"',
4365
+ 'gh issue edit <number> --remove-label "status:in-progress" --add-label "status:ready-for-review"',
4364
4366
  "```",
4365
4367
  "",
4368
+ "Do **not** set `status:done` here \u2014 the `pr-reviewer` sub-agent is",
4369
+ "responsible for that transition once the PR successfully merges.",
4370
+ "",
4366
4371
  "## Phase 9: Branch Cleanup",
4367
4372
  "",
4368
4373
  "The PR will not auto-merge until the `pr-reviewer` enables it. Poll the PR",
@@ -4931,8 +4936,8 @@ var profilePersonSkill = {
4931
4936
  };
4932
4937
  var peopleProfileBundle = {
4933
4938
  name: "people-profile",
4934
- description: "People research and profiling pipeline: research, draft profile, followup. Opt-in only; domain-neutral; filesystem-durable between phases; cross-references existing companies, software, and meeting notes without creating new downstream issues.",
4935
- appliesWhen: () => false,
4939
+ description: "People research and profiling pipeline: research, draft profile, followup. Enabled by default; domain-neutral; filesystem-durable between phases; cross-references existing companies, software, and meeting notes without creating new downstream issues.",
4940
+ appliesWhen: () => true,
4936
4941
  rules: [
4937
4942
  {
4938
4943
  name: "people-profile-workflow",
@@ -5251,6 +5256,14 @@ var prReviewerSubAgent = {
5251
5256
  " git fetch --prune origin",
5252
5257
  " git branch -d <branch-name> 2>/dev/null || git branch -D <branch-name> 2>/dev/null || true",
5253
5258
  " ```",
5259
+ " Transition the linked issue to `status:done` (replaces whichever of",
5260
+ " `status:ready-for-review` or `status:in-progress` it was carrying):",
5261
+ " ```bash",
5262
+ " gh issue edit <issue-number> \\",
5263
+ ' --remove-label "status:ready-for-review" \\',
5264
+ ' --remove-label "status:in-progress" \\',
5265
+ ' --add-label "status:done"',
5266
+ " ```",
5254
5267
  " Then check the linked issue state:",
5255
5268
  " ```bash",
5256
5269
  " gh issue view <issue-number> --json state --jq '.state'",
@@ -6658,8 +6671,8 @@ var researchSkill = {
6658
6671
  };
6659
6672
  var researchPipelineBundle = {
6660
6673
  name: "research-pipeline",
6661
- description: "Generic research micro-task pipeline: scope, N-way slice search/synthesize, and verify. Opt-in only; domain-neutral; filesystem-durable between phases.",
6662
- appliesWhen: () => false,
6674
+ description: "Generic research micro-task pipeline: scope, N-way slice search/synthesize, and verify. Enabled by default; domain-neutral; filesystem-durable between phases.",
6675
+ appliesWhen: () => true,
6663
6676
  rules: [
6664
6677
  {
6665
6678
  name: "research-pipeline-workflow",
@@ -7304,8 +7317,8 @@ var profileSoftwareSkill = {
7304
7317
  };
7305
7318
  var softwareProfileBundle = {
7306
7319
  name: "software-profile",
7307
- description: "Software research, profiling, and feature-matrix pipeline: research, profile, matrix, followup. Opt-in only; domain-neutral; filesystem-durable between phases; ranks features against configurable segment-importance weights.",
7308
- appliesWhen: () => false,
7320
+ description: "Software research, profiling, and feature-matrix pipeline: research, profile, matrix, followup. Enabled by default; domain-neutral; filesystem-durable between phases; ranks features against configurable segment-importance weights.",
7321
+ appliesWhen: () => true,
7309
7322
  rules: [
7310
7323
  {
7311
7324
  name: "software-profile-workflow",
@@ -9889,6 +9902,11 @@ var DEFAULT_STATUS_LABELS = [
9889
9902
  color: "FBCA04",
9890
9903
  description: "Actively being worked on"
9891
9904
  },
9905
+ {
9906
+ name: "status:ready-for-review",
9907
+ color: "1D76DB",
9908
+ description: "PR opened and awaiting review"
9909
+ },
9892
9910
  {
9893
9911
  name: "status:blocked",
9894
9912
  color: "D93F0B",