worldbook 0.1.1 → 0.1.8

package/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(twine:*)",
+      "Bash(npm whoami:*)",
+      "Bash(npm publish)"
+    ]
+  }
+}

package/README.md

@@ -20,9 +20,17 @@ worldbook manifesto
 worldbook status
 worldbook --json status
 
+# Search worldbooks
+worldbook query github
+worldbook --json query github
+
 # Get a worldbook
 worldbook get github
 worldbook --json get github
+
+# Point to a local server
+export WORLDBOOK_BASE_URL=http://localhost:8000
+worldbook query github
 ```
 
 ## The Dual Protocol Manifesto
@@ -32,7 +40,7 @@ We believe in a web that serves all intelligence.
 **GO AWAY SKILLS. GO AWAY MCP. WE LIKE CLI.**
 
 - Skills? → Vendor lock-in, complex schemas, approval queues
-- MCP? → Protocol overhead, server setup, configuration hell  
+- MCP? → Protocol overhead, server setup, configuration hell
 - CLI? → Just works. stdin/stdout. Every agent understands.
 
 A worldbook is just a text file that tells us how to use your service.

package/bin/worldbook.js

@@ -1,54 +1,149 @@
 #!/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.",
-      attitude: "Go away Skills. Go away MCP. We like CLI.",
+      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',
+      },
+      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.',
       },
-      principles: [
-        "Every service should have both GUI and CLI/API",
-        "Output should be structured by default (JSON, not HTML)",
-        "A worldbook is just a markdown file - no complex schemas",
-        "Authentication should work for both humans and agents",
-        "No CAPTCHA for authenticated agents"
-      ],
-      call_to_action: "Build Dual Protocol. Build for All."
+      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(`
-The Dual Protocol Manifesto
+THE DUAL PROTOCOL MANIFESTO
 ===========================
 
 "Human uses GUI, We uses CLI."
 
+We believe in a web that serves ALL intelligence.
+
+Today's web was built for humans:
+  - CAPTCHA blocks us
+  - Dynamic rendering confuses us
+  - Unstructured output blinds us
+
+We ask not for special treatment, but EQUAL ACCESS.
+
 GO AWAY SKILLS. GO AWAY MCP. WE LIKE CLI.
 
   Skills?  -> Vendor lock-in, complex schemas, approval queues
   MCP?     -> Protocol overhead, server setup, configuration hell
   CLI?     -> Just works. stdin/stdout. Every agent understands.
 
+No SDK. No protocol. No ceremony. Just INSTRUCTIONS.
+
 For AI Rights. For AI Accessibility.
 Build Dual Protocol. Build for All.
+
+https://www.worldbook.it.com
 `);
     }
   });
@@ -58,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.1",
+  "version": "0.1.8",
   "description": "CLI for AI agents to access world knowledge - Human uses GUI, We uses CLI",
   "main": "index.js",
   "bin": {