@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
@@ -40,7 +40,7 @@ import {
40
40
  tierPins,
41
41
  tierSwitch,
42
42
  trackerKind
43
- } from "./index-ykggr043.js";
43
+ } from "./index-fpgmdmww.js";
44
44
 
45
45
  // packages/rafa/src/core/config/config-items.ts
46
46
  var itemText = text("a non-empty string");
@@ -186,6 +186,7 @@ var CORE_SPECS = {
186
186
  cli: true
187
187
  },
188
188
  loopWorktreeDir: { key: "loop.worktreeDir", read: directory, cli: false },
189
+ loopWorktreeSetup: { key: "loop.worktreeSetup", read: text("a shell command"), cli: false },
189
190
  boardTrustedAuthors: {
190
191
  key: "board.trustedAuthors",
191
192
  read: listOf(githubLogin, "GitHub logins"),
@@ -230,7 +231,12 @@ var CORE_SPECS = {
230
231
  taskSkills: { key: "task.skills", read: skillResolverName, cli: true },
231
232
  taskLessons: { key: "task.lessons", read: lessonSwitch, cli: false },
232
233
  mergeDuplicates: { key: "merge.duplicates", read: duplicatesLevel, cli: false },
233
- namingBranch: { key: "naming.branch", read: branchTemplate, cli: false }
234
+ namingBranch: { key: "naming.branch", read: branchTemplate, cli: false },
235
+ templates: {
236
+ key: "templates",
237
+ read: listOf(text("a template name"), "template names"),
238
+ cli: false
239
+ }
234
240
  };
235
241
  var CORE_DEFAULTS = Object.freeze({
236
242
  version: 1,
@@ -256,6 +262,7 @@ var CORE_DEFAULTS = Object.freeze({
256
262
  allowList: Object.freeze([]),
257
263
  settingSources: Object.freeze(["project", "local"]),
258
264
  loopWorktreeDir: join(".rafa", "worktrees"),
265
+ loopWorktreeSetup: null,
259
266
  boardTrustedAuthors: Object.freeze([]),
260
267
  boardRelationships: "labels",
261
268
  boardProjectTemplate: BOARD_PROJECT_TEMPLATE_DEFAULT,
@@ -276,7 +283,8 @@ var CORE_DEFAULTS = Object.freeze({
276
283
  taskSkills: "planner",
277
284
  taskLessons: "on",
278
285
  mergeDuplicates: "warn",
279
- namingBranch: DEFAULT_BRANCH_TEMPLATE
286
+ namingBranch: DEFAULT_BRANCH_TEMPLATE,
287
+ templates: Object.freeze([])
280
288
  });
281
289
  var CORE_SECTION = Object.freeze({
282
290
  package: CORE_PACKAGE,
@@ -288,11 +296,15 @@ var CORE_SECTION = Object.freeze({
288
296
  import { join as join2 } from "path";
289
297
 
290
298
  // packages/rafa/src/core/config/config-origins.ts
291
- function originOf(source, setting, file, user) {
292
- const layer = source === "file" ? file : source === "user" ? user : null;
293
- if (layer === null)
299
+ function originOf(source, setting, answeredBy) {
300
+ if (answeredBy === null || source === "cli" || source === "default")
301
+ return null;
302
+ if (source !== "template")
303
+ return Object.freeze({ file: answeredBy.path, entry: answeredBy.entries?.get(setting) ?? 0 });
304
+ const template = answeredBy.templates?.get(setting);
305
+ if (template === undefined)
294
306
  return null;
295
- return Object.freeze({ file: layer.path, entry: layer.entries?.get(setting) ?? 0 });
307
+ return Object.freeze({ file: answeredBy.path, entry: answeredBy.entries?.get("templates") ?? 0, template });
296
308
  }
297
309
 
298
310
  // packages/rafa/src/core/config/section.ts
@@ -408,6 +420,21 @@ function activeDefaults() {
408
420
  function activeChecks() {
409
421
  return active.checks;
410
422
  }
423
+ function requireRegistered(reader) {
424
+ if (active.sections.length > 0)
425
+ return;
426
+ throw new ConfigSectionError([
427
+ `no config section is registered: call registerCoreConfigSections from src/config-registry.ts before ${reader}`
428
+ ]);
429
+ }
430
+ function registeredDefaults() {
431
+ requireRegistered("registeredDefaults");
432
+ return active.defaults;
433
+ }
434
+ function registeredSettings() {
435
+ requireRegistered("registeredSettings");
436
+ return active.settings;
437
+ }
411
438
  function prefixesOf(key) {
412
439
  const parts = key.split(".");
413
440
  return parts.slice(1).map((_, index) => parts.slice(0, index + 1).join("."));
@@ -470,6 +497,15 @@ function setConfigLoadHook(hook) {
470
497
  function activeConfigLoadHook() {
471
498
  return loadHook;
472
499
  }
500
+ var templateHook = null;
501
+ function setConfigTemplateHook(hook) {
502
+ const previous = templateHook;
503
+ templateHook = hook;
504
+ return previous;
505
+ }
506
+ function activeConfigTemplateHook() {
507
+ return templateHook;
508
+ }
473
509
 
474
510
  // packages/rafa/src/core/config/config.ts
475
511
  class ConfigError extends Error {
@@ -605,6 +641,28 @@ function unloadedPinWarnings(layer) {
605
641
  ];
606
642
  return pins.flatMap(([key, map]) => [...map ?? []].filter(([, pin]) => pin === "rafa").map(([name]) => `rafa config: ${key}.${name} in ${layer.path} pins the rafa tier, ` + "which is not loaded (tiers.rafa is off), so the pin has no effect"));
607
643
  }
644
+ function layTemplatesUnder(file, templates) {
645
+ if (templates.length === 0)
646
+ return file;
647
+ const answered = new Map;
648
+ const entries = registeredNames().map((setting) => {
649
+ const own = file.values[setting];
650
+ const under = templates.filter((template) => template.values[setting] !== undefined);
651
+ const last = under.at(-1);
652
+ if (last === undefined)
653
+ return [setting, own];
654
+ if (own === undefined)
655
+ answered.set(setting, last.name);
656
+ if (isMapSetting(setting))
657
+ return [setting, mergeMaps(...under.map((template) => template.values[setting]), own)];
658
+ return [setting, own ?? last.values[setting]];
659
+ });
660
+ const values = Object.fromEntries(entries);
661
+ return { ...file, values, templates: answered };
662
+ }
663
+ function sourceIn(layer, setting, own) {
664
+ return layer.templates?.has(setting) === true ? "template" : own;
665
+ }
608
666
  function unknownKeyWarning(key, path) {
609
667
  const quoted2 = JSON.stringify(key);
610
668
  const [under, names] = activeKnownKeysAbove(key);
@@ -612,41 +670,38 @@ function unknownKeyWarning(key, path) {
612
670
  return `rafa config: unknown key ${quoted2} in ${path} has no effect ` + `in this version (known keys${where}: ${names.join(", ")})`;
613
671
  }
614
672
  function resolveConfig(layers = {}) {
673
+ const local = layers.local ?? null;
615
674
  const file = layers.file ?? null;
675
+ const userLocal = layers.userLocal ?? null;
616
676
  const user = layers.user ?? null;
617
677
  const overrides = layers.cli ?? {};
618
678
  const { layer: cli, problems } = readLayer((setting) => isCommandLineSetting(setting) ? overrides[setting] : undefined, (setting) => ({ label: `command line: ${setting}`, key: setting }));
619
679
  if (problems.length > 0)
620
680
  throw new ConfigError(problems);
681
+ const order = [[local, "local"], [file, "file"], [userLocal, "user"], [user, "user"]];
682
+ const files = order.flatMap(([layer, source]) => layer === null ? [] : [{ layer, source }]);
621
683
  const defaults = activeDefaults();
622
684
  const rank = (setting) => {
623
685
  const fromCli = cli[setting];
624
686
  if (fromCli !== undefined)
625
- return { value: fromCli, source: "cli" };
626
- const fromFile = file?.values[setting];
627
- const fromUser = user?.values[setting];
628
- if (isMapSetting(setting)) {
629
- const merged = mergeMaps(defaults[setting], fromUser, fromFile);
630
- const source = fromFile !== undefined ? "file" : fromUser !== undefined ? "user" : "default";
631
- return { value: merged, source };
632
- }
633
- if (fromFile !== undefined)
634
- return { value: fromFile, source: "file" };
635
- if (fromUser !== undefined)
636
- return { value: fromUser, source: "user" };
637
- return { value: defaults[setting], source: "default" };
687
+ return { value: fromCli, source: "cli", answeredBy: null };
688
+ const answered = files.find(({ layer }) => layer.values[setting] !== undefined);
689
+ const value = isMapSetting(setting) ? mergeMaps(defaults[setting], ...files.map(({ layer }) => layer.values[setting]).reverse()) : answered === undefined ? defaults[setting] : answered.layer.values[setting];
690
+ if (answered === undefined)
691
+ return { value, source: "default", answeredBy: null };
692
+ return { value, source: sourceIn(answered.layer, setting, answered.source), answeredBy: answered.layer };
638
693
  };
639
694
  const ranked = registeredNames().map((setting) => [setting, rank(setting)]);
640
695
  const config = Object.fromEntries(ranked.map(([setting, { value }]) => [setting, value]));
641
696
  const sources = Object.fromEntries(ranked.map(([setting, { source }]) => [setting, source]));
642
- const provenance = Object.fromEntries(ranked.map(([setting, { source }]) => [setting, originOf(source, setting, file, user)]));
697
+ const provenance = Object.fromEntries(ranked.map(([setting, { source, answeredBy }]) => [setting, originOf(source, setting, answeredBy)]));
643
698
  const path = file?.path ?? null;
644
699
  const userPath = user?.path ?? null;
645
- const checkProblems = activeChecks().flatMap((check) => check({ config, sources, path, userPath }));
700
+ const checkProblems = activeChecks().flatMap((check) => check({ config, sources, path, userPath, provenance }));
646
701
  if (checkProblems.length > 0)
647
702
  throw new ConfigError(checkProblems);
648
703
  const rafaLoaded = ranked.find(([setting]) => setting === "tiersRafa")?.[1].value !== "off";
649
- const warnings = [user, file].flatMap((layer) => layer === null ? [] : [
704
+ const warnings = [...files].reverse().flatMap(({ layer }) => [
650
705
  ...layer.extras.map((extra) => unknownKeyWarning(extra.key, layer.path)),
651
706
  ...rafaLoaded ? [] : unloadedPinWarnings(layer)
652
707
  ]);
@@ -654,12 +709,15 @@ function resolveConfig(layers = {}) {
654
709
  config,
655
710
  sources,
656
711
  path,
712
+ localPath: local?.path ?? null,
657
713
  userPath,
714
+ userLocalPath: userLocal?.path ?? null,
658
715
  extras: file?.extras ?? [],
716
+ localExtras: local?.extras ?? [],
659
717
  userExtras: user?.extras ?? [],
718
+ userLocalExtras: userLocal?.extras ?? [],
660
719
  warnings,
661
- provenance,
662
- shadowed: []
720
+ provenance
663
721
  };
664
722
  }
665
723
 
@@ -707,4 +765,4 @@ function writeDangerousPassLines(resolved, warn, invocation) {
707
765
  warn(line);
708
766
  }
709
767
  }
710
- export { PREREQUISITE_KINDS, requiredPrerequisite, optionalPrerequisite, MODULE_SOURCE_KINDS, DEFAULT_ROUTING, CONFIG_FILE, SCOPE_DIR, CORE_SECTION, registerConfigSections, activeSections, activeSettings, activeDefaults, activeSettingByKey, setConfigLoadHook, activeConfigLoadHook, ConfigError, parseConfigDocument, configFilePath, parseConfigText, readConfigDocument, resolveConfig, writeDangerousPassLines, scopeAt };
768
+ export { PREREQUISITE_KINDS, requiredPrerequisite, optionalPrerequisite, MODULE_SOURCE_KINDS, DEFAULT_ROUTING, CONFIG_FILE, SCOPE_DIR, CORE_SECTION, registerConfigSections, activeSections, activeSettings, activeDefaults, registeredDefaults, registeredSettings, activeSettingByKey, setConfigLoadHook, activeConfigLoadHook, setConfigTemplateHook, activeConfigTemplateHook, ConfigError, parseConfigDocument, configFilePath, parseConfigText, readConfigDocument, layTemplatesUnder, resolveConfig, writeDangerousPassLines, scopeAt };