Repository navigation
chore: share the design system and Hookdeck CLI helpers across demos via _shared/ and a sync check - #43
Merged
Conversation
Shared code now has a single source of truth in _shared/. A manifest lists which demo takes which piece; npm run sync-shared copies it (with a generated header) and --check fails on drift. CI runs the check on every PR and push, plus a fresh-copy install and typecheck per manifest demo. deepgram/stt-tts adopts the merged CLI and listen helpers; all four ds copies come from _shared/ds. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The CLI silently ignores auth in --source-config / --config-file for at least VAPI sources (3.1.0). upsertSource now takes an `auth` field and PUTs it to /sources/{id}. GET /sources redacts auth, so confirmation is the PUT response only (documented).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
_shared/becomes the source of truth for the Hookdeck design system and the Hookdeck CLI and listen helpers. Demos stay standalone, sonpx giget@latest gh:hookdeck/hookdeck-demos/<vendor>/<demo>still gives a working demo, and CI stops the copies drifting.How it works
_shared/manifest.jsonlists which demo takes which shared piece and where.npm run sync-shared(repo root) copies them in. Text copies carry a "Generated from_shared/<path>; edit there" header; copied directories get aGENERATED.md.npm run sync-shared -- --checkfails on any drift, including stray files in a copied directory..github/workflows/shared.ymlruns on every PR and push to main, with nopaths:filter: the drift check, plus a fresh-copy check per manifest demo (git archiveof the folder alone, install,typecheck).What moves
_shared/ds/fromhookdeck/mcp-events-forward-proxy/viz/ds/, synced into that demo,deepgram/stt-tts,hookdeck/binary-payloadsandhookdeck/transformations. The copies were identical apart fromassets/brand/logo-icon.svg, which only the forward proxy had; all four now get it._shared/hookdeck/hookdeck-cli.ts(createHookdeckCli()) andhookdeck-listen.ts(runListen()), merged from five diverged copies.deepgram/stt-ttsadopts them with the same CLI arguments as before.upsertSource()setsconfig.authwith aPUT /sources/{id}after the CLI upsert, because CLI 3.1.0 silently dropped the signing secret for aVAPIsource and left verification off.GET /sourcesredactsauth, so a signed plus unsigned probe request is the only end-to-end proof; a code comment says so.Checked locally
--check, passes. Editing a copy or adding a stray file makes--checkfail and name the file.npx giget@latest gh:hookdeck/hookdeck-demos/deepgram/stt-ttsworks against main.PUT. This is the repo's first workflow, so this PR is its first CI run.The four voice AI demos in progress adopt the helpers when they rebase onto this.
🤖 Generated with Claude Code