@telora/daemon 0.21.26 → 0.21.82

package/dist/focus-branch-identity.d.ts

@@ -1,62 +0,0 @@
-/**
- * Focus branch identity: derivation, pinning, and worktree-dir mapping.
- *
- * A focus's branch name was historically re-derived from the LIVE agent-role
- * registry at every spawn (generateFocusBranchName below). A mid-flight role
- * rename/reassignment therefore changed which branch the daemon's git plumbing
- * addressed -- pointing spawns, review-coverage rev-parse, and worktree
- * resolution at a branch that never existed (the 2026-08-06 Tinker Tailor
- * incident).
- *
- * The identity is now PINNED: persisted (product_focuses.branch_name) the first
- * time the focus branch is created, and read back thereafter. resolveFocusBranchName
- * is the single decision point -- read the pinned value if present, otherwise
- * derive it (and signal the caller to persist it, write-once).
- *
- * Extracted into its own light module (only a type import + sanitizeGitSegment,
- * NO @telora/daemon-core / spawn graph) so every consumer -- spawn, lifecycle,
- * provisioning, worktree resolution -- and the unit tests can use it without
- * pulling in focus-executor.ts. focus-executor re-exports generateFocusBranchName
- * for back-compat with existing importers.
- */
-import type { AgentRole } from './types.js';
-/**
- * Derive the focus branch name from the role, focus name, and focus id:
- * `agent/<role>/<focus-name>-<short-id>`. This is the FIRST-CREATION deriver
- * only -- once a focus has a pinned branch_name, consumers read that instead
- * (see resolveFocusBranchName). The short-id is the immutable focus-id prefix.
- */
-export declare function generateFocusBranchName(role: AgentRole, focusName: string, focusId: string): string;
-/**
- * Map a focus branch name to its worktree directory name. The worktree path is
- * `join(worktreeDir, branchName.replace('/', '-'))` (worktree.ts), so a pinned
- * branch name pins the worktree directory too -- one stored value covers both.
- */
-export declare function focusWorktreeDirName(branchName: string): string;
-/** Result of resolving a focus's branch identity. */
-export interface ResolvedFocusBranch {
-    /** The branch name to use for all git plumbing this spawn. */
-    branchName: string;
-    /**
-     * True when `branchName` came from the persisted pin. False when it was
-     * freshly derived because no pin existed yet -- the caller should persist it
-     * (setFocusBranchName) so the identity is captured on first creation.
-     */
-    pinned: boolean;
-}
-/**
- * Resolve a focus's branch identity, preferring the pinned value.
- *
- * If `pinnedBranch` is a non-empty string, it is returned verbatim (immune to
- * role renames -- this is the whole point). Otherwise the name is derived from
- * the current role and `pinned:false` signals the caller to persist it. A
- * blank/whitespace pinned value is treated as absent (defensive against an
- * empty column write).
- */
-export declare function resolveFocusBranchName(args: {
-    pinnedBranch: string | null | undefined;
-    role: AgentRole;
-    focusName: string;
-    focusId: string;
-}): ResolvedFocusBranch;
-//# sourceMappingURL=focus-branch-identity.d.ts.map

package/dist/focus-branch-identity.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"focus-branch-identity.d.ts","sourceRoot":"","sources":["../src/focus-branch-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKnG;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,mBAAmB,CAMtB"}

package/dist/focus-branch-identity.js

@@ -1,59 +0,0 @@
-/**
- * Focus branch identity: derivation, pinning, and worktree-dir mapping.
- *
- * A focus's branch name was historically re-derived from the LIVE agent-role
- * registry at every spawn (generateFocusBranchName below). A mid-flight role
- * rename/reassignment therefore changed which branch the daemon's git plumbing
- * addressed -- pointing spawns, review-coverage rev-parse, and worktree
- * resolution at a branch that never existed (the 2026-08-06 Tinker Tailor
- * incident).
- *
- * The identity is now PINNED: persisted (product_focuses.branch_name) the first
- * time the focus branch is created, and read back thereafter. resolveFocusBranchName
- * is the single decision point -- read the pinned value if present, otherwise
- * derive it (and signal the caller to persist it, write-once).
- *
- * Extracted into its own light module (only a type import + sanitizeGitSegment,
- * NO @telora/daemon-core / spawn graph) so every consumer -- spawn, lifecycle,
- * provisioning, worktree resolution -- and the unit tests can use it without
- * pulling in focus-executor.ts. focus-executor re-exports generateFocusBranchName
- * for back-compat with existing importers.
- */
-import { sanitizeGitSegment } from './git/utils.js';
-/**
- * Derive the focus branch name from the role, focus name, and focus id:
- * `agent/<role>/<focus-name>-<short-id>`. This is the FIRST-CREATION deriver
- * only -- once a focus has a pinned branch_name, consumers read that instead
- * (see resolveFocusBranchName). The short-id is the immutable focus-id prefix.
- */
-export function generateFocusBranchName(role, focusName, focusId) {
-    const sanitizedRoleName = sanitizeGitSegment(role.name);
-    const shortId = focusId.slice(0, 8);
-    const sanitizedFocusName = sanitizeGitSegment(focusName);
-    return `agent/${sanitizedRoleName}/${sanitizedFocusName}-${shortId}`;
-}
-/**
- * Map a focus branch name to its worktree directory name. The worktree path is
- * `join(worktreeDir, branchName.replace('/', '-'))` (worktree.ts), so a pinned
- * branch name pins the worktree directory too -- one stored value covers both.
- */
-export function focusWorktreeDirName(branchName) {
-    return branchName.replace(/\//g, '-');
-}
-/**
- * Resolve a focus's branch identity, preferring the pinned value.
- *
- * If `pinnedBranch` is a non-empty string, it is returned verbatim (immune to
- * role renames -- this is the whole point). Otherwise the name is derived from
- * the current role and `pinned:false` signals the caller to persist it. A
- * blank/whitespace pinned value is treated as absent (defensive against an
- * empty column write).
- */
-export function resolveFocusBranchName(args) {
-    const { pinnedBranch, role, focusName, focusId } = args;
-    if (typeof pinnedBranch === 'string' && pinnedBranch.trim().length > 0) {
-        return { branchName: pinnedBranch, pinned: true };
-    }
-    return { branchName: generateFocusBranchName(role, focusName, focusId), pinned: false };
-}
-//# sourceMappingURL=focus-branch-identity.js.map

package/dist/focus-branch-identity.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"focus-branch-identity.js","sourceRoot":"","sources":["../src/focus-branch-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAe,EAAE,SAAiB,EAAE,OAAe;IACzF,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzD,OAAO,SAAS,iBAAiB,IAAI,kBAAkB,IAAI,OAAO,EAAE,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC;AAcD;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAKtC;IACC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACxD,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACpD,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC1F,CAAC"}

package/dist/focus-engine.d.ts

@@ -1,74 +0,0 @@
-/**
- * FocusEngine -- ExecutionEngine adapter for the focus-based daemon.
- *
- * Wraps the existing daemon modules (listener, heartbeat, spawner, git, etc.)
- * behind the ExecutionEngine interface from @telora/daemon-core. This allows
- * the unified process shell to manage the focus engine without knowing
- * its internals.
- *
- * Lifecycle (called by the process shell):
- *   1. init(config)           -- validate, connect to Supabase, init git
- *   2. recoverFromCrash()     -- reconcile orphaned state from previous run
- *   3. start()                -- begin polling loops and heartbeat
- *   4. stop()                 -- stop accepting new work
- *   5. shutdown()             -- graceful cleanup (kill teams, WIP commit, drain)
- */
-import type { ExecutionEngine, EngineHealth, ResourceUsage, BaseConfig } from '@telora/daemon-core';
-import { ResourceGovernor } from '@telora/daemon-core';
-import type { DaemonConfig } from './types.js';
-/**
- * Decide whether a loop tick should be enabled based on an environment
- * variable. Opt-out semantics:
- *
- *   unset       -> true   (NEW default: loop fires)
- *   ''          -> true   (treated like unset)
- *   '0'         -> false  (explicit opt-out)
- *   anything    -> true   ('1', 'true', 'yes', etc.)
- *
- * Operators disable the loop by setting the env var to '0' (in
- * `.telora/daemon.json`'s `env` block or as a process env var) and
- * restarting the daemon. See `docs/runbook-loop-activation.md`.
- *
- * @param envVarName Name of the process.env variable (e.g. TELORA_FOCUS_LOOP).
- * @param env Optional env source for testing; defaults to process.env.
- */
-export declare function shouldRunLoop(envVarName: string, env?: NodeJS.ProcessEnv): boolean;
-export declare class FocusEngine implements ExecutionEngine {
-    readonly name = "focus";
-    /** Daemon config, set during init(). */
-    private config;
-    /**
-     * Optional resource governor for global concurrency limiting.
-     * Non-private so LOOP_REGISTRY descriptors (focus-loop-registry.ts) can read
-     * it via the structural LoopEngineHost surface.
-     */
-    governor: ResourceGovernor | null;
-    /**
-     * Interval handles for periodic tasks (cleared in stop/shutdown).
-     * Non-private so LOOP_REGISTRY descriptors push their safeInterval handles
-     * here via the structural LoopEngineHost surface.
-     */
-    intervals: ReturnType<typeof setInterval>[];
-    /** Last scanned timestamp for git activity per product (reset on restart). */
-    private lastGitScanTimestamps;
-    /**
-     * Inject a ResourceGovernor for global concurrency limiting.
-     * Called by the process shell after construction but before start().
-     */
-    setGovernor(gov: ResourceGovernor): void;
-    init(config: BaseConfig & Record<string, unknown>): Promise<void>;
-    recoverFromCrash(): Promise<void>;
-    start(): Promise<void>;
-    tickFocusLoop(config: DaemonConfig): Promise<void>;
-    private scanAndUpsertGitActivity;
-    stop(): void;
-    shutdown(): Promise<void>;
-    healthCheck(): EngineHealth;
-    getResourceUsage(): ResourceUsage;
-    /**
-     * Assert that config has been set (init() was called) and return it.
-     * Throws a clear error if called before init().
-     */
-    private requireConfig;
-}
-//# sourceMappingURL=focus-engine.d.ts.map

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

@@ -1 +0,0 @@
-{"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,EAAoC,MAAM,qBAAqB,CAAC;AAClH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA0D/C;;;;;;;;;;;;;;;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;;;;OAIG;IACH,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAEzC;;;;OAIG;IACH,SAAS,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,EAAE,CAAM;IAEjD,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;IA2FtB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;YAiE1C,wBAAwB;IA+BtC,IAAI,IAAI,IAAI;IAeN,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA+F/B,WAAW,IAAI,YAAY;IA8C3B,gBAAgB,IAAI,aAAa;IAsBjC;;;OAGG;IACH,OAAO,CAAC,aAAa;CAStB"}