@moretea-labs/forge 1.8.0 → 1.8.2

package/scripts/run-skill-hook.ts

@@ -1,244 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Skill Lifecycle Hook Executor
- *
- * Runs lifecycle hooks defined in assets/skill-hooks.json.
- * Hook types:
- * - sync: blocking, failure aborts the operation
- * - advisory: non-blocking, failure is a warning only
- */
-
-import { readFileSync, existsSync } from "fs";
-import { join, dirname } from "path";
-import { fileURLToPath } from "url";
-import { spawn } from "child_process";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const REPO_ROOT = join(__dirname, "..");
-const HOOKS_CONFIG_FILE = join(REPO_ROOT, "assets", "skill-hooks.json");
-
-// ============================================================================
-// Types
-// ============================================================================
-
-export type HookType = "sync" | "advisory";
-
-export interface HookDefinition {
-  type: HookType;
-  description: string;
-  scripts: string[];
-}
-
-export interface HookConfig {
-  events: Record<string, HookDefinition>;
-}
-
-export const VALID_EVENTS = [
-  "pre-init",
-  "post-init",
-  "pre-assemble",
-  "post-assemble",
-  "pre-migrate",
-  "post-migrate",
-  "on-version-change",
-] as const;
-
-export type HookEvent = (typeof VALID_EVENTS)[number];
-
-// ============================================================================
-// Core Functions
-// ============================================================================
-
-/**
- * Load hook configuration from skill-hooks.json.
- */
-export function loadHookConfig(
-  configPath: string = HOOKS_CONFIG_FILE
-): HookConfig {
-  if (!existsSync(configPath)) {
-    throw new Error(`skill-hooks.json not found at ${configPath}`);
-  }
-
-  const raw = readFileSync(configPath, "utf-8");
-  const parsed = JSON.parse(raw) as HookConfig;
-
-  if (!parsed.events || typeof parsed.events !== "object") {
-    throw new Error("skill-hooks.json missing 'events' object");
-  }
-
-  return parsed;
-}
-
-/**
- * Check if an event name is valid.
- */
-export function isValidEvent(event: string): event is HookEvent {
-  return (VALID_EVENTS as readonly string[]).includes(event);
-}
-
-/**
- * Get the hook definition for a specific event.
- */
-export function getHookDefinition(
-  config: HookConfig,
-  event: string
-): HookDefinition | null {
-  if (!isValidEvent(event)) return null;
-  return config.events[event] ?? null;
-}
-
-/**
- * Execute a single hook script.
- * Context is passed via stdin as JSON and SKILL_HOOK_EVENT env var.
- */
-export async function executeHookScript(
-  scriptPath: string,
-  event: string,
-  context: Record<string, unknown> = {}
-): Promise<{ success: boolean; output: string; error: string }> {
-  return new Promise((resolve) => {
-    const absolutePath = scriptPath.startsWith("/")
-      ? scriptPath
-      : join(REPO_ROOT, scriptPath);
-
-    if (!existsSync(absolutePath)) {
-      resolve({
-        success: false,
-        output: "",
-        error: `Hook script not found: ${absolutePath}`,
-      });
-      return;
-    }
-
-    const child = spawn("bash", [absolutePath], {
-      env: {
-        ...process.env,
-        SKILL_HOOK_EVENT: event,
-        SKILL_ROOT: REPO_ROOT,
-      },
-      cwd: REPO_ROOT,
-    });
-
-    const stdoutChunks: string[] = [];
-    const stderrChunks: string[] = [];
-
-    child.stdout.on("data", (data: Buffer) => stdoutChunks.push(data.toString()));
-    child.stderr.on("data", (data: Buffer) => stderrChunks.push(data.toString()));
-
-    // Pass context via stdin
-    child.stdin.write(JSON.stringify(context));
-    child.stdin.end();
-
-    child.on("close", (code) => {
-      resolve({
-        success: code === 0,
-        output: stdoutChunks.join(""),
-        error: stderrChunks.join(""),
-      });
-    });
-
-    child.on("error", (err) => {
-      resolve({
-        success: false,
-        output: "",
-        error: err.message,
-      });
-    });
-  });
-}
-
-/**
- * Run all hooks for a specific event.
- * For sync hooks, failure on any script aborts remaining scripts and returns false.
- * For advisory hooks, failures are logged but execution continues.
- */
-export async function runHooks(
-  event: string,
-  context: Record<string, unknown> = {},
-  configPath?: string
-): Promise<{ success: boolean; results: Array<{ script: string; success: boolean; output: string; error: string }> }> {
-  const config = loadHookConfig(configPath);
-  const hookDef = getHookDefinition(config, event);
-
-  if (!hookDef) {
-    return { success: true, results: [] };
-  }
-
-  // Short-circuit if no scripts configured
-  if (hookDef.scripts.length === 0) {
-    return { success: true, results: [] };
-  }
-
-  const results: Array<{ script: string; success: boolean; output: string; error: string }> = [];
-
-  for (const script of hookDef.scripts) {
-    const result = await executeHookScript(script, event, context);
-    results.push({ script, ...result });
-
-    if (!result.success && hookDef.type === "sync") {
-      console.error(`[hook:${event}] sync hook failed: ${script}`);
-      if (result.error) console.error(`  ${result.error}`);
-      return { success: false, results };
-    }
-
-    if (!result.success && hookDef.type === "advisory") {
-      console.warn(`[hook:${event}] advisory hook warning: ${script}`);
-      if (result.error) console.warn(`  ${result.error}`);
-    }
-  }
-
-  return { success: true, results };
-}
-
-// ============================================================================
-// CLI
-// ============================================================================
-
-if (import.meta.main) {
-  const args = process.argv.slice(2);
-  const event = args[0];
-  const contextIdx = args.indexOf("--context");
-  const contextStr = contextIdx !== -1 ? args[contextIdx + 1] : "{}";
-
-  if (!event) {
-    console.log(`Usage: bun scripts/run-skill-hook.ts <event> [--context '{"key":"value"}']`);
-    console.log(`\nValid events: ${VALID_EVENTS.join(", ")}`);
-    process.exit(1);
-  }
-
-  if (!isValidEvent(event)) {
-    console.error(`Invalid event: ${event}`);
-    console.error(`Valid events: ${VALID_EVENTS.join(", ")}`);
-    process.exit(1);
-  }
-
-  let context: Record<string, unknown> = {};
-  try {
-    context = JSON.parse(contextStr);
-  } catch {
-    console.error("Invalid --context JSON");
-    process.exit(1);
-  }
-
-  try {
-    const result = await runHooks(event, context);
-
-    if (result.results.length === 0) {
-      console.log(`[hook:${event}] No hooks configured`);
-    } else {
-      for (const r of result.results) {
-        const status = r.success ? "OK" : "FAIL";
-        console.log(`[hook:${event}] ${r.script}: ${status}`);
-        if (r.output) console.log(r.output.trimEnd());
-      }
-    }
-
-    if (!result.success) {
-      process.exit(1);
-    }
-  } catch (error) {
-    console.error("Error:", error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-}

package/scripts/stage-runtime-release.ts

@@ -1,44 +0,0 @@
-#!/usr/bin/env bun
-import { realpathSync } from 'fs';
-import { resolve } from 'path';
-import { assertRuntimeReleaseFiles, stageRuntimeRelease, type CandidateRuntimeStageReceiptV1 } from '../src/runtime/root/release-materialize';
-
-function option(args: string[], name: string): string | undefined {
-  const index = args.lastIndexOf(name);
-  return index >= 0 ? args[index + 1] : undefined;
-}
-
-function requiredOption(args: string[], name: string): string {
-  const value = option(args, name)?.trim();
-  if (!value) throw new Error(`RUNTIME_RELEASE_CANDIDATE_OPTION_REQUIRED: ${name}`);
-  return value;
-}
-
-const args = process.argv.slice(2);
-const controllerHome = resolve(requiredOption(args, '--controller-home'));
-const sourceRoot = resolve(requiredOption(args, '--source-root'));
-const expectedHead = requiredOption(args, '--expected-head');
-const sourceRepositoryId = requiredOption(args, '--source-repository-id');
-if (!/^[a-f0-9]{40}$/i.test(expectedHead)) throw new Error('RUNTIME_RELEASE_CANDIDATE_EXPECTED_HEAD_INVALID');
-if (realpathSync(sourceRoot) !== realpathSync(process.cwd())) throw new Error('RUNTIME_RELEASE_CANDIDATE_CWD_MISMATCH');
-
-const staged = stageRuntimeRelease({ controllerHome, sourceRoot, sourceRepositoryId });
-assertRuntimeReleaseFiles(staged);
-if (staged.sourceCommit !== expectedHead) {
-  throw new Error(`RUNTIME_RELEASE_CANDIDATE_SOURCE_MISMATCH: expected ${expectedHead}, got ${staged.sourceCommit}`);
-}
-if (staged.sourceRepositoryId !== sourceRepositoryId) {
-  throw new Error(`RUNTIME_RELEASE_CANDIDATE_SOURCE_REPOSITORY_MISMATCH: expected ${sourceRepositoryId}, got ${staged.sourceRepositoryId ?? 'missing'}`);
-}
-
-const receipt: CandidateRuntimeStageReceiptV1 = {
-  schemaVersion: 1,
-  releasePath: staged.releasePath,
-  manifestPath: staged.manifestPath,
-  releaseId: staged.releaseId,
-  artifactIdentity: staged.artifactIdentity,
-  manifestSha256: staged.manifestSha256,
-  sourceCommit: staged.sourceCommit,
-  sourceRepositoryId,
-};
-process.stdout.write(`${JSON.stringify(receipt)}\n`);

package/scripts/sync-codex-installed-copies.sh

@@ -1,182 +0,0 @@
-#!/bin/bash
-set -euo pipefail
-
-SOURCE_ROOT="${AGENTIC_DEV_SOURCE_ROOT:-}"
-if [[ -z "$SOURCE_ROOT" ]]; then
-  SOURCE_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-fi
-
-CODEX_SKILLS_ROOT_WAS_SET=0
-if [[ -z "${CODEX_SKILLS_ROOT:-}" ]]; then
-  if [[ -z "${HOME:-}" ]]; then
-    echo "[sync-installed] HOME is required when CODEX_SKILLS_ROOT is not set." >&2
-    exit 1
-  fi
-  CODEX_SKILLS_ROOT="$HOME/.codex/skills"
-else
-  CODEX_SKILLS_ROOT_WAS_SET=1
-fi
-
-if [[ -z "${CLAUDE_SKILLS_ROOT:-}" ]]; then
-  if [[ "$CODEX_SKILLS_ROOT_WAS_SET" -eq 0 ]]; then
-    CLAUDE_SKILLS_ROOT="$HOME/.claude/skills"
-  else
-    CLAUDE_SKILLS_ROOT=""
-  fi
-fi
-
-SOURCE_ROOT="${SOURCE_ROOT%/}"
-CODEX_SKILLS_ROOT="${CODEX_SKILLS_ROOT%/}"
-if [[ -n "$CLAUDE_SKILLS_ROOT" ]]; then
-  CLAUDE_SKILLS_ROOT="${CLAUDE_SKILLS_ROOT%/}"
-fi
-LINK_INSTALLED_COPIES="${AGENTIC_DEV_LINK_INSTALLED_COPIES:-}"
-if [[ -z "$LINK_INSTALLED_COPIES" && "$CODEX_SKILLS_ROOT_WAS_SET" -eq 0 ]]; then
-  LINK_INSTALLED_COPIES=1
-fi
-
-if [[ ! -d "$SOURCE_ROOT" ]]; then
-  echo "[sync-installed] Source root not found: $SOURCE_ROOT" >&2
-  exit 1
-fi
-
-common_excludes=(
-  --exclude='.git/'
-  --exclude='_ops/'
-  --exclude='node_modules/'
-  --exclude='.DS_Store'
-  --exclude='evals/benchmark.md'
-  --exclude='.codex/'
-  --exclude='.claude/settings.local.json'
-  --exclude='.claude/.atomic_pending'
-  --exclude='.claude/.session-id'
-  --exclude='.claude/.trace.jsonl'
-  --exclude='.claude/.session-handoff.md'
-  --exclude='.claude/.task-state.json'
-  --exclude='.claude/*.tmp'
-  --exclude='.claude/*.bak'
-  --exclude='.claude/*.bak.*'
-  --exclude='.claude/*.backup-*'
-  --exclude='.ai/harness/checks/latest.json'
-  --exclude='.ai/harness/events.jsonl'
-  --exclude='.ai/harness/archive/'
-  --exclude='.ai/harness/failures/latest.jsonl'
-  --exclude='.ai/harness/session/continuation.md'
-  --exclude='.ai/harness/session/resume.md'
-  --exclude='.ai/harness/architecture/events.jsonl'
-  --exclude='.ai/harness/worktrees/'
-  --exclude='.ai/harness/runs/'
-)
-
-require_rsync_for_copy_mode() {
-  if command -v rsync >/dev/null 2>&1; then
-    return 0
-  fi
-  echo "[sync-installed] unsupported copy-mode: rsync capability is missing." >&2
-  echo "[sync-installed] Install rsync, or rerun with AGENTIC_DEV_LINK_INSTALLED_COPIES=1 on a filesystem that supports symlinks." >&2
-  exit 1
-}
-
-create_symlink_or_explain() {
-  local source="$1"
-  local dest="$2"
-  if ln -s "$source" "$dest"; then
-    return 0
-  fi
-  echo "[sync-installed] unsupported link-mode: symlink capability is unavailable for $dest." >&2
-  echo "[sync-installed] Rerun with AGENTIC_DEV_LINK_INSTALLED_COPIES=0 to use copy-mode; copy-mode requires rsync." >&2
-  exit 1
-}
-
-sync_copy() {
-  local dest="$1"
-  require_rsync_for_copy_mode
-  remove_managed_dest "$dest"
-  mkdir -p "$dest"
-  rsync -a --delete "${common_excludes[@]}" "$SOURCE_ROOT/" "$dest/"
-}
-
-remove_managed_dest() {
-  local dest="$1"
-  if [[ -L "$dest" ]]; then
-    rm "$dest"
-    return 0
-  fi
-
-  if [[ -e "$dest" ]]; then
-    if [[ -d "$dest/_ops" ]]; then
-      echo "[sync-installed] Refusing to replace $dest because it contains _ops/ local state." >&2
-      echo "[sync-installed] Move or archive that directory first, then rerun." >&2
-      exit 1
-    fi
-    rm -rf "$dest"
-  fi
-}
-
-sync_claude_alias_links() {
-  if [[ -z "$CLAUDE_SKILLS_ROOT" ]]; then
-    return 0
-  fi
-
-  mkdir -p "$CLAUDE_SKILLS_ROOT"
-  local alias_dest="$CLAUDE_SKILLS_ROOT/forge"
-  remove_managed_dest "$alias_dest"
-  create_symlink_or_explain "$SOURCE_ROOT" "$alias_dest"
-  echo "[sync-installed] Claude skill alias: $alias_dest -> $SOURCE_ROOT"
-}
-
-sync_claude_alias_copies() {
-  if [[ -z "$CLAUDE_SKILLS_ROOT" ]]; then
-    return 0
-  fi
-
-  mkdir -p "$CLAUDE_SKILLS_ROOT"
-  local alias_dest="$CLAUDE_SKILLS_ROOT/forge"
-  sync_copy "$alias_dest"
-  echo "[sync-installed] Claude skill copy: $alias_dest"
-}
-
-# The host skill surface is intentionally canonical-only. CLI subcommands remain
-# available through the single forge router instead of being installed as
-# separate, overlapping skills. Clean historical managed facade installs so an
-# upgrade does not leave stale skills discoverable.
-legacy_facades=(
-  forge-architecture forge-autoplan forge-capability
-  forge-check forge-deploy forge-goal
-  forge-gptpro forge-gptpro-setup forge-handoff
-  forge-init forge-migrate forge-plan forge-prd
-  forge-repair forge-review forge-scaffold
-  forge-ship forge-sprint forge-upgrade
-  forge-chatgpt-bridge forge-chatgpt-browser
-)
-
-cleanup_legacy_facades() {
-  local root="$1"
-  [[ -n "$root" ]] || return 0
-  local name
-  for name in "${legacy_facades[@]}"; do
-    remove_managed_dest "$root/$name"
-  done
-}
-
-canonical_dest="$CODEX_SKILLS_ROOT/forge"
-if [[ "$LINK_INSTALLED_COPIES" == "1" ]]; then
-  mkdir -p "$CODEX_SKILLS_ROOT"
-  remove_managed_dest "$canonical_dest"
-  create_symlink_or_explain "$SOURCE_ROOT" "$canonical_dest"
-  echo "[sync-installed] canonical skill link: $canonical_dest -> $SOURCE_ROOT"
-
-  cleanup_legacy_facades "$CODEX_SKILLS_ROOT"
-  sync_claude_alias_links
-  cleanup_legacy_facades "$CLAUDE_SKILLS_ROOT"
-  echo "[sync-installed] OK"
-  exit 0
-fi
-
-sync_copy "$canonical_dest"
-echo "[sync-installed] canonical skill copy: $canonical_dest"
-
-cleanup_legacy_facades "$CODEX_SKILLS_ROOT"
-sync_claude_alias_copies
-cleanup_legacy_facades "$CLAUDE_SKILLS_ROOT"
-echo "[sync-installed] OK"

package/src/cli/commands/tools.ts

@@ -1,167 +0,0 @@
-/**
- * `forge tools` — explicit tool lifecycle commands.
- *
- * Host adapter installation remains under `install --target`; tool readiness
- * mutation lives here so detector, installer, and MCP lifecycles stay separate.
- */
-
-import { Command } from 'commander';
-import {
-  configureCodegraph,
-  ensureCodegraph,
-  type CodegraphConfigureLocation,
-  type CodegraphConfigureResult,
-  type CodegraphHostTarget,
-  type CodegraphEnsureResult,
-} from '../tools/codegraph';
-
-interface CodegraphEnsureCliOptions {
-  json?: boolean;
-  check?: boolean;
-  init?: boolean;
-  sync?: boolean;
-  installDeps?: boolean;
-  repo?: string;
-}
-
-interface CodegraphConfigureCliOptions {
-  json?: boolean;
-  target: string;
-  location: string;
-  repo?: string;
-}
-
-export function formatCodegraphEnsure(result: CodegraphEnsureResult, asJson = false, repoRoot?: string): string {
-  if (asJson) {
-    return JSON.stringify(
-      {
-        generated_at: new Date().toISOString(),
-        repo_root: repoRoot,
-        changed: result.changed,
-        read_only: result.readOnly,
-        codegraph: result.raw,
-        actions: result.actions,
-      },
-      null,
-      2,
-    );
-  }
-
-  const lines: string[] = [];
-  lines.push(`CodeGraph: ${result.status} (${result.reason})`);
-  lines.push(`Source: ${result.resolution.source}`);
-  if (result.resolution.version) lines.push(`Version: ${result.resolution.version}`);
-  if (result.resolution.globalFallbackUsed) lines.push('Fallback: global binary used');
-  if (result.actions.length > 0) {
-    lines.push('');
-    lines.push('Actions:');
-    for (const action of result.actions) {
-      lines.push(`  ${action.action}: ${action.status}`);
-    }
-  }
-  return lines.join('\n');
-}
-
-export function formatCodegraphConfigure(result: CodegraphConfigureResult, asJson = false, repoRoot?: string): string {
-  if (asJson) {
-    return JSON.stringify(
-      {
-        generated_at: new Date().toISOString(),
-        repo_root: repoRoot,
-        target: result.target,
-        location: result.location,
-        changed: result.changed,
-        read_only: result.readOnly,
-        codegraph: result.raw,
-        actions: result.actions,
-      },
-      null,
-      2,
-    );
-  }
-
-  const lines: string[] = [];
-  lines.push(`CodeGraph configure: target=${result.target} location=${result.location}`);
-  lines.push(`Source: ${result.resolution.source}`);
-  if (result.resolution.version) lines.push(`Version: ${result.resolution.version}`);
-  if (result.actions.length > 0) {
-    lines.push('');
-    lines.push('Actions:');
-    for (const action of result.actions) {
-      lines.push(`  ${action.action}: ${action.status}`);
-    }
-  }
-  return lines.join('\n');
-}
-
-function parseTarget(value: string): CodegraphHostTarget {
-  if (value === 'codex' || value === 'claude' || value === 'both') return value;
-  throw new Error(`invalid --target "${value}" (expected: codex, claude, both)`);
-}
-
-function parseLocation(value: string): CodegraphConfigureLocation {
-  if (value === 'global' || value === 'local') return value;
-  throw new Error(`invalid --location "${value}" (expected: global, local)`);
-}
-
-export function buildToolsCommand(): Command {
-  const tools = new Command('tools').description('Manage explicit external tool readiness');
-  const ensure = new Command('ensure').description('Ensure a named tool is ready');
-  const configure = new Command('configure').description('Configure a named tool for a host agent');
-
-  ensure
-    .command('codegraph')
-    .description('Check or ensure CodeGraph readiness for the current repo')
-    .option('--json', 'Output JSON instead of human-readable text')
-    .option('--check', 'Read-only readiness check; do not install, init, or sync')
-    .option('--init', 'Initialize the repo index when missing')
-    .option('--sync', 'Sync the repo index')
-    .option('--no-install-deps', 'Do not run bun install when the local binary is missing')
-    .option('--repo <path>', 'Repository root to check or ensure')
-    .action((rawOpts: CodegraphEnsureCliOptions) => {
-      const repoRoot = rawOpts.repo ?? process.cwd();
-      const result = ensureCodegraph({
-        repoRoot,
-        checkOnly: rawOpts.check === true,
-        init: rawOpts.init === true,
-        sync: rawOpts.sync === true,
-        installDeps: rawOpts.installDeps !== false,
-      });
-      console.log(formatCodegraphEnsure(result, rawOpts.json === true, repoRoot));
-      const failed = result.actions.some((entry) => entry.status === 'failed');
-      process.exit(failed ? 1 : 0);
-    });
-
-  configure
-    .command('codegraph')
-    .description('Configure CodeGraph MCP for Codex and/or Claude')
-    .requiredOption('--target <target>', 'Target host: codex|claude|both')
-    .requiredOption('--location <location>', 'Install location: global|local')
-    .option('--json', 'Output JSON instead of human-readable text')
-    .option('--repo <path>', 'Repository root used for local installs and readiness probes')
-    .action((rawOpts: CodegraphConfigureCliOptions) => {
-      let target: CodegraphHostTarget;
-      let location: CodegraphConfigureLocation;
-      try {
-        target = parseTarget(rawOpts.target);
-        location = parseLocation(rawOpts.location);
-      } catch (err) {
-        console.error((err as Error).message);
-        process.exit(2);
-      }
-
-      const repoRoot = rawOpts.repo ?? process.cwd();
-      const result = configureCodegraph({
-        repoRoot,
-        target,
-        location,
-      });
-      console.log(formatCodegraphConfigure(result, rawOpts.json === true, repoRoot));
-      const failed = result.actions.some((entry) => entry.status === 'failed');
-      process.exit(failed ? 1 : 0);
-    });
-
-  tools.addCommand(ensure);
-  tools.addCommand(configure);
-  return tools;
-}