@ankhorage/studio 2.6.4 → 2.7.1

package/dist/host/orchestrator/infraSession.js

@@ -1,79 +0,0 @@
-import { ensureProjectInfrastructureRuntime, InfraScriptExecutionError, resolveProjectInfrastructurePortForward, runProjectInfrastructureLifecycle, } from '@ankhorage/infra/project';
-const portForwardSessions = new Map();
-const defaultDependencies = {
-    ensureProjectInfrastructureRuntime,
-    resolveProjectInfrastructurePortForward,
-    runProjectInfrastructureLifecycle,
-};
-/***
- * Ensure one generated project's Infrastructure runtime session is available and remember it for shutdown cleanup.
- * @todo Move Studio Infrastructure-session orchestration out of generic `host/orchestrator` into the owning projects/infra host edge.
- */
-export async function ensureProjectInfrastructureRuntimeSession(args, dependencies = defaultDependencies) {
-    try {
-        await dependencies.ensureProjectInfrastructureRuntime(args);
-    }
-    catch (error) {
-        throw withInfrastructureUpGuidance(error, args.projectId);
-    }
-    portForwardSessions.set(sessionKey(args), args);
-}
-/***
- * Resolve and ensure the web port-forward session required to launch a generated project.
- * @todo Keep this Studio launch-session use case with project/infra application ownership rather than generic orchestration.
- */
-export async function ensureProjectWebLaunchSession(args, dependencies = defaultDependencies) {
-    const endpoint = await dependencies.resolveProjectInfrastructurePortForward(args);
-    const status = await dependencies.runProjectInfrastructureLifecycle({
-        ...args,
-        script: 'port-forward',
-        args: ['status', 'app'],
-    });
-    const started = !/\bapp:\s+running\b/u.test(status.stdout);
-    await ensureProjectInfrastructureRuntimeSession(args, dependencies);
-    return { started, url: endpoint.url };
-}
-/***
- * Stop every remembered project Infrastructure port-forward while tolerating stale external sessions during shutdown.
- * @todo Move global Studio Infrastructure shutdown coordination to the project/infra application edge.
- */
-export async function stopAllProjectInfraPortForwards() {
-    const sessions = [...portForwardSessions.values()];
-    portForwardSessions.clear();
-    await Promise.all(sessions.map(async (session) => {
-        try {
-            await runProjectInfrastructureLifecycle({
-                ...session,
-                script: 'port-forward',
-                args: ['stop', 'all'],
-            });
-        }
-        catch {
-            // Studio shutdown must not be blocked by a stale external runtime session.
-        }
-    }));
-}
-/***
- * Build a stable compound key from project path, project id, and target.
- * @utility @ankhorage/utility/string
- */
-function sessionKey(args) {
-    return `${args.projectPath}:${args.projectId}:${args.target}`;
-}
-/*** Preserve Infrastructure script diagnostics while appending the Studio-specific regeneration guidance. */
-function withInfrastructureUpGuidance(error, projectId) {
-    const guidance = `Run Infrastructure Up to regenerate project '${projectId}' infrastructure before retrying.`;
-    if (error instanceof InfraScriptExecutionError) {
-        const guidedError = new InfraScriptExecutionError({
-            exitCode: error.exitCode,
-            message: `${error.message} ${guidance}`,
-            stderr: error.stderr,
-            stdout: error.stdout,
-        });
-        guidedError.cause = error;
-        return guidedError;
-    }
-    const message = error instanceof Error ? error.message : String(error);
-    return new Error(`${message} ${guidance}`, { cause: error });
-}
-//# sourceMappingURL=infraSession.js.map

package/dist/host/orchestrator/infraSession.js.map

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

package/dist/host/orchestrator/projectGenerationState.d.ts

@@ -1,11 +0,0 @@
-/***
- * Read whether the current generated project state includes the Studio admin surface.
- * @todo Move generation-state persistence from generic `host/orchestrator` into the `projects/` generation domain.
- */
-export declare function readProjectStudioInclusion(projectPath: string): Promise<boolean>;
-/***
- * Atomically persist whether the current generated project state includes the Studio admin surface.
- * @todo Keep this domain wrapper in `projects/`; the generic atomic JSON write primitive can move to Utility.
- */
-export declare function writeProjectStudioInclusion(projectPath: string, includeStudio: boolean): Promise<void>;
-//# sourceMappingURL=projectGenerationState.d.ts.map

package/dist/host/orchestrator/projectGenerationState.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"projectGenerationState.d.ts","sourceRoot":"","sources":["../../../src/host/orchestrator/projectGenerationState.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAItF;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,OAAO,GACrB,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/dist/host/orchestrator/projectGenerationState.js

@@ -1,65 +0,0 @@
-import { isMissingPathError, writeJsonFileAtomic } from '@ankhorage/utility/node/fs';
-import { isRecord } from '@ankhorage/utility/object';
-import { promises as fs } from 'fs';
-import path from 'path';
-const PROJECT_GENERATION_STATE_REL_PATH = '.ankh/generation-state.json';
-/***
- * Read whether the current generated project state includes the Studio admin surface.
- * @todo Move generation-state persistence from generic `host/orchestrator` into the `projects/` generation domain.
- */
-export async function readProjectStudioInclusion(projectPath) {
-    const statePath = resolveProjectFile(projectPath, PROJECT_GENERATION_STATE_REL_PATH);
-    const state = await readProjectGenerationState(statePath);
-    return state.includeStudio;
-}
-/***
- * Atomically persist whether the current generated project state includes the Studio admin surface.
- * @todo Keep this domain wrapper in `projects/`; the generic atomic JSON write primitive can move to Utility.
- */
-export async function writeProjectStudioInclusion(projectPath, includeStudio) {
-    const state = { includeStudio };
-    const statePath = resolveProjectFile(projectPath, PROJECT_GENERATION_STATE_REL_PATH);
-    await writeJsonFileAtomic(statePath, state);
-}
-/*** Read, parse, and validate the required Studio project-generation state document. */
-async function readProjectGenerationState(statePath) {
-    let source;
-    try {
-        source = await fs.readFile(statePath, 'utf8');
-    }
-    catch (error) {
-        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;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(source);
-    }
-    catch (error) {
-        throw new Error(`Project generation state is invalid at '${statePath}'.`, { cause: error });
-    }
-    if (!isProjectGenerationState(parsed)) {
-        throw new Error(`Project generation state is invalid at '${statePath}'.`);
-    }
-    return parsed;
-}
-/*** Validate the semantic shape of a persisted Studio project-generation state document. */
-function isProjectGenerationState(value) {
-    return isRecord(value) && typeof value.includeStudio === 'boolean';
-}
-/***
- * Resolve a relative path beneath a root and reject absolute or escaping paths.
- * @utility @ankhorage/utility/node/path
- */
-function resolveProjectFile(projectPath, relativePath) {
-    const root = path.resolve(projectPath);
-    const target = path.resolve(root, relativePath);
-    const relative = path.relative(root, target);
-    if (relative.startsWith('..') || path.isAbsolute(relative)) {
-        throw new Error(`Invalid project generation state path: ${relativePath}`);
-    }
-    return target;
-}
-//# sourceMappingURL=projectGenerationState.js.map

package/dist/host/orchestrator/projectGenerationState.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"projectGenerationState.js","sourceRoot":"","sources":["../../../src/host/orchestrator/projectGenerationState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,iCAAiC,GAAG,6BAA6B,CAAC;AAMxE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,WAAmB;IAClE,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,EAAE,iCAAiC,CAAC,CAAC;IACrF,MAAM,KAAK,GAAG,MAAM,0BAA0B,CAAC,SAAS,CAAC,CAAC;IAC1D,OAAO,KAAK,CAAC,aAAa,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,WAAmB,EACnB,aAAsB;IAEtB,MAAM,KAAK,GAA2B,EAAE,aAAa,EAAE,CAAC;IACxD,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,EAAE,iCAAiC,CAAC,CAAC;IACrF,MAAM,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,wFAAwF;AACxF,KAAK,UAAU,0BAA0B,CAAC,SAAiB;IACzD,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,2CAA2C,SAAS,4FAA4F,EAChJ,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAY,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,2CAA2C,SAAS,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,2CAA2C,SAAS,IAAI,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4FAA4F;AAC5F,SAAS,wBAAwB,CAAC,KAAc;IAC9C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,SAAS,kBAAkB,CAAC,WAAmB,EAAE,YAAoB;IACnE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,0CAA0C,YAAY,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/host/utils/trimOutput.d.ts

@@ -1,11 +0,0 @@
-export interface TrimmedOutput {
-    text: string;
-    truncated: boolean;
-    originalLength: number;
-}
-/***
- * Limit text to a maximum character count while preserving original length and appending a truncation marker when space permits.
- * @utility @ankhorage/utility/string
- */
-export declare function trimOutputForApi(text: string, maxChars: number): TrimmedOutput;
-//# sourceMappingURL=trimOutput.d.ts.map

package/dist/host/utils/trimOutput.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trimOutput.d.ts","sourceRoot":"","sources":["../../../src/host/utils/trimOutput.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAE9E"}

package/dist/host/utils/trimOutput.js

@@ -1,9 +0,0 @@
-/***
- * Limit text to a maximum character count while preserving original length and appending a truncation marker when space permits.
- * @utility @ankhorage/utility/string
- */
-export function trimOutputForApi(text, maxChars) {
-    return trimOutput(text, maxChars);
-}
-import { trimOutput } from '@ankhorage/utility/string';
-//# sourceMappingURL=trimOutput.js.map

package/dist/host/utils/trimOutput.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"trimOutput.js","sourceRoot":"","sources":["../../../src/host/utils/trimOutput.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAgB;IAC7D,OAAO,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AACD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC"}