sf-agentpmd 0.1.0

package/dist/commands/agentpmd/analyze.js

@@ -0,0 +1,122 @@
+import { Flags, SfCommand } from '@salesforce/sf-plugins-core';
+import { analyzeSource } from '../../analyzer/analyze.js';
+import { discoverSfdxProject } from '../../analyzer/project.js';
+import { render } from '../../renderers/index.js';
+const FORMATS = ['text', 'markdown', 'sarif', 'csv'];
+export default class AgentpmdAnalyze extends SfCommand {
+    static description = `Walks .agent source files under --source-dir and emits per-procedure
+cyclomatic complexity totals (before_reasoning, after_reasoning, and
+reasoning.instructions blocks), plus an inventory of declared and used
+@actions.X targets. For every apex:// target, resolves the .cls file
+and computes per-method Apex CC.
+
+Default output is human-readable text. --json emits the SF CLI envelope
+with the full structured report. --format <markdown|sarif|csv> emits the
+named format on stdout for piping into PR comments, GitHub Code Scanning,
+or spreadsheet pivots.`;
+    static 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',
+    ];
+    static flags = {
+        'apex-source': Flags.string({
+            summary: 'Override directory to look up apex:// targets. By default we walk up from each .agent file looking for a sibling classes/ folder.',
+        }),
+        'api-name': Flags.string({
+            char: 'n',
+            multiple: true,
+            summary: 'Filter to specific agent bundles. Matched against the bundle directory name and the config.developer_name field. Repeatable.',
+        }),
+        ascii: Flags.boolean({
+            default: false,
+            summary: 'Force ASCII-only output in the text renderer (no Unicode box chars, no emoji).',
+        }),
+        'fail-on': Flags.integer({
+            min: 1,
+            summary: 'Exit non-zero if combined agent+Apex CC meets or exceeds this threshold.',
+        }),
+        format: Flags.string({
+            default: 'text',
+            options: [...FORMATS],
+            summary: 'Non-JSON output format. --json takes precedence per SF CLI convention.',
+        }),
+        'no-color': Flags.boolean({
+            default: false,
+            summary: 'Disable ANSI color in the text renderer. NO_COLOR env also disables.',
+        }),
+        'sarif-error': Flags.integer({
+            min: 1,
+            summary: 'SARIF "error" level threshold. Default 20.',
+        }),
+        'sarif-warning': Flags.integer({
+            min: 1,
+            summary: 'SARIF "warning" level threshold. Default 10.',
+        }),
+        'source-dir': Flags.string({
+            char: 'd',
+            summary: 'Directory or single .agent file to analyze. Defaults to the packageDirectories of the nearest sfdx-project.json.',
+        }),
+        width: Flags.integer({
+            default: 60,
+            min: 20,
+            summary: 'Rule width for the text renderer.',
+        }),
+    };
+    static summary = 'Compute McCabe cyclomatic complexity and action-reference inventory for AgentScript bundles and their Apex backing logic.';
+    async run() {
+        const { flags } = await this.parse(AgentpmdAnalyze);
+        const { reportBase, roots, sourceDescription } = await resolveSources(flags['source-dir']);
+        if (!this.jsonEnabled() && sourceDescription) {
+            this.log(sourceDescription);
+        }
+        const report = await analyzeSource(roots, {
+            apexSourceOverride: flags['apex-source'],
+            apiNames: flags['api-name'],
+            reportBase,
+        });
+        if (!this.jsonEnabled()) {
+            const format = flags.format;
+            const text = render(format, report, {
+                ascii: flags.ascii || undefined,
+                color: flags['no-color'] ? false : undefined,
+                sarifErrorThreshold: flags['sarif-error'],
+                sarifWarningThreshold: flags['sarif-warning'],
+                width: flags.width,
+            });
+            this.log(text);
+        }
+        const combined = report.totalComplexity + report.totalApexComplexity;
+        if (flags['fail-on'] !== undefined && combined >= flags['fail-on']) {
+            this.error(`Combined cyclomatic complexity ${combined} (agent ${report.totalComplexity} + apex ${report.totalApexComplexity}) ≥ threshold ${flags['fail-on']}`, { exit: 2 });
+        }
+        return report;
+    }
+}
+/**
+ * Resolve the directories we should scan. Explicit `--source-dir` wins.
+ * Otherwise, walk up from cwd looking for `sfdx-project.json` and use its
+ * `packageDirectories`. If neither is available, fail with a clear message.
+ */
+async function resolveSources(sourceDirFlag) {
+    if (sourceDirFlag) {
+        return { reportBase: undefined, roots: [sourceDirFlag] };
+    }
+    const project = await discoverSfdxProject(process.cwd());
+    if (!project) {
+        throw new Error('No --source-dir was provided and no sfdx-project.json was found in the ' +
+            'current directory or any ancestor. Pass --source-dir <path> or run from ' +
+            'inside an sfdx project.');
+    }
+    if (project.packageDirectories.length === 0) {
+        throw new Error(`sfdx-project.json at ${project.root} declares no packageDirectories. ` +
+            'Pass --source-dir <path> explicitly.');
+    }
+    return {
+        reportBase: project.root,
+        roots: project.packageDirectories,
+        sourceDescription: `Analyzing sfdx project ${project.root} (${project.packageDirectories.length} package director${project.packageDirectories.length === 1 ? 'y' : 'ies'}).`,
+    };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/commands/agentpmd/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../../src/commands/agentpmd/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAK/D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAElD,MAAM,OAAO,GAAgC,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAElF,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,SAAyB;IAC7D,MAAM,CAAU,WAAW,GAAG;;;;;;;;;uBAShB,CAAC;IACjB,MAAM,CAAU,QAAQ,GAAG;QAC9B,yEAAyE;QACzE,gFAAgF;QAChF,uGAAuG;QACvG,uGAAuG;KACxG,CAAC;IACG,MAAM,CAAU,KAAK,GAAG;QAC3B,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC;YAC1B,OAAO,EACL,mIAAmI;SACtI,CAAC;QACF,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC;YACvB,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;YACd,OAAO,EACL,8HAA8H;SACjI,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,OAAO,EAAE,KAAK;YACd,OAAO,EACL,gFAAgF;SACnF,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC;YACvB,GAAG,EAAE,CAAC;YACN,OAAO,EACL,0EAA0E;SAC7E,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;YACrB,OAAO,EACL,wEAAwE;SAC3E,CAAC;QACF,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC;YACxB,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,sEAAsE;SAChF,CAAC;QACF,aAAa,EAAE,KAAK,CAAC,OAAO,CAAC;YAC3B,GAAG,EAAE,CAAC;YACN,OAAO,EAAE,4CAA4C;SACtD,CAAC;QACF,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC;YAC7B,GAAG,EAAE,CAAC;YACN,OAAO,EAAE,8CAA8C;SACxD,CAAC;QACF,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC;YACzB,IAAI,EAAE,GAAG;YACT,OAAO,EACL,kHAAkH;SACrH,CAAC;QACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,OAAO,EAAE,EAAE;YACX,GAAG,EAAE,EAAE;YACP,OAAO,EAAE,mCAAmC;SAC7C,CAAC;KACH,CAAC;IACG,MAAM,CAAU,OAAO,GAC1B,2HAA2H,CAAC;IAEvH,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAEpD,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,cAAc,CACnE,KAAK,CAAC,YAAY,CAAC,CACpB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,iBAAiB,EAAE,CAAC;YAC7C,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE;YACxC,kBAAkB,EAAE,KAAK,CAAC,aAAa,CAAC;YACxC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC;YAC3B,UAAU;SACX,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAsB,CAAC;YAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE;gBAClC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,SAAS;gBAC/B,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBAC5C,mBAAmB,EAAE,KAAK,CAAC,aAAa,CAAC;gBACzC,qBAAqB,EAAE,KAAK,CAAC,eAAe,CAAC;gBAC7C,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,mBAAmB,CAAC;QACrE,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,KAAK,CACR,kCAAkC,QAAQ,WAAW,MAAM,CAAC,eAAe,WAAW,MAAM,CAAC,mBAAmB,iBAAiB,KAAK,CAAC,SAAS,CAAC,EAAE,EACnJ,EAAE,IAAI,EAAE,CAAC,EAAE,CACZ,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;;AAUH;;;;GAIG;AACH,KAAK,UAAU,cAAc,CAC3B,aAAiC;IAEjC,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,yEAAyE;YACvE,0EAA0E;YAC1E,yBAAyB,CAC5B,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,wBAAwB,OAAO,CAAC,IAAI,mCAAmC;YACrE,sCAAsC,CACzC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,IAAI;QACxB,KAAK,EAAE,OAAO,CAAC,kBAAkB;QACjC,iBAAiB,EAAE,0BAA0B,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,kBAAkB,CAAC,MAAM,oBAAoB,OAAO,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI;KAC7K,CAAC;AACJ,CAAC"}

package/dist/commands/agentpmd/install-skill.d.ts

@@ -0,0 +1,11 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+export default class AgentpmdInstallSkill extends SfCommand<{
+    installed: string;
+}> {
+    static readonly 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.";
+    static readonly examples: string[];
+    static readonly summary = "Install the agentforcepmd Claude Code skill to ~/.claude/skills/.";
+    run(): Promise<{
+        installed: string;
+    }>;
+}

package/dist/commands/agentpmd/install-skill.js

@@ -0,0 +1,33 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { existsSync } from 'node:fs';
+// `cp` is stable since Node 16.7; the plugin runtime targets Node >= 20.
+// eslint-disable-next-line n/no-unsupported-features/node-builtins
+import { cp } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const SKILL_DEST = join(homedir(), '.claude', 'skills', 'agentforcepmd');
+export default class AgentpmdInstallSkill extends SfCommand {
+    static description = `Recursively copies the bundled skill tree (SKILL.md plus its references/
+pages) to ~/.claude/skills/agentforcepmd/ so Claude Code can use it as a
+skill. Restart Claude Code (or reload skills) afterward to activate it.`;
+    static examples = ['$ sf agentpmd install-skill'];
+    static summary = 'Install the agentforcepmd Claude Code skill to ~/.claude/skills/.';
+    async run() {
+        // Resolve the skill source relative to this package's installed location.
+        // Compiled file lives at dist/commands/agentpmd/install-skill.js. Joining
+        // '..' from the file path strips the filename first, so reaching the
+        // package root (above dist/) takes four hops: install-skill.js → agentpmd
+        // → commands → dist → <pkgRoot>.
+        const pkgRoot = join(fileURLToPath(import.meta.url), '..', '..', '..', '..');
+        const skillSrc = join(pkgRoot, 'skill');
+        if (!existsSync(skillSrc)) {
+            this.error(`Skill source not found at ${skillSrc} — is the package installed correctly?`);
+        }
+        await cp(skillSrc, SKILL_DEST, { recursive: true });
+        this.log(`Skill installed to ${SKILL_DEST}`);
+        this.log('Restart Claude Code (or reload skills) to activate.');
+        return { installed: SKILL_DEST };
+    }
+}
+//# sourceMappingURL=install-skill.js.map

package/dist/commands/agentpmd/install-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-skill.js","sourceRoot":"","sources":["../../../src/commands/agentpmd/install-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,yEAAyE;AACzE,mEAAmE;AACnE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;AAEzE,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,SAAgC;IACzE,MAAM,CAAU,WAAW,GAAG;;wEAEiC,CAAC;IAChE,MAAM,CAAU,QAAQ,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC3D,MAAM,CAAU,OAAO,GAAG,mEAAmE,CAAC;IAE9F,KAAK,CAAC,GAAG;QACd,0EAA0E;QAC1E,0EAA0E;QAC1E,qEAAqE;QACrE,0EAA0E;QAC1E,iCAAiC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAExC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,6BAA6B,QAAQ,wCAAwC,CAAC,CAAC;QAC5F,CAAC;QAED,MAAM,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,IAAI,CAAC,GAAG,CAAC,sBAAsB,UAAU,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;QAEhE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IACnC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { analyzeSource } from './analyzer/analyze.js';
+export type { ActionReference, AnalysisReport, FileReport, ProcedureCC } from './analyzer/types.js';
+export { default as AgentpmdAnalyze } from './commands/agentpmd/analyze.js';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { analyzeSource } from './analyzer/analyze.js';
+export { default as AgentpmdAnalyze } from './commands/agentpmd/analyze.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/renderers/csv.d.ts

@@ -0,0 +1,6 @@
+import type { AnalysisReport } from '../analyzer/types.js';
+/**
+ * Single CSV with all per-procedure and per-method rows so a spreadsheet
+ * can pivot on `type` and `file`. RFC 4180-quoted; first row is the header.
+ */
+export declare function renderCsv(report: AnalysisReport): string;

package/dist/renderers/csv.js

@@ -0,0 +1,78 @@
+/**
+ * Single CSV with all per-procedure and per-method rows so a spreadsheet
+ * can pivot on `type` and `file`. RFC 4180-quoted; first row is the header.
+ */
+export function renderCsv(report) {
+    const lines = [];
+    lines.push([
+        'type',
+        'file',
+        'scope_or_class',
+        'name',
+        'complexity',
+        'start_row',
+        'start_col',
+        'contributors',
+    ]
+        .map((c) => csvCell(c))
+        .join(','));
+    for (const f of report.files) {
+        for (const p of f.procedures) {
+            lines.push([
+                'agent_procedure',
+                f.path,
+                p.scope,
+                p.kind,
+                String(p.complexity),
+                String(p.location.startRow),
+                String(p.location.startCol),
+                breakdownProc(p.contributors),
+            ]
+                .map((c) => csvCell(c))
+                .join(','));
+        }
+    }
+    for (const cls of report.apexClasses) {
+        for (const m of cls.methods) {
+            lines.push([
+                'apex_method',
+                cls.path,
+                cls.className,
+                m.signature,
+                String(m.complexity),
+                String(m.location.startRow),
+                String(m.location.startCol),
+                breakdownApex(m.contributors),
+            ]
+                .map((c) => csvCell(c))
+                .join(','));
+        }
+    }
+    return lines.join('\n');
+}
+function csvCell(v) {
+    // Always quote — keeps the output uniform and lets cells contain
+    // commas, quotes, and newlines without per-cell branching.
+    return `"${v.replaceAll('"', '""')}"`;
+}
+function breakdownProc(contributors) {
+    if (contributors.length === 0)
+        return 'base';
+    const counts = {};
+    for (const c of contributors)
+        counts[c.kind] = (counts[c.kind] ?? 0) + 1;
+    return Object.entries(counts)
+        .map(([k, n]) => `${k}=${n}`)
+        .join(';');
+}
+function breakdownApex(contributors) {
+    if (contributors.length === 0)
+        return 'base';
+    const counts = {};
+    for (const c of contributors)
+        counts[c.kind] = (counts[c.kind] ?? 0) + 1;
+    return Object.entries(counts)
+        .map(([k, n]) => `${k}=${n}`)
+        .join(';');
+}
+//# sourceMappingURL=csv.js.map

package/dist/renderers/csv.js.map

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

package/dist/renderers/index.d.ts

@@ -0,0 +1,8 @@
+import type { AnalysisReport } from '../analyzer/types.js';
+import type { RenderFormat, RenderOptions } from './options.js';
+export declare function render(format: RenderFormat, report: AnalysisReport, options?: RenderOptions): string;
+export { renderCsv } from './csv.js';
+export { renderMarkdown } from './markdown.js';
+export type { RenderFormat, RenderOptions } from './options.js';
+export { renderSarif } from './sarif.js';
+export { renderText } from './text.js';

package/dist/renderers/index.js

@@ -0,0 +1,25 @@
+import { renderCsv } from './csv.js';
+import { renderMarkdown } from './markdown.js';
+import { renderSarif } from './sarif.js';
+import { renderText } from './text.js';
+export function render(format, report, options) {
+    switch (format) {
+        case 'csv': {
+            return renderCsv(report);
+        }
+        case 'markdown': {
+            return renderMarkdown(report);
+        }
+        case 'sarif': {
+            return renderSarif(report, options);
+        }
+        case 'text': {
+            return renderText(report, options);
+        }
+    }
+}
+export { renderCsv } from './csv.js';
+export { renderMarkdown } from './markdown.js';
+export { renderSarif } from './sarif.js';
+export { renderText } from './text.js';
+//# sourceMappingURL=index.js.map

package/dist/renderers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/renderers/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,UAAU,MAAM,CACpB,MAAoB,EACpB,MAAsB,EACtB,OAAuB;IAEvB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,OAAO,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,OAAO,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;AACH,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/renderers/markdown.d.ts

@@ -0,0 +1,12 @@
+import type { AnalysisReport } from '../analyzer/types.js';
+/**
+ * Renders a GFM Markdown report with a Mermaid bar chart at the top
+ * (agent CC vs Apex CC per bundle) followed by per-bundle and per-class
+ * drilldown tables. Designed to be portable into PR descriptions, gists,
+ * Slack snippets, and whitepaper appendices.
+ *
+ * Palette is whitepaper § 1: Reasoning hot (#a82820), Conversation amber
+ * (#c4942a), Deterministic green (#6b8c52), Scaffolding cool gray (#9aa5ad).
+ */
+export declare function renderMarkdown(report: AnalysisReport): string;
+export { type ApexClassReport } from '../analyzer/types.js';

package/dist/renderers/markdown.js

@@ -0,0 +1,233 @@
+const KIND_LABEL = {
+    after_reasoning: 'after_reasoning',
+    available_when: 'available_when',
+    before_reasoning: 'before_reasoning',
+    other: 'other',
+    reasoning_instructions: 'reasoning.instructions',
+};
+/**
+ * Renders a GFM Markdown report with a Mermaid bar chart at the top
+ * (agent CC vs Apex CC per bundle) followed by per-bundle and per-class
+ * drilldown tables. Designed to be portable into PR descriptions, gists,
+ * Slack snippets, and whitepaper appendices.
+ *
+ * Palette is whitepaper § 1: Reasoning hot (#a82820), Conversation amber
+ * (#c4942a), Deterministic green (#6b8c52), Scaffolding cool gray (#9aa5ad).
+ */
+export function renderMarkdown(report) {
+    const lines = [];
+    lines.push('# AgentForce PMD — Cyclomatic Complexity (McCabe)', '', 'Per the categorization rule § 7, CC is reported by the standard ' +
+        'McCabe convention used in SonarQube / PMD / Checkstyle for the ' +
+        'relevant language.', '');
+    if (report.files.length === 0) {
+        lines.push('_(no `.agent` files found)_');
+        return lines.join('\n');
+    }
+    // ── CC by location chart ──────────────────────────────────────────
+    lines.push('## CC by location', '', renderMermaid(report), '', `| | AgentScript | Apex | Combined |\n` +
+        `| --- | ---: | ---: | ---: |\n` +
+        `| **Totals** | ${report.totalComplexity} | ${report.totalApexComplexity} | ${report.totalComplexity + report.totalApexComplexity} |`, '', '## Per-bundle (`.agent` files)', '');
+    for (const f of report.files) {
+        lines.push(`### \`${f.path}\` — CC = ${f.fileComplexity}`, '');
+        if (f.procedures.length === 0) {
+            lines.push('_(no procedure-bearing scopes)_');
+        }
+        else {
+            lines.push('| Scope | Procedure | CC | Contributors |', '| --- | --- | ---: | --- |');
+            for (const p of f.procedures) {
+                lines.push(`| ${escapeCell(p.scope)} | ${KIND_LABEL[p.kind]} | ${p.complexity} | ${escapeCell(breakdownProc(p.contributors))} |`);
+            }
+        }
+        lines.push('');
+        if (f.declarations.length > 0) {
+            lines.push('**Action references**', '', '| Action | Target kind | Target | Uses |', '| --- | --- | --- | ---: |');
+            const usage = countReferences(f);
+            for (const d of f.declarations) {
+                const used = usage.get(d.name) ?? 0;
+                lines.push(`| \`${d.name}\` | ${d.targetKind} | ${d.target ?? '_n/a_'} | ${used} |`);
+            }
+            const undeclared = listUndeclaredRefs(f);
+            if (undeclared.length > 0) {
+                lines.push('', 'Referenced but not declared in-file: ' + undeclared.map(u => `\`${u}\``).join(', '));
+            }
+            lines.push('');
+        }
+    }
+    // ── Apex backing logic ────────────────────────────────────────────
+    if (report.apexClasses.length > 0 || report.unresolvedApexTargets.length > 0) {
+        lines.push('## Apex backing logic', '');
+        for (const cls of report.apexClasses) {
+            lines.push(`### \`${cls.path}\` — class CC = ${cls.classComplexity}`, '', `Referenced by: ${cls.referencedBy.map(r => `\`${r}\``).join(', ') || '_none_'}`, '');
+            if (cls.methods.length === 0) {
+                lines.push('_(no methods with bodies)_');
+            }
+            else {
+                lines.push('| Method | CC | Contributors |', '| --- | ---: | --- |');
+                for (const m of cls.methods) {
+                    lines.push(`| \`${escapeCell(m.signature)}\` | ${m.complexity} | ${escapeCell(breakdownApex(m.contributors))} |`);
+                }
+            }
+            lines.push('');
+        }
+        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('');
+        }
+    }
+    // ── Footer ────────────────────────────────────────────────────────
+    lines.push('---', '', `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 renderMermaid(report) {
+    // Per-bundle agent CC + the sum of Apex CC for classes that bundle
+    // references. We compute that mapping rather than counting classes
+    // globally so each bundle's bar reflects its full "implementation
+    // CC" footprint.
+    const apexByBundle = new Map();
+    for (const cls of report.apexClasses) {
+        for (const ref of cls.referencedBy) {
+            apexByBundle.set(ref, (apexByBundle.get(ref) ?? 0) + cls.classComplexity);
+        }
+    }
+    const labels = [];
+    const agentVals = [];
+    const apexVals = [];
+    for (const f of report.files) {
+        labels.push(shortBundleLabel(f.path));
+        agentVals.push(f.fileComplexity);
+        apexVals.push(apexByBundle.get(f.path) ?? 0);
+    }
+    // Mermaid xychart-beta supports stacked-bar style via two series.
+    // Palette: AgentScript = Reasoning red (#a82820); Apex = Deterministic green (#6b8c52).
+    return [
+        '```mermaid',
+        '%%{init: {"theme":"base","themeVariables":{"xyChart":{"plotColorPalette":"#a82820, #6b8c52"}}}}%%',
+        'xychart-beta',
+        '    title "CC by location, per .agent bundle"',
+        `    x-axis [${labels.map(l => `"${l}"`).join(', ')}]`,
+        `    y-axis "Cyclomatic complexity"`,
+        `    bar [${agentVals.join(', ')}]`,
+        `    bar [${apexVals.join(', ')}]`,
+        '```',
+        '',
+        '<sub>Series: **AgentScript CC** (red, whitepaper "Reasoning Logic") · **Apex CC** (green, whitepaper "Deterministic Logic"). Apex CC per bundle is the sum of the CC of every `apex://` class that bundle references; classes referenced by multiple bundles contribute to each.</sub>',
+    ].join('\n');
+}
+function shortBundleLabel(path) {
+    // Strip "aiAuthoringBundles/" and the trailing ".agent" to keep x-axis tight.
+    const stripped = path
+        .replace(/^.*aiAuthoringBundles\//, '')
+        .replace(/\.agent$/, '');
+    // Use only the basename if it appears twice (Bundle/Bundle.agent → Bundle).
+    const parts = stripped.split('/');
+    if (parts.length === 2 && parts[0] === parts[1])
+        return parts[0];
+    return parts.join('/');
+}
+function breakdownProc(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]) => `${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 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;
+}
+function escapeCell(s) {
+    // GFM table cells: escape pipes and turn embedded newlines into <br>.
+    return s.replaceAll('|', String.raw `\|`).replaceAll('\n', '<br>');
+}
+//# sourceMappingURL=markdown.js.map

package/dist/renderers/markdown.js.map

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

package/dist/renderers/options.d.ts

@@ -0,0 +1,20 @@
+import type { AnalysisReport } from '../analyzer/types.js';
+export type RenderFormat = 'csv' | 'markdown' | 'sarif' | 'text';
+export interface RenderOptions {
+    /** Force ASCII-only output (no Unicode box chars, no emoji). Default: auto. */
+    ascii?: boolean;
+    /** Force/disable color in text output. Default: auto (TTY + no NO_COLOR). */
+    color?: boolean;
+    sarifErrorThreshold?: number;
+    /**
+     * SARIF severity thresholds. Methods/procedures with complexity at or above
+     * `warning` are flagged `level: warning`; at or above `error` → `level: error`.
+     * Default: warning=10, error=20 (matches PMD's methodReportLevel default).
+     */
+    sarifWarningThreshold?: number;
+    /** Rule width for the text renderer. Default: 60. */
+    width?: number;
+}
+export interface Renderer {
+    render(report: AnalysisReport, options?: RenderOptions): string;
+}

package/dist/renderers/options.js

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

package/dist/renderers/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/renderers/options.ts"],"names":[],"mappings":""}

package/dist/renderers/sarif.d.ts

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