agentic-qe 3.14.3 → 3.14.4

package/dist/cli/chunks/workflow-2ZQO6WYI.js

@@ -0,0 +1,51 @@
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.14.4");process.exit(0)}
+import"./chunk-TWAWHOP7.js";import{b as $}from"./chunk-3X3DJZJJ.js";import{d as C}from"./chunk-GPLQ6DOK.js";import{b as k,c as W,d as v}from"./chunk-OSLYSG3B.js";import{c as b}from"./chunk-DHJPWQBR.js";import"./chunk-STM3UDNO.js";import"./chunk-G6T45OIC.js";import"./chunk-TT23RRB7.js";import{Command as D}from"commander";import o from"chalk";function O(w,i){let h=w.indexOf("=");return h>0&&(i[w.substring(0,h)]=w.substring(h+1)),i}function V(w,i,h){let m=new D("workflow").description("Manage QE workflows and pipelines (ADR-041)");return m.command("run <file>").description("Execute a QE pipeline from YAML file").option("-w, --watch","Watch execution progress").option("-v, --verbose","Show detailed output").option("--params <json>","Additional parameters as JSON","{}").action(async(n,t)=>{if(!await h())return;let u=(await import("path")).resolve(n);try{console.log(o.blue(`
+ Running workflow from: ${n}
+`));let l=k(u);if(!l.success||!l.workflow){console.log(o.red("Failed to parse pipeline:"));for(let g of l.errors)console.log(o.red(`   ${g}`));await i(1)}let f={...b(t.params,"params")};if(l.pipeline){for(let g of l.pipeline.stages)if(g.params)for(let[y,p]of Object.entries(g.params))f[y]=p}if(!w.workflowOrchestrator.getWorkflow(l.workflow.id)){let g=w.workflowOrchestrator.registerWorkflow(l.workflow);g.success||(console.log(o.red(`Failed to register workflow: ${g.error.message}`)),await i(1))}let c=await w.workflowOrchestrator.executeWorkflow(l.workflow.id,f);if(!c.success){console.log(o.red(`Failed to start workflow: ${c.error.message}`)),await i(1);return}let a=c.value;if(console.log(o.cyan(`  Execution ID: ${a}`)),console.log(o.gray(`  Workflow: ${l.workflow.name}`)),console.log(o.gray(`  Stages: ${l.workflow.steps.length}`)),console.log(""),t.watch){console.log(o.blue(`Workflow Progress:
+`));let g,y=Date.now();for(;;){let d=w.workflowOrchestrator.getWorkflowStatus(a);if(!d)break;if(!g||g.progress!==d.progress||g.status!==d.status||JSON.stringify(g.currentSteps)!==JSON.stringify(d.currentSteps)){process.stdout.write("\r\x1B[K");let S="\u2588".repeat(Math.floor(d.progress/5))+"\u2591".repeat(20-Math.floor(d.progress/5)),R=d.status==="completed"?o.green:d.status==="failed"?o.red:d.status==="running"?o.yellow:o.gray;console.log(`  [${S}] ${d.progress}% - ${R(d.status)}`),d.currentSteps.length>0&&t.verbose&&console.log(o.gray(`    Running: ${d.currentSteps.join(", ")}`)),g=d}if(d.status==="completed"||d.status==="failed"||d.status==="cancelled")break;await new Promise(S=>setTimeout(S,500))}let p=w.workflowOrchestrator.getWorkflowStatus(a);if(p){console.log("");let d=p.duration||Date.now()-y;p.status==="completed"?(console.log(o.green("Workflow completed successfully")),console.log(o.gray(`   Duration: ${$(d)}`)),console.log(o.gray(`   Completed: ${p.completedSteps.length} stages`)),p.skippedSteps.length>0&&console.log(o.yellow(`   Skipped: ${p.skippedSteps.length} stages`))):p.status==="failed"?(console.log(o.red("Workflow failed")),console.log(o.red(`   Error: ${p.error}`)),console.log(o.gray(`   Failed stages: ${p.failedSteps.join(", ")}`))):console.log(o.yellow(`Workflow ${p.status}`))}console.log(""),await i(p?.status==="completed"?0:1);return}else console.log(o.green("Workflow execution started")),console.log(o.gray(`   Use 'aqe workflow status ${a}' to check progress`));console.log(""),await i(0)}catch(l){console.error(o.red(`
+Failed to run workflow:`),l),await i(1)}}),m.command("schedule <file>").description("Schedule a QE pipeline for recurring execution").option("-c, --cron <expression>","Override cron schedule from file").option("-e, --enable","Enable immediately",!0).action(async(n,t)=>{if(!await h())return;let u=(await import("path")).resolve(n);try{console.log(o.blue(`
+Scheduling workflow from: ${n}
+`));let l=k(u);if(!l.success||!l.pipeline||!l.workflow){console.log(o.red("Failed to parse pipeline:"));for(let a of l.errors)console.log(o.red(`   ${a}`));await i(1)}let s=t.cron||l.pipeline.schedule;if(s||(console.log(o.red("No schedule specified")),console.log(o.gray('   Add "schedule" field to YAML or use --cron option')),await i(1)),!w.workflowOrchestrator.getWorkflow(l.workflow.id)){let a=w.workflowOrchestrator.registerWorkflow(l.workflow);a.success||(console.log(o.red(`Failed to register workflow: ${a.error.message}`)),await i(1))}let r=C({workflowId:l.workflow.id,pipelinePath:u,schedule:s,scheduleDescription:v(s),enabled:t.enable!==!1});await w.persistentScheduler.saveSchedule(r);let c={id:r.id,workflowId:r.workflowId,pipelinePath:r.pipelinePath,schedule:r.schedule,scheduleDescription:r.scheduleDescription,nextRun:new Date(r.nextRun),enabled:r.enabled,createdAt:new Date(r.createdAt)};w.scheduledWorkflows.set(c.id,c),console.log(o.green("Workflow scheduled successfully (persisted to disk)")),console.log(o.cyan(`   Schedule ID: ${r.id}`)),console.log(o.gray(`   Workflow: ${l.workflow.name}`)),console.log(o.gray(`   Schedule: ${s}`)),console.log(o.gray(`   Description: ${r.scheduleDescription}`)),console.log(o.gray(`   Next run: ${r.nextRun}`)),console.log(o.gray(`   Status: ${r.enabled?o.green("enabled"):o.yellow("disabled")}`)),console.log(o.yellow(`
+Note: Scheduled workflows require daemon mode to run automatically`)),console.log(o.gray("   Start daemon with: npx aqe daemon start")),console.log(o.gray("   Schedules are persisted to: ~/.aqe/schedules.json")),console.log(""),await i(0)}catch(l){console.error(o.red(`
+Failed to schedule workflow:`),l),await i(1)}}),m.command("list").description("List workflows").option("-s, --scheduled","Show only scheduled workflows").option("-a, --active","Show only active executions").option("--all","Show all workflows (registered + scheduled + active)").action(async n=>{if(await h())try{if(console.log(o.blue(`
+Workflows
+`)),n.scheduled||n.all){console.log(o.cyan("Scheduled Workflows:"));let t=await w.persistentScheduler.getSchedules();if(t.length===0)console.log(o.gray(`  No scheduled workflows
+`));else for(let e of t){let u=e.enabled?o.green("*"):o.gray("o");console.log(`  ${u} ${o.white(e.workflowId)}`),console.log(o.gray(`     ID: ${e.id}`)),console.log(o.gray(`     Schedule: ${e.schedule} (${e.scheduleDescription})`)),console.log(o.gray(`     File: ${e.pipelinePath}`)),console.log(o.gray(`     Next run: ${e.nextRun}`)),e.lastRun&&console.log(o.gray(`     Last run: ${e.lastRun}`)),console.log(o.gray(`     Status: ${e.enabled?o.green("enabled"):o.yellow("disabled")}`)),console.log("")}}if(n.active||n.all){console.log(o.cyan("Active Executions:"));let t=w.workflowOrchestrator.getActiveExecutions();if(t.length===0)console.log(o.gray(`  No active executions
+`));else for(let e of t){let u=e.status==="running"?o.yellow:o.gray;console.log(`  ${u("*")} ${o.white(e.workflowName)}`),console.log(o.gray(`     Execution: ${e.executionId}`)),console.log(o.gray(`     Status: ${e.status}`)),console.log(o.gray(`     Progress: ${e.progress}%`)),e.currentSteps.length>0&&console.log(o.gray(`     Current: ${e.currentSteps.join(", ")}`)),console.log("")}}if(!n.scheduled&&!n.active||n.all){console.log(o.cyan("Registered Workflows:"));let t=w.workflowOrchestrator.listWorkflows();if(t.length===0)console.log(o.gray(`  No registered workflows
+`));else for(let e of t)console.log(`  ${o.white(e.name)} (${o.cyan(e.id)})`),console.log(o.gray(`     Version: ${e.version}`)),console.log(o.gray(`     Steps: ${e.stepCount}`)),e.description&&console.log(o.gray(`     ${e.description}`)),e.tags&&e.tags.length>0&&console.log(o.gray(`     Tags: ${e.tags.join(", ")}`)),e.triggers&&e.triggers.length>0&&console.log(o.gray(`     Triggers: ${e.triggers.join(", ")}`)),console.log("")}await i(0)}catch(t){console.error(o.red(`
+Failed to list workflows:`),t),await i(1)}}),m.command("validate <file>").description("Validate a pipeline YAML file").option("-v, --verbose","Show detailed validation results").action(async(n,t)=>{let e=await import("fs"),l=(await import("path")).resolve(n);try{console.log(o.blue(`
+Validating pipeline: ${n}
+`)),e.existsSync(l)||(console.log(o.red(`File not found: ${l}`)),await i(1));let s=k(l);if(!s.success){console.log(o.red("Parse errors:"));for(let r of s.errors)console.log(o.red(`   * ${r}`));await i(1)}let f=W(s.pipeline);if(f.valid)console.log(o.green(`Pipeline is valid
+`));else{console.log(o.red(`Pipeline has errors:
+`));for(let r of f.errors)console.log(o.red(`   x [${r.path}] ${r.message}`));console.log("")}if(f.warnings.length>0){console.log(o.yellow("Warnings:"));for(let r of f.warnings)console.log(o.yellow(`   * [${r.path}] ${r.message}`));console.log("")}if(t.verbose&&s.pipeline){let r=s.pipeline;console.log(o.cyan(`Pipeline Details:
+`)),console.log(o.gray(`  Name: ${r.name}`)),console.log(o.gray(`  Version: ${r.version||"1.0.0"}`)),r.description&&console.log(o.gray(`  Description: ${r.description}`)),r.schedule&&console.log(o.gray(`  Schedule: ${r.schedule} (${v(r.schedule)})`)),r.tags&&r.tags.length>0&&console.log(o.gray(`  Tags: ${r.tags.join(", ")}`)),console.log(o.cyan(`
+  Stages:`));for(let c=0;c<r.stages.length;c++){let a=r.stages[c];console.log(`    ${c+1}. ${o.white(a.name)}`),console.log(o.gray(`       Command: ${a.command}`)),a.params&&console.log(o.gray(`       Params: ${JSON.stringify(a.params)}`)),a.depends_on&&a.depends_on.length>0&&console.log(o.gray(`       Depends on: ${a.depends_on.join(", ")}`)),a.timeout&&console.log(o.gray(`       Timeout: ${a.timeout}s`))}if(r.triggers&&r.triggers.length>0){console.log(o.cyan(`
+  Triggers:`));for(let c of r.triggers)console.log(o.gray(`    * ${c.event}`)),c.branches&&console.log(o.gray(`      Branches: ${c.branches.join(", ")}`))}}if(t.verbose&&s.workflow){console.log(o.cyan(`
+  Converted Workflow ID: `)+o.white(s.workflow.id)),console.log(o.gray(`  Steps: ${s.workflow.steps.length}`));for(let r of s.workflow.steps)console.log(o.gray(`    * ${r.id}: ${r.domain}.${r.action}`))}console.log(""),await i(f.valid?0:1)}catch(s){console.error(o.red(`
+Validation failed:`),s),await i(1)}}),m.command("status <executionId>").description("Get workflow execution status").option("-v, --verbose","Show detailed step results").action(async(n,t)=>{if(await h())try{let e=w.workflowOrchestrator.getWorkflowStatus(n);if(!e){console.log(o.red(`
+Execution not found: ${n}
+`)),await i(1);return}console.log(o.blue(`
+Workflow Execution Status
+`));let u=e.status==="completed"?o.green:e.status==="failed"?o.red:e.status==="running"?o.yellow:o.gray;console.log(`  Execution ID: ${o.cyan(e.executionId)}`),console.log(`  Workflow: ${o.white(e.workflowName)} (${e.workflowId})`),console.log(`  Status: ${u(e.status)}`),console.log(`  Progress: ${e.progress}%`),console.log(`  Started: ${e.startedAt.toISOString()}`),e.completedAt&&console.log(`  Completed: ${e.completedAt.toISOString()}`),e.duration&&console.log(`  Duration: ${$(e.duration)}`),console.log(o.cyan(`
+  Step Summary:`)),console.log(o.gray(`    Completed: ${e.completedSteps.length}`)),console.log(o.gray(`    Skipped: ${e.skippedSteps.length}`)),console.log(o.gray(`    Failed: ${e.failedSteps.length}`)),e.currentSteps.length>0&&console.log(o.yellow(`    Running: ${e.currentSteps.join(", ")}`)),e.error&&console.log(o.red(`
+  Error: ${e.error}`));for(let l of e.parallelCompositionReceipts??[]){console.log(`  Composition ${l.groupId}: ${l.disposition}`);for(let s of l.conflicts)console.log(`    ${s.kind}: ${s.stepA}.${s.pathA} / ${s.stepB}.${s.pathB}`)}if(t.verbose&&e.stepResults.size>0){console.log(o.cyan(`
+  Step Results:`));for(let[l,s]of e.stepResults){let f=s.status==="completed"?o.green:s.status==="failed"?o.red:s.status==="skipped"?o.yellow:o.gray;console.log(`    ${f("*")} ${o.white(l)}: ${f(s.status)}`),s.duration&&console.log(o.gray(`       Duration: ${$(s.duration)}`)),s.error&&console.log(o.red(`       Error: ${s.error}`)),s.retryCount&&s.retryCount>0&&console.log(o.yellow(`       Retries: ${s.retryCount}`))}}console.log(""),await i(0)}catch(e){console.error(o.red(`
+Failed to get workflow status:`),e),await i(1)}}),m.command("cancel <executionId>").description("Cancel a running workflow").action(async n=>{if(await h())try{let t=await w.workflowOrchestrator.cancelWorkflow(n);t.success?console.log(o.green(`
+Workflow cancelled: ${n}
+`)):console.log(o.red(`
+Failed to cancel workflow: ${t.error.message}
+`)),await i(t.success?0:1)}catch(t){console.error(o.red(`
+Failed to cancel workflow:`),t),await i(1)}}),m.command("browser-list").description("List available browser workflow templates").action(async()=>{try{let{BrowserWorkflowTool:n}=await import("./browser-workflow-2FZTKDUL.js"),e=await new n().invoke({});if(e.success&&e.data){console.log(o.blue(`
+ Browser Workflow Templates:
+`));for(let u of e.data.availableTemplates)console.log(`  ${o.cyan(u)}`);console.log("")}else console.log(o.red(`Failed: ${e.error||"Unknown error"}`));await i(0)}catch(n){console.error(o.red(`
+Failed:`),n),await i(1)}}),m.command("browser-load [template]").description("Load and validate a browser workflow template or inline YAML").option("--yaml <yaml>","Inline YAML workflow definition").option("-v, --var <key=value>","Variable override (repeatable)",O,{}).option("-F, --format <format>","Output format (text|json)","text").option("-o, --output <path>","Write output to file").action(async(n,t)=>{try{let{BrowserWorkflowTool:e}=await import("./browser-workflow-2FZTKDUL.js"),{writeOutput:u,toJSON:l}=await import("./ci-output-I7FX2RSO.js"),s=new e,f={variables:t.var||{}};if(t.yaml)f.workflowYaml=t.yaml;else if(n)if(n.endsWith(".yaml")||n.endsWith(".yml")){let c=await import("fs"),g=(await import("path")).resolve(n);c.existsSync(g)||(console.log(o.red(`
+File not found: ${g}
+`)),await i(1)),f.workflowYaml=c.readFileSync(g,"utf-8")}else f.templateName=n;else console.log(o.red(`
+Provide a template name or --yaml. Use "workflow browser-list" to see templates.
+`)),await i(1);console.log(o.blue(`
+ Loading browser workflow${n?": "+n:""}...
+`));let r=await s.invoke(f);if(r.success&&r.data){let c=r.data;if(t.format==="json")u(l(c),t.output);else{if(console.log(o.green(` Workflow: ${c.workflowName}`)),c.description&&console.log(o.gray(`  ${c.description}`)),console.log(`  Source: ${o.cyan(c.source)}`),console.log(`  Steps: ${o.white(c.steps.length)}`),c.steps.length>0){console.log(o.cyan(`
+  Steps:`));for(let a of c.steps){let g=a.optional?o.gray(" (optional)"):"",y=a.assertionCount>0?o.gray(` [${a.assertionCount} assertions]`):"";console.log(`    ${o.white(a.name)} \u2014 ${a.action}${g}${y}`)}}if(c.variables.defined.length>0){console.log(o.cyan(`
+  Variables:`));for(let a of c.variables.defined){let g=a.required?o.red("*"):"",y=a.hasDefault?o.gray(" (has default)"):"";console.log(`    ${g}${o.white(a.name)}: ${a.type}${y}`)}}if(!c.validation.valid){console.log(o.red(`
+  Validation errors:`));for(let a of c.validation.errors)console.log(o.red(`    - ${a}`))}console.log("")}await i(c.validation.valid?0:1)}else console.log(o.red(`Failed: ${r.error||"Unknown error"}`)),await i(1)}catch(e){console.error(o.red(`
+Failed:`),e),await i(1)}}),m}export{V as createWorkflowCommand};

package/dist/cli/chunks/workflow-orchestrator-DB3HIECD.js

@@ -0,0 +1,2 @@
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.14.4");process.exit(0)}
+import{a,b,c,d}from"./chunk-CDKG6EI7.js";import"./chunk-AUXFKCQL.js";import"./chunk-55RWDRJD.js";import"./chunk-R4VL6E65.js";import"./chunk-RJCYCLZV.js";import"./chunk-NA7B2QYB.js";import"./chunk-Y3MW3YBC.js";import"./chunk-PEPFCPES.js";import"./chunk-DHJPWQBR.js";import"./chunk-STM3UDNO.js";import"./chunk-G6T45OIC.js";import"./chunk-SRKETSFF.js";import"./chunk-BGE6FOLM.js";import"./chunk-5YPYDPBJ.js";import"./chunk-HDSAM2RE.js";import"./chunk-KCZR45PA.js";import"./chunk-BFP7KO7P.js";import"./chunk-ODKLFVYC.js";import"./chunk-VD6QRULW.js";import"./chunk-KHFNNVJA.js";import"./chunk-CNG6GQEZ.js";import"./chunk-TT23RRB7.js";export{b as DEFAULT_WORKFLOW_CONFIG,a as WorkflowEvents,c as WorkflowOrchestrator,d as createWorkflowOrchestrator};

package/dist/cli/chunks/{wrappers-DIJNNFU6.js → wrappers-SUS6XEJD.js}

@@ -1,2 +1,2 @@
-import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.14.3");process.exit(0)}
-import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v as L,w as M,x as N}from"./chunk-TTMHIOQ3.js";import{a as v,b as w,c as x,d as y,e as z,f as A,g as B,h as C,i as D,j as E,k as F,l as G,m as H,n as I,o as J,p as K}from"./chunk-F67AV5P2.js";import"./chunk-TFHQE6NK.js";import"./chunk-4RP5VUBI.js";import"./chunk-5F6DWHQG.js";import"./chunk-L2GKMBDP.js";import"./chunk-72UJXEKQ.js";import"./chunk-Y5SQBI2F.js";import"./chunk-YAKS3CAB.js";import"./chunk-HRUU7E3D.js";import"./chunk-MXMFGSWR.js";import"./chunk-VIDBBB6F.js";import"./chunk-PI74GOE4.js";import"./chunk-5IAB5NRZ.js";import"./chunk-OVDKWCD7.js";import"./chunk-XA7CG3LH.js";import"./chunk-YEXPFHV6.js";import"./chunk-IP7NSFQQ.js";import"./chunk-T35GZXTU.js";import"./chunk-Y2DVFVGI.js";export{z as GNNLayerFactory,i as QEFlashAttention,x as QEGNNEmbeddingIndex,y as QEGNNIndexFactory,a as QESONA,e as QE_FLASH_ATTENTION_CONFIG,g as QE_PERFORMANCE_TARGETS,f as QE_SONA_CONFIG,A as TensorCompressionFactory,u as batchComputeAttention,K as batchDifferentiableSearch,M as checkRuvectorPackagesAvailable,c as createDomainQESONA,j as createQEFlashAttention,b as createQESONA,D as getDifferentiableSearch,F as getGetCompressionLevel,E as getHierarchicalForward,G as getInit,h as getOptimalBlockConfig,k as getQEFlashAttentionConfig,n as getRuvectorDotProductAttention,m as getRuvectorFlashAttention,p as getRuvectorHyperbolicAttention,B as getRuvectorLayer,q as getRuvectorLinearAttention,r as getRuvectorMoEAttention,o as getRuvectorMultiHeadAttention,L as getRuvectorPackageVersions,C as getTensorCompress,l as getWorkloadTypes,N as initAllRuvectorPackages,w as initGNN,d as isAttentionAvailable,v as isGNNAvailable,s as toFloat32Array,H as toFloat32ArrayGNN,J as toIEmbedding,t as toNumberArrayAttn,I as toNumberArrayGNN};
+import{createRequire as __cr}from"module";const require=__cr(import.meta.url);if(process.argv.includes('--version')||process.argv.includes('-v')){console.log("3.14.4");process.exit(0)}
+import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v as L,w as M,x as N}from"./chunk-3QHGWY7T.js";import{a as v,b as w,c as x,d as y,e as z,f as A,g as B,h as C,i as D,j as E,k as F,l as G,m as H,n as I,o as J,p as K}from"./chunk-M2JBBZQB.js";import"./chunk-55RWDRJD.js";import"./chunk-R4VL6E65.js";import"./chunk-RJCYCLZV.js";import"./chunk-NA7B2QYB.js";import"./chunk-Y3MW3YBC.js";import"./chunk-PEPFCPES.js";import"./chunk-DHJPWQBR.js";import"./chunk-G6T45OIC.js";import"./chunk-BGE6FOLM.js";import"./chunk-5YPYDPBJ.js";import"./chunk-HDSAM2RE.js";import"./chunk-KCZR45PA.js";import"./chunk-BFP7KO7P.js";import"./chunk-ODKLFVYC.js";import"./chunk-VD6QRULW.js";import"./chunk-KHFNNVJA.js";import"./chunk-CNG6GQEZ.js";import"./chunk-TT23RRB7.js";export{z as GNNLayerFactory,i as QEFlashAttention,x as QEGNNEmbeddingIndex,y as QEGNNIndexFactory,a as QESONA,e as QE_FLASH_ATTENTION_CONFIG,g as QE_PERFORMANCE_TARGETS,f as QE_SONA_CONFIG,A as TensorCompressionFactory,u as batchComputeAttention,K as batchDifferentiableSearch,M as checkRuvectorPackagesAvailable,c as createDomainQESONA,j as createQEFlashAttention,b as createQESONA,D as getDifferentiableSearch,F as getGetCompressionLevel,E as getHierarchicalForward,G as getInit,h as getOptimalBlockConfig,k as getQEFlashAttentionConfig,n as getRuvectorDotProductAttention,m as getRuvectorFlashAttention,p as getRuvectorHyperbolicAttention,B as getRuvectorLayer,q as getRuvectorLinearAttention,r as getRuvectorMoEAttention,o as getRuvectorMultiHeadAttention,L as getRuvectorPackageVersions,C as getTensorCompress,l as getWorkloadTypes,N as initAllRuvectorPackages,w as initGNN,d as isAttentionAvailable,v as isGNNAvailable,s as toFloat32Array,H as toFloat32ArrayGNN,J as toIEmbedding,t as toNumberArrayAttn,I as toNumberArrayGNN};

package/dist/cli/commands/ci.js

@@ -12,10 +12,11 @@ import * as path from 'path';
 import { findCIConfigFile, parseCIConfigFile, getDefaultCIConfig, } from '../utils/ci-config.js';
 import { writeOutput, toJSON } from '../utils/ci-output.js';
 import { buildCoverageData } from '../utils/coverage-data.js';
+import { evaluateQualityEvidence, loadQualityEvidence, } from '../../domains/quality-assessment/quality-evidence.js';
 // ============================================================================
 // Phase Execution
 // ============================================================================
-async function executePhase(phase, context, outputDir, outputFormat) {
+async function executePhase(phase, context, outputDir, phaseIndex) {
     const startTime = Date.now();
     const artifacts = [];
     if (!phase.enabled) {
@@ -130,25 +131,25 @@ async function executePhase(phase, context, outputDir, outputFormat) {
                 break;
             }
             case 'quality-gate': {
-                const qualityAPI = await context.kernel.getDomainAPIAsync('quality-assessment');
-                if (!qualityAPI) {
-                    return makeResult(phase, startTime, 'failed', 1, 'Quality assessment domain not available', artifacts);
+                // Use the same evidence contract as `aqe quality --gate` and registered
+                // MCP quality_assess. The domain API has no evaluate() method.
+                try {
+                    const metrics = await loadQualityEvidence(context.kernel.memory);
+                    const assessment = evaluateQualityEvidence(metrics);
+                    details = { ...assessment, metrics, evidenceStatus: 'measured' };
+                    status = assessment.passed ? 'passed' : 'failed';
+                    summary = `Quality gate: ${assessment.passed ? 'PASSED' : 'FAILED'} (${assessment.checks.filter(check => check.passed).length}/${assessment.checks.length} measured checks passed)`;
                 }
-                const result = await qualityAPI.evaluate({ runGate: true, includeAdvice: true });
-                if (result.success && result.value) {
-                    const assessment = result.value;
-                    const passed = assessment.passed ?? assessment.meetsThreshold ?? true;
-                    details = { passed, score: assessment.score || assessment.grade, checks: assessment.checks };
-                    status = passed ? 'passed' : 'failed';
-                    summary = `Quality gate: ${passed ? 'PASSED' : 'FAILED'} (score: ${assessment.score || assessment.grade || 'N/A'})`;
-                    const artifactPath = path.join(outputDir, 'quality-gate.json');
-                    fs.writeFileSync(artifactPath, toJSON(assessment), 'utf-8');
-                    artifacts.push(artifactPath);
-                }
-                else {
+                catch (error) {
                     status = 'failed';
-                    summary = result.error?.message || 'Quality gate evaluation failed';
+                    summary = `Quality gate: ${error instanceof Error ? error.message : String(error)}`;
+                    details = { passed: false, evidenceStatus: 'unavailable', error: summary, checks: [] };
                 }
+                // Each gate owns its evidence. A later passing gate must not overwrite
+                // an earlier failure when a pipeline contains multiple gate phases.
+                const artifactPath = path.join(outputDir, `quality-gate-${phaseIndex + 1}.json`);
+                fs.writeFileSync(artifactPath, toJSON(details), 'utf-8');
+                artifacts.push(artifactPath);
                 break;
             }
             case 'code-intelligence': {
@@ -222,7 +223,7 @@ function generateCombinedReport(result) {
     let md = `# AQE CI/CD Report\n\n`;
     md += `**Status:** ${result.overallStatus === 'passed' ? 'PASSED' : result.overallStatus === 'warning' ? 'WARNING' : 'FAILED'}\n`;
     md += `**Duration:** ${(result.duration / 1000).toFixed(1)}s\n`;
-    md += `**Quality Gate:** ${result.qualityGatePassed ? 'Passed' : 'Failed'}\n\n`;
+    md += `**Quality Gate:** ${describeQualityGate(result)}\n\n`;
     md += `## Phases\n\n`;
     md += `| Phase | Type | Status | Duration | Summary |\n`;
     md += `|-------|------|--------|----------|---------|\n`;
@@ -244,6 +245,11 @@ function generateCombinedReport(result) {
     }
     return md;
 }
+function describeQualityGate(result) {
+    const status = result.qualityGateStatus === 'not-run' ? 'Not run' :
+        result.qualityGatePassed ? 'Passed' : 'Failed';
+    return `${status} (${result.qualityGateEnforced ? 'enforced' : 'advisory'})`;
+}
 // ============================================================================
 // Command
 // ============================================================================
@@ -318,15 +324,21 @@ export function createCICommand(context, cleanupAndExit, ensureInitialized) {
             // Create output directory
             const outputDir = path.resolve(config.output.directory);
             fs.mkdirSync(outputDir, { recursive: true });
+            const gateReportPath = path.join(outputDir, 'quality-gate.json');
+            // Invalidate an earlier approval before executing any phase. This also
+            // covers early stops, disabled gates, and --phase selections without a gate.
+            fs.writeFileSync(gateReportPath, toJSON({
+                passed: false, status: 'not-run', evidenceStatus: 'not-run',
+                enforced: config.qualityGate.enforced, phases: [],
+            }), 'utf-8');
             // Execute phases
             const phaseResults = [];
-            let pipelineFailed = false;
             for (const phase of config.phases) {
                 if (format === 'text') {
                     const spinner = `  [${phaseResults.length + 1}/${config.phases.length}] ${phase.name}...`;
                     process.stdout.write(chalk.cyan(spinner));
                 }
-                const result = await executePhase(phase, context, outputDir, config.output.format);
+                const result = await executePhase(phase, context, outputDir, phaseResults.length);
                 phaseResults.push(result);
                 if (format === 'text') {
                     const statusColor = result.status === 'passed' ? chalk.green :
@@ -339,8 +351,7 @@ export function createCICommand(context, cleanupAndExit, ensureInitialized) {
                         console.log(chalk.gray(`      ${result.summary}`));
                     }
                 }
-                if (result.status === 'failed') {
-                    pipelineFailed = true;
+                if (result.status === 'failed' && (result.type !== 'quality-gate' || config.qualityGate.enforced)) {
                     if (!phase.continueOnFailure) {
                         if (format === 'text') {
                             console.log(chalk.red(`\n  Pipeline stopped: "${phase.name}" failed (continue_on_failure: false)\n`));
@@ -350,11 +361,16 @@ export function createCICommand(context, cleanupAndExit, ensureInitialized) {
                 }
             }
             // Determine overall status
-            const hasFailure = phaseResults.some(r => r.status === 'failed');
-            const hasWarning = phaseResults.some(r => r.status === 'warning');
-            const qualityGateResult = phaseResults.find(r => r.type === 'quality-gate');
-            const qualityGatePassed = !config.qualityGate.enforced || !qualityGateResult || qualityGateResult.status === 'passed';
-            const overallStatus = hasFailure || !qualityGatePassed ? 'failed' :
+            const hasFailure = phaseResults.some(r => r.status === 'failed' && r.type !== 'quality-gate');
+            const hasWarning = phaseResults.some(r => r.status === 'warning' ||
+                (r.type === 'quality-gate' && r.status === 'failed' && !config.qualityGate.enforced));
+            const gateResults = phaseResults.filter(r => r.type === 'quality-gate');
+            const expectedGates = config.phases.filter(phase => phase.type === 'quality-gate').length;
+            const qualityGatePassed = gateResults.length > 0 && gateResults.length === expectedGates &&
+                gateResults.every(r => r.status === 'passed');
+            const qualityGateStatus = qualityGatePassed ? 'passed' :
+                gateResults.some(r => r.status === 'failed') ? 'failed' : 'not-run';
+            const overallStatus = hasFailure || (config.qualityGate.enforced && !qualityGatePassed) ? 'failed' :
                 hasWarning ? 'warning' : 'passed';
             const completedAt = new Date();
             const duration = completedAt.getTime() - startedAt.getTime();
@@ -365,9 +381,19 @@ export function createCICommand(context, cleanupAndExit, ensureInitialized) {
                 duration,
                 phases: phaseResults,
                 qualityGatePassed,
+                qualityGateStatus,
+                qualityGateEnforced: config.qualityGate.enforced,
                 overallStatus,
                 exitCode: overallStatus === 'failed' ? 1 : 0,
             };
+            fs.writeFileSync(gateReportPath, toJSON({
+                ...(gateResults.length === 1 ? gateResults[0].details : {}),
+                passed: qualityGatePassed,
+                status: qualityGateStatus,
+                enforced: config.qualityGate.enforced,
+                ...(qualityGateStatus === 'not-run' ? { evidenceStatus: 'not-run' } : {}),
+                phases: gateResults,
+            }), 'utf-8');
             // Write combined report
             if (config.output.combinedReport) {
                 const reportPath = path.join(outputDir, 'ci-report.md');
@@ -388,7 +414,7 @@ export function createCICommand(context, cleanupAndExit, ensureInitialized) {
                 const statusColor = overallStatus === 'passed' ? chalk.green :
                     overallStatus === 'failed' ? chalk.red : chalk.yellow;
                 console.log(`  ${statusColor(`Pipeline: ${overallStatus.toUpperCase()}`)} (${(duration / 1000).toFixed(1)}s)`);
-                console.log(`  Quality Gate: ${qualityGatePassed ? chalk.green('PASSED') : chalk.red('FAILED')}`);
+                console.log(`  Quality Gate: ${describeQualityGate(runResult)}`);
                 console.log(chalk.gray(`  Artifacts: ${outputDir}/`));
                 console.log('');
             }

package/dist/cli/commands/code.js

@@ -56,6 +56,12 @@ Examples:
                 const targetPath = path.resolve(target || '.');
                 let paths;
                 if (gitSince) {
+                    const { getGitRefError } = await import('../../shared/git/ref-validation.js');
+                    const refError = getGitRefError(gitSince, '--git-since ref');
+                    if (refError) {
+                        console.log(chalk.red(refError));
+                        return await cleanupAndExit(1);
+                    }
                     // Use git diff to find changed files since the ref
                     // SEC: Use execFileSync with array args to prevent shell injection (CWE-78)
                     const { execFileSync } = await import('child_process');

package/dist/cli/commands/eval.js

@@ -17,6 +17,7 @@ import * as path from 'path';
 import * as yaml from 'yaml';
 import { createParallelEvalRunner, DEFAULT_PARALLEL_EVAL_CONFIG, MockLLMExecutor, } from '../../validation/parallel-eval-runner.js';
 import { resolveEvalExecutor } from '../../validation/provider-llm-executor.js';
+import { DEFAULT_SONNET_MODEL } from '../../shared/llm/model-registry.js';
 import { createCommandEvalRunner, isCommandEvalSuite, } from '../../validation/command-eval-runner.js';
 import { createSkillValidationLearner, } from '../../learning/skill-validation-learner.js';
 import { createRealQEReasoningBank, } from '../../learning/real-qe-reasoning-bank.js';
@@ -585,7 +586,7 @@ export function createEvalCommand() {
         .command('run')
         .description('Run eval suite for a single skill')
         .requiredOption('-s, --skill <skill>', 'Skill name to evaluate')
-        .requiredOption('-m, --model <model>', 'Model to use (e.g., claude-sonnet-4-6)')
+        .requiredOption('-m, --model <model>', `Model to use (e.g., ${DEFAULT_SONNET_MODEL})`)
         .option('-p, --parallel', 'Enable parallel execution', false)
         .option('-w, --workers <n>', 'Number of parallel workers', parseInt, 5)
         .option('-b, --batch-size <n>', 'Test cases per batch', parseInt, 4)
@@ -615,7 +616,7 @@ export function createEvalCommand() {
         .command('run-all')
         .description('Run eval suites for multiple skills')
         .option('--skills-tier <tier>', 'Skill tier (1=all, 2=P0+P1, 3=P0 only)', parseInt, 3)
-        .option('--models <models>', 'Comma-separated models to test', 'claude-sonnet-4-6')
+        .option('--models <models>', 'Comma-separated models to test', DEFAULT_SONNET_MODEL)
         .option('-p, --parallel', 'Enable parallel execution', true)
         .option('-w, --workers <n>', 'Number of parallel workers', parseInt, 5)
         .option('-o, --output <path>', 'Output file path for report')

package/dist/cli/commands/fleet.js

@@ -4,8 +4,8 @@
  * Fleet operations with multi-agent progress tracking.
  */
 import { Command } from 'commander';
-import { secureRandomFloat } from '../../shared/utils/crypto-random.js';
 import chalk from 'chalk';
+import { loadCLIDomainPlugins } from '../helpers/domain-plugins.js';
 import { ALL_DOMAINS } from '../../shared/types/index.js';
 import { QEKernelImpl } from '../../kernel/kernel.js';
 import { CrossDomainEventRouter } from '../../coordination/cross-domain-router.js';
@@ -99,6 +99,7 @@ export function createFleetCommand(context, cleanupAndExit, ensureInitialized, r
                     enableExperienceBridge: false,
                 });
                 await context.kernel.initialize();
+                const domainPlugins = await loadCLIDomainPlugins(context.kernel.plugins);
                 console.log(chalk.green('  * Kernel initialized'));
                 context.router = new CrossDomainEventRouter(context.kernel.eventBus);
                 await context.router.initialize();
@@ -113,7 +114,7 @@ export function createFleetCommand(context, cleanupAndExit, ensureInitialized, r
                     return context.kernel.getDomainAPI(domain);
                 };
                 const protocolExecutor = new DefaultProtocolExecutor(context.kernel.eventBus, context.kernel.memory, getDomainAPI);
-                context.queen = createQueenCoordinator(context.kernel, context.router, protocolExecutor, undefined);
+                context.queen = createQueenCoordinator(context.kernel, context.router, protocolExecutor, undefined, domainPlugins);
                 await context.queen.initialize();
                 console.log(chalk.green('  * Queen coordinator initialized'));
                 context.initialized = true;
@@ -220,9 +221,15 @@ export function createFleetCommand(context, cleanupAndExit, ensureInitialized, r
         .option('--parallel <count>', 'Number of parallel agents', '4')
         .action(async (operation, options) => {
         if (!await ensureInitialized())
-            return;
+            return cleanupAndExit(1);
         try {
-            const parallelCount = parseInt(options.parallel, 10);
+            const parallelCount = Number(options.parallel);
+            if (!Number.isSafeInteger(parallelCount) || parallelCount < 1) {
+                throw new Error('--parallel must be a positive integer');
+            }
+            if (!['test', 'analyze', 'scan'].includes(operation)) {
+                throw new Error(`Unsupported operation: ${operation}`);
+            }
             console.log(chalk.blue(`\n Fleet Operation: ${operation}\n`));
             const progress = new FleetProgressManager({
                 title: `${operation.charAt(0).toUpperCase() + operation.slice(1)} Progress`,
@@ -234,7 +241,7 @@ export function createFleetCommand(context, cleanupAndExit, ensureInitialized, r
                 analyze: 'coverage-analysis',
                 scan: 'security-compliance',
             };
-            const domain = domainMap[operation] || 'test-generation';
+            const domain = domainMap[operation];
             const agentOperations = Array.from({ length: parallelCount }, (_, i) => {
                 const agentId = `${operation}-agent-${i + 1}`;
                 return {
@@ -251,16 +258,9 @@ export function createFleetCommand(context, cleanupAndExit, ensureInitialized, r
                     progress: 0,
                 });
             }
-            const results = await Promise.all(agentOperations.map(async (op, index) => {
-                await new Promise(resolve => setTimeout(resolve, index * 200));
+            const results = await Promise.all(agentOperations.map(async (op) => {
                 progress.updateAgent(op.id, 0, { status: 'running' });
                 try {
-                    for (let p = 10; p <= 90; p += 20) {
-                        await new Promise(resolve => setTimeout(resolve, secureRandomFloat(300, 500)));
-                        progress.updateAgent(op.id, p, {
-                            eta: Math.round((100 - p) * 50),
-                        });
-                    }
                     const taskResult = await context.queen.submitTask({
                         type: operation === 'test' ? 'generate-tests' :
                             operation === 'analyze' ? 'analyze-coverage' :
@@ -270,10 +270,29 @@ export function createFleetCommand(context, cleanupAndExit, ensureInitialized, r
                         payload: { target: options.target, workerId: op.id },
                         timeout: 60000,
                     });
-                    progress.completeAgent(op.id, taskResult.success);
-                    return { id: op.id, success: taskResult.success };
+                    if (!taskResult.success) {
+                        throw taskResult.error;
+                    }
+                    // Submission is only an acknowledgement. Keep the process alive
+                    // until the domain reports a terminal result or the task expires.
+                    const deadline = Date.now() + 60000;
+                    while (Date.now() < deadline) {
+                        const task = context.queen.getTaskStatus(taskResult.value);
+                        if (!task)
+                            throw new Error(`Task status unavailable: ${taskResult.value}`);
+                        if (task.status === 'completed') {
+                            progress.completeAgent(op.id, true);
+                            return { id: op.id, success: true };
+                        }
+                        if (task.status === 'failed' || task.status === 'cancelled') {
+                            throw new Error(task.error || `Task ${task.status}`);
+                        }
+                        await new Promise(resolve => setTimeout(resolve, 250));
+                    }
+                    throw new Error(`Task timed out: ${taskResult.value}`);
                 }
-                catch {
+                catch (error) {
+                    console.error(chalk.red(`   ${op.name}: ${error instanceof Error ? error.message : String(error)}`));
                     progress.completeAgent(op.id, false);
                     return { id: op.id, success: false };
                 }

package/dist/cli/commands/learning-snapshot.d.ts

@@ -0,0 +1,38 @@
+interface SnapshotInfo {
+    schemaVersion: number;
+    pages: number;
+    verification: {
+        valid: true;
+        message: string;
+    };
+}
+export interface LearningBackupResult {
+    backupPath: string;
+    sourceSizeKB: number;
+    backupSizeKB: number;
+    compressed: boolean;
+    schemaVersion: number;
+    verification: SnapshotInfo['verification'];
+}
+/** Publish only a complete standalone image; the existing artifact survives staging failures. */
+export declare function backupLearningDatabase(source: string, output: string, options?: {
+    compress?: boolean;
+    verify?: boolean;
+}): Promise<LearningBackupResult>;
+export interface LearningRestoreResult {
+    sizeKB: number;
+    schemaVersion: number;
+    wasCompressed: boolean;
+    safetyBackupPath?: string;
+}
+/**
+ * Validate before replacing anything and retain a verified pre-restore image.
+ * SQLite mediates the destination write: never unlink its DB/WAL/SHM files.
+ * Stop project writers before restore; this does not coordinate later writes
+ * from other processes or refresh their in-memory learning caches.
+ */
+export declare function restoreLearningDatabase(input: string, destination: string, options?: {
+    force?: boolean;
+}): Promise<LearningRestoreResult>;
+export {};
+//# sourceMappingURL=learning-snapshot.d.ts.map

package/dist/cli/commands/learning-snapshot.js

@@ -0,0 +1,171 @@
+/** Consistent, verified SQLite images for the learning backup/restore commands. */
+import { existsSync, realpathSync, statSync } from 'node:fs';
+import { mkdir, mkdtemp, rename, rm, stat } from 'node:fs/promises';
+import { basename, dirname, join, resolve } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { openDatabase } from '../../shared/safe-db.js';
+import { compressFile, decompressFile } from './learning-helpers.js';
+function inspectSnapshot(file) {
+    const db = openDatabase(file, { readonly: true, fileMustExist: true });
+    try {
+        const checks = db.pragma('integrity_check');
+        if (checks.length !== 1 || checks[0].integrity_check !== 'ok') {
+            throw new Error('Database integrity verification failed');
+        }
+        const hasVersion = db.prepare("SELECT 1 FROM sqlite_master WHERE type='table' AND name='schema_version'").get();
+        const version = hasVersion
+            ? db.prepare('SELECT version FROM schema_version WHERE id = 1').get()
+            : undefined;
+        return {
+            schemaVersion: version?.version ?? 0,
+            pages: db.pragma('page_count', { simple: true }),
+            verification: { valid: true, message: 'Database integrity verified' },
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+function canonicalPath(file) {
+    return existsSync(file) ? realpathSync(file) : join(realpathSync(dirname(file)), basename(file));
+}
+function sameFile(left, right) {
+    if (canonicalPath(left) === canonicalPath(right))
+        return true;
+    if (!existsSync(left) || !existsSync(right))
+        return false;
+    const a = statSync(left);
+    const b = statSync(right);
+    return a.dev === b.dev && a.ino === b.ino;
+}
+function assertDistinct(source, destination) {
+    const sourcePath = canonicalPath(source);
+    const destinationPath = canonicalPath(destination);
+    for (const suffix of ['', '-wal', '-shm', '-journal']) {
+        if (sameFile(`${sourcePath}${suffix}`, destination)
+            || sameFile(source, `${destinationPath}${suffix}`)) {
+            throw new Error('Backup source and destination must not alias the same database or its sidecars');
+        }
+    }
+}
+function assertRegularFile(file) {
+    if (!statSync(file).isFile())
+        throw new Error('Backup input must be a regular file');
+}
+/** Awaiting backup alone is insufficient: a busy destination can report 0/0. */
+async function copySqliteSnapshot(source, destination, options = {}) {
+    const db = openDatabase(source, { readonly: true, fileMustExist: true });
+    try {
+        const result = await db.backup(destination);
+        if (result.totalPages <= 0 || result.remainingPages !== 0
+            || (options.expectedPages !== undefined && result.totalPages !== options.expectedPages)) {
+            throw new Error('SQLite snapshot did not complete; the source may be empty or the destination busy');
+        }
+        if (options.standalone) {
+            // Only private new images are normalized. A WAL header otherwise makes
+            // SQLite try to create sidecars when reading an archive on readonly media.
+            const image = openDatabase(destination, { fileMustExist: true, walMode: false });
+            try {
+                if (image.pragma('journal_mode = DELETE', { simple: true }) !== 'delete') {
+                    throw new Error('Could not create a standalone SQLite image');
+                }
+            }
+            finally {
+                image.close();
+            }
+        }
+        const inspected = inspectSnapshot(destination);
+        if (inspected.pages !== result.totalPages) {
+            throw new Error('SQLite snapshot page count does not match the completed backup');
+        }
+        return inspected;
+    }
+    finally {
+        db.close();
+    }
+}
+/** Publish only a complete standalone image; the existing artifact survives staging failures. */
+export async function backupLearningDatabase(source, output, options = {}) {
+    assertRegularFile(source);
+    const finalPath = resolve(options.compress ? `${output}.gz` : output);
+    await mkdir(dirname(finalPath), { recursive: true });
+    assertDistinct(source, resolve(output));
+    assertDistinct(source, finalPath);
+    const staging = await mkdtemp(join(dirname(finalPath), '.aqe-backup-'));
+    try {
+        const image = join(staging, 'snapshot.db');
+        const info = await copySqliteSnapshot(source, image, { standalone: true });
+        const published = options.compress ? await compressFile(image) : image;
+        if (options.compress && options.verify) {
+            const checkedImage = join(staging, 'verified.db');
+            await decompressFile(published, checkedImage);
+            inspectSnapshot(checkedImage);
+        }
+        const sourceSizeKB = Number(((await stat(source)).size / 1024).toFixed(2));
+        const backupSizeKB = Number(((await stat(published)).size / 1024).toFixed(2));
+        // An existing DB+WAL pair may be live. Never replace its main file while
+        // leaving old sidecars that could be replayed against the new image.
+        if (['-wal', '-shm', '-journal'].some(suffix => existsSync(`${finalPath}${suffix}`))) {
+            throw new Error('Backup destination has SQLite sidecars; choose an unused output path');
+        }
+        await rename(published, finalPath);
+        return { backupPath: finalPath, sourceSizeKB, backupSizeKB, compressed: !!options.compress,
+            schemaVersion: info.schemaVersion, verification: info.verification };
+    }
+    finally {
+        await rm(staging, { recursive: true, force: true });
+    }
+}
+/**
+ * Validate before replacing anything and retain a verified pre-restore image.
+ * SQLite mediates the destination write: never unlink its DB/WAL/SHM files.
+ * Stop project writers before restore; this does not coordinate later writes
+ * from other processes or refresh their in-memory learning caches.
+ */
+export async function restoreLearningDatabase(input, destination, options = {}) {
+    assertRegularFile(input);
+    await mkdir(dirname(destination), { recursive: true });
+    assertDistinct(input, destination);
+    if (existsSync(destination) && !options.force) {
+        throw new Error(`Database already exists at: ${destination}. Use --force to overwrite`);
+    }
+    const staging = await mkdtemp(join(dirname(destination), '.aqe-restore-'));
+    let safetyBackupPath;
+    try {
+        const wasCompressed = input.endsWith('.gz');
+        const image = join(staging, 'snapshot.db');
+        let source = input;
+        if (wasCompressed) {
+            source = join(staging, 'decompressed.db');
+            await decompressFile(input, source);
+        }
+        // A legacy uncompressed backup may still need its companion WAL.
+        const info = await copySqliteSnapshot(source, image, { standalone: true });
+        const sizeKB = Number(((await stat(image)).size / 1024).toFixed(2));
+        if (existsSync(destination)) {
+            const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+            const candidate = `${destination}.pre-restore-${timestamp}-${randomUUID()}.db`;
+            try {
+                await copySqliteSnapshot(destination, candidate, { standalone: true });
+                safetyBackupPath = candidate;
+            }
+            catch (error) {
+                await rm(candidate, { force: true });
+                throw new Error('Cannot create a verified safety backup of the existing database; restore refused. Stop project processes and preserve the database and its sidecars before restoring into an absent destination.', { cause: error });
+            }
+        }
+        await copySqliteSnapshot(image, destination, { expectedPages: info.pages });
+        return { sizeKB, schemaVersion: info.schemaVersion, wasCompressed, safetyBackupPath };
+    }
+    catch (error) {
+        if (safetyBackupPath) {
+            const detail = error instanceof Error ? error.message : 'SQLite snapshot failed';
+            throw new Error(`Restore failed: ${detail}; previous database snapshot preserved at ${safetyBackupPath}`, { cause: error });
+        }
+        throw error;
+    }
+    finally {
+        await rm(staging, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=learning-snapshot.js.map