@etiquekit/etq 1.0.13 → 1.0.15

package/packages/control/src/cli/commands/workflow.ts

@@ -1,86 +0,0 @@
-import { resolve } from 'node:path';
-import { requireString } from '../argv';
-import { evaluateWorkflowCheck, explainWorkflowMode } from '../../workflow/evaluator';
-import { loadWorkflowEnvelope, loadWorkflowMode } from '../../workflow/loader';
-import { WORKFLOW_MODE_TYPES, type WorkflowModeType } from '../../workflow/types';
-
-const WORKFLOW_VERBS = new Set(['validate', 'explain', 'check']);
-
-export function isWorkflowCommand(command: string): boolean {
-  return command === 'workflow';
-}
-
-function parseModeType(raw: string | undefined): WorkflowModeType {
-  if (!raw || !(WORKFLOW_MODE_TYPES as readonly string[]).includes(raw)) {
-    throw new Error(`workflow mode type must be one of: ${WORKFLOW_MODE_TYPES.join(', ')}`);
-  }
-  return raw as WorkflowModeType;
-}
-
-function renderValidate(mode: Awaited<ReturnType<typeof loadWorkflowMode>>): string {
-  return [
-    'workflow_mode_validate:',
-    `  mode_id: ${mode.mode_id}`,
-    `  mode_version: ${mode.mode_version}`,
-    `  mode_type: ${mode.mode_type}`,
-    `  authority_status: ${mode.authority_status}`,
-    `  advisory_consensus_can_authorize: ${String(mode.grant.advisory_consensus_can_authorize)}`,
-    '  can_authorize: false',
-    '  can_attach_grant: false',
-  ].join('\n');
-}
-
-function renderExplain(explanation: ReturnType<typeof explainWorkflowMode>): string {
-  return [
-    'workflow_mode_explain:',
-    `  mode_type: ${explanation.mode_type}`,
-    `  summary: ${explanation.summary}`,
-    `  use_when: ${explanation.use_when.join(', ')}`,
-    `  boundary: ${explanation.boundary.join(', ')}`,
-  ].join('\n');
-}
-
-function renderCheck(result: ReturnType<typeof evaluateWorkflowCheck>): string {
-  return [
-    'workflow_check:',
-    `  task_ref: ${result.task_ref}`,
-    `  mode_id: ${result.mode_id}`,
-    `  mode_type: ${result.mode_type}`,
-    `  recommendation: ${result.recommendation}`,
-    `  missing: ${result.missing.join(', ') || 'none'}`,
-    `  warnings: ${result.warnings.join(', ') || 'none'}`,
-    `  can_authorize: ${String(result.authority_boundary.can_authorize)}`,
-    `  can_attach_grant: ${String(result.authority_boundary.can_attach_grant)}`,
-    `  consensus_can_authorize: ${String(result.authority_boundary.consensus_can_authorize)}`,
-  ].join('\n');
-}
-
-export async function dispatchWorkflow(
-  positionals: string[],
-  flags: Record<string, string | boolean>,
-): Promise<void> {
-  const verb = positionals[1];
-  if (!verb || !WORKFLOW_VERBS.has(verb)) {
-    throw new Error(`workflow verb must be one of: ${[...WORKFLOW_VERBS].join(', ')}`);
-  }
-  const json = Boolean(flags.json);
-
-  if (verb === 'validate') {
-    const mode = await loadWorkflowMode(resolve(requireString(flags, 'mode')));
-    console.log(json ? JSON.stringify(mode, null, 2) : renderValidate(mode));
-    return;
-  }
-
-  if (verb === 'explain') {
-    const explanation = explainWorkflowMode(parseModeType(positionals[2]));
-    console.log(json ? JSON.stringify(explanation, null, 2) : renderExplain(explanation));
-    return;
-  }
-
-  if (verb === 'check') {
-    const mode = await loadWorkflowMode(resolve(requireString(flags, 'mode')));
-    const envelope = await loadWorkflowEnvelope(resolve(requireString(flags, 'task')));
-    const result = evaluateWorkflowCheck(mode, envelope);
-    console.log(json ? JSON.stringify(result, null, 2) : renderCheck(result));
-  }
-}

package/packages/control/src/cli/commands/workspace.ts

@@ -1,50 +0,0 @@
-import { resolve } from 'node:path';
-import { requireString } from '../argv';
-import { validateWorkspaceAuthorityFile } from '../../workspace/authority';
-
-const WORKSPACE_VERBS = new Set(['authority']);
-
-export function isWorkspaceCommand(command: string): boolean {
-  return command === 'workspace';
-}
-
-function renderAuthority(result: Awaited<ReturnType<typeof validateWorkspaceAuthorityFile>>): string {
-  return [
-    'workspace_authority_validation:',
-    `  workspace_id: ${result.workspace_id}`,
-    result.org_id ? `  org_id: ${result.org_id}` : undefined,
-    `  verdict: ${result.verdict}`,
-    `  authority_mode: ${result.authority_mode}`,
-    `  canonical_location: ${result.canonical_location}`,
-    `  creator_is_root_authority: ${String(result.creator_is_root_authority)}`,
-    `  local_workspace_is_canonical: ${String(result.local_workspace_is_canonical)}`,
-    `  org_workspace_is_canonical: ${String(result.org_workspace_is_canonical)}`,
-    `  runtime_cell_can_mutate_canonical_truth: ${String(result.runtime_cell_can_mutate_canonical_truth)}`,
-    `  owner_role: ${result.owner_role.role_id}`,
-    `  owner_occupant: ${result.owner_role.occupant_principal}`,
-    `  owner_replacement_policy: ${result.owner_role.replacement_policy}`,
-    `  memory_stores: ${result.memory_summary.stores}`,
-    `  filesystem_like_memory_stores: ${result.memory_summary.filesystem_like_stores}`,
-    `  shared_read_write_memory_stores: ${result.memory_summary.shared_read_write_stores}`,
-    `  consolidation_mode: ${result.memory_summary.consolidation_mode}`,
-    `  runner_memory_boundary: ${result.memory_summary.runner_memory_boundary}`,
-    `  consolidation_mutates_input_store: ${String(result.memory_summary.consolidation_mutates_input_store)}`,
-    '  boundary: authority roots in the declared canonical workspace; memory/consolidation cannot authorize work',
-  ].filter((line): line is string => Boolean(line)).join('\n');
-}
-
-export async function dispatchWorkspace(
-  positionals: string[],
-  flags: Record<string, string | boolean>,
-): Promise<void> {
-  const verb = positionals[1];
-  if (!verb || !WORKSPACE_VERBS.has(verb)) {
-    throw new Error(`workspace verb must be one of: ${[...WORKSPACE_VERBS].join(', ')}`);
-  }
-  const json = Boolean(flags.json);
-
-  if (verb === 'authority') {
-    const result = await validateWorkspaceAuthorityFile(resolve(requireString(flags, 'profile')));
-    console.log(json ? JSON.stringify(result, null, 2) : renderAuthority(result));
-  }
-}

package/packages/control/src/cli/core-usage.ts

@@ -1,34 +0,0 @@
-export function coreUsage(): string {
-  return [
-    'etiquette-core',
-    '',
-    'Bare-bones governance profile. Core governs; runtimes/adapters remain optional.',
-    '',
-    'usage (seat readiness):',
-    '  etiquette-core seat readiness --seat <id> [--project <path>] [--json]',
-    '  etiquette-core seat heartbeat [--project <path>] [--seat <id>] [--json]',
-    '  etiquette-core seat status [--project <path>] [--json]',
-    '',
-    'usage (workflow mode checks):',
-    '  etiquette-core workflow validate --mode <path> [--json]',
-    '  etiquette-core workflow explain <deliberative|expedient|mixed> [--json]',
-    '  etiquette-core workflow check --mode <path> --task <path> [--json]',
-    '',
-    'usage (rubrics):',
-    '  etiquette-core rubric validate --rubric <path> [--json]',
-    '  etiquette-core rubric sandbox --rubric <path> --fixtures <path> --run-by <seat> [--json]',
-    '  etiquette-core rubric promote-check --rubric <path> --receipt <path> [--json]',
-    '',
-    'usage (operational dispatch):',
-    '  etiquette-core session create --seat <id> --task <ref> [--project <path>] [--json]',
-    '  etiquette-core session note --session <id> --section plan|tool|retry|evidence|note --message <text> [--project <path>] [--json]',
-    '  etiquette-core session migrate-project [--project <path>] [--dry-run] [--json]',
-    '  etiquette-core dispatch check --mode <path> --task <path> [--project <path>] [--json]',
-    '  etiquette-core dispatch record --mode <path> --task <path> [--project <path>] [--json]',
-    '',
-    'usage (local ledger read model):',
-    '  etiquette-core ledger index [--project <path>] [--json]',
-    '  etiquette-core ledger search <query> [--project <path>] [--limit <n>] [--json]',
-    '  etiquette-core ledger show <entry-or-ref-id> [--project <path>]',
-  ].join('\n');
-}

package/packages/control/src/cli/prompt.ts

@@ -1,67 +0,0 @@
-import { createInterface } from 'node:readline/promises';
-import { stdin as input, stdout as output } from 'node:process';
-
-export interface PromptIo {
-  inputIsTTY: boolean;
-  outputIsTTY: boolean;
-  ci: boolean;
-}
-
-export function defaultPromptIo(): PromptIo {
-  return {
-    inputIsTTY: Boolean(input.isTTY),
-    outputIsTTY: Boolean(output.isTTY),
-    ci: Boolean(process.env.CI),
-  };
-}
-
-export function canPrompt(io: PromptIo = defaultPromptIo()): boolean {
-  return io.inputIsTTY && io.outputIsTTY && !io.ci;
-}
-
-export async function askChoice<T extends string>(inputPrompt: {
-  label: string;
-  choices: Array<{ value: T; label: string }>;
-  defaultValue: T;
-  io?: PromptIo;
-}): Promise<T> {
-  if (!canPrompt(inputPrompt.io)) return inputPrompt.defaultValue;
-  const choices = inputPrompt.choices
-    .map((choice, index) => `${index + 1}) ${choice.label}`)
-    .join('  ');
-  const defaultIndex = inputPrompt.choices.findIndex((choice) => choice.value === inputPrompt.defaultValue) + 1;
-  const rl = createInterface({ input, output });
-  try {
-    const answer = (await rl.question(`${inputPrompt.label}\n${choices}\nSelect [${defaultIndex}]: `)).trim();
-    if (answer.length === 0) return inputPrompt.defaultValue;
-    const numeric = Number.parseInt(answer, 10);
-    if (Number.isInteger(numeric) && numeric >= 1 && numeric <= inputPrompt.choices.length) {
-      return inputPrompt.choices[numeric - 1].value;
-    }
-    const normalized = answer.toLowerCase();
-    const byValue = inputPrompt.choices.find((choice) => choice.value.toLowerCase() === normalized);
-    if (byValue) return byValue.value;
-    return inputPrompt.defaultValue;
-  } finally {
-    rl.close();
-  }
-}
-
-export async function askConfirm(inputPrompt: {
-  label: string;
-  defaultValue: boolean;
-  io?: PromptIo;
-}): Promise<boolean> {
-  if (!canPrompt(inputPrompt.io)) return inputPrompt.defaultValue;
-  const suffix = inputPrompt.defaultValue ? '[Y/n]' : '[y/N]';
-  const rl = createInterface({ input, output });
-  try {
-    const answer = (await rl.question(`${inputPrompt.label} ${suffix} `)).trim().toLowerCase();
-    if (answer.length === 0) return inputPrompt.defaultValue;
-    if (answer === 'y' || answer === 'yes') return true;
-    if (answer === 'n' || answer === 'no') return false;
-    return inputPrompt.defaultValue;
-  } finally {
-    rl.close();
-  }
-}

package/packages/control/src/cli/supervision-deps.ts

@@ -1,44 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { appendFile, mkdir, readFile, writeFile } from 'node:fs/promises';
-import { resolve } from 'node:path';
-import type { SupervisionDeps } from '../../../protocol/src/index';
-import { openSupervisionSqlite } from '../supervision/index';
-import { createSupervisionProjectionAdapter } from '../supervision/projection-adapter';
-import { optionalString } from './argv';
-
-/**
- * Supervision `SupervisionDeps` factory + projection-dir resolver. Extracted
- * from the former monolithic `cli.ts` so the supervision command dispatcher
- * can import a pre-built adapter set without re-declaring the plumbing.
- */
-export function makeSupervisionDeps(
-  projectionDir: string,
-  eventsPath: string,
-): SupervisionDeps {
-  const adapter = createSupervisionProjectionAdapter({
-    projectionDir,
-    eventsPath,
-  });
-  return {
-    now: () => new Date(),
-    randomId: () => randomUUID(),
-    readFile: (path) => readFile(path, 'utf-8'),
-    writeFile: (path, contents) => writeFile(path, contents, 'utf-8'),
-    appendFile: (path, contents) => appendFile(path, contents, 'utf-8'),
-    mkdirp: async (path) => {
-      await mkdir(path, { recursive: true });
-    },
-    openSqlite: (path) => openSupervisionSqlite(path),
-    projectionAdapter: adapter,
-  };
-}
-
-export function resolveProjectionDir(
-  flags: Record<string, string | boolean>,
-  campaignRoot: string,
-  sessionId: string,
-): string {
-  const override = optionalString(flags, 'projection-dir');
-  if (override) return resolve(override);
-  return resolve(campaignRoot, '.etiquette', 'projections', sessionId);
-}

package/packages/control/src/cli/usage.ts

@@ -1,241 +0,0 @@
-/**
- * CLI usage text. Extracted from the former monolithic `cli.ts`.
- */
-export function usage(): string {
-  return [
-    'etiquette',
-    '',
-    'Govern agent-assisted engineering work with seats, evidence, and promotion gates.',
-    '',
-    'Start here:',
-    '  etiquette setup [--target auto|codex|claude-code|gemini|all] [--project <path>] [--yes]',
-    '  etiquette handoff [--project <path>] [--profile solo|lead-review|codex-cc-gemini] [--task-prefix <id>]',
-    '  etiquette init [--project <path>]',
-    '  etiquette bootstrap local [--project <path>] [--profile solo|lead-review|codex-cc-gemini] [--ask]',
-    '  etiquette whereami [--project <path>] [--seat <id>] [--task <ref>] [--json]',
-    '  etiquette doctor [--project <path>]',
-    '  etiquette status [--project <path>]',
-    '',
-    'Daily work:',
-    '  etiquette join --seat <id> [--project <path>] [--json]',
-    '  etiquette pickup --seat <id> --task <ref> --expect-project-id <id> [--project <path>] [--text|--json]',
-    '  etiquette enter <task> --seat <id> --operator <principal> [--project <path>]',
-    '  etiquette session create --seat <id> --task <ref> [--project <path>]',
-    '  etiquette notify poll --seat <id> [--project <path>] [--after-seq <n>] [--json]',
-    '  etiquette notify webhook github --payload <file> --delivery <id> --event push --signature-256 <sha256=...> [--json]',
-    '  etiquette return check --task <ref> --seat <id> [--remote-runner] [--project <path>] [--json]',
-    '  etiquette retire <path> --reason <kind> --evidence-ref <ref> --removed-by <seat> [--project <path>]',
-    '  etiquette diagnostics runner-glitch --symptom <text> [--session <id>] [--project <path>]',
-    '  etiquette diagnostics no-return --task <ref> --seat <id> [--project <path>] [--json]',
-    '  etiquette dispatch scaffold [--project <path>] [--task-id <id>] [--seat <id>] [--out <dir>]',
-    '  etiquette dispatch check --mode <path> --task <path> [--project <path>] [--json]',
-    '  etiquette dispatch record --mode <path> --task <path> [--project <path>] [--json]',
-    '  etiquette bus view [--project <path>] [--lane <id>] [--seat <id>] [--since <n>] [--format text|json|markdown]',
-    '  etiquette timeline view [--project <path>] [--scope project|seat|lane|principal] [--seat <id>] [--lane <id>]',
-    '  etiquette timeline preview [--project <path>] [--scope project|seat|lane|principal] [--seat <id>] [--lane <id>] [--host 127.0.0.1] [--port 4174]  # loopback only',
-    '  etiquette ledger index|search|show ...',
-    '',
-    'Seats and readiness:',
-    '  etiquette seat readiness --seat <id> [--project <path>] [--json]',
-    '  etiquette seat status [--project <path>] [--json]',
-    '  etiquette seat owner-card --manifest <path> [--project <path>] [--json]',
-    '',
-    'Management views:',
-    '  etiquette console board [--project <path>] [--seat <id>] [--text]',
-    '  etiquette console serve [--project <path>] [--host 127.0.0.1] [--port 4173]',
-    '',
-    'Release checks:',
-    '  etiquette release readiness [--project <path>] [--json]',
-    '  etiquette release ga-readiness [--project <path>] --channel <name> --verify-tag-remote <remote> [--json]',
-    '',
-    'Advanced surfaces:',
-    '  etiquette help advanced',
-    '  etiquette-core help',
-    '',
-    'Authority boundary:',
-    '  commands can initialize, check, record evidence, and project read models;',
-    '  they do not grant authority, merge, close work, publish, or promote truth.',
-  ].join('\n');
-}
-
-export function advancedUsage(): string {
-  return [
-    'etiquette advanced command catalog',
-    '',
-    'usage (supervision — Phase 1, etiquette/internal/docs/supervision/PHASE1.md):',
-    '  discipline session-open <session-id> --campaign-root <path> --objective <text> --lead <seat> --responder <seat>',
-    '      --escalation-owner <seat> --time-cap <minutes> --turn-cap <n> --source-ref a,b [--topic <text>] [--seat-manifest <path>]',
-    '  discipline session-status <session-id> --campaign-root <path> [--json] [--seat-manifest <path>]',
-    '  discipline turn-open <session-id> --campaign-root <path> --owner <seat> --action-class <class>',
-    '      --max-duration <minutes> --allowed-command a,b --repo-root a,b --owned-path a,b',
-    '      --forbidden-path a,b --verify-command a,b [--requires-human-approval]',
-    '      [--projection-policy on_state_change|on_command_only] [--seat-manifest <path>]',
-    '  discipline turn-close <session-id> --campaign-root <path> --turn <turn-id>',
-    '      --result <done|blocked|handed_off|stopped|timed_out> --summary <text> [--evidence-ref a,b]',
-    '  discipline session-command <session-id> <command> --campaign-root <path>',
-    '      [--actor <seat>] [--payload <json>] [--seat-manifest <path>]',
-    '  discipline session-project <session-id> --campaign-root <path>',
-    '  discipline session-rebuild <session-id> --campaign-root <path>',
-    '  discipline seat-validate [--manifest <path>]',
-    '',
-    'usage (memory spine — local-first, compact-then-exact):',
-    '  etiquette memory index [--project <path>] [--db <path>] [--local-private] [--json]',
-    '  etiquette memory index --export [<dir>] --org-id <opaque-id> --confirm-shared-export',
-    '      [--workspace-id <opaque-id>] [--project <path>] [--db <path>] [--json]',
-  '  etiquette memory search <query> [--project <path>] [--db <path>] [--limit <n>] [--json]',
-  '  etiquette memory show <capsule-id> [--project <path>] [--db <path>]',
-    '  etiquette memory preflight <lane-or-task> [--project <path>] [--db <path>] [--limit <n>] [--json]',
-    '  etiquette memory context [<query>] [--lane <ref>] [--task <ref>] [--query <text>]',
-    '      [--workspace-id <opaque-id>] [--org-id <opaque-id>] [--project <path>] [--db <path>] [--limit <n>] [--json]',
-  '  etiquette memory status [--project <path>] [--db <path>] [--root <path>] [--json]',
-  '  etiquette memory store init --store <id> --scope org|workspace|lane|seat|session --access read_only|read_write',
-  '      [--mount-mode filesystem_like|context_pack|mcp_resource] [--write-policy none|candidate_only|curator_promoted]',
-  '      [--project <path>] [--root <path>] [--at <iso8601>] [--json]',
-  '  etiquette memory store add --store <id> --path <repo-relative> --content <text> --evidence <type:ref,...>',
-  '      [--project <path>] [--root <path>] [--at <iso8601>] [--json]',
-  '  etiquette memory store list [--project <path>] [--root <path>] [--json]',
-  '  etiquette memory store show --store <id> [--project <path>] [--root <path>] [--json]',
-  '  etiquette memory consolidate --input <store-id,...> --out <store-id> [--project <path>] [--root <path>] [--at <iso8601>] [--json]',
-  '  etiquette memory drain-import --from-project <child-path> --from-store <id> --to-store <id>',
-  '      [--project <parent-path>] [--from-root <path>] [--to-root <path>] [--source-ref <ref>] [--target-ref <ref>]',
-  '      [--path-prefix <repo-relative>] [--receipt <path>] [--at <iso8601>] [--json]',
-  '  etiquette memory sharded-drain-import --shard <id=child-path,...> --from-store <id> --to-store <id>',
-  '      [--project <parent-path>] [--target-ref <ref>] [--receipt-dir <repo-dir>] [--receipt <path>] [--json]',
-  '  etiquette memory stale [--project <path>] [--db <path>] [--limit <n>] [--json]',
-  '  etiquette memory rejected [--project <path>] [--db <path>] [--limit <n>] [--json]',
-    '',
-    'usage (console v0 - read-only local management view):',
-    '  etiquette console snapshot [--project <path>] [--json]',
-    '  etiquette console board [--project <path>] [--seat <id>] [--text]',
-    '  etiquette console serve [--project <path>] [--host 127.0.0.1] [--port 4173]',
-    '',
-    'usage (local workspace workflow v0 - repo-local onboarding, no hidden authority):',
-    '  etiquette setup [--target auto|all|codex|claude-code|gemini] [--project <path>]',
-    '      [--dry-run] [--force] [--eject] [--json]',
-    '  etiquette handoff [--project <path>] [--profile solo|lead-review|codex-cc-gemini] [--task-prefix <id>] [--json]',
-    '  etiquette init [--project <path>]',
-    '  etiquette bootstrap local [--project <path>] [--profile solo|lead-review|codex-cc-gemini] [--ask]',
-    '      [--task-prefix <id>] [--lead-seat <id>] [--lead-principal <id>]',
-    '      [--review-seat <id>] [--review-principal <id>] [--qa-seat <id>] [--qa-principal <id>]',
-    '      [--bootstrap-seat <id>] [--bootstrap-principal <id>] [--no-qa] [--force] [--json]',
-    '  etiquette whereami [--project <path>] [--seat <id>] [--task <ref>] [--json]',
-    '  etiquette join --seat <id> [--project <path>] [--json]',
-    '  etiquette pickup --seat <id> --task <ref> [--project <path>] [--text|--json]',
-    '  etiquette enter <task> --seat <id> --operator <principal> [--project <path>]',
-    '  etiquette session create --seat <id> --task <ref> [--session-id <id>] [--operator <id>]',
-    '      [--owner <id>] [--target-ref <ref>] [--creation-mode explicit|dynamic] [--project <path>] [--json]',
-    '  etiquette session note --session <id> --section plan|tool|retry|evidence|note --message <text>',
-    '      [--project <path>] [--json]',
-    '  etiquette session migrate-project [--project <path>] [--dry-run] [--json]',
-    '  etiquette audit append --actor <id> --action <id> [--project <path>] [--refs a,b]',
-    '  etiquette roster card validate --card <path>',
-    '  etiquette roster enroll <seat> --card <path> --operator-principal <id> --execution-seat <id>',
-    '      --as-role <role> --authority-scope <scope> --mode <mode> --orientation-ref <path> [--project <path>]',
-    '  etiquette roster ready <seat> --ack-ref <ref> --orientation-ref <path> [--project <path>]',
-    '  etiquette roster list|show|posture <seat> [--project <path>] [--json]',
-    '  etiquette roster doctor [--project <path>] [--cards <dir>] [--json]',
-    '  etiquette post --role <role> --lane <id> --from <seat> --to <seat> [--changes-state true|false] [--emit] [--project <path>]',
-    '  etiquette post --profile <path> --draft --out <path> [profile field flags] [--force]',
-    '  etiquette notify subscribe --seat <id> --lane <id> [--roles a,b] [--project <path>]',
-    '  etiquette notify feed --seat <id> [--project <path>] [--text]',
-    '  etiquette notify poll --seat <id> [--project <path>] [--after-seq <n>] [--limit <n>] [--text|--json]',
-    '  etiquette notify queue --seat <id> [--project <path>] [--text|--json]',
-    '  etiquette notify webhook github --payload <file> --delivery <id> --event push --signature-256 <sha256=...>',
-    '      [--secret-env ETIQUETTE_GITHUB_WEBHOOK_SECRET] [--text|--json]',
-    '  etiquette return check --task <ref> --seat <id> [--role any|implementation-return|review-return]',
-    '      [--tier local-advisory|remote-runner-hard-gate] [--remote-runner] [--project <path>] [--json]',
-    '  etiquette retire <path> --reason superseded|rejected|closed|duplicate --evidence-ref <ref>',
-    '      --removed-by <seat> [--superseded-by <path>] [--project <path>] [--json]',
-    '  etiquette trash list|show|restore|rebuild ... [--project <path>] [--json]',
-    '  etiquette rig doctor [--project <path>]',
-    '  etiquette bus status [n] [--project <path>] [--text]',
-    '  etiquette bus inbox --addressee <seat> [--project <path>] [--text]',
-    '  etiquette bus view [--project <path>] [--lane <id>] [--seat <id>] [--role <role>]',
-    '      [--since <n|local://event/n>] [--until <n|local://event/n>] [--match <text>]',
-    '      [--kind all|events|packets] [--limit <n>] [--format text|json|markdown]',
-    '  etiquette timeline view [--project <path>] [--scope project|seat|lane|principal] [--seat <id>] [--lane <id>]',
-    '      [--since <n|local://event/n>] [--until <n|local://event/n>] [--match <text>] [--limit <n>]',
-    '      [--format text|json|markdown]',
-    '  etiquette timeline preview [--project <path>] [--scope project|seat|lane|principal] [--seat <id>] [--lane <id>]',
-    '      [--since <n|local://event/n>] [--until <n|local://event/n>] [--match <text>] [--limit <n>]',
-    '      [--host 127.0.0.1] [--port 4174]  # loopback only',
-    '  etiquette diagnostics runner-glitch --symptom <text> [--runner <id>] [--session <id>]',
-    '      [--command-ref <summary>] [--severity info|warning|blocked] [--project <path>] [--json]',
-    '  etiquette diagnostics no-return --task <ref> --seat <id> [--role any|implementation-return|review-return]',
-    '      [--project <path>] [--json]',
-    '  etiquette status [--project <path>]',
-    '',
-    'usage (ledger retrieval v0.1 - local generated index, compact-then-exact):',
-    '  etiquette ledger index [--project <path>] [--db <path>] [--json]',
-    '  etiquette ledger search <query> [--project <path>] [--db <path>] [--limit <n>] [--json]',
-    '  etiquette ledger search --topic <slug> [--project <path>] [--db <path>] [--limit <n>] [--json]',
-    '  etiquette ledger show <entry-or-ref-id> [--project <path>] [--db <path>]',
-    '',
-    'usage (hook adapter v0.1 — optional, disabled-by-default, opt in via ETIQUETTE_HOOKS_ENABLED=1):',
-    '  etiquette hook session_start [--workspace <id>] [--payload <json>]',
-    '  etiquette hook user_prompt_submit [--workspace <id>] [--payload <json>]',
-    '  etiquette hook post_tool_use [--workspace <id>] [--payload <json>]',
-    '  etiquette hook stop [--workspace <id>] [--payload <json>]',
-    '  etiquette hook session_end [--workspace <id>] [--payload <json>]',
-    '',
-    'usage (harness maintenance v0 - pruning receipts, inventory, and canary checks; no deletion authority):',
-    '  etiquette harness receipt --receipt <path> [--json]',
-    '  etiquette harness inventory --manifest <path> [--project <path>] [--json]',
-    '  etiquette harness canary --receipt <path> [--json]',
-    '',
-    'usage (rubric runner v0.1 - local sandbox evidence, no authority activation):',
-    '  etiquette rubric validate --rubric <path> [--json]',
-    '  etiquette rubric sandbox --rubric <path> --fixtures <path> --run-by <seat>',
-    '      [--environment local|sandbox-isolated] [--at <iso8601>] [--receipt <path>] [--json]',
-    '  etiquette rubric promote-check --rubric <path> --receipt <path>',
-    '      [--policy <path>] [--grant-ref <ref>] [--json]',
-    '',
-    'usage (release readiness v0 - package/channel checks, no publish authority):',
-    '  etiquette release channels [--json]',
-    '  etiquette release readiness [--project <path>] [--json] [--fail-on-blocked]',
-    '  etiquette release ga-readiness [--project <path>] --channel <name>',
-    '      --verify-tag-remote <remote> [--json] [--fail-on-blocked]',
-    '',
-    'usage (infra runtime — source-only, not shipped in the local devkit):',
-    '  runtime verifier cells, kube plans, and EKS provisioning belong to an infra/runtime workspace.',
-    '',
-    'usage (seat capability heartbeat v0.1 - local-first routing metadata):',
-    '  etiquette seat readiness --seat <id> [--project <path>] [--state <path>]',
-    '      [--seat-type control_seat|execution_seat|review_seat|seat_maintainer]',
-    '      [--execution-surface <opaque-id>] [--capability-source config|local_validation|seat_doctor|agent_self_declared]',
-    '      [--operational-status operational|degraded|blocked|offline]',
-    '      [--model-tier lite_fast|balanced|frontier_high_reasoning|local_unknown] [--model-id <opaque-id>]',
-    '      [--active-workers <n>] [--max-recommended-workers <n>] [--supports-parallel true|false]',
-    '      [--supported-strategies a,b] [--unsupported-strategies a,b] [--constraints a,b] [--json]',
-    '  etiquette seat heartbeat [--project <path>] [--state <path>] [--seat <id>]',
-    '      [--operational-status operational|degraded|blocked|offline] [--active-workers <n>] [--constraints a,b] [--json]',
-    '  etiquette seat status [--project <path>] [--state <path>] [--json]',
-    '  etiquette seat owner-card --manifest <path> [--project <path>] [--state <path>] [--at <iso8601>] [--json]',
-    '',
-    'usage (workflow mode consumer v0.1 - advisory-only policy preset checks):',
-    '  etiquette workflow validate --mode <path> [--json]',
-    '  etiquette workflow explain <deliberative|expedient|mixed> [--json]',
-    '  etiquette workflow check --mode <path> --task <path> [--json]',
-    '',
-    'usage (workspace authority v0 - personal-local, org-remote, runtime-cell roots):',
-    '  etiquette workspace authority --profile <path> [--json]',
-    '',
-    'usage (operational dispatch consumer v0 - advisory wiring, no execution):',
-    '  etiquette dispatch scaffold [--project <path>] [--task-id <id>] [--seat <id>] [--out <dir>] [--json]',
-    '  etiquette dispatch check --mode <path> --task <path> [--project <path>] [--state <path>]',
-    '      [--sandbox-receipt <path>] [--strategy <id>] [--at <iso8601>] [--json]',
-    '  etiquette dispatch record --mode <path> --task <path> [--project <path>] [--state <path>]',
-    '      [--sandbox-receipt <path>] [--strategy <id>] [--at <iso8601>] [--recorded-by <seat>] [--json]',
-    '  etiquette dispatch projection --record <path> [--artifact-ref <ref>] [--receipt-ref <repo-ref>]',
-    '      [--status success|partial|blocked|failed] [--validation-summary <text>] [--json]',
-    '',
-    'usage (local-remote sync outbox v0 - local staging only, no network):',
-    '  etiquette sync stage [--project <path>] [--outbox <path>] [--workspace-id <opaque-id>]',
-    '      [--org-id <opaque-id>] [--seat-id <opaque-id>] [--at <iso8601>] [--json]',
-    '  etiquette sync join-plan --invite <path> --joined-by <seat> --claim-ref <ref>',
-    '      [--at <iso8601>] [--json]',
-    '  etiquette sync git-driver-status [--project <path>] [--driver-name etqseq] [--json]',
-    '  etiquette sync install-git-merge-driver [--project <path>] [--driver-name etqseq]',
-    '      [--driver-command <command>] [--skip-git-config] [--json]',
-  ].join('\n');
-}