Initial commit

Author: montabano1

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+[*.{rs,toml}]
+indent_size = 4
+
+[Makefile]
+indent_style = tab
+
+[*.md]
+trim_trailing_whitespace = false

.gitattributes

@@ -0,0 +1,19 @@
+# Catetus .gitattributes
+#
+# Local-only directives. These flags do NOT prevent `git push` — that
+# protection requires a pre-push hook (see
+# experiments/partnership-docs-audit/AUDIT.md §6 item 6). They:
+#   - exclude these paths from `git archive` tarballs (export-ignore)
+#   - mark them as documentation/strategy for linguist & language stats
+#   - serve as a human-readable signal that these paths are pre-decisional
+#
+# docs/standards-outreach/** — pre-decisional outreach drafts, NEVER push to
+# public remotes until operator has explicitly authorized each file.
+docs/standards-outreach/**       export-ignore linguist-documentation
+docs/standards-outreach/*.md     export-ignore linguist-documentation
+
+# Same handling for any future re-creation of docs/partnerships/ (the
+# original was removed in commit c003011 but the path is reserved so
+# accidental re-add carries the same protections).
+docs/partnerships/**             export-ignore linguist-documentation
+docs/partnerships/*.md           export-ignore linguist-documentation

.githooks/pre-push

@@ -0,0 +1,128 @@
+#!/usr/bin/env bash
+# Catetus pre-push guard: block partnership/standards-outreach docs from
+# being pushed.
+#
+# Background: 2026-05-15 leak — docs/partnerships/{adobe-spz-memo,contact-map,
+# outreach-sequence}.md and docs/standards-outreach/{khronos-issue,
+# openusd-forum-post}.md were pushed to the public test-hero-fast branch
+# for ~4 days, leading to Khronos issue #2580 being closed citing the leaked
+# outreach doc as evidence the submission was premature.
+#
+# This hook reads the list of ref updates from stdin (git's pre-push protocol)
+# and, for each update, compares the new SHA against the remote SHA. Any added
+# or modified path under docs/partnerships/ or docs/standards-outreach/ aborts
+# the push.
+#
+# Override: CATETUS_PARTNERSHIP_OVERRIDE=1 git push ...
+# (Use ONLY for legitimate cases like deleting a leaked file from history.
+# An audit line is written to stderr when override fires.)
+#
+# Design notes:
+# - FAST: only runs `git diff --name-only` once per ref update.
+# - FAIL-OPEN on diff machinery errors (we don't want to block legit work
+#   if the repo is in a weird state — CI is the belt-and-suspenders).
+# - First-push: when the remote SHA is all-zeros, we diff against
+#   origin/HEAD (or origin/main / origin/master as fallback) to avoid
+#   diffing the entire branch history against /dev/null.
+
+set -u
+
+remote="${1:-origin}"
+# shellcheck disable=SC2034  # url passed by git, unused
+url="${2:-}"
+
+PROTECTED_PATTERN='^docs/(partnerships|standards-outreach)/'
+ZERO='0000000000000000000000000000000000000000'
+
+# Fast bail-out: not pushing? nothing to do.
+if [ -t 0 ]; then
+  exit 0
+fi
+
+# Resolve a fallback base ref for first-push case.
+fallback_base=""
+for candidate in "${remote}/HEAD" "${remote}/main" "${remote}/master"; do
+  if git rev-parse --verify --quiet "${candidate}" >/dev/null 2>&1; then
+    fallback_base="${candidate}"
+    break
+  fi
+done
+
+violations=""
+while read -r local_ref local_sha remote_ref remote_sha; do
+  # Branch deletion: local_sha is zeros, nothing to check.
+  if [ "${local_sha}" = "${ZERO}" ]; then
+    continue
+  fi
+
+  # Determine the diff range.
+  if [ "${remote_sha}" = "${ZERO}" ]; then
+    # First push of this branch. Diff against fallback base if available;
+    # otherwise diff against the empty tree (covers the no-fallback case
+    # without erroring out).
+    if [ -n "${fallback_base}" ]; then
+      range="${fallback_base}..${local_sha}"
+    else
+      # Empty tree SHA — every file becomes "added".
+      empty_tree="$(git hash-object -t tree /dev/null 2>/dev/null || echo '4b825dc642cb6eb9a060e54bf8d69288fbee4904')"
+      range="${empty_tree}..${local_sha}"
+    fi
+  else
+    range="${remote_sha}..${local_sha}"
+  fi
+
+  # FAIL-OPEN: if diff machinery errors, let the push through (CI catches it).
+  changed="$(git diff --name-only --diff-filter=AM "${range}" 2>/dev/null)" || {
+    echo "pre-push: warning — git diff failed for ${range}; skipping protection (CI will still check)" >&2
+    continue
+  }
+
+  hits="$(printf '%s\n' "${changed}" | grep -E "${PROTECTED_PATTERN}" || true)"
+  if [ -n "${hits}" ]; then
+    violations="${violations}${violations:+$'\n'}--- ${local_ref} -> ${remote_ref} ---"$'\n'"${hits}"
+  fi
+done
+
+if [ -z "${violations}" ]; then
+  exit 0
+fi
+
+if [ "${CATETUS_PARTNERSHIP_OVERRIDE:-}" = "1" ]; then
+  who="$(git config user.email 2>/dev/null || echo 'unknown')"
+  when="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+  echo "==============================================================" >&2
+  echo "pre-push: OVERRIDE engaged (CATETUS_PARTNERSHIP_OVERRIDE=1)" >&2
+  echo "  user:  ${who}" >&2
+  echo "  when:  ${when}" >&2
+  echo "  remote: ${remote}" >&2
+  echo "  paths overridden:" >&2
+  printf '%s\n' "${violations}" | sed 's/^/    /' >&2
+  echo "==============================================================" >&2
+  exit 0
+fi
+
+cat >&2 <<EOF
+==============================================================
+pre-push: BLOCKED — partnership/outreach docs in push
+
+The following paths are protected and MUST NOT be pushed to any
+remote (the repo flips public eventually; these docs never should):
+
+${violations}
+
+Why: a 2026-05-15 leak of docs/partnerships/* on the public
+test-hero-fast branch produced concrete external fallout
+(Khronos issue #2580 closed citing the leaked outreach doc).
+See experiments/partnership-docs-audit/AUDIT.md.
+
+Options:
+  1) Drop these paths from the push:
+       git restore --staged docs/partnerships docs/standards-outreach
+       git commit --amend            # or rebase to remove the commits
+  2) Legitimate exception (e.g. deleting a leaked file from
+     history, intentional internal-only remote):
+       CATETUS_PARTNERSHIP_OVERRIDE=1 git push ...
+     (An audit line will be written to stderr.)
+==============================================================
+EOF
+exit 1

.github/CODEOWNERS

@@ -0,0 +1,7 @@
+# Catetus code owners.
+#
+# Until there are more humans on the project, everything routes to the
+# project lead for review. Add path-scoped rules above the catch-all as
+# new maintainers come on board.
+
+* @montabano1

.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,34 @@
+---
+name: Bug report
+about: Something is broken or behaves unexpectedly
+title: "bug: "
+labels: bug
+---
+
+## What happened
+
+<!-- Brief description. -->
+
+## What you expected
+
+## Reproduction
+
+Steps:
+1.
+2.
+
+If possible attach (or link to) a minimal PLY/SPZ/glTF fixture.
+
+```bash
+catetus --version
+catetus analyze your-fixture.ply
+```
+
+## Environment
+
+- OS / arch: <!-- e.g. macOS arm64 14.5 -->
+- catetus version: <!-- catetus --version -->
+- Rust version: <!-- rustc --version -->
+- Browser (if viewer issue): <!-- e.g. Chromium 124 / Safari 17.5 -->
+
+## Anything else

.github/ISSUE_TEMPLATE/corpus_request.md

@@ -0,0 +1,54 @@
+---
+name: SplatBench corpus contribution
+about: Contribute a real splat scene to the public benchmark corpus
+title: "corpus: add <scene-name>"
+labels: corpus
+---
+
+## Scene name
+
+## Class
+
+<!-- Choose one or more PRD corpus classes -->
+
+- [ ] small product scan
+- [ ] people / characters
+- [ ] indoor real estate
+- [ ] outdoor scene
+- [ ] reflective / transparent failure case
+- [ ] noisy capture with floaters
+- [ ] dense large scene
+- [ ] mobile-friendly scene
+- [ ] glTF KHR conformance asset
+- [ ] SPZ test asset
+- [ ] OpenUSD test asset
+
+## Source
+
+<!-- Where did the capture come from? Capture device / app, capture date,
+     post-processing pipeline (Inria 3DGS / Polycam / etc.). -->
+
+## License / rights
+
+- [ ] Public domain / CC0
+- [ ] Permissive (CC-BY, MIT-style)
+- [ ] Apache 2.0
+- [ ] Other open license: <!-- which -->
+- [ ] Private / design-partner (do not redistribute)
+
+## Asset description
+
+- Splat count (approx):
+- File size (raw PLY MB):
+- Bounding box (approx):
+- SH degree:
+- Known capture artifacts (floaters, missing geometry, etc.):
+
+## Download
+
+<!-- Direct URL or HuggingFace dataset reference. For private assets, link to
+     a signed-URL contact channel. -->
+
+## Reference images
+
+<!-- A couple of reference renders are very helpful. -->

.github/ISSUE_TEMPLATE/feature.md

@@ -0,0 +1,26 @@
+---
+name: Feature request
+about: Suggest a new feature or improvement
+title: "feat: "
+labels: enhancement
+---
+
+## What problem does this solve
+
+<!-- Who benefits and why. -->
+
+## Proposal
+
+<!-- What you'd like to see. -->
+
+## Alternatives considered
+
+## Spec impact
+
+- [ ] No spec change (refactor/perf only)
+- [ ] Amends existing spec: `specs/####-...md`
+- [ ] Requires a new spec
+
+## Non-goals
+
+<!-- What this is explicitly NOT trying to do. -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,25 @@
+## Summary
+
+<!-- One-paragraph description of what this PR does. -->
+
+## Related spec / issue
+
+- spec: `specs/####-...md` (or "n/a — refactor")
+- closes #
+
+## Checklist
+
+- [ ] Tests added (unit / integration / snapshot / property as appropriate)
+- [ ] `cargo fmt --all -- --check` is clean
+- [ ] `cargo clippy --workspace --all-targets -- -D warnings` is clean
+- [ ] `cargo test --workspace` passes
+- [ ] `pnpm -r run lint && pnpm -r run test` passes
+- [ ] Public API changes documented in CHANGELOG.md under `## [Unreleased]`
+- [ ] If parser/format change: malformed fixture added in `fixtures/invalid/`
+- [ ] If optimizer change: before/after pass stats emitted
+- [ ] If renderer change: visual-regression snapshot updated only if spec required
+- [ ] Commits are `Signed-off-by:` (DCO)
+
+## Notes for the reviewer
+
+<!-- Anything tricky, anything you're unsure about, anything you punted on. -->

.github/workflows/bench-regression-pr-comment.yml

@@ -0,0 +1,80 @@
+name: bench-regression-pr-comment
+
+# On every PR opened/synced against main, run the bench matrix in DRY mode
+# first (so the PR comment shows up fast and free), and if the PR is
+# labeled `run-bench` (manual opt-in to spend ~$42 on Modal), re-run the
+# matrix live and post a real table.
+#
+# Comparison baseline: benches/reports/splatbench-v0.json's
+# continuousBench.latestCells from main's HEAD. Any cell that regresses
+# >= 0.3 dB PSNR (or > 5% larger output) is highlighted with a warning.
+#
+# This workflow informs only — it does NOT block merge. The user is the
+# final auto-ship arbiter per CLAUDE.md project policy.
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize, reopened, labeled]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  comment:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with: { fetch-depth: 2 }
+      - uses: actions/setup-node@v4
+        with: { node-version: "20" }
+      - name: Build regression table from current main's continuousBench
+        id: tbl
+        shell: bash
+        run: |
+          set -euo pipefail
+          node - <<'JS' > /tmp/bench-comment.md
+          import { readFileSync, existsSync } from "node:fs";
+          const path = "benches/reports/splatbench-v0.json";
+          if (!existsSync(path)) {
+            console.log("_SplatBench v3 has no continuous data yet — first run pending._");
+            process.exit(0);
+          }
+          const r = JSON.parse(readFileSync(path, "utf8"));
+          const cont = r.continuousBench ?? { latestCells: {}, commits: [] };
+          const cells = cont.latestCells ?? {};
+          const keys = Object.keys(cells);
+          if (!keys.length) {
+            console.log("_SplatBench v3 has no continuous cells yet (likely awaiting first successful workflow run)._");
+            process.exit(0);
+          }
+          console.log("## SplatBench v3 — current main snapshot\n");
+          console.log("This PR will run the full (preset × scene) matrix on merge (or on the `run-bench` label).");
+          console.log(`Last bench commit: \`${cont.lastCommit?.slice(0,7) ?? "(unknown)"}\` (${cont.lastCommitAt ?? "n/a"})\n`);
+          console.log("| Preset | Scene | ΔPSNR (dB) | PLY save (%) | Output |");
+          console.log("|---|---|---:|---:|---|");
+          for (const k of keys.sort()) {
+            const c = cells[k];
+            const dp = c.delta_psnr_db == null ? "—" : c.delta_psnr_db.toFixed(2);
+            const sv = c.ply_save_pct == null ? "—" : (c.ply_save_pct * 100).toFixed(1);
+            const link = c.output_url ? `[ply](${c.output_url})` : "—";
+            console.log(`| \`${c.preset}\` | \`${c.scene}\` | ${dp} | ${sv} | ${link} |`);
+          }
+          if ((cont.lastRejections ?? []).length) {
+            console.log("\n### Last cells rejected by ≤0.3 dB drop rule");
+            for (const rj of cont.lastRejections) {
+              console.log(`- \`${rj.key}\` — ${rj.reason}`);
+            }
+          }
+          JS
+          {
+            echo "body<<EOF"
+            cat /tmp/bench-comment.md
+            echo "EOF"
+          } >> "$GITHUB_OUTPUT"
+      - name: Post sticky PR comment
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          header: splatbench-v3
+          message: ${{ steps.tbl.outputs.body }}