job-forge 2.14.40 → 2.14.41

package/bin/geometra-mcp-launcher.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 import { spawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const DEFAULT_FALLBACK_PACKAGE = '@geometra/mcp@1.61.3';
@@ -22,6 +22,46 @@ function resolveExplicitPath(rawPath) {
   return resolvedPath;
 }
 
+function readJsonFile(filePath) {
+  return JSON.parse(readFileSync(filePath, 'utf8'));
+}
+
+function readProjectPathFromPackageJson(projectDir) {
+  const packagePath = join(projectDir, 'package.json');
+  if (!existsSync(packagePath)) return null;
+  const pkg = readJsonFile(packagePath);
+  const rawPath = pkg?.jobForge?.geometraMcpPath;
+  return normalizeEnv(rawPath);
+}
+
+function readProjectPathFromOpencodeConfig(projectDir) {
+  const configPath = join(projectDir, 'opencode.json');
+  if (!existsSync(configPath)) return null;
+  const config = readJsonFile(configPath);
+  const rawPath = config?.mcp?.geometra?.environment?.JOB_FORGE_GEOMETRA_MCP_PATH;
+  return normalizeEnv(rawPath);
+}
+
+function resolveProjectConfiguredPath(projectDir) {
+  const packagePath = readProjectPathFromPackageJson(projectDir);
+  if (packagePath) {
+    return {
+      source: 'project-package-json',
+      resolvedPath: resolve(projectDir, packagePath),
+    };
+  }
+
+  const opencodePath = readProjectPathFromOpencodeConfig(projectDir);
+  if (opencodePath) {
+    return {
+      source: 'project-opencode-json',
+      resolvedPath: resolve(projectDir, opencodePath),
+    };
+  }
+
+  return null;
+}
+
 export function resolveGeometraMcpLaunchTarget() {
   const explicitPath = normalizeEnv(process.env.JOB_FORGE_GEOMETRA_MCP_PATH);
   if (explicitPath) {
@@ -34,6 +74,18 @@ export function resolveGeometraMcpLaunchTarget() {
     };
   }
 
+  const projectDir = process.env.JOB_FORGE_PROJECT || process.cwd();
+  const projectConfigured = resolveProjectConfiguredPath(projectDir);
+  if (projectConfigured) {
+    const resolvedPath = resolveExplicitPath(projectConfigured.resolvedPath);
+    return {
+      source: projectConfigured.source,
+      command: process.execPath,
+      args: [resolvedPath],
+      resolvedPath,
+    };
+  }
+
   const scriptDir = dirname(fileURLToPath(import.meta.url));
   const siblingRepoPath = resolve(scriptDir, '../../geometra/mcp/dist/index.js');
   if (existsSync(siblingRepoPath)) {

package/docs/SETUP.md

@@ -214,7 +214,17 @@ Use it to identify which sessions or models are consuming the most tokens. The `
 `sync-check` requires `cv.md` and `config/profile.yml` with the fields checked in `cv-sync-check.mjs`. Until you finish the profile and CV steps, that is normal.
 
 **PDF generation fails**  
-The scaffolded `opencode.json` already registers Geometra MCP; if it's not running, check `opencode mcp list` and verify the scaffolded config under the `mcp.geometra` key — its `command` MUST be `["npx", "--no-install", "job-forge", "mcp:geometra"]`, `enabled: true`, and its `environment` should include `GEOMETRA_STEALTH=1` (or equivalently `GEOMETRA_BROWSER=stealth`) so proxy-backed portal sessions default to CloakBrowser's patched Chromium. `job-forge mcp:geometra` prefers `JOB_FORGE_GEOMETRA_MCP_PATH` when set, otherwise a sibling `../geometra/mcp/dist/index.js` checkout for local JobForge development, and otherwise falls back to the pinned npm package. Geometra manages Chromium via its built-in proxy. JobForge still passes `stealth: true` for portal sessions explicitly; the env block keeps the default aligned for auto-spawned sessions and local debugging. For standalone CLI usage (outside opencode), `generate-pdf.mjs` also works with standalone Playwright/Chromium — install with `npx playwright install chromium`.
+The scaffolded `opencode.json` already registers Geometra MCP; if it's not running, check `opencode mcp list` and verify the scaffolded config under the `mcp.geometra` key — its `command` MUST be `["npx", "--no-install", "job-forge", "mcp:geometra"]`, `enabled: true`, and its `environment` should include `GEOMETRA_STEALTH=1` (or equivalently `GEOMETRA_BROWSER=stealth`) so proxy-backed portal sessions default to CloakBrowser's patched Chromium. `job-forge mcp:geometra` resolves Geometra in this order: `JOB_FORGE_GEOMETRA_MCP_PATH`, then a consumer-project override from `package.json -> jobForge.geometraMcpPath`, then `opencode.json -> mcp.geometra.environment.JOB_FORGE_GEOMETRA_MCP_PATH`, then a sibling `../geometra/mcp/dist/index.js` checkout for local JobForge development, and finally the pinned npm package. Geometra manages Chromium via its built-in proxy. JobForge still passes `stealth: true` for portal sessions explicitly; the env block keeps the default aligned for auto-spawned sessions and local debugging. For standalone CLI usage (outside opencode), `generate-pdf.mjs` also works with standalone Playwright/Chromium — install with `npx playwright install chromium`.
+
+For consumer projects that should always use a local Geometra checkout across Opencode, Codex, Cursor, and Claude, prefer a local `package.json` override instead of editing symlinked MCP configs:
+
+```json
+{
+  "jobForge": {
+    "geometraMcpPath": "/absolute/path/to/geometra/mcp/dist/index.js"
+  }
+}
+```
 
 **Symlinks are missing or pointing to a stale path**  
 Run `npx job-forge sync` (or `npm run sync`) to recreate them. This happens if you move the project directory after installing, or if `postinstall` didn't run (rare — check `npm install` output for errors).

package/modes/reference-portals.md

@@ -139,6 +139,6 @@ The Geometra MCP partitions its reusable-proxy pool by proxy identity and browse
 }
 ```
 
-`job-forge mcp:geometra` resolves Geometra in this order: `JOB_FORGE_GEOMETRA_MCP_PATH` if set, then a sibling local `../geometra/mcp/dist/index.js` checkout for maintainers working across both repos, then the pinned npm fallback.
+`job-forge mcp:geometra` resolves Geometra in this order: `JOB_FORGE_GEOMETRA_MCP_PATH`, then `package.json -> jobForge.geometraMcpPath`, then `opencode.json -> mcp.geometra.environment.JOB_FORGE_GEOMETRA_MCP_PATH`, then a sibling local `../geometra/mcp/dist/index.js` checkout for maintainers working across both repos, then the pinned npm fallback.
 
 To check or modify MCP settings, edit `opencode.json` in the project root.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "job-forge",
-  "version": "2.14.40",
+  "version": "2.14.41",
   "description": "AI-powered job search pipeline built on opencode",
   "type": "module",
   "bin": {