Skip to content

forcedotcom/sf-skills / plugins/builder/agentforce-adlc/skills/agentforce-architecture-analyze

agentforce-architecture-analyze

Verified

Declared architecture snapshot for one Agentforce agent: planner, topics, actions, flows, Apex, prompt templates, and NGA plugins. Renders a human-readable architecture document and Mermaid invocation graph from design-time metadata (not runtime audit rows). TRIGGER when user asks to describe, diagram, inventory, audit, document, or diff (e.g. v3 vs v5) the architecture / action tree / topic structure / tool inventory of a specific agent by agent API name in a specific org. DO NOT TRIGGER for runtime session traces, conversation transcripts, generation timings, or gateway audit chains — this skill reads design-time metadata only (use agentforce-d360-analyze for session traces).

FileKindSize
README.mdmarkdown8.5 KB
SKILL.mdskill md17.5 KB
assets/cli/describe_sobject.yamlconfig317 B
assets/cli/describe_tooling_sobject.yamlconfig347 B
assets/cli/list_metadata_genaiprompttemplate.yamlconfig342 B
assets/cli/org_display.yamlconfig280 B
assets/cli/retrieve_genai_plugin.yamlconfig391 B
assets/cli/show_access_token.yamlconfig700 B
assets/mermaid/action_tree.mmdother986 B
assets/mermaid/data_flow.mmdother893 B
assets/mermaid/dependency_graph.mmdother810 B
assets/mermaid/invocation_sequence.mmdother1004 B
assets/mermaid/planner_state.mmdother813 B
assets/soql/apex_class_bodies_by_ids.soqlother103 B
assets/soql/apex_class_bodies_by_names.soqlother102 B
assets/soql/bot_definition_details.soqlother152 B
assets/soql/bot_version_lookup.soqlother186 B
assets/soql/flow_definition_by_ids.soqlother115 B
assets/soql/flow_definition_ids_by_names.soqlother146 B
assets/soql/flow_definition_view_by_durable_ids.soqlother180 B
assets/soql/flow_metadata_by_id.soqlother73 B
assets/soql/functions_by_plugins.soqlother317 B
assets/soql/planner_attrs_by_parent_ids.soqlother156 B
assets/soql/planner_bundle_functions.soqlother93 B
assets/soql/planner_definition_by_agent_chain.soqlother174 B
assets/soql/plugin_functions_by_plugin_ids.soqlother93 B
assets/soql/plugin_instructions_by_plugin_ids.soqlother168 B
assets/soql/plugins_by_planner.soqlother199 B
references/architecture_sections.mdmarkdown8.3 KB
references/contract.jsonconfig11.7 KB
references/soql_fields.mdmarkdown24.6 KB
scripts/_shared/__init__.pyscript82 B
scripts/_shared/fs_guard.pyexecutablescript12.8 KB
scripts/_shared/paths.pyscript3.9 KB
scripts/_shared/runtime.pyscript2.0 KB
scripts/_shared/sql.pyscript355 B
scripts/cache_check.pyexecutablescript8.9 KB
scripts/config.pyscript5.9 KB
scripts/emit_env.pyexecutablescript5.1 KB
scripts/emit_result.pyexecutablescript10.7 KB
scripts/fetch_soql.pyscript26.1 KB
scripts/finalize.pyexecutablescript11.8 KB
scripts/main.pyscript113.9 KB
scripts/metadata_listing.pyscript9.5 KB
scripts/parallel_retrieve.pyscript3.3 KB
scripts/parse_bundle.pyexecutablescript7.9 KB
scripts/parse_wave.pyexecutablescript36.1 KB
scripts/probe_channels.pyscript11.1 KB
scripts/render_architecture.pyscript40.0 KB
scripts/resolve_bot.pyexecutablescript9.4 KB
scripts/resolve_invocation_target.pyscript4.8 KB
scripts/rest_client.pyscript33.7 KB
scripts/retrieve_planner.pyscript464 B
scripts/sanitize.pyexecutablescript1013 B
scripts/sf_cli.pyscript12.3 KB
scripts/soql_loader.pyscript11.1 KB
scripts/summarize_tree.pyexecutablescript4.6 KB
scripts/tests/__init__.pyscript0 B
scripts/tests/_bootstrap.pyscript843 B
scripts/tests/fixtures/__init__.pyscript0 B
scripts/tests/fixtures/genai_payloads.pyscript12.5 KB
scripts/tests/test_cache_check.pyscript12.6 KB
scripts/tests/test_cache_check_main.pyscript10.4 KB
scripts/tests/test_config.pyscript3.8 KB
scripts/tests/test_end_to_end_fixture.pyscript26.2 KB
scripts/tests/test_finalize.pyscript11.2 KB
scripts/tests/test_flow_children_inflation.pyscript25.6 KB
scripts/tests/test_fs_guard.pyscript4.3 KB
scripts/tests/test_iterative_wave_b.pyscript19.0 KB
scripts/tests/test_main_pipeline.pyscript145.1 KB
scripts/tests/test_parallel_retrieve.pyscript4.8 KB
scripts/tests/test_parse_bundle.pyscript15.6 KB
scripts/tests/test_parse_wave.pyscript26.9 KB
scripts/tests/test_parse_wave_classifiers.pyscript8.6 KB
scripts/tests/test_parse_wave_helpers.pyscript14.3 KB
scripts/tests/test_parse_wave_main.pyscript16.4 KB
scripts/tests/test_per_branch_visited.pyscript9.5 KB
scripts/tests/test_probe_channels.pyscript13.3 KB
scripts/tests/test_probe_cli_recipes.pyscript8.2 KB
scripts/tests/test_render_architecture.pyscript32.7 KB
scripts/tests/test_resolve_bot.pyscript7.5 KB
scripts/tests/test_resolve_creds.pyscript12.0 KB
scripts/tests/test_resolve_invocation_target.pyscript5.2 KB
scripts/tests/test_rest_client.pyscript49.8 KB
scripts/tests/test_runtime_override.pyscript3.9 KB
scripts/tests/test_sf_cli.pyscript17.3 KB
scripts/tests/test_signature_stamping.pyscript18.0 KB
scripts/tests/test_skill_md_pipeline_block.pyscript12.7 KB
scripts/tests/test_soql_loader.pyscript21.3 KB
scripts/tests/test_summarize_tree.pyscript8.9 KB
scripts/tests/test_write_emit_ctx.pyscript19.2 KB
scripts/write_emit_ctx.pyexecutablescript14.1 KB

scripts/tests/test_parse_wave_classifiers.py

View on GitHub
"""Tests for ``parse_wave`` classifiers + BFS step helper.

Targets the high-density branch surface in ``classify_bundle_action``
(Flow / Apex / PromptTemplate / StandardAction / Unknown) and
``classify_action_call`` (apex / generatePromptResponse / other / empty).
Plus the central ``bfs_step`` helper that drives wave-level fetches.
"""
from __future__ import annotations

import unittest

from . import _bootstrap  # noqa: F401  — sys.path setup

import parse_wave  # type: ignore


# -----------------------------------------------------------------------------
# classify_bundle_action — every branch
# -----------------------------------------------------------------------------


class ClassifyBundleActionTests(unittest.TestCase):

    def test_no_target_returns_none_pair(self):
        unwraps, leaf = parse_wave.classify_bundle_action({
            "invocationTarget": "",
            "invocationTargetType": "flow",
        })
        self.assertIsNone(unwraps)
        self.assertIsNone(leaf)

    def test_flow_branch(self):
        unwraps, leaf = parse_wave.classify_bundle_action({
            "invocationTarget": "MyFlow",
            "invocationTargetType": "flow",
        })
        self.assertEqual(unwraps["kind"], "FLOW")
        self.assertEqual(unwraps["api_name"], "MyFlow")
        self.assertEqual(leaf["children"], [])

    def test_apex_branch(self):
        unwraps, leaf = parse_wave.classify_bundle_action({
            "invocationTarget": "MyClass.method",
            "invocationTargetType": "apex",
        })
        self.assertEqual(unwraps["kind"], "APEX")
        self.assertEqual(leaf["api_name"], "MyClass.method")

    def test_prompt_template_via_generatepromptresponse(self):
        unwraps, _ = parse_wave.classify_bundle_action({
            "invocationTarget": "MyPrompt",
            "invocationTargetType": "generatepromptresponse",
        })
        self.assertEqual(unwraps["kind"], "PROMPT_TEMPLATE")

    def test_prompt_template_via_prompt_prefix(self):
        unwraps, _ = parse_wave.classify_bundle_action({
            "invocationTarget": "MyPrompt",
            "invocationTargetType": "prompt-template",
        })
        self.assertEqual(unwraps["kind"], "PROMPT_TEMPLATE")

    def test_prompt_template_via_genai_prefix(self):
        unwraps, _ = parse_wave.classify_bundle_action({
            "invocationTarget": "MyPrompt",
            "invocationTargetType": "genaifunction",
        })
        self.assertEqual(unwraps["kind"], "PROMPT_TEMPLATE")

    def test_standard_invocable_action_branch(self):
        unwraps, leaf = parse_wave.classify_bundle_action({
            "invocationTarget": "createRecord",
            "invocationTargetType": "standardinvocableaction",
        })
        self.assertEqual(unwraps["kind"], "STANDARD_ACTION")
        self.assertEqual(unwraps["invocation_type"], "standardinvocableaction")
        self.assertEqual(leaf["api_name"], "createRecord")

    def test_unknown_action_type_falls_to_unknown(self):
        unwraps, leaf = parse_wave.classify_bundle_action({
            "invocationTarget": "MysteryAction",
            "invocationTargetType": "MYSTERY",
        })
        self.assertEqual(unwraps["kind"], "UNKNOWN")
        self.assertEqual(unwraps["invocation_type"], "mystery")  # lowercased
        self.assertEqual(leaf["kind"], "UNKNOWN")

    def test_invocationTargetType_missing_normalizes_to_empty_string(self):
        unwraps, _ = parse_wave.classify_bundle_action({
            "invocationTarget": "MyAction",
            # no invocationTargetType — coerced to ""
        })
        self.assertEqual(unwraps["kind"], "UNKNOWN")
        self.assertEqual(unwraps["invocation_type"], "")


# -----------------------------------------------------------------------------
# classify_action_call — every branch
# -----------------------------------------------------------------------------


class ClassifyActionCallTests(unittest.TestCase):

    def test_apex_branch(self):
        out = parse_wave.classify_action_call("apex", "MyClass", "callA")
        self.assertEqual(out["kind"], "APEX")
        self.assertEqual(out["api_name"], "MyClass")
        self.assertEqual(out["element_name"], "callA")

    def test_generate_prompt_response_branch(self):
        out = parse_wave.classify_action_call(
            "generatePromptResponse", "MyPrompt", "callB",
        )
        self.assertEqual(out["kind"], "PROMPT_TEMPLATE")
        self.assertEqual(out["api_name"], "MyPrompt")

    def test_other_action_type_falls_to_standard_action(self):
        out = parse_wave.classify_action_call("emailAlert", "MyAlert", "callC")
        self.assertEqual(out["kind"], "STANDARD_ACTION")
        self.assertEqual(out["invocation_type"], "emailAlert")
        self.assertEqual(out["api_name"], "MyAlert")

    def test_other_action_type_uses_action_type_when_name_missing(self):
        out = parse_wave.classify_action_call("emailAlert", "", "callC")
        self.assertEqual(out["api_name"], "emailAlert")

    def test_empty_action_type_falls_to_unknown(self):
        out = parse_wave.classify_action_call("", "MyName", "callD")
        self.assertEqual(out["kind"], "UNKNOWN")
        self.assertEqual(out["api_name"], "MyName")

    def test_unknown_with_no_name_falls_to_question_mark(self):
        out = parse_wave.classify_action_call("", "", "callE")
        self.assertEqual(out["api_name"], "?")


# -----------------------------------------------------------------------------
# bfs_step — pure helper
# -----------------------------------------------------------------------------


class BfsStepTests(unittest.TestCase):

    def test_new_refs_added_to_pending(self):
        pending = parse_wave.empty_kind_sets()
        visited = parse_wave.empty_kind_sets()
        new_refs = {
            "FLOW": {"FlowA", "FlowB"},
            "APEX": {"ApexA"},
            "PROMPT_TEMPLATE": set(),
            "STANDARD_ACTION": set(),
        }
        merged, cycles = parse_wave.bfs_step(pending, visited, new_refs)
        self.assertEqual(merged["FLOW"], {"FlowA", "FlowB"})
        self.assertEqual(merged["APEX"], {"ApexA"})
        self.assertEqual(cycles, [])

    def test_visited_refs_recorded_as_cycles(self):
        pending = parse_wave.empty_kind_sets()
        visited = parse_wave.empty_kind_sets()
        visited["FLOW"].add("FlowA")
        new_refs = {
            "FLOW": {"FlowA", "FlowB"},
            "APEX": set(), "PROMPT_TEMPLATE": set(), "STANDARD_ACTION": set(),
        }
        merged, cycles = parse_wave.bfs_step(pending, visited, new_refs)
        self.assertEqual(merged["FLOW"], {"FlowB"})
        self.assertIn(("FLOW", "FlowA"), cycles)

    def test_cross_kind_same_name_stays_distinct(self):
        pending = parse_wave.empty_kind_sets()
        visited = parse_wave.empty_kind_sets()
        new_refs = {
            "FLOW": {"Foo"}, "APEX": {"Foo"},
            "PROMPT_TEMPLATE": set(), "STANDARD_ACTION": set(),
        }
        merged, _ = parse_wave.bfs_step(pending, visited, new_refs)
        self.assertEqual(merged["FLOW"], {"Foo"})
        self.assertEqual(merged["APEX"], {"Foo"})

    def test_existing_pending_preserved_via_merge(self):
        pending = parse_wave.empty_kind_sets()
        pending["FLOW"].add("FlowExisting")
        visited = parse_wave.empty_kind_sets()
        new_refs = {
            "FLOW": {"FlowNew"},
            "APEX": set(), "PROMPT_TEMPLATE": set(), "STANDARD_ACTION": set(),
        }
        merged, _ = parse_wave.bfs_step(pending, visited, new_refs)
        self.assertEqual(merged["FLOW"], {"FlowExisting", "FlowNew"})

    def test_unknown_kind_raises(self):
        pending = parse_wave.empty_kind_sets()
        visited = parse_wave.empty_kind_sets()
        with self.assertRaises(ValueError) as ctx:
            parse_wave.bfs_step(
                pending, visited,
                {"BOGUS_KIND": {"x"}},
            )
        self.assertIn("unknown BFS kind", str(ctx.exception))


# -----------------------------------------------------------------------------
# empty_kind_sets — fresh dict per call
# -----------------------------------------------------------------------------


class EmptyKindSetsTests(unittest.TestCase):

    def test_returns_one_set_per_BFS_KIND(self):
        out = parse_wave.empty_kind_sets()
        self.assertEqual(set(out.keys()), set(parse_wave.BFS_KINDS))
        for v in out.values():
            self.assertEqual(v, set())

    def test_each_call_returns_fresh_dict(self):
        a = parse_wave.empty_kind_sets()
        a["FLOW"].add("x")
        b = parse_wave.empty_kind_sets()
        self.assertEqual(b["FLOW"], set())


if __name__ == "__main__":
    unittest.main()
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall