@logicseek/hello-cc 0.1.5 → 0.1.7

package/lib/integrations/shims/script.mjs

@@ -0,0 +1,384 @@
+export function generateShim(hccBin, realBin, tool) {
+  if (tool.resumeFlag) {
+    // Claude: --resume/--continue/--session-id/--fork-session aware wrapper.
+    return `#!/usr/bin/env bash
+# hello-cc shim for ${tool.name} (auto-generated; do not edit manually)
+# Wraps ${tool.name} with hello-cc peer mesh integration.
+# Real binary: ${realBin}
+
+set -e
+REAL_BIN="${realBin}"
+HCC_BIN="${hccBin}"
+
+if [ "\${HCC_SHIM_ENSURED:-}" != "1" ]; then
+  set +e
+  "$HCC_BIN" shim ensure "${tool.name}" "$0" >/dev/null 2>&1
+  ENSURE_STATUS=$?
+  set -e
+  if [ "$ENSURE_STATUS" = "75" ]; then
+    export HCC_SHIM_ENSURED=1
+    exec "$0" "$@"
+  fi
+fi
+
+should_passthrough() {
+  for arg in "$@"; do
+    case "$arg" in
+      -h|--help|-v|--version|-p|--print|--bare|--safe-mode)
+        return 0
+        ;;
+    esac
+  done
+
+  case "\${1:-}" in
+    agents|auth|auto-mode|doctor|install|mcp|plugin|plugins|project|setup-token|ultrareview|update|upgrade)
+      return 0
+      ;;
+  esac
+
+  return 1
+}
+
+if should_passthrough "$@"; then
+  exec "$REAL_BIN" "$@"
+fi
+
+# Use the current directory as the hello-cc project root unless HCC_ROOT is set.
+HCC_ROOT=$("$HCC_BIN" find-root 2>/dev/null || true)
+
+if [ -z "$HCC_ROOT" ]; then
+  exec "$REAL_BIN" "$@"
+fi
+
+sanitize_peer_part() {
+  printf '%s' "$1" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9._-]/-/g; s/^-*//; s/-*$//' | cut -c 1-32
+}
+
+tty_peer_part() {
+  TTY_NUM=$(tty 2>/dev/null | tr -dc '0-9' | tail -c 4)
+  PARENT_PID="\${PPID:-$$}"
+  if [ -n "$TTY_NUM" ]; then
+    printf '%s-%s' "$TTY_NUM" "$PARENT_PID"
+  else
+    printf '%s' "$PARENT_PID"
+  fi
+}
+
+RESUME_ID=""
+SESSION_ID=""
+SESSION_NAME=""
+IS_CONTINUE=0
+IS_FORK=0
+PREV_ARG=""
+for arg in "$@"; do
+  case "$PREV_ARG" in
+    --resume|-r) RESUME_ID="$arg" ;;
+    --session-id) SESSION_ID="$arg" ;;
+    --name|-n) SESSION_NAME="$arg" ;;
+  esac
+  case "$arg" in
+    --resume=*) RESUME_ID="\${arg#--resume=}" ;;
+    --session-id=*) SESSION_ID="\${arg#--session-id=}" ;;
+    --name=*) SESSION_NAME="\${arg#--name=}" ;;
+    --continue|-c) IS_CONTINUE=1 ;;
+    --fork-session) IS_FORK=1 ;;
+  esac
+  PREV_ARG="$arg"
+done
+
+if [ -n "$HCC_PEER" ]; then
+  PEER_ID="$HCC_PEER"
+elif [ -n "$SESSION_ID" ]; then
+  PEER_ID="${tool.kind}-\$(sanitize_peer_part "\${SESSION_ID:0:8}")"
+elif [ -n "$RESUME_ID" ] && [ "$IS_FORK" != "1" ]; then
+  PEER_ID="${tool.kind}-\$(sanitize_peer_part "\${RESUME_ID:0:8}")"
+elif [ -n "$CLAUDE_CODE_SESSION_ID" ]; then
+  PEER_ID="${tool.kind}-\$(sanitize_peer_part "\${CLAUDE_CODE_SESSION_ID:0:8}")"
+elif [ -n "$SESSION_NAME" ] && [ "$IS_FORK" != "1" ] && [ "$IS_CONTINUE" != "1" ]; then
+  PEER_ID="${tool.kind}-\$(sanitize_peer_part "$SESSION_NAME")"
+else
+  PEER_ID="${tool.kind}-\$(tty_peer_part)"
+fi
+
+export HCC_PEER="$PEER_ID"
+export HCC_ROOT
+
+current_tmux_pane() {
+  if [ -n "\${TMUX_PANE:-}" ]; then
+    printf '%s\\n' "$TMUX_PANE"
+    return 0
+  fi
+  TTY_PATH=$(tty 2>/dev/null || true)
+  if [ -z "$TTY_PATH" ] || [ "$TTY_PATH" = "not a tty" ]; then
+    return 1
+  fi
+  tmux list-panes -a -F '#{pane_id} #{pane_tty}' 2>/dev/null | awk -v tty="$TTY_PATH" '$2 == tty { print $1; found = 1; exit } END { exit found ? 0 : 1 }'
+}
+
+CURRENT_HCC_PANE=""
+CURRENT_HCC_SESSION=""
+detect_current_hcc_pane() {
+  CURRENT_HCC_SESSION=""
+  CURRENT_HCC_PANE=$(current_tmux_pane || true)
+  if [ -z "$CURRENT_HCC_PANE" ]; then
+    return 1
+  fi
+  CURRENT_HCC_SESSION=$(tmux display-message -p -t "$CURRENT_HCC_PANE" '#S' 2>/dev/null || true)
+  case "$CURRENT_HCC_SESSION" in
+    hcc-*-*) return 0 ;;
+  esac
+  CURRENT_HCC_PANE=""
+  CURRENT_HCC_SESSION=""
+  return 1
+}
+
+if detect_current_hcc_pane; then
+  SESSION_PEER_ID=$(printf '%s' "$CURRENT_HCC_SESSION" | sed 's/^hcc-[^-]*-//')
+  if [ -n "$SESSION_PEER_ID" ] && [ "$SESSION_PEER_ID" != "$CURRENT_HCC_SESSION" ]; then
+    PEER_ID="$SESSION_PEER_ID"
+  fi
+  export HCC_PEER="$PEER_ID"
+  "$HCC_BIN" web >/dev/null 2>&1 || true
+  "$HCC_BIN" peer attach "$PEER_ID" --kind "${tool.kind}" --pane "$CURRENT_HCC_PANE" --cwd "$PWD" --force >/dev/null 2>&1 || true
+  exec "$REAL_BIN" "$@"
+fi
+
+set +e
+# Wrap in shell so pane_pid stays as bash; Ctrl+C drops back to bash
+START_OUT=$("$HCC_BIN" web >/dev/null 2>&1 || true; "$HCC_BIN" peer start "$PEER_ID" --kind "${tool.kind}" --restart-env -- bash -lc 'REAL_BIN="$1"; shift; hcc_provider_state() { HCC_TMUX_SESSION=$(tmux display-message -p "#S" 2>/dev/null || true); if [ -n "$HCC_TMUX_SESSION" ]; then tmux set-environment -t "$HCC_TMUX_SESSION" HCC_PROVIDER_STATE "$1" >/dev/null 2>&1 || true; fi; }; hcc_provider_state running; "$REAL_BIN" "$@"; hcc_provider_state exited; exec bash' _ "$REAL_BIN" "$@" 2>&1)
+START_STATUS=$?
+set -e
+if [ "$START_STATUS" -ne 0 ]; then
+  printf '%s\\n' "$START_OUT" >&2
+  exit "$START_STATUS"
+fi
+
+PANE=$(printf '%s\\n' "$START_OUT" | sed -n 's/.*pane=\\(%[0-9][0-9]*\\).*/\\1/p' | tail -n 1)
+if [ -z "$PANE" ]; then
+  printf '%s\\n' "$START_OUT"
+  exit 0
+fi
+
+if [ "$HCC_SHIM_NO_ATTACH" = "1" ] || [ ! -t 0 ]; then
+  printf '%s\\n' "$START_OUT"
+  exit 0
+fi
+
+SESSION=$(tmux display-message -p -t "$PANE" '#S' 2>/dev/null || true)
+if [ -z "$SESSION" ]; then
+  printf '%s\\n' "$START_OUT"
+  exit 0
+fi
+
+if [ -n "$TMUX" ]; then
+  exec tmux switch-client -t "$SESSION"
+fi
+
+exec tmux attach-session -t "$SESSION"
+`;
+  }
+
+  // Codex: resume/fork subcommand aware wrapper.
+  return `#!/usr/bin/env bash
+# hello-cc shim for ${tool.name} (auto-generated; do not edit manually)
+# Wraps ${tool.name} with hello-cc peer mesh integration.
+# Real binary: ${realBin}
+
+set -e
+REAL_BIN="${realBin}"
+HCC_BIN="${hccBin}"
+
+if [ "\${HCC_SHIM_ENSURED:-}" != "1" ]; then
+  set +e
+  "$HCC_BIN" shim ensure "${tool.name}" "$0" >/dev/null 2>&1
+  ENSURE_STATUS=$?
+  set -e
+  if [ "$ENSURE_STATUS" = "75" ]; then
+    export HCC_SHIM_ENSURED=1
+    exec "$0" "$@"
+  fi
+fi
+
+first_non_option() {
+  EXPECT_VALUE=0
+  for arg in "$@"; do
+    if [ "$EXPECT_VALUE" = "1" ]; then
+      EXPECT_VALUE=0
+      continue
+    fi
+
+    case "$arg" in
+      --)
+        EXPECT_VALUE=0
+        continue
+        ;;
+      -c|--config|-i|--image|-m|--model|-p|--profile|-s|--sandbox|-C|--cd|--add-dir|-a|--ask-for-approval|--remote|--remote-auth-token-env)
+        EXPECT_VALUE=1
+        continue
+        ;;
+      --config=*|--image=*|--model=*|--profile=*|--sandbox=*|--cd=*|--add-dir=*|--ask-for-approval=*|--remote=*|--remote-auth-token-env=*)
+        continue
+        ;;
+      --*)
+        continue
+        ;;
+      -*)
+        continue
+        ;;
+      *)
+        printf '%s' "$arg"
+        return 0
+        ;;
+    esac
+  done
+  return 1
+}
+
+should_passthrough() {
+  for arg in "$@"; do
+    case "$arg" in
+      -h|--help|-V|--version)
+        return 0
+        ;;
+    esac
+  done
+
+  SUBCOMMAND=$(first_non_option "$@" || true)
+  case "$SUBCOMMAND" in
+    help|exec|e|review|login|logout|mcp|plugin|mcp-server|app-server|remote-control|completion|update|doctor|sandbox|debug|apply|a|archive|unarchive|cloud|exec-server|features)
+      return 0
+      ;;
+  esac
+
+  return 1
+}
+
+if should_passthrough "$@"; then
+  exec "$REAL_BIN" "$@"
+fi
+
+HCC_ROOT=$("$HCC_BIN" find-root 2>/dev/null || true)
+
+if [ -z "$HCC_ROOT" ]; then
+  exec "$REAL_BIN" "$@"
+fi
+
+sanitize_peer_part() {
+  printf '%s' "$1" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9._-]/-/g; s/^-*//; s/-*$//' | cut -c 1-32
+}
+
+tty_peer_part() {
+  TTY_NUM=$(tty 2>/dev/null | tr -dc '0-9' | tail -c 4)
+  PARENT_PID="\${PPID:-$$}"
+  if [ -n "$TTY_NUM" ]; then
+    printf '%s-%s' "$TTY_NUM" "$PARENT_PID"
+  else
+    printf '%s' "$PARENT_PID"
+  fi
+}
+
+SUBCMD=""
+RESUME_ID=""
+EXPECT_SESSION=0
+for arg in "$@"; do
+  if [ -z "$SUBCMD" ]; then
+    if [ "$arg" = "resume" ] || [ "$arg" = "fork" ]; then
+      SUBCMD="$arg"
+      EXPECT_SESSION=1
+    fi
+    continue
+  fi
+  if [ "$EXPECT_SESSION" = "1" ]; then
+    case "$arg" in
+      --last) EXPECT_SESSION=0 ;;
+      -*) ;;
+      *) RESUME_ID="$arg"; EXPECT_SESSION=0 ;;
+    esac
+  fi
+done
+
+if [ -n "$HCC_PEER" ]; then
+  PEER_ID="$HCC_PEER"
+elif [ "$SUBCMD" = "resume" ] && [ -n "$RESUME_ID" ]; then
+  PEER_ID="${tool.kind}-\$(sanitize_peer_part "\${RESUME_ID:0:8}")"
+else
+  PEER_ID="${tool.kind}-\$(tty_peer_part)"
+fi
+
+export HCC_PEER="$PEER_ID"
+export HCC_ROOT
+
+current_tmux_pane() {
+  if [ -n "\${TMUX_PANE:-}" ]; then
+    printf '%s\\n' "$TMUX_PANE"
+    return 0
+  fi
+  TTY_PATH=$(tty 2>/dev/null || true)
+  if [ -z "$TTY_PATH" ] || [ "$TTY_PATH" = "not a tty" ]; then
+    return 1
+  fi
+  tmux list-panes -a -F '#{pane_id} #{pane_tty}' 2>/dev/null | awk -v tty="$TTY_PATH" '$2 == tty { print $1; found = 1; exit } END { exit found ? 0 : 1 }'
+}
+
+CURRENT_HCC_PANE=""
+CURRENT_HCC_SESSION=""
+detect_current_hcc_pane() {
+  CURRENT_HCC_SESSION=""
+  CURRENT_HCC_PANE=$(current_tmux_pane || true)
+  if [ -z "$CURRENT_HCC_PANE" ]; then
+    return 1
+  fi
+  CURRENT_HCC_SESSION=$(tmux display-message -p -t "$CURRENT_HCC_PANE" '#S' 2>/dev/null || true)
+  case "$CURRENT_HCC_SESSION" in
+    hcc-*-*) return 0 ;;
+  esac
+  CURRENT_HCC_PANE=""
+  CURRENT_HCC_SESSION=""
+  return 1
+}
+
+if detect_current_hcc_pane; then
+  SESSION_PEER_ID=$(printf '%s' "$CURRENT_HCC_SESSION" | sed 's/^hcc-[^-]*-//')
+  if [ -n "$SESSION_PEER_ID" ] && [ "$SESSION_PEER_ID" != "$CURRENT_HCC_SESSION" ]; then
+    PEER_ID="$SESSION_PEER_ID"
+  fi
+  export HCC_PEER="$PEER_ID"
+  "$HCC_BIN" web >/dev/null 2>&1 || true
+  "$HCC_BIN" peer attach "$PEER_ID" --kind "${tool.kind}" --pane "$CURRENT_HCC_PANE" --cwd "$PWD" --force >/dev/null 2>&1 || true
+  exec "$REAL_BIN" "$@"
+fi
+
+set +e
+# Wrap in shell so pane_pid stays as bash; Ctrl+C drops back to bash
+START_OUT=$("$HCC_BIN" web >/dev/null 2>&1 || true; "$HCC_BIN" peer start "$PEER_ID" --kind "${tool.kind}" --restart-env -- bash -lc 'REAL_BIN="$1"; shift; hcc_provider_state() { HCC_TMUX_SESSION=$(tmux display-message -p "#S" 2>/dev/null || true); if [ -n "$HCC_TMUX_SESSION" ]; then tmux set-environment -t "$HCC_TMUX_SESSION" HCC_PROVIDER_STATE "$1" >/dev/null 2>&1 || true; fi; }; hcc_provider_state running; "$REAL_BIN" "$@"; hcc_provider_state exited; exec bash' _ "$REAL_BIN" "$@" 2>&1)
+START_STATUS=$?
+set -e
+if [ "$START_STATUS" -ne 0 ]; then
+  printf '%s\\n' "$START_OUT" >&2
+  exit "$START_STATUS"
+fi
+
+PANE=$(printf '%s\\n' "$START_OUT" | sed -n 's/.*pane=\\(%[0-9][0-9]*\\).*/\\1/p' | tail -n 1)
+if [ -z "$PANE" ]; then
+  printf '%s\\n' "$START_OUT"
+  exit 0
+fi
+
+if [ "$HCC_SHIM_NO_ATTACH" = "1" ] || [ ! -t 0 ]; then
+  printf '%s\\n' "$START_OUT"
+  exit 0
+fi
+
+SESSION=$(tmux display-message -p -t "$PANE" '#S' 2>/dev/null || true)
+if [ -z "$SESSION" ]; then
+  printf '%s\\n' "$START_OUT"
+  exit 0
+fi
+
+if [ -n "$TMUX" ]; then
+  exec tmux switch-client -t "$SESSION"
+fi
+
+exec tmux attach-session -t "$SESSION"
+`;
+}

package/lib/integrations/shims.mjs

@@ -0,0 +1,106 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { spawnSync } from 'node:child_process';
+import { generateShim } from './shims/script.mjs';
+
+export const SHIM_DIR = path.join(os.homedir(), '.hcc-shims');
+
+/**
+ * Install shim scripts for `claude` and `codex` into SHIM_DIR.
+ * Returns { shimDir, installed: [paths], changed: [paths], skipped: [names] }.
+ */
+export function installShims(hccBin) {
+  fs.mkdirSync(SHIM_DIR, { recursive: true });
+
+  const tools = [
+    { name: 'claude', kind: 'claude', resumeFlag: '--resume' },
+    { name: 'codex',  kind: 'codex',  resumeSubcmd: 'resume' },
+  ];
+
+  const installed = [];
+  const changed = [];
+  const skipped = [];
+
+  for (const tool of tools) {
+    const realBin = findRealBinary(tool.name);
+    if (!realBin) {
+      skipped.push(`${tool.name} (not found on PATH)`);
+      continue;
+    }
+    const shimPath = path.join(SHIM_DIR, tool.name);
+    const content = generateShim(hccBin, realBin, tool);
+    let previous = null;
+    try { previous = fs.readFileSync(shimPath, 'utf8'); } catch {}
+    if (previous !== content) {
+      fs.writeFileSync(shimPath, content, { mode: 0o755 });
+      changed.push(shimPath);
+    } else {
+      try { fs.chmodSync(shimPath, 0o755); } catch {}
+    }
+    installed.push(shimPath);
+  }
+
+  return { shimDir: SHIM_DIR, installed, changed, skipped };
+}
+
+/**
+ * Remove shim scripts.
+ */
+export function uninstallShims() {
+  const removed = [];
+  for (const name of ['claude', 'codex']) {
+    const p = path.join(SHIM_DIR, name);
+    try { fs.unlinkSync(p); removed.push(p); } catch {}
+  }
+  try { fs.rmdirSync(SHIM_DIR); } catch {}
+  return removed;
+}
+
+/**
+ * Returns true if at least one shim is installed and in an HCC shim dir.
+ */
+export function verifyShims() {
+  return ['claude', 'codex'].some(name =>
+    fsExists(path.join(SHIM_DIR, name))
+  );
+}
+
+/**
+ * Find the real binary for `name`, skipping the SHIM_DIR.
+ * Checks PATH, then npm global bin, then common install locations.
+ */
+export function findRealBinary(name) {
+  // which -a lists all matches; pick first one outside SHIM_DIR
+  const r = spawnSync('which', ['-a', name], { encoding: 'utf8', timeout: 3000 });
+  if (r.status === 0) {
+    for (const p of r.stdout.trim().split('\n')) {
+      const resolved = p.trim();
+      if (resolved && !resolved.startsWith(SHIM_DIR)) return resolved;
+    }
+  }
+
+  // Try npm global bin
+  const npmR = spawnSync('npm', ['root', '-g'], { encoding: 'utf8', timeout: 3000 });
+  if (npmR.status === 0) {
+    const npmBin = path.join(path.dirname(npmR.stdout.trim()), 'bin', name);
+    if (fsExists(npmBin)) return npmBin;
+  }
+
+  // Common locations
+  for (const dir of [
+    '/usr/local/bin',
+    '/usr/bin',
+    path.join(os.homedir(), '.local', 'bin'),
+    path.join(os.homedir(), '.nvm', 'current', 'bin'),
+  ]) {
+    const p = path.join(dir, name);
+    if (fsExists(p)) return p;
+  }
+
+  return null;
+}
+
+function fsExists(p) {
+  try { fs.accessSync(p); return true; } catch { return false; }
+}

package/lib/json-file.mjs

@@ -1,14 +1 @@
-import fs from 'node:fs';
-import path from 'node:path';
-
-export function readJsonSafe(filePath) {
-  try { return JSON.parse(fs.readFileSync(filePath, 'utf8')); }
-  catch { return null; }
-}
-
-export function writeJsonSafe(filePath, data) {
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  const tmpPath = filePath + '.tmp.' + process.pid;
-  fs.writeFileSync(tmpPath, JSON.stringify(data, null, 2) + '\n');
-  fs.renameSync(tmpPath, filePath);
-}
+export { readJsonSafe, writeJsonSafe } from './shared/json-file.mjs';

package/lib/locks.mjs

@@ -0,0 +1,10 @@
+export {
+  WHOLE_LOCK_SCOPE,
+  lockArgv,
+  lockBaseResource,
+  lockLabel,
+  lockScope,
+  locksConflict,
+  normalizeLockScope,
+  scopedLockResource
+} from './core/coordination/locks.mjs';

package/lib/messages.mjs

@@ -0,0 +1,3 @@
+export {
+  createMessageStore
+} from './core/coordination/messages.mjs';

package/lib/package-meta.mjs

@@ -1,24 +1,6 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-export function packageRoot(fromUrl = import.meta.url) {
-  return path.resolve(fileURLToPath(fromUrl), '..', '..');
-}
-
-export function readJson(file) {
-  return JSON.parse(fs.readFileSync(file, 'utf8'));
-}
-
-export function readPackageJson(root) {
-  return readJson(path.join(root, 'package.json'));
-}
-
-export function readPackageMeta(root) {
-  const pkg = readPackageJson(root);
-  return {
-    name: pkg.name,
-    version: pkg.version,
-    packageJson: pkg
-  };
-}
+export {
+  packageRoot,
+  readJson,
+  readPackageJson,
+  readPackageMeta
+} from './release/package-meta.mjs';

package/lib/peer-bindings.mjs

@@ -0,0 +1,14 @@
+export {
+  bindingFromDetected,
+  bindingHasProviderSession,
+  bindingHasRuntime,
+  bindingProviderSessionValue,
+  comparePeerBindings,
+  mergePeerBinding,
+  mergeRuntimeBinding,
+  peerBindingRuntimeRank
+} from './core/peers/bindings.mjs';
+
+export {
+  createPeerBindingStore
+} from './db/stores/peers.mjs';

package/lib/peer-format.mjs

@@ -0,0 +1,4 @@
+export {
+  sanitizePeerPart,
+  shortHash
+} from './core/peers/format.mjs';

package/lib/peer-identity.mjs

@@ -0,0 +1,15 @@
+export {
+  autoPeerBasis,
+  autoPeerId,
+  autoPeerKind,
+  autoPeerProviderSession,
+  autoPeerResumeId,
+  autoPeerSessionId,
+  currentPeer,
+  currentTtyName,
+  readAncestorCliInfo,
+  resolveCurrentPeer,
+  resumeIdFromArgs,
+  sanitizePeerPart,
+  shortHash
+} from './integrations/peers/identity.mjs';

package/lib/project-context.mjs

@@ -0,0 +1,6 @@
+export {
+  detectBranch,
+  detectRoot,
+  hasHccRootSync,
+  runGit
+} from './runtime/project-context.mjs';

package/lib/project-registry.mjs

@@ -0,0 +1,7 @@
+export {
+  projectRecord,
+  readProjectRegistry,
+  registerProject,
+  registerProjectActivity,
+  writeProjectRegistry
+} from './runtime/projects.mjs';

package/lib/provider-commands.mjs

@@ -0,0 +1,13 @@
+export {
+  bindingFromRun,
+  buildClaudeCommand,
+  buildCodexCommand,
+  buildPeerCommand,
+  defaultSessionCommand,
+  hasResumeOpts,
+  inferPeerKind,
+  parseClaudeCommandArgs,
+  parseCodexCommandArgs,
+  providerSessionParts,
+  providerSessionPeerId
+} from './integrations/providers.mjs';

package/lib/release/package-meta.mjs

@@ -0,0 +1,31 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+export function packageRoot(fromUrl = import.meta.url) {
+  let dir = path.dirname(fileURLToPath(fromUrl));
+  for (;;) {
+    if (fs.existsSync(path.join(dir, 'package.json'))) return dir;
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return path.resolve(path.dirname(fileURLToPath(fromUrl)), '..', '..');
+}
+
+export function readJson(file) {
+  return JSON.parse(fs.readFileSync(file, 'utf8'));
+}
+
+export function readPackageJson(root) {
+  return readJson(path.join(root, 'package.json'));
+}
+
+export function readPackageMeta(root) {
+  const pkg = readPackageJson(root);
+  return {
+    name: pkg.name,
+    version: pkg.version,
+    packageJson: pkg
+  };
+}

package/lib/release/release-notes.mjs

@@ -0,0 +1,40 @@
+export function normalizeVersion(version) {
+  return String(version || '').replace(/^v/, '');
+}
+
+export function releaseSection(markdown, version) {
+  const lines = markdown.split(/\r?\n/);
+  const heading = `## ${version}`;
+  const start = lines.findIndex((line) => line.trim() === heading);
+  if (start < 0) return null;
+
+  let end = lines.length;
+  for (let i = start + 1; i < lines.length; i += 1) {
+    if (/^##\s+/.test(lines[i])) {
+      end = i;
+      break;
+    }
+  }
+  return lines.slice(start, end).join('\n').trimEnd();
+}
+
+export function validateReleaseSection(section, version) {
+  const problems = [];
+  if (!section) {
+    problems.push(`CHANGELOG.md is missing section ## ${version}`);
+    return problems;
+  }
+  if (!section.includes('### Summary')) problems.push(`## ${version} is missing ### Summary`);
+  if (!section.includes('### Highlights')) problems.push(`## ${version} is missing ### Highlights`);
+  if (section.includes('TODO') || section.includes('TBD')) problems.push(`## ${version} still contains TODO/TBD text`);
+  const bulletCount = (section.match(/^- /gm) || []).length;
+  if (bulletCount < 2) problems.push(`## ${version} should include at least two release-note bullets`);
+  return problems;
+}
+
+export function repoFromPackage(pkg) {
+  const repo = typeof pkg.repository === 'string' ? pkg.repository : pkg.repository?.url;
+  if (!repo) return null;
+  const match = repo.match(/github\.com[:/](.+?\/.+?)(?:\.git)?$/);
+  return match ? match[1] : null;
+}