Packages

Packages

A package is a directory with a zinc.pkg.yaml manifest.

Zinc records where the package lives and reads manifest paths. The package owns its software, settings, docs, and output meaning.

Manifest

name: openai-responses
version: "0.3.12"
about: OpenAI Responses model package.

source:
  uri: https://github.com/darkhorseprojects/darkhorseprojects-packages.git
  ref: openai-responses-v0.3.12
  path: openai-responses

links:
  unix-bash: "0.1.4"

software:
  responses:
    about: Produce model text, reasoning text, and requested named outputs.
    python: software/responses.py
    gives: gives

shapes:
  short_answer: shapes/short-answer.circuitry.yaml

settings:
  models: settings/models.yaml

docs:
  readme: docs/README.md

Recorded facts

Field	Purpose
name	Package identifier.
version	Package version string.
root	Installed path on disk.
source.uri	Source URI Zinc can resolve.
source.ref	Source ref Zinc resolves within source.uri.
source.path	Package path inside the source.
links	Optional soft package links Zinc reports but does not install.

Managing packages

zn pkg install ./openai-responses --global
zn pkg list
zn pkg links
zn pkg links --missing
zn pkg update openai-responses --dry-run
zn pkg update all --dry-run
zn pkg remove openai-responses

links are informational. Zinc reports them; it does not install them automatically.

Boundary

Zinc can locate a package and read its manifest. Package behavior remains package-owned.