Transferring API requests to the backend

README.md

@@ -66,6 +66,13 @@ interactive terminal UI.
   to hold the directional bet) while every strategy algorithm stays identical.
 - **In-process NestJS GraphQL backend**: the interactive CLI starts a local
   GraphQL endpoint without a second service process.
+- **Repository-mediated GraphQL layer**: the API surface lives entirely in the
+  backend. Both ends of the `cli → graphql → backend` path own a repository — the
+  backend `TradefastRepository` (`src/backend/graphql/`) maps the application
+  facade onto GraphQL DTOs, and the frontend `GraphqlTradefastRepository`
+  (`src/cli/graphql/`) is the only place the CLI talks to the API. Each GraphQL
+  class lives in its own file on both sides. The headless `status`, `strategies`
+  and `clear` commands make their requests through this path.
 - **Dockerised**: `docker compose up` brings up PostgreSQL and the CLI.
 
 ---

package.json

@@ -1,6 +1,6 @@
 {
   "name": "Tradefast",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "TRADEFΛST — a disciplined crypto market-research CLI: strategies, analytics, risk and AI-assisted research, in the style of Gemini CLI.",
   "type": "module",
   "license": "MIT",

src/backend/graphql/dto/analytics.dto.ts

@@ -0,0 +1,32 @@
+import { Field, Float, Int, ObjectType } from '@nestjs/graphql';
+
+/** Per-symbol consensus analytics for the latest run. */
+@ObjectType()
+export class AnalyticsDto {
+  @Field(() => String)
+  symbol!: string;
+
+  @Field(() => Float)
+  consensusScore!: number;
+
+  @Field(() => Int)
+  longCount!: number;
+
+  @Field(() => Int)
+  shortCount!: number;
+
+  @Field(() => Int)
+  neutralCount!: number;
+
+  @Field(() => String, { nullable: true })
+  strongestStrategy!: string | null;
+
+  @Field(() => Float, { nullable: true })
+  strongestStrength!: number | null;
+
+  @Field(() => Float, { nullable: true })
+  lastPrice!: number | null;
+
+  @Field(() => Float, { nullable: true })
+  atr!: number | null;
+}

src/backend/graphql/dto/run-report.dto.ts

@@ -0,0 +1,22 @@
+import { Field, Int, ObjectType } from '@nestjs/graphql';
+
+import { SymbolRunDto } from './symbol-run.dto.js';
+
+/** The outcome of a `/start` or `/update` collection run. */
+@ObjectType()
+export class RunReportDto {
+  @Field(() => Int)
+  runId!: number;
+
+  @Field(() => String)
+  kind!: string;
+
+  @Field(() => [SymbolRunDto])
+  symbols!: SymbolRunDto[];
+
+  @Field(() => Int)
+  searchResults!: number;
+
+  @Field(() => Int)
+  durationMs!: number;
+}

src/backend/graphql/dto/status.dto.ts

@@ -0,0 +1,20 @@
+import { Field, Int, ObjectType } from '@nestjs/graphql';
+
+import { AnalyticsDto } from './analytics.dto.js';
+import { TableCountDto } from './table-count.dto.js';
+
+/** A snapshot of the backend's database and the latest run's analytics. */
+@ObjectType()
+export class StatusDto {
+  @Field(() => String)
+  driver!: string;
+
+  @Field(() => [TableCountDto])
+  counts!: TableCountDto[];
+
+  @Field(() => Int, { nullable: true })
+  latestRunId!: number | null;
+
+  @Field(() => [AnalyticsDto])
+  latestAnalytics!: AnalyticsDto[];
+}

src/backend/graphql/dto/strategy.dto.ts

@@ -0,0 +1,11 @@
+import { Field, ObjectType } from '@nestjs/graphql';
+
+/** A registered trading strategy, exposed for discovery by clients. */
+@ObjectType()
+export class StrategyDto {
+  @Field(() => String)
+  id!: string;
+
+  @Field(() => String)
+  title!: string;
+}

src/backend/graphql/dto/symbol-run.dto.ts

@@ -0,0 +1,26 @@
+import { Field, Int, ObjectType } from '@nestjs/graphql';
+
+/** What a single symbol contributed to a collection run. */
+@ObjectType()
+export class SymbolRunDto {
+  @Field(() => String)
+  symbol!: string;
+
+  @Field(() => Int)
+  candlesAdded!: number;
+
+  @Field(() => Int)
+  signalsInserted!: number;
+
+  @Field(() => Int)
+  signalsUpdated!: number;
+
+  @Field(() => Int)
+  signalsUnchanged!: number;
+
+  @Field(() => Int)
+  scrapesAdded!: number;
+
+  @Field(() => String)
+  insight!: string;
+}

src/backend/graphql/dto/table-count.dto.ts

@@ -0,0 +1,11 @@
+import { Field, Int, ObjectType } from '@nestjs/graphql';
+
+/** A single database table together with its current row count. */
+@ObjectType()
+export class TableCountDto {
+  @Field(() => String)
+  name!: string;
+
+  @Field(() => Int)
+  count!: number;
+}

src/backend/graphql/facade.ts

@@ -0,0 +1,19 @@
+import type { StatusReport } from '../../app/tradefast.js';
+import type { RunReport } from '../../pipeline/collector.js';
+
+/** DI token under which the application facade is provided to the resolver. */
+export const TRADEFAST_FACADE = Symbol('TRADEFAST_FACADE');
+
+/**
+ * The slice of the {@link Tradefast} application the GraphQL backend depends on.
+ * Keeping it an interface lets tests provide a lightweight stand-in and keeps the
+ * backend decoupled from the full application class.
+ */
+export interface TradefastApiFacade {
+  readonly driver: string;
+  status(): Promise<StatusReport>;
+  strategies(): { id: string; title: string }[];
+  start(): Promise<RunReport>;
+  update(): Promise<RunReport>;
+  clear(): Promise<number>;
+}

src/backend/graphql/index.ts

@@ -0,0 +1,10 @@
+/** Barrel for the backend GraphQL layer: facade, DTOs, repository and resolver. */
+export { TRADEFAST_FACADE, type TradefastApiFacade } from './facade.js';
+export { AnalyticsDto } from './dto/analytics.dto.js';
+export { RunReportDto } from './dto/run-report.dto.js';
+export { StatusDto } from './dto/status.dto.js';
+export { StrategyDto } from './dto/strategy.dto.js';
+export { SymbolRunDto } from './dto/symbol-run.dto.js';
+export { TableCountDto } from './dto/table-count.dto.js';
+export { TradefastRepository, toRunDto } from './repository.js';
+export { TradefastResolver } from './tradefast.resolver.js';