@bensandee/tooling 0.82.0 → 0.83.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.
Files changed (4) hide show
  1. package/README.md +16 -14
  2. package/dist/bin.mjs +25173 -26597
  3. package/package.json +5 -3
  4. package/tooling.schema.json +72 -36
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bensandee/tooling",
3
- "version": "0.82.0",
3
+ "version": "0.83.0",
4
4
  "description": "CLI tool to bootstrap and maintain standardized TypeScript project tooling",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -30,7 +30,7 @@
30
30
  "registry": "https://registry.npmjs.org"
31
31
  },
32
32
  "dependencies": {
33
- "@bensandee/common": "0.1.4",
33
+ "@bensandee/common": "0.2.0",
34
34
  "@clack/prompts": "^1.8.1",
35
35
  "citty": "^0.2.2",
36
36
  "cross-spawn": "^7.0.6",
@@ -44,13 +44,15 @@
44
44
  },
45
45
  "devDependencies": {
46
46
  "@bensandee/claude-hooks": "0.12.0",
47
- "@bensandee/forgejo": "0.6.0",
47
+ "@bensandee/cli-kit": "0.0.0",
48
+ "@bensandee/forgejo": "0.7.0",
48
49
  "@changesets/cli": "3.0.3",
49
50
  "@release-it/bumper": "8.0.1",
50
51
  "@types/cross-spawn": "6.0.6",
51
52
  "@types/node": "24.13.5",
52
53
  "@types/picomatch": "4.0.3",
53
54
  "commit-and-tag-version": "13.2.1",
55
+ "modern-web-guidance": "0.0.191",
54
56
  "oxfmt": "0.71.0",
55
57
  "prettier": "3.9.9",
56
58
  "release-it": "21.1.0",
package/tooling.schema.json CHANGED
@@ -649,6 +649,77 @@
649
649
  "triageAnalysis": {
650
650
  "description": "Whether the agent may route its own agent-note/human-triage-needed issues through the agent/analyze stage (default: off). Unlike agent.backlog, which defaults on, this defaults off: a backlog run batches every pending finding into one container, while triage routing spends one container per issue -- arming it is the reversible direction, not disarming it.",
651
651
  "type": "boolean"
652
+ },
653
+ "findingHolds": {
654
+ "description": "Which of a pull request's linked open findings withhold its unattended merge. `rules` is ordered and the first `when` that matches decides; no match falls through to `default`; an absent block is { rules: [], default: true }, so every open linked finding holds by default. Read off the repo's DEFAULT BRANCH, never off the pull request's own tree -- a pull request cannot edit the rule deciding whether it is held. In a `mentions` entry a /.../flags pattern is a regular expression and anything else is a case-insensitive substring.",
655
+ "type": "object",
656
+ "properties": {
657
+ "rules": {
658
+ "default": [],
659
+ "description": "Ordered rules; the first whose `when` matches decides, and no match falls through to `default`.",
660
+ "type": "array",
661
+ "items": {
662
+ "type": "object",
663
+ "properties": {
664
+ "when": {
665
+ "description": "The clause this rule matches on -- a conjunction of optional matchers, all of which must match. An absent clause matches every finding; a matcher that is present may not be empty.",
666
+ "type": "object",
667
+ "properties": {
668
+ "class": {
669
+ "description": "Match when the finding's class is any of these. Only human-decision findings become issues today, so this matcher exists for a class a later change files as one; it is declared now so a rule using it does not need the schema to change under it.",
670
+ "minItems": 1,
671
+ "type": "array",
672
+ "items": {
673
+ "type": "string",
674
+ "enum": ["human-decision", "pre-existing", "nit"]
675
+ }
676
+ },
677
+ "phase": {
678
+ "description": "Match when the phase of the run that filed the finding is any of these (review, spec, plan, implement, ...). Distinguishes, for example, a finding filed by spec work against a docs-only pull request from one a review raised on the code.",
679
+ "minItems": 1,
680
+ "type": "array",
681
+ "items": {
682
+ "type": "string",
683
+ "minLength": 1
684
+ }
685
+ },
686
+ "mentions": {
687
+ "description": "Match when the finding's title or body prose contains any of these. A plain string is a case-insensitive substring; a pattern written /.../flags is a regular expression. This is how a rule looks at which files a finding concerns: a finding about health-baseline.json says so in its text.",
688
+ "minItems": 1,
689
+ "type": "array",
690
+ "items": {
691
+ "type": "string",
692
+ "minLength": 1
693
+ }
694
+ },
695
+ "prLabels": {
696
+ "description": "Match when the pull request carries any of these labels (from the claim snapshot).",
697
+ "minItems": 1,
698
+ "type": "array",
699
+ "items": {
700
+ "type": "string",
701
+ "minLength": 1
702
+ }
703
+ }
704
+ },
705
+ "additionalProperties": false
706
+ },
707
+ "hold": {
708
+ "type": "boolean",
709
+ "description": "What this rule decides: true withholds the pull request from unattended merging, false lets it through."
710
+ }
711
+ },
712
+ "required": ["hold"],
713
+ "additionalProperties": false
714
+ }
715
+ },
716
+ "default": {
717
+ "default": true,
718
+ "description": "What to do with a finding no rule matched (default true -- hold). Failing closed is the deliberate shipped default: an unwanted hold costs one tap to answer the finding, while an unwanted pass is the problem the gate exists to prevent.",
719
+ "type": "boolean"
720
+ }
721
+ },
722
+ "additionalProperties": false
652
723
  }
653
724
  },
654
725
  "additionalProperties": false
@@ -664,7 +735,7 @@
664
735
  "maximum": 9007199254740991
665
736
  },
666
737
  "backupDays": {
667
- "description": "Days before bst branch:prune deletes an agent/(repair|rebase)-backup/* ref whose parent branch has no merged PR to key on (default 30). Deliberately longer than mergedDays: a backup ref is the only surviving copy of history rebased away from its parent. Zero is valid on purpose, matching the --backup-days CLI flag's contract.",
738
+ "description": "Days before bst branch:prune deletes an agent/(repair|rebase|failover)-backup/* ref whose parent branch has no merged PR to key on (default 30). Deliberately longer than mergedDays: a backup ref may be the only surviving copy of the work it holds. Zero is valid on purpose, matching the --backup-days CLI flag's contract.",
668
739
  "type": "integer",
669
740
  "minimum": 0,
670
741
  "maximum": 9007199254740991
@@ -679,41 +750,6 @@
679
750
  },
680
751
  "additionalProperties": false
681
752
  },
682
- "labelSets": {
683
- "description": "User-defined label sets for `bst forgejo:labels sync --set <name>`, keyed by set name. Read from the repo the command runs in, never from a --repo/--fleet target. A name that collides with a built-in set (e.g. the agent package's own 'agent' set) is a resolution-time error, not a silent override.",
684
- "type": "object",
685
- "propertyNames": {
686
- "type": "string"
687
- },
688
- "additionalProperties": {
689
- "type": "array",
690
- "items": {
691
- "type": "object",
692
- "properties": {
693
- "name": {
694
- "type": "string",
695
- "minLength": 1,
696
- "description": "The label's full name, e.g. 'area/frontend'"
697
- },
698
- "color": {
699
- "type": "string",
700
- "pattern": "^#[0-9a-fA-F]{6}$",
701
- "description": "Hex color with a leading '#', e.g. '#1f6feb'"
702
- },
703
- "description": {
704
- "type": "string",
705
- "description": "Shown in the forge UI beside the label"
706
- },
707
- "exclusive": {
708
- "description": "Forgejo scoped-label exclusivity: at most one label of this set's scope per issue/PR (default false)",
709
- "type": "boolean"
710
- }
711
- },
712
- "required": ["name", "color", "description"],
713
- "additionalProperties": false
714
- }
715
- }
716
- },
717
753
  "issues": {
718
754
  "description": "Repo-level issue policy -- currently just the default reviewer(s) `bst issue:create` assigns. The natural home for any future issue-policy key.",
719
755
  "type": "object",