cc-agentic-framework 1.14.1

package/framework/modules/writer/schemas/manifest.schema.json

@@ -0,0 +1,155 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://agentic-framework.dev/schemas/writer/manifest.schema.json",
+  "title": "World Directory Manifest Schema",
+  "description": "Schema for _manifest.json files in world directories",
+  "type": "object",
+  "required": ["directory", "type", "created", "facts"],
+  "properties": {
+    "directory": {
+      "type": "string",
+      "description": "Path to this directory relative to world root"
+    },
+    "type": {
+      "type": "string",
+      "enum": ["immutable", "append-only", "expandable"],
+      "description": "Mutability type for this directory"
+    },
+    "created": {
+      "type": "string",
+      "format": "date",
+      "description": "Date when this directory was created"
+    },
+    "description": {
+      "type": "string",
+      "description": "Description of what this directory contains"
+    },
+    "facts": {
+      "type": "array",
+      "description": "Array of all facts in this directory",
+      "items": {
+        "type": "object",
+        "required": ["file", "hash", "established", "version", "summary"],
+        "properties": {
+          "file": {
+            "type": "string",
+            "description": "Filename or relative path to fact file"
+          },
+          "fact-id": {
+            "type": "string",
+            "pattern": "^world-[a-z]+-[a-z0-9-]+$",
+            "description": "Unique fact identifier"
+          },
+          "hash": {
+            "type": "string",
+            "description": "Current content hash (SHA-256)"
+          },
+          "established": {
+            "type": "string",
+            "format": "date",
+            "description": "Date when fact was established"
+          },
+          "version": {
+            "type": "string",
+            "pattern": "^\\d+\\.\\d+\\.\\d+$",
+            "description": "Current version of the fact"
+          },
+          "immutable": {
+            "type": "boolean",
+            "description": "Whether this specific fact is immutable"
+          },
+          "summary": {
+            "type": "string",
+            "description": "Brief summary of the fact for quick reference"
+          },
+          "token-estimate": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Estimated token count for full content"
+          },
+          "summary-token-estimate": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Estimated token count for summary only"
+          },
+          "category": {
+            "type": "string",
+            "description": "Category of the fact"
+          },
+          "depends-on": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "IDs of facts this depends on"
+          },
+          "referenced-by": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "IDs of content referencing this fact"
+          },
+          "additions-count": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Number of additions (for append-only facts)"
+          },
+          "expansions-count": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Number of expansions (for expandable facts)"
+          }
+        }
+      }
+    },
+    "total-token-estimate": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total estimated tokens for all facts in this directory"
+    },
+    "total-summary-tokens": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total tokens if loading only summaries"
+    },
+    "fact-count": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total number of facts in this directory"
+    },
+    "last-validated": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Timestamp of last validation check"
+    },
+    "validation-status": {
+      "type": "string",
+      "enum": ["valid", "invalid", "warning", "not-validated"],
+      "description": "Result of last validation"
+    },
+    "validation-errors": {
+      "type": "array",
+      "description": "Array of validation errors if any",
+      "items": {
+        "type": "object",
+        "properties": {
+          "file": {
+            "type": "string",
+            "description": "File with the error"
+          },
+          "error": {
+            "type": "string",
+            "description": "Error description"
+          },
+          "severity": {
+            "type": "string",
+            "enum": ["error", "warning"],
+            "description": "Severity level"
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/framework/modules/writer/schemas/prerequisites.schema.json

@@ -0,0 +1,171 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Prerequisites Schema",
+  "description": "Schema for narrative prerequisites in parts, chapters, and scenes",
+  "type": "object",
+  "properties": {
+    "baseline": {
+      "type": "string",
+      "description": "ID of baseline document (for parts)"
+    },
+    "requires-parts": {
+      "type": "array",
+      "items": { "type": "integer" },
+      "description": "Part numbers that must be complete before this part"
+    },
+    "requires-chapters": {
+      "type": "array",
+      "items": { "type": "integer" },
+      "description": "Chapter numbers in current part that must be complete"
+    },
+    "part": {
+      "type": "integer",
+      "description": "Parent part number (for chapters)"
+    },
+    "chapter": {
+      "type": "integer",
+      "description": "Parent chapter number (for scenes)"
+    },
+    "prior-scene": {
+      "type": ["string", "null"],
+      "description": "Filename of immediately prior scene"
+    },
+    "prior-state": {
+      "type": "object",
+      "properties": {
+        "last-scene": { "type": "string" },
+        "time-since": { "type": "string" },
+        "location": { "type": "string" }
+      }
+    },
+    "world-state": {
+      "type": "object",
+      "description": "World state changes at this point",
+      "properties": {
+        "time-elapsed": { "type": "string" },
+        "location-shift": { "type": "string" },
+        "date": { "type": "string" },
+        "era": { "type": "string" }
+      }
+    },
+    "character-states": {
+      "type": "object",
+      "description": "State of each character at this point",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "physical": { "type": "string" },
+          "emotional": { "type": "string" },
+          "location": { "type": "string" },
+          "status": { "type": "string" },
+          "knows": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "doesnt-know": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "current-goal": { "type": "string" },
+          "knowledge-gained-last-chapter": {
+            "type": "array",
+            "items": { "type": "string" }
+          }
+        }
+      }
+    },
+    "required-threads": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Plot threads that must be established"
+    },
+    "active-tensions": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Unresolved tensions active at this point"
+    },
+    "world-elements-required": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "World fact IDs needed for this section"
+    },
+    "relevant-world-facts": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "World fact IDs relevant to this scene"
+    },
+    "reader-knows": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "What the reader knows at this point"
+    },
+    "immediate": {
+      "type": "object",
+      "description": "Immediate scene context",
+      "properties": {
+        "time": { "type": "string" },
+        "location": { "type": "string" },
+        "weather": { "type": "string" },
+        "lighting": { "type": "string" }
+      }
+    },
+    "characters-present": {
+      "type": "array",
+      "description": "Characters in this scene",
+      "items": {
+        "type": "object",
+        "required": ["id"],
+        "properties": {
+          "id": { "type": "string" },
+          "state": { "type": "string" },
+          "position": { "type": "string" }
+        }
+      }
+    },
+    "sensory": {
+      "type": "object",
+      "description": "Sensory context for the scene",
+      "properties": {
+        "dominant": { "type": "string" },
+        "secondary": { "type": "string" },
+        "ambient": { "type": "string" }
+      }
+    },
+    "mood": {
+      "type": "string",
+      "description": "Overall mood of scene"
+    },
+    "tension-level": {
+      "type": "string",
+      "enum": ["low", "medium", "high", "extreme"],
+      "description": "Tension level for pacing"
+    },
+    "pov-state": {
+      "type": "object",
+      "description": "POV character's internal state",
+      "properties": {
+        "current-thought": { "type": "string" },
+        "current-fear": { "type": "string" },
+        "physical-sensation": { "type": "string" }
+      }
+    },
+    "token-budget": {
+      "type": "object",
+      "description": "Token limits for context loading",
+      "properties": {
+        "full": { "type": "integer" },
+        "full-context": { "type": "integer" },
+        "summary": { "type": "integer" },
+        "summary-context": { "type": "integer" },
+        "scene-context": { "type": "integer" },
+        "chapter-context": { "type": "integer" },
+        "max-context": { "type": "integer" },
+        "world-facts": { "type": "integer" },
+        "character-context": { "type": "integer" },
+        "immediate-setting": { "type": "integer" },
+        "style-guidance": { "type": "integer" },
+        "remaining-for-prose": { "type": "integer" }
+      }
+    }
+  }
+}

package/framework/modules/writer/schemas/token-budgets.json

@@ -0,0 +1,129 @@
+{
+  "$schema": "./token-budgets.schema.json",
+  "version": "1.0.0",
+
+  "defaults": {
+    "scene-writing": {
+      "total": 2000,
+      "allocation": {
+        "immediate-context": 200,
+        "chapter-summary": 150,
+        "world-facts": 400,
+        "character-context": 400,
+        "style-guidance": 200,
+        "prerequisites": 150,
+        "active-threads": 100,
+        "reserve": 400
+      }
+    },
+    "chapter-planning": {
+      "total": 3000,
+      "allocation": {
+        "part-context": 300,
+        "chapter-arc": 400,
+        "scene-summaries": 500,
+        "character-states": 500,
+        "world-facts": 600,
+        "style-guidance": 200,
+        "foreshadowing": 200,
+        "reserve": 300
+      }
+    },
+    "part-planning": {
+      "total": 5000,
+      "allocation": {
+        "baseline": 500,
+        "part-arc": 600,
+        "chapter-summaries": 800,
+        "character-arcs": 800,
+        "world-facts-full": 1000,
+        "themes": 400,
+        "style-guidance": 300,
+        "reserve": 600
+      }
+    }
+  },
+
+  "world-fact-priorities": {
+    "core": 1,
+    "magic": 2,
+    "geography": 3,
+    "characters": 4,
+    "history": 5,
+    "factions": 6,
+    "artifacts": 7,
+    "languages": 8,
+    "calendars": 9
+  },
+
+  "summary-requirements": {
+    "world-fact": {
+      "max-summary-tokens": 100,
+      "required-for-token-count-over": 300
+    },
+    "character": {
+      "max-summary-tokens": 80,
+      "required-for-token-count-over": 200
+    }
+  },
+
+  "context-levels": {
+    "minimal": {
+      "name": "minimal",
+      "max-tokens": 500,
+      "sections": [
+        "immediate",
+        "pov-voice-summary",
+        "active-tensions"
+      ]
+    },
+    "scene": {
+      "name": "scene",
+      "max-tokens": 1500,
+      "sections": [
+        "immediate",
+        "pov-voice",
+        "chapter-summary",
+        "world-facts-summary",
+        "style-guidance"
+      ]
+    },
+    "chapter": {
+      "name": "chapter",
+      "max-tokens": 2500,
+      "sections": [
+        "immediate",
+        "pov-voice",
+        "chapter-full",
+        "part-summary",
+        "world-facts",
+        "characters-present",
+        "foreshadowing"
+      ]
+    },
+    "part": {
+      "name": "part",
+      "max-tokens": 4000,
+      "sections": [
+        "baseline-summary",
+        "part-full",
+        "chapter-summaries",
+        "character-arcs",
+        "world-facts-full",
+        "themes"
+      ]
+    },
+    "full": {
+      "name": "full",
+      "max-tokens": 6000,
+      "sections": [
+        "baseline-full",
+        "part-full",
+        "chapter-full",
+        "all-characters",
+        "all-world-facts",
+        "style-full"
+      ]
+    }
+  }
+}

package/framework/modules/writer/schemas/token-budgets.schema.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Token Budgets Configuration Schema",
+  "description": "Schema for token budget configuration file",
+  "type": "object",
+  "required": ["version", "defaults"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "defaults": {
+      "type": "object",
+      "properties": {
+        "scene-writing": {
+          "$ref": "#/definitions/budgetAllocation"
+        },
+        "chapter-planning": {
+          "$ref": "#/definitions/budgetAllocation"
+        },
+        "part-planning": {
+          "$ref": "#/definitions/budgetAllocation"
+        }
+      }
+    },
+    "world-fact-priorities": {
+      "type": "object",
+      "description": "Priority order for loading world facts (lower = higher priority)",
+      "additionalProperties": { "type": "integer" }
+    },
+    "summary-requirements": {
+      "type": "object",
+      "properties": {
+        "world-fact": {
+          "type": "object",
+          "properties": {
+            "max-summary-tokens": { "type": "integer" },
+            "required-for-token-count-over": { "type": "integer" }
+          }
+        },
+        "character": {
+          "type": "object",
+          "properties": {
+            "max-summary-tokens": { "type": "integer" },
+            "required-for-token-count-over": { "type": "integer" }
+          }
+        }
+      }
+    },
+    "context-levels": {
+      "type": "object",
+      "properties": {
+        "minimal": { "$ref": "#/definitions/contextLevel" },
+        "scene": { "$ref": "#/definitions/contextLevel" },
+        "chapter": { "$ref": "#/definitions/contextLevel" },
+        "part": { "$ref": "#/definitions/contextLevel" },
+        "full": { "$ref": "#/definitions/contextLevel" }
+      }
+    }
+  },
+  "definitions": {
+    "budgetAllocation": {
+      "type": "object",
+      "properties": {
+        "total": {
+          "type": "integer",
+          "minimum": 500,
+          "maximum": 10000
+        },
+        "allocation": {
+          "type": "object",
+          "additionalProperties": { "type": "integer" }
+        }
+      }
+    },
+    "contextLevel": {
+      "type": "object",
+      "properties": {
+        "name": { "type": "string" },
+        "max-tokens": {
+          "type": "integer",
+          "minimum": 100,
+          "maximum": 10000
+        },
+        "sections": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    }
+  }
+}