feat: migrate to Core's git-free incremental (#401)

[Svilen-Stefanov]

Why

CodeBoarding Core's content-versioning stack (CodeBoarding#401) removed the git-ref incremental API. Once it merges to Core main, this action breaks: engine_adapter.py calls run_full/run_incremental with the old signatures (repo_path=/output_dir=/base_ref=/target_ref=/source_sha=), which now raise TypeError. metadata.commit_hash — which sync mode used to identify its baseline — is also gone.

New Core API:

• run_full(run_paths: RunPaths, run_context: RunContext, depth_level=, source_sha=)
• run_incremental(run_paths: RunPaths, run_context: RunContext) — no base/target ref; it diffs a whole-tree fingerprint.json sidecar against the checkout itself.

Changes

engine_adapter.py

• Migrate every run_full/run_incremental call to (RunPaths, RunContext) via a _run_ctx() helper. Drop base_ref/target_ref from run_incremental and from the head subcommand + argparser.
• run_seed now also writes fingerprint.json (hash_repo_source_files) — the baseline git-free incremental diffs against.
• run_analyze (sync): drop the commit_hash trustworthiness gate. A present analysis.json runs incremental (Core self-falls-back to full on a missing sidecar/cache); full only on --force-full or no baseline.

action.yml

Sync mode is naturally git-free ("analyze the latest state, commit the architecture back") — so it no longer needs a baseline SHA or a worktree:

• Seed the sync workdir from the committed .codeboarding/ directly (analysis.json + fingerprint.json), gated on both files' presence. Removed the baseline-SHA git worktree add seed and the commit_hash lookup.
• Commit fingerprint.json back alongside analysis.json + the pkl, so the next sync's baseline is self-contained. Dropped the now-redundant SHA-keyed sync static-analysis cache (the pkl travels via git, a more durable cross-runner baseline).

Review mode stays git-based — a PR review inherently compares two commits — but its base seed now also emits fingerprint.json, and the base cache key is bumped v2 → v3 (the cached base dir now includes the sidecar).

Tests

Updated the engine_adapter/sync stubs for the new Core symbols (RunPaths/RunContext/write_fingerprint/hash_repo_source_files) and rewrote the head/analyze tests for the (RunPaths, RunContext) call shape and the git-free baseline gate. 171 passing.

Depends on

• CodeBoarding#401 (the content-versioning stack that changes the Core API).
• Companion Core-side fix: CodeBoarding#406 (github_action.py, Core's own docs.yml entry point — a different file from this action repo).

🤖 Generated with Claude Code

Outdated analysis.json migration

The action now defaults to CodeBoarding Core 0.13.0. Before attempting an incremental run, it loads the baseline through the installed Core's UnifiedAnalysisJson model and requires a lossless model round-trip. This detects old or otherwise incompatible formats without hardcoding individual JSON properties.

Sync mode

1. The committed baseline is checked for compatibility.
2. If it is incompatible, incremental analysis is skipped and a full analysis runs at the baseline's recorded depth (subject to the configured tier limit).
3. The new 0.13-compatible analysis.json, fingerprint, and caches are committed back to the branch.
4. The analysis_mode output reports full; later sync runs return to incremental.

Review mode

1. The target-branch baseline is checked before analyzing the PR.
2. If it is incompatible, the action runs a full analysis of the target commit to create a fresh comparison baseline.
3. The PR head is then analyzed against that fresh baseline and the architecture diff/comment is produced normally.

Review mode does not commit the migrated baseline. The sync job persists it. Therefore no manual migration is required: the first affected run performs the necessary full rebuild, and subsequent runs can be incremental again.

[codeboarding-review]

Architecture review · failed

The architecture diff couldn't be generated for this run. See the workflow logs for details.

_{codeboarding-action · run 29246147062}

[Svilen-Stefanov]

LGTM.