Skip to content

feat: incorporate PetroglyphTools + knowledge-base (vendored/data trees)#189

Merged
Prekzursil merged 2 commits into
mainfrom
feat/incorporate-petroglyphtools-knowledgebase
Jun 28, 2026
Merged

feat: incorporate PetroglyphTools + knowledge-base (vendored/data trees)#189
Prekzursil merged 2 commits into
mainfrom
feat/incorporate-petroglyphtools-knowledgebase

Conversation

@Prekzursil

Copy link
Copy Markdown
Owner

What

Incorporates two read-only support trees from the SWFOC reverse-engineering workspace:

  • PetroglyphTools/ — third-party SWFOC modding tools (C#), reproduced verbatim for provenance (a separate solution, not part of SwfocTrainer.sln; not first-party-maintained).
  • knowledge-base/ — reverse-engineering notes + machine-generated decompile/data JSON (45.5k files) + a SQLite call-graph index.

(ghidra_project from the source workspace is intentionally not included.)

Storage (Git LFS)

  • LFS tracks binary blobs only: callgraph_index.sqlite + PetroglyphTools *.dat/*.meg game-data and test fixtures (via .gitattributes). ~43 MB LFS total (well within the free tier).
  • All JSON / Markdown / JSONL stays in normal git (text).
  • linguist-vendored (PetroglyphTools) / linguist-generated (knowledge-base) keep them out of GitHub language stats and collapse them in diffs.

Lean quality gate — scoped out as vendored/data (first-party scope unchanged)

Consistent with how the repo already handles bridge / imgui / minhook / ghidra_scripts:

  • ruff (lint/format): ruff.toml extend-exclude — no first-party Python in either tree
  • basedpyright (types): pyrightconfig.json exclude
  • coverage: .coveragerc omit — already outside source (scripts/tools)
  • gitleaks (secrets): .gitleaks.toml allowlist — baseline scan 2026-06-28: 0 leaks
  • CodeQL (SAST): codeql-config.yml paths-ignore — PetroglyphTools is C#
  • pre-commit: .pre-commit-config.yaml exclude
  • osv-scanner (deps): no change neededscan source extracts 0 package sources from both trees (bare .csproj, no NuGet lockfile; knowledge-base has no manifests). Verified and documented in osv-scanner.toml.

Local verification (pinned tools, on the committed tree)

  • ruff 0.15.17 check + format --check → pass
  • biome 2.5.0 ci (bundled config) → pass (checked only the 2 first-party JS files; ignored all 45k JSON)
  • oxlint 1.69.0 --deny-warnings → pass
  • gitleaks 8.30.1 detect → no leaks found
  • osv-scanner 2.3.8 scan source --recursive . → no issues found (0 packages from new dirs)

Adds two read-only support trees from the SWFOC RE workspace:

- PetroglyphTools/  third-party SWFOC modding tools (C#), reproduced verbatim
  for provenance (not part of SwfocTrainer.sln; not first-party-maintained).
- knowledge-base/   reverse-engineering notes + machine-generated decompile/data
  JSON (45.5k files) + a SQLite call-graph index.

Storage:
- Git LFS tracks the binary blobs only (callgraph_index.sqlite + PetroglyphTools
  .dat / .meg game-data + test fixtures) via .gitattributes; ~43 MB LFS total.
  All JSON/Markdown/JSONL stays in normal git (text).
- linguist-vendored (PetroglyphTools) / linguist-generated (knowledge-base) keep
  them out of GitHub language stats and collapse them in diffs.

Lean quality gate - scoped OUT consistently with the existing vendored RE editor
trees (bridge/imgui/minhook/ghidra_scripts); first-party scope is unchanged:
- ruff.toml extend-exclude, pyrightconfig.json exclude, .coveragerc omit
  (no first-party Python lives under either tree)
- .gitleaks.toml allowlist paths (baseline scan 2026-06-28: 0 leaks in both)
- .github/codeql/codeql-config.yml paths-ignore (PetroglyphTools is C#)
- .pre-commit-config.yaml exclude
- osv-scanner: no change needed - scan source extracts 0 package sources from
  either tree (bare .csproj without a NuGet lockfile; knowledge-base has no
  manifests); verified 2026-06-28. Documented in osv-scanner.toml.
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@sentry

sentry Bot commented Jun 28, 2026

Copy link
Copy Markdown

🚧 Skipped: PR exceeds review size limit.

Please split into smaller PRs and re-run.
Reference ID: 1489045

…upstream

PetroglyphTools multi-targets .NET 10, which breaks GitHub's native
"Automatic dependency submission" (the Actions runner SDK cannot restore
net10 projects) - a recurring red on this repo. Remove the vendored
PetroglyphTools tree (1090 files) and the PetroglyphTools-specific entries the
incorporation commit added to the lean-gate config (.gitattributes LFS +
linguist-vendored, ruff.toml extend-exclude, pyrightconfig.json exclude,
.coveragerc omit, .pre-commit-config.yaml exclude, .gitleaks.toml allowlist,
.github/codeql/codeql-config.yml paths-ignore, osv-scanner.toml).

Keep the knowledge-base tree (RE notes + decompile/data JSON + its LFS object
callgraph_index.sqlite) and all of its config entries intact.

Document where to obtain PetroglyphTools (AlamoEngine-Tools upstream) in
docs/EXTERNAL-TOOLS.md, linked from README.

Lean gate verified locally (ruff 0.15.17, oxlint 1.69.0, biome 2.5.0,
gitleaks 8.30.1, osv-scanner 2.3.8 all green). No .csproj added, so the
Automatic dependency submission check recovers.
@sentry

sentry Bot commented Jun 28, 2026

Copy link
Copy Markdown

🚧 Skipped: PR exceeds review size limit.

Please split into smaller PRs and re-run.
Reference ID: 1489093

@Prekzursil Prekzursil merged commit baf9b4a into main Jun 28, 2026
8 checks passed
@Prekzursil Prekzursil deleted the feat/incorporate-petroglyphtools-knowledgebase branch June 28, 2026 05:07
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.

1 participant