@windagency/valora 2.1.4 → 2.2.1

package/README.md

@@ -17,7 +17,7 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-2.1.4-blue?style=flat-square" alt="Version" />
+  <img src="https://img.shields.io/badge/version-2.2.1-blue?style=flat-square" alt="Version" />
   <img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen?style=flat-square&logo=node.js" alt="Node" />
   <img src="https://img.shields.io/badge/typescript-5.x-3178c6?style=flat-square&logo=typescript" alt="TypeScript" />
   <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License" />
@@ -176,7 +176,7 @@ npm install -g @windagency/valora       # npm
 
 # Verify installation
 valora --version
-# Should output: 2.1.4
+# Should output: 2.2.1
 ```
 
 ### Project Setup

package/data/commands/_meta/schema.json

@@ -213,6 +213,11 @@
 								"minimum": 1000,
 								"maximum": 300000,
 								"default": 30000
+							},
+							"failure_policy": {
+								"type": "string",
+								"description": "Controls how tool failures affect stage success. 'strict' = all failures count, 'tolerant' = only fatal (mutating) failures count, 'lenient' = never hard-stop.",
+								"enum": ["strict", "tolerant", "lenient"]
 							}
 						},
 						"additionalProperties": false

package/data/commands/create-backlog.md

@@ -31,6 +31,7 @@ prompts:
       timeout_ms: 30000
     - stage: onboard
       prompt: onboard.analyze-requirements
+      batch: true
       required: true
       inputs:
         source_document: $STAGE_context.prd_document
@@ -43,6 +44,7 @@ prompts:
       timeout_ms: 60000
     - stage: breakdown
       prompt: plan.decompose-tasks
+      batch: true
       required: true
       inputs:
         analysis: $STAGE_onboard.requirement_analysis
@@ -56,6 +58,7 @@ prompts:
       timeout_ms: 90000
     - stage: review
       prompt: review.validate-backlog
+      batch: true
       required: true
       inputs:
         tasks: $STAGE_breakdown.task_list
@@ -67,6 +70,7 @@ prompts:
       timeout_ms: 60000
     - stage: generate
       prompt: documentation.generate-backlog-artifacts
+      batch: true
       required: true
       inputs:
         task_list: $STAGE_breakdown.task_list

package/data/commands/create-prd.md

@@ -31,6 +31,7 @@ prompts:
         - project_type
     - stage: onboard
       prompt: onboard.analyze-requirements
+      batch: true
       required: true
       inputs:
         source_document: $STAGE_context.specifications
@@ -59,6 +60,7 @@ prompts:
         - questions_skipped
     - stage: documentation
       prompt: documentation.generate-prd
+      batch: true
       required: true
       inputs:
         specifications: $STAGE_context.specifications
@@ -71,6 +73,7 @@ prompts:
         - executive_summary
     - stage: review
       prompt: review.validate-completeness
+      batch: true
       required: true
       inputs:
         document: $STAGE_documentation.prd_document

package/data/commands/generate-docs.md

@@ -53,6 +53,7 @@ prompts:
       timeout_ms: 60000
     - stage: generateInfra
       prompt: documentation.generate-infrastructure-docs
+      batch: true
       required: false
       conditional: $STAGE_analyze.domain_assignments.infrastructure
       parallel: true
@@ -73,6 +74,7 @@ prompts:
       timeout_ms: 180000
     - stage: generateBackend
       prompt: documentation.generate-backend-docs
+      batch: true
       required: false
       conditional: $STAGE_analyze.domain_assignments.backend
       parallel: true
@@ -92,6 +94,7 @@ prompts:
       timeout_ms: 180000
     - stage: generateFrontend
       prompt: documentation.generate-frontend-docs
+      batch: true
       required: false
       conditional: $STAGE_analyze.domain_assignments.frontend
       parallel: true
@@ -110,6 +113,7 @@ prompts:
       timeout_ms: 180000
     - stage: review
       prompt: review.validate-documentation
+      batch: true
       required: true
       inputs:
         infrastructure_docs: $STAGE_generateInfra

package/data/commands/implement.md

@@ -33,6 +33,7 @@ prompts:
     - stage: context
       prompt: context.load-implementation-context
       required: true
+      failure_policy: tolerant
       inputs:
         implementation_plan: $ARG_1
         agent_type: $ARG_agent
@@ -48,6 +49,7 @@ prompts:
     - stage: review
       prompt: code.validate-prerequisites
       required: true
+      failure_policy: tolerant
       inputs:
         plan_summary: $STAGE_context.plan_summary
         dependencies: $STAGE_context.dependencies

package/data/commands/plan-architecture.md

@@ -36,6 +36,7 @@ prompts:
         - scope_boundaries
     - stage: architecture
       prompt: plan.define-architecture
+      batch: true
       required: true
       inputs:
         task_details: $STAGE_load.task_details

package/data/commands/plan-implementation.md

@@ -38,6 +38,7 @@ prompts:
         - execution_order
     - stage: risks
       prompt: plan.assess-risks
+      batch: true
       required: true
       inputs:
         architecture: $STAGE_load-arch.result
@@ -50,6 +51,7 @@ prompts:
         - risk_score
     - stage: breakdown
       prompt: plan.breakdown-implementation
+      batch: true
       required: true
       inputs:
         architecture: $STAGE_load-arch.result

package/data/commands/refine-specs.md

@@ -25,6 +25,7 @@ prompts:
         - initial_scope
     - stage: onboard
       prompt: onboard.refine-specifications
+      batch: true
       required: true
       inputs:
         user_intent: $STAGE_context.user_intent
@@ -39,6 +40,7 @@ prompts:
         - clarifying_questions
     - stage: review
       prompt: review.validate-completeness
+      batch: true
       required: true
       inputs:
         document: $STAGE_onboard.refined_specifications

package/data/commands/refine-task.md

@@ -27,6 +27,7 @@ prompts:
         - linked_requirements
     - stage: analyze
       prompt: onboard.analyze-clarity
+      batch: true
       required: true
       inputs:
         task_context: $STAGE_context.result
@@ -48,6 +49,7 @@ prompts:
         - assumptions_made
     - stage: review
       prompt: review.validate-testability
+      batch: true
       required: true
       inputs:
         task_context: $STAGE_context.result

package/data/commands/review-code.md

@@ -51,6 +51,7 @@ prompts:
         - validation_results
     - stage: documentation
       prompt: documentation.generate-code-review-report
+      batch: true
       required: true
       inputs:
         quality_score: $STAGE_review.quality_score

package/data/commands/review-functional.md

@@ -47,6 +47,7 @@ prompts:
         - workflow_validation
     - stage: documentation
       prompt: documentation.generate-functional-review-report
+      batch: true
       required: true
       inputs:
         completeness_score: $STAGE_review.completeness_score

package/data/commands/review-plan.md

@@ -27,6 +27,7 @@ prompts:
         - complexity_assessment
     - stage: completeness
       prompt: review.validate-completeness
+      batch: true
       required: true
       inputs:
         document_type: 'plan'
@@ -49,6 +50,7 @@ prompts:
         - blockers_identified
     - stage: risks
       prompt: review.validate-risk-coverage
+      batch: true
       required: true
       parallel: true
       inputs:
@@ -60,6 +62,7 @@ prompts:
         - mitigation_gaps
     - stage: steps
       prompt: review.validate-step-quality
+      batch: true
       required: true
       parallel: true
       inputs:
@@ -70,6 +73,7 @@ prompts:
         - actionability_issues
     - stage: tests
       prompt: review.validate-test-strategy
+      batch: true
       required: true
       parallel: true
       inputs:
@@ -79,6 +83,7 @@ prompts:
         - testing_gaps
     - stage: synthesis
       prompt: review.synthesize-plan-assessment
+      batch: true
       required: true
       inputs:
         completeness_score: $STAGE_completeness.completeness_score

package/dist/batch/batch-eligibility.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Batch eligibility checks
+ *
+ * A stage is batch-eligible when all three conditions hold:
+ * 1. stage.batch === true  (explicit opt-in)
+ * 2. --batch flag is set   (user intent)
+ * 3. provider.isBatchableProvider() (provider capability)
+ */
+import type { ExecutionContext } from '../executor/execution-context.js';
+import type { PipelineStage } from '../types/command.types.js';
+import type { LLMProvider } from '../types/llm.types.js';
+export interface EligibilityResult {
+    eligible: boolean;
+    reason?: string;
+}
+export declare function isEligible(stage: PipelineStage, executionContext: ExecutionContext, provider: LLMProvider): EligibilityResult;
+//# sourceMappingURL=batch-eligibility.d.ts.map

package/dist/batch/batch-eligibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-eligibility.d.ts","sourceRoot":"","sources":["../../src/batch/batch-eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,CACzB,KAAK,EAAE,aAAa,EACpB,gBAAgB,EAAE,gBAAgB,EAClC,QAAQ,EAAE,WAAW,GACnB,iBAAiB,CAcnB"}

package/dist/batch/batch-eligibility.js

@@ -0,0 +1,22 @@
+/**
+ * Batch eligibility checks
+ *
+ * A stage is batch-eligible when all three conditions hold:
+ * 1. stage.batch === true  (explicit opt-in)
+ * 2. --batch flag is set   (user intent)
+ * 3. provider.isBatchableProvider() (provider capability)
+ */
+import { isBatchableProvider } from './batch-provider.interface.js';
+export function isEligible(stage, executionContext, provider) {
+    if (!stage.batch) {
+        return { eligible: false, reason: 'stage does not have batch: true' };
+    }
+    if (!executionContext.flags['batch']) {
+        return { eligible: false, reason: '--batch flag not set' };
+    }
+    if (!isBatchableProvider(provider)) {
+        return { eligible: false, reason: `provider "${provider.name}" does not support batch API` };
+    }
+    return { eligible: true };
+}
+//# sourceMappingURL=batch-eligibility.js.map

package/dist/batch/batch-eligibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-eligibility.js","sourceRoot":"","sources":["../../src/batch/batch-eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAOjE,MAAM,UAAU,UAAU,CACzB,KAAoB,EACpB,gBAAkC,EAClC,QAAqB;IAErB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC;IACvE,CAAC;IAED,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC;IAC5D,CAAC;IAED,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,QAAQ,CAAC,IAAI,8BAA8B,EAAE,CAAC;IAC9F,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/batch/batch-orchestrator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * BatchOrchestrator - Submit, poll, and retrieve batch results
+ *
+ * Polling backoff: 30s → 60s → 2m → 5m (cap). Max wait default: 26h.
+ */
+import type { BatchableProvider } from './batch-provider.interface.js';
+import type { BatchRequest, BatchResult, BatchStatusInfo, BatchSubmission, PersistedBatch } from './batch.types.js';
+export declare class BatchOrchestrator {
+    /**
+     * Submit a set of requests to the batch provider and persist state.
+     */
+    submit(requests: BatchRequest[], provider: BatchableProvider): Promise<BatchSubmission>;
+    /**
+     * Block until the batch completes (or max wait is reached), then return results.
+     */
+    waitForResults(localId: string, provider: BatchableProvider, maxWaitMs?: number): Promise<BatchResult[]>;
+    /**
+     * Non-blocking: return current status from provider (and update persisted state).
+     */
+    getStatus(localId: string, provider: BatchableProvider): Promise<BatchStatusInfo>;
+    /**
+     * Retrieve completed results (from provider, with disk caching).
+     */
+    getResults(localId: string, provider: BatchableProvider): Promise<BatchResult[]>;
+    /**
+     * Cancel a batch job and update persisted state.
+     */
+    cancel(localId: string, provider: BatchableProvider): Promise<void>;
+    /**
+     * List all known batches from disk.
+     */
+    list(): PersistedBatch[];
+}
+export declare function getBatchOrchestrator(): BatchOrchestrator;
+//# sourceMappingURL=batch-orchestrator.d.ts.map

package/dist/batch/batch-orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-orchestrator.d.ts","sourceRoot":"","sources":["../../src/batch/batch-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAajH,qBAAa,iBAAiB;IAC7B;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAiB7F;;OAEG;IACG,cAAc,CACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,SAAsB,GAC7B,OAAO,CAAC,WAAW,EAAE,CAAC;IA+BzB;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBvF;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgBtF;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAazE;;OAEG;IACH,IAAI,IAAI,cAAc,EAAE;CAGxB;AAaD,wBAAgB,oBAAoB,IAAI,iBAAiB,CAGxD"}

package/dist/batch/batch-orchestrator.js

@@ -0,0 +1,121 @@
+/**
+ * BatchOrchestrator - Submit, poll, and retrieve batch results
+ *
+ * Polling backoff: 30s → 60s → 2m → 5m (cap). Max wait default: 26h.
+ */
+import { getLogger } from '../output/logger.js';
+import { generateLocalId, listBatches, loadBatch, persistBatch, updateBatch } from './batch-session.js';
+const DEFAULT_MAX_WAIT_MS = 26 * 60 * 60 * 1000; // 26 hours
+const POLL_INTERVALS_MS = [
+    30_000, // 30 s
+    60_000, // 60 s
+    2 * 60_000, // 2 min
+    5 * 60_000 // 5 min (cap)
+];
+export class BatchOrchestrator {
+    /**
+     * Submit a set of requests to the batch provider and persist state.
+     */
+    async submit(requests, provider) {
+        const logger = getLogger();
+        const localId = generateLocalId();
+        logger.info(`Submitting batch of ${requests.length} request(s) to ${provider.name}`, { localId });
+        const submission = await provider.submitBatch(requests);
+        // Use the localId we generated (submitBatch may generate its own, but we want ours for disk)
+        submission.localId = localId;
+        const persisted = { localId, requests, submission };
+        persistBatch(persisted);
+        logger.info(`Batch submitted`, { batchId: submission.batchId, localId, provider: provider.name });
+        return submission;
+    }
+    /**
+     * Block until the batch completes (or max wait is reached), then return results.
+     */
+    async waitForResults(localId, provider, maxWaitMs = DEFAULT_MAX_WAIT_MS) {
+        const logger = getLogger();
+        const deadline = Date.now() + maxWaitMs;
+        let attempt = 0;
+        while (Date.now() < deadline) {
+            const status = await this.getStatus(localId, provider);
+            logger.info(`Batch status: ${status.status}`, {
+                batchId: status.batchId,
+                completed: status.completedCount,
+                failed: status.failedCount,
+                total: status.totalCount
+            });
+            if (status.status === 'completed') {
+                return this.getResults(localId, provider);
+            }
+            if (status.status === 'failed' || status.status === 'cancelled' || status.status === 'expired') {
+                throw new Error(`Batch ${localId} ended with status: ${status.status}`);
+            }
+            const waitMs = nextPollInterval(attempt);
+            logger.debug(`Waiting ${waitMs}ms before next poll (attempt ${attempt + 1})`);
+            await sleep(waitMs);
+            attempt++;
+        }
+        throw new Error(`Batch ${localId} did not complete within ${Math.round(maxWaitMs / 3600000)}h`);
+    }
+    /**
+     * Non-blocking: return current status from provider (and update persisted state).
+     */
+    async getStatus(localId, provider) {
+        const batch = loadBatch(localId);
+        if (!batch) {
+            throw new Error(`Batch not found: ${localId}`);
+        }
+        const status = await provider.getBatchStatus(batch.submission.batchId);
+        // Update persisted status
+        updateBatch(localId, {
+            submission: { ...batch.submission, status: status.status }
+        });
+        return status;
+    }
+    /**
+     * Retrieve completed results (from provider, with disk caching).
+     */
+    async getResults(localId, provider) {
+        const batch = loadBatch(localId);
+        if (!batch) {
+            throw new Error(`Batch not found: ${localId}`);
+        }
+        const results = await provider.getBatchResults(batch.submission.batchId);
+        // Update status to completed
+        updateBatch(localId, {
+            submission: { ...batch.submission, status: 'completed' }
+        });
+        return results;
+    }
+    /**
+     * Cancel a batch job and update persisted state.
+     */
+    async cancel(localId, provider) {
+        const batch = loadBatch(localId);
+        if (!batch) {
+            throw new Error(`Batch not found: ${localId}`);
+        }
+        await provider.cancelBatch(batch.submission.batchId);
+        updateBatch(localId, {
+            submission: { ...batch.submission, status: 'cancelled' }
+        });
+    }
+    /**
+     * List all known batches from disk.
+     */
+    list() {
+        return listBatches();
+    }
+}
+function nextPollInterval(attempt) {
+    const idx = Math.min(attempt, POLL_INTERVALS_MS.length - 1);
+    return POLL_INTERVALS_MS[idx] ?? POLL_INTERVALS_MS[POLL_INTERVALS_MS.length - 1] ?? 5 * 60_000;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+let orchestratorInstance = null;
+export function getBatchOrchestrator() {
+    orchestratorInstance ??= new BatchOrchestrator();
+    return orchestratorInstance;
+}
+//# sourceMappingURL=batch-orchestrator.js.map

package/dist/batch/batch-orchestrator.js.map

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

package/dist/batch/batch-provider.interface.d.ts

@@ -0,0 +1,14 @@
+/**
+ * BatchableProvider interface and runtime type guard
+ */
+import type { LLMProvider } from '../types/llm.types.js';
+import type { BatchRequest, BatchResult, BatchStatusInfo, BatchSubmission } from './batch.types.js';
+export interface BatchableProvider extends LLMProvider {
+    cancelBatch(batchId: string): Promise<void>;
+    getBatchResults(batchId: string): Promise<BatchResult[]>;
+    getBatchStatus(batchId: string): Promise<BatchStatusInfo>;
+    submitBatch(requests: BatchRequest[]): Promise<BatchSubmission>;
+    supportsBatch(): true;
+}
+export declare function isBatchableProvider(p: LLMProvider): p is BatchableProvider;
+//# sourceMappingURL=batch-provider.interface.d.ts.map

package/dist/batch/batch-provider.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-provider.interface.d.ts","sourceRoot":"","sources":["../../src/batch/batch-provider.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEjG,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACrD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1D,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAChE,aAAa,IAAI,IAAI,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,IAAI,iBAAiB,CAM1E"}

package/dist/batch/batch-provider.interface.js

@@ -0,0 +1,9 @@
+/**
+ * BatchableProvider interface and runtime type guard
+ */
+export function isBatchableProvider(p) {
+    return ('supportsBatch' in p &&
+        typeof p.supportsBatch === 'function' &&
+        p.supportsBatch() === true);
+}
+//# sourceMappingURL=batch-provider.interface.js.map

package/dist/batch/batch-provider.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-provider.interface.js","sourceRoot":"","sources":["../../src/batch/batch-provider.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,MAAM,UAAU,mBAAmB,CAAC,CAAc;IACjD,OAAO,CACN,eAAe,IAAI,CAAC;QACpB,OAAQ,CAAuB,CAAC,aAAa,KAAK,UAAU;QAC3D,CAAuB,CAAC,aAAa,EAAE,KAAK,IAAI,CACjD,CAAC;AACH,CAAC"}

package/dist/batch/batch-session.d.ts

@@ -0,0 +1,29 @@
+/**
+ * BatchSession - Persists batch job state to .valora/batches/<localId>.json
+ */
+import type { PersistedBatch } from './batch.types.js';
+/**
+ * Generate a short unique local ID for a batch job
+ */
+export declare function generateLocalId(): string;
+/**
+ * Persist a batch to disk
+ */
+export declare function persistBatch(batch: PersistedBatch): void;
+/**
+ * Load a batch from disk by local ID
+ */
+export declare function loadBatch(localId: string): null | PersistedBatch;
+/**
+ * Update a persisted batch with partial data
+ */
+export declare function updateBatch(localId: string, partial: Partial<PersistedBatch>): void;
+/**
+ * List all persisted batches
+ */
+export declare function listBatches(): PersistedBatch[];
+/**
+ * Remove a persisted batch from disk
+ */
+export declare function removeBatch(localId: string): void;
+//# sourceMappingURL=batch-session.d.ts.map

package/dist/batch/batch-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-session.d.ts","sourceRoot":"","sources":["../../src/batch/batch-session.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAgBpD;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAIxD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,CAWhE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAMnF;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,cAAc,EAAE,CAe9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKjD"}

package/dist/batch/batch-session.js

@@ -0,0 +1,91 @@
+/**
+ * BatchSession - Persists batch job state to .valora/batches/<localId>.json
+ */
+import { createHash, randomBytes } from 'crypto';
+import { existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { getLogger } from '../output/logger.js';
+import { getRuntimeDataDir } from '../utils/paths.js';
+const getBatchDir = () => join(getRuntimeDataDir(), 'batches');
+function batchFilePath(localId) {
+    return join(getBatchDir(), `${localId}.json`);
+}
+function ensureBatchDir() {
+    const dir = getBatchDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+/**
+ * Generate a short unique local ID for a batch job
+ */
+export function generateLocalId() {
+    return createHash('sha256')
+        .update(`${Date.now()}-${randomBytes(8).toString('hex')}`)
+        .digest('hex')
+        .substring(0, 16);
+}
+/**
+ * Persist a batch to disk
+ */
+export function persistBatch(batch) {
+    const dir = ensureBatchDir();
+    const filePath = join(dir, `${batch.localId}.json`);
+    writeFileSync(filePath, JSON.stringify(batch, null, 2), 'utf-8');
+}
+/**
+ * Load a batch from disk by local ID
+ */
+export function loadBatch(localId) {
+    const filePath = batchFilePath(localId);
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch (error) {
+        getLogger().warn(`Failed to load batch ${localId}`, { error: error.message });
+        return null;
+    }
+}
+/**
+ * Update a persisted batch with partial data
+ */
+export function updateBatch(localId, partial) {
+    const existing = loadBatch(localId);
+    if (!existing) {
+        throw new Error(`Batch not found: ${localId}`);
+    }
+    persistBatch({ ...existing, ...partial });
+}
+/**
+ * List all persisted batches
+ */
+export function listBatches() {
+    const dir = getBatchDir();
+    if (!existsSync(dir)) {
+        return [];
+    }
+    const files = readdirSync(dir).filter((f) => f.endsWith('.json'));
+    const batches = [];
+    for (const file of files) {
+        const localId = file.replace('.json', '');
+        const batch = loadBatch(localId);
+        if (batch) {
+            batches.push(batch);
+        }
+    }
+    return batches;
+}
+/**
+ * Remove a persisted batch from disk
+ */
+export function removeBatch(localId) {
+    const filePath = batchFilePath(localId);
+    if (existsSync(filePath)) {
+        unlinkSync(filePath);
+    }
+}
+//# sourceMappingURL=batch-session.js.map

package/dist/batch/batch-session.js.map

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