zenkit 0.5.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,121 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAgainstSchema = exports.schemas = void 0;
+exports.validate = validate;
+exports.getSchema = getSchema;
+exports.getSchemaNames = getSchemaNames;
+exports.loadFeatureSpec = loadFeatureSpec;
+exports.createHandoff = createHandoff;
+/**
+ * ZenKit — Programmatic API
+ *
+ * Usage:
+ *   import { validate, schemas, loadFeatureSpec } from 'zenkit'
+ *
+ *   const result = validate('handoff', myData)
+ *   if (!result.valid) console.error(result.errors)
+ */
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ajv_1 = __importDefault(require("ajv"));
+const ajv_formats_1 = __importDefault(require("ajv-formats"));
+// --- Schema Loading ---
+const handoff_schema_json_1 = __importDefault(require("../schemas/handoff.schema.json"));
+const task_schema_json_1 = __importDefault(require("../schemas/task.schema.json"));
+const audit_schema_json_1 = __importDefault(require("../schemas/audit.schema.json"));
+const checkpoint_schema_json_1 = __importDefault(require("../schemas/checkpoint.schema.json"));
+const benchmark_schema_json_1 = __importDefault(require("../schemas/benchmark.schema.json"));
+const feature_spec_schema_json_1 = __importDefault(require("../schemas/feature-spec.schema.json"));
+const ajv = new ajv_1.default({ allErrors: true, strict: false });
+(0, ajv_formats_1.default)(ajv);
+exports.schemas = {
+    handoff: handoff_schema_json_1.default,
+    task: task_schema_json_1.default,
+    audit: audit_schema_json_1.default,
+    checkpoint: checkpoint_schema_json_1.default,
+    benchmark: benchmark_schema_json_1.default,
+    'feature-spec': feature_spec_schema_json_1.default,
+};
+const validators = {
+    handoff: ajv.compile(handoff_schema_json_1.default),
+    task: ajv.compile(task_schema_json_1.default),
+    audit: ajv.compile(audit_schema_json_1.default),
+    checkpoint: ajv.compile(checkpoint_schema_json_1.default),
+    benchmark: ajv.compile(benchmark_schema_json_1.default),
+    'feature-spec': ajv.compile(feature_spec_schema_json_1.default),
+};
+/**
+ * Validate data against a named ZenKit schema.
+ *
+ * @example
+ * const result = validate('handoff', { context: '...', ... })
+ * if (!result.valid) console.error(result.errors)
+ */
+function validate(schemaName, data) {
+    const validator = validators[schemaName];
+    if (!validator) {
+        return {
+            valid: false,
+            errors: [{ path: '/', message: `Unknown schema: ${schemaName}`, keyword: 'schema' }],
+            schemaName,
+        };
+    }
+    const valid = validator(data);
+    return {
+        valid,
+        errors: valid
+            ? []
+            : (validator.errors || []).map((err) => ({
+                path: err.instancePath || '/',
+                message: err.message || 'Unknown validation error',
+                keyword: err.keyword,
+            })),
+        schemaName,
+    };
+}
+/**
+ * Get the raw JSON Schema object for a named schema.
+ */
+function getSchema(name) {
+    return exports.schemas[name];
+}
+/**
+ * List all available schema names.
+ */
+function getSchemaNames() {
+    return Object.keys(exports.schemas);
+}
+/**
+ * Load and validate a feature spec from a JSON file.
+ * Returns the parsed spec if valid, throws if invalid.
+ */
+function loadFeatureSpec(specPath) {
+    const resolved = path_1.default.resolve(specPath);
+    const raw = fs_1.default.readFileSync(resolved, 'utf-8');
+    const data = JSON.parse(raw);
+    const result = validate('feature-spec', data);
+    if (!result.valid) {
+        const errorMsg = result.errors.map(e => `${e.path}: ${e.message}`).join(', ');
+        throw new Error(`Invalid feature spec: ${errorMsg}`);
+    }
+    return data;
+}
+/**
+ * Create and validate a handoff object.
+ * Returns the handoff if valid, throws if invalid.
+ */
+function createHandoff(handoff) {
+    const result = validate('handoff', handoff);
+    if (!result.valid) {
+        const errorMsg = result.errors.map(e => `${e.path}: ${e.message}`).join(', ');
+        throw new Error(`Invalid handoff: ${errorMsg}`);
+    }
+    return handoff;
+}
+// --- Re-exports for backwards compatibility ---
+/** @deprecated Use `validate` instead */
+exports.validateAgainstSchema = validate;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/schemas/audit.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://zenkit.dev/schemas/audit.schema.json",
+  "title": "ZenKit Audit Report",
+  "description": "Structured audit output from a ZenKit audit command.",
+  "type": "object",
+  "required": ["task_id", "auditor", "verdict", "findings"],
+  "properties": {
+    "task_id": {
+      "type": "string"
+    },
+    "auditor": {
+      "type": "string",
+      "description": "Agent or role that performed the audit."
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "verdict": {
+      "type": "string",
+      "enum": ["pass", "fail", "conditional", "needs_review"]
+    },
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["category", "severity", "description"],
+        "properties": {
+          "category": {
+            "type": "string",
+            "enum": ["correctness", "security", "performance", "style", "architecture", "testing", "documentation"]
+          },
+          "severity": {
+            "type": "string",
+            "enum": ["info", "warning", "error", "critical"]
+          },
+          "description": { "type": "string" },
+          "file": { "type": "string" },
+          "line": { "type": "integer" },
+          "suggestion": { "type": "string" }
+        }
+      }
+    },
+    "rubric_scores": {
+      "type": "object",
+      "properties": {
+        "execution_quality": { "type": "number", "minimum": 0, "maximum": 10 },
+        "verbosity_score": { "type": "number", "minimum": 0, "maximum": 10 },
+        "architectural_alignment": { "type": "number", "minimum": 0, "maximum": 10 }
+      }
+    },
+    "open_questions": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "recommendations": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "additionalProperties": false
+}

package/dist/schemas/benchmark.schema.json

@@ -0,0 +1,118 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://zenkit.dev/schemas/benchmark.schema.json",
+  "title": "ZenKit Benchmark Result",
+  "description": "Structured output from a ZenKit benchmark run with acceptance criteria verification.",
+  "type": "object",
+  "required": ["benchmark_id", "version", "mode", "task_name", "started_at", "completed_at", "status", "validation_summary", "acceptance_criteria_results"],
+  "properties": {
+    "benchmark_id": { "type": "string" },
+    "version": { "type": "string" },
+    "mode": {
+      "type": "string",
+      "enum": ["zenkit", "baseline"],
+      "description": "Whether this run used ZenKit workflow structure or an unstructured baseline."
+    },
+    "task_name": { "type": "string" },
+    "feature_spec": { "type": "string" },
+    "started_at": { "type": "string", "format": "date-time" },
+    "completed_at": { "type": "string", "format": "date-time" },
+    "duration_ms": { "type": "integer", "minimum": 0 },
+    "status": {
+      "type": "string",
+      "enum": ["pass", "fail", "partial"]
+    },
+    "expected_files": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "files_found": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "files_missing": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "acceptance_criteria_results": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "description", "status", "evidence", "verification_type"],
+        "properties": {
+          "id": { "type": "string" },
+          "description": { "type": "string" },
+          "status": { "type": "string", "enum": ["pass", "fail"] },
+          "evidence": { "type": "string", "description": "What was actually checked and found." },
+          "verification_type": { "type": "string" }
+        }
+      }
+    },
+    "stages": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "status", "checks_run", "checks_passed"],
+        "properties": {
+          "name": { "type": "string" },
+          "status": { "type": "string", "enum": ["pass", "fail", "skipped"] },
+          "duration_ms": { "type": "integer" },
+          "checks_run": { "type": "integer", "minimum": 0 },
+          "checks_passed": { "type": "integer", "minimum": 0 },
+          "details": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "validation_summary": {
+      "type": "object",
+      "required": ["total_criteria", "criteria_passed", "criteria_failed"],
+      "properties": {
+        "total_criteria": { "type": "integer" },
+        "criteria_passed": { "type": "integer" },
+        "criteria_failed": { "type": "integer" },
+        "schemas_valid": { "type": "boolean" },
+        "examples_valid": { "type": "boolean" }
+      }
+    },
+    "telemetry": {
+      "type": "object",
+      "required": ["estimated"],
+      "properties": {
+        "estimated": {
+          "type": "object",
+          "required": ["tokens", "cost_usd", "basis"],
+          "properties": {
+            "tokens": { "type": "integer" },
+            "cost_usd": { "type": "number" },
+            "basis": { "type": "string", "description": "How the estimate was calculated." }
+          }
+        },
+        "actual": {
+          "oneOf": [
+            { "type": "null" },
+            {
+              "type": "object",
+              "required": ["tokens", "cost_usd"],
+              "properties": {
+                "tokens": { "type": "integer" },
+                "cost_usd": { "type": "number" }
+              }
+            }
+          ],
+          "description": "Null when no real telemetry is available. Never fabricated."
+        }
+      }
+    },
+    "uncertainty": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "What this benchmark does NOT prove."
+    },
+    "limitations": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Inherited from the feature spec — scope boundaries of the verification."
+    }
+  },
+  "additionalProperties": false
+}

package/dist/schemas/checkpoint.schema.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://zenkit.dev/schemas/checkpoint.schema.json",
+  "title": "ZenKit Checkpoint",
+  "description": "A snapshot of workflow state at a specific point in execution.",
+  "type": "object",
+  "required": ["checkpoint_id", "task_id", "status", "timestamp"],
+  "properties": {
+    "checkpoint_id": {
+      "type": "string",
+      "pattern": "^chk-[a-z0-9-]+$"
+    },
+    "task_id": {
+      "type": "string"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["snapshot", "gate", "rollback_point"]
+    },
+    "stage": {
+      "type": "string",
+      "enum": ["plan", "build", "audit", "ship"]
+    },
+    "state": {
+      "type": "object",
+      "properties": {
+        "files_changed": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "tests_passing": { "type": "boolean" },
+        "lint_passing": { "type": "boolean" },
+        "git_ref": { "type": "string" },
+        "notes": { "type": "string" }
+      }
+    },
+    "gate_conditions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "condition": { "type": "string" },
+          "met": { "type": "boolean" }
+        },
+        "required": ["condition", "met"]
+      }
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "agent": { "type": "string" },
+        "command": { "type": "string" },
+        "iteration": { "type": "integer" },
+        "tokens_used": { "type": "integer" },
+        "cost_estimate_usd": { "type": "number" }
+      }
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,76 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://zenkit.dev/schemas/feature-spec.schema.json",
+  "title": "ZenKit Feature Spec",
+  "description": "Machine-readable feature specification for ZenKit benchmarks.",
+  "type": "object",
+  "required": ["feature_id", "name", "description", "mode", "acceptance_criteria", "constraints", "expected_files", "limitations"],
+  "properties": {
+    "feature_id": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string"
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["zenkit", "baseline"]
+    },
+    "acceptance_criteria": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "description", "verification"],
+        "properties": {
+          "id": { "type": "string" },
+          "description": { "type": "string" },
+          "verification": {
+            "type": "object",
+            "required": ["type"],
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": ["file_exists", "file_contains", "schema_count", "examples_valid", "schemas_consistent", "test_passes", "json_path_equals"]
+              },
+              "path": { "type": "string" },
+              "pattern": { "type": "string" },
+              "command": { "type": "string", "description": "Shell command to run for test_passes verification." },
+              "json_path": { "type": "string", "description": "Dot-separated path into JSON for json_path_equals." },
+              "equals": { "description": "Expected value for json_path_equals." },
+              "expected": { "type": "integer" }
+            }
+          }
+        }
+      }
+    },
+    "constraints": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "expected_files": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "assigned_commands": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "estimated_complexity": {
+      "type": "string",
+      "enum": ["low", "medium", "high"]
+    },
+    "limitations": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" },
+      "description": "What this spec does NOT verify. Required — specs must be honest about scope."
+    }
+  },
+  "additionalProperties": false
+}

package/dist/schemas/handoff.schema.json

@@ -0,0 +1,78 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://zenkit.dev/schemas/handoff.schema.json",
+  "title": "ZenKit Handoff Contract",
+  "description": "Structured handoff between agents or workflow stages in ZenKit.",
+  "type": "object",
+  "required": ["context", "assumptions", "decision", "deliverable", "next_agent"],
+  "properties": {
+    "context": {
+      "type": "string",
+      "description": "What is the current situation? What has happened so far?"
+    },
+    "assumptions": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Explicit assumptions made during this stage."
+    },
+    "constraints": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Hard constraints that bound this work."
+    },
+    "decision": {
+      "type": "string",
+      "description": "What was decided and why."
+    },
+    "deliverable": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["code", "document", "schema", "plan", "review", "test", "artifact"]
+        },
+        "description": { "type": "string" },
+        "files_changed": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "validation_status": {
+          "type": "string",
+          "enum": ["passed", "failed", "partial", "untested"]
+        }
+      },
+      "required": ["type", "description"]
+    },
+    "risks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "description": { "type": "string" },
+          "severity": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
+          "mitigation": { "type": "string" }
+        },
+        "required": ["description", "severity"]
+      }
+    },
+    "open_questions": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Unresolved questions that the next agent should address."
+    },
+    "next_agent": {
+      "type": "string",
+      "description": "The agent or role that should receive this handoff."
+    },
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "timestamp": { "type": "string", "format": "date-time" },
+        "source_agent": { "type": "string" },
+        "command": { "type": "string" },
+        "iteration": { "type": "integer", "minimum": 0 }
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/dist/schemas/schemas/audit.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://zenkit.dev/schemas/audit.schema.json",
+  "title": "ZenKit Audit Report",
+  "description": "Structured audit output from a ZenKit audit command.",
+  "type": "object",
+  "required": ["task_id", "auditor", "verdict", "findings"],
+  "properties": {
+    "task_id": {
+      "type": "string"
+    },
+    "auditor": {
+      "type": "string",
+      "description": "Agent or role that performed the audit."
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "verdict": {
+      "type": "string",
+      "enum": ["pass", "fail", "conditional", "needs_review"]
+    },
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["category", "severity", "description"],
+        "properties": {
+          "category": {
+            "type": "string",
+            "enum": ["correctness", "security", "performance", "style", "architecture", "testing", "documentation"]
+          },
+          "severity": {
+            "type": "string",
+            "enum": ["info", "warning", "error", "critical"]
+          },
+          "description": { "type": "string" },
+          "file": { "type": "string" },
+          "line": { "type": "integer" },
+          "suggestion": { "type": "string" }
+        }
+      }
+    },
+    "rubric_scores": {
+      "type": "object",
+      "properties": {
+        "execution_quality": { "type": "number", "minimum": 0, "maximum": 10 },
+        "verbosity_score": { "type": "number", "minimum": 0, "maximum": 10 },
+        "architectural_alignment": { "type": "number", "minimum": 0, "maximum": 10 }
+      }
+    },
+    "open_questions": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "recommendations": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "additionalProperties": false
+}