Skip to content

verify(sdk): confirm the published @netscript/sdk JSR landing page shows the canonical query dialect #1606

Description

@rickylabs

Summary

#1377's final acceptance row is observational — it can only be checked against a published
artifact, so no pull request can close it:

[post-merge] The published JSR landing page for @netscript/sdk shows the canonical dialect.

The content that satisfies it merged in PR #1541 (packages/sdk/README.md now leads with
createQueryFactories rather than the demoted createServiceQueryUtils), and
jsr-package-settings.json:6 sets readmeSource: "readme", so that file is the JSR landing
page. But whether jsr.io renders it correctly is only observable after @netscript/sdk publishes.

This issue carries that verification forward so #1377 can close on work that is actually done,
rather than being closed with an unverified row and no tracker.

Why it exists as a separate issue

milestone-run.md § Honesty rules: "Observational criteria cannot be closed by a PR — route them to
a verification issue in the next milestone (#1090 pattern) at the moment you notice it, not at cut
time."

The docs lane recorded this obligation when it opened, and the gate PR (#1586) carries
Closes #1377. Without this issue, that merge would close #1377 with a row nobody can honestly tick
and nothing tracking it — the stranded-scope failure the close-gate rules exist to prevent.

Verification steps

After the next @netscript/sdk publish:

  1. Open https://jsr.io/@netscript/sdk and confirm the landing page renders the README from
    packages/sdk/README.md (per readmeSource: "readme").
  2. Confirm the page leads with createQueryFactories as the golden-path query API.
  3. Confirm createServiceQueryUtils appears, if at all, only as the narrower non-golden-path helper
    — matching docs/site/reference/sdk/index.md:111, which distinguishes its queryOptions({ input })
    shape from the golden-path queryOptions(input) and notes it has no server KV tier.
  4. Confirm no lib/api-clients.ts reference survives on the rendered page.

Acceptance criteria

Boundaries

Provenance

Filed by the 0.0.6 documentation-lane orchestrator, prompted by the fallback IMPL-EVAL of PR #1586,
which found the routing commitment recorded in that slice's plan.md had been dropped in its
context-pack.md and never executed — the row was correctly left unticked, but no verification issue
existed to carry it.

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions