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.
Files changed (59) hide show
  1. package/PRIVACY.md +133 -0
  2. package/README.md +486 -481
  3. package/build/bin/cli.js +29 -23
  4. package/build/bin/cli.js.map +1 -1
  5. package/build/src/completions.d.ts +9 -7
  6. package/build/src/completions.d.ts.map +1 -1
  7. package/build/src/completions.js +9 -7
  8. package/build/src/completions.js.map +1 -1
  9. package/build/src/dashboard-lite/render.d.ts +1 -1
  10. package/build/src/dashboard-lite/render.d.ts.map +1 -1
  11. package/build/src/dashboard-lite/render.js +168 -147
  12. package/build/src/dashboard-lite/render.js.map +1 -1
  13. package/build/src/loopback-guard.d.ts.map +1 -1
  14. package/build/src/loopback-guard.js +12 -1
  15. package/build/src/loopback-guard.js.map +1 -1
  16. package/build/src/prompts/index.d.ts.map +1 -1
  17. package/build/src/prompts/index.js +99 -6
  18. package/build/src/prompts/index.js.map +1 -1
  19. package/build/src/resources/career-kb.d.ts.map +1 -1
  20. package/build/src/resources/career-kb.js +134 -15
  21. package/build/src/resources/career-kb.js.map +1 -1
  22. package/build/src/resources/live.d.ts +6 -0
  23. package/build/src/resources/live.d.ts.map +1 -1
  24. package/build/src/resources/live.js +127 -21
  25. package/build/src/resources/live.js.map +1 -1
  26. package/build/src/storage/file-store.d.ts +40 -1
  27. package/build/src/storage/file-store.d.ts.map +1 -1
  28. package/build/src/storage/file-store.js +88 -3
  29. package/build/src/storage/file-store.js.map +1 -1
  30. package/build/src/storage/read-only-error.d.ts +23 -0
  31. package/build/src/storage/read-only-error.d.ts.map +1 -0
  32. package/build/src/storage/read-only-error.js +30 -0
  33. package/build/src/storage/read-only-error.js.map +1 -0
  34. package/build/src/storage/serialize.d.ts +2 -0
  35. package/build/src/storage/serialize.d.ts.map +1 -1
  36. package/build/src/storage/serialize.js +17 -1
  37. package/build/src/storage/serialize.js.map +1 -1
  38. package/build/src/storage/write-claim.d.ts +42 -5
  39. package/build/src/storage/write-claim.d.ts.map +1 -1
  40. package/build/src/storage/write-claim.js +97 -23
  41. package/build/src/storage/write-claim.js.map +1 -1
  42. package/build/src/tools/career-kb.d.ts.map +1 -1
  43. package/build/src/tools/career-kb.js +136 -109
  44. package/build/src/tools/career-kb.js.map +1 -1
  45. package/build/src/tools/interview.d.ts.map +1 -1
  46. package/build/src/tools/interview.js +25 -6
  47. package/build/src/tools/interview.js.map +1 -1
  48. package/build/src/tools/pipeline.d.ts.map +1 -1
  49. package/build/src/tools/pipeline.js +59 -49
  50. package/build/src/tools/pipeline.js.map +1 -1
  51. package/build/src/tools/read-guard.d.ts +30 -0
  52. package/build/src/tools/read-guard.d.ts.map +1 -0
  53. package/build/src/tools/read-guard.js +34 -0
  54. package/build/src/tools/read-guard.js.map +1 -0
  55. package/build/src/untrusted.d.ts +14 -5
  56. package/build/src/untrusted.d.ts.map +1 -1
  57. package/build/src/untrusted.js +14 -5
  58. package/build/src/untrusted.js.map +1 -1
  59. 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