@software-dlc/cli 0.157.2

package/dist/local/document-embeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-embeds.d.ts","sourceRoot":"","sources":["../../src/local/document-embeds.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,aAAa,EACd,MAAM,2BAA2B,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,GACnB,uBAAuB,EAAE,CA4B3B;AAED,6EAA6E;AAC7E,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,UAAU,EAAE,aAAa,CAAC;IAC1B,KAAK,EAAE,aAAa,CAAC;CACtB,GAAG,uBAAuB,EAAE,CAO5B"}

package/dist/local/document-embeds.js

@@ -0,0 +1,38 @@
+import { listDocumentBlocks } from '@software-dlc/graph/computation';
+export function danglingDocumentEmbeds(graph) {
+    const present = {
+        node: new Set(graph.nodes.map((node) => node.id)),
+        edge: new Set(graph.edges.map((edge) => edge.id)),
+        path: new Set((graph.paths ?? []).map((path) => path.id))
+    };
+    const issues = [];
+    for (const node of graph.nodes) {
+        if (node.type !== 'document')
+            continue;
+        const composition = node.data?.data?.document?.composition;
+        if (!composition)
+            continue;
+        for (const block of listDocumentBlocks(composition)) {
+            if (block.kind !== 'embed' || block.embed.type !== 'graph_entity')
+                continue;
+            const { entity_kind, entity_id } = block.embed;
+            if (present[entity_kind].has(entity_id))
+                continue;
+            issues.push({
+                code: 'DOCUMENT_EMBED_TARGET_MISSING',
+                node_id: node.id,
+                block_id: block.id,
+                entity_kind,
+                entity_id
+            });
+        }
+    }
+    return issues;
+}
+/** The dangling embeds in `graph` that `base_graph` did not already have. */
+export function introducedDanglingDocumentEmbeds(input) {
+    const key = (issue) => `${issue.node_id}\u0000${issue.block_id}\u0000${issue.entity_kind}\u0000${issue.entity_id}`;
+    const before = new Set(danglingDocumentEmbeds(input.base_graph).map(key));
+    return danglingDocumentEmbeds(input.graph).filter((issue) => !before.has(key(issue)));
+}
+//# sourceMappingURL=document-embeds.js.map

package/dist/local/document-embeds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-embeds.js","sourceRoot":"","sources":["../../src/local/document-embeds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAoBrE,MAAM,UAAU,sBAAsB,CACpC,KAAoB;IAEpB,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjD,IAAI,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjD,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;KAC1D,CAAC;IACF,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;YAAE,SAAS;QACvC,MAAM,WAAW,GACf,IAAI,CAAC,IAAI,EAAE,IACZ,EAAE,QAAQ,EAAE,WAAW,CAAC;QACzB,IAAI,CAAC,WAAW;YAAE,SAAS;QAC3B,KAAK,MAAM,KAAK,IAAI,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;YACpD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc;gBAC/D,SAAS;YACX,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;YAC/C,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,SAAS;YAClD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,+BAA+B;gBACrC,OAAO,EAAE,IAAI,CAAC,EAAE;gBAChB,QAAQ,EAAE,KAAK,CAAC,EAAE;gBAClB,WAAW;gBACX,SAAS;aACV,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gCAAgC,CAAC,KAGhD;IACC,MAAM,GAAG,GAAG,CAAC,KAA8B,EAAE,EAAE,CAC7C,GAAG,KAAK,CAAC,OAAO,SAAS,KAAK,CAAC,QAAQ,SAAS,KAAK,CAAC,WAAW,SAAS,KAAK,CAAC,SAAS,EAAE,CAAC;IAC9F,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,sBAAsB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,OAAO,sBAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAC/C,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CACnC,CAAC;AACJ,CAAC"}

package/dist/local/environment-context.d.ts

@@ -0,0 +1,39 @@
+import type { GraphClientOptions } from '@software-dlc/graph/client';
+import { type SdlcRepositoryConfig } from './config.js';
+import { type EnvironmentMetadata, type TrustedConnection } from './environment-sidecar.js';
+import type { GitWorktreeContext } from './git.js';
+import { type LocalStateDirectoryResolution } from './state-directory.js';
+export type ActiveEnvironmentContext = {
+    profile: string;
+    sidecar_dir: string;
+    config: SdlcRepositoryConfig;
+    metadata: EnvironmentMetadata | null;
+    connection: TrustedConnection | null;
+    state: LocalStateDirectoryResolution;
+    legacy_migration_required: boolean;
+};
+export declare function resolveActiveEnvironmentContext(input: {
+    git: GitWorktreeContext;
+    state_override?: string;
+    registry_path?: string;
+    env?: Readonly<Record<string, string | undefined>>;
+}): Promise<ActiveEnvironmentContext>;
+export declare function resolveEnvironmentClient(input: {
+    context: ActiveEnvironmentContext;
+    env?: Readonly<Record<string, string | undefined>>;
+    fetch_impl?: typeof fetch;
+}): GraphClientOptions;
+export declare function initializeEnvironmentProfile(input: {
+    git: GitWorktreeContext;
+    profile: string;
+    repository_id: string;
+    connection: TrustedConnection;
+}): Promise<{
+    profile: string;
+    sidecar_dir: string;
+    config_path: string;
+    metadata: EnvironmentMetadata;
+    active: boolean;
+    excluded: string[];
+}>;
+//# sourceMappingURL=environment-context.d.ts.map

package/dist/local/environment-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-context.d.ts","sourceRoot":"","sources":["../../src/local/environment-context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAUL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACrC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrC,KAAK,EAAE,6BAA6B,CAAC;IACrC,yBAAyB,EAAE,OAAO,CAAC;CACpC,CAAC;AAgCF,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,GAAG,EAAE,kBAAkB,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CACpD,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAwFpC;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,OAAO,EAAE,wBAAwB,CAAC;IAClC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACnD,UAAU,CAAC,EAAE,OAAO,KAAK,CAAC;CAC3B,GAAG,kBAAkB,CA+CrB;AAED,wBAAsB,4BAA4B,CAAC,KAAK,EAAE;IACxD,GAAG,EAAE,kBAAkB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,iBAAiB,CAAC;CAC/B,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC,CAgED"}

package/dist/local/environment-context.js

@@ -0,0 +1,193 @@
+import { setOperationPhase, currentOperation } from './operation.js';
+import { access } from 'node:fs/promises';
+import { getRepositoryConfigPath, readRepositoryConfig, writeRepositoryConfig } from './config.js';
+import { assertSidecarDirectory, environmentSidecarDirectory, getTrustedConnection, readActiveEnvironmentSelector, readEnvironmentMetadata, resolveTrustedConnectionCredential, serviceOriginFingerprint, writeActiveEnvironmentSelector, writeEnvironmentMetadata } from './environment-sidecar.js';
+import { excludeEnvironmentPaths } from './environment-exclude.js';
+import { prepareLocalStateDirectory } from './state-directory.js';
+function errorCode(error) {
+    return typeof error === 'object' && error !== null && 'code' in error
+        ? String(error.code)
+        : null;
+}
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch (error) {
+        if (errorCode(error) === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+function assertStateOverrideProfile(input) {
+    if (!input.state_override)
+        return;
+    const selected_profile = (input.env ?? process.env).SDLC_STATE_PROFILE;
+    if (selected_profile !== input.profile) {
+        throw new Error(`SDLC_STATE_DIR requires SDLC_STATE_PROFILE=${input.profile} so an external state directory cannot be reused across profiles implicitly.`);
+    }
+}
+export async function resolveActiveEnvironmentContext(input) {
+    const selector = await readActiveEnvironmentSelector(input.git.repository_root);
+    let profile = selector?.profile ?? 'live';
+    let sidecar_dir = environmentSidecarDirectory({
+        repository_root: input.git.repository_root,
+        profile
+    });
+    let legacy_migration_required = false;
+    if (!selector) {
+        const legacy_config_path = `${sidecar_dir}/config.json`;
+        const legacy_metadata_path = `${sidecar_dir}/state/environment.json`;
+        if ((await pathExists(legacy_config_path)) &&
+            !(await pathExists(legacy_metadata_path))) {
+            profile = 'local';
+            sidecar_dir = environmentSidecarDirectory({
+                repository_root: input.git.repository_root,
+                profile: 'live'
+            });
+            legacy_migration_required = true;
+        }
+    }
+    await assertSidecarDirectory(sidecar_dir);
+    // A repository set up with `sdlc workspace init` alone has local graph
+    // state and no hosted environment; say so rather than failing on the file.
+    const config_path = getRepositoryConfigPath(input.git.repository_root, sidecar_dir);
+    if (!(await pathExists(config_path))) {
+        throw new Error(`This repository has no hosted SDLC environment (${config_path} does not exist). ` +
+            'Hosted commands need one: sdlc init --connection <name> --repository-id <uuid>. ' +
+            'In a local-only workspace, sdlc workspace commit validates the projection and sdlc workspace status shows it.');
+    }
+    const config = await readRepositoryConfig(input.git.repository_root, sidecar_dir);
+    const metadata = legacy_migration_required
+        ? null
+        : await readEnvironmentMetadata(sidecar_dir);
+    const connection = metadata
+        ? await getTrustedConnection({
+            name_or_id: metadata.connection_id,
+            registry_path: input.registry_path
+        })
+        : null;
+    if (metadata &&
+        connection &&
+        (metadata.profile !== profile ||
+            metadata.origin_fingerprint !== connection.origin_fingerprint ||
+            serviceOriginFingerprint(connection.base_url) !==
+                metadata.origin_fingerprint)) {
+        throw new Error('Active SDLC sidecar connection or origin fingerprint does not match its trusted connection.');
+    }
+    assertStateOverrideProfile({
+        profile,
+        state_override: input.state_override,
+        env: input.env
+    });
+    const state = await prepareLocalStateDirectory({
+        repository_root: input.git.repository_root,
+        git_dir: input.git.git_dir,
+        sidecar_dir,
+        override: input.state_override
+    });
+    return {
+        profile,
+        sidecar_dir,
+        config,
+        metadata,
+        connection,
+        state,
+        legacy_migration_required
+    };
+}
+export function resolveEnvironmentClient(input) {
+    if (input.context.legacy_migration_required || !input.context.connection) {
+        throw new Error('The legacy local .sdlc/ sidecar must be migrated before authenticated commands can run.');
+    }
+    const base_url = input.context.connection.base_url;
+    const configured_origin = new URL(base_url).origin;
+    const fetch_impl = input.fetch_impl ?? fetch;
+    const exact_origin_fetch = async (request, init) => {
+        const request_url = new URL(typeof request === 'string' || request instanceof URL
+            ? request
+            : request.url, base_url);
+        if (request_url.origin !== configured_origin) {
+            throw new Error(`Refusing SDLC request outside the trusted connection origin: ${request_url.origin}`);
+        }
+        setOperationPhase('request');
+        const operation_signal = currentOperation()?.signal;
+        const signals = [operation_signal, init?.signal].filter((signal) => Boolean(signal));
+        const response = await fetch_impl(request, {
+            ...init,
+            redirect: 'manual',
+            ...(signals.length ? { signal: AbortSignal.any(signals) } : {})
+        });
+        setOperationPhase('response');
+        if (response.status >= 300 && response.status < 400) {
+            throw new Error('SDLC API redirects are not followed for trusted connections.');
+        }
+        return response;
+    };
+    return {
+        base_url,
+        api_key: resolveTrustedConnectionCredential({
+            connection: input.context.connection,
+            env: input.env
+        }),
+        fetch_impl: exact_origin_fetch
+    };
+}
+export async function initializeEnvironmentProfile(input) {
+    const sidecar_dir = environmentSidecarDirectory({
+        repository_root: input.git.repository_root,
+        profile: input.profile
+    });
+    if (await pathExists(sidecar_dir)) {
+        await assertSidecarDirectory(sidecar_dir);
+    }
+    const excluded = await excludeEnvironmentPaths({
+        repository_root: input.git.repository_root,
+        git_common_dir: input.git.git_common_dir,
+        profile: input.profile
+    });
+    await prepareLocalStateDirectory({
+        repository_root: input.git.repository_root,
+        git_dir: input.git.git_dir,
+        sidecar_dir
+    });
+    const config_path = getRepositoryConfigPath(input.git.repository_root, sidecar_dir);
+    if (await pathExists(config_path)) {
+        const existing = await readRepositoryConfig(input.git.repository_root, sidecar_dir);
+        if (existing.repository_id !== input.repository_id) {
+            throw new Error(`Environment profile already belongs to repository ${existing.repository_id}.`);
+        }
+    }
+    else {
+        await writeRepositoryConfig({
+            repository_root: input.git.repository_root,
+            repository_id: input.repository_id,
+            sidecar_dir
+        });
+    }
+    await assertSidecarDirectory(sidecar_dir);
+    const metadata = await writeEnvironmentMetadata({
+        sidecar_dir,
+        profile: input.profile,
+        connection: input.connection
+    });
+    const selector = await readActiveEnvironmentSelector(input.git.repository_root);
+    let active = selector?.profile === input.profile;
+    if (!selector) {
+        await writeActiveEnvironmentSelector({
+            repository_root: input.git.repository_root,
+            profile: input.profile
+        });
+        active = true;
+    }
+    return {
+        profile: input.profile,
+        sidecar_dir,
+        config_path,
+        metadata,
+        active,
+        excluded
+    };
+}
+//# sourceMappingURL=environment-context.js.map

package/dist/local/environment-context.js.map

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

package/dist/local/environment-exclude.d.ts

@@ -0,0 +1,7 @@
+export declare function environmentExcludePatterns(profile: string): string[];
+export declare function excludeEnvironmentPaths(input: {
+    repository_root: string;
+    git_common_dir: string;
+    profile: string;
+}): Promise<string[]>;
+//# sourceMappingURL=environment-exclude.d.ts.map

package/dist/local/environment-exclude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-exclude.d.ts","sourceRoot":"","sources":["../../src/local/environment-exclude.ts"],"names":[],"mappings":"AAuBA,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAYpE;AA0CD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BpB"}

package/dist/local/environment-exclude.js

@@ -0,0 +1,82 @@
+import { execFile } from 'node:child_process';
+import { appendFile, mkdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+import { ACTIVE_ENVIRONMENT_SELECTOR_NAME, ENVIRONMENT_MIGRATION_JOURNAL_NAME, ENVIRONMENT_SWITCH_JOURNAL_NAME, INACTIVE_PROJECTION_DIRECTORY_NAME, LIVE_ENVIRONMENT_PROFILE, normalizeEnvironmentProfile } from './environment-sidecar.js';
+import { DEFAULT_PROJECTION_DIRECTORY_NAME } from './projection.js';
+const execFileAsync = promisify(execFile);
+const EXCLUDE_HEADER = '# SoftwareDLC local environment state (sdlc init)';
+// Root-anchored patterns for what a profile, environment switching and
+// migration write at the repository root, the managed projection included.
+// The live profile excludes only its state and cached projection under
+// .sdlc/, since older repositories track .sdlc/config.json.
+export function environmentExcludePatterns(profile) {
+    const normalized = normalizeEnvironmentProfile(profile);
+    return [
+        ...(normalized === LIVE_ENVIRONMENT_PROFILE
+            ? ['/.sdlc/state/', `/.sdlc/${INACTIVE_PROJECTION_DIRECTORY_NAME}/`]
+            : [`/.sdlc.${normalized}/`]),
+        `/${DEFAULT_PROJECTION_DIRECTORY_NAME}/`,
+        `/${ACTIVE_ENVIRONMENT_SELECTOR_NAME}`,
+        `/${ENVIRONMENT_SWITCH_JOURNAL_NAME}`,
+        `/${ENVIRONMENT_MIGRATION_JOURNAL_NAME}`,
+        '/.sdlc.transition/'
+    ];
+}
+async function isIgnored(repository_root, pattern) {
+    try {
+        await execFileAsync('git', ['check-ignore', '--quiet', '--no-index', '--', pattern.slice(1)], { cwd: repository_root });
+        return true;
+    }
+    catch (error) {
+        const exit_code = typeof error === 'object' && error !== null && 'code' in error
+            ? error.code
+            : null;
+        if (exit_code === 1)
+            return false;
+        throw error;
+    }
+}
+async function readOptional(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch (error) {
+        if (typeof error === 'object' &&
+            error !== null &&
+            'code' in error &&
+            error.code === 'ENOENT') {
+            return '';
+        }
+        throw error;
+    }
+}
+// Adds each pattern Git does not already ignore to the common directory's
+// info/exclude, which every linked worktree reads and nothing tracks.
+// Returns the patterns it added.
+export async function excludeEnvironmentPaths(input) {
+    const missing = [];
+    for (const pattern of environmentExcludePatterns(input.profile)) {
+        if (!(await isIgnored(input.repository_root, pattern))) {
+            missing.push(pattern);
+        }
+    }
+    if (missing.length === 0)
+        return [];
+    const exclude_path = join(input.git_common_dir, 'info', 'exclude');
+    const existing = await readOptional(exclude_path);
+    const existing_lines = new Set(existing.split('\n').map((line) => line.trim()));
+    // A listed pattern that still does not apply is overridden by a tracked
+    // .gitignore; adding it again would change nothing.
+    const added = missing.filter((pattern) => !existing_lines.has(pattern));
+    if (added.length === 0)
+        return [];
+    const lines = existing_lines.has(EXCLUDE_HEADER)
+        ? added
+        : [EXCLUDE_HEADER, ...added];
+    const separator = existing && !existing.endsWith('\n') ? '\n' : '';
+    await mkdir(join(input.git_common_dir, 'info'), { recursive: true });
+    await appendFile(exclude_path, `${separator}${lines.join('\n')}\n`, 'utf8');
+    return added;
+}
+//# sourceMappingURL=environment-exclude.js.map

package/dist/local/environment-exclude.js.map

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

package/dist/local/environment-sidecar.d.ts

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+export declare const LIVE_ENVIRONMENT_PROFILE = "live";
+export declare const ACTIVE_ENVIRONMENT_SELECTOR_NAME = ".sdlc.active";
+export declare const ENVIRONMENT_MIGRATION_JOURNAL_NAME = ".sdlc.migration.json";
+export declare const ENVIRONMENT_SWITCH_JOURNAL_NAME = ".sdlc.switch.json";
+export declare const INACTIVE_PROJECTION_DIRECTORY_NAME = "projection-cache";
+declare const trusted_connection_schema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    connection_id: z.ZodString;
+    name: z.ZodString;
+    base_url: z.ZodString;
+    origin_fingerprint: z.ZodString;
+    credential_env: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strict>;
+export declare const trusted_connection_registry_schema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    connections: z.ZodArray<z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        connection_id: z.ZodString;
+        name: z.ZodString;
+        base_url: z.ZodString;
+        origin_fingerprint: z.ZodString;
+        credential_env: z.ZodString;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const environment_metadata_schema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    profile: z.ZodString;
+    connection_id: z.ZodString;
+    origin_fingerprint: z.ZodString;
+}, z.core.$strict>;
+export declare const active_environment_selector_schema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    profile: z.ZodString;
+}, z.core.$strict>;
+export declare const environment_switch_journal_schema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    source_profile: z.ZodString;
+    target_profile: z.ZodString;
+    stage: z.ZodEnum<{
+        prepared: "prepared";
+        source_cached: "source_cached";
+        target_restored: "target_restored";
+        stores_relocated: "stores_relocated";
+        selector_advanced: "selector_advanced";
+    }>;
+    source_had_projection: z.ZodBoolean;
+    target_had_projection: z.ZodBoolean;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strict>;
+export type TrustedConnection = z.infer<typeof trusted_connection_schema>;
+export type EnvironmentMetadata = z.infer<typeof environment_metadata_schema>;
+export type ActiveEnvironmentSelector = z.infer<typeof active_environment_selector_schema>;
+export type EnvironmentSwitchJournal = z.infer<typeof environment_switch_journal_schema>;
+export declare function assertSidecarDirectory(path: string): Promise<void>;
+export declare function normalizeEnvironmentProfile(value: string): string;
+export declare function environmentSidecarDirectory(input: {
+    repository_root: string;
+    profile: string;
+}): string;
+export declare function inactiveProjectionDirectory(input: {
+    repository_root: string;
+    profile: string;
+}): string;
+export declare function activeEnvironmentSelectorPath(repository_root: string): string;
+export declare function environmentSwitchJournalPath(repository_root: string): string;
+export declare function normalizeServiceOrigin(value: string): string;
+export declare function serviceOriginFingerprint(base_url: string): string;
+export declare function resolveTrustedConnectionRegistryPath(input?: {
+    override?: string;
+    env?: Readonly<Record<string, string | undefined>>;
+}): string;
+export declare function listTrustedConnections(input?: {
+    registry_path?: string;
+}): Promise<TrustedConnection[]>;
+export declare function getTrustedConnection(input: {
+    name_or_id: string;
+    registry_path?: string;
+}): Promise<TrustedConnection>;
+export declare function addTrustedConnection(input: {
+    name: string;
+    base_url: string;
+    credential_env: string;
+    registry_path?: string;
+}): Promise<TrustedConnection>;
+export declare function resolveTrustedConnectionCredential(input: {
+    connection: TrustedConnection;
+    env?: Readonly<Record<string, string | undefined>>;
+}): string;
+export declare function environmentMetadataPath(sidecar_dir: string): string;
+export declare function readEnvironmentMetadata(sidecar_dir: string): Promise<EnvironmentMetadata>;
+export declare function writeEnvironmentMetadata(input: {
+    sidecar_dir: string;
+    profile: string;
+    connection: TrustedConnection;
+}): Promise<EnvironmentMetadata>;
+export declare function readActiveEnvironmentSelector(repository_root: string): Promise<ActiveEnvironmentSelector | null>;
+export declare function writeActiveEnvironmentSelector(input: {
+    repository_root: string;
+    profile: string;
+}): Promise<ActiveEnvironmentSelector>;
+export declare function listEnvironmentProfiles(repository_root: string): Promise<Array<{
+    profile: string;
+    sidecar_dir: string;
+}>>;
+export declare function migrateLegacyLocalSidecar(input: {
+    repository_root: string;
+    connection: TrustedConnection;
+}): Promise<{
+    profile: 'local';
+    sidecar_dir: string;
+    recovered: boolean;
+}>;
+export declare function readEnvironmentSwitchJournal(repository_root: string): Promise<EnvironmentSwitchJournal | null>;
+export declare function writeEnvironmentSwitchJournal(input: {
+    repository_root: string;
+    journal: EnvironmentSwitchJournal;
+}): Promise<void>;
+export declare function clearEnvironmentSwitchJournal(repository_root: string): Promise<void>;
+export {};
+//# sourceMappingURL=environment-sidecar.d.ts.map

package/dist/local/environment-sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-sidecar.d.ts","sourceRoot":"","sources":["../../src/local/environment-sidecar.ts"],"names":[],"mappings":"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"}