@codyswann/lisa 2.229.1 → 2.230.0

package/dist/cli/remote-environment-catalog.d.ts

@@ -0,0 +1,17 @@
+import type { ProjectType } from "../core/config.js";
+import type { JsonObject } from "../sync/json-path.js";
+import type { IntegrationFlags, VariableRequirement } from "./remote-environment-contract.js";
+/**
+ * Build requirements implied by the active Lisa tracker and PRD source.
+ * @param config - Merged Lisa project config
+ * @returns Active integration requirements
+ */
+export declare function configuredIntegrationRequirements(config: JsonObject): readonly VariableRequirement[];
+/**
+ * Convert active flags to names-only variable requirements.
+ * @param flags - Detected integrations
+ * @param projectTypes - Detected Lisa project types
+ * @returns Active project requirements
+ */
+export declare function requirementsForFlags(flags: IntegrationFlags, projectTypes: readonly ProjectType[]): readonly VariableRequirement[];
+//# sourceMappingURL=remote-environment-catalog.d.ts.map

package/dist/cli/remote-environment-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-environment-catalog.d.ts","sourceRoot":"","sources":["../../src/cli/remote-environment-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,kCAAkC,CAAC;AAgD1C;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,UAAU,GACjB,SAAS,mBAAmB,EAAE,CAmDhC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,EACvB,YAAY,EAAE,SAAS,WAAW,EAAE,GACnC,SAAS,mBAAmB,EAAE,CAsEhC"}

package/dist/cli/remote-environment-catalog.js

@@ -0,0 +1,175 @@
+const JIRA_SOURCE = "Lisa config: Jira tracker";
+/**
+ * Build the active Jira tracker requirements.
+ * @returns Required jira-cli variables
+ */
+function jiraRequirements() {
+    return [
+        {
+            name: "JIRA_API_TOKEN",
+            reason: "Jira API authentication for the active tracker",
+            source: JIRA_SOURCE,
+            secret: true,
+        },
+        {
+            name: "JIRA_SERVER",
+            reason: "Jira Cloud site used by jira-cli",
+            source: JIRA_SOURCE,
+            secret: false,
+        },
+        {
+            name: "JIRA_LOGIN",
+            reason: "Jira account used by jira-cli",
+            source: JIRA_SOURCE,
+            secret: false,
+        },
+        {
+            name: "JIRA_PROJECT",
+            reason: "Jira project key used by the factory",
+            source: JIRA_SOURCE,
+            secret: false,
+        },
+    ];
+}
+/**
+ * Resolve the most specific AWS detection source.
+ * @param projectTypes - Detected Lisa project types
+ * @returns Human-readable detection source
+ */
+function awsRequirementSource(projectTypes) {
+    return projectTypes.includes("cdk")
+        ? "Project type: CDK"
+        : "Integration: AWS";
+}
+/**
+ * Build requirements implied by the active Lisa tracker and PRD source.
+ * @param config - Merged Lisa project config
+ * @returns Active integration requirements
+ */
+export function configuredIntegrationRequirements(config) {
+    const tracker = typeof config.tracker === "string" ? config.tracker : "";
+    const source = typeof config.source === "string" ? config.source : "";
+    const catalog = [
+        {
+            active: tracker === "github" || source === "github",
+            requirements: [
+                {
+                    name: "GH_TOKEN",
+                    reason: "GitHub CLI access for the active tracker or PRD source",
+                    source: "Lisa config: GitHub",
+                    secret: true,
+                },
+            ],
+        },
+        { active: tracker === "jira", requirements: jiraRequirements() },
+        {
+            active: tracker === "linear" || source === "linear",
+            requirements: [
+                {
+                    name: "LINEAR_API_KEY",
+                    reason: "Headless Linear access for the active tracker or source",
+                    source: "Lisa config: Linear",
+                    secret: true,
+                },
+            ],
+        },
+        {
+            active: source === "notion",
+            requirements: [
+                {
+                    name: "NOTION_API_TOKEN",
+                    reason: "Notion integration access for the active PRD source",
+                    source: "Lisa config: Notion source",
+                    secret: true,
+                },
+            ],
+        },
+        {
+            active: source === "confluence",
+            requirements: [
+                {
+                    name: "ATLASSIAN_API_TOKEN",
+                    reason: "Confluence API access for the active PRD source",
+                    source: "Lisa config: Confluence source",
+                    secret: true,
+                },
+            ],
+        },
+    ];
+    return catalog.flatMap(entry => (entry.active ? entry.requirements : []));
+}
+/**
+ * Convert active flags to names-only variable requirements.
+ * @param flags - Detected integrations
+ * @param projectTypes - Detected Lisa project types
+ * @returns Active project requirements
+ */
+export function requirementsForFlags(flags, projectTypes) {
+    const catalog = [
+        {
+            active: flags.jam,
+            requirement: {
+                name: "JAM_PAT",
+                reason: "Jam CLI access for the detected Jam integration",
+                source: "Integration: @jam.dev",
+                secret: true,
+            },
+        },
+        {
+            active: flags.aws,
+            requirement: {
+                name: "LISA_AWS_BOOTSTRAP_JSON",
+                reason: "Renewable AWS CLI profiles for this AWS-enabled project",
+                source: awsRequirementSource(projectTypes),
+                secret: true,
+            },
+        },
+        {
+            active: flags.sonar,
+            requirement: {
+                name: "SONAR_TOKEN",
+                reason: "SonarCloud diagnostics for the configured project",
+                source: "Integration: SonarCloud",
+                secret: true,
+            },
+        },
+        {
+            active: flags.sentry,
+            requirement: {
+                name: "SENTRY_AUTH_TOKEN",
+                reason: "Sentry diagnostics and release tooling",
+                source: "Integration: Sentry",
+                secret: true,
+            },
+        },
+        {
+            active: flags.figma,
+            requirement: {
+                name: "FIGMA_ACCESS_TOKEN",
+                reason: "Figma tooling referenced by the project setup",
+                source: "Integration: Figma",
+                secret: true,
+            },
+        },
+        {
+            active: flags.eas,
+            requirement: {
+                name: "EXPO_TOKEN",
+                reason: "EAS operations for this Expo project",
+                source: "Project type: Expo with EAS",
+                secret: true,
+            },
+        },
+        {
+            active: flags.maestro,
+            requirement: {
+                name: "MAESTRO_API_KEY",
+                reason: "Maestro Cloud verification for this project",
+                source: "Integration: Maestro Cloud",
+                secret: true,
+            },
+        },
+    ];
+    return catalog.filter(entry => entry.active).map(entry => entry.requirement);
+}
+//# sourceMappingURL=remote-environment-catalog.js.map

package/dist/cli/remote-environment-catalog.js.map

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

package/dist/cli/remote-environment-contract.d.ts

@@ -0,0 +1,94 @@
+import type { Harness, ProjectType } from "../core/config.js";
+/** Project-owned extension point for remote-environment requirements. */
+export declare const REMOTE_ENVIRONMENT_MANIFEST: ".lisa/remote-environment.json";
+/** One concrete coding agent, excluding the fleet aggregate. */
+export type RemoteAgent = Exclude<Harness, "fleet">;
+/** A variable the current project requires in a remote coding environment. */
+export interface RemoteEnvironmentVariableStatus {
+    /** Environment-variable name. Values are never exposed. */
+    readonly name: string;
+    /** Why this project requires the variable. */
+    readonly reason: string;
+    /** Project signal that activated the requirement. */
+    readonly source: string;
+    /** Whether the variable contains a credential. */
+    readonly secret: boolean;
+    /** Whether the variable is visible to the `lisa ui` process. */
+    readonly set: boolean;
+}
+/** Startup artifact expected by one supported remote coding agent. */
+export interface RemoteEnvironmentStartupStatus {
+    /** Agent whose remote environment consumes the artifact. */
+    readonly agent: RemoteAgent;
+    /** Project-relative setup artifact, when one is configured. */
+    readonly artifact?: string;
+    /** Whether the configured artifact exists. */
+    readonly installed: boolean;
+}
+/** Project-aware remote-environment readiness exposed to the console. */
+export interface RemoteEnvironmentStatus {
+    /** Lisa project types detected for the current project. */
+    readonly projectTypes: readonly ProjectType[];
+    /** Required variables only; optional/dormant integrations are omitted. */
+    readonly variables: readonly RemoteEnvironmentVariableStatus[];
+    /** Startup artifact status for every supported agent. */
+    readonly startupScripts: readonly RemoteEnvironmentStartupStatus[];
+}
+/** Internal names-only variable requirement. */
+export interface VariableRequirement {
+    /** Environment-variable name. */
+    readonly name: string;
+    /** Human-readable reason the project requires it. */
+    readonly reason: string;
+    /** Project signal that activated it. */
+    readonly source: string;
+    /** Whether it contains a credential. */
+    readonly secret: boolean;
+}
+/** Active remote-tool integrations detected from the host project. */
+export interface IntegrationFlags {
+    /** AWS SDK/infrastructure/operational integration. */
+    readonly aws: boolean;
+    /** Expo Application Services integration. */
+    readonly eas: boolean;
+    /** Figma tooling integration. */
+    readonly figma: boolean;
+    /** Jam debugging integration. */
+    readonly jam: boolean;
+    /** Maestro Cloud integration. */
+    readonly maestro: boolean;
+    /** Sentry tooling integration. */
+    readonly sentry: boolean;
+    /** SonarCloud integration. */
+    readonly sonar: boolean;
+}
+/** Raw project-owned manifest shape; every field is validated before use. */
+export interface RemoteEnvironmentManifest {
+    /** Names-only variable declarations. */
+    readonly variables?: readonly {
+        readonly name?: unknown;
+        readonly reason?: unknown;
+        readonly source?: unknown;
+        readonly secret?: unknown;
+        readonly required?: unknown;
+    }[];
+    /** Per-agent project-relative startup artifacts. */
+    readonly startupScripts?: Readonly<Record<string, unknown>>;
+}
+/** Supported concrete agents in canonical order. */
+export declare const REMOTE_AGENTS: readonly RemoteAgent[];
+/** Default project artifacts recognized for each remote agent. */
+export declare const DEFAULT_STARTUP_ARTIFACTS: Readonly<Record<RemoteAgent, readonly string[]>>;
+/**
+ * Validate project-owned manifest variable declarations.
+ * @param manifest - Parsed manifest
+ * @returns Required variable declarations only
+ */
+export declare function manifestRequirements(manifest: RemoteEnvironmentManifest | null): readonly VariableRequirement[];
+/**
+ * Deduplicate requirements by variable name while preserving first-source order.
+ * @param requirements - Requirements from config, detection, and manifest
+ * @returns Deduplicated requirements
+ */
+export declare function uniqueRequirements(requirements: readonly VariableRequirement[]): readonly VariableRequirement[];
+//# sourceMappingURL=remote-environment-contract.d.ts.map

package/dist/cli/remote-environment-contract.d.ts.map

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

package/dist/cli/remote-environment-contract.js

@@ -0,0 +1,58 @@
+import { HARNESS_VALUES } from "../core/config.js";
+/** Project-owned extension point for remote-environment requirements. */
+export const REMOTE_ENVIRONMENT_MANIFEST = ".lisa/remote-environment.json";
+/** Supported concrete agents in canonical order. */
+export const REMOTE_AGENTS = HARNESS_VALUES.filter((harness) => harness !== "fleet");
+const GENERIC_STARTUP_ARTIFACT = "scripts/remote-agent-setup.sh";
+/** Default project artifacts recognized for each remote agent. */
+export const DEFAULT_STARTUP_ARTIFACTS = {
+    claude: ["scripts/claude-remote-setup.sh", GENERIC_STARTUP_ARTIFACT],
+    codex: ["scripts/codex-remote-setup.sh", GENERIC_STARTUP_ARTIFACT],
+    cursor: [
+        ".cursor/environment.json",
+        "scripts/cursor-remote-setup.sh",
+        GENERIC_STARTUP_ARTIFACT,
+    ],
+    agy: ["scripts/agy-remote-setup.sh", GENERIC_STARTUP_ARTIFACT],
+    copilot: [
+        ".github/workflows/copilot-setup-steps.yml",
+        "scripts/copilot-remote-setup.sh",
+        GENERIC_STARTUP_ARTIFACT,
+    ],
+    opencode: ["scripts/opencode-remote-setup.sh", GENERIC_STARTUP_ARTIFACT],
+};
+/**
+ * Validate project-owned manifest variable declarations.
+ * @param manifest - Parsed manifest
+ * @returns Required variable declarations only
+ */
+export function manifestRequirements(manifest) {
+    return (manifest?.variables ?? []).flatMap(entry => {
+        if (entry.required === false ||
+            typeof entry.name !== "string" ||
+            !/^[A-Z][A-Z0-9_]*$/u.test(entry.name)) {
+            return [];
+        }
+        return [
+            {
+                name: entry.name,
+                reason: typeof entry.reason === "string"
+                    ? entry.reason
+                    : "Required by the project remote-environment manifest",
+                source: typeof entry.source === "string"
+                    ? entry.source
+                    : REMOTE_ENVIRONMENT_MANIFEST,
+                secret: entry.secret !== false,
+            },
+        ];
+    });
+}
+/**
+ * Deduplicate requirements by variable name while preserving first-source order.
+ * @param requirements - Requirements from config, detection, and manifest
+ * @returns Deduplicated requirements
+ */
+export function uniqueRequirements(requirements) {
+    return requirements.filter((requirement, index) => requirements.findIndex(candidate => candidate.name === requirement.name) === index);
+}
+//# sourceMappingURL=remote-environment-contract.js.map

package/dist/cli/remote-environment-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-environment-contract.js","sourceRoot":"","sources":["../../src/cli/remote-environment-contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,yEAAyE;AACzE,MAAM,CAAC,MAAM,2BAA2B,GACtC,+BAAwC,CAAC;AAmF3C,oDAAoD;AACpD,MAAM,CAAC,MAAM,aAAa,GAA2B,cAAc,CAAC,MAAM,CACxE,CAAC,OAAO,EAA0B,EAAE,CAAC,OAAO,KAAK,OAAO,CACzD,CAAC;AAEF,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AAEjE,kEAAkE;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAElC;IACF,MAAM,EAAE,CAAC,gCAAgC,EAAE,wBAAwB,CAAC;IACpE,KAAK,EAAE,CAAC,+BAA+B,EAAE,wBAAwB,CAAC;IAClE,MAAM,EAAE;QACN,0BAA0B;QAC1B,gCAAgC;QAChC,wBAAwB;KACzB;IACD,GAAG,EAAE,CAAC,6BAA6B,EAAE,wBAAwB,CAAC;IAC9D,OAAO,EAAE;QACP,2CAA2C;QAC3C,iCAAiC;QACjC,wBAAwB;KACzB;IACD,QAAQ,EAAE,CAAC,kCAAkC,EAAE,wBAAwB,CAAC;CACzE,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAA0C;IAE1C,OAAO,CAAC,QAAQ,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACjD,IACE,KAAK,CAAC,QAAQ,KAAK,KAAK;YACxB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAC9B,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EACtC,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO;YACL;gBACE,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EACJ,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;oBAC9B,CAAC,CAAC,KAAK,CAAC,MAAM;oBACd,CAAC,CAAC,qDAAqD;gBAC3D,MAAM,EACJ,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;oBAC9B,CAAC,CAAC,KAAK,CAAC,MAAM;oBACd,CAAC,CAAC,2BAA2B;gBACjC,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,KAAK;aAC/B;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,YAA4C;IAE5C,OAAO,YAAY,CAAC,MAAM,CACxB,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CACrB,YAAY,CAAC,SAAS,CACpB,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,CACjD,KAAK,KAAK,CACd,CAAC;AACJ,CAAC"}

package/dist/cli/remote-environment-detection.d.ts

@@ -0,0 +1,23 @@
+import type { ProjectType } from "../core/config.js";
+import type { VariableRequirement } from "./remote-environment-contract.js";
+/**
+ * Read a UTF-8 file, returning an empty string when it is absent.
+ * @param filePath - Absolute path
+ * @returns File contents or an empty string
+ */
+export declare function readTextOrEmpty(filePath: string): Promise<string>;
+/**
+ * Return whether a project-relative file exists.
+ * @param destDir - Project root
+ * @param relativePath - Project-relative path
+ * @returns True when the file can be read and is non-empty
+ */
+export declare function projectFileExists(destDir: string, relativePath: string): Promise<boolean>;
+/**
+ * Build requirements activated by detected project type and integrations.
+ * @param destDir - Project root
+ * @param projectTypes - Detected Lisa project types
+ * @returns Project-specific requirements
+ */
+export declare function detectedProjectRequirements(destDir: string, projectTypes: readonly ProjectType[]): Promise<readonly VariableRequirement[]>;
+//# sourceMappingURL=remote-environment-detection.d.ts.map

package/dist/cli/remote-environment-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-environment-detection.d.ts","sourceRoot":"","sources":["../../src/cli/remote-environment-detection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,KAAK,EAEV,mBAAmB,EACpB,MAAM,kCAAkC,CAAC;AAU1C;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWvE;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAElB;AA2GD;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,SAAS,WAAW,EAAE,GACnC,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC,CAIzC"}

package/dist/cli/remote-environment-detection.js

@@ -0,0 +1,120 @@
+import { readFile } from "node:fs/promises";
+import * as path from "node:path";
+import { readJsonOrNull } from "../utils/index.js";
+import { requirementsForFlags } from "./remote-environment-catalog.js";
+/**
+ * Read a UTF-8 file, returning an empty string when it is absent.
+ * @param filePath - Absolute path
+ * @returns File contents or an empty string
+ */
+export async function readTextOrEmpty(filePath) {
+    try {
+        return await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        const code = typeof error === "object" && error !== null && "code" in error
+            ? error.code
+            : undefined;
+        if (code === "ENOENT")
+            return "";
+        throw error;
+    }
+}
+/**
+ * Return whether a project-relative file exists.
+ * @param destDir - Project root
+ * @param relativePath - Project-relative path
+ * @returns True when the file can be read and is non-empty
+ */
+export async function projectFileExists(destDir, relativePath) {
+    return (await readTextOrEmpty(path.join(destDir, relativePath))) !== "";
+}
+/**
+ * Read dependency names and selected project-owned integration surfaces.
+ * @param destDir - Project root
+ * @returns Signals used by the requirement detectors
+ */
+async function readProjectSignals(destDir) {
+    const packageJson = await readJsonOrNull(path.join(destDir, "package.json"));
+    const dependencies = new Set([
+        ...Object.keys(packageJson?.dependencies ?? {}),
+        ...Object.keys(packageJson?.devDependencies ?? {}),
+    ]);
+    const workflows = ["ci", "deploy", "quality"].flatMap(name => [
+        `.github/workflows/${name}.yml`,
+        `.github/workflows/${name}.yaml`,
+    ]);
+    const [envExample, remoteSetup, ...workflowContents] = await Promise.all([
+        readTextOrEmpty(path.join(destDir, ".env.example")),
+        readTextOrEmpty(path.join(destDir, "scripts/claude-remote-setup.sh")),
+        ...workflows.map(relativePath => readTextOrEmpty(path.join(destDir, relativePath))),
+    ]);
+    return {
+        dependencies,
+        envExample,
+        remoteSetup,
+        workflows: workflowContents.join("\n"),
+    };
+}
+/**
+ * Test dependency presence by exact name or namespace prefix.
+ * @param dependencies - Project dependency names
+ * @param names - Exact names or prefixes ending in `/`
+ * @returns Whether any dependency matches
+ */
+function hasDependency(dependencies, names) {
+    return Array.from(dependencies).some(dependency => names.some(name => name.endsWith("/") ? dependency.startsWith(name) : dependency === name));
+}
+/**
+ * Detect active project integrations from dependencies and committed surfaces.
+ * @param destDir - Project root
+ * @param projectTypes - Detected Lisa project types
+ * @param signals - Project signals
+ * @returns Boolean integration flags
+ */
+async function detectIntegrationFlags(destDir, projectTypes, signals) {
+    const { dependencies, envExample, remoteSetup, workflows } = signals;
+    const [serverlessYml, serverlessYaml, sstTs, sstJs, sonar, eas, maestro] = await Promise.all([
+        "serverless.yml",
+        "serverless.yaml",
+        "sst.config.ts",
+        "sst.config.js",
+        "sonar-project.properties",
+        "eas.json",
+        ".maestro/config.yaml",
+    ].map(relativePath => projectFileExists(destDir, relativePath)));
+    return {
+        aws: projectTypes.includes("cdk") ||
+            hasDependency(dependencies, [
+                "@aws-sdk/",
+                "aws-cdk-lib",
+                "serverless",
+                "sst",
+            ]) ||
+            /^(AWS_PROFILE|CDK_CONTEXT_ACCOUNT|CDK_CONTEXT_ENV)=/mu.test(envExample) ||
+            [serverlessYml, serverlessYaml, sstTs, sstJs].some(Boolean),
+        eas: projectTypes.includes("expo") &&
+            (eas || workflows.includes("EXPO_TOKEN")),
+        figma: remoteSetup.includes("FIGMA_ACCESS_TOKEN"),
+        jam: hasDependency(dependencies, ["@jam.dev/"]),
+        maestro: maestro === true && workflows.includes("MAESTRO_API_KEY"),
+        sentry: hasDependency(dependencies, ["@sentry/"]) &&
+            (remoteSetup.includes("SENTRY_AUTH_TOKEN") ||
+                workflows.includes("SENTRY_AUTH_TOKEN")),
+        sonar: sonar === true &&
+            (remoteSetup.includes("SONAR_TOKEN") ||
+                workflows.includes("SONAR_TOKEN")),
+    };
+}
+/**
+ * Build requirements activated by detected project type and integrations.
+ * @param destDir - Project root
+ * @param projectTypes - Detected Lisa project types
+ * @returns Project-specific requirements
+ */
+export async function detectedProjectRequirements(destDir, projectTypes) {
+    const signals = await readProjectSignals(destDir);
+    const flags = await detectIntegrationFlags(destDir, projectTypes, signals);
+    return requirementsForFlags(flags, projectTypes);
+}
+//# sourceMappingURL=remote-environment-detection.js.map

package/dist/cli/remote-environment-detection.js.map

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

package/dist/cli/remote-environment.d.ts

@@ -0,0 +1,12 @@
+import type { JsonObject } from "../sync/json-path.js";
+import { type RemoteEnvironmentStatus } from "./remote-environment-contract.js";
+export type { RemoteEnvironmentStartupStatus, RemoteEnvironmentStatus, RemoteEnvironmentVariableStatus, } from "./remote-environment-contract.js";
+/**
+ * Inspect requirements for this particular project without exposing values.
+ * @param destDir - Project root
+ * @param config - Merged Lisa project config
+ * @param environment - Environment visible to the Lisa process
+ * @returns Project-aware variable and startup-artifact status
+ */
+export declare function inspectRemoteEnvironment(destDir: string, config: JsonObject, environment: NodeJS.ProcessEnv): Promise<RemoteEnvironmentStatus>;
+//# sourceMappingURL=remote-environment.d.ts.map

package/dist/cli/remote-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-environment.d.ts","sourceRoot":"","sources":["../../src/cli/remote-environment.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAQL,KAAK,uBAAuB,EAE7B,MAAM,kCAAkC,CAAC;AAO1C,YAAY,EACV,8BAA8B,EAC9B,uBAAuB,EACvB,+BAA+B,GAChC,MAAM,kCAAkC,CAAC;AAkD1C;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,MAAM,CAAC,UAAU,GAC7B,OAAO,CAAC,uBAAuB,CAAC,CA2BlC"}

package/dist/cli/remote-environment.js

@@ -0,0 +1,73 @@
+import * as path from "node:path";
+import { createDetectorRegistry } from "../detection/index.js";
+import { readJsonOrNull } from "../utils/index.js";
+import { DEFAULT_STARTUP_ARTIFACTS, manifestRequirements, REMOTE_AGENTS, REMOTE_ENVIRONMENT_MANIFEST, uniqueRequirements, } from "./remote-environment-contract.js";
+import { configuredIntegrationRequirements } from "./remote-environment-catalog.js";
+import { detectedProjectRequirements, projectFileExists, } from "./remote-environment-detection.js";
+/**
+ * Restrict manifest artifacts to files beneath the host project.
+ * @param candidate - Project-owned manifest value
+ * @returns Whether the value is a safe project-relative path
+ */
+function isSafeProjectArtifact(candidate) {
+    return (candidate.length > 0 &&
+        !path.isAbsolute(candidate) &&
+        !candidate.split(/[\\/]/u).includes(".."));
+}
+/**
+ * Resolve an explicitly configured or discovered startup artifact for one agent.
+ * @param destDir - Project root
+ * @param agent - Supported coding agent
+ * @param manifest - Project-owned manifest
+ * @returns Startup artifact status
+ */
+async function resolveStartupScript(destDir, agent, manifest) {
+    const configured = manifest?.startupScripts?.[agent];
+    const explicit = typeof configured === "string" && isSafeProjectArtifact(configured)
+        ? configured
+        : undefined;
+    const candidates = explicit === undefined ? DEFAULT_STARTUP_ARTIFACTS[agent] : [explicit];
+    const existence = await Promise.all(candidates.map(async (artifact) => ({
+        artifact,
+        exists: await projectFileExists(destDir, artifact),
+    })));
+    const installed = existence.find(candidate => candidate.exists);
+    return installed === undefined
+        ? {
+            agent,
+            ...(explicit === undefined ? {} : { artifact: explicit }),
+            installed: false,
+        }
+        : { agent, artifact: installed.artifact, installed: true };
+}
+/**
+ * Inspect requirements for this particular project without exposing values.
+ * @param destDir - Project root
+ * @param config - Merged Lisa project config
+ * @param environment - Environment visible to the Lisa process
+ * @returns Project-aware variable and startup-artifact status
+ */
+export async function inspectRemoteEnvironment(destDir, config, environment) {
+    const detectorRegistry = createDetectorRegistry();
+    const [detectedTypes, manifest] = await Promise.all([
+        detectorRegistry.detectAll(destDir),
+        readJsonOrNull(path.join(destDir, REMOTE_ENVIRONMENT_MANIFEST)),
+    ]);
+    const projectTypes = detectorRegistry.expandAndOrderTypes(detectedTypes);
+    const requirements = uniqueRequirements([
+        ...configuredIntegrationRequirements(config),
+        ...(await detectedProjectRequirements(destDir, projectTypes)),
+        ...manifestRequirements(manifest),
+    ]);
+    const startupScripts = await Promise.all(REMOTE_AGENTS.map(agent => resolveStartupScript(destDir, agent, manifest)));
+    return {
+        projectTypes,
+        variables: requirements.map(requirement => ({
+            ...requirement,
+            set: typeof environment[requirement.name] === "string" &&
+                environment[requirement.name].length > 0,
+        })),
+        startupScripts,
+    };
+}
+//# sourceMappingURL=remote-environment.js.map

package/dist/cli/remote-environment.js.map

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