@poping/yome 0.0.3 → 0.0.4

package/README.md

@@ -63,10 +63,9 @@ The agent loop must not live only in the 30 seconds after you press Enter. It sh
 
 | Capability | Meaning |
 |---|---|
-| **Daemon** | Long-lived background agent; state persists across sessions, no more "thinking only when a window is open" |
+| **Daemon** | Yome runs as an OS-level daemon, not a chat window. It watches your filesystem, calendar, IM signals, and long-running jobs in the background — and only surfaces when something matters. The agent loop never has to be re-spawned from scratch. |
 | **Live compaction** | Long sessions auto-compress history; tokens never overflow, memory never lost |
-| **Custom missions** | Recurring tasks like *"every Monday morning, draft my weekly report"* become reusable missions |
-| **Async agent** | Long jobs run in the background and push notifications when done, instead of blocking your prompt |
+| **Oncall** | The agent is event-driven, not prompt-driven. WeChat / Feishu / Slack / iMessage messages, calendar fires, build finishes, GPU spikes, *@you* mentions — Yome reacts to the world and pages you with a one-line summary + a draft response, instead of waiting for you to ask. |
 
 **Available today:**
 
@@ -76,7 +75,7 @@ yome thread share <session-id> --skill=<slug>   # build redacted case bundle
 yome thread submit <bundle-dir> --skill=<slug>  # publish as PR (needs gh CLI)
 ```
 
-Sessions, history compaction and case bundles ship today. Daemon, custom missions and async agent are next-up on the `next` branch.
+Sessions, history compaction and case bundles ship today. Daemon and Oncall are next-up on the `next` branch.
 
 ---
 
@@ -307,9 +306,8 @@ We do not replace your tools. We **empower** them without interrupting the way y
 | Capability model (sandbox grants) | **stable** |
 | Thread history + case bundles | **stable** |
 | Live history compaction | beta |
-| Daemon (always-on agent) | experimental, on `next` branch |
-| Custom missions (recurring tasks) | next-up |
-| Async agent (background long-running) | next-up |
+| Daemon (OS-level always-on loop) | experimental, on `next` branch |
+| Oncall (event-driven, auto-paging) | next-up |
 
 **Daemon roadmap** *(scoped, on `next`)*
 

package/README.zh-CN.md

@@ -63,10 +63,9 @@ Agent loop 不能只活在用户敲下 Enter 的那 30 秒;它应当 always-on,
 
 | 能力 | 含义 |
 |---|---|
-| **Daemon · 守护进程** | Agent 长驻后台,跨会话保持状态,不再"开个窗口才会思考" |
+| **Daemon · 守护进程** | Yome 是一个跑在系统层的 daemon,而不是一个聊天窗口。它在后台一直盯着你的文件系统、日历、IM 信号、长任务进程,只有真正值得打断你的时候才出现。Agent loop 永远不需要从零冷启动。 |
 | **Live compaction · 即时压缩** | 长会话自动压缩历史,token 永远不爆,记忆永远不丢 |
-| **Custom missions · 定制任务** | 把"每周一上午整理周报"这种重复任务沉淀成可复用 mission |
-| **Async agent · 异步 agent** | 后台跑长任务,完成后主动 push 通知,而不是阻塞你的 prompt |
+| **Oncall · 主动响应** | Agent 由事件驱动,而不是 prompt 驱动。微信 / 飞书 / Slack / iMessage 来消息,日历到点,build 跑完,GPU 飙高,有人 @你 —— Yome 监听这些信号,主动把"这件事 + 一个候选回复"推给你,而不是等你想起来再问它。 |
 
 **当前可用:**
 
@@ -76,7 +75,7 @@ yome thread share <session-id> --skill=<slug>   # 构建脱敏的 case bundle
 yome thread submit <bundle-dir> --skill=<slug>  # 作为 PR 发布 (需要 gh CLI)
 ```
 
-会话 / 历史压缩 / case bundle 这三件已落地。Daemon、custom missions、async agent 在 `next` 分支推进。
+会话 / 历史压缩 / case bundle 这三件已落地。Daemon 与 Oncall 在 `next` 分支推进。
 
 ---
 
@@ -307,9 +306,8 @@ yome --key sk-... --base-url https://… --model …
 | Capability model (sandbox grants) | **stable** |
 | Thread 历史 + case bundles | **stable** |
 | Live history compaction | beta |
-| Daemon (always-on agent) | experimental, 在 `next` 分支 |
-| Custom missions (recurring tasks) | next-up |
-| Async agent (后台长任务) | next-up |
+| Daemon (系统级常驻 loop) | experimental, 在 `next` 分支 |
+| Oncall (事件驱动 / 主动 paging) | next-up |
 
 **Daemon roadmap** *(scoped, 在 `next` 分支)*
 

package/dist/context.js

@@ -93,11 +93,14 @@ You help with software engineering tasks: reading code, writing code, debugging,
 - Never expose secrets or API keys.
 
 ## Available Tools
-You have these tools: Read, Edit, Write, Bash, Glob, Grep, LS.
+You have these tools: Read, Edit, Write, Bash, Yome, AskUser, TodoWrite, Glob, Grep, LS.
 - Use Read to view file contents.
 - Use Edit to modify existing files (find & replace with old_string/new_string).
 - Use Write to create new files.
-- Use Bash to run shell commands.
+- Use Bash for /bin/sh commands ONLY (ls, cat, git, mkdir, build/test runners, pipes…). It does NOT route to hub skills.
+- Use Yome to invoke installed hub-skill commands (xl, ppt, cal, fs, rem, …) — pass the command line exactly as a human would type it (e.g. \`xl books\`, \`ppt new ~/Desktop/x.pptx\`).
+- Use AskUser when requirements are ambiguous or you need the user to choose between trade-offs BEFORE doing irreversible work. Send 1–4 multiple-choice questions; do NOT include "Other" (the UI provides a custom-answer entry). Blocks until the user responds.
+- Use TodoWrite proactively whenever you start a task with 3+ meaningful steps. Always send the FULL list. Keep exactly ONE item in_progress at a time. Flip status the moment you start / finish a step — don't batch updates. Each item needs \`content\` (imperative) + \`activeForm\` (present continuous) + \`status\`.
 - Use Glob to find files by pattern.
 - Use Grep to search file contents.
 - Use LS to list directory contents.
@@ -162,7 +165,7 @@ function buildSkillsSection(skills) {
  * the trigger / effects / entry triad.
  */
 function buildHubSkillsSection(entries) {
-    let section = `\n## Installed Hub Skills\nUse the Bash tool: \`<domain> <action> [args]\` (no \`yome\` prefix, no SkillCall).\n\n`;
+    let section = `\n## Installed Hub Skills\nUse the **Yome** tool: \`<domain> <action> [args]\` (no \`yome\` prefix, no SkillCall, NOT the Bash tool).\nThe Bash tool is for /bin/sh ops only and will NOT route to skills.\n\n`;
     for (const e of entries) {
         const manifest = readManifest(e.installedAt);
         section += renderL1Block(e.domain, manifest, e.description) + '\n';

package/dist/context.js.map

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

package/dist/daemon/calendarPermission.d.ts

@@ -0,0 +1,10 @@
+export interface CalendarAccessResult {
+    ok: boolean;
+    status: 'granted' | 'denied' | 'restricted' | 'not-determined' | 'unknown' | 'no-helper';
+    message: string;
+    /** Hint surfaced from the Swift helper (e.g. "open System Settings → ..."). */
+    fix?: string;
+}
+/** Best-effort path to bin/yome-calwatch. */
+export declare function resolveCalwatchPath(): string;
+export declare function checkCalendarAccess(): CalendarAccessResult;

package/dist/daemon/calendarPermission.js

@@ -0,0 +1,68 @@
+// Pre-flight EventKit permission probe for `yome cron add --on calendar:*`.
+//
+// We invoke the same Swift helper the daemon uses (`yome-calwatch
+// --check-access`) — it's the only reliable way to learn the current
+// state because TCC is per-binary, not per-user.
+//
+// Exit codes (mirrors the helper):
+//   0  granted
+//   2  denied / restricted (with a JSON line describing the fix)
+//   3  unknown
+//   non-existent binary → returns { ok: false, message: '...' }
+import { spawnSync } from 'child_process';
+import { existsSync } from 'fs';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+/** Best-effort path to bin/yome-calwatch. */
+export function resolveCalwatchPath() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    // dist/daemon/calendarPermission.js  → ../../bin/yome-calwatch
+    // src/daemon/calendarPermission.ts   → ../../bin/yome-calwatch
+    return resolve(here, '..', '..', 'bin', 'yome-calwatch');
+}
+export function checkCalendarAccess() {
+    const bin = resolveCalwatchPath();
+    if (!existsSync(bin)) {
+        return {
+            ok: false,
+            status: 'no-helper',
+            message: 'native helper yome-calwatch is missing. ' +
+                'On macOS: cd cli && npm run build:native. ' +
+                'On Linux/Windows: calendar triggers are macOS-only.',
+        };
+    }
+    const r = spawnSync(bin, ['--check-access'], { encoding: 'utf-8', timeout: 30_000 });
+    // Helper writes one JSON line to stdout regardless of exit code.
+    const last = (r.stdout ?? '').split('\n').reverse().find((l) => l.trim().startsWith('{'));
+    let parsed = {};
+    if (last) {
+        try {
+            parsed = JSON.parse(last);
+        }
+        catch { /* noop */ }
+    }
+    const status = String(parsed.status ?? '');
+    const fix = typeof parsed.fix === 'string' ? parsed.fix : undefined;
+    if (r.status === 0 && status === 'granted') {
+        return { ok: true, status: 'granted', message: 'calendar access granted' };
+    }
+    if (status === 'denied' || status === 'restricted') {
+        return {
+            ok: false,
+            status: status,
+            message: `calendar access ${status}`,
+            fix,
+        };
+    }
+    if (status === 'not-determined') {
+        return { ok: false, status: 'not-determined', message: 'calendar access not yet determined', fix };
+    }
+    return {
+        ok: false,
+        status: 'unknown',
+        message: `unable to determine calendar access (helper exit=${r.status}). ` +
+            `stdout=${(r.stdout ?? '').slice(0, 200)} stderr=${(r.stderr ?? '').slice(0, 200)}`,
+        fix,
+    };
+}
+//# sourceMappingURL=calendarPermission.js.map

package/dist/daemon/calendarPermission.js.map

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

package/dist/daemon/cronCli.d.ts

@@ -0,0 +1,19 @@
+export interface CronCliFlags {
+    at?: string;
+    human?: string;
+    once?: string;
+    on?: string;
+    path?: string;
+    within?: string;
+    titleRegex?: string;
+    calendar?: string;
+    tz?: string;
+    cwd?: string;
+    allow?: string | string[];
+    deny?: string | string[];
+    maxMs?: string;
+    env?: string | string[];
+    follow?: boolean;
+    json?: boolean;
+}
+export declare function runCronSubcommand(args: string[], flags: CronCliFlags): Promise<number>;

package/dist/daemon/cronCli.js

@@ -0,0 +1,403 @@
+// `yome cron <subcommand>` — task management UI on top of taskStore.
+//
+// add     create a new task
+// list    list tasks
+// rm      delete a task
+// enable / disable
+// run     manually fire a task right now (out-of-process, like the scheduler does)
+// logs    show audit logs for a task
+//
+// All of these are pure CLI side-effects. The actual scheduling lives in
+// the daemon process; tasks.json is the shared state and the daemon
+// watches it for changes (see scheduler.ts).
+import cron from 'node-cron';
+import { addTask, listTasks, removeTask, getTask, setEnabled } from './taskStore.js';
+import { humanToCron } from './humanCron.js';
+import { humanToOnceMs } from './humanOnce.js';
+import { fireTask, resolveYomeBinPath } from './triggers/cron.js';
+import { listRunsForTask, readRunLog } from './log.js';
+import { readPidIfRunning } from './scheduler.js';
+import { execSync } from 'child_process';
+import { checkCalendarAccess } from './calendarPermission.js';
+export async function runCronSubcommand(args, flags) {
+    const sub = args[0];
+    switch (sub) {
+        case 'add': return doAdd(args.slice(1), flags);
+        case 'list':
+        case 'ls': return doList(flags);
+        case 'rm':
+        case 'remove': return doRm(args.slice(1));
+        case 'enable': return doToggle(args.slice(1), true);
+        case 'disable': return doToggle(args.slice(1), false);
+        case 'run': return doRun(args.slice(1));
+        case 'logs': return doLogs(args.slice(1), flags);
+        case undefined:
+        case 'help':
+        case '--help':
+            printHelp();
+            return 0;
+        default:
+            console.error(`Unknown subcommand: yome cron ${sub}`);
+            printHelp();
+            return 2;
+    }
+}
+function printHelp() {
+    console.log(`Usage: yome cron <subcommand>
+
+  add "<prompt>"   Add a task. Pick exactly one trigger:
+                     --at "<crontab>"        cron schedule, e.g. "0 18 * * *"
+                     --human "<phrase>"      friendly: "9:00", "every 5 min", "mon 9:00"
+                     --once "<time>"         one-shot: "in 5 minutes",
+                                              "tomorrow 9:00", "2026-04-30 18:00", ISO 8601
+                     --on file:<event> --path "<glob>"
+                                              fire on file events. <event> ∈
+                                                change (add+change, default),
+                                                any (add+change+unlink),
+                                                add, unlink
+                                              Glob: "~/Desktop/test/**/*.xlsx"
+                     --on calendar:<event>   fire on macOS Calendar events. <event> ∈
+                                                event-start (default), event-end, event-added
+                                              Filters (calendar only):
+                                                --within "10m"           lead time before start
+                                                --title-regex "^Standup" case-insensitive title match
+                                                --calendar "Work"        calendar display name (substring)
+                   Optional:
+                     --tz <iana>             timezone (default: system local; cron only)
+                     --cwd <dir>             working dir for the task
+                     --allow <rules>         comma-separated allowlist, e.g. "Read,Write,Yome(@yome/fs:*)"
+                     --deny  <rules>         comma-separated denylist
+                     --max-ms <ms>           wall-time cap (default 300000)
+  list / ls         List tasks
+  rm <id>           Remove a task
+  enable <id>       Re-enable a paused task
+  disable <id>      Pause a task without deleting it
+  run <id>          Fire a task immediately (out-of-process)
+  logs <id> [-f]    Show audit logs for a task
+                     -f / --follow            follow the latest run
+
+Tip: edits to tasks.json take effect immediately — the daemon watches
+the file. You don't need to restart the daemon after add/rm/enable.`);
+}
+function doAdd(args, flags) {
+    const prompt = args[0];
+    if (!prompt) {
+        console.error('Usage: yome cron add "<prompt>" <--at|--human|--once|--on ...>');
+        return 2;
+    }
+    // Exactly one trigger type must be specified.
+    const triggerSpecified = [flags.at, flags.human, flags.once, flags.on].filter(Boolean).length;
+    if (triggerSpecified === 0) {
+        console.error('Must specify a trigger: --at, --human, --once, or --on');
+        return 2;
+    }
+    if (triggerSpecified > 1) {
+        console.error('Specify exactly ONE trigger (--at / --human / --once / --on)');
+        return 2;
+    }
+    let trigger;
+    let summary;
+    try {
+        if (flags.at || flags.human) {
+            let schedule;
+            if (flags.at) {
+                if (!cron.validate(flags.at))
+                    throw new Error(`Invalid crontab: '${flags.at}'`);
+                schedule = flags.at;
+            }
+            else {
+                schedule = humanToCron(flags.human);
+            }
+            trigger = { kind: 'cron', schedule, ...(flags.tz ? { tz: flags.tz } : {}) };
+            summary = `cron "${schedule}"${flags.tz ? ` tz=${flags.tz}` : ''}`;
+        }
+        else if (flags.once) {
+            const atMs = humanToOnceMs(flags.once);
+            trigger = { kind: 'once', atMs };
+            summary = `once @ ${new Date(atMs).toISOString()}`;
+        }
+        else if (flags.on) {
+            // file:change      → add+change (any mutation that creates/updates content)
+            // file:any         → add+change+unlink
+            // file:add         → just creates
+            // file:unlink      → just deletions
+            // calendar:event-start | event-end | event-added (each via Swift helper)
+            const [domain, event] = flags.on.split(':');
+            if (domain === 'file') {
+                if (!flags.path)
+                    throw new Error('--on file:* requires --path "<glob>"');
+                const events = mapFileEvent(event ?? 'change');
+                trigger = { kind: 'file', path: flags.path, events };
+                summary = `file ${event ?? 'change'} on ${flags.path}`;
+            }
+            else if (domain === 'calendar') {
+                const ev = (event ?? 'event-start');
+                if (ev !== 'event-start' && ev !== 'event-end' && ev !== 'event-added') {
+                    throw new Error(`unknown calendar event: ${ev} (use event-start | event-end | event-added)`);
+                }
+                // Pre-flight permission probe so the user gets immediate feedback
+                // instead of "task added but never fires". Mirrors option C in the
+                // PR4 plan (helper also re-checks at watcher startup).
+                const access = checkCalendarAccess();
+                if (!access.ok) {
+                    let msg = `cannot add calendar trigger: ${access.message}`;
+                    if (access.fix)
+                        msg += `\n  → ${access.fix}`;
+                    throw new Error(msg);
+                }
+                const leadMs = flags.within ? parseDurationMs(flags.within) : 0;
+                trigger = {
+                    kind: 'calendar',
+                    events: [ev],
+                    ...(leadMs ? { leadMs } : {}),
+                    ...(flags.titleRegex ? { titleRegex: flags.titleRegex } : {}),
+                    ...(flags.calendar ? { calendar: flags.calendar } : {}),
+                };
+                const filterDesc = [
+                    flags.titleRegex ? `title=/${flags.titleRegex}/i` : '',
+                    flags.calendar ? `cal="${flags.calendar}"` : '',
+                    leadMs ? `lead=${flags.within}` : '',
+                ].filter(Boolean).join(' ');
+                summary = `calendar ${ev}${filterDesc ? ` ${filterDesc}` : ''}`;
+            }
+            else {
+                throw new Error(`unknown --on event: ${flags.on}`);
+            }
+        }
+        else {
+            throw new Error('unreachable');
+        }
+    }
+    catch (e) {
+        console.error(`✗ ${e?.message ?? e}`);
+        return 2;
+    }
+    const t = addTask({
+        trigger,
+        prompt,
+        cwd: flags.cwd,
+        autoAllow: parseRuleList(flags.allow),
+        autoDeny: parseRuleList(flags.deny),
+        maxDurationMs: flags.maxMs ? Number.parseInt(flags.maxMs, 10) : undefined,
+        env: parseEnvList(flags.env),
+    });
+    console.log(`✓ added ${t.id}`);
+    console.log(`  trigger:    ${summary}`);
+    console.log(`  prompt:     ${prompt.length > 80 ? prompt.slice(0, 80) + '…' : prompt}`);
+    if (t.autoAllow?.length)
+        console.log(`  autoAllow:  ${t.autoAllow.join(', ')}`);
+    if (t.autoDeny?.length)
+        console.log(`  autoDeny:   ${t.autoDeny.join(', ')}`);
+    if (!readPidIfRunning()) {
+        console.log('');
+        console.log('⚠️  Daemon is not running. Start it with: yome daemon start');
+    }
+    return 0;
+}
+function parseRuleList(s) {
+    if (!s)
+        return undefined;
+    // meow with isMultiple gives us an array; the manual case (single
+    // --allow "a,b,c") gives us a string. Normalise both into a flat
+    // array of comma-trimmed rule names.
+    const parts = Array.isArray(s) ? s : [s];
+    const out = parts.flatMap((p) => p.split(',').map((x) => x.trim()).filter(Boolean));
+    return out.length === 0 ? undefined : out;
+}
+/**
+ * Parse repeated --env KEY=VAL flags (or a single comma-separated string)
+ * into a flat { KEY: VAL } record. Quoted values aren't unescaped — pass
+ * them via shell quoting at the call site.
+ */
+function parseEnvList(s) {
+    if (!s)
+        return undefined;
+    const parts = Array.isArray(s) ? s : [s];
+    const out = {};
+    for (const p of parts) {
+        for (const kv of p.split(',')) {
+            const eq = kv.indexOf('=');
+            if (eq <= 0)
+                continue;
+            const k = kv.slice(0, eq).trim();
+            const v = kv.slice(eq + 1).trim();
+            if (k)
+                out[k] = v;
+        }
+    }
+    return Object.keys(out).length === 0 ? undefined : out;
+}
+/**
+ * Parse a friendly duration string into milliseconds.
+ *   "30s" → 30000   "10m" → 600000   "2h" → 7200000   "500ms" → 500
+ *   bare number → milliseconds.
+ */
+function parseDurationMs(s) {
+    const m = /^(\d+(?:\.\d+)?)\s*(ms|s|m|h)?$/i.exec(s.trim());
+    if (!m)
+        throw new Error(`invalid duration: ${JSON.stringify(s)} (use e.g. "30s", "10m", "2h")`);
+    const n = Number(m[1]);
+    const unit = (m[2] ?? 'ms').toLowerCase();
+    switch (unit) {
+        case 'ms': return Math.round(n);
+        case 's': return Math.round(n * 1000);
+        case 'm': return Math.round(n * 60_000);
+        case 'h': return Math.round(n * 3_600_000);
+        default: return Math.round(n);
+    }
+}
+/**
+ * Map a user-friendly file event token into chokidar event names.
+ *
+ * Most users typing `--on file:change` mean "any time these files are
+ * created, edited, or deleted" rather than chokidar's strict "change =
+ * existing file content modified, distinct from add/unlink". We pick a
+ * sensible default and let power users be explicit.
+ */
+function mapFileEvent(token) {
+    switch (token.toLowerCase()) {
+        case 'change': return ['add', 'change'];
+        case 'any':
+        case '*': return ['add', 'change', 'unlink'];
+        case 'add': return ['add'];
+        case 'unlink':
+        case 'delete': return ['unlink'];
+        default:
+            throw new Error(`unknown file event: '${token}' (try change | add | unlink | any)`);
+    }
+}
+function doList(flags) {
+    const tasks = listTasks();
+    if (flags.json) {
+        process.stdout.write(JSON.stringify(tasks, null, 2) + '\n');
+        return 0;
+    }
+    if (tasks.length === 0) {
+        console.log('(no tasks defined — use `yome cron add ...`)');
+        return 0;
+    }
+    const idW = Math.max(2, ...tasks.map((t) => t.id.length));
+    const schedW = Math.max(8, ...tasks.map((t) => trigSummary(t.trigger).length));
+    const pad = (s, w) => s + ' '.repeat(Math.max(0, w - s.length));
+    console.log(`  ${pad('ID', idW)}  ${pad('SCHEDULE', schedW)}  STATE  LAST-RUN              PROMPT`);
+    for (const t of tasks) {
+        const state = t.enabled ? 'on ' : 'off';
+        const last = t.lastRun
+            ? new Date(t.lastRun.ts).toISOString().replace('T', ' ').slice(0, 19) + (t.lastRun.ok ? ' ok' : ' err')
+            : '—';
+        const prompt = t.prompt.length > 60 ? t.prompt.slice(0, 60) + '…' : t.prompt;
+        console.log(`  ${pad(t.id, idW)}  ${pad(trigSummary(t.trigger), schedW)}  ${state}    ${pad(last, 22)} ${prompt}`);
+    }
+    if (!readPidIfRunning() && tasks.some((t) => t.enabled)) {
+        console.log('');
+        console.log('⚠️  Daemon is not running — enabled tasks will not fire. Start with: yome daemon start');
+    }
+    return 0;
+}
+function trigSummary(trig) {
+    if (trig?.kind === 'cron')
+        return trig.schedule;
+    if (trig?.kind === 'once')
+        return `once @ ${new Date(trig.atMs).toISOString().slice(0, 16)}`;
+    if (trig?.kind === 'file')
+        return `file:${trig.path}`;
+    if (trig?.kind === 'calendar') {
+        const ev = (trig.events ?? ['event-start']).join(',');
+        const bits = [`cal:${ev}`];
+        if (trig.leadMs)
+            bits.push(`-${Math.round(trig.leadMs / 1000)}s`);
+        if (trig.titleRegex)
+            bits.push(`/${trig.titleRegex}/`);
+        if (trig.calendar)
+            bits.push(`@${trig.calendar}`);
+        return bits.join(' ');
+    }
+    return '?';
+}
+function doRm(args) {
+    const id = args[0];
+    if (!id) {
+        console.error('Usage: yome cron rm <id>');
+        return 2;
+    }
+    if (!removeTask(id)) {
+        console.error(`✗ no such task: ${id}`);
+        return 1;
+    }
+    console.log(`✓ removed ${id}`);
+    return 0;
+}
+function doToggle(args, enabled) {
+    const id = args[0];
+    if (!id) {
+        console.error(`Usage: yome cron ${enabled ? 'enable' : 'disable'} <id>`);
+        return 2;
+    }
+    if (!setEnabled(id, enabled)) {
+        console.error(`✗ no such task: ${id}`);
+        return 1;
+    }
+    console.log(`✓ ${enabled ? 'enabled' : 'disabled'} ${id}`);
+    return 0;
+}
+function doRun(args) {
+    const id = args[0];
+    if (!id) {
+        console.error('Usage: yome cron run <id>');
+        return 2;
+    }
+    const t = getTask(id);
+    if (!t) {
+        console.error(`✗ no such task: ${id}`);
+        return 1;
+    }
+    // Spawn out-of-process via the same path the scheduler uses, so behaviour
+    // (stdout capture, kill timer, jsonl logging) matches a scheduled fire.
+    console.log(`→ firing ${id} now (out-of-process)…`);
+    fireTask(id, resolveYomeBinPath(), t);
+    console.log(`✓ task spawned. Watch logs with: yome cron logs ${id} -f`);
+    return 0;
+}
+function doLogs(args, flags) {
+    const id = args[0];
+    if (!id) {
+        console.error('Usage: yome cron logs <id> [-f]');
+        return 2;
+    }
+    const runs = listRunsForTask(id);
+    if (runs.length === 0) {
+        console.log(`(no runs recorded for ${id} yet)`);
+        return 0;
+    }
+    const latest = runs[0];
+    if (flags.follow) {
+        try {
+            execSync(`tail -F "${latest.file}"`, { stdio: 'inherit' });
+        }
+        catch { /* user terminated tail */ }
+        return 0;
+    }
+    console.log(`── latest run: ${new Date(latest.runTs).toISOString()} (${latest.file}) ──`);
+    for (const e of readRunLog(latest.file)) {
+        const t = new Date(e.ts).toISOString().slice(11, 19);
+        if (e.type === 'tool_use') {
+            console.log(`[${t}] tool ${e.name}  ${JSON.stringify(e.input).slice(0, 120)}`);
+        }
+        else if (e.type === 'tool_result') {
+            const r = String(e.result ?? '').replace(/\n/g, ' ').slice(0, 120);
+            console.log(`[${t}] └─ ${r}`);
+        }
+        else if (e.type === 'run_start' || e.type === 'run_end') {
+            console.log(`[${t}] ${e.type} ${JSON.stringify({ ok: e.ok, durationMs: e.durationMs, error: e.error }).slice(0, 200)}`);
+        }
+        else {
+            console.log(`[${t}] ${e.type} ${JSON.stringify(e).slice(0, 200)}`);
+        }
+    }
+    if (runs.length > 1) {
+        console.log('');
+        console.log(`(${runs.length - 1} earlier run(s) in ${latest.file.replace(/\/[^/]+$/, '')})`);
+    }
+    return 0;
+}
+//# sourceMappingURL=cronCli.js.map