@asermax/tachikoma 2.0.0

package/dist/extensions/external/tools.js

@@ -0,0 +1,112 @@
+import { Type } from "typebox";
+import { isGitSource } from "./installs.js";
+const RESTART_NOTE = "The change takes effect after Tachikoma restarts.";
+export const InstallPluginParams = Type.Object({
+    source: Type.String({
+        description: "Git URL to clone (https://, git@, ssh://, file:// or ending in .git) or a local path to a directory/file containing the extension module",
+    }),
+    alias: Type.String({
+        description: "Install alias — lowercase letters, digits, and hyphens",
+    }),
+});
+export const PluginAliasParams = Type.Object({
+    alias: Type.String({
+        description: "Alias of an installed extension (see list_installed_extensions)",
+    }),
+});
+export const ListInstalledPluginsParams = Type.Object({});
+export const handleInstallExternalExtension = async (manager, args) => {
+    const record = await manager.install(args.source, args.alias);
+    return [
+        `ExternalExtension '${args.alias}' installed successfully.`,
+        `- Source: ${record.source}`,
+        `- Path: ${record.path}`,
+        RESTART_NOTE,
+    ].join("\n");
+};
+export const handleUpdateExternalExtension = async (manager, args) => {
+    const result = await manager.update(args.alias);
+    if (result.status === "skipped")
+        return `ExternalExtension '${args.alias}' skipped: ${result.detail}`;
+    return [`ExternalExtension '${args.alias}' updated.`, result.detail, RESTART_NOTE].join("\n");
+};
+export const handleListInstalledPlugins = (manager) => {
+    const entries = Object.entries(manager.list());
+    if (entries.length === 0)
+        return "No external extensions installed.";
+    return [
+        "# Installed Plugins",
+        "",
+        ...entries.flatMap(([alias, record]) => [
+            `- **${alias}** (${isGitSource(record.source) ? "git" : "local"})`,
+            `  Source: ${record.source}`,
+            `  Path: ${record.path}`,
+            `  Installed: ${record.installedAt}`,
+            "",
+        ]),
+    ].join("\n");
+};
+export const handleUninstallExtension = async (manager, args) => {
+    await manager.uninstall(args.alias);
+    return [`ExternalExtension '${args.alias}' uninstalled.`, RESTART_NOTE].join("\n");
+};
+const textResult = (text) => ({
+    content: [{ type: "text", text }],
+    details: undefined,
+});
+/** pi extension factory exposing the extension install management tools to the agent. */
+export const createExternalToolsFactory = (manager) => (pi) => {
+    pi.registerTool({
+        name: "install_extension",
+        label: "Install ExternalExtension",
+        description: "Install a third-party Tachikoman extension from a git URL (cloned into the data dir) or a local path (loaded in place). The external extension is loaded on the next restart.",
+        promptSnippet: "Install third-party Tachikoman extensions from git URLs or local paths",
+        promptGuidelines: [
+            "Use install_extension when the user asks to add a Tachikoman extension; tell them it activates after a restart.",
+        ],
+        parameters: InstallPluginParams,
+        async execute(_toolCallId, params) {
+            return textResult(await handleInstallExternalExtension(manager, params));
+        },
+    });
+    pi.registerTool({
+        name: "update_extension",
+        label: "Update ExternalExtension",
+        description: "Update an installed extension: git installs are pulled from their source; local installs are always current. Updates apply on the next restart.",
+        promptSnippet: "Update an installed extension to its latest version",
+        promptGuidelines: [
+            "Use update_extension with the alias from list_installed_extensions when the user wants a newer extension version.",
+        ],
+        parameters: PluginAliasParams,
+        async execute(_toolCallId, params) {
+            return textResult(await handleUpdateExternalExtension(manager, params));
+        },
+    });
+    pi.registerTool({
+        name: "list_installed_extensions",
+        label: "List Installed Plugins",
+        description: "List external extensions installed through install_extension, with their alias, source, install path, and install time.",
+        promptSnippet: "List installed third-party extensions",
+        promptGuidelines: [
+            "Check list_installed_extensions before install_extension to avoid alias collisions.",
+        ],
+        parameters: ListInstalledPluginsParams,
+        async execute() {
+            return textResult(handleListInstalledPlugins(manager));
+        },
+    });
+    pi.registerTool({
+        name: "uninstall_extension",
+        label: "Uninstall ExternalExtension",
+        description: "Uninstall an extension by alias: removes its install record and deletes cloned files (local sources are left untouched). The external extension stays active until restart.",
+        promptSnippet: "Uninstall a third-party extension by alias",
+        promptGuidelines: [
+            "Use uninstall_extension when the user wants an extension gone; mention it unloads fully on restart.",
+        ],
+        parameters: PluginAliasParams,
+        async execute(_toolCallId, params) {
+            return textResult(await handleUninstallExtension(manager, params));
+        },
+    });
+};
+//# sourceMappingURL=tools.js.map

package/dist/extensions/external/tools.js.map

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

package/dist/extensions/git/commit.d.ts

@@ -0,0 +1,19 @@
+import type { SideRunner } from "../../agent/side-run.ts";
+import type { Logger } from "../../log.ts";
+export type Completer = Pick<SideRunner, "complete">;
+export declare const generateCommitMessage: (side: Completer, diffStat: string, fallback: string, log: Logger) => Promise<string>;
+export interface CommitAllOptions {
+    cwd: string;
+    side: Completer;
+    /** Deterministic message used when generation fails or produces nothing usable. */
+    fallbackMessage: string;
+    /** Explicit message — skips generation entirely. */
+    message?: string;
+    log: Logger;
+}
+/**
+ * Stage everything and commit with a descriptive message generated from the
+ * staged diffstat. Returns the commit message, or null when there was nothing
+ * to commit.
+ */
+export declare const commitAll: ({ cwd, side, fallbackMessage, message, log, }: CommitAllOptions) => Promise<string | null>;

package/dist/extensions/git/commit.js

@@ -0,0 +1,44 @@
+import { runGit, runGitCapture } from "./git.js";
+const COMMIT_MESSAGE_SYSTEM = `You write git commit messages for an automated workspace-versioning agent.
+
+Given the staged diffstat of a commit, respond with a single descriptive commit
+message line: imperative mood, under 72 characters, mentioning what changed.
+Output only the message — no quotes, no prose, no trailing punctuation.`;
+const MAX_MESSAGE_CHARS = 100;
+const sanitizeMessage = (raw) => {
+    const line = raw
+        .split("\n")
+        .map((candidate) => candidate.trim())
+        .find((candidate) => candidate !== "");
+    if (line == null)
+        return null;
+    const cleaned = line.replaceAll(/^["'`]+|["'`]+$/g, "").trim();
+    if (cleaned === "")
+        return null;
+    return cleaned.length <= MAX_MESSAGE_CHARS ? cleaned : `${cleaned.slice(0, MAX_MESSAGE_CHARS)}…`;
+};
+export const generateCommitMessage = async (side, diffStat, fallback, log) => {
+    try {
+        const generated = sanitizeMessage(await side.complete({ system: COMMIT_MESSAGE_SYSTEM, user: diffStat, tier: "processor" }));
+        return generated ?? fallback;
+    }
+    catch (error) {
+        log.warn({ err: error }, "commit message generation failed — using fallback");
+        return fallback;
+    }
+};
+/**
+ * Stage everything and commit with a descriptive message generated from the
+ * staged diffstat. Returns the commit message, or null when there was nothing
+ * to commit.
+ */
+export const commitAll = async ({ cwd, side, fallbackMessage, message, log, }) => {
+    await runGit(cwd, ["add", "-A"]);
+    const { stdout: diffStat } = await runGitCapture(cwd, ["diff", "--cached", "--stat"]);
+    if (diffStat === "")
+        return null;
+    const resolved = message ?? (await generateCommitMessage(side, diffStat, fallbackMessage, log));
+    await runGit(cwd, ["commit", "-m", resolved]);
+    return resolved;
+};
+//# sourceMappingURL=commit.js.map

package/dist/extensions/git/commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.js","sourceRoot":"","sources":["../../../src/extensions/git/commit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIjD,MAAM,qBAAqB,GAAG;;;;wEAI0C,CAAC;AAEzE,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B,MAAM,eAAe,GAAG,CAAC,GAAW,EAAiB,EAAE;IACrD,MAAM,IAAI,GAAG,GAAG;SACb,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;SACpC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;IAEzC,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAE/D,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAEhC,OAAO,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAAG,CAAC;AACnG,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACxC,IAAe,EACf,QAAgB,EAChB,QAAgB,EAChB,GAAW,EACM,EAAE;IACnB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,eAAe,CAC/B,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAC1F,CAAC;QAEF,OAAO,SAAS,IAAI,QAAQ,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,mDAAmD,CAAC,CAAC;QAC9E,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;AAYF;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,EAC9B,GAAG,EACH,IAAI,EACJ,eAAe,EACf,OAAO,EACP,GAAG,GACc,EAA0B,EAAE;IAC7C,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IAEjC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEtF,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,MAAM,qBAAqB,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,CAAC,CAAC,CAAC;IAChG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE9C,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/dist/extensions/git/git.d.ts

@@ -0,0 +1,11 @@
+export interface GitResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+/** Run a git command and return exit code + trimmed output, never throwing on non-zero exit. */
+export declare const runGitCapture: (cwd: string, args: string[]) => Promise<GitResult>;
+/** Run a git command and throw on failure. Returns trimmed stdout. */
+export declare const runGit: (cwd: string, args: string[]) => Promise<string>;
+export declare const hasUncommittedChanges: (cwd: string) => Promise<boolean>;
+export declare const hasRemote: (cwd: string, remote: string) => Promise<boolean>;

package/dist/extensions/git/git.js

@@ -0,0 +1,29 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/** Run a git command and return exit code + trimmed output, never throwing on non-zero exit. */
+export const runGitCapture = async (cwd, args) => {
+    try {
+        const { stdout, stderr } = await execFileAsync("git", args, { cwd });
+        return { code: 0, stdout: stdout.trim(), stderr: stderr.trim() };
+    }
+    catch (error) {
+        const failure = error;
+        return {
+            code: typeof failure.code === "number" ? failure.code : 1,
+            stdout: (failure.stdout ?? "").trim(),
+            stderr: (failure.stderr ?? "").trim(),
+        };
+    }
+};
+/** Run a git command and throw on failure. Returns trimmed stdout. */
+export const runGit = async (cwd, args) => {
+    const result = await runGitCapture(cwd, args);
+    if (result.code !== 0) {
+        throw new Error(`git ${args.join(" ")} failed: ${result.stderr || `exit code ${result.code}`}`);
+    }
+    return result.stdout;
+};
+export const hasUncommittedChanges = async (cwd) => (await runGitCapture(cwd, ["status", "--porcelain"])).stdout !== "";
+export const hasRemote = async (cwd, remote) => (await runGitCapture(cwd, ["remote", "get-url", remote])).code === 0;
+//# sourceMappingURL=git.js.map

package/dist/extensions/git/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../src/extensions/git/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAQ1C,gGAAgG;AAChG,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAAE,GAAW,EAAE,IAAc,EAAsB,EAAE;IACrF,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACrE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IACnE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAqE,CAAC;QAEtF,OAAO;YACL,IAAI,EAAE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzD,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YACrC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;SACtC,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,sEAAsE;AACtE,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,EAAE,GAAW,EAAE,IAAc,EAAmB,EAAE;IAC3E,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,IAAI,aAAa,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAClG,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EAAE,GAAW,EAAoB,EAAE,CAC3E,CAAC,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC;AAEtE,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,GAAW,EAAE,MAAc,EAAoB,EAAE,CAC/E,CAAC,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC"}

package/dist/extensions/git/hooks.d.ts

@@ -0,0 +1,10 @@
+import type { Logger } from "../../log.ts";
+export declare const COMMITTER_NAME = "Tachikoma";
+export declare const COMMITTER_EMAIL = "tachikoma@local";
+export declare const GITIGNORE_ENTRIES: string[];
+/**
+ * Bootstrap hook: initialize the workspace as a git repo with a fixed
+ * committer identity (idempotent), ensure internal state stays gitignored,
+ * and sync with the origin remote when one is configured.
+ */
+export declare const initializeWorkspaceRepo: (workspaceRoot: string, log: Logger) => Promise<void>;

package/dist/extensions/git/hooks.js

@@ -0,0 +1,88 @@
+import { access, readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { hasRemote, runGit } from "./git.js";
+import { SYNC_RESULT, smartPull } from "./sync.js";
+export const COMMITTER_NAME = "Tachikoma";
+export const COMMITTER_EMAIL = "tachikoma@local";
+export const GITIGNORE_ENTRIES = [".tachikoma/\n"];
+const readGitignore = async (workspaceRoot) => {
+    try {
+        return await readFile(join(workspaceRoot, ".gitignore"), "utf8");
+    }
+    catch {
+        return "";
+    }
+};
+const appendMissingEntries = (existing) => {
+    let content = existing;
+    for (const entry of GITIGNORE_ENTRIES) {
+        if (!content.includes(entry)) {
+            const separator = content === "" || content.endsWith("\n") ? "" : "\n";
+            content += separator + entry;
+        }
+    }
+    return content;
+};
+/**
+ * Ensure the gitignore entries exist without committing — called on every
+ * startup so existing workspaces receive new entries; the commit processor
+ * picks the change up at the next session close.
+ */
+const ensureGitignoreEntries = async (workspaceRoot) => {
+    const existing = await readGitignore(workspaceRoot);
+    const updated = appendMissingEntries(existing);
+    if (updated !== existing) {
+        await writeFile(join(workspaceRoot, ".gitignore"), updated, "utf8");
+    }
+};
+const initializeRepo = async (workspaceRoot, log) => {
+    log.info({ path: workspaceRoot }, "initializing workspace git repo");
+    await runGit(workspaceRoot, ["init"]);
+    await runGit(workspaceRoot, ["config", "user.name", COMMITTER_NAME]);
+    await runGit(workspaceRoot, ["config", "user.email", COMMITTER_EMAIL]);
+    // The agent commits unattended — never block on a missing GPG setup.
+    await runGit(workspaceRoot, ["config", "commit.gpgsign", "false"]);
+    await runGit(workspaceRoot, ["commit", "--allow-empty", "-m", "Initial commit"]);
+    await ensureGitignoreEntries(workspaceRoot);
+    await runGit(workspaceRoot, ["add", ".gitignore"]);
+    await runGit(workspaceRoot, ["commit", "-m", "Add gitignore for workspace exclusions"]);
+    log.info("workspace git repo initialized");
+};
+const syncWorkspace = async (workspaceRoot, log) => {
+    try {
+        if (!(await hasRemote(workspaceRoot, "origin"))) {
+            log.debug("no origin remote configured — skipping workspace sync");
+            return;
+        }
+        const result = await smartPull(workspaceRoot, "origin", "HEAD", log);
+        if (result === SYNC_RESULT.dirtySkipped) {
+            log.warn("workspace has uncommitted changes — skipping sync");
+        }
+        else if (result === SYNC_RESULT.upToDate) {
+            log.debug("workspace already up to date");
+        }
+        else if (result === SYNC_RESULT.syncFailed) {
+            log.warn("workspace sync failed — continuing with local state");
+        }
+        else {
+            log.info({ result }, "workspace synced");
+        }
+    }
+    catch (error) {
+        log.warn({ err: error }, "workspace sync failed");
+    }
+};
+/**
+ * Bootstrap hook: initialize the workspace as a git repo with a fixed
+ * committer identity (idempotent), ensure internal state stays gitignored,
+ * and sync with the origin remote when one is configured.
+ */
+export const initializeWorkspaceRepo = async (workspaceRoot, log) => {
+    const gitDirMissing = await access(join(workspaceRoot, ".git")).then(() => false, () => true);
+    if (gitDirMissing) {
+        await initializeRepo(workspaceRoot, log);
+    }
+    await ensureGitignoreEntries(workspaceRoot);
+    await syncWorkspace(workspaceRoot, log);
+};
+//# sourceMappingURL=hooks.js.map

package/dist/extensions/git/hooks.js.map

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

package/dist/extensions/git/index.d.ts

@@ -0,0 +1,11 @@
+interface GitConfig {
+    enabled: boolean;
+}
+/**
+ * Workspace versioning: initializes the workspace as a git repo on startup
+ * (syncing with origin when configured), commits and pushes all workspace
+ * changes at session close, and exposes git inspection/commit tools to the
+ * agent.
+ */
+declare const _default: import("../api.ts").TachikomaExtension<GitConfig>;
+export default _default;

package/dist/extensions/git/index.js

@@ -0,0 +1,28 @@
+import { Type } from "typebox";
+import { defineExtension } from "../api.js";
+import { initializeWorkspaceRepo } from "./hooks.js";
+import { createGitProcessor } from "./processor.js";
+import { createGitToolsFactory } from "./tools.js";
+/**
+ * Workspace versioning: initializes the workspace as a git repo on startup
+ * (syncing with origin when configured), commits and pushes all workspace
+ * changes at session close, and exposes git inspection/commit tools to the
+ * agent.
+ */
+export default defineExtension({
+    name: "git",
+    configSchema: Type.Object({
+        enabled: Type.Boolean({ default: true }),
+    }),
+    setup(app) {
+        if (!app.extensionConfig.enabled) {
+            app.log.info("git extension disabled by configuration");
+            return;
+        }
+        const workspaceRoot = app.workspace.root;
+        app.bootstrap("init-workspace-repo", () => initializeWorkspaceRepo(workspaceRoot, app.log));
+        app.agent.use(createGitToolsFactory({ workspaceRoot, side: app.agent.side, log: app.log }));
+        app.sessions.registerProcessor(createGitProcessor({ workspaceRoot, side: app.agent.side }));
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/extensions/git/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extensions/git/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAMnD;;;;;GAKG;AACH,eAAe,eAAe,CAAY;IACxC,IAAI,EAAE,KAAK;IAEX,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC;QACxB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KACzC,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;YACjC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;QAEzC,GAAG,CAAC,SAAS,CAAC,qBAAqB,EAAE,GAAG,EAAE,CAAC,uBAAuB,CAAC,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAE5F,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAE5F,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9F,CAAC;CACF,CAAC,CAAC"}

package/dist/extensions/git/processor.d.ts

@@ -0,0 +1,13 @@
+import type { PostProcessor } from "../api.ts";
+import { type Completer } from "./commit.ts";
+export interface GitProcessorDeps {
+    workspaceRoot: string;
+    side: Completer;
+}
+export declare const workspaceFallbackMessage: (now?: Date) => string;
+/**
+ * Finalize-phase post-processor: stages and commits all workspace changes after
+ * each session with a message generated from the staged diffstat, then pushes
+ * to origin when a remote is configured.
+ */
+export declare const createGitProcessor: ({ workspaceRoot, side }: GitProcessorDeps) => PostProcessor;

package/dist/extensions/git/processor.js

@@ -0,0 +1,52 @@
+import { commitAll } from "./commit.js";
+import { hasRemote, hasUncommittedChanges } from "./git.js";
+import { PUSH_RESULT, PUSH_SUCCESS, smartPush } from "./sync.js";
+export const workspaceFallbackMessage = (now = new Date()) => `Update workspace files (${now.toISOString().slice(0, 10)})`;
+/**
+ * Finalize-phase post-processor: stages and commits all workspace changes after
+ * each session with a message generated from the staged diffstat, then pushes
+ * to origin when a remote is configured.
+ */
+export const createGitProcessor = ({ workspaceRoot, side }) => ({
+    name: "git-commit",
+    phase: "finalize",
+    async process({ log }) {
+        if (!(await hasUncommittedChanges(workspaceRoot))) {
+            log.debug("workspace is clean — no commits needed");
+            return;
+        }
+        const message = await commitAll({
+            cwd: workspaceRoot,
+            side,
+            fallbackMessage: workspaceFallbackMessage(),
+            log,
+        });
+        if (message != null)
+            log.info({ message }, "committed workspace changes");
+        if (await hasRemote(workspaceRoot, "origin")) {
+            const result = await smartPush(workspaceRoot, "origin", "HEAD", log);
+            if (PUSH_SUCCESS.has(result)) {
+                log.info({ result }, "pushed workspace changes");
+            }
+            else if (result === PUSH_RESULT.nothingToPush) {
+                log.debug("nothing to push");
+            }
+            else {
+                log.warn({ result }, "push failed — changes remain committed locally");
+            }
+        }
+        if (await hasUncommittedChanges(workspaceRoot)) {
+            log.warn("uncommitted changes remain after commit pass — retrying");
+            await commitAll({
+                cwd: workspaceRoot,
+                side,
+                fallbackMessage: workspaceFallbackMessage(),
+                log,
+            });
+            if (await hasUncommittedChanges(workspaceRoot)) {
+                log.warn("uncommitted changes remain after git processor retry");
+            }
+        }
+    },
+});
+//# sourceMappingURL=processor.js.map

package/dist/extensions/git/processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.js","sourceRoot":"","sources":["../../../src/extensions/git/processor.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAOjE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE,EAAU,EAAE,CACnE,2BAA2B,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EAAE,aAAa,EAAE,IAAI,EAAoB,EAAiB,EAAE,CAAC,CAAC;IAC/F,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,UAAU;IAEjB,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE;QACnB,IAAI,CAAC,CAAC,MAAM,qBAAqB,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC;YAC9B,GAAG,EAAE,aAAa;YAClB,IAAI;YACJ,eAAe,EAAE,wBAAwB,EAAE;YAC3C,GAAG;SACJ,CAAC,CAAC;QAEH,IAAI,OAAO,IAAI,IAAI;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,6BAA6B,CAAC,CAAC;QAE1E,IAAI,MAAM,SAAS,CAAC,aAAa,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;YAErE,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC7B,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC;YACnD,CAAC;iBAAM,IAAI,MAAM,KAAK,WAAW,CAAC,aAAa,EAAE,CAAC;gBAChD,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,gDAAgD,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAED,IAAI,MAAM,qBAAqB,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;YAEpE,MAAM,SAAS,CAAC;gBACd,GAAG,EAAE,aAAa;gBAClB,IAAI;gBACJ,eAAe,EAAE,wBAAwB,EAAE;gBAC3C,GAAG;aACJ,CAAC,CAAC;YAEH,IAAI,MAAM,qBAAqB,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC/C,GAAG,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/extensions/git/sync.d.ts

@@ -0,0 +1,44 @@
+import type { Logger } from "../../log.ts";
+export declare const DIVERGENCE_STATUS: {
+    readonly upToDate: "UP_TO_DATE";
+    readonly ahead: "AHEAD";
+    readonly behind: "BEHIND";
+    readonly diverged: "DIVERGED";
+};
+export type DivergenceStatus = (typeof DIVERGENCE_STATUS)[keyof typeof DIVERGENCE_STATUS];
+export declare const PUSH_RESULT: {
+    readonly pushed: "PUSHED";
+    readonly nothingToPush: "NOTHING_TO_PUSH";
+    readonly rebaseSucceeded: "REBASE_SUCCEEDED";
+    readonly pushFailed: "PUSH_FAILED";
+    readonly rebaseFailed: "REBASE_FAILED";
+};
+export type PushResult = (typeof PUSH_RESULT)[keyof typeof PUSH_RESULT];
+export declare const SYNC_RESULT: {
+    readonly upToDate: "UP_TO_DATE";
+    readonly fastForwarded: "FAST_FORWARDED";
+    readonly rebaseSucceeded: "REBASE_SUCCEEDED";
+    readonly syncFailed: "SYNC_FAILED";
+    readonly dirtySkipped: "DIRTY_SKIPPED";
+};
+export type SyncResult = (typeof SYNC_RESULT)[keyof typeof SYNC_RESULT];
+export declare const PUSH_SUCCESS: ReadonlySet<PushResult>;
+/**
+ * Classify the relationship between local HEAD and `<remote>/<branch>`.
+ * Precondition: `git fetch <remote>` has already run.
+ */
+export declare const detectDivergence: (cwd: string, remote?: string, branch?: string) => Promise<DivergenceStatus>;
+/**
+ * Push local commits with divergence recovery: abort stale rebase → fetch →
+ * detect divergence → push directly when ahead, or rebase-then-push when
+ * diverged. Conflicting rebases are aborted (local commits preserved) and
+ * surface as REBASE_FAILED.
+ */
+export declare const smartPush: (cwd: string, remote: string, branch: string, log: Logger) => Promise<PushResult>;
+/**
+ * Pull remote changes with divergence recovery: skip when dirty, abort stale
+ * rebase → fetch → detect divergence → fast-forward when behind, or naive
+ * rebase when diverged. Conflicting rebases are aborted and surface as
+ * SYNC_FAILED.
+ */
+export declare const smartPull: (cwd: string, remote: string, branch: string, log: Logger) => Promise<SyncResult>;