Scaffold Baseline

A Baseline is one immutable version of the public Registry, named YYYY.MM.DD-<short sha>. It contains every Registry Item hi can install: skills, hooks, runtime scripts, source guides, lint assets, prompt specs, the shared prompt, the subagent manifest, handoff files, the Commit Gate, and the required tools list. The Registry installs no wiki (user decision 2026-09-28, amending the Registry Baseline spec).

Source

• Public Registry: https://api.harness-intelligence.devpunks.com/r (override HI_REGISTRY_URL or settings registry). The CLI sends no credential.
• Root registry.json names the latest Baseline; <version>/registry.json and <version>/<item>.json are immutable.
• The npm package ships no Baseline. Local builds use file:// Registry URLs.

Invariants

• A Baseline is immutable; a correction is a new Baseline. Publishing moves latest; there is no promotion step.
• Each Baseline declares a compatible CLI range; a CLI outside it refuses the Baseline and writes nothing.
• The catalog meta.sha256 verifies the installer's download cache only. No repository file stores a content hash of a Managed Artifact.
• Registry Item JSON stays compatible with the shadcn registry-item format; Harness data lives under meta.hi.
• The installed Baseline, Recorded Shape, and path-to-item map live in .devpunks/installed.json, written only by the installer.

Owned Data

• Pack catalog and Pack detection data
• Skills
• Hooks and runtime scripts
• Lint assets and the Commit Gate
• Prompt spec, handoff, and subagent templates
• Source guides and the required tools list

The CLI owns repository detection, fetching and caching, filesystem writes, the Harness Adapters, terminal interaction, and the Drift Check. See the CLI scaffolding runbook.