@prestyj/cli 5.30.2 → 5.31.0

package/dist/core/goal-summary.js

@@ -0,0 +1,104 @@
+/**
+ * Goal list rows, shared by the desktop sidecar (`app-sidecar/goal-routes.ts`)
+ * and ACP mode (`modes/acp-goals.ts`), so both surfaces describe a goal the
+ * same way.
+ */
+import { promises as fs } from "node:fs";
+import { goalWasInterrupted } from "./goals-store.js";
+import { formatRelativeTime } from "./project-discovery.js";
+/** The kickoff/resume instruction is runtime-authored and never shown as a user bubble. */
+export const GOAL_RUNTIME_PROVENANCE = {
+    source: "runtime",
+    kind: "automation",
+    visibility: "hidden",
+};
+/** How much of a session file's end is read to find its last message. */
+const TAIL_BYTES = 64 * 1024;
+/**
+ * The last few messages of a session file (role and content), read from its
+ * end only, never thawing or rewriting it. Empty when it can't be read
+ * (archived, gone): the goal then just isn't marked interrupted.
+ */
+async function lastMessages(file) {
+    let text;
+    try {
+        const handle = await fs.open(file, "r");
+        try {
+            const { size } = await handle.stat();
+            const start = Math.max(0, size - TAIL_BYTES);
+            const buf = Buffer.alloc(size - start);
+            await handle.read(buf, 0, buf.length, start);
+            text = buf.toString("utf-8");
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const line of text.split("\n")) {
+        if (!line.startsWith("{"))
+            continue;
+        try {
+            const entry = JSON.parse(line);
+            if (entry.type === "message" && entry.message?.role) {
+                out.push({ role: entry.message.role, content: entry.message.content });
+            }
+        }
+        catch {
+            // A line cut at the start of the read window.
+        }
+    }
+    return out;
+}
+/** A goal's status for the list (see GoalSummary.status). */
+export function goalListStatus(record, busy, cutOff = false) {
+    if (record.pausedAt)
+        return "paused";
+    if (busy)
+        return "running";
+    if (cutOff)
+        return "interrupted";
+    return record.startedAt ? "idle" : "briefing";
+}
+/** Summarize one goal for a list, from its record and its coordinator sessions. */
+export async function summarizeGoal(sessions, dir, record, busy = false) {
+    const list = await sessions.list(dir).catch(() => []);
+    const withMessages = list.filter((s) => s.messageCount > 0);
+    let lastActiveMs = Date.parse(record.createdAt) || 0;
+    let latestSessionPath = null;
+    let latestSessionId = null;
+    let latestMs = -1;
+    for (const s of withMessages) {
+        const ms = Date.parse(s.lastActivity) || 0;
+        if (ms > latestMs) {
+            latestMs = ms;
+            latestSessionPath = s.path;
+            latestSessionId = s.id;
+        }
+        if (ms > lastActiveMs)
+            lastActiveMs = ms;
+    }
+    return {
+        id: record.id,
+        name: record.name,
+        goal: record.goal,
+        context: record.context,
+        path: dir,
+        createdAt: record.createdAt,
+        lastActiveMs,
+        lastActiveDisplay: formatRelativeTime(lastActiveMs),
+        latestSessionPath,
+        latestSessionId,
+        status: goalListStatus(record, busy, 
+        // Not working, but its last turn never finished: the app closed, or it
+        // was stopped, mid-work. Workers aren't known here, only the session.
+        !busy &&
+            Boolean(record.startedAt) &&
+            latestSessionPath !== null &&
+            goalWasInterrupted(record, await lastMessages(latestSessionPath), [])),
+    };
+}
+//# sourceMappingURL=goal-summary.js.map

package/dist/core/goal-summary.js.map

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

package/dist/core/goals-store.d.ts

@@ -0,0 +1,208 @@
+import { z } from "zod";
+import type { AskQuestion, AskUserResult } from "./ask-user.js";
+/**
+ * Goals: a long-running objective the user hands to EZ Coder ("Bring p95
+ * latency under 200 ms across the whole API"). Each goal is its own folder under
+ * `~/.ezcoder/goals/<id>/` holding `goal.json`; that folder is also the goal's
+ * workspace (the coordinator session's cwd) and, later, its shared library.
+ * Context folders and files the user attaches live elsewhere on disk and are
+ * referenced by absolute path.
+ */
+export declare const GOAL_FILE = "goal.json";
+/** New names stay short enough to read at a glance in the goal list. */
+export declare const GOAL_NAME_MAX = 15;
+export declare const GOAL_TEXT_MAX = 2000;
+export declare const GOAL_CONTEXT_MAX = 20;
+/** Standing instructions the user gives a goal (rules that hold throughout). */
+export declare const GOAL_INSTRUCTIONS_MAX = 4000;
+/** The goal's memory file in its folder: decisions and preferences learned along the way. */
+export declare const GOAL_MEMORY_FILE = "MEMORY.md";
+/** How much of the memory file is loaded into EZ Goals' brief. */
+export declare const GOAL_MEMORY_MAX = 16000;
+declare const contextItemSchema: z.ZodObject<{
+    path: z.ZodString;
+    kind: z.ZodEnum<{
+        file: "file";
+        folder: "folder";
+    }>;
+}, z.core.$strip>;
+declare const goalRecordSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    id: z.ZodString;
+    name: z.ZodString;
+    goal: z.ZodString;
+    context: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        kind: z.ZodEnum<{
+            file: "file";
+            folder: "folder";
+        }>;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+    kickoffAt: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    critterModel: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strip>>;
+    instructions: z.ZodOptional<z.ZodString>;
+    pausedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** What the app sends to create a goal. Context kinds are re-derived on disk. */
+export declare const createGoalInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    goal: z.ZodString;
+    context: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    instructions: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** What the app sends to change a goal's context or instructions after it's created. */
+export declare const updateGoalInputSchema: z.ZodObject<{
+    context: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    instructions: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UpdateGoalInput = z.input<typeof updateGoalInputSchema>;
+export type GoalContextItem = z.infer<typeof contextItemSchema>;
+export type GoalRecord = z.infer<typeof goalRecordSchema>;
+export type CreateGoalInput = z.input<typeof createGoalInputSchema>;
+export type GoalResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: string;
+};
+/** Folder that holds every goal. */
+export declare function goalsRoot(agentDir: string): string;
+/** Lowercase dashed folder name; empty when the name has no usable characters. */
+export declare function goalSlug(name: string): string;
+/** True when `dir` is exactly one goal folder directly inside `root`. */
+export declare function isGoalDir(root: string, dir: string): boolean;
+/** True when `target` is `root` or anything beneath it. */
+export declare function isInsideGoalsRoot(root: string, target: string): boolean;
+/** Read and validate one goal folder's record; null when absent or invalid. */
+export declare function readGoal(dir: string): Promise<GoalRecord | null>;
+/**
+ * Create a goal folder and its record. The folder name is the slug, suffixed
+ * `-2`, `-3`… when taken; `mkdir` without `recursive` makes the claim atomic.
+ */
+export declare function createGoal(root: string, input: CreateGoalInput, now: Date): Promise<GoalResult<{
+    dir: string;
+    record: GoalRecord;
+}>>;
+/** Every valid goal under `root` with its folder. Unreadable folders are skipped. */
+export declare function listGoals(root: string): Promise<Array<{
+    dir: string;
+    record: GoalRecord;
+}>>;
+/**
+ * True while a goal still needs EZ Goals' automatic first reply: the kickoff
+ * was never started and the conversation has no user or assistant message yet.
+ * The system prompt is not conversation, so it does not count.
+ */
+export declare function goalNeedsKickoff(record: GoalRecord, messages: ReadonlyArray<{
+    role: string;
+}>): boolean;
+/** Briefing until the user starts the goal; active from then on. */
+export type GoalPhase = "briefing" | "active";
+export declare function goalPhase(record: GoalRecord): GoalPhase;
+/**
+ * True when an ask_user result is the user choosing to start the goal. An
+ * answer comes back as the option's `value` when it has one, so pass the
+ * questions asked: an option labelled GOAL_START_OPTION counts by its value
+ * too (live bug: EZ Goals gave it the value "start", the answer came back as
+ * "start", and the goal never started).
+ */
+export declare function isGoalStartAnswer(result: AskUserResult, questions?: ReadonlyArray<AskQuestion>): boolean;
+/**
+ * Start the goal if `result` is the user choosing to, whether it came back
+ * while EZ Goals was still waiting on its question or after the question's
+ * deadline passed (a late answer). Returns the started record, or null when
+ * the answer isn't the start option or the goal had already started.
+ */
+export declare function startGoalOnAnswer(dir: string, record: GoalRecord, result: AskUserResult, now: Date, questions?: ReadonlyArray<AskQuestion>): Promise<GoalRecord | null>;
+/**
+ * Pin the model the goal's workers run on, or clear it (null) so they follow
+ * EZ Goals' model. Returns the updated record; null when the goal is gone.
+ */
+export declare function setGoalCritterModel(dir: string, pick: {
+    provider: string;
+    model: string;
+} | null): Promise<GoalRecord | null>;
+/**
+ * Record that the user started the goal. Returns the updated record, or null
+ * when it had already started (or the goal is gone), so it is set only once.
+ */
+export declare function markGoalStarted(dir: string, now: Date): Promise<GoalRecord | null>;
+/**
+ * Change a goal's attached context or standing instructions. Paths are
+ * re-resolved on disk like at creation; an empty instructions string clears
+ * them. Takes effect for the goal's next session (EZ Goals' brief is fixed
+ * for a session, so its prompt cache holds).
+ */
+export declare function updateGoal(dir: string, input: UpdateGoalInput): Promise<GoalResult<GoalRecord>>;
+/** Pause a goal (true) or let it carry on (false). Returns the updated record, or null if missing. */
+export declare function setGoalPaused(dir: string, paused: boolean, now: Date): Promise<GoalRecord | null>;
+/**
+ * The goal's memory: what EZ Goals has written down in its folder's
+ * MEMORY.md (decisions, the user's preferences and corrections, what's done
+ * and what's left). Empty when there's none yet. Long files are cut to
+ * GOAL_MEMORY_MAX, with a note, so the brief stays bounded.
+ */
+export declare function readGoalMemory(dir: string): Promise<string>;
+/**
+ * Delete one goal: its folder (record, notes, artifacts) and the coordinator
+ * sessions stored for it. Attached context lives elsewhere and is untouched.
+ * `id` must name a direct child of `root`; anything else is refused.
+ */
+export declare function deleteGoal(root: string, sessionsDir: string, id: string): Promise<GoalResult<{
+    dir: string;
+}>>;
+/**
+ * Record that the coordinator's first reply has started. Returns null when it
+ * already had (or the goal is gone), so a second caller never kicks off twice.
+ */
+export declare function markGoalKickoff(dir: string, now: Date): Promise<GoalRecord | null>;
+/** The two answers to the coordinator's "ready to start?" question. */
+export declare const GOAL_START_OPTION = "Start the goal now";
+export declare const GOAL_HOLD_OPTION = "Hang on, I want to discuss it more";
+/**
+ * The coordinator's standing brief, appended to the system prompt of a session
+ * whose cwd is a goal folder. Static for the goal's lifetime.
+ */
+/** What EZ Goals' brief carries besides the goal itself, read once per session. */
+export interface GoalBriefExtras {
+    /** The goal folder's MEMORY.md (see readGoalMemory); empty when there's none. */
+    memory?: string;
+    /** Each attached folder's instruction files (AGENTS.md, CLAUDE.md…), by folder. */
+    projectRules?: ReadonlyArray<{
+        readonly folder: string;
+        readonly rules: readonly string[];
+    }>;
+}
+export declare function renderGoalPrompt(dir: string, record: GoalRecord, extras?: GoalBriefExtras): string;
+/** What EZ Goals is told when the user changes the goal's settings mid-session. */
+export declare function goalSettingsNote(record: GoalRecord): string;
+/**
+ * Whether a started goal was cut off mid-work and should pick itself back up
+ * when its session opens again: it isn't paused, and either a worker was
+ * interrupted by the restart or EZ Goals' own last turn never finished (its
+ * last message is a tool call, or a tool result or message with no reply
+ * after it).
+ */
+export declare function goalWasInterrupted(record: GoalRecord, messages: ReadonlyArray<{
+    role: string;
+    content?: unknown;
+}>, workers: ReadonlyArray<{
+    state: string;
+    recovered?: boolean;
+}>): boolean;
+/**
+ * The note behind EZ Goals' first run after the goal was interrupted (the
+ * app closed or crashed mid-work): workers don't survive a restart, so it
+ * checks what got done and carries on with the rest. Cut off mid-briefing,
+ * it asks its question again instead.
+ */
+export declare function goalResumePrompt(record: GoalRecord): string;
+/** The hidden instruction behind the coordinator's first, automatic reply. */
+export declare function goalKickoffPrompt(record: GoalRecord): string;
+export {};