Workspace and Project Portability

Portability is a governed transfer boundary, not a recursive folder copy. Workspai distinguishes portable source and metadata from dependencies, secrets, generated evidence, caches, and machine-local workspace links.

Workspace archive

npx workspai workspace archive create --json

Verify an archive before importing or hydrating it:

npx workspai workspace archive verify --json

The archive manifest records format, compatibility, inventory, exclusions, and integrity evidence. Verification must succeed before the archive can be treated as a trusted transfer package.

Project archive and restore

npx workspai project archive api --json

npx workspai project restore api --json

Project archival preserves registry identity and recovery evidence. Restore reconciles ownership and destination state instead of reviving stale absolute paths.

Portable operations fail closed on path traversal, unsafe links, incompatible schemas, missing inventory, or integrity mismatch.

See workspace archive, project archive, and project restore.