updose 0.3.0 → 0.4.0

package/README.md

@@ -130,9 +130,9 @@ npx updose search --author james --target claude      # james's Claude boilerpla
 npx updose search --tag typescript --target codex     # TypeScript boilerplates for Codex
 ```
 
-At least one of the query or filter options must be provided. Running `npx updose search` with no arguments will show an error.
+Running `npx updose search` with no arguments returns popular boilerplates.
 
-Results display the boilerplate name, version, author, description, rating, download count, supported targets, and tags.
+Results display the boilerplate name, version, author, description, download count, supported targets, and tags.
 
 | Option              | Description                                                 |
 |--------             |-------------                                                |

package/dist/index.cjs

@@ -25,6 +25,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 // src/index.ts
 var import_commander = require("commander");
 
+// src/commands/add.ts
+var import_node_crypto = require("crypto");
+
 // src/constants.ts
 var USER_AGENT = "updose-cli";
 var MANIFEST_FILENAME = "updose.json";
@@ -51,14 +54,18 @@ async function searchBoilerplates(query, filters) {
   }
   return await res.json();
 }
-async function recordDownload(repo, dir) {
+async function recordDownload(repo, dir, projectHash) {
   await fetch(`${API_BASE_URL}/download`, {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
       "User-Agent": USER_AGENT
     },
-    body: JSON.stringify({ repo, dir: dir ?? null }),
+    body: JSON.stringify({
+      repo,
+      dir: dir ?? null,
+      ...projectHash ? { project_hash: projectHash } : {}
+    }),
     signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
   });
 }
@@ -357,35 +364,10 @@ function handleHttpError(res) {
     );
   }
 }
-var branchCache = /* @__PURE__ */ new Map();
-async function getDefaultBranch(repo) {
-  const cached = branchCache.get(repo);
-  if (cached) return cached;
-  const { owner, name } = parseRepo(repo);
-  const res = await fetch(`${GITHUB_API_URL}/repos/${owner}/${name}`, {
-    headers: {
-      Accept: GITHUB_ACCEPT_HEADER,
-      "User-Agent": USER_AGENT,
-      ...getAuthHeaders()
-    },
-    signal: createSignal()
-  });
-  if (res.status === 404) {
-    throw new Error(`Repository not found: ${repo}`);
-  }
-  handleHttpError(res);
-  if (!res.ok) {
-    throw new Error(`GitHub API error: ${res.status} ${res.statusText}`);
-  }
-  const data = await res.json();
-  branchCache.set(repo, data.default_branch);
-  return data.default_branch;
-}
 async function fetchFile(repo, path) {
   const { owner, name } = parseRepo(repo);
-  const branch = await getDefaultBranch(repo);
   const encodedPath = path.split("/").map((segment) => encodeURIComponent(segment)).join("/");
-  const url = `${GITHUB_RAW}/${owner}/${name}/${branch}/${encodedPath}`;
+  const url = `${GITHUB_RAW}/${owner}/${name}/HEAD/${encodedPath}`;
   const res = await fetch(url, {
     headers: { "User-Agent": USER_AGENT, ...getAuthHeaders() },
     signal: createSignal()
@@ -417,8 +399,7 @@ async function fetchManifest(repo, dir) {
 }
 async function fetchRepoTree(repo) {
   const { owner, name } = parseRepo(repo);
-  const branch = await getDefaultBranch(repo);
-  const url = `${GITHUB_API_URL}/repos/${owner}/${name}/git/trees/${branch}?recursive=1`;
+  const url = `${GITHUB_API_URL}/repos/${owner}/${name}/git/trees/HEAD?recursive=1`;
   const res = await fetch(url, {
     headers: {
       Accept: GITHUB_ACCEPT_HEADER,
@@ -809,7 +790,8 @@ async function addCommand(repoInput, options) {
     const summary = skillsInstalled > 0 ? `${installed} file(s) + ${skillsInstalled} skill(s)` : `${installed} file(s)`;
     success(`Done! ${summary} installed, ${skipped} skipped.`);
     if (installed + skillsInstalled > 0) {
-      await recordDownload(repo, dir).catch(() => {
+      const projectHash = (0, import_node_crypto.createHash)("sha256").update(cwd).digest("hex");
+      await recordDownload(repo, dir, projectHash).catch(() => {
       });
     }
   } catch (err) {
@@ -1427,29 +1409,26 @@ function detectRepo(cwd) {
 var import_chalk4 = __toESM(require("chalk"), 1);
 async function searchCommand(query, options) {
   try {
-    if (!query && !options.target && !options.tag && !options.author) {
-      error(
-        "Please provide a search query or at least one filter (--target, --tag, --author)."
-      );
-      process.exitCode = 1;
-      return;
-    }
     const filters = {};
     if (options.target) filters.target = options.target;
     if (options.tag) filters.tag = options.tag;
     if (options.author) filters.author = options.author;
-    const results = await searchBoilerplates(query, filters);
-    const label = query ? `"${query}"` : "the given filters";
-    if (results.length === 0) {
+    const hasParams = !!(query || filters.target || filters.tag || filters.author);
+    const label = query ? `"${query}"` : hasParams ? "the given filters" : "popular boilerplates";
+    const response = await searchBoilerplates(query, filters);
+    if (response.data.length === 0) {
       info(`No boilerplates found for ${label}`);
       return;
     }
     console.log();
-    info(`Found ${results.length} result(s) for ${label}:
+    info(`Found ${response.total} result(s) for ${label}:
 `);
-    for (const bp of results) {
+    for (const bp of response.data) {
       formatResult(bp);
     }
+    console.log(
+      import_chalk4.default.dim(`  Browse more results and details at https://updose.dev/`)
+    );
   } catch (err) {
     error(
       err instanceof Error ? err.message : "An unexpected error occurred during search."
@@ -1463,10 +1442,9 @@ function formatResult(bp) {
   if (bp.description) {
     console.log(`    ${bp.description}`);
   }
-  const rating = bp.avg_rating > 0 ? `${import_chalk4.default.yellow("\u2605")} ${bp.avg_rating}${bp.rating_count > 0 ? import_chalk4.default.dim(` (${bp.rating_count})`) : ""}` : import_chalk4.default.dim("\u2605 -");
   const downloads = `${import_chalk4.default.green("\u2193")} ${bp.downloads.toLocaleString()}`;
   const targets = import_chalk4.default.cyan(bp.targets.join(", "));
-  console.log(`    ${rating}  ${downloads}  ${targets}`);
+  console.log(`    ${downloads}  ${targets}`);
   if (bp.tags.length > 0) {
     console.log(`    ${bp.tags.map((t) => import_chalk4.default.dim(`#${t}`)).join(" ")}`);
   }
@@ -1477,7 +1455,7 @@ function formatResult(bp) {
 
 // src/index.ts
 var program = new import_commander.Command();
-program.name("updose").description("AI coding tool boilerplate marketplace").version("0.3.0");
+program.name("updose").description("AI coding tool boilerplate marketplace").version("0.4.0");
 program.command("add <repo>").description("Install a boilerplate").option("-y, --yes", "Skip all prompts and use defaults").option("--dry-run", "Preview install without writing files").action(addCommand);
 program.command("search [query]").description("Search for boilerplates").option("--target <target>", "Filter by target (claude, codex, gemini)").option("--tag <tag>", "Filter by tag").option("--author <author>", "Filter by author").action(searchCommand);
 program.command("init").description("Scaffold a new boilerplate repository").option("--dir <dir>", "Create boilerplate in a subdirectory").action(initCommand);

package/dist/index.js

@@ -3,6 +3,9 @@
 // src/index.ts
 import { Command } from "commander";
 
+// src/commands/add.ts
+import { createHash } from "crypto";
+
 // src/constants.ts
 var USER_AGENT = "updose-cli";
 var MANIFEST_FILENAME = "updose.json";
@@ -29,14 +32,18 @@ async function searchBoilerplates(query, filters) {
   }
   return await res.json();
 }
-async function recordDownload(repo, dir) {
+async function recordDownload(repo, dir, projectHash) {
   await fetch(`${API_BASE_URL}/download`, {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
       "User-Agent": USER_AGENT
     },
-    body: JSON.stringify({ repo, dir: dir ?? null }),
+    body: JSON.stringify({
+      repo,
+      dir: dir ?? null,
+      ...projectHash ? { project_hash: projectHash } : {}
+    }),
     signal: AbortSignal.timeout(FETCH_TIMEOUT_MS)
   });
 }
@@ -335,35 +342,10 @@ function handleHttpError(res) {
     );
   }
 }
-var branchCache = /* @__PURE__ */ new Map();
-async function getDefaultBranch(repo) {
-  const cached = branchCache.get(repo);
-  if (cached) return cached;
-  const { owner, name } = parseRepo(repo);
-  const res = await fetch(`${GITHUB_API_URL}/repos/${owner}/${name}`, {
-    headers: {
-      Accept: GITHUB_ACCEPT_HEADER,
-      "User-Agent": USER_AGENT,
-      ...getAuthHeaders()
-    },
-    signal: createSignal()
-  });
-  if (res.status === 404) {
-    throw new Error(`Repository not found: ${repo}`);
-  }
-  handleHttpError(res);
-  if (!res.ok) {
-    throw new Error(`GitHub API error: ${res.status} ${res.statusText}`);
-  }
-  const data = await res.json();
-  branchCache.set(repo, data.default_branch);
-  return data.default_branch;
-}
 async function fetchFile(repo, path) {
   const { owner, name } = parseRepo(repo);
-  const branch = await getDefaultBranch(repo);
   const encodedPath = path.split("/").map((segment) => encodeURIComponent(segment)).join("/");
-  const url = `${GITHUB_RAW}/${owner}/${name}/${branch}/${encodedPath}`;
+  const url = `${GITHUB_RAW}/${owner}/${name}/HEAD/${encodedPath}`;
   const res = await fetch(url, {
     headers: { "User-Agent": USER_AGENT, ...getAuthHeaders() },
     signal: createSignal()
@@ -395,8 +377,7 @@ async function fetchManifest(repo, dir) {
 }
 async function fetchRepoTree(repo) {
   const { owner, name } = parseRepo(repo);
-  const branch = await getDefaultBranch(repo);
-  const url = `${GITHUB_API_URL}/repos/${owner}/${name}/git/trees/${branch}?recursive=1`;
+  const url = `${GITHUB_API_URL}/repos/${owner}/${name}/git/trees/HEAD?recursive=1`;
   const res = await fetch(url, {
     headers: {
       Accept: GITHUB_ACCEPT_HEADER,
@@ -787,7 +768,8 @@ async function addCommand(repoInput, options) {
     const summary = skillsInstalled > 0 ? `${installed} file(s) + ${skillsInstalled} skill(s)` : `${installed} file(s)`;
     success(`Done! ${summary} installed, ${skipped} skipped.`);
     if (installed + skillsInstalled > 0) {
-      await recordDownload(repo, dir).catch(() => {
+      const projectHash = createHash("sha256").update(cwd).digest("hex");
+      await recordDownload(repo, dir, projectHash).catch(() => {
       });
     }
   } catch (err) {
@@ -1405,29 +1387,26 @@ function detectRepo(cwd) {
 import chalk4 from "chalk";
 async function searchCommand(query, options) {
   try {
-    if (!query && !options.target && !options.tag && !options.author) {
-      error(
-        "Please provide a search query or at least one filter (--target, --tag, --author)."
-      );
-      process.exitCode = 1;
-      return;
-    }
     const filters = {};
     if (options.target) filters.target = options.target;
     if (options.tag) filters.tag = options.tag;
     if (options.author) filters.author = options.author;
-    const results = await searchBoilerplates(query, filters);
-    const label = query ? `"${query}"` : "the given filters";
-    if (results.length === 0) {
+    const hasParams = !!(query || filters.target || filters.tag || filters.author);
+    const label = query ? `"${query}"` : hasParams ? "the given filters" : "popular boilerplates";
+    const response = await searchBoilerplates(query, filters);
+    if (response.data.length === 0) {
       info(`No boilerplates found for ${label}`);
       return;
     }
     console.log();
-    info(`Found ${results.length} result(s) for ${label}:
+    info(`Found ${response.total} result(s) for ${label}:
 `);
-    for (const bp of results) {
+    for (const bp of response.data) {
       formatResult(bp);
     }
+    console.log(
+      chalk4.dim(`  Browse more results and details at https://updose.dev/`)
+    );
   } catch (err) {
     error(
       err instanceof Error ? err.message : "An unexpected error occurred during search."
@@ -1441,10 +1420,9 @@ function formatResult(bp) {
   if (bp.description) {
     console.log(`    ${bp.description}`);
   }
-  const rating = bp.avg_rating > 0 ? `${chalk4.yellow("\u2605")} ${bp.avg_rating}${bp.rating_count > 0 ? chalk4.dim(` (${bp.rating_count})`) : ""}` : chalk4.dim("\u2605 -");
   const downloads = `${chalk4.green("\u2193")} ${bp.downloads.toLocaleString()}`;
   const targets = chalk4.cyan(bp.targets.join(", "));
-  console.log(`    ${rating}  ${downloads}  ${targets}`);
+  console.log(`    ${downloads}  ${targets}`);
   if (bp.tags.length > 0) {
     console.log(`    ${bp.tags.map((t) => chalk4.dim(`#${t}`)).join(" ")}`);
   }
@@ -1455,7 +1433,7 @@ function formatResult(bp) {
 
 // src/index.ts
 var program = new Command();
-program.name("updose").description("AI coding tool boilerplate marketplace").version("0.3.0");
+program.name("updose").description("AI coding tool boilerplate marketplace").version("0.4.0");
 program.command("add <repo>").description("Install a boilerplate").option("-y, --yes", "Skip all prompts and use defaults").option("--dry-run", "Preview install without writing files").action(addCommand);
 program.command("search [query]").description("Search for boilerplates").option("--target <target>", "Filter by target (claude, codex, gemini)").option("--tag <tag>", "Filter by tag").option("--author <author>", "Filter by author").action(searchCommand);
 program.command("init").description("Scaffold a new boilerplate repository").option("--dir <dir>", "Create boilerplate in a subdirectory").action(initCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "updose",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "description": "AI coding tool boilerplate marketplace",
   "main": "dist/index.cjs",