@lunora/config 1.0.0-alpha.46 → 1.0.0-alpha.47

package/dist/index.d.mts

@@ -3,6 +3,23 @@ export type { ContainerIR, WorkflowIR } from '@lunora/codegen';
 import { Writable } from 'node:stream';
 import 'ts-morph';
 export { type A as AdditivePolicyEdit, type D as DestructivePolicyEdit, type P as PolicyEdit, type a as PolicyScaffoldFailureReason, type b as ScaffoldFileResult, type S as ScaffoldPolicyEdit, type c as WireResult, type W as WireRlsEdit, d as classifyPolicyEdit, s as scaffoldPolicyFile, w as wireRlsIntoProcedure } from "./packem_shared/policy-scaffold.d-DCmwn7zQ.mjs";
+/** Minimal env shape — `process.env` structurally, injectable for tests. */
+type EnvLike = Readonly<Record<string, string | undefined>>;
+/** One detected agent: which tool, and which env var gave it away. */
+interface AgentDetection {
+  /** Human-readable agent name, for the "agent detected" log line. */
+  name: string;
+  /** The environment variable that matched. */
+  variable: string;
+}
+/** Env var that forces agent mode on (`1`/`true`) or off (`0`/`false`), overriding detection. */
+declare const AGENT_MODE_ENV = "LUNORA_AGENT_MODE";
+/**
+* Detect the AI agent driving this process, or `undefined` when none is.
+* `LUNORA_AGENT_MODE` wins over `@visulima/find-ai-runner`'s marker table in
+* both directions. Pure — pass a custom `env` in tests.
+*/
+declare const detectAiAgent: (env?: EnvLike) => AgentDetection | undefined;
 /**
 * Project-relative directory the Lunora agent skills ("rules") install into.
 * This is the portable [Agent Skills](https://tanstack.com/intent/latest/docs/registry)
@@ -157,6 +174,13 @@ interface FrameworkDetection {
   framework: DetectedFramework;
 }
 /**
+* Read and parse the project `package.json`, returning its merged
+* `dependencies` + `devDependencies` name set (empty on any failure). Public
+* so sibling consumers (e.g. the CLI's Vite-project detection) share one
+* best-effort reader instead of re-parsing `package.json` themselves.
+*/
+declare const readProjectDependencyNames: (root: string) => ReadonlySet<string>;
+/**
 * Detect which meta-framework a project uses by inspecting its `package.json`
 * dependencies, and classify it under void's class-A/B/C model (PLAN4 §3).
 *
@@ -165,6 +189,112 @@ interface FrameworkDetection {
 * SPA flow is preserved.
 */
 declare const detectFramework: (root: string) => FrameworkDetection;
+/** Directory holding per-checkout Lunora state (gitignored by convention). */
+declare const DEV_STATE_DIR = ".lunora";
+/** The dev-server state filename, relative to the project root. */
+declare const DEV_STATE_FILE: string;
+/** Log file a backgrounded dev server's output is captured to, relative to the project root. */
+declare const DEV_LOG_FILE: string;
+/**
+* Marker env `lunora dev --background` sets on the detached server process
+* (the daemon `lunora dev` or `vite dev`), so it records itself as
+* `background: true` — and, for the CLI daemon, never re-detects an agent and
+* recurses into background mode again.
+*/
+declare const DEV_DAEMON_ENV = "LUNORA_DEV_DAEMON";
+/** Env carrying the capture-log path into the detached server, recorded in the state file. */
+declare const DEV_LOG_FILE_ENV = "LUNORA_DEV_LOG_FILE";
+/**
+* Env carrying the PID of a parent that holds a *provisional* state record it
+* expects the child dev server to supersede. The CLI claims `.lunora/dev.json`
+* with its own PID before spawning the real server (closing the duplicate-start
+* race for the vite flavor and the wrangler daemon), then hands its PID down
+* via this variable; the child's claim (see {@link claimDevServerState}'s
+* `supersedePid`) may replace exactly that record with the authoritative
+* URL + PID.
+*/
+declare const DEV_HANDOFF_ENV = "LUNORA_DEV_HANDOFF_PID";
+/** How the recorded dev server runs. */
+type DevServerMode = "cli" | "vite";
+/** The state record persisted to `.lunora/dev.json`. */
+interface DevServerState {
+  /** Whether the server was detached into the background (`lunora dev --background`). */
+  background?: boolean;
+  /** Absolute path of the log file capturing the server's output, when captured. */
+  logFile?: string;
+  /** `"cli"` for the `lunora dev` wrangler orchestration, `"vite"` for a Vite dev server. */
+  mode: DevServerMode;
+  /** PID of the process to signal for shutdown (the orchestrating CLI or the Vite process). */
+  pid: number;
+  /** ISO-8601 stamp written at startup, purely informational (drives `status` uptime). */
+  startedAt?: string;
+  /** The embedded studio server's URL, when it runs. */
+  studioUrl?: string;
+  /** The primary URL serving the worker/app. */
+  url: string;
+}
+/**
+* True when a process with `pid` is currently alive AND signalable by this
+* user. Signal `0` performs the existence check without delivering anything.
+*
+* `EPERM` ("alive but another user's process") deliberately counts as NOT
+* alive here: every dev server this module tracks was spawned by the current
+* user, so a PID we cannot signal is by definition a recycled PID — treating
+* it as running would wedge the lockfile permanently and aim `dev stop`'s
+* kill escalation at an innocent process.
+*/
+declare const isProcessAlive: (pid: number) => boolean;
+/**
+* True when the record's PID verifiably still refers to the dev server that
+* wrote the record — not merely "some process exists with that number".
+* Guards against PID reuse: a server process necessarily starts BEFORE its
+* record is written, so a process that started after `startedAt` (+ skew) is
+* a recycled PID wearing the corpse's number. The start-time check runs only
+* where the platform exposes it (Linux); elsewhere liveness alone decides.
+*/
+declare const isRecordedProcessCurrent: (state: DevServerState) => boolean;
+/**
+* Read the state record from `.lunora/dev.json`, or `undefined` when there is
+* no usable record. Best-effort; performs NO liveness check — use
+* {@link readLiveDevServerState} for "is a dev server actually running".
+*/
+declare const readDevServerState: (projectRoot: string) => DevServerState | undefined;
+/**
+* Write the state record to `.lunora/dev.json`, creating the `.lunora/`
+* directory when absent. Returns the absolute path written, or `undefined`
+* when the write failed (state is convenience metadata — a read-only checkout
+* must never crash dev startup).
+*/
+declare const writeDevServerState: (projectRoot: string, state: DevServerState) => string | undefined;
+/**
+* Merge `patch` into the existing state record, when one exists. Used by the
+* CLI to stamp `background`/`logFile` onto the record the Vite plugin wrote.
+* Returns the merged record, or `undefined` when there was nothing to update.
+*/
+declare const updateDevServerState: (projectRoot: string, patch: Partial<DevServerState>) => DevServerState | undefined;
+/**
+* Remove `.lunora/dev.json`. Idempotent and never throws. When `expectedPid`
+* is given, the file is only removed while it still records that PID — so a
+* shutting-down server can't clobber the record a newer server just wrote.
+*/
+declare const clearDevServerState: (projectRoot: string, expectedPid?: number) => void;
+/**
+* The state record of a dev server that is verifiably running right now, or
+* `undefined`. A record whose PID is dead — or recycled onto a different
+* process (see {@link isRecordedProcessCurrent}) — is stale: it is cleared on
+* the spot so subsequent starts don't keep re-reading a corpse.
+*/
+declare const readLiveDevServerState: (projectRoot: string) => DevServerState | undefined;
+/** Result of {@link claimDevServerState}: claimed, or lost to the live server already recorded. */
+interface ClaimDevServerStateResult {
+  /** The live record that won the race, when `ok` is `false`. */
+  existing?: DevServerState;
+  /** Whether this process now owns the record. */
+  ok: boolean;
+}
+declare const claimDevServerState: (projectRoot: string, state: DevServerState, options?: {
+  supersedePid?: number;
+}) => ClaimDevServerStateResult;
 /**
 * The `.dev.vars` line grammar — one owner, shared by every reader/writer of the
 * file so the format can't drift between packages. `@lunora/cli`'s `env`
@@ -1319,4 +1449,4 @@ interface WranglerProjectValidationResult {
 * `{ problems, wranglerPath }` shape plus the structured `report`.
 */
 declare const validateWranglerProject: (options: WranglerProjectValidationOptions) => WranglerProjectValidationResult;
-export { ACCENT, AGENT_RULES_DIR, AGENT_RULES_HINT, AGENT_RULES_HINT_ENV, type AddIndexEdit, type AddOptionalColumnEdit, type AddTableEdit, type AdditiveEdit, type AgentRulesStatus, type ApplyEditResult, type ApplyFailureReason, type AugmentPlan, BADGES, BADGE_COLUMN_WIDTH, type BadgeName, type BadgeSpec, type ContainerLogLevel, type ContainerLogLine, type ContainerLogSource, type ContainerLogStreamHandle, type ContainerLogStreamOptions, DEV_VARS_EXAMPLE_FILE, DEV_VARS_FILE, DEV_VARS_KEY_PATTERN, type DestructiveEdit, type DetectedFramework, type DevSecretsFillPlan, type DiscoverContainerInfoResult, type DiscoverSchemaInfoResult, type DiscoverWorkflowInfoResult, type DockerLike, type EnsureDevVariablesDeps, type EnsureDevVariablesResult, type EnsureDevVariablesStatus, type ExportGap, type FillDevSecretsResult, type FrameworkClass, type FrameworkDetection, type InferOptions, type InferredBindings, type InferredContainer, type InferredWorkflow, LINKED_PROJECT_DIR, LINKED_PROJECT_FILE, LUNA_ART, LUNA_BUNNY, LUNA_NAME, LUNA_SIGNOFF, LUNORA_CONFIG_FILE, LUNORA_EVENT_SOURCE, LUNORA_SKILL_NAMES, type LevelBadgeName, type LinkedProject, type LunoraFormattedLine, type LunoraLineLevel, type LunoraProjectConfig, LunoraReporter, type MaterializeOptions, type MaterializeResult, type MultiSelectOption, PACKAGE_SECRETS_REGISTRY, type ParseSchemaResult, REMOTE_ELIGIBLE_KEYS, REQUIRED_COMPATIBILITY_DATE, REQUIRED_FLAG, ROOT_SKILL_NAME, type ReadWranglerResult, type ReconcileBindingsResult, type RemoteBindingPlan, type RemoteEnableInputs, type RemotePreference, type RemoteWranglerShape, STEP_BADGE_NAMES, type ScaffoldPlan, type SchemaColumn, type SchemaEdit, type SchemaIndex, type SchemaInfo, type SchemaTable, type SecretEntry, type SelectOption, type StepBadgeName, type TailConsumer, WRANGLER_FILES, type WranglerConfig, type WranglerContainerEntry, type WranglerProjectValidationOptions, type WranglerProjectValidationResult, type WranglerValidationReport, type WranglerWorkflowEntry, applyAdditiveEdit, badgeLead, badgeWidth, buildPackageSecretsBlock, claimAgentRulesHint, classifyEdit, createConfirm, detectAgentRules, detectFramework, discoverContainerInfo, discoverSchemaInfo, discoverWorkflowInfo, ensureDevVariables, ensureDevVariablesExample as ensureDevVarsExample, fillDevSecrets, findWranglerFile, formatLunoraEvent, generateSecretValue, inferLunoraBindings, injectRemoteFlags, interpretRemote, isInteractive, isMintableSecretKey, isPlaceholderValue, isRemoteEnvEnabled, materializeRemoteWranglerConfig, packageNamesFromBindings, padBadge, paintAnswer, paintBadge, parseDevVariableEntries, parseSchema, planDevSecretsFill, planDevVariablesAugment, planDevVariablesScaffold, planRemoteBindings, promptMultiSelect, promptSelect, promptYesNo, readLinkedProject, readProjectRemotePreference, readWranglerJsonc, reconcileWranglerBindings, requiredSecrets, resolveRemoteEnabled, secretsForPackages, streamContainerLogs, validateWrangler, validateWranglerConfig, validateWranglerProject, withTailConsumer, writeLinkedProject };
+export { ACCENT, AGENT_MODE_ENV, AGENT_RULES_DIR, AGENT_RULES_HINT, AGENT_RULES_HINT_ENV, type AddIndexEdit, type AddOptionalColumnEdit, type AddTableEdit, type AdditiveEdit, type AgentDetection, type AgentRulesStatus, type ApplyEditResult, type ApplyFailureReason, type AugmentPlan, BADGES, BADGE_COLUMN_WIDTH, type BadgeName, type BadgeSpec, type ClaimDevServerStateResult, type ContainerLogLevel, type ContainerLogLine, type ContainerLogSource, type ContainerLogStreamHandle, type ContainerLogStreamOptions, DEV_DAEMON_ENV, DEV_HANDOFF_ENV, DEV_LOG_FILE, DEV_LOG_FILE_ENV, DEV_STATE_DIR, DEV_STATE_FILE, DEV_VARS_EXAMPLE_FILE, DEV_VARS_FILE, DEV_VARS_KEY_PATTERN, type DestructiveEdit, type DetectedFramework, type DevSecretsFillPlan, type DevServerMode, type DevServerState, type DiscoverContainerInfoResult, type DiscoverSchemaInfoResult, type DiscoverWorkflowInfoResult, type DockerLike, type EnsureDevVariablesDeps, type EnsureDevVariablesResult, type EnsureDevVariablesStatus, type ExportGap, type FillDevSecretsResult, type FrameworkClass, type FrameworkDetection, type InferOptions, type InferredBindings, type InferredContainer, type InferredWorkflow, LINKED_PROJECT_DIR, LINKED_PROJECT_FILE, LUNA_ART, LUNA_BUNNY, LUNA_NAME, LUNA_SIGNOFF, LUNORA_CONFIG_FILE, LUNORA_EVENT_SOURCE, LUNORA_SKILL_NAMES, type LevelBadgeName, type LinkedProject, type LunoraFormattedLine, type LunoraLineLevel, type LunoraProjectConfig, LunoraReporter, type MaterializeOptions, type MaterializeResult, type MultiSelectOption, PACKAGE_SECRETS_REGISTRY, type ParseSchemaResult, REMOTE_ELIGIBLE_KEYS, REQUIRED_COMPATIBILITY_DATE, REQUIRED_FLAG, ROOT_SKILL_NAME, type ReadWranglerResult, type ReconcileBindingsResult, type RemoteBindingPlan, type RemoteEnableInputs, type RemotePreference, type RemoteWranglerShape, STEP_BADGE_NAMES, type ScaffoldPlan, type SchemaColumn, type SchemaEdit, type SchemaIndex, type SchemaInfo, type SchemaTable, type SecretEntry, type SelectOption, type StepBadgeName, type TailConsumer, WRANGLER_FILES, type WranglerConfig, type WranglerContainerEntry, type WranglerProjectValidationOptions, type WranglerProjectValidationResult, type WranglerValidationReport, type WranglerWorkflowEntry, applyAdditiveEdit, badgeLead, badgeWidth, buildPackageSecretsBlock, claimAgentRulesHint, claimDevServerState, classifyEdit, clearDevServerState, createConfirm, detectAgentRules, detectAiAgent, detectFramework, discoverContainerInfo, discoverSchemaInfo, discoverWorkflowInfo, ensureDevVariables, ensureDevVariablesExample as ensureDevVarsExample, fillDevSecrets, findWranglerFile, formatLunoraEvent, generateSecretValue, inferLunoraBindings, injectRemoteFlags, interpretRemote, isInteractive, isMintableSecretKey, isPlaceholderValue, isProcessAlive, isRecordedProcessCurrent, isRemoteEnvEnabled, materializeRemoteWranglerConfig, packageNamesFromBindings, padBadge, paintAnswer, paintBadge, parseDevVariableEntries, parseSchema, planDevSecretsFill, planDevVariablesAugment, planDevVariablesScaffold, planRemoteBindings, promptMultiSelect, promptSelect, promptYesNo, readDevServerState, readLinkedProject, readLiveDevServerState, readProjectDependencyNames, readProjectRemotePreference, readWranglerJsonc, reconcileWranglerBindings, requiredSecrets, resolveRemoteEnabled, secretsForPackages, streamContainerLogs, updateDevServerState, validateWrangler, validateWranglerConfig, validateWranglerProject, withTailConsumer, writeDevServerState, writeLinkedProject };

package/dist/index.d.ts

@@ -3,6 +3,23 @@ export type { ContainerIR, WorkflowIR } from '@lunora/codegen';
 import { Writable } from 'node:stream';
 import 'ts-morph';
 export { type A as AdditivePolicyEdit, type D as DestructivePolicyEdit, type P as PolicyEdit, type a as PolicyScaffoldFailureReason, type b as ScaffoldFileResult, type S as ScaffoldPolicyEdit, type c as WireResult, type W as WireRlsEdit, d as classifyPolicyEdit, s as scaffoldPolicyFile, w as wireRlsIntoProcedure } from "./packem_shared/policy-scaffold.d-DCmwn7zQ.js";
+/** Minimal env shape — `process.env` structurally, injectable for tests. */
+type EnvLike = Readonly<Record<string, string | undefined>>;
+/** One detected agent: which tool, and which env var gave it away. */
+interface AgentDetection {
+  /** Human-readable agent name, for the "agent detected" log line. */
+  name: string;
+  /** The environment variable that matched. */
+  variable: string;
+}
+/** Env var that forces agent mode on (`1`/`true`) or off (`0`/`false`), overriding detection. */
+declare const AGENT_MODE_ENV = "LUNORA_AGENT_MODE";
+/**
+* Detect the AI agent driving this process, or `undefined` when none is.
+* `LUNORA_AGENT_MODE` wins over `@visulima/find-ai-runner`'s marker table in
+* both directions. Pure — pass a custom `env` in tests.
+*/
+declare const detectAiAgent: (env?: EnvLike) => AgentDetection | undefined;
 /**
 * Project-relative directory the Lunora agent skills ("rules") install into.
 * This is the portable [Agent Skills](https://tanstack.com/intent/latest/docs/registry)
@@ -157,6 +174,13 @@ interface FrameworkDetection {
   framework: DetectedFramework;
 }
 /**
+* Read and parse the project `package.json`, returning its merged
+* `dependencies` + `devDependencies` name set (empty on any failure). Public
+* so sibling consumers (e.g. the CLI's Vite-project detection) share one
+* best-effort reader instead of re-parsing `package.json` themselves.
+*/
+declare const readProjectDependencyNames: (root: string) => ReadonlySet<string>;
+/**
 * Detect which meta-framework a project uses by inspecting its `package.json`
 * dependencies, and classify it under void's class-A/B/C model (PLAN4 §3).
 *
@@ -165,6 +189,112 @@ interface FrameworkDetection {
 * SPA flow is preserved.
 */
 declare const detectFramework: (root: string) => FrameworkDetection;
+/** Directory holding per-checkout Lunora state (gitignored by convention). */
+declare const DEV_STATE_DIR = ".lunora";
+/** The dev-server state filename, relative to the project root. */
+declare const DEV_STATE_FILE: string;
+/** Log file a backgrounded dev server's output is captured to, relative to the project root. */
+declare const DEV_LOG_FILE: string;
+/**
+* Marker env `lunora dev --background` sets on the detached server process
+* (the daemon `lunora dev` or `vite dev`), so it records itself as
+* `background: true` — and, for the CLI daemon, never re-detects an agent and
+* recurses into background mode again.
+*/
+declare const DEV_DAEMON_ENV = "LUNORA_DEV_DAEMON";
+/** Env carrying the capture-log path into the detached server, recorded in the state file. */
+declare const DEV_LOG_FILE_ENV = "LUNORA_DEV_LOG_FILE";
+/**
+* Env carrying the PID of a parent that holds a *provisional* state record it
+* expects the child dev server to supersede. The CLI claims `.lunora/dev.json`
+* with its own PID before spawning the real server (closing the duplicate-start
+* race for the vite flavor and the wrangler daemon), then hands its PID down
+* via this variable; the child's claim (see {@link claimDevServerState}'s
+* `supersedePid`) may replace exactly that record with the authoritative
+* URL + PID.
+*/
+declare const DEV_HANDOFF_ENV = "LUNORA_DEV_HANDOFF_PID";
+/** How the recorded dev server runs. */
+type DevServerMode = "cli" | "vite";
+/** The state record persisted to `.lunora/dev.json`. */
+interface DevServerState {
+  /** Whether the server was detached into the background (`lunora dev --background`). */
+  background?: boolean;
+  /** Absolute path of the log file capturing the server's output, when captured. */
+  logFile?: string;
+  /** `"cli"` for the `lunora dev` wrangler orchestration, `"vite"` for a Vite dev server. */
+  mode: DevServerMode;
+  /** PID of the process to signal for shutdown (the orchestrating CLI or the Vite process). */
+  pid: number;
+  /** ISO-8601 stamp written at startup, purely informational (drives `status` uptime). */
+  startedAt?: string;
+  /** The embedded studio server's URL, when it runs. */
+  studioUrl?: string;
+  /** The primary URL serving the worker/app. */
+  url: string;
+}
+/**
+* True when a process with `pid` is currently alive AND signalable by this
+* user. Signal `0` performs the existence check without delivering anything.
+*
+* `EPERM` ("alive but another user's process") deliberately counts as NOT
+* alive here: every dev server this module tracks was spawned by the current
+* user, so a PID we cannot signal is by definition a recycled PID — treating
+* it as running would wedge the lockfile permanently and aim `dev stop`'s
+* kill escalation at an innocent process.
+*/
+declare const isProcessAlive: (pid: number) => boolean;
+/**
+* True when the record's PID verifiably still refers to the dev server that
+* wrote the record — not merely "some process exists with that number".
+* Guards against PID reuse: a server process necessarily starts BEFORE its
+* record is written, so a process that started after `startedAt` (+ skew) is
+* a recycled PID wearing the corpse's number. The start-time check runs only
+* where the platform exposes it (Linux); elsewhere liveness alone decides.
+*/
+declare const isRecordedProcessCurrent: (state: DevServerState) => boolean;
+/**
+* Read the state record from `.lunora/dev.json`, or `undefined` when there is
+* no usable record. Best-effort; performs NO liveness check — use
+* {@link readLiveDevServerState} for "is a dev server actually running".
+*/
+declare const readDevServerState: (projectRoot: string) => DevServerState | undefined;
+/**
+* Write the state record to `.lunora/dev.json`, creating the `.lunora/`
+* directory when absent. Returns the absolute path written, or `undefined`
+* when the write failed (state is convenience metadata — a read-only checkout
+* must never crash dev startup).
+*/
+declare const writeDevServerState: (projectRoot: string, state: DevServerState) => string | undefined;
+/**
+* Merge `patch` into the existing state record, when one exists. Used by the
+* CLI to stamp `background`/`logFile` onto the record the Vite plugin wrote.
+* Returns the merged record, or `undefined` when there was nothing to update.
+*/
+declare const updateDevServerState: (projectRoot: string, patch: Partial<DevServerState>) => DevServerState | undefined;
+/**
+* Remove `.lunora/dev.json`. Idempotent and never throws. When `expectedPid`
+* is given, the file is only removed while it still records that PID — so a
+* shutting-down server can't clobber the record a newer server just wrote.
+*/
+declare const clearDevServerState: (projectRoot: string, expectedPid?: number) => void;
+/**
+* The state record of a dev server that is verifiably running right now, or
+* `undefined`. A record whose PID is dead — or recycled onto a different
+* process (see {@link isRecordedProcessCurrent}) — is stale: it is cleared on
+* the spot so subsequent starts don't keep re-reading a corpse.
+*/
+declare const readLiveDevServerState: (projectRoot: string) => DevServerState | undefined;
+/** Result of {@link claimDevServerState}: claimed, or lost to the live server already recorded. */
+interface ClaimDevServerStateResult {
+  /** The live record that won the race, when `ok` is `false`. */
+  existing?: DevServerState;
+  /** Whether this process now owns the record. */
+  ok: boolean;
+}
+declare const claimDevServerState: (projectRoot: string, state: DevServerState, options?: {
+  supersedePid?: number;
+}) => ClaimDevServerStateResult;
 /**
 * The `.dev.vars` line grammar — one owner, shared by every reader/writer of the
 * file so the format can't drift between packages. `@lunora/cli`'s `env`
@@ -1319,4 +1449,4 @@ interface WranglerProjectValidationResult {
 * `{ problems, wranglerPath }` shape plus the structured `report`.
 */
 declare const validateWranglerProject: (options: WranglerProjectValidationOptions) => WranglerProjectValidationResult;
-export { ACCENT, AGENT_RULES_DIR, AGENT_RULES_HINT, AGENT_RULES_HINT_ENV, type AddIndexEdit, type AddOptionalColumnEdit, type AddTableEdit, type AdditiveEdit, type AgentRulesStatus, type ApplyEditResult, type ApplyFailureReason, type AugmentPlan, BADGES, BADGE_COLUMN_WIDTH, type BadgeName, type BadgeSpec, type ContainerLogLevel, type ContainerLogLine, type ContainerLogSource, type ContainerLogStreamHandle, type ContainerLogStreamOptions, DEV_VARS_EXAMPLE_FILE, DEV_VARS_FILE, DEV_VARS_KEY_PATTERN, type DestructiveEdit, type DetectedFramework, type DevSecretsFillPlan, type DiscoverContainerInfoResult, type DiscoverSchemaInfoResult, type DiscoverWorkflowInfoResult, type DockerLike, type EnsureDevVariablesDeps, type EnsureDevVariablesResult, type EnsureDevVariablesStatus, type ExportGap, type FillDevSecretsResult, type FrameworkClass, type FrameworkDetection, type InferOptions, type InferredBindings, type InferredContainer, type InferredWorkflow, LINKED_PROJECT_DIR, LINKED_PROJECT_FILE, LUNA_ART, LUNA_BUNNY, LUNA_NAME, LUNA_SIGNOFF, LUNORA_CONFIG_FILE, LUNORA_EVENT_SOURCE, LUNORA_SKILL_NAMES, type LevelBadgeName, type LinkedProject, type LunoraFormattedLine, type LunoraLineLevel, type LunoraProjectConfig, LunoraReporter, type MaterializeOptions, type MaterializeResult, type MultiSelectOption, PACKAGE_SECRETS_REGISTRY, type ParseSchemaResult, REMOTE_ELIGIBLE_KEYS, REQUIRED_COMPATIBILITY_DATE, REQUIRED_FLAG, ROOT_SKILL_NAME, type ReadWranglerResult, type ReconcileBindingsResult, type RemoteBindingPlan, type RemoteEnableInputs, type RemotePreference, type RemoteWranglerShape, STEP_BADGE_NAMES, type ScaffoldPlan, type SchemaColumn, type SchemaEdit, type SchemaIndex, type SchemaInfo, type SchemaTable, type SecretEntry, type SelectOption, type StepBadgeName, type TailConsumer, WRANGLER_FILES, type WranglerConfig, type WranglerContainerEntry, type WranglerProjectValidationOptions, type WranglerProjectValidationResult, type WranglerValidationReport, type WranglerWorkflowEntry, applyAdditiveEdit, badgeLead, badgeWidth, buildPackageSecretsBlock, claimAgentRulesHint, classifyEdit, createConfirm, detectAgentRules, detectFramework, discoverContainerInfo, discoverSchemaInfo, discoverWorkflowInfo, ensureDevVariables, ensureDevVariablesExample as ensureDevVarsExample, fillDevSecrets, findWranglerFile, formatLunoraEvent, generateSecretValue, inferLunoraBindings, injectRemoteFlags, interpretRemote, isInteractive, isMintableSecretKey, isPlaceholderValue, isRemoteEnvEnabled, materializeRemoteWranglerConfig, packageNamesFromBindings, padBadge, paintAnswer, paintBadge, parseDevVariableEntries, parseSchema, planDevSecretsFill, planDevVariablesAugment, planDevVariablesScaffold, planRemoteBindings, promptMultiSelect, promptSelect, promptYesNo, readLinkedProject, readProjectRemotePreference, readWranglerJsonc, reconcileWranglerBindings, requiredSecrets, resolveRemoteEnabled, secretsForPackages, streamContainerLogs, validateWrangler, validateWranglerConfig, validateWranglerProject, withTailConsumer, writeLinkedProject };
+export { ACCENT, AGENT_MODE_ENV, AGENT_RULES_DIR, AGENT_RULES_HINT, AGENT_RULES_HINT_ENV, type AddIndexEdit, type AddOptionalColumnEdit, type AddTableEdit, type AdditiveEdit, type AgentDetection, type AgentRulesStatus, type ApplyEditResult, type ApplyFailureReason, type AugmentPlan, BADGES, BADGE_COLUMN_WIDTH, type BadgeName, type BadgeSpec, type ClaimDevServerStateResult, type ContainerLogLevel, type ContainerLogLine, type ContainerLogSource, type ContainerLogStreamHandle, type ContainerLogStreamOptions, DEV_DAEMON_ENV, DEV_HANDOFF_ENV, DEV_LOG_FILE, DEV_LOG_FILE_ENV, DEV_STATE_DIR, DEV_STATE_FILE, DEV_VARS_EXAMPLE_FILE, DEV_VARS_FILE, DEV_VARS_KEY_PATTERN, type DestructiveEdit, type DetectedFramework, type DevSecretsFillPlan, type DevServerMode, type DevServerState, type DiscoverContainerInfoResult, type DiscoverSchemaInfoResult, type DiscoverWorkflowInfoResult, type DockerLike, type EnsureDevVariablesDeps, type EnsureDevVariablesResult, type EnsureDevVariablesStatus, type ExportGap, type FillDevSecretsResult, type FrameworkClass, type FrameworkDetection, type InferOptions, type InferredBindings, type InferredContainer, type InferredWorkflow, LINKED_PROJECT_DIR, LINKED_PROJECT_FILE, LUNA_ART, LUNA_BUNNY, LUNA_NAME, LUNA_SIGNOFF, LUNORA_CONFIG_FILE, LUNORA_EVENT_SOURCE, LUNORA_SKILL_NAMES, type LevelBadgeName, type LinkedProject, type LunoraFormattedLine, type LunoraLineLevel, type LunoraProjectConfig, LunoraReporter, type MaterializeOptions, type MaterializeResult, type MultiSelectOption, PACKAGE_SECRETS_REGISTRY, type ParseSchemaResult, REMOTE_ELIGIBLE_KEYS, REQUIRED_COMPATIBILITY_DATE, REQUIRED_FLAG, ROOT_SKILL_NAME, type ReadWranglerResult, type ReconcileBindingsResult, type RemoteBindingPlan, type RemoteEnableInputs, type RemotePreference, type RemoteWranglerShape, STEP_BADGE_NAMES, type ScaffoldPlan, type SchemaColumn, type SchemaEdit, type SchemaIndex, type SchemaInfo, type SchemaTable, type SecretEntry, type SelectOption, type StepBadgeName, type TailConsumer, WRANGLER_FILES, type WranglerConfig, type WranglerContainerEntry, type WranglerProjectValidationOptions, type WranglerProjectValidationResult, type WranglerValidationReport, type WranglerWorkflowEntry, applyAdditiveEdit, badgeLead, badgeWidth, buildPackageSecretsBlock, claimAgentRulesHint, claimDevServerState, classifyEdit, clearDevServerState, createConfirm, detectAgentRules, detectAiAgent, detectFramework, discoverContainerInfo, discoverSchemaInfo, discoverWorkflowInfo, ensureDevVariables, ensureDevVariablesExample as ensureDevVarsExample, fillDevSecrets, findWranglerFile, formatLunoraEvent, generateSecretValue, inferLunoraBindings, injectRemoteFlags, interpretRemote, isInteractive, isMintableSecretKey, isPlaceholderValue, isProcessAlive, isRecordedProcessCurrent, isRemoteEnvEnabled, materializeRemoteWranglerConfig, packageNamesFromBindings, padBadge, paintAnswer, paintBadge, parseDevVariableEntries, parseSchema, planDevSecretsFill, planDevVariablesAugment, planDevVariablesScaffold, planRemoteBindings, promptMultiSelect, promptSelect, promptYesNo, readDevServerState, readLinkedProject, readLiveDevServerState, readProjectDependencyNames, readProjectRemotePreference, readWranglerJsonc, reconcileWranglerBindings, requiredSecrets, resolveRemoteEnabled, secretsForPackages, streamContainerLogs, updateDevServerState, validateWrangler, validateWranglerConfig, validateWranglerProject, withTailConsumer, writeDevServerState, writeLinkedProject };

package/dist/index.mjs

@@ -1,7 +1,9 @@
+export { AGENT_MODE_ENV, detectAiAgent } from './packem_shared/AGENT_MODE_ENV-DM1Siczo.mjs';
 export { AGENT_RULES_DIR, AGENT_RULES_HINT, AGENT_RULES_HINT_ENV, LUNORA_SKILL_NAMES, ROOT_SKILL_NAME, claimAgentRulesHint, detectAgentRules } from './packem_shared/AGENT_RULES_DIR-lcgC08aE.mjs';
 export { discoverContainerInfo } from './packem_shared/discoverContainerInfo-BXFs6Wav.mjs';
 export { streamContainerLogs } from './packem_shared/streamContainerLogs-BZ4cOZwH.mjs';
-export { detectFramework } from './packem_shared/detectFramework-Br-BcPBq.mjs';
+export { detectFramework, readProjectDependencyNames } from './packem_shared/detectFramework-U08038Yp.mjs';
+export { DEV_DAEMON_ENV, DEV_HANDOFF_ENV, DEV_LOG_FILE, DEV_LOG_FILE_ENV, DEV_STATE_DIR, DEV_STATE_FILE, claimDevServerState, clearDevServerState, isProcessAlive, isRecordedProcessCurrent, readDevServerState, readLiveDevServerState, updateDevServerState, writeDevServerState } from './packem_shared/DEV_DAEMON_ENV-FIEtW7Fz.mjs';
 export { DEV_VARS_EXAMPLE_FILE, DEV_VARS_FILE, DEV_VARS_KEY_PATTERN, parseDevVariableEntries } from './packem_shared/DEV_VARS_EXAMPLE_FILE-dJPNTEnK.mjs';
 export { inferLunoraBindings, packageNamesFromBindings } from './packem_shared/inferLunoraBindings-ByMwG-gH.mjs';
 export { LINKED_PROJECT_DIR, LINKED_PROJECT_FILE, readLinkedProject, writeLinkedProject } from './packem_shared/LINKED_PROJECT_DIR-CXwXzV_C.mjs';

package/dist/packem_shared/AGENT_MODE_ENV-DM1Siczo.mjs

@@ -0,0 +1,17 @@
+import { detectAiSession } from '@visulima/find-ai-runner';
+
+const AGENT_MODE_ENV = "LUNORA_AGENT_MODE";
+const isDisabled = (value) => {
+  const normalized = value.trim().toLowerCase();
+  return normalized === "0" || normalized === "false";
+};
+const detectAiAgent = (env = process.env) => {
+  const override = env[AGENT_MODE_ENV];
+  if (override !== void 0 && override !== "") {
+    return isDisabled(override) ? void 0 : { name: "agent (forced)", variable: AGENT_MODE_ENV };
+  }
+  const session = detectAiSession(env);
+  return session === void 0 ? void 0 : { name: session.agent, variable: session.variable };
+};
+
+export { AGENT_MODE_ENV, detectAiAgent };

package/dist/packem_shared/DEV_DAEMON_ENV-FIEtW7Fz.mjs

@@ -0,0 +1,163 @@
+import { mkdirSync, writeFileSync, rmSync, existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+const DEV_STATE_DIR = ".lunora";
+const DEV_STATE_FILE = join(DEV_STATE_DIR, "dev.json");
+const DEV_LOG_FILE = join(DEV_STATE_DIR, "dev.log");
+const DEV_DAEMON_ENV = "LUNORA_DEV_DAEMON";
+const DEV_LOG_FILE_ENV = "LUNORA_DEV_LOG_FILE";
+const DEV_HANDOFF_ENV = "LUNORA_DEV_HANDOFF_PID";
+const isObject = (value) => value !== null && typeof value === "object";
+const stringField = (record, key) => {
+  const value = record[key];
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+};
+const isProcessAlive = (pid) => {
+  if (!Number.isInteger(pid) || pid <= 0) {
+    return false;
+  }
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+};
+const START_TIME_SKEW_MS = 1e4;
+const LINUX_CLOCK_TICKS_PER_SECOND = 100;
+const processStartTimeMs = (pid) => {
+  if (process.platform !== "linux") {
+    return void 0;
+  }
+  try {
+    const stat = readFileSync(`/proc/${String(pid)}/stat`, "utf8");
+    const fields = stat.slice(stat.lastIndexOf(")") + 2).split(" ");
+    const startTicks = Number(fields[19]);
+    const bootLine = readFileSync("/proc/stat", "utf8").split("\n").find((line) => line.startsWith("btime "));
+    const bootSeconds = Number(bootLine?.slice("btime ".length));
+    if (!Number.isFinite(startTicks) || !Number.isFinite(bootSeconds)) {
+      return void 0;
+    }
+    return bootSeconds * 1e3 + startTicks / LINUX_CLOCK_TICKS_PER_SECOND * 1e3;
+  } catch {
+    return void 0;
+  }
+};
+const isRecordedProcessCurrent = (state) => {
+  if (!isProcessAlive(state.pid)) {
+    return false;
+  }
+  const recordedAtMs = state.startedAt === void 0 ? Number.NaN : Date.parse(state.startedAt);
+  if (Number.isNaN(recordedAtMs)) {
+    return true;
+  }
+  const actualStartMs = processStartTimeMs(state.pid);
+  return actualStartMs === void 0 || actualStartMs <= recordedAtMs + START_TIME_SKEW_MS;
+};
+const readDevServerState = (projectRoot) => {
+  const path = join(projectRoot, DEV_STATE_FILE);
+  if (!existsSync(path)) {
+    return void 0;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    return void 0;
+  }
+  if (!isObject(parsed) || typeof parsed["pid"] !== "number") {
+    return void 0;
+  }
+  const url = stringField(parsed, "url");
+  if (url === void 0) {
+    return void 0;
+  }
+  return {
+    background: parsed["background"] === true,
+    logFile: stringField(parsed, "logFile"),
+    mode: parsed["mode"] === "vite" ? "vite" : "cli",
+    pid: parsed["pid"],
+    startedAt: stringField(parsed, "startedAt"),
+    studioUrl: stringField(parsed, "studioUrl"),
+    url
+  };
+};
+const writeDevServerState = (projectRoot, state) => {
+  try {
+    mkdirSync(join(projectRoot, DEV_STATE_DIR), { recursive: true });
+    const path = join(projectRoot, DEV_STATE_FILE);
+    writeFileSync(path, `${JSON.stringify(state, void 0, 2)}
+`, "utf8");
+    return path;
+  } catch {
+    return void 0;
+  }
+};
+const updateDevServerState = (projectRoot, patch) => {
+  const existing = readDevServerState(projectRoot);
+  if (existing === void 0) {
+    return void 0;
+  }
+  const merged = { ...existing, ...patch };
+  writeDevServerState(projectRoot, merged);
+  return merged;
+};
+const clearDevServerState = (projectRoot, expectedPid) => {
+  try {
+    if (expectedPid !== void 0) {
+      const current = readDevServerState(projectRoot);
+      if (current !== void 0 && current.pid !== expectedPid) {
+        return;
+      }
+    }
+    rmSync(join(projectRoot, DEV_STATE_FILE), { force: true });
+  } catch {
+  }
+};
+const readLiveDevServerState = (projectRoot) => {
+  const state = readDevServerState(projectRoot);
+  if (state === void 0) {
+    return void 0;
+  }
+  if (isRecordedProcessCurrent(state)) {
+    return state;
+  }
+  clearDevServerState(projectRoot, state.pid);
+  return void 0;
+};
+const resolveClaimConflict = (projectRoot, state, supersedePid) => {
+  const existing = readLiveDevServerState(projectRoot);
+  if (existing === void 0) {
+    return void 0;
+  }
+  if (supersedePid !== void 0 && existing.pid === supersedePid) {
+    return { ok: writeDevServerState(projectRoot, state) !== void 0 };
+  }
+  if (existing.pid !== state.pid) {
+    return { existing, ok: false };
+  }
+  return { ok: writeDevServerState(projectRoot, state) !== void 0 };
+};
+const claimDevServerState = (projectRoot, state, options) => {
+  const path = join(projectRoot, DEV_STATE_FILE);
+  const payload = `${JSON.stringify(state, void 0, 2)}
+`;
+  for (let attempt = 0; attempt < 2; attempt += 1) {
+    try {
+      mkdirSync(join(projectRoot, DEV_STATE_DIR), { recursive: true });
+      writeFileSync(path, payload, { encoding: "utf8", flag: "wx" });
+      return { ok: true };
+    } catch (error) {
+      if (error.code !== "EEXIST") {
+        return { ok: writeDevServerState(projectRoot, state) !== void 0 };
+      }
+      const resolved = resolveClaimConflict(projectRoot, state, options?.supersedePid);
+      if (resolved !== void 0) {
+        return resolved;
+      }
+    }
+  }
+  return { ok: writeDevServerState(projectRoot, state) !== void 0 };
+};
+
+export { DEV_DAEMON_ENV, DEV_HANDOFF_ENV, DEV_LOG_FILE, DEV_LOG_FILE_ENV, DEV_STATE_DIR, DEV_STATE_FILE, claimDevServerState, clearDevServerState, isProcessAlive, isRecordedProcessCurrent, readDevServerState, readLiveDevServerState, updateDevServerState, writeDevServerState };

package/dist/packem_shared/{detectFramework-Br-BcPBq.mjs → detectFramework-U08038Yp.mjs}

@@ -12,7 +12,7 @@ const FRAMEWORK_SIGNATURES = [
   { class: "B", dependency: "astro", framework: "astro" }
 ];
 const STANDALONE = { class: "C", framework: "none" };
-const readDependencyNames = (root) => {
+const readProjectDependencyNames = (root) => {
   const packageJsonPath = join(root, "package.json");
   if (!existsSync(packageJsonPath)) {
     return /* @__PURE__ */ new Set();
@@ -26,7 +26,7 @@ const readDependencyNames = (root) => {
   }
 };
 const detectFramework = (root) => {
-  const dependencies = readDependencyNames(root);
+  const dependencies = readProjectDependencyNames(root);
   if (dependencies.size === 0) {
     return STANDALONE;
   }
@@ -38,4 +38,4 @@ const detectFramework = (root) => {
   return STANDALONE;
 };
 
-export { detectFramework };
+export { detectFramework, readProjectDependencyNames };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/config",
-  "version": "1.0.0-alpha.46",
+  "version": "1.0.0-alpha.47",
   "description": "Internal shared CLI + Vite config layer for Lunora: wrangler.jsonc validation, binding inference, and .dev.vars scaffolding",
   "keywords": [
     "bindings",
@@ -55,6 +55,7 @@
     "@lunora/errors": "1.0.0-alpha.1",
     "@lunora/seed": "1.0.0-alpha.14",
     "@visulima/colorize": "2.0.0-alpha.14",
+    "@visulima/find-ai-runner": "1.0.0-alpha.9",
     "dockerode": "^5.0.1",
     "es-module-lexer": "^2.1.0",
     "jsonc-parser": "^3.3.1",