@iowarp/clio-coder 0.5.0 → 0.5.2

package/library/skills/meta/clio-coder-test/references/test-map.md

@@ -1,97 +1,68 @@
-# Where Clio's tests live
+# Selecting Clio test gates
+
+Read current `package.json` scripts before running a gate; this map is navigation,
+not a substitute for executable source. Use `rg --files tests` to locate stems
+because contracts and extended tests are deliberately separate lanes.
+
+| Lane | Location / command | Execution boundary |
+| --- | --- | --- |
+| Required contracts | `tests/contracts/*.test.ts`; `pnpm run test:file -- <file>` | Usually source through tsx; inspect subprocess cases |
+| Required process smoke | `acp-boundary`, `real-binary-boot`, `process-lifecycle` in `tests/smoke/`; included in `pnpm run test` | Current built CLI |
+| Extended regressions | `tests/extended/`, `tests/extended-smoke/`; focused `test:file` or `pnpm run test:full` | Source or built CLI according to the fixture |
+| Package qualification | `pnpm run test:package` | Packed/installed artifact and native timing |
+| Boundaries and package pins | `pnpm run lint` | Biome and `scripts/check-hygiene.ts` |
+| Required GUI checks | `pnpm run check:gui`, `pnpm run test:gui` | App types/lint and selected API/runtime/UI contracts |
+| Full GUI/browser investigation | `pnpm --filter @iowarp/clio-coder-gui verify` | Extended app tests, Vite build, browser smoke; browser dependency required |
+| Routine integrated gate | `pnpm run ci` | Types, lint, build, required root and maintenance tests, required GUI checks |
+| Release qualification | `pnpm run ci:release` | Clean committed source and exact candidate artifact |
+| Qualified artifact preflight | `pnpm run release:preflight` | Checks unchanged qualified candidate; not a replacement for qualification |
+
+`pnpm run test` only builds automatically when dist is absent. Existing dist may
+be stale after source edits. `pnpm run build` runs `scripts/build.ts` and the
+codewiki asset build; check the scripts instead of naming an obsolete bundler.
+
+## Find focused coverage
+
+| Change | Useful existing test stems |
+| --- | --- |
+| Context/summary | `compaction-controls`, `compaction-projection`, `compaction-summary-format`, `compaction-skill-checkpoint`, `context-lifecycle`, `live-context-anchor`, `working-set-core` |
+| Session/memory | `session-durability`, `memory-session-isolation`, `memory-scope`, `memory-convention-workflow`, `no-edit-memory` |
+| Skill/prompt policy | `prompt-skill-policy`, `skill-install`, `skill-library-activation`, `headless-skill-activation`, `skill-tool-surface`, `prompt-session-snapshot`, `prompt-prefix-layout` |
+| Dispatch/providers | `dispatch-admission`, `dispatch-lifecycle`, `worker-boundary`, `provider-context-boundary`, `provider-transport` |
+| CLI/ACP | `tests/smoke/acp-boundary.test.ts`, `tests/extended-smoke/cli-core.test.ts` |
+| Resource packages | `library-packages`, `library-context`, `library-loader`, `library-hash` when present; discover exact filenames with `rg` |
+
+Do not guess a broad domain test filename or assume a test belongs to contracts.
+For example:
 
-Routine contracts and three process smoke files protect core product boundaries.
-The installed-package and real native timing checks belong to qualification.
-Extended regressions are explicit development investigations.
-
-## Layout
-
-| Lane | Path | Command | Build needed |
-|---|---|---|---|
-| Required contracts | `tests/contracts/*.test.ts` | `npm run test:file -- <file>` | CLI tests require current dist |
-| Required process smoke | ACP, binary boot, process lifecycle under `tests/smoke/` | `npm run test` includes them | Yes |
-| Package qualification | Installed package and native call timing under `tests/smoke/` | `npm run ci:release` | Built once by qualification |
-| Extended regressions | `tests/extended/`, `tests/extended-smoke/` | `npm run test:full` or a focused `test:file` | Yes for CLI scenarios |
-| Static boundaries and pins | `scripts/check-hygiene.ts` | `npm run lint` | No |
-| Required GUI boundaries | Selected files in `apps/clio-coder-gui/tests/` | `npm run test:gui` | Root build |
-| Full GUI investigation | All GUI tests and browser matrix | `pnpm --filter @iowarp/clio-coder-gui verify` | Yes |
-
-`npm run ci` runs the routine lane. `npm run ci:release` qualifies a clean,
-committed candidate and its exact tarball; `npm run release:preflight` checks
-that qualification without repeating development tests. See CONTRIBUTING.md.
-
-## Contract files
-
-| Area | Required or extended focused files |
-|---|---|
-| Authentication | `auth-login-write-failure`, `auth-storage-durability` |
-| Context, session, and state | `context-lifecycle`, `memory-scope`, `project-bootstrap`, `session-durability`, `state-file-lock`, `task-board-done`, `working-set-core` |
-| Config, routing, and presentation | `footer-context-window`, `knob-aliases`, `pane-remedies`, `rendering-invariants`, `route-identity-keying`, `settings-migration` |
-| Dispatch, fleet, and workers | `dispatch-admission`, `dispatch-lifecycle`, `dispatch-schema`, `fleet-lifecycle`, `host-verification-batch`, `intent-requirements`, `worker-attestation-surface`, `worker-boundary` |
-| Prompts, engine loop, and middleware | `compact-prompt-contracts`, `engine-lifecycle`, `loop-detector`, `loop-guard-epoch`, `middleware-hooks`, `prompt-cache-correctness`, `prompt-prefix-layout`, `prompt-role-routing`, `prompt-session-snapshot`, `prompt-tool-hints` |
-| Providers and model policy | `gemma-channel-filter`, `llamacpp-router-probe`, `local-model-family-resolution`, `provider-context-boundary`, `provider-transport`, `synthesis-lock`, `thinking-off-wire` |
-| Safety and tools | `bash-exec-settlement`, `rejection-feedback`, `safe-resource-write`, `safety-gates`, `tool-boundaries` |
-| Evidence, eval, and release | `eval-boundary`, `evidence-integrity`, `metering-integrity`, `release-boundary` |
-| Extensions, interop, and skills | `extension-compatibility`, `extension-reload-coordinator`, `extension-reload-slash`, `extension-resources`, `extension-snapshot`, `interop-boundary`, `marketplace-offer`, `skill-install` |
-| Documentation navigation | `docs-server` |
-
-Append `.test.ts` to every stem in the table. Use `rg` over the files before
-choosing a lane; related behavior can span more than one focused contract.
-
-## Smoke files
-
-| Boundary | File under `tests/smoke/` |
-|---|---|
-| ACP v1 over JSON-RPC stdio, permission requests, and text/image content | `acp-boundary.test.ts` |
-| Core CLI health, local-provider run, receipts, events, and autonomy | `cli-core.test.ts` |
-| `npm pack`, installed resources, and installed codewiki navigation | `installed-package.test.ts` |
-| Signal propagation through a real tool child | `process-lifecycle.test.ts` |
-| Real-binary setup, onboarding, migration, and launch behavior | `real-binary-boot.test.ts` |
-
-The smoke files own their child-process helpers. There is no shared
-`tests/harness/spawn.ts` and no PTY smoke lane in the current tree.
-
-## Harness and fixture modules
-
-| File | Purpose |
-|---|---|
-| `tests/harness/tmp-root.ts` | Preloaded guarded temp root and cleanup for every root test run |
-| `tests/harness/tmp-git-guard.ts` | Prevents accidental `.git` creation in the system or test temp root |
-| `tests/harness/scratch-env.ts` | Child-process and in-process Clio state isolation |
-| `tests/harness/dispatch.ts` | Dispatch bundle, fast reproducibility, isolated state, and event-loop helpers |
-| `tests/harness/dispatch-stub-context.ts` | Minimal domain context for dispatch contracts |
-| `tests/harness/receipt.ts` | Typed run-envelope and receipt fixtures |
-| `tests/harness/openai-compat-fixture.ts` | Loopback OpenAI-compatible server and target seeders |
+```bash
+rg --files tests | rg 'compaction|memory-session|skill|library'
+pnpm run test:file -- tests/extended/compaction-controls.test.ts
+pnpm run test:file -- --test-name-pattern='cancellation' tests/extended/compaction-controls.test.ts
+```
 
-Child fixtures in `tests/fixtures/` are
-`capacity-lease-child.ts`, `codewiki-coordinator-child.ts`, and
-`evidence-index-writer.ts`.
+## Skill and package edits
 
-## Running a subset
+Update `SKILL.md` version/description and `plugin.json` consistently. Supporting
+references and eval scenarios participate in full-tree integrity too.
 
 ```bash
-# all contracts (the shell expands the file pattern)
-npm run test:full
-
-# one contract or smoke file
-npm run test:file -- tests/contracts/skill-install.test.ts
-npm run build
-npm run test:file -- tests/extended-smoke/cli-core.test.ts
-
-# only it.only or describe.only within one file
-npm run test:file -- --test-only tests/contracts/skill-install.test.ts
+pnpm run skills:pin
+pnpm run skills:check
+pnpm run library:pin
+pnpm run library:check
 ```
 
-## Writing tests
+Inspect the generated diff; do not accept unrelated pin drift. The skill hash
+and full library digest are different contracts. Package validation uses
+`clio-coder library validate <package-root> --json` with a current candidate CLI.
+The portable manifest and house frontmatter are richer than a generic skill
+validator; use Clio's own validation as the authority for Clio metadata.
+
+## Checks proportional to the change
 
-- Use `node:test` and `node:assert/strict`.
-- End local TypeScript import specifiers in `.js` for NodeNext resolution.
-- Keep `tsconfig.tests.json` strict, including `noUncheckedIndexedAccess` and
-  `exactOptionalPropertyTypes`; narrow indexed values before use.
-- Let the package script preload `tmp-root.ts`. Tests that mutate Clio state or
-  `process.env` should use `scratch-env.ts` and restore in teardown.
-- Use a loopback fixture for provider behavior. Do not contact a configured or
-  public model from a deterministic test.
-- Build before a focused smoke run. `npm run ci` already builds before testing.
-- Keep a smoke process driver local to the boundary it exercises unless a
-  genuinely shared contract appears.
+A docs-only correction needs source/command/link verification, not a fabricated
+runtime test. A runtime discovery change needs admission tests, including no-
+skills, hidden/disabled content, wrong repository, and restrictive policies.
+Integration or release work must run the relevant full gate, with the candidate
+build isolated when the running agent uses the main checkout's dist.

package/library/skills/registry.yaml

@@ -24,7 +24,7 @@ skills:
   - name: context-handoff
     path: context/context-handoff
     version: 0.5.1
-    sha256: e05a8dc9d09b4decbf79afade1f530d7c81d5412112723faab104a83893c34f8
+    sha256: e450ea25a3f2368b058a5b85aebf37027b757e81d5f179f696b37655abf27e41
   - name: context-prime
     path: context/context-prime
     version: 0.4.1
@@ -61,12 +61,12 @@ skills:
   # ── meta ──
   - name: clio-coder-dev
     path: meta/clio-coder-dev
-    version: 0.4.0
-    sha256: 8980f3bed0f06c24685bc0a02f3ffbbcdac9442616dc3ce54122265b666ae0d7
+    version: 0.5.0
+    sha256: aece1ffc91e74003dba6b048cc688e41527d6b2a8ba13d2adcaedac9791fdf98
   - name: clio-coder-test
     path: meta/clio-coder-test
-    version: 0.3.1
-    sha256: e5de4cd00f6ca78aa6443b13d54751ef1088ece0294d4f24f418e037dabf2214
+    version: 0.4.0
+    sha256: 83315385851ce53d6a278cdde9441a6bafd40cde42b2a40cd580be27e3268564
   - name: credentials
     path: meta/credentials
     version: 0.2.0

package/library/skills/skill-marketplace.json

@@ -196,31 +196,29 @@
 		},
 		{
 			"name": "clio-coder-dev",
-			"description": "Governs changes to Clio Coder's own source and harness (TUI, skills, agents, tools, prompts, domains): what may change freely, what needs explicit user intent, and how to change it without breaking the architecture. Not for verifying a change against the harness; use clio-coder-test.",
+			"description": "Develop Clio Coder inside its own repository: trace source contracts, implement bounded changes, coordinate sprint work, and preserve running-agent and session correctness. Use before changing Clio source, prompts, tools, or library; pair with clio-coder-test for validation.",
 			"triggers": [
-				"modify Clio Coder",
-				"change the Clio harness",
-				"edit Clio skills or agents",
-				"evolve Clio tools or prompts",
-				"Clio contribution boundary"
+				"develop Clio in its own repository",
+				"implement a Clio sprint packet",
+				"change Clio context or session lifecycle",
+				"edit Clio skills tools or prompts"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/meta/clio-coder-dev",
-			"version": "0.4.0",
+			"version": "0.5.0",
 			"audit": "pass",
 			"category": "meta"
 		},
 		{
 			"name": "clio-coder-test",
-			"description": "Verifies a Clio Coder source change against the current contract, smoke, boundary, and application test lanes, including temporary-state and local-provider harnesses. Not for deciding what may change; use clio-coder-dev.",
+			"description": "Validate Clio Coder changes using focused source regressions, built CLI and ACP fixtures, skill/library checks, and isolated package or GUI gates. Use when developing or diagnosing Clio itself; select checks from the changed behavior and report evidence without claiming unrun coverage.",
 			"triggers": [
-				"test Clio Coder",
-				"verify a Clio source change",
-				"run Clio contract tests",
-				"test ACP over stdio",
-				"Clio mock provider harness"
+				"validate a Clio change",
+				"test Clio context compaction or memory",
+				"verify Clio skill activation",
+				"choose Clio test gates"
 			],
 			"sourceUrl": "https://github.com/iowarp/clio-coder/tree/main/library/skills/meta/clio-coder-test",
-			"version": "0.3.1",
+			"version": "0.4.0",
 			"audit": "pass",
 			"category": "meta"
 		},

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@iowarp/clio-coder",
-	"version": "0.5.0",
+	"version": "0.5.2",
 	"description": "An open-source terminal coding agent for scientific software: your models, bounded workers, and inspectable evidence.",
 	"keywords": [
 		"ai",