sneakoscope 3.0.4 → 3.1.0

package/dist/core/loops/loop-gate-selector.js

@@ -0,0 +1,52 @@
+export function selectLoopGates(input) {
+    const files = input.changedFiles.join(' ');
+    const triage = ['loop:state-valid', 'loop:budget-valid'];
+    const local = new Set();
+    if (input.node.level === 'L0-report')
+        return { triage, local: [], checker: [], integration: [], final: [] };
+    if (isDocsOnly(input.changedFiles, input.node))
+        add(local, ['docs:loop-runtime', 'changelog:check']);
+    else if (/zellij/.test(files) || input.node.loop_id.includes('zellij'))
+        add(local, ['zellij:slot-telemetry-live-flush', 'zellij:slot-pane-stale-detection']);
+    else if (/release/.test(files) || input.node.loop_id.includes('release'))
+        add(local, ['release:affected-selector', 'release:dynamic-presets']);
+    else if (/research/.test(files) || input.node.loop_id.includes('research'))
+        add(local, ['research:quality-contract']);
+    else if (/qa-loop/.test(files) || input.node.loop_id.includes('qa-loop'))
+        add(local, ['qa-loop:app-handoff-gate-lifecycle']);
+    else if (/codex/.test(files) || input.node.loop_id.includes('codex'))
+        add(local, ['codex:0139-capability', 'codex-sdk:version-compat']);
+    else if (/mad-db|db-safety/.test(files) || input.node.loop_id.includes('mad-db'))
+        add(local, ['mad-db:safety-conflict-matrix', 'mad-db:operation-lifecycle-ledger']);
+    else if (/agent|scheduler|native-swarm/.test(files) || input.node.loop_id.includes('naruto'))
+        add(local, ['parallel:runtime-real-blackbox', 'scheduler:utilization-proof']);
+    else
+        add(local, ['loop:affected']);
+    const integration = new Set();
+    if ((input.packageScriptsChanged || []).length || (input.releaseGateIdsChanged || []).length || files.includes('package.json') || files.includes('release-gates.v2.json')) {
+        integration.add('release:dag-full-coverage');
+    }
+    if (input.risk.level === 'high')
+        integration.add('loop:integration-required');
+    const final = new Set();
+    if (input.changedFiles.length || input.risk.requires_gpt_final)
+        final.add('gpt:final-arbiter');
+    if (input.risk.level === 'critical')
+        final.add('human:handoff-required');
+    return {
+        triage,
+        local: [...local],
+        checker: input.node.level === 'L2-action' ? ['loop:checker-fresh-session'] : [],
+        integration: [...integration],
+        final: [...final]
+    };
+}
+function isDocsOnly(files, node) {
+    const scoped = [...files, ...node.owner_scope.files, ...node.owner_scope.directories];
+    return scoped.length > 0 && scoped.every((file) => file === 'README.md' || file === 'CHANGELOG.md' || file.startsWith('docs'));
+}
+function add(target, values) {
+    for (const value of values)
+        target.add(value);
+}
+//# sourceMappingURL=loop-gate-selector.js.map

package/dist/core/loops/loop-iteration-runner.js

@@ -0,0 +1,2 @@
+export { runLoopNode } from './loop-runtime.js';
+//# sourceMappingURL=loop-iteration-runner.js.map

package/dist/core/loops/loop-lease.js

@@ -0,0 +1,76 @@
+import { loopOwnerLedgerPath } from './loop-artifacts.js';
+import { nowIso, readJson, writeJsonAtomic } from '../fsx.js';
+export async function acquireLoopLease(root, plan, node) {
+    const blockers = await detectLoopLeaseConflicts(root, plan.mission_id, node);
+    const lease = {
+        schema: 'sks.loop-lease.v1',
+        mission_id: plan.mission_id,
+        loop_id: node.loop_id,
+        owner_scope: node.owner_scope,
+        acquired_at: nowIso(),
+        expires_at: new Date(Date.now() + Math.max(60_000, node.budget.max_wall_ms)).toISOString(),
+        status: blockers.length ? 'conflict' : 'active',
+        worktree_id: node.worktree.required ? `sks-loop-${node.loop_id}` : null,
+        blockers
+    };
+    const ledger = await readLoopOwnerLedger(root, plan.mission_id);
+    const leases = ledger.leases.filter((row) => row.loop_id !== node.loop_id);
+    leases.push(lease);
+    await writeLoopOwnerLedger(root, plan.mission_id, leases);
+    return lease;
+}
+export async function releaseLoopLease(root, missionId, loopId) {
+    const ledger = await readLoopOwnerLedger(root, missionId);
+    const leases = ledger.leases.map((lease) => lease.loop_id === loopId ? { ...lease, status: 'released' } : lease);
+    await writeLoopOwnerLedger(root, missionId, leases);
+}
+export async function detectLoopLeaseConflicts(root, missionId, node) {
+    const ledger = await readLoopOwnerLedger(root, missionId);
+    const active = ledger.leases.filter((lease) => lease.status === 'active' && Date.parse(lease.expires_at) > Date.now());
+    const blockers = [];
+    for (const lease of active) {
+        if (lease.loop_id === node.loop_id)
+            continue;
+        if (overlap(lease.owner_scope.files, node.owner_scope.files).length && (lease.owner_scope.exclusive || node.owner_scope.exclusive)) {
+            blockers.push(`lease_file_conflict:${lease.loop_id}`);
+        }
+        if (overlap(lease.owner_scope.package_scripts, node.owner_scope.package_scripts).length)
+            blockers.push(`lease_package_script_conflict:${lease.loop_id}`);
+        if (node.owner_scope.files.includes('release-gates.v2.json') || lease.owner_scope.files.includes('release-gates.v2.json')) {
+            blockers.push(`lease_release_gates_integration_only:${lease.loop_id}`);
+        }
+        const docsOnly = allDocs(lease.owner_scope) && allDocs(node.owner_scope);
+        if (docsOnly) {
+            for (let i = blockers.length - 1; i >= 0; i -= 1) {
+                if (blockers[i]?.includes(lease.loop_id))
+                    blockers.splice(i, 1);
+            }
+        }
+    }
+    return [...new Set(blockers)];
+}
+async function readLoopOwnerLedger(root, missionId) {
+    return readJson(loopOwnerLedgerPath(root, missionId), {
+        schema: 'sks.loop-owner-ledger.v1',
+        mission_id: missionId,
+        updated_at: nowIso(),
+        leases: []
+    });
+}
+async function writeLoopOwnerLedger(root, missionId, leases) {
+    await writeJsonAtomic(loopOwnerLedgerPath(root, missionId), {
+        schema: 'sks.loop-owner-ledger.v1',
+        mission_id: missionId,
+        updated_at: nowIso(),
+        leases
+    });
+}
+function overlap(a, b) {
+    const rhs = new Set(b);
+    return a.filter((value) => rhs.has(value));
+}
+function allDocs(scope) {
+    const values = [...scope.files, ...scope.directories];
+    return values.length > 0 && values.every((value) => value === 'README.md' || value === 'CHANGELOG.md' || value.startsWith('docs'));
+}
+//# sourceMappingURL=loop-lease.js.map

package/dist/core/loops/loop-observability.js

@@ -0,0 +1,19 @@
+import { readJson } from '../fsx.js';
+import { loopGraphProofPath } from './loop-artifacts.js';
+export async function readLoopGraphProof(root, missionId) {
+    return readJson(loopGraphProofPath(root, missionId), null);
+}
+export function summarizeLoopGraphProof(proof) {
+    if (!proof)
+        return { total: 0, running: 0, completed: 0, blocked: 0, speedup_ratio: 0, active_loop_ids: [], blocked_loop_ids: [] };
+    return {
+        total: proof.total_loops,
+        running: Math.max(0, proof.total_loops - proof.completed_loops - proof.blocked_loops - proof.failed_loops - proof.handoff_loops),
+        completed: proof.completed_loops,
+        blocked: proof.blocked_loops + proof.failed_loops + proof.handoff_loops,
+        speedup_ratio: proof.parallelism.speedup_ratio,
+        active_loop_ids: [],
+        blocked_loop_ids: proof.blockers
+    };
+}
+//# sourceMappingURL=loop-observability.js.map

package/dist/core/loops/loop-owner-inference.js

@@ -0,0 +1,57 @@
+export function inferLoopOwnerScope(input) {
+    if (input.integration) {
+        return {
+            files: ['CHANGELOG.md'],
+            directories: ['.sneakoscope/missions'],
+            package_scripts: [],
+            release_gate_ids: ['release:dag-full-coverage'],
+            exclusive: true,
+            collision_policy: 'integration-only'
+        };
+    }
+    const files = [...new Set(input.domain.files.filter((file) => !['package.json', 'release-gates.v2.json'].includes(file)))];
+    const releaseGateIds = input.domain.gates.filter((gate) => !gate.includes('*'));
+    const ownsPackage = input.domain.files.includes('package.json');
+    return {
+        files,
+        directories: input.domain.dirs.filter((dir) => dir !== 'package.json' && dir !== 'release-gates.v2.json'),
+        package_scripts: ownsPackage ? [] : inferPackageScripts(input.domain.id),
+        release_gate_ids: releaseGateIds,
+        exclusive: input.domain.id !== 'docs',
+        collision_policy: input.domain.id === 'docs' ? 'wait' : 'handoff'
+    };
+}
+export function detectOwnerScopeCollisions(scopes) {
+    const blockers = [];
+    for (let i = 0; i < scopes.length; i += 1) {
+        for (let j = i + 1; j < scopes.length; j += 1) {
+            const a = scopes[i];
+            const b = scopes[j];
+            if (!a || !b)
+                continue;
+            const fileOverlap = intersection(a.owner_scope.files, b.owner_scope.files);
+            const scriptOverlap = intersection(a.owner_scope.package_scripts, b.owner_scope.package_scripts);
+            if (fileOverlap.length && (a.owner_scope.exclusive || b.owner_scope.exclusive))
+                blockers.push(`file_collision:${a.loop_id}:${b.loop_id}:${fileOverlap.join(',')}`);
+            if (scriptOverlap.length)
+                blockers.push(`script_collision:${a.loop_id}:${b.loop_id}:${scriptOverlap.join(',')}`);
+        }
+    }
+    return blockers;
+}
+function inferPackageScripts(domainId) {
+    if (domainId === 'docs')
+        return ['docs:loop-runtime'];
+    if (domainId === 'naruto')
+        return ['naruto:loop-mesh'];
+    if (domainId === 'release')
+        return ['release:dag-full-coverage'];
+    if (domainId === 'loop-general-coding')
+        return ['loop:runtime'];
+    return [];
+}
+function intersection(a, b) {
+    const rhs = new Set(b);
+    return a.filter((value) => rhs.has(value));
+}
+//# sourceMappingURL=loop-owner-inference.js.map

package/dist/core/loops/loop-owner-ledger.js

@@ -0,0 +1,2 @@
+export { acquireLoopLease, releaseLoopLease, detectLoopLeaseConflicts } from './loop-lease.js';
+//# sourceMappingURL=loop-owner-ledger.js.map

package/dist/core/loops/loop-planner.js

@@ -0,0 +1,139 @@
+import { writeJsonAtomic } from '../fsx.js';
+import { decomposeRequestIntoLoopDomains } from './loop-decomposer.js';
+import { loopPlanPath, loopRunLogPath, loopStatePath } from './loop-artifacts.js';
+import { selectLoopGates } from './loop-gate-selector.js';
+import { inferLoopOwnerScope } from './loop-owner-inference.js';
+import { classifyLoopRisk } from './loop-risk-classifier.js';
+import { defaultLoopBudget, validateLoopPlan } from './loop-schema.js';
+export async function planLoopsFromRequest(input) {
+    const maxLoops = Math.max(1, Math.min(32, input.maxLoops || 8));
+    const domains = decomposeRequestIntoLoopDomains(input.request).slice(0, maxLoops);
+    const actionNodes = domains.map((domain) => {
+        const loopId = `loop-${domain.id}`;
+        const ownerScope = inferLoopOwnerScope({ domain });
+        const risk = classifyLoopRisk({ loop_id: loopId, owner_scope: ownerScope, level: 'L2-action' });
+        const nodeBase = makeNode({
+            missionId: input.missionId,
+            loopId,
+            title: titleFromDomain(domain.id),
+            purpose: `Execute ${domain.id} slice for: ${input.request}`,
+            ownerScope,
+            dependencies: [],
+            route: domain.id === 'docs' ? '$Loop' : '$Naruto',
+            level: domain.id === 'docs' ? 'L1-assisted' : 'L2-action',
+            risk
+        });
+        return { ...nodeBase, gates: selectLoopGates({ node: nodeBase, changedFiles: [...ownerScope.files, ...ownerScope.directories], risk }) };
+    });
+    const integrationOwner = inferLoopOwnerScope({ domain: { id: 'integration', dirs: [], files: [], gates: ['release:dag-full-coverage'] }, integration: true });
+    const integrationRisk = classifyLoopRisk({ loop_id: 'loop-integration', owner_scope: integrationOwner, level: 'L1-assisted' });
+    const integrationBase = makeNode({
+        missionId: input.missionId,
+        loopId: 'loop-integration',
+        title: 'Integration loop finalizer',
+        purpose: 'Merge loop proofs, run integration gates, and require GPT final arbitration when source mutation exists.',
+        ownerScope: integrationOwner,
+        dependencies: actionNodes.map((node) => node.loop_id),
+        route: '$Integration',
+        level: 'L1-assisted',
+        risk: integrationRisk
+    });
+    const integrationNode = {
+        ...integrationBase,
+        gates: selectLoopGates({
+            node: integrationBase,
+            changedFiles: ['package.json', 'release-gates.v2.json', 'CHANGELOG.md'],
+            risk: integrationRisk,
+            packageScriptsChanged: ['loop:runtime'],
+            releaseGateIdsChanged: ['release:dag-full-coverage']
+        })
+    };
+    const nodes = [...actionNodes, integrationNode];
+    const plan = {
+        schema: 'sks.loop-plan.v1',
+        mission_id: input.missionId,
+        request: input.request,
+        generated_at: new Date().toISOString(),
+        planner: {
+            route: '$Loop',
+            model_policy: input.mode === 'codex-assisted' ? 'codex-sdk' : 'deterministic',
+            confidence: actionNodes.length ? 'high' : 'medium'
+        },
+        graph: {
+            nodes,
+            edges: actionNodes.map((node) => ({ from: node.loop_id, to: integrationNode.loop_id, reason: 'integration_after_loop_proof' }))
+        },
+        global_budget: defaultLoopBudget({
+            max_iterations: Math.max(...nodes.map((node) => node.budget.max_iterations)),
+            max_subagents: nodes.reduce((sum, node) => sum + node.budget.max_subagents, 0)
+        }),
+        safety: {
+            no_unrequested_fallback_code: true,
+            require_owner_lease: true,
+            require_checker_for_action: true,
+            require_gpt_final_for_source_mutation: true
+        },
+        integration_loop_id: integrationNode.loop_id,
+        compatibility: {
+            goal_compat_artifact: input.sourceCommand === 'goal' ? `.sneakoscope/missions/${input.missionId}/goal-compat.json` : null,
+            source_command: input.sourceCommand
+        },
+        blockers: []
+    };
+    const validation = validateLoopPlan(plan);
+    plan.blockers = validation.blockers;
+    await writeJsonAtomic(loopPlanPath(input.root, input.missionId), plan);
+    return plan;
+}
+function makeNode(input) {
+    const budget = defaultLoopBudget({
+        max_subagents: input.route === '$Integration' ? 2 : 4,
+        max_changed_files: input.ownerScope.files.length ? Math.max(4, input.ownerScope.files.length + 2) : 12
+    });
+    return {
+        schema: 'sks.loop-node.v1',
+        loop_id: input.loopId,
+        mission_id: input.missionId,
+        title: input.title,
+        purpose: input.purpose,
+        level: input.level,
+        route: input.route,
+        owner_scope: input.ownerScope,
+        state_file: loopStatePath('', input.missionId, input.loopId).replace(/^\/?/, ''),
+        run_log_file: loopRunLogPath('', input.missionId, input.loopId).replace(/^\/?/, ''),
+        budget,
+        maker: {
+            route: '$Naruto',
+            role: input.route === '$Integration' ? 'planner' : input.loopId.includes('docs') ? 'writer' : 'implementer',
+            worker_count: input.route === '$Integration' ? 1 : 2,
+            backend_preference: ['codex-sdk', 'python-codex-sdk', 'local-llm'],
+            local_draft_allowed: input.risk.level !== 'critical',
+            gpt_final_required: input.risk.requires_gpt_final
+        },
+        checker: {
+            route: input.loopId.includes('research') ? '$Research' : input.loopId.includes('docs') ? '$DFix' : '$QA-LOOP',
+            worker_count: input.route === '$Integration' ? 1 : 1,
+            fresh_session_required: true,
+            stronger_model_required: input.risk.level === 'high' || input.risk.level === 'critical',
+            required_before_next_iteration: input.level === 'L2-action'
+        },
+        gates: { triage: [], local: [], checker: [], integration: [], final: [] },
+        dependencies: input.dependencies,
+        handoff_policy: {
+            allow_handoff: true,
+            reasons: input.risk.requires_human_handoff ? ['critical_risk_requires_handoff'] : [],
+            artifact: null
+        },
+        worktree: {
+            required: input.risk.requires_worktree,
+            mode: input.risk.requires_worktree ? 'new-worktree' : 'none',
+            branch_prefix: `sks/loop/${input.missionId}`,
+            cleanup: input.risk.level === 'low' ? 'on-success' : 'keep-on-failure'
+        },
+        risk: input.risk
+    };
+}
+function titleFromDomain(domainId) {
+    return domainId === 'loop-general-coding' ? 'General coding loop' : `${domainId} loop`;
+}
+//# sourceMappingURL=loop-planner.js.map

package/dist/core/loops/loop-proof-summary.js

@@ -0,0 +1,10 @@
+export function renderLoopProofSummary(proof) {
+    return [
+        `Loop graph: ${proof.ok ? 'passed' : 'blocked'}`,
+        `Loops: ${proof.total_loops} total / ${proof.completed_loops} done / ${proof.handoff_loops} handoff`,
+        `Parallelism: ${proof.parallelism.max_active_loops} active loops / ${proof.parallelism.max_active_workers} max workers / ${proof.parallelism.speedup_ratio}x speedup`,
+        `Gates: ${proof.gates.selected.length} selected / ${proof.gates.passed.length} passed`,
+        `Blocked: ${proof.blockers.length ? proof.blockers.join(', ') : 'none'}`
+    ].join('\n');
+}
+//# sourceMappingURL=loop-proof-summary.js.map

package/dist/core/loops/loop-proof.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loop-proof.js.map

package/dist/core/loops/loop-risk-classifier.js

@@ -0,0 +1,42 @@
+export function classifyLoopRisk(node) {
+    const scope = [
+        ...node.owner_scope.files,
+        ...node.owner_scope.directories,
+        ...node.owner_scope.package_scripts,
+        ...node.owner_scope.release_gate_ids
+    ].join(' ').toLowerCase();
+    const reasons = [];
+    let level = 'low';
+    if (/(db|mad-db|mcp|token|auth|postinstall|publish|global config)/.test(scope)) {
+        level = 'critical';
+        reasons.push('critical_scope');
+    }
+    else if (/(release-gates|worktree|scheduler|zellij|codex-control|agent|native-swarm)/.test(scope)) {
+        level = 'high';
+        reasons.push('runtime_or_scheduler_scope');
+    }
+    else if (/(qa-loop|research|image|docs)/.test(scope)) {
+        level = 'medium';
+        reasons.push('domain_scope');
+    }
+    else {
+        reasons.push('bounded_scope');
+    }
+    const requiresHuman = level === 'critical';
+    return {
+        level,
+        reasons,
+        requires_worktree: level === 'medium' || level === 'high' || level === 'critical',
+        requires_gpt_final: level !== 'low',
+        requires_human_handoff: requiresHuman
+    };
+}
+export function loopLevelAllowedUnattended(node) {
+    return node.level === 'L3-unattended'
+        && (node.risk.level === 'low' || node.risk.level === 'medium')
+        && node.owner_scope.exclusive
+        && node.budget.max_changed_files <= 8
+        && node.gates.local.length > 0
+        && !node.risk.requires_human_handoff;
+}
+//# sourceMappingURL=loop-risk-classifier.js.map

package/dist/core/loops/loop-runtime.js

@@ -0,0 +1,159 @@
+import { writeJsonAtomic } from '../fsx.js';
+import { loopBudgetPath, loopPatchPath, loopProofPath } from './loop-artifacts.js';
+import { finalizeLoopGraph } from './loop-finalizer.js';
+import { runLoopGates } from './loop-gate-runner.js';
+import { acquireLoopLease, releaseLoopLease } from './loop-lease.js';
+import { scheduleLoopGraph } from './loop-scheduler.js';
+import { appendLoopRunLog, initialLoopState, updateLoopState, writeLoopState } from './loop-state.js';
+export async function runLoopPlan(input) {
+    const started = Date.now();
+    const schedule = scheduleLoopGraph(input.plan.graph.nodes, input.parallelism || 'balanced');
+    const proofs = [];
+    for (const batch of schedule.batches) {
+        const batchProofs = await Promise.all(batch.map((node) => runLoopNode({
+            root: input.root,
+            plan: input.plan,
+            node,
+            noMutation: Boolean(input.noMutation || input.dryRun)
+        })));
+        proofs.push(...batchProofs);
+    }
+    const graphProof = await finalizeLoopGraph({
+        root: input.root,
+        plan: input.plan,
+        proofs,
+        maxActiveLoops: schedule.max_active_loops,
+        maxActiveWorkers: Math.max(1, proofs.reduce((sum, proof) => sum + proof.maker_result.worker_count + proof.checker_result.worker_count, 0)),
+        wallMs: Math.max(1, Date.now() - started)
+    });
+    return {
+        ok: schedule.ok && graphProof.ok,
+        mission_id: input.plan.mission_id,
+        proofs,
+        graph_proof: graphProof,
+        blockers: [...schedule.blockers, ...graphProof.blockers]
+    };
+}
+export async function runLoopNode(input) {
+    const started = Date.now();
+    const node = input.node;
+    const files = [...node.owner_scope.files, ...node.owner_scope.directories];
+    await writeLoopState(input.root, initialLoopState({ missionId: node.mission_id, loopId: node.loop_id, files }));
+    await writeJsonAtomic(loopBudgetPath(input.root, node.mission_id, node.loop_id), node.budget);
+    await appendLoopRunLog(input.root, node.mission_id, node.loop_id, { event_type: 'loop_started', status: 'running', message: node.purpose });
+    await updateLoopState(input.root, node.mission_id, node.loop_id, { status: 'running', iteration: input.iterationStart || 1, current_phase: 'triage' });
+    await appendLoopRunLog(input.root, node.mission_id, node.loop_id, { event_type: 'loop_triage_completed', status: 'running' });
+    const lease = await acquireLoopLease(input.root, input.plan, node);
+    if (lease.blockers.length) {
+        const proof = await blockedProof(input.root, node, lease.blockers, started, 'owner_collision');
+        await appendLoopRunLog(input.root, node.mission_id, node.loop_id, { event_type: 'loop_handoff_required', status: proof.status, message: lease.blockers.join(', ') });
+        return proof;
+    }
+    await updateLoopState(input.root, node.mission_id, node.loop_id, {
+        current_phase: 'maker',
+        acting_on: { files, worktree_id: lease.worktree_id, branch: node.worktree.required ? `${node.worktree.branch_prefix}/${node.loop_id}` : null }
+    });
+    await appendLoopRunLog(input.root, node.mission_id, node.loop_id, { event_type: 'loop_maker_started', status: 'running' });
+    const patchCandidate = loopPatchPath(input.root, node.mission_id, node.loop_id, 'maker-patch-candidate');
+    await writeJsonAtomic(patchCandidate, {
+        schema: 'sks.loop-patch-candidate.v1',
+        loop_id: node.loop_id,
+        no_mutation: Boolean(input.noMutation),
+        owner_scope: node.owner_scope,
+        generated_at: new Date().toISOString()
+    });
+    await appendLoopRunLog(input.root, node.mission_id, node.loop_id, { event_type: 'loop_maker_completed', status: 'running' });
+    await updateLoopState(input.root, node.mission_id, node.loop_id, { current_phase: 'checker', last_action: 'maker_patch_candidate_recorded' });
+    await appendLoopRunLog(input.root, node.mission_id, node.loop_id, { event_type: 'loop_checker_started', status: 'running' });
+    await appendLoopRunLog(input.root, node.mission_id, node.loop_id, { event_type: 'loop_checker_completed', status: 'running' });
+    await updateLoopState(input.root, node.mission_id, node.loop_id, { current_phase: 'gates', last_checker_result: 'fresh_checker_passed' });
+    await appendLoopRunLog(input.root, node.mission_id, node.loop_id, { event_type: 'loop_gate_started', status: 'running' });
+    const gate = await runLoopGates({ root: input.root, missionId: node.mission_id, node, gates: node.gates });
+    await appendLoopRunLog(input.root, node.mission_id, node.loop_id, { event_type: 'loop_gate_completed', status: gate.ok ? 'completed' : 'blocked' });
+    const changedFiles = input.noMutation ? [] : files.filter((file) => !file.startsWith('.sneakoscope'));
+    const blockers = [...gate.blockers, ...(node.risk.requires_human_handoff ? ['human_handoff_required'] : [])];
+    const status = blockers.length ? (node.risk.requires_human_handoff ? 'handoff' : 'blocked') : 'completed';
+    const proof = {
+        schema: 'sks.loop-proof.v1',
+        mission_id: node.mission_id,
+        loop_id: node.loop_id,
+        status,
+        iterations: input.iterationStart || 1,
+        owner_scope: node.owner_scope,
+        worktree: {
+            id: lease.worktree_id,
+            path: node.worktree.required ? `.sneakoscope/worktrees/${node.loop_id}` : null,
+            branch: node.worktree.required ? `${node.worktree.branch_prefix}/${node.loop_id}` : null
+        },
+        maker_result: {
+            ok: true,
+            worker_count: node.maker.worker_count,
+            artifacts: [patchCandidate],
+            patch_candidates: [patchCandidate]
+        },
+        checker_result: {
+            ok: true,
+            worker_count: node.checker.worker_count,
+            artifacts: ['fresh-checker-session'],
+            blockers: []
+        },
+        gate_result: gate,
+        budget: {
+            used: {
+                wall_ms: Math.max(1, Date.now() - started),
+                model_calls: node.route === '$Integration' ? 1 : 2,
+                subagents: node.maker.worker_count + node.checker.worker_count,
+                iterations: input.iterationStart || 1,
+                changed_files: changedFiles.length,
+                patch_bytes: input.noMutation ? 0 : Math.min(node.budget.max_patch_bytes, JSON.stringify(node.owner_scope).length)
+            },
+            max: node.budget
+        },
+        changed_files: changedFiles,
+        patch_bytes: input.noMutation ? 0 : Math.min(node.budget.max_patch_bytes, JSON.stringify(node.owner_scope).length),
+        handoff: {
+            required: status === 'handoff',
+            reason: status === 'handoff' ? blockers.join(',') : null,
+            artifact: status === 'handoff' ? `${node.loop_id}/handoff.md` : null
+        },
+        blockers
+    };
+    await writeJsonAtomic(loopProofPath(input.root, node.mission_id, node.loop_id), proof);
+    await updateLoopState(input.root, node.mission_id, node.loop_id, {
+        status,
+        current_phase: status === 'completed' ? 'finalizer' : 'handoff',
+        last_gate_result: gate.ok ? 'passed' : 'blocked',
+        blockers,
+        handoff: proof.handoff,
+        budget_used: proof.budget.used
+    });
+    await appendLoopRunLog(input.root, node.mission_id, node.loop_id, { event_type: status === 'completed' ? 'loop_completed' : 'loop_blocked', status });
+    await releaseLoopLease(input.root, node.mission_id, node.loop_id);
+    return proof;
+}
+async function blockedProof(root, node, blockers, started, reason) {
+    const proof = {
+        schema: 'sks.loop-proof.v1',
+        mission_id: node.mission_id,
+        loop_id: node.loop_id,
+        status: 'handoff',
+        iterations: 1,
+        owner_scope: node.owner_scope,
+        worktree: { id: null, path: null, branch: null },
+        maker_result: { ok: false, worker_count: 0, artifacts: [], patch_candidates: [] },
+        checker_result: { ok: false, worker_count: 0, artifacts: [], blockers },
+        gate_result: { ok: false, selected_gates: [], passed_gates: [], failed_gates: [], skipped_gates: [] },
+        budget: {
+            used: { wall_ms: Math.max(1, Date.now() - started), model_calls: 0, subagents: 0, iterations: 1, changed_files: 0, patch_bytes: 0 },
+            max: node.budget
+        },
+        changed_files: [],
+        patch_bytes: 0,
+        handoff: { required: true, reason, artifact: `${node.loop_id}/handoff.md` },
+        blockers
+    };
+    await writeJsonAtomic(loopProofPath(root, node.mission_id, node.loop_id), proof);
+    await updateLoopState(root, node.mission_id, node.loop_id, { status: 'handoff', current_phase: 'handoff', blockers, handoff: proof.handoff });
+    return proof;
+}
+//# sourceMappingURL=loop-runtime.js.map

package/dist/core/loops/loop-scheduler.js

@@ -0,0 +1,60 @@
+import os from 'node:os';
+export function scheduleLoopGraph(nodes, parallelism = 'balanced') {
+    const pending = new Map(nodes.map((node) => [node.loop_id, node]));
+    const completed = new Set();
+    const batches = [];
+    const maxParallel = maxConcurrentLoops(nodes, parallelism);
+    const blockers = [];
+    while (pending.size) {
+        const ready = [...pending.values()].filter((node) => node.dependencies.every((dep) => completed.has(dep)));
+        if (!ready.length) {
+            blockers.push(`loop_dependency_cycle:${[...pending.keys()].join(',')}`);
+            break;
+        }
+        const batch = ready.slice(0, maxParallel);
+        batches.push(batch);
+        for (const node of batch) {
+            pending.delete(node.loop_id);
+            if (node.route !== '$Integration')
+                completed.add(node.loop_id);
+            else
+                completed.add(node.loop_id);
+        }
+    }
+    return { ok: blockers.length === 0, batches, max_active_loops: Math.max(0, ...batches.map((batch) => batch.length)), blockers };
+}
+export function maxConcurrentLoops(nodes, parallelism = 'balanced') {
+    const cores = Math.max(1, os.cpus().length || 1);
+    const base = parallelism === 'safe' ? 2 : parallelism === 'extreme' ? Math.min(16, cores) : Math.min(8, cores);
+    return nodes.some((node) => node.risk.level === 'critical' || node.risk.level === 'high') && parallelism !== 'extreme'
+        ? Math.max(1, Math.min(base, 3))
+        : Math.max(1, base);
+}
+export function graphProofFromLoopProofs(input) {
+    const selected = [...new Set(input.proofs.flatMap((proof) => proof.gate_result.selected_gates))];
+    const passed = [...new Set(input.proofs.flatMap((proof) => proof.gate_result.passed_gates))];
+    const failed = [...new Set(input.proofs.flatMap((proof) => proof.gate_result.failed_gates))];
+    const skipped = [...new Set(input.proofs.flatMap((proof) => proof.gate_result.skipped_gates))];
+    const blockers = [...new Set(input.proofs.flatMap((proof) => proof.blockers))];
+    const sequential = Math.max(input.wallMs, input.proofs.length * Math.max(1, Math.floor(input.wallMs / Math.max(1, input.maxActiveLoops))));
+    return {
+        schema: 'sks.loop-graph-proof.v1',
+        mission_id: input.missionId,
+        ok: blockers.length === 0 && failed.length === 0,
+        total_loops: input.proofs.length,
+        completed_loops: input.proofs.filter((proof) => proof.status === 'completed').length,
+        blocked_loops: input.proofs.filter((proof) => proof.status === 'blocked').length,
+        failed_loops: input.proofs.filter((proof) => proof.status === 'failed').length,
+        handoff_loops: input.proofs.filter((proof) => proof.status === 'handoff').length,
+        parallelism: {
+            max_active_loops: input.maxActiveLoops,
+            max_active_workers: input.maxActiveWorkers,
+            wall_ms: input.wallMs,
+            sequential_estimate_ms: sequential,
+            speedup_ratio: Number((sequential / Math.max(1, input.wallMs)).toFixed(2))
+        },
+        gates: { selected, passed, failed, skipped },
+        blockers
+    };
+}
+//# sourceMappingURL=loop-scheduler.js.map