@ankhorage/studio 2.6.2 → 2.6.4

package/dist/features/project-updates/composition/createStudioProjectUpdateApplyOwnerStepPort.js

@@ -0,0 +1,171 @@
+import { readPendingModuleLifecycleStateAsync } from '../adapters/outbound/readPendingModuleLifecycleStateAsync';
+import { readStudioManifestDigestAsync } from '../adapters/outbound/readStudioManifestDigestAsync';
+import { readCurrentStudioApmArtifactBindingAsync } from '../adapters/outbound/resolveCurrentStudioApmArtifactAsync';
+import { readReviewedPendingModuleStep } from '../domain/pendingModulePlanStep';
+/*** Compose Studio pending-module execution around any pre-existing trusted owner step adapter. */
+export function createStudioProjectUpdateApplyOwnerStepPort(lifecycle, base) {
+    return {
+        observeAsync: async (input) => {
+            const reviewed = readReviewedPendingModuleStep(input.step);
+            return reviewed === undefined
+                ? delegateObservationAsync(base, input)
+                : observePendingModuleAsync(input.journal.rootPath, reviewed, lifecycle);
+        },
+        executeAsync: async (input) => {
+            const reviewed = readReviewedPendingModuleStep(input.step);
+            return reviewed === undefined
+                ? delegateExecutionAsync(base, 'executeAsync', input)
+                : executePendingModuleAsync(input.journal.rootPath, reviewed, lifecycle);
+        },
+        rollbackAsync: async (input) => {
+            const reviewed = readReviewedPendingModuleStep(input.step);
+            return reviewed === undefined
+                ? delegateExecutionAsync(base, 'rollbackAsync', input)
+                : unsupportedRollback(input.step.id);
+        },
+    };
+}
+/*** Observe exact pending/manifest/artifact preconditions before one irreversible module effect. */
+async function observePendingModuleAsync(rootPath, reviewed, lifecycle) {
+    const binding = await bindingObservationAsync(reviewed);
+    if (binding !== undefined)
+        return binding;
+    const pending = await pendingObservationAsync(rootPath, reviewed.pendingDigest);
+    if (pending !== undefined)
+        return pending;
+    const manifest = await manifestObservationAsync(rootPath, reviewed.manifestDigest);
+    if (manifest !== undefined)
+        return manifest;
+    const installed = await lifecycle.isModuleInstalledAsync(rootPath, reviewed.moduleId);
+    if (installed === undefined) {
+        return {
+            state: 'unknown',
+            evidence: [`module:${reviewed.moduleId}`],
+            reason: 'Orchestrator could not determine the reviewed module installation state.',
+        };
+    }
+    return installed
+        ? { state: 'pending', evidence: [`module-installed:${reviewed.moduleId}`] }
+        : { state: 'satisfied', evidence: [`module-removed:${reviewed.moduleId}`] };
+}
+/*** Execute exactly one reviewed Orchestrator removal after all frozen preconditions still match. */
+async function executePendingModuleAsync(rootPath, reviewed, lifecycle) {
+    const observation = await observePendingModuleAsync(rootPath, reviewed, lifecycle);
+    if (observation.state === 'satisfied')
+        return completed(observation.evidence);
+    if (observation.state !== 'pending')
+        return observationFailure(observation);
+    await lifecycle.removeModuleAsync(rootPath, reviewed.moduleId);
+    const installed = await lifecycle.isModuleInstalledAsync(rootPath, reviewed.moduleId);
+    if (installed === false)
+        return completed([`module-removed:${reviewed.moduleId}`]);
+    return installed === undefined
+        ? {
+            state: 'unknown',
+            evidence: [`module:${reviewed.moduleId}`],
+            diagnostics: [],
+            failure: {
+                code: 'studio.pending-module-lifecycle.observation-unavailable',
+                reason: 'Module removal returned but its postcondition could not be observed.',
+                evidence: [reviewed.moduleId],
+            },
+        }
+        : failed('studio.pending-module-lifecycle.remove-incomplete', 'Orchestrator returned from removal but the reviewed module remains installed.', reviewed.moduleId);
+}
+/*** Reject a reviewed step when the running Studio package does not match its frozen owner artifact. */
+async function bindingObservationAsync(reviewed) {
+    const binding = await readCurrentStudioApmArtifactBindingAsync();
+    const matches = reviewed.artifact.packageName === binding.packageName &&
+        reviewed.artifact.version === binding.version &&
+        reviewed.artifact.descriptorDigest === binding.descriptorDigest;
+    return matches
+        ? undefined
+        : {
+            state: 'conflict',
+            evidence: [
+                `${reviewed.artifact.packageName}@${reviewed.artifact.version}`,
+                `${binding.packageName}@${binding.version}`,
+                reviewed.artifact.descriptorDigest,
+                binding.descriptorDigest,
+            ],
+            reason: 'Loaded Studio owner code no longer matches the reviewed immutable artifact binding.',
+        };
+}
+/*** Require the exact pending-state digest to remain unchanged until native APM file finalization. */
+async function pendingObservationAsync(rootPath, expectedDigest) {
+    const pending = await readPendingModuleLifecycleStateAsync(rootPath);
+    if (pending.state === 'valid' && pending.digest === expectedDigest)
+        return undefined;
+    if (pending.state === 'unreadable') {
+        return {
+            state: 'unknown',
+            evidence: [pending.reason],
+            reason: 'Studio pending module lifecycle state cannot be read safely.',
+        };
+    }
+    return {
+        state: 'conflict',
+        evidence: [expectedDigest, pending.state === 'valid' ? pending.digest : pending.state],
+        reason: 'Studio pending module lifecycle state changed after the reviewed plan was created.',
+    };
+}
+/*** Require the canonical manifest to remain byte-identical before irreversible Orchestrator effects. */
+async function manifestObservationAsync(rootPath, expectedDigest) {
+    try {
+        const actualDigest = await readStudioManifestDigestAsync(rootPath);
+        return actualDigest === expectedDigest
+            ? undefined
+            : {
+                state: 'conflict',
+                evidence: [expectedDigest, actualDigest],
+                reason: 'Studio manifest changed after the reviewed pending-module plan was created.',
+            };
+    }
+    catch (error) {
+        return {
+            state: 'unknown',
+            evidence: [error instanceof Error ? error.message : 'unknown manifest read failure'],
+            reason: 'Studio manifest cannot be read safely before the reviewed module removal.',
+        };
+    }
+}
+/*** Delegate an unrelated owner observation or remain explicitly unavailable. */
+async function delegateObservationAsync(base, input) {
+    return base === undefined
+        ? {
+            state: 'unknown',
+            evidence: [input.step.id],
+            reason: 'No trusted Studio owner adapter handles this reviewed step.',
+        }
+        : base.observeAsync(input);
+}
+/*** Delegate unrelated owner execution/rollback without swallowing its result. */
+async function delegateExecutionAsync(base, action, input) {
+    return base === undefined
+        ? failed('studio.owner-step.unavailable', 'No trusted Studio owner adapter handles this reviewed step.', input.step.id)
+        : action === 'executeAsync'
+            ? base.executeAsync(input)
+            : base.rollbackAsync(input);
+}
+/*** Convert a non-executable observation into a deterministic owner-step failure. */
+function observationFailure(observation) {
+    return failed('studio.pending-module-lifecycle.precondition-changed', observation.reason ?? 'Reviewed pending module lifecycle preconditions are not executable.', ...observation.evidence);
+}
+/*** Report one completed trusted owner effect. */
+function completed(evidence) {
+    return { state: 'completed', evidence, diagnostics: [] };
+}
+/*** Report one deterministic owner execution failure. */
+function failed(code, reason, ...evidence) {
+    return {
+        state: 'failed',
+        evidence,
+        diagnostics: [],
+        failure: { code, reason, evidence },
+    };
+}
+/*** Keep dynamic Orchestrator effects explicitly non-reversible. */
+function unsupportedRollback(stepId) {
+    return failed('studio.pending-module-lifecycle.rollback-unsupported', 'Reviewed Orchestrator module removal is not transactionally reversible by Studio.', stepId);
+}
+//# sourceMappingURL=createStudioProjectUpdateApplyOwnerStepPort.js.map

package/dist/features/project-updates/composition/createStudioProjectUpdateApplyOwnerStepPort.js.map

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

package/dist/features/project-updates/composition/createStudioProjectUpdateExtensionEvidencePort.d.ts

@@ -0,0 +1,4 @@
+import type { ApmStatusExtensionEvidencePort } from '@ankhorage/apm/types';
+/*** Compose Studio pending-lifecycle evidence with any existing package-owner status provider. */
+export declare function createStudioProjectUpdateExtensionEvidencePort(base?: ApmStatusExtensionEvidencePort): ApmStatusExtensionEvidencePort;
+//# sourceMappingURL=createStudioProjectUpdateExtensionEvidencePort.d.ts.map

package/dist/features/project-updates/composition/createStudioProjectUpdateExtensionEvidencePort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStudioProjectUpdateExtensionEvidencePort.d.ts","sourceRoot":"","sources":["../../../../src/features/project-updates/composition/createStudioProjectUpdateExtensionEvidencePort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAIjG,kGAAkG;AAClG,wBAAgB,8CAA8C,CAC5D,IAAI,CAAC,EAAE,8BAA8B,GACpC,8BAA8B,CAUhC"}

package/dist/features/project-updates/composition/createStudioProjectUpdateExtensionEvidencePort.js

@@ -0,0 +1,29 @@
+import { inspectPendingModuleLifecycleEvidenceAsync } from '../adapters/outbound/inspectPendingModuleLifecycleEvidenceAsync';
+/*** Compose Studio pending-lifecycle evidence with any existing package-owner status provider. */
+export function createStudioProjectUpdateExtensionEvidencePort(base) {
+    return {
+        inspectExtensionEvidenceAsync: async (input) => {
+            const [baseEvidence, pendingEvidence] = await Promise.all([
+                readBaseEvidenceAsync(base, input),
+                inspectPendingModuleLifecycleEvidenceAsync(input.rootPath),
+            ]);
+            return mergeExtensionEvidence(baseEvidence, pendingEvidence);
+        },
+    };
+}
+/*** Read optional existing owner evidence without treating an absent provider as incomplete. */
+async function readBaseEvidenceAsync(base, input) {
+    return base === undefined
+        ? { state: 'unavailable', complete: true, observations: [], diagnostics: [] }
+        : base.inspectExtensionEvidenceAsync(input);
+}
+/*** Merge independent owner evidence without replacing an already composed provider. */
+function mergeExtensionEvidence(base, pending) {
+    return {
+        state: base.state === 'available' || pending.state === 'available' ? 'available' : 'unavailable',
+        complete: base.complete && pending.complete,
+        observations: [...base.observations, ...pending.observations],
+        diagnostics: [...base.diagnostics, ...pending.diagnostics],
+    };
+}
+//# sourceMappingURL=createStudioProjectUpdateExtensionEvidencePort.js.map

package/dist/features/project-updates/composition/createStudioProjectUpdateExtensionEvidencePort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStudioProjectUpdateExtensionEvidencePort.js","sourceRoot":"","sources":["../../../../src/features/project-updates/composition/createStudioProjectUpdateExtensionEvidencePort.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0CAA0C,EAAE,MAAM,iEAAiE,CAAC;AAE7H,kGAAkG;AAClG,MAAM,UAAU,8CAA8C,CAC5D,IAAqC;IAErC,OAAO;QACL,6BAA6B,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC7C,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACxD,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC;gBAClC,0CAA0C,CAAC,KAAK,CAAC,QAAQ,CAAC;aAC3D,CAAC,CAAC;YACH,OAAO,sBAAsB,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;QAC/D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,KAAK,UAAU,qBAAqB,CAClC,IAAgD,EAChD,KAAqF;IAErF,OAAO,IAAI,KAAK,SAAS;QACvB,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QAC7E,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,wFAAwF;AACxF,SAAS,sBAAsB,CAC7B,IAA0B,EAC1B,OAA6B;IAE7B,OAAO;QACL,KAAK,EACH,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,OAAO,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa;QAC3F,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ;QAC3C,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;QAC7D,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/dist/features/project-updates/composition/createStudioProjectUpdateProtocolPort.d.ts

@@ -0,0 +1,10 @@
+import type { ApmExtensionArtifactIdentityResolution, ApmPlanProtocolPort } from '@ankhorage/apm/types';
+interface StudioProjectUpdateProtocolOptions {
+    readonly pendingLifecycleExecution?: boolean;
+    readonly resolveArtifactAsync?: (rootPath: string) => Promise<ApmExtensionArtifactIdentityResolution>;
+    readonly nowIso?: () => string;
+}
+/*** Extend package-owner planning with reviewed Studio pending-module lifecycle execution. */
+export declare function createStudioProjectUpdateProtocolPort(base?: ApmPlanProtocolPort, options?: StudioProjectUpdateProtocolOptions): ApmPlanProtocolPort;
+export {};
+//# sourceMappingURL=createStudioProjectUpdateProtocolPort.d.ts.map

package/dist/features/project-updates/composition/createStudioProjectUpdateProtocolPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStudioProjectUpdateProtocolPort.d.ts","sourceRoot":"","sources":["../../../../src/features/project-updates/composition/createStudioProjectUpdateProtocolPort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sCAAsC,EAGtC,mBAAmB,EAEpB,MAAM,sBAAsB,CAAC;AAS9B,UAAU,kCAAkC;IAC1C,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAC7C,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAC9B,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,sCAAsC,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;CAChC;AAED,8FAA8F;AAC9F,wBAAgB,qCAAqC,CACnD,IAAI,CAAC,EAAE,mBAAmB,EAC1B,OAAO,GAAE,kCAAuC,GAC/C,mBAAmB,CAiCrB"}

package/dist/features/project-updates/composition/createStudioProjectUpdateProtocolPort.js

@@ -0,0 +1,106 @@
+import { resolveCurrentStudioApmArtifactAsync } from '../adapters/outbound/resolveCurrentStudioApmArtifactAsync';
+import { planPendingModuleLifecycleAsync } from '../application/planPendingModuleLifecycleAsync';
+import { STUDIO_PENDING_MODULE_LIFECYCLE_EVIDENCE, STUDIO_PENDING_MODULE_LIFECYCLE_PROJECTION_ID, } from '../constants';
+/*** Extend package-owner planning with reviewed Studio pending-module lifecycle execution. */
+export function createStudioProjectUpdateProtocolPort(base, options = {}) {
+    return {
+        planProtocolAsync: async (input) => {
+            const baseResult = await readBaseProtocolResultAsync(base, input);
+            const pending = input.status.extensions.observations.find(isPendingModuleLifecycleObservation);
+            const pendingSlice = await planPendingObservationAsync(pending, input.status.rootPath, options);
+            const unhandled = base === undefined
+                ? input.status.extensions.observations.filter((observation) => !isPendingModuleLifecycleObservation(observation) &&
+                    requiresProtocolPlanning(observation, input.policy.repairProjections))
+                : [];
+            const unhandledBlockers = unhandled.length === 0 ? [] : [protocolUnavailableBlocker(unhandled)];
+            const blockers = [...baseResult.blockers, ...pendingSlice.blockers, ...unhandledBlockers];
+            return {
+                ...baseResult,
+                complete: baseResult.complete && blockers.length === 0,
+                files: [...baseResult.files, ...pendingSlice.files],
+                artifacts: [...baseResult.artifacts, ...pendingSlice.artifacts],
+                steps: [...baseResult.steps, ...pendingSlice.steps],
+                blockers,
+            };
+        },
+    };
+}
+const EMPTY_PROTOCOL_RESULT = {
+    complete: true,
+    requiredSelections: [],
+    files: [],
+    artifacts: [],
+    steps: [],
+    effects: [],
+    findings: [],
+    blockers: [],
+    diagnostics: [],
+};
+const EMPTY_PENDING_SLICE = { files: [], artifacts: [], steps: [], blockers: [] };
+/*** Delegate existing package-owner planning when present instead of replacing it. */
+async function readBaseProtocolResultAsync(base, input) {
+    return base === undefined ? EMPTY_PROTOCOL_RESULT : base.planProtocolAsync(input);
+}
+/*** Plan the pending lifecycle observation only when the host supplied its trusted execution adapter. */
+async function planPendingObservationAsync(observation, rootPath, options) {
+    if (observation === undefined)
+        return EMPTY_PENDING_SLICE;
+    if (options.pendingLifecycleExecution !== true) {
+        return { ...EMPTY_PENDING_SLICE, blockers: [pendingLifecycleBlocker(observation)] };
+    }
+    const expectedPendingDigest = readPendingDigest(observation);
+    if (expectedPendingDigest === undefined) {
+        return { ...EMPTY_PENDING_SLICE, blockers: [missingPendingDigestBlocker(observation)] };
+    }
+    return planPendingModuleLifecycleAsync({
+        rootPath,
+        expectedPendingDigest,
+        resolveArtifactAsync: options.resolveArtifactAsync ?? resolveCurrentStudioApmArtifactAsync,
+        nowIso: options.nowIso ?? (() => new Date().toISOString()),
+    });
+}
+/*** Identify the Studio-owned pending module lifecycle observation by stable evidence. */
+function isPendingModuleLifecycleObservation(observation) {
+    return observation.evidence.includes(STUDIO_PENDING_MODULE_LIFECYCLE_EVIDENCE);
+}
+/*** Read the exact pending-file precondition frozen into status evidence. */
+function readPendingDigest(observation) {
+    return observation.evidence
+        .find((item) => item.startsWith('pending-digest:'))
+        ?.slice('pending-digest:'.length);
+}
+/*** Mirror APM's owner-planning requirement for evidence not handled by Studio's local planner. */
+function requiresProtocolPlanning(observation, repairProjections) {
+    return (observation.migration === 'pending' || (repairProjections && observation.projection === 'stale'));
+}
+/*** Block apply when this service instance has no trusted module-lifecycle executor. */
+function pendingLifecycleBlocker(observation) {
+    return {
+        code: 'protocol.studio-pending-module-lifecycle',
+        scope: { kind: 'projection', id: STUDIO_PENDING_MODULE_LIFECYCLE_PROJECTION_ID },
+        evidence: observation.evidence,
+        reason: 'Studio module removals are queued, but this host did not compose the trusted module-lifecycle owner executor.',
+        nextAction: 'Use the normal Studio host or compose its trusted pending-module lifecycle adapter.',
+    };
+}
+/*** Block planning when pending evidence lacks the immutable file digest required for reviewed execution. */
+function missingPendingDigestBlocker(observation) {
+    return {
+        code: 'protocol.studio-pending-module-lifecycle-evidence-incomplete',
+        scope: { kind: 'projection', id: STUDIO_PENDING_MODULE_LIFECYCLE_PROJECTION_ID },
+        evidence: observation.evidence,
+        reason: 'Pending module lifecycle evidence is missing its reviewed file digest.',
+        nextAction: 'Refresh Studio status before planning pending module removals.',
+    };
+}
+/*** Preserve APM's fail-closed behavior when another owner observation lacks a planner. */
+function protocolUnavailableBlocker(observations) {
+    return {
+        code: 'plan.protocol-unavailable',
+        scope: { kind: 'project' },
+        evidence: observations.flatMap((observation) => observation.evidence),
+        reason: 'Package-owned migration or projection work is pending without a composed planner.',
+        nextAction: 'Compose the required trusted owner planner before applying project updates.',
+    };
+}
+//# sourceMappingURL=createStudioProjectUpdateProtocolPort.js.map

package/dist/features/project-updates/composition/createStudioProjectUpdateProtocolPort.js.map

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

package/dist/features/project-updates/composition/createStudioProjectUpdateService.d.ts

@@ -0,0 +1,6 @@
+import type { ProjectUpdateServiceOptions } from '../../../types/project-updates';
+import { ProjectUpdateService } from '../application/ProjectUpdateService';
+import type { StudioPendingModuleLifecyclePort } from '../application/StudioPendingModuleLifecyclePort';
+/*** Compose Studio-owned APM evidence, planning, execution, and verification around one host lifecycle port. */
+export declare function createStudioProjectUpdateService(options?: ProjectUpdateServiceOptions, lifecycle?: StudioPendingModuleLifecyclePort): ProjectUpdateService;
+//# sourceMappingURL=createStudioProjectUpdateService.d.ts.map

package/dist/features/project-updates/composition/createStudioProjectUpdateService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStudioProjectUpdateService.d.ts","sourceRoot":"","sources":["../../../../src/features/project-updates/composition/createStudioProjectUpdateService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,iDAAiD,CAAC;AAMxG,gHAAgH;AAChH,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,2BAAgC,EACzC,SAAS,CAAC,EAAE,gCAAgC,GAC3C,oBAAoB,CAoBtB"}

package/dist/features/project-updates/composition/createStudioProjectUpdateService.js

@@ -0,0 +1,22 @@
+import { ProjectUpdateService } from '../application/ProjectUpdateService';
+import { createStudioProjectUpdateApplyOwnerStepPort } from './createStudioProjectUpdateApplyOwnerStepPort';
+import { createStudioProjectUpdateExtensionEvidencePort } from './createStudioProjectUpdateExtensionEvidencePort';
+import { createStudioProjectUpdateProtocolPort } from './createStudioProjectUpdateProtocolPort';
+import { createStudioProjectUpdateVerifyOwnerStepPort } from './createStudioProjectUpdateVerifyOwnerStepPort';
+/*** Compose Studio-owned APM evidence, planning, execution, and verification around one host lifecycle port. */
+export function createStudioProjectUpdateService(options = {}, lifecycle) {
+    return new ProjectUpdateService({
+        ...options,
+        extensions: createStudioProjectUpdateExtensionEvidencePort(options.extensions),
+        protocol: createStudioProjectUpdateProtocolPort(options.protocol, {
+            pendingLifecycleExecution: lifecycle !== undefined,
+        }),
+        ...(lifecycle === undefined
+            ? {}
+            : {
+                applyOwnerStep: createStudioProjectUpdateApplyOwnerStepPort(lifecycle, options.applyOwnerStep),
+                verifyOwnerStep: createStudioProjectUpdateVerifyOwnerStepPort(lifecycle, options.verifyOwnerStep),
+            }),
+    });
+}
+//# sourceMappingURL=createStudioProjectUpdateService.js.map

package/dist/features/project-updates/composition/createStudioProjectUpdateService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStudioProjectUpdateService.js","sourceRoot":"","sources":["../../../../src/features/project-updates/composition/createStudioProjectUpdateService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,EAAE,2CAA2C,EAAE,MAAM,+CAA+C,CAAC;AAC5G,OAAO,EAAE,8CAA8C,EAAE,MAAM,kDAAkD,CAAC;AAClH,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,4CAA4C,EAAE,MAAM,gDAAgD,CAAC;AAE9G,gHAAgH;AAChH,MAAM,UAAU,gCAAgC,CAC9C,UAAuC,EAAE,EACzC,SAA4C;IAE5C,OAAO,IAAI,oBAAoB,CAAC;QAC9B,GAAG,OAAO;QACV,UAAU,EAAE,8CAA8C,CAAC,OAAO,CAAC,UAAU,CAAC;QAC9E,QAAQ,EAAE,qCAAqC,CAAC,OAAO,CAAC,QAAQ,EAAE;YAChE,yBAAyB,EAAE,SAAS,KAAK,SAAS;SACnD,CAAC;QACF,GAAG,CAAC,SAAS,KAAK,SAAS;YACzB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,cAAc,EAAE,2CAA2C,CACzD,SAAS,EACT,OAAO,CAAC,cAAc,CACvB;gBACD,eAAe,EAAE,4CAA4C,CAC3D,SAAS,EACT,OAAO,CAAC,eAAe,CACxB;aACF,CAAC;KACP,CAAC,CAAC;AACL,CAAC"}

package/dist/features/project-updates/composition/createStudioProjectUpdateVerifyOwnerStepPort.d.ts

@@ -0,0 +1,5 @@
+import type { ApmVerifyStepPort } from '@ankhorage/apm/types';
+import type { StudioPendingModuleLifecyclePort } from '../application/StudioPendingModuleLifecyclePort';
+/*** Compose Studio pending-module verification around any pre-existing trusted owner verifier. */
+export declare function createStudioProjectUpdateVerifyOwnerStepPort(lifecycle: StudioPendingModuleLifecyclePort, base?: ApmVerifyStepPort): ApmVerifyStepPort;
+//# sourceMappingURL=createStudioProjectUpdateVerifyOwnerStepPort.d.ts.map

package/dist/features/project-updates/composition/createStudioProjectUpdateVerifyOwnerStepPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStudioProjectUpdateVerifyOwnerStepPort.d.ts","sourceRoot":"","sources":["../../../../src/features/project-updates/composition/createStudioProjectUpdateVerifyOwnerStepPort.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGpF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,iDAAiD,CAAC;AAGxG,kGAAkG;AAClG,wBAAgB,4CAA4C,CAC1D,SAAS,EAAE,gCAAgC,EAC3C,IAAI,CAAC,EAAE,iBAAiB,GACvB,iBAAiB,CAgBnB"}

package/dist/features/project-updates/composition/createStudioProjectUpdateVerifyOwnerStepPort.js

@@ -0,0 +1,67 @@
+import { currentStudioApmArtifactMatchesAsync } from '../adapters/outbound/resolveCurrentStudioApmArtifactAsync';
+import { readReviewedPendingModuleStep } from '../domain/pendingModulePlanStep';
+/*** Compose Studio pending-module verification around any pre-existing trusted owner verifier. */
+export function createStudioProjectUpdateVerifyOwnerStepPort(lifecycle, base) {
+    return {
+        verifyAsync: async (input) => {
+            const reviewed = readReviewedPendingModuleStep(input.step);
+            return reviewed === undefined
+                ? delegateVerifyAsync(base, input)
+                : [
+                    await verifyPendingModuleAsync(input.journal.rootPath, input.step.id, reviewed, lifecycle),
+                ];
+        },
+    };
+}
+/*** Verify the immutable owner binding and exact Orchestrator module postcondition. */
+async function verifyPendingModuleAsync(rootPath, stepId, reviewed, lifecycle) {
+    if (!(await currentStudioApmArtifactMatchesAsync(reviewed.artifact))) {
+        return {
+            id: `verify:${stepId}`,
+            kind: 'projection',
+            status: 'unknown',
+            evidence: [`${reviewed.artifact.packageName}@${reviewed.artifact.version}`],
+            reason: 'Loaded Studio owner code no longer matches the reviewed immutable artifact binding.',
+            nextAction: 'Verify again with the exact reviewed Studio owner artifact.',
+        };
+    }
+    const installed = await lifecycle.isModuleInstalledAsync(rootPath, reviewed.moduleId);
+    if (installed === undefined) {
+        return {
+            id: `verify:${stepId}`,
+            kind: 'projection',
+            status: 'unknown',
+            evidence: [`module:${reviewed.moduleId}`],
+            reason: 'Orchestrator could not determine the reviewed module installation state.',
+        };
+    }
+    return installed
+        ? {
+            id: `verify:${stepId}`,
+            kind: 'projection',
+            status: 'failed',
+            evidence: [`module-installed:${reviewed.moduleId}`],
+            reason: 'Reviewed pending module remains installed after the APM operation.',
+        }
+        : {
+            id: `verify:${stepId}`,
+            kind: 'projection',
+            status: 'passed',
+            evidence: [`module-removed:${reviewed.moduleId}`],
+        };
+}
+/*** Delegate unrelated owner verification or keep the missing verifier explicit. */
+async function delegateVerifyAsync(base, input) {
+    return base === undefined
+        ? [
+            {
+                id: `verify:${input.step.id}`,
+                kind: input.step.kind === 'migration' ? 'migration' : 'projection',
+                status: 'unknown',
+                evidence: [input.step.id],
+                reason: 'No trusted Studio owner verifier handles this reviewed step.',
+            },
+        ]
+        : base.verifyAsync(input);
+}
+//# sourceMappingURL=createStudioProjectUpdateVerifyOwnerStepPort.js.map

package/dist/features/project-updates/composition/createStudioProjectUpdateVerifyOwnerStepPort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStudioProjectUpdateVerifyOwnerStepPort.js","sourceRoot":"","sources":["../../../../src/features/project-updates/composition/createStudioProjectUpdateVerifyOwnerStepPort.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oCAAoC,EAAE,MAAM,2DAA2D,CAAC;AAEjH,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAEhF,kGAAkG;AAClG,MAAM,UAAU,4CAA4C,CAC1D,SAA2C,EAC3C,IAAwB;IAExB,OAAO;QACL,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,6BAA6B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3D,OAAO,QAAQ,KAAK,SAAS;gBAC3B,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC;gBAClC,CAAC,CAAC;oBACE,MAAM,wBAAwB,CAC5B,KAAK,CAAC,OAAO,CAAC,QAAQ,EACtB,KAAK,CAAC,IAAI,CAAC,EAAE,EACb,QAAQ,EACR,SAAS,CACV;iBACF,CAAC;QACR,CAAC;KACF,CAAC;AACJ,CAAC;AAKD,uFAAuF;AACvF,KAAK,UAAU,wBAAwB,CACrC,QAAgB,EAChB,MAAc,EACd,QAAsB,EACtB,SAA2C;IAE3C,IAAI,CAAC,CAAC,MAAM,oCAAoC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACrE,OAAO;YACL,EAAE,EAAE,UAAU,MAAM,EAAE;YACtB,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC3E,MAAM,EAAE,qFAAqF;YAC7F,UAAU,EAAE,6DAA6D;SAC1E,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACtF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO;YACL,EAAE,EAAE,UAAU,MAAM,EAAE;YACtB,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,SAAS;YACjB,QAAQ,EAAE,CAAC,UAAU,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACzC,MAAM,EAAE,0EAA0E;SACnF,CAAC;IACJ,CAAC;IACD,OAAO,SAAS;QACd,CAAC,CAAC;YACE,EAAE,EAAE,UAAU,MAAM,EAAE;YACtB,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,CAAC,oBAAoB,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACnD,MAAM,EAAE,oEAAoE;SAC7E;QACH,CAAC,CAAC;YACE,EAAE,EAAE,UAAU,MAAM,EAAE;YACtB,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,CAAC,kBAAkB,QAAQ,CAAC,QAAQ,EAAE,CAAC;SAClD,CAAC;AACR,CAAC;AAED,oFAAoF;AACpF,KAAK,UAAU,mBAAmB,CAChC,IAAmC,EACnC,KAAkB;IAElB,OAAO,IAAI,KAAK,SAAS;QACvB,CAAC,CAAC;YACE;gBACE,EAAE,EAAE,UAAU,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE;gBAC7B,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY;gBAClE,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,EAAE,8DAA8D;aACvE;SACF;QACH,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/features/project-updates/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const STUDIO_PENDING_MODULE_LIFECYCLE_FILE = ".ankh/pending.json";
+export declare const STUDIO_PENDING_MODULE_LIFECYCLE_EVIDENCE = "studio:pending-module-lifecycle";
+export declare const STUDIO_PENDING_MODULE_LIFECYCLE_PROJECTION_ID = "studio-module-lifecycle";
+//# sourceMappingURL=constants.d.ts.map

package/dist/features/project-updates/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/features/project-updates/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oCAAoC,uBAAuB,CAAC;AACzE,eAAO,MAAM,wCAAwC,oCAAoC,CAAC;AAC1F,eAAO,MAAM,6CAA6C,4BAA4B,CAAC"}

package/dist/features/project-updates/constants.js

@@ -0,0 +1,4 @@
+export const STUDIO_PENDING_MODULE_LIFECYCLE_FILE = '.ankh/pending.json';
+export const STUDIO_PENDING_MODULE_LIFECYCLE_EVIDENCE = 'studio:pending-module-lifecycle';
+export const STUDIO_PENDING_MODULE_LIFECYCLE_PROJECTION_ID = 'studio-module-lifecycle';
+//# sourceMappingURL=constants.js.map

package/dist/features/project-updates/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/features/project-updates/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oCAAoC,GAAG,oBAAoB,CAAC;AACzE,MAAM,CAAC,MAAM,wCAAwC,GAAG,iCAAiC,CAAC;AAC1F,MAAM,CAAC,MAAM,6CAA6C,GAAG,yBAAyB,CAAC"}

package/dist/features/project-updates/domain/pendingModuleLifecycleState.d.ts

@@ -0,0 +1,24 @@
+interface PendingModuleLifecycleOperation {
+    readonly type: 'uninstall';
+    readonly moduleId: string;
+    readonly at: string;
+}
+export interface PendingModuleLifecycleState {
+    readonly ops: readonly PendingModuleLifecycleOperation[];
+}
+export type PendingModuleLifecycleParseResult = {
+    readonly valid: true;
+    readonly value: PendingModuleLifecycleState;
+} | {
+    readonly valid: false;
+};
+/*** Parse Studio's persisted pending module lifecycle state without accepting ambiguous operations. */
+export declare function parsePendingModuleLifecycleState(content: string): PendingModuleLifecycleParseResult;
+/*** Serialize canonical Studio pending lifecycle state for one reviewed APM file change. */
+export declare function serializePendingModuleLifecycleState(state: PendingModuleLifecycleState): string;
+/*** Return pending module ids in the persisted execution order. */
+export declare function pendingModuleLifecycleIds(state: PendingModuleLifecycleState): readonly string[];
+/*** Remove only reviewed module ids while preserving unrelated pending operations. */
+export declare function removeReviewedPendingModules(state: PendingModuleLifecycleState, moduleIds: ReadonlySet<string>): PendingModuleLifecycleState;
+export {};
+//# sourceMappingURL=pendingModuleLifecycleState.d.ts.map

package/dist/features/project-updates/domain/pendingModuleLifecycleState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pendingModuleLifecycleState.d.ts","sourceRoot":"","sources":["../../../../src/features/project-updates/domain/pendingModuleLifecycleState.ts"],"names":[],"mappings":"AAEA,UAAU,+BAA+B;IACvC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,GAAG,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAC1D;AAED,MAAM,MAAM,iCAAiC,GAC3C;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpG,uGAAuG;AACvG,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,MAAM,GACd,iCAAiC,CAYnC;AAED,4FAA4F;AAC5F,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,2BAA2B,GAAG,MAAM,CAE/F;AAED,mEAAmE;AACnE,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,2BAA2B,GAAG,SAAS,MAAM,EAAE,CAE/F;AAED,sFAAsF;AACtF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,2BAA2B,EAClC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAC7B,2BAA2B,CAE7B"}

package/dist/features/project-updates/domain/pendingModuleLifecycleState.js

@@ -0,0 +1,48 @@
+import { isRecord } from '@ankhorage/utility/object';
+/*** Parse Studio's persisted pending module lifecycle state without accepting ambiguous operations. */
+export function parsePendingModuleLifecycleState(content) {
+    const value = parseJson(content);
+    if (!isRecord(value) || !Array.isArray(value.ops))
+        return { valid: false };
+    const ops = value.ops.map(parseOperation);
+    if (ops.some((operation) => operation === undefined))
+        return { valid: false };
+    const parsed = ops.filter((operation) => operation !== undefined);
+    const uniqueIds = new Set(parsed.map(({ moduleId }) => moduleId));
+    return uniqueIds.size === parsed.length
+        ? { valid: true, value: { ops: parsed } }
+        : { valid: false };
+}
+/*** Serialize canonical Studio pending lifecycle state for one reviewed APM file change. */
+export function serializePendingModuleLifecycleState(state) {
+    return `${JSON.stringify(state, null, 2)}\n`;
+}
+/*** Return pending module ids in the persisted execution order. */
+export function pendingModuleLifecycleIds(state) {
+    return state.ops.map(({ moduleId }) => moduleId);
+}
+/*** Remove only reviewed module ids while preserving unrelated pending operations. */
+export function removeReviewedPendingModules(state, moduleIds) {
+    return { ops: state.ops.filter(({ moduleId }) => !moduleIds.has(moduleId)) };
+}
+/*** Parse JSON into unknown data without leaking JSON.parse's any type. */
+function parseJson(content) {
+    try {
+        const value = JSON.parse(content);
+        return value;
+    }
+    catch {
+        return undefined;
+    }
+}
+/*** Validate one persisted pending uninstall operation. */
+function parseOperation(value) {
+    if (!isRecord(value) || value.type !== 'uninstall')
+        return undefined;
+    if (typeof value.moduleId !== 'string' || value.moduleId.trim() === '')
+        return undefined;
+    if (typeof value.at !== 'string' || value.at.trim() === '')
+        return undefined;
+    return { type: 'uninstall', moduleId: value.moduleId.trim(), at: value.at };
+}
+//# sourceMappingURL=pendingModuleLifecycleState.js.map

package/dist/features/project-updates/domain/pendingModuleLifecycleState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pendingModuleLifecycleState.js","sourceRoot":"","sources":["../../../../src/features/project-updates/domain/pendingModuleLifecycleState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAerD,uGAAuG;AACvG,MAAM,UAAU,gCAAgC,CAC9C,OAAe;IAEf,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC3E,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC1C,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,SAAS,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC9E,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CACvB,CAAC,SAAS,EAAgD,EAAE,CAAC,SAAS,KAAK,SAAS,CACrF,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE,OAAO,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM;QACrC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;QACzC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,oCAAoC,CAAC,KAAkC;IACrF,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,yBAAyB,CAAC,KAAkC;IAC1E,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,4BAA4B,CAC1C,KAAkC,EAClC,SAA8B;IAE9B,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,2EAA2E;AAC3E,SAAS,SAAS,CAAC,OAAe;IAChC,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,2DAA2D;AAC3D,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IACrE,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACzF,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC7E,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;AAC9E,CAAC"}

package/dist/features/project-updates/domain/pendingModulePlanStep.d.ts

@@ -0,0 +1,10 @@
+import type { ApmExtensionArtifactIdentity, ApmPlanStep } from '@ankhorage/apm/types';
+export interface ReviewedPendingModuleStep {
+    readonly moduleId: string;
+    readonly pendingDigest: string;
+    readonly manifestDigest: string;
+    readonly artifact: ApmExtensionArtifactIdentity;
+}
+/*** Parse one exact Studio pending-module owner step from a reviewed APM plan. */
+export declare function readReviewedPendingModuleStep(step: ApmPlanStep): ReviewedPendingModuleStep | undefined;
+//# sourceMappingURL=pendingModulePlanStep.d.ts.map

package/dist/features/project-updates/domain/pendingModulePlanStep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pendingModulePlanStep.d.ts","sourceRoot":"","sources":["../../../../src/features/project-updates/domain/pendingModulePlanStep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAOtF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,4BAA4B,CAAC;CACjD;AAED,kFAAkF;AAClF,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,WAAW,GAChB,yBAAyB,GAAG,SAAS,CAUvC"}