aimship 0.1.0-preview.11 → 0.1.0-preview.13

package/skills/aimship/references/stages/frame.md

@@ -20,4 +20,4 @@ Use [the shared core](../core.md) for state, evidence and continuation rules. Re
 
 ## Artifact contract
 
-Use the selected PRD/Scope requirement entry. Preserve the `goals` section anchor (Scope uses adoption/goals as applicable). Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+Use the selected PRD/Scope requirement entry. Preserve the ordinary template headings and section order. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.

package/skills/aimship/references/stages/handoff.md

@@ -20,6 +20,6 @@ Use [the shared core](../core.md) for state, evidence and continuation rules. Re
 
 ## Artifact contract
 
-Use handoff.md. Preserve the `outcomes` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+Use handoff.md. Preserve the ordinary template headings and section order. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
 
 Use the derived completion assessment alongside goal and acceptance. A user-authorized scope without cases/verification may be finished as an explicitly untested partial handoff, never standard complete delivery. No next-session prompt is needed at the final endpoint.

package/skills/aimship/references/stages/implement.md

@@ -20,6 +20,6 @@ Use [the shared core](../core.md) for state, evidence and continuation rules. Re
 
 ## Artifact contract
 
-Use plan.md. Preserve the `execution` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+Use plan.md. Preserve the ordinary template headings and section order. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
 
-Update TASK/B status and actual execution in the existing plan.md, preserving planned versus actual and code versions. Do not generate implementation.md.
+Update TASK/B status and actual execution in plan.md's execution section, citing the existing task/batch numbers. Keep approved task definitions unchanged unless the plan itself changes; preserve planned versus actual and code versions. Do not generate implementation.md.

package/skills/aimship/references/stages/plan.md

@@ -20,7 +20,7 @@ Use [the shared core](../core.md) for state, evidence and continuation rules. Re
 
 ## Artifact contract
 
-Use plan.md. Preserve the `tasks` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+Use plan.md. Preserve the ordinary template headings and section order. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
 
 ## Human document review
 

package/skills/aimship/references/stages/requirements.md

@@ -20,7 +20,7 @@ Use [the shared core](../core.md) for state, evidence and continuation rules. Re
 
 ## Artifact contract
 
-Use the selected PRD/Scope requirement entry. Preserve the `requirements` section anchor (Scope uses adoption/goals as applicable). Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+Use the selected PRD/Scope requirement entry. Preserve the ordinary template headings and section order. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
 
 ## Human document review
 

package/skills/aimship/references/stages/review.md

@@ -20,6 +20,6 @@ Use [the shared core](../core.md) for state, evidence and continuation rules. Re
 
 ## Artifact contract
 
-Use review.md. Preserve the `reviews` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+Use review.md. Preserve the ordinary template headings and section order. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
 
 Record reviewOf with the actual implementation-run IDs; mark overall: true only for an overall review. The batch review shares that batch’s suggested session, while overall review has its own suggestion. Resolve findings before continuation; a suggestion never substitutes for a passing review.

package/skills/aimship/references/stages/scope.md

@@ -20,7 +20,7 @@ Use [the shared core](../core.md) for state, evidence and continuation rules. Re
 
 ## Artifact contract
 
-Use the selected PRD/Scope requirement entry. Preserve the `scope` section anchor (Scope uses adoption/goals as applicable). Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+Use the selected PRD/Scope requirement entry. Preserve the ordinary template headings and section order. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
 
 ## Human document review
 

package/skills/aimship/references/stages/tech-design.md

@@ -20,7 +20,7 @@ Use [the shared core](../core.md) for state, evidence and continuation rules. Re
 
 ## Artifact contract
 
-Use tech-design.md. Preserve the `coverage` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+Use tech-design.md. Preserve the ordinary template headings and section order. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
 
 Technical design does not require finished SQL before its review. After its approval, contract produces and presents database.sql for one target, or database-<id>.sql per independent target. No SQL for no database change.
 

package/skills/aimship/references/stages/test-design.md

@@ -20,7 +20,7 @@ Use [the shared core](../core.md) for state, evidence and continuation rules. Re
 
 ## Artifact contract
 
-Use testing.md. Preserve the `cases` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+Use testing.md. Preserve the ordinary template headings and section order. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
 
 ## Human document review
 

package/skills/aimship/references/stages/verify.md

@@ -20,6 +20,6 @@ Use [the shared core](../core.md) for state, evidence and continuation rules. Re
 
 ## Artifact contract
 
-Use testing.md. Preserve the `runs` section anchor. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
+Use testing.md. Preserve the ordinary template headings and section order. Follow [document patterns](../document-patterns.md) and the single [artifact map](../artifact-map.json). Keep this run independent even when its document is shared. New runs need a precise result location; adopted work is not a newly executed stage.
 
-Append RUN records in testing.md, referencing versioned TC and exact objects. Evidence goes in .aimship/evidence/; no installation diagnostics or repeated state output in ordinary deliveries.
+Append RUN records in testing.md, citing TC numbers, the tested document version and exact objects. Evidence goes in .aimship/evidence/; no installation diagnostics or repeated state output in ordinary deliveries.

package/skills/aimship/references/templates/change-log.md

@@ -2,12 +2,10 @@
 
 Delivery: <deliveryId from init>; document revision: <revision>.
 
-<a id="changes"></a>
 ## Important changes
 
 CHG, reason/decision source, before/after, affected IDs/objects, actions/results and remaining work. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="remaining"></a>
 ## Unfinished impact handling
 
 One decision stays one record; no edit audit. Replace guidance with actual content; explain inapplicability, never prefill a result.

package/skills/aimship/references/templates/diagnosis.md

@@ -2,37 +2,30 @@
 
 Delivery: <deliveryId from init>; document revision: <revision>.
 
-<a id="goals"></a>
 ## Investigation goal and scope
 
 Commission and authorized scope. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="symptoms"></a>
 ## Observed and expected behavior
 
 Facts versus hypotheses. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="environment"></a>
 ## Environment and reproduction
 
 Exact versions and reproducible conditions. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="evidence"></a>
 ## Checks and evidence
 
 Operations, observations and source refs. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="causes"></a>
 ## Cause assessment
 
 Confirmed causes versus unverified hypotheses. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="unknowns"></a>
 ## Impact and unknowns
 
 Dependent work and recovery conditions. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="conclusion"></a>
 ## Conclusion and next action
 
 Investigation endpoint is not automatically repair completion. Replace guidance with actual content; explain inapplicability, never prefill a result.

package/skills/aimship/references/templates/handoff.md

@@ -2,32 +2,26 @@
 
 Delivery: <deliveryId from init>; document revision: <revision>.
 
-<a id="goals"></a>
 ## Current goal comparison
 
 REQ/AC and actual results, including explicit goal changes. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="artifacts"></a>
 ## Artifacts, repositories and versions
 
 Links, actual checkout/worktree, branch/commit and uncommitted paths; no Git uses file digests. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="usage"></a>
 ## Usage
 
 Actual commands and entry points. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="results"></a>
 ## Review and verification
 
 Scopes, versions, results and evidence. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="limits"></a>
 ## Limitations and remaining work
 
 Unverified work and recovery conditions. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="outcomes"></a>
 ## Acceptance, integration, release and continuation
 
 Independent facts; prepared version is not a release. Replace guidance with actual content; explain inapplicability, never prefill a result.

package/skills/aimship/references/templates/plan.md

@@ -2,32 +2,26 @@
 
 Delivery: <deliveryId from init>; document revision: <revision>.
 
-<a id="basis"></a>
 ## Implementation basis and scope
 
 Current requirements, design, contracts and actual repositories. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="batches"></a>
 ## Batches and dependencies
 
 B ID, goal, dependencies and integration arrangement. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="tasks"></a>
 ## Tasks and completion criteria
 
-TASK, batch, REQ/AC or risk, repository ID, file/module, planned change, completion criteria, status, artifact ref. Replace guidance with actual content; explain inapplicability, never prefill a result.
+TASK, batch, REQ/AC or risk, repository ID, file/module, planned change and completion criteria. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="validation"></a>
 ## Review and independent verification arrangement
 
 Each batch review, overall review then independent verification; no per-batch full test gates. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="execution"></a>
 ## Task status and execution records
 
-Actual changes and object versions by TASK/B; preserve original plan and distinguish pre-existing changes. Replace guidance with actual content; explain inapplicability, never prefill a result.
+Current status, actual changes, artifact references and object versions by existing TASK/B; preserve the approved tasks above and distinguish pre-existing changes. Record progress here, for example a table of Task | Status | Actual result. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="remaining"></a>
 ## Deviations, blockers and remaining work
 
 Unfinished effects and recovery, not a second stage ledger. Replace guidance with actual content; explain inapplicability, never prefill a result.

package/skills/aimship/references/templates/prd.md

@@ -2,37 +2,30 @@
 
 Delivery: <deliveryId from init>; document revision: <revision>.
 
-<a id="info"></a>
 ## Document information and sources
 
 Identify this delivery, revision and adopted inputs. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="goals"></a>
 ## Background, goals and non-goals
 
 Separate known facts, requirements and assumptions. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="scope"></a>
 ## Scope, engineering objects and endpoint
 
 Included/excluded work, repository IDs, authorization and endpoint. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="requirements"></a>
 ## Requirements and behavior
 
 REQ, type, actor/object, trigger/precondition, behavior, observable result, boundaries/errors, source and AC. Shared business rules, access control (even one role), performance and reliability need independent identity when independently testable. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="states"></a>
 ## States, interaction and recovery
 
 Allowed transitions, terminal states, errors and recovery; say why inapplicable. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="acceptance"></a>
 ## Acceptance criteria
 
 AC, requirement reference, condition, operation, decidable expected result. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="arrangement"></a>
 ## Dependencies, questions and stage arrangement
 
 Selected order, artifact locations/reuse, dependencies, Q with impact/status/decision source. Replace guidance with actual content; explain inapplicability, never prefill a result.

package/skills/aimship/references/templates/review.md

@@ -2,17 +2,14 @@
 
 Delivery: <deliveryId from init>; document revision: <revision>.
 
-<a id="basis"></a>
 ## Review basis and scope
 
 Exact repositories/objects, baseline and differences. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="reviews"></a>
 ## Review records
 
 REV, batch/overall/repair scope, TASK/REQ/AC, reviewer/date, findings, dispositions and recheck conclusions. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="conclusion"></a>
 ## Open findings and current conclusion
 
 Preserve historical findings and old object basis; review is not execution. Replace guidance with actual content; explain inapplicability, never prefill a result.

package/skills/aimship/references/templates/scope.md

@@ -2,37 +2,30 @@
 
 Delivery: <deliveryId from init>; document revision: <revision>.
 
-<a id="info"></a>
 ## Document information and source versions
 
 Delivery identity and adopted versions. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="goals"></a>
 ## Goal, engineering objects and endpoint
 
 Actual repository IDs, authorized objects and endpoint. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="adoption"></a>
 ## Source mapping and adopted scope
 
 Source/version/original ID or section, adoption decision, requirement reference, AC and gaps; do not copy the full PRD. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="exclusions"></a>
 ## Exclusions and constraints
 
 Explicitly delimit this commission. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="decisions"></a>
 ## Conflicts, gaps and supplementary decisions
 
 Preserve sources; identify decision authority and pending source updates. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="acceptance"></a>
 ## Acceptance basis
 
 AC, requirement/source identity, conditions, actions and expected results. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="arrangement"></a>
 ## Authorization, questions and stage arrangement
 
 Selected order, artifact locations/reuse, permissions and open Q. Replace guidance with actual content; explain inapplicability, never prefill a result.

package/skills/aimship/references/templates/tech-design.md

@@ -2,37 +2,30 @@
 
 Delivery: <deliveryId from init>; document revision: <revision>.
 
-<a id="basis"></a>
 ## Basis and engineering context
 
 Current requirements and actual engineering constraints. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="architecture"></a>
 ## Architecture and key flows
 
 Ordered explanation or diagram of the important flow. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="modules"></a>
 ## Modules and interaction implementation
 
 Repository ID, responsibility, actual path, new/change, requirement refs; entry/state/data flow for interaction. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="data"></a>
 ## Data, interfaces and SQL
 
 Structures, indexes, consistency, contract authority, database type/version/schema basis, SQL order and execution boundary. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="errors"></a>
 ## Errors and nonfunctional design
 
 Recovery, access, performance, observability, cache/messages when relevant. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="risks"></a>
 ## Tradeoffs and risks
 
 Reasons, alternatives, compatibility and technical risks. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="coverage"></a>
 ## Requirement coverage and questions
 
 REQ/AC to module/operation/SQL section and unresolved Q. Replace guidance with actual content; explain inapplicability, never prefill a result.

package/skills/aimship/references/templates/testing.md

@@ -2,32 +2,26 @@
 
 Delivery: <deliveryId from init>; document revision: <revision>.
 
-<a id="basis"></a>
 ## Basis and scope
 
 Current AC and risks; adopted cases location/version if verify-only. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="environment"></a>
 ## Environment, data and execution conditions
 
 Tools, permissions, commands and unavailable conditions. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="cases"></a>
 ## Test cases
 
-TC, case version, REQ/AC or risk, type/level, preconditions, operations, concrete expected result, method/entry. Replace guidance with actual content; explain inapplicability, never prefill a result.
+TC, REQ/AC or risk, type/level, preconditions, operations, concrete expected result, method/entry. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="coverage"></a>
 ## Coverage and verification arrangement
 
 AC, requirements, TC, gaps and execution group/order. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="runs"></a>
 ## Execution and retest records
 
-RUN, TC@version, exact code/build or document object, command/operation, assertions, actual results and evidence. Not executed until actually run; append failures/retests. Replace guidance with actual content; explain inapplicability, never prefill a result.
+RUN, TC, testing document version, exact code/build or document object, command/operation, assertions, actual results and evidence. Not executed until actually run; append failures/retests. Replace guidance with actual content; explain inapplicability, never prefill a result.
 
-<a id="conclusion"></a>
 ## Defects, current conclusion and remaining work
 
 Separate passed, failed, blocked and unexecuted; explain applicability after change. Replace guidance with actual content; explain inapplicability, never prefill a result.

package/lib/migrate.mjs

@@ -1,77 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { atomicWrite, exists, fail, hash, json, noSymlinks, readJSON, withLock } from './io.mjs';
-import { statePaths, validateState, assertInstallationComplete, readState } from './state.mjs';
-import { savedResult } from './view.mjs';
-
-export async function migrateState(directory, revision, rulesVersion, runtime, input) {
-  assertInstallationComplete(runtime);
-  if (rulesVersion !== runtime.version || runtime.version !== runtime.activeVersion) fail('VERSION_MISMATCH','Migration requires the active tool.','Bind the active version.');
-  if (!input || Object.keys(input).length !== 1 || typeof input.compatibilityRef !== 'string' || !input.compatibilityRef.trim()) fail('USAGE','Migration input is {compatibilityRef}.','Record the assessment and old/new document disposition first.');
-  const old=statePaths(directory,true), modern=statePaths(directory);
-  await noSymlinks(modern.internal); await fs.mkdir(modern.internal,{recursive:true});
-  return withLock(old.lock,()=>withLock(modern.lock,async()=>{
-    const journalPath=path.join(modern.internal,'migration.json');
-    for (const file of [journalPath,old.statePath,old.backup,modern.statePath,path.join(modern.internal,'legacy/state.json'),path.join(modern.internal,'legacy/state.previous.json')]) await noSymlinks(file);
-    let journal;
-    if (await exists(journalPath)) {
-      journal=await readJSON(journalPath);
-      if (journal.protocol !== 1 || journal.revision !== revision || journal.compatibilityRef !== input.compatibilityRef) fail('MIGRATION_CONFLICT','Migration parameters or journal differ.','Inspect recorded migration; never overwrite the copies.');
-      if (journal.status==='complete') {
-        if (await exists(old.statePath)) fail('LAYOUT_CONFLICT','A root state reappeared after migration.','Inspect both states before proceeding.');
-        return {state:(await readState(directory)).state,migration:'already-complete'};
-      }
-    } else {
-      if (await exists(modern.statePath) || await exists(modern.backup)) fail('LAYOUT_CONFLICT','Target state/recovery already exists.','Inspect both layouts; do not merge by timestamp.');
-      await noSymlinks(old.statePath); await noSymlinks(old.backup);
-      const raw=await fs.readFile(old.statePath,'utf8'), state=JSON.parse(raw);
-      validateState(state);
-      if (state.schemaVersion!==1) fail('UNKNOWN_SCHEMA','Only schema 1 root state can migrate.','Keep unknown formats read-only.');
-      if (state.revision!==revision) fail('REVISION_CONFLICT','Legacy revision changed.','Read and reassess before migration.');
-      const next={...state,schemaVersion:2,revision:state.revision+1,updatedAt:new Date().toISOString(),documentPolicy:{authority:'legacy'},documents:[],legacyRunIds:state.stageRuns.map(r=>r.id),migration:{fromSchema:1,compatibilityRef:input.compatibilityRef}};
-      // validate the assessment reference with the ordinary state reference protocol.
-      validateState({...next,next:{...next.next,inputRefs:[input.compatibilityRef]}});
-      const backupRaw=await exists(old.backup)?await fs.readFile(old.backup,'utf8'):null;
-      journal={protocol:1,status:'prepared',revision,compatibilityRef:input.compatibilityRef,sourceHash:hash(raw),backupHash:backupRaw===null?null:hash(backupRaw),targetHash:hash(json(next)),target:next};
-      const legacyDir=path.join(modern.internal,'legacy'); await noSymlinks(legacyDir); await fs.mkdir(legacyDir,{recursive:true});
-      for (const [name,bytes] of [['state.json',raw],['state.previous.json',backupRaw]]) {
-        if(bytes===null) continue;
-        const file=path.join(legacyDir,name);
-        if(await exists(file) && hash(await fs.readFile(file))!==hash(bytes)) fail('MIGRATION_CONFLICT','Legacy backup differs.','Preserve all copies and resolve manually.');
-        if(!await exists(file)) await atomicWrite(file,bytes);
-      }
-      await atomicWrite(journalPath,json(journal));
-    }
-    validateState(journal.target);
-    if (hash(json(journal.target))!==journal.targetHash) fail('MIGRATION_CONFLICT','Migration target checksum changed.','Inspect journal and preserved source.');
-    const legacyCopy=path.join(modern.internal,'legacy/state.json');
-    if(hash(await fs.readFile(legacyCopy))!==journal.sourceHash) fail('MIGRATION_CONFLICT','Preserved source changed.','Recover the original source before resuming.');
-    const recoveryCopy=path.join(modern.internal,'legacy/state.previous.json');
-    if (journal.backupHash !== null && (!await exists(recoveryCopy) || hash(await fs.readFile(recoveryCopy))!==journal.backupHash)) fail('MIGRATION_CONFLICT','Preserved recovery copy is missing or changed.','Repair the preserved copy from the original recovery material before resuming.');
-    if(await exists(old.statePath) && hash(await fs.readFile(old.statePath))!==journal.sourceHash) fail('MIGRATION_CONFLICT','Legacy state changed during migration.','Reconcile facts; do not overwrite either copy.');
-    if(await exists(modern.statePath) && hash(await fs.readFile(modern.statePath))!==journal.targetHash) fail('MIGRATION_CONFLICT','Target state changed during migration.','Reconcile both states.');
-    if(await exists(old.backup) && hash(await fs.readFile(old.backup))!==journal.backupHash) fail('MIGRATION_CONFLICT','Legacy recovery copy changed.','Preserve both recovery copies.');
-    if(!await exists(modern.statePath)) await atomicWrite(modern.statePath,json(journal.target));
-    await fs.rm(old.statePath,{force:true}); await fs.rm(old.backup,{force:true});
-    await atomicWrite(journalPath,json({...journal,status:'complete'}));
-    return savedResult(directory,journal.target);
-  }));
-}
-
-// Discovery is intentionally bounded to named material roots, never the home or code tree.
-export async function scanDeliveries(root) {
-  const records=[],issues=[],seen=new Map();
-  for(const entry of await fs.readdir(root,{withFileTypes:true})) {
-    if(!entry.isDirectory() || entry.name.startsWith('.')) continue;
-    const directory=path.join(root,entry.name);
-    if(!await exists(path.join(directory,'state.json')) && !await exists(path.join(directory,'.aimship/state.json'))) continue;
-    try {
-      const read=await readState(directory), id=read.state.deliveryId;
-      if(read.conflict || read.readOnly) {issues.push({directory,reason:read.conflict?'layout-conflict':'unknown-schema',candidates:read.candidates}); continue;}
-      if(seen.has(id)) {issues.push({directory,reason:'duplicate-delivery-id',other:seen.get(id)}); continue;}
-      seen.set(id,directory);
-      records.push({directory,statePath:read.statePath,deliveryId:id,rulesVersion:read.state.rulesVersion,repositories:read.state.repositories,currentRun:read.state.currentRun,stageRuns:read.state.stageRuns,outcome:read.state.outcome,next:read.state.next,updatedAt:read.state.updatedAt,migration:read.migration?.status??null});
-    } catch(error) {issues.push({directory,reason:error.code??error.message});}
-  }
-  return {root:path.resolve(root),records,issues,limits:'Named root immediate children only. Records may be stale; unknown roots and non-Aimship work are outside this check. Agent must assess actual writing intent and checkout/worktree identity.'};
-}