Files
poli0981andClaude Opus 5 5b61a20482 build: scaffold the repository the docs assume
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>
2026-08-02 17:38:39 +07:00

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