@wafflebase/cli 0.3.5 → 0.3.7

package/dist/schema/registry.js

@@ -38,33 +38,40 @@ const registry = [
         },
         response: { workspace: 'string' },
     },
+    // Docs (word-processor) namespace
     {
-        name: 'doc.list',
+        name: 'docs.list',
         description: 'List documents in workspace',
         safety: 'read-only',
-        parameters: {},
-        response: { type: 'array', items: { id: 'string', title: 'string', createdAt: 'string' } },
+        parameters: {
+            '--type': { type: 'string', required: false, description: 'Filter by document type (doc|sheet)' },
+        },
+        response: { type: 'array', items: { id: 'string', title: 'string', type: 'string', createdAt: 'string' } },
+        aliases: ['doc.list', 'document.list', 'documents.list'],
     },
     {
-        name: 'doc.create',
+        name: 'docs.create',
         description: 'Create a new document',
         safety: 'write',
         parameters: {
             title: { type: 'string', required: true, description: 'Document title' },
+            '--type': { type: 'string', required: false, description: 'Document type (doc|sheet)', default: 'sheet' },
         },
-        response: { id: 'string', title: 'string' },
+        response: { id: 'string', title: 'string', type: 'string' },
+        aliases: ['doc.create', 'document.create', 'documents.create'],
     },
     {
-        name: 'doc.get',
+        name: 'docs.get',
         description: 'Show document metadata',
         safety: 'read-only',
         parameters: {
             'doc-id': { type: 'string', required: true, description: 'Document ID' },
         },
-        response: { id: 'string', title: 'string', createdAt: 'string' },
+        response: { id: 'string', title: 'string', type: 'string', createdAt: 'string' },
+        aliases: ['doc.get', 'document.get', 'documents.get'],
     },
     {
-        name: 'doc.rename',
+        name: 'docs.rename',
         description: 'Rename a document',
         safety: 'write',
         parameters: {
@@ -72,27 +79,81 @@ const registry = [
             title: { type: 'string', required: true, description: 'New title' },
         },
         response: { id: 'string', title: 'string' },
+        aliases: ['doc.rename', 'document.rename', 'documents.rename'],
     },
     {
-        name: 'doc.delete',
+        name: 'docs.delete',
         description: 'Delete a document',
         safety: 'destructive',
         parameters: {
             'doc-id': { type: 'string', required: true, description: 'Document ID' },
         },
         response: { id: 'string' },
+        aliases: ['doc.delete', 'document.delete', 'documents.delete'],
+    },
+    {
+        name: 'docs.content',
+        description: 'Read document content as JSON, Markdown, or plain text',
+        safety: 'read-only',
+        parameters: {
+            'doc-id': { type: 'string', required: true, description: 'Document ID' },
+            '--format': { type: 'string', required: false, description: 'Output format (json|md|text)', default: 'json' },
+            '--pages': { type: 'string', required: false, description: 'Page range (e.g. 1-3,5)' },
+            '--include-header-footer': { type: 'boolean', required: false, description: 'Include header/footer (md/text)', default: 'false' },
+            '--inline-images': { type: 'boolean', required: false, description: 'Inline data: image URLs (md only)', default: 'false' },
+            '--out': { type: 'string', required: false, description: 'Output file (- for stdout)' },
+            '--force': { type: 'boolean', required: false, description: 'Overwrite existing output file', default: 'false' },
+        },
+        response: { type: 'object', description: 'Document JSON, Markdown text, or plaintext per --format' },
+        aliases: ['doc.content', 'document.content', 'documents.content'],
+    },
+    {
+        name: 'docs.export',
+        description: 'Export a document to PDF or DOCX',
+        safety: 'read-only',
+        parameters: {
+            'doc-id': { type: 'string', required: true, description: 'Document ID' },
+            file: { type: 'string', required: true, description: 'Output path or - for stdout' },
+            '--format': { type: 'string', required: false, description: 'Output format (pdf|docx); default from extension' },
+            '--pages': { type: 'string', required: false, description: 'Page range (PDF only)' },
+            '--include-header-footer': { type: 'boolean', required: false, description: 'Include header/footer regions', default: 'true' },
+            '--force': { type: 'boolean', required: false, description: 'Overwrite existing output file', default: 'false' },
+        },
+        response: { type: 'binary', description: 'PDF or DOCX bytes' },
+        aliases: ['doc.export', 'document.export', 'documents.export'],
+    },
+    {
+        name: 'docs.import',
+        description: 'Import a .docx file as a new (or replacement) document',
+        // Default safety is `write` (create new doc); `--replace` flips it
+        // to destructive. Variants spell this out for skill agents.
+        safety: 'write',
+        parameters: {
+            file: { type: 'string', required: true, description: 'Source .docx path or - for stdin' },
+            '--title': { type: 'string', required: false, description: 'Document title (default: file basename)' },
+            '--replace': { type: 'string', required: false, description: 'Existing document ID to replace' },
+            '--yes': { type: 'boolean', required: false, description: 'Skip --replace confirmation', default: 'false' },
+        },
+        response: { id: 'string', title: 'string', replaced: 'boolean' },
+        variants: [
+            { when: 'default', safety: 'write', creates: 'new document' },
+            { when: '--replace given', safety: 'destructive', modifies: 'existing document content' },
+        ],
+        aliases: ['doc.import', 'document.import', 'documents.import'],
     },
+    // Sheets namespace — canonical names live under sheets.*
     {
-        name: 'tab.list',
-        description: 'List tabs in a document',
+        name: 'sheets.tabs.list',
+        description: 'List tabs in a spreadsheet document',
         safety: 'read-only',
         parameters: {
             'doc-id': { type: 'string', required: true, description: 'Document ID' },
         },
         response: { type: 'array', items: { id: 'string', name: 'string', type: 'string' } },
+        aliases: ['tab.list', 'tabs.list', 'sheet.tabs.list', 'sheet.tab.list', 'sheets.tab.list'],
     },
     {
-        name: 'cell.get',
+        name: 'sheets.cells.get',
         description: 'Get cells from a spreadsheet tab',
         safety: 'read-only',
         parameters: {
@@ -104,9 +165,10 @@ const registry = [
             type: 'array',
             items: { ref: 'string', value: 'string | null', formula: 'string | null', style: 'object | null' },
         },
+        aliases: ['cell.get', 'cells.get', 'sheet.cells.get', 'sheet.cell.get', 'sheets.cell.get'],
     },
     {
-        name: 'cell.set',
+        name: 'sheets.cells.set',
         description: 'Set a single cell value',
         safety: 'write',
         parameters: {
@@ -116,9 +178,10 @@ const registry = [
             '--tab': { type: 'string', required: false, description: 'Tab ID', default: 'tab-1' },
         },
         response: { ref: 'string', value: 'string', formula: 'string | null' },
+        aliases: ['cell.set', 'cells.set', 'sheet.cells.set', 'sheet.cell.set', 'sheets.cell.set'],
     },
     {
-        name: 'cell.batch',
+        name: 'sheets.cells.batch',
         description: 'Batch update cells',
         safety: 'write',
         parameters: {
@@ -127,9 +190,10 @@ const registry = [
             '--data': { type: 'string', required: false, description: 'JSON data (or pipe from stdin)' },
         },
         response: { updated: 'number' },
+        aliases: ['cell.batch', 'cells.batch', 'sheet.cells.batch', 'sheet.cell.batch', 'sheets.cell.batch'],
     },
     {
-        name: 'cell.delete',
+        name: 'sheets.cells.delete',
         description: 'Delete a single cell',
         safety: 'destructive',
         parameters: {
@@ -138,10 +202,11 @@ const registry = [
             '--tab': { type: 'string', required: false, description: 'Tab ID', default: 'tab-1' },
         },
         response: { ref: 'string', deleted: 'boolean' },
+        aliases: ['cell.delete', 'cells.delete', 'sheet.cells.delete', 'sheet.cell.delete', 'sheets.cell.delete'],
     },
     {
-        name: 'import',
-        description: 'Import CSV/JSON into a tab',
+        name: 'sheets.import',
+        description: 'Import CSV/JSON into a spreadsheet tab',
         safety: 'write',
         parameters: {
             'doc-id': { type: 'string', required: true, description: 'Document ID' },
@@ -151,10 +216,11 @@ const registry = [
             '--start': { type: 'string', required: false, description: 'Top-left cell', default: 'A1' },
         },
         response: { imported: 'number' },
+        aliases: ['import', 'sheet.import'],
     },
     {
-        name: 'export',
-        description: 'Export tab data to CSV/JSON',
+        name: 'sheets.export',
+        description: 'Export spreadsheet tab data to CSV/JSON',
         safety: 'read-only',
         parameters: {
             'doc-id': { type: 'string', required: true, description: 'Document ID' },
@@ -164,35 +230,49 @@ const registry = [
             '--file-format': { type: 'string', required: false, description: 'File format (csv, json)' },
         },
         response: { type: 'string', description: 'Formatted cell data' },
+        aliases: ['export', 'sheet.export'],
     },
+    // API keys namespace
     {
-        name: 'api-key.create',
+        name: 'api-keys.create',
         description: 'Create a new API key',
         safety: 'write',
         parameters: {
             name: { type: 'string', required: true, description: 'Key name' },
         },
         response: { id: 'string', name: 'string', prefix: 'string', key: 'string' },
+        aliases: ['api-key.create'],
     },
     {
-        name: 'api-key.list',
+        name: 'api-keys.list',
         description: 'List API keys in workspace',
         safety: 'read-only',
         parameters: {},
         response: { type: 'array', items: { id: 'string', name: 'string', prefix: 'string' } },
+        aliases: ['api-key.list'],
     },
     {
-        name: 'api-key.revoke',
+        name: 'api-keys.revoke',
         description: 'Revoke an API key',
         safety: 'destructive',
         parameters: {
             'key-id': { type: 'string', required: true, description: 'API key ID' },
         },
         response: { id: 'string' },
+        aliases: ['api-key.revoke'],
     },
 ];
+/**
+ * Look up a schema entry by canonical name or any registered alias.
+ * Aliases let scripts and skills written against the v0.3.x singular
+ * names (`cell.get`, `doc.list`, `import`) keep working after the
+ * v0.3.7 namespace shuffle.
+ */
 export function getCommandSchema(name) {
-    return registry.find((c) => c.name === name);
+    const direct = registry.find((c) => c.name === name);
+    if (direct)
+        return direct;
+    return registry.find((c) => c.aliases?.includes(name));
 }
 export function getAllCommandSchemas() {
     return registry;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wafflebase/cli",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "description": "CLI for Wafflebase spreadsheet API",
   "license": "Apache-2.0",
   "type": "module",
@@ -14,11 +14,16 @@
     "dist"
   ],
   "dependencies": {
+    "@xmldom/xmldom": "^0.9.10",
     "commander": "^13.0.0",
+    "fontkit": "^2.0.4",
     "open": "^11.0.0",
-    "yaml": "^2.0.0"
+    "pdf-lib": "^1.17.1",
+    "yaml": "^2.0.0",
+    "@wafflebase/docs": "0.3.7"
   },
   "devDependencies": {
+    "@types/fontkit": "^2.0.0",
     "@types/node": "^25.4.0",
     "@vitest/coverage-v8": "3.1.1",
     "eslint": "^9.18.0",

package/dist/commands/api-key.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerApiKeyCommand(program: Command): void;

package/dist/commands/cell.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerCellCommand(program: Command): void;

package/dist/commands/document.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerDocumentCommand(program: Command): void;

package/dist/commands/document.js

@@ -1,93 +0,0 @@
-import { getGlobalOpts, getClient, getConfig } from './root.js';
-import { output, outputError } from '../output/formatter.js';
-import { printDryRun } from '../client/dry-run.js';
-export function registerDocumentCommand(program) {
-    const doc = program.command('document').alias('doc').description('Manage documents');
-    doc
-        .command('list')
-        .description('List documents in workspace')
-        .action(async function () {
-        const opts = getGlobalOpts(this);
-        try {
-            const res = await getClient(opts).listDocuments();
-            if (!res.ok)
-                throw new Error(`HTTP ${res.status}`);
-            output(res.data, opts.format, opts.quiet);
-        }
-        catch (e) {
-            outputError(e, opts.quiet);
-        }
-    });
-    doc
-        .command('create <title>')
-        .description('Create a new document')
-        .action(async function (title) {
-        const opts = getGlobalOpts(this);
-        if (opts.dryRun) {
-            printDryRun(getConfig(opts), 'POST', '/documents', { title });
-            return;
-        }
-        try {
-            const res = await getClient(opts).createDocument(title);
-            if (!res.ok)
-                throw new Error(`HTTP ${res.status}`);
-            output(res.data, opts.format, opts.quiet);
-        }
-        catch (e) {
-            outputError(e, opts.quiet);
-        }
-    });
-    doc
-        .command('get <doc-id>')
-        .description('Show document metadata')
-        .action(async function (docId) {
-        const opts = getGlobalOpts(this);
-        try {
-            const res = await getClient(opts).getDocument(docId);
-            if (!res.ok)
-                throw new Error(`HTTP ${res.status}`);
-            output(res.data, opts.format, opts.quiet);
-        }
-        catch (e) {
-            outputError(e, opts.quiet);
-        }
-    });
-    doc
-        .command('rename <doc-id> <title>')
-        .description('Rename a document')
-        .action(async function (docId, title) {
-        const opts = getGlobalOpts(this);
-        if (opts.dryRun) {
-            printDryRun(getConfig(opts), 'PATCH', `/documents/${docId}`, { title });
-            return;
-        }
-        try {
-            const res = await getClient(opts).updateDocument(docId, title);
-            if (!res.ok)
-                throw new Error(`HTTP ${res.status}`);
-            output(res.data, opts.format, opts.quiet);
-        }
-        catch (e) {
-            outputError(e, opts.quiet);
-        }
-    });
-    doc
-        .command('delete <doc-id>')
-        .description('Delete a document')
-        .action(async function (docId) {
-        const opts = getGlobalOpts(this);
-        if (opts.dryRun) {
-            printDryRun(getConfig(opts), 'DELETE', `/documents/${docId}`);
-            return;
-        }
-        try {
-            const res = await getClient(opts).deleteDocument(docId);
-            if (!res.ok)
-                throw new Error(`HTTP ${res.status}`);
-            output(res.data, opts.format, opts.quiet);
-        }
-        catch (e) {
-            outputError(e, opts.quiet);
-        }
-    });
-}

package/dist/commands/export.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerExportCommand(program: Command): void;

package/dist/commands/import.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerImportCommand(program: Command): void;

package/dist/commands/tab.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerTabCommand(program: Command): void;