@starci/hfs 4.0.8 → 4.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (703) hide show
  1. package/CHANGELOG.md +9 -0
  2. package/LICENSE +21 -0
  3. package/README.md +81 -39
  4. package/emit/contracts.mjs +56 -9
  5. package/emit/db-types.mjs +169 -0
  6. package/emit/events.mjs +41 -0
  7. package/emit/operations-worker.mjs +1 -1
  8. package/emit/operations.mjs +2 -2
  9. package/emit/schema-worker.mjs +1 -1
  10. package/lint/bound-sys.cjs +50 -0
  11. package/lint/run.mjs +131 -24
  12. package/package.json +16 -10
  13. package/report/sonar.mjs +8 -8
  14. package/runtime/engine/admission.mjs +308 -0
  15. package/runtime/engine/canonical-json.mjs +10 -0
  16. package/runtime/engine/config.mjs +486 -0
  17. package/runtime/engine/db/blob.mjs +315 -0
  18. package/runtime/engine/db/ledger-paths.mjs +83 -0
  19. package/runtime/engine/db/ledger.mjs +1118 -0
  20. package/runtime/engine/db/machine-connection.mjs +135 -0
  21. package/runtime/engine/db/machine-schema.mjs +84 -0
  22. package/runtime/engine/db/machine.mjs +1367 -0
  23. package/runtime/engine/db/migrations/machine/0001-init.sql +924 -0
  24. package/runtime/engine/db/migrations/runtime/0001-init.sql +1108 -0
  25. package/runtime/engine/db/provider-reservations.mjs +101 -0
  26. package/runtime/engine/digest.mjs +16 -0
  27. package/runtime/engine/invalid-config.mjs +15 -0
  28. package/runtime/engine/orca-config.mjs +27 -0
  29. package/runtime/engine/refuse.mjs +11 -0
  30. package/runtime/engine/secrets.mjs +130 -0
  31. package/runtime/knowledge/hfs/canon-pins.yaml +162 -31
  32. package/runtime/knowledge/hfs/peer-integrations.yaml +2 -2
  33. package/runtime/knowledge/hfs/rules.yaml +2059 -0
  34. package/runtime/knowledge/hfs/slots.yaml +912 -120
  35. package/runtime/knowledge/patterns/be/api.yaml +369 -0
  36. package/runtime/knowledge/patterns/be/cli.yaml +297 -0
  37. package/runtime/knowledge/patterns/be/domain.yaml +113 -0
  38. package/runtime/knowledge/patterns/be/event-bus.yaml +285 -0
  39. package/runtime/knowledge/patterns/be/jobs.yaml +261 -0
  40. package/runtime/knowledge/patterns/be/projections.yaml +178 -0
  41. package/runtime/knowledge/patterns/be/queues.yaml +236 -0
  42. package/runtime/knowledge/patterns/be/reactors.yaml +140 -0
  43. package/runtime/knowledge/patterns/be/realtime.yaml +222 -0
  44. package/runtime/knowledge/patterns/be/saga.yaml +248 -0
  45. package/runtime/knowledge/patterns/be/webhooks.yaml +221 -0
  46. package/runtime/knowledge/patterns/fe/folder.yaml +131 -25
  47. package/runtime/knowledge/sonar-gate.yaml +52 -18
  48. package/runtime/modules/kernel/failure-codes.yaml +611 -51
  49. package/runtime/modules/models/registry.yaml +553 -0
  50. package/runtime/modules/models/runtimes.yaml +695 -0
  51. package/runtime/modules/ops/_labels.yaml +53 -0
  52. package/runtime/scripts/api/fs/forbidden-root.mjs +51 -0
  53. package/runtime/scripts/api/fs/is-link-like.mjs +25 -0
  54. package/runtime/scripts/api/fs/lib.mjs +16 -2
  55. package/runtime/scripts/api/fs/safe-remove.mjs +12 -132
  56. package/runtime/scripts/api/git/config-get.mjs +10 -0
  57. package/runtime/scripts/api/git/diff.mjs +5 -0
  58. package/runtime/scripts/api/git/lib.mjs +18 -26
  59. package/runtime/scripts/api/git/log.mjs +5 -0
  60. package/runtime/scripts/api/git/ls-files.mjs +6 -0
  61. package/runtime/scripts/api/git/ls-tree.mjs +5 -0
  62. package/runtime/scripts/api/git/merge-base.mjs +9 -0
  63. package/runtime/scripts/api/git/remote.mjs +5 -0
  64. package/runtime/scripts/api/git/rev-parse-query.mjs +5 -0
  65. package/runtime/scripts/api/git/show.mjs +6 -0
  66. package/runtime/scripts/api/node/lib.mjs +14 -0
  67. package/runtime/scripts/api/node/spawn-node.mjs +6 -0
  68. package/runtime/scripts/api/process/lib.mjs +111 -0
  69. package/runtime/scripts/api/process/owned-process.mjs +78 -0
  70. package/runtime/scripts/api/process/resolve-real-tool.mjs +46 -0
  71. package/runtime/scripts/api/process/run-program.mjs +7 -0
  72. package/runtime/scripts/api/process/stop-owned-process.mjs +9 -0
  73. package/runtime/scripts/api/sops/decrypt.mjs +9 -12
  74. package/runtime/scripts/api/sops/lib.mjs +255 -0
  75. package/runtime/scripts/api/sops/seal.mjs +22 -0
  76. package/runtime/scripts/connectors/lib.mjs +488 -0
  77. package/runtime/scripts/hfs/architecture/ast-walks.mjs +220 -0
  78. package/runtime/scripts/hfs/architecture/backend.mjs +16 -23
  79. package/runtime/scripts/hfs/architecture/background-unowned.mjs +16 -34
  80. package/runtime/scripts/hfs/architecture/client-reaches-server.mjs +3 -1
  81. package/runtime/scripts/hfs/architecture/clones.mjs +4 -4
  82. package/runtime/scripts/hfs/architecture/config.mjs +9 -6
  83. package/runtime/scripts/hfs/architecture/connection-map.mjs +20 -8
  84. package/runtime/scripts/hfs/architecture/context-coupling.mjs +88 -0
  85. package/runtime/scripts/hfs/architecture/context-map.mjs +237 -0
  86. package/runtime/scripts/hfs/architecture/context-owner.mjs +82 -0
  87. package/runtime/scripts/hfs/architecture/context-platform-tables.mjs +47 -0
  88. package/runtime/scripts/hfs/architecture/context-transaction.mjs +60 -0
  89. package/runtime/scripts/hfs/architecture/contract-fixture-guard.mjs +4 -10
  90. package/runtime/scripts/hfs/architecture/contracts.mjs +33 -162
  91. package/runtime/scripts/hfs/architecture/dead-exports.mjs +58 -29
  92. package/runtime/scripts/hfs/architecture/doc-language.mjs +1 -1
  93. package/runtime/scripts/hfs/architecture/entrypoint.mjs +2 -1
  94. package/runtime/scripts/hfs/architecture/fe-slot-allows.mjs +2 -2
  95. package/runtime/scripts/hfs/architecture/feature-shape.mjs +5 -2
  96. package/runtime/scripts/hfs/architecture/framework-pinned.mjs +1 -1
  97. package/runtime/scripts/hfs/architecture/frontend.mjs +17 -43
  98. package/runtime/scripts/hfs/architecture/hfs.mjs +24 -39
  99. package/runtime/scripts/hfs/architecture/i18n-keys.mjs +1 -1
  100. package/runtime/scripts/hfs/architecture/index.mjs +17 -4
  101. package/runtime/scripts/hfs/architecture/machine-ast.mjs +44 -11
  102. package/runtime/scripts/hfs/architecture/managed-scripts.mjs +27 -0
  103. package/runtime/scripts/hfs/architecture/module-per-transport.mjs +30 -6
  104. package/runtime/scripts/hfs/architecture/next-data.mjs +22 -63
  105. package/runtime/scripts/hfs/architecture/owners.mjs +35 -15
  106. package/runtime/scripts/hfs/architecture/register-once.mjs +2 -1
  107. package/runtime/scripts/hfs/architecture/registration.mjs +23 -81
  108. package/runtime/scripts/hfs/architecture/required-files.mjs +20 -12
  109. package/runtime/scripts/hfs/architecture/schema-owner.mjs +17 -114
  110. package/runtime/scripts/hfs/architecture/server-action.mjs +24 -0
  111. package/runtime/scripts/hfs/architecture/side-boundary.mjs +16 -0
  112. package/runtime/scripts/hfs/architecture/source-names.mjs +27 -147
  113. package/runtime/scripts/hfs/architecture/sql-owner.mjs +59 -18
  114. package/runtime/scripts/hfs/architecture/sql-returning.mjs +64 -0
  115. package/runtime/scripts/hfs/architecture/supabase-ast.mjs +111 -0
  116. package/runtime/scripts/hfs/architecture/supabase-be.mjs +131 -0
  117. package/runtime/scripts/hfs/architecture/supabase-tables.mjs +42 -0
  118. package/runtime/scripts/hfs/architecture/supabase.mjs +434 -0
  119. package/runtime/scripts/hfs/architecture/surface.mjs +9 -3
  120. package/runtime/scripts/hfs/architecture/test-world-files.mjs +9 -19
  121. package/runtime/scripts/hfs/architecture/tiers.mjs +47 -5
  122. package/runtime/scripts/hfs/architecture/transport-owner.mjs +3 -3
  123. package/runtime/scripts/hfs/architecture/typescript.mjs +12 -26
  124. package/runtime/scripts/hfs/architecture.mjs +4 -4
  125. package/runtime/scripts/hfs/check.mjs +75 -72
  126. package/runtime/scripts/hfs/coverage-scope.mjs +162 -0
  127. package/runtime/scripts/hfs/declaration-shape.mjs +62 -0
  128. package/runtime/scripts/hfs/declaration-slots.mjs +75 -0
  129. package/runtime/scripts/hfs/edition-slots.mjs +66 -0
  130. package/runtime/scripts/hfs/manifest-shape.mjs +109 -32
  131. package/runtime/scripts/hfs/param-names.mjs +18 -0
  132. package/runtime/scripts/hfs/path-findings.mjs +1 -1
  133. package/runtime/scripts/hfs/repo-identity.mjs +9 -6
  134. package/runtime/scripts/hfs/rule-params-shape.mjs +50 -0
  135. package/runtime/scripts/hfs/rules/app-root.mjs +51 -0
  136. package/runtime/scripts/hfs/rules/cli.mjs +37 -0
  137. package/runtime/scripts/hfs/rules/contract-compat.mjs +71 -0
  138. package/runtime/scripts/hfs/rules/contract.mjs +10 -9
  139. package/runtime/scripts/hfs/rules/database-config.mjs +102 -0
  140. package/runtime/scripts/hfs/rules/database-constants.mjs +13 -0
  141. package/runtime/scripts/hfs/rules/database-migrations.mjs +111 -0
  142. package/runtime/scripts/hfs/rules/database-plpgsql.mjs +233 -0
  143. package/runtime/scripts/hfs/rules/database-sql.mjs +336 -0
  144. package/runtime/scripts/hfs/rules/database.mjs +68 -0
  145. package/runtime/scripts/hfs/rules/deps.mjs +1 -1
  146. package/runtime/scripts/hfs/rules/docker.mjs +259 -0
  147. package/runtime/scripts/hfs/rules/edition.mjs +111 -0
  148. package/runtime/scripts/hfs/rules/event-bus.mjs +153 -0
  149. package/runtime/scripts/hfs/rules/fe-contract-documents.mjs +1 -1
  150. package/runtime/scripts/hfs/rules/fe-no-tests.mjs +6 -5
  151. package/runtime/scripts/hfs/rules/frontend-tree.mjs +9 -9
  152. package/runtime/scripts/hfs/rules/integration-specs.mjs +3 -6
  153. package/runtime/scripts/hfs/rules/kinds.mjs +84 -0
  154. package/runtime/scripts/hfs/rules/lint-suppression.mjs +1 -1
  155. package/runtime/scripts/hfs/rules/monorepo.mjs +179 -0
  156. package/runtime/scripts/hfs/rules/peer-integrations.mjs +3 -3
  157. package/runtime/scripts/hfs/rules/pipeline.mjs +11 -21
  158. package/runtime/scripts/hfs/rules/proof-commands.mjs +2 -2
  159. package/runtime/scripts/hfs/rules/read.mjs +1 -1
  160. package/runtime/scripts/hfs/rules/repo-local-checks.mjs +2 -2
  161. package/runtime/scripts/hfs/rules/saga.mjs +170 -0
  162. package/runtime/scripts/hfs/rules/secrets.mjs +3 -3
  163. package/runtime/scripts/hfs/rules/services.mjs +220 -0
  164. package/runtime/scripts/hfs/rules/spec-placement.mjs +1 -1
  165. package/runtime/scripts/hfs/rules/stacks.mjs +3 -3
  166. package/runtime/scripts/hfs/rules/supabase-secrets.mjs +89 -0
  167. package/runtime/scripts/hfs/rules/test-topology.mjs +2 -2
  168. package/runtime/scripts/hfs/secret.mjs +209 -0
  169. package/runtime/scripts/hfs/slots.mjs +78 -108
  170. package/runtime/scripts/hfs/sql/pg-parse.mjs +46 -0
  171. package/runtime/scripts/hfs/test-world-slot.mjs +6 -0
  172. package/runtime/scripts/hfs/tree.mjs +5 -4
  173. package/runtime/scripts/hfs/typescript-programs.mjs +0 -5
  174. package/runtime/scripts/hfs/view.mjs +3 -2
  175. package/runtime/scripts/lib/clip.mjs +19 -0
  176. package/runtime/scripts/lib/display-names.mjs +259 -0
  177. package/runtime/scripts/lib/dockerfile.mjs +124 -0
  178. package/runtime/scripts/lib/env.mjs +10 -0
  179. package/runtime/scripts/lib/event-contract.mjs +103 -0
  180. package/runtime/scripts/lib/example-refs.mjs +158 -0
  181. package/runtime/scripts/lib/fs-kind.mjs +14 -4
  182. package/runtime/scripts/lib/git.mjs +36 -0
  183. package/runtime/scripts/lib/graphql-contract.mjs +1 -1
  184. package/runtime/scripts/lib/i18n.mjs +86 -0
  185. package/runtime/scripts/lib/json-schema.mjs +52 -0
  186. package/runtime/scripts/lib/json.mjs +13 -3
  187. package/runtime/scripts/lib/language.mjs +24 -5
  188. package/runtime/scripts/lib/list.mjs +20 -0
  189. package/runtime/scripts/lib/mutation-fence.mjs +15 -0
  190. package/runtime/scripts/lib/package-at.mjs +37 -0
  191. package/runtime/scripts/lib/path-key.mjs +57 -2
  192. package/runtime/scripts/lib/process-identity.mjs +6 -0
  193. package/runtime/scripts/lib/read-text.mjs +34 -0
  194. package/runtime/scripts/lib/read-yaml.mjs +18 -0
  195. package/runtime/scripts/lib/redact.mjs +161 -0
  196. package/runtime/scripts/lib/regex.mjs +4 -0
  197. package/runtime/scripts/lib/same-text.mjs +5 -0
  198. package/runtime/scripts/lib/secret-patterns.mjs +4 -3
  199. package/runtime/scripts/lib/sleep-sync.mjs +2 -1
  200. package/runtime/scripts/lib/sleep.mjs +7 -0
  201. package/runtime/scripts/lib/sops-envelope.mjs +112 -0
  202. package/runtime/scripts/lib/source-phrases.mjs +34 -0
  203. package/runtime/scripts/lib/sqlite.mjs +21 -0
  204. package/runtime/scripts/lib/stack-services.mjs +7 -31
  205. package/runtime/scripts/lib/ts-ast.mjs +35 -0
  206. package/runtime/scripts/lib/walk.mjs +4 -3
  207. package/scaffold/add-app.mjs +174 -0
  208. package/scaffold/add-cli-lite.mjs +257 -0
  209. package/scaffold/add-inbox-lite.mjs +314 -0
  210. package/scaffold/add-table.mjs +344 -0
  211. package/scaffold/add.mjs +299 -0
  212. package/scaffold/app.mjs +358 -69
  213. package/scaffold/edition-gate.mjs +25 -0
  214. package/scaffold/image.mjs +19 -0
  215. package/scaffold/lite-exports.mjs +186 -0
  216. package/scaffold/service.mjs +32 -26
  217. package/scaffold/supabase-ports.mjs +26 -0
  218. package/src/main.mjs +327 -0
  219. package/sync/cli.mjs +6 -9
  220. package/sync/format.mjs +1 -1
  221. package/sync/hygiene.mjs +10 -10
  222. package/sync/index.mjs +167 -104
  223. package/sync/managed.mjs +19 -11
  224. package/sync/sonar-key.mjs +5 -0
  225. package/templates/app/ci-workflows/github/workflows/ci.yml +14 -14
  226. package/templates/app/ci-workflows/github/workflows/images.yml +37 -0
  227. package/templates/app/ci-workflows/sonar-steps.yml +9 -0
  228. package/templates/app/ci-workflows-lite/github/workflows/ci.yml +66 -0
  229. package/templates/app/ci-workflows-lite/github/workflows/db-deploy.yml +31 -0
  230. package/templates/app/ci-workflows-lite/github/workflows/images.yml +37 -0
  231. package/templates/app/codegen-lite/scripts/codegen.mjs +32 -0
  232. package/templates/app/docker-ignore/dockerignore +50 -0
  233. package/templates/app/gitignore-lite +35 -0
  234. package/templates/app/hooks/husky/pre-commit +3 -8
  235. package/templates/app/hooks/husky/pre-push +45 -6
  236. package/templates/app/package-scripts/core.json +8 -0
  237. package/templates/app/package-scripts/package.json +3 -10
  238. package/templates/app/package-scripts-lite/package.json +15 -0
  239. package/templates/app/quality-config/codecov.yml +15 -3
  240. package/templates/app/quality-config/sonar-base.properties +4 -0
  241. package/templates/app/quality-config/sonar-project.properties +1 -4
  242. package/templates/app/quality-config-lite/sonar-project.properties +5 -0
  243. package/templates/app/skeleton/.starcistacks/dev/seeds/primary-notes.sql +5 -0
  244. package/templates/app/skeleton/.starciwork/features/system-health/index.yaml +4 -0
  245. package/templates/app/skeleton/.starciwork/{features/index.yaml → index.yaml} +2 -2
  246. package/templates/app/skeleton/README.md +7 -5
  247. package/templates/app/skeleton-lite/.sops.yaml +3 -0
  248. package/templates/app/skeleton-lite/.starcistacks/dev/environment.json +5 -0
  249. package/templates/app/skeleton-lite/.starcistacks/dev/secrets/.gitkeep +1 -0
  250. package/templates/app/skeleton-lite/.starciwork/shell/index.yaml +55 -0
  251. package/templates/app/skeleton-lite/README.md +40 -0
  252. package/templates/app/skeleton-lite/supabase/config.toml +41 -0
  253. package/templates/app/skeleton-lite/supabase/migrations/__timestamp___baseline.sql +56 -0
  254. package/templates/app/skeleton-lite/supabase/seed.sql +0 -0
  255. package/templates/app/task-graph/turbo.json +23 -0
  256. package/templates/app/tool-config-lite/prettierignore +2 -0
  257. package/templates/app/tool-config-lite/prettierrc +1 -0
  258. package/templates/app/upgrade-full/.starcistacks/application-stacks.yaml +38 -0
  259. package/templates/app/upgrade-full/.starcistacks/dev/README.md +10 -0
  260. package/templates/app/upgrade-full/.starcistacks/dev/infra/compose/api.yaml +13 -0
  261. package/templates/app/upgrade-full/.starcistacks/dev/infra/compose/compose.yaml +3 -0
  262. package/templates/app/upgrade-full/.starcistacks/dev/infra/compose/postgres.yaml +12 -0
  263. package/templates/app/upgrade-full/.starcistacks/dev/infra/metadata.json +7 -0
  264. package/templates/be/common/main-listen.ts.partial +14 -0
  265. package/templates/be/common/sql-ident.ts.partial +7 -0
  266. package/templates/be/common/sql-tag.ts.partial +5 -0
  267. package/templates/be/image/api/Dockerfile +38 -0
  268. package/templates/be/image/cli/Dockerfile +38 -0
  269. package/templates/be/image/worker/Dockerfile +36 -0
  270. package/templates/be/inbox/database-client.ts.tpl +50 -0
  271. package/templates/be/inbox/index.ts.tpl +2 -0
  272. package/templates/be/inbox/migration.sql.tpl +29 -0
  273. package/templates/be/inbox/module-definition.ts.tpl +6 -0
  274. package/templates/be/inbox/module.ts.tpl +14 -0
  275. package/templates/be/inbox/options.ts.tpl +2 -0
  276. package/templates/be/inbox/service.ts.tpl +33 -0
  277. package/templates/be/inbox/sql.ts.tpl +16 -0
  278. package/templates/be/inbox/webhook-door.ts.tpl +36 -0
  279. package/templates/be/patterns/api/application.command.http.ts.tpl +10 -0
  280. package/templates/be/patterns/api/application.command.ts.tpl +10 -0
  281. package/templates/be/patterns/api/application.contracts.ts.tpl +11 -0
  282. package/templates/be/patterns/api/application.handler.http.ts.tpl +22 -0
  283. package/templates/be/patterns/api/application.handler.ts.tpl +22 -0
  284. package/templates/be/patterns/api/feature.index.http.ts.tpl +1 -0
  285. package/templates/be/patterns/api/feature.index.ts.tpl +1 -0
  286. package/templates/be/patterns/api/feature.module.ts.tpl +6 -0
  287. package/templates/be/patterns/api/graphql.input.ts.tpl +13 -0
  288. package/templates/be/patterns/api/graphql.mapper.ts.tpl +9 -0
  289. package/templates/be/patterns/api/graphql.module.ts.tpl +7 -0
  290. package/templates/be/patterns/api/graphql.resolver.ts.tpl +27 -0
  291. package/templates/be/patterns/api/graphql.type.ts.tpl +9 -0
  292. package/templates/be/patterns/api/http.controller.ts.tpl +27 -0
  293. package/templates/be/patterns/api/http.mapper.ts.tpl +9 -0
  294. package/templates/be/patterns/api/http.module.ts.tpl +7 -0
  295. package/templates/be/patterns/api/http.request.ts.tpl +10 -0
  296. package/templates/be/patterns/api/http.response.ts.tpl +5 -0
  297. package/templates/be/patterns/cli/group.cli.spec.ts.tpl +15 -0
  298. package/templates/be/patterns/cli/group.cli.ts.tpl +11 -0
  299. package/templates/be/patterns/cli/group.module.ts.tpl +7 -0
  300. package/templates/be/patterns/cli/sub.run.cli.spec.ts.tpl +17 -0
  301. package/templates/be/patterns/cli/sub.run.cli.ts.tpl +15 -0
  302. package/templates/be/patterns/event-bus/platform/errors/event-bus.error.ts.tpl +22 -0
  303. package/templates/be/patterns/event-bus/platform/event-bus.config.ts.tpl +19 -0
  304. package/templates/be/patterns/event-bus/platform/event-bus.contracts.ts.tpl +58 -0
  305. package/templates/be/patterns/event-bus/platform/event-bus.decorators.ts.tpl +46 -0
  306. package/templates/be/patterns/event-bus/platform/event-bus.log-events.ts.tpl +12 -0
  307. package/templates/be/patterns/event-bus/platform/event-bus.module-definition.ts.tpl +10 -0
  308. package/templates/be/patterns/event-bus/platform/event-bus.module.ts.tpl +52 -0
  309. package/templates/be/patterns/event-bus/platform/event-bus.options.ts.tpl +19 -0
  310. package/templates/be/patterns/event-bus/platform/event-bus.port.ts.tpl +28 -0
  311. package/templates/be/patterns/event-bus/platform/event-bus.service.spec.ts.tpl +165 -0
  312. package/templates/be/patterns/event-bus/platform/event-bus.service.ts.tpl +93 -0
  313. package/templates/be/patterns/event-bus/platform/event-envelope.policy.spec.ts.tpl +90 -0
  314. package/templates/be/patterns/event-bus/platform/event-envelope.policy.ts.tpl +58 -0
  315. package/templates/be/patterns/event-bus/platform/event-relay.service.spec.ts.tpl +136 -0
  316. package/templates/be/patterns/event-bus/platform/event-relay.service.ts.tpl +56 -0
  317. package/templates/be/patterns/event-bus/platform/event-runner.service.spec.ts.tpl +272 -0
  318. package/templates/be/patterns/event-bus/platform/event-runner.service.ts.tpl +128 -0
  319. package/templates/be/patterns/event-bus/platform/event-transport.port.ts.tpl +180 -0
  320. package/templates/be/patterns/event-bus/platform/event.policy.spec.ts.tpl +67 -0
  321. package/templates/be/patterns/event-bus/platform/event.policy.ts.tpl +38 -0
  322. package/templates/be/patterns/event-bus/platform/index.ts.tpl +11 -0
  323. package/templates/be/patterns/event-bus/platform/kafka-event-transport.client.spec.ts.tpl +348 -0
  324. package/templates/be/patterns/event-bus/platform/kafka-event-transport.client.ts.tpl +241 -0
  325. package/templates/be/patterns/event-bus/platform/messages/event-bus.messages.ts.tpl +15 -0
  326. package/templates/be/patterns/event-bus/platform/persistence/connection.ts.tpl +8 -0
  327. package/templates/be/patterns/event-bus/platform/persistence/entities/event-outbox.entity.ts.tpl +37 -0
  328. package/templates/be/patterns/event-bus/platform/persistence/event-bus.rows.ts.tpl +11 -0
  329. package/templates/be/patterns/event-bus/platform/persistence/event-bus.sql.ts.tpl +12 -0
  330. package/templates/be/patterns/event-bus/platform/persistence/migrations/1789800009000-create-event-outbox.ts.tpl +26 -0
  331. package/templates/be/patterns/jobs/job.index.ts.tpl +1 -0
  332. package/templates/be/patterns/jobs/job.module.ts.tpl +6 -0
  333. package/templates/be/patterns/jobs/job.processor.ts.tpl +20 -0
  334. package/templates/be/patterns/jobs/job.queue.module.ts.tpl +20 -0
  335. package/templates/be/patterns/jobs/job.step.ts.tpl +19 -0
  336. package/templates/be/patterns/jobs/platform/fenced.processor.spec.ts.tpl +31 -0
  337. package/templates/be/patterns/jobs/platform/fenced.processor.ts.tpl +13 -0
  338. package/templates/be/patterns/jobs/platform/job-claim.service.spec.ts.tpl +150 -0
  339. package/templates/be/patterns/jobs/platform/job-claim.service.ts.tpl +100 -0
  340. package/templates/be/patterns/jobs/platform/job-runner.service.spec.ts.tpl +138 -0
  341. package/templates/be/patterns/jobs/platform/job-runner.service.ts.tpl +69 -0
  342. package/templates/be/patterns/jobs/platform/jobs.config.ts.tpl +11 -0
  343. package/templates/be/patterns/jobs/platform/jobs.contracts.ts.tpl +62 -0
  344. package/templates/be/patterns/jobs/platform/jobs.decorators.ts.tpl +31 -0
  345. package/templates/be/patterns/jobs/platform/jobs.error.ts.tpl +22 -0
  346. package/templates/be/patterns/jobs/platform/jobs.index.ts.tpl +11 -0
  347. package/templates/be/patterns/jobs/platform/jobs.log-events.ts.tpl +9 -0
  348. package/templates/be/patterns/jobs/platform/jobs.messages.ts.tpl +15 -0
  349. package/templates/be/patterns/jobs/platform/jobs.module-definition.ts.tpl +10 -0
  350. package/templates/be/patterns/jobs/platform/jobs.module.ts.tpl +32 -0
  351. package/templates/be/patterns/jobs/platform/jobs.options.ts.tpl +11 -0
  352. package/templates/be/patterns/jobs/platform/jobs.port.ts.tpl +36 -0
  353. package/templates/be/patterns/jobs/platform/persistence.connection.ts.tpl +8 -0
  354. package/templates/be/patterns/jobs/platform/persistence.job.entity.ts.tpl +53 -0
  355. package/templates/be/patterns/jobs/platform/persistence.jobs.rows.ts.tpl +13 -0
  356. package/templates/be/patterns/jobs/platform/persistence.jobs.sql.ts.tpl +33 -0
  357. package/templates/be/patterns/jobs/platform/persistence.migration.ts.tpl +29 -0
  358. package/templates/be/patterns/outbox/platform/index.ts.tpl +2 -0
  359. package/templates/be/patterns/outbox/platform/outbox-relay.policy.spec.ts.tpl +96 -0
  360. package/templates/be/patterns/outbox/platform/outbox-relay.policy.ts.tpl +78 -0
  361. package/templates/be/patterns/outbox/platform/outbox.log-events.ts.tpl +5 -0
  362. package/templates/be/patterns/projections/migration.ts.tpl +18 -0
  363. package/templates/be/patterns/projections/persistence.connection.ts.tpl +8 -0
  364. package/templates/be/patterns/projections/projection.entity.ts.tpl +9 -0
  365. package/templates/be/patterns/projections/projection.index.ts.tpl +3 -0
  366. package/templates/be/patterns/projections/projection.module-definition.ts.tpl +7 -0
  367. package/templates/be/patterns/projections/projection.module.ts.tpl +18 -0
  368. package/templates/be/patterns/projections/projection.options.ts.tpl +2 -0
  369. package/templates/be/patterns/projections/projection.projection.spec.ts.tpl +55 -0
  370. package/templates/be/patterns/projections/projection.projection.ts.tpl +21 -0
  371. package/templates/be/patterns/queues/platform/bullmq-queue-transport.client.spec.ts.tpl +142 -0
  372. package/templates/be/patterns/queues/platform/bullmq-queue-transport.client.ts.tpl +81 -0
  373. package/templates/be/patterns/queues/platform/persistence.connection.ts.tpl +8 -0
  374. package/templates/be/patterns/queues/platform/persistence.migration.ts.tpl +25 -0
  375. package/templates/be/patterns/queues/platform/persistence.queue-outbox.entity.ts.tpl +25 -0
  376. package/templates/be/patterns/queues/platform/persistence.queue.rows.ts.tpl +9 -0
  377. package/templates/be/patterns/queues/platform/persistence.queue.sql.ts.tpl +12 -0
  378. package/templates/be/patterns/queues/platform/queue-outbox.service.spec.ts.tpl +48 -0
  379. package/templates/be/patterns/queues/platform/queue-outbox.service.ts.tpl +17 -0
  380. package/templates/be/patterns/queues/platform/queue-relay.service.spec.ts.tpl +128 -0
  381. package/templates/be/patterns/queues/platform/queue-relay.service.ts.tpl +48 -0
  382. package/templates/be/patterns/queues/platform/queue-transport.port.ts.tpl +115 -0
  383. package/templates/be/patterns/queues/platform/queue-worker.service.spec.ts.tpl +91 -0
  384. package/templates/be/patterns/queues/platform/queue-worker.service.ts.tpl +45 -0
  385. package/templates/be/patterns/queues/platform/queue.config.ts.tpl +15 -0
  386. package/templates/be/patterns/queues/platform/queue.contracts.ts.tpl +31 -0
  387. package/templates/be/patterns/queues/platform/queue.decorators.ts.tpl +45 -0
  388. package/templates/be/patterns/queues/platform/queue.index.ts.tpl +7 -0
  389. package/templates/be/patterns/queues/platform/queue.log-events.ts.tpl +5 -0
  390. package/templates/be/patterns/queues/platform/queue.module-definition.ts.tpl +10 -0
  391. package/templates/be/patterns/queues/platform/queue.module.ts.tpl +62 -0
  392. package/templates/be/patterns/queues/platform/queue.options.ts.tpl +22 -0
  393. package/templates/be/patterns/queues/platform/queue.policy.spec.ts.tpl +19 -0
  394. package/templates/be/patterns/queues/platform/queue.policy.ts.tpl +11 -0
  395. package/templates/be/patterns/queues/platform/queue.port.ts.tpl +14 -0
  396. package/templates/be/patterns/queues/queue.index.ts.tpl +3 -0
  397. package/templates/be/patterns/queues/queue.module.ts.tpl +6 -0
  398. package/templates/be/patterns/queues/queue.queue.ts.tpl +23 -0
  399. package/templates/be/patterns/reactors/application.command.ts.tpl +10 -0
  400. package/templates/be/patterns/reactors/application.contracts.ts.tpl +12 -0
  401. package/templates/be/patterns/reactors/application.handler.ts.tpl +22 -0
  402. package/templates/be/patterns/reactors/consumer.ts.tpl +19 -0
  403. package/templates/be/patterns/reactors/message.module.ts.tpl +20 -0
  404. package/templates/be/patterns/reactors/reactor.index.ts.tpl +1 -0
  405. package/templates/be/patterns/reactors/reactor.module.ts.tpl +6 -0
  406. package/templates/be/patterns/realtime/channel.graphql.module.ts.tpl +6 -0
  407. package/templates/be/patterns/realtime/channel.index.ts.tpl +1 -0
  408. package/templates/be/patterns/realtime/channel.input.ts.tpl +12 -0
  409. package/templates/be/patterns/realtime/channel.subscription.spec.ts.tpl +51 -0
  410. package/templates/be/patterns/realtime/channel.subscription.ts.tpl +32 -0
  411. package/templates/be/patterns/realtime/channel.type.ts.tpl +9 -0
  412. package/templates/be/patterns/saga/saga.compensate.command.ts.tpl +11 -0
  413. package/templates/be/patterns/saga/saga.compensate.contracts.ts.tpl +7 -0
  414. package/templates/be/patterns/saga/saga.compensate.handler.ts.tpl +22 -0
  415. package/templates/be/patterns/saga/saga.compensation.ts.tpl +21 -0
  416. package/templates/be/patterns/saga/saga.complete.command.ts.tpl +11 -0
  417. package/templates/be/patterns/saga/saga.complete.contracts.ts.tpl +7 -0
  418. package/templates/be/patterns/saga/saga.complete.handler.ts.tpl +22 -0
  419. package/templates/be/patterns/saga/saga.done.consumer.ts.tpl +21 -0
  420. package/templates/be/patterns/saga/saga.failed.consumer.ts.tpl +21 -0
  421. package/templates/be/patterns/saga/saga.index.ts.tpl +1 -0
  422. package/templates/be/patterns/saga/saga.message.module.ts.tpl +23 -0
  423. package/templates/be/patterns/saga/saga.module.ts.tpl +20 -0
  424. package/templates/be/patterns/saga/saga.service.spec.ts.tpl +70 -0
  425. package/templates/be/patterns/saga/saga.service.ts.tpl +44 -0
  426. package/templates/be/patterns/saga/saga.state.ts.tpl +14 -0
  427. package/templates/be/patterns/saga/saga.step.ts.tpl +11 -0
  428. package/templates/be/patterns/saga/saga.undo.command.ts.tpl +10 -0
  429. package/templates/be/patterns/saga/saga.undo.contracts.ts.tpl +5 -0
  430. package/templates/be/patterns/saga/saga.undo.handler.ts.tpl +21 -0
  431. package/templates/be/patterns/webhooks/webhook.door.spec.ts.tpl +72 -0
  432. package/templates/be/patterns/webhooks/webhook.door.ts.tpl +36 -0
  433. package/templates/be/patterns/webhooks/webhook.http.module.ts.tpl +6 -0
  434. package/templates/be/patterns/webhooks/webhook.index.ts.tpl +1 -0
  435. package/templates/be/patterns/webhooks/webhook.request.ts.tpl +9 -0
  436. package/templates/be/skeleton/apps/__app__/src/__app__.options.ts +3 -0
  437. package/templates/be/skeleton/apps/__app__/src/app.module.ts +15 -2
  438. package/templates/be/skeleton/apps/__app__/src/main.ts +7 -15
  439. package/templates/be/skeleton/apps/cli/src/app.module.ts +30 -0
  440. package/templates/be/skeleton/apps/cli/src/cli.options.ts +22 -0
  441. package/templates/be/skeleton/apps/cli/src/main.ts +24 -0
  442. package/templates/be/skeleton/src/features/cli/cli.module.ts +7 -0
  443. package/templates/be/skeleton/src/features/cli/index.ts +1 -0
  444. package/templates/be/skeleton/src/features/cli/migrate/migrate.cli.spec.ts +17 -0
  445. package/templates/be/skeleton/src/features/cli/migrate/migrate.cli.ts +15 -0
  446. package/templates/be/skeleton/src/features/cli/migrate/migrate.module.ts +7 -0
  447. package/templates/be/skeleton/src/features/cli/migrate/subs/run.cli.spec.ts +17 -0
  448. package/templates/be/skeleton/src/features/cli/migrate/subs/run.cli.ts +18 -0
  449. package/templates/be/skeleton/src/features/cli/seed/seed.cli.spec.ts +17 -0
  450. package/templates/be/skeleton/src/features/cli/seed/seed.cli.ts +15 -0
  451. package/templates/be/skeleton/src/features/cli/seed/seed.module.ts +7 -0
  452. package/templates/be/skeleton/src/features/cli/seed/subs/run.cli.spec.ts +33 -0
  453. package/templates/be/skeleton/src/features/cli/seed/subs/run.cli.ts +34 -0
  454. package/templates/be/skeleton/src/modules/domain/identity/admission.policy.spec.ts +13 -0
  455. package/templates/be/skeleton/src/modules/domain/identity/auth.guard.spec.ts +40 -0
  456. package/templates/be/skeleton/src/modules/domain/identity/messages/identity.messages.ts +1 -1
  457. package/templates/be/skeleton/src/modules/domain/note/errors/note.error.ts +16 -0
  458. package/templates/be/skeleton/src/modules/domain/note/index.ts +3 -0
  459. package/templates/be/skeleton/src/modules/domain/note/note.contracts.ts +19 -0
  460. package/templates/be/skeleton/src/modules/domain/note/note.decorators.ts +9 -0
  461. package/templates/be/skeleton/src/modules/domain/note/note.module-definition.ts +7 -0
  462. package/templates/be/skeleton/src/modules/domain/note/note.module.ts +19 -0
  463. package/templates/be/skeleton/src/modules/domain/note/note.options.ts +2 -0
  464. package/templates/be/skeleton/src/modules/domain/note/note.service.spec.ts +76 -0
  465. package/templates/be/skeleton/src/modules/domain/note/note.service.ts +37 -0
  466. package/templates/be/skeleton/src/modules/domain/note/persistence/connection.ts +8 -0
  467. package/templates/be/skeleton/src/modules/domain/note/persistence/entities/note.entity.ts +17 -0
  468. package/templates/be/skeleton/src/modules/domain/note/persistence/migrations/1790000000000-init-note.ts +22 -0
  469. package/templates/be/skeleton/src/modules/domain/note/persistence/note.rows.ts +17 -0
  470. package/templates/be/skeleton/src/modules/domain/note/persistence/note.sql.ts +4 -0
  471. package/templates/be/skeleton/src/modules/platform/config/env-source.config.ts +20 -0
  472. package/templates/be/skeleton/src/modules/platform/config/index.ts +1 -1
  473. package/templates/be/skeleton/src/modules/platform/cqrs/cqrs.contracts.ts +18 -0
  474. package/templates/be/skeleton/src/modules/platform/database/connection-source.client.spec.ts +41 -0
  475. package/templates/be/skeleton/src/modules/platform/database/connection-source.client.ts +17 -0
  476. package/templates/be/skeleton/src/modules/platform/database/database.module-definition.ts +13 -0
  477. package/templates/be/skeleton/src/modules/platform/database/database.module.ts +77 -0
  478. package/templates/be/skeleton/src/modules/platform/database/database.options.ts +30 -0
  479. package/templates/be/skeleton/src/modules/platform/database/database.port.ts +65 -0
  480. package/templates/be/skeleton/src/modules/platform/database/database.sql.ts +47 -0
  481. package/templates/be/skeleton/src/modules/platform/database/errors/database.error.ts +16 -0
  482. package/templates/be/skeleton/src/modules/platform/database/index.ts +9 -0
  483. package/templates/be/skeleton/src/modules/platform/database/migrate-connections.client.ts +30 -0
  484. package/templates/be/skeleton/src/modules/platform/database/migration-runner.service.spec.ts +84 -0
  485. package/templates/be/skeleton/src/modules/platform/database/migration-runner.service.ts +23 -0
  486. package/templates/be/skeleton/src/modules/platform/database/primary.config.ts +9 -0
  487. package/templates/be/skeleton/src/modules/platform/database/primary.connection.ts +2 -0
  488. package/templates/be/skeleton/src/modules/platform/database/primary.decorators.ts +10 -0
  489. package/templates/be/skeleton/src/modules/platform/database/seed-connections.client.spec.ts +108 -0
  490. package/templates/be/skeleton/src/modules/platform/database/seed-connections.client.ts +75 -0
  491. package/templates/be/skeleton/src/modules/platform/database/seed-runner.service.spec.ts +88 -0
  492. package/templates/be/skeleton/src/modules/platform/database/seed-runner.service.ts +29 -0
  493. package/templates/be/skeleton/src/modules/platform/errors/errors.filter.spec.ts +48 -0
  494. package/templates/be/skeleton/src/modules/platform/errors/messages/errors.messages.ts +1 -1
  495. package/templates/be/skeleton/src/modules/platform/http-security/errors/http-security.error.ts +12 -0
  496. package/templates/be/skeleton/src/modules/platform/http-security/execution-request.mapper.spec.ts +16 -0
  497. package/templates/be/skeleton/src/modules/platform/http-security/http-security.config.ts +8 -1
  498. package/templates/be/skeleton/src/modules/platform/http-security/http-security.decorators.ts +8 -0
  499. package/templates/be/skeleton/src/modules/platform/http-security/http-security.module.ts +14 -1
  500. package/templates/be/skeleton/src/modules/platform/http-security/http-security.options.ts +12 -0
  501. package/templates/be/skeleton/src/modules/platform/http-security/messages/http-security.messages.ts +10 -2
  502. package/templates/be/skeleton/src/modules/platform/http-security/origin.guard.spec.ts +63 -0
  503. package/templates/be/skeleton/src/modules/platform/http-security/rate-limit.guard.spec.ts +108 -0
  504. package/templates/be/skeleton/src/modules/platform/http-security/request-validation.service.spec.ts +39 -0
  505. package/templates/be/skeleton/src/modules/platform/http-security/request-validation.service.ts +25 -0
  506. package/templates/be/skeleton/src/modules/platform/http-security/webhook-signature.service.spec.ts +172 -0
  507. package/templates/be/skeleton/src/modules/platform/http-security/webhook-signature.service.ts +66 -0
  508. package/templates/be/skeleton/src/modules/platform/logging/logging.log-events.ts +3 -1
  509. package/templates/be/skeleton/src/modules/platform/primitives/outcome.mapper.spec.ts +52 -0
  510. package/templates/be/skeleton-lite/apps/api/Dockerfile +37 -0
  511. package/templates/be/skeleton-lite/apps/api/src/api.options.ts +16 -0
  512. package/templates/be/skeleton-lite/apps/api/src/app.module.ts +81 -0
  513. package/templates/be/skeleton-lite/apps/api/src/main.ts +34 -0
  514. package/templates/be/skeleton-lite/src/modules/domain/identity/admission.policy.ts +14 -0
  515. package/templates/be/skeleton-lite/src/modules/domain/identity/auth.guard.ts +50 -0
  516. package/templates/be/skeleton-lite/src/modules/domain/identity/identity.contracts.ts +26 -0
  517. package/templates/be/skeleton-lite/src/modules/domain/identity/identity.decorators.ts +19 -0
  518. package/templates/be/skeleton-lite/src/modules/domain/identity/identity.module.ts +26 -0
  519. package/templates/be/skeleton-lite/src/modules/domain/identity/identity.options.ts +7 -0
  520. package/templates/be/skeleton-lite/src/modules/domain/identity/index.ts +6 -0
  521. package/templates/be/skeleton-lite/src/modules/integrations/supabase/errors/supabase.error.ts +19 -0
  522. package/templates/be/skeleton-lite/src/modules/integrations/supabase/index.ts +10 -0
  523. package/templates/be/skeleton-lite/src/modules/integrations/supabase/supabase.client.ts +24 -0
  524. package/templates/be/skeleton-lite/src/modules/integrations/supabase/supabase.config.ts +8 -0
  525. package/templates/be/skeleton-lite/src/modules/integrations/supabase/supabase.decorators.ts +17 -0
  526. package/templates/be/skeleton-lite/src/modules/integrations/supabase/supabase.jwks.ts +32 -0
  527. package/templates/be/skeleton-lite/src/modules/integrations/supabase/supabase.options.ts +24 -0
  528. package/templates/be/skeleton-lite/src/modules/platform/cqrs/index.ts +4 -0
  529. package/templates/be/skeleton-lite/src/modules/platform/database/database.module.ts +54 -0
  530. package/templates/be/skeleton-lite/src/modules/platform/database/database.options.ts +23 -0
  531. package/templates/be/skeleton-lite/src/modules/platform/database/database.port.ts +10 -0
  532. package/templates/be/skeleton-lite/src/modules/platform/database/database.sql.ts +49 -0
  533. package/templates/be/skeleton-lite/src/modules/platform/database/index.ts +4 -0
  534. package/templates/be/skeleton-lite/src/modules/platform/database/migration-runner.service.ts +21 -0
  535. package/templates/be/skeleton-lite/src/modules/platform/database/primary.config.ts +11 -0
  536. package/templates/be/skeleton-lite/src/modules/platform/database/seed-runner.service.ts +28 -0
  537. package/templates/be/skeleton-lite/src/modules/platform/http-security/http-security.module.ts +25 -0
  538. package/templates/be/skeleton-lite/src/modules/platform/http-security/index.ts +9 -0
  539. package/templates/be/skeleton-lite/src/modules/platform/i18n/index.ts +4 -0
  540. package/templates/be/skeleton-lite/src/modules/platform/logging/index.ts +5 -0
  541. package/templates/be/table/error.ts.tpl +16 -0
  542. package/templates/be/table/index.ts.tpl +2 -0
  543. package/templates/be/table/migration.sql.tpl +51 -0
  544. package/templates/be/table/module-definition.ts.tpl +7 -0
  545. package/templates/be/table/module.ts.tpl +14 -0
  546. package/templates/be/table/options.ts.tpl +2 -0
  547. package/templates/be/table/rows.ts.tpl +4 -0
  548. package/templates/be/table/service.ts.tpl +23 -0
  549. package/templates/be/table/sql.ts.tpl +4 -0
  550. package/templates/be/tool-config/jest.config.js +3 -1
  551. package/templates/be/upgrade-full/apps/cli/src/app.module.ts +14 -0
  552. package/templates/be/upgrade-full/apps/cli/src/main.ts +26 -0
  553. package/templates/be/upgrade-full/src/features/cli/cli.module.ts +6 -0
  554. package/templates/be/upgrade-full/src/features/cli/migrate/subs/run.cli.ts +23 -0
  555. package/templates/common/gitignore.base +1 -2
  556. package/templates/fe/app/package.json.tpl +1 -0
  557. package/templates/fe/app/tsconfig.json +12 -0
  558. package/templates/fe/common/app-layout.tsx.partial +8 -0
  559. package/templates/fe/common/site-shell.tsx.partial +9 -0
  560. package/templates/fe/image/next/Dockerfile +42 -0
  561. package/templates/fe/skeleton/apps/app/next.config.ts +23 -0
  562. package/templates/fe/skeleton/apps/app/postcss.config.mjs +7 -0
  563. package/templates/fe/skeleton/apps/{__app__ → app}/src/app/[locale]/error.tsx +2 -2
  564. package/templates/fe/skeleton/apps/app/src/app/[locale]/layout.tsx +22 -0
  565. package/templates/fe/skeleton/apps/{__app__ → app}/src/app/[locale]/loading.tsx +2 -2
  566. package/templates/fe/skeleton/apps/{__app__ → app}/src/app/[locale]/not-found.tsx +2 -2
  567. package/templates/fe/skeleton/apps/app/src/app/[locale]/page.tsx +9 -0
  568. package/templates/fe/skeleton/apps/{__app__ → app}/src/app/global-error.tsx +2 -2
  569. package/templates/fe/skeleton/apps/app/src/app/globals.css +10 -0
  570. package/templates/fe/skeleton/apps/app/src/features/layouts/AppLayout/index.tsx +18 -0
  571. package/templates/fe/skeleton/apps/app/src/features/pages/AppErrorPage/component.tsx +19 -0
  572. package/templates/fe/skeleton/apps/app/src/features/pages/AppErrorPage/index.tsx +11 -0
  573. package/templates/fe/skeleton/apps/app/src/features/pages/AppGlobalErrorPage/index.tsx +16 -0
  574. package/templates/fe/skeleton/apps/app/src/features/pages/AppHomePage/component.tsx +10 -0
  575. package/templates/fe/skeleton/apps/app/src/features/pages/AppHomePage/index.tsx +15 -0
  576. package/templates/fe/skeleton/apps/app/src/features/pages/AppLoadingPage/index.tsx +8 -0
  577. package/templates/fe/skeleton/apps/app/src/features/pages/AppNotFoundPage/index.tsx +9 -0
  578. package/templates/fe/skeleton/apps/app/src/modules/i18n/index.ts +4 -0
  579. package/templates/fe/skeleton/apps/app/src/modules/i18n/messages/vi.json +28 -0
  580. package/templates/fe/skeleton/apps/app/src/modules/i18n/request.ts +4 -0
  581. package/templates/fe/skeleton/apps/app/src/modules/routes/index.ts +4 -0
  582. package/templates/fe/skeleton/apps/app/src/proxy.ts +1 -0
  583. package/templates/fe/skeleton/apps/{__app__ → landing}/next.config.ts +4 -2
  584. package/templates/fe/skeleton/apps/landing/postcss.config.mjs +7 -0
  585. package/templates/fe/skeleton/apps/landing/src/app/[locale]/error.tsx +10 -0
  586. package/templates/fe/skeleton/apps/landing/src/app/[locale]/layout.tsx +22 -0
  587. package/templates/fe/skeleton/apps/landing/src/app/[locale]/loading.tsx +6 -0
  588. package/templates/fe/skeleton/apps/landing/src/app/[locale]/not-found.tsx +6 -0
  589. package/templates/fe/skeleton/apps/landing/src/app/[locale]/page.tsx +9 -0
  590. package/templates/fe/skeleton/apps/landing/src/app/global-error.tsx +10 -0
  591. package/templates/fe/skeleton/apps/landing/src/app/globals.css +10 -0
  592. package/templates/fe/skeleton/apps/landing/src/features/layouts/LandingLayout/index.tsx +24 -0
  593. package/templates/fe/skeleton/apps/landing/src/features/pages/LandingErrorPage/component.tsx +18 -0
  594. package/templates/fe/skeleton/apps/landing/src/features/pages/LandingErrorPage/index.tsx +11 -0
  595. package/templates/fe/skeleton/apps/landing/src/features/pages/LandingGlobalErrorPage/index.tsx +16 -0
  596. package/templates/fe/skeleton/apps/landing/src/features/pages/LandingLoadingPage/index.tsx +8 -0
  597. package/templates/fe/skeleton/apps/landing/src/features/pages/LandingNotFoundPage/index.tsx +9 -0
  598. package/templates/fe/skeleton/apps/landing/src/features/pages/LandingPage/component.tsx +24 -0
  599. package/templates/fe/skeleton/apps/landing/src/features/pages/LandingPage/index.tsx +16 -0
  600. package/templates/fe/skeleton/apps/landing/src/modules/config/index.ts +12 -0
  601. package/templates/fe/skeleton/apps/landing/src/modules/i18n/index.ts +7 -0
  602. package/templates/fe/skeleton/apps/landing/src/modules/i18n/messages/vi.json +31 -0
  603. package/templates/fe/skeleton/apps/landing/src/modules/i18n/request.ts +4 -0
  604. package/templates/fe/skeleton/apps/landing/src/modules/routes/index.ts +4 -0
  605. package/templates/fe/skeleton/apps/landing/src/proxy.ts +1 -0
  606. package/templates/fe/skeleton/packages/__project__-i18n/src/index.ts +49 -0
  607. package/templates/fe/skeleton/packages/__project__-i18n/src/proxy.ts +24 -0
  608. package/templates/fe/skeleton/packages/__project__-i18n/src/routing.ts +20 -0
  609. package/templates/fe/skeleton/packages/__project__-ui/src/branches/Providers/index.tsx +23 -0
  610. package/templates/fe/skeleton/packages/__project__-ui/src/composites/ErrorNotice/index.tsx +14 -0
  611. package/templates/fe/skeleton/packages/__project__-ui/src/composites/GlobalErrorNotice/index.tsx +25 -0
  612. package/templates/fe/skeleton/packages/__project__-ui/src/composites/LoadingNotice/index.tsx +9 -0
  613. package/templates/fe/skeleton/packages/__project__-ui/src/composites/LocaleShell/index.tsx +21 -0
  614. package/templates/fe/skeleton/packages/__project__-ui/src/composites/NotFoundNotice/index.tsx +19 -0
  615. package/templates/fe/skeleton/packages/__project__-ui/src/composites/SiteShell/classNames.ts +4 -0
  616. package/templates/fe/skeleton/packages/__project__-ui/src/composites/SiteShell/index.tsx +19 -0
  617. package/templates/fe/skeleton/packages/__project__-ui/src/index.ts +6 -0
  618. package/templates/fe/skeleton-lite/apps/web/next.config.ts +22 -0
  619. package/templates/fe/skeleton-lite/apps/web/src/app/[locale]/error.tsx +10 -0
  620. package/templates/fe/skeleton-lite/apps/web/src/app/[locale]/layout.tsx +37 -0
  621. package/templates/fe/skeleton-lite/apps/web/src/app/[locale]/loading.tsx +6 -0
  622. package/templates/fe/skeleton-lite/apps/web/src/app/[locale]/not-found.tsx +6 -0
  623. package/templates/fe/skeleton-lite/apps/web/src/app/[locale]/page.tsx +9 -0
  624. package/templates/fe/skeleton-lite/apps/web/src/app/[locale]/providers.tsx +26 -0
  625. package/templates/fe/skeleton-lite/apps/web/src/app/auth/callback/route.ts +24 -0
  626. package/templates/fe/skeleton-lite/apps/web/src/app/global-error.tsx +10 -0
  627. package/templates/fe/{skeleton/apps/__app__ → skeleton-lite/apps/web}/src/app/globals.css +1 -1
  628. package/templates/fe/skeleton-lite/apps/web/src/app/health/live/route.ts +5 -0
  629. package/templates/fe/skeleton-lite/apps/web/src/components/blocks/SignInForm/component.tsx +29 -0
  630. package/templates/fe/skeleton-lite/apps/web/src/components/blocks/SignInForm/index.tsx +41 -0
  631. package/templates/fe/skeleton-lite/apps/web/src/components/blocks/SignOutButton/component.tsx +17 -0
  632. package/templates/fe/skeleton-lite/apps/web/src/components/blocks/SignOutButton/index.tsx +38 -0
  633. package/templates/fe/skeleton-lite/apps/web/src/components/composites/ErrorNotice/index.tsx +13 -0
  634. package/templates/fe/skeleton-lite/apps/web/src/components/composites/GlobalErrorNotice/index.tsx +24 -0
  635. package/templates/fe/skeleton-lite/apps/web/src/components/composites/LoadingNotice/index.tsx +7 -0
  636. package/templates/fe/skeleton-lite/apps/web/src/components/composites/NotFoundNotice/index.tsx +18 -0
  637. package/templates/fe/skeleton-lite/apps/web/src/components/composites/SiteShell/classNames.ts +4 -0
  638. package/templates/fe/skeleton-lite/apps/web/src/components/composites/SiteShell/index.tsx +13 -0
  639. package/templates/fe/skeleton-lite/apps/web/src/features/layouts/AppLayout/index.tsx +31 -0
  640. package/templates/fe/skeleton-lite/apps/web/src/features/pages/AppErrorPage/component.tsx +12 -0
  641. package/templates/fe/skeleton-lite/apps/web/src/features/pages/AppErrorPage/index.tsx +10 -0
  642. package/templates/fe/skeleton-lite/apps/web/src/features/pages/AppGlobalErrorPage/index.tsx +15 -0
  643. package/templates/fe/skeleton-lite/apps/web/src/features/pages/AppHomePage/component.tsx +14 -0
  644. package/templates/fe/skeleton-lite/apps/web/src/features/pages/AppHomePage/index.tsx +30 -0
  645. package/templates/fe/skeleton-lite/apps/web/src/features/pages/AppLoadingPage/index.tsx +8 -0
  646. package/templates/fe/skeleton-lite/apps/web/src/features/pages/AppNotFoundPage/index.tsx +9 -0
  647. package/templates/fe/skeleton-lite/apps/web/src/modules/brand/brand.css +20 -0
  648. package/templates/fe/skeleton-lite/apps/web/src/modules/brand/index.ts +2 -0
  649. package/templates/fe/skeleton-lite/apps/web/src/modules/config/index.ts +20 -0
  650. package/templates/fe/skeleton-lite/apps/web/src/modules/db/auth/read-session.ts +25 -0
  651. package/templates/fe/skeleton-lite/apps/web/src/modules/db/auth/write-sign-in.ts +25 -0
  652. package/templates/fe/skeleton-lite/apps/web/src/modules/db/auth/write-sign-out.ts +17 -0
  653. package/templates/fe/skeleton-lite/apps/web/src/modules/db/browser.ts +14 -0
  654. package/templates/fe/skeleton-lite/apps/web/src/modules/db/index.ts +3 -0
  655. package/templates/fe/skeleton-lite/apps/web/src/modules/db/outcome.ts +59 -0
  656. package/templates/fe/skeleton-lite/apps/web/src/modules/db/principal.ts +29 -0
  657. package/templates/fe/skeleton-lite/apps/web/src/modules/db/server.ts +70 -0
  658. package/templates/fe/skeleton-lite/apps/web/src/modules/db/validation/validation.mapper.ts +50 -0
  659. package/templates/fe/skeleton-lite/apps/web/src/modules/i18n/index.ts +8 -0
  660. package/templates/fe/skeleton-lite/apps/web/src/modules/i18n/messages/vi.json +48 -0
  661. package/templates/fe/skeleton-lite/apps/web/src/modules/i18n/request.ts +16 -0
  662. package/templates/fe/skeleton-lite/apps/web/src/modules/i18n/routing.ts +14 -0
  663. package/templates/fe/skeleton-lite/apps/web/src/modules/routes/index.ts +7 -0
  664. package/templates/fe/skeleton-lite/apps/web/src/modules/routes/safe-next-path.ts +26 -0
  665. package/templates/fe/skeleton-lite/apps/web/src/proxy.ts +43 -0
  666. package/templates/fe/table/read.ts.tpl +16 -0
  667. package/templates/fe/table/write.ts.tpl +16 -0
  668. package/upgrade/check.mjs +137 -0
  669. package/upgrade/index.mjs +524 -0
  670. package/bin/hfs.mjs +0 -233
  671. package/runtime/scripts/api/fs/rmdir-link.mjs +0 -12
  672. package/runtime/scripts/lib/test-secrets.mjs +0 -116
  673. package/templates/fe/skeleton/apps/__app__/src/app/[locale]/layout.tsx +0 -20
  674. package/templates/fe/skeleton/apps/__app__/src/app/[locale]/page.tsx +0 -9
  675. package/templates/fe/skeleton/apps/__app__/src/components/composites/FailureScreen/index.tsx +0 -28
  676. package/templates/fe/skeleton/apps/__app__/src/features/layouts/LocaleShell/index.tsx +0 -35
  677. package/templates/fe/skeleton/apps/__app__/src/features/pages/ErrorPage/component.tsx +0 -19
  678. package/templates/fe/skeleton/apps/__app__/src/features/pages/ErrorPage/index.tsx +0 -11
  679. package/templates/fe/skeleton/apps/__app__/src/features/pages/GlobalErrorPage/component.tsx +0 -24
  680. package/templates/fe/skeleton/apps/__app__/src/features/pages/GlobalErrorPage/index.tsx +0 -14
  681. package/templates/fe/skeleton/apps/__app__/src/features/pages/HomePage/component.tsx +0 -21
  682. package/templates/fe/skeleton/apps/__app__/src/features/pages/HomePage/index.tsx +0 -15
  683. package/templates/fe/skeleton/apps/__app__/src/features/pages/LoadingPage/component.tsx +0 -23
  684. package/templates/fe/skeleton/apps/__app__/src/features/pages/LoadingPage/index.tsx +0 -8
  685. package/templates/fe/skeleton/apps/__app__/src/features/pages/NotFoundPage/component.tsx +0 -28
  686. package/templates/fe/skeleton/apps/__app__/src/features/pages/NotFoundPage/index.tsx +0 -8
  687. package/templates/fe/skeleton/apps/__app__/src/modules/i18n/config.ts +0 -8
  688. package/templates/fe/skeleton/apps/__app__/src/modules/i18n/index.ts +0 -2
  689. package/templates/fe/skeleton/apps/__app__/src/modules/i18n/messages/vi.json +0 -25
  690. package/templates/fe/skeleton/apps/__app__/src/modules/i18n/request.ts +0 -19
  691. package/templates/fe/skeleton/apps/__app__/src/modules/i18n/routing.ts +0 -9
  692. package/templates/fe/skeleton/apps/__app__/src/modules/routes/index.ts +0 -4
  693. package/templates/fe/skeleton/apps/__app__/src/proxy.ts +0 -10
  694. /package/templates/be/skeleton/src/features/{system-health → api/system-health}/application/check-liveness.contracts.ts +0 -0
  695. /package/templates/be/skeleton/src/features/{system-health → api/system-health}/application/check-liveness.handler.ts +0 -0
  696. /package/templates/be/skeleton/src/features/{system-health → api/system-health}/application/check-liveness.query.ts +0 -0
  697. /package/templates/be/skeleton/src/features/{system-health → api/system-health}/index.ts +0 -0
  698. /package/templates/be/skeleton/src/features/{system-health → api/system-health}/system-health.module.ts +0 -0
  699. /package/templates/be/skeleton/src/features/{system-health → api/system-health}/transport/http/live.controller.ts +0 -0
  700. /package/templates/be/skeleton/src/features/{system-health → api/system-health}/transport/http/system-health-http.module.ts +0 -0
  701. /package/templates/fe/skeleton/apps/{__app__ → app}/src/app/health/live/route.ts +0 -0
  702. /package/templates/fe/skeleton/apps/{__app__ → app}/src/modules/config/index.ts +0 -0
  703. /package/templates/fe/{skeleton/apps/__app__ → skeleton-lite/apps/web}/postcss.config.mjs +0 -0
@@ -0,0 +1,695 @@
1
+ schema: starci/runtimes@1
2
+ purpose: |-
3
+ Every runtime is a provider-window pool with real parallel slots and a cooldown: the pool boundary IS the
4
+ quota-window boundary, so one pool never spans two independently metered windows and one window never splits
5
+ into two pools. The workflow-bound profile applies adaptive capacity from config.yaml: role, tier, tools,
6
+ qualification, independent review, fresh provider quota, shared admitted load and recent observed service
7
+ filter and score provider families before one runtime is handed to the typed launcher. The preference/tier
8
+ lists below are within-family suitability and a compatibility policy for direct low-level consumers; they are
9
+ not a provider fallback chain in a workflow. A runtime that fails is classified and parked for the cooldown of
10
+ that failure kind, doubling per repeat. Auth health is provider-wide rather than pool-wide: a confirmed
11
+ launch, worker-start or attestation auth rejection parks every runtime sharing that provider credential. A
12
+ stale-token preflight may make one real refresh attempt; a typed no-effect rejection falls through on the
13
+ same logical operation attempt, while partial or unknown effects require reconciliation before fallback.
14
+
15
+ Models are pinned inside the pool per DIFFICULTY (`models`) and attested at launch - never inferred from the
16
+ pool name. The pools themselves — membership, `provider`, `roles`, `maxParallel`, per-difficulty `models`
17
+ and `effort` pins, `defaultModel` — live in modules/models/registry.yaml `pools`, the ONE model catalog;
18
+ this file keeps only the operational allocation policy and runtime tuning that is not model data.
19
+ # `maxParallelOps` is the worker-wide ceiling across every workflow; `budgets.maxOps` in the owner's
20
+ # config.yaml is the per-workflow one. The lower of the two admits: engine/admission.mjs
21
+ # opSlotCeiling takes min(budgets.maxOps, maxParallelOps) and scripts/kernel/cli.mjs refuses
22
+ # route/dispatch with `max-ops` at it.
23
+ maxParallelOps: 20
24
+ allocation:
25
+ # Common new-admission thresholds, consumed by the pure selector and runtime reservation adapter.
26
+ admission:
27
+ schema: starci/agent-admission-policy@1
28
+ version: 1
29
+ reservePercent: 90
30
+ exhaustedPercent: 100
31
+ maxAgeMs: 300000
32
+ qualityOrder: [economy, standard, frontier]
33
+ ownerBiasRoles: [op]
34
+ eligibilityModes: [qualified, probation, kernel-function, scoped-control-plane, operation-policy]
35
+ roles:
36
+ kernel: {qualityFloor: standard}
37
+ op:
38
+ qualityFloor: economy
39
+ difficultyFloors: {easy: economy, medium: economy, hard: frontier, insane: frontier}
40
+ supervisor: {qualityFloor: standard}
41
+ worker: {qualityFloor: standard}
42
+ critic: {qualityFloor: standard, independence: provider}
43
+ # The default policy. config.yaml allocation.policy overrides it for `starci kernel route` (engine/config.mjs
44
+ # configuredAllocationPolicy): prefer-then-overflow takes the first eligible pool of the tier order below;
45
+ # balanced walks the eligible pools of that order and takes the FIRST one still below its config.yaml
46
+ # allocation.shares target of the recent dispatches (scripts/agent/balance.mjs counts them; scripts/agent/
47
+ # models.mjs selectPool picks), so the evidence order ranks and the share caps; when every eligible pool
48
+ # is at or above its share, the one furthest below (least over) takes it and the order breaks ties. Under
49
+ # both, every gate (role, difficulty pin, owner grant, host tools, quota/auth, circuit, maxParallel)
50
+ # applies first.
51
+ policy: prefer-then-overflow
52
+ # Under balanced, a pool listed here for a work class and tier is taken only when no other pool of the
53
+ # order is eligible: Opus stays hands-on overflow below insane, so its share is spent on think work; at
54
+ # insane, where only Opus and Sol pin a model, the two balance.
55
+ balanced:
56
+ overflowOnly:
57
+ hands-on:
58
+ easy: [claude-agent]
59
+ medium: [claude-agent]
60
+ hard: [claude-agent]
61
+ # Owner decision 2026-09-25 (review-hands, amending routing-by-evidence): a pool an order lists here is taken
62
+ # only when no other pool of that order is eligible, under EITHER policy - neither the balanced share nor the
63
+ # owner's goal routing_bias prefer moves it ahead. Opus and Sol are the review order's overflow: they take a review only when
64
+ # Devin is unavailable (circuit open, quota dead, full, or excluded by the cross-family rule).
65
+ overflowByOrder:
66
+ review: [claude-agent, codex-agent]
67
+ # Cross-family audit: a verify kind whose records overlap the output of the latest settled non-verify op of
68
+ # the workflow (scripts/kernel/cli.mjs cmdRoute finds that author with scripts/agent/balance.mjs
69
+ # auditAuthorOf) routes to an eligible pool of another audit family - the reviewer's provider differs from
70
+ # the implementer's. The audit families are the pools of `frontier` and `hands`: Opus or Sol review what
71
+ # Devin implemented; Sol reviews Opus's records and Opus reviews Sol's. The author's
72
+ # own family is taken only when no pool of another family is eligible (crossFamily.applied false).
73
+ # thinkAuditCrossFamily keeps its name from when only think verdicts were audited.
74
+ thinkAuditCrossFamily: true
75
+ # The frontier think group: Claude Opus 5.5 and GPT-6.1 Sol. It is what the kernel's own model calls route
76
+ # over (scripts/route/route-model.mjs decisionFlow kernel-function) and two families of the cross-family
77
+ # audit above.
78
+ frontier: [claude-agent, codex-agent]
79
+ # The hands group: Devin (SWE-2 Max). It implements and, since the owner decision of 2026-09-25
80
+ # (review-hands), reviews - the third audit family.
81
+ hands: [devin-agent]
82
+ # Owner decision 2026-09-25 ("ok"): route by the 72h evidence of scripts/agent/model-scorecard.mjs (1389 op jobs over the product ledgers of that window).
83
+ # Those historical Sol scores describe the pre-migration model; they are not GPT-6.1 Sol qualification evidence.
84
+ # Each kind walks ONE order, named by its roleOfKind `order` (default: `think` for think work, else its role),
85
+ # at its difficulty tier:
86
+ # implement, write, verify (hands-on implementation: backend.implement, interface.implement, code.refactor,
87
+ # test.author, the hands-on verify kinds, release/scope finish): Devin first, then Codex and Claude -
88
+ # Devin passed 70% of backend.implement and 68% of interface.implement over the 72h scorecard.
89
+ # scaffold (scaffold, docs, content, grammar.update - small work - and every cut slice of a fan-out, which
90
+ # scripts/kernel/cli.mjs cmdRoute routes on this order): Devin first - backend.scaffold passed 73% on Devin,
91
+ # 43% on Codex over the 72h scorecard.
92
+ # think, decide, plan (every think kind: decide, review and author ops): Claude Opus first, GPT-6.1 Sol second
93
+ # and nothing else - Opus passed 72-73% of business/architecture.decide, Sol 60-64%. Think kinds route at a hard floor, where codex-agent pins Sol; the
94
+ # easy and medium keys (Claude only, never Luna) exist for direct role consumers that bring no kind.
95
+ # draw (interface.draw; owner ruling 2026-09-27 draw-devin-brand-claude, modules/kernel/owner-rulings.yaml):
96
+ # Devin draws first (SWE-2 Max; token-render HTML + Playwright in the product checkout - its card carries
97
+ # browser-dom), Codex (GPT-6.1 Sol at effort high) is the fallback. The raster regions a drawing needs are
98
+ # artworkSlots for interface.asset, never painted by the drawer. Devin pins no easy or insane model, so the easy
99
+ # and insane keys are Codex alone. The draw loop's independent critic stays a DIFFERENT model from the drawer
100
+ # (allocation.drawLoop.critic, criticWhenDrawer).
101
+ # asset (interface.asset): Codex only - the one agent with the image tool (image_gen.imagegen).
102
+ # brand (brand.decide; owner ruling 2026-09-27 draw-devin-brand-claude): Claude Opus decides the brand and its
103
+ # direction, GPT-6.1 Sol is the fallback when the Claude pool cannot serve; Codex is also the cross-family second
104
+ # opinion on think work.
105
+ # review (owner decision 2026-09-25 review-hands, amending the think order above: "codex/claude only
106
+ # decide (that is, set the strategy), review must be done by the hands"): every verify kind -
107
+ # review.verify, handover.review, security.verify, goal.validate, uat.assisted.verify, interface.audit and
108
+ # the hands-on e2e/integration/perf/uat verify kinds - and work.author walk the review order: Devin,
109
+ # then Opus and Sol as overflow only (overflowByOrder.review). The cross-family rule sends a review of
110
+ # what Devin implemented to Opus or Sol. An experiment, measured in
111
+ # benchmark/findings/2026-09-25-review-hands.md.
112
+ # Claude and Codex keep strategy: request.analyze, scope.define, business/architecture/goal decide and
113
+ # revise, decision.prepare and implementation.plan (the cut) stay on think/decide/plan (Opus, Sol); brand.decide
114
+ # walks its own brand order (Opus, then Sol).
115
+ # interface.audit needs the browser-dom host tool: Devin and Codex carry it, Claude does not, so the
116
+ # host-tool gate passes Claude over (Devin audited it at 11% pass, 83% fail over the 72h scorecard -
117
+ # the experiment re-measures it).
118
+ # Devin (SWE-2-max) pins no easy or insane model, so easy hands-on work starts at Codex (Luna) and insane
119
+ # hands-on work at the frontier pools; Opus stays hands-on overflow below insane.
120
+ # Owner routing 2026-09-26: Opus brainstorms and decides (think/decide/plan orders); Sol draws, audits the UI
121
+ # and verifies e2e/security/assisted UAT (order ui: Devin as fallback when the Codex quota circuit
122
+ # opens); Devin implements, run the kernel and do the mechanical ops (provision.ask, workspace.manage,
123
+ # task.execute, knowledge.repair walk implement); the kernel's own model calls walk sol-think (Sol, Opus overflow).
124
+ tiers:
125
+ hard:
126
+ default: [devin-agent, codex-agent, claude-agent]
127
+ implement: [devin-agent, codex-agent, claude-agent]
128
+ write: [devin-agent, codex-agent, claude-agent]
129
+ verify: [devin-agent, codex-agent, claude-agent]
130
+ scaffold: [devin-agent, codex-agent, claude-agent]
131
+ think: [claude-agent, codex-agent]
132
+ decide: [claude-agent, codex-agent]
133
+ plan: [claude-agent, codex-agent]
134
+ draw: [devin-agent, codex-agent]
135
+ asset: [codex-agent]
136
+ brand: [claude-agent, codex-agent]
137
+ review: [devin-agent, claude-agent, codex-agent]
138
+ ui: [codex-agent, devin-agent]
139
+ sol-think: [codex-agent, claude-agent]
140
+ medium:
141
+ default: [devin-agent, codex-agent, claude-agent]
142
+ implement: [devin-agent, codex-agent, claude-agent]
143
+ write: [devin-agent, codex-agent, claude-agent]
144
+ verify: [devin-agent, codex-agent, claude-agent]
145
+ scaffold: [devin-agent, codex-agent, claude-agent]
146
+ think: [claude-agent]
147
+ decide: [claude-agent]
148
+ plan: [claude-agent]
149
+ draw: [devin-agent, codex-agent]
150
+ asset: [codex-agent]
151
+ brand: [claude-agent, codex-agent]
152
+ review: [devin-agent, claude-agent, codex-agent]
153
+ ui: [codex-agent, devin-agent]
154
+ sol-think: [codex-agent, claude-agent]
155
+ easy:
156
+ default: [codex-agent, claude-agent]
157
+ implement: [codex-agent, claude-agent]
158
+ write: [codex-agent, claude-agent]
159
+ verify: [codex-agent, claude-agent]
160
+ scaffold: [codex-agent, claude-agent]
161
+ think: [claude-agent]
162
+ decide: [claude-agent]
163
+ plan: [claude-agent]
164
+ draw: [codex-agent]
165
+ asset: [codex-agent]
166
+ brand: [claude-agent, codex-agent]
167
+ review: [claude-agent, codex-agent]
168
+ ui: [codex-agent]
169
+ sol-think: [codex-agent, claude-agent]
170
+ # Insane tops the ladder: only pools that declare an insane model can serve it. Devin carries no insane
171
+ # pin and is ineligible here by the models gate, so it is absent rather than listed-and-rejected (an insane
172
+ # review is Opus's, with Sol as overflow).
173
+ insane:
174
+ default: [claude-agent, codex-agent]
175
+ implement: [claude-agent, codex-agent]
176
+ write: [claude-agent, codex-agent]
177
+ verify: [claude-agent, codex-agent]
178
+ scaffold: [claude-agent, codex-agent]
179
+ think: [claude-agent, codex-agent]
180
+ decide: [claude-agent, codex-agent]
181
+ plan: [claude-agent, codex-agent]
182
+ draw: [codex-agent]
183
+ asset: [codex-agent]
184
+ brand: [claude-agent, codex-agent]
185
+ review: [claude-agent, codex-agent]
186
+ ui: [codex-agent]
187
+ sol-think: [codex-agent, claude-agent]
188
+ # config.yaml allocation.preferredProvider is a bias within the tier's eligible pools and never moves think
189
+ # work to a pool outside `think` (scripts/route/route-model.mjs).
190
+ preference:
191
+ implement: [devin-agent, codex-agent, claude-agent]
192
+ verify: [devin-agent, codex-agent, claude-agent]
193
+ write: [devin-agent, codex-agent, claude-agent]
194
+ scaffold: [devin-agent, codex-agent, claude-agent]
195
+ think: [claude-agent, codex-agent]
196
+ decide: [claude-agent, codex-agent]
197
+ plan: [claude-agent, codex-agent]
198
+ draw: [devin-agent, codex-agent]
199
+ asset: [codex-agent]
200
+ brand: [claude-agent, codex-agent]
201
+ review: [devin-agent, claude-agent, codex-agent]
202
+ ui: [codex-agent, devin-agent]
203
+ sol-think: [codex-agent, claude-agent]
204
+ # Heavy work fans out: a big node is cut into children with disjoint write scopes, the seam every other child
205
+ # would touch is built first and alone, then the rest run at once - bounded here so one parent never takes
206
+ # every slot of the pool and leaves the rest of the tree waiting behind it.
207
+ fanOut: {seamFirst: true, maxPerGroup: 10}
208
+ # Deterministic same-op slicing — the kernel measures the write scope and calls `starci kernel estimate`;
209
+ # it never guesses an agent count. W = sum(weight * count) in agent-minutes places the closure in
210
+ # a `size` class, and the class plus the owner's `parallel.gear` (config.yaml) names how many
211
+ # agents the op asks for. `s` and `m` are always one agent; only `l` and `xl` fan out. The static
212
+ # bounds in kinds.yaml (12 files / 8 assertions / 3 components) are a coarse screen over the same
213
+ # measure — the estimate is the authority. When N > 1 slices are admitted together the kernel
214
+ # routes them one after the other with plain starci kernel route (a Kernel --prefer/--avoid is ignored, owner
215
+ # decision 2026-09-25) so the workers spread over the lanes instead of piling onto the first pool. A
216
+ # hands-on slice (payload.cut) walks the scaffold order, Devin first (owner decision 2026-09-25): each
217
+ # routed slice is already counted before the next one is routed, and a pool that reaches its share
218
+ # passes the next slice down the order.
219
+ # A gear never raises a pool's maxParallel, maxParallelOps or budgets.maxOps: it raises only what
220
+ # `starci kernel estimate` requests, and admission still clamps it.
221
+ slicing:
222
+ weights: {file: 4, assertion: 3, component: 12, record: 2}
223
+ targetMinutes: [15, 30]
224
+ maxSlices: 15
225
+ gears: [1, 2]
226
+ # Size classes over the same measure. A closure is `xl` when any of its counts reaches an `xl`
227
+ # bound, `l` when any reaches an `l` bound, `s` when W is inside targetMinutes[0], else `m`.
228
+ # `l.from.files: 12` is ledger-derived: of 52 settled implement/refactor/author jobs in the
229
+ # measured product ledger, closures at or above 12 authored files ran a median 46 min against 12 min below
230
+ # it, the first cutoff where the majority exceeds one targetMinutes[1] window
231
+ # (benchmark/findings/2026-09-23-parallel-gear.md). Every other `from` bound is the
232
+ # benchmark/findings/fable.md sketch value carried as an ASSUMPTION: that ledger holds exactly one job over three
233
+ # windows and no assertion or component measurement at all, so `xl.from` and both `assertions`
234
+ # bounds have no observation behind them and are re-derived when estimate inputs are recorded.
235
+ size:
236
+ l: {from: {files: 12, assertions: 40}, agents: {1: 3, 2: 5}}
237
+ xl: {from: {files: 40, assertions: 150}, agents: {1: 6, 2: 10}}
238
+ # The workers' operating windows, in milliseconds. engine/config.mjs allocationMs() is how code reads
239
+ # them and kernel contracts cite the key rather than restating the number, so each one is changed here
240
+ # and nowhere else.
241
+ dispatchLeaseTtlMs: 1800000
242
+ watchdogCadenceMs: 300000
243
+ observeCadenceMs: 180000
244
+ # activeStaleMs: an `active` screen (spinner/"Working" row) is trusted only while the terminal still
245
+ # prints; a spinner re-renders every second, so output older than this is a frozen frame. The watchdog
246
+ # then treats the Kernel as turn-idle (reason stale-active) and wakes it, and a worker reads turn-idle
247
+ # for the nudge frontier (scripts/lib/terminal-liveness.mjs staleAwareState).
248
+ # quietMs: a worker still at its idle prompt (or frozen) this long after a delivered nudge, with no
249
+ # output since, is quiet - dead to the frontier; the watchdog settles it failed-no-report and queues
250
+ # its retry (starci kernel reconcile --dead-worker --settle-failed). A provider card's liveness.activeStaleMs /
251
+ # liveness.quietMs overrides these per provider (modules/models/agents/<provider>.yaml).
252
+ # launchGraceMs: a managed worker-start returns before Orca injects the worker's Task, so for this
253
+ # long after its op-dispatched event a managed worker that still reads an idle prompt is `starting`
254
+ # - never nudge-ready, and starci kernel nudge skips it worker-starting.
255
+ # A command-terminal dispatch has already proven its prompt submitted and carries no grace; a
256
+ # staged paste is nudge-ready at any age, and a nudge since the dispatch ends the grace.
257
+ # kernelTurnBudgetMs / supervisorTurnBudgetMs: the longest ONE busy turn of a Kernel / the [Supervisor] seat (its
258
+ # spinner timer) before the reconciler's host controller sends the agent's own interrupt key and re-wakes it with
259
+ # the decision doorbell; still the same turn turnInterruptGraceMs later, the seat is replaced (KERNEL_TURN_OVERDUE,
260
+ # scripts/reconciler/controllers/host.mjs turnStep). A busy turn defers every doorbell and notice (kernel-busy).
261
+ liveness: {activeUnclassifiedMs: 120000, activeStaleMs: 600000, quietMs: 1200000, launchGraceMs: 90000,
262
+ kernelTurnBudgetMs: 1200000, supervisorTurnBudgetMs: 1800000, turnInterruptGraceMs: 300000}
263
+ # one local git read over a job's owned paths (scripts/kernel/owned-path-effects.mjs ownedPathEffects, job-artifacts.mjs).
264
+ settleGit: {commandMs: 15000}
265
+ # Typed logs (scripts/kernel/typed-logs.mjs, the ledger's logs table): perJobCap rows a job's own writes
266
+ # may store before one log.truncated row closes them (derived event rows are never capped); dataMaxBytes bounds
267
+ # one row's data after redaction. diff: the caps of a job patch's pre-structured <patch>.json
268
+ # (scripts/kernel/patch-json.mjs) - lines kept per file and in total, files, characters per line, and the size of
269
+ # an image literal decoded into <patch>.assets/.
270
+ logs:
271
+ perJobCap: 2000
272
+ dataMaxBytes: 4096
273
+ diff: {fileLines: 1500, totalLines: 20000, files: 400, lineChars: 2000, assetBytes: 5242880}
274
+ # Recovery windows. hostOutage (scripts/kernel/host-outage.mjs): how long a watchdog tick or a kernel
275
+ # start waits for an Orca that does not answer, and how long after a responding Orca calls a kernel dead
276
+ # it is asked again.
277
+ hostOutage: {waitMs: 90000, deathSettleMs: 10000}
278
+ # supervisorTick: the numbers of the retired supervisor tick (2026-09-28) that the reconciler controllers still read
279
+ # (host thresholds, orca probes, statusApp port, owner digest cadence); everyMs is unused. The tick ran every
280
+ # everyMs (whole minutes: schtasks repetition). host: above maxNode node.exe or maxGit git.exe processes the host
281
+ # controller logs the counts and the parents holding the most. orca: terminal-list is probed up to probes times, probeTimeoutMs each, gapMs apart; when every
282
+ # probe fails the Orca app (never its terminal daemon) gets closeWaitMs to close before it is forced, is launched
283
+ # again, and restart-all runs. deadKernelMs: a watchdog whose trailing ticks read tick-failed or restart-failed
284
+ # this long flags a dead kernel. orphanedFrontierMs: a workflow read orphaned-frontier on ticks this far apart is
285
+ # flagged. noProgressMs: a STALLED workflow idle this long is flagged. statusApp: the status
286
+ # UI's ports and scheduled task — port serves the built UI and its read-only API, devPort the Vite dev/preview
287
+ # server (ui/ports.mjs is the one reader; nothing else states either) — restarted when port does not answer
288
+ # within probeTimeoutMs. alertRepeatMs: one
289
+ # alert key reaches the inbox and Telegram at most once per window. actionSlaMs: an owed action (scripts/supervisor/
290
+ # actions.mjs) no supervisor action touched this long is an SLA breach, alerted into the Supervisor's inbox.
291
+ # ownerDigestMs: the Owner Notifier's periodic owner digest goes out at most this often.
292
+ supervisorTick:
293
+ everyMs: 1800000
294
+ host: {maxNode: 300, maxGit: 100}
295
+ orca: {probeTimeoutMs: 30000, probes: 5, gapMs: 30000, closeWaitMs: 20000}
296
+ deadKernelMs: 900000
297
+ orphanedFrontierMs: 1800000
298
+ noProgressMs: 21600000
299
+ statusApp: {port: 4547, devPort: 4545, task: 'StarCi Harness App', probeTimeoutMs: 5000}
300
+ alertRepeatMs: 21600000
301
+ actionSlaMs: 1800000
302
+ ownerDigestMs: 7200000
303
+ # supervisorLearning (scripts/machine/lessons.mjs, supervise.yaml selfLearning): a failure signature seen
304
+ # minRepeats times opens a hypothesis; a landed experiment is measured for measureMs (its signature recurring, a new
305
+ # signature naming a file it changed, or an op success rate lower by successDrop -> revert due); at most
306
+ # dailyAutoLandCap autonomous landings in 24 h; an owner-feedback lesson weighs ownerWeight (a self-derived one 1).
307
+ supervisorLearning: {minRepeats: 2, measureMs: 21600000, dailyAutoLandCap: 8, ownerWeight: 3, successDrop: 0.1}
308
+ # progress (scripts/kernel/progress-rca.mjs; owner 2026-09-28 "could the supervisor not think before?" and "why do
309
+ # workflows not coordinate themselves but wait for the supervisor"): the outcome SLA each Kernel reads first on every wake (starci kernel status
310
+ # progress + rca) and the Supervisor backstops. units/h over windowMs (only units that passed their gates), ETA over
311
+ # etaWindowMs. A priority workflow (highest ramThrottle.priorities weight) below minUnitsPerHour.priority for graceMs,
312
+ # or holding queued-ready work while running < its allowed parallelism, is a progress stall: the Kernel acts on the
313
+ # ranked rca.actions at once; a stall older than supervisorGraceMs is the Supervisor's (progress-stall). maxUnitsPerEdit
314
+ # bounds one light graph-edit; recutThreshold open cut-shaped failures (absent paths, grants too narrow) rank a heavy
315
+ # re-cut first. rca: failures of one op in one workflow >= minFailures inside windowMs open the RCA even without a stall.
316
+ # commandTimeoutMs: the window the tool-timeout action gives an op (op-override).
317
+ progress:
318
+ windowMs: 3600000
319
+ etaWindowMs: 21600000
320
+ graceMs: 1800000
321
+ supervisorGraceMs: 3600000
322
+ minUnitsPerHour: {priority: 3, default: 0}
323
+ maxUnitsPerEdit: 3
324
+ recutThreshold: 3
325
+ commandTimeoutMs: 600000
326
+ # settleBacklog: SETTLE-FIRST - starci kernel route/dispatch refuse settle-backlog while >= max filed reports older than ageMs
327
+ # wait unconsumed (a finished [Op] keeps its terminal and slot until its settle closes it).
328
+ # The runtime settles green reports itself (settler below); this refusal counts only the reports waiting on the Kernel
329
+ # (non-green outcomes and done reports the settler handed over as needs-kernel-decision), consumed or not.
330
+ settleBacklog: {max: 3, ageMs: 120000}
331
+ rca: {minFailures: 3, windowMs: 86400000, examples: 4}
332
+ # settler (scripts/kernel/settle/job-settle.mjs; owner ruling settle-runtime-service 2026-09-28): the runtime settles every
333
+ # filed done report whose declared checks re-verify green through the same `starci kernel record-checks` + `starci kernel settle` path, from each
334
+ # workflow watchdog loop every everyMs and right after `starci kernel report`. rerunTimeoutMs bounds one declared check re-run and
335
+ # itemBudgetMs one report. invariantMaxAgeMs: the Supervisor tick asserts no filed/consumed report of a live job stays
336
+ # unsettled and un-handed-over longer than this (settle-unsettled-report, a runtime bug). releaseWindowMs: settled jobs
337
+ # this recent whose worker close is unproven are closed and verified. tail: the async settle tail (artifact indexing,
338
+ # evidence copy, session retention, input baselines, rev drift) retries a failed run after retryMs, up to maxAttempts.
339
+ settler:
340
+ everyMs: 60000
341
+ rerunTimeoutMs: 300000
342
+ itemBudgetMs: 900000
343
+ invariantMaxAgeMs: 180000
344
+ releaseWindowMs: 86400000
345
+ tail: {retryMs: 120000, maxAttempts: 5}
346
+ # redesign (starci kernel redesign; owner 2026-09-28: heavy redesign is dispatched to the op that owns it, and the Kernel stays on
347
+ # Devin): these ops, enqueued from an RCA, route as `routeAs` (implementation.plan: the plan order - Opus, then Sol) at
348
+ # >= minDifficulty at `effort` whatever their usual order (work.author walks the review order, Devin first, otherwise).
349
+ redesign:
350
+ ops: [work.author, scope.define, goal.revise]
351
+ routeAs: implementation.plan
352
+ minDifficulty: hard
353
+ effort: high
354
+ # selfReload (scripts/machine/self-reload.mjs): a watchdog loop re-execs at most once per minIntervalMs; its
355
+ # replacement takes over the loop's lock within handoverMs or is stopped.
356
+ selfReload: {minIntervalMs: 300000, handoverMs: 30000}
357
+ # footprint (scripts/guards/footprint-scan.mjs): one host-wide scan at most every everyMs; a crashed
358
+ # tick's claim lock is cleared after lockStaleMs.
359
+ footprint: {everyMs: 600000, lockStaleMs: 60000}
360
+ # jobGuard (scripts/guards/hook-install.mjs): a guard file older than ttlMs is pruned.
361
+ jobGuard: {ttlMs: 604800000}
362
+ # landGate (scripts/supervisor/land.mjs): a land waits waitMs for its turn at the gate; its spec run may take
363
+ # specsBaseMs plus perSpecMs for every spec it runs, specConcurrency spec files at a time.
364
+ landGate: {waitMs: 1800000, specsBaseMs: 600000, perSpecMs: 60000, specConcurrency: 6}
365
+ # workerClose (scripts/machine/worker-close.mjs; owner rule: a finished worker is closed COMPLETELY): after worker-release and the terminal
366
+ # close the runtime waits verifyMs for every process of that terminal's shell tree to end (polled every pollMs); a survivor proven to belong
367
+ # to the tree is stopped and given stopVerifyMs to end before the finding is raised.
368
+ workerClose: {verifyMs: 10000, pollMs: 1000, stopVerifyMs: 5000}
369
+ # waiterPriority (scripts/kernel/waiter-priority.mjs): a queued job that has blocked another
370
+ # workflow this long earns its Kernel one heads-up per newly waiting workflow.
371
+ waiterPriority: {blockingHeadsUpMs: 900000}
372
+ # cutSeam (scripts/kernel/seam-policy.mjs; owner ruling 2026-09-28 "a seam must not block the whole chain"): a cut
373
+ # sibling ordinal waits on its seam at most maxSiblingWaitMs (30 min), then runs on a stub and owes one
374
+ # cut-seam-reconcile once the seam lands; a published seam interface, a seam whose latest attempt
375
+ # settled failed/blocked, or recutAfterFailures failed seam attempts release it at once (and owe a re-cut).
376
+ cutSeam: {maxSiblingWaitMs: 1800000, recutAfterFailures: 2}
377
+ # opTelemetry (scripts/machine/op-metrics.mjs): op health per op and per workflow over the last windowMs; the
378
+ # supervisor tick records one supervisor-op-metrics snapshot per run and the owner digest's trend line compares the
379
+ # newest with the one closest to trendMs earlier. stuckSla: every wait a running workflow holds (starci kernel status stuck[])
380
+ # is severity warn past warnMs and critical past criticalMs - either is a Supervisor owed action; the tick alerts
381
+ # every critical one.
382
+ opTelemetry:
383
+ windowMs: 86400000
384
+ trendMs: 86400000
385
+ stuckSla:
386
+ owner-gate: {warnMs: 14400000, criticalMs: 86400000}
387
+ peer-wait: {warnMs: 3600000, criticalMs: 14400000}
388
+ dependency: {warnMs: 14400000, criticalMs: 86400000}
389
+ retry-cap: {warnMs: 1800000, criticalMs: 14400000}
390
+ deferred-settle: {warnMs: 1800000, criticalMs: 7200000}
391
+ queued-ready: {warnMs: 900000, criticalMs: 3600000}
392
+ throttled: {warnMs: 3600000, criticalMs: 14400000}
393
+ # quitAgent (scripts/kernel/quit-agent.mjs): after the agent's own quit input is typed, settle waits
394
+ # this long for the terminal to disconnect before the release/close proceeds anyway.
395
+ quitAgent: {waitMs: 6000}
396
+ # drawRender (scripts/work/draw-render.mjs): a capture waits settleMs after document.fonts.ready.
397
+ drawRender: {settleMs: 500}
398
+ # drawLoop (scripts/work/draw-loop.mjs, scripts/work/draw/draw-taste.mjs; owner rulings 2026-09-27): interface.draw
399
+ # draws -> shoots -> evaluates -> fixes in rounds. A loop stops when every machine metric passes and the
400
+ # independent critic's beauty is at least beautyMin, after maxRounds, or after stallRounds rounds in a row that
401
+ # neither cut the failures nor raised the beauty; the best round is kept. Taste thresholds: accentBudget is the
402
+ # largest share of the render the accent colour may fill (the brand art band excluded), bandsPerCardMax the most
403
+ # hairline bands one card splits into, badgesPerEntityMax the most badges one entity carries. critic is the fresh,
404
+ # context-free Orca worker that scores beauty and hierarchy against the product's brand.direction rubric: started
405
+ # through orchestration worker-start --agent <provider> --model --effort (scripts/agent/lib.mjs startAgent) on a
406
+ # runtime worktree detached at the empty tree (draw-critic.mjs criticWorkspace; Orca refuses a bare temp dir) holding only the PNGs, the HTML and the rubric; it writes verdict.json and reports worker_done; a
407
+ # critic with no worker_done within timeoutMs is stopped and released (outcome timeout, no beauty). The critic is a DIFFERENT model from the drawer (owner ruling 2026-09-27
408
+ # draw-devin-brand-claude): Devin draws, Codex critiques; when the drawer (the op's provider, bound to its
409
+ # terminal - scripts/guards/op-context.mjs - or draw-loop.mjs round --drawer) is the critic's provider - Codex drawing as the draw order's fallback - the round is
410
+ # judged by criticWhenDrawer.<drawer> instead, and a round with no independent critic has no beauty. directionPrerequisite: interface.draw needs an ACCEPTED brand.direction
411
+ # archetype for its ui record's ui.archetype - brand.mjs checkDirection evidence.ready, the owner's receipt
412
+ # (scripts/kernel/prerequisites.mjs direction-unaccepted; the Kernel enqueues brand.decide --param
413
+ # directionArchetype=<archetype> first). false switches the gate off.
414
+ drawLoop:
415
+ maxRounds: 10
416
+ stallRounds: 2
417
+ beautyMin: 8
418
+ accentBudget: 0.10
419
+ bandsPerCardMax: 3
420
+ badgesPerEntityMax: 2
421
+ critic: {provider: codex, model: gpt-6.1-sol, effort: high, timeoutMs: 900000}
422
+ criticWhenDrawer:
423
+ codex: {provider: claude, model: claude-opus-5-5, effort: high, timeoutMs: 900000}
424
+ directionPrerequisite: true
425
+ # How long the workflow that claimed foundation `shell` (the layout chain an interface.draw draws) may hold it before a
426
+ # waiting draw opens a Supervisor Decision Item (scripts/kernel/shell-foundation.mjs; owner ruling 2026-09-29 draw-from-todo).
427
+ shellFoundationStallMs: 7200000
428
+ # autopilot (scripts/kernel/autopilot-run.mjs; owner ruling 2026-09-28 autopilot-run-to-finish, modules/kernel/
429
+ # owner-rulings.yaml): "run to the finish in one go, don't stop to ask the owner - not even UX/UI review; the owner
430
+ # reviews once at the end". enabled is the default for every running workflow; workflows.<workflowId>.enabled
431
+ # overrides it for one workflow (starci kernel autopilot --workflow <id> --set on|off records a ledger override that wins
432
+ # over both). Under autopilot:
433
+ # - a draw-review or brand-direction-review ask whose machine gates pass is answered PROVISIONALLY (answeredBy
434
+ # autopilot, receipt provisional:true + gate evidence); it never becomes golden and never counts as an owner
435
+ # answer (owner-claim.mjs). Failing gates answer redraw/revise with the gate findings, at most
436
+ # redrawBudget times per record, then the leg is deferred to the final review;
437
+ # - a credential, real-money, shared-external-system or owner-only ask is deferred-to-handover: nothing is
438
+ # sent or waited on, the leg proceeds on the sandbox/stub path the deferral names, the live-proof legs that
439
+ # need it wait for the one end-of-flow credential checklist (provision.ask subject handover-credentials);
440
+ # - a retry cap or an owner-gate that is really a runtime/process issue is a supervisor-gate incident (the
441
+ # Supervisor fixes or decides the retry), supervisorExtraBudget gates per node group, then the leg is
442
+ # deferred; an unresolved supervisor-gate older than supervisorGateTimeoutMs defers what it holds;
443
+ # - budgets caps one workflow (non-kernel jobs, token total recorded on jobs, wall time since start): past
444
+ # one, a supervisor-gate holds new dispatch until the Supervisor extends the budget.
445
+ autopilot:
446
+ enabled: true
447
+ workflows: {}
448
+ redrawBudget: 2
449
+ supervisorExtraBudget: 2
450
+ supervisorGateTimeoutMs: 21600000
451
+ budgets: {attempts: 600, tokens: 400000000, wallMs: 1209600000}
452
+ # serveAsk (scripts/kernel/ask-server.mjs): the default lifetime of a served owner-ask link
453
+ # (--ttl <ms> overrides it per serve).
454
+ serveAsk: {ttlMs: 14400000}
455
+ # workerJobs (scripts/supervisor/workers.mjs takeLeases, scripts/supervisor/supervisor-watchdog.mjs
456
+ # filedReports): a contract worker's file leases expire leaseTtlMs after it takes them, so a dead
457
+ # worker's leases free themselves; the watchdog consumes worker reports filed in the last
458
+ # reportWindowMs.
459
+ workerJobs: {leaseTtlMs: 604800000, reportWindowMs: 604800000}
460
+ # draft (scripts/kernel/clear-draft.mjs): the beat between one Ctrl+U and the re-read that judges
461
+ # the input box's answer - a TUI repaints a beat later. clearDraft and probeDraft default to it and
462
+ # the wake-delivery draft probe caps its own interval at it.
463
+ draft: {intervalMs: 300}
464
+ # housekeeping (scripts/housekeeping/housekeeping.mjs): every retention window and root the host
465
+ # cleanup reads - no literal may live in the script. tmp: top-level %TEMP% entries whose name starts
466
+ # with one of tmpPrefixes (the prefixes StarCi, its ops lanes and its spec fixtures create) and
467
+ # whose age passes tmpMaxAgeMs are removed, never %TEMP%/claude and never a dir a live process
468
+ # holds. Agent session files (codex sessions and archived_sessions, devin
469
+ # transcripts and summaries, orca's own codex-runtime-home sessions/generated_images) older than
470
+ # sessionArchiveAfterMs move under archiveRoot keeping their relative path; Claude Code project
471
+ # transcripts get the longer claudeTranscriptArchiveAfterMs. Archive files older than
472
+ # archiveMaxAgeMs are deleted outright. lanesRoot is where lane worktrees sit; a landed lane is
473
+ # removed only once its branch reflog, HEAD reflog and directory stayed unchanged for laneGraceMs
474
+ # (a fresh lane with no commit yet reads as landed to git cherry); unset, no lane is removed.
475
+ # logMaxAgeMs caps every jsonl and log under %LOCALAPPDATA%/StarCi and ~/.starci.
476
+ # gitIndexLockStaleMs: a product checkout's .git/index.lock older than this, with no git process on
477
+ # that repository (one naming no repository counts as on it), is removed by
478
+ # scripts/api/git/index-lock.mjs - from the op worker's git shim before git runs, and by the
479
+ # housekeeping area gitlocks - and recorded as a supervisor-ledger git-index-lock-removed event. A
480
+ # live git holds the lock only while it writes (a commit with hooks: minutes at most), and its
481
+ # process keeps the lock regardless of age.
482
+ housekeeping:
483
+ tmpMaxAgeMs: 172800000
484
+ tmpPrefixes: [policy-, rights-, l4-, starci, starci-w2, evidence, sup-k, work-v3, scoped-lint, si-, w1-, nivo-, orca-spec,
485
+ owner-bias-cli-, admission-runtime-, agent-launch-, starci-provider-budget-, starci-provider-schema-,
486
+ codex-, deps-, direction-part-, draw-layer-, footprint-, grammar-pin-, guard-, literal-argv-, module-yaml-,
487
+ doc-language-, guidance-, hk-, hfs-, install-link-, kernel-check-, kguard-, sup-orca, land-, op-manifest-, path-key-, pathspec-, push-scan-spec-, rename-over-, sbl-, serve-ask-, sup-chat, sup-repo, sup-src, sup-wd,
488
+ work-acceptance-, work-brand-test-, work-core-test-, work-custody-test-, work-external-,
489
+ work-index-md-, work-module-spec-, example-critique-, example-derive-, example-evidence-, example-verify-,
490
+ example-work-gate-, work-artifacts-, work-consistency-, work-surfaces-,
491
+ grammar-land-, kernel-replace-close-, nm-link-, rc-job-, rc-health-, release-gate-, seat-titles-, slice-typecheck-, unit-roles-, spec-budget-]
492
+ sessionArchiveAfterMs: 259200000
493
+ claudeTranscriptArchiveAfterMs: 604800000
494
+ archiveMaxAgeMs: 2592000000
495
+ # archiveRoot and lanesRoot are unset on purpose: no host location lives in a tracked file. The defaults are
496
+ # <starciLocalRoot>/archive and <starciLocalRoot>/lanes (scripts/machine/home.mjs archiveRoot, lanesRoot); the owner
497
+ # relocates them with STARCI_ARCHIVE_ROOT and STARCI_LANES_ROOT or by setting these keys on the host.
498
+ laneGraceMs: 86400000
499
+ logMaxAgeMs: 1209600000
500
+ gitIndexLockStaleMs: 300000
501
+ # gc: the Supervisor's garbage collection (scripts/supervisor/gc.mjs, every tick; owner 2026-09-28 "there must be
502
+ # garbage collection"). An idle bare shell or an unregistered runtime terminal of a live workflow is closed only once it has
503
+ # been seen for gcMinAgeMs (a dispatch binds its terminal well within that); a merged lane worktree only once idle
504
+ # for gcLaneGraceMs. GC never purges an ended workflow: housekeeping does (Q6: 30 days, zipped and verified first).
505
+ gcMinAgeMs: 600000
506
+ gcLaneGraceMs: 1800000
507
+ # gc: the cadence of the Supervisor's periodic sweep (scripts/supervisor/gc.mjs; owner 2026-09-28 "every 30 minutes, not
508
+ # every tick": the tick only checks whether it is due) and the tabs it never touches (keepTitles: regexes on the tab or
509
+ # pane title; an owner's hand-opened tab with recent output is reported, not closed, allowlisted or not).
510
+ gc:
511
+ sweepMs: 1800000
512
+ # laneCap: the most lane worktrees that stay registered under the lanes root (scripts/supervisor/gc.mjs collectLanes); past it the
513
+ # longest idle clean lanes go, landed or not (an unlanded lane keeps its branch). Owner rule: worktrees never accumulate.
514
+ laneCap: 40
515
+ keepTitles: []
516
+ # reconciler (scripts/reconciler/*; DESIGN 7.4-7.8, contract modules/reconciler/reconciler.yaml): the engine polls
517
+ # every ledger's events every pollMs; the leader row lasts leaseMs and is renewed (with the heartbeat row and file)
518
+ # every renewMs; boot.mjs ensure restarts an engine whose heartbeat is older than
519
+ # heartbeatStaleMs; one starci kernel status snapshot per workflow is shared for statusCacheMs; a failing key backs off
520
+ # backoff.minMs doubling to backoff.maxMs; more than crashLoop.max engine starts in crashLoop.windowMs start it
521
+ # --safe (read-only) and push the owner one urgent Telegram (boot.mjs).
522
+ reconciler: {pollMs: 2000, leaseMs: 30000, renewMs: 10000, heartbeatStaleMs: 60000, statusCacheMs: 20000, backoff: {minMs: 1000, maxMs: 300000}, crashLoop: {max: 3, windowMs: 1800000}}
523
+ # resources: the host-floor guards the provider-health / admission path reads. Below minFreeDiskGb
524
+ # `starci kernel dispatch --spawn` refuses host-resources-low until there is room again - measured on the
525
+ # drive that holds %TEMP% and the repos. RAM goes through the RAM-aware, priority-aware throttle
526
+ # (scripts/machine/ram-throttle.mjs; owner ruling 2026-09-28 "Parallelism ceiling follows real RAM: free RAM below 15%
527
+ # then reduce the number of parallel ops, avoid freezing the machine and killing ops mid-run"): at every dispatch the effective cap
528
+ # is min(maxParallelOps, running + the ops that fit in free RAM above hardFloorPct of total), counted across
529
+ # every ledger of the host, and never above maxParallelOps. minFreeRamPct is the heavy floor: below it no NEW
530
+ # heavy op (opRam class heavy: Playwright / render / test / implement) starts from a workflow below the top
531
+ # priority, light ops still start; heavy resumes only above ramThrottle.heavyResumeAbovePct (hysteresis).
532
+ # Below landSpecPauseBelowPct no heavy op starts from any workflow and the land gate's spec runs pause until
533
+ # free RAM is back above landSpecResumeAbovePct. A CPU at or above cpuHeavyStopAbove pauses heavy ops the
534
+ # same way until it falls below cpuHeavyResumeBelow. Running ops are never stopped. Owner ruling 2026-09-28
535
+ # ("15→10, 10→2.5"): the heavy floor 10% resuming at 15%, critical 2.5% resuming at 5%, the fit floor 2.5%.
536
+ resources:
537
+ minFreeDiskGb: 20
538
+ minFreeRamPct: 10
539
+ ramThrottle:
540
+ heavyResumeAbovePct: 15
541
+ landSpecPauseBelowPct: 2.5
542
+ landSpecResumeAbovePct: 5
543
+ hardFloorPct: 2.5
544
+ cpuHeavyStopAbove: 0.95
545
+ cpuHeavyResumeBelow: 0.85
546
+ # The estimate history: the newest historySamples op-ram-footprint samples (the Resource controller records them);
547
+ # a kind's measured RAM replaces its opRam prior once it has historyMinObservations observations. kernelMb:
548
+ # the RAM one running Kernel's agent is assumed to hold, subtracted from the agent trees before sharing.
549
+ historySamples: 48
550
+ historyMinObservations: 3
551
+ kernelMb: 900
552
+ # priorities: {<workflowId>: {weight, reserve}}. Weight 1 is everyone's default. A workflow below the top
553
+ # weight leaves `reserve` slots (and the RAM its queued ops need) to the higher ones and loses its heavy
554
+ # ops first under the heavy pause; the top one keeps starting heavy ops while they fit, until critical.
555
+ # The Supervisor overrides per host: starci supervisor ram-cap prioritize --workflow <id>
556
+ # --weight <n> [--reserve <slots>]. Owner priority 2026-09-28: the prioritized FE refactor workflow ran
557
+ # up to 15 parallel code.refactor slices first; the other workflows ramped up in what was left.
558
+ priorities: {}
559
+ # opRam: the per-op RAM estimate table (MB for one running op: the agent CLI plus what it runs - the
560
+ # test runner, the browser, the dev server) and its class. heavy = Playwright / render / test /
561
+ # implement; light = reading, deciding, writing records. A kind not listed takes `default`.
562
+ opRam:
563
+ default: {mb: 1000, class: light}
564
+ backend.implement: {mb: 2500, class: heavy}
565
+ interface.implement: {mb: 3000, class: heavy}
566
+ interface.draw: {mb: 3500, class: heavy}
567
+ interface.asset: {mb: 2500, class: heavy}
568
+ interface.audit: {mb: 3000, class: heavy}
569
+ brand.decide: {mb: 3000, class: heavy}
570
+ code.refactor: {mb: 2000, class: heavy}
571
+ test.author: {mb: 2500, class: heavy}
572
+ task.execute: {mb: 2000, class: heavy}
573
+ backend.scaffold: {mb: 2000, class: heavy}
574
+ interface.scaffold: {mb: 2000, class: heavy}
575
+ package.scaffold: {mb: 2000, class: heavy}
576
+ uat.verify: {mb: 3500, class: heavy}
577
+ uat.assisted.verify: {mb: 3500, class: heavy}
578
+ e2e.verify: {mb: 3500, class: heavy}
579
+ perf.verify: {mb: 3500, class: heavy}
580
+ unit.verify: {mb: 2500, class: heavy}
581
+ integration.verify: {mb: 2500, class: heavy}
582
+ security.verify: {mb: 1500, class: light}
583
+ review.verify: {mb: 1000, class: light}
584
+ runtime.operate: {mb: 1500, class: light}
585
+ release.deliver: {mb: 1500, class: light}
586
+ architecture.decide: {mb: 800, class: light}
587
+ business.decide: {mb: 800, class: light}
588
+ decision.prepare: {mb: 800, class: light}
589
+ request.analyze: {mb: 800, class: light}
590
+ scope.define: {mb: 800, class: light}
591
+ scope.finish: {mb: 800, class: light}
592
+ goal.revise: {mb: 800, class: light}
593
+ docs.author: {mb: 800, class: light}
594
+ content.generate: {mb: 800, class: light}
595
+ work.author: {mb: 800, class: light}
596
+ grammar.update: {mb: 800, class: light}
597
+ knowledge.repair: {mb: 800, class: light}
598
+ handover.review: {mb: 800, class: light}
599
+ provision.ask: {mb: 800, class: light}
600
+ uat.assisted.prepare: {mb: 1000, class: light}
601
+ workspace.manage: {mb: 1000, class: light}
602
+ # A routed-but-queued job (payload.model set, status queued) holds its pool slot only this long after its latest route
603
+ # decision (payload.routedAt, else its newest route-decided event): long enough for one fan-out's sequential route
604
+ # calls to spread across pools, short enough that a job parked behind a gate, hold, peer-wait, dependency or
605
+ # readiness loop does not starve the pool (scripts/kernel/cli.mjs poolLoadOf, shared by starci kernel route and starci kernel status).
606
+ # Running, leased and answering jobs always hold theirs. Re-routing refreshes the hold.
607
+ routeHoldMs: 900000
608
+ verifyAvoidsImplementRuntime: true
609
+ onLaunchFailure: next-available-runtime
610
+ tieBreak: round-robin
611
+ # worker-start is a managed launch the host refused without classifying it. Two minutes is long
612
+ # enough for the kernel to reroute the attempt to a different pool, short enough that a one-off
613
+ # host hiccup does not park a healthy pool for the rest of the leg. prompt-delivery-stalled is its
614
+ # command-terminal twin: a prompt lost on a stalled send and on its one re-delivery (scripts/agent/lib.mjs).
615
+ # quota: the fallback only - a provider whose plan reset is configured holds its quota circuit until that reset
616
+ # plus one probe interval, cleared earlier by its recovery probe.
617
+ # capacity: the provider refused to serve the model for now (an agent card's capacityExhausted row).
618
+ cooldownMs: {rate-limited: 600000, quota: 3600000, capacity: 600000, auth: 86400000, other: 300000, worker-start: 120000, prompt-delivery-stalled: 120000}
619
+ # Observations of one failure kind before its circuit opens. A kind absent here opens on the first:
620
+ # a provider answering 401 is not a flake, a single refused launch can be.
621
+ # A circuit that reopens for the same failure inside windowMs waits factor
622
+ # times longer each time, capped at capMs (scripts/kernel/cli.mjs
623
+ # writeProviderCircuit). An un-onboarded CLI does not clear in two minutes.
624
+ circuitBackoff: {factor: 5, capMs: 3600000, windowMs: 3600000}
625
+ providerStrikes: {worker-start: 2, prompt-delivery-stalled: 2}
626
+ backoffFactor: 2
627
+ maxCooldownMs: 3600000
628
+ # The allocator's reading of each kind, from what its op manifest's goal and steps do. `role` is the
629
+ # kinds.yaml role. `work` is `think` when the output is a canonical record (SRS, SDS, scope, goal, decision,
630
+ # brand, ui, Work, workspace, rule) or a verdict about quality, and `hands-on` when the op builds, runs or
631
+ # measures under a record someone else settled. `floor` is the least difficulty the kind routes at:
632
+ # scripts/agent/models.mjs selectPool raises a measured difficulty to it and never lowers one. Every think
633
+ # kind's floor is hard, the tier where every think pool pins a frontier model. The kernel's own model
634
+ # calls (selection.yaml kernelFunctionKinds) are think work at the same floor. `order` names the allocation
635
+ # tiers/preference key the kind walks when it is not the default (`think` for think work, else the role):
636
+ # `scaffold` (Devin first) for scaffold, docs, content and grammar work, `draw` (Devin first, Codex Sol at effort high
637
+ # the fallback) for interface.draw, `asset` (Codex only, the image tool) for interface.asset, `brand` (Opus first, Sol
638
+ # the fallback) for brand.decide, `review` (Devin, Opus and Sol overflow) for the remaining verify kinds and
639
+ # work.author (owner decision 2026-09-25 review-hands), `ui` (Codex first, Devin as fallback) for
640
+ # interface.audit, e2e.verify, security.verify and uat.assisted.verify, `implement` for the mechanical
641
+ # think ops the hands take whatever their kind role - provision.ask, workspace.manage, task.execute and
642
+ # knowledge.repair - and `sol-think` (Sol first, Opus overflow) for the kernel's own model calls, verify
643
+ # calls included (owner routing 2026-09-26). work.author authors Work records - the write role, as in
644
+ # modules/models/kinds.yaml - so the hands pools, which carry no plan role, can take it; its cut form,
645
+ # implementation.plan, stays plan work on the think order.
646
+ roleOfKind:
647
+ request.analyze: {role: plan, work: think, floor: hard}
648
+ task.execute: {role: plan, work: think, floor: hard, order: implement}
649
+ backend.implement: {role: implement, work: hands-on, floor: medium}
650
+ backend.scaffold: {role: implement, work: hands-on, floor: easy, order: scaffold}
651
+ interface.implement: {role: implement, work: hands-on, floor: medium}
652
+ interface.audit: {role: verify, work: think, floor: hard, order: ui}
653
+ interface.scaffold: {role: implement, work: hands-on, floor: easy, order: scaffold}
654
+ package.scaffold: {role: implement, work: hands-on, floor: easy, order: scaffold}
655
+ scope.define: {role: decide, work: think, floor: hard}
656
+ code.refactor: {role: implement, work: hands-on, floor: easy}
657
+ test.author: {role: implement, work: hands-on, floor: easy}
658
+ grammar.update: {role: implement, work: hands-on, floor: hard, order: scaffold}
659
+ architecture.revise: {role: decide, work: think, floor: hard}
660
+ business.revise: {role: decide, work: think, floor: hard}
661
+ content.generate: {role: write, work: hands-on, floor: easy, order: scaffold}
662
+ docs.author: {role: write, work: hands-on, floor: easy, order: scaffold}
663
+ knowledge.repair: {role: write, work: think, floor: hard, order: implement}
664
+ release.deliver: {role: implement, work: hands-on, floor: hard}
665
+ scope.finish: {role: implement, work: hands-on, floor: hard}
666
+ runtime.operate: {role: implement, work: hands-on, floor: medium}
667
+ review.verify: {role: verify, work: think, floor: hard, order: review}
668
+ handover.review: {role: verify, work: think, floor: hard, order: review}
669
+ e2e.verify: {role: verify, work: hands-on, floor: medium, order: ui}
670
+ integration.verify: {role: verify, work: hands-on, floor: hard, order: review}
671
+ security.verify: {role: verify, work: think, floor: hard, order: ui}
672
+ perf.verify: {role: verify, work: hands-on, floor: medium, order: review}
673
+ unit.verify: {role: verify, work: hands-on, floor: medium, order: review}
674
+ uat.verify: {role: verify, work: hands-on, floor: medium, order: review}
675
+ uat.assisted.prepare: {role: write, work: hands-on, floor: medium}
676
+ uat.assisted.verify: {role: verify, work: think, floor: hard, order: ui}
677
+ goal.validate: {role: verify, work: think, floor: hard, order: review}
678
+ architecture.decide: {role: decide, work: think, floor: hard}
679
+ business.decide: {role: decide, work: think, floor: hard}
680
+ goal.revise: {role: decide, work: think, floor: hard}
681
+ decision.prepare: {role: decide, work: think, floor: hard}
682
+ provision.ask: {role: decide, work: think, floor: hard, order: implement}
683
+ brand.decide: {role: write, work: think, floor: hard, order: brand}
684
+ interface.draw: {role: write, work: think, floor: hard, order: draw}
685
+ interface.asset: {role: write, work: hands-on, floor: medium, order: asset}
686
+ work.author: {role: write, work: think, floor: hard, order: review}
687
+ implementation.plan: {role: plan, work: think, floor: hard}
688
+ workspace.manage: {role: plan, work: think, floor: hard, order: implement}
689
+ model.assessGoal: {role: plan, work: think, floor: hard, order: sol-think}
690
+ model.planOp: {role: plan, work: think, floor: hard, order: sol-think}
691
+ model.decide: {role: decide, work: think, floor: hard, order: sol-think}
692
+ model.manageWorkflow: {role: decide, work: think, floor: hard, order: sol-think}
693
+ model.validateOp: {role: verify, work: think, floor: hard, order: sol-think}
694
+ model.critiqueGoal: {role: verify, work: think, floor: hard, order: sol-think}
695
+ judge: {role: verify, work: think, floor: hard, order: sol-think}