cloudcostwise 0.1.2__tar.gz → 0.1.3__tar.gz

{cloudcostwise-0.1.2 → cloudcostwise-0.1.3}/PKG-INFO

@@ -1,10 +1,12 @@
 Metadata-Version: 2.4
 Name: cloudcostwise
-Version: 0.1.2
+Version: 0.1.3
 Summary: Find AWS waste from your terminal or your AI assistant. Runs locally with your own read-only credentials; nothing leaves your machine.
 Author: CloudWise
 License: FSL-1.1-ALv2
 Project-URL: Homepage, https://cloudcostwise.io/cli
+Project-URL: Repository, https://github.com/cloudwise-app/cloudcostwise
+Project-URL: Issues, https://github.com/cloudwise-app/cloudcostwise/issues
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE.md

{cloudcostwise-0.1.2 → cloudcostwise-0.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "cloudcostwise"
-version = "0.1.2"
+version = "0.1.3"
 description = "Find AWS waste from your terminal or your AI assistant. Runs locally with your own read-only credentials; nothing leaves your machine."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -20,6 +20,8 @@ cloudcostwise = "cloudcostwise.cli:main"
 
 [project.urls]
 Homepage = "https://cloudcostwise.io/cli"
+Repository = "https://github.com/cloudwise-app/cloudcostwise"
+Issues = "https://github.com/cloudwise-app/cloudcostwise/issues"
 
 [tool.setuptools.packages.find]
 where = ["src"]

{cloudcostwise-0.1.2 → cloudcostwise-0.1.3}/src/cloudcostwise/__init__.py

@@ -1,3 +1,3 @@
 """cloudcostwise: find AWS waste locally (FSL-1.1-ALv2)."""
 
-__version__ = "0.1.2"
+__version__ = "0.1.3"

{cloudcostwise-0.1.2 → cloudcostwise-0.1.3}/src/cloudcostwise/mcp_server.py

@@ -62,16 +62,16 @@ def build_server() -> MCPServer:
     session = _Session()
     server = MCPServer(name="cloudcostwise", version=__version__, instructions=INSTRUCTIONS)
 
-    @server.tool(
-        annotations=READ_ONLY,
-        description=(
-            "Scan the user's AWS account for waste with their local credentials (read-only; any non-read "
-            "AWS call is refused). Takes 30-60 s per region; up to 4 regions run at once. COST: the RI/Savings Plans checks call Cost "
-            "Explorer, billed by AWS at $0.01 per request (about $0.13 a scan); tell the user before "
-            "running, and pass include_cost_explorer=false to skip them. regions: comma-separated, or "
-            "'all'; default us-east-1 plus the profile's region."
-        ),
-    )
+    # Same one-line decorator shape as the other three tools: directories that
+    # list tools by reading the source (mcprush) missed this one when its
+    # decorator opened on its own line.
+    @server.tool(annotations=READ_ONLY,
+                 description="Scan the user's AWS account for waste with their local credentials (read-only; "
+                             "any non-read AWS call is refused). Takes 30-60 s per region; up to 4 regions run "
+                             "at once. COST: the RI/Savings Plans checks call Cost Explorer, billed by AWS at "
+                             "$0.01 per request (about $0.13 a scan); tell the user before running, and pass "
+                             "include_cost_explorer=false to skip them. regions: comma-separated, or 'all'; "
+                             "default us-east-1 plus the profile's region.")
     async def scan(ctx: Context, profile: Optional[str] = None, regions: Optional[str] = None,
                    include_cost_explorer: bool = True) -> str:
         try:

{cloudcostwise-0.1.2 → cloudcostwise-0.1.3}/src/cloudcostwise.egg-info/PKG-INFO

@@ -1,10 +1,12 @@
 Metadata-Version: 2.4
 Name: cloudcostwise
-Version: 0.1.2
+Version: 0.1.3
 Summary: Find AWS waste from your terminal or your AI assistant. Runs locally with your own read-only credentials; nothing leaves your machine.
 Author: CloudWise
 License: FSL-1.1-ALv2
 Project-URL: Homepage, https://cloudcostwise.io/cli
+Project-URL: Repository, https://github.com/cloudwise-app/cloudcostwise
+Project-URL: Issues, https://github.com/cloudwise-app/cloudcostwise/issues
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE.md

{cloudcostwise-0.1.2 → cloudcostwise-0.1.3}/src/cloudwise_scan_core/advisory_types.py

@@ -25,6 +25,7 @@ UNVALIDATED = "unvalidated"
 
 # No path to L2 within budget.
 ADVISORY_WASTE_TYPES: frozenset[str] = frozenset({
+    "appsync_idle_cache",
     "aurora_io_optimization_opportunity",
     "aurora_serverless_opportunity",
     "convertible_ri_exchange_opportunity",
@@ -55,6 +56,7 @@ ADVISORY_WASTE_TYPES: frozenset[str] = frozenset({
     "ri_opportunity_opensearch",
     "ri_opportunity_rds",
     "ri_opportunity_redshift",
+    "s3_high_request_and_transfer_cost",
     "s3_no_default_encryption",
     "savings_plan_coverage_gap",
     "sp_opportunity_compute",
@@ -80,18 +82,22 @@ TRUSTED_WASTE_TYPES: frozenset[str] = frozenset({
     "dynamodb_no_deletion_protection",
     "ecr_no_lifecycle_policy",
     "ecs_container_insights_waste",
+    "ecs_no_autoscaling",
     "eip_on_stopped_instance",
     "elasticache_engine_migration",
     "elasticache_extended_support_cost",
+    "elasticache_replication_waste",
     "empty_log_group",
     "excessive_retention_log_group",
     "failed_glue_job_retry",
     "glue_job_missing_timeout",
     "gp2_migration",
+    "idle_beanstalk",
     "idle_documentdb",
     "idle_dynamodb",
     "idle_ecs_service",
     "idle_efs",
+    "idle_fsx",
     "idle_load_balancer",
     "idle_state_machine",
     "kinesis_firehose_idle",
@@ -99,6 +105,8 @@ TRUSTED_WASTE_TYPES: frozenset[str] = frozenset({
     "lambda_excessive_timeout",
     "lambda_old_runtime",
     "lambda_provisioned_concurrency_idle",
+    "lightsail_idle_database",
+    "lightsail_idle_load_balancer",
     "lightsail_unattached_disk",
     "lightsail_unattached_static_ip",
     "low_traffic_alb",
@@ -108,11 +116,13 @@ TRUSTED_WASTE_TYPES: frozenset[str] = frozenset({
     "no_retention_log_group",
     "old_ecr_images",
     "old_glue_job",
+    "opensearch_no_encryption_at_rest",
     "orphaned_dns_record",
     "orphaned_ebs_snapshot",
     "over_provisioned_dynamodb",
     "over_provisioned_lambda",
     "oversized_glue_job",
+    "oversized_sagemaker_endpoint",
     "previous_gen_sagemaker_instance",
     "rds_no_deletion_protection",
     "rds_publicly_accessible",
@@ -140,7 +150,6 @@ TRUSTED_WASTE_TYPES: frozenset[str] = frozenset({
 
 # L0/L1 with a path to L2.
 UNVALIDATED_WASTE_TYPES: frozenset[str] = frozenset({
-    "appsync_idle_cache",
     "aurora_extended_support_cost",
     "aurora_to_rds_downgrade_opportunity",
     "backup_copy_policy_overreach",
@@ -151,20 +160,16 @@ UNVALIDATED_WASTE_TYPES: frozenset[str] = frozenset({
     "beanstalk_unnecessary_alb",
     "cloudtrail_s3_no_lifecycle",
     "disabled_global_accelerator",
-    "ecs_no_autoscaling",
     "eks_extended_support_cost",
     "elasticache_data_tiering_opportunity",
-    "elasticache_replication_waste",
     "elasticache_serverless_optimization",
     "emr_missing_auto_termination",
     "emr_previous_gen_instances",
     "emr_spot_opportunity",
     "fsx_throughput_overprovisioned",
-    "idle_beanstalk",
     "idle_ec2",
     "idle_elasticache",
     "idle_emr_cluster",
-    "idle_fsx",
     "idle_glue_crawler",
     "idle_kinesis_stream",
     "idle_lightsail",
@@ -179,8 +184,6 @@ UNVALIDATED_WASTE_TYPES: frozenset[str] = frozenset({
     "incomplete_multipart",
     "kinesis_enhanced_fan_out_waste",
     "kinesis_extended_retention_waste",
-    "lightsail_idle_database",
-    "lightsail_idle_load_balancer",
     "lightsail_old_snapshot",
     "neptune_old_snapshot",
     "neptune_serverless_opportunity",
@@ -192,7 +195,6 @@ UNVALIDATED_WASTE_TYPES: frozenset[str] = frozenset({
     "old_rds_snapshot",
     "opensearch_ebs_overprovisioned",
     "opensearch_extended_support_cost",
-    "opensearch_no_encryption_at_rest",
     "over_provisioned_iops",
     "over_provisioned_kinesis",
     "overprovisioned_documentdb",
@@ -208,10 +210,8 @@ UNVALIDATED_WASTE_TYPES: frozenset[str] = frozenset({
     "oversized_neptune",
     "oversized_opensearch",
     "oversized_rds_optimizer",
-    "oversized_sagemaker_endpoint",
     "oversized_workspace",
     "rds_extended_support_cost",
-    "s3_high_request_and_transfer_cost",
     "s3_rapid_growth",
     "stopped_sagemaker_notebook_storage",
     "unused_api_gateway",
@@ -224,6 +224,7 @@ UNVALIDATED_WASTE_TYPES: frozenset[str] = frozenset({
 
 # Why each advisory type is advisory (ledger `advisory_reason`).
 ADVISORY_REASONS: Dict[str, str] = {
+    "appsync_idle_cache": "over_budget",
     "aurora_io_optimization_opportunity": "over_budget",
     "aurora_serverless_opportunity": "over_budget",
     "convertible_ri_exchange_opportunity": "commitment",
@@ -254,6 +255,7 @@ ADVISORY_REASONS: Dict[str, str] = {
     "ri_opportunity_opensearch": "commitment",
     "ri_opportunity_rds": "commitment",
     "ri_opportunity_redshift": "commitment",
+    "s3_high_request_and_transfer_cost": "over_budget",
     "s3_no_default_encryption": "retired_config",
     "savings_plan_coverage_gap": "commitment",
     "sp_opportunity_compute": "commitment",

{cloudcostwise-0.1.2 → cloudcostwise-0.1.3}/src/cloudwise_scan_core/cloudwatch_metrics_service.py

@@ -164,22 +164,27 @@ class MSKMetrics:
     messages_in_per_sec: float
     bytes_in_per_sec: float
     bytes_out_per_sec: float
-    # Online (CLO-549): the busiest broker's mean CpuUser + CpuSystem, and
-    # traffic summed across brokers. Offline: the export's cluster figure.
+    # Both online (CLO-549) and offline (CLO-560): the busiest broker's mean
+    # CpuUser + CpuSystem, and traffic summed across brokers.
     cpu_user: float
     period_days: int
     is_idle: bool = False
-    # CLO-457: hourly CpuUser datapoints behind ``cpu_user``. 0 means CPU was
-    # not measured (``cpu_user`` is then a placeholder 0.0, not 0% CPU);
-    # None means the source does not count them (the offline export).
+    # CLO-457/CLO-560: hourly CpuUser+CpuSystem datapoints behind
+    # ``cpu_user`` (the fewest of any broker). 0 means CPU was not measured
+    # on at least one broker (``cpu_user`` is then a placeholder 0.0, not 0%
+    # CPU). None is unused today — both providers count it.
     cpu_datapoints: Optional[int] = None
 
 
 @dataclass
 class NeptuneMetrics:
     """Neptune cluster metrics."""
-    gremlin_requests: int
-    sparql_requests: int
+    # CLO-584: float for parity with NeptuneMetricsData (data_providers/models.py) --
+    # this class and get_neptune_metrics() below are not on the live
+    # detector path (no caller in the repo), but kept consistent rather than
+    # left truncating.
+    gremlin_requests: float
+    sparql_requests: float
     loader_requests: int
     avg_cpu: float
     max_cpu: float
@@ -1779,8 +1784,9 @@ class CloudWatchMetricsService:
                 )
             )
             
-            gremlin_requests = int(sum(dp.get('Sum', 0) for dp in gremlin_response.get('Datapoints', [])))
-            sparql_requests = int(sum(dp.get('Sum', 0) for dp in sparql_response.get('Datapoints', [])))
+            # CLO-584: kept as floats (see NeptuneMetrics above).
+            gremlin_requests = sum(dp.get('Sum', 0) for dp in gremlin_response.get('Datapoints', []))
+            sparql_requests = sum(dp.get('Sum', 0) for dp in sparql_response.get('Datapoints', []))
             
             cpu_datapoints = cpu_response.get('Datapoints', [])
             avg_cpu = sum(dp.get('Average', 0) for dp in cpu_datapoints) / len(cpu_datapoints) if cpu_datapoints else 0

{cloudcostwise-0.1.2 → cloudcostwise-0.1.3}/src/cloudwise_scan_core/data_providers/base.py

@@ -776,6 +776,26 @@ class WasteDataProvider(ABC):
         both names; datapoints from before the consumer existed are excluded."""
         pass
 
+    @abstractmethod
+    async def get_kinesis_consumer_subscribed(
+        self, stream_name: str, consumer_name: str,
+    ) -> Optional[bool]:
+        """Whether an enhanced fan-out consumer has subscribed in the past
+        two weeks (CLO-589 follow-up, PR #1654 review HIGH 1).
+
+        AWS publishes SubscribeToShard.Success (StreamName, ConsumerName) at
+        least once every 5 minutes while a subscription lives, and the
+        SubscribeToShardEvent.* series only while one is active; a consumer
+        that never subscribes publishes no series at all. CloudWatch
+        ListMetrics reports the metrics that had data in the past two weeks.
+        So: True when a successful ListMetrics answer holds any series for
+        the (StreamName, ConsumerName) pair; False only when a complete,
+        successful answer holds none; None (MISSING, noted) when it could not
+        be read. Never an empty GetMetricStatistics series read as idle.
+
+        Both providers implement it (repo rule: every get_* is abstract)."""
+        pass
+
     @abstractmethod
     async def get_firehose_delivery_streams(self) -> List['KinesisFirehoseData']:
         """Get all Kinesis Data Firehose delivery streams."""
@@ -1011,6 +1031,17 @@ class WasteDataProvider(ABC):
         """Get copy job summaries for the specified lookback period."""
         pass
 
+    async def backup_vault_exists(self, vault_arn: str) -> Optional[bool]:
+        """Whether the backup vault ``vault_arn`` exists now (CLO-589).
+
+        True / False only on a read that could see the vault; None when it
+        could not be judged (a cross-account vault, a failed read, a
+        provider that cannot look): MISSING, never "exists". ListCopyJobs
+        keeps a deleted vault's COMPLETED jobs for its whole window, so
+        backup_copy_policy_overreach needs this before naming a vault. The
+        default cannot look."""
+        return None
+
     # =========================================================================
     # DocumentDB
     # =========================================================================

{cloudcostwise-0.1.2 → cloudcostwise-0.1.3}/src/cloudwise_scan_core/data_providers/missing_data.py

@@ -23,6 +23,13 @@ logger = logging.getLogger(__name__)
 # Example resource ids kept in a note; the count covers the rest.
 _MAX_EXAMPLES = 3
 
+# CLO-589 follow-up: the one note kinesis_enhanced_fan_out_waste's withheld
+# verdicts share (both providers, the base default and the detector), kept
+# apart from the stream-level 'kinesis' note so their wording never mixes.
+KINESIS_EFO_NOTE_SERVICE = 'kinesis enhanced fan-out'
+KINESIS_EFO_NOTE_VERDICT = 'never-subscribed consumer'
+KINESIS_EFO_NOTE_EVIDENCE = 'SubscribeToShard series (ListMetrics)'
+
 
 class MissingDataNotesMixin:
     """Provider mixin. Needs ``self.data_warnings`` (a list), ``self._region``

{cloudcostwise-0.1.2 → cloudcostwise-0.1.3}/src/cloudwise_scan_core/data_providers/models.py

@@ -583,6 +583,15 @@ class ElastiCacheMetricsData:
     # applies to the CurrConnections coverage check — otherwise a shorter
     # export could never pass a coverage gate sized to the full window.
     cpu_window_days: Optional[int] = None
+    # CLO-572: DatabaseMemoryUsagePercentage datapoints behind
+    # database_memory_usage_pct, the same convention as cpu_datapoints: None
+    # means not reported, 0 means a read with no data (MISSING, never read
+    # as 0% used). oversized_elasticache's memory gate needs 75% coverage
+    # of memory_window_days (cpu_window_days's sibling: None means use
+    # period_days, the offline provider clamps it to the export's own
+    # shorter window).
+    memory_datapoints: Optional[int] = None
+    memory_window_days: Optional[int] = None
 
 
 @dataclass
@@ -1422,8 +1431,11 @@ class NeptuneSnapshotData:
 class NeptuneMetricsData:
     """Normalized Neptune cluster CloudWatch metrics."""
     cluster_id: str
-    gremlin_requests: int = 0
-    sparql_requests: int = 0
+    # CLO-584: floats, not int -- a lightly used cluster's per-second-rate
+    # Sum over the window can be well under 1, and an int() truncation made
+    # that indistinguishable from true zero traffic.
+    gremlin_requests: float = 0.0
+    sparql_requests: float = 0.0
     avg_cpu: float = 0.0
     max_cpu: float = 0.0  # window maximum of hourly Maximums; reported, not gated by oversized_neptune
     # CLO-480: the shared CPU rule's inputs (cloudwise_scan_core.cpu_sizing)