DPCS Pipeline Package Format¶

Implementation-defined pipeline package layout for ROADMAP 0.10 (Appendix G).

Layout¶

name.dpcspkg/
  manifest.yaml   # also accepts manifest.yml / manifest.json
  artifacts/
    contracts/...
    plans/...
    profiles/...
    registry.yaml   # optional

Directory packages may also be zipped (.dpcspkg.zip). Prefer writing the zip outside the package directory (dpcs package pack DIR --archive /tmp/out.zip).

Manifest¶

PackageManifest fields:

Field	Required	Description
`id`	yes	Stable package identifier
`version`	yes	SemVer-compatible package version
`dpcsVersion`	yes	Supported DPCS specification version
`name`	no	Human-readable name
`description`	no	Description
`artifacts[]`	no	Indexed artifacts with `id`, `type`, `version`, `path`

Artifact paths are relative to the package root and must not contain .. or be absolute. Symlinked artifact files are rejected.

Manifest filename precedence: manifest.yaml, then manifest.yml, then manifest.json.

CLI¶

dpcs package validate examples/packages/minimal.dpcspkg
dpcs package show examples/packages/minimal.dpcspkg --json
dpcs package pack examples/packages/minimal.dpcspkg --archive /tmp/minimal.dpcspkg.zip
dpcs package unpack /tmp/minimal.dpcspkg.zip /tmp/out

pack without --archive validates the package directory but does not write a zip.

Library¶

use dpcs::{pack, unpack, validate_package, resolve_artifact};