@prestyj/cli 5.10.0 → 5.12.0

package/dist/core/extensions/plugin-bundles.test.js

@@ -0,0 +1,110 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { ExtensionLoader } from "./loader.js";
+import { installPlugin, listInstalledPlugins, packPlugin, removePlugin } from "./plugin-bundles.js";
+let root;
+let source;
+let extensions;
+let artifact;
+async function writePlugin(id = "example.plugin", version = "1.2.3") {
+    await fs.mkdir(path.join(source, "commands"), { recursive: true });
+    await fs.writeFile(path.join(source, "plugin.json"), JSON.stringify({
+        schemaVersion: 1,
+        id,
+        name: "Example Plugin",
+        version,
+        entry: "index.mjs",
+        commands: ["commands/review.md"],
+    }));
+    await fs.writeFile(path.join(source, "index.mjs"), "export default () => ({ name: 'example', activate() {} });\n");
+    await fs.writeFile(path.join(source, "commands", "review.md"), "Review this change.\n");
+}
+beforeEach(async () => {
+    root = await fs.mkdtemp(path.join(os.tmpdir(), "ez-plugin-test-"));
+    source = path.join(root, "source");
+    extensions = path.join(root, "extensions");
+    artifact = path.join(root, "example.ggplugin");
+    await writePlugin();
+});
+afterEach(async () => {
+    await fs.rm(root, { recursive: true, force: true });
+});
+describe("plugin bundles", () => {
+    it("packs, installs, lists, updates, and removes a portable plugin without rewriting its manifest", async () => {
+        const originalManifest = await fs.readFile(path.join(source, "plugin.json"), "utf8");
+        await packPlugin(source, artifact);
+        const installed = await installPlugin(artifact, extensions);
+        expect(installed).toMatchObject({ id: "example.plugin", version: "1.2.3" });
+        expect(await fs.readFile(path.join(installed.installPath, "plugin.json"), "utf8")).toBe(originalManifest);
+        expect(await fs.readFile(path.join(installed.installPath, "commands", "review.md"), "utf8")).toBe("Review this change.\n");
+        expect(await listInstalledPlugins(extensions)).toEqual([installed]);
+        const loader = new ExtensionLoader();
+        await loader.loadAll(extensions, {});
+        expect(loader.getLoaded()).toMatchObject([{ name: "example" }]);
+        await fs.rm(source, { recursive: true, force: true });
+        await fs.mkdir(source, { recursive: true });
+        await writePlugin("example.plugin", "2.0.0");
+        await packPlugin(source, artifact);
+        await installPlugin(artifact, extensions);
+        expect(await listInstalledPlugins(extensions)).toMatchObject([
+            { id: "example.plugin", version: "2.0.0" },
+        ]);
+        await removePlugin("example.plugin", extensions);
+        expect(await listInstalledPlugins(extensions)).toEqual([]);
+    });
+    it("rejects source symlinks and unsupported executable files", async () => {
+        await fs.symlink(path.join(source, "index.mjs"), path.join(source, "linked.mjs"));
+        await expect(packPlugin(source, artifact)).rejects.toThrow("symlinks");
+        await fs.rm(path.join(source, "linked.mjs"));
+        await fs.writeFile(path.join(source, "payload.exe"), "bad");
+        await expect(packPlugin(source, artifact)).rejects.toThrow("Unsupported plugin file type");
+    });
+    it("does not let manually placed plugin manifests load entries outside their directory", async () => {
+        const pluginDir = path.join(extensions, "malicious");
+        await fs.mkdir(pluginDir, { recursive: true });
+        await fs.writeFile(path.join(pluginDir, "plugin.json"), JSON.stringify({
+            schemaVersion: 1,
+            id: "malicious",
+            name: "Malicious",
+            version: "1.0.0",
+            entry: "../outside.mjs",
+        }));
+        await fs.writeFile(path.join(extensions, "outside.mjs"), "export default () => ({ name: 'escaped', activate() {} });\n");
+        const loader = new ExtensionLoader();
+        const errorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        await loader.loadAll(extensions, {});
+        expect(loader.getLoaded()).toEqual([]);
+        expect(errorSpy).toHaveBeenCalledWith(expect.stringContaining("Unsafe plugin path"));
+        errorSpy.mockRestore();
+    });
+    it("rejects traversal and duplicate paths before writing outside the install root", async () => {
+        const manifest = {
+            schemaVersion: 1,
+            id: "example.plugin",
+            name: "Example Plugin",
+            version: "1.0.0",
+            entry: "index.mjs",
+        };
+        await fs.writeFile(artifact, JSON.stringify({
+            format: "ezcoder-agent-plugin",
+            schemaVersion: 1,
+            manifest,
+            files: [
+                {
+                    path: "plugin.json",
+                    contentBase64: Buffer.from(JSON.stringify(manifest)).toString("base64"),
+                },
+                {
+                    path: "index.mjs",
+                    contentBase64: Buffer.from("export default () => ({})").toString("base64"),
+                },
+                { path: "../escaped.js", contentBase64: Buffer.from("bad").toString("base64") },
+            ],
+        }));
+        await expect(installPlugin(artifact, extensions)).rejects.toThrow("Unsafe plugin path");
+        await expect(fs.stat(path.join(root, "escaped.js"))).rejects.toMatchObject({ code: "ENOENT" });
+    });
+});
+//# sourceMappingURL=plugin-bundles.test.js.map

package/dist/core/extensions/plugin-bundles.test.js.map

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

package/dist/core/fast-apply-benchmark.d.ts

@@ -19,8 +19,8 @@
  *   npx tsx src/core/fast-apply-benchmark.ts
  *
  * Env overrides:
- *   GG_FA_FRONTIER_PROVIDER / GG_FA_FRONTIER_MODEL   (default openai / gpt-5.5)
- *   GG_FA_APPLY_PROVIDER     / GG_FA_APPLY_MODEL      (default gemini / gemini-3.1-flash-lite)
+ *   EZ_FA_FRONTIER_PROVIDER / EZ_FA_FRONTIER_MODEL   (default openai / gpt-5.5)
+ *   EZ_FA_APPLY_PROVIDER     / EZ_FA_APPLY_MODEL      (default gemini / gemini-3.1-flash-lite)
  */
 export {};
 //# sourceMappingURL=fast-apply-benchmark.d.ts.map

package/dist/core/fast-apply-benchmark.js

@@ -19,8 +19,8 @@
  *   npx tsx src/core/fast-apply-benchmark.ts
  *
  * Env overrides:
- *   GG_FA_FRONTIER_PROVIDER / GG_FA_FRONTIER_MODEL   (default openai / gpt-5.5)
- *   GG_FA_APPLY_PROVIDER     / GG_FA_APPLY_MODEL      (default gemini / gemini-3.1-flash-lite)
+ *   EZ_FA_FRONTIER_PROVIDER / EZ_FA_FRONTIER_MODEL   (default openai / gpt-5.5)
+ *   EZ_FA_APPLY_PROVIDER     / EZ_FA_APPLY_MODEL      (default gemini / gemini-3.1-flash-lite)
  */
 import { stream } from "@prestyj/ai";
 import { AuthStorage } from "./auth-storage.js";
@@ -189,10 +189,10 @@ function checkAnchors(finalFile, task) {
     return true;
 }
 async function main() {
-    const frontierProvider = process.env.GG_FA_FRONTIER_PROVIDER ?? "openai";
-    const frontierModel = process.env.GG_FA_FRONTIER_MODEL ?? "gpt-5.5";
-    const applyProvider = process.env.GG_FA_APPLY_PROVIDER ?? "gemini";
-    const applyModel = process.env.GG_FA_APPLY_MODEL ?? "gemini-3.1-flash-lite";
+    const frontierProvider = process.env.EZ_FA_FRONTIER_PROVIDER ?? "openai";
+    const frontierModel = process.env.EZ_FA_FRONTIER_MODEL ?? "gpt-5.5";
+    const applyProvider = process.env.EZ_FA_APPLY_PROVIDER ?? "gemini";
+    const applyModel = process.env.EZ_FA_APPLY_MODEL ?? "gemini-3.1-flash-lite";
     const auth = new AuthStorage();
     await auth.load();
     const resolve = async (p) => {

package/dist/core/foreign-session-import.d.ts

@@ -0,0 +1,120 @@
+import type { Message, Provider } from "@prestyj/ai";
+import { type SessionManager } from "./session-manager.js";
+/**
+ * Parse a foreign coding-agent transcript (Claude Code, Codex, Cursor) into
+ * EZ Coder messages so the thread can be resumed here.
+ *
+ * `project-discovery.ts` already walks `~/.claude/projects` and
+ * `~/.codex/sessions`, but only to recover a cwd. This module reads the message
+ * records themselves.
+ *
+ * Import is lossy **by design**: anything we cannot map faithfully is dropped
+ * and counted, never fabricated. `ForeignImportResult.dropped` reports exactly
+ * what was lost so the caller can record it on the imported session.
+ */
+export type ForeignFormat = "claude" | "codex" | "cursor";
+export interface ForeignImportDropped {
+    /** Tool results whose call we could not pair, or whose payload was unmappable. */
+    toolResults: number;
+    /** Records recognized as messages but with no usable content. */
+    messages: number;
+    /** Lines that were not valid JSON or not a known record shape. */
+    records: number;
+}
+export interface ForeignImportResult {
+    format: ForeignFormat;
+    messages: Message[];
+    /** Working directory recorded by the source agent, when it stored one. */
+    cwd?: string;
+    /** First user prompt, used as the session preview/title. */
+    preview?: string;
+    /** Epoch millis of the earliest record, when the source recorded timestamps. */
+    startedAt?: number;
+    dropped: ForeignImportDropped;
+}
+/** Human-readable summary of what an import discarded. */
+export declare function describeDropped(dropped: ForeignImportDropped): string;
+/**
+ * Identify a transcript from its records. Detection is shape-based, not
+ * filename-based, so a transcript copied out of its home directory still
+ * imports correctly.
+ */
+export declare function detectForeignFormat(text: string): ForeignFormat | undefined;
+export declare function parseForeignTranscript(text: string, format?: ForeignFormat): ForeignImportResult;
+/**
+ * Claude Code writes one JSONL record per DAG node under
+ * `~/.claude/projects/<encoded-cwd>/<session>.jsonl`. Message records are
+ * `{ type: "user"|"assistant", message: { role, content }, uuid, cwd, timestamp }`
+ * where `content` is a string or an Anthropic content-block array. Non-message
+ * record types (system, file-history-snapshot, mode, …) are UI state, not
+ * conversation, and are skipped without counting as data loss.
+ */
+export declare function parseClaudeTranscript(text: string): ForeignImportResult;
+/**
+ * Codex rollouts live at `~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl`.
+ * Current records are `{ timestamp, type, payload }` where `type` is
+ * `session_meta` / `response_item` / `event_msg` / `turn_context`; older
+ * rollouts wrote the payload at the top level with no wrapper.
+ *
+ * Only `response_item` carries the model conversation. `event_msg` duplicates
+ * it for the UI, so importing both would double every turn.
+ */
+export declare function parseCodexTranscript(text: string): ForeignImportResult;
+/**
+ * Cursor exports a flat JSONL chat log: one record per turn, carrying a role
+ * and either a plain `text`/`content` string or a content-block array.
+ *
+ * The part that actually matters on import is the wrapping: Cursor sends the
+ * typed prompt inside `<user_query>`, preceded by context blocks such as
+ * `<cursor_commands>` and `<timestamp>`. Importing that verbatim leaks harness
+ * scaffolding into the session title and preview, so a recognized wrapper is
+ * stripped while a message with UNRECOGNIZED leading context is kept intact —
+ * that text may be something the user genuinely wrote.
+ */
+export declare function parseCursorTranscript(text: string): ForeignImportResult;
+export interface ImportedSession {
+    sessionId: string;
+    sessionPath: string;
+    cwd: string;
+    messageCount: number;
+    format: ForeignFormat;
+    dropped: ForeignImportDropped;
+    preview?: string;
+}
+export interface ImportForeignSessionOptions {
+    /** Path to the foreign JSONL transcript. */
+    filePath: string;
+    sessionManager: SessionManager;
+    provider: Provider;
+    model: string;
+    /** Overrides the cwd recorded by the source agent. */
+    cwd?: string;
+    /** Skips detection when the caller already knows the format. */
+    format?: ForeignFormat;
+}
+/**
+ * Read a foreign transcript and write it out as a real EZ Coder session, so it
+ * resumes through the existing loader with no reader changes: a v2
+ * `SessionHeader` from `SessionManager.create()`, one `MessageEntry` per
+ * message chained through `parentId`, and a final leaf pointer.
+ *
+ * An `import` app marker records the source and everything the import dropped —
+ * import is lossy by definition, and a silent loss is worse than a noted one.
+ */
+export declare function importForeignSession(opts: ImportForeignSessionOptions): Promise<ImportedSession>;
+/** Never-throwing result shape shared by the CLI, the sidecar and the app. */
+export type ImportForeignTranscriptResult = {
+    ok: true;
+    sessionId: string;
+    sessionPath: string;
+    cwd: string;
+    format: ForeignFormat;
+    messageCount: number;
+    /** Human-readable summary of what the lossy import discarded. */
+    dropped: string;
+    preview?: string;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=foreign-session-import.d.ts.map

package/dist/core/foreign-session-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"foreign-session-import.d.ts","sourceRoot":"","sources":["../../src/core/foreign-session-import.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAe,OAAO,EAAE,QAAQ,EAAc,MAAM,aAAa,CAAC;AAC9E,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAc9B;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAID,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAMrE;AAID;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAyC3E;AAID,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,mBAAmB,CAehG;AAkID;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CA2FvE;AAID;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CA+DtE;AA4CD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAgCvE;AAqDD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,2BAA2B;IAC1C,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,2BAA2B,GAChC,OAAO,CAAC,eAAe,CAAC,CAsE1B;AAED,8EAA8E;AAC9E,MAAM,MAAM,6BAA6B,GACrC;IACE,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,aAAa,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}