Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 7 additions & 6 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@ the project tree if desired.

## Capability map (what's built, by phase)

All 36 phases, P37a and P37b-i are built and tested. One line of current fact per phase; the
All 36 phases, P37a, P37b-i and P37b-ii are built and tested. One line of current fact per phase; the
authoritative rationale and full semantics live in the linked ADR, the design
in `ARCHITECTURE.md`. The old per-phase narrative log this table replaced is
archived verbatim at `docs/archive/claude-md-phase-log-2026-07.md` — do not
Expand Down Expand Up @@ -152,7 +152,7 @@ the code, those win.
| P35 | Native Tauri desktop browser: opens `.sc` repositories through `scl-repo`, shows local/remote refs, all-parent snapshot DAG + provenance, public trees and first-parent diffs; protected content is locked and private branches remain opaque; no mutation or identity surface | [0045](docs/adr/0045-native-desktop-read-model.md) |
| P36 | Bucket WAL remotes (sc+wal://, sc+s3://): immutable packs + CAS'd manifest, checkpoints + log-tail cold start, bucket-backed `sc serve --store` with disposable instances | [0046](docs/adr/0046-wal-bucket-remotes.md) |
| P37a | Want-by-id fetch: batched `GetObjects` verb (wire v5), opt-in `.sc/promisor-lazy`, `sc cat <ref>:<path>` fills only the absent trees and blob on its path; `Store::get` stays network-free; sealed objects refused by kind; sparse widen and the lifted P27 refusals are P37b | [0047](docs/adr/0047-want-by-id-fetch-and-gap-fill.md) |
| P37b-i | Presence-based partial clones: push, verify and gc walk what the store holds (`reachable_objects_partial`), not the fetch filter; push checks every gap id against the destination before sending; a view gap fails with `GapInView` before any write (preflight at the top of `materialize`, plus `undo` and `sparse set`); a partial clone fetches from its origin only. Sparse widen (37b-ii) and merge/replay are next | [0048](docs/adr/0048-presence-based-partial-clones.md) |
| P37b-i | Presence-based partial clones: push, verify and gc walk what the store holds (`reachable_objects_partial`), not the fetch filter; push checks every gap id against the destination before sending; a view gap fails with `GapInView` before any write (preflight at the top of `materialize`, plus `undo` and `sparse set`); a partial clone fetches from its origin only. 37b-ii: on a lazy, online clone `ensure_view` fills the view closure by id before switch, fast-forward, undo and `sparse set`, `sparse set` may widen past the filter, a by-id reply is capped at `min(--max-pack-size, 512 MiB)` and a refused batch is split. Merge/replay are next | [0048](docs/adr/0048-presence-based-partial-clones.md) |

## Standing boundaries & gotchas

Expand All @@ -169,14 +169,15 @@ transport-adjacent. The rest, imperatively:
capability, and no DTO field capable of carrying protected ciphertext or
identity material.
- **Partial clones refuse merge, cherry-pick/rebase, `sc ws fork`/`harvest`,
`sc work`, `sc export`, `sparse disable`, an empty `sparse set`, `sc rewrap`,
`sc work`, `sc export`, `sparse disable`, an empty `sparse set` (and, on a non-lazy clone, one outside the filter), `sc rewrap`,

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Distinguish lazy gap healing in the working guide

This newly permits a lazy clone to widen outside its filter, but the same section at lines 176-179 still says without qualification that gaps encountered by switch, fast-forward, undo, or sparse set fail with GapInView and require sc backfill. Those operations now fetch the closure by ID when the clone is lazy and online, so the guide should restrict that failure description to non-lazy or offline clones; otherwise users and agents are directed to perform unnecessary backfills.

AGENTS.md reference: AGENTS.md:L3-L5

Useful? React with 👍 / 👎.

`sc grant`/`revoke`, leaving a private branch, `sc push` to a git remote, and
`sc fetch` from any native remote but the promisor origin.** `sc backfill --all`
converts to a genuine full clone and re-enables them. The filter records what
a clone *asked for*, not what is present: after a fetch an in-filter object
can be absent, and a switch, fast-forward, undo or `sparse set` that needs it
fails with `GapInView` (nothing changed) and names the `sc backfill <prefix>`
that repairs it.
can be absent. On a lazy, online clone a switch, fast-forward, rebase, undo
or `sparse set` fetches what its view needs by id first; on a non-lazy or
offline clone it fails with `GapInView` (nothing changed) and names the
`sc backfill <prefix>` that repairs it.
- **Bucket remotes hold public content plaintext at rest** — bucket ACL is
the perimeter (sealed content stays ciphertext, unchanged); partial-clone
`filter` against bucket remotes is refused.
Expand Down
7 changes: 4 additions & 3 deletions ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -548,12 +548,13 @@ across every phase.

## Active

**P37b — presence-based walks and the lifted P27 refusals (37b-i built).**
**P37b — presence-based walks and the lifted P27 refusals (37b-i, 37b-ii built).**
P37a (built) added the batched `GetObjects` verb and `sc cat`. 37b-i (built)
made push, verify and gc ask "is this object present?" instead of "is this
path in the filter?", which also fixed gc and fast-forward failing after an
ordinary fetch on a partial clone; the remaining work is sparse widen over a
filled prefix (37b-ii). Merge, rebase and sessions on partial clones are directions
ordinary fetch on a partial clone. 37b-ii (built) added sparse widen on a lazy
clone: the view closure is filled by id before switch, fast-forward, undo and
`sparse set`, and a by-id reply is capped and split on refusal. Merge, rebase and sessions on partial clones are directions
with constraints, each needing its own design record; `export` and `sparse
disable` stay refused. Design and open questions in
[ADR-0048](docs/adr/0048-presence-based-partial-clones.md).
Expand Down
Loading
Loading