docks-kit 0.20.4 → 0.20.5
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/AGENTS.md +1 -1
- package/README.md +2 -1
- package/cli/docs/flags.md +3 -1
- package/cli/src/commands/harnesses.ts +4 -1
- package/cli/src/generated/sotPayload.ts +1 -1
- package/package.json +1 -1
package/AGENTS.md
CHANGED
|
@@ -99,7 +99,7 @@ For per-tool SoT layouts (`SoT/.claude/`, `SoT/.codex/`, `SoT/.omp/`), see the m
|
|
|
99
99
|
- **Effect 4 CLI stack.** The CLI pins `effect@4.0.0-rc.115` (including `effect/unstable/cli`), `@effect/platform-bun@4.0.0-rc.115` (`BunServices.layer`, `BunRuntime.runMain`), `@effect/vitest@4.0.0-rc.115`, and `vitest@5.0.0` (inside the `@effect/vitest` peer range `>=5.0.0 <6.0.0`; 5.0.0 is past the 5.x patch point for GHSA-82fw-gwwq-j7x9, fixed in 5.0.0-rc.2). `@effect/cli` and `@effect/platform` are removed and must not be reintroduced.
|
|
100
100
|
- **Effect skill routing.** Effect work in this checkout must verify migration and API call shapes against the installed declarations under `node_modules/effect/dist/unstable/cli/`, never from memory or a mutable dist-tag. The `effect-ts-setup`, `effect-ts-port`, and `effect-ts-specialist` skills target Effect 3.x and do not apply.
|
|
101
101
|
- **Targeted syncs.** `./docks-kit sync` accepts positional targets: `claude`, `codex`, `agents`, and `omp`. Use the narrowest target that matches the SoT change (for example, `./docks-kit sync omp` for omp-only config edits); targets can be combined with `--dry-run`, `--skip-bubblewrap` (skip optional bubblewrap bootstrap for the Codex Linux sandbox), `--skip-plugin-refresh` (install missing plugins without refreshing existing caches), `--reconcile`, `--prune`, and the deploy-time modifiers `--claude-compact-window=<tokens>` / `--claude-permissive` / `--claude-model=<m>` / `--claude-effort=<level>` / `--claude-advisor=<on|off|default>` / `--codex-model=<m>` / `--codex-effort=<level>` (see `CLAUDE.md` § Deploy-time modifiers).
|
|
102
|
-
- **Per-machine harness selection.** The SQLite store `~/.docks-kit/kit.db` drives a flag-less sync. A missing selection selects `claude`, `codex`, and `agents`; it never selects `omp` implicitly. `sync` never prompts and never writes the selection. `docks-kit harnesses` is the only command that writes the `harness_selection` table. The same store holds the independent `omp_session` table, which only `docks-kit omp` writes, and a TTL cache (`cache_entry`) for the live Anthropic model list and `toolchain outdated` lookups. `kitDb.ts withKitDb` is the only opener: it runs the append-only `MIGRATIONS`, imports a legacy `state.json` once and renames it to `state.json.migrated`, and refuses a store from a newer schema. Cache rows carry the kit version as fingerprint, so a new release refetches them.
|
|
102
|
+
- **Per-machine harness selection.** The SQLite store `~/.docks-kit/kit.db` drives a flag-less sync. A missing selection selects `claude`, `codex`, and `agents`; it never selects `omp` implicitly. `sync` never prompts and never writes the selection. `docks-kit harnesses` is the only command that writes the `harness_selection` table. With no stored selection, its picker pre-ticks all four harnesses, `omp` included, so a new machine opts out of omp instead of opting in; nothing changes until the picker saves. The same store holds the independent `omp_session` table, which only `docks-kit omp` writes, and a TTL cache (`cache_entry`) for the live Anthropic model list and `toolchain outdated` lookups. `kitDb.ts withKitDb` is the only opener: it runs the append-only `MIGRATIONS`, imports a legacy `state.json` once and renames it to `state.json.migrated`, and refuses a store from a newer schema. Cache rows carry the kit version as fingerprint, so a new release refetches them.
|
|
103
103
|
- **Additive by default.** Keys present in deployed config but absent from SoT are preserved on default sync. This protects user-only additions, but means drift accumulates — neither flag-less reset can clean it up. The one exception is the Claude `removed` manifest (`claudeSync.ts REMOVED_MANIFEST, baseline removal inventory`), a curated list of unambiguous kit-owned artifacts that `claudeSync.ts syncRemovals, baseline artifact prune` force-prunes on every sync, including the home-relative `~/.local/bin/session-relay` artifact installed outside `~/.claude`; see `CLAUDE.md` § Pruning stale artifacts.
|
|
104
104
|
- **`--reconcile` / `--prune` are the kit-owned reconcile flags.** Orthogonal — `--reconcile` reconciles the settings layer (SoT-declared keys/tables/arrays win; user-only keys and nested objects are preserved; permissions arrays are replaced wholesale by SoT). `--prune` uninstalls kit-managed installations not in the SoT (plugins, marketplaces, and `~/.agents/skills/*` entries tracked in `~/.agents/.kit-managed-skills`). Combine for a full reset to SoT's kit-managed scope. User-only additions outside the kit's scope (custom env vars, mcpServers, manually-installed skills, third-party plugins not declared in SoT) are always preserved. Each tool's per-tool file documents the specific paths and diff recipes.
|
|
105
105
|
- **SOLID-aligned modules.** Axis modules own one concern each (see layout); orchestrators (`claudeSync.ts`, `codexSync.ts`, `skillsSync.ts`, `ompSync.ts`, `index.ts`, `argv.ts`, `parseArgs.ts`) keep prior exports. New shared shapes go in `sharedTypes.d.ts`, never a second local copy. The public CLI seam is `cli/src/engine.ts`.
|
package/README.md
CHANGED
|
@@ -94,7 +94,8 @@ and a later flag-less sync reverts them. Full reference: `docks-kit docs flags`
|
|
|
94
94
|
(`--reconcile` / `--prune`).
|
|
95
95
|
- **Per-machine selection** — `~/.docks-kit/kit.db` drives a flag-less sync.
|
|
96
96
|
A missing selection selects Claude Code, Codex, and universal skills. It does not
|
|
97
|
-
select omp. Use `docks-kit harnesses` to view or change the selection.
|
|
97
|
+
select omp. Use `docks-kit harnesses` to view or change the selection. With no
|
|
98
|
+
stored selection, its picker pre-ticks every harness, omp included.
|
|
98
99
|
- **Idempotent** — every step is safe to re-run; no-change syncs are no-ops.
|
|
99
100
|
- **Toolchain floors** — `SoT/toolchain.json` records the kit-verified version
|
|
100
101
|
floors for external tools (bun, bwrap, …). `docks-kit toolchain check` prints
|
package/cli/docs/flags.md
CHANGED
|
@@ -16,7 +16,9 @@ Positional targets are `claude`, `codex`, `agents`, and `omp`. A flag-less
|
|
|
16
16
|
`sync` deploys the per-machine harness selection stored in
|
|
17
17
|
`~/.docks-kit/kit.db`. A missing selection or an unreadable store selects `claude`,
|
|
18
18
|
`codex`, and `agents`, and never selects `omp`. Choose the stored selection
|
|
19
|
-
with `docks-kit harnesses`.
|
|
19
|
+
with `docks-kit harnesses`. With no stored selection, its picker pre-ticks all
|
|
20
|
+
four harnesses, `omp` included; a flag-less `sync` does not change until the
|
|
21
|
+
picker saves a selection.
|
|
20
22
|
|
|
21
23
|
## Global flags
|
|
22
24
|
|
|
@@ -41,7 +41,10 @@ export const harnessesCommand = Command.make("harnesses", {}, () =>
|
|
|
41
41
|
title: harness,
|
|
42
42
|
value: harness,
|
|
43
43
|
description: DESCRIPTIONS[harness],
|
|
44
|
-
|
|
44
|
+
// With no stored selection, pre-tick every harness, omp included, so a
|
|
45
|
+
// new machine opts out of omp instead of opting in. A flag-less sync
|
|
46
|
+
// keeps LEGACY_SELECTION until this picker saves a selection.
|
|
47
|
+
selected: (stored ?? HARNESSES).includes(harness),
|
|
45
48
|
})),
|
|
46
49
|
});
|
|
47
50
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
// Generated by cli/scripts/generate-sot-payload.ts. DO NOT EDIT.
|
|
2
2
|
// Edit SoT/, notification.mp3, or package.json, then run: bun cli/scripts/generate-sot-payload.ts
|
|
3
3
|
|
|
4
|
-
export const GENERATED_PACKAGE_VERSION = "0.20.
|
|
4
|
+
export const GENERATED_PACKAGE_VERSION = "0.20.5"
|
|
5
5
|
|
|
6
6
|
export const GENERATED_PAYLOAD_TEXT = {
|
|
7
7
|
"SoT/.agents/skills.txt": "# Universal AI-agent skill manifest intentionally empty.\n# Global skill discovery is opt-in: add one <owner>/<repo> slug per line.\n# EngineNative ignores comments and blank lines.\n",
|
package/package.json
CHANGED