Skip to content

Releases: AdaInTheLab/the-human-pattern-lab-cli

0.0.1-alpha.6

13 Jan 19:10
@AdaInTheLab AdaInTheLab
0.0.1-alpha.6
97d5578
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
0.0.1-alpha.6 Pre-release
Pre-release

0.0.1-alpha.6 — 2026-01-13

✨ Highlights

This release stabilizes the foundational architecture of the HPL CLI and formally validates its automation-safe JSON contracts.

Added

  • notes sync command with support for syncing from a remote content repository
    • New flags: --content-repo, --content-ref, --content-subdir, --cache-dir
  • Domain-based command mounting for notes (list, get, sync)
  • Dedicated rendering utilities for text and tables (human mode)
  • JSON contract validation via direct tsx execution

Changed

  • CLI entrypoint reduced to pure command wiring (no business logic)
  • Strict separation of:
    • command logic
    • rendering
    • output contracts
  • Lab Notes CLI types aligned with API ledger-backed schema
  • JSON mode (--json) enforced as stdout-pure across all commands

Fixed

  • Eliminated stdout leakage in JSON mode
  • Resolved command registration issues that hid subcommands
  • Improved Windows compatibility by avoiding hard process.exit() calls

Notes

  • This is an architectural stabilization release.
  • Interfaces remain alpha and may evolve, but core contracts are now enforced and tested.

🦊 The lantern is lit. The contracts hold.

Loading

HPL CLI v0.0.1-alpha.0

01 Jan 16:05
@AdaInTheLab AdaInTheLab
v0.0.1-alpha.0
9ab5eaf

Choose a tag to compare

View all tags
HPL CLI v0.0.1-alpha.0 Pre-release
Pre-release

🔎 Summary

This release introduces the Human Pattern Lab CLI (HPL) as a
contract-first, read-only interface for accessing Lab Notes from the
ledger-backed Lab API.

It establishes a versioned CLI contract (schemaVersion) with
machine-readable output, explicit intent metadata, and stable semantics
for both human and agent consumers.

This is the first release where the CLI is considered governed and supported.

📦 Compatibility

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

Compatibility is defined by the CLI contract, not implementation details.

➕ Additive Changes

  • Introduced notes list command (read all Lab Notes)
  • Introduced notes get <slug> command (read one Lab Note)
  • Added --json output mode for all read commands
  • Added explicit schemaVersion to all JSON output
  • Added intent metadata for machine interpretation
  • Normalized support for raw and enveloped API responses
  • Human-friendly terminal rendering with agent-safe JSON fallback

🔧 Internal Changes

  • Established contract-first CLI architecture
  • Introduced shared schema and intent definitions
  • Hardened HTTP client behavior across platforms
  • Aligned CLI release discipline with Lab API practices

🧠 Contract Notes

This release establishes the initial CLI contract:

  • schemaVersion: 0.1
  • JSON output shape, intent semantics, and exit codes are now governed
  • Additive changes will not break the contract
  • Breaking changes will require a schemaVersion bump and explicit release notes

📚 Notes

Earlier tags in this repository reflect internal tooling and early
experimentation under the Skulk namespace.

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

🔗 References

🦊
The contract holds. The lantern is lit.

Loading