Skip to content

fix: align public help and lifecycle docs for paired a6 - #131

Merged
anycodes merged 3 commits into
mainfrom
fix/sandbox-help-imports
Oct 25, 2026
Merged

anycodes merged 3 commits into
mainfrom
fix/sandbox-help-imports

Conversation

@anycodes

@anycodes anycodes commented Oct 25, 2026 •

Copy link
Copy Markdown
Contributor

Description

Four ordinary public Sandbox class help examples still import absent upstream SDK packages after the scoped Template correction in a5. Current bilingual API/lifecycle pages also mix unsupported Provider interpreter calls, retired configuration names and an unimplemented global cleanup/type menu. Correct help and current examples using actual standard/interpreter entries and owned base/command/file lifecycle. Prepare minimum lockstep client/server 0.4.0a6; callable behavior, valid standard parameters, exports and dependencies are unchanged.

Refs #130. Publication/readback acceptance remains after merge; do not close prematurely.

Type of Change

  • 🐛 Bug fix
  • 📖 Documentation
  • 🧪 Tests

Changes

  • Python scope: four class-help imports plus three paired version/dependency declarations. Preserve NOTICE, both MIT licenses, original SOURCES hashes and executable AST excluding docstrings in those four modules.
  • Current EN/ZH sdk-api-design and sandbox-types, with matching README/design index labels: supported base commands/files/context cleanup, actual typed E3001 with finally deletion/closure, canonical Provider keywords and explicit interpreter/application prerequisites. Delete unimplemented Config/global policy and speculative persistence/hibernation/pricing/startup claims; do not implement them.
  • Four actual class help import/identity regressions; retain 24 Template imports and 12 Provider help checks. Add exhaustive source docstring guard with existing/nonempty roots, no fixed count assumption.
  • Whole audit: 390 shipped Python files, 2358 docstrings, four residues before → zero after, no upstream runtime imports. All 174 maintained Markdown files including both Skills reviewed: ten upstream examples are eight explicit migration inputs plus two labeled third-party comparisons and remain unchanged.
  • Preserve immutable a5 formal publication and actual 24-Template/12-Provider/four-hash/HTTP evidence separately from its four later class-help failures. Public-a4 real cloud/local evidence is unchanged and never relabeled a6.
  • English/Chinese entry distinction, CHANGELOG and owner records. Current installation guidance remains verified public a4 until a6 is actually published.

Testing

  • All six current Python block occurrences in the four design pages equal two complete programs actually run unchanged using official non-all public a5: command/file/context case PASS2.876s; real sleep100/timeout5 typedE3001/finally case PASS7.298s. Both own cleanups completed before observer; a second independent process confirmed 2/2 typedNotFound, no recovery counted passing.
  • Updated current document SDK import scan: 206 Markdown/RST files enumerated, explicit archives/labeled designs excluded; 155 owned import occurrences / 34 unique statements, 33 actual PASS and one explicit pytest developer-helper exclusion. No remaining current owned import failures. Partial snippet import-line fallback and scope limits are recorded.
  • Before patch: 5 FAIL (four imports + exhaustive guard), 24 previous Template cases PASS. After patch: 54 focused PASS.
  • Full client: 2318 PASS, 26 skipped, 127.41s.
  • Local full server: 878 PASS / 2 FAIL, 314.43s. Same existing low-level HTTP assertions returned 501/502 rather than 400; failures retained with no unverified root-cause claim. Exact-head remote matrix must independently pass.
  • Both-package ruff/format/mypy, paired wheels/sdists, twine, both py.typed markers, fresh combined installation.
  • Installed candidate wheels: all 28 actual help imports, exhaustive installed390files/2358docs scan with zero upstream residue, 12 Provider help/signatures, pip check; real local HTTP health/shell/files and independent owned-process absence.
  • Health 106 PASS / one existing runbook WARN / zero FAIL; hygiene and diff checks.
  • Fresh required CI and independent final review on latest head; earlier 01a1 CI is historical only. No runtime/test code changed in the current-document follow-up.
  • Immutable a6 normal publisher and independent official four-file/fresh non-all/28-help/HTTP readback; no unverified publication claim.

Checklist / Definition of Done

  • Scoped process note, new sanitized evidence, English/Chinese docs and CHANGELOG.
  • Version lockstep; no alias, dependency, API, runtime or release framework changes.
  • No credentials, resource IDs, machine-local paths or altered historical evidence.
  • Required latest-head checks/review/merge; official post-release checks remain separate gates.

@anycodes anycodes changed the title fix: complete Sandbox help imports in paired a6 patch fix: align public help and lifecycle docs for paired a6 Oct 25, 2026
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