@moretea-labs/forge 1.8.1 → 1.8.2

package/assets/templates/helpers/check-agent-tooling.sh

@@ -76,20 +76,9 @@ const WAZA_RAW_BASE_URL = "https://raw.githubusercontent.com/tw93/Waza/main";
 const WAZA_MANAGED_SKILLS = ["think", "hunt", "check", "health"];
 const WAZA_SHARED_RULES = ["anti-patterns.md", "chinese.md", "durable-context.md", "english.md"];
 const CODEX_AUTOMATION_SKILLS = ["health", "check", "mermaid"];
-const CODEGRAPH_PACKAGE = "@colbymchenry/codegraph";
-const CODEGRAPH_GLOBAL_INSTALL_COMMAND = `bun add -g ${CODEGRAPH_PACKAGE} && forge tools configure codegraph --target codex --location global`;
 const GBRAIN_INSTALL_COMMAND = "bun install -g github:garrytan/gbrain";
 const GBRAIN_INSTALL_NOTE =
   "Install from GitHub; npm registry package gbrain is an unrelated GPU library and does not ship this CLI.";
-const CODEGRAPH_MCP_CONFIGURE_COMMAND = "forge tools configure codegraph --target <codex|claude|both> --location global";
-const CODEGRAPH_LOCAL_INSTALL_COMMAND = "bun install";
-const CODEGRAPH_ENSURE_COMMAND = [
-  ".ai/harness/scripts/ensure-codegraph.sh",
-  "scripts/ensure-codegraph.sh",
-].find((relPath) => fs.existsSync(path.join(REPO_ROOT, relPath)));
-const CODEGRAPH_ENSURE_BASH_COMMAND = CODEGRAPH_ENSURE_COMMAND
-  ? `bash ${CODEGRAPH_ENSURE_COMMAND}`
-  : null;
 const WAZA_STAGING_ROOT = path.join(HOME, ".agents");
 const WAZA_STAGING_DIR = path.join(WAZA_STAGING_ROOT, "skills");
 const WAZA_STAGING_RULES_DIR = path.join(WAZA_STAGING_ROOT, "rules");
@@ -1070,97 +1059,6 @@ function detectGbrain() {
   };
 }
 
-function detectCodeGraphMcp(host) {
-  const meta = HOSTS[host];
-  const content = readText(meta.configPath);
-  function claudeEntryResult(entry, source) {
-    if (!entry || typeof entry !== "object") return null;
-    if (entry.alwaysLoad === true) {
-      return {
-        status: "configured",
-        always_load: true,
-        tool_search: "always-load",
-        reason: `${source} contains a codegraph MCP server entry with alwaysLoad=true.`,
-      };
-    }
-    return {
-      status: "deferred",
-      always_load: false,
-      tool_search: "deferred",
-      reason: `${source} contains a codegraph MCP server entry, but alwaysLoad is not true; Claude Code MCP Tool Search may defer CodeGraph tools.`,
-    };
-  }
-  function claudeTextFallback(source, sourcePath) {
-    return {
-      status: "deferred",
-      always_load: false,
-      tool_search: "unknown",
-      reason: `${source} contains a codegraph MCP server entry at ${sourcePath}, but alwaysLoad could not be verified.`,
-    };
-  }
-
-  if (!content) {
-    if (host === "claude") {
-      const claudeRootConfig = path.join(HOME, ".claude.json");
-      const rootJson = readJson(claudeRootConfig);
-      const rootEntry = claudeEntryResult(rootJson?.mcpServers?.codegraph, `Claude root config at ${claudeRootConfig}`);
-      if (rootEntry) return rootEntry;
-      const rootContent = readText(claudeRootConfig);
-      if (/codegraph/i.test(rootContent)) {
-        return claudeTextFallback("Claude root config", claudeRootConfig);
-      }
-    }
-
-    return {
-      status: "missing",
-      reason: `No ${meta.label} config found at ${meta.configPath}.`,
-    };
-  }
-
-  if (host === "codex") {
-    if (/\[mcp_servers\.codegraph\]/.test(content)) {
-      return {
-        status: "configured",
-        reason: "Codex config contains a codegraph MCP server entry.",
-      };
-    }
-
-    return {
-      status: "missing",
-      reason: "Codex config does not contain a codegraph MCP server entry.",
-    };
-  }
-
-  const settingsJson = readJson(meta.configPath);
-  const settingsEntry = claudeEntryResult(settingsJson?.mcpServers?.codegraph, `Claude settings at ${meta.configPath}`);
-  if (settingsEntry) return settingsEntry;
-  if (/"mcpServers"\s*:\s*{[\s\S]*"codegraph"/i.test(content)) {
-    return claudeTextFallback("Claude settings", meta.configPath);
-  }
-
-  const claudeRootConfig = path.join(HOME, ".claude.json");
-  const rootJson = readJson(claudeRootConfig);
-  const rootEntry = claudeEntryResult(rootJson?.mcpServers?.codegraph, `Claude root config at ${claudeRootConfig}`);
-  if (rootEntry) return rootEntry;
-  const rootContent = readText(claudeRootConfig);
-  if (/"mcpServers"\s*:\s*{[\s\S]*"codegraph"/i.test(rootContent)) {
-    return claudeTextFallback("Claude root config", claudeRootConfig);
-  }
-
-  return {
-    status: "missing",
-    reason: "Claude config does not contain a codegraph MCP server entry.",
-  };
-}
-
-function parseCodeGraphProjectStatus(output) {
-  if (/Not initialized/i.test(output)) return "not-initialized";
-  if (/Index is up to date/i.test(output)) return "up-to-date";
-  if (/Pending Changes/i.test(output) || /Run "codegraph sync/i.test(output)) return "stale";
-  if (/CodeGraph Status/i.test(output)) return "unknown";
-  return "unavailable";
-}
-
 function resolvePathCommand(command) {
   const pathValue = process.env.PATH || "";
   for (const dir of pathValue.split(path.delimiter)) {
@@ -1171,207 +1069,6 @@ function resolvePathCommand(command) {
   return null;
 }
 
-function codeGraphPackageDeclared() {
-  const pkg = readJson(path.join(REPO_ROOT, "package.json"));
-  if (!pkg || typeof pkg !== "object") return false;
-  return Boolean(
-    pkg.devDependencies?.[CODEGRAPH_PACKAGE] ||
-      pkg.dependencies?.[CODEGRAPH_PACKAGE] ||
-      pkg.optionalDependencies?.[CODEGRAPH_PACKAGE]
-  );
-}
-
-function codeGraphPlatformPackageName() {
-  return `${CODEGRAPH_PACKAGE}-${process.platform}-${process.arch}`;
-}
-
-function codeGraphPlatformBundleBin() {
-  if (process.platform === "win32") return null;
-  return path.join(REPO_ROOT, "node_modules", codeGraphPlatformPackageName(), "bin", "codegraph");
-}
-
-function resolveCodeGraphBinary() {
-  const allowRepoLocal = process.env.AGENTIC_DEV_CODEGRAPH_ALLOW_REPO_LOCAL !== "0";
-  const allowGlobal = process.env.AGENTIC_DEV_CODEGRAPH_ALLOW_GLOBAL !== "0";
-  const localCandidates = [];
-  const localOverride = process.env.AGENTIC_DEV_CODEGRAPH_LOCAL_BIN;
-  const globalOverride = process.env.AGENTIC_DEV_CODEGRAPH_GLOBAL_BIN;
-
-  if (localOverride) localCandidates.push(localOverride);
-  if (allowRepoLocal) {
-    localCandidates.push(codeGraphPlatformBundleBin());
-    localCandidates.push(path.join(REPO_ROOT, "node_modules", ".bin", "codegraph"));
-  }
-
-  let localBinPath = null;
-  for (const candidate of localCandidates) {
-    if (candidate && fileIsExecutable(candidate)) {
-      localBinPath = candidate;
-      break;
-    }
-  }
-
-  let globalBinPath = null;
-  if (allowGlobal) {
-    if (globalOverride && fileIsExecutable(globalOverride)) {
-      globalBinPath = globalOverride;
-    } else if (!globalOverride) {
-      globalBinPath = resolvePathCommand("codegraph");
-    }
-  }
-
-  if (localBinPath) {
-    return {
-      source: "local",
-      bin_path: localBinPath,
-      local_bin_path: localBinPath,
-      global_bin_path: globalBinPath,
-      global_fallback_used: false,
-    };
-  }
-
-  if (globalBinPath) {
-    return {
-      source: "global",
-      bin_path: globalBinPath,
-      local_bin_path: null,
-      global_bin_path: globalBinPath,
-      global_fallback_used: true,
-    };
-  }
-
-  return {
-    source: "missing",
-    bin_path: null,
-    local_bin_path: null,
-    global_bin_path: null,
-    global_fallback_used: false,
-  };
-}
-
-function codeGraphVersion(binPath) {
-  if (!binPath) return null;
-  const result = run(binPath, ["--version"], { timeoutMs: 1000 });
-  if (result.ok) return result.stdout.trim() || null;
-  if (result.timed_out) {
-    const retry = run(binPath, ["--version"], { timeoutMs: 1000 });
-    if (retry.ok) return retry.stdout.trim() || null;
-  }
-  return null;
-}
-
-function detectCodeGraph() {
-  const resolution = resolveCodeGraphBinary();
-  const cliPresent = Boolean(resolution.bin_path);
-  const version = codeGraphVersion(resolution.bin_path);
-  const globalVersion = resolution.global_bin_path && resolution.global_bin_path !== resolution.bin_path
-    ? codeGraphVersion(resolution.global_bin_path)
-    : resolution.source === "global"
-      ? version
-      : null;
-  const localVersion = resolution.source === "local" ? version : null;
-  const packageDeclared = codeGraphPackageDeclared();
-  const mcpHosts = {};
-
-  for (const host of SELECTED_HOSTS) {
-    mcpHosts[host] = {
-      label: HOSTS[host].label,
-      ...detectCodeGraphMcp(host),
-    };
-  }
-
-  const selectedMcpConfigured = SELECTED_HOSTS.every((host) => mcpHosts[host]?.status === "configured");
-  const statusResult = cliPresent ? run(resolution.bin_path, ["status", "."], { timeoutMs: 1500 }) : null;
-  const statusOutput = `${statusResult?.stdout || ""}\n${statusResult?.stderr || ""}`;
-  const projectIndexStatus = cliPresent ? parseCodeGraphProjectStatus(statusOutput) : "unavailable";
-  const indexInitialized = fs.existsSync(path.join(REPO_ROOT, ".codegraph"))
-    || ["up-to-date", "stale", "unknown"].includes(projectIndexStatus);
-  const updateResult = cliPresent && checkUpdates
-    ? run("npm", ["view", CODEGRAPH_PACKAGE, "version", "--json"], { timeoutMs: 3000 })
-    : null;
-  const latestVersion = updateResult?.ok ? (parseJson(updateResult.stdout) || updateResult.stdout.trim().replace(/^"|"$/g, "")) : null;
-  const updateStatus = !checkUpdates
-    ? "not-checked"
-    : latestVersion && version
-      ? (String(latestVersion) === String(version) ? "up-to-date" : "update-available")
-      : "unknown";
-  const localDependencyMissing = packageDeclared && resolution.source === "global";
-  const status = !cliPresent
-    ? "missing"
-    : localDependencyMissing || !selectedMcpConfigured || projectIndexStatus === "not-initialized" || projectIndexStatus === "unavailable"
-      ? "partial"
-      : projectIndexStatus === "stale" || projectIndexStatus === "unknown"
-        ? "warning"
-        : "present";
-
-  return {
-    name: "codegraph",
-    status,
-    reason: !cliPresent
-      ? "CodeGraph CLI is not installed."
-      : localDependencyMissing
-        ? "CodeGraph global fallback is present, but this repo declares a local dev dependency that is not installed."
-      : !selectedMcpConfigured
-        ? "CodeGraph CLI is present, but one or more selected host MCP configs are missing or deferred."
-        : projectIndexStatus === "not-initialized"
-          ? "CodeGraph CLI and MCP are present, but this repo has not been indexed."
-          : projectIndexStatus === "unavailable"
-            ? "CodeGraph CLI and MCP are present, but project index status could not be read."
-          : projectIndexStatus === "stale"
-            ? "CodeGraph is configured, but this repo index has pending changes."
-            : projectIndexStatus === "unknown"
-              ? "CodeGraph is configured, but this repo index status is unknown."
-            : "CodeGraph CLI, selected host MCP config, and project index are ready.",
-    package: CODEGRAPH_PACKAGE,
-    primary_host: "codex",
-    cli_present: cliPresent,
-    source: resolution.source,
-    bin_path: resolution.bin_path,
-    local_bin_path: resolution.local_bin_path,
-    global_bin_path: resolution.global_bin_path,
-    global_fallback_used: resolution.global_fallback_used,
-    version,
-    local_version: localVersion,
-    global_version: globalVersion,
-    dependency_declared: packageDeclared,
-    drift: localVersion && globalVersion && localVersion !== globalVersion
-      ? { local: localVersion, global: globalVersion, using: resolution.source }
-      : null,
-    latest_version: latestVersion,
-    update_status: updateStatus,
-    update_reason: !checkUpdates
-      ? "Update checks were skipped."
-      : updateResult?.timed_out
-        ? "CodeGraph npm version check timed out."
-        : latestVersion && version
-          ? (String(latestVersion) === String(version) ? "Local CodeGraph matches npm latest." : "npm reports a newer CodeGraph version.")
-          : "CodeGraph update status is unknown.",
-    mcp_hosts: mcpHosts,
-    project_index: {
-      status: projectIndexStatus,
-      initialized: indexInitialized,
-      path: path.join(REPO_ROOT, ".codegraph"),
-      command: "codegraph status .",
-    },
-    install_command: packageDeclared ? CODEGRAPH_LOCAL_INSTALL_COMMAND : CODEGRAPH_GLOBAL_INSTALL_COMMAND,
-    ensure_command: packageDeclared ? CODEGRAPH_ENSURE_BASH_COMMAND : null,
-    mcp_install_command: CODEGRAPH_MCP_CONFIGURE_COMMAND,
-    init_command: packageDeclared && CODEGRAPH_ENSURE_BASH_COMMAND ? `${CODEGRAPH_ENSURE_BASH_COMMAND} --init` : "codegraph init -i .",
-    sync_command: packageDeclared && CODEGRAPH_ENSURE_BASH_COMMAND ? `${CODEGRAPH_ENSURE_BASH_COMMAND} --sync` : "codegraph sync .",
-    upgrade_command: packageDeclared && CODEGRAPH_ENSURE_BASH_COMMAND ? `bun update @colbymchenry/codegraph && ${CODEGRAPH_ENSURE_BASH_COMMAND} --sync` : `bun add -g ${CODEGRAPH_PACKAGE}@latest && codegraph sync .`,
-    uninstall_command: "codegraph uninstall --target codex --location global --yes",
-    readiness: {
-      required_for: "codex-agent-code-navigation",
-      hook_policy: "do-not-block-hooks",
-      user_setup: "one-terminal-command-or-authorized-agent-action",
-    },
-    impact: {
-      code_navigation: status === "present" ? "full" : status === "warning" ? "stale-index" : "missing",
-      hook_correctness: "unaffected",
-    },
-  };
-}
-
 const wazaReport = detectWaza();
 const report = {
   generated_at: new Date().toISOString(),
@@ -1384,14 +1081,10 @@ const report = {
     waza: wazaReport,
     codex_automation_profile: detectCodexAutomationProfile(),
     gbrain: detectGbrain(),
-    codegraph: detectCodeGraph(),
   },
 };
 
 const strictFailures = [];
-if (strictReadiness && ["missing", "partial"].includes(report.tools.codegraph.status)) {
-  strictFailures.push(`CodeGraph readiness is ${report.tools.codegraph.status}: ${report.tools.codegraph.reason}`);
-}
 
 function printText(result) {
   console.log("External Tooling Report");
@@ -1496,26 +1189,7 @@ function printText(result) {
   console.log(`  - Manual sync: ${gbrain.sync_command}`);
   console.log("");
 
-  const codegraph = result.tools.codegraph;
-  console.log(`CodeGraph [${codegraph.status}]`);
-  console.log(`  - CLI: ${codegraph.cli_present ? `present${codegraph.version ? ` (v${codegraph.version})` : ""} via ${codegraph.source}` : "missing"}`);
-  if (codegraph.drift) {
-    console.log(`  - Drift: local=${codegraph.drift.local}, global=${codegraph.drift.global}, using=${codegraph.drift.using}`);
-  }
-  for (const host of SELECTED_HOSTS) {
-    const entry = codegraph.mcp_hosts[host];
-    const suffix = entry.tool_search ? ` (${entry.tool_search})` : "";
-    console.log(`  - ${entry.label} MCP: ${entry.status}${suffix}`);
-  }
-  console.log(`  - Project index: ${codegraph.project_index.status}`);
-  console.log(`  - Updates: ${codegraph.update_status} (${codegraph.update_reason})`);
-  console.log(`  - Impact: code-navigation=${codegraph.impact.code_navigation}, hooks=${codegraph.impact.hook_correctness}`);
-  console.log(`  - Install deps: ${codegraph.install_command}`);
-  if (codegraph.ensure_command) {
-    console.log(`  - Ensure: ${codegraph.ensure_command}`);
-  }
-  console.log(`  - Init index: ${codegraph.init_command}`);
-  console.log(`  - Sync index: ${codegraph.sync_command}`);
+
 }
 
 if (jsonOutput) {

package/assets/templates/helpers/check-task-workflow.sh

@@ -670,7 +670,7 @@ check_helper_runtime_files() {
       refresh-current-status.sh prepare-handoff.sh verify-contract.sh summarize-failures.sh
       verify-sprint.sh sprint-backlog.sh check-task-sync.sh check-deploy-sql-order.sh
       check-architecture-sync.sh check-agent-tooling.sh check-context-files.sh
-      check-brain-manifest.sh sync-brain-docs.sh check-skill-version.ts
+      check-brain-manifest.sh sync-brain-docs.sh
       select-agent-context-blocks.sh ensure-task-workflow.sh check-task-workflow.sh
       switch-plan.sh workflow-contract.ts
       inspect-project-state.ts migrate-workflow-docs.ts migrate-project-template.sh

package/assets/templates/helpers/ensure-task-workflow.sh

@@ -1012,20 +1012,6 @@ ARCHITECTURE_INDEX_EOF
     },
     "gbrain": {
       "mcp": "candidate-disabled"
-    },
-    "codegraph": {
-      "package": "@colbymchenry/codegraph",
-      "primary_host": "both",
-      "install_mode": "target-aware-mcp",
-      "codex_config_path": "~/.codex/config.toml",
-      "claude_config_path": "~/.claude.json",
-      "index_dir": ".codegraph",
-      "readiness": "forge-bundled-backend; host-mcp-optional",
-      "hook_policy": "do-not-block-hooks",
-      "install_command": "bun add -g @colbymchenry/codegraph && forge tools configure codegraph --target codex --location global",
-      "project_init_command": "codegraph init -i .",
-      "sync_command": "codegraph sync .",
-      "vendoring_policy": "do-not-add-package-dependency"
     }
   },
   "agentic_development": {

package/assets/templates/helpers/migrate-project-template.sh

@@ -15,7 +15,7 @@ run_source_root() {
     echo "[migrate] bun is required to run Forge from source: $root" >&2
     exit 1
   }
-  exec bun "$root/src/cli/index.ts" adopt "$@" --no-codegraph --no-verify
+  exec bun "$root/src/cli/index.ts" adopt "$@" --no-verify
 }
 
 run_source_root "$SELF_SOURCE_ROOT" "$@"
@@ -24,7 +24,7 @@ if [[ -n "$SOURCE_ROOT" ]]; then
 fi
 
 if command -v forge >/dev/null 2>&1; then
-  exec forge adopt "$@" --no-codegraph --no-verify
+  exec forge adopt "$@" --no-verify
 fi
 
 echo "[migrate] Missing Forge CLI; set FORGE_SOURCE_ROOT to a Forge source checkout." >&2

package/assets/workflow-contract.v1.json

@@ -107,7 +107,6 @@
       "check-context-files.sh",
       "check-brain-manifest.sh",
       "sync-brain-docs.sh",
-      "check-skill-version.ts",
       "select-agent-context-blocks.sh",
       "ensure-task-workflow.sh",
       "check-task-workflow.sh",
@@ -403,7 +402,6 @@
             "scripts/check-brain-manifest.sh",
             "scripts/check-context-files.sh",
             "scripts/check-deploy-sql-order.sh",
-            "scripts/check-skill-version.ts",
             "scripts/check-task-sync.sh",
             "scripts/check-task-workflow.sh",
             "scripts/harness-trace-grade.sh",

package/docs/README.md

@@ -2,7 +2,9 @@
 
 > Maintained documentation for the current Forge product and runtime. Executable behavior and [`architecture/CURRENT.md`](architecture/CURRENT.md) are authoritative for implementation facts and architecture contracts; historical notes are context, not active contracts.
 
-[中文文档中心](README.zh-CN.md) · [GitHub](https://github.com/moretea-labs/forge) · [Releases](https://github.com/moretea-labs/forge/releases) · [Support](../SUPPORT.md)
+[Public documentation site](https://moretea-labs.github.io/forge/) · [中文文档中心](README.zh-CN.md) · [GitHub Wiki](https://github.com/moretea-labs/forge/wiki) · [GitHub](https://github.com/moretea-labs/forge) · [Releases](https://github.com/moretea-labs/forge/releases) · [Support](../SUPPORT.md)
+
+Forge is a local-first ChatGPT MCP runtime for permission-scoped computer use, development, browser actions, and connected services. Current stable: [v1.8.1](https://github.com/moretea-labs/forge/releases/tag/v1.8.1) on npm `latest`. **The versioned repository docs are authoritative; GitHub Wiki mirrors `docs/wiki/`.**
 
 ## Start here
 
@@ -38,9 +40,10 @@ Forge is Direct-first: investigation does not create durable Work by itself, and
 - [Core Concepts](wiki/Core-Concepts.md)
 
 ### Integrate
+- [Computer and plugin setup](wiki/Computer-and-Plugins.md)
 - [Plugin management](forge-plugin-management.md)
 - [Browser provider](operations/controller-browser-plugin.md)
-- [Desktop provider](operations/controller-desktop-plugin.md)
+- [Computer / Desktop provider](wiki/Computer-and-Plugins.md)
 - [Local system assistant](operations/local-system-assistant.md)
 - [iOS development assistant](forge-ios-development-assistant.md)