Expand description
Portable application manifest v1 (APP-02). Portable application manifest v1 (APP-02) + projection adapters (APP-03).
Cold-construction schema for app identity, entry projections, required capabilities/assets, state schema, permission intents, presentation hints, compatibility, integrity digests, and update channel.
project_manifest resolves one manifest into host-neutral Poet manifold,
Poet container, focused mini-app, and Desktop launch descriptors without a
projection-specific private database or divergent permission model.
§Security invariants
- Unknown manifest versions fail closed.
- Unknown permission wire values fail closed.
- Permission intents that exceed a host grant ceiling fail closed.
- Package path fields reject
.., absolute escapes, and URL schemes. - Presentation hints are inert for authority — they never grant
permissions; see
authority_from_presentation_hints. - Projection adapters authorize once and copy the same IDs / permission outcome into every descriptor.
Structs§
- AppAuthor
- Author identity recorded on the manifest.
- AppIdentity
- App identity / version / author block.
- Compatibility
- Engine / feature compatibility window.
- Desktop
Launch Descriptor - Webizen Desktop Apps launch / inspect descriptor (no lifecycle execution).
- Entry
Projection - One entry into a projection surface.
- Focused
Mini AppProjection - Focused mini-app entry projection.
- Integrity
- Package integrity digests.
- Permission
Grant - Host-side grant ceiling for an installed app (not stored in the manifest).
- Permission
Intent - Declared permission intent inside a portable application manifest.
- Poet
Container Projection - Poet container placement / tool projection.
- Poet
Manifold Projection - Poet manifold entry projection (host-neutral; not a live
ManifoldSeed). - Portable
AppManifest - Versioned portable application manifest v1.
- Presentation
Hint - Decorative / layout suggestion. Inert for authorization.
- Projected
App - Full cold projection of one portable app under a host grant.
- Required
Asset - Governed asset the package depends on.
- Required
Capability - Capability the host must provide before launch.
- Shared
Projection Ids - Shared identity + authorization outcome for every projection of one manifest.
- State
Schema - State schema reference (SHACL / semantic shape id + version).
- Update
Channel - Update channel descriptor (no network fetch performed here).
Enums§
- AppManifest
Error - Permission
Kind - Allowlisted permission kinds a portable app may declare as intents.
- Projection
Kind - Host-agnostic entry projection kind.
Constants§
- APP_
MANIFEST_ MAGIC - Wire magic:
Q42APP\0\0. - APP_
MANIFEST_ VERSION - Manifest schema version encoded on the wire.
- MAX_
ASSETS - Maximum required asset rows.
- MAX_
CAPABILITIES - Maximum required capability rows.
- MAX_
ENTRIES - Maximum entry projections retained.
- MAX_
FEATURES - Maximum compatibility feature tags.
- MAX_
HINTS - Maximum presentation hints.
- MAX_
MANIFEST_ BYTES - Soft ceiling for a single serialized manifest (cold metadata).
- MAX_
PERMISSIONS - Maximum permission intents.
Functions§
- authority_
from_ presentation_ hints - Presentation hints are decorative only and never contribute authority.
- check_
permission_ intents - Fail closed when any required intent is absent from the grant.
- project_
manifest - Project every entry kind present on the manifest.
- project_
manifest_ kinds - Project only the requested kinds (still authorize the full intent set).
- sha256_
into - Compute SHA-256 into a caller-owned buffer.
- sha256_
of - Convenience SHA-256 for cold tests and tooling.
- validate_
package_ relative_ path - Reject absolute, traversal, and scheme-bearing path strings.