@calliopelabs/cli 3.1.0 → 3.2.1

package/dist/goals/index.js

@@ -0,0 +1,16 @@
+export * from './types.js';
+export * from './validation.js';
+export * from './journal.js';
+export * from './store.js';
+export * from './authority.js';
+export * from './contracts.js';
+export * from './actions.js';
+export * from './cli.js';
+export * from './team.js';
+export * from './supervised.js';
+export * from './supervised-cli.js';
+export * from './repair.js';
+export * from './accounting.js';
+export * from './metrics.js';
+export { validateGoalRouting, loadGoalRouting } from './routing.js';
+//# sourceMappingURL=index.js.map

package/dist/goals/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/goals/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAC,mBAAmB,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC"}

package/dist/goals/journal.d.ts

@@ -0,0 +1,5 @@
+import type { GoalManifest, GoalEvent, GoalProjection } from './types.js';
+export declare const goalHistoryHash: (manifest: GoalManifest, events: GoalEvent[]) => string;
+export declare function validateGoalEvent(value: unknown, manifest: GoalManifest): GoalEvent;
+export declare function replayGoal(manifest: GoalManifest, events: GoalEvent[]): GoalProjection;
+//# sourceMappingURL=journal.d.ts.map

package/dist/goals/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../../src/goals/journal.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,YAAY,EAAC,SAAS,EAAC,cAAc,EAAC,MAAM,YAAY,CAAC;AAEtE,eAAO,MAAM,eAAe,aAAW,YAAY,UAAQ,SAAS,EAAE,WAAmF,CAAC;AAC1J,wBAAgB,iBAAiB,CAAC,KAAK,EAAC,OAAO,EAAC,QAAQ,EAAC,YAAY,GAAE,SAAS,CAY/E;AACD,wBAAgB,UAAU,CAAC,QAAQ,EAAC,YAAY,EAAC,MAAM,EAAC,SAAS,EAAE,GAAE,cAAc,CAqBlF"}

package/dist/goals/journal.js

@@ -0,0 +1,142 @@
+import { canonicalJson, digest } from '../approvals/index.js';
+import { shape, integer, iso, uuid, hex, array, text, fail } from '../orchestration/validation.js';
+import { OrchestrationError } from '../orchestration/types.js';
+import { validateGoalManifest, validateAllocation, validatePlanningSpend, verifyHash, MAX_GOAL_EVENTS, MAX_GOAL_EVENT_BYTES } from './validation.js';
+export const goalHistoryHash = (manifest, events) => digest(canonicalJson({ manifestHash: manifest.hash, events: events.map(e => e.hash) }));
+export function validateGoalEvent(value, manifest) {
+    shape(value, ['version', 'id', 'goalId', 'sequence', 'at', 'previous', 'change', 'hash']);
+    if (value.version !== 1 || !uuid(value.id) || value.goalId !== manifest.id || !iso(value.at) || !hex(value.previous))
+        fail('Invalid goal event.');
+    integer(value.sequence, 1, MAX_GOAL_EVENTS);
+    shape(value.change, ['type'], ['allocation', 'status', 'spend', 'proposalHash', 'reason', 'source', 'runId', 'revision', 'completed', 'total']);
+    const c = value.change;
+    if (c.type === 'planning_allocated') {
+        shape(c, ['type', 'allocation']);
+        validateAllocation(c.allocation, manifest, 'planning');
+    }
+    else if (c.type === 'planning_finished') {
+        shape(c, ['type', 'status', 'spend', 'proposalHash', 'reason']);
+        if (!['review_required', 'failed', 'denied', 'cancelled'].includes(String(c.status)) || c.proposalHash !== null && !hex(c.proposalHash))
+            fail('Invalid planning outcome.');
+        if (c.spend !== null)
+            validatePlanningSpend(c.spend);
+        text(c.reason);
+    }
+    else if (c.type === 'proposal_revised') {
+        shape(c, ['type', 'proposalHash']);
+        if (!hex(c.proposalHash))
+            fail('Invalid revised proposal.');
+    }
+    else if (c.type === 'execution_allocated') {
+        shape(c, ['type', 'allocation', 'proposalHash', 'source']);
+        validateAllocation(c.allocation, manifest, 'execution');
+        if (!hex(c.proposalHash) || !['cli', 'repl'].includes(String(c.source)))
+            fail('Invalid plan approval.');
+    }
+    else if (c.type === 'execution_started') {
+        shape(c, ['type', 'runId']);
+        if (!uuid(c.runId))
+            fail('Invalid execution run.');
+    }
+    else if (c.type === 'execution_interrupted') {
+        shape(c, ['type', 'runId', 'status', 'reason']);
+        if (!uuid(c.runId) || !['failed', 'denied', 'cancelled'].includes(String(c.status)))
+            fail('Invalid execution interruption.');
+        text(c.reason);
+    }
+    else if (c.type === 'execution_finished') {
+        shape(c, ['type', 'runId', 'revision', 'status', 'completed', 'total']);
+        if (!uuid(c.runId) || !hex(c.revision) || !['completed', 'partial', 'failed', 'denied', 'cancelled'].includes(String(c.status)))
+            fail('Invalid execution evidence.');
+        integer(c.total, 1, manifest.limits.maxTasks);
+        integer(c.completed, 0, c.total);
+        if (c.status === 'completed' && c.completed !== c.total)
+            fail('Goal completion requires all task evidence.');
+    }
+    else if (c.type === 'cancelled') {
+        shape(c, ['type', 'source']);
+        if (!['cli', 'repl'].includes(String(c.source)))
+            fail('Invalid cancellation source.');
+    }
+    else
+        fail('Unknown goal event.');
+    verifyHash(value);
+    if (Buffer.byteLength(JSON.stringify(value)) > MAX_GOAL_EVENT_BYTES)
+        fail('Goal event exceeds its byte limit.');
+    return value;
+}
+export function replayGoal(manifest, events) {
+    validateGoalManifest(manifest);
+    array(events, MAX_GOAL_EVENTS);
+    const state = { version: 1, id: manifest.id, revision: goalHistoryHash(manifest, []), status: 'created', revoked: false, planning: null, execution: null, planningSpend: null, planningFrozen: false, proposalHash: null, approvedProposalHash: null, result: null };
+    const seen = new Set();
+    let at = manifest.createdAt;
+    const conflict = (message) => { throw new OrchestrationError('conflict', message); };
+    for (const event of events) {
+        validateGoalEvent(event, manifest);
+        if (seen.has(event.id) || event.sequence !== seen.size + 1 || event.previous !== state.revision || event.at < at)
+            fail('Broken goal event ancestry.');
+        seen.add(event.id);
+        at = event.at;
+        const c = event.change;
+        if (c.type === 'planning_allocated') {
+            if (state.status !== 'created' || state.planning || Date.parse(at) >= c.allocation.deadline)
+                conflict('Goal cannot allocate a new planner.');
+            state.planning = c.allocation;
+            state.status = 'planning';
+        }
+        else if (c.type === 'planning_finished') {
+            if (!state.planning || state.planningFrozen || !['planning', 'cancelled'].includes(state.status))
+                conflict('Planning is already frozen or was never allocated.');
+            if (c.status === 'review_required' && (!c.proposalHash || !c.spend || c.spend.tokens > state.planning.tokens || c.spend.costNanos > state.planning.costNanos) || c.status !== 'review_required' && c.proposalHash !== null)
+                fail('A proposal requires bounded planning evidence.');
+            state.planningSpend = c.spend;
+            state.planningFrozen = true;
+            state.proposalHash = c.proposalHash;
+            if (state.status !== 'cancelled')
+                state.status = c.status;
+        }
+        else if (c.type === 'proposal_revised') {
+            if (!['review_required', 'failed', 'denied', 'cancelled'].includes(state.status) || state.revoked || state.execution || !state.planningFrozen || !state.planningSpend)
+                conflict('Only frozen, unallocated planning can be revised.');
+            state.proposalHash = c.proposalHash;
+            state.status = 'review_required';
+        }
+        else if (c.type === 'execution_allocated') {
+            if (state.status !== 'review_required' || state.execution || !state.planningSpend || state.proposalHash !== c.proposalHash || Date.parse(at) >= c.allocation.deadline || c.allocation.runId === state.planning.runId || c.allocation.id === state.planning.id)
+                conflict('Execution needs the current unallocated proposal and deadline.');
+            if (c.allocation.tokens > manifest.limits.tokenBudget - state.planningSpend.tokens || c.allocation.costNanos > manifest.limits.costBudgetNanos - state.planningSpend.costNanos)
+                conflict('Execution allocation exceeds remaining goal budget.');
+            state.execution = c.allocation;
+            state.approvedProposalHash = c.proposalHash;
+            state.status = 'approved';
+        }
+        else if (c.type === 'execution_started') {
+            if (!state.execution || c.runId !== state.execution.runId || state.revoked || state.status === 'completed' || Date.parse(at) >= state.execution.deadline)
+                conflict('Execution cannot start or refresh its deadline.');
+            state.status = 'running';
+        }
+        else if (c.type === 'execution_interrupted') {
+            if (!state.execution || c.runId !== state.execution.runId || state.status === 'completed')
+                conflict('Goal interruption belongs to another or completed execution.');
+            if (!state.revoked)
+                state.status = c.status;
+        }
+        else if (c.type === 'execution_finished') {
+            if (!state.execution || c.runId !== state.execution.runId)
+                conflict('Goal result belongs to another execution.');
+            state.result = { runId: c.runId, revision: c.revision, status: c.status, completed: c.completed, total: c.total };
+            if (!state.revoked)
+                state.status = c.status;
+        }
+        else if (c.type === 'cancelled') {
+            if (state.status === 'completed')
+                conflict('Completed goals cannot be cancelled.');
+            state.status = 'cancelled';
+            state.revoked = true;
+        }
+        state.revision = event.hash;
+    }
+    return state;
+}
+//# sourceMappingURL=journal.js.map

package/dist/goals/journal.js.map

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

package/dist/goals/metrics.d.ts

@@ -0,0 +1,53 @@
+import { type GoalAccounting } from './accounting.js';
+import type { GoalOptions } from './actions.js';
+export interface GoalMetrics {
+    version: 1;
+    kind: 'goal.metrics';
+    goalId: string;
+    goalRevision: string;
+    executionRevision: string | null;
+    accounting: GoalAccounting;
+    tasks: {
+        total: number;
+        mechanicallyVerified: number;
+        humanAccepted: number;
+        unverified: number;
+        successRate: number | null;
+    } | null;
+    attempts: {
+        started: number;
+        finishedOutcomes: number;
+        failedOutcomes: number;
+        cancelledOutcomes: number;
+        deniedOutcomes: number;
+        unknownOutcomes: number;
+    } | null;
+    checks: {
+        passed: number;
+        total: number;
+        passRate: number | null;
+        scope: 'recorded-acceptance-checks-across-all-attempts';
+    } | null;
+    recovery: {
+        samples: number;
+        meanMs: number | null;
+        openFailures: number;
+        scope: 'recorded-failure-to-mechanical-completion';
+    } | null;
+    evidence: {
+        status: 'verified' | 'unavailable' | 'not-executed' | 'no-mechanical-result';
+        artifactEventIds: string[];
+        checkedBytes: number;
+    };
+    costPerVerifiedTask: {
+        value: number | null;
+        unit: 'nano-usd';
+        numerator: number | null;
+        denominator: number;
+        reason: string;
+    };
+    limitations: string;
+}
+/** Revalidate final artifact bytes under current policy before a completed task enters the cost denominator. */
+export declare function inspectGoalMetrics(cwd: string, id: string, options?: GoalOptions): Promise<GoalMetrics>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/goals/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/goals/metrics.ts"],"names":[],"mappings":"AASA,OAAO,EAAyC,KAAK,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAC5F,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAC,CAAC,CAAC;IAAA,IAAI,EAAC,cAAc,CAAC;IAAA,MAAM,EAAC,MAAM,CAAC;IAAA,YAAY,EAAC,MAAM,CAAC;IAAA,iBAAiB,EAAC,MAAM,GAAC,IAAI,CAAC;IAAA,UAAU,EAAC,cAAc,CAAC;IACxH,KAAK,EAAC;QAAC,KAAK,EAAC,MAAM,CAAC;QAAA,oBAAoB,EAAC,MAAM,CAAC;QAAA,aAAa,EAAC,MAAM,CAAC;QAAA,UAAU,EAAC,MAAM,CAAC;QAAA,WAAW,EAAC,MAAM,GAAC,IAAI,CAAA;KAAC,GAAC,IAAI,CAAC;IACrH,QAAQ,EAAC;QAAC,OAAO,EAAC,MAAM,CAAC;QAAA,gBAAgB,EAAC,MAAM,CAAC;QAAA,cAAc,EAAC,MAAM,CAAC;QAAA,iBAAiB,EAAC,MAAM,CAAC;QAAA,cAAc,EAAC,MAAM,CAAC;QAAA,eAAe,EAAC,MAAM,CAAA;KAAC,GAAC,IAAI,CAAC;IACnJ,MAAM,EAAC;QAAC,MAAM,EAAC,MAAM,CAAC;QAAA,KAAK,EAAC,MAAM,CAAC;QAAA,QAAQ,EAAC,MAAM,GAAC,IAAI,CAAC;QAAA,KAAK,EAAC,gDAAgD,CAAA;KAAC,GAAC,IAAI,CAAC;IACrH,QAAQ,EAAC;QAAC,OAAO,EAAC,MAAM,CAAC;QAAA,MAAM,EAAC,MAAM,GAAC,IAAI,CAAC;QAAA,YAAY,EAAC,MAAM,CAAC;QAAA,KAAK,EAAC,2CAA2C,CAAA;KAAC,GAAC,IAAI,CAAC;IACxH,QAAQ,EAAC;QAAC,MAAM,EAAC,UAAU,GAAC,aAAa,GAAC,cAAc,GAAC,sBAAsB,CAAC;QAAA,gBAAgB,EAAC,MAAM,EAAE,CAAC;QAAA,YAAY,EAAC,MAAM,CAAA;KAAC,CAAC;IAC/H,mBAAmB,EAAC;QAAC,KAAK,EAAC,MAAM,GAAC,IAAI,CAAC;QAAA,IAAI,EAAC,UAAU,CAAC;QAAA,SAAS,EAAC,MAAM,GAAC,IAAI,CAAC;QAAA,WAAW,EAAC,MAAM,CAAC;QAAA,MAAM,EAAC,MAAM,CAAA;KAAC,CAAC;IAC/G,WAAW,EAAC,MAAM,CAAC;CACpB;AAYD,gHAAgH;AAChH,wBAAsB,kBAAkB,CAAC,GAAG,EAAC,MAAM,EAAC,EAAE,EAAC,MAAM,EAAC,OAAO,GAAC,WAAc,GAAE,OAAO,CAAC,WAAW,CAAC,CAwCzG"}

package/dist/goals/metrics.js

@@ -0,0 +1,141 @@
+import { throwIfCancelled } from '../cancellation.js';
+import { SessionPolicyError } from '../session-management/index.js';
+import { inspectExecution } from '../orchestration/coordinator-actions.js';
+import { mechanicallyVerified } from '../orchestration/execution-journal.js';
+import { readCollectedArtifact, checkArtifactSnapshot } from '../orchestration/verification.js';
+import { RunStore } from '../orchestration/store.js';
+import { OrchestrationError } from '../orchestration/types.js';
+import { GoalStore } from './store.js';
+import { assertGoalRunBinding, readGoalAccounting } from './accounting.js';
+function observations(execution) {
+    const attempts = { started: 0, finishedOutcomes: 0, failedOutcomes: 0, cancelledOutcomes: 0, deniedOutcomes: 0, unknownOutcomes: 0 }, failed = new Map();
+    let passed = 0, total = 0, recovered = 0, recoveryMs = 0;
+    for (const event of execution.events) {
+        const c = event.change;
+        if (c.type === 'task_started')
+            attempts.started++;
+        if (c.type !== 'task_finished')
+            continue;
+        attempts.finishedOutcomes++;
+        passed += c.output.checks.filter(v => v.passed).length;
+        total += c.output.checks.length;
+        if (c.status === 'failed') {
+            attempts.failedOutcomes++;
+            if (!failed.has(c.taskId))
+                failed.set(c.taskId, Date.parse(event.at));
+        }
+        if (c.status === 'cancelled')
+            attempts.cancelledOutcomes++;
+        if (c.status === 'denied')
+            attempts.deniedOutcomes++;
+        if (c.status === 'unknown')
+            attempts.unknownOutcomes++;
+        if (c.status === 'completed' && failed.has(c.taskId)) {
+            recoveryMs += Date.parse(event.at) - failed.get(c.taskId);
+            recovered++;
+            failed.delete(c.taskId);
+        }
+    }
+    return { attempts, checks: { passed, total, passRate: total ? passed / total : null, scope: 'recorded-acceptance-checks-across-all-attempts' }, recovery: { samples: recovered, meanMs: recovered ? recoveryMs / recovered : null, openFailures: failed.size, scope: 'recorded-failure-to-mechanical-completion' } };
+}
+/** Revalidate final artifact bytes under current policy before a completed task enters the cost denominator. */
+export async function inspectGoalMetrics(cwd, id, options = {}) {
+    throwIfCancelled(options.signal);
+    const goals = options.goals ?? new GoalStore(), goal = goals.read(id, cwd), runs = options.store ?? new RunStore(goal.manifest.runsRoot);
+    if (runs.root !== goal.manifest.runsRoot)
+        throw new OrchestrationError('conflict', 'Goal metrics require the original run store.');
+    const accounting = readGoalAccounting(goal, goals, undefined, options.signal), metric = { version: 1, kind: 'goal.metrics', goalId: id, goalRevision: goal.state.revision, executionRevision: null, accounting, tasks: null, attempts: null, checks: null, recovery: null, evidence: { status: 'not-executed', artifactEventIds: [], checkedBytes: 0 }, costPerVerifiedTask: { value: null, unit: 'nano-usd', numerator: accounting.status === 'available' ? accounting.accounted.costNanos : null, denominator: 0, reason: 'No mechanically verified execution task is available.' }, limitations: 'The numerator includes all planning, worker retry and controller/reviewer charges once. Accounted costs are not invoices. Human acceptance is separate from mechanical verification. Task counts change with decomposition; these observations do not establish causal improvement or cross-run comparability. Recovery and check counts describe recorded executor observations, not test assertions or fresh reproduction.' };
+    if (!goal.state.execution)
+        return metric;
+    try {
+        const current = await inspectExecution(cwd, goal.state.execution.runId, { ...options, store: runs });
+        assertGoalRunBinding(goal, goal.state.execution, current.view.manifest, goals);
+        const execution = current.execution;
+        if (!execution) {
+            metric.evidence.status = 'unavailable';
+            return metric;
+        }
+        const context = current.store.context(execution), states = Object.values(execution.state.tasks), accepted = new Set();
+        metric.executionRevision = execution.state.revision;
+        Object.assign(metric, observations(execution));
+        for (const event of execution.events) {
+            const c = event.change;
+            if (c.type === 'task_accepted')
+                accepted.add(c.taskId);
+            if (c.type === 'task_reset')
+                accepted.delete(c.taskId);
+        }
+        let human = 0, unavailable = false;
+        const seen = new Set(), verifiedTasks = new Set(), proofs = [];
+        for (const task of states) {
+            throwIfCancelled(options.signal);
+            if (task.status !== 'completed')
+                continue;
+            if (accepted.has(task.id)) {
+                human++;
+                continue;
+            }
+            if (!task.output || !mechanicallyVerified(task.output, context)) {
+                unavailable = true;
+                continue;
+            }
+            let intact = true;
+            for (const artifact of task.output.artifacts) {
+                if (seen.has(artifact.source.eventId))
+                    continue;
+                if (metric.evidence.checkedBytes + artifact.bytes > 64 * 1024 * 1024)
+                    throw new OrchestrationError('limit', 'Goal metrics exceed the 64 MiB evidence inspection limit.');
+                if (seen.size % 32 === 0)
+                    await new Promise(resolve => setImmediate(resolve));
+                throwIfCancelled(options.signal);
+                try {
+                    await readCollectedArtifact(current.store, artifact, options);
+                    seen.add(artifact.source.eventId);
+                    proofs.push(artifact);
+                    metric.evidence.artifactEventIds.push(artifact.source.eventId);
+                    metric.evidence.checkedBytes += artifact.bytes;
+                }
+                catch (error) {
+                    throwIfCancelled(options.signal);
+                    if (error instanceof SessionPolicyError || error instanceof OrchestrationError && ['policy-denied', 'limit'].includes(error.code))
+                        throw error;
+                    intact = false;
+                    unavailable = true;
+                }
+            }
+            if (intact)
+                verifiedTasks.add(task.id);
+        }
+        for (const artifact of proofs) {
+            throwIfCancelled(options.signal);
+            try {
+                checkArtifactSnapshot(current.store, artifact);
+            }
+            catch {
+                unavailable = true;
+                verifiedTasks.delete(artifact.taskId);
+            }
+        }
+        const verified = verifiedTasks.size;
+        metric.tasks = { total: states.length, mechanicallyVerified: verified, humanAccepted: human, unverified: states.length - verified - human, successRate: !unavailable && states.length ? verified / states.length : null };
+        metric.evidence.status = unavailable ? 'unavailable' : verified ? 'verified' : 'no-mechanical-result';
+        metric.costPerVerifiedTask.denominator = verified;
+        // A revision mismatch is an incomplete observation, not permission to reread until something passes.
+        const latest = readGoalAccounting(goal, goals, undefined, options.signal), phase = accounting.status !== 'unavailable' ? accounting.phases.execution : undefined;
+        const stable = accounting.status === 'available' && latest.status === 'available' && latest.revision === accounting.revision && phase?.status === 'available' && phase.executionRevision === execution.state.revision && current.store.read().state.revision === execution.state.revision;
+        const eligible = stable && accounting.usageComplete && !unavailable && verified > 0;
+        metric.costPerVerifiedTask.value = eligible ? accounting.accounted.costNanos / verified : null;
+        metric.costPerVerifiedTask.reason = eligible ? 'Fully accounted goal charges, including planning and all reviews/retries, divided by final mechanically verified tasks at these revisions.' : !stable ? 'Goal, execution or budget evidence is missing, inconsistent or changed during inspection.' : unavailable ? 'A final artifact is unavailable or changed after collection.' : !accounting.usageComplete ? 'Active execution, unresolved usage or pending child admission prevents a final cost measurement.' : 'No mechanically verified execution task is available.';
+        return metric;
+    }
+    catch (error) {
+        throwIfCancelled(options.signal);
+        if (error instanceof SessionPolicyError || error instanceof OrchestrationError && ['policy-denied', 'limit'].includes(error.code))
+            throw error;
+        metric.evidence.status = 'unavailable';
+        metric.costPerVerifiedTask.value = null;
+        metric.costPerVerifiedTask.reason = 'Execution or artifact evidence is unavailable or inconsistent; preserve the goal and linked runs.';
+        return metric;
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/goals/metrics.js.map

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

package/dist/goals/repair.d.ts

@@ -0,0 +1,10 @@
+import { type ProjectTask } from '../orchestration/types.js';
+import type { ExecutionStore } from '../orchestration/execution-store.js';
+import type { TaskOutput, TaskStatus } from '../orchestration/coordinator-types.js';
+import type { RunActionOptions } from '../orchestration/actions.js';
+/** Validate data before recording a planning outcome, including direct run/resume entry points. */
+export declare function validatePlanningArtifact(store: ExecutionStore, task: ProjectTask, collected: {
+    status: TaskStatus;
+    output: TaskOutput;
+}, options: RunActionOptions, assertActive: () => void): Promise<void>;
+//# sourceMappingURL=repair.d.ts.map

package/dist/goals/repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","sourceRoot":"","sources":["../../src/goals/repair.ts"],"names":[],"mappings":"AAKA,OAAO,EAAwC,KAAK,WAAW,EAAC,MAAM,2BAA2B,CAAC;AAClG,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAC,UAAU,EAAC,UAAU,EAAC,MAAM,uCAAuC,CAAC;AACjF,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,6BAA6B,CAAC;AAMlE,mGAAmG;AACnG,wBAAsB,wBAAwB,CAAC,KAAK,EAAC,cAAc,EAAC,IAAI,EAAC,WAAW,EAAC,SAAS,EAAC;IAAC,MAAM,EAAC,UAAU,CAAC;IAAA,MAAM,EAAC,UAAU,CAAA;CAAC,EAAC,OAAO,EAAC,gBAAgB,EAAC,YAAY,EAAC,MAAI,IAAI,GAAE,OAAO,CAAC,IAAI,CAAC,CAwBjM"}

package/dist/goals/repair.js

@@ -0,0 +1,50 @@
+import { join } from 'node:path';
+import { ReservationLedger } from '../execution/ledger.js';
+import { ExecutionLimitError } from '../execution/types.js';
+import { throwIfCancelled } from '../cancellation.js';
+import { analyzePlan, bindPlan } from '../orchestration/validation.js';
+import { OrchestrationError } from '../orchestration/types.js';
+import { readCollectedArtifact, checkArtifactSnapshot, workerSummary } from '../orchestration/verification.js';
+import { GoalStore } from './store.js';
+import { goalRunAuthority } from './authority.js';
+import { proposePlan } from './contracts.js';
+/** Validate data before recording a planning outcome, including direct run/resume entry points. */
+export async function validatePlanningArtifact(store, task, collected, options, assertActive) {
+    const link = store.manifest.goal, goal = new GoalStore(link.root).read(link.id, store.manifest.project.root);
+    const authority = goalRunAuthority(store.manifest, goal.manifest.runsRoot);
+    authority.assertActive();
+    if (!goal.manifest.planningRepair)
+        throw new OrchestrationError('conflict', 'Planning repair is absent from the original goal authority.');
+    const artifact = collected.output.artifacts.find(a => a.id === (task.id === 'draft' ? 'draft' : 'proposal'));
+    if (!artifact)
+        return; // Missing or malformed worker reports already fail collection.
+    const bytes = await readCollectedArtifact(store, artifact, options), ledger = new ReservationLedger(join(goal.manifest.runsRoot, store.manifest.id, 'budget')).read(store.manifest.project.root);
+    authority.checkBudget(ledger.manifest);
+    if (ledger.projection.exceeded)
+        throw new ExecutionLimitError('budget', 'Planning usage exceeded its request reservation.');
+    let diagnostics = [];
+    try {
+        let value;
+        try {
+            value = JSON.parse(bytes.toString('utf8'));
+        }
+        catch {
+            throw new OrchestrationError('invalid', 'Planner artifact is not a valid JSON plan.');
+        }
+        const proposal = proposePlan(goal.manifest, value, { kind: 'agent', runId: store.manifest.id, artifactId: artifact.id, artifactHash: artifact.sha256, eventId: artifact.source.eventId }, { ...ledger.projection.spent, revision: ledger.projection.revision });
+        bindPlan(analyzePlan(proposal.plan), store.manifest.project.root);
+    }
+    catch (error) {
+        if (!(error instanceof OrchestrationError) || !['invalid', 'limit'].includes(error.code))
+            throw error;
+        diagnostics = error.diagnostics ?? [{ path: '$', message: workerSummary(error.message).slice(0, 1024) }];
+    }
+    const valid = diagnostics.length === 0;
+    await store.append({ type: 'proposal_validated', taskId: task.id, artifactId: artifact.id, artifactHash: artifact.sha256, goalManifestHash: goal.manifest.hash, valid, diagnostics }, options.signal, undefined, () => { throwIfCancelled(options.signal); assertActive(); authority.assertActive(); checkArtifactSnapshot(store, artifact); });
+    if (!valid) {
+        const feedback = workerSummary('Proposal rejected: ' + diagnostics.map(d => d.path + ': ' + d.message + (d.parentPath ? ' Parent authority: ' + d.parentPath + '.' : '') + (d.actual === undefined ? '' : ` Actual ${d.actual}; limit ${d.limit}.`)).join(' '));
+        collected.status = 'failed';
+        collected.output = { ...collected.output, status: 'failed', summary: feedback, unresolvedRisks: [feedback], recommendedNextAction: 'Return a corrected complete proposal within the same scope, remaining planning budget and original deadline. Human approval is still required.' };
+    }
+}
+//# sourceMappingURL=repair.js.map

package/dist/goals/repair.js.map

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

package/dist/goals/routing.d.ts

@@ -0,0 +1,18 @@
+import { type SmartRoutingPolicy } from '../routing/smart.js';
+import type { RunActionOptions } from '../orchestration/actions.js';
+import type { ProjectPlan } from '../orchestration/types.js';
+import type { GoalManifest } from './types.js';
+export interface GoalRouting {
+    version: 1;
+    default: SmartRoutingPolicy;
+    planner?: SmartRoutingPolicy;
+    workers?: SmartRoutingPolicy;
+    reviewer?: SmartRoutingPolicy;
+    controller?: SmartRoutingPolicy;
+    supervisionReviewer?: SmartRoutingPolicy;
+}
+export declare function validateGoalRouting(value: unknown): GoalRouting;
+export declare function loadGoalRouting(cwd: string, path: string, options: RunActionOptions): Promise<GoalRouting>;
+/** Captured operator choices overwrite model-proposed policies before hash review. */
+export declare function applyGoalRouting(plan: ProjectPlan, manifest: GoalManifest, phase: 'planning' | 'execution'): ProjectPlan;
+//# sourceMappingURL=routing.d.ts.map

package/dist/goals/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/goals/routing.ts"],"names":[],"mappings":"AAOA,OAAO,EAAqB,KAAK,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAEhF,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,YAAY,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAC,CAAC,CAAC;IAAA,OAAO,EAAC,kBAAkB,CAAC;IAAA,OAAO,CAAC,EAAC,kBAAkB,CAAC;IAAA,OAAO,CAAC,EAAC,kBAAkB,CAAC;IAC7F,QAAQ,CAAC,EAAC,kBAAkB,CAAC;IAAA,UAAU,CAAC,EAAC,kBAAkB,CAAC;IAAA,mBAAmB,CAAC,EAAC,kBAAkB,CAAC;CACrG;AACD,wBAAgB,mBAAmB,CAAC,KAAK,EAAC,OAAO,GAAE,WAAW,CAK7D;AACD,wBAAsB,eAAe,CAAC,GAAG,EAAC,MAAM,EAAC,IAAI,EAAC,MAAM,EAAC,OAAO,EAAC,gBAAgB,GAAE,OAAO,CAAC,WAAW,CAAC,CAO1G;AACD,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAC,WAAW,EAAC,QAAQ,EAAC,YAAY,EAAC,KAAK,EAAC,UAAU,GAAC,WAAW,GAAE,WAAW,CAQhH"}

package/dist/goals/routing.js

@@ -0,0 +1,60 @@
+import { dirname, relative, resolve } from 'node:path';
+import { realpathSync } from 'node:fs';
+import { canonicalPath, projectIdentity } from '../approvals/index.js';
+import { readPrivateSessionFile } from '../sessions/index.js';
+import { authorizeSessionAction } from '../session-management/index.js';
+import { throwIfCancelled } from '../cancellation.js';
+import { withScope, validatePath } from '../scope.js';
+import { validateSmartPolicy } from '../routing/smart.js';
+import { shape, fail, pathName } from '../orchestration/validation.js';
+export function validateGoalRouting(value) {
+    shape(value, ['version', 'default'], ['planner', 'workers', 'reviewer', 'controller', 'supervisionReviewer']);
+    if (value.version !== 1)
+        fail('Unsupported goal routing version.');
+    for (const [key, policy] of Object.entries(value))
+        if (key !== 'version')
+            try {
+                validateSmartPolicy(policy);
+            }
+            catch {
+                fail('Invalid Smart routing policy for ' + key + '.');
+            }
+    return structuredClone(value);
+}
+export async function loadGoalRouting(cwd, path, options) {
+    throwIfCancelled(options.signal);
+    const identity = projectIdentity(cwd), file = resolve(identity.project, path);
+    pathName(relative(identity.project, file));
+    if (canonicalPath(file) !== file || realpathSync(dirname(file)) !== dirname(file))
+        fail('Routing policy must be a regular file inside the canonical project.');
+    withScope(identity.project, () => validatePath(file, identity.project));
+    await authorizeSessionAction(identity.project, 'read_file', { path: file, operation: 'smart-routing-policy' }, options);
+    throwIfCancelled(options.signal);
+    if (canonicalPath(file) !== file || projectIdentity(cwd).projectKey !== identity.projectKey)
+        fail('Routing policy path changed during authorization.');
+    const raw = readPrivateSessionFile(file, 65536);
+    let value;
+    try {
+        value = JSON.parse(raw ?? '');
+    }
+    catch {
+        fail('Routing policy must be valid JSON.');
+    }
+    return validateGoalRouting(value);
+}
+/** Captured operator choices overwrite model-proposed policies before hash review. */
+export function applyGoalRouting(plan, manifest, phase) {
+    const routing = manifest.routing;
+    if (!routing)
+        return plan;
+    for (const agent of plan.agents) {
+        const role = phase === 'planning' ? (agent.parentId === null ? 'planner' : 'reviewer') : agent.parentId === null ? 'controller' : agent.id === plan.supervision?.reviewerId ? 'supervisionReviewer' : 'workers';
+        agent.routing = structuredClone(routing[role] ?? routing.default);
+        if (phase === 'execution' && agent.maxChildCount && agent.maxChildDepth)
+            agent.childRouting = structuredClone(routing.workers ?? routing.default);
+        else
+            delete agent.childRouting;
+    }
+    return plan;
+}
+//# sourceMappingURL=routing.js.map

package/dist/goals/routing.js.map

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

package/dist/goals/store.d.ts

@@ -0,0 +1,30 @@
+import type { GoalManifest, GoalProposal, GoalInspection, GoalChange, GoalEvent, GoalOwner, PlanningSpend } from './types.js';
+/** Goal allocations are durable grants, separate from provider request reservations. */
+export declare class GoalStore {
+    private readonly onEvent?;
+    readonly root: string;
+    constructor(root?: string, onEvent?: ((event: GoalEvent) => void) | undefined);
+    directory(id: string): string;
+    private identity;
+    private names;
+    create(input: GoalManifest, signal?: AbortSignal): GoalInspection;
+    read(id: string, cwd?: string): GoalInspection;
+    list(cwd: string): {
+        goals: GoalInspection[];
+        unavailable: number;
+    };
+    proposal(manifest: GoalManifest, hash: string, spend?: PlanningSpend): GoalProposal;
+    writeProposal(input: GoalProposal, spend: PlanningSpend, signal?: AbortSignal): GoalProposal;
+    append(id: string, change: GoalChange, options?: {
+        signal?: AbortSignal;
+        expectedRevision?: string;
+        beforeCommit?: () => void;
+    }): Promise<GoalEvent>;
+    owner(id: string): {
+        id: string;
+        pid: number;
+        alive: boolean;
+    } | null;
+    acquire(id: string): GoalOwner;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/goals/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/goals/store.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,YAAY,EAAC,YAAY,EAAC,cAAc,EAAC,UAAU,EAAC,SAAS,EAAC,SAAS,EAAgB,aAAa,EAAC,MAAM,YAAY,CAAC;AAYrI,wFAAwF;AACxF,qBAAa,SAAS;IAEqC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IADlF,QAAQ,CAAC,IAAI,EAAC,MAAM,CAAC;IACrB,YAAY,IAAI,SAAwC,EAAkB,OAAO,CAAC,GAAC,CAAC,KAAK,EAAC,SAAS,KAAG,IAAI,aAAA,EAA2B;IACrI,SAAS,CAAC,EAAE,EAAC,MAAM,GAAE,MAAM,CAA2G;IACtI,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,KAAK;IAIb,MAAM,CAAC,KAAK,EAAC,YAAY,EAAC,MAAM,CAAC,EAAC,WAAW,GAAE,cAAc,CAO5D;IACD,IAAI,CAAC,EAAE,EAAC,MAAM,EAAC,GAAG,CAAC,EAAC,MAAM,GAAE,cAAc,CAOzC;IACD,IAAI,CAAC,GAAG,EAAC,MAAM,GAAE;QAAC,KAAK,EAAC,cAAc,EAAE,CAAC;QAAA,WAAW,EAAC,MAAM,CAAA;KAAC,CAAgX;IAC5a,QAAQ,CAAC,QAAQ,EAAC,YAAY,EAAC,IAAI,EAAC,MAAM,EAAC,KAAK,CAAC,EAAC,aAAa,GAAE,YAAY,CAAyU;IACtZ,aAAa,CAAC,KAAK,EAAC,YAAY,EAAC,KAAK,EAAC,aAAa,EAAC,MAAM,CAAC,EAAC,WAAW,GAAE,YAAY,CAKrF;IACK,MAAM,CAAC,EAAE,EAAC,MAAM,EAAC,MAAM,EAAC,UAAU,EAAC,OAAO,GAAC;QAAC,MAAM,CAAC,EAAC,WAAW,CAAC;QAAA,gBAAgB,CAAC,EAAC,MAAM,CAAC;QAAA,YAAY,CAAC,EAAC,MAAI,IAAI,CAAA;KAAI,GAAE,OAAO,CAAC,SAAS,CAAC,CAa5I;IACD,KAAK,CAAC,EAAE,EAAC,MAAM,GAAE;QAAC,EAAE,EAAC,MAAM,CAAC;QAAA,GAAG,EAAC,MAAM,CAAC;QAAA,KAAK,EAAC,OAAO,CAAA;KAAC,GAAC,IAAI,CAEzD;IACD,OAAO,CAAC,EAAE,EAAC,MAAM,GAAE,SAAS,CAO3B;CACF"}