@starci/eslint-canon-be 3.18.4 → 3.19.1

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 (211) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/README.md +1 -1
  3. package/dist/comments.js +1 -1
  4. package/dist/explicit-surface.js +1 -1
  5. package/dist/index.js +1 -1
  6. package/dist/jwt-alg.js +1 -1
  7. package/dist/lib/edition.d.ts +1 -1
  8. package/dist/lib/edition.js +1 -1
  9. package/dist/lib/hfs-view.d.ts +5 -0
  10. package/dist/lib/hfs.d.ts +0 -6
  11. package/dist/lib/hfs.js +7 -5
  12. package/dist/lib/runtime-root.d.ts +6 -1
  13. package/dist/lib/runtime-root.js +8 -2
  14. package/dist/lib/subject-values.js +1 -1
  15. package/dist/module-layering.js +2 -2
  16. package/dist/project-graph.js +1 -1
  17. package/dist/schema-authority.js +66 -2
  18. package/dist/third-party-owner.js +1 -1
  19. package/package.json +3 -1
  20. package/runtime/bundle.json +1 -190
  21. package/runtime/scripts/api/git/recorded-lines.mjs +5 -5
  22. package/runtime/scripts/hfs/project-graph.mjs +6 -6
  23. package/runtime/scripts/hfs/project-rule.mjs +3 -3
  24. package/runtime/config.example.yaml +0 -194
  25. package/runtime/engine/by-code-unit.mjs +0 -12
  26. package/runtime/engine/config.mjs +0 -461
  27. package/runtime/engine/invalid-config.mjs +0 -15
  28. package/runtime/engine/model-config.mjs +0 -112
  29. package/runtime/engine/orca-config.mjs +0 -34
  30. package/runtime/engine/plain-object.mjs +0 -5
  31. package/runtime/engine/release-config.mjs +0 -32
  32. package/runtime/engine/removed-vocabulary.mjs +0 -27
  33. package/runtime/engine/resources-config.mjs +0 -59
  34. package/runtime/engine/runtime-root.mjs +0 -138
  35. package/runtime/engine/secrets.mjs +0 -202
  36. package/runtime/engine/sonar-config.mjs +0 -24
  37. package/runtime/engine/temp-root.mjs +0 -26
  38. package/runtime/engine/yaml.mjs +0 -161
  39. package/runtime/knowledge/grammars/index.yaml +0 -114
  40. package/runtime/knowledge/hfs/canon-pins.yaml +0 -720
  41. package/runtime/knowledge/hfs/fe-stack.yaml +0 -272
  42. package/runtime/knowledge/hfs/rules.yaml +0 -6760
  43. package/runtime/knowledge/hfs/slots.yaml +0 -2783
  44. package/runtime/knowledge/patterns/fe/folder.yaml +0 -425
  45. package/runtime/knowledge/sonar-gate.yaml +0 -151
  46. package/runtime/modules/kernel/removed-vocabulary.yaml +0 -458
  47. package/runtime/modules/models/registry.yaml +0 -221
  48. package/runtime/modules/models/runtimes.yaml +0 -556
  49. package/runtime/modules/models/tiers.yaml +0 -66
  50. package/runtime/scripts/api/git/cat-file.mjs +0 -4
  51. package/runtime/scripts/api/git/config-get.mjs +0 -9
  52. package/runtime/scripts/api/git/diff.mjs +0 -4
  53. package/runtime/scripts/api/git/lib.mjs +0 -80
  54. package/runtime/scripts/api/git/ls-files.mjs +0 -5
  55. package/runtime/scripts/api/git/ls-tree.mjs +0 -4
  56. package/runtime/scripts/api/git/merge-base.mjs +0 -8
  57. package/runtime/scripts/api/git/remote.mjs +0 -4
  58. package/runtime/scripts/api/git/rev-parse-query.mjs +0 -4
  59. package/runtime/scripts/api/git/show.mjs +0 -5
  60. package/runtime/scripts/api/git/tag.mjs +0 -4
  61. package/runtime/scripts/hfs/allows.mjs +0 -77
  62. package/runtime/scripts/hfs/architecture/ast-walks.mjs +0 -250
  63. package/runtime/scripts/hfs/architecture/automatic-gates.mjs +0 -103
  64. package/runtime/scripts/hfs/architecture/backend-app-files.mjs +0 -114
  65. package/runtime/scripts/hfs/architecture/backend.mjs +0 -462
  66. package/runtime/scripts/hfs/architecture/background-unowned.mjs +0 -254
  67. package/runtime/scripts/hfs/architecture/canon-clones.mjs +0 -291
  68. package/runtime/scripts/hfs/architecture/canon-jsx-clones.mjs +0 -224
  69. package/runtime/scripts/hfs/architecture/client-reaches-server.mjs +0 -102
  70. package/runtime/scripts/hfs/architecture/clones.mjs +0 -287
  71. package/runtime/scripts/hfs/architecture/component-tiers.mjs +0 -161
  72. package/runtime/scripts/hfs/architecture/config-unread.mjs +0 -16
  73. package/runtime/scripts/hfs/architecture/config.mjs +0 -407
  74. package/runtime/scripts/hfs/architecture/connection-map.mjs +0 -350
  75. package/runtime/scripts/hfs/architecture/constructor-deps.mjs +0 -115
  76. package/runtime/scripts/hfs/architecture/context-coupling.mjs +0 -117
  77. package/runtime/scripts/hfs/architecture/context-map.mjs +0 -355
  78. package/runtime/scripts/hfs/architecture/context-owner.mjs +0 -102
  79. package/runtime/scripts/hfs/architecture/context-platform-tables.mjs +0 -65
  80. package/runtime/scripts/hfs/architecture/context-transaction.mjs +0 -75
  81. package/runtime/scripts/hfs/architecture/contract-bounds.mjs +0 -72
  82. package/runtime/scripts/hfs/architecture/contract-fixture-guard.mjs +0 -177
  83. package/runtime/scripts/hfs/architecture/contracts-readonly.mjs +0 -360
  84. package/runtime/scripts/hfs/architecture/contracts.mjs +0 -489
  85. package/runtime/scripts/hfs/architecture/cross-app-duplicate.mjs +0 -81
  86. package/runtime/scripts/hfs/architecture/dead-exports-bindings.mjs +0 -173
  87. package/runtime/scripts/hfs/architecture/dead-exports.mjs +0 -420
  88. package/runtime/scripts/hfs/architecture/default-deny.mjs +0 -175
  89. package/runtime/scripts/hfs/architecture/doc-language.mjs +0 -45
  90. package/runtime/scripts/hfs/architecture/entity-registry.mjs +0 -51
  91. package/runtime/scripts/hfs/architecture/entrypoint.mjs +0 -75
  92. package/runtime/scripts/hfs/architecture/error-codes.mjs +0 -54
  93. package/runtime/scripts/hfs/architecture/error-masked.mjs +0 -78
  94. package/runtime/scripts/hfs/architecture/fe-slot-allows.mjs +0 -44
  95. package/runtime/scripts/hfs/architecture/feature-shape.mjs +0 -60
  96. package/runtime/scripts/hfs/architecture/framework-pinned.mjs +0 -41
  97. package/runtime/scripts/hfs/architecture/frontend-block-render.mjs +0 -112
  98. package/runtime/scripts/hfs/architecture/frontend-grammar.mjs +0 -193
  99. package/runtime/scripts/hfs/architecture/frontend-routing.mjs +0 -198
  100. package/runtime/scripts/hfs/architecture/frontend-world-render.mjs +0 -368
  101. package/runtime/scripts/hfs/architecture/frontend-world.mjs +0 -374
  102. package/runtime/scripts/hfs/architecture/frontend.mjs +0 -248
  103. package/runtime/scripts/hfs/architecture/function-spec-providers.mjs +0 -185
  104. package/runtime/scripts/hfs/architecture/hfs-graph.mjs +0 -77
  105. package/runtime/scripts/hfs/architecture/hfs.mjs +0 -394
  106. package/runtime/scripts/hfs/architecture/hooks-are-hooks.mjs +0 -118
  107. package/runtime/scripts/hfs/architecture/i18n-keys.mjs +0 -213
  108. package/runtime/scripts/hfs/architecture/identity.mjs +0 -121
  109. package/runtime/scripts/hfs/architecture/index.mjs +0 -402
  110. package/runtime/scripts/hfs/architecture/injection-token-exported.mjs +0 -69
  111. package/runtime/scripts/hfs/architecture/jwt-ast.mjs +0 -231
  112. package/runtime/scripts/hfs/architecture/machine-ast.mjs +0 -232
  113. package/runtime/scripts/hfs/architecture/managed-scripts.mjs +0 -32
  114. package/runtime/scripts/hfs/architecture/module-per-transport.mjs +0 -237
  115. package/runtime/scripts/hfs/architecture/next-data-contract.mjs +0 -126
  116. package/runtime/scripts/hfs/architecture/next-data-inference.mjs +0 -192
  117. package/runtime/scripts/hfs/architecture/next-data-key.mjs +0 -374
  118. package/runtime/scripts/hfs/architecture/next-data-symbols.mjs +0 -26
  119. package/runtime/scripts/hfs/architecture/next-data.mjs +0 -425
  120. package/runtime/scripts/hfs/architecture/operation-contract-roots.mjs +0 -55
  121. package/runtime/scripts/hfs/architecture/owners.mjs +0 -142
  122. package/runtime/scripts/hfs/architecture/package-shape.mjs +0 -92
  123. package/runtime/scripts/hfs/architecture/presentation.mjs +0 -173
  124. package/runtime/scripts/hfs/architecture/reachability.mjs +0 -330
  125. package/runtime/scripts/hfs/architecture/register-once.mjs +0 -212
  126. package/runtime/scripts/hfs/architecture/registration.mjs +0 -372
  127. package/runtime/scripts/hfs/architecture/render-graph.mjs +0 -449
  128. package/runtime/scripts/hfs/architecture/render-prop-across-server.mjs +0 -58
  129. package/runtime/scripts/hfs/architecture/required-files.mjs +0 -237
  130. package/runtime/scripts/hfs/architecture/root-packages.mjs +0 -78
  131. package/runtime/scripts/hfs/architecture/route-files-thin.mjs +0 -133
  132. package/runtime/scripts/hfs/architecture/schema-owner.mjs +0 -288
  133. package/runtime/scripts/hfs/architecture/server-action.mjs +0 -78
  134. package/runtime/scripts/hfs/architecture/side-boundary.mjs +0 -13
  135. package/runtime/scripts/hfs/architecture/source-names-shape.mjs +0 -320
  136. package/runtime/scripts/hfs/architecture/source-names.mjs +0 -393
  137. package/runtime/scripts/hfs/architecture/sql-keys.mjs +0 -344
  138. package/runtime/scripts/hfs/architecture/sql-owner.mjs +0 -291
  139. package/runtime/scripts/hfs/architecture/sql-returning.mjs +0 -76
  140. package/runtime/scripts/hfs/architecture/sql-token-forms.mjs +0 -117
  141. package/runtime/scripts/hfs/architecture/sql-tokens.mjs +0 -587
  142. package/runtime/scripts/hfs/architecture/staged-consumers.mjs +0 -42
  143. package/runtime/scripts/hfs/architecture/surface-nesting.mjs +0 -127
  144. package/runtime/scripts/hfs/architecture/surface.mjs +0 -88
  145. package/runtime/scripts/hfs/architecture/symbols.mjs +0 -273
  146. package/runtime/scripts/hfs/architecture/test-world-files.mjs +0 -263
  147. package/runtime/scripts/hfs/architecture/tiers.mjs +0 -256
  148. package/runtime/scripts/hfs/architecture/transport-owner.mjs +0 -248
  149. package/runtime/scripts/hfs/architecture/type-context.mjs +0 -335
  150. package/runtime/scripts/hfs/architecture/typescript.mjs +0 -477
  151. package/runtime/scripts/hfs/architecture/unit-spec-providers.mjs +0 -165
  152. package/runtime/scripts/hfs/declaration-shape.mjs +0 -196
  153. package/runtime/scripts/hfs/declaration-slots.mjs +0 -89
  154. package/runtime/scripts/hfs/edition-slots.mjs +0 -80
  155. package/runtime/scripts/hfs/explicit-surface-rule.mjs +0 -59
  156. package/runtime/scripts/hfs/linear-text.mjs +0 -30
  157. package/runtime/scripts/hfs/manifest-shape.mjs +0 -474
  158. package/runtime/scripts/hfs/param-names.mjs +0 -13
  159. package/runtime/scripts/hfs/path-findings.mjs +0 -167
  160. package/runtime/scripts/hfs/repo-identity.mjs +0 -89
  161. package/runtime/scripts/hfs/rule-catalog.mjs +0 -458
  162. package/runtime/scripts/hfs/rule-params-shape.mjs +0 -103
  163. package/runtime/scripts/hfs/rules/database-constants.mjs +0 -25
  164. package/runtime/scripts/hfs/rules/database-migrations.mjs +0 -684
  165. package/runtime/scripts/hfs/rules/fe-no-tests.mjs +0 -68
  166. package/runtime/scripts/hfs/rules/read.mjs +0 -45
  167. package/runtime/scripts/hfs/rules/secrets.mjs +0 -79
  168. package/runtime/scripts/hfs/rules/spec-placement.mjs +0 -28
  169. package/runtime/scripts/hfs/slot-app-view.mjs +0 -97
  170. package/runtime/scripts/hfs/slot-classify.mjs +0 -69
  171. package/runtime/scripts/hfs/slot-errors.mjs +0 -12
  172. package/runtime/scripts/hfs/slot-imports.mjs +0 -98
  173. package/runtime/scripts/hfs/slot-manifest-shape.mjs +0 -111
  174. package/runtime/scripts/hfs/slot-match.mjs +0 -164
  175. package/runtime/scripts/hfs/slot-path.mjs +0 -6
  176. package/runtime/scripts/hfs/slot-required.mjs +0 -95
  177. package/runtime/scripts/hfs/slot-semantic-problems.mjs +0 -175
  178. package/runtime/scripts/hfs/slot-side-problems.mjs +0 -32
  179. package/runtime/scripts/hfs/slots.mjs +0 -306
  180. package/runtime/scripts/hfs/test-world-slot.mjs +0 -5
  181. package/runtime/scripts/hfs/trailing-slashes.mjs +0 -8
  182. package/runtime/scripts/hfs/typescript-programs.mjs +0 -95
  183. package/runtime/scripts/hfs/view.mjs +0 -180
  184. package/runtime/scripts/lib/declaration-surface.mjs +0 -166
  185. package/runtime/scripts/lib/dockerfile.mjs +0 -164
  186. package/runtime/scripts/lib/env.mjs +0 -18
  187. package/runtime/scripts/lib/event-contract.mjs +0 -102
  188. package/runtime/scripts/lib/git-hooks-dir.mjs +0 -30
  189. package/runtime/scripts/lib/git.mjs +0 -35
  190. package/runtime/scripts/lib/glob.mjs +0 -32
  191. package/runtime/scripts/lib/grammar-lint.mjs +0 -57
  192. package/runtime/scripts/lib/i18n.mjs +0 -82
  193. package/runtime/scripts/lib/in-order.mjs +0 -90
  194. package/runtime/scripts/lib/json-clone.mjs +0 -70
  195. package/runtime/scripts/lib/json.mjs +0 -44
  196. package/runtime/scripts/lib/language.mjs +0 -233
  197. package/runtime/scripts/lib/list.mjs +0 -26
  198. package/runtime/scripts/lib/mutation-fence.mjs +0 -20
  199. package/runtime/scripts/lib/package-at.mjs +0 -62
  200. package/runtime/scripts/lib/path-key.mjs +0 -124
  201. package/runtime/scripts/lib/read-text.mjs +0 -47
  202. package/runtime/scripts/lib/regex.mjs +0 -3
  203. package/runtime/scripts/lib/rule-packs.mjs +0 -243
  204. package/runtime/scripts/lib/same-text.mjs +0 -4
  205. package/runtime/scripts/lib/secret-patterns.mjs +0 -230
  206. package/runtime/scripts/lib/sops-envelope.mjs +0 -212
  207. package/runtime/scripts/lib/stack-services.mjs +0 -191
  208. package/runtime/scripts/lib/ts-analysis.mjs +0 -39
  209. package/runtime/scripts/lib/ts-ast.mjs +0 -63
  210. package/runtime/scripts/lib/walk.mjs +0 -45
  211. package/runtime/scripts/lib/yaml-cached.mjs +0 -14
@@ -13,12 +13,12 @@
13
13
  // A graph that cannot be built (no tsconfig, unresolvable import, invalid declaration) is an error: a check that cannot run is
14
14
  // never a pass, so `projectGraph` throws the machine's own message and the lint run stops.
15
15
  import fs from 'node:fs';
16
- import { checkArchitecture } from './architecture/index.mjs';
17
- import { openHfs } from './slots.mjs';
18
- import { pathFindings } from './path-findings.mjs';
19
- import { lsFiles } from '../api/git/ls-files.mjs';
20
- import { posixPath } from '../lib/path-key.mjs';
21
- import { onLintSurface } from './architecture/surface.mjs';
16
+ import { checkArchitecture } from '@starci/hfs/runtime/scripts/hfs/architecture/index.mjs';
17
+ import { openHfs } from '@starci/hfs/runtime/scripts/hfs/slots.mjs';
18
+ import { pathFindings } from '@starci/hfs/runtime/scripts/hfs/path-findings.mjs';
19
+ import { lsFiles } from '@starci/hfs/runtime/scripts/api/git/ls-files.mjs';
20
+ import { posixPath } from '@starci/hfs/runtime/scripts/lib/path-key.mjs';
21
+ import { onLintSurface } from '@starci/hfs/runtime/scripts/hfs/architecture/surface.mjs';
22
22
 
23
23
  const cache = new Map();
24
24
 
@@ -8,8 +8,8 @@
8
8
  // Both lint canons ship a byte copy of this file in runtime/ and build their rules with it.
9
9
  import path from 'node:path';
10
10
  import { projectGraph } from './project-graph.mjs';
11
- import { posixPath } from '../lib/path-key.mjs';
12
- import { belongsTo, codeOf } from './architecture/surface.mjs';
11
+ import { posixPath } from '@starci/hfs/runtime/scripts/lib/path-key.mjs';
12
+ import { belongsTo, codeOf } from '@starci/hfs/runtime/scripts/hfs/architecture/surface.mjs';
13
13
 
14
14
  /**
15
15
  * A rule reporting the graph findings of `codes` on the linted file.
@@ -23,7 +23,7 @@ export const projectRule = ({ enforcer, runtimeRoot, hfsOf }) => {
23
23
  create(context) {
24
24
  const hfs = hfsOf(context);
25
25
  const rel = posixPath(path.relative(hfs.repoRoot, context.filename));
26
- if (rel.startsWith('..')) return {};
26
+ if (rel.startsWith('@starci/hfs/runtime/scripts')) return {};
27
27
  const { byFile } = projectGraph({ repoRoot: hfs.repoRoot, runtimeRoot: context.settings?.starci?.injectedRuntimeRoot ?? runtimeRoot, injectedTypeScript: context.settings?.starci?.injectedTypeScript?.() });
28
28
  const mine = (byFile.get(rel) ?? []).filter((finding) => belongsTo(enforcer, finding));
29
29
  return {
@@ -1,194 +0,0 @@
1
- # config.example.yaml — seed for the per-project owner config.
2
- # The installer copies this file to the gitignored `config.yaml` next to it;
3
- # owners edit that copy. Everything below is read at runtime — no key here is
4
- # decorative. Kernel route precedence: explicit `--agent` flag >
5
- # `kernel` below > the tier chain (modules/models/tiers.yaml).
6
- language: vi
7
- model: null
8
- effort: medium
9
- # Explicit current owner adoption is required; shipped defaults grant no trust or purge authority.
10
- # launchTrust: {profile: automatic, approvedBy: owner, approvalRef: '<current approval>', roots: ['<exact absolute repository root>']}
11
- # profile: declined preserves an explicit decision; provider-side declines also remain authoritative.
12
- launchTrust: null
13
- # retention: {workflowPurge: {approvedBy: owner, approvalRef: '<current approval>', repos: ['<exact absolute ledger-owner repo>']}}
14
- retention: null
15
- # kernel — the long-lived [Kernel] seat. It takes the `high` tier of modules/models/tiers.yaml (an ordered chain of
16
- # members; the picker takes the first member with tokens after your bias and the balance step; docs/config-format.md).
17
- # {agent?, model?, effort?}: agent and/or model PIN the seat — the bias `only`, keeping the tier's model of that agent
18
- # (an explicit `--agent` flag is the same bias and wins). effort: the seat's effort; null takes the tier member's effort.
19
- kernel: {effort: high}
20
- # parallel — the one knob for how wide the workers run. `gear` indexes the agent
21
- # table in modules/models/runtimes.yaml allocation.slicing.size: a long (`l`)
22
- # operation asks for the `l.agents[gear]` agents, an extra-long (`xl`) one for
23
- # `xl.agents[gear]`; `s` and `m` operations are always one agent. Declared gears
24
- # are allocation.slicing.gears — an undeclared value fails closed. Absent means
25
- # the first declared gear. A gear raises only what `starci kernel estimate` requests; it
26
- # never raises a pool's maxParallel, maxParallelOps or budgets.maxOps below.
27
- parallel: {gear: 1}
28
- # supervisor — the optional chat digest cadence. pollIntervalMs controls
29
- # scripts/supervisor/poll.mjs when run continuously (its floor is the config
30
- # validation of engine/config.mjs); null uses scripts/machine/home.mjs
31
- # DEFAULTS, and --interval-ms overrides this key.
32
- # The reconciler engine owns host runtime cadence and restores seats after reboot.
33
- # repos: managed product ledger-owner repositories for the reconciler and Supervisor tools,
34
- # relative to the source root (the directory holding this skill) or absolute.
35
- # --repo on the poll command line can add another. stallMinutes (optional,
36
- # integer >= 5) marks a running workflow STALLED in scripts/supervisor/stall.mjs;
37
- # the Workflow controller turns actionable findings into Decision Items. The [Supervisor]
38
- # kernel (docs/supervisor.md) also takes, optional, defaults in home.mjs DEFAULTS:
39
- # kernel: {agent, model, effort} its agent pin (default: the kernel pin below)
40
- # workers: {base, max} the adaptive [Worker] cap, 0 to 10 (0 = the Supervisor runs no fix worker)
41
- # landGate: {mode: shared, push: true} shared lets running lanes commit directly; exclusive = gate only. A land
42
- # fast-forwards LOCAL main; main reaches the remote right after a green scoped check through
43
- # `starci release push` (push: true, the default; false locks the remote). CI is the critic.
44
- supervisor:
45
- # mode: chat (default) - the owner's desktop chat session is the Supervisor: it owns channel 'main'
46
- # and reads Decision Items; nothing starts a [Supervisor] kernel. kernel - the optional [Supervisor]
47
- # Orca kernel (scripts/supervisor/start-supervisor.mjs), kept alive by the reconciler Host controller.
48
- # See docs/supervisor.md.
49
- # mode: chat
50
- pollIntervalMs: null
51
- repos: []
52
- # frozenMinutes: <n> # Host seat check: a busy frame unchanged this long is frozen, not busy
53
- # landGate: {mode: shared|exclusive, push: true|false}
54
- # delegation — while the owner is away, a named delegate (e.g. the supervisor chat) may
55
- # answer owner asks until the given time; excluded classes stay owner-only. null = none.
56
- # delegation: {asks: supervisor, until: 2026-09-23T09:00:00+07:00,
57
- # excludes: [credentials, oauth-consent, payments, legal, payment-provider]}
58
- delegation: null
59
- # budgets — the owner's ceiling, surfaced by every plan before `ok`. Null = unbounded.
60
- budgets:
61
- maxOps: null # max concurrent dispatched ops one workflow may hold open;
62
- # route/dispatch refuse `max-ops` at min(this, maxParallelOps)
63
- # allocation — the owner's default grant for a pool whose capacity is an explicit grant (Devin).
64
- # grants: '<pool>=<slots>@<role>+<role>' — the default grant every workflow gets. Once a grants list is
65
- # declared it is the whole set: a pool whose registry.yaml capacityAuthority is explicit-workflow-quota
66
- # (Devin) routes only for the roles and up to the running slots a grant names ([] closes it).
67
- allocation:
68
- grants: [devin-agent=10@implement+verify+write]
69
- # models — optional overrides of the shipped model tiers (modules/models/tiers.yaml owns the defaults). Every key is optional:
70
- # tiers: {<tier>: [{agent, model, effort?}, ...]} replaces or adds one tier's ordered member chain
71
- # seats: {<seat>: <tier>} remaps a seat (supervisor, kernel, worker, planner, validator, kernelManager)
72
- # balance: {maxStreak, maxSharePercent} a head member picked maxStreak times in a row, or holding more than
73
- # maxSharePercent of the tier's running seats, yields to the next member
74
- # usage: {reservePercent, biasPercent} a member at reservePercent of its tokens is skipped; an owner bias
75
- # naming it keeps it usable up to biasPercent; never above it
76
- models: {}
77
- # connectors — the owner's public ask channel (docs/connectors.md). Everything is off by default.
78
- # One local gateway (scripts/connectors/ask-gateway.mjs) fronts every serve-ask form; a Cloudflare
79
- # tunnel (scripts/connectors/tunnel.mjs) publishes the gateway; when serve-ask binds a form, the
80
- # kernel's ask path sends the owner one Telegram message (scripts/connectors/telegram.mjs) with the
81
- # question, its options and the public link. Telegram carries owner asks only.
82
- # SECRETS NEVER GO IN THIS FILE: tokenEnv/botTokenEnv NAME an environment variable holding the token
83
- # (or <NAME>_FILE pointing at a custody file); a value that is not an UPPER_SNAKE env var name is refused.
84
- # Host credentials use the canonical runtime root secret.env; docs/host-secrets.md owns setup.
85
- # Supplied environment values win, including blank values. Missing local file adds no values.
86
- # repos: ledger-owner repository roots whose asks go public, relative to the source root (the
87
- # directory holding this skill) or absolute. [] = the source root plus every .workspaces project owner.
88
- # gateway.port: the one fixed local port the tunnel points at (outside the 6969..7069 form band).
89
- # cloudflare.mode: off | quick | named.
90
- # quick — `cloudflared tunnel --url`, a random https://*.trycloudflare.com host, no account, no auth,
91
- # a new host on every restart. Good for decisions only.
92
- # named — a fixed `hostname`, authenticated one of two ways: `tunnel` (UUID) + `credentialsFile`
93
- # (the JSON `cloudflared tunnel create` wrote; the manager writes its own ingress config mapping
94
- # hostname -> the gateway and never reads ~/.cloudflared/config.yml), or a remotely managed tunnel
95
- # token in `tokenEnv` (its public hostname is routed to http://127.0.0.1:<gateway.port> in the
96
- # Cloudflare dashboard).
97
- # cloudflare.access: whether a Cloudflare Access application guards `hostname` (informational; false
98
- # prints a warning). Recommended for anything beyond yes/no decisions.
99
- # telegram.enabled / chatId: the owner's chat with the bot (BotFather token in botTokenEnv). Send the
100
- # bot /start, then `starci connect telegram discover-chat` prints the chat id.
101
- # telegram.exposeCredentialAsks: false keeps a credential/secret ask off the public link — the message
102
- # says to answer it on this machine and carries only the localhost link, and the gateway refuses it.
103
- connectors:
104
- repos: []
105
- gateway: {port: 7070}
106
- cloudflare: {mode: off, tunnel: null, credentialsFile: null, tokenEnv: CLOUDFLARE_TUNNEL_TOKEN, hostname: null, access: false}
107
- telegram:
108
- enabled: false
109
- botTokenEnv: TELEGRAM_BOT_TOKEN
110
- chatId: null
111
- exposeCredentialAsks: false
112
- # asks — owner asks that carry a recommended option (question.recommended, or exactly one option
113
- # marked "(recommended)" or its Vietnamese equivalents). autoAcceptRecommended: true answers such an
114
- # ask with its recommendation instead of serving the form: the ledger records ask-answered with
115
- # answeredBy auto-recommended, the kernel is woken, and Telegram gets one plain message naming the
116
- # pick. A later owner answer supersedes it. excludes lists the ask classes that always reach the owner:
117
- # credential — any ask with secret fields, or of kind credential, account, access or consent;
118
- # handover — every handover.review ask (always excluded, even when removed from this list);
119
- # draw-review — the opt-out for drawings (interface.draw, scripts/work/draw-review.mjs): unlisted, a
120
- # drawing the owner did not ask to review is accepted without the owner (its accept option is the
121
- # recommendation); a drawing the owner asked for (a prior owner redraw of the record, the owner
122
- # opened its form, or question.ownerRequested) always reaches the owner;
123
- # or any ask kind: information, authority, business-decision, irreversible-confirmation, ...
124
- asks:
125
- autoAcceptRecommended: false
126
- excludes: [credential, irreversible-confirmation, handover]
127
- # uat — the machine-wide UAT ceiling. At most maxConcurrent UAT runs (a browser session, a player, the
128
- # app it drives) execute at once on this host, across every workflow; the rest wait queued for a slot
129
- # (scripts/uat/uat-slots.mjs, lock files under <runtime>/uat-slots). A slot whose holder died is
130
- # reclaimed. STARCI_UAT_MAX_CONCURRENT overrides it for one process tree.
131
- uat:
132
- maxConcurrent: 10
133
- # orca — the owner's Orca app settings the runtime must know (engine/orca-config.mjs orcaSettings). maxWorkerDepth MUST equal
134
- # the worker depth set in the Orca app: the deepest worker Orca starts under the owner's chat (chat 0, Kernel or
135
- # Supervisor 1, op or [Worker] 2, draw critic 3). Orca exposes no read of it, so the runtime trusts this value and refuses
136
- # a deeper launch before worker-start (worker-depth-exceeded). `start --check` with STARCI_ORCA_LIVE=1 measures Orca's
137
- # real limit and turns red when the two differ.
138
- orca:
139
- maxWorkerDepth: 4
140
- # debugLoop — the debug watcher. Workflow DEBUG is a /loop of the chat that started the workflow (the /starci skill sets it up in
141
- # Claude Code and Codex; no seat, no background agent, nothing in the runtime schedules it). Each tick runs the read-only
142
- # `starci debug digest`. interval is the loop cadence (<n>s | <n>m | <n>h, default `10m` = `debugLoop.interval`); worktreeLimit is the
143
- # per-repository core-watch alert threshold (default `40` = `debugLoop.worktreeLimit`). Both keys are optional (engine/config.mjs DEBUG_LOOP_DEFAULTS).
144
- debugLoop:
145
- interval: 10m
146
- worktreeLimit: 40
147
- # reconciler — the host's one reconciler engine (scripts/reconciler/engine.mjs; contract
148
- # modules/reconciler/reconciler.yaml). Each controller runs off | shadow (reads, records what it would do as
149
- # reconciler.would rows, runs nothing) | active (acts; the old loop yields that duty via scripts/reconciler/owns.mjs).
150
- # profile — the operational default of every controller, so a host is never left all-shadow by accident:
151
- # operational job, host, workflow, resource active (they settle jobs, start services and seats, wake stalled
152
- # workflows, throttle); gc, workers, learning shadow. The `start` skill applies and checks it.
153
- # observe every controller shadow (read-only; a debugging or audit host).
154
- # (absent) only the explicit controllers.<name>.mode entries count; an unnamed controller is off.
155
- # controllers.<name>.mode overrides the profile for that one controller (e.g. gc: {mode: active}).
156
- # Rollback of a controller: set its mode to off (the old loops take the duty back within
157
- # allocation.reconciler.heartbeatStaleMs). Numbers: modules/models/runtimes.yaml allocation.reconciler.
158
- reconciler:
159
- enabled: true
160
- profile: operational
161
- controllers: {}
162
- # specs.unit / specs.e2e in workflows (the `specs` map near the top; owner 2026-09-28 "speed up development;
163
- # test later when asked"; scripts/route/spec-deferral.mjs). Each op brief's policy.specsToggle says what it does:
164
- # unit: false - backend.implement, interface.implement and code.refactor run no jest/vitest/test:ci/coverage
165
- # and demand no changed-line coverage (Sonar still runs: bugs, smells, security gate);
166
- # test.author legs are never dispatched; review/handover gates do not count unit tests or coverage.
167
- # e2e: false - e2e.verify legs and e2e test authoring are never dispatched; uat.verify is not e2e.
168
- # A leg that is not dispatched settles `deferred: specs.<class>=false` with no attempt spent and the workflow
169
- # proceeds past it; starci kernel status lists testsDeferred and `starci kernel run-deferred-tests --workflow <id> [--kind unit|e2e]`
170
- # runs them later. Read on every wake: flipping a switch needs no restart.
171
- # roots — where this host keeps the archive, the lane worktrees and its temporary files, when the owner moves them off the defaults.
172
- # All keys are optional absolute directories; env STARCI_ARCHIVE_ROOT / STARCI_LANES_ROOT / STARCI_TEMP_ROOT win over them, and an
173
- # absent key means <starciLocalRoot>/archive (<runtime root>/.runtime/archive), the per-user profile lanes directory, kept out of the checkout (scripts/machine/home.mjs lanesRoot),
174
- # and the OS temp directory (engine/temp-root.mjs tempRoot; the processes the runtime starts get it as TEMP/TMP/TMPDIR). No host location lives in
175
- # a tracked file: set the real directories only in the gitignored config.yaml copy, e.g.
176
- # roots: {archive: <absolute directory>, lanes: <absolute directory>, temp: <absolute directory>}
177
- # sonar — the SonarCloud organization the release's Sonar proof of the example apps analyses in (scripts/supervisor/release-sonarcloud.mjs). It is configuration, not a secret,
178
- # so it lives here and not in secret.env; the project keys are <organization>_starci-example-<app>. The environment variable SONAR_ORGANIZATION wins over it (CI reads the
179
- # repository variable of the same name). Empty until the owner sets it in the gitignored config.yaml copy, e.g.
180
- # sonar: {organization: <the organization key shown on sonarcloud.io>}
181
- sonar: {organization: null}
182
- # resources — the host capacity floors the dispatch gate enforces, over the shipped numbers of modules/models/runtimes.yaml allocation.resources
183
- # (scripts/machine/host-resources.mjs; docs/config-format.md "Host resource floors"). Every key is optional (a number above 0, or null):
184
- # minFreeDiskGb free GB a drive holding the temp root or the repository must keep
185
- # minFreeDiskPct the same floor as a percentage of the drive's size; with minFreeDiskGb the larger requirement applies
186
- # minFreeRamPct free-RAM percentage below which no new heavy op starts
187
- # set them only in the gitignored config.yaml copy, e.g.
188
- # resources: {minFreeDiskGb: 5, minFreeDiskPct: 1, minFreeRamPct: 10}
189
- # release - where the full suite of a release is judged (scripts/guards/release-suite-mode.mjs; docs/releasing.md "Where the suite runs"). One key:
190
- # suite: local the shipped default: `starci release cut` also runs the L4 rows on this host (root rows, example apps, Sonar proofs, Linux parity container) before it tags; it never gates a push
191
- # suite: ci the owner's recorded choice (2026-10-09, widened 2026-10-26 by push-main-after-scoped-check): EVERY row is judged by the GitHub workflows (ci, examples, sonar) on each push to main;
192
- # the cut runs none and lists each row as delegated, never green. A red CI opens the next alpha.N.M and never blocks the next push (starci release ci-status).
193
- # "none" is refused: the suite does not vanish, it moves to CI. Set it only in the gitignored config.yaml copy: release: {suite: ci}
194
- release: {suite: local}
@@ -1,12 +0,0 @@
1
- // by-code-unit.mjs -the comparator of a bare `Array.prototype.sort()`, owned beside the engine files that digest and canonicalize (scripts/lib/list.mjs re-exports it).
2
- /**
3
- * The comparator of a bare `Array.prototype.sort()`: values compared as strings by UTF-16 code unit. Pass it to `sort` and
4
- * `toSorted` so the order is stated, and stays byte-identical to the default order that digests and canonical output depend on.
5
- */
6
- export const byCodeUnit = (a, b) => {
7
- const left = String(a);
8
- const right = String(b);
9
- if (left < right)
10
- return -1;
11
- return left > right ? 1 : 0;
12
- };