fix(context): correct delivery-free recovery guidance

docs/as-built/architecture/plugin-agent-image-context-pack.md

@@ -58,8 +58,9 @@ reference already encodes this ("## Plugin Inspection (v0.3.1)").
 ## 1. Context packs (PL-014) — 0.3.0
 
 A **context pack** is a directory of `manifest.yaml` + included markdown /
-yaml / txt files: operator-authored, library-discoverable, reviewable,
-sendable. No SQLite tables; in-memory cache at daemon scope.
+yaml / txt files: operator-authored, library-discoverable, reviewable, and
+composable. The `rig context` noun is delivery-free. No SQLite tables;
+in-memory cache at daemon scope.
 
 > Source: `domain/context-packs/context-pack-types.ts:1-11` @HEAD.
 
@@ -72,10 +73,10 @@ Startup wires three roots: builtin (`../context-packs`, first), user-file
 addressed by its path-like **ref** (e.g. `packs/compaction-restore`), which is
 its unique identity; the opaque entry id is `context-pack:<ref>` (a UI routing
 key). Colon-id `context-pack:<name>:<version>` addressing and the `/library/:id`
-routes were removed in Slice-03 Atom 5 — resolution is by ref only (`getByRef`,
-`GET/DELETE /library/by-ref`, `GET /library/by-ref/preview`,
-`POST /library/by-ref/send`). `startup_files` `kind: context_pack` entries
-likewise address by `ref:`.
+routes were removed in Slice-03 Atom 5. Resolution is by ref only through
+`getByRef` and the read/delete/preview/pieces route family. Startup accepts
+ordinary files only and rejects context-pack expansion; compose a durable ref
+first, then use a dedicated delivery verb when delivery is intended.
 
 > Source: `domain/context-packs/context-pack-library-service.ts:59-94`
 > (scan; last-wins L79-81), `:31-33` (id); `startup.ts:481-502` (3-root
@@ -100,17 +101,20 @@ unreadable file throws `file_read_failed`.
 > Source: `domain/context-packs/bundle-assembler.ts:38-39` (prefixes),
 > `:73-100` (missing skip L74-76; read-fail throw L81-87) @HEAD.
 
-`contextPacksRoutes()` (mounted `server.ts:482`): `GET /library`,
-`POST /library/sync`, `GET /library/:id`, `GET /library/:id/preview`
-(assembled, no send), `POST /library/:id/send`
-(`{ destinationSession, dryRun }`; dry-run returns text without
-`SessionTransport`; real send → 502 on transport failure). `id==="sync"`
-→ 404 so it cannot shadow the sync route; 503 when unprovisioned. CLI:
-`rig context list|show|preview|sync|add|send` (`send --dry-run`; Atom-7 retired the `rig context-pack` grammar).
+`contextPacksRoutes()` exposes a ref-primary, delivery-free library surface:
+`GET /library`, `POST /library/sync`, `POST /library/compose`,
+`GET/DELETE /library/by-ref`, `GET /library/by-ref/preview`, and
+`GET /library/by-ref/pieces`. Preview returns the assembled review shape;
+pieces returns ordered member contents plus the whole plain text and byte size.
+There is no pack-owned delivery route. CLI library verbs are
+`rig context compose|list|show|preview|sync|add|rm`; delivery belongs to
+`rig send --context`, `rig broadcast --context`, `rig walk --through`, and
+`rig queue create --body-context`.
 
-> Source: `routes/context-packs.ts:25-138` (table; sync-guard L51; 503
-> L31; dry-run L121-123; 502 L126-133); `server.ts:482`;
-> `docs/as-built/cli-reference.md:914-929` @HEAD.
+> Source: `routes/context-packs.ts` (complete route table);
+> `domain/startup-validation.ts` (file-only startup contract);
+> `packages/cli/src/commands/context.ts`, `send.ts`, `broadcast.ts`,
+> `walk.ts`, and `queue.ts` @HEAD.
 
 ## 2. Agent images (PL-016) — 0.3.0
 

packages/cli/src/context-resolve.ts

@@ -32,7 +32,7 @@ export async function resolveContextRef(client: DaemonClient, ref: string): Prom
     `/api/context-packs/library/by-ref/pieces?ref=${encodeURIComponent(ref)}`,
   );
   if (res.status === 404) {
-    throw new Error(`Context pack '${ref}' not found in library. Run 'rig context-pack list' to see the available refs.`);
+    throw new Error(`Context pack '${ref}' not found in library. Run 'rig context list' to see the available refs.`);
   }
   if (res.status === 400) {
     throw new Error(res.data?.message ?? `Unsafe context ref '${ref}'.`);

packages/cli/test/context-resolve.test.ts

@@ -24,8 +24,17 @@ describe("resolveContextRef (Atom 6b)", () => {
     await expect(resolveContextRef(client, "packs/x")).rejects.toThrow(/whole context or none/i);
   });
 
-  it("throws a not-found error for an absent ref (404)", async () => {
-    await expect(resolveContextRef(fakeClient(404, {}), "packs/absent")).rejects.toThrow(/not found in library/);
+  it("points an absent ref at the live delivery-free context list command", async () => {
+    let error: Error | undefined;
+    try {
+      await resolveContextRef(fakeClient(404, {}), "packs/absent");
+    } catch (caught) {
+      error = caught as Error;
+    }
+    expect(error?.message).toBe(
+      "Context pack 'packs/absent' not found in library. Run 'rig context list' to see the available refs.",
+    );
+    expect(error?.message).not.toContain("rig context-pack");
   });
 
   it("throws the daemon's structured unsafe message for a 400", async () => {

packages/daemon/src/startup.ts

@@ -642,10 +642,10 @@ export async function createDaemon(opts?: DaemonOptions): Promise<DaemonResult>
     console.error(`[openrig] plugin vendor setup warning: ${(err as Error).message}`);
   }
 
-  // PL-014 Item 6: hoist ContextPackLibraryService construction so the
-  // PodRigInstantiator can resolve `kind: context_pack` startup_files
-  // entries at materialize time. Same instance is returned to deps
-  // below so /api/context-packs/* shares it.
+  // PL-014: one daemon-scoped ContextPackLibraryService backs the
+  // delivery-free /api/context-packs list/sync/compose/read/delete/preview/pieces
+  // routes. Startup context-pack expansion is intentionally unsupported;
+  // dedicated send/broadcast/walk/queue verbs own delivery.
   const contextPackLibrary = (() => {
     const userPacksRoot = getDefaultOpenRigPath("context-packs");
     try { fs.mkdirSync(userPacksRoot, { recursive: true }); } catch { /* best-effort */ }