@great-arrow/cli 0.7.0 → 0.7.1

package/README.md

@@ -80,6 +80,12 @@ gad memory delete <id>
 cat notes.md | gad memory create --title "Meeting notes"
 ```
 
+`gad memory search` shows a **Source** column for every hit: the original
+document's link (GitHub, Notion, Drive…) when there is one, otherwise the
+memory's page in the web app. `gad ask` prints a numbered **Sources** list of
+the memories its answer was built from, under the answer (`--quiet` hides it;
+`--json` keeps the raw `hits`).
+
 ### Workspace
 
 ```bash

package/dist/index.js

@@ -9483,7 +9483,7 @@ function isNodeError(value) {
 
 // src/lib/version.ts
 var CLI_PACKAGE_NAME = "@great-arrow/cli";
-var CLI_VERSION = "0.7.0";
+var CLI_VERSION = "0.7.1";
 var GAD_INSTALL_VERSION = "2026.08.08";
 var GAD_INSTALL_MIN_VERSION = "2026.06.22";
 var GAD_INSTALL_HEADER = "X-GAD-Install-Version";
@@ -12198,11 +12198,56 @@ function readStdin(stream) {
   return readStream(input2);
 }
 
+// src/lib/sources.ts
+function nonEmpty2(value) {
+  if (typeof value !== "string") return null;
+  const clean = stripControlChars(value).trim();
+  return clean === "" ? null : clean;
+}
+function httpUrl(value) {
+  const raw = nonEmpty2(value);
+  if (!raw) return null;
+  try {
+    const parsed = new URL(raw);
+    return parsed.protocol === "https:" || parsed.protocol === "http:" ? parsed.toString() : null;
+  } catch {
+    return null;
+  }
+}
+function sourceOf(hit, apiUrl) {
+  const memoryId = nonEmpty2(hit.memoryId);
+  const link = httpUrl(hit.url) ?? (memoryId ? `${apiUrl.replace(/\/$/, "")}/stuff/memories/${encodeURIComponent(memoryId)}` : null);
+  const label = nonEmpty2(hit.fileName) ?? nonEmpty2(hit.memoryTitle) ?? nonEmpty2(hit.title) ?? memoryId ?? "Untitled";
+  return { label, link };
+}
+function uniqueSources(hits, apiUrl, max = 5) {
+  const seen = /* @__PURE__ */ new Set();
+  const out2 = [];
+  for (const hit of hits) {
+    const source = sourceOf(hit, apiUrl);
+    const key = source.link ?? source.label;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out2.push(source);
+    if (out2.length >= max) break;
+  }
+  return out2;
+}
+function formatSources(sources) {
+  if (sources.length === 0) return "";
+  const lines = sources.map(
+    (s2, i) => `  [${i + 1}] ${s2.label}${s2.link ? ` \u2014 ${s2.link}` : ""}`
+  );
+  return `Sources:
+${lines.join("\n")}`;
+}
+
 // src/commands/memory.ts
 var searchColumns = [
   { key: "title", header: "Title", width: 30 },
   { key: "layer", header: "Layer", width: 12 },
   { key: "freshness", header: "Freshness", width: 10 },
+  { key: "source", header: "Source" },
   {
     key: "preview",
     header: "Preview",
@@ -12298,7 +12343,12 @@ memoryCommand.command("create").description("Create a new memory in the active w
 });
 memoryCommand.command("search <query>").description("Semantic search across memories").option("--json", "Output as JSON").option("-k, --limit <number>", "Max results", "10").option("--layer <layer>", "Filter by layer").action(async (query, opts, command) => {
   const g = globalOutputOpts(command);
-  const client2 = await buildClient();
+  const auth = await resolveAuth();
+  const client2 = new GadClient({
+    token: auth.token,
+    getToken: auth.getToken,
+    apiUrl: auth.apiUrl
+  });
   const args = {
     query,
     k: Number.parseInt(opts.limit, 10)
@@ -12312,6 +12362,7 @@ memoryCommand.command("search <query>").description("Semantic search across memo
   const rows = rawResults.map((item) => ({
     ...item,
     title: item.title ?? item.memoryTitle,
+    source: sourceOf(item, auth.apiUrl).link ?? "",
     preview: extractPreview(item)
   }));
   const fmt = createFormatter({
@@ -18293,6 +18344,17 @@ function askOutcome(data) {
   const answer = extractAnswer(data);
   return answer.trim() === "" ? { kind: "empty" } : { kind: "ok", text: answer };
 }
+function askSources(data, apiUrl) {
+  if (!data || typeof data !== "object") return "";
+  const hits = data.hits;
+  if (!Array.isArray(hits)) return "";
+  return formatSources(
+    uniqueSources(
+      hits.filter((h) => typeof h === "object" && h !== null),
+      apiUrl
+    )
+  );
+}
 function askCommand() {
   const cmd = new Command("ask").description("Ask the orchestrator a question").argument("<question>", "The question to ask").option("--json", "Output raw response as JSON").option("--quiet", "Suppress decorative output").option("--no-color", "Disable color output").action(async (question, options, command) => {
     const g = globalOutputOpts(command);
@@ -18329,6 +18391,10 @@ function askCommand() {
     const outcome = askOutcome(result);
     if (outcome.kind === "ok") {
       process.stdout.write(outcome.text + "\n");
+      const sources = g.quiet ? "" : askSources(result, auth.apiUrl);
+      if (sources) process.stdout.write(`
+${sources}
+`);
     } else if (outcome.kind === "error") {
       fmt.warn(`Orchestrator error: ${outcome.message}`);
       process.exitCode = 1;
@@ -20107,7 +20173,7 @@ __export(external_exports, {
   hash: () => hash,
   hex: () => hex2,
   hostname: () => hostname4,
-  httpUrl: () => httpUrl,
+  httpUrl: () => httpUrl2,
   iban: () => iban2,
   includes: () => _includes,
   input: () => input,
@@ -37046,7 +37112,7 @@ __export(schemas_exports2, {
   hash: () => hash,
   hex: () => hex2,
   hostname: () => hostname4,
-  httpUrl: () => httpUrl,
+  httpUrl: () => httpUrl2,
   iban: () => iban2,
   instanceof: () => _instanceof,
   int: () => int,
@@ -37594,7 +37660,7 @@ var ZodURL = /* @__PURE__ */ $constructor("ZodURL", (inst, def) => {
 function url(params) {
   return _url(ZodURL, params);
 }
-function httpUrl(params) {
+function httpUrl2(params) {
   return _url(ZodURL, {
     protocol: httpProtocol,
     hostname: domain,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@great-arrow/cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "GreatArrow.ai CLI tool",
   "type": "module",
   "bin": {