Light, fluffy, and always free - The AWS Local Emulator alternative
docs: keep grouped service action counts in sync (#5991)
XuJiane06013e1fe0c
diff --git a/docs/services/autoscaling.md b/docs/services/autoscaling.mdindex 90fd25f456..819e97dfd6 100644--- a/docs/services/autoscaling.md+++ b/docs/services/autoscaling.md@@ -10,7 +10,7 @@ Floci implements the EC2 Auto Scaling API — stored-state management for launch- `arn:aws:autoscaling:<region>:<account>:launchConfiguration:<uuid>:launchConfigurationName/<name>`- `arn:aws:autoscaling:<region>:<account>:scalingPolicy:<uuid>:autoScalingGroupName/<group>/policyName/<name>`-## Supported Operations (47 total)+## Supported Operations (53 total)### Launch Configurations@@ -29,6 +29,8 @@ Floci implements the EC2 Auto Scaling API — stored-state management for launch| `UpdateAutoScalingGroup` | Updates capacity bounds, cooldown, launch source, AZs || `DeleteAutoScalingGroup` | `ForceDelete=true` terminates all instances before deletion || `DescribeTags` | Group tags; filters `auto-scaling-group`, `key`, `value`, `propagate-at-launch` (values ORed, filters ANDed); `MaxRecords`/`NextToken` paging |+| `CreateOrUpdateTags` | Creates or updates group tags and their propagate-at-launch setting |+| `DeleteTags` | Removes named group tags || `EnableMetricsCollection` | Records the named group metrics, or all 20 when none are named, as `EnabledMetrics` on `DescribeAutoScalingGroups`. `Granularity` is required and must be `1Minute`; an unknown metric name raises `ValidationError`. No metrics are published to CloudWatch || `DisableMetricsCollection` | Removes the named metrics from `EnabledMetrics`, or all of them when none are named |@@ -67,6 +69,8 @@ EC2 instance can use a default subnet in a different zone.| Operation | Notes ||---|---|| `DescribeAutoScalingInstances` | Returns all ASG-tracked instances with lifecycle state and health status |+| `SetInstanceHealth` | Updates an instance's health status immediately; accepts but does not enforce the grace-period flag |+| `SetInstanceProtection` | Enables or disables scale-in protection for named instances in a group || `SetDesiredCapacity` | Updates desired count; reconciler handles scale-out / scale-in within 10 s || `AttachInstances` | Attaches existing EC2 instances to a group; sets lifecycle state to `InService` || `DetachInstances` | Detaches instances from a group; optionally decrements desired capacity |@@ -74,6 +78,13 @@ EC2 instance can use a default subnet in a different zone.| `SuspendProcesses` | Records suspended scaling processes (empty list suspends all); reported back by `DescribeAutoScalingGroups` || `ResumeProcesses` | Clears suspended processes (empty list resumes all) |+### Instance Refresh++| Operation | Notes |+|---|---|+| `StartInstanceRefresh` | Starts replacement of group instances and returns a refresh ID |+| `DescribeInstanceRefreshes` | Returns refresh status and progress, with `MaxRecords`/`NextToken` paging |+### Instance Refresh RecoveryNew instance refreshes retain the selected instances and their replacement progressdiff --git a/docs/services/codedeploy.md b/docs/services/codedeploy.mdindex 2bc5225a33..69fb43f6be 100644--- a/docs/services/codedeploy.md+++ b/docs/services/codedeploy.md@@ -11,7 +11,7 @@ Floci implements the CodeDeploy API — stored-state management for applications- `arn:aws:codedeploy:<region>:<account>:deploymentconfig:<name>`- `arn:aws:codedeploy:<region>:<account>:deployment:<id>`-## Supported Operations (30 total)+## Supported Operations (35 total)### Applications@@ -66,12 +66,17 @@ Floci implements the CodeDeploy API — stored-state management for applications| `UntagResource` | Removes specific tag keys || `ListTagsForResource` | Returns tags for a resource ARN |-### On-Premises (no-op)+### On-Premises Instances| Operation | Notes ||---|---|-| `AddTagsToOnPremisesInstances` | Accepted, no-op |-| `RemoveTagsFromOnPremisesInstances` | Accepted, no-op |+| `RegisterOnPremisesInstance` | Registers an instance name with an IAM session or user ARN |+| `DeregisterOnPremisesInstance` | Marks an instance as `Deregistered` while retaining its registration record |+| `GetOnPremisesInstance` | Returns registration information for one instance |+| `BatchGetOnPremisesInstances` | Returns registration information for named instances |+| `ListOnPremisesInstances` | Lists registered names, optionally filtered by status or tags |+| `AddTagsToOnPremisesInstances` | Adds or replaces tags by key on named instances |+| `RemoveTagsFromOnPremisesInstances` | Removes matching tag keys from named instances |## Pre-seeded Built-in Deployment Configsdiff --git a/docs/services/index.md b/docs/services/index.mdindex 6891f2e7b8..d4efb63ffd 100644--- a/docs/services/index.md+++ b/docs/services/index.md@@ -27,7 +27,7 @@ Operation counts are exact. For dispatch-table services (Query and JSON 1.1) eac| [STS](sts.md) | `POST /` with `Action=` param | Query | 8 || [AWS Sign-In](iam.md#aws-sign-in-login-credentials) | `/v1/authorize`, `/v1/token` | REST JSON | 2 || [Organizations](organizations.md) | `POST /` + `X-Amz-Target: AWSOrganizationsV20161128.*` | JSON 1.1 | 56 |-| [Cognito](cognito.md) | `POST /` + `X-Amz-Target: AWSCognitoIdentityProviderService.*` | JSON 1.1 | 86 |+| [Cognito](cognito.md) | `POST /` + `X-Amz-Target: AWSCognitoIdentityProviderService.*` | JSON 1.1 | 90 || [Cognito Identity](cognitoidentity.md) | `POST /` + `X-Amz-Target: AWSCognitoIdentityService.*` | JSON 1.1 | 12 || [Global Accelerator](globalaccelerator.md) | `POST /` + `X-Amz-Target: GlobalAccelerator_V20180706.*` | JSON 1.1 | 22 || [KMS](kms.md) | `POST /` + `X-Amz-Target: TrentService.*` | JSON 1.1 | 42 |@@ -70,7 +70,7 @@ Operation counts are exact. For dispatch-table services (Query and JSON 1.1) eac| [Amazon MQ](amazonmq.md) | `/v1/brokers/...` + RabbitMQ broker | REST JSON + AMQP | 5 || [MWAA](mwaa.md) | `/` REST paths for environments + CLI/web proxy | REST JSON | 10 || [Athena](athena.md) | `POST /` + `X-Amz-Target: AmazonAthena.*` | JSON 1.1 | 21 |-| [Glue](glue.md) | `POST /` + `X-Amz-Target: AWSGlue.*` | JSON 1.1 | 38 |+| [Glue](glue.md) | `POST /` + `X-Amz-Target: AWSGlue.*` | JSON 1.1 | 131 || [Lake Formation](lakeformation.md) | `POST /<Action>` | REST JSON | 16 || [Neptune](neptune.md) | `POST /` with `Action=` param + Gremlin TCP proxy | Query + WebSocket | 14 || [DocumentDB](docdb.md) | `POST /` with `Action=` param + MongoDB container | Query + MongoDB wire | 13 |@@ -81,9 +81,9 @@ Operation counts are exact. For dispatch-table services (Query and JSON 1.1) eac| [EMR](emr.md) | `POST /` + `X-Amz-Target: ElasticMapReduce.*` | JSON 1.1 | 40 || [EMR Serverless](emr-serverless.md) | `/applications/*`, `/tags/*` | REST JSON | 10 || [Data Firehose](firehose.md) | `POST /` + `X-Amz-Target: Firehose_20150804.*` | JSON 1.1 | 12 |-| [ECS](ecs.md) | `POST /` + `X-Amz-Target: AmazonEC2ContainerServiceV20141113.*` | JSON 1.1 | 58 |+| [ECS](ecs.md) | `POST /` + `X-Amz-Target: AmazonEC2ContainerServiceV20141113.*` | JSON 1.1 | 59 || [EFS](efs.md) | `/2015-02-01/...` | REST JSON | 26 |-| [EC2](ec2.md) | `POST /` with `Action=` param | EC2 Query | 78 |+| [EC2](ec2.md) | `POST /` with `Action=` param | EC2 Query | 198 || [Lightsail](lightsail.md) | `POST /` + `X-Amz-Target: Lightsail_20161128.*` | JSON 1.1 | 79 local responses; 161 recognized actions || [ACM](acm.md) | `POST /` + `X-Amz-Target: CertificateManager.*` | JSON 1.1 | 16 || [ECR](ecr.md) | `POST /` + `X-Amz-Target: AmazonEC2ContainerRegistry_V20150921.*` (control plane) and `/v2/...` (data plane proxied to `registry:2`) | JSON 1.1 + OCI Distribution | 17 |@@ -100,15 +100,15 @@ Operation counts are exact. For dispatch-table services (Query and JSON 1.1) eac| [Bedrock AgentCore Control](bedrock-agentcore.md) | `/runtimes/*`, `/gateways/*`, `/memories/*`, `/identities/*`, `/browsers*`, `/browser-profiles*`, `/code-interpreters*`, `/resourcepolicy/*`, `/tags/{resourceArn}` | REST JSON | 65 (+ 3 tagging via shared `/tags/{arn}` route) || [Bedrock AgentCore](bedrock-agentcore.md#data-plane-invokeagentruntime) | `/runtimes/{agentRuntimeArn}/invocations` | REST JSON (binary payload) | 1 (canned-response stub) || [EKS](eks.md) | `/clusters`, `/clusters/{name}`, `/tags/{resourceArn}` | REST JSON | 7 |-| [ELB v2](elb.md) | `POST /` with `Action=` param | Query | 34 |+| [ELB v2](elb.md) | `POST /` with `Action=` param | Query | 37 || [ELB Classic (v1)](elb-classic.md) | `POST /` with `Action=` and `Version=2012-06-01` | Query | 20 || [WAF v2](wafv2.md) | `POST /` + `X-Amz-Target: AWSWAF_20190729.*` | JSON 1.1 | 35 |-| [Auto Scaling](autoscaling.md) | `POST /` with `Action=` param | Query | 33 |+| [Auto Scaling](autoscaling.md) | `POST /` with `Action=` param | Query | 53 || [Application Auto Scaling](applicationautoscaling.md) | `POST /` + `X-Amz-Target: AnyScaleFrontendService.*` | JSON 1.1 | 10 || [Elastic Beanstalk](elastic-beanstalk.md) | `POST /` with `Action=` or `Operation=` param | Query | 14 || [CodeBuild](codebuild.md) | `POST /` + `X-Amz-Target: CodeBuild_20161006.*` | JSON 1.1 | 20 || [AWS Batch](batch.md) | `/v1/...` | REST JSON | 10 |-| [CodeDeploy](codedeploy.md) | `POST /` + `X-Amz-Target: CodeDeploy_20141006.*` | JSON 1.1 | 30 |+| [CodeDeploy](codedeploy.md) | `POST /` + `X-Amz-Target: CodeDeploy_20141006.*` | JSON 1.1 | 35 || [CodePipeline](codepipeline.md) | `POST /` + `X-Amz-Target: CodePipeline_20150709.*` | JSON 1.1 | 44 || [AWS Network Firewall](network-firewall.md) | `POST /` + `X-Amz-Target: NetworkFirewall_20201112.*` | JSON 1.0 | 27 || [AWS Service Catalog](service-catalog.md) | `POST /` + `X-Amz-Target: AWS242ServiceCatalogService.*` | JSON 1.1 | 89 |@@ -129,7 +129,7 @@ Operation counts are exact. For dispatch-table services (Query and JSON 1.1) eac| [Amazon SageMaker](sagemaker.md) | `POST /` + `X-Amz-Target: SageMaker.*` | JSON 1.1 | 20 || [SageMaker Runtime](sagemaker.md#endpoint-hosting) | `/endpoints/{EndpointName}/invocations` | REST (binary payload) | 1 || [Cloud Map](cloudmap.md) | `POST /` + `X-Amz-Target: Route53AutoNaming_v20170314.*` | JSON 1.1 | 22 |-| [AWS Config](config.md) | `POST /` + `X-Amz-Target: StarlingDoveService.*` | JSON 1.1 | 33 |+| [AWS Config](config.md) | `POST /` + `X-Amz-Target: StarlingDoveService.*` | JSON 1.1 | 36 || [CloudTrail](cloudtrail.md) | `POST /` + `X-Amz-Target: com.amazonaws.cloudtrail.v20131101.CloudTrail_20131101.*` | JSON 1.1 | 14 || [Textract](textract.md) | `POST /` + `X-Amz-Target: Textract.*` | JSON 1.1 | 6 || [Comprehend](comprehend.md) | `POST /` + `X-Amz-Target: Comprehend_20171127.*` | JSON 1.1 | 5 |diff --git a/tools/docs/check_service_matrix.py b/tools/docs/check_service_matrix.pyindex 93a8bb0385..a7e66ae005 100644--- a/tools/docs/check_service_matrix.py+++ b/tools/docs/check_service_matrix.py@@ -45,6 +45,14 @@ CATALOG_SOURCE = "src/main/java/io/github/hectorvent/floci/core/common/ResolvedSMATRIX_DOC = "docs/services/index.md"REGISTRY = "tools/docs/service_matrix.yaml"+# These grouped rows already have one dispatcher each; removing a registry entry+# must not silently turn off their count check.+REQUIRED_ACTION_COUNT_SOURCES = frozenset({+ "autoscaling", "cloudmap", "codebuild", "codedeploy", "cognito", "config",+ "ec2", "ecs", "elastic-beanstalk", "elb", "elb-classic", "glue", "iam",+ "resource-groups-tagging",+})+MATRIX_HEADING = "## Service Matrix"MATRIX_END_HEADING = "## Common Setup"@@ -183,14 +191,13 @@ def count_generated_actions(md_source: str) -> int | None:return count-def extract_action_counts(repo_root: Path) -> dict[str, int]:+def extract_action_counts(repo_root: Path, required_sources: frozenset[str] = frozenset()) -> dict[str, int]:"""Extract mechanically verifiable action counts.Generated service documents are counted from their generated action-table- markers. IAM is a deferred non-tabular document, so its Query switch is- parsed directly using the same action parser as regen_action_docs.py.- Other services without generated action-table markers are intentionally- skipped here because their handlers use non-tabular or mixed dispatch- patterns that cannot be counted safely by the generic registry parser.+ markers. Explicitly mapped non-tabular Query/JSON dispatchers are counted+ from source with the same action parser as regen_action_docs.py. Mixed and+ anchored rows remain outside this check until their operations can be+ attributed to a single matrix row."""md_source = (repo_root / MATRIX_DOC).read_text(encoding="utf-8")matrix_counts = extract_matrix_action_counts(md_source)@@ -198,7 +205,7 @@ def extract_action_counts(repo_root: Path) -> dict[str, int]:counts: dict[str, int] = {}# Generated service documents.- for slug in matrix_counts:+ for slug in sorted(extract_matrix_slugs(md_source)):doc_path = repo_root / SERVICES_DIR / f"{slug}.md"if not doc_path.exists():@@ -208,19 +215,32 @@ def extract_action_counts(repo_root: Path) -> dict[str, int]:generated_count = count_generated_actions(doc_source)if generated_count is not None:+ if slug not in matrix_counts:+ raise ValueError(+ f"{MATRIX_DOC}: '{slug}' needs a numeric matrix row for its generated action table"+ )counts[slug] = generated_count- # IAM is intentionally non-tabular, so validate it from its handler.- iam_source = (- repo_root- / "src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.java"- )-- counts["iam"] = len(- regen_action_docs.extract_switch_actions(- iam_source.read_text(encoding="utf-8")+ registry = yaml.safe_load((repo_root / REGISTRY).read_text(encoding="utf-8")) or {}+ sources = registry.get("action_count_sources")+ if not isinstance(sources, dict) or not sources:+ raise ValueError(f"{REGISTRY}: action_count_sources must be a non-empty mapping")+ missing = required_sources - sources.keys()+ if missing:+ raise ValueError(f"{REGISTRY}: required action count source(s) missing: {', '.join(sorted(missing))}")+ for slug, relative_path in sources.items():+ if slug not in matrix_counts:+ raise ValueError(f"{REGISTRY}: action count source '{slug}' has no numeric matrix row")+ if slug in counts:+ raise ValueError(f"{REGISTRY}: '{slug}' already has a generated action table")+ if not isinstance(relative_path, str):+ raise ValueError(f"{REGISTRY}: action count source '{slug}' needs a source path")+ actions = regen_action_docs.extract_switch_actions(+ (repo_root / relative_path).read_text(encoding="utf-8"))- )+ if not actions:+ raise ValueError(f"{REGISTRY}: action count source '{slug}' has no actions")+ counts[slug] = len(set(actions))return counts@@ -343,8 +363,8 @@ def main(argv: list[str] | None = None) -> int:try:matrix_action_counts = extract_matrix_action_counts(md_source)- source_action_counts = extract_action_counts(repo_root)- except (ValueError, OSError) as exc:+ source_action_counts = extract_action_counts(repo_root, REQUIRED_ACTION_COUNT_SOURCES)+ except (ValueError, OSError, yaml.YAMLError) as exc:print(f"error: {exc}", file=sys.stderr)return 1diff --git a/tools/docs/service_matrix.yaml b/tools/docs/service_matrix.yamlindex 4550e86884..da4af43300 100644--- a/tools/docs/service_matrix.yaml+++ b/tools/docs/service_matrix.yaml@@ -64,6 +64,25 @@ aliases:# row lands - don't wait for it to expire.deferred: []+# Non-tabular pages with one Query/JSON action dispatcher per numeric base row.+# These counts are checked against the handler switch, without flattening the+# grouped documentation. Anchored and mixed-dispatch rows need separate rules.+action_count_sources:+ autoscaling: src/main/java/io/github/hectorvent/floci/services/autoscaling/AutoScalingQueryHandler.java+ cloudmap: src/main/java/io/github/hectorvent/floci/services/cloudmap/CloudMapHandler.java+ codebuild: src/main/java/io/github/hectorvent/floci/services/codebuild/CodeBuildJsonHandler.java+ codedeploy: src/main/java/io/github/hectorvent/floci/services/codedeploy/CodeDeployJsonHandler.java+ cognito: src/main/java/io/github/hectorvent/floci/services/cognito/CognitoJsonHandler.java+ config: src/main/java/io/github/hectorvent/floci/services/configservice/ConfigServiceJsonHandler.java+ ec2: src/main/java/io/github/hectorvent/floci/services/ec2/Ec2QueryHandler.java+ ecs: src/main/java/io/github/hectorvent/floci/services/ecs/EcsJsonHandler.java+ elastic-beanstalk: src/main/java/io/github/hectorvent/floci/services/elasticbeanstalk/ElasticBeanstalkQueryHandler.java+ elb: src/main/java/io/github/hectorvent/floci/services/elbv2/ElbV2QueryHandler.java+ elb-classic: src/main/java/io/github/hectorvent/floci/services/elb/ElbClassicQueryHandler.java+ glue: src/main/java/io/github/hectorvent/floci/services/glue/GlueJsonHandler.java+ iam: src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.java+ resource-groups-tagging: src/main/java/io/github/hectorvent/floci/services/resourcegroupstagging/ResourceGroupsTaggingJsonHandler.java+# docs/services pages that intentionally have no Service Matrix row of their own.facet_pages:- cloudwatch-metric-filters-verificationdiff --git a/tools/docs/test_check_service_matrix.py b/tools/docs/test_check_service_matrix.pyindex 6f460308cf..d618217353 100644--- a/tools/docs/test_check_service_matrix.py+++ b/tools/docs/test_check_service_matrix.py@@ -131,6 +131,119 @@ Another link to [SQS](sqs.md).}[email protected]("slug,handler", [+ ("ec2", "ec2/Ec2QueryHandler.java"),+ ("ecs", "ecs/EcsJsonHandler.java"),+ ("elb", "elbv2/ElbV2QueryHandler.java"),+ ("glue", "glue/GlueJsonHandler.java"),+])+def test_non_tabular_action_counts_follow_dispatcher(slug, handler):+ root = c._repo_root()+ source = root / "src/main/java/io/github/hectorvent/floci/services" / handler+ expected = len(set(c.regen_action_docs.extract_switch_actions(+ source.read_text(encoding="utf-8")+ )))++ assert c.extract_action_counts(root)[slug] == expected+++def test_non_tabular_action_count_tracks_new_dispatch_cases(tmp_path):+ matrix = tmp_path / "docs/services/index.md"+ matrix.parent.mkdir(parents=True)+ matrix.write_text(+ "## Service Matrix\n\n| [Glue](glue.md) | Query | JSON | 2 |\n\n## Common Setup\n",+ encoding="utf-8",+ )+ registry = tmp_path / "tools/docs/service_matrix.yaml"+ registry.parent.mkdir(parents=True)+ registry.write_text("action_count_sources:\n glue: src/GlueJsonHandler.java\n", encoding="utf-8")+ handler = tmp_path / "src/GlueJsonHandler.java"+ handler.parent.mkdir(parents=True)+ handler.write_text(+ 'case "CreateTable" -> create();\ncase "GetTable" -> get();\n',+ encoding="utf-8",+ )++ assert c.extract_action_counts(tmp_path)["glue"] == 2++ handler.write_text(+ handler.read_text(encoding="utf-8") + 'case "DeleteTable" -> delete();\n',+ encoding="utf-8",+ )+ assert c.extract_action_counts(tmp_path)["glue"] == 3+++def test_generated_action_table_requires_numeric_matrix_count(tmp_path):+ matrix = tmp_path / "docs/services/index.md"+ matrix.parent.mkdir(parents=True)+ matrix.write_text(+ "## Service Matrix\n\n| [EFS](efs.md) | REST | REST | TBD |\n"+ "| [Glue](glue.md) | Query | JSON | 2 |\n\n## Common Setup\n",+ encoding="utf-8",+ )+ (matrix.parent / "efs.md").write_text(+ "<!-- floci:actions:start -->\n| Action | Description |\n"+ "| --- | --- |\n| CreateFileSystem | Creates a file system |\n"+ "<!-- floci:actions:end -->\n",+ encoding="utf-8",+ )+ registry = tmp_path / "tools/docs/service_matrix.yaml"+ registry.parent.mkdir(parents=True)+ registry.write_text("action_count_sources:\n glue: src/GlueJsonHandler.java\n", encoding="utf-8")+ handler = tmp_path / "src/GlueJsonHandler.java"+ handler.parent.mkdir(parents=True)+ handler.write_text('case "CreateTable" -> create();\ncase "GetTable" -> get();\n', encoding="utf-8")++ with pytest.raises(ValueError, match="efs.*numeric matrix row"):+ c.extract_action_counts(tmp_path)++[email protected]("source_entry", ["[]", "{}", "null"])+def test_non_tabular_action_sources_cannot_be_disabled(tmp_path, source_entry):+ matrix = tmp_path / "docs/services/index.md"+ matrix.parent.mkdir(parents=True)+ matrix.write_text(+ "## Service Matrix\n\n| [Glue](glue.md) | Query | JSON | 2 |\n\n## Common Setup\n",+ encoding="utf-8",+ )+ registry = tmp_path / "tools/docs/service_matrix.yaml"+ registry.parent.mkdir(parents=True)+ registry.write_text(f"action_count_sources: {source_entry}\n", encoding="utf-8")++ with pytest.raises(ValueError, match="non-empty mapping"):+ c.extract_action_counts(tmp_path)+++def test_non_tabular_action_source_cannot_be_removed_silently(tmp_path):+ matrix = tmp_path / "docs/services/index.md"+ matrix.parent.mkdir(parents=True)+ matrix.write_text(+ "## Service Matrix\n\n| [Glue](glue.md) | Query | JSON | 2 |\n"+ "| [EC2](ec2.md) | Query | Query | 1 |\n\n## Common Setup\n",+ encoding="utf-8",+ )+ registry = tmp_path / "tools/docs/service_matrix.yaml"+ registry.parent.mkdir(parents=True)+ registry.write_text(+ "action_count_sources:\n glue: src/GlueJsonHandler.java\n"+ " ec2: src/Ec2QueryHandler.java\n", encoding="utf-8",+ )+ source_dir = tmp_path / "src"+ source_dir.mkdir()+ (source_dir / "GlueJsonHandler.java").write_text(+ 'case "CreateTable" -> create();\ncase "GetTable" -> get();\n', encoding="utf-8",+ )+ (source_dir / "Ec2QueryHandler.java").write_text(+ 'case "DescribeInstances" -> describe();\n', encoding="utf-8",+ )++ required = frozenset({"glue", "ec2"})+ assert c.extract_action_counts(tmp_path, required) == {"glue": 2, "ec2": 1}+ registry.write_text("action_count_sources:\n glue: src/GlueJsonHandler.java\n", encoding="utf-8")+ with pytest.raises(ValueError, match="required action count source\\(s\\) missing: ec2"):+ c.extract_action_counts(tmp_path, required)++def test_extract_matrix_slugs_raises_on_missing_heading():# A renamed/reordered heading must fail loudly rather than silently returning an# empty slug set, which would make every registered service look undocumented.