@overdeck/desktop 0.45.12 → 0.45.15

package/sync-sources/hooks/gh-issue-trailer-hook.js

@@ -0,0 +1,239 @@
+#!/usr/bin/env node
+import { existsSync, mkdtempSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { homedir, tmpdir } from "node:os";
+import { fileURLToPath } from "node:url";
+//#region gh-issue-trailer-hook.ts
+const FLYWHEEL_RUN_ID_PATTERN = /^RUN-\d+$/;
+function shellQuote(value) {
+	return `'${value.replace(/'/g, `'"'"'`)}'`;
+}
+function tokenize(command) {
+	const tokens = [];
+	let text = "";
+	let start = -1;
+	let quote = null;
+	let escape = false;
+	const flush = (end) => {
+		if (start !== -1) tokens.push({
+			text,
+			start,
+			end
+		});
+		text = "";
+		start = -1;
+	};
+	for (let index = 0; index < command.length; index += 1) {
+		const char = command[index];
+		if (start === -1 && !/\s/.test(char)) start = index;
+		if (escape) {
+			text += char;
+			escape = false;
+			continue;
+		}
+		if (quote === "single") {
+			if (char === "'") quote = null;
+			else text += char;
+			continue;
+		}
+		if (quote === "double") {
+			if (char === "\"") quote = null;
+			else if (char === "\\") escape = true;
+			else text += char;
+			continue;
+		}
+		if (/\s/.test(char)) {
+			flush(index);
+			continue;
+		}
+		if (char === "'") {
+			quote = "single";
+			continue;
+		}
+		if (char === "\"") {
+			quote = "double";
+			continue;
+		}
+		if (char === "\\") {
+			escape = true;
+			continue;
+		}
+		text += char;
+	}
+	flush(command.length);
+	return tokens;
+}
+function findGhIssueCreate(tokens) {
+	for (let index = 0; index <= tokens.length - 3; index += 1) if (tokens[index].text === "gh" && tokens[index + 1].text === "issue" && tokens[index + 2].text === "create") return index;
+	return -1;
+}
+function containsFlywheelRunId(body) {
+	return /^Flywheel-Run-Id:/m.test(body);
+}
+function resolveDiscoveredIn(env) {
+	const agentId = env.OVERDECK_AGENT_ID;
+	if (!agentId || basename(agentId) !== agentId) return null;
+	const statePath = join(env.OVERDECK_HOME ?? join(env.HOME ?? homedir(), ".overdeck"), "agents", agentId, "state.json");
+	if (!existsSync(statePath)) return null;
+	try {
+		const parsed = JSON.parse(readFileSync(statePath, "utf-8"));
+		return typeof parsed.issueId === "string" && parsed.issueId.trim() ? parsed.issueId.trim() : null;
+	} catch {
+		return null;
+	}
+}
+function buildTrailer(env) {
+	const runId = env.OVERDECK_FLYWHEEL_RUN_ID?.trim();
+	if (!runId || !FLYWHEEL_RUN_ID_PATTERN.test(runId)) return null;
+	const filedBy = env.OVERDECK_FLYWHEEL_AGENT_ROLE === "flywheel" ? "agent" : "operator";
+	const discoveredIn = resolveDiscoveredIn(env);
+	return `\n\n${[
+		"---",
+		`Flywheel-Run-Id: ${runId}`,
+		`Flywheel-Filed-By: ${filedBy}`,
+		discoveredIn ? `Flywheel-Discovered-In: ${discoveredIn}` : void 0
+	].filter((line) => line !== void 0).join("\n")}\n`;
+}
+function replaceSpan(command, start, end, replacement) {
+	return `${command.slice(0, start)}${replacement}${command.slice(end)}`;
+}
+function findFlag(tokens, ghIndex, flagName) {
+	for (let index = ghIndex + 3; index < tokens.length; index += 1) {
+		const token = tokens[index];
+		if (token.text === flagName) return {
+			flag: token,
+			value: tokens[index + 1],
+			inline: false
+		};
+		if (token.text.startsWith(`${flagName}=`)) return {
+			flag: token,
+			inline: true
+		};
+	}
+	return null;
+}
+function inlineFlagValue(flag) {
+	const equalsOffset = flag.text.indexOf("=");
+	if (equalsOffset === -1) return null;
+	const valueStart = flag.start + equalsOffset + 1;
+	return {
+		value: flag.text.slice(equalsOffset + 1),
+		valueStart,
+		valueEnd: flag.end
+	};
+}
+function appendBodyFlag(command, tokens, ghIndex, trailer) {
+	const bodyFlag = findFlag(tokens, ghIndex, "--body");
+	if (!bodyFlag) return null;
+	const body = bodyFlag.inline ? inlineFlagValue(bodyFlag.flag) : bodyFlag.value;
+	if (!body) return null;
+	const bodyText = "text" in body ? body.text : body.value;
+	if (containsFlywheelRunId(bodyText)) return command;
+	const appended = `${bodyText}${trailer}`;
+	if ("text" in body) return replaceSpan(command, body.start, body.end, shellQuote(appended));
+	return replaceSpan(command, body.valueStart, body.valueEnd, shellQuote(appended));
+}
+function writeTempBodyFile(body) {
+	const path = join(mkdtempSync(join(tmpdir(), "pan-gh-issue-body-")), "body.md");
+	writeFileSync(path, body, "utf-8");
+	return path;
+}
+function appendBodyFileFlag(command, tokens, ghIndex, trailer) {
+	const bodyFileFlag = findFlag(tokens, ghIndex, "--body-file");
+	if (!bodyFileFlag) return null;
+	const pathValue = bodyFileFlag.inline ? inlineFlagValue(bodyFileFlag.flag) : bodyFileFlag.value;
+	if (!pathValue) return null;
+	const pathText = "text" in pathValue ? pathValue.text : pathValue.value;
+	if (pathText === "-") return appendStdinBody(command, tokens[ghIndex].start, trailer);
+	if (!existsSync(pathText)) return null;
+	const body = readFileSync(pathText, "utf-8");
+	if (containsFlywheelRunId(body)) return command;
+	const tempPath = writeTempBodyFile(`${body}${trailer}`);
+	if ("text" in pathValue) return replaceSpan(command, pathValue.start, pathValue.end, shellQuote(tempPath));
+	return replaceSpan(command, pathValue.valueStart, pathValue.valueEnd, shellQuote(tempPath));
+}
+function findPipeBefore(command, beforeIndex) {
+	let quote = null;
+	let escape = false;
+	let pipeIndex = -1;
+	for (let index = 0; index < beforeIndex; index += 1) {
+		const char = command[index];
+		if (escape) {
+			escape = false;
+			continue;
+		}
+		if (quote === "single") {
+			if (char === "'") quote = null;
+			continue;
+		}
+		if (quote === "double") {
+			if (char === "\"") quote = null;
+			else if (char === "\\") escape = true;
+			continue;
+		}
+		if (char === "'") quote = "single";
+		else if (char === "\"") quote = "double";
+		else if (char === "\\") escape = true;
+		else if (char === "|" && command[index + 1] !== "|" && command[index - 1] !== "|") pipeIndex = index;
+	}
+	return pipeIndex;
+}
+function appendHereDoc(command, trailer) {
+	const match = command.match(/(<<-?\s*['"]?([A-Za-z_][A-Za-z0-9_-]*)['"]?[^\n]*\n)([\s\S]*?)(\n\2\s*)$/);
+	if (!match || match.index === void 0) return null;
+	const body = match[3];
+	if (containsFlywheelRunId(body)) return command;
+	const bodyStart = match.index + match[1].length;
+	return replaceSpan(command, bodyStart, bodyStart + body.length, `${body}${trailer}`);
+}
+function appendStdinBody(command, ghStart, trailer) {
+	if (command.includes("Flywheel-Run-Id:")) return command;
+	const hereDoc = appendHereDoc(command, trailer);
+	if (hereDoc) return hereDoc;
+	const pipeIndex = findPipeBefore(command, ghStart);
+	if (pipeIndex === -1) return null;
+	const producer = command.slice(0, pipeIndex).trim();
+	const consumer = command.slice(pipeIndex + 1).trimStart();
+	if (!producer || !consumer) return null;
+	return `{ ${producer}; printf %s ${shellQuote(trailer)}; } | ${consumer}`;
+}
+function buildUpdatedInput(command) {
+	return { hookSpecificOutput: {
+		hookEventName: "PreToolUse",
+		permissionDecisionReason: "Flywheel issue provenance trailers added",
+		updatedInput: { command }
+	} };
+}
+function rewriteGhIssueCreateCommand(command, env = process.env) {
+	const trailer = buildTrailer(env);
+	if (!trailer) return null;
+	const tokens = tokenize(command);
+	const ghIndex = findGhIssueCreate(tokens);
+	if (ghIndex === -1) return null;
+	const bodyCommand = appendBodyFlag(command, tokens, ghIndex, trailer);
+	if (bodyCommand !== null) return bodyCommand === command ? null : bodyCommand;
+	const bodyFileCommand = appendBodyFileFlag(command, tokens, ghIndex, trailer);
+	if (bodyFileCommand !== null) return bodyFileCommand === command ? null : bodyFileCommand;
+	return null;
+}
+function runGhIssueTrailerHook(input, env = process.env) {
+	let event;
+	try {
+		event = JSON.parse(input);
+	} catch {
+		return "{}";
+	}
+	const command = event.tool_name === "Bash" ? event.tool_input?.command : void 0;
+	if (typeof command !== "string") return "{}";
+	const updatedCommand = rewriteGhIssueCreateCommand(command, env);
+	if (!updatedCommand) return "{}";
+	return JSON.stringify(buildUpdatedInput(updatedCommand));
+}
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+	const input = readFileSync(0, "utf-8");
+	process.stdout.write(runGhIssueTrailerHook(input));
+}
+//#endregion
+export { rewriteGhIssueCreateCommand, runGhIssueTrailerHook };
+
+//# sourceMappingURL=gh-issue-trailer-hook.js.map

package/sync-sources/hooks/gh-issue-trailer-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gh-issue-trailer-hook.js","names":[],"sources":["gh-issue-trailer-hook.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { existsSync, mkdtempSync, readFileSync, writeFileSync } from 'node:fs';\nimport { homedir, tmpdir } from 'node:os';\nimport { basename, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\ninterface PreToolUseEvent {\n  tool_name?: string;\n  tool_input?: {\n    command?: string;\n    [key: string]: unknown;\n  };\n}\n\ninterface Token {\n  text: string;\n  start: number;\n  end: number;\n}\n\ntype HookEnv = Record<string, string | undefined>;\n\nconst FLYWHEEL_RUN_ID_PATTERN = /^RUN-\\d+$/;\n\nfunction shellQuote(value: string): string {\n  return `'${value.replace(/'/g, `'\"'\"'`)}'`;\n}\n\nfunction tokenize(command: string): Token[] {\n  const tokens: Token[] = [];\n  let text = '';\n  let start = -1;\n  let quote: 'single' | 'double' | null = null;\n  let escape = false;\n\n  const flush = (end: number): void => {\n    if (start !== -1) tokens.push({ text, start, end });\n    text = '';\n    start = -1;\n  };\n\n  for (let index = 0; index < command.length; index += 1) {\n    const char = command[index];\n    if (start === -1 && !/\\s/.test(char)) start = index;\n\n    if (escape) {\n      text += char;\n      escape = false;\n      continue;\n    }\n\n    if (quote === 'single') {\n      if (char === \"'\") quote = null;\n      else text += char;\n      continue;\n    }\n\n    if (quote === 'double') {\n      if (char === '\"') quote = null;\n      else if (char === '\\\\') escape = true;\n      else text += char;\n      continue;\n    }\n\n    if (/\\s/.test(char)) {\n      flush(index);\n      continue;\n    }\n\n    if (char === \"'\") {\n      quote = 'single';\n      continue;\n    }\n\n    if (char === '\"') {\n      quote = 'double';\n      continue;\n    }\n\n    if (char === '\\\\') {\n      escape = true;\n      continue;\n    }\n\n    text += char;\n  }\n\n  flush(command.length);\n  return tokens;\n}\n\nfunction findGhIssueCreate(tokens: Token[]): number {\n  for (let index = 0; index <= tokens.length - 3; index += 1) {\n    if (tokens[index].text === 'gh' && tokens[index + 1].text === 'issue' && tokens[index + 2].text === 'create') {\n      return index;\n    }\n  }\n  return -1;\n}\n\nfunction containsFlywheelRunId(body: string): boolean {\n  return /^Flywheel-Run-Id:/m.test(body);\n}\n\nfunction resolveDiscoveredIn(env: HookEnv): string | null {\n  const agentId = env.OVERDECK_AGENT_ID;\n  if (!agentId || basename(agentId) !== agentId) return null;\n\n  const overdeckHome = env.OVERDECK_HOME ?? join(env.HOME ?? homedir(), '.overdeck');\n  const statePath = join(overdeckHome, 'agents', agentId, 'state.json');\n  if (!existsSync(statePath)) return null;\n\n  try {\n    const parsed = JSON.parse(readFileSync(statePath, 'utf-8')) as { issueId?: unknown };\n    return typeof parsed.issueId === 'string' && parsed.issueId.trim() ? parsed.issueId.trim() : null;\n  } catch {\n    return null;\n  }\n}\n\nfunction buildTrailer(env: HookEnv): string | null {\n  const runId = env.OVERDECK_FLYWHEEL_RUN_ID?.trim();\n  if (!runId || !FLYWHEEL_RUN_ID_PATTERN.test(runId)) return null;\n\n  const filedBy = env.OVERDECK_FLYWHEEL_AGENT_ROLE === 'flywheel' ? 'agent' : 'operator';\n  const discoveredIn = resolveDiscoveredIn(env);\n  const lines = [\n    '---',\n    `Flywheel-Run-Id: ${runId}`,\n    `Flywheel-Filed-By: ${filedBy}`,\n    discoveredIn ? `Flywheel-Discovered-In: ${discoveredIn}` : undefined,\n  ].filter((line): line is string => line !== undefined);\n  return `\\n\\n${lines.join('\\n')}\\n`;\n}\n\nfunction replaceSpan(command: string, start: number, end: number, replacement: string): string {\n  return `${command.slice(0, start)}${replacement}${command.slice(end)}`;\n}\n\nfunction findFlag(tokens: Token[], ghIndex: number, flagName: '--body' | '--body-file'): { flag: Token; value?: Token; inline: boolean } | null {\n  for (let index = ghIndex + 3; index < tokens.length; index += 1) {\n    const token = tokens[index];\n    if (token.text === flagName) return { flag: token, value: tokens[index + 1], inline: false };\n    if (token.text.startsWith(`${flagName}=`)) return { flag: token, inline: true };\n  }\n  return null;\n}\n\nfunction inlineFlagValue(flag: Token): { value: string; valueStart: number; valueEnd: number } | null {\n  const equalsOffset = flag.text.indexOf('=');\n  if (equalsOffset === -1) return null;\n  const valueStart = flag.start + equalsOffset + 1;\n  return { value: flag.text.slice(equalsOffset + 1), valueStart, valueEnd: flag.end };\n}\n\nfunction appendBodyFlag(command: string, tokens: Token[], ghIndex: number, trailer: string): string | null {\n  const bodyFlag = findFlag(tokens, ghIndex, '--body');\n  if (!bodyFlag) return null;\n\n  const body = bodyFlag.inline ? inlineFlagValue(bodyFlag.flag) : bodyFlag.value;\n  if (!body) return null;\n  const bodyText = 'text' in body ? body.text : body.value;\n  if (containsFlywheelRunId(bodyText)) return command;\n\n  const appended = `${bodyText}${trailer}`;\n  if ('text' in body) return replaceSpan(command, body.start, body.end, shellQuote(appended));\n  return replaceSpan(command, body.valueStart, body.valueEnd, shellQuote(appended));\n}\n\nfunction writeTempBodyFile(body: string): string {\n  const dir = mkdtempSync(join(tmpdir(), 'pan-gh-issue-body-'));\n  const path = join(dir, 'body.md');\n  writeFileSync(path, body, 'utf-8');\n  return path;\n}\n\nfunction appendBodyFileFlag(command: string, tokens: Token[], ghIndex: number, trailer: string): string | null {\n  const bodyFileFlag = findFlag(tokens, ghIndex, '--body-file');\n  if (!bodyFileFlag) return null;\n\n  const pathValue = bodyFileFlag.inline ? inlineFlagValue(bodyFileFlag.flag) : bodyFileFlag.value;\n  if (!pathValue) return null;\n  const pathText = 'text' in pathValue ? pathValue.text : pathValue.value;\n\n  if (pathText === '-') return appendStdinBody(command, tokens[ghIndex].start, trailer);\n  if (!existsSync(pathText)) return null;\n\n  const body = readFileSync(pathText, 'utf-8');\n  if (containsFlywheelRunId(body)) return command;\n\n  const tempPath = writeTempBodyFile(`${body}${trailer}`);\n  if ('text' in pathValue) return replaceSpan(command, pathValue.start, pathValue.end, shellQuote(tempPath));\n  return replaceSpan(command, pathValue.valueStart, pathValue.valueEnd, shellQuote(tempPath));\n}\n\nfunction findPipeBefore(command: string, beforeIndex: number): number {\n  let quote: 'single' | 'double' | null = null;\n  let escape = false;\n  let pipeIndex = -1;\n\n  for (let index = 0; index < beforeIndex; index += 1) {\n    const char = command[index];\n    if (escape) {\n      escape = false;\n      continue;\n    }\n    if (quote === 'single') {\n      if (char === \"'\") quote = null;\n      continue;\n    }\n    if (quote === 'double') {\n      if (char === '\"') quote = null;\n      else if (char === '\\\\') escape = true;\n      continue;\n    }\n    if (char === \"'\") quote = 'single';\n    else if (char === '\"') quote = 'double';\n    else if (char === '\\\\') escape = true;\n    else if (char === '|' && command[index + 1] !== '|' && command[index - 1] !== '|') pipeIndex = index;\n  }\n\n  return pipeIndex;\n}\n\nfunction appendHereDoc(command: string, trailer: string): string | null {\n  const match = command.match(/(<<-?\\s*['\"]?([A-Za-z_][A-Za-z0-9_-]*)['\"]?[^\\n]*\\n)([\\s\\S]*?)(\\n\\2\\s*)$/);\n  if (!match || match.index === undefined) return null;\n  const body = match[3];\n  if (containsFlywheelRunId(body)) return command;\n  const bodyStart = match.index + match[1].length;\n  const bodyEnd = bodyStart + body.length;\n  return replaceSpan(command, bodyStart, bodyEnd, `${body}${trailer}`);\n}\n\nfunction appendStdinBody(command: string, ghStart: number, trailer: string): string | null {\n  if (command.includes('Flywheel-Run-Id:')) return command;\n\n  const hereDoc = appendHereDoc(command, trailer);\n  if (hereDoc) return hereDoc;\n\n  const pipeIndex = findPipeBefore(command, ghStart);\n  if (pipeIndex === -1) return null;\n\n  const producer = command.slice(0, pipeIndex).trim();\n  const consumer = command.slice(pipeIndex + 1).trimStart();\n  if (!producer || !consumer) return null;\n  return `{ ${producer}; printf %s ${shellQuote(trailer)}; } | ${consumer}`;\n}\n\nfunction buildUpdatedInput(command: string): Record<string, unknown> {\n  return {\n    hookSpecificOutput: {\n      hookEventName: 'PreToolUse',\n      permissionDecisionReason: 'Flywheel issue provenance trailers added',\n      updatedInput: { command },\n    },\n  };\n}\n\nexport function rewriteGhIssueCreateCommand(command: string, env: HookEnv = process.env): string | null {\n  const trailer = buildTrailer(env);\n  if (!trailer) return null;\n\n  const tokens = tokenize(command);\n  const ghIndex = findGhIssueCreate(tokens);\n  if (ghIndex === -1) return null;\n\n  const bodyCommand = appendBodyFlag(command, tokens, ghIndex, trailer);\n  if (bodyCommand !== null) return bodyCommand === command ? null : bodyCommand;\n\n  const bodyFileCommand = appendBodyFileFlag(command, tokens, ghIndex, trailer);\n  if (bodyFileCommand !== null) return bodyFileCommand === command ? null : bodyFileCommand;\n\n  return null;\n}\n\nexport function runGhIssueTrailerHook(input: string, env: HookEnv = process.env): string {\n  let event: PreToolUseEvent;\n  try {\n    event = JSON.parse(input) as PreToolUseEvent;\n  } catch {\n    return '{}';\n  }\n\n  const command = event.tool_name === 'Bash' ? event.tool_input?.command : undefined;\n  if (typeof command !== 'string') return '{}';\n\n  const updatedCommand = rewriteGhIssueCreateCommand(command, env);\n  if (!updatedCommand) return '{}';\n  return JSON.stringify(buildUpdatedInput(updatedCommand));\n}\n\nif (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {\n  const input = readFileSync(0, 'utf-8');\n  process.stdout.write(runGhIssueTrailerHook(input));\n}\n"],"mappings":"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"}

package/sync-sources/hooks/gh-issue-trailer-hook.ts

@@ -0,0 +1,296 @@
+#!/usr/bin/env node
+import { existsSync, mkdtempSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir, tmpdir } from 'node:os';
+import { basename, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+interface PreToolUseEvent {
+  tool_name?: string;
+  tool_input?: {
+    command?: string;
+    [key: string]: unknown;
+  };
+}
+
+interface Token {
+  text: string;
+  start: number;
+  end: number;
+}
+
+type HookEnv = Record<string, string | undefined>;
+
+const FLYWHEEL_RUN_ID_PATTERN = /^RUN-\d+$/;
+
+function shellQuote(value: string): string {
+  return `'${value.replace(/'/g, `'"'"'`)}'`;
+}
+
+function tokenize(command: string): Token[] {
+  const tokens: Token[] = [];
+  let text = '';
+  let start = -1;
+  let quote: 'single' | 'double' | null = null;
+  let escape = false;
+
+  const flush = (end: number): void => {
+    if (start !== -1) tokens.push({ text, start, end });
+    text = '';
+    start = -1;
+  };
+
+  for (let index = 0; index < command.length; index += 1) {
+    const char = command[index];
+    if (start === -1 && !/\s/.test(char)) start = index;
+
+    if (escape) {
+      text += char;
+      escape = false;
+      continue;
+    }
+
+    if (quote === 'single') {
+      if (char === "'") quote = null;
+      else text += char;
+      continue;
+    }
+
+    if (quote === 'double') {
+      if (char === '"') quote = null;
+      else if (char === '\\') escape = true;
+      else text += char;
+      continue;
+    }
+
+    if (/\s/.test(char)) {
+      flush(index);
+      continue;
+    }
+
+    if (char === "'") {
+      quote = 'single';
+      continue;
+    }
+
+    if (char === '"') {
+      quote = 'double';
+      continue;
+    }
+
+    if (char === '\\') {
+      escape = true;
+      continue;
+    }
+
+    text += char;
+  }
+
+  flush(command.length);
+  return tokens;
+}
+
+function findGhIssueCreate(tokens: Token[]): number {
+  for (let index = 0; index <= tokens.length - 3; index += 1) {
+    if (tokens[index].text === 'gh' && tokens[index + 1].text === 'issue' && tokens[index + 2].text === 'create') {
+      return index;
+    }
+  }
+  return -1;
+}
+
+function containsFlywheelRunId(body: string): boolean {
+  return /^Flywheel-Run-Id:/m.test(body);
+}
+
+function resolveDiscoveredIn(env: HookEnv): string | null {
+  const agentId = env.OVERDECK_AGENT_ID;
+  if (!agentId || basename(agentId) !== agentId) return null;
+
+  const overdeckHome = env.OVERDECK_HOME ?? join(env.HOME ?? homedir(), '.overdeck');
+  const statePath = join(overdeckHome, 'agents', agentId, 'state.json');
+  if (!existsSync(statePath)) return null;
+
+  try {
+    const parsed = JSON.parse(readFileSync(statePath, 'utf-8')) as { issueId?: unknown };
+    return typeof parsed.issueId === 'string' && parsed.issueId.trim() ? parsed.issueId.trim() : null;
+  } catch {
+    return null;
+  }
+}
+
+function buildTrailer(env: HookEnv): string | null {
+  const runId = env.OVERDECK_FLYWHEEL_RUN_ID?.trim();
+  if (!runId || !FLYWHEEL_RUN_ID_PATTERN.test(runId)) return null;
+
+  const filedBy = env.OVERDECK_FLYWHEEL_AGENT_ROLE === 'flywheel' ? 'agent' : 'operator';
+  const discoveredIn = resolveDiscoveredIn(env);
+  const lines = [
+    '---',
+    `Flywheel-Run-Id: ${runId}`,
+    `Flywheel-Filed-By: ${filedBy}`,
+    discoveredIn ? `Flywheel-Discovered-In: ${discoveredIn}` : undefined,
+  ].filter((line): line is string => line !== undefined);
+  return `\n\n${lines.join('\n')}\n`;
+}
+
+function replaceSpan(command: string, start: number, end: number, replacement: string): string {
+  return `${command.slice(0, start)}${replacement}${command.slice(end)}`;
+}
+
+function findFlag(tokens: Token[], ghIndex: number, flagName: '--body' | '--body-file'): { flag: Token; value?: Token; inline: boolean } | null {
+  for (let index = ghIndex + 3; index < tokens.length; index += 1) {
+    const token = tokens[index];
+    if (token.text === flagName) return { flag: token, value: tokens[index + 1], inline: false };
+    if (token.text.startsWith(`${flagName}=`)) return { flag: token, inline: true };
+  }
+  return null;
+}
+
+function inlineFlagValue(flag: Token): { value: string; valueStart: number; valueEnd: number } | null {
+  const equalsOffset = flag.text.indexOf('=');
+  if (equalsOffset === -1) return null;
+  const valueStart = flag.start + equalsOffset + 1;
+  return { value: flag.text.slice(equalsOffset + 1), valueStart, valueEnd: flag.end };
+}
+
+function appendBodyFlag(command: string, tokens: Token[], ghIndex: number, trailer: string): string | null {
+  const bodyFlag = findFlag(tokens, ghIndex, '--body');
+  if (!bodyFlag) return null;
+
+  const body = bodyFlag.inline ? inlineFlagValue(bodyFlag.flag) : bodyFlag.value;
+  if (!body) return null;
+  const bodyText = 'text' in body ? body.text : body.value;
+  if (containsFlywheelRunId(bodyText)) return command;
+
+  const appended = `${bodyText}${trailer}`;
+  if ('text' in body) return replaceSpan(command, body.start, body.end, shellQuote(appended));
+  return replaceSpan(command, body.valueStart, body.valueEnd, shellQuote(appended));
+}
+
+function writeTempBodyFile(body: string): string {
+  const dir = mkdtempSync(join(tmpdir(), 'pan-gh-issue-body-'));
+  const path = join(dir, 'body.md');
+  writeFileSync(path, body, 'utf-8');
+  return path;
+}
+
+function appendBodyFileFlag(command: string, tokens: Token[], ghIndex: number, trailer: string): string | null {
+  const bodyFileFlag = findFlag(tokens, ghIndex, '--body-file');
+  if (!bodyFileFlag) return null;
+
+  const pathValue = bodyFileFlag.inline ? inlineFlagValue(bodyFileFlag.flag) : bodyFileFlag.value;
+  if (!pathValue) return null;
+  const pathText = 'text' in pathValue ? pathValue.text : pathValue.value;
+
+  if (pathText === '-') return appendStdinBody(command, tokens[ghIndex].start, trailer);
+  if (!existsSync(pathText)) return null;
+
+  const body = readFileSync(pathText, 'utf-8');
+  if (containsFlywheelRunId(body)) return command;
+
+  const tempPath = writeTempBodyFile(`${body}${trailer}`);
+  if ('text' in pathValue) return replaceSpan(command, pathValue.start, pathValue.end, shellQuote(tempPath));
+  return replaceSpan(command, pathValue.valueStart, pathValue.valueEnd, shellQuote(tempPath));
+}
+
+function findPipeBefore(command: string, beforeIndex: number): number {
+  let quote: 'single' | 'double' | null = null;
+  let escape = false;
+  let pipeIndex = -1;
+
+  for (let index = 0; index < beforeIndex; index += 1) {
+    const char = command[index];
+    if (escape) {
+      escape = false;
+      continue;
+    }
+    if (quote === 'single') {
+      if (char === "'") quote = null;
+      continue;
+    }
+    if (quote === 'double') {
+      if (char === '"') quote = null;
+      else if (char === '\\') escape = true;
+      continue;
+    }
+    if (char === "'") quote = 'single';
+    else if (char === '"') quote = 'double';
+    else if (char === '\\') escape = true;
+    else if (char === '|' && command[index + 1] !== '|' && command[index - 1] !== '|') pipeIndex = index;
+  }
+
+  return pipeIndex;
+}
+
+function appendHereDoc(command: string, trailer: string): string | null {
+  const match = command.match(/(<<-?\s*['"]?([A-Za-z_][A-Za-z0-9_-]*)['"]?[^\n]*\n)([\s\S]*?)(\n\2\s*)$/);
+  if (!match || match.index === undefined) return null;
+  const body = match[3];
+  if (containsFlywheelRunId(body)) return command;
+  const bodyStart = match.index + match[1].length;
+  const bodyEnd = bodyStart + body.length;
+  return replaceSpan(command, bodyStart, bodyEnd, `${body}${trailer}`);
+}
+
+function appendStdinBody(command: string, ghStart: number, trailer: string): string | null {
+  if (command.includes('Flywheel-Run-Id:')) return command;
+
+  const hereDoc = appendHereDoc(command, trailer);
+  if (hereDoc) return hereDoc;
+
+  const pipeIndex = findPipeBefore(command, ghStart);
+  if (pipeIndex === -1) return null;
+
+  const producer = command.slice(0, pipeIndex).trim();
+  const consumer = command.slice(pipeIndex + 1).trimStart();
+  if (!producer || !consumer) return null;
+  return `{ ${producer}; printf %s ${shellQuote(trailer)}; } | ${consumer}`;
+}
+
+function buildUpdatedInput(command: string): Record<string, unknown> {
+  return {
+    hookSpecificOutput: {
+      hookEventName: 'PreToolUse',
+      permissionDecisionReason: 'Flywheel issue provenance trailers added',
+      updatedInput: { command },
+    },
+  };
+}
+
+export function rewriteGhIssueCreateCommand(command: string, env: HookEnv = process.env): string | null {
+  const trailer = buildTrailer(env);
+  if (!trailer) return null;
+
+  const tokens = tokenize(command);
+  const ghIndex = findGhIssueCreate(tokens);
+  if (ghIndex === -1) return null;
+
+  const bodyCommand = appendBodyFlag(command, tokens, ghIndex, trailer);
+  if (bodyCommand !== null) return bodyCommand === command ? null : bodyCommand;
+
+  const bodyFileCommand = appendBodyFileFlag(command, tokens, ghIndex, trailer);
+  if (bodyFileCommand !== null) return bodyFileCommand === command ? null : bodyFileCommand;
+
+  return null;
+}
+
+export function runGhIssueTrailerHook(input: string, env: HookEnv = process.env): string {
+  let event: PreToolUseEvent;
+  try {
+    event = JSON.parse(input) as PreToolUseEvent;
+  } catch {
+    return '{}';
+  }
+
+  const command = event.tool_name === 'Bash' ? event.tool_input?.command : undefined;
+  if (typeof command !== 'string') return '{}';
+
+  const updatedCommand = rewriteGhIssueCreateCommand(command, env);
+  if (!updatedCommand) return '{}';
+  return JSON.stringify(buildUpdatedInput(updatedCommand));
+}
+
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+  const input = readFileSync(0, 'utf-8');
+  process.stdout.write(runGhIssueTrailerHook(input));
+}

package/sync-sources/hooks/git-hooks/post-checkout

@@ -0,0 +1,109 @@
+#!/bin/bash
+#
+# Git post-checkout hook to guard main project directories
+# Prevents accidental checkouts away from main in the primary project directory
+#
+# Install: ln -sf /path/to/overdeck/scripts/git-hooks/post-checkout .git/hooks/post-checkout
+# Or: pan projects add /path/to/project (auto-installs hooks)
+#
+# This hook only activates in the MAIN project directory (not worktrees).
+# Worktrees can freely checkout any branch - that's their purpose.
+#
+# Auto-revert behavior:
+# - Agents (OVERDECK_AGENT=1): Always auto-revert (agents should never checkout in main)
+# - Manual (OVERDECK_AUTO_REVERT_CHECKOUT=1): Opt-in auto-revert for humans
+# - Default: Warn only, don't revert
+
+# Get the previous and new HEAD refs
+PREV_HEAD=$1
+NEW_HEAD=$2
+IS_BRANCH_CHECKOUT=$3  # 1 if branch checkout, 0 if file checkout
+
+# Only care about branch checkouts
+if [ "$IS_BRANCH_CHECKOUT" != "1" ]; then
+    exit 0
+fi
+
+# Check if we're in a worktree (worktrees have .git as a file, not directory)
+if [ -f ".git" ]; then
+    # This is a worktree - allow any checkout
+    exit 0
+fi
+
+# Check if .git is a directory (main repo)
+if [ ! -d ".git" ]; then
+    # Not a git repo at all
+    exit 0
+fi
+
+# Get current branch name
+CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)
+
+# If we're on main or master, all good
+if [ "$CURRENT_BRANCH" = "main" ] || [ "$CURRENT_BRANCH" = "master" ]; then
+    exit 0
+fi
+
+# We're in the main project directory and NOT on main - this is bad!
+echo ""
+echo "╔══════════════════════════════════════════════════════════════════════════════╗"
+echo "║  ⚠️  WARNING: Main project directory is not on 'main' branch!               ║"
+echo "╠══════════════════════════════════════════════════════════════════════════════╣"
+echo "║                                                                              ║"
+echo "║  Current branch: $CURRENT_BRANCH"
+echo "║  Location: $(pwd)"
+echo "║                                                                              ║"
+echo "║  The main project directory should ALWAYS stay on 'main'.                   ║"
+echo "║  All feature work should happen in workspaces (git worktrees).              ║"
+echo "║                                                                              ║"
+echo "║  To fix this:                                                               ║"
+echo "║    git checkout main                                                        ║"
+echo "║                                                                              ║"
+echo "║  To work on a feature:                                                      ║"
+echo "║    pan workspace create ISSUE-ID                                            ║"
+echo "║                                                                              ║"
+echo "╚══════════════════════════════════════════════════════════════════════════════╝"
+echo ""
+
+# Auto-revert for agents and planning sessions
+# They should NEVER be checking out in main project
+IS_OVERDECK_SESSION=0
+
+# Check explicit environment variables
+if [ "$OVERDECK_AGENT" = "1" ] || [ -n "$OVERDECK_AGENT_ID" ]; then
+    IS_OVERDECK_SESSION=1
+fi
+
+# Check for planning session
+if [ "$OVERDECK_PLANNING" = "1" ] || [ -n "$OVERDECK_PLANNING_ISSUE" ]; then
+    IS_OVERDECK_SESSION=1
+fi
+
+# Check tmux session name pattern (agent-* or planning-* or specialist-*)
+if [ -n "$TMUX" ]; then
+    TMUX_SESSION=$(tmux display-message -p '#{session_name}' 2>/dev/null || true)
+    case "$TMUX_SESSION" in
+        agent-*|planning-*|specialist-*)
+            IS_OVERDECK_SESSION=1
+            ;;
+    esac
+fi
+
+if [ "$IS_OVERDECK_SESSION" = "1" ]; then
+    echo "🤖 Overdeck session detected - auto-reverting to main branch..."
+    git checkout main --quiet
+    echo "✓ Reverted to main branch. Agents/planning must use workspaces for feature branches."
+    exit 0
+fi
+
+# Check for manual auto-revert environment variable
+if [ "$OVERDECK_AUTO_REVERT_CHECKOUT" = "1" ]; then
+    echo "Auto-reverting to main branch (OVERDECK_AUTO_REVERT_CHECKOUT=1)..."
+    git checkout main --quiet
+    echo "Reverted to main branch."
+    exit 0
+fi
+
+# Return success but with warning - don't block the checkout
+# The warning is enough for humans to notice
+exit 0