@popoverai/dotrequirements 0.25.0 → 0.26.1

package/dist/codebase-to-spec/schemas.d.ts

@@ -1,12 +1,10 @@
 /**
- * JSON schemas for outline + reviewer output.
- *
- * The CLI passes these to `claude -p --json-schema` to constrain agent output,
- * then validates the parsed result before driving the loop.
+ * Schemas for the codebase-to-spec outline and the conversational
+ * orchestrator's review / partial-result shapes. Workers validate their JSON
+ * output against these before returning it to the workflow.
  *
  * Requirements covered:
  * - CTS-PLAN-1: outline structure
- * - CTS-PLAN-2: outline reviewer output structure (categorized findings + verdict)
  */
 import { z } from "zod";
 export declare const CustomerSchema: z.ZodObject<{
@@ -135,208 +133,6 @@ export declare const OutlineSchema: z.ZodObject<{
     }[];
 }>;
 export type Outline = z.infer<typeof OutlineSchema>;
-/**
- * JSON Schema for the outline, passed to `claude -p --json-schema`.
- * Mirrors OutlineSchema in JSON Schema form (which `claude -p` accepts).
- */
-export declare const OUTLINE_JSON_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly title: {
-            readonly type: "string";
-        };
-        readonly defaultPrefix: {
-            readonly type: "string";
-        };
-        readonly summary: {
-            readonly type: "string";
-        };
-        readonly areas: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "object";
-                readonly properties: {
-                    readonly name: {
-                        readonly type: "string";
-                    };
-                    readonly description: {
-                        readonly type: "string";
-                    };
-                    readonly prefix: {
-                        readonly type: "string";
-                    };
-                    readonly files: {
-                        readonly type: "array";
-                        readonly items: {
-                            readonly type: "string";
-                        };
-                    };
-                    readonly customers: {
-                        readonly type: "array";
-                        readonly minItems: 1;
-                        readonly items: {
-                            readonly type: "object";
-                            readonly properties: {
-                                readonly name: {
-                                    readonly type: "string";
-                                };
-                                readonly description: {
-                                    readonly type: "string";
-                                };
-                            };
-                            readonly required: readonly ["name", "description"];
-                            readonly additionalProperties: false;
-                        };
-                    };
-                };
-                readonly required: readonly ["name", "description", "prefix", "files", "customers"];
-                readonly additionalProperties: false;
-            };
-        };
-    };
-    readonly required: readonly ["title", "defaultPrefix", "summary", "areas"];
-    readonly additionalProperties: false;
-};
-export declare const VerdictValues: readonly ["approved", "approved-with-revisions", "requires-another-review"];
-export type Verdict = (typeof VerdictValues)[number];
-export declare const OutlineReviewSchema: z.ZodObject<{
-    coverage_gaps: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    framing_errors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    granularity_issues: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    file_assignment_issues: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    revisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    verdict: z.ZodEnum<["approved", "approved-with-revisions", "requires-another-review"]>;
-}, "strip", z.ZodTypeAny, {
-    coverage_gaps: string[];
-    framing_errors: string[];
-    granularity_issues: string[];
-    file_assignment_issues: string[];
-    revisions: string[];
-    verdict: "approved" | "approved-with-revisions" | "requires-another-review";
-}, {
-    verdict: "approved" | "approved-with-revisions" | "requires-another-review";
-    coverage_gaps?: string[] | undefined;
-    framing_errors?: string[] | undefined;
-    granularity_issues?: string[] | undefined;
-    file_assignment_issues?: string[] | undefined;
-    revisions?: string[] | undefined;
-}>;
-export type OutlineReview = z.infer<typeof OutlineReviewSchema>;
-export declare const OUTLINE_REVIEW_JSON_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly coverage_gaps: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly framing_errors: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly granularity_issues: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly file_assignment_issues: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly revisions: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly verdict: {
-            readonly type: "string";
-            readonly enum: readonly string[];
-        };
-    };
-    readonly required: readonly ["coverage_gaps", "framing_errors", "granularity_issues", "file_assignment_issues", "revisions", "verdict"];
-    readonly additionalProperties: false;
-};
-/**
- * Try to parse a string as JSON and validate against the outline schema.
- * Throws with a descriptive message on failure (caller catches and either
- * retries or fails the loop).
- */
-export declare function parseOutline(text: string): Outline;
-/**
- * Parse a reviewer's JSON output and validate against the outline-review schema.
- */
-export declare function parseOutlineReview(text: string): OutlineReview;
-export declare const SpecReviewSchema: z.ZodObject<{
-    coverage_gaps: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    framing_errors: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    cross_area_issues: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    internal_mechanics_drift: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    revisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    verdict: z.ZodEnum<["approved", "approved-with-revisions", "requires-another-review"]>;
-}, "strip", z.ZodTypeAny, {
-    coverage_gaps: string[];
-    framing_errors: string[];
-    revisions: string[];
-    verdict: "approved" | "approved-with-revisions" | "requires-another-review";
-    cross_area_issues: string[];
-    internal_mechanics_drift: string[];
-}, {
-    verdict: "approved" | "approved-with-revisions" | "requires-another-review";
-    coverage_gaps?: string[] | undefined;
-    framing_errors?: string[] | undefined;
-    revisions?: string[] | undefined;
-    cross_area_issues?: string[] | undefined;
-    internal_mechanics_drift?: string[] | undefined;
-}>;
-export type SpecReview = z.infer<typeof SpecReviewSchema>;
-export declare const SPEC_REVIEW_JSON_SCHEMA: {
-    readonly type: "object";
-    readonly properties: {
-        readonly coverage_gaps: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly framing_errors: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly cross_area_issues: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly internal_mechanics_drift: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly revisions: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly verdict: {
-            readonly type: "string";
-            readonly enum: readonly string[];
-        };
-    };
-    readonly required: readonly ["coverage_gaps", "framing_errors", "cross_area_issues", "internal_mechanics_drift", "revisions", "verdict"];
-    readonly additionalProperties: false;
-};
 export declare const ConversationalCustomerSchema: z.ZodObject<{
     description: z.ZodString;
 }, "strip", z.ZodTypeAny, {
@@ -363,11 +159,11 @@ export declare const ConversationalReviewEntrySchema: z.ZodDiscriminatedUnion<"r
     result: z.ZodLiteral<"needs-revision">;
     revisions: z.ZodArray<z.ZodString, "many">;
 }, "strip", z.ZodTypeAny, {
-    revisions: string[];
     result: "needs-revision";
-}, {
     revisions: string[];
+}, {
     result: "needs-revision";
+    revisions: string[];
 }>]>;
 export type ConversationalReviewEntry = z.infer<typeof ConversationalReviewEntrySchema>;
 /**
@@ -387,27 +183,27 @@ export declare const ConversationalReviewSchema: z.ZodObject<{
         result: z.ZodLiteral<"needs-revision">;
         revisions: z.ZodArray<z.ZodString, "many">;
     }, "strip", z.ZodTypeAny, {
-        revisions: string[];
         result: "needs-revision";
-    }, {
         revisions: string[];
+    }, {
         result: "needs-revision";
+        revisions: string[];
     }>]>, "many">;
 }, "strip", z.ZodTypeAny, {
     result: "approved" | "needs-revision";
     thread: ({
         result: "approved";
     } | {
-        revisions: string[];
         result: "needs-revision";
+        revisions: string[];
     })[];
 }, {
     result: "approved" | "needs-revision";
     thread: ({
         result: "approved";
     } | {
-        revisions: string[];
         result: "needs-revision";
+        revisions: string[];
     })[];
 }>;
 export type ConversationalReview = z.infer<typeof ConversationalReviewSchema>;
@@ -442,27 +238,27 @@ export declare const ConversationalAreaSchema: z.ZodObject<{
             result: z.ZodLiteral<"needs-revision">;
             revisions: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            revisions: string[];
             result: "needs-revision";
-        }, {
             revisions: string[];
+        }, {
             result: "needs-revision";
+            revisions: string[];
         }>]>, "many">;
     }, "strip", z.ZodTypeAny, {
         result: "approved" | "needs-revision";
         thread: ({
             result: "approved";
         } | {
-            revisions: string[];
             result: "needs-revision";
+            revisions: string[];
         })[];
     }, {
         result: "approved" | "needs-revision";
         thread: ({
             result: "approved";
         } | {
-            revisions: string[];
             result: "needs-revision";
+            revisions: string[];
         })[];
     }>>;
 }, "strip", z.ZodTypeAny, {
@@ -478,8 +274,8 @@ export declare const ConversationalAreaSchema: z.ZodObject<{
         thread: ({
             result: "approved";
         } | {
-            revisions: string[];
             result: "needs-revision";
+            revisions: string[];
         })[];
     } | undefined;
 }, {
@@ -495,8 +291,8 @@ export declare const ConversationalAreaSchema: z.ZodObject<{
         thread: ({
             result: "approved";
         } | {
-            revisions: string[];
             result: "needs-revision";
+            revisions: string[];
         })[];
     } | undefined;
 }>;
@@ -522,27 +318,27 @@ export declare const ConversationalOutlineSchema: z.ZodObject<{
             result: z.ZodLiteral<"needs-revision">;
             revisions: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            revisions: string[];
             result: "needs-revision";
-        }, {
             revisions: string[];
+        }, {
             result: "needs-revision";
+            revisions: string[];
         }>]>, "many">;
     }, "strip", z.ZodTypeAny, {
         result: "approved" | "needs-revision";
         thread: ({
             result: "approved";
         } | {
-            revisions: string[];
             result: "needs-revision";
+            revisions: string[];
         })[];
     }, {
         result: "approved" | "needs-revision";
         thread: ({
             result: "approved";
         } | {
-            revisions: string[];
             result: "needs-revision";
+            revisions: string[];
         })[];
     }>>;
     /**
@@ -565,27 +361,27 @@ export declare const ConversationalOutlineSchema: z.ZodObject<{
             result: z.ZodLiteral<"needs-revision">;
             revisions: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            revisions: string[];
             result: "needs-revision";
-        }, {
             revisions: string[];
+        }, {
             result: "needs-revision";
+            revisions: string[];
         }>]>, "many">;
     }, "strip", z.ZodTypeAny, {
         result: "approved" | "needs-revision";
         thread: ({
             result: "approved";
         } | {
-            revisions: string[];
             result: "needs-revision";
+            revisions: string[];
         })[];
     }, {
         result: "approved" | "needs-revision";
         thread: ({
             result: "approved";
         } | {
-            revisions: string[];
             result: "needs-revision";
+            revisions: string[];
         })[];
     }>>;
     areas: z.ZodArray<z.ZodObject<{
@@ -619,27 +415,27 @@ export declare const ConversationalOutlineSchema: z.ZodObject<{
                 result: z.ZodLiteral<"needs-revision">;
                 revisions: z.ZodArray<z.ZodString, "many">;
             }, "strip", z.ZodTypeAny, {
-                revisions: string[];
                 result: "needs-revision";
-            }, {
                 revisions: string[];
+            }, {
                 result: "needs-revision";
+                revisions: string[];
             }>]>, "many">;
         }, "strip", z.ZodTypeAny, {
             result: "approved" | "needs-revision";
             thread: ({
                 result: "approved";
             } | {
-                revisions: string[];
                 result: "needs-revision";
+                revisions: string[];
             })[];
         }, {
             result: "approved" | "needs-revision";
             thread: ({
                 result: "approved";
             } | {
-                revisions: string[];
                 result: "needs-revision";
+                revisions: string[];
             })[];
         }>>;
     }, "strip", z.ZodTypeAny, {
@@ -655,8 +451,8 @@ export declare const ConversationalOutlineSchema: z.ZodObject<{
             thread: ({
                 result: "approved";
             } | {
-                revisions: string[];
                 result: "needs-revision";
+                revisions: string[];
             })[];
         } | undefined;
     }, {
@@ -672,8 +468,8 @@ export declare const ConversationalOutlineSchema: z.ZodObject<{
             thread: ({
                 result: "approved";
             } | {
-                revisions: string[];
                 result: "needs-revision";
+                revisions: string[];
             })[];
         } | undefined;
     }>, "many">;
@@ -694,8 +490,8 @@ export declare const ConversationalOutlineSchema: z.ZodObject<{
             thread: ({
                 result: "approved";
             } | {
-                revisions: string[];
                 result: "needs-revision";
+                revisions: string[];
             })[];
         } | undefined;
     }[];
@@ -704,8 +500,8 @@ export declare const ConversationalOutlineSchema: z.ZodObject<{
         thread: ({
             result: "approved";
         } | {
-            revisions: string[];
             result: "needs-revision";
+            revisions: string[];
         })[];
     } | undefined;
     crossAreaReview?: {
@@ -713,8 +509,8 @@ export declare const ConversationalOutlineSchema: z.ZodObject<{
         thread: ({
             result: "approved";
         } | {
-            revisions: string[];
             result: "needs-revision";
+            revisions: string[];
         })[];
     } | undefined;
 }, {
@@ -734,8 +530,8 @@ export declare const ConversationalOutlineSchema: z.ZodObject<{
             thread: ({
                 result: "approved";
             } | {
-                revisions: string[];
                 result: "needs-revision";
+                revisions: string[];
             })[];
         } | undefined;
     }[];
@@ -744,8 +540,8 @@ export declare const ConversationalOutlineSchema: z.ZodObject<{
         thread: ({
             result: "approved";
         } | {
-            revisions: string[];
             result: "needs-revision";
+            revisions: string[];
         })[];
     } | undefined;
     crossAreaReview?: {
@@ -753,8 +549,8 @@ export declare const ConversationalOutlineSchema: z.ZodObject<{
         thread: ({
             result: "approved";
         } | {
-            revisions: string[];
             result: "needs-revision";
+            revisions: string[];
         })[];
     } | undefined;
 }>;
@@ -865,5 +661,4 @@ export declare function parsePartialResult(text: string): PartialResult;
  * non-empty `revisions` list.
  */
 export declare function parseReviewVerdict(text: string): ConversationalReviewEntry;
-export declare function parseSpecReview(text: string): SpecReview;
 //# sourceMappingURL=schemas.d.ts.map

package/dist/codebase-to-spec/schemas.js

@@ -1,12 +1,10 @@
 /**
- * JSON schemas for outline + reviewer output.
- *
- * The CLI passes these to `claude -p --json-schema` to constrain agent output,
- * then validates the parsed result before driving the loop.
+ * Schemas for the codebase-to-spec outline and the conversational
+ * orchestrator's review / partial-result shapes. Workers validate their JSON
+ * output against these before returning it to the workflow.
  *
  * Requirements covered:
  * - CTS-PLAN-1: outline structure
- * - CTS-PLAN-2: outline reviewer output structure (categorized findings + verdict)
  */
 import { z } from "zod";
 // ---------- Outline ----------
@@ -37,165 +35,14 @@ export const OutlineSchema = z.object({
     summary: z.string().min(1),
     areas: z.array(AreaSchema).min(1),
 });
-/**
- * JSON Schema for the outline, passed to `claude -p --json-schema`.
- * Mirrors OutlineSchema in JSON Schema form (which `claude -p` accepts).
- */
-export const OUTLINE_JSON_SCHEMA = {
-    type: "object",
-    properties: {
-        title: { type: "string" },
-        defaultPrefix: { type: "string" },
-        summary: { type: "string" },
-        areas: {
-            type: "array",
-            items: {
-                type: "object",
-                properties: {
-                    name: { type: "string" },
-                    description: { type: "string" },
-                    prefix: { type: "string" },
-                    files: { type: "array", items: { type: "string" } },
-                    customers: {
-                        type: "array",
-                        minItems: 1,
-                        items: {
-                            type: "object",
-                            properties: {
-                                name: { type: "string" },
-                                description: { type: "string" },
-                            },
-                            required: ["name", "description"],
-                            additionalProperties: false,
-                        },
-                    },
-                },
-                required: ["name", "description", "prefix", "files", "customers"],
-                additionalProperties: false,
-            },
-        },
-    },
-    required: ["title", "defaultPrefix", "summary", "areas"],
-    additionalProperties: false,
-};
-// ---------- Outline review verdict ----------
-export const VerdictValues = [
-    "approved",
-    "approved-with-revisions",
-    "requires-another-review",
-];
-export const OutlineReviewSchema = z.object({
-    coverage_gaps: z.array(z.string()).default([]),
-    framing_errors: z.array(z.string()).default([]),
-    granularity_issues: z.array(z.string()).default([]),
-    file_assignment_issues: z.array(z.string()).default([]),
-    revisions: z.array(z.string()).default([]),
-    verdict: z.enum(VerdictValues),
-});
-export const OUTLINE_REVIEW_JSON_SCHEMA = {
-    type: "object",
-    properties: {
-        coverage_gaps: { type: "array", items: { type: "string" } },
-        framing_errors: { type: "array", items: { type: "string" } },
-        granularity_issues: { type: "array", items: { type: "string" } },
-        file_assignment_issues: { type: "array", items: { type: "string" } },
-        revisions: { type: "array", items: { type: "string" } },
-        verdict: {
-            type: "string",
-            enum: VerdictValues,
-        },
-    },
-    required: [
-        "coverage_gaps",
-        "framing_errors",
-        "granularity_issues",
-        "file_assignment_issues",
-        "revisions",
-        "verdict",
-    ],
-    additionalProperties: false,
-};
-/**
- * Try to parse a string as JSON and validate against the outline schema.
- * Throws with a descriptive message on failure (caller catches and either
- * retries or fails the loop).
- */
-export function parseOutline(text) {
-    const trimmed = text.trim();
-    // Try direct parse first; fall back to extracting first {...} block.
-    let raw;
-    try {
-        raw = JSON.parse(trimmed);
-    }
-    catch {
-        const match = trimmed.match(/(\{[\s\S]*\})/);
-        if (!match) {
-            throw new Error("Outline output is not valid JSON and contains no JSON object");
-        }
-        raw = JSON.parse(match[1]);
-    }
-    return OutlineSchema.parse(raw);
-}
-/**
- * Parse a reviewer's JSON output and validate against the outline-review schema.
- */
-export function parseOutlineReview(text) {
-    const trimmed = text.trim();
-    let raw;
-    try {
-        raw = JSON.parse(trimmed);
-    }
-    catch {
-        const match = trimmed.match(/(\{[\s\S]*\})/);
-        if (!match) {
-            throw new Error("Reviewer output is not valid JSON and contains no JSON object");
-        }
-        raw = JSON.parse(match[1]);
-    }
-    return OutlineReviewSchema.parse(raw);
-}
-// ---------- Spec review verdict ----------
-//
-// Same three-verdict structure as the outline reviewer, with categories
-// tailored to document-level cohesion concerns.
-export const SpecReviewSchema = z.object({
-    coverage_gaps: z.array(z.string()).default([]),
-    framing_errors: z.array(z.string()).default([]),
-    cross_area_issues: z.array(z.string()).default([]),
-    internal_mechanics_drift: z.array(z.string()).default([]),
-    revisions: z.array(z.string()).default([]),
-    verdict: z.enum(VerdictValues),
-});
-export const SPEC_REVIEW_JSON_SCHEMA = {
-    type: "object",
-    properties: {
-        coverage_gaps: { type: "array", items: { type: "string" } },
-        framing_errors: { type: "array", items: { type: "string" } },
-        cross_area_issues: { type: "array", items: { type: "string" } },
-        internal_mechanics_drift: { type: "array", items: { type: "string" } },
-        revisions: { type: "array", items: { type: "string" } },
-        verdict: {
-            type: "string",
-            enum: VerdictValues,
-        },
-    },
-    required: [
-        "coverage_gaps",
-        "framing_errors",
-        "cross_area_issues",
-        "internal_mechanics_drift",
-        "revisions",
-        "verdict",
-    ],
-    additionalProperties: false,
-};
 // ---------- Conversational orchestrator outline (Phase 2b refactor) ----------
 //
 // The conversational orchestrator uses a single evolving `outline.yaml` as
 // the pipeline's substrate. The outline carries both the behavioral spec
 // content (areas, customers, source_files) AND its own lifecycle state
 // (review.result + review.thread). This is distinct from the legacy
-// `OutlineSchema` above, which the `cts run` pipeline still uses.
+// `OutlineSchema` above, which the deterministic compose/present stages still
+// consume (the orchestrator converts to it via `conversationalOutlineToLegacy`).
 //
 // Field naming uses "result" rather than "verdict" deliberately: review is
 // a collaborative interaction with the worker, not a juridical ruling.
@@ -433,19 +280,4 @@ export function parseReviewVerdict(text) {
     }
     return ConversationalReviewEntrySchema.parse(raw);
 }
-export function parseSpecReview(text) {
-    const trimmed = text.trim();
-    let raw;
-    try {
-        raw = JSON.parse(trimmed);
-    }
-    catch {
-        const match = trimmed.match(/(\{[\s\S]*\})/);
-        if (!match) {
-            throw new Error("Spec reviewer output is not valid JSON and contains no JSON object");
-        }
-        raw = JSON.parse(match[1]);
-    }
-    return SpecReviewSchema.parse(raw);
-}
 //# sourceMappingURL=schemas.js.map