@damian87/omp 0.4.1 → 0.5.0

package/dist/src/comms/index.d.ts

@@ -0,0 +1,116 @@
+import { type TmuxApi } from "../team/tmux.js";
+/**
+ * Strip ANSI escape sequences (OSC, CSI, and single-char Fe) from pane text.
+ * The OSC branch is bounded — it stops at the next BEL or ESC and tolerates a
+ * missing terminator (capture-pane can truncate mid-sequence) so it never
+ * greedily consumes real output between two sequences.
+ */
+export declare function stripAnsi(input: string): string;
+export interface OnlineOptions {
+    host?: string;
+    port?: number;
+    timeoutMs?: number;
+}
+/** Low-level reachability probe: resolves true if a TCP connection opens. */
+export type Connector = (host: string, port: number, timeoutMs: number) => Promise<boolean>;
+/**
+ * Returns true when the host appears to have internet connectivity. Defaults
+ * to a TCP probe of 1.1.1.1:443; overridable via env or options for tests and
+ * restricted networks.
+ *
+ * Note: this confirms reachability of the probe host only, not that Copilot's
+ * upstream (GitHub / model API) is reachable. It is a coarse "are we online"
+ * gate, not a Copilot health check.
+ */
+export declare function checkOnline(opts?: OnlineOptions, connect?: Connector): Promise<boolean>;
+export interface CommsDeps {
+    /** tmux API (defaults to the real one). */
+    tmux?: TmuxApi;
+    /** internet reachability check (defaults to {@link checkOnline}). */
+    isOnline?: () => Promise<boolean>;
+    /** sleep used by polling loops (injectable for tests). */
+    sleep?: (ms: number) => Promise<void>;
+}
+export interface StatusResult {
+    ok: true;
+    session: string;
+    /** tmux session exists ("on"). */
+    exists: boolean;
+    /** internet reachable. */
+    online: boolean;
+    /** pane shows an idle prompt (ready for input). */
+    ready: boolean;
+    /** pane shows an active task in progress. */
+    busy: boolean;
+    /** set when the pane existed but its contents could not be read. */
+    error?: string;
+}
+export declare function commsStatus(session: string, deps?: CommsDeps): Promise<StatusResult>;
+export interface SendResult {
+    ok: boolean;
+    session?: string;
+    /** true if the text was observed in the pane before Enter was pressed. */
+    confirmed?: boolean;
+    error?: string;
+}
+export interface SendOptions {
+    /** send even when the pane shows an active task in progress. */
+    force?: boolean;
+}
+/**
+ * Send a prompt into the Copilot pane. Refuses unless the session exists AND
+ * the host is online. Sends the text literally, then a single Enter (C-m).
+ *
+ * Before pressing Enter it tries to confirm the text actually landed in the
+ * input buffer by comparing pane captures before/after the keystrokes (a
+ * delta check, so prompt text already present in scrollback can't false-
+ * confirm). Enter is sent exactly once regardless, so a slow render never
+ * causes a double-submit.
+ */
+export declare function commsSend(session: string, text: string, deps?: CommsDeps, opts?: SendOptions): Promise<SendResult>;
+export interface RecvOptions {
+    /** number of trailing pane lines to capture (default 80). */
+    lines?: number;
+    /** poll until the pane returns to an idle prompt before capturing. */
+    wait?: boolean;
+    /** max time to wait when `wait` is set (default 30000ms). */
+    timeoutMs?: number;
+    /** poll interval when `wait` is set (default 500ms). */
+    pollMs?: number;
+}
+export interface RecvResult {
+    ok: boolean;
+    session?: string;
+    text?: string;
+    /** true if `wait` gave up before the pane became ready (text may be mid-generation). */
+    timedOut?: boolean;
+    error?: string;
+}
+/** Read Copilot's latest pane output back (ANSI-stripped). */
+export declare function commsRecv(session: string, deps?: CommsDeps, opts?: RecvOptions): Promise<RecvResult>;
+/**
+ * Best-effort isolation of the output that appeared *after* a baseline capture.
+ * tmux scrollback has no reliable delimiters, so this uses an order-preserving
+ * multiset diff: lines present in `after` but not already accounted for in
+ * `before` are treated as new, with leading/trailing blank or prompt-only lines
+ * trimmed. It is a heuristic — not a guaranteed exact reply boundary.
+ */
+export declare function newOutputSince(before: string, after: string): string;
+export interface AskOptions extends SendOptions {
+    /** trailing pane lines to consider (default 200). */
+    lines?: number;
+    /** max time to wait for Copilot to go idle (default 30000ms). */
+    timeoutMs?: number;
+    /** poll interval while waiting (default 500ms). */
+    pollMs?: number;
+}
+export interface AskResult extends RecvResult {
+    /** whether the prompt was actually sent. */
+    sent: boolean;
+}
+/**
+ * Send a prompt and return only Copilot's new reply: snapshot the pane, send
+ * (with the same on/online/busy guards as {@link commsSend}), wait until the
+ * pane goes idle, then diff against the snapshot via {@link newOutputSince}.
+ */
+export declare function commsAsk(session: string, text: string, deps?: CommsDeps, opts?: AskOptions): Promise<AskResult>;

package/dist/src/comms/index.js

@@ -0,0 +1,258 @@
+/**
+ * comms — a thin wrapper that lets you talk to a running Copilot CLI session
+ * over tmux: send a prompt in, read the reply back, and check whether Copilot
+ * is reachable first.
+ *
+ * Design notes:
+ * - Reuses the tmux primitives in `../team/tmux.ts` (no new tmux plumbing).
+ * - Every external dependency (tmux, connectivity probe, sleep) is injectable
+ *   so the logic is unit-testable without a real tmux server or network.
+ * - A send is gated on two conditions, mirroring "connected to the internet
+ *   AND on": the target tmux session must exist, and an internet reachability
+ *   probe must succeed. If either fails the send is refused with a structured
+ *   error (never a silent no-op).
+ */
+import { createConnection } from "node:net";
+import { makeTmux, paneLooksReady, paneHasActiveTask, } from "../team/tmux.js";
+/**
+ * Strip ANSI escape sequences (OSC, CSI, and single-char Fe) from pane text.
+ * The OSC branch is bounded — it stops at the next BEL or ESC and tolerates a
+ * missing terminator (capture-pane can truncate mid-sequence) so it never
+ * greedily consumes real output between two sequences.
+ */
+export function stripAnsi(input) {
+    // OSC: ESC ] ... up to BEL or ST (optional, to tolerate truncation).
+    // eslint-disable-next-line no-control-regex
+    const osc = /\][^]*(?:|\\)?/g;
+    // CSI: ESC [ params intermediates final; or a single-char Fe escape.
+    // eslint-disable-next-line no-control-regex
+    const csiFe = /(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g;
+    return input.replace(osc, "").replace(csiFe, "");
+}
+const defaultConnector = (host, port, timeoutMs) => new Promise((resolve) => {
+    let settled = false;
+    const done = (ok) => {
+        if (settled)
+            return;
+        settled = true;
+        try {
+            socket.destroy();
+        }
+        catch {
+            /* ignore */
+        }
+        resolve(ok);
+    };
+    const socket = createConnection({ host, port });
+    socket.setTimeout(timeoutMs);
+    socket.once("connect", () => done(true));
+    socket.once("timeout", () => done(false));
+    socket.once("error", () => done(false));
+});
+/**
+ * Returns true when the host appears to have internet connectivity. Defaults
+ * to a TCP probe of 1.1.1.1:443; overridable via env or options for tests and
+ * restricted networks.
+ *
+ * Note: this confirms reachability of the probe host only, not that Copilot's
+ * upstream (GitHub / model API) is reachable. It is a coarse "are we online"
+ * gate, not a Copilot health check.
+ */
+export async function checkOnline(opts = {}, connect = defaultConnector) {
+    const host = opts.host ?? process.env.OMP_NET_PROBE_HOST ?? "1.1.1.1";
+    const port = opts.port ?? (Number(process.env.OMP_NET_PROBE_PORT) || 443);
+    const timeoutMs = opts.timeoutMs ?? (Number(process.env.OMP_NET_PROBE_TIMEOUT_MS) || 3000);
+    try {
+        return await connect(host, port, timeoutMs);
+    }
+    catch {
+        return false;
+    }
+}
+const defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));
+export async function commsStatus(session, deps = {}) {
+    const tmux = deps.tmux ?? makeTmux();
+    const exists = tmux.sessionExists(session);
+    const online = deps.isOnline ? await deps.isOnline() : await checkOnline();
+    let ready = false;
+    let busy = false;
+    let error;
+    if (exists) {
+        const cap = tmux.capturePane(session, 40);
+        if (cap.status !== 0) {
+            // Session is "on" but unreadable — surface it rather than reporting a
+            // misleading running-but-idle state.
+            error = `failed to read copilot pane (tmux exit ${cap.status})`;
+        }
+        else {
+            const captured = stripAnsi(cap.stdout);
+            ready = paneLooksReady(captured);
+            busy = paneHasActiveTask(captured);
+        }
+    }
+    return { ok: true, session, exists, online, ready, busy, ...(error ? { error } : {}) };
+}
+/**
+ * Send a prompt into the Copilot pane. Refuses unless the session exists AND
+ * the host is online. Sends the text literally, then a single Enter (C-m).
+ *
+ * Before pressing Enter it tries to confirm the text actually landed in the
+ * input buffer by comparing pane captures before/after the keystrokes (a
+ * delta check, so prompt text already present in scrollback can't false-
+ * confirm). Enter is sent exactly once regardless, so a slow render never
+ * causes a double-submit.
+ */
+export async function commsSend(session, text, deps = {}, opts = {}) {
+    if (!text || !text.trim()) {
+        return { ok: false, error: "empty message" };
+    }
+    if (/[\r\n]/.test(text)) {
+        // send-keys delivers embedded newlines literally, which most TUIs treat as
+        // separate submissions — refuse rather than mis-submit a multi-line prompt.
+        return { ok: false, error: "multi-line prompts are not supported; send a single line" };
+    }
+    const tmux = deps.tmux ?? makeTmux();
+    if (!tmux.sessionExists(session)) {
+        return { ok: false, error: `copilot session not running: ${session}` };
+    }
+    const online = deps.isOnline ? await deps.isOnline() : await checkOnline();
+    if (!online) {
+        return { ok: false, error: "offline: no internet connectivity" };
+    }
+    // Read the pane once: doubles as a failure check and a busy-gate baseline.
+    const pre = tmux.capturePane(session, 5);
+    if (pre.status !== 0) {
+        return { ok: false, error: `failed to read copilot pane (tmux exit ${pre.status})` };
+    }
+    const baseline = stripAnsi(pre.stdout);
+    if (!opts.force && paneHasActiveTask(baseline)) {
+        // Don't inject a prompt while Copilot is mid-response — pass force to override.
+        return { ok: false, error: "copilot is busy (task in progress); retry or use --force" };
+    }
+    const sleep = deps.sleep ?? defaultSleep;
+    const probe = text.slice(-Math.min(20, text.length));
+    const probeInBaseline = baseline.includes(probe);
+    const sent = tmux.sendText(session, text);
+    if (sent.status !== 0) {
+        return { ok: false, error: `tmux send-keys failed (exit ${sent.status})` };
+    }
+    // Confirm the literal text landed in the input buffer before pressing Enter,
+    // rather than relying on a fixed delay. Best-effort: send Enter once after
+    // the confirm window regardless, so we never double-submit.
+    let confirmed = false;
+    for (let i = 0; i < 6; i++) {
+        const cap = stripAnsi(tmux.capturePane(session, 5).stdout);
+        // If the probe wasn't already on screen, its appearance confirms the send.
+        // If it was, require the pane to have changed (the new text was appended).
+        if (cap.includes(probe) && (!probeInBaseline || cap !== baseline)) {
+            confirmed = true;
+            break;
+        }
+        await sleep(50);
+    }
+    const enter = tmux.sendKeys(session, "C-m");
+    if (enter.status !== 0) {
+        return { ok: false, error: `tmux send-keys C-m failed (exit ${enter.status})` };
+    }
+    return { ok: true, session, confirmed };
+}
+/** Read Copilot's latest pane output back (ANSI-stripped). */
+export async function commsRecv(session, deps = {}, opts = {}) {
+    const tmux = deps.tmux ?? makeTmux();
+    if (!tmux.sessionExists(session)) {
+        return { ok: false, error: `copilot session not running: ${session}` };
+    }
+    const lines = opts.lines ?? 80;
+    let timedOut = false;
+    if (opts.wait) {
+        const sleep = deps.sleep ?? defaultSleep;
+        const timeoutMs = opts.timeoutMs ?? 30000;
+        const pollMs = opts.pollMs ?? 500;
+        const deadline = Date.now() + timeoutMs;
+        timedOut = true;
+        while (Date.now() < deadline) {
+            const snapshot = stripAnsi(tmux.capturePane(session, lines).stdout);
+            if (paneLooksReady(snapshot) && !paneHasActiveTask(snapshot)) {
+                timedOut = false;
+                break;
+            }
+            await sleep(pollMs);
+        }
+    }
+    const captured = tmux.capturePane(session, lines);
+    if (captured.status !== 0) {
+        return { ok: false, error: `failed to read copilot pane (tmux exit ${captured.status})` };
+    }
+    const text = stripAnsi(captured.stdout);
+    return { ok: true, session, text, ...(opts.wait ? { timedOut } : {}) };
+}
+// --- ask (send + wait + isolate the new reply) ---------------------------
+/** A line that is only whitespace, box-drawing, or a bare prompt glyph. */
+// eslint-disable-next-line no-misleading-character-class
+const PROMPT_ONLY = /^[\s│┃║▌▐▏▕╎┆┊›>❯$#%]*$/;
+/**
+ * Best-effort isolation of the output that appeared *after* a baseline capture.
+ * tmux scrollback has no reliable delimiters, so this uses an order-preserving
+ * multiset diff: lines present in `after` but not already accounted for in
+ * `before` are treated as new, with leading/trailing blank or prompt-only lines
+ * trimmed. It is a heuristic — not a guaranteed exact reply boundary.
+ */
+export function newOutputSince(before, after) {
+    const norm = (s) => s.split("\n").map((l) => l.replace(/\s+$/, ""));
+    const counts = new Map();
+    for (const line of norm(before))
+        counts.set(line, (counts.get(line) ?? 0) + 1);
+    const out = [];
+    for (const line of norm(after)) {
+        const remaining = counts.get(line) ?? 0;
+        if (remaining > 0) {
+            counts.set(line, remaining - 1);
+            continue;
+        }
+        out.push(line);
+    }
+    while (out.length && (!out[0].trim() || PROMPT_ONLY.test(out[0])))
+        out.shift();
+    while (out.length && (!out[out.length - 1].trim() || PROMPT_ONLY.test(out[out.length - 1]))) {
+        out.pop();
+    }
+    return out.join("\n");
+}
+/**
+ * Send a prompt and return only Copilot's new reply: snapshot the pane, send
+ * (with the same on/online/busy guards as {@link commsSend}), wait until the
+ * pane goes idle, then diff against the snapshot via {@link newOutputSince}.
+ */
+export async function commsAsk(session, text, deps = {}, opts = {}) {
+    const tmux = deps.tmux ?? makeTmux();
+    if (!tmux.sessionExists(session)) {
+        return { ok: false, error: `copilot session not running: ${session}`, sent: false };
+    }
+    const lines = opts.lines ?? 200;
+    const pre = tmux.capturePane(session, lines);
+    if (pre.status !== 0) {
+        return { ok: false, error: `failed to read copilot pane (tmux exit ${pre.status})`, sent: false };
+    }
+    const baseline = stripAnsi(pre.stdout);
+    const sent = await commsSend(session, text, deps, { force: opts.force });
+    if (!sent.ok) {
+        return { ok: false, error: sent.error, sent: false };
+    }
+    const recv = await commsRecv(session, deps, {
+        wait: true,
+        lines,
+        timeoutMs: opts.timeoutMs,
+        pollMs: opts.pollMs,
+    });
+    if (!recv.ok) {
+        return { ok: false, error: recv.error, sent: true };
+    }
+    return {
+        ok: true,
+        session,
+        text: newOutputSince(baseline, recv.text ?? ""),
+        timedOut: recv.timedOut,
+        sent: true,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/comms/index.js.map

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

package/dist/src/comms/resolve-session.d.ts

@@ -0,0 +1,35 @@
+import { type TmuxApi } from "../team/tmux.js";
+/**
+ * Regex matching a Copilot session name produced by the launch scheme
+ * (`omp-${Date.now()}`). Naturally excludes `omp-team-*` and any other
+ * non-digit suffixes.
+ */
+export declare const COPILOT_SESSION_RE: RegExp;
+export type ResolveSessionSuccess = {
+    ok: true;
+    session: string;
+    source: "flag" | "env" | "discovery";
+};
+export type ResolveSessionFailure = {
+    ok: false;
+    error: string;
+    candidates?: string[];
+};
+export type ResolveSessionResult = ResolveSessionSuccess | ResolveSessionFailure;
+export interface ResolveSessionOpts {
+    /** Value of the --session CLI flag, if provided. */
+    flag?: string;
+    /** Value of the COPILOT_TMUX_SESSION env var, if set. */
+    env?: string;
+    /** Injected tmux API (defaults to the real one). */
+    tmux?: TmuxApi;
+}
+/**
+ * Resolve the target Copilot tmux session via three-tier precedence:
+ * 1. Explicit --session flag
+ * 2. COPILOT_TMUX_SESSION env var
+ * 3. Auto-discovery: scan tmux for exactly one session matching COPILOT_SESSION_RE
+ *
+ * Returns a structured result — never throws.
+ */
+export declare function resolveSession(opts?: ResolveSessionOpts): ResolveSessionResult;

package/dist/src/comms/resolve-session.js

@@ -0,0 +1,53 @@
+import { makeTmux } from "../team/tmux.js";
+/**
+ * Regex matching a Copilot session name produced by the launch scheme
+ * (`omp-${Date.now()}`). Naturally excludes `omp-team-*` and any other
+ * non-digit suffixes.
+ */
+export const COPILOT_SESSION_RE = /^omp-\d+$/;
+/**
+ * Resolve the target Copilot tmux session via three-tier precedence:
+ * 1. Explicit --session flag
+ * 2. COPILOT_TMUX_SESSION env var
+ * 3. Auto-discovery: scan tmux for exactly one session matching COPILOT_SESSION_RE
+ *
+ * Returns a structured result — never throws.
+ */
+export function resolveSession(opts = {}) {
+    const { flag, env } = opts;
+    const tmux = opts.tmux ?? makeTmux();
+    if (flag && flag.length > 0) {
+        return { ok: true, session: flag, source: "flag" };
+    }
+    if (env && env.length > 0) {
+        return { ok: true, session: env, source: "env" };
+    }
+    let sessions;
+    try {
+        sessions = tmux.listSessions();
+    }
+    catch (err) {
+        // Honor the no-throw contract: surface tmux failures as a structured result.
+        return {
+            ok: false,
+            error: `failed to list tmux sessions (${err instanceof Error ? err.message : String(err)}) — pass --session <name>`,
+        };
+    }
+    const candidates = sessions.filter((name) => COPILOT_SESSION_RE.test(name));
+    if (candidates.length === 1) {
+        return { ok: true, session: candidates[0], source: "discovery" };
+    }
+    if (candidates.length === 0) {
+        return {
+            ok: false,
+            error: "no running copilot session found — launch with `omp`, or pass --session <name>",
+        };
+    }
+    // More than one match — refuse to pick silently.
+    return {
+        ok: false,
+        error: `multiple copilot sessions found — pass --session <name> to specify one:\n  ${candidates.join("\n  ")}`,
+        candidates,
+    };
+}
+//# sourceMappingURL=resolve-session.js.map

package/dist/src/comms/resolve-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-session.js","sourceRoot":"","sources":["../../../src/comms/resolve-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAgB,MAAM,iBAAiB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAC;AAyB9C;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,OAA2B,EAAE;IAC1D,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC;IAErC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACrD,CAAC;IAED,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,6EAA6E;QAC7E,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,iCAAiC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,2BAA2B;SACpH,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5E,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACpE,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,gFAAgF;SACxF,CAAC;IACJ,CAAC;IAED,iDAAiD;IACjD,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,8EAA8E,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;QAC9G,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/src/daily-log.d.ts

@@ -0,0 +1,18 @@
+/** Set/replace today's goal. Returns the date and stored goal. */
+export declare function setDailyGoal(cwd: string, goal: string): {
+    date: string;
+    goal: string;
+};
+/** Append a timestamped entry (`- HH:MM — <text>`) to today's log. */
+export declare function addLogEntry(cwd: string, text: string): {
+    date: string;
+    count: number;
+};
+/**
+ * Delete day-files older than `keepDays` days; returns the removed dates.
+ * Daily files already age out of context (only a breadcrumb is injected and
+ * reads are recency-bounded), so this is disk housekeeping, not a context fix.
+ */
+export declare function pruneDailyLog(cwd: string, keepDays: number): string[];
+/** Read today + the previous `days` days, newest-first, capped to ~4KB. */
+export declare function readDailyLog(cwd: string, days: number): string;

package/dist/src/daily-log.js

@@ -0,0 +1,138 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { ompRoot } from "./omp-root.js";
+const DAY_FILE_RE = /^\d{4}-\d{2}-\d{2}\.md$/;
+const READ_CHAR_BUDGET = 4000;
+function pad(n) {
+    return String(n).padStart(2, "0");
+}
+function todayStr(d = new Date()) {
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+}
+function timeStr(d = new Date()) {
+    return `${pad(d.getHours())}:${pad(d.getMinutes())}`;
+}
+function dailyDir(cwd) {
+    return join(ompRoot(cwd), ".omp", "memory", "daily");
+}
+function dayFile(cwd, date = todayStr()) {
+    return join(dailyDir(cwd), `${date}.md`);
+}
+function parseDay(text) {
+    let section = null;
+    const goalLines = [];
+    const log = [];
+    for (const line of text.split("\n")) {
+        if (/^#\s+/.test(line))
+            continue;
+        if (/^##\s+Goal\s*$/i.test(line)) {
+            section = "goal";
+            continue;
+        }
+        if (/^##\s+Log\s*$/i.test(line)) {
+            section = "log";
+            continue;
+        }
+        if (section === "goal")
+            goalLines.push(line);
+        // Preserve any non-empty line a user may have hand-written, verbatim (bullets,
+        // prose, indented sub-notes). Only blank spacer lines are dropped on round-trip.
+        else if (section === "log" && line.trim() !== "")
+            log.push(line);
+    }
+    return { goal: goalLines.join("\n").trim(), log };
+}
+function serializeDay(date, doc) {
+    const parts = [`# ${date}`, "", "## Goal", doc.goal.trim(), "", "## Log", ...doc.log];
+    return `${parts.join("\n").replace(/\n+$/, "")}\n`;
+}
+function readDay(cwd, date = todayStr()) {
+    const p = dayFile(cwd, date);
+    if (!existsSync(p))
+        return { goal: "", log: [] };
+    try {
+        return parseDay(readFileSync(p, "utf8"));
+    }
+    catch {
+        return { goal: "", log: [] };
+    }
+}
+function writeDay(cwd, doc, date = todayStr()) {
+    const p = dayFile(cwd, date);
+    mkdirSync(dirname(p), { recursive: true });
+    const tmp = `${p}.tmp.${process.pid}.${Date.now()}`;
+    writeFileSync(tmp, serializeDay(date, doc), "utf8");
+    renameSync(tmp, p);
+}
+/** Set/replace today's goal. Returns the date and stored goal. */
+export function setDailyGoal(cwd, goal) {
+    const doc = readDay(cwd);
+    doc.goal = String(goal ?? "").trim();
+    writeDay(cwd, doc);
+    return { date: todayStr(), goal: doc.goal };
+}
+/** Append a timestamped entry (`- HH:MM — <text>`) to today's log. */
+export function addLogEntry(cwd, text) {
+    // Collapse to a single line so an entry can never contain a `## Goal`/`## Log`
+    // marker that parseDay would later misread as a section boundary.
+    const clean = String(text ?? "")
+        .replace(/\s*\n\s*/g, " ")
+        .trim();
+    const doc = readDay(cwd);
+    doc.log.push(`- ${timeStr()} — ${clean}`);
+    writeDay(cwd, doc);
+    return { date: todayStr(), count: doc.log.length };
+}
+/**
+ * Delete day-files older than `keepDays` days; returns the removed dates.
+ * Daily files already age out of context (only a breadcrumb is injected and
+ * reads are recency-bounded), so this is disk housekeeping, not a context fix.
+ */
+export function pruneDailyLog(cwd, keepDays) {
+    const dir = dailyDir(cwd);
+    if (!existsSync(dir))
+        return [];
+    const cutoff = todayStr(new Date(Date.now() - Math.max(0, keepDays) * 86400000));
+    const removed = [];
+    for (const f of readdirSync(dir)) {
+        if (!DAY_FILE_RE.test(f))
+            continue;
+        const date = f.slice(0, 10);
+        if (date < cutoff) {
+            try {
+                unlinkSync(join(dir, f));
+                removed.push(date);
+            }
+            catch {
+                // skip unremovable file
+            }
+        }
+    }
+    return removed.sort();
+}
+/** Read today + the previous `days` days, newest-first, capped to ~4KB. */
+export function readDailyLog(cwd, days) {
+    const dir = dailyDir(cwd);
+    if (!existsSync(dir))
+        return "";
+    const files = readdirSync(dir)
+        .filter((f) => DAY_FILE_RE.test(f))
+        .sort()
+        .reverse()
+        .slice(0, Math.max(0, days) + 1);
+    let out = "";
+    for (const f of files) {
+        try {
+            out += `${readFileSync(join(dir, f), "utf8").trim()}\n\n`;
+        }
+        catch {
+            // skip unreadable day file
+        }
+        if (out.length > READ_CHAR_BUDGET) {
+            out = `${out.slice(0, READ_CHAR_BUDGET)}\n…(truncated)`;
+            break;
+        }
+    }
+    return out.trim();
+}
+//# sourceMappingURL=daily-log.js.map

package/dist/src/daily-log.js.map

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

package/dist/src/goal.d.ts

@@ -0,0 +1,4 @@
+/** The repo objective, or "" when unset. */
+export declare function readRepoGoal(cwd: string): string;
+/** Set/replace the repo objective (collapsed to one north-star line). */
+export declare function writeRepoGoal(cwd: string, goal: string): string;