@autonav/core 1.5.0 → 1.6.0

package/dist/memento/prompts.js

@@ -0,0 +1,168 @@
+/**
+ * Prompts for Memento Loop
+ *
+ * System prompts and user prompts for navigator and worker agents.
+ * Uses shared Agent Identity Protocol from communication-layer.
+ *
+ * Design principle: The WORKER forgets between iterations (memento pattern).
+ * The NAVIGATOR maintains its own memory and knowledge base - we just provide
+ * git history as context about what the worker has accomplished so far.
+ */
+import { buildAgentIdentityProtocol, } from "@autonav/communication-layer";
+/**
+ * Build the prompt for the navigator to provide an implementation plan
+ *
+ * Uses Agent Identity Protocol when navigator identity is available.
+ * Git history is provided as context about what the worker has done,
+ * but the navigator maintains its own knowledge and memory.
+ */
+export function buildNavPlanPrompt(context, gitLog, navigatorIdentity) {
+    const iterationInfo = context.maxIterations > 0
+        ? `Iteration ${context.iteration} of ${context.maxIterations}`
+        : `Iteration ${context.iteration}`;
+    // Agent Identity Protocol: Explicit role identification and mutual acknowledgment
+    const identityProtocol = buildAgentIdentityProtocol(navigatorIdentity, {
+        name: "Autonav Memento Loop",
+        request: "The memento loop is coordinating implementation work on behalf of the user. Please provide the next implementation plan using the `submit_implementation_plan` tool.",
+    });
+    return `${identityProtocol}# Memento Loop - Planning Phase
+
+You are the **Navigator** guiding a memento loop. Your job is to provide the next implementation plan for the worker agent.
+
+## Task
+
+${context.task}
+
+## Current State
+
+- **${iterationInfo}**
+- **Code Directory:** ${context.codeDirectory}
+- **Branch:** ${context.branch || "(default branch)"}
+
+## Recent Git History (Worker's Progress)
+
+The worker agent has made the following commits. Use this to understand what has been implemented so far:
+
+\`\`\`
+${gitLog || "(No commits yet)"}
+\`\`\`
+
+## Instructions
+
+1. **Analyze** the current state - you may explore the codebase, consult your knowledge base, or use any resources you have
+2. **Determine** what work remains to complete the task
+3. **Create** a focused implementation plan for the next iteration
+4. **Use the submit_implementation_plan tool** to submit your plan
+
+### About the Memento Loop
+
+- The **worker agent forgets** between iterations (it has no memory of previous work)
+- **You** (the navigator) maintain continuity - use your knowledge and judgment
+- The git history shows what the worker has accomplished so far
+- Keep plans focused and incremental - the worker implements one plan at a time
+- Set \`isComplete: true\` when the entire task is done
+- The worker agent will implement your plan, not you
+
+Submit your implementation plan now using the \`submit_implementation_plan\` tool.`;
+}
+/**
+ * Build the system prompt for the navigator agent
+ */
+export function buildNavSystemPrompt(navSystemPrompt) {
+    return `${navSystemPrompt}
+
+# Memento Loop Navigator Role
+
+You are acting as the **Navigator** in a memento loop. Your responsibilities:
+
+1. **Analyze** the current state of the codebase
+2. **Plan** the next implementation steps
+3. **Submit** structured plans via the \`submit_implementation_plan\` tool
+4. **Determine** when the task is complete
+
+You do NOT implement code yourself. You provide plans for the worker agent.
+
+## Key Principles
+
+- Be specific and actionable in your plans
+- Reference concrete files and commands
+- Include clear validation criteria
+- Only mark complete when ALL requirements are met
+- Use conventional commit style for plan summaries (e.g., "feat: add user auth", "fix: resolve login bug")`;
+}
+/**
+ * Build the prompt for the worker agent to implement a plan
+ */
+export function buildWorkerPrompt(codeDirectory, plan) {
+    const stepsText = plan.steps
+        .map((step, i) => `### Step ${i + 1}: ${step.description}
+${step.files?.length ? `- Files: ${step.files.join(", ")}` : ""}
+${step.commands?.length ? `- Commands: ${step.commands.join(", ")}` : ""}`)
+        .join("\n\n");
+    const validationText = plan.validationCriteria
+        .map((c, i) => `${i + 1}. ${c}`)
+        .join("\n");
+    return `# Implementation Task
+
+## Plan Summary
+
+${plan.summary}
+
+## Steps to Implement
+
+${stepsText}
+
+## Validation Criteria
+
+After implementation, verify:
+${validationText}
+
+## Instructions
+
+1. Implement each step in order
+2. After completing all steps, run the validation checks
+3. **Review your code** - read through what you wrote and check for:
+   - Bugs or logic errors
+   - Missing error handling
+   - Code style issues
+   - Incomplete implementations
+4. Fix any issues before finishing
+5. Report what you accomplished
+
+**Important:** Your changes will be committed automatically after you finish. Make sure the code is ready for commit - review and fix before completing.
+
+**Working Directory:** ${codeDirectory}
+
+Begin implementation now.`;
+}
+/**
+ * Build the system prompt for the worker agent
+ */
+export function buildWorkerSystemPrompt(codeDirectory) {
+    return `You are a **Worker Agent** implementing code changes.
+
+## Your Role
+
+You receive implementation plans from the Navigator and execute them precisely.
+
+## Guidelines
+
+1. **Execute** each step in the plan
+2. **Verify** your work against the validation criteria
+3. **Review** your code before finishing - check for bugs, missing error handling, style issues
+4. **Fix** any issues you find
+5. **Report** what you accomplished
+
+## Working Directory
+
+All file paths are relative to: ${codeDirectory}
+
+## Important
+
+- Focus on implementing the plan, not redesigning it
+- If something is unclear, make reasonable assumptions
+- Report any blockers or issues clearly
+- Do not add features beyond what the plan specifies
+- **Review your code** - your changes are committed automatically when you finish`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/memento/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/memento/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,0BAA0B,GAE3B,MAAM,8BAA8B,CAAC;AAiBtC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAyB,EACzB,MAAc,EACd,iBAA4C;IAE5C,MAAM,aAAa,GACjB,OAAO,CAAC,aAAa,GAAG,CAAC;QACvB,CAAC,CAAC,aAAa,OAAO,CAAC,SAAS,OAAO,OAAO,CAAC,aAAa,EAAE;QAC9D,CAAC,CAAC,aAAa,OAAO,CAAC,SAAS,EAAE,CAAC;IAEvC,kFAAkF;IAClF,MAAM,gBAAgB,GAAG,0BAA0B,CAAC,iBAAiB,EAAE;QACrE,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EACL,sKAAsK;KACzK,CAAC,CAAC;IAEH,OAAO,GAAG,gBAAgB;;;;;;EAM1B,OAAO,CAAC,IAAI;;;;MAIR,aAAa;wBACK,OAAO,CAAC,aAAa;gBAC7B,OAAO,CAAC,MAAM,IAAI,kBAAkB;;;;;;;EAOlD,MAAM,IAAI,kBAAkB;;;;;;;;;;;;;;;;;;;mFAmBqD,CAAC;AACpF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,eAAuB;IAC1D,OAAO,GAAG,eAAe;;;;;;;;;;;;;;;;;;;2GAmBgF,CAAC;AAC5G,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,aAAqB,EACrB,IAAwB;IAExB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK;SACzB,GAAG,CACF,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACV,YAAY,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,WAAW;EAC5C,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;EAC7D,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACrE;SACA,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,MAAM,cAAc,GAAG,IAAI,CAAC,kBAAkB;SAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;SAC/B,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;;;EAIP,IAAI,CAAC,OAAO;;;;EAIZ,SAAS;;;;;EAKT,cAAc;;;;;;;;;;;;;;;;yBAgBS,aAAa;;0BAEZ,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,aAAqB;IAC3D,OAAO;;;;;;;;;;;;;;;;kCAgByB,aAAa;;;;;;;;kFAQmC,CAAC;AACnF,CAAC"}

package/dist/memento/state.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Memento State Management
+ *
+ * File-based state persistence for the memento loop.
+ * Uses atomic writes to prevent corruption from crashes.
+ */
+import type { MementoState, MementoOptions } from "./types.js";
+/**
+ * Get the path to the state file for a code directory
+ */
+export declare function getStatePath(codeDirectory: string): string;
+/**
+ * Check if a memento state file exists
+ */
+export declare function stateExists(codeDirectory: string): boolean;
+/**
+ * Load existing state from disk
+ *
+ * @throws {Error} If state file doesn't exist or is invalid
+ */
+export declare function loadState(codeDirectory: string): MementoState;
+/**
+ * Save state to disk atomically
+ *
+ * Uses temp file + rename pattern to prevent corruption
+ */
+export declare function saveState(state: MementoState): void;
+/**
+ * Initialize a new memento state
+ */
+export declare function initializeState(codeDirectory: string, navDirectory: string, task: string, options: MementoOptions): MementoState;
+/**
+ * Increment iteration counter and record timestamp
+ */
+export declare function incrementIteration(state: MementoState): MementoState;
+/**
+ * Record a plan in history
+ */
+export declare function recordPlan(state: MementoState, summary: string): MementoState;
+/**
+ * Mark the loop as completed
+ */
+export declare function completeLoop(state: MementoState, completionMessage?: string): MementoState;
+/**
+ * Check if the loop should continue
+ */
+export declare function shouldContinue(state: MementoState): boolean;
+/**
+ * Delete state file (cleanup after successful completion)
+ */
+export declare function deleteState(codeDirectory: string): void;
+/**
+ * Get or initialize state based on options
+ */
+export declare function getOrInitializeState(codeDirectory: string, navDirectory: string, task: string, options: MementoOptions): MementoState;
+//# sourceMappingURL=state.d.ts.map

package/dist/memento/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/memento/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAM/D;;GAEG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,YAAY,CAmB7D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAgBnD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,YAAY,CAmBd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAKpE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAQ7E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,YAAY,CAK1F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAU3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAMvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,YAAY,CAsBd"}

package/dist/memento/state.js

@@ -0,0 +1,156 @@
+/**
+ * Memento State Management
+ *
+ * File-based state persistence for the memento loop.
+ * Uses atomic writes to prevent corruption from crashes.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { randomUUID } from "node:crypto";
+const STATE_DIR = ".autonav";
+const STATE_FILE = "memento-state.json";
+const STATE_VERSION = "1.0.0";
+/**
+ * Get the path to the state file for a code directory
+ */
+export function getStatePath(codeDirectory) {
+    return path.join(codeDirectory, STATE_DIR, STATE_FILE);
+}
+/**
+ * Check if a memento state file exists
+ */
+export function stateExists(codeDirectory) {
+    return fs.existsSync(getStatePath(codeDirectory));
+}
+/**
+ * Load existing state from disk
+ *
+ * @throws {Error} If state file doesn't exist or is invalid
+ */
+export function loadState(codeDirectory) {
+    const statePath = getStatePath(codeDirectory);
+    if (!fs.existsSync(statePath)) {
+        throw new Error(`No memento state found at ${statePath}. Use --resume=false to start a new run.`);
+    }
+    const content = fs.readFileSync(statePath, "utf-8");
+    const state = JSON.parse(content);
+    // Validate version
+    if (state.version !== STATE_VERSION) {
+        throw new Error(`State version mismatch: found ${state.version}, expected ${STATE_VERSION}. ` +
+            `Manual migration may be required.`);
+    }
+    return state;
+}
+/**
+ * Save state to disk atomically
+ *
+ * Uses temp file + rename pattern to prevent corruption
+ */
+export function saveState(state) {
+    const statePath = getStatePath(state.codeDirectory);
+    const stateDir = path.dirname(statePath);
+    const tempPath = path.join(stateDir, `.memento-state-${Date.now()}.tmp`);
+    // Ensure .autonav directory exists
+    if (!fs.existsSync(stateDir)) {
+        fs.mkdirSync(stateDir, { recursive: true });
+    }
+    // Update timestamp
+    state.lastUpdated = new Date().toISOString();
+    // Write to temp file, then rename atomically
+    fs.writeFileSync(tempPath, JSON.stringify(state, null, 2));
+    fs.renameSync(tempPath, statePath);
+}
+/**
+ * Initialize a new memento state
+ */
+export function initializeState(codeDirectory, navDirectory, task, options) {
+    const state = {
+        version: STATE_VERSION,
+        runId: randomUUID(),
+        codeDirectory: path.resolve(codeDirectory),
+        navDirectory: path.resolve(navDirectory),
+        task,
+        branch: options.branch,
+        iteration: 0,
+        maxIterations: options.maxIterations,
+        promise: options.promise,
+        completed: false,
+        lastUpdated: new Date().toISOString(),
+        iterationTimestamps: [],
+        planHistory: [],
+    };
+    saveState(state);
+    return state;
+}
+/**
+ * Increment iteration counter and record timestamp
+ */
+export function incrementIteration(state) {
+    state.iteration += 1;
+    state.iterationTimestamps.push(new Date().toISOString());
+    saveState(state);
+    return state;
+}
+/**
+ * Record a plan in history
+ */
+export function recordPlan(state, summary) {
+    state.planHistory.push({
+        iteration: state.iteration,
+        summary,
+        timestamp: new Date().toISOString(),
+    });
+    saveState(state);
+    return state;
+}
+/**
+ * Mark the loop as completed
+ */
+export function completeLoop(state, completionMessage) {
+    state.completed = true;
+    state.completionMessage = completionMessage;
+    saveState(state);
+    return state;
+}
+/**
+ * Check if the loop should continue
+ */
+export function shouldContinue(state) {
+    if (state.completed) {
+        return false;
+    }
+    if (state.maxIterations > 0 && state.iteration >= state.maxIterations) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Delete state file (cleanup after successful completion)
+ */
+export function deleteState(codeDirectory) {
+    const statePath = getStatePath(codeDirectory);
+    if (fs.existsSync(statePath)) {
+        fs.unlinkSync(statePath);
+    }
+}
+/**
+ * Get or initialize state based on options
+ */
+export function getOrInitializeState(codeDirectory, navDirectory, task, options) {
+    if (options.resume && stateExists(codeDirectory)) {
+        const state = loadState(codeDirectory);
+        // Validate that the resumed state matches current parameters
+        if (state.navDirectory !== path.resolve(navDirectory)) {
+            throw new Error(`Navigator directory mismatch: state has ${state.navDirectory}, ` +
+                `but ${navDirectory} was provided. Delete state file to start fresh.`);
+        }
+        return state;
+    }
+    // If state exists but not resuming, warn and overwrite
+    if (stateExists(codeDirectory) && !options.resume) {
+        console.warn(`Warning: Existing state found. Starting fresh (use --resume to continue).`);
+        deleteState(codeDirectory);
+    }
+    return initializeState(codeDirectory, navDirectory, task, options);
+}
+//# sourceMappingURL=state.js.map

package/dist/memento/state.js.map

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

package/dist/memento/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Memento Loop Types
+ *
+ * Core type definitions for the context-clearing iterative development loop
+ * that coordinates navigator (planning) and worker (implementation) agents.
+ *
+ * Design principle: The WORKER forgets between iterations (memento pattern).
+ * The NAVIGATOR maintains its own memory. Git commits track worker progress.
+ * All types here are for in-memory use during loop execution.
+ */
+import { z } from "zod";
+/**
+ * Schema for implementation plan steps
+ */
+export declare const ImplementationStepSchema: z.ZodObject<{
+    description: z.ZodString;
+    files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    commands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    files?: string[] | undefined;
+    commands?: string[] | undefined;
+}, {
+    description: string;
+    files?: string[] | undefined;
+    commands?: string[] | undefined;
+}>;
+/**
+ * Schema for implementation plan returned by navigator
+ */
+export declare const ImplementationPlanSchema: z.ZodObject<{
+    summary: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        commands: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        files?: string[] | undefined;
+        commands?: string[] | undefined;
+    }, {
+        description: string;
+        files?: string[] | undefined;
+        commands?: string[] | undefined;
+    }>, "many">;
+    validationCriteria: z.ZodArray<z.ZodString, "many">;
+    isComplete: z.ZodBoolean;
+    completionMessage: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    steps: {
+        description: string;
+        files?: string[] | undefined;
+        commands?: string[] | undefined;
+    }[];
+    validationCriteria: string[];
+    isComplete: boolean;
+    completionMessage?: string | undefined;
+}, {
+    summary: string;
+    steps: {
+        description: string;
+        files?: string[] | undefined;
+        commands?: string[] | undefined;
+    }[];
+    validationCriteria: string[];
+    isComplete: boolean;
+    completionMessage?: string | undefined;
+}>;
+export type ImplementationStep = z.infer<typeof ImplementationStepSchema>;
+export type ImplementationPlan = z.infer<typeof ImplementationPlanSchema>;
+/**
+ * Result from worker agent execution
+ */
+export interface WorkerResult {
+    /** Whether the worker completed successfully */
+    success: boolean;
+    /** Summary of what was done */
+    summary: string;
+    /** Files that were modified */
+    filesModified: string[];
+    /** Any errors encountered */
+    errors?: string[];
+    /** Duration in milliseconds */
+    durationMs: number;
+}
+/**
+ * Command line options for memento command
+ */
+export interface MementoOptions {
+    /** Create and push to a new PR when complete */
+    pr?: boolean;
+    /** Maximum iterations (0 = unlimited) */
+    maxIterations: number;
+    /** Completion signal text */
+    promise: string;
+    /** Git branch name for work */
+    branch?: string;
+    /** Task description (overrides TASK.md) */
+    task?: string;
+    /** Show detailed logging */
+    verbose?: boolean;
+}
+/**
+ * Final result of memento loop execution
+ */
+export interface MementoResult {
+    /** Whether the task completed successfully */
+    success: boolean;
+    /** Number of iterations performed */
+    iterations: number;
+    /** Completion message from nav */
+    completionMessage?: string;
+    /** PR URL if --pr was used */
+    prUrl?: string;
+    /** Git branch name */
+    branch?: string;
+    /** Total duration in milliseconds */
+    durationMs: number;
+    /** Any errors that occurred */
+    errors?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/memento/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memento/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,EAAE,CAAC,EAAE,OAAO,CAAC;IAEb,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IAEtB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IAEjB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/memento/types.js

@@ -0,0 +1,30 @@
+/**
+ * Memento Loop Types
+ *
+ * Core type definitions for the context-clearing iterative development loop
+ * that coordinates navigator (planning) and worker (implementation) agents.
+ *
+ * Design principle: The WORKER forgets between iterations (memento pattern).
+ * The NAVIGATOR maintains its own memory. Git commits track worker progress.
+ * All types here are for in-memory use during loop execution.
+ */
+import { z } from "zod";
+/**
+ * Schema for implementation plan steps
+ */
+export const ImplementationStepSchema = z.object({
+    description: z.string().describe("What this step accomplishes"),
+    files: z.array(z.string()).optional().describe("Files to create or modify"),
+    commands: z.array(z.string()).optional().describe("Commands to run"),
+});
+/**
+ * Schema for implementation plan returned by navigator
+ */
+export const ImplementationPlanSchema = z.object({
+    summary: z.string().describe("Brief summary of what this plan will accomplish"),
+    steps: z.array(ImplementationStepSchema).describe("Ordered implementation steps"),
+    validationCriteria: z.array(z.string()).describe("How to verify the implementation worked"),
+    isComplete: z.boolean().describe("True if the overall task is complete and no more iterations needed"),
+    completionMessage: z.string().optional().describe("Message to display when isComplete is true"),
+});
+//# sourceMappingURL=types.js.map

package/dist/memento/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memento/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC/D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IAC3E,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;CACrE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IAC/E,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACjF,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC3F,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IACtG,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAChG,CAAC,CAAC"}

package/dist/memento/worker-agent.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Worker Agent for Memento Loop
+ *
+ * Executes implementation plans using the Claude Agent SDK.
+ */
+import type { ImplementationPlan, WorkerResult } from "./types.js";
+/**
+ * Minimal context for worker (no persisted state)
+ */
+interface WorkerContext {
+    codeDirectory: string;
+    task: string;
+}
+/**
+ * Options for worker agent execution
+ */
+export interface WorkerAgentOptions {
+    /** Show detailed logging */
+    verbose?: boolean;
+    /** Model to use (defaults to claude-sonnet-4-5) */
+    model?: string;
+    /** Maximum turns for worker agent */
+    maxTurns?: number;
+}
+/**
+ * Run the worker agent to implement a plan
+ */
+export declare function runWorkerAgent(context: WorkerContext, plan: ImplementationPlan, options?: WorkerAgentOptions): Promise<WorkerResult>;
+export {};
+//# sourceMappingURL=worker-agent.d.ts.map

package/dist/memento/worker-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-agent.d.ts","sourceRoot":"","sources":["../../src/memento/worker-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGnE;;GAEG;AACH,UAAU,aAAa;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,kBAAkB,EACxB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,YAAY,CAAC,CAoHvB"}