CORE [SCMS] establish contract-first HPL CLI read surface for Lab Notes 🧬

[AdaInTheLab]

Summary

This PR introduces the first contract-stable release of the Human Pattern Lab CLI (HPL).

It replaces earlier Skulk-era experimentation with a governed CLI surface that mirrors
the Lab API’s release discipline, terminology, and stability guarantees.

This PR defines the read-only interface for Lab Notes and establishes the
machine-readable contract (schemaVersion) that future automation and agents depend on.

---

Scope

Included

• Read-all access to Lab Notes (notes list)
• Read-one access by slug (notes get <slug>)
• Stable JSON output with:
  • schemaVersion
  • intent metadata
  • normalized API envelopes
• Human-friendly terminal rendering
• Agent-safe --json mode for all read commands
• Compatibility with ledger-backed Lab Notes API (v0.x)

Explicitly Excluded

• Write / admin commands
• Authentication flows
• Offline caching or sync
• Search, filters, or pagination
• Any breaking changes to existing API contracts

---

Contract Details

• CLI schemaVersion: 0.1
• Contract scope: JSON output shape, intent semantics, exit codes
• Stability rule: Contract changes require explicit version bumps and release notes

This PR marks the first release where the CLI contract is considered authoritative.

---

Compatibility

Component	Version
CLI package	v0.0.1-alpha.0
CLI schemaVersion	0.1
Compatible API versions	API ≥ v0.2.0

Earlier repository tags reflect Skulk-era scaffolding and are not part of the HPL release lineage.

---

Validation

Verified locally:

hpl notes list
hpl notes list --json
hpl notes get <slug>
hpl notes get <slug> --json
hpl version --json
hpl capabilities --json

All commands emit stable output and conform to the declared schemaVersion.

---

Release Intent

This PR is release-worthy and is intended to be tagged as:

v0.0.1-alpha.0

This tag represents the first contract-stable release of the HPL CLI.

---

Notes

• Aligns CLI release discipline with the Lab API
• Establishes a governed interface rather than an experimental tool
• Humans remain a tolerated interface

🦊
The contract holds.

[github-actions]

😼✨ Carmel Approval Stamp™

Adequate work, human.