@miller-tech/uap 1.30.1 → 1.32.0

package/dist/delivery/halo-trace.js

@@ -0,0 +1,88 @@
+/**
+ * HALO Delivery Tracer — observability for the convergence loop
+ *
+ * Emits delivery runs as HALO/OpenInference spans so `uap harness analyze`
+ * can mine systemic failure modes across runs (which gates dominate, where
+ * turns stall, which strategies win). One AGENT span per run, one CHAIN span
+ * per turn, parented to the run.
+ *
+ * Inherits the exporter's guarantees: zero overhead when tracing is disabled
+ * and never throws into the loop.
+ */
+import { isHaloTracingEnabled, newSpanId, recordHaloSpan, } from '../observability/halo-exporter.js';
+const MAX_ERROR_CHARS = 1_000;
+/**
+ * Error strings can embed model-controlled text (rejected file-block paths,
+ * HTTP payloads). Strip control characters and cap length before persisting
+ * to the trace file — `uap harness analyze` replays these into an LLM, so
+ * they must be treated as untrusted data, never as raw instructions.
+ */
+function sanitizeError(text) {
+    /* eslint-disable no-control-regex */
+    return text
+        .replace(/\x1b\[[0-9;]*[A-Za-z]/g, '')
+        .replace(/[\x00-\x08\x0b\x0c\x0e-\x1f]/g, '')
+        .slice(0, MAX_ERROR_CHARS);
+    /* eslint-enable no-control-regex */
+}
+/**
+ * Create a tracer for a single delivery run. All emission is gated on
+ * isHaloTracingEnabled(), so constructing one unconditionally is free.
+ */
+export function createHaloDeliveryTracer(options) {
+    const runSpanId = newSpanId();
+    const runStart = Date.now();
+    return {
+        onIteration(record) {
+            if (!isHaloTracingEnabled())
+                return;
+            const end = Date.now();
+            recordHaloSpan({
+                kind: 'CHAIN',
+                name: `delivery.turn.${record.turn}`,
+                startTimeMs: end - record.durationMs,
+                endTimeMs: end,
+                ok: record.passed,
+                parentSpanId: runSpanId,
+                attributes: {
+                    'delivery.turn': record.turn,
+                    'delivery.score': record.score,
+                    'delivery.files_applied': record.filesApplied.length,
+                    ...(record.strategy ? { 'delivery.strategy': record.strategy } : {}),
+                    ...(record.candidates ? { 'delivery.candidates': record.candidates.length } : {}),
+                    ...(record.executorError
+                        ? { 'delivery.executor_error': sanitizeError(record.executorError) }
+                        : {}),
+                    ...(record.applyError ? { 'delivery.apply_error': sanitizeError(record.applyError) } : {}),
+                    'delivery.gates_failed': record.gateResults
+                        .filter((g) => !g.passed && !g.skipped)
+                        .map((g) => g.id)
+                        .join(','),
+                },
+            });
+        },
+        finish(result) {
+            if (!isHaloTracingEnabled())
+                return;
+            recordHaloSpan({
+                kind: 'AGENT',
+                name: 'agent.deliver',
+                startTimeMs: runStart,
+                endTimeMs: Date.now(),
+                ok: result.success,
+                spanId: runSpanId,
+                attributes: {
+                    'agent.name': 'deliver',
+                    'delivery.instruction': options.instruction.slice(0, 500),
+                    'delivery.model': options.modelId,
+                    'delivery.project_root': options.projectRoot,
+                    'delivery.turns': result.turns,
+                    'delivery.best_score': result.bestScore,
+                    'delivery.best_turn': result.bestTurn,
+                    'delivery.already_delivered': result.alreadyDelivered,
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=halo-trace.js.map

package/dist/delivery/halo-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"halo-trace.js","sourceRoot":"","sources":["../../src/delivery/halo-trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,cAAc,GACf,MAAM,mCAAmC,CAAC;AAgB3C,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B;;;;;GAKG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,qCAAqC;IACrC,OAAO,IAAI;SACR,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC;SACrC,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC;SAC5C,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IAC7B,oCAAoC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAkC;IACzE,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE5B,OAAO;QACL,WAAW,CAAC,MAAuB;YACjC,IAAI,CAAC,oBAAoB,EAAE;gBAAE,OAAO;YACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,cAAc,CAAC;gBACb,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,iBAAiB,MAAM,CAAC,IAAI,EAAE;gBACpC,WAAW,EAAE,GAAG,GAAG,MAAM,CAAC,UAAU;gBACpC,SAAS,EAAE,GAAG;gBACd,EAAE,EAAE,MAAM,CAAC,MAAM;gBACjB,YAAY,EAAE,SAAS;gBACvB,UAAU,EAAE;oBACV,eAAe,EAAE,MAAM,CAAC,IAAI;oBAC5B,gBAAgB,EAAE,MAAM,CAAC,KAAK;oBAC9B,wBAAwB,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM;oBACpD,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpE,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACjF,GAAG,CAAC,MAAM,CAAC,aAAa;wBACtB,CAAC,CAAC,EAAE,yBAAyB,EAAE,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;wBACpE,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC1F,uBAAuB,EAAE,MAAM,CAAC,WAAW;yBACxC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;yBACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBAChB,IAAI,CAAC,GAAG,CAAC;iBACb;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,MAAsB;YAC3B,IAAI,CAAC,oBAAoB,EAAE;gBAAE,OAAO;YACpC,cAAc,CAAC;gBACb,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,QAAQ;gBACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,EAAE,EAAE,MAAM,CAAC,OAAO;gBAClB,MAAM,EAAE,SAAS;gBACjB,UAAU,EAAE;oBACV,YAAY,EAAE,SAAS;oBACvB,sBAAsB,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBACzD,gBAAgB,EAAE,OAAO,CAAC,OAAO;oBACjC,uBAAuB,EAAE,OAAO,CAAC,WAAW;oBAC5C,gBAAgB,EAAE,MAAM,CAAC,KAAK;oBAC9B,qBAAqB,EAAE,MAAM,CAAC,SAAS;oBACvC,oBAAoB,EAAE,MAAM,CAAC,QAAQ;oBACrC,4BAA4B,EAAE,MAAM,CAAC,gBAAgB;iBACtD;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/delivery/ideation.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Ideation Seeder — divergent strategy seeds for exploration (open-collider)
+ *
+ * Connects `uap ideate` divergent ideation to the delivery loop. Instead of
+ * the four static DEFAULT_STRATEGY_SEEDS, the seeder produces task-specific,
+ * deliberately diverse strategy hints for the best-of-N explorer:
+ *
+ *  - generateStrategySeeds: one Koestler-bisociation-style model call that
+ *    asks for N structurally distinct implementation approaches
+ *  - seedsFromIdeas: convert curated ideas (e.g. an open-collider project's
+ *    curated_ideas.json) into strategy seeds directly
+ *
+ * Both are fail-soft: any parse/model failure falls back to the default
+ * static seeds so ideation can never block delivery.
+ */
+import type { LoopExecutor } from './convergence-loop.js';
+import type { StrategySeed } from './explorer.js';
+export interface IdeationOptions {
+    /** Number of seeds to request (default 4, capped at MAX_CANDIDATES) */
+    count?: number;
+}
+/** Extract the first JSON array of {id, hint} objects from model output. */
+export declare function parseSeedArray(text: string): StrategySeed[];
+/**
+ * Generate task-specific divergent strategy seeds via one model call.
+ * Falls back to DEFAULT_STRATEGY_SEEDS on any failure — ideation is an
+ * outcome optimizer, never a blocker.
+ */
+export declare function generateStrategySeeds(instruction: string, executor: LoopExecutor, options?: IdeationOptions): Promise<StrategySeed[]>;
+/**
+ * Convert curated ideas (plain strings, e.g. from an open-collider project's
+ * curated_ideas.json via `uap ideate ideas`) into explorer strategy seeds.
+ * Returns [] when no usable ideas are provided so callers can fall back.
+ */
+export declare function seedsFromIdeas(ideas: string[], options?: IdeationOptions): StrategySeed[];
+//# sourceMappingURL=ideation.d.ts.map

package/dist/delivery/ideation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ideation.d.ts","sourceRoot":"","sources":["../../src/delivery/ideation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqBD,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CA6B3D;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,YAAY,EAAE,CAAC,CAYzB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,eAAoB,GAAG,YAAY,EAAE,CAY7F"}

package/dist/delivery/ideation.js

@@ -0,0 +1,109 @@
+/**
+ * Ideation Seeder — divergent strategy seeds for exploration (open-collider)
+ *
+ * Connects `uap ideate` divergent ideation to the delivery loop. Instead of
+ * the four static DEFAULT_STRATEGY_SEEDS, the seeder produces task-specific,
+ * deliberately diverse strategy hints for the best-of-N explorer:
+ *
+ *  - generateStrategySeeds: one Koestler-bisociation-style model call that
+ *    asks for N structurally distinct implementation approaches
+ *  - seedsFromIdeas: convert curated ideas (e.g. an open-collider project's
+ *    curated_ideas.json) into strategy seeds directly
+ *
+ * Both are fail-soft: any parse/model failure falls back to the default
+ * static seeds so ideation can never block delivery.
+ */
+import { DEFAULT_STRATEGY_SEEDS, MAX_CANDIDATES } from './explorer.js';
+const DEFAULT_SEED_COUNT = 4;
+const MAX_HINT_CHARS = 400;
+function buildIdeationPrompt(instruction, count) {
+    return [
+        'You are a divergent-ideation engine (Koestler bisociation). For the task',
+        'below, propose structurally DISTINCT implementation strategies — each one',
+        'must approach the problem from a different region of solution space.',
+        'Avoid minor variations of the same obvious approach; collide the task',
+        'with distant framings (data-flow first, contract first, smallest diff,',
+        'rewrite from scratch, defensive edge-case first, etc.).',
+        '',
+        `TASK: ${instruction}`,
+        '',
+        `Respond with ONLY a JSON array of exactly ${count} objects:`,
+        '[{"id": "<kebab-case-slug>", "hint": "STRATEGY: <one or two imperative sentences>"}]',
+    ].join('\n');
+}
+/** Extract the first JSON array of {id, hint} objects from model output. */
+export function parseSeedArray(text) {
+    // Anchor on an array of objects so brackets in surrounding prose
+    // ("[done]", markdown links) can't corrupt the slice; try the lazy match
+    // first, then the greedy one for arrays whose objects contain ']'.
+    let parsed;
+    for (const re of [/\[\s*\{[\s\S]*?\}\s*\]/, /\[\s*\{[\s\S]*\}\s*\]/]) {
+        const match = text.match(re);
+        if (!match)
+            continue;
+        try {
+            parsed = JSON.parse(match[0]);
+            break;
+        }
+        catch {
+            parsed = undefined;
+        }
+    }
+    if (!Array.isArray(parsed))
+        return [];
+    const seen = new Set();
+    const seeds = [];
+    for (const entry of parsed) {
+        if (typeof entry !== 'object' || entry === null)
+            continue;
+        const { id, hint } = entry;
+        if (typeof id !== 'string' || typeof hint !== 'string')
+            continue;
+        const slug = id.trim().toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '');
+        if (!slug || !hint.trim() || seen.has(slug))
+            continue;
+        seen.add(slug);
+        seeds.push({ id: slug, hint: hint.trim().slice(0, MAX_HINT_CHARS) });
+    }
+    return seeds;
+}
+/**
+ * Generate task-specific divergent strategy seeds via one model call.
+ * Falls back to DEFAULT_STRATEGY_SEEDS on any failure — ideation is an
+ * outcome optimizer, never a blocker.
+ */
+export async function generateStrategySeeds(instruction, executor, options = {}) {
+    const count = Math.min(MAX_CANDIDATES, Math.max(2, options.count ?? DEFAULT_SEED_COUNT));
+    try {
+        const raw = await executor(buildIdeationPrompt(instruction, count));
+        const seeds = parseSeedArray(raw);
+        // Require at least two usable seeds — one seed defeats the purpose of
+        // divergent exploration and signals a degenerate model response.
+        if (seeds.length >= 2)
+            return seeds.slice(0, count);
+    }
+    catch {
+        // fall through to defaults
+    }
+    return DEFAULT_STRATEGY_SEEDS;
+}
+/**
+ * Convert curated ideas (plain strings, e.g. from an open-collider project's
+ * curated_ideas.json via `uap ideate ideas`) into explorer strategy seeds.
+ * Returns [] when no usable ideas are provided so callers can fall back.
+ */
+export function seedsFromIdeas(ideas, options = {}) {
+    const count = Math.min(MAX_CANDIDATES, Math.max(2, options.count ?? DEFAULT_SEED_COUNT));
+    const seeds = [];
+    for (let i = 0; i < ideas.length && seeds.length < count; i++) {
+        const idea = ideas[i]?.trim();
+        if (!idea)
+            continue;
+        seeds.push({
+            id: `idea-${seeds.length + 1}`,
+            hint: `STRATEGY: Apply this curated idea to the task — ${idea.slice(0, MAX_HINT_CHARS)}`,
+        });
+    }
+    return seeds.length >= 2 ? seeds : [];
+}
+//# sourceMappingURL=ideation.js.map

package/dist/delivery/ideation.js.map

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

package/dist/delivery/index.d.ts

@@ -5,7 +5,7 @@
  * iterations against the project's real completion gates until delivery
  * is achieved.
  */
-export { ConvergenceLoop, defaultPromptBuilder, type CandidateSummary, type ConvergenceConfig, type DeliveryResult, type ExplorerSettings, type IterationDirective, type IterationRecord, type LoopExecutor, type LadderRunner, type OnIteration, type PracticeProvider, type PromptBuilder, type PromptContext, } from './convergence-loop.js';
+export { ConvergenceLoop, composeIterationHooks, defaultPromptBuilder, type CandidateSummary, type ConvergenceConfig, type DeliveryResult, type ExplorerSettings, type IterationDirective, type IterationRecord, type LoopExecutor, type LadderRunner, type OnIteration, type PracticeProvider, type PromptBuilder, type PromptContext, } from './convergence-loop.js';
 export { createEscalationController, defaultEscalationLadder, type DefaultLadderOptions, type EscalationConfig, type EscalationController, type EscalationTier, } from './escalation.js';
 export { InMemoryPracticeStore, FilePracticeStore, extractKeywords, distillPractice, defaultPracticePath, retrievePracticesSemantic, type PracticeCard, type PracticeInput, type PracticeStore, type SemanticRetriever, type SemanticRetrieveOptions, } from './practice.js';
 export { exploreAndCommit, DEFAULT_STRATEGY_SEEDS, MAX_CANDIDATES, type CandidateResult, type ExplorationResult, type ExplorerConfig, type StrategySeed, } from './explorer.js';
@@ -13,5 +13,9 @@ export { createModelJudge, extractJson, type Judge, type JudgeCandidate, type Ju
 export { createModelCritic, parseFixList, type Critic, type Critique, type CritiqueInput, } from './critic.js';
 export { detectRungs, runLadder, runRung, formatFeedback, type GateRung, type RungResult, type RungFailureReason, type LadderResult, type LadderOptions, } from './verifier-ladder.js';
 export { applyFileBlocks, applyFileBlocksWithRollback, parseFileBlocks, type Applier, type ApplyResult, type FileBlock, type RevertibleApply, } from './applier.js';
+export { planAutoOptimization, DELIVERY_COMPLEXITY_THRESHOLDS, type AutoPlan, type DeliveryComplexity, } from './auto-optimizer.js';
+export { generateStrategySeeds, parseSeedArray, seedsFromIdeas, type IdeationOptions, } from './ideation.js';
+export { createHaloDeliveryTracer, type HaloDeliveryTracer, type HaloDeliveryTracerOptions, } from './halo-trace.js';
+export { createRunCoordinator, collectAppliedFiles, type RunCoordinator, type RunCoordinatorOptions, } from './run-coordinator.js';
 export { OpenAICompatClient, type OpenAICompatClientOptions } from '../models/openai-compat-client.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,SAAS,EACT,OAAO,EACP,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,eAAe,EACf,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,KAAK,KAAK,EACV,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,SAAS,EACT,OAAO,EACP,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,eAAe,EACf,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,8BAA8B,EAC9B,KAAK,QAAQ,EACb,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/delivery/index.js

@@ -5,7 +5,7 @@
  * iterations against the project's real completion gates until delivery
  * is achieved.
  */
-export { ConvergenceLoop, defaultPromptBuilder, } from './convergence-loop.js';
+export { ConvergenceLoop, composeIterationHooks, defaultPromptBuilder, } from './convergence-loop.js';
 export { createEscalationController, defaultEscalationLadder, } from './escalation.js';
 export { InMemoryPracticeStore, FilePracticeStore, extractKeywords, distillPractice, defaultPracticePath, retrievePracticesSemantic, } from './practice.js';
 export { exploreAndCommit, DEFAULT_STRATEGY_SEEDS, MAX_CANDIDATES, } from './explorer.js';
@@ -13,5 +13,9 @@ export { createModelJudge, extractJson, } from './judge.js';
 export { createModelCritic, parseFixList, } from './critic.js';
 export { detectRungs, runLadder, runRung, formatFeedback, } from './verifier-ladder.js';
 export { applyFileBlocks, applyFileBlocksWithRollback, parseFileBlocks, } from './applier.js';
+export { planAutoOptimization, DELIVERY_COMPLEXITY_THRESHOLDS, } from './auto-optimizer.js';
+export { generateStrategySeeds, parseSeedArray, seedsFromIdeas, } from './ideation.js';
+export { createHaloDeliveryTracer, } from './halo-trace.js';
+export { createRunCoordinator, collectAppliedFiles, } from './run-coordinator.js';
 export { OpenAICompatClient } from '../models/openai-compat-client.js';
 //# sourceMappingURL=index.js.map

package/dist/delivery/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,eAAe,EACf,oBAAoB,GAarB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GAKxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,yBAAyB,GAM1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,GAKf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,WAAW,GAIZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,YAAY,GAIb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,SAAS,EACT,OAAO,EACP,cAAc,GAMf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,eAAe,GAKhB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,kBAAkB,EAAkC,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,oBAAoB,GAarB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GAKxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,yBAAyB,GAM1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,GAKf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,WAAW,GAIZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,YAAY,GAIb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,WAAW,EACX,SAAS,EACT,OAAO,EACP,cAAc,GAMf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,eAAe,EACf,2BAA2B,EAC3B,eAAe,GAKhB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,oBAAoB,EACpB,8BAA8B,GAG/B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,cAAc,GAEf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,wBAAwB,GAGzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,GAGpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAkC,MAAM,mCAAmC,CAAC"}

package/dist/delivery/run-coordinator.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Delivery Run Coordinator — `uap agent` + `uap deploy` integration
+ *
+ * Makes a delivery run a first-class citizen of the multi-agent coordination
+ * layer:
+ *
+ *  - registers an ephemeral agent for the run (visible in `uap agent status`)
+ *  - announces work intent on the project root (overlap detection warns
+ *    other agents — and this run — about concurrent edits)
+ *  - heartbeats every loop turn so the run never shows as stale
+ *  - marks work complete and deregisters when the loop finishes
+ *  - on success, can queue a commit of the applied files into the deploy
+ *    batcher (`uap deploy status` / `uap deploy flush`)
+ *
+ * Everything is fail-soft via lazy imports: a missing/locked coordination DB
+ * degrades to a no-op coordinator rather than blocking delivery.
+ */
+import type { DeliveryResult, IterationRecord } from './convergence-loop.js';
+export interface RunCoordinator {
+    /** Agent id registered for this run; null when coordination is degraded. */
+    readonly agentId: string | null;
+    /** Overlap warnings returned by the work announcement (may be empty). */
+    readonly overlapWarnings: string[];
+    /** Heartbeat + status update per loop turn (wire into onIteration). */
+    onIteration(record: IterationRecord): void;
+    /** Complete the announced work and deregister the agent. */
+    finish(result: DeliveryResult): Promise<void>;
+    /** Queue a commit of the run's applied files into the deploy batcher. */
+    queueDeploy(result: DeliveryResult, message: string): Promise<number | null>;
+}
+export interface RunCoordinatorOptions {
+    instruction: string;
+    projectRoot: string;
+    modelId: string;
+    /** Estimated minutes for the announcement (default 15) */
+    estimatedMinutes?: number;
+    /** Coordination DB override (tests); defaults to the shared coordination DB */
+    dbPath?: string;
+}
+/** All files the loop applied across its iteration history, deduplicated. */
+export declare function collectAppliedFiles(result: DeliveryResult): string[];
+/**
+ * Register this delivery run with the coordination service and announce its
+ * work. Returns a no-op coordinator when the coordination layer is
+ * unavailable — delivery must never fail because coordination did.
+ */
+export declare function createRunCoordinator(options: RunCoordinatorOptions): Promise<RunCoordinator>;
+//# sourceMappingURL=run-coordinator.d.ts.map

package/dist/delivery/run-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-coordinator.d.ts","sourceRoot":"","sources":["../../src/delivery/run-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,yEAAyE;IACzE,QAAQ,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;IACnC,uEAAuE;IACvE,WAAW,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C,4DAA4D;IAC5D,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,yEAAyE;IACzE,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAUD,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAMpE;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,cAAc,CAAC,CA+FzB"}

package/dist/delivery/run-coordinator.js

@@ -0,0 +1,132 @@
+/**
+ * Delivery Run Coordinator — `uap agent` + `uap deploy` integration
+ *
+ * Makes a delivery run a first-class citizen of the multi-agent coordination
+ * layer:
+ *
+ *  - registers an ephemeral agent for the run (visible in `uap agent status`)
+ *  - announces work intent on the project root (overlap detection warns
+ *    other agents — and this run — about concurrent edits)
+ *  - heartbeats every loop turn so the run never shows as stale
+ *  - marks work complete and deregisters when the loop finishes
+ *  - on success, can queue a commit of the applied files into the deploy
+ *    batcher (`uap deploy status` / `uap deploy flush`)
+ *
+ * Everything is fail-soft via lazy imports: a missing/locked coordination DB
+ * degrades to a no-op coordinator rather than blocking delivery.
+ */
+const NOOP = {
+    agentId: null,
+    overlapWarnings: [],
+    onIteration: () => undefined,
+    finish: async () => undefined,
+    queueDeploy: async () => null,
+};
+/** All files the loop applied across its iteration history, deduplicated. */
+export function collectAppliedFiles(result) {
+    const files = new Set();
+    for (const record of result.history) {
+        for (const f of record.filesApplied)
+            files.add(f);
+    }
+    return [...files];
+}
+/**
+ * Register this delivery run with the coordination service and announce its
+ * work. Returns a no-op coordinator when the coordination layer is
+ * unavailable — delivery must never fail because coordination did.
+ */
+export async function createRunCoordinator(options) {
+    let registeredId = null;
+    let registeredService = null;
+    try {
+        const { CoordinationService } = await import('../coordination/service.js');
+        const service = new CoordinationService(options.dbPath ? { dbPath: options.dbPath } : {});
+        const agentId = service.register(`uap-deliver-${options.modelId}`, [
+            'delivery',
+            'convergence-loop',
+        ]);
+        registeredId = agentId;
+        registeredService = service;
+        service.updateStatus(agentId, 'active', options.instruction.slice(0, 200));
+        const { overlaps } = service.announceWork(agentId, options.projectRoot, 'editing', {
+            description: `uap deliver: ${options.instruction.slice(0, 200)}`,
+            estimatedMinutes: options.estimatedMinutes ?? 15,
+        });
+        const overlapWarnings = overlaps.map((o) => {
+            const who = o.agents.map((a) => `${a.name} (${a.intentType})`).join(', ');
+            return `${o.resource}: ${who} — ${o.conflictRisk} risk. ${o.suggestion}`;
+        });
+        // A single loop turn (model call + full gate run) routinely exceeds the
+        // stale-agent cutoff, so heartbeat on a timer too — not just per turn —
+        // or concurrent cleanup would mark this run stale mid-turn. unref() so
+        // the timer never keeps the process alive.
+        const heartbeatTimer = setInterval(() => {
+            try {
+                service.heartbeat(agentId);
+            }
+            catch {
+                // Heartbeat is best-effort
+            }
+        }, 30_000);
+        heartbeatTimer.unref?.();
+        return {
+            agentId,
+            overlapWarnings,
+            onIteration(record) {
+                try {
+                    service.heartbeat(agentId);
+                    service.updateStatus(agentId, 'active', `turn ${record.turn}: ${Math.round(record.score * 100)}% of gates`);
+                }
+                catch {
+                    // Heartbeat is best-effort
+                }
+            },
+            async finish(result) {
+                clearInterval(heartbeatTimer);
+                try {
+                    service.completeWork(agentId, options.projectRoot);
+                    service.updateStatus(agentId, 'completed', result.success ? `delivered in ${result.turns} turn(s)` : 'not delivered');
+                    service.deregister(agentId);
+                }
+                catch {
+                    // Cleanup is best-effort
+                }
+            },
+            async queueDeploy(result, message) {
+                if (!result.success)
+                    return null;
+                try {
+                    const { DeployBatcher } = await import('../coordination/deploy-batcher.js');
+                    const batcher = new DeployBatcher(options.dbPath ? { dbPath: options.dbPath } : {});
+                    const files = collectAppliedFiles(result);
+                    if (files.length === 0)
+                        return null;
+                    return await batcher.queue(agentId, 'commit', options.projectRoot, {
+                        message,
+                        files,
+                        cwd: options.projectRoot,
+                        source: 'uap-deliver',
+                    });
+                }
+                catch {
+                    return null;
+                }
+            },
+        };
+    }
+    catch {
+        // If registration succeeded but a later step threw, don't leak an
+        // 'active' phantom agent into the registry.
+        if (registeredId && registeredService) {
+            try {
+                registeredService.deregister(registeredId);
+            }
+            catch {
+                // best-effort
+            }
+        }
+        return NOOP;
+    }
+}
+//# sourceMappingURL=run-coordinator.js.map

package/dist/delivery/run-coordinator.js.map

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

package/dist/memory/dynamic-retrieval.d.ts

@@ -13,9 +13,15 @@ import { type TaskClassification } from './task-classifier.js';
 import { type ContextDecision, type TaskMetadata } from './adaptive-context.js';
 import { type AmbiguityResult } from './ambiguity-detector.js';
 /**
- * Query complexity levels for adaptive retrieval
+ * Query complexity levels for adaptive retrieval. The scorer lives in the
+ * dependency-free utils module so non-memory consumers (delivery harness)
+ * can classify without loading this module's DB machinery; re-exported here
+ * for backward compatibility.
  */
-export type QueryComplexity = 'simple' | 'moderate' | 'complex';
+import { measureQueryComplexity } from '../utils/query-complexity.js';
+import type { QueryComplexity } from '../utils/query-complexity.js';
+export { measureQueryComplexity };
+export type { QueryComplexity };
 /**
  * Retrieval depth configuration
  */
@@ -39,11 +45,6 @@ export interface RetrievalDepthConfig {
         patterns: number;
     };
 }
-/**
- * Measure query complexity to determine retrieval depth
- * Based on SimpleMem's adaptive query-aware retrieval
- */
-export declare function measureQueryComplexity(query: string): QueryComplexity;
 /**
  * Get retrieval limits based on query complexity
  */

package/dist/memory/dynamic-retrieval.d.ts.map

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

package/dist/memory/dynamic-retrieval.js

@@ -87,63 +87,19 @@ const dbPoolCleanupInterval = setInterval(() => {
     trimFileCache();
 }, 60_000);
 dbPoolCleanupInterval.unref();
+/**
+ * Query complexity levels for adaptive retrieval. The scorer lives in the
+ * dependency-free utils module so non-memory consumers (delivery harness)
+ * can classify without loading this module's DB machinery; re-exported here
+ * for backward compatibility.
+ */
+import { measureQueryComplexity } from '../utils/query-complexity.js';
+export { measureQueryComplexity };
 const DEFAULT_RETRIEVAL_DEPTHS = {
     simple: { shortTerm: 3, sessionMem: 2, longTerm: 5, patterns: 3 },
     moderate: { shortTerm: 6, sessionMem: 5, longTerm: 8, patterns: 5 },
     complex: { shortTerm: 10, sessionMem: 8, longTerm: 15, patterns: 8 },
 };
-/**
- * Measure query complexity to determine retrieval depth
- * Based on SimpleMem's adaptive query-aware retrieval
- */
-export function measureQueryComplexity(query) {
-    let score = 0;
-    // Length-based scoring (lower thresholds)
-    const wordCount = query.split(/\s+/).length;
-    if (wordCount > 30)
-        score += 1.5;
-    else if (wordCount > 12)
-        score += 0.75;
-    else if (wordCount > 6)
-        score += 0.25;
-    // Technical terms increase complexity
-    const techPatterns = [
-        /debug|fix|error|exception|bug/i,
-        /implement|refactor|optimize|build/i,
-        /configure|setup|install|deploy/i,
-        /security|vulnerability|cve|auth/i,
-        /performance|memory|cpu|latency/i,
-        /database|query|migration|schema/i,
-        /test|coverage|mock|spec/i,
-    ];
-    for (const pattern of techPatterns) {
-        if (pattern.test(query))
-            score += 0.4;
-    }
-    // Multiple entities/files increase complexity
-    const fileMatches = query.match(/[\w./\\-]+\.(ts|js|py|json|yaml|sh|sql)/gi);
-    if (fileMatches) {
-        score += fileMatches.length * 0.3;
-    }
-    // Multi-step tasks are complex
-    if (/and then|after that|followed by|step \d|first.*then|also|additionally/i.test(query)) {
-        score += 1;
-    }
-    // Questions about "why" or "how" are moderate
-    if (/^(why|how|what caused|explain)/i.test(query)) {
-        score += 0.5;
-    }
-    // Multiple actions in one query
-    const actionWords = query.match(/\b(fix|implement|configure|debug|create|update|delete|add|remove)\b/gi);
-    if (actionWords && actionWords.length > 1) {
-        score += actionWords.length * 0.3;
-    }
-    if (score >= 2)
-        return 'complex';
-    if (score >= 1)
-        return 'moderate';
-    return 'simple';
-}
 /**
  * Get retrieval limits based on query complexity
  */