docs: 0.3.0 site sweep — new task syntax hero, apply verb, executed Landlock claim#42
Merged
Conversation
…andlock claim - Hero and Getting Started re-cut to the 0.3.0 syntax: @sp.task with a bare GitRepo handle parameter, with sp.open(...), tasks.register(fn), keyword task arguments, and typed changed_paths. The hero's CI test now runs the snippet as a real script against the installed wheel (executed: 1 passed on shepherd-ai==0.3.0). - apply joins the settlement vocabulary everywhere verbs are enumerated, with the fork-before-settling caveat on the roadmap. - Platform claim updated: grant enforcement executed on both macOS Seatbelt and Linux Landlock. - Permissions concept teaches the grant ladder (bare GitRepo -> May[...] narrowing -> derived may ceiling); tasks concept names the grant-in / handle-return-out boundary; Getting Started gains an upgrading-from-0.2.x section including the unannotated-repo behavior removal. - CLI reference re-captured from the installed 0.3.0 CLI; API pages and version stamps regenerated via the sanctioned generators (site gate ALL GREEN, 79 pages). - quickstart hello.py re-cut to shipped-true value chaining with re-authored sim transcripts; deterministic-demo expected output synced. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Deploying shepherd-agents-docs with
|
| Latest commit: |
1418891
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://a86007c1.shepherd-agents-docs.pages.dev |
| Branch Preview URL: | https://docs-030-sweep.shepherd-agents-docs.pages.dev |
The site leaked maintainer vocabulary with no public referent: "Settlement Core" / "Dataflow" as product-half names, "the honest map", "the named road", "spelling" for syntax form, "servicer", and "the wheel". Rewritten in plain terms — the roadmap page is now "what ships, and what's ahead", links read "Roadmap", and the apply loop caveat is stated without internal bug-report idiom. No behavioral claims changed; both docs gates pass (pages=79 errors=0, names errors=0). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The docs site catches up to the published
shepherd-ai==0.3.0wheel.@sp.taskwith a barerepo: sp.GitRepohandle parameter,with sp.open("."),tasks.register(fn), keyword task arguments, andchangeset().changed_paths. The published hero block is byte-for-byte the snippet its CI test executes against the installed wheel.applyjoins the settlement vocabulary on every page that enumerates the verbs, with its semantics (three-way onto a moved workspace, path-disjoint or refuse) and the fork-before-settling caveat on the roadmap.GitRepo(writable default) →May[GitRepo, ReadOnly](narrowing) → the ceiling derived from the signature — and the tasks concept names the boundary readers will hit next: handles flow in as grants; handle-typed returns refuse until returned handles ship.repoparameters are no longer treated as handles).run apply), API pages and version stamps via the generators.docs/_srcquickstart sources re-cut; sim transcripts re-authored for the new tasks.Testing
run.py check): ALL GREEN — 79 pages, nav 12, 0 errors (membership, name, and drift checks included)gen_cli_reference.py --check: okdocs/_srcsnippet tests: 10 passed (the one failure,test_baseline_gate_green, fails identically on unmodifiedmain— pre-existing environmental issue, not introduced here)pip install shepherd-ai==0.3.0): 1 passed0.2.0claims on published pages (grep-gated)🤖 Generated with Claude Code