sf-agentpmd 0.1.0

package/dist/renderers/sarif.js

@@ -0,0 +1,131 @@
+const DEFAULT_WARNING = 10;
+const DEFAULT_ERROR = 20;
+const RULE_AGENT_CC = {
+    defaultConfiguration: { level: 'note' },
+    fullDescription: {
+        text: 'Reports cyclomatic complexity (McCabe) of an AgentScript before_reasoning, ' +
+            'after_reasoning, or reasoning.instructions block. Computed as 1 + ' +
+            'count(if) + count(elif) + count(ternary) + count(and) + count(or).',
+    },
+    helpUri: 'https://github.com/bobbywhitesfdc/sf-agentpmd/blob/main/docs/agent-loc-categorization-skill-v2.md#-7--cyclomatic-complexity',
+    id: 'AGENTPMD.AgentScriptCyclomaticComplexity',
+    name: 'AgentScriptCyclomaticComplexity',
+    shortDescription: {
+        text: 'McCabe cyclomatic complexity of an AgentScript procedure.',
+    },
+};
+const RULE_APEX_CC = {
+    defaultConfiguration: { level: 'note' },
+    fullDescription: {
+        text: 'Reports cyclomatic complexity (McCabe) of an Apex method or ' +
+            'constructor body, mirroring SonarQube / PMD CyclomaticComplexity.',
+    },
+    helpUri: 'https://github.com/bobbywhitesfdc/sf-agentpmd/blob/main/docs/agent-loc-categorization-skill-v2.md#-7--cyclomatic-complexity',
+    id: 'AGENTPMD.ApexCyclomaticComplexity',
+    name: 'ApexCyclomaticComplexity',
+    shortDescription: {
+        text: 'McCabe cyclomatic complexity of an Apex method or constructor.',
+    },
+};
+export function renderSarif(report, opts) {
+    const warn = opts?.sarifWarningThreshold ?? DEFAULT_WARNING;
+    const err = opts?.sarifErrorThreshold ?? DEFAULT_ERROR;
+    const results = [];
+    for (const f of report.files) {
+        for (const p of f.procedures) {
+            results.push(buildAgentResult(f, p, warn, err));
+        }
+    }
+    for (const cls of report.apexClasses) {
+        for (const m of cls.methods) {
+            results.push(buildApexResult(cls, m, warn, err));
+        }
+    }
+    const log = {
+        $schema: 'https://raw.githubusercontent.com/oasis-tcs/sarif-spec/master/Schemata/sarif-schema-2.1.0.json',
+        runs: [
+            {
+                results,
+                tool: {
+                    driver: {
+                        informationUri: 'https://github.com/bobbywhitesfdc/sf-agentpmd',
+                        name: 'sf-agentpmd',
+                        rules: [RULE_AGENT_CC, RULE_APEX_CC],
+                        semanticVersion: pluginVersion(),
+                    },
+                },
+            },
+        ],
+        version: '2.1.0',
+    };
+    return JSON.stringify(log, null, 2);
+}
+function buildAgentResult(f, p, warn, err) {
+    return {
+        level: levelFor(p.complexity, warn, err),
+        locations: [
+            {
+                physicalLocation: {
+                    artifactLocation: { uri: f.path },
+                    // AgentScript CST locations are 0-based — bump to SARIF 1-based.
+                    region: regionFromZeroBased(p.location),
+                },
+            },
+        ],
+        message: {
+            text: `Procedure '${p.kind}' in '${p.scope}' has cyclomatic complexity ` +
+                `${p.complexity}.`,
+        },
+        properties: { complexity: p.complexity, kind: p.kind },
+        ruleId: RULE_AGENT_CC.id,
+    };
+}
+function buildApexResult(cls, m, warn, err) {
+    return {
+        level: levelFor(m.complexity, warn, err),
+        locations: [
+            {
+                physicalLocation: {
+                    artifactLocation: { uri: cls.path },
+                    // ANTLR token positions are 1-based for line, 0-based for column;
+                    // SARIF wants 1-based for both.
+                    region: regionFromAntlr(m.location),
+                },
+            },
+        ],
+        message: {
+            text: `${m.kind} '${m.name}' has cyclomatic complexity ${m.complexity}.`,
+        },
+        properties: { complexity: m.complexity, kind: m.kind },
+        ruleId: RULE_APEX_CC.id,
+    };
+}
+function levelFor(cc, warn, err) {
+    if (cc >= err)
+        return 'error';
+    if (cc >= warn)
+        return 'warning';
+    return 'note';
+}
+function regionFromZeroBased(loc) {
+    return {
+        endColumn: loc.endCol + 1,
+        endLine: loc.endRow + 1,
+        startColumn: loc.startCol + 1,
+        startLine: loc.startRow + 1,
+    };
+}
+function regionFromAntlr(loc) {
+    return {
+        endColumn: loc.endCol + 1,
+        endLine: Math.max(1, loc.endRow),
+        startColumn: loc.startCol + 1,
+        startLine: Math.max(1, loc.startRow),
+    };
+}
+function pluginVersion() {
+    // Avoid a JSON-file dep at runtime; this stays in sync with package.json
+    // manually. Bumping the plugin should bump this string.
+    return '0.1.0';
+}
+//# sourceMappingURL=sarif.js.map

package/dist/renderers/sarif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.js","sourceRoot":"","sources":["../../src/renderers/sarif.ts"],"names":[],"mappings":"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"}

package/dist/renderers/text.d.ts

@@ -0,0 +1,3 @@
+import type { AnalysisReport } from '../analyzer/types.js';
+import type { RenderOptions } from './options.js';
+export declare function renderText(report: AnalysisReport, opts?: RenderOptions): string;

package/dist/renderers/text.js

@@ -0,0 +1,243 @@
+import pc from 'picocolors';
+const KIND_LABEL = {
+    after_reasoning: 'after_reasoning',
+    available_when: 'available_when',
+    before_reasoning: 'before_reasoning',
+    other: 'other',
+    reasoning_instructions: 'reasoning.instructions',
+};
+const UNICODE_GLYPHS = {
+    agentFile: '📄',
+    apexFile: '📜',
+    ruleHeavy: '═',
+    ruleLight: '─',
+};
+const ASCII_GLYPHS = {
+    agentFile: '[agent]',
+    apexFile: '[apex] ',
+    ruleHeavy: '=',
+    ruleLight: '-',
+};
+function resolveOptions(opts) {
+    // Auto-detect: text + emoji unless explicitly disabled, color on TTY only
+    // and respecting the well-known NO_COLOR env var.
+    const stdoutIsTty = Boolean(process.stdout.isTTY);
+    const noColorEnv = Boolean(process.env.NO_COLOR);
+    return {
+        ascii: opts?.ascii ?? !stdoutIsTty,
+        color: opts?.color ?? (stdoutIsTty && !noColorEnv),
+        width: opts?.width ?? 60,
+    };
+}
+export function renderText(report, opts) {
+    const r = resolveOptions(opts);
+    const g = r.ascii ? ASCII_GLYPHS : UNICODE_GLYPHS;
+    const c = colorize(r.color);
+    const lines = [];
+    lines.push(c.title('AgentForce PMD — Cyclomatic Complexity (McCabe)'), g.ruleHeavy.repeat(r.width));
+    if (report.files.length === 0) {
+        lines.push('  (no .agent files found)');
+        return lines.join('\n');
+    }
+    for (const f of report.files) {
+        lines.push('', `${g.agentFile} ${c.path(f.path)}   CC=${c.cc(f.fileComplexity)}`, g.ruleLight.repeat(r.width));
+        if (f.procedures.length === 0) {
+            lines.push('  (no procedure-bearing scopes)');
+        }
+        else {
+            const scopes = groupByScope(f.procedures);
+            for (const [scope, procs] of scopes) {
+                const scopeTotal = procs.reduce((a, p) => a + p.complexity, 0);
+                lines.push(`  ${c.scope(scope)}   subtotal CC=${c.cc(scopeTotal)}`);
+                for (const p of procs) {
+                    lines.push(`    ${pad(KIND_LABEL[p.kind], 24)} CC=${c.cc(p.complexity)}   ` +
+                        c.breakdown(breakdownProc(p)));
+                }
+            }
+        }
+        if (f.declarations.length > 0 || f.references.length > 0) {
+            lines.push('', '  Action references', '  ' + g.ruleLight.repeat(Math.max(0, r.width - 2)));
+            const usage = countReferences(f);
+            for (const d of f.declarations) {
+                const used = usage.get(d.name) ?? 0;
+                const tgt = d.target ?? '(no target)';
+                lines.push(`    ${pad(d.name, 32)} [${pad(d.targetKind, 6)}] used ${used}x → ${tgt}`);
+            }
+            const undeclared = listUndeclaredRefs(f);
+            if (undeclared.length > 0) {
+                lines.push('', '    Referenced but not declared in-file:');
+                for (const u of undeclared) {
+                    lines.push(`      ${u}`);
+                }
+            }
+        }
+    }
+    if (report.apexClasses.length > 0 || report.unresolvedApexTargets.length > 0) {
+        lines.push('', c.title('Apex backing logic (resolved via apex:// targets)'), g.ruleHeavy.repeat(r.width));
+        for (const cls of report.apexClasses) {
+            lines.push('', `${g.apexFile} ${c.path(cls.path)}   class CC=${c.cc(cls.classComplexity)}`, `   referenced by: ${cls.referencedBy.join(', ') || '(none)'}`, g.ruleLight.repeat(r.width));
+            if (cls.methods.length === 0) {
+                lines.push('   (no methods with bodies)');
+            }
+            else {
+                for (const m of cls.methods) {
+                    lines.push(`   ${pad(m.signature, 44)} CC=${c.cc(m.complexity)}   ${c.breakdown(breakdownApex(m.contributors))}`);
+                }
+            }
+        }
+        if (report.unresolvedApexTargets.length > 0) {
+            lines.push('', 'Unresolved apex:// targets:');
+            for (const u of report.unresolvedApexTargets) {
+                lines.push(`  - ${u}  (no matching .cls under source-dir or --apex-source)`);
+            }
+        }
+    }
+    lines.push('', g.ruleHeavy.repeat(r.width), c.title('CC by location (whitepaper § 7)'), `  AgentScript: ${c.cc(report.totalComplexity)}` +
+        `   Apex: ${c.cc(report.totalApexComplexity)}` +
+        `   Combined: ${c.cc(report.totalComplexity + report.totalApexComplexity)}`, `Action declarations: ${report.totalDeclarations}  ` +
+        `(apex ${report.byTargetKind.apex}, flow ${report.byTargetKind.flow}, ` +
+        `prompt ${report.byTargetKind.prompt}, unknown ${report.byTargetKind.unknown})`, `Action references:   ${report.totalReferences}`);
+    return lines.join('\n');
+}
+function colorize(on) {
+    if (!on) {
+        return {
+            breakdown: s => s,
+            cc: String,
+            path: s => s,
+            scope: s => s,
+            title: s => s,
+        };
+    }
+    return {
+        breakdown: pc.gray,
+        cc(n) {
+            // Palette echoes whitepaper temperature: cool for low, hot for high.
+            const s = String(n);
+            if (n >= 20)
+                return pc.red(s);
+            if (n >= 10)
+                return pc.yellow(s);
+            if (n >= 5)
+                return pc.green(s);
+            return pc.gray(s);
+        },
+        path: pc.cyan,
+        scope: pc.bold,
+        title: pc.bold,
+    };
+}
+function breakdownProc(p) {
+    if (p.contributors.length === 0)
+        return '(base only)';
+    const counts = {};
+    for (const c of p.contributors)
+        counts[c.kind] = (counts[c.kind] ?? 0) + 1;
+    return Object.entries(counts)
+        .map(([k, n]) => `${shortKind(k)}=${n}`)
+        .join(' ');
+}
+function breakdownApex(contributors) {
+    if (contributors.length === 0)
+        return '(base only)';
+    const counts = {};
+    for (const c of contributors)
+        counts[c.kind] = (counts[c.kind] ?? 0) + 1;
+    return Object.entries(counts)
+        .map(([k, n]) => `${shortApexKind(k)}=${n}`)
+        .join(' ');
+}
+function shortKind(k) {
+    switch (k) {
+        case 'elif_clause': {
+            return 'elif';
+        }
+        case 'if_statement': {
+            return 'if';
+        }
+        case 'short_circuit_and': {
+            return 'and';
+        }
+        case 'short_circuit_or': {
+            return 'or';
+        }
+        case 'ternary_expression': {
+            return 'ternary';
+        }
+        default: {
+            return k;
+        }
+    }
+}
+function shortApexKind(k) {
+    switch (k) {
+        case 'catch_clause': {
+            return 'catch';
+        }
+        case 'do_while_statement': {
+            return 'do-while';
+        }
+        case 'for_statement': {
+            return 'for';
+        }
+        case 'if_statement': {
+            return 'if';
+        }
+        case 'short_circuit_and': {
+            return '&&';
+        }
+        case 'short_circuit_or': {
+            return '||';
+        }
+        case 'ternary': {
+            return 'ternary';
+        }
+        case 'when_arm': {
+            return 'when';
+        }
+        case 'while_statement': {
+            return 'while';
+        }
+        default: {
+            return k;
+        }
+    }
+}
+function groupByScope(procs) {
+    const m = new Map();
+    for (const p of procs) {
+        let arr = m.get(p.scope);
+        if (!arr) {
+            arr = [];
+            m.set(p.scope, arr);
+        }
+        arr.push(p);
+    }
+    return m;
+}
+function pad(s, n) {
+    if (s.length >= n)
+        return s;
+    return s + ' '.repeat(n - s.length);
+}
+function countReferences(f) {
+    const m = new Map();
+    for (const r of f.references)
+        m.set(r.name, (m.get(r.name) ?? 0) + 1);
+    return m;
+}
+function listUndeclaredRefs(f) {
+    const declared = new Set(f.declarations.map(d => d.name));
+    const seen = new Set();
+    const out = [];
+    for (const r of f.references) {
+        if (declared.has(r.name))
+            continue;
+        if (seen.has(r.name))
+            continue;
+        seen.add(r.name);
+        out.push(r.name);
+    }
+    return out;
+}
+//# sourceMappingURL=text.js.map

package/dist/renderers/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/renderers/text.ts"],"names":[],"mappings":"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"}

package/oclif.manifest.json

@@ -0,0 +1,168 @@
+{
+  "commands": {
+    "agentpmd:analyze": {
+      "aliases": [],
+      "args": {},
+      "description": "Walks .agent source files under --source-dir and emits per-procedure\ncyclomatic complexity totals (before_reasoning, after_reasoning, and\nreasoning.instructions blocks), plus an inventory of declared and used\n@actions.X targets. For every apex:// target, resolves the .cls file\nand computes per-method Apex CC.\n\nDefault output is human-readable text. --json emits the SF CLI envelope\nwith the full structured report. --format <markdown|sarif|csv> emits the\nnamed format on stdout for piping into PR comments, GitHub Code Scanning,\nor spreadsheet pivots.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --source-dir force-app/main/default",
+        "<%= config.bin %> <%= command.id %> --source-dir force-app/main/default --json",
+        "<%= config.bin %> <%= command.id %> --source-dir force-app/main/default --format markdown > report.md",
+        "<%= config.bin %> <%= command.id %> --source-dir force-app/main/default --format sarif > report.sarif"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "apex-source": {
+          "name": "apex-source",
+          "summary": "Override directory to look up apex:// targets. By default we walk up from each .agent file looking for a sibling classes/ folder.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "api-name": {
+          "char": "n",
+          "name": "api-name",
+          "summary": "Filter to specific agent bundles. Matched against the bundle directory name and the config.developer_name field. Repeatable.",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "ascii": {
+          "name": "ascii",
+          "summary": "Force ASCII-only output in the text renderer (no Unicode box chars, no emoji).",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "fail-on": {
+          "name": "fail-on",
+          "summary": "Exit non-zero if combined agent+Apex CC meets or exceeds this threshold.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "name": "format",
+          "summary": "Non-JSON output format. --json takes precedence per SF CLI convention.",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "markdown",
+            "sarif",
+            "csv"
+          ],
+          "type": "option"
+        },
+        "no-color": {
+          "name": "no-color",
+          "summary": "Disable ANSI color in the text renderer. NO_COLOR env also disables.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "sarif-error": {
+          "name": "sarif-error",
+          "summary": "SARIF \"error\" level threshold. Default 20.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sarif-warning": {
+          "name": "sarif-warning",
+          "summary": "SARIF \"warning\" level threshold. Default 10.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source-dir": {
+          "char": "d",
+          "name": "source-dir",
+          "summary": "Directory or single .agent file to analyze. Defaults to the packageDirectories of the nearest sfdx-project.json.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "width": {
+          "name": "width",
+          "summary": "Rule width for the text renderer.",
+          "default": 60,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "agentpmd:analyze",
+      "pluginAlias": "sf-agentpmd",
+      "pluginName": "sf-agentpmd",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Compute McCabe cyclomatic complexity and action-reference inventory for AgentScript bundles and their Apex backing logic.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "agentpmd",
+        "analyze.js"
+      ]
+    },
+    "agentpmd:install-skill": {
+      "aliases": [],
+      "args": {},
+      "description": "Recursively copies the bundled skill tree (SKILL.md plus its references/\npages) to ~/.claude/skills/agentforcepmd/ so Claude Code can use it as a\nskill. Restart Claude Code (or reload skills) afterward to activate it.",
+      "examples": [
+        "$ sf agentpmd install-skill"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "agentpmd:install-skill",
+      "pluginAlias": "sf-agentpmd",
+      "pluginName": "sf-agentpmd",
+      "pluginType": "core",
+      "strict": true,
+      "summary": "Install the agentforcepmd Claude Code skill to ~/.claude/skills/.",
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "agentpmd",
+        "install-skill.js"
+      ]
+    }
+  },
+  "version": "0.1.0"
+}

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "sf-agentpmd",
+  "version": "0.1.0",
+  "description": "SF CLI plugin: McCabe cyclomatic complexity and Agent LOC analysis for AgentScript (.agent) bundles.",
+  "license": "MIT",
+  "author": "Bobby White",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bobbywhitesfdc/sf-agentpmd.git"
+  },
+  "bugs": "https://github.com/bobbywhitesfdc/sf-agentpmd/issues",
+  "homepage": "https://github.com/bobbywhitesfdc/sf-agentpmd",
+  "keywords": [
+    "salesforce",
+    "sf-plugin",
+    "sfdx-plugin",
+    "oclif",
+    "agentforce",
+    "agentscript",
+    "cyclomatic-complexity",
+    "mccabe",
+    "pmd",
+    "static-analysis",
+    "code-quality",
+    "apex"
+  ],
+  "files": [
+    "./bin",
+    "./dist",
+    "./vendor",
+    "./skill",
+    "./oclif.manifest.json",
+    "./LICENSE",
+    "./NOTICE"
+  ],
+  "bin": {
+    "sf-agentpmd": "bin/run.js"
+  },
+  "scripts": {
+    "build": "shx rm -rf dist tsconfig.tsbuildinfo && tsc -b",
+    "clean": "shx rm -rf dist oclif.manifest.json tsconfig.tsbuildinfo",
+    "lint": "eslint",
+    "posttest": "npm run lint",
+    "prepack": "oclif manifest && oclif readme",
+    "postpack": "shx rm -f oclif.manifest.json",
+    "test": "mocha --forbid-only \"test/**/*.test.ts\"",
+    "version": "git add README.md"
+  },
+  "dependencies": {
+    "@agentscript/parser-javascript": "file:./vendor/agentscript-parser-javascript",
+    "@agentscript/types": "file:./vendor/agentscript-types",
+    "@apexdevtools/apex-parser": "^5.0.0",
+    "@oclif/core": "^4",
+    "@oclif/plugin-help": "^6",
+    "@salesforce/sf-plugins-core": "^11",
+    "antlr4": "^4.13.2",
+    "picocolors": "^1.1.1",
+    "tiny-invariant": "^1.3.3"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1",
+    "@oclif/prettier-config": "^0.2.1",
+    "@oclif/test": "^4",
+    "@types/chai": "^4",
+    "@types/mocha": "^10",
+    "@types/node": "^22",
+    "chai": "^4",
+    "eslint": "^9",
+    "eslint-config-oclif": "^6",
+    "eslint-config-prettier": "^10",
+    "mocha": "^11",
+    "oclif": "^4",
+    "shx": "^0.3.3",
+    "ts-node": "^10",
+    "typescript": "^5.6"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "oclif": {
+    "bin": "sf",
+    "dirname": "sf-agentpmd",
+    "commands": "./dist/commands",
+    "plugins": [
+      "@oclif/plugin-help"
+    ],
+    "topicSeparator": " ",
+    "topics": {
+      "agentpmd": {
+        "description": "Static analysis for Agentforce / AgentScript bundles (CC and LOC)."
+      }
+    }
+  }
+}