Repository navigation
docs: place upstream in a subtree and settle the LINA link declaration - #4
Merged
Merged
Conversation
Keep the ClawSweeper tree under upstream/ as a git subtree, install and check it in foundation with upstream's own Node, pnpm and lockfile, and add a dependency policy for SION's own packages. Point result fields at LINA's host protocol, fix the declaration at outbox/declaration.json, mark the two visibility rules that follow upstream, and state that stage permissions read checks as upstream's jobs do. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
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
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
Settles how SION holds its ClawSweeper base and how its LINA link is declared, so Stage 1 can start.
docs/design/sion.md): the upstream ClawSweeper tree sits underupstream/as a git subtree. Upstream files keep their content and relative paths; the repository root (README, LICENSE, AGENTS.md, CONTRIBUTING.md,.github/) belongs to SION. Upstream workflows underupstream/.github/workflows/never run here, because GitHub runs workflows only from the root. Operator workflows are placed by SION's installation and call SION's root reusable workflows, which run upstream code fromupstream/. An upstream sync usesgit subtree merge --prefix upstreamand merges with a merge commit.docs/policy/ci.md): new "Upstream tree" section. Theupstreamjob uses Node 24 from upstream'sengines, pnpm frompackageManagerthrough corepack,pnpm install --frozen-lockfileandpnpm run checkinupstream/.docs/policy/dependencies.md, new): upstream's manifest, lockfile and workspace settings are used as upstream ships them and change only through a sync. Packages that only SION's own code uses follow SION's rules: exact registry versions, a committed frozen lockfile, no install scripts, and no minimum release age.outbox/declaration.jsononstate, with the product version, protocol versions, capabilities and the targets whose link is on. Connecting is a person naming the operator repository in LINA. Mailbox file paths follow LINA's schema and fixtures.state.AGENTS.md: design contracts are described in the present tense.Verification
.github/workflows/, and the onlyworkflow_callones are internal.setup-pnpmtakes aworking-directory, and no upstream code usesgit rev-parse --show-toplevel. Every target token mintspermission-checks: read, and the README says the retired commit-review lane no longer publishes Check Runs. The public dashboard projection never returns private repositories, and the scheduler doc keeps fanout public-only unless records publish to a private state surface.node .github/scripts/check-docs.mjspasses. So donode --test .github/scripts/*.test.mjsandgit diff --cached --check.#source-layout,#typesandci.md#upstream-tree, plus the LINA anchorshost-protocol.md#sionandintegrations.md#sion-link, were checked by reading. No other document links to a changed sion.md section.🤖 Generated with Claude Code