cited-cli 0.3.14__tar.gz → 0.5.0__tar.gz

{cited_cli-0.3.14 → cited_cli-0.5.0}/PKG-INFO

@@ -1,23 +1,23 @@
 Metadata-Version: 2.4
 Name: cited-cli
-Version: 0.3.14
+Version: 0.5.0
 Summary: CLI for the Cited GEO platform
 Author-email: Cited <support@youcited.com>
 License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
 Requires-Python: >=3.11
-Requires-Dist: cited-core>=0.3.14
+Requires-Dist: cited-core>=0.5.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: typer>=0.15.0
 Provides-Extra: dev
-Requires-Dist: cited-mcp>=0.3.14; extra == 'dev'
+Requires-Dist: cited-mcp>=0.5.0; extra == 'dev'
 Requires-Dist: mypy>=1.10; extra == 'dev'
 Requires-Dist: pytest>=8.0; extra == 'dev'
 Requires-Dist: respx>=0.21; extra == 'dev'
 Requires-Dist: ruff>=0.4; extra == 'dev'
 Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
 Provides-Extra: mcp
-Requires-Dist: cited-mcp>=0.3.14; extra == 'mcp'
+Requires-Dist: cited-mcp>=0.5.0; extra == 'mcp'
 Description-Content-Type: text/markdown
 
 # Cited CLI

{cited_cli-0.3.14 → cited_cli-0.5.0}/packages/core/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cited-core"
-version = "0.3.14"
+version = "0.5.0"
 description = "Core library for the Cited GEO platform"
 license = "LicenseRef-Proprietary"
 requires-python = ">=3.11"

cited_cli-0.5.0/packages/core/src/cited_core/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.5.0"

{cited_cli-0.3.14 → cited_cli-0.5.0}/packages/core/src/cited_core/api/client.py

@@ -40,6 +40,15 @@ class CitedClient:
     def close(self) -> None:
         self._client.close()
 
+    def set_request_id(self, request_id: str | None) -> None:
+        """Stamp X-Request-ID on subsequent outgoing requests so the cited
+        backend can echo it in its access logs and produce end-to-end traces.
+        Pass None to clear."""
+        if request_id:
+            self._client.headers["X-Request-ID"] = request_id
+        else:
+            self._client.headers.pop("X-Request-ID", None)
+
     def __enter__(self) -> CitedClient:
         return self
 

{cited_cli-0.3.14 → cited_cli-0.5.0}/packages/core/src/cited_core/api/endpoints.py

@@ -23,6 +23,7 @@ BUSINESS = "/businesses/{business_id}"
 BUSINESS_LOGO = "/businesses/{business_id}/logo"
 HEALTH_SCORES = "/businesses/{business_id}/health-scores"
 HEALTH_SCORES_BREAKDOWN = "/businesses/{business_id}/health-scores/breakdown"
+PROFILE_COMPETITORS = "/businesses/{business_id}/profile-competitors"
 
 # Business Crawl
 CRAWL_DATA = "/businesses/{business_id}/crawl-data"
@@ -77,9 +78,16 @@ HQ_PRIORITY_STATUS = "/businesses/{business_id}/hq/priority/{action_id}/status"
 HQ_PRIORITY_SUMMARY = "/businesses/{business_id}/hq/priority/summary"
 HQ_EXPORT_PDF = "/businesses/{business_id}/hq/export/pdf"
 HQ_RECOMPUTE = "/businesses/{business_id}/hq/recompute"
+HQ_OVERVIEW_REFRESH_AUDIT = "/businesses/{business_id}/overview/refresh-audit"
+HQ_OVERVIEW_REFRESH_RECS = "/businesses/{business_id}/overview/refresh-recommendations"
+HQ_OVERVIEW_REFRESH_ALL = "/businesses/{business_id}/overview/refresh-all"
+HQ_AGENT_BRIEF = "/businesses/{business_id}/agent-brief"
 PERSONAS = "/businesses/{business_id}/personas"
+PERSONA = "/businesses/{business_id}/personas/{persona_id}"
 PRODUCTS = "/businesses/{business_id}/products"
+PRODUCT = "/businesses/{business_id}/products/{product_id}"
 BUYER_INTENTS = "/businesses/{business_id}/buyer-intents"
+BUYER_INTENT = "/businesses/{business_id}/buyer-intents/{intent_id}"
 AGENTIC_READINESS = "/businesses/{business_id}/agentic-readiness"
 TRUST_SIGNALS = "/businesses/{business_id}/trust-signals"
 

{cited_cli-0.3.14 → cited_cli-0.5.0}/packages/mcp/pyproject.toml

@@ -4,14 +4,14 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cited-mcp"
-version = "0.3.14"
+version = "0.5.0"
 description = "MCP server for the Cited GEO platform"
 readme = "README.md"
 license = "LicenseRef-Proprietary"
 requires-python = ">=3.11"
 authors = [{ name = "Cited", email = "support@youcited.com" }]
 dependencies = [
-    "cited-core>=0.3.14",
+    "cited-core>=0.5.0",
     "mcp>=1.27.0",
     "PyJWT>=2.8.0",
     "PyYAML>=6.0",

{cited_cli-0.3.14 → cited_cli-0.5.0}/packages/mcp/src/cited_mcp/plan_gating.py

@@ -43,6 +43,18 @@ _SCALE_TOOLS: set[str] = {
     "mark_action_done",
     "dismiss_action",
     "get_action_progress",
+    "set_profile_competitors",
+    "create_persona",
+    "update_persona",
+    "delete_persona",
+    "create_product",
+    "update_product",
+    "delete_product",
+    "create_buyer_intent",
+    "update_buyer_intent",
+    "delete_buyer_intent",
+    "recompute_health_scores",
+    "refresh_business_overview",
 }
 
 # Tools restricted to pro+ tier
@@ -54,6 +66,7 @@ _PRO_TOOLS: set[str] = {
     "get_semantic_health",
     "buyer_fit_query",
     "get_business_hq",
+    "get_agent_brief",
     "get_analytics_trends",
     "get_analytics_dashboard",
     "compare_audits",
@@ -156,6 +169,10 @@ _BASE_TOOLS: set[str] = {
     "get_business",
     "crawl_business",
     "get_health_scores",
+    "list_profile_competitors",
+    "list_personas",
+    "list_products",
+    "list_buyer_intents",
     "list_audit_templates",
     "get_audit_template",
     "start_audit",

{cited_cli-0.3.14 → cited_cli-0.5.0}/packages/mcp/src/cited_mcp/tool_changelog.yaml

@@ -21,6 +21,215 @@
 #      this file.
 
 versions:
+  - version: "0.5.0"
+    released: "2026-05-11"
+    # Three new read-only list_* tools to enable persona/product/buyer-intent
+    # CRUD flows (agents need IDs before they can call update/delete), plus a
+    # significant parameter-schema expansion on update_business / create_business
+    # to cover the full canonical BusinessUpdate/CreateRequest field set. Also
+    # fixes a latent bug: update_business previously sent HTTP PUT against a
+    # backend PATCH route. Bumps minor (not patch) because update_business /
+    # create_business signature changes shift parameter ordering and clients
+    # diffing the fingerprint should pick this up as non-additive.
+    fingerprint: "5bef45100c53"
+    tools_added:
+      - name: list_personas
+        description: |
+          List buyer personas declared on the business profile. Required
+          before update_persona / delete_persona since the agent has no
+          other way to discover persona_ids.
+      - name: list_products
+        description: |
+          List products / service offerings declared on the business
+          profile. Required before update_product / delete_product to
+          discover product_ids.
+      - name: list_buyer_intents
+        description: |
+          List buyer-intent entries declared on the business profile.
+          Use before recommending a new create_buyer_intent to avoid
+          overlapping entries.
+      - name: update_buyer_intent
+        description: |
+          Update a buyer-intent entry (question, intent_type, priority,
+          is_answered, answering_page_url — all optional). Closes the
+          persona/product CRUD symmetry. Requires the cited backend with
+          PATCH /businesses/{id}/buyer-intents/{intent_id} (added in
+          companion backend PR).
+      - name: delete_buyer_intent
+        description: |
+          Delete a buyer intent. Confirm with the user before calling —
+          there's no undo. Requires the cited backend with
+          DELETE /businesses/{id}/buyer-intents/{intent_id}.
+    tools_changed:
+      - name: update_business
+        change_summary: |
+          Parameter set expanded from 4 fields (name, website, description,
+          industry) to the full BusinessUpdateRequest schema: adds
+          one_line_description, primary_customer, problem_solved,
+          offering_type, primary_market, service_areas,
+          headquarters_country, goals, discovery_channels,
+          success_definition, plus primary-location fields (address, city,
+          region, country). All new params are optional and keyword-only.
+          Also fixes a method bug: now sends PATCH (was PUT) to match the
+          backend @router.patch route.
+      - name: create_business
+        change_summary: |
+          Parameter set expanded to the full BusinessCreateRequest schema:
+          description is now optional (server composes from structured
+          fields if omitted); adds one_line_description, primary_customer,
+          problem_solved, offering_type, primary_market, service_areas,
+          headquarters_country, goals, discovery_channels,
+          success_definition. Existing 4-field callers unaffected
+          (description was already accepted; making it optional is
+          backward-compatible).
+
+  - version: "0.4.0"
+    released: "2026-05-08"
+    # 12 new tools + docstring/parameter-schema edits on 4 existing tools —
+    # significant surface expansion, so the minor version bumps to 0.4.0
+    # to signal a non-additive-only release for clients that diff the
+    # fingerprint.
+    fingerprint: "8197f97dcd06"
+    tools_added:
+      - name: get_agent_brief
+        description: |
+          Single-call composite "what should I focus on right now?" —
+          top priority actions, quick wins, failing deterministic checks,
+          and recent citation-rate movement. Designed to replace
+          chained get_business_hq + get_quick_wins + check_status calls
+          in opening-turn agent flows.
+      - name: list_profile_competitors
+        description: |
+          List the user-declared competitors on a business profile.
+          These bypass third-party domain filtering and rank ahead of
+          citation-only picks in head-to-head comparisons.
+      - name: set_profile_competitors
+        description: |
+          Replace the full list of profile competitors (max 10).
+          Pass [{name, website}] entries; PUT replaces. Use when the
+          user reports an obviously-relevant rival missing from H2H.
+      - name: recompute_health_scores
+        description: |
+          Force a fresh recomputation of business health scores after
+          profile/HQ edits — no crawl, no audit, just re-derive from
+          existing data.
+      - name: refresh_business_overview
+        description: |
+          Refresh cached audit / recommendation overview projections
+          for a business. scope ∈ {audit, recommendations, all}.
+      - name: create_persona
+        description: Create a target buyer persona on a business.
+      - name: update_persona
+        description: Update a persona (partial — only changed fields).
+      - name: delete_persona
+        description: Delete a persona.
+      - name: create_product
+        description: Create a product/service offering on a business.
+      - name: update_product
+        description: Update a product (partial).
+      - name: delete_product
+        description: Delete a product.
+      - name: create_buyer_intent
+        description: |
+          Create a buyer-intent entry tying personas to products
+          through specific decision moments — drives audit question
+          generation and per-intent coverage scoring.
+    tools_changed:
+      - name: get_business_hq
+        change_summary: |
+          New include flags ``include_agentic_readiness`` and
+          ``include_trust_signals`` add the agentic-readiness summary
+          and trust-signal evidence to the dashboard payload. Existing
+          callers are unaffected — both default to false.
+      - name: get_competitive_comparison
+        change_summary: |
+          Docstring now describes the new ``analysis_status`` and
+          ``last_analysis_run_at`` freshness fields on the response
+          (added in cited backend commit 2c716be). Tool behavior is
+          unchanged — these were already passed through; the docstring
+          was previously silent about them.
+      - name: get_recommendation_check_status
+        change_summary: |
+          Updated for Validation Engine Tier 4: now runs 72
+          deterministic checks (was 62). New checks fill
+          monitoring_adaptation and original_research domains
+          (knowledge_graph_linkage, aggregate_rating_present,
+          author_bio_on_blog_posts, sitemap_lastmod_freshness,
+          outbound_authority_citations, hreflang_and_lang_consistency,
+          well_known_agent_discovery). Response shape unchanged.
+      - name: crawl_business
+        change_summary: |
+          Docstring now notes the post-crawl auto-fill side effect:
+          empty business-profile fields (description, founding year,
+          NAICS, sameAs links) are populated from JSON-LD / meta tags
+          found on the homepage. User-supplied values are never
+          overwritten. (cited backend CIT-148.)
+    tools_removed: []
+    behavior_changed:
+      - area: plan_gating
+        change_summary: |
+          Tier assignments for the new tools:
+          - base (all tiers): ``list_profile_competitors``
+          - scale: ``set_profile_competitors``,
+            ``create/update/delete_persona``,
+            ``create/update/delete_product``,
+            ``create_buyer_intent``,
+            ``recompute_health_scores``,
+            ``refresh_business_overview``
+          - pro: ``get_agent_brief`` (matches the ``get_business_hq``
+            tier — same composite-dashboard semantics).
+
+  - version: "0.3.15"
+    released: "2026-05-05"
+    # Fingerprint unchanged from 0.3.14 image runtime — pure observability +
+    # logging-enrichment release; no tool surface change. (The 0.3.14 entry
+    # below pins defa3022aedb, which was the host-venv compute at release
+    # prep — differing from the deployed image's 1c4fed943fff. Future
+    # entries should pin runtime fingerprints; this collision is benign
+    # because there's nothing in the surface for clients to act on.)
+    fingerprint: "1c4fed943fff"
+    tools_added: []
+    tools_changed: []
+    tools_removed: []
+    behavior_changed:
+      - area: structured_logging
+        change_summary: |
+          Every ``tool_call`` log line now carries:
+          - ``server_version`` and ``tools_fingerprint`` (so log entries
+            self-identify which build emitted them)
+          - ``deployment_id`` from ``CITED_DEPLOYMENT_ID`` env var
+            (format ``<env>-<short-sha>-<unix-ts>``, set by the deploy
+            script — uniquely identifies a single deploy attempt)
+          - ``client_id`` extracted from the OAuth JWT (lets us tell
+            Claude Desktop traffic from Claude.ai traffic)
+          - ``resources`` map with ID-shaped kwargs (``business_id``,
+            ``audit_id``, ``job_id``, ``source_id``, etc.) — enough to
+            correlate user activity with backend records, never raw
+            content like buyer profiles or audit descriptions.
+          On failures the line now also carries ``error_type`` and
+          ``status_code`` pulled from the typed-error response, so the
+          dashboard can categorise failures without grepping messages.
+      - area: end_to_end_tracing
+        change_summary: |
+          The MCP now stamps ``X-Request-ID`` on every outgoing call to
+          the cited backend (matching the ``request_id`` already in the
+          tool_call log line). The backend can echo this to its own
+          access logs to produce end-to-end traces — when a customer
+          reports "buyer_fit_query 500 with request_id abc123" the
+          owner can find both MCP-side and backend-side log entries
+          for the same request.
+      - area: deploy_pipeline
+        change_summary: |
+          Companion ``deploy-mcp.sh`` improvements (cited-mcp-infra
+          repo, commit 5542667): split log groups (prod writes to
+          ``/ecs/cited-mcp-prod`` instead of mixing into the dev
+          group), real stability check that fails the deploy when ECS
+          silently rolls back to a prior task definition (the failure
+          mode that hid today's IAM-blocked prod deploy), and
+          deployment_id stamping. CloudWatch dashboard ``cited-mcp``
+          + saved Insights queries (``cited-mcp/usage/per-user`` etc.)
+          + failure-burst alarms also added.
+
   - version: "0.3.14"
     released: "2026-05-05"
     fingerprint: "defa3022aedb"