@ui8kit/uxdx 0.1.0

package/packages/sdlc/harness/full/sdlc.sh

@@ -0,0 +1,230 @@
+#!/usr/bin/env bash
+# Run from a product repo after this pack is copied to .sdlc/
+#   .sdlc/sdlc.sh install
+#   .sdlc/sdlc.sh start <slug>
+#   .sdlc/sdlc.sh status
+set -euo pipefail
+
+SDLC_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"
+REPO_ROOT="$(CDPATH= cd -- "$SDLC_DIR/.." && pwd)"
+MANIFEST="$SDLC_DIR/manifest.yaml"
+BEGIN='<!-- sdlc-harness:begin -->'
+END='<!-- sdlc-harness:end -->'
+
+die() { printf 'sdlc: %s\n' "$*" >&2; exit 1; }
+
+need_manifest() {
+  [[ -f "$MANIFEST" ]] || die "missing $MANIFEST (copy a harness pack into .sdlc/)"
+}
+
+level() {
+  awk '/^level:[[:space:]]/ { print $2; exit }' "$MANIFEST"
+}
+
+warn_location() {
+  local base
+  base="$(basename -- "$SDLC_DIR")"
+  if [[ "$base" != ".sdlc" ]]; then
+    printf 'sdlc: warning: script dir is %s (expected .sdlc in a product repo)\n' "$SDLC_DIR" >&2
+  fi
+}
+
+usage() {
+  cat <<EOF
+Usage: .sdlc/sdlc.sh <command>
+
+  install              Overlay Cursor rules/skills; merge AGENTS.md at repo root
+  start <slug> [opts]  Copy templates into .sdlc/changes/<slug>/
+  status               Show level, overlay, and changes
+
+start options:
+  --force              Overwrite files that already exist in the change folder
+  --intent             Also copy intent.md (light/core; full always copies it)
+  --spec               Also copy spec.md (light; core/full as below)
+  --boundary           core: copy intent.md + spec.md + plan.md
+
+Repo root is the parent of this .sdlc directory:
+  $REPO_ROOT
+EOF
+}
+
+copy_rules() {
+  local src="$SDLC_DIR/cursor/rules" dest="$REPO_ROOT/.cursor/rules" f
+  [[ -d "$src" ]] || die "missing $src"
+  mkdir -p "$dest"
+  shopt -s nullglob
+  for f in "$src"/*.mdc; do
+    cp -- "$f" "$dest/"
+    printf 'sdlc: rule %s\n' "$dest/$(basename -- "$f")"
+  done
+  shopt -u nullglob
+}
+
+copy_skills() {
+  local src="$SDLC_DIR/skills" dest="$REPO_ROOT/.cursor/skills" d name
+  [[ -d "$src" ]] || die "missing $src"
+  mkdir -p "$dest"
+  shopt -s nullglob
+  for d in "$src"/*/; do
+    name="$(basename -- "$d")"
+    rm -rf -- "$dest/$name"
+    cp -R -- "$d" "$dest/$name"
+    printf 'sdlc: skill %s\n' "$dest/$name"
+  done
+  shopt -u nullglob
+}
+
+merge_agents() {
+  local overlay="$SDLC_DIR/AGENTS.md" dest="$REPO_ROOT/AGENTS.md" tmp
+  [[ -f "$overlay" ]] || die "missing $overlay"
+  if [[ ! -f "$dest" ]]; then
+    cp -- "$overlay" "$dest"
+    printf 'sdlc: created %s\n' "$dest"
+    return
+  fi
+  tmp="$(mktemp)"
+  if grep -F -q -- "$BEGIN" "$dest"; then
+    awk -v begin="$BEGIN" -v end="$END" -v overlay="$overlay" '
+      BEGIN {
+        while ((getline line < overlay) > 0) { o = o line "\n" }
+        close(overlay)
+      }
+      index($0, begin) == 1 {
+        printf "%s", o
+        skip = 1
+        next
+      }
+      skip {
+        if (index($0, end) == 1) skip = 0
+        next
+      }
+      { print }
+    ' "$dest" >"$tmp"
+  else
+    cat -- "$dest" >"$tmp"
+    printf '\n' >>"$tmp"
+    cat -- "$overlay" >>"$tmp"
+  fi
+  mv -- "$tmp" "$dest"
+  printf 'sdlc: merged overlay into %s\n' "$dest"
+}
+
+cmd_install() {
+  need_manifest
+  warn_location
+  copy_rules
+  copy_skills
+  merge_agents
+  printf 'sdlc: install done (level %s) repo %s\n' "$(level)" "$REPO_ROOT"
+}
+
+valid_slug() {
+  [[ "$1" =~ ^[a-z0-9][a-z0-9-]*$ ]] || die "slug must be kebab-case: $1"
+}
+
+copy_template() {
+  local src="$SDLC_DIR/$1" dest="$2/$1"
+  [[ -f "$src" ]] || die "missing template $src"
+  if [[ -e "$dest" && "$FORCE" -eq 0 ]]; then
+    printf 'sdlc: skip existing %s (use --force)\n' "$dest"
+    return
+  fi
+  cp -- "$src" "$dest"
+  printf 'sdlc: %s\n' "$dest"
+}
+
+cmd_start() {
+  need_manifest
+  warn_location
+  local slug="" with_intent=0 with_spec=0 boundary=0
+  FORCE=0
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --force) FORCE=1; shift ;;
+      --intent) with_intent=1; shift ;;
+      --spec) with_spec=1; shift ;;
+      --boundary) boundary=1; shift ;;
+      --help|-h) usage; exit 0 ;;
+      -*) die "unknown option $1" ;;
+      *)
+        [[ -z "$slug" ]] || die "unexpected argument $1"
+        slug="$1"
+        shift
+        ;;
+    esac
+  done
+  [[ -n "$slug" ]] || die "start requires <slug>"
+  valid_slug "$slug"
+
+  local lvl dest
+  lvl="$(level)"
+  dest="$SDLC_DIR/changes/$slug"
+  mkdir -p "$dest"
+
+  case "$lvl" in
+    light)
+      copy_template plan.md "$dest"
+      [[ "$with_intent" -eq 1 ]] && copy_template intent.md "$dest"
+      [[ "$with_spec" -eq 1 ]] && copy_template spec.md "$dest"
+      ;;
+    core)
+      copy_template plan.md "$dest"
+      if [[ "$boundary" -eq 1 || "$with_intent" -eq 1 || "$with_spec" -eq 1 ]]; then
+        copy_template intent.md "$dest"
+        copy_template spec.md "$dest"
+      fi
+      ;;
+    full)
+      copy_template intent.md "$dest"
+      copy_template spec.md "$dest"
+      copy_template plan.md "$dest"
+      ;;
+    *)
+      die "unknown level in manifest: $lvl"
+      ;;
+  esac
+  printf 'sdlc: change %s ready under %s\n' "$slug" "$dest"
+}
+
+cmd_status() {
+  need_manifest
+  warn_location
+  local lvl
+  lvl="$(level)"
+  printf 'level:     %s\n' "$lvl"
+  printf 'sdlc dir:  %s\n' "$SDLC_DIR"
+  printf 'repo:      %s\n' "$REPO_ROOT"
+  if [[ -f "$REPO_ROOT/AGENTS.md" ]] && grep -F -q -- "$BEGIN" "$REPO_ROOT/AGENTS.md"; then
+    printf 'AGENTS.md: overlay present\n'
+  else
+    printf 'AGENTS.md: overlay missing (run install)\n'
+  fi
+  if [[ -d "$REPO_ROOT/.cursor/rules" ]]; then
+    printf 'rules:\n'
+    ls -1 "$REPO_ROOT/.cursor/rules"/sdlc-*.mdc 2>/dev/null || printf '  (no sdlc-*.mdc)\n'
+  fi
+  printf 'changes:\n'
+  if [[ -d "$SDLC_DIR/changes" ]]; then
+    local d
+    shopt -s nullglob
+    for d in "$SDLC_DIR/changes"/*/; do
+      printf '  %s\n' "$(basename -- "$d")"
+    done
+    shopt -u nullglob
+  fi
+}
+
+main() {
+  local cmd="${1:-}"
+  [[ -n "$cmd" ]] || { usage; exit 1; }
+  shift || true
+  case "$cmd" in
+    install) cmd_install "$@" ;;
+    start) cmd_start "$@" ;;
+    status) cmd_status "$@" ;;
+    -h|--help|help) usage ;;
+    *) die "unknown command $cmd" ;;
+  esac
+}
+
+main "$@"

package/packages/sdlc/harness/full/skills/sdlc-feedback/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: sdlc-feedback
+description: >-
+  Verify agent work with the repo's existing commands before claiming done.
+  Use in full-harness repos after implementation. Do not weaken tests to
+  make a task pass.
+---
+
+# Feedback loop
+
+1. Read verify commands from root `AGENTS.md` (or Makefile / package.json
+   scripts named there).
+2. Run them. Paste or summarize the outcome.
+3. If tests fail, fix production code, not the test, unless the change is the
+   test and `plan.md` says so.
+4. For UI, use the repo's existing check (`bun run check`, screenshot, or
+   documented browser step). Do not add Playwright as a default gate.
+5. Never report complete without the proof named in `plan.md`.

package/packages/sdlc/harness/full/skills/sdlc-loop/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: sdlc-loop
+description: >-
+  Full AI-native SDLC loop for a solo developer. Use when working in a repo
+  with .sdlc/manifest.yaml level full. Drive intent.md, spec.md, plan.md in
+  order; do not skip to code on a non-trivial change.
+---
+
+# Full SDLC loop
+
+1. Write or update `.sdlc/changes/<slug>/intent.md`. The human corrects it
+   before spec.
+2. Produce `spec.md` from the intent. Flag policy conflicts. Do not start
+   plan mode until the human accepts the spec (or explicitly says "small,
+   proceed").
+3. Plan mode: `plan.md` with files, order, risks, proof. No file edits until
+   the plan is accepted.
+4. Implement in one pass when the plan is tight. Update `plan.md` if you
+   diverge.
+5. Hand off to skill `sdlc-feedback` before reporting done.
+6. PR text points at the three artifacts. Review uses `sdlc-review`.

package/packages/sdlc/harness/full/skills/sdlc-review/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: sdlc-review
+description: >-
+  Review a PR against .sdlc/REVIEW.md, spec.md, and plan.md in a full-harness
+  repo. Use when reviewing diffs or addressing review comments.
+---
+
+# PR review (full)
+
+1. Read `.sdlc/REVIEW.md` and the change's `spec.md` / `plan.md`.
+2. Three passes: bugs, security, compliance with the artifacts.
+3. Findings do not merge the PR. A human approves.
+4. If the same mistake appears twice, add a line to product `AGENTS.md` or a
+   skill — not a one-off comment that will rot.
+5. The agent that wrote the diff must not be treated as the approver.

package/packages/sdlc/harness/full/spec.md

@@ -0,0 +1,28 @@
+# Spec: <!-- title from intent -->
+
+Intent: `.sdlc/changes/<slug>/intent.md`
+Status: draft
+
+## Requirements
+
+What the change must do. Trace each item to the intent.
+
+## Design
+
+How it fits the existing codebase. Name surfaces (API, admin, BFF, host) —
+do not invent a new plane.
+
+## Skills and policies applied
+
+Brand, security, UX, stack-contract — list the files that constrained this
+spec (`AGENTS.md`, `.cursor/rules/*`, `.project/adr/*`).
+
+## Areas of concern
+
+Where policies conflict or evidence is missing. A human resolves each item
+before plan mode. Do not leave a red flag for engineering to discover in the
+diff.
+
+## Open questions carried forward
+
+Questions from `intent.md` that remain, with an owner.

package/packages/sdlc/harness/full/start.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+set -euo pipefail
+exec "$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)/sdlc.sh" start "$@"

package/packages/sdlc/harness/light/AGENTS.md

@@ -0,0 +1,13 @@
+<!-- sdlc-harness:begin -->
+## SDLC harness (light)
+
+This repo uses the **light** pack from `hinddy/brainstorm` (`.harness-sdlc/light`).
+Working copy: `.sdlc/`. Per-change artifacts: `.sdlc/changes/<slug>/`.
+
+- Non-trivial work starts in plan mode. Commit `plan.md` before a large diff.
+- `spec.md` is optional. Do not start a requirements theatre for a one-file fix.
+- Verify with this repository's existing commands, listed in this `AGENTS.md`
+  or `.project/`. Do not add Playwright or extra browser suites as a default gate.
+- Overlay rules: `.cursor/rules/sdlc-light.mdc`. Overlay skill: `sdlc-light`.
+- Product rules and this file's stack contract win over the harness if they conflict.
+<!-- sdlc-harness:end -->

package/packages/sdlc/harness/light/README.md

@@ -0,0 +1,15 @@
+# Light harness
+
+For product repos that already have a contract (`AGENTS.md`, stack rules, tests).
+Examples: AlexY OS, GitCourse, Lab, BrandOSS, ui8px-cli, FastyGo UI.
+
+Copy this directory to `<repo>/.sdlc/`. Then overlay Cursor files — see
+`../README.md`.
+
+## Per change
+
+1. `mkdir -p .sdlc/changes/<slug>`
+2. Copy `plan.md` into that folder and fill it.
+3. Add `intent.md` only if the origin is unclear (incident, external request).
+4. Skip `spec.md` unless you are changing published IA or a user-visible contract.
+5. Run the repo's existing verify command before calling the task done.

package/packages/sdlc/harness/light/changes/README.md

@@ -0,0 +1,6 @@
+# changes/
+
+One directory per change: copy `../intent.md` (optional), `../plan.md` (required)
+from the pack root into `./<slug>/` and fill them.
+
+Do not edit the pack-root templates in place once a real change is in flight.

package/packages/sdlc/harness/light/cursor/rules/sdlc-light.mdc

@@ -0,0 +1,16 @@
+---
+description: Light SDLC — plan.md and existing verify gates; no spec theatre
+alwaysApply: true
+---
+
+# Light SDLC overlay
+
+This repository opted into `.sdlc` harness **light**.
+
+- Put change artifacts under `.sdlc/changes/<slug>/`.
+- Require `plan.md` for non-trivial diffs. `intent.md` is optional. Skip
+  `spec.md` unless published IA or a public contract changes.
+- After code changes, run the verify command already documented in `AGENTS.md`.
+- Do not add eval suites, managed hooks, or autonomous maintain loops.
+- If this overlay disagrees with stack-contract or product `AGENTS.md`, the
+  product files win.

package/packages/sdlc/harness/light/install.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+set -euo pipefail
+exec "$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)/sdlc.sh" install "$@"

package/packages/sdlc/harness/light/intent.md

@@ -0,0 +1,24 @@
+# Intent (light — optional)
+
+Author: <!-- name -->
+Status: draft
+Slug: <!-- kebab-case, matches .sdlc/changes/<slug>/ -->
+
+## Problem
+
+What cannot be done today, in the originator's words.
+
+## Proposed outcome
+
+What better looks like. One paragraph.
+
+## Out of scope
+
+What this change will not do.
+
+## Constraints
+
+Repo `AGENTS.md` and existing `.cursor/rules` stay in force. Do not invent
+kinds, routes, or a second API.
+
+## Open questions

package/packages/sdlc/harness/light/manifest.yaml

@@ -0,0 +1,15 @@
+level: light
+version: 1
+copy_to: .sdlc
+cursor:
+  rules: cursor/rules
+  skills: skills
+agents_md:
+  overlay: AGENTS.md
+  merge_markers:
+    begin: "<!-- sdlc-harness:begin -->"
+    end: "<!-- sdlc-harness:end -->"
+artifacts:
+  required: [plan.md]
+  optional: [intent.md]
+  skip_by_default: [spec.md]

package/packages/sdlc/harness/light/plan.md

@@ -0,0 +1,28 @@
+# Plan (light)
+
+From: <!-- intent/spec slug or issue URL -->
+Status: draft
+Author: <!-- engineer -->
+
+## Files that change
+
+-
+
+## Order of work
+
+1.
+2.
+
+## Tests / proof
+
+Name the existing command that must pass (`make verify`, `bun run validate`,
+`go test ./...`, or the repo's documented gate). Do not invent a parallel suite.
+
+## Risks
+
+-
+
+## Non-goals
+
+Do not expand product IA, add a second REST shape, or edit pinned modules to
+ship this change.

package/packages/sdlc/harness/light/sdlc.sh

@@ -0,0 +1,230 @@
+#!/usr/bin/env bash
+# Run from a product repo after this pack is copied to .sdlc/
+#   .sdlc/sdlc.sh install
+#   .sdlc/sdlc.sh start <slug>
+#   .sdlc/sdlc.sh status
+set -euo pipefail
+
+SDLC_DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"
+REPO_ROOT="$(CDPATH= cd -- "$SDLC_DIR/.." && pwd)"
+MANIFEST="$SDLC_DIR/manifest.yaml"
+BEGIN='<!-- sdlc-harness:begin -->'
+END='<!-- sdlc-harness:end -->'
+
+die() { printf 'sdlc: %s\n' "$*" >&2; exit 1; }
+
+need_manifest() {
+  [[ -f "$MANIFEST" ]] || die "missing $MANIFEST (copy a harness pack into .sdlc/)"
+}
+
+level() {
+  awk '/^level:[[:space:]]/ { print $2; exit }' "$MANIFEST"
+}
+
+warn_location() {
+  local base
+  base="$(basename -- "$SDLC_DIR")"
+  if [[ "$base" != ".sdlc" ]]; then
+    printf 'sdlc: warning: script dir is %s (expected .sdlc in a product repo)\n' "$SDLC_DIR" >&2
+  fi
+}
+
+usage() {
+  cat <<EOF
+Usage: .sdlc/sdlc.sh <command>
+
+  install              Overlay Cursor rules/skills; merge AGENTS.md at repo root
+  start <slug> [opts]  Copy templates into .sdlc/changes/<slug>/
+  status               Show level, overlay, and changes
+
+start options:
+  --force              Overwrite files that already exist in the change folder
+  --intent             Also copy intent.md (light/core; full always copies it)
+  --spec               Also copy spec.md (light; core/full as below)
+  --boundary           core: copy intent.md + spec.md + plan.md
+
+Repo root is the parent of this .sdlc directory:
+  $REPO_ROOT
+EOF
+}
+
+copy_rules() {
+  local src="$SDLC_DIR/cursor/rules" dest="$REPO_ROOT/.cursor/rules" f
+  [[ -d "$src" ]] || die "missing $src"
+  mkdir -p "$dest"
+  shopt -s nullglob
+  for f in "$src"/*.mdc; do
+    cp -- "$f" "$dest/"
+    printf 'sdlc: rule %s\n' "$dest/$(basename -- "$f")"
+  done
+  shopt -u nullglob
+}
+
+copy_skills() {
+  local src="$SDLC_DIR/skills" dest="$REPO_ROOT/.cursor/skills" d name
+  [[ -d "$src" ]] || die "missing $src"
+  mkdir -p "$dest"
+  shopt -s nullglob
+  for d in "$src"/*/; do
+    name="$(basename -- "$d")"
+    rm -rf -- "$dest/$name"
+    cp -R -- "$d" "$dest/$name"
+    printf 'sdlc: skill %s\n' "$dest/$name"
+  done
+  shopt -u nullglob
+}
+
+merge_agents() {
+  local overlay="$SDLC_DIR/AGENTS.md" dest="$REPO_ROOT/AGENTS.md" tmp
+  [[ -f "$overlay" ]] || die "missing $overlay"
+  if [[ ! -f "$dest" ]]; then
+    cp -- "$overlay" "$dest"
+    printf 'sdlc: created %s\n' "$dest"
+    return
+  fi
+  tmp="$(mktemp)"
+  if grep -F -q -- "$BEGIN" "$dest"; then
+    awk -v begin="$BEGIN" -v end="$END" -v overlay="$overlay" '
+      BEGIN {
+        while ((getline line < overlay) > 0) { o = o line "\n" }
+        close(overlay)
+      }
+      index($0, begin) == 1 {
+        printf "%s", o
+        skip = 1
+        next
+      }
+      skip {
+        if (index($0, end) == 1) skip = 0
+        next
+      }
+      { print }
+    ' "$dest" >"$tmp"
+  else
+    cat -- "$dest" >"$tmp"
+    printf '\n' >>"$tmp"
+    cat -- "$overlay" >>"$tmp"
+  fi
+  mv -- "$tmp" "$dest"
+  printf 'sdlc: merged overlay into %s\n' "$dest"
+}
+
+cmd_install() {
+  need_manifest
+  warn_location
+  copy_rules
+  copy_skills
+  merge_agents
+  printf 'sdlc: install done (level %s) repo %s\n' "$(level)" "$REPO_ROOT"
+}
+
+valid_slug() {
+  [[ "$1" =~ ^[a-z0-9][a-z0-9-]*$ ]] || die "slug must be kebab-case: $1"
+}
+
+copy_template() {
+  local src="$SDLC_DIR/$1" dest="$2/$1"
+  [[ -f "$src" ]] || die "missing template $src"
+  if [[ -e "$dest" && "$FORCE" -eq 0 ]]; then
+    printf 'sdlc: skip existing %s (use --force)\n' "$dest"
+    return
+  fi
+  cp -- "$src" "$dest"
+  printf 'sdlc: %s\n' "$dest"
+}
+
+cmd_start() {
+  need_manifest
+  warn_location
+  local slug="" with_intent=0 with_spec=0 boundary=0
+  FORCE=0
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --force) FORCE=1; shift ;;
+      --intent) with_intent=1; shift ;;
+      --spec) with_spec=1; shift ;;
+      --boundary) boundary=1; shift ;;
+      --help|-h) usage; exit 0 ;;
+      -*) die "unknown option $1" ;;
+      *)
+        [[ -z "$slug" ]] || die "unexpected argument $1"
+        slug="$1"
+        shift
+        ;;
+    esac
+  done
+  [[ -n "$slug" ]] || die "start requires <slug>"
+  valid_slug "$slug"
+
+  local lvl dest
+  lvl="$(level)"
+  dest="$SDLC_DIR/changes/$slug"
+  mkdir -p "$dest"
+
+  case "$lvl" in
+    light)
+      copy_template plan.md "$dest"
+      [[ "$with_intent" -eq 1 ]] && copy_template intent.md "$dest"
+      [[ "$with_spec" -eq 1 ]] && copy_template spec.md "$dest"
+      ;;
+    core)
+      copy_template plan.md "$dest"
+      if [[ "$boundary" -eq 1 || "$with_intent" -eq 1 || "$with_spec" -eq 1 ]]; then
+        copy_template intent.md "$dest"
+        copy_template spec.md "$dest"
+      fi
+      ;;
+    full)
+      copy_template intent.md "$dest"
+      copy_template spec.md "$dest"
+      copy_template plan.md "$dest"
+      ;;
+    *)
+      die "unknown level in manifest: $lvl"
+      ;;
+  esac
+  printf 'sdlc: change %s ready under %s\n' "$slug" "$dest"
+}
+
+cmd_status() {
+  need_manifest
+  warn_location
+  local lvl
+  lvl="$(level)"
+  printf 'level:     %s\n' "$lvl"
+  printf 'sdlc dir:  %s\n' "$SDLC_DIR"
+  printf 'repo:      %s\n' "$REPO_ROOT"
+  if [[ -f "$REPO_ROOT/AGENTS.md" ]] && grep -F -q -- "$BEGIN" "$REPO_ROOT/AGENTS.md"; then
+    printf 'AGENTS.md: overlay present\n'
+  else
+    printf 'AGENTS.md: overlay missing (run install)\n'
+  fi
+  if [[ -d "$REPO_ROOT/.cursor/rules" ]]; then
+    printf 'rules:\n'
+    ls -1 "$REPO_ROOT/.cursor/rules"/sdlc-*.mdc 2>/dev/null || printf '  (no sdlc-*.mdc)\n'
+  fi
+  printf 'changes:\n'
+  if [[ -d "$SDLC_DIR/changes" ]]; then
+    local d
+    shopt -s nullglob
+    for d in "$SDLC_DIR/changes"/*/; do
+      printf '  %s\n' "$(basename -- "$d")"
+    done
+    shopt -u nullglob
+  fi
+}
+
+main() {
+  local cmd="${1:-}"
+  [[ -n "$cmd" ]] || { usage; exit 1; }
+  shift || true
+  case "$cmd" in
+    install) cmd_install "$@" ;;
+    start) cmd_start "$@" ;;
+    status) cmd_status "$@" ;;
+    -h|--help|help) usage ;;
+    *) die "unknown command $cmd" ;;
+  esac
+}
+
+main "$@"