tokrepo 3.3.0 → 3.3.1

package/bin/tokrepo.js

@@ -517,7 +517,7 @@ async function cmdPush() {
   // Flags override config
   title = args.flags.title || title || guessTitle(filesToPush, baseDir);
   description = args.flags.desc || description || '';
-  visibility = args.flags.public ? 1 : (args.flags.private ? 0 : (projectConfig?.visibility ?? 1));
+  visibility = args.flags.public ? 1 : (args.flags.private ? 0 : (projectConfig?.visibility ?? 0));
   tags = args.flags.tags || tags || [];
 
   // Read files and detect types
@@ -553,8 +553,8 @@ async function cmdPush() {
   // Show summary
   log(`\n${C.bold}tokrepo push${C.reset}\n`);
   log(`  ${C.bold}Title:${C.reset}      ${title}`);
-  log(`  ${C.bold}Visibility:${C.reset} ${visibility === 1 ? `${C.green}public${C.reset}` : `${C.yellow}private${C.reset}`}`);
-  log(`  ${C.bold}Files:${C.reset}      ${pushFiles.length}`);
+  log(`  ${C.bold}Visibility:${C.reset} ${visibility === 1 ? `${C.green}public${C.reset} (visible to everyone)` : `${C.yellow}private${C.reset} (only you can see)`}`);
+  log(`  ${C.bold}Files:${C.reset}      ${pushFiles.length} (only these files will be uploaded)`);
   if (detectedTags.size > 0) {
     log(`  ${C.bold}Tags:${C.reset}       ${Array.from(detectedTags).join(', ')}`);
   }
@@ -614,7 +614,7 @@ async function cmdInit() {
     title: title || dirName,
     description: description || '',
     files: ['*.md', '*.sh', '*.py', '*.js', '*.mjs', '*.ts', '*.json', '*.yaml'],
-    visibility: 1,
+    visibility: 0,
     tags: [],
   };
 
@@ -663,6 +663,11 @@ async function cmdPull() {
   }
 }
 
+// Normalize query: replace hyphens/underscores/dots with spaces for better matching
+function normalizeQuery(q) {
+  return q.replace(/[-_.]/g, ' ').replace(/\s+/g, ' ').trim();
+}
+
 // Resolve various input formats to a UUID:
 //   - UUID directly: "ca000374-f5d8-..."
 //   - Full URL: "https://tokrepo.com/en/workflows/ca000374-f5d8-..."
@@ -680,9 +685,10 @@ async function resolveAssetId(input, config, apiBase) {
   const atMatch = input.match(/^@([^/]+)\/(.+)$/);
   if (atMatch) {
     const [, username, assetName] = atMatch;
-    info(`Searching for "${assetName}" by @${username}...`);
+    const normalizedName = normalizeQuery(assetName);
+    info(`Searching for "${normalizedName}" by @${username}...`);
     // Search by keyword, then filter by author nickname
-    const encoded = encodeURIComponent(assetName);
+    const encoded = encodeURIComponent(normalizedName);
     try {
       const data = await apiRequest('GET', `/api/v1/tokenboard/workflows/list?keyword=${encoded}&page=1&page_size=20&sort_by=views`, null, config?.token, apiBase);
       const items = data.list || data.items || [];
@@ -700,9 +706,10 @@ async function resolveAssetId(input, config, apiBase) {
     error(`Asset not found: ${input}`);
   }
 
-  // Plain name: search by keyword
-  info(`Searching for "${input}"...`);
-  const encoded = encodeURIComponent(input);
+  // Plain name: search by keyword (normalize separators)
+  const normalizedInput = normalizeQuery(input);
+  info(`Searching for "${normalizedInput}"...`);
+  const encoded = encodeURIComponent(normalizedInput);
   try {
     const data = await apiRequest('GET', `/api/v1/tokenboard/workflows/list?keyword=${encoded}&page=1&page_size=5&sort_by=views`, null, config?.token, apiBase);
     const items = data.list || data.items || [];
@@ -714,10 +721,12 @@ async function resolveAssetId(input, config, apiBase) {
 // ─── Search ───
 
 async function cmdSearch() {
-  const query = process.argv.slice(3).join(' ');
-  if (!query) error('Usage: tokrepo search <keyword>');
+  const rawQuery = process.argv.slice(3).join(' ');
+  if (!rawQuery) error('Usage: tokrepo search <keyword>');
 
-  log(`\n${C.bold}tokrepo search${C.reset} "${query}"\n`);
+  const query = normalizeQuery(rawQuery);
+  const displayQuery = query !== rawQuery ? `"${rawQuery}" → "${query}"` : `"${query}"`;
+  log(`\n${C.bold}tokrepo search${C.reset} ${displayQuery}\n`);
 
   const config = readConfig();
   const apiBase = config?.api || DEFAULT_API;
@@ -728,7 +737,14 @@ async function cmdSearch() {
 
     if (!data.list || data.list.length === 0) {
       info('No assets found.');
-      log(`\n  ${C.dim}Try different keywords or browse: https://tokrepo.com/en/featured${C.reset}\n`);
+      // Suggest broader search terms
+      const words = query.split(' ');
+      if (words.length > 1) {
+        log(`\n  ${C.dim}Try fewer keywords:${C.reset}`);
+        log(`  ${C.cyan}tokrepo search ${words[0]}${C.reset}`);
+        log(`  ${C.cyan}tokrepo search ${words.slice(0, 2).join(' ')}${C.reset}`);
+      }
+      log(`\n  ${C.dim}Browse all: https://tokrepo.com/en/featured${C.reset}\n`);
       return;
     }
 
@@ -739,8 +755,13 @@ async function cmdSearch() {
       const tags = (wf.tags || []).map(t => t.name).join(', ');
       const views = wf.view_count || 0;
       const votes = wf.vote_count || 0;
+      // Truncate long descriptions for readability
+      const desc = (wf.description || '').length > 80
+        ? wf.description.substring(0, 77) + '...'
+        : (wf.description || '');
 
       log(`  ${C.dim}${String(i + 1).padStart(2)}.${C.reset} ${C.bold}${wf.title}${C.reset}`);
+      if (desc) log(`      ${desc}`);
       if (tags) log(`      ${C.cyan}${tags}${C.reset}  ${C.dim}★${votes} 👁${views}${C.reset}`);
       log(`      ${C.dim}tokrepo install ${wf.uuid}${C.reset}`);
       log('');
@@ -778,18 +799,23 @@ Examples:
   }
   // UUID format check
   else if (!/^[a-f0-9-]{36}$/.test(target)) {
-    // Search by name
-    info(`Searching for "${target}"...`);
+    // Search by name (normalize separators for better matching)
+    const normalizedTarget = normalizeQuery(target);
+    info(`Searching for "${normalizedTarget}"...`);
     try {
-      const encoded = encodeURIComponent(target);
+      const encoded = encodeURIComponent(normalizedTarget);
       const searchData = await apiRequest('GET', `/api/v1/tokenboard/workflows/list?keyword=${encoded}&page=1&page_size=5&sort_by=views`, null, config?.token, apiBase);
 
       if (!searchData.list || searchData.list.length === 0) {
         error(`No asset found matching "${target}". Try: tokrepo search ${target}`);
       }
 
-      // If exact title match, use it directly
-      const exact = searchData.list.find(w => w.title.toLowerCase().includes(target.toLowerCase()));
+      // If title contains all query words, prefer it
+      const queryWords = normalizedTarget.toLowerCase().split(' ');
+      const exact = searchData.list.find(w => {
+        const title = w.title.toLowerCase();
+        return queryWords.every(word => title.includes(word));
+      });
       const chosen = exact || searchData.list[0];
 
       uuid = chosen.uuid;
@@ -1241,10 +1267,14 @@ function showHelp() {
   log(`
 ${C.bold}tokrepo${C.reset} — AI assets for humans and agents. Like GitHub, for AI experience.
 
+  ${C.dim}You control what gets pushed. Each push uploads only the files you specify.
+  Nothing is shared without your explicit action. Private by default.${C.reset}
+
 ${C.bold}QUICK START${C.reset}
   ${C.cyan}tokrepo search cursor rules${C.reset}             # find assets
   ${C.cyan}tokrepo install awesome-cursor-rules${C.reset}    # install to your project
-  ${C.cyan}tokrepo push --public .${C.reset}                 # share your own assets
+  ${C.cyan}tokrepo push --private my-skill.md${C.reset}      # save privately (only you can see)
+  ${C.cyan}tokrepo push --public my-skill.md${C.reset}       # share publicly
 
 ${C.bold}USAGE${C.reset}
   tokrepo <command> [args] [options]
@@ -1270,8 +1300,8 @@ ${C.bold}ACCOUNT${C.reset}
   ${C.cyan}help${C.reset}                Show this help
 
 ${C.bold}PUSH OPTIONS${C.reset}
-  ${C.cyan}--public${C.reset}            Make asset publicly visible (default)
-  ${C.cyan}--private${C.reset}           Make asset private
+  ${C.cyan}--private${C.reset}           Keep asset private — only you can see it (recommended for personal assets)
+  ${C.cyan}--public${C.reset}            Share asset publicly with the community
   ${C.cyan}--title${C.reset} "..."       Set title (auto-detected from README or dir name)
   ${C.cyan}--desc${C.reset} "..."        Set description
   ${C.cyan}--tag${C.reset} Skills        Add tag (repeatable)
@@ -1286,8 +1316,10 @@ ${C.bold}INSTALL BEHAVIOR${C.reset}
 ${C.bold}EXAMPLES${C.reset}
   tokrepo search "mcp server"                 # Find MCP configs
   tokrepo install ca000374-f5d8-...           # Install by UUID
-  tokrepo push --public .                     # Push current directory
-  tokrepo push --public --title "My MCP" .    # Push with custom title
+  tokrepo push --private my-rules.md          # Save one file privately
+  tokrepo push --public skill.md              # Share one file publicly
+  tokrepo push --private .                    # Push current dir as private
+  tokrepo push --public --title "My MCP" .    # Push dir publicly with title
 
 ${C.bold}FILE TYPE AUTO-DETECTION${C.reset}
   .sh .py .js .ts .mjs .go .rs  →  script

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokrepo",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "AI assets for humans and agents — search, install, push. Like GitHub, for AI experience.",
   "bin": {
     "tokrepo": "bin/tokrepo.js"