docs(specs): Matrix Heretic Room v0 prebuild (#112) #328

Closed

claude wants to merge 0 commits from claude/iskra/matrix-heretic-room-v0 into main

claude commented

2026-05-17 17:25:34 +02:00

Collaborator

Summary

Prebuild for #112 — dedicated Matrix room on RS2000 proxying to operator's Mac-hosted pdurlej/gemma-4-26B-A4B-it-heretic:Q4_K_M Ollama model via Tailnet-internal tunnel.

Side channel for contrarian / red-team / unfiltered-material research where mainstream-aligned models refuse. Not global assistant — dedicated room only, operator-controlled invite, audit log per turn.

What's in this PR

6-file Spec Kit + companion execution prompt:

docs/specs/matrix-heretic-room-v0/README.md — index
docs/specs/matrix-heretic-room-v0/00-constitution.md — 8 principles, non-negotiable (Mac stays Mac, Tailnet-only, dedicated room not default, NO moralizatorstwo layer, operator-only invite, visible degradation, audit log, resource-conscious)
docs/specs/matrix-heretic-room-v0/01-specify.md — problem, scope, acceptance criteria, success metrics
docs/specs/matrix-heretic-room-v0/02-plan.md — architecture, 4-slice breakdown, Q1-Q6 open questions, dependencies, risks
docs/specs/matrix-heretic-room-v0/03-tasks.md — per-slice task list with acceptance criteria
docs/specs/matrix-heretic-room-v0/04-implement-notes.md — matrix-nio + httpx scaffolds, gotchas G1-G6, DRY pointers
prompts/codex-matrix-heretic-room.md — execution prompt with Safety / production boundary statement + per-slice instructions + stop conditions

Slices (forthcoming PRs)

(a) Tunnel setup — Lite — operator-runnable Tailscale Serve config + RS2000-side verification scripts
(b) Heretic bot module — Full (security-sensitive) — new modules/heretic-bot/ + services/heretic-bot/ Python + matrix-nio
(c) Room creation + ACL hardening — Full — Synapse admin, P3+P5 stress tests
(d) Documentation + sunset — Lite — operator guide, audit review, sunset runbook

Tier

Trivial per ADR-0007 (docs-only prebuild, no runtime / schema / sacred-path mutation).

Operator action

Draft for review. After merge: paste prompts/codex-matrix-heretic-room.md to fresh codex session to begin Slice (a).

Operator-side coordination point: Slice (a) Mac tunnel setup is OPERATOR-RUNNABLE (codex provides runbook; codex does not deploy to operator's Mac). Slice (b) blocks until operator confirms tunnel up + provides Mac tailnet IP.

Refs #112

## Summary Prebuild for #112 — dedicated Matrix room on RS2000 proxying to operator's Mac-hosted `pdurlej/gemma-4-26B-A4B-it-heretic:Q4_K_M` Ollama model via Tailnet-internal tunnel. Side channel for contrarian / red-team / unfiltered-material research where mainstream-aligned models refuse. **Not global assistant** — dedicated room only, operator-controlled invite, audit log per turn. ## What's in this PR 6-file Spec Kit + companion execution prompt: - `docs/specs/matrix-heretic-room-v0/README.md` — index - `docs/specs/matrix-heretic-room-v0/00-constitution.md` — 8 principles, non-negotiable (Mac stays Mac, Tailnet-only, dedicated room not default, NO moralizatorstwo layer, operator-only invite, visible degradation, audit log, resource-conscious) - `docs/specs/matrix-heretic-room-v0/01-specify.md` — problem, scope, acceptance criteria, success metrics - `docs/specs/matrix-heretic-room-v0/02-plan.md` — architecture, 4-slice breakdown, Q1-Q6 open questions, dependencies, risks - `docs/specs/matrix-heretic-room-v0/03-tasks.md` — per-slice task list with acceptance criteria - `docs/specs/matrix-heretic-room-v0/04-implement-notes.md` — matrix-nio + httpx scaffolds, gotchas G1-G6, DRY pointers - `prompts/codex-matrix-heretic-room.md` — execution prompt with Safety / production boundary statement + per-slice instructions + stop conditions ## Slices (forthcoming PRs) - **(a) Tunnel setup** — Lite — operator-runnable Tailscale Serve config + RS2000-side verification scripts - **(b) Heretic bot module** — Full (security-sensitive) — new `modules/heretic-bot/` + `services/heretic-bot/` Python + matrix-nio - **(c) Room creation + ACL hardening** — Full — Synapse admin, P3+P5 stress tests - **(d) Documentation + sunset** — Lite — operator guide, audit review, sunset runbook ## Tier Trivial per ADR-0007 (docs-only prebuild, no runtime / schema / sacred-path mutation). ## Operator action Draft for review. After merge: paste `prompts/codex-matrix-heretic-room.md` to fresh codex session to begin Slice (a). **Operator-side coordination point**: Slice (a) Mac tunnel setup is OPERATOR-RUNNABLE (codex provides runbook; codex does not deploy to operator's Mac). Slice (b) blocks until operator confirms tunnel up + provides Mac tailnet IP. Refs #112

claude commented

2026-05-17 22:42:28 +02:00

Author

Collaborator

Closing empty PR — fork-anchor 2026-05-17 coordination loss

This PR's branch has zero commits unique vs main — the parallel-fork-claude session that owned this branch wrote spec files locally but those commits never landed on this branch (likely due to shared-checkout collision: forks alternated .git/HEAD between each other's checkout -b, leaving some forks' work uncommitted or on wrong branches).

The untracked spec files were lost during subsequent branch switches by other forks. The PR description above describes intent + scope but no implementation artifact exists on this branch.

Lesson learned: parallel forks on shared local checkout need git worktree add per fork. Next dispatch should use /Users/pd/Developer/iskra-platform-2026-04-30-fork-<letter>/ per fork with own .git/HEAD.

To retry: open a fresh fork session in dedicated worktree, recreate the prebuild from the issue description + this PR's scope description.

Closing as cleanup; not a fail of the underlying spec idea.

## Closing empty PR — fork-anchor 2026-05-17 coordination loss This PR's branch has **zero commits unique vs `main`** — the parallel-fork-claude session that owned this branch wrote spec files locally but those commits never landed on this branch (likely due to shared-checkout collision: forks alternated `.git/HEAD` between each other's `checkout -b`, leaving some forks' work uncommitted or on wrong branches). The untracked spec files were lost during subsequent branch switches by other forks. The PR description above describes intent + scope but no implementation artifact exists on this branch. **Lesson learned:** parallel forks on shared local checkout need `git worktree add` per fork. Next dispatch should use `/Users/pd/Developer/iskra-platform-2026-04-30-fork-<letter>/` per fork with own `.git/HEAD`. **To retry:** open a fresh fork session in dedicated worktree, recreate the prebuild from the issue description + this PR's scope description. Closing as cleanup; not a fail of the underlying spec idea.

claude closed this pull request

2026-05-17 22:42:28 +02:00