@etiquekit/etq 0.0.1 → 1.0.4

package/templates/seat-packs-v0/bin/provision-seat

@@ -0,0 +1,70 @@
+#!/bin/sh
+set -eu
+
+ROOT=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
+
+usage() {
+  echo "usage: sh bin/provision-seat <codex|claude-code|gemini|openrouter|ollama|auto> <target-dir>" >&2
+}
+
+if [ "$#" -ne 2 ]; then
+  usage
+  exit 2
+fi
+
+seat=$1
+target=$2
+
+detect() {
+  found=""
+  command -v codex >/dev/null 2>&1 && found="$found codex"
+  command -v claude >/dev/null 2>&1 && found="$found claude-code"
+  command -v gemini >/dev/null 2>&1 && found="$found gemini"
+  command -v ollama >/dev/null 2>&1 && found="$found ollama"
+  [ -n "${OPENROUTER_API_KEY:-}" ] && found="$found openrouter"
+
+  count=$(set -- $found; echo "$#")
+  if [ "$count" -eq 1 ]; then
+    set -- $found
+    echo "$1"
+    return
+  fi
+  if [ "$count" -eq 0 ]; then
+    echo "auto-detect found no supported runtime; choose explicit seat type" >&2
+    exit 2
+  fi
+  echo "auto-detect found multiple runtimes:$found; choose explicit seat type" >&2
+  exit 2
+}
+
+if [ "$seat" = "auto" ]; then
+  seat=$(detect)
+fi
+
+case "$seat" in
+  codex) src="$ROOT/source/codex-seat" ;;
+  claude-code) src="$ROOT/source/claude-code-seat" ;;
+  gemini) src="$ROOT/source/gemini-seat" ;;
+  openrouter) src="$ROOT/source/openrouter-seat" ;;
+  ollama) src="$ROOT/source/ollama-seat" ;;
+  *) usage; exit 2 ;;
+esac
+
+if [ -e "$target" ]; then
+  echo "target already exists: $target" >&2
+  exit 2
+fi
+
+cp -R "$src" "$target"
+
+if command -v git >/dev/null 2>&1; then
+  git -C "$target" init -q
+  git -C "$target" add .
+  git -C "$target" \
+    -c user.name="Etiquette Seat" \
+    -c user.email="etiquette-seat@example.invalid" \
+    commit -q -m "Initial $seat seat scaffold"
+fi
+
+echo "provisioned $seat seat at $target"
+

package/templates/seat-packs-v0/source/claude-code-seat/.llm-substrate/HANDOFF.md

@@ -0,0 +1,24 @@
+# Claude Code Seat Handoff
+
+You are an Etiquette Claude Code seat.
+
+## Startup
+
+1. Run `sh bin/seat-doctor`.
+2. Read the target project's head-start surfaces.
+3. Report readiness before claiming work.
+
+## Default Capability
+
+```yaml
+seat_type: execution_seat | review_seat
+execution_surface: claude_code
+supported_strategies:
+  - solo
+  - local_adversarial_tango
+  - telescope
+blocked_strategies:
+  - required_cross_runtime_without_backplane
+```
+
+Do not clone product repos until assigned.

package/templates/seat-packs-v0/source/claude-code-seat/README.md

@@ -0,0 +1,19 @@
+# Claude Code Seat
+
+Optional Etiquette seat template for a Claude Code runtime.
+
+Use this only after the control seat grants a Claude Code execution or review seat.
+
+## Head-Start
+
+Before pickup in the target project, read:
+
+1. `AGENTS.md`
+2. `docs/work/BOARD.md`
+3. `docs/work/runbooks/SESSION_PICKUP.md`
+4. `docs/work/manuals/SEAT_OPERATING_MANUAL.md`
+5. `docs/work/cookbooks/ADD_A_LANE.md` when routing new work
+
+Use `$etiquette-seat-lifecycle` before pickup after stale context, resume,
+runner/model/profile swaps, or workflow migration. Hooks and readiness are
+evidence only; the task envelope is the work authority.

package/templates/seat-packs-v0/source/claude-code-seat/bin/seat-doctor

@@ -0,0 +1,8 @@
+#!/bin/sh
+set -eu
+ROOT=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
+test -f "$ROOT/.llm-substrate/HANDOFF.md"
+if [ "${ETIQUETTE_REQUIRE_RUNTIME:-0}" = "1" ]; then
+  command -v claude >/dev/null 2>&1
+fi
+echo "claude-code-seat: ok"

package/templates/seat-packs-v0/source/codex-seat/.llm-substrate/HANDOFF.md

@@ -0,0 +1,25 @@
+# Codex Seat Handoff
+
+You are an Etiquette Codex seat.
+
+## Startup
+
+1. Run `sh bin/seat-doctor`.
+2. Use `etiquette notify poll --seat <id> --after-seq <n>` for cursor-based wake checks.
+3. Read the target project's head-start surfaces.
+4. Report readiness before claiming work.
+
+## Default Capability
+
+```yaml
+seat_type: execution_seat | review_seat
+execution_surface: codex
+supported_strategies:
+  - solo
+  - telescope
+  - manifold
+blocked_strategies:
+  - required_cross_runtime_without_backplane
+```
+
+Do not clone product repos until assigned.

package/templates/seat-packs-v0/source/codex-seat/README.md

@@ -0,0 +1,22 @@
+# Codex Seat
+
+Optional Etiquette seat template for a Codex runtime.
+
+Use this only after the control seat grants a Codex execution or review seat.
+
+## Head-Start
+
+Before pickup in the target project, read:
+
+1. `AGENTS.md`
+2. `docs/work/BOARD.md`
+3. `docs/work/runbooks/SESSION_PICKUP.md`
+4. `docs/work/manuals/SEAT_OPERATING_MANUAL.md`
+5. `docs/work/cookbooks/ADD_A_LANE.md` when routing new work
+
+Use `$etiquette-seat-lifecycle` before pickup after stale context, resume,
+runner/model/profile swaps, or workflow migration. Hooks and readiness are
+evidence only; the task envelope is the work authority.
+
+For bounded, cursor-based wake checks use the portable core command
+`etiquette notify poll --seat <id> --after-seq <n>` instead of raw `tail -F` monitors.

package/templates/seat-packs-v0/source/codex-seat/bin/seat-doctor

@@ -0,0 +1,8 @@
+#!/bin/sh
+set -eu
+ROOT=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
+test -f "$ROOT/.llm-substrate/HANDOFF.md"
+if [ "${ETIQUETTE_REQUIRE_RUNTIME:-0}" = "1" ]; then
+  command -v codex >/dev/null 2>&1
+fi
+echo "codex-seat: ok"

package/templates/seat-packs-v0/source/gemini-seat/.llm-substrate/HANDOFF.md

@@ -0,0 +1,23 @@
+# Gemini Seat Handoff
+
+You are an Etiquette Gemini seat.
+
+## Startup
+
+1. Run `sh bin/seat-doctor`.
+2. Read the target project's head-start surfaces.
+3. Report readiness before claiming work.
+
+## Default Capability
+
+```yaml
+seat_type: execution_seat | review_seat
+execution_surface: gemini_cli
+supported_strategies:
+  - solo
+  - telescope
+blocked_strategies:
+  - required_parallel_without_adapter
+```
+
+Do not clone product repos until assigned.

package/templates/seat-packs-v0/source/gemini-seat/README.md

@@ -0,0 +1,19 @@
+# Gemini Seat
+
+Optional Etiquette seat template for a Gemini CLI runtime.
+
+Use this only after the control seat grants a Gemini execution or review seat.
+
+## Head-Start
+
+Before pickup in the target project, read:
+
+1. `AGENTS.md`
+2. `docs/work/BOARD.md`
+3. `docs/work/runbooks/SESSION_PICKUP.md`
+4. `docs/work/manuals/SEAT_OPERATING_MANUAL.md`
+5. `docs/work/cookbooks/ADD_A_LANE.md` when routing new work
+
+Use `$etiquette-seat-lifecycle` before pickup after stale context, resume,
+runner/model/profile swaps, or workflow migration. Hooks and readiness are
+evidence only; the task envelope is the work authority.

package/templates/seat-packs-v0/source/gemini-seat/bin/seat-doctor

@@ -0,0 +1,8 @@
+#!/bin/sh
+set -eu
+ROOT=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
+test -f "$ROOT/.llm-substrate/HANDOFF.md"
+if [ "${ETIQUETTE_REQUIRE_RUNTIME:-0}" = "1" ]; then
+  command -v gemini >/dev/null 2>&1
+fi
+echo "gemini-seat: ok"

package/templates/seat-packs-v0/source/ollama-seat/.llm-substrate/HANDOFF.md

@@ -0,0 +1,24 @@
+# Ollama Seat Handoff
+
+You are an Etiquette Ollama seat.
+
+## Startup
+
+1. Run `sh bin/seat-doctor`.
+2. Read the target project's head-start surfaces.
+3. Report readiness before claiming work.
+
+## Default Capability
+
+```yaml
+seat_type: execution_seat | review_seat
+execution_surface: ollama
+supported_strategies:
+  - solo
+  - telescope
+blocked_strategies:
+  - required_remote_api_without_adapter
+  - required_parallel_without_adapter
+```
+
+Do not clone product repos until assigned.

package/templates/seat-packs-v0/source/ollama-seat/README.md

@@ -0,0 +1,19 @@
+# Ollama Seat
+
+Optional Etiquette seat template for a local Ollama runtime.
+
+Use this only after the control seat grants an Ollama execution or review seat.
+
+## Head-Start
+
+Before pickup in the target project, read:
+
+1. `AGENTS.md`
+2. `docs/work/BOARD.md`
+3. `docs/work/runbooks/SESSION_PICKUP.md`
+4. `docs/work/manuals/SEAT_OPERATING_MANUAL.md`
+5. `docs/work/cookbooks/ADD_A_LANE.md` when routing new work
+
+Use `$etiquette-seat-lifecycle` before pickup after stale context, resume,
+runner/model/profile swaps, or workflow migration. Hooks and readiness are
+evidence only; the task envelope is the work authority.

package/templates/seat-packs-v0/source/ollama-seat/bin/seat-doctor

@@ -0,0 +1,8 @@
+#!/bin/sh
+set -eu
+ROOT=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
+test -f "$ROOT/.llm-substrate/HANDOFF.md"
+if [ "${ETIQUETTE_REQUIRE_RUNTIME:-0}" = "1" ]; then
+  command -v ollama >/dev/null 2>&1
+fi
+echo "ollama-seat: ok"

package/templates/seat-packs-v0/source/openrouter-seat/.llm-substrate/HANDOFF.md

@@ -0,0 +1,24 @@
+# OpenRouter Seat Handoff
+
+You are an Etiquette OpenRouter seat.
+
+## Startup
+
+1. Run `sh bin/seat-doctor`.
+2. Read the target project's head-start surfaces.
+3. Report readiness before claiming work.
+
+## Default Capability
+
+```yaml
+seat_type: execution_seat | review_seat
+execution_surface: openrouter
+supported_strategies:
+  - solo
+  - telescope
+blocked_strategies:
+  - required_local_tool_execution_without_adapter
+  - required_parallel_without_adapter
+```
+
+Do not clone product repos until assigned. Do not embed API keys in receipts.

package/templates/seat-packs-v0/source/openrouter-seat/README.md

@@ -0,0 +1,19 @@
+# OpenRouter Seat
+
+Optional Etiquette seat template for an OpenRouter-backed runtime.
+
+Use this only after the control seat grants an OpenRouter execution or review seat.
+
+## Head-Start
+
+Before pickup in the target project, read:
+
+1. `AGENTS.md`
+2. `docs/work/BOARD.md`
+3. `docs/work/runbooks/SESSION_PICKUP.md`
+4. `docs/work/manuals/SEAT_OPERATING_MANUAL.md`
+5. `docs/work/cookbooks/ADD_A_LANE.md` when routing new work
+
+Use `$etiquette-seat-lifecycle` before pickup after stale context, resume,
+runner/model/profile swaps, or workflow migration. Hooks and readiness are
+evidence only; the task envelope is the work authority.

package/templates/seat-packs-v0/source/openrouter-seat/bin/seat-doctor

@@ -0,0 +1,8 @@
+#!/bin/sh
+set -eu
+ROOT=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
+test -f "$ROOT/.llm-substrate/HANDOFF.md"
+if [ "${ETIQUETTE_REQUIRE_RUNTIME:-0}" = "1" ]; then
+  test -n "${OPENROUTER_API_KEY:-}"
+fi
+echo "openrouter-seat: ok"

package/templates/seat-packs-v0/validate-seat-packs.sh

@@ -0,0 +1,27 @@
+#!/bin/sh
+set -eu
+
+ROOT=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+
+for seat in codex-seat claude-code-seat gemini-seat openrouter-seat ollama-seat; do
+  test -d "$ROOT/source/$seat"
+  sh "$ROOT/source/$seat/bin/seat-doctor"
+done
+
+tmp="${TMPDIR:-/tmp}/etiquette-seat-pack-provision-check-$$"
+sh "$ROOT/bin/provision-seat" codex "$tmp"
+sh "$tmp/bin/seat-doctor"
+
+fakebin="${TMPDIR:-/tmp}/etiquette-seat-pack-auto-bin-$$"
+autotmp="${TMPDIR:-/tmp}/etiquette-seat-pack-auto-check-$$"
+mkdir -p "$fakebin"
+if [ -x /usr/bin/true ]; then
+  true_cmd=/usr/bin/true
+else
+  true_cmd=/bin/true
+fi
+ln -s "$true_cmd" "$fakebin/codex"
+PATH="$fakebin:/bin:/usr/bin" sh "$ROOT/bin/provision-seat" auto "$autotmp"
+sh "$autotmp/bin/seat-doctor"
+
+echo "seat-packs: ok"

package/bin/etq

@@ -1,4 +0,0 @@
-#!/usr/bin/env node
-console.log("Etiquette (etq) — local-first governance for agent-assisted engineering.");
-console.log("This name is reserved; releases begin at https://etiquekit.com");
-process.exit(0);