@damian87/omp 0.4.1 → 0.6.0

package/dist/src/project-memory.js

@@ -0,0 +1,105 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { ompRoot } from "./omp-root.js";
+function memPath(cwd) {
+    return join(ompRoot(cwd), ".omp", "project-memory.json");
+}
+function notesDir(cwd) {
+    return join(ompRoot(cwd), ".omp", "memory", "notes");
+}
+// --- directives (rules, injected at session start) ---
+function readMem(cwd) {
+    const p = memPath(cwd);
+    if (!existsSync(p))
+        return { directives: [], updatedAt: new Date(0).toISOString() };
+    try {
+        const data = JSON.parse(readFileSync(p, "utf8"));
+        return {
+            directives: Array.isArray(data?.directives) ? data.directives : [],
+            updatedAt: typeof data?.updatedAt === "string" ? data.updatedAt : new Date(0).toISOString(),
+        };
+    }
+    catch {
+        return { directives: [], updatedAt: new Date(0).toISOString() };
+    }
+}
+function writeMem(cwd, mem) {
+    const p = memPath(cwd);
+    mkdirSync(dirname(p), { recursive: true });
+    const tmp = `${p}.tmp.${process.pid}.${Date.now()}`;
+    writeFileSync(tmp, JSON.stringify({ directives: mem.directives, updatedAt: new Date().toISOString() }, null, 2), "utf8");
+    renameSync(tmp, p);
+}
+export function readDirectives(cwd) {
+    return readMem(cwd).directives;
+}
+/** Append a must-follow directive; returns the new directive count. */
+export function addDirective(cwd, directive) {
+    const mem = readMem(cwd);
+    mem.directives.push(String(directive).trim());
+    writeMem(cwd, mem);
+    return mem.directives.length;
+}
+function slugify(title) {
+    return (String(title)
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 50) || "note");
+}
+/** Create a note (title + optional body); returns its id (slug, deduped). */
+export function addNote(cwd, title, body) {
+    const dir = notesDir(cwd);
+    mkdirSync(dir, { recursive: true });
+    const base = slugify(title);
+    let id = base;
+    let n = 1;
+    while (existsSync(join(dir, `${id}.md`))) {
+        n += 1;
+        id = `${base}-${n}`;
+    }
+    const content = `# ${String(title).trim()}\n${body ? `\n${String(body).trim()}\n` : ""}`;
+    const p = join(dir, `${id}.md`);
+    const tmp = `${p}.tmp.${process.pid}.${Date.now()}`;
+    writeFileSync(tmp, content, "utf8");
+    renameSync(tmp, p);
+    return id;
+}
+/** Cheap index of (id, title) — the only thing surfaced; bodies stay on disk. */
+export function noteIndex(cwd) {
+    const dir = notesDir(cwd);
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((f) => f.endsWith(".md"))
+        .map((f) => {
+        const id = f.replace(/\.md$/, "");
+        let title = id;
+        try {
+            const first = readFileSync(join(dir, f), "utf8").split("\n")[0] ?? "";
+            title = first.replace(/^#\s*/, "").trim() || id;
+        }
+        catch {
+            // keep id as title
+        }
+        return { id, title };
+    })
+        .sort((a, b) => a.id.localeCompare(b.id));
+}
+/** Full note body by id, or null when missing. */
+export function readNote(cwd, id) {
+    // Ids are slugs ([a-z0-9-]); reject anything else so a crafted id can't
+    // escape the notes dir via path traversal (e.g. "../../README").
+    if (!/^[a-z0-9-]+$/i.test(id))
+        return null;
+    const p = join(notesDir(cwd), `${id}.md`);
+    if (!existsSync(p))
+        return null;
+    try {
+        return readFileSync(p, "utf8").trim();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=project-memory.js.map

package/dist/src/project-memory.js.map

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

package/dist/src/schedule/commands.d.ts

@@ -0,0 +1,34 @@
+import { type OsBackend, type ScheduleAddOptions, type ScheduleJob } from "./types.js";
+/**
+ * Resolve the absolute path of the `omp` wrapper to write into OS entries.
+ * The dist `.js` (process.argv[1]) is a last resort because launchd/cron need
+ * the executable wrapper, not the script.
+ */
+export declare function resolveOmpBinPath(): string;
+export interface AddResult {
+    ok: boolean;
+    job?: ScheduleJob;
+    backend?: OsBackend;
+    messages: string[];
+    error?: string;
+}
+export declare function addScheduleJob(stateCwd: string, opts: ScheduleAddOptions): AddResult;
+export interface JobView extends ScheduleJob {
+    osInstalled: boolean;
+}
+export declare function listScheduleJobs(stateCwd: string): JobView[];
+export interface RemoveResult {
+    removed: boolean;
+    uninstalled: boolean;
+}
+export declare function removeScheduleJob(stateCwd: string, id: string): RemoveResult;
+export interface StatusView {
+    job?: ScheduleJob;
+    osInstalled: boolean;
+}
+export declare function getScheduleStatus(stateCwd: string, id: string): StatusView;
+/** Run handler entry used by `omp schedule run|run-now`. Missing job → clean no-op (exit 0). */
+export declare function runScheduleById(stateCwd: string, id: string): Promise<{
+    ok: boolean;
+    message: string;
+}>;

package/dist/src/schedule/commands.js

@@ -0,0 +1,130 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, statSync, unlinkSync } from "node:fs";
+import { getInstalledStatus, installJob, uninstallJob } from "./installer.js";
+import { deleteJob, listJobs, readJob, writeJob } from "./job-store.js";
+import { ensureScheduleDirs, jobFilePath, jobLockPath, resolveSchedulePaths, } from "./paths.js";
+import { runScheduledJob } from "./runner.js";
+import { DEFAULT_TIMEOUT_MS, DEFAULT_TTL_HOURS, } from "./types.js";
+const ID_RE = /^[a-zA-Z0-9_-]+$/;
+const CRON_RE = /^\S+\s+\S+\s+\S+\s+\S+\s+\S+$/; // exactly 5 whitespace-separated fields
+/**
+ * Resolve the absolute path of the `omp` wrapper to write into OS entries.
+ * The dist `.js` (process.argv[1]) is a last resort because launchd/cron need
+ * the executable wrapper, not the script.
+ */
+export function resolveOmpBinPath() {
+    const fromEnv = process.env.OMP_BIN;
+    if (fromEnv)
+        return fromEnv;
+    try {
+        const which = execFileSync("which", ["omp"], { encoding: "utf8" }).trim();
+        if (which)
+            return which;
+    }
+    catch {
+        // not on PATH
+    }
+    return process.argv[1] ?? "omp";
+}
+export function addScheduleJob(stateCwd, opts) {
+    const messages = [];
+    if (!ID_RE.test(opts.id)) {
+        return { ok: false, messages, error: `invalid --id "${opts.id}" (use letters, digits, _ or -)` };
+    }
+    if (!CRON_RE.test(opts.cron)) {
+        return { ok: false, messages, error: `invalid --cron "${opts.cron}" (expected 5 fields)` };
+    }
+    const agentCwd = opts.cwd ?? stateCwd;
+    if (!existsSync(agentCwd) || !statSync(agentCwd).isDirectory()) {
+        return { ok: false, messages, error: `--cwd does not exist or is not a directory: ${agentCwd}` };
+    }
+    const paths = resolveSchedulePaths(stateCwd);
+    ensureScheduleDirs(paths);
+    const allowAllTools = opts.allowAllTools ?? false;
+    // TTL precedence: explicit --ttl-hours wins; else a --max-runs-only job has no
+    // TTL (run-count bounds it); else fall back to the default 72h TTL.
+    const expiresAt = opts.ttlHours !== undefined
+        ? new Date(Date.now() + opts.ttlHours * 3_600_000).toISOString()
+        : opts.maxRuns !== undefined
+            ? undefined
+            : new Date(Date.now() + DEFAULT_TTL_HOURS * 3_600_000).toISOString();
+    const job = {
+        id: opts.id,
+        cron: opts.cron,
+        prompt: opts.prompt,
+        bin: opts.bin ?? "copilot",
+        model: opts.model,
+        cwd: agentCwd,
+        timeoutMs: opts.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+        allowAllTools,
+        createdAt: new Date().toISOString(),
+        expiresAt,
+        maxRuns: opts.maxRuns,
+        runCount: 0,
+        backend: "crontab",
+        ompBinPath: resolveOmpBinPath(),
+        active: true,
+    };
+    if (opts.dryRun) {
+        messages.push(`[dry-run] would install job "${job.id}" (cron ${job.cron}) for agent ${job.bin} in ${job.cwd}`);
+        return { ok: true, job, messages };
+    }
+    // Clean replace: if a job with this id already exists, uninstall its OS entry by
+    // the RECORDED backend first. The new install's detected backend may differ (e.g.
+    // a prior crontab-fallback re-added with a simple cron resolves to launchd), which
+    // would otherwise orphan the old entry.
+    const existing = readJob(jobFilePath(paths.jobsDir, job.id));
+    if (existing)
+        uninstallJob(existing.id, existing.backend);
+    writeJob(jobFilePath(paths.jobsDir, job.id), job);
+    const result = installJob(job, paths.logsDir, paths.cwd);
+    job.backend = result.backend;
+    writeJob(jobFilePath(paths.jobsDir, job.id), job); // persist resolved backend
+    messages.push(`scheduled "${job.id}" via ${job.backend} (cron ${job.cron})`);
+    if (allowAllTools) {
+        messages.push(`⚠ WARNING: "${job.id}" runs UNATTENDED with full tool access (--allow-all-tools) in ${job.cwd}. Ensure the prompt is safe.`);
+    }
+    else {
+        messages.push(`note: "${job.id}" runs without --allow-all-tools, so in unattended (-p, no TTY) mode the agent is limited to read-only/allowlisted tools. Re-add with --allow-all-tools if it must act.`);
+    }
+    return { ok: true, job, backend: job.backend, messages };
+}
+export function listScheduleJobs(stateCwd) {
+    const paths = resolveSchedulePaths(stateCwd);
+    return listJobs(paths.jobsDir).map((job) => ({ ...job, osInstalled: getInstalledStatus(job.id, job.backend) }));
+}
+export function removeScheduleJob(stateCwd, id) {
+    const paths = resolveSchedulePaths(stateCwd);
+    const jobPath = jobFilePath(paths.jobsDir, id);
+    const job = readJob(jobPath);
+    if (!job)
+        return { removed: false, uninstalled: false };
+    uninstallJob(id, job.backend);
+    deleteJob(jobPath);
+    try {
+        unlinkSync(jobLockPath(paths.jobsDir, id));
+    }
+    catch {
+        // no lock to clean
+    }
+    // results + logs are intentionally preserved for audit
+    return { removed: true, uninstalled: true };
+}
+export function getScheduleStatus(stateCwd, id) {
+    const paths = resolveSchedulePaths(stateCwd);
+    const job = readJob(jobFilePath(paths.jobsDir, id));
+    return { job, osInstalled: job ? getInstalledStatus(id, job.backend) : false };
+}
+/** Run handler entry used by `omp schedule run|run-now`. Missing job → clean no-op (exit 0). */
+export async function runScheduleById(stateCwd, id) {
+    const paths = resolveSchedulePaths(stateCwd);
+    const job = readJob(jobFilePath(paths.jobsDir, id));
+    if (!job) {
+        return { ok: true, message: `schedule run: job "${id}" not found (orphan OS entry?); no-op` };
+    }
+    const result = await runScheduledJob(job, paths, {
+        onExpire: (j) => uninstallJob(j.id, j.backend),
+    });
+    return { ok: result.status !== "error", message: `run "${id}" → ${result.status}: ${result.summary}` };
+}
+//# sourceMappingURL=commands.js.map

package/dist/src/schedule/commands.js.map

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

package/dist/src/schedule/installer.d.ts

@@ -0,0 +1,20 @@
+import type { OsBackend, ScheduleJob } from "./types.js";
+export interface DetectOptions {
+    platform?: NodeJS.Platform;
+    hasSystemctl?: boolean;
+}
+/** Pick the native backend for this host. Inputs are injectable for testing. */
+export declare function detectOsBackend(opts?: DetectOptions): OsBackend;
+export interface InstallResult {
+    backend: OsBackend;
+    installed: boolean;
+}
+/**
+ * Install the OS-scheduler entry for a job. On launchd, a cron expression that
+ * StartCalendarInterval cannot express falls back to crontab — the chosen
+ * backend is returned so the caller can persist it on the job.
+ */
+export declare function installJob(job: ScheduleJob, logsDir: string, stateRoot: string, opts?: DetectOptions): InstallResult;
+/** Uninstall by the job's recorded backend. Idempotent — never throws if absent. */
+export declare function uninstallJob(id: string, backend: OsBackend): void;
+export declare function getInstalledStatus(id: string, backend: OsBackend): boolean;

package/dist/src/schedule/installer.js

@@ -0,0 +1,76 @@
+import { execFileSync } from "node:child_process";
+import { cronToLaunchdInterval, installLaunchd, statusLaunchd, uninstallLaunchd } from "./installers/launchd.js";
+import { installCrontab, statusCrontab, uninstallCrontab } from "./installers/crontab.js";
+import { installSystemd, statusSystemd, uninstallSystemd } from "./installers/systemd.js";
+function systemctlAvailable() {
+    try {
+        execFileSync("systemctl", ["--user", "--version"], { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Pick the native backend for this host. Inputs are injectable for testing. */
+export function detectOsBackend(opts = {}) {
+    const platform = opts.platform ?? process.platform;
+    if (platform === "darwin")
+        return "launchd";
+    const hasSystemctl = opts.hasSystemctl ?? systemctlAvailable();
+    if (hasSystemctl)
+        return "systemd";
+    return "crontab";
+}
+/**
+ * Install the OS-scheduler entry for a job. On launchd, a cron expression that
+ * StartCalendarInterval cannot express falls back to crontab — the chosen
+ * backend is returned so the caller can persist it on the job.
+ */
+export function installJob(job, logsDir, stateRoot, opts = {}) {
+    const backend = detectOsBackend(opts);
+    // Replace semantics: clear any prior entry for this id first.
+    uninstallJob(job.id, backend);
+    if (backend === "launchd") {
+        const sched = cronToLaunchdInterval(job.cron);
+        if (sched === null) {
+            // launchd can't express this cron — fall back to crontab.
+            installCrontab(job, logsDir, stateRoot);
+            return { backend: "crontab", installed: true };
+        }
+        installLaunchd(job, sched, logsDir, stateRoot);
+        return { backend: "launchd", installed: true };
+    }
+    if (backend === "systemd") {
+        installSystemd(job, stateRoot);
+        return { backend: "systemd", installed: true };
+    }
+    installCrontab(job, logsDir, stateRoot);
+    return { backend: "crontab", installed: true };
+}
+/** Uninstall by the job's recorded backend. Idempotent — never throws if absent. */
+export function uninstallJob(id, backend) {
+    try {
+        if (backend === "launchd")
+            uninstallLaunchd(id);
+        else if (backend === "systemd")
+            uninstallSystemd(id);
+        else
+            uninstallCrontab(id);
+    }
+    catch {
+        // best effort — entry may already be gone
+    }
+}
+export function getInstalledStatus(id, backend) {
+    try {
+        if (backend === "launchd")
+            return statusLaunchd(id);
+        if (backend === "systemd")
+            return statusSystemd(id);
+        return statusCrontab(id);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=installer.js.map

package/dist/src/schedule/installer.js.map

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

package/dist/src/schedule/installers/crontab.d.ts

@@ -0,0 +1,17 @@
+import type { ScheduleJob } from "../types.js";
+export declare const BLOCK_BEGIN = "# BEGIN omp-schedule";
+export declare const BLOCK_END = "# END omp-schedule";
+/** The crontab command line for a job (without the id marker). */
+export declare function crontabEntryLine(job: ScheduleJob, logsDir: string, stateRoot: string): string;
+/** Parse the managed block of an existing crontab into an ordered id→line map. */
+export declare function parseManagedBlock(existing: string): Map<string, string>;
+/** Pure: add or replace the entry for `id` in the managed block. */
+export declare function applyCrontabBlock(existing: string, id: string, entryLine: string): string;
+/** Pure: remove the entry for `id`; drops the block markers when it empties. */
+export declare function removeCrontabEntry(existing: string, id: string): string;
+export declare function hasCrontabEntry(existing: string, id: string): boolean;
+export declare function readCrontab(): string;
+export declare function writeCrontab(content: string): void;
+export declare function installCrontab(job: ScheduleJob, logsDir: string, stateRoot: string): string;
+export declare function uninstallCrontab(id: string): void;
+export declare function statusCrontab(id: string): boolean;

package/dist/src/schedule/installers/crontab.js

@@ -0,0 +1,112 @@
+import { execSync } from "node:child_process";
+import { join } from "node:path";
+export const BLOCK_BEGIN = "# BEGIN omp-schedule";
+export const BLOCK_END = "# END omp-schedule";
+const ID_PREFIX = "# omp:";
+/** Single-quote a value for safe shell interpolation. */
+function shq(s) {
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+/** The crontab command line for a job (without the id marker). */
+export function crontabEntryLine(job, logsDir, stateRoot) {
+    const logFile = join(logsDir, job.id, `${job.id}.cron.log`);
+    // `omp schedule run` resolves state from --root (independent of the agent cwd).
+    return `${job.cron} ${shq(job.ompBinPath)} schedule run --id ${job.id} --root ${shq(stateRoot)} >> ${shq(logFile)} 2>&1`;
+}
+/** Parse the managed block of an existing crontab into an ordered id→line map. */
+export function parseManagedBlock(existing) {
+    const out = new Map();
+    const lines = existing.split("\n");
+    let inBlock = false;
+    let currentId;
+    for (const line of lines) {
+        if (line.trim() === BLOCK_BEGIN) {
+            inBlock = true;
+            continue;
+        }
+        if (line.trim() === BLOCK_END) {
+            inBlock = false;
+            continue;
+        }
+        if (!inBlock)
+            continue;
+        if (line.startsWith(ID_PREFIX)) {
+            currentId = line.slice(ID_PREFIX.length).trim();
+            continue;
+        }
+        if (currentId && line.trim()) {
+            out.set(currentId, line);
+            currentId = undefined;
+        }
+    }
+    return out;
+}
+/** Strip the managed block, returning everything outside it (trimmed). */
+function stripManagedBlock(existing) {
+    const lines = existing.split("\n");
+    const kept = [];
+    let inBlock = false;
+    for (const line of lines) {
+        if (line.trim() === BLOCK_BEGIN) {
+            inBlock = true;
+            continue;
+        }
+        if (line.trim() === BLOCK_END) {
+            inBlock = false;
+            continue;
+        }
+        if (!inBlock)
+            kept.push(line);
+    }
+    return kept.join("\n").trim();
+}
+/** Render a fresh crontab from outside-block content + the managed entries. */
+function render(outside, entries) {
+    if (entries.size === 0) {
+        return outside ? `${outside}\n` : "";
+    }
+    const block = [BLOCK_BEGIN];
+    for (const [id, line] of entries) {
+        block.push(`${ID_PREFIX}${id}`, line);
+    }
+    block.push(BLOCK_END);
+    return `${outside ? `${outside}\n\n` : ""}${block.join("\n")}\n`;
+}
+/** Pure: add or replace the entry for `id` in the managed block. */
+export function applyCrontabBlock(existing, id, entryLine) {
+    const entries = parseManagedBlock(existing);
+    entries.set(id, entryLine);
+    return render(stripManagedBlock(existing), entries);
+}
+/** Pure: remove the entry for `id`; drops the block markers when it empties. */
+export function removeCrontabEntry(existing, id) {
+    const entries = parseManagedBlock(existing);
+    entries.delete(id);
+    return render(stripManagedBlock(existing), entries);
+}
+export function hasCrontabEntry(existing, id) {
+    return parseManagedBlock(existing).has(id);
+}
+export function readCrontab() {
+    try {
+        return execSync("crontab -l 2>/dev/null", { encoding: "utf8" });
+    }
+    catch {
+        return ""; // no crontab yet
+    }
+}
+export function writeCrontab(content) {
+    execSync("crontab -", { input: content });
+}
+export function installCrontab(job, logsDir, stateRoot) {
+    const next = applyCrontabBlock(readCrontab(), job.id, crontabEntryLine(job, logsDir, stateRoot));
+    writeCrontab(next);
+    return "crontab";
+}
+export function uninstallCrontab(id) {
+    writeCrontab(removeCrontabEntry(readCrontab(), id));
+}
+export function statusCrontab(id) {
+    return hasCrontabEntry(readCrontab(), id);
+}
+//# sourceMappingURL=crontab.js.map

package/dist/src/schedule/installers/crontab.js.map

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

package/dist/src/schedule/installers/launchd.d.ts

@@ -0,0 +1,22 @@
+import type { ScheduleJob } from "../types.js";
+export declare function launchdLabel(id: string): string;
+export declare function launchdPlistPath(id: string): string;
+export interface LaunchdSchedule {
+    startInterval?: number;
+    startCalendarInterval?: {
+        Minute?: number;
+        Hour?: number;
+        Weekday?: number;
+    };
+}
+/**
+ * Translate a simple 5-field cron to a launchd schedule. Returns null for
+ * patterns launchd's StartCalendarInterval cannot cleanly express (lists,
+ * ranges, multi-step) — the caller then falls back to crontab.
+ */
+export declare function cronToLaunchdInterval(cron: string): LaunchdSchedule | null;
+/** Generate the LaunchAgent plist XML. Deliberately omits KeepAlive (timer jobs must not auto-restart). */
+export declare function generatePlist(job: ScheduleJob, sched: LaunchdSchedule, logsDir: string, stateRoot: string): string;
+export declare function installLaunchd(job: ScheduleJob, sched: LaunchdSchedule, logsDir: string, stateRoot: string): void;
+export declare function uninstallLaunchd(id: string): void;
+export declare function statusLaunchd(id: string): boolean;