@orkestrel/scaffold 0.0.115 → 0.0.116

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/dist/bin/main.js +137 -15
  2. package/dist/bin/main.js.map +1 -1
  3. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +1 -1
  4. package/dist/host/claude/agents/orkestrel.md +1 -1
  5. package/dist/host/claude/rules/names.md +3 -1
  6. package/dist/host/guides/abort.md +17 -17
  7. package/dist/host/guides/agent.md +445 -445
  8. package/dist/host/guides/brief.md +143 -143
  9. package/dist/host/guides/browser.md +731 -731
  10. package/dist/host/guides/budget.md +39 -39
  11. package/dist/host/guides/capture.md +298 -298
  12. package/dist/host/guides/console.md +109 -109
  13. package/dist/host/guides/contract.md +335 -335
  14. package/dist/host/guides/csv.md +30 -30
  15. package/dist/host/guides/database.md +163 -163
  16. package/dist/host/guides/emitter.md +17 -17
  17. package/dist/host/guides/form.md +99 -99
  18. package/dist/host/guides/guide.md +361 -183
  19. package/dist/host/guides/html.md +49 -49
  20. package/dist/host/guides/indexeddb.md +40 -40
  21. package/dist/host/guides/interpret.md +139 -139
  22. package/dist/host/guides/lsp.md +114 -114
  23. package/dist/host/guides/markdown.md +68 -68
  24. package/dist/host/guides/mcp.md +3745 -3745
  25. package/dist/host/guides/middleware.md +170 -170
  26. package/dist/host/guides/msg.md +95 -95
  27. package/dist/host/guides/ndjson.md +8 -8
  28. package/dist/host/guides/ollama.md +56 -56
  29. package/dist/host/guides/pool.md +21 -21
  30. package/dist/host/guides/probe.md +82 -82
  31. package/dist/host/guides/process.md +99 -99
  32. package/dist/host/guides/program.md +98 -96
  33. package/dist/host/guides/qualifier.md +70 -70
  34. package/dist/host/guides/queue.md +37 -37
  35. package/dist/host/guides/rater.md +38 -38
  36. package/dist/host/guides/reason.md +308 -308
  37. package/dist/host/guides/relation.md +50 -50
  38. package/dist/host/guides/router.md +58 -58
  39. package/dist/host/guides/scaffold.md +554 -419
  40. package/dist/host/guides/sea.md +128 -128
  41. package/dist/host/guides/server.md +100 -100
  42. package/dist/host/guides/sqlite.md +28 -28
  43. package/dist/host/guides/sse.md +20 -20
  44. package/dist/host/guides/study.md +444 -444
  45. package/dist/host/guides/table.md +82 -82
  46. package/dist/host/guides/template.md +41 -41
  47. package/dist/host/guides/terminal.md +121 -121
  48. package/dist/host/guides/test.md +273 -273
  49. package/dist/host/guides/timeout.md +18 -18
  50. package/dist/host/guides/tool.md +27 -27
  51. package/dist/host/guides/toolbox.md +166 -166
  52. package/dist/host/guides/websocket.md +54 -54
  53. package/dist/host/guides/worker.md +24 -24
  54. package/dist/host/guides/workflow.md +187 -187
  55. package/dist/host/guides/workspace.md +55 -55
  56. package/dist/host/manifest.json +55 -55
  57. package/dist/host/tests/setupPolicy.ts +5 -3
  58. package/dist/src/core/index.cjs +89 -3
  59. package/dist/src/core/index.cjs.map +1 -1
  60. package/dist/src/core/index.d.cts +229 -144
  61. package/dist/src/core/index.d.ts +229 -144
  62. package/dist/src/core/index.js +87 -4
  63. package/dist/src/core/index.js.map +1 -1
  64. package/dist/src/server/index.cjs +292 -66
  65. package/dist/src/server/index.cjs.map +1 -1
  66. package/dist/src/server/index.d.cts +188 -6
  67. package/dist/src/server/index.d.ts +188 -6
  68. package/dist/src/server/index.js +287 -69
  69. package/dist/src/server/index.js.map +1 -1
  70. package/package.json +4 -3
@@ -35,36 +35,36 @@ documented under [`## Methods`](#methods), and its readonly data members stay he
35
35
 
36
36
  A `Shape` cell holds an interface's data members as bare names in braces, `?` marking an optional member and `plus` introducing its call-signature members, and a type alias's own type literal with a union's arms escaped as `\|`.
37
37
 
38
- | Name | Kind | Shape | Summary |
39
- | --------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
40
- | `BinaryMIME` | type | `'image/png' \| 'image/jpeg' \| 'image/gif' \| 'image/webp'` | Names the MIME labels a binary `FileContent` arm supports. |
41
- | `FileContent` | type | `TextContent \| BinaryContent` | Holds a file's immutable content: either text with a language tag or a base64 string with a MIME. The union carries no discriminant field, so a caller narrows it with a guard. |
42
- | `TextContent` | interface | `{ text, language }` | Holds the text arm of a file's immutable content: a body and its language tag. |
43
- | `BinaryContent` | interface | `{ base64, mime }` | Holds the binary arm of a file's immutable content: a base64 payload and its MIME. |
44
- | `FileState` | type | `'created' \| 'modified'` | Names the edit state of an immutable file value: `created` for the first write to a path and `modified` for every later edit of that path. |
45
- | `FileInput` | interface | `{ path, content, state? }` | Carries the caller-supplied values used to create an immutable file. The byte size and the line count are derived rather than supplied. |
46
- | `FileInterface` | interface | `{ path, content, state, size, lines }` | Represents an immutable path-addressed file with derived byte and line counts. |
47
- | `Position` | interface | `{ line, column }` | Locates a 1-based caret inside text. |
48
- | `Range` | interface | `{ start, end }` | Represents a half-open text span whose start is inclusive and end is exclusive. |
49
- | `ReadResult` | interface | `{ content, range }` | Carries the content and clamped span returned by a ranged read. |
50
- | `SearchOptions` | interface | `{ regex?, sensitive?, limit? }` | Configures search and replacement behavior. |
51
- | `SearchMatch` | interface | `{ path, line, column, length, content }` | Reports one 1-based search hit and the full line that contains it. |
52
- | `ReplaceResult` | interface | `{ occurrences, files }` | Carries the tallies a replacement produced: the occurrences replaced and the files changed. |
53
- | `WorkspaceEventMap` | type | `{ write, remove, move, clear }` | Names the events emitted after workspace mutations complete. |
54
- | `WorkspaceOptions` | interface | `{ id?, on?, error?, seed? }` | Configures a workspace at construction. |
55
- | `WorkspaceSnapshot` | interface | `{ id, files }` | Represents a workspace's stored state in JSON-serializable form. |
56
- | `WorkspaceStoreInterface` | interface | `{} plus get, set, delete` | Persists workspace snapshots through an asynchronous point-access contract. |
57
- | `WorkspaceSnapshotRow` | interface | `{ id, snapshot }` | Represents the database row used to persist one opaque workspace snapshot. |
58
- | `WorkspaceErrorCode` | type | `'MISSING' \| 'MODALITY' \| 'PATTERN' \| 'RANGE'` | Names the machine-readable failure codes raised by the workspace edit surface. |
59
- | `WorkspaceInterface` | interface | `{ id, emitter, count } plus file, files, read, has, search, replace, write, prepend, append, move, remove, clear, snapshot, destroy` | Represents a mutable path-keyed editing surface over immutable file values. |
60
- | `WorkspaceManagerOptions` | interface | `{ on?, error?, store? }` | Configures a workspace registry at construction. |
61
- | `WorkspaceManagerInterface` | interface | `{ count, active } plus workspace, workspaces, add, switch, open, save, remove, clear` | Represents an insertion-ordered workspace registry with an active selection and optional durability. |
38
+ | Name | Kind | Signature | Summary |
39
+ | --------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
40
+ | `BinaryMIME` | type | `'image/png' \| 'image/jpeg' \| 'image/gif' \| 'image/webp'` | Names the MIME labels a binary `FileContent` arm supports. |
41
+ | `FileContent` | type | `TextContent \| BinaryContent` | Holds a file's immutable content: either text with a language tag or a base64 string with a MIME. The union carries no discriminant field, so a caller narrows it with a guard. |
42
+ | `TextContent` | interface | `{ text, language }` | Holds the text arm of a file's immutable content: a body and its language tag. |
43
+ | `BinaryContent` | interface | `{ base64, mime }` | Holds the binary arm of a file's immutable content: a base64 payload and its MIME. |
44
+ | `FileState` | type | `'created' \| 'modified'` | Names the edit state of an immutable file value: `created` for the first write to a path and `modified` for every later edit of that path. |
45
+ | `FileInput` | interface | `{ path, content, state? }` | Carries the caller-supplied values used to create an immutable file. The byte size and the line count are derived rather than supplied. |
46
+ | `FileInterface` | interface | `{ path, content, state, size, lines }` | Represents an immutable path-addressed file with derived byte and line counts. |
47
+ | `Position` | interface | `{ line, column }` | Locates a 1-based caret inside text. |
48
+ | `Range` | interface | `{ start, end }` | Represents a half-open text span whose start is inclusive and end is exclusive. |
49
+ | `ReadResult` | interface | `{ content, range }` | Carries the content and clamped span returned by a ranged read. |
50
+ | `SearchOptions` | interface | `{ regex?, sensitive?, limit? }` | Configures search and replacement behavior. |
51
+ | `SearchMatch` | interface | `{ path, line, column, length, content }` | Reports one 1-based search hit and the full line that contains it. |
52
+ | `ReplaceResult` | interface | `{ occurrences, files }` | Carries the tallies a replacement produced: the occurrences replaced and the files changed. |
53
+ | `WorkspaceEventMap` | type | `{ readonly write: readonly [file: FileInterface]; readonly remove: readonly [path: string]; readonly move: readonly [from: string, to: string]; readonly clear: readonly []; }` | Names the events emitted after workspace mutations complete. |
54
+ | `WorkspaceOptions` | interface | `{ id?, on?, error?, seed? }` | Configures a workspace at construction. |
55
+ | `WorkspaceSnapshot` | interface | `{ id, files }` | Represents a workspace's stored state in JSON-serializable form. |
56
+ | `WorkspaceStoreInterface` | interface | `{ get(), set(), delete() }` | Persists workspace snapshots through an asynchronous point-access contract. |
57
+ | `WorkspaceSnapshotRow` | interface | `{ id, snapshot }` | Represents the database row used to persist one opaque workspace snapshot. |
58
+ | `WorkspaceErrorCode` | type | `'MISSING' \| 'MODALITY' \| 'PATTERN' \| 'RANGE'` | Names the machine-readable failure codes raised by the workspace edit surface. |
59
+ | `WorkspaceInterface` | interface | `{ id, emitter, count, file(), files(), read(), has(), search(), replace(), write(), prepend(), append(), move(), remove(), clear(), snapshot(), destroy() }` | Represents a mutable path-keyed editing surface over immutable file values. |
60
+ | `WorkspaceManagerOptions` | interface | `{ on?, error?, store? }` | Configures a workspace registry at construction. |
61
+ | `WorkspaceManagerInterface` | interface | `{ count, active, workspace(), workspaces(), add(), switch(), open(), save(), remove(), clear() }` | Represents an insertion-ordered workspace registry with an active selection and optional durability. |
62
62
 
63
63
  ### Constants
64
64
 
65
65
  A `Shape` cell holds the constant's declared type.
66
66
 
67
- | Name | Kind | Shape | Summary |
67
+ | Name | Kind | Signature | Summary |
68
68
  | --------------------- | ----- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
69
69
  | `EXTENSION_LANGUAGES` | const | `Readonly<Record<string, string>>` | Maps file extensions to language tags for text content. The table is frozen, and an extension it does not list falls back to `text` in `inferLanguage`. |
70
70
 
@@ -73,32 +73,32 @@ A `Shape` cell holds the constant's declared type.
73
73
  From [`errors.ts`](../src/core/errors.ts). A refusal is an exception; everything else this
74
74
  package can answer, it answers with a value.
75
75
 
76
- | Name | Kind | Signature | Summary |
77
- | ------------------ | -------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
78
- | `WorkspaceError` | class | `new (code, message, context?)` | Reports an invalid workspace edit or search operation, carrying a `WorkspaceErrorCode` and, when the operation had one, the context it ran under. |
79
- | `isWorkspaceError` | function | `(value: unknown) => value is WorkspaceError` | Narrows a caught value to a `WorkspaceError`. |
76
+ | Name | Kind | Signature | Summary |
77
+ | ------------------ | -------- | ---------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
78
+ | `WorkspaceError` | class | `new (code: WorkspaceErrorCode, message: string, context?: Readonly<Record<string, unknown>>) => WorkspaceError` | Reports an invalid workspace edit or search operation, carrying a `WorkspaceErrorCode` and, when the operation had one, the context it ran under. |
79
+ | `isWorkspaceError` | function | `(value: unknown) => value is WorkspaceError` | Narrows a caught value to a `WorkspaceError`. |
80
80
 
81
81
  ### Helpers
82
82
 
83
83
  The pure leaves, from [`helpers.ts`](../src/core/helpers.ts). Each one is exported and tested
84
84
  on its own, and the classes compose them rather than hiding them.
85
85
 
86
- | Name | Kind | Signature | Summary |
87
- | -------------------- | -------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
88
- | `inferLanguage` | function | `(path: string) => string` | Infers a language tag from the final file extension. |
89
- | `isText` | function | `(content: FileContent) => content is TextContent` | Determines whether content is the text arm. |
90
- | `isBinary` | function | `(content: FileContent) => content is BinaryContent` | Determines whether content is the binary arm. |
91
- | `computeSize` | function | `(content: FileContent) => number` | Computes the byte size of file content. |
92
- | `countLines` | function | `(content: FileContent) => number` | Counts the lines in file content. |
93
- | `computeDecodedSize` | function | `(base64: string) => number` | Computes the decoded byte length of a base64 string, arithmetically rather than by decoding it. |
94
- | `isValidRange` | function | `(range: Range) => boolean` | Determines whether a 1-based range is structurally valid. |
95
- | `clampPosition` | function | `(text: string, position: Position) => Position` | Clamps a position to text bounds. |
96
- | `clampRange` | function | `(text: string, range: Range) => Range` | Clamps both positions in a range to text bounds. |
97
- | `offsetAt` | function | `(text: string, position: Position) => number` | Converts a 1-based position to a zero-based string offset. |
98
- | `sliceRange` | function | `(text: string, range: Range) => string` | Slices a clamped half-open text range. |
99
- | `spliceRange` | function | `(text: string, range: Range, replacement: string) => string` | Replaces a clamped half-open text range. |
100
- | `rangeOf` | function | `(fromLine, fromColumn, toLine, toColumn) => Range` | Assembles a nested range from four 1-based coordinates. |
101
- | `escapeRegExp` | function | `(value: string) => string` | Escapes regular-expression metacharacters for literal matching. |
86
+ | Name | Kind | Signature | Summary |
87
+ | -------------------- | -------- | ----------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
88
+ | `inferLanguage` | function | `(path: string) => string` | Infers a language tag from the final file extension. |
89
+ | `isText` | function | `(content: FileContent) => content is TextContent` | Determines whether content is the text arm. |
90
+ | `isBinary` | function | `(content: FileContent) => content is BinaryContent` | Determines whether content is the binary arm. |
91
+ | `computeSize` | function | `(content: FileContent) => number` | Computes the byte size of file content. |
92
+ | `countLines` | function | `(content: FileContent) => number` | Counts the lines in file content. |
93
+ | `computeDecodedSize` | function | `(base64: string) => number` | Computes the decoded byte length of a base64 string, arithmetically rather than by decoding it. |
94
+ | `isValidRange` | function | `(range: Range) => boolean` | Determines whether a 1-based range is structurally valid. |
95
+ | `clampPosition` | function | `(text: string, position: Position) => Position` | Clamps a position to text bounds. |
96
+ | `clampRange` | function | `(text: string, range: Range) => Range` | Clamps both positions in a range to text bounds. |
97
+ | `offsetAt` | function | `(text: string, position: Position) => number` | Converts a 1-based position to a zero-based string offset. |
98
+ | `sliceRange` | function | `(text: string, range: Range) => string` | Slices a clamped half-open text range. |
99
+ | `spliceRange` | function | `(text: string, range: Range, replacement: string) => string` | Replaces a clamped half-open text range. |
100
+ | `rangeOf` | function | `(fromLine: number, fromColumn: number, toLine: number, toColumn: number) => Range` | Assembles a nested range from four 1-based coordinates. |
101
+ | `escapeRegExp` | function | `(value: string) => string` | Escapes regular-expression metacharacters for literal matching. |
102
102
 
103
103
  ### Validators
104
104
 
@@ -107,10 +107,10 @@ value arriving from outside the process without throwing on a hostile property a
107
107
 
108
108
  In a guard table a `Shape` cell holds the type the guard narrows to.
109
109
 
110
- | Name | Kind | Shape | Summary |
111
- | --------------------- | -------- | ------------------- | ----------------------------------------------------- |
112
- | `isFile` | function | `FileInterface` | Narrows an unknown value to an immutable file record. |
113
- | `isWorkspaceSnapshot` | function | `WorkspaceSnapshot` | Narrows an unknown value to a workspace snapshot. |
110
+ | Name | Kind | Signature | Summary |
111
+ | --------------------- | -------- | ------------------------------------------------ | ----------------------------------------------------- |
112
+ | `isFile` | function | `(value: unknown) => value is FileInterface` | Narrows an unknown value to an immutable file record. |
113
+ | `isWorkspaceSnapshot` | function | `(value: unknown) => value is WorkspaceSnapshot` | Narrows an unknown value to a workspace snapshot. |
114
114
 
115
115
  ### Factories
116
116
 
@@ -135,12 +135,12 @@ The implementing classes, from [`Workspace.ts`](../src/core/workspaces/Workspace
135
135
  [`DatabaseWorkspaceStore.ts`](../src/core/workspaces/stores/DatabaseWorkspaceStore.ts) — each
136
136
  documented in full under its own heading following this table.
137
137
 
138
- | Name | Kind | Summary |
139
- | ------------------------ | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
140
- | `Workspace` | class | Implements `WorkspaceInterface` over one insertion-ordered path map the instance owns, projecting fresh arrays on every read. Whole-file edits create text files, ranged edits operate only on existing text files, and binary files remain available through construction-time hydration. Mutations emit after the file map has changed. |
141
- | `WorkspaceManager` | class | Implements `WorkspaceManagerInterface` over an insertion-ordered id map and one active id the instance owns, resolving `active` through that map on every read and holding no emitter. A supplied store adds lenient snapshot `open` and `save` operations. Event defaults flow into workspaces created through the registry, while observability remains owned by each workspace. |
142
- | `MemoryWorkspaceStore` | class | Holds workspace snapshots in the current process. |
143
- | `DatabaseWorkspaceStore` | class | Persists workspace snapshots in a database table. Snapshots occupy one opaque column and are narrowed when read back from the storage boundary. |
138
+ | Name | Kind | Signature | Summary |
139
+ | ------------------------ | ----- | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
140
+ | `Workspace` | class | `new (options?: WorkspaceOptions) => WorkspaceInterface` | Implements `WorkspaceInterface` over one insertion-ordered path map the instance owns, projecting fresh arrays on every read. Whole-file edits create text files, ranged edits operate only on existing text files, and binary files remain available through construction-time hydration. Mutations emit after the file map has changed. |
141
+ | `WorkspaceManager` | class | `new (options?: WorkspaceManagerOptions) => WorkspaceManagerInterface` | Implements `WorkspaceManagerInterface` over an insertion-ordered id map and one active id the instance owns, resolving `active` through that map on every read and holding no emitter. A supplied store adds lenient snapshot `open` and `save` operations. Event defaults flow into workspaces created through the registry, while observability remains owned by each workspace. |
142
+ | `MemoryWorkspaceStore` | class | `new () => WorkspaceStoreInterface` | Holds workspace snapshots in the current process. |
143
+ | `DatabaseWorkspaceStore` | class | `new (table: TableInterface<WorkspaceSnapshotRow>) => WorkspaceStoreInterface` | Persists workspace snapshots in a database table. Snapshots occupy one opaque column and are narrowed when read back from the storage boundary. |
144
144
 
145
145
  ### `Workspace`
146
146
 
@@ -472,7 +472,7 @@
472
472
  "storage": "agents/skills/orkestrel-publish/references/wave.md",
473
473
  "destination": ".agents/skills/orkestrel-publish/references/wave.md",
474
474
  "executable": false,
475
- "digest": "b6944e189426c578817610d26583cd51c1deec43cd88814c49b2022221035960"
475
+ "digest": "cb20949b031e9b9b7a2d0202c9b4d6f8fce1657e2f9e9bb59ebec55e4f75d71d"
476
476
  },
477
477
  {
478
478
  "storage": "agents/skills/orkestrel-publish/references/window.md",
@@ -604,7 +604,7 @@
604
604
  "storage": "claude/agents/orkestrel.md",
605
605
  "destination": ".claude/agents/orkestrel.md",
606
606
  "executable": false,
607
- "digest": "19b22439f9653ca068e0f217ee82de765d869b332dc655875d408e4ec8942b10"
607
+ "digest": "e38ce6624566e4bb00281516faf8ea67869f16e5a4ecbc96ddda7aa263d1e94b"
608
608
  },
609
609
  {
610
610
  "storage": "claude/agents/planner.md",
@@ -670,7 +670,7 @@
670
670
  "storage": "claude/rules/names.md",
671
671
  "destination": ".claude/rules/names.md",
672
672
  "executable": false,
673
- "digest": "d2131626cba8b83074fcfd979e22ca4a5bcd75bbc818fc0af92ac21c3d9bf752"
673
+ "digest": "c92326ad5ab3a786479205ebc9543f19f9b43909b0f4b86c196372768d4ca624"
674
674
  },
675
675
  {
676
676
  "storage": "claude/rules/patterns.md",
@@ -964,37 +964,37 @@
964
964
  "storage": "guides/abort.md",
965
965
  "destination": "guides/abort.md",
966
966
  "executable": false,
967
- "digest": "f272c4a4d7818419120df7eb529f805ae31e623ffdb03556d4784c043f0a8fc5"
967
+ "digest": "bec8bbd8ac7ef08405abda3e4c8e450bc2279045982fb28710380ecea080002b"
968
968
  },
969
969
  {
970
970
  "storage": "guides/agent.md",
971
971
  "destination": "guides/agent.md",
972
972
  "executable": false,
973
- "digest": "675cafb567a893dc7bf0f296ceac7022534b2509fa34b6bbaf68fc6e68aad2dd"
973
+ "digest": "e4efd816f5bd77dafb2ad223d529e94806cbbeb1fe11dffe0b8b4cdc532cfcef"
974
974
  },
975
975
  {
976
976
  "storage": "guides/brief.md",
977
977
  "destination": "guides/brief.md",
978
978
  "executable": false,
979
- "digest": "55fd0d63fccf1af8329eea17179a3fdf158ed953b6d46164f8672bee2edffd3b"
979
+ "digest": "80788c817e14dcd5b08bcf7a4fd1a94fe3f60629e8d4a1ca6656460b80c502a9"
980
980
  },
981
981
  {
982
982
  "storage": "guides/browser.md",
983
983
  "destination": "guides/browser.md",
984
984
  "executable": false,
985
- "digest": "35ef0b7b4f7050de94ef7fb408bf285571d02ac1af9cace23b0ad3420bc81e2e"
985
+ "digest": "30260e48f94ef0c6cfdc8364b8d6c286b1107820c0ed2301a311ea8537457cf5"
986
986
  },
987
987
  {
988
988
  "storage": "guides/budget.md",
989
989
  "destination": "guides/budget.md",
990
990
  "executable": false,
991
- "digest": "748b1da40f61d6f39335253595885aae3c8faf94e324c6256c72295b4b32c260"
991
+ "digest": "e00376f740c0f9d78462bf4549012e4eeb154e240473afd0c10d3a831f3a7199"
992
992
  },
993
993
  {
994
994
  "storage": "guides/capture.md",
995
995
  "destination": "guides/capture.md",
996
996
  "executable": false,
997
- "digest": "14f693ead9a396ee9cb6d1554fb170e09c996c02db618852e391e8e37ccb585c"
997
+ "digest": "5335caf1c48db6db63ae69dada251e02d981ccce8863c760fc50cf8e27697fed"
998
998
  },
999
999
  {
1000
1000
  "storage": "guides/codec.md",
@@ -1006,265 +1006,265 @@
1006
1006
  "storage": "guides/console.md",
1007
1007
  "destination": "guides/console.md",
1008
1008
  "executable": false,
1009
- "digest": "6f487af2635e8b40555112e4826869ca938fa485f53b405bc56b0304257abf8a"
1009
+ "digest": "3097c0c41471c31fd39a13776b7fab216af282471a959064bee7a669abd12b30"
1010
1010
  },
1011
1011
  {
1012
1012
  "storage": "guides/contract.md",
1013
1013
  "destination": "guides/contract.md",
1014
1014
  "executable": false,
1015
- "digest": "df54f956f43a099c02a1ce06b8a1340b042ed1c0e25968535cc764328bcdee98"
1015
+ "digest": "3bf2b7ad3ec46b08cbd94e368f5bb19493141a2ef2b1cf0abecf38f4f0b696b8"
1016
1016
  },
1017
1017
  {
1018
1018
  "storage": "guides/csv.md",
1019
1019
  "destination": "guides/csv.md",
1020
1020
  "executable": false,
1021
- "digest": "9b0c9f7913cf89d1ec168cff811bbc90ebc993fc67e44b1401ac78cf66f3db71"
1021
+ "digest": "6593a8d8573ab43a7ab786e42e63789cdd9ad1d5b201c6337738b70ce3b896e3"
1022
1022
  },
1023
1023
  {
1024
1024
  "storage": "guides/database.md",
1025
1025
  "destination": "guides/database.md",
1026
1026
  "executable": false,
1027
- "digest": "8cd5338fcca2e13cebbe5c221adda35f7032bde120f3a3350fdc074acc89c42c"
1027
+ "digest": "206f4bcb62cee4bd7630ca93df0dcfa28b4b8df1b8f593a997a4cf2a4392811c"
1028
1028
  },
1029
1029
  {
1030
1030
  "storage": "guides/emitter.md",
1031
1031
  "destination": "guides/emitter.md",
1032
1032
  "executable": false,
1033
- "digest": "542d147733961665e33e4a8e7048b2c05c05cb930ea67f3717e7e81b0918792c"
1033
+ "digest": "a00d3c7509419537ea9115f2b2c16670a243bb52721a7cb10b6fa2b6a370d0f4"
1034
1034
  },
1035
1035
  {
1036
1036
  "storage": "guides/form.md",
1037
1037
  "destination": "guides/form.md",
1038
1038
  "executable": false,
1039
- "digest": "67c37642c8710110a5e7297b2a2ecc34e27e484eb10d458b155cd21c4bb428b8"
1039
+ "digest": "cc07f605a86dc8e5ed4b09e6037021243af3421160e9f090c196431a3e3a4797"
1040
1040
  },
1041
1041
  {
1042
1042
  "storage": "guides/guide.md",
1043
1043
  "destination": "guides/guide.md",
1044
1044
  "executable": false,
1045
- "digest": "84a4806796d520b9a396515f36f5657d2c2b086393935233130ea915995cc31a"
1045
+ "digest": "e1e677fe395af8153c5ceeb496630784507cee05d17f6f5cdaf7f9a221033117"
1046
1046
  },
1047
1047
  {
1048
1048
  "storage": "guides/html.md",
1049
1049
  "destination": "guides/html.md",
1050
1050
  "executable": false,
1051
- "digest": "efe0e6a980cddf9680d86a9676bec77aa9bf332d5c4adecde86f7a848c48e580"
1051
+ "digest": "9c868beacfc7e9394af790854ae8237b994d5295fab5ffd3fe9c612894bc0cbf"
1052
1052
  },
1053
1053
  {
1054
1054
  "storage": "guides/indexeddb.md",
1055
1055
  "destination": "guides/indexeddb.md",
1056
1056
  "executable": false,
1057
- "digest": "cb1fa6886a466f5852d694c1dffef09acc49a5e5f0656583842aba9fe60cc5b4"
1057
+ "digest": "f1fd7a74ce2e816cf41d724320639b2ea37a4ed17ad920c29d64530cdd8a64d9"
1058
1058
  },
1059
1059
  {
1060
1060
  "storage": "guides/interpret.md",
1061
1061
  "destination": "guides/interpret.md",
1062
1062
  "executable": false,
1063
- "digest": "496dfc8f82472c713fc13a799cbcd2e415aa6506af238374fc23fd255813f788"
1063
+ "digest": "2096b2c52d8551ae6689aec8d4530bb87b4da34f5bec205da31e309dab7f13b5"
1064
1064
  },
1065
1065
  {
1066
1066
  "storage": "guides/lsp.md",
1067
1067
  "destination": "guides/lsp.md",
1068
1068
  "executable": false,
1069
- "digest": "b53c987ec732d91d421640b07c53a61766da656d9dbe2c5f3a1015904dfb4da3"
1069
+ "digest": "708423d96a9122adf8982dadb6fbdf54d81fd8ca3fb7c01cdaa85869ad76fd7e"
1070
1070
  },
1071
1071
  {
1072
1072
  "storage": "guides/markdown.md",
1073
1073
  "destination": "guides/markdown.md",
1074
1074
  "executable": false,
1075
- "digest": "931bb821dfbbd28f805063e5a601f0113ffdfa783a670d83fb4b866a39bc1626"
1075
+ "digest": "5d6025ba5a260d3acb17803275be49c3203bb7d41fe71410c9c722b501d34afb"
1076
1076
  },
1077
1077
  {
1078
1078
  "storage": "guides/mcp.md",
1079
1079
  "destination": "guides/mcp.md",
1080
1080
  "executable": false,
1081
- "digest": "b50d2ccb4732ed69262959dcc3a75510c4e1981a394c4bad823b4d5664c3aeef"
1081
+ "digest": "309fd1a40927c866cc43186ce4629c44f30d7be846d04f848bc992b3871d8a96"
1082
1082
  },
1083
1083
  {
1084
1084
  "storage": "guides/middleware.md",
1085
1085
  "destination": "guides/middleware.md",
1086
1086
  "executable": false,
1087
- "digest": "ee41b2c21390a2a81415dc5aae18d850a5d3c27c3cd354734f2f381d58b652b7"
1087
+ "digest": "39579242328adc69baf4d842c4bc560c83cea5c1e74ad1b09e40a7ca3ed9db55"
1088
1088
  },
1089
1089
  {
1090
1090
  "storage": "guides/msg.md",
1091
1091
  "destination": "guides/msg.md",
1092
1092
  "executable": false,
1093
- "digest": "958b9fbd2dfb9dfa63ac394a7af87716cc965c3990a6306d8d136e3f633c4dcc"
1093
+ "digest": "bcd26b7f041e2f0c8b34137f8132b81754071cf6a8889d3aea6f5b13cda457e9"
1094
1094
  },
1095
1095
  {
1096
1096
  "storage": "guides/ndjson.md",
1097
1097
  "destination": "guides/ndjson.md",
1098
1098
  "executable": false,
1099
- "digest": "73df4f2c2283259fe0b12cd257ceda9302fe1bd9b0847a84024ed8c3e385ef51"
1099
+ "digest": "5e4e2039f5b93b867b4e58d95e47d9afc9063ebe571d66e4139d9c37436ee700"
1100
1100
  },
1101
1101
  {
1102
1102
  "storage": "guides/ollama.md",
1103
1103
  "destination": "guides/ollama.md",
1104
1104
  "executable": false,
1105
- "digest": "2dcfdbcf6df1df629f5902f394536c2fc37cbd14fe5e27e101f1ee5548a58c21"
1105
+ "digest": "93cbdf9a45e25bebc7a18033593213b39f194f9c5514f22325e1c1a7166b23b2"
1106
1106
  },
1107
1107
  {
1108
1108
  "storage": "guides/pool.md",
1109
1109
  "destination": "guides/pool.md",
1110
1110
  "executable": false,
1111
- "digest": "5616dfddf50f2e4a3a81847bcd1e1596ff73c78d464bb2f5c7deee26758db6a7"
1111
+ "digest": "5fc46276e54f04aff1354b4479086aa70e609200576c2f723024c8b314b90417"
1112
1112
  },
1113
1113
  {
1114
1114
  "storage": "guides/probe.md",
1115
1115
  "destination": "guides/probe.md",
1116
1116
  "executable": false,
1117
- "digest": "793e797e3bbeae2a66782db95081db31209ea0e1ee0005b6ce58ccf1a5baa6ed"
1117
+ "digest": "4448b57b45cb2832fd34e2fd92e99b483fb93dc5483a4fe024f363341fe62dd3"
1118
1118
  },
1119
1119
  {
1120
1120
  "storage": "guides/process.md",
1121
1121
  "destination": "guides/process.md",
1122
1122
  "executable": false,
1123
- "digest": "26b6109585bc4b8069ff3e4e948c477cd61d81e402ffdbf587fdbfaf46f3f4f9"
1123
+ "digest": "9711caa51f35aaa5d4102f98d7a8cfd940c6308b6351a5035824a93ca05878a9"
1124
1124
  },
1125
1125
  {
1126
1126
  "storage": "guides/program.md",
1127
1127
  "destination": "guides/program.md",
1128
1128
  "executable": false,
1129
- "digest": "99b9cbad800f29bc01d66e212ea2a91b791e449b195ccefd0eb0f6605a502b03"
1129
+ "digest": "46ea608eb97dc77a87453bb42103a3f58769b36c208bf31e70a206e10e6e35df"
1130
1130
  },
1131
1131
  {
1132
1132
  "storage": "guides/qualifier.md",
1133
1133
  "destination": "guides/qualifier.md",
1134
1134
  "executable": false,
1135
- "digest": "efc4b6f3dc3791cd0e4cf3c5260c651fa243133713f758dca270ef8c228c607f"
1135
+ "digest": "b67c14f568fb03ea4014a71926d7e38d769e53eba003e870d57a124e60cc5270"
1136
1136
  },
1137
1137
  {
1138
1138
  "storage": "guides/queue.md",
1139
1139
  "destination": "guides/queue.md",
1140
1140
  "executable": false,
1141
- "digest": "4990f36f3b06daaefafd7e41ad575da9b20a7b3613a4b848b40bd35343d28540"
1141
+ "digest": "9290e94e6cefcedd0c1f7c1f74563dd801d4d4d749d321c46dfbefbb2940316d"
1142
1142
  },
1143
1143
  {
1144
1144
  "storage": "guides/rater.md",
1145
1145
  "destination": "guides/rater.md",
1146
1146
  "executable": false,
1147
- "digest": "2a3b3fe8ccf8f510fc514a97f81e06b648167dbddc2157c18b1c44c87cf1f7e1"
1147
+ "digest": "e7d5d773a3198893ad01037b40785b08d2719b5170a079feb7355cc0d849f2a8"
1148
1148
  },
1149
1149
  {
1150
1150
  "storage": "guides/reason.md",
1151
1151
  "destination": "guides/reason.md",
1152
1152
  "executable": false,
1153
- "digest": "1673e32e8c2a09f33aaf3ba807b71e45f210a87d1233c61a6d38addb028f1c33"
1153
+ "digest": "31e748054261734e2881a0a85ad16fdce995274fb11317d7eaf185ad3fe095a4"
1154
1154
  },
1155
1155
  {
1156
1156
  "storage": "guides/relation.md",
1157
1157
  "destination": "guides/relation.md",
1158
1158
  "executable": false,
1159
- "digest": "ef45c6618f301e9dbaaff675cb1cf6e2da1df5cd1cf4a06fb64b34cb10754a9b"
1159
+ "digest": "3cd02efa7e5f43997cc77da3a355c31c5ca2cd48818941d49f3ffa9036e8a17d"
1160
1160
  },
1161
1161
  {
1162
1162
  "storage": "guides/router.md",
1163
1163
  "destination": "guides/router.md",
1164
1164
  "executable": false,
1165
- "digest": "890c46d9749875a48f5ec1981e9a8da90c93ad961b2ed092549172d83546f4e9"
1165
+ "digest": "789de905998bf6b0719660c0f550838e7092cf7314d6f418b0e4aab531e055fc"
1166
1166
  },
1167
1167
  {
1168
1168
  "storage": "guides/scaffold.md",
1169
1169
  "destination": "guides/scaffold.md",
1170
1170
  "executable": false,
1171
- "digest": "0051b423298277bd7fd2d12a81f6a858a4fd633bd3a44c735a0d8db8dbdd866d"
1171
+ "digest": "9311d0b55f5d08c20ce417b84ac115e3c8400cf167cf7d108d1ef1cb846de837"
1172
1172
  },
1173
1173
  {
1174
1174
  "storage": "guides/sea.md",
1175
1175
  "destination": "guides/sea.md",
1176
1176
  "executable": false,
1177
- "digest": "a138945b7ac99fa778d3d116d15760a3773c4ea85ea94c1ff12f07bdd0330de5"
1177
+ "digest": "326a964896ccb9f590b1b9a983f3541f04d0229459def0aad085b89de6544a64"
1178
1178
  },
1179
1179
  {
1180
1180
  "storage": "guides/server.md",
1181
1181
  "destination": "guides/server.md",
1182
1182
  "executable": false,
1183
- "digest": "4290030d156bc22f5741ad8acfedaba7eda9197cd6ffaaba06937aef0a00cd05"
1183
+ "digest": "c7424beb8d1c38cdff10e5ea8c1362037112780ff114a72eee0dcca9f94ffd47"
1184
1184
  },
1185
1185
  {
1186
1186
  "storage": "guides/sqlite.md",
1187
1187
  "destination": "guides/sqlite.md",
1188
1188
  "executable": false,
1189
- "digest": "d2ab5c43fbf646596fe146154ed818ca64e8434ab3c7b3e68b5a4319dc3112af"
1189
+ "digest": "11997169616f8f5b6af58c5e25a08c7d82b1adf259fb92e87909ee63848fa8fa"
1190
1190
  },
1191
1191
  {
1192
1192
  "storage": "guides/sse.md",
1193
1193
  "destination": "guides/sse.md",
1194
1194
  "executable": false,
1195
- "digest": "bb2c1a98674ba4eee328125173d682c68724a788f76dfd4123a00dab837b6cc8"
1195
+ "digest": "324dbb50b4431e1f7e619b76877875b6374a53e34bb9d71c4c46c7d72e3469ba"
1196
1196
  },
1197
1197
  {
1198
1198
  "storage": "guides/study.md",
1199
1199
  "destination": "guides/study.md",
1200
1200
  "executable": false,
1201
- "digest": "a2838d667df274296563865cf0735901c2082e7cede72fa92125103cf887dc17"
1201
+ "digest": "f60609cd096502cb25483d271aea7ee886a6a62e6096a904abe55014d9e74555"
1202
1202
  },
1203
1203
  {
1204
1204
  "storage": "guides/table.md",
1205
1205
  "destination": "guides/table.md",
1206
1206
  "executable": false,
1207
- "digest": "7cf56ef990816d9345e48a4b5c4fcf7a32960298066d607abab7c9a8f0bceacd"
1207
+ "digest": "bb664b8d9a5997d61563d0610e7c6887340a9649a5a91a4c8900d9b9823f17ff"
1208
1208
  },
1209
1209
  {
1210
1210
  "storage": "guides/template.md",
1211
1211
  "destination": "guides/template.md",
1212
1212
  "executable": false,
1213
- "digest": "4a1bab2e9cf19f124419ee14baf17b702699f2b53f1762b659c75e3baa412327"
1213
+ "digest": "ea734629cb3083c3dcda94e853330760fd9838aa2e952d98b410f1a671584942"
1214
1214
  },
1215
1215
  {
1216
1216
  "storage": "guides/terminal.md",
1217
1217
  "destination": "guides/terminal.md",
1218
1218
  "executable": false,
1219
- "digest": "3b66a33475881741a199b3d13050457c10bc4cc08312643d890c822211ae8ee6"
1219
+ "digest": "a0fbdeac6ee8eb65ea4e4a0737f2f096dbf1e2f021440d586575059992f66856"
1220
1220
  },
1221
1221
  {
1222
1222
  "storage": "guides/test.md",
1223
1223
  "destination": "guides/test.md",
1224
1224
  "executable": false,
1225
- "digest": "dbfcb7b98dfe1b8f824b661c7f15b3a4c474f8ef66f21c143f69639dc457adf2"
1225
+ "digest": "4511b496d349e889788687e2ba293a2ebb615cd2b463299e78e847b7cc58cc44"
1226
1226
  },
1227
1227
  {
1228
1228
  "storage": "guides/timeout.md",
1229
1229
  "destination": "guides/timeout.md",
1230
1230
  "executable": false,
1231
- "digest": "f767022f246db2db76b8e2cd568978e3e0cb3a1104b6c4dd9c516b23bfeffd19"
1231
+ "digest": "edd80ade6308fff2a8361b76bd36be1516a7c727dba34f0553d2b87bef5c15e7"
1232
1232
  },
1233
1233
  {
1234
1234
  "storage": "guides/tool.md",
1235
1235
  "destination": "guides/tool.md",
1236
1236
  "executable": false,
1237
- "digest": "10c8378d1fa84d45817439a7c6e3678c3afb13a6690e2579d0d3bccd4c58df1c"
1237
+ "digest": "13bd0ba1b57b8978234f225ae67469dbd7347e3b840d56e4acba340a8d78217e"
1238
1238
  },
1239
1239
  {
1240
1240
  "storage": "guides/toolbox.md",
1241
1241
  "destination": "guides/toolbox.md",
1242
1242
  "executable": false,
1243
- "digest": "b20c58d347a351b439ae1ac9a2e05488380ef1eb90c19ee5f63264c2125bf4be"
1243
+ "digest": "536f1eb438c25770421a86c35bb42107041d90bfb28a69069b23d6dd4c04145f"
1244
1244
  },
1245
1245
  {
1246
1246
  "storage": "guides/websocket.md",
1247
1247
  "destination": "guides/websocket.md",
1248
1248
  "executable": false,
1249
- "digest": "2db26ff03790d86cf828162db56d16a58991bdfc6444ffaa88732374bd8d2785"
1249
+ "digest": "8b2abb42919dde94b59deebc8fc2a10e18dc04e323754b850fa4a57e782d2ac1"
1250
1250
  },
1251
1251
  {
1252
1252
  "storage": "guides/worker.md",
1253
1253
  "destination": "guides/worker.md",
1254
1254
  "executable": false,
1255
- "digest": "441c0c0a3a5b425fb91034d953e2e6a1d05d3dcb29702c600a43e048bac24afd"
1255
+ "digest": "39ffc2a919522d806f4bcaf0424e641c78cb2211bb6bf82ddf78188758bfe1c1"
1256
1256
  },
1257
1257
  {
1258
1258
  "storage": "guides/workflow.md",
1259
1259
  "destination": "guides/workflow.md",
1260
1260
  "executable": false,
1261
- "digest": "2ac4e783c908f31377ce3381065150ba4c02afbcff65cbfcdc2c960692af464c"
1261
+ "digest": "8796f9cb552112dbe50a2a65db72f1347bd4ff35d72279e4809a6d21435f87ec"
1262
1262
  },
1263
1263
  {
1264
1264
  "storage": "guides/workspace.md",
1265
1265
  "destination": "guides/workspace.md",
1266
1266
  "executable": false,
1267
- "digest": "df7b4411caba1e409bd4a12e247c5e63136df9d3fecf3b8b91cf8ffd80b076a2"
1267
+ "digest": "ee9d57c3438969443d4ce006810455a31128990a1311e3fe6b352ccd3f09c2e1"
1268
1268
  },
1269
1269
  {
1270
1270
  "storage": "scripts/browsers.sh",
@@ -1318,7 +1318,7 @@
1318
1318
  "storage": "tests/setupPolicy.ts",
1319
1319
  "destination": "tests/setupPolicy.ts",
1320
1320
  "executable": false,
1321
- "digest": "311efff7dce707c5f8553271076d7de853da5c9f795f2ba83f19e35131bbc6ce"
1321
+ "digest": "66ae0b2a0905d69cb4c85d0eafce5994beb69c8f27e54afdfbe84a4bad528ca1"
1322
1322
  }
1323
1323
  ],
1324
1324
  "roots": [
@@ -2141,5 +2141,5 @@
2141
2141
  ]
2142
2142
  }
2143
2143
  ],
2144
- "digest": "6c42ce973b86ead3c3ded38397d4574c880d85e4c7a971682f35ad8fa5fc3443"
2144
+ "digest": "f7b980503c2ad03619c833ea066b67d682ec26c894ea5b52a6f013c93aaa491f"
2145
2145
  }
@@ -144,9 +144,11 @@ export function createPolicySurfaceGuide(names: readonly string[]): string {
144
144
  '',
145
145
  '## Surface',
146
146
  '',
147
- '| Name | Kind | Summary |',
148
- '| ---- | ---- | ------- |',
149
- ...names.map((name) => `| \`${name}\` | function | Declares a fixture name. |`),
147
+ '| Name | Kind | Signature | Summary |',
148
+ '| ---- | ---- | --------- | ------- |',
149
+ ...names.map(
150
+ (name) => `| \`${name}\` | function | \`() => void\` | Declares a fixture name. |`,
151
+ ),
150
152
  '',
151
153
  ].join('\n')
152
154
  }