feat(pic): complete the canister settings and status, check the live spec

[marc0olo]

Closes #298

Spec source

scripts/check-spec-drift.sh read ic.did from dfinity/portal, which is archived, so it could no longer report drift. It now reads the live spec, public/references/ic.did in dfinity/developer-docs, pinned to 707596d (2026-09-17). Checked: the new pin reports no drift, and the previous ic.did revision reports the newer additions.

Canister settings and status

• New settings minimumIncomingCanisterCallCycles and statusVisibility, for createCanister, setupCanister and updateCanisterSettings.

• canisterStatus returns every field of the spec's canister_status:

  • all settings, including logMemoryLimit, snapshotVisibility and statusVisibility, which could be set but not read back;
  • readyForMigration, version and memoryMetrics.

  The JSDoc said PocketIC didn't return some of these; decoding a live v16 response against the spec shows it returns all of them.

• The settings were copied field by field in three methods, which is how some went missing from the status. One canisterSettingsToIDL now converts them, and one pair of helpers handles all three visibility settings.

• The status settings are a named DefiniteCanisterSettings interface instead of an inline object. It has the same shape, so it's not breaking. Every field of the exported types in pocket-ic-types.ts now has JSDoc, including the older CanisterQueryStats, HttpsConfig, EnvironmentVariable and log filters.

Not included

The spec version also adds the patch HTTP method, pricing_version and flexible HTTP outcalls. Those are outcall APIs and belong to #302. The pin comment notes it.

Verified

• pnpm test:pic (89 tests):
  • the settings test now reads back every setting it sets;
  • new tests check the complete status and that statusVisibility controls who can read it (rejected with "is not allowed to read the canister status" until it's public).
• pnpm format:check, and the Motoko examples locally. The Rust examples are left to CI.

🤖 Generated with Claude Code

[Copilot]

Copilot review overview

🟢 Approval recommended

No unresolved blocking issues were identified.

Review effort: Lite
Findings: None

What changed in this PR

Aligns PocketIC’s canister settings and status handling with the live IC management-canister specification.

Changes:

• Updates spec drift checks and pinned revision.
• Adds minimum-cycle and visibility settings.
• Exposes complete status and memory metrics.
• Expands coverage for settings, status, and visibility behavior.

File	Summary
scripts/​check-spec-drift.sh	Uses the live IC specification source.
packages/​pic/​tests/​src/​pocket-ic.spec.ts	Tests settings, status, and visibility behavior.
packages/​pic/​src/​util/​candid.ts	Centralizes settings and visibility conversion.
packages/​pic/​src/​pocket-ic.ts	Supports new settings and complete status decoding.
packages/​pic/​src/​pocket-ic-types.ts	Exposes updated settings and status types.
packages/​pic/​src/​management-canister.ts	Updates management-canister Candid definitions.
.github/​workflows/​check-spec-drift.yml	Updates the pinned specification revision.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Copilot review overview

🟢 Approval recommended

The implementation consistently matches the described specification updates and includes focused integration coverage.

Review effort: Balanced
Findings: None