@schnick371/devsteps-shared 0.8.5 → 1.0.0-next.2

package/dist/schemas/cbp-mandate.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Context Budget Protocol (CBP) — Tier-2 Mandate Schemas
+ * Zod schemas for T2 mandate dispatch and result envelopes.
+ *
+ * @see EPIC-028 CBP Tier-2 Mandate Tools
+ */
+import { z } from 'zod';
+/**
+ * Context Budget Protocol (CBP) — Tier-2 Mandate Schemas
+ *
+ * Defines structured JSON envelopes for Tier-1 ↔ Tier-2 agent handoffs.
+ * Tier-1 dispatches Mandates to Tier-2 Deep Analysts.
+ * Tier-2 writes MandateResult to disk and returns ~800-token synthesis to Tier-1.
+ *
+ * Storage path: .devsteps/cbp/[sprint_id]/[mandate_id].result.json
+ *
+ * @see EPIC-028 N-Tier Agent Hierarchy
+ * @see STORY-108 MandateResult CBP Extension
+ */
+export declare const MandateType: z.ZodEnum<{
+    risk: "risk";
+    archaeology: "archaeology";
+    "archaeology-delta": "archaeology-delta";
+    "risk-batch": "risk-batch";
+    research: "research";
+    "quality-review": "quality-review";
+    planning: "planning";
+    "planning-rerank": "planning-rerank";
+}>;
+export type MandateType = z.infer<typeof MandateType>;
+export declare const TriageTier: z.ZodEnum<{
+    QUICK: "QUICK";
+    STANDARD: "STANDARD";
+    FULL: "FULL";
+    COMPETITIVE: "COMPETITIVE";
+}>;
+export type TriageTier = z.infer<typeof TriageTier>;
+export declare const MandateResultStatus: z.ZodEnum<{
+    escalated: "escalated";
+    complete: "complete";
+    partial: "partial";
+}>;
+export type MandateResultStatus = z.infer<typeof MandateResultStatus>;
+/**
+ * Tier-1 → Tier-2: A Mandate is dispatched by Tier-1 to a Tier-2 Deep Analyst.
+ * Contains the context for the analyst to decompose into Tier-3 sub-questions.
+ *
+ * NOT written to disk directly — passed as argument to the runSubagent call.
+ * Tier-2 agents receive this as structured input.
+ */
+export declare const MandateSchema: z.ZodObject<{
+    mandate_id: z.ZodString;
+    type: z.ZodEnum<{
+        risk: "risk";
+        archaeology: "archaeology";
+        "archaeology-delta": "archaeology-delta";
+        "risk-batch": "risk-batch";
+        research: "research";
+        "quality-review": "quality-review";
+        planning: "planning";
+        "planning-rerank": "planning-rerank";
+    }>;
+    sprint_id: z.ZodString;
+    item_ids: z.ZodArray<z.ZodString>;
+    triage_tier: z.ZodEnum<{
+        QUICK: "QUICK";
+        STANDARD: "STANDARD";
+        FULL: "FULL";
+        COMPETITIVE: "COMPETITIVE";
+    }>;
+    constraints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    dispatched_at: z.ZodString;
+    max_tokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type Mandate = z.infer<typeof MandateSchema>;
+/**
+ * Tier-2 → Tier-1: A MandateResult is written to disk by a Tier-2 Deep Analyst
+ * after synthesizing all Tier-3 sub-question answers.
+ *
+ * Storage: .devsteps/cbp/[sprint_id]/[mandate_id].result.json
+ * Tier-1 reads via read_mandate_results() — never reads T3 envelopes directly.
+ *
+ * Max ~800 tokens in findings field — enforced by schema.
+ */
+export declare const MandateResultSchema: z.ZodObject<{
+    mandate_id: z.ZodString;
+    item_ids: z.ZodArray<z.ZodString>;
+    sprint_id: z.ZodString;
+    analyst: z.ZodString;
+    status: z.ZodEnum<{
+        escalated: "escalated";
+        complete: "complete";
+        partial: "partial";
+    }>;
+    findings: z.ZodString;
+    recommendations: z.ZodArray<z.ZodString>;
+    confidence: z.ZodNumber;
+    token_cost: z.ZodNumber;
+    completed_at: z.ZodString;
+    escalation_reason: z.ZodOptional<z.ZodString>;
+    schema_version: z.ZodDefault<z.ZodLiteral<"1.0">>;
+}, z.core.$strip>;
+export type MandateResult = z.infer<typeof MandateResultSchema>;
+//# sourceMappingURL=cbp-mandate.d.ts.map

package/dist/schemas/cbp-mandate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbp-mandate.d.ts","sourceRoot":"","sources":["../../src/schemas/cbp-mandate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;GAWG;AAIH,eAAO,MAAM,WAAW;;;;;;;;;EAStB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAItD,eAAO,MAAM,UAAU;;;;;EAAuD,CAAC;AAC/E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAIpD,eAAO,MAAM,mBAAmB;;;;EAI9B,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAItE;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;iBAiBxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAIpD;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;iBA4B9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/schemas/cbp-mandate.js

@@ -0,0 +1,107 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Context Budget Protocol (CBP) — Tier-2 Mandate Schemas
+ * Zod schemas for T2 mandate dispatch and result envelopes.
+ *
+ * @see EPIC-028 CBP Tier-2 Mandate Tools
+ */
+import { z } from 'zod';
+/**
+ * Context Budget Protocol (CBP) — Tier-2 Mandate Schemas
+ *
+ * Defines structured JSON envelopes for Tier-1 ↔ Tier-2 agent handoffs.
+ * Tier-1 dispatches Mandates to Tier-2 Deep Analysts.
+ * Tier-2 writes MandateResult to disk and returns ~800-token synthesis to Tier-1.
+ *
+ * Storage path: .devsteps/cbp/[sprint_id]/[mandate_id].result.json
+ *
+ * @see EPIC-028 N-Tier Agent Hierarchy
+ * @see STORY-108 MandateResult CBP Extension
+ */
+// ─── Mandate Type ─────────────────────────────────────────────────────────────
+export const MandateType = z.enum([
+    'archaeology', // deep-analyst-archaeology: full scope analysis
+    'archaeology-delta', // deep-analyst-archaeology: incremental re-analysis
+    'risk', // deep-analyst-risk: single-item risk scoring
+    'risk-batch', // deep-analyst-risk: multi-item sprint risk matrix
+    'research', // deep-analyst-research: external technical research
+    'quality-review', // deep-analyst-quality: post-implementation gate
+    'planning', // deep-analyst-planner: atomic step decomposition
+    'planning-rerank', // deep-analyst-planner: adaptive sprint resequencing
+]);
+// ─── Triage Tier ─────────────────────────────────────────────────────────────
+export const TriageTier = z.enum(['QUICK', 'STANDARD', 'FULL', 'COMPETITIVE']);
+// ─── MandateResult Status ─────────────────────────────────────────────────────
+export const MandateResultStatus = z.enum([
+    'complete', // All sub-questions answered, confidence >= 0.5
+    'partial', // Max resolution rounds exhausted, answers incomplete
+    'escalated', // Human or higher-tier decision required
+]);
+// ─── MandateSchema ────────────────────────────────────────────────────────────
+/**
+ * Tier-1 → Tier-2: A Mandate is dispatched by Tier-1 to a Tier-2 Deep Analyst.
+ * Contains the context for the analyst to decompose into Tier-3 sub-questions.
+ *
+ * NOT written to disk directly — passed as argument to the runSubagent call.
+ * Tier-2 agents receive this as structured input.
+ */
+export const MandateSchema = z.object({
+    /** Unique ID for correlation between Mandate and MandateResult */
+    mandate_id: z.string().uuid(),
+    /** Which Tier-2 analyst receives this mandate */
+    type: MandateType,
+    /** Sprint or item context identifier (used as storage path segment) */
+    sprint_id: z.string(),
+    /** DevSteps item IDs this mandate covers (single item or batch) */
+    item_ids: z.array(z.string().regex(/^(EPIC|STORY|TASK|REQ|FEAT|BUG|SPIKE|TEST)-\d{3,}$/)),
+    /** Determines which sub-questions the analyst must answer */
+    triage_tier: TriageTier,
+    /** Optional Tier-1 context hints (e.g., shared-file conflicts, prior results paths) */
+    constraints: z.record(z.string(), z.unknown()).optional(),
+    /** ISO 8601 timestamp when this mandate was dispatched */
+    dispatched_at: z.string().datetime(),
+    /** Token budget hint for the analyst (enforcement is advisory) */
+    max_tokens: z.number().int().positive().optional(),
+});
+// ─── MandateResultSchema ──────────────────────────────────────────────────────
+/**
+ * Tier-2 → Tier-1: A MandateResult is written to disk by a Tier-2 Deep Analyst
+ * after synthesizing all Tier-3 sub-question answers.
+ *
+ * Storage: .devsteps/cbp/[sprint_id]/[mandate_id].result.json
+ * Tier-1 reads via read_mandate_results() — never reads T3 envelopes directly.
+ *
+ * Max ~800 tokens in findings field — enforced by schema.
+ */
+export const MandateResultSchema = z.object({
+    /** Correlates to the originating Mandate.mandate_id */
+    mandate_id: z.string().uuid(),
+    /** DevSteps item IDs this result covers */
+    item_ids: z.array(z.string()),
+    /** Sprint ID for file path construction */
+    sprint_id: z.string(),
+    /** Name of the Tier-2 agent that produced this result */
+    analyst: z.string(),
+    /** Result completeness indicator */
+    status: MandateResultStatus,
+    /**
+     * Structured synthesis — max ~800 tokens.
+     * Should be a markdown table or structured paragraphs answering the mandate.
+     */
+    findings: z.string().max(6000), // ~800 tokens ≈ 6000 chars
+    /** Top-5 actionable items for Tier-1, max 120 chars each */
+    recommendations: z.array(z.string().max(200)).max(5),
+    /** 0.0–1.0 confidence in the synthesis quality */
+    confidence: z.number().min(0).max(1),
+    /** Actual token cost of this analyst invocation (for Tier-1 budget tracking) */
+    token_cost: z.number().int().nonnegative(),
+    /** ISO 8601 timestamp when this result was written */
+    completed_at: z.string().datetime(),
+    /** Required when status === "escalated" */
+    escalation_reason: z.string().optional(),
+    /** Schema version for forward compatibility */
+    schema_version: z.literal('1.0').default('1.0'),
+});
+//# sourceMappingURL=cbp-mandate.js.map

package/dist/schemas/cbp-mandate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbp-mandate.js","sourceRoot":"","sources":["../../src/schemas/cbp-mandate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;GAWG;AAEH,iFAAiF;AAEjF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC;IAChC,aAAa,EAAE,gDAAgD;IAC/D,mBAAmB,EAAE,oDAAoD;IACzE,MAAM,EAAE,8CAA8C;IACtD,YAAY,EAAE,mDAAmD;IACjE,UAAU,EAAE,qDAAqD;IACjE,gBAAgB,EAAE,iDAAiD;IACnE,UAAU,EAAE,kDAAkD;IAC9D,iBAAiB,EAAE,qDAAqD;CACzE,CAAC,CAAC;AAGH,gFAAgF;AAEhF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;AAG/E,iFAAiF;AAEjF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC;IACxC,UAAU,EAAE,gDAAgD;IAC5D,SAAS,EAAE,sDAAsD;IACjE,WAAW,EAAE,yCAAyC;CACvD,CAAC,CAAC;AAGH,iFAAiF;AAEjF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,kEAAkE;IAClE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC7B,iDAAiD;IACjD,IAAI,EAAE,WAAW;IACjB,uEAAuE;IACvE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,mEAAmE;IACnE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACzF,6DAA6D;IAC7D,WAAW,EAAE,UAAU;IACvB,uFAAuF;IACvF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzD,0DAA0D;IAC1D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,kEAAkE;IAClE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAGH,iFAAiF;AAEjF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,uDAAuD;IACvD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC7B,2CAA2C;IAC3C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,2CAA2C;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,yDAAyD;IACzD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,oCAAoC;IACpC,MAAM,EAAE,mBAAmB;IAC3B;;;OAGG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,2BAA2B;IAC3D,4DAA4D;IAC5D,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,kDAAkD;IAClD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,gFAAgF;IAChF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,sDAAsD;IACtD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,2CAA2C;IAC3C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,+CAA+C;IAC/C,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CAChD,CAAC,CAAC"}

package/dist/schemas/cbp-mandate.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Unit Tests for CBP Tier-2 Mandate Schemas
+ *
+ * Tests: MandateSchema, MandateResultSchema
+ *
+ * @see STORY-108 MandateResult CBP Extension
+ * @see TASK-233 MandateSchema + MandateResultSchema
+ */
+export {};
+//# sourceMappingURL=cbp-mandate.test.d.ts.map

package/dist/schemas/cbp-mandate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbp-mandate.test.d.ts","sourceRoot":"","sources":["../../src/schemas/cbp-mandate.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/schemas/cbp-mandate.test.js

@@ -0,0 +1,188 @@
+/**
+ * Unit Tests for CBP Tier-2 Mandate Schemas
+ *
+ * Tests: MandateSchema, MandateResultSchema
+ *
+ * @see STORY-108 MandateResult CBP Extension
+ * @see TASK-233 MandateSchema + MandateResultSchema
+ */
+import { describe, expect, it } from 'vitest';
+import { MandateResultSchema, MandateResultStatus, MandateSchema, MandateType, TriageTier, } from './cbp-mandate.js';
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function validMandate() {
+    return {
+        mandate_id: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+        type: 'archaeology',
+        sprint_id: 'sprint-2026-02-22',
+        item_ids: ['TASK-233'],
+        triage_tier: 'STANDARD',
+        dispatched_at: '2026-02-22T10:00:00.000Z',
+    };
+}
+function validMandateResult() {
+    return {
+        mandate_id: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+        item_ids: ['TASK-233'],
+        sprint_id: 'sprint-2026-02-22',
+        analyst: 'devsteps-t2-archaeology',
+        status: 'complete',
+        findings: '## Affected Scope\n- packages/shared/src/schemas/cbp-mandate.ts (new)\n- packages/shared/src/schemas/index.ts (export)',
+        recommendations: ['Implement MandateSchema first (TASK-233)', 'Export from schemas/index.ts'],
+        confidence: 0.9,
+        token_cost: 1500,
+        completed_at: '2026-02-22T10:05:00.000Z',
+    };
+}
+// ─── MandateType enum ─────────────────────────────────────────────────────────
+describe('MandateType', () => {
+    it('accepts all valid mandate types', () => {
+        const validTypes = [
+            'archaeology',
+            'archaeology-delta',
+            'risk',
+            'risk-batch',
+            'research',
+            'quality-review',
+            'planning',
+            'planning-rerank',
+        ];
+        for (const type of validTypes) {
+            expect(() => MandateType.parse(type)).not.toThrow();
+        }
+    });
+    it('rejects unknown mandate types', () => {
+        expect(() => MandateType.parse('unknown-type')).toThrow();
+        expect(() => MandateType.parse('impl')).toThrow();
+    });
+});
+// ─── MandateSchema ────────────────────────────────────────────────────────────
+describe('MandateSchema', () => {
+    it('parses a valid Mandate', () => {
+        const result = MandateSchema.safeParse(validMandate());
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.data.mandate_id).toBe('a1b2c3d4-e5f6-7890-abcd-ef1234567890');
+            expect(result.data.type).toBe('archaeology');
+            expect(result.data.item_ids).toEqual(['TASK-233']);
+        }
+    });
+    it('rejects invalid UUID for mandate_id', () => {
+        const badMandate = { ...validMandate(), mandate_id: 'not-a-uuid' };
+        const result = MandateSchema.safeParse(badMandate);
+        expect(result.success).toBe(false);
+    });
+    it('rejects invalid item ID format', () => {
+        const badMandate = { ...validMandate(), item_ids: ['XYZ-123'] }; // Invalid prefix
+        const result = MandateSchema.safeParse(badMandate);
+        expect(result.success).toBe(false);
+    });
+    it('accepts valid item ID formats', () => {
+        const itemIds = ['EPIC-001', 'STORY-108', 'TASK-233', 'BUG-042', 'SPIKE-015'];
+        const result = MandateSchema.safeParse({ ...validMandate(), item_ids: itemIds });
+        expect(result.success).toBe(true);
+    });
+    it('rejects invalid triage tier', () => {
+        const badMandate = { ...validMandate(), triage_tier: 'ULTRA' };
+        const result = MandateSchema.safeParse(badMandate);
+        expect(result.success).toBe(false);
+    });
+    it('allows optional constraints field', () => {
+        const withConstraints = {
+            ...validMandate(),
+            constraints: { shared_file_conflicts: ['packages/shared/index.ts'] },
+        };
+        const result = MandateSchema.safeParse(withConstraints);
+        expect(result.success).toBe(true);
+    });
+    it('allows optional max_tokens field', () => {
+        const result = MandateSchema.safeParse({ ...validMandate(), max_tokens: 10000 });
+        expect(result.success).toBe(true);
+    });
+    it('rejects missing required fields', () => {
+        const { mandate_id: _, ...noId } = validMandate();
+        expect(MandateSchema.safeParse(noId).success).toBe(false);
+        const { sprint_id: __, ...noSprint } = validMandate();
+        expect(MandateSchema.safeParse(noSprint).success).toBe(false);
+    });
+});
+// ─── MandateResultSchema ──────────────────────────────────────────────────────
+describe('MandateResultSchema', () => {
+    it('parses a valid MandateResult', () => {
+        const result = MandateResultSchema.safeParse(validMandateResult());
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.data.analyst).toBe('devsteps-t2-archaeology');
+            expect(result.data.status).toBe('complete');
+            expect(result.data.confidence).toBe(0.9);
+            expect(result.data.schema_version).toBe('1.0');
+        }
+    });
+    it('defaults schema_version to 1.0', () => {
+        const result = MandateResultSchema.parse(validMandateResult());
+        expect(result.schema_version).toBe('1.0');
+    });
+    it('rejects confidence outside 0.0–1.0', () => {
+        expect(MandateResultSchema.safeParse({ ...validMandateResult(), confidence: 1.1 }).success).toBe(false);
+        expect(MandateResultSchema.safeParse({ ...validMandateResult(), confidence: -0.1 }).success).toBe(false);
+    });
+    it('rejects findings exceeding 6000 characters', () => {
+        const tooLong = 'x'.repeat(6001);
+        const result = MandateResultSchema.safeParse({ ...validMandateResult(), findings: tooLong });
+        expect(result.success).toBe(false);
+    });
+    it('accepts findings at exactly 6000 characters', () => {
+        const exact = 'x'.repeat(6000);
+        const result = MandateResultSchema.safeParse({ ...validMandateResult(), findings: exact });
+        expect(result.success).toBe(true);
+    });
+    it('rejects recommendations with more than 5 items', () => {
+        const tooMany = ['a', 'b', 'c', 'd', 'e', 'f']; // 6 items
+        const result = MandateResultSchema.safeParse({
+            ...validMandateResult(),
+            recommendations: tooMany,
+        });
+        expect(result.success).toBe(false);
+    });
+    it('rejects a recommendation exceeding 200 characters', () => {
+        const tooLong = ['x'.repeat(201)];
+        const result = MandateResultSchema.safeParse({
+            ...validMandateResult(),
+            recommendations: tooLong,
+        });
+        expect(result.success).toBe(false);
+    });
+    it('accepts all valid status values', () => {
+        for (const status of ['complete', 'partial', 'escalated']) {
+            const result = MandateResultSchema.safeParse({ ...validMandateResult(), status });
+            expect(result.success).toBe(true);
+        }
+    });
+    it('requires escalation_reason when status is escalated (validation note: field is optional in schema)', () => {
+        // Schema allows escalated without escalation_reason (handler documents it)
+        const escalated = { ...validMandateResult(), status: 'escalated' };
+        const result = MandateResultSchema.safeParse(escalated);
+        expect(result.success).toBe(true);
+    });
+    it('rejects negative token_cost', () => {
+        const result = MandateResultSchema.safeParse({ ...validMandateResult(), token_cost: -1 });
+        expect(result.success).toBe(false);
+    });
+    it('rejects non-integer token_cost', () => {
+        const result = MandateResultSchema.safeParse({ ...validMandateResult(), token_cost: 1.5 });
+        expect(result.success).toBe(false);
+    });
+    it('validates TriageTier enum independently', () => {
+        expect(() => TriageTier.parse('QUICK')).not.toThrow();
+        expect(() => TriageTier.parse('STANDARD')).not.toThrow();
+        expect(() => TriageTier.parse('FULL')).not.toThrow();
+        expect(() => TriageTier.parse('COMPETITIVE')).not.toThrow();
+        expect(() => TriageTier.parse('INVALID')).toThrow();
+    });
+    it('validates MandateResultStatus enum independently', () => {
+        expect(() => MandateResultStatus.parse('complete')).not.toThrow();
+        expect(() => MandateResultStatus.parse('partial')).not.toThrow();
+        expect(() => MandateResultStatus.parse('escalated')).not.toThrow();
+        expect(() => MandateResultStatus.parse('failed')).toThrow();
+    });
+});
+//# sourceMappingURL=cbp-mandate.test.js.map

package/dist/schemas/cbp-mandate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbp-mandate.test.js","sourceRoot":"","sources":["../../src/schemas/cbp-mandate.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,gFAAgF;AAEhF,SAAS,YAAY;IACnB,OAAO;QACL,UAAU,EAAE,sCAAsC;QAClD,IAAI,EAAE,aAAa;QACnB,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,WAAW,EAAE,UAAU;QACvB,aAAa,EAAE,0BAA0B;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB;IACzB,OAAO;QACL,UAAU,EAAE,sCAAsC;QAClD,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,SAAS,EAAE,mBAAmB;QAC9B,OAAO,EAAE,yBAAyB;QAClC,MAAM,EAAE,UAAU;QAClB,QAAQ,EACN,wHAAwH;QAC1H,eAAe,EAAE,CAAC,0CAA0C,EAAE,8BAA8B,CAAC;QAC7F,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,0BAA0B;KACzC,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,UAAU,GAAG;YACjB,aAAa;YACb,mBAAmB;YACnB,MAAM;YACN,YAAY;YACZ,UAAU;YACV,gBAAgB;YAChB,UAAU;YACV,iBAAiB;SAClB,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACtD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAC1D,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,iFAAiF;AAEjF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;YAC5E,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC7C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,UAAU,GAAG,EAAE,GAAG,YAAY,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;QACnE,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,UAAU,GAAG,EAAE,GAAG,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,iBAAiB;QAClF,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,OAAO,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,EAAE,GAAG,YAAY,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,UAAU,GAAG,EAAE,GAAG,YAAY,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;QAC/D,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,eAAe,GAAG;YACtB,GAAG,YAAY,EAAE;YACjB,WAAW,EAAE,EAAE,qBAAqB,EAAE,CAAC,0BAA0B,CAAC,EAAE;SACrE,CAAC;QACF,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,EAAE,GAAG,YAAY,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,YAAY,EAAE,CAAC;QAClD,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE1D,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,YAAY,EAAE,CAAC;QACtD,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,iFAAiF;AAEjF,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;YAC5D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CACJ,mBAAmB,CAAC,SAAS,CAAC,EAAE,GAAG,kBAAkB,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CACpF,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,MAAM,CACJ,mBAAmB,CAAC,SAAS,CAAC,EAAE,GAAG,kBAAkB,EAAE,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CACrF,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,EAAE,GAAG,kBAAkB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7F,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,EAAE,GAAG,kBAAkB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3F,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,UAAU;QAC1D,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC;YAC3C,GAAG,kBAAkB,EAAE;YACvB,eAAe,EAAE,OAAO;SACzB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC;YAC3C,GAAG,kBAAkB,EAAE;YACvB,eAAe,EAAE,OAAO;SACzB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,KAAK,MAAM,MAAM,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,CAAU,EAAE,CAAC;YACnE,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,EAAE,GAAG,kBAAkB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAClF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oGAAoG,EAAE,GAAG,EAAE;QAC5G,2EAA2E;QAC3E,MAAM,SAAS,GAAG,EAAE,GAAG,kBAAkB,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QACnE,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,EAAE,GAAG,kBAAkB,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1F,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,EAAE,GAAG,kBAAkB,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3F,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACtD,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACzD,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACrD,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAC5D,MAAM,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QAClE,MAAM,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACjE,MAAM,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnE,MAAM,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/schemas/index-refs.schema.d.ts

@@ -1,4 +1,7 @@
 /**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
  * Zod Validation Schemas for Refs-Style Index
  *
  * Runtime validation for the distributed index architecture.
@@ -45,9 +48,9 @@ export declare const StatusIndexSchema: z.ZodObject<{
         "in-progress": "in-progress";
         review: "review";
         done: "done";
-        obsolete: "obsolete";
         blocked: "blocked";
         cancelled: "cancelled";
+        obsolete: "obsolete";
     }>;
 }, z.core.$strip>;
 /**

package/dist/schemas/index-refs.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-refs.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/index-refs.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;iBAS9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;iBAE1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAE5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;iBAE9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc,uCAG1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAC;AAEH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAExF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAEhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAEpF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAExF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAE9E"}
+{"version":3,"file":"index-refs.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/index-refs.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;iBAS9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;iBAE1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAW5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;iBAO9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc,uCAM1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAC;AAEH;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAExF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAEhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAEpF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAExF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAE9E"}

package/dist/schemas/index-refs.schema.js

@@ -1,4 +1,7 @@
 /**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
  * Zod Validation Schemas for Refs-Style Index
  *
  * Runtime validation for the distributed index architecture.
@@ -29,13 +32,27 @@ export const TypeIndexSchema = CategoryIndexSchema.extend({
  * Status index schema (by-status/*.json)
  */
 export const StatusIndexSchema = CategoryIndexSchema.extend({
-    category: z.enum(['draft', 'planned', 'in-progress', 'review', 'done', 'obsolete', 'blocked', 'cancelled']),
+    category: z.enum([
+        'draft',
+        'planned',
+        'in-progress',
+        'review',
+        'done',
+        'obsolete',
+        'blocked',
+        'cancelled',
+    ]),
 });
 /**
  * Priority index schema (by-priority/*.json)
  */
 export const PriorityIndexSchema = CategoryIndexSchema.extend({
-    category: z.enum(['urgent-important', 'not-urgent-important', 'urgent-not-important', 'not-urgent-not-important']),
+    category: z.enum([
+        'urgent-important',
+        'not-urgent-important',
+        'urgent-not-important',
+        'not-urgent-not-important',
+    ]),
 });
 /**
  * Counters schema (index/counters.json)
@@ -43,7 +60,11 @@ export const PriorityIndexSchema = CategoryIndexSchema.extend({
  * Preserves ID generation counters from legacy index
  */
 export const CountersSchema = z.record(z.string(), // item type key
-z.number().int().nonnegative());
+z
+    .number()
+    .int()
+    .nonnegative() // counter value
+);
 /**
  * Index paths validation
  */

package/dist/schemas/index-refs.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"index-refs.schema.js","sourceRoot":"","sources":["../../src/schemas/index-refs.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,oBAAoB;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IAEpB,wBAAwB;IACxB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAEtF,uCAAuC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACzD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;CAC7F,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC3D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;CAC3G,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC7D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,0BAA0B,CAAC,CAAC;CAClH,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CACrC,CAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB;AAC5B,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IAClD,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC9C,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAChD,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IAClD,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC7C,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"index-refs.schema.js","sourceRoot":"","sources":["../../src/schemas/index-refs.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,oBAAoB;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IAEpB,wBAAwB;IACxB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAEtF,uCAAuC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC,MAAM,CAAC;IACxD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;CAC9F,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC1D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;QACf,OAAO;QACP,SAAS;QACT,aAAa;QACb,QAAQ;QACR,MAAM;QACN,UAAU;QACV,SAAS;QACT,WAAW;KACZ,CAAC;CACH,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC5D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC;QACf,kBAAkB;QAClB,sBAAsB;QACtB,sBAAsB;QACtB,0BAA0B;KAC3B,CAAC;CACH,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CACpC,CAAC,CAAC,MAAM,EAAE,EAAE,gBAAgB;AAC5B,CAAC;KACE,MAAM,EAAE;KACR,GAAG,EAAE;KACL,WAAW,EAAE,CAAC,gBAAgB;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,OAAO,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/dist/schemas/index.d.ts

@@ -1,7 +1,17 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Schemas barrel export
+ * Re-exports all Zod schemas and derived TypeScript types.
+ */
 import { z } from 'zod';
+export * from './analysis.js';
+export * from './cbp-loops.js';
+export * from './cbp-mandate.js';
+export * from './index-refs.schema.js';
 export * from './project.js';
 export * from './relationships.js';
-export * from './index-refs.schema.js';
 /**
  * Methodology types
  */
@@ -37,9 +47,9 @@ export declare const ItemStatus: z.ZodEnum<{
     "in-progress": "in-progress";
     review: "review";
     done: "done";
-    obsolete: "obsolete";
     blocked: "blocked";
     cancelled: "cancelled";
+    obsolete: "obsolete";
 }>;
 export type ItemStatus = z.infer<typeof ItemStatus>;
 /**
@@ -64,11 +74,11 @@ export declare const RelationType: z.ZodEnum<{
     "implemented-by": "implemented-by";
     blocks: "blocks";
     "blocked-by": "blocked-by";
+    "tested-by": "tested-by";
+    tests: "tests";
     "relates-to": "relates-to";
     "depends-on": "depends-on";
     "required-by": "required-by";
-    "tested-by": "tested-by";
-    tests: "tests";
     supersedes: "supersedes";
     "superseded-by": "superseded-by";
 }>;
@@ -124,9 +134,9 @@ export declare const ItemMetadata: z.ZodObject<{
         "in-progress": "in-progress";
         review: "review";
         done: "done";
-        obsolete: "obsolete";
         blocked: "blocked";
         cancelled: "cancelled";
+        obsolete: "obsolete";
     }>>;
     eisenhower: z.ZodDefault<z.ZodEnum<{
         "urgent-important": "urgent-important";
@@ -221,9 +231,9 @@ export declare const DevStepsIndex: z.ZodObject<{
             "in-progress": "in-progress";
             review: "review";
             done: "done";
-            obsolete: "obsolete";
             blocked: "blocked";
             cancelled: "cancelled";
+            obsolete: "obsolete";
         }>;
         eisenhower: z.ZodEnum<{
             "urgent-important": "urgent-important";
@@ -255,9 +265,9 @@ export declare const DevStepsIndex: z.ZodObject<{
             "in-progress": "in-progress";
             review: "review";
             done: "done";
-            obsolete: "obsolete";
             blocked: "blocked";
             cancelled: "cancelled";
+            obsolete: "obsolete";
         }>;
     }, z.core.$strip>>>;
     stats: z.ZodOptional<z.ZodObject<{

package/dist/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,WAAW;;;;EAA2C,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;EASnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;EASrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;;;EAK7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;EAYvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;kBA0BpB,CAAC;AACL,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;iBAMpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgCxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,cAAc,eAAe,CAAC;AAE9B,cAAc,gBAAgB,CAAC;AAE/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AAEnC;;GAEG;AACH,eAAO,MAAM,WAAW;;;;EAA2C,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;EASnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;EASrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;;;EAK7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;EAYvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;kBA0BpB,CAAC;AACL,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;iBAMpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgCxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/schemas/index.js

@@ -1,8 +1,21 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Schemas barrel export
+ * Re-exports all Zod schemas and derived TypeScript types.
+ */
 import { z } from 'zod';
+// Context Budget Protocol schemas
+export * from './analysis.js';
+// CBP Loop control schemas: RejectionFeedback, IterationSignal, EscalationSignal
+export * from './cbp-loops.js';
+// CBP Tier-2 schemas: Mandate ↔ MandateResult (Tier-1 ↔ Tier-2)
+export * from './cbp-mandate.js';
+export * from './index-refs.schema.js';
 // Re-export project context schemas
 export * from './project.js';
 export * from './relationships.js';
-export * from './index-refs.schema.js';
 /**
  * Methodology types
  */