Release automation + palette customization

.editorconfig

@@ -0,0 +1,19 @@
+# Editor configuration
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.go]
+indent_style = tab
+tab_width = 8
+[Makefile]
+indent_style = tab
+
+[*.md]
+trim_trailing_whitespace = false

.githooks/pre-commit

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "Running gofmt check..."
+make fmt-check
+
+echo "Running golangci-lint..."
+if ! command -v golangci-lint >/dev/null 2>&1; then
+  echo "golangci-lint not found. Install from https://golangci-lint.run/ before committing." >&2
+  exit 1
+fi
+make lint
+
+echo "Running go tests..."
+make test
+
+echo "Regenerating docs to ensure sync..."
+BIN="${MARKDOWN_TRANSCLUSION_BIN:-markdown-transclusion}"
+if ! command -v "$BIN" >/dev/null 2>&1; then
+  echo "Required '$BIN' not found. Install it or set MARKDOWN_TRANSCLUSION_BIN." >&2
+  exit 1
+fi
+MARKDOWN_TRANSCLUSION_BIN="$BIN" make docs
+# Abort commit if generation changed files; force developers to stage them.
+if ! git diff --quiet --exit-code; then
+  echo "Docs changed during pre-commit. Stage the updates and re-run commit." >&2
+  git --no-pager diff --stat
+  exit 1
+fi
+
+echo "Pre-commit checks passed."

.github/workflows/docs.yml

@@ -0,0 +1,38 @@
+name: Docs Pipeline
+
+'on':
+  push:
+    branches: [main]
+  pull_request:
+permissions:
+  contents: read
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - name: Install markdown-transclusion CLI
+        run: npm install -g markdown-transclusion@^1
+      # Alternatively:
+      # - name: Generate docs
+      #   run: npx --yes markdown-transclusion --version && make docs
+      #   env:
+      #     MARKDOWN_TRANSCLUSION_BIN: npx --yes markdown-transclusion
+      - name: Generate docs
+        env:
+          MARKDOWN_TRANSCLUSION_BIN: markdown-transclusion
+        run: make docs
+      - name: Ensure docs are up to date
+        run: git diff --stat --exit-code
+      - name: Run docs tests
+        run: make docs-test

.github/workflows/quality.yml

@@ -0,0 +1,51 @@
+name: Quality Checks
+
+on:
+  push:
+    branches: [main, docs-release-pipeline]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: '1.25'
+
+      - name: Install markdown-transclusion
+        run: npm install -g markdown-transclusion
+
+      - name: gofmt check
+        run: make fmt-check
+
+      - name: Run golangci-lint
+        uses: golangci/golangci-lint-action@v3
+        with:
+          version: v1.59.1
+          install-mode: binary
+          args: ./...
+        env:
+          GOTOOLCHAIN: go1.22.7
+
+      - name: Go tests
+        run: make test
+
+      - name: Generate docs
+        run: make docs
+
+      - name: Verify docs
+        run: make docs-verify
+
+      - name: Ensure docs committed
+        run: |
+          git status --porcelain
+          git diff --stat
+          git diff --exit-code

.golangci.yml

@@ -0,0 +1,23 @@
+run:
+  timeout: 5m
+  tests: true
+linters:
+  enable:
+    - govet
+    - staticcheck
+    - gofmt
+    - goimports
+    - revive
+    - errcheck
+    - ineffassign
+    - gosec
+issues:
+  exclude-use-default: false
+
+linters-settings:
+  gofmt:
+    simplify: true
+  goimports:
+    local-prefixes: github.com/flyingrobots/hubless
+  revive:
+    ignore-generated-header: true

@hubless/README.md

@@ -0,0 +1,15 @@
+# Hubless Planning Data
+
+This directory holds the human-authored JSON records plus generated markdown artifacts derived from them.
+
+- `schema/` – JSON schemas (hand maintained).
+- `roadmap/` – milestone & feature data.
+  - `*.json` – source of truth (hand maintained).
+  - `templates/` – Markdown templates that reference shared components (edit these when layout changes).
+  - `generated/` – Output Markdown rendered from templates (do not edit, regenerated via `make docs`).
+- `issues/` – stories & tasks following the task lifecycle.
+  - `tasks/*.json` and `stories/*.json` – source of truth (hand maintained).
+  - `templates/` – Markdown templates to document task/story tables (edit as needed).
+  - `generated/` – Output Markdown rendered from templates (`tasks.md`, `archive.md`, etc.). Do not edit by hand.
+
+Run `make docs` from the repository root to regenerate anything in `generated/` after changing source JSON or templates.

@hubless/issues/generated/archive.md

@@ -0,0 +1,17 @@
+# Hubless Archive
+
+> Generated overview of completed work. Regenerate with `make docs` after updating story or task JSON.
+
+## Completed Stories
+
+<!-- Generated by docs-components; do not edit manually. -->
+| ID | Title | Completed Status |
+| --- | --- | --- |
+| — | — | — |
+
+## Completed Tasks
+
+<!-- Generated by docs-components; do not edit manually. -->
+| ID | Title | Completed On | Badges |
+| --- | --- | --- | --- |
+| hubless/m0/task/0005 | Evaluate markdown component library | 2025-09-19 | Tested, Documented, Shipped |

@hubless/issues/tasks.md → @hubless/issues/generated/tasks.md

@@ -1,15 +1,26 @@
 # Hubless Tasks
 
-> Source of truth: individual JSON files in `@hubless/issues/tasks/`. Task IDs follow `{project}/{milestone}/{type}/{number}`.\
-> Regenerate this Markdown whenever tasks change (manual for now).
+> Source of truth: individual JSON files in `@hubless/issues/tasks/`. Task IDs follow `{project}/{milestone}/{type}/{number}`.\\
+> Regenerate this Markdown with `make docs` after updating task JSON files.
 
-| ID                                                      | Title                                   | Status  | Owner        | Labels                   | Badges | Updated    |
-| ------------------------------------------------------- | --------------------------------------- | ------- | ------------ | ------------------------ | ------ | ---------- |
-| [hubless/m0/task/0001](tasks/hubless-m0-task-0001.json) | Port progress updater from Python to Go | PLANNED | _unassigned_ | m0-foundations, prog     | —      | —          |
-| [hubless/m0/task/0004](tasks/hubless-m0-task-0004.json) | Structure @hubless planning artifacts   | STARTED | _unassigned_ | m0-foundations, planning | —      | 2025-09-18 |
-| [hubless/m1/task/0002](tasks/hubless-m1-task-0002.json) | Introduce Fang-based CLI skeleton       | PLANNED | _unassigned_ | m1-cli, cli              | —      | —          |
-| [hubless/m1/task/0003](tasks/hubless-m1-task-0003.json) | Implement Git event store adapter       | PLANNED | _unassigned_ | m1-cli, event-store      | —      | —          |
-| [hubless/m1/task/0005](tasks/hubless-m1-task-0005.json) | Prototype Bubbletea TUI and Fang CLI wireframes | STARTED | _unassigned_ | m1-cli, tui, cli         | —      | 2025-09-19 |
+<!-- Generated by docs-components; do not edit manually. -->
+| ID | Title | Status | Owner | Labels | Badges | Updated |
+| --- | --- | --- | --- | --- | --- | --- |
+| [hubless/m0/task/0001](tasks/hubless-m0-task-0001.json) | Port progress updater from Python to Go | PLANNED | _unassigned_ | m0-foundations, prog | — | — |
+| [hubless/m0/task/0004](tasks/hubless-m0-task-0004.json) | Structure @hubless planning artifacts | STARTED | _unassigned_ | m0-foundations, planning | — | 2025-09-18 |
+| [hubless/m0/task/0005](tasks/hubless-m0-task-0005.json) | Evaluate markdown component library | DONE | _unassigned_ | m0-foundations, docs, automation | Tested, Documented, Shipped | 2025-09-19 |
+| [hubless/m1/task/0002](tasks/hubless-m1-task-0002.json) | Introduce Fang-based CLI skeleton | PLANNED | _unassigned_ | m1-cli, cli | — | — |
+| [hubless/m1/task/0003](tasks/hubless-m1-task-0003.json) | Implement Git event store adapter | PLANNED | _unassigned_ | m1-cli, event-store | — | — |
+| [hubless/m1/task/0005](tasks/hubless-m1-task-0005.json) | Prototype Bubbletea TUI and Fang CLI wireframes with mocked data | STARTED | _unassigned_ | m1-cli, tui, cli | — | — |
+
+## Status Breakdown
+
+<!-- Generated by docs-components; do not edit manually. -->
+| Status | Count |
+| --- | --- |
+| DONE | 1 |
+| STARTED | 2 |
+| PLANNED | 3 |
 
 ## Task Dependency Graph
 
@@ -50,4 +61,4 @@
     {"at": "YYYY-MM-DDThh:mm:ssZ", "author": "name", "body": "Short update."}
   ]
 }
-```
+```

@hubless/issues/stories/hubless-story-0007.json

@@ -0,0 +1,22 @@
+{
+  "id": "hubless/story/0007",
+  "title": "As a documentarian I can compose docs from reusable components",
+  "status": "PLANNED",
+  "persona": "Documentarian",
+  "need": "maintain consistent documentation without manual duplication",
+  "outcome": "Docs are assembled from shared Markdown snippets using automation integrated with Hubless tooling",
+  "acceptance_criteria": [
+    "Component snippets library exists",
+    "At least one doc (e.g., PRD) generated from components",
+    "Build command integrates snippet assembly"
+  ],
+  "features": [
+    "hubless/feature/docs-components"
+  ],
+  "dependencies": [
+    "hubless/story/0001"
+  ],
+  "tasks": [
+    "hubless/m0/task/0005"
+  ]
+}

@hubless/issues/tasks.archive.md

@@ -4,4 +4,3 @@ Move completed tasks here once they have badges **Tested**, **Documented**, **Sh
 
 | ID | Title | Completed | Badges | Notes |
 |----|-------|-----------|--------|-------|
-

@hubless/issues/tasks/hubless-m0-task-0005.json

@@ -0,0 +1,88 @@
+{
+  "id": "hubless/m0/task/0005",
+  "title": "Evaluate markdown component library",
+  "status": "DONE",
+  "owner": null,
+  "description": "Assess the existing markdown-transclusion project and plan integration or Go-based alternative for reusable documentation components.",
+  "labels": [
+    "m0-foundations",
+    "docs",
+    "automation"
+  ],
+  "links": [
+    {
+      "type": "repo",
+      "url": "https://github.com/flyingrobots/markdown-transclusion",
+      "label": "markdown-transclusion"
+    },
+    {
+      "type": "doc",
+      "url": "../../docs/PRD.md",
+      "label": "PRD"
+    },
+    {
+      "type": "doc",
+      "url": "../../docs/TechSpec.md",
+      "label": "Tech spec"
+    }
+  ],
+  "required_inputs": [
+    {
+      "resource": "https://github.com/flyingrobots/markdown-transclusion",
+      "exclusivity": "read-only",
+      "notes": "Review existing snippet tooling."
+    },
+    {
+      "resource": "../../docs/PRD.md",
+      "exclusivity": "read-only",
+      "notes": "Identify repeated content candidates."
+    },
+    {
+      "resource": "../../@hubless/schema",
+      "exclusivity": "read-only",
+      "notes": "Ensure schema-driven docs compatible with snippet outputs."
+    }
+  ],
+  "expected_outputs": [
+    {
+      "resource": "../../docs/reference/docs-components-plan.md",
+      "notes": "Plan outlining snippet integration approach."
+    },
+    {
+      "resource": "../../@hubless/roadmap/features/hubless-feature-docs-components.json",
+      "notes": "Feature status updated with findings."
+    }
+  ],
+  "expertise": [
+    "Documentation tooling",
+    "Go",
+    "Automation pipelines"
+  ],
+  "dependencies": [
+    "hubless/m0/task/0004"
+  ],
+  "badges": [
+    "Tested",
+    "Documented",
+    "Shipped"
+  ],
+  "created_at": "2025-09-18",
+  "updated_at": "2025-09-19",
+  "notes": [
+    {
+      "at": "2025-09-19T17:20:00Z",
+      "author": "codex",
+      "body": "Integrated markdown-transclusion pipeline, added reusable snippets under docs/components, and documented make docs workflow."
+    },
+    {
+      "at": "2025-09-19T18:05:00Z",
+      "author": "codex",
+      "body": "Reorganized @hubless directories, added progress/dependency/status components, wired them into PRD/TechSpec, and added generator unit tests."
+    },
+    {
+      "at": "2025-09-19T18:25:00Z",
+      "author": "codex",
+      "body": "Parameterised dependency graph output and published archived rollups with CI enforcement."
+    }
+  ]
+}

@hubless/issues/templates/archive.md

@@ -0,0 +1,11 @@
+# Hubless Archive
+
+> Generated overview of completed work. Regenerate with `make docs` after updating story or task JSON.
+
+## Completed Stories
+
+![[docs/components/issues/archived-stories.md]]
+
+## Completed Tasks
+
+![[docs/components/issues/archived-tasks.md]]