@memberjunction/cli 2.121.0 → 2.122.1

package/README.md

@@ -494,6 +494,7 @@ Available dbdoc commands:
 - `analyze` - Analyze database and generate documentation
 - `generate-queries` - Generate sample SQL queries from existing analysis state
 - `export` - Export documentation in multiple formats (SQL, Markdown, HTML, CSV, Mermaid)
+- `export-sample-queries` - Export sample queries to MemberJunction metadata format
 - `status` - Show analysis status and progress
 - `reset` - Reset analysis state
 
@@ -522,6 +523,19 @@ mj dbdoc generate-queries --from-state ./output/run-1/state.json \
   --queries-per-table 10 \
   --output-dir ./queries
 
+# Export sample queries to MemberJunction metadata format
+mj dbdoc export-sample-queries \
+  --input ./output/sample-queries.json \
+  --output ./metadata/queries/.queries.json
+
+# Export with separate SQL files and category
+mj dbdoc export-sample-queries \
+  --input ./output/sample-queries.json \
+  --output ./metadata/queries/.queries.json \
+  --separate-sql-files \
+  --category "Database Documentation" \
+  --min-confidence 0.8
+
 # Export all formats
 mj dbdoc export --sql --markdown --html --csv --mermaid
 
@@ -561,6 +575,18 @@ mj dbdoc reset --force
 - `--queries-per-table <number>`: Number of queries to generate per table (optional, overrides config)
 - `--max-execution-time <ms>`: Maximum execution time for query validation in milliseconds (optional, overrides config)
 
+**Export Sample Queries Command:**
+- `-i, --input <path>`: Path to sample-queries.json file from generate-queries (required)
+- `-o, --output <path>`: Output path for the .queries.json metadata file (required)
+- `--separate-sql-files`: Write SQL to separate files and use @file: references
+- `--sql-dir <name>`: Directory for SQL files when using --separate-sql-files (default: SQL)
+- `--category <name>`: Category name for @lookup reference (e.g., "Database Documentation")
+- `--status <value>`: Status to assign (Approved/Pending/Rejected/Expired, default: Pending)
+- `--min-confidence <value>`: Minimum confidence threshold to export (0-1, default: 0)
+- `--validated-only`: Only export queries that were successfully validated
+- `--append`: Append to existing metadata file instead of overwriting
+- `--include-primary-key`: Include primaryKey and sync fields (for updating existing records)
+
 **Export Command:**
 - `-s, --state-file <path>`: Path to state JSON file
 - `-o, --output-dir <path>`: Output directory for generated files
@@ -640,11 +666,26 @@ Or generate separately from existing state:
 mj dbdoc generate-queries --from-state ./output/run-1/state.json
 ```
 
+**Export to MemberJunction Metadata:**
+
+Transform generated queries into MemberJunction's Query entity format for use with AI agents like Skip:
+```bash
+mj dbdoc export-sample-queries \
+  --input ./output/sample-queries.json \
+  --output ./metadata/queries/.queries.json \
+  --category "Database Documentation" \
+  --separate-sql-files
+
+# Then sync to database
+mj sync push ./metadata/queries/
+```
+
 **Use Cases:**
 - Training AI agents to generate consistent multi-query patterns
 - Creating reference examples for few-shot prompting
 - Documenting common query patterns for your database
 - Validating that related queries use consistent filtering logic
+- Syncing generated queries to MemberJunction's Query entity for use by Skip
 
 ---
 

package/bin/dev.cmd

@@ -1,3 +1,3 @@
-@echo off
-
+@echo off
+
 node "%~dp0\dev" %*

package/bin/run.cmd

@@ -1,3 +1,3 @@
-@echo off
-
-node "%~dp0\run" %*
+@echo off
+
+node "%~dp0\run" %*

package/dist/commands/dbdoc/export-sample-queries.d.ts

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+export default class DbDocExportSampleQueries extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        input: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        output: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'separate-sql-files': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'sql-dir': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        category: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        status: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'min-confidence': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'validated-only': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        append: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'include-primary-key': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/dbdoc/export-sample-queries.js

@@ -0,0 +1,120 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+class DbDocExportSampleQueries extends core_1.Command {
+    static description = 'Export sample queries to MemberJunction metadata format (delegates to db-auto-doc export-sample-queries)';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --input ./output/sample-queries.json --output ./metadata/queries/.queries.json',
+        '<%= config.bin %> <%= command.id %> --input ./sample-queries.json --output ./metadata/queries/.queries.json --separate-sql-files',
+        '<%= config.bin %> <%= command.id %> --input ./sample-queries.json --output ./queries/.queries.json --category "Database Documentation"',
+        '<%= config.bin %> <%= command.id %> --input ./sample-queries.json --output ./queries/.queries.json --status Pending --min-confidence 0.8',
+    ];
+    static flags = {
+        input: core_1.Flags.string({
+            char: 'i',
+            description: 'Path to sample-queries.json file generated by generate-queries command',
+            required: true
+        }),
+        output: core_1.Flags.string({
+            char: 'o',
+            description: 'Output path for the .queries.json metadata file',
+            required: true
+        }),
+        'separate-sql-files': core_1.Flags.boolean({
+            description: 'Write SQL to separate files and use @file: references',
+            default: false
+        }),
+        'sql-dir': core_1.Flags.string({
+            description: 'Directory for SQL files when using --separate-sql-files (relative to output file)',
+            default: 'SQL'
+        }),
+        category: core_1.Flags.string({
+            description: 'Category name for @lookup reference (e.g., "Database Documentation")',
+            required: false
+        }),
+        status: core_1.Flags.string({
+            description: 'Status to assign to exported queries',
+            options: ['Approved', 'Pending', 'Rejected', 'Expired'],
+            default: 'Pending'
+        }),
+        'min-confidence': core_1.Flags.string({
+            description: 'Minimum confidence threshold to export (0-1)',
+            default: '0'
+        }),
+        'validated-only': core_1.Flags.boolean({
+            description: 'Only export queries that were successfully validated',
+            default: false
+        }),
+        append: core_1.Flags.boolean({
+            description: 'Append to existing metadata file instead of overwriting',
+            default: false
+        }),
+        'include-primary-key': core_1.Flags.boolean({
+            description: 'Include primaryKey and sync fields (for updating existing records)',
+            default: false
+        })
+    };
+    async run() {
+        const { flags } = await this.parse(DbDocExportSampleQueries);
+        // Load DBAutoDoc command dynamically
+        const { default: ExportSampleQueriesCommand } = await Promise.resolve().then(() => __importStar(require('@memberjunction/db-auto-doc/dist/commands/export-sample-queries')));
+        // Build args array for DBAutoDoc command
+        const args = [];
+        if (flags.input) {
+            args.push('--input', flags.input);
+        }
+        if (flags.output) {
+            args.push('--output', flags.output);
+        }
+        if (flags['separate-sql-files']) {
+            args.push('--separate-sql-files');
+        }
+        if (flags['sql-dir'] && flags['sql-dir'] !== 'SQL') {
+            args.push('--sql-dir', flags['sql-dir']);
+        }
+        if (flags.category) {
+            args.push('--category', flags.category);
+        }
+        if (flags.status && flags.status !== 'Pending') {
+            args.push('--status', flags.status);
+        }
+        if (flags['min-confidence'] && flags['min-confidence'] !== '0') {
+            args.push('--min-confidence', flags['min-confidence']);
+        }
+        if (flags['validated-only']) {
+            args.push('--validated-only');
+        }
+        if (flags.append) {
+            args.push('--append');
+        }
+        if (flags['include-primary-key']) {
+            args.push('--include-primary-key');
+        }
+        // Execute the DBAutoDoc export-sample-queries command
+        await ExportSampleQueriesCommand.run(args);
+    }
+}
+exports.default = DbDocExportSampleQueries;

package/dist/commands/sync/push.js

@@ -174,6 +174,7 @@ class Push extends core_1.Command {
                 unchanged: result.unchanged,
                 deleted: result.deleted || 0,
                 skipped: result.skipped || 0,
+                deferred: result.deferred || 0,
                 errors: result.errors,
                 duration: endTime - startTime,
             });

package/oclif.manifest.json

@@ -202,6 +202,114 @@
         "analyze.js"
       ]
     },
+    "dbdoc:export-sample-queries": {
+      "aliases": [],
+      "args": {},
+      "description": "Export sample queries to MemberJunction metadata format (delegates to db-auto-doc export-sample-queries)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --input ./output/sample-queries.json --output ./metadata/queries/.queries.json",
+        "<%= config.bin %> <%= command.id %> --input ./sample-queries.json --output ./metadata/queries/.queries.json --separate-sql-files",
+        "<%= config.bin %> <%= command.id %> --input ./sample-queries.json --output ./queries/.queries.json --category \"Database Documentation\"",
+        "<%= config.bin %> <%= command.id %> --input ./sample-queries.json --output ./queries/.queries.json --status Pending --min-confidence 0.8"
+      ],
+      "flags": {
+        "input": {
+          "char": "i",
+          "description": "Path to sample-queries.json file generated by generate-queries command",
+          "name": "input",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "output": {
+          "char": "o",
+          "description": "Output path for the .queries.json metadata file",
+          "name": "output",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "separate-sql-files": {
+          "description": "Write SQL to separate files and use @file: references",
+          "name": "separate-sql-files",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "sql-dir": {
+          "description": "Directory for SQL files when using --separate-sql-files (relative to output file)",
+          "name": "sql-dir",
+          "default": "SQL",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "category": {
+          "description": "Category name for @lookup reference (e.g., \"Database Documentation\")",
+          "name": "category",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "description": "Status to assign to exported queries",
+          "name": "status",
+          "default": "Pending",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Approved",
+            "Pending",
+            "Rejected",
+            "Expired"
+          ],
+          "type": "option"
+        },
+        "min-confidence": {
+          "description": "Minimum confidence threshold to export (0-1)",
+          "name": "min-confidence",
+          "default": "0",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "validated-only": {
+          "description": "Only export queries that were successfully validated",
+          "name": "validated-only",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "append": {
+          "description": "Append to existing metadata file instead of overwriting",
+          "name": "append",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "include-primary-key": {
+          "description": "Include primaryKey and sync fields (for updating existing records)",
+          "name": "include-primary-key",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "dbdoc:export-sample-queries",
+      "pluginAlias": "@memberjunction/cli",
+      "pluginName": "@memberjunction/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "dist",
+        "commands",
+        "dbdoc",
+        "export-sample-queries.js"
+      ]
+    },
     "dbdoc:export": {
       "aliases": [],
       "args": {},
@@ -2177,5 +2285,5 @@
       ]
     }
   },
-  "version": "2.121.0"
+  "version": "2.122.1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/cli",
-  "version": "2.121.0",
+  "version": "2.122.1",
   "description": "MemberJunction command line tools",
   "keywords": [
     "oclif"
@@ -51,13 +51,13 @@
   },
   "dependencies": {
     "@inquirer/prompts": "^5.0.1",
-    "@memberjunction/ai-cli": "2.121.0",
-    "@memberjunction/codegen-lib": "2.121.0",
-    "@memberjunction/core": "2.121.0",
-    "@memberjunction/db-auto-doc": "2.121.0",
-    "@memberjunction/metadata-sync": "2.121.0",
-    "@memberjunction/sqlserver-dataprovider": "2.121.0",
-    "@memberjunction/testing-cli": "2.121.0",
+    "@memberjunction/ai-cli": "2.122.1",
+    "@memberjunction/codegen-lib": "2.122.1",
+    "@memberjunction/core": "2.122.1",
+    "@memberjunction/db-auto-doc": "2.122.1",
+    "@memberjunction/metadata-sync": "2.122.1",
+    "@memberjunction/sqlserver-dataprovider": "2.122.1",
+    "@memberjunction/testing-cli": "2.122.1",
     "@oclif/core": "^3",
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-version": "^2.0.17",