sf-agentpmd 0.1.0 → 0.1.1

package/dist/analyzer/apex-complexity.js

@@ -1,133 +0,0 @@
-import { CatchClauseContext, CondExpressionContext, ConstructorDeclarationContext, DoWhileStatementContext, ForStatementContext, IfStatementContext, LogAndExpressionContext, LogOrExpressionContext, MethodDeclarationContext, WhenControlContext, WhileStatementContext, } from '@apexdevtools/apex-parser';
-import { locOfCtx, walkParseTree } from './apex-parse.js';
-/**
- * Standard McCabe Cyclomatic Complexity for Apex, per the SonarQube /
- * PMD CyclomaticComplexity convention used in the categorization
- * whitepaper § 7:
- *
- *   CC = 1
- *      + count(if)
- *      + count(for)        // includes enhanced-for (for-each)
- *      + count(while)
- *      + count(do-while)
- *      + count(when arm)   // each switch `when X { ... }`; `when else` excluded
- *      + count(catch)      // each catch clause
- *      + count(ternary ?:)
- *      + count(&&)
- *      + count(||)
- *
- * Not counted: else, when else, finally, try itself.
- */
-export function complexityOfMethod(methodCtx) {
-    const body = methodCtx.block();
-    const contributors = [];
-    if (body) {
-        walkParseTree(body, node => {
-            // Don't descend into nested methods/constructors — they have their
-            // own CC counted separately.
-            if (node !== methodCtx &&
-                (node instanceof MethodDeclarationContext ||
-                    node instanceof ConstructorDeclarationContext)) {
-                // walkParseTree will still recurse into this node's subtree.
-                // We can't easily prune, so we filter by parentage: skip
-                // contributors whose nearest enclosing method/ctor is not us.
-                return;
-            }
-            const kind = classifyContributor(node);
-            if (kind !== undefined && enclosingMethod(node) === methodCtx) {
-                contributors.push({ kind, location: locOfCtx(node) });
-            }
-        });
-    }
-    const name = methodCtx instanceof ConstructorDeclarationContext
-        ? methodCtx.qualifiedName()?.getText() ?? '<ctor>'
-        : methodCtx.id()?.getText() ?? '<anon>';
-    const signature = renderSignature(methodCtx, name);
-    return {
-        complexity: 1 + contributors.length,
-        contributors,
-        kind: methodCtx instanceof ConstructorDeclarationContext ? 'constructor' : 'method',
-        location: locOfCtx(methodCtx),
-        name,
-        signature,
-    };
-}
-function classifyContributor(node) {
-    if (node instanceof IfStatementContext)
-        return 'if_statement';
-    if (node instanceof ForStatementContext)
-        return 'for_statement';
-    if (node instanceof WhileStatementContext)
-        return 'while_statement';
-    if (node instanceof DoWhileStatementContext)
-        return 'do_while_statement';
-    if (node instanceof WhenControlContext) {
-        // `when else { ... }` is the default arm → don't count it.
-        const wv = node.whenValue();
-        const elseTok = wv && typeof wv.ELSE === 'function' ? wv.ELSE() : undefined;
-        return elseTok ? undefined : 'when_arm';
-    }
-    if (node instanceof CatchClauseContext)
-        return 'catch_clause';
-    if (node instanceof CondExpressionContext)
-        return 'ternary';
-    if (node instanceof LogAndExpressionContext)
-        return 'short_circuit_and';
-    if (node instanceof LogOrExpressionContext)
-        return 'short_circuit_or';
-    return undefined;
-}
-function enclosingMethod(node) {
-    let p = node.parentCtx;
-    while (p) {
-        if (p instanceof MethodDeclarationContext || p instanceof ConstructorDeclarationContext) {
-            return p;
-        }
-        p = p.parentCtx;
-    }
-    return undefined;
-}
-function renderSignature(ctx, name) {
-    const paramsText = renderFormalParameters(ctx.formalParameters());
-    if (ctx instanceof MethodDeclarationContext) {
-        const retType = ctx.typeRef()?.getText() ?? (ctx.VOID() ? 'void' : '');
-        return `${retType ? retType + ' ' : ''}${name}${paramsText}`;
-    }
-    return `${name}${paramsText}`;
-}
-/**
- * ANTLR's `getText()` concatenates child tokens with no whitespace, which
- * mangles parameter lists like `List<Request> requests` into
- * `List<Request>requests`. Walk the structured children and rebuild a
- * properly-spaced signature.
- */
-function renderFormalParameters(params) {
-    if (!params)
-        return '()';
-    const list = params.formalParameterList();
-    if (!list)
-        return '()';
-    const parts = list.formalParameter_list().map(p => {
-        const type = p.typeRef()?.getText() ?? '';
-        const id = p.id()?.getText() ?? '';
-        return type && id ? `${type} ${id}` : type || id;
-    });
-    return `(${parts.join(', ')})`;
-}
-/**
- * Enumerate every method and constructor in a compilation unit, including
- * those nested inside inner classes. Each gets its own CC entry per the
- * v2 scope ("all methods in any class touched by apex://").
- */
-export function methodsInCompilationUnit(cu) {
-    const out = [];
-    walkParseTree(cu, node => {
-        if ((node instanceof MethodDeclarationContext ||
-            node instanceof ConstructorDeclarationContext) &&
-            node.block()) {
-            out.push(node);
-        }
-    });
-    return out;
-}
-//# sourceMappingURL=apex-complexity.js.map

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

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

package/dist/analyzer/apex-parse.d.ts

@@ -1,39 +0,0 @@
-import { CompilationUnitContext } from '@apexdevtools/apex-parser';
-/**
- * Structural view of an ANTLR parse-tree node covering only the members this
- * analyzer touches. `@apexdevtools/apex-parser` 5.x ships generated context
- * types that extend antlr4's `ParserRuleContext`, but antlr4 4.13.x does not
- * surface `ParserRuleContext` (nor its inherited `getText`/`getChild`) through
- * its NodeNext `.d.cts` re-export chain, so importing it directly fails to
- * resolve. We model the contract locally instead — the runtime objects carry
- * all of these methods.
- */
-export interface ApexRuleNode {
-    getChild(i: number): unknown;
-    getChildCount(): number;
-    getText(): string;
-    parentCtx?: ApexRuleNode | undefined;
-    start?: {
-        column?: number;
-        line?: number;
-        text?: string;
-    };
-    stop?: {
-        column?: number;
-        line?: number;
-        text?: string;
-    };
-}
-export declare function parseApexSource(source: string): CompilationUnitContext;
-export declare function locOfCtx(ctx: ApexRuleNode): {
-    endCol: number;
-    endRow: number;
-    startCol: number;
-    startRow: number;
-};
-/**
- * Walk an ANTLR parse-tree node depth-first, invoking the visitor on every
- * descendant (including the start node). Terminal/error nodes have no
- * children and are visited like any other node — caller filters by type.
- */
-export declare function walkParseTree(node: ApexRuleNode, visit: (n: ApexRuleNode) => void): void;

package/dist/analyzer/apex-parse.js

@@ -1,32 +0,0 @@
-import { ApexParserFactory, } from '@apexdevtools/apex-parser';
-export function parseApexSource(source) {
-    const parser = ApexParserFactory.createParser(source);
-    return parser.compilationUnit();
-}
-export function locOfCtx(ctx) {
-    const { start } = ctx;
-    const stop = ctx.stop ?? ctx.start;
-    return {
-        endCol: (stop?.column ?? 0) + (stop?.text?.length ?? 0),
-        endRow: stop?.line ?? 0,
-        startCol: start?.column ?? 0,
-        startRow: start?.line ?? 0,
-    };
-}
-/**
- * Walk an ANTLR parse-tree node depth-first, invoking the visitor on every
- * descendant (including the start node). Terminal/error nodes have no
- * children and are visited like any other node — caller filters by type.
- */
-export function walkParseTree(node, visit) {
-    visit(node);
-    const childCount = typeof node.getChildCount === 'function' ? node.getChildCount() : 0;
-    for (let i = 0; i < childCount; i++) {
-        const c = node.getChild(i);
-        // Filter to ParserRuleContext children only — terminals don't carry rules.
-        if (c && typeof c.getChildCount === 'function') {
-            walkParseTree(c, visit);
-        }
-    }
-}
-//# sourceMappingURL=apex-parse.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"apex-parse.js","sourceRoot":"","sources":["../../src/analyzer/apex-parse.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAElB,MAAM,2BAA2B,CAAC;AAoBnC,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,MAAM,GAAG,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC,eAAe,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAiB;IACxC,MAAM,EAAC,KAAK,EAAC,GAAG,GAAG,CAAC;IACpB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC;IACnC,OAAO;QACL,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC;QACvD,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;QACvB,QAAQ,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC;QAC5B,QAAQ,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAkB,EAClB,KAAgC;IAEhC,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,MAAM,UAAU,GACd,OAAO,IAAI,CAAC,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC3B,2EAA2E;QAC3E,IAAI,CAAC,IAAI,OAAQ,CAAkB,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;YACjE,aAAa,CAAC,CAAiB,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/analyzer/apex-resolve.d.ts

@@ -1,32 +0,0 @@
-export declare function extractApexClassName(uri: string): string | undefined;
-export interface ResolveOptions {
-    /**
-     * The .agent file that holds the apex:// reference. Used as the seed for
-     * the upward walk.
-     */
-    agentFilePath: string;
-    /**
-     * Optional `--apex-source` override. When set, classes are looked up here
-     * before falling back to the upward walk.
-     */
-    apexSourceOverride?: string;
-    /**
-     * The CLI `--source-dir` value. We never walk above this directory.
-     */
-    sourceDirRoot: string;
-}
-/**
- * Find `classes/<ClassName>.cls` by walking up from the .agent file. The walk
- * stops at the CLI's source-dir root so we never escape it. Returns the
- * absolute path or undefined.
- *
- * Path conventions covered:
- *   - sfdx default: <pkg>/main/default/classes/<X>.cls, with the .agent in
- *     <pkg>/main/default/aiAuthoringBundles/<Bundle>/<X>.agent
- *   - flat fixtures: <root>/classes/<X>.cls, with .agent under
- *     <root>/aiAuthoringBundles/<Bundle>/<X>.agent
- *   - explicit override: --apex-source <dir>/<X>.cls
- */
-export declare function resolveApexClassPath(className: string, opts: ResolveOptions): Promise<string | undefined>;
-/** True if `child` is the same as or a subpath of `parent` (path-segment safe). */
-export declare function isUnder(child: string, parent: string): boolean;

package/dist/analyzer/apex-resolve.js

@@ -1,59 +0,0 @@
-import { stat } from 'node:fs/promises';
-import { dirname, isAbsolute, join, resolve, sep } from 'node:path';
-const APEX_SCHEME = /^apex:\/\/(.+)$/;
-export function extractApexClassName(uri) {
-    const m = APEX_SCHEME.exec(uri);
-    if (!m)
-        return undefined;
-    // `apex://Foo` or `apex://namespace__Foo`; take the trailing simple name.
-    const raw = m[1].trim();
-    const dot = raw.lastIndexOf('.');
-    return dot === -1 ? raw : raw.slice(dot + 1);
-}
-/**
- * Find `classes/<ClassName>.cls` by walking up from the .agent file. The walk
- * stops at the CLI's source-dir root so we never escape it. Returns the
- * absolute path or undefined.
- *
- * Path conventions covered:
- *   - sfdx default: <pkg>/main/default/classes/<X>.cls, with the .agent in
- *     <pkg>/main/default/aiAuthoringBundles/<Bundle>/<X>.agent
- *   - flat fixtures: <root>/classes/<X>.cls, with .agent under
- *     <root>/aiAuthoringBundles/<Bundle>/<X>.agent
- *   - explicit override: --apex-source <dir>/<X>.cls
- */
-export async function resolveApexClassPath(className, opts) {
-    const candidates = [];
-    if (opts.apexSourceOverride) {
-        const override = isAbsolute(opts.apexSourceOverride)
-            ? opts.apexSourceOverride
-            : resolve(opts.apexSourceOverride);
-        candidates.push(join(override, `${className}.cls`), join(override, 'classes', `${className}.cls`));
-    }
-    const stop = resolve(opts.sourceDirRoot);
-    let dir = dirname(resolve(opts.agentFilePath));
-    while (true) {
-        candidates.push(join(dir, 'classes', `${className}.cls`));
-        if (dir === stop)
-            break;
-        const parent = dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    for (const c of candidates) {
-        const s = await stat(c).catch(() => { });
-        if (s?.isFile())
-            return c;
-    }
-    return undefined;
-}
-/** True if `child` is the same as or a subpath of `parent` (path-segment safe). */
-export function isUnder(child, parent) {
-    const c = resolve(child);
-    const p = resolve(parent);
-    if (c === p)
-        return true;
-    return c.startsWith(p.endsWith(sep) ? p : p + sep);
-}
-//# sourceMappingURL=apex-resolve.js.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,30 +0,0 @@
-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

@@ -1,126 +0,0 @@
-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

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

package/dist/analyzer/parse.d.ts

@@ -1,51 +0,0 @@
-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;