@ankhorage/studio 2.7.0 → 2.7.2

package/README.md

@@ -3,7 +3,7 @@
 
 # @ankhorage/studio
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v2.6.3](././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.7.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)
 
 Studio authoring package for Ankhorage apps
 

package/apm/update.json

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

package/dist/features/project-updates/adapters/inbound/registerProjectUpdateRoutes.d.ts

@@ -0,0 +1,16 @@
+import type { ApmApplyInput, ApmPlanProjectInput, ApmStatusInput, ApmVerifyInput } from '@ankhorage/apm/types';
+import type { FastifyInstance } from 'fastify';
+interface ProjectUpdateRouteService {
+    readonly statusAsync: (input: ApmStatusInput) => Promise<unknown>;
+    readonly planAsync: (input: ApmPlanProjectInput) => Promise<unknown>;
+    readonly applyAsync: (input: ApmApplyInput) => Promise<unknown>;
+    readonly verifyAsync: (input: ApmVerifyInput) => Promise<unknown>;
+}
+interface ProjectUpdateRouteOptions {
+    readonly service: ProjectUpdateRouteService;
+    readonly resolveProjectRootAsync: (projectId: string) => Promise<string | undefined>;
+}
+/*** Register the authorized HTTP adapter for Studio's composed APM project-update lifecycle. */
+export declare function registerProjectUpdateRoutes(fastify: FastifyInstance, options: ProjectUpdateRouteOptions): void;
+export {};
+//# sourceMappingURL=registerProjectUpdateRoutes.d.ts.map

package/dist/features/project-updates/adapters/inbound/registerProjectUpdateRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerProjectUpdateRoutes.d.ts","sourceRoot":"","sources":["../../../../../src/features/project-updates/adapters/inbound/registerProjectUpdateRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAIb,mBAAmB,EAInB,cAAc,EACd,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,SAAS,CAAC;AAE7D,UAAU,yBAAyB;IACjC,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACnE;AAED,UAAU,yBAAyB;IACjC,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,uBAAuB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACtF;AAED,gGAAgG;AAChG,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,yBAAyB,GACjC,IAAI,CAwEN"}

package/dist/features/project-updates/adapters/inbound/registerProjectUpdateRoutes.js

@@ -0,0 +1,269 @@
+import { hasOnlyKeys, isRecord } from '@ankhorage/utility/object';
+/*** Register the authorized HTTP adapter for Studio's composed APM project-update lifecycle. */
+export function registerProjectUpdateRoutes(fastify, options) {
+    fastify.get('/api/projects/:id/updates/status', async (request, reply) => {
+        const context = await resolveRequestContext(request.params, options, reply);
+        if (context === undefined)
+            return;
+        const query = isRecord(request.query) ? request.query : {};
+        if (!hasOnlyKeys(query, ['availability']) || !isAvailability(query.availability)) {
+            return sendInvalidRequest(reply);
+        }
+        const input = {
+            rootPath: context.rootPath,
+            ...(query.availability === undefined ? {} : { availability: query.availability }),
+        };
+        return invokeReadOnly(reply, () => options.service.statusAsync(input));
+    });
+    fastify.post('/api/projects/:id/updates/plan', async (request, reply) => {
+        const context = await resolveRequestContext(request.params, options, reply);
+        if (context === undefined)
+            return;
+        const body = request.body === undefined ? {} : request.body;
+        if (!isPlanRequest(body))
+            return sendInvalidRequest(reply);
+        const input = {
+            rootPath: context.rootPath,
+            ...(body.availability === undefined ? {} : { availability: body.availability }),
+            ...(body.policy === undefined ? {} : { policy: body.policy }),
+        };
+        return invokeLifecycle(reply, () => options.service.planAsync(input));
+    });
+    fastify.post('/api/projects/:id/updates/apply', async (request, reply) => {
+        const context = await resolveRequestContext(request.params, options, reply);
+        if (context === undefined)
+            return;
+        const { body } = request;
+        if (!isApplyRequest(body))
+            return sendInvalidRequest(reply);
+        if (body.plan.rootPath !== context.rootPath) {
+            return reply.status(409).send({ error: 'The reviewed plan belongs to another project.' });
+        }
+        return invokeLifecycle(reply, () => options.service.applyAsync({
+            mode: 'start',
+            plan: body.plan,
+            permissions: body.permissions,
+        }));
+    });
+    fastify.post('/api/projects/:id/updates/resume', async (request, reply) => {
+        const context = await resolveRequestContext(request.params, options, reply);
+        if (context === undefined)
+            return;
+        const { body } = request;
+        if (!isResumeRequest(body))
+            return sendInvalidRequest(reply);
+        return invokeLifecycle(reply, () => options.service.applyAsync({
+            mode: 'resume',
+            rootPath: context.rootPath,
+            operationId: body.operationId,
+            permissions: body.permissions,
+        }));
+    });
+    fastify.post('/api/projects/:id/updates/verify', async (request, reply) => {
+        const context = await resolveRequestContext(request.params, options, reply);
+        if (context === undefined)
+            return;
+        const { body } = request;
+        if (!isOperationRequest(body))
+            return sendInvalidRequest(reply);
+        return invokeLifecycle(reply, () => options.service.verifyAsync({
+            rootPath: context.rootPath,
+            operationId: body.operationId,
+        }));
+    });
+}
+/*** Resolve a request's validated project id to its server-owned project root. */
+async function resolveRequestContext(params, options, reply) {
+    if (!isRecord(params) || typeof params.id !== 'string' || params.id.length === 0) {
+        sendInvalidRequest(reply);
+        return undefined;
+    }
+    try {
+        const rootPath = await options.resolveProjectRootAsync(params.id);
+        if (rootPath === undefined) {
+            reply.status(404).send({ error: 'Project not found.' });
+            return undefined;
+        }
+        return { rootPath };
+    }
+    catch {
+        reply.status(404).send({ error: 'Project not found.' });
+        return undefined;
+    }
+}
+/*** Execute one read-only APM request without leaking host exception details. */
+async function invokeReadOnly(reply, operation) {
+    try {
+        return await operation();
+    }
+    catch {
+        return reply.status(500).send({ error: 'Project update request failed.' });
+    }
+}
+/*** Execute one APM lifecycle request and map incomplete or blocked structured results to conflict. */
+async function invokeLifecycle(reply, operation) {
+    try {
+        const result = await operation();
+        if (isLifecycleConflict(result))
+            return reply.status(409).send(result);
+        return result;
+    }
+    catch {
+        return reply.status(500).send({ error: 'Project update request failed.' });
+    }
+}
+/*** Detect structured APM plan/apply/verify results that require further user action. */
+function isLifecycleConflict(value) {
+    if (!isRecord(value) || typeof value.operation !== 'string')
+        return false;
+    if (value.operation === 'plan')
+        return value.complete === false;
+    if (value.operation === 'apply')
+        return value.status !== 'completed';
+    if (value.operation === 'verify')
+        return value.verified === false;
+    return false;
+}
+/*** Return a stable bad-request response without echoing untrusted request data. */
+function sendInvalidRequest(reply) {
+    return reply.status(400).send({ error: 'Invalid project update request.' });
+}
+/*** Validate the optional APM availability mode. */
+function isAvailability(value) {
+    return value === undefined || value === 'refresh' || value === 'offline';
+}
+/*** Validate the bounded request body accepted by the plan route. */
+function isPlanRequest(value) {
+    return (isRecord(value) &&
+        hasOnlyKeys(value, ['availability', 'policy']) &&
+        isAvailability(value.availability) &&
+        (value.policy === undefined || isPlanPolicy(value.policy)));
+}
+/*** Validate the APM plan policy fields exposed by the host adapter. */
+function isPlanPolicy(value) {
+    return (isRecord(value) &&
+        hasOnlyKeys(value, [
+            'dependencyUpdates',
+            'selections',
+            'repairInstallations',
+            'repairProjections',
+            'maxGeneratorIterations',
+        ]) &&
+        (value.dependencyUpdates === undefined ||
+            value.dependencyUpdates === 'safe' ||
+            value.dependencyUpdates === 'selected' ||
+            value.dependencyUpdates === 'none') &&
+        (value.selections === undefined ||
+            (Array.isArray(value.selections) && value.selections.every(isPlanPackageSelection))) &&
+        (value.repairInstallations === undefined || typeof value.repairInstallations === 'boolean') &&
+        (value.repairProjections === undefined || typeof value.repairProjections === 'boolean') &&
+        (value.maxGeneratorIterations === undefined ||
+            (typeof value.maxGeneratorIterations === 'number' &&
+                Number.isInteger(value.maxGeneratorIterations) &&
+                value.maxGeneratorIterations > 0)));
+}
+/*** Validate one package selection in a host-authored APM plan request. */
+function isPlanPackageSelection(value) {
+    if (!isRecord(value) || !hasOnlyKeys(value, ['selector', 'target']))
+        return false;
+    const { selector } = value;
+    if (!isRecord(selector) ||
+        !hasOnlyKeys(selector, ['name', 'packageId', 'installRootId', 'ownerPath'])) {
+        return false;
+    }
+    return (typeof selector.name === 'string' &&
+        selector.name.length > 0 &&
+        isOptionalString(selector.packageId) &&
+        isOptionalString(selector.installRootId) &&
+        isOptionalString(selector.ownerPath) &&
+        isPlanTargetSelection(value.target));
+}
+/*** Validate one compatible/latest/exact APM target selection. */
+function isPlanTargetSelection(value) {
+    if (!isRecord(value) || typeof value.kind !== 'string')
+        return false;
+    if (value.kind === 'compatible')
+        return hasOnlyKeys(value, ['kind']);
+    if (value.kind === 'latest') {
+        return (hasOnlyKeys(value, ['kind', 'allowPrerelease', 'manifestRange']) &&
+            isOptionalBoolean(value.allowPrerelease) &&
+            isOptionalString(value.manifestRange));
+    }
+    if (value.kind === 'version') {
+        return (hasOnlyKeys(value, [
+            'kind',
+            'version',
+            'allowPrerelease',
+            'allowDowngrade',
+            'manifestRange',
+        ]) &&
+            typeof value.version === 'string' &&
+            value.version.length > 0 &&
+            isOptionalBoolean(value.allowPrerelease) &&
+            isOptionalBoolean(value.allowDowngrade) &&
+            isOptionalString(value.manifestRange));
+    }
+    return false;
+}
+/*** Validate the reviewed start request without accepting a caller-controlled project root. */
+function isApplyRequest(value) {
+    return (isRecord(value) &&
+        hasOnlyKeys(value, ['plan', 'permissions']) &&
+        isPlanResult(value.plan) &&
+        isApplyPermissions(value.permissions));
+}
+/*** Validate the durable resume request without accepting a caller-controlled project root. */
+function isResumeRequest(value) {
+    return (isRecord(value) &&
+        hasOnlyKeys(value, ['operationId', 'permissions']) &&
+        isNonEmptyString(value.operationId) &&
+        isApplyPermissions(value.permissions));
+}
+/*** Validate the verify request's operation identity. */
+function isOperationRequest(value) {
+    if (!isRecord(value))
+        return false;
+    return hasOnlyKeys(value, ['operationId']) && isNonEmptyString(value.operationId);
+}
+/*** Validate explicit APM execution permissions. */
+function isApplyPermissions(value) {
+    return (isRecord(value) &&
+        hasOnlyKeys(value, ['ownerCode', 'lifecycleScripts', 'externalEffects']) &&
+        typeof value.ownerCode === 'boolean' &&
+        typeof value.lifecycleScripts === 'boolean' &&
+        typeof value.externalEffects === 'boolean');
+}
+/*** Validate a reviewed APM plan envelope before passing it back to the executor for revalidation. */
+function isPlanResult(value) {
+    return (isRecord(value) &&
+        value.schemaVersion === 2 &&
+        value.operation === 'plan' &&
+        isNonEmptyString(value.id) &&
+        isNonEmptyString(value.rootPath) &&
+        typeof value.complete === 'boolean' &&
+        isRecord(value.policy) &&
+        isRecord(value.executor) &&
+        isRecord(value.inputFingerprint) &&
+        Array.isArray(value.targets) &&
+        Array.isArray(value.files) &&
+        Array.isArray(value.packages) &&
+        Array.isArray(value.artifacts) &&
+        Array.isArray(value.steps) &&
+        Array.isArray(value.effects) &&
+        Array.isArray(value.findings) &&
+        Array.isArray(value.blockers) &&
+        Array.isArray(value.diagnostics));
+}
+/*** Validate an optional string field. */
+function isOptionalString(value) {
+    return value === undefined || typeof value === 'string';
+}
+/*** Validate an optional boolean field. */
+function isOptionalBoolean(value) {
+    return value === undefined || typeof value === 'boolean';
+}
+/*** Validate a required non-empty string. */
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+//# sourceMappingURL=registerProjectUpdateRoutes.js.map

package/dist/features/project-updates/adapters/inbound/registerProjectUpdateRoutes.js.map

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

package/dist/features/projects/adapters/outbound/ProjectGenerationStateStore.d.ts

@@ -0,0 +1,29 @@
+import type { StudioRuntimeProjectionState } from '../../../../types/project-generation';
+/*** Persist and inspect Studio-owned generated-project state in the canonical `.ankh/generation-state.json` document. */
+export declare class ProjectGenerationStateStore {
+    /*** Read whether the current generated project state includes the Studio admin surface. */
+    readStudioInclusionAsync(projectPath: string): Promise<boolean>;
+    /*** Atomically persist Studio inclusion while preserving runtime projection evidence owned by the same state document. */
+    writeStudioInclusionAsync(projectPath: string, includeStudio: boolean): Promise<void>;
+    /*** Resolve current runtime projection currency without exposing persisted runtime signatures to callers. */
+    readRuntimeProjectionStateAsync(projectPath: string, expectedSignature: string): Promise<StudioRuntimeProjectionState>;
+    /*** Record the exact runtime signature only after the owning projection operation completed successfully. */
+    recordRuntimeProjectionSuccessAsync(projectPath: string, appliedSignature: string): Promise<void>;
+    /*** Persist bounded failure evidence for one attempted runtime signature while retaining the last successful signature. */
+    recordRuntimeProjectionFailureAsync(projectPath: string, failedSignature: string): Promise<void>;
+    /*** Read one required generation-state document and reject missing state instead of inferring ownership. */
+    private requireStateAsync;
+    /*** Read, parse and validate one generation-state document, optionally treating a missing file as an empty owner state. */
+    private readStateAsync;
+    /*** Read one generation-state source document with explicit missing-state semantics. */
+    private readStateSourceAsync;
+    /*** Parse one generation-state JSON source while preserving the original parse error as its cause. */
+    private parseStateSource;
+    /*** Validate the semantic shape of Studio's generated-project state document. */
+    private isProjectGenerationState;
+    /*** Validate persisted runtime projection evidence without accepting unrelated or malformed values. */
+    private isRuntimeProjectionEvidence;
+    /*** Resolve the canonical project generation-state path while rejecting path escape. */
+    private resolveStatePath;
+}
+//# sourceMappingURL=ProjectGenerationStateStore.d.ts.map

package/dist/features/projects/adapters/outbound/ProjectGenerationStateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectGenerationStateStore.d.ts","sourceRoot":"","sources":["../../../../../src/features/projects/adapters/outbound/ProjectGenerationStateStore.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,4BAA4B,EAC7B,MAAM,sCAAsC,CAAC;AAU9C,yHAAyH;AACzH,qBAAa,2BAA2B;IACtC,2FAA2F;IACrF,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrE,0HAA0H;IACpH,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3F,6GAA6G;IACvG,+BAA+B,CACnC,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAAC,4BAA4B,CAAC;IAKxC,6GAA6G;IACvG,mCAAmC,CACvC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC;IAShB,2HAA2H;IACrH,mCAAmC,CACvC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC;IAahB,4GAA4G;YAC9F,iBAAiB;IAM/B,2HAA2H;YAC7G,cAAc;IAa5B,wFAAwF;YAC1E,oBAAoB;IAkBlC,sGAAsG;IACtG,OAAO,CAAC,gBAAgB;IAQxB,iFAAiF;IACjF,OAAO,CAAC,wBAAwB;IAShC,uGAAuG;IACvG,OAAO,CAAC,2BAA2B;IASnC,wFAAwF;IACxF,OAAO,CAAC,gBAAgB;CAWzB"}

package/dist/features/projects/adapters/outbound/ProjectGenerationStateStore.js

@@ -0,0 +1,116 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { isMissingPathError, writeJsonFileAtomic } from '@ankhorage/utility/node/fs';
+import { isRecord } from '@ankhorage/utility/object';
+import { resolveStudioRuntimeProjectionState } from '../../domain/resolveStudioRuntimeProjectionState';
+const PROJECT_GENERATION_STATE_REL_PATH = '.ankh/generation-state.json';
+/*** Persist and inspect Studio-owned generated-project state in the canonical `.ankh/generation-state.json` document. */
+export class ProjectGenerationStateStore {
+    /*** Read whether the current generated project state includes the Studio admin surface. */
+    async readStudioInclusionAsync(projectPath) {
+        const state = await this.requireStateAsync(projectPath);
+        return state.includeStudio;
+    }
+    /*** Atomically persist Studio inclusion while preserving runtime projection evidence owned by the same state document. */
+    async writeStudioInclusionAsync(projectPath, includeStudio) {
+        const statePath = this.resolveStatePath(projectPath);
+        const current = await this.readStateAsync(statePath, true);
+        const state = current
+            ? { ...current, includeStudio }
+            : { includeStudio };
+        await writeJsonFileAtomic(statePath, state);
+    }
+    /*** Resolve current runtime projection currency without exposing persisted runtime signatures to callers. */
+    async readRuntimeProjectionStateAsync(projectPath, expectedSignature) {
+        const state = await this.requireStateAsync(projectPath);
+        return resolveStudioRuntimeProjectionState(state.runtimeProjection, expectedSignature);
+    }
+    /*** Record the exact runtime signature only after the owning projection operation completed successfully. */
+    async recordRuntimeProjectionSuccessAsync(projectPath, appliedSignature) {
+        const statePath = this.resolveStatePath(projectPath);
+        const current = await this.requireStateAsync(projectPath);
+        await writeJsonFileAtomic(statePath, {
+            ...current,
+            runtimeProjection: { appliedSignature },
+        });
+    }
+    /*** Persist bounded failure evidence for one attempted runtime signature while retaining the last successful signature. */
+    async recordRuntimeProjectionFailureAsync(projectPath, failedSignature) {
+        const statePath = this.resolveStatePath(projectPath);
+        const current = await this.requireStateAsync(projectPath);
+        const appliedSignature = current.runtimeProjection?.appliedSignature;
+        await writeJsonFileAtomic(statePath, {
+            ...current,
+            runtimeProjection: {
+                ...(appliedSignature === undefined ? {} : { appliedSignature }),
+                failedSignature,
+            },
+        });
+    }
+    /*** Read one required generation-state document and reject missing state instead of inferring ownership. */
+    async requireStateAsync(projectPath) {
+        const state = await this.readStateAsync(this.resolveStatePath(projectPath), false);
+        if (!state)
+            throw new Error('Project generation state unexpectedly resolved as missing.');
+        return state;
+    }
+    /*** Read, parse and validate one generation-state document, optionally treating a missing file as an empty owner state. */
+    async readStateAsync(statePath, allowMissing) {
+        const source = await this.readStateSourceAsync(statePath, allowMissing);
+        if (source === null)
+            return null;
+        const parsed = this.parseStateSource(source, statePath);
+        if (!this.isProjectGenerationState(parsed)) {
+            throw new Error(`Project generation state is invalid at '${statePath}'.`);
+        }
+        return parsed;
+    }
+    /*** Read one generation-state source document with explicit missing-state semantics. */
+    async readStateSourceAsync(statePath, allowMissing) {
+        try {
+            return await fs.readFile(statePath, 'utf8');
+        }
+        catch (error) {
+            if (allowMissing && isMissingPathError(error))
+                return null;
+            if (isMissingPathError(error)) {
+                throw new Error(`Project generation state is missing at '${statePath}'. Run an explicit project sync with includeStudio set before using implicit runtime sync.`, { cause: error });
+            }
+            throw error;
+        }
+    }
+    /*** Parse one generation-state JSON source while preserving the original parse error as its cause. */
+    parseStateSource(source, statePath) {
+        try {
+            return JSON.parse(source);
+        }
+        catch (error) {
+            throw new Error(`Project generation state is invalid at '${statePath}'.`, { cause: error });
+        }
+    }
+    /*** Validate the semantic shape of Studio's generated-project state document. */
+    isProjectGenerationState(value) {
+        return (isRecord(value) &&
+            typeof value.includeStudio === 'boolean' &&
+            (value.runtimeProjection === undefined ||
+                this.isRuntimeProjectionEvidence(value.runtimeProjection)));
+    }
+    /*** Validate persisted runtime projection evidence without accepting unrelated or malformed values. */
+    isRuntimeProjectionEvidence(value) {
+        return (isRecord(value) &&
+            (value.appliedSignature === undefined || typeof value.appliedSignature === 'string') &&
+            (value.failedSignature === undefined || typeof value.failedSignature === 'string') &&
+            (typeof value.appliedSignature === 'string' || typeof value.failedSignature === 'string'));
+    }
+    /*** Resolve the canonical project generation-state path while rejecting path escape. */
+    resolveStatePath(projectPath) {
+        const root = path.resolve(projectPath);
+        const target = path.resolve(root, PROJECT_GENERATION_STATE_REL_PATH);
+        const relative = path.relative(root, target);
+        if (relative.startsWith('..') || path.isAbsolute(relative)) {
+            throw new Error(`Invalid project generation state path: ${PROJECT_GENERATION_STATE_REL_PATH}`);
+        }
+        return target;
+    }
+}
+//# sourceMappingURL=ProjectGenerationStateStore.js.map

package/dist/features/projects/adapters/outbound/ProjectGenerationStateStore.js.map

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

package/dist/features/projects/composition/createProjectGenerationStateStore.d.ts

@@ -0,0 +1,4 @@
+import { ProjectGenerationStateStore } from '../adapters/outbound/ProjectGenerationStateStore';
+/*** Compose Studio's canonical generated-project state store for host project lifecycle orchestration. */
+export declare function createProjectGenerationStateStore(): ProjectGenerationStateStore;
+//# sourceMappingURL=createProjectGenerationStateStore.d.ts.map

package/dist/features/projects/composition/createProjectGenerationStateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProjectGenerationStateStore.d.ts","sourceRoot":"","sources":["../../../../src/features/projects/composition/createProjectGenerationStateStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAE/F,0GAA0G;AAC1G,wBAAgB,iCAAiC,IAAI,2BAA2B,CAE/E"}

package/dist/features/projects/composition/createProjectGenerationStateStore.js

@@ -0,0 +1,6 @@
+import { ProjectGenerationStateStore } from '../adapters/outbound/ProjectGenerationStateStore';
+/*** Compose Studio's canonical generated-project state store for host project lifecycle orchestration. */
+export function createProjectGenerationStateStore() {
+    return new ProjectGenerationStateStore();
+}
+//# sourceMappingURL=createProjectGenerationStateStore.js.map

package/dist/features/projects/composition/createProjectGenerationStateStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createProjectGenerationStateStore.js","sourceRoot":"","sources":["../../../../src/features/projects/composition/createProjectGenerationStateStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAE/F,0GAA0G;AAC1G,MAAM,UAAU,iCAAiC;IAC/C,OAAO,IAAI,2BAA2B,EAAE,CAAC;AAC3C,CAAC"}

package/dist/features/projects/domain/resolveStudioRuntimeProjectionState.d.ts

@@ -0,0 +1,4 @@
+import type { ProjectRuntimeProjectionEvidence, StudioRuntimeProjectionState } from '../../../types/project-generation';
+/*** Resolve durable runtime projection evidence against the current runtime-relevant manifest signature. */
+export declare function resolveStudioRuntimeProjectionState(evidence: ProjectRuntimeProjectionEvidence | undefined, expectedSignature: string): StudioRuntimeProjectionState;
+//# sourceMappingURL=resolveStudioRuntimeProjectionState.d.ts.map

package/dist/features/projects/domain/resolveStudioRuntimeProjectionState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveStudioRuntimeProjectionState.d.ts","sourceRoot":"","sources":["../../../../src/features/projects/domain/resolveStudioRuntimeProjectionState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gCAAgC,EAChC,4BAA4B,EAC7B,MAAM,mCAAmC,CAAC;AAE3C,4GAA4G;AAC5G,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,gCAAgC,GAAG,SAAS,EACtD,iBAAiB,EAAE,MAAM,GACxB,4BAA4B,CAc9B"}

package/dist/features/projects/domain/resolveStudioRuntimeProjectionState.js

@@ -0,0 +1,17 @@
+/*** Resolve durable runtime projection evidence against the current runtime-relevant manifest signature. */
+export function resolveStudioRuntimeProjectionState(evidence, expectedSignature) {
+    if (!evidence) {
+        return { status: 'unknown', reason: 'missing-evidence' };
+    }
+    if (evidence.failedSignature === expectedSignature) {
+        return { status: 'failed', reason: 'projection-failed' };
+    }
+    if (evidence.appliedSignature === expectedSignature) {
+        return { status: 'current', reason: 'applied' };
+    }
+    if (evidence.appliedSignature !== undefined || evidence.failedSignature !== undefined) {
+        return { status: 'pending', reason: 'manifest-changed' };
+    }
+    return { status: 'unknown', reason: 'missing-evidence' };
+}
+//# sourceMappingURL=resolveStudioRuntimeProjectionState.js.map

package/dist/features/projects/domain/resolveStudioRuntimeProjectionState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveStudioRuntimeProjectionState.js","sourceRoot":"","sources":["../../../../src/features/projects/domain/resolveStudioRuntimeProjectionState.ts"],"names":[],"mappings":"AAKA,4GAA4G;AAC5G,MAAM,UAAU,mCAAmC,CACjD,QAAsD,EACtD,iBAAyB;IAEzB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,QAAQ,CAAC,eAAe,KAAK,iBAAiB,EAAE,CAAC;QACnD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,QAAQ,CAAC,gBAAgB,KAAK,iBAAiB,EAAE,CAAC;QACpD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAClD,CAAC;IACD,IAAI,QAAQ,CAAC,gBAAgB,KAAK,SAAS,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACtF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC3D,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;AAC3D,CAAC"}

package/dist/host/http/projectRuntimeRoutes.d.ts

@@ -1,7 +1,7 @@
 import type { FastifyInstance } from 'fastify';
 import type { ProjectManager } from '../orchestrator/projectManager';
-type ProjectRuntimeManager = Pick<ProjectManager, 'upInfrastructure'>;
-/*** Register the provider-neutral infrastructure runtime recovery HTTP adapter. */
+type ProjectRuntimeManager = Pick<ProjectManager, 'getProjectRuntimeProjectionState' | 'upInfrastructure'>;
+/*** Register project runtime status and provider-neutral infrastructure recovery HTTP adapters. */
 export declare function registerProjectRuntimeRoutes(fastify: FastifyInstance, options: {
     readonly projectManager: ProjectRuntimeManager;
     readonly workspaceRoot: string;

package/dist/host/http/projectRuntimeRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projectRuntimeRoutes.d.ts","sourceRoot":"","sources":["../../../src/host/http/projectRuntimeRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,SAAS,CAAC;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,KAAK,qBAAqB,GAAG,IAAI,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;AAEtE,mFAAmF;AACnF,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IACP,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GACA,IAAI,CAWN"}
+{"version":3,"file":"projectRuntimeRoutes.d.ts","sourceRoot":"","sources":["../../../src/host/http/projectRuntimeRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgB,MAAM,SAAS,CAAC;AAE7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,KAAK,qBAAqB,GAAG,IAAI,CAC/B,cAAc,EACd,kCAAkC,GAAG,kBAAkB,CACxD,CAAC;AAEF,mGAAmG;AACnG,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IACP,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GACA,IAAI,CAqBN"}

package/dist/host/http/projectRuntimeRoutes.js

@@ -1,5 +1,15 @@
-/*** Register the provider-neutral infrastructure runtime recovery HTTP adapter. */
+/*** Register project runtime status and provider-neutral infrastructure recovery HTTP adapters. */
 export function registerProjectRuntimeRoutes(fastify, options) {
+    /*** Report bounded runtime projection currency for the project's currently persisted manifest. */
+    fastify.get('/api/projects/:id/runtime/projection', async (request, reply) => {
+        const { id } = request.params;
+        try {
+            return await options.projectManager.getProjectRuntimeProjectionState(id);
+        }
+        catch (error) {
+            return sendRuntimeFailure(reply, error);
+        }
+    });
     /*** Reconcile the project's local infrastructure environment to its desired running state. */
     fastify.post('/api/projects/:id/infra/runtime/ensure', async (request, reply) => {
         const { id } = request.params;
@@ -12,7 +22,7 @@ export function registerProjectRuntimeRoutes(fastify, options) {
         }
     });
 }
-/*** Translate a project infrastructure runtime failure into the bounded Studio HTTP response. */
+/*** Translate a project runtime failure into the bounded Studio HTTP response. */
 function sendRuntimeFailure(reply, error) {
     const message = error instanceof Error ? error.message : String(error);
     return reply.status(500).send({ error: message });

package/dist/host/http/projectRuntimeRoutes.js.map

@@ -1 +1 @@
-{"version":3,"file":"projectRuntimeRoutes.js","sourceRoot":"","sources":["../../../src/host/http/projectRuntimeRoutes.ts"],"names":[],"mappings":"AAMA,mFAAmF;AACnF,MAAM,UAAU,4BAA4B,CAC1C,OAAwB,EACxB,OAGC;IAED,8FAA8F;IAC9F,OAAO,CAAC,IAAI,CAAC,wCAAwC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC9E,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAiC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;YACrE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QACvC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iGAAiG;AACjG,SAAS,kBAAkB,CAAC,KAAmB,EAAE,KAAc;IAC7D,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"projectRuntimeRoutes.js","sourceRoot":"","sources":["../../../src/host/http/projectRuntimeRoutes.ts"],"names":[],"mappings":"AASA,mGAAmG;AACnG,MAAM,UAAU,4BAA4B,CAC1C,OAAwB,EACxB,OAGC;IAED,kGAAkG;IAClG,OAAO,CAAC,GAAG,CAAC,sCAAsC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC3E,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAiC,CAAC;QACzD,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,cAAc,CAAC,gCAAgC,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,8FAA8F;IAC9F,OAAO,CAAC,IAAI,CAAC,wCAAwC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QAC9E,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAiC,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;YACrE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QACvC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kFAAkF;AAClF,SAAS,kBAAkB,CAAC,KAAmB,EAAE,KAAc;IAC7D,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/host/http/server.d.ts

@@ -1,14 +1,16 @@
 import type { FastifyInstance } from 'fastify';
+import { createStudioProjectUpdateService } from '../../features/project-updates/composition/createStudioProjectUpdateService';
 import { ModuleManager } from '../orchestrator/moduleManager';
 import { ProjectManager } from '../orchestrator/projectManager';
 /***
- * Compose the Fastify Studio host by applying security middleware and registering project, template, infrastructure, runtime, media and module HTTP endpoints.
+ * Compose the Fastify Studio host by applying security middleware and registering project, template, infrastructure, runtime, project-update, media and module HTTP endpoints.
  * @todo Split the remaining inline project/template/infrastructure endpoints into domain-owned HTTP route adapters so this server remains composition/bootstrap only and can satisfy canonical function-size lint rules without local overrides.
  */
 export declare function createStudioHostServer(args: {
     projectManager: ProjectManager;
     orchestrator: ModuleManager;
     projectRoot: string;
+    projectUpdateService?: ReturnType<typeof createStudioProjectUpdateService>;
     fastifyInstance?: FastifyInstance;
 }): Promise<FastifyInstance<import("fastify").RawServerDefault, import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, import("fastify").FastifyBaseLogger, import("fastify").FastifyTypeProviderDefault>>;
 export interface StartStudioHostServerOptions {

package/dist/host/http/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/host/http/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAK7E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAgChE;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,aAAa,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,kPA4NA;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,uHAAuH;AACvH,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,MAAM,GAAG,4BAAiC,kPAY9F"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/host/http/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAK7E,OAAO,EAAE,gCAAgC,EAAE,MAAM,6EAA6E,CAAC;AAG/H,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAiChE;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,aAAa,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,UAAU,CAAC,OAAO,gCAAgC,CAAC,CAAC;IAC3E,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC,kPAuOA;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,uHAAuH;AACvH,wBAAsB,qBAAqB,CAAC,OAAO,GAAE,MAAM,GAAG,4BAAiC,kPAY9F"}