feat: HEM CLI v1.0.0-Pleasure-through-Creation

Author: damienheiser

.github/workflows/release.yml

@@ -0,0 +1,56 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+    tags: ['v*']
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18, 20, 22]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+      - run: npm ci
+      - run: npm run build
+      - run: npm test
+
+  publish:
+    needs: test
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org
+      - run: npm ci
+      - run: npm run build
+      - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+  notify:
+    needs: publish
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Notify method repo of CLI release
+        uses: peter-evans/repository-dispatch@v3
+        with:
+          token: ${{ secrets.METHOD_REPO_TOKEN }}
+          repository: hedonistic-io/method
+          event-type: cli-release
+          client-payload: '{"tag": "${{ github.ref_name }}", "sha": "${{ github.sha }}"}'

.gitignore

@@ -0,0 +1,8 @@
+node_modules/
+dist/
+*.tsbuildinfo
+.DS_Store
+*.map
+coverage/
+.env
+.env.*

.npmrc

@@ -0,0 +1 @@
+access=public

README.md

@@ -0,0 +1,219 @@
+# HEM CLI
+
+The command-line interface for the **Hedonistic Method** (HEM) -- an AI-native creation methodology for governing agent-driven software projects. HEM provides structured governance, quality measurement, project validation, and multi-engine orchestration from your terminal.
+
+## Install
+
+```bash
+npm install -g @hedonistic-io/hem
+```
+
+Or with a project-local install:
+
+```bash
+npm install --save-dev @hedonistic-io/hem
+npx hem --help
+```
+
+## Commands
+
+### Project Setup
+
+```bash
+# Initialize a new HEM project in the current directory
+hem init
+
+# Initialize with a specific profile
+hem init --profile saas-product
+
+# Initialize in a target directory
+hem init ./my-project
+
+# Guided first-time setup wizard
+hem wizard
+```
+
+### Daily Workflow
+
+```bash
+# Project health dashboard
+hem status
+hem status --json
+
+# Calculate the Hedonistic Index (quality score)
+hem measure
+hem measure quick
+hem measure --json
+
+# Run governance validation checks
+hem validate
+hem validate --json
+```
+
+### Signing and Verification
+
+```bash
+# Sign a file with your HEM key
+hem sign file ./COMPACT.md
+
+# Verify a signed file
+hem sign verify ./COMPACT.md.sig
+
+# Manage signing keys
+hem sign keys
+hem sign generate
+```
+
+### Estimation and Calibration
+
+```bash
+# View or adjust estimates
+hem estimate
+
+# Record actuals against estimates
+hem estimate actuals
+
+# View calibration data
+hem estimate calibration
+
+# Harvest calibration entries from completed tasks
+hem estimate harvest
+```
+
+### AI Engine Orchestration
+
+```bash
+# List available AI engines (Claude, Codex, Gemini, etc.)
+hem engines
+hem engines available
+
+# Launch a sub-agent on a specific engine
+hem launch claude "Implement the auth module"
+```
+
+### Skills
+
+```bash
+# List available HEM skills
+hem skills list
+
+# Show details for a specific skill
+hem skills info build
+```
+
+### Changelog Management
+
+```bash
+# Show the changelog
+hem changelog show
+
+# Add an entry
+hem changelog add
+
+# Show the latest version entry
+hem changelog latest
+```
+
+### Shell Completions
+
+```bash
+# Generate completions for your shell
+hem completions fish
+hem completions zsh
+hem completions bash
+
+# Auto-install completions
+hem completions install
+```
+
+### MCP Server
+
+```bash
+# Start the HEM MCP server (stdio transport)
+hem serve
+```
+
+### Active Monitoring
+
+```bash
+# Run the steering watchdog (continuous governance monitoring)
+hem watch
+hem watch --json
+```
+
+### Additional Commands
+
+```bash
+# Manage tasks
+hem tasks list|add|complete|actuals|focus|progress
+
+# Manage compacts (project contracts)
+hem compact show|create|vision|scope|criteria|complete
+
+# Generate role-scoped briefs
+hem brief show|export --role steward --budget 4000
+
+# Session memory management
+hem memory list|show|append|distill
+
+# Multi-project management
+hem projects list|add|remove|switch|scan
+
+# Profile management
+hem profile show|list|set|info
+
+# Escalation checks
+hem escalation check|thresholds
+
+# One-shot steering analysis
+hem steer analyze|prompt|check
+
+# Lint governance documents
+hem lint compact|tasks|accord|amendment
+
+# Rejection tracking
+hem reject list|create|resolve|summary
+
+# Knowledge base
+hem knowledge list|search|show|stages|add|corroborate
+
+# Archive management
+hem archive list|show|search|export
+
+# Template rendering
+hem template list|show|render
+
+# Version info
+hem version
+```
+
+## How It Works
+
+HEM CLI wraps `@hedonistic-io/hem-core`, which provides:
+
+- **Profile system** -- per-project behavior profiles (saas-product, hardware, open-source, etc.)
+- **Hedonistic Index** -- a composite quality score measuring session health, steering quality, agent performance, and outcome quality
+- **Governance validation** -- checks for COMPACT.md, TASKS.md, proper git workflow, and method compliance
+- **Estimation calibration** -- track estimate-vs-actual ratios and improve future estimates
+- **Multi-engine orchestration** -- launch and manage agents across Claude, Codex, Gemini, Copilot, and more
+- **Cryptographic signing** -- sign and verify governance documents
+
+## Quality Priority
+
+HEM enforces a strict quality priority in all work:
+
+1. Correctness
+2. Security
+3. Simplicity
+4. Maintainability
+5. Performance
+
+## The Method
+
+The Hedonistic Method is a universal creation methodology built for AI-native development. It covers the full project lifecycle from genesis through integration, with structured governance that scales from solo projects to multi-agent orchestration.
+
+Learn more at the [method repository](https://github.com/hedonistic-io/method).
+
+## License
+
+MIT - Hedonistic IO LLC

package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@hedonistic-io/hem",
+  "version": "1.0.0",
+  "description": "HEM CLI — init, validate, measure, and manage Hedonistic Method projects",
+  "type": "module",
+  "bin": {
+    "hem": "packages/hem-cli/dist/cli.js"
+  },
+  "scripts": {
+    "build": "npm run build:core && npm run build:cli",
+    "build:core": "cd packages/hem-core && npx tsc",
+    "build:cli": "cd packages/hem-cli && npx tsc",
+    "test": "npm run test:core && npm run test:cli",
+    "test:core": "cd packages/hem-core && npx vitest run",
+    "test:cli": "cd packages/hem-cli && npx vitest run",
+    "dev": "cd packages/hem-cli && npx tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "workspaces": [
+    "packages/hem-core",
+    "packages/hem-cli"
+  ],
+  "keywords": [
+    "hem",
+    "hedonistic",
+    "engineering",
+    "methodology",
+    "ai",
+    "agents",
+    "cli",
+    "governance",
+    "creation"
+  ],
+  "author": "Hedonistic IO LLC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hedonistic-io/method-hem-cli.git"
+  },
+  "homepage": "https://github.com/hedonistic-io/method-hem-cli#readme",
+  "bugs": {
+    "url": "https://github.com/hedonistic-io/method-hem-cli/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

packages/hem-cli/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@hedonistic-io/hem-cli",
+  "version": "1.0.0",
+  "description": "The Hedonistic Method — AI-native creation methodology CLI",
+  "type": "module",
+  "bin": {
+    "hem": "dist/cli.js"
+  },
+  "main": "dist/cli.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "hem",
+    "hedonistic",
+    "engineering",
+    "ai",
+    "agents",
+    "methodology",
+    "cli"
+  ],
+  "author": "Hedonistic IO LLC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hedonistic-io/method-hem-cli.git",
+    "directory": "packages/hem-cli"
+  },
+  "dependencies": {
+    "@hedonistic-io/hem-core": "workspace:*",
+    "@types/react": "^19.2.14",
+    "ink": "^6.8.0",
+    "ink-big-text": "^2.0.0",
+    "ink-gradient": "^4.0.0",
+    "ink-select-input": "^6.2.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "react": "^19.2.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}