hadara 0.3.2 → 0.3.3

package/dist/schemas/context-source-manifest.schema.json

@@ -0,0 +1,147 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.context.sourceManifest.v1",
+    "x-hadara-schema-id": "hadara.context.sourceManifest.v1",
+    "title": "HADARA Context Source Manifest",
+    "type": "object",
+    "additionalProperties": true,
+    "required": [
+        "schemaVersion",
+        "generatedAt",
+        "projectFingerprint",
+        "cacheVersion",
+        "manifestHash",
+        "ignoreConfigHash",
+        "extractorVersions",
+        "sources",
+        "summary",
+        "budget",
+        "issues"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "hadara.context.sourceManifest.v1" },
+        "generatedAt": { "type": "string" },
+        "projectFingerprint": { "type": "string" },
+        "cacheVersion": { "type": "string" },
+        "manifestHash": { "type": "string" },
+        "ignoreConfigHash": { "type": "string" },
+        "extractorVersions": {
+            "type": "object",
+            "additionalProperties": { "type": "string" }
+        },
+        "sources": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/source" }
+        },
+        "summary": { "$ref": "#/$defs/summary" },
+        "budget": { "$ref": "#/$defs/budget" },
+        "issues": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/issue" }
+        }
+    },
+    "$defs": {
+        "sourceKind": {
+            "enum": [
+                "task-board",
+                "task-capsule",
+                "evidence",
+                "docs-registry",
+                "command-registry",
+                "managed-section-source",
+                "source-file",
+                "test-file",
+                "fixture-file",
+                "config-file",
+                "release-doc",
+                "handoff-doc",
+                "project-state-doc",
+                "spec-doc",
+                "other-doc"
+            ]
+        },
+        "source": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": [
+                "path",
+                "kind",
+                "sizeBytes",
+                "metadataHash",
+                "extractorKeys"
+            ],
+            "properties": {
+                "path": { "type": "string", "minLength": 1 },
+                "kind": { "$ref": "#/$defs/sourceKind" },
+                "sizeBytes": { "type": "number" },
+                "mtimeMs": { "type": "number" },
+                "mtimeNs": { "type": "string" },
+                "contentHash": { "type": "string" },
+                "metadataHash": { "type": "string", "minLength": 1 },
+                "extractorKeys": {
+                    "type": "array",
+                    "items": { "type": "string", "minLength": 1 }
+                },
+                "parseState": { "enum": ["ok", "skipped", "failed"] },
+                "issueCodes": {
+                    "type": "array",
+                    "items": { "type": "string" }
+                }
+            }
+        },
+        "summary": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": [
+                "sourceCount",
+                "totalBytes",
+                "hashedSourceCount",
+                "skippedSourceCount"
+            ],
+            "properties": {
+                "sourceCount": { "type": "number" },
+                "totalBytes": { "type": "number" },
+                "hashedSourceCount": { "type": "number" },
+                "skippedSourceCount": { "type": "number" },
+                "generatedByCommand": { "type": "string" }
+            }
+        },
+        "budget": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": [
+                "maxSourceFiles",
+                "maxSourceBytes",
+                "maxSingleSourceBytes",
+                "discoveredSourceCount",
+                "discoveredBytes",
+                "skippedSourceCount"
+            ],
+            "properties": {
+                "maxSourceFiles": { "type": "number" },
+                "maxSourceBytes": { "type": "number" },
+                "maxSingleSourceBytes": { "type": "number" },
+                "discoveredSourceCount": { "type": "number" },
+                "discoveredBytes": { "type": "number" },
+                "skippedSourceCount": { "type": "number" }
+            }
+        },
+        "issue": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["severity", "code", "message"],
+            "properties": {
+                "severity": { "enum": ["info", "warning", "error"] },
+                "code": {
+                    "enum": [
+                        "SOURCE_MANIFEST_READ_FAILED",
+                        "SOURCE_MANIFEST_PARTIAL"
+                    ]
+                },
+                "message": { "type": "string", "minLength": 1 },
+                "path": { "type": "string" },
+                "fixHint": { "type": "string" }
+            }
+        }
+    }
+}

package/dist/schemas/schema-index.json

@@ -64,6 +64,69 @@
             "owner": "hermes/context-export",
             "notes": "Documents read-only MCP memory-mode context export; CLI export-context remains file-writing."
         },
+        {
+            "id": "hadara.context.cacheRecord.v1",
+            "path": "src/schemas/context-cache-record.schema.json",
+            "status": "fixture",
+            "owner": "context/cache",
+            "notes": "Documents C6 context cache record envelopes for projection payloads keyed by source manifests, source subsets, and extractor versions."
+        },
+        {
+            "id": "hadara.context.cacheStatus.v1",
+            "path": "src/schemas/context-cache-status.schema.json",
+            "status": "fixture",
+            "owner": "context/cache",
+            "notes": "Documents read-only C6 context cache status reports for source-manifest cache hit, miss, stale, and corrupt states."
+        },
+        {
+            "id": "hadara.context.cacheWarm.v1",
+            "path": "src/schemas/context-cache-warm.schema.json",
+            "status": "fixture",
+            "owner": "context/cache",
+            "notes": "Documents dry-run-first C6 context cache warm reports for source-manifest cache population."
+        },
+        {
+            "id": "hadara.codeIndex.v1",
+            "path": "src/schemas/code-index.schema.json",
+            "status": "fixture",
+            "owner": "context/code-index",
+            "notes": "Documents deterministic read-only C2 code index reports over source, test, fixture, script, config, symbol, and code relation candidates."
+        },
+        {
+            "id": "hadara.context.sourceManifest.v1",
+            "path": "src/schemas/context-source-manifest.schema.json",
+            "status": "fixture",
+            "owner": "context/source-manifest",
+            "notes": "Documents C6.1 metadata-first source discovery manifests for context graph, code index, cache invalidation, and future warm paths."
+        },
+        {
+            "id": "hadara.contextPack.v1",
+            "path": "src/schemas/context-pack.schema.json",
+            "status": "fixture",
+            "owner": "context/context-pack",
+            "notes": "Documents deterministic read-only C3 context pack reports over graph-ranked task, document, command, evidence, code, known-problem, validation, write-boundary, and slice-candidate items."
+        },
+        {
+            "id": "hadara.contextSlice.v1",
+            "path": "src/schemas/context-slice.schema.json",
+            "status": "fixture",
+            "owner": "context/context-slice",
+            "notes": "Documents deterministic read-only C4 raw context slice reports for explicit ranges, tail windows, keyword windows, managed sections, symbol neighborhoods, and context-pack candidates."
+        },
+        {
+            "id": "hadara.contextGraph.v1",
+            "path": "src/schemas/context-graph.schema.json",
+            "status": "fixture",
+            "owner": "context/graph",
+            "notes": "Documents deterministic read-only C1 project context graph reports over task, document, evidence, command, release, decision, and known-problem nodes."
+        },
+        {
+            "id": "hadara.sessionStart.v1",
+            "path": "src/schemas/session-start.schema.json",
+            "status": "fixture",
+            "owner": "context/session-start",
+            "notes": "Documents bounded read-only C5 session-start packets composed from context pack, state projection, lifecycle guidance, and cache/degraded metadata."
+        },
         {
             "id": "hadara.command_help.v1",
             "path": "src/schemas/command-help.schema.json",
@@ -218,6 +281,13 @@
             "owner": "task/close",
             "notes": "Documents task close plan and execute reports with close-evidence loop-boundary metadata."
         },
+        {
+            "id": "hadara.task.closeRepairPlan.v1",
+            "path": "src/schemas/task-close-repair-plan.schema.json",
+            "status": "fixture",
+            "owner": "task/close-repair-plan",
+            "notes": "Documents read-only close proof repair classifications and next actions."
+        },
         {
             "id": "hadara.task.complete_flow.v1",
             "path": "src/schemas/task-complete-flow.schema.json",
@@ -225,6 +295,27 @@
             "owner": "task/complete-flow",
             "notes": "Documents read-only task completion flow reports that compose finish, ready, close, and audit guidance."
         },
+        {
+            "id": "hadara.task.finalize.v1",
+            "path": "src/schemas/task-finalize.schema.json",
+            "status": "fixture",
+            "owner": "task/finalize",
+            "notes": "Documents read-only finalize dry-run plans with plan hashes, lifecycle steps, write boundaries, and execute refusal metadata."
+        },
+        {
+            "id": "hadara.task.lifecycle.v1",
+            "path": "src/schemas/task-lifecycle.schema.json",
+            "status": "fixture",
+            "owner": "task/lifecycle",
+            "notes": "Documents read-only normalized lifecycle phase reports that compose finish, ready, close, and audit state."
+        },
+        {
+            "id": "hadara.taskContext.v1",
+            "path": "src/schemas/task-context.schema.json",
+            "status": "fixture",
+            "owner": "context/task-context",
+            "notes": "Documents task-centered C1 context reports used to avoid reading the full graph for a selected task."
+        },
         {
             "id": "hadara.task.create.v1",
             "path": "src/schemas/task-create.schema.json",

package/dist/schemas/session-start.schema.json

@@ -0,0 +1,158 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.sessionStart.v1",
+    "x-hadara-schema-id": "hadara.sessionStart.v1",
+    "title": "HADARA Session Start Report",
+    "type": "object",
+    "additionalProperties": true,
+    "required": [
+        "schemaVersion",
+        "command",
+        "ok",
+        "generatedAt",
+        "projectRoot",
+        "currentState",
+        "contextPack",
+        "lifecycle",
+        "guidance",
+        "knownProblems",
+        "sourceSummary",
+        "cache",
+        "summary",
+        "issues"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "hadara.sessionStart.v1" },
+        "command": { "const": "session.start" },
+        "ok": { "type": "boolean" },
+        "generatedAt": { "type": "string" },
+        "projectRoot": { "type": "string" },
+        "currentState": {
+            "type": "object",
+            "additionalProperties": true,
+            "properties": {
+                "activeTask": { "type": "string" },
+                "latestCompletedTask": { "type": "string" },
+                "recommendedNextTask": { "type": "string" },
+                "releaseState": { "type": "string" }
+            }
+        },
+        "contextPack": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["schemaVersion", "command", "ok", "readFirst", "readIfNeeded", "issues"],
+            "properties": {
+                "schemaVersion": { "const": "hadara.contextPack.v1" },
+                "command": { "const": "context.pack" },
+                "ok": { "type": "boolean" },
+                "readFirst": { "type": "array" },
+                "readIfNeeded": { "type": "array" },
+                "issues": { "type": "array" }
+            }
+        },
+        "lifecycle": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["primaryNextCommands", "diagnosticCommands"],
+            "properties": {
+                "primaryNextCommands": {
+                    "type": "array",
+                    "items": { "type": "string", "minLength": 1 }
+                },
+                "diagnosticCommands": {
+                    "type": "array",
+                    "items": { "type": "string", "minLength": 1 }
+                }
+            }
+        },
+        "guidance": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": [
+                "mode",
+                "primaryNextAction",
+                "reason",
+                "taskRequired",
+                "liveContextPackAvailable",
+                "commands"
+            ],
+            "properties": {
+                "mode": { "enum": ["live-context-pack", "warm-cache", "bounded-no-live"] },
+                "primaryNextAction": { "enum": ["select-task", "inspect-task"] },
+                "reason": { "type": "string", "minLength": 1 },
+                "taskRequired": { "type": "boolean" },
+                "liveContextPackAvailable": { "type": "boolean" },
+                "commands": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "additionalProperties": true,
+                        "required": ["id", "command", "args", "reason"],
+                        "properties": {
+                            "id": { "type": "string", "minLength": 1 },
+                            "command": { "type": "string", "minLength": 1 },
+                            "args": {
+                                "type": "array",
+                                "items": { "type": "string" }
+                            },
+                            "reason": { "type": "string", "minLength": 1 }
+                        }
+                    }
+                }
+            }
+        },
+        "knownProblems": { "type": "array" },
+        "sourceSummary": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["graphAvailable", "stateProjectionAvailable", "degraded"],
+            "properties": {
+                "graphAvailable": { "type": "boolean" },
+                "stateProjectionAvailable": { "type": "boolean" },
+                "degraded": { "type": "boolean" }
+            }
+        },
+        "cache": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["used", "hit"],
+            "properties": {
+                "used": { "type": "boolean" },
+                "hit": { "type": "boolean" }
+            }
+        },
+        "summary": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": [
+                "degraded",
+                "readFirstCount",
+                "readIfNeededCount",
+                "sliceCandidateCount",
+                "knownProblemCount",
+                "issueCount"
+            ],
+            "properties": {
+                "degraded": { "type": "boolean" },
+                "readFirstCount": { "type": "number" },
+                "readIfNeededCount": { "type": "number" },
+                "sliceCandidateCount": { "type": "number" },
+                "knownProblemCount": { "type": "number" },
+                "issueCount": { "type": "number" }
+            }
+        },
+        "issues": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "additionalProperties": true,
+                "required": ["severity", "code", "message"],
+                "properties": {
+                    "severity": { "enum": ["info", "warning", "error"] },
+                    "code": { "type": "string" },
+                    "message": { "type": "string", "minLength": 1 }
+                }
+            }
+        }
+    }
+}

package/dist/schemas/task-close-repair-plan.schema.json

@@ -0,0 +1,67 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.task.closeRepairPlan.v1",
+    "x-hadara-schema-id": "hadara.task.closeRepairPlan.v1",
+    "type": "object",
+    "additionalProperties": true,
+    "required": ["schemaVersion", "command", "ok", "readOnly", "taskId", "generatedAt", "actor", "classification", "repairNeeded", "summary", "evidence", "causes", "nextActions", "issues"],
+    "properties": {
+        "schemaVersion": { "const": "hadara.task.closeRepairPlan.v1" },
+        "command": { "const": "task.close-repair-plan" },
+        "ok": { "type": "boolean" },
+        "readOnly": { "const": true },
+        "taskId": { "type": "string" },
+        "generatedAt": { "type": "string" },
+        "actor": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["agentId", "runId", "role", "parentRunId"],
+            "properties": {
+                "agentId": { "type": "string" },
+                "runId": { "type": "string" },
+                "role": { "enum": ["operator", "coordinator", "worker", "reviewer", "unknown"] },
+                "parentRunId": { "type": ["string", "null"] }
+            }
+        },
+        "classification": { "enum": ["not-closed", "closed-stale", "closed-invalid", "duplicate-close-proof", "closed-valid", "unknown"] },
+        "repairNeeded": { "type": "boolean" },
+        "summary": { "type": "string" },
+        "evidence": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["closeEvidenceFound", "closeEvidenceValid", "closeEvidenceRecords", "currentValidationReportHash", "currentSourceHash"],
+            "properties": {
+                "closeEvidenceFound": { "type": "boolean" },
+                "closeEvidenceValid": { "type": "boolean" },
+                "closeEvidenceRecords": { "type": "number" },
+                "latestCloseEvidenceId": { "type": "string" },
+                "duplicateCloseEvidenceCount": { "type": "number" },
+                "supersededCloseEvidenceIds": { "type": "array", "items": { "type": "string" } },
+                "recordedValidationReportHash": { "type": "string" },
+                "currentValidationReportHash": { "type": "string" },
+                "reportHashMatches": { "type": "boolean" },
+                "recordedSourceHash": { "type": "string" },
+                "currentSourceHash": { "type": "string" },
+                "sourceHashMatches": { "type": "boolean" }
+            }
+        },
+        "causes": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "additionalProperties": true,
+                "required": ["code", "severity", "summary", "sourceReport"],
+                "properties": {
+                    "code": { "type": "string" },
+                    "severity": { "enum": ["error", "warning", "info"] },
+                    "summary": { "type": "string" },
+                    "sourceReport": { "enum": ["hadara.task.audit_close.v1", "hadara.task.close.v1"] },
+                    "path": { "type": "string" }
+                }
+            }
+        },
+        "primaryNextAction": { "type": "object", "additionalProperties": true },
+        "nextActions": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+        "issues": { "type": "array", "items": { "type": "object", "additionalProperties": true } }
+    }
+}

package/dist/schemas/task-context.schema.json

@@ -0,0 +1,125 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.taskContext.v1",
+    "x-hadara-schema-id": "hadara.taskContext.v1",
+    "title": "HADARA Task Context Report",
+    "type": "object",
+    "additionalProperties": true,
+    "required": [
+        "schemaVersion",
+        "taskId",
+        "readFirst",
+        "readIfNeeded",
+        "doNotReadByDefault",
+        "relatedEvidence",
+        "relatedCommands",
+        "knownProblems",
+        "validationSuggestions",
+        "stateIssues",
+        "issues"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "hadara.taskContext.v1" },
+        "taskId": { "type": "string", "minLength": 1 },
+        "task": { "$ref": "#/$defs/node" },
+        "readFirst": { "type": "array", "items": { "$ref": "#/$defs/candidate" } },
+        "readIfNeeded": { "type": "array", "items": { "$ref": "#/$defs/candidate" } },
+        "doNotReadByDefault": { "type": "array", "items": { "$ref": "#/$defs/candidate" } },
+        "relatedEvidence": { "type": "array", "items": { "$ref": "#/$defs/candidate" } },
+        "relatedCommands": { "type": "array", "items": { "$ref": "#/$defs/candidate" } },
+        "knownProblems": { "type": "array", "items": { "$ref": "#/$defs/candidate" } },
+        "validationSuggestions": { "type": "array", "items": { "type": "string" } },
+        "stateIssues": { "type": "array", "items": { "$ref": "#/$defs/stateIssue" } },
+        "issues": { "type": "array", "items": { "$ref": "#/$defs/graphIssue" } }
+    },
+    "$defs": {
+        "confidence": { "enum": ["explicit", "derived", "heuristic"] },
+        "nodeType": {
+            "enum": ["Task", "Document", "ManagedSection", "Evidence", "Command", "ReleaseCheck", "Decision", "KnownProblem"]
+        },
+        "source": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["path", "extractor"],
+            "properties": {
+                "path": { "type": "string", "minLength": 1 },
+                "line": { "type": "number" },
+                "hash": { "type": "string" },
+                "extractor": { "type": "string", "minLength": 1 }
+            }
+        },
+        "node": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["id", "type", "label", "source"],
+            "properties": {
+                "id": { "type": "string", "minLength": 1 },
+                "type": { "$ref": "#/$defs/nodeType" },
+                "label": { "type": "string", "minLength": 1 },
+                "path": { "type": "string" },
+                "status": { "type": "string" },
+                "kind": { "type": "string" },
+                "owner": { "type": "string" },
+                "metadata": { "type": "object" },
+                "source": { "$ref": "#/$defs/source" }
+            }
+        },
+        "candidate": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["id", "type", "reason", "confidence"],
+            "properties": {
+                "id": { "type": "string", "minLength": 1 },
+                "type": { "$ref": "#/$defs/nodeType" },
+                "path": { "type": "string" },
+                "reason": { "type": "string", "minLength": 1 },
+                "confidence": { "$ref": "#/$defs/confidence" },
+                "sourceHash": { "type": "string" }
+            }
+        },
+        "stateIssue": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["severity", "code", "message", "paths"],
+            "properties": {
+                "severity": { "enum": ["info", "warning", "error"] },
+                "code": {
+                    "enum": [
+                        "STATE_LATEST_TASK_MISMATCH",
+                        "STATE_ACTIVE_TASK_MISMATCH",
+                        "STATE_TASK_BOARD_MISSING_ROW",
+                        "STATE_TASK_CAPSULE_MISSING",
+                        "STATE_CLOSE_PROOF_STALE",
+                        "STATE_RELEASE_EVIDENCE_STALE",
+                        "STATE_DOC_REQUIRED_READING_DRIFT",
+                        "STATE_UNKNOWN"
+                    ]
+                },
+                "message": { "type": "string", "minLength": 1 },
+                "paths": { "type": "array", "items": { "type": "string" } },
+                "fixHint": { "type": "string" }
+            }
+        },
+        "graphIssue": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["severity", "code", "message"],
+            "properties": {
+                "severity": { "enum": ["info", "warning", "error"] },
+                "code": {
+                    "enum": [
+                        "CONTEXT_GRAPH_SOURCE_MISSING",
+                        "CONTEXT_GRAPH_PARSE_FAILED",
+                        "CONTEXT_GRAPH_DOC_REGISTRY_MISSING",
+                        "CONTEXT_GRAPH_COMMAND_REGISTRY_MISSING",
+                        "CONTEXT_GRAPH_EVIDENCE_READ_FAILED",
+                        "CONTEXT_GRAPH_DEGRADED"
+                    ]
+                },
+                "message": { "type": "string", "minLength": 1 },
+                "path": { "type": "string" },
+                "fixHint": { "type": "string" }
+            }
+        }
+    }
+}