@telora/daemon-core 0.2.29 → 0.2.33

package/dist/env-config.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Typed, validated daemon environment configuration -- the ONE discoverable
+ * index of every operational knob the daemon reads from the environment.
+ *
+ * Why this module exists:
+ *   Before this, operational knobs were scattered as ad-hoc `process.env.TELORA_*`
+ *   reads across the daemon. They were undiscoverable (no single list), and a
+ *   typo'd or out-of-range value failed silently at runtime (NaN, wrong branch)
+ *   instead of loudly at startup. This module declares EVERY knob in one place
+ *   with a Zod type, a default, and a one-line description, and validates them
+ *   once at startup -- so invalid config fails loudly, naming the offending var.
+ *
+ * What lives here:
+ *   - Operational knobs only (loop gates, intervals, limits, ports, paths,
+ *     branch names, registry URL, telemetry tuning). Connection identity
+ *     (TELORA_TRACKER_ID / _ORGANIZATION_ID / _PRODUCT_ID / _URL / _REPO_PATH,
+ *     CLAUDE_CODE_PATH, TELORA_LOG_DIR, SESSION_TIMEOUT_MS) stays in
+ *     `config.ts`'s BASE_ENV_MAP -- that is the established home for connection
+ *     fields and the multi-product normalization. This module does not
+ *     duplicate them.
+ *   - Secrets (ANTHROPIC_API_KEY, OPENAI_API_KEY, ...) are intentionally OUT of
+ *     scope: they are read by spawned processes, not the daemon's own config.
+ *
+ * Loop-gate semantics:
+ *   The opt-out loop gates (TELORA_FOCUS_LOOP, ...) MUST reproduce
+ *   `shouldRunLoop` EXACTLY: unset -> true, '' -> true, '0' -> false,
+ *   anything else -> true. `loopGate()` below is the canonical preprocessor.
+ *
+ * Discoverability:
+ *   `ENV_VAR_METADATA` is the machine-readable index (name + description +
+ *   default + kind) of all declared knobs. `formatEnvVarTable()` renders it
+ *   for docs / `--help`.
+ */
+import { z } from 'zod';
+/**
+ * Reproduce the canonical opt-out loop-gate semantics as a boolean:
+ *   undefined -> true   (unset: loop fires)
+ *   ''        -> true   (treated like unset)
+ *   '0'       -> false  (explicit opt-out)
+ *   anything  -> true   ('1', 'true', 'yes', etc.)
+ *
+ * Keep this in lockstep with `shouldRunLoop` in
+ * `packages/daemon/src/focus-engine.ts`.
+ */
+export declare function loopGateEnabled(raw: string | undefined): boolean;
+export type EnvVarKind = 'loop-gate' | 'int' | 'float' | 'port' | 'bool' | 'string' | 'enum';
+export interface EnvVarMeta {
+    /** The process.env variable name (e.g. TELORA_FOCUS_LOOP). */
+    name: string;
+    /** The typed-config field name this var populates. */
+    field: keyof EnvConfig;
+    /** Coarse kind, for rendering / docs. */
+    kind: EnvVarKind;
+    /** Default applied when the var is unset or empty. */
+    default: string | number | boolean | undefined;
+    /** One-line human description of what the knob does. */
+    description: string;
+}
+declare const EnvConfigSchema: z.ZodObject<{
+    TELORA_FOCUS_LOOP: z.ZodType<boolean, unknown, z.core.$ZodTypeInternals<boolean, unknown>>;
+    TELORA_VERIFICATION_LOOP: z.ZodType<boolean, unknown, z.core.$ZodTypeInternals<boolean, unknown>>;
+    TELORA_MERGE_BACK_LOOP: z.ZodType<boolean, unknown, z.core.$ZodTypeInternals<boolean, unknown>>;
+    TELORA_FRT_PROSE_LOOP: z.ZodType<boolean, unknown, z.core.$ZodTypeInternals<boolean, unknown>>;
+    TELORA_PRD_LOOP: z.ZodType<boolean, unknown, z.core.$ZodTypeInternals<boolean, unknown>>;
+    TELORA_DRIFT_EVAL_LOOP: z.ZodType<boolean, unknown, z.core.$ZodTypeInternals<boolean, unknown>>;
+    TELORA_SECURITY_SCAN_LOOP: z.ZodType<boolean, unknown, z.core.$ZodTypeInternals<boolean, unknown>>;
+    TELORA_SECURITY_SCAN_INTERVAL_HOURS: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    TELORA_STUCK_BRANCH_THRESHOLD_HOURS: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    TELORA_REVIEW_REMEDIATION_LIMIT: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    TELORA_SCOPE_COVERAGE_NO_PROGRESS_LIMIT: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    TELORA_WORKTREE_DIR: z.ZodType<string | undefined, unknown, z.core.$ZodTypeInternals<string | undefined, unknown>>;
+    TELORA_INTEGRATION_BRANCH: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+    TELORA_POLICY_FAILURE_MODE: z.ZodPipe<z.ZodTransform<string, unknown>, z.ZodEnum<{
+        [x: string]: string;
+    }>>;
+    TELORA_REGISTRY_URL: z.ZodType<string, unknown, z.core.$ZodTypeInternals<string, unknown>>;
+    TELORA_TELEMETRY_ENABLED: z.ZodType<boolean, unknown, z.core.$ZodTypeInternals<boolean, unknown>>;
+    TELORA_TELEMETRY_PORT: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    TELORA_TELEMETRY_FLUSH_INTERVAL_MS: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    TELORA_TELEMETRY_RETENTION_DAYS: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    MAX_TOTAL_SESSIONS: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    TOKEN_LIMIT: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    COST_LIMIT: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    MERGE_LOCK_TIMEOUT_MS: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    MERGE_LOCK_CONTENTION_WARNING_MS: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    LOG_MAX_AGE_DAYS: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    LOG_MAX_TOTAL_BYTES: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+    LOG_MAX_FILES: z.ZodType<number, unknown, z.core.$ZodTypeInternals<number, unknown>>;
+}, z.core.$strip>;
+/** Fully typed, validated, frozen operational config. */
+export type EnvConfig = z.infer<typeof EnvConfigSchema>;
+/**
+ * Machine-readable index of every declared knob -- the discoverability surface.
+ * Order mirrors the schema declaration above.
+ */
+export declare const ENV_VAR_METADATA: readonly EnvVarMeta[];
+/**
+ * Parse + validate the operational env config ONCE and return a typed, frozen
+ * object. On invalid input, throws a CLEAR, ACTIONABLE error naming each
+ * offending variable and what was expected -- so a typo'd MERGE_LOCK_TIMEOUT_MS
+ * or a non-numeric TELORA_TELEMETRY_PORT fails loudly at startup rather than
+ * silently at runtime.
+ *
+ * @param env Env source (defaults to process.env). When omitted, the result is
+ *            memoized; pass an explicit env (e.g. in tests) to bypass the cache.
+ */
+export declare function loadEnvConfig(env?: NodeJS.ProcessEnv): EnvConfig;
+/** Test-only: clear the memoized config so a later load re-reads process.env. */
+export declare function resetEnvConfigCache(): void;
+/**
+ * Render the knob index as a human-readable table (for docs / --help output).
+ * This is the discoverable list of every operational env var.
+ */
+export declare function formatEnvVarTable(): string;
+export {};
+//# sourceMappingURL=env-config.d.ts.map

package/dist/env-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-config.d.ts","sourceRoot":"","sources":["../src/env-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIhE;AAsED,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE7F,MAAM,WAAW,UAAU;IACzB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,KAAK,EAAE,MAAM,SAAS,CAAC;IACvB,yCAAyC;IACzC,IAAI,EAAE,UAAU,CAAC;IACjB,sDAAsD;IACtD,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC/C,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;CACrB;AAiDD,QAAA,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAwB,CAAC;AAE9C,yDAAyD;AACzD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,UAAU,EAiChD,CAAC;AAQH;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CA6BhE;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C"}

package/dist/env-config.js

@@ -0,0 +1,230 @@
+/**
+ * Typed, validated daemon environment configuration -- the ONE discoverable
+ * index of every operational knob the daemon reads from the environment.
+ *
+ * Why this module exists:
+ *   Before this, operational knobs were scattered as ad-hoc `process.env.TELORA_*`
+ *   reads across the daemon. They were undiscoverable (no single list), and a
+ *   typo'd or out-of-range value failed silently at runtime (NaN, wrong branch)
+ *   instead of loudly at startup. This module declares EVERY knob in one place
+ *   with a Zod type, a default, and a one-line description, and validates them
+ *   once at startup -- so invalid config fails loudly, naming the offending var.
+ *
+ * What lives here:
+ *   - Operational knobs only (loop gates, intervals, limits, ports, paths,
+ *     branch names, registry URL, telemetry tuning). Connection identity
+ *     (TELORA_TRACKER_ID / _ORGANIZATION_ID / _PRODUCT_ID / _URL / _REPO_PATH,
+ *     CLAUDE_CODE_PATH, TELORA_LOG_DIR, SESSION_TIMEOUT_MS) stays in
+ *     `config.ts`'s BASE_ENV_MAP -- that is the established home for connection
+ *     fields and the multi-product normalization. This module does not
+ *     duplicate them.
+ *   - Secrets (ANTHROPIC_API_KEY, OPENAI_API_KEY, ...) are intentionally OUT of
+ *     scope: they are read by spawned processes, not the daemon's own config.
+ *
+ * Loop-gate semantics:
+ *   The opt-out loop gates (TELORA_FOCUS_LOOP, ...) MUST reproduce
+ *   `shouldRunLoop` EXACTLY: unset -> true, '' -> true, '0' -> false,
+ *   anything else -> true. `loopGate()` below is the canonical preprocessor.
+ *
+ * Discoverability:
+ *   `ENV_VAR_METADATA` is the machine-readable index (name + description +
+ *   default + kind) of all declared knobs. `formatEnvVarTable()` renders it
+ *   for docs / `--help`.
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Loop-gate semantics (must match focus-engine.shouldRunLoop EXACTLY)
+// ---------------------------------------------------------------------------
+/**
+ * Reproduce the canonical opt-out loop-gate semantics as a boolean:
+ *   undefined -> true   (unset: loop fires)
+ *   ''        -> true   (treated like unset)
+ *   '0'       -> false  (explicit opt-out)
+ *   anything  -> true   ('1', 'true', 'yes', etc.)
+ *
+ * Keep this in lockstep with `shouldRunLoop` in
+ * `packages/daemon/src/focus-engine.ts`.
+ */
+export function loopGateEnabled(raw) {
+    if (raw === undefined)
+        return true;
+    if (raw === '')
+        return true;
+    return raw !== '0';
+}
+/**
+ * A Zod schema that parses a raw env string into a loop-gate boolean using
+ * the exact opt-out semantics above. Used for every loop-gate knob.
+ */
+const loopGate = () => z.preprocess((v) => loopGateEnabled(v === undefined ? undefined : String(v)), z.boolean());
+// ---------------------------------------------------------------------------
+// Numeric coercion helpers
+//
+// We hand-write the preprocess so an invalid value produces a CLEAR, ACTIONABLE
+// error that names the offending var (the field key is included by Zod). An
+// empty/unset value falls through to the declared default.
+// ---------------------------------------------------------------------------
+/** Positive integer (> 0). Unset/'' -> default. Non-numeric -> loud error. */
+const positiveInt = (def) => z.preprocess((v) => {
+    if (v === undefined || v === '')
+        return def;
+    const n = Number(v);
+    return n;
+}, z.number({ message: 'must be a number' }).int('must be an integer').positive('must be > 0'));
+/** Positive float (> 0). Unset/'' -> default. Non-numeric -> loud error. */
+const positiveFloat = (def) => z.preprocess((v) => {
+    if (v === undefined || v === '')
+        return def;
+    return Number(v);
+}, z.number({ message: 'must be a number' }).positive('must be > 0'));
+/** TCP port (1..65535). Unset/'' -> default. */
+const port = (def) => z.preprocess((v) => {
+    if (v === undefined || v === '')
+        return def;
+    return Number(v);
+}, z.number({ message: 'must be a number' }).int('must be an integer').min(1, 'must be >= 1').max(65535, 'must be <= 65535'));
+/** Boolean with true/false/1/0 semantics. Unset/'' -> default. */
+const boolEnabled = (def) => z.preprocess((v) => {
+    if (v === undefined || v === '')
+        return def;
+    const s = String(v).toLowerCase();
+    if (s === '0' || s === 'false' || s === 'no')
+        return false;
+    return true;
+}, z.boolean());
+/** Optional string (undefined when unset/''); never errors. */
+const optionalString = () => z.preprocess((v) => (v === undefined || v === '' ? undefined : String(v)), z.string().optional());
+/** String with a default when unset/''. */
+const stringDefault = (def) => z.preprocess((v) => (v === undefined || v === '' ? def : String(v)), z.string());
+/** Enum string with a default. Inference preserves the literal union. */
+const enumDefault = (values, def) => z.preprocess((v) => (v === undefined || v === '' ? def : String(v)), z.enum(values));
+// ---------------------------------------------------------------------------
+// Schema + metadata, declared together so they cannot drift.
+//
+// Loop gates -- opt-out (unset/''/other -> on, '0' -> off):
+// ---------------------------------------------------------------------------
+const schemaShape = {
+    // ── Loop gates (opt-out: '0' disables, everything else enables) ──
+    TELORA_FOCUS_LOOP: loopGate(),
+    TELORA_VERIFICATION_LOOP: loopGate(),
+    TELORA_MERGE_BACK_LOOP: loopGate(),
+    TELORA_FRT_PROSE_LOOP: loopGate(),
+    TELORA_PRD_LOOP: loopGate(),
+    TELORA_DRIFT_EVAL_LOOP: loopGate(),
+    TELORA_SECURITY_SCAN_LOOP: loopGate(),
+    // ── Loop / scan cadence + bounds ──
+    TELORA_SECURITY_SCAN_INTERVAL_HOURS: positiveFloat(24),
+    TELORA_STUCK_BRANCH_THRESHOLD_HOURS: positiveFloat(24),
+    TELORA_REVIEW_REMEDIATION_LIMIT: positiveInt(3),
+    TELORA_SCOPE_COVERAGE_NO_PROGRESS_LIMIT: positiveInt(3),
+    // ── Branch / path / registry ──
+    TELORA_WORKTREE_DIR: optionalString(),
+    TELORA_INTEGRATION_BRANCH: stringDefault('integration'),
+    TELORA_POLICY_FAILURE_MODE: enumDefault(['fail-open', 'fail-closed'], 'fail-open'),
+    TELORA_REGISTRY_URL: stringDefault('https://registry.npmjs.org/'),
+    // ── Telemetry / OTLP receiver ──
+    TELORA_TELEMETRY_ENABLED: boolEnabled(true),
+    TELORA_TELEMETRY_PORT: port(4318),
+    TELORA_TELEMETRY_FLUSH_INTERVAL_MS: positiveInt(5000),
+    TELORA_TELEMETRY_RETENTION_DAYS: positiveInt(30),
+    // ── Session / cost limits (non-prefixed operational vars) ──
+    MAX_TOTAL_SESSIONS: positiveInt(5),
+    TOKEN_LIMIT: positiveInt(200000),
+    COST_LIMIT: positiveFloat(10.0),
+    MERGE_LOCK_TIMEOUT_MS: positiveInt(300000),
+    MERGE_LOCK_CONTENTION_WARNING_MS: positiveInt(30000),
+    // ── Log retention ──
+    LOG_MAX_AGE_DAYS: positiveInt(7),
+    LOG_MAX_TOTAL_BYTES: positiveInt(1073741824),
+    LOG_MAX_FILES: positiveInt(500),
+};
+const EnvConfigSchema = z.object(schemaShape);
+/**
+ * Machine-readable index of every declared knob -- the discoverability surface.
+ * Order mirrors the schema declaration above.
+ */
+export const ENV_VAR_METADATA = Object.freeze([
+    { name: 'TELORA_FOCUS_LOOP', field: 'TELORA_FOCUS_LOOP', kind: 'loop-gate', default: true, description: 'Differential focus loop tick (opt-out: 0 disables).' },
+    { name: 'TELORA_VERIFICATION_LOOP', field: 'TELORA_VERIFICATION_LOOP', kind: 'loop-gate', default: true, description: 'Pluggable per-delivery verification tick (opt-out: 0 disables).' },
+    { name: 'TELORA_MERGE_BACK_LOOP', field: 'TELORA_MERGE_BACK_LOOP', kind: 'loop-gate', default: true, description: 'Continuous merge-back recovery tick (opt-out: 0 disables).' },
+    { name: 'TELORA_FRT_PROSE_LOOP', field: 'TELORA_FRT_PROSE_LOOP', kind: 'loop-gate', default: true, description: 'Eager FRT cascade-prose reconciliation tick (opt-out: 0 disables).' },
+    { name: 'TELORA_PRD_LOOP', field: 'TELORA_PRD_LOOP', kind: 'loop-gate', default: true, description: 'PRD-lifecycle controller tick; arms PRT frontier foci (opt-out: 0 disables).' },
+    { name: 'TELORA_DRIFT_EVAL_LOOP', field: 'TELORA_DRIFT_EVAL_LOOP', kind: 'loop-gate', default: true, description: 'Reality-tree drift evaluation tick (opt-out: 0 disables).' },
+    { name: 'TELORA_SECURITY_SCAN_LOOP', field: 'TELORA_SECURITY_SCAN_LOOP', kind: 'loop-gate', default: true, description: 'Pluggable security scanner engine tick (opt-out: 0 disables).' },
+    { name: 'TELORA_SECURITY_SCAN_INTERVAL_HOURS', field: 'TELORA_SECURITY_SCAN_INTERVAL_HOURS', kind: 'float', default: 24, description: 'Cadence (hours) of the security scan loop.' },
+    { name: 'TELORA_STUCK_BRANCH_THRESHOLD_HOURS', field: 'TELORA_STUCK_BRANCH_THRESHOLD_HOURS', kind: 'float', default: 24, description: 'Hours a focus branch may lead integration before a stuck_focus_branch escalation.' },
+    { name: 'TELORA_REVIEW_REMEDIATION_LIMIT', field: 'TELORA_REVIEW_REMEDIATION_LIMIT', kind: 'int', default: 3, description: 'Cap on review remediation cycles before escalation.' },
+    { name: 'TELORA_SCOPE_COVERAGE_NO_PROGRESS_LIMIT', field: 'TELORA_SCOPE_COVERAGE_NO_PROGRESS_LIMIT', kind: 'int', default: 3, description: 'Cap on consecutive no-progress re-engagement cycles before scope-coverage escalation.' },
+    { name: 'TELORA_WORKTREE_DIR', field: 'TELORA_WORKTREE_DIR', kind: 'string', default: undefined, description: 'Override directory for parallel agent worktrees (default: <repo>/.telora/worktrees).' },
+    { name: 'TELORA_INTEGRATION_BRANCH', field: 'TELORA_INTEGRATION_BRANCH', kind: 'string', default: 'integration', description: 'Branch agents merge into on success before human promotion to main.' },
+    { name: 'TELORA_POLICY_FAILURE_MODE', field: 'TELORA_POLICY_FAILURE_MODE', kind: 'enum', default: 'fail-open', description: 'Guard failure mode: fail-open (default) or fail-closed.' },
+    { name: 'TELORA_REGISTRY_URL', field: 'TELORA_REGISTRY_URL', kind: 'string', default: 'https://registry.npmjs.org/', description: 'npm registry the update check targets (LAN/dev override).' },
+    { name: 'TELORA_TELEMETRY_ENABLED', field: 'TELORA_TELEMETRY_ENABLED', kind: 'bool', default: true, description: 'Enable the OTLP telemetry receiver (false/0 disables).' },
+    { name: 'TELORA_TELEMETRY_PORT', field: 'TELORA_TELEMETRY_PORT', kind: 'port', default: 4318, description: 'TCP port for the OTLP telemetry receiver.' },
+    { name: 'TELORA_TELEMETRY_FLUSH_INTERVAL_MS', field: 'TELORA_TELEMETRY_FLUSH_INTERVAL_MS', kind: 'int', default: 5000, description: 'Telemetry buffer flush interval (ms).' },
+    { name: 'TELORA_TELEMETRY_RETENTION_DAYS', field: 'TELORA_TELEMETRY_RETENTION_DAYS', kind: 'int', default: 30, description: 'Telemetry retention window (days).' },
+    { name: 'MAX_TOTAL_SESSIONS', field: 'MAX_TOTAL_SESSIONS', kind: 'int', default: 5, description: 'Max concurrent focus agent sessions.' },
+    { name: 'TOKEN_LIMIT', field: 'TOKEN_LIMIT', kind: 'int', default: 200000, description: 'Per-session token budget.' },
+    { name: 'COST_LIMIT', field: 'COST_LIMIT', kind: 'float', default: 10.0, description: 'Per-session cost budget (USD).' },
+    { name: 'MERGE_LOCK_TIMEOUT_MS', field: 'MERGE_LOCK_TIMEOUT_MS', kind: 'int', default: 300000, description: 'Max wait (ms) to acquire the merge lock.' },
+    { name: 'MERGE_LOCK_CONTENTION_WARNING_MS', field: 'MERGE_LOCK_CONTENTION_WARNING_MS', kind: 'int', default: 30000, description: 'Warn threshold (ms) when contending for the merge lock.' },
+    { name: 'LOG_MAX_AGE_DAYS', field: 'LOG_MAX_AGE_DAYS', kind: 'int', default: 7, description: 'Max age (days) of retained agent logs.' },
+    { name: 'LOG_MAX_TOTAL_BYTES', field: 'LOG_MAX_TOTAL_BYTES', kind: 'int', default: 1073741824, description: 'Max total bytes of retained agent logs.' },
+    { name: 'LOG_MAX_FILES', field: 'LOG_MAX_FILES', kind: 'int', default: 500, description: 'Max number of retained agent log files.' },
+]);
+// ---------------------------------------------------------------------------
+// Loader
+// ---------------------------------------------------------------------------
+let cached = null;
+/**
+ * Parse + validate the operational env config ONCE and return a typed, frozen
+ * object. On invalid input, throws a CLEAR, ACTIONABLE error naming each
+ * offending variable and what was expected -- so a typo'd MERGE_LOCK_TIMEOUT_MS
+ * or a non-numeric TELORA_TELEMETRY_PORT fails loudly at startup rather than
+ * silently at runtime.
+ *
+ * @param env Env source (defaults to process.env). When omitted, the result is
+ *            memoized; pass an explicit env (e.g. in tests) to bypass the cache.
+ */
+export function loadEnvConfig(env) {
+    const useCache = env === undefined;
+    if (useCache && cached)
+        return cached;
+    const source = env ?? process.env;
+    // Pick only the declared keys so unrelated env vars cannot interfere.
+    const input = {};
+    for (const meta of ENV_VAR_METADATA) {
+        input[meta.name] = source[meta.name];
+    }
+    const result = EnvConfigSchema.safeParse(input);
+    if (!result.success) {
+        const lines = result.error.issues.map((issue) => {
+            const varName = String(issue.path[0] ?? '(unknown)');
+            const got = source[varName];
+            return `  - ${varName}: ${issue.message} (got: ${JSON.stringify(got)})`;
+        });
+        throw new Error(`Invalid daemon environment configuration (${result.error.issues.length} error(s)):\n` +
+            lines.join('\n') +
+            '\nRun the daemon with corrected values, or unset the variable to use its default.');
+    }
+    const frozen = Object.freeze(result.data);
+    if (useCache)
+        cached = frozen;
+    return frozen;
+}
+/** Test-only: clear the memoized config so a later load re-reads process.env. */
+export function resetEnvConfigCache() {
+    cached = null;
+}
+/**
+ * Render the knob index as a human-readable table (for docs / --help output).
+ * This is the discoverable list of every operational env var.
+ */
+export function formatEnvVarTable() {
+    const rows = ENV_VAR_METADATA.map((m) => {
+        const def = m.default === undefined ? '(none)' : String(m.default);
+        return `${m.name}\t[${m.kind}, default ${def}]\t${m.description}`;
+    });
+    return ['Operational environment variables:', ...rows].join('\n');
+}
+//# sourceMappingURL=env-config.js.map

package/dist/env-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-config.js","sourceRoot":"","sources":["../src/env-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,sEAAsE;AACtE,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,GAAuB;IACrD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,GAAG,KAAK,GAAG,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,QAAQ,GAAG,GAAuB,EAAE,CACxC,CAAC,CAAC,UAAU,CACV,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAC/D,CAAC,CAAC,OAAO,EAAE,CACqB,CAAC;AAErC,8EAA8E;AAC9E,2BAA2B;AAC3B,EAAE;AACF,gFAAgF;AAChF,4EAA4E;AAC5E,2DAA2D;AAC3D,8EAA8E;AAE9E,8EAA8E;AAC9E,MAAM,WAAW,GAAG,CAAC,GAAW,EAAqB,EAAE,CACrD,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,CAAC,CAAC;AACX,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;AAElG,4EAA4E;AAC5E,MAAM,aAAa,GAAG,CAAC,GAAW,EAAqB,EAAE,CACvD,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5C,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;AAExE,gDAAgD;AAChD,MAAM,IAAI,GAAG,CAAC,GAAW,EAAqB,EAAE,CAC9C,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5C,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAEhI,kEAAkE;AAClE,MAAM,WAAW,GAAG,CAAC,GAAY,EAAsB,EAAE,CACvD,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE;IACjB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAClC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAElB,+DAA+D;AAC/D,MAAM,cAAc,GAAG,GAAkC,EAAE,CACzD,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;AAEpG,2CAA2C;AAC3C,MAAM,aAAa,GAAG,CAAC,GAAW,EAAqB,EAAE,CACvD,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAEnF,yEAAyE;AACzE,MAAM,WAAW,GAAG,CAA2C,MAAS,EAAE,GAAc,EAAE,EAAE,CAC1F,CAAC,CAAC,UAAU,CACV,CAAC,CAAC,EAAa,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAE,MAAM,CAAC,CAAC,CAAe,CAAC,EAChF,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CACf,CAAC;AAqBJ,8EAA8E;AAC9E,6DAA6D;AAC7D,EAAE;AACF,4DAA4D;AAC5D,8EAA8E;AAE9E,MAAM,WAAW,GAAG;IAClB,oEAAoE;IACpE,iBAAiB,EAAE,QAAQ,EAAE;IAC7B,wBAAwB,EAAE,QAAQ,EAAE;IACpC,sBAAsB,EAAE,QAAQ,EAAE;IAClC,qBAAqB,EAAE,QAAQ,EAAE;IACjC,eAAe,EAAE,QAAQ,EAAE;IAC3B,sBAAsB,EAAE,QAAQ,EAAE;IAClC,yBAAyB,EAAE,QAAQ,EAAE;IAErC,qCAAqC;IACrC,mCAAmC,EAAE,aAAa,CAAC,EAAE,CAAC;IACtD,mCAAmC,EAAE,aAAa,CAAC,EAAE,CAAC;IACtD,+BAA+B,EAAE,WAAW,CAAC,CAAC,CAAC;IAC/C,uCAAuC,EAAE,WAAW,CAAC,CAAC,CAAC;IAEvD,iCAAiC;IACjC,mBAAmB,EAAE,cAAc,EAAE;IACrC,yBAAyB,EAAE,aAAa,CAAC,aAAa,CAAC;IACvD,0BAA0B,EAAE,WAAW,CAAC,CAAC,WAAW,EAAE,aAAa,CAAC,EAAE,WAAW,CAAC;IAClF,mBAAmB,EAAE,aAAa,CAAC,6BAA6B,CAAC;IAEjE,kCAAkC;IAClC,wBAAwB,EAAE,WAAW,CAAC,IAAI,CAAC;IAC3C,qBAAqB,EAAE,IAAI,CAAC,IAAI,CAAC;IACjC,kCAAkC,EAAE,WAAW,CAAC,IAAI,CAAC;IACrD,+BAA+B,EAAE,WAAW,CAAC,EAAE,CAAC;IAEhD,8DAA8D;IAC9D,kBAAkB,EAAE,WAAW,CAAC,CAAC,CAAC;IAClC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC;IAChC,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC;IAC/B,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAC;IAC1C,gCAAgC,EAAE,WAAW,CAAC,KAAK,CAAC;IAEpD,sBAAsB;IACtB,gBAAgB,EAAE,WAAW,CAAC,CAAC,CAAC;IAChC,mBAAmB,EAAE,WAAW,CAAC,UAAU,CAAC;IAC5C,aAAa,EAAE,WAAW,CAAC,GAAG,CAAC;CACvB,CAAC;AAEX,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAK9C;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA0B,MAAM,CAAC,MAAM,CAAC;IACnE,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,qDAAqD,EAAE;IAC/J,EAAE,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,0BAA0B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,iEAAiE,EAAE;IACzL,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,4DAA4D,EAAE;IAChL,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,oEAAoE,EAAE;IACtL,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,8EAA8E,EAAE;IACpL,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,2DAA2D,EAAE;IAC/K,EAAE,IAAI,EAAE,2BAA2B,EAAE,KAAK,EAAE,2BAA2B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,+DAA+D,EAAE;IAEzL,EAAE,IAAI,EAAE,qCAAqC,EAAE,KAAK,EAAE,qCAAqC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,4CAA4C,EAAE;IACpL,EAAE,IAAI,EAAE,qCAAqC,EAAE,KAAK,EAAE,qCAAqC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,mFAAmF,EAAE;IAC3N,EAAE,IAAI,EAAE,iCAAiC,EAAE,KAAK,EAAE,iCAAiC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,qDAAqD,EAAE;IAClL,EAAE,IAAI,EAAE,yCAAyC,EAAE,KAAK,EAAE,yCAAyC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,uFAAuF,EAAE;IAEpO,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,sFAAsF,EAAE;IACtM,EAAE,IAAI,EAAE,2BAA2B,EAAE,KAAK,EAAE,2BAA2B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,qEAAqE,EAAE;IACrM,EAAE,IAAI,EAAE,4BAA4B,EAAE,KAAK,EAAE,4BAA4B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,yDAAyD,EAAE;IACvL,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,6BAA6B,EAAE,WAAW,EAAE,2DAA2D,EAAE;IAE/L,EAAE,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,0BAA0B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,wDAAwD,EAAE;IAC3K,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,2CAA2C,EAAE;IACxJ,EAAE,IAAI,EAAE,oCAAoC,EAAE,KAAK,EAAE,oCAAoC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,uCAAuC,EAAE;IAC7K,EAAE,IAAI,EAAE,iCAAiC,EAAE,KAAK,EAAE,iCAAiC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,oCAAoC,EAAE;IAElK,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,sCAAsC,EAAE;IACzI,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,2BAA2B,EAAE;IACrH,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,gCAAgC,EAAE;IACxH,EAAE,IAAI,EAAE,uBAAuB,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,0CAA0C,EAAE;IACxJ,EAAE,IAAI,EAAE,kCAAkC,EAAE,KAAK,EAAE,kCAAkC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,yDAAyD,EAAE;IAE5L,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,wCAAwC,EAAE;IACvI,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,yCAAyC,EAAE;IACvJ,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,yCAAyC,EAAE;CACrI,CAAC,CAAC;AAEH,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,IAAI,MAAM,GAAqB,IAAI,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,GAAuB;IACnD,MAAM,QAAQ,GAAG,GAAG,KAAK,SAAS,CAAC;IACnC,IAAI,QAAQ,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAEtC,MAAM,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IAElC,sEAAsE;IACtE,MAAM,KAAK,GAAuC,EAAE,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC;YACrD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,OAAO,OAAO,KAAK,KAAK,CAAC,OAAO,UAAU,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;QAC1E,CAAC,CAAC,CAAC;QACH,MAAM,IAAI,KAAK,CACb,6CAA6C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,eAAe;YACtF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YAChB,mFAAmF,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,QAAQ;QAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,mBAAmB;IACjC,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACtC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACnE,OAAO,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,aAAa,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IACpE,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,oCAAoC,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC"}

package/dist/execution-status.d.ts

@@ -16,5 +16,50 @@
  */
 export declare const EXECUTION_STATUSES: readonly ["draft", "planning", "queued", "coding", "verify", "verify_failed", "done", "paused", "cancelled"];
 export type ExecutionStatus = (typeof EXECUTION_STATUSES)[number];
+/**
+ * Named constants for each delivery execution-status value.
+ *
+ * Consumers (daemon, frontend, MCP) compare against these instead of writing
+ * bare string literals like `=== 'verify'`. This is what makes the vocabulary
+ * a SINGLE source of truth at the USE site, not just the definition site, and
+ * it is what `scripts/lint-vocabulary.mjs` enforces: a bare status literal in a
+ * comparison outside this module is a drift risk; `DELIVERY_STATUS.VERIFY` is
+ * not. A typo (`DELIVERY_STATUS.VERFY`) fails to compile.
+ */
+export declare const DELIVERY_STATUS: {
+    readonly DRAFT: "draft";
+    readonly PLANNING: "planning";
+    readonly QUEUED: "queued";
+    readonly CODING: "coding";
+    readonly VERIFY: "verify";
+    readonly VERIFY_FAILED: "verify_failed";
+    readonly DONE: "done";
+    readonly PAUSED: "paused";
+    readonly CANCELLED: "cancelled";
+};
 export declare function isExecutionStatus(value: unknown): value is ExecutionStatus;
+/**
+ * Machine-readable delivery execution-status state machine.
+ *
+ * This is the canonical, single-source map of the LIFECYCLE transitions the
+ * daemon drives (root CLAUDE.md "Delivery Lifecycle"):
+ *   - main path:        queued -> coding -> verify -> done
+ *   - re-iteration:     verify -> verify_failed -> queued (-> coding -> verify)
+ *   - exits:            active states -> paused / cancelled
+ *   - revival:          paused -> queued/coding, cancelled -> draft/queued
+ *   - planning entry:   draft -> planning -> queued
+ *
+ * NOTE: this is distinct from the frontend's DELIVERY_STATUS_TRANSITIONS, which
+ * is a MANUAL UI-affordance map (which transitions a human may click in the UI)
+ * -- it deliberately omits automatic transitions like queued -> coding (driven
+ * by a DB trigger, not a human). That manual map is a presentation concern and
+ * stays local to the frontend. This map is the actual state machine, the thing
+ * an AI must be able to read to reason about the lifecycle holistically.
+ */
+export declare const EXECUTION_STATUS_TRANSITIONS: Record<ExecutionStatus, readonly ExecutionStatus[]>;
+/**
+ * True iff `to` is a permitted next state from `from` per the canonical
+ * delivery state machine.
+ */
+export declare function isValidTransition(from: ExecutionStatus, to: ExecutionStatus): boolean;
 //# sourceMappingURL=execution-status.d.ts.map

package/dist/execution-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution-status.d.ts","sourceRoot":"","sources":["../src/execution-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,kBAAkB,8GAUrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAK1E"}
+{"version":3,"file":"execution-status.d.ts","sourceRoot":"","sources":["../src/execution-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,kBAAkB,8GAUrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;CAUwB,CAAC;AAErD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAK1E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAC/C,eAAe,EACf,SAAS,eAAe,EAAE,CAW3B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,eAAe,GAClB,OAAO,CAET"}

package/dist/execution-status.js

@@ -25,8 +25,65 @@ export const EXECUTION_STATUSES = [
     'paused',
     'cancelled',
 ];
+/**
+ * Named constants for each delivery execution-status value.
+ *
+ * Consumers (daemon, frontend, MCP) compare against these instead of writing
+ * bare string literals like `=== 'verify'`. This is what makes the vocabulary
+ * a SINGLE source of truth at the USE site, not just the definition site, and
+ * it is what `scripts/lint-vocabulary.mjs` enforces: a bare status literal in a
+ * comparison outside this module is a drift risk; `DELIVERY_STATUS.VERIFY` is
+ * not. A typo (`DELIVERY_STATUS.VERFY`) fails to compile.
+ */
+export const DELIVERY_STATUS = {
+    DRAFT: 'draft',
+    PLANNING: 'planning',
+    QUEUED: 'queued',
+    CODING: 'coding',
+    VERIFY: 'verify',
+    VERIFY_FAILED: 'verify_failed',
+    DONE: 'done',
+    PAUSED: 'paused',
+    CANCELLED: 'cancelled',
+};
 export function isExecutionStatus(value) {
     return (typeof value === 'string' &&
         EXECUTION_STATUSES.includes(value));
 }
+/**
+ * Machine-readable delivery execution-status state machine.
+ *
+ * This is the canonical, single-source map of the LIFECYCLE transitions the
+ * daemon drives (root CLAUDE.md "Delivery Lifecycle"):
+ *   - main path:        queued -> coding -> verify -> done
+ *   - re-iteration:     verify -> verify_failed -> queued (-> coding -> verify)
+ *   - exits:            active states -> paused / cancelled
+ *   - revival:          paused -> queued/coding, cancelled -> draft/queued
+ *   - planning entry:   draft -> planning -> queued
+ *
+ * NOTE: this is distinct from the frontend's DELIVERY_STATUS_TRANSITIONS, which
+ * is a MANUAL UI-affordance map (which transitions a human may click in the UI)
+ * -- it deliberately omits automatic transitions like queued -> coding (driven
+ * by a DB trigger, not a human). That manual map is a presentation concern and
+ * stays local to the frontend. This map is the actual state machine, the thing
+ * an AI must be able to read to reason about the lifecycle holistically.
+ */
+export const EXECUTION_STATUS_TRANSITIONS = {
+    draft: ['planning', 'queued', 'cancelled'],
+    planning: ['queued', 'cancelled'],
+    queued: ['coding', 'paused', 'cancelled'],
+    coding: ['verify', 'paused', 'cancelled'],
+    verify: ['done', 'verify_failed', 'paused', 'cancelled'],
+    verify_failed: ['queued', 'coding', 'cancelled'],
+    done: ['verify_failed', 'verify'],
+    paused: ['queued', 'coding', 'cancelled'],
+    cancelled: ['draft', 'queued'],
+};
+/**
+ * True iff `to` is a permitted next state from `from` per the canonical
+ * delivery state machine.
+ */
+export function isValidTransition(from, to) {
+    return EXECUTION_STATUS_TRANSITIONS[from]?.includes(to) ?? false;
+}
 //# sourceMappingURL=execution-status.js.map

package/dist/execution-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution-status.js","sourceRoot":"","sources":["../src/execution-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO;IACP,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,eAAe;IACf,MAAM;IACN,QAAQ;IACR,WAAW;CACH,CAAC;AAIX,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,kBAAwC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC1D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"execution-status.js","sourceRoot":"","sources":["../src/execution-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO;IACP,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,eAAe;IACf,MAAM;IACN,QAAQ;IACR,WAAW;CACH,CAAC;AAIX;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,aAAa,EAAE,eAAe;IAC9B,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;CAC4B,CAAC;AAErD,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,kBAAwC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAGrC;IACF,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC;IAC1C,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;IACjC,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC;IACzC,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC;IACzC,MAAM,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,CAAC;IACxD,aAAa,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC;IAChD,IAAI,EAAE,CAAC,eAAe,EAAE,QAAQ,CAAC;IACjC,MAAM,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC;IACzC,SAAS,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;CAC/B,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAqB,EACrB,EAAmB;IAEnB,OAAO,4BAA4B,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;AACnE,CAAC"}

package/dist/focus-stage.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Canonical focus-stage vocabulary for product_focuses.stage.
+ *
+ * Distinct from focus STATUS (focus-status.ts): status is the human-set intent
+ * lifecycle (proposed -> active -> complete | cancelled), while STAGE is the
+ * workflow-execution axis the daemon derives from a focus's delivery aggregate
+ * (planning -> queued -> in_progress -> verify -> review -> close_loop -> done,
+ * plus the blocked exit). Backed by the `product_focuses.stage` text column.
+ *
+ * Source of truth shared by @telora/daemon, @telora/mcp-products, and the
+ * frontend (src/types/focus.ts) so the runtimes cannot drift on what stages
+ * exist or which of them count as "past planning".
+ */
+export declare const FOCUS_STAGES: readonly ["planning", "queued", "in_progress", "verify", "review", "close_loop", "done", "blocked"];
+export type FocusStage = (typeof FOCUS_STAGES)[number];
+/**
+ * Named constants for each focus-stage value. Consumers compare against these
+ * instead of bare literals (`focus.stage === 'close_loop'`) so the use site
+ * references the single source of truth and a typo fails to compile. Enforced
+ * by scripts/lint-vocabulary.mjs.
+ */
+export declare const FOCUS_STAGE: {
+    readonly PLANNING: "planning";
+    readonly QUEUED: "queued";
+    readonly IN_PROGRESS: "in_progress";
+    readonly VERIFY: "verify";
+    readonly REVIEW: "review";
+    readonly CLOSE_LOOP: "close_loop";
+    readonly DONE: "done";
+    readonly BLOCKED: "blocked";
+};
+export declare function isFocusStage(value: unknown): value is FocusStage;
+/**
+ * Focus stages past the planning phase. When a delivery is created on a focus
+ * already in one of these stages, the daemon's poll loop expects new work to
+ * land in 'queued' so a team can pick it up -- defaulting to 'planning' would
+ * leave the row invisible. Canonical home for the set previously hardcoded in
+ * mcp/telora-products/src/handlers/deliveryHandlers.ts.
+ */
+export declare const POST_PLANNING_FOCUS_STAGES: ReadonlySet<FocusStage>;
+/** True iff `stage` is a focus stage past the planning phase. */
+export declare function isPostPlanning(stage: unknown): boolean;
+//# sourceMappingURL=focus-stage.d.ts.map

package/dist/focus-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-stage.d.ts","sourceRoot":"","sources":["../src/focus-stage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,YAAY,qGASf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;;;;CASuB,CAAC;AAEhD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAKhE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,UAAU,CAM7D,CAAC;AAEH,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEtD"}

package/dist/focus-stage.js

@@ -0,0 +1,62 @@
+/**
+ * Canonical focus-stage vocabulary for product_focuses.stage.
+ *
+ * Distinct from focus STATUS (focus-status.ts): status is the human-set intent
+ * lifecycle (proposed -> active -> complete | cancelled), while STAGE is the
+ * workflow-execution axis the daemon derives from a focus's delivery aggregate
+ * (planning -> queued -> in_progress -> verify -> review -> close_loop -> done,
+ * plus the blocked exit). Backed by the `product_focuses.stage` text column.
+ *
+ * Source of truth shared by @telora/daemon, @telora/mcp-products, and the
+ * frontend (src/types/focus.ts) so the runtimes cannot drift on what stages
+ * exist or which of them count as "past planning".
+ */
+export const FOCUS_STAGES = [
+    'planning',
+    'queued',
+    'in_progress',
+    'verify',
+    'review',
+    'close_loop',
+    'done',
+    'blocked',
+];
+/**
+ * Named constants for each focus-stage value. Consumers compare against these
+ * instead of bare literals (`focus.stage === 'close_loop'`) so the use site
+ * references the single source of truth and a typo fails to compile. Enforced
+ * by scripts/lint-vocabulary.mjs.
+ */
+export const FOCUS_STAGE = {
+    PLANNING: 'planning',
+    QUEUED: 'queued',
+    IN_PROGRESS: 'in_progress',
+    VERIFY: 'verify',
+    REVIEW: 'review',
+    CLOSE_LOOP: 'close_loop',
+    DONE: 'done',
+    BLOCKED: 'blocked',
+};
+export function isFocusStage(value) {
+    return (typeof value === 'string' &&
+        FOCUS_STAGES.includes(value));
+}
+/**
+ * Focus stages past the planning phase. When a delivery is created on a focus
+ * already in one of these stages, the daemon's poll loop expects new work to
+ * land in 'queued' so a team can pick it up -- defaulting to 'planning' would
+ * leave the row invisible. Canonical home for the set previously hardcoded in
+ * mcp/telora-products/src/handlers/deliveryHandlers.ts.
+ */
+export const POST_PLANNING_FOCUS_STAGES = new Set([
+    'queued',
+    'in_progress',
+    'verify',
+    'review',
+    'close_loop',
+]);
+/** True iff `stage` is a focus stage past the planning phase. */
+export function isPostPlanning(stage) {
+    return isFocusStage(stage) && POST_PLANNING_FOCUS_STAGES.has(stage);
+}
+//# sourceMappingURL=focus-stage.js.map

package/dist/focus-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-stage.js","sourceRoot":"","sources":["../src/focus-stage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,UAAU;IACV,QAAQ;IACR,aAAa;IACb,QAAQ;IACR,QAAQ;IACR,YAAY;IACZ,MAAM;IACN,SAAS;CACD,CAAC;AAIX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;CAC2B,CAAC;AAEhD,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,YAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CACpD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAA4B,IAAI,GAAG,CAAa;IACrF,QAAQ;IACR,aAAa;IACb,QAAQ;IACR,QAAQ;IACR,YAAY;CACb,CAAC,CAAC;AAEH,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,0BAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC"}

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export { type AgentEvent, type AgentEventParser, type AgentSessionStartedEvent,
 export { ClaudeAgentParser, extractFilePath, } from './claude-agent-parser.js';
 export { CodexAgentParser, } from './codex-agent-parser.js';
 export { UUID_REGEX, loadConfigFile, productLabel, resolveBaseConfig, validateBaseConfig, type BaseConfig, type ProductEntry, } from './config.js';
+export { ENV_VAR_METADATA, formatEnvVarTable, loadEnvConfig, loopGateEnabled, resetEnvConfigCache, type EnvConfig, type EnvVarKind, type EnvVarMeta, } from './env-config.js';
 export { PidLockError, ShutdownController, acquirePidLock, isProcessRunning, releasePidLock, setupSignalHandlers, type ShutdownHandler, } from './lifecycle.js';
 export { DEFAULT_GIT_TIMEOUT_MS, branchExists, runGit, type GitResult, } from './git.js';
 export { commitWip, createWorktreeBase, pruneWorktrees, removeWorktreeBase, worktreeExistsForBranch, type CreateWorktreeResult, } from './worktree.js';
@@ -18,8 +19,9 @@ export { formatEventForLog, } from './event-logger.js';
 export { ActivityTracker, type ActivitySnapshot, } from './activity-tracker.js';
 export { buildOtelEnv, type BuildOtelEnvOptions, } from './otel-env.js';
 export { ESCALATION_REASONS, ESCALATION_KINDS, type EscalationReasonType, type EscalationKind, } from './escalation-types.js';
-export { EXECUTION_STATUSES, isExecutionStatus, type ExecutionStatus, } from './execution-status.js';
+export { DELIVERY_STATUS, EXECUTION_STATUSES, EXECUTION_STATUS_TRANSITIONS, isExecutionStatus, isValidTransition, type ExecutionStatus, } from './execution-status.js';
 export { FOCUS_STATUSES, isFocusStatus, type FocusStatus, } from './focus-status.js';
+export { FOCUS_STAGE, FOCUS_STAGES, isFocusStage, isPostPlanning, POST_PLANNING_FOCUS_STAGES, type FocusStage, } from './focus-stage.js';
 export { PRODUCT_STATUSES, isProductStatus, type ProductStatus, } from './product-status.js';
 export { extractSessionKey, pruneOldLogs, scanLogDirectory, type LogFileInfo, type LogManagerDeps, type LogRetentionConfig, type PruneResult, } from './log-manager.js';
 export { buildMcpConfig, isLegacyMcpConfigShape, resolveMcpServerPath, writeMcpConfigFile, MCP_PRODUCTS_PACKAGE, MCP_PRODUCTS_BIN, type McpConfigOptions, } from './mcp-resolution.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,kBAAkB,EAClB,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,aAAa,EACb,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,iBAAiB,EACjB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,MAAM,EACN,KAAK,SAAS,GACf,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,eAAe,EACf,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,4BAA4B,EAC5B,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,0BAA0B,EAC1B,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -15,6 +15,8 @@ export { ClaudeAgentParser, extractFilePath, } from './claude-agent-parser.js';
 export { CodexAgentParser, } from './codex-agent-parser.js';
 // Shared config infrastructure (BaseConfig, loaders, validators)
 export { UUID_REGEX, loadConfigFile, productLabel, resolveBaseConfig, validateBaseConfig, } from './config.js';
+// Typed operational env config (the discoverable index of every daemon knob)
+export { ENV_VAR_METADATA, formatEnvVarTable, loadEnvConfig, loopGateEnabled, resetEnvConfigCache, } from './env-config.js';
 // Process lifecycle (PID locking, signal handling, shutdown coordination)
 export { PidLockError, ShutdownController, acquirePidLock, isProcessRunning, releasePidLock, setupSignalHandlers, } from './lifecycle.js';
 // Git utilities (synchronous git runner, branch helpers)
@@ -35,10 +37,13 @@ export { ActivityTracker, } from './activity-tracker.js';
 export { buildOtelEnv, } from './otel-env.js';
 // Escalation reason types (shared enum/constants for agent_escalations.reason_type)
 export { ESCALATION_REASONS, ESCALATION_KINDS, } from './escalation-types.js';
-// Execution status enum (shared source of truth for product_deliveries.execution_status)
-export { EXECUTION_STATUSES, isExecutionStatus, } from './execution-status.js';
+// Execution status enum + transition map (shared source of truth for
+// product_deliveries.execution_status and its state machine)
+export { DELIVERY_STATUS, EXECUTION_STATUSES, EXECUTION_STATUS_TRANSITIONS, isExecutionStatus, isValidTransition, } from './execution-status.js';
 // Focus status enum (shared source of truth for product_focuses.status)
 export { FOCUS_STATUSES, isFocusStatus, } from './focus-status.js';
+// Focus stage vocabulary (shared source of truth for product_focuses.stage)
+export { FOCUS_STAGE, FOCUS_STAGES, isFocusStage, isPostPlanning, POST_PLANNING_FOCUS_STAGES, } from './focus-stage.js';
 // Product status enum (shared source of truth for products.status)
 export { PRODUCT_STATUSES, isProductStatus, } from './product-status.js';
 // Log manager (retention policy and pruning for agent log files)

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,4EAA4E;AAE5E,OAAO,EACL,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,yBAAyB,EAIzB,kBAAkB,EAClB,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,SAAS,GAEV,MAAM,iBAAiB,CAAC;AAEzB,2DAA2D;AAC3D,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,cAAc,GAGf,MAAM,iBAAiB,CAAC;AAEzB,6DAA6D;AAC7D,OAAO,EACL,eAAe,EACf,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,qDAAqD;AACrD,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,aAAa,GAEd,MAAM,kBAAkB,CAAC;AAE1B,iFAAiF;AACjF,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,GAqBZ,MAAM,kBAAkB,CAAC;AAc1B,wDAAwD;AACxD,OAAO,EACL,iBAAiB,EACjB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAElC,8DAA8D;AAC9D,OAAO,EACL,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAEjC,iEAAiE;AACjE,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AAErB,0EAA0E;AAC1E,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,mBAAmB,GAEpB,MAAM,gBAAgB,CAAC;AAExB,yDAAyD;AACzD,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,MAAM,GAEP,MAAM,UAAU,CAAC;AAElB,0DAA0D;AAC1D,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,uBAAuB,GAExB,MAAM,eAAe,CAAC;AAEvB,gEAAgE;AAChE,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,sBAAsB,GAGvB,MAAM,YAAY,CAAC;AASpB,iEAAiE;AACjE,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAGlB,MAAM,qBAAqB,CAAC;AAE7B,2EAA2E;AAC3E,OAAO,EACL,gBAAgB,GAGjB,MAAM,wBAAwB,CAAC;AAEhC,0EAA0E;AAC1E,OAAO,EACL,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,4DAA4D;AAC5D,OAAO,EACL,eAAe,GAEhB,MAAM,uBAAuB,CAAC;AAE/B,sFAAsF;AACtF,OAAO,EACL,YAAY,GAEb,MAAM,eAAe,CAAC;AAEvB,oFAAoF;AACpF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GAGjB,MAAM,uBAAuB,CAAC;AAE/B,yFAAyF;AACzF,OAAO,EACL,kBAAkB,EAClB,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AAE/B,wEAAwE;AACxE,OAAO,EACL,cAAc,EACd,aAAa,GAEd,MAAM,mBAAmB,CAAC;AAE3B,mEAAmE;AACnE,OAAO,EACL,gBAAgB,EAChB,eAAe,GAEhB,MAAM,qBAAqB,CAAC;AAE7B,iEAAiE;AACjE,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,GAKjB,MAAM,kBAAkB,CAAC;AAE1B,8CAA8C;AAC9C,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,GAEjB,MAAM,qBAAqB,CAAC;AAE7B,oEAAoE;AACpE,OAAO,EACL,iBAAiB,EACjB,YAAY,GAGb,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/vocabulary.d.ts

@@ -0,0 +1,5 @@
+export { DELIVERY_STATUS, EXECUTION_STATUSES, EXECUTION_STATUS_TRANSITIONS, isExecutionStatus, isValidTransition, type ExecutionStatus, } from './execution-status.js';
+export { FOCUS_STAGE, FOCUS_STAGES, isFocusStage, isPostPlanning, POST_PLANNING_FOCUS_STAGES, type FocusStage, } from './focus-stage.js';
+export { FOCUS_STATUSES, isFocusStatus, type FocusStatus, } from './focus-status.js';
+export { PRODUCT_STATUSES, isProductStatus, type ProductStatus, } from './product-status.js';
+//# sourceMappingURL=vocabulary.d.ts.map

package/dist/vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../src/vocabulary.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,4BAA4B,EAC5B,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,0BAA0B,EAC1B,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,KAAK,aAAa,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/vocabulary.js

@@ -0,0 +1,25 @@
+// @telora/daemon-core/vocabulary -- browser-safe canonical domain vocabulary.
+//
+// This is a PURE re-export barrel of the four domain-vocabulary modules. Unlike
+// the package barrel (index.ts), it pulls in NONE of the Node-only
+// infrastructure (token-usage -> node:stream, git -> node:child_process,
+// worktree/config/log-manager -> node:fs/path/os/module). Its entire transitive
+// import graph is the four modules below, each of which is plain TypeScript with
+// zero `node:` imports -- safe to bundle into the browser frontend.
+//
+// Consumers that run in the browser (the React frontend) import vocabulary from
+// '@telora/daemon-core/vocabulary'. Node consumers (daemon, MCP) keep importing
+// from the package barrel ('@telora/daemon-core'), which re-exports these same
+// symbols alongside the Node infrastructure.
+//
+// If you add a new pure domain-vocabulary module to daemon-core, re-export it
+// here too so the browser-safe surface stays complete.
+// Execution status enum + transition map (product_deliveries.execution_status).
+export { DELIVERY_STATUS, EXECUTION_STATUSES, EXECUTION_STATUS_TRANSITIONS, isExecutionStatus, isValidTransition, } from './execution-status.js';
+// Focus stage vocabulary (product_focuses.stage).
+export { FOCUS_STAGE, FOCUS_STAGES, isFocusStage, isPostPlanning, POST_PLANNING_FOCUS_STAGES, } from './focus-stage.js';
+// Focus status enum (product_focuses.status).
+export { FOCUS_STATUSES, isFocusStatus, } from './focus-status.js';
+// Product status enum (products.status).
+export { PRODUCT_STATUSES, isProductStatus, } from './product-status.js';
+//# sourceMappingURL=vocabulary.js.map

package/dist/vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vocabulary.js","sourceRoot":"","sources":["../src/vocabulary.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,EAAE;AACF,gFAAgF;AAChF,mEAAmE;AACnE,yEAAyE;AACzE,gFAAgF;AAChF,iFAAiF;AACjF,oEAAoE;AACpE,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,6CAA6C;AAC7C,EAAE;AACF,8EAA8E;AAC9E,uDAAuD;AAEvD,gFAAgF;AAChF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,4BAA4B,EAC5B,iBAAiB,EACjB,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AAE/B,kDAAkD;AAClD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,0BAA0B,GAE3B,MAAM,kBAAkB,CAAC;AAE1B,8CAA8C;AAC9C,OAAO,EACL,cAAc,EACd,aAAa,GAEd,MAAM,mBAAmB,CAAC;AAE3B,yCAAyC;AACzC,OAAO,EACL,gBAAgB,EAChB,eAAe,GAEhB,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telora/daemon-core",
-  "version": "0.2.29",
+  "version": "0.2.33",
   "description": "Shared core infrastructure for Telora daemon and factory - resilience, API client, config, git operations",
   "type": "module",
   "main": "dist/index.js",
@@ -9,6 +9,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./vocabulary": {
+      "import": "./dist/vocabulary.js",
+      "types": "./dist/vocabulary.d.ts"
     }
   },
   "files": [