openings 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.codex-plugin/plugin.json +1 -1
- package/README.md +1 -1
- package/docs/job-seeker-quickstart.md +1 -1
- package/package.json +1 -1
- package/src/mcp.ts +1 -1
- package/src/package-mcp.ts +2 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "openings",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Find evidence-grounded jobs, including relevant roles you may not have searched for, without accounts or API keys.",
|
|
5
5
|
"author": { "name": "Openings contributors" },
|
|
6
6
|
"license": "MIT",
|
package/README.md
CHANGED
|
@@ -91,7 +91,7 @@ The verifier resolves the canonical board endpoint, validates its payload, appli
|
|
|
91
91
|
|
|
92
92
|
## Sharing crawls
|
|
93
93
|
|
|
94
|
-
|
|
94
|
+
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.
|
|
95
95
|
|
|
96
96
|
## Privacy
|
|
97
97
|
|
|
@@ -104,6 +104,6 @@ For development from a source checkout, point the server at the absolute `src/mc
|
|
|
104
104
|
}
|
|
105
105
|
```
|
|
106
106
|
|
|
107
|
-
|
|
107
|
+
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.
|
|
108
108
|
|
|
109
109
|
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
CHANGED
package/src/mcp.ts
CHANGED
|
@@ -22,7 +22,7 @@ export function createMcpHandler(tools: ToolHandler) {
|
|
|
22
22
|
const base = { jsonrpc: "2.0" as const, id: request.id ?? null };
|
|
23
23
|
try {
|
|
24
24
|
if (request.method === "initialize") {
|
|
25
|
-
return { ...base, result: { protocolVersion: "2025-06-18", capabilities: { tools: {} }, serverInfo: { name: "openings", version: "0.1.
|
|
25
|
+
return { ...base, result: { protocolVersion: "2025-06-18", capabilities: { tools: {} }, serverInfo: { name: "openings", version: "0.1.1" } } };
|
|
26
26
|
}
|
|
27
27
|
if (request.method === "ping") return { ...base, result: {} };
|
|
28
28
|
if (request.method === "tools/list") return { ...base, result: { tools: tools.list() } };
|
package/src/package-mcp.ts
CHANGED
|
@@ -3,6 +3,8 @@ import { homedir } from "node:os";
|
|
|
3
3
|
import { join } from "node:path";
|
|
4
4
|
|
|
5
5
|
process.env.OPENINGS_DATA_DIR ??= join(homedir(), ".openings");
|
|
6
|
+
// Shared index: installs report crawled sources here and seed from it. Set OPENINGS_AGGREGATOR_URL to override, or to "" to keep crawls local.
|
|
7
|
+
process.env.OPENINGS_AGGREGATOR_URL ??= "https://openings.avagama.co";
|
|
6
8
|
|
|
7
9
|
const { serve } = await import("./mcp.ts");
|
|
8
10
|
await serve();
|