@telora/daemon 0.18.40 → 0.18.55

package/dist/git-genesis.js

@@ -0,0 +1,231 @@
+/**
+ * Starter-repo genesis: seed an EMPTY product repo from a registered, polished
+ * starter the active PRD selected, instead of scaffolding a frontend from zero
+ * (focus 80ecc233).
+ *
+ * When a product's git repo has no commits AND its active PRD carries a
+ * `starterRepoId`, the daemon clones the starter's pinned ref, squashes its
+ * working tree into a fresh INITIAL commit (starter history is NOT inherited),
+ * and records provenance (git URL + resolved sha) both as a `.telora`
+ * metadata file and in the genesis commit trailers. The PRD then runs normally
+ * against that base -- the agent starts ABOVE the UX floor.
+ *
+ * It is a strict NO-OP (returns seeded:false with a reason) when the repo
+ * already has history (greenfield guard), no active PRD selects a starter, or
+ * the selected starter cannot be resolved/cloned -- in every such case the
+ * caller falls back to the empty-initial-commit path.
+ *
+ * Private starters clone via the daemon process's inherited git credentials
+ * (ssh-agent / credential helper) -- no special handling here; `git clone`
+ * runs in the daemon's environment.
+ *
+ * All filesystem + git effects are injectable (GenesisDeps) so the path is
+ * unit-tested against a local fixture starter repo without a live backend.
+ */
+import { mkdtempSync, rmSync, cpSync, writeFileSync, mkdirSync, existsSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, sep } from 'node:path';
+import { runGitSync } from './git-types.js';
+import { repoHasCommits } from './git-branch.js';
+import { loadActivePrds, hasPendingStarterSelection } from './queries/prd.js';
+import { loadStarterRepo, } from './queries/starter-repo.js';
+const defaultDeps = {
+    hasCommits: repoHasCommits,
+    loadActivePrds,
+    loadStarterRepo,
+    hasPendingStarterSelection,
+    runGit: runGitSync,
+    log: (msg) => console.log(msg),
+};
+/**
+ * The placeholder initial-commit message written when an empty repo has no
+ * starter to seed from. Shared so callers can recognise the placeholder.
+ */
+export const PLACEHOLDER_COMMIT_MESSAGE = 'chore: initialize repository for Telora';
+// Cloning a polished app (full clone so an arbitrary sha is reachable) can take
+// a while; give it a generous ceiling distinct from the 60s default.
+const CLONE_TIMEOUT_MS = 300_000;
+/**
+ * Seed an empty product repo's genesis commit from the starter its active PRD
+ * selected. Returns a typed result; the caller decides the fallback.
+ */
+export async function seedGenesisFromStarter(config, deps = {}) {
+    const d = { ...defaultDeps, ...deps };
+    // Greenfield guard: only an empty repo is seeded. A repo with history is left
+    // untouched -- a starter is the INITIAL commit, never grafted onto a history.
+    if (d.hasCommits(config.repoPath)) {
+        return { seeded: false, reason: 'repo-has-history' };
+    }
+    // Resolve the starter the active PRD selected (first active PRD that carries
+    // a selection wins).
+    let starterRepoId = null;
+    try {
+        const prds = await d.loadActivePrds(config.productId);
+        starterRepoId = prds.find((p) => p.starterRepoId)?.starterRepoId ?? null;
+    }
+    catch (err) {
+        d.log(`[genesis] could not load active PRDs for product ${config.productId}: ${err.message} -- skipping starter genesis`);
+        return { seeded: false, reason: 'no-starter-selected' };
+    }
+    if (!starterRepoId) {
+        d.log('[genesis] no active PRD selects a starter -- using empty genesis');
+        return { seeded: false, reason: 'no-starter-selected' };
+    }
+    // Resolve the starter's clone coordinates.
+    let coords = null;
+    try {
+        coords = await d.loadStarterRepo(starterRepoId);
+    }
+    catch (err) {
+        d.log(`[genesis] could not load starter ${starterRepoId}: ${err.message}`);
+    }
+    if (!coords) {
+        d.log(`[genesis] starter ${starterRepoId} not found/unclonable -- using empty genesis`);
+        return { seeded: false, reason: 'starter-not-found', starterRepoId };
+    }
+    const tmpRoot = mkdtempSync(join(tmpdir(), 'telora-starter-'));
+    const cloneDir = join(tmpRoot, 'starter');
+    try {
+        // Full clone (so a pinned sha is reachable), then check out the exact ref.
+        const clone = d.runGit(['clone', coords.gitUrl, cloneDir], tmpRoot, {
+            timeoutMs: CLONE_TIMEOUT_MS,
+        });
+        if (!clone.success) {
+            d.log(`[genesis] clone of ${coords.gitUrl} failed: ${clone.error} -- using empty genesis`);
+            return { seeded: false, reason: 'clone-failed', starterRepoId, gitUrl: coords.gitUrl, ref: coords.ref };
+        }
+        const checkout = d.runGit(['checkout', coords.ref], cloneDir, { timeoutMs: CLONE_TIMEOUT_MS });
+        if (!checkout.success) {
+            d.log(`[genesis] checkout of ref ${coords.ref} failed: ${checkout.error} -- using empty genesis`);
+            return { seeded: false, reason: 'clone-failed', starterRepoId, gitUrl: coords.gitUrl, ref: coords.ref };
+        }
+        const resolved = d.runGit(['rev-parse', 'HEAD'], cloneDir);
+        const resolvedSha = resolved.success ? resolved.output.trim() : coords.ref;
+        // Copy the starter working tree (MINUS its .git) over the empty product
+        // repo. Excluding .git is what squashes the result to a single fresh
+        // initial commit -- starter history is not inherited.
+        const starterGitDir = join(cloneDir, '.git');
+        cpSync(cloneDir, config.repoPath, {
+            recursive: true,
+            filter: (src) => src !== starterGitDir && !src.startsWith(starterGitDir + sep),
+        });
+        // Record provenance as repo metadata (force-added past any .telora gitignore)
+        // so a product traces back to exactly what it started from.
+        const provenance = {
+            starterRepoId,
+            name: coords.name,
+            gitUrl: coords.gitUrl,
+            ref: coords.ref,
+            resolvedSha,
+            seededAt: new Date().toISOString(),
+        };
+        const teloraDir = join(config.repoPath, '.telora');
+        if (!existsSync(teloraDir))
+            mkdirSync(teloraDir, { recursive: true });
+        writeFileSync(join(teloraDir, 'starter-provenance.json'), `${JSON.stringify(provenance, null, 2)}\n`);
+        d.runGit(['add', '-A'], config.repoPath);
+        // Force-add the provenance file in case the product's .gitignore drops
+        // .telora -- the provenance must land in the genesis commit.
+        d.runGit(['add', '-f', '.telora/starter-provenance.json'], config.repoPath);
+        const message = `chore: initialize from starter ${coords.name || coords.ref}\n\n` +
+            'Seeded the product genesis commit from a registered starter repo ' +
+            '(squashed -- starter history not inherited).\n\n' +
+            `Starter-Repo-Id: ${starterRepoId}\n` +
+            `Starter-Name: ${coords.name}\n` +
+            `Starter-Git-Url: ${coords.gitUrl}\n` +
+            `Starter-Ref: ${coords.ref}\n` +
+            `Starter-Resolved-Sha: ${resolvedSha}\n`;
+        let commit = d.runGit(['commit', '-m', message], config.repoPath);
+        if (!commit.success) {
+            // The daemon host may have no committer identity configured. Retry with an
+            // explicit one scoped to this command only.
+            commit = d.runGit([
+                '-c',
+                'user.name=Telora Factory',
+                '-c',
+                'user.email=factory@telora.local',
+                'commit',
+                '-m',
+                message,
+            ], config.repoPath);
+        }
+        if (!commit.success) {
+            d.log(`[genesis] genesis commit failed: ${commit.error} -- using empty genesis`);
+            return {
+                seeded: false,
+                reason: 'commit-failed',
+                starterRepoId,
+                gitUrl: coords.gitUrl,
+                ref: coords.ref,
+                resolvedSha,
+            };
+        }
+        d.log(`[genesis] seeded product genesis from starter "${coords.name}" ` +
+            `(${coords.gitUrl} @ ${coords.ref} -> ${resolvedSha.slice(0, 12)})`);
+        return {
+            seeded: true,
+            reason: 'seeded',
+            starterRepoId,
+            gitUrl: coords.gitUrl,
+            ref: coords.ref,
+            resolvedSha,
+        };
+    }
+    finally {
+        rmSync(tmpRoot, { recursive: true, force: true });
+    }
+}
+/**
+ * Ensure an empty product repo has its initial commit, preferring a starter
+ * genesis. This is the single decision point both daemon startup (initGit) and
+ * the per-poll worktree-provisioning safety net share, so the
+ * defer-rather-than-foreclose rule is applied consistently (focus 80ecc233).
+ *
+ * Order:
+ *  1. Repo already has commits -> nothing to do.
+ *  2. Try to seed from the active PRD's starter.
+ *  3. No active starter, BUT a starter-selecting PRD is still draft -> DEFER:
+ *     leave the repo empty (no foreclosing placeholder). The worktree-provisioning
+ *     safety net re-runs this once the PRD activates and seeds the genesis then.
+ *  4. Otherwise (no starter anywhere, or the clone genuinely failed) -> write an
+ *     empty placeholder commit so git operations are never wedged.
+ */
+export async function ensureInitialCommit(config, deps = {}) {
+    const d = { ...defaultDeps, ...deps };
+    if (d.hasCommits(config.repoPath)) {
+        return { committed: true, seeded: false, deferred: false };
+    }
+    const genesis = await seedGenesisFromStarter(config, d);
+    if (genesis.seeded) {
+        return { committed: true, seeded: true, deferred: false, genesis };
+    }
+    // Defer ONLY for the genuinely-pending case. A clone/commit failure on an
+    // active selection (reason !== 'no-starter-selected') must still fall through
+    // to a placeholder -- never leave the product permanently without a commit.
+    if (genesis.reason === 'no-starter-selected') {
+        let pending = false;
+        try {
+            pending = await d.hasPendingStarterSelection(config.productId);
+        }
+        catch (err) {
+            d.log(`[genesis] could not check pending starter PRDs: ${err.message}`);
+        }
+        if (pending) {
+            d.log('[genesis] a starter-selecting PRD exists but is not active yet -- ' +
+                'deferring the initial commit so genesis can seed once it activates');
+            return { committed: false, seeded: false, deferred: true, genesis };
+        }
+    }
+    // Fall back to an empty placeholder initial commit.
+    let commit = d.runGit(['commit', '--allow-empty', '-m', PLACEHOLDER_COMMIT_MESSAGE], config.repoPath);
+    if (!commit.success) {
+        // Retry with an explicit committer identity scoped to this command only.
+        commit = d.runGit([
+            '-c', 'user.name=Telora Factory',
+            '-c', 'user.email=factory@telora.local',
+            'commit', '--allow-empty', '-m', PLACEHOLDER_COMMIT_MESSAGE,
+        ], config.repoPath);
+    }
+    return { committed: commit.success, seeded: false, deferred: false, genesis };
+}
+//# sourceMappingURL=git-genesis.js.map

package/dist/git-genesis.js.map

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

package/dist/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAc/C,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGlJ,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,cAAc,EACd,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,2BAA2B,EAC3B,kCAAkC,EAClC,6BAA6B,EAC7B,6BAA6B,EAC7B,6BAA6B,EAC7B,wBAAwB,EACxB,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,2BAA2B,EAC3B,KAAK,6BAA6B,EAClC,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAIvB;;GAEG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA+DjE"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAe/C,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGlJ,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,cAAc,GACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,kBAAkB,EAClB,cAAc,EACd,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,2BAA2B,EAC3B,kCAAkC,EAClC,6BAA6B,EAC7B,6BAA6B,EAC7B,6BAA6B,EAC7B,wBAAwB,EACxB,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,2BAA2B,EAC3B,KAAK,6BAA6B,EAClC,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAIvB;;GAEG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFjE"}

package/dist/git.js

@@ -17,6 +17,7 @@ import { configureMergeLock } from './git-merge-lock.js';
 import { ensureIntegrationBranch, repoHasCommits } from './git-branch.js';
 import { syncIntegrationWithMain } from './git-integration.js';
 import { runGitSync } from './git-types.js';
+import { ensureInitialCommit } from './git-genesis.js';
 // ── Re-exports from sub-modules ─────────────────────────────────
 // git-types.ts: shared types and utilities
 export { runGitSync, DEFAULT_GIT_TIMEOUT_MS } from './git-types.js';
@@ -59,15 +60,37 @@ export async function initGit(config) {
     pruneWorktrees(config.repoPath);
     // Empty repos need an initial commit before branches or worktrees can be created.
     // Create one automatically so the full git subsystem initializes immediately.
+    // When the product's active PRD selects a starter repo, seed the genesis
+    // commit from that polished starter instead of an empty commit (focus
+    // 80ecc233) -- the agent then starts ABOVE the UX floor. Falls back to the
+    // empty commit when there is no starter / it cannot be cloned.
     if (!repoHasCommits(config.repoPath)) {
-        console.log('Repository has no commits -- creating initial commit for Telora...');
-        const result = runGitSync(['commit', '--allow-empty', '-m', 'chore: initialize repository for Telora'], config.repoPath);
-        if (!result.success) {
-            console.error(`Failed to create initial commit: ${result.error}`);
+        const init = await ensureInitialCommit({
+            repoPath: config.repoPath,
+            productId: config.productId,
+        });
+        if (init.seeded) {
+            const g = init.genesis;
+            console.log(`Genesis commit seeded from starter ${g?.starterRepoId} ` +
+                `(${g?.gitUrl} @ ${g?.ref} -> ${g?.resolvedSha?.slice(0, 12)})`);
+        }
+        else if (init.deferred) {
+            // A starter-selecting PRD is still draft -- leave the repo empty rather
+            // than foreclose genesis with a placeholder. The worktree-provisioning
+            // safety net seeds it once the PRD activates.
+            console.log('Repository has no commits -- deferring initial commit until a ' +
+                'starter-selecting PRD activates (genesis will seed it then)');
+            console.log('Git subsystem initialized (limited -- waiting for starter PRD / first commit)');
+            return;
+        }
+        else if (!init.committed) {
+            console.error('Failed to create initial commit');
             console.log('Git subsystem initialized (limited -- waiting for first commit)');
             return;
         }
-        console.log('Initial commit created');
+        else {
+            console.log(`Repository has no commits (${init.genesis?.reason}) -- created empty initial commit for Telora`);
+        }
     }
     // Ensure integration branch exists
     await ensureIntegrationBranch(config);

package/dist/git.js.map

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

package/dist/loop-engine-types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * API-response shapes consumed by the LoopEngine (loop-engine.ts).
+ *
+ * Extracted from loop-engine.ts to keep that file under the daemon structural
+ * size lint -- the same reason the operational-block guard and the LLM-flag
+ * resolver live in their own modules. These are the minimal projections the
+ * engine reads from focus_list / loop_document_list / loop_question_list /
+ * reality_metrics_focus.
+ */
+export interface FocusWithLoopData {
+    id: string;
+    productId: string;
+    organizationId: string;
+    name: string;
+    status: string;
+    assignedAgentRoleId: string | null;
+    targetDate: string | null;
+}
+export interface LoopDocumentItem {
+    id: string;
+    title: string;
+    content: string;
+    sortOrder: number;
+}
+export interface LoopQuestionItem {
+    id: string;
+    text: string;
+    questionType: string;
+    sortOrder: number | null;
+    isRetired: boolean;
+}
+export interface RealityMetricsResponse {
+    focusId: string;
+    metrics: Record<string, unknown> | null;
+    projections: {
+        completion: Record<string, unknown> | null;
+        cost: Record<string, unknown> | null;
+    };
+}
+//# sourceMappingURL=loop-engine-types.d.ts.map

package/dist/loop-engine-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-engine-types.d.ts","sourceRoot":"","sources":["../src/loop-engine-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,WAAW,EAAE;QACX,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QAC3C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KACtC,CAAC;CACH"}

package/dist/loop-engine-types.js

@@ -0,0 +1,11 @@
+/**
+ * API-response shapes consumed by the LoopEngine (loop-engine.ts).
+ *
+ * Extracted from loop-engine.ts to keep that file under the daemon structural
+ * size lint -- the same reason the operational-block guard and the LLM-flag
+ * resolver live in their own modules. These are the minimal projections the
+ * engine reads from focus_list / loop_document_list / loop_question_list /
+ * reality_metrics_focus.
+ */
+export {};
+//# sourceMappingURL=loop-engine-types.js.map

package/dist/loop-engine-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-engine-types.js","sourceRoot":"","sources":["../src/loop-engine-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/loop-engine.d.ts

@@ -14,6 +14,10 @@
  *   5. shutdown()             -- no-op (no processes to kill)
  */
 import type { ExecutionEngine, EngineHealth, ResourceUsage, BaseConfig, ResourceGovernor } from '@telora/daemon-core';
+import { type LoopIntentData, type RealityData, type VarianceResult } from './loop-variance.js';
+import { isFocusOperationallyBlocked } from './loop-operational-block.js';
+import { isLoopLlmReCurationEnabled } from './loop-llm-flag.js';
+import type { FocusWithLoopData } from './loop-engine-types.js';
 export interface LoopEventTriggerConfig {
     /** Trigger on delivery completion. Default: true. */
     deliveryCompleted: boolean;
@@ -36,6 +40,41 @@ export interface LoopEngineConfig {
     /** Event triggers that cause immediate re-evaluation. Default: all enabled. */
     eventTriggers: LoopEventTriggerConfig;
 }
+export { isFocusOperationallyBlocked };
+export type { OperationalBlockDeps } from './loop-operational-block.js';
+export { isLoopLlmReCurationEnabled };
+/**
+ * Injectable collaborators for {@link LoopEngine.processFocus}.
+ *
+ * Every field defaults to the engine's real implementation, so an omitted (or
+ * partial) override is byte-identical to production. The seam exists ONLY to
+ * make the operational-block suppression behavior testable WITHOUT module
+ * mocking: `loop-engine.ts`'s transitive graph (queries/shared, worktree-safety,
+ * git-types) runtime-imports `@telora/daemon-core`, and `mock.module(...)` is
+ * incompatible with that under tsx's experimental resolver (documented in
+ * focus-engine-characterization.test.ts). Injecting these collaborators lets a
+ * test drive processFocus with the REAL modules and assert that the LLM update
+ * is suppressed while a focus is operationally blocked, runs once the block
+ * clears, and that the variance snapshot is still persisted while blocked.
+ */
+export interface ProcessFocusDeps {
+    /** Load intent (loop documents/questions/persona) for the focus. */
+    loadIntentData: (focusId: string) => Promise<LoopIntentData>;
+    /** Load forecasted-reality (metrics + projections) for the focus. */
+    loadRealityData: (focusId: string) => Promise<RealityData>;
+    /** Persist the computed variance snapshot (cheap; kept even while blocked). */
+    persistVarianceSnapshot: (focus: FocusWithLoopData, variance: VarianceResult) => Promise<void>;
+    /** True when the focus is operationally blocked (LLM drift must be suppressed). */
+    isFocusOperationallyBlocked: (focusId: string) => Promise<boolean>;
+    /**
+     * Opt-in gate for the whole LLM re-curation concern (the block guard + the
+     * update). Default reads TELORA_LOOP_LLM via isLoopLlmReCurationEnabled (OFF).
+     * Injected so a test can exercise the on-path without mutating process.env.
+     */
+    isLoopLlmReCurationEnabled: () => boolean;
+    /** Run the LLM drift update -- the call suppressed while a focus is blocked. */
+    runLLMUpdate: (focus: FocusWithLoopData, intent: LoopIntentData, reality: RealityData, variance: VarianceResult) => Promise<void>;
+}
 export declare class LoopEngine implements ExecutionEngine {
     readonly name = "loop";
     private config;
@@ -53,6 +92,19 @@ export declare class LoopEngine implements ExecutionEngine {
     private lastVariance;
     /** Focuses that have been triggered by lifecycle events (pending immediate evaluation). */
     private triggeredFocuses;
+    /**
+     * Focuses currently in an operational-block episode (LLM drift suppressed).
+     * Tracked so we log ONCE per episode (on entry) and resume ONCE (on exit),
+     * rather than every poll tick.
+     */
+    private blockedFocuses;
+    /**
+     * Focuses for which the "LLM re-curation disabled by default" line has already
+     * been logged. The opt-in is a persistent config (not a clearing episode), so
+     * the default-OFF skip is logged at most once per focus -- observable without
+     * per-tick spam.
+     */
+    private llmDisabledLoggedFocuses;
     /** Cleanup function for event bus subscription. */
     private unsubscribeEvents;
     setGovernor(gov: ResourceGovernor): void;

package/dist/loop-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop-engine.d.ts","sourceRoot":"","sources":["../src/loop-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,UAAU,EACV,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAa7B,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,qDAAqD;IACrD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mDAAmD;IACnD,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,mFAAmF;IACnF,gBAAgB,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAC;IACvB,uFAAuF;IACvF,uBAAuB,EAAE,MAAM,CAAC;IAChC,kGAAkG;IAClG,gBAAgB,EAAE,MAAM,CAAC;IACzB,+EAA+E;IAC/E,aAAa,EAAE,sBAAsB,CAAC;CACvC;AA2DD,qBAAa,UAAW,YAAW,eAAe;IAChD,QAAQ,CAAC,IAAI,UAAU;IAEvB,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAAgD;IAClE,OAAO,CAAC,QAAQ,CAAiC;IAEjD,OAAO,CAAC,WAAW,CAA8C;IACjE,OAAO,CAAC,YAAY,CAAS;IAE7B,8DAA8D;IAC9D,OAAO,CAAC,gBAAgB,CAAK;IAE7B,gDAAgD;IAChD,OAAO,CAAC,UAAU,CAAqB;IAEvC,+CAA+C;IAC/C,OAAO,CAAC,gBAAgB,CAAkC;IAE1D,mEAAmE;IACnE,OAAO,CAAC,YAAY,CAA0C;IAE9D,2FAA2F;IAC3F,OAAO,CAAC,gBAAgB,CAA0B;IAElD,mDAAmD;IACnD,OAAO,CAAC,iBAAiB,CAA6B;IAMtD,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IASlC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCjE,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB5B,IAAI,IAAI,IAAI;IAgBN,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B,WAAW,IAAI,YAAY;IAkB3B,gBAAgB,IAAI,aAAa;YAWnB,YAAY;IAqB1B;;;OAGG;YACW,WAAW;IA0CzB;;;OAGG;YACW,YAAY;IAgC1B;;OAEG;YACW,cAAc;IA6C5B;;OAEG;YACW,eAAe;IAe7B;;OAEG;YACW,uBAAuB;IAerC;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAoE9B;;OAEG;YACW,YAAY;IAqC1B;;OAEG;YACW,gBAAgB;IAsD9B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqBzB"}
+{"version":3,"file":"loop-engine.d.ts","sourceRoot":"","sources":["../src/loop-engine.ts"],"names":[],"mappings":"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"}

package/dist/loop-engine.js

@@ -19,6 +19,11 @@ import { computeVariance } from './loop-variance.js';
 import { buildLoopUpdatePrompt, parseLoopUpdateResponse } from './loop-prompt-builder.js';
 import { callLoopLLM } from './loop-llm-client.js';
 import { onLoopTrigger } from './loop-event-bus.js';
+import { hasOpenWorktreeDirtyEscalation } from './queries/issues.js';
+import { getFocusWorktree } from './focus-worktree-state.js';
+import { worktreeHasUncommittedChanges } from './worktree-safety.js';
+import { isFocusOperationallyBlocked } from './loop-operational-block.js';
+import { isLoopLlmReCurationEnabled } from './loop-llm-flag.js';
 const DEFAULT_EVENT_TRIGGERS = {
     deliveryCompleted: true,
     focusStatusChanged: true,
@@ -32,6 +37,15 @@ const DEFAULT_LOOP_CONFIG = {
     staleThresholdMs: 86_400_000,
     eventTriggers: { ...DEFAULT_EVENT_TRIGGERS },
 };
+// Operational-block guard (OperationalBlockDeps + isFocusOperationallyBlocked)
+// lives in ./loop-operational-block.ts; imported above for processFocus's default
+// wiring and re-exported here so existing importers (e.g.
+// loop-engine-operational-block.test.ts) are unaffected.
+export { isFocusOperationallyBlocked };
+// LLM re-curation opt-in flag (default OFF). Extracted to ./loop-llm-flag.ts to
+// keep this file under the structural size lint; re-exported so existing
+// importers (and the flag's tests) reach it from loop-engine.
+export { isLoopLlmReCurationEnabled };
 // ---------------------------------------------------------------------------
 // LoopEngine
 // ---------------------------------------------------------------------------
@@ -52,6 +66,19 @@ export class LoopEngine {
     lastVariance = new Map();
     /** Focuses that have been triggered by lifecycle events (pending immediate evaluation). */
     triggeredFocuses = new Set();
+    /**
+     * Focuses currently in an operational-block episode (LLM drift suppressed).
+     * Tracked so we log ONCE per episode (on entry) and resume ONCE (on exit),
+     * rather than every poll tick.
+     */
+    blockedFocuses = new Set();
+    /**
+     * Focuses for which the "LLM re-curation disabled by default" line has already
+     * been logged. The opt-in is a persistent config (not a clearing episode), so
+     * the default-OFF skip is logged at most once per focus -- observable without
+     * per-tick spam.
+     */
+    llmDisabledLoggedFocuses = new Set();
     /** Cleanup function for event bus subscription. */
     unsubscribeEvents = null;
     // -----------------------------------------------------------------------
@@ -222,26 +249,80 @@ export class LoopEngine {
      * Process a single focus: load intent + reality, compute variance,
      * optionally call LLM for updates, persist variance snapshot.
      */
-    async processFocus(focus) {
+    async processFocus(focus, depsOverride) {
+        // Resolve injectable collaborators; each defaults to the real
+        // implementation so an omitted override is byte-identical to production.
+        // The default block-check binds the exact module trio the inline call used.
+        const loadIntent = depsOverride?.loadIntentData ?? ((id) => this.loadIntentData(id));
+        const loadReality = depsOverride?.loadRealityData ?? ((id) => this.loadRealityData(id));
+        const persistVariance = depsOverride?.persistVarianceSnapshot ??
+            ((f, v) => this.persistVarianceSnapshot(f, v));
+        const checkBlocked = depsOverride?.isFocusOperationallyBlocked ??
+            ((id) => isFocusOperationallyBlocked(id, {
+                hasOpenWorktreeDirtyEscalation,
+                getFocusWorktree,
+                worktreeHasUncommittedChanges,
+            }));
+        const runUpdate = depsOverride?.runLLMUpdate ??
+            ((f, i, r, v) => this.runLLMUpdate(f, i, r, v));
+        const llmEnabled = depsOverride?.isLoopLlmReCurationEnabled ?? (() => isLoopLlmReCurationEnabled());
         // 1. Load intent data (loop documents + questions + answers)
-        const intent = await this.loadIntentData(focus.id);
+        const intent = await loadIntent(focus.id);
         // Skip focuses with no loop data (not yet initialized)
         if (intent.documents.length === 0 && intent.questions.length === 0) {
             return;
         }
         // 2. Load reality data (metrics + projections)
-        const reality = await this.loadRealityData(focus.id);
+        const reality = await loadReality(focus.id);
         // 3. Compute variance (pass previous for trend direction)
         const previousVariance = this.lastVariance.get(focus.id) ?? null;
         const variance = computeVariance(intent, reality, focus.targetDate ?? null, previousVariance);
         // 4. Persist variance snapshot
-        await this.persistVarianceSnapshot(focus, variance);
-        // 5. Determine if LLM update is needed
-        const shouldUpdate = this.shouldTriggerLLMUpdate(focus.id, variance, reality);
-        if (shouldUpdate) {
-            console.log(`[Loop] Triggering LLM update for focus "${focus.name}" (${focus.id.slice(0, 8)}) -- lock: ${variance.lockStatus}`);
-            await this.runLLMUpdate(focus, intent, reality, variance);
-            this.lastEvaluationAt.set(focus.id, Date.now());
+        await persistVariance(focus, variance);
+        // 4b. LLM re-curation opt-in gate (default OFF -- the OUTER guard). The
+        // deterministic variance/lock snapshot above is the load-bearing
+        // differential signal and has already been computed + persisted. The LLM
+        // re-curation pass (the operational-block check AND the update below) is
+        // empirically net-negative even on healthy focuses, so it is suppressed
+        // entirely unless TELORA_LOOP_LLM opts in. lastVariance is still stamped
+        // (step 6) regardless, so trend comparison stays correct if the pass is
+        // later re-enabled. The default-off skip is logged at most once per focus.
+        if (llmEnabled()) {
+            // 4c. Operational-block guard. Intent-vs-reality drift cannot be reconciled
+            // by an LLM while reality is frozen by an operational block (an open
+            // advance-block / worktree-dirty escalation, or a dirty worktree). Skip the
+            // LLM call entirely while blocked -- otherwise the loop fires repeated no-op
+            // "drift" sessions on a stuck focus. The variance snapshot above is kept
+            // (cheap + useful), and lastVariance is still stamped (step 6) so trend
+            // comparison stays correct when the block clears.
+            const blocked = await checkBlocked(focus.id);
+            if (blocked) {
+                if (!this.blockedFocuses.has(focus.id)) {
+                    this.blockedFocuses.add(focus.id);
+                    console.log(`[Loop] Focus "${focus.name}" (${focus.id.slice(0, 8)}) is operationally blocked ` +
+                        `(open advance-block/worktree-dirty escalation or dirty worktree); ` +
+                        `suppressing LLM drift update until it clears.`);
+                }
+                this.lastVariance.set(focus.id, variance);
+                return;
+            }
+            if (this.blockedFocuses.delete(focus.id)) {
+                console.log(`[Loop] Focus "${focus.name}" (${focus.id.slice(0, 8)}) operational block cleared; ` +
+                    `resuming LLM drift updates.`);
+            }
+            // 5. Determine if LLM update is needed
+            const shouldUpdate = this.shouldTriggerLLMUpdate(focus.id, variance, reality);
+            if (shouldUpdate) {
+                console.log(`[Loop] Triggering LLM update for focus "${focus.name}" (${focus.id.slice(0, 8)}) -- lock: ${variance.lockStatus}`);
+                await runUpdate(focus, intent, reality, variance);
+                this.lastEvaluationAt.set(focus.id, Date.now());
+            }
+        }
+        else if (!this.llmDisabledLoggedFocuses.has(focus.id)) {
+            this.llmDisabledLoggedFocuses.add(focus.id);
+            console.log(`[Loop] LLM re-curation disabled by default (TELORA_LOOP_LLM unset) for focus ` +
+                `"${focus.name}" (${focus.id.slice(0, 8)}); variance snapshot persisted, ` +
+                `skipping LLM drift update.`);
         }
         // 6. Store variance for threshold comparison
         this.lastVariance.set(focus.id, variance);