@tophtab/homer 0.1.0

package/.homer/adapters/agents/skills/homer/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: homer
+description: "Route Homer novel-assistant requests inside a single-book project. Use when Codex needs to initialize a Homer project, write or polish chapters, accept chapters into canon, rebuild public lore/tracking, rebuild author-lore indexes, or decide which Homer workflow applies."
+---
+
+# Homer Router
+
+Load Homer state before acting:
+
+```bash
+python3 .homer/scripts/homer.py status
+```
+
+Read:
+
+- `.homer/workflow.md`
+- `.homer/spec/hard-rules.md`
+- `.homer/state/chapters.json`
+
+## Route
+
+- Setup, init, repair, or import existing chapters: use `homer-setup`.
+- Write, continue, expand, polish, or revise chapters: use `homer-write`.
+- Accept chapters, rebuild public lore/tracking, or rebuild author-lore indexes: use `homer-sync`.
+
+If `.homer/` is missing or `.homer/scripts/homer.py` is unavailable and the user wants Homer behavior, route to `homer-setup`.
+
+## Boundaries
+
+- One project is one book.
+- `设定/`, `大纲/`, and `正文/` are author-owned freeform files.
+- Default writing does not read full `设定/`.
+- `accepted` chapters are canon and are not edited by default.
+- `draft` chapters are editable.
+- Public lore and tracking are generated only from accepted chapters.
+- After writing, do not auto-accept or auto-sync.

package/.homer/adapters/agents/skills/homer-setup/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: homer-setup
+description: "Initialize or repair a Homer single-book novel project. Use when setting up .homer infrastructure, scanning existing chapter files, creating or fixing .homer/state/chapters.json, confirming imported chapter statuses, or generating .agents/.codex adapter files from Homer sources."
+---
+
+# Homer Setup
+
+Initialize or repair the current directory as one Homer book project.
+
+## Steps
+
+1. Read `HOMER_MVP_SPEC.md` if present.
+2. Read `.homer/spec/setup.md` and `.homer/spec/hard-rules.md` if present.
+3. Ensure `设定/`, `大纲/`, `正文/`, and `.homer/` infrastructure exist.
+4. Run:
+
+```bash
+python3 .homer/scripts/homer.py init --scan
+```
+
+5. Inspect `.homer/state/chapters.json`.
+6. If existing chapter status is uncertain, ask before changing status.
+7. Generate adapters:
+
+```bash
+python3 .homer/scripts/homer.py generate-adapters
+```
+
+## Existing Chapter Status
+
+- Empty `正文/`: initialize empty state.
+- One existing chapter: ask whether it is `draft` or `accepted` unless the user made it clear.
+- Multiple existing chapters: confirm all accepted, all draft, first N accepted, or a custom pattern.
+- Imported completed or serialized works may be marked accepted only when the user says they are completed/published.
+
+Do not guess batch chapter status.
+
+## After Setup
+
+Run:
+
+```bash
+python3 .homer/scripts/homer.py status
+```
+
+If accepted chapters exist, use `homer-sync` to rebuild public lore and tracking.

package/.homer/adapters/agents/skills/homer-sync/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: homer-sync
+description: "Accept Homer chapters into canon and rebuild structured knowledge. Use when the user says to accept/采纳 a chapter, sync after writing, rebuild public lore, rebuild tracking, mark accepted chapters current after knowledge rebuild, or rebuild the author-lore JSON index from freeform 设定/."
+---
+
+# Homer Sync
+
+Use sync to accept chapters and rebuild structured JSON knowledge.
+
+Read before syncing:
+
+- `.homer/workflow.md`
+- `.homer/spec/hard-rules.md`
+- `.homer/spec/sync.md`
+- `.homer/state/chapters.json`
+
+## Chapter Acceptance
+
+When the user asks to accept a chapter:
+
+```bash
+python3 .homer/scripts/homer.py accept <chapter>
+```
+
+Then:
+
+1. Read all `accepted` chapters from `.homer/state/chapters.json`, ordered by chapter number.
+2. Rebuild `.homer/knowledge/public-lore/` from accepted chapter text.
+3. Rebuild `.homer/knowledge/tracking/` from accepted chapter text.
+4. Run:
+
+```bash
+python3 .homer/scripts/homer.py mark-current
+```
+
+## Public Lore
+
+Public lore stores reader-known knowledge only. Each item must include source chapter and evidence.
+
+Separate:
+
+- `shown_fact`
+- `reader_inference`
+- `character_claim`
+- `rumor`
+- `misdirection`
+
+## Tracking
+
+Tracking stores current serial state extracted directly from accepted chapters:
+
+- context
+- timeline
+- character state
+- foreshadowing
+- patches for accepted-canon issues that should be repaired later
+
+## Author Lore
+
+Rebuild `.homer/knowledge/author-lore/` only when requested, during setup, or when a task needs author settings. Extract explicit facts separately from inferences, candidates, conflicts, and obsolete notes.
+
+Do not modify `设定/` unless the user explicitly asks.

package/.homer/adapters/agents/skills/homer-write/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: homer-write
+description: "Write, continue, expand, polish, or revise web-novel chapters in a Homer project. Use when the user provides a chapter draft, asks for prose improvement, asks to continue or expand a chapter, gives direction for a new chapter, or wants direct edits under 正文/."
+---
+
+# Homer Write
+
+Writing and polishing are one business flow. Edit target files directly under `正文/`.
+
+## Required Checks
+
+Read before editing:
+
+- `.homer/workflow.md`
+- `.homer/spec/hard-rules.md`
+- `.homer/spec/write.md`
+- `.homer/state/chapters.json`
+
+Identify the target chapter and file.
+
+- If target chapter is `accepted`, do not edit unless the user explicitly asks for canon revision.
+- If target chapter is `draft`, edit the file directly.
+- If target chapter is missing, create it under `正文/` and register it as `draft`.
+
+## Context Selection
+
+Use minimal context:
+
+- Current user instruction.
+- Current chapter outline in `大纲/` when relevant.
+- Relevant `.homer/knowledge/public-lore/*.json`.
+- Relevant `.homer/knowledge/tracking/*.json`.
+- Previous or directly related accepted chapter text only when needed.
+- `.homer/spec/` rules.
+
+Do not read full `设定/` by default. If hidden author settings are required, read only relevant `.homer/knowledge/author-lore/` slices.
+
+## Editing Semantics
+
+- Polish, `打磨`, `优化`: refine existing material.
+- `续写`: continue from existing material.
+- `扩写`: add detail and complete underwritten parts.
+- `重写`: replace only when explicitly requested.
+
+If unclear, preserve and improve or expand instead of replacing.
+
+Do not introduce canon-changing plot, important new characters, new world rules, relationship changes, or major foreshadowing unless authorized.
+
+## Finish
+
+Run after editing:
+
+```bash
+python3 .homer/scripts/homer.py check
+```
+
+Do not auto-accept or sync. Tell the user the chapter remains draft and can be accepted with `homer-sync`.

package/.homer/adapters/codex/config.toml

@@ -0,0 +1,2 @@
+# Homer project-local Codex config.
+# Codex hooks require user-level ~/.codex/config.toml to enable hooks.

package/.homer/adapters/codex/hooks/inject-homer-state.py

@@ -0,0 +1,45 @@
+#!/usr/bin/env python3
+"""Inject a compact Homer state block for Codex turns."""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+
+
+def find_root(start: Path) -> Path | None:
+    current = start.resolve()
+    while current != current.parent:
+        if (current / ".homer").is_dir():
+            return current
+        current = current.parent
+    return None
+
+
+def main() -> int:
+    root = find_root(Path.cwd())
+    if root is None:
+        return 0
+    script = root / ".homer" / "scripts" / "homer.py"
+    if not script.is_file():
+        return 0
+    try:
+        result = subprocess.run(
+            [sys.executable, str(script), "hook-state"],
+            cwd=root,
+            text=True,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.DEVNULL,
+            timeout=2,
+            check=False,
+        )
+    except Exception:
+        return 0
+    if result.stdout.strip():
+        print(result.stdout.rstrip())
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/.homer/adapters/codex/hooks.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 -X utf8 .codex/hooks/inject-homer-state.py",
+            "timeout": 15
+          }
+        ]
+      }
+    ]
+  }
+}

package/.homer/adapters/codex/skills/homer-start/SKILL.md

@@ -0,0 +1,26 @@
+---
+name: homer-start
+description: "Load Homer project state and workflow context in Codex. Use when starting work in a Homer novel project, when Codex hooks are unavailable, when the session was restarted, or when the assistant needs current Homer routing state before setup/write/sync work."
+---
+
+# Homer Start
+
+Run:
+
+```bash
+python3 .homer/scripts/homer.py status
+```
+
+Then read:
+
+- `.homer/workflow.md`
+- `.homer/spec/hard-rules.md`
+- `.homer/state/chapters.json`
+
+Route the user's request:
+
+- Setup, init, repair, import, adapter regeneration: `homer-setup`.
+- Write, continue, expand, polish, revise: `homer-write`.
+- Accept chapters, rebuild public lore/tracking, rebuild author-lore: `homer-sync`.
+
+If `.homer/scripts/homer.py` is missing, initialize or repair with `homer-setup`.

package/.homer/knowledge/author-lore/index.json

@@ -0,0 +1,5 @@
+{
+  "schema_version": 1,
+  "source": "设定/",
+  "items": []
+}

package/.homer/knowledge/public-lore/index.json

@@ -0,0 +1,5 @@
+{
+  "schema_version": 1,
+  "source": "accepted chapters",
+  "items": []
+}

package/.homer/knowledge/tracking/character-state.json

@@ -0,0 +1,5 @@
+{
+  "schema_version": 1,
+  "source": "accepted chapters",
+  "characters": []
+}

package/.homer/knowledge/tracking/context.json

@@ -0,0 +1,5 @@
+{
+  "schema_version": 1,
+  "source": "accepted chapters",
+  "current_context": []
+}

package/.homer/knowledge/tracking/foreshadowing.json

@@ -0,0 +1,5 @@
+{
+  "schema_version": 1,
+  "source": "accepted chapters",
+  "threads": []
+}

package/.homer/knowledge/tracking/patches.json

@@ -0,0 +1,5 @@
+{
+  "schema_version": 1,
+  "source": "accepted chapters",
+  "patches": []
+}

package/.homer/knowledge/tracking/timeline.json

@@ -0,0 +1,5 @@
+{
+  "schema_version": 1,
+  "source": "accepted chapters",
+  "events": []
+}