Completed the documentation update and removed the completed roadmap

examples/config.yml

@@ -1,6 +1,6 @@
-prompt_dir: ./prompts
-profile_dir: ./profiles
-schema_dir: ./schemas
+prompt_dir: ./examples/prompts
+profile_dir: ./examples/profiles
+schema_dir: ./examples/schemas
 
 server:
   addr: :8080

examples/profiles/local-fast.yaml

@@ -0,0 +1,7 @@
+id: local-fast
+endpoint: http://localhost:8000/v1
+model: gpt-4o-mini
+temperature: 0.2
+max_tokens: 500
+top_p: 1.0
+timeout_seconds: 90

examples/profiles/local-quality.yaml

@@ -0,0 +1,8 @@
+id: local-quality
+endpoint: http://localhost:8000/v1
+model: gpt-4.1
+temperature: 0.0
+max_tokens: 1200
+top_p: 1.0
+timeout_seconds: 180
+api_key_env: SCRIPTORIUM_API_KEY

examples/prompts/dnd.session_recap.system.md

@@ -0,0 +1,2 @@
+You create concise tabletop RPG session recaps.
+Stay factual and avoid inventing events.

examples/prompts/dnd.session_recap.user.md

@@ -0,0 +1,10 @@
+Produce a recap with these sections:
+- Session Highlights
+- Open Threads
+- NPC Mentions
+
+Transcript:
+{{input "transcript"}}
+
+Glossary:
+{{input "glossary"}}

examples/prompts/dnd.session_recap.yaml

@@ -0,0 +1,22 @@
+id: dnd.session_recap
+version: "1.0.0"
+default_profile: local-quality
+description: Example D&D session recap prompt definition for demonstration only.
+inputs:
+  - name: transcript
+    required: true
+    content_type: text/markdown
+    description: Session source content
+  - name: glossary
+    required: false
+    content_type: text/yaml
+    description: Optional glossary context
+messages:
+  - role: system
+    content_file: ./dnd.session_recap.system.md
+  - role: user
+    content_file: ./dnd.session_recap.user.md
+output:
+  format: markdown
+  validation_mode: basic
+  repair_attempts: 0

examples/prompts/generic.markdown_summary.system.md

@@ -0,0 +1,2 @@
+You are a concise analysis assistant.
+Write clear Markdown output.

examples/prompts/generic.markdown_summary.user.md

@@ -0,0 +1,7 @@
+Summarize the following source transcript:
+
+{{input "transcript"}}
+
+Reference glossary:
+
+{{input "glossary"}}

examples/prompts/generic.markdown_summary.yaml

@@ -0,0 +1,22 @@
+id: generic.markdown_summary
+version: "1.0.0"
+default_profile: local-fast
+description: Generic markdown summary from transcript and glossary.
+inputs:
+  - name: transcript
+    required: true
+    content_type: text/markdown
+    description: Source transcript content
+  - name: glossary
+    required: false
+    content_type: text/yaml
+    description: Optional glossary context
+messages:
+  - role: system
+    content_file: ./generic.markdown_summary.system.md
+  - role: user
+    content_file: ./generic.markdown_summary.user.md
+output:
+  format: markdown
+  validation_mode: basic
+  repair_attempts: 0

examples/prompts/generic.structured_events.system.md

@@ -0,0 +1,2 @@
+Return only JSON following the requested schema.
+Do not include commentary.

examples/prompts/generic.structured_events.user.md

@@ -0,0 +1,7 @@
+Extract important events from the transcript and emit JSON.
+
+Transcript:
+{{input "transcript"}}
+
+Glossary:
+{{input "glossary"}}

examples/prompts/generic.structured_events.yaml

@@ -0,0 +1,23 @@
+id: generic.structured_events
+version: "1.0.0"
+default_profile: local-quality
+description: Produce structured event JSON from a transcript.
+inputs:
+  - name: transcript
+    required: true
+    content_type: text/markdown
+    description: Source transcript content
+  - name: glossary
+    required: false
+    content_type: text/yaml
+    description: Optional glossary context
+messages:
+  - role: system
+    content_file: ./generic.structured_events.system.md
+  - role: user
+    content_file: ./generic.structured_events.user.md
+output:
+  format: json
+  validation_mode: json_schema
+  schema_path: structured_events.schema.json
+  repair_attempts: 0

examples/schemas/structured_events.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://example.local/structured_events.schema.json",
+  "type": "object",
+  "required": ["summary", "events"],
+  "properties": {
+    "summary": {
+      "type": "string",
+      "minLength": 1
+    },
+    "events": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["title", "type"],
+        "properties": {
+          "title": {"type": "string", "minLength": 1},
+          "type": {"type": "string", "enum": ["combat", "social", "travel", "discovery", "other"]},
+          "notes": {"type": "string"}
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}