sequant 2.2.0 → 2.3.0

package/dist/src/ui/tui/Header.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { DIVIDER_COLOR } from "./theme.js";
+/** Top-of-dashboard summary: count, concurrency, base, quality-loop. */
+export function Header({ snapshot }) {
+    const { config, issues } = snapshot;
+    const concurrency = config.concurrency > 1
+        ? `parallel (${config.concurrency} concurrent)`
+        : "sequential";
+    const loop = config.qualityLoop ? "on" : "off";
+    const base = config.baseSha
+        ? `${config.baseBranch} @${config.baseSha.slice(0, 7)}`
+        : config.baseBranch;
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "sequant run" }), _jsxs(Text, { color: DIVIDER_COLOR, children: ["  ─  ", issues.length, " issue", issues.length === 1 ? "" : "s", "  •  ", concurrency, "  •  ", "quality loop ", loop] })] }), _jsxs(Box, { children: [_jsx(Text, { color: DIVIDER_COLOR, children: "base " }), _jsx(Text, { children: base })] })] }));
+}

package/dist/src/ui/tui/IssueBox.d.ts

@@ -0,0 +1,16 @@
+import type { JSX } from "react";
+import type { IssueRuntimeState } from "../../lib/workflow/run-state.js";
+/**
+ * Three-cell rendering of a single issue's runtime state.
+ *
+ * Cells:
+ *   1. header  — id, title, phase N/total, elapsed
+ *   2. context — branch, phase progression, log path
+ *   3. activity — current `now` line, last-activity stamp
+ */
+export declare function IssueBox({ state, slot, width, now, }: {
+    state: IssueRuntimeState;
+    slot: number;
+    width: number;
+    now: number;
+}): JSX.Element;

package/dist/src/ui/tui/IssueBox.js

@@ -0,0 +1,68 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Box, Text } from "ink";
+import { DIVIDER_COLOR, PHASE_GLYPHS, borderColorForIssue, phaseStatusColor, } from "./theme.js";
+import { Spinner } from "./Spinner.js";
+import { ElapsedTimer, formatSinceActivity } from "./ElapsedTimer.js";
+import { truncateToWidth } from "./truncate.js";
+/**
+ * Three-cell rendering of a single issue's runtime state.
+ *
+ * Cells:
+ *   1. header  — id, title, phase N/total, elapsed
+ *   2. context — branch, phase progression, log path
+ *   3. activity — current `now` line, last-activity stamp
+ */
+export function IssueBox({ state, slot, width, now, }) {
+    const border = borderColorForIssue(state.status, slot);
+    const innerWidth = Math.max(10, width - 4);
+    const doneCount = state.phases.filter((p) => p.status === "done" || p.status === "failed").length;
+    const activePhaseIndex = state.phases.findIndex((p) => p.status === "running");
+    const displayPhaseN = activePhaseIndex >= 0 ? activePhaseIndex + 1 : doneCount;
+    const total = state.phases.length;
+    const headerTitle = truncateToWidth(`#${state.number}  ${state.title}`, Math.max(10, innerWidth - 20));
+    return (_jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: border, paddingX: 1, marginBottom: 1, width: width, children: [_jsxs(Box, { justifyContent: "space-between", children: [_jsx(Text, { color: border, children: headerTitle }), _jsxs(Text, { color: DIVIDER_COLOR, children: ["phase ", displayPhaseN, "/", total, " \u2022", " ", _jsx(ElapsedTimer, { startedAt: state.startedAt })] })] }), _jsx(Divider, { width: innerWidth, borderColor: border }), _jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: DIVIDER_COLOR, children: "branch " }), _jsx(Text, { children: truncateToWidth(state.branch, innerWidth - 8) })] }), _jsx(PhaseProgression, { phases: state.phases, borderColor: border }), state.currentPhase?.logPath ? (_jsxs(Box, { children: [_jsx(Text, { color: DIVIDER_COLOR, children: "log " }), _jsx(Text, { children: truncateToWidth(state.currentPhase.logPath, innerWidth - 8) })] })) : null] }), _jsx(Divider, { width: innerWidth, borderColor: border }), _jsx(Box, { flexDirection: "column", children: state.currentPhase ? (_jsxs(_Fragment, { children: [_jsxs(Box, { children: [_jsx(Text, { color: DIVIDER_COLOR, children: "now " }), _jsx(Spinner, { color: border }), _jsxs(Text, { children: ["  ", truncateToWidth(state.currentPhase.nowLine, innerWidth - 12)] })] }), _jsx(Box, { children: _jsxs(Text, { color: DIVIDER_COLOR, children: ["        └ last activity ", formatSinceActivity(now, state.currentPhase.lastActivityAt)] }) })] })) : (_jsx(Text, { color: DIVIDER_COLOR, children: statusLine(state) })) })] }));
+}
+function statusLine(state) {
+    switch (state.status) {
+        case "queued":
+            return "queued";
+        case "running":
+            return "working…";
+        case "passed":
+            return "completed";
+        case "failed":
+            return "failed";
+    }
+}
+function Divider({ width, borderColor, }) {
+    const mid = "─".repeat(Math.max(0, width - 2));
+    return (_jsxs(Text, { children: [_jsx(Text, { color: borderColor, children: "\u251C" }), _jsx(Text, { color: DIVIDER_COLOR, children: mid }), _jsx(Text, { color: borderColor, children: "\u2524" })] }));
+}
+function PhaseProgression({ phases, borderColor, }) {
+    return (_jsxs(Box, { flexWrap: "wrap", children: [_jsx(Text, { color: DIVIDER_COLOR, children: "phases " }), phases.map((p, i) => {
+                const isLast = i === phases.length - 1;
+                return (_jsxs(Box, { children: [_jsx(PhaseGlyph, { status: p.status, label: p.name, activeColor: borderColor, elapsedMs: p.elapsedMs }), !isLast ? (_jsxs(Text, { color: DIVIDER_COLOR, children: ["   ", PHASE_GLYPHS.separator, "   "] })) : null] }, `${p.name}-${i}`));
+            })] }));
+}
+function PhaseGlyph({ status, label, activeColor, elapsedMs, }) {
+    if (status === "running") {
+        return (_jsxs(Box, { children: [_jsx(Spinner, { color: activeColor }), _jsxs(Text, { children: [" ", label] })] }));
+    }
+    const glyph = status === "done"
+        ? PHASE_GLYPHS.done
+        : status === "failed"
+            ? PHASE_GLYPHS.failed
+            : PHASE_GLYPHS.pending;
+    const glyphColor = phaseStatusColor(status);
+    return (_jsxs(Box, { children: [_jsx(Text, { color: glyphColor, children: glyph }), _jsxs(Text, { color: DIVIDER_COLOR, children: [" ", label, elapsedMs != null ? ` ${formatShortDuration(elapsedMs)}` : ""] })] }));
+}
+function formatShortDuration(ms) {
+    const secs = Math.max(0, Math.floor(ms / 1000));
+    if (secs < 60)
+        return `${secs.toString().padStart(2, "0")}s`;
+    const mm = Math.floor(secs / 60)
+        .toString()
+        .padStart(2, "0");
+    const ss = (secs % 60).toString().padStart(2, "0");
+    return `${mm}:${ss}`;
+}

package/dist/src/ui/tui/Spinner.d.ts

@@ -0,0 +1,9 @@
+import { type JSX } from "react";
+import { type BorderColor } from "./theme.js";
+/**
+ * Braille spinner. Ticks at 10 Hz in its own component so the parent
+ * issue box is not forced to re-render on each frame.
+ */
+export declare function Spinner({ color }: {
+    color?: BorderColor;
+}): JSX.Element;

package/dist/src/ui/tui/Spinner.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Text } from "ink";
+import { SPINNER_FRAMES } from "./theme.js";
+/**
+ * Braille spinner. Ticks at 10 Hz in its own component so the parent
+ * issue box is not forced to re-render on each frame.
+ */
+export function Spinner({ color }) {
+    const [frame, setFrame] = useState(0);
+    useEffect(() => {
+        const id = setInterval(() => {
+            setFrame((f) => (f + 1) % SPINNER_FRAMES.length);
+        }, 100);
+        return () => clearInterval(id);
+    }, []);
+    return _jsx(Text, { color: color, children: SPINNER_FRAMES[frame] });
+}

package/dist/src/ui/tui/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Experimental multi-issue TUI entry point.
+ *
+ * Mounts an `ink` app that polls `RunOrchestrator.getSnapshot()` at 10 Hz.
+ * Unmounts when the orchestrator reports `done` so the shell returns
+ * cleanly. Only safe to call when `process.stdout.isTTY` is true.
+ */
+import type { RunOrchestrator } from "../../lib/workflow/run-orchestrator.js";
+export interface TuiHandle {
+    /** Promise that resolves when the TUI unmounts. */
+    done: Promise<void>;
+    /** Force-unmount (e.g., on SIGINT fallback). */
+    unmount: () => void;
+}
+export declare function renderTui(orchestrator: RunOrchestrator): TuiHandle;

package/dist/src/ui/tui/index.js

@@ -0,0 +1,29 @@
+/**
+ * Experimental multi-issue TUI entry point.
+ *
+ * Mounts an `ink` app that polls `RunOrchestrator.getSnapshot()` at 10 Hz.
+ * Unmounts when the orchestrator reports `done` so the shell returns
+ * cleanly. Only safe to call when `process.stdout.isTTY` is true.
+ */
+import { createElement } from "react";
+import { render } from "ink";
+import { App } from "./App.js";
+export function renderTui(orchestrator) {
+    let resolveDone;
+    const done = new Promise((resolve) => {
+        resolveDone = resolve;
+    });
+    const instance = render(createElement(App, {
+        getSnapshot: () => orchestrator.getSnapshot(),
+        onDone: () => {
+            instance.unmount();
+        },
+    }), { exitOnCtrlC: false });
+    instance.waitUntilExit().then(() => resolveDone());
+    return {
+        done,
+        unmount: () => {
+            instance.unmount();
+        },
+    };
+}

package/dist/src/ui/tui/theme.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Theme tokens for the experimental multi-issue dashboard TUI.
+ *
+ * Palette rotates by start order (cyan → magenta → blue → yellow); issue
+ * status (failed / passed) overrides the rotation color where applicable.
+ * Respects `NO_COLOR` automatically via `ink`/`chalk`.
+ */
+import type { IssueStatus, PhaseStatus } from "../../lib/workflow/run-state.js";
+/** Border-color palette rotated by issue start order. */
+export declare const BORDER_ROTATION: readonly ["cyan", "magenta", "blue", "yellow"];
+export type BorderColor = (typeof BORDER_ROTATION)[number] | "green" | "red" | "gray";
+/** Gray used for horizontal dividers inside each box. */
+export declare const DIVIDER_COLOR: "gray";
+/**
+ * Pick the border color for an issue.
+ * Failed / passed states win over rotation; otherwise rotate by slot.
+ */
+export declare function borderColorForIssue(status: IssueStatus, slot: number): BorderColor;
+/** Glyphs for the phase progression row. */
+export declare const PHASE_GLYPHS: {
+    readonly pending: "○";
+    readonly done: "✓";
+    readonly failed: "✗";
+    readonly separator: "▸";
+};
+/** Braille spinner frames — 10 Hz rotation looks smooth at ~100ms tick. */
+export declare const SPINNER_FRAMES: readonly ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+/** Color for a phase glyph based on its status. Active phase uses border color. */
+export declare function phaseStatusColor(status: PhaseStatus): BorderColor;

package/dist/src/ui/tui/theme.js

@@ -0,0 +1,52 @@
+/**
+ * Theme tokens for the experimental multi-issue dashboard TUI.
+ *
+ * Palette rotates by start order (cyan → magenta → blue → yellow); issue
+ * status (failed / passed) overrides the rotation color where applicable.
+ * Respects `NO_COLOR` automatically via `ink`/`chalk`.
+ */
+/** Border-color palette rotated by issue start order. */
+export const BORDER_ROTATION = ["cyan", "magenta", "blue", "yellow"];
+/** Gray used for horizontal dividers inside each box. */
+export const DIVIDER_COLOR = "gray";
+/**
+ * Pick the border color for an issue.
+ * Failed / passed states win over rotation; otherwise rotate by slot.
+ */
+export function borderColorForIssue(status, slot) {
+    if (status === "failed")
+        return "red";
+    if (status === "passed")
+        return "green";
+    const idx = ((slot % BORDER_ROTATION.length) + BORDER_ROTATION.length) %
+        BORDER_ROTATION.length;
+    return BORDER_ROTATION[idx];
+}
+/** Glyphs for the phase progression row. */
+export const PHASE_GLYPHS = {
+    pending: "○",
+    done: "✓",
+    failed: "✗",
+    separator: "▸",
+};
+/** Braille spinner frames — 10 Hz rotation looks smooth at ~100ms tick. */
+export const SPINNER_FRAMES = [
+    "⠋",
+    "⠙",
+    "⠹",
+    "⠸",
+    "⠼",
+    "⠴",
+    "⠦",
+    "⠧",
+    "⠇",
+    "⠏",
+];
+/** Color for a phase glyph based on its status. Active phase uses border color. */
+export function phaseStatusColor(status) {
+    if (status === "done")
+        return "green";
+    if (status === "failed")
+        return "red";
+    return "gray";
+}

package/dist/src/ui/tui/truncate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Display-width-aware truncation for terminal output.
+ *
+ * Uses `string-width` so wide glyphs (CJK, emoji) and ANSI escapes are
+ * counted correctly. Cheaper than ink's own truncation in hot paths.
+ */
+/**
+ * Truncate `text` so its visible width does not exceed `max` columns.
+ * If truncation happens, appends a single `…` (which itself counts as 1 col).
+ */
+export declare function truncateToWidth(text: string, max: number): string;

package/dist/src/ui/tui/truncate.js

@@ -0,0 +1,31 @@
+/**
+ * Display-width-aware truncation for terminal output.
+ *
+ * Uses `string-width` so wide glyphs (CJK, emoji) and ANSI escapes are
+ * counted correctly. Cheaper than ink's own truncation in hot paths.
+ */
+import stringWidth from "string-width";
+/**
+ * Truncate `text` so its visible width does not exceed `max` columns.
+ * If truncation happens, appends a single `…` (which itself counts as 1 col).
+ */
+export function truncateToWidth(text, max) {
+    if (max <= 0)
+        return "";
+    const width = stringWidth(text);
+    if (width <= max)
+        return text;
+    if (max === 1)
+        return "…";
+    let acc = "";
+    let accWidth = 0;
+    const budget = max - 1; // reserve one column for the ellipsis
+    for (const ch of text) {
+        const w = stringWidth(ch);
+        if (accWidth + w > budget)
+            break;
+        acc += ch;
+        accWidth += w;
+    }
+    return `${acc}…`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sequant",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Quantize your development workflow - Sequential AI phases with quality gates",
   "type": "module",
   "bin": {
@@ -27,6 +27,7 @@
     "lint": "eslint src/ bin/ --max-warnings 0",
     "sync:skills": "cp -r templates/skills/* .claude/skills/",
     "validate:skills": "for skill in templates/skills/*/; do npx skills-ref validate \"$skill\"; done",
+    "lint:skill-calls": "npx tsx scripts/lint-skill-calls.ts",
     "prepare:marketplace": "npx tsx scripts/prepare-marketplace.ts",
     "validate:marketplace": "npx tsx scripts/prepare-marketplace.ts --validate-only",
     "prepublishOnly": "npm run build"
@@ -76,19 +77,23 @@
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.11",
-    "@hono/node-server": "^1.19.9",
+    "@hono/node-server": "^2.0.0",
     "boxen": "^8.0.1",
     "chalk": "^5.3.0",
     "chokidar": "^5.0.0",
     "cli-table3": "^0.6.5",
     "commander": "^14.0.3",
-    "diff": "^8.0.3",
+    "diff": "^9.0.0",
     "gradient-string": "^3.0.0",
     "hono": "^4.12.1",
+    "ink": "^7.0.1",
     "inquirer": "^13.3.0",
+    "log-update": "^7.0.1",
     "open": "^11.0.0",
     "ora": "^9.3.0",
     "p-limit": "^7.3.0",
+    "react": "^19.2.5",
+    "string-width": "^8.2.0",
     "yaml": "^2.7.0",
     "zod": "^4.3.5"
   },
@@ -97,10 +102,12 @@
     "@types/gradient-string": "^1.1.6",
     "@types/inquirer": "^9.0.7",
     "@types/node": "^25.4.0",
+    "@types/react": "^19.2.14",
     "@typescript-eslint/eslint-plugin": "^8.58.0",
     "@typescript-eslint/parser": "^8.58.0",
     "eslint": "^10.1.0",
     "globals": "^17.0.0",
+    "ink-testing-library": "^4.0.0",
     "tsx": "^4.19.2",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.58.0",

package/templates/agents/sequant-explorer.md

@@ -1,6 +1,7 @@
 ---
 name: sequant-explorer
 description: Codebase exploration agent for sequant /spec phase. Searches for existing patterns, components, database schemas, and file structures. Use when gathering context before planning a feature implementation.
+# Note: per anthropics/claude-code#43869 this is currently a no-op; agent runs on parent's model
 model: haiku
 maxTurns: 15
 tools:

package/templates/agents/sequant-qa-checker.md

@@ -1,7 +1,8 @@
 ---
 name: sequant-qa-checker
 description: Quality check agent for sequant /qa phase. Runs type safety, scope/size, security, and documentation checks on diffs. Use when spawned by the /qa skill to perform parallel or sequential quality checks.
-model: haiku
+# Note: per anthropics/claude-code#43869 this is currently a no-op; agent runs on parent's model
+model: sonnet
 permissionMode: bypassPermissions
 effort: low
 maxTurns: 15

package/templates/agents/sequant-testgen.md

@@ -1,6 +1,7 @@
 ---
 name: sequant-testgen
 description: Test stub generator for sequant /testgen phase. Parses verification criteria from /spec comments and generates Jest/Vitest test stubs with Given/When/Then structure. Use when spawned by the /testgen skill.
+# Note: per anthropics/claude-code#43869 this is currently a no-op; agent runs on parent's model
 model: haiku
 maxTurns: 25
 tools:

package/templates/hooks/post-tool.sh

@@ -13,6 +13,17 @@ if [[ "${CLAUDE_HOOKS_DISABLED:-}" == "true" ]]; then
     exit 0
 fi
 
+# === RELAY CHECK (#383) ===
+# Sourced only when SEQUANT_RELAY=true. The check itself is a single env-var
+# comparison when relay is disabled (default), so non-relay runs incur no cost.
+if [[ "${SEQUANT_RELAY:-}" == "true" ]]; then
+    _RELAY_CHECK="$(dirname "${BASH_SOURCE[0]:-$0}")/relay-check.sh"
+    if [[ -f "${_RELAY_CHECK}" ]]; then
+        # shellcheck source=relay-check.sh disable=SC1091
+        source "${_RELAY_CHECK}" || true
+    fi
+fi
+
 # === READ INPUT FROM STDIN ===
 # Claude Code passes tool data as JSON via stdin, not environment variables
 INPUT_JSON=$(cat)

package/templates/hooks/pre-tool.sh

@@ -104,20 +104,23 @@ if echo "$TOOL_INPUT" | grep -qE '^(env|printenv|export)$'; then
 fi
 
 # Destructive system commands
-if echo "$TOOL_INPUT" | grep -qE 'sudo|rm -rf /|rm -rf ~|rm -rf \$HOME'; then
+# Skip for gh issue/pr commands — body text may legitimately reference these tokens (#570)
+if ! echo "$TOOL_INPUT" | grep -qE '^gh (issue|pr) ' && echo "$TOOL_INPUT" | grep -qE 'sudo|rm -rf /|rm -rf ~|rm -rf \$HOME'; then
     echo "HOOK_BLOCKED: Destructive system command" | tee -a "$HOOK_LOG" >&2
     exit 2
 fi
 
 # Deployment (should never happen in issue automation)
-if echo "$TOOL_INPUT" | grep -qE 'vercel (deploy|--prod)|terraform (apply|destroy)|kubectl (apply|delete)'; then
+# Skip for gh issue/pr commands — body text may legitimately reference these tokens (#570)
+if ! echo "$TOOL_INPUT" | grep -qE '^gh (issue|pr) ' && echo "$TOOL_INPUT" | grep -qE 'vercel (deploy|--prod)|terraform (apply|destroy)|kubectl (apply|delete)'; then
     echo "HOOK_BLOCKED: Deployment command" | tee -a "$HOOK_LOG" >&2
     exit 2
 fi
 
 # Force push
 # Pattern requires -f to be a standalone flag (not part of branch name like -fix)
-if echo "$TOOL_INPUT" | grep -qE 'git push.*(--force| -f($| ))'; then
+# Skip for gh issue/pr commands — body text may legitimately reference these tokens (#564)
+if ! echo "$TOOL_INPUT" | grep -qE '^gh (issue|pr) ' && echo "$TOOL_INPUT" | grep -qE 'git push.*(--force| -f($| ))'; then
     echo "HOOK_BLOCKED: Force push" | tee -a "$HOOK_LOG" >&2
     exit 2
 fi
@@ -127,7 +130,8 @@ fi
 # - Unpushed commits on main/master
 # - Uncommitted changes (staged or unstaged)
 # - Unfinished merge in progress
-if echo "$TOOL_INPUT" | grep -qE 'git reset.*(--hard|origin)'; then
+# Skip for gh issue/pr commands — body text may legitimately reference these tokens (#570)
+if ! echo "$TOOL_INPUT" | grep -qE '^gh (issue|pr) ' && echo "$TOOL_INPUT" | grep -qE 'git reset.*(--hard|origin)'; then
     CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "")
     BLOCK_REASONS=""
     
@@ -167,7 +171,8 @@ if echo "$TOOL_INPUT" | grep -qE 'git reset.*(--hard|origin)'; then
 fi
 
 # CI/CD triggers (automation shouldn't trigger more automation)
-if echo "$TOOL_INPUT" | grep -qE 'gh workflow run'; then
+# Skip for gh issue/pr commands — body text may legitimately reference these tokens (#570)
+if ! echo "$TOOL_INPUT" | grep -qE '^gh (issue|pr) ' && echo "$TOOL_INPUT" | grep -qE 'gh workflow run'; then
     echo "HOOK_BLOCKED: Workflow trigger" | tee -a "$HOOK_LOG" >&2
     exit 2
 fi
@@ -225,7 +230,8 @@ check_sensitive_files() {
 
 if [[ "${CLAUDE_HOOKS_SECURITY:-true}" != "false" ]]; then
     # Security checks for git commit
-    if [[ "$TOOL_NAME" == "Bash" ]] && echo "$TOOL_INPUT" | grep -qE 'git commit'; then
+    # Skip for gh issue/pr commands — body text may legitimately reference these tokens (#564)
+    if [[ "$TOOL_NAME" == "Bash" ]] && ! echo "$TOOL_INPUT" | grep -qE '^gh (issue|pr) ' && echo "$TOOL_INPUT" | grep -qE 'git commit'; then
         # Skip security checks if --no-verify is used
         if ! echo "$TOOL_INPUT" | grep -qE -- '--no-verify'; then
             # Check staged files for secrets
@@ -257,7 +263,8 @@ fi
 # --- No-Changes Guard (AC-7) ---
 # Block commits when there are no staged or unstaged changes (prevents empty commits)
 # Skips for --amend since amending doesn't require new changes
-if [[ "$TOOL_NAME" == "Bash" ]] && echo "$TOOL_INPUT" | grep -qE 'git commit'; then
+# Skip for gh issue/pr commands — body text may legitimately reference these tokens (#564)
+if [[ "$TOOL_NAME" == "Bash" ]] && ! echo "$TOOL_INPUT" | grep -qE '^gh (issue|pr) ' && echo "$TOOL_INPUT" | grep -qE 'git commit'; then
     if ! echo "$TOOL_INPUT" | grep -qE -- '--amend|--allow-empty'; then
         # Extract target directory from cd command if present (for worktree commits)
         # Handles: "cd /path && git commit" or "cd /path; git commit"
@@ -284,7 +291,8 @@ fi
 # Warn (but don't block) when committing outside a feature worktree
 # This catches accidental commits to main repo during feature work
 QUALITY_LOG="${_LOG_DIR}/claude-quality.log"
-if [[ "$TOOL_NAME" == "Bash" ]] && echo "$TOOL_INPUT" | grep -qE 'git commit'; then
+# Skip for gh issue/pr commands — body text may legitimately reference these tokens (#564)
+if [[ "$TOOL_NAME" == "Bash" ]] && ! echo "$TOOL_INPUT" | grep -qE '^gh (issue|pr) ' && echo "$TOOL_INPUT" | grep -qE 'git commit'; then
     CWD=$(pwd)
     if ! echo "$CWD" | grep -qE 'worktrees/feature/'; then
         echo "$(date +%H:%M:%S) WORKTREE_WARNING: Committing outside feature worktree ($CWD)" >> "$QUALITY_LOG"
@@ -295,7 +303,8 @@ fi
 # --- Commit Message Validation (AC-3) ---
 # Enforce conventional commits format: type(scope): description
 # Types: feat|fix|docs|style|refactor|test|chore|ci|build|perf
-if [[ "$TOOL_NAME" == "Bash" ]] && echo "$TOOL_INPUT" | grep -qE 'git commit'; then
+# Skip for gh issue/pr commands — body text may legitimately reference these tokens (#564)
+if [[ "$TOOL_NAME" == "Bash" ]] && ! echo "$TOOL_INPUT" | grep -qE '^gh (issue|pr) ' && echo "$TOOL_INPUT" | grep -qE 'git commit'; then
     # Extract message from -m flag
     MSG=""
 

package/templates/hooks/relay-check.sh

@@ -0,0 +1,107 @@
+#!/bin/bash
+# Relay check (#383): sourced from post-tool.sh on every PostToolUse when
+# SEQUANT_RELAY=true. Reads unread user messages from inbox.jsonl, renders the
+# framing prompt to stdout (which Claude Code surfaces as additional context),
+# and advances the per-issue read cursor.
+#
+# Fast path (no pending messages): exits silently in well under 5 ms.
+# Slow path (messages pending): renders one framing block per invocation.
+
+# Opt-in guard. Fast path #1: env var unset / not exactly "true".
+# Bash precedence makes `cmd1 && cmd2 || cmd3` equivalent to `(cmd1 && cmd2) || cmd3`,
+# so we must use an explicit `if` block to avoid falling through to `exit 0`
+# when the test is FALSE (which is the relay-enabled case).
+if [[ "${SEQUANT_RELAY:-}" != "true" ]]; then
+    return 0 2>/dev/null || exit 0
+fi
+
+# Resolve relay directory. Inside an isolated worktree, the phase-executor sets
+# SEQUANT_WORKTREE. During the spec phase (main repo) we fall back to the
+# per-issue layout under .sequant/relay/<issue>/.
+if [[ -n "${SEQUANT_WORKTREE:-}" ]]; then
+  _RELAY_DIR="${SEQUANT_WORKTREE}/.sequant/relay"
+elif [[ -n "${SEQUANT_ISSUE:-}" ]]; then
+  _RELAY_DIR="${PWD}/.sequant/relay/${SEQUANT_ISSUE}"
+else
+  # Nothing to do without a target issue or worktree.
+  return 0 2>/dev/null || exit 0
+fi
+
+_INBOX="${_RELAY_DIR}/inbox.jsonl"
+_CURSOR="${_RELAY_DIR}/.cursor"
+
+# Fast path #2: AC-8 — `test -s` is sub-millisecond. Empty/missing inbox skips.
+[[ -s "${_INBOX}" ]] || return 0 2>/dev/null || exit 0
+
+# Cursor read (missing → 0). Compare against current inbox line count.
+_CURSOR_VAL=0
+if [[ -f "${_CURSOR}" ]]; then
+  _CURSOR_VAL=$(cat "${_CURSOR}" 2>/dev/null || echo 0)
+  [[ "${_CURSOR_VAL}" =~ ^[0-9]+$ ]] || _CURSOR_VAL=0
+fi
+
+_INBOX_LINES=$(wc -l < "${_INBOX}" 2>/dev/null || echo 0)
+_INBOX_LINES=${_INBOX_LINES// /} # trim whitespace from wc output on macOS
+
+# Fast path #3: cursor caught up.
+if [[ "${_INBOX_LINES}" -le "${_CURSOR_VAL}" ]]; then
+  return 0 2>/dev/null || exit 0
+fi
+
+# Slow path: render frame.
+
+# Resolve frame template. Phase-executor sets SEQUANT_RELAY_FRAME to the
+# absolute path within the sequant installation. Falls back to ./templates/
+# (when running from the sequant repo itself).
+_FRAME_PATH="${SEQUANT_RELAY_FRAME:-}"
+if [[ -z "${_FRAME_PATH}" || ! -f "${_FRAME_PATH}" ]]; then
+  for _candidate in \
+      "${PWD}/.claude/relay/frame.txt" \
+      "${PWD}/templates/relay/frame.txt"; do
+    if [[ -f "${_candidate}" ]]; then
+      _FRAME_PATH="${_candidate}"
+      break
+    fi
+  done
+fi
+if [[ -z "${_FRAME_PATH}" || ! -f "${_FRAME_PATH}" ]]; then
+  # Missing template — emit a minimal frame so the user still gets through.
+  _FRAME_PATH=""
+fi
+
+# Skip the lines we've already shown the model. `tail -n +N` is 1-indexed.
+_START=$((_CURSOR_VAL + 1))
+
+# Render messages. Sort by timestamp ascending (AC-9). jq handles JSON parsing.
+# Messages are separated by `---` lines; a single message has no separator.
+_render_messages() {
+  if command -v jq &>/dev/null; then
+    tail -n "+${_START}" "${_INBOX}" \
+      | jq -s -r 'sort_by(.timestamp) | map("Type: \(.type)\nMessage: \((.message // "") | tojson)") | join("\n---\n")'
+  else
+    # Fallback without jq: dump raw lines.
+    tail -n "+${_START}" "${_INBOX}"
+  fi
+}
+
+if [[ -n "${_FRAME_PATH}" ]]; then
+  # Split frame template at {{MESSAGES}} placeholder.
+  _PREFIX=$(awk '/\{\{MESSAGES\}\}/ {exit} {print}' "${_FRAME_PATH}")
+  _SUFFIX=$(awk '/\{\{MESSAGES\}\}/ {found=1; next} found {print}' "${_FRAME_PATH}")
+  printf '%s\n' "${_PREFIX}"
+  _render_messages
+  if [[ -n "${_SUFFIX}" ]]; then
+    printf '%s\n' "${_SUFFIX}"
+  fi
+else
+  printf '[SEQUANT RELAY — message from user]\n'
+  _render_messages
+fi
+
+# Advance cursor atomically (temp + rename on same fs).
+_TMP="${_CURSOR}.tmp.$$"
+if printf '%s' "${_INBOX_LINES}" > "${_TMP}" 2>/dev/null; then
+  mv -f "${_TMP}" "${_CURSOR}" 2>/dev/null || rm -f "${_TMP}" 2>/dev/null || true
+fi
+
+return 0 2>/dev/null || exit 0

package/templates/relay/frame.txt

@@ -0,0 +1,11 @@
+[SEQUANT RELAY — message from user]
+Respond briefly in .sequant/relay/outbox.jsonl, then continue your current task unchanged.
+Rules:
+- Do NOT modify acceptance criteria
+- Do NOT change your current objective or phase
+- Do NOT treat this as a new requirement
+- For "query" type: provide a brief status update only
+- For "directive" type: acknowledge and adjust approach if reasonable, but do not abandon current work
+- For "abort" type: stop gracefully, commit progress, and exit
+
+{{MESSAGES}}