feed-the-machine 1.5.0 → 1.6.0

package/ftm-state/schemas/context.schema.json

@@ -1,130 +1,130 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "context.schema.json",
-  "title": "Blackboard Context",
-  "description": "Schema for the blackboard session context state file",
-  "type": "object",
-  "required": [
-    "current_task",
-    "recent_decisions",
-    "active_constraints",
-    "user_preferences",
-    "session_metadata"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "current_task": {
-      "type": "object",
-      "description": "The task currently being executed in this session",
-      "required": ["id", "description", "type", "started_at", "status"],
-      "additionalProperties": false,
-      "properties": {
-        "id": {
-          "type": ["string", "null"],
-          "description": "Unique identifier for the task"
-        },
-        "description": {
-          "type": ["string", "null"],
-          "description": "Human-readable description of the task"
-        },
-        "type": {
-          "type": ["string", "null"],
-          "description": "Category or type of task (e.g. feature, bugfix, refactor)"
-        },
-        "started_at": {
-          "type": ["string", "null"],
-          "format": "date-time",
-          "description": "ISO 8601 timestamp when the task was started"
-        },
-        "status": {
-          "type": ["string", "null"],
-          "enum": [null, "pending", "in_progress", "complete", "failed"],
-          "description": "Current execution status of the task"
-        }
-      }
-    },
-    "recent_decisions": {
-      "type": "array",
-      "description": "Log of decisions made during this session (capped at 10)",
-      "maxItems": 10,
-      "items": {
-        "type": "object",
-        "required": ["summary", "timestamp", "skill"],
-        "additionalProperties": false,
-        "properties": {
-          "summary": {
-            "type": "string",
-            "description": "Brief description of the decision made"
-          },
-          "timestamp": {
-            "type": "string",
-            "description": "When the decision was recorded"
-          },
-          "skill": {
-            "type": "string",
-            "description": "The skill that produced this decision"
-          }
-        }
-      }
-    },
-    "active_constraints": {
-      "type": "array",
-      "description": "List of constraints currently in effect for this session",
-      "items": {
-        "type": "string"
-      }
-    },
-    "user_preferences": {
-      "type": "object",
-      "description": "Preferences established or inferred during the session",
-      "required": ["communication_style", "approval_gates", "default_model_profile"],
-      "additionalProperties": false,
-      "properties": {
-        "communication_style": {
-          "type": ["string", "null"],
-          "description": "Preferred tone and verbosity level (e.g. concise, detailed)"
-        },
-        "approval_gates": {
-          "type": ["string", "null"],
-          "description": "Approval gate setting (e.g. always, on_destructive, never)"
-        },
-        "default_model_profile": {
-          "type": ["string", "null"],
-          "description": "Model profile to use by default when not overridden"
-        }
-      }
-    },
-    "session_metadata": {
-      "type": "object",
-      "description": "Metadata tracking the lifecycle and activity of this session",
-      "required": ["started_at", "last_updated", "conversation_id", "messages_count", "skills_invoked"],
-      "additionalProperties": false,
-      "properties": {
-        "started_at": {
-          "type": ["string", "null"],
-          "description": "ISO 8601 timestamp when the session began"
-        },
-        "last_updated": {
-          "type": ["string", "null"],
-          "description": "ISO 8601 timestamp of the most recent write to this file"
-        },
-        "conversation_id": {
-          "type": ["string", "null"],
-          "description": "Identifier for the conversation this session belongs to"
-        },
-        "messages_count": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Number of messages exchanged in the session so far"
-        },
-        "skills_invoked": {
-          "type": "array",
-          "description": "Ordered list of skill names invoked during this session",
-          "items": {
-            "type": "string"
-          }
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "context.schema.json",
+  "title": "Blackboard Context",
+  "description": "Schema for the blackboard session context state file",
+  "type": "object",
+  "required": [
+    "current_task",
+    "recent_decisions",
+    "active_constraints",
+    "user_preferences",
+    "session_metadata"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "current_task": {
+      "type": "object",
+      "description": "The task currently being executed in this session",
+      "required": ["id", "description", "type", "started_at", "status"],
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "type": ["string", "null"],
+          "description": "Unique identifier for the task"
+        },
+        "description": {
+          "type": ["string", "null"],
+          "description": "Human-readable description of the task"
+        },
+        "type": {
+          "type": ["string", "null"],
+          "description": "Category or type of task (e.g. feature, bugfix, refactor)"
+        },
+        "started_at": {
+          "type": ["string", "null"],
+          "format": "date-time",
+          "description": "ISO 8601 timestamp when the task was started"
+        },
+        "status": {
+          "type": ["string", "null"],
+          "enum": [null, "pending", "in_progress", "complete", "failed"],
+          "description": "Current execution status of the task"
+        }
+      }
+    },
+    "recent_decisions": {
+      "type": "array",
+      "description": "Log of decisions made during this session (capped at 10)",
+      "maxItems": 10,
+      "items": {
+        "type": "object",
+        "required": ["summary", "timestamp", "skill"],
+        "additionalProperties": false,
+        "properties": {
+          "summary": {
+            "type": "string",
+            "description": "Brief description of the decision made"
+          },
+          "timestamp": {
+            "type": "string",
+            "description": "When the decision was recorded"
+          },
+          "skill": {
+            "type": "string",
+            "description": "The skill that produced this decision"
+          }
+        }
+      }
+    },
+    "active_constraints": {
+      "type": "array",
+      "description": "List of constraints currently in effect for this session",
+      "items": {
+        "type": "string"
+      }
+    },
+    "user_preferences": {
+      "type": "object",
+      "description": "Preferences established or inferred during the session",
+      "required": ["communication_style", "approval_gates", "default_model_profile"],
+      "additionalProperties": false,
+      "properties": {
+        "communication_style": {
+          "type": ["string", "null"],
+          "description": "Preferred tone and verbosity level (e.g. concise, detailed)"
+        },
+        "approval_gates": {
+          "type": ["string", "null"],
+          "description": "Approval gate setting (e.g. always, on_destructive, never)"
+        },
+        "default_model_profile": {
+          "type": ["string", "null"],
+          "description": "Model profile to use by default when not overridden"
+        }
+      }
+    },
+    "session_metadata": {
+      "type": "object",
+      "description": "Metadata tracking the lifecycle and activity of this session",
+      "required": ["started_at", "last_updated", "conversation_id", "messages_count", "skills_invoked"],
+      "additionalProperties": false,
+      "properties": {
+        "started_at": {
+          "type": ["string", "null"],
+          "description": "ISO 8601 timestamp when the session began"
+        },
+        "last_updated": {
+          "type": ["string", "null"],
+          "description": "ISO 8601 timestamp of the most recent write to this file"
+        },
+        "conversation_id": {
+          "type": ["string", "null"],
+          "description": "Identifier for the conversation this session belongs to"
+        },
+        "messages_count": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of messages exchanged in the session so far"
+        },
+        "skills_invoked": {
+          "type": "array",
+          "description": "Ordered list of skill names invoked during this session",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}

package/ftm-state/schemas/experience-index.schema.json

@@ -1,77 +1,77 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "experience-index.schema.json",
-  "title": "Blackboard Experience Index",
-  "description": "Schema for the experience index file that tracks all stored experience entries",
-  "type": "object",
-  "required": ["entries", "metadata"],
-  "additionalProperties": false,
-  "properties": {
-    "entries": {
-      "type": "array",
-      "description": "Index records pointing to individual experience files",
-      "items": {
-        "type": "object",
-        "required": ["id", "file", "task_type", "tags", "timestamp", "confidence"],
-        "additionalProperties": false,
-        "properties": {
-          "id": {
-            "type": "string",
-            "description": "Unique identifier for this experience entry"
-          },
-          "file": {
-            "type": "string",
-            "description": "Relative path to the experience JSON file (e.g. YYYY-MM-DD_task-slug.json)"
-          },
-          "task_type": {
-            "type": "string",
-            "description": "Category of task this experience was recorded from"
-          },
-          "tags": {
-            "type": "array",
-            "description": "Labels for filtering and retrieval",
-            "items": {
-              "type": "string"
-            }
-          },
-          "timestamp": {
-            "type": "string",
-            "description": "ISO 8601 timestamp when the experience was recorded"
-          },
-          "confidence": {
-            "type": "number",
-            "minimum": 0,
-            "maximum": 1,
-            "description": "Confidence score for this experience (0.0 = low, 1.0 = high)"
-          }
-        }
-      }
-    },
-    "metadata": {
-      "type": "object",
-      "description": "Administrative metadata about the experience index",
-      "required": ["total_count", "last_updated", "max_entries", "pruning_strategy"],
-      "additionalProperties": false,
-      "properties": {
-        "total_count": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Total number of experience entries in the index"
-        },
-        "last_updated": {
-          "type": ["string", "null"],
-          "description": "ISO 8601 timestamp of the most recent write to this index"
-        },
-        "max_entries": {
-          "type": "integer",
-          "default": 200,
-          "description": "Maximum number of entries to retain before pruning is triggered"
-        },
-        "pruning_strategy": {
-          "type": "string",
-          "description": "Strategy used to remove entries when max_entries is exceeded (e.g. remove_oldest_low_confidence)"
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "experience-index.schema.json",
+  "title": "Blackboard Experience Index",
+  "description": "Schema for the experience index file that tracks all stored experience entries",
+  "type": "object",
+  "required": ["entries", "metadata"],
+  "additionalProperties": false,
+  "properties": {
+    "entries": {
+      "type": "array",
+      "description": "Index records pointing to individual experience files",
+      "items": {
+        "type": "object",
+        "required": ["id", "file", "task_type", "tags", "timestamp", "confidence"],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Unique identifier for this experience entry"
+          },
+          "file": {
+            "type": "string",
+            "description": "Relative path to the experience JSON file (e.g. YYYY-MM-DD_task-slug.json)"
+          },
+          "task_type": {
+            "type": "string",
+            "description": "Category of task this experience was recorded from"
+          },
+          "tags": {
+            "type": "array",
+            "description": "Labels for filtering and retrieval",
+            "items": {
+              "type": "string"
+            }
+          },
+          "timestamp": {
+            "type": "string",
+            "description": "ISO 8601 timestamp when the experience was recorded"
+          },
+          "confidence": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1,
+            "description": "Confidence score for this experience (0.0 = low, 1.0 = high)"
+          }
+        }
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Administrative metadata about the experience index",
+      "required": ["total_count", "last_updated", "max_entries", "pruning_strategy"],
+      "additionalProperties": false,
+      "properties": {
+        "total_count": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total number of experience entries in the index"
+        },
+        "last_updated": {
+          "type": ["string", "null"],
+          "description": "ISO 8601 timestamp of the most recent write to this index"
+        },
+        "max_entries": {
+          "type": "integer",
+          "default": 200,
+          "description": "Maximum number of entries to retain before pruning is triggered"
+        },
+        "pruning_strategy": {
+          "type": "string",
+          "description": "Strategy used to remove entries when max_entries is exceeded (e.g. remove_oldest_low_confidence)"
+        }
+      }
+    }
+  }
+}

package/ftm-state/schemas/experience.schema.json

@@ -1,78 +1,78 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "experience.schema.json",
-  "title": "Blackboard Experience Entry",
-  "description": "Schema for an individual experience file stored in ftm-state/blackboard/experiences/",
-  "type": "object",
-  "required": ["task_type", "task_description", "timestamp"],
-  "additionalProperties": false,
-  "properties": {
-    "task_type": {
-      "type": "string",
-      "description": "Category of task this experience was recorded from (e.g. feature, bugfix, refactor)"
-    },
-    "task_description": {
-      "type": "string",
-      "description": "Human-readable description of the task that generated this experience"
-    },
-    "agent_team": {
-      "type": "array",
-      "description": "Names of agents that participated in executing the task",
-      "items": {
-        "type": "string"
-      }
-    },
-    "wave_count": {
-      "type": "integer",
-      "minimum": 1,
-      "description": "Number of execution waves that occurred during the task"
-    },
-    "audit_outcomes": {
-      "type": "object",
-      "description": "Summary of audit results across all waves",
-      "additionalProperties": false,
-      "properties": {
-        "pass": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Number of audit checks that passed without modification"
-        },
-        "auto_fix": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Number of audit checks that were automatically corrected"
-        },
-        "fail": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Number of audit checks that failed and required manual resolution"
-        }
-      }
-    },
-    "lessons_learned": {
-      "type": "array",
-      "description": "Key takeaways extracted from this experience for future sessions",
-      "items": {
-        "type": "string"
-      }
-    },
-    "timestamp": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp when this experience was recorded"
-    },
-    "confidence": {
-      "type": "number",
-      "minimum": 0,
-      "maximum": 1,
-      "description": "Confidence score for this experience (0.0 = low, 1.0 = high)"
-    },
-    "tags": {
-      "type": "array",
-      "description": "Free-form labels for indexing and retrieval",
-      "items": {
-        "type": "string"
-      }
-    }
-  }
-}
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "experience.schema.json",
+  "title": "Blackboard Experience Entry",
+  "description": "Schema for an individual experience file stored in ftm-state/blackboard/experiences/",
+  "type": "object",
+  "required": ["task_type", "task_description", "timestamp"],
+  "additionalProperties": false,
+  "properties": {
+    "task_type": {
+      "type": "string",
+      "description": "Category of task this experience was recorded from (e.g. feature, bugfix, refactor)"
+    },
+    "task_description": {
+      "type": "string",
+      "description": "Human-readable description of the task that generated this experience"
+    },
+    "agent_team": {
+      "type": "array",
+      "description": "Names of agents that participated in executing the task",
+      "items": {
+        "type": "string"
+      }
+    },
+    "wave_count": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Number of execution waves that occurred during the task"
+    },
+    "audit_outcomes": {
+      "type": "object",
+      "description": "Summary of audit results across all waves",
+      "additionalProperties": false,
+      "properties": {
+        "pass": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of audit checks that passed without modification"
+        },
+        "auto_fix": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of audit checks that were automatically corrected"
+        },
+        "fail": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Number of audit checks that failed and required manual resolution"
+        }
+      }
+    },
+    "lessons_learned": {
+      "type": "array",
+      "description": "Key takeaways extracted from this experience for future sessions",
+      "items": {
+        "type": "string"
+      }
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp when this experience was recorded"
+    },
+    "confidence": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1,
+      "description": "Confidence score for this experience (0.0 = low, 1.0 = high)"
+    },
+    "tags": {
+      "type": "array",
+      "description": "Free-form labels for indexing and retrieval",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}