@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.
- package/README.md +2 -0
- package/dist/agent/claude-code.mjs +15 -21
- package/dist/board.d.mts +20 -3
- package/dist/board.mjs +124 -38
- package/dist/cli.mjs +84 -9
- package/dist/code-host/github-setup.mjs +2 -2
- package/dist/code-host/github.d.mts +1 -1
- package/dist/code-host/github.mjs +29 -2
- package/dist/code-host/types.d.mts +16 -1
- package/dist/code-host/types.mjs +8 -0
- package/dist/columns-suggest.d.mts +25 -6
- package/dist/columns-suggest.mjs +119 -29
- package/dist/commands.d.mts +5 -2
- package/dist/commands.mjs +37 -12
- package/dist/config.d.mts +25 -3
- package/dist/config.mjs +159 -33
- package/dist/doctor.d.mts +6 -1
- package/dist/doctor.mjs +78 -18
- package/dist/explain.d.mts +5 -0
- package/dist/explain.mjs +36 -1
- package/dist/init.d.mts +10 -0
- package/dist/init.mjs +133 -31
- package/dist/lib/color.d.mts +11 -0
- package/dist/lib/color.mjs +15 -0
- package/dist/lib/gh.d.mts +6 -0
- package/dist/lib/gh.mjs +11 -1
- package/dist/lib/listed.d.mts +3 -2
- package/dist/lib/listed.mjs +5 -4
- package/dist/poller.d.mts +1 -1
- package/dist/poller.mjs +9 -6
- package/dist/pr.mjs +9 -1
- package/dist/preset-commands.d.mts +2 -0
- package/dist/preset-commands.mjs +18 -12
- package/dist/preset.mjs +3 -2
- package/dist/setup.d.mts +3 -0
- package/dist/site.d.mts +3 -0
- package/dist/site.mjs +8 -1
- package/dist/status.d.mts +5 -2
- package/dist/status.mjs +13 -22
- package/dist/sync.d.mts +7 -1
- package/dist/sync.mjs +17 -5
- package/dist/ticket-fields.d.mts +84 -0
- package/dist/ticket-fields.mjs +374 -0
- package/dist/ticket.d.mts +3 -0
- package/dist/ticket.mjs +35 -8
- package/dist/tickets/github-setup.mjs +1 -1
- package/dist/tickets/github.mjs +69 -0
- package/dist/tickets/index.d.mts +8 -1
- package/dist/tickets/index.mjs +67 -7
- package/dist/tickets/types.d.mts +27 -1
- package/dist/tickets/types.mjs +4 -0
- package/dist/tools.d.mts +1 -1
- package/docs/builds.md +26 -13
- package/docs/cli.md +73 -36
- package/docs/configuration.md +264 -59
- package/docs/design.md +10 -0
- package/docs/developing.md +49 -18
- package/docs/existing-repo.md +184 -34
- package/docs/github/by-hand.md +13 -1
- package/docs/github/setup.md +14 -2
- package/docs/presets.md +15 -3
- package/docs/quick-start.md +3 -3
- package/docs/skills.md +3 -1
- package/docs/updating.md +132 -5
- package/docs/workflow.md +1 -1
- package/package.json +4 -2
- package/settings.schema.json +82 -20
- package/skills/factory-build/SKILL.md +39 -7
- 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
|
-
|
|
7
|
-
settings file: [Moving to settings version
|
|
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
|
|
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
|
|
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
|
-
|
|
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.
|
|
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",
|
package/settings.schema.json
CHANGED
|
@@ -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
|
-
{
|
|
122
|
+
{
|
|
123
|
+
"type": "string",
|
|
124
|
+
"minLength": 1
|
|
125
|
+
},
|
|
123
126
|
{
|
|
124
127
|
"type": "array",
|
|
125
128
|
"minItems": 1,
|
|
126
|
-
"items": {
|
|
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.
|
|
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
|
-
{
|
|
139
|
+
{
|
|
140
|
+
"type": "string",
|
|
141
|
+
"minLength": 1
|
|
142
|
+
},
|
|
134
143
|
{
|
|
135
144
|
"type": "array",
|
|
136
145
|
"minItems": 1,
|
|
137
|
-
"items": {
|
|
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.
|
|
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.
|
|
157
|
+
"description": "The board's column for the ready state. May be none."
|
|
146
158
|
},
|
|
147
159
|
"building": {
|
|
148
160
|
"oneOf": [
|
|
149
|
-
{
|
|
161
|
+
{
|
|
162
|
+
"type": "string",
|
|
163
|
+
"minLength": 1
|
|
164
|
+
},
|
|
150
165
|
{
|
|
151
166
|
"type": "array",
|
|
152
167
|
"minItems": 1,
|
|
153
|
-
"items": {
|
|
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.
|
|
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
|
-
{
|
|
178
|
+
{
|
|
179
|
+
"type": "string",
|
|
180
|
+
"minLength": 1
|
|
181
|
+
},
|
|
161
182
|
{
|
|
162
183
|
"type": "array",
|
|
163
184
|
"minItems": 1,
|
|
164
|
-
"items": {
|
|
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.
|
|
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
|
-
{
|
|
195
|
+
{
|
|
196
|
+
"type": "string",
|
|
197
|
+
"minLength": 1
|
|
198
|
+
},
|
|
172
199
|
{
|
|
173
200
|
"type": "array",
|
|
174
201
|
"minItems": 1,
|
|
175
|
-
"items": {
|
|
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.
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
|
246
|
-
npx --no-install openspec
|
|
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
|
-
|
|
250
|
-
|
|
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
|
|
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
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
release
|
|
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
|