Capital Agentic Charts

Capital Agentic Charts is the standalone Bun/TypeScript runtime for Capital Companion's agentic financial chart workspace. The chart is a durable trade reasoning document, not transient Canvas or React state. Users and agents mutate charts through typed ChartOperation objects that can be validated, replayed, exported, reviewed, and rolled back.

VCP package release candidate: exact restricted versions are prepared but not published. The document schema is 2.0.0, the Capital Companion integration contract is 2026-07-23.chart-runtime.v2, and schema 1.0.0 documents migrate in memory without persistence until ordinary Save.

Quickstart

bun install
bun run typecheck
bun run test
bun run build
bun run chart:fixtures
bun run chart:eval
bun run chart:bench
bun run chart:visual
bun run verify

Run the local chart lab:

bun run --filter chart-lab build
cd apps/chart-lab
bunx serve dist

Then open the served index.html for the vanilla Canvas lab or react-example.html for the React adapter sidecar.

Packages

• @major7apps/agentic-charts-core: canonical ChartDocument, operations, validation, reducers, replay, import/export, and integration DTOs.
• @major7apps/agentic-charts-finance: dependency-free financial time, indicator, anchor, and trade-plan math.
• @major7apps/agentic-charts-agent: compact/full context export, review context, and agent operation validation.
• @major7apps/agentic-charts-pattern-scene: immutable renderer-neutral VCP semantic scenes derived from durable pattern evidence.
• @major7apps/agentic-charts-renderer-canvas: framework-agnostic Canvas renderer that consumes documents and emits operations.
• @major7apps/agentic-charts-react: thin React adapter around the Canvas renderer.
• @major7apps/agentic-charts-fixtures: deterministic fixture generation.
• @major7apps/cc-chart: CLI for fixture generation, validation, replay, evals, visual regression, and render benchmarks.
• chart-lab: local browser lab. It is not a production app integration.

The private @major7apps/[email protected] adapter is chart-lab-only. It is not staged, published, installed by Capital Companion, or shipped in production. Canvas remains the production renderer.

Package root imports are the supported entrypoints:

import { type ChartDocument, applyChartOperation } from "@major7apps/agentic-charts-core";
import { exportCompactContextForLlm } from "@major7apps/agentic-charts-agent";
import { CapitalAgenticChart } from "@major7apps/agentic-charts-react";

Built artifacts are emitted to each package's dist/ directory with index.js, index.js.map, index.d.ts, and index.d.ts.map. Bun workspace development uses source entrypoints; downstream applications consume only independently verified registry artifacts pinned to the exact versions in docs/chart-runtime/NPM_RELEASE.md.

After schema 2.0.0 data exists, compatible-reader rollback keeps the newest pattern-aware Canvas reader installed while disabling new detection, ranking, and acceptance. It never rolls back to an incompatible reader, hides accepted patterns, or introduces a second chart runtime.

Release Docs

• docs/chart-runtime/PUBLIC_API.md
• docs/chart-runtime/APP_INTEGRATION_GATE.md
• docs/chart-runtime/CAPITAL_COMPANION_INTEGRATION.md
• docs/chart-runtime/FEATURE_FLAG_AND_ROLLBACK.md
• docs/chart-runtime/MIGRATION_SAFETY.md
• docs/chart-runtime/NPM_RELEASE.md
• CHANGELOG.md
• NOTICE.md