Skip to content

Verify project-history package transport before importing - #70

Merged
kudama merged 1 commit into
mainfrom
project-package-verification
Nov 15, 2026
Merged

kudama merged 1 commit into
mainfrom
project-package-verification

Conversation

@kudama

@kudama kudama commented Nov 15, 2026

Copy link
Copy Markdown
Owner

Add a read-only verifier for extracted version-1 project-history packages before a future supported importer writes destination projects. It requires an independently trusted checksums.json SHA-256, verifies the exact file/link inventory and fingerprints, rejects unsafe paths/hard links/special files/duplicate manifest keys, and checks working-file records against transport metadata. It never extracts archives, invokes Git or packaged scripts, follows directory symlinks, imports projects or changes grants.

The summary explicitly reports git_history_checked=false and imported=false. Documentation separates trusted transfer, transport verification, Git-history acceptance and runtime migration, and keeps #64 open for general export/import. Existing private Foundry artifacts remain unchanged.

Validation (2026-11-15): 35 focused cases and all 467 regression tests pass locally. Cases include dotfiles, Unicode, legitimate trailing-dot names, tampered/resealed manifests, missing/extra/changed files, executable bits, hard links, directory symlinks, duplicate IDs/keys, escaping paths, no symlink target reads and unchanged source bytes/modes. This does not validate complete Git histories or the actual private Foundry package.

Agent review: Foundry task 3cffe669a5104ef49015cac85b6c8ac6 proposed the small pure path validator. Forge removed its unnecessary PurePath import and unsupported rejection of ordinary filenames ending in a dot, retained the canonical-path checks, and independently tested the corrected version. The surrounding verifier and acceptance tests were supplied by Forge.

@kudama
kudama merged commit de92fe9 into main Nov 15, 2026
4 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.

1 participant