@otto-assistant/otto 0.1.0

package/dist/installer.test.js

@@ -0,0 +1,43 @@
+import { describe, expect, it } from "vitest";
+import { installMissingPackages, planStableUpgrades } from "./installer.js";
+describe("installer", () => {
+    it("installMissingPackages returns empty when all installed", () => {
+        const getInstalled = (_name) => "1.0.0";
+        const installed = installMissingPackages(getInstalled, () => "ok");
+        expect(installed).toEqual([]);
+    });
+    it("installMissingPackages returns missing package names", () => {
+        const getInstalled = (name) => name === "kimaki" ? "1.0.0" : null;
+        const installedNames = [];
+        const install = (name) => { installedNames.push(name); return name; };
+        const result = installMissingPackages(getInstalled, install);
+        expect(result).toContain("opencode-ai");
+        expect(result).not.toContain("kimaki");
+        // opencode-agent-memory is a plugin, not a global npm package
+        expect(result).not.toContain("opencode-agent-memory");
+    });
+    it("planStableUpgrades returns empty when all packages match pinned", () => {
+        const pinned = { a: "1.0.0", b: "2.0.0" };
+        const getInstalled = (name) => pinned[name] ?? null;
+        const plan = planStableUpgrades(["a", "b"], getInstalled, pinned);
+        expect(plan).toEqual([]);
+    });
+    it("planStableUpgrades lists packages whose version differs from pinned", () => {
+        const pinned = { "opencode-ai": "1.2.20", kimaki: "0.4.90" };
+        const getInstalled = (name) => (name === "kimaki" ? "0.4.90" : "1.0.0");
+        const plan = planStableUpgrades(["opencode-ai", "kimaki"], getInstalled, pinned);
+        expect(plan).toEqual([
+            { name: "opencode-ai", current: "1.0.0", target: "1.2.20" },
+        ]);
+    });
+    it("planStableUpgrades includes not installed packages", () => {
+        const pinned = { x: "1.0.0" };
+        const getInstalled = () => null;
+        const plan = planStableUpgrades(["x"], getInstalled, pinned);
+        expect(plan).toEqual([{ name: "x", current: null, target: "1.0.0" }]);
+    });
+    it("planStableUpgrades throws when pinned entry missing for a package", () => {
+        expect(() => planStableUpgrades(["missing"], () => "1.0.0", {})).toThrow("No pinned version for missing in manifest");
+    });
+});
+//# sourceMappingURL=installer.test.js.map

package/dist/installer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.test.js","sourceRoot":"","sources":["../src/installer.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAE3E,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,CAAA;QAC/C,MAAM,SAAS,GAAG,sBAAsB,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QAClE,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC/B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;QACzE,MAAM,cAAc,GAAa,EAAE,CAAA;QACnC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC,CAAA;QAE5E,MAAM,MAAM,GAAG,sBAAsB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAE5D,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAA;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QACtC,8DAA8D;QAC9D,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAA;QACzC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,MAAM,CAAC,IAA2B,CAAC,IAAI,IAAI,CAAA;QAClF,MAAM,IAAI,GAAG,kBAAkB,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,CAAA;QACjE,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,MAAM,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;QAC5D,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QAC/E,MAAM,IAAI,GAAG,kBAAkB,CAAC,CAAC,aAAa,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,CAAA;QAChF,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;YACnB,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE;SAC5D,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAA;QAC7B,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,IAAqB,CAAA;QAChD,MAAM,IAAI,GAAG,kBAAkB,CAAC,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,CAAA;QAC5D,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,CAAC,GAAG,EAAE,CACV,kBAAkB,CAAC,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CACnD,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,4 @@
+export declare function hasKimakiBinary(): boolean;
+export declare function isKimakiRunning(): boolean;
+export declare function restartKimaki(): void;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,IAAI,OAAO,CAOzC;AAED,wBAAgB,eAAe,IAAI,OAAO,CAOzC;AAED,wBAAgB,aAAa,IAAI,IAAI,CASpC"}

package/dist/lifecycle.js

@@ -0,0 +1,30 @@
+import { execSync } from "node:child_process";
+export function hasKimakiBinary() {
+    try {
+        execSync("which kimaki", { encoding: "utf-8", stdio: "pipe" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isKimakiRunning() {
+    try {
+        const output = execSync("pgrep -f kimaki", { encoding: "utf-8", stdio: "pipe" });
+        return output.trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+export function restartKimaki() {
+    if (!hasKimakiBinary()) {
+        throw new Error("kimaki is not installed. Install it first with: npm install -g kimaki");
+    }
+    execSync("kimaki restart", {
+        encoding: "utf-8",
+        stdio: "pipe",
+        timeout: 30_000,
+    });
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,QAAQ,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QAC9D,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QAChF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAA;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAA;IAC1F,CAAC;IACD,QAAQ,CAAC,gBAAgB,EAAE;QACzB,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,MAAM;KAChB,CAAC,CAAA;AACJ,CAAC"}

package/dist/lifecycle.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lifecycle.test.d.ts.map

package/dist/lifecycle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.test.d.ts","sourceRoot":"","sources":["../src/lifecycle.test.ts"],"names":[],"mappings":""}

package/dist/lifecycle.test.js

@@ -0,0 +1,19 @@
+import { describe, expect, it } from "vitest";
+import { hasKimakiBinary, isKimakiRunning, restartKimaki } from "./lifecycle.js";
+describe("lifecycle", () => {
+    it("hasKimakiBinary returns boolean", () => {
+        const result = hasKimakiBinary();
+        expect(typeof result).toBe("boolean");
+    });
+    it("isKimakiRunning returns boolean", () => {
+        const result = isKimakiRunning();
+        expect(typeof result).toBe("boolean");
+    });
+    it("restartKimaki is a function", () => {
+        expect(typeof restartKimaki).toBe("function");
+    });
+    it("restartKimaki throws descriptive error when kimaki not found", () => {
+        expect(typeof restartKimaki).toBe("function");
+    });
+});
+//# sourceMappingURL=lifecycle.test.js.map

package/dist/lifecycle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.test.js","sourceRoot":"","sources":["../src/lifecycle.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEhF,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;QAChC,MAAM,CAAC,OAAO,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAA;QAChC,MAAM,CAAC,OAAO,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/manifest.d.ts

@@ -0,0 +1,18 @@
+export interface Manifest {
+    version: string;
+    /** Packages installed globally via npm (CLI tools) */
+    packages: Record<string, string>;
+    /** Pinned versions for `otto upgrade stable` (global npm packages only) */
+    pinned: Record<string, string>;
+    /** Plugins enabled via opencode.json plugin[] — opencode resolves them itself */
+    plugins: string[];
+}
+export declare const MANIFEST: Manifest;
+/** Upstream repositories for sync tracking */
+export declare const UPSTREAM_REPOS: Record<string, {
+    repo: string;
+    upstream: string;
+}>;
+export declare const OPENCODE_CONFIG_DIR: () => string;
+export declare const KIMAKI_DATA_DIR: () => string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,iFAAiF;IACjF,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,eAAO,MAAM,QAAQ,EAAE,QAatB,CAAA;AAED,8CAA8C;AAC9C,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAK7E,CAAA;AAED,eAAO,MAAM,mBAAmB,QAAO,MAGtC,CAAA;AAED,eAAO,MAAM,eAAe,QAAO,MAGlC,CAAA"}

package/dist/manifest.js

@@ -0,0 +1,30 @@
+export const MANIFEST = {
+    version: "0.1.0",
+    packages: {
+        "opencode-ai": ">=1.0.115",
+        "@otto-assistant/bridge": ">=0.4.90",
+    },
+    pinned: {
+        "opencode-ai": "1.2.20",
+        "@otto-assistant/bridge": "0.4.90",
+    },
+    plugins: [
+        "opencode-agent-memory",
+    ],
+};
+/** Upstream repositories for sync tracking */
+export const UPSTREAM_REPOS = {
+    "@otto-assistant/bridge": {
+        repo: "otto-assistant/bridge",
+        upstream: "remorses/kimaki",
+    },
+};
+export const OPENCODE_CONFIG_DIR = () => {
+    const home = process.env.HOME || process.env.USERPROFILE || "/root";
+    return `${home}/.config/opencode`;
+};
+export const KIMAKI_DATA_DIR = () => {
+    const home = process.env.HOME || process.env.USERPROFILE || "/root";
+    return `${home}/.kimaki`;
+};
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,QAAQ,GAAa;IAChC,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE;QACR,aAAa,EAAE,WAAW;QAC1B,wBAAwB,EAAE,UAAU;KACrC;IACD,MAAM,EAAE;QACN,aAAa,EAAE,QAAQ;QACvB,wBAAwB,EAAE,QAAQ;KACnC;IACD,OAAO,EAAE;QACP,uBAAuB;KACxB;CACF,CAAA;AAED,8CAA8C;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAuD;IAChF,wBAAwB,EAAE;QACxB,IAAI,EAAE,uBAAuB;QAC7B,QAAQ,EAAE,iBAAiB;KAC5B;CACF,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAW,EAAE;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAA;IACnE,OAAO,GAAG,IAAI,mBAAmB,CAAA;AACnC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,GAAW,EAAE;IAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAA;IACnE,OAAO,GAAG,IAAI,UAAU,CAAA;AAC1B,CAAC,CAAA"}

package/dist/sync.d.ts

@@ -0,0 +1,10 @@
+import { UPSTREAM_REPOS } from "./manifest.js";
+interface SyncTarget {
+    repo: string;
+    upstream: string;
+    branch: string;
+}
+declare function getSyncTargets(): SyncTarget[];
+export declare function syncUpstreams(): Promise<void>;
+export { getSyncTargets, UPSTREAM_REPOS };
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,iBAAS,cAAc,IAAI,UAAU,EAAE,CAMtC;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAiCnD;AAED,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAA"}

package/dist/sync.js

@@ -0,0 +1,39 @@
+import { execSync } from "node:child_process";
+import { UPSTREAM_REPOS } from "./manifest.js";
+function getSyncTargets() {
+    return Object.entries(UPSTREAM_REPOS).map(([_pkgName, info]) => ({
+        repo: info.repo,
+        upstream: info.upstream,
+        branch: "main",
+    }));
+}
+export async function syncUpstreams() {
+    const targets = getSyncTargets();
+    if (targets.length === 0) {
+        console.log("No upstream repos configured for sync.");
+        return;
+    }
+    // Check gh CLI is available
+    try {
+        execSync("gh --version", { stdio: "pipe" });
+    }
+    catch {
+        console.error("Error: gh CLI is required for sync. Install: https://cli.github.com/");
+        process.exit(1);
+    }
+    console.log("Triggering upstream sync for all forked repos:\n");
+    for (const target of targets) {
+        console.log(`  ${target.repo} ← ${target.upstream}`);
+        try {
+            execSync(`gh workflow run sync-upstream.yml --repo ${target.repo} --ref ${target.branch}`, { stdio: "pipe" });
+            console.log(`    ✓ Sync triggered`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`    ✗ Failed: ${msg}`);
+        }
+    }
+    console.log("\nSync workflows triggered. Check status with: gh run list --repo <repo>");
+}
+export { getSyncTargets, UPSTREAM_REPOS };
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAQ9C,SAAS,cAAc;IACrB,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,MAAM;KACf,CAAC,CAAC,CAAA;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAA;IAEhC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAA;QACrD,OAAM;IACR,CAAC;IAED,4BAA4B;IAC5B,IAAI,CAAC;QACH,QAAQ,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,sEAAsE,CAAC,CAAA;QACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAA;IAE/D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;QACpD,IAAI,CAAC;YACH,QAAQ,CACN,4CAA4C,MAAM,CAAC,IAAI,UAAU,MAAM,CAAC,MAAM,EAAE,EAChF,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB,CAAA;YACD,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;QACrC,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAC5D,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAA;QACvC,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,0EAA0E,CAAC,CAAA;AACzF,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,CAAA"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@otto-assistant/otto",
+  "version": "0.1.0",
+  "description": "Otto — terminal UI distribution wrapper for opencode + kimaki + opencode-agent-memory",
+  "type": "module",
+  "bin": {
+    "otto": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["src", "dist"],
+  "keywords": ["otto", "opencode", "kimaki", "ai-agent", "distribution"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/otto-assistant/otto.git"
+  },
+  "scripts": {
+    "build": "rm -rf dist *.tsbuildinfo && tsc && chmod +x dist/cli.js",
+    "dev": "tsc --watch",
+    "prepublishOnly": "pnpm build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9.1",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.2.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,291 @@
+#!/usr/bin/env node
+
+import { MANIFEST } from "./manifest.js"
+import { getInstalledVersion } from "./detect.js"
+import {
+  readOpenCodeConfigState,
+  writeOpenCodeConfig,
+  ensureAgentMemoryConfig,
+  ensureSubagentThreadSkill,
+  mergePlugins,
+  readOttoConfig,
+  writeOttoConfig,
+  buildSubagentThreadPolicy,
+  mergeAgentPrompts,
+  type OpenCodeConfig,
+} from "./config.js"
+import { installMissingPackages, upgradePackage, planStableUpgrades } from "./installer.js"
+import { hasKimakiBinary, restartKimaki } from "./lifecycle.js"
+import { checkPackagePresence, checkConfigHealth, checkDirectoryHealth } from "./health.js"
+import { syncUpstreams } from "./sync.js"
+
+const args = process.argv.slice(2)
+const command = args[0] ?? ""
+const subCommand = args[1] ?? ""
+
+function mergeOttoManagedConfig(config: OpenCodeConfig): OpenCodeConfig {
+  let merged = config
+
+  for (const plugin of MANIFEST.plugins) {
+    merged = mergePlugins(merged, plugin)
+  }
+
+  // Read Otto's own config from otto.json (NOT from opencode.json)
+  const ottoConfig = readOttoConfig()
+  merged = mergeAgentPrompts(merged, buildSubagentThreadPolicy(ottoConfig))
+  return merged
+}
+
+async function cmdInstall(): Promise<void> {
+  console.log("Otto install — conservative mode\n")
+
+  // 1. Install missing global npm packages (CLI tools only)
+  const installed = installMissingPackages(getInstalledVersion)
+  if (installed.length > 0) {
+    console.log(`Installed: ${installed.join(", ")}`)
+  } else {
+    console.log("All packages already installed.")
+  }
+
+  // 2. Merge plugins + Otto policy into opencode.json
+  let configChanged = false
+  const { config, status } = readOpenCodeConfigState()
+  if (status === "invalid") {
+    console.error("Error: opencode.json exists but is not valid JSON. Fix the file, then run otto again.")
+    process.exit(1)
+  }
+
+  // 2a. Ensure otto.json exists with defaults
+  const ottoConfig = readOttoConfig()
+  const ottoConfigChanged = writeOttoConfig(ottoConfig)
+
+  // 2b. Merge plugins + policy into opencode.json (NO otto key!)
+  const merged = mergeOttoManagedConfig(config)
+  configChanged = writeOpenCodeConfig(merged) || configChanged
+
+  if (configChanged) {
+    console.log(`Updated opencode.json — added plugins: ${MANIFEST.plugins.join(", ")} + otto subagent policy`)
+  }
+  if (ottoConfigChanged) {
+    console.log("Created otto.json with defaults")
+  }
+
+  // 3. Ensure agent-memory.json exists
+  const created = ensureAgentMemoryConfig()
+  if (created) {
+    console.log("Created agent-memory.json with defaults")
+  }
+
+  // 4. Ensure otto-subagent-threads skill exists
+  const skillCreated = ensureSubagentThreadSkill()
+  if (skillCreated) {
+    console.log("Created otto-subagent-threads skill")
+  }
+
+  // 5. Restart kimaki if needed — but NOT if running inside kimaki
+  //    (kimaki restart kills the current opencode session)
+  const runningInsideKimaki = !!process.env.KIMAKI
+  if (configChanged || installed.length > 0) {
+    if (runningInsideKimaki) {
+      console.log("\n⚠ Changes require kimaki restart. Run `kimaki restart` manually when ready.")
+    } else if (hasKimakiBinary()) {
+      console.log("Restarting kimaki...")
+      try {
+        restartKimaki()
+        console.log("Kimaki restarted.")
+      } catch (err: unknown) {
+        const msg = err instanceof Error ? err.message : String(err)
+        console.error(`Warning: could not restart kimaki: ${msg}`)
+      }
+    }
+  }
+
+  console.log("\nDone!")
+}
+
+async function cmdUpgrade(mode: "stable" | "latest"): Promise<void> {
+  console.log(`Otto upgrade — mode: ${mode}\n`)
+
+  const packageNames = Object.keys(MANIFEST.packages)
+
+  let didUpgradePackages = false
+
+  if (mode === "stable") {
+    const upgradePlan = planStableUpgrades(packageNames, getInstalledVersion, MANIFEST.pinned)
+    if (upgradePlan.length === 0) {
+      console.log("Nothing to upgrade — already at pinned stable versions.")
+    } else {
+      console.log("Will upgrade:")
+      for (const { name, current, target } of upgradePlan) {
+        console.log(`  ${name}: ${current ?? "not installed"} → ${target}`)
+      }
+      for (const { name } of upgradePlan) {
+        console.log(`Upgrading ${name}...`)
+        upgradePackage(name, mode)
+      }
+    }
+    didUpgradePackages = upgradePlan.length > 0
+  } else {
+    console.log("Will upgrade:")
+    for (const name of packageNames) {
+      const current = getInstalledVersion(name)
+      console.log(`  ${name}: ${current ?? "not installed"} → latest`)
+    }
+    for (const name of packageNames) {
+      console.log(`Upgrading ${name}...`)
+      upgradePackage(name, mode)
+    }
+    didUpgradePackages = packageNames.length > 0
+  }
+
+  // Ensure plugins + Otto policy are in config
+  const { config, status } = readOpenCodeConfigState()
+  if (status === "invalid") {
+    console.error("Error: opencode.json exists but is not valid JSON. Fix the file, then run otto again.")
+    process.exit(1)
+  }
+
+  // Ensure otto.json exists
+  const ottoConfig = readOttoConfig()
+  writeOttoConfig(ottoConfig)
+
+  const merged = mergeOttoManagedConfig(config)
+  const configChanged = writeOpenCodeConfig(merged)
+
+  // Ensure skill file is up to date
+  ensureSubagentThreadSkill()
+
+  // Restart — but NOT inside kimaki session
+  // Only restart if anything actually changed.
+  const runningInsideKimaki = !!process.env.KIMAKI
+  if (didUpgradePackages || configChanged) {
+    if (runningInsideKimaki) {
+      console.log("\n⚠ Changes require kimaki restart. Run `kimaki restart` manually when ready.")
+    } else if (hasKimakiBinary()) {
+      console.log("Restarting kimaki...")
+      try {
+        restartKimaki()
+        console.log("Kimaki restarted.")
+      } catch (err: unknown) {
+        const msg = err instanceof Error ? err.message : String(err)
+        console.error(`Warning: could not restart kimaki: ${msg}`)
+      }
+    }
+  }
+
+  console.log("\nDone!")
+}
+
+async function cmdStatus(): Promise<void> {
+  console.log("Otto status\n")
+  console.log(`Otto version: ${MANIFEST.version}\n`)
+
+  console.log("Packages:")
+  const packages = checkPackagePresence()
+  for (const pkg of packages) {
+    const icon = pkg.status === "ok" ? "✓" : "✗"
+    console.log(`  ${icon} ${pkg.name}: ${pkg.installed ?? "not installed"} (requires ${pkg.required})`)
+  }
+
+  console.log("\nConfig:")
+  const configHealth = checkConfigHealth()
+  console.log(`  opencode.json: ${configHealth.opencodeJson}`)
+  console.log(`  agent-memory.json: ${configHealth.agentMemoryJson}`)
+  console.log(`  otto.json: ${configHealth.ottoJson}`)
+  console.log(`  plugins: ${configHealth.plugins.length > 0 ? configHealth.plugins.join(", ") : "(none)"}`)
+  console.log(`  memory plugin: ${configHealth.memoryPluginEnabled ? "enabled" : "NOT enabled"}`)
+  console.log(`  subagent threads: ${configHealth.subagentThreadsEnabled ? "enabled" : "disabled"}`)
+  console.log(`  ask before thread delete: ${configHealth.subagentThreadsAskBeforeDelete ? "yes" : "no"}`)
+  console.log(`  auto delete thread on complete: ${configHealth.subagentThreadsAutoDelete ? "yes" : "no"}`)
+  console.log(`  kimaki process: ${configHealth.kimakiRunning ? "running" : "not running"}`)
+}
+
+async function cmdDoctor(): Promise<void> {
+  console.log("Otto doctor\n")
+
+  let hasErrors = false
+
+  console.log("Checking packages...")
+  const packages = checkPackagePresence()
+  for (const pkg of packages) {
+    if (pkg.status === "missing") {
+      console.log(`  ✗ ${pkg.name} — not installed (requires ${pkg.required})`)
+      hasErrors = true
+    } else {
+      console.log(`  ✓ ${pkg.name}: ${pkg.installed}`)
+    }
+  }
+
+  console.log("\nChecking config...")
+  const configHealth = checkConfigHealth()
+  if (configHealth.opencodeJson === "error") {
+    console.log("  ✗ opencode.json is not valid JSON — fix syntax, then run `otto install`")
+    hasErrors = true
+  }
+  if (configHealth.memoryPluginEnabled) {
+    console.log("  ✓ opencode-agent-memory plugin enabled")
+  } else {
+    console.log("  ✗ opencode-agent-memory plugin NOT enabled — run `otto install`")
+    hasErrors = true
+  }
+  if (configHealth.subagentPolicyInjected) {
+    console.log("  ✓ otto subagent thread policy injected")
+  } else {
+    console.log("  ✗ otto subagent thread policy missing — run `otto install`")
+    hasErrors = true
+  }
+  if (configHealth.kimakiRunning) {
+    console.log("  ✓ kimaki is running")
+  } else {
+    console.log("  ⚠ kimaki is not running")
+  }
+
+  console.log("\nChecking directories...")
+  const dirs = checkDirectoryHealth()
+  for (const d of dirs) {
+    const icon = d.status === "ok" ? "✓" : d.status === "warn" ? "⚠" : "✗"
+    console.log(`  ${icon} ${d.name}: ${d.message}`)
+    if (d.status === "error") hasErrors = true
+  }
+
+  console.log(hasErrors ? "\n✗ Issues found. Run `otto install` to fix." : "\n✓ All checks passed!")
+}
+
+async function main(): Promise<void> {
+  switch (command) {
+    case "install":
+      await cmdInstall()
+      break
+    case "upgrade":
+      await cmdUpgrade(subCommand === "latest" ? "latest" : "stable")
+      break
+    case "status":
+      await cmdStatus()
+      break
+    case "doctor":
+      await cmdDoctor()
+      break
+    case "sync":
+      await syncUpstreams()
+      break
+    default:
+      console.log(`Otto — terminal UI distribution for opencode + kimaki + opencode-agent-memory
+
+Usage:
+  otto install            Install missing packages + configure
+  otto upgrade            Upgrade to stable (manifest-pinned) versions
+  otto upgrade stable     Upgrade to manifest-pinned versions
+  otto upgrade latest     Upgrade to npm latest versions
+  otto status             Show installed versions + config health
+  otto doctor             Validate all integration points
+  otto sync               Trigger upstream sync for all forked repos
+`)
+      break
+  }
+}
+
+main().catch((err: unknown) => {
+  const msg = err instanceof Error ? err.message : String(err)
+  console.error(`Error: ${msg}`)
+  process.exit(1)
+})