@peernova/cuneiform-sf 1.0.2 → 1.0.4-beta.10

package/package.json

@@ -1,21 +1,34 @@
 {
   "name": "@peernova/cuneiform-sf",
   "description": "Cuneiform for Salesforce CLI-Powered Data Profiling",
-  "version": "1.0.2",
+  "version": "1.0.4-beta.10",
+  "cuneiform": {
+    "_comment": "Compatibility manifest. CLI-2932. requiredAppVersion is the minimum Cuneiform For Salesforce managed package version this CLI build expects in the target org. Update at release time alongside the CLI version. See README → Compatibility.",
+    "requiredAppVersion": "4.12.0.17"
+  },
   "dependencies": {
+    "@jetstreamapp/soql-parser-js": "^6.3.1",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "@oclif/core": "^4",
     "@salesforce/core": "^8",
-    "@salesforce/sf-plugins-core": "^12"
+    "@salesforce/sf-plugins-core": "^12",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@oclif/plugin-command-snapshot": "^5.1.9",
-    "@types/node": "^22",
     "@salesforce/cli-plugins-testkit": "^5.3.10",
-    "@salesforce/dev-scripts": "^10",
+    "@salesforce/dev-scripts": "^11",
+    "@types/node": "^22",
+    "c8": "^10.1.3",
     "eslint-plugin-sf-plugin": "^1.20.33",
+    "eslint-plugin-test-quality": "file:eslint-plugin-test-quality",
+    "knip": "^6.9.0",
     "oclif": "^4.14.0",
+    "sfdmu": "^5.6.0",
     "ts-node": "^10.9.2",
-    "typescript": "^5.4.5"
+    "tsx": "^4.19.3",
+    "typescript": "^5.9.3",
+    "yarn": "^1.22.22"
   },
   "engines": {
     "node": ">=18.0.0"
@@ -34,9 +47,9 @@
     "data-quality",
     "cuneiform"
   ],
-  "license": "BSD-3-Clause",
+  "license": "SEE LICENSE IN LICENSE",
   "peerDependencies": {
-    "sfdmu": ">=4.0.0"
+    "sfdmu": ">=5.0.0"
   },
   "peerDependenciesMeta": {
     "sfdmu": {
@@ -50,12 +63,39 @@
     "devPlugins": [
       "@oclif/plugin-help"
     ],
+    "hooks": {
+      "prerun": "./lib/hooks/prerun"
+    },
     "topics": {
-      "hello": {
-        "description": "Commands to say hello."
-      },
       "cuneiform": {
-        "description": "provides a description of the Cuneiform for Salesforce SFDX Plugin."
+        "description": "Know what your Salesforce data is actually doing — whether you are preparing for Agentforce, integrating data across systems, optimizing your org, strengthening governance, or building a monitoring practice. Cuneiform for Salesforce profiles objects, fields, and value usage patterns directly from your org, producing evidence you can act on in minutes: profiling scope, data quality gaps, and operational priorities."
+      },
+      "cuneiform:compatibility": {
+        "description": "Verify the Cuneiform For Salesforce app version this CLI build expects and (optionally) the version installed in a target org. Local-only readout in default mode; queries InstalledSubscriberPackage when --target-org is supplied."
+      },
+      "cuneiform:definition": {
+        "description": "Build and manage the profiling specifications that tell Cuneiform what to analyze — which objects, which fields, which methods, and under what conditions. Create definitions for dozens of objects in a single command; update field lists as schemas evolve; export and import for team collaboration, backup, and cross-org portability."
+      },
+      "cuneiform:mcp": {
+        "description": "Turn data profiling from a specialist skill into a conversation anyone on your team can have. Cuneiform MCP connects all profiling, analysis, and management capabilities to the AI assistant of your choice via the Model Context Protocol — giving your team evidence-backed answers about data quality without learning command syntax."
+      },
+      "cuneiform:object": {
+        "description": "Explore the Salesforce objects in your org — standard, custom, and managed package. List gives you the inventory: which objects have data, how much, and which namespaces they belong to. Describe gives you the deep dive: field structure, record types, data age, and relationships for individual objects. Together they answer: what should we profile, and how should we scope it?"
+      },
+      "cuneiform:org": {
+        "description": "See your org's consolidated configuration — edition, products, features, namespace composition, and API capacity — from a single command. Surfaces Cuneiform installation status, org type, active features, detected Salesforce Clouds, installed namespaces with object counts, and capacity warnings as the platform baseline that precedes every profiling engagement."
+      },
+      "cuneiform:profile": {
+        "description": "Generate the object, field, and value-level evidence that reveals what your Salesforce data is actually doing — population rates, value distributions, usage patterns, and reliability insights across every profiled object. Execute definitions individually by key or in bulk by method, with parallel processing, namespace filtering, and automatic skip of empty objects."
+      },
+      "cuneiform:profile:request": {
+        "description": "A profiling request is the execution record created when you run `sf cuneiform profile` — it tracks what was submitted, by whom, and whether it completed, was rejected, or was canceled. Requests transition through four statuses: Queued, Completed, Rejected, and Canceled. Monitor the queue to track progress, cancel requests before they generate summaries, and delete terminal requests to keep the queue clean."
+      },
+      "cuneiform:summary": {
+        "description": "A profiling summary is a point-in-time snapshot of field population, value frequency, and KPI results for a single object — created each time a definition is profiled. One definition produces many summaries over successive runs, building a history of how data quality evolves. Manage that history by pruning older results to keep the latest per definition, purging by object or category, stopping in-progress summaries to free resources, and reprofiling failed fields to fill gaps."
+      },
+      "cuneiform:user": {
+        "description": "Verify and activate the two configuration touchpoints required for CLI-based profiling — so every user starts confident their environment is ready. Diagnostic mode shows Ready/Not Ready status with specific resolution guidance; configure mode assigns the permission set and enables API-Based Profiling in a single, safe operation."
       }
     },
     "flexibleTaxonomy": true
@@ -73,8 +113,36 @@
     "postpack": "sf-clean --ignore-signing-artifacts",
     "prepack": "sf-prepack",
     "test": "wireit",
-    "test:nuts": "nyc mocha \"**/*.nut.ts\" --slow 4500 --timeout 600000 --parallel",
+    "test:nuts": "mocha --config .mocharc.nuts.json",
+    "test:nuts:fast": "mocha --config .mocharc.nuts-fast.json",
+    "test:nuts:commands": "mocha --config .mocharc.nuts-base.json --reporter-option outputFile=nut-commands-results.json \"test/commands/**/*.nut.ts\"",
+    "test:nuts:adapters": "mocha --config .mocharc.nuts-base.json --reporter-option outputFile=nut-adapters-results.json \"test/adapters/**/*.nut.ts\"",
+    "test:nuts:services": "mocha --config .mocharc.nuts-base.json --reporter-option outputFile=nut-services-results.json \"test/services/**/*.nut.ts\"",
+    "test:nuts:group": "mocha --config .mocharc.nuts-base.json --reporter-option outputFile=nut-group-results.json",
+    "test:nuts:smoke": "mocha --config .mocharc.nuts-smoke.json",
+    "test:nuts:core": "mocha --config .mocharc.nuts-core.json",
+    "test:nuts:shard-a": "mocha --config .mocharc.nuts-shard-a.json",
+    "test:nuts:shard-b": "mocha --config .mocharc.nuts-shard-b.json",
+    "test:nuts:shard-c": "mocha --config .mocharc.nuts-shard-c.json",
+    "test:nuts:timed": "mocha --config .mocharc.nuts.json; node scripts/report-nut-timing.cjs test-results/nut-kycd-results.json",
+    "test:nuts:timeline": "mocha --config .mocharc.nuts.json; node scripts/generate-nut-timeline.cjs --open",
+    "test:nuts:debug-logs": "node scripts/capture-debug-logs.cjs",
+    "test:nuts:observe": "mocha --config .mocharc.nuts.json; node scripts/report-nut-timing.cjs test-results/nut-kycd-results.json; node scripts/generate-nut-timeline.cjs; node scripts/capture-debug-logs.cjs",
+    "test:nuts:parallel": "node scripts/nut-provision.cjs && mocha --config .mocharc.nuts-parallel.json && mocha --config .mocharc.nuts-serial.json",
+    "test:nuts:seed": "node scripts/nut-provision.cjs --seed",
+    "nuts:provision": "node scripts/nut-provision.cjs",
+    "nuts:seed": "node scripts/nut-provision.cjs --seed",
+    "nuts:phase1": "mocha --config .mocharc.nuts-parallel.json",
+    "nuts:phase2": "mocha --config .mocharc.nuts-serial.json",
+    "nuts:shard": "node scripts/nut-shard.cjs",
     "test:only": "wireit",
+    "test:fresh": "c8 mocha \"test/**/*.test.ts\"",
+    "test:quality": "node scripts/generate-test-quality-report.cjs",
+    "coverage:commands": "node scripts/check-command-coverage.cjs",
+    "docs:generate": "node scripts/generate-docs.cjs",
+    "docs:freshness": "bash scripts/check-docs-drift.sh",
+    "snapshot": "bash scripts/generate-snapshots.sh",
+    "knip": "knip",
     "version": "oclif readme"
   },
   "publishConfig": {
@@ -112,7 +180,7 @@
       "output": []
     },
     "lint": {
-      "command": "eslint src test --color --cache --cache-location .eslintcache",
+      "command": "eslint src test --color --max-warnings=0",
       "files": [
         "src/**/*.ts",
         "test/**/*.ts",
@@ -138,7 +206,7 @@
       ]
     },
     "test:only": {
-      "command": "nyc mocha \"test/**/*.test.ts\"",
+      "command": "c8 mocha \"test/**/*.test.ts\"",
       "env": {
         "FORCE_COLOR": "2"
       },
@@ -148,7 +216,7 @@
         "**/tsconfig.json",
         ".mocha*",
         "!*.nut.ts",
-        ".nycrc"
+        ".c8rc.json"
       ],
       "output": []
     },
@@ -196,8 +264,26 @@
   "author": "Abraham David Lloyd (PeerNova)",
   "repository": {
     "type": "git",
-    "url": "https://github.com/PeerNova-Solutions/cuneiform-cli.git",
-    "directory": "@peernova/cuneiform-sf"
+    "url": "git+https://github.com/PeerNova-Solutions/salesforce-cli.git"
   },
-  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e",
+  "resolutions": {
+    "@modelcontextprotocol/sdk/**/ajv": "^8.20.0",
+    "@salesforce/core/**/ajv": "^8.20.0",
+    "brace-expansion": "^1.1.12",
+    "diff": "^4.0.4",
+    "fast-uri": "^3.1.2",
+    "fast-xml-parser": "^5.7.0",
+    "flatted": "^3.4.2",
+    "form-data": "^4.0.5",
+    "hono": "^4.12.16",
+    "ip-address": "^10.1.1",
+    "lodash": "^4.18.0",
+    "lodash-es": "^4.18.0",
+    "minimatch": "^9.0.5 || ^10.2.3",
+    "picomatch": "^4.0.4",
+    "qs": "^6.14.1",
+    "serialize-javascript": "^7.0.5",
+    "tough-cookie": "^4.1.3"
+  }
 }

package/lib/commands/cuneiform/about.d.ts

@@ -1,13 +0,0 @@
-import { SfCommand } from '@salesforce/sf-plugins-core';
-export type CuneiformAboutResult = {
-    path: string;
-};
-export default class CuneiformAbout extends SfCommand<CuneiformAboutResult> {
-    static readonly summary: string;
-    static readonly description: string;
-    static readonly examples: string[];
-    static readonly flags: {
-        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    run(): Promise<CuneiformAboutResult>;
-}

package/lib/commands/cuneiform/about.js

@@ -1,26 +0,0 @@
-import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
-import { Messages } from '@salesforce/core';
-Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
-const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'cuneiform.about');
-export default class CuneiformAbout extends SfCommand {
-    static summary = messages.getMessage('summary');
-    static description = messages.getMessage('description');
-    static examples = messages.getMessages('examples');
-    static flags = {
-        name: Flags.string({
-            summary: messages.getMessage('flags.name.summary'),
-            description: messages.getMessage('flags.name.description'),
-            char: 'n',
-            required: false,
-        }),
-    };
-    async run() {
-        const { flags } = await this.parse(CuneiformAbout);
-        const name = flags.name ?? 'world';
-        this.log(`hello ${name} from src/commands/cuneiform/about.ts`);
-        return {
-            path: 'src/commands/cuneiform/about.ts',
-        };
-    }
-}
-//# sourceMappingURL=about.js.map

package/lib/commands/cuneiform/about.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"about.js","sourceRoot":"","sources":["../../../src/commands/cuneiform/about.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,wBAAwB,EAAE,iBAAiB,CAAC,CAAC;AAMpF,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,SAA+B;IAClE,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,CAAU,KAAK,GAAG;QAC7B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;YAClD,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,wBAAwB,CAAC;YAC1D,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAEnD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC;QACnC,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,uCAAuC,CAAC,CAAC;QAC/D,OAAO;YACL,IAAI,EAAE,iCAAiC;SACxC,CAAC;IACJ,CAAC"}

package/lib/commands/hello/world.d.ts

@@ -1,14 +0,0 @@
-import { SfCommand } from '@salesforce/sf-plugins-core';
-export type HelloWorldResult = {
-    name: string;
-    time: string;
-};
-export default class World extends SfCommand<HelloWorldResult> {
-    static readonly summary: string;
-    static readonly description: string;
-    static readonly examples: string[];
-    static readonly flags: {
-        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    run(): Promise<HelloWorldResult>;
-}

package/lib/commands/hello/world.js

@@ -1,27 +0,0 @@
-import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
-import { Messages } from '@salesforce/core';
-Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
-const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'hello.world');
-export default class World extends SfCommand {
-    static summary = messages.getMessage('summary');
-    static description = messages.getMessage('description');
-    static examples = messages.getMessages('examples');
-    static flags = {
-        name: Flags.string({
-            char: 'n',
-            summary: messages.getMessage('flags.name.summary'),
-            description: messages.getMessage('flags.name.description'),
-            default: 'World',
-        }),
-    };
-    async run() {
-        const { flags } = await this.parse(World);
-        const time = new Date().toDateString();
-        this.log(messages.getMessage('info.hello', [flags.name, time]));
-        return {
-            name: flags.name,
-            time,
-        };
-    }
-}
-//# sourceMappingURL=world.js.map

package/lib/commands/hello/world.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"world.js","sourceRoot":"","sources":["../../../src/commands/hello/world.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,QAAQ,CAAC,kCAAkC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,wBAAwB,EAAE,aAAa,CAAC,CAAC;AAOhF,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,SAA2B;IACrD,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,CAAU,KAAK,GAAG;QAC7B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,oBAAoB,CAAC;YAClD,WAAW,EAAE,QAAQ,CAAC,UAAU,CAAC,wBAAwB,CAAC;YAC1D,OAAO,EAAE,OAAO;SACjB,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,YAAY,EAAE,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAChE,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI;SACL,CAAC;IACJ,CAAC"}

package/lib/index.d.ts

@@ -1,2 +0,0 @@
-declare const _default: {};
-export default _default;

package/lib/index.js

@@ -1,2 +0,0 @@
-export default {};
-//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe,EAAE,CAAC"}

package/messages/cuneiform.about.md

@@ -1,19 +0,0 @@
-# summary
-
-Summary of a command.
-
-# description
-
-More information about a command. Don't repeat the summary.
-
-# flags.name.summary
-
-Description of a flag.
-
-# flags.name.description
-
-More information about a flag. Don't repeat the summary.
-
-# examples
-
-- <%= config.bin %> <%= command.id %>

package/messages/hello.world.md

@@ -1,29 +0,0 @@
-# summary
-
-Say hello.
-
-# description
-
-Say hello either to the world or someone you know.
-
-# flags.name.summary
-
-The name of the person you'd like to say hello to.
-
-# flags.name.description
-
-This person can be anyone in the world!
-
-# examples
-
-- Say hello to the world:
-
-  <%= config.bin %> <%= command.id %>
-
-- Say hello to someone you know:
-
-  <%= config.bin %> <%= command.id %> --name Astro
-
-# info.hello
-
-Hello %s at %s.