8000 chore: share the design system and Hookdeck CLI helpers across demos via _shared/ and a sync check by leggetter · Pull Request #43 · hookdeck/hookdeck-demos · GitHub
[go: up one dir, main page]

Skip to content

chore: share the design system and Hookdeck CLI helpers across demos via _shared/ and a sync check - #43

Merged
leggetter merged 2 commits into
mainfrom
chore/shared-components
Nov 11, 2026
Merged

leggetter merged 2 commits into
mainfrom
chore/shared-components

Conversation

@leggetter
Copy link
Copy Markdown
Collaborator

_shared/ becomes the source of truth for the Hookdeck design system and the Hookdeck CLI and listen helpers. Demos stay standalone, so npx giget@latest gh:hookdeck/hookdeck-demos/<vendor>/<demo> still gives a working demo, and CI stops the copies drifting.

How it works

  • _shared/manifest.json lists 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 a GENERATED.md.
  • npm run sync-shared -- --check fails on any drift, including stray files in a copied directory.
  • .github/workflows/shared.yml runs on every PR and push to main, with no paths: filter: the drift check, plus a fresh-copy check per manifest demo (git archive of the folder alone, install, typecheck).

What moves

  • Design system: _shared/ds/ from hookdeck/mcp-events-forward-proxy/viz/ds/, synced into that demo, deepgram/stt-tts, hookdeck/binary-payloads and hookdeck/transformations. The copies were identical apart from assets/brand/logo-icon.svg, which only the forward proxy had; all four now get it.
  • Hookdeck helpers: _shared/hookdeck/hookdeck-cli.ts (createHookdeckCli()) and hookdeck-listen.ts (runListen()), merged from five diverged copies. deepgram/stt-tts adopts them with the same CLI arguments as before.
  • Source auth: upsertSource() sets config.auth with a PUT /sources/{id} after the CLI upsert, because CLI 3.1.0 silently dropped the signing secret for a VAPI source and left verification off. GET /sources redacts auth, so a signed plus unsigned probe request is the only end-to-end proof; a code comment says so.
  • README: "Get one demo" and "Shared code" sections.

Checked locally

  • Sync, then --check, passes. Editing a copy or adding a stray file makes --check fail and name the file.
  • Fresh-copy install and typecheck pass for all four manifest demos.
  • npx giget@latest gh:hookdeck/hookdeck-demos/deepgram/stt-tts works against main.
  • Not run against the live Hookdeck API: Deepgram's setup and the new auth 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

Posted by an AI agent with human oversight.

leggetter and others added 2 commits November 11, 2026 15:29
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>
@leggetter
leggetter merged commit 28d3a78 into main Nov 11, 2026
6 checks passed
@leggetter
leggetter deleted the chore/shared-components branch November 11, 2026 17:28
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

0