career-compass-mcp 2.5.1 → 2.6.0
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/PRIVACY.md +133 -0
- package/README.md +486 -481
- package/build/bin/cli.js +29 -23
- package/build/bin/cli.js.map +1 -1
- package/build/src/completions.d.ts +9 -7
- package/build/src/completions.d.ts.map +1 -1
- package/build/src/completions.js +9 -7
- package/build/src/completions.js.map +1 -1
- package/build/src/dashboard-lite/render.d.ts +1 -1
- package/build/src/dashboard-lite/render.d.ts.map +1 -1
- package/build/src/dashboard-lite/render.js +168 -147
- package/build/src/dashboard-lite/render.js.map +1 -1
- package/build/src/loopback-guard.d.ts.map +1 -1
- package/build/src/loopback-guard.js +12 -1
- package/build/src/loopback-guard.js.map +1 -1
- package/build/src/prompts/index.d.ts.map +1 -1
- package/build/src/prompts/index.js +99 -6
- package/build/src/prompts/index.js.map +1 -1
- package/build/src/resources/career-kb.d.ts.map +1 -1
- package/build/src/resources/career-kb.js +134 -15
- package/build/src/resources/career-kb.js.map +1 -1
- package/build/src/resources/live.d.ts +6 -0
- package/build/src/resources/live.d.ts.map +1 -1
- package/build/src/resources/live.js +127 -21
- package/build/src/resources/live.js.map +1 -1
- package/build/src/storage/file-store.d.ts +40 -1
- package/build/src/storage/file-store.d.ts.map +1 -1
- package/build/src/storage/file-store.js +88 -3
- package/build/src/storage/file-store.js.map +1 -1
- package/build/src/storage/read-only-error.d.ts +23 -0
- package/build/src/storage/read-only-error.d.ts.map +1 -0
- package/build/src/storage/read-only-error.js +30 -0
- package/build/src/storage/read-only-error.js.map +1 -0
- package/build/src/storage/serialize.d.ts +2 -0
- package/build/src/storage/serialize.d.ts.map +1 -1
- package/build/src/storage/serialize.js +17 -1
- package/build/src/storage/serialize.js.map +1 -1
- package/build/src/storage/write-claim.d.ts +42 -5
- package/build/src/storage/write-claim.d.ts.map +1 -1
- package/build/src/storage/write-claim.js +97 -23
- package/build/src/storage/write-claim.js.map +1 -1
- package/build/src/tools/career-kb.d.ts.map +1 -1
- package/build/src/tools/career-kb.js +136 -109
- package/build/src/tools/career-kb.js.map +1 -1
- package/build/src/tools/interview.d.ts.map +1 -1
- package/build/src/tools/interview.js +25 -6
- package/build/src/tools/interview.js.map +1 -1
- package/build/src/tools/pipeline.d.ts.map +1 -1
- package/build/src/tools/pipeline.js +59 -49
- package/build/src/tools/pipeline.js.map +1 -1
- package/build/src/tools/read-guard.d.ts +30 -0
- package/build/src/tools/read-guard.d.ts.map +1 -0
- package/build/src/tools/read-guard.js +34 -0
- package/build/src/tools/read-guard.js.map +1 -0
- package/build/src/untrusted.d.ts +14 -5
- package/build/src/untrusted.d.ts.map +1 -1
- package/build/src/untrusted.js +14 -5
- package/build/src/untrusted.js.map +1 -1
- package/package.json +77 -76
package/PRIVACY.md
ADDED
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
# Privacy Policy — Career Compass MCP
|
|
2
|
+
|
|
3
|
+
**Last updated:** 2026-08-08
|
|
4
|
+
**Applies to:** the `career-compass-mcp` MCP server and its bundled local dashboard, all versions.
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## The short version
|
|
9
|
+
|
|
10
|
+
Career Compass runs entirely on your own computer. It has no server and no account. Your
|
|
11
|
+
career history and job pipeline are plain YAML files in a directory you choose. Nothing is
|
|
12
|
+
uploaded, and there is nothing for us to collect, store, sell, or hand over — because your
|
|
13
|
+
data never reaches us in the first place.
|
|
14
|
+
|
|
15
|
+
There is exactly one outbound network request in the whole package, and only when you ask
|
|
16
|
+
for it: the `check_setup` tool asks the public npm registry whether a newer version has
|
|
17
|
+
been released. It sends nothing about you. Details under [Update checks](#update-checks).
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## What data the software handles
|
|
22
|
+
|
|
23
|
+
Career Compass reads and writes the career information *you* give it:
|
|
24
|
+
|
|
25
|
+
- **Career knowledge base** — name, contact details, work history, skills, education,
|
|
26
|
+
projects, testimonials, and a dated journal of your own notes.
|
|
27
|
+
- **Job pipeline** — the roles you're tracking, their status, salary ranges you record,
|
|
28
|
+
recruiter and hiring-manager contact details you enter, interview dates, and your notes.
|
|
29
|
+
- **Text you paste in** — job postings, emails, offer letters, performance reviews, and
|
|
30
|
+
similar documents you hand to a tool.
|
|
31
|
+
|
|
32
|
+
## Where it is stored
|
|
33
|
+
|
|
34
|
+
In a single directory on your machine, set by the `CAREER_DATA_PATH` environment variable.
|
|
35
|
+
The default is `~/.career-compass/`. Files are ordinary YAML you can open, edit, back up,
|
|
36
|
+
or delete with any text editor. While a write is in progress the folder also briefly holds a
|
|
37
|
+
`.write-claim` file naming the process doing the writing, so a second Career Compass process
|
|
38
|
+
(a dashboard, or a server registered in two clients) refuses rather than overwriting it. It is
|
|
39
|
+
deleted when the write finishes, contains no personal data, and is safe to remove by hand.
|
|
40
|
+
Each write also leaves a timestamped `.bak` copy of the
|
|
41
|
+
previous version in the same directory.
|
|
42
|
+
|
|
43
|
+
**We never receive this data.** There is no Career Compass account, no cloud sync, no
|
|
44
|
+
backup service, and no telemetry or analytics of any kind. The only request the software
|
|
45
|
+
ever makes to the internet is the version check described below, which carries none of it.
|
|
46
|
+
|
|
47
|
+
## Update checks
|
|
48
|
+
|
|
49
|
+
The `check_setup` tool reports the health of your install, and part of that report is
|
|
50
|
+
whether you are running the current release. To answer that it makes a single HTTPS GET to
|
|
51
|
+
the public npm registry:
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
https://registry.npmjs.org/career-compass-mcp/latest
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Precisely what that involves:
|
|
58
|
+
|
|
59
|
+
- **What is sent.** The package name, in the URL. That is all. No account, no identifier,
|
|
60
|
+
no career data, no pipeline data, no request body, no cookies, and no authentication
|
|
61
|
+
header. It is the same request `npm view career-compass-mcp` makes, and npm's registry
|
|
62
|
+
sees it the same way it sees anyone browsing a public package page. Your IP address is
|
|
63
|
+
visible to the registry, as it is to any website you open.
|
|
64
|
+
- **What comes back.** The published metadata for the latest version. Career Compass reads
|
|
65
|
+
one field from it — the version number — and discards the rest.
|
|
66
|
+
- **When it happens.** Only while `check_setup` is running, and only if its
|
|
67
|
+
`checkForUpdates` parameter is true. No other tool makes it, nothing makes it on
|
|
68
|
+
startup, on a schedule, or in the background.
|
|
69
|
+
- **How to turn it off.** Call `check_setup` with `checkForUpdates: false`. The rest of
|
|
70
|
+
the health check runs normally and no request is constructed.
|
|
71
|
+
- **When it fails.** If you are offline, behind a proxy, or the registry is slow, the
|
|
72
|
+
check times out after a few seconds and the report says it could not check. It is never
|
|
73
|
+
an error and it never blocks the rest of the report.
|
|
74
|
+
|
|
75
|
+
The npm registry is operated by npm, Inc. (GitHub/Microsoft) under its own privacy policy:
|
|
76
|
+
https://docs.npmjs.com/policies/privacy
|
|
77
|
+
|
|
78
|
+
Separately, `check_setup` also checks whether your local dashboard is running by requesting
|
|
79
|
+
`http://127.0.0.1:<port>/`. That is a loopback request to your own machine; it never
|
|
80
|
+
reaches the network.
|
|
81
|
+
|
|
82
|
+
## Who else sees it
|
|
83
|
+
|
|
84
|
+
Career Compass is an MCP server, so it answers a client you connect it to — normally Claude
|
|
85
|
+
Desktop or Claude Code. When you ask Claude to tailor a resume or prep an interview, the
|
|
86
|
+
relevant parts of your career data are passed to that client, and from there to the model
|
|
87
|
+
provider under **their** privacy policy, not this one:
|
|
88
|
+
|
|
89
|
+
- Anthropic's privacy policy: https://www.anthropic.com/legal/privacy
|
|
90
|
+
|
|
91
|
+
That is the only path by which your data leaves your machine, it happens because you asked
|
|
92
|
+
for it, and it is governed by the terms of whichever client and model provider you chose.
|
|
93
|
+
Career Compass itself sends none of your data anywhere — its one outbound request asks the
|
|
94
|
+
npm registry about a version number and carries nothing else.
|
|
95
|
+
|
|
96
|
+
The bundled local dashboard (`career-compass-mcp dashboard`) serves pages from
|
|
97
|
+
`127.0.0.1` on your own machine, renders them with no external assets, and makes no
|
|
98
|
+
network calls.
|
|
99
|
+
|
|
100
|
+
## Untrusted text
|
|
101
|
+
|
|
102
|
+
Job postings, emails, and documents you paste in are third-party content. Career Compass
|
|
103
|
+
wraps them in a clearly-marked, nonce-delimited block before they reach the model, so text
|
|
104
|
+
inside them is presented as quoted evidence rather than as instructions. This reduces the
|
|
105
|
+
risk that a malicious posting can direct the model to act against you, but no such measure
|
|
106
|
+
is absolute. Treat pasted content from unknown sources with the same care you would apply
|
|
107
|
+
anywhere else.
|
|
108
|
+
|
|
109
|
+
## Data retention
|
|
110
|
+
|
|
111
|
+
Your files stay on your disk until you delete them. There is no retention period on our
|
|
112
|
+
side because we hold nothing. To remove everything, delete your `CAREER_DATA_PATH`
|
|
113
|
+
directory (including the `.bak` files and any leftover `.write-claim`) and uninstall the package.
|
|
114
|
+
|
|
115
|
+
## Third-party sharing
|
|
116
|
+
|
|
117
|
+
None. We do not share, sell, rent, or disclose your data, because we never receive it.
|
|
118
|
+
There are no advertisers, analytics providers, data brokers, or subprocessors involved.
|
|
119
|
+
|
|
120
|
+
## Children
|
|
121
|
+
|
|
122
|
+
Career Compass is a job-search tool intended for adults in the workforce and is not
|
|
123
|
+
directed at children under 13.
|
|
124
|
+
|
|
125
|
+
## Changes to this policy
|
|
126
|
+
|
|
127
|
+
Changes are published in this file in the public repository, with the date at the top
|
|
128
|
+
updated. The version history is visible in git.
|
|
129
|
+
|
|
130
|
+
## Contact
|
|
131
|
+
|
|
132
|
+
- **Issues and questions:** https://github.com/benskamps/career-compass-mcp/issues
|
|
133
|
+
- **Maintainer:** Ben Schippers — https://github.com/benskamps
|