@monte3l/groundwork 1.0.0-rc.4 → 1.0.0-rc.6
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/README.md +20 -5
- package/dist/customize-paths.d.ts +51 -15
- package/dist/customize-paths.js +32 -13
- package/dist/fs-guard.d.ts +2 -2
- package/dist/harness/rules.d.ts +2 -1
- package/dist/harness/rules.js +3 -1
- package/dist/inventory.d.ts +1 -1
- package/dist/inventory.js +5 -2
- package/dist/plugin.d.ts +12 -12
- package/dist/plugin.js +34 -26
- package/dist/report.js +74 -10
- package/dist/survey/survey-harness.d.ts +10 -2
- package/dist/survey/survey-harness.js +90 -4
- package/dist/survey/survey-shape.js +6 -3
- package/dist/survey/survey-toolchain.js +7 -9
- package/dist/survey/types.d.ts +33 -0
- package/dist/toolchain/grade.js +6 -7
- package/dist/toolchain/rules.d.ts +5 -3
- package/dist/toolchain/rules.js +6 -4
- package/package.json +1 -1
- package/plugin/skills/customize/SKILL.md +73 -408
- package/plugin/skills/customize/step-0-reconcile.md +265 -0
- package/plugin/skills/customize/step-3-round-1.md +171 -0
- package/plugin/src/domain-map.ts +2 -2
- package/plugin/src/kind-facet-map.ts +39 -9
- package/plugin/src/pack-map.ts +5 -3
- package/plugin/src/plugin-map.ts +154 -11
- package/templates/core/.claude/agents/Explore.md +1 -1
- package/templates/core/.claude/hooks/guard-hub-src-writes.mjs +7 -12
- package/templates/core/.claude/hooks/guard-no-commonjs.mjs +3 -2
- package/templates/core/.claude/hooks/inject-decision-gate.mjs +7 -7
- package/templates/core/.claude/rules/agent-dispatch.md +12 -7
- package/templates/core/.claude/rules/src.md +7 -4
- package/templates/core/.claude/rules/tests.md +2 -2
- package/templates/core/.claude/skills/finishing-work/SKILL.md +4 -3
- package/templates/core/.claude/skills/triaging-ci/SKILL.md +2 -2
- package/templates/core/.claude/skills/writing-commits/SKILL.md +4 -4
- package/templates/core/.prettierignore +1 -0
- package/templates/core/CLAUDE.md +28 -15
- package/templates/core/README.md +15 -3
- package/templates/core/_gitignore +1 -0
- package/templates/core/bin/check-exports.mjs +5 -3
- package/templates/core/bin/lib/harness-rules.mjs +3 -1
- package/templates/core/bin/lib/toolchain-rules.mjs +17 -9
- package/templates/core/bin/lint-commit.mjs +215 -10
- package/templates/core/tsconfig.base.json +10 -6
- package/templates/packs/README.md +25 -13
- package/templates/packs/github/files/.github/workflows/claude-pr-review.yml +3 -4
- package/templates/packs/github/files/.github/workflows/claude.yml +5 -8
- package/templates/packs/github/pack.json +1 -1
- package/templates/packs/harness-extras/files/.claude/hooks/guard-readonly-bash.mjs +3 -5
- package/templates/packs/harness-extras/files/.claude/hooks/subagent-statusline.mjs +29 -14
- package/templates/packs/harness-extras/pack.json +1 -1
- package/templates/packs/publishing/files/.github/workflows/release.yml +4 -7
- package/templates/packs/publishing/files/bin/pnpm-publish-shim.mjs +4 -14
- package/templates/packs/publishing/pack.json +1 -1
- package/templates/packs/quality/files/.claude/agents/type-design-analyzer.md +1 -1
- package/templates/packs/quality/pack.json +1 -1
- package/templates/packs/supply-chain/files/.github/workflows/scorecard.yml +4 -2
- package/templates/packs/supply-chain/pack.json +2 -2
- package/templates/packs/worktrees/pack.json +1 -1
package/README.md
CHANGED
|
@@ -7,11 +7,23 @@ project compares to that setup.
|
|
|
7
7
|
The offline bootstrapper behind [m3l-groundwork](https://github.com/monte3l/m3l-groundwork):
|
|
8
8
|
one deterministic CLI that either writes a baseline TypeScript toolchain and
|
|
9
9
|
Claude Code **harness** (its agents, skills, hooks, and settings) into an
|
|
10
|
-
empty directory (**fresh** mode) or surveys an existing project
|
|
11
|
-
|
|
12
|
-
it's for a project that already exists and shouldn't be rewritten
|
|
10
|
+
empty directory (**fresh** mode) or surveys an existing project (**adopt
|
|
11
|
+
mode**, for a project that already exists and shouldn't be rewritten
|
|
13
12
|
automatically).
|
|
14
13
|
|
|
14
|
+
Fresh mode writes the baseline, installs any `--pack`, installs the
|
|
15
|
+
`/customize` skill, runs `git init`, then runs `pnpm install`. If `git init`
|
|
16
|
+
or `pnpm install` fails, the project is already written to disk and the error
|
|
17
|
+
says what to run yourself.
|
|
18
|
+
|
|
19
|
+
Adopt mode never overwrites or removes a project file. It writes a report
|
|
20
|
+
(`.groundwork/adoption-report.md`), an inventory (`.groundwork/inventory.json`),
|
|
21
|
+
and inert `.staged` copies of the baseline files your project lacks
|
|
22
|
+
(`.groundwork/baseline/`) and of the packs that apply
|
|
23
|
+
(`.groundwork/packs/`), all under `.groundwork/`. It also adds one guarded
|
|
24
|
+
copy of the `/customize` skill at `.claude/skills/customize/`, or at
|
|
25
|
+
`.groundwork/customize/` when something already there blocks it.
|
|
26
|
+
|
|
15
27
|
```bash
|
|
16
28
|
# currently a 1.0.0 release candidate, shipping on the `rc` dist-tag
|
|
17
29
|
npx @monte3l/groundwork@rc my-new-project
|
|
@@ -21,10 +33,13 @@ npx @monte3l/groundwork@rc ../existing-project
|
|
|
21
33
|
|
|
22
34
|
Requires Node 24+. No prompts, and no network call beyond the `pnpm install` a
|
|
23
35
|
fresh bootstrap ends with (`--skip-install` to skip it). Run with `--help` for
|
|
24
|
-
every flag, or `--list-packs` for the optional packs.
|
|
36
|
+
every flag, or `--list-packs` for the optional packs. Exit `0` is success, `1`
|
|
37
|
+
is a runtime failure, and `2` is a bad invocation.
|
|
25
38
|
|
|
26
39
|
The `/customize` skill it installs, the packs, and the design are documented in
|
|
27
|
-
the [repository README](https://github.com/monte3l/m3l-groundwork/blob/main/README.md)
|
|
40
|
+
the [repository README](https://github.com/monte3l/m3l-groundwork/blob/main/README.md),
|
|
41
|
+
whose [versioning policy](https://github.com/monte3l/m3l-groundwork/blob/main/README.md#versioning-policy)
|
|
42
|
+
also lists the stable surfaces, including the adoption report's section headings.
|
|
28
43
|
Unfamiliar terms (harness, adopt mode, pack, and the rest) are defined in the
|
|
29
44
|
[glossary](https://github.com/monte3l/m3l-groundwork/blob/main/docs/glossary.md).
|
|
30
45
|
|
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* The skill's entry file:
|
|
3
|
-
*
|
|
4
|
-
*
|
|
2
|
+
* The skill's entry file: it lives under the plugin source's
|
|
3
|
+
* `skills/customize/` beside {@link CUSTOMIZE_SKILL_STEP_FILE_NAMES} (the
|
|
4
|
+
* backing-data files live under its `src/`), and it is the one payload file
|
|
5
|
+
* whose presence makes Claude Code load the skill -- which is why
|
|
5
6
|
* {@link CUSTOMIZE_SKILL_WRITE_ORDER} writes it last.
|
|
6
7
|
*
|
|
7
8
|
* @example
|
|
@@ -12,6 +13,24 @@
|
|
|
12
13
|
* ```
|
|
13
14
|
*/
|
|
14
15
|
export declare const CUSTOMIZE_SKILL_ENTRY_FILE = "SKILL.md";
|
|
16
|
+
/**
|
|
17
|
+
* The step files `SKILL.md` delegates to (Step 0's adopt-mode reconcile and
|
|
18
|
+
* Step 3's Round 1), sourced from the plugin's `skills/customize/` beside
|
|
19
|
+
* {@link CUSTOMIZE_SKILL_ENTRY_FILE}. Like the backing-data files, they are
|
|
20
|
+
* written before `SKILL.md`, so a loadable `SKILL.md` never sits beside a
|
|
21
|
+
* missing step file.
|
|
22
|
+
*
|
|
23
|
+
* @example
|
|
24
|
+
* ```ts
|
|
25
|
+
* import { CUSTOMIZE_SKILL_STEP_FILE_NAMES } from "./customize-paths.js";
|
|
26
|
+
*
|
|
27
|
+
* CUSTOMIZE_SKILL_STEP_FILE_NAMES[0]; // "step-0-reconcile.md"
|
|
28
|
+
* ```
|
|
29
|
+
*/
|
|
30
|
+
export declare const CUSTOMIZE_SKILL_STEP_FILE_NAMES: readonly [
|
|
31
|
+
"step-0-reconcile.md",
|
|
32
|
+
"step-3-round-1.md"
|
|
33
|
+
];
|
|
15
34
|
/**
|
|
16
35
|
* Every payload file's name inside an installed copy of the skill.
|
|
17
36
|
*
|
|
@@ -22,19 +41,28 @@ export declare const CUSTOMIZE_SKILL_ENTRY_FILE = "SKILL.md";
|
|
|
22
41
|
* CUSTOMIZE_SKILL_FILE_NAMES.includes("SKILL.md"); // true
|
|
23
42
|
* ```
|
|
24
43
|
*/
|
|
25
|
-
export declare const CUSTOMIZE_SKILL_FILE_NAMES: readonly [
|
|
44
|
+
export declare const CUSTOMIZE_SKILL_FILE_NAMES: readonly [
|
|
45
|
+
"SKILL.md",
|
|
46
|
+
"kind-facet-map.ts",
|
|
47
|
+
"domain-map.ts",
|
|
48
|
+
"pack-map.ts",
|
|
49
|
+
"plugin-map.ts",
|
|
50
|
+
"step-0-reconcile.md",
|
|
51
|
+
"step-3-round-1.md"
|
|
52
|
+
];
|
|
26
53
|
/**
|
|
27
|
-
* The order an install writes the payload in: every backing-data file
|
|
28
|
-
*
|
|
29
|
-
* (and whose rollback cannot remove everything) therefore never
|
|
30
|
-
* loadable `SKILL.md` beside missing or stale data files --
|
|
31
|
-
* precondition that no `SKILL.md` already sits at the destination.
|
|
32
|
-
* an install replaces existing entries -- fresh mode's
|
|
54
|
+
* The order an install writes the payload in: every backing-data file, then
|
|
55
|
+
* every step file, {@link CUSTOMIZE_SKILL_ENTRY_FILE} last. A run that fails
|
|
56
|
+
* part-way (and whose rollback cannot remove everything) therefore never
|
|
57
|
+
* leaves a loadable `SKILL.md` beside missing or stale data or step files --
|
|
58
|
+
* given the precondition that no `SKILL.md` already sits at the destination.
|
|
59
|
+
* Wherever an install replaces existing entries -- fresh mode's
|
|
33
60
|
* `.claude/skills/customize/` (a `--force` re-run over an earlier install)
|
|
34
61
|
* and the CLI-owned `.groundwork/customize/` -- `plugin.ts` establishes that
|
|
35
62
|
* precondition by removing any existing `SKILL.md` entry before the first
|
|
36
|
-
* data file is rewritten. Adopt mode's additive
|
|
37
|
-
* install only ever writes there when no
|
|
63
|
+
* data or step file is rewritten. Adopt mode's additive
|
|
64
|
+
* `.claude/skills/customize/` install only ever writes there when no
|
|
65
|
+
* `SKILL.md` entry exists.
|
|
38
66
|
*
|
|
39
67
|
* @example
|
|
40
68
|
* ```ts
|
|
@@ -43,7 +71,15 @@ export declare const CUSTOMIZE_SKILL_FILE_NAMES: readonly ["SKILL.md", "kind-fac
|
|
|
43
71
|
* CUSTOMIZE_SKILL_WRITE_ORDER.at(-1); // "SKILL.md"
|
|
44
72
|
* ```
|
|
45
73
|
*/
|
|
46
|
-
export declare const CUSTOMIZE_SKILL_WRITE_ORDER: readonly [
|
|
74
|
+
export declare const CUSTOMIZE_SKILL_WRITE_ORDER: readonly [
|
|
75
|
+
"kind-facet-map.ts",
|
|
76
|
+
"domain-map.ts",
|
|
77
|
+
"pack-map.ts",
|
|
78
|
+
"plugin-map.ts",
|
|
79
|
+
"step-0-reconcile.md",
|
|
80
|
+
"step-3-round-1.md",
|
|
81
|
+
"SKILL.md"
|
|
82
|
+
];
|
|
47
83
|
/**
|
|
48
84
|
* The fresh-mode destination -- and adopt mode's, when nothing is there yet
|
|
49
85
|
* or an earlier install was interrupted before its `SKILL.md` -- as path
|
|
@@ -63,7 +99,7 @@ export declare const CLAUDE_DEST_SEGMENTS: readonly [".claude", "skills", "custo
|
|
|
63
99
|
* project root. Used whenever {@link CLAUDE_DEST_SEGMENTS} cannot be written
|
|
64
100
|
* additively: a project-owned entry under any of the skill's payload names
|
|
65
101
|
* that is not this CLI's current copy (a differing file, a symlink, a
|
|
66
|
-
* directory, a `SKILL.md` without its data), or a component of
|
|
102
|
+
* directory, a `SKILL.md` without its data or step files), or a component of
|
|
67
103
|
* `.claude/skills/customize` that is a symlink or not a directory.
|
|
68
104
|
*
|
|
69
105
|
* @example
|
|
@@ -85,7 +121,7 @@ export declare const GROUNDWORK_DEST_SEGMENTS: readonly [".groundwork", "customi
|
|
|
85
121
|
* import { plannedCustomizeSkillPaths } from "./customize-paths.js";
|
|
86
122
|
*
|
|
87
123
|
* plannedCustomizeSkillPaths();
|
|
88
|
-
* // [".claude/skills/customize/SKILL.md", ..., ".groundwork/customize/
|
|
124
|
+
* // [".claude/skills/customize/SKILL.md", ..., ".groundwork/customize/step-3-round-1.md"]
|
|
89
125
|
* ```
|
|
90
126
|
*/
|
|
91
127
|
export declare function plannedCustomizeSkillPaths(): readonly string[];
|
package/dist/customize-paths.js
CHANGED
|
@@ -7,9 +7,10 @@
|
|
|
7
7
|
*/
|
|
8
8
|
import { join } from "node:path";
|
|
9
9
|
/**
|
|
10
|
-
* The skill's entry file:
|
|
11
|
-
*
|
|
12
|
-
*
|
|
10
|
+
* The skill's entry file: it lives under the plugin source's
|
|
11
|
+
* `skills/customize/` beside {@link CUSTOMIZE_SKILL_STEP_FILE_NAMES} (the
|
|
12
|
+
* backing-data files live under its `src/`), and it is the one payload file
|
|
13
|
+
* whose presence makes Claude Code load the skill -- which is why
|
|
13
14
|
* {@link CUSTOMIZE_SKILL_WRITE_ORDER} writes it last.
|
|
14
15
|
*
|
|
15
16
|
* @example
|
|
@@ -27,6 +28,21 @@ const CUSTOMIZE_SKILL_DATA_FILE_NAMES = [
|
|
|
27
28
|
"pack-map.ts",
|
|
28
29
|
"plugin-map.ts",
|
|
29
30
|
];
|
|
31
|
+
/**
|
|
32
|
+
* The step files `SKILL.md` delegates to (Step 0's adopt-mode reconcile and
|
|
33
|
+
* Step 3's Round 1), sourced from the plugin's `skills/customize/` beside
|
|
34
|
+
* {@link CUSTOMIZE_SKILL_ENTRY_FILE}. Like the backing-data files, they are
|
|
35
|
+
* written before `SKILL.md`, so a loadable `SKILL.md` never sits beside a
|
|
36
|
+
* missing step file.
|
|
37
|
+
*
|
|
38
|
+
* @example
|
|
39
|
+
* ```ts
|
|
40
|
+
* import { CUSTOMIZE_SKILL_STEP_FILE_NAMES } from "./customize-paths.js";
|
|
41
|
+
*
|
|
42
|
+
* CUSTOMIZE_SKILL_STEP_FILE_NAMES[0]; // "step-0-reconcile.md"
|
|
43
|
+
* ```
|
|
44
|
+
*/
|
|
45
|
+
export const CUSTOMIZE_SKILL_STEP_FILE_NAMES = ["step-0-reconcile.md", "step-3-round-1.md"];
|
|
30
46
|
/**
|
|
31
47
|
* Every payload file's name inside an installed copy of the skill.
|
|
32
48
|
*
|
|
@@ -40,19 +56,21 @@ const CUSTOMIZE_SKILL_DATA_FILE_NAMES = [
|
|
|
40
56
|
export const CUSTOMIZE_SKILL_FILE_NAMES = [
|
|
41
57
|
CUSTOMIZE_SKILL_ENTRY_FILE,
|
|
42
58
|
...CUSTOMIZE_SKILL_DATA_FILE_NAMES,
|
|
59
|
+
...CUSTOMIZE_SKILL_STEP_FILE_NAMES,
|
|
43
60
|
];
|
|
44
61
|
/**
|
|
45
|
-
* The order an install writes the payload in: every backing-data file
|
|
46
|
-
*
|
|
47
|
-
* (and whose rollback cannot remove everything) therefore never
|
|
48
|
-
* loadable `SKILL.md` beside missing or stale data files --
|
|
49
|
-
* precondition that no `SKILL.md` already sits at the destination.
|
|
50
|
-
* an install replaces existing entries -- fresh mode's
|
|
62
|
+
* The order an install writes the payload in: every backing-data file, then
|
|
63
|
+
* every step file, {@link CUSTOMIZE_SKILL_ENTRY_FILE} last. A run that fails
|
|
64
|
+
* part-way (and whose rollback cannot remove everything) therefore never
|
|
65
|
+
* leaves a loadable `SKILL.md` beside missing or stale data or step files --
|
|
66
|
+
* given the precondition that no `SKILL.md` already sits at the destination.
|
|
67
|
+
* Wherever an install replaces existing entries -- fresh mode's
|
|
51
68
|
* `.claude/skills/customize/` (a `--force` re-run over an earlier install)
|
|
52
69
|
* and the CLI-owned `.groundwork/customize/` -- `plugin.ts` establishes that
|
|
53
70
|
* precondition by removing any existing `SKILL.md` entry before the first
|
|
54
|
-
* data file is rewritten. Adopt mode's additive
|
|
55
|
-
* install only ever writes there when no
|
|
71
|
+
* data or step file is rewritten. Adopt mode's additive
|
|
72
|
+
* `.claude/skills/customize/` install only ever writes there when no
|
|
73
|
+
* `SKILL.md` entry exists.
|
|
56
74
|
*
|
|
57
75
|
* @example
|
|
58
76
|
* ```ts
|
|
@@ -63,6 +81,7 @@ export const CUSTOMIZE_SKILL_FILE_NAMES = [
|
|
|
63
81
|
*/
|
|
64
82
|
export const CUSTOMIZE_SKILL_WRITE_ORDER = [
|
|
65
83
|
...CUSTOMIZE_SKILL_DATA_FILE_NAMES,
|
|
84
|
+
...CUSTOMIZE_SKILL_STEP_FILE_NAMES,
|
|
66
85
|
CUSTOMIZE_SKILL_ENTRY_FILE,
|
|
67
86
|
];
|
|
68
87
|
/**
|
|
@@ -84,7 +103,7 @@ export const CLAUDE_DEST_SEGMENTS = [".claude", "skills", "customize"];
|
|
|
84
103
|
* project root. Used whenever {@link CLAUDE_DEST_SEGMENTS} cannot be written
|
|
85
104
|
* additively: a project-owned entry under any of the skill's payload names
|
|
86
105
|
* that is not this CLI's current copy (a differing file, a symlink, a
|
|
87
|
-
* directory, a `SKILL.md` without its data), or a component of
|
|
106
|
+
* directory, a `SKILL.md` without its data or step files), or a component of
|
|
88
107
|
* `.claude/skills/customize` that is a symlink or not a directory.
|
|
89
108
|
*
|
|
90
109
|
* @example
|
|
@@ -106,7 +125,7 @@ export const GROUNDWORK_DEST_SEGMENTS = [".groundwork", "customize"];
|
|
|
106
125
|
* import { plannedCustomizeSkillPaths } from "./customize-paths.js";
|
|
107
126
|
*
|
|
108
127
|
* plannedCustomizeSkillPaths();
|
|
109
|
-
* // [".claude/skills/customize/SKILL.md", ..., ".groundwork/customize/
|
|
128
|
+
* // [".claude/skills/customize/SKILL.md", ..., ".groundwork/customize/step-3-round-1.md"]
|
|
110
129
|
* ```
|
|
111
130
|
*/
|
|
112
131
|
export function plannedCustomizeSkillPaths() {
|
package/dist/fs-guard.d.ts
CHANGED
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
* endsWithRerunAdvice(message); // true
|
|
13
13
|
* ```
|
|
14
14
|
*/
|
|
15
|
-
export declare const FIX_AND_RERUN_ADVICE
|
|
15
|
+
export declare const FIX_AND_RERUN_ADVICE: string;
|
|
16
16
|
/**
|
|
17
17
|
* Whether `message` already ENDS with "re-run the CLI" advice, in any
|
|
18
18
|
* wording that ends that way (e.g. {@link assertNotSymlink}'s "remove it and
|
|
@@ -138,5 +138,5 @@ export declare function assertNotDirectory(path: string, advice: string): void;
|
|
|
138
138
|
* assertNotSymlink("/work/app/package.json", FRESH_SYMLINK_ADVICE);
|
|
139
139
|
* ```
|
|
140
140
|
*/
|
|
141
|
-
export declare const FRESH_SYMLINK_ADVICE
|
|
141
|
+
export declare const FRESH_SYMLINK_ADVICE: string;
|
|
142
142
|
//# sourceMappingURL=fs-guard.d.ts.map
|
package/dist/harness/rules.d.ts
CHANGED
|
@@ -59,7 +59,8 @@ export interface HarnessRule {
|
|
|
59
59
|
* Model ids and aliases the rubric accepts: the current ids and aliases, plus
|
|
60
60
|
* ids that were once listed here, kept until Anthropic deprecates them. The
|
|
61
61
|
* ids follow Anthropic's models overview and model-deprecations pages
|
|
62
|
-
* (retrieved 2026-10-
|
|
62
|
+
* (retrieved 2026-10-08): Haiku 5.5 (released 2026-10-07) is current, and
|
|
63
|
+
* Haiku 4.5 is legacy but still active. A legacy id that was never listed here is
|
|
63
64
|
* deliberately not added, so the rule keeps nudging pins toward current
|
|
64
65
|
* models. Bump alongside the `harness-guidance` refresh sweep;
|
|
65
66
|
* `templates/core/bin/lib/harness-rules.mjs` carries the same list and the
|
package/dist/harness/rules.js
CHANGED
|
@@ -20,7 +20,8 @@ import { fieldList, fieldText, parseFrontmatter } from "./frontmatter.js";
|
|
|
20
20
|
* Model ids and aliases the rubric accepts: the current ids and aliases, plus
|
|
21
21
|
* ids that were once listed here, kept until Anthropic deprecates them. The
|
|
22
22
|
* ids follow Anthropic's models overview and model-deprecations pages
|
|
23
|
-
* (retrieved 2026-10-
|
|
23
|
+
* (retrieved 2026-10-08): Haiku 5.5 (released 2026-10-07) is current, and
|
|
24
|
+
* Haiku 4.5 is legacy but still active. A legacy id that was never listed here is
|
|
24
25
|
* deliberately not added, so the rule keeps nudging pins toward current
|
|
25
26
|
* models. Bump alongside the `harness-guidance` refresh sweep;
|
|
26
27
|
* `templates/core/bin/lib/harness-rules.mjs` carries the same list and the
|
|
@@ -37,6 +38,7 @@ export const CURRENT_MODELS = [
|
|
|
37
38
|
"claude-sonnet-5",
|
|
38
39
|
"claude-sonnet-5-5",
|
|
39
40
|
"claude-fable-5-1",
|
|
41
|
+
"claude-haiku-5-5",
|
|
40
42
|
"claude-haiku-4-5",
|
|
41
43
|
"claude-haiku-4-5-20251001",
|
|
42
44
|
];
|
package/dist/inventory.d.ts
CHANGED
|
@@ -9,7 +9,7 @@ import type { PackWiring } from "./packs.js";
|
|
|
9
9
|
import type { ProjectSurvey } from "./survey/survey.js";
|
|
10
10
|
import type { ToolchainConformance } from "./toolchain/conformance.js";
|
|
11
11
|
import type { ToolchainGrade } from "./toolchain/types.js";
|
|
12
|
-
export declare const INVENTORY_SCHEMA_VERSION =
|
|
12
|
+
export declare const INVENTORY_SCHEMA_VERSION = 6;
|
|
13
13
|
/**
|
|
14
14
|
* Where adopt mode staged the baseline files the project lacks entirely
|
|
15
15
|
* (`baseline-stage.ts`), and how each staged copy is named.
|
package/dist/inventory.js
CHANGED
|
@@ -21,7 +21,10 @@
|
|
|
21
21
|
* (`pack-stage.ts`), its manifest included. No published release has
|
|
22
22
|
* written schema 5 yet; an inventory without `stagedPacks` came only from an
|
|
23
23
|
* unreleased development build, which staged packs unsuffixed at the same
|
|
24
|
-
* location.
|
|
24
|
+
* location. `schemaVersion` below 6 predates `survey.harness.pluginLayout`
|
|
25
|
+
* (`null`, or the `.claude-plugin/plugin.json` manifest plus which root
|
|
26
|
+
* plugin components exist) -- `/customize` then has no plugin-layout
|
|
27
|
+
* evidence and asks the project kind without pre-selecting one.
|
|
25
28
|
*/
|
|
26
29
|
import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
|
|
27
30
|
import { dirname, join } from "node:path";
|
|
@@ -29,7 +32,7 @@ import { fileURLToPath } from "node:url";
|
|
|
29
32
|
import { toPosixPath } from "./assets.js";
|
|
30
33
|
import { summarizeHarnessConformance } from "./harness/conformance.js";
|
|
31
34
|
import { summarizeToolchainConformance } from "./toolchain/conformance.js";
|
|
32
|
-
export const INVENTORY_SCHEMA_VERSION =
|
|
35
|
+
export const INVENTORY_SCHEMA_VERSION = 6;
|
|
33
36
|
/** Resolves this CLI package's own `package.json`, relative to this module's runtime location. */
|
|
34
37
|
function defaultPackageJsonPath() {
|
|
35
38
|
const here = dirname(fileURLToPath(import.meta.url));
|
package/dist/plugin.d.ts
CHANGED
|
@@ -89,20 +89,20 @@ export interface GuardedInstallResult {
|
|
|
89
89
|
* `fallbackCause` is `"component"` -- the entry (and any link target) is
|
|
90
90
|
* left untouched.
|
|
91
91
|
* - Otherwise, if every payload file already there is a regular file
|
|
92
|
-
* matching what this CLI ships byte-for-byte: with
|
|
93
|
-
* result is `"already-present"` (nothing written); with no
|
|
94
|
-
* (none at all, or an install interrupted before writing
|
|
95
|
-
* files are written into `.claude/skills/customize/`,
|
|
96
|
-
* never rewriting or removing the correct ones.
|
|
92
|
+
* matching what this CLI ships byte-for-byte: with every payload file
|
|
93
|
+
* present the result is `"already-present"` (nothing written); with no
|
|
94
|
+
* `SKILL.md` file (none at all, or an install interrupted before writing
|
|
95
|
+
* it) the missing files are written into `.claude/skills/customize/`,
|
|
96
|
+
* `SKILL.md` last, never rewriting or removing the correct ones.
|
|
97
97
|
* - Anything else under a payload name (a differing file, a regular file
|
|
98
98
|
* that cannot be read, a symlink -- dangling or not -- a directory, a
|
|
99
|
-
* `SKILL.md` without its data; detected by `lstat`) is kept
|
|
100
|
-
* project's own: the skill is written to `.groundwork/customize/`
|
|
101
|
-
* `fallbackReason` names that entry (saying so when it could not
|
|
102
|
-
* and `fallbackCause` is `"entry"`. Adopt mode never guesses at a
|
|
103
|
-
* entry it cannot compare, and the fallback does not guess either:
|
|
104
|
-
* leaves that entry exactly as it was. Claude Code does not load a
|
|
105
|
-
* from there; the caller must say so.
|
|
99
|
+
* `SKILL.md` without its data or step files; detected by `lstat`) is kept
|
|
100
|
+
* as the project's own: the skill is written to `.groundwork/customize/`
|
|
101
|
+
* instead, `fallbackReason` names that entry (saying so when it could not
|
|
102
|
+
* be read) and `fallbackCause` is `"entry"`. Adopt mode never guesses at a
|
|
103
|
+
* project entry it cannot compare, and the fallback does not guess either:
|
|
104
|
+
* it leaves that entry exactly as it was. Claude Code does not load a
|
|
105
|
+
* skill from there; the caller must say so.
|
|
106
106
|
*
|
|
107
107
|
* Writes into `.claude/skills/customize/` use `"wx"` only, so an entry that
|
|
108
108
|
* appears there mid-install fails the run (rolled back) rather than being
|
package/dist/plugin.js
CHANGED
|
@@ -4,14 +4,14 @@
|
|
|
4
4
|
* Installs the `/customize` skill into a bootstrapped or adopted project.
|
|
5
5
|
* Claude Code's marketplace-based plugin installation is an interactive,
|
|
6
6
|
* network-involving flow this offline CLI can't drive; instead this copies
|
|
7
|
-
* the skill's SKILL.md
|
|
8
|
-
* destination directory, so `/customize` works immediately with no
|
|
9
|
-
* setup step.
|
|
7
|
+
* the skill's SKILL.md, its step files and its deterministic backing data
|
|
8
|
+
* into a destination directory, so `/customize` works immediately with no
|
|
9
|
+
* further setup step.
|
|
10
10
|
*/
|
|
11
11
|
import { lstatSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
|
|
12
12
|
import { join } from "node:path";
|
|
13
13
|
import { resolveAsset } from "./assets.js";
|
|
14
|
-
import { CLAUDE_DEST_SEGMENTS, CUSTOMIZE_SKILL_ENTRY_FILE, CUSTOMIZE_SKILL_WRITE_ORDER, GROUNDWORK_DEST_SEGMENTS, } from "./customize-paths.js";
|
|
14
|
+
import { CLAUDE_DEST_SEGMENTS, CUSTOMIZE_SKILL_ENTRY_FILE, CUSTOMIZE_SKILL_STEP_FILE_NAMES, CUSTOMIZE_SKILL_WRITE_ORDER, GROUNDWORK_DEST_SEGMENTS, } from "./customize-paths.js";
|
|
15
15
|
import { assertNotSymlink, endsWithRerunAdvice, FIX_AND_RERUN_ADVICE, FRESH_RETRY, FRESH_SYMLINK_ADVICE, } from "./fs-guard.js";
|
|
16
16
|
/** Resolves the plugin payload for a source checkout (`packages/plugin`) or a published tarball (`plugin/`). */
|
|
17
17
|
function pluginDir() {
|
|
@@ -107,6 +107,14 @@ function errnoField(error, field) {
|
|
|
107
107
|
const value = Reflect.get(error, field);
|
|
108
108
|
return typeof value === "string" ? value : undefined;
|
|
109
109
|
}
|
|
110
|
+
/**
|
|
111
|
+
* The payload files sourced from the plugin's `skills/customize/` (the
|
|
112
|
+
* entry file and its step files); every other one comes from its `src/`.
|
|
113
|
+
*/
|
|
114
|
+
const SKILL_DIR_FILE_NAMES = new Set([
|
|
115
|
+
CUSTOMIZE_SKILL_ENTRY_FILE,
|
|
116
|
+
...CUSTOMIZE_SKILL_STEP_FILE_NAMES,
|
|
117
|
+
]);
|
|
110
118
|
/**
|
|
111
119
|
* Reads every payload file from the plugin source, in
|
|
112
120
|
* {@link CUSTOMIZE_SKILL_WRITE_ORDER} (`SKILL.md` last), before anything is
|
|
@@ -117,7 +125,7 @@ function errnoField(error, field) {
|
|
|
117
125
|
*/
|
|
118
126
|
function readCustomizeSkillPayload(sourceDir) {
|
|
119
127
|
return CUSTOMIZE_SKILL_WRITE_ORDER.map((name) => {
|
|
120
|
-
const from = name
|
|
128
|
+
const from = SKILL_DIR_FILE_NAMES.has(name)
|
|
121
129
|
? join(sourceDir, "skills", "customize", name)
|
|
122
130
|
: join(sourceDir, "src", name);
|
|
123
131
|
try {
|
|
@@ -201,13 +209,13 @@ function assertNoDirectoryAtPayloadNames(destDir, payload, alreadyCurrent, polic
|
|
|
201
209
|
/**
|
|
202
210
|
* For every policy that replaces existing entries: removes an existing
|
|
203
211
|
* `SKILL.md` entry (a file or a symlink, unlinked, never followed) BEFORE any
|
|
204
|
-
* data file is rewritten, so a later failure never leaves a stale
|
|
205
|
-
* loadable beside missing or half-rewritten data
|
|
206
|
-
* {@link assertNoDirectoryAtPayloadNames}, so a directory there
|
|
207
|
-
* been refused (one raced in since makes `rmSync` throw). Returns
|
|
208
|
-
* removed path, if any; throws (wrapped) before anything is written when
|
|
209
|
-
* removal fails. `label` is how the entry is described: `"existing"` for
|
|
210
|
-
* project's own `.claude/` copy, `"stale"` for the CLI-owned staging.
|
|
212
|
+
* data or step file is rewritten, so a later failure never leaves a stale
|
|
213
|
+
* `SKILL.md` loadable beside missing or half-rewritten data or step files.
|
|
214
|
+
* Runs after {@link assertNoDirectoryAtPayloadNames}, so a directory there
|
|
215
|
+
* has already been refused (one raced in since makes `rmSync` throw). Returns
|
|
216
|
+
* the removed path, if any; throws (wrapped) before anything is written when
|
|
217
|
+
* the removal fails. `label` is how the entry is described: `"existing"` for
|
|
218
|
+
* a project's own `.claude/` copy, `"stale"` for the CLI-owned staging.
|
|
211
219
|
*/
|
|
212
220
|
function removeStaleSkillEntry(destDir, label) {
|
|
213
221
|
const staleEntry = join(destDir, CUSTOMIZE_SKILL_ENTRY_FILE);
|
|
@@ -323,8 +331,8 @@ function replacedClause(policy, skillRemoved, replaced, skillMaybeLeft) {
|
|
|
323
331
|
if (skillRemoved === undefined && others === "") {
|
|
324
332
|
return "";
|
|
325
333
|
}
|
|
326
|
-
// One sentence for SKILL.md and the
|
|
327
|
-
// them was removed and none is restored.
|
|
334
|
+
// One sentence for SKILL.md and the other payload files alike: every
|
|
335
|
+
// one of them was removed and none is restored.
|
|
328
336
|
const removedPaths = [
|
|
329
337
|
...(skillRemoved === undefined
|
|
330
338
|
? []
|
|
@@ -668,20 +676,20 @@ function installGuarded(targetDir, sourceDir) {
|
|
|
668
676
|
* `fallbackCause` is `"component"` -- the entry (and any link target) is
|
|
669
677
|
* left untouched.
|
|
670
678
|
* - Otherwise, if every payload file already there is a regular file
|
|
671
|
-
* matching what this CLI ships byte-for-byte: with
|
|
672
|
-
* result is `"already-present"` (nothing written); with no
|
|
673
|
-
* (none at all, or an install interrupted before writing
|
|
674
|
-
* files are written into `.claude/skills/customize/`,
|
|
675
|
-
* never rewriting or removing the correct ones.
|
|
679
|
+
* matching what this CLI ships byte-for-byte: with every payload file
|
|
680
|
+
* present the result is `"already-present"` (nothing written); with no
|
|
681
|
+
* `SKILL.md` file (none at all, or an install interrupted before writing
|
|
682
|
+
* it) the missing files are written into `.claude/skills/customize/`,
|
|
683
|
+
* `SKILL.md` last, never rewriting or removing the correct ones.
|
|
676
684
|
* - Anything else under a payload name (a differing file, a regular file
|
|
677
685
|
* that cannot be read, a symlink -- dangling or not -- a directory, a
|
|
678
|
-
* `SKILL.md` without its data; detected by `lstat`) is kept
|
|
679
|
-
* project's own: the skill is written to `.groundwork/customize/`
|
|
680
|
-
* `fallbackReason` names that entry (saying so when it could not
|
|
681
|
-
* and `fallbackCause` is `"entry"`. Adopt mode never guesses at a
|
|
682
|
-
* entry it cannot compare, and the fallback does not guess either:
|
|
683
|
-
* leaves that entry exactly as it was. Claude Code does not load a
|
|
684
|
-
* from there; the caller must say so.
|
|
686
|
+
* `SKILL.md` without its data or step files; detected by `lstat`) is kept
|
|
687
|
+
* as the project's own: the skill is written to `.groundwork/customize/`
|
|
688
|
+
* instead, `fallbackReason` names that entry (saying so when it could not
|
|
689
|
+
* be read) and `fallbackCause` is `"entry"`. Adopt mode never guesses at a
|
|
690
|
+
* project entry it cannot compare, and the fallback does not guess either:
|
|
691
|
+
* it leaves that entry exactly as it was. Claude Code does not load a
|
|
692
|
+
* skill from there; the caller must say so.
|
|
685
693
|
*
|
|
686
694
|
* Writes into `.claude/skills/customize/` use `"wx"` only, so an entry that
|
|
687
695
|
* appears there mid-install fails the run (rolled back) rather than being
|
package/dist/report.js
CHANGED
|
@@ -25,7 +25,13 @@ function estimatePostMergeCaps(inventory) {
|
|
|
25
25
|
},
|
|
26
26
|
};
|
|
27
27
|
}
|
|
28
|
-
/**
|
|
28
|
+
/**
|
|
29
|
+
* Sums the declared `budget` of every listed pack adopt mode can install
|
|
30
|
+
* (`modes` includes `"adopt"`) -- the "if every adoptable pack were
|
|
31
|
+
* installed" delta, not just the ones a user will choose. A fresh-only pack
|
|
32
|
+
* (e.g. `publishing`) is left out: adopt mode cannot install it, so counting
|
|
33
|
+
* it would flag a cap no adopt run can reach.
|
|
34
|
+
*/
|
|
29
35
|
function sumPackBudgets(packs) {
|
|
30
36
|
const total = {
|
|
31
37
|
agents: 0,
|
|
@@ -35,6 +41,8 @@ function sumPackBudgets(packs) {
|
|
|
35
41
|
scripts: 0,
|
|
36
42
|
};
|
|
37
43
|
for (const pack of packs) {
|
|
44
|
+
if (!pack.modes.includes("adopt"))
|
|
45
|
+
continue;
|
|
38
46
|
total.agents += pack.budget.agents;
|
|
39
47
|
total.skills += pack.budget.skills;
|
|
40
48
|
total.hooks += pack.budget.hooks;
|
|
@@ -55,10 +63,23 @@ function renderShapeSection(inventory) {
|
|
|
55
63
|
`- Node pin: ${s.nodeVersionPin ? `${s.nodeVersionPin.value} (${s.nodeVersionPin.source})` : "none found"}`,
|
|
56
64
|
`- Source layout: ${s.sourceLayout}`,
|
|
57
65
|
`- Test placement: ${s.testPlacement}`,
|
|
58
|
-
`- Kind evidence: exports map=${s.kindEvidence.hasExportsMap}, bin=${s.kindEvidence.hasBinField}, main=${s.kindEvidence.hasMainField}, framework deps=${s.kindEvidence.frameworkDeps.join(", ") || "none"}`,
|
|
66
|
+
`- Kind evidence: exports map=${s.kindEvidence.hasExportsMap}, bin=${s.kindEvidence.hasBinField}, main=${s.kindEvidence.hasMainField}, framework deps=${s.kindEvidence.frameworkDeps.join(", ") || "none"}, claude plugin manifest=${pluginManifestEvidence(inventory)}`,
|
|
59
67
|
];
|
|
60
68
|
return lines.join("\n");
|
|
61
69
|
}
|
|
70
|
+
/**
|
|
71
|
+
* The kind-evidence `claude plugin manifest` value: `true` when a plugin
|
|
72
|
+
* layout was recorded, `unknown` when none was but some `undetermined` note
|
|
73
|
+
* names a `.claude-plugin` path (a probe that could not be made), else
|
|
74
|
+
* `false`.
|
|
75
|
+
*/
|
|
76
|
+
function pluginManifestEvidence(inventory) {
|
|
77
|
+
if (inventory.survey.harness.pluginLayout != null)
|
|
78
|
+
return "true";
|
|
79
|
+
return inventory.survey.undetermined.some((entry) => entry.includes(".claude-plugin"))
|
|
80
|
+
? "unknown (see Could not be determined)"
|
|
81
|
+
: "false";
|
|
82
|
+
}
|
|
62
83
|
function renderToolchainSection(inventory) {
|
|
63
84
|
const t = inventory.survey.toolchain;
|
|
64
85
|
const lines = [
|
|
@@ -75,6 +96,39 @@ function renderToolchainSection(inventory) {
|
|
|
75
96
|
];
|
|
76
97
|
return lines.join("\n");
|
|
77
98
|
}
|
|
99
|
+
/** The "- Plugin layout: ..." line for a plugin repository, or nothing. */
|
|
100
|
+
function pluginLayoutLines(layout) {
|
|
101
|
+
if (layout == null)
|
|
102
|
+
return [];
|
|
103
|
+
const components = layout.components.length > 0 ? layout.components.join(", ") : "none";
|
|
104
|
+
return [`- Plugin layout: ${layout.manifest}; components: ${components}`];
|
|
105
|
+
}
|
|
106
|
+
/** The harness grade's scope note for a plugin repository, or nothing. */
|
|
107
|
+
function pluginScopeLines(layout) {
|
|
108
|
+
if (layout == null)
|
|
109
|
+
return [];
|
|
110
|
+
return [
|
|
111
|
+
"Plugin components at the repository root are outside the harness grader's scope (it reads .claude/ and CLAUDE.md).",
|
|
112
|
+
];
|
|
113
|
+
}
|
|
114
|
+
/** Total checks across every rubric category of a grade. */
|
|
115
|
+
function rubricTotal(rubric) {
|
|
116
|
+
return Object.values(rubric).reduce((sum, tally) => sum + tally.checked, 0);
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* The wiring and quality lines of a grade section, each half rendered on its
|
|
120
|
+
* own: a half with no checks applied says so instead of printing a vacuous
|
|
121
|
+
* "0 of 0" or a 100% over nothing.
|
|
122
|
+
*/
|
|
123
|
+
function gradeHalvesLines(structural, rubricChecked, rubricScore) {
|
|
124
|
+
const wiring = structural.checked === 0
|
|
125
|
+
? "- **Wiring (structural):** no checks applied (nothing found, or nothing the grader could read)."
|
|
126
|
+
: `- **Wiring (structural):** ${structural.checked - structural.failed} of ${structural.checked} checks pass.`;
|
|
127
|
+
const quality = rubricChecked === 0
|
|
128
|
+
? "- **Quality (rubric):** no checks applied."
|
|
129
|
+
: `- **Quality (rubric):** ${Math.round(rubricScore * 100)}% over ${rubricChecked} checks -- advisory, never a blocker.`;
|
|
130
|
+
return [wiring, quality];
|
|
131
|
+
}
|
|
78
132
|
function renderHarnessSection(inventory) {
|
|
79
133
|
const h = inventory.survey.harness;
|
|
80
134
|
if (!h.present) {
|
|
@@ -82,6 +136,7 @@ function renderHarnessSection(inventory) {
|
|
|
82
136
|
"## Existing Claude Code harness",
|
|
83
137
|
"",
|
|
84
138
|
"No `.claude/` directory found -- the baseline harness would be entirely new.",
|
|
139
|
+
...pluginLayoutLines(h.pluginLayout),
|
|
85
140
|
].join("\n");
|
|
86
141
|
}
|
|
87
142
|
const lines = [
|
|
@@ -93,6 +148,7 @@ function renderHarnessSection(inventory) {
|
|
|
93
148
|
`- Rules: ${h.rules.length > 0 ? h.rules.map((r) => r.name).join(", ") : "none"}`,
|
|
94
149
|
`- Commands: ${h.commands.length > 0 ? h.commands.join(", ") : "none"}`,
|
|
95
150
|
`- settings.local.json present: ${h.hasSettingsLocal}`,
|
|
151
|
+
...pluginLayoutLines(h.pluginLayout),
|
|
96
152
|
];
|
|
97
153
|
return lines.join("\n");
|
|
98
154
|
}
|
|
@@ -113,12 +169,12 @@ function renderDocsSection(inventory) {
|
|
|
113
169
|
function renderToolchainGradeSection(inventory) {
|
|
114
170
|
const { toolchainGrade: grade, toolchainConformance: conformance } = inventory;
|
|
115
171
|
const lines = ["## Toolchain grade", ""];
|
|
116
|
-
const rubricChecked =
|
|
172
|
+
const rubricChecked = rubricTotal(grade.rubric);
|
|
117
173
|
if (grade.structural.checked === 0 && rubricChecked === 0) {
|
|
118
174
|
lines.push("No TypeScript toolchain files (tsconfig, ESLint or vitest config, verify steps) found -- nothing to grade.");
|
|
119
175
|
return lines.join("\n");
|
|
120
176
|
}
|
|
121
|
-
lines.push(
|
|
177
|
+
lines.push(...gradeHalvesLines(grade.structural, rubricChecked, grade.rubricScore), `- **Drift from the baseline toolchain:** ${conformance.identical} identical, ${conformance.divergent} divergent, ${conformance.absent} absent. ` +
|
|
122
178
|
"Informational only -- `/customize` rewrites the baseline on purpose, so divergence is not a defect.");
|
|
123
179
|
const structural = grade.findings.filter((f) => f.level === "structural");
|
|
124
180
|
const rubric = grade.findings.filter((f) => f.level === "rubric");
|
|
@@ -149,11 +205,17 @@ function renderHarnessGradeSection(inventory) {
|
|
|
149
205
|
const lines = ["## Harness grade", ""];
|
|
150
206
|
if (!harness.present && !harness.hasClaudeMd) {
|
|
151
207
|
lines.push("No `.claude/` directory or `CLAUDE.md` found -- nothing to grade.");
|
|
208
|
+
const scope = pluginScopeLines(harness.pluginLayout);
|
|
209
|
+
if (scope.length > 0)
|
|
210
|
+
lines.push("", ...scope);
|
|
152
211
|
return lines.join("\n");
|
|
153
212
|
}
|
|
154
|
-
const rubricChecked =
|
|
155
|
-
lines.push(
|
|
213
|
+
const rubricChecked = rubricTotal(grade.rubric);
|
|
214
|
+
lines.push(...gradeHalvesLines(grade.structural, rubricChecked, grade.rubricScore), `- **Drift from the baseline harness:** ${conformance.identical} identical, ${conformance.divergent} divergent, ${conformance.absent} absent. ` +
|
|
156
215
|
"Informational only -- `/customize` rewrites the baseline on purpose, so divergence is not a defect.");
|
|
216
|
+
const scope = pluginScopeLines(harness.pluginLayout);
|
|
217
|
+
if (scope.length > 0)
|
|
218
|
+
lines.push("", ...scope);
|
|
157
219
|
const structural = grade.findings.filter((f) => f.level === "structural");
|
|
158
220
|
const rubric = grade.findings.filter((f) => f.level === "rubric");
|
|
159
221
|
lines.push("", "### Wiring findings", "");
|
|
@@ -185,13 +247,13 @@ function renderCapsSection(inventory) {
|
|
|
185
247
|
const packBudget = sumPackBudgets(inventory.packs);
|
|
186
248
|
const overCap = (count, cap) => count > cap ? " ⚠ over cap" : "";
|
|
187
249
|
const header = hasPacks
|
|
188
|
-
? "| Artifact | Baseline | Existing project | +
|
|
250
|
+
? "| Artifact | Baseline | Existing project | + adopt packs | Post-merge (approx.) | Cap |"
|
|
189
251
|
: "| Artifact | Baseline | Existing project | Post-merge (approx.) | Cap |";
|
|
190
252
|
const divider = hasPacks
|
|
191
253
|
? "| --- | --- | --- | --- | --- | --- |"
|
|
192
254
|
: "| --- | --- | --- | --- | --- |";
|
|
193
255
|
const row = (label, key, existingCount, cap) => {
|
|
194
|
-
// The shown total (and its over-cap flag) includes the "+
|
|
256
|
+
// The shown total (and its over-cap flag) includes the "+ adopt packs"
|
|
195
257
|
// column, so a pack that tips a cap over is flagged, not just listed.
|
|
196
258
|
const total = postMerge[key] + (hasPacks ? packBudget[key] : 0);
|
|
197
259
|
const cells = [label, String(baseline[key]), String(existingCount)];
|
|
@@ -214,8 +276,10 @@ function renderCapsSection(inventory) {
|
|
|
214
276
|
"This is an approximate count assuming no name overlap; `/customize`'s Step 0 resolves it for real.",
|
|
215
277
|
];
|
|
216
278
|
if (hasPacks) {
|
|
217
|
-
lines.push("", '"+
|
|
218
|
-
|
|
279
|
+
lines.push("", '"+ adopt packs" sums every adopt-capable pack listed below, not just the ' +
|
|
280
|
+
"ones you choose to install; fresh-only packs (e.g. `publishing`) are " +
|
|
281
|
+
"excluded because adopt mode cannot install them -- see " +
|
|
282
|
+
'"## Available packs" for every pack\'s numbers.');
|
|
219
283
|
}
|
|
220
284
|
return lines.join("\n");
|
|
221
285
|
}
|