hadara 0.1.0-rc.0

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

@@ -0,0 +1,140 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.releaseArtifact.v1",
+    "x-hadara-schema-id": "hadara.releaseArtifact.v1",
+    "title": "HADARA Release Artifact Report",
+    "type": "object",
+    "additionalProperties": true,
+    "required": [
+        "schemaVersion",
+        "command",
+        "ok",
+        "mode",
+        "execution",
+        "output",
+        "package",
+        "artifacts",
+        "packageContents",
+        "privacy",
+        "issues"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "hadara.releaseArtifact.v1" },
+        "command": { "const": "release.artifact" },
+        "ok": { "type": "boolean" },
+        "mode": { "const": "execute" },
+        "execution": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": [
+                "stagingCreated",
+                "npmPackExecuted",
+                "checksumGenerated",
+                "manifestGenerated",
+                "packageContentsVerified",
+                "publishExecuted",
+                "githubReleaseCreated",
+                "dockerImageBuilt"
+            ],
+            "properties": {
+                "stagingCreated": { "type": "boolean" },
+                "npmPackExecuted": { "type": "boolean" },
+                "checksumGenerated": { "type": "boolean" },
+                "manifestGenerated": { "type": "boolean" },
+                "packageContentsVerified": { "type": "boolean" },
+                "publishExecuted": { "const": false },
+                "githubReleaseCreated": { "const": false },
+                "dockerImageBuilt": { "const": false }
+            }
+        },
+        "output": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["kind", "displayPath", "pathRedacted", "retention"],
+            "properties": {
+                "kind": { "type": "string", "enum": ["disposable", "explicit"] },
+                "displayPath": { "type": "string", "minLength": 1 },
+                "pathRedacted": { "const": true },
+                "relativePath": { "type": "string", "minLength": 1 },
+                "retention": { "type": "string", "enum": ["deleted", "kept-temporary", "explicit-output"] }
+            }
+        },
+        "package": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["name", "version", "private", "filesWhitelistApplied"],
+            "properties": {
+                "name": { "type": "string", "minLength": 1 },
+                "version": { "type": "string", "minLength": 1 },
+                "private": { "type": "boolean" },
+                "filesWhitelistApplied": { "const": true }
+            }
+        },
+        "artifacts": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/artifact" }
+        },
+        "packageContents": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["verified", "fileCount", "allowedRoots", "requiredFiles", "forbiddenMatches"],
+            "properties": {
+                "verified": { "type": "boolean" },
+                "fileCount": { "type": "integer" },
+                "allowedRoots": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+                "requiredFiles": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+                "forbiddenMatches": { "type": "array", "items": { "type": "string", "minLength": 1 } }
+            }
+        },
+        "privacy": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": [
+                "rawLogsIncluded",
+                "packageContentsIncluded",
+                "privatePathsIncluded",
+                "environmentSecretsIncluded",
+                "privateStorePathsIncluded"
+            ],
+            "properties": {
+                "rawLogsIncluded": { "const": false },
+                "packageContentsIncluded": { "const": false },
+                "privatePathsIncluded": { "const": false },
+                "environmentSecretsIncluded": { "const": false },
+                "privateStorePathsIncluded": { "const": false }
+            }
+        },
+        "issues": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/issue" }
+        }
+    },
+    "$defs": {
+        "artifact": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["kind", "visibility", "fileName", "pathRedacted", "rawContentIncluded"],
+            "properties": {
+                "kind": { "type": "string", "enum": ["tarball", "checksum", "manifest"] },
+                "visibility": { "type": "string", "enum": ["temporary", "local"] },
+                "fileName": { "type": "string", "minLength": 1 },
+                "relativePath": { "type": "string", "minLength": 1 },
+                "pathRedacted": { "const": true },
+                "byteLength": { "type": "integer" },
+                "hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+                "rawContentIncluded": { "const": false }
+            }
+        },
+        "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/release-dry-run.schema.json

@@ -0,0 +1,141 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.releaseDryRun.v1",
+    "x-hadara-schema-id": "hadara.releaseDryRun.v1",
+    "title": "HADARA Release Dry Run Report",
+    "type": "object",
+    "additionalProperties": true,
+    "required": [
+        "schemaVersion",
+        "command",
+        "mode",
+        "ok",
+        "current",
+        "releaseTargets",
+        "checks",
+        "evidence",
+        "plannedSteps",
+        "privacy",
+        "issues"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "hadara.releaseDryRun.v1" },
+        "command": { "const": "release.dryRun" },
+        "mode": { "const": "dry-run" },
+        "ok": { "type": "boolean" },
+        "current": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["packageName", "packageVersion"],
+            "properties": {
+                "packageName": { "type": "string", "minLength": 1 },
+                "packageVersion": { "type": "string", "minLength": 1 },
+                "gitCommit": { "type": "string", "pattern": "^[a-f0-9]{40}$" }
+            }
+        },
+        "releaseTargets": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["primary", "secondary", "dockerImage"],
+            "properties": {
+                "primary": { "const": "npm-package" },
+                "secondary": { "const": "github-release" },
+                "dockerImage": { "const": "deferred" }
+            }
+        },
+        "checks": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/check" }
+        },
+        "evidence": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/evidence" }
+        },
+        "plannedSteps": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/plannedStep" }
+        },
+        "privacy": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": [
+                "tokenValuesIncluded",
+                "rawLogsIncluded",
+                "privatePathsIncluded",
+                "publishExecuted",
+                "githubReleaseCreated",
+                "dockerImageBuilt"
+            ],
+            "properties": {
+                "tokenValuesIncluded": { "const": false },
+                "rawLogsIncluded": { "const": false },
+                "privatePathsIncluded": { "const": false },
+                "publishExecuted": { "const": false },
+                "githubReleaseCreated": { "const": false },
+                "dockerImageBuilt": { "const": false }
+            }
+        },
+        "issues": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/issue" }
+        }
+    },
+    "$defs": {
+        "check": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["code", "name", "status", "summary"],
+            "properties": {
+                "code": { "type": "string", "minLength": 1 },
+                "name": { "type": "string", "minLength": 1 },
+                "status": { "type": "string", "enum": ["passed", "warning", "error"] },
+                "summary": { "type": "string", "minLength": 1 }
+            }
+        },
+        "evidence": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["code", "artifactExists"],
+            "properties": {
+                "code": {
+                    "type": "string",
+                    "enum": ["PACKAGE_SMOKE_EVIDENCE", "CLEAN_CHECKOUT_SMOKE_EVIDENCE", "RELEASE_ARTIFACT_EVIDENCE"]
+                },
+                "taskId": { "type": "string", "pattern": "^T-[0-9]{4}$" },
+                "time": { "type": "string", "minLength": 1 },
+                "evidencePath": { "type": "string", "minLength": 1 },
+                "artifactExists": { "type": "boolean" },
+                "artifactSchemaValid": { "type": "boolean" },
+                "sourceOk": { "type": "boolean" },
+                "category": { "type": "string", "minLength": 1 },
+                "mode": { "type": "string", "minLength": 1 },
+                "result": { "type": "string", "minLength": 1 },
+                "packageVersion": { "type": "string", "minLength": 1 },
+                "gitCommit": { "type": "string", "pattern": "^[a-f0-9]{40}$" },
+                "manifestHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+            }
+        },
+        "plannedStep": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["id", "target", "willExecute", "requiresApproval", "summary"],
+            "properties": {
+                "id": { "type": "string", "minLength": 1 },
+                "target": { "type": "string", "enum": ["npm-package", "github-release", "docker-image"] },
+                "willExecute": { "const": false },
+                "requiresApproval": { "type": "boolean" },
+                "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 }
+            }
+        }
+    }
+}

package/dist/schemas/release-gate.schema.json

@@ -0,0 +1,42 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.releaseGate.v1",
+    "x-hadara-schema-id": "hadara.releaseGate.v1",
+    "title": "HADARA Release Gate Report",
+    "type": "object",
+    "additionalProperties": true,
+    "required": ["schemaVersion", "command", "mode", "ok", "checks", "issues"],
+    "properties": {
+        "schemaVersion": { "const": "hadara.releaseGate.v1" },
+        "command": { "const": "release.gate" },
+        "mode": { "type": "string", "enum": ["advisory", "strict"] },
+        "ok": { "type": "boolean" },
+        "checks": {
+            "type": "array",
+            "items": {
+                "type": "object",
+                "additionalProperties": true,
+                "required": ["code", "name", "status", "summary"],
+                "properties": {
+                    "code": { "type": "string", "minLength": 1 },
+                    "name": { "type": "string", "minLength": 1 },
+                    "status": { "type": "string", "enum": ["passed", "warning", "error"] },
+                    "summary": { "type": "string", "minLength": 1 }
+                }
+            }
+        },
+        "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 }
+                }
+            }
+        }
+    }
+}

package/dist/schemas/release-publish.schema.json

@@ -0,0 +1,114 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "hadara.releasePublish.v1",
+    "x-hadara-schema-id": "hadara.releasePublish.v1",
+    "title": "HADARA Release Publish Report",
+    "type": "object",
+    "additionalProperties": true,
+    "required": ["schemaVersion", "command", "mode", "ok", "current", "approval", "releaseTargets", "checks", "privacy", "issues"],
+    "properties": {
+        "schemaVersion": { "const": "hadara.releasePublish.v1" },
+        "command": { "const": "release.publish" },
+        "mode": { "type": "string", "enum": ["dry-run", "execute"] },
+        "ok": { "type": "boolean" },
+        "current": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["packageName", "packageVersion", "private"],
+            "properties": {
+                "packageName": { "type": "string", "minLength": 1 },
+                "packageVersion": { "type": "string", "minLength": 1 },
+                "private": { "type": "boolean" }
+            }
+        },
+        "approval": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["required", "actorProvided", "reasonProvided", "confirmationProvided"],
+            "properties": {
+                "required": { "const": true },
+                "actorProvided": { "type": "boolean" },
+                "reasonProvided": { "type": "boolean" },
+                "confirmationProvided": { "type": "boolean" }
+            }
+        },
+        "releaseTargets": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/releaseTarget" }
+        },
+        "checks": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/check" }
+        },
+        "privacy": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": [
+                "tokenValuesIncluded",
+                "rawLogsIncluded",
+                "privatePathsIncluded",
+                "publishExecuted",
+                "githubReleaseCreated",
+                "dockerImageBuilt"
+            ],
+            "properties": {
+                "tokenValuesIncluded": { "const": false },
+                "rawLogsIncluded": { "const": false },
+                "privatePathsIncluded": { "const": false },
+                "publishExecuted": { "const": false },
+                "githubReleaseCreated": { "const": false },
+                "dockerImageBuilt": { "const": false }
+            }
+        },
+        "audit": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["attempted", "written"],
+            "properties": {
+                "attempted": { "type": "boolean" },
+                "written": { "type": "boolean" }
+            }
+        },
+        "issues": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/issue" }
+        }
+    },
+    "$defs": {
+        "releaseTarget": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["id", "target", "status", "willExecute", "summary"],
+            "properties": {
+                "id": { "type": "string", "enum": ["npm-publish", "github-release", "docker-image"] },
+                "target": { "type": "string", "enum": ["npm-package", "github-release", "docker-image"] },
+                "status": { "type": "string", "enum": ["ready", "blocked", "deferred"] },
+                "tokenName": { "type": "string", "minLength": 1 },
+                "tokenPresent": { "type": "boolean" },
+                "willExecute": { "const": false },
+                "summary": { "type": "string", "minLength": 1 }
+            }
+        },
+        "check": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["code", "name", "status", "summary"],
+            "properties": {
+                "code": { "type": "string", "minLength": 1 },
+                "name": { "type": "string", "minLength": 1 },
+                "status": { "type": "string", "enum": ["passed", "warning", "error"] },
+                "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 }
+            }
+        }
+    }
+}

package/dist/schemas/schema-index.json

@@ -0,0 +1,145 @@
+{
+    "schemaVersion": "hadara.schema.index.v1",
+    "schemas": [
+        {
+            "id": "hadara.evidence.list.v1",
+            "path": "src/schemas/evidence-list.schema.json",
+            "status": "fixture",
+            "owner": "services/evidence-list",
+            "notes": "Shared by CLI evidence list and read-only MCP hadara.evidence.list."
+        },
+        {
+            "id": "hadara.context.export.v1",
+            "path": "src/schemas/context-export.schema.json",
+            "status": "fixture",
+            "owner": "hermes/context-export",
+            "notes": "Documents read-only MCP memory-mode context export; CLI export-context remains file-writing."
+        },
+        {
+            "id": "hadara.tools.list.v1",
+            "path": "src/schemas/tools-list.schema.json",
+            "status": "fixture",
+            "owner": "services/tools-list",
+            "notes": "Documents CLI/MCP capability discovery, availability metadata, and disabled surfaces."
+        },
+        {
+            "id": "hadara.active_run.projection.v1",
+            "path": "src/schemas/active-run-projection.schema.json",
+            "status": "fixture",
+            "owner": "services/active-run-state",
+            "notes": "Documents read-only active-run projection with degraded warnings for local mutable state."
+        },
+        {
+            "id": "hadara.active_run.resume.v1",
+            "path": "src/schemas/active-run-resume.schema.json",
+            "status": "fixture",
+            "owner": "services/active-run-state",
+            "notes": "Documents read-only resume guidance; it does not mutate active-run state or resume a process."
+        },
+        {
+            "id": "hadara.privateEvidence.v1",
+            "path": "src/schemas/private-evidence.schema.json",
+            "status": "fixture",
+            "owner": "evidence/private-manifest",
+            "notes": "Documents private portable-store manifest records without private raw content or source paths."
+        },
+        {
+            "id": "hadara.releaseGate.v1",
+            "path": "src/schemas/release-gate.schema.json",
+            "status": "fixture",
+            "owner": "services/operational-debt",
+            "notes": "Documents advisory and strict release gate reports."
+        },
+        {
+            "id": "hadara.event.v1",
+            "path": "src/schemas/event.schema.json",
+            "status": "fixture",
+            "owner": "core/events",
+            "notes": "Documents structured HADARA event records used by private audit JSONL and future debug/read surfaces."
+        },
+        {
+            "id": "hadara.provider.config.v1",
+            "path": "src/schemas/provider-config.schema.json",
+            "status": "fixture",
+            "owner": "providers/preparation",
+            "notes": "Documents provider adapter configuration references without storing provider secret values."
+        },
+        {
+            "id": "hadara.provider.call.v1",
+            "path": "src/schemas/provider-call.schema.json",
+            "status": "fixture",
+            "owner": "providers/preparation",
+            "notes": "Documents provider call summary reports without prompt, response, or secret content."
+        },
+        {
+            "id": "hadara.write.preflight.v1",
+            "path": "src/schemas/write-preflight.schema.json",
+            "status": "fixture",
+            "owner": "services/write-preflight",
+            "notes": "Documents read-only CLI write-boundary preflight reports for expected project/portable write paths."
+        },
+        {
+            "id": "hadara.install.plan.v1",
+            "path": "src/schemas/install-plan.schema.json",
+            "status": "fixture",
+            "owner": "install/plan",
+            "notes": "Documents dry-run installer planning reports before any install mutation implementation."
+        },
+        {
+            "id": "hadara.packageSmoke.v1",
+            "path": "src/schemas/package-smoke.schema.json",
+            "status": "fixture",
+            "owner": "package-smoke/report",
+            "notes": "Documents reduced package-smoke reports before dry-run or executable package-smoke command implementation."
+        },
+        {
+            "id": "hadara.featureSmoke.v1",
+            "path": "src/schemas/feature-smoke.schema.json",
+            "status": "fixture",
+            "owner": "feature-smoke/runner",
+            "notes": "Documents reduced read-only major feature smoke reports for core service/read-model validation; installed binary and launcher checks are deferred."
+        },
+        {
+            "id": "hadara.cleanCheckoutSmoke.v1",
+            "path": "src/schemas/clean-checkout-smoke.schema.json",
+            "status": "fixture",
+            "owner": "clean-checkout/smoke",
+            "notes": "Documents reduced executable source-checkout smoke reports for disposable clean checkout validation."
+        },
+        {
+            "id": "hadara.releaseArtifact.v1",
+            "path": "src/schemas/release-artifact.schema.json",
+            "status": "fixture",
+            "owner": "release/artifact",
+            "notes": "Documents reduced release artifact build reports for tarball, checksum, manifest, and package-content verification without publish or GitHub Release mutation."
+        },
+        {
+            "id": "hadara.releaseDryRun.v1",
+            "path": "src/schemas/release-dry-run.schema.json",
+            "status": "fixture",
+            "owner": "release/dry-run",
+            "notes": "Documents read-only final release dry-run reports that cross-check public evidence artifacts and planned release targets without publish or GitHub Release mutation."
+        },
+        {
+            "id": "hadara.releasePublish.v1",
+            "path": "src/schemas/release-publish.schema.json",
+            "status": "fixture",
+            "owner": "release/publish",
+            "notes": "Documents approval-gated publish/deploy readiness reports with token presence checks but no token values or release mutation."
+        },
+        {
+            "id": "hadara.smokeEvidenceSummary.v1",
+            "path": "src/schemas/smoke-evidence-summary.schema.json",
+            "status": "fixture",
+            "owner": "smoke/evidence",
+            "notes": "Documents reduced public smoke evidence summaries attached by package-smoke and clean-checkout smoke execution."
+        },
+        {
+            "id": "hadara.releaseArtifact.manifest.v1",
+            "path": "src/schemas/release-artifact-manifest.schema.json",
+            "status": "fixture",
+            "owner": "release/artifact",
+            "notes": "Documents generated release artifact manifest files for tarball hash and package file lists without publish or GitHub Release mutation."
+        }
+    ]
+}