Skip to content

Merge dev to mainline — release 0.25.0 - #2755

Merged
antonsynd merged 143 commits into
mainlinefrom
dev
Nov 19, 2026
Merged

antonsynd merged 143 commits into
mainlinefrom
dev

Conversation

@antonsynd

Copy link
Copy Markdown
Owner

Release 0.25.0. This promotes dev @ 5bb23cb to mainline, at the owner's request (2026-11-19). The version bump landed in #2754, and its whole-solution CI run passed (35/35 checks). Merging this auto-tags v0.25.0 and dispatches release.yml.


Generated by Claude Code

Closes deferred finding F16 of plan-775c50.

OutObservationTotalityFailures required When.Ready by name and took
every other ready time from ObservedWhenExclusion, the predicate that
also picks the generated cells, so a time moved into its exclusion arm
left the assertion green. The assertion now holds, for every cell of
the location product whose use is an observed operand and for every
OutObservation, that the observed cell is generated if and only if the
Read cell of the same holder, host form and kind at that time is a
control (the value is ready). A time with no Read cell is accepted as
not ready only where WhenExclusion names the read as excluded there;
otherwise it is a line. The by-name When.Ready check and the coverage
loop that iterated ObservedWhenExclusion are replaced by the iff, and a
non-vacuity line requires every stored holder and form to be observed
in every way at some time. Test code only: no cell, model, row or
allowlist entry moves (pool 1836, 668 rows).

mutation (the verifier's: ReadyAcrossAwait moved to the exclusion arm
of ObservedWhenExclusion): broken → red (3 of 27 failed:
Axes_AreTheImageOfTheirSources_AndThePoolIsFedByThem "6 totality
failure(s)", Totality_ACellDroppedListedTwiceOrRetagged_IsALine,
InitializerDependency_Sweep "6 failures", pool 1830; each line
"Location/{ModuleVar,StaticField,StaticField+Generic}/Int/OutOperand/
ReadyAcrossAwait/{InCallee,AfterThrow} is not generated, and .../Read/
ReadyAcrossAwait is a control"), restored by cp (cmp identical) → green
(27 passed, 0 failed, 0 skipped, 2.1 min).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
plan-775c50 D1 (#2420): delete ExecutionOrderAnalyzer.DetectInitializerDependencies.
Predicate: the CodeGenInfo of a module-level VariableDeclaration does not
depend on what its initializer reads. Before this, a module variable whose
initializer named another non-const module value was marked "execution order
issue", got IsModuleLevel: false, and was emitted as a Main() local, so a read
from a lambda or a function was CS0103 (SPY0908).

Retired with the arm: CollectReferencedIdentifiers and the state only it read
(_typeAndFunctionNames, _assignmentVariables, the SymbolTable constructor
parameter). CollectDeclarationNames is left collecting consts only, as a plain
loop (CollectConstNames). The things ExecutionOrderAnalyzerTotalityTests and
the two DispatchSiteInventory rows (CollectReferencedIdentifiers,
CollectDeclarationNames) inventoried no longer exist, so the test file and both
rows are deleted (lead's ruling).

Re-pinned by direction in ExecutionOrderAnalyzerTests: the 14 tests that pinned
the dependency arm now assert NotContain for the reader (19 assertions),
each beside a positive control that the read name keeps its own issue kind
(assignment-only, assigned-before-declared). The other issue kinds are
unchanged.

Allowlists drained (A1): initializer-dependency-differential 235 rows
(every Reference row citing "#2420 ice"; Reference=750/red 0, red 433 = 668 - 235)
and name-resolution-differential 3 rows
(read/ModuleVar/ModuleInitializer/Lambda/Earlier/Bare/outer=None, seed/D10,
seed/E06). Nothing else went stale, moved or newly red in the three harnesses.
scorecard_metrics.py --lower: outside 1243 -> 1008, seed 2604 -> 2601.

Classifier_AGeneratedCSharpFailure_IsIce: its specimen was #2420's program
(k / g = lambda: k * 2 / print(g())), one of the drained rows, which now runs.
The specimen moves to seed C36, #2151's store arm (P79; SPY0908 CS0103), with a
comment for P79 to swap it again. The assertion is unchanged.

M1 (restore DetectInitializerDependencies from a cp copy, null-safe ctor):
broken -> red (16 of 57 failed: 14 ExecutionOrderAnalyzerTests, the
initializer-dependency sweep with 235 failures, the name-resolution sweep with
3 non-allowlisted), restored -> green (309/0/0 over ExecutionOrderAnalyzer,
the three stage-0 harnesses and DispatchSiteInventory).
Classifier guard (ClassifySharpy without the IceCodes arm): broken -> red
(9 of 50 Classifier_ tests, the new specimen's among them), restored -> green
(50/50).

Refs #2420

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
plan-775c50 task-decomposition rule 5: regeneration right after the first
Semantic change (T1, fa33889), built at that commit.

- spy-stdlib C# (build_tools/regenerate_spy_stdlib.sh): no diff.
- spy-test C# (build_tools/regenerate_spy_tests.sh, 119 files): no diff.
- stdlib docs (python3 -m build_tools stdlib generate --force, 69 files): no diff.
- oracle ledger (cpython_oracle ledger --check): up to date.
- .expected.cs snapshots (UPDATE_SNAPSHOTS=true FileBasedIntegrationTests,
  then regenerate_corpus_pins.sh --no-build): two files move, and the corpus
  pins do not.
  basics/arithmetic_operators and type_system/null_coalescing_0003: Main's
  reads of module variables whose initializers read other module variables
  (SumResult, DiffResult, ..., Y, B, DefaultName, Result) go from bare to
  global::<Ns>.<Ns>Module.X. This is T1's expected effect: those variables
  no longer carry HasExecutionOrderIssues, so they get the module-level
  reference spelling. No declaration, value or fixture output changed;
  FileBasedIntegrationTests 3702/0/0 (Compiler), 251/0/0 (Stdlib), 49/0/0 (Lsp).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
plan-775c50 T1 names 16 pins of DetectInitializerDependencies. fa33889
re-pinned the 14 in ExecutionOrderAnalyzerTests and missed two outside that
file, which go red at fa33889 and are re-pinned here by direction:

- CodeGenInfoIntegrationTests.VariableReferencingAssignmentVariable_IsModuleLevel
- CodeGenInfoComputerTests.ComputeForModule_ModuleLevelVariable_ReferencesAssignmentVariable_IsModuleLevel

Each pinned `x = 5 / y: int = x` -> y HasExecutionOrderIssues: true,
IsModuleLevel: false. Each now asserts the opposite (D1: what an initializer
reads is not an issue of the reader). The positive control of the remaining
issue kind (assignment before declaration) is the test beside each, unchanged.
Both asserted the old direction green at the base (a523fa0 gate 85360/0/10)
and red at fa33889, so restoring the arm (M1) turns them red; measured green
now with the related classes: 163/0 plus T2's pending classification row
(NameResolutionService, EmitterMigration, CodeGenInfo*, ExecutionOrder*).

Refs #2420

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
plan-775c50 D3 (A4, M4). One process-wide re-entrant lock (a Monitor).
Per value a byte state (StaticInitState: Uninitialized 0, Initializing 1,
Assigned 2, StoredInitializing 3, Ready 4); per host a StaticInitHost
struct (NotStarted, Running, Done, Failed, Retrying). API: TryLoad (the
Swept type initializer; Monitor.TryEnter, never waits), Load, Read (the
slow path of a read), Store<T> (the slow path of x_set), Run (one sweep
step), IsReady. A read of a value never given one, on the initializing
thread, raises NameError "name 'x' is not defined" (CPython 3.15.2's
text); a throw restores the state the run found and rethrows the
original; a sweep runs once, its failure is delivered once, then each
value retries on its read. Requiring a host whose sweep is running on
this thread returns at once (import cycles, the lead's ruling); an empty
sweep is valid.

Tests: StaticInitTests, 20, hosts copying the emitted shape (nested
Swept whose type initializer calls TryLoad), each body bounded at 20 s.
StaticInit filter: 20/0/0 (measured).

Mutations (Sharpy.Core.Tests, filter StaticInit, 20 tests), restored by
cp from a copy, cmp identical:
- skip the reset on throw: broken -> red (4 failed), restored -> green
- skip the Initializing mark: broken -> red (3 failed), restored -> green
- reset past an earlier store (reset to Uninitialized): broken -> red
  (1 failed), restored -> green
- make TryLoad wait (Monitor.Enter): broken -> red (19 failed: the
  two-lazy-classes deadlock keeps the lock, later tests time out),
  restored -> green
- deliver a failure to every read: broken -> red (6 failed), restored ->
  green
- re-run a sweep already running on this thread (import cycle): broken
  -> red (9 failed), restored -> green
Restored: 20/0/0.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
plan-775c50 D2 (Rule 2; A2, M2). CodeGenInfoComputer records, and the
incremental cache round-trips, the facts T4/T5 pick their arms by. No
emission change: no snapshot moves.

Facts
- CodeGenInfo.StaticStorage (Const | Guarded | Plain | null) and
  CodeGenInfo.IsOnGenericHost (the host or an enclosing type declares a
  type parameter), classified once by StaticStorageFacts. Const is exactly
  IsConst && IsCompileTimeConstant (ConstEligibility, #1791). Guarded = an
  initializer and no C# const: a module variable, a computed const, a
  property default, a @static field, in every host. No initializer: Plain
  (Q4).
- A class-level @static property: PropertySymbol.StaticStorage and
  PropertySymbol.IsOnGenericHost (lead's ruling), set in
  ProcessTypeMembers, round-tripped by CachedProperty.
- HasSweep: each module records its own, declarer-side, on the project
  SemanticBinding keyed by normalized path (SetModuleHasSweep), persisted
  on FileCacheEntry.HasSweep and restored warm beside the layout.
  Transitive (a Guarded value in any host, or an import/from-import of a
  module that has one). ONE importer-side predicate
  (ImportedStaticFacts.ImportedSweep) copies it into the imported
  ModuleSymbol's CodeGenInfo.HasSweep (import m, and each submodule) and
  the from-import's ModuleLayout.HasSweep.

Lead rulings applied
- null StaticStorage for int/string enum members, instance fields and
  defaults, instance property defaults, function-style properties, and
  #2125's Main-local module variables (HasExecutionOrderIssues).
- A deferred-cycle peer with no record yet reads HasSweep true (the
  conservative arm, named in ImportedSweep; T5 emits a load entry for
  every module). Single-file / registry / stdlib / reference imports read
  false until T8.
- Ruling (a) on the cold identity split: a cold build's module VARIABLE
  export (`import lib; lib.mv`, and an alias clone's root) is ModuleLoader's
  extracted symbol, not the declared one; warm it is the restored declared
  symbol. The declaring module also records each module value's storage
  keyed by (path, name) (SemanticBinding.SetModuleValueStorage, in
  MergeFrom); the same predicate class's ImportedStorage reads the
  declaration's CodeGenInfo, else that record, into the from-imported
  name's CodeGenInfo and onto `import m`'s exported VariableSymbols
  (CopyImportedValueStorage). Copy sites cite the findings-ledger row
  (candidate class P78 / #2423), so the map is deleted with the cure.

Schema: IncrementalCompilationCache.CurrentSchemaVersion 41 -> 42
(CachedCodeGenInfo StaticStorage / IsOnGenericHost / HasSweep,
CachedProperty StaticStorage / IsOnGenericHost, FileCacheEntry.HasSweep).
SymbolFactMirrorConformanceTests lists the three CodeGenInfo facts as
RoundTrips; ColdWarmUpToDateCheckTests classifies FileCacheEntry.HasSweep.

Test: StaticStorageFactsRoundTripTests — kind (7) x host (Module, Class,
Struct, GenericClass, GenericStruct, NestedInClass, NestedInGenericClass)
generated with a totality check, 42 cells, cold and warm (lib served from
the cache, positive control asserted); HasSweep records and both carriers
incl. transitive; the importer's `lib.x` exports and `from lib import mv
as amv`; a deferred import cycle (each from-importer reads true) with an
acyclic control (false).

Mutations (A2 class, 3 tests; each restored by cp, cmp identical):
- drop StaticStorage from SymbolSerializer (CodeGenInfo + property) ->
  red, 1 of 3 failed, 49 warm cell failures; restored -> green 3/3
- drop IsOnGenericHost from SymbolSerializer -> red, 1 of 3 failed, 18
  warm cell failures (6 kinds x 3 generic hosts); restored -> green
- drop HasSweep from FileCacheEntry -> red, 1 of 3 failed, 6 warm
  failures (3 records null, 3 importer carriers false); restored -> green
- drop ImportedStorage's keyed-record arm (ruling (a)) -> red, 1 of 3
  failed, 3 cold failures (lib.mv, lib.ni, amv); restored -> green
- the cycle arm returning false -> red, the cycle test failed; restored
  -> green

Measured @ 1eacf8c + this change: A2 + SymbolFactMirror|ColdWarm|
SymbolSerializer|CodeGenInfo|IncrementalCompilation 426/0/0;
FileBasedIntegrationTests (snapshots verified, none moved) 3706/0/0;
stage-0 InitializerDependency|NameResolutionDifferential|
StaticInitializerOrderMatrix 263/0/0; Sharpy.Lsp.Tests 22652/0/0;
Sharpy.Cli.Tests (Incremental|Project) 85/0/0.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
plan-775c50 D7 (A7, M7). TypeChecker.CheckModifiedArgument refused a
ref/out operand by its shape alone, so a property or a const passed by
reference reached Roslyn (CS0206 / CS1510 / CS0199 / CS8156 behind
SPY0908). It now classifies the operand by the symbol the checker bound
(the identifier's symbol, a module- or type-qualified member's
resolution, or the member the receiver's resolved type declares, through
DenotedTypeSymbolOf for every type-denoting spelling) and refuses with
SPY0389:
- a property (module, @static, instance; default or not) under ref, out
  and in (Q8);
- a const under ref and out.
A variable or field under any modifier and a computed const under `in`
run. `in` on a literal const is not refused: it is the owner's open cell
(SPY0908 CS8156, excluded with its program), left exactly as today. The
shape refusal for a non-name operand under ref/out is unchanged.
SPY0389's DiagnosticExplanations entry describes the rule by symbol kind.

Aliased and qualified spellings get the one verdict (probed with the
built sharpyc): `type E = D0` then `ref E.k`, `ref G[int].k`,
`ref self.k`, `ref lib.k` / `ref lib.p`, `from lib import p as q` then
`ref q` -> SPY0389.

Allowlist: the 46 Operand rows (`#2422 ice`) drain; the other 46 Operand
cells run (Operand=92/red 0). Scorecard outside-seed 1008 -> 962.

Measured (src/Sharpy.Compiler.Tests, before T4's in-flight CodeGen edits
appeared in the shared tree): InitializerDependencyDifferentialTests |
ModifiedArgument | ParameterModifier | DiagnosticExplanation: 69/0/0.

mutation M7a: refuse by shape alone (symbol rule removed) -> red
(InitializerDependency_Sweep, 46 failures: Operand=92/red 46, Ice=46,
the rows listed again); restored -> green (Operand red 0).
mutation M7b: refuse every non-variable (a const under `in` too) -> red
(2 of 27 failed: 16 sweep failures, the 4 Operand computed-const `in`
cells and 12 Location computed-const InOperand cells FalseRefusal, plus
Exclusions_ThatRestOnADiagnostic_StillDrawIt: the literal-const `in`
program drew SPY0389 for SPY0908 CS8156); restored (cp, cmp identical)
-> Operand red 0, no failure line names SPY0389 (the restored run's
other reds are T4's uncommitted CodeGen edits in Location/Slot).

Direction record (A10): no Integration fixture and no spec block is
newly SPY0389 (FileBasedIntegrationTests: no failure names SPY0389;
check_spec_blocks.sh: no SPY0389). The newly refused programs are the
46 generated Operand cells, each an internal error (SPY0908) before.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
TypeChecker.CheckFor checked only an identifier or tuple target, so a
member or element for-target (`for H.t in xs:`, `for o.x in xs:`,
`for xs[0] in ys:`) recorded no resolution: the emitter could not read a
Guarded @static target's storage fact (plan-775c50 D4). The target is now
checked as the comprehension for-clause target already is (CheckExpression,
then the element type), the with-as target's arm too.

Test: ForTargetCheckTests — the three shapes, each beside its comprehension
spelling as the positive control: H.t records its MemberAccessResolution,
o.x and xs[0] their receiver's type.
mutation: drop the arm's CheckExpression -> red (1 failed: "for target H.t:
no member resolution recorded", o.x and xs[0] "receiver never checked"),
restored -> green (1/1).

No new diagnostic on valid programs: FileBasedIntegrationTests 3687/15/0
(measured, with T4's in-flight emitter edits in the tree); the 15 are 13
.expected.cs snapshot diffs and 2 static-init outputs from that emission,
none holds a member or element for-target (none does in the corpus).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
D6 (plan-775c50): in an `async def` body, a use of a Guarded value that is
neither a plain read nor a plain store is a node-keyed SemanticInfo fact, in
MergeFrom, so the emitter hoists the ensure (or the `out` arm pick) before
the statement and names the backing field: no accessor reference is live
across an `await` (CS8178 under D4's by-ref accessor).

- AsyncGuardedUseAnalyzer runs after CodeGenInfoComputer.ComputeForModule:
  a node naming a Guarded VariableSymbol (module variable, @static field,
  computed const; any spelling: bare, H.s, lib.u, aliased module, from-import,
  aliased from-import; storage via the binding, else ImportedStaticFacts)
  is recorded as OutOperand under `out`, Ensure under `ref` / `in`, or Ensure
  as the receiver root of a member / index path under a modifier, a store
  target, or a method call's receiver. Plain reads, plain stores on the
  name, nested def / lambda / class bodies and Guarded properties: none.
- SemanticInfo.GetAsyncGuardedUse(Expression) -> AsyncGuardedUse(Node,
  Value, Kind); SetAsyncGuardedUse(node, value, kind). API agreed with the
  codegen agent (one table, node-keyed). Side-table ratchet 85 -> 86 with its
  plan line; dispatch roster rows for the analyzer's five switches.

Test: AsyncGuardedUseFactTests — 18 use kinds x 7 spellings, 98 cells
(28 excluded, each with its reason): 67 recorded (Ensure and OutOperand),
31 async read / plain-store cells unrecorded, every cell's plain-def twin
unrecorded, a local and a Guarded module property unrecorded, no stray
record in the file; project-merged and per-file views; roster totality.
mutation: drop the method-call arm -> red (2 of 3 failed: MutatingCall and
ParenthesizedCall on all six spellings, both views), restored -> green (3/3).
Guards: AsyncGuardedUseFactTests, SemanticInfoMergeConformanceTests,
SemanticInfoFreezeTests, ForTargetCheckTests 19/0/0 (measured);
Semantic namespace + FileBasedIntegrationTests 15669/15/1 before the
setter-signature fix, the 15 = SemanticInfoFreezeTests (fixed here),
T4's in-flight emitter (13 snapshots, ExplicitInterfaceKeyCensus) and none
from this change; DispatchSiteInventory red only on T7's two rows.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
T7 (5625ff9) added two kind dispatches to TypeChecker.Expressions.cs,
ResolveModifiedOperandKind and DescribeOperand, without roster rows, so
DispatchSiteInventoryTests.AllDispatchSites_MatchRosterExactly has been red
on them since that commit; T7's filtered run did not include the inventory.
Each gets a refusal-net row on InitializerDependencyDifferentialTests, whose
generated Operand cells refuse every kind on every spelling (D7, SPY0389)
and run each accepted operand.

Guard record (the roster is the guard; the rows are the change):
without the rows -> red (1 failed: UNROSTERED DescribeOperand,
ResolveModifiedOperandKind; log dotnet-serialized-20261117-084836-9269),
with the rows -> green (DispatchSiteInventoryTests 17/0/0; log
dotnet-serialized-20261117-091915-8018).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
plan-775c50 T4 (D4; A3, A6; F14, W10). T6's D6 emission is folded in, on the
semantic fact e2d1baf (lead ruling).

Emission (RoslynEmitter.StaticValues.cs). The arm comes from
CodeGenInfo.StaticStorage / PropertySymbol.StaticStorage and never from a type.
Every Guarded value is emitted this way: a module variable, a @static field, a
computed const and a property default, in a module, class, struct or
interface. Each gets a backing field and a state byte with no initializer,
N__init, N__slow, and a property of the value's own C# name. A variable or
@static field returns `ref`, a computed const `ref readonly`, and a property
default keeps get/set. N__set is the one plain-store seam: all five AST store
nodes and the for/walrus rebinds, bare or qualified, and `x op= e` becomes
N__set(x op e). An out operand on a Guarded value is N__out(out var spill):
the storage once the value is Ready, a heap StrongBox before. N__commit stores
the spill when the call returns, before the operand to its right (W10). An
expression-statement call places its commits after the statement. Each host
gets __host / __Sweep / __Swept, with sweep steps in declaration order.
F15: the spill is a StrongBox, fix (3), so no [UnscopedRef] is needed on either
target. T5 builds Sharpy.Stdlib on both targets.
D6: in an async def body, an Ensure use hoists N__ensure() and names the
backing field. An OutOperand use hoists `var spill = N__pick();` and emits
`(spill == null ? call(out field) : N__commit(call(out spill.Value), spill))`,
or the if/else form for a statement call. The backing field takes the value's
accessibility. All 27 ReadyAcrossAwait controls are green.

Harness (F14, W10, A3):
- OutObservationCells generates the not-ready times with Q-F (a)'s models.
- F16's iff is narrowed to the controls that carry a Rejected model.
- SameExpressionCells adds the W10 controls.
- The ForTarget-through-a-closed-generic exclusion (#2435, CS0305) retires:
  the for target now runs, so its 16 cells are generated, all green.
- The ClassComputedConst cross exclusion moves CS0198 -> CS8331. It still rests
  on a drawn code.
- New StaticInitializerCensusTests (A3): fixture corpus + pool, 4346 programs,
  with a positive control.
Layout control moved by design: StaticInitializerOrderMatrixTests now asserts
`static ref readonly int B` and its guard.

Allowlists:
- IDD 387 -> 190. 197 drained: Cross 67, ModuleVar 40, StaticField 40,
  StaticField+Generic 38, ClassComputedConst(+Generic) 8, ModuleComputedConst 4.
- 181 IDD rows moved SilentWrong -> RuntimeThrow (NameError). Each carries a
  comment naming the commit that clears it:
  - 69 Location/Cross ReadBack + 6 non-refuse Slot: T5.
  - 106 must-refuse Slot cycle cells: T9 (D8, SPY0278).
  No new red.
- NR: 165 stale rows drained. ModelsReadByNothing re-taken 45->39, 20->3, 25->18.
- scorecard --lower: 962->766 / 2601->2436.
- New rows: one inspection row (SyntaxFactory.NullableType, a false positive),
  two dispatch rows, sink/operand-order exemptions, 4 corpus pins.

Direction (A10). Two fixtures move by N3, confirmed with `run`:
- static_prop_default_calls_static_method_2396: 0 5 -> 5 5
- static_prop_in_static_init_2396: 4 4 4 0 -> 4 4 4 2
python3 3.15.2 gives NameError for both: a class body cannot name its own
class, so neither has a twin.

Transient reds (exactly 14, cleared by T5's one regen commit):
- 13 .expected.cs snapshots: layout.
- 1 ApiSurfaceComparisonTests.ApiSurface_NativeMethodsExistInMSBuild: the
  pre-regen Sharpy.Stdlib.dll lacks N__set/__ensure/__pick/__out/__commit.

Measured @ e2d1baf+working tree:
- trio + census: 265/0/0.
- FileBasedIntegrationTests: 3689/13/0 (the 13 snapshots).
- Sharpy.Compiler.Tests minus FileBased and the trio: 48753 passed, 2 failed,
  6 skipped before the 2 h tool limit stopped the run in the Properties tail.
  The 2 failures were ModuleMemberQualificationMatrixTests (fixed and re-run
  green) and ApiSurface (transient, above).
- Guard and fixed-test reruns: 259/0/0.

Mutations (IDD sweep unless noted). Each: broken -> red, restored -> green.
- M3, one Guarded `t` as an initialized field: census red (1 failed).
- M6, return a copy: 158 failures, incl. CS1612 / CS0206 / CS8156.
- M6, no D6 arm in an async def body: 27 failures, all CS8178.
- M6, store sites left on the accessor: 88 failures (`5 5`, `5 5 7`, NameError).
- M6, out left on the accessor: 31 failures (`42 42`, `42 42 7`, `43 42`).
- M6, spill a Ready out: 84 failures, the 42 controls print `7 42` / `7 7`.
- M6, drop the Assigned mark (Core): 35 failures (`7 7`, `7 7 7`).
- M6, raise on a store to an Initializing value (Core): 52 controls raise.
- M6, raise on a read after one (Core): 26 controls raise.
- M6, return the field before any store (Core): 65 print a default.
- F16, ReadyAcrossAwait into the exclusion: stays red (2 of 26, 6 totality
  failures).
- M6, pick by the host's sweep: green at T4. It needs T5's Main and line
  sweeps; T5 re-runs it.
All restored by cp, cmp identical. Restored: IDD sweep + census green (3/0/0).

Ledger: an interface `@static t: int = 7` is an interface property in the
symbol model (SPY0908 CS0120), outside CodeGen.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
The whole-solution gate at 1d90383 (run 44085983515) was red on three
generated pins beyond T4's 14 named transient reds:

- DoorCensusTests.T2_PathCapableMembersUnderNegativeRows_EqualTheCommittedCensus.
  T3's runtime (e7e6efd, Sharpy.Core StaticInit) calls
  Monitor.TryEnter(object). The System.Threading negative row is re-judged
  and holds: a lock call with no path parameter. Regenerated with
  UPDATE_DOOR_CENSUS=1 (8/0/0).
- CodeActionShapeSweepTests Identity/Crlf totals. One moved row is
  explained by its source: T4 rewrote the header comment of
  classes/static_prop_default_calls_static_method_2396.spy, one line longer,
  so the sampled code-action positions moved. Its row leaves
  inline-function crlf (#2296) and joins extract-method identity (#2294),
  both open trackers. No other row moved. regenerate_corpus_pins.sh: 17081/0/0
  and 49/0/0.

Regenerated in a clean worktree at 1d90383.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
D5 (plan-775c50, T5; lead's ruling (a)): "by an importer's sweep at the
import's position" needs, per import statement, the Sharpy modules Python
runs for it. Which modules run depends on the statement's spelling
(`import a.b.c` and `import a.b` both bind `a`), so the fact is node-keyed in
SemanticInfo (Rule 2's (b) form), not on the bound ModuleSymbol.

- SemanticInfo.GetImportRequirements(Statement) -> IReadOnlyList<ModuleLayout>
  (layout + HasSweep), on every module-level `import` and `from ... import`;
  null for any other statement; empty when every module is .NET, synthetic or
  unresolved. In MergeFrom (sequence comparer). Side-table cap 86 -> 87,
  citing D5's line and T5.
- Python's order, CPython 3.15.2 measured on a package tree printing at
  import: `import a.b.c` -> a, a.b, a.b.c; `import a.b as x` -> a, a.b;
  aliases in turn, each module once; `from a.b import n` -> a, a.b, then
  a.b.n when n is no export of a.b and resolves as its submodule;
  `from a.b import *` -> a, a.b. Skipped: a .NET module and its chain, a
  namespace-only package (no __init__.spy: nothing recorded for it, its
  submodules still are), a file outside the compilation, the importer itself.
- ImportResolver records the chain (file paths) on the shared SemanticBinding
  at resolution, with the module resolver and the .NET precedence of
  TryResolveNetModule; CodeGenInfoComputer turns it into layouts.
  Ancestors and from-import submodules add no dependency edge (so no new
  cycle): their HasSweep is ImportedStaticFacts.RequiredSweep, the record,
  else true (the T2 ruling's conservative arm); an imported module's is
  ImportedSweep. A required sweep makes the importer's own HasSweep true.

Test: ImportRequirementsFactTests — Form (6) x depth 1-3 x .NET in the
statement (2): 22 cells, 14 excluded with reasons; 10 extra rows (.NET only,
.NET from, namespace-only x3, two chains, repeated ancestor, two modules,
import from inside the package, a package importing its own submodule).
Exact ordered list (each module's own recorded layout + literal HasSweep)
per cell, in the cold merged, cold per-file and warm merged views (every
tree module served from the cache); a def beside each import has no record;
the submodule-by-name cells (SPY0301 today, findings ledger) in their own
project with the diagnostic as positive control; generator totality.
mutation: drop the ancestor walk in AppendImportChain -> red (2 of 3 failed:
the run test's d2/d3 import, import-as and from-name cells in every view,
and the refused project's FromSubmodule/d3), restored (cp, cmp) -> green 3/3.
Both runs at 13:06 and 13:10 on touched sources, before the 13:13 Core
mutation window.
Guards: ImportRequirementsFactTests, SemanticInfoMergeConformanceTests,
SemanticInfoFreezeTests, StaticStorageFactsRoundTripTests,
AsyncGuardedUseFactTests 24/0/0 (measured, sources touched).
Semantic + Project + FileBasedIntegrationTests + roster/carrier tests:
17093/163/1 (measured on the tree with T5's in-flight CodeGen edits; not
controlled at the base): 160 .expected.cs snapshot diffs (Main() prelude),
DispatchSiteInventory (CodeGen AddImportRequirements), EmitterCarrierOnly
(ModuleClass.cs:228), ExplicitInterfaceKeyCensus: all in in-flight CodeGen
files, no stdout change.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
An import statement's requirement list (plan-775c50 D5) now also names
each Sharpy module imported by reference (D10). These are every
regenerated Sharpy.Stdlib module and any referenced Sharpy library. A
module is listed when discovery finds a load entry for it, read only
from Sharpy.SharpyLoadEntryAttribute (ModuleRegistry.GetModuleLoadEntry,
which forwards to CachedModuleDiscovery). The list keeps S3's chain
rules: Python's order, a package before its submodule, each module once,
and source and by-reference modules interleaved in statement order. A
.NET namespace or a hand-written C# [SharpyModule] with no entry adds
nothing.

ModuleLayout gains ClrMembersClass, the members class's CLR full name.
ModuleLayout.ByReference(clr, hasSweep) has empty NamespaceSegments,
the simple class name and the entry's HasSweep. MembersClassFullName
returns ClrMembersClass when it is set.

Consumers checked:
- record equality and MergeFrom's sequence comparer cover the new field;
- the incremental cache stores only a file's own layout (its segments
  and class name), never an import requirement, so there is no cache
  version bump;
- Guarded facts are not carried over: a by-reference value stays Plain.

The side-table cap stays 87 (no new table).

This depends on CachedModuleDiscovery.GetModuleLoadEntry and
ModuleLoadEntry. Both are in the codegen agent's T5/T8 change, which
lands next.

Test: ImportRequirementsFactTests.ByReferenceModules_* runs 16 cells in
three views (cold merged, cold per-file, warm merged). The cells cover:
- import math / math as mm / from math import pi / from math import *;
- a repeated alias;
- import os.path and from os.path import join (os, then os.path: two
  entries);
- by-reference and source chains mixed, both ways;
- a Sharpy library built by the harness and consumed by reference, with
  and without a sweep;
- a hand-written C# [SharpyModule] assembly with no entry, giving [].

Mutation (private worktree, files touched before each run):
- ByReference() made to return null: red, ByReference fact failed with
  "expected [clr:Sharpy.MathModule.MathModuleModule/... sweep=True],
  got []" (the other 3 facts stayed green);
- restored from the cp copy: green, 4/4.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
T5 (D5; A5, A6, M5) and T8 (D10; A8, M8) in one commit (lead ruling: T8
folds into T5 as T6 folded into T4; T5's regen cannot be green without
D10). 55cd533 (S4) builds only with this commit: it calls
CachedModuleDiscovery.GetModuleLoadEntry / ModuleLoadEntry, added here.

D5 (CodeGen). Each host's __Sweep runs its steps in declaration order:
a value's StaticInit.Run, or a requirement (another host's load entry).
- Module: [CompilerGenerated, SharpyLoadEntry(hasSweep)] public static
  void __Load(). It is empty for a module with nothing to sweep (no host,
  sweep or Swept class is emitted then).
- A non-generic type with values: an internal __Load_<Type>(), required
  by the sweep around it at its line. A type with no values passes its
  requirements up. A generic host is swept by first use only.
- Imports: every import's requirements come from S3/S4's
  SemanticInfo.GetImportRequirements (one source per position), in
  python's order.
  - A source module is required under the project namespace.
  - A by-reference one is required by its ModuleLayout.ClrMembersClass.
- An entry point's main() calls __Load() first.
- F15:
  - N__field = default! and spill.Value! keep the shape nullable-clean.
  - Sharpy.Stdlib builds 0 errors / 0 warnings on net10.0 and
    netstandard2.1.

D10 (Discovery, Sharpy.Core).
- Every member D4/D5 adds carries [CompilerGenerated] and is internal,
  or private / private protected when its value's access is narrower.
- Core adds SharpyStaticStorageAttribute(StaticStorageKind) on a Guarded
  value's property and SharpyLoadEntryAttribute(hasSweep) on the entry.
- Discovery:
  - skips [CompilerGenerated] module members;
  - reads the load entry by its attribute (GetModuleLoadEntry);
  - reads a value's storage by its attribute alone
    (IsModuleFieldGuarded: a C# `ref` static property is Plain);
  - maps a by-reference property / return type to its element type
    (ClrTypeHelper.ValueTypeOf: ClrTypeBridge, ClrMemberTypeResolver,
    OverloadIndexBuilder, ClrDeclaredNullability).
  - Index cache format v26.
- Storage is observed where discovery holds it (lead ruling): an
  importer's symbol stays Plain.

Tests.
- StaticInitSweepProjectTests (5 project controls; python3 3.15.2 twins).
- ByReferenceInteropTests (A8: a hand-written C# module with ref /
  ref readonly properties, a ref-returning method, a ref indexer and
  instance property, and [CompilerGenerated] public members; and a Sharpy
  library dll).
- SharpyStaticStorageAttributeTests (Core).
- InitializerDependencyDifferentialTests.Locations: F14's cross half
  (the not-ready-yet exclusion removed; the owed observed cells are
  generated).
- StdlibModuleGlobalRosterTests' census reads a Guarded value by its
  property: its storage is the field the getter returns by ref, and its
  generated members are its machinery. A write is a call to its store
  seam (D4: N__set / N__out) from user code. The positive control's kind
  is now "store-call ._Random__set" (D4's plain store; was
  SimpleAssignmentExpression).

Rows drained:
- initializer-dependency-differential: 80 (69 Location/Cross ReadBack
  RuntimeThrow, 6 Slot non-refuse, 5 Location Plain>Module UserFirst
  SilentWrong). 110 left:
  - 106 must-refuse Slot RuntimeThrow: cleared by T9 (D8's graph; T9
    note on each);
  - 4 FalseRefusal SPY0618 InInitializerText (StaticField±Generic,
    ComprehensionTarget / OutOperand), route and cite as measured:
    cleared by T9 (D9: SPY0618 retires in D8's commit).
- name-resolution-differential: 12 (read/order-observation 11, seed 1).
- scorecard --lower: outside 766 -> 686, seed 2436 -> 2424.

Transient reds turned green, each measured here:
- T4's 14 named reds: 13 .expected.cs snapshots and
  ApiSurfaceComparisonTests. The snapshots are regenerated (160 files
  now: the Main prelude, the entry, the guarded shape).
  ApiSurfaceComparisonTests skips [CompilerGenerated] methods, as
  discovery does.
- Found by the broad run (T4/T5 layout), now green:
  - ModuleClassMergeMatrix 24, RoslynEmitterModule 6 and
    RoslynEmitterNamespace 6: no host for a sweepless module.
  - NamespaceLevelTypes 1: D4's `public static ref int Counter`.
  - LayoutFactConsumerScan 2: RequirementPath and AddImportRequirements
    rostered, 15 -> 17.
  - SinkPushingTotality 1: LoadStatement rostered.
  - StaticInitializerCensus 1: `N__field = default!` is no user
    expression.
  - ExplicitInterfaceKeyCensus: ModuleClass.cs:134 -> 135.
  - Stdlib.Tests: 18 snapshots and 5 StdlibModuleGlobalRoster.

Regen:
- build_tools/regenerate_spy_stdlib.sh: 18 modules, every Guarded value
  in D4's shape, every module with its entry.
- regenerate_spy_tests.sh: 119 files.
  - Import steps: os 19, math 10, random 4, re 3, csv 3, string 1,
    socket 1.
- Snapshots: Compiler 160, Stdlib 18.
- Corpus pins: no change. Stdlib docs: no change.
- The new public members are needed by D4's shape: the value's ref
  property and the module's entry. Every helper is internal.

Measured on this tree (base 55cd533):
- trio + census 265/0/0 (10.4 min);
- FileBased + ApiSurface + Project + Discovery 5623/0/0;
- Stdlib.Tests 4538/0/0; Core.Tests 4238/0/0;
- Lsp.Tests 22652/0/0; Cli.Tests 1131/0/1;
- CodeGen + Discovery + Project + ApiSurface slice 3533/0/0 (re-run
  after the last Discovery edit).

Mutations, each in a private worktree; broken -> red, restored -> green,
same base per batch.
- Batch 1 @ 440c2ef + T5 diff (IDD sweep + 4 project controls; base 5/5):
  - mutation: drop Main's requirement → red (2 of 5 failed, 82 IDD
    failures + MainRequiresItsModule); restored → green (5/5)
  - mutation: reverse the sweep → red (4 of 5 failed, 131 failures);
    restored → green
  - mutation: initialize only the value a use names (Read without
    Require) → red (1 failed, 29 failures); restored → green
  - mutation: leave a generic host unswept → red (1 failed, 314
    failures); restored → green
  - mutation: drop a generic host's Swept check → red (1 failed, 293
    failures); restored → green
  - mutation: hold its state outside the generic type → red (1 failed,
    96 failures); restored → green
  - mutation: pick by the host's sweep → red (1 failed, 4 failures);
    restored → green
  - Store without Require stays green (5/5). It is not a plan mutation:
    Store's Require is unobserved by the cells.
- Batch 3 @ 55cd533 + this diff (IDD sweep + 5 project + 5 A8; base 11/11):
  - mutation: M5, drop a class's RequireStep at its line → red (2 of
    11 failed: nested class prints O.a O.b C.v, 51 IDD failures);
    restored → green (11/11)
  - mutation: take only an import's last module → red (1 failed: `m1
    pkg.sub m2 …`, no pkg); restored → green
  - mutation: M8.1, drop the [CompilerGenerated] skip → red (1 failed:
    extra names "hidden", "hidden_count"); restored → green
  - mutation: M8.2, drop the SharpyLoadEntry attribute → red (2 failed:
    load entry null; the order control prints m1 m2 lib.x); restored →
    green
  - mutation: M8.3, classify by CLR shape (ByRef is Guarded) → red (1
    failed: refshapes.x imports as Guarded, observed by
    CachedModuleDiscovery.IsModuleFieldGuarded); restored → green
  - mutation: keep a ByRef member type → red (4 failed: element type,
    every-kind run, order control, 4 IDD); restored → green
  - A writable-ref setter rule in the index stayed green (11/11), so it
    was dropped, not landed. The ref indexer store is a ledger row.
- F15 arm, wt regen + Stdlib build both TFMs (base 0 errors):
  - mutation: drop `= default!` → red (34 errors, CS8618 on both
    targets); restored → green (0 errors)
  - mutation: drop the box `!` → red (34 errors, CS8601 + CS8604 on
    net10.0); restored → green (0 errors)
- Batch 4, StdlibModuleGlobalRosterTests (base 20/20):
  - mutation: count a value's own machinery as writes → red (3 of 20
    failed); restored → green (20/20)
  - mutation: a store-seam call is no write → red (3 of 20 failed,
    PositiveControl_GeneratedRandomSeedIsAWrite among them); restored →
    green (20/20)

Ledger rows (findings-ledger, not filed here):
- a read-only discovered module member is assignable (CS0200 /
  CS8331 ICE; get-only pre-existing);
- a `ref` indexer store is SPY0320 (false refusal; semantic keys on
  GetSetMethod);
- the dotted-import package member row (S3's; seen again).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
Residue of f719b40 (gate 85400/1/10, run 44136488505; Python Build
Tools run 44136493864).

1. corpus-pin-inventory: the LayoutFactConsumerScanTests row is re-keyed
   to `ReaderCount = 17`. Its reason, code-site-roster, still holds: the
   constant counts compiler/LSP/Stdlib reader rows, and T5 added two.

2. Class: every tool that reads member types of the generated C# or of
   Sharpy.Stdlib.dll must read a `ref`/`ref readonly` member as its
   element type (D10, the same rule as discovery's ByRef unwrap).
   - generate_stdlib_docs.py rendered `ref int`, `ref str`, ... for
     every Guarded value. Fixed with member_value_type(), applied to
     property types and method returns.
   - Discovery: ClrTypeHelper.ValueTypeOf (T8), already correct.
   - LSP hover/signature/symbol paths read SemanticType, not CLR
     reflection. Measured with a new hover test over math.pi and
     string.digits under the server reference set: green.
   - ApiSurfaceComparisonTests compares methods only (getters are
     special names): green.
   - Playground: no reflection reads. build_tools: no other tool reads
     Stdlib member types (spy_none_default_audit reads .spy only).
   The generator also skips [CompilerGenerated] members (D10: __Load).

3. random._random/_lock and socket._default_timeout/_lock: D4 did not
   widen accessibility. At 55cd533 they were already
   `public static ... _Random = ...;` fields. The generator ignored
   mutable public fields but matches ref properties, so T5 made them
   visible to it. D4's shape is untouched. The docs skip python-private
   (`_name`) static values; a new roster test guards it.

4. The leaked cref `Result{T,E}` (`E`) was caused by T5: math's
   `public static ref double E` now matches _MEMBER_DECL_RE, so `E`
   entered _DECLARED_MEMBERS (pre-T5 `public static double E = ...;`
   did not). The cref heuristic now treats type-argument positions as
   type parameters, not member references.

Docs regenerated (`stdlib generate --force`): csv, math, os, re,
socket, string gain a Properties table of public module values with
element types; `--check` reports up to date.

Gates (worktree at 38a24a5 + this diff):
- pytest test_generate_stdlib_docs.py: 320 passed
- CorpusPinInventoryTests + ApiSurfaceComparisonTests: 15/0/0
- StdlibDocFieldNameBindingTests: 7/0/0 (every documented value binds)
- Lsp HoverTests: 42/0/0

mutation: unwrap identity in the docs generator → red (1 failed,
  roster; --check drift on string.md), restored → green (320)
mutation: [CompilerGenerated] skip removed → red (1 failed, new
  test), restored → green (320)
mutation: python-private skip removed → red (2 failed), restored →
  green (320)
mutation: cref type-argument exemption removed → red (1 failed),
  restored → green (320)
mutation: ClrTypeHelper.ValueTypeOf → identity → red (1 failed:
  hover shows "Double&"), restored → green (1/0/0)

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
claude and others added 29 commits November 19, 2026 04:15
Shorter wording, same rule: /verify-plan's re-opened label and
/verify-implementation's stop on an auditor not run (29 bytes).

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZWuQhE7ZvVZDE3FdDs
The review fixes on this branch add 57 procedure bytes over the
previous raise (145503 -> 145560). Over origin/dev the three additions
now add 1853: /verify-plan +1273, /verify-implementation +490,
/plan-flow +90 (baseline 143707 -> 145560).

The lead asked the owner on 2026-11-19 how the three additions should
land given the ratchet, offering "Raise by exact delta", "Net zero" and
"Definitions in the contract"; the owner answered "Raise by exact delta
(Recommended)".

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZWuQhE7ZvVZDE3FdDs
process(skills): paraphrase first, not-run auditors, second-pass labels
Fix round on check_skill_refs.py after review (PR 2747); history kept.

1. Links resolve as GitHub does: against the citing file's directory, a
   leading / at the repo root, to a file or a directory; never as a
   /skill. Duplicate headings get GitHub's -1, -2 slugs.
2. Number lists and ranges are checked whole (Dimensions 2, 3 and 9,
   Dimensions 1-5, steps 8 and 9, contract §1, §10, a chain then §N).
3. Prose is not a citation: Name step|item|§ N is read only when Name is
   a section of the citing file (else counted bare; known limit in the
   docstring: an own-file citation whose heading was renamed is counted,
   not red). Contract/Charter are read at a sentence start too.
4. Skills: sentence-end /name., **/name**, ``/name`` are read.
5. `/x` §Name and /x Name step N resolve against /x.
6. step/item N: info-string fences do not count, a subsection's items do
   not answer its parent, a list counts at its own indent, ### Step N:
   headings count; a target with no Name takes an item of any section or
   a numbered heading anywhere in it.
7. Info-string fences (```bash, ```markdown) are code: no skill, link,
   section or shorthand is read there; links not in inline code. A bare
   fence stays prose: in these files it is an agent prompt the reader
   follows (/verify-implementation's `/ci-gate` › Control runs).
8. test_every_target_the_check_reads_starts_the_python_workflow: every
   file the checker read (scanned files, targets, .gitignore) is matched
   by RELEVANT_PATHS and push paths; a cited directory by one tracked
   file in it. Patterns added to both lists: .gitignore,
   docs/architecture.md, docs/design/**, docs/audits/**, the cited files
   benchmarks/cross-language/run_benchmarks.py, editors/vscode/
   {CHANGELOG.md,package.json,syntaxes/sharpy.tmLanguage.json},
   src/Sharpy.Compiler.Tests/{Sharpy.Compiler.Tests.csproj,
   CodeGen/EmitterCarrierOnlyConformanceTests.cs,
   Project/ProjectConfigWithInMemorySourcesTests.cs},
   src/Sharpy.Lsp.Tests/Conformance/FrontEndParityTests.cs, and one
   anchor file per otherwise-uncovered cited directory: TestFixtures/
   async/async_basic.spy, Properties/PropertyIterations.cs,
   Benchmarks/Corpus/hello_world.spy, Sharpy.Playground.csproj,
   Sharpy.TestInfrastructure.csproj, Spy/generated/approx_helper_tests.cs.
   Each pattern is necessary (dropping any one turns the test red).

Mutation record (Rule 12): each fix reverted in place (the file copied
to a mktemp -d dir first), test_check_skill_refs.py run, restored with
cp, cmp identical, rerun green (92 passed) every time.
- 1 link resolved repo-root first: red
  test_a_link_resolves_as_github_does_red[[p](docs/process/README.md#
  the-stage-trail)-docs/design/verification-contract.md].
- 1 link resolved like a TARGET: red ...red[[b](/push)-CLAUDE.md] (+1).
- 1 no duplicate-heading suffix: red ...green[link-[x](.claude/skills/
  push/SKILL.md#anchored-heading-1)].
- 2 numbers() keeps the first only: 5 red, e.g. ...red[section-Skip
  Dimensions 1, 3 and 99.], ...[See `/push` › Cleanup and Report,
  steps 8 and 9.], ...[contract-Per contract §1–§9.].
- 2 chain then §N not read: red ...red[section-See `/push` › Output §99.]
- 3 prose Name read as own section: red ...extracts_nothing[Repeat step
  2. See §3 for it. ...], test_prose_numbers_fall_to_the_counted_bare_
  bucket.
- 3 contract case-sensitive: red ...green[contract-Contract §2 holds.]
- 3 charter case-sensitive: red test_prose_numbers_fall_to_the_counted_
  bare_bucket.
- 4 sentence-end . taken as a path: 3 red, ...red[skill-Then run
  /no-such-skill.], test_a_builtin_cited_at_a_sentence_end_counts...
- 4 ** not a word start: red ...red[skill-Use **/nope** now.]
- 4 double backtick not a span start: red ...red[skill-See ``/nope``
  now.] (+ the tree test).
- 5 `/x` §Name not a target form: red ...red[section-See `/push`
  §Testing.]
- 5 bare /skill not a target: red ...red[section-Run /push Critical Rules
  step 1.] and ...green[...Cleanup and Report step 8.]
- 6 numbers in info-string fences count: red ...[Cleanup and Report
  step 3.]; subsection items count for the parent: red ...[step 4.];
  nested items count: red ...[step 5.]; indent 0 only: red
  ...green[Indented, item 2.]; no Step N heading: red ...green[Steps,
  step 2.]; no-name target whole-file only: red ...green[See `/push`
  step 8.] and the tree test.
- 7 code fences read as prose: red ...extracts_nothing[```bash ...] and
  [```markdown ...]; links read in inline code: red
  ...extracts_nothing[Index it as `a[i](x)`.]
- 8 docs/design/** dropped from both lists: red test_every_target_the_
  check_reads_starts_the_python_workflow.

Real tree: green, 0 broken of 1028 (path 529, skill 268, section 111,
contract 103, link 17; bare 101, charter 4). No PROCEDURE_FILES change.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZWuQhE7ZvVZDE3FdDs
Brings in #2746 (skill text) so the reference check runs against it.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZWuQhE7ZvVZDE3FdDs
Two procedure-bytes raises landed on 11-18 (+2,700 bytes in a day), each
on the owner's word through the §4 stop rule, one of them answered on an
estimate 353 bytes below what landed. The owner ruled on 2026-11-19
("both your recs"): the question names the measured delta, never an
estimate, and offers an equal cut in the same counted text as the
default; a raise is for when no cut is found. §4's rise rule now says so.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZXE9K8LiDXK2rj4doP
Review of the first commit: the owner ruled on procedure bytes, but the
rise rule's bullet also covers the side-table pin (a count of SemanticInfo
fields) and allowlist rows, where a "cut" is compiler work or a bug fix
the owner never chose as a default. The equal-cut default now names
procedure and CLAUDE.md bytes; "never an estimate" stays general. "No cut
is found" becomes "the lead finds no cut", which says who looks.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZXE9K8LiDXK2rj4doP
process(docs): a ratchet raise question offers an equal cut first
Second review round on check_skill_refs.py (PR 2747); history kept.

A. The workflow-coverage test skips reads with no tracked file at or
   under them (gitignored .claude/tmp/, .claude/plans/): no PR can
   rename them. Reproduced first: with .claude/tmp/ present the test
   failed on ".claude/tmp (RELEVANT_PATHS)"; now green with it present.
B. charter §N (any case) is claimed before the own-section pass, and an
   own-file Name must equal a section name exactly ("Do" is not
   "**Do not**"). Critical Rules step 9 stays red.
C. /word is no skill citation inside a link target ([d](/docs)), mid
   code span (`msbuild /nologo`), or in NOT_SKILLS = {tmp} (a filesystem
   root; pinned: each entry is a directory under /, none a skill).
D. has_number never reads a fenced line as a heading (`# Role` in a
   prompt); bare-fence items still count.
E. `TARGET [Name] §N|step N|§Name` accepts a bare CLAUDE.md and a
   markdown link; CLAUDE.md no longer matches build_tools/CLAUDE.md.
F. Dimensions 4-design, 6, 7 checks 4, 6, 7; step 1.25 checks 1.25;
   Step/Item after a target or chain; contract §1–99, §1 and 99.
G. Links whose text wraps one line, or whose target has a "title".
H. New counted OUT_OF_SCOPE kind "filename": slash-less file names in
   code spans (sharpy.sln, .python-version), not resolved.
Docstring known limits match the code (own-file renamed or shortened
heading, prefix-cut heading, family example, reference-style links,
code spans split by a hard wrap).

Real tree: 0 broken of 1019 (path 529, skill 262, section 108,
contract 103, link 17; bare 108, charter 4, url 0, filename 185). Lost
to the exact/span-start rules (now bare or not read, none were red):
implement-plan "Cleanup step 4", "Pre-Implementation §2" (x2),
verify-implementation "Cleanup steps 1, 2 and 6", "Cleanup step 4";
seven mid-span /skill mentions.

Mutation record (Rule 12): each fix reverted in place after copying the
file to a mktemp -d dir, test_check_skill_refs.py run, restored with
cp, cmp identical, rerun green (117 passed) every time.
- A untracked reads asserted: red test_coverage_skips_untracked_reads_green
- B charter not claimed first: 3 red, test_out_of_scope_forms_are_counted,
  test_prose_numbers_fall_to_the_counted_bare_bucket, ..._and_named
- B own section by prefix: 2 red, ...extracts_nothing[Charter §3 says so.
  Do step 3 first. See §2 of the plan. CHARTER §4.] (+1)
- C mid-span /word read: red ...extracts_nothing[Run `msbuild /nologo`,
  write to `/tmp`.]
- C link target read as a skill: red
  test_a_root_relative_link_is_a_link_not_a_skill
- C NOT_SKILLS ignored: red ...extracts_nothing[... `/tmp`.]
- D fenced # read as a heading: red ...red[See `/push` › Prompt step 7.],
  ...green[See `/push` › Prompt step 2.]
- E bare CLAUDE.md not a target ahead: red
  test_a_target_ahead_is_the_named_file_green[As CLAUDE.md §Testing
  says.], test_a_target_ahead_is_the_named_file_red
- E CLAUDE.md matches a path tail: red ...red[See build_tools/CLAUDE.md
  › Testing.]
- E link not a target ahead: red ..._green[[c](../../../CLAUDE.md)
  §Testing]
- F 4-design ends the list: red ...red[Run Dimensions 4-design, 6.]
- F 1.25 read as 1: red ...red[See `/push` step 1.3.]
- F Step N not read: red ...red[`/push` › Cleanup and Report, Step 9.]
- F contract continuation needs §: red ...red[contract §1–99.] and
  [contract §1 and 99.]
- G link text may not wrap: red ...red[[a\nb](docs/missing.md)] (+1)
- G link title not read: red ...red[[x](docs/missing.md "a title")] (+1)
- H file names not counted: red
  test_slash_less_file_names_in_code_are_counted

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZWuQhE7ZvVZDE3FdDs
Third review round on check_skill_refs.py (PR 2747); history kept.

1. `step N.M` resolves to a heading numbered N.M; where the target has
   no N.x heading at all it is checked as N (property-stress step 4.2,
   Dimension 3.5, Rule 1.5). `/push` step 1.3 stays red (### 1.25).
2. After a contract citation only a tight range reads a §-less number
   (§1–99); `, 40` and `and 15` are prose again.
3. TARGET_AHEAD_RE is back on lowercase step/item (a `Step 7` on the
   next line is prose); the chain tail keeps Step/Item.
4. LINK_RE is LINK_TARGET: one pattern, "title" included, so a titled
   link works as a chain or §Name target.
7. Fixed (2 lines): the plan template's fenced body is read for numbers
   when resolve() asks for fences, so `Defect Class › Violated contract,
   item 1` can resolve.
8. Left: fence_lines and prose_of index lines alike only if Doc.lines
   and code_regions change too (three lines, not one).
Tests only: NOT_SKILLS is pinned to a fixed tuple of POSIX root names;
the dead half of the Critical Rules red case is cut.
Docstring: missed forms vs. forms that can go red on fine text, and a
gitignored path is any .gitignore match, not only a session's file.

Real tree: 0 broken of 1019, counts unchanged (path 529, skill 262,
section 108, contract 103, link 17).

Mutation record (Rule 12): each fix reverted in place after copying the
file to a mktemp -d dir, test_check_skill_refs.py run, restored with
cp, cmp identical, rerun green (124 passed) every time.
- 1 N.M never falls back to N: red ...green[See `/push` step 8.2;
  Dimension 3.5; Rule 1.5.]
- 2 round-2 continuation restored: red test_fine_text_is_not_red[Per
  contract §2, 40 agents run.] and [Per contract §11 and 15 rows.]
- 2 tight §-less range removed: red ...red[contract-Per contract §1–99.]
- 3 STEP_ANY after a target: red test_fine_text_is_not_red[Use `/push`
  \nStep 7 of the build is next.]
- 4 LINK_TARGET without the title: 4 red, incl. ...green[[p](docs/
  process/README.md "t") › The stage trail.]
- 7 template body skipped for numbers: red ...green[Read Defect Class ›
  Violated contract, item 1.]

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZWuQhE7ZvVZDE3FdDs
Docstring only: the module docstring already says it; the helper's own
line still called every ignored path a session's file.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZWuQhE7ZvVZDE3FdDs
Sixth review of #2742, finding 1: two round-6 comments said a bare
`N.s` inside `G[T]` is spelled by its own chain. Only a receiver chain
that constructs the generic (`G[int].N.s`) is; the bare name inside
the generic still emits the open `G.N` (CS0305 behind SPY0908, at the
base and the tip), the class tracked on #1941. Comments only.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVPaJNNntZNLLiymdp
test(build_tools): check every reference the procedure text makes
The nightly sets CsCheck_Time=15, which turns HotspotModule.Sample(...,
iter: 1500) into a 15 s run. The generator is slow, so on a busy hosted
runner the in-subset floor (samples.Count > 50) became a wall-clock
floor: nightly runs 44458291834 (41 samples) and 43676725192 (48) went
red with no parser mismatch. refs #2458 (cell 6890413350).

Change (CPythonDifferentialParseTests only):
- Collection is an explicit draw loop: candidate i is drawn from its own
  PCG(1, SplitMix64(seed, i)), drawn in parallel batches and walked in
  index order, so the result is fixed by the seed whatever the thread
  count. It stops at targetCount in-subset samples or maxCandidates
  draws. CsCheck_Time no longer reaches it (Gen.Generate, not Sample).
- The seed is random per run, printed, and SHARPY_DIFFPARSE_SEED
  replays it (checked: seed 7919 replays 150/303 exactly).
- New floor: in-subset / candidates >= 0.35, plus the unchanged
  samples > 50, plus dual-parsed > 50 after the mismatch asserts.
- The samples/candidates/ratio/seed line prints before the floors.
- Depth: targetCount = 150 x scale, maxCandidates = 1500 x scale,
  scale = PropertyIterations.Injection / 100 clamped to [1, 6]; the
  nightly's SHARPY_PROPERTY_ITER=600 gives scale 6 (900 samples).

Measured (4 cores, python 3.15.2), scale 1, 30 seeds (7919 x 1..30):
ratio min 0.495, median 0.553, max 0.649, s.d. 0.032; 231-303
candidates; dual-parsed >= 149; 20-42 s per collection. r = 0.35.
Scale 6 (CsCheck_Time=15, SHARPY_PROPERTY_ITER=600): 900 samples from
1554 candidates, ratio 0.579, 181 s collection, 3 m 1 s test.

Guard (rule 12):
- Regression control, original code @ 6d6c5c9 with CsCheck_Time=1:
  red, "Too few in-subset samples generated (8)". New code with
  CsCheck_Time=1: green (see the PR for the run).
- Mutation: SubsetFilter.IsInSharedSubset additionally returned false
  for every in-subset module whose unparsed source's FNV-1a hash was
  not 0 mod 10 (rejects ~90%). Seed 7919: red, "In-subset ratio 0.071
  (106/1500) is below 0.35". The old floor alone (> 50) would have
  passed with 106. Restored from a cp copy (cmp clean): green, 150/303,
  ratio 0.495.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZXE9K8LiDXK2rj4doP
feat(codegen): P77 — N3: module and @static values ready before use
test(parser): count-bound the differential-parse sample floor
plan-775c50 /verify-implementation, class-cure audit: the WithStatement arm
of AsyncGuardedUseAnalyzer.IsStoreTarget could be replaced by false with
FullyQualifiedName~AsyncGuarded still green (25/25), although
DispatchSiteInventoryTests rosters the site as netted by this type. The
generator held a member store only as an assignment's target.

Four uses join the generator, a member of the value as a tuple leaf and as
a for / with / comprehension target, each expected Ensure, over the six
non-const spellings and both views.

Mutations, each on AsyncGuardedUseAnalyzer.cs alone, restored by cp and
cmp, filter FullyQualifiedName~AsyncGuardedUseFactTests (3 tests):
- WithStatement arm -> false: broken -> red (2 failed, 1 passed)
- ForStatement arm -> false: broken -> red (2 failed, 1 passed)
- ForClause arm -> false: broken -> red (2 failed, 1 passed)
- IsElementOf's TupleLiteral arm -> false: broken -> red (2 failed, 1 passed)
- restored -> green (3 passed)
Measured @ a2876b2 plus this change.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZW5iXgCkmJYFuSUhUm
plan-775c50 /verify-implementation. The #2588 cell asserted that stdout
does not contain "main", but ProjectCompilationHelper returns an empty
stdout whenever the program throws, so the absence had no positive control:
a Main that ran the user's body first and the sweep after it stayed green.

main now raises its own ValueError, and the test asserts that the
exception under the reflection wrapper is exactly ZeroDivisionError: the
sweep ran first, and nothing wraps what it raised (D3; Q3).

Mutation, RoslynEmitter.ModuleClass.cs: Main's __Load() appended to its
body in place of inserted first; filter
FullyQualifiedName~StaticInitSweepProjectTests (5 tests):
broken -> red (1 failed, 4 passed: found "ValueError");
restored by cp and cmp -> green (5 passed).
Measured @ a2876b2 plus this change.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZW5iXgCkmJYFuSUhUm
plan-775c50 /verify-implementation, stale artifacts (contract section 11):
- initializer-dependency-differential-allowlist.txt held 0 rows since
  086a550 and was never deleted. The test reads a missing file as empty
  (the ratchet stays), it has no seed line and no pin entry.
- scorecard_metrics.py --lower: allowlist_rows_seed 2379 -> 2377, the two
  rows 410a688 drained without lowering. --check: RESULT OK.
- Two comments that still described drained rows or a retired SPY0618 in
  the present tense now say what holds: SPY0618's forward-read rule is
  retired, the code stays for N2's shape (owner ruling, 2026-11-17).

No assertion changes. The generator's run with the file absent is recorded
in the plan's verification record.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZW5iXgCkmJYFuSUhUm
plan-775c50 /verify-implementation, two docs findings in
parameter_modifiers.md:
- Deferred finding F14 asked the spec to name both moves of an out operand
  on a value not yet initialized. The NameError inside the value's own
  initializer was there; the callee's read by name before the initializer
  was not. New block: 7 42 @ a2876b2, 42 7 @ 6d6c5c9 (the ruling is
  Q-F (a) of the plan's verification summary).
- The ref / in example ran its operands from main, where every value is
  ready at the base too (2 3 3 at both shas), so it did not show
  "initialized first". It now runs them from an earlier initializer:
  3 2 3 @ a2876b2, 0 1 3 @ 6d6c5c9.
Both blocks carry the output marker and were run with sharpyc run (Debug).

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZW5iXgCkmJYFuSUhUm
Independent review of #2751 @ c9179c2 (merge after
fixes), its three findings:

- F1: the comment on the new cells claimed one cell per arm of
  IsElementOf; only its TupleLiteral arm has one. A cell was tried for
  the list arm ([v.x, n0] = ...) and for the parenthesized arm
  ((v.x, n0) = ...): with each arm replaced by false the type stayed green
  (3 passed both times), because the parser gives a list target and a
  parenthesized tuple target a TupleLiteral (sharpyc emit ast, for an
  assignment, a for and a comprehension). A starred member target is
  SPY0106. The two vacuous cells are not added; the comment names the
  three arms no accepted program reaches, and why.
- F2: parameter_modifiers.md says the value stays initialized after the
  callee's read, so its declaration does not run the initializer again.
- F3: gap-discovery-contracts.md no longer describes the deleted
  allowlist file as present.

No assertion and no cell changes against c9179c2: comments and prose only.
FullyQualifiedName~AsyncGuardedUseFactTests|~DispatchSiteInventoryTests:
20 passed, 0 failed, measured on this tree.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZW5iXgCkmJYFuSUhUm
Appends the Implementation Verification Record: five refuting auditors
over 6d6c5c9..f968835 (the merge of #2742), no
regression found, six completeness gaps and two vacuous assertions fixed
on this lane, eleven cells posted to seven open trackers, no issue filed.

Gate, the last code commit's: 85541/0/10 @ 5a5adce (measured, run
44554132404), Python Build Tools green (run 44554139066).

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZW5iXgCkmJYFuSUhUm
test(conformance): P77 verify — guard gaps, stale artifacts, record
Call 46 (`/batch-issues --since-charter`): 6 new issues, 53 new comments
on 26 placed issues, the 22 on the three issues P77 closed, and the
2026-11-16 sweep folded in by reference.

- P77 DONE (plan-775c50; #2422 #2412 #2420 closed); P78 is next.
- New groups: P77d (#2752, filed; full c, d), P101 (#2733; light e),
  P102 (#2734; light).
- Placed: #2721 -> P18, #2723 -> P32 and out as a no-plan lane with
  #2644's None-container cell, #2745 -> P17c; #2749 folded onto #2308
  and closed.
- Rulings: R-PN…R-QH letter what the owner ruled between the calls;
  R-QI…R-QR are the ten decisions of this call.
- Census: 354 open = 17 parked + 337 batched.

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVZgkQLg3eboSCt11b
The owner's word after the call ("post them"): the 2026-11-16 sweep's
moved cells are on its 46 PARTIAL and 7 CHANGED issues, and the two
python-result corrections on #2064 and #2113. The charter's open item
is closed; #2096 got no correction (the report does not say which
result differs).

Co-Authored-By: Claude Fable 5.2 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZVZgkQLg3eboSCt11b
process: 2026-09-20 charter at call 46 @ 396a1b3 — P77d, R-PN…R-QR
Minor bump (pre-1.0) per owner ruling: five breaking stdlib/core fixes
and three feat commits since v0.24.0.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LGMKZYfGwj3H3WNmGpXFFS
@antonsynd
antonsynd merged commit 4582965 into mainline Nov 19, 2026
45 checks passed
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.

2 participants