Skip to content

feat(prism-code): Docker's spellings and the familiarity transcript (Part of #347) - #637

Merged
afflom merged 2 commits into
mainfrom
claude/roadmap-347-familiarity
Nov 12, 2026
Merged

afflom merged 2 commits into
mainfrom
claude/roadmap-347-familiarity

Conversation

@afflom

@afflom afflom commented Nov 12, 2026

Copy link
Copy Markdown
Member

Requested by Alex · project thread

Part of #347. This is the familiarity test from its "done when": the ten most common Docker tasks (build, run, inspect, tag, push, pull, list images, list containers, logs, remove), done against Prism through both the CLI and the SDK. The transcript is committed as a fixture, and CI runs it again.

What changes

I ran the ten tasks the way Docker spells them and found these gaps. This PR closes them:

  • prism-code ps and prism-code logs are top-level verbs again. They mean containers ps and containers logs, declared as aliases in src/cli/containers.mjs. containers ls lists the same rows as ps.
  • container, image and volume name the same groups as their plurals, so prism-code container ls -a and prism-code image ls work. They come from MODULE_ALIASES and moduleOf in src/cli/index.mjs.
  • A stored image name now works wherever Docker takes one. This covers prism-code run calc:latest <input>, prism-code inspect calc:latest, prism.containers.run('calc:latest', input) and prism.images.inspect('calc:latest'), which all open the image the local store (Local image store: prism images, tag and rmi #349) keeps under that name. A path that exists still wins.
  • The group help prints each top-level alias line, as the auth group already did for login and logout.
  • developerSurface lists the singular groups as namespaces. developer-surface.json is regenerated, and cargo xtask check-developer-view accepts all 197 names.

The transcript

  • test/fixtures/familiarity.json holds each task twice:
    • as Docker's CLI command, with docker renamed prism-code;
    • as the Docker SDK call and its prism client equivalent.
  • test/familiarity.test.mjs runs every CLI step against the in-process registry, checking the exit code and the stdout pattern, and then runs the SDK flow.
  • build runs under PRISM_CODE_DRY_RUN on the CLI and with a fake builder in the SDK, because CI has no builder image. The fixture's note says so.

Checks

  • npm test in sdk/npm/prism-code: 910 pass and 1 fails. The failure is reference-archives.test.mjs, which cannot resolve the sibling prism-code package without the workspace install CI does. The same failure happens without this change.
  • cargo xtask check-developer-view passes.
  • The package allowance is scripts/package-allowances/familiarity.json, 4 KiB.

Still open in #347 after this PR: view schemas for the JSON output and the SDK return values, the 0.2.0 examples run through the aliases, and the prose renames.


Generated by Claude Code

…s and stored image names, with the familiarity transcript (Part of #347)

prism-code ps and prism-code logs are containers ps and containers logs.
container, image and volume name the same groups as their plurals, and
containers ls lists as ps does. run and inspect on the CLI, and
prism.containers.run and prism.images.inspect in the SDK, open the image the
local store keeps under a name; a path that exists still wins.

The ten most common Docker tasks, spelled as Docker's CLI and SDK spell them,
are committed as test/fixtures/familiarity.json, and
test/familiarity.test.mjs runs every step against a local registry. The
developer surface now lists the top-level verbs and the singular groups, and
cargo xtask check-developer-view accepts all 197 names.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N4k8eo7mrfwURU1WM
@afflom afflom self-assigned this Nov 12, 2026
…help now prints

The group help prints each module's top-level aliases, so cli.json lists
ps, logs, tag and rmi, the containers summary names ls and the singular
groups, and the prism skill's command block is regenerated.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013Asa3N4k8eo7mrfwURU1WM
@afflom
afflom merged commit 3263e7d into main Nov 12, 2026
34 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants