@imdeadpool/guardex 7.0.21 → 7.0.23

package/src/context.js

@@ -128,8 +128,19 @@ const TEMPLATE_FILES = [
   'vscode/guardex-active-agents/extension.js',
   'vscode/guardex-active-agents/session-schema.js',
   'vscode/guardex-active-agents/README.md',
+  'vscode/guardex-active-agents/icon.png',
 ];
 
+const PACKAGE_ROOT_SOURCE_OVERRIDES = new Set([
+  'scripts/agent-session-state.js',
+  'scripts/install-vscode-active-agents-extension.js',
+  'vscode/guardex-active-agents/package.json',
+  'vscode/guardex-active-agents/extension.js',
+  'vscode/guardex-active-agents/session-schema.js',
+  'vscode/guardex-active-agents/README.md',
+  'vscode/guardex-active-agents/icon.png',
+]);
+
 const LEGACY_WORKFLOW_SHIM_SPECS = [
   { relativePath: 'scripts/agent-branch-start.sh', kind: 'shell', command: ['branch', 'start'] },
   { relativePath: 'scripts/agent-branch-finish.sh', kind: 'shell', command: ['branch', 'finish'] },
@@ -202,6 +213,7 @@ const PACKAGE_SCRIPT_ASSETS = {
   branchMerge: path.join(TEMPLATE_ROOT, 'scripts', 'agent-branch-merge.sh'),
   codexAgent: path.join(TEMPLATE_ROOT, 'scripts', 'codex-agent.sh'),
   reviewBot: path.join(TEMPLATE_ROOT, 'scripts', 'review-bot-watch.sh'),
+  sessionState: path.join(TEMPLATE_ROOT, 'scripts', 'agent-session-state.js'),
   worktreePrune: path.join(TEMPLATE_ROOT, 'scripts', 'agent-worktree-prune.sh'),
   lockTool: path.join(TEMPLATE_ROOT, 'scripts', 'agent-file-locks.py'),
   planInit: path.join(TEMPLATE_ROOT, 'scripts', 'openspec', 'init-plan-workspace.sh'),
@@ -348,8 +360,8 @@ const CLI_COMMAND_DESCRIPTIONS = [
   ['cleanup', 'Prune merged/stale agent branches and worktrees'],
   ['release', 'Create or update the current GitHub release with README-generated notes'],
   ['agents', 'Start/stop repo-scoped review + cleanup bots'],
-  ['prompt', 'Print AI setup checklist (--exec, --snippet)'],
-  ['report', 'Security/safety reports (e.g. OpenSSF scorecard)'],
+  ['prompt', 'Print AI setup checklist or named slices (--exec, --part, --list-parts, --snippet)'],
+  ['report', 'Security/safety reports (e.g. OpenSSF scorecard, session severity)'],
   ['help', 'Show this help output'],
   ['version', 'Print GitGuardex version'],
 ];
@@ -369,6 +381,12 @@ const AGENT_BOT_DESCRIPTIONS = [
 const DOCTOR_AUTO_FINISH_DETAIL_LIMIT = 6;
 const DOCTOR_AUTO_FINISH_BRANCH_LABEL_MAX = 72;
 const DOCTOR_AUTO_FINISH_MESSAGE_MAX = 160;
+const AI_SETUP_PART_ALIASES = new Map([
+  ['task', 'task-loop'],
+  ['loop', 'task-loop'],
+  ['reviewbot', 'review-bot'],
+  ['forksync', 'fork-sync'],
+]);
 
 function envFlagIsTruthy(raw) {
   const lowered = String(raw || '').trim().toLowerCase();
@@ -383,35 +401,177 @@ function defaultAgentWorktreeRelativeDir(env = process.env) {
   return isClaudeCodeSession(env) ? CLAUDE_WORKTREE_RELATIVE_DIR : CODEX_WORKTREE_RELATIVE_DIR;
 }
 
-const AI_SETUP_PROMPT = `GitGuardex (gx) setup checklist for Codex/Claude in this repo.
-
-1) Install:    ${GLOBAL_INSTALL_COMMAND} && gh --version
-2) Bootstrap:  gx setup
-3) Repair:     gx doctor
-4) Task loop:  gx branch start "<task>" "<agent>"
-               then gx locks claim --branch "<agent-branch>" <file...> -> gx branch finish
-5) Integrate:  gx merge --branch <agent-a> --branch <agent-b>
-6) Finish:     gx finish --all
-7) Cleanup:    gx cleanup
-8) OpenSpec:   /opsx:propose -> /opsx:apply -> /opsx:archive
-9) Optional:   gx protect add release staging
-10) Optional:  gx sync --check && gx sync
-11) Review bot: install https://github.com/apps/cr-gpt + set OPENAI_API_KEY
-12) Fork sync:  install https://github.com/apps/pull + cp .github/pull.yml.example .github/pull.yml
-`;
-
-const AI_SETUP_COMMANDS = `${GLOBAL_INSTALL_COMMAND}
-gh --version
-gx setup
-gx doctor
-gx branch start "<task>" "<agent>"
-gx locks claim --branch "<agent-branch>" <file...>
-gx merge --branch "<agent-a>" --branch "<agent-b>"
-gx finish --all
-gx cleanup
-gx protect add release staging
-gx sync --check && gx sync
-`;
+const AI_SETUP_PARTS = [
+  {
+    name: 'install',
+    label: 'Install',
+    promptLines: [`${GLOBAL_INSTALL_COMMAND} && gh --version`],
+    execLines: [GLOBAL_INSTALL_COMMAND, 'gh --version'],
+  },
+  {
+    name: 'bootstrap',
+    label: 'Bootstrap',
+    promptLines: ['gx setup'],
+    execLines: ['gx setup'],
+  },
+  {
+    name: 'repair',
+    label: 'Repair',
+    promptLines: ['gx doctor'],
+    execLines: ['gx doctor'],
+  },
+  {
+    name: 'task-loop',
+    label: 'Task loop',
+    promptLines: [
+      'gx branch start "<task>" "<agent>"',
+      'then gx locks claim --branch "<agent-branch>" <file...> -> inspect once -> patch once -> verify once -> gx branch finish',
+      'batch discovery, git/PR, and CI by phase; avoid repeated peeks or stdin loops',
+    ],
+    execLines: [
+      'gx branch start "<task>" "<agent>"',
+      'gx locks claim --branch "<agent-branch>" <file...>',
+    ],
+  },
+  {
+    name: 'integrate',
+    label: 'Integrate',
+    promptLines: ['gx merge --branch <agent-a> --branch <agent-b>'],
+    execLines: ['gx merge --branch <agent-a> --branch <agent-b>'],
+  },
+  {
+    name: 'finish',
+    label: 'Finish',
+    promptLines: ['gx finish --all'],
+    execLines: ['gx finish --all'],
+  },
+  {
+    name: 'cleanup',
+    label: 'Cleanup',
+    promptLines: ['gx cleanup'],
+    execLines: ['gx cleanup'],
+  },
+  {
+    name: 'openspec',
+    label: 'OpenSpec',
+    promptLines: ['/opsx:propose -> /opsx:apply -> /opsx:archive'],
+  },
+  {
+    name: 'protect',
+    label: 'Protect',
+    promptLines: ['gx protect add release staging'],
+    execLines: ['gx protect add release staging'],
+  },
+  {
+    name: 'sync',
+    label: 'Sync',
+    promptLines: ['gx sync --check && gx sync'],
+    execLines: ['gx sync --check && gx sync'],
+  },
+  {
+    name: 'review-bot',
+    label: 'Review bot',
+    promptLines: ['install https://github.com/apps/cr-gpt + set OPENAI_API_KEY'],
+  },
+  {
+    name: 'fork-sync',
+    label: 'Fork sync',
+    promptLines: ['install https://github.com/apps/pull + cp .github/pull.yml.example .github/pull.yml'],
+  },
+];
+const AI_SETUP_PARTS_BY_NAME = new Map(AI_SETUP_PARTS.map((part) => [part.name, part]));
+const AI_SETUP_EXEC_PART_NAMES = AI_SETUP_PARTS
+  .filter((part) => Array.isArray(part.execLines))
+  .map((part) => part.name);
+
+function normalizeAiSetupPartName(rawName) {
+  const normalized = String(rawName || '')
+    .trim()
+    .toLowerCase()
+    .replace(/_/g, '-');
+  return AI_SETUP_PART_ALIASES.get(normalized) || normalized;
+}
+
+function listAiSetupPartNames(options = {}) {
+  if (!options.execOnly) return AI_SETUP_PARTS.map((part) => part.name);
+  return AI_SETUP_EXEC_PART_NAMES.slice();
+}
+
+function parseAiSetupPartNames(rawValue) {
+  return String(rawValue || '')
+    .split(',')
+    .map((entry) => normalizeAiSetupPartName(entry))
+    .filter(Boolean);
+}
+
+function resolveAiSetupParts(rawPartNames, options = {}) {
+  const exec = Boolean(options.exec);
+  const requestedPartNames = Array.isArray(rawPartNames) ? rawPartNames : [];
+  const availablePartNames = listAiSetupPartNames();
+  const execCapablePartNames = listAiSetupPartNames({ execOnly: true });
+  const seen = new Set();
+  const resolved = [];
+
+  for (const rawName of requestedPartNames) {
+    const name = normalizeAiSetupPartName(rawName);
+    const part = AI_SETUP_PARTS_BY_NAME.get(name);
+    if (!part) {
+      throw new Error(
+        `Unknown prompt part: ${rawName}. Available parts: ${availablePartNames.join(', ')}`,
+      );
+    }
+    if (exec && !Array.isArray(part.execLines)) {
+      throw new Error(
+        `Prompt part '${name}' is not available with --exec. ` +
+        `Exec-capable parts: ${execCapablePartNames.join(', ')}`,
+      );
+    }
+    if (seen.has(name)) continue;
+    seen.add(name);
+    resolved.push(part);
+  }
+
+  return resolved;
+}
+
+function renderFullAiSetupPrompt() {
+  const lines = ['GitGuardex (gx) setup checklist for Codex/Claude in this repo.', ''];
+  const indentWidth = 18;
+
+  AI_SETUP_PARTS.forEach((part, index) => {
+    const [lead, ...tail] = part.promptLines;
+    const prefix = `${index + 1}) ${part.label}:`;
+    lines.push(`${prefix.padEnd(indentWidth)}${lead}`);
+    tail.forEach((line) => lines.push(`${' '.repeat(indentWidth)}${line}`));
+  });
+
+  return `${lines.join('\n')}\n`;
+}
+
+function renderPartialAiSetupPrompt(parts) {
+  return `${parts
+    .map((part) => `${part.label}:\n${part.promptLines.join('\n')}`)
+    .join('\n\n')}\n`;
+}
+
+function renderAiSetupCommands(parts) {
+  return `${parts.flatMap((part) => part.execLines).join('\n')}\n`;
+}
+
+function renderAiSetupPrompt(options = {}) {
+  const exec = Boolean(options.exec);
+  const requestedPartNames = Array.isArray(options.parts) ? options.parts : [];
+  if (requestedPartNames.length === 0) {
+    return exec
+      ? renderAiSetupCommands(resolveAiSetupParts(AI_SETUP_EXEC_PART_NAMES, { exec: true }))
+      : renderFullAiSetupPrompt();
+  }
+  const parts = resolveAiSetupParts(requestedPartNames, { exec });
+  return exec ? renderAiSetupCommands(parts) : renderPartialAiSetupPrompt(parts);
+}
+
+const AI_SETUP_PROMPT = renderAiSetupPrompt();
+const AI_SETUP_COMMANDS = renderAiSetupPrompt({ exec: true });
 
 const SCORECARD_RISK_BY_CHECK = {
   'Dangerous-Workflow': 'Critical',
@@ -472,6 +632,7 @@ module.exports = {
   HOOK_NAMES,
   toDestinationPath,
   TEMPLATE_FILES,
+  PACKAGE_ROOT_SOURCE_OVERRIDES,
   LEGACY_WORKFLOW_SHIM_SPECS,
   LEGACY_WORKFLOW_SHIMS,
   MANAGED_TEMPLATE_DESTINATIONS,
@@ -511,6 +672,9 @@ module.exports = {
   envFlagIsTruthy,
   isClaudeCodeSession,
   defaultAgentWorktreeRelativeDir,
+  listAiSetupPartNames,
+  parseAiSetupPartNames,
+  renderAiSetupPrompt,
   AI_SETUP_PROMPT,
   AI_SETUP_COMMANDS,
   SCORECARD_RISK_BY_CHECK,

package/src/core/stdin.js

@@ -0,0 +1,52 @@
+const fs = require('node:fs');
+const { StringDecoder } = require('node:string_decoder');
+
+const stdinWaitArray = new Int32Array(new SharedArrayBuffer(4));
+
+function sleepSyncMs(milliseconds) {
+  Atomics.wait(stdinWaitArray, 0, 0, milliseconds);
+}
+
+function readSingleLineFromStdin(options = {}) {
+  const fsModule = options.fsModule || fs;
+  const input = options.input || process.stdin;
+  const sleepSync = options.sleepSync || sleepSyncMs;
+  const retryDelayMs = options.retryDelayMs == null ? 15 : options.retryDelayMs;
+  const buffer = Buffer.alloc(1);
+  const decoder = new StringDecoder('utf8');
+  let text = '';
+
+  while (true) {
+    let bytesRead = 0;
+    try {
+      bytesRead = fsModule.readSync(input.fd, buffer, 0, 1);
+    } catch (error) {
+      if (error && ['EAGAIN', 'EWOULDBLOCK', 'EINTR'].includes(error.code)) {
+        sleepSync(retryDelayMs);
+        continue;
+      }
+      return text + decoder.end();
+    }
+
+    if (bytesRead === 0) {
+      if (input.isTTY) {
+        sleepSync(retryDelayMs);
+        continue;
+      }
+      return text + decoder.end();
+    }
+
+    const char = decoder.write(buffer.subarray(0, bytesRead));
+    if (!char) {
+      continue;
+    }
+    if (char === '\n' || char === '\r') {
+      return text;
+    }
+    text += char;
+  }
+}
+
+module.exports = {
+  readSingleLineFromStdin,
+};

package/src/core/versions.js

@@ -0,0 +1,33 @@
+const semver = require('semver');
+
+function parseVersionString(version) {
+  const trimmed = String(version || '').trim();
+  if (!trimmed) {
+    return null;
+  }
+  return semver.valid(trimmed) || null;
+}
+
+function compareParsedVersions(left, right) {
+  if (!left || !right) {
+    return 0;
+  }
+  return semver.compare(left, right);
+}
+
+function isNewerVersion(latest, current) {
+  const latestParts = parseVersionString(latest);
+  const currentParts = parseVersionString(current);
+
+  if (!latestParts || !currentParts) {
+    return String(latest || '').trim() !== String(current || '').trim();
+  }
+
+  return semver.gt(latestParts, currentParts);
+}
+
+module.exports = {
+  parseVersionString,
+  compareParsedVersions,
+  isNewerVersion,
+};