codex-workflow-v2 2.0.0-beta.13.7 → 2.0.0-beta.13.8

package/README.md

@@ -82,7 +82,7 @@ cross-machine synchronization are not part of its contract.
 Node.js 22 or newer is required. Consumers pin the exact package version:
 
 ```bash
-npm install --save-dev --save-exact codex-workflow-v2@2.0.0-beta.13.7
+npm install --save-dev --save-exact codex-workflow-v2@2.0.0-beta.13.8
 npx codex-workflow gateway handshake --repo .
 npx codex-workflow doctor --repo .
 ```

package/dist/reviewer-runtime-build.json

@@ -1,8 +1,8 @@
 {
   "protocol": "codex-workflow-runtime-build-manifest-v1",
   "packageName": "codex-workflow-v2",
-  "packageVersion": "2.0.0-beta.13.7",
-  "packageManifestSha256": "32741f20fe31b2772ea653b6e87b438ff26661e9c02a3e8b8ae715379c5d05c7",
+  "packageVersion": "2.0.0-beta.13.8",
+  "packageManifestSha256": "032d1f88cbbd058d3bec809947281f8ad9d43dc210a32efb69195054a59ff2be",
   "requiredEntrypoints": [
     "dist/src/cli.js",
     "dist/src/gateway-handshake.js",
@@ -80,7 +80,7 @@
     },
     {
       "path": "dist/src/alpha7/autonomy.js",
-      "sha256": "9c05ea60cb1f77d62200a8a6506f08953473fe13ee56370ca3369ec741210d79"
+      "sha256": "8f8ce97ea1d765f2884daadc0278c3532c37a6deba8b0dcafebb0e0e7719ea31"
     },
     {
       "path": "dist/src/alpha7/corrective-recovery.js",
@@ -94,13 +94,17 @@
       "path": "dist/src/beta1/project-transaction.js",
       "sha256": "aca86d6baf103866ab7a4a54416e0a231bdd77eda322dae3c6fde35e7f969801"
     },
+    {
+      "path": "dist/src/change-explanation.js",
+      "sha256": "78dcf7feeb3a0770efc6df408942dc382e65ad29853c9055505ae4230e8a0810"
+    },
     {
       "path": "dist/src/cli-actions.js",
-      "sha256": "136c3824b7f4b6eb8281d11e1045fc2153d25055fcf05f68ef6e2f2833e3c11b"
+      "sha256": "184d6bc81d09b06c4bb7b36d8e25dffeea3adf9b5f6671830a12a857b58b682a"
     },
     {
       "path": "dist/src/cli.js",
-      "sha256": "98fe016d8477ce845043c38e0d9ff34bfd780212aca400eb7f42a558965e99ba"
+      "sha256": "beb3c1c4114a9b09ec4b819b58d96a42637ae0830dfcb82e957933158fa353e6"
     },
     {
       "path": "dist/src/contracts.js",
@@ -304,7 +308,7 @@
     },
     {
       "path": "dist/src/state/store.js",
-      "sha256": "5aa930f73607ce38e0e9d76560e8fafa7390cafcdcbc97d29fdff01f7dfecbf0"
+      "sha256": "575f4bdad35c49dceb2fc2318344c057a801d94788010dc9f21c36f62d61d8c8"
     },
     {
       "path": "dist/src/transition-core.js",
@@ -316,11 +320,11 @@
     },
     {
       "path": "dist/src/version.js",
-      "sha256": "862eff1de3eb98ba34276c81c4b594de888e3c8c5c70b598de4a0b19449d7422"
+      "sha256": "9faa0b93db373a62b9c50eb88e33f7d2bd9283271ef578da327e08ec04fd53bf"
     },
     {
       "path": "dist/src/workflow.js",
-      "sha256": "7335f7dca57a3299c8d8f0d087f93c3a2c032cb5b1c0e3813044a817020cddde"
+      "sha256": "313966096d0cef5836eb3f8a801bddf1fc295f26eb1de2511fa3999c130bc984"
     }
   ],
   "runtimeDependencies": [
@@ -1104,5 +1108,5 @@
       ]
     }
   ],
-  "fingerprint": "194f8b54c345346d38cb0239182a9b40218b6c33187c745b9c41e679b9cb2a46"
+  "fingerprint": "498a099ec87cd1e2ecb3768c6840760604279780bdf9db93f22abaaf7e36fa00"
 }

package/dist/src/alpha7/autonomy.d.ts

@@ -2,6 +2,8 @@ import type { DelegationGrant, DelegationPolicyInput, MilestonePlanInput, Milest
 import type { FileStateStore } from '../state/store.js';
 export interface MilestoneAutonomyEvent extends SidecarEventRecord {
     eventType: 'issued';
+    confirmationCodeBindingHash?: string;
+    issuedMilestoneStatus?: MilestoneState['status'];
     projectId: string;
     milestoneId: string;
     milestoneRevision: number;
@@ -33,6 +35,7 @@ export interface ActiveMilestoneAutonomy {
 }
 export declare function milestoneSemanticScopeHash(milestone: Pick<MilestoneState, 'id' | 'discoveryId' | 'baseBranch' | 'outcome' | 'successSignal' | 'acceptance' | 'checks'>): string;
 export declare function prepareMilestoneAutonomyContract(options: {
+    store: FileStateStore;
     projectId: string;
     milestone: MilestoneState;
     principal: string;

package/dist/src/alpha7/autonomy.js

@@ -24,17 +24,31 @@ export function milestoneSemanticScopeHash(milestone) {
         checks: milestone.checks,
     }));
 }
+function autonomyAuthoritySnapshot(store, projectId, milestoneId) {
+    const event = readMilestoneAutonomyEvents(store, projectId, milestoneId).at(-1);
+    if (!event)
+        return null;
+    try {
+        const grant = store.readDelegation(projectId, event.delegationGrantId);
+        return { eventHash: event.eventHash, grant };
+    }
+    catch (error) {
+        if (!(error instanceof WorkflowError) || error.code !== 'NOT_FOUND')
+            throw error;
+        return { eventHash: event.eventHash, grant: null };
+    }
+}
 export function prepareMilestoneAutonomyContract(options) {
     const { projectId, milestone, now } = options;
-    if (milestone.status !== 'awaiting_execution_authorization' || !milestone.planHash) {
-        throw new WorkflowError('TRANSITION_BLOCKED', 'Milestone autonomy may be granted only after the complete initial Plan is recorded and before execution.', { milestoneId: milestone.id, status: milestone.status });
+    if (!['awaiting_execution_authorization', 'active'].includes(milestone.status) || !milestone.planHash) {
+        throw new WorkflowError('TRANSITION_BLOCKED', 'Milestone autonomy requires a complete Plan and an awaiting-authorization or active Milestone.', { milestoneId: milestone.id, status: milestone.status });
     }
     const principal = options.principal.trim();
     const delegate = options.delegate.trim();
     if (!principal || principal.startsWith('agent:')) {
         throw new WorkflowError('INVALID_ARGUMENT', 'Milestone autonomy principal must be an explicit human actor.');
     }
-    if (!delegate.startsWith('agent:') || delegate === principal) {
+    if (!delegate.startsWith('agent:') || !delegate.slice(6).trim() || delegate === principal) {
         throw new WorkflowError('INVALID_ARGUMENT', 'Milestone autonomy delegate must be a distinct agent actor.');
     }
     const expiry = new Date(options.expiresAt);
@@ -55,7 +69,9 @@ export function prepareMilestoneAutonomyContract(options) {
     const delegationPolicyHash = hashDelegationPolicy(projectId, delegationPolicy);
     const semanticScopeHash = milestoneSemanticScopeHash(milestone);
     const confirmationCodeBindingHash = sha256Hex(canonicalJsonStringify({
-        version: 'milestone-autonomy-contract-v1',
+        version: 'milestone-autonomy-contract-v2',
+        milestoneStatus: milestone.status,
+        priorAuthority: autonomyAuthoritySnapshot(options.store, projectId, milestone.id),
         projectId,
         milestoneId: milestone.id,
         milestoneRevision: milestone.revision,
@@ -80,53 +96,72 @@ export function prepareMilestoneAutonomyContract(options) {
 }
 export function applyMilestoneAutonomyContract(options) {
     const prepared = prepareMilestoneAutonomyContract(options);
-    if (options.confirmationCode.trim() !== prepared.confirmationCode) {
+    const root = options.store.milestoneRoot(options.projectId, options.milestone.id);
+    const existing = readMilestoneAutonomyEvents(options.store, options.projectId, options.milestone.id);
+    let event = existing.at(-1) ?? null;
+    // The original confirmation remains usable only for an exact successful retry or
+    // completion of its event-first interrupted write, never to undo a revocation.
+    // Legacy event-first writes retain their original v1 retry code. They can only
+    // finish at the original pre-execution revision, never reopen revoked authority.
+    const retryBindingHash = event?.confirmationCodeBindingHash ?? (event ? sha256Hex(canonicalJsonStringify({
+        version: 'milestone-autonomy-contract-v1',
+        projectId: options.projectId,
+        milestoneId: options.milestone.id,
+        milestoneRevision: options.milestone.revision,
+        planHash: options.milestone.planHash,
+        semanticScopeHash: event.semanticScopeHash,
+        delegationPolicyHash: event.delegationPolicyHash,
+    })) : null);
+    const retry = event !== null && retryBindingHash !== null
+        && options.confirmationCode.trim() === `MAC-${retryBindingHash.slice(0, 24).toUpperCase()}`
+        && event.delegationPolicyHash === prepared.delegationPolicyHash
+        && event.milestoneRevision === options.milestone.revision
+        && (event.issuedMilestoneStatus ?? 'awaiting_execution_authorization') === options.milestone.status
+        && event.principal === options.principal.trim()
+        && event.delegate === options.delegate.trim()
+        && event.expiresAt === prepared.expiresAt
+        && event.semanticScopeHash === milestoneSemanticScopeHash(options.milestone);
+    if (retry && event) {
+        if (Date.parse(event.expiresAt) <= options.now.getTime()) {
+            throw new WorkflowError('TRANSITION_BLOCKED', 'Expired autonomy confirmation cannot be replayed.');
+        }
+        try {
+            options.store.readDelegation(options.projectId, event.delegationGrantId);
+            return requireActiveMilestoneAutonomy({ ...options, actor: options.delegate });
+        }
+        catch (error) {
+            if (!(error instanceof WorkflowError) || error.code !== 'NOT_FOUND')
+                throw error;
+            // Only this exact confirmed event may finish its missing grant write below.
+        }
+    }
+    if (!retry && options.confirmationCode.trim() !== prepared.confirmationCode) {
         throw new WorkflowError('TRANSITION_BLOCKED', 'Milestone autonomy confirmation does not match the exact bounded contract.', {
             milestoneId: options.milestone.id,
             confirmationCodeBindingHash: prepared.confirmationCodeBindingHash,
         });
     }
-    const root = options.store.milestoneRoot(options.projectId, options.milestone.id);
-    const existing = readMilestoneAutonomyEvents(options.store, options.projectId, options.milestone.id);
-    let event = existing.at(-1) ?? null;
-    if (event) {
-        const exactRetry = event.milestoneRevision === options.milestone.revision
-            && event.principal === prepared.principal
-            && event.delegate === prepared.delegate
-            && event.expiresAt === prepared.expiresAt
-            && event.semanticScopeHash === prepared.semanticScopeHash
-            && event.delegationPolicyHash === prepared.delegationPolicyHash;
+    if (event && !retry) {
+        let previousGrant = null;
         try {
-            const previousGrant = options.store.readDelegation(options.projectId, event.delegationGrantId);
-            if (exactRetry && previousGrant.status === 'active') {
-                return requireActiveMilestoneAutonomy({
-                    store: options.store,
-                    projectId: options.projectId,
-                    milestone: options.milestone,
-                    actor: prepared.delegate,
-                    now: options.now,
-                });
-            }
-            if (!exactRetry
-                && previousGrant.status === 'active'
-                && Date.parse(previousGrant.expiresAt) > options.now.getTime()
-                && event.semanticScopeHash === milestoneSemanticScopeHash(options.milestone)) {
-                throw new WorkflowError('TRANSITION_BLOCKED', 'Milestone already has an active autonomy contract.', {
-                    eventId: event.eventId,
-                    delegationGrantId: event.delegationGrantId,
-                    expiresAt: previousGrant.expiresAt,
-                });
-            }
-            // An expired, revoked, or semantically invalidated contract may be replaced only by
-            // another exact human-confirmed MAC binding.
-            event = null;
+            previousGrant = options.store.readDelegation(options.projectId, event.delegationGrantId);
         }
         catch (error) {
-            if (!(error instanceof WorkflowError) || error.code !== 'NOT_FOUND' || !exactRetry)
+            if (!(error instanceof WorkflowError) || error.code !== 'NOT_FOUND')
                 throw error;
-            // The append-only contract is written before its grant. An exact retry may finish a
-            // crash-interrupted issuance; the contract remains inert until this write succeeds.
+            // A fresh confirmation binds the missing grant and may supersede an inert
+            // interrupted issuance. Preserve its event; never recreate its authority.
+        }
+        if (previousGrant?.status === 'active'
+            && Date.parse(previousGrant.expiresAt) > options.now.getTime()
+            && event.semanticScopeHash === milestoneSemanticScopeHash(options.milestone)) {
+            throw new WorkflowError('TRANSITION_BLOCKED', 'Milestone already has an active autonomy contract.', {
+                eventId: event.eventId,
+                delegationGrantId: event.delegationGrantId,
+                expiresAt: previousGrant.expiresAt,
+            });
         }
+        event = null;
     }
     if (!event) {
         const grantId = createEntityId('DGR', options.now.getTime());
@@ -134,6 +169,8 @@ export function applyMilestoneAutonomyContract(options) {
             eventId: `MAC-${createUlid(options.now.getTime())}`,
             recordedAt: options.now.toISOString(),
             eventType: 'issued',
+            confirmationCodeBindingHash: prepared.confirmationCodeBindingHash,
+            issuedMilestoneStatus: options.milestone.status,
             projectId: options.projectId,
             milestoneId: options.milestone.id,
             milestoneRevision: options.milestone.revision,
@@ -149,7 +186,7 @@ export function applyMilestoneAutonomyContract(options) {
         });
     }
     const grantId = event.delegationGrantId;
-    const timestamp = options.now.toISOString();
+    const timestamp = event.issuedAt;
     const grant = options.store.writeDelegation({
         schemaVersion: STATE_SCHEMA_VERSION,
         revision: 0,
@@ -199,6 +236,11 @@ export function requireActiveMilestoneAutonomy(options) {
         expiresAt: grant.expiresAt,
     });
     if (grant.status !== 'active'
+        || grant.principal !== contract.principal
+        || grant.delegate !== contract.delegate
+        || grant.expiresAt !== contract.expiresAt
+        || grant.scope.kind !== 'milestone'
+        || grant.scope.id !== options.milestone.id
         || grant.policyHash !== expectedPolicyHash
         || grant.policyHash !== contract.delegationPolicyHash) {
         throw new WorkflowError('TRANSITION_BLOCKED', 'Milestone autonomy delegation is revoked or invalid.');
@@ -249,6 +291,11 @@ function validateMilestoneAutonomyEvent(event, expectedProjectId, expectedMilest
     if (Date.parse(event.expiresAt) <= Date.parse(event.issuedAt)) {
         throw new WorkflowError('STATE_CORRUPT', 'Milestone autonomy expiry must follow issuance.');
     }
+    if (event.confirmationCodeBindingHash !== undefined
+        && (!/^[a-f0-9]{64}$/.test(event.confirmationCodeBindingHash)
+            || !['awaiting_execution_authorization', 'active'].includes(event.issuedMilestoneStatus ?? ''))) {
+        throw new WorkflowError('STATE_CORRUPT', 'Milestone autonomy confirmation binding is invalid.');
+    }
     if (!Number.isInteger(event.milestoneRevision) || event.milestoneRevision < 1) {
         throw new WorkflowError('STATE_CORRUPT', 'Milestone autonomy revision is invalid.');
     }

package/dist/src/alpha7/autonomy.js.map

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

package/dist/src/change-explanation.d.ts

@@ -0,0 +1,64 @@
+import type { TaskState } from './contracts.js';
+export interface ChangeExplanationInput {
+    reason: string;
+    paths: string[];
+    intent?: 'implementation' | 'membership' | 'semantic-scope';
+    expectedRevision?: number;
+    expectedPlanHash?: string;
+    executionContext?: {
+        cwd: string;
+        writeRoot: string;
+        expectedBranch: string;
+    };
+    externalDecision?: 'denied' | 'unknown';
+}
+type Blocker = {
+    layer: string;
+    code: string;
+    resolution: string;
+};
+/** Explanation only: never issues a credential, writes state, or grants permission to apply a patch. */
+export declare function explainChange(input: ChangeExplanationInput, repository: string, task: TaskState | undefined, next: Record<string, unknown>): {
+    kind: string;
+    version: number;
+    readOnly: boolean;
+    authority: string;
+    changeKind: string;
+    decisionBasis: string;
+    binding: {
+        projectId: string;
+        repositoryRoot: string;
+        taskId: string | null;
+        revision: number | null;
+        planHash: string | null;
+        head: string;
+        proposedPaths: string[];
+        observedDirtyPaths: string[];
+        proposedPathBytesHash: string | null;
+        requestHash: string;
+        existingAction: string;
+    };
+    proposalHash: string;
+    executionContext: {
+        state: string;
+        externallyEnforced: boolean;
+    };
+    blockers: Blocker[];
+    existingRoute: {
+        action: string;
+        blockedByExplanation: boolean;
+        recheckNextBeforeMutation: boolean;
+    };
+    proposedPaths: string[];
+    outsideCurrentStep: string[];
+    boundedAmendment: {
+        route: string;
+        prerequisite: string | null;
+        scopeExtensions: string[];
+        effect: unknown;
+    } | null;
+    requiresUser: boolean | null;
+    validationNeeded: string[];
+    limitations: string[];
+};
+export {};

package/dist/src/change-explanation.js

@@ -0,0 +1,150 @@
+import { createHash } from 'node:crypto';
+import { existsSync, lstatSync, realpathSync } from 'node:fs';
+import path from 'node:path';
+import { pathAllowed } from './domain/validation.js';
+import { WorkflowError } from './errors.js';
+import { currentBranch, headCommit, resolveRepositoryIdentity, runGit } from './repository.js';
+import { hashDirtyWorktree } from './alpha6/downstream-proof.js';
+const object = (value) => value !== null && typeof value === 'object'
+    && !Array.isArray(value) ? value : {};
+function validate(input) {
+    const keys = ['reason', 'paths', 'intent', 'expectedRevision', 'expectedPlanHash', 'executionContext', 'externalDecision'];
+    if (!input || typeof input !== 'object' || Object.keys(input).some(key => !keys.includes(key))
+        || typeof input.reason !== 'string' || !input.reason.trim() || input.reason.length > 4000
+        || !Array.isArray(input.paths) || input.paths.length > 256
+        || input.paths.some(p => typeof p !== 'string' || !p || p.includes('\\') || p.includes('\0')
+            || /[*?\[\]{}]/.test(p) || path.isAbsolute(p) || p.split('/').some(x => !x || x === '.' || x === '..'))
+        || (input.intent !== undefined && !['implementation', 'membership', 'semantic-scope'].includes(input.intent))
+        || (input.externalDecision !== undefined && !['denied', 'unknown'].includes(input.externalDecision))
+        || (input.expectedRevision !== undefined && (!Number.isSafeInteger(input.expectedRevision) || input.expectedRevision < 1))
+        || (input.expectedPlanHash !== undefined && !/^[a-f0-9]{64}$/.test(input.expectedPlanHash))) {
+        throw new WorkflowError('INVALID_ARGUMENT', 'Expected a closed change explanation with reason and normalized repository-relative paths.');
+    }
+    const ctx = input.executionContext;
+    if (ctx !== undefined && (!ctx || typeof ctx !== 'object'
+        || Object.keys(ctx).sort().join(',') !== 'cwd,expectedBranch,writeRoot'
+        || [ctx.cwd, ctx.writeRoot, ctx.expectedBranch].some(x => typeof x !== 'string' || !x.trim())
+        || !path.isAbsolute(ctx.cwd) || !path.isAbsolute(ctx.writeRoot))) {
+        throw new WorkflowError('INVALID_ARGUMENT', 'executionContext requires absolute cwd/writeRoot and expectedBranch.');
+    }
+}
+// Resolve existing ancestors as well as non-existing destinations; do not read through symlinks.
+function outsideRoot(root, file) {
+    let ancestor = path.join(root, file);
+    while (!existsSync(ancestor)) {
+        try {
+            if (lstatSync(ancestor).isSymbolicLink())
+                return true;
+        }
+        catch { /* missing path */ }
+        const parent = path.dirname(ancestor);
+        if (parent === ancestor)
+            return true;
+        ancestor = parent;
+    }
+    const relative = path.relative(root, realpathSync(ancestor));
+    return relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative);
+}
+/** Explanation only: never issues a credential, writes state, or grants permission to apply a patch. */
+export function explainChange(input, repository, task, next) {
+    validate(input);
+    const identity = resolveRepositoryIdentity(repository);
+    const root = realpathSync(identity.repositoryRoot);
+    const blockers = [];
+    const add = (layer, code, resolution) => blockers.push({ layer, code, resolution });
+    const dirty = [...new Set([
+            ...runGit(root, ['diff', 'HEAD', '--name-only', '-z']).split('\0'),
+            ...runGit(root, ['ls-files', '--others', '--exclude-standard', '-z']).split('\0'),
+        ].filter(Boolean))].sort();
+    const paths = [...new Set([...input.paths, ...dirty])].sort();
+    const escaped = paths.filter(p => outsideRoot(root, p));
+    if (escaped.length)
+        add('execution-context', 'WRITE_PATH_ESCAPES_CHECKOUT', 'Resolve the symlink or target mismatch before proposing a write.');
+    let contextState = 'not-supplied';
+    if (input.executionContext) {
+        contextState = 'matched';
+        try {
+            const ctx = input.executionContext;
+            const observed = resolveRepositoryIdentity(ctx.cwd);
+            if (realpathSync(observed.repositoryRoot) !== root || realpathSync(ctx.writeRoot) !== root
+                || currentBranch(root) !== ctx.expectedBranch
+                || (task?.taskBranch !== null && task?.taskBranch !== undefined && ctx.expectedBranch !== task.taskBranch)) {
+                contextState = 'mismatch';
+                add('execution-context', 'EXECUTION_CONTEXT_MISMATCH', 'Reconcile the existing Worker checkout and fresh Task branch; do not retry in another chat or silently change the target.');
+            }
+        }
+        catch {
+            contextState = 'unverified';
+            add('execution-context', 'EXECUTION_CONTEXT_UNVERIFIED', 'Obtain a readable current checkout observation.');
+        }
+    }
+    if (input.externalDecision === 'denied')
+        add('external-approval', 'EXTERNAL_OPERATION_DENIED', 'Preserve the denial. Prepare safe evidence or obtain the exact external authorization; a Workflow grant does not override it.');
+    if (input.expectedRevision !== undefined && input.expectedRevision !== task?.revision
+        || input.expectedPlanHash !== undefined && input.expectedPlanHash !== task?.planHash) {
+        add('integrity', 'STALE_CHANGE_BINDING', 'Refresh the proposal from the current Task revision and Plan.');
+    }
+    const action = typeof next.action === 'string' ? next.action : 'blocked';
+    if (next.status === 'observation-blocked' || next.status === 'repair-required') {
+        add('integrity', 'CORE_OBSERVATION_UNAVAILABLE', 'Complete the exact Core observation/recovery route before changing work.');
+    }
+    const step = task?.steps.find(s => s.id === next.stepId)
+        ?? task?.steps.find(s => s.status === 'in_progress' || s.status === 'failed');
+    const outOfPlan = paths.filter(p => !step || !pathAllowed(p, step.allowedWrites) || pathAllowed(p, step.forbiddenScope));
+    const recovery = object(next.planIntegrityRecovery);
+    const supporting = recovery.state === 'eligible'
+        && (action === 'task plan-integrity-recover' || next.blockedAction === 'task plan-integrity-recover')
+        && recovery.boundedEffect === 'record-machine-derived-check-support-scope';
+    const evidence = object(recovery.evidence);
+    const scope = Array.isArray(evidence.scopeExtensions) ? evidence.scopeExtensions.filter((x) => typeof x === 'string') : [];
+    const bounded = supporting && outOfPlan.every(p => scope.includes(p));
+    let kind = 'implementation';
+    let decisionBasis = 'No automatic conclusion about semantic safety; follow the current Core route.';
+    if (input.intent === 'semantic-scope') {
+        kind = 'semantic-scope';
+        add('workflow', 'HUMAN_SEMANTIC_DECISION', 'Resolve the changed outcome or acceptance with the user through the scope-change route.');
+    }
+    else if (input.intent === 'membership' || next.auditedRemediation) {
+        kind = 'membership';
+        decisionBasis = 'Membership is separate from Step implementation. Use only the advertised bounded topology route or a separately confirmed scope change.';
+    }
+    else if (bounded) {
+        kind = 'bounded-plan-amendment';
+        decisionBasis = 'Core derived an exact check-support extension. Use its existing recovery; do not edit allowedWrites or grant authority manually.';
+    }
+    else if (/replan|corrective-yield|downstream-proof/.test(action) || recovery.boundedEffect === 'record-replan-required-decision') {
+        kind = 'corrective-plan';
+        decisionBasis = 'Core identified a Plan/recovery conflict; preserve historical evidence and the existing Task.';
+    }
+    else if (action === 'task context-refresh' || action === 'task knowledge-rebind') {
+        kind = 'context-refresh';
+        decisionBasis = 'Context refresh is independent of Plan correction and cannot acknowledge a Plan conflict.';
+    }
+    else if (outOfPlan.length) {
+        kind = 'plan-review';
+        add('workflow', 'UNPROVED_SCOPE_EXTENSION', 'Establish a Core-supported extension or revise the Plan. File count and user-declared intent are not safety evidence.');
+    }
+    const delegated = Array.isArray(next.delegatedApprovalOptions) && next.delegatedApprovalOptions.length > 0;
+    const derived = object(next.correctiveDerivedApproval).humanApprovalRequired === false;
+    const humanGate = !!next.requiredHumanGate || ['task authorize', 'task accept', 'milestone authorize', 'milestone accept', 'project-memory approve'].includes(action);
+    if (humanGate && !delegated && !derived)
+        add('workflow', 'CURRENT_HUMAN_GATE', 'Use the current exact human gate; this explanation issues no authority.');
+    const head = headCommit(root);
+    const binding = { projectId: identity.projectId, repositoryRoot: root, taskId: task?.id ?? null,
+        revision: task?.revision ?? null, planHash: task?.planHash ?? null, head,
+        proposedPaths: [...new Set(input.paths)].sort(), observedDirtyPaths: dirty, proposedPathBytesHash: escaped.length ? null : hashDirtyWorktree(root, paths),
+        requestHash: createHash('sha256').update(JSON.stringify(input)).digest('hex'), existingAction: action };
+    return { kind: 'change-explanation', version: 1, readOnly: true, authority: 'none', changeKind: kind,
+        decisionBasis, binding, proposalHash: createHash('sha256').update(JSON.stringify(binding)).digest('hex'),
+        executionContext: { state: contextState, externallyEnforced: false }, blockers,
+        existingRoute: { action, blockedByExplanation: blockers.length > 0, recheckNextBeforeMutation: true },
+        proposedPaths: paths, outsideCurrentStep: outOfPlan,
+        boundedAmendment: bounded && kind === 'bounded-plan-amendment' ? { route: 'task plan-integrity-recover', prerequisite: action === 'task plan-integrity-recover' ? null : action, scopeExtensions: scope, effect: recovery.boundedEffect } : null,
+        requiresUser: blockers.some(b => ['EXTERNAL_OPERATION_DENIED', 'HUMAN_SEMANTIC_DECISION', 'CURRENT_HUMAN_GATE'].includes(b.code)) ? true : null,
+        validationNeeded: ['Fresh status and next; current revision, Plan, HEAD and file bytes.',
+            'Current Worker checkout, branch and writer credential; external approval remains independent.',
+            'Preserve requirements, acceptance, checks and historical evidence; review the exact diff.'],
+        limitations: ['Not an apply command or proof of external permission.',
+            'Unspecified risks and blockers may remain. No inference of semantic safety from paths or diff size.'] };
+}
+//# sourceMappingURL=change-explanation.js.map

package/dist/src/change-explanation.js.map

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

package/dist/src/cli-actions.d.ts

@@ -6,6 +6,7 @@
  */
 declare const CLI_ACTIONS_LITERAL: {
     readonly gateway: readonly ["handshake"];
+    readonly change: readonly ["explain"];
     readonly update: readonly ["preflight", "pending-review-source-preflight", "pending-review-dependency-preflight", "pending-review-dependency-recover", "rescue-preflight", "dependency-provenance-preflight", "corrective-carryover-preflight", "dependency-provenance-recover", "historical-step-dependency-preflight", "historical-step-dependency-recover", "downstream-proof-dependency-preflight", "downstream-proof-dependency-recover", "downstream-proof-replan-update-preflight", "downstream-proof-replan-dependency-preflight", "downstream-proof-replan-dependency-recover", "plan-integrity-update-preflight", "plan-integrity-dependency-preflight", "plan-integrity-dependency-recover"];
     readonly delegation: readonly ["prepare", "grant", "list", "show", "revoke"];
     readonly 'project-memory': readonly ["scan", "show", "status", "approve", "reconcile"];

package/dist/src/cli-actions.js

@@ -6,6 +6,7 @@
  */
 const CLI_ACTIONS_LITERAL = {
     gateway: ['handshake'],
+    change: ['explain'],
     update: [
         'preflight',
         'pending-review-source-preflight',

package/dist/src/cli-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-actions.js","sourceRoot":"","sources":["../../src/cli-actions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG;IAC1B,OAAO,EAAE,CAAC,WAAW,CAAC;IACtB,MAAM,EAAE;QACN,WAAW;QACX,iCAAiC;QACjC,qCAAqC;QACrC,mCAAmC;QACnC,kBAAkB;QAClB,iCAAiC;QACjC,gCAAgC;QAChC,+BAA+B;QAC/B,sCAAsC;QACtC,oCAAoC;QACpC,uCAAuC;QACvC,qCAAqC;QACrC,0CAA0C;QAC1C,8CAA8C;QAC9C,4CAA4C;QAC5C,iCAAiC;QACjC,qCAAqC;QACrC,mCAAmC;KACpC;IACD,UAAU,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;IAC1D,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC;IACpE,KAAK,EAAE,CAAC,SAAS,EAAE,kBAAkB,EAAE,gBAAgB,CAAC;IACxD,KAAK,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,UAAU,CAAC;IACnE,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC;IACrD,IAAI,EAAE;QACJ,MAAM;QACN,yBAAyB;QACzB,qBAAqB;QACrB,UAAU;QACV,kBAAkB;QAClB,iBAAiB;QACjB,WAAW;QACX,iBAAiB;QACjB,OAAO;QACP,KAAK;QACL,eAAe;QACf,QAAQ;QACR,eAAe;QACf,eAAe;QACf,eAAe;QACf,sBAAsB;QACtB,aAAa;QACb,oBAAoB;QACpB,oBAAoB;QACpB,6BAA6B;QAC7B,0BAA0B;QAC1B,wBAAwB;QACxB,0BAA0B;QAC1B,iCAAiC;QACjC,uBAAuB;QACvB,qBAAqB;QACrB,qBAAqB;QACrB,kBAAkB;QAClB,0BAA0B;QAC1B,2BAA2B;QAC3B,2BAA2B;QAC3B,2BAA2B;QAC3B,2BAA2B;QAC3B,sCAAsC;QACtC,oCAAoC;QACpC,SAAS;QACT,iBAAiB;QACjB,iBAAiB;QACjB,cAAc;QACd,OAAO;QACP,2BAA2B;QAC3B,UAAU;QACV,iBAAiB;QACjB,YAAY;QACZ,QAAQ;QACR,WAAW;QACX,OAAO;QACP,eAAe;KAChB;IACD,SAAS,EAAE;QACT,SAAS;QACT,MAAM;QACN,UAAU;QACV,UAAU;QACV,yBAAyB;QACzB,sBAAsB;QACtB,oBAAoB;QACpB,kBAAkB;QAClB,gBAAgB;QAChB,iBAAiB;QACjB,WAAW;QACX,UAAU;QACV,QAAQ;QACR,QAAQ;KACT;IACD,KAAK,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;CACpB,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAgD,mBAAmB,CAAC;AAO5F,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACpF,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAY,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAkC,CAAC;IACrE,OAAO,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"cli-actions.js","sourceRoot":"","sources":["../../src/cli-actions.ts"],"names":[],"mappings":"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"}