openhermes 1.2.2

package/schemas/instinct.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Instinct",
+  "description": "Reusable proven patterns or heuristics with success/failure tracking.",
+  "type": "object",
+  "required": ["id", "class", "summary", "trigger", "action", "success_count", "failure_count", "promotion_state", "provenance", "created_at", "status"],
+  "properties": {
+    "id": { "type": "string", "description": "Unique identifier, recommended pattern: instinct-YYYYMMDD-short-slug" },
+    "class": { "type": "string", "const": "instinct" },
+    "project": { "type": ["string", "null"], "description": "Project identifier; null for global/openhermes/session scope" },
+    "scope": { "type": "string", "enum": ["project", "global", "session", "harness"], "description": "Scope of applicability" },
+    "summary": { "type": "string", "description": "One-line description of the instinct" },
+    "tags": { "type": "array", "items": { "type": "string" }, "description": "Searchable tags" },
+    "source": { "type": "string", "enum": ["user", "agent", "audit", "migration", "repair"], "description": "Origin of this record" },
+    "provenance": {
+      "type": "object",
+      "required": ["session_id"],
+      "properties": {
+        "session_id": { "type": "string" },
+        "task_id": { "type": "string" },
+        "db_refs": { "type": "array", "items": { "type": "string" } },
+        "file_refs": { "type": "array", "items": { "type": "string" } },
+        "log_refs": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "created_at": { "type": "string", "format": "date-time", "description": "ISO-8601 timestamp" },
+    "updated_at": { "type": "string", "format": "date-time", "description": "ISO-8601 timestamp" },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1, "default": 0.5 },
+    "signal": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
+    "visibility": { "type": "string", "enum": ["implicit", "selective", "explicit"] },
+    "status": { "type": "string", "enum": ["active", "superseded", "archived", "closed", "open"] },
+    "refs": { "type": "array", "items": { "type": "string" }, "description": "Related object IDs or file paths" },
+    "review_at": { "type": ["string", "null"], "format": "date-time", "description": "ISO-8601 or null" },
+    "decay_at": { "type": ["string", "null"], "format": "date-time", "description": "ISO-8601 or null" },
+    "archived_at": { "type": ["string", "null"], "format": "date-time", "description": "ISO-8601 or null" },
+    "trigger": { "type": "string", "description": "Condition or pattern that triggers this instinct" },
+    "action": { "type": "string", "description": "Recommended action when triggered" },
+    "success_count": { "type": "integer", "minimum": 0, "default": 0, "description": "Number of successful applications" },
+    "failure_count": { "type": "integer", "minimum": 0, "default": 0, "description": "Number of failed applications" },
+    "promotion_state": { "type": "string", "enum": ["project", "candidate_global", "global"], "description": "Current promotion level" }
+  }
+}

package/schemas/loop-state.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Loop State",
+  "description": "Runtime loop state for curator session tracking and heartbeat. Written by curator.js plugin.",
+  "type": "object",
+  "required": ["status", "updated_at", "phase", "heartbeat_at"],
+  "properties": {
+    "status": { "type": "string", "enum": ["idle", "active", "error", "compacted"], "description": "Current session status" },
+    "last_gate_result": { "type": ["string", "null"], "description": "Result of last gate check, if any" },
+    "last_error": { "type": ["string", "null"], "description": "Last error message" },
+    "updated_at": { "type": "string", "format": "date-time", "description": "ISO-8601 timestamp of last update" },
+    "last_checkpoint_id": { "type": "string", "description": "ID of the most recent checkpoint" },
+    "phase": { "type": "string", "description": "Current lifecycle phase (session.idle, session.compacted, compress, etc.)" },
+    "heartbeat_at": { "type": "string", "format": "date-time", "description": "ISO-8601 timestamp of last heartbeat" },
+    "budget": {
+      "type": "object",
+      "description": "Token or execution budget tracking",
+      "properties": {
+        "remaining": { "type": "number" },
+        "total": { "type": "number" },
+        "reset_at": { "type": "string", "format": "date-time" }
+      }
+    },
+    "rollback": {
+      "type": "object",
+      "description": "Rollback tracking",
+      "properties": {
+        "level": { "type": "integer" },
+        "last_rollback_at": { "type": "string", "format": "date-time" }
+      }
+    }
+  }
+}

package/schemas/mistake.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Mistake",
+  "description": "Failure memory with root cause, fix, and prevention rule. Stored as JSONL (one object per line).",
+  "type": "object",
+  "required": ["id", "class", "summary", "type", "failure", "root_cause", "fix", "prevention", "strike", "provenance", "created_at", "status"],
+  "properties": {
+    "id": { "type": "string", "description": "Unique identifier, recommended pattern: mistake-YYYYMMDD-short-slug" },
+    "class": { "type": "string", "const": "mistake" },
+    "project": { "type": ["string", "null"], "description": "Project identifier; null for global/openhermes scope" },
+    "scope": { "type": "string", "enum": ["project", "global", "harness"], "description": "Scope of applicability" },
+    "summary": { "type": "string", "description": "One-line description of the mistake" },
+    "tags": { "type": "array", "items": { "type": "string" }, "description": "Searchable tags" },
+    "source": { "type": "string", "enum": ["user", "agent", "audit", "migration", "repair"], "description": "Origin of this record" },
+    "type": { "type": "string", "enum": ["build", "logic", "config", "security", "tool", "scope", "other"], "description": "Category of mistake" },
+    "failure": { "type": "string", "description": "What happened — the observable failure" },
+    "root_cause": { "type": "string", "description": "Why it happened — the underlying cause" },
+    "fix": { "type": "string", "description": "How it was resolved" },
+    "prevention": { "type": "string", "description": "Rule or guard to prevent recurrence" },
+    "strike": { "type": "integer", "minimum": 1, "description": "Strike count for this mistake type" },
+    "provenance": {
+      "type": "object",
+      "required": ["session_id"],
+      "properties": {
+        "session_id": { "type": "string" },
+        "task_id": { "type": "string" },
+        "db_refs": { "type": "array", "items": { "type": "string" } },
+        "file_refs": { "type": "array", "items": { "type": "string" } },
+        "log_refs": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1, "default": 1.0 },
+    "signal": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
+    "visibility": { "type": "string", "enum": ["implicit", "selective", "explicit"] },
+    "status": { "type": "string", "enum": ["active", "superseded", "archived", "closed", "open"] },
+    "refs": { "type": "array", "items": { "type": "string" }, "description": "Related object IDs or file paths" },
+    "created_at": { "type": "string", "format": "date-time", "description": "ISO-8601 timestamp" },
+    "updated_at": { "type": "string", "format": "date-time", "description": "ISO-8601 timestamp" },
+    "review_at": { "type": ["string", "null"], "format": "date-time", "description": "ISO-8601 or null" },
+    "decay_at": { "type": ["string", "null"], "format": "date-time", "description": "ISO-8601 or null" },
+    "archived_at": { "type": ["string", "null"], "format": "date-time", "description": "ISO-8601 or null" }
+  }
+}

package/schemas/verification_receipt.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Verification Receipt",
+  "description": "Cached verification result keyed by artifact identity + fingerprint. Stored in memory\\verification_receipts\\.",
+  "type": "object",
+  "required": ["id", "class", "artifact", "artifact_type", "fingerprint", "method", "result", "provenance", "created_at", "status"],
+  "properties": {
+    "id": { "type": "string", "description": "Unique identifier, recommended pattern: v:<artifact-path-or-logical-id>" },
+    "class": { "type": "string", "const": "verification_receipt" },
+    "project": { "type": ["string", "null"], "description": "Project identifier; null for global/openhermes scope" },
+    "scope": { "type": "string", "enum": ["project", "global", "session", "harness"], "description": "Scope of applicability" },
+    "summary": { "type": "string", "description": "One-line description of what was verified" },
+    "tags": { "type": "array", "items": { "type": "string" }, "description": "Searchable tags" },
+    "source": { "type": "string", "enum": ["user", "agent", "audit", "migration", "repair"], "description": "Origin of this record" },
+    "provenance": {
+      "type": "object",
+      "required": ["session_id"],
+      "properties": {
+        "session_id": { "type": "string" },
+        "task_id": { "type": "string" },
+        "db_refs": { "type": "array", "items": { "type": "string" } },
+        "file_refs": { "type": "array", "items": { "type": "string" } },
+        "log_refs": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "created_at": { "type": "string", "format": "date-time", "description": "ISO-8601 timestamp" },
+    "updated_at": { "type": "string", "format": "date-time", "description": "ISO-8601 timestamp" },
+    "expires_at": { "type": ["string", "null"], "format": "date-time", "description": "ISO-8601 — receipt invalid after this time regardless of fingerprint" },
+    "confidence": { "type": "number", "minimum": 0, "maximum": 1, "default": 1.0 },
+    "signal": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
+    "visibility": { "type": "string", "enum": ["implicit", "selective", "explicit"] },
+    "status": { "type": "string", "enum": ["active", "superseded", "archived", "closed", "open", "expired"] },
+    "refs": { "type": "array", "items": { "type": "string" }, "description": "Related object IDs or file paths" },
+    "review_at": { "type": ["string", "null"], "format": "date-time", "description": "ISO-8601 or null" },
+    "decay_at": { "type": ["string", "null"], "format": "date-time", "description": "ISO-8601 or null" },
+    "archived_at": { "type": ["string", "null"], "format": "date-time", "description": "ISO-8601 or null" },
+    "artifact": { "type": "string", "description": "Full path or logical identity of the verified artifact" },
+    "artifact_type": { "type": "string", "enum": ["file", "command", "config", "dependency", "memory", "state", "other"], "description": "Type of artifact verified" },
+    "fingerprint": {
+      "type": "object",
+      "required": ["path"],
+      "properties": {
+        "path": { "type": "string", "description": "Normalized file path or logical ID" },
+        "mtime": { "type": "string", "description": "File modification time (ISO-8601)" },
+        "size": { "type": "integer", "description": "File size in bytes" },
+        "sha256": { "type": "string", "description": "SHA-256 hash (optional but preferred)" }
+      }
+    },
+    "environment": {
+      "type": "object",
+      "properties": {
+        "cwd": { "type": "string" },
+        "os": { "type": "string" },
+        "shell": { "type": "string", "default": "cmd.exe" },
+        "provider": { "type": "string" },
+        "model": { "type": "string" }
+      }
+    },
+    "method": { "type": "string", "enum": ["command", "read", "test", "schema-validate", "manual-inspection", "bash", "grep", "live-hook-run", "permission-regression", "end-to-end-run", "external-test", "runtime-proof"], "description": "Verification method used. runtime-proof = linked to runtime_proof record for executable evidence." },
+    "command": { "type": "string", "description": "The command or action executed to verify" },
+    "result": { "type": "string", "enum": ["pass", "fail", "unknown"], "description": "Verification outcome" },
+    "result_detail": { "type": "string", "description": "Detailed result description or output summary" },
+    "supersedes": { "type": "array", "items": { "type": "string" }, "description": "Receipt IDs this receipt supersedes" },
+    "superseded_by": { "type": "array", "items": { "type": "string" }, "description": "Receipt IDs that supersede this one" },
+    "invalidation_reason": { "type": "string", "description": "If status is expired/superseded, why the receipt was invalidated" }
+  }
+}

package/skill-builder.mjs

@@ -0,0 +1,113 @@
+import path from "node:path"
+import fs from "node:fs"
+import os from "node:os"
+import { atomicWriteJson, fingerprintEnvironment, isTruthy, sanitizeRecord } from "./lib/hardening.mjs"
+
+function getHarnessRoot(directory) {
+  const home = process.env.USERPROFILE || os.homedir()
+  const configRoot = path.join(home, ".config", "opencode")
+  const projectHarness = path.join(directory, ".opencode", "openhermes")
+  const projectMemory = path.join(projectHarness, "memory")
+  if (isTruthy(process.env.OPENCODE_ALLOW_PROJECT_HARNESS)) {
+    try { fs.accessSync(projectMemory); return projectHarness } catch {}
+  }
+  return path.join(configRoot, "openhermes")
+}
+
+function readJson(fp, fallback) {
+  try { return JSON.parse(fs.readFileSync(fp, "utf8")) } catch { return fallback }
+}
+
+function buildEnvironmentFingerprint(root, directory, project) {
+  return fingerprintEnvironment({
+    cwd: directory,
+    harnessRoot: root,
+    projectRoot: directory,
+    project: project?.name || path.basename(directory),
+    sessionId: project?.session_id || null,
+  })
+}
+
+const COMPLEXITY_THRESHOLD = { toolCalls: 8, subagents: 2 }
+let sessionStats = { toolCalls: 0, subagents: 0, startTime: Date.now() }
+
+export const SkillBuilderPlugin = async ({ project, directory }) => {
+  return {
+    "tool.execute.after": async (input, output) => {
+      sessionStats.toolCalls++
+      if (input.tool === "task") sessionStats.subagents++
+    },
+
+    event: async ({ event }) => {
+      if (event.type === "session.created") {
+        sessionStats = { toolCalls: 0, subagents: 0, startTime: Date.now() }
+      }
+
+      if (event.type === "session.idle") {
+        const durationMin = Math.round((Date.now() - sessionStats.startTime) / 60000)
+        const isComplex = sessionStats.toolCalls >= COMPLEXITY_THRESHOLD.toolCalls
+          || sessionStats.subagents >= COMPLEXITY_THRESHOLD.subagents
+
+        if (isComplex) {
+          try {
+            const root = getHarnessRoot(directory)
+            const ts = new Date().toISOString()
+            const id = `bl_skill_candidate_${ts.replace(/[:.]/g, "-")}`
+            const backlogIndexPath = path.join(root, "memory", "backlog", "index.json")
+            const backlogIndex = readJson(backlogIndexPath, [])
+            const hasOpenCandidate = Array.isArray(backlogIndex)
+              ? backlogIndex.some(e => e.status === "open" && String(e.summary || "").includes("[skill-candidate]"))
+              : false
+            if (hasOpenCandidate) {
+              sessionStats = { toolCalls: 0, subagents: 0, startTime: Date.now() }
+              return
+            }
+            const environmentFingerprint = buildEnvironmentFingerprint(root, directory, project)
+            const record = {
+              id,
+              class: "backlog",
+              scope: "global",
+              summary: `[skill-candidate] Complex session: ${sessionStats.toolCalls} tool calls, ${sessionStats.subagents} subagents, ${durationMin}min`,
+              description: `Session exceeded complexity thresholds (toolCalls>=${COMPLEXITY_THRESHOLD.toolCalls} or subagents>=${COMPLEXITY_THRESHOLD.subagents}). Session had ${sessionStats.toolCalls} tool calls and ${sessionStats.subagents} subagent spawns over ${durationMin} minutes.`,
+              title: `Skill candidate: Complex session (${sessionStats.toolCalls} tool calls${sessionStats.subagents ? `, ${sessionStats.subagents} subagents`:""})`,
+              priority: "medium",
+              trigger: "drift",
+              status: "open",
+              provenance: {
+                session_id: project?.session_id || `session-${Date.now()}`,
+                harness_root: root,
+                project_root: directory,
+              },
+              tags: ["skill-candidate", "auto-detected"],
+              source: "agent",
+              created_at: ts,
+              updated_at: ts,
+              project: project?.name || path.basename(directory),
+              environment_fingerprint: environmentFingerprint,
+            }
+            const dir = path.join(root, "memory", "backlog")
+            fs.mkdirSync(dir, { recursive: true })
+            const safeRecord = sanitizeRecord(record, { maxStringLength: 4000 })
+            atomicWriteJson(path.join(dir, `${id}.json`), safeRecord)
+
+            const index = Array.isArray(backlogIndex) ? backlogIndex : []
+            index.push({
+              id,
+              summary: safeRecord.summary,
+              title: safeRecord.title,
+              status: "open",
+              updated_at: ts,
+              path: `openhermes/memory/backlog/${id}.json`,
+              priority: "medium",
+              trigger: "drift",
+              environment_fingerprint: environmentFingerprint,
+            })
+            atomicWriteJson(path.join(dir, "index.json"), index)
+
+          } catch (err) {}
+        }
+        sessionStats = { toolCalls: 0, subagents: 0, startTime: Date.now() }
+      }
+    },
+  }
+}