storyai

Öffnen Sie zuerst dies → docs/index.html

Wenn Sie es im Browser öffnen, sind sieben Dokumente über Links miteinander verbunden. Wenn Sie alles auf einer Seite sehen möchten: docs/storyai-설계-통합.html. Wenn Sie die Oberfläche sehen möchten: docs/07-UI목업.html — es funktioniert tatsächlich.

Related MCP server: bible-ecrivain

Was in diesem Ordner ist

docs/     읽을 것.  설계 문서 7종 + 통합본
spec/     구현이 읽을 것.  온톨로지·툴·규칙·DDL (JSON + SQL)
build/    문서를 고칠 때.  parts/ 수정 후 build.py 실행
skills/   에이전트가 읽을 것.  집필·검수·설정집 3종
hooks/    자동 검사 트리거.  Claude Code / Codex 각각
AGENTS.md 에이전트 지침 단일 소스 ★ 양쪽 호스트가 읽음

manuscript/ api/ web/        ← 후속 단계에서 채웁니다
server/ bible/ store/        ← P0 조회 + P1 제안/커밋 구현

Dokumente

Öffnen Sie docs/index.html im Browser. Die sieben Dokumente verweisen aufeinander.

Maschinenlesbare Spezifikation

Die Dateien, die das Dokument beschreibt und die die Implementierung direkt liest.

spec/ontology.json   노드 18종 · 간선 28종 · 태그 · 삼중 시간축 · 가시성 · 불변식
spec/tools.json      MCP 툴 15개 시그니처 · 예산 · 위험 등급 정책
spec/rules.json      진단 규칙 26개 (Tier 1 결정론 / Tier 2 LLM) · 전파 정책
spec/policy.json     P1 변경 위험 등급 · 잠금 · 캐스케이드 임계값
spec/schema.sql      DDL — 테이블 22 · 뷰 5 · 인덱스 18

Wird direkt mit sqlite3 store/story.db < spec/schema.sql angewendet.

Host-Paket

Funktioniert als ein Satz sowohl mit Claude Code als auch mit Codex.

plugin.json                 agent-plugins 스키마 — Codex가 우선 인식
.claude-plugin/plugin.json  Claude Code 매니페스트 — Codex도 폴백으로 읽음
.mcp.json                   Claude Code용 프로젝트 MCP 설정
.codex/config.toml          Codex용 프로젝트 MCP 설정
AGENTS.md                   ★ 에이전트 지침 단일 소스. 양쪽이 읽음
CLAUDE.md                   AGENTS.md를 가리키는 한 줄
skills/                     Agent Skills 규격 6필드만 — 양쪽 + 46개 호스트
hooks/                      run-check.sh 를 양쪽 훅이 공통 호출

MCP-Verbindung prüfen

Das Repository enthält sowohl .mcp.json für Claude Code als auch .codex/config.toml für Codex. Vertrauen Sie beim ersten Öffnen dem Projekt, genehmigen Sie die MCP-Ausführung und prüfen Sie dann den Verbindungsstatus.

claude mcp list
codex mcp list

Dokumente bearbeiten

Die Dokumente sind Build-Artefakte. Um Inhalte zu ändern, bearbeiten Sie build/parts/*.part.html und:

python3 build/build.py

Der gemeinsame Stil liegt an einer Stelle in build/style.css und wird beim Build in jedes Dokument inline eingebettet — Dadurch ist jedes Dokument eigenständig und wird überall unverändert gerendert. Die einzigen Abhängigkeiten sind die Python-Standardbibliothek.

Implementierungsstatus

P0 schreibgeschützter Index, P1 Schreibpfad, P2 Nebenstränge·Diagnose, P3 Extraktion·Suche sind implementiert. Es werden 14 MCP-Tools bereitgestellt, und alle Schreibvorgänge werden über die Vorschlagsprotokollierung und die read_set-Konfliktprüfung in einer einzigen SQLite-Commit-Spur atomar angewendet. P3 erzwingt ein explizites ID-Binding-Manifest und UTF-8-Byte-Spannen und kombiniert BM25- und lokale sqlite-vec-Ergebnisse per RRF.

Als Nächstes kommt P4 — UI. Die detaillierte Aufschlüsselung folgt Entwicklungsplan §P4.

Entwicklung ausführen

Erstellen Sie eine isolierte Umgebung mit Python 3.12 oder höher und installieren Sie die Entwicklungsabhängigkeiten.

python3 -m venv .venv
.venv/bin/python -m pip install -e '.[dev]'

Das Format der Konfigurationsdateien folgt bible/README.md. Der Loader liest nur die angegebenen YAML-Metadaten und rät nicht über Inhalte oder extrahiert sie nicht automatisch.

.venv/bin/python -m server.load_bible
.venv/bin/python -m server.consolidate
.venv/bin/python -m pytest
server/run-mcp.sh

Die Manuskriptextraktion verwendet *.story.json neben manuscript/**/*.md als Eingabe. Format und LLM-Extraktionsvertrag liegen in prompts/v1/; ingest erstellt nur Proposals und committet nicht automatisch.

Der letzte Befehl ist ein stdio-MCP-Server, daher ist es normal, dass er im Terminal wartet. Claude Code und Codex führen über ihre jeweiligen Projekteinstellungen denselben server/run-mcp.sh-Einstiegspunkt aus.

P1-Schreibvertrag

propose ändert den Live-Graphen nicht. Jede Operation benötigt einen eindeutigen idem_key mit mindestens 8 Zeichen, und read_set darf nicht leer sein. Bei einem ADD ohne bestehende Knotenbasis, wie bei der ersten Session, wird die aktuelle graph_state.revision als { "node": "book", "rev": n } übergeben.

Unterstützte Verben sind ADD · UPDATE · INVALIDATE · LINK · UNLINK. INVALIDATE und UNLINK löschen keine Zeilen, sondern schließen tx_to. commit(mode="dry_run") führt die gleiche Validierung, CID- und Merkle-Berechnung wie real aus und rollt dann die gesamte Transaktion zurück.

story://session/latest zeigt auf den neuesten Session-Knoten. In den props der Session müssen open_threads und next hinterlassen werden, damit der nächste Host übernehmen kann.

P2-Nebenstränge·Kontinuitätsvertrag

Der props.status eines Promise durchläuft nur die Reihenfolge hypothetical → eligible → actualized; eine absichtliche Verwerfung endet mit prevented. eligible erfordert T, actualized erfordert P. promises(status=["eligible"]) gibt F–T–P, Schulden, S-Eff und delta-Coh-Näherungen zurück.

Die Sichtbarkeit eines Facts wird in visible_to mit viewer, learned_at und pathway strukturiert erfasst. Die props.pre · post · forbid-Bedingungen haben die Form subject, field, op, value; Äußerungs-Fakten werden als props.claims=[{"speaker": "character/…", "fact": "fact/…"}] erfasst. Nur mit dieser Struktur kann check Wahrnehmungszeitpunkt, Weltregeln und Faktenkonflikte reproduzierbar per SQL beurteilen.

Zyklen in causes, contains, extends und eine zweite focalizes-Kante pro Scene werden in der Vorschlagsphase abgelehnt. Die übrigen Diagnosen, einschließlich unerreichbarer Ereignisse, werden in den Commit-Ergebnissen und mit check geprüft.