Skip to content

feat: Outpost skill & examples, scenario-tester evals, and event-gateway CLI guidance#20

Merged
leggetter merged 13 commits into
mainfrom
feat/outpost-skill-examples
Apr 24, 2026
Merged

feat: Outpost skill & examples, scenario-tester evals, and event-gateway CLI guidance#20
leggetter merged 13 commits into
mainfrom
feat/outpost-skill-examples

Conversation

@leggetter
Copy link
Copy Markdown
Collaborator

@leggetter leggetter commented Apr 22, 2026

Summary

Outpost skill (original PR scope)

  • Adds runnable Outpost reference applications for Next.js and FastAPI + React, plus progressive-disclosure integration maps under skills/outpost/references/.
  • Refactors skills/outpost/SKILL.md to use https://hookdeck.com/docs/outpost as the single source of truth, prioritize llms.txt plus curl / TypeScript / Python / Go quickstarts, and add explicit fast-path guidance for agents.
  • Fixes factual and link accuracy: updates stale references, corrects destination support status (Kafka supported, EventBridge planned), aligns self-hosted quickstart URLs, and repairs integration-map links after section heading changes.

Additional changes (stacked on this branch)

  • Agent scenario tester: Optional LLM-as-judge (--judge / RUN_LLM_JUDGE), load repo-root .env (see .env.example), skillUnderTest plus outpost-managed-quickstart scenario, judge transcript includes generated source/config on disk, and a stricter Stage 01 rubric (human-facing https://hookdeck.com/docs/cli URL without .md, or an explicit CLI install command). TESTING.md and tools/agent-scenario-tester/README.md updated.
  • Event-gateway skill: Canonical Hookdeck CLI prerequisite in references/cli-workflows.md; SKILL and stage references link to it with short preambles. Example READMEs document official install (hookdeck.com/docs/cli#installation) and brew / npm commands for humans.
  • Outpost follow-ups: Prefer Hookdeck Console for throwaway webhook destination URLs in docs; do not use fictional https://hookdeck.com/webhook/create or generic echo sites (e.g. webhook.site) by default; scenarios.yaml prompt for outpost-managed-quickstart aligned. Removed PostHog cross-links from skill and integration maps in favor of neutral wording.

Validation

  • Full runs: ./scripts/test-agent-scenario.sh run receive-webhooks express --judge and run outpost-managed-quickstart express --judge (heuristic + judge artifacts verified).
  • Link and content spot-checks against live Hookdeck docs (overview, api, llms.txt, language quickstarts, CLI install).

- Add full-stack Next.js and FastAPI+React reference apps under skills/outpost/examples
- Add integration maps under skills/outpost/references for progressive disclosure
- Extend outpost SKILL.md with example pointers and testing notes
- Wire test-examples.sh and GitHub Actions for outpost SaaS examples
- Document outpost example testing in TESTING.md and CONTRIBUTING.md
- Adjust .gitignore for example lockfiles and artifacts

Made-with: Cursor
…piVersion in seed

Align seed script Stripe client with the apiVersion expected by the installed stripe package.

Made-with: Cursor
- Lazy Stripe client; STRIPE_MOCK=1 and dev catalog mock without secret key
- Guard checkout callback and webhook when Stripe is disabled
- Document STRIPE_MOCK and no-key dev behavior in .env.example and README

Made-with: Cursor
When adding a hookdeck destination, show steps and a new-tab link to
dashboard.hookdeck.com/connect for obtaining the connection token.

Made-with: Cursor
- SKILL: maps-first, reference-only examples, stack snapshot, API Access note
- Integration maps: transfer patterns to user repo; manifest pointers
- CONTRIBUTING: sync SKILL snapshot when bumping Outpost examples
- TESTING: note STRIPE_MOCK=1 for next build
- fastapi-saas: outpost_sdk >=1.0.0,<2

Made-with: Cursor
Update Outpost skill guidance to use hookdeck.com/docs/outpost as the single source of truth, surface llms.txt and language quickstarts first, and trim in-file operational detail so agents choose the smallest successful path faster. Also correct supported destination claims (Kafka supported, EventBridge planned), fix reference links after section renames, and keep managed/self-hosted API pointers consistent with current docs.

Made-with: Cursor
@leggetter leggetter changed the title feat(outpost): SaaS reference examples, integration maps, and CI docs(outpost): canonical docs, quickstart-first skill flow, and reference maps Apr 24, 2026
Revert accidental inclusion of local agent-scenario-tester changes so this PR stays scoped to Outpost skill and documentation updates.

Made-with: Cursor
- Document hookdeck gateway as default for Event Gateway; deprecate root connection
- Collapse metrics table to match actual CLI (queue/issue views via measures)
- Cross-link hookdeck umbrella skill to gateway command model

Made-with: Cursor
…bric

- Add optional --judge / RUN_LLM_JUDGE (Anthropic Messages API); write llm-score.json and append to report.md.
- Load repo-root .env before commands; add .env.example for required env vars.
- Support skillUnderTest per scenario (event-gateway, outpost, hookdeck); add outpost-managed-quickstart and tighten receive-webhooks Stage 01 (human hookdeck.com/docs/cli URL without .md, or install commands).
- Include generated source/config in judge transcript; pass framework into judge pipeline.
- Update TESTING.md, scenario script header, and agent-scenario-tester README; add dotenv and @types/js-yaml.

Made-with: Cursor
…e READMEs

- Add canonical Hookdeck CLI prerequisite in cli-workflows.md; link from SKILL and stage references with short preambles.
- Example READMEs document official install (hookdeck.com/docs/cli#installation) and brew/npm commands instead of skill-internal paths.

Made-with: Cursor
- Prefer https://console.hookdeck.com for throwaway webhook URLs; forbid fake hookdeck.com/webhook paths; avoid webhook.site by default (SKILL, scope, verify, nextjs-saas README).
- Replace PostHog progressive-disclosure links with neutral guidance in SKILL and integration maps.

Made-with: Cursor
@leggetter leggetter changed the title docs(outpost): canonical docs, quickstart-first skill flow, and reference maps feat: Outpost skill & examples, scenario-tester evals, and event-gateway CLI guidance Apr 24, 2026
@leggetter leggetter marked this pull request as ready for review April 24, 2026 16:10
Replace the outdated MCP roadmap with shipped CLI MCP (beta): operational
query/inspect scope, correct hookdeck gateway mcp entrypoint, and links to
human-facing docs (/docs/mcp and /docs/cli). Document in AGENTS.md that root
README must not use hookdeck.com .../*.md URLs.

Made-with: Cursor
@leggetter leggetter merged commit 94c610d into main Apr 24, 2026
8 checks passed
@leggetter leggetter deleted the feat/outpost-skill-examples branch April 24, 2026 16:32
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