ima2-gen 1.1.21 → 1.1.23

package/bin/commands/session.ts

@@ -1,266 +0,0 @@
-import { readFile } from "fs/promises";
-import { parseArgs, type ParsedArgs } from "../lib/args.js";
-import { resolveServer, request } from "../lib/client.js";
-import { out, die, color, json, exitCodeForError, table } from "../lib/output.js";
-
-const HELP = `
-  ima2 session <subcommand> [options]
-
-  Subcommands:
-    ls [--json]                            List sessions
-    show <id> [--json]                     Show session details
-    create <title>                         Create a new session
-    rm <id> [--yes]                        Delete a session
-    rename <id> <title>                    Rename a session
-    graph save <id> <file>                 Save graph JSON (uses If-Match for concurrency)
-    graph load <id> [--out <file>]         Load graph JSON (stdout or --out)
-    style-sheet get <id> [--json]
-    style-sheet put <id> <file>            Replace full style sheet
-    style-sheet enable <id>
-    style-sheet disable <id>
-    style-sheet extract <id>               LLM-extract style sheet from session content
-
-  Common options:
-        --server <url>                     Override server URL
-        --json                             JSON output
-        --yes                              Skip destructive confirmation
-`;
-
-const COMMON_FLAGS = {
-  json: { type: "boolean" },
-  server: { type: "string" },
-  yes: { type: "boolean" },
-  out: { type: "string" },
-  help: { short: "h", type: "boolean" },
-};
-
-async function getServer(args: ParsedArgs) {
-  try { return await resolveServer({ serverFlag: args.server }); }
-  catch (e: any) { die(exitCodeForError(e), e.message); throw e; }
-}
-
-async function lsSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: COMMON_FLAGS });
-  const server = await getServer(args);
-  const resp = await request(server.base, "/api/sessions").catch(handle);
-  const sessions = resp.sessions || [];
-  if (args.json) { json({ sessions }); return; }
-  if (sessions.length === 0) { out(color.dim("(no sessions)")); return; }
-  table(sessions, [
-    { key: "id", label: "ID" },
-    { key: "title", label: "TITLE" },
-    { key: "createdAt", label: "WHEN", format: (v: unknown) => v ? new Date(v as string | number).toISOString().slice(0, 19) : "" },
-  ]);
-}
-
-async function showSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: COMMON_FLAGS });
-  const id = args.positional[0];
-  if (!id) die(2, "session id required");
-  const server = await getServer(args);
-  const resp = await request(server.base, `/api/sessions/${encodeURIComponent(id)}`).catch(handle);
-  if (args.json) { json(resp); return; }
-  const s = resp.session || resp;
-  out(color.bold(s.id || id));
-  out(color.dim("  title: ") + (s.title || ""));
-  if (s.graph) out(color.dim("  graph: ") + `${s.graph.nodes?.length ?? 0} nodes, ${s.graph.edges?.length ?? 0} edges, version ${s.graph.version}`);
-  if (s.styleSheet) out(color.dim("  styleSheet: ") + (s.styleSheet.enabled ? "enabled" : "disabled"));
-}
-
-async function createSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: COMMON_FLAGS });
-  const title = args.positional.join(" ").trim();
-  if (!title) die(2, "title required");
-  const server = await getServer(args);
-  const resp = await request(server.base, "/api/sessions", {
-    method: "POST",
-    body: { title },
-  }).catch(handle);
-  if (args.json) { json(resp); return; }
-  out(color.green("✓ ") + (resp.session?.id || "(no id returned)"));
-}
-
-async function rmSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: COMMON_FLAGS });
-  const id = args.positional[0];
-  if (!id) die(2, "session id required");
-  if (!args.yes && !process.stdin.isTTY) die(2, "destructive: pass --yes for non-TTY");
-  if (!args.yes) {
-    process.stdout.write(`Delete session ${id}? [y/N] `);
-    const ans = await readLine();
-    if (!/^y(es)?$/i.test(ans.trim())) { out("(canceled)"); return; }
-  }
-  const server = await getServer(args);
-  await request(server.base, `/api/sessions/${encodeURIComponent(id)}`, { method: "DELETE" }).catch(handle);
-  out(color.green("✓ deleted"));
-}
-
-async function renameSub(argv: string[]) {
-  const args = parseArgs(argv, { flags: COMMON_FLAGS });
-  const [id, ...rest] = args.positional;
-  const title = rest.join(" ").trim();
-  if (!id || !title) die(2, "usage: session rename <id> <title>");
-  const server = await getServer(args);
-  await request(server.base, `/api/sessions/${encodeURIComponent(id)}`, {
-    method: "PATCH",
-    body: { title },
-  }).catch(handle);
-  out(color.green("✓ renamed"));
-}
-
-async function graphSub(argv: string[]) {
-  const action = argv[0];
-  const rest = argv.slice(1);
-  if (action === "save") return graphSave(rest);
-  if (action === "load") return graphLoad(rest);
-  die(2, "usage: session graph <save|load> ...");
-}
-
-async function graphSave(argv: string[]) {
-  const args = parseArgs(argv, { flags: COMMON_FLAGS });
-  const [id, file] = args.positional;
-  if (!id || !file) die(2, "usage: session graph save <id> <file>");
-  const buf = await readFile(file, "utf-8");
-  let parsed;
-  try { parsed = JSON.parse(buf); } catch { die(2, "graph file is not valid JSON"); }
-  const { nodes, edges } = parsed;
-  if (!Array.isArray(nodes) || !Array.isArray(edges))
-    die(2, "graph file must contain { nodes: [], edges: [] }");
-  const server = await getServer(args);
-  // Step 1: fetch current version
-  const current: any = await request(server.base, `/api/sessions/${encodeURIComponent(id)}`).catch(handle);
-  const version = current?.session?.graph?.version;
-  if (typeof version !== "number") die(1, "could not resolve current graph version");
-  // Step 2: PUT with If-Match
-  try {
-    const result: any = await request(server.base, `/api/sessions/${encodeURIComponent(id)}/graph`, {
-      method: "PUT",
-      body: { nodes, edges },
-      headers: { "If-Match": `"${version}"` },
-    });
-    if (args.json) { json(result); return; }
-    out(color.green(`✓ saved (graphVersion: ${result.graphVersion})`));
-  } catch (e: any) {
-    if (e.status === 412 || e.code === "GRAPH_VERSION_CONFLICT") die(1, "graph version conflict — fetch latest and retry");
-    if (e.status === 413) die(1, e.message);
-    handle(e);
-  }
-}
-
-async function graphLoad(argv: string[]) {
-  const args = parseArgs(argv, { flags: COMMON_FLAGS });
-  const id = args.positional[0];
-  if (!id) die(2, "usage: session graph load <id>");
-  const server = await getServer(args);
-  const resp: any = await request(server.base, `/api/sessions/${encodeURIComponent(id)}`).catch(handle);
-  const graph = resp?.session?.graph;
-  if (!graph) die(1, "no graph for session");
-  const text = JSON.stringify(graph, null, 2);
-  if (args.out) {
-    const { writeFile } = await import("fs/promises");
-    await writeFile(String(args.out), text);
-    out(color.green("✓ ") + String(args.out));
-  } else {
-    process.stdout.write(text + "\n");
-  }
-}
-
-async function styleSheetSub(argv: string[]) {
-  const action = argv[0];
-  const rest = argv.slice(1);
-  if (action === "get") return ssGet(rest);
-  if (action === "put") return ssPut(rest);
-  if (action === "enable") return ssEnable(rest, true);
-  if (action === "disable") return ssEnable(rest, false);
-  if (action === "extract") return ssExtract(rest);
-  die(2, "usage: session style-sheet <get|put|enable|disable|extract> ...");
-}
-
-async function ssGet(argv: string[]) {
-  const args = parseArgs(argv, { flags: COMMON_FLAGS });
-  const id = args.positional[0];
-  if (!id) die(2, "session id required");
-  const server = await getServer(args);
-  const resp = await request(server.base, `/api/sessions/${encodeURIComponent(id)}/style-sheet`).catch(handle);
-  json(resp);
-}
-
-async function ssPut(argv: string[]) {
-  const args = parseArgs(argv, { flags: COMMON_FLAGS });
-  const [id, file] = args.positional;
-  if (!id || !file) die(2, "usage: session style-sheet put <id> <file>");
-  const buf = await readFile(file, "utf-8");
-  let parsed;
-  try { parsed = JSON.parse(buf); } catch { die(2, "style-sheet file is not valid JSON"); }
-  const server = await getServer(args);
-  await request(server.base, `/api/sessions/${encodeURIComponent(id)}/style-sheet`, {
-    method: "PUT",
-    body: parsed,
-  }).catch(handle);
-  out(color.green("✓ style-sheet updated"));
-}
-
-async function ssEnable(argv: string[], enabled: boolean) {
-  const args = parseArgs(argv, { flags: COMMON_FLAGS });
-  const id = args.positional[0];
-  if (!id) die(2, "session id required");
-  const server = await getServer(args);
-  await request(server.base, `/api/sessions/${encodeURIComponent(id)}/style-sheet/enabled`, {
-    method: "PATCH",
-    body: { enabled },
-  }).catch(handle);
-  out(color.green(enabled ? "✓ enabled" : "✓ disabled"));
-}
-
-async function ssExtract(argv: string[]) {
-  const args = parseArgs(argv, { flags: COMMON_FLAGS });
-  const id = args.positional[0];
-  if (!id) die(2, "session id required");
-  const server = await getServer(args);
-  const resp = await request(server.base, `/api/sessions/${encodeURIComponent(id)}/style-sheet/extract`, {
-    method: "POST",
-    timeoutMs: 120_000,
-  }).catch(handle);
-  json(resp);
-}
-
-function handle(e: unknown) {
-  const err = e as { message?: string; code?: string };
-  die(exitCodeForError(e), `${err.message}${err.code ? ` (${err.code})` : ""}`);
-}
-
-async function readLine(): Promise<string> {
-  return new Promise((resolve) => {
-    let buf = "";
-    process.stdin.setEncoding("utf-8");
-    const onData = (chunk: Buffer | string) => {
-      buf += chunk;
-      const nl = buf.indexOf("\n");
-      if (nl !== -1) {
-        process.stdin.removeListener("data", onData);
-        process.stdin.pause();
-        resolve(buf.slice(0, nl));
-      }
-    };
-    process.stdin.resume();
-    process.stdin.on("data", onData);
-  });
-}
-
-const SUB: Record<string, (argv: any[]) => Promise<void>> = {
-  ls: lsSub,
-  show: showSub,
-  create: createSub,
-  rm: rmSub,
-  rename: renameSub,
-  graph: graphSub,
-  "style-sheet": styleSheetSub,
-};
-
-export default async function sessionCmd(argv: string[]) {
-  const sub = argv[0];
-  if (!sub || sub === "--help" || sub === "-h") { out(HELP); return; }
-  const handler = SUB[sub];
-  if (!handler) die(2, `unknown subcommand: ${sub}\n${HELP}`);
-  return handler(argv.slice(1));
-}

package/bin/commands/show.ts

@@ -1,72 +0,0 @@
-import { parseArgs } from "../lib/args.js";
-import { resolveServer, request } from "../lib/client.js";
-import { openUrl } from "../lib/platform.js";
-import { out, die, color, json, exitCodeForError } from "../lib/output.js";
-import { fileToDataUri } from "../lib/files.js";
-import { config } from "../../config.js";
-
-import { errInfo } from "../../lib/errInfo.js";
-const SPEC = {
-  flags: {
-    json:   { type: "boolean" },
-    reveal: { type: "boolean" },
-    metadata: { type: "boolean" },
-    server: { type: "string" },
-    help:   { short: "h", type: "boolean" },
-  },
-};
-
-export default async function showCmd(argv: string[]) {
-  const args = parseArgs(argv, SPEC);
-  if (args.help) { out("ima2 show <filename> [--json] [--reveal] [--metadata]"); return; }
-  const name = args.positional[0];
-  if (!name) die(2, "filename required");
-
-  let server;
-  try { server = await resolveServer({ serverFlag: args.server }); }
-  catch (e) {
-    const err = errInfo(e); die(exitCodeForError(e), err.message); }
-
-  let resp;
-  try { resp = await request(server.base, "/api/history"); }
-  catch (e) {
-    const err = errInfo(e); die(exitCodeForError(e), err.message); }
-
-  const items: Record<string, any>[] = resp.items || resp.history || [];
-  const item = items.find((it: Record<string, any>) => it.filename === name || (it.filename && it.filename.endsWith(name)));
-  if (!item) die(1, `not found: ${name}`);
-
-  let metadata: any = null;
-  if (args.metadata) {
-    try {
-      const dataUrl = await fileToDataUri(`${config.storage.generatedDir}/${item.filename}`);
-      metadata = await request(server.base, "/api/metadata/read", {
-        method: "POST",
-        body: { dataUrl },
-      });
-    } catch (e: any) {
-      out(color.dim(`(metadata unavailable: ${e?.message || e})`));
-    }
-  }
-
-  if (args.json) { json(args.metadata ? { ...item, metadata } : item); }
-  else {
-    out(color.bold(item.filename));
-    out(color.dim(`  prompt:`)   + ` ${item.prompt || ""}`);
-    out(color.dim(`  size:`)     + ` ${item.size || ""}  quality: ${item.quality || ""}`);
-    if (item.createdAt) out(color.dim(`  when:`) + ` ${new Date(item.createdAt).toISOString()}`);
-    if (item.url) out(color.dim(`  url:`) + ` ${server.base}${item.url}`);
-    if (metadata) {
-      out(color.dim(`  metadata:`));
-      const dump = JSON.stringify(metadata, null, 2).split("\n").map(l => "    " + l).join("\n");
-      out(dump);
-    }
-  }
-
-  if (args.reveal) {
-    const url = item.url ? `${server.base}${item.url}` : null;
-    if (!url) { out(color.yellow("(no url)")); return; }
-    const res = openUrl(url);
-    if (!res.ok) out(color.yellow("(could not reveal)"));
-  }
-}

package/bin/commands/skill.ts

@@ -1,70 +0,0 @@
-import { existsSync, readFileSync } from "fs";
-import { dirname, join, relative } from "path";
-import { fileURLToPath } from "url";
-import { parseArgs } from "../lib/args.js";
-import { die, json, out } from "../lib/output.js";
-
-const ROOT = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
-const SKILL_PATH = join(ROOT, "skills", "ima2", "SKILL.md");
-const PACKAGE_PATH = join(ROOT, "package.json");
-
-const HELP = `
-  ima2 skill [path] [--json]
-
-  Print the packaged ima2 Markdown skill for agents.
-
-  Commands:
-    ima2 skill          Print skills/ima2/SKILL.md
-    ima2 skill path     Print resolved skill path
-    ima2 skill --json   Print a JSON wrapper around the Markdown skill
-`;
-
-const FLAGS = {
-  json: { type: "boolean" },
-  help: { short: "h", type: "boolean" },
-};
-
-function readPackageVersion(): string {
-  try {
-    const pkg = JSON.parse(readFileSync(PACKAGE_PATH, "utf-8")) as { version?: string };
-    return pkg.version || "?";
-  } catch {
-    return "?";
-  }
-}
-
-function readSkill(): string {
-  if (!existsSync(SKILL_PATH)) {
-    die(5, `packaged skill not found: ${SKILL_PATH}`);
-  }
-  return readFileSync(SKILL_PATH, "utf-8");
-}
-
-export default async function skillCmd(argv: string[]) {
-  const args = parseArgs(argv, { flags: FLAGS });
-  if (args.help) {
-    out(HELP);
-    return;
-  }
-
-  if (args.positional[0] === "path") {
-    out(SKILL_PATH);
-    return;
-  }
-
-  const content = readSkill();
-  if (args.json) {
-    json({
-      name: "ima2",
-      format: "markdown-skill",
-      formatVersion: "1",
-      packageVersion: readPackageVersion(),
-      path: relative(ROOT, SKILL_PATH),
-      source: "package",
-      content,
-    });
-    return;
-  }
-
-  out(content.replace(/\n$/, ""));
-}