@autonav/core 1.4.0 → 1.6.0

package/dist/memento/git-operations.js

@@ -0,0 +1,256 @@
+/**
+ * Git Operations for Memento Loop
+ *
+ * Helper functions for git operations: branches, commits, logs, PRs.
+ */
+import { execSync } from "node:child_process";
+/**
+ * Execute a git command and return output
+ */
+function execGit(command, options) {
+    const execOptions = {
+        cwd: options.cwd,
+        encoding: "utf-8",
+        stdio: options.verbose ? "inherit" : "pipe",
+    };
+    try {
+        const result = execSync(command, execOptions);
+        return typeof result === "string" ? result.trim() : "";
+    }
+    catch (error) {
+        if (error instanceof Error && "stderr" in error) {
+            throw new Error(`Git command failed: ${command}\n${error.stderr}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Check if directory is a git repository
+ */
+export function isGitRepo(cwd) {
+    try {
+        execSync("git rev-parse --is-inside-work-tree", {
+            cwd,
+            encoding: "utf-8",
+            stdio: "pipe",
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Initialize a git repository if not already initialized
+ */
+export function ensureGitRepo(options) {
+    if (!isGitRepo(options.cwd)) {
+        execGit("git init", options);
+        if (options.verbose) {
+            console.log(`Initialized git repository in ${options.cwd}`);
+        }
+    }
+}
+/**
+ * Get current branch name
+ */
+export function getCurrentBranch(options) {
+    try {
+        return execGit("git branch --show-current", { ...options, verbose: false });
+    }
+    catch {
+        return "HEAD"; // Detached HEAD state
+    }
+}
+/**
+ * Create and checkout a new branch
+ */
+export function createBranch(name, options) {
+    // Check if branch already exists
+    try {
+        execGit(`git rev-parse --verify ${name}`, { ...options, verbose: false });
+        // Branch exists, just checkout
+        execGit(`git checkout ${name}`, options);
+        if (options.verbose) {
+            console.log(`Switched to existing branch: ${name}`);
+        }
+    }
+    catch {
+        // Branch doesn't exist, create it
+        execGit(`git checkout -b ${name}`, options);
+        if (options.verbose) {
+            console.log(`Created and switched to branch: ${name}`);
+        }
+    }
+}
+/**
+ * Get recent git log entries
+ */
+export function getRecentGitLog(options) {
+    const count = options.count ?? 10;
+    try {
+        // Check if there are any commits
+        execGit("git rev-parse HEAD", { ...options, verbose: false });
+        return execGit(`git log --oneline --no-decorate -n ${count}`, { ...options, verbose: false });
+    }
+    catch {
+        // No commits yet
+        return "";
+    }
+}
+/**
+ * Get diff of recent changes (staged + unstaged)
+ */
+export function getRecentDiff(options) {
+    try {
+        const staged = execGit("git diff --cached", { ...options, verbose: false });
+        const unstaged = execGit("git diff", { ...options, verbose: false });
+        return `${staged}\n${unstaged}`.trim();
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Get diff stats (lines added/removed) for uncommitted changes
+ */
+export function getDiffStats(options) {
+    try {
+        // git diff --shortstat outputs: " 3 files changed, 10 insertions(+), 5 deletions(-)"
+        const output = execGit("git diff --shortstat", { ...options, verbose: false });
+        if (!output) {
+            return { filesChanged: 0, linesAdded: 0, linesRemoved: 0 };
+        }
+        const filesMatch = output.match(/(\d+) files? changed/);
+        const insertionsMatch = output.match(/(\d+) insertions?\(\+\)/);
+        const deletionsMatch = output.match(/(\d+) deletions?\(-\)/);
+        return {
+            filesChanged: filesMatch ? parseInt(filesMatch[1], 10) : 0,
+            linesAdded: insertionsMatch ? parseInt(insertionsMatch[1], 10) : 0,
+            linesRemoved: deletionsMatch ? parseInt(deletionsMatch[1], 10) : 0,
+        };
+    }
+    catch {
+        return { filesChanged: 0, linesAdded: 0, linesRemoved: 0 };
+    }
+}
+/**
+ * Get diff stats between HEAD and HEAD~1 (last commit)
+ */
+export function getLastCommitDiffStats(options) {
+    try {
+        const output = execGit("git diff --shortstat HEAD~1 HEAD", { ...options, verbose: false });
+        if (!output) {
+            return { filesChanged: 0, linesAdded: 0, linesRemoved: 0 };
+        }
+        const filesMatch = output.match(/(\d+) files? changed/);
+        const insertionsMatch = output.match(/(\d+) insertions?\(\+\)/);
+        const deletionsMatch = output.match(/(\d+) deletions?\(-\)/);
+        return {
+            filesChanged: filesMatch ? parseInt(filesMatch[1], 10) : 0,
+            linesAdded: insertionsMatch ? parseInt(insertionsMatch[1], 10) : 0,
+            linesRemoved: deletionsMatch ? parseInt(deletionsMatch[1], 10) : 0,
+        };
+    }
+    catch {
+        return { filesChanged: 0, linesAdded: 0, linesRemoved: 0 };
+    }
+}
+/**
+ * Check if there are uncommitted changes
+ */
+export function hasUncommittedChanges(options) {
+    try {
+        const status = execGit("git status --porcelain", { ...options, verbose: false });
+        return status.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Stage all changes
+ */
+export function stageAllChanges(options) {
+    execGit("git add -A", options);
+}
+/**
+ * Commit staged changes
+ *
+ * Returns the commit hash, or null if nothing to commit
+ */
+export function commitChanges(message, options) {
+    // Check if there's anything to commit
+    if (!hasUncommittedChanges(options)) {
+        if (options.verbose) {
+            console.log("No changes to commit");
+        }
+        return null;
+    }
+    // Stage all changes
+    stageAllChanges(options);
+    // Commit
+    execGit(`git commit -m "${message.replace(/"/g, '\\"')}"`, options);
+    // Get the commit hash
+    const hash = execGit("git rev-parse --short HEAD", { ...options, verbose: false });
+    if (options.verbose) {
+        console.log(`Committed: ${hash} - ${message}`);
+    }
+    return hash;
+}
+/**
+ * Push branch to remote
+ */
+export function pushBranch(branch, options) {
+    const upstream = options.setUpstream ? "-u origin" : "";
+    execGit(`git push ${upstream} ${branch}`.trim(), options);
+    if (options.verbose) {
+        console.log(`Pushed branch: ${branch}`);
+    }
+}
+/**
+ * Create a pull request using GitHub CLI
+ *
+ * Requires `gh` CLI to be installed and authenticated
+ */
+export function createPullRequest(options) {
+    const { title, body, base = "main", draft = false } = options;
+    // Escape for shell
+    const escapedTitle = title.replace(/"/g, '\\"');
+    const escapedBody = body.replace(/"/g, '\\"');
+    const draftFlag = draft ? "--draft" : "";
+    const output = execGit(`gh pr create --title "${escapedTitle}" --body "${escapedBody}" --base ${base} ${draftFlag}`.trim(), options);
+    // gh pr create outputs the PR URL
+    const prUrl = output.split("\n").pop() || output;
+    if (options.verbose) {
+        console.log(`Created PR: ${prUrl}`);
+    }
+    return prUrl;
+}
+/**
+ * Check if gh CLI is available and authenticated
+ */
+export function isGhAvailable() {
+    try {
+        execSync("gh auth status", {
+            encoding: "utf-8",
+            stdio: "pipe",
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the remote origin URL
+ */
+export function getRemoteUrl(options) {
+    try {
+        return execGit("git remote get-url origin", { ...options, verbose: false });
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=git-operations.js.map

package/dist/memento/git-operations.js.map

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

package/dist/memento/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Memento Loop Module
+ *
+ * Context-clearing iterative development loop that coordinates
+ * navigator (planning) and worker (implementation) agents.
+ *
+ * Design principle: Git is the only persistent memory. All other
+ * state lives in-memory during loop execution.
+ *
+ * @example
+ * ```typescript
+ * import { runMementoLoop } from './memento';
+ *
+ * const result = await runMementoLoop(
+ *   './my-code',
+ *   './my-navigator',
+ *   'Add user authentication',
+ *   { maxIterations: 10, branch: 'feature/auth', verbose: true }
+ * );
+ *
+ * console.log(`Completed in ${result.iterations} iterations`);
+ * ```
+ */
+export { type ImplementationStep, type ImplementationPlan, type WorkerResult, type MementoOptions, type MementoResult, ImplementationStepSchema, ImplementationPlanSchema, } from "./types.js";
+export { isGitRepo, ensureGitRepo, getCurrentBranch, createBranch, getRecentGitLog, getRecentDiff, getDiffStats, getLastCommitDiffStats, hasUncommittedChanges, stageAllChanges, commitChanges, pushBranch, createPullRequest, isGhAvailable, getRemoteUrl, type DiffStats, } from "./git-operations.js";
+export { createNavProtocolMcpServer, SUBMIT_PLAN_TOOL, type PlanSubmissionResult, } from "./nav-protocol.js";
+export { buildNavPlanPrompt, buildNavSystemPrompt, buildWorkerPrompt, buildWorkerSystemPrompt, type NavigatorIdentity, } from "./prompts.js";
+export { runWorkerAgent, type WorkerAgentOptions, } from "./worker-agent.js";
+export { runMementoLoop, type MementoLoopOptions, } from "./loop.js";
+export { MatrixAnimation, withMatrixAnimation, type AnimationStats, } from "./matrix-animation.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memento/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,KAAK,SAAS,GACf,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAC"}

package/dist/memento/index.js

@@ -0,0 +1,38 @@
+/**
+ * Memento Loop Module
+ *
+ * Context-clearing iterative development loop that coordinates
+ * navigator (planning) and worker (implementation) agents.
+ *
+ * Design principle: Git is the only persistent memory. All other
+ * state lives in-memory during loop execution.
+ *
+ * @example
+ * ```typescript
+ * import { runMementoLoop } from './memento';
+ *
+ * const result = await runMementoLoop(
+ *   './my-code',
+ *   './my-navigator',
+ *   'Add user authentication',
+ *   { maxIterations: 10, branch: 'feature/auth', verbose: true }
+ * );
+ *
+ * console.log(`Completed in ${result.iterations} iterations`);
+ * ```
+ */
+// Types
+export { ImplementationStepSchema, ImplementationPlanSchema, } from "./types.js";
+// Git operations
+export { isGitRepo, ensureGitRepo, getCurrentBranch, createBranch, getRecentGitLog, getRecentDiff, getDiffStats, getLastCommitDiffStats, hasUncommittedChanges, stageAllChanges, commitChanges, pushBranch, createPullRequest, isGhAvailable, getRemoteUrl, } from "./git-operations.js";
+// Nav protocol
+export { createNavProtocolMcpServer, SUBMIT_PLAN_TOOL, } from "./nav-protocol.js";
+// Prompts
+export { buildNavPlanPrompt, buildNavSystemPrompt, buildWorkerPrompt, buildWorkerSystemPrompt, } from "./prompts.js";
+// Worker agent
+export { runWorkerAgent, } from "./worker-agent.js";
+// Main loop
+export { runMementoLoop, } from "./loop.js";
+// Animation
+export { MatrixAnimation, withMatrixAnimation, } from "./matrix-animation.js";
+//# sourceMappingURL=index.js.map

package/dist/memento/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memento/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,QAAQ;AACR,OAAO,EAML,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,iBAAiB;AACjB,OAAO,EACL,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,YAAY,GAEb,MAAM,qBAAqB,CAAC;AAE7B,eAAe;AACf,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,GAEjB,MAAM,mBAAmB,CAAC;AAE3B,UAAU;AACV,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,cAAc,CAAC;AAEtB,eAAe;AACf,OAAO,EACL,cAAc,GAEf,MAAM,mBAAmB,CAAC;AAE3B,YAAY;AACZ,OAAO,EACL,cAAc,GAEf,MAAM,WAAW,CAAC;AAEnB,YAAY;AACZ,OAAO,EACL,eAAe,EACf,mBAAmB,GAEpB,MAAM,uBAAuB,CAAC"}

package/dist/memento/loop.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Memento Loop Core Logic
+ *
+ * The main loop that coordinates navigator planning and worker implementation
+ * in a context-clearing iterative development pattern.
+ *
+ * Design principle: The WORKER forgets between iterations (memento pattern).
+ * The NAVIGATOR maintains its own memory and knowledge base. We provide git
+ * history as context about what the worker has accomplished so far.
+ */
+import type { MementoOptions, MementoResult } from "./types.js";
+/**
+ * Options for the memento loop
+ */
+export interface MementoLoopOptions extends MementoOptions {
+    /** Model to use for worker agent (default: claude-haiku-4-5) */
+    model?: string;
+    /** Model to use for navigator agent (default: claude-opus-4-5) */
+    navModel?: string;
+    /** Maximum turns per agent call */
+    maxTurns?: number;
+}
+/**
+ * Run the memento loop
+ *
+ * Coordinates navigator planning and worker implementation in iterations
+ * until the task is complete or max iterations reached.
+ *
+ * All state is in-memory. Git history is the only persistent context
+ * visible to the agents.
+ */
+export declare function runMementoLoop(codeDirectory: string, navDirectory: string, task: string, options: MementoLoopOptions): Promise<MementoResult>;
+//# sourceMappingURL=loop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/memento/loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAoBpF;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA0bD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,aAAa,CAAC,CA4PxB"}