@davidbyoung/software-factory 0.1.8 → 0.1.10

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 (69) hide show
  1. package/README.md +2 -0
  2. package/dist/agent/claude-code.mjs +15 -21
  3. package/dist/board.d.mts +20 -3
  4. package/dist/board.mjs +124 -38
  5. package/dist/cli.mjs +84 -9
  6. package/dist/code-host/github-setup.mjs +2 -2
  7. package/dist/code-host/github.d.mts +1 -1
  8. package/dist/code-host/github.mjs +29 -2
  9. package/dist/code-host/types.d.mts +16 -1
  10. package/dist/code-host/types.mjs +8 -0
  11. package/dist/columns-suggest.d.mts +25 -6
  12. package/dist/columns-suggest.mjs +119 -29
  13. package/dist/commands.d.mts +5 -2
  14. package/dist/commands.mjs +37 -12
  15. package/dist/config.d.mts +25 -3
  16. package/dist/config.mjs +159 -33
  17. package/dist/doctor.d.mts +6 -1
  18. package/dist/doctor.mjs +78 -18
  19. package/dist/explain.d.mts +5 -0
  20. package/dist/explain.mjs +36 -1
  21. package/dist/init.d.mts +10 -0
  22. package/dist/init.mjs +133 -31
  23. package/dist/lib/color.d.mts +11 -0
  24. package/dist/lib/color.mjs +15 -0
  25. package/dist/lib/gh.d.mts +6 -0
  26. package/dist/lib/gh.mjs +11 -1
  27. package/dist/lib/listed.d.mts +3 -2
  28. package/dist/lib/listed.mjs +5 -4
  29. package/dist/poller.d.mts +1 -1
  30. package/dist/poller.mjs +9 -6
  31. package/dist/pr.mjs +9 -1
  32. package/dist/preset-commands.d.mts +2 -0
  33. package/dist/preset-commands.mjs +18 -12
  34. package/dist/preset.mjs +3 -2
  35. package/dist/setup.d.mts +3 -0
  36. package/dist/site.d.mts +3 -0
  37. package/dist/site.mjs +8 -1
  38. package/dist/status.d.mts +5 -2
  39. package/dist/status.mjs +13 -22
  40. package/dist/sync.d.mts +7 -1
  41. package/dist/sync.mjs +17 -5
  42. package/dist/ticket-fields.d.mts +84 -0
  43. package/dist/ticket-fields.mjs +374 -0
  44. package/dist/ticket.d.mts +3 -0
  45. package/dist/ticket.mjs +35 -8
  46. package/dist/tickets/github-setup.mjs +1 -1
  47. package/dist/tickets/github.mjs +69 -0
  48. package/dist/tickets/index.d.mts +8 -1
  49. package/dist/tickets/index.mjs +67 -7
  50. package/dist/tickets/types.d.mts +27 -1
  51. package/dist/tickets/types.mjs +4 -0
  52. package/dist/tools.d.mts +1 -1
  53. package/docs/builds.md +26 -13
  54. package/docs/cli.md +73 -36
  55. package/docs/configuration.md +264 -59
  56. package/docs/design.md +10 -0
  57. package/docs/developing.md +49 -18
  58. package/docs/existing-repo.md +184 -34
  59. package/docs/github/by-hand.md +13 -1
  60. package/docs/github/setup.md +14 -2
  61. package/docs/presets.md +15 -3
  62. package/docs/quick-start.md +3 -3
  63. package/docs/skills.md +3 -1
  64. package/docs/updating.md +132 -5
  65. package/docs/workflow.md +1 -1
  66. package/package.json +4 -2
  67. package/settings.schema.json +82 -20
  68. package/skills/factory-build/SKILL.md +39 -7
  69. package/skills/factory-deps/SKILL.md +6 -4
package/docs/updating.md CHANGED
@@ -3,8 +3,12 @@
3
3
  **When a new version is released, a pull request appears in your
4
4
  repository. You read it and merge it.** That is all you have to do.
5
5
 
6
- One release asks more of you, because it changes the shape of your
7
- settings file: [Moving to settings version 2](#moving-to-settings-version-2).
6
+ Three releases ask more of you, because they need lines in your
7
+ settings file that it doesn't have: [Moving to settings version
8
+ 2](#moving-to-settings-version-2) and [Naming build
9
+ branches](#naming-build-branches), for every repository, and [Naming
10
+ every column](#naming-every-column), for a repository whose settings
11
+ have a [`tickets.board`](configuration.md#tickets).
8
12
 
9
13
  ## What happens
10
14
 
@@ -91,8 +95,8 @@ and its checks fail until the file is moved. On the pull request's branch:
91
95
  4. Run `factory config check`, then `factory sync`, and commit what
92
96
  changed.
93
97
 
94
- **It worked when** `factory config check` prints nothing, and
95
- `factory sync --check` passes.
98
+ **It worked when** `factory config check` prints
99
+ `✓ The settings are valid.`, and `factory sync --check` passes.
96
100
 
97
101
  ### Each key that moved or changed shape
98
102
 
@@ -149,6 +153,10 @@ After:
149
153
  version: 2
150
154
  repository: your-name/your-repo
151
155
 
156
+ code-host:
157
+ type: github
158
+ branch-name: "{ticket}"
159
+
152
160
  specs: openspec
153
161
 
154
162
  commands:
@@ -207,6 +215,123 @@ needed, and the rest are worth a look while the file is open.
207
215
  branch is not `main` needs no setting: `factory sync` writes the
208
216
  branch's name where the workflows need it.
209
217
 
218
+ ## Naming every column
219
+
220
+ From this release, a repository with a board names a column for all six
221
+ states in [`tickets.columns`](configuration.md#ticketscolumns). Before
222
+ it, a state you left out used the factory's own column name, so a
223
+ repository set up earlier has no `columns` block, or one with only the
224
+ states whose column has another name. A repository with no
225
+ `tickets.board` needs nothing.
226
+
227
+ Until the block names all six, every command that reads the settings
228
+ stops with one of these, the second naming the states you left out:
229
+
230
+ ```text
231
+ .claude/factory.yaml: tickets.columns: is required with tickets.board: run factory init to choose which of board 3's columns shows each state
232
+ .claude/factory.yaml: tickets.columns: building and done have no column: give each a column, a list of columns, or none, or run factory init to choose them
233
+ ```
234
+
235
+ So on the factory's update pull request, `factory-deps`, which opens
236
+ and finishes it ([What happens](#what-happens)), cannot run
237
+ `factory sync`. It stops and opens an issue in your repository quoting
238
+ the line. Check out the pull request's branch, and from your
239
+ repository's root run:
240
+
241
+ ```bash
242
+ gh pr checkout 123 # the update pull request's number
243
+ factory init
244
+ ```
245
+
246
+ Init keeps everything your settings already say and adds only the
247
+ missing states. It shows the whole block it saves, the states you had
248
+ and the ones it added. A state whose column of the factory's name is on
249
+ your board, which is the column the factory was reading for it, is added
250
+ with no question:
251
+
252
+ ```text
253
+ Your settings give no column to building or done.
254
+ Board 3 has a column of the factory's name for each:
255
+
256
+ State Column
257
+ backlog Todo
258
+ refining none, shows in Todo
259
+ ready none
260
+ building In Progress
261
+ review Code review
262
+ done Done
263
+ ```
264
+
265
+ For a state whose column your board doesn't have, init asks which column
266
+ shows it, offering your columns, no column, or a new column with the
267
+ factory's name. When it needs Claude Code to suggest columns, it asks
268
+ as [You already have a board](existing-repo.md#you-already-have-a-board)
269
+ shows.
270
+
271
+ You can add the lines by hand instead. For each state your block leaves
272
+ out, the factory used the name in the table in
273
+ [`tickets.columns`](configuration.md#ticketscolumns), so write that name
274
+ to keep things as they were. If your board has no column of that name,
275
+ write one of your columns, or `none`.
276
+
277
+ Then run `factory sync`, which rewrites the factory's files for the new
278
+ version, commit what changed, `.claude/factory.yaml` included, and push.
279
+ The pull request's checks run again, and you close the issue
280
+ `factory-deps` opened.
281
+
282
+ **It worked when** `factory config check` prints
283
+ `✓ The settings are valid.`, and `factory sync --check` passes.
284
+
285
+ ## Naming build branches
286
+
287
+ From this release, every repository says how a build names its branch,
288
+ in [`code-host.branch-name`](configuration.md#code-host). Before it, a
289
+ build named its branch `issue-` with the ticket's number and a few words
290
+ of its title, such as `issue-47-terminal-color`, and no setting said so.
291
+ So a repository set up earlier has no `branch-name`, or writes
292
+ `code-host: github` on one line, and every command that reads the
293
+ settings stops with `code-host.branch-name: is required`.
294
+
295
+ There is no pattern that keeps the old names, since they held words a
296
+ session chose. The pattern you choose names new builds only: branches
297
+ already pushed keep their names, and their pull requests carry on as
298
+ before.
299
+
300
+ So on the factory's update pull request, `factory-deps` cannot run
301
+ `factory sync`. It stops and opens an issue in your repository quoting
302
+ the line. Check out the pull request's branch, and from your
303
+ repository's root run:
304
+
305
+ ```bash
306
+ gh pr checkout 123 # the update pull request's number
307
+ factory init
308
+ ```
309
+
310
+ Init keeps everything your settings already say, so it asks again only
311
+ what they lack: how a build names its branch, offering `{ticket}`. Press
312
+ Enter to keep it, or type your team's pattern, such as
313
+ `feature/{user}/{ticket}`; [`code-host`](configuration.md#code-host)
314
+ lists what a pattern can hold. If the update also needs [Naming every
315
+ column](#naming-every-column), the same run fills in both. When a
316
+ [preset](presets.md) you follow sets the pattern, init asks nothing.
317
+
318
+ You can add the lines by hand instead:
319
+
320
+ ```yaml
321
+ code-host:
322
+ type: github
323
+ branch-name: "{ticket}"
324
+ ```
325
+
326
+ Keep the quotes: without them, YAML reads `{ticket}` as a map rather
327
+ than as text. Then run `factory sync`, commit what changed,
328
+ `.claude/factory.yaml` included, and push. The pull request's checks run
329
+ again, and you close the issue `factory-deps` opened.
330
+
331
+ **It worked when** `factory config check` prints
332
+ `✓ The settings are valid.`, and `factory ticket branch 12` prints the
333
+ branch a build of ticket 12 would push.
334
+
210
335
  ## The commands
211
336
 
212
337
  | Command | When |
@@ -231,9 +356,11 @@ not match `package-lock.json`.
231
356
 
232
357
  | What you see | What happened | What to do |
233
358
  | ------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------- |
234
- | CI fails with "the factory's files are out of sync" | A factory file was edited by hand, or settings changed without a sync | Run `factory sync` and commit the result |
359
+ | CI fails with "of the factory's files don't match the settings" | A factory file was edited by hand, or settings changed without a sync | Run `factory sync` and commit the result |
235
360
  | `factory doctor` says your installed version is older than the repository's | You pulled an update and have not installed it | Run `npm ci` |
236
361
  | A command stops with `version: must be 2` | The update changed the shape of the settings file | [Move the file](#moving-to-settings-version-2) |
362
+ | A command stops with `tickets.columns: is required` or `have no column` | The update needs a column named for every state | [Name every column](#naming-every-column) |
363
+ | A command stops with `code-host.branch-name: is required` | The update needs the pattern a build names its branch by | [Name build branches](#naming-build-branches) |
237
364
  | A command stops with `.claude/factory.lock is from an earlier version of the factory` | The update's sync has not run on this checkout | Run `factory sync` and commit the result |
238
365
  | A command stops with `.claude/factory.yaml changed since the last sync` | The settings changed without a sync | Run `factory sync` and commit the result |
239
366
  | The update pull request conflicts with your default branch | Something else changed the same file | `factory-deps` resolves it on its next run, or close it and update by hand |
package/docs/workflow.md CHANGED
@@ -25,7 +25,7 @@ A ticket is always in one of six states. They are fixed: you cannot add one
25
25
  or reorder them. Your board shows them as columns, and which column shows
26
26
  which state is your repository's choice
27
27
  ([`tickets.columns`](configuration.md#ticketscolumns)). The table gives the
28
- default names.
28
+ names `factory init` gives the columns it adds.
29
29
 
30
30
  A state with no column of its own shows in the column of the nearest earlier
31
31
  state that has one, and a ticket is shown in the `ready` column only when it
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@davidbyoung/software-factory",
3
- "version": "0.1.8",
3
+ "version": "0.1.10",
4
4
  "description": "Refines, builds, and reviews tickets with Claude Code sessions, from a board to a merged pull request.",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -30,10 +30,11 @@
30
30
  ],
31
31
  "scripts": {
32
32
  "test": "vitest run",
33
+ "coverage": "vitest run --coverage",
33
34
  "typecheck": "tsc --noEmit",
34
35
  "format": "prettier --write .",
35
36
  "format:check": "prettier --check .",
36
- "check": "prettier --check . && tsc --noEmit && npm run -s spec:validate && node bin/factory.js sync --check && node bin/factory.js config check && vitest run",
37
+ "check": "prettier --check . && tsc --noEmit && npm run -s spec:validate && node bin/factory.js sync --check && node bin/factory.js config check && vitest run --coverage",
37
38
  "prepack": "tsc -p tsconfig.build.json",
38
39
  "pack-check": "node tests/pack-check.mts",
39
40
  "site-check": "node --test tests/site-check.mts",
@@ -51,6 +52,7 @@
51
52
  "@types/js-yaml": "^4.0.9",
52
53
  "@types/node": "^22.18.0",
53
54
  "@types/pngjs": "^6.0.5",
55
+ "@vitest/coverage-v8": "^5.1.0",
54
56
  "ajv": "^8.20.0",
55
57
  "playwright": "^1.65.0",
56
58
  "prettier": "^3.10.0",
@@ -36,7 +36,7 @@
36
36
  ]
37
37
  },
38
38
  "code-host": {
39
- "description": "Where pull requests are.",
39
+ "description": "Where pull requests are, and what a build names its branch.",
40
40
  "anyOf": [
41
41
  {
42
42
  "$ref": "#/definitions/code-host/properties/type"
@@ -114,74 +114,104 @@
114
114
  },
115
115
  "tickets.columns": {
116
116
  "type": "object",
117
- "description": "Which of your board's columns shows each state. Needs a board.",
117
+ "description": "Which of your board's columns shows each state. Needs a board. With a board, all six states are required, here or from a preset.",
118
118
  "additionalProperties": false,
119
119
  "properties": {
120
120
  "backlog": {
121
121
  "oneOf": [
122
- { "type": "string", "minLength": 1 },
122
+ {
123
+ "type": "string",
124
+ "minLength": 1
125
+ },
123
126
  {
124
127
  "type": "array",
125
128
  "minItems": 1,
126
- "items": { "type": "string", "minLength": 1 }
129
+ "items": {
130
+ "type": "string",
131
+ "minLength": 1
132
+ }
127
133
  }
128
134
  ],
129
- "description": "The board's column for the backlog state, or a list of its columns. Default: Backlog."
135
+ "description": "The board's column for the backlog state, or a list of its columns."
130
136
  },
131
137
  "refining": {
132
138
  "oneOf": [
133
- { "type": "string", "minLength": 1 },
139
+ {
140
+ "type": "string",
141
+ "minLength": 1
142
+ },
134
143
  {
135
144
  "type": "array",
136
145
  "minItems": 1,
137
- "items": { "type": "string", "minLength": 1 }
146
+ "items": {
147
+ "type": "string",
148
+ "minLength": 1
149
+ }
138
150
  }
139
151
  ],
140
- "description": "The board's column for the refining state, or a list of its columns. Default: In refinement. May be none."
152
+ "description": "The board's column for the refining state, or a list of its columns. May be none."
141
153
  },
142
154
  "ready": {
143
155
  "type": "string",
144
156
  "minLength": 1,
145
- "description": "The board's column for the ready state. Default: Ready. May be none."
157
+ "description": "The board's column for the ready state. May be none."
146
158
  },
147
159
  "building": {
148
160
  "oneOf": [
149
- { "type": "string", "minLength": 1 },
161
+ {
162
+ "type": "string",
163
+ "minLength": 1
164
+ },
150
165
  {
151
166
  "type": "array",
152
167
  "minItems": 1,
153
- "items": { "type": "string", "minLength": 1 }
168
+ "items": {
169
+ "type": "string",
170
+ "minLength": 1
171
+ }
154
172
  }
155
173
  ],
156
- "description": "The board's column for the building state, or a list of its columns. Default: In progress. May be none."
174
+ "description": "The board's column for the building state, or a list of its columns. May be none."
157
175
  },
158
176
  "review": {
159
177
  "oneOf": [
160
- { "type": "string", "minLength": 1 },
178
+ {
179
+ "type": "string",
180
+ "minLength": 1
181
+ },
161
182
  {
162
183
  "type": "array",
163
184
  "minItems": 1,
164
- "items": { "type": "string", "minLength": 1 }
185
+ "items": {
186
+ "type": "string",
187
+ "minLength": 1
188
+ }
165
189
  }
166
190
  ],
167
- "description": "The board's column for the review state, or a list of its columns. Default: In review. May be none."
191
+ "description": "The board's column for the review state, or a list of its columns. May be none."
168
192
  },
169
193
  "done": {
170
194
  "oneOf": [
171
- { "type": "string", "minLength": 1 },
195
+ {
196
+ "type": "string",
197
+ "minLength": 1
198
+ },
172
199
  {
173
200
  "type": "array",
174
201
  "minItems": 1,
175
- "items": { "type": "string", "minLength": 1 }
202
+ "items": {
203
+ "type": "string",
204
+ "minLength": 1
205
+ }
176
206
  }
177
207
  ],
178
- "description": "The board's column for the done state, or a list of its columns. Default: Done. May be none."
208
+ "description": "The board's column for the done state, or a list of its columns. May be none."
179
209
  }
180
210
  }
181
211
  },
182
212
  "tickets.fields": {
183
213
  "type": "object",
184
- "description": "Which of your board's fields the sync writes. Needs a board.",
214
+ "description": "Which of your fields holds each of the factory's fields: on the board, session, runs-in, and cost, which need a board; on the ticket, decisions, spec, acceptance-criteria, for-the-builder, and any heading of your own.",
185
215
  "additionalProperties": false,
186
216
  "properties": {
187
217
  "session": {
@@ -198,17 +228,49 @@
198
228
  "type": "string",
199
229
  "minLength": 1,
200
230
  "description": "The board's field the sync writes for cost. Default: Cost. May be none."
231
+ },
232
+ "decisions": {
233
+ "type": "string",
234
+ "minLength": 1,
235
+ "description": "The ticket field that holds Decisions. Default: none, the description. Spec and acceptance-criteria may name the same field."
236
+ },
237
+ "spec": {
238
+ "type": "string",
239
+ "minLength": 1,
240
+ "description": "The ticket field that holds Spec. Default: none, the description. Spec and acceptance-criteria may name the same field."
241
+ },
242
+ "acceptance-criteria": {
243
+ "type": "string",
244
+ "minLength": 1,
245
+ "description": "The ticket field that holds Acceptance criteria. Default: none, the description. Spec and acceptance-criteria may name the same field."
246
+ },
247
+ "for-the-builder": {
248
+ "type": "string",
249
+ "minLength": 1,
250
+ "description": "The ticket field that holds For the builder. Default: none, the description. Spec and acceptance-criteria may name the same field."
251
+ }
252
+ },
253
+ "patternProperties": {
254
+ "^[a-z0-9]+(-[a-z0-9]+)*$": {
255
+ "type": "string",
256
+ "minLength": 1,
257
+ "description": "The ticket field that holds a heading of your own: the heading in lowercase, with hyphens for spaces. May be none."
201
258
  }
202
259
  }
203
260
  },
204
261
  "code-host": {
205
262
  "type": "object",
206
- "description": "Where pull requests are.",
263
+ "description": "Where pull requests are, and what a build names its branch. branch-name is required, here or from a preset.",
207
264
  "additionalProperties": false,
208
265
  "properties": {
209
266
  "type": {
210
267
  "enum": ["github"],
211
268
  "description": "The code host. Default: github."
269
+ },
270
+ "branch-name": {
271
+ "type": "string",
272
+ "minLength": 1,
273
+ "description": "The pattern a build names its branch by: {ticket}, the ticket's number, which it must have, and {user}, the code host account the build runs as. Quote it, as \"{ticket}\" or \"feature/{user}/{ticket}\". No default: factory init asks for it."
212
274
  }
213
275
  }
214
276
  },
@@ -225,11 +225,40 @@ uncommitted changes onto the new branch, where the issue's commit would sweep
225
225
  them into its PR, and refuses outright when a changed file differs between
226
226
  the branches.
227
227
 
228
- Then, from the latest default branch on `origin`, named for the issue:
228
+ Then name the branch, as `code-host.branch-name` in the settings says,
229
+ and look for it on `origin`:
229
230
 
230
231
  ```bash
231
232
  git fetch origin
232
- git switch -c issue-N-short-slug origin/DEFAULT
233
+ npx --no-install factory ticket branch N # prints BRANCH
234
+ git ls-remote --exit-code origin refs/heads/BRANCH
235
+ ```
236
+
237
+ Give `ls-remote` the full ref: `--heads origin 12` also matches
238
+ `feature/someone/12`. Exit 2 means `origin` has no such branch: go on.
239
+ Exit 0 means an earlier build's branch is there, and its newest pull
240
+ request decides, from `npx --no-install factory pr for-branch BRANCH`:
241
+
242
+ - **`#M merged`,** and the commit `ls-remote` printed is
243
+ `npx --no-install factory pr view M --field head`: its work is on the
244
+ default branch. Delete it with `git push origin --delete BRANCH`, say
245
+ `Branch BRANCH's pull request #M merged; replacing it.`, and go on.
246
+ - **`#M open`:** stop ("The claim") with
247
+ `Branch BRANCH is already on origin, with open pull request #M. Work it with /factory-address-review M`.
248
+ - **Anything else,** or commits pushed after the merge: stop with
249
+ `Branch BRANCH is already on origin, with work no pull request merged. Open a pull request from it to keep that work, or delete it with: git push origin --delete BRANCH`.
250
+ A build that lost its claim pushed its branch to keep its work, and
251
+ this is how the owner keeps it.
252
+
253
+ No build carries on from an unmerged branch. A local branch of the same
254
+ name stops the build the same way, naming `git branch -D BRANCH` for the
255
+ owner to run once they have looked at its commits, unless its last
256
+ commit is the merged pull request's head: then switch away from it if
257
+ it is checked out, with `git switch --detach origin/DEFAULT`, and
258
+ delete it with the remote one. Then, from the latest default branch:
259
+
260
+ ```bash
261
+ git switch -c BRANCH origin/DEFAULT
233
262
  ```
234
263
 
235
264
  If the branch you left has commits not on `origin/DEFAULT`, name it in the
@@ -242,12 +271,15 @@ commit. Nothing in it is new; the thinking was done at refinement.
242
271
 
243
272
  ```bash
244
273
  export DO_NOT_TRACK=1
245
- npx --no-install openspec new change issue-N-short-slug
246
- npx --no-install openspec status --change issue-N-short-slug
274
+ npx --no-install factory specs change-name N # prints NAME
275
+ npx --no-install openspec new change NAME
276
+ npx --no-install openspec status --change NAME
247
277
  ```
248
278
 
249
- For each artifact `status` lists, run `npx --no-install openspec instructions <artifact>
250
- --change issue-N-short-slug` and fill it from the issue. An issue without
279
+ Read NAME once, here, and use it through step 4's archive, whatever
280
+ the branch is called. For each artifact `status` lists, run
281
+ `npx --no-install openspec instructions <artifact> --change NAME` and
282
+ fill it from the issue. An issue without
251
283
  the `spec` label fills `proposal.md` and the spec delta only; OpenSpec
252
284
  validates and archives a change without `design.md` or `tasks.md`.
253
285
 
@@ -336,7 +368,7 @@ Then fold the change into the specs, as the last commit before the pull
336
368
  request:
337
369
 
338
370
  ```bash
339
- DO_NOT_TRACK=1 npx --no-install openspec archive issue-N-short-slug --yes
371
+ DO_NOT_TRACK=1 npx --no-install openspec archive NAME --yes
340
372
  ```
341
373
 
342
374
  Then run the spec check, `npx --no-install factory specs check`.
@@ -146,10 +146,12 @@ npx --no-install factory sync
146
146
  ```
147
147
 
148
148
  When the sync itself fails on the settings after the update, the release
149
- changed the settings' shape, as version 2 does.
150
- Stop (step 6), and say the settings are the owner's to move, as "Moving to
151
- settings version 2" in the factory's `docs/updating.md` says for that
152
- release. Never edit `.claude/factory.yaml`.
149
+ needs lines the settings don't have, as version 2 and naming every
150
+ column do.
151
+ Stop (step 6), and say the settings are the owner's to change, naming the
152
+ release's section of the factory's `docs/updating.md`, such as "Moving to
153
+ settings version 2" or "Naming every column". Never edit
154
+ `.claude/factory.yaml`.
153
155
  When it fails on `.npmrc` instead, refusing a variable a sign-in line
154
156
  reads, stop the same way and say the name is the owner's to change:
155
157
  renaming it renames the secret and every developer's variable. Never edit