@ankhorage/studio 2.6.2 → 2.6.3

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/studio
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v2.6.1](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v2.6.2](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
 
 Studio authoring package for Ankhorage apps
 

package/apm/update.json

@@ -1,7 +1,7 @@
 {
   "protocolVersion": 1,
   "schemaVersion": 1,
-  "owner": { "name": "@ankhorage/studio", "version": "2.6.2" },
+  "owner": { "name": "@ankhorage/studio", "version": "2.6.3" },
   "history": {
     "supported": [{ "sourceRange": ">=2.5.7 <3.0.0", "mode": "no-migration" }],
     "unsupported": [],

package/dist/features/project-updates/adapters/outbound/inspectPendingModuleLifecycleEvidenceAsync.d.ts

@@ -0,0 +1,4 @@
+import type { ApmExtensionEvidence } from '@ankhorage/apm/types';
+/*** Inspect Studio's deferred module removals without mutating or executing the project. */
+export declare function inspectPendingModuleLifecycleEvidenceAsync(rootPath: string): Promise<ApmExtensionEvidence>;
+//# sourceMappingURL=inspectPendingModuleLifecycleEvidenceAsync.d.ts.map

package/dist/features/project-updates/adapters/outbound/inspectPendingModuleLifecycleEvidenceAsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectPendingModuleLifecycleEvidenceAsync.d.ts","sourceRoot":"","sources":["../../../../../src/features/project-updates/adapters/outbound/inspectPendingModuleLifecycleEvidenceAsync.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AASjE,4FAA4F;AAC5F,wBAAsB,0CAA0C,CAC9D,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,CAAC,CAQ/B"}

package/dist/features/project-updates/adapters/outbound/inspectPendingModuleLifecycleEvidenceAsync.js

@@ -0,0 +1,148 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { isRecord } from '@ankhorage/utility/object';
+import { STUDIO_PENDING_MODULE_LIFECYCLE_EVIDENCE, STUDIO_PENDING_MODULE_LIFECYCLE_FILE, STUDIO_PENDING_MODULE_LIFECYCLE_PROJECTION_ID, } from '../../constants';
+/*** Inspect Studio's deferred module removals without mutating or executing the project. */
+export async function inspectPendingModuleLifecycleEvidenceAsync(rootPath) {
+    const filePath = path.join(rootPath, STUDIO_PENDING_MODULE_LIFECYCLE_FILE);
+    try {
+        const content = await readFile(filePath, 'utf8');
+        return toExtensionEvidence(parsePendingModuleIds(content));
+    }
+    catch (error) {
+        return isMissingFileError(error) ? availableEvidence([]) : unreadableEvidence(error);
+    }
+}
+/*** Parse only the current Studio pending-operation shape and reject ambiguous state. */
+function parsePendingModuleIds(content) {
+    const value = parseJson(content);
+    if (!isRecord(value) || !Array.isArray(value.ops))
+        return { valid: false };
+    const moduleIds = value.ops.map(readPendingModuleId);
+    if (moduleIds.some((moduleId) => moduleId === undefined))
+        return { valid: false };
+    const ids = moduleIds.filter((moduleId) => moduleId !== undefined);
+    return { valid: true, moduleIds: [...new Set(ids)].sort(compareText) };
+}
+/*** Parse JSON into unknown data without allowing JSON.parse's any type beyond this boundary. */
+function parseJson(content) {
+    try {
+        const value = JSON.parse(content);
+        return value;
+    }
+    catch {
+        return undefined;
+    }
+}
+/*** Validate one queued uninstall operation and return its normalized module id. */
+function readPendingModuleId(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 value.moduleId.trim();
+}
+/*** Convert parsed pending state into conservative APM extension evidence. */
+function toExtensionEvidence(result) {
+    if (!result.valid)
+        return malformedEvidence();
+    return availableEvidence(result.moduleIds);
+}
+/*** Return complete Studio extension evidence for absent, empty, or valid pending state. */
+function availableEvidence(moduleIds) {
+    if (moduleIds.length === 0) {
+        return { state: 'available', complete: true, observations: [], diagnostics: [] };
+    }
+    return {
+        state: 'available',
+        complete: true,
+        observations: [
+            {
+                owner: '@ankhorage/studio',
+                projection: 'stale',
+                migration: 'not-applicable',
+                evidence: pendingEvidence(moduleIds),
+                reason: 'Studio has deferred module removals that are not yet materialized.',
+                nextAction: 'Review the pending Studio module lifecycle work before applying project updates.',
+            },
+        ],
+        diagnostics: [],
+    };
+}
+/*** Return incomplete evidence when the pending file exists but has an unsupported shape. */
+function malformedEvidence() {
+    const evidence = baseEvidence();
+    return {
+        state: 'available',
+        complete: false,
+        observations: [
+            {
+                owner: '@ankhorage/studio',
+                projection: 'unknown',
+                migration: 'not-applicable',
+                evidence,
+                reason: 'Studio pending module lifecycle state is malformed or unsupported.',
+                nextAction: 'Repair or recreate the Studio pending module lifecycle state before updating.',
+            },
+        ],
+        diagnostics: [
+            {
+                code: 'studio.pending-module-lifecycle.invalid',
+                severity: 'error',
+                scope: { kind: 'projection', id: STUDIO_PENDING_MODULE_LIFECYCLE_PROJECTION_ID },
+                evidence,
+                reason: 'The pending module lifecycle file cannot be interpreted safely.',
+                nextAction: 'Repair or recreate the Studio pending module lifecycle state before updating.',
+            },
+        ],
+    };
+}
+/*** Return incomplete evidence when the pending state cannot be read for an unexpected reason. */
+function unreadableEvidence(error) {
+    const detail = error instanceof Error ? error.message : 'unknown pending-state read failure';
+    return {
+        state: 'available',
+        complete: false,
+        observations: [
+            {
+                owner: '@ankhorage/studio',
+                projection: 'unknown',
+                migration: 'not-applicable',
+                evidence: [...baseEvidence(), detail],
+                reason: 'Studio pending module lifecycle state could not be inspected.',
+                nextAction: 'Restore readable project state before updating.',
+            },
+        ],
+        diagnostics: [
+            {
+                code: 'studio.pending-module-lifecycle.unreadable',
+                severity: 'error',
+                scope: { kind: 'projection', id: STUDIO_PENDING_MODULE_LIFECYCLE_PROJECTION_ID },
+                evidence: [...baseEvidence(), detail],
+                reason: 'The pending module lifecycle file could not be read.',
+                nextAction: 'Restore readable project state before updating.',
+            },
+        ],
+    };
+}
+/*** Build stable evidence for the pending lifecycle projection. */
+function pendingEvidence(moduleIds) {
+    return [...baseEvidence(), ...moduleIds.map((moduleId) => `module-uninstall:${moduleId}`)];
+}
+/*** Build the stable evidence prefix used to recognize Studio's pending lifecycle projection. */
+function baseEvidence() {
+    return [STUDIO_PENDING_MODULE_LIFECYCLE_EVIDENCE, STUDIO_PENDING_MODULE_LIFECYCLE_FILE];
+}
+/*** Detect a missing pending file without depending on a Node-specific error assertion. */
+function isMissingFileError(error) {
+    return isRecord(error) && error.code === 'ENOENT';
+}
+/*** Compare serialized identifiers without locale-dependent ordering. */
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    return left > right ? 1 : 0;
+}
+//# sourceMappingURL=inspectPendingModuleLifecycleEvidenceAsync.js.map

package/dist/features/project-updates/adapters/outbound/inspectPendingModuleLifecycleEvidenceAsync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspectPendingModuleLifecycleEvidenceAsync.js","sourceRoot":"","sources":["../../../../../src/features/project-updates/adapters/outbound/inspectPendingModuleLifecycleEvidenceAsync.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,4 @@
+import type { ApmPlanProtocolPort } from '@ankhorage/apm/types';
+/*** Extend package-owner planning with explicit pending Studio module-lifecycle blockers. */
+export declare function createStudioProjectUpdateProtocolPort(base?: ApmPlanProtocolPort): ApmPlanProtocolPort;
+//# 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,EAGV,mBAAmB,EAEpB,MAAM,sBAAsB,CAAC;AAO9B,6FAA6F;AAC7F,wBAAgB,qCAAqC,CACnD,IAAI,CAAC,EAAE,mBAAmB,GACzB,mBAAmB,CA0BrB"}

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

@@ -0,0 +1,67 @@
+import { STUDIO_PENDING_MODULE_LIFECYCLE_EVIDENCE, STUDIO_PENDING_MODULE_LIFECYCLE_PROJECTION_ID, } from '../constants';
+/*** Extend package-owner planning with explicit pending Studio module-lifecycle blockers. */
+export function createStudioProjectUpdateProtocolPort(base) {
+    return {
+        planProtocolAsync: async (input) => {
+            const baseResult = await readBaseProtocolResultAsync(base, input);
+            const pending = input.status.extensions.observations.find(isPendingModuleLifecycleObservation);
+            const unhandled = base === undefined
+                ? input.status.extensions.observations.filter((observation) => !isPendingModuleLifecycleObservation(observation) &&
+                    requiresProtocolPlanning(observation, input.policy.repairProjections))
+                : [];
+            const additionalBlockers = [
+                ...(pending === undefined ? [] : [pendingLifecycleBlocker(pending)]),
+                ...(unhandled.length === 0 ? [] : [protocolUnavailableBlocker(unhandled)]),
+            ];
+            return {
+                ...baseResult,
+                complete: baseResult.complete && additionalBlockers.length === 0,
+                blockers: [...baseResult.blockers, ...additionalBlockers],
+            };
+        },
+    };
+}
+const EMPTY_PROTOCOL_RESULT = {
+    complete: true,
+    requiredSelections: [],
+    files: [],
+    artifacts: [],
+    steps: [],
+    effects: [],
+    findings: [],
+    blockers: [],
+    diagnostics: [],
+};
+/*** 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);
+}
+/*** Identify the Studio-owned pending module lifecycle observation by stable evidence. */
+function isPendingModuleLifecycleObservation(observation) {
+    return observation.evidence.includes(STUDIO_PENDING_MODULE_LIFECYCLE_EVIDENCE);
+}
+/*** Mirror APM's owner-planning requirement for evidence not handled by Studio's local blocker. */
+function requiresProtocolPlanning(observation, repairProjections) {
+    return (observation.migration === 'pending' || (repairProjections && observation.projection === 'stale'));
+}
+/*** Block apply until queued removals have a reviewed owner execution boundary. */
+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 no reviewed APM owner execution step exists for their Orchestrator lifecycle effects yet.',
+        nextAction: 'Review or finalize the pending module lifecycle through its explicit owner flow before applying the project update plan.',
+    };
+}
+/*** 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":"AAOA,OAAO,EACL,wCAAwC,EACxC,6CAA6C,GAC9C,MAAM,cAAc,CAAC;AAEtB,6FAA6F;AAC7F,MAAM,UAAU,qCAAqC,CACnD,IAA0B;IAE1B,OAAO;QACL,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACjC,MAAM,UAAU,GAAG,MAAM,2BAA2B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAClE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CACvD,mCAAmC,CACpC,CAAC;YACF,MAAM,SAAS,GACb,IAAI,KAAK,SAAS;gBAChB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CACzC,CAAC,WAAW,EAAE,EAAE,CACd,CAAC,mCAAmC,CAAC,WAAW,CAAC;oBACjD,wBAAwB,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC,CACxE;gBACH,CAAC,CAAC,EAAE,CAAC;YACT,MAAM,kBAAkB,GAAG;gBACzB,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;gBACpE,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,0BAA0B,CAAC,SAAS,CAAC,CAAC,CAAC;aAC3E,CAAC;YACF,OAAO;gBACL,GAAG,UAAU;gBACb,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC;gBAChE,QAAQ,EAAE,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,GAAG,kBAAkB,CAAC;aAC1D,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,qBAAqB,GAA0B;IACnD,QAAQ,EAAE,IAAI;IACd,kBAAkB,EAAE,EAAE;IACtB,KAAK,EAAE,EAAE;IACT,SAAS,EAAE,EAAE;IACb,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,sFAAsF;AACtF,KAAK,UAAU,2BAA2B,CACxC,IAAqC,EACrC,KAA8D;IAE9D,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;AACpF,CAAC;AAED,0FAA0F;AAC1F,SAAS,mCAAmC,CAAC,WAAoC;IAC/E,OAAO,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,wCAAwC,CAAC,CAAC;AACjF,CAAC;AAED,mGAAmG;AACnG,SAAS,wBAAwB,CAC/B,WAAoC,EACpC,iBAA0B;IAE1B,OAAO,CACL,WAAW,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,iBAAiB,IAAI,WAAW,CAAC,UAAU,KAAK,OAAO,CAAC,CACjG,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,SAAS,uBAAuB,CAAC,WAAoC;IACnE,OAAO;QACL,IAAI,EAAE,0CAA0C;QAChD,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,6CAA6C,EAAE;QAChF,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,MAAM,EACJ,kIAAkI;QACpI,UAAU,EACR,0HAA0H;KAC7H,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,SAAS,0BAA0B,CACjC,YAAgD;IAEhD,OAAO;QACL,IAAI,EAAE,2BAA2B;QACjC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC1B,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC;QACrE,MAAM,EAAE,mFAAmF;QAC3F,UAAU,EAAE,6EAA6E;KAC1F,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { ProjectUpdateServiceOptions } from '../../../types/project-updates';
+import { ProjectUpdateService } from '../application/ProjectUpdateService';
+/*** Compose Studio-owned status and planning evidence around the released APM lifecycle service. */
+export declare function createStudioProjectUpdateService(options?: ProjectUpdateServiceOptions): 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;AAI3E,oGAAoG;AACpG,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CAMtB"}

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

@@ -0,0 +1,12 @@
+import { ProjectUpdateService } from '../application/ProjectUpdateService';
+import { createStudioProjectUpdateExtensionEvidencePort } from './createStudioProjectUpdateExtensionEvidencePort';
+import { createStudioProjectUpdateProtocolPort } from './createStudioProjectUpdateProtocolPort';
+/*** Compose Studio-owned status and planning evidence around the released APM lifecycle service. */
+export function createStudioProjectUpdateService(options = {}) {
+    return new ProjectUpdateService({
+        ...options,
+        extensions: createStudioProjectUpdateExtensionEvidencePort(options.extensions),
+        protocol: createStudioProjectUpdateProtocolPort(options.protocol),
+    });
+}
+//# 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;AAC3E,OAAO,EAAE,8CAA8C,EAAE,MAAM,kDAAkD,CAAC;AAClH,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAEhG,oGAAoG;AACpG,MAAM,UAAU,gCAAgC,CAC9C,UAAuC,EAAE;IAEzC,OAAO,IAAI,oBAAoB,CAAC;QAC9B,GAAG,OAAO;QACV,UAAU,EAAE,8CAA8C,CAAC,OAAO,CAAC,UAAU,CAAC;QAC9E,QAAQ,EAAE,qCAAqC,CAAC,OAAO,CAAC,QAAQ,CAAC;KAClE,CAAC,CAAC;AACL,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/host/createStudioHost.d.ts

@@ -1,4 +1,3 @@
-import { ProjectUpdateService } from '../features/project-updates/application/ProjectUpdateService';
 import { ProjectDeployService } from './deploy/ProjectDeployService';
 import { ModuleManager } from './orchestrator/moduleManager';
 import { ProjectManager } from './orchestrator/projectManager';
@@ -13,7 +12,7 @@ export declare function createStudioHost(options: CreateStudioHostOptions): {
     workspaceRoot: string;
     projectManager: ProjectManager;
     moduleManager: ModuleManager;
-    projectUpdateService: ProjectUpdateService;
+    projectUpdateService: import(".").ProjectUpdateService;
     projectDeployService: ProjectDeployService;
     /*** Close host-owned infrastructure sessions during Studio host shutdown. */
     close(): Promise<void>;

package/dist/host/createStudioHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createStudioHost.d.ts","sourceRoot":"","sources":["../../src/host/createStudioHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8DAA8D,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB;;;;;;IAc7D,6EAA6E;;EAKhF;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"createStudioHost.d.ts","sourceRoot":"","sources":["../../src/host/createStudioHost.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB;;;;;;IAc7D,6EAA6E;;EAKhF;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/host/createStudioHost.js

@@ -1,4 +1,4 @@
-import { ProjectUpdateService } from '../features/project-updates/application/ProjectUpdateService';
+import { createStudioProjectUpdateService } from '../features/project-updates/composition/createStudioProjectUpdateService';
 import { ProjectDeployService } from './deploy/ProjectDeployService';
 import { stopAllProjectInfraPortForwards } from './orchestrator/infraSession';
 import { ModuleManager } from './orchestrator/moduleManager';
@@ -10,7 +10,7 @@ import { ProjectManager } from './orchestrator/projectManager';
 export function createStudioHost(options) {
     const projectManager = new ProjectManager(options.workspaceRoot);
     const moduleManager = new ModuleManager(options.workspaceRoot);
-    const projectUpdateService = new ProjectUpdateService();
+    const projectUpdateService = createStudioProjectUpdateService();
     const projectDeployService = new ProjectDeployService({
         projectManager,
         workspaceRoot: options.workspaceRoot,

package/dist/host/createStudioHost.js.map

@@ -1 +1 @@
-{"version":3,"file":"createStudioHost.js","sourceRoot":"","sources":["../../src/host/createStudioHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8DAA8D,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAM/D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/D,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAC;IACxD,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,CAAC;QACpD,cAAc;QACd,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;IACH,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,cAAc;QACd,aAAa;QACb,oBAAoB;QACpB,oBAAoB;QACpB,6EAA6E;QAC7E,KAAK,CAAC,KAAK;YACT,MAAM,+BAA+B,EAAE,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"createStudioHost.js","sourceRoot":"","sources":["../../src/host/createStudioHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,0EAA0E,CAAC;AAC5H,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAM/D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/D,MAAM,oBAAoB,GAAG,gCAAgC,EAAE,CAAC;IAChE,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,CAAC;QACpD,cAAc;QACd,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;IACH,OAAO;QACL,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,cAAc;QACd,aAAa;QACb,oBAAoB;QACpB,oBAAoB;QACpB,6EAA6E;QAC7E,KAAK,CAAC,KAAK;YACT,MAAM,+BAA+B,EAAE,CAAC;QAC1C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ankhorage/studio",
-  "version": "2.6.2",
+  "version": "2.6.3",
   "description": "Studio authoring package for Ankhorage apps",
   "license": "MIT",
   "homepage": "https://github.com/ankhorage/studio#readme",