@open-tomato/rafa 0.46.0 → 0.48.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (94) hide show
  1. package/README.md +70 -37
  2. package/dist/adapters/logger/settings.d.ts +2 -2
  3. package/dist/bugs/places.d.ts +1 -1
  4. package/dist/bugs/record.d.ts +1 -1
  5. package/dist/bundled/skills/dev-planner/SKILL.md +2 -2
  6. package/dist/cli.js +73457 -72996
  7. package/dist/config/index.d.ts +5 -0
  8. package/dist/config/index.js +6 -4
  9. package/dist/config/shape.d.ts +20 -15
  10. package/dist/config/templates.d.ts +64 -0
  11. package/dist/config-registry.d.ts +21 -12
  12. package/dist/config-schema-board-project.d.ts +3 -3
  13. package/dist/config-schema-bugs.d.ts +3 -3
  14. package/dist/config-schema-checks.d.ts +114 -0
  15. package/dist/config-schema-errors.d.ts +3 -3
  16. package/dist/config-schema-features.d.ts +4 -4
  17. package/dist/config-schema-hub.d.ts +6 -4
  18. package/dist/config-schema-issues.d.ts +2 -2
  19. package/dist/config-schema-logger.d.ts +3 -3
  20. package/dist/config-schema-loop-continue.d.ts +3 -3
  21. package/dist/config-schema-loop-retries.d.ts +4 -4
  22. package/dist/config-schema-release.d.ts +23 -24
  23. package/dist/config-schema-tests.d.ts +35 -27
  24. package/dist/config-schema-triage.d.ts +3 -3
  25. package/dist/config-schema-wrap-up.d.ts +4 -4
  26. package/dist/core/command/command.d.ts +1 -1
  27. package/dist/core/command/confirm.d.ts +11 -5
  28. package/dist/core/command/global-flags.d.ts +25 -0
  29. package/dist/core/command/index.d.ts +47 -23
  30. package/dist/core/command/registry-types.d.ts +4 -4
  31. package/dist/core/command/shared-flags.d.ts +40 -0
  32. package/dist/core/command/types.d.ts +3 -2
  33. package/dist/core/config/branch-template.d.ts +2 -0
  34. package/dist/core/config/config-items.d.ts +1 -1
  35. package/dist/core/config/config-load-module.d.ts +43 -0
  36. package/dist/core/config/config-load.d.ts +43 -12
  37. package/dist/core/config/config-origins.d.ts +31 -30
  38. package/dist/core/config/config-schema.d.ts +11 -0
  39. package/dist/core/config/config-sections.d.ts +15 -14
  40. package/dist/core/config/config.d.ts +90 -25
  41. package/dist/core/config/core-section.d.ts +1 -1
  42. package/dist/core/config/default-routing.d.ts +1 -1
  43. package/dist/core/config/index.d.ts +14 -10
  44. package/dist/core/config/merge-method.d.ts +40 -0
  45. package/dist/core/config/scope.d.ts +2 -2
  46. package/dist/core/config/section.d.ts +81 -1
  47. package/dist/core/config/sections.d.ts +17 -6
  48. package/dist/core/git/gh-runner.d.ts +1 -1
  49. package/dist/core/git/git.d.ts +34 -0
  50. package/dist/core/git/index.d.ts +13 -8
  51. package/dist/core/loop/claude.d.ts +11 -5
  52. package/dist/core/loop/hop-record.d.ts +6 -6
  53. package/dist/core/loop/index.d.ts +9 -8
  54. package/dist/core/loop/session-record-parse.d.ts +9 -2
  55. package/dist/core/loop/sessions.d.ts +23 -11
  56. package/dist/core/loop/suite-failure.d.ts +8 -6
  57. package/dist/core/output/active.d.ts +1 -1
  58. package/dist/core/plan/block-reader.d.ts +1 -1
  59. package/dist/core/runtime/identity.d.ts +13 -0
  60. package/dist/core/runtime/index.d.ts +12 -6
  61. package/dist/effort/store/check-rows.d.ts +1 -1
  62. package/dist/effort/store/commit-stats.d.ts +1 -1
  63. package/dist/effort/store/index.js +7 -8
  64. package/dist/effort/store/merge-commit-gaps.d.ts +1 -1
  65. package/dist/effort/store/plan-stubs.d.ts +1 -1
  66. package/dist/effort/store/session-row-types.d.ts +2 -2
  67. package/dist/errors/rafa-codes.d.ts +1 -1
  68. package/dist/index-2xzkzwm6.js +670 -0
  69. package/dist/index-ajv88fkm.js +448 -0
  70. package/dist/{index-ykggr043.js → index-fpgmdmww.js} +13 -5
  71. package/dist/index-g91ys6kw.js +249 -0
  72. package/dist/{index-cy98y87p.js → index-jx3x70xh.js} +1111 -638
  73. package/dist/{index-gvek4r8m.js → index-m672ptpg.js} +84 -26
  74. package/dist/{index-39kbcw68.js → index-w5qbpdtp.js} +415 -842
  75. package/dist/{index-gqz4jn6j.js → index-z4r20zwr.js} +8974 -11438
  76. package/dist/{index-j4k2vdz3.js → index-zsak0jy6.js} +124 -290
  77. package/dist/index.js +24940 -18766
  78. package/dist/learning/index.js +221 -12
  79. package/dist/plan/index.js +10 -9
  80. package/dist/ports/index.d.ts +7 -7
  81. package/dist/ports/learning.d.ts +5 -4
  82. package/dist/ports/spec-review.d.ts +1 -1
  83. package/dist/ready-gax3hhtt.js +241 -0
  84. package/dist/release-templates/release-bot-fragment.yml +6 -6
  85. package/dist/release-templates/release-publish.yml +8 -8
  86. package/dist/release-templates/release-settle.yml +8 -7
  87. package/dist/release-templates/release-tag.yml +8 -7
  88. package/package.json +53 -2
  89. package/dist/index-77ajfffn.js +0 -223
  90. package/dist/index-jh1r4kcn.js +0 -1067
  91. package/dist/index-z1w83f81.js +0 -4
  92. package/dist/pr/checks.d.ts +0 -133
  93. package/dist/pr/types.d.ts +0 -422
  94. package/dist/ready-4f8edezt.js +0 -2016
@@ -1,12 +1,12 @@
1
1
  /**
2
2
  * The barrel over the config's value readers: every name
3
- * `config-sections.ts`, `config-readers.ts` and `branch-template.ts`
4
- * export, and nothing else.
3
+ * `config-sections.ts`, `config-readers.ts`, `branch-template.ts` and
4
+ * `merge-method.ts` export, and nothing else.
5
5
  *
6
- * A file outside `packages/rafa/src/core/` imports this file and never the three behind
6
+ * A file outside `packages/rafa/src/core/` imports this file and never the four behind
7
7
  * it (`scripts/survey/core-barrels.ts` measures that, and
8
8
  * `src/tests/core-barrels.sweep.test.ts` holds it against the tree). A
9
- * file inside `packages/rafa/src/core/` imports the three directly and never this file.
9
+ * file inside `packages/rafa/src/core/` imports the four directly and never this file.
10
10
  *
11
11
  * ## Why the pair has a barrel of its own
12
12
  *
@@ -28,18 +28,29 @@
28
28
  * through the `naming.branch` template, `branchGlob` and `stubOfBranch`.
29
29
  * It imports `config-readers.ts` alone, so it is a leaf as the pair is,
30
30
  * and it sits beside `branchFromTemplate`, the writer it reads back.
31
+ * `DEFAULT_BASE_BRANCH`, the base `pr.base` unset is read as, joined it
32
+ * from `packages/rafa-run/src/next/sources.ts`, so a reader of the base takes it beside
33
+ * `DEFAULT_BRANCH_TEMPLATE` without reaching `rafa next`'s composition.
34
+ *
35
+ * `merge-method.ts` joined with the words `pr.mergeMethod` takes, its
36
+ * list and its guard, moved out of `packages/rafa/src/pr/types.ts` so the release
37
+ * section reads them without reaching the pull request port. It imports
38
+ * nothing, so it is a leaf too, and `packages/rafa/src/pr/types.ts` re-exports its
39
+ * names from here.
31
40
  *
32
41
  * ## What it exports
33
42
  *
34
43
  * Each name is spelled, types apart from values, as the entries
35
44
  * `src/index.ts` and `src/plan/index.ts` spell theirs.
36
45
  *
37
- * `sections.test.ts` holds the list to the three files: every name any
46
+ * `sections.test.ts` holds the list to the four files: every name any
38
47
  * of them exports is here once, as the same binding, and no name is here
39
48
  * that none of them exports.
40
49
  */
41
50
  export type { ReleasePublishMode, ReleaseSettleMode, ReleaseStrategy, ReleaseTagMode, VersionCollisionMode, } from './config-readers.js';
42
51
  export type { BoardRelationshipMode, ClaimsAhead, ClaimsStaleAfter, ClaudeSettingSource, ConfigExtra, ConfigVersion, DuplicatesLevel, InjectMode, LessonSwitch, Mapping, OutputMode, PrProvider, Reader, Reading, ReleaseEnabled, RouteTarget, SkillResolverName, StoreBackend, SyncStrategy, TierPin, TierSwitch, ValueAt, } from './config-sections.js';
43
- export { branchGlob, stubOfBranch } from './branch-template.js';
52
+ export type { MergeMethod } from './merge-method.js';
53
+ export { branchGlob, DEFAULT_BASE_BRANCH, stubOfBranch } from './branch-template.js';
44
54
  export { BRANCH_STUB, branchFromTemplate, branchTemplate, DEFAULT_BRANCH_TEMPLATE, directory, fragmentsDirectory, isBranchTemplate, mapOf, RELEASE_PUBLISH_MODES, RELEASE_SETTLE_MODES, RELEASE_STRATEGIES, RELEASE_TAG_MODES, releaseFile, releasePublishMode, releaseSettleMode, releaseStrategy, releaseTagMode, routeTable, tierPins, trackerKind, VERSION_COLLISION_MODES, versionCollisionMode, } from './config-readers.js';
45
55
  export { below, BOARD_PROJECT_TEMPLATE_DEFAULT, BOARD_RELATIONSHIP_MODES, BUSY_TIMEOUT_MAX_MS, BUSY_TIMEOUT_MIN_MS, busyTimeoutMs, claimDurationHours, CLAIMS_AHEAD, CLAIMS_STALE_DISABLED, claimsAhead, claimsStaleAfter, CLAUDE_SETTING_SOURCES, confidence, CONFIDENCE_MAX, CONFIDENCE_MIN, CONFIG_VERSIONS, dayCount, describeValue, DUPLICATE_LEVELS, duplicatesLevel, flag, githubLogin, INJECT_MODES, isBusyTimeoutMs, isGitHubLogin, isMapping, issueNumber, LESSON_SWITCHES, lessonSwitch, listOf, mapReading, messageOf, oneOf, OUTPUT_MODES, PR_PROVIDERS, projectNumber, projectUrl, recurrenceCount, refused, refusedWith, RELEASE_AUTO, releaseEnabled, routeTarget, SKILL_RESOLVERS, skillResolverName, STORE_BACKENDS, subsetOf, SYNC_STRATEGIES, text, TIER_SWITCHES, tierPin, tierSwitch, usdAmount, } from './config-sections.js';
56
+ export { isMergeMethod, MERGE_METHODS } from './merge-method.js';
@@ -4,7 +4,7 @@
4
4
  *
5
5
  * Declared here, below the `github` tracker that spawns `gh`, so the
6
6
  * adapter registry types its `gh` option without importing the tracker.
7
- * `src/adapters/tracker/github.ts` imports both names from this file
7
+ * `packages/rafa-board/src/adapters/tracker/github.ts` imports both names from this file
8
8
  * and re-exports them under the same names, so none of its importers
9
9
  * changes.
10
10
  */
@@ -20,3 +20,37 @@ export declare function createGitRunner(cwd: string): GitRunner;
20
20
  * all, which a successful `git switch` does.
21
21
  */
22
22
  export declare function gitSaid(result: GitResult): string;
23
+ /** A checkout's working tree, as `git status --porcelain` reported it. */
24
+ export interface WorkingTreeStatus {
25
+ /** True when git reported nothing at all. */
26
+ readonly clean: boolean;
27
+ /** Every porcelain line, as git wrote it; see the module note. */
28
+ readonly entries: readonly string[];
29
+ /** The porcelain lines naming a tracked path, as git wrote them. */
30
+ readonly tracked: readonly string[];
31
+ /**
32
+ * The untracked paths, unquoted ({@link unquoteGitPath}). A directory
33
+ * git folded into one line keeps its trailing `/`.
34
+ */
35
+ readonly untracked: readonly string[];
36
+ }
37
+ /**
38
+ * Parses `git status --porcelain` into a status.
39
+ *
40
+ * Every non-blank line lands in {@link WorkingTreeStatus.entries}, and
41
+ * each one in exactly one of the two halves: a `?? ` line is untracked
42
+ * and its path is unquoted, every other line is tracked and kept as git
43
+ * wrote it; see the module note. Which half refuses a merge is
44
+ * `readMergeRefusal`'s, in `packages/rafa-pr/src/pr/merge.ts`.
45
+ */
46
+ export declare function parseWorkingTree(stdout: string): WorkingTreeStatus;
47
+ /**
48
+ * A path as git printed it, with git's quoting undone. git wraps a path
49
+ * in double quotes when it holds a character it will not print bare —
50
+ * `git status --porcelain` for a space, `git ls-tree` for a non-ASCII
51
+ * byte, which it writes as octal escapes under `core.quotePath` — and
52
+ * leaves every other path as it is. Measured on git 2.53.0: an
53
+ * untracked `a b.txt` read `?? "a b.txt"` in porcelain and `a b.txt` in
54
+ * `ls-tree -r --name-only`, and `é.txt` read `"\303\251.txt"` in both.
55
+ */
56
+ export declare function unquoteGitPath(raw: string): string;
@@ -11,7 +11,9 @@
11
11
  * ## What sits behind it
12
12
  *
13
13
  * - `git.ts`: the runner that spawns `git` in a directory and answers
14
- * what git said instead of throwing, with the reader of that answer;
14
+ * what git said instead of throwing, with the reader of that answer,
15
+ * and the reader of `git status --porcelain` with git's path
16
+ * unquoting;
15
17
  * - `commit.ts`: staging and committing one task's work on the loop's
16
18
  * behalf, the subject derived from the task text, and the argv of
17
19
  * each step;
@@ -50,16 +52,19 @@
50
52
  * file imports one file outside `packages/rafa/src/core/` by value,
51
53
  * `packages/rafa/src/schema/tiers.ts`, and it does not reach this barrel.
52
54
  *
53
- * `src/pr/index.ts`, the `pr` subject's barrel, re-exports the four
54
- * names of `git.ts` from this file, as it re-exported them from
55
- * `git.ts` before the move. `config-sections.ts` imports
56
- * `src/pr/types.ts` directly and not that barrel, which is why the edge
55
+ * `packages/rafa-pr/src/pr/index.ts`, the `pr` subject's barrel, re-exports four names
56
+ * of `git.ts` from this file (`GitResult`, `GitRunner`,
57
+ * `createGitRunner`, `gitSaid`), as it re-exported them from `git.ts`
58
+ * before the move; the working tree reader and `unquoteGitPath`, which
59
+ * came here later from `packages/rafa-pr/src/pr/merge.ts`, it does not re-export.
60
+ * `config-sections.ts` imports
61
+ * `packages/rafa/src/pr/types.ts` directly and not that barrel, which is why the edge
57
62
  * closes nothing.
58
63
  *
59
64
  * Measured when the two moved: the value imports of the non-test files
60
65
  * under `src/` and `packages/` held six cycles before the move and the
61
66
  * same six after it, none through a file of this folder. The control,
62
- * the same tree with `src/pr/types.ts` taking one value (`gitSaid`) from
67
+ * the same tree with `packages/rafa/src/pr/types.ts` taking one value (`gitSaid`) from
63
68
  * this barrel, held a seventh: that file, `config-sections.ts`, `git.ts`
64
69
  * and this one. No load order of the control was run.
65
70
  *
@@ -79,7 +84,7 @@
79
84
  * `git.ts` declares, and no other name is here.
80
85
  */
81
86
  export type { GhResult, GhRunner } from './gh-runner.js';
82
- export type { GitResult, GitRunner } from './git.js';
87
+ export type { GitResult, GitRunner, WorkingTreeStatus } from './git.js';
83
88
  export type { CommitAttempt, CommitMessage, CommitOptions, CommitOutcome, CommitStep, CommitType, CommitTypeRule, DerivedSubject, GitRunResult, SubjectOptions, } from './commit.js';
84
- export { createGitRunner, gitSaid } from './git.js';
89
+ export { createGitRunner, gitSaid, parseWorkingTree, unquoteGitPath } from './git.js';
85
90
  export { buildCommitMessage, COMMIT_TYPE_RULES, commitArgs, commitTaskWork, DEFAULT_COMMIT_TYPE, deriveCommitSubject, FALLBACK_DESCRIPTION, firstClause, headShaArgs, inferCommitType, MAX_MESSAGE_CHARS, MAX_SUBJECT_LENGTH, normaliseTaskText, spawnGit, stageAllArgs, stagedChangesArgs, } from './commit.js';
@@ -167,7 +167,7 @@
167
167
  * `with` declaration and the run carries the flag, or an `unless`
168
168
  * declaration and the run does not. `through` covers a run because the
169
169
  * command runs another's action in-process (`rafa next`,
170
- * `src/next/actions.ts`), and the recorded command stays the outer one.
170
+ * `packages/rafa-run/src/next/actions.ts`), and the recorded command stays the outer one.
171
171
  * A flag is matched by its name without the dashes, and `--no-<name>`
172
172
  * also as the parser keys it, `<name>` set to `false`; a flag recorded
173
173
  * as `false` is not carried. With no command recorded, as for a caller
@@ -204,6 +204,12 @@ export declare const CLAUDE_BASE_ARGS: readonly string[];
204
204
  * module note.
205
205
  */
206
206
  export declare const SETTING_SOURCES_FLAG = "--setting-sources";
207
+ /**
208
+ * The flag a session is spawned with to run under the id the loop
209
+ * picked for it. A task session's id goes ahead of its declaration's
210
+ * flags; see the module note.
211
+ */
212
+ export declare const SESSION_ID_FLAG = "--session-id";
207
213
  /**
208
214
  * Builds the argument list for one session: the base arguments, the
209
215
  * setting sources, the served flags, then the flags.
@@ -220,7 +226,7 @@ export declare const SETTING_SOURCES_FLAG = "--setting-sources";
220
226
  * for a decision `core/plan/declaration.ts` already makes.
221
227
  *
222
228
  * `served` is `ServedSet.flags` from `serveResolution`
223
- * (`src/tiers/serve.ts`), the session-only flags handing the run's
229
+ * (`packages/rafa-inventory/src/tiers/serve.ts`), the session-only flags handing the run's
224
230
  * served directory over, and is taken as it is for the same reason.
225
231
  * It defaults to empty, so a caller that serves nothing spawns what it
226
232
  * spawned before. It goes BEFORE `flags`, never after: `--tools` has to
@@ -307,13 +313,13 @@ export interface CapturedSession {
307
313
  export interface CapturedSpawnOptions {
308
314
  /**
309
315
  * The session's working directory, or the loop's own when absent. The
310
- * search session (`src/inventory/search/index.ts`) names the scratch
316
+ * search session (`packages/rafa-inventory/src/inventory/search/index.ts`) names the scratch
311
317
  * copy of its candidates, each check session of the epic verification
312
- * run (`src/epic/verify-run.ts`) a detached worktree of main, the plan
318
+ * run (`packages/rafa-board/src/epic/verify-run.ts`) a detached worktree of main, the plan
313
319
  * session of the `claude` planner (`src/adapters/planner/claude.ts`)
314
320
  * the project root it writes the plan under, and the loop's task,
315
321
  * wrap-up and CI repair sessions the run's checkout
316
- * (`src/start/checkout.ts`).
322
+ * (`packages/rafa-run/src/start/checkout.ts`).
317
323
  */
318
324
  readonly cwd?: string;
319
325
  }
@@ -1,12 +1,12 @@
1
1
  /**
2
2
  * The shapes of the hop record and of a place, with the checks that read
3
- * them from parsed JSON: the part of `src/next/hop-record.ts` and
4
- * `src/project/position.ts` a session record needs (`sessions.ts` keeps a
3
+ * them from parsed JSON: the part of `packages/rafa/src/next/hop-record.ts` and
4
+ * `packages/rafa/src/project/position.ts` a session record needs (`sessions.ts` keeps a
5
5
  * hop record in its `hop` field).
6
6
  *
7
7
  * It sits in core so `sessions.ts` reads them without importing above
8
- * core. `src/project/position.ts` re-exports `Place` and `asPlace`, and
9
- * `src/next/hop-record.ts` re-exports `HopKind`, `HopState`, `HopRecord`
8
+ * core. `packages/rafa/src/project/position.ts` re-exports `Place` and `asPlace`, and
9
+ * `packages/rafa/src/next/hop-record.ts` re-exports `HopKind`, `HopState`, `HopRecord`
10
10
  * and `asHopRecord`, each under the same name; the reading and writing of
11
11
  * `.rafa/position.json` and `.rafa/hop.json`, and the module notes that
12
12
  * describe both files, stay there. `isRecord` is exported for the
@@ -23,7 +23,7 @@ export interface Place {
23
23
  export type HopKind = 'blocker' | 'dry';
24
24
  /** Where the hop stands: working its target, back home waiting on it or with it merged, or back home from a halt. */
25
25
  export type HopState = 'away' | 'waiting' | 'merged' | 'halted';
26
- /** The record `.rafa/hop.json` holds; see the module note of `src/next/hop-record.ts`. */
26
+ /** The record `.rafa/hop.json` holds; see the module note of `packages/rafa/src/next/hop-record.ts`. */
27
27
  export interface HopRecord {
28
28
  readonly kind: HopKind;
29
29
  readonly home: Place;
@@ -46,7 +46,7 @@ export declare function isRecord(value: unknown): value is Record<string, unknow
46
46
  export declare function asPlace(value: unknown): Place | null;
47
47
  /**
48
48
  * `value` as a hop record, or null when it is not one: the check
49
- * `readHopRecord` (`src/next/hop-record.ts`) makes on the parsed file,
49
+ * `readHopRecord` (`packages/rafa/src/next/hop-record.ts`) makes on the parsed file,
50
50
  * which the session record makes on its `hop` field (`sessions.ts`).
51
51
  */
52
52
  export declare function asHopRecord(value: unknown): HopRecord | null;
@@ -25,7 +25,8 @@
25
25
  * - `session-env.ts`: the environment a Claude session is spawned
26
26
  * with, which `claude.ts` imports by path;
27
27
  * - `suite-failure.ts`: the type of one failing test, which
28
- * `sessions.ts` imports by path and `src/suite/run.ts` re-exports.
28
+ * `sessions.ts` imports by path and `packages/rafa/src/suite/run.ts`
29
+ * re-exports.
29
30
  *
30
31
  * The four files share no name, and only `sessions.ts` imports
31
32
  * `suite-failure.ts`, for a type. One
@@ -67,14 +68,14 @@
67
68
  * ## Why the hop record is not here
68
69
  *
69
70
  * `hop-record.ts`, the shapes of the hop record and of a place, sits
70
- * alone behind `hops.ts`. `src/next/hop-record.ts` and
71
- * `src/project/position.ts` re-export its names, so they import a
71
+ * alone behind `hops.ts`. `packages/rafa/src/next/hop-record.ts` and
72
+ * `packages/rafa/src/project/position.ts` re-export its names, so they import a
72
73
  * barrel over it by value, and `src/loop/session-record-parse.ts`,
73
74
  * which `sessions.ts` imported by value, imported `asHopRecord` from
74
- * `src/next/hop-record.ts` by value when the split was made; it has
75
+ * `packages/rafa/src/next/hop-record.ts` by value when the split was made; it has
75
76
  * since moved here and imports `hop-record.ts` by path. With `hop-record.ts` behind this
76
77
  * barrel that is a cycle of four files: this one, `sessions.ts`, the
77
- * parser and `src/next/hop-record.ts`. `hops.ts` records the
78
+ * parser and `packages/rafa/src/next/hop-record.ts`. `hops.ts` records the
78
79
  * measurement, and `hops.test.ts` holds that no name is on two loop
79
80
  * barrels. `sessions.ts` imports `hop-record.ts` by path, for
80
81
  * `HopRecord`.
@@ -86,7 +87,7 @@
86
87
  * imported three files by value when it moved:
87
88
  * `packages/rafa/src/core/config/config-sections.ts`, for `messageOf`, and two outside
88
89
  * `packages/rafa/src/core/`, `src/loop/session-record-parse.ts` and
89
- * `src/project/scope.ts`. Through them it reached 38 files by value, and
90
+ * `packages/rafa/src/project/scope.ts`. Through them it reached 38 files by value, and
90
91
  * none of the 38 imported it by value. Both have since moved into
91
92
  * `packages/rafa/src/core/`, as `session-record-parse.ts` beside it and
92
93
  * `packages/rafa/src/core/config/scope.ts`.
@@ -174,6 +175,6 @@ export type { PidProbe, SessionChange, SessionConflict, SessionConflictReason, S
174
175
  export type { CapturedSession, CapturedSpawnOptions, CapturingSpawner, ClaudeSpawner } from './claude.js';
175
176
  export type { SpawnEnv } from './session-env.js';
176
177
  export type { SuiteFailure } from './suite-failure.js';
177
- export { beginSession, errorCode, isPidAlive, isPositiveWhole, isSessionId, parseSessionRecord, readSession, readSessions, readState, RECORD_EXTENSION, RUNS_DIR, runsDir, samePlan, SESSION_DECISION_STRATEGIES, SESSION_PHASES, SESSION_STATES, SESSION_STEP_KINDS, SESSION_STEP_REASONS, SessionConflictError, sessionConflicts, sessionDecisions, sessionFilePath, sessionPhase, SessionRecordError, SessionStateError, sessionSteps, updateSession, } from './sessions.js';
178
- export { carriesFlag, CLAUDE_BASE_ARGS, CLAUDE_BIN, claudeArgs, interruptClaudeSessions, runClaude, runClaudeCaptured, SETTING_SOURCES_FLAG, spawnClaude, spawnClaudeCaptured, spendWarning, } from './claude.js';
178
+ export { beginSession, errorCode, isPidAlive, isPositiveWhole, isSessionId, NONE_STEP_SCOPE, parseSessionRecord, readSession, readSessions, readState, RECORD_EXTENSION, RUNS_DIR, runsDir, samePlan, SESSION_DECISION_STRATEGIES, SESSION_PHASES, SESSION_STATES, SESSION_STEP_KINDS, SESSION_STEP_REASONS, SessionConflictError, sessionConflicts, sessionDecisions, sessionFilePath, sessionPhase, SessionRecordError, SessionStateError, sessionSteps, updateSession, } from './sessions.js';
179
+ export { carriesFlag, CLAUDE_BASE_ARGS, CLAUDE_BIN, claudeArgs, interruptClaudeSessions, runClaude, runClaudeCaptured, SESSION_ID_FLAG, SETTING_SOURCES_FLAG, spawnClaude, spawnClaudeCaptured, spendWarning, } from './claude.js';
179
180
  export { sessionPath, sessionSpawnEnv } from './session-env.js';
@@ -20,11 +20,18 @@ export type SessionStepKind = (typeof SESSION_STEP_KINDS)[number];
20
20
  * Why a suite step ran at the scope it did: the task's own `tests=`
21
21
  * declaration, a full-suite trigger, the `--changed` fallback taken when
22
22
  * no `Owns:` folder narrows the run, a `tests=module` task whose module
23
- * holds no test file, and a stage step's own scope.
23
+ * holds no test file, a stage step's own scope, a check-point entry that
24
+ * names no check (a `none` step), and the entry's `unit` check.
24
25
  */
25
- export declare const SESSION_STEP_REASONS: readonly ['declared', 'trigger', 'fallback', 'no-module-tests', 'stage'];
26
+ export declare const SESSION_STEP_REASONS: readonly ['declared', 'trigger', 'fallback', 'no-module-tests', 'stage', 'no-check', 'unit'];
26
27
  /** One of {@link SESSION_STEP_REASONS}. */
27
28
  export type SessionStepReason = (typeof SESSION_STEP_REASONS)[number];
29
+ /**
30
+ * The scope of a step that ran nothing: its check-point entry named no
31
+ * check. Such a step holds an empty `command`, exit code 0 and no
32
+ * failures; see the module note, "A `none` step".
33
+ */
34
+ export declare const NONE_STEP_SCOPE: "none";
28
35
  /** The strategies a saved decision may name: the two that pass over a task. */
29
36
  export declare const SESSION_DECISION_STRATEGIES: readonly ['jump', 'defer'];
30
37
  /** A record file that cannot be read, or holds no record this module accepts. */
@@ -38,7 +38,7 @@
38
38
  * - `hop`: only on a run started with `loop start --roadmap` while a
39
39
  * `rafa next --roadmap` hop is away, the hop record as
40
40
  * `.rafa/hop.json` held it when the run began
41
- * (`src/next/hop-record.ts`, `start/session.ts`). A record of any
41
+ * (`packages/rafa/src/next/hop-record.ts`, `start/session.ts`). A record of any
42
42
  * other run carries no `hop` key at all, never one set to null, so
43
43
  * such a record is written byte for byte as it was before the field.
44
44
  * Once written, every later write of the record keeps it as it is.
@@ -80,19 +80,28 @@
80
80
  * first dispatch, `task` after a task commits, `stage` after a stage's
81
81
  * last task, `pre-wrap-up` before the wrap-up.
82
82
  * - `scope`: `affected`, `module` or `full` (`TEST_SCOPES`,
83
- * `core/plan/declaration.ts`), or the list of files and folders run, which
84
- * may be empty.
83
+ * `core/plan/declaration.ts`), `none` ({@link NONE_STEP_SCOPE}) for a
84
+ * step that ran nothing because its check-point entry named no check,
85
+ * or the list of files and folders run, which may be empty.
85
86
  * - `reason`: optional, why the step ran at that scope, one of
86
87
  * {@link SESSION_STEP_REASONS}: `declared` for the task's own `tests=`
87
- * declaration, `trigger` for a full-suite trigger, `fallback` for the
88
+ * declaration or the check-point entry, `trigger` for a full-suite trigger, `fallback` for the
88
89
  * `--changed` run taken when no `Owns:` folder narrows it,
89
90
  * `no-module-tests` for a `tests=module` task whose module holds no
90
- * test file, and `stage` for a stage step's own scope. It is written
91
+ * test file, `stage` for a stage step's own scope, `no-check` for a
92
+ * `none` step, and `unit` for a run the entry's `unit` check chose. It is written
91
93
  * as its own key right after `scope`. A step written by rafa 0.35.0
92
94
  * or earlier carries no `reason` key and reads as having none; a
93
95
  * value outside the set is left out on read, never refused, as an
94
96
  * unknown `phase` is.
95
- * - `command`: the argv spawned, `bun` first, never empty.
97
+ * - `declared`: only on a `none` step whose task line declared a
98
+ * `tests=` value, that value, which the step set aside; written right
99
+ * after `reason`. On read a value outside `TEST_SCOPES`, or the key on
100
+ * any other step, is left out, never refused.
101
+ * - `command`: the argv spawned, `bun` first, never empty but on a
102
+ * `none` step, whose command is the empty list, its `exitCode` 0 and
103
+ * its `failures` and `newFailures` empty. A `none` step outside that
104
+ * shape, and an empty command at any other scope, are refused on read.
96
105
  * - `exitCode`: the command's exit code, a whole number.
97
106
  * - `summary`: Bun's `Ran N tests across M files.` line, or null when it
98
107
  * printed none.
@@ -212,14 +221,15 @@
212
221
  * refused on read. This module re-exports what a caller reads from
213
222
  * there, so `./sessions.js` stays the one import a record's reader
214
223
  * needs: `isPositiveWhole` and `RECORD_EXTENSION` among them, which
215
- * `src/stretch/folder.ts` and `src/cleanup/runs.ts` read.
224
+ * `src/stretch/folder.ts` and `packages/rafa-run/src/cleanup/runs.ts` read.
216
225
  */
217
226
  import type { HopRecord } from './hop-record.js';
218
227
  import type { SessionPhase, SessionState, SessionStepKind, SessionStepReason } from './session-record-parse.js';
219
228
  import type { SuiteFailure } from './suite-failure.js';
220
229
  import type { TestScope } from '../plan/declaration.js';
230
+ import { NONE_STEP_SCOPE } from './session-record-parse.js';
221
231
  export type { SessionPhase, SessionState, SessionStepKind, SessionStepReason, } from './session-record-parse.js';
222
- export { isPositiveWhole, isSessionId, parseSessionRecord, RECORD_EXTENSION, SESSION_DECISION_STRATEGIES, SESSION_PHASES, SESSION_STATES, SESSION_STEP_KINDS, SESSION_STEP_REASONS, SessionRecordError, sessionDecisions, sessionPhase, sessionSteps, } from './session-record-parse.js';
232
+ export { isPositiveWhole, isSessionId, NONE_STEP_SCOPE, parseSessionRecord, RECORD_EXTENSION, SESSION_DECISION_STRATEGIES, SESSION_PHASES, SESSION_STATES, SESSION_STEP_KINDS, SESSION_STEP_REASONS, SessionRecordError, sessionDecisions, sessionPhase, sessionSteps, } from './session-record-parse.js';
223
233
  /** The directory the records are kept in, under a project's `.rafa/`. */
224
234
  export declare const RUNS_DIR = "runs";
225
235
  /** The task a session is running. */
@@ -245,11 +255,13 @@ export interface SessionStepOnly {
245
255
  /** One suite run the runner recorded for a session. See the module note. */
246
256
  export interface SessionStep {
247
257
  readonly kind: SessionStepKind;
248
- /** A named scope, or the files and folders run. */
249
- readonly scope: TestScope | readonly string[];
258
+ /** A named scope, `none` for a step that ran nothing, or the files and folders run. */
259
+ readonly scope: TestScope | typeof NONE_STEP_SCOPE | readonly string[];
250
260
  /** Why the step ran at {@link SessionStep.scope}; left out of a step from rafa 0.35.0 or earlier. See the module note. */
251
261
  readonly reason?: SessionStepReason;
252
- /** The argv spawned, `bun` first. */
262
+ /** The `tests=` value a `none` step set aside; only on a `none` step whose task line had one. See the module note. */
263
+ readonly declared?: TestScope;
264
+ /** The argv spawned, `bun` first; empty on a `none` step alone. */
253
265
  readonly command: readonly string[];
254
266
  readonly exitCode: number;
255
267
  /** Bun's summary line, or null when it printed none. */
@@ -1,10 +1,11 @@
1
1
  /**
2
- * The record of one failing test, as `src/suite/run.ts` reads it from a
3
- * JUnit report and a session record keeps it among a suite step's
4
- * failures (`sessions.ts`).
2
+ * The record of one failing test, as `packages/rafa/src/suite/run.ts`
3
+ * reads it from a JUnit report and a session record keeps it among a
4
+ * suite step's failures (`sessions.ts`).
5
5
  *
6
6
  * It sits in core so `sessions.ts` reads it without importing above
7
- * core; `src/suite/run.ts` re-exports it under the same name.
7
+ * core; `packages/rafa/src/suite/run.ts` re-exports it under the same
8
+ * name.
8
9
  */
9
10
  /** One failing test: its file, relative to the run's directory, and its full name. */
10
11
  export interface SuiteFailure {
@@ -13,13 +14,14 @@ export interface SuiteFailure {
13
14
  readonly name: string;
14
15
  /**
15
16
  * The first line of its JUnit failure's message; absent when the
16
- * report gave none. Compared by `src/triage/inherited.ts` when present to
17
+ * report gave none. Compared by `packages/rafa-pr/src/triage/inherited.ts` when present to
17
18
  * identify inherited failures.
18
19
  */
19
20
  readonly message?: string;
20
21
  /**
21
22
  * The first lines of the error Bun printed for it on stderr, trimmed;
22
- * absent when it printed none. See the module note of `src/suite/run.ts`.
23
+ * absent when it printed none. See the module note of
24
+ * `packages/rafa/src/suite/run.ts`.
23
25
  */
24
26
  readonly errorLines?: readonly string[];
25
27
  }
@@ -2,7 +2,7 @@
2
2
  * The Output this process writes through, and the mode it renders in.
3
3
  *
4
4
  * A function that prints asks {@link activeOutput} for the output rather
5
- * than taking one as an argument, as `src/start/stamp.ts` holds a run's
5
+ * than taking one as an argument, as `packages/rafa-run/src/start/stamp.ts` holds a run's
6
6
  * plan stub: an `Output` threaded through every function that prints
7
7
  * would add an argument to call sites that have nothing to say about
8
8
  * output. The output is held in two places, and the readers answer the
@@ -17,7 +17,7 @@
17
17
  *
18
18
  * A barrel that groups a file with a file outside `packages/rafa/src/core/` that
19
19
  * imports the barrel back by value is a runtime cycle.
20
- * `src/utils/tracker.ts` imports `readRafaBlocks` by value, and
20
+ * `packages/rafa/src/utils/tracker.ts` imports `readRafaBlocks` by value, and
21
21
  * `parse.ts`, behind `index.ts`, imported that file by value when the
22
22
  * split was made. So `blocks.ts` behind `index.ts` closed a cycle
23
23
  * through the tracker. `blocks.ts` imports no file, so a barrel that
@@ -1,3 +1,16 @@
1
+ /**
2
+ * Rafa's published name, the `name` of the root `package.json`. It is
3
+ * spelled here rather than read from that manifest, which lies above
4
+ * core's package (#1090); the manifest beside this package names the
5
+ * package itself, `@open-tomato/rafa-core`, until #808 renames it.
6
+ * `src/tests/core-coupled/core/runtime/identity.test.ts` plants its
7
+ * manifests with the root manifest's `name`, so a drift fails there.
8
+ * It is also what run's install and pr's merge follow-ups compare a
9
+ * manifest's `name` against.
10
+ */
11
+ export declare const RAFA_PACKAGE_NAME = "@open-tomato/rafa";
12
+ /** Where versions sit under the home: `~/.rafa/runtime/<version>/`. */
13
+ export declare const RUNTIME_SUBDIR: string;
1
14
  /** An installed runtime: a runtime copy, or the package installed from npm. */
2
15
  export interface InstalledIdentity {
3
16
  readonly kind: 'installed';
@@ -17,15 +17,19 @@
17
17
  * from a checkout, and the three types it answers with. It moved here
18
18
  * from `src/runtime/identity.ts` (#1088), so the effort store, which
19
19
  * asks it before it migrates a live store, imports nothing above core
20
- * for it.
20
+ * for it. Beside it sit two values: `RAFA_PACKAGE_NAME`, rafa's
21
+ * published name, which the walk compares each manifest against, and
22
+ * `RUNTIME_SUBDIR`, where installed versions sit under the home. Both
23
+ * moved into core in the seventh decouple item, so pr's merge reads
24
+ * them without importing run.
21
25
  *
22
26
  * ## Why one barrel can hold it
23
27
  *
24
28
  * A barrel that groups a file with a file outside `packages/rafa/src/core/` that
25
29
  * imports the barrel back by value is a runtime cycle. `identity.ts`
26
- * imports `node:fs`, `node:path` and the root `package.json`, and no
27
- * file under `src/`, so no file behind this barrel reaches a file that
28
- * imports it back.
30
+ * imports only `node:fs` and `node:path`, no file under `src/`, and
31
+ * spells rafa's package name as a literal, so no file behind this barrel
32
+ * reaches a file that imports it back.
29
33
  *
30
34
  * ## The old path
31
35
  *
@@ -37,10 +41,12 @@
37
41
  *
38
42
  * Each name is spelled, types apart from values, as the other core
39
43
  * barrels spell theirs. No name here is part of the published surface:
40
- * `src/index.ts` re-exports nothing from this file.
44
+ * `src/index.ts` re-exports nothing from this file. The values are
45
+ * {@link readRuntimeIdentity}, `RAFA_PACKAGE_NAME` and `RUNTIME_SUBDIR`;
46
+ * the types are the three identities.
41
47
  *
42
48
  * `index.test.ts` holds the list to the file: every name `identity.ts`
43
49
  * exports is here once, as the same binding, and no other name is here.
44
50
  */
45
51
  export type { DevelopmentIdentity, InstalledIdentity, RuntimeIdentity } from './identity.js';
46
- export { readRuntimeIdentity } from './identity.js';
52
+ export { readRuntimeIdentity, RAFA_PACKAGE_NAME, RUNTIME_SUBDIR } from './identity.js';
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * The check rows of a pull request and the verdict over them, which the
3
- * store's plan CI writer (`./plan-ci.ts`) reads and `src/pr/checks.ts`
3
+ * store's plan CI writer (`./plan-ci.ts`) reads and `packages/rafa-pr/src/pr/checks.ts`
4
4
  * re-exports for the poll and the provider that parse and wait on them.
5
5
  *
6
6
  * They sit in core so the store reads a verdict without importing the
@@ -2,7 +2,7 @@
2
2
  * The commit row of the effort store and the gap arithmetic its rows
3
3
  * carry.
4
4
  *
5
- * Moved down from `src/effort/commits.ts`, which parses `git log` into
5
+ * Moved down from `packages/rafa-effort/src/effort/commits.ts`, which parses `git log` into
6
6
  * these rows and re-exports both names under the same names: the
7
7
  * store's row types (`types.ts`), the merge's gap recompute
8
8
  * (`merge-commit-gaps.ts`) and its scenario fixtures
@@ -1,5 +1,6 @@
1
1
  // @bun
2
2
  import {
3
+ EFFORT_KEY_PROJECTIONS,
3
4
  WIRE_FORMAT,
4
5
  WIRE_VERSION,
5
6
  WireExportRefusal,
@@ -10,19 +11,17 @@ import {
10
11
  materialiseWirePayload,
11
12
  mergeStore,
12
13
  openNdjsonStore,
14
+ openSqliteStore,
13
15
  selectEffortStore
14
- } from "../../index-jh1r4kcn.js";
16
+ } from "../../index-jx3x70xh.js";
15
17
  import {
16
- EFFORT_KEY_PROJECTIONS,
17
- TRUSTED_PERMISSIONS,
18
- openSqliteStore
19
- } from "../../index-cy98y87p.js";
18
+ TRUSTED_PERMISSIONS
19
+ } from "../../index-2xzkzwm6.js";
20
20
  import"../../index-2a7nb3an.js";
21
- import"../../index-gvek4r8m.js";
21
+ import"../../index-m672ptpg.js";
22
22
  import {
23
23
  STORE_BACKENDS
24
- } from "../../index-ykggr043.js";
25
- import"../../index-z1w83f81.js";
24
+ } from "../../index-fpgmdmww.js";
26
25
  export {
27
26
  selectEffortStore,
28
27
  openSqliteStore,
@@ -7,7 +7,7 @@
7
7
  * ## Why only those rows
8
8
  *
9
9
  * A commit's gap is the minutes since the commit before it in time
10
- * (`assignElapsedMinutes`, `src/effort/commits.ts`), measured with
10
+ * (`assignElapsedMinutes`, `packages/rafa-effort/src/effort/commits.ts`), measured with
11
11
  * {@link minutesBetween}. A commit brought in between two commits here
12
12
  * changes exactly two gaps: its own, which the other store measured
13
13
  * against its own neighbours, and that of the commit after it, which now
@@ -3,7 +3,7 @@
3
3
  * and a stub, how plan stubs are read out of a directory listing, and
4
4
  * how a branch stub resolves against them.
5
5
  *
6
- * Moved down from `src/effort/attribution.ts`, which attributes a
6
+ * Moved down from `packages/rafa-effort/src/effort/attribution.ts`, which attributes a
7
7
  * session to its plan, issue and task text and re-exports these names
8
8
  * under the same names: the store's row types (`types.ts`) and its plan
9
9
  * CI reader (`plan-ci.ts`) need the resolution but not the session
@@ -2,8 +2,8 @@
2
2
  * The session row's own types: what a session was dispatched to do and
3
3
  * the stats accumulated over its log.
4
4
  *
5
- * Moved down from `src/effort/classify.ts` (`SessionKind`) and
6
- * `src/effort/session-log.ts` (`SessionStats` and the
5
+ * Moved down from `packages/rafa-effort/src/effort/classify.ts` (`SessionKind`) and
6
+ * `packages/rafa/src/effort/session-log.ts` (`SessionStats` and the
7
7
  * `SessionUsageTotals` it names), which classify and read session logs
8
8
  * and re-export these names under the same names: the store's row types
9
9
  * (`types.ts`) need the shapes but not the classifier or the reader, so
@@ -18,7 +18,7 @@
18
18
  * added here by the change that fixes it.
19
19
  *
20
20
  * A project's own codes come from `errors.codes`
21
- * (`src/config-schema-errors.ts`), and {@link listedCodes} puts the two
21
+ * (`packages/rafa/src/config-schema-errors.ts`), and {@link listedCodes} puts the two
22
22
  * side by side.
23
23
  */
24
24
  import type { ErrorCodeEntry } from './codes.js';