hadara 0.1.0-rc.0

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

@@ -0,0 +1,35 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.context.export.v1",
+    "x-hadara-schema-id": "hadara.context.export.v1",
+    "title": "HADARA Context Export Report",
+    "type": "object",
+    "additionalProperties": true,
+    "required": ["schemaVersion", "command", "ok", "format", "mode", "content", "contextPath", "wouldWritePath", "issues"],
+    "properties": {
+        "schemaVersion": { "const": "hadara.context.export.v1" },
+        "command": { "const": "context.export" },
+        "ok": { "type": "boolean" },
+        "format": { "type": "string", "enum": ["markdown", "json"] },
+        "mode": { "const": "memory" },
+        "content": { "type": "string" },
+        "contextPath": { "type": "null" },
+        "wouldWritePath": { "const": ".hadara/context/HADARA_CONTEXT.md" },
+        "issues": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/issue" }
+        }
+    },
+    "$defs": {
+        "issue": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["severity", "code", "message"],
+            "properties": {
+                "severity": { "type": "string", "enum": ["warning", "error"] },
+                "code": { "type": "string", "minLength": 1 },
+                "message": { "type": "string", "minLength": 1 }
+            }
+        }
+    }
+}

package/dist/schemas/event.schema.json

@@ -0,0 +1,17 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.event.v1",
+    "x-hadara-schema-id": "hadara.event.v1",
+    "type": "object",
+    "required": ["schemaVersion", "time", "level", "eventType", "actor", "summary"],
+    "properties": {
+        "schemaVersion": { "const": "hadara.event.v1" },
+        "time": { "type": "string", "minLength": 1 },
+        "level": { "type": "string", "enum": ["debug", "info", "warn", "error"] },
+        "eventType": { "type": "string", "minLength": 1, "pattern": "^[A-Za-z0-9_.:-]+$" },
+        "actor": { "type": "string", "enum": ["cli", "mcp", "system", "agent", "user"] },
+        "taskId": { "type": "string", "pattern": "^T-[0-9]{4}$" },
+        "summary": { "type": "string", "minLength": 1 },
+        "payload": { "type": ["object", "array", "string", "number", "boolean", "null"] }
+    }
+}

package/dist/schemas/evidence-list.schema.json

@@ -0,0 +1,49 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.evidence.list.v1",
+    "x-hadara-schema-id": "hadara.evidence.list.v1",
+    "title": "HADARA Evidence List Report",
+    "type": "object",
+    "additionalProperties": true,
+    "required": ["schemaVersion", "command", "ok", "taskId", "count", "records", "issues"],
+    "properties": {
+        "schemaVersion": { "const": "hadara.evidence.list.v1" },
+        "command": { "const": "evidence.list" },
+        "ok": { "type": "boolean" },
+        "taskId": { "type": "string", "pattern": "^T-[0-9]{4}$" },
+        "count": { "type": "integer", "minimum": 0 },
+        "records": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "additionalProperties": true,
+                "required": ["schemaVersion", "time", "taskId", "kind", "summary", "result", "visibility"],
+                "properties": {
+                    "schemaVersion": { "const": "hadara.evidence.v1" },
+                    "time": { "type": "string", "minLength": 1 },
+                    "taskId": { "type": "string", "pattern": "^T-[0-9]{4}$" },
+                    "kind": { "type": "string", "enum": ["test-log", "command-log", "diff-summary", "screenshot", "note"] },
+                    "summary": { "type": "string", "minLength": 1 },
+                    "result": { "type": "string", "enum": ["passed", "failed", "blocked", "unknown"] },
+                    "visibility": { "type": "string", "enum": ["public", "private"] }
+                }
+            }
+        },
+        "issues": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/issue" }
+        }
+    },
+    "$defs": {
+        "issue": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["severity", "code", "message"],
+            "properties": {
+                "severity": { "type": "string", "enum": ["warning", "error"] },
+                "code": { "type": "string", "minLength": 1 },
+                "message": { "type": "string", "minLength": 1 }
+            }
+        }
+    }
+}

package/dist/schemas/feature-smoke.schema.json

@@ -0,0 +1,67 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.featureSmoke.v1",
+    "x-hadara-schema-id": "hadara.featureSmoke.v1",
+    "title": "HADARA Feature Smoke Report",
+    "type": "object",
+    "additionalProperties": true,
+    "required": [
+        "schemaVersion",
+        "command",
+        "ok",
+        "profile",
+        "readOnly",
+        "executionMode",
+        "binaryExecuted",
+        "launcherChecked",
+        "packageInstallChecked",
+        "steps",
+        "issues"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "hadara.featureSmoke.v1" },
+        "command": { "const": "feature-smoke.run" },
+        "ok": { "type": "boolean" },
+        "profile": { "type": "string", "enum": ["core", "release-readiness"] },
+        "readOnly": { "const": true },
+        "executionMode": { "const": "service-read-model" },
+        "binaryExecuted": { "const": false },
+        "launcherChecked": { "const": false },
+        "packageInstallChecked": { "const": false },
+        "steps": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/step" }
+        },
+        "issues": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/issue" }
+        }
+    },
+    "$defs": {
+        "step": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["id", "command", "executionMode", "status", "summary"],
+            "properties": {
+                "id": { "type": "string", "minLength": 1 },
+                "command": { "type": "string", "minLength": 1 },
+                "executionMode": { "const": "service-read-model" },
+                "status": { "type": "string", "enum": ["passed", "failed", "skipped"] },
+                "schemaVersion": { "type": "string", "minLength": 1 },
+                "schemaStatus": { "type": "string", "enum": ["validated", "not-registered", "invalid"] },
+                "summary": { "type": "string", "minLength": 1 }
+            }
+        },
+        "issue": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["severity", "code", "message"],
+            "properties": {
+                "severity": { "type": "string", "enum": ["warning", "error"] },
+                "code": { "type": "string", "minLength": 1 },
+                "message": { "type": "string", "minLength": 1 },
+                "stepId": { "type": "string", "minLength": 1 }
+            }
+        }
+    }
+}

package/dist/schemas/install-plan.schema.json

@@ -0,0 +1,93 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.install.plan.v1",
+    "x-hadara-schema-id": "hadara.install.plan.v1",
+    "title": "HADARA Install Plan Report",
+    "type": "object",
+    "additionalProperties": true,
+    "required": ["schemaVersion", "command", "ok", "mode", "platform", "source", "target", "execution", "actions", "issues"],
+    "properties": {
+        "schemaVersion": { "const": "hadara.install.plan.v1" },
+        "command": { "const": "install.plan" },
+        "ok": { "type": "boolean" },
+        "mode": { "type": "string", "enum": ["dry-run", "execute"] },
+        "platform": { "type": "string", "enum": ["linux", "posix", "windows", "wsl", "usb"] },
+        "source": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["kind", "pathRedacted"],
+            "properties": {
+                "kind": { "type": "string", "enum": ["tarball", "directory", "portable-bundle"] },
+                "displayPath": { "type": "string", "minLength": 1 },
+                "pathRedacted": { "type": "boolean", "const": true },
+                "relativePath": { "type": "string", "minLength": 1 }
+            }
+        },
+        "target": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["prefix", "launcher"],
+            "properties": {
+                "prefix": { "$ref": "#/$defs/publicPathRef" },
+                "launcher": { "$ref": "#/$defs/publicPathRef" }
+            }
+        },
+        "execution": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["executeEnabled"],
+            "properties": {
+                "executeEnabled": { "type": "boolean" },
+                "disabledIssueCode": { "type": "string", "minLength": 1 }
+            }
+        },
+        "node": {
+            "type": "object",
+            "additionalProperties": true,
+            "properties": {
+                "requiredMajor": { "type": "integer" },
+                "detected": { "type": ["string", "null"] },
+                "windowsShimRejected": { "type": "boolean" }
+            }
+        },
+        "actions": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "additionalProperties": true,
+                "required": ["kind", "description", "wouldWrite"],
+                "properties": {
+                    "kind": { "type": "string", "minLength": 1 },
+                    "description": { "type": "string", "minLength": 1 },
+                    "wouldWrite": { "type": "boolean" }
+                }
+            }
+        },
+        "issues": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "additionalProperties": true,
+                "required": ["severity", "code", "message"],
+                "properties": {
+                    "severity": { "type": "string", "enum": ["warning", "error"] },
+                    "code": { "type": "string", "minLength": 1 },
+                    "message": { "type": "string", "minLength": 1 }
+                }
+            }
+        }
+    },
+    "$defs": {
+        "publicPathRef": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["displayPath", "pathRedacted"],
+            "properties": {
+                "displayPath": { "type": "string", "minLength": 1 },
+                "pathRedacted": { "type": "boolean", "const": true },
+                "relativePath": { "type": "string", "minLength": 1 },
+                "kind": { "type": "string", "enum": ["default", "portable", "relative"] }
+            }
+        }
+    }
+}

package/dist/schemas/package-smoke.schema.json

@@ -0,0 +1,130 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.packageSmoke.v1",
+    "x-hadara-schema-id": "hadara.packageSmoke.v1",
+    "title": "HADARA Package Smoke Report",
+    "type": "object",
+    "additionalProperties": true,
+    "required": [
+        "schemaVersion",
+        "command",
+        "ok",
+        "mode",
+        "readOnly",
+        "execution",
+        "workspace",
+        "source",
+        "steps",
+        "artifacts",
+        "privacy",
+        "issues"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "hadara.packageSmoke.v1" },
+        "command": { "const": "package.smoke" },
+        "ok": { "type": "boolean" },
+        "mode": { "type": "string", "enum": ["dry-run", "local"] },
+        "readOnly": { "type": "boolean" },
+        "execution": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["npmPackExecuted", "packageInstallExecuted", "featureSmokeExecuted", "releaseMutationExecuted", "publishExecuted"],
+            "properties": {
+                "npmPackExecuted": { "type": "boolean" },
+                "packageInstallExecuted": { "type": "boolean" },
+                "featureSmokeExecuted": { "type": "boolean" },
+                "releaseMutationExecuted": { "const": false },
+                "publishExecuted": { "const": false }
+            }
+        },
+        "workspace": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["kind", "pathRedacted"],
+            "properties": {
+                "kind": { "type": "string", "enum": ["disposable", "project-source"] },
+                "displayPath": { "type": "string", "minLength": 1 },
+                "relativePath": { "type": "string", "minLength": 1 },
+                "pathRedacted": { "const": true },
+                "retention": { "type": "string", "enum": ["deleted", "kept-temporary", "private-local"] }
+            }
+        },
+        "source": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["kind", "pathRedacted"],
+            "properties": {
+                "kind": { "type": "string", "enum": ["source-checkout", "tarball", "release-artifact"] },
+                "displayPath": { "type": "string", "minLength": 1 },
+                "relativePath": { "type": "string", "minLength": 1 },
+                "pathRedacted": { "const": true }
+            }
+        },
+        "steps": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/step" }
+        },
+        "artifacts": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/artifact" }
+        },
+        "privacy": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["rawLogsIncluded", "rawPackageContentsIncluded", "privatePathsIncluded", "environmentSecretsIncluded", "privateStorePathsIncluded"],
+            "properties": {
+                "rawLogsIncluded": { "const": false },
+                "rawPackageContentsIncluded": { "const": false },
+                "privatePathsIncluded": { "const": false },
+                "environmentSecretsIncluded": { "const": false },
+                "privateStorePathsIncluded": { "const": false }
+            }
+        },
+        "issues": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/issue" }
+        }
+    },
+    "$defs": {
+        "step": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["id", "label", "status"],
+            "properties": {
+                "id": { "type": "string", "minLength": 1 },
+                "label": { "type": "string", "minLength": 1 },
+                "status": { "type": "string", "enum": ["planned", "passed", "failed", "skipped"] },
+                "command": { "type": "string", "minLength": 1 },
+                "exitCode": { "type": ["integer", "null"] },
+                "elapsedMs": { "type": "integer" },
+                "summary": { "type": "string", "minLength": 1 }
+            }
+        },
+        "artifact": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["kind", "visibility"],
+            "properties": {
+                "kind": { "type": "string", "enum": ["summary", "command-log", "package-artifact", "install-tree"] },
+                "visibility": { "type": "string", "enum": ["public", "private", "temporary"] },
+                "evidencePath": { "type": "string", "pattern": "^tasks/T-[0-9]{4}-.+/artifacts/package-smoke/.+" },
+                "relativePath": { "type": "string", "minLength": 1 },
+                "pathRedacted": { "const": true },
+                "rawContentIncluded": { "const": false },
+                "byteLength": { "type": "integer" },
+                "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+            }
+        },
+        "issue": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["severity", "code", "message"],
+            "properties": {
+                "severity": { "type": "string", "enum": ["warning", "error"] },
+                "code": { "type": "string", "minLength": 1 },
+                "message": { "type": "string", "minLength": 1 },
+                "stepId": { "type": "string", "minLength": 1 }
+            }
+        }
+    }
+}

package/dist/schemas/private-evidence.schema.json

@@ -0,0 +1,48 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.privateEvidence.v1",
+    "x-hadara-schema-id": "hadara.privateEvidence.v1",
+    "title": "HADARA Private Evidence Manifest Record",
+    "type": "object",
+    "additionalProperties": true,
+    "required": ["schemaVersion", "taskId", "evidenceId", "kind", "summary", "result", "storage", "createdAt", "retention", "encryption"],
+    "properties": {
+        "schemaVersion": { "const": "hadara.privateEvidence.v1" },
+        "taskId": { "type": "string", "pattern": "^T-[0-9]{4}$" },
+        "evidenceId": { "type": "string", "minLength": 1 },
+        "kind": { "type": "string", "enum": ["test-log", "command-log", "diff-summary", "screenshot", "note"] },
+        "summary": { "type": "string" },
+        "result": { "type": "string", "enum": ["passed", "failed", "blocked", "unknown"] },
+        "storage": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["kind", "relativePath", "encrypted", "hash", "byteLength"],
+            "properties": {
+                "kind": { "const": "portable-store" },
+                "relativePath": { "type": "string", "pattern": "^data/private-evidence/" },
+                "encrypted": { "const": false },
+                "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+                "byteLength": { "type": "integer" }
+            }
+        },
+        "createdAt": { "type": "string", "minLength": 1 },
+        "retention": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["policy", "includeInContextExport"],
+            "properties": {
+                "policy": { "const": "local-only" },
+                "includeInContextExport": { "const": false }
+            }
+        },
+        "encryption": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["status", "reason"],
+            "properties": {
+                "status": { "const": "deferred" },
+                "reason": { "type": "string", "minLength": 1 }
+            }
+        }
+    }
+}

package/dist/schemas/provider-call.schema.json

@@ -0,0 +1,42 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.provider.call.v1",
+    "x-hadara-schema-id": "hadara.provider.call.v1",
+    "type": "object",
+    "required": ["schemaVersion", "provider", "ok", "input", "issues"],
+    "properties": {
+        "schemaVersion": { "const": "hadara.provider.call.v1" },
+        "provider": { "type": "string", "minLength": 1, "pattern": "^[A-Za-z0-9_.:-]+$" },
+        "model": { "type": "string", "minLength": 1 },
+        "ok": { "type": "boolean" },
+        "input": {
+            "type": "object",
+            "required": ["messages", "approxTokens"],
+            "properties": {
+                "messages": { "type": "integer" },
+                "approxTokens": { "type": "integer" }
+            }
+        },
+        "output": {
+            "type": "object",
+            "required": ["finishReason", "approxTokens"],
+            "properties": {
+                "finishReason": { "type": "string", "enum": ["stop", "length", "tool_call", "error"] },
+                "approxTokens": { "type": "integer" }
+            }
+        },
+        "issues": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "required": ["severity", "code", "message"],
+                "properties": {
+                    "severity": { "type": "string", "enum": ["warning", "error"] },
+                    "code": { "type": "string", "minLength": 1, "pattern": "^[A-Z0-9_:-]+$" },
+                    "message": { "type": "string", "minLength": 1 },
+                    "retriable": { "type": "boolean" }
+                }
+            }
+        }
+    }
+}

package/dist/schemas/provider-config.schema.json

@@ -0,0 +1,43 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.provider.config.v1",
+    "x-hadara-schema-id": "hadara.provider.config.v1",
+    "type": "object",
+    "required": ["schemaVersion", "providers", "defaultProvider"],
+    "properties": {
+        "schemaVersion": { "const": "hadara.provider.config.v1" },
+        "providers": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "required": ["id", "kind", "enabled", "model", "capabilities", "localOnly", "costProfile"],
+                "properties": {
+                    "id": { "type": "string", "minLength": 1, "pattern": "^[A-Za-z0-9_.:-]+$" },
+                    "kind": { "type": "string", "enum": ["openai-compatible", "ollama", "llama-cpp"] },
+                    "enabled": { "type": "boolean" },
+                    "baseUrlEnv": { "type": "string", "minLength": 1, "pattern": "^[A-Z_][A-Z0-9_]*$" },
+                    "apiKeyEnv": { "type": "string", "minLength": 1, "pattern": "^[A-Z_][A-Z0-9_]*$" },
+                    "model": { "type": "string", "minLength": 1 },
+                    "capabilities": {
+                        "type": "object",
+                        "required": ["streaming", "toolCalling", "reasoning", "vision"],
+                        "properties": {
+                            "streaming": { "type": "boolean" },
+                            "toolCalling": { "type": "boolean" },
+                            "reasoning": { "type": "boolean" },
+                            "vision": { "type": "boolean" }
+                        }
+                    },
+                    "localOnly": { "type": "boolean" },
+                    "costProfile": { "type": "string", "enum": ["free", "low", "medium", "high", "unknown"] }
+                }
+            }
+        },
+        "defaultProvider": {
+            "oneOf": [
+                { "type": "string", "minLength": 1, "pattern": "^[A-Za-z0-9_.:-]+$" },
+                { "type": "null" }
+            ]
+        }
+    }
+}

package/dist/schemas/release-artifact-manifest.schema.json

@@ -0,0 +1,55 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.releaseArtifact.manifest.v1",
+    "x-hadara-schema-id": "hadara.releaseArtifact.manifest.v1",
+    "title": "HADARA Release Artifact Manifest",
+    "type": "object",
+    "additionalProperties": true,
+    "required": [
+        "schemaVersion",
+        "package",
+        "tarball",
+        "files",
+        "releaseMutationExecuted",
+        "publishExecuted",
+        "githubReleaseCreated"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "hadara.releaseArtifact.manifest.v1" },
+        "package": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["name", "version", "private"],
+            "properties": {
+                "name": { "type": "string", "minLength": 1 },
+                "version": { "type": "string", "minLength": 1 },
+                "private": { "type": "boolean" },
+                "license": { "type": "string", "minLength": 1 }
+            }
+        },
+        "tarball": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["fileName", "hash"],
+            "properties": {
+                "fileName": { "type": "string", "minLength": 1 },
+                "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+            }
+        },
+        "files": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "additionalProperties": true,
+                "required": ["path"],
+                "properties": {
+                    "path": { "type": "string", "minLength": 1 },
+                    "byteLength": { "type": "integer" }
+                }
+            }
+        },
+        "releaseMutationExecuted": { "const": false },
+        "publishExecuted": { "const": false },
+        "githubReleaseCreated": { "const": false }
+    }
+}