@telora/daemon 0.19.31 → 0.19.34

package/dist/cli/harness-add.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `telora-daemon harness add <target>` subcommand.
+ *
+ * A token-free, idempotent way to install or repair any operator harness on an
+ * ALREADY-connected workstation. Unlike `connect`, it never redeems a token,
+ * never rewrites `~/.telora/daemon.json`, and never starts the daemon -- it
+ * reads the identity `connect` already persisted (`readConnectedIdentity`) and
+ * writes exactly the same harness scaffolding (`writeHarnessScaffolding`), so
+ * `harness add <h>` and `connect --harness <h>` produce byte-identical files
+ * for a given identity.
+ *
+ * On a repo the workstation is not connected to, it refuses with an actionable
+ * message directing the operator to `connect` first.
+ */
+import { type ConnectIO, type OperatorHarness } from './connect.js';
+export interface HarnessAddOptions {
+    /** The harness target to install or repair. */
+    target: OperatorHarness;
+    /** Repo path to scaffold (default: cwd). */
+    repoPath?: string;
+    /** Override IO (used by tests). */
+    io?: Partial<ConnectIO>;
+}
+export interface HarnessAddResult {
+    ok: boolean;
+    /** Human-facing message (success detail, or the not-connected remediation). */
+    message: string;
+}
+/**
+ * Install or repair the `target` harness scaffolding for a connected repo.
+ *
+ * Idempotent: the underlying writers skip the write when content is unchanged,
+ * so a second run leaves identical files and returns ok. Returns `ok: false`
+ * (no files touched) when the repo is not connected.
+ */
+export declare function runHarnessAdd(opts: HarnessAddOptions): HarnessAddResult;
+//# sourceMappingURL=harness-add.d.ts.map

package/dist/cli/harness-add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-add.d.ts","sourceRoot":"","sources":["../../src/cli/harness-add.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAML,KAAK,SAAS,EACd,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,MAAM,EAAE,eAAe,CAAC;IACxB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,EAAE,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,CA4BvE"}

package/dist/cli/harness-add.js

@@ -0,0 +1,48 @@
+/**
+ * `telora-daemon harness add <target>` subcommand.
+ *
+ * A token-free, idempotent way to install or repair any operator harness on an
+ * ALREADY-connected workstation. Unlike `connect`, it never redeems a token,
+ * never rewrites `~/.telora/daemon.json`, and never starts the daemon -- it
+ * reads the identity `connect` already persisted (`readConnectedIdentity`) and
+ * writes exactly the same harness scaffolding (`writeHarnessScaffolding`), so
+ * `harness add <h>` and `connect --harness <h>` produce byte-identical files
+ * for a given identity.
+ *
+ * On a repo the workstation is not connected to, it refuses with an actionable
+ * message directing the operator to `connect` first.
+ */
+import { resolve } from 'node:path';
+import { defaultIO, ensureGitignoreEntries, harnessGitignoreEntries, readConnectedIdentity, writeHarnessScaffolding, } from './connect.js';
+/**
+ * Install or repair the `target` harness scaffolding for a connected repo.
+ *
+ * Idempotent: the underlying writers skip the write when content is unchanged,
+ * so a second run leaves identical files and returns ok. Returns `ok: false`
+ * (no files touched) when the repo is not connected.
+ */
+export function runHarnessAdd(opts) {
+    const io = defaultIO(opts.io);
+    const repoPath = resolve(opts.repoPath ?? process.cwd());
+    const identity = readConnectedIdentity(repoPath);
+    if (!identity) {
+        return {
+            ok: false,
+            message: `This workstation is not connected to Telora for ${repoPath}. ` +
+                `Run \`telora-daemon connect <token> --harness ${opts.target}\` to connect first.`,
+        };
+    }
+    const inv = {
+        productName: null,
+        teloraUrl: identity.teloraUrl,
+        organizationId: identity.organizationId,
+        productId: identity.productId,
+    };
+    ensureGitignoreEntries(repoPath, io, harnessGitignoreEntries(opts.target));
+    writeHarnessScaffolding(repoPath, opts.target, inv, io);
+    return {
+        ok: true,
+        message: `Installed ${opts.target} harness scaffolding for product ${identity.productId}.`,
+    };
+}
+//# sourceMappingURL=harness-add.js.map

package/dist/cli/harness-add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-add.js","sourceRoot":"","sources":["../../src/cli/harness-add.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,SAAS,EACT,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,GAGxB,MAAM,cAAc,CAAC;AAiBtB;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAuB;IACnD,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEzD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EACL,mDAAmD,QAAQ,IAAI;gBAC/D,iDAAiD,IAAI,CAAC,MAAM,sBAAsB;SACrF,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAgC;QACvC,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,SAAS,EAAE,QAAQ,CAAC,SAAS;KAC9B,CAAC;IAEF,sBAAsB,CAAC,QAAQ,EAAE,EAAE,EAAE,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3E,uBAAuB,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAExD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,aAAa,IAAI,CAAC,MAAM,oCAAoC,QAAQ,CAAC,SAAS,GAAG;KAC3F,CAAC;AACJ,CAAC"}

package/dist/cli/open.d.ts

@@ -0,0 +1,171 @@
+/**
+ * `telora-daemon open <focus>` subcommand.
+ *
+ * Resolves a focus (by UUID or by focus key like "f3") to its git branch,
+ * reuses or creates an OPERATOR-OWNED worktree on that branch, and launches the
+ * operator's editor there -- for a focus that is still in flight OR already
+ * merged/completed.
+ *
+ * Two invariants shape the design:
+ *
+ *  1. The operator worktree is NEVER the team's live worktree. Team worktrees
+ *     live at `join(worktreeDir, branch.replace(/\//g,'-'))`; operator worktrees
+ *     live under a distinct `operator-` prefixed namespace
+ *     (`join(worktreeDir, 'operator-' + branch.replace(/\//g,'-'))`). The
+ *     prefix keeps them provably a different path AND out of reach of the
+ *     team-lifecycle sweeps: `cleanupOrphanFocusWorktrees` only reaps dirs whose
+ *     name starts with `agent-`, so an `operator-agent-...` dir is never reaped.
+ *
+ *  2. A focus resolves to its branch even after merge. The `focus_worktrees`
+ *     ROW survives a merge (only the worktree DIRECTORY is removed), so the row
+ *     is the primary branch source. When no row exists we fall back to deriving
+ *     the branch name and verifying it exists in git; a focus with neither is
+ *     the actionable no-branch error path.
+ *
+ * All side-effecting pieces (record lookup, git ops, editor launch, IO) are
+ * injected so `runOpen` is testable without a network, a real git remote, or a
+ * real editor. `runOpenCommand` wires the real defaults for the CLI.
+ */
+/** Default editor command. `cursor` since this verb is the IDE bridge. */
+export declare const DEFAULT_EDITOR = "cursor";
+/** True when `ref` is a focus UUID (vs. an ephemeral focus key like "f3"). */
+export declare function looksLikeUuid(ref: string): boolean;
+/** True when `ref` is an ephemeral focus key like "f3". */
+export declare function looksLikeFocusKey(ref: string): boolean;
+/**
+ * Derive a focus branch name. Mirrors `generateFocusBranchName` in
+ * focus-executor.ts (`agent/<role>/<focus>-<shortId>`), reusing the same
+ * canonical `sanitizeGitSegment`. Used only as the fallback when a focus has no
+ * `focus_worktrees` row; the derived branch is git-verified before use.
+ */
+export declare function deriveFocusBranchName(roleName: string, focusName: string, focusId: string): string;
+/**
+ * The team's worktree path for a branch. Mirrors `createWorktree` in
+ * worktree.ts. This is the LIVE worktree an executing team owns -- `open`
+ * never creates, removes, or writes to it.
+ */
+export declare function teamWorktreePath(worktreeDir: string, branchName: string): string;
+/**
+ * The OPERATOR worktree path for a branch: a distinct namespace under the same
+ * worktree dir, prefixed `operator-`. Distinct from `teamWorktreePath` by
+ * construction, and invisible to `cleanupOrphanFocusWorktrees` (which only
+ * reaps `agent-*` dirs).
+ */
+export declare function operatorWorktreePath(worktreeDir: string, branchName: string): string;
+/**
+ * Resolve the editor command with precedence: explicit `--editor` > `TELORA_EDITOR`
+ * env > `DEFAULT_EDITOR`.
+ */
+export declare function resolveEditor(optEditor?: string, env?: NodeJS.ProcessEnv): string;
+/** The subset of a `focus_worktrees` row the resolver needs. */
+export interface WorktreeLite {
+    focusId: string;
+    branchName: string;
+    worktreePath: string;
+    productId?: string | null;
+}
+/** The subset of a `focus_list` entry the resolver needs. */
+export interface FocusLite {
+    id: string;
+    focusKey?: string | null;
+    name?: string | null;
+    assignedAgentRoleName?: string | null;
+    productId?: string | null;
+}
+/** Record-level resolution of a focus ref to a branch (no product paths yet). */
+export interface FocusRecordResolution {
+    focusId: string;
+    focusName: string;
+    branchName: string;
+    productId: string | null;
+    /** True when the branch came from a focus_worktrees row; false when derived. */
+    fromWorktreeRow: boolean;
+}
+/** Full resolution including the product's repo + worktree directory. */
+export interface FocusResolution extends FocusRecordResolution {
+    repoPath: string;
+    worktreeDir: string;
+}
+/**
+ * Pure resolution of a focus ref (UUID or focus key) to its branch, from
+ * already-fetched worktree rows + focus list. No I/O -- hermetic to test.
+ *
+ * Returns null when the ref is neither a UUID nor a key, when a key does not
+ * match any focus, or when there is no branch to open (no row and no derivable
+ * branch).
+ */
+export declare function resolveFocusWorktreeFromData(params: {
+    focusRef: string;
+    worktrees: WorktreeLite[];
+    focuses: FocusLite[];
+}): FocusRecordResolution | null;
+/** Git/worktree operations, injectable for tests. */
+export interface OpenGitOps {
+    /** Whether a path exists on disk. */
+    pathExists: (path: string) => boolean;
+    /** Whether a local git branch exists in the repo. */
+    branchExists: (branchName: string, repoPath: string) => boolean;
+    /** `git worktree add <worktreePath> <branch>`. Throws on failure. */
+    addWorktree: (repoPath: string, worktreePath: string, branchName: string) => void;
+}
+/** Launch an editor at a path. Injectable for tests. */
+export type LaunchEditor = (editorCmd: string, worktreePath: string) => void;
+/** Message sink, injectable for tests. */
+export interface OpenIO {
+    out: (msg: string) => void;
+    err: (msg: string) => void;
+}
+export interface RunOpenParams {
+    focusRef: string;
+    /** The resolved editor command (see resolveEditor). */
+    editor: string;
+    /** Injected focus-ref -> resolution lookup (network in real wiring). */
+    resolveWorktreeRecord: (focusRef: string) => Promise<FocusResolution | null>;
+    git: OpenGitOps;
+    launchEditor: LaunchEditor;
+    io: OpenIO;
+}
+export type OpenFailure = 'no_branch' | 'worktree_create_failed';
+export interface RunOpenResult {
+    ok: boolean;
+    editor: string;
+    message: string;
+    failure?: OpenFailure;
+    focusName?: string;
+    branchName?: string;
+    operatorWorktreePath?: string;
+    teamWorktreePath?: string;
+    /** True when an existing operator worktree was reused (not created). */
+    reused?: boolean;
+    /** True when a new operator worktree was created. */
+    createdWorktree?: boolean;
+    /** True when the team's worktree still exists on disk (focus in flight). */
+    inFlight?: boolean;
+}
+/**
+ * Resolve a focus to an operator worktree and launch the editor there.
+ *
+ * Returns a result object; the CLI wrapper maps `ok === false` to a non-zero
+ * exit. Never touches the team's live worktree.
+ */
+export declare function runOpen(params: RunOpenParams): Promise<RunOpenResult>;
+/** Default git ops backed by the real filesystem + git. */
+export declare const defaultGitOps: OpenGitOps;
+/** Default editor launcher: detached spawn so the CLI can return immediately. */
+export declare function defaultLaunchEditor(editorCmd: string, worktreePath: string): void;
+export interface RunOpenCommandOptions {
+    focusRef: string;
+    /** Explicit editor override (from --editor). */
+    editor?: string;
+    /** Path to daemon.json (from --config). */
+    config?: string;
+    /** IO override (tests). */
+    io?: Partial<OpenIO>;
+}
+/**
+ * CLI entry: load config, wire the real defaults, run, print, and return an
+ * exit code (0 success, 1 failure). The `index.ts` action wrapper calls
+ * `process.exit` with the returned code.
+ */
+export declare function runOpenCommand(opts: RunOpenCommandOptions): Promise<number>;
+//# sourceMappingURL=open.d.ts.map

package/dist/cli/open.d.ts.map

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

package/dist/cli/open.js

@@ -0,0 +1,323 @@
+/**
+ * `telora-daemon open <focus>` subcommand.
+ *
+ * Resolves a focus (by UUID or by focus key like "f3") to its git branch,
+ * reuses or creates an OPERATOR-OWNED worktree on that branch, and launches the
+ * operator's editor there -- for a focus that is still in flight OR already
+ * merged/completed.
+ *
+ * Two invariants shape the design:
+ *
+ *  1. The operator worktree is NEVER the team's live worktree. Team worktrees
+ *     live at `join(worktreeDir, branch.replace(/\//g,'-'))`; operator worktrees
+ *     live under a distinct `operator-` prefixed namespace
+ *     (`join(worktreeDir, 'operator-' + branch.replace(/\//g,'-'))`). The
+ *     prefix keeps them provably a different path AND out of reach of the
+ *     team-lifecycle sweeps: `cleanupOrphanFocusWorktrees` only reaps dirs whose
+ *     name starts with `agent-`, so an `operator-agent-...` dir is never reaped.
+ *
+ *  2. A focus resolves to its branch even after merge. The `focus_worktrees`
+ *     ROW survives a merge (only the worktree DIRECTORY is removed), so the row
+ *     is the primary branch source. When no row exists we fall back to deriving
+ *     the branch name and verifying it exists in git; a focus with neither is
+ *     the actionable no-branch error path.
+ *
+ * All side-effecting pieces (record lookup, git ops, editor launch, IO) are
+ * injected so `runOpen` is testable without a network, a real git remote, or a
+ * real editor. `runOpenCommand` wires the real defaults for the CLI.
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { spawn } from 'node:child_process';
+import { loadConfig, configForProduct, findProduct } from '../config.js';
+import { sanitizeGitSegment } from '../git-utils.js';
+import { runGitSync } from '../git-types.js';
+import { listWorktreeRecords } from '../queries/worktrees.js';
+import { callApi, initSupabase } from '../queries/shared.js';
+/** Default editor command. `cursor` since this verb is the IDE bridge. */
+export const DEFAULT_EDITOR = 'cursor';
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const FOCUS_KEY_RE = /^f\d+$/;
+/** True when `ref` is a focus UUID (vs. an ephemeral focus key like "f3"). */
+export function looksLikeUuid(ref) {
+    return UUID_RE.test(ref);
+}
+/** True when `ref` is an ephemeral focus key like "f3". */
+export function looksLikeFocusKey(ref) {
+    return FOCUS_KEY_RE.test(ref);
+}
+/**
+ * Derive a focus branch name. Mirrors `generateFocusBranchName` in
+ * focus-executor.ts (`agent/<role>/<focus>-<shortId>`), reusing the same
+ * canonical `sanitizeGitSegment`. Used only as the fallback when a focus has no
+ * `focus_worktrees` row; the derived branch is git-verified before use.
+ */
+export function deriveFocusBranchName(roleName, focusName, focusId) {
+    return `agent/${sanitizeGitSegment(roleName)}/${sanitizeGitSegment(focusName)}-${focusId.slice(0, 8)}`;
+}
+/**
+ * The team's worktree path for a branch. Mirrors `createWorktree` in
+ * worktree.ts. This is the LIVE worktree an executing team owns -- `open`
+ * never creates, removes, or writes to it.
+ */
+export function teamWorktreePath(worktreeDir, branchName) {
+    return join(worktreeDir, branchName.replace(/\//g, '-'));
+}
+/**
+ * The OPERATOR worktree path for a branch: a distinct namespace under the same
+ * worktree dir, prefixed `operator-`. Distinct from `teamWorktreePath` by
+ * construction, and invisible to `cleanupOrphanFocusWorktrees` (which only
+ * reaps `agent-*` dirs).
+ */
+export function operatorWorktreePath(worktreeDir, branchName) {
+    return join(worktreeDir, `operator-${branchName.replace(/\//g, '-')}`);
+}
+/**
+ * Resolve the editor command with precedence: explicit `--editor` > `TELORA_EDITOR`
+ * env > `DEFAULT_EDITOR`.
+ */
+export function resolveEditor(optEditor, env = process.env) {
+    if (optEditor && optEditor.trim())
+        return optEditor.trim();
+    const fromEnv = env.TELORA_EDITOR;
+    if (fromEnv && fromEnv.trim())
+        return fromEnv.trim();
+    return DEFAULT_EDITOR;
+}
+/**
+ * Pure resolution of a focus ref (UUID or focus key) to its branch, from
+ * already-fetched worktree rows + focus list. No I/O -- hermetic to test.
+ *
+ * Returns null when the ref is neither a UUID nor a key, when a key does not
+ * match any focus, or when there is no branch to open (no row and no derivable
+ * branch).
+ */
+export function resolveFocusWorktreeFromData(params) {
+    const { focusRef, worktrees, focuses } = params;
+    // 1. Resolve the ref to a focus id (+ carry the focus row for name/role).
+    let focusId = null;
+    let focus;
+    if (looksLikeUuid(focusRef)) {
+        focusId = focusRef;
+        focus = focuses.find((f) => f.id === focusRef);
+    }
+    else if (looksLikeFocusKey(focusRef)) {
+        focus = focuses.find((f) => f.focusKey === focusRef);
+        focusId = focus?.id ?? null;
+    }
+    else {
+        return null; // Neither a UUID nor a focus key.
+    }
+    if (!focusId)
+        return null; // Key matched no focus.
+    const focusName = focus?.name ?? focusId;
+    // 2. Prefer the focus_worktrees row -- it survives a merge, so this is the
+    //    branch source for BOTH in-flight and already-merged focuses.
+    const row = worktrees.find((w) => w.focusId === focusId);
+    if (row) {
+        return {
+            focusId,
+            focusName,
+            branchName: row.branchName,
+            productId: row.productId ?? focus?.productId ?? null,
+            fromWorktreeRow: true,
+        };
+    }
+    // 3. Fallback: derive the branch when we know the focus name + assigned role.
+    //    runOpen verifies the branch exists in git before using it, so a derived
+    //    branch git does not have degrades to the no-branch error path.
+    if (focus?.name && focus.assignedAgentRoleName) {
+        return {
+            focusId,
+            focusName,
+            branchName: deriveFocusBranchName(focus.assignedAgentRoleName, focus.name, focusId),
+            productId: focus.productId ?? null,
+            fromWorktreeRow: false,
+        };
+    }
+    return null; // No row, no derivable branch.
+}
+/**
+ * Resolve a focus to an operator worktree and launch the editor there.
+ *
+ * Returns a result object; the CLI wrapper maps `ok === false` to a non-zero
+ * exit. Never touches the team's live worktree.
+ */
+export async function runOpen(params) {
+    const { focusRef, editor, resolveWorktreeRecord, git, launchEditor, io } = params;
+    const resolution = await resolveWorktreeRecord(focusRef);
+    if (!resolution) {
+        return {
+            ok: false,
+            editor,
+            failure: 'no_branch',
+            message: `Focus "${focusRef}" has no branch to open: no focus_worktrees row and no ` +
+                `derivable branch. It has never been provisioned by the daemon (no delivery ` +
+                `has entered coding yet). Nothing to open.`,
+        };
+    }
+    const { branchName, focusName, repoPath, worktreeDir } = resolution;
+    const teamPath = teamWorktreePath(worktreeDir, branchName);
+    const operatorPath = operatorWorktreePath(worktreeDir, branchName);
+    // Reuse an existing operator worktree on this branch -- do not recreate.
+    if (git.pathExists(operatorPath)) {
+        io.out(`Reusing operator worktree for "${focusName}" at ${operatorPath} (branch ${branchName}).\n`);
+        launchEditor(editor, operatorPath);
+        return {
+            ok: true,
+            editor,
+            message: `Opened ${operatorPath} in ${editor}.`,
+            focusName,
+            branchName,
+            operatorWorktreePath: operatorPath,
+            teamWorktreePath: teamPath,
+            reused: true,
+            createdWorktree: false,
+            inFlight: git.pathExists(teamPath),
+        };
+    }
+    // The branch must exist to base a worktree on it. A merged focus whose branch
+    // was deleted, or a never-provisioned focus, lands here.
+    if (!git.branchExists(branchName, repoPath)) {
+        return {
+            ok: false,
+            editor,
+            failure: 'no_branch',
+            focusName,
+            branchName,
+            message: `Focus "${focusName}" resolves to branch ${branchName}, but that branch does ` +
+                `not exist in ${repoPath} (it may have been deleted after merge). Nothing to open.`,
+        };
+    }
+    // Create an OPERATOR-owned worktree on the focus branch. This is a distinct
+    // path from the team's worktree (${teamPath}) and never touches it.
+    try {
+        git.addWorktree(repoPath, operatorPath, branchName);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            editor,
+            failure: 'worktree_create_failed',
+            focusName,
+            branchName,
+            message: `Failed to create operator worktree at ${operatorPath}: ` +
+                `${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    const inFlight = git.pathExists(teamPath);
+    io.out(inFlight
+        ? `Focus "${focusName}" is in flight; opened a separate operator worktree at ` +
+            `${operatorPath} (branch ${branchName}). The team's worktree at ${teamPath} is untouched.\n`
+        : `Focus "${focusName}" branch ${branchName} checked out at operator worktree ${operatorPath}.\n`);
+    launchEditor(editor, operatorPath);
+    return {
+        ok: true,
+        editor,
+        message: `Opened ${operatorPath} in ${editor}.`,
+        focusName,
+        branchName,
+        operatorWorktreePath: operatorPath,
+        teamWorktreePath: teamPath,
+        reused: false,
+        createdWorktree: true,
+        inFlight,
+    };
+}
+// ── Real CLI wiring ────────────────────────────────────────────────────────
+/** Default git ops backed by the real filesystem + git. */
+export const defaultGitOps = {
+    pathExists: (path) => existsSync(path),
+    branchExists: (branchName, repoPath) => {
+        const res = runGitSync(['rev-parse', '--verify', '--quiet', `refs/heads/${branchName}`], repoPath);
+        return res.success && res.output.trim().length > 0;
+    },
+    addWorktree: (repoPath, worktreePath, branchName) => {
+        const res = runGitSync(['worktree', 'add', worktreePath, branchName], repoPath);
+        if (!res.success) {
+            throw new Error(res.error || 'git worktree add failed');
+        }
+    },
+};
+/** Default editor launcher: detached spawn so the CLI can return immediately. */
+export function defaultLaunchEditor(editorCmd, worktreePath) {
+    const child = spawn(editorCmd, [worktreePath], {
+        detached: true,
+        stdio: 'ignore',
+    });
+    child.on('error', (err) => {
+        process.stderr.write(`Could not launch editor "${editorCmd}": ${err.message}. ` +
+            `Open ${worktreePath} manually, or pass --editor / set TELORA_EDITOR.\n`);
+    });
+    child.unref();
+}
+/** Fetch focus id/key/name/role across all configured products (best-effort). */
+async function fetchFocusLiteAcrossProducts(config) {
+    const out = [];
+    for (const product of config.products) {
+        try {
+            const res = await callApi('focus_list', { productId: product.id, limit: 500 });
+            for (const f of res.focuses ?? []) {
+                out.push({
+                    id: f.id,
+                    focusKey: f.focusKey ?? null,
+                    name: f.name ?? null,
+                    assignedAgentRoleName: f.assignedAgentRoleName ?? null,
+                    productId: product.id,
+                });
+            }
+        }
+        catch {
+            // Best-effort per product: a failure resolving one product's focuses must
+            // not block opening a focus in another.
+        }
+    }
+    return out;
+}
+/**
+ * Real resolver wiring: hits the Telora API for worktree rows + focuses, runs
+ * the pure resolver, then attaches the resolved product's repo + worktree dir.
+ */
+async function resolveFocusWorktreeReal(focusRef, config) {
+    initSupabase(config);
+    const worktrees = await listWorktreeRecords();
+    const focuses = await fetchFocusLiteAcrossProducts(config);
+    const base = resolveFocusWorktreeFromData({ focusRef, worktrees, focuses });
+    if (!base)
+        return null;
+    const product = base.productId ? findProduct(config, base.productId) : undefined;
+    const scoped = product ? configForProduct(config, product) : config;
+    return {
+        ...base,
+        repoPath: scoped.repoPath,
+        worktreeDir: scoped.worktreeDir,
+    };
+}
+/**
+ * CLI entry: load config, wire the real defaults, run, print, and return an
+ * exit code (0 success, 1 failure). The `index.ts` action wrapper calls
+ * `process.exit` with the returned code.
+ */
+export async function runOpenCommand(opts) {
+    const io = {
+        out: opts.io?.out ?? ((m) => process.stdout.write(m)),
+        err: opts.io?.err ?? ((m) => process.stderr.write(m)),
+    };
+    const config = loadConfig(opts.config);
+    const editor = resolveEditor(opts.editor);
+    const result = await runOpen({
+        focusRef: opts.focusRef,
+        editor,
+        resolveWorktreeRecord: (ref) => resolveFocusWorktreeReal(ref, config),
+        git: defaultGitOps,
+        launchEditor: defaultLaunchEditor,
+        io,
+    });
+    if (!result.ok) {
+        io.err(result.message.endsWith('\n') ? result.message : `${result.message}\n`);
+        return 1;
+    }
+    io.out(result.message.endsWith('\n') ? result.message : `${result.message}\n`);
+    return 0;
+}
+//# sourceMappingURL=open.js.map

package/dist/cli/open.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"focus-engine.d.ts","sourceRoot":"","sources":["../src/focus-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,UAAU,EACX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAA2B,gBAAgB,EAAmD,MAAM,qBAAqB,CAAC;AA8DjI;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAOT;AAMD,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,IAAI,WAAW;IAExB,wCAAwC;IACxC,OAAO,CAAC,MAAM,CAA6B;IAE3C,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAiC;IAEjD,sEAAsE;IACtE,OAAO,CAAC,SAAS,CAAwC;IAEzD,8EAA8E;IAC9E,OAAO,CAAC,qBAAqB,CAA6B;IAE1D;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IAUlC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkEjE,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAsEjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAmXd,aAAa;YA8Bb,wBAAwB;IA+BtC,IAAI,IAAI,IAAI;IAeN,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA2G/B,WAAW,IAAI,YAAY;IA0D3B,gBAAgB,IAAI,aAAa;IAwBjC;;;OAGG;IACH,OAAO,CAAC,aAAa;CAStB"}
+{"version":3,"file":"focus-engine.d.ts","sourceRoot":"","sources":["../src/focus-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,aAAa,EACb,UAAU,EACX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAA2B,gBAAgB,EAAmD,MAAM,qBAAqB,CAAC;AA+DjI;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAOT;AAMD,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,IAAI,WAAW;IAExB,wCAAwC;IACxC,OAAO,CAAC,MAAM,CAA6B;IAE3C,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAiC;IAEjD,sEAAsE;IACtE,OAAO,CAAC,SAAS,CAAwC;IAEzD,8EAA8E;IAC9E,OAAO,CAAC,qBAAqB,CAA6B;IAE1D;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IAUlC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkEjE,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAsEjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YA6Yd,aAAa;YA8Bb,wBAAwB;IA+BtC,IAAI,IAAI,IAAI;IAeN,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA2G/B,WAAW,IAAI,YAAY;IA0D3B,gBAAgB,IAAI,aAAa;IAwBjC;;;OAGG;IACH,OAAO,CAAC,aAAa;CAStB"}

package/dist/focus-engine.js

@@ -43,6 +43,7 @@ import { runCascadeProseTick, runNegativeBranchTick } from './cascade-restatemen
 import { runPrdControllerTickAll } from './prd-controller.js';
 import { runMergeBackTick } from './merge-back-loop.js';
 import { runDriftEvalTick, runPendingDriftEvalRequestsTick } from './drift-eval-loop.js';
+import { runSensorSweepTick } from './sensor-sweep.js';
 import { reconcileDaemonProducts, buildReconcileDeps } from './config-reconcile.js';
 import { buildDefaultSecurityScanDeps, registerScanner, runSecurityScanTick, } from './security-scan-engine.js';
 import { depsScanner } from './scanners/deps.js';
@@ -444,6 +445,29 @@ export class FocusEngine {
         else {
             console.log('Drift-eval loop tick: disabled (TELORA_DRIFT_EVAL_LOOP=0)');
         }
+        // Artifact-health sensor sweep (30 minutes). Deterministic whole-repo mining
+        // (churn/hotspot mass, lint-ratchet counts, dependency freshness) into the
+        // code_metrics DC baseline. Drift-proportional: skips a product whose repo
+        // HEAD + manifest hash are unchanged since its last snapshot. Opt-out via
+        // TELORA_SENSOR_SWEEP_LOOP=0; default ON.
+        if (shouldRunLoop('TELORA_SENSOR_SWEEP_LOOP')) {
+            console.log('Sensor-sweep loop tick: enabled (set TELORA_SENSOR_SWEEP_LOOP=0 to disable)');
+            this.intervals.push(safeInterval(async () => {
+                try {
+                    const counts = await runSensorSweepTick(config);
+                    if (counts.snapshotsWritten > 0) {
+                        console.log(`[sensor-sweep] tick: productsScanned=${counts.productsScanned} ` +
+                            `snapshotsWritten=${counts.snapshotsWritten} skippedUnchanged=${counts.skippedUnchanged}`);
+                    }
+                }
+                catch (err) {
+                    console.warn('[sensor-sweep] tick failed:', err.message);
+                }
+            }, 1_800_000, 'sensor-sweep-loop'));
+        }
+        else {
+            console.log('Sensor-sweep loop tick: disabled (TELORA_SENSOR_SWEEP_LOOP=0)');
+        }
         // Security scan loop (per-product cron cadence inside).
         // Pluggable scanner engine: deps / signatures / workflow.
         // Opt-out via TELORA_SECURITY_SCAN_LOOP=0; default ON.