Epic: v1 refocus trim — cut to the core

[pskry]

Epic: v1 refocus trim — cut to the core

Tracking issue for the v1 refocus trim. Every trim commit references
this issue ((#N)); the final reconcile closes it.

Context

After the v2 (k8s-style reconciler) and v3 (full rewrite) detours, the
conclusion was that v1's architecture was right — the project died
of scope creep, not design. v3 is preserved at pskry/scampi-v3; v1 is
restored as the canonical scampi-dev/scampi. This epic trims v1 back
to a focused core so it can actually ship.

Direction: keep the convergence spine — lang → engine → step → target → diagnostic/render — and cut everything that's a bet on a frozen
frontend, a single vendor, or a speculative ecosystem.

Decisions

Area	Decision	Reasoning
lsp/ + scampls	cut	Frontend isn't frozen enough to support stable tooling. Revisit when scampi-lang stabilizes.
benchmarks/ + CI	cut	Baseline-tracking apparatus (51 baselines, VPS runner, HTML dashboard) is premature; perf isn't a current concern. Keep Benchmark* funcs + smoke so ad-hoc go test -bench still works.
step/pve + target	cut	Proxmox — one vendor, ~3.7k LOC, larger than engine. Out of scope until the core is solid.
step/rest + target	cut	The openapi-composition bet (raw rest.request → idempotent rest.resource). Elegant, but premature on a non-frozen frontend. Revive later — the shape is right, the timing isn't.
mod/	strip	Keep the manifest parser + local multi-file/submodule loading (mod.Parse, ~240 LOC). Cut the ~1600-LOC remote dependency manager (fetch/resolve/tidy/sum/vanity), the scampi mod CLI, the VerifyAll gate, and linker/remote.go. The remote half is the speculative module-registry ecosystem.
step/container	keep	Docker/Podman is a real, broadly-useful capability. Clean structure (parallel to pkg/svc backends), zero entanglement with core file ops. Muscle, not fat.
index command	cut	Too narrow to be useful.
site/	TBD	Separate Go module, doesn't affect the binary. Decided during the CI/GitHub reconcile.
Codeberg mirror	TBD	v3 may have clobbered it; reconcile during the CI pass.

Checklist

• Drop lsp/ + cmd/scampls
• Drop benchmarks/ tracking apparatus (keep Benchmark funcs + smoke)
• Drop step/pve + target/pve + std/pve
• Drop step/rest + target/rest + target/mem_rest + std/rest
• Strip mod/ to the parser; cut the remote dependency manager
• Reconcile CI / mirror / release / site workflows with the trim
• Triage remaining issues against the trimmed scope

Recoverability

• Pre-trim snapshot tagged pre-trim-2026-06-23.
• One commit per area — reviving any cut is git revert <commit> (or
  cherry-picking the deleted tree back).

Issue triage done alongside

31 cut-aligned issues already closed as "not planned" (lsp/editor, pve,
rest, index, external-module ecosystem). Remaining mod-internals issues
get closed when the mod strip lands.

[pskry]

Progress — 3 of 5 cuts landed (local, unpushed):

• dc3671cb chore: drop lsp & scampls — 12,463 lines
• 04a2acf0 chore: drop benchmark tracking apparatus
• c8386482 chore: drop pve step, target & std module — 7,361 lines

Deferred cosmetic cleanup (not blocking): spec.ResourceLXC/LXCResource and the pve.lxc examples in deploy_graph.go/spec.go/attribute_check.go comments survive — they're used as generic dependency-graph test fixtures in engine/deploy_graph_test.go, not coupled to the pve package. Excising them means rewriting that test suite; left for a follow-up.

Remaining: rest (step/target/std), mod strip, CI/mirror/site reconcile.

Note: the local mod/linker remote-dependency tests fail under tag.gpgsign=true (signed tags need a message); environmental, green on CI, and that code is deleted in the mod strip anyway.

[pskry]

All 5 code cuts landed (local, unpushed). just test all is fully green — the mod strip deleted the remote-dep tests that were failing under tag.gpgsign.

• dc3671cb drop lsp & scampls — −12,463
• 04a2acf0 drop benchmark tracking apparatus
• c8386482 drop pve step, target & std — −7,361
• 063a370c drop rest subsystem (+ gen, kin-openapi) — −8,600
• 78f324e5 strip mod to manifest parser, cut remote dep manager — −5,245

Kept: container (Docker/Podman), local multi-file/submodule configs (mod.Parse + the local loader).

Remaining (this epic): docs sweep (stale man pages + site docs), CI/mirror/release reconcile, site fate, close the now-moot mod-internals issues, then close this epic.

[pskry]

Reconcile done (still local, unpushed):

• CI/release/site-deploy now run via jdx/mise-action reading .mise.toml + go.mod toolchain — same exact tool versions as local, so local-green = CI-green.
• Tooling pinned: .mise.toml (go 1.26.4, just 1.53.0, shellcheck 0.11.0, jq 1.8.2); toolchain go1.26.4 in both go.mod files.
• Man pages dropped entirely (doc/man/, the manpages recipe, md2man tool).
• Site cut to the bone: landing + install + a curated Examples/Steps page; the whole docs/ reference tree, bench dashboard, and lsp/rest/pve/gen pages gone. Install-script generation folded into one static install.sh (one binary, no template).
• Scripts pruned: bin-size, dev-run (folded into scampi-dev), scampls-dev, diagnostic-span-report, the AI issue-automation pipeline (+ issues.just).
• Mirror: self-heals on next push (force-mirrors GitHub→Codeberg).
• Issues: 9 more closed (mod remote-dep machinery), 40 total this pass.

7 commits stacked. Codeberg mirror reconciles on push. This epic closes once the stack is pushed.