@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.
- package/CHANGELOG.md +18 -0
- package/README.md +4 -9
- package/emit/operation-schemas.mjs +3 -0
- package/lint/bound-sys.cjs +2 -2
- package/package.json +11 -5
- package/runtime/engine/admission.mjs +1 -1
- package/runtime/engine/config.mjs +2 -2
- package/runtime/engine/db/machine.mjs +2 -3
- package/runtime/engine/invalid-config.mjs +1 -1
- package/runtime/knowledge/grammars/{starci → core}/playbook.yaml +3 -3
- package/runtime/knowledge/grammars/index.yaml +14 -23
- package/runtime/knowledge/grammars/offset-pop/playbook.yaml +2 -2
- package/runtime/knowledge/hfs/canon-pins.yaml +23 -23
- package/runtime/knowledge/hfs/fe-stack.yaml +1 -1
- package/runtime/knowledge/hfs/rules.yaml +83 -60
- package/runtime/modules/kernel/failure-codes.yaml +23 -13
- package/runtime/scripts/guards/git-policy.mjs +2 -3
- package/runtime/scripts/hfs/rule-catalog.mjs +2 -2
- package/runtime/scripts/hfs/rules/pipeline.mjs +5 -5
- package/runtime/scripts/lib/example-refs.mjs +10 -3
- package/runtime/scripts/lib/grammar-lint.mjs +16 -3
- package/runtime/scripts/lib/package-at.mjs +5 -6
- package/runtime/scripts/lib/roots.mjs +2 -2
- package/runtime/scripts/work/draw/draw-dna-findings.mjs +23 -12
- package/runtime/scripts/work/draw/draw-dna.mjs +14 -8
- package/scaffold/app.mjs +6 -6
- package/src/main.mjs +3 -3
- package/sync/hygiene.mjs +1 -1
- package/sync/index.mjs +15 -2
- package/sync/managed.mjs +3 -2
- package/templates/app/codegen-graphql.mjs.partial +4 -4
- package/templates/app/quality-config/sonar-project.properties +4 -2
- package/runtime/engine/canonical-json.mjs +0 -14
- package/runtime/engine/db/ledger-open.mjs +0 -38
- package/runtime/engine/db/ledger-paths.mjs +0 -87
- package/runtime/engine/db/ledger.mjs +0 -1068
- package/runtime/engine/db/provision-authority.mjs +0 -76
- package/runtime/engine/db/provision-operations.mjs +0 -146
- package/runtime/packages/grammar/scripts/build-stamp.mjs +0 -98
- package/runtime/scripts/agent/codex-app-server.mjs +0 -79
- package/runtime/scripts/agent/codex-mirror-source.mjs +0 -34
- package/runtime/scripts/agent/host-agents.mjs +0 -80
- package/runtime/scripts/agent/launch-trust-policy.mjs +0 -53
- package/runtime/scripts/agent/trust-launch.mjs +0 -191
- package/runtime/scripts/agent/trust.mjs +0 -523
- package/runtime/scripts/api/fs/temp-path.mjs +0 -8
- package/runtime/scripts/api/git/diff-names.mjs +0 -8
- package/runtime/scripts/api/git/head-time.mjs +0 -10
- package/runtime/scripts/api/git/index-lock.mjs +0 -78
- package/runtime/scripts/api/git/log.mjs +0 -5
- package/runtime/scripts/api/git/merge-tree.mjs +0 -5
- package/runtime/scripts/api/git/rev-list.mjs +0 -5
- package/runtime/scripts/api/git/rev-parse.mjs +0 -13
- package/runtime/scripts/api/git/status-query.mjs +0 -5
- package/runtime/scripts/api/git/worktree-list-query.mjs +0 -5
- package/runtime/scripts/api/node/spawn-node.mjs +0 -6
- package/runtime/scripts/api/npm/dist-tag.mjs +0 -8
- package/runtime/scripts/api/npm/lib.mjs +0 -32
- package/runtime/scripts/api/npm/pack-dry-run.mjs +0 -9
- package/runtime/scripts/api/npm/run-npm.mjs +0 -6
- package/runtime/scripts/api/npm/view.mjs +0 -30
- package/runtime/scripts/api/npm/whoami.mjs +0 -8
- package/runtime/scripts/api/process/hide-child-windows.mjs +0 -31
- package/runtime/scripts/api/process/kill-tree.mjs +0 -22
- package/runtime/scripts/api/process/lib.mjs +0 -125
- package/runtime/scripts/api/process/probe-guard-command.mjs +0 -74
- package/runtime/scripts/api/process/process-list.mjs +0 -28
- package/runtime/scripts/api/process/system-tool.mjs +0 -37
- package/runtime/scripts/gates/canon-digest.mjs +0 -81
- package/runtime/scripts/gates/canon-pins.mjs +0 -119
- package/runtime/scripts/gates/gate-input.mjs +0 -98
- package/runtime/scripts/gates/gate.mjs +0 -636
- package/runtime/scripts/gates/grammar-dist.mjs +0 -206
- package/runtime/scripts/gates/output.mjs +0 -40
- package/runtime/scripts/gates/runtime-package-selection.mjs +0 -27
- package/runtime/scripts/gates/test-world-run.mjs +0 -252
- package/runtime/scripts/gates/type-impact.mjs +0 -277
- package/runtime/scripts/gates/type-program.mjs +0 -113
- package/runtime/scripts/guards/assigned-command.mjs +0 -12
- package/runtime/scripts/guards/call-rights.mjs +0 -47
- package/runtime/scripts/guards/command-guard.mjs +0 -468
- package/runtime/scripts/guards/command-policy.mjs +0 -342
- package/runtime/scripts/guards/critic-reach.mjs +0 -82
- package/runtime/scripts/guards/deps-guard.mjs +0 -150
- package/runtime/scripts/guards/env-dump-verdict.mjs +0 -89
- package/runtime/scripts/guards/guards-root.mjs +0 -27
- package/runtime/scripts/guards/hook-install.mjs +0 -343
- package/runtime/scripts/guards/hook-verdict.mjs +0 -12
- package/runtime/scripts/guards/install-verdict.mjs +0 -41
- package/runtime/scripts/guards/kernel-seat.mjs +0 -63
- package/runtime/scripts/guards/launch-verdict.mjs +0 -74
- package/runtime/scripts/guards/op-starci.mjs +0 -16
- package/runtime/scripts/guards/op-write-scope.mjs +0 -27
- package/runtime/scripts/guards/orca-self-lifecycle.mjs +0 -39
- package/runtime/scripts/guards/process-kill-verdict.mjs +0 -106
- package/runtime/scripts/guards/protected-zone.mjs +0 -56
- package/runtime/scripts/guards/refusals.mjs +0 -27
- package/runtime/scripts/guards/rights.mjs +0 -268
- package/runtime/scripts/guards/seat-tools.mjs +0 -47
- package/runtime/scripts/guards/shell-commands.mjs +0 -328
- package/runtime/scripts/guards/supervisor-seat.mjs +0 -80
- package/runtime/scripts/guards/verdict-process.mjs +0 -81
- package/runtime/scripts/lib/app-data.mjs +0 -11
- package/runtime/scripts/lib/canon-binding-text.mjs +0 -129
- package/runtime/scripts/lib/check-format.mjs +0 -7
- package/runtime/scripts/lib/failure-code-reads.mjs +0 -100
- package/runtime/scripts/lib/failure-code-template-errors.mjs +0 -161
- package/runtime/scripts/lib/git-dir.mjs +0 -120
- package/runtime/scripts/lib/guard-command.mjs +0 -24
- package/runtime/scripts/lib/interrupt-cleanup.mjs +0 -38
- package/runtime/scripts/lib/json-formats.mjs +0 -34
- package/runtime/scripts/lib/managed-json.mjs +0 -51
- package/runtime/scripts/lib/menu-parts.mjs +0 -11
- package/runtime/scripts/lib/op-gate.mjs +0 -15
- package/runtime/scripts/lib/provision-control-failure.mjs +0 -32
- package/runtime/scripts/lib/release-version.mjs +0 -134
- package/runtime/scripts/lib/runtime-location.mjs +0 -21
- package/runtime/scripts/lib/runtime-package-inventory.mjs +0 -21
- package/runtime/scripts/lib/runtime-package-manifests.mjs +0 -84
- package/runtime/scripts/lib/runtime-publication-tags.mjs +0 -56
- package/runtime/scripts/lib/seat-env.mjs +0 -43
- package/runtime/scripts/lib/sonar-new-code.mjs +0 -58
- package/runtime/scripts/lib/source-package-imports.mjs +0 -111
- package/runtime/scripts/lib/tar-files.mjs +0 -39
- package/runtime/scripts/lib/uat-run-folder.mjs +0 -118
- package/runtime/scripts/lib/worktree-record.mjs +0 -14
- package/runtime/scripts/machine/ask-receipts.mjs +0 -113
- package/runtime/scripts/machine/evidence-store.mjs +0 -223
- package/runtime/scripts/machine/home.mjs +0 -216
- package/runtime/scripts/machine/host-lock.mjs +0 -184
- package/runtime/scripts/machine/lock-recovery.mjs +0 -55
- package/runtime/scripts/machine/roles-contract.mjs +0 -90
- package/runtime/scripts/machine/runtime-change.mjs +0 -20
- package/runtime/scripts/machine/workflow-tree.mjs +0 -122
- package/runtime/scripts/reconciler/checklist-items.mjs +0 -7
- package/runtime/scripts/reconciler/guard-row.mjs +0 -25
- package/runtime/scripts/work/brand/brand-colour.mjs +0 -125
- package/runtime/scripts/work/brand/brand-tokens.mjs +0 -167
- package/runtime/scripts/work/brand/brand-value-source.mjs +0 -106
- package/runtime/scripts/work/brand/brand.mjs +0 -892
- package/runtime/scripts/work/draw/draw-layer.mjs +0 -306
- package/runtime/scripts/work/draw/draw-rationale-page.mjs +0 -237
- package/runtime/scripts/work/draw/draw-rationale-ref.mjs +0 -14
- package/runtime/scripts/work/draw/draw-rationale.mjs +0 -353
- package/runtime/scripts/work/draw/draw-source.mjs +0 -412
- package/runtime/scripts/work/draw/draw-taste.mjs +0 -278
- package/runtime/scripts/work/draw/draw-typecheck.mjs +0 -72
- package/runtime/scripts/work/draw/rationale-findings.mjs +0 -205
- package/runtime/scripts/work/draw-grammar.mjs +0 -175
- package/runtime/scripts/work/draw-render-page.mjs +0 -188
- package/runtime/scripts/work/draw-render.mjs +0 -626
- package/runtime/scripts/work/png.mjs +0 -237
- 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/`
|
|
196
|
-
`scripts/hfs/architecture.mjs
|
|
197
|
-
|
|
198
|
-
|
|
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
|
}
|
package/lint/bound-sys.cjs
CHANGED
|
@@ -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
|
|
8
|
-
// tsc
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
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:
|
|
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-
|
|
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
|
|
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:
|
|
51
|
-
path:
|
|
52
|
-
title:
|
|
50
|
+
- id: core
|
|
51
|
+
path: core/index.yaml
|
|
52
|
+
title: Core Grammar
|
|
53
53
|
summary: |
|
|
54
|
-
Historical snapshot of 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:
|
|
89
|
-
title:
|
|
79
|
+
- id: core
|
|
80
|
+
title: core
|
|
90
81
|
contractRef: common
|
|
91
82
|
lint:
|
|
92
|
-
package: '@starci/eslint-grammar-
|
|
93
|
-
factory:
|
|
83
|
+
package: '@starci/eslint-grammar-core'
|
|
84
|
+
factory: coreGrammarConfig
|
|
94
85
|
prefix: starci-grammar
|
|
95
|
-
authority:
|
|
96
|
-
packageSnapshot:
|
|
97
|
-
reusableStyle:
|
|
98
|
-
productComposition:
|
|
99
|
-
index:
|
|
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:
|
|
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:
|
|
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-
|
|
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.
|
|
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.
|
|
40
|
+
version: 3.5.0
|
|
41
41
|
group: starci
|
|
42
42
|
install: registry
|
|
43
43
|
side: be
|
|
44
|
-
source: packages/eslint
|
|
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.
|
|
47
|
+
version: 9.3.0
|
|
48
48
|
group: starci
|
|
49
49
|
install: registry
|
|
50
50
|
side: fe
|
|
51
|
-
source: packages/eslint
|
|
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-
|
|
54
|
-
version: 0.
|
|
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
|
|
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.
|
|
61
|
+
version: 0.14.0
|
|
62
62
|
group: starci
|
|
63
63
|
install: registry
|
|
64
64
|
side: fe
|
|
65
|
-
source: packages/eslint
|
|
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
|
|
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.
|
|
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.
|
|
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.
|
|
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
|
-
'
|
|
101
|
-
version: 1.
|
|
100
|
+
'starci-harness':
|
|
101
|
+
version: 1.1.0-alpha.1
|
|
102
102
|
group: starci
|
|
103
103
|
install: registry
|
|
104
104
|
side: both
|
|
105
|
-
source:
|
|
106
|
-
why: 'the
|
|
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.
|
|
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
|
|
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-
|
|
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-
|
|
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: []
|