Skip to main content

Module app_manifest

Module app_manifest 

Source
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.
DesktopLaunchDescriptor
Webizen Desktop Apps launch / inspect descriptor (no lifecycle execution).
EntryProjection
One entry into a projection surface.
FocusedMiniAppProjection
Focused mini-app entry projection.
Integrity
Package integrity digests.
PermissionGrant
Host-side grant ceiling for an installed app (not stored in the manifest).
PermissionIntent
Declared permission intent inside a portable application manifest.
PoetContainerProjection
Poet container placement / tool projection.
PoetManifoldProjection
Poet manifold entry projection (host-neutral; not a live ManifoldSeed).
PortableAppManifest
Versioned portable application manifest v1.
PresentationHint
Decorative / layout suggestion. Inert for authorization.
ProjectedApp
Full cold projection of one portable app under a host grant.
RequiredAsset
Governed asset the package depends on.
RequiredCapability
Capability the host must provide before launch.
SharedProjectionIds
Shared identity + authorization outcome for every projection of one manifest.
StateSchema
State schema reference (SHACL / semantic shape id + version).
UpdateChannel
Update channel descriptor (no network fetch performed here).

Enums§

AppManifestError
PermissionKind
Allowlisted permission kinds a portable app may declare as intents.
ProjectionKind
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.