agent-recall-core 3.4.18 → 3.4.21

package/dist/tools-logic/pipeline-current.js

@@ -0,0 +1,8 @@
+import { resolveProject } from "../storage/project.js";
+import { findActiveMilestone } from "../palace/pipeline.js";
+export async function pipelineCurrent(input) {
+    const slug = await resolveProject(input.project);
+    const milestone = findActiveMilestone(slug);
+    return { success: true, project: slug, milestone };
+}
+//# sourceMappingURL=pipeline-current.js.map

package/dist/tools-logic/pipeline-current.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-current.js","sourceRoot":"","sources":["../../src/tools-logic/pipeline-current.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAkB,MAAM,uBAAuB,CAAC;AAY5E,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAA2B;IAC/D,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AACrD,CAAC"}

package/dist/tools-logic/pipeline-list.d.ts

@@ -0,0 +1,11 @@
+import { type MilestoneSummary } from "../palace/pipeline.js";
+export interface PipelineListInput {
+    project?: string;
+}
+export interface PipelineListResult {
+    success: boolean;
+    project: string;
+    milestones: MilestoneSummary[];
+}
+export declare function pipelineList(input: PipelineListInput): Promise<PipelineListResult>;
+//# sourceMappingURL=pipeline-list.d.ts.map

package/dist/tools-logic/pipeline-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-list.d.ts","sourceRoot":"","sources":["../../src/tools-logic/pipeline-list.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzF,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAIxF"}

package/dist/tools-logic/pipeline-list.js

@@ -0,0 +1,8 @@
+import { resolveProject } from "../storage/project.js";
+import { listMilestones, summarize } from "../palace/pipeline.js";
+export async function pipelineList(input) {
+    const slug = await resolveProject(input.project);
+    const milestones = listMilestones(slug).map(summarize);
+    return { success: true, project: slug, milestones };
+}
+//# sourceMappingURL=pipeline-list.js.map

package/dist/tools-logic/pipeline-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-list.js","sourceRoot":"","sources":["../../src/tools-logic/pipeline-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAyB,MAAM,uBAAuB,CAAC;AAYzF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAwB;IACzD,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AACtD,CAAC"}

package/dist/tools-logic/pipeline-open.d.ts

@@ -0,0 +1,23 @@
+export interface PipelineOpenInput {
+    project?: string;
+    phase_name: string;
+    goal: string;
+    close_previous_with_synthesis?: string;
+    /** Mark this phase as auto-drafted (background process). Default false. */
+    auto?: boolean;
+}
+export interface PipelineOpenResult {
+    success: boolean;
+    project: string;
+    order: number;
+    phase: string;
+    file_path: string;
+    closed_previous?: {
+        order: number;
+        phase: string;
+        file_path: string;
+    };
+    error?: string;
+}
+export declare function pipelineOpen(input: PipelineOpenInput): Promise<PipelineOpenResult>;
+//# sourceMappingURL=pipeline-open.d.ts.map

package/dist/tools-logic/pipeline-open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-open.d.ts","sourceRoot":"","sources":["../../src/tools-logic/pipeline-open.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA0BD,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAyExF"}

package/dist/tools-logic/pipeline-open.js

@@ -0,0 +1,109 @@
+import * as fs from "node:fs";
+import { resolveProject } from "../storage/project.js";
+import { withLock } from "../storage/filelock.js";
+import { syncToSupabase } from "../supabase/sync.js";
+import { findActiveMilestone, nextOrder, writeMilestone, PLACEHOLDER, } from "../palace/pipeline.js";
+/**
+ * Fire-and-forget Supabase sync. Reads the just-written file back inside the
+ * caller's lock window; the actual upload is deferred via setImmediate inside
+ * syncToSupabase, so this never blocks.
+ */
+function syncPipelineFile(filePath, project) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        syncToSupabase(filePath, content, project, "palace", "pipeline");
+    }
+    catch {
+        // Best-effort — Supabase sync failures must never break a write.
+    }
+}
+function autoCloseActive(project, active, synthesis) {
+    const closedAt = new Date().toISOString();
+    const updatedMeta = { ...active.meta, status: "closed", closed: closedAt };
+    const sections = {
+        goal: active.sections.goal,
+        what_was_hard: active.sections.what_was_hard && active.sections.what_was_hard !== PLACEHOLDER
+            ? active.sections.what_was_hard
+            : "(not captured at close)",
+        how_solved: active.sections.how_solved && active.sections.how_solved !== PLACEHOLDER
+            ? active.sections.how_solved
+            : "(not captured at close)",
+        synthesis,
+    };
+    const filePath = writeMilestone(project, updatedMeta, sections, active.file_path);
+    syncPipelineFile(filePath, project);
+    return { order: active.meta.order, phase: active.meta.phase, file_path: filePath };
+}
+export async function pipelineOpen(input) {
+    const slug = await resolveProject(input.project);
+    const phaseName = (input.phase_name ?? "").trim();
+    const goal = (input.goal ?? "").trim();
+    if (!phaseName) {
+        return {
+            success: false,
+            project: slug,
+            order: 0,
+            phase: "",
+            file_path: "",
+            error: "phase_name is required (non-empty after trim).",
+        };
+    }
+    if (!goal) {
+        return {
+            success: false,
+            project: slug,
+            order: 0,
+            phase: phaseName,
+            file_path: "",
+            error: "goal is required (non-empty after trim).",
+        };
+    }
+    return withLock(`pipeline-${slug}`, () => {
+        const active = findActiveMilestone(slug);
+        let closedPrev;
+        if (active) {
+            if (input.close_previous_with_synthesis && input.close_previous_with_synthesis.trim()) {
+                closedPrev = autoCloseActive(slug, active, input.close_previous_with_synthesis.trim());
+            }
+            else {
+                return {
+                    success: false,
+                    project: slug,
+                    order: active.meta.order,
+                    phase: active.meta.phase,
+                    file_path: active.file_path,
+                    error: `Phase ${active.meta.order} (${active.meta.phase}) is still active. Close it with pipeline_close, or pass close_previous_with_synthesis to auto-close.`,
+                };
+            }
+        }
+        const order = nextOrder(slug);
+        const openedAt = new Date().toISOString();
+        const meta = {
+            phase: phaseName,
+            order,
+            status: "active",
+            opened: openedAt,
+            closed: null,
+            auto: input.auto === true,
+        };
+        const sections = {
+            goal,
+            what_was_hard: PLACEHOLDER,
+            how_solved: PLACEHOLDER,
+            synthesis: PLACEHOLDER,
+        };
+        const filePath = writeMilestone(slug, meta, sections);
+        syncPipelineFile(filePath, slug);
+        const result = {
+            success: true,
+            project: slug,
+            order,
+            phase: phaseName,
+            file_path: filePath,
+        };
+        if (closedPrev)
+            result.closed_previous = closedPrev;
+        return result;
+    });
+}
+//# sourceMappingURL=pipeline-open.js.map

package/dist/tools-logic/pipeline-open.js.map

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

package/dist/tools-logic/pipeline-show.d.ts

@@ -0,0 +1,34 @@
+/**
+ * pipeline_show — render a project's narrative spine on demand.
+ *
+ * Reads existing pipeline/*.md milestones + journal entries + corrections.
+ * No writes, no LLM. Lazy reconstruction view of "where is this project."
+ */
+import { type MilestoneSummary } from "../palace/pipeline.js";
+export interface PipelineShowInput {
+    project?: string;
+    /** Render full sections (what_was_hard, how_solved) for the last N phases. Default 3. */
+    detail_last_n?: number;
+}
+export interface SubstrateStats {
+    sessions: {
+        count: number;
+        first_iso: string | null;
+        last_iso: string | null;
+        days_span: number;
+    };
+    corrections: {
+        count: number;
+    };
+}
+export interface PipelineShowResult {
+    success: boolean;
+    project: string;
+    substrate: SubstrateStats;
+    spine: MilestoneSummary[];
+    active: MilestoneSummary | null;
+    /** Pretty-printed combined view, suitable for direct display. */
+    view: string;
+}
+export declare function pipelineShow(input: PipelineShowInput): Promise<PipelineShowResult>;
+//# sourceMappingURL=pipeline-show.d.ts.map

package/dist/tools-logic/pipeline-show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-show.d.ts","sourceRoot":"","sources":["../../src/tools-logic/pipeline-show.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,cAAc,CAAC;IAC1B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;CACd;AA4HD,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAexF"}

package/dist/tools-logic/pipeline-show.js

@@ -0,0 +1,134 @@
+/**
+ * pipeline_show — render a project's narrative spine on demand.
+ *
+ * Reads existing pipeline/*.md milestones + journal entries + corrections.
+ * No writes, no LLM. Lazy reconstruction view of "where is this project."
+ */
+import { resolveProject } from "../storage/project.js";
+import { listJournalFiles } from "../helpers/journal-files.js";
+import { readCorrections } from "../storage/corrections.js";
+import { listMilestones, summarize, } from "../palace/pipeline.js";
+function daysBetween(aISO, bISO) {
+    const a = new Date(aISO).getTime();
+    const b = new Date(bISO).getTime();
+    if (Number.isNaN(a) || Number.isNaN(b))
+        return 0;
+    return Math.max(0, Math.round(Math.abs(b - a) / (1000 * 60 * 60 * 24)));
+}
+function formatDuration(opened, closed, status) {
+    if (status === "active") {
+        const d = daysBetween(opened, new Date().toISOString());
+        return d > 0 ? `${d}d open` : "open today";
+    }
+    if (!closed)
+        return "";
+    const d = daysBetween(opened, closed);
+    return d > 0 ? `${d}d` : "same-day";
+}
+function gatherSubstrate(slug) {
+    const journals = listJournalFiles(slug);
+    const dates = journals.map((j) => j.date).filter(Boolean).sort();
+    const first = dates[0] ?? null;
+    const last = dates[dates.length - 1] ?? null;
+    const corrections = readCorrections(slug);
+    return {
+        sessions: {
+            count: journals.length,
+            first_iso: first,
+            last_iso: last,
+            days_span: first && last ? daysBetween(first, last) : 0,
+        },
+        corrections: { count: corrections.length },
+    };
+}
+function renderPhase(m, detailed) {
+    const lines = [];
+    const statusLabel = m.meta.status === "active" ? "ACTIVE" : m.meta.status === "abandoned" ? "abandoned" : "closed";
+    const autoFlag = m.meta.auto ? " ⚠auto" : "";
+    const dur = formatDuration(m.meta.opened, m.meta.closed ?? null, m.meta.status);
+    const opened = m.meta.opened?.slice(0, 10) ?? "?";
+    const datePart = dur ? `${opened}, ${dur}` : opened;
+    lines.push(`  ${String(m.meta.order).padStart(2, "0")} ${m.meta.phase}  (${statusLabel} ${datePart}${autoFlag})`);
+    const realGoal = m.sections.goal && m.sections.goal !== "(in progress)" ? m.sections.goal : null;
+    if (realGoal)
+        lines.push(`     Goal: ${realGoal}`);
+    if (detailed) {
+        const hard = m.sections.what_was_hard && m.sections.what_was_hard !== "(in progress)" ? m.sections.what_was_hard : null;
+        const how = m.sections.how_solved && m.sections.how_solved !== "(in progress)" ? m.sections.how_solved : null;
+        if (hard)
+            lines.push(`     Hard: ${hard}`);
+        if (how)
+            lines.push(`     Solved by: ${how}`);
+    }
+    if (m.meta.status !== "active" && m.sections.synthesis && m.sections.synthesis !== "(in progress)") {
+        lines.push(`     → ${m.sections.synthesis}`);
+    }
+    if (m.meta.status === "active") {
+        lines.push(`     (in progress — no synthesis yet)`);
+    }
+    lines.push("");
+    return lines;
+}
+function renderView(slug, substrate, milestones, active, detailLastN) {
+    const lines = [];
+    lines.push(`=== ${slug} ===`);
+    const { sessions, corrections } = substrate;
+    if (sessions.count > 0) {
+        if (sessions.count === 1 || sessions.days_span === 0) {
+            lines.push(`Sessions: ${sessions.count} (${sessions.first_iso})`);
+        }
+        else {
+            lines.push(`Sessions: ${sessions.count} over ${sessions.days_span} day${sessions.days_span === 1 ? "" : "s"} (${sessions.first_iso} → ${sessions.last_iso})`);
+        }
+    }
+    if (corrections.count > 0) {
+        lines.push(`Corrections logged: ${corrections.count}`);
+    }
+    const closed = milestones.filter((m) => m.meta.status === "closed").length;
+    const abandoned = milestones.filter((m) => m.meta.status === "abandoned").length;
+    const activeCount = milestones.filter((m) => m.meta.status === "active").length;
+    if (milestones.length > 0) {
+        const parts = [`${closed} closed`];
+        if (abandoned > 0)
+            parts.push(`${abandoned} abandoned`);
+        parts.push(`${activeCount} active`);
+        lines.push(`Phases: ${milestones.length} (${parts.join(", ")})`);
+    }
+    else {
+        lines.push(`Phases: 0`);
+    }
+    lines.push("");
+    if (milestones.length === 0) {
+        lines.push("[No phases yet. Open one with pipeline_open or wait for v1.5 auto-detection.]");
+        return lines.join("\n").trimEnd();
+    }
+    // Render. Detail (hard/solved) only for the last N phases — keeps output bounded.
+    const detailStart = Math.max(0, milestones.length - detailLastN);
+    milestones.forEach((m, i) => {
+        lines.push(...renderPhase(m, i >= detailStart));
+    });
+    if (active) {
+        lines.push(`▶ Currently active: Phase ${active.meta.order} — ${active.meta.phase}`);
+        if (active.sections.goal && active.sections.goal !== "(in progress)") {
+            lines.push(`  Goal: ${active.sections.goal}`);
+        }
+    }
+    return lines.join("\n").trimEnd();
+}
+export async function pipelineShow(input) {
+    const slug = await resolveProject(input.project);
+    const substrate = gatherSubstrate(slug);
+    const milestones = listMilestones(slug);
+    const active = milestones.find((m) => m.meta.status === "active") ?? null;
+    const detailLastN = typeof input.detail_last_n === "number" && input.detail_last_n >= 0 ? input.detail_last_n : 3;
+    const view = renderView(slug, substrate, milestones, active, detailLastN);
+    return {
+        success: true,
+        project: slug,
+        substrate,
+        spine: milestones.map(summarize),
+        active: active ? summarize(active) : null,
+        view,
+    };
+}
+//# sourceMappingURL=pipeline-show.js.map

package/dist/tools-logic/pipeline-show.js.map

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

package/dist/tools-logic/register-rule.d.ts

@@ -0,0 +1,15 @@
+export interface RegisterRuleToolInput {
+    project?: string;
+    name: string;
+    when: string;
+    do: string;
+}
+export interface RegisterRuleToolResult {
+    success: boolean;
+    project: string;
+    rule_id?: string;
+    total_rules?: number;
+    error?: string;
+}
+export declare function registerRule(input: RegisterRuleToolInput): Promise<RegisterRuleToolResult>;
+//# sourceMappingURL=register-rule.d.ts.map

package/dist/tools-logic/register-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-rule.d.ts","sourceRoot":"","sources":["../../src/tools-logic/register-rule.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAShG"}

package/dist/tools-logic/register-rule.js

@@ -0,0 +1,13 @@
+import { resolveProject } from "../storage/project.js";
+import { registerBehaviorRule } from "../storage/behavior-policies.js";
+export async function registerRule(input) {
+    const slug = await resolveProject(input.project);
+    const r = registerBehaviorRule({
+        project: slug,
+        name: input.name,
+        when: input.when,
+        do: input.do,
+    });
+    return { ...r, project: slug };
+}
+//# sourceMappingURL=register-rule.js.map

package/dist/tools-logic/register-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-rule.js","sourceRoot":"","sources":["../../src/tools-logic/register-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAiBvE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAA4B;IAC7D,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,CAAC,GAAG,oBAAoB,CAAC;QAC7B,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,EAAE,EAAE,KAAK,CAAC,EAAE;KACb,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC"}

package/dist/tools-logic/session-end-reflect.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Reflect — Park-2023-style aggregation step.
+ *
+ * The V2 finding: AgentRecall only promotes insights from CORRECTIONS.
+ * Successful patterns never become semantic knowledge. Generative Agents
+ * (Park et al. 2023) showed that periodic LLM-driven distillation of raw
+ * memories into "high-level questions + derived insights" is the move
+ * that makes memory compound.
+ *
+ * Design choice: this tool does NOT call an LLM directly. Core is meant
+ * to stay deterministic + dependency-free of any model API. Instead, we
+ * package the necessary inputs + prompt template into a structured
+ * payload that the calling MCP tool returns to the LLM in the loop, and
+ * the LLM does the synthesis on its own turn. The result can then be
+ * fed back via `skill_write` or `awareness_update`.
+ *
+ * Why: this matches AgentRecall's "agent-as-author" stance — the agent
+ * already in the conversation writes its own reflection, we just give it
+ * the inputs.
+ */
+export interface ReflectInput {
+    project?: string;
+    /** Look back this many days of journal entries. Default 7. */
+    lookback_days?: number;
+}
+export interface ReflectInputBundle {
+    /** Journal entries (file path + first 800 chars) within lookback window. */
+    recent_journals: Array<{
+        date: string;
+        file: string;
+        excerpt: string;
+    }>;
+    /** Active corrections relevant to the lookback window. */
+    active_corrections: Array<{
+        id: string;
+        rule: string;
+        severity: string;
+        precision: number | null;
+    }>;
+    /** Last 3 closed pipeline phases with their synthesis. */
+    recent_phases: Array<{
+        order: number;
+        phase: string;
+        synthesis: string;
+    }>;
+}
+export interface ReflectResult {
+    success: boolean;
+    project: string;
+    bundle: ReflectInputBundle;
+    /** Ready-to-paste prompt the calling LLM can use to write reflection back. */
+    prompt: string;
+    /** Suggested follow-up tool calls. */
+    next_actions: string[];
+}
+export declare function sessionEndReflect(input: ReflectInput): Promise<ReflectResult>;
+//# sourceMappingURL=session-end-reflect.d.ts.map

package/dist/tools-logic/session-end-reflect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-end-reflect.d.ts","sourceRoot":"","sources":["../../src/tools-logic/session-end-reflect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,0DAA0D;IAC1D,kBAAkB,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACpG,0DAA0D;IAC1D,aAAa,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAID,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CA0DnF"}

package/dist/tools-logic/session-end-reflect.js

@@ -0,0 +1,117 @@
+/**
+ * Reflect — Park-2023-style aggregation step.
+ *
+ * The V2 finding: AgentRecall only promotes insights from CORRECTIONS.
+ * Successful patterns never become semantic knowledge. Generative Agents
+ * (Park et al. 2023) showed that periodic LLM-driven distillation of raw
+ * memories into "high-level questions + derived insights" is the move
+ * that makes memory compound.
+ *
+ * Design choice: this tool does NOT call an LLM directly. Core is meant
+ * to stay deterministic + dependency-free of any model API. Instead, we
+ * package the necessary inputs + prompt template into a structured
+ * payload that the calling MCP tool returns to the LLM in the loop, and
+ * the LLM does the synthesis on its own turn. The result can then be
+ * fed back via `skill_write` or `awareness_update`.
+ *
+ * Why: this matches AgentRecall's "agent-as-author" stance — the agent
+ * already in the conversation writes its own reflection, we just give it
+ * the inputs.
+ */
+import { resolveProject } from "../storage/project.js";
+import { readCorrections } from "../storage/corrections.js";
+import { listJournalFiles } from "../helpers/journal-files.js";
+import { listMilestones } from "../palace/pipeline.js";
+import * as fs from "node:fs";
+import * as path from "node:path";
+const EXCERPT_CHARS = 800;
+export async function sessionEndReflect(input) {
+    const slug = await resolveProject(input.project);
+    const lookback = input.lookback_days && input.lookback_days > 0 ? input.lookback_days : 7;
+    const cutoff = new Date(Date.now() - lookback * 86400000);
+    // Collect recent journal excerpts
+    const journals = listJournalFiles(slug);
+    const recentJournals = [];
+    for (const j of journals) {
+        const d = new Date(j.date);
+        if (Number.isNaN(d.getTime()) || d < cutoff)
+            continue;
+        let excerpt = "";
+        try {
+            const content = fs.readFileSync(path.join(j.dir, j.file), "utf-8");
+            excerpt = content.slice(0, EXCERPT_CHARS);
+        }
+        catch {
+            // skip unreadable
+        }
+        recentJournals.push({ date: j.date, file: j.file, excerpt });
+        if (recentJournals.length >= 7)
+            break;
+    }
+    // Active corrections + precision
+    const corrections = readCorrections(slug)
+        .filter((r) => r.active !== false)
+        .slice(0, 20)
+        .map((r) => ({
+        id: r.id,
+        rule: r.rule,
+        severity: r.severity,
+        precision: r.precision ?? null,
+    }));
+    // Last 3 closed phases
+    const allPhases = listMilestones(slug);
+    const recentPhases = allPhases
+        .filter((p) => p.meta.status === "closed")
+        .slice(-3)
+        .map((p) => ({
+        order: p.meta.order,
+        phase: p.meta.phase,
+        synthesis: p.sections.synthesis,
+    }));
+    const bundle = {
+        recent_journals: recentJournals,
+        active_corrections: corrections,
+        recent_phases: recentPhases,
+    };
+    const prompt = buildPrompt(slug, bundle, lookback);
+    const nextActions = [
+        "After reading the bundle, call skill_write for any IF-THEN production rule worth saving (procedural memory).",
+        "Call session_end again with insights[] containing distilled cross-session patterns.",
+        "If a correction's precision < 0.3 across ≥3 retrievals, suggest archiving it (set active:false).",
+    ];
+    return { success: true, project: slug, bundle, prompt, next_actions: nextActions };
+}
+function buildPrompt(slug, bundle, lookback) {
+    const lines = [];
+    lines.push(`# Reflect on ${slug} — last ${lookback} days`);
+    lines.push("");
+    lines.push("You are the agent reviewing your own recent work. Look at the inputs below and produce:");
+    lines.push("");
+    lines.push("1. **Three high-level questions** this period raised (Park 2023 style).");
+    lines.push("2. **Procedural skills** that crystallized — anything repeated ≥2x is a candidate (call skill_write).");
+    lines.push("3. **Cross-session patterns** that aren't yet in awareness — distilled insights worth promoting.");
+    lines.push("4. **Noise to archive** — corrections with low precision that should be retired.");
+    lines.push("");
+    lines.push("Be terse. One bullet per finding. Cite journal dates / phase orders / correction ids as evidence.");
+    lines.push("");
+    lines.push("---");
+    lines.push("");
+    lines.push(`## Journals (${bundle.recent_journals.length})`);
+    for (const j of bundle.recent_journals) {
+        lines.push(`### ${j.date} — ${j.file}`);
+        lines.push(j.excerpt);
+        lines.push("");
+    }
+    lines.push(`## Active corrections (${bundle.active_corrections.length})`);
+    for (const c of bundle.active_corrections) {
+        const p = c.precision !== null ? ` p=${c.precision}` : "";
+        lines.push(`- [${c.id}] (${c.severity}${p}) ${c.rule}`);
+    }
+    lines.push("");
+    lines.push(`## Recent closed phases (${bundle.recent_phases.length})`);
+    for (const ph of bundle.recent_phases) {
+        lines.push(`- Phase ${ph.order} — ${ph.phase}: ${ph.synthesis}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=session-end-reflect.js.map

package/dist/tools-logic/session-end-reflect.js.map

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