@ankhorage/studio 2.0.22 → 2.0.24

package/dist/host/secrets/projectSecretService.js

@@ -8,6 +8,7 @@ import { createBunSupabaseVaultClient, } from './bunSupabaseVaultClient';
 import { resolveProjectSecretDatabaseUrl } from './resolveProjectSecretDatabaseUrl';
 export class ProjectSecretUsageError extends Error {
     code;
+    /*** Create the domain error used when a secret reference cannot be inspected safely. */
     constructor(args) {
         super(args.message);
         this.name = 'ProjectSecretUsageError';
@@ -19,6 +20,10 @@ export class ProjectSecretService {
     workspaceRoot;
     createClient;
     resolveDatabaseUrl;
+    /***
+     * @todo Keep this service in the Secrets application/host boundary; it owns project secret-store lifecycle and trusted Vault access rather than generic persistence.
+     * Create the project-scoped secret application service with injectable trusted Vault boundaries.
+     */
     constructor(options) {
         this.projectManager = options.projectManager;
         this.workspaceRoot = options.workspaceRoot;
@@ -27,6 +32,7 @@ export class ProjectSecretService {
             options.resolveDatabaseUrl ??
                 ((projectPath, target) => resolveProjectSecretDatabaseUrl({ projectPath, target }));
     }
+    /*** List secret metadata for a project/environment scope with optional kind and provider filters. */
     list(input) {
         return this.withAdapter(input.projectId, (adapter) => adapter.list({
             scope: createScope(input.projectId, input.environment),
@@ -34,12 +40,14 @@ export class ProjectSecretService {
             ...(input.provider ? { provider: input.provider } : {}),
         }));
     }
+    /*** Read secret metadata for one project-scoped reference without resolving its payload. */
     getMetadata(input) {
         return this.withAdapter(input.projectId, (adapter) => adapter.getMetadata({
             scope: createScope(input.projectId, input.environment),
             ref: input.ref,
         }));
     }
+    /*** Create a new project secret through the configured Infra secret-store adapter. */
     create(input) {
         return this.withAdapter(input.projectId, (adapter) => adapter.create({
             scope: createScope(input.projectId, input.environment),
@@ -49,6 +57,7 @@ export class ProjectSecretService {
             payload: input.payload,
         }));
     }
+    /*** Replace the payload stored behind an existing project secret reference. */
     replace(input) {
         return this.withAdapter(input.projectId, (adapter) => adapter.replace({
             scope: createScope(input.projectId, input.environment),
@@ -56,18 +65,21 @@ export class ProjectSecretService {
             payload: input.payload,
         }));
     }
+    /*** Remove one project secret directly from the configured secret store. */
     remove(input) {
         return this.withAdapter(input.projectId, (adapter) => adapter.remove({
             scope: createScope(input.projectId, input.environment),
             ref: input.ref,
         }));
     }
+    /*** Resolve the trusted payload behind one project-scoped secret reference. */
     resolve(input) {
         return this.withAdapter(input.projectId, (adapter) => adapter.resolve({
             scope: createScope(input.projectId, input.environment),
             ref: input.ref,
         }));
     }
+    /*** Inspect the current project manifest and report every usage of a normalized secret reference. */
     async getUsages(input) {
         const refResult = normalizeSecretRef(input.ref);
         if (!refResult.ok) {
@@ -76,6 +88,9 @@ export class ProjectSecretService {
         const manifest = await this.readEditableManifest(input.projectId);
         return findProjectSecretUsages({ manifest, ref: refResult.data });
     }
+    /***
+     * Remove a secret only after evaluating current manifest usages and requiring explicit confirmation for broken references.
+     */
     async removeGuarded(input) {
         let client = null;
         const refResult = normalizeSecretRef(input.ref);
@@ -140,6 +155,7 @@ export class ProjectSecretService {
             await client?.close();
         }
     }
+    /*** Validate and upsert trusted OAuth provider credentials into the project secret store. */
     async configureOAuthProvider(input) {
         const definition = getSupabaseOAuthProviderDefinition(input.providerId);
         if (!definition) {
@@ -198,6 +214,10 @@ export class ProjectSecretService {
             credentialsRef: refResult.data,
         };
     }
+    /***
+     * @todo Reassess the duplicate manifest retry when the Projects/Secrets boundary is migrated; the second call currently repeats the same read without changing inputs.
+     * Read the current editable project manifest, retrying the same manager once on failure.
+     */
     async readEditableManifest(projectId) {
         try {
             return await this.projectManager.getProjectManifest(projectId);
@@ -206,6 +226,7 @@ export class ProjectSecretService {
             return this.projectManager.getProjectManifest(projectId);
         }
     }
+    /*** Open the trusted project secret adapter for one operation and always close its Vault client afterward. */
     async withAdapter(projectId, operation) {
         let client = null;
         try {
@@ -247,18 +268,27 @@ export class ProjectSecretService {
         }
     }
 }
+/*** Build the canonical project/environment scope used by the Secret-store contract. */
 function createScope(projectId, environment = 'local') {
     return {
         projectId,
         environment: normalizeOptionalText(environment) ?? 'local',
     };
 }
+/***
+ * @utility @ankhorage/utility/value
+ * Normalize optional user text to a trimmed non-empty string; this collapses to `asNonEmptyString`.
+ */
 function normalizeOptionalText(value) {
     const normalized = value?.trim();
     if (!normalized)
         return undefined;
     return normalized;
 }
+/***
+ * @utility @ankhorage/utility/error
+ * Project a structured error to the public `{ code, message }` pair; this collapses to `pickCodeMessage`.
+ */
 function toPublicError(error) {
     return { code: error.code, message: error.message };
 }

package/dist/host/secrets/projectSecretService.js.map

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

package/dist/host/secrets/resolveProjectSecretDatabaseUrl.d.ts

@@ -3,5 +3,9 @@ export interface ResolveProjectSecretDatabaseUrlInput {
     readonly target: string;
     readonly processEnvironment?: Readonly<Record<string, string | undefined>>;
 }
+/***
+ * @todo Keep trusted secret-store database resolution with the Secrets host edge; it composes host environment and generated Infra state rather than providing a generic URL helper.
+ * Resolve the trusted database URL used by the project secret store, preferring an explicit host override over generated Infra state.
+ */
 export declare function resolveProjectSecretDatabaseUrl(input: ResolveProjectSecretDatabaseUrlInput): Promise<string>;
 //# sourceMappingURL=resolveProjectSecretDatabaseUrl.d.ts.map

package/dist/host/secrets/resolveProjectSecretDatabaseUrl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolveProjectSecretDatabaseUrl.d.ts","sourceRoot":"","sources":["../../../src/host/secrets/resolveProjectSecretDatabaseUrl.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CAC5E;AAED,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,oCAAoC,GAC1C,OAAO,CAAC,MAAM,CAAC,CAkBjB"}
+{"version":3,"file":"resolveProjectSecretDatabaseUrl.d.ts","sourceRoot":"","sources":["../../../src/host/secrets/resolveProjectSecretDatabaseUrl.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CAC5E;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,oCAAoC,GAC1C,OAAO,CAAC,MAAM,CAAC,CAkBjB"}

package/dist/host/secrets/resolveProjectSecretDatabaseUrl.js

@@ -1,6 +1,10 @@
 import { resolveProjectInfrastructureDatabaseUrl } from '@ankhorage/infra/project';
-import { readOwnProperty } from '../../utils/readOwnProperty';
+import { readOwnProperty } from '@ankhorage/utility/object';
 const TRUSTED_HOST_DATABASE_URL_KEY = 'ANKH_SECRET_STORE_DATABASE_URL';
+/***
+ * @todo Keep trusted secret-store database resolution with the Secrets host edge; it composes host environment and generated Infra state rather than providing a generic URL helper.
+ * Resolve the trusted database URL used by the project secret store, preferring an explicit host override over generated Infra state.
+ */
 export async function resolveProjectSecretDatabaseUrl(input) {
     const rawTrustedHostValue = (input.processEnvironment
         ? readOwnProperty(input.processEnvironment, TRUSTED_HOST_DATABASE_URL_KEY)

package/dist/host/secrets/resolveProjectSecretDatabaseUrl.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveProjectSecretDatabaseUrl.js","sourceRoot":"","sources":["../../../src/host/secrets/resolveProjectSecretDatabaseUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uCAAuC,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,6BAA6B,GAAG,gCAAgC,CAAC;AAQvE,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,KAA2C;IAE3C,MAAM,mBAAmB,GACvB,CAAC,KAAK,CAAC,kBAAkB;QACvB,CAAC,CAAC,eAAe,CAAqB,KAAK,CAAC,kBAAkB,EAAE,6BAA6B,CAAC;QAC9F,CAAC,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC;IAC/D,MAAM,gBAAgB,GACpB,OAAO,mBAAmB,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACnF,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAC;IAE9C,MAAM,YAAY,GAAG,MAAM,uCAAuC,CAAC;QACjE,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;IACH,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,MAAM,IAAI,KAAK,CACb,8IAA8I,CAC/I,CAAC;AACJ,CAAC"}
+{"version":3,"file":"resolveProjectSecretDatabaseUrl.js","sourceRoot":"","sources":["../../../src/host/secrets/resolveProjectSecretDatabaseUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uCAAuC,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,6BAA6B,GAAG,gCAAgC,CAAC;AAQvE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,KAA2C;IAE3C,MAAM,mBAAmB,GACvB,CAAC,KAAK,CAAC,kBAAkB;QACvB,CAAC,CAAC,eAAe,CAAqB,KAAK,CAAC,kBAAkB,EAAE,6BAA6B,CAAC;QAC9F,CAAC,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC;IAC/D,MAAM,gBAAgB,GACpB,OAAO,mBAAmB,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACnF,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAC;IAE9C,MAAM,YAAY,GAAG,MAAM,uCAAuC,CAAC;QACjE,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;IACH,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,MAAM,IAAI,KAAK,CACb,8IAA8I,CAC/I,CAAC;AACJ,CAAC"}

package/dist/host/secrets/trustedOAuthInfraEnvironment.d.ts

@@ -14,12 +14,20 @@ export type TrustedOAuthInfraEnvironmentForUpResult = {
     readonly env: Record<string, string | undefined>;
     readonly reason: string;
 };
+/***
+ * @todo Keep the deferred Secret-store handling in the Secrets/Infra application boundary; it represents Studio OAuth rollout policy rather than a generic error wrapper.
+ * Resolve trusted OAuth environment variables for Infra Up while turning secret-store unavailability into an explicit deferred result.
+ */
 export declare function resolveTrustedOAuthInfraEnvironmentForUp(args: {
     readonly projectId: string;
     readonly projectManager: Pick<ProjectManager, 'getProjectManifest'>;
     readonly workspaceRoot: string;
     readonly secretResolver?: TrustedOAuthSecretResolver;
 }): Promise<TrustedOAuthInfraEnvironmentForUpResult>;
+/***
+ * @todo Keep OAuth-provider credential resolution and GoTrue environment assembly in the Secrets/Auth boundary.
+ * Resolve enabled OAuth provider credentials into the trusted GoTrue environment expected by generated Infra.
+ */
 export declare function resolveTrustedOAuthInfraEnvironment(args: {
     readonly projectId: string;
     readonly projectManager: Pick<ProjectManager, 'getProjectManifest'>;

package/dist/host/secrets/trustedOAuthInfraEnvironment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trustedOAuthInfraEnvironment.d.ts","sourceRoot":"","sources":["../../../src/host/secrets/trustedOAuthInfraEnvironment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAErF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,KAAK,EAAE;QACb,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC;CAC/C;AAED,MAAM,MAAM,uCAAuC,GAC/C;IACE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAClD,GACD;IACE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AASN,wBAAsB,wCAAwC,CAAC,IAAI,EAAE;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC;IACpE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,0BAA0B,CAAC;CACtD,GAAG,OAAO,CAAC,uCAAuC,CAAC,CAgBnD;AAED,wBAAsB,mCAAmC,CAAC,IAAI,EAAE;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC;IACpE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,0BAA0B,CAAC;CACtD,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAuD9C"}
+{"version":3,"file":"trustedOAuthInfraEnvironment.d.ts","sourceRoot":"","sources":["../../../src/host/secrets/trustedOAuthInfraEnvironment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAErF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,KAAK,EAAE;QACb,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC;CAC/C;AAED,MAAM,MAAM,uCAAuC,GAC/C;IACE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAClD,GACD;IACE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AASN;;;GAGG;AACH,wBAAsB,wCAAwC,CAAC,IAAI,EAAE;IACnE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC;IACpE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,0BAA0B,CAAC;CACtD,GAAG,OAAO,CAAC,uCAAuC,CAAC,CAgBnD;AAED;;;GAGG;AACH,wBAAsB,mCAAmC,CAAC,IAAI,EAAE;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC;IACpE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,0BAA0B,CAAC;CACtD,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAuD9C"}

package/dist/host/secrets/trustedOAuthInfraEnvironment.js

@@ -5,6 +5,10 @@ class TrustedOAuthSecretStoreUnavailableError extends Error {
         this.name = 'TrustedOAuthSecretStoreUnavailableError';
     }
 }
+/***
+ * @todo Keep the deferred Secret-store handling in the Secrets/Infra application boundary; it represents Studio OAuth rollout policy rather than a generic error wrapper.
+ * Resolve trusted OAuth environment variables for Infra Up while turning secret-store unavailability into an explicit deferred result.
+ */
 export async function resolveTrustedOAuthInfraEnvironmentForUp(args) {
     try {
         return {
@@ -23,6 +27,10 @@ export async function resolveTrustedOAuthInfraEnvironmentForUp(args) {
         throw error;
     }
 }
+/***
+ * @todo Keep OAuth-provider credential resolution and GoTrue environment assembly in the Secrets/Auth boundary.
+ * Resolve enabled OAuth provider credentials into the trusted GoTrue environment expected by generated Infra.
+ */
 export async function resolveTrustedOAuthInfraEnvironment(args) {
     const manifest = await readCurrentManifest(args.projectId, args.projectManager);
     const providers = manifest.infra.auth?.oauth?.enabled
@@ -66,6 +74,10 @@ export async function resolveTrustedOAuthInfraEnvironment(args) {
     }
     return env;
 }
+/***
+ * @todo This retry belongs to the project-manifest read policy; reassess whether a second identical read remains intentional during the Projects/Secrets migration.
+ * Read the current project manifest, retrying the same owner once when the first read rejects.
+ */
 async function readCurrentManifest(projectId, projectManager) {
     try {
         return await projectManager.getProjectManifest(projectId);

package/dist/host/secrets/trustedOAuthInfraEnvironment.js.map

@@ -1 +1 @@
-{"version":3,"file":"trustedOAuthInfraEnvironment.js","sourceRoot":"","sources":["../../../src/host/secrets/trustedOAuthInfraEnvironment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trustedOAuthInfraEnvironment.js","sourceRoot":"","sources":["../../../src/host/secrets/trustedOAuthInfraEnvironment.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAoB9D,MAAM,uCAAwC,SAAQ,KAAK;IACzD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yCAAyC,CAAC;IACxD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wCAAwC,CAAC,IAK9D;IACC,IAAI,CAAC;QACH,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,GAAG,EAAE,MAAM,mCAAmC,CAAC,IAAI,CAAC;SACrD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,uCAAuC,EAAE,CAAC;YAC7D,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,GAAG,EAAE,EAAE;gBACP,MAAM,EAAE,KAAK,CAAC,OAAO;aACtB,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mCAAmC,CAAC,IAKzD;IACC,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAChF,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO;QACnD,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC;QACtF,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,cAAc,GAClB,IAAI,CAAC,cAAc;QACnB,IAAI,oBAAoB,CAAC;YACvB,cAAc,EAAE,IAAI,CAAC,cAAgC;YACrD,aAAa,EAAE,IAAI,CAAC,aAAa;SAClC,CAAC,CAAC;IACL,MAAM,GAAG,GAAuC,EAAE,CAAC;IAEnD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,EAAE,sCAAsC,CAAC,CAAC;QAChG,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC;YAC1C,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE,QAAQ,CAAC,cAAc;SAC7B,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACxC,MAAM,IAAI,uCAAuC,CAC/C,2DAA2D,QAAQ,CAAC,EAAE,SAAS,QAAQ,CAAC,cAAc,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CACnI,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,KAAK,CACb,6DAA6D,QAAQ,CAAC,EAAE,SAAS,QAAQ,CAAC,cAAc,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CACrI,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;QAC/C,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CACb,2CAA2C,QAAQ,CAAC,EAAE,SAAS,QAAQ,CAAC,cAAc,kDAAkD,CACzI,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,EAAE;aAC1B,WAAW,EAAE;aACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;aAC5B,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC5B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,CAAC,EAAE,8CAA8C,CAAC,CAAC;QAChG,CAAC;QAED,GAAG,CAAC,mBAAmB,SAAS,YAAY,CAAC,GAAG,QAAQ,CAAC;QACzD,GAAG,CAAC,mBAAmB,SAAS,SAAS,CAAC,GAAG,YAAY,CAAC;IAC5D,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,mBAAmB,CAChC,SAAiB,EACjB,cAA0D;IAE1D,IAAI,CAAC;QACH,OAAO,MAAM,cAAc,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,cAAc,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/host/templates/index.d.ts

@@ -5,8 +5,14 @@ export interface ProjectTemplateSelection {
     readonly category: AppCategory;
     readonly slug: string;
 }
-/*** List the published standalone templates grouped by their existing category metadata. */
+/***
+ * List the published standalone templates grouped by their existing category metadata.
+ * @todo Move Studio template catalog projection from host/templates to the top-level templates domain; host should only expose it through adapters.
+ */
 export declare function getTemplateCatalog(): TemplateCatalog;
-/*** Resolve one published portable template to the source-agnostic input used by project creation. */
+/***
+ * Resolve one published portable template to the source-agnostic input used by project creation.
+ * @todo Move portable-template source resolution beside the templates/projects application boundary rather than owning it under host.
+ */
 export declare function getProjectTemplateSource(selection: ProjectTemplateSelection): Promise<ProjectCreationSource>;
 //# sourceMappingURL=index.d.ts.map

package/dist/host/templates/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/templates/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,sBAAsB,CAAC;AAQpE,OAAO,KAAK,EAAE,eAAe,EAA2B,MAAM,gCAAgC,CAAC;AAC/F,OAAO,KAAK,EAEV,qBAAqB,EACtB,MAAM,uCAAuC,CAAC;AAE/C,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAKD,4FAA4F;AAC5F,wBAAgB,kBAAkB,IAAI,eAAe,CAoBpD;AAED,sGAAsG;AACtG,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,wBAAwB,GAClC,OAAO,CAAC,qBAAqB,CAAC,CAUhC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/templates/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,sBAAsB,CAAC;AAQpE,OAAO,KAAK,EAAE,eAAe,EAA2B,MAAM,gCAAgC,CAAC;AAC/F,OAAO,KAAK,EAEV,qBAAqB,EACtB,MAAM,uCAAuC,CAAC;AAE/C,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAKD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAoBpD;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,wBAAwB,GAClC,OAAO,CAAC,qBAAqB,CAAC,CAUhC"}

package/dist/host/templates/index.js

@@ -4,7 +4,10 @@ import { dirname, join } from 'node:path';
 import { CATEGORY_PRESETS, createTemplateArtifact, listTemplates, } from '@ankhorage/templates';
 const require = createRequire(import.meta.url);
 const TEMPLATES_PACKAGE_ROOT = dirname(require.resolve('@ankhorage/templates/package.json'));
-/*** List the published standalone templates grouped by their existing category metadata. */
+/***
+ * List the published standalone templates grouped by their existing category metadata.
+ * @todo Move Studio template catalog projection from host/templates to the top-level templates domain; host should only expose it through adapters.
+ */
 export function getTemplateCatalog() {
     const templates = listTemplates();
     return {
@@ -26,7 +29,10 @@ export function getTemplateCatalog() {
         }),
     };
 }
-/*** Resolve one published portable template to the source-agnostic input used by project creation. */
+/***
+ * Resolve one published portable template to the source-agnostic input used by project creation.
+ * @todo Move portable-template source resolution beside the templates/projects application boundary rather than owning it under host.
+ */
 export async function getProjectTemplateSource(selection) {
     const artifact = createTemplateArtifact(selection);
     return {

package/dist/host/templates/index.js.map

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

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

@@ -1,4 +1,12 @@
 import type { ScreenRequirements, UiNode } from '@ankhorage/contracts';
+/***
+ * Infer screen permission/capability requirements by walking authored UiNodes and collecting requirements declared by ZORA component metadata.
+ * @todo Move this requirements-domain behavior out of generic `host/utils`; it depends directly on shared ScreenRequirements contracts and ZORA metadata and should live with the owning generation/requirements capability.
+ */
 export declare function inferScreenRequirementsFromUi(root: UiNode): ScreenRequirements | undefined;
+/***
+ * Merge inferred and explicit ScreenRequirements by semantic key, with explicit declarations overriding inferred ones.
+ * @todo This is reusable requirements-domain behavior, but the correct owner is the ScreenRequirements/contracts capability rather than generic Utility.
+ */
 export declare function mergeScreenRequirements(explicit?: ScreenRequirements, inferred?: ScreenRequirements): ScreenRequirements | undefined;
 //# sourceMappingURL=requirementsInference.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"requirementsInference.d.ts","sourceRoot":"","sources":["../../../src/host/utils/requirementsInference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,kBAAkB,EAClB,MAAM,EACP,MAAM,sBAAsB,CAAC;AAG9B,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CA+B1F;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,CAAC,EAAE,kBAAkB,EAC7B,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,kBAAkB,GAAG,SAAS,CAyBhC"}
+{"version":3,"file":"requirementsInference.d.ts","sourceRoot":"","sources":["../../../src/host/utils/requirementsInference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,kBAAkB,EAClB,MAAM,EACP,MAAM,sBAAsB,CAAC;AAG9B;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAgC1F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,CAAC,EAAE,kBAAkB,EAC7B,QAAQ,CAAC,EAAE,kBAAkB,GAC5B,kBAAkB,GAAG,SAAS,CAyBhC"}

package/dist/host/utils/requirementsInference.js

@@ -1,7 +1,12 @@
 import { ZORA_COMPONENT_META } from '@ankhorage/zora/metadata';
+/***
+ * Infer screen permission/capability requirements by walking authored UiNodes and collecting requirements declared by ZORA component metadata.
+ * @todo Move this requirements-domain behavior out of generic `host/utils`; it depends directly on shared ScreenRequirements contracts and ZORA metadata and should live with the owning generation/requirements capability.
+ */
 export function inferScreenRequirementsFromUi(root) {
     const permissions = new Map();
     const capabilities = new Map();
+    /*** Visit one UiNode subtree and collect metadata-declared permissions/capabilities by semantic key. */
     function walk(node) {
         const meta = ZORA_COMPONENT_META[node.type];
         if (meta?.requirements) {
@@ -25,6 +30,10 @@ export function inferScreenRequirementsFromUi(root) {
         capabilities: capabilities.size > 0 ? Array.from(capabilities.values()) : undefined,
     };
 }
+/***
+ * Merge inferred and explicit ScreenRequirements by semantic key, with explicit declarations overriding inferred ones.
+ * @todo This is reusable requirements-domain behavior, but the correct owner is the ScreenRequirements/contracts capability rather than generic Utility.
+ */
 export function mergeScreenRequirements(explicit, inferred) {
     if (!explicit && !inferred) {
         return undefined;

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

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

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

@@ -3,5 +3,9 @@ export interface TrimmedOutput {
     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 +1 @@
-{"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,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAkC9E"}
+{"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,32 +1,9 @@
+/***
+ * 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) {
-    if (maxChars <= 0) {
-        return {
-            text: '',
-            truncated: text.length > 0,
-            originalLength: text.length,
-        };
-    }
-    if (text.length <= maxChars) {
-        return {
-            text,
-            truncated: false,
-            originalLength: text.length,
-        };
-    }
-    const omitted = text.length - maxChars;
-    const marker = `\n...[truncated ${omitted} chars]`;
-    if (marker.length >= maxChars) {
-        return {
-            text: marker.slice(0, maxChars),
-            truncated: true,
-            originalLength: text.length,
-        };
-    }
-    const keep = maxChars - marker.length;
-    return {
-        text: `${text.slice(0, keep)}${marker}`,
-        truncated: true,
-        originalLength: text.length,
-    };
+    return trimOutput(text, maxChars);
 }
+import { trimOutput } from '@ankhorage/utility/string';
 //# sourceMappingURL=trimOutput.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"trimOutput.js","sourceRoot":"","sources":["../../../src/host/utils/trimOutput.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAgB;IAC7D,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,OAAO;YACL,IAAI,EAAE,EAAE;YACR,SAAS,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC;YAC1B,cAAc,EAAE,IAAI,CAAC,MAAM;SAC5B,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO;YACL,IAAI;YACJ,SAAS,EAAE,KAAK;YAChB,cAAc,EAAE,IAAI,CAAC,MAAM;SAC5B,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IACvC,MAAM,MAAM,GAAG,mBAAmB,OAAO,SAAS,CAAC;IAEnD,IAAI,MAAM,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;YAC/B,SAAS,EAAE,IAAI;YACf,cAAc,EAAE,IAAI,CAAC,MAAM;SAC5B,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IACtC,OAAO;QACL,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,MAAM,EAAE;QACvC,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,IAAI,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC"}
+{"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"}

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

@@ -1,2 +1,6 @@
+/***
+ * Resolve the first matching workspace root from a preferred directory and cwd, failing with a descriptive message when none is found.
+ * @utility @ankhorage/utility/node/workspace
+ */
 export declare function resolveWorkspaceRoot(fromDir: string, cwd?: string): string;
 //# sourceMappingURL=workspaceRoot.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"workspaceRoot.d.ts","sourceRoot":"","sources":["../../../src/host/utils/workspaceRoot.ts"],"names":[],"mappings":"AAKA,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAgB,UASxE"}
+{"version":3,"file":"workspaceRoot.d.ts","sourceRoot":"","sources":["../../../src/host/utils/workspaceRoot.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAgB,UASxE"}

package/dist/host/utils/workspaceRoot.js

@@ -1,6 +1,10 @@
 import { existsSync, readFileSync } from 'node:fs';
 import path from 'node:path';
 const STUDIO_PACKAGE_NAME = '@ankhorage/studio';
+/***
+ * Resolve the first matching workspace root from a preferred directory and cwd, failing with a descriptive message when none is found.
+ * @utility @ankhorage/utility/node/workspace
+ */
 export function resolveWorkspaceRoot(fromDir, cwd = process.cwd()) {
     const candidates = [fromDir, cwd];
     for (const candidate of candidates) {
@@ -10,6 +14,10 @@ export function resolveWorkspaceRoot(fromDir, cwd = process.cwd()) {
     }
     throw new Error(`Could not resolve an ${STUDIO_PACKAGE_NAME} workspace from ${path.resolve(fromDir)} or ${path.resolve(cwd)}.`);
 }
+/***
+ * Walk parent directories until a package root satisfies package-name and required-path markers, tolerating invalid intermediate package.json files.
+ * @utility @ankhorage/utility/node/workspace
+ */
 function findStudioWorkspaceRoot(startPath) {
     let current = path.resolve(startPath);
     for (;;) {

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

@@ -1 +1 @@
-{"version":3,"file":"workspaceRoot.js","sourceRoot":"","sources":["../../../src/host/utils/workspaceRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEhD,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACvE,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAClC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,QAAQ,CAAC;IACzC,CAAC;IACD,MAAM,IAAI,KAAK,CACb,wBAAwB,mBAAmB,mBAAmB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAC/G,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,SAAiB;IAChD,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtC,SAAS,CAAC;QACR,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC3D,IAAI,UAAU,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC1E,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAuB,CAAC;gBAC5F,IAAI,WAAW,CAAC,IAAI,KAAK,mBAAmB;oBAAE,OAAO,OAAO,CAAC;YAC/D,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;YACnE,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"workspaceRoot.js","sourceRoot":"","sources":["../../../src/host/utils/workspaceRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACvE,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAClC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,QAAQ,CAAC;IACzC,CAAC;IACD,MAAM,IAAI,KAAK,CACb,wBAAwB,mBAAmB,mBAAmB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAC/G,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAAC,SAAiB;IAChD,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtC,SAAS,CAAC;QACR,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC3D,IAAI,UAAU,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC1E,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAuB,CAAC;gBAC5F,IAAI,WAAW,CAAC,IAAI,KAAK,mBAAmB;oBAAE,OAAO,OAAO,CAAC;YAC/D,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;YACnE,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QACpC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/host/zoraExtensions/index.d.ts

@@ -5,9 +5,21 @@ export interface ZoraExtensionDefinition {
     dependencies?: Record<string, string>;
     interactionPolicySupportedComponents?: readonly string[];
 }
-/*** Resolve extension packages from the component types actually used by one manifest. */
+/***
+ * Resolve extension packages from the component types actually used by one manifest.
+ * @todo Move ZORA extension discovery from the host edge to project-generation/module ownership; host should consume the resolved extension plan.
+ */
 export declare function resolveZoraExtensionsForManifest(manifest: AppManifest): readonly ZoraExtensionDefinition[];
+/***
+ * Resolve known ZORA extensions from a package dependency record.
+ * @todo Keep dependency-to-extension projection with the same project-generation/module owner as manifest extension discovery.
+ */
 export declare function resolveZoraExtensionsFromDependencies(dependencies: Readonly<Record<string, string>>): readonly ZoraExtensionDefinition[];
+/*** Merge extension lists by package ownership, with later definitions replacing earlier definitions for the same package. */
 export declare function mergeZoraExtensions(...extensionLists: readonly (readonly ZoraExtensionDefinition[])[]): readonly ZoraExtensionDefinition[];
+/***
+ * Project dependency requirements from selected ZORA extension definitions.
+ * @todo Replace extension dependency ranges such as `latest` with canonical owned release ranges; generated projects must not bypass reproducible dependency ownership.
+ */
 export declare function collectZoraExtensionDependencies(extensions: readonly ZoraExtensionDefinition[]): Record<string, string>;
 //# sourceMappingURL=index.d.ts.map

package/dist/host/zoraExtensions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/zoraExtensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAU,MAAM,sBAAsB,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,oCAAoC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1D;AA4BD,0FAA0F;AAC1F,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,WAAW,GACpB,SAAS,uBAAuB,EAAE,CAQpC;AAED,wBAAgB,qCAAqC,CACnD,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC7C,SAAS,uBAAuB,EAAE,CAEpC;AAED,wBAAgB,mBAAmB,CACjC,GAAG,cAAc,EAAE,SAAS,CAAC,SAAS,uBAAuB,EAAE,CAAC,EAAE,GACjE,SAAS,uBAAuB,EAAE,CAUpC;AAED,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,SAAS,uBAAuB,EAAE,GAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/zoraExtensions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAU,MAAM,sBAAsB,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,oCAAoC,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1D;AA4BD;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,WAAW,GACpB,SAAS,uBAAuB,EAAE,CAQpC;AAED;;;GAGG;AACH,wBAAgB,qCAAqC,CACnD,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC7C,SAAS,uBAAuB,EAAE,CAEpC;AAED,8HAA8H;AAC9H,wBAAgB,mBAAmB,CACjC,GAAG,cAAc,EAAE,SAAS,CAAC,SAAS,uBAAuB,EAAE,CAAC,EAAE,GACjE,SAAS,uBAAuB,EAAE,CAUpC;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,SAAS,uBAAuB,EAAE,GAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB"}

package/dist/host/zoraExtensions/index.js

@@ -21,7 +21,10 @@ const ZORA_TABLETOP_EXTENSION = {
     },
 };
 const KNOWN_ZORA_EXTENSIONS = [ZORA_CHESS_EXTENSION, ZORA_TABLETOP_EXTENSION];
-/*** Resolve extension packages from the component types actually used by one manifest. */
+/***
+ * Resolve extension packages from the component types actually used by one manifest.
+ * @todo Move ZORA extension discovery from the host edge to project-generation/module ownership; host should consume the resolved extension plan.
+ */
 export function resolveZoraExtensionsForManifest(manifest) {
     const componentTypes = new Set();
     for (const screen of Object.values(manifest.screens)) {
@@ -29,9 +32,14 @@ export function resolveZoraExtensionsForManifest(manifest) {
     }
     return KNOWN_ZORA_EXTENSIONS.filter((extension) => Object.keys(extension.components).some((componentType) => componentTypes.has(componentType)));
 }
+/***
+ * Resolve known ZORA extensions from a package dependency record.
+ * @todo Keep dependency-to-extension projection with the same project-generation/module owner as manifest extension discovery.
+ */
 export function resolveZoraExtensionsFromDependencies(dependencies) {
     return KNOWN_ZORA_EXTENSIONS.filter((extension) => extension.packageName in dependencies);
 }
+/*** Merge extension lists by package ownership, with later definitions replacing earlier definitions for the same package. */
 export function mergeZoraExtensions(...extensionLists) {
     const extensions = new Map();
     for (const extensionList of extensionLists) {
@@ -41,6 +49,10 @@ export function mergeZoraExtensions(...extensionLists) {
     }
     return [...extensions.values()];
 }
+/***
+ * Project dependency requirements from selected ZORA extension definitions.
+ * @todo Replace extension dependency ranges such as `latest` with canonical owned release ranges; generated projects must not bypass reproducible dependency ownership.
+ */
 export function collectZoraExtensionDependencies(extensions) {
     return extensions.reduce((dependencies, extension) => {
         return {

package/dist/host/zoraExtensions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/host/zoraExtensions/index.ts"],"names":[],"mappings":"AASA,MAAM,oBAAoB,GAAG;IAC3B,WAAW,EAAE,uBAAuB;IACpC,UAAU,EAAE;QACV,UAAU,EAAE,YAAY;QACxB,WAAW,EAAE,aAAa;KAC3B;IACD,YAAY,EAAE;QACZ,uBAAuB,EAAE,QAAQ;KAClC;CACgC,CAAC;AAEpC,MAAM,uBAAuB,GAAG;IAC9B,WAAW,EAAE,0BAA0B;IACvC,UAAU,EAAE;QACV,aAAa,EAAE,eAAe;QAC9B,KAAK,EAAE,eAAe;QACtB,qBAAqB,EAAE,eAAe;QACtC,gCAAgC,EAAE,eAAe;KAClD;IACD,YAAY,EAAE;QACZ,0BAA0B,EAAE,QAAQ;KACrC;CACgC,CAAC;AAEpC,MAAM,qBAAqB,GAAG,CAAC,oBAAoB,EAAE,uBAAuB,CAAU,CAAC;AAEvF,0FAA0F;AAC1F,MAAM,UAAU,gCAAgC,CAC9C,QAAqB;IAErB,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAChD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAC7F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,YAA8C;IAE9C,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,IAAI,YAAY,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,GAAG,cAA+D;IAElE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAmC,CAAC;IAE9D,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;QAC3C,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;YACtC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,UAA8C;IAE9C,OAAO,UAAU,CAAC,MAAM,CAAyB,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE;QAC3E,OAAO;YACL,GAAG,YAAY;YACf,GAAG,CAAC,SAAS,CAAC,YAAY,IAAI,EAAE,CAAC;SAClC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC;AAED,sEAAsE;AACtE,SAAS,gBAAgB,CAAC,IAAY,EAAE,cAA2B;IACjE,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;IAC3E,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;AAClF,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/host/zoraExtensions/index.ts"],"names":[],"mappings":"AASA,MAAM,oBAAoB,GAAG;IAC3B,WAAW,EAAE,uBAAuB;IACpC,UAAU,EAAE;QACV,UAAU,EAAE,YAAY;QACxB,WAAW,EAAE,aAAa;KAC3B;IACD,YAAY,EAAE;QACZ,uBAAuB,EAAE,QAAQ;KAClC;CACgC,CAAC;AAEpC,MAAM,uBAAuB,GAAG;IAC9B,WAAW,EAAE,0BAA0B;IACvC,UAAU,EAAE;QACV,aAAa,EAAE,eAAe;QAC9B,KAAK,EAAE,eAAe;QACtB,qBAAqB,EAAE,eAAe;QACtC,gCAAgC,EAAE,eAAe;KAClD;IACD,YAAY,EAAE;QACZ,0BAA0B,EAAE,QAAQ;KACrC;CACgC,CAAC;AAEpC,MAAM,qBAAqB,GAAG,CAAC,oBAAoB,EAAE,uBAAuB,CAAU,CAAC;AAEvF;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,QAAqB;IAErB,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAChD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAC7F,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qCAAqC,CACnD,YAA8C;IAE9C,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,IAAI,YAAY,CAAC,CAAC;AAC5F,CAAC;AAED,8HAA8H;AAC9H,MAAM,UAAU,mBAAmB,CACjC,GAAG,cAA+D;IAElE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAmC,CAAC;IAE9D,KAAK,MAAM,aAAa,IAAI,cAAc,EAAE,CAAC;QAC3C,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;YACtC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gCAAgC,CAC9C,UAA8C;IAE9C,OAAO,UAAU,CAAC,MAAM,CAAyB,CAAC,YAAY,EAAE,SAAS,EAAE,EAAE;QAC3E,OAAO;YACL,GAAG,YAAY;YACf,GAAG,CAAC,SAAS,CAAC,YAAY,IAAI,EAAE,CAAC;SAClC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;AACT,CAAC;AAED,sEAAsE;AACtE,SAAS,gBAAgB,CAAC,IAAY,EAAE,cAA2B;IACjE,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;IAC3E,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC;AAClF,CAAC"}