Dashboard/Competitive Intelligence/logs/2026-06-26-ci-product-spec.md
Competitive Intelligence

logs/2026-06-26-ci-product-spec.md

CI Product Spec v1 - 2026-06-26

Product

Competitive Intelligence Command Center for Chowmes.

V1 Audience

Arijit first. No external or Algolia stakeholder access in v1.

Problem

The existing CI workflow can collect sources and produce reports, but it is not yet a trusted intelligence product. It needs better operational truth, evidence discipline, archive access, source health, action routing, and a dedicated delivery surface.

V1 Promise

Every day, CI should tell Arijit one of three things:

  1. A material competitor/market signal occurred, with evidence and owner-specific action.
  2. Nothing material happened, and the system can defend that statement with source coverage.
  3. Nothing material can be claimed because coverage failed, and the repair work is explicit.

Scope

Included:

  • Daily pulse.
  • Weekly digest.
  • Report archive.
  • Source health.
  • Signal ledger.
  • Action queue.
  • Dedicated CI bot design.
  • Athena quality oversight.
  • Private dashboard.

Excluded:

  • Public dashboard.
  • Algolia stakeholder access.
  • CRM/Gong/Salesforce/Slack ingestion.
  • Paid Semrush, G2, Similarweb, or analyst APIs.
  • Win/loss integration.

Quality Gates

Gate Rule
Evidence No material claim without source URL.
Date Every evidence item needs event date or detection date.
Quiet day Quiet-day confidence cannot exceed medium when key sources fail.
Battlecard No battlecard update from baseline-only signals.
Source coverage Daily delivery warns when coverage is below threshold.
Stakeholder export Disabled in v1.

Implementation Sequence

  1. Stabilize weekly renderer, runtime sync, and baseline filtering.
  2. Add report index, source health events, action items, and bot delivery schema.
  3. Build report archive API.
  4. Build source health API.
  5. Build signal ledger API.
  6. Build action queue API.
  7. Build private dashboard.
  8. Add CI bot only after token approval.
  9. Add Athena weekly quality review loop.

Acceptance Criteria

  • Daily report distinguishes baseline from material movement.
  • Weekly report produces Markdown, HTML, and PDF.
  • Source health is visible and actionable.
  • Archive lists daily and weekly reports.
  • Action recommendations can be tracked.
  • Athena supervises quality, not delivery.
  • CI bot delivery is separate from Athena after token approval.

Implementation Notes

Implemented on 2026-06-26:

  • report_index, source_health_events, action_items, and bot_deliveries tables exist in the ledger.
  • Report generation writes to report_index.
  • CI core exposes archive, source-health, and action-queue helpers.
  • scripts/generate-dashboard.py creates a static dashboard artifact with Today, Weekly, Sources, Signals, Actions, and Archive views.
  • VPS artifact: /opt/data/knowledge/obsidian/MyOS/Projects/Competitive Intelligence/artifacts/competitive-research/dashboard/index.html

Still pending:

  • Private tunnel serving path.
  • Dedicated CI bot token and gateway setup, pending explicit Arijit approval.
  • Weekly baseline-only battlecard gate.
  • Source repair/replacement pass.