sf-agentpmd 0.1.0

package/dist/analyzer/apex-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apex-resolve.js","sourceRoot":"","sources":["../../src/analyzer/apex-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEpE,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAEtC,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,0EAA0E;IAC1E,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC;AAmBD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAiB,EACjB,IAAoB;IAEpB,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC;YAClD,CAAC,CAAC,IAAI,CAAC,kBAAkB;YACzB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACrC,UAAU,CAAC,IAAI,CACb,IAAI,CAAC,QAAQ,EAAE,GAAG,SAAS,MAAM,CAAC,EAClC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,MAAM,CAAC,CAC9C,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACzC,IAAI,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAC/C,OAAO,IAAI,EAAE,CAAC;QACZ,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,SAAS,MAAM,CAAC,CAAC,CAAC;QAC1D,IAAI,GAAG,KAAK,IAAI;YAAE,MAAM;QACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,EAAE,MAAM,EAAE;YAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,MAAc;IACnD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;AACrD,CAAC"}

package/dist/analyzer/complexity.d.ts

@@ -0,0 +1,30 @@
+import type { SyntaxNode } from '@agentscript/types';
+import type { ProcedureCC, SourceLocation } from './types.js';
+export declare function complexityOf(body: SyntaxNode, scope: string, kind: ProcedureCC['kind']): ProcedureCC;
+/**
+ * Identify the procedure-bearing blocks in a single topic / start_agent /
+ * subagent scope. AgentScript's three control-flow surfaces are:
+ *   • before_reasoning: <procedure>     (deterministic, pre-LLM)
+ *   • after_reasoning:  <procedure>     (deterministic, post-LLM)
+ *   • reasoning.instructions: -> <template body>  (LLM-evaluated)
+ *
+ * v1 walks all three for CC. (instructions: -> body holds Reasoning Logic per
+ * whitepaper § 4 but the CC convention itself is language-neutral.)
+ */
+export declare function collectProcedures(scopeBody: SyntaxNode, scopeLabel: string): ProcedureCC[];
+export interface AgentScope {
+    body: SyntaxNode;
+    kind: string;
+    label: string;
+}
+/**
+ * Find topic/start_agent/subagent scopes anywhere in the tree. They appear
+ * at the source-file level as mapping_elements whose key kind matches.
+ */
+export declare function collectScopes(root: SyntaxNode): AgentScope[];
+export interface FileComplexity {
+    procedures: ProcedureCC[];
+    total: number;
+}
+export declare function complexityForFile(root: SyntaxNode): FileComplexity;
+export declare function dummyLoc(): SourceLocation;

package/dist/analyzer/complexity.js

@@ -0,0 +1,126 @@
+import { bodyOf, descendants, findMappingEntry, keyHeader, locOf } from './parse.js';
+/**
+ * Standard McCabe CC, applied to AgentScript control-flow nodes.
+ *
+ * Per the categorization whitepaper (§ 7) the convention mirrors
+ * SonarQube/PMD/Checkstyle for the relevant language:
+ *
+ *   CC = 1
+ *      + count(if_statement)
+ *      + count(elif_clause)
+ *      + count(ternary_expression)
+ *      + count(binary_expression where operator ∈ {and, or})
+ *
+ * We do NOT count: else_clause, comparison_expression, set/run/transition,
+ * try/catch (AgentScript has none), default branches.
+ */
+const SHORT_CIRCUIT_OPS = new Set(['and', 'or']);
+export function complexityOf(body, scope, kind) {
+    const contributors = [];
+    for (const n of descendants(body)) {
+        switch (n.type) {
+            case 'binary_expression': {
+                const op = binaryOperator(n);
+                if (op === 'and')
+                    contributors.push({ kind: 'short_circuit_and', location: locOf(n) });
+                else if (op === 'or')
+                    contributors.push({ kind: 'short_circuit_or', location: locOf(n) });
+                break;
+            }
+            case 'elif_clause': {
+                contributors.push({ kind: 'elif_clause', location: locOf(n) });
+                break;
+            }
+            case 'if_statement': {
+                contributors.push({ kind: 'if_statement', location: locOf(n) });
+                break;
+            }
+            case 'ternary_expression': {
+                contributors.push({ kind: 'ternary_expression', location: locOf(n) });
+                break;
+            }
+        }
+    }
+    return {
+        complexity: 1 + contributors.length,
+        contributors,
+        kind,
+        location: locOf(body),
+        scope,
+    };
+}
+function binaryOperator(n) {
+    for (const c of n.children) {
+        if (!c.isNamed && SHORT_CIRCUIT_OPS.has(c.type))
+            return c.type;
+        if (!c.isNamed && (c.type === '+' || c.type === '-' || c.type === '*' || c.type === '/'))
+            return c.type;
+    }
+    return undefined;
+}
+/**
+ * Identify the procedure-bearing blocks in a single topic / start_agent /
+ * subagent scope. AgentScript's three control-flow surfaces are:
+ *   • before_reasoning: <procedure>     (deterministic, pre-LLM)
+ *   • after_reasoning:  <procedure>     (deterministic, post-LLM)
+ *   • reasoning.instructions: -> <template body>  (LLM-evaluated)
+ *
+ * v1 walks all three for CC. (instructions: -> body holds Reasoning Logic per
+ * whitepaper § 4 but the CC convention itself is language-neutral.)
+ */
+export function collectProcedures(scopeBody, scopeLabel) {
+    const out = [];
+    const before = findMappingEntry(scopeBody, 'before_reasoning');
+    if (before)
+        out.push(complexityOf(before, scopeLabel, 'before_reasoning'));
+    const after = findMappingEntry(scopeBody, 'after_reasoning');
+    if (after)
+        out.push(complexityOf(after, scopeLabel, 'after_reasoning'));
+    const reasoning = findMappingEntry(scopeBody, 'reasoning');
+    if (reasoning) {
+        const instructions = findMappingEntry(reasoning, 'instructions');
+        if (instructions) {
+            out.push(complexityOf(instructions, scopeLabel, 'reasoning_instructions'));
+        }
+    }
+    return out;
+}
+/** Scopes that contain procedure-bearing blocks. */
+const PROCEDURE_SCOPES = new Set(['start_agent', 'subagent', 'topic']);
+/**
+ * Find topic/start_agent/subagent scopes anywhere in the tree. They appear
+ * at the source-file level as mapping_elements whose key kind matches.
+ */
+export function collectScopes(root) {
+    const scopes = [];
+    // The source_file has a single top-level `mapping` child holding the agent
+    // declarations (system, config, variables, start_agent X, topic Y, …).
+    const topMapping = root.namedChildren.find(c => c.type === 'mapping') ?? root;
+    for (const c of topMapping.namedChildren) {
+        if (c.type !== 'mapping_element')
+            continue;
+        const keyNode = c.childForFieldName('key') ?? c.namedChildren.find(n => n.type === 'key');
+        if (!keyNode)
+            continue;
+        const h = keyHeader(keyNode);
+        if (!h || !PROCEDURE_SCOPES.has(h.kind))
+            continue;
+        const body = bodyOf(keyNode);
+        if (!body)
+            continue;
+        scopes.push({ body, kind: h.kind, label: `${h.kind} ${h.label ?? ''}`.trim() });
+    }
+    return scopes;
+}
+export function complexityForFile(root) {
+    const procedures = [];
+    for (const s of collectScopes(root)) {
+        procedures.push(...collectProcedures(s.body, s.label));
+    }
+    const total = procedures.reduce((acc, p) => acc + p.complexity, 0);
+    return { procedures, total };
+}
+export function dummyLoc() {
+    return { endCol: 0, endRow: 0, startCol: 0, startRow: 0 };
+}
+//# sourceMappingURL=complexity.js.map

package/dist/analyzer/complexity.js.map

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

package/dist/analyzer/parse.d.ts

@@ -0,0 +1,51 @@
+import type { SyntaxNode } from '@agentscript/types';
+export declare function parseAgentSource(source: string): SyntaxNode;
+export declare function locOf(n: SyntaxNode): {
+    endCol: number;
+    endRow: number;
+    startCol: number;
+    startRow: number;
+};
+export declare function walk(node: SyntaxNode, visit: (n: SyntaxNode) => void): void;
+export declare function descendants(node: SyntaxNode): Generator<SyntaxNode>;
+/**
+ * The block header for a `key` node. AgentScript keys can be plain (`config`)
+ * or named (`topic case_creation`, `start_agent customer_verification`).
+ * We return the first whitespace-delimited token as the key kind, and the
+ * remainder (if any) as the instance label.
+ */
+export declare function keyHeader(n: SyntaxNode): null | {
+    kind: string;
+    label?: string;
+};
+/**
+ * The CST shapes a key/value pair as `mapping_element { key, ':', value }`.
+ * Given the mapping_element node, return its key kind + label.
+ */
+export declare function mappingKeyHeader(m: SyntaxNode): null | {
+    kind: string;
+    label?: string;
+};
+export declare function mappingValue(m: SyntaxNode): SyntaxNode | undefined;
+/**
+ * Within a scope whose body is a `mapping` (the typical case for topic/
+ * start_agent/subagent blocks), find the mapping_element whose key matches
+ * `kind`, and return its value subtree.
+ */
+export declare function findMappingEntry(parentBody: SyntaxNode, kind: string): SyntaxNode | undefined;
+/**
+ * Walk a scope-key node (topic / start_agent / subagent at top level) and
+ * return its body — the `mapping` that holds before_reasoning, after_reasoning,
+ * reasoning, actions, etc. The scope-key itself lives inside a mapping_element
+ * at the source-file level; the body is the sibling value.
+ */
+export declare function bodyOf(scopeKey: SyntaxNode): SyntaxNode | undefined;
+/**
+ * Read the `developer_name:` value from the `config:` block of a parsed
+ * .agent file. This is the canonical API name of the agent (matches what
+ * `sf agent generate authoring-bundle --api-name X` produces). Returns
+ * undefined when the field is absent or empty.
+ */
+export declare function extractDeveloperName(root: SyntaxNode): string | undefined;
+/** Convenience: extract a leaf string literal text (without surrounding quotes). */
+export declare function extractStringLiteral(n: SyntaxNode): string | undefined;

package/dist/analyzer/parse.js

@@ -0,0 +1,143 @@
+import { parse as parseAgent } from '@agentscript/parser-javascript';
+export function parseAgentSource(source) {
+    return parseAgent(source).rootNode;
+}
+export function locOf(n) {
+    return {
+        endCol: n.endCol,
+        endRow: n.endRow,
+        startCol: n.startCol,
+        startRow: n.startRow,
+    };
+}
+export function walk(node, visit) {
+    visit(node);
+    for (const c of node.namedChildren)
+        walk(c, visit);
+}
+export function* descendants(node) {
+    yield node;
+    for (const c of node.namedChildren)
+        yield* descendants(c);
+}
+/**
+ * The block header for a `key` node. AgentScript keys can be plain (`config`)
+ * or named (`topic case_creation`, `start_agent customer_verification`).
+ * We return the first whitespace-delimited token as the key kind, and the
+ * remainder (if any) as the instance label.
+ */
+export function keyHeader(n) {
+    if (n.type !== 'key')
+        return null;
+    const head = n.text.split('\n', 1)[0];
+    const colon = head.indexOf(':');
+    const lhs = (colon === -1 ? head : head.slice(0, colon)).trim();
+    const parts = lhs.split(/\s+/);
+    return { kind: parts[0], label: parts.length > 1 ? parts.slice(1).join(' ') : undefined };
+}
+/**
+ * The CST shapes a key/value pair as `mapping_element { key, ':', value }`.
+ * Given the mapping_element node, return its key kind + label.
+ */
+export function mappingKeyHeader(m) {
+    if (m.type !== 'mapping_element')
+        return null;
+    const keyNode = m.childForFieldName('key');
+    if (!keyNode) {
+        // Fall back: first namedChild of type 'key'.
+        for (const c of m.namedChildren) {
+            if (c.type === 'key')
+                return keyHeader(c);
+        }
+        return null;
+    }
+    return keyHeader(keyNode);
+}
+/**
+ * The value-bearing child of a mapping_element. Could be `mapping` (sub-block),
+ * `expression_with_to` (scalar/expression), `colinear_value`, `procedure`,
+ * `variable_declaration`, etc.
+ *
+ * A mapping_element can interleave leading `comment` nodes between the `:`/`->`
+ * markers and the actual value-bearing child. Skip them so we don't return a
+ * comment as the "value."
+ */
+const NON_VALUE_NAMED_TYPES = new Set(['comment', 'key']);
+export function mappingValue(m) {
+    if (m.type !== 'mapping_element')
+        return undefined;
+    for (const c of m.namedChildren) {
+        if (!NON_VALUE_NAMED_TYPES.has(c.type))
+            return c;
+    }
+    return undefined;
+}
+/**
+ * Within a scope whose body is a `mapping` (the typical case for topic/
+ * start_agent/subagent blocks), find the mapping_element whose key matches
+ * `kind`, and return its value subtree.
+ */
+export function findMappingEntry(parentBody, kind) {
+    for (const c of parentBody.namedChildren) {
+        if (c.type !== 'mapping_element')
+            continue;
+        const h = mappingKeyHeader(c);
+        if (h && h.kind === kind)
+            return mappingValue(c);
+    }
+    return undefined;
+}
+/**
+ * Walk a scope-key node (topic / start_agent / subagent at top level) and
+ * return its body — the `mapping` that holds before_reasoning, after_reasoning,
+ * reasoning, actions, etc. The scope-key itself lives inside a mapping_element
+ * at the source-file level; the body is the sibling value.
+ */
+export function bodyOf(scopeKey) {
+    const { parent } = scopeKey;
+    if (!parent)
+        return undefined;
+    return mappingValue(parent);
+}
+/**
+ * Read the `developer_name:` value from the `config:` block of a parsed
+ * .agent file. This is the canonical API name of the agent (matches what
+ * `sf agent generate authoring-bundle --api-name X` produces). Returns
+ * undefined when the field is absent or empty.
+ */
+export function extractDeveloperName(root) {
+    const topMapping = root.namedChildren.find(c => c.type === 'mapping') ?? root;
+    for (const c of topMapping.namedChildren) {
+        if (c.type !== 'mapping_element')
+            continue;
+        const keyNode = c.childForFieldName('key') ?? c.namedChildren.find(n => n.type === 'key');
+        if (!keyNode)
+            continue;
+        const h = keyHeader(keyNode);
+        if (!h || h.kind !== 'config')
+            continue;
+        const body = mappingValue(c);
+        if (!body)
+            return undefined;
+        const devNameVal = findMappingEntry(body, 'developer_name');
+        if (!devNameVal)
+            return undefined;
+        return extractStringLiteral(devNameVal);
+    }
+    return undefined;
+}
+/** Convenience: extract a leaf string literal text (without surrounding quotes). */
+export function extractStringLiteral(n) {
+    for (const d of descendants(n)) {
+        if (d.type === 'string') {
+            const t = d.text;
+            if (t.startsWith('"') && t.endsWith('"'))
+                return t.slice(1, -1);
+            if (t.startsWith("'") && t.endsWith("'"))
+                return t.slice(1, -1);
+            return t;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=parse.js.map

package/dist/analyzer/parse.js.map

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

package/dist/analyzer/project.d.ts

@@ -0,0 +1,12 @@
+export interface SfdxProject {
+    /** Absolute paths of every `packageDirectories[].path`, in declaration order. */
+    packageDirectories: string[];
+    /** Absolute path of the project root (the directory containing sfdx-project.json). */
+    root: string;
+}
+/**
+ * Walk up from `startDir` until we find a directory containing
+ * `sfdx-project.json`, then return its root + resolved package directories.
+ * Returns undefined when no project is found.
+ */
+export declare function discoverSfdxProject(startDir: string): Promise<SfdxProject | undefined>;

package/dist/analyzer/project.js

@@ -0,0 +1,51 @@
+import { readFile, stat } from 'node:fs/promises';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+/**
+ * Walk up from `startDir` until we find a directory containing
+ * `sfdx-project.json`, then return its root + resolved package directories.
+ * Returns undefined when no project is found.
+ */
+export async function discoverSfdxProject(startDir) {
+    let dir = resolve(startDir);
+    while (true) {
+        const candidate = join(dir, 'sfdx-project.json');
+        const s = await stat(candidate).catch(() => { });
+        if (s?.isFile()) {
+            return readProject(dir, candidate);
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+async function readProject(root, jsonPath) {
+    const raw = await readFile(jsonPath, 'utf8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new Error(`failed to parse ${jsonPath}: ${error.message}`);
+    }
+    const pkgs = extractPackageDirectories(parsed, root);
+    return { packageDirectories: pkgs, root };
+}
+function extractPackageDirectories(parsed, root) {
+    if (!parsed || typeof parsed !== 'object')
+        return [];
+    const obj = parsed;
+    if (!Array.isArray(obj.packageDirectories))
+        return [];
+    const out = [];
+    for (const entry of obj.packageDirectories) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const pathField = entry.path;
+        if (typeof pathField !== 'string' || pathField.length === 0)
+            continue;
+        out.push(isAbsolute(pathField) ? pathField : resolve(root, pathField));
+    }
+    return out;
+}
+//# sourceMappingURL=project.js.map

package/dist/analyzer/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/analyzer/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAS/D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAgB;IAEhB,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;QACjD,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,SAAS,CAAC;QACrC,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,QAAgB;IACvD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,mBAAmB,QAAQ,KAAM,KAAe,CAAC,OAAO,EAAE,CAC3D,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,yBAAyB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrD,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,yBAAyB,CAAC,MAAe,EAAE,IAAY;IAC9D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACrD,MAAM,GAAG,GAAG,MAA0C,CAAC;IACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAAE,OAAO,EAAE,CAAC;IACtD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;QAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClD,MAAM,SAAS,GAAI,KAA4B,CAAC,IAAI,CAAC;QACrD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACtE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/analyzer/types.d.ts

@@ -0,0 +1,76 @@
+export interface SourceLocation {
+    endCol: number;
+    endRow: number;
+    startCol: number;
+    startRow: number;
+}
+export interface ProcedureCC {
+    complexity: number;
+    contributors: CCContributor[];
+    kind: 'after_reasoning' | 'available_when' | 'before_reasoning' | 'other' | 'reasoning_instructions';
+    location: SourceLocation;
+    scope: string;
+}
+export interface CCContributor {
+    kind: 'elif_clause' | 'if_statement' | 'short_circuit_and' | 'short_circuit_or' | 'ternary_expression';
+    location: SourceLocation;
+}
+export type ActionTargetKind = 'apex' | 'flow' | 'prompt' | 'unknown' | 'utils';
+export interface ActionDeclaration {
+    location: SourceLocation;
+    name: string;
+    scope: string;
+    target?: string;
+    targetKind: ActionTargetKind;
+}
+export type ActionReferenceContext = 'after_reasoning_run' | 'before_reasoning_run' | 'reasoning_actions' | 'reasoning_instructions_run' | 'transition' | 'unknown';
+export interface ActionReference {
+    context: ActionReferenceContext;
+    location: SourceLocation;
+    name: string;
+    scope: string;
+}
+export interface FileReport {
+    declarations: ActionDeclaration[];
+    fileComplexity: number;
+    parseErrors: ParseDiagnostic[];
+    path: string;
+    procedures: ProcedureCC[];
+    references: ActionReference[];
+}
+export interface ParseDiagnostic {
+    location: SourceLocation;
+    message: string;
+}
+export interface AnalysisReport {
+    apexClasses: ApexClassReport[];
+    byTargetKind: Record<ActionTargetKind, number>;
+    files: FileReport[];
+    totalApexComplexity: number;
+    totalComplexity: number;
+    totalDeclarations: number;
+    totalReferences: number;
+    unresolvedApexTargets: string[];
+}
+export type ApexCCContributorKind = 'catch_clause' | 'do_while_statement' | 'for_statement' | 'if_statement' | 'short_circuit_and' | 'short_circuit_or' | 'ternary' | 'when_arm' | 'while_statement';
+export interface ApexCCContributor {
+    kind: ApexCCContributorKind;
+    location: SourceLocation;
+}
+export interface ApexMethodCC {
+    complexity: number;
+    contributors: ApexCCContributor[];
+    kind: 'constructor' | 'method';
+    location: SourceLocation;
+    name: string;
+    signature: string;
+}
+export interface ApexClassReport {
+    classComplexity: number;
+    className: string;
+    methods: ApexMethodCC[];
+    parseErrors: ParseDiagnostic[];
+    path: string;
+    /** Bundles or actions whose target resolves here. */
+    referencedBy: string[];
+}

package/dist/analyzer/types.js

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

package/dist/analyzer/types.js.map

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

package/dist/commands/agentpmd/analyze.d.ts

@@ -0,0 +1,20 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import type { AnalysisReport } from '../../analyzer/types.js';
+export default class AgentpmdAnalyze extends SfCommand<AnalysisReport> {
+    static readonly 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.";
+    static readonly examples: string[];
+    static readonly flags: {
+        'apex-source': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-name': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        ascii: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'fail-on': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'no-color': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'sarif-error': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'sarif-warning': import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'source-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        width: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static readonly summary = "Compute McCabe cyclomatic complexity and action-reference inventory for AgentScript bundles and their Apex backing logic.";
+    run(): Promise<AnalysisReport>;
+}