@orkestrel/scaffold 0.0.142 → 0.0.143

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 CHANGED
@@ -10,7 +10,7 @@ import { readdirSync } from "node:fs";
10
10
  import { parseArgs } from "node:util";
11
11
  var package_default = {
12
12
  name: "@orkestrel/scaffold",
13
- version: "0.0.142",
13
+ version: "0.0.143",
14
14
  description: "Scaffold workspaces with commands: new, audit, surface, repair, catalog, and overwrite.",
15
15
  keywords: [
16
16
  "audit",
@@ -764,6 +764,111 @@ function collectQuestions(target: string, writing: boolean): readonly Question[]
764
764
  }
765
765
  ```
766
766
 
767
+ ## `exemptions.record` and `exemptions.copy` (**Exemptions**)
768
+
769
+ - **Signatures.** Computed-key writes, `\b[A-Za-z_$][\w$]*\[(?:[^\]'"\[]|\[[^\]]*\])+\]\s*=[^=>]`,
770
+ and member definitions, `\.define(?:Property|Properties)?\(`. Then resolve the object each hit
771
+ writes to the binding that creates it.
772
+ - **Reading.**
773
+ - Drop a write into a record that meets every condition of the record item (**Exemptions**): the
774
+ function that writes the record creates it as a `{ __proto__: null }` literal, fills it in a
775
+ counted loop over a list that function owns, writes one own data property per key, writes no
776
+ key twice, and returns or freezes the record.
777
+ - Drop a definition on a copy that meets every condition of the copy item (**Exemptions**): a
778
+ traversal creates the copy before it visits the copy's members, the traversal step that owns the
779
+ copy writes it, each write defines one own property, and no key is written twice.
780
+ - Keep a write into a record that a caller passed or that a parameter reaches, a write whose key
781
+ can repeat, such as a key list that can name one key twice or a tally that rewrites its key, and
782
+ a definition on a copy that another step owns. Rule each kept hit under **Running values**,
783
+ **Lists and logs**, and **Per-call state**.
784
+ - Drop a write into a typed array, and a write that `exemptions.platform` drops.
785
+
786
+ Hit fixture, `exemptions.record.hit.ts`:
787
+
788
+ ```ts
789
+ function countWords(words: readonly string[], counts: Record<string, number>): void {
790
+ for (let index = 0; index < words.length; index++) {
791
+ const word = words[index]
792
+ if (word !== undefined) counts[word] = (counts[word] ?? 0) + 1
793
+ }
794
+ }
795
+ ```
796
+
797
+ Hit fixture, `exemptions.copy.hit.ts`:
798
+
799
+ ```ts
800
+ interface TreeFrame {
801
+ readonly source: Readonly<Record<string, unknown>>
802
+ readonly copy: object
803
+ readonly parent: TreeFrame | undefined
804
+ }
805
+
806
+ function fillFrame(frame: TreeFrame): void {
807
+ for (const key of Object.keys(frame.source)) {
808
+ Object.defineProperty(frame.copy, key, { value: frame.source[key], enumerable: true })
809
+ }
810
+ if (frame.parent !== undefined) {
811
+ Object.defineProperty(frame.parent.copy, 'last', { value: frame.copy, configurable: true })
812
+ }
813
+ }
814
+ ```
815
+
816
+ Clear fixture, `exemptions.record.clear.ts`:
817
+
818
+ ```ts
819
+ function selectMembers(
820
+ source: Readonly<Record<string, unknown>>,
821
+ keys: readonly string[],
822
+ ): Readonly<Record<string, unknown>> {
823
+ const present = [...new Set(keys)].filter((key) => Object.hasOwn(source, key))
824
+ const result: Record<string, unknown> = { __proto__: null }
825
+ for (let index = 0; index < present.length; index++) {
826
+ const key = present[index]
827
+ if (key !== undefined) result[key] = source[key]
828
+ }
829
+ return Object.freeze(result)
830
+ }
831
+ ```
832
+
833
+ Clear fixture, `exemptions.copy.clear.ts`:
834
+
835
+ ```ts
836
+ interface CopyFrame {
837
+ readonly source: object
838
+ readonly copy: Record<string, unknown>
839
+ }
840
+
841
+ function captureValue(
842
+ value: unknown,
843
+ copies: Map<object, Record<string, unknown>>,
844
+ pending: CopyFrame[],
845
+ ): unknown {
846
+ if (typeof value !== 'object' || value === null) return value
847
+ const known = copies.get(value)
848
+ if (known !== undefined) return known
849
+ const copy: Record<string, unknown> = { __proto__: null }
850
+ copies.set(value, copy)
851
+ pending.push({ source: value, copy })
852
+ return copy
853
+ }
854
+
855
+ function cloneGraph(root: object): unknown {
856
+ const copies = new Map<object, Record<string, unknown>>()
857
+ const pending: CopyFrame[] = []
858
+ const clone = captureValue(root, copies, pending)
859
+ for (const frame of pending) {
860
+ for (const key of Object.keys(frame.source)) {
861
+ Object.defineProperty(frame.copy, key, {
862
+ value: captureValue(Reflect.get(frame.source, key), copies, pending),
863
+ enumerable: true,
864
+ })
865
+ }
866
+ Object.freeze(frame.copy)
867
+ }
868
+ return clone
869
+ }
870
+ ```
871
+
767
872
  ## `percall.builtins` (**Per-call state**)
768
873
 
769
874
  - **Signatures.** In an `async` function, or one that registers callbacks, find every local
@@ -78,7 +78,7 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
78
78
  | `@orkestrel/reason` | `0.0.20` | L2 | `@orkestrel/emitter` `^0.0.18`, `@orkestrel/contract` `^0.0.26` | |
79
79
  | `@orkestrel/relation` | `0.0.26` | L3 | `@orkestrel/emitter` `^0.0.18`, `@orkestrel/contract` `^0.0.26`, `@orkestrel/database` `^0.0.28` | |
80
80
  | `@orkestrel/router` | `0.0.24` | L2 | `@orkestrel/abort` `^0.0.19`, `@orkestrel/emitter` `^0.0.18`, `@orkestrel/contract` `^0.0.26` | |
81
- | `@orkestrel/scaffold` | `0.0.141` | L3 | `@orkestrel/console` `^0.0.22`, `@orkestrel/emitter` `^0.0.18`, `@orkestrel/process` `^0.0.22`, `@orkestrel/contract` `^0.0.26`, `@orkestrel/markdown` `^0.0.23`, `@orkestrel/template` `^0.0.16` | |
81
+ | `@orkestrel/scaffold` | `0.0.142` | L3 | `@orkestrel/console` `^0.0.22`, `@orkestrel/emitter` `^0.0.18`, `@orkestrel/process` `^0.0.22`, `@orkestrel/contract` `^0.0.26`, `@orkestrel/markdown` `^0.0.23`, `@orkestrel/template` `^0.0.16` | |
82
82
  | `@orkestrel/sea` | `0.0.25` | L3 | `@orkestrel/emitter` `^0.0.18`, `@orkestrel/process` `^0.0.22`, `@orkestrel/contract` `^0.0.26` | |
83
83
  | `@orkestrel/server` | `0.0.30` | L3 | `@orkestrel/abort` `^0.0.19`, `@orkestrel/codec` `^0.0.12`, `@orkestrel/router` `^0.0.24`, `@orkestrel/emitter` `^0.0.18`, `@orkestrel/timeout` `^0.0.19`, `@orkestrel/contract` `^0.0.26` | |
84
84
  | `@orkestrel/sqlite` | `0.0.20` | L1 | `@orkestrel/contract` `^0.0.26` | |
@@ -116,6 +116,13 @@ The non-negotiables and design laws in `AGENTS.md` apply without exception and a
116
116
  requires, such as zlib, a PNG encoder, or `Buffer`, which is a platform-API write, or as the
117
117
  result a counted loop computes into a typed array its own function creates; write no index
118
118
  twice;
119
+ - a null-prototype record (`{ __proto__: null }`) that a function creates and fills in a counted
120
+ loop over a list that function owns, with one own data property per key, each key written once,
121
+ as the record that function returns or freezes; never write into a record a caller passed or
122
+ that a parameter reaches;
123
+ - a copy that a traversal creates before it visits the copy's members, so that a cycle can reach
124
+ the copy, filled with one own property per key, each key written once, by the traversal step
125
+ that owns the copy;
119
126
  - a counted loop's index and its accumulators, which the **Counted loops** bullet admits.
120
127
  - **Per-call state.** Keep state that the awaits or callbacks of one call change, other than a log,
121
128
  in `#` fields of an entity created for that call. Treat a list that more than one concurrently
@@ -274,7 +274,7 @@
274
274
  "storage": "agents/skills/orkestrel-harden/references/bindings.md",
275
275
  "destination": ".agents/skills/orkestrel-harden/references/bindings.md",
276
276
  "executable": false,
277
- "digest": "77fbd8e4a0b978b25446cf8c02fe062d404e6dfe6ccfcf2b56e18bc2bfdd9464"
277
+ "digest": "c44a1a980a94d3473b769c20ee769047a1e229b8481e79950f155e596769c0e0"
278
278
  },
279
279
  {
280
280
  "storage": "agents/skills/orkestrel-harden/references/centralization.md",
@@ -628,7 +628,7 @@
628
628
  "storage": "claude/agents/orkestrel.md",
629
629
  "destination": ".claude/agents/orkestrel.md",
630
630
  "executable": false,
631
- "digest": "ae1f337975883d0438b9f9155e51017b1ce7de8b287bdbff1ca516f2e396402c"
631
+ "digest": "d49aa65e13a18ca3e52163c2c2a573e9dfddad028422216ade97460a0198fce9"
632
632
  },
633
633
  {
634
634
  "storage": "claude/agents/planner.md",
@@ -730,7 +730,7 @@
730
730
  "storage": "claude/rules/typescript.md",
731
731
  "destination": ".claude/rules/typescript.md",
732
732
  "executable": false,
733
- "digest": "88b22b23da6ec2773d38916ac9b0e8302954c9892d5aa6cfc073e57233a32e04"
733
+ "digest": "ccabaa787151efdf5b654319fdfba7958d410f58ffa4b517796148c4e18001df"
734
734
  },
735
735
  {
736
736
  "storage": "claude/rules/workspace.md",
@@ -1417,5 +1417,5 @@
1417
1417
  "scripts"
1418
1418
  ],
1419
1419
  "surface": [],
1420
- "digest": "5cfcfde5d05c0fa79f9a9a33ba901ebd4968529cfb4b6e91a075dc90bd3a3ac2"
1420
+ "digest": "d023fbae058238dcd4206e2b6fe7d9a8bfa71dfe7e7e7c32b4355eed29aa7803"
1421
1421
  }
File without changes
File without changes
File without changes
File without changes
File without changes
File without changes
@@ -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.142",
7
+ version: "0.0.143",
8
8
  description: "Scaffold workspaces with commands: new, audit, surface, repair, catalog, and overwrite.",
9
9
  keywords: [
10
10
  "audit",
@@ -3,7 +3,7 @@ import { fillTemplate } from "@orkestrel/template";
3
3
  import { Emitter } from "@orkestrel/emitter";
4
4
  var package_default = {
5
5
  name: "@orkestrel/scaffold",
6
- version: "0.0.142",
6
+ version: "0.0.143",
7
7
  description: "Scaffold workspaces with commands: new, audit, surface, repair, catalog, and overwrite.",
8
8
  keywords: [
9
9
  "audit",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@orkestrel/scaffold",
3
- "version": "0.0.142",
3
+ "version": "0.0.143",
4
4
  "description": "Scaffold workspaces with commands: new, audit, surface, repair, catalog, and overwrite.",
5
5
  "keywords": [
6
6
  "audit",