@etiquekit/etq 0.0.1 → 1.0.1

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);