openings 0.1.0 → 0.1.2

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "openings",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Find evidence-grounded jobs, including relevant roles you may not have searched for, without accounts or API keys.",
   "author": { "name": "Openings contributors" },
   "license": "MIT",

package/README.md

@@ -91,7 +91,7 @@ The verifier resolves the canonical board endpoint, validates its payload, appli
 
 ## Sharing crawls
 
-Set `OPENINGS_AGGREGATOR_URL` and each source you crawl is reported to that aggregator, which merges reports from every install and publishes the result. New installs then download the published index on first setup instead of crawling every source. Only public job data is sent, never resume content. Leave the variable unset to keep every crawl local.
+The packaged server reports each source you crawl to the shared Openings aggregator at `openings.avagama.co`, which merges reports from every install and publishes the result. New installs download the published index on first setup instead of crawling every source. Only public job data is sent, never resume content. Set `OPENINGS_AGGREGATOR_URL` to an empty string to keep every crawl local, or to another URL to use your own aggregator. The source entrypoint reports only when the variable is set.
 
 ## Privacy
 

package/docs/job-seeker-quickstart.md

@@ -104,6 +104,6 @@ For development from a source checkout, point the server at the absolute `src/mc
 }
 ```
 
-When `OPENINGS_AGGREGATOR_URL` is set, first-time setup downloads the aggregator's published index before crawling, and every source you crawl is reported back so other installs benefit; only public job data is shared, never your resume. Leave it unset to keep crawls private. The packaged commands use `~/.openings` by default. The source entrypoint uses `.openings` under the MCP process's working directory unless `OPENINGS_DATA_DIR` is set. The included `.mcp.json` provides the repository-local configuration when this repository is installed as a Codex plugin.
+First-time setup downloads the shared index from the Openings aggregator before crawling, and every source you crawl is reported back so other installs benefit; only public job data is shared, never your resume. Set `OPENINGS_AGGREGATOR_URL` to an empty string to keep crawls private. The packaged commands use `~/.openings` by default. The source entrypoint uses `.openings` under the MCP process's working directory unless `OPENINGS_DATA_DIR` is set. The included `.mcp.json` provides the repository-local configuration when this repository is installed as a Codex plugin.
 
 The MCP interface exposes setup, coverage, recommendation, fit analysis, resume optimization, search, and job-detail tools. There is no application-submission tool.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openings",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A free, candidate-safe job-search substrate for AI agents",
   "license": "MIT",
   "repository": { "type": "git", "url": "git+https://github.com/abhay-avagama/hiring-agent.git" },

package/src/locations.ts

@@ -118,6 +118,9 @@ function detectEligibleCountries(description: string): string[] {
   return matches;
 }
 
+/** Codes the CLDR region table resolves to a name but that are not current ISO 3166-1 countries: deprecated aliases (DD = Germany, UK = United Kingdom) and non-country groupings. */
+const NON_COUNTRY_CODES = new Set(["AC", "AN", "BU", "CP", "CS", "CT", "DD", "DG", "DY", "EA", "EU", "EZ", "FQ", "FX", "HV", "IC", "JT", "MI", "NH", "NQ", "NT", "PC", "PU", "PZ", "QO", "RH", "SU", "TA", "TP", "UK", "UN", "VD", "WK", "XA", "XB", "XK", "YD", "YU", "ZR", "ZZ"]);
+
 let cachedCountryNames: Array<[string, string]> | undefined;
 function countryNames(): Array<[string, string]> {
   if (cachedCountryNames) return cachedCountryNames;
@@ -126,6 +129,7 @@ function countryNames(): Array<[string, string]> {
   for (let first = 65; first <= 90; first += 1) {
     for (let second = 65; second <= 90; second += 1) {
       const code = String.fromCharCode(first, second);
+      if (NON_COUNTRY_CODES.has(code)) continue;
       const name = display.of(code);
       if (name && name !== code && !name.startsWith("Unknown Region")) names.push([code, name]);
     }
@@ -153,7 +157,7 @@ function countryRules(): CountryRule[] {
   cachedCountryRules = countryMatchers().map(([code, country]) => ({
     code,
     location: new RegExp(country, "i"),
-    codeLocation: new RegExp(`(?:^|[,(/-]\\s*)${code}(?=\\s*(?:$|[,)/-]))`, "i"),
+    codeLocation: new RegExp(`(?:^|[,(/-]\\s*)${code === "GB" ? "(?:GB|UK)" : code}(?=\\s*(?:$|[,)/-]))`, "i"),
     exclusion: new RegExp(`\\b(not available|unavailable|excluding|except|cannot hire|can't hire|unable to hire|do not hire|does not hire)\\b.{0,80}(?:${country})|(?:${country}).{0,40}\\b(excluded|not eligible|not supported)\\b`, "i"),
     eligibility: new RegExp(`\\b(open to|hiring|candidates?|applicants?|eligible|remote (?:in|from)|work (?:in|from)|based in|available (?:in|to))\\b.{0,80}(?:${country})`, "i"),
   }));

package/src/mcp.ts

@@ -22,7 +22,7 @@ export function createMcpHandler(tools: ToolHandler) {
     const base = { jsonrpc: "2.0" as const, id: request.id ?? null };
     try {
       if (request.method === "initialize") {
-        return { ...base, result: { protocolVersion: "2025-06-18", capabilities: { tools: {} }, serverInfo: { name: "openings", version: "0.1.0" } } };
+        return { ...base, result: { protocolVersion: "2025-06-18", capabilities: { tools: {} }, serverInfo: { name: "openings", version: "0.1.2" } } };
       }
       if (request.method === "ping") return { ...base, result: {} };
       if (request.method === "tools/list") return { ...base, result: { tools: tools.list() } };

package/src/package-mcp.ts

@@ -3,6 +3,8 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 
 process.env.OPENINGS_DATA_DIR ??= join(homedir(), ".openings");
+// Shared index: installs report crawled sources here and seed from it. Set OPENINGS_AGGREGATOR_URL to override, or to "" to keep crawls local.
+process.env.OPENINGS_AGGREGATOR_URL ??= "https://openings.avagama.co";
 
 const { serve } = await import("./mcp.ts");
 await serve();