@claudexor/schema 2.1.3 → 3.0.0

package/dist/spec.js

@@ -1,186 +0,0 @@
-import { z } from "zod";
-import { Id, IsoTimestamp, SchemaVersion } from "./primitives.js";
-import { TestCommand } from "./task.js";
-/**
- * SpecPack — the frozen, versioned, diffable specification produced by the
- * spec interview (the hierarchical clarify-quiz). It is the SSOT a run is held
- * to: a SpecPack maps deterministically into a TaskContract. Unlike spec-first
- * tools that regenerate an opaque blob, this is spec-anchored: versioned with
- * section-level diffs across revisions.
- */
-export const InterviewQuestionKind = z
-    .enum(["single", "multi", "text"])
-    .describe("Answer shape of an interview question: single choice, multiple choice, or free text.");
-export const InterviewOption = z
-    .object({
-    id: Id.describe("Option id."),
-    label: z.string().describe("Human-readable option label."),
-})
-    .describe("One selectable option of an interview question.");
-/** One quiz card. `tier` expresses the hierarchical depth (0 = foundational). */
-export const InterviewQuestion = z
-    .object({
-    id: Id.describe("Question id."),
-    tier: z
-        .number()
-        .int()
-        .nonnegative()
-        .default(0)
-        .describe("Hierarchical depth of the question (0 = foundational)."),
-    prompt: z.string().describe("The question text shown to the user."),
-    kind: InterviewQuestionKind.default("single"),
-    options: z
-        .array(InterviewOption)
-        .default([])
-        .describe("Selectable options; empty for pure free-text questions."),
-    /** Whether free-text is accepted in addition to / instead of options. */
-    allow_text: z
-        .boolean()
-        .default(false)
-        .describe("Whether free-text is accepted in addition to or instead of options."),
-    rationale: z.string().optional().describe("Why this question matters for the spec."),
-})
-    .describe("One quiz card of the spec interview.");
-export const InterviewAnswer = z
-    .object({
-    question_id: Id.describe("Id of the question being answered."),
-    option_ids: z.array(Id).default([]).describe("Ids of the selected options."),
-    text: z
-        .string()
-        .nullable()
-        .default(null)
-        .describe("Free-text answer; null when only options were selected."),
-})
-    .describe("The user's answer to one interview question.");
-/**
- * An explicit unresolved ambiguity (NEEDS_CLARIFICATION). The interview refuses
- * to freeze while any of these are `open` — nothing is silently guessed.
- */
-export const ClarificationItem = z
-    .object({
-    id: Id.describe("Clarification id."),
-    claim: z.string().describe("The ambiguous claim or open question that needs resolution."),
-    status: z
-        .enum(["open", "resolved"])
-        .default("open")
-        .describe("Whether the ambiguity is still open or has been resolved."),
-    resolution: z
-        .string()
-        .nullable()
-        .default(null)
-        .describe("How the ambiguity was resolved; null while open."),
-})
-    .describe("An explicit unresolved ambiguity (NEEDS_CLARIFICATION); the interview refuses to freeze while any is open.");
-/** Acceptance criterion in EARS style ("WHEN <cond>, THE SYSTEM SHALL <behavior>"). */
-export const SpecAcceptanceCriterion = z
-    .object({
-    id: Id.describe("Criterion id."),
-    behavior: z
-        .string()
-        .describe("Required behavior, EARS style (WHEN <condition>, THE SYSTEM SHALL <behavior>)."),
-    required: z
-        .boolean()
-        .default(true)
-        .describe("Whether this criterion is required (vs advisory)."),
-})
-    .describe("Acceptance criterion in EARS style.");
-/** A dependency-ordered task in the implementation checklist. */
-export const SpecTask = z
-    .object({
-    id: Id.describe("Task id."),
-    title: z.string().describe("Human-readable task title."),
-    depends_on: z.array(Id).default([]).describe("Ids of tasks that must complete first."),
-    done: z.boolean().default(false).describe("Whether the task has been completed."),
-})
-    .describe("A dependency-ordered task in the implementation checklist.");
-export const SpecConstraints = z
-    .object({
-    /** Spec-owned protected paths can raise review risk; per-run approvals cannot be frozen into a spec. */
-    protected_paths: z
-        .array(z.string())
-        .default([])
-        .describe("Spec-owned protected path globs that raise review risk; per-run approvals cannot be frozen into a spec."),
-})
-    .strict()
-    .describe("Constraints frozen into the spec.");
-const SpecPackBase = z.object({
-    schema_version: SchemaVersion,
-    id: Id.describe("SpecPack id."),
-    created_at: IsoTimestamp.describe("When this SpecPack revision was created."),
-    /** Monotonic revision; each freeze increments it (spec-anchored history). */
-    version: z
-        .number()
-        .int()
-        .positive()
-        .default(1)
-        .describe("Monotonic revision; each freeze increments it."),
-    frozen: z
-        .boolean()
-        .default(false)
-        .describe("Whether the spec is frozen (immutable and runnable)."),
-    intent: z
-        .object({
-        raw: z.string().describe("The user's original request, verbatim."),
-        normalized: z.string().optional().describe("Optional normalized restatement of the request."),
-    })
-        .describe("The user intent this spec captures."),
-    summary: z.string().default("").describe("Short human-readable summary of the spec."),
-    success_criteria: z
-        .array(SpecAcceptanceCriterion)
-        .default([])
-        .describe("Acceptance criteria the implementation is held to."),
-    non_goals: z.array(z.string()).default([]).describe("Explicitly out-of-scope outcomes."),
-    forbidden_approaches: z
-        .array(z.string())
-        .default([])
-        .describe("Approaches the implementation must not take."),
-    decided_tradeoffs: z
-        .array(z.string())
-        .default([])
-        .describe("Tradeoffs already decided during the interview."),
-    constraints: SpecConstraints.default({}),
-    tests: z
-        .array(TestCommand)
-        .default([])
-        .describe("Deterministic test commands frozen into the spec."),
-    tasks: z.array(SpecTask).default([]).describe("Dependency-ordered implementation checklist."),
-    open_questions: z
-        .array(ClarificationItem)
-        .default([])
-        .describe("Unresolved ambiguities; must all be resolved before freezing."),
-    interview: z
-        .object({
-        questions: z
-            .array(InterviewQuestion)
-            .default([])
-            .describe("Questions asked during the interview."),
-        answers: z.array(InterviewAnswer).default([]).describe("The user's answers."),
-    })
-        .default({ questions: [], answers: [] })
-        .describe("The clarify-quiz transcript this spec was built from."),
-});
-/**
- * Schema-level invariants (SSOT, enforced on every parse — even when loaded from
- * disk, not just via the engine): a frozen spec cannot carry open clarifications,
- * and a "resolved" clarification must record a non-empty resolution. This makes a
- * frozen-but-ambiguous SpecPack unrepresentable — no silent guessing.
- */
-export const SpecPack = SpecPackBase.superRefine((data, ctx) => {
-    if (data.frozen && data.open_questions.some((q) => q.status === "open")) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            path: ["open_questions"],
-            message: "a frozen SpecPack cannot have open clarifications",
-        });
-    }
-    data.open_questions.forEach((q, i) => {
-        if (q.status === "resolved" && (q.resolution === null || q.resolution.trim() === "")) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                path: ["open_questions", i, "resolution"],
-                message: "a resolved clarification must have a non-empty resolution",
-            });
-        }
-    });
-}).describe("The frozen, versioned, diffable specification produced by the spec interview; the SSOT a run is held to, mapping deterministically into a TaskContract.");
-//# sourceMappingURL=spec.js.map

package/dist/spec.js.map

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

package/generated/ControlSpecAnswersRequest.schema.json

@@ -1,74 +0,0 @@
-{
-  "$ref": "#/definitions/ControlSpecAnswersRequest",
-  "definitions": {
-    "ControlSpecAnswersRequest": {
-      "type": "object",
-      "properties": {
-        "answers": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "question_id": {
-                "type": "string",
-                "minLength": 1,
-                "description": "Id of the question being answered."
-              },
-              "option_ids": {
-                "type": "array",
-                "items": {
-                  "type": "string",
-                  "minLength": 1,
-                  "description": "Non-empty identifier string."
-                },
-                "default": [],
-                "description": "Ids of the selected options."
-              },
-              "text": {
-                "type": [
-                  "string",
-                  "null"
-                ],
-                "default": null,
-                "description": "Free-text answer; null when only options were selected."
-              }
-            },
-            "required": [
-              "question_id"
-            ],
-            "additionalProperties": false,
-            "description": "The user's answer to one interview question."
-          },
-          "description": "Answers for the current interview tier."
-        },
-        "priorDecisions": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "question": {
-                "type": "string",
-                "description": "Question asked in a prior tier."
-              },
-              "answer": {
-                "type": "string",
-                "description": "The user's answer."
-              }
-            },
-            "required": [
-              "question",
-              "answer"
-            ],
-            "additionalProperties": false
-          }
-        }
-      },
-      "required": [
-        "answers"
-      ],
-      "additionalProperties": false,
-      "description": "Answers recorded against a durable spec session."
-    }
-  },
-  "$schema": "http://json-schema.org/draft-07/schema#"
-}

package/generated/ControlSpecQuestionsRequest.schema.json

@@ -1,209 +0,0 @@
-{
-  "$ref": "#/definitions/ControlSpecQuestionsRequest",
-  "definitions": {
-    "ControlSpecQuestionsRequest": {
-      "type": "object",
-      "properties": {
-        "prompt": {
-          "type": "string",
-          "minLength": 1,
-          "description": "The user's request the interview is clarifying."
-        },
-        "threadId": {
-          "type": "string",
-          "minLength": 1,
-          "pattern": "\\S",
-          "description": "Owning chat thread, when created from the app."
-        },
-        "scope": {
-          "type": "object",
-          "properties": {
-            "kind": {
-              "type": "string",
-              "const": "project"
-            },
-            "root": {
-              "type": "string",
-              "description": "Absolute path of the project root."
-            },
-            "context": {
-              "type": "string",
-              "enum": [
-                "auto"
-              ],
-              "description": "Project context depth; auto is the only mode.",
-              "default": "auto"
-            }
-          },
-          "required": [
-            "kind",
-            "root"
-          ],
-          "additionalProperties": false,
-          "description": "Project the spec is about."
-        },
-        "harnesses": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/ControlSpecQuestionsRequest/properties/threadId"
-          },
-          "description": "Harnesses eligible to generate the questions."
-        },
-        "n": {
-          "type": "integer",
-          "exclusiveMinimum": 0
-        },
-        "effort": {
-          "type": "string",
-          "enum": [
-            "low",
-            "medium",
-            "high",
-            "xhigh",
-            "max"
-          ],
-          "description": "Cross-harness reasoning-effort level, weakest to strongest; adapters declare the subset they support and a shared normalizer clamps requests onto the nearest supported level."
-        },
-        "paidBudget": {
-          "anyOf": [
-            {
-              "type": "object",
-              "properties": {
-                "kind": {
-                  "type": "string",
-                  "const": "unlimited"
-                }
-              },
-              "required": [
-                "kind"
-              ],
-              "additionalProperties": false
-            },
-            {
-              "type": "object",
-              "properties": {
-                "kind": {
-                  "type": "string",
-                  "const": "finite"
-                },
-                "maxUsd": {
-                  "type": "number",
-                  "minimum": 0
-                }
-              },
-              "required": [
-                "kind",
-                "maxUsd"
-              ],
-              "additionalProperties": false
-            }
-          ],
-          "description": "Incremental-cash budget: explicitly unlimited or a finite non-negative USD cap."
-        },
-        "web": {
-          "type": "string",
-          "enum": [
-            "off",
-            "auto",
-            "cached",
-            "live"
-          ],
-          "description": "External web/context policy for a run: off (no external context), auto (engine decides), cached (cached sources only), live (live web access). Separate from process/network sandboxing."
-        },
-        "reviewerModels": {
-          "type": "object",
-          "additionalProperties": {
-            "$ref": "#/definitions/ControlSpecQuestionsRequest/properties/threadId"
-          },
-          "propertyNames": {
-            "enum": [
-              "openai",
-              "anthropic",
-              "google",
-              "cursor",
-              "opencode",
-              "xai",
-              "local",
-              "unknown"
-            ]
-          }
-        },
-        "reviewerEfforts": {
-          "type": "object",
-          "additionalProperties": {
-            "$ref": "#/definitions/ControlSpecQuestionsRequest/properties/effort"
-          },
-          "propertyNames": {
-            "enum": [
-              "openai",
-              "anthropic",
-              "google",
-              "cursor",
-              "opencode",
-              "xai",
-              "local",
-              "unknown"
-            ]
-          }
-        },
-        "reviewerPanel": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "harness": {
-                "type": "string",
-                "minLength": 1,
-                "pattern": "\\S",
-                "description": "Explicit reviewer harness id; repeated harness ids are allowed so one provider can review through multiple requested models."
-              },
-              "model": {
-                "$ref": "#/definitions/ControlSpecQuestionsRequest/properties/threadId",
-                "description": "Per-reviewer model hint, passed to that harness only."
-              },
-              "effort": {
-                "$ref": "#/definitions/ControlSpecQuestionsRequest/properties/effort",
-                "description": "Per-reviewer effort hint, passed to that harness only."
-              }
-            },
-            "required": [
-              "harness"
-            ],
-            "additionalProperties": false,
-            "description": "One reviewer of an explicit reviewer panel."
-          },
-          "minItems": 1
-        },
-        "priorDecisions": {
-          "type": "array",
-          "items": {
-            "type": "object",
-            "properties": {
-              "question": {
-                "type": "string",
-                "description": "Question asked in a prior tier."
-              },
-              "answer": {
-                "type": "string",
-                "description": "The user's answer."
-              }
-            },
-            "required": [
-              "question",
-              "answer"
-            ],
-            "additionalProperties": false
-          },
-          "description": "Prior-tier decisions carried into the next interview tier."
-        }
-      },
-      "required": [
-        "prompt",
-        "scope"
-      ],
-      "additionalProperties": false,
-      "description": "Request to create a durable spec interview session."
-    }
-  },
-  "$schema": "http://json-schema.org/draft-07/schema#"
-}