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

package/package.json

@@ -1,21 +1,33 @@
 {
   "name": "@peernova/cuneiform-sf",
   "description": "Cuneiform for Salesforce CLI-Powered Data Profiling",
-  "version": "1.0.2",
+  "version": "1.0.4-beta.8",
+  "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",
     "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 +46,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 +62,36 @@
     "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 before you deploy Agentforce, Data 360, plan an org migration, or prioritize data quality.  Cuneiform for Salesforce profiles objects, fields, and value usage patterns directly from your org — giving you evidence for decisions that previously required weeks of manual analysis or significant data management expertise."
+      },
+      "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 reusable profiling specifications that tell Cuneiform what to analyze — which objects, which fields, and under what conditions. Create, update, and organize definitions in your org; export and import them 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": "Understand the data landscape of your org before committing to a profiling scope, migration, or initiative. List objects with record volumes, type distribution, and namespace filtering to see where data lives; describe individual objects to map field structure, record types, and data dependencies before you build."
+      },
+      "cuneiform:org": {
+        "description": "Establish the org context you need before any profiling, migration, or initiative begins. Surfaces Cuneiform installation status and license, org type, active features, detected Salesforce Clouds, installed namespace composition, and API limits — a complete platform baseline from a single command."
+      },
+      "cuneiform:profile": {
+        "description": "Generate the object, field, and value-level evidence that reveals what your Salesforce data is actually doing — including population rates, value distributions, and usage patterns across every profiled object, for the data segments that drive your business outcomes. Execute definitions individually by key or in bulk by type, with parallel processing, namespace filtering, and real-time progress monitoring."
+      },
+      "cuneiform:summary": {
+        "description": "Maintain a clean, current record of profiling results across the engagement lifecycle. Profiling summaries accumulate with each execution — manage them precisely by object, definition, or ID, with dry-run preview before deletion, to keep your active data intelligence current without losing analytical continuity."
+      },
+      "cuneiform:user": {
+        "description": "Verify and activate the prerequisites for CLI-based profiling — so every user can start without guesswork or support tickets. Check surfaces Ready/Not Ready status with specific resolution guidance for anything missing; configure assigns the required permissions and enables profiling access in a single, safe operation."
       }
     },
     "flexibleTaxonomy": true
@@ -73,12 +109,33 @@
     "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-base.json --reporter-option outputFile=nut-smoke-results.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",
+    "nuts:provision": "node scripts/nut-provision.cjs",
+    "nuts:phase1": "mocha --config .mocharc.nuts-parallel.json",
+    "nuts:phase2": "mocha --config .mocharc.nuts-serial.json",
     "test:only": "wireit",
+    "test:fresh": "c8 mocha \"test/**/*.test.ts\"",
+    "test:quality": "node scripts/generate-test-quality-report.cjs",
+    "docs:generate": "node scripts/generate-docs.cjs",
+    "docs:freshness": "bash scripts/check-docs-drift.sh",
+    "coverage:commands": "node scripts/check-command-coverage.cjs",
+    "docs:sync": "node scripts/check-doc-sync.cjs",
+    "snapshot": "bash scripts/generate-snapshots.sh",
     "version": "oclif readme"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "restricted"
   },
   "wireit": {
     "build": {
@@ -112,7 +169,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 +195,7 @@
       ]
     },
     "test:only": {
-      "command": "nyc mocha \"test/**/*.test.ts\"",
+      "command": "c8 mocha \"test/**/*.test.ts\"",
       "env": {
         "FORCE_COLOR": "2"
       },
@@ -148,7 +205,7 @@
         "**/tsconfig.json",
         ".mocha*",
         "!*.nut.ts",
-        ".nycrc"
+        ".c8rc.json"
       ],
       "output": []
     },
@@ -196,8 +253,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.