Repository navigation
Wrapped projects, slice 1: the sources declaration and project wrap (PR1) - #333
Merged
Merged
Conversation
A wrapper repository holds the DevCapsule configuration and a foreign repository as a submodule, so a developer works on someone else's code in a capsule with three commands. The work order records the owner's rulings of 2026-11-02: an ordinary project, several JDKs in the base, the fork rule, the FRC learning project as the showcase, Codex as the review partner. The registration lists the workstream in the root status and the index. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The manifest gains a [sources] root table keyed by submodule path, with an upstream key for the fork rule and a java key for the JDK line; the base carries Temurin 17 beside 25 under stable names; the instruction reaches the agent first and the capsule environment second; the IDE opens the wrapper root so the agent reads the wrapper's guidance; wrap detects GradleRIO and plain Gradle for the showcase and embeds the submodule's Git directory. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Schema 2 gains the [sources."<path>"] table: one entry per submodule path with an upstream key, present when the origin is the developer's fork, and a java key naming the Java line the source builds with. The reader validates it, the writer renders it after capabilities, a schema-1 file refuses the word, and a launcher without the field carries it as an extension. declare_source edits the table alone, leaving the lock bytes untouched; config show lists one row per source. Evidence: tests/test_sources.py and the owner-command tests. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
wrap adds the repository as a submodule with its Git directory moved into the tree the capsule mounts, reads what the source needs (a Gradle wrapper, with or without GradleRIO, as data with its sources), initializes the manifest and lock as init would or extends an existing manifest, declares the source, and writes the wrapper's AGENTS.md and README.md from the manifest, regenerated on every wrap and kept when they are the owner's. A rerun keeps a submodule already added from the same URL. init and wrap share the owner options. Evidence: tests/test_wrap.py over local bare repositories and tests/test_wrap_detection.py. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Someone else's repository explains the three commands, what wrap reads off the code, learning versus changing, several repositories and what wrap does not do; the CLI reference gains the wrap row and section; R-CONFIG-001 names the sources table as an optional table; R-WRAP-001 states the requirement; the indexes list both. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Fix submodule path lookup, missing-directory recovery, metadata validation, failure reports, guidance escaping, and literal Gradle detection. Add manifest round-trip and listing coverage. Correct the user documentation. Evidence: the initial regression run found 19 failures on PR1. After the fixes, 146 focused cases passed. The build gate passed mypy over 271 files and is running the full suite. Co-authored-by: GPT-6 Astra Codex <noreply@openai.com>
Owner
Author
|
Validation of PR1 at 9af1fd1, in the dogfood capsule (Claude Code + Fable 5.1).
Pending the owner's direction of 2026-11-02 in chat: the Gradle detection is to be removed from |
Codex + gpt-6-astra review of the sources declaration and project wrap, accepted without a round. Inputs are validated before Git writes; submodules are found by path, missing registered directories are initialized, and the embedding asks the submodule for its Git directory; failures name the state left behind; the guidance marker is the exact first line and external text is escaped; detection ignores comments and strings; tests and pages updated.
The owner's ruling of 2026-11-02: the launcher infers nothing from a foreign tree. Detecting Gradle special-cased the showcase into the product and baked in facts about another tool. wrap now requires the capabilities the developer names and declares the Java line the developer gives; a source with no line is described to the agent as unsettled, to be found out with the user. The guidance renders paths, origins and upstreams as code spans, readable raw by an agent, in place of HTML entities; paths and upstreams refuse control characters. Evidence: tests/test_wrap.py and tests/test_sources.py; wrap_detection.py and its tests are deleted. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Owner
Author
|
Gate on the final branch at 0a131d6 (after PR1.1 merged and the detection removed), in the dogfood capsule (Claude Code + Fable 5.1).
PR1 is handed to the owner. The design note for what follows, project capabilities settled and unsettled, is on the branch at |
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <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
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.
Slice 1 of the wrapped-projects work order, by the Claude Code + Fable 5.1 pair, reviewed by the Codex + gpt-6-astra pair as PR1.1 (#334, merged). Design: the wrapped-source design note, ruled by the owner on 2026-11-02, amended the same day: the launcher infers nothing from a foreign tree (amendment 6).
What changed
[sources."<path>"], one entry per submodule path, withupstream(present when the origin is the developer's fork) andjava(the Java line the source builds with).configuration/sources.pyvalidates and renders it;ManifestV2reads it as its own table, the writer renders it after[capabilities], a schema-1 file refuses the word, and a launcher without the field carries it as an extension.declare_sourceedits the table alone and leaves the lock bytes untouched.config showlists onesourcerow per entry.devcapsule project wrap URL [--path NAME] [--upstream URL] [--require CAPABILITY]... [--java LINE]plusinit's owner options, shared through_add_owner_options. It adds the submodule, finds registrations by path (a section name is not a path), initializes a registered submodule whose directory is missing, moves the Git directory the submodule names into<path>/.gitand unsetscore.worktreeby editing the file, so the capsule's bind mount sees a whole repository. It requires what the developer names, initializes the manifest and lock asinitwould or extends an existing manifest, declares the source, and writesAGENTS.mdandREADME.mdfrom the manifest: paths, origins and upstreams as code spans an agent can use verbatim; a source without a Java line described as unsettled, to be found out with the user. Files whose whole first line is the wrap marker are regenerated; others are kept and named. A rerun keeps a submodule already added from the same URL; failures name the state left behind and remove nothing.docs/your-project/someone-elses-repository.md, thewraprow and section in the CLI reference, R-CONFIG-001's new section on the optional table, R-WRAP-001, and both indexes.Judgments for the owner
.gitmodulesholds it. The manifest holds what DevCapsule adds.upstreampresent means "fork, change it"; absent means "upstream, learn". One key carries the fork rule.wrapinfers nothing:--requireand--javaare the developer's statements. Thejavakey is an early form of the build's environment and is expected to fold into the project-capabilities design that follows.wrapwrites nothing inside the submodule, does not install the project workflow, and does not recommend an IDE;config recommend idedoes.Validation
See the comments: the first gate at 9af1fd1 and the final gate at 0a131d6. Both show 18 pre-existing failures specific to this capsule, none caused or fixed by the slice; typecheck passes; 270 focused tests pass. Preparation evidence from inside the 0.3.0 capsule: RobotCode2025Public fails under Temurin 25 at Gradle's script parser and builds under Temurin 17 with
JAVA_HOMEandPATHalone (BUILD SUCCESSFUL in 10m 55s, 25 tasks).🤖 Generated with Claude Code