@imdeadpool/guardex 7.0.41 → 7.0.43

package/templates/scripts/agent-session-state.js

@@ -1,171 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-function resolveSessionSchemaModule() {
-  const candidates = [
-    path.resolve(__dirname, '..', 'vscode', 'guardex-active-agents', 'session-schema.js'),
-    path.resolve(__dirname, '..', 'templates', 'vscode', 'guardex-active-agents', 'session-schema.js'),
-  ];
-
-  for (const candidate of candidates) {
-    if (fs.existsSync(candidate)) {
-      return require(candidate);
-    }
-  }
-
-  throw new Error('Could not resolve Guardex active-agent session schema module.');
-}
-
-const sessionSchema = resolveSessionSchemaModule();
-
-function usage() {
-  return (
-    'Usage:\n' +
-    '  node scripts/agent-session-state.js start --repo <path> --branch <name> --task <task> --agent <agent> --worktree <path> --pid <pid> --cli <name> [--task-mode <caveman|omx>] [--openspec-tier <T0|T1|T2|T3>] [--routing-reason <text>] [--state <working|thinking|idle>]\n' +
-    '  node scripts/agent-session-state.js heartbeat --repo <path> --branch <name> [--state <working|thinking|idle>]\n' +
-    '  node scripts/agent-session-state.js terminate --repo <path> --branch <name>\n' +
-    '  node scripts/agent-session-state.js stop --repo <path> --branch <name>\n'
-  );
-}
-
-function parseOptions(argv) {
-  const options = {};
-  for (let index = 0; index < argv.length; index += 1) {
-    const token = argv[index];
-    if (!token.startsWith('--')) {
-      throw new Error(`Unexpected argument: ${token}`);
-    }
-    const key = token.slice(2);
-    const value = argv[index + 1];
-    if (!value || value.startsWith('--')) {
-      throw new Error(`Missing value for --${key}`);
-    }
-    options[key] = value;
-    index += 1;
-  }
-  return options;
-}
-
-function requireOption(options, key) {
-  const value = options[key];
-  if (!value) {
-    throw new Error(`Missing required option --${key}`);
-  }
-  return value;
-}
-
-function writeSessionRecord(options) {
-  const repoRoot = requireOption(options, 'repo');
-  const branch = requireOption(options, 'branch');
-  const record = sessionSchema.buildSessionRecord({
-    repoRoot,
-    branch,
-    taskName: requireOption(options, 'task'),
-    agentName: requireOption(options, 'agent'),
-    worktreePath: requireOption(options, 'worktree'),
-    pid: requireOption(options, 'pid'),
-    cliName: requireOption(options, 'cli'),
-    taskMode: options['task-mode'],
-    openspecTier: options['openspec-tier'],
-    taskRoutingReason: options['routing-reason'],
-    state: options.state,
-  });
-
-  const targetPath = sessionSchema.sessionFilePathForBranch(repoRoot, branch);
-  fs.mkdirSync(path.dirname(targetPath), { recursive: true });
-  fs.writeFileSync(targetPath, `${JSON.stringify(record, null, 2)}\n`, 'utf8');
-}
-
-function refreshSessionRecord(options) {
-  const repoRoot = requireOption(options, 'repo');
-  const branch = requireOption(options, 'branch');
-  const targetPath = sessionSchema.sessionFilePathForBranch(repoRoot, branch);
-  if (!fs.existsSync(targetPath)) {
-    return;
-  }
-
-  const parsed = JSON.parse(fs.readFileSync(targetPath, 'utf8'));
-  const nextRecord = {
-    ...parsed,
-    lastHeartbeatAt: new Date().toISOString(),
-  };
-  if (options.state) {
-    nextRecord.state = options.state;
-  }
-
-  fs.writeFileSync(targetPath, `${JSON.stringify(nextRecord, null, 2)}\n`, 'utf8');
-}
-
-function readSessionRecord(options) {
-  const repoRoot = requireOption(options, 'repo');
-  const branch = requireOption(options, 'branch');
-  const targetPath = sessionSchema.sessionFilePathForBranch(repoRoot, branch);
-  if (!fs.existsSync(targetPath)) {
-    return null;
-  }
-  return JSON.parse(fs.readFileSync(targetPath, 'utf8'));
-}
-
-function terminateSessionProcess(options) {
-  const record = readSessionRecord(options);
-  const pid = Number(record?.pid);
-  if (!Number.isInteger(pid) || pid <= 0) {
-    throw new Error('No live pid recorded for branch.');
-  }
-
-  try {
-    process.kill(pid, 'SIGTERM');
-  } catch (error) {
-    if (error?.code === 'ESRCH') {
-      return;
-    }
-    throw error;
-  }
-}
-
-function removeSessionRecord(options) {
-  const repoRoot = requireOption(options, 'repo');
-  const branch = requireOption(options, 'branch');
-  const targetPath = sessionSchema.sessionFilePathForBranch(repoRoot, branch);
-  if (fs.existsSync(targetPath)) {
-    fs.unlinkSync(targetPath);
-  }
-}
-
-function main() {
-  const [command, ...rest] = process.argv.slice(2);
-  if (!command || ['-h', '--help', 'help'].includes(command)) {
-    process.stdout.write(usage());
-    return;
-  }
-
-  const options = parseOptions(rest);
-  if (command === 'start') {
-    writeSessionRecord(options);
-    return;
-  }
-  if (command === 'heartbeat') {
-    refreshSessionRecord(options);
-    return;
-  }
-  if (command === 'terminate') {
-    terminateSessionProcess(options);
-    return;
-  }
-  if (command === 'stop') {
-    removeSessionRecord(options);
-    return;
-  }
-
-  throw new Error(`Unknown subcommand: ${command}`);
-}
-
-try {
-  main();
-} catch (error) {
-  process.stderr.write(`[guardex-active-session] ${error.message}\n`);
-  process.stderr.write(usage());
-  process.exitCode = 1;
-}

package/templates/scripts/install-vscode-active-agents-extension.js

@@ -1,135 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require('node:fs');
-const os = require('node:os');
-const path = require('node:path');
-
-const PATCH_COMPATIBILITY_WINDOW = 20;
-const RETIRED_EXTENSION_IDS = [
-  'recodeee.gitguardex-active-agents',
-];
-
-function parseOptions(argv) {
-  const options = {};
-  for (let index = 0; index < argv.length; index += 1) {
-    const token = argv[index];
-    if (!token.startsWith('--')) {
-      throw new Error(`Unexpected argument: ${token}`);
-    }
-    const key = token.slice(2);
-    const value = argv[index + 1];
-    if (!value || value.startsWith('--')) {
-      throw new Error(`Missing value for --${key}`);
-    }
-    options[key] = value;
-    index += 1;
-  }
-  return options;
-}
-
-function resolveExtensionSource(repoRoot) {
-  const candidates = [
-    path.join(repoRoot, 'vscode', 'guardex-active-agents'),
-    path.join(repoRoot, 'templates', 'vscode', 'guardex-active-agents'),
-  ];
-
-  for (const candidate of candidates) {
-    if (fs.existsSync(path.join(candidate, 'package.json'))) {
-      return candidate;
-    }
-  }
-
-  throw new Error('Could not find the Guardex VS Code companion sources.');
-}
-
-function removeIfExists(targetPath) {
-  if (fs.existsSync(targetPath)) {
-    fs.rmSync(targetPath, { recursive: true, force: true });
-  }
-}
-
-function parseSimpleSemver(version) {
-  const parts = String(version || '').trim().split('.').map((part) => Number.parseInt(part, 10));
-  if (parts.length !== 3 || parts.some((part) => Number.isNaN(part))) {
-    throw new Error(`Expected simple semver for the Active Agents companion, received "${version}".`);
-  }
-  return parts;
-}
-
-function buildInstallTargets(extensionId, version, extensionsDir) {
-  const [major, minor, patch] = parseSimpleSemver(version);
-  const firstCompatiblePatch = Math.max(0, patch - PATCH_COMPATIBILITY_WINDOW);
-  const targets = [path.join(extensionsDir, extensionId)];
-
-  for (let compatiblePatch = firstCompatiblePatch; compatiblePatch <= patch; compatiblePatch += 1) {
-    targets.push(path.join(extensionsDir, `${extensionId}-${major}.${minor}.${compatiblePatch}`));
-  }
-
-  return targets;
-}
-
-function isRetiredExtensionInstall(entryName, currentExtensionId) {
-  return RETIRED_EXTENSION_IDS
-    .filter((extensionId) => extensionId !== currentExtensionId)
-    .some((extensionId) => entryName === extensionId || entryName.startsWith(`${extensionId}-`));
-}
-
-function main() {
-  const repoRoot = path.resolve(__dirname, '..');
-  const options = parseOptions(process.argv.slice(2));
-  const sourceDir = resolveExtensionSource(repoRoot);
-  const manifest = JSON.parse(fs.readFileSync(path.join(sourceDir, 'package.json'), 'utf8'));
-  const extensionId = `${manifest.publisher}.${manifest.name}`;
-  const extensionsDir = path.resolve(
-    options['extensions-dir'] ||
-      process.env.GUARDEX_VSCODE_EXTENSIONS_DIR ||
-      process.env.VSCODE_EXTENSIONS_DIR ||
-      path.join(os.homedir(), '.vscode', 'extensions'),
-  );
-
-  fs.mkdirSync(extensionsDir, { recursive: true });
-  const targetDirs = buildInstallTargets(extensionId, manifest.version, extensionsDir);
-  const canonicalTargetDir = targetDirs[0];
-  const keepDirNames = new Set(targetDirs.map((targetDir) => path.basename(targetDir)));
-  let retiredInstallCount = 0;
-
-  for (const entry of fs.readdirSync(extensionsDir, { withFileTypes: true })) {
-    if (!entry.isDirectory()) {
-      continue;
-    }
-    if (isRetiredExtensionInstall(entry.name, extensionId)) {
-      removeIfExists(path.join(extensionsDir, entry.name));
-      retiredInstallCount += 1;
-      continue;
-    }
-    if (keepDirNames.has(entry.name)) {
-      continue;
-    }
-    if (entry.name === extensionId || entry.name.startsWith(`${extensionId}-`)) {
-      removeIfExists(path.join(extensionsDir, entry.name));
-    }
-  }
-
-  for (const targetDir of targetDirs) {
-    removeIfExists(targetDir);
-    fs.cpSync(sourceDir, targetDir, {
-      recursive: true,
-      force: true,
-      preserveTimestamps: true,
-    });
-  }
-
-  process.stdout.write(
-    `[guardex-active-agents] Installed ${extensionId}@${manifest.version} to ${canonicalTargetDir}\n` +
-      `[guardex-active-agents] Refreshed ${targetDirs.length - 1} recent patch compatibility path(s) for already-open windows.\n` +
-      `[guardex-active-agents] Removed ${retiredInstallCount} retired extension install path(s).\n` +
-      '[guardex-active-agents] Reload each already-open VS Code window to activate the newest Source Control companion.\n',
-  );
-}
-
-try {
-  main();
-} catch (error) {
-  process.stderr.write(`[guardex-active-agents] ${error.message}\n`);
-  process.exitCode = 1;
-}

package/templates/vscode/guardex-active-agents/README.md

@@ -1,34 +0,0 @@
-# GitGuardex Active Agents
-
-Local VS Code companion for Guardex-managed repos.
-
-## Quick Start
-
-Use the dedicated Active Agents sidebar icon to create or inspect Guardex sandboxes quickly.
-
-1. Install from a Guardex-wired repo:
-
-```sh
-node scripts/install-vscode-active-agents-extension.js
-```
-
-2. Reload the VS Code window.
-3. In the Activity Bar, open the dedicated `Active Agents` hive icon. Use `Start agent` to enter a task + agent name and launch the repo Guardex agent runner. The companion prefers `bash scripts/codex-agent.sh` when present, falls back to `npm run agent:codex --`, and only uses `gx branch start` as a last resort.
-
-What it does:
-
-- Bundles a local GitGuardex icon so repo installs show branded extension metadata inside VS Code.
-- Bundles the optional `GitGuardex File Icons` theme for OpenSpec, agent worktree, and hook files in Explorer.
-- Adds a dedicated `Active Agents` Activity Bar container with a hive icon and live badge count for active sessions.
-- Renders one repo node per live Guardex workspace with grouped `ACTIVE AGENTS` and `CHANGES` sections.
-- Splits live sessions inside `ACTIVE AGENTS` into `BLOCKED`, `WORKING NOW`, `THINKING`, `STALLED`, and `DEAD` groups so stuck, active, and inactive lanes stand out immediately.
-- Mirrors the same live state in the VS Code status bar so the selected session or active-agent count stays visible outside the tree.
-- Keeps the built-in Source Control view focused on real Git repositories; the Active Agents commit command prompts for a message from its own toolbar action.
-- Shows one row per live Guardex sandbox session inside those activity groups, with changed-file rows nested under sessions that are touching files.
-- Labels session rows with provider identity and snapshot context; snapshot-backed rows use a one-letter snapshot badge such as `N` for `nagyviktor@edixa.com`.
-- Shows raw agent branch groups with the `git-branch` icon instead of the generic folder icon.
-- Shows repo-root git changes in a sibling `CHANGES` section when the guarded repo itself is dirty.
-- Derives session state from dirty worktree status, git conflict markers, heartbeat freshness, PID liveness, and recent file mtimes, surfaces working/dead/conflict counts in the repo/header summary, and shows changed-file counts for active edits.
-- Uses distinct VS Code codicons for each session state, including animated `loading~spin` for `WORKING NOW`.
-- Reads repo-local presence files from `.omx/state/active-sessions/`, expects `lastHeartbeatAt` freshness, and falls back to managed worktree-root `AGENT.lock` telemetry when the launcher session file is absent.
-- Publishes `guardex.hasAgents` and `guardex.hasConflicts` context keys for other VS Code contributions.