storyai

まずこれを開いてください → docs/index.html

ブラウザで開くと、7つのドキュメントが互いにリンクでつながっています。 1枚ですべて見たい場合は docs/storyai-설계-통합.html。 画面を見たい場合は docs/07-UI목업.html — 実際に動作します。

Related MCP server: bible-ecrivain

このフォルダにあるもの

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 제안/커밋 구현

ドキュメント

docs/index.html をブラウザで開いてください。7つのドキュメントが互いに参照し合っています。

機械可読用スペック

ドキュメントが説明する対象であり、実装が直接読み取るファイルです。

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

sqlite3 store/story.db < spec/schema.sql でそのまま適用されます。

ホストパッケージ

Claude CodeとCodexの両方で1セットで動作します。

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接続確認

リポジトリにはClaude Code用の.mcp.jsonとCodex用の.codex/config.tomlの両方が入っています。 初回オープン時にプロジェクトを信頼し、MCP実行を承認したうえで接続状態を確認します。

claude mcp list
codex mcp list

ドキュメント修正

ドキュメントはビルド成果物です。内容を修正するには build/parts/*.part.html を修正し:

python3 build/build.py

共通スタイルは build/style.css の1か所にあり、ビルド時に各ドキュメントへインライン展開されます — そのためドキュメント1つひとつが自己完結型で、どこに置いてもそのままレンダリングされます。 依存関係はPython標準ライブラリのみです。

実装状況

P0 読み取り専用インデックス、P1 書き込みパス、P2 複線・診断、P3 抽出・検索が 実装済みです。MCPツール14個を提供し、すべての書き込みは提案記録と read_set 衝突 判定を経て、単一のSQLiteコミットレーン上で原子的に適用されます。P3は明示的なIDバインディング マニフェストとUTF-8バイトスパンを強制し、BM25とローカルsqlite-vecの結果をRRFで結合します。

次はP4 — UIです。詳細な分解は 開発計画書 §P4 に従います。

開発実行

Python 3.12以上で隔離環境を作成し、開発依存関係をインストールします。

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

設定集ファイル形式は bible/README.md に従います。ローダーは明示された YAMLメタデータのみを読み取り、内容を推測したり自動抽出したりしません。

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

原稿抽出は manuscript/**/*.md の隣にある *.story.json を入力として使用します。形式と LLM抽出契約は prompts/v1/ にあり、ingest はProposalのみを作成し、 自動コミットしません。

最後のコマンドはstdio MCPサーバーであるため、ターミナルで待機するのが正常です。Claude Codeと Codexはそれぞれのプロジェクト設定を通じて、同じ server/run-mcp.sh エントリポイントを 実行します。

P1 書き込み契約

propose はライブグラフを変更しません。各opには8文字以上の一意な idem_key が 必要で、read_set は空にできません。最初のSessionのように既存ノードの根拠がない ADDは、現在の graph_state.revision を { "node": "book", "rev": n } として渡します。

サポートされるverbは ADD · UPDATE · INVALIDATE · LINK · UNLINK です。INVALIDATE と UNLINK は行を削除せず、tx_to を閉じます。commit(mode="dry_run") は実際と 同じ検証・CID・Merkle計算を実行した後、トランザクション全体をロールバックします。

story://session/latest は最も新しいSessionノードを指します。Sessionの props には open_threads と next を必ず残し、次のホストが引き継げるようにします。

P2 複線・連続性契約

Promiseの props.status は hypothetical → eligible → actualized の順序でのみ進行し、 意図的な破棄は prevented で終わります。eligible にはT、actualized にはPが必要です。 promises(status=["eligible"]) はF–T–Pと負債、S-Eff、delta-Coh近似値を返します。

Factの可視性は visible_to にviewer、learned_at、pathwayを構造化して記録します。Sceneの props.pre · post · forbid 条件はsubject、field、op、value形式であり、発話事実は props.claims=[{"speaker": "character/…", "fact": "fact/…"}] で記録します。この構造を 使用して初めて check が認知時点・世界ルール・事実衝突をSQLで再現可能に判定します。

causes、contains、extends の循環と、Sceneごとの2番目の focalizes エッジは提案段階で 拒否されます。到達不能イベントを含む残りの診断は、commit結果と check で確認します。