cortexapps-cli 1.27.0__tar.gz → 1.29.0__tar.gz

{cortexapps_cli-1.27.0 → cortexapps_cli-1.29.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cortexapps-cli
-Version: 1.27.0
+Version: 1.29.0
 Summary: Command Line Interface for cortexapps
 License: MIT
 License-File: LICENSE

{cortexapps_cli-1.27.0 → cortexapps_cli-1.29.0}/cortexapps_cli/commands/backup.py

@@ -471,6 +471,47 @@ def _import_entity_relationships(ctx, directory):
 
     return ("entity-relationships", len(results) - failed_count, [(fp, et, em) for rt, fp, et, em in results if et])
 
+def _import_custom_metrics(ctx, directory):
+    imported = 0
+    failed = []
+    if os.path.isdir(directory):
+        print("Processing: " + directory)
+        client = ctx.obj["client"]
+        for filename in sorted(os.listdir(directory)):
+            if not filename.endswith(".json"):
+                continue
+            file_path = os.path.join(directory, filename)
+            if not os.path.isfile(file_path):
+                continue
+            metric_key = filename[:-5]  # strip .json
+            try:
+                print("   Importing: " + filename)
+                with open(file_path) as f:
+                    data = json.load(f)
+
+                # Group flat values list by entityTag
+                grouped = {}
+                for entry in data.get("values", []):
+                    tag = entry["entityTag"]
+                    if tag not in grouped:
+                        grouped[tag] = []
+                    grouped[tag].append({
+                        "timestamp": entry["timestamp"],
+                        "value": entry["value"],
+                    })
+
+                # Call per-entity bulk endpoint once per entity
+                for entity_tag, series in grouped.items():
+                    client.post(
+                        f"api/v1/eng-intel/custom-metrics/{metric_key}/entity/{entity_tag}/bulk",
+                        data={"series": series},
+                    )
+                imported += 1
+            except Exception as e:
+                print(f"   Failed to import {filename}: {type(e).__name__} - {str(e)}")
+                failed.append((file_path, type(e).__name__, str(e)))
+    return ("custom-metrics", imported, failed)
+
 def _has_relationships(file_path):
     """Check if a catalog YAML file contains x-cortex-relationships."""
     try:
@@ -760,6 +801,7 @@ def import_tenant(
     all_stats.append(_import_entity_relationship_types(ctx, directory + "/entity-relationship-types"))
     all_stats.append(_import_catalog(ctx, directory + "/catalog"))
     all_stats.append(_import_entity_relationships(ctx, directory + "/entity-relationships"))
+    all_stats.append(_import_custom_metrics(ctx, directory + "/custom-metrics"))
     all_stats.append(_import_plugins(ctx, directory + "/plugins"))
     all_stats.append(_import_scorecards(ctx, directory + "/scorecards"))
     all_stats.append(_import_workflows(ctx, directory + "/workflows"))
@@ -811,6 +853,8 @@ def import_tenant(
             elif import_type == "entity-relationships":
                 # These need special handling - would need the relationship type
                 print(f"# Manual retry needed for entity-relationships: {file_path}")
+            elif import_type == "custom-metrics":
+                print(f"# Manual retry needed for custom-metrics: {file_path}")
             elif import_type == "plugins":
                 print(f"cortex plugins create --force -f \"{file_path}\"")
             elif import_type == "scorecards":

{cortexapps_cli-1.27.0 → cortexapps_cli-1.29.0}/cortexapps_cli/commands/plugins.py

@@ -87,6 +87,8 @@ def create(
             # Remove the 'tag' attribute if it exists
             data.pop("tag", None)
             r = client.put("api/v1/plugins/" + tag, data, raw_response=True)
+        else:
+            r = client.post("api/v1/plugins", data, raw_response=True)
     else:
         r = client.post("api/v1/plugins", data, raw_response=True)
 
@@ -142,12 +144,18 @@ def get(
 def replace(
     ctx: typer.Context,
     file_input: Annotated[typer.FileText, typer.Option("--file", "-f", help="File containing contents of plugin using schema defined at https://docs.cortex.io/docs/api/create-plugin")] = None,
-    tag_or_id: str = typer.Option(..., "--tag-or-id", "-t", help="The tag (x-cortex-tag) or unique, auto-generated identifier for the entity.")
+    tag_or_id: str = typer.Option(None, "--tag-or-id", "-t", help="The tag or ID of the plugin to replace. Defaults to the tag field in the file."),
 ):
     """
     Replace an existing plugin by tag
     """
 
     client = ctx.obj["client"]
-    
-    client.put("api/v1/plugins/"+ tag_or_id, data=file_input.read())
+
+    data = json.loads(file_input.read())
+    resolved = tag_or_id or data.get("tag")
+    if not resolved:
+        typer.echo("Error: --tag-or-id is required when the file does not contain a 'tag' field.")
+        raise typer.Exit(1)
+
+    client.put("api/v1/plugins/" + resolved, data=data)

{cortexapps_cli-1.27.0 → cortexapps_cli-1.29.0}/cortexapps_cli/commands/solutions.py

@@ -280,6 +280,7 @@ def _collect_solution_resources(path: Path) -> dict[str, list[str]]:
         "catalog": [],
         "scorecards": [],
         "workflows": [],
+        "plugins": [],
     }
     for kind in resources:
         subdir = path / kind
@@ -336,7 +337,7 @@ def _run_uninstall(client, path: Path, yes: bool) -> None:
         return
 
     typer.echo("\nThis will remove the following resources:")
-    for kind in ("workflows", "scorecards", "catalog", "entity-relationship-types", "entity-types"):
+    for kind in ("workflows", "scorecards", "plugins", "catalog", "entity-relationship-types", "entity-types"):
         count = len(resources[kind])
         if count:
             typer.echo(f"  {kind}: {count}")
@@ -352,6 +353,7 @@ def _run_uninstall(client, path: Path, yes: bool) -> None:
     steps = [
         ("workflows",                 lambda t: f"api/v1/workflows/{t}"),
         ("scorecards",                lambda t: f"api/v1/scorecards/{t}"),
+        ("plugins",                   lambda t: f"api/v1/plugins/{t}"),
         ("catalog",                   lambda t: f"api/v1/catalog/{t}"),
         ("entity-relationship-types", lambda t: f"api/v1/relationship-types/{t}"),
         ("entity-types",              lambda t: f"api/v1/catalog/definitions/{t}"),

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/.github/workflows/sync-claude-spend.yaml

@@ -0,0 +1,27 @@
+name: Sync Claude AI Spend to Cortex
+
+on:
+  schedule:
+    - cron: "0 6 * * 1"  # Every Monday at 06:00 UTC
+  workflow_dispatch:       # Allow manual runs from the Actions tab
+
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: pip install requests
+
+      - name: Sync Claude spend to Cortex
+        env:
+          ANTHROPIC_ANALYTICS_KEY: ${{ secrets.ANTHROPIC_ANALYTICS_KEY }}
+          CORTEX_API_KEY: ${{ secrets.CORTEX_API_KEY }}
+        run: python scripts/sync-claude-spend.py

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/README.md

@@ -0,0 +1,165 @@
+---
+name: AI Spend
+description: Track per-employee Claude AI spend in Cortex using custom metrics, with a full team hierarchy for rollup visibility.
+---
+
+# AI Spend
+
+Answers the question: **"How much are we spending on Claude AI, and who's spending it?"**
+
+Register every employee as a Cortex entity linked to their team, push weekly Claude spend as a custom metric, and roll costs up the org hierarchy — from individual → sub-team → top-level engineering.
+
+## How It Works
+
+```
+  ┌─────────────────────┐        every Monday 06:00 UTC
+  │   GitHub Actions    │◄──────────────────────────────────┐
+  │  sync-claude-spend  │                                   │
+  └────────┬────────────┘                             (cron schedule)
+           │
+           │ GET /v1/organizations/analytics/costs
+           ▼
+  ┌─────────────────────┐
+  │  Anthropic Claude   │   per-user spend for the week
+  │   Analytics API     │
+  └────────┬────────────┘
+           │
+           │ map email → employee-first-last
+           │ sum members → team rollups
+           ▼
+  ┌─────────────────────┐
+  │    Cortex API       │   POST ai-spend custom metric
+  │  Custom Metrics     │   per employee + per team
+  └────────┬────────────┘
+           │
+           ▼
+  ┌──────────────────────────────────────────────┐
+  │              Cortex Catalog                  │
+  │                                              │
+  │  team-engineering        $1,212/wk  Silver   │
+  │  ├── team-platform         $473/wk  Gold     │
+  │  │   ├── employee-alice      $291/wk         │
+  │  │   └── employee-bob        $182/wk         │
+  │  ├── team-frontend         $380/wk  Silver   │
+  │  │   ├── employee-carol      $245/wk         │
+  │  │   └── employee-david      $136/wk         │
+  │  └── team-data             $359/wk  Bronze   │
+  │      └── employee-emma      $359/wk          │
+  │                                              │
+  │  Scorecard: ai-spend-scorecard               │
+  │  Plugin:    team-ai-spend (per-team chart)   │
+  └──────────────────────────────────────────────┘
+```
+
+## What's Included
+
+| Resource | Tag / Key |
+|---|---|
+| Entity type | `employee` |
+| Relationship type | `team-member` (team → team\|employee) |
+| Teams | `team-engineering`, `team-platform`, `team-frontend`, `team-data` |
+| Employees | `employee-alice-chen`, `employee-bob-martinez`, `employee-carol-kim`, `employee-david-osei`, `employee-emma-johnson` |
+| Custom metric sample data | `ai-spend` (8 weeks, fictional, per-employee and team rollups) |
+| Plugin | `team-ai-spend` (team-scoped spend visualization) |
+| Scorecard | `ai-spend-scorecard` (bronze/silver/gold budget compliance) |
+| Sync script | `scripts/sync-claude-spend.py` |
+| GH Actions workflow | `.github/workflows/sync-claude-spend.yaml` |
+
+## Prerequisites
+
+Before installing, create the `ai-spend` custom metric definition in your Cortex instance:
+**Eng Intel → Custom Metrics → New Metric**, key: `ai-spend`.
+
+## Installation
+
+```
+cortex solutions install -s ai-spend
+```
+
+## After Installing
+
+**Create the team-member catalog**
+
+Enable the relationship type catalog so you can browse team membership from the Cortex UI:
+
+1. Go to **Settings → Entity Relationship Types → team-member**
+2. Click **Edit** and enable **Create relationship type catalog**
+3. Save
+
+**View the AI Spend Budget Compliance scorecard**
+
+An `ai-spend-scorecard` is installed automatically and tracks whether each team's weekly spend stays within budget:
+
+- **Bronze** — team has `ai-spend` metric data in the last 8 days and a budget set
+- **Silver** — spend is within 25% of budget
+- **Gold** — spend is at or under budget
+
+The sample data is pre-loaded with budgets that produce an interesting distribution: team-platform achieves Gold, team-frontend and team-engineering achieve Silver, and team-data achieves Bronze.
+
+To set a budget for a real team, add `ai-budget-weekly` as custom data on the team entity:
+
+```bash
+cortex custom-data add -t <team-tag> -k ai-budget-weekly -v <weekly-budget-dollars>
+```
+
+**View the Team AI Spend plugin**
+
+A `team-ai-spend` plugin is installed automatically and appears on every team entity page. It shows the team's total weekly AI spend and a per-member breakdown bar chart, pulling live data from the `ai-spend` custom metric.
+
+**Create a Tabular View for AI spend**
+
+Build a Data Explorer table to compare spend across employees and teams:
+
+1. Go to **Eng Intelligence → Data Explorer**
+2. Select the **Table** view
+3. Click **Add column**, find `ai-spend` under the **Custom** category, and click **View metric**
+4. Set **Group by → Team** and enable **Show hierarchy** to roll up spend to team level
+5. Click **Save As** to name and save the view for future use
+
+> Note: Tabular View creation is not yet available via API. It must be configured manually.
+
+**Set up live Claude spend sync**
+
+The sample entities include fictional spend data. To push real data from your Anthropic Claude Enterprise account weekly:
+
+1. **Get an Analytics API key:**
+   - Sign in to claude.ai as the **primary owner** of your organization
+   - Go to **Organization settings → API**
+   - Enable public API access and create an Analytics API key
+   - (Only the primary owner can create this key — admin role is not sufficient)
+
+2. **Add secrets to your GitHub repo:**
+   - `ANTHROPIC_ANALYTICS_KEY` — the Analytics API key from step 1
+   - `CORTEX_API_KEY` — your Cortex API key
+
+3. **Copy the workflow** to your repo's `.github/workflows/` directory:
+   ```bash
+   cp .github/workflows/sync-claude-spend.yaml <your-repo>/.github/workflows/
+   ```
+
+4. **Copy the script** to your repo's `scripts/` directory:
+   ```bash
+   cp scripts/sync-claude-spend.py <your-repo>/scripts/
+   ```
+
+The workflow runs every Monday at 06:00 UTC and can be triggered manually from the GitHub Actions tab.
+
+**Customize the email domain**
+
+The sync script maps `first.last@cortex.io` → `employee-first-last`. Set `EMAIL_DOMAIN` in the workflow env to match your company's domain:
+
+```yaml
+env:
+  EMAIL_DOMAIN: yourcompany.com
+```
+
+**Add your real employees**
+
+The sample entities are fictional. Add your real employees as catalog entities with `x-cortex-type: employee` and tag them `employee-<first>-<last>` to match the email mapping.
+
+**Notes**
+
+- Users who authenticate Claude Code with a personal API key (not Enterprise OAuth) show $0 spend in the Analytics API and are skipped automatically.
+- Cost data may take up to 24 hours to appear; dates at least 30 days old are considered final for billing purposes.
+- The `ai-spend` custom metric definition must currently be created manually before installing. A future release will support auto-creation of custom metric definitions as part of `cortex solutions install`.
+- The scorecard's Bronze rule uses a `P1Y` lookback to accommodate sample data. Once your weekly sync is running consistently, consider tightening it to `P8D` to ensure the rule only passes when data is fresh. The Silver and Gold rules use `P8D` and can similarly be adjusted to match your sync frequency.

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/catalog/employee-alice-chen.yaml

@@ -0,0 +1,7 @@
+openapi: "3.0.0"
+info:
+  title: Alice Chen
+  x-cortex-tag: employee-alice-chen
+  x-cortex-type: employee
+  x-cortex-description: Platform Engineer
+  x-cortex-definition: {}

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/catalog/employee-bob-martinez.yaml

@@ -0,0 +1,7 @@
+openapi: "3.0.0"
+info:
+  title: Bob Martinez
+  x-cortex-tag: employee-bob-martinez
+  x-cortex-type: employee
+  x-cortex-description: Platform Engineer
+  x-cortex-definition: {}

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/catalog/employee-carol-kim.yaml

@@ -0,0 +1,7 @@
+openapi: "3.0.0"
+info:
+  title: Carol Kim
+  x-cortex-tag: employee-carol-kim
+  x-cortex-type: employee
+  x-cortex-description: Frontend Engineer
+  x-cortex-definition: {}

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/catalog/employee-david-osei.yaml

@@ -0,0 +1,7 @@
+openapi: "3.0.0"
+info:
+  title: David Osei
+  x-cortex-tag: employee-david-osei
+  x-cortex-type: employee
+  x-cortex-description: Frontend Engineer
+  x-cortex-definition: {}

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/catalog/employee-emma-johnson.yaml

@@ -0,0 +1,7 @@
+openapi: "3.0.0"
+info:
+  title: Emma Johnson
+  x-cortex-tag: employee-emma-johnson
+  x-cortex-type: employee
+  x-cortex-description: Data Engineer
+  x-cortex-definition: {}

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/catalog/team-data.yaml

@@ -0,0 +1,20 @@
+openapi: "3.0.0"
+info:
+  title: Data
+  x-cortex-tag: team-data
+  x-cortex-type: team
+  x-cortex-description: Data engineering team
+  x-cortex-definition: {}
+  x-cortex-groups:
+    - ai-spend-demo
+  x-cortex-team:
+    members:
+      - name: Emma Johnson
+        email: emma.johnson@cortex.io
+  x-cortex-custom-data:
+    - key: ai-budget-weekly
+      value: 280
+  x-cortex-relationships:
+    - type: team-member
+      destinations:
+        - tag: employee-emma-johnson

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/catalog/team-engineering.yaml

@@ -0,0 +1,30 @@
+openapi: "3.0.0"
+info:
+  title: Engineering
+  x-cortex-tag: team-engineering
+  x-cortex-type: team
+  x-cortex-description: Top-level engineering organization
+  x-cortex-definition: {}
+  x-cortex-groups:
+    - ai-spend-demo
+  x-cortex-team:
+    members:
+      - name: Alice Chen
+        email: alice.chen@cortex.io
+      - name: Bob Martinez
+        email: bob.martinez@cortex.io
+      - name: Carol Kim
+        email: carol.kim@cortex.io
+      - name: David Osei
+        email: david.osei@cortex.io
+      - name: Emma Johnson
+        email: emma.johnson@cortex.io
+  x-cortex-custom-data:
+    - key: ai-budget-weekly
+      value: 1100
+  x-cortex-relationships:
+    - type: team-member
+      destinations:
+        - tag: team-platform
+        - tag: team-frontend
+        - tag: team-data

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/catalog/team-frontend.yaml

@@ -0,0 +1,23 @@
+openapi: "3.0.0"
+info:
+  title: Frontend
+  x-cortex-tag: team-frontend
+  x-cortex-type: team
+  x-cortex-description: Frontend engineering team
+  x-cortex-definition: {}
+  x-cortex-groups:
+    - ai-spend-demo
+  x-cortex-team:
+    members:
+      - name: Carol Kim
+        email: carol.kim@cortex.io
+      - name: David Osei
+        email: david.osei@cortex.io
+  x-cortex-custom-data:
+    - key: ai-budget-weekly
+      value: 360
+  x-cortex-relationships:
+    - type: team-member
+      destinations:
+        - tag: employee-carol-kim
+        - tag: employee-david-osei

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/catalog/team-platform.yaml

@@ -0,0 +1,23 @@
+openapi: "3.0.0"
+info:
+  title: Platform
+  x-cortex-tag: team-platform
+  x-cortex-type: team
+  x-cortex-description: Platform engineering team
+  x-cortex-definition: {}
+  x-cortex-groups:
+    - ai-spend-demo
+  x-cortex-team:
+    members:
+      - name: Alice Chen
+        email: alice.chen@cortex.io
+      - name: Bob Martinez
+        email: bob.martinez@cortex.io
+  x-cortex-custom-data:
+    - key: ai-budget-weekly
+      value: 480
+  x-cortex-relationships:
+    - type: team-member
+      destinations:
+        - tag: employee-alice-chen
+        - tag: employee-bob-martinez

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/custom-metrics/ai-spend.json

@@ -0,0 +1,84 @@
+{
+  "values": [
+    { "entityTag": "employee-alice-chen", "timestamp": "2026-06-09T00:00:00", "value": 38.20 },
+    { "entityTag": "employee-alice-chen", "timestamp": "2026-06-16T00:00:00", "value": 56.40 },
+    { "entityTag": "employee-alice-chen", "timestamp": "2026-06-23T00:00:00", "value": 79.80 },
+    { "entityTag": "employee-alice-chen", "timestamp": "2026-06-30T00:00:00", "value": 127.30 },
+    { "entityTag": "employee-alice-chen", "timestamp": "2026-07-07T00:00:00", "value": 179.60 },
+    { "entityTag": "employee-alice-chen", "timestamp": "2026-07-14T00:00:00", "value": 234.80 },
+    { "entityTag": "employee-alice-chen", "timestamp": "2026-07-21T00:00:00", "value": 268.90 },
+    { "entityTag": "employee-alice-chen", "timestamp": "2026-07-28T00:00:00", "value": 291.40 },
+
+    { "entityTag": "employee-bob-martinez", "timestamp": "2026-06-09T00:00:00", "value": 24.10 },
+    { "entityTag": "employee-bob-martinez", "timestamp": "2026-06-16T00:00:00", "value": 31.80 },
+    { "entityTag": "employee-bob-martinez", "timestamp": "2026-06-23T00:00:00", "value": 54.20 },
+    { "entityTag": "employee-bob-martinez", "timestamp": "2026-06-30T00:00:00", "value": 75.40 },
+    { "entityTag": "employee-bob-martinez", "timestamp": "2026-07-07T00:00:00", "value": 118.30 },
+    { "entityTag": "employee-bob-martinez", "timestamp": "2026-07-14T00:00:00", "value": 141.70 },
+    { "entityTag": "employee-bob-martinez", "timestamp": "2026-07-21T00:00:00", "value": 173.90 },
+    { "entityTag": "employee-bob-martinez", "timestamp": "2026-07-28T00:00:00", "value": 181.60 },
+
+    { "entityTag": "employee-carol-kim", "timestamp": "2026-06-09T00:00:00", "value": 27.30 },
+    { "entityTag": "employee-carol-kim", "timestamp": "2026-06-16T00:00:00", "value": 47.10 },
+    { "entityTag": "employee-carol-kim", "timestamp": "2026-06-23T00:00:00", "value": 66.80 },
+    { "entityTag": "employee-carol-kim", "timestamp": "2026-06-30T00:00:00", "value": 108.40 },
+    { "entityTag": "employee-carol-kim", "timestamp": "2026-07-07T00:00:00", "value": 157.20 },
+    { "entityTag": "employee-carol-kim", "timestamp": "2026-07-14T00:00:00", "value": 189.60 },
+    { "entityTag": "employee-carol-kim", "timestamp": "2026-07-21T00:00:00", "value": 231.50 },
+    { "entityTag": "employee-carol-kim", "timestamp": "2026-07-28T00:00:00", "value": 244.70 },
+
+    { "entityTag": "employee-david-osei", "timestamp": "2026-06-09T00:00:00", "value": 14.80 },
+    { "entityTag": "employee-david-osei", "timestamp": "2026-06-16T00:00:00", "value": 27.30 },
+    { "entityTag": "employee-david-osei", "timestamp": "2026-06-23T00:00:00", "value": 41.20 },
+    { "entityTag": "employee-david-osei", "timestamp": "2026-06-30T00:00:00", "value": 55.60 },
+    { "entityTag": "employee-david-osei", "timestamp": "2026-07-07T00:00:00", "value": 89.40 },
+    { "entityTag": "employee-david-osei", "timestamp": "2026-07-14T00:00:00", "value": 104.80 },
+    { "entityTag": "employee-david-osei", "timestamp": "2026-07-21T00:00:00", "value": 129.70 },
+    { "entityTag": "employee-david-osei", "timestamp": "2026-07-28T00:00:00", "value": 135.50 },
+
+    { "entityTag": "employee-emma-johnson", "timestamp": "2026-06-09T00:00:00", "value": 46.20 },
+    { "entityTag": "employee-emma-johnson", "timestamp": "2026-06-16T00:00:00", "value": 62.90 },
+    { "entityTag": "employee-emma-johnson", "timestamp": "2026-06-23T00:00:00", "value": 107.40 },
+    { "entityTag": "employee-emma-johnson", "timestamp": "2026-06-30T00:00:00", "value": 149.80 },
+    { "entityTag": "employee-emma-johnson", "timestamp": "2026-07-07T00:00:00", "value": 231.60 },
+    { "entityTag": "employee-emma-johnson", "timestamp": "2026-07-14T00:00:00", "value": 279.30 },
+    { "entityTag": "employee-emma-johnson", "timestamp": "2026-07-21T00:00:00", "value": 341.20 },
+    { "entityTag": "employee-emma-johnson", "timestamp": "2026-07-28T00:00:00", "value": 358.70 },
+
+    { "entityTag": "team-platform", "timestamp": "2026-06-09T00:00:00", "value": 62.30 },
+    { "entityTag": "team-platform", "timestamp": "2026-06-16T00:00:00", "value": 88.20 },
+    { "entityTag": "team-platform", "timestamp": "2026-06-23T00:00:00", "value": 134.00 },
+    { "entityTag": "team-platform", "timestamp": "2026-06-30T00:00:00", "value": 202.70 },
+    { "entityTag": "team-platform", "timestamp": "2026-07-07T00:00:00", "value": 297.90 },
+    { "entityTag": "team-platform", "timestamp": "2026-07-14T00:00:00", "value": 376.50 },
+    { "entityTag": "team-platform", "timestamp": "2026-07-21T00:00:00", "value": 442.80 },
+    { "entityTag": "team-platform", "timestamp": "2026-07-28T00:00:00", "value": 473.00 },
+
+    { "entityTag": "team-frontend", "timestamp": "2026-06-09T00:00:00", "value": 42.10 },
+    { "entityTag": "team-frontend", "timestamp": "2026-06-16T00:00:00", "value": 74.40 },
+    { "entityTag": "team-frontend", "timestamp": "2026-06-23T00:00:00", "value": 108.00 },
+    { "entityTag": "team-frontend", "timestamp": "2026-06-30T00:00:00", "value": 164.00 },
+    { "entityTag": "team-frontend", "timestamp": "2026-07-07T00:00:00", "value": 246.60 },
+    { "entityTag": "team-frontend", "timestamp": "2026-07-14T00:00:00", "value": 294.40 },
+    { "entityTag": "team-frontend", "timestamp": "2026-07-21T00:00:00", "value": 361.20 },
+    { "entityTag": "team-frontend", "timestamp": "2026-07-28T00:00:00", "value": 380.20 },
+
+    { "entityTag": "team-data", "timestamp": "2026-06-09T00:00:00", "value": 46.20 },
+    { "entityTag": "team-data", "timestamp": "2026-06-16T00:00:00", "value": 62.90 },
+    { "entityTag": "team-data", "timestamp": "2026-06-23T00:00:00", "value": 107.40 },
+    { "entityTag": "team-data", "timestamp": "2026-06-30T00:00:00", "value": 149.80 },
+    { "entityTag": "team-data", "timestamp": "2026-07-07T00:00:00", "value": 231.60 },
+    { "entityTag": "team-data", "timestamp": "2026-07-14T00:00:00", "value": 279.30 },
+    { "entityTag": "team-data", "timestamp": "2026-07-21T00:00:00", "value": 341.20 },
+    { "entityTag": "team-data", "timestamp": "2026-07-28T00:00:00", "value": 358.70 },
+
+    { "entityTag": "team-engineering", "timestamp": "2026-06-09T00:00:00", "value": 150.60 },
+    { "entityTag": "team-engineering", "timestamp": "2026-06-16T00:00:00", "value": 225.50 },
+    { "entityTag": "team-engineering", "timestamp": "2026-06-23T00:00:00", "value": 349.40 },
+    { "entityTag": "team-engineering", "timestamp": "2026-06-30T00:00:00", "value": 516.50 },
+    { "entityTag": "team-engineering", "timestamp": "2026-07-07T00:00:00", "value": 776.10 },
+    { "entityTag": "team-engineering", "timestamp": "2026-07-14T00:00:00", "value": 950.20 },
+    { "entityTag": "team-engineering", "timestamp": "2026-07-21T00:00:00", "value": 1145.20 },
+    { "entityTag": "team-engineering", "timestamp": "2026-07-28T00:00:00", "value": 1211.90 }
+  ]
+}

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/entity-relationship-types/team-member.json

@@ -0,0 +1,20 @@
+{
+  "tag": "team-member",
+  "name": "Team Member",
+  "description": "Links a team to its direct members, which can be sub-teams or individual employees. Use this single relationship type to walk the full org hierarchy in the catalog.",
+  "definitionLocation": "SOURCE",
+  "isSingleSource": false,
+  "isSingleDestination": false,
+  "allowCycles": false,
+  "sourcesFilter": {
+    "include": true,
+    "types": ["team"],
+    "providers": []
+  },
+  "destinationsFilter": {
+    "include": true,
+    "types": ["team", "employee"],
+    "providers": []
+  },
+  "inheritances": []
+}

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/entity-types/employee.json

@@ -0,0 +1,7 @@
+{
+  "type": "employee",
+  "name": "Employee",
+  "description": "A member of the organization. Used to track AI tool usage and spend per person.",
+  "iconTag": "Cortex-builtin::Person",
+  "schema": {"type": "object", "properties": {}}
+}

cortexapps_cli-1.29.0/cortexapps_cli/solutions/ai-spend/plugins/team-ai-spend.json

@@ -0,0 +1,14 @@
+{
+  "tag": "team-ai-spend",
+  "name": "Team AI Spend",
+  "description": "Visualizes per-member Claude AI spend for the team with a weekly total and per-member breakdown chart.",
+  "isDraft": false,
+  "minimumRoleRequired": "VIEWER",
+  "contexts": [
+    { "type": "ENTITY", "entityFilter": { "type": "CQL_FILTER", "category": "Team", "query": "hasGroup(\"ai-spend-demo\")" } }
+  ],
+  "proxyTag": null,
+  "iconTag": null,
+  "version": null,
+  "blob": "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>Team AI Spend</title>\n  <script src=\"https://cdn.jsdelivr.net/npm/@iframe-resizer/child@5/index.umd.js\"></script>\n  <script src=\"https://cdn.jsdelivr.net/npm/chart.js@4/dist/chart.umd.min.js\"></script>\n  <style>\n    * { box-sizing: border-box; margin: 0; padding: 0; }\n    body {\n      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;\n      background: #fff;\n      color: #111827;\n      padding: 16px;\n      font-size: 14px;\n    }\n    #loading { text-align: center; padding: 40px 16px; color: #9ca3af; }\n    #error {\n      background: #fef2f2;\n      border: 1px solid #fca5a5;\n      border-radius: 8px;\n      padding: 12px 16px;\n      color: #dc2626;\n      display: none;\n    }\n    .total-card {\n      background: linear-gradient(135deg, #6366f1 0%, #7c3aed 100%);\n      border-radius: 12px;\n      padding: 20px 24px;\n      color: #fff;\n      margin-bottom: 20px;\n    }\n    .total-label {\n      font-size: 12px;\n      font-weight: 500;\n      opacity: 0.8;\n      text-transform: uppercase;\n      letter-spacing: 0.08em;\n      margin-bottom: 6px;\n    }\n    .total-amount {\n      font-size: 40px;\n      font-weight: 700;\n      line-height: 1;\n      margin-bottom: 4px;\n    }\n    .total-period { font-size: 12px; opacity: 0.65; }\n    .section-label {\n      font-size: 11px;\n      font-weight: 600;\n      text-transform: uppercase;\n      letter-spacing: 0.08em;\n      color: #6b7280;\n      margin-bottom: 12px;\n    }\n    #content { display: none; }\n  </style>\n</head>\n<body>\n  <div id=\"loading\">Loading AI spend data\u2026</div>\n  <div id=\"error\"></div>\n  <div id=\"content\">\n    <div class=\"total-card\" id=\"total-card\">\n      <div class=\"total-label\">Team Weekly AI Spend</div>\n      <div class=\"total-amount\" id=\"total-amount\">$0</div>\n      <div class=\"total-period\" id=\"total-period\"></div>\n    </div>\n    <div class=\"section-label\">Per-Member Breakdown</div>\n    <canvas id=\"chart\"></canvas>\n  </div>\n\n  <script>\n    function tagToName(tag) {\n      return tag.replace(/^employee-/, '').split('-')\n        .map(function(w) { return w.charAt(0).toUpperCase() + w.slice(1); })\n        .join(' ');\n    }\n\n    function getContext() {\n      return new Promise(function(resolve, reject) {\n        var ch = new MessageChannel();\n        ch.port1.onmessage = function(e) {\n          if (e.data.ok) resolve(e.data.data);\n          else reject(e.data);\n        };\n        parent.postMessage({ type: 'context' }, '*', [ch.port2]);\n      });\n    }\n\n    function proxyFetch(url, init) {\n      return new Promise(function(resolve, reject) {\n        var ch = new MessageChannel();\n        ch.port1.onmessage = function(e) {\n          if (e.data.ok) resolve(e.data.data);\n          else reject(new Error('fetch failed: ' + JSON.stringify(e.data)));\n        };\n        parent.postMessage({ type: 'fetch', input: url, init: init || {} }, '*', [ch.port2]);\n      });\n    }\n\n    function showError(msg) {\n      document.getElementById('loading').style.display = 'none';\n      var el = document.getElementById('error');\n      el.textContent = msg;\n      el.style.display = 'block';\n    }\n\n    async function main() {\n      try {\n        var pluginCtx = await getContext();\n        var apiBaseUrl = pluginCtx.apiBaseUrl;\n        var teamTag = (pluginCtx.entity && pluginCtx.entity.tag) || pluginCtx.tag;\n\n        if (!teamTag) { showError('No team entity found in plugin context.'); return; }\n\n        var relRes = await proxyFetch(apiBaseUrl + '/relationships/team-member?pageSize=500');\n        if (!relRes.ok) throw new Error('Failed to fetch team relationships: ' + relRes.status);\n        var relData = JSON.parse(relRes.body);\n\n        var adjacency = {};\n        (relData.relationships || []).forEach(function(r) {\n          if (!r.sourceEntity || !r.destinationEntity) return;\n          var src = r.sourceEntity.tag;\n          if (!adjacency[src]) adjacency[src] = [];\n          adjacency[src].push(r.destinationEntity);\n        });\n\n        function collectEmployees(tag, visited) {\n          if (visited[tag]) return [];\n          visited[tag] = true;\n          var employees = [];\n          (adjacency[tag] || []).forEach(function(dst) {\n            if (adjacency[dst.tag]) {\n              employees = employees.concat(collectEmployees(dst.tag, visited));\n            } else {\n              employees.push({ tag: dst.tag, name: dst.name || tagToName(dst.tag) });\n            }\n          });\n          return employees;\n        }\n\n        var members = collectEmployees(teamTag, {});\n        if (!members.length) {\n          showError('No team members found. Make sure team-member relationships are set up.');\n          return;\n        }\n\n        var budget = null;\n        try {\n          var budgetRes = await proxyFetch(apiBaseUrl + '/catalog/' + encodeURIComponent(teamTag) + '/custom-data/ai-budget-weekly');\n          if (budgetRes.ok) {\n            var budgetData = JSON.parse(budgetRes.body);\n            if (budgetData.value != null) budget = parseFloat(budgetData.value);\n          }\n        } catch (e) {}\n\n        var spendResults = await Promise.all(members.map(async function(m) {\n          try {\n            var r = await proxyFetch(apiBaseUrl + '/eng-intel/custom-metrics/ai-spend/entity/' + encodeURIComponent(m.tag) + '?pageSize=100');\n            if (!r.ok) return Object.assign({}, m, { spend: 0, timestamp: null });\n            var d = JSON.parse(r.body);\n            var values = d.data || d.values || d.series || [];\n            if (!values.length) return Object.assign({}, m, { spend: 0, timestamp: null });\n            values.sort(function(a, b) { return new Date(b.timestamp) - new Date(a.timestamp); });\n            return Object.assign({}, m, { spend: values[0].value || 0, timestamp: values[0].timestamp });\n          } catch (e) {\n            return Object.assign({}, m, { spend: 0, timestamp: null });\n          }\n        }));\n\n        var withSpend = spendResults.filter(function(m) { return m.spend > 0; });\n        if (!withSpend.length) {\n          showError('No ai-spend metric data found. Make sure the ai-spend custom metric has been pushed for team members.');\n          return;\n        }\n\n        var total = withSpend.reduce(function(s, m) { return s + m.spend; }, 0);\n        var latestDate = withSpend.map(function(m) { return m.timestamp; }).filter(Boolean).sort().pop();\n\n        document.getElementById('loading').style.display = 'none';\n        document.getElementById('content').style.display = 'block';\n        document.getElementById('total-amount').textContent = '$' + total.toFixed(2);\n        if (latestDate) {\n          var d = new Date(latestDate);\n          document.getElementById('total-period').textContent =\n            'Week of ' + d.toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric' });\n        }\n\n        if (budget !== null) {\n          var card = document.getElementById('total-card');\n          card.style.background = total <= budget\n            ? 'linear-gradient(135deg, #16a34a 0%, #15803d 100%)'\n            : 'linear-gradient(135deg, #dc2626 0%, #b91c1c 100%)';\n        }\n\n        // Chart entries: Team Total bar first, then members sorted by spend desc\n        var sorted = withSpend.slice().sort(function(a, b) { return b.spend - a.spend; });\n        var entries = [{ name: 'Team Total', spend: total, isTotal: true }].concat(sorted);\n\n        var palette = ['#6366f1', '#7c3aed', '#8b5cf6', '#a78bfa', '#c4b5fd'];\n\n        // Budget line plugin drawn over the Total bar only\n        var budgetLinePlugin = {\n          id: 'budgetLine',\n          afterDatasetsDraw: function(chart) {\n            if (budget == null) return;\n            var c = chart.ctx;\n            var xScale = chart.scales.x;\n            var yScale = chart.scales.y;\n            var x = xScale.getPixelForValue(budget);\n            // Constrain to the Total bar row only (index 0)\n            var meta = chart.getDatasetMeta(0);\n            if (!meta.data || !meta.data[0]) return;\n            var barTop = meta.data[0].y - meta.data[0].height / 2;\n            var barBottom = meta.data[0].y + meta.data[0].height / 2;\n            c.save();\n            c.beginPath();\n            c.moveTo(x, barTop - 18);\n            c.lineTo(x, yScale.bottom);\n            c.strokeStyle = '#111827';\n            c.lineWidth = 2;\n            c.setLineDash([6, 4]);\n            c.stroke();\n            c.setLineDash([]);\n            c.font = 'bold 11px -apple-system, BlinkMacSystemFont, sans-serif';\n            c.fillStyle = '#111827';\n            c.textAlign = 'center';\n            c.fillText('Budget: $' + budget, x, barTop - 20);\n            c.restore();\n          }\n        };\n\n        // Dataset 1: green for total bar (up to budget), purple for members\n        // Dataset 2: red for total bar overflow only\n        var greenData = entries.map(function(e, i) {\n          if (e.isTotal) return budget !== null ? Math.min(e.spend, budget) : e.spend;\n          return e.spend;\n        });\n        var redData = entries.map(function(e) {\n          return (e.isTotal && budget !== null) ? Math.max(0, e.spend - budget) : 0;\n        });\n        var barColors = entries.map(function(e, i) {\n          if (e.isTotal) return budget !== null ? '#16a34a' : '#6366f1';\n          return palette[(i - 1) % palette.length];\n        });\n\n        new Chart(document.getElementById('chart').getContext('2d'), {\n          type: 'bar',\n          plugins: budget !== null ? [budgetLinePlugin] : [],\n          data: {\n            labels: entries.map(function(e) { return e.name; }),\n            datasets: [\n              {\n                label: 'Spend',\n                data: greenData,\n                backgroundColor: barColors,\n                borderRadius: 0,\n                borderSkipped: false\n              },\n              {\n                label: 'Over Budget',\n                data: redData,\n                backgroundColor: '#dc2626',\n                borderRadius: 4,\n                borderSkipped: false\n              }\n            ]\n          },\n          options: {\n            indexAxis: 'y',\n            responsive: true,\n            layout: { padding: { top: budget !== null ? 24 : 0 } },\n            interaction: { mode: 'nearest', axis: 'x', intersect: true },\n            plugins: {\n              legend: { display: false },\n              tooltip: {\n                filter: function(item) { return item.raw > 0; },\n                callbacks: {\n                  label: function(item) {\n                    var entry = entries[item.dataIndex];\n                    if (entry.isTotal && budget !== null) {\n                      if (item.datasetIndex === 1) return ' Over by: +$' + item.raw.toFixed(2);\n                      return ' Budget: $' + budget.toFixed(2) + '/wk';\n                    }\n                    return ' $' + entry.spend.toFixed(2) + '/wk';\n                  }\n                }\n              }\n            },\n            scales: {\n              x: {\n                stacked: true,\n                beginAtZero: true,\n                suggestedMax: budget !== null ? Math.max(budget, total) * 1.1 : undefined,\n                ticks: { callback: function(v) { return '$' + v; } },\n                grid: { color: '#f3f4f6' }\n              },\n              y: { stacked: true, grid: { display: false } }\n            }\n          }\n        });\n\n      } catch (err) {\n        showError('Error: ' + err.message);\n      }\n    }\n\n    main();\n  </script>\n</body>\n</html>"
+}