@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
@@ -0,0 +1,249 @@
1
+ // @bun
2
+ import {
3
+ MERGE_METHODS,
4
+ PR_PROVIDERS,
5
+ RELEASE_AUTO,
6
+ flag,
7
+ fragmentsDirectory,
8
+ oneOf,
9
+ releaseEnabled,
10
+ releaseFile,
11
+ releasePublishMode,
12
+ releaseSettleMode,
13
+ releaseStrategy,
14
+ releaseTagMode,
15
+ text,
16
+ usdAmount,
17
+ versionCollisionMode
18
+ } from "./index-fpgmdmww.js";
19
+
20
+ // packages/rafa/src/adapters/logger/settings.ts
21
+ import { AsyncLocalStorage } from "async_hooks";
22
+ var LOG_LEVELS = Object.freeze(["error", "warn", "debug"]);
23
+ var LOGGER_THEMES = Object.freeze(["default", "plain"]);
24
+ var DEFAULT_LOGGER_KIND = "console";
25
+ var DEBUG_VERBOSITY = 2;
26
+ var API_VERBOSITY = 3;
27
+ var DEFAULT_LOGGER_SETTINGS = Object.freeze({
28
+ kind: DEFAULT_LOGGER_KIND,
29
+ level: "warn",
30
+ theme: "default",
31
+ modules: new Map,
32
+ callSite: false,
33
+ api: false
34
+ });
35
+ var scopes = new AsyncLocalStorage;
36
+ var moduleLevel = { settings: DEFAULT_LOGGER_SETTINGS };
37
+ function settingsOf(settings) {
38
+ return settings === null ? DEFAULT_LOGGER_SETTINGS : Object.freeze({ ...settings, modules: new Map(settings.modules) });
39
+ }
40
+ function cellHere() {
41
+ return scopes.getStore() ?? moduleLevel;
42
+ }
43
+ function setActiveLoggerSettings(settings) {
44
+ cellHere().settings = settingsOf(settings);
45
+ }
46
+ function activeLoggerSettings() {
47
+ return cellHere().settings;
48
+ }
49
+ function levelEnabled(level, module, settings, verbosity) {
50
+ if (level === "api")
51
+ return settings.api || verbosity >= API_VERBOSITY;
52
+ if (level === "debug" && verbosity >= DEBUG_VERBOSITY)
53
+ return true;
54
+ const threshold = (module === undefined ? undefined : settings.modules.get(module)) ?? settings.level;
55
+ return LOG_LEVELS.indexOf(level) <= LOG_LEVELS.indexOf(threshold);
56
+ }
57
+
58
+ // packages/rafa/src/config-schema-release.ts
59
+ var PR_DEFAULTS = Object.freeze({
60
+ prProvider: null,
61
+ prMergeMethod: "squash",
62
+ prBase: null,
63
+ prResolveBudget: 2,
64
+ prVersionCollision: "report"
65
+ });
66
+ var RELEASE_DEFAULTS = Object.freeze({
67
+ releaseEnabled: RELEASE_AUTO,
68
+ releaseVersionFile: "package.json",
69
+ releaseChangelog: "CHANGELOG.md",
70
+ releaseHeading: "## {version} \u2014 {date}, {title}",
71
+ releaseFragments: ".changes",
72
+ releaseStrategy: "semver-by-level",
73
+ releaseSettle: "push",
74
+ releaseTag: "manual",
75
+ releasePublishCommand: "npm publish",
76
+ releasePublish: "manual",
77
+ releaseMoveLock: false
78
+ });
79
+ var DANGEROUS_RELEASE_DEFAULTS = Object.freeze({
80
+ dangerousAcceptVersionCollision: false
81
+ });
82
+ var mergeMethod = oneOf(MERGE_METHODS);
83
+ var PR_SETTINGS = {
84
+ prProvider: { key: "pr.provider", read: oneOf(PR_PROVIDERS), cli: false },
85
+ prMergeMethod: { key: "pr.mergeMethod", read: mergeMethod, cli: false },
86
+ prBase: { key: "pr.base", read: text("a branch name"), cli: false },
87
+ prResolveBudget: { key: "pr.resolveBudget", read: usdAmount, cli: false },
88
+ prVersionCollision: {
89
+ key: "pr.versionCollision",
90
+ read: versionCollisionMode,
91
+ cli: false
92
+ }
93
+ };
94
+ var RELEASE_SETTINGS = {
95
+ releaseEnabled: { key: "release.enabled", read: releaseEnabled, cli: false },
96
+ releaseVersionFile: {
97
+ key: "release.versionFile",
98
+ read: releaseFile,
99
+ cli: false
100
+ },
101
+ releaseChangelog: { key: "release.changelog", read: releaseFile, cli: false },
102
+ releaseHeading: {
103
+ key: "release.heading",
104
+ read: text("a changelog heading template"),
105
+ cli: false
106
+ },
107
+ releaseFragments: {
108
+ key: "release.fragments",
109
+ read: fragmentsDirectory,
110
+ cli: false
111
+ },
112
+ releaseStrategy: { key: "release.strategy", read: releaseStrategy, cli: false },
113
+ releaseSettle: { key: "release.settle", read: releaseSettleMode, cli: false },
114
+ releaseTag: { key: "release.tag", read: releaseTagMode, cli: false },
115
+ releasePublishCommand: {
116
+ key: "release.publishCommand",
117
+ read: text("a publish command"),
118
+ cli: false
119
+ },
120
+ releasePublish: { key: "release.publish", read: releasePublishMode, cli: false },
121
+ releaseMoveLock: { key: "release.moveLock", read: flag, cli: false }
122
+ };
123
+ var DANGEROUS_RELEASE_SETTINGS = {
124
+ dangerousAcceptVersionCollision: {
125
+ key: "dangerous.acceptVersionCollision",
126
+ read: flag,
127
+ cli: false
128
+ }
129
+ };
130
+ var RELEASE_SECTION = Object.freeze({
131
+ package: "release",
132
+ settings: Object.freeze({ ...PR_SETTINGS, ...RELEASE_SETTINGS, ...DANGEROUS_RELEASE_SETTINGS }),
133
+ defaults: Object.freeze({ ...PR_DEFAULTS, ...RELEASE_DEFAULTS, ...DANGEROUS_RELEASE_DEFAULTS })
134
+ });
135
+
136
+ // packages/rafa/src/errors/codes.ts
137
+ var ERROR_LEVELS = Object.freeze(["error", "warn"]);
138
+ var CODE_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*:[a-z0-9]+(?:-[a-z0-9]+)*$/;
139
+ var NEW_CONTEXT_LEAF = "new-context";
140
+ var UNKNOWN_FAMILY = "unknown";
141
+ var TEXT_FIELDS = ["description", "hint", "since"];
142
+ var PREFIX = "error codes";
143
+ function familyOf(code) {
144
+ return code.slice(0, code.indexOf(":"));
145
+ }
146
+ function codeProblem(code) {
147
+ if (!CODE_PATTERN.test(code))
148
+ return `${JSON.stringify(code)} is not <family>:<leaf> in kebab-case`;
149
+ const leaf = code.slice(code.indexOf(":") + 1);
150
+ if (leaf === NEW_CONTEXT_LEAF || leaf === UNKNOWN_FAMILY) {
151
+ return `${JSON.stringify(code)} uses the reserved leaf ${leaf}`;
152
+ }
153
+ if (familyOf(code) === UNKNOWN_FAMILY)
154
+ return `${JSON.stringify(code)} uses the reserved family ${UNKNOWN_FAMILY}`;
155
+ return null;
156
+ }
157
+ function entryProblem(entry, index) {
158
+ const codeFault = codeProblem(entry.code);
159
+ if (codeFault !== null)
160
+ return `[${index}].code ${codeFault}`;
161
+ const empty = TEXT_FIELDS.find((field) => (entry[field] ?? "").trim() === "");
162
+ if (empty !== undefined)
163
+ return `[${index}].${empty} is empty`;
164
+ if (!ERROR_LEVELS.includes(entry.level)) {
165
+ return `[${index}].level is ${JSON.stringify(entry.level)}, expected ${ERROR_LEVELS.join(" or ")}`;
166
+ }
167
+ return null;
168
+ }
169
+ function defineErrorCodes(entries) {
170
+ entries.forEach((entry, index) => {
171
+ const fault = entryProblem(entry, index);
172
+ if (fault !== null)
173
+ throw new TypeError(`${PREFIX}: ${fault}`);
174
+ const first = entries.findIndex((other) => other.code === entry.code);
175
+ if (first < index) {
176
+ throw new TypeError(`${PREFIX}: ${JSON.stringify(entry.code)} is declared at [${first}] and [${index}]`);
177
+ }
178
+ });
179
+ return Object.freeze(entries.map((entry) => Object.freeze({ ...entry })));
180
+ }
181
+ function isKnownCode(code, entries) {
182
+ if (code === `${UNKNOWN_FAMILY}:${NEW_CONTEXT_LEAF}`)
183
+ return true;
184
+ if (entries.some((entry) => entry.code === code))
185
+ return true;
186
+ return code === `${familyOf(code)}:${NEW_CONTEXT_LEAF}` && entries.some((entry) => familyOf(entry.code) === familyOf(code));
187
+ }
188
+
189
+ // packages/rafa/src/errors/rafa-codes.ts
190
+ var SEED = "#949";
191
+ var FAMILY_DESCRIPTIONS = Object.freeze({
192
+ api: "a call to a remote service",
193
+ cli: "routing a command line and running the command",
194
+ config: "reading the project or user config",
195
+ fs: "reading or writing files",
196
+ git: "running git",
197
+ input: "a value given on the command line or in a file",
198
+ skill: "a skill file's frontmatter",
199
+ spawn: "starting a child process",
200
+ tracker: "the issue tracker",
201
+ tsc: "type-checking"
202
+ });
203
+ var RAFA_CODES = defineErrorCodes([
204
+ { code: "cli:unknown-subject", description: "the first word names no subject", hint: "run rafa --help for the subjects", level: "error", since: SEED, legacy: "unknown_subject" },
205
+ { code: "cli:missing-action", description: "a subject is named with no action after it", hint: "run rafa <subject> --help for its actions", level: "error", since: SEED, legacy: "missing_action" },
206
+ { code: "cli:unknown-action", description: "the action names nothing the subject holds", hint: "run rafa <subject> --help for its actions", level: "error", since: SEED, legacy: "unknown_action" },
207
+ { code: "cli:unknown-module", description: "a module command names a module that is not mounted", hint: "run rafa module list for the modules that are mounted", level: "error", since: SEED, legacy: "unknown_module" },
208
+ { code: "cli:unexpected-version", description: "--version is typed beside a command, where it is read alone", hint: "run rafa --version alone, with no command beside it", level: "error", since: SEED, legacy: "unexpected_version" },
209
+ { code: "cli:invalid-spec", description: "a command declares a shape the dispatcher refuses", hint: "fix the command declaration the message names", level: "error", since: SEED, legacy: "invalid_spec" },
210
+ { code: "cli:no-project", description: "a command that needs a project ran outside one", hint: "run it inside a project, or run rafa init", level: "error", since: SEED, legacy: "no_project" },
211
+ { code: "cli:command-exit", description: "a command refused and set its own exit code", hint: "read the message above it", level: "error", since: SEED, legacy: "command_exit" },
212
+ { code: "cli:command-error", description: "a command threw an error it did not handle", hint: "file a bug with the stack", level: "error", since: SEED, legacy: "command_error" },
213
+ { code: "cli:result-unwritable", description: "the command result cannot be written, as with data JSON refuses", hint: "file a bug: the command answered data that cannot be written as JSON", level: "error", since: SEED, legacy: "result_unwritable" },
214
+ { code: "skill:missing-field", description: "a required frontmatter field is absent or empty", hint: "add the field the message names", level: "error", since: SEED, legacy: "missing-field" },
215
+ { code: "skill:wrong-type", description: "a frontmatter field has a type the schema cannot read", hint: "write the field as the schema expects", level: "error", since: SEED, legacy: "wrong-type" },
216
+ { code: "skill:invalid-name", description: "a skill name is not kebab-case", hint: "rename the skill in kebab-case", level: "error", since: SEED, legacy: "invalid-name" },
217
+ { code: "skill:description-too-long", description: "the description is at or past its limit", hint: "shorten the description", level: "error", since: SEED, legacy: "description-too-long" },
218
+ { code: "skill:listing-too-long", description: "description and when_to_use together pass the listing limit", hint: "shorten when_to_use", level: "error", since: SEED, legacy: "listing-too-long" },
219
+ { code: "skill:unknown-stack", description: "a stack entry is outside the vocabulary", hint: "use a stack the schema lists", level: "error", since: SEED, legacy: "unknown-stack" },
220
+ { code: "skill:unpaired-prevents", description: "prevents is set without signal, or signal without prevents", hint: "set both or neither", level: "error", since: SEED, legacy: "unpaired-prevents" },
221
+ { code: "skill:unknown-signal", description: "signal holds a value the schema does not list", hint: "use a listed signal", level: "error", since: SEED, legacy: "unknown-signal" },
222
+ { code: "skill:unusable-glob", description: "a paths glob gates on nothing it seems to gate on", hint: "rewrite the glob", level: "error", since: SEED, legacy: "unusable-glob" },
223
+ { code: "skill:forbidden-field", description: "an instinct field appears on a skill", hint: "remove the field", level: "error", since: SEED, legacy: "forbidden-field" },
224
+ { code: "skill:unknown-provenance", description: "provenance names neither first-party nor a known mapping", hint: "use first-party or a known mapping", level: "error", since: SEED, legacy: "unknown-provenance" },
225
+ { code: "skill:invalid-reviewed", description: "provenance.reviewed is not who and a date", hint: "write <who> <YYYY-MM-DD>", level: "error", since: SEED, legacy: "invalid-reviewed" },
226
+ { code: "skill:empty-failure-string", description: "a failure_strings entry is blank", hint: "remove the blank entry", level: "error", since: SEED, legacy: "empty-failure-string" },
227
+ { code: "skill:short-failure-string", description: "a failure_strings entry is too short to name one failure", hint: "lengthen the entry", level: "warn", since: SEED, legacy: "short-failure-string" },
228
+ { code: "git:no-identity", description: "a git commit runs with no author identity set, often in a scratch home", hint: "set user.name and user.email where the commit runs", level: "error", since: SEED },
229
+ { code: "git:filesystem-boundary", description: "git prints an extra line when run outside a repository", hint: "run inside a repository, or read only the first line", level: "warn", since: SEED },
230
+ { code: "tsc:tests-excluded", description: "type errors in test files stay hidden because tsc excludes tests", hint: "type-check the test files", level: "error", since: SEED },
231
+ { code: "fs:gitignored-fixture", description: "a test reads a gitignored file a fresh checkout lacks", hint: "plant the file in the test, never read the live one", level: "error", since: SEED },
232
+ { code: "fs:live-home", description: "a test reads the live home directory instead of a planted one", hint: "point HOME at a scratch folder in the test", level: "error", since: SEED },
233
+ { code: "fs:not-found", description: "a file or folder the step needs is missing", hint: "create it, or fix the path", level: "error", since: SEED },
234
+ { code: "input:missing-param", description: "a required value was not given", hint: "pass the value the message names", level: "error", since: SEED },
235
+ { code: "input:invalid-value", description: "a given value is outside what the step accepts", hint: "pass one of the values the message lists", level: "error", since: SEED },
236
+ { code: "api:http-status", description: "a remote service answered with an error status", hint: "read the status, then retry or fix the request", level: "error", since: SEED },
237
+ { code: "config:invalid-value", description: "a config key holds a value its reader refuses", hint: "fix the key the message names", level: "error", since: SEED },
238
+ { code: "tracker:unreachable", description: "the issue tracker could not be reached", hint: "check the network and gh auth status", level: "error", since: SEED },
239
+ { code: "tracker:unavailable", description: "a tracker kind could not be made or failed its preflight, and the chain passed it over", hint: "read the reason given, or leave the fallback tracker in use", level: "warn", since: "#950" },
240
+ { code: "spawn:nonzero-exit", description: "a child process exited nonzero", hint: "read the child's stderr above", level: "error", since: SEED }
241
+ ]);
242
+ function listedCodes(projectCodes) {
243
+ return Object.freeze([
244
+ ...RAFA_CODES.map((entry) => Object.freeze({ ...entry, source: "rafa" })),
245
+ ...projectCodes.map((entry) => Object.freeze({ ...entry, source: "project" }))
246
+ ]);
247
+ }
248
+
249
+ export { LOG_LEVELS, LOGGER_THEMES, DEFAULT_LOGGER_KIND, setActiveLoggerSettings, activeLoggerSettings, levelEnabled, ERROR_LEVELS, CODE_PATTERN, NEW_CONTEXT_LEAF, UNKNOWN_FAMILY, familyOf, codeProblem, isKnownCode, RAFA_CODES, listedCodes, PR_DEFAULTS, RELEASE_DEFAULTS, DANGEROUS_RELEASE_DEFAULTS, PR_SETTINGS, RELEASE_SETTINGS, DANGEROUS_RELEASE_SETTINGS, RELEASE_SECTION };