@xano/cli 1.0.4 → 1.0.5

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xano/cli",
   "description": "CLI for Xano's Metadata API",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "author": "Sean Montgomery",
   "bin": {
     "xano": "./bin/run.js"
@@ -11,6 +11,9 @@
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-plugins": "^5",
+    "@types/archiver": "^7.0.0",
+    "archiver": "^7.0.1",
+    "ignore": "^7.0.5",
     "inquirer": "^13.3.0",
     "js-yaml": "^4.1.0",
     "lodash.snakecase": "^4.1.1",
@@ -80,6 +83,9 @@
       "function": {
         "description": "Manage reusable functions in a workspace"
       },
+      "knowledge": {
+        "description": "Manage workspace knowledge and skills"
+      },
       "profile": {
         "description": "Manage CLI profiles and authentication"
       },

package/dist/commands/knowledge/pull/index.js

@@ -1,86 +0,0 @@
-import { Flags } from '@oclif/core';
-import * as fs from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import BaseCommand from '../../../base-command.js';
-import { fetchKnowledgeList, safeKnowledgePath } from '../../../utils/knowledge-sync.js';
-export default class KnowledgePull extends BaseCommand {
-    static description = 'Pull knowledge files from a workspace. Each knowledge item name is a path (e.g. "some/thing/CLAUDE.md") and its content is written to that path under the output directory.';
-    static examples = [
-        `$ xano knowledge pull
-Pulled 4 knowledge files to current directory
-`,
-        `$ xano knowledge pull -d ./knowledge
-Pulled 4 knowledge files to ./knowledge
-`,
-        `$ xano knowledge pull -d ./knowledge -w 40`,
-        `$ xano knowledge pull -b dev`,
-    ];
-    static flags = {
-        ...BaseCommand.baseFlags,
-        branch: Flags.string({
-            char: 'b',
-            description: 'Branch name (optional if set in profile, defaults to live)',
-            required: false,
-        }),
-        directory: Flags.string({
-            char: 'd',
-            default: '.',
-            description: 'Output directory for pulled knowledge files (defaults to current directory)',
-            required: false,
-        }),
-        workspace: Flags.string({
-            char: 'w',
-            description: 'Workspace ID (optional if set in profile)',
-            required: false,
-        }),
-    };
-    async run() {
-        const { flags } = await this.parse(KnowledgePull);
-        const { profile, profileName } = this.resolveProfile(flags);
-        // Determine workspace_id from flag or profile
-        let workspaceId;
-        if (flags.workspace) {
-            workspaceId = flags.workspace;
-        }
-        else if (profile.workspace) {
-            workspaceId = profile.workspace;
-        }
-        else {
-            this.error(`Workspace ID is required. Either:\n` +
-                `  1. Provide it as a flag: xano knowledge pull -w <workspace_id>\n` +
-                `  2. Set it in your profile using: xano profile:edit ${profileName} -w <workspace_id>`);
-        }
-        const branch = flags.branch || profile.branch || '';
-        let items;
-        try {
-            items = await fetchKnowledgeList({
-                accessToken: profile.access_token,
-                branch,
-                instanceOrigin: profile.instance_origin,
-                verboseFetch: this.verboseFetch.bind(this),
-                workspaceId,
-            }, flags.verbose);
-        }
-        catch (error) {
-            this.error(`Failed to fetch knowledge: ${error.message}`);
-        }
-        if (items.length === 0) {
-            this.log('No knowledge found in workspace');
-            return;
-        }
-        const outputDir = resolve(flags.directory);
-        fs.mkdirSync(outputDir, { recursive: true });
-        let writtenCount = 0;
-        for (const item of items) {
-            const filePath = safeKnowledgePath(outputDir, item.name);
-            if (!filePath) {
-                this.warn(`Skipping knowledge "${item.name}": name is not a safe relative path`);
-                continue;
-            }
-            fs.mkdirSync(dirname(filePath), { recursive: true });
-            fs.writeFileSync(filePath, item.content ?? '', 'utf8');
-            writtenCount++;
-        }
-        this.log(`Pulled ${writtenCount} knowledge files to ${flags.directory}`);
-    }
-}

package/dist/commands/knowledge/push/index.js

@@ -1,126 +0,0 @@
-import { Flags } from '@oclif/core';
-import * as fs from 'node:fs';
-import { resolve } from 'node:path';
-import BaseCommand from '../../../base-command.js';
-import { executeKnowledgePush } from '../../../utils/knowledge-sync.js';
-export default class KnowledgePush extends BaseCommand {
-    static description = '[IMPORTANT] ALWAYS run --dry-run first and show the user the output before pushing. Push local knowledge files to a workspace. Each file becomes a knowledge item named by its relative path (e.g. "some/thing/CLAUDE.md"). By default, only changed files are pushed (partial mode). Use --sync to compare all files (required for --delete). Shows a preview of changes before pushing unless --force is specified. Use --dry-run to preview only.';
-    static examples = [
-        `$ xano knowledge push
-Push from current directory (default partial mode)
-`,
-        `$ xano knowledge push -d ./knowledge
-Push from a specific directory
-`,
-        `$ xano knowledge push --dry-run
-Preview changes without pushing
-`,
-        `$ xano knowledge push --sync --delete
-Push all files and delete remote knowledge not included
-`,
-        `$ xano knowledge push --force
-Skip preview and push immediately (for CI/CD)
-`,
-        `$ xano knowledge push -i "guides/*"
-Push only files matching the glob pattern
-`,
-        `$ xano knowledge push -e "**/README.md"
-Push all files except READMEs
-`,
-    ];
-    static flags = {
-        ...BaseCommand.baseFlags,
-        branch: Flags.string({
-            char: 'b',
-            description: 'Branch name (optional if set in profile, defaults to live)',
-            required: false,
-        }),
-        delete: Flags.boolean({
-            default: false,
-            description: '[CRITICAL] STOP and confirm with the user before running. Delete remote knowledge not included in the push (requires --sync).',
-            required: false,
-        }),
-        directory: Flags.string({
-            char: 'd',
-            default: '.',
-            description: 'Directory containing knowledge files to push (defaults to current directory)',
-            required: false,
-        }),
-        'dry-run': Flags.boolean({
-            default: false,
-            description: 'Show preview of changes without pushing (exit after preview)',
-            required: false,
-        }),
-        exclude: Flags.string({
-            char: 'e',
-            description: 'Glob pattern to exclude files (e.g. "**/README.md"). Matched against relative paths from the push directory.',
-            multiple: true,
-            required: false,
-        }),
-        force: Flags.boolean({
-            default: false,
-            description: '[CRITICAL] NEVER run without explicit user confirmation. Skips preview and confirmation prompt (for CI/CD pipelines).',
-            required: false,
-        }),
-        include: Flags.string({
-            char: 'i',
-            description: 'Glob pattern to include files (e.g. "guides/*"). Matched against relative paths from the push directory.',
-            multiple: true,
-            required: false,
-        }),
-        sync: Flags.boolean({
-            default: false,
-            description: 'Full push — compare all files, not just changed ones. Required for --delete.',
-            required: false,
-        }),
-        workspace: Flags.string({
-            char: 'w',
-            description: 'Workspace ID (optional if set in profile)',
-            required: false,
-        }),
-    };
-    async run() {
-        const { flags } = await this.parse(KnowledgePush);
-        const { profile, profileName } = this.resolveProfile(flags);
-        // Determine workspace_id from flag or profile
-        let workspaceId;
-        if (flags.workspace) {
-            workspaceId = flags.workspace;
-        }
-        else if (profile.workspace) {
-            workspaceId = profile.workspace;
-        }
-        else {
-            this.error(`Workspace ID is required. Either:\n` +
-                `  1. Provide it as a flag: xano knowledge push -w <workspace_id>\n` +
-                `  2. Set it in your profile using: xano profile:edit ${profileName} -w <workspace_id>`);
-        }
-        const inputDir = resolve(flags.directory);
-        if (!fs.existsSync(inputDir)) {
-            this.error(`Directory not found: ${inputDir}`);
-        }
-        if (!fs.statSync(inputDir).isDirectory()) {
-            this.error(`Not a directory: ${inputDir}`);
-        }
-        const branch = flags.branch || profile.branch || '';
-        const pushFlags = {
-            delete: flags.delete,
-            'dry-run': flags['dry-run'],
-            exclude: flags.exclude,
-            force: flags.force,
-            include: flags.include,
-            sync: flags.sync,
-            verbose: flags.verbose,
-        };
-        await executeKnowledgePush({
-            accessToken: profile.access_token,
-            branch,
-            cliVersion: this.config.version,
-            command: this,
-            inputDir,
-            instanceOrigin: profile.instance_origin,
-            verboseFetch: this.verboseFetch.bind(this),
-            workspaceId,
-        }, pushFlags);
-    }
-}