@deftai/directive 0.97.0 → 0.98.0

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.
@@ -83,6 +83,9 @@ export const SUBCOMMAND_ROUTES = {
83
83
  "policy:allow-direct-commits": ["policy", "allow-direct-commits"],
84
84
  "policy:allow-bot-merge": ["policy", "allow-bot-merge"],
85
85
  "policy:enable-value-feedback": ["policy", "enable-value-feedback"],
86
+ "policy:coverage-check-resume-preset": ["policy", "coverage-check-resume-preset"],
87
+ "policy:coverage-check-resume-dismiss": ["policy", "coverage-check-resume-dismiss"],
88
+ "policy:coverage-check-resume-later": ["policy", "coverage-check-resume-later"],
86
89
  "policy:clear-value-feedback": ["policy", "clear-value-feedback"],
87
90
  "authz:show": ["authz", "show"],
88
91
  "authz:uat-start": ["authz", "uat-start"],
package/dist/dispatch.js CHANGED
@@ -211,6 +211,9 @@ export const POLICY_ACTION_ALIAS_SUBCOMMANDS = {
211
211
  "policy:allow-bot-merge": "allow-bot-merge",
212
212
  "policy:enable-value-feedback": "enable-value-feedback",
213
213
  "policy:clear-value-feedback": "clear-value-feedback",
214
+ "policy:coverage-check-resume-preset": "coverage-check-resume-preset",
215
+ "policy:coverage-check-resume-dismiss": "coverage-check-resume-dismiss",
216
+ "policy:coverage-check-resume-later": "coverage-check-resume-later",
214
217
  "policy:disable-directive": "disable-directive",
215
218
  "policy:enable-directive": "enable-directive",
216
219
  };
package/dist/policy.d.ts CHANGED
@@ -7,7 +7,7 @@ interface ShowArgs {
7
7
  error?: string;
8
8
  }
9
9
  interface SetArgs {
10
- cmd: "show" | "enforce-branches" | "allow-direct-commits" | "allow-bot-merge" | "enable-value-feedback" | "clear-value-feedback" | "disable-directive" | "enable-directive" | "resolve";
10
+ cmd: "show" | "enforce-branches" | "allow-direct-commits" | "allow-bot-merge" | "enable-value-feedback" | "clear-value-feedback" | "coverage-check-resume-preset" | "coverage-check-resume-dismiss" | "coverage-check-resume-later" | "disable-directive" | "enable-directive" | "resolve";
11
11
  confirm: boolean;
12
12
  actor: string;
13
13
  note: string;
@@ -15,6 +15,9 @@ interface SetArgs {
15
15
  format: "text" | "json";
16
16
  changedOnly: boolean;
17
17
  field: string | null;
18
+ /** Strict | hatch-aware for coverage-check-resume-preset; reason for dismiss. */
19
+ preset?: string;
20
+ reason?: string;
18
21
  error?: string;
19
22
  }
20
23
  /** Parse policy:show flags (mirrors _policy_show_cli.py). */
package/dist/policy.js CHANGED
@@ -6,7 +6,7 @@
6
6
  import { existsSync } from "node:fs";
7
7
  import { resolve as pathResolve, relative } from "node:path";
8
8
  import { fileURLToPath } from "node:url";
9
- import { ALLOW_BOT_MERGE_CAPABILITY_COST, clearValueFeedback, createNoDeftDirectiveFlag, describeShadowedPlanExtension, detectNoDeftDirective, detectShadowedPlanExtensions, disclosureLine, enableValueFeedback, FIELD_VALUE_FEEDBACK, FIELD_VALUE_FEEDBACK_CLI_ALIAS, formatValueFeedbackStatusLine, humanMergeDisclosureLine, inspectAllPolicies, inspectOnePolicy, loadProjectDefinition, NO_DEFT_DIRECTIVE_DISABLED_MESSAGE, NO_DEFT_DIRECTIVE_FLAG_NAME, NO_DEFT_DIRECTIVE_INCONSISTENT_MESSAGE, policyColonInvocation, projectDefinitionPath, pythonListRepr, pythonStringRepr, registeredPolicyNames, removeNoDeftDirectiveFlag, renderJson, renderText, resolveHumanMergePolicy, resolvePolicy, resolveValueFeedback, setPolicy, setRequireHumanMerge, } from "@deftai/directive-core/policy";
9
+ import { ALLOW_BOT_MERGE_CAPABILITY_COST, applyHatchAwareCoverageCheckResumePreset, applyLaterCoverageCheckResumeSkip, applyStrictCoverageCheckResumePreset, clearValueFeedback, createNoDeftDirectiveFlag, describeShadowedPlanExtension, detectNoDeftDirective, detectShadowedPlanExtensions, disclosureLine, dismissCoverageCheckResume, enableValueFeedback, FIELD_VALUE_FEEDBACK, FIELD_VALUE_FEEDBACK_CLI_ALIAS, formatValueFeedbackStatusLine, humanMergeDisclosureLine, inspectAllPolicies, inspectOnePolicy, loadProjectDefinition, NO_DEFT_DIRECTIVE_DISABLED_MESSAGE, NO_DEFT_DIRECTIVE_FLAG_NAME, NO_DEFT_DIRECTIVE_INCONSISTENT_MESSAGE, policyColonInvocation, projectDefinitionPath, pythonListRepr, pythonStringRepr, registeredPolicyNames, removeNoDeftDirectiveFlag, renderJson, renderText, resolveHumanMergePolicy, resolvePolicy, resolveValueFeedback, setPolicy, setRequireHumanMerge, } from "@deftai/directive-core/policy";
10
10
  const CAPABILITY_COST_DISCLOSURE = "\u26a0 Capability-cost disclosure -- enabling direct commits to the default " +
11
11
  "branch turns OFF the deft branch-protection policy.\n" +
12
12
  " \u2022 Pre-commit + pre-push hooks will no longer block default-branch " +
@@ -114,7 +114,7 @@ export function parseShowArgs(argv) {
114
114
  /** Parse argv for the policy CLI (show + set subcommands). */
115
115
  export function parseArgs(argv) {
116
116
  if (argv.length === 0) {
117
- const usage = "usage: policy [show|enforce-branches|allow-direct-commits|allow-bot-merge|enable-value-feedback|clear-value-feedback|disable-directive|enable-directive|resolve] ...";
117
+ const usage = "usage: policy [show|enforce-branches|allow-direct-commits|allow-bot-merge|enable-value-feedback|clear-value-feedback|coverage-check-resume-preset|coverage-check-resume-dismiss|coverage-check-resume-later|disable-directive|enable-directive|resolve] ...";
118
118
  return makeSetError(usage);
119
119
  }
120
120
  const cmd = argv[0];
@@ -151,6 +151,9 @@ export function parseArgs(argv) {
151
151
  cmd === "allow-bot-merge" ||
152
152
  cmd === "enable-value-feedback" ||
153
153
  cmd === "clear-value-feedback" ||
154
+ cmd === "coverage-check-resume-preset" ||
155
+ cmd === "coverage-check-resume-dismiss" ||
156
+ cmd === "coverage-check-resume-later" ||
154
157
  cmd === "disable-directive" ||
155
158
  cmd === "enable-directive") {
156
159
  let confirm = false;
@@ -164,16 +167,44 @@ export function parseArgs(argv) {
164
167
  ? policyColonInvocation("enable-value-feedback")
165
168
  : cmd === "clear-value-feedback"
166
169
  ? policyColonInvocation("clear-value-feedback")
167
- : cmd === "disable-directive"
168
- ? policyColonInvocation("disable-directive")
169
- : policyColonInvocation("enable-directive");
170
+ : cmd === "coverage-check-resume-preset"
171
+ ? policyColonInvocation("coverage-check-resume-preset")
172
+ : cmd === "coverage-check-resume-dismiss"
173
+ ? policyColonInvocation("coverage-check-resume-dismiss")
174
+ : cmd === "coverage-check-resume-later"
175
+ ? policyColonInvocation("coverage-check-resume-later")
176
+ : cmd === "disable-directive"
177
+ ? policyColonInvocation("disable-directive")
178
+ : policyColonInvocation("enable-directive");
170
179
  let note = "";
171
180
  let projectRoot = ".";
181
+ let preset = "";
182
+ let reason = "";
172
183
  for (let i = 1; i < argv.length; i += 1) {
173
184
  const arg = argv[i];
174
185
  if (arg === "--confirm") {
175
186
  confirm = true;
176
187
  }
188
+ else if (arg === "--preset") {
189
+ const v = argv[i + 1];
190
+ if (v === undefined)
191
+ return makeSetError("argument --preset: expected one argument");
192
+ preset = v;
193
+ i += 1;
194
+ }
195
+ else if (arg?.startsWith("--preset=")) {
196
+ preset = arg.slice("--preset=".length);
197
+ }
198
+ else if (arg === "--reason") {
199
+ const v = argv[i + 1];
200
+ if (v === undefined)
201
+ return makeSetError("argument --reason: expected one argument");
202
+ reason = v;
203
+ i += 1;
204
+ }
205
+ else if (arg?.startsWith("--reason=")) {
206
+ reason = arg.slice("--reason=".length);
207
+ }
177
208
  else if (arg === "--actor") {
178
209
  const v = argv[i + 1];
179
210
  if (v === undefined)
@@ -204,6 +235,10 @@ export function parseArgs(argv) {
204
235
  else if (arg?.startsWith("--project-root=")) {
205
236
  projectRoot = arg.slice("--project-root=".length);
206
237
  }
238
+ else if (cmd === "coverage-check-resume-preset" &&
239
+ (arg === "strict" || arg === "hatch-aware")) {
240
+ preset = arg;
241
+ }
207
242
  else {
208
243
  return makeSetError(`unrecognized argument: ${arg}`);
209
244
  }
@@ -217,6 +252,8 @@ export function parseArgs(argv) {
217
252
  format: "text",
218
253
  changedOnly: false,
219
254
  field: null,
255
+ preset,
256
+ reason,
220
257
  };
221
258
  }
222
259
  return makeSetError(`unknown subcommand: ${cmd}`);
@@ -456,6 +493,15 @@ export function run(argv) {
456
493
  if (args.cmd === "clear-value-feedback") {
457
494
  return runClearValueFeedback(args);
458
495
  }
496
+ if (args.cmd === "coverage-check-resume-preset") {
497
+ return runCoverageCheckResumePreset(args);
498
+ }
499
+ if (args.cmd === "coverage-check-resume-dismiss") {
500
+ return runCoverageCheckResumeDismiss(args);
501
+ }
502
+ if (args.cmd === "coverage-check-resume-later") {
503
+ return runCoverageCheckResumeLater();
504
+ }
459
505
  if (args.cmd === "disable-directive") {
460
506
  return runDisableDirective(args);
461
507
  }
@@ -464,6 +510,42 @@ export function run(argv) {
464
510
  }
465
511
  return 2;
466
512
  }
513
+ /** Apply Strict or Hatch-aware coverageDebt+checkResume preset (#3189). */
514
+ function runCoverageCheckResumePreset(args) {
515
+ const root = pathResolve(args.projectRoot);
516
+ const preset = (args.preset ?? "").trim().toLowerCase();
517
+ if (preset !== "strict" && preset !== "hatch-aware") {
518
+ process.stdout.write("usage: policy coverage-check-resume-preset --preset strict|hatch-aware [--project-root PATH]\n" +
519
+ " (or: policy:coverage-check-resume-preset strict|hatch-aware)\n");
520
+ return 1;
521
+ }
522
+ const result = preset === "strict"
523
+ ? applyStrictCoverageCheckResumePreset(root, { actor: args.actor, note: args.note })
524
+ : applyHatchAwareCoverageCheckResumePreset(root, { actor: args.actor, note: args.note });
525
+ process.stdout.write(result.stdout);
526
+ return result.exitCode;
527
+ }
528
+ /** Dismiss-with-reason for coverageDebt+checkResume (#3189). */
529
+ function runCoverageCheckResumeDismiss(args) {
530
+ const root = pathResolve(args.projectRoot);
531
+ const reason = (args.reason ?? "").trim();
532
+ if (reason.length === 0) {
533
+ process.stdout.write("usage: policy coverage-check-resume-dismiss --reason TEXT [--project-root PATH]\n");
534
+ return 1;
535
+ }
536
+ const result = dismissCoverageCheckResume(root, reason, {
537
+ actor: args.actor,
538
+ note: args.note,
539
+ });
540
+ process.stdout.write(result.stdout);
541
+ return result.exitCode;
542
+ }
543
+ /** Later skip — no PROJECT-DEFINITION write (#3189). */
544
+ function runCoverageCheckResumeLater() {
545
+ const result = applyLaterCoverageCheckResumeSkip();
546
+ process.stdout.write(result.stdout);
547
+ return result.exitCode;
548
+ }
467
549
  if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
468
550
  process.exit(run(process.argv.slice(2)));
469
551
  }
@@ -12,6 +12,11 @@ export interface ParsedArgs {
12
12
  allowCrossRepo: boolean;
13
13
  /** Opt-in: include closed issues (default open-only, #3125). */
14
14
  includeClosed: boolean;
15
+ /**
16
+ * Opt-in re-enrich: re-plan already-stamped issues with additive label deltas
17
+ * (#3197). Requires --mirror; dry-run by default until --apply.
18
+ */
19
+ reEnrich: boolean;
15
20
  /** Raw --author value (LOGIN, @me, comma allow-list); null = no filter (#3129). */
16
21
  author: string | null;
17
22
  /** Apply batch size (rate-limit awareness). */
@@ -36,6 +36,7 @@ export function parseArgs(argv) {
36
36
  repo: null,
37
37
  allowCrossRepo: false,
38
38
  includeClosed: false,
39
+ reEnrich: false,
39
40
  author: null,
40
41
  batchSize: null,
41
42
  delayMs: null,
@@ -64,6 +65,9 @@ export function parseArgs(argv) {
64
65
  else if (arg === "--include-closed") {
65
66
  parsed.includeClosed = true;
66
67
  }
68
+ else if (arg === "--re-enrich") {
69
+ parsed.reEnrich = true;
70
+ }
67
71
  else if (arg === "--author-mine") {
68
72
  parsed.author = "@me";
69
73
  }
@@ -185,6 +189,12 @@ export function parseArgs(argv) {
185
189
  error: "--apply requires --mirror (Tier-1 label mirror / bootstrap mass-triage, #1423)",
186
190
  };
187
191
  }
192
+ if (parsed.reEnrich && !parsed.doMirror) {
193
+ return {
194
+ ...parsed,
195
+ error: "--re-enrich requires --mirror (additive re-plan of already-stamped issues, #3197)",
196
+ };
197
+ }
188
198
  if ((parsed.includeClosed ||
189
199
  parsed.author !== null ||
190
200
  parsed.batchSize !== null ||
@@ -244,6 +254,7 @@ export function run(argv, options = {}) {
244
254
  repo: args.repo,
245
255
  allowCrossRepo: args.allowCrossRepo,
246
256
  includeClosed: args.includeClosed,
257
+ reEnrich: args.reEnrich,
247
258
  ...(authorFilter !== null && authorFilter !== undefined ? { authorFilter } : {}),
248
259
  ...(args.batchSize !== null ? { batchSize: args.batchSize } : {}),
249
260
  ...(args.delayMs !== null ? { delayMs: args.delayMs } : {}),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deftai/directive",
3
- "version": "0.97.0",
3
+ "version": "0.98.0",
4
4
  "description": "Directive CLI — npm install path for the Deft Directive framework.",
5
5
  "license": "MIT",
6
6
  "homepage": "https://deftai.github.io/directive/",
@@ -34,8 +34,8 @@
34
34
  "provenance": true
35
35
  },
36
36
  "dependencies": {
37
- "@deftai/directive-core": "^0.97.0",
38
- "@deftai/directive-content": "^0.97.0"
37
+ "@deftai/directive-core": "^0.98.0",
38
+ "@deftai/directive-content": "^0.98.0"
39
39
  },
40
40
  "scripts": {
41
41
  "build": "tsc -b"