@orkestrel/scaffold 0.0.132 → 0.0.134

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 (86) hide show
  1. package/dist/agents/skills/orkestrel-dispatch/scripts/bench.js +61 -96
  2. package/dist/agents/skills/orkestrel-dispatch/scripts/brief.js +48 -76
  3. package/dist/agents/skills/orkestrel-dispatch/scripts/chain.js +27 -66
  4. package/dist/agents/skills/orkestrel-dispatch/scripts/cite.js +31 -64
  5. package/dist/agents/skills/orkestrel-dispatch/scripts/launch.js +43 -57
  6. package/dist/agents/skills/orkestrel-dispatch/scripts/login.js +43 -86
  7. package/dist/agents/skills/orkestrel-dispatch/scripts/patch.js +68 -104
  8. package/dist/agents/skills/orkestrel-dispatch/scripts/result.js +35 -69
  9. package/dist/agents/skills/orkestrel-dispatch/scripts/sweep.js +47 -84
  10. package/dist/agents/skills/orkestrel-falsify/scripts/mutate.js +134 -116
  11. package/dist/agents/skills/orkestrel-harden/scripts/discovery.js +38 -90
  12. package/dist/agents/skills/orkestrel-harden/scripts/interleave.js +39 -103
  13. package/dist/agents/skills/orkestrel-harden/scripts/measure.js +40 -89
  14. package/dist/agents/skills/orkestrel-harden/scripts/titles.js +41 -87
  15. package/dist/agents/skills/orkestrel-parallel/scripts/cases.js +43 -88
  16. package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +1018 -194
  17. package/dist/agents/skills/orkestrel-publish/scripts/compare.js +40 -60
  18. package/dist/agents/skills/orkestrel-publish/scripts/pins.js +47 -81
  19. package/dist/agents/skills/orkestrel-publish/scripts/steps.js +66 -104
  20. package/dist/agents/skills/orkestrel-publish/scripts/swap.js +74 -88
  21. package/dist/agents/skills/orkestrel-publish/scripts/wave.js +95 -108
  22. package/dist/agents/skills/orkestrel-publish/scripts/window.js +55 -96
  23. package/dist/agents/skills/orkestrel-scout/scripts/map.js +54 -101
  24. package/dist/bin/main.js +30 -6
  25. package/dist/bin/main.js.map +1 -1
  26. package/dist/host/agents/orchestration.md +1 -0
  27. package/dist/host/agents/skills/orkestrel-dispatch/scripts/bench.ts +81 -97
  28. package/dist/host/agents/skills/orkestrel-dispatch/scripts/brief.ts +64 -72
  29. package/dist/host/agents/skills/orkestrel-dispatch/scripts/chain.ts +41 -63
  30. package/dist/host/agents/skills/orkestrel-dispatch/scripts/cite.ts +56 -79
  31. package/dist/host/agents/skills/orkestrel-dispatch/scripts/launch.ts +61 -74
  32. package/dist/host/agents/skills/orkestrel-dispatch/scripts/login.ts +59 -89
  33. package/dist/host/agents/skills/orkestrel-dispatch/scripts/patch.ts +87 -106
  34. package/dist/host/agents/skills/orkestrel-dispatch/scripts/result.ts +57 -76
  35. package/dist/host/agents/skills/orkestrel-dispatch/scripts/sweep.ts +73 -88
  36. package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +2 -2
  37. package/dist/host/agents/skills/orkestrel-falsify/scripts/mutate.ts +167 -119
  38. package/dist/host/agents/skills/orkestrel-harden/references/methods.md +1 -1
  39. package/dist/host/agents/skills/orkestrel-harden/scripts/discovery.ts +58 -75
  40. package/dist/host/agents/skills/orkestrel-harden/scripts/interleave.ts +55 -99
  41. package/dist/host/agents/skills/orkestrel-harden/scripts/measure.ts +59 -90
  42. package/dist/host/agents/skills/orkestrel-harden/scripts/titles.ts +60 -80
  43. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +4 -4
  44. package/dist/host/agents/skills/orkestrel-parallel/scripts/cases.ts +71 -108
  45. package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +1288 -239
  46. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +10 -6
  47. package/dist/host/agents/skills/orkestrel-publish/scripts/compare.ts +58 -79
  48. package/dist/host/agents/skills/orkestrel-publish/scripts/pins.ts +66 -87
  49. package/dist/host/agents/skills/orkestrel-publish/scripts/steps.ts +84 -102
  50. package/dist/host/agents/skills/orkestrel-publish/scripts/swap.ts +92 -99
  51. package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +130 -126
  52. package/dist/host/agents/skills/orkestrel-publish/scripts/window.ts +82 -120
  53. package/dist/host/agents/skills/orkestrel-scout/SKILL.md +3 -3
  54. package/dist/host/agents/skills/orkestrel-scout/scripts/map.ts +85 -112
  55. package/dist/host/claude/agents/orkestrel.md +54 -54
  56. package/dist/host/claude/rules/documentation.md +1 -1
  57. package/dist/host/claude/rules/patterns.md +5 -4
  58. package/dist/host/claude/rules/styles.md +1 -1
  59. package/dist/host/claude/rules/tests.md +8 -3
  60. package/dist/host/claude/rules/workspace.md +47 -35
  61. package/dist/host/configs/helpers.ts +40 -15
  62. package/dist/host/dotfiles/oxlintrc.json +62 -0
  63. package/dist/host/guides/browser.md +1 -1
  64. package/dist/host/guides/form.md +79 -4
  65. package/dist/host/guides/queue.md +3 -1
  66. package/dist/host/guides/scaffold.md +95 -67
  67. package/dist/host/guides/table.md +20 -6
  68. package/dist/host/guides/test.md +342 -202
  69. package/dist/host/guides/workflow.md +4 -2
  70. package/dist/host/manifest.json +48 -48
  71. package/dist/host/tests/config.test.ts +201 -11
  72. package/dist/host/tests/policy.test.ts +15 -22
  73. package/dist/host/tests/setupPolicy.ts +43 -36
  74. package/dist/src/core/index.cjs +194 -97
  75. package/dist/src/core/index.cjs.map +1 -1
  76. package/dist/src/core/index.d.cts +27 -13
  77. package/dist/src/core/index.d.ts +27 -13
  78. package/dist/src/core/index.js +192 -97
  79. package/dist/src/core/index.js.map +1 -1
  80. package/dist/src/server/index.cjs +8 -9
  81. package/dist/src/server/index.cjs.map +1 -1
  82. package/dist/src/server/index.d.cts +1 -1
  83. package/dist/src/server/index.d.ts +1 -1
  84. package/dist/src/server/index.js +8 -9
  85. package/dist/src/server/index.js.map +1 -1
  86. package/package.json +5 -5
@@ -320,7 +320,7 @@ The entity, its managers, its factory, its contract, and the error it raises.
320
320
  | `FilterManagerInterface` | interface | `{ filter(), filters(), set(), remove() }` | Manages which rows a grid keeps. |
321
321
  | `SelectionManagerInterface` | interface | `{ keys, select(), clear(), toggle() }` | Manages the rows somebody has picked. |
322
322
  | `ExpansionManagerInterface` | interface | `{ keys, expand(), clear(), toggle() }` | Manages the rows somebody has opened up. |
323
- | `PaginationManagerInterface` | interface | `{ page, limit, offset, count, move(), resize() }` | Manages which stretch of the filtered rows the view shows. |
323
+ | `PaginationManagerInterface` | interface | `{ page, limit, offset, count, move(), locate(), resize() }` | Manages which stretch of the filtered rows the view shows. |
324
324
  | `GridError` | class | `new (code: GridErrorCode, message: string, context?: JSONRecord) => GridError` | Represents an error raised by the grid domain — a machine-readable `code` and optional structured `context`. |
325
325
  | `GridErrorCode` | type | `'SCHEMA' \| 'COLUMN' \| 'KEY' \| 'CELL' \| 'DESTROYED'` | Names the reason a `GridError` carries — the machine-readable code a `catch` branches on. |
326
326
  | `isGridError` | function | `(input: unknown) => input is GridError` | Determines whether a caught value is a grid error, so a `catch` branches on `code` without an assertion. |
@@ -971,6 +971,10 @@ the filter admits, so nothing here can drift out of step with what the grid hold
971
971
  "page 1 of 1" over an empty list needs no separate case for it.
972
972
  - A page beyond the last one clamps to the last one. Narrowing the filter therefore moves the page
973
973
  on its own, and moving to page 9 of 3 shows page 3 rather than nothing.
974
+ - `locate` names the page that holds one row under the current filter and sort, so a host turns to
975
+ a row with `move(locate(key))` and keeps no copy of the lens to work it out. An unpaged grid
976
+ answers `1`, and a key the filter hides or no row holds answers `undefined`, never a page the
977
+ row is not on. `locate` moves nothing.
974
978
  - `resize` keeps the first row the view was showing, so the page moves to wherever that row
975
979
  falls. Resizing is a change of magnification, not a jump to the top.
976
980
 
@@ -988,6 +992,13 @@ grid.pagination.page // 3 — clamped to the last page
988
992
  grid.pagination.offset // 4
989
993
  grid.view.map((row) => row.id) // ['5']
990
994
 
995
+ grid.pagination.locate('3') // 2 — rows 3 and 4 fill the second page
996
+ grid.pagination.locate('9') // undefined — no row holds that key
997
+ grid.filter.set({ column: 'id', operator: 'contains', text: '5' })
998
+ grid.pagination.locate('3') // undefined — the filter hides the row
999
+ grid.pagination.locate('5') // 1 — one admitted row fills one page
1000
+ grid.filter.remove()
1001
+
991
1002
  grid.pagination.resize()
992
1003
  grid.pagination.limit // undefined — not paged
993
1004
  grid.view.length // 5
@@ -1503,10 +1514,11 @@ it either way.
1503
1514
 
1504
1515
  #### `PaginationManagerInterface`
1505
1516
 
1506
- | Method | Returns | Summary |
1507
- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
1508
- | `move` | `void` | Shows another page, counted from one and clamped to the pages that exist. |
1509
- | `resize` | `void` | Sets how many rows a page holds, keeping the first row the view was showing. Leave the argument out to stop paging. |
1517
+ | Method | Returns | Summary |
1518
+ | -------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------- |
1519
+ | `move` | `void` | Shows another page, counted from one and clamped to the pages that exist. |
1520
+ | `locate` | `number` or `undefined` | Finds the page that holds one row under the current filter and sort. |
1521
+ | `resize` | `void` | Sets how many rows a page holds, keeping the first row the view was showing. Leave the argument out to stop paging. |
1510
1522
 
1511
1523
  ### Errors
1512
1524
 
@@ -1623,7 +1635,9 @@ These invariants hold across [`src/core`](../src/core) and this guide.
1623
1635
  `offset` is `(page - 1) * limit` and zero when unpaged; `count` is `max(1, ceil(rows / limit))`
1624
1636
  and `1` when unpaged — so a paged grid with no admitted rows holds one page, and that page's
1625
1637
  `view` is empty. A page beyond the last clamps to the last, including when a filter or a removal
1626
- shrinks the rows underneath it. `resize` keeps the first row the view was showing.
1638
+ shrinks the rows underneath it. `locate` is derived the same way: the page of a key among the rows
1639
+ the filter admits, in the order the sort gives them, `1` when unpaged, and `undefined` for a
1640
+ key the filter hides or no row holds. `resize` keeps the first row the view was showing.
1627
1641
  14. **Every event fires after commit, and a no-op is silent.** No listener sees a state the grid has
1628
1642
  not finished writing, and a call that moves nothing announces nothing — the same sort term twice,
1629
1643
  a toggle back to where it was, a `move` to the index a row already occupies. When one call moves