postgresai 0.16.0-dev.7 → 0.16.0-dev.8

package/bin/postgres-ai.ts

@@ -5647,6 +5647,22 @@ withJoeOptions(
   await runJoeCli("describe", null, args, opts);
 });
 
+// history search is roadmapped for M1b; the search backend is not deployed yet.
+// Ship a recognized subcommand so the documented `pgai joe history …` example
+// degrades cleanly (an informative "not yet available" line + exit 1) instead of
+// Commander's generic "unknown command 'history'". Wire it to the rpc when M1b lands.
+withJoeOptions(
+  joe
+    .command("history <terms>")
+    .description("search prior Joe analyses, metadata-only (M1b — not yet available)")
+).action(async (_terms: string, _opts: JoeCliOpts) => {
+  console.error(
+    "Joe history search is not available yet — it is planned for M1b. " +
+      "No history-search backend is deployed; this command is a placeholder until then.",
+  );
+  process.exitCode = 1;
+});
+
 // Org-level discovery — a general postgresai command, NOT a Joe endpoint (SPEC §6).
 program
   .command("projects")

package/dist/bin/postgres-ai.js

@@ -13444,7 +13444,7 @@ var {
 // package.json
 var package_default = {
   name: "postgresai",
-  version: "0.16.0-dev.7",
+  version: "0.16.0-dev.8",
   description: "postgres_ai CLI",
   license: "Apache-2.0",
   private: false,
@@ -16275,7 +16275,7 @@ var Result = import_lib.default.Result;
 var TypeOverrides = import_lib.default.TypeOverrides;
 var defaults = import_lib.default.defaults;
 // package.json
-var version = "0.16.0-dev.7";
+var version = "0.16.0-dev.8";
 var package_default2 = {
   name: "postgresai",
   version,
@@ -39856,6 +39856,10 @@ withJoeOptions(joe.command("describe <object>").description("\\d-family schema/r
     args.variant = opts.variant;
   await runJoeCli("describe", null, args, opts);
 });
+withJoeOptions(joe.command("history <terms>").description("search prior Joe analyses, metadata-only (M1b \u2014 not yet available)")).action(async (_terms, _opts) => {
+  console.error("Joe history search is not available yet \u2014 it is planned for M1b. " + "No history-search backend is deployed; this command is a placeholder until then.");
+  process.exitCode = 1;
+});
 program2.command("projects").description("list the org's projects (shows which have Joe ready) \u2014 org-level, not a Joe endpoint").option("--debug", "enable debug output").option("--json", "output raw JSON").action(async (opts) => {
   try {
     const rootOpts = program2.opts();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postgresai",
-  "version": "0.16.0-dev.7",
+  "version": "0.16.0-dev.8",
   "description": "postgres_ai CLI",
   "license": "Apache-2.0",
   "private": false,

package/test/joe.cli.test.ts

@@ -141,11 +141,23 @@ describe("CLI Joe command surface (grouped under `pgai joe …`)", () => {
     const r = runCli(["joe", "--help"], isolatedEnv());
     expect(r.status).toBe(0);
     const out = `${r.stdout}\n${r.stderr}`;
-    for (const verb of ["plan", "explain", "exec", "hypo", "activity", "terminate", "reset", "describe", "result", "status"]) {
+    for (const verb of ["plan", "explain", "exec", "hypo", "activity", "terminate", "reset", "describe", "result", "status", "history"]) {
       expect(out).toContain(verb);
     }
   });
 
+  test("pgai joe history (M1b) is recognized and degrades cleanly", () => {
+    // The brief's §2 documents `pgai joe history "users email" --project 12`, but the
+    // history-search backend is M1b/not built. The command must be recognized (NOT a
+    // Commander "unknown command") and exit 1 with an informative pending message.
+    const r = runCli(["joe", "history", "users email", "--project", "12"], isolatedEnv({ PGAI_API_KEY: "k" }));
+    expect(r.status).toBe(1);
+    const out = `${r.stdout}\n${r.stderr}`;
+    expect(out).toContain("not available yet");
+    expect(out).toContain("M1b");
+    expect(out).not.toContain("unknown command");
+  });
+
   test("pgai projects prints the brief's table", async () => {
     const api = startFakeApi();
     try {