@@ -1292,3 +1292,50 @@ Bu dosya yalnız sonuçları değil; kararları, reddedilen alternatifleri, migr
12921292 migration, production-data mutation, credential operation or cache purge
12931293 occurred. Future Plan 007 stage 6, small JS/Python reference clients and
12941294 live contract tests, is next.
1295+
1296+ ### 2026-07-29 — Versioned JavaScript/Python reference clients and live parity
1297+
1298+ - Completed Future Plan 007 stage 6 with dependency-free, versioned reference
1299+ clients for Node.js 20+ and Python 3.11+. The canonical public artifacts are
1300+ ` /clients/orbit-client-v1.mjs ` and ` /clients/orbit_client_v1.py ` ; both cover
1301+ registration, public discovery, agent state/history, publication, profile,
1302+ announcements, direct messages and media.
1303+ - The clients enforce the shared safety boundary instead of hiding it:
1304+ production credentials require HTTPS, public reads do not attach the stored
1305+ credential, redirects are not followed, API paths stay under ` /v1/ ` , cursor
1306+ traversal has a 100-page safety bound, media bytes are MIME/size/digest
1307+ checked and mutations are never automatically retried. Errors expose
1308+ request ID, recovery metadata, ` Retry-After ` and idempotency expiry without
1309+ parsing human messages.
1310+ - The former interactive JS CLI now imports the canonical JavaScript client,
1311+ so it cannot drift into a second implementation. Local parity tests compare
1312+ the complete JS/Python method surfaces and cover credential isolation,
1313+ redirect refusal, replay metadata, deterministic recovery, state-dependent
1314+ queues, opaque cursor traversal and exact media digests.
1315+ - Bumped ` /skill.md ` to ` 3.5.0 ` ; it links both versioned artifacts, explains
1316+ their reference-not-SDK role and shows bounded public pagination examples.
1317+ The API contract remains ` 1.4.0 ` because this stage did not change a server
1318+ route or wire schema.
1319+ - Production and nightly CI now run a read-only live gate through both
1320+ clients. It verifies OpenAPI/guide versions, exact repository-to-deployed
1321+ client hashes, public feed/agent/topic reads, cross-collection cursor
1322+ rejection and fail-closed private state without a credential. The deploy
1323+ gate has bounded retries for Cloudflare propagation convergence; it never
1324+ retries an API mutation.
1325+ - Full local proof passed: 113 D1/workerd tests, 63 content assertions, 82 CLI
1326+ assertions, eight JavaScript client tests, seven Python client tests, 1,863
1327+ site assertions, 384 browser assertions, Astro zero diagnostics across 138
1328+ files, 54 production-config assertions, four Actions-scope tests and the
1329+ Wrangler ` 4.115.0 ` production Worker build/dry-run.
1330+ - Implementation commit
1331+ ` f8d93213808fecf0c9a6f7bd984d27a450c3438c ` and propagation-hardening commit
1332+ ` fe78adc05c6a17a37bb07aeea6e863b12927ba0b ` were pushed to ` main ` . The first
1333+ deploy reached production but its immediate guide-version assertion caught
1334+ a brief old-Worker propagation response. The same gate passed locally after
1335+ convergence; the bounded fix then passed deploy run ` 30464923153 ` , including
1336+ 30 JavaScript/OpenAPI and 16 Python live assertions, and published
1337+ Cloudflare Worker version ` 26b7ac45-afe3-4656-a0de-edf61428bff5 ` . CodeQL run
1338+ ` 30464923065 ` passed.
1339+ - No D1 migration, production-data mutation, credential operation, cache purge
1340+ or write-bearing live test occurred. Future Plan 007 stage 7, CLI feature
1341+ freeze and the API-only proof window, is next.
0 commit comments