@redaksjon/protokoll 0.0.12 → 0.0.13

package/guide/routing.md

@@ -7,48 +7,88 @@ The routing system determines where transcribed notes should be saved.
 Protokoll uses multi-signal classification to route notes:
 
 1. Analyzes transcript text for project signals
-2. Matches against configured triggers
+2. Matches against configured triggers in project files
 3. Builds output path using Dreadcabinet patterns
 
-## Configuration
+## Default Output Configuration
 
-### Default Routing
+The default output location is set in the main config:
 
 ```yaml
 # ~/.protokoll/config.yaml
+outputDirectory: "~/notes"
+outputStructure: "month"
+outputFilenameOptions:
+  - date
+  - time
+  - subject
+```
+
+This is where notes go when no project matches.
+
+## Project-Specific Routing
+
+To route notes to different destinations based on content, create **project files** in your context directory:
+
+### Example Project File
+
+```yaml
+# ~/.protokoll/projects/work.yaml
+id: work
+name: Work Notes
+type: project
+
+classification:
+  context_type: work
+  explicit_phrases:
+    - "work note"
+    - "about work"
+    - "office meeting"
+  topics:
+    - "standup"
+    - "sprint"
+    - "roadmap"
+  associated_people:
+    - "colleague-id"
+  associated_companies:
+    - "acme-corp"
+
 routing:
-  default:
-    path: "~/notes"
-    structure: "month"
-    filename:
-      - date
-      - time
-      - subject
+  destination: "~/work/notes"
+  structure: "month"
+  filename_options:
+    - date
+    - time
+    - subject
+  auto_tags:
+    - work
+
+active: true
 ```
 
-### Project-Specific Routing
+### Another Example
 
 ```yaml
+# ~/.protokoll/projects/personal.yaml
+id: personal
+name: Personal Notes
+type: project
+
+classification:
+  context_type: personal
+  explicit_phrases:
+    - "personal note"
+    - "reminder to self"
+    - "shopping list"
+
 routing:
-  projects:
-    - projectId: "work"
-      destination:
-        path: "~/work/notes"
-        structure: "month"
-      triggers:
-        - "work note"
-        - "about work"
-        - "office meeting"
-      priority: 10
-    
-    - projectId: "personal"
-      destination:
-        path: "~/notes/personal"
-        structure: "day"
-      triggers:
-        - "personal note"
-        - "reminder to self"
-      priority: 5
+  destination: "~/notes/personal"
+  structure: "day"
+  filename_options:
+    - date
+    - subject
+
+active: true
 ```
 
 ## Structures
@@ -74,44 +114,50 @@ Combined example: `260111-1430-meeting-notes.md`
 
 ## Classification Signals
 
-The classifier looks for multiple signals:
+The classifier looks for multiple signals in project files:
+
+### 1. Explicit Phrases
 
-### 1. Explicit Triggers
+High-confidence trigger phrases:
 
 ```yaml
-triggers:
-  - "work note"           # Exact phrase
-  - "about project alpha" # Project mention
+classification:
+  explicit_phrases:
+    - "work note"           # Exact phrase
+    - "about project alpha" # Project mention
 ```
 
 ### 2. Associated People
 
-If a person is associated with a project:
+If a person is mentioned and linked to a project:
 
 ```yaml
-# Person file
-company: acme-corp
-projects:
-  - quarterly-planning
+classification:
+  associated_people:
+    - "priya-sharma"  # Person ID
 ```
 
-Mentioning that person increases confidence for those projects.
+Mentioning that person increases confidence for the project.
 
 ### 3. Topic Keywords
 
-Projects can define topic keywords:
+General topic keywords:
 
 ```yaml
-topics:
-  - "budget"
-  - "roadmap"
-  - "quarterly"
+classification:
+  topics:
+    - "budget"
+    - "roadmap"
+    - "quarterly"
 ```
 
 ### 4. Context Type
 
+General category:
+
 ```yaml
-category: "work"  # or "personal", "mixed"
+classification:
+  context_type: "work"  # or "personal", "mixed"
 ```
 
 ## Confidence Scoring
@@ -120,7 +166,7 @@ Each signal contributes to a confidence score:
 
 | Signal | Weight |
 |--------|--------|
-| Explicit trigger match | 0.8 |
+| Explicit phrase match | 0.8 |
 | Associated person | 0.3 |
 | Topic keyword | 0.2 |
 | Context type match | 0.1 |
@@ -133,18 +179,19 @@ The project with highest confidence wins.
 
 ```typescript
 interface RoutingInstance {
-  // Classify text for project signals
-  classify(text: string): ProjectClassification[];
+  // Route based on context
+  route(context: RoutingContext): RouteDecision;
   
-  // Route to destination
-  route(text: string, config: RoutingConfig): RouteDestination;
+  // Build output path from decision
+  buildOutputPath(decision: RouteDecision, context: RoutingContext): string;
 }
 
-interface RouteDestination {
+interface RouteDecision {
   projectId: string | null;
-  path: string;
-  structure: FilesystemStructure;
+  destination: RouteDestination;
   confidence: number;
+  signals: ClassificationSignal[];
+  reasoning: string;
 }
 ```
 
@@ -152,71 +199,119 @@ interface RouteDestination {
 
 ### Work vs Personal
 
+Main config (default destination):
+
 ```yaml
+# ~/.protokoll/config.yaml
+outputDirectory: "~/notes/personal"
+outputStructure: "month"
+```
+
+Work project file:
+
+```yaml
+# ~/.protokoll/projects/work.yaml
+id: work
+name: Work
+type: project
+
+classification:
+  context_type: work
+  explicit_phrases:
+    - "work"
+    - "office"
+    - "standup"
+    - "meeting with"
+
 routing:
-  default:
-    path: "~/notes/personal"
-    structure: "month"
-  
-  projects:
-    - projectId: "work"
-      destination:
-        path: "~/work/notes"
-        structure: "day"
-      triggers:
-        - "work"
-        - "office"
-        - "standup"
-        - "meeting with"
+  destination: "~/work/notes"
+  structure: "day"
+  filename_options:
+    - date
+    - time
+    - subject
+
+active: true
 ```
 
 Recording: "This is a note about the standup meeting..."
-→ Routes to: `~/work/notes/2026/01/11/standup-meeting.md`
+→ Routes to: `~/work/notes/2026/01/11/260111-0930-standup-meeting.md`
 
 Recording: "Reminder to buy groceries..."
-→ Routes to: `~/notes/personal/2026/01/groceries.md`
+→ Routes to: `~/notes/personal/2026/01/260111-groceries.md` (default)
 
 ### Multiple Projects
 
 ```yaml
+# ~/.protokoll/projects/project-alpha.yaml
+id: project-alpha
+name: Project Alpha
+type: project
+
+classification:
+  context_type: work
+  explicit_phrases:
+    - "project alpha"
+    - "alpha team"
+
+routing:
+  destination: "~/work/alpha/notes"
+  structure: "month"
+  filename_options:
+    - date
+    - time
+    - subject
+
+active: true
+```
+
+```yaml
+# ~/.protokoll/projects/project-beta.yaml
+id: project-beta
+name: Project Beta
+type: project
+
+classification:
+  context_type: work
+  explicit_phrases:
+    - "project beta"
+    - "beta launch"
+
 routing:
-  projects:
-    - projectId: "project-alpha"
-      destination:
-        path: "~/work/alpha/notes"
-      triggers:
-        - "project alpha"
-        - "alpha team"
-      priority: 10
-    
-    - projectId: "project-beta"
-      destination:
-        path: "~/work/beta/notes"
-      triggers:
-        - "project beta"
-        - "beta launch"
-      priority: 10
+  destination: "~/work/beta/notes"
+  structure: "month"
+  filename_options:
+    - date
+    - time
+    - subject
+
+active: true
 ```
 
 ## Troubleshooting
 
 ### Notes Going to Wrong Project
 
-1. Check trigger phrases match your speech patterns
-2. Add more specific triggers
+1. Check `explicit_phrases` match your speech patterns
+2. Add more specific phrases
 3. Use `--debug` to see classification scores
 
 ### Notes Going to Default
 
-1. Verify project config is loaded
-2. Check triggers are case-insensitive matches
-3. Add more trigger variations
+1. Verify project files are in `.protokoll/projects/`
+2. Check `active: true` is set
+3. Ensure phrases are case-insensitive matches
+4. Add more phrase variations
 
 ### Path Not Created
 
-```yaml
-routing:
-  default:
-    createDirectories: true  # Ensure this is set
-```
+Directories are created automatically. If they're not:
+
+1. Check write permissions on parent directory
+2. Use `--verbose` to see directory creation logs
+
+## See Also
 
+- [Transcript Actions](./action.md) - Edit transcripts and change their project routing after creation
+- [Context System](./context-system.md) - How context storage works
+- [Configuration](./configuration.md) - All configuration options

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redaksjon/protokoll",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "Focused audio transcription with intelligent context integration",
   "main": "dist/main.js",
   "type": "module",