codictator 0.0.0 → 0.1.3

package/schema/cli/status.schema.json

@@ -0,0 +1,51 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://codictator.dev/schema/cli/status.schema.json",
+	"title": "status output",
+	"description": "SPEC §4.18.3: --json rendering of codictator status for the extension.",
+	"type": "object",
+	"properties": {
+		"engineVersion": { "type": "string" },
+		"packs": { "type": "object" },
+		"harnesses": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"properties": {
+					"harness": { "type": "string" },
+					"state": { "enum": ["active", "inactive", "unknown", "unverified"] },
+					"layers": { "type": "string" }
+				},
+				"required": ["harness", "state", "layers"],
+				"additionalProperties": false
+			}
+		},
+		"helpers": {
+			"type": ["array", "null"],
+			"items": {
+				"type": "object",
+				"properties": {
+					"role": { "type": "string" },
+					"present": { "type": "boolean" },
+					"detail": { "type": "string" }
+				},
+				"required": ["role", "present"],
+				"additionalProperties": false
+			}
+		},
+		"events": { "type": "integer", "minimum": 0 },
+		"corrupt": { "type": "integer", "minimum": 0 },
+		"gap": { "type": "boolean" },
+		"now": { "type": "string" }
+	},
+	"required": [
+		"engineVersion",
+		"packs",
+		"harnesses",
+		"events",
+		"corrupt",
+		"gap",
+		"now"
+	],
+	"additionalProperties": true
+}

package/schema/cli/verify.schema.json

@@ -0,0 +1,15 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"$id": "https://codictator.dev/schema/cli/verify.schema.json",
+	"title": "verify output",
+	"description": "SPEC §4.19.2: --json rendering of codictator verify (exit 0 allow, 1 block).",
+	"type": "object",
+	"properties": {
+		"decision": { "enum": ["allow", "block"] },
+		"findings": { "type": "array" },
+		"configHash": { "type": "string" },
+		"note": { "type": "string" }
+	},
+	"required": ["decision", "findings", "configHash", "note"],
+	"additionalProperties": false
+}

package/schema/config.schema.json

@@ -0,0 +1,43 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Codictator config.json (SPEC §7.2)",
+	"type": "object",
+	"required": ["version", "codictator", "packs", "harnesses"],
+	"additionalProperties": false,
+	"properties": {
+		"version": { "const": 1 },
+		"codictator": { "type": "string", "minLength": 1 },
+		"packs": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["id"],
+				"additionalProperties": false,
+				"properties": {
+					"id": { "type": "string", "minLength": 1 },
+					"version": { "type": "string", "minLength": 1 },
+					"path": { "type": "string", "minLength": 1 }
+				}
+			}
+		},
+		"harnesses": {
+			"type": "array",
+			"minItems": 1,
+			"items": { "type": "string", "minLength": 1 }
+		},
+		"tunables": { "type": "object" },
+		"architecture": { "type": "object" },
+		"workflow": { "type": "object" },
+		"spec": { "type": "object" },
+		"testing": { "type": "object" },
+		"commands": { "type": "object" },
+		"steering": { "type": "object" },
+		"tools": { "type": "array", "items": { "type": "object" } },
+		"security": { "type": "object" },
+		"deps": { "type": "object" },
+		"network": { "type": "object" },
+		"integrity": { "type": "object" },
+		"ci": { "type": "object" },
+		"llm": { "type": "object" }
+	}
+}

package/schema/event-log.schema.json

@@ -0,0 +1,52 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Codictator event log line (SPEC §7.10)",
+	"type": "object",
+	"required": [
+		"v",
+		"id",
+		"ts",
+		"now",
+		"kind",
+		"layer",
+		"trigger",
+		"ruleIds",
+		"durationMs",
+		"configHash",
+		"packs"
+	],
+	"additionalProperties": false,
+	"properties": {
+		"v": { "const": 1 },
+		"id": { "type": "string", "minLength": 1 },
+		"ts": { "type": "string", "minLength": 1 },
+		"now": { "type": "string", "minLength": 1 },
+		"kind": {
+			"enum": [
+				"verdict",
+				"injection",
+				"escalation",
+				"waiver",
+				"upgrade",
+				"integrity",
+				"tool",
+				"install",
+				"remediation",
+				"review",
+				"session",
+				"llm"
+			]
+		},
+		"layer": { "type": "string", "minLength": 1 },
+		"trigger": { "type": "string", "minLength": 1 },
+		"harness": { "type": "string" },
+		"sessionId": { "type": "string" },
+		"taskId": { "type": "string" },
+		"ruleIds": { "type": "array", "items": { "type": "string" } },
+		"decision": { "enum": ["allow", "advise", "block", "escalate"] },
+		"durationMs": { "type": "number", "minimum": 0 },
+		"configHash": { "type": "string", "minLength": 1 },
+		"packs": { "type": "object", "additionalProperties": { "type": "string" } },
+		"message": { "type": "string" }
+	}
+}

package/schema/hook-decision.schema.json

@@ -0,0 +1,13 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Codictator HookDecision (SPEC §7.8)",
+	"type": "object",
+	"required": ["decision", "eventId"],
+	"additionalProperties": false,
+	"properties": {
+		"decision": { "enum": ["allow", "advise", "block", "escalate"] },
+		"message": { "type": "string" },
+		"additionalContext": { "type": "string" },
+		"eventId": { "type": "string", "minLength": 1 }
+	}
+}

package/schema/hook-event.schema.json

@@ -0,0 +1,50 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Codictator HookEvent (SPEC §7.8)",
+	"type": "object",
+	"required": ["harness", "event", "trigger", "sessionId", "cwd"],
+	"additionalProperties": false,
+	"properties": {
+		"harness": { "type": "string", "minLength": 1 },
+		"event": { "type": "string", "minLength": 1 },
+		"trigger": { "type": "string", "minLength": 1 },
+		"sessionId": { "type": "string", "minLength": 1 },
+		"agentId": { "type": "string" },
+		"role": { "type": "string" },
+		"cwd": { "type": "string", "minLength": 1 },
+		"source": { "enum": ["startup", "resume", "clear", "compact"] },
+		"tool": {
+			"type": "object",
+			"required": ["kind", "name", "paths"],
+			"additionalProperties": false,
+			"properties": {
+				"kind": { "type": "string", "minLength": 1 },
+				"name": { "type": "string", "minLength": 1 },
+				"paths": { "type": "array", "items": { "type": "string" } },
+				"command": { "type": "string" },
+				"proposedContent": { "type": "string" },
+				"range": {
+					"type": "object",
+					"required": ["offset", "limit"],
+					"additionalProperties": false,
+					"properties": {
+						"offset": { "type": "integer", "minimum": 0 },
+						"limit": { "type": "integer", "minimum": 0 }
+					}
+				},
+				"query": { "type": "string" }
+			}
+		},
+		"usage": {
+			"type": "object",
+			"required": ["contextTokens", "contextWindow"],
+			"additionalProperties": false,
+			"properties": {
+				"contextTokens": { "type": "integer", "minimum": 0 },
+				"contextWindow": { "type": "integer", "minimum": 1 }
+			}
+		},
+		"transcriptPath": { "type": "string" },
+		"modelProvider": { "type": "string" }
+	}
+}

package/schema/manifest.schema.json

@@ -0,0 +1,26 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Codictator guardrail manifest (SPEC §7.14)",
+	"type": "object",
+	"required": ["version", "codictator", "artifacts", "hash"],
+	"additionalProperties": false,
+	"properties": {
+		"version": { "const": 1 },
+		"codictator": { "type": "string", "minLength": 1 },
+		"artifacts": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["path", "owner", "mode", "hash"],
+				"additionalProperties": false,
+				"properties": {
+					"path": { "type": "string", "minLength": 1 },
+					"owner": { "type": "string", "minLength": 1 },
+					"mode": { "enum": ["file", "block", "entries"] },
+					"hash": { "type": "string", "minLength": 1 }
+				}
+			}
+		},
+		"hash": { "type": "string", "minLength": 1 }
+	}
+}

package/schema/pack-draft.schema.json

@@ -0,0 +1,42 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Codictator pack draft (SPEC §4.16.3)",
+	"description": "LLM draft for the generator flow: rules expressed only as template ids and parameters, plus fixtures. The generator validates the draft against this shape, runs one repair round, then materialises it.",
+	"type": "object",
+	"required": ["packId", "description", "rules"],
+	"additionalProperties": false,
+	"properties": {
+		"packId": { "type": "string", "minLength": 1 },
+		"description": { "type": "string", "minLength": 1 },
+		"rules": {
+			"type": "array",
+			"minItems": 1,
+			"items": {
+				"type": "object",
+				"required": [
+					"id",
+					"template",
+					"params",
+					"statement",
+					"reason",
+					"remediation",
+					"tier",
+					"violatingFixture",
+					"passingFixture"
+				],
+				"additionalProperties": false,
+				"properties": {
+					"id": { "type": "string", "minLength": 1 },
+					"template": { "type": "string", "minLength": 1 },
+					"params": { "type": "object" },
+					"statement": { "type": "string", "minLength": 1 },
+					"reason": { "type": "string", "minLength": 1 },
+					"remediation": { "type": "string", "minLength": 1 },
+					"tier": { "type": "string", "enum": ["floor", "tunable"] },
+					"violatingFixture": { "type": "string", "minLength": 1 },
+					"passingFixture": { "type": "string", "minLength": 1 }
+				}
+			}
+		}
+	}
+}

package/schema/pack.schema.json

@@ -0,0 +1,70 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Codictator pack.json (SPEC §7.3)",
+	"type": "object",
+	"required": [
+		"id",
+		"version",
+		"description",
+		"rules",
+		"enforcers",
+		"maxWaiverDays"
+	],
+	"additionalProperties": false,
+	"properties": {
+		"id": { "type": "string", "minLength": 1 },
+		"version": { "type": "string", "minLength": 1 },
+		"description": { "type": "string", "minLength": 1 },
+		"rules": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": [
+					"id",
+					"family",
+					"tier",
+					"statement",
+					"reason",
+					"remediation",
+					"enforcer",
+					"triggers",
+					"scope",
+					"params",
+					"measureVersion",
+					"fixtures"
+				],
+				"additionalProperties": false,
+				"properties": {
+					"id": { "type": "string", "minLength": 1 },
+					"family": { "type": "string", "minLength": 1 },
+					"tier": { "type": "string", "minLength": 1 },
+					"statement": { "type": "string", "minLength": 1 },
+					"reason": { "type": "string", "minLength": 1 },
+					"remediation": { "type": "string", "minLength": 1 },
+					"enforcer": { "type": "string", "minLength": 1 },
+					"triggers": { "type": "array", "items": { "type": "string" } },
+					"scope": { "type": "array", "items": { "type": "string" } },
+					"params": { "type": "object" },
+					"ratchet": {},
+					"measureVersion": { "type": "integer", "minimum": 1 },
+					"fixtures": {
+						"type": "object",
+						"required": ["violating", "passing"],
+						"additionalProperties": false,
+						"properties": {
+							"violating": { "type": "array", "items": { "type": "string" } },
+							"passing": { "type": "array", "items": { "type": "string" } }
+						}
+					}
+				}
+			}
+		},
+		"enforcers": { "type": "array", "items": { "type": "object" } },
+		"drivers": { "type": "array", "items": { "type": "object" } },
+		"extractors": { "type": "array", "items": { "type": "object" } },
+		"measures": { "type": "array", "items": { "type": "object" } },
+		"capabilities": { "type": "array", "items": { "type": "object" } },
+		"assets": { "type": "array", "items": { "type": "object" } },
+		"maxWaiverDays": { "type": "integer", "minimum": 1 }
+	}
+}

package/schema/registry-snapshot.schema.json

@@ -0,0 +1,41 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Codictator registry snapshot (SPEC §7.12)",
+	"type": "object",
+	"required": ["version", "ecosystem", "fetchedAt", "packages", "advisories"],
+	"additionalProperties": false,
+	"properties": {
+		"version": { "const": 1 },
+		"ecosystem": { "type": "string", "minLength": 1 },
+		"fetchedAt": { "type": "string", "minLength": 1 },
+		"packages": {
+			"type": "object",
+			"additionalProperties": {
+				"type": "object",
+				"required": ["versions"],
+				"additionalProperties": false,
+				"properties": {
+					"versions": {
+						"type": "object",
+						"additionalProperties": {
+							"type": "object",
+							"required": ["published"],
+							"additionalProperties": false,
+							"properties": {
+								"published": { "type": "string", "minLength": 1 },
+								"deprecated": { "type": "boolean" },
+								"yanked": { "type": "boolean" },
+								"license": { "type": "string" },
+								"engines": { "type": "object" }
+							}
+						}
+					}
+				}
+			}
+		},
+		"advisories": {
+			"type": "object",
+			"additionalProperties": { "type": "array", "items": { "type": "string" } }
+		}
+	}
+}

package/schema/remediation-plan.schema.json

@@ -0,0 +1,44 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Codictator remediation plan (SPEC §7.13)",
+	"type": "object",
+	"required": ["version", "generatedFrom", "steps"],
+	"additionalProperties": false,
+	"properties": {
+		"version": { "const": 1 },
+		"generatedFrom": {
+			"type": "object",
+			"required": ["head", "baselineHash"],
+			"additionalProperties": false,
+			"properties": {
+				"head": { "type": "string", "minLength": 1 },
+				"baselineHash": { "type": "string", "minLength": 1 }
+			}
+		},
+		"steps": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": [
+					"id",
+					"kind",
+					"scope",
+					"executor",
+					"dependsOn",
+					"status",
+					"attempts"
+				],
+				"additionalProperties": false,
+				"properties": {
+					"id": { "type": "string", "minLength": 1 },
+					"kind": { "type": "string", "minLength": 1 },
+					"scope": { "type": "array", "items": { "type": "string" } },
+					"executor": { "type": "string", "minLength": 1 },
+					"dependsOn": { "type": "array", "items": { "type": "string" } },
+					"status": { "type": "string", "minLength": 1 },
+					"attempts": { "type": "integer", "minimum": 0 }
+				}
+			}
+		}
+	}
+}

package/schema/review-findings.schema.json

@@ -0,0 +1,25 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Codictator review findings file (SPEC §7.16)",
+	"type": "object",
+	"required": ["version", "findings"],
+	"additionalProperties": false,
+	"properties": {
+		"version": { "const": 1 },
+		"findings": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["id", "severity", "path", "message"],
+				"additionalProperties": false,
+				"properties": {
+					"id": { "type": "string", "minLength": 1 },
+					"severity": { "type": "string", "minLength": 1 },
+					"path": { "type": "string", "minLength": 1 },
+					"line": { "type": "integer", "minimum": 1 },
+					"message": { "type": "string", "minLength": 1 }
+				}
+			}
+		}
+	}
+}

package/schema/task-record.schema.json

@@ -0,0 +1,49 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Codictator task record (SPEC §7.11)",
+	"type": "object",
+	"required": [
+		"version",
+		"id",
+		"type",
+		"title",
+		"branch",
+		"phase",
+		"phases",
+		"spec",
+		"acceptanceCriteria",
+		"files"
+	],
+	"additionalProperties": false,
+	"properties": {
+		"version": { "const": 1 },
+		"id": { "type": "string", "minLength": 1 },
+		"type": { "type": "string", "minLength": 1 },
+		"title": { "type": "string", "minLength": 1 },
+		"branch": { "type": "string", "minLength": 1 },
+		"phase": { "type": "string", "minLength": 1 },
+		"phases": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["name", "enteredAt", "evidence"],
+				"additionalProperties": false,
+				"properties": {
+					"name": { "type": "string", "minLength": 1 },
+					"enteredAt": { "type": "string", "minLength": 1 },
+					"evidence": { "type": "string" }
+				}
+			}
+		},
+		"spec": { "type": "array", "items": { "type": "string" } },
+		"acceptanceCriteria": { "type": "array", "items": { "type": "string" } },
+		"files": {
+			"type": "object",
+			"required": ["allow"],
+			"additionalProperties": false,
+			"properties": {
+				"allow": { "type": "array", "items": { "type": "string" } }
+			}
+		}
+	}
+}

package/schema/waivers.schema.json

@@ -0,0 +1,29 @@
+{
+	"$schema": "https://json-schema.org/draft/2020-12/schema",
+	"title": "Codictator waivers.json (SPEC §7.5)",
+	"type": "object",
+	"required": ["version", "waivers"],
+	"additionalProperties": false,
+	"properties": {
+		"version": { "const": 1 },
+		"waivers": {
+			"type": "array",
+			"items": {
+				"type": "object",
+				"required": ["id", "rule", "reason", "created", "expires", "createdBy"],
+				"additionalProperties": false,
+				"properties": {
+					"id": { "type": "string", "pattern": "^W-[0-9]{4}$" },
+					"rule": { "type": "string", "minLength": 1 },
+					"params": { "type": "object" },
+					"paths": { "type": "array", "items": { "type": "string" } },
+					"reason": { "type": "string", "minLength": 1 },
+					"created": { "type": "string", "minLength": 1 },
+					"expires": { "type": "string", "minLength": 1 },
+					"createdBy": { "type": "string", "minLength": 1 },
+					"renews": { "type": "string", "minLength": 1 }
+				}
+			}
+		}
+	}
+}