docks-kit 0.25.0 → 0.26.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/AGENTS.md +6 -6
  2. package/README.md +29 -9
  3. package/cli/dist/docks-kit.js +24688 -0
  4. package/cli/docs/command-guards.md +1 -1
  5. package/cli/docs/install.md +26 -6
  6. package/cli/docs/omp-context.md +1 -1
  7. package/cli/docs/omp-models.md +1 -1
  8. package/cli/src/agentDocs/agentFirstCheck.ts +786 -0
  9. package/cli/src/agentDocs/bridgeCheck.ts +226 -0
  10. package/cli/src/agentDocs/commands.ts +63 -0
  11. package/cli/src/agentDocs/prTemplate.ts +211 -0
  12. package/cli/src/agentDocs/services.ts +202 -0
  13. package/cli/src/agentDocs/shared.ts +730 -0
  14. package/cli/src/agentDocs/verifySkill.ts +136 -0
  15. package/cli/src/argv.ts +25 -1
  16. package/cli/src/commands/agentDocs.ts +29 -0
  17. package/cli/src/commands/plan.ts +29 -0
  18. package/cli/src/commands/skill.ts +29 -0
  19. package/cli/src/commands/update.ts +87 -28
  20. package/cli/src/generated/sotPayload.ts +50 -78
  21. package/cli/src/main.ts +12 -3
  22. package/cli/src/plan/bytes.ts +110 -0
  23. package/cli/src/plan/checkout.ts +341 -0
  24. package/cli/src/plan/commands.ts +1192 -0
  25. package/cli/src/plan/github.ts +816 -0
  26. package/cli/src/plan/records.ts +623 -0
  27. package/cli/src/plan/repository.ts +53 -0
  28. package/cli/src/plan/reviews.ts +292 -0
  29. package/cli/src/plan/services.ts +256 -0
  30. package/cli/src/plan/types.ts +164 -0
  31. package/cli/src/skills/commands.ts +142 -0
  32. package/cli/src/skills/config.json +30 -0
  33. package/cli/src/skills/files.ts +74 -0
  34. package/cli/src/skills/frontmatter.ts +148 -0
  35. package/cli/src/skills/guard.ts +366 -0
  36. package/cli/src/skills/kitGate.ts +406 -0
  37. package/cli/src/skills/rubric.ts +143 -0
  38. package/package.json +7 -4
@@ -10,7 +10,7 @@ The policy keeps only deny rules. Where omp's critical-command check acts,
10
10
  the form is denied. omp also denies a `$` or a backtick after `git push`,
11
11
  because the agent can always write the ref literally.
12
12
 
13
- By owner decision (0.22.8, #126), the kit ships no omp
13
+ By owner decision (0.22.8, DocksDocks/public#126), the kit ships no omp
14
14
  prompt rule. The kit's `bash.patterns` holds only deny rules and the `trash *`
15
15
  allow. Under omp's default `tools.approvalMode: yolo`, omp runs every
16
16
  command that no deny matches without a question, in the main session and in
@@ -6,8 +6,8 @@ Hosts outside this matrix fail before a launcher can fall back to Bun source.
6
6
  ## 1. Repo checkout (development / current users)
7
7
 
8
8
  ```
9
- git clone https://github.com/DocksDocks/public.git ~/projects/public
10
- cd ~/projects/public
9
+ git clone https://github.com/DocksDocks/docks-kit.git ~/projects/docks-kit
10
+ cd ~/projects/docks-kit
11
11
  ./docks-kit sync
12
12
  ```
13
13
 
@@ -17,6 +17,23 @@ version matches `package.json`. It then falls back to Bun-from-source and
17
17
  auto-installs Bun plus `node_modules` when needed. Each launcher reports and
18
18
  bypasses an ignored stale build.
19
19
 
20
+ ### Move a checkout of DocksDocks/public
21
+
22
+ The kit moved from DocksDocks/public to DocksDocks/docks-kit. To move a
23
+ checkout of DocksDocks/public, run these commands from the checkout's root:
24
+
25
+ ```
26
+ git remote set-url origin https://github.com/DocksDocks/docks-kit.git
27
+ ./docks-kit update # Linux and macOS
28
+ .\docks-kit.ps1 update # Windows
29
+ ./docks-kit sync # Linux and macOS
30
+ .\docks-kit.ps1 sync # Windows
31
+ ```
32
+
33
+ The update pulls from DocksDocks/docks-kit. The sync then deploys the skills
34
+ with their new report target: a launcher that runs a fresh compiled binary
35
+ skips the sync that the update chains. A global npm install needs nothing.
36
+
20
37
  ## 2. Global via Bun
21
38
 
22
39
  ```
@@ -26,8 +43,11 @@ docks-kit sync
26
43
  bunx docks-kit toolchain check
27
44
  ```
28
45
 
29
- The npm package bundles the CLI and its generated in-memory payload — releases
30
- are versioned config snapshots without publishing the authoring `SoT/` tree.
46
+ The npm package runs one minified JavaScript bundle of the CLI and its generated
47
+ in-memory payload (`cli/dist/docks-kit.js`) — releases are versioned config
48
+ snapshots without publishing the authoring `SoT/` tree. Identifiers stay
49
+ unminified, so a stack trace keeps its names; the source map is a GitHub
50
+ release asset (`docks-kit.js.map`), matched by the bundle's `//# debugId=` line.
31
51
  Kit-home resolution remains available for checkout/package update behavior and
32
52
  display paths, but sync reads do not depend on it.
33
53
 
@@ -49,7 +69,7 @@ a copy that lags behind the pinned release.
49
69
  ## 3. curl installer (POSIX)
50
70
 
51
71
  ```
52
- tmp="$(mktemp)" && curl -fsSL https://raw.githubusercontent.com/DocksDocks/public/main/install.sh -o "$tmp" && bash "$tmp"; rc=$?; rm -f "$tmp"; (exit "$rc")
72
+ tmp="$(mktemp)" && curl -fsSL https://raw.githubusercontent.com/DocksDocks/docks-kit/main/install.sh -o "$tmp" && bash "$tmp"; rc=$?; rm -f "$tmp"; (exit "$rc")
53
73
  ```
54
74
 
55
75
  Download-then-run, never `curl | bash` — stream truncation has bitten this
@@ -61,7 +81,7 @@ installer below.
61
81
  ## 4. PowerShell installer (Windows)
62
82
 
63
83
  ```powershell
64
- Invoke-WebRequest https://raw.githubusercontent.com/DocksDocks/public/main/install.ps1 -OutFile "$env:TEMP\docks-kit-install.ps1"
84
+ Invoke-WebRequest https://raw.githubusercontent.com/DocksDocks/docks-kit/main/install.ps1 -OutFile "$env:TEMP\docks-kit-install.ps1"
65
85
  powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$env:TEMP\docks-kit-install.ps1"
66
86
  Remove-Item "$env:TEMP\docks-kit-install.ps1"
67
87
  ```
@@ -124,7 +124,7 @@ keys carries a kit value that differs from the default omp already applies.
124
124
 
125
125
  ## omp 19.0.0 tools and returned overrides
126
126
 
127
- The owner made these decisions on 2026-11-19 (#184). They apply from 0.24.0.
127
+ The owner made these decisions on 2026-11-19 (DocksDocks/public#184). They apply from 0.24.0.
128
128
 
129
129
  ### Tools that the kit turns on
130
130
 
@@ -523,7 +523,7 @@ At `high`, Sol produces about 19% more tokens per second than Terra. At
523
523
  `xhigh`, the gain is about 24%. Sol also has the lower TTFT and end-to-end
524
524
  time at both levels.
525
525
 
526
- The `reviewer` role stays on GPT-6.1 Terra `high`. The #130 benchmark chose
526
+ The `reviewer` role stays on GPT-6.1 Terra `high`. The DocksDocks/public#130 benchmark chose
527
527
  Terra by escaped defects, not by speed. omp 18.22.2 lists no GPT-6.2 Terra. A
528
528
  move of the reviewer to GPT-6.2 Sol needs a new benchmark.
529
529