tooling
Maps shared build/CLI architecture, compiler assembly identity, candidate installation, generated sections, and host admission.
- License 许可
- Apache-2.0
- 所属仓库
- ByteTerrace/Puck
- 最近更新
- 2026-11-12
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- tooling
- description
- Maps shared build/CLI architecture, compiler assembly identity, candidate installation, generated sections, and host admission.
02 资源文件 2
03 SKILL.md 正文
Build and CLI tooling
Load verification for builds, private CLI copies and leases, and symbol-analysis for finding callers. CI and releases owns repository automation; the CLI reference owns verb behavior. File publication, paths, Git inventories, project ownership and Markdown parsing route to tooling-files.
| Capability | Shared home | Callers and boundary |
|---|---|---|
| Parse project declarations and evaluate architecture policy | ArchitectureModel in build/ProjectArchitecture.cs |
The build task and Puck.Cli.Core compile this source. MSBuild supplies evaluated policy and resolved references; ArchitectureCommand supplies declared facts. Keep resolved-route enforcement (PUCKARCH006) in PuckArchitectureGate. A declared report cannot prove resolved references. |
| Walk project dependencies | ArchitectureGraph | Architecture closures follow assembly edges; affected and shader selection follow all build references. Choose the edge set; share the walk. |
| Traverse assemblies for derivation identity | AssemblyReach.Of |
The default follows Puck.*; WorldCompileCache includes all non-framework compiler dependencies and records missing trimmed modules. WorldCodeWarmer uses the same walk. Keep identity folds with their derivations. |
| Splice generated document sections | CliGeneratedSection.TryReplace |
Packages and the architecture map preserve delimiters and surrounding text, then use CliGeneratedFile.WriteOrCheck, including index agreement. |
| Install an isolated CLI candidate | CandidateCliInstall in build/CandidateCliInstall.cs |
Compiled into Puck.Cli.Release and run as a file-based bootstrap by setup-puck, before a CLI exists. One exclusive feed, private package cache, fresh tool path and version check. The CLI supplies CliProcess; bootstrap Main supplies process I/O only. |
| Acquire and admit leased work | LeasedAdmission.AcquireAsync in Puck.Cli.Core |
LeaseCommand and WorldLaunch share GPU preflight, unreserved before acquisition, then bounded reservation under the hold and release before retry. Heavy work admits with its lease held. The total caller deadline includes acquisition and admission. |
| Bound a measurement window | OperationDeadline in Puck.Abstractions, owned by MeasureCommand |
One clock and cancellation lifetime covers acquisition, settling and draining. MeasureCommand.DrainAsync checks it before each request and sample, and incomplete requests remain pending. CliProcess.RunCapturedAsync stops and reaps the active child tree before the quiet hold is disposed. |
| Recover abandoned lease metadata | CliLease.PruneReleased in Puck.Cli.Core |
Inspection and quiet-priority checks share cleanup under the resource's exclusive guard. Acquisition already replaces metadata once it owns that same guard; process identity and metadata age never override a free guard. |
| Pause a suite budget while waiting for another run | SuiteBudget in Puck.Cli.Core |
Sweep, motion, frame benchmarks and offscreen legs share remaining-time calculation, cancellation and scoped pauses. Offscreen callers lend their existing suite stopwatch. Canary's concurrent leg context already uses CliProcess.RemainingBudget; it does not pause a shared clock while other legs run. |
| Enumerate the live console vocabulary across boot shapes | WorldConsoleVerbs.TryEnumerate in Puck.Cli.Harness |
verbs and docs citations read the structured world.affordances manifest. The catalog excludes authored commands; citation checking includes them. |
| Sample and judge host headroom | HostAdmission, HostProbe, HostStartTracker in Puck.Cli.Harness/Host |
WorldAdmission installs real admission by default, including standalone Puck.Cli.Worlds. Install is a test override; no entry point needs to remember an install call. |
| Turn captured processes into gate outcomes | GateStepResult.Captured |
Gate execution and lock restore preserve merged stream order, refusal exit on timeout, and one timeout annotation. |
The framework-facade MSBuild task runs before Puck projects build; a project reference to the runtime CLI would create a bootstrap dependency and target the wrong runtime. Shared source is intentional. Add a new shared build source to the task's compiler inputs and its assembly-cache identity together.
Admission's guarantee stops at a lease share: releasing one WorldGpuHold
share does not release another live start's share. Cross-process growth
reservations also remain process-local; machine leases serialize device and
heavy starts. Do not describe those reservations as machine-wide exclusion.
This map earns its place by naming the cross-assembly homes and distinctions a name search misses: declared versus resolved references, assembly versus build edges, compiler dependencies versus Puck-only warmup, and bootstrap versus installed CLI execution. Update it with a move or a new caller.
04 同仓库更多 Skills
verification
Verifies Puck changes: landing bar, builds, stale DLLs, flaky tests, GPU/heavy leases, coverage, source-scan or regex laws versus type/compiler enforcement, and writing tests.
tooling-files
Maps shared repository tooling for files, paths, Git queries, project ownership and Markdown fences. Load before adding or changing a helper in these areas.
symbol-analysis
Answers C# structure questions with puck references and declarations: which types derive from, implement or override a symbol, who references it, safe to delete or rename. Text: content-search.
state
Maps Puck's state and rule engine (Puck.State, .Rules, .Search, .Topology, .Vectors, .Generators): arena, journal scopes, undo, hashing, rule compiler, faults, transforms, search, draws.
sdf-authoring
Authors creations: shape rows, primitives, blends, folds, palettes, paints, render lanes, rigs, bake work and bytes, creation stats. Use to sculpt or fix a part. Grammar: puck-dsl; GPU: rendering.
rom-forge
Authors and compiles Puck cartridges (puck.cartridge.v1, *.cgb.puck, *.dmg.puck, *.agb.puck, forge.play, forge.open, puck compile --validate), native compilers, cost. Emulator core is gaming-bricks.