@orkestrel/scaffold 0.0.130 → 0.0.132
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/dist/bin/main.js +48 -45
- package/dist/bin/main.js.map +1 -1
- package/dist/host/agents/orchestration.md +4 -3
- package/dist/host/agents/platforms/windows.md +1 -0
- package/dist/host/agents/skills/orkestrel-polish/SKILL.md +1 -0
- package/dist/host/claude/agents/orkestrel.md +32 -32
- package/dist/host/claude/rules/patterns.md +2 -0
- package/dist/host/configs/helpers.ts +2 -2
- package/dist/host/guides/agent.md +228 -152
- package/dist/host/guides/contract.md +26 -5
- package/dist/host/guides/database.md +43 -37
- package/dist/host/guides/scaffold.md +15 -8
- package/dist/host/manifest.json +12 -12
- package/dist/host/tests/config.test.ts +3 -3
- package/dist/src/core/index.cjs +23 -16
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.d.cts +5 -2
- package/dist/src/core/index.d.ts +5 -2
- package/dist/src/core/index.js +23 -16
- package/dist/src/core/index.js.map +1 -1
- package/package.json +10 -10
|
@@ -521,6 +521,7 @@ Declarative constructors for the `ContractShape` union (`src/core/shapers.ts`).
|
|
|
521
521
|
| `stringShape` | function | `(options?: StringShapeOptions) => StringShape` | Builds a string `StringShape`. |
|
|
522
522
|
| `numberShape` | function | `(options?: NumberShapeOptions) => NumberShape` | Builds a numeric `NumberShape`. |
|
|
523
523
|
| `integerShape` | function | `(options?: Omit<NumberShapeOptions, 'integer'>) => NumberShape` | Builds an integer `NumberShape` — forces `integer: true`. |
|
|
524
|
+
| `dateShape` | function | `(options?: Omit<StringShapeOptions, 'date' \| 'pattern'>) => StringShape` | Builds a calendar-date `StringShape` — forces `date: true`. |
|
|
524
525
|
| `booleanShape` | function | `(options?: BooleanShapeOptions) => BooleanShape` | Builds a `BooleanShape`. |
|
|
525
526
|
| `nullShape` | function | `(options?: NullShapeOptions) => NullShape` | Builds a `NullShape`. |
|
|
526
527
|
| `literalShape` | function | `<const T extends readonly LiteralValue[]>(values: T, options?: LiteralShapeOptions) => LiteralShape<Readonly<T>>` | Builds a literal shape from a fixed set of primitive values. |
|
|
@@ -541,6 +542,23 @@ An ordinary `oneOfShape` parser returns the input itself when exactly one arm ac
|
|
|
541
542
|
|
|
542
543
|
**String bounds count code points.** `min` and `max` on a string count what the `minLength` and `maxLength` the shape emits count, so one astral character has a length of one and a lone surrogate counts as one. `stringOf` and the two reports share `matchesStringLength`, which decides from `.length` where it can: a string holds at most `.length` code points and at least half that. Only where a bound sits between those two figures does it call `computeSurrogatePairs`, which stops as soon as the pairs it has found settle the bound.
|
|
543
544
|
|
|
545
|
+
**Calendar dates.** `dateShape` builds a string shape whose guard and parser admit exactly a calendar-valid `YYYY-MM-DD` and coerce nothing, so `2026-02-30`, `2026-1-10`, a date-time, and a `Date` object all refuse. A refused date reports a `'constraint'` fault with `expected: 'date'` and `constraint: 'date'`, as a fraction against `integerShape` reports `'integer'`, and the emitted schema carries `format: 'date'` with no `pattern`. A strict `schemaToShape` reads that schema back as the date shape; a lenient one keeps `format` an annotation and builds a plain string shape. A string shape that declares both `date` and `pattern`, or bounds that exclude length 10, refuses at build.
|
|
546
|
+
|
|
547
|
+
This compiles a date field and shows what it admits, refuses, reports, and emits.
|
|
548
|
+
|
|
549
|
+
```ts
|
|
550
|
+
import { createContract, dateShape, objectShape } from '@orkestrel/contract'
|
|
551
|
+
|
|
552
|
+
const booking = createContract(objectShape({ arrival: dateShape() }))
|
|
553
|
+
|
|
554
|
+
booking.is({ arrival: '2024-02-29' }) // true
|
|
555
|
+
booking.is({ arrival: '2026-02-29' }) // false — 2026 is not a leap year
|
|
556
|
+
booking.parse({ arrival: '2026-1-10' }) // undefined
|
|
557
|
+
booking.audit({ arrival: '2026-02-30' })
|
|
558
|
+
// [{ reason: 'constraint', path: ['arrival'], expected: 'date', constraint: 'date', received: '"2026-02-30"' }]
|
|
559
|
+
booking.schema.properties?.arrival // { type: 'string', format: 'date' }
|
|
560
|
+
```
|
|
561
|
+
|
|
544
562
|
**Field defaults.** `optionalShape(inner, { default })` lets a declaration state what an absent field reads as. The compiled parser fills the default where the property is absent or `undefined`, through the inner parser, on a fresh copy when the default is a container, so nested defaults apply and two parses share no tree. A default on a `jsonShape`, a `rawShape`, or a union inner reaches you as a frozen copy, because those parsers return their input by identity. `is`, `audit`, `explain`, and `generate` do not read a default: an absent optional stays canonical, so `is({})` is `true`, and `generate` keeps omitting the key or drawing from `inner`. The emitted property schema carries the keyword. `null` is a value and fills; a present `undefined` is a `structure` refusal, because absence is not a value.
|
|
545
563
|
|
|
546
564
|
The builder and `cloneShape` own a frozen copy of a value that passes `isJSONValue`, so a stored shape survives a JSON round trip. Every compiler refuses a default its `inner` guard refuses, refinements included, with code `structure` at `[…path, 'default']`: a restored declaration never met a builder, and `validateShape` judges structure only. A shape holding a default builds the guard family for that check whichever artifact you read first; a shape holding none builds what it always built.
|
|
@@ -578,7 +596,7 @@ The precedence below assumes a readable node and a lenient conversion. A readabl
|
|
|
578
596
|
|
|
579
597
|
A lenient conversion carries a property's `default` when the key is not in `required`, the object is closed with no union ancestor, and the value is one the property's primitive or literal guard accepts. It drops every other `default`, because a carried default that cannot compile would end the conversion's totality.
|
|
580
598
|
|
|
581
|
-
**Strict conversion.** `schemaToShape(schema, { strict: true })` is the door for a foreign schema. It refuses, with code `structure` and the keyword's path, what the lenient walk would widen or read past: every node the walk would widen to `rawShape` (an empty schema, a `type` typo at any depth, a non-record child, an array with no `items`, exhausted depth, and a cycle), a keyword outside `STRICT_SCHEMA_KEYWORDS` (`$ref`, `$defs`, `definitions`, `const`, `allOf`, `$anchor`, `$dynamicAnchor`, the `content*` keywords, `nullable`, `discriminator`, `example`, `patternProperties`, `propertyNames`, and `prefixItems`), `pattern` and `format
|
|
599
|
+
**Strict conversion.** `schemaToShape(schema, { strict: true })` is the door for a foreign schema. It refuses, with code `structure` and the keyword's path, what the lenient walk would widen or read past: every node the walk would widen to `rawShape` (an empty schema, a `type` typo at any depth, a non-record child, an array with no `items`, exhausted depth, and a cycle), a keyword outside `STRICT_SCHEMA_KEYWORDS` (`$ref`, `$defs`, `definitions`, `const`, `allOf`, `$anchor`, `$dynamicAnchor`, the `content*` keywords, `nullable`, `discriminator`, `example`, `patternProperties`, `propertyNames`, and `prefixItems`), `pattern` and every `format` but `'date'` on a string node, which no compiled shape asserts, a `format: 'date'` whose length bounds exclude length 10, a malformed keyword value or annotation, a boolean schema, an `enum` entry that is neither a finite primitive nor `null`, a contradictory or malformed bound, a keyword the node's type never reads, a `type` beside a union, a pair of keywords only one of which the walk would keep, an enum member its `type` contradicts, a `required` name not in `properties`, breadth past `INFER_BREADTH_LIMIT`, and a `default` with no optional property to fill or one its schema refuses. `oneOf` keeps exactly-one here, because this walk reads every keyword that could keep two arms apart. An object with no `additionalProperties` closes, unlike JSON Schema's own default, because a misspelled key at a foreign door must reach `audit`; an explicit `true` or schema value stays open. Below a `oneOf` it refuses instead, at any depth, because closing it could change which arms match: two arms declaring optional `a` and `b` both match `{ a: 'x' }` as written, and only one does once closed. It accepts the annotations a schema generator emits, which assert nothing and which the shape drops: `title`, `$schema`, `$id`, and `$comment` when strings, `examples` when an array, and `deprecated`, `readOnly`, and `writeOnly` when booleans. A default under a union or on an open object refuses with `placement` at its path in the schema, ending `properties`, the key, and `default`.
|
|
582
600
|
|
|
583
601
|
**Round-trip law:** for any READABLE value `v` — including `NaN`, `±Infinity`, a `Map`, a `Set`, a class instance, a function, a symbol, a bigint, and readable cyclic hosts — `compileGuard(schemaToShape(valueToSchema(v)))(v) === true`, with widening as the ONLY source of looseness, never narrowing. An unreadable host is refused before the law produces a schema. The law otherwise retains its three limits: JSON absence, `Date` serialization, and unstable reads between inference and validation. A widened node cannot be auto-generated: `createContract(schemaToShape(x)).generate()` throws when the conversion widened anywhere; its parser returns `undefined` for readable invalid input and propagates the shared coded refusal when a required read fails.
|
|
584
602
|
|
|
@@ -602,7 +620,7 @@ what the resolution produces.
|
|
|
602
620
|
| Name | Kind | Signature | Summary |
|
|
603
621
|
| ---------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
604
622
|
| `ContractShape` | type | `StringShape \| NumberShape \| BooleanShape \| NullShape \| LiteralShape \| ArrayShape \| ObjectShape \| UnionShape \| OptionalShape \| NullableShape \| JSONShape \| ShapeShape \| RawShape` | Describes a value declaratively — a declaration the shape builders build and the compilers turn into a guard, a parser, a JSON Schema, and a generator. |
|
|
605
|
-
| `StringShape` | interface | `{ category, min?, max?, pattern?, description? }`
|
|
623
|
+
| `StringShape` | interface | `{ category, min?, max?, pattern?, date?, description? }` | Describes a string with optional length, pattern, and calendar-date constraints. |
|
|
606
624
|
| `NumberShape` | interface | `{ category, min?, max?, integer?, description? }` | Describes a number with optional bounds; `integer` restricts to whole numbers. |
|
|
607
625
|
| `BooleanShape` | interface | `{ category, description? }` | Describes a boolean — accepts only `true` or `false`. |
|
|
608
626
|
| `NullShape` | interface | `{ category, description? }` | Describes a null value — accepts only `null`. |
|
|
@@ -620,7 +638,7 @@ what the resolution produces.
|
|
|
620
638
|
| `InferOpenIndex` | type | `[A] extends [false] ? unknown : [A] extends [true] ? { readonly [k: string]: unknown; } : [A] extends [ContractShape] ? { readonly [k: string]: unknown; } : unknown` | Computes the index-signature contribution of a MIXED object shape's `additionalProperties` — one with both fixed `properties` and an open tail. |
|
|
621
639
|
| `InferMutable` | type | `{ -readonly [K in keyof Infer<S>]: Infer<S>[K]; }` | Strips the TOP-LEVEL `readonly` modifiers from `Infer` (a shallow strip — nested object/array properties stay readonly) — for consumers writing the parsed value's own fields. |
|
|
622
640
|
| `InferUnion` | type | `V extends ReadonlyArray<infer U> ? (U extends ContractShape ? Infer<U> : never) : never` | Resolves `Infer` of a union shape's `variants` — the union of each variant's inferred type. |
|
|
623
|
-
| `StringShapeOptions` | interface | `{ min?, max?, pattern?, description? }`
|
|
641
|
+
| `StringShapeOptions` | interface | `{ min?, max?, pattern?, date?, description? }` | Groups the options for `StringShape` (through `stringShape`). |
|
|
624
642
|
| `NumberShapeOptions` | interface | `{ min?, max?, integer?, description? }` | Groups the options for `NumberShape` (through `numberShape` / `integerShape`). |
|
|
625
643
|
| `BooleanShapeOptions` | interface | `{ description? }` | Groups the options for `BooleanShape` (through `booleanShape`). |
|
|
626
644
|
| `NullShapeOptions` | interface | `{ description? }` | Groups the options for `NullShape` (through `nullShape`). |
|
|
@@ -718,6 +736,8 @@ The canonicalization leaves (`canonicalStringify`, `encodeLeaf`) and the format-
|
|
|
718
736
|
| `classifyFormat` | function | `(value: string) => SchemaFormat \| undefined` | Classifies an already-bounded string against the pattern-only and calendar-checked `SchemaFormat` vocabulary. |
|
|
719
737
|
| `samplesToFormat` | function | `(values: readonly unknown[]) => SchemaFormat \| undefined` | Classifies a list of sample values against the `SchemaFormat` vocabulary, requiring unanimity. |
|
|
720
738
|
| `matchesISOInstant` | function | `(value: string) => boolean` | Checks whether a supported ISO-8601 date or date-time names a real instant. |
|
|
739
|
+
| `matchesCalendarDate` | function | `(value: string) => boolean` | Checks whether a string is exactly a calendar-valid `YYYY-MM-DD` date. |
|
|
740
|
+
| `computeMonthLength` | function | `(year: number, month: number) => number` | Computes the number of days in a month of the Gregorian calendar. |
|
|
721
741
|
| `ValueToSchemaOptions` | interface | `{ limits?, closed?, format?, enum? }` | Groups the options for `valueToSchema` / `samplesToSchema`. |
|
|
722
742
|
| `ValueToSchemaLimits` | interface | `{ depth?, properties? }` | Holds the per-walk budgets `ValueToSchemaOptions` groups under `limits`. |
|
|
723
743
|
| `SampleMemo` | interface | `{ rows, schemas }` | Holds the per-walk memo the multi-sample walk behind `samplesToSchema` owns, keyed by the ORDERED identities of the rows a slot collected. |
|
|
@@ -728,6 +748,7 @@ The canonicalization leaves (`canonicalStringify`, `encodeLeaf`) and the format-
|
|
|
728
748
|
| `INFER_ENUM_LIMIT` | const | `12` | Caps by default at `12` the number of distinct values a multi-sample slot may hold before enum inference gives up and falls back to a bare `type`, frozen. |
|
|
729
749
|
| `FORMAT_MAX_LENGTH` | const | `128` | Caps at `128` the string length `stringToFormat` attempts to classify, frozen. |
|
|
730
750
|
| `FORMAT_PATTERNS` | const | `Readonly<Record<'uuid' \| 'email' \| 'uri', RegExp>>` | Holds the pure-regex matchers backing `stringToFormat`'s pattern-only formats (`uuid` / `email` / `uri`), frozen as data. |
|
|
751
|
+
| `DATE_LENGTH` | const | `10` | Holds `10`, the length of every `YYYY-MM-DD` date a date string shape admits. |
|
|
731
752
|
|
|
732
753
|
Canonicalization classifies every non-null object at the read boundary before choosing a traversal. Arrays retain the dense indexed path; the shared realm-neutral `matchesRecordBrand` rule selects sorted own keys for ordinary, null-prototype, and foreign-realm plain records; every other readable exotic object — including a class whose prototype a caller reparented to `null` — keeps the existing `JSON.stringify` fallback. A failed prototype inspection is unreadable structure, reported as `canonicalStringify: value could not be read`.
|
|
733
754
|
|
|
@@ -774,8 +795,8 @@ One diagnostic for each artifact that answers yes-or-no. `compileReporter` is th
|
|
|
774
795
|
| `Fault` | type | `{ readonly reason: 'type'; readonly path: FieldPath; readonly expected: FaultKind; readonly received: string; } \| { readonly reason: 'missing'; readonly path: FieldPath; readonly expected: FaultKind; } \| { readonly reason: 'constraint'; readonly path: FieldPath; readonly expected: FaultKind; readonly constraint: FaultConstraint; readonly limit?: number \| string; readonly received: string; } \| { readonly reason: 'variant'; readonly path: FieldPath; readonly variants: number; readonly key?: string; readonly expected?: readonly LiteralValue[]; } \| { readonly reason: 'oneOf'; readonly path: FieldPath; readonly matched: number; readonly key?: string; readonly expected?: readonly LiteralValue[]; }` | Represents a single structured parse-failure diagnostic — one entry of an `ContractInterface.explain` report. |
|
|
775
796
|
| `ExtraFault` | interface | `{ reason, path }` | Represents a key present on a value that its closed object shape does not declare. |
|
|
776
797
|
| `AuditFault` | type | `Fault \| ExtraFault` | Covers every fault an audit reports — the parse faults plus undeclared keys. |
|
|
777
|
-
| `FaultKind` | type | `'string' \| 'number' \| 'integer' \| 'boolean' \| 'null' \| 'literal' \| 'array' \| 'object' \| 'union' \| 'json' \| 'shape'`
|
|
778
|
-
| `FaultConstraint` | type | `'min' \| 'max' \| 'pattern' \| 'integer'`
|
|
798
|
+
| `FaultKind` | type | `'string' \| 'date' \| 'number' \| 'integer' \| 'boolean' \| 'null' \| 'literal' \| 'array' \| 'object' \| 'union' \| 'json' \| 'shape'` | Names the kind of value a `Fault` expected — the shape-projected counterpart of a `ContractShape`'s `category`. |
|
|
799
|
+
| `FaultConstraint` | type | `'min' \| 'max' \| 'pattern' \| 'date' \| 'integer'` | Names the refinement a `Fault` of reason `'constraint'` violates. |
|
|
779
800
|
|
|
780
801
|
#### How a union is audited and reported
|
|
781
802
|
|
|
@@ -5,8 +5,8 @@
|
|
|
5
5
|
> file, SQLite, or IndexedDB.
|
|
6
6
|
|
|
7
7
|
A table is a contract. Declare a `tables` map of
|
|
8
|
-
[`ContractShape`](contract.md)s once, and the row type, write-time
|
|
9
|
-
|
|
8
|
+
[`ContractShape`](contract.md)s once, and the row type, write-time admission,
|
|
9
|
+
JSON-Schema introspection, and seed data all flow from that one
|
|
10
10
|
declaration — no separate schema, no annotations, no `as`.
|
|
11
11
|
|
|
12
12
|
The design stance is one engine, thin drivers. A backend implements only an
|
|
@@ -53,7 +53,7 @@ const db = createDatabase({
|
|
|
53
53
|
|
|
54
54
|
const users = db.table('users') // hold the handle; TableInterface<{ id; name; age }>
|
|
55
55
|
|
|
56
|
-
await users.set({ id: 'u1', name: 'Ada', age: 36 }) //
|
|
56
|
+
await users.set({ id: 'u1', name: 'Ada', age: 36 }) // admitted whole through the contract
|
|
57
57
|
await users.get('u1') // typed { id; name; age } | undefined — narrowed, never `as`
|
|
58
58
|
await users
|
|
59
59
|
.query()
|
|
@@ -68,7 +68,7 @@ never write `objectShape` at the table level. The row type is `Infer` of
|
|
|
68
68
|
those columns, so `db.table('users')` is checked against the schema (a
|
|
69
69
|
typo'd column name or a wrong-typed write fails at compile time) and returns
|
|
70
70
|
a `TableInterface` typed by that row. That one declaration is the single
|
|
71
|
-
source of truth: it types the table, drives write
|
|
71
|
+
source of truth: it types the table, drives write admission,
|
|
72
72
|
produces the JSON Schema, and seeds fixtures.
|
|
73
73
|
|
|
74
74
|
### Factories
|
|
@@ -169,7 +169,9 @@ The constructor installs an own, non-enumerable, non-writable
|
|
|
169
169
|
error itself. `isDatabaseError` accepts branded subclasses across package copies
|
|
170
170
|
and ESM/CJS entries without requiring an exact `name`. It validates the declared
|
|
171
171
|
code and optional context, and refuses unbranded look-alikes, transparent proxies,
|
|
172
|
-
and plain objects carrying only the brand.
|
|
172
|
+
and plain objects carrying only the brand. When the context carries a `faults`
|
|
173
|
+
member, as a `VALIDATION` refusal from `Table` does, the guard requires a list
|
|
174
|
+
whose every entry passes Contract's `isAuditFault` function.
|
|
173
175
|
|
|
174
176
|
### Query engine
|
|
175
177
|
|
|
@@ -525,19 +527,24 @@ These invariants hold across the core database source tree ↔ this guide:
|
|
|
525
527
|
both directions (see `.claude/rules/documentation.md` § Parity). Exported
|
|
526
528
|
implementation declarations outside
|
|
527
529
|
an entry barrel remain internal.
|
|
528
|
-
2. **A table is a contract.** Every write is
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
530
|
+
2. **A table is a contract.** Every write is admitted whole through the
|
|
531
|
+
table's compiled contract — `set` / `add` / `update` run the row through
|
|
532
|
+
Contract's `admitValue`, which admits a lossless repair such as `'36'` to
|
|
533
|
+
`36` for a number column and enforces constraints such as `min` /
|
|
534
|
+
`pattern`. A row that carries an undeclared top-level column, omits a
|
|
535
|
+
required column, or needs a lossy repair such as `'036'` to `36` throws
|
|
536
|
+
`VALIDATION`; the table never removes a column to admit the rest. A
|
|
537
|
+
`rawShape` column admits any defined value, so the nested keys of a JSON
|
|
538
|
+
column never refuse. Reads are narrowed back to the table's row type
|
|
539
|
+
through the guard — never an `as` (see `AGENTS.md` § Non-negotiable
|
|
540
|
+
rules). The row type is the shape's `Infer`, so a `tables` map types every
|
|
541
|
+
table from one declaration. A refusal's context carries `table` and
|
|
542
|
+
`faults`, the `AuditFault` list `admitValue` returned, and its message
|
|
543
|
+
names the table and the first fault through Contract's `describeFaultLine`
|
|
544
|
+
function. A fault's `received` member and the message carry Contract's
|
|
545
|
+
JSON-encoded, length-capped rendering of the received value; the rejected
|
|
546
|
+
row and the parser cause never enter the message, context, serialized
|
|
547
|
+
error, or table events.
|
|
541
548
|
3. **Thin driver, one engine, native overrides.** The required
|
|
542
549
|
`DriverInterface` surface is the irreducible storage primitive — keyed
|
|
543
550
|
read/write/atomic-insert/delete, an ordered `scan`, key listing, and `snapshot`. `open`
|
|
@@ -1213,13 +1220,13 @@ await users.remove(['u1', 'u2']) // → readonly boolean[]
|
|
|
1213
1220
|
A batch runs as independent sequential operations; wrap it in `transaction`
|
|
1214
1221
|
when it must be atomic.
|
|
1215
1222
|
|
|
1216
|
-
###
|
|
1223
|
+
### Admission through the contract
|
|
1217
1224
|
|
|
1218
|
-
|
|
1225
|
+
Admits a numeric string against the table's contract, stores the repaired number, and refuses an undeclared column:
|
|
1219
1226
|
|
|
1220
1227
|
```ts
|
|
1221
|
-
import { createDatabase, createMemoryDriver } from '@orkestrel/database'
|
|
1222
|
-
import { integerShape, stringShape } from '@orkestrel/contract'
|
|
1228
|
+
import { createDatabase, createMemoryDriver, isDatabaseError } from '@orkestrel/database'
|
|
1229
|
+
import { admitValue, integerShape, stringShape } from '@orkestrel/contract'
|
|
1223
1230
|
|
|
1224
1231
|
const users = createDatabase({
|
|
1225
1232
|
driver: createMemoryDriver(),
|
|
@@ -1228,18 +1235,16 @@ const users = createDatabase({
|
|
|
1228
1235
|
},
|
|
1229
1236
|
}).table('users')
|
|
1230
1237
|
|
|
1231
|
-
// A numeric
|
|
1232
|
-
const
|
|
1233
|
-
|
|
1234
|
-
|
|
1235
|
-
|
|
1236
|
-
role: 'member',
|
|
1237
|
-
})
|
|
1238
|
-
if (normalized === undefined) throw new Error('Expected the row to parse')
|
|
1239
|
-
await users.set(normalized)
|
|
1240
|
-
;(await users.get('u2'))?.age // 41 (a number) — the contract parsed it
|
|
1238
|
+
// A numeric string is a lossless repair, so admitValue admits it as the number.
|
|
1239
|
+
const admitted = admitValue(users.contract, { id: 'u2', name: 'Bo', age: '41', role: 'member' })
|
|
1240
|
+
if (!admitted.success) throw new Error('Expected the row to admit')
|
|
1241
|
+
await users.set(admitted.value.value)
|
|
1242
|
+
;(await users.get('u2'))?.age // 41 (a number)
|
|
1241
1243
|
|
|
1242
|
-
//
|
|
1244
|
+
// An undeclared column refuses with DatabaseError('VALIDATION') and the contract's faults.
|
|
1245
|
+
const imported = { id: 'u3', name: 'Cy', age: 29, role: 'member', nickname: 'Cy' }
|
|
1246
|
+
const refused = await users.set(imported).catch((error: unknown) => error)
|
|
1247
|
+
if (isDatabaseError(refused)) refused.context?.faults // [{ reason: 'extra', path: ['nickname'] }]
|
|
1243
1248
|
```
|
|
1244
1249
|
|
|
1245
1250
|
### Fluent queries
|
|
@@ -2517,9 +2522,10 @@ mapMigrationError(fault) // → the same, but an UPGRADE fault becomes 'MIGRATIO
|
|
|
2517
2522
|
|
|
2518
2523
|
- **Declare tables in `createDatabase({ tables })` and hold the handles** —
|
|
2519
2524
|
`const users = db.table('users')`; reuse them rather than re-resolving.
|
|
2520
|
-
- **Writes
|
|
2521
|
-
loose data (`'41'`) through `table.contract
|
|
2522
|
-
|
|
2525
|
+
- **Writes admit whole, reads narrow.** At an unknown-input boundary, admit
|
|
2526
|
+
loose data (`'41'`) through `admitValue(table.contract, input)` and write
|
|
2527
|
+
its value; a refusal carries the faults to report. Trust `get` / `records`
|
|
2528
|
+
to return the row type.
|
|
2523
2529
|
- **Use `resolve` when absence is an error**, `get` when it is expected —
|
|
2524
2530
|
`resolve` throws `NOT_FOUND`, `get` returns `undefined`.
|
|
2525
2531
|
- **Reach for `query()` over `records()`** — the builder compiles a portable
|
|
@@ -2549,7 +2555,7 @@ mapMigrationError(fault) // → the same, but an UPGRADE fault becomes 'MIGRATIO
|
|
|
2549
2555
|
- [`tests/src/core/Database.test.ts`](../tests/src/core/Database.test.ts) — declared tables, lazy connect, typed CRUD, custom keys, indexes, import/export, and callback transactions: whole accepted-operation drain, synchronous-throw and asynchronous-rejection reason identity, caught-operation rejection still rolling back, callback-over-drain error precedence, root/import/lifecycle/nesting barriers, stale scoped table/query/cursor/stream invalidation, and truthful successful-rollback-only events. It also covers explicit migration and versioned open: deployed-schema-first reconciliation, fresh stamp, same-version no-op, atomic upgrade input, higher-version rejection, paired-hook enforcement (metadata-only and stamp-only are inert), and migrate-event behavior.
|
|
2550
2556
|
- [`tests/src/core/ScopedIterator.test.ts`](../tests/src/core/ScopedIterator.test.ts) — direct internal continuation-lifetime coverage: tracked `next` / `return` / `throw`, the readiness thunk running before every advance and its failure preempting the source, synchronous source throws, missing methods, concurrent accepted continuations, idle iterators, late conflicts, and exactly-once rejected cleanup.
|
|
2551
2557
|
- [`tests/src/core/DriverIterator.test.ts`](../tests/src/core/DriverIterator.test.ts) — direct root-driver continuation coverage: pre/post-read guards, produced-row discard, terminalization, return races, missing methods, throw delegation, and exactly-once cleanup.
|
|
2552
|
-
- [`tests/src/core/Table.test.ts`](../tests/src/core/Table.test.ts) — `Table`'s keyed CRUD + batch overloads, payload-safe bounded contract diagnostics, strict paging at every read boundary,
|
|
2558
|
+
- [`tests/src/core/Table.test.ts`](../tests/src/core/Table.test.ts) — `Table`'s keyed CRUD + batch overloads, payload-safe bounded contract diagnostics, strict paging at every read boundary, whole-row admission with its lossless repairs, its undeclared, missing, and lossy refusals, and the raw-column nested-key admission, `add` dispatch through atomic `insert` (including concurrent duplicate claims), sequential partial-batch abort semantics, and the emitter's post-commit and no-aborted-event behavior.
|
|
2553
2559
|
- [`tests/src/core/Query.test.ts`](../tests/src/core/Query.test.ts) — `Query`'s where / and / or dispatch, ordering, synchronous strict page builders with no failed mutation, legal zero, `filter`, and aggregates.
|
|
2554
2560
|
- [`tests/src/core/Cursor.test.ts`](../tests/src/core/Cursor.test.ts) — cursor behavior over a key snapshot: `value` / `index` / `done`, serialized overlapping `next` / `update` / `remove`, rejection recovery, synchronous runner admission, terminal close before queued work and during dispatched reads/mutations, plus transaction-ledger regressions for deleted-key skipping, unawaited normalized updates, validation rollback, and retained closed/active conflicts.
|
|
2555
2561
|
- [`tests/src/core/factories.test.ts`](../tests/src/core/factories.test.ts) — `createDatabase` / `createMemoryDriver` each return a working instance of their interface (a round-trip end to end).
|
|
@@ -992,22 +992,27 @@ Scaffold writes one part of the manifest rather than advising on it: the writabl
|
|
|
992
992
|
and `prepublishOnly`. Each sheet face adds its `check:src:<face>` and `build:src:<face>` scripts.
|
|
993
993
|
Each occupied framework face adds `check:<axis>:vue` and `build:<axis>:vue`; the application face also adds `dev:vue`.
|
|
994
994
|
Selected showcase pages add `showcase`, `showcase:<framework>`, `build:showcase`, and `build:showcase:<framework>`; application journeys add `test:journey:<framework>`.
|
|
995
|
+
A workspace that plans the application server barrel adds `build:app:barrel`, which has no
|
|
996
|
+
predecessor form. A workspace with the server application adds `serve:build`, which runs `build`
|
|
997
|
+
before `serve` and accepts `npm run build:app:server && npm run serve` as its generated predecessor.
|
|
995
998
|
Its `test:src:<face>` script accepts, as its generated predecessor, the command that ran the project
|
|
996
999
|
without building the face first, and `build:src:styles` accepts the styles-only build as the
|
|
997
1000
|
predecessor of the chain that builds themes after it. A publishing `test` chain joins the region when
|
|
998
1001
|
it matches byte for byte the planned chain with the generated `test:app`, `test:journey`, and framework
|
|
999
1002
|
journey invocations inserted after `test:src`, where that blueprint emitted them before.
|
|
1000
1003
|
`repair` and `overwrite` remove those helper invocations from that exact predecessor.
|
|
1001
|
-
|
|
1002
|
-
the planned chain and
|
|
1003
|
-
|
|
1004
|
+
When the `test` or `build:app` chain is a generated predecessor, which runs fewer steps than
|
|
1005
|
+
the planned chain and runs only planned steps in the planned order, that chain joins the region
|
|
1006
|
+
and `repair` and `overwrite` write the planned chain in its place. That write lands only when
|
|
1004
1007
|
every step the planned chain adds runs a script the manifest declares or the region writes. The
|
|
1005
1008
|
`test:src` and `test:app` aggregates sit outside the region. Only a private workspace's planned
|
|
1006
1009
|
chain invokes `test:app`. A chain whose planned form adds an
|
|
1007
1010
|
aggregate the manifest lacks stays with the package, and the `projects` question keeps its remedy.
|
|
1008
|
-
`audit` reports this chain write only through the `projects` question, so a planned step that
|
|
1011
|
+
`audit` reports this `test` chain write only through the `projects` question, so a planned step that
|
|
1009
1012
|
registers no Vitest project, such as `npm run test:guides`, lands on the next `repair` without an
|
|
1010
|
-
earlier advisory.
|
|
1013
|
+
earlier advisory. `audit` reports no `build:app` chain write, so in a barrel workspace only the
|
|
1014
|
+
`scripts` question's report of a missing `build:app:barrel` script precedes that write. A `test` or
|
|
1015
|
+
`build:app` chain running any other step or order stays maintainer-owned, as do the
|
|
1011
1016
|
`check`, `build`, `dev`, `serve`, `format`, `lint`, `clean`, and `copy` gate chains. A
|
|
1012
1017
|
declared value is overwritten only when it is already the value being written or is a recognized
|
|
1013
1018
|
generated predecessor. The overwrite happens in place,
|
|
@@ -1693,7 +1698,9 @@ A workspace that selects `studies` and the `server` application also builds the
|
|
|
1693
1698
|
`app/server/index.ts`, because `@orkestrel/study` loads the package under study as ES modules. The
|
|
1694
1699
|
`appBarrel` factory, the content-owned `configs/app/vite.barrel.config.ts` wrapper, and the
|
|
1695
1700
|
`build:app:barrel` script exist only under that condition, and `build:app` runs the script after
|
|
1696
|
-
`build:app:server`.
|
|
1701
|
+
`build:app:server`. `serve:build` runs `build` before `serve`, so the barrel, which the server
|
|
1702
|
+
build's emptied `dist/app/server` would otherwise lose, and every browser face the server serves are
|
|
1703
|
+
rebuilt. The build emits the single file `dist/app/server/index.js` with `@app/*` and
|
|
1697
1704
|
`@src/*` specifiers and relative imports inlined, and `node:` and every installed package specifier
|
|
1698
1705
|
left external. It sets `emptyOutDir` to `false`, so `main.cjs` stays byte-identical. A workspace
|
|
1699
1706
|
without both conditions plans none of the three. Scaffold's `tests/src/core/templates.test.ts` builds both entries in a
|
|
@@ -2202,7 +2209,7 @@ extras pass through unchanged except for the selected showcase pair. Extras foll
|
|
|
2202
2209
|
`ORKESTREL_RANGE_PATTERN`; foreign peers follow `FLOOR_RANGE_PATTERN`.
|
|
2203
2210
|
|
|
2204
2211
|
A browser application with `showcase: true`, including its Vue face, selects exact
|
|
2205
|
-
`vite-plugin-singlefile: 2.3.3`, Vite `^8.3.
|
|
2212
|
+
`vite-plugin-singlefile: 2.3.3`, Vite `^8.3.8` from scaffold's manifest, and the npm override
|
|
2206
2213
|
`"vite-plugin-singlefile@2.3.3": { "micromatch": "npm:picomatch@2.3.2" }`. This policy applies
|
|
2207
2214
|
after extras. Online resolution excludes this pair from ordinary foreign-major updates; other
|
|
2208
2215
|
dependencies retain their usual resolution. Repair preserves each package's runtime or development
|
|
@@ -2280,7 +2287,7 @@ The dependency tables select these floors:
|
|
|
2280
2287
|
| `oxfmt` | `^0.78.0` | Every workspace |
|
|
2281
2288
|
| `@microsoft/api-extractor` | `^7.60.1` | Declaration builds; uses its bundled TypeScript 6.0.3 engine |
|
|
2282
2289
|
| `playwright` | `^1.64.1` | Browser tooling |
|
|
2283
|
-
| Vite | `^8.3.
|
|
2290
|
+
| Vite | `^8.3.8` | Every workspace |
|
|
2284
2291
|
| `@types/node` | `^24.19.2` | Every workspace; generated workspaces support Node `>=22.18.0` |
|
|
2285
2292
|
|
|
2286
2293
|
Node 26 types admit APIs that the supported runtime lacks. Inside the declared major the verbs
|
package/dist/host/manifest.json
CHANGED
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
"storage": "agents/orchestration.md",
|
|
17
17
|
"destination": ".agents/orchestration.md",
|
|
18
18
|
"executable": false,
|
|
19
|
-
"digest": "
|
|
19
|
+
"digest": "a434e7b16e375549de56a078da62f14663dfd0b5da5749b3f5099b3e4975bb6e"
|
|
20
20
|
},
|
|
21
21
|
{
|
|
22
22
|
"storage": "agents/platforms/posix.md",
|
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
"storage": "agents/platforms/windows.md",
|
|
29
29
|
"destination": ".agents/platforms/windows.md",
|
|
30
30
|
"executable": false,
|
|
31
|
-
"digest": "
|
|
31
|
+
"digest": "c852ff9886b2a2d24b8a0d69efe10f58dac37bd217d676c133048c148b5e877e"
|
|
32
32
|
},
|
|
33
33
|
{
|
|
34
34
|
"storage": "agents/skills/enterprise-bootstrap/SKILL.md",
|
|
@@ -448,7 +448,7 @@
|
|
|
448
448
|
"storage": "agents/skills/orkestrel-polish/SKILL.md",
|
|
449
449
|
"destination": ".agents/skills/orkestrel-polish/SKILL.md",
|
|
450
450
|
"executable": false,
|
|
451
|
-
"digest": "
|
|
451
|
+
"digest": "bb30bfc7b29d63176e39e345188e5eec45a14921a40671c9d8a4084c2a2e9512"
|
|
452
452
|
},
|
|
453
453
|
{
|
|
454
454
|
"storage": "agents/skills/orkestrel-polish/agents/openai.yaml",
|
|
@@ -628,7 +628,7 @@
|
|
|
628
628
|
"storage": "claude/agents/orkestrel.md",
|
|
629
629
|
"destination": ".claude/agents/orkestrel.md",
|
|
630
630
|
"executable": false,
|
|
631
|
-
"digest": "
|
|
631
|
+
"digest": "b2c55e267355a8865a03069be17858340f31773448598750e9e39768c67cef7a"
|
|
632
632
|
},
|
|
633
633
|
{
|
|
634
634
|
"storage": "claude/agents/planner.md",
|
|
@@ -700,7 +700,7 @@
|
|
|
700
700
|
"storage": "claude/rules/patterns.md",
|
|
701
701
|
"destination": ".claude/rules/patterns.md",
|
|
702
702
|
"executable": false,
|
|
703
|
-
"digest": "
|
|
703
|
+
"digest": "2ad9c0e6ca3c995fccb1163f52537252b3cc83e2e8ef0ca6365a20811959c942"
|
|
704
704
|
},
|
|
705
705
|
{
|
|
706
706
|
"storage": "claude/rules/portability.md",
|
|
@@ -910,7 +910,7 @@
|
|
|
910
910
|
"storage": "configs/helpers.ts",
|
|
911
911
|
"destination": "configs/helpers.ts",
|
|
912
912
|
"executable": false,
|
|
913
|
-
"digest": "
|
|
913
|
+
"digest": "316a70bb0e3eb51d9831dad144b613e86092fc82c6288b9ce428d2bb0cc93ba0"
|
|
914
914
|
},
|
|
915
915
|
{
|
|
916
916
|
"storage": "configs/policy.ts",
|
|
@@ -994,7 +994,7 @@
|
|
|
994
994
|
"storage": "guides/agent.md",
|
|
995
995
|
"destination": "guides/agent.md",
|
|
996
996
|
"executable": false,
|
|
997
|
-
"digest": "
|
|
997
|
+
"digest": "e254fceecdd111c66193ccaa2ec065ceaaba68a3386a1e4c29000fd02ec69ec9"
|
|
998
998
|
},
|
|
999
999
|
{
|
|
1000
1000
|
"storage": "guides/brief.md",
|
|
@@ -1036,7 +1036,7 @@
|
|
|
1036
1036
|
"storage": "guides/contract.md",
|
|
1037
1037
|
"destination": "guides/contract.md",
|
|
1038
1038
|
"executable": false,
|
|
1039
|
-
"digest": "
|
|
1039
|
+
"digest": "3092cdb3ef53f9dfcc59f2a06e665e609ddca3fda2b6a45686863461e383f277"
|
|
1040
1040
|
},
|
|
1041
1041
|
{
|
|
1042
1042
|
"storage": "guides/csv.md",
|
|
@@ -1048,7 +1048,7 @@
|
|
|
1048
1048
|
"storage": "guides/database.md",
|
|
1049
1049
|
"destination": "guides/database.md",
|
|
1050
1050
|
"executable": false,
|
|
1051
|
-
"digest": "
|
|
1051
|
+
"digest": "aa18f2aaed701023c831aef84aa069c4b4e74d9b0da3a29120a03e94e7a14188"
|
|
1052
1052
|
},
|
|
1053
1053
|
{
|
|
1054
1054
|
"storage": "guides/emitter.md",
|
|
@@ -1198,7 +1198,7 @@
|
|
|
1198
1198
|
"storage": "guides/scaffold.md",
|
|
1199
1199
|
"destination": "guides/scaffold.md",
|
|
1200
1200
|
"executable": false,
|
|
1201
|
-
"digest": "
|
|
1201
|
+
"digest": "64be1c48b9d18dfb6cd7f139035ede8b6163c9efcb2de9bf2d7c55097b52c9cd"
|
|
1202
1202
|
},
|
|
1203
1203
|
{
|
|
1204
1204
|
"storage": "guides/sea.md",
|
|
@@ -1336,7 +1336,7 @@
|
|
|
1336
1336
|
"storage": "tests/config.test.ts",
|
|
1337
1337
|
"destination": "tests/config.test.ts",
|
|
1338
1338
|
"executable": false,
|
|
1339
|
-
"digest": "
|
|
1339
|
+
"digest": "f164d7ae0a443b1373798c09c14772fd5e097cfad7959f27e7eb2d3aea6a30d6"
|
|
1340
1340
|
},
|
|
1341
1341
|
{
|
|
1342
1342
|
"storage": "tests/policy.test.ts",
|
|
@@ -1417,5 +1417,5 @@
|
|
|
1417
1417
|
"scripts"
|
|
1418
1418
|
],
|
|
1419
1419
|
"surface": [],
|
|
1420
|
-
"digest": "
|
|
1420
|
+
"digest": "226166ccc0bf247428a82035e08915bf36a9c9fe92a053c08d744e99a2c904eb"
|
|
1421
1421
|
}
|
|
@@ -5174,7 +5174,7 @@ describe('configuration helpers', () => {
|
|
|
5174
5174
|
'environmentSourceError',
|
|
5175
5175
|
'fileSystemPath',
|
|
5176
5176
|
'findPackageDirectory',
|
|
5177
|
-
'
|
|
5177
|
+
'hasASCIIURLControl',
|
|
5178
5178
|
'isBoundaryExemptModule',
|
|
5179
5179
|
'isExtractorModule',
|
|
5180
5180
|
'isOutsideWorkspacePath',
|
|
@@ -5462,8 +5462,8 @@ describe('configuration helpers', () => {
|
|
|
5462
5462
|
"const module = import('./module.js')\nconst asset = new URL('./asset%20name.png', import.meta.url)\nvoid module\nvoid asset\n"
|
|
5463
5463
|
writeFileSync(source, code, 'utf8')
|
|
5464
5464
|
|
|
5465
|
-
expect(configHelpers.
|
|
5466
|
-
expect(configHelpers.
|
|
5465
|
+
expect(configHelpers.hasASCIIURLControl('clean')).toBe(false)
|
|
5466
|
+
expect(configHelpers.hasASCIIURLControl('line\u0000break')).toBe(true)
|
|
5467
5467
|
expect(configHelpers.isBoundaryExemptModule('virtual:control')).toBe(true)
|
|
5468
5468
|
expect(configHelpers.isBoundaryExemptModule(resolve(POLICY_ROOT, 'src/core/index.ts'))).toBe(
|
|
5469
5469
|
false,
|
package/dist/src/core/index.cjs
CHANGED
|
@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
|
|
|
4
4
|
let _orkestrel_emitter = require("@orkestrel/emitter");
|
|
5
5
|
var package_default = {
|
|
6
6
|
name: "@orkestrel/scaffold",
|
|
7
|
-
version: "0.0.
|
|
7
|
+
version: "0.0.132",
|
|
8
8
|
description: "Scaffold workspaces with commands: new, audit, surface, repair, catalog, and overwrite.",
|
|
9
9
|
keywords: [
|
|
10
10
|
"audit",
|
|
@@ -96,27 +96,27 @@ var package_default = {
|
|
|
96
96
|
"prepublishOnly": "npm run format:check && npm run lint:check && npm run check && npm run build && npm test && npm run test:templates && npm run test:distribution -- --mode release"
|
|
97
97
|
},
|
|
98
98
|
dependencies: {
|
|
99
|
-
"@orkestrel/console": "^0.0.
|
|
100
|
-
"@orkestrel/contract": "^0.0.
|
|
101
|
-
"@orkestrel/emitter": "^0.0.
|
|
102
|
-
"@orkestrel/markdown": "^0.0.
|
|
103
|
-
"@orkestrel/process": "^0.0.
|
|
104
|
-
"@orkestrel/template": "^0.0.
|
|
99
|
+
"@orkestrel/console": "^0.0.20",
|
|
100
|
+
"@orkestrel/contract": "^0.0.23",
|
|
101
|
+
"@orkestrel/emitter": "^0.0.16",
|
|
102
|
+
"@orkestrel/markdown": "^0.0.21",
|
|
103
|
+
"@orkestrel/process": "^0.0.19",
|
|
104
|
+
"@orkestrel/template": "^0.0.14"
|
|
105
105
|
},
|
|
106
106
|
devDependencies: {
|
|
107
107
|
"@microsoft/api-extractor": "^7.60.1",
|
|
108
108
|
"@orkestrel/browser": "^0.0.32",
|
|
109
109
|
"@orkestrel/guide": "^0.0.30",
|
|
110
|
-
"@orkestrel/html": "^0.0.
|
|
110
|
+
"@orkestrel/html": "^0.0.16",
|
|
111
111
|
"@orkestrel/probe": "^0.0.29",
|
|
112
|
-
"@orkestrel/test": "^0.0.
|
|
112
|
+
"@orkestrel/test": "^0.0.34",
|
|
113
113
|
"@types/node": "^24.19.2",
|
|
114
114
|
"@vitest/browser-playwright": "^5.1.0",
|
|
115
115
|
"oxfmt": "^0.78.0",
|
|
116
116
|
"oxlint": "^1.93.0",
|
|
117
117
|
"playwright": "^1.64.1",
|
|
118
118
|
"typescript": "^7.0.2",
|
|
119
|
-
"vite": "^8.3.
|
|
119
|
+
"vite": "^8.3.8",
|
|
120
120
|
"vitest": "^5.1.0"
|
|
121
121
|
},
|
|
122
122
|
engines: { "node": ">=22.18.0" }
|
|
@@ -1690,7 +1690,8 @@ export function service(override?: UserConfig): UserConfig {
|
|
|
1690
1690
|
return mergeOverride(project, override)
|
|
1691
1691
|
}
|
|
1692
1692
|
`,
|
|
1693
|
-
studies: `// Run these @orkestrel/study proofs on demand with npm run test:studies;
|
|
1693
|
+
studies: `// Run these @orkestrel/study proofs on demand with npm run test:studies;
|
|
1694
|
+
// no gate or chain runs them.
|
|
1694
1695
|
export function studies(override?: UserConfig): UserConfig {
|
|
1695
1696
|
const project: UserConfig = {
|
|
1696
1697
|
resolve,
|
|
@@ -7469,7 +7470,7 @@ function blueprintToScripts(blueprint) {
|
|
|
7469
7470
|
...blueprint.showcase ? Object.fromEntries(application.flatMap((name) => [[`showcase:${name}`, `${showcase} --mode ${name}`], [`build:showcase:${name}`, `${buildShowcase} --mode ${name}`]])) : {},
|
|
7470
7471
|
...blueprint.app.includes("server") ? {
|
|
7471
7472
|
serve: "node dist/app/server/main.cjs",
|
|
7472
|
-
"serve:build": "npm run build
|
|
7473
|
+
"serve:build": "npm run build && npm run serve"
|
|
7473
7474
|
} : {},
|
|
7474
7475
|
...publishes ? {
|
|
7475
7476
|
prepack: "npm run build",
|
|
@@ -7499,6 +7500,9 @@ function blueprintToScripts(blueprint) {
|
|
|
7499
7500
|
* A base browser application's journey axis also adds `journey` and `capture`, and each
|
|
7500
7501
|
* app-side browser face adds `journey:<name>` and `capture:<name>`. Their generated
|
|
7501
7502
|
* commands are writable and have no predecessor forms; customized values remain caller-owned.
|
|
7503
|
+
* A workspace that plans the application server barrel adds `build:app:barrel`, which has no
|
|
7504
|
+
* predecessor form. A workspace with the server application adds `serve:build`, which runs `build`
|
|
7505
|
+
* before `serve`, so the barrel and every browser face the server serves are rebuilt.
|
|
7502
7506
|
* Aggregate test scripts and
|
|
7503
7507
|
* maintainer-owned gate chains stay outside the region.
|
|
7504
7508
|
*
|
|
@@ -7509,8 +7513,8 @@ function blueprintToScripts(blueprint) {
|
|
|
7509
7513
|
* existed. The pack hook accepts the build chain emitted before it
|
|
7510
7514
|
* delegated to `build`. The publication hook accepts the same gate chain without
|
|
7511
7515
|
* {@link RELEASE_PROOF_COMMAND}. No accepted publication chain carries a study
|
|
7512
|
-
* step.
|
|
7513
|
-
* it is not repeated there. Any other value is a script the workspace author
|
|
7516
|
+
* step. `serve:build` accepts the server-only chain it ran before it delegated to
|
|
7517
|
+
* `build`. The value being written is always writable, so it is not repeated there. Any other value is a script the workspace author
|
|
7514
7518
|
* customized, and {@link replaceManifestScripts} retains it while writing the
|
|
7515
7519
|
* other named scripts independently.
|
|
7516
7520
|
*
|
|
@@ -7531,11 +7535,14 @@ function blueprintToWritableScripts(blueprint) {
|
|
|
7531
7535
|
const sheet = sheets.some((face) => name === `build:src:${face}` || name === `check:src:${face}`);
|
|
7532
7536
|
const framework = blueprintToFaces(blueprint).some((extension) => extension.surface === "browser" && extension.axes.some((axis) => name === `check:${axis}:${extension.name}` || name === `build:${axis}:${extension.name}` || axis === "app" && (name === `dev:${extension.name}` || name === `journey:${extension.name}` || name === `capture:${extension.name}`)));
|
|
7533
7537
|
const showcase = name === "showcase" || name.startsWith("showcase:") || name === "build:showcase" || name.startsWith("build:showcase:");
|
|
7534
|
-
|
|
7538
|
+
const capture = name === "journey" || name === "capture";
|
|
7539
|
+
const barrel = matchesBarrel(blueprint) && name === "build:app:barrel";
|
|
7540
|
+
const served = blueprint.app.includes("server") && name === "serve:build";
|
|
7541
|
+
if (!direct && !sheet && !framework && !showcase && !capture && !barrel && !served) return [];
|
|
7535
7542
|
return [{
|
|
7536
7543
|
name,
|
|
7537
7544
|
command,
|
|
7538
|
-
accepted: name === "test:guides" ? ["vitest run --config vite.config.ts --no-cache --reporter=dot --project guides"] : name === "test:bench" ? ["vitest bench --config vite.config.ts --no-cache --project probe"] : name === "build:src:styles" && blueprint.themes ? ["vite build --config configs/src/vite.styles.config.ts"] : sheets.some((face) => name === `test:src:${face}`) ? [command.slice(command.indexOf(" && ") + 4)] : []
|
|
7545
|
+
accepted: name === "test:guides" ? ["vitest run --config vite.config.ts --no-cache --reporter=dot --project guides"] : name === "test:bench" ? ["vitest bench --config vite.config.ts --no-cache --project probe"] : name === "build:src:styles" && blueprint.themes ? ["vite build --config configs/src/vite.styles.config.ts"] : sheets.some((face) => name === `test:src:${face}`) ? [command.slice(command.indexOf(" && ") + 4)] : name === "serve:build" ? ["npm run build:app:server && npm run serve"] : []
|
|
7539
7546
|
}];
|
|
7540
7547
|
});
|
|
7541
7548
|
const prepack = scripts.prepack;
|