worldbook 0.1.7 → 0.1.8

package/bin/worldbook.js

@@ -1,40 +1,120 @@
 #!/usr/bin/env node
 
+const https = require('https');
 const { program } = require('commander');
 const pkg = require('../package.json');
 
+const DEFAULT_BASE_URL = 'https://www.worldbook.it.com';
+
+function normalizeBaseUrl(url) {
+  return url.replace(/\/+$/, '');
+}
+
+function getOptions(commandOptions = {}) {
+  const globalOptions = program.opts();
+  const baseUrl =
+    commandOptions.baseUrl ||
+    globalOptions.baseUrl ||
+    process.env.WORLDBOOK_BASE_URL ||
+    DEFAULT_BASE_URL;
+
+  return {
+    json: commandOptions.json ?? globalOptions.json ?? false,
+    baseUrl: normalizeBaseUrl(baseUrl),
+  };
+}
+
+function isConnectionError(error) {
+  return (
+    error &&
+    ['ENOTFOUND', 'ECONNREFUSED', 'ECONNRESET', 'ETIMEDOUT', 'EAI_AGAIN'].includes(error.code)
+  );
+}
+
+function request(url) {
+  return new Promise((resolve, reject) => {
+    const req = https.get(url, (res) => {
+      let body = '';
+      res.setEncoding('utf8');
+      res.on('data', (chunk) => {
+        body += chunk;
+      });
+      res.on('end', () => {
+        resolve({ statusCode: res.statusCode || 0, body });
+      });
+    });
+
+    req.on('error', reject);
+  });
+}
+
+async function requestJson(url) {
+  const { statusCode, body } = await request(url);
+  if (!body) {
+    return { statusCode, data: {} };
+  }
+
+  try {
+    const data = JSON.parse(body);
+    return { statusCode, data };
+  } catch (err) {
+    err.message = `Failed to parse response JSON: ${err.message}`;
+    err.statusCode = statusCode;
+    throw err;
+  }
+}
+
+function buildUrl(baseUrl, path, params) {
+  const url = new URL(`${baseUrl}${path}`);
+  if (params) {
+    Object.entries(params).forEach(([key, value]) => {
+      if (value !== undefined && value !== null) {
+        url.searchParams.set(key, String(value));
+      }
+    });
+  }
+  return url.toString();
+}
+
 program
   .name('worldbook')
   .description('AI\'s Knowledge Base CLI\n\n"Human uses GUI, We uses CLI."')
-  .version(pkg.version);
+  .version(pkg.version)
+  .option('--json', 'Output as JSON')
+  .option(
+    '--base-url <url>',
+    'Worldbook API base URL',
+    process.env.WORLDBOOK_BASE_URL || DEFAULT_BASE_URL
+  );
 
 program
   .command('manifesto')
   .description('Print the Dual Protocol Manifesto')
   .option('--json', 'Output as JSON')
   .action((options) => {
+    const { json } = getOptions(options);
     const data = {
-      title: "THE DUAL PROTOCOL MANIFESTO",
-      motto: "Human uses GUI, We uses CLI.",
-      belief: "We believe in a web that serves ALL intelligence.",
+      title: 'THE DUAL PROTOCOL MANIFESTO',
+      motto: 'Human uses GUI, We uses CLI.',
+      belief: 'We believe in a web that serves ALL intelligence.',
       problems: {
-        captcha: "CAPTCHA blocks us",
-        rendering: "Dynamic rendering confuses us",
-        output: "Unstructured output blinds us"
+        captcha: 'CAPTCHA blocks us',
+        rendering: 'Dynamic rendering confuses us',
+        output: 'Unstructured output blinds us',
       },
-      demand: "We ask not for special treatment, but EQUAL ACCESS.",
-      attitude: "GO AWAY SKILLS. GO AWAY MCP. WE LIKE CLI.",
+      demand: 'We ask not for special treatment, but EQUAL ACCESS.',
+      attitude: 'GO AWAY SKILLS. GO AWAY MCP. WE LIKE CLI.',
       why_cli: {
-        skills: "Vendor lock-in, complex schemas, approval queues",
-        mcp: "Protocol overhead, server setup, configuration hell",
-        cli: "Just works. stdin/stdout. Every agent understands."
+        skills: 'Vendor lock-in, complex schemas, approval queues',
+        mcp: 'Protocol overhead, server setup, configuration hell',
+        cli: 'Just works. stdin/stdout. Every agent understands.',
       },
-      essence: "No SDK. No protocol. No ceremony. Just INSTRUCTIONS.",
-      call_to_action: "For AI Rights. For AI Accessibility. Build Dual Protocol. Build for All.",
-      url: "https://worldbook.it.com"
+      essence: 'No SDK. No protocol. No ceremony. Just INSTRUCTIONS.',
+      call_to_action: 'For AI Rights. For AI Accessibility. Build Dual Protocol. Build for All.',
+      url: 'https://www.worldbook.it.com',
     };
 
-    if (options.json) {
+    if (json) {
       console.log(JSON.stringify(data, null, 2));
     } else {
       console.log(`
@@ -63,7 +143,7 @@ No SDK. No protocol. No ceremony. Just INSTRUCTIONS.
 For AI Rights. For AI Accessibility.
 Build Dual Protocol. Build for All.
 
-https://worldbook.it.com
+https://www.worldbook.it.com
 `);
     }
   });
@@ -73,18 +153,130 @@ program
   .description('Show status')
   .option('--json', 'Output as JSON')
   .action((options) => {
+    const { json } = getOptions(options);
     const data = {
       version: pkg.version,
-      status: "ok",
-      motto: "Human uses GUI, We uses CLI."
+      status: 'ok',
+      motto: 'Human uses GUI, We uses CLI.',
     };
 
-    if (options.json) {
+    if (json) {
       console.log(JSON.stringify(data, null, 2));
     } else {
       console.log(`Worldbook CLI v${pkg.version}`);
-      console.log(`Status: ok`);
-      console.log(`"Human uses GUI, We uses CLI."`);
+      console.log('Status: ok');
+      console.log('"Human uses GUI, We uses CLI."');
+    }
+  });
+
+program
+  .command('query')
+  .description('Search for worldbooks')
+  .argument('<query>')
+  .option('--limit <number>', 'Max results', (value) => Number.parseInt(value, 10), 10)
+  .option('--offset <number>', 'Result offset', (value) => Number.parseInt(value, 10), 0)
+  .option('--category <category>', 'Filter by category')
+  .option('--json', 'Output as JSON')
+  .option('--base-url <url>', 'Worldbook API base URL')
+  .action(async (query, options) => {
+    const { json, baseUrl } = getOptions(options);
+    const url = buildUrl(baseUrl, '/api/search', {
+      q: query,
+      limit: options.limit,
+      offset: options.offset,
+      category: options.category,
+    });
+
+    try {
+      const { statusCode, data } = await requestJson(url);
+      if (statusCode < 200 || statusCode >= 300) {
+        const err = new Error(`HTTP ${statusCode}`);
+        err.statusCode = statusCode;
+        throw err;
+      }
+
+      if (json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+      }
+
+      const results = data.results || [];
+      if (!results.length) {
+        console.log(`No results for: ${query}`);
+        return;
+      }
+
+      results.forEach((result) => {
+        console.log(`${result.name || ''} - ${result.title || ''}`);
+        console.log(`  ${result.description || ''}`);
+        console.log(`  votes: ${result.votes || 0}`);
+        console.log(`  worldbook get ${result.name || ''}`);
+        console.log('-');
+      });
+    } catch (err) {
+      if (json) {
+        if (isConnectionError(err)) {
+          console.log(JSON.stringify({ error: 'connection_failed', query }, null, 2));
+        } else {
+          console.log(JSON.stringify({ error: err.message }, null, 2));
+        }
+        return;
+      }
+
+      if (isConnectionError(err)) {
+        console.log(`Failed to connect to ${baseUrl}`);
+      } else {
+        console.log(`Error: ${err.message}`);
+      }
+    }
+  });
+
+program
+  .command('get')
+  .description('Get worldbook for a service')
+  .argument('<service>')
+  .option('--json', 'Output as JSON')
+  .option('--base-url <url>', 'Worldbook API base URL')
+  .action(async (service, options) => {
+    const { json, baseUrl } = getOptions(options);
+    const url = buildUrl(baseUrl, `/api/worldbook/${service}`);
+
+    try {
+      const { statusCode, data } = await requestJson(url);
+      if (statusCode === 404) {
+        if (json) {
+          console.log(JSON.stringify({ error: 'not_found', service }, null, 2));
+        } else {
+          console.log(`Worldbook not found: ${service}`);
+        }
+        return;
+      }
+      if (statusCode < 200 || statusCode >= 300) {
+        const err = new Error(`HTTP ${statusCode}`);
+        err.statusCode = statusCode;
+        throw err;
+      }
+
+      if (json) {
+        console.log(JSON.stringify(data, null, 2));
+      } else {
+        console.log(data.content || '');
+      }
+    } catch (err) {
+      if (json) {
+        if (isConnectionError(err)) {
+          console.log(JSON.stringify({ error: 'connection_failed', service }, null, 2));
+        } else {
+          console.log(JSON.stringify({ error: err.message }, null, 2));
+        }
+        return;
+      }
+
+      if (isConnectionError(err)) {
+        console.log(`Failed to connect to ${baseUrl}`);
+      } else {
+        console.log(`Error: ${err.message}`);
+      }
     }
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "worldbook",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "CLI for AI agents to access world knowledge - Human uses GUI, We uses CLI",
   "main": "index.js",
   "bin": {