Takes the project from docs-only to a state where the P0 spike can begin.
Everything here was verified to run, not just written.
Managed
global.json pins the SDK band. Without it `dotnet --version` on this
machine resolved to an 11.0 preview, which silently changes analyzer
behaviour under TreatWarningsAsErrors and makes local and CI disagree
for reasons invisible in a diff. Not mentioned in any doc; added to
12_BUILD.
TargetFramework net10.0-windows10.0.22621.0 with
SupportedOSPlatformVersion 10.0.19045.0. The plan called for a 19041
target, but the SDK rejects SupportedOSPlatformVersion above
TargetPlatformVersion (NETSDK1135), and 19045 is not a targeting-pack
version — the packs are cut at 19041/20348/22000/22621/26100.
12_BUILD already requires the Windows 11 SDK >= 22621, so targeting it
costs nothing while CA1416 still enforces the 22H2 floor from NFR-8.
Solution is FrameLedger.slnx: the XML format is what `dotnet new sln`
produces on .NET 10, and it diffs far better than the classic format.
Six projects plus three test projects, wired to the dependency
direction CLAUDE.md specifies. Builds warning-free under
TreatWarningsAsErrors + AnalysisLevel=latest-all; the only analyzer
suppressions are three WPF codegen constraints, scoped to
src/FrameLedger.App and each explained in .editorconfig.
Pinned SQLitePCLRaw forward: Microsoft.Data.Sqlite 10.0.10 resolves
lib.e_sqlite3 2.1.11, which carries GHSA-2m69-gcr7-jv3q. The build
failed on it, correctly.
Pinned FluentAssertions to the 7.x line. 8.0.0 moved from Apache-2.0
to Xceed's Community Licence, which is not OSI and carries
field-of-use restrictions — exactly what 18_GPU_VENDOR_APIS's vendor
checklist rejects. Dependabot is configured not to major-bump it.
Native
fl_shm.h is the valuable artifact: the corrected four-region layout,
with static_asserts on every size and offset. Compile-verified — all
four structs are exactly 64 bytes with no implicit holes, and the
mapping is 512 KiB + 192 B of header. fl-layout-dump emits those
offsets as JSON for the C# mirror test to consume.
/guard:cf and -D_HAS_EXCEPTIONS=0 are deliberately NOT applied to the
Overlay target yet. Both are unresolved (20_OPEN_QUESTIONS H1, H3);
applying them now would mean meeting the problem as a crash in a real
game rather than as a decision.
Not compiled: this machine has no MSVC C++ workload, so the CMake
targets are unverified. The headers were checked with g++ instead.
Gates
build.ps1 check runs the nine gates, and CI runs that same script.
Gates skip loudly — the run ends "PASSED WITH N SKIPPED GATE(S)"
rather than a clean pass, because a gate that silently passes because
its tool is missing reads as "checked" when nothing was checked.
license-check and rules-validate are real, and were proven red-green
before being wired in: a planted IGCL header fails the licence gate,
and an emptied anticheat.modules list (or a dropped BattlEye entry, or
malformed JSON) fails the rules gate. A safety gate only ever observed
passing has not been tested.
Added a placeholder guard: any {{ token other than {{RELEASE_DATE}}
surviving in README.md or legal/*.md fails the build. Those documents
are displayed for acceptance under FR-11.
rules/detection-rules.json is seeded with a non-empty anticheat block.
An empty one is a fail-closed fixture, not a ship state.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
44 lines
1.1 KiB
YAML
44 lines
1.1 KiB
YAML
# docs/12_BUILD.md: clang-format (LLVM base, 4-space, 120 col), enforced in CI
|
|
# via `clang-format --dry-run -Werror` over src/native.
|
|
---
|
|
Language: Cpp
|
|
BasedOnStyle: LLVM
|
|
|
|
IndentWidth: 4
|
|
TabWidth: 4
|
|
UseTab: Never
|
|
ColumnLimit: 120
|
|
|
|
AccessModifierOffset: -4
|
|
AlignAfterOpenBracket: Align
|
|
AllowShortFunctionsOnASingleLine: Inline
|
|
AllowShortIfStatementsOnASingleLine: Never
|
|
AllowShortLoopsOnASingleLine: false
|
|
AlwaysBreakTemplateDeclarations: Yes
|
|
BreakBeforeBraces: Attach
|
|
BreakConstructorInitializers: BeforeColon
|
|
Cpp11BracedListStyle: true
|
|
FixNamespaceComments: true
|
|
NamespaceIndentation: None
|
|
PointerAlignment: Left
|
|
SortIncludes: CaseInsensitive
|
|
SpaceAfterCStyleCast: false
|
|
SpacesBeforeTrailingComments: 4
|
|
Standard: c++20
|
|
|
|
# Keep the hot-path record and header structs readable as tables: their field
|
|
# comments carry the byte offsets that 07_IPC.md declares normative.
|
|
AlignConsecutiveDeclarations: Consecutive
|
|
AlignTrailingComments: true
|
|
|
|
IncludeBlocks: Regroup
|
|
IncludeCategories:
|
|
- Regex: '^<windows\.h>'
|
|
Priority: 1
|
|
- Regex: '^<(d3d|dxgi|vulkan|GL)'
|
|
Priority: 2
|
|
- Regex: '^<'
|
|
Priority: 3
|
|
- Regex: '^"'
|
|
Priority: 4
|