cortexapps-cli 1.26.0__tar.gz → 1.28.0__tar.gz

{cortexapps_cli-1.26.0 → cortexapps_cli-1.28.0}/PKG-INFO

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

{cortexapps_cli-1.26.0 → cortexapps_cli-1.28.0}/cortexapps_cli/cli.py

@@ -181,9 +181,11 @@ def login(
     pat_url = f"{ui_base}{DEFAULT_UI_KEYS_PATH}?tenantCode={tenant}"
 
     if open_browser:
-        typer.echo(f"\nOpening browser to the Personal Access Tokens page for workspace '{tenant}'.")
-        typer.echo(f"Create or copy a personal access token, then come back here and paste it below.\n")
+        typer.echo(f"\nWe'll open the Personal Access Tokens page for workspace '{tenant}' in your browser.")
+        typer.echo(f"Create or copy a personal access token, then come back here and paste it below.")
+        typer.confirm("\nReady to open browser?", default=True, abort=True)
         webbrowser.open(pat_url)
+        typer.echo("")
     else:
         typer.echo(f"\nGo to {pat_url} to create or copy a personal access token, then paste it below.\n")
 

cortexapps_cli-1.28.0/cortexapps_cli/solutions/ai-agents/README.md

@@ -0,0 +1,125 @@
+---
+name: AI Agents Catalog
+description: Track internally-built AI agents as first-class Cortex entities, with ownership, model-adoption visibility, and a governance scorecard for engineering leaders.
+---
+
+# AI Agents Catalog
+
+Answers the executive question: **"Where and how are we using AI tooling?"**
+
+Register every internally-built AI agent as a Cortex entity with a named owner, a team, and links to its implementation. The **AI Agent Governance** scorecard ensures each agent is documented, classified by model and criticality tier, and periodically verified — giving leadership a live inventory of AI usage across the organization.
+
+## Overview
+
+```
+  ┌──────────────────────────┐   ┌──────────────────────────┐   ┌──────────────────────────┐
+  │         ai-agent         │   │         ai-agent         │   │         ai-agent         │
+  │       code-review        │   │       audit-flags        │   │       jira-to-kb         │
+  │                          │   │                          │   │                          │
+  │  group: ai-model:        │   │  group: ai-model:        │   │  group: ai-model:        │
+  │    claude-opus-4-6       │   │    claude-sonnet-4-6     │   │  claude-haiku-4-5-...    │
+  │  group: tier1            │   │  group: tier3            │   │  group: tier3            │
+  └──────────────────────────┘   └──────────────────────────┘   └──────────────────────────┘
+
+  Filter by group "ai-model:claude-opus-4-6" → all agents on that model
+  Filter by group "tier1"                    → all business-critical agents
+  Scorecard "AI Agent Governance"            → Bronze / Silver / Gold across the catalog
+```
+
+AI model families and criticality tiers are Cortex **Groups**, not separate entity types. This keeps the classification lightweight and available anywhere groups appear — scorecard filters, catalog views, reports, and the Explore sidebar.
+
+## What's Included
+
+- **Entity type:** `ai-agent`
+- **Scorecard:** `ai-agent-governance` — 6 rules across Bronze, Silver, and Gold levels
+  - Bronze: has description · has a business owner (email) · owned by a team
+  - Silver: tagged with an `ai-model:` group · tagged with a criticality tier (`tier-1` / `tier-2` / `tier-3`)
+  - Gold: verified in the last 90 days
+- **Sample entities:** 9 real agents from Cortex's own engineering org, drawn from the `cortexapps/brain-backend` skill library, intentionally spread across scoring levels so the scorecard tells a story out of the box:
+  - **Silver:** `code-review`, `fix-issue`, `address-reviews`, `audit-flags`, `jira-to-kb`
+  - **Bronze:** `simplify-test`, `incident-trends`, `search-troubleshooting-kb` (missing model + tier groups)
+  - **Fails Bronze:** `release-to-sha` (no owner assigned)
+
+## Installation
+
+```
+cortex solutions install -s ai-agents
+```
+
+## After Installing
+
+**Replace the sample entities with your real agents**
+
+The nine sample entities use `platform-engineering` as a placeholder team and `owner@example.com` as a placeholder business owner. For each real agent:
+
+1. Create a new entity YAML (copy a sample as a template):
+   ```
+   cortex catalog create -f my-agent.yaml
+   ```
+2. Set the owning team and business owner:
+   ```
+   x-cortex-owners:
+     - type: GROUP
+       name: your-team-name
+       provider: CORTEX
+     - type: EMAIL
+       email: real-owner@yourcompany.com
+       description: business-owner
+   ```
+3. Tag it with the AI model and criticality tier:
+   ```
+   x-cortex-groups:
+     - ai-model:claude-sonnet-4-6
+     - tier-2
+   ```
+4. Point it at the agent's source code:
+   ```
+   x-cortex-git:
+     github:
+       repository: your-org/your-repo
+       basepath: agents/my-agent
+   ```
+
+**Standard AI model groups**
+
+Use these group tags consistently so filtering and reports work across agents:
+
+| Model | Group tag |
+|-------|-----------|
+| Claude Opus 4.6 | `ai-model:claude-opus-4-6` |
+| Claude Sonnet 4.6 | `ai-model:claude-sonnet-4-6` |
+| Claude Haiku 4.5 | `ai-model:claude-haiku-4-5-20251001` |
+| GPT-4o | `ai-model:gpt-4o` |
+| GPT-4o mini | `ai-model:gpt-4o-mini` |
+| Gemini 2.5 Pro | `ai-model:gemini-2-5-pro` |
+
+As new models are introduced, follow the `ai-model:<provider>-<model-version>` naming convention so they are automatically picked up by the Silver scorecard rule — no rule changes needed.
+
+**Linking to agent source code**
+
+The sample entities use `x-cortex-git` with `basepath:` to scope Cortex's git features (commit history, code search) to just the agent's folder rather than the whole repository. Two variants depending on how the agent's code is organized:
+
+*Folder-based agent (SKILL.md plus reference files, prompt directory, etc.):*
+
+```
+x-cortex-git:
+  github:
+    repository: your-org/your-repo
+    basepath: agents/my-agent
+```
+
+
+**Reaching Gold**
+
+The Gold rule checks that the agent has been verified within the last 90 days (`verifications().lastVerifiedAt() != null and verifications().lastVerifiedAt().fromNow() > duration("P-90D")`). Verify entities via the Cortex UI or API — none of the sample entities start at Gold by design. Wire a quarterly reminder or a GitHub Action on your agent directories to prompt re-verification when files change.
+
+**Create an AI Agents Catalog in the UI**
+
+Cortex Catalogs (the nav-level groupings) are UI-only today — no API or CLI support yet:
+
+1. Go to [Catalogs](https://app.getcortexapp.com/admin/catalogs) → **New Catalog**
+2. Entity type: `ai-agent`
+3. Name it **AI Agents**
+
+> Catalog creation will be automated once catalog API support is added to the CLI.
+

cortexapps_cli-1.28.0/cortexapps_cli/solutions/ai-agents/catalog/address-reviews.yaml

@@ -0,0 +1,21 @@
+openapi: "3.0.0"
+info:
+  title: address-reviews
+  description: Address findings from PR reviews — both automated Claude reviews and human reviewer comments. Reads all feedback, applies fixes, and pushes an updated commit.
+  x-cortex-tag: address-reviews
+  x-cortex-type: ai-agent
+  x-cortex-definition: {}
+  x-cortex-groups:
+    - ai-model:claude-sonnet-4-6
+    - tier-2
+  x-cortex-git:
+    github:
+      repository: cortexapps/brain-backend
+      basepath: .claude/skills/address-reviews
+  x-cortex-owners:
+    - type: GROUP
+      name: platform-engineering
+      provider: CORTEX
+    - type: EMAIL
+      email: owner@example.com
+      description: business-owner

cortexapps_cli-1.28.0/cortexapps_cli/solutions/ai-agents/catalog/audit-flags.yaml

@@ -0,0 +1,21 @@
+openapi: "3.0.0"
+info:
+  title: audit-flags
+  description: Audit all LaunchDarkly feature flags across codebases — generates descriptions, links Jira tickets, checks code usage, and classifies each flag. Outputs a CSV report for flag cleanup decisions.
+  x-cortex-tag: audit-flags
+  x-cortex-type: ai-agent
+  x-cortex-definition: {}
+  x-cortex-groups:
+    - ai-model:claude-sonnet-4-6
+    - tier-3
+  x-cortex-git:
+    github:
+      repository: cortexapps/brain-backend
+      basepath: .claude/skills/audit-flags
+  x-cortex-owners:
+    - type: GROUP
+      name: platform-engineering
+      provider: CORTEX
+    - type: EMAIL
+      email: owner@example.com
+      description: business-owner

cortexapps_cli-1.28.0/cortexapps_cli/solutions/ai-agents/catalog/code-review.yaml

@@ -0,0 +1,21 @@
+openapi: "3.0.0"
+info:
+  title: code-review
+  description: Code review of branch changes, optionally informed by a Jira issue for context. Fetches the diff, reads related tickets, and posts structured feedback covering correctness, security, and style.
+  x-cortex-tag: code-review
+  x-cortex-type: ai-agent
+  x-cortex-definition: {}
+  x-cortex-groups:
+    - ai-model:claude-opus-4-6
+    - tier-1
+  x-cortex-git:
+    github:
+      repository: cortexapps/brain-backend
+      basepath: .claude/skills/code-review
+  x-cortex-owners:
+    - type: GROUP
+      name: platform-engineering
+      provider: CORTEX
+    - type: EMAIL
+      email: owner@example.com
+      description: business-owner

cortexapps_cli-1.28.0/cortexapps_cli/solutions/ai-agents/catalog/fix-issue.yaml

@@ -0,0 +1,21 @@
+openapi: "3.0.0"
+info:
+  title: fix-issue
+  description: Fix a bug documented in a Jira or Linear issue. Reads the issue, investigates the codebase, presents a plan with fix and tests, then implements upon approval.
+  x-cortex-tag: fix-issue
+  x-cortex-type: ai-agent
+  x-cortex-definition: {}
+  x-cortex-groups:
+    - ai-model:claude-opus-4-6
+    - tier-2
+  x-cortex-git:
+    github:
+      repository: cortexapps/brain-backend
+      basepath: .claude/skills/fix-issue
+  x-cortex-owners:
+    - type: GROUP
+      name: platform-engineering
+      provider: CORTEX
+    - type: EMAIL
+      email: owner@example.com
+      description: business-owner

cortexapps_cli-1.28.0/cortexapps_cli/solutions/ai-agents/catalog/incident-trends.yaml

@@ -0,0 +1,20 @@
+openapi: "3.0.0"
+info:
+  title: incident-trends
+  description: Analyze incident trends and patterns from the engineering troubleshooting knowledge base. Answers aggregate questions like "what keeps breaking?" and "which product areas have the most incidents?" by translating natural language questions into BigQuery analytics.
+  x-cortex-tag: incident-trends
+  x-cortex-type: ai-agent
+  x-cortex-definition: {}
+  # No model group set — scores Baseline but not Mature.
+  # Add x-cortex-groups with an ai-model: tag to reach Mature.
+  x-cortex-git:
+    github:
+      repository: cortexapps/brain-backend
+      basepath: .claude/skills/incident-trends
+  x-cortex-owners:
+    - type: GROUP
+      name: platform-engineering
+      provider: CORTEX
+    - type: EMAIL
+      email: owner@example.com
+      description: business-owner

cortexapps_cli-1.28.0/cortexapps_cli/solutions/ai-agents/catalog/jira-to-kb.yaml

@@ -0,0 +1,21 @@
+openapi: "3.0.0"
+info:
+  title: jira-to-kb
+  description: End-to-end pipeline that takes a Jira issue key, retrieves all relevant context (issue details, linked GitHub PRs, PR diffs), and uploads a troubleshooting record to the engineering knowledge base with auto-generated embeddings. Fully autonomous — no human approval needed per record.
+  x-cortex-tag: jira-to-kb
+  x-cortex-type: ai-agent
+  x-cortex-definition: {}
+  x-cortex-groups:
+    - ai-model:claude-haiku-4-5-20251001
+    - tier-3
+  x-cortex-git:
+    github:
+      repository: cortexapps/brain-backend
+      basepath: .claude/skills/jira-to-kb
+  x-cortex-owners:
+    - type: GROUP
+      name: platform-engineering
+      provider: CORTEX
+    - type: EMAIL
+      email: owner@example.com
+      description: business-owner

cortexapps_cli-1.28.0/cortexapps_cli/solutions/ai-agents/catalog/release-to-sha.yaml

@@ -0,0 +1,15 @@
+openapi: "3.0.0"
+info:
+  title: release-to-sha
+  description: Map a Cortex on-prem helm chart version to the git SHAs baked into it across all components — brain-backend, epv-consumer, auth-service, frontend, brain-web. Used during incident triage when a self-hosted customer reports a version.
+  x-cortex-tag: release-to-sha
+  x-cortex-type: ai-agent
+  x-cortex-definition: {}
+  x-cortex-groups:
+    - ai-model:claude-haiku-4-5-20251001
+  x-cortex-git:
+    github:
+      repository: cortexapps/brain-backend
+      basepath: .claude/skills/release-to-sha
+  # No owner set — fails Baseline "Agent has a business owner" rule.
+  # Replace with a real owner to start scoring.

cortexapps_cli-1.28.0/cortexapps_cli/solutions/ai-agents/catalog/search-troubleshooting-kb.yaml

@@ -0,0 +1,20 @@
+openapi: "3.0.0"
+info:
+  title: search-troubleshooting-kb
+  description: Search the engineering troubleshooting knowledge base in BigQuery for past incidents, fixes, and diagnostic patterns. Use during active debugging sessions to find similar past incidents and their resolutions. Also used proactively at the start of any debugging session to check for prior art.
+  x-cortex-tag: search-troubleshooting-kb
+  x-cortex-type: ai-agent
+  x-cortex-definition: {}
+  # No model group set — scores Baseline but not Mature.
+  # Add x-cortex-groups with an ai-model: tag to reach Mature.
+  x-cortex-git:
+    github:
+      repository: cortexapps/brain-backend
+      basepath: .claude/skills/search-troubleshooting-kb
+  x-cortex-owners:
+    - type: GROUP
+      name: platform-engineering
+      provider: CORTEX
+    - type: EMAIL
+      email: owner@example.com
+      description: business-owner

cortexapps_cli-1.28.0/cortexapps_cli/solutions/ai-agents/catalog/simplify-test.yaml

@@ -0,0 +1,20 @@
+openapi: "3.0.0"
+info:
+  title: simplify-test
+  description: Simplify a heavy integration test by splitting it into controller unit tests, service unit tests, and lightweight integration tests. Applies a migration playbook and enforces the integration test ratchet.
+  x-cortex-tag: simplify-test
+  x-cortex-type: ai-agent
+  x-cortex-definition: {}
+  # No model group set — scores Baseline but not Mature.
+  # Add x-cortex-groups with an ai-model: tag to reach Mature.
+  x-cortex-git:
+    github:
+      repository: cortexapps/brain-backend
+      basepath: .claude/skills/simplify-test
+  x-cortex-owners:
+    - type: GROUP
+      name: platform-engineering
+      provider: CORTEX
+    - type: EMAIL
+      email: owner@example.com
+      description: business-owner

cortexapps_cli-1.28.0/cortexapps_cli/solutions/ai-agents/entity-types/ai-agent.json

@@ -0,0 +1,7 @@
+{
+  "type": "ai-agent",
+  "name": "AI Agent",
+  "description": "An internally-built AI agent — a workflow, assistant, or automation powered by an LLM (e.g. Claude, GPT-4o) and deployed to handle a repeatable task.",
+  "iconTag": "Cortex-builtin::Robot",
+  "schema": {"type": "object", "properties": {}}
+}

cortexapps_cli-1.28.0/cortexapps_cli/solutions/ai-agents/scorecards/ai-agent-governance.yaml

@@ -0,0 +1,69 @@
+tag: ai-agent-governance
+name: AI Agent Governance
+description: Checks that AI agents are documented, owned, classified by model and criticality, and regularly verified — the minimum bar for answering "where and how are we using AI tooling?"
+draft: false
+notifications:
+  enabled: true
+  scoreDropNotificationsEnabled: true
+exemptions:
+  enabled: true
+  autoApprove: false
+  userSpecificNotifications: false
+evaluation:
+  window: 24
+ladder:
+  name: Default Ladder
+  levels:
+    - name: Bronze
+      rank: 1
+      description: The agent is documented, owned by a team, and linked to its source implementation.
+      color: "#CD7F32"
+    - name: Silver
+      rank: 2
+      description: The agent is classified by AI model and criticality tier, enabling org-wide reporting on model adoption and business impact.
+      color: "#C0C0C0"
+    - name: Gold
+      rank: 3
+      description: The agent has been explicitly verified as active and current.
+      color: "#D7AC58"
+filter:
+  kind: GENERIC
+  types:
+    include:
+      - ai-agent
+rules:
+  - title: Agent has a description
+    description: Every AI agent should describe what it does and why — the minimum signal for stakeholders asking "where are we using AI?"
+    expression: entity.description().length > 0
+    weight: 1
+    level: Bronze
+
+  - title: Agent is owned by a team
+    description: AI agents must be owned by a Cortex team so responsibility is shared and survives individual attrition.
+    expression: ownership.teams().length >= 1
+    weight: 1
+    level: Bronze
+
+  - title: Agent has a source code reference
+    description: The agent's implementation must be linked via x-cortex-git so the catalog entry stays connected to the code.
+    expression: git != null
+    weight: 1
+    level: Bronze
+
+  - title: Agent is tagged with an AI model
+    description: Tag this agent with its LLM using the ai-model group prefix (e.g. ai-model:claude-opus-4-6) so leadership can report on model adoption across the organization.
+    expression: groups().any((group) => group.name.matchesIn("ai-model:"))
+    weight: 1
+    level: Silver
+
+  - title: Agent has a criticality tier
+    description: Tag this agent with its business criticality (tier-1, tier-2, or tier-3) so incidents and ownership decisions can be prioritized accordingly.
+    expression: groups().any((group) => group.name.matchesIn("tier-"))
+    weight: 1
+    level: Silver
+
+  - title: Agent verified in the last 90 days
+    description: The agent has been verified within the last 90 days — confirming it is still in active use and its metadata is current. Verify via the Cortex UI or API.
+    expression: verifications().lastVerifiedAt() != null and verifications().lastVerifiedAt().fromNow() > duration("P-90D")
+    weight: 1
+    level: Gold

{cortexapps_cli-1.26.0 → cortexapps_cli-1.28.0}/pyproject.toml

@@ -1,7 +1,7 @@
 [tool.poetry]
 name = "cortexapps-cli"
 # version will be incremented via command line as part of github actions build
-version = "1.26.0"
+version = "1.28.0"
 description = "Command Line Interface for cortexapps"
 license = "MIT"
 authors = [