Analysis Files

How ChapterWise stores analysis results in sibling .analysis.json files

Analysis Files

Analysis results in ChapterWise are stored as sibling files next to your source codex files. This design allows your analysis to travel with your manuscript and be version-controlled alongside your content.

File Naming Convention

Source File	Analysis File
`manuscript.codex.yaml`	`manuscript.analysis.json`
`chapters/chapter-1.codex.md`	`chapters/chapter-1.analysis.json`
`story.codex.json`	`story.analysis.json`

The analysis file always shares the same base name as the source file, with .analysis.json replacing the codex extension.

Why JSON?

Analysis files use JSON format (not YAML) for performance reasons:

5-30x faster parsing compared to YAML
Analysis is machine-generated, not human-edited
Uses the orjson library for maximum speed
Still follows the codex structure format

File Structure

Analysis files use the standard codex format with specialized node types:

{
  "metadata": {
    "formatVersion": "1.2",
    "created": "2026-02-02T12:34:56Z",
    "updated": "2026-02-02T14:00:00Z"
  },
  "id": "manuscript-analysis",
  "type": "analysis",
  "name": "Analysis Results",
  "attributes": [
    {"key": "sourceFile", "value": "manuscript.codex.yaml"},
    {"key": "sourceHash", "value": "abc123def456..."}
  ],
  "children": [
    {
      "id": "characters",
      "type": "analysis-module",
      "name": "Characters",
      "children": [
        {
          "id": "entry-20260202T123456Z",
          "type": "analysis-entry",
          "status": "published",
          "attributes": [
            {"key": "model", "value": "claude-sonnet-4"},
            {"key": "sourceHash", "value": "abc123def456..."},
            {"key": "analysisStatus", "value": "current"}
          ],
          "body": "## Character Analysis\n\n### Main Characters\n..."
        }
      ]
    }
  ]
}