@starci/hfs 4.7.47 → 4.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +4 -9
  3. package/emit/operation-schemas.mjs +3 -0
  4. package/lint/bound-sys.cjs +2 -2
  5. package/package.json +11 -5
  6. package/runtime/engine/admission.mjs +1 -1
  7. package/runtime/engine/config.mjs +2 -2
  8. package/runtime/engine/db/machine.mjs +2 -3
  9. package/runtime/engine/invalid-config.mjs +1 -1
  10. package/runtime/knowledge/grammars/{starci → core}/playbook.yaml +3 -3
  11. package/runtime/knowledge/grammars/index.yaml +14 -23
  12. package/runtime/knowledge/grammars/offset-pop/playbook.yaml +2 -2
  13. package/runtime/knowledge/hfs/canon-pins.yaml +23 -23
  14. package/runtime/knowledge/hfs/fe-stack.yaml +1 -1
  15. package/runtime/knowledge/hfs/rules.yaml +83 -60
  16. package/runtime/modules/kernel/failure-codes.yaml +23 -13
  17. package/runtime/scripts/guards/git-policy.mjs +2 -3
  18. package/runtime/scripts/hfs/rule-catalog.mjs +2 -2
  19. package/runtime/scripts/hfs/rules/pipeline.mjs +5 -5
  20. package/runtime/scripts/lib/example-refs.mjs +10 -3
  21. package/runtime/scripts/lib/grammar-lint.mjs +16 -3
  22. package/runtime/scripts/lib/package-at.mjs +5 -6
  23. package/runtime/scripts/lib/roots.mjs +2 -2
  24. package/runtime/scripts/work/draw/draw-dna-findings.mjs +23 -12
  25. package/runtime/scripts/work/draw/draw-dna.mjs +14 -8
  26. package/scaffold/app.mjs +6 -6
  27. package/src/main.mjs +3 -3
  28. package/sync/hygiene.mjs +1 -1
  29. package/sync/index.mjs +15 -2
  30. package/sync/managed.mjs +3 -2
  31. package/templates/app/codegen-graphql.mjs.partial +4 -4
  32. package/templates/app/quality-config/sonar-project.properties +4 -2
  33. package/runtime/engine/canonical-json.mjs +0 -14
  34. package/runtime/engine/db/ledger-open.mjs +0 -38
  35. package/runtime/engine/db/ledger-paths.mjs +0 -87
  36. package/runtime/engine/db/ledger.mjs +0 -1068
  37. package/runtime/engine/db/provision-authority.mjs +0 -76
  38. package/runtime/engine/db/provision-operations.mjs +0 -146
  39. package/runtime/packages/grammar/scripts/build-stamp.mjs +0 -98
  40. package/runtime/scripts/agent/codex-app-server.mjs +0 -79
  41. package/runtime/scripts/agent/codex-mirror-source.mjs +0 -34
  42. package/runtime/scripts/agent/host-agents.mjs +0 -80
  43. package/runtime/scripts/agent/launch-trust-policy.mjs +0 -53
  44. package/runtime/scripts/agent/trust-launch.mjs +0 -191
  45. package/runtime/scripts/agent/trust.mjs +0 -523
  46. package/runtime/scripts/api/fs/temp-path.mjs +0 -8
  47. package/runtime/scripts/api/git/diff-names.mjs +0 -8
  48. package/runtime/scripts/api/git/head-time.mjs +0 -10
  49. package/runtime/scripts/api/git/index-lock.mjs +0 -78
  50. package/runtime/scripts/api/git/log.mjs +0 -5
  51. package/runtime/scripts/api/git/merge-tree.mjs +0 -5
  52. package/runtime/scripts/api/git/rev-list.mjs +0 -5
  53. package/runtime/scripts/api/git/rev-parse.mjs +0 -13
  54. package/runtime/scripts/api/git/status-query.mjs +0 -5
  55. package/runtime/scripts/api/git/worktree-list-query.mjs +0 -5
  56. package/runtime/scripts/api/node/spawn-node.mjs +0 -6
  57. package/runtime/scripts/api/npm/dist-tag.mjs +0 -8
  58. package/runtime/scripts/api/npm/lib.mjs +0 -32
  59. package/runtime/scripts/api/npm/pack-dry-run.mjs +0 -9
  60. package/runtime/scripts/api/npm/run-npm.mjs +0 -6
  61. package/runtime/scripts/api/npm/view.mjs +0 -30
  62. package/runtime/scripts/api/npm/whoami.mjs +0 -8
  63. package/runtime/scripts/api/process/hide-child-windows.mjs +0 -31
  64. package/runtime/scripts/api/process/kill-tree.mjs +0 -22
  65. package/runtime/scripts/api/process/lib.mjs +0 -125
  66. package/runtime/scripts/api/process/probe-guard-command.mjs +0 -74
  67. package/runtime/scripts/api/process/process-list.mjs +0 -28
  68. package/runtime/scripts/api/process/system-tool.mjs +0 -37
  69. package/runtime/scripts/gates/canon-digest.mjs +0 -81
  70. package/runtime/scripts/gates/canon-pins.mjs +0 -119
  71. package/runtime/scripts/gates/gate-input.mjs +0 -98
  72. package/runtime/scripts/gates/gate.mjs +0 -636
  73. package/runtime/scripts/gates/grammar-dist.mjs +0 -206
  74. package/runtime/scripts/gates/output.mjs +0 -40
  75. package/runtime/scripts/gates/runtime-package-selection.mjs +0 -27
  76. package/runtime/scripts/gates/test-world-run.mjs +0 -252
  77. package/runtime/scripts/gates/type-impact.mjs +0 -277
  78. package/runtime/scripts/gates/type-program.mjs +0 -113
  79. package/runtime/scripts/guards/assigned-command.mjs +0 -12
  80. package/runtime/scripts/guards/call-rights.mjs +0 -47
  81. package/runtime/scripts/guards/command-guard.mjs +0 -468
  82. package/runtime/scripts/guards/command-policy.mjs +0 -342
  83. package/runtime/scripts/guards/critic-reach.mjs +0 -82
  84. package/runtime/scripts/guards/deps-guard.mjs +0 -150
  85. package/runtime/scripts/guards/env-dump-verdict.mjs +0 -89
  86. package/runtime/scripts/guards/guards-root.mjs +0 -27
  87. package/runtime/scripts/guards/hook-install.mjs +0 -343
  88. package/runtime/scripts/guards/hook-verdict.mjs +0 -12
  89. package/runtime/scripts/guards/install-verdict.mjs +0 -41
  90. package/runtime/scripts/guards/kernel-seat.mjs +0 -63
  91. package/runtime/scripts/guards/launch-verdict.mjs +0 -74
  92. package/runtime/scripts/guards/op-starci.mjs +0 -16
  93. package/runtime/scripts/guards/op-write-scope.mjs +0 -27
  94. package/runtime/scripts/guards/orca-self-lifecycle.mjs +0 -39
  95. package/runtime/scripts/guards/process-kill-verdict.mjs +0 -106
  96. package/runtime/scripts/guards/protected-zone.mjs +0 -56
  97. package/runtime/scripts/guards/refusals.mjs +0 -27
  98. package/runtime/scripts/guards/rights.mjs +0 -268
  99. package/runtime/scripts/guards/seat-tools.mjs +0 -47
  100. package/runtime/scripts/guards/shell-commands.mjs +0 -328
  101. package/runtime/scripts/guards/supervisor-seat.mjs +0 -80
  102. package/runtime/scripts/guards/verdict-process.mjs +0 -81
  103. package/runtime/scripts/lib/app-data.mjs +0 -11
  104. package/runtime/scripts/lib/canon-binding-text.mjs +0 -129
  105. package/runtime/scripts/lib/check-format.mjs +0 -7
  106. package/runtime/scripts/lib/failure-code-reads.mjs +0 -100
  107. package/runtime/scripts/lib/failure-code-template-errors.mjs +0 -161
  108. package/runtime/scripts/lib/git-dir.mjs +0 -120
  109. package/runtime/scripts/lib/guard-command.mjs +0 -24
  110. package/runtime/scripts/lib/interrupt-cleanup.mjs +0 -38
  111. package/runtime/scripts/lib/json-formats.mjs +0 -34
  112. package/runtime/scripts/lib/managed-json.mjs +0 -51
  113. package/runtime/scripts/lib/menu-parts.mjs +0 -11
  114. package/runtime/scripts/lib/op-gate.mjs +0 -15
  115. package/runtime/scripts/lib/provision-control-failure.mjs +0 -32
  116. package/runtime/scripts/lib/release-version.mjs +0 -134
  117. package/runtime/scripts/lib/runtime-location.mjs +0 -21
  118. package/runtime/scripts/lib/runtime-package-inventory.mjs +0 -21
  119. package/runtime/scripts/lib/runtime-package-manifests.mjs +0 -84
  120. package/runtime/scripts/lib/runtime-publication-tags.mjs +0 -56
  121. package/runtime/scripts/lib/seat-env.mjs +0 -43
  122. package/runtime/scripts/lib/sonar-new-code.mjs +0 -58
  123. package/runtime/scripts/lib/source-package-imports.mjs +0 -111
  124. package/runtime/scripts/lib/tar-files.mjs +0 -39
  125. package/runtime/scripts/lib/uat-run-folder.mjs +0 -118
  126. package/runtime/scripts/lib/worktree-record.mjs +0 -14
  127. package/runtime/scripts/machine/ask-receipts.mjs +0 -113
  128. package/runtime/scripts/machine/evidence-store.mjs +0 -223
  129. package/runtime/scripts/machine/home.mjs +0 -216
  130. package/runtime/scripts/machine/host-lock.mjs +0 -184
  131. package/runtime/scripts/machine/lock-recovery.mjs +0 -55
  132. package/runtime/scripts/machine/roles-contract.mjs +0 -90
  133. package/runtime/scripts/machine/runtime-change.mjs +0 -20
  134. package/runtime/scripts/machine/workflow-tree.mjs +0 -122
  135. package/runtime/scripts/reconciler/checklist-items.mjs +0 -7
  136. package/runtime/scripts/reconciler/guard-row.mjs +0 -25
  137. package/runtime/scripts/work/brand/brand-colour.mjs +0 -125
  138. package/runtime/scripts/work/brand/brand-tokens.mjs +0 -167
  139. package/runtime/scripts/work/brand/brand-value-source.mjs +0 -106
  140. package/runtime/scripts/work/brand/brand.mjs +0 -892
  141. package/runtime/scripts/work/draw/draw-layer.mjs +0 -306
  142. package/runtime/scripts/work/draw/draw-rationale-page.mjs +0 -237
  143. package/runtime/scripts/work/draw/draw-rationale-ref.mjs +0 -14
  144. package/runtime/scripts/work/draw/draw-rationale.mjs +0 -353
  145. package/runtime/scripts/work/draw/draw-source.mjs +0 -412
  146. package/runtime/scripts/work/draw/draw-taste.mjs +0 -278
  147. package/runtime/scripts/work/draw/draw-typecheck.mjs +0 -72
  148. package/runtime/scripts/work/draw/rationale-findings.mjs +0 -205
  149. package/runtime/scripts/work/draw-grammar.mjs +0 -175
  150. package/runtime/scripts/work/draw-render-page.mjs +0 -188
  151. package/runtime/scripts/work/draw-render.mjs +0 -626
  152. package/runtime/scripts/work/png.mjs +0 -237
  153. package/runtime/scripts/work/render-tools.mjs +0 -64
package/CHANGELOG.md CHANGED
@@ -1,5 +1,23 @@
1
1
  # Changelog
2
2
 
3
+ ## 4.9.0 - 2026-10-28
4
+
5
+ - Removed: 121 bundled runtime scripts that only served the legacy runtime and that no `starci app` verb, package entry or catalogued rule enforcer reaches: `scripts/agent/`, `scripts/reconciler/`, the legacy hook guards of `scripts/guards/` (command, seat, rights, install and launch verdicts), the op gate of `scripts/gates/` (`gate.mjs`, canon pins and digest, type impact), the drawing pipeline of `scripts/work/` other than the DNA judge (`draw-dna*`, `grammar-proposal`, `asset-slot`), the ledger of `engine/db/`, the machine helpers, and the `scripts/api` and `scripts/lib` helpers only they imported; with them the specs that exercised only that code. The `release-push-gate` and `hook-io` cases of `hook-input.spec.mjs` stay.
6
+ - Changed: `starci app` is carried by the harness CLI `starci-harness`, which runs this package in-process; `@starci/cli` is retired. A new app's root devDependencies name `starci-harness` instead of `@starci/cli`, its GraphQL codegen loads the input-bounds plugin from `starci-harness/input-bounds`, the runtime resolves an app's `starci` bin and its @starci/hfs from its installed `starci-harness` (`package-at.mjs`), and HFS_CI_MISSING_CANON accepts `npx starci-harness[@<version>] app lint`, the version being the `starci-harness` pin; the bundled canon pins replace the retired `@starci/cli` with `starci-harness` 1.1.0-alpha.1 (`source: cli/package.json`), the one command line a product installs for `starci app`, and follow the harness packages (Grammar family 0.14.0, hfs 4.9.0, canon-fe 9.3.0, canon-be 3.5.0).
7
+ - Changed: the rendered `sonar-project.properties` takes the jest preset's test patterns as tests: `sonar.tests` names every source folder and `sonar.test.inclusions` those patterns, which `sonar.exclusions` moves out of the sources (Sonar refuses a file indexed as both), beside the build and dependency folders; `supabase/types/**` is no longer excluded, so a lite app's generated row types are analysed. `sonar.coverage.exclusions` sits between the `starci:sonar-scope` markers `starci app sonar --write` writes, so sync and the harness's Sonar scope check agree on one file.
8
+
9
+ ## 4.8.0 - 2026-10-27
10
+
11
+ - Removed: the Heritage family from the bundled Grammar catalog.
12
+ - Changed: the bundled canon pins name each @starci package by its folder in starci-harness (`source: packages/<name>/package.json`) at the versions there; `@starci/cli` is a registry-only pin.
13
+ - Removed: the specs that exercised the legacy runtime's own scripts (css-rules, grammar-knowledge, grammar-union-census, grammar-vendor-repaints, ui-proof-*); that code is not part of this package.
14
+ - Changed: the package lives in github.com/starci183/starci-harness under `packages/` and publishes from there; its bundled `runtime/` is committed source, edited in place (no generator, no `prepack`/`pretest` hook).
15
+ - Changed: owner ruling: the Grammar catalog has exactly two families, `core` and `offset-pop`. `grammarLintFor`,
16
+ `grammarFamilyFor`, `grammarContractFor`, `resolveGrammarFamily` and the code-pattern family binding
17
+ (`familyCanons.core`) answer by those ids; `starci app` scaffolds `sides.fe.grammar: core`; the core lint package is
18
+ `@starci/eslint-grammar-core` with `coreGrammarConfig`, and the knowledge folder is `knowledge/grammars/core`.
19
+ - Removed: `starci` and `starci-core` are not family ids and have no alias; a selection naming them is refused.
20
+
3
21
  ## 4.7.47 - 2026-10-27
4
22
 
5
23
  - Fixed: the rendered stack escapes every literal dollar once more, so a secret-reading command or healthcheck survives the second interpolation of docker stack deploy.
package/README.md CHANGED
@@ -192,15 +192,10 @@ The upload authenticates with GitHub's OIDC token: the managed `ci.yml` job has
192
192
 
193
193
  ## Maintaining the bundle
194
194
 
195
- `runtime/` is a byte copy of the slot loader files, the pins, and the import closure of `scripts/hfs/check.mjs` and
196
- `scripts/hfs/architecture.mjs` (computed by `scripts/hfs/sync-runtime.mjs`, so a new import of the machine is bundled without
197
- editing a list), plus the catalog slice of every code `starci app check` can emit: its own and the machine's (`ARCHITECTURE_RULE_IDS`,
198
- derived from the machine's rule id lists). After changing any of those files, `knowledge/hfs/slots.yaml`,
199
- `knowledge/hfs/canon-pins.yaml`, `knowledge/patterns/fe/folder.yaml` or the catalog entries of those codes, run `starci release sync-runtime`;
200
- `starci release sync-runtime --check` fails on a stale copy. Bump `version` here and in the pin when the behaviour changes.
201
-
202
- The examples workflow (`.github/workflows/examples.yml`) runs `starci app lint` of this CLI at the root of every `examples/*`
203
- app with an `hfs.json` (each `examples/<app>` root) and fails on any finding or any tool that could not run. This includes the ESLint canons and repository checks also run by `starci app check`, plus stylelint over the frontend stylesheets.
195
+ `runtime/` holds the slot loader files, the pins, the import closure of `scripts/hfs/check.mjs` and
196
+ `scripts/hfs/architecture.mjs`, and the catalog slice of every code `starci app check` can emit. It is committed source of
197
+ this package, edited in place ([packages/README.md](../README.md) says how the bundled copies move together). Bump
198
+ `version` here and in the pin when the behaviour changes.
204
199
 
205
200
  ## Serving knowledge to other packages
206
201
 
@@ -101,6 +101,9 @@ export function operationSchemaReader({ ts, program, repoRoot }) {
101
101
  if (!resolved?.endsWith('.schema.ts')) throw new Error(`schema modules may import only zod and *.schema.ts, found ${specifier} in ${file}`);
102
102
  return load(resolved);
103
103
  };
104
+ // zod is the app's dependency, not the schema's code: it loads before the timed run, so the 1000 ms budget bounds only the
105
+ // schema module itself (a cold zod load inside it ran past the budget on a loaded machine).
106
+ for (const [, specifier] of compiled.matchAll(/require\("(zod(?:\/[^"]*)?)"\)/g)) requireApp(specifier);
104
107
  new vm.Script(compiled, { filename: file }).runInNewContext({ module, exports: module.exports, require: requireSchema }, { timeout: 1000 });
105
108
  return module.exports;
106
109
  }
@@ -4,8 +4,8 @@
4
4
  // projectService builds its server host from `tsserver.sys` (typescript/lib/tsserverlibrary) and exposes no host through
5
5
  // parserOptions, so without a bound a typed rule reads types from an enclosing repository's node_modules and judges the app
6
6
  // greener than its own install allows. Here `sys` of the app's own TypeScript is patched, in place and before ESLint loads
7
- // the parser, to answer only for paths inside the app root and TypeScript's own lib directory (the same bound the gate's
8
- // tsc programs use, scripts/gates/gate.mjs boundedSys). realpath is the identity, so an install junctioned inside the app
7
+ // the parser, to answer only for paths inside the app root and TypeScript's own lib directory (the same bound a typed
8
+ // tsc program of the app keeps). realpath is the identity, so an install junctioned inside the app
9
9
  // stays inside it. Nothing is patched when STARCI_LINT_BOUND is unset or TypeScript is not installed (nothing typed runs).
10
10
  'use strict'
11
11
  const path = require('node:path')
package/package.json CHANGED
@@ -1,9 +1,19 @@
1
1
  {
2
2
  "name": "@starci/hfs",
3
- "version": "4.7.47",
3
+ "version": "4.9.0",
4
4
  "description": "The StarCi app command implementation for scaffolding, linting, checking and synchronizing one product repository.",
5
5
  "type": "module",
6
6
  "license": "MIT",
7
+ "author": "starci183",
8
+ "homepage": "https://github.com/starci183/starci-harness/tree/main/packages/hfs#readme",
9
+ "repository": {
10
+ "type": "git",
11
+ "url": "git+https://github.com/starci183/starci-harness.git",
12
+ "directory": "packages/hfs"
13
+ },
14
+ "bugs": {
15
+ "url": "https://github.com/starci183/starci-harness/issues"
16
+ },
7
17
  "private": false,
8
18
  "exports": {
9
19
  ".": "./src/main.mjs",
@@ -60,10 +70,6 @@
60
70
  "access": "public"
61
71
  },
62
72
  "scripts": {
63
- "sync": "node ../../scripts/hfs/sync-runtime.mjs",
64
- "sync:check": "node ../../scripts/hfs/sync-runtime.mjs --check",
65
- "prepack": "node prep-runtime.mjs",
66
- "pretest": "node prep-runtime.mjs",
67
73
  "test": "node --test \"src/*.spec.mjs\""
68
74
  }
69
75
  }
@@ -187,7 +187,7 @@ export const AWAITING_OWNER='awaiting-owner';
187
187
  */
188
188
  export const AWAITING_OWNER_STATUS='awaiting_owner';
189
189
  export const RETRYABLE_JOB_STATUSES=Object.freeze(['failed',AWAITING_OWNER_STATUS]);
190
- /** Every jobs.status that holds nothing the runtime still needs (mirrors engine/db/ledger.mjs JOB_STATUSES.settled). */
190
+ /** Every jobs.status that holds nothing the runtime still needs. */
191
191
  export const SETTLED_JOB_LIST=Object.freeze(['succeeded','failed',AWAITING_OWNER_STATUS,'cancelled']);
192
192
  /** The tries of a unit that spent budget: every try but the ones that only waited on the owner. */
193
193
  export const spentTries=tries=>tries.filter(job=>job.status!==AWAITING_OWNER_STATUS).length;
@@ -288,11 +288,11 @@ const validateSupervisorBlock=(supervisor,profile)=>{
288
288
  const interval=supervisor?.pollIntervalMs,repos=supervisor?.repos,stall=supervisor?.stallMinutes;
289
289
  if(!plain(supervisor)||Object.keys(supervisor).some(key=>!CONFIG_KEY_TREE.supervisor.includes(key))||!(interval===null||interval===undefined||(Number.isInteger(interval)&&interval>=60000)))
290
290
  throw new Error('Invalid config.yaml: supervisor must be {mode?, pollIntervalMs?, repos?, stallMinutes?, kernel?, workers?, landGate?, frozenMinutes?} with an integer of at least 60000 ms, or null.');
291
- // mode: where the Supervisor role runs (scripts/machine/home.mjs supervisorMode) - chat (default: the owner's desktop
291
+ // mode: where the Supervisor role runs - chat (default: the owner's desktop
292
292
  // chat session owns channel 'main' and ticks itself) or kernel (the optional [Supervisor] Orca kernel, start-supervisor.mjs).
293
293
  if(!(supervisor.mode===undefined||supervisor.mode===null||['chat','kernel'].includes(supervisor.mode)))
294
294
  throw new Error('Invalid config.yaml: supervisor.mode must be chat or kernel, or null.');
295
- // The [Supervisor] kernel seat (scripts/machine/home.mjs supervisorSettings): kernel {agent?, model?, effort?}
295
+ // The [Supervisor] kernel seat: kernel {agent?, model?, effort?}
296
296
  // pins its agent (default: the kernel pin), workers {base?, max?} its adaptive [Worker] cap (0 to 10; the shipped default is 0 fix workers),
297
297
  // landGate {mode?: shared|exclusive, push?: boolean} the land gate (scripts/supervisor/land.mjs); push (default true, owner ruling push-main-after-scoped-check) lets `starci release push` send main to the remote after a green scoped check, false is the owner's lock on the remote.
298
298
  const seat=supervisor.kernel,workers=supervisor.workers,gate=supervisor.landGate;
@@ -64,8 +64,7 @@ export const CONTROLLERS = Object.freeze(['job', 'workflow', 'resource', 'host',
64
64
  // Paths
65
65
  // ---------------------------------------------------------------------------------------------------------------------
66
66
  /**
67
- * Overrides the per-host state base itself (machine.sqlite, projects/, archive/), the one seam starciLocalRoot and
68
- * engine/db/ledger.mjs (which re-exports starciLocalRoot for its own projectsRootFor) both read. Debug probes and
67
+ * Overrides the per-host state base itself (machine.sqlite, projects/, archive/), the one seam starciLocalRoot reads. Debug probes and
69
68
  * throwaway repos point this at a temp directory so they never touch the real
70
69
  * <runtime root>/.runtime and leak fake ledgers/workflows into it (2026-09-30 incident: probe-*, dbg-ask-*, dbg-env*
71
70
  * repos left six fake-worker ledgers in the live store). STARCI_PROJECTS_ROOT (ledger-db.mjs) and
@@ -138,7 +137,7 @@ function corruptIncident(file, error, details) {
138
137
 
139
138
  /**
140
139
  * The rev of the runtime this process runs, as its callers know it: '<HEAD committer time, ms, 13 digits>:<short sha>' of
141
- * the .claude checkout, which scripts/machine/home.mjs runtimeRevOf computes and the caller passes in (`rev`,
140
+ * the harness checkout, which the caller computes and passes in (`rev`,
142
141
  * `writerRev`, `sourceRev`). The db never spawns git: with no rev passed the default is STARCI_RUNTIME_REV, else
143
142
  * 'unknown'. The time prefix orders two revs, so a writer can refuse a store row written by a NEWER runtime (MB-15);
144
143
  * 'unknown' sorts before every real rev.
@@ -5,7 +5,7 @@ export const invalid=section=>message=>{throw new Error(`Invalid config.yaml: ${
5
5
 
6
6
  /** The host roots the owner may relocate (config.yaml `roots`): the archive root, the lanes root and the temp root. */
7
7
  export const ROOT_KEYS=Object.freeze(['archive','lanes','temp']);
8
- /** config.yaml `roots` - {archive?, lanes?, temp?}: absolute directories, or null; an absent key means <starciLocalRoot>/archive and the per-user lanes directory (scripts/machine/home.mjs lanesDefault). */
8
+ /** config.yaml `roots` - {archive?, lanes?, temp?}: absolute directories, or null; an absent key means <starciLocalRoot>/archive and the per-user lanes directory. */
9
9
  export function validateRoots(roots){
10
10
  if(roots===null)return;
11
11
  const bad=invalid('roots');
@@ -1,5 +1,5 @@
1
1
  schema: starci/knowledge-source@1
2
- id: grammar.starci.playbook
2
+ id: grammar.core.playbook
3
3
  title: StarCi Core — playbook
4
4
  purpose: |
5
5
  Which idioms a business shape asks for, and what a supplied reference is allowed to contribute to
@@ -12,7 +12,7 @@ purpose: |
12
12
  has yet shown them twice; `guidance` holds the rules every Core app built on them follows.
13
13
  appliesTo:
14
14
  - grammar
15
- family: starci
15
+ family: core
16
16
  provenance:
17
17
  publicEntry: "@starci/grammar/common"
18
18
  package: "@starci/grammar"
@@ -269,7 +269,7 @@ shapes:
269
269
  by presentation.groupIdentity.
270
270
  notes: |
271
271
  FE-RULE-OWNERSHIP in knowledge/patterns/fe/index.yaml separates universal app-shell semantics
272
- from these family APIs, values, shapes and effects. @starci/eslint-grammar-starci owns their
272
+ from these family APIs, values, shapes and effects. @starci/eslint-grammar-core owns their
273
273
  code checks. Inspect installed Grammar exports and the running shell when proving the recipe.
274
274
 
275
275
  readingSteps:
@@ -24,7 +24,7 @@ guidance:
24
24
  Do not treat this catalog as selecting a default Grammar family. Family choice belongs to the
25
25
  current design specification and its explicit sides.fe.grammar declaration.
26
26
  rationale: |
27
- Silent fallback to StarCi would invent product direction and override an absent/ambiguous design.
27
+ Silent fallback to a family would invent product direction and override an absent/ambiguous design.
28
28
  - id: verify-before-use
29
29
  requirement: |
30
30
  Before applying snapshot APIs or recorded gaps, inspect the selected repository's package
@@ -47,11 +47,11 @@ topics:
47
47
  Generated DNA snapshot of the `@starci/grammar/common` public entry: custom properties,
48
48
  the 110 renderers of its registry, their classes, stamped rule ids and recorded gaps. The DNA owns the observed package
49
49
  version and source inventory. Common supplies anatomy, not colour. The snapshot is drift-checked.
50
- - id: starci
51
- path: starci/index.yaml
52
- title: StarCi Core Grammar
50
+ - id: core
51
+ path: core/index.yaml
52
+ title: Core Grammar
53
53
  summary: |
54
- Historical snapshot of the StarCi Core family — DNA, idioms, playbook (including composing the
54
+ Historical snapshot of the core family — DNA, idioms, playbook (including composing the
55
55
  0.5.0 forms, overlays and navigation chrome) and family boundaries.
56
56
  - id: offset-pop
57
57
  path: offset-pop/index.yaml
@@ -61,16 +61,7 @@ topics:
61
61
  shadow, one pink decision accent with a text-safe accent for text — with DNA, idioms, a
62
62
  mobile-first playbook for playful learning or consumer apps, and family boundaries including two
63
63
  decisions flagged for the family owner.
64
- - id: heritage
65
- path: heritage/DNA.yaml
66
- title: Heritage Grammar
67
- summary: |
68
- Generated snapshot of the Heritage family's parity declaration, arrangement, scoped tokens and Common renderers.
69
64
  families:
70
- - id: heritage
71
- title: heritage
72
- contractRef: common
73
- packageSnapshot: heritage/DNA.yaml
74
65
  - id: common
75
66
  title: common
76
67
  componentContract:
@@ -85,18 +76,18 @@ families:
85
76
  (`defineGrammarFamily`), not a family that ships a palette, so `authority`, `reusableStyle`,
86
77
  `productComposition` and `index` have nothing to name here. Universal semantics, renderer anatomy,
87
78
  state and accessibility remain owned by knowledge/ui.
88
- - id: starci
89
- title: starci
79
+ - id: core
80
+ title: core
90
81
  contractRef: common
91
82
  lint:
92
- package: '@starci/eslint-grammar-starci'
93
- factory: starciGrammarConfig
83
+ package: '@starci/eslint-grammar-core'
84
+ factory: coreGrammarConfig
94
85
  prefix: starci-grammar
95
- authority: starci/family.yaml
96
- packageSnapshot: starci/DNA.yaml
97
- reusableStyle: starci/idioms.yaml
98
- productComposition: starci/playbook.yaml
99
- index: starci/index.yaml
86
+ authority: core/family.yaml
87
+ packageSnapshot: core/DNA.yaml
88
+ reusableStyle: core/idioms.yaml
89
+ productComposition: core/playbook.yaml
90
+ index: core/index.yaml
100
91
  - id: offset-pop
101
92
  title: offset-pop
102
93
  contractRef: common
@@ -289,14 +289,14 @@ guidance:
289
289
  presentation:
290
290
  font:
291
291
  ownership: FE-RULE-OWNERSHIP
292
- inherits: starci
292
+ inherits: core
293
293
  contract: |
294
294
  Offset Pop keeps Common typography renderers and props. Its font proof reads the shared Common
295
295
  rank-to-renderer recipes in the StarCi playbook; the Offset Pop stylesheet owns its family palette
296
296
  and display treatment.
297
297
  padding:
298
298
  ownership: FE-RULE-OWNERSHIP
299
- inherits: starci
299
+ inherits: core
300
300
  contract: |
301
301
  Offset Pop keeps the same Common spacing and component geometry. Its padding proof reads the
302
302
  shared Common recipes declared in the StarCi playbook; it supplies no replacement inset scale.
@@ -21,7 +21,7 @@ pins:
21
21
  install: registry
22
22
  side: fe
23
23
  source: packages/heroicons/package.json
24
- why: 'StarCi custom Heroicons-compatible cuts; eslint-grammar-starci (icon.mjs) admits @starci/heroicons/24/outline and /16/solid as icon sources, so an app that uses them gets this exact version.'
24
+ why: 'StarCi custom Heroicons-compatible cuts; eslint-grammar-core (icon.mjs) admits @starci/heroicons/24/outline and /16/solid as icon sources, so an app that uses them gets this exact version.'
25
25
  '@starci/event-stream':
26
26
  version: 0.1.0
27
27
  group: starci
@@ -30,61 +30,61 @@ pins:
30
30
  source: packages/event-stream/package.json
31
31
  why: 'the one server-sent-events client of every front end (fe-stack event-stream, owner:event-stream-package): the transport client layer (modules/api/sse/clients) creates one instance for the app with the bearer token source and the stream operations follow on it; it carries Last-Event-ID resume, the capped doubling backoff, the heartbeat timeout, the single 401 renewal and the useSWRSubscription adapter, so no app keeps a hand-written reader.'
32
32
  '@starci/grammar':
33
- version: 0.12.14
33
+ version: 0.14.0
34
34
  group: starci
35
35
  install: registry
36
36
  side: fe
37
37
  source: packages/grammar/package.json
38
38
  why: 'the grammar front ends read: the brand layer sets `--font-sans` and `--font-mono` and the grammar reads them; it carries the Input tel kind, the copyable and read-only Input, the IconButton disclosure props and count badge, ChatBubble, FillViewport, Textarea mentions and Enter-to-send, the leading PrimaryRailLayout rail, the plate-less Image, ListRow, the soft Alert, Progress steps, the floating primary IconButton, FlowGraph, the STATE-8 loading views and the bordered selectable TagGroup chips. The runtime source version wins for a @starci package.'
39
39
  '@starci/eslint-canon-be':
40
- version: 3.4.56
40
+ version: 3.5.0
41
41
  group: starci
42
42
  install: registry
43
43
  side: be
44
- source: packages/eslint/be/package.json
44
+ source: packages/eslint-canon-be/package.json
45
45
  why: 'the back-end ESLint canon: `loadHfs(import.meta.url)` of be/eslint.config.mjs finds the app-root hfs.json (kind app) and gives every linted file the view of the be side, and the project graph is built per side; its bundled runtime copies (slots, canon-pins, failure codes, the architecture machine) put .starcistacks and .sops.yaml at the app root; `starciBeConfig({ hfs: loadHfs(import.meta.url) })` is the typed factory and the BE-CONVENTION laws are its rules.'
46
46
  '@starci/eslint-canon-fe':
47
- version: 9.1.10
47
+ version: 9.3.0
48
48
  group: starci
49
49
  install: registry
50
50
  side: fe
51
- source: packages/eslint/fe/package.json
51
+ source: packages/eslint-canon-fe/package.json
52
52
  why: 'the front-end ESLint canon: `loadHfs(import.meta.url)` of fe/eslint.config.mjs finds the app-root hfs.json (kind app) and gives every linted file the view of the fe side, and the project graph is built per side; its bundled runtime copies (slots, canon-pins, failure codes, the architecture machine) put .starcistacks and .sops.yaml at the app root; the front end has no tests (FE_NO_TESTS R97 in hfs) and no-vietnamese-in-source (R91) applies.'
53
- '@starci/eslint-grammar-starci':
54
- version: 0.12.14
53
+ '@starci/eslint-grammar-core':
54
+ version: 0.14.0
55
55
  group: starci
56
56
  install: registry
57
57
  side: fe
58
- source: packages/eslint/grammar-starci/package.json
58
+ source: packages/eslint-grammar-core/package.json
59
59
  why: 'the StarCi Grammar component API lint, versioned with @starci/grammar; front ends compose this family package with the universal FE canon.'
60
60
  '@starci/eslint-grammar-offset-pop':
61
- version: 0.12.14
61
+ version: 0.14.0
62
62
  group: starci
63
63
  install: registry
64
64
  side: fe
65
- source: packages/eslint/grammar-offset-pop/package.json
65
+ source: packages/eslint-grammar-offset-pop/package.json
66
66
  why: 'the Offset Pop Grammar component API lint, versioned with @starci/grammar; its shared component contract comes from the StarCi family lint without copying rules.'
67
67
  '@starci/stylelint-canon':
68
- version: 2.0.13
68
+ version: 2.1.0
69
69
  group: starci
70
70
  install: registry
71
71
  side: fe
72
- source: packages/stylelint/package.json
72
+ source: packages/stylelint-canon/package.json
73
73
  why: 'the front-end stylelint canon: no-class-selector refuses a compound class selector (`div.card`); the brand layer accepts `--font-sans` and `--font-mono`; status-contrast measures the HeroUI soft pairs per theme; brand-layer-shape reads the shared :root,.light,.dark block and the info soft pair; appTokens come from loadAppTokens(import.meta.url) for the managed one-line stylelint.config.mjs.'
74
74
  '@starci/tsconfig':
75
- version: 2.0.7
75
+ version: 2.0.8
76
76
  group: starci
77
77
  install: registry
78
78
  side: both
79
79
  source: packages/tsconfig/package.json
80
80
  '@starci/prettier-config':
81
- version: 1.0.4
81
+ version: 1.0.5
82
82
  group: starci
83
83
  install: registry
84
84
  side: both
85
85
  source: packages/prettier-config/package.json
86
86
  '@starci/jest-preset':
87
- version: 2.3.6
87
+ version: 2.3.7
88
88
  group: starci
89
89
  install: registry
90
90
  side: be
@@ -97,20 +97,20 @@ pins:
97
97
  side: be
98
98
  source: packages/test-world/package.json
99
99
  why: 'the shared e2e library of every back end (R47, R48), a devDependency of every back end: the warm stack behind toxiproxy, the network-edge fakes, the Nest boot, the typed useTestWorld handle, useSandbox for contract specs and the outage lock. Kafka is real own infra (the one digest-pinned apache/kafka KRaft image, a broker listener and proxy per slot, slot-prefixed topics, consumer groups and client ids) and Postgres is schema-per-context (a schema and a login role per context in a shared database). Each worker has its own data slot (<ns>_w<k>) with its own databases, Keycloak realm, leased Redis DB, bucket/collection/topic prefixes, fakes host, toxiproxy proxies and outage lock; a run provisions min(jest workers, workers cap, default 2) slots, and state file protocol 2 pairs exactly with @starci/jest-preset (TEST_WORLD_PAIR_MISMATCH otherwise). A modules world boots real peer apps beside its modules, world.apps.<name>.during(fn) is the outage of a peer app, w.keycloak.clientSecret(client) answers the run-generated secret of a confidential realm client, world.keycloak.events/sessions read the realm user events and live sessions, world.infra.postgresql.connection(name) takes one database connection down while the others serve, and world.resolve and scope.resolve take any Nest token. Every path a declaration names (`stack`, seeds, the realm, Dockerfiles) resolves from the app root (the directory of hfs.json); the globalSetup registers the path aliases as TypeScript resolves them. Its CLI main is exported at ./cli for starci app stack.'
100
- '@starci/cli':
101
- version: 1.7.47
100
+ 'starci-harness':
101
+ version: 1.1.0-alpha.1
102
102
  group: starci
103
103
  install: registry
104
104
  side: both
105
- source: packages/cli/package.json
106
- why: 'the only StarCi command package; product repositories install it for starci app, while @starci/hfs remains its pinned transitive implementation.'
105
+ source: cli/package.json
106
+ why: 'the one StarCi command line (bins starci and starci-harness): a product repository installs it for starci app, which it runs in-process through its exact @starci/hfs dependency, and its codegen loads starci-harness/input-bounds.'
107
107
  '@starci/hfs':
108
- version: 4.7.47
108
+ version: 4.9.0
109
109
  group: starci
110
110
  install: registry
111
111
  side: both
112
112
  source: packages/hfs/package.json
113
- why: 'the transitive app implementation used by @starci/cli; it carries the generated runtime slice read by starci app commands.'
113
+ why: 'the app implementation starci-harness runs for starci app; it carries the generated runtime slice read by starci app commands.'
114
114
  # --- tooling
115
115
  typescript:
116
116
  version: 5.9.3
@@ -406,7 +406,7 @@ pins:
406
406
  version: 2.2.0
407
407
  group: ui
408
408
  side: fe
409
- why: 'the base of the one application icon set (fe-stack icons, with @starci/heroicons for the glyphs it lacks); eslint-grammar-starci (icon.mjs) admits @heroicons/react/24/outline and /16/solid.'
409
+ why: 'the base of the one application icon set (fe-stack icons, with @starci/heroicons for the glyphs it lacks); eslint-grammar-core (icon.mjs) admits @heroicons/react/24/outline and /16/solid.'
410
410
  '@dicebear/core':
411
411
  version: 10.4.0
412
412
  group: ui
@@ -251,7 +251,7 @@ concerns:
251
251
  why: the canon lint and format configuration.
252
252
  - id: grammar-lint
253
253
  tier: opt
254
- packages: ['@starci/eslint-grammar-starci', '@starci/eslint-grammar-offset-pop']
254
+ packages: ['@starci/eslint-grammar-core', '@starci/eslint-grammar-offset-pop']
255
255
  home: [fe.source-root-pinned]
256
256
  pattern: FE-RULE-OWNERSHIP
257
257
  forbids: []