{"_id":"reinvent-compass","_rev":"6-d1733d66a460d70c89910261c3a62eb3","name":"reinvent-compass","dist-tags":{"latest":"0.1.3"},"versions":{"0.0.0-stage":{"name":"reinvent-compass","version":"0.0.0-stage","_id":"reinvent-compass@0.0.0-stage","stub":true,"maintainers":[{"name":"henniefrancis","email":"henniefrancis@gmail.com"}],"dist":{"shasum":"d67ba26377e839318f26ab5bdc29240139e5394f","tarball":"https://registry.npmjs.org/reinvent-compass/-/reinvent-compass-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-c+b4hJuJm6JdTHZtb8WekhIsWrRKyK5Y2pdyw5sPEi8xhdsVCenuJ5riLVZlXG41JDbYZ1NJHnb1YZ9knjsAkA==","signatures":[{"sig":"MEQCICKpifYcNXzCxkY2Mv8Nqz6d5mOzTLfV9966fYqSncnXAiB9aWaCW6UCqJyg/STfmkxIvlmeLQ6LR1ogwVyrA4LIOw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":338},"_npmUser":{"name":"henniefrancis","email":"henniefrancis@gmail.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.0.1":{"name":"reinvent-compass","version":"0.0.1","keywords":["aws","reinvent","mcp","kiro"],"author":{"name":"Hennie Francis"},"license":"Apache-2.0","_id":"reinvent-compass@0.0.1","maintainers":[{"name":"henniefrancis","email":"henniefrancis@gmail.com"}],"homepage":"https://github.com/henniefrancis/aws-re_invent-compass#readme","bugs":{"url":"https://github.com/henniefrancis/aws-re_invent-compass/issues"},"dist":{"shasum":"5ae1cf258530fada9d4ee6a56ccd467281b23edd","tarball":"https://registry.npmjs.org/reinvent-compass/-/reinvent-compass-0.0.1.tgz","fileCount":2,"integrity":"sha512-jyGaz782N5e6xfZ2z6ScdUAl1s84AS0dVM+tLeS5sFK/T+5OJprdvcdoZtiyz9zTKvDCr+NIhFQ6sP2UkQRJrw==","signatures":[{"sig":"MEUCIC1ows0TDK4j7iNVVgRq5D7uV07zhH6aSqI8hhQ0KgUWAiEA3RBly2EtQKf39spVn8az1CVfWtNW7X6Vmel8dvuQI6M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIFyOk8LvZQNC5BDGRkbLfxtNgUl/UJxg+Cje6vqkACLqAiEA8Eb6TmcrHkUNU4By+77hsAr04Rk5HOO8I0xFpCGyaLc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":894},"_npmUser":{"name":"henniefrancis","email":"henniefrancis@gmail.com"},"repository":{"url":"git+https://github.com/henniefrancis/aws-re_invent-compass.git","type":"git"},"_npmVersion":"11.17.0","description":"Placeholder for re:Invent Compass, a Kiro Power and MCP server that plans a first-timer's AWS re:Invent week. The first real release follows.","directories":{},"_nodeVersion":"24.16.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/reinvent-compass_0.0.1_1792322767930_0.025364206586909965","host":"s3://npm-registry-packages-npm-production"}},"0.1.0":{"name":"reinvent-compass","version":"0.1.0","license":"Apache-2.0","_id":"reinvent-compass@0.1.0","maintainers":[{"name":"henniefrancis","email":"henniefrancis@gmail.com"}],"homepage":"https://reinvent-compass.vegas","bugs":{"url":"https://github.com/henniefrancis/aws-re_invent-compass/issues"},"bin":{"reinvent-compass":"dist/bin.js"},"dist":{"shasum":"d335cc93c5efae11351cae06de5d0f00220bf2a4","tarball":"https://registry.npmjs.org/reinvent-compass/-/reinvent-compass-0.1.0.tgz","fileCount":63,"integrity":"sha512-r+lKU3O091R8lWtkuzwaEE60pvZvCURXMgeW70IWfPzikgkAIMY3dkPEL71ZMzh/ptewABElKYeCN47XkL8jvA==","signatures":[{"sig":"MEQCIDssAPb2p25eRlr1bxuhDPvYiTU9+mJqK9YtWP2P8aBSAiBDhxV3P4hm7WotrRJeNxslIG7XmeNLDxP3EqGCoQFRjA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCAAJiKLWRKyzJL82hU9PLd+L//8R56D/d73tYeY6CiyAIhAPIoPJqBf3WF4Boe3vFVXhv+j+nc4aMNrXZb7E3FfIOw","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/reinvent-compass@0.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3687897},"type":"module","_from":"file:/home/runner/work/_temp/pack/reinvent-compass-0.1.0.tgz","engines":{"node":">=24"},"scripts":{"build":"node scripts/build.mjs","prepack":"node scripts/build.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"69cbb267-af8a-4bbe-a0ca-359e2d160263"}},"_resolved":"/home/runner/work/_temp/pack/reinvent-compass-0.1.0.tgz","_integrity":"sha512-r+lKU3O091R8lWtkuzwaEE60pvZvCURXMgeW70IWfPzikgkAIMY3dkPEL71ZMzh/ptewABElKYeCN47XkL8jvA==","repository":{"url":"git+https://github.com/henniefrancis/aws-re_invent-compass.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.19.1","description":"An MCP server and Kiro Power that plans your re:Invent week from your own code and issues unofficial boarding passes for your reserved sessions.","directories":{},"_nodeVersion":"24.22.1","dependencies":{"@napi-rs/keyring":"2.1.1"},"_hasShrinkwrap":false,"devDependencies":{"zod":"4.6.7","@compass/core":"0.0.0","@compass/contracts":"0.0.0","@modelcontextprotocol/sdk":"1.32.2"},"_npmOperationalInternal":{"tmp":"tmp/reinvent-compass_0.1.0_1793739249768_0.024854342233967763","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"reinvent-compass","version":"0.1.1","license":"Apache-2.0","_id":"reinvent-compass@0.1.1","maintainers":[{"name":"henniefrancis","email":"henniefrancis@gmail.com"}],"homepage":"https://reinvent-compass.vegas","bugs":{"url":"https://github.com/henniefrancis/aws-re_invent-compass/issues"},"bin":{"reinvent-compass":"dist/bin.js"},"dist":{"shasum":"5471bea5098217a720dda1d3d83841912301d267","tarball":"https://registry.npmjs.org/reinvent-compass/-/reinvent-compass-0.1.1.tgz","fileCount":63,"integrity":"sha512-iBVXhRnT8pmQe5mgpMjXkh5zbPANLny33irLLE40ck2EpuJ2XFIorWCuHkZo0md0yXLXeFq/i3L6ZLotmofn/A==","signatures":[{"sig":"MEUCIH5WulV4pq5K+Rqj81Lx+pQNhcgZp6/29hqHdde7Hc8oAiEAnvcMO+n62JgWT/L3SVmZ6K0NVogmx9t+IxsEpmjOApc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCbkEhLd84TpddKPdZq0MU7kSGVQoWS9qlxBUHTKwVf+gIhAPBTiO10fMP7UpDg20UamTykDPsEz0eJZoUH+MCfQjN3","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/reinvent-compass@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3690482},"type":"module","_from":"file:/home/runner/work/_temp/pack/reinvent-compass-0.1.1.tgz","engines":{"node":">=24"},"scripts":{"build":"node scripts/build.mjs","prepack":"node scripts/build.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"69cbb267-af8a-4bbe-a0ca-359e2d160263"}},"_resolved":"/home/runner/work/_temp/pack/reinvent-compass-0.1.1.tgz","_integrity":"sha512-iBVXhRnT8pmQe5mgpMjXkh5zbPANLny33irLLE40ck2EpuJ2XFIorWCuHkZo0md0yXLXeFq/i3L6ZLotmofn/A==","repository":{"url":"git+https://github.com/henniefrancis/aws-re_invent-compass.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.19.1","description":"An MCP server and Kiro Power that plans your re:Invent week from your own code and issues unofficial boarding passes for your reserved sessions.","directories":{},"_nodeVersion":"24.22.1","dependencies":{"@napi-rs/keyring":"2.1.1"},"_hasShrinkwrap":false,"devDependencies":{"zod":"4.6.7","@compass/core":"0.0.0","@compass/contracts":"0.0.0","@modelcontextprotocol/sdk":"1.32.2"},"_npmOperationalInternal":{"tmp":"tmp/reinvent-compass_0.1.1_1793799010685_0.813354377040005","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"reinvent-compass","version":"0.1.2","license":"Apache-2.0","_id":"reinvent-compass@0.1.2","maintainers":[{"name":"henniefrancis","email":"henniefrancis@gmail.com"}],"homepage":"https://reinvent-compass.vegas","bugs":{"url":"https://github.com/henniefrancis/aws-re_invent-compass/issues"},"bin":{"reinvent-compass":"dist/bin.js"},"dist":{"shasum":"e4c5a191286947ecf3615b8fc411d1d364d23574","tarball":"https://registry.npmjs.org/reinvent-compass/-/reinvent-compass-0.1.2.tgz","fileCount":63,"integrity":"sha512-QsW7NvBgFLMd2wKsIw51c7TaRN2cLTnOaot/qFU0WkvsSJaj8Aoc9+jkwSmomwJ2kdUxykNi9iWwhUUAEsdQGQ==","signatures":[{"sig":"MEUCIFPy7pmNwoi71j+ZE+1diC/k4ePoMkbtVNDesNpyugfCAiEAlj9x1kMg8wAZqIDXO1IzNWkQDvAnCo24OyHay+955KQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIH8RQbZOQP4kZO+O3LNn871/azbNwT6/AyzRsYaSVQM0AiEAqj/DRdDE5RM2cju7jFLKWNjgk9EhPIAZ1lpH7kofRRQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/reinvent-compass@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3691176},"type":"module","_from":"file:/home/runner/work/_temp/pack/reinvent-compass-0.1.2.tgz","engines":{"node":">=24"},"scripts":{"build":"node scripts/build.mjs","prepack":"node scripts/build.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"69cbb267-af8a-4bbe-a0ca-359e2d160263"}},"_resolved":"/home/runner/work/_temp/pack/reinvent-compass-0.1.2.tgz","_integrity":"sha512-QsW7NvBgFLMd2wKsIw51c7TaRN2cLTnOaot/qFU0WkvsSJaj8Aoc9+jkwSmomwJ2kdUxykNi9iWwhUUAEsdQGQ==","repository":{"url":"git+https://github.com/henniefrancis/aws-re_invent-compass.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.19.1","description":"An MCP server and Kiro Power that plans your re:Invent week from your own code and issues unofficial boarding passes for your reserved sessions.","directories":{},"_nodeVersion":"24.22.2","dependencies":{"@napi-rs/keyring":"2.1.1"},"_hasShrinkwrap":false,"devDependencies":{"zod":"4.6.7","@compass/core":"0.0.0","@compass/contracts":"0.0.0","@modelcontextprotocol/sdk":"1.32.2"},"_npmOperationalInternal":{"tmp":"tmp/reinvent-compass_0.1.2_1793812236402_0.8339519545731344","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"_id":"reinvent-compass@0.1.3","bin":{"reinvent-compass":"dist/bin.js"},"bugs":{"url":"https://github.com/henniefrancis/aws-re_invent-compass/issues"},"dist":{"shasum":"b10324028fae32c9283dd1ac78d4627512acc18f","tarball":"https://registry.npmjs.org/reinvent-compass/-/reinvent-compass-0.1.3.tgz","fileCount":63,"integrity":"sha512-K2lxbGfJPlf9f1whzM89Ke8DYCH1hwCLsHU/P3eB5ETJQkYxm7ZdWlwZxSl+Oih7VqXMLhGJfK9J29G+7Wa5rg==","signatures":[{"sig":"MEUCIQDzTI8ueHSfaMdEoDH7GRfs6kA+nsqX6o+zeFKhnnD/BQIgbuFq07O2L7XHKIxBhwXzk0HWFWKOkX5MIM2P/NvUsJA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDH3Y1dr8yslqkhw9bwf31eWNCEGuRSuSNCnmSXRW+YLAiEAsbizUy0V18CX0DtEabB16EJpAV9cuHaqRHQer1nH1SU="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/reinvent-compass@0.1.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":3701111},"name":"reinvent-compass","type":"module","_from":"file:/home/runner/work/_temp/pack/reinvent-compass-0.1.3.tgz","engines":{"node":">=24"},"license":"Apache-2.0","scripts":{"build":"node scripts/build.mjs","prepack":"node scripts/build.mjs"},"version":"0.1.3","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"69cbb267-af8a-4bbe-a0ca-359e2d160263"}},"homepage":"https://reinvent-compass.vegas","keywords":["mcp","mcp-server","model-context-protocol","kiro","kiro-power","aws","reinvent","re:Invent","conference","sessions","schedule","boarding-pass","wallet","first-timer"],"_resolved":"/home/runner/work/_temp/pack/reinvent-compass-0.1.3.tgz","_integrity":"sha512-K2lxbGfJPlf9f1whzM89Ke8DYCH1hwCLsHU/P3eB5ETJQkYxm7ZdWlwZxSl+Oih7VqXMLhGJfK9J29G+7Wa5rg==","repository":{"url":"git+https://github.com/henniefrancis/aws-re_invent-compass.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.19.1","description":"Scans your code and GitHub repositories to find the AWS re:Invent sessions that match your stack, books them safely with guardrails, and puts unofficial Boarding Passes on your phone. Independent community project, not affiliated with AWS.","directories":{},"maintainers":[{"name":"henniefrancis","email":"henniefrancis@gmail.com"}],"_nodeVersion":"24.22.2","dependencies":{"@napi-rs/keyring":"2.1.1"},"_hasShrinkwrap":false,"devDependencies":{"zod":"4.6.7","@compass/core":"0.0.0","@compass/contracts":"0.0.0","@modelcontextprotocol/sdk":"1.32.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/reinvent-compass_0.1.3_1793911190996_0.06439536397076517"}}},"time":{"created":"2026-10-18T11:21:57.750Z","modified":"2026-11-05T20:39:51.437Z","0.0.0-stage":"2026-10-18T11:21:57.750Z","0.0.1":"2026-10-18T11:26:08.010Z","0.1.0":"2026-11-03T20:54:09.936Z","0.1.1":"2026-11-04T13:30:10.824Z","0.1.2":"2026-11-04T17:10:36.599Z","0.1.3":"2026-11-05T20:39:51.120Z"},"bugs":{"url":"https://github.com/henniefrancis/aws-re_invent-compass/issues"},"license":"Apache-2.0","homepage":"https://reinvent-compass.vegas","repository":{"url":"git+https://github.com/henniefrancis/aws-re_invent-compass.git","type":"git","directory":"packages/mcp-server"},"description":"Scans your code and GitHub repositories to find the AWS re:Invent sessions that match your stack, books them safely with guardrails, and puts unofficial Boarding Passes on your phone. Independent community project, not affiliated with AWS.","maintainers":[{"name":"henniefrancis","email":"henniefrancis@gmail.com"}],"readme":"# reinvent-compass\n\nScans your code and GitHub repositories to find the AWS re:Invent sessions that match your stack, books them safely with guardrails, and puts unofficial Boarding Passes on your phone.\n\n**Unofficial. Your badge is your ticket.** re:Invent Compass is an independent community project. It is not affiliated with, endorsed by or sponsored by AWS or Amazon.\n\n## What it does\n\nCompass is a local MCP server and a Kiro Power. Your AI assistant uses it to:\n\n- read the session catalog and search it on your machine,\n- scan a folder of yours, or a dev folder of git repositories (read-only), to see which AWS services you use and how deeply, and which other technology you use (.NET, Node.js, Python, React, Docker and more),\n- read your GitHub repositories the same way, read-only and only after you confirm the list,\n- keep that tech list on your machine, answer \"What tech do I work on (the most)?\" and find sessions on a technology (\"Find me sessions on .NET\"),\n- plan a week of sessions that fits your tech, and write the plan as a Kiro spec in your workspace,\n- check every booking against your real schedule before it is made, and block clashes,\n- swap a booking for its repeat safely (it reserves the repeat first and cancels the original after),\n- issue unofficial Boarding Passes and hand them to your phone with a short-lived QR code.\n\nThe guardrail that checks bookings runs inside the Compass server. It runs in every client, with or without hooks. Compass is read-only by default: it changes your re:Invent schedule only after you turn writes on (see \"Read-only by default\").\n\nThe showcase site, with a browser demo you can try on any phone, is at https://reinvent-compass.vegas.\n\n## Install\n\nYou need Node.js 24 or newer. Compass starts with `npx --yes reinvent-compass@0.1.3`, which downloads the package on first use.\n\n### Kiro (the Power)\n\nThe Power is the `power/` folder of the repository: `plugin.json` and a matching `POWER.md` (Kiro needs one of the two at the root), `mcp.json`, three skills and a hook template.\n\n0. Kiro starts no MCP server until you allow it: in Settings, set \"Kiro Agent: Configure MCP\" to Enabled.\n1. In Kiro, open the Powers panel and choose Add Custom Power.\n2. Choose Import power from GitHub and give it the folder URL of the Power: `https://github.com/henniefrancis/aws-re_invent-compass/tree/main/power`.\n\nUse the folder URL, not the repository URL: Kiro reports \"Nothing to install from the repository root\" for the repository URL. You can also import `power/` from a folder after cloning the repository. A folder import registers the Power under the folder name, so its server is called `power-power-compass`, whatever `plugin.json` says; the hooks accept both `compass` and that name.\n\n**Updating the Power.** Kiro keeps its own copy of the repository in `~/.kiro/powers/repos/` and does not refresh it when you import the Power again, so a new import can keep the old version. To update:\n\n1. Remove the Power in the Powers panel.\n2. Delete its copy: each folder in `~/.kiro/powers/repos/` (on Windows, `%USERPROFILE%\\.kiro\\powers\\repos\\`) where `git remote -v` shows `henniefrancis/aws-re_invent-compass`. Delete only those folders, not `repos` itself, and leave the folders of other Powers alone.\n3. Import the folder URL again.\n4. If you installed the hooks, ask for them again so they use the new version.\n\nSeen in Kiro 1.4.86 on 4 November 2026.\n\nWithout the Power, add the server to `.kiro/settings/mcp.json` (this workspace) or `~/.kiro/settings/mcp.json` (all workspaces). Kiro reloads the file when you save it:\n\n```json\n{\n  \"mcpServers\": {\n    \"compass\": {\n      \"command\": \"npx\",\n      \"args\": [\"--yes\", \"reinvent-compass@0.1.3\"],\n      \"autoApprove\": [\"refresh_catalog\", \"find_sessions\"]\n    }\n  }\n}\n```\n\nKiro documentation: https://kiro.dev/docs/mcp/configuration/ (checked 17 October 2026).\n\n### Claude Desktop\n\nOpen the Claude menu, then Settings, then Developer, then Edit Config. The file is `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS and `%APPDATA%\\Claude\\claude_desktop_config.json` on Windows. Add:\n\n```json\n{\n  \"mcpServers\": {\n    \"compass\": {\n      \"command\": \"npx\",\n      \"args\": [\"--yes\", \"reinvent-compass@0.1.3\"]\n    }\n  }\n}\n```\n\nQuit Claude Desktop completely and start it again. Documentation: https://modelcontextprotocol.io/docs/develop/connect-local-servers (checked 17 October 2026).\n\n### VS Code\n\nCreate `.vscode/mcp.json` in the workspace, or run MCP: Open User Configuration for your profile. VS Code uses a `servers` object:\n\n```json\n{\n  \"servers\": {\n    \"compass\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"--yes\", \"reinvent-compass@0.1.3\"]\n    }\n  }\n}\n```\n\nVS Code asks you to trust a server the first time it starts, and can ask you to confirm each tool call. Documentation: https://code.visualstudio.com/docs/copilot/customization/mcp-servers (checked 17 October 2026).\n\n### Kiro CLI\n\nThe Kiro CLI uses the same `mcpServers` JSON as the IDE; use the snippet from the Kiro section. The CLI also has `kiro-cli mcp add`, `list`, `remove`, `import` and `status` commands with a `workspace` or `global` scope. Run `kiro-cli mcp --help` for the exact options of your version. Documentation: https://kiro.dev/docs/mcp/ and https://kiro.dev/docs/reference/cli-commands/ (checked 17 October 2026).\n\nEvery command here names the exact version of this package. Pinning it is deliberate: see the threat model below. Change it only to a version you have looked up on the npm page.\n\n## The tools\n\n| Tool                        | Class        | What it does                                                                                                   |\n| --------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------- |\n| `sign_in`                   | local action | Signs you in with your AWS Builder ID. Opens your browser.                                                     |\n| `sign_out`                  | local action | Revokes your sign-in and clears the stored tokens.                                                             |\n| `refresh_catalog`           | read         | Loads the session catalog into a private local cache.                                                          |\n| `find_sessions`             | read         | Searches and filters the cached catalog.                                                                       |\n| `scan_repo`                 | read         | Scans a folder (or a dev folder of repos) read-only for AWS services and tech.                                 |\n| `show_my_tech`              | read         | Lists your tech list on this machine: AWS services first, then other technology.                               |\n| `find_sessions_by_tech`     | read         | Finds catalog sessions on a technology, or on the tech you use the most.                                       |\n| `connect_github`            | local action | Connects the read-only Compass GitHub App. Shows a code to enter on GitHub.                                    |\n| `scan_github`               | read         | Reads your GitHub repositories, read-only, after you confirm the list.                                         |\n| `disconnect_github`         | local action | Deletes the GitHub sign-in on this machine.                                                                    |\n| `check_itinerary`           | read         | Checks your whole week, plus any sessions you propose, and lists it in time order. Writes nothing.             |\n| `show_schedule`             | read         | Lists your reservations, standby list and layovers with their ids. Writes nothing.                             |\n| `plan_week`                 | local action | Plans a week and writes it as a Kiro spec in the workspace, after you confirm.                                 |\n| `export_calendar`           | local action | Writes an `.ics` calendar file of your schedule.                                                               |\n| `reserve_with_guardrails`   | write        | Reserves 1 to 10 sessions after the guardrail passes. Changes your real schedule when writes are on.           |\n| `cancel_reservation`        | write        | Cancels a reservation, with the safe swap rule. Changes your real schedule when writes are on.                 |\n| `add_standby`               | write        | Favourites sessions as backups. Changes your real schedule when writes are on.                                 |\n| `remove_standby`            | write        | Removes a favourite. Changes your real schedule when writes are on.                                            |\n| `add_layover`               | write        | Creates, changes or deletes personal time. Changes your real schedule when writes are on.                      |\n| `issue_all_boarding_passes` | write        | Creates unofficial Boarding Passes for all your reserved sessions; approving the call is the one confirmation. |\n| `issue_boarding_pass`       | write        | Creates one Boarding Pass for a session you hold; without a session it asks which.                             |\n| `send_to_phone`             | write        | Makes a 15-minute link for your passes: shown as a link, a QR code in your browser, or both.                   |\n| `sync_passes`               | write        | Makes the passes match your schedule. It can void passes.                                                      |\n| `forget_me`                 | write        | Deletes your pass data on the server and on this machine.                                                      |\n\n## Approvals\n\nOnly two read tools may be auto-approved: `refresh_catalog` and `find_sessions`. They change nothing and read nothing of yours. `scan_repo` is read-only too, but it reads a folder on your machine, so approve each scan yourself. It scans freely only inside the folder Compass was started in; for any other folder it asks you to confirm first, and a client that cannot ask cannot scan one. A scan never changes where the plan is written: that is always the folder Compass was started in. `show_schedule` is read-only as well, but it reads your schedule, so approve each call yourself. It takes no input and lists your reserved sessions, standby list and layovers with the ids that `cancel_reservation`, `remove_standby` and `add_layover` take. `check_itinerary` reads your schedule too, to check your whole week, so approve each call yourself. `show_my_tech` and `find_sessions_by_tech` read your tech list on this machine, so approve them per call too. `connect_github`, `scan_github` and `disconnect_github` touch your GitHub account: approve each call yourself. `scan_github` also asks you to confirm the repositories before it reads any, and a client that cannot ask cannot run it.\n\n**Write tools must never be auto-approved.** That means every tool marked write above, including `sync_passes`, which can void passes. Approve each call yourself. Where your client supports it, Compass also asks you to confirm in the client before it changes your schedule, listing the session ids, codes, titles and any warnings. Declining writes nothing.\n\nThe Power does not ship an `autoApprove` list. If you add one in your own configuration, list only those two read tools.\n\n## Hooks (Kiro only)\n\nHooks are an extra check that only Kiro runs. The Power includes a hook template, and the `install-hooks` skill writes it to `.kiro/hooks/reinvent-compass.json` after you say yes.\n\n- Kiro sends every Power tool call as one built-in tool, `kiro_powers`. The first hook matches it, and `pre-write-guardrail` picks out the Compass booking calls inside it, runs the same check as the server against your last read schedule and the cached catalog, and blocks the call when the guardrail blocks it.\n- The second hook blocks any write through the remote `awsevents` server, so bookings go through Compass. Its matcher is lower case, because Kiro matches regular expressions against the lower-cased tool name.\n- A hook can only block, with exit code 2. Anything a hook prints when it lets a call through never reaches the agent, so there is no sync reminder hook: the Compass tool results say when to run `sync_passes`.\n\nThe server checks every booking again, so nothing is unsafe in a client without hooks. A hook reads its input from stdin only, makes no network call and starts no other program. If it cannot judge a call, it says so and lets the call through. `npx --yes reinvent-compass@0.1.3 hook <name>` accepts only the names `pre-write-guardrail` and `post-write-sync` (the template uses only the first), and exits with code 0 or 2.\n\n## The official AWS Events server (read only)\n\nAWS publishes its own MCP server at `https://api.awsevents.com/mcp` (https://docs.aws.amazon.com/events/latest/devguide/mcp-server.html). It is fine for reading events and sessions. Do not use its write tools (ReserveSessions, CancelReservation, AssociateFavorites, DisassociateFavorite, CreatePersonalTime, UpdatePersonalTime, DeletePersonalTime): they skip the Compass guardrail. If you add it yourself, add it to the workspace `.kiro/settings/mcp.json` (not to a Power) and list those seven in `disabledTools` by their full names: `AWSEventsPublicApi-Mcp-prod___ReserveSessions`, `AWSEventsPublicApi-Mcp-prod___CancelReservation`, `AWSEventsPublicApi-Mcp-prod___AssociateFavorites`, `AWSEventsPublicApi-Mcp-prod___DisassociateFavorite`, `AWSEventsPublicApi-Mcp-prod___CreatePersonalTime`, `AWSEventsPublicApi-Mcp-prod___UpdatePersonalTime` and `AWSEventsPublicApi-Mcp-prod___DeletePersonalTime`. A bare name such as `ReserveSessions` hides nothing. The Power does not bundle the server, because Kiro does not honour `disabledTools` inside a Power (ADR-024), and the hook template blocks the seven write tools as a second layer.\n\n## Read-only by default\n\nCompass never changes your re:Invent schedule unless you ask it to in its settings. Signed in with your Builder ID, it reads the live catalog and your real reservations, standby list and layovers, and runs the booking guardrail as usual. By default the schedule write tools (`reserve_with_guardrails`, `cancel_reservation`, `add_standby`, `remove_standby` and `add_layover`) ask nothing and reply with what they would have done, that nothing changed, and that you can make the change in the re:Invent app. Underneath, every Events API write is refused before any request, so no path can change your schedule by accident. Boarding Passes still work, because they live on the Compass pass service, not in your re:Invent schedule.\n\nTo let Compass make changes, each one still confirmed by you first, set `COMPASS_ALLOW_WRITES=1` in the environment of the Compass MCP server. In Kiro that is the `env` of the server in your MCP settings: the `compass` entry for a manual install, or the Compass server the Power added (shown as `power-power-compass` when imported from a folder). While writes are on, every schedule reply in the chat starts with \"Writes are on\", and the server also logs one line. Only you should change this setting; the Power tells the agent never to.\n\n```json\n\"env\": { \"COMPASS_ALLOW_WRITES\": \"1\" }\n```\n\nSimulated mode never calls the Events API, so its made-up bookings work without the setting.\n\nWhere your client supports it, Compass also asks you to confirm inside the tool (MCP elicitation). A client that declares the feature but cannot show the question answers every one as a no. Set `COMPASS_ELICITATION=off` for such a client: Compass then asks nothing, and your approval of the tool call is the confirmation. The Kiro Power sets it, because Kiro cancels the questions a server asks through a Power.\n\n## Passes on your phone\n\n`send_to_phone` takes `show`: `link` gives a 15-minute link in the chat, `qr` opens a page with a QR code in your browser for your phone camera to scan (the chat then shows no link), and `both` does both. Without `show` it creates nothing and asks, and the Power tells your assistant to ask \"Link or QR code?\" first. The QR page is a static file in a new private folder in your temp folder (file mode 0600 on macOS and Linux; on Windows your own `%TEMP%` folder protects it), with no script and nothing loaded from outside. Compass deletes it when the link expires, when it shows a newer one, when `forget_me` runs and when the server stops, and clears out any page a crashed server left behind. If the browser cannot be opened, the QR code comes back in the chat instead. If no page appears, ask for a link.\n\nOn the phone, all the passes of the week sit together as one group in the wallet, with \"re:Invent Compass\" as the issuer. When a session's time, venue or room changes, `sync_passes` updates its pass and the phone shows a change alert. A cancelled session's pass is voided, and every pass expires when its session ends. `forget_me` voids your passes, but a pass already in a wallet stays on the phone until you remove it.\n\n## Simulated mode and the demo\n\nSet `COMPASS_MODE=simulated` to run the whole server on made-up data: a synthetic catalog, a signed-in attendee, a pinned clock, and an in-process pass service. No browser opens, no sign-in happens and nothing is sent anywhere. Every result starts with `SIMULATED MODE: no real data.` Simulated files live in a `simulated` folder, apart from real data. Simulated mode is refused when `NODE_ENV=production` unless `COMPASS_ALLOW_SIMULATED=1` is set.\n\nTry the whole flow in one command:\n\n```\nnpx --yes reinvent-compass@0.1.3 demo\n```\n\nIt forces simulated mode and runs ten steps through the real tools on a copy of a sample repo: sign in and load the catalog, scan the repo, plan the week, a clash that is blocked, a safe swap, reserve the session that clashed, issue passes, hand them to a phone with a QR code, cancel a session, and void its pass. It prints which step failed and exits 1 if one does. `demo --repo <folder>` scans a folder of yours instead (a copy is used, so your folder is not changed).\n\n## Your tech list and GitHub\n\nEvery scan adds to one tech list on your machine: the AWS services you use (with depth) and the other technology you use, such as .NET, C#, Node.js, TypeScript, Python, Java, Go, React, Angular, Docker, Kubernetes and Terraform. Ask \"What tech do I work on?\" or \"What do I use the most?\" (`show_my_tech`), and \"Find me sessions on .NET\" (`find_sessions_by_tech`, which also knows \"dotnet\" and \"C#\"). `plan_week` ranks sessions by the whole list.\n\n- **A dev folder.** Point `scan_repo` at a folder of projects. Each git repository one or two levels down is scanned on its own, up to 50, and the reply says how many it scanned and skipped.\n- **The AWS SDK for .NET** counts as AWS evidence: `AWSSDK.*` package references in `.csproj` files and `new Amazon<Name>Client(` in C#.\n- **GitHub, read-only.** `connect_github` signs you in to the Compass GitHub App with a code you enter on github.com. The app has only Contents: read and Metadata: read, so it can never change your code. When you install it on GitHub you choose which accounts, organisations and repositories it may read; an organisation's owner must approve it there. `scan_github` lists the repositories it is about to read and reads nothing until you confirm. Forks are left out unless you ask (`includeForks`). Each repository is downloaded as an archive into memory, scanned under a time and size limit and dropped; nothing is written to disk.\n- **Disconnect.** `disconnect_github` (or `forget_me`) deletes the GitHub sign-in on this machine. To remove the app on GitHub as well, uninstall it at https://github.com/settings/installations and revoke it at https://github.com/settings/apps/authorizations.\n\n## What leaves your machine\n\n- **Your sign-in tokens** stay in your operating system keychain (or in memory only, if there is no keychain). The access token goes only to `api.awsevents.com`, the refresh token only to `oauth.awsevents.com`, and the ID token only to the Compass pass service.\n- **Your repository** is read on your machine. Only service and technology names, a depth per service and counts are used; no file name, path or content leaves the scanner.\n- **Your tech list** is kept in your app-data folder (mode 0600) and removed by `forget_me`. Each project is stored under a one-way hash, so no folder path or repository name is kept. It is never sent anywhere.\n- **GitHub**: the GitHub tokens stay in your operating system keychain (or in memory only) and go only to `github.com` and `api.github.com`. Repository archives come from `codeload.github.com` without the token, are read in memory and are never saved. Nothing about your repositories goes to Compass or to AWS.\n- **Your schedule** is read from the AWS Events service. A copy is kept in your app-data folder (mode 0600) and removed by `forget_me`.\n- **Session text** from the catalog is shown to your assistant as labelled data, never as instructions. Session abstracts are never passed on.\n- **Boarding Passes**: when you issue passes, the pass fields (session code, title, venue, room, times, and the walks before and after the session) go to the Compass pass service; Compass never sends your name. Apple receives a pass only if you add it to Apple Wallet. Google Wallet gets its pass object when the pass service issues the pass, so the \"Add to Google Wallet\" link works. The ID token is checked and never stored.\n- **Nothing is logged** that holds a token, an email address, a link or a file path. Logs go to stderr, never to stdout.\n- **The week spec** is written into your workspace folder, after you confirm the folder. If the folder is a public repository the plan would show where you will be and when, so Compass offers to add it to `.gitignore`.\n\n## How depth is worked out\n\nOther technology gets a score instead of a depth: 1 for each file of its language, plus 5 for each manifest or package that declares it. `show_my_tech` ranks it by the number of projects that use it, then by score.\n\nThe scanner counts evidence per AWS service from Terraform, CDK (TypeScript), AWS SDK for JavaScript v3, boto3 (Python), the AWS SDK for .NET (`.csproj` and C#) and package manifests.\n\n- `none`: no evidence.\n- `exploring`: only imports, or packages listed as dependencies.\n- `building`: any real resource, construct, client or command.\n- `production`: building, with both infrastructure and code usage, and either a score of 12 or more or a production marker in the repository.\n\nThe score is 2 for each resource, construct or client, plus 1 for each command, import or dependency. A depth maps to a suggested session level: exploring is level 100 (200 with more evidence), building is 300 and production is 400. A boto3 client or resource call counts like an SDK client.\n\n## Threat model\n\n| Risk                                                                                            | What Compass does                                                                                                                                                                                                                                                                                 |\n| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| A session title or a file in your repo tries to talk to the assistant (prompt injection)        | Catalog text comes back as labelled JSON data. Write tools are never auto-approved. The guardrail runs in the server.                                                                                                                                                                             |\n| Another program on your machine steals tokens                                                   | Tokens live in the OS keychain. The sign-in server binds to 127.0.0.1, takes one request and closes.                                                                                                                                                                                              |\n| A token or email ends up in a log                                                               | A redacting logger on stderr, and tests that prove no token or email reaches a log or an error.                                                                                                                                                                                                   |\n| Someone books through the remote `awsevents` server and skips the guardrail                     | Do not use its write tools. The hook template blocks them in Kiro.                                                                                                                                                                                                                                |\n| The wrong program runs when you start Compass with `npx` (the local copy risk)                  | `npx` can prefer a copy of a package from the folder you are in. Pin the version (`reinvent-compass@0.1.3`), do not start Compass from inside a repository you do not trust, and prefer a global install of a pinned version.                                                                     |\n| Someone else publishes a package under the same npm name before the owner does (name squatting) | Before the first publish the owner had to claim the npm package name `reinvent-compass`. The owner now holds it and publishes from the owner's account with provenance, starting with version 0.1.0 on 3 November 2026. Install only the pinned version, and check the publisher on the npm page. |\n| A hostile repository (a slow pattern, a huge archive, a deep or `..` path, links)               | Every scan runs in a worker with a hard time budget. Archives stop at 100 MB compressed or 500 MB unpacked, files over 1 MB and binary files are skipped, links and `..` paths are never followed, and nothing is written to disk.                                                                |\n| A GitHub token is stolen or misused                                                             | The Compass GitHub App can only read code. Tokens live in the OS keychain, are redacted from every log and error, go only to `github.com` and `api.github.com`, and are never sent on the archive redirect. `disconnect_github` deletes them.                                                     |\n| A workspace edits the hook to skip the check                                                    | The hook is a convenience. The server runs the same check.                                                                                                                                                                                                                                        |\n| Supply chain                                                                                    | Exact version pins in the Power and in the hook template.                                                                                                                                                                                                                                         |\n\n## Troubleshooting\n\n- **\"No OS keychain is available\" (tokens held in memory only)**: on Linux, tokens need the Secret Service (for example GNOME Keyring). Without it, Compass holds them in memory and you sign in again each session.\n- **Sign-in does not open a browser**: Compass prints the sign-in address on stderr. Open it by hand. Sign-in uses a local port from 8484 to 8489, so make sure one of them is free.\n- **\"Run refresh_catalog first\"**: the catalog cache is empty. Run `refresh_catalog`.\n- **A hook says Compass could not check a call**: nothing is wrong. The server checks it.\n- **A write says it is unconfirmed**: the request went out, but the schedule could not be read back. Check your schedule before trying again. Compass does not send it twice.\n","readmeFilename":"README.md","keywords":["mcp","mcp-server","model-context-protocol","kiro","kiro-power","aws","reinvent","re:Invent","conference","sessions","schedule","boarding-pass","wallet","first-timer"]}