Skip to content

chore: pre-public polish (docs, sample host, NOTICE, drop unused test.proto) - #12

Merged
greggTime merged 1 commit into
mainfrom
chore/pre-public-polish
Sep 11, 2026
Merged

greggTime merged 1 commit into
mainfrom
chore/pre-public-polish

Conversation

@greggTime

Copy link
Copy Markdown
Collaborator

Summary

Final polish before this sample goes public. No functional changes to the bridge; docs, sample-data, and licensing hygiene plus removal of one unused proto.

Changes

Docs: Node baseline (correctness). After EOL Node 20 was dropped in the dependency upgrade (engines.node is >=22; CI tests 22.x/24.x), several docs still said "Node 20+". Corrected to 22+ in:

  • docs/03-deployment.md (Prerequisites)
  • docs/04-testing-runbook.md (Host assumptions, and the Step 1 preflight node -p check that green-lit Node 20 before the app rejected it)
  • .github/contributing.md (Development setup)

Docs: Messages tab (consistency). manifest.json sets messages_tab_enabled: false (Home tab only). The README and deployment runbook claimed the Messages tab was enabled; corrected to match the manifest.

Sample data. telemetry.vendor.io is a real registrable domain; replaced with the reserved telemetry.example.io in scripts/send-samples.ts and src/capture/sample-events.ts, matching the surrounding .example sample hosts.

proto/NOTICE. Quote NVIDIA's SPDX header in its real order (SPDX-FileCopyrightText then SPDX-License-Identifier).

Remove proto/test.proto. An unused upstream persistence-test fixture. The client loads openshell.proto and its imports (datamodel / options / sandbox) only; nothing references test.proto.

Verification

  • npm run typecheck — clean
  • npm test — 202 / 202 pass
  • npm run build — clean

Co-Authored-By: Claude svc-devxp-claude@slack-corp.com

….proto)

Final cleanup before the repo goes public. No functional changes to the bridge.

- Docs: correct the Node baseline from 20+ to 22+ (matches engines.node and the
  CI matrix after dropping EOL Node 20) in the deployment runbook, the testing
  runbook (prose plus the Step 1 preflight check), and the contributing guide.
- Docs: reconcile the Messages tab with the manifest. manifest.json sets
  messages_tab_enabled:false (Home tab only), so the README and deployment
  runbook no longer claim the Messages tab is enabled.
- Sample data: use the reserved telemetry.example.io instead of the real
  registrable telemetry.vendor.io in send-samples and sample-events.
- proto/NOTICE: quote NVIDIA's SPDX header in its actual order
  (SPDX-FileCopyrightText then SPDX-License-Identifier).
- Remove proto/test.proto: an unused upstream persistence-test fixture the
  bridge never loads (it loads openshell.proto and its imports only).

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
@greggTime
greggTime merged commit faf3a61 into main Sep 11, 2026
2 checks passed
@greggTime
greggTime deleted the chore/pre-public-polish branch September 11, 2026 02:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant