Git based markdown wiki orchestrator
Find a file
tegwick def699c1eb feat(adapters): GitShardAdapter history adopt + cross-substrate integration (WP-0012 T3)
Adopt git-native history (TSD §A.5): a VERSION-gated history(key) surfaces the
commit list for a path (newest-first sha + subject) — declared by every git-IS-store
shard, read-only or not. Integration proves the union/overlay/edit machinery works
unchanged across folder + git substrates: resolve/chorus span both, edit through a
git shard fast-forwards as a commit, apply-under-drift refuses on an external commit
(sha drift) without clobbering, and a read-only git target keeps the overlay as a
draft. SCOPE updated; WP-0012 done. 196 tests green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-16 02:41:19 +02:00
demand research: write up wiki-engines landscape scan; send IAM demand to netkingdom 2026-06-13 18:18:45 +02:00
docs Reorganize documentation into canonical repository layout 2026-06-08 13:55:27 +02:00
history history(SHARD-WP-0013 T3): reuse-surface gap proposals + consumptions; derived-views registered 2026-06-15 22:28:29 +02:00
issues Reorganize documentation into canonical repository layout 2026-06-08 13:55:27 +02:00
registry Add capability registry scaffold and seed entries from reuse-surface 2026-06-16 01:34:23 +02:00
research research: SHARD-WP-0004 synthesis (the computational page model); workplan done 2026-06-15 00:12:03 +02:00
spec adr: ADR-0001 engine activation via feature-control (OpenFeature, availability-only) 2026-06-15 23:48:49 +02:00
src/shard_wiki feat(adapters): GitShardAdapter history adopt + cross-substrate integration (WP-0012 T3) 2026-06-16 02:41:19 +02:00
tests feat(adapters): GitShardAdapter history adopt + cross-substrate integration (WP-0012 T3) 2026-06-16 02:41:19 +02:00
wiki Reorganize documentation into canonical repository layout 2026-06-08 13:55:27 +02:00
workplans feat(adapters): GitShardAdapter history adopt + cross-substrate integration (WP-0012 T3) 2026-06-16 02:41:19 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-06-16 00:57:09 +02:00
.gitignore Reorganize documentation into canonical repository layout 2026-06-08 13:55:27 +02:00
AGENTS.md Reorganize documentation into canonical repository layout 2026-06-08 13:55:27 +02:00
CLAUDE.md Reorganize documentation into canonical repository layout 2026-06-08 13:55:27 +02:00
INTENT.md intent(SHARD-WP-0013 T4): ratify additive native engine — headless, API-first, agent-optimized 2026-06-15 22:43:46 +02:00
LICENSE Initial commit 2026-05-15 21:23:05 +00:00
pyproject.toml test: harden suite with error-path contracts + coverage floor (98%) 2026-06-16 00:05:16 +02:00
README.md Reorganize documentation into canonical repository layout 2026-06-08 13:55:27 +02:00
SCOPE.md feat(adapters): GitShardAdapter history adopt + cross-substrate integration (WP-0012 T3) 2026-06-16 02:41:19 +02:00

shard-wiki

Git-based Markdown wiki orchestrator and federation layer.

shard-wiki joins heterogeneous wiki-shaped page stores (shards) into a coherent information space while preserving provenance, capabilities, and history. It is an orchestration layer, not a wiki engine.

Status

Early-stage: Python scaffold, intent and specification groundwork, active design workplan. See SCOPE.md for current maturity.

Documentation

Document Purpose
INTENT.md Aspiration and boundaries
SCOPE.md What we achieve now
AGENTS.md Agent working guide
docs/repository-layout.md How this repo organizes information

Quick start

pip install -e ".[dev]"
pytest

Layout

research/     explorations (yymmdd-prefixed)
demand/       inbound unreviewed requirements
spec/         implementation specifications
workplans/    State Hubregistered tasks
docs/         stakeholder documentation
wiki/         collaborative knowledge (wiki UI when connected)
issues/       ticket mirrors
history/      archived material (yymmdd-prefixed)