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

package/dist/core/update.js

@@ -1,9 +1,16 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Core update-item operation
+ * Patches item metadata fields and synchronizes the distributed index.
+ */
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { STATUS, RELATIONSHIP_TYPE } from '../constants/index.js';
-import { TYPE_TO_DIRECTORY, getCurrentTimestamp, parseItemId } from '../utils/index.js';
-import { updateItemInIndex } from './index-refs.js';
+import { RELATIONSHIP_TYPE, STATUS } from '../constants/index.js';
+import { getCurrentTimestamp, parseItemId, TYPE_TO_DIRECTORY } from '../utils/index.js';
 import { getItem } from './get.js';
+import { updateItemInIndex } from './index-refs.js';
 /**
  * Core business logic for updating an item
  */
@@ -28,7 +35,8 @@ export async function updateItem(devstepsDir, args) {
     if (args.status === STATUS.DONE) {
         // Helper function to validate children are complete
         const validateChildren = async (relationshipType) => {
-            const children = metadata.linked_items[relationshipType];
+            // Guard: old-format items may lack linked_items or specific relation keys
+            const children = metadata.linked_items?.[relationshipType] ?? [];
             if (children.length > 0) {
                 const openChildren = [];
                 for (const childId of children) {
@@ -36,7 +44,9 @@ export async function updateItem(devstepsDir, args) {
                     if (childParsed) {
                         try {
                             const { metadata: childMeta } = await getItem(devstepsDir, childId);
-                            if (childMeta.status !== STATUS.DONE && childMeta.status !== STATUS.CANCELLED && childMeta.status !== STATUS.OBSOLETE) {
+                            if (childMeta.status !== STATUS.DONE &&
+                                childMeta.status !== STATUS.CANCELLED &&
+                                childMeta.status !== STATUS.OBSOLETE) {
                                 openChildren.push(childId);
                             }
                         }
@@ -86,9 +96,7 @@ export async function updateItem(devstepsDir, args) {
     }
     else if (args.append_description) {
         // Append to existing (or create new if doesn't exist)
-        const existing = existsSync(descriptionPath)
-            ? readFileSync(descriptionPath, 'utf-8')
-            : '';
+        const existing = existsSync(descriptionPath) ? readFileSync(descriptionPath, 'utf-8') : '';
         writeFileSync(descriptionPath, existing + args.append_description);
     }
     // Update index (auto-migration ensures refs-style always available)

package/dist/core/update.js.map

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

package/dist/core/validation.d.ts

@@ -1,4 +1,12 @@
-import type { ItemType, Methodology } from '../schemas/index.js';
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Relationship validation
+ * Enforces hierarchy rules and flexible relationship constraints
+ * based on the active project methodology.
+ */
+import type { ItemType, LinkedItems, Methodology } from '../schemas/index.js';
 /**
  * Validation result with detailed error messaging
  */
@@ -25,4 +33,21 @@ export interface WorkItem {
  * @returns ValidationResult with valid flag and optional error/suggestion
  */
 export declare function validateRelationship(source: WorkItem, target: WorkItem, relationType: string, methodology: Methodology): ValidationResult;
+/**
+ * Validate that no conflicting relation types exist between the same source and target.
+ *
+ * Blocks:
+ * - hierarchy + any other type to same target
+ * - multiple hierarchy types to same target
+ *
+ * Allows:
+ * - bidirectional symmetric flexible relations (e.g. relates-to)
+ * - multiple flexible types to same target (e.g. depends-on + relates-to)
+ *
+ * @param targetId - The target item ID being linked
+ * @param newRelationType - The new relation type being added
+ * @param existingLinks - Current linked_items of the source item
+ * @returns ValidationResult indicating conflict or success
+ */
+export declare function validateRelationConflict(targetId: string, newRelationType: string, existingLinks: LinkedItems): ValidationResult;
 //# sourceMappingURL=validation.d.ts.map

package/dist/core/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIjE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,QAAQ,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,WAAW,GACvB,gBAAgB,CAwDlB"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAG9E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,QAAQ,EAChB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,WAAW,GACvB,gBAAgB,CA2DlB;AAmLD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,WAAW,GACzB,gBAAgB,CAoClB"}

package/dist/core/validation.js

@@ -1,5 +1,13 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Relationship validation
+ * Enforces hierarchy rules and flexible relationship constraints
+ * based on the active project methodology.
+ */
+import { ITEM_TYPE, METHODOLOGY, RELATIONSHIP_TYPE } from '../constants/index.js';
 import { isFlexibleRelation, isHierarchyRelation } from '../schemas/relationships.js';
-import { ITEM_TYPE, RELATIONSHIP_TYPE, METHODOLOGY } from '../constants/index.js';
 /**
  * Validate relationship between two items based on methodology
  * Only validates "implements" relationships - all other relations are flexible
@@ -29,7 +37,8 @@ export function validateRelationship(source, target, relationType, methodology)
         // Bug blocks: validate as hierarchy below
     }
     // Only validate "implements" direction (implemented-by, blocked-by are automatic reverse)
-    if (relationType === RELATIONSHIP_TYPE.IMPLEMENTED_BY || relationType === RELATIONSHIP_TYPE.BLOCKED_BY) {
+    if (relationType === RELATIONSHIP_TYPE.IMPLEMENTED_BY ||
+        relationType === RELATIONSHIP_TYPE.BLOCKED_BY) {
         return { valid: true }; // Reverse relationships auto-created, no validation needed
     }
     // Validate based on methodology
@@ -68,7 +77,9 @@ function validateScrumHierarchy(source, target) {
     const { type: targetType } = target;
     // Task → Story, Spike, or Bug
     if (sourceType === ITEM_TYPE.TASK) {
-        if (targetType === ITEM_TYPE.STORY || targetType === ITEM_TYPE.SPIKE || targetType === ITEM_TYPE.BUG) {
+        if (targetType === ITEM_TYPE.STORY ||
+            targetType === ITEM_TYPE.SPIKE ||
+            targetType === ITEM_TYPE.BUG) {
             return { valid: true };
         }
         return {
@@ -145,7 +156,9 @@ function validateWaterfallHierarchy(source, target) {
     const { type: targetType } = target;
     // Task → Feature, Spike, or Bug
     if (sourceType === ITEM_TYPE.TASK) {
-        if (targetType === ITEM_TYPE.FEATURE || targetType === ITEM_TYPE.SPIKE || targetType === ITEM_TYPE.BUG) {
+        if (targetType === ITEM_TYPE.FEATURE ||
+            targetType === ITEM_TYPE.SPIKE ||
+            targetType === ITEM_TYPE.BUG) {
             return { valid: true };
         }
         return {
@@ -212,4 +225,52 @@ function validateWaterfallHierarchy(source, target) {
         suggestion: 'Check Waterfall hierarchy: Requirement → Feature|Spike → Task',
     };
 }
+/**
+ * Validate that no conflicting relation types exist between the same source and target.
+ *
+ * Blocks:
+ * - hierarchy + any other type to same target
+ * - multiple hierarchy types to same target
+ *
+ * Allows:
+ * - bidirectional symmetric flexible relations (e.g. relates-to)
+ * - multiple flexible types to same target (e.g. depends-on + relates-to)
+ *
+ * @param targetId - The target item ID being linked
+ * @param newRelationType - The new relation type being added
+ * @param existingLinks - Current linked_items of the source item
+ * @returns ValidationResult indicating conflict or success
+ */
+export function validateRelationConflict(targetId, newRelationType, existingLinks) {
+    const newIsHierarchy = isHierarchyRelation(newRelationType);
+    for (const [existingType, targetIds] of Object.entries(existingLinks)) {
+        // Skip same type — duplicate check is handled separately
+        if (existingType === newRelationType)
+            continue;
+        // Skip if target not in this relation list
+        if (!Array.isArray(targetIds) || !targetIds.includes(targetId))
+            continue;
+        const existingIsHierarchy = isHierarchyRelation(existingType);
+        // Block: both hierarchy types to same target
+        if (newIsHierarchy && existingIsHierarchy) {
+            return {
+                valid: false,
+                error: `Cannot add "${newRelationType}" to ${targetId} — already has hierarchy relation "${existingType}" to same target`,
+                suggestion: `Remove the existing "${existingType}" link first, or use a different target`,
+            };
+        }
+        // Block: hierarchy mixed with any flexible type to same target
+        if (newIsHierarchy || existingIsHierarchy) {
+            const hierarchyType = newIsHierarchy ? newRelationType : existingType;
+            const flexibleType = newIsHierarchy ? existingType : newRelationType;
+            return {
+                valid: false,
+                error: `Cannot mix hierarchy relation "${hierarchyType}" with flexible relation "${flexibleType}" to same target ${targetId}`,
+                suggestion: `Use only "${hierarchyType}" (hierarchy takes precedence) and remove "${flexibleType}", or use a different target`,
+            };
+        }
+        // Multiple flexible types to same target: allowed
+    }
+    return { valid: true };
+}
 //# sourceMappingURL=validation.js.map

package/dist/core/validation.js.map

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

package/dist/index.d.ts

@@ -1,7 +1,14 @@
-export * from './types/index.js';
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Shared package public API
+ * Single entry point re-exporting all public types, schemas, and core functions.
+ */
+export * from './constants/index.js';
+export { HIERARCHY_TYPE, ITEM_TYPE, METHODOLOGY, RELATIONSHIP_TYPE, STATUS, } from './constants/index.js';
+export * from './core/index.js';
 export * from './schemas/index.js';
+export * from './types/index.js';
 export * from './utils/index.js';
-export * from './core/index.js';
-export * from './constants/index.js';
-export { ITEM_TYPE, STATUS, RELATIONSHIP_TYPE, METHODOLOGY, HIERARCHY_TYPE, } from './constants/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACN,SAAS,EACT,MAAM,EACN,iBAAiB,EACjB,WAAW,EACX,cAAc,GACd,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,cAAc,EACd,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,MAAM,GACP,MAAM,sBAAsB,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,7 +1,14 @@
-export * from './types/index.js';
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Shared package public API
+ * Single entry point re-exporting all public types, schemas, and core functions.
+ */
+export * from './constants/index.js';
+export { HIERARCHY_TYPE, ITEM_TYPE, METHODOLOGY, RELATIONSHIP_TYPE, STATUS, } from './constants/index.js';
+export * from './core/index.js';
 export * from './schemas/index.js';
+export * from './types/index.js';
 export * from './utils/index.js';
-export * from './core/index.js';
-export * from './constants/index.js';
-export { ITEM_TYPE, STATUS, RELATIONSHIP_TYPE, METHODOLOGY, HIERARCHY_TYPE, } from './constants/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACN,SAAS,EACT,MAAM,EACN,iBAAiB,EACjB,WAAW,EACX,cAAc,GACd,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,cAAc,EACd,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,MAAM,GACP,MAAM,sBAAsB,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/schemas/analysis.d.ts

@@ -0,0 +1,206 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Context Budget Protocol (CBP) — Analysis Schemas
+ * Zod schemas for T3 archaeology and analysis envelope files.
+ *
+ * @see EPIC-027 CBP Tier-3 Analysis Tools
+ */
+import { z } from 'zod';
+/**
+ * Context Budget Protocol (CBP) — Analysis Schemas
+ *
+ * Defines structured JSON envelopes for AI agent-to-agent handoffs.
+ * Aspect agents write AnalysisBriefing to disk (.devsteps/analysis/[ID]/)
+ * and return CompressedVerdict envelopes (~150 tokens) in-memory to the coordinator.
+ *
+ * @see EPIC-027 Context Budget Protocol Infrastructure
+ */
+export declare const AnalysisAspect: z.ZodEnum<{
+    impact: "impact";
+    constraints: "constraints";
+    quality: "quality";
+    staleness: "staleness";
+    integration: "integration";
+    internal: "internal";
+    web: "web";
+    meta: "meta";
+}>;
+export type AnalysisAspect = z.infer<typeof AnalysisAspect>;
+export declare const AspectVerdict: z.ZodEnum<{
+    PROCEED: "PROCEED";
+    "PROCEED-WITH-CAUTION": "PROCEED-WITH-CAUTION";
+    STOP: "STOP";
+    CURRENT: "CURRENT";
+    "STALE-PARTIAL": "STALE-PARTIAL";
+    "STALE-OBSOLETE": "STALE-OBSOLETE";
+    "STALE-CONFLICT": "STALE-CONFLICT";
+}>;
+export type AspectVerdict = z.infer<typeof AspectVerdict>;
+/**
+ * Compressed envelope returned IN-MEMORY by aspect agents to the coordinator.
+ * Max ~150 tokens — coordinator reads only this, never the full report.
+ */
+export declare const CompressedVerdictSchema: z.ZodObject<{
+    aspect: z.ZodEnum<{
+        impact: "impact";
+        constraints: "constraints";
+        quality: "quality";
+        staleness: "staleness";
+        integration: "integration";
+        internal: "internal";
+        web: "web";
+        meta: "meta";
+    }>;
+    verdict: z.ZodEnum<{
+        PROCEED: "PROCEED";
+        "PROCEED-WITH-CAUTION": "PROCEED-WITH-CAUTION";
+        STOP: "STOP";
+        CURRENT: "CURRENT";
+        "STALE-PARTIAL": "STALE-PARTIAL";
+        "STALE-OBSOLETE": "STALE-OBSOLETE";
+        "STALE-CONFLICT": "STALE-CONFLICT";
+    }>;
+    confidence: z.ZodNumber;
+    top3_findings: z.ZodArray<z.ZodString>;
+    report_path: z.ZodString;
+    timestamp: z.ZodString;
+    winner: z.ZodOptional<z.ZodString>;
+    rule_applied: z.ZodOptional<z.ZodString>;
+    implementation_briefing: z.ZodOptional<z.ZodString>;
+    internet_advantage_claim: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type CompressedVerdict = z.infer<typeof CompressedVerdictSchema>;
+/**
+ * Full analysis report written to disk by aspect agents.
+ * Path: `.devsteps/analysis/[TASK-ID]/[aspect]-report.json`
+ * Contains the CompressedVerdict envelope + full markdown analysis text.
+ * Impl-subagent reads this for implementation context.
+ */
+export declare const AnalysisBriefingSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    aspect: z.ZodEnum<{
+        impact: "impact";
+        constraints: "constraints";
+        quality: "quality";
+        staleness: "staleness";
+        integration: "integration";
+        internal: "internal";
+        web: "web";
+        meta: "meta";
+    }>;
+    analyst: z.ZodString;
+    created: z.ZodString;
+    envelope: z.ZodObject<{
+        aspect: z.ZodEnum<{
+            impact: "impact";
+            constraints: "constraints";
+            quality: "quality";
+            staleness: "staleness";
+            integration: "integration";
+            internal: "internal";
+            web: "web";
+            meta: "meta";
+        }>;
+        verdict: z.ZodEnum<{
+            PROCEED: "PROCEED";
+            "PROCEED-WITH-CAUTION": "PROCEED-WITH-CAUTION";
+            STOP: "STOP";
+            CURRENT: "CURRENT";
+            "STALE-PARTIAL": "STALE-PARTIAL";
+            "STALE-OBSOLETE": "STALE-OBSOLETE";
+            "STALE-CONFLICT": "STALE-CONFLICT";
+        }>;
+        confidence: z.ZodNumber;
+        top3_findings: z.ZodArray<z.ZodString>;
+        report_path: z.ZodString;
+        timestamp: z.ZodString;
+        winner: z.ZodOptional<z.ZodString>;
+        rule_applied: z.ZodOptional<z.ZodString>;
+        implementation_briefing: z.ZodOptional<z.ZodString>;
+        internet_advantage_claim: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    full_analysis: z.ZodString;
+    affected_files: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    recommendations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    schema_version: z.ZodDefault<z.ZodLiteral<"1.0">>;
+}, z.core.$strip>;
+export type AnalysisBriefing = z.infer<typeof AnalysisBriefingSchema>;
+/**
+ * Meta-verdict written by the coordinator judge in Competitive Mode.
+ * Path: `.devsteps/analysis/[TASK-ID]/meta.json`
+ */
+export declare const SprintVerdictSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    mode: z.ZodLiteral<"competitive">;
+    winner: z.ZodEnum<{
+        "devsteps-analyst-internal-subagent": "devsteps-analyst-internal-subagent";
+        "devsteps-analyst-web-subagent": "devsteps-analyst-web-subagent";
+    }>;
+    rule_applied: z.ZodEnum<{
+        "RULE 1": "RULE 1";
+        "RULE 2": "RULE 2";
+        "RULE 3": "RULE 3";
+        "RULE 4": "RULE 4";
+        "RULE 5": "RULE 5";
+    }>;
+    implementation_briefing: z.ZodString;
+    flags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    created: z.ZodString;
+    schema_version: z.ZodDefault<z.ZodLiteral<"1.0">>;
+}, z.core.$strip>;
+export type SprintVerdict = z.infer<typeof SprintVerdictSchema>;
+/**
+ * Produced by devsteps-planner at sprint start from global archaeology + backlog.
+ * Path: `.devsteps/analysis/sprint-[DATE]/enriched-sprint-brief.json`
+ */
+export declare const SprintItemRisk: z.ZodEnum<{
+    QUICK: "QUICK";
+    STANDARD: "STANDARD";
+    FULL: "FULL";
+    COMPETITIVE: "COMPETITIVE";
+}>;
+export type SprintItemRisk = z.infer<typeof SprintItemRisk>;
+export declare const EnrichedSprintItemSchema: z.ZodObject<{
+    item_id: z.ZodString;
+    title: z.ZodString;
+    risk: z.ZodEnum<{
+        QUICK: "QUICK";
+        STANDARD: "STANDARD";
+        FULL: "FULL";
+        COMPETITIVE: "COMPETITIVE";
+    }>;
+    estimated_minutes: z.ZodOptional<z.ZodNumber>;
+    affected_files: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    depends_on: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    shared_file_conflicts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type EnrichedSprintItem = z.infer<typeof EnrichedSprintItemSchema>;
+export declare const EnrichedSprintBriefSchema: z.ZodObject<{
+    sprint_date: z.ZodString;
+    global_context_path: z.ZodString;
+    ordered_items: z.ZodArray<z.ZodObject<{
+        item_id: z.ZodString;
+        title: z.ZodString;
+        risk: z.ZodEnum<{
+            QUICK: "QUICK";
+            STANDARD: "STANDARD";
+            FULL: "FULL";
+            COMPETITIVE: "COMPETITIVE";
+        }>;
+        estimated_minutes: z.ZodOptional<z.ZodNumber>;
+        affected_files: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        depends_on: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        shared_file_conflicts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    invalidation_cache: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    created: z.ZodString;
+    schema_version: z.ZodDefault<z.ZodLiteral<"1.0">>;
+}, z.core.$strip>;
+export type EnrichedSprintBrief = z.infer<typeof EnrichedSprintBriefSchema>;
+//# sourceMappingURL=analysis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/schemas/analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AAIH,eAAO,MAAM,cAAc;;;;;;;;;EASzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAI5D,eAAO,MAAM,aAAa;;;;;;;;EASxB,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAI1D;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwBlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAIxE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;iBAS9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;EAAuD,CAAC;AACnF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;iBASnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;iBAOpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/schemas/analysis.js

@@ -0,0 +1,138 @@
+/**
+ * Copyright © 2025 Thomas Hertel (the@devsteps.dev)
+ * Licensed under the Apache License, Version 2.0
+ *
+ * Context Budget Protocol (CBP) — Analysis Schemas
+ * Zod schemas for T3 archaeology and analysis envelope files.
+ *
+ * @see EPIC-027 CBP Tier-3 Analysis Tools
+ */
+import { z } from 'zod';
+/**
+ * Context Budget Protocol (CBP) — Analysis Schemas
+ *
+ * Defines structured JSON envelopes for AI agent-to-agent handoffs.
+ * Aspect agents write AnalysisBriefing to disk (.devsteps/analysis/[ID]/)
+ * and return CompressedVerdict envelopes (~150 tokens) in-memory to the coordinator.
+ *
+ * @see EPIC-027 Context Budget Protocol Infrastructure
+ */
+// ─── Aspect types ────────────────────────────────────────────────────────────
+export const AnalysisAspect = z.enum([
+    'impact',
+    'constraints',
+    'quality',
+    'staleness',
+    'integration',
+    'internal', // competitive analyst: codebase
+    'web', // competitive analyst: internet
+    'meta', // coordinator judge verdict
+]);
+// ─── Verdict types ───────────────────────────────────────────────────────────
+export const AspectVerdict = z.enum([
+    'PROCEED',
+    'PROCEED-WITH-CAUTION',
+    'STOP',
+    // staleness-specific
+    'CURRENT',
+    'STALE-PARTIAL',
+    'STALE-OBSOLETE',
+    'STALE-CONFLICT',
+]);
+// ─── CompressedVerdict ───────────────────────────────────────────────────────
+/**
+ * Compressed envelope returned IN-MEMORY by aspect agents to the coordinator.
+ * Max ~150 tokens — coordinator reads only this, never the full report.
+ */
+export const CompressedVerdictSchema = z.object({
+    /** Which aspect produced this envelope */
+    aspect: AnalysisAspect,
+    /** Proceed / stop / caution signal */
+    verdict: AspectVerdict,
+    /** 0.0–1.0 confidence in the verdict */
+    confidence: z.number().min(0).max(1),
+    /** Max 3, max 100 chars each — the coordinator reads these */
+    top3_findings: z.array(z.string().max(200)).max(3),
+    /** Relative path to the full AnalysisBriefing JSON on disk */
+    report_path: z.string(),
+    /** ISO 8601 timestamp */
+    timestamp: z.string().datetime(),
+    // ── Competitive mode fields (aspect = 'internal' | 'web' | 'meta') ───────
+    /** Winner agent name (meta verdict only) */
+    winner: z.string().optional(),
+    /** Rule applied by the judge (meta verdict only) */
+    rule_applied: z.string().optional(),
+    /** Path to winning implementation briefing (meta verdict only) */
+    implementation_briefing: z.string().optional(),
+    /** Internet advantage claim (web analyst only) */
+    internet_advantage_claim: z.string().optional(),
+    /** Arbitrary aspect-specific scalar fields (kept minimal) */
+    metadata: z.record(z.string(), z.unknown()).default({}),
+});
+// ─── AnalysisBriefing ────────────────────────────────────────────────────────
+/**
+ * Full analysis report written to disk by aspect agents.
+ * Path: `.devsteps/analysis/[TASK-ID]/[aspect]-report.json`
+ * Contains the CompressedVerdict envelope + full markdown analysis text.
+ * Impl-subagent reads this for implementation context.
+ */
+export const AnalysisBriefingSchema = z.object({
+    /** DevSteps item ID this analysis belongs to */
+    task_id: z.string().regex(/^(EPIC|STORY|TASK|REQ|FEAT|BUG|SPIKE|TEST)-\d{3,}$/),
+    /** Which aspect this briefing covers */
+    aspect: AnalysisAspect,
+    /** Name of the agent that produced this briefing */
+    analyst: z.string(),
+    /** When the briefing was created */
+    created: z.string().datetime(),
+    /** The compressed envelope (also returned in-memory to coordinator) */
+    envelope: CompressedVerdictSchema,
+    /** Full markdown analysis text for implementation agents to read */
+    full_analysis: z.string(),
+    /** Files identified as affected by this analysis */
+    affected_files: z.array(z.string()).default([]),
+    /** Prioritized action recommendations */
+    recommendations: z.array(z.string()).default([]),
+    /** Schema version for forward compatibility */
+    schema_version: z.literal('1.0').default('1.0'),
+});
+// ─── SprintVerdict ───────────────────────────────────────────────────────────
+/**
+ * Meta-verdict written by the coordinator judge in Competitive Mode.
+ * Path: `.devsteps/analysis/[TASK-ID]/meta.json`
+ */
+export const SprintVerdictSchema = z.object({
+    task_id: z.string(),
+    mode: z.literal('competitive'),
+    winner: z.enum(['devsteps-analyst-internal-subagent', 'devsteps-analyst-web-subagent']),
+    rule_applied: z.enum(['RULE 1', 'RULE 2', 'RULE 3', 'RULE 4', 'RULE 5']),
+    implementation_briefing: z.string(),
+    flags: z.array(z.string()).default([]),
+    created: z.string().datetime(),
+    schema_version: z.literal('1.0').default('1.0'),
+});
+// ─── EnrichedSprintBrief ─────────────────────────────────────────────────────
+/**
+ * Produced by devsteps-planner at sprint start from global archaeology + backlog.
+ * Path: `.devsteps/analysis/sprint-[DATE]/enriched-sprint-brief.json`
+ */
+export const SprintItemRisk = z.enum(['QUICK', 'STANDARD', 'FULL', 'COMPETITIVE']);
+export const EnrichedSprintItemSchema = z.object({
+    item_id: z.string(),
+    title: z.string(),
+    risk: SprintItemRisk,
+    estimated_minutes: z.number().optional(),
+    affected_files: z.array(z.string()).default([]),
+    depends_on: z.array(z.string()).default([]),
+    shared_file_conflicts: z.array(z.string()).default([]),
+    notes: z.string().optional(),
+});
+export const EnrichedSprintBriefSchema = z.object({
+    sprint_date: z.string(),
+    global_context_path: z.string(),
+    ordered_items: z.array(EnrichedSprintItemSchema),
+    invalidation_cache: z.array(z.string()).default([]),
+    created: z.string().datetime(),
+    schema_version: z.literal('1.0').default('1.0'),
+});
+//# sourceMappingURL=analysis.js.map