Skip to content

docs(core): assertLive gets its section on the testing-harness page (#2075) - #2200

Merged
lex00 merged 1 commit into
mainfrom
docs/2075-assert-live
Sep 7, 2026
Merged

docs(core): assertLive gets its section on the testing-harness page (#2075)#2200
lex00 merged 1 commit into
mainfrom
docs/2075-assert-live

Conversation

@lex00

@lex00 lex00 commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

Closes #2075.

#1857 shipped assertLive on the testing harness and used it in examples/testing-harness-aws, but its third acceptance item, a section on the testing-harness page, never landed. grep -rl assertLive docs/src/content/docs was empty.

This adds ## Asserting the deploy is live to docs/src/content/docs/local-testing/testing-harness.mdx, between the API summary and the project requirements, plus a one-line assertLive entry in the DeployedStack list. It covers the two call shapes, the three failure modes and their distinct error types, that "not observed" is never a pass, endpoint resolution matching deploy and destroy, and the v1 boundary of existence and status only. The example is lifted from the real e2e test and links to it.

No cross-links were added from the lifecycle or effect-receipts pages, since neither mentions live assertions today.

Gates

node scripts/lint-docs-sentences.mjs   4111 gated finding(s), no regressions (4111 baselined)
node scripts/check-docs-diataxis.mjs   clean
npx tsc --noEmit                       clean

The two in-page anchors were checked by hand against their headings; the repo has no local link checker outside the CI lychee run.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FoXyD9UvKQ5ZdhiR9JT1yB

… page

#1857's third acceptance item never shipped: PR #1997 added assertLive to
the DeployedStack handle and the worked example used it, but touched no
docs, so the local-testing/testing-harness page had zero mentions of it.

The new "Asserting the deploy is live" section covers the signature, the
two call shapes, the three failure modes (observed absent, not observed,
foreign marker) and that each throws rather than passes, endpoint
resolution being identical to deploy/destroy, and the v1 boundary against
deep observation (#1014). The example is lifted from
examples/testing-harness-aws/harness.e2e.test.ts, the worked example named
in both issues.

Fixes #2075.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FoXyD9UvKQ5ZdhiR9JT1yB
@lex00
lex00 merged commit 72d7e01 into main Sep 7, 2026
6 checks passed
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.

docs: assertLive has no section on the testing-harness page — #1857's third acceptance item did not ship

1 participant