# Atloria (self dogfood)

<!-- source: function-convertpreelement.md -->

# $convertPreElement

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/CodeBlockNode.tsx` (line 298)

Converts a <pre> HTML element into a CodeBlockNode.
Extracts the code content, language, and meta information from the element's attributes.
The language is determined from the class attribute (e.g., class="language-javascript") or
the data-language attribute if available.

## Signature

```ts
function $convertPreElement(element: Element): DOMConversionOutput
```

## Parameters

| Name | Type |
|---|---|
| `element` | `Element` |

**Returns:** `DOMConversionOutput`

<!-- source: constant-abort-conditions.md -->

# ABORT_CONDITIONS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 349)

<!-- source: api-endpoint-accept.md -->

# accept

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/invitation/invitation.controller.ts` (line 35)

## Endpoint

`POST /invitations/:token/accept`

| Parameter | In | Type | Required |
|---|---|---|---|
| `token` | query | `string` | ✓ |

## Referenced By

- `InvitationController` (MODULE_DECLARES)

<!-- source: class-acceptinvitationbodydto.md -->

# AcceptInvitationBodyDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/invitation/invitation.controller.ts` (line 7)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `password` | `string` |

<!-- source: interface-acceptinvitationdto.md -->

# AcceptInvitationDto

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/invitation/invitation.service.ts` (line 29)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `password` | `string` |

<!-- source: interface-accessibilityresult.md -->

# AccessibilityResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/accessibility.ts` (line 28)

Accessibility check result

## Properties

| Property | Type |
|---|---|
| `violations` | `AccessibilityViolation[]` |
| `passes` | `number` |
| `incomplete` | `number` |

<!-- source: interface-accordionitemprops-2.md -->

# AccordionItemProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/accordion-item.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `questionKey` | `string` |
| `answerKey` | `string` |
| `defaultOpen` | `boolean` |

<!-- source: interface-accordionitemprops.md -->

# AccordionItemProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/accordion-item.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `questionKey` | `string` |
| `answerKey` | `string` |
| `defaultOpen` | `boolean` |

<!-- source: service-actionexecutorservice.md -->

# ActionExecutorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/action-executor.service.ts` (line 57)

Service for executing pre-capture actions on Playwright pages

Supports 13 action types:
- click, dblclick: Click interactions
- type, fill: Text input
- press: Keyboard keys
- wait: Duration or selector waits
- scroll: Scroll to element or page bottom
- hover, focus, blur: Element state changes
- select: Dropdown selection
- navigate: Page navigation
- frame: Iframe context switching

And 5 wait condition types:
- selector, timeout, networkIdle, loadState, function

`ActionExecutorService` executes a configured list of **pre-capture actions** against a Playwright `Page` (or an active `Frame`) before a screenshot is taken. It provides a single, validated execution pipeline that maps high-level action definitions (click, type, wait, navigate, frame, etc.) into concrete Playwright calls. This service typically sits inside the screenshot worker flow, ensuring pages are in the desired state (navigation complete, elements ready, UI interacted with) prior to capture.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `executeActions` | `executeActions(page: Page, actions: ScreenshotActionDto[] | undefined)` | `Promise<void>` |
| `executeActionsWithHook` | `executeActionsWithHook(page: Page, actions: ScreenshotActionDto[] | undefined, onAfterEach: (action: ScreenshotActionDto, index: number) => Promise<void>)` | `Promise<void>` |
| `executeAction` | `executeAction(page: Page, action: ScreenshotActionDto, index: number, context: ActionContext)` | `Promise<ActionContext | void>` |
| `executeWaitFor` | `executeWaitFor(page: Page, waitFor: WaitForDto | undefined)` | `Promise<void>` |
| `validateAction` | `validateAction(action: ScreenshotActionDto)` | `void` |
| `captureDOMState` | `captureDOMState(page: Page)` | `Promise<CapturedDOMState>` |

## Diagram

```mermaid
sequenceDiagram
  participant Orchestrator as Screenshot Orchestrator
  participant Executor as ActionExecutorService
  participant Page as Playwright Page
  participant Frame as Playwright Frame

  Orchestrator->>Executor: execute(page, actions[])
  loop for each action
    alt action.type == "frame"
      Executor->>Page: frameLocator()/frame()
      Page-->>Executor: Frame context
      Executor->>Frame: set active context
    else action targets frame context
      Executor->>Frame: perform action (click/type/wait/etc.)
    else action targets page context
      Executor->>Page: perform action (navigate/wait/scroll/etc.)
    end
  end
  Executor-->>Orchestrator: done (page ready for capture)
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { chromium, type Page } from 'playwright';
import { ActionExecutorService } from './services/action-executor.service';

@Injectable()
export class ScreenshotJobRunner {
  constructor(private readonly actionExecutor: ActionExecutorService) {}

  async run() {
    const browser = await chromium.launch();
    const page: Page = await (await browser.newContext()).newPage();

    // Example action list (shape may vary slightly based on your DTOs)
    const actions = [
      { type: 'navigate', url: 'https://example.com' },
      { type: 'wait', condition: { type: 'loadState', state: 'networkidle' } },
      { type: 'click', selector: 'text=Sign in' },
      { type: 'fill', selector: 'input[name="email"]', value: 'user@example.com' },
      { type: 'press', selector: 'input[name="password"]', key: 'Tab' },
      { type: 'type', selector: 'input[name="password"]', value: 'correct horse battery staple' },
      { type: 'click', selector: 'button[type="submit"]' },
      { type: 'wait', condition: { type: 'selector', selector: '[data-testid="dashboard"]' } },
      { type: 'scroll', to: 'bottom' },
      // Switch into an iframe, then interact within it
      { type: 'frame', selector: 'iframe#billing' },
      { type: 'select', selector: 'select#plan', value: 'pro' },
      { type: 'hover', selector: '[data-testid="plan-details"]' },
    ];

    await this.actionExecutor.execute(page, actions);

    // Now page is prepared for capture
    const screenshot = await page.screenshot({ fullPage: true });

    await browser.close();
    return screenshot;
  }
}
```

## AI Coding Instructions

- Keep the action execution path **strictly deterministic**: validate action payloads up-front and route by `action.type` with a single dispatcher to avoid divergent behavior.
- When implementing waits, prefer explicit `wait` actions with supported condition types (`selector`, `timeout`, `networkIdle`, `loadState`, `function`) and avoid hidden implicit sleeps inside other actions.
- Be careful with **frame context**: `frame` actions should update the active execution target (Page vs Frame). Ensure subsequent selector-based actions operate in the intended context.
- Integrate new action types by mapping directly to Playwright primitives and preserving consistent error messages (include `action.type` and selector/url where applicable) to aid job debugging.

<!-- source: type-actiontype.md -->

# ActionType

**Kind:** Type

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 38)

## Definition

```ts
typeof ACTION_TYPES[number]
```

<!-- source: constant-action-types.md -->

# ACTION_TYPES

**Kind:** Constant

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 32)

<!-- source: controller-activitycontroller.md -->

# ActivityController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/activity/activity.controller.ts` (line 11)

## Relationships

- MODULE_DECLARES → `list`
- MODULE_DECLARES → `getDocumentActivities`
- MODULE_DECLARES → `getProjectActivities`
- MODULE_DECLARES → `getRecentProjects`
- MODULE_DECLARES → `getRecentDocuments`
- DEPENDS_ON → `activityservice`

<!-- source: module-activitymodule.md -->

# ActivityModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/activity/activity.module.ts` (line 8)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_DECLARES → `activitycontroller`
- MODULE_PROVIDES → `activityservice`
- MODULE_EXPORTS → `activityservice`

<!-- source: service-activityservice.md -->

# ActivityService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/activity/activity.service.ts` (line 7)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `log` | `log(dto: CreateActivityDto)` | `Promise<void>` |
| `getActivities` | `getActivities(filters: ActivityFiltersDto)` | `unknown` |
| `getDocumentActivities` | `getDocumentActivities(documentId: string)` | `unknown` |
| `getProjectActivities` | `getProjectActivities(projectId: string)` | `unknown` |
| `trackActivity` | `trackActivity(userId: string, entityType: 'PROJECT' | 'DOCUMENT', entityId: string, actionType: 'VIEW' | 'EDIT' | 'CREATE')` | `unknown` |
| `getRecentProjects` | `getRecentProjects(userId: string, limit: unknown)` | `unknown` |
| `getRecentDocuments` | `getRecentDocuments(userId: string, limit: unknown)` | `unknown` |
| `getRecentDocumentsByProject` | `getRecentDocumentsByProject(userId: string, projectId: string, limit: unknown)` | `unknown` |
| `clearActivity` | `clearActivity(userId: string, entityType: 'PROJECT' | 'DOCUMENT')` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: interface-adaptivepromptoptions.md -->

# AdaptivePromptOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/adaptive-prompt.ts` (line 30)

## Properties

| Property | Type |
|---|---|
| `workspace` | `string` |
| `toolGuide` | `string` |
| `repoMap` | `string` |
| `projectContext` | `string` |
| `memoryContext` | `string` |
| `deferredToolsReminder` | `string` |
| `skillDescriptions` | `string` |
| `pluginCommands` | `string` |
| `domainRules` | `string[]` |
| `modelProfile` | `ModelCapabilityProfile` |
| `mode` | `TaskMode` |

<!-- source: function-addcodesamplestospec.md -->

# addCodeSamplesToSpec

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/code-samples.ts` (line 56)

Attach `x-codeSamples` to every operation in the spec (mutates + returns it). Requires the
full spec so `$ref` request/response schemas resolve into example payloads.

## Signature

```ts
function addCodeSamplesToSpec(spec: any, targets: string[]): any
```

## Parameters

| Name | Type |
|---|---|
| `spec` | `any` |
| `targets` | `string[]` |

**Returns:** `any`

<!-- source: graphql-mutation-addcomment.md -->

# addComment

**Kind:** Graphql Mutation

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Add comment to post

## Relationships

- TYPE_OF → `Comment`

## Referenced By

- `Mutation` (CALLS_API)

<!-- source: type-additionallexicalnode.md -->

# AdditionalLexicalNode

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 90)

## Definition

```ts
KlassConstructor<typeof LexicalNode> | LexicalNodeReplacement
```

<!-- source: type-afterturncallback.md -->

# AfterTurnCallback

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/autonomous-loop.ts` (line 210)

Callback fired after each model turn completes.
Use for live monitoring / progress logging.

## Definition

```ts
(event: {
  turnNumber: number;
  toolsUsed: string[];
  loopState: Readonly<LoopState>;
  /** Failing quality gate IDs (empty if all pass or no provider) */
  failingGates: string[];
}) => void
```

<!-- source: function-agentcommand.md -->

# agentCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/agent.command.ts` (line 143)

## Signature

```ts
async function agentCommand(options: AgentCommandOptions): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `AgentCommandOptions` |

**Returns:** `Promise<void>`

<!-- source: interface-agentcommandoptions.md -->

# AgentCommandOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/commands/agent.command.ts` (line 93)

## Properties

| Property | Type |
|---|---|
| `model` | `string` |
| `workspace` | `string` |
| `maxTurns` | `string` |
| `autonomous` | `boolean` |
| `verbose` | `boolean` |
| `project` | `string` |
| `org` | `string` |
| `super` | `boolean` |
| `routingTable` | `string` |
| `continue` | `string | boolean` |
| `mode` | `string` |
| `remoteTriggers` | `boolean` |

<!-- source: service-agentcontextservice.md -->

# AgentContextService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/agent-context.service.ts` (line 1)

<!-- source: class-agentnotestore.md -->

# AgentNoteStore

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/autonomous-loop.ts` (line 233)

Store for session-scoped agent notes.
Shared between the note tool and the TurnHook.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `add` | `add(turn: number, content: string)` | `AgentNote` |
| `getAll` | `getAll()` | `AgentNote[]` |
| `count` | `count()` | `number` |
| `format` | `format()` | `string` |

<!-- source: function-aggregateresults.md -->

# aggregateResults

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 146)

Aggregate parse results for assertions

## Signature

```ts
function aggregateResults(results: ParseResult[]): {
  totalFiles: number;
  successfulFiles: number;
  failedFiles: number;
  skippedFiles: number;
  totalEntities: number;
  totalRelationships: number;
  totalErrors: number;
  totalWarnings: number;
  entitiesByType: Record<string, number>;
  relationshipsByType: Record<string, number>;
}
```

## Parameters

| Name | Type |
|---|---|
| `results` | `ParseResult[]` |

**Returns:** `{
  totalFiles: number;
  successfulFiles: number;
  failedFiles: number;
  skippedFiles: number;
  totalEntities: number;
  totalRelationships: number;
  totalErrors: number;
  totalWarnings: number;
  entitiesByType: Record<string, number>;
  relationshipsByType: Record<string, number>;
}`

<!-- source: interface-aienhancementoptions.md -->

# AIEnhancementOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ai-enhancement.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `enableCompetitorResearch` | `boolean` |
| `maxCompetitors` | `number` |
| `cacheResults` | `boolean` |

<!-- source: interface-aiprovider.md -->

# AIProvider

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/types/ai.ts` (line 7)

## Properties

| Property | Type |
|---|---|
| `name` | `AIProviderName` |
| `available` | `boolean` |
| `displayName` | `string` |
| `description` | `string` |

<!-- source: class-aiprovidererror.md -->

# AIProviderError

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/errors.ts` (line 118)

Error thrown when AI provider fails

**Extends:** `PipelineError`

## Properties

| Property | Type |
|---|---|
| `provider` | `'claude' | 'openai' | 'azure-responses'` |
| `statusCode` | `number` |

<!-- source: type-aiprovidername-2.md -->

# AIProviderName

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/ai/interfaces/ai-types.ts` (line 1)

## Definition

```ts
'azure-claude' | 'azure-openai' | 'azure-codex' | 'azure-gpt52' | 'claude' | 'openai' | 'codex'
```

<!-- source: type-aiprovidername.md -->

# AIProviderName

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/types/ai.ts` (line 5)

AI Settings & Configuration Types

## Definition

```ts
'azure-claude' | 'azure-openai' | 'claude' | 'openai'
```

<!-- source: function-always.md -->

# always

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/prompt-sections.ts` (line 86)

Always include

## Signature

```ts
function always(_ctx: SectionContext): boolean
```

## Parameters

| Name | Type |
|---|---|
| `_ctx` | `SectionContext` |

**Returns:** `boolean`

<!-- source: controller-analysiscontroller.md -->

# AnalysisController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/analysis/analysis.controller.ts` (line 5)

## Relationships

- MODULE_DECLARES → `startAnalysis`
- MODULE_DECLARES → `getJobStatus`
- MODULE_DECLARES → `getProjectJobs`
- DEPENDS_ON → `analysisservice`

<!-- source: module-analysismodule.md -->

# AnalysisModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/analysis/analysis.module.ts` (line 7)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `gitmodule`
- MODULE_DECLARES → `analysiscontroller`
- MODULE_PROVIDES → `analysisservice`
- MODULE_EXPORTS → `analysisservice`

<!-- source: service-analysisservice.md -->

# AnalysisService

**Kind:** Service

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/analysis/analysis.service.ts` (line 17)

Analysis orchestrator service

This service coordinates the entire code analysis pipeline:
1. Clone repository (with mono-repo support)
2. Analyze codebase using file optimization techniques
3. Generate UI documentation and element extraction
4. Create Playwright tests
5. Track progress in database
6. Cleanup after completion

## Methods

| Method | Signature | Returns |
|---|---|---|
| `startAnalysis` | `startAnalysis(dto: StartAnalysisDto)` | `Promise<string>` |
| `getJobStatus` | `getJobStatus(jobId: string)` | `unknown` |
| `getProjectJobs` | `getProjectJobs(projectId: string)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `gitservice`

<!-- source: class-angularparser.md -->

# AngularParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/frontend-parser/src/parsers/angular.parser.ts` (line 61)

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `supportedPatterns` | `string[]` |

<!-- source: class-angularparser-2.md -->

# AngularParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/frontend/angular.parser.ts` (line 91)

Angular Parser

Pure TypeScript class that parses Angular TypeScript files.
No NestJS dependencies required.

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `supportedPatterns` | `string[]` |

<!-- source: constant-apiauthenticationtemplate.md -->

# apiAuthenticationTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/api-authentication.template.ts` (line 3)

<!-- source: interface-apiendpointentity.md -->

# APIEndpointEntity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 453)

API Endpoint entity

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.API_ENDPOINT` |
| `method` | `'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD'` |
| `path` | `string` |
| `pathParams` | `ParameterDefinition[]` |
| `queryParams` | `ParameterDefinition[]` |
| `requestBody` | `SchemaDefinition` |
| `responses` | `ResponseDefinition[]` |
| `authentication` | `AuthenticationInfo` |
| `rateLimit` | `RateLimitInfo` |
| `middleware` | `string[]` |
| `controller` | `string` |
| `operationId` | `string` |

<!-- source: class-apierror.md -->

# ApiError

**Kind:** Class

**Source:** `atloria-monorepo/apps/web/src/lib/api-client.ts` (line 92)

API error carrying the HTTP status so callers can branch on it.
402 (out of credits) must render an upgrade CTA, never a blind Retry.

**Extends:** `Error`

<!-- source: type-apiexecfn.md -->

# ApiExecFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/mcp-toolset.ts` (line 43)

Optional live-API execution backend. Injected the same way as askFn so the toolset stays PURE
(no fetch/dns/Nest here) — all outbound HTTP, SSRF validation, method allow-listing and
server-side auth injection live in the executor the API layer builds (api-executor.ts). Present
only when the project has opted into a Live API target, which is what gates the `call_operation`
tool below.

## Definition

```ts
(input: {
  method: string;
  path: string;
  pathParams?: Record<string, string>;
  query?: Record<string, string>;
  body?: unknown;
}) => Promise<{ status: number; statusText: string; headers: Record<string, string>; body: unknown }>
```

<!-- source: class-apiexplorerpagegenerator.md -->

# APIExplorerPageGenerator

**Kind:** Class

**Source:** `atloria-monorepo/apps/cli/src/generators/api-explorer-page.generator.ts` (line 58)

API Explorer Page Generator

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate(entities: Entity[], _relationships: Relationship[])` | `Promise<void>` |

<!-- source: constant-api-url.md -->

# API_URL

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 16)

Shared types + design tokens for the Support Desk shell.

The desk codes against the parallel backend contract:
  GET  desk/:projectId/counts
  GET  desk/:projectId/threads?bucket=...&limit=50
  GET  desk/:projectId/threads/:id
  POST desk/:projectId/threads/:id/transition {action, snoozedUntil?}
  POST desk/:projectId/threads/:id/reply {body, internal?, andDone?}
  POST desk/:projectId/threads/:id/duplicate {intoTicketNumber}

Chip palettes intentionally mirror apps/web/src/app/app/settings/issues/all/page.tsx
so tickets look identical across the Issues pages and the Desk.

<!-- source: controller-appcontroller.md -->

# AppController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/app.controller.ts` (line 4)

## Relationships

- MODULE_DECLARES → `getHealth`
- MODULE_DECLARES → `getInfo`
- DEPENDS_ON → `appservice`

<!-- source: controller-appcontroller-3.md -->

# AppController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api-schema-parser/src/app.controller.ts` (line 14)

## Relationships

- MODULE_DECLARES → `getHealth`
- MODULE_DECLARES → `getParsers`
- DEPENDS_ON → `appservice`

<!-- source: function-applyautolayout.md -->

# applyAutoLayout

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Graph/graphUtils.ts` (line 206)

Apply auto-layout using dagre

## Signature

```ts
function applyAutoLayout(nodes: GraphNode[], edges: GraphEdge[]): { nodes: GraphNode[]; edges: GraphEdge[] }
```

## Parameters

| Name | Type |
|---|---|
| `nodes` | `GraphNode[]` |
| `edges` | `GraphEdge[]` |

**Returns:** `{ nodes: GraphNode[]; edges: GraphEdge[] }`

<!-- source: function-applycuration.md -->

# applyCuration

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/curation.ts` (line 79)

## Signature

```ts
function applyCuration(navMap: T, curation: TechdocsCuration): T
```

## Parameters

| Name | Type |
|---|---|
| `navMap` | `T` |
| `curation` | `TechdocsCuration` |

**Returns:** `T`

<!-- source: module-appmodule-9.md -->

# AppModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/frontend-parser/src/app.module.ts` (line 16)

## Relationships

- MODULE_PROVIDES → `reactparser`
- MODULE_PROVIDES → `nextjsparser`
- MODULE_PROVIDES → `vueparser`
- MODULE_PROVIDES → `angularparser`
- MODULE_EXPORTS → `reactparser`
- MODULE_EXPORTS → `nextjsparser`
- MODULE_EXPORTS → `vueparser`
- MODULE_EXPORTS → `angularparser`

<!-- source: module-appmodule-7.md -->

# AppModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/config-docs-parser/src/app.module.ts` (line 21)

## Relationships

- MODULE_DECLARES → `healthcontroller`
- MODULE_PROVIDES → `markdownparser`
- MODULE_PROVIDES → `mdxparser`
- MODULE_PROVIDES → `envparser`
- MODULE_PROVIDES → `yamlparser`
- MODULE_PROVIDES → `jsonconfigparser`
- MODULE_PROVIDES → `parserregistryservice`
- MODULE_EXPORTS → `markdownparser`
- MODULE_EXPORTS → `mdxparser`
- MODULE_EXPORTS → `envparser`
- MODULE_EXPORTS → `yamlparser`
- MODULE_EXPORTS → `jsonconfigparser`
- MODULE_EXPORTS → `parserregistryservice`

<!-- source: module-appmodule-8.md -->

# AppModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/database-parser/src/app.module.ts` (line 7)

## Relationships

- MODULE_PROVIDES → `prismaparser`
- MODULE_PROVIDES → `typeormparser`
- MODULE_PROVIDES → `sequelizeparser`
- MODULE_PROVIDES → `migrationparser`
- MODULE_EXPORTS → `prismaparser`
- MODULE_EXPORTS → `typeormparser`
- MODULE_EXPORTS → `sequelizeparser`
- MODULE_EXPORTS → `migrationparser`

<!-- source: module-appmodule-5.md -->

# AppModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/backend-parser/src/app.module.ts` (line 16)

## Relationships

- MODULE_PROVIDES → `nestjsparser`
- MODULE_PROVIDES → `expressparser`
- MODULE_PROVIDES → `fastapiparser`
- MODULE_PROVIDES → `djangoparser`
- MODULE_PROVIDES → `backendparserservice`
- MODULE_EXPORTS → `nestjsparser`
- MODULE_EXPORTS → `expressparser`
- MODULE_EXPORTS → `fastapiparser`
- MODULE_EXPORTS → `djangoparser`
- MODULE_EXPORTS → `backendparserservice`

<!-- source: module-appmodule.md -->

# AppModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/app.module.ts` (line 24)

## Relationships

- MODULE_IMPORTS → `queuemodule`
- MODULE_IMPORTS → `knowledgegraphmodule`
- MODULE_IMPORTS → `orchestratormodule`
- MODULE_IMPORTS → `integrationmodule`

<!-- source: module-appmodule-4.md -->

# AppModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api-schema-parser/src/app.module.ts` (line 17)

## Relationships

- MODULE_DECLARES → `appcontroller`
- MODULE_PROVIDES → `appservice`
- MODULE_PROVIDES → `openapiparser`
- MODULE_PROVIDES → `graphqlparser`
- MODULE_PROVIDES → `grpcparser`
- MODULE_EXPORTS → `openapiparser`
- MODULE_EXPORTS → `graphqlparser`
- MODULE_EXPORTS → `grpcparser`

<!-- source: module-appmodule-2.md -->

# AppModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/app.module.ts` (line 13)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `playwrightmodule`
- MODULE_IMPORTS → `storagemodule`
- MODULE_IMPORTS → `screenshotmodule`
- MODULE_IMPORTS → `pdfmodule`
- MODULE_IMPORTS → `discoverymodule`
- MODULE_DECLARES → `appcontroller`
- MODULE_PROVIDES → `appservice`

<!-- source: service-appservice-3.md -->

# AppService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api-schema-parser/src/app.service.ts` (line 13)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getHealth` | `getHealth()` | `{ status: string; parsers: string[]; version: string }` |
| `getSupportedParsers` | `getSupportedParsers()` | `Array<{
    name: string;
    version: string;
    patterns: string[];
  }>` |

<!-- source: function-assemblesite.md -->

# assembleSite

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/assembler.ts` (line 36)

Assemble a complete site from config.

## Signature

```ts
async function assembleSite(config: SiteAssemblyConfig, deps: AssemblerDeps): Promise<AssemblyResult>
```

## Parameters

| Name | Type |
|---|---|
| `config` | `SiteAssemblyConfig` |
| `deps` | `AssemblerDeps` |

**Returns:** `Promise<AssemblyResult>`

<!-- source: class-assemblyerror.md -->

# AssemblyError

**Kind:** Class

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/errors.ts` (line 9)

**Extends:** `Error`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `toJSON` | `toJSON()` | `void` |

<!-- source: type-assemblystage.md -->

# AssemblyStage

**Kind:** Type

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 87)

## Definition

```ts
| 'validate'
  | 'copy-template'
  | 'copy-sections'
  | 'generate-landing-page'
  | 'generate-main'
  | 'generate-app'
  | 'generate-i18n'
  | 'generate-locales'
  | 'verify'
```

<!-- source: function-assertnoaccessibilityviolations.md -->

# assertNoAccessibilityViolations

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/accessibility.ts` (line 99)

Assert no accessibility violations (WCAG AA by default)

## Signature

```ts
async function assertNoAccessibilityViolations(page: Page, options: {
    level?: WCAGLevel;
    include?: string[];
    exclude?: string[];
    disabledRules?: string[];
    allowedViolations?: string[];
  }): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |
| `options` | `{
    level?: WCAGLevel;
    include?: string[];
    exclude?: string[];
    disabledRules?: string[];
    allowedViolations?: string[];
  }` |

**Returns:** `Promise<void>`

<!-- source: module-atloria-csharpparser.md -->

# Atloria.CSharpParser

**Kind:** Module

**Source:** `atloria-monorepo/libs/parser-core/src/dotnet-bridge/Atloria.CSharpParser/Atloria.CSharpParser.csproj` (line 1)

.NET Exe project (C#)

## Relationships

- DEPENDS_ON → `Microsoft.CodeAnalysis.CSharp`
- DEPENDS_ON → `System.Text.Json`

<!-- source: enum-audience.md -->

# Audience

**Kind:** Enum

**Source:** `atloria-monorepo/packages/types/src/enums/index.ts` (line 45)

Audience types define who the documentation is intended for
Note: Matches Prisma schema exactly

## Values

- `TECHNICAL`
- `USER`
- `API`
- `INTERNAL`

<!-- source: interface-authconfig-2.md -->

# AuthConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.service.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `loginUrl` | `string` |
| `username` | `string` |
| `password` | `string` |
| `usernameSelector` | `string` |
| `passwordSelector` | `string` |
| `submitSelector` | `string` |
| `successSelector` | `string` |

<!-- source: component-avatar.md -->

# Avatar

**Kind:** Component

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/frontend/src/components/Avatar.tsx` (line 16)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `src` | `any` | ✓ | - |
| `alt` | `any` | ✓ | - |
| `size` | `any` | - | "medium" |
| `fallback` | `any` | - | "/default-avatar.png" |

## Diagram

```mermaid
graph TD
    component_Avatar_31a20b94["Avatar"]
    class component_Avatar_31a20b94 rootComponent
```

## Relationships

- USES_HOOK → `useState`

<!-- source: class-azureimageprovider.md -->

# AzureImageProvider

**Kind:** Class

**Source:** `atloria-monorepo/libs/pme-core/src/providers/azure-image.provider.ts` (line 30)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate(options: ImageGenerationOptions)` | `Promise<ImageGenerationResponse>` |

<!-- source: interface-azureimageproviderconfig.md -->

# AzureImageProviderConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/providers/azure-image.provider.ts` (line 8)

Azure Image Provider

Thin client for GPT-image-1.5 via Azure OpenAI.
Different API shape from text models — uses the images/generations endpoint.

## Properties

| Property | Type |
|---|---|
| `endpoint` | `string` |
| `apiKey` | `string` |
| `apiVersion` | `string` |
| `deploymentName` | `string` |
| `timeout` | `number` |

<!-- source: service-backendparserservice.md -->

# BackendParserService

**Kind:** Service

**Source:** `atloria-monorepo/apps/backend-parser/src/backend-parser.service.ts` (line 31)

Backend Parser Service

Provides a unified interface for all backend parsers.
Automatically selects the appropriate parser based on file type.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleInit` | `onModuleInit()` | `Promise<void>` |
| `onModuleDestroy` | `onModuleDestroy()` | `Promise<void>` |
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `getParsers` | `getParsers()` | `IParser[]` |
| `getParser` | `getParser(name: string)` | `IParser | undefined` |
| `findParserForFile` | `findParserForFile(filePath: string)` | `IParser | undefined` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `parseFilesGrouped` | `parseFilesGrouped(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `getSupportedPatterns` | `getSupportedPatterns()` | `string[]` |
| `getParserMetadata` | `getParserMetadata()` | `Array<{
    name: string;
    version: string;
    supportedPatterns: string[];
  }>` |

## Relationships

- DEPENDS_ON → `nestjsparser`
- DEPENDS_ON → `expressparser`
- DEPENDS_ON → `fastapiparser`
- DEPENDS_ON → `djangoparser`

<!-- source: constant-banned-phrases-list.md -->

# BANNED_PHRASES_LIST

**Kind:** Constant

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/brand-voice.guardrail.ts` (line 125)

<!-- source: class-basepage.md -->

# BasePage

**Kind:** Class

**Source:** `atloria-monorepo/apps/web-e2e/src/pages/base.page.ts` (line 6)

Base page object with common functionality

## Methods

| Method | Signature | Returns |
|---|---|---|
| `goto` | `goto()` | `Promise<void>` |
| `waitForPageLoad` | `waitForPageLoad()` | `Promise<void>` |
| `getURL` | `getURL()` | `string` |
| `isVisible` | `isVisible(selector: string)` | `Promise<boolean>` |
| `getToast` | `getToast()` | `Locator` |
| `waitForToast` | `waitForToast(expectedText: string)` | `Promise<string>` |
| `getModal` | `getModal()` | `Locator` |
| `closeModal` | `closeModal()` | `Promise<void>` |
| `waitForLoading` | `waitForLoading()` | `Promise<void>` |
| `getPageTitle` | `getPageTitle()` | `Promise<string>` |
| `takeScreenshot` | `takeScreenshot(name: string)` | `Promise<Buffer>` |

<!-- source: class-batchauthconfigdto.md -->

# BatchAuthConfigDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 499)

## Properties

| Property | Type |
|---|---|
| `loginUrl` | `string` |
| `username` | `string` |
| `password` | `string` |
| `usernameSelector` | `string` |
| `passwordSelector` | `string` |
| `submitSelector` | `string` |
| `successSelector` | `string` |
| `useSmartDetection` | `boolean` |
| `healthCheck` | `SessionHealthCheckDto` |

<!-- source: function-boxtoclip.md -->

# boxToClip

**Kind:** Function

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/crop.service.ts` (line 36)

Convert a percent box (0-100 of the natural image) into a Playwright clip rect
in PIXELS, framing the target with `padPct` of breathing room on every side and
clamped to the image bounds so the clip never runs off-canvas.

## Signature

```ts
function boxToClip(box: BoxPct, imgW: number, imgH: number, padPct): ClipRect
```

## Parameters

| Name | Type |
|---|---|
| `box` | `BoxPct` |
| `imgW` | `number` |
| `imgH` | `number` |
| `padPct` | `any` |

**Returns:** `ClipRect`

<!-- source: enum-browsertype.md -->

# BrowserType

**Kind:** Enum

**Source:** `atloria-monorepo/apps/api/src/screenshot/dto/capture-screenshot.dto.ts` (line 20)

## Values

- `CHROMIUM`
- `FIREFOX`
- `WEBKIT`

<!-- source: function-buildcontentgenerationprompt.md -->

# buildContentGenerationPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/coordinator.prompts.ts` (line 156)

## Signature

```ts
function buildContentGenerationPrompt(sectionType: SectionType, docContext: string, config: GenerationConfig): string
```

## Parameters

| Name | Type |
|---|---|
| `sectionType` | `SectionType` |
| `docContext` | `string` |
| `config` | `GenerationConfig` |

**Returns:** `string`

<!-- source: api-endpoint-canceljob.md -->

# cancelJob

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/orchestrator.controller.ts` (line 133)

Cancel a job

## Endpoint

`DELETE /api/orchestrator/jobs/:jobId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `jobId` | query | `string` | ✓ |

## Referenced By

- `OrchestratorController` (MODULE_DECLARES)

<!-- source: enum-changeseverity.md -->

# ChangeSeverity

**Kind:** Enum

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/version-diff.ts` (line 22)

Change severity

## Values

- `Major`
- `Minor`
- `Patch`

<!-- source: function-checkifexported.md -->

# checkIfExported

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 433)

Check if a name is exported

## Signature

```ts
function checkIfExported(name: string, exportedNames: Set<string>): boolean
```

## Parameters

| Name | Type |
|---|---|
| `name` | `string` |
| `exportedNames` | `Set<string>` |

**Returns:** `boolean`

<!-- source: constant-claude-profile.md -->

# CLAUDE_PROFILE

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-profiles.ts` (line 165)

Anthropic Claude (via Azure or direct API).
- No reasoning effort field
- No apply_patch format (uses edit_file natively)
- No tool persistence nudging needed

## Definition

```ts
ModelCapabilityProfile
```

<!-- source: interface-cloneoptions-2.md -->

# CloneOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/git/git.service.ts` (line 10)

## Properties

| Property | Type |
|---|---|
| `repoUrl` | `string` |
| `branch` | `string` |
| `folderPath` | `string` |
| `depth` | `number` |

<!-- source: type-contentgeneratefn.md -->

# ContentGenerateFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/tools/generate-content.tool.ts` (line 16)

Content generation function — wraps AzureResponsesProvider.generateJSON().
Injected at tool creation time.

## Definition

```ts
(
  prompt: string,
  systemPrompt: string,
  maxTokens?: number
) => Promise<{ content: string; inputTokens: number; outputTokens: number }>
```

<!-- source: api-endpoint-createbatchjob.md -->

# createBatchJob

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/batch-screenshot.controller.ts` (line 101)

Create and start a batch screenshot job

POST /api/screenshot/batch

Returns immediately with job ID for polling.
Processing happens asynchronously in the background.

## Endpoint

`POST /screenshot/batch`

## Referenced By

- `BatchScreenshotController` (MODULE_DECLARES)

<!-- source: function-database.md -->

# database

**Kind:** Function

**Source:** `atloria-monorepo/libs/database/src/lib/database.ts` (line 1)

## Signature

```ts
function database(): string
```

**Returns:** `string`

<!-- source: module-databasemodule.md -->

# DatabaseModule

**Kind:** Module

**Source:** `atloria-monorepo/libs/database/src/lib/database.module.ts` (line 7)

## Relationships

- MODULE_IMPORTS → `configmodule`
- MODULE_PROVIDES → `prismaservice`
- MODULE_PROVIDES → `redisservice`
- MODULE_EXPORTS → `prismaservice`
- MODULE_EXPORTS → `redisservice`

<!-- source: component-datebadge.md -->

# DateBadge

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/social-proof/social-proof-timeline.tsx` (line 23)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `dateKey` | `string` | ✓ | - |
| `t` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DateBadge_7efe08da["DateBadge"]
    class component_DateBadge_7efe08da rootComponent
```

## Referenced By

- `MilestoneCard` (RENDERS)

<!-- source: type-datetime.md -->

# DateTime

**Kind:** Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Custom scalar for date-time

`DateTime` is a custom GraphQL scalar used to represent date-time values in a consistent, API-friendly format. It’s typically serialized as an ISO-8601 string in responses and parsed/validated on input to ensure clients and services exchange timestamps reliably across the system.

## Diagram

```mermaid
graph LR
  Client[GraphQL Client] -->|Query/Mutation with DateTime| API[GraphQL API]
  API -->|Parse & validate| Scalar[DateTime Scalar]
  Scalar -->|Convert to JS Date / internal representation| Resolvers[Resolvers]
  Resolvers -->|Return DateTime| Scalar
  Scalar -->|Serialize ISO-8601 string| Client
```

## Usage

```ts
import { GraphQLScalarType, Kind } from "graphql";

// Example DateTime scalar implementation (ISO-8601)
export const DateTime = new GraphQLScalarType({
  name: "DateTime",
  description: "Custom scalar for date-time",
  serialize(value: unknown): string {
    const date = value instanceof Date ? value : new Date(String(value));
    if (Number.isNaN(date.getTime())) throw new TypeError("DateTime cannot serialize invalid date");
    return date.toISOString();
  },
  parseValue(value: unknown): Date {
    const date = new Date(String(value));
    if (Number.isNaN(date.getTime())) throw new TypeError("DateTime cannot parse invalid date");
    return date;
  },
  parseLiteral(ast): Date {
    if (ast.kind !== Kind.STRING) throw new TypeError("DateTime must be a string literal");
    const date = new Date(ast.value);
    if (Number.isNaN(date.getTime())) throw new TypeError("DateTime cannot parse invalid date");
    return date;
  },
});

// Example usage in schema (SDL):
// scalar DateTime
// type Event { id: ID!, startsAt: DateTime! }

// Example resolver returning a JS Date (will serialize to ISO string)
export const resolvers = {
  DateTime,
  Query: {
    serverTime: () => new Date(),
  },
  Mutation: {
    createEvent: (_: unknown, args: { startsAt: Date }) => ({
      id: "evt_123",
      startsAt: args.startsAt, // parsed by DateTime.parseValue
    }),
  },
};
```

## AI Coding Instructions

- Treat `DateTime` values as ISO-8601 strings at the GraphQL boundary; convert to `Date` (or your internal time type) inside resolvers/services.
- Validate inputs aggressively (`Invalid Date` checks) to avoid silently accepting malformed timestamps and propagating bad data.
- Be explicit about timezone behavior: prefer `toISOString()` (UTC) for serialization to keep client/server consistent.
- When integrating with DB/ORM layers, standardize on one representation (e.g., store as UTC, return `Date` objects to GraphQL so the scalar can serialize).
- Avoid accepting non-string literals in `parseLiteral` unless you intentionally support them; mixed formats are a common source of client incompatibilities.

## Referenced By

- `User` (TYPE_OF)
- `User` (TYPE_OF)
- `Post` (TYPE_OF)
- `Post` (TYPE_OF)
- `Post` (TYPE_OF)
- `Comment` (TYPE_OF)
- `Comment` (TYPE_OF)
- `Like` (TYPE_OF)
- `Follow` (TYPE_OF)

<!-- source: constant-default-targets.md -->

# DEFAULT_TARGETS

**Kind:** Constant

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/code-samples.ts` (line 26)

<!-- source: constant-defaulttestuser.md -->

# defaultTestUser

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web-e2e/src/fixtures/base.fixture.ts` (line 16)

Default test user for authenticated tests

## Definition

```ts
TestUser
```

<!-- source: class-djangoparser.md -->

# DjangoParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/backend-parser/src/parsers/django.parser.ts` (line 51)

Django REST Framework Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: class-envparser.md -->

# EnvParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/config-docs-parser/src/parsers/env.parser.ts` (line 61)

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: constant-fixtures-path.md -->

# FIXTURES_PATH

**Kind:** Constant

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 22)

<!-- source: component-formatbutton.md -->

# FormatButton

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/BoldItalicUnderlineToggles.tsx` (line 18)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `format` | `any` | ✓ | - |
| `addTitle` | `any` | ✓ | - |
| `removeTitle` | `any` | ✓ | - |
| `icon` | `any` | ✓ | - |
| `formatName` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FormatButton_47bb73da["FormatButton"]
    class component_FormatButton_47bb73da rootComponent
```

## Relationships

- RENDERS → `ToggleSingleGroupWithItem`
- USES_HOOK → `useCellValues`
- USES_HOOK → `usePublisher`

## Referenced By

- `BoldItalicUnderlineToggles` (RENDERS)
- `StrikeThroughSupSubToggles` (RENDERS)

<!-- source: enum-framework.md -->

# Framework

**Kind:** Enum

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/analysis/dto/start-analysis.dto.ts` (line 3)

## Values

- `REACT`
- `ANGULAR`
- `VUE`
- `NEXT`
- `NEST`
- `AUTO`

<!-- source: function-generatecontenthash.md -->

# generateContentHash

**Kind:** Function

**Source:** `atloria-monorepo/apps/database-parser/src/utils/hash.util.ts` (line 8)

Generate a content hash for change detection

## Signature

```ts
function generateContentHash(content: string): string
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |

**Returns:** `string`

<!-- source: api-endpoint-gethealth-3.md -->

# getHealth

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api-schema-parser/src/app.controller.ts` (line 21)

Health check endpoint

## Endpoint

`GET /health`

## Referenced By

- `AppController` (MODULE_DECLARES)

<!-- source: api-endpoint-gethealth-4.md -->

# getHealth

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/app.controller.ts` (line 11)

Health check endpoint

## Endpoint

`GET /`

## Referenced By

- `AppController` (MODULE_DECLARES)

<!-- source: class-graphqlparser.md -->

# GraphQLParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/api-schema-parser/src/parsers/graphql.parser.ts` (line 57)

GraphQL Parser Implementation

Supports:
- GraphQL Schema Definition Language (SDL)
- Queries, Mutations, Subscriptions
- Object Types, Input Types, Enums, Interfaces, Unions
- Directives and field arguments

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: api-endpoint-health.md -->

# health

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/config-docs-parser/src/health.controller.ts` (line 5)

## Endpoint

`GET /health`

## Referenced By

- `HealthController` (MODULE_DECLARES)

<!-- source: controller-healthcontroller.md -->

# HealthController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/config-docs-parser/src/health.controller.ts` (line 3)

## Relationships

- MODULE_DECLARES → `health`

<!-- source: interface-hookinfo.md -->

# HookInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 42)

Information about a hook usage

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `'built-in' | 'custom'` |
| `location` | `string` |
| `dependencies` | `string[]` |

<!-- source: service-integrationservice.md -->

# IntegrationService

**Kind:** Service

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/integration/integration.service.ts` (line 23)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `registerParser` | `registerParser(parser: IParser)` | `Promise<void>` |
| `initializeParser` | `initializeParser(parserName: string, config: ParserConfig)` | `Promise<void>` |
| `getParser` | `getParser(parserName: string)` | `IParser | null` |
| `hasParser` | `hasParser(parserName: string)` | `boolean` |
| `getRegisteredParsers` | `getRegisteredParsers()` | `Array<{
    name: string;
    version: string;
    patterns: string[];
    initialized: boolean;
  }>` |
| `findParserForFile` | `findParserForFile(filePath: string)` | `string | null` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult | null>` |
| `parseFiles` | `parseFiles(files: string[])` | `Promise<ParseResult[]>` |
| `destroyParser` | `destroyParser(parserName: string)` | `Promise<void>` |
| `destroyAll` | `destroyAll()` | `Promise<void>` |
| `generateEntityId` | `generateEntityId(type: string, name: string, filePath: string)` | `string` |
| `generateRelationshipId` | `generateRelationshipId(sourceId: string, type: string, targetId: string)` | `string` |
| `validateEntity` | `validateEntity(entity: Partial<Entity>)` | `{ valid: boolean; errors: string[] }` |
| `validateRelationship` | `validateRelationship(relationship: Partial<Relationship>)` | `{ valid: boolean; errors: string[] }` |

<!-- source: constant-key-patterns.md -->

# KEY_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/pme-agent/test/discovery/ground-truth.ts` (line 139)

Key architectural patterns the agent should discover

<!-- source: service-microsoft-codeanalysis-csharp.md -->

# Microsoft.CodeAnalysis.CSharp

**Kind:** Service

**Source:** `atloria-monorepo/libs/parser-core/src/dotnet-bridge/Atloria.CSharpParser/Atloria.CSharpParser.csproj` (line 1)

NuGet package dependency

## Referenced By

- `Atloria.CSharpParser` (DEPENDS_ON)

<!-- source: class-migrationparser.md -->

# MigrationParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/database-parser/src/parsers/migration.parser.ts` (line 90)

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: graphql-subscription-newcomment.md -->

# newComment

**Kind:** Graphql Subscription

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Subscribe to new comments on a post

## Relationships

- TYPE_OF → `Comment`

## Referenced By

- `Subscription` (CALLS_API)

<!-- source: controller-orchestratorcontroller.md -->

# OrchestratorController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/orchestrator.controller.ts` (line 26)

## Relationships

- MODULE_DECLARES → `dispatchJob`
- MODULE_DECLARES → `parseProject`
- MODULE_DECLARES → `getJobStatus`
- MODULE_DECLARES → `getJobResult`
- MODULE_DECLARES → `cancelJob`
- MODULE_DECLARES → `getQueueMetrics`
- MODULE_DECLARES → `getKGStatistics`
- MODULE_DECLARES → `getAvailableParsers`
- MODULE_DECLARES → `detectParser`
- MODULE_DECLARES → `healthCheck`
- DEPENDS_ON → `orchestratorservice`

<!-- source: interface-parsefilerequest.md -->

# ParseFileRequest

**Kind:** Interface

**Source:** `atloria-monorepo/apps/config-docs-parser/src/services/parser-registry.service.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `content` | `string` |

<!-- source: class-parsejobdto.md -->

# ParseJobDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/dto/parse-job.dto.ts` (line 27)

DTO for dispatching a single parse job

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `files` | `string[]` |
| `parserType` | `string` |
| `config` | `Record<string, unknown>` |
| `priority` | `number` |

<!-- source: service-parserregistryservice.md -->

# ParserRegistryService

**Kind:** Service

**Source:** `atloria-monorepo/apps/config-docs-parser/src/services/parser-registry.service.ts` (line 30)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleInit` | `onModuleInit()` | `Promise<void>` |
| `onModuleDestroy` | `onModuleDestroy()` | `Promise<void>` |
| `configure` | `configure(config: ParserRegistryConfig)` | `Promise<void>` |
| `getAllParsers` | `getAllParsers()` | `IParser[]` |
| `getParser` | `getParser(name: string)` | `IParser | undefined` |
| `hasParser` | `hasParser(name: string)` | `boolean` |
| `getParserNames` | `getParserNames()` | `string[]` |
| `findParsersForFile` | `findParsersForFile(filePath: string)` | `IParser[]` |
| `findBestParser` | `findBestParser(filePath: string)` | `IParser | undefined` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileRequest[])` | `Promise<ParseResult[]>` |
| `getAllSupportedPatterns` | `getAllSupportedPatterns()` | `string[]` |
| `getStats` | `getStats()` | `{
    parserCount: number;
    parsers: Array<{ name: string; version: string; patterns: string[] }>;
    totalPatterns: number;
  }` |
| `destroyAll` | `destroyAll()` | `Promise<void>` |
| `isInitialized` | `isInitialized()` | `boolean` |

## Relationships

- DEPENDS_ON → `markdownparser`
- DEPENDS_ON → `mdxparser`
- DEPENDS_ON → `envparser`
- DEPENDS_ON → `yamlparser`
- DEPENDS_ON → `jsonconfigparser`

<!-- source: module-pmeagentmodule.md -->

# PmeAgentModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/pme-agent/src/pme-agent.module.ts` (line 8)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `queuemodule`

<!-- source: interface-pmejobpayload.md -->

# PmeJobPayload

**Kind:** Interface

**Source:** `atloria-monorepo/apps/pme-agent/src/queue/pme.processor.ts` (line 62)

## Properties

| Property | Type |
|---|---|
| `jobId` | `string` |
| `projectId` | `string` |
| `userId` | `string` |
| `organizationId` | `string` |
| `config` | `GenerationConfig` |

<!-- source: class-pmeprocessor.md -->

# PmeProcessor

**Kind:** Class

**Source:** `atloria-monorepo/apps/pme-agent/src/queue/pme.processor.ts` (line 73)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `handleGenerate` | `handleGenerate(job: Job<PmeJobPayload>)` | `Promise<RunResult>` |
| `handleStrategy` | `handleStrategy(job: Job<PmeJobPayload>)` | `Promise<void>` |
| `handleFinalize` | `handleFinalize(job: Job<any>)` | `Promise<void>` |
| `handleSiteGen` | `handleSiteGen(job: Job<PmeJobPayload & { outputDir: string }>)` | `Promise<void>` |
| `onActive` | `onActive(job: Job<PmeJobPayload>)` | `void` |
| `onCompleted` | `onCompleted(job: Job<PmeJobPayload>)` | `void` |
| `onFailed` | `onFailed(job: Job<PmeJobPayload>, error: Error)` | `void` |

## Properties

| Property | Type |
|---|---|
| `progressEmitter` | `ProgressEmitter` |

<!-- source: graphql-query-post.md -->

# post

**Kind:** Graphql Query

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Get a post by ID

## Relationships

- TYPE_OF → `Post`

## Referenced By

- `Query` (CALLS_API)

<!-- source: component-previewshell.md -->

# PreviewShell

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/page.tsx` (line 357)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `url` | `string` | ✓ | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PreviewShell_be22912["PreviewShell"]
    class component_PreviewShell_be22912 rootComponent
```

## Referenced By

- `KbPanel` (RENDERS)
- `ManualPanel` (RENDERS)
- `ApiPanel` (RENDERS)
- `SupportPanel` (RENDERS)

<!-- source: service-prismaservice.md -->

# PrismaService

**Kind:** Service

**Source:** `atloria-monorepo/libs/database/src/lib/prisma.service.ts` (line 7)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleInit` | `onModuleInit()` | `unknown` |
| `onModuleDestroy` | `onModuleDestroy()` | `unknown` |
| `enableQueryLogging` | `enableQueryLogging()` | `unknown` |

## Relationships

- DEPENDS_ON → `configservice`

<!-- source: page-privacy.md -->

# privacy

**Kind:** Page

**Source:** `atloria-monorepo/templates/site-bootstrap/src/App.tsx`

<!-- source: type-progressemitter.md -->

# ProgressEmitter

**Kind:** Type

**Source:** `atloria-monorepo/apps/pme-agent/src/queue/pme.processor.ts` (line 71)

Progress callback for WebSocket emission (injected from outside).

## Definition

```ts
(event: PmeProgressEvent) => void
```

<!-- source: enum-relationtype.md -->

# RelationType

**Kind:** Enum

**Source:** `atloria-monorepo/apps/web/src/components/Graph/types.ts` (line 8)

Relationship types in the Knowledge Graph

## Values

- `CONTAINS`
- `USES`
- `CALLS`
- `REFERENCES`
- `IMPLEMENTS`
- `EXTENDS`
- `DEPENDS_ON`

<!-- source: enum-role.md -->

# Role

**Kind:** Enum

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

User roles

## Referenced By

- `User` (TYPE_OF)

<!-- source: class-startanalysisdto.md -->

# StartAnalysisDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/analysis/dto/start-analysis.dto.ts` (line 12)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `repoUrl` | `string` |
| `branch` | `string` |
| `folderPath` | `string` |
| `framework` | `Framework` |
| `patterns` | `string[]` |
| `modules` | `string[]` |
| `tokenBudget` | `number` |
| `organizationId` | `string` |
| `triggeredBy` | `string` |

<!-- source: service-storagehelperservice.md -->

# StorageHelperService

**Kind:** Service

**Source:** `atloria-monorepo/apps/cli/src/services/storage-helper.service.ts` (line 1)

<!-- source: system-overview.md -->

# Atloria (self dogfood)

## Overview

Auto-generated technical documentation for **Atloria (self dogfood)** — 30529 entities (24923 doc comments, 1520 interfaces, 785 functions, 782 components).

## Architecture

```mermaid
flowchart LR
  service_StorageHelperService_751da417["StorageHelperService"]
  service_Crop_140a6041["Crop"]
  service_ParserService_5634fec["ParserService"]
  service_EntityMapper_2dd3ba0b["EntityMapper"]
  service_ParserCoreBridge_5f634fe8["ParserCoreBridge"]
  service_ChunkerService_36d48187["ChunkerService"]
  service_FeatureExtractorService_54b31c9a["FeatureExtractorService"]
  service_AnalyzerService_509b5604["AnalyzerService"]
  service_SynthesizerService_5be315["SynthesizerService"]
  service_StructureService_335fa54b["StructureService"]
  service_V4dStructureService_1c78148e["V4dStructureService"]
  service_PhaseService_465e9705["PhaseService"]
  service_SessionService_22a97883["SessionService"]
  service_DocPlannerService_224fae1["DocPlannerService"]
  service_AgentContextService_36c11d80["AgentContextService"]
  service_AgentWriterService_58c6015c["AgentWriterService"]
  service_DocVerifierService_6b28454a["DocVerifierService"]
  service_GeneratorService_252aea01["GeneratorService"]
  service_VerifierAgentService_acd24ae["VerifierAgentService"]
  service_OpenAIReviewerService_36f27c12["OpenAIReviewerService"]
  service_VerifierService_3e00a087["VerifierService"]
  service_HybridMapperService_54fe3fb9["HybridMapperService"]
  service_LoginSelectorDetectorService_32760a58["LoginSelectorDetectorService"]
  service_ScreenshotCapturerService_6ed39a45["ScreenshotCapturerService"]
```

## Modules

- **ActivityModule**
- **AgentModule**
- **AIModule**
- **AnalyticsModule**
- **AppModule**
- **AssetsModule**
- **AudienceModule**
- **AuditModule**
- **AuthModule**
- **SamlModule**
- **BillingModule**
- **BitbucketModule**
- **BoardsModule**
- **BrandingModule**
- **CaptureModule**
- **CollaborationModule**
- **CommentModule**
- **ThrottlingModule**
- **DashboardModule**
- **DocVersionModule**
- **DocumentModule**
- **DraftDocumentModule**
- **DocumentationModule**
- **EmailModule**
- **EventsModule**
- **GatewayModule**
- **GitHubModule**
- **GithubAppModule**
- **GitLabModule**
- **GraphModule**
- **InvitationModule**
- **IssuesModule**
- **ManualsInsightsModule**
- **NotificationModule**
- **OpsModule**
- **OrganizationModule**
- **ParserModule**
- **ParsingModule**
- **PmeModule**
- **ProjectModule**
- **ScreenshotModule**
- **SuggestionModule**
- **SupportAgentModule**
- **TechnicalDocsModule**
- **TemplateModule**
- **TrialModule**
- **WebhookModule**
- **WorkflowModule**
- **AppModule**
- **AppModule**
- **AnalysisModule**
- **AppModule**
- **GitModule**
- **AppModule**
- **AppModule**
- **AppModule**
- **AppModule**
- **IntegrationModule**
- **KnowledgeGraphModule**
- **OrchestratorModule**
- **QueueModule**
- **UsersModule**
- **PmeAgentModule**
- **QueueModule**
- **AppModule**
- **DiscoveryModule**
- **PdfModule**
- **PlaywrightModule**
- **ScreenshotModule**
- **StorageModule**
- **DatabaseModule**
- **Atloria.CSharpParser** — .NET Exe project (C#)

## Entry Points

- Controller: **ActivityController** (`atloria-monorepo/apps/api/src/activity/activity.controller.ts`)
- Controller: **AgentController** (`atloria-monorepo/apps/api/src/agent/agent.controller.ts`)
- Controller: **AIController** (`atloria-monorepo/apps/api/src/ai/ai.controller.ts`)
- Controller: **AnalyticsController** (`atloria-monorepo/apps/api/src/analytics/analytics.controller.ts`)
- Controller: **AnalyticsExportController** (`atloria-monorepo/apps/api/src/analytics/export/analytics-export.controller.ts`)
- Controller: **AppController** (`atloria-monorepo/apps/api/src/app/app.controller.ts`)
- Controller: **AssetsController** (`atloria-monorepo/apps/api/src/assets/assets.controller.ts`)
- Controller: **AudienceController** (`atloria-monorepo/apps/api/src/audience/audience.controller.ts`)
- Controller: **AuditController** (`atloria-monorepo/apps/api/src/audit/audit.controller.ts`)
- Controller: **AuthController** (`atloria-monorepo/apps/api/src/auth/auth.controller.ts`)
- Controller: **SamlController** (`atloria-monorepo/apps/api/src/auth/saml/saml.controller.ts`)
- Controller: **BillingController** (`atloria-monorepo/apps/api/src/billing/billing.controller.ts`)
- Controller: **BitbucketController** (`atloria-monorepo/apps/api/src/bitbucket/bitbucket.controller.ts`)
- Controller: **BoardsController** (`atloria-monorepo/apps/api/src/boards/boards.controller.ts`)
- Controller: **BrandingController** (`atloria-monorepo/apps/api/src/branding/branding.controller.ts`)
- Controller: **CaptureController** (`atloria-monorepo/apps/api/src/capture/capture.controller.ts`)
- Controller: **PublicCaptureController** (`atloria-monorepo/apps/api/src/capture/public-capture.controller.ts`)
- Controller: **CommentController** (`atloria-monorepo/apps/api/src/comment/comment.controller.ts`)
- Controller: **DashboardController** (`atloria-monorepo/apps/api/src/dashboard/dashboard.controller.ts`)
- Controller: **DocVersionController** (`atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts`)
- `GET /activities` → list
- `GET /activities/documents/:id` → getDocumentActivities
- `GET /activities/projects/:id` → getProjectActivities
- `GET /activities/recent/projects` → getRecentProjects
- `GET /activities/recent/documents` → getRecentDocuments
- `GET /agent/status` → getStatus
- `POST /ai/enhance` → enhance
- `POST /ai/outline` → generateOutline
- `POST /ai/improve` → improve
- `POST /ai/summarize` → summarize
- `GET /ai/providers` → listProviders
- `POST /analytics/track` → track
- `GET /analytics/:projectId/overview` → getOverview
- `GET /analytics/:projectId/versions` → getVersionTraffic
- `GET /analytics/:projectId/documents` → getTopDocuments
- `GET /analytics/:projectId/search-queries` → getTopSearchQueries
- `GET /analytics/:projectId/daily-traffic` → getDailyTraffic
- `GET /analytics/:projectId/devices` → getDeviceBreakdown
- `GET /analytics/:projectId/sources` → getSourceBreakdown
- `GET /analytics/:projectId/geo` → getGeoBreakdown
- `GET /analytics/:projectId/zero-result-searches` → getZeroResultSearches
- `GET /analytics/:projectId/ghost-docs` → getGhostDocs
- `GET /analytics/:projectId/trending-docs` → getTrendingDocs
- `GET /analytics/:projectId/scroll-histogram` → getScrollHistogram
- `POST /analytics/feedback` → submitFeedback
- `GET /analytics/:projectId/feedback-summary` → getFeedbackSummary
- `POST /analytics/:projectId/export` → exportNow
- `GET /analytics/:projectId/reports` → listReports
- `POST /analytics/:projectId/reports` → createReport
- `PATCH /analytics/:projectId/reports/:id` → updateReport

## Key Components

_The most-referenced entities — start here._

- **Description** (doc comment) — referenced 15×
- **Example Input** (doc comment) — referenced 15×
- **Example Output** (doc comment) — referenced 15×
- **DEVELOPER_STANDARDS.md** (doc comment) — referenced 12×
- **User** (graphql type) — referenced 11×
- **Your Prompt:** (doc comment) — referenced 11×
- **MANDATORY READING** (doc comment) — referenced 11×
- **Your Mission** (doc comment) — referenced 11×
- **Technology Stack** (doc comment) — referenced 11×
- **Code Location** (doc comment) — referenced 11×

<!-- source: type-templatecategory.md -->

# TemplateCategory

**Kind:** Type

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 146)

## Definition

```ts
| 'general'
  | 'api'
  | 'user-guide'
  | 'tutorial'
  | 'reference'
```

<!-- source: graphql-type-user.md -->

# User

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

User account

`User` is a GraphQL object type representing a user account in the API, including identity fields (id, email, name), authorization context (`role`), and social/content relationships (profile, posts, followers/following). It serves as the central node for querying user-centric data and derived counts (`followerCount`, `followingCount`) in the graph.

## Diagram

```mermaid
graph LR
  User[User]
  Role[Role]
  Profile[Profile]
  Post[Post]
  Follow[Follow]

  User -->|role: Role!| Role
  User -->|profile: Profile| Profile
  User -->|posts: [Post!]!| Post
  User -->|followers: [Follow!]!| Follow
  User -->|following: [Follow!]!| Follow
  User -->|followerCount: Int!| followerCount[(Int)]
  User -->|followingCount: Int!| followingCount[(Int)]
```

## Usage

```ts
import { gql, GraphQLClient } from "graphql-request";

const client = new GraphQLClient(process.env.API_URL!, {
  headers: { authorization: `Bearer ${process.env.API_TOKEN}` },
});

const GetUserWithRelations = gql`
  query GetUserWithRelations($id: ID!) {
    user(id: $id) {
      id
      email
      name
      role
      profile {
        id
        bio
      }
      posts {
        id
        title
      }
      followerCount
      followingCount
    }
  }
`;

type GetUserWithRelationsResult = {
  user: {
    id: string;
    email: string;
    name: string;
    role: "ADMIN" | "USER" | string;
    profile: { id: string; bio?: string | null } | null;
    posts: Array<{ id: string; title: string }>;
    followerCount: number;
    followingCount: number;
  } | null;
};

async function fetchUser(id: string) {
  const data = await client.request<GetUserWithRelationsResult>(GetUserWithRelations, { id });
  return data.user;
}

// Example call
fetchUser("user_123").then(console.log).catch(console.error);
```

## AI Coding Instructions

- Treat `User` as the hub type: keep resolver logic for `posts`, `profile`, `followers`, and `following` consistent with the underlying data model (IDs, join tables, pagination if applicable).
- Ensure `followerCount`/`followingCount` are derived efficiently (prefer aggregated queries over loading full `followers`/`following` lists just to count).
- Respect nullability: `profile` can be `null`, but list fields like `posts` are non-null lists of non-null items (`[Post!]!`) and should always resolve to an array.
- Avoid leaking sensitive fields: `email` is non-nullable, so enforce authorization checks in the `User` query resolver if email visibility is restricted.
- Keep `role` aligned with the `Role` enum values; validate and migrate consistently when adding new roles.

## Relationships

- TYPE_OF → `Role`
- TYPE_OF → `Profile`
- TYPE_OF → `Post`
- TYPE_OF → `Follow`
- TYPE_OF → `Follow`
- TYPE_OF → `DateTime`
- TYPE_OF → `DateTime`

## Referenced By

- `user` (TYPE_OF)
- `searchUsers` (TYPE_OF)
- `createUser` (TYPE_OF)
- `updateUser` (TYPE_OF)
- `Post` (TYPE_OF)
- `Comment` (TYPE_OF)
- `Like` (TYPE_OF)
- `Follow` (TYPE_OF)
- `Follow` (TYPE_OF)
- `UserConnection` (TYPE_OF)
- `AuthPayload` (TYPE_OF)

<!-- source: api-schema-user-management-api.md -->

# User Management API

**Kind:** API Schema

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

RESTful API for user management operations

## Relationships

- IMPLEMENTS_API → `getUsers`
- IMPLEMENTS_API → `createUser`
- IMPLEMENTS_API → `getUserById`
- IMPLEMENTS_API → `updateUser`
- IMPLEMENTS_API → `deleteUser`
- IMPLEMENTS_API → `login`
- TYPE_OF → `User`
- TYPE_OF → `UserWithProfile`
- TYPE_OF → `Profile`
- TYPE_OF → `CreateUser`
- TYPE_OF → `UpdateUser`
- TYPE_OF → `LoginRequest`
- TYPE_OF → `AuthResponse`
- TYPE_OF → `Error`

<!-- source: function-createcodeblocknode.md -->

# $createCodeBlockNode

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/CodeBlockNode.tsx` (line 275)

## Signature

```ts
function $createCodeBlockNode(options: Partial<CreateCodeBlockNodeOptions>): CodeBlockNode
```

## Parameters

| Name | Type |
|---|---|
| `options` | `Partial<CreateCodeBlockNodeOptions>` |

**Returns:** `CodeBlockNode`

<!-- source: api-endpoint-accept-2.md -->

# accept

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/suggestion/suggestion.controller.ts` (line 29)

## Endpoint

`POST /documents/:documentId/suggestions/:id/accept`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `SuggestionController` (MODULE_DECLARES)

<!-- source: interface-accessibilityviolation.md -->

# AccessibilityViolation

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/accessibility.ts` (line 12)

Accessibility violation

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `description` | `string` |
| `help` | `string` |
| `helpUrl` | `string` |
| `impact` | `'minor' | 'moderate' | 'serious' | 'critical'` |
| `nodes` | `{
    html: string;
    target: string[];
    failureSummary?: string;
  }[]` |

<!-- source: interface-accuracyreport.md -->

# AccuracyReport

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-11.types.ts` (line 28)

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `title` | `string` |
| `accuracyScore` | `number` |
| `claims` | `{
    total: number;
    verified: number;
    flagged: number;
    uncertain: number;
  }` |
| `issues` | `VerificationIssue[]` |
| `passesThreshold` | `boolean` |
| `requiredActions` | `string[]` |

<!-- source: constant-activeeditor.md -->

# activeEditor$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 129)

Holds a reference to the current Lexical editor instance - can be the root editor or a nested editor.

<!-- source: class-activityfiltersdto.md -->

# ActivityFiltersDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/activity/dto/activity-filters.dto.ts` (line 3)

## Properties

| Property | Type |
|---|---|
| `organizationId` | `string` |
| `projectId` | `string` |
| `userId` | `string` |
| `entityType` | `string` |
| `entityId` | `string` |
| `startDate` | `string` |
| `endDate` | `string` |

<!-- source: service-agentadapterservice.md -->

# AgentAdapterService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/support-agent/agent-adapter.service.ts` (line 40)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `execute` | `execute(message: string, executionConfig: AgentExecutionConfig)` | `Promise<AgentExecutionResult>` |
| `executeStream` | `executeStream(message: string, executionConfig: AgentExecutionConfig)` | `AsyncGenerator<string, void, unknown>` |

## Relationships

- DEPENDS_ON → `configservice`
- DEPENDS_ON → `prismaservice`

<!-- source: controller-agentanalyticscontroller.md -->

# AgentAnalyticsController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/events/agent-analytics.controller.ts` (line 12)

Agent-native analytics — "who/what AI is reading your docs". Authed, org-scoped
read model over the agent_read events the public agent surfaces record. Guard/scope
pattern mirrors ManualsInsightsController.

## Relationships

- MODULE_DECLARES → `traffic`
- DEPENDS_ON → `agentanalyticsservice`

<!-- source: interface-agentconfig.md -->

# AgentConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 14)

Agent Core Runtime Types

Our interfaces for agent configuration, tool definitions, and run results.
These are the contracts that domain layers (PME, doc-automation, etc.) code against.
The SDK's types are mapped to these in agent-runtime.ts — if the SDK changes,
only that file needs updating.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `instructions` | `string | ((context: RunContext<TContext>) => string | Promise<string>)` |
| `model` | `string` |
| `modelSettings` | `AgentModelSettings` |
| `tools` | `ToolDefinition<TContext>[]` |
| `handoffs` | `AgentConfig<TContext>[]` |
| `handoffDescription` | `string` |
| `inputGuardrails` | `GuardrailDefinition[]` |
| `outputGuardrails` | `OutputGuardrailDefinition[]` |
| `outputType` | `'text' | JsonSchemaOutput` |
| `maxTurns` | `number` |

<!-- source: interface-agentendedevent.md -->

# AgentEndedEvent

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/agent/agent.types.ts` (line 151)

## Properties

| Property | Type |
|---|---|
| `totalUsage` | `{
    inputTokens: number;
    outputTokens: number;
    totalTokens: number;
  }` |
| `turnCount` | `number` |

<!-- source: type-agentfactory.md -->

# AgentFactory

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/tools/spawn-agent.tool.ts` (line 33)

Factory function that creates sub-agent configs on demand.
Domain layers implement this to control what instructions, model,
and tools sub-agents receive.

The `model` in options is already resolved by the router — factory
should use it as-is when provided.

## Definition

```ts
(
  name: string,
  task: string,
  tools?: string[],
  options?: { rootDir?: string; model?: string },
) => import('../runtime/types').AgentConfig<TContext>
```

<!-- source: module-agentmodule.md -->

# AgentModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/agent/agent.module.ts` (line 6)

## Relationships

- MODULE_DECLARES → `agentcontroller`
- MODULE_PROVIDES → `agentservice`
- MODULE_PROVIDES → `agentgateway`
- MODULE_EXPORTS → `agentservice`
- MODULE_EXPORTS → `agentgateway`

<!-- source: class-agentruntime.md -->

# AgentRuntime

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/agent-runtime.ts` (line 45)

AgentRuntime — the SDK-based agent loop implementation.
Wraps

**Implements:** `IAgentLoop`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `run` | `run(config: AgentConfig<TContext>, input: string, options: RunOptions<TContext>)` | `Promise<RunResult>` |
| `runStreamed` | `runStreamed(config: AgentConfig<TContext>, input: string | AgentInputItem[], options: RunOptions<TContext>)` | `Promise<StreamedRunHandle>` |

<!-- source: service-agentwriterservice.md -->

# AgentWriterService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/agent-writer.service.ts` (line 1)

<!-- source: interface-aiprovidersresponse.md -->

# AIProvidersResponse

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/types/ai.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `providers` | `AIProvider[]` |
| `default` | `AIProviderName` |

<!-- source: type-aiprovidertype.md -->

# AIProviderType

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/ai-provider.interface.ts` (line 98)

AI Provider type selection

## Definition

```ts
'claude' | 'openai' | 'azure-responses'
```

<!-- source: function-analyzeangulartemplate.md -->

# analyzeAngularTemplate

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/template-analyzer.ts` (line 599)

Analyze Angular template file

## Signature

```ts
function analyzeAngularTemplate(templateContent: string): TemplateAnalysis
```

## Parameters

| Name | Type |
|---|---|
| `templateContent` | `string` |

**Returns:** `TemplateAnalysis`

<!-- source: function-analyzeauthfailurewithai.md -->

# analyzeAuthFailureWithAI

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/utils/ai-auth-debugger.ts` (line 127)

Ask AI to analyze authentication failure and suggest fixes

## Signature

```ts
async function analyzeAuthFailureWithAI(diagnostics: AuthDiagnostics, config: AuthConfig, debugGuideContent: string): Promise<{
  analysis: string;
  suggestedFixes: Array<{
    type: 'alert-handling' | 'selector-change' | 'timing-adjustment' | 'method-change';
    description: string;
    code?: string;
  }>;
}>
```

## Parameters

| Name | Type |
|---|---|
| `diagnostics` | `AuthDiagnostics` |
| `config` | `AuthConfig` |
| `debugGuideContent` | `string` |

**Returns:** `Promise<{
  analysis: string;
  suggestedFixes: Array<{
    type: 'alert-handling' | 'selector-change' | 'timing-adjustment' | 'method-change';
    description: string;
    code?: string;
  }>;
}>`

<!-- source: class-angulardetector.md -->

# AngularDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/angular-detector.ts` (line 77)

Angular Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectComponents` | `detectComponents(entities: Entity[])` | `DetectedAngularComponent[]` |
| `detectServices` | `detectServices(entities: Entity[])` | `DetectedAngularService[]` |
| `getComponentSummary` | `getComponentSummary(component: DetectedAngularComponent)` | `string` |

<!-- source: service-annotationemitterservice.md -->

# AnnotationEmitterService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/annotation-emitter.service.ts` (line 59)

TS port of the atlorix Python annotation producer
(tools/capture_annotations.py + tools/emit_annotations.py).

Locates a step's target element on the LIVE page, converts it to percent-of-
natural-image coordinates, and builds the non-destructive overlay payload +
the `#atloria-annotations=` URL fragment the web viewer consumes. Coordinates
only — the screenshot pixels are never touched (moat intact).

## Methods

| Method | Signature | Returns |
|---|---|---|
| `recomputeTargetBoxPct` | `recomputeTargetBoxPct(page: Page, selector: string, opts: { fullPage: boolean })` | `Promise<BoxPct | null>` |
| `buildStepAnnotations` | `buildStepAnnotations(boxPct: BoxPct, stepIndex: number)` | `Annotation[]` |
| `toFragment` | `toFragment(annotations: Annotation[])` | `string` |

<!-- source: constant-apidocumentationtemplate.md -->

# apiDocumentationTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/api-documentation.template.ts` (line 3)

<!-- source: interface-apiendpointentity-2.md -->

# APIEndpointEntity

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 536)

API Endpoint entity

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.API_ENDPOINT` |
| `method` | `'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD'` |
| `path` | `string` |
| `pathParams` | `ParameterDefinition[]` |
| `queryParams` | `ParameterDefinition[]` |
| `requestBody` | `SchemaDefinition` |
| `responses` | `ResponseDefinition[]` |
| `authentication` | `AuthenticationInfo` |
| `rateLimit` | `RateLimitInfo` |
| `middleware` | `string[]` |
| `controller` | `string` |
| `operationId` | `string` |

<!-- source: interface-apiflow.md -->

# APIFlow

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/relationship.interface.ts` (line 391)

API flow showing component → API → service → model chain

## Properties

| Property | Type |
|---|---|
| `endpoint` | `{
    id: string;
    name: string;
    path: string;
    method: string;
  }` |
| `callers` | `Array<{
    id: string;
    name: string;
    type: string;
    filePath: string;
  }>` |
| `services` | `Array<{
    id: string;
    name: string;
    filePath: string;
  }>` |
| `models` | `Array<{
    id: string;
    name: string;
    tableName: string;
  }>` |
| `relationships` | `Relationship[]` |

<!-- source: class-apiprovider.md -->

# ApiProvider

**Kind:** Class

**Source:** `atloria-monorepo/apps/cli/src/providers/api.provider.ts` (line 54)

API data provider
Fetches from Atloria REST API

**Implements:** `DataProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: DataProviderConfig)` | `Promise<void>` |
| `getProjectMetadata` | `getProjectMetadata()` | `Promise<ProjectMetadata>` |
| `getEntities` | `getEntities()` | `Promise<Entity[]>` |
| `getEntitiesByType` | `getEntitiesByType(type: string)` | `Promise<Entity[]>` |
| `getEntityById` | `getEntityById(id: string)` | `Promise<Entity | null>` |
| `getRelationships` | `getRelationships()` | `Promise<Relationship[]>` |
| `getRelationshipsForEntity` | `getRelationshipsForEntity(entityId: string)` | `Promise<Relationship[]>` |
| `saveParseResults` | `saveParseResults(results: ParseResult[], project: DetectedProject, workflowSignals: WorkflowSignals, workflowOptions: {
      enableAiWorkflows?: boolean;
      aiModel?: string;
      forceWorkflowDiscovery?: boolean;
    }, businessContextText: string)` | `Promise<void>` |
| `saveDocumentation` | `saveDocumentation(pages: Array<{
      slug: string;
      title: string;
      description: string;
      type: string;
      content: string;
      order: number;
      parentSlug?: string;
      entityId?: string;
    }>, _navigation: Array<{
      title: string;
      href: string;
      children?: Array<{ title: string; href: string }>;
    }>)` | `Promise<void>` |
| `destroy` | `destroy()` | `Promise<void>` |

<!-- source: controller-appcontroller-4.md -->

# AppController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/app.controller.ts` (line 4)

## Relationships

- MODULE_DECLARES → `getHealth`
- MODULE_DECLARES → `getInfo`
- DEPENDS_ON → `appservice`

<!-- source: function-applycardmove.md -->

# applyCardMove

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 154)

Apply a card move to local board state for optimistic UI.
Returns a NEW board object — does not mutate.

## Signature

```ts
function applyCardMove(board: BoardData, cardId: string, toColumnId: string, position: number): BoardData
```

## Parameters

| Name | Type |
|---|---|
| `board` | `BoardData` |
| `cardId` | `string` |
| `toColumnId` | `string` |
| `position` | `number` |

**Returns:** `BoardData`

<!-- source: function-applyhunks.md -->

# applyHunks

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/edit-file.tool.ts` (line 625)

Apply parsed hunks to file content with fuzzy line offset matching.
Hunks are applied in reverse order (bottom-to-top) to preserve line numbers.

## Signature

```ts
function applyHunks(content: string, hunks: DiffHunk[], fuzzLines): { success: boolean; content?: string; error?: string; lastNewText?: string }
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |
| `hunks` | `DiffHunk[]` |
| `fuzzLines` | `any` |

**Returns:** `{ success: boolean; content?: string; error?: string; lastNewText?: string }`

<!-- source: module-appmodule-6.md -->

# AppModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/app.module.ts` (line 9)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `gitmodule`
- MODULE_IMPORTS → `analysismodule`
- MODULE_DECLARES → `appcontroller`
- MODULE_PROVIDES → `appservice`

<!-- source: service-appservice-4.md -->

# AppService

**Kind:** Service

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/app.service.ts` (line 4)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getHealth` | `getHealth()` | `unknown` |
| `getInfo` | `getInfo()` | `unknown` |

## Relationships

- DEPENDS_ON → `gitservice`

<!-- source: function-areparsersinitialized.md -->

# areParsersInitialized

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/queue/processors/parser-registry.ts` (line 165)

Check if parsers are initialized

## Signature

```ts
function areParsersInitialized(): boolean
```

**Returns:** `boolean`

<!-- source: type-askfn.md -->

# AskFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/mcp-toolset.ts` (line 34)

Optional grounded-QA backend (LLM). Injected so the toolset stays pure/testable.

## Definition

```ts
(question: string, context: DocSearchHit[]) => Promise<{ answer: string; citations: string[] }>
```

<!-- source: interface-assemblerdeps.md -->

# AssemblerDeps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/assembler.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `templateDir` | `string` |
| `componentLibraryDir` | `string` |

<!-- source: function-assertperformancemetrics.md -->

# assertPerformanceMetrics

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/performance.ts` (line 126)

Assert performance metrics meet thresholds

## Signature

```ts
async function assertPerformanceMetrics(page: Page, thresholds: Partial<{
    ttfb: number;
    fcp: number;
    lcp: number;
    cls: number;
    domContentLoaded: number;
    load: number;
    resourceCount: number;
    totalSize: number;
    domNodes: number;
  }>): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |
| `thresholds` | `Partial<{
    ttfb: number;
    fcp: number;
    lcp: number;
    cls: number;
    domContentLoaded: number;
    load: number;
    resourceCount: number;
    totalSize: number;
    domNodes: number;
  }>` |

**Returns:** `Promise<void>`

<!-- source: function-assertpublichttpurl.md -->

# assertPublicHttpUrl

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/ssrf.ts` (line 26)

Validate that a URL is http(s) and does not point at a private address
(by hostname pattern or DNS resolution). Throws BadRequestException.

## Signature

```ts
async function assertPublicHttpUrl(rawUrl: string): Promise<URL>
```

## Parameters

| Name | Type |
|---|---|
| `rawUrl` | `string` |

**Returns:** `Promise<URL>`

<!-- source: class-atloriawebsocketclient.md -->

# AtloriaWebSocketClient

**Kind:** Class

**Source:** `atloria-monorepo/apps/web/src/lib/websocket-client.ts` (line 30)

AtloriaWebSocketClient

Manages WebSocket connections for real-time updates.
Supports multiple namespaces (comments, documents) and channel subscriptions.

**Implements:** `WebSocketClient`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `setToken` | `setToken(token: string | null)` | `void` |
| `joinDocument` | `joinDocument(documentId: string, namespace: NamespaceType)` | `void` |
| `leaveDocument` | `leaveDocument(documentId: string, namespace: NamespaceType)` | `void` |
| `subscribe` | `subscribe(channel: string, handler: SubscriptionHandler)` | `() => void` |
| `on` | `on(event: string, handler: SubscriptionHandler)` | `void` |
| `off` | `off(event: string, handler: SubscriptionHandler)` | `void` |
| `emit` | `emit(event: string, data: any)` | `void` |
| `disconnect` | `disconnect()` | `void` |
| `isConnected` | `isConnected()` | `boolean` |

<!-- source: interface-authconfig.md -->

# AuthConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/utils/ai-auth-debugger.ts` (line 12)

## Properties

| Property | Type |
|---|---|
| `loginUrl` | `string` |
| `credentials` | `{
    usernameSelector: string;
    passwordSelector: string;
    submitSelector: string;
    username: string;
    password: string;
  }` |
| `waitAfterLogin` | `number` |
| `testUrl` | `string` |

<!-- source: interface-authenticatedscreenshotoptions.md -->

# AuthenticatedScreenshotOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/playwright/playwright.service.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `targetUrl` | `string` |
| `loginUrl` | `string` |
| `username` | `string` |
| `password` | `string` |
| `usernameSelector` | `string` |
| `passwordSelector` | `string` |
| `submitSelector` | `string` |
| `successSelector` | `string` |
| `browserType` | `BrowserType` |
| `viewport` | `{
    width: number;
    height: number;
  }` |
| `fullPage` | `boolean` |
| `waitForSelector` | `string` |
| `waitForTimeout` | `number` |

<!-- source: constant-authoptions.md -->

# authOptions

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/lib/auth.ts` (line 93)

NextAuth configuration

## Definition

```ts
NextAuthOptions
```

<!-- source: component-backdrop.md -->

# Backdrop

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/DeskDialogs.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onClose` | `Function` | ✓ | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Backdrop_3d5e3532["Backdrop"]
    class component_Backdrop_3d5e3532 rootComponent
```

## Referenced By

- `SnoozeMenu` (RENDERS)
- `DuplicateDialog` (RENDERS)
- `ShortcutOverlay` (RENDERS)

<!-- source: class-batchconfigdto.md -->

# BatchConfigDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 555)

Batch configuration DTO

Controls batch-level settings:
- Concurrency and parallelism
- Browser selection
- Retry behavior
- Screenshot format and quality
- Deduplication

## Properties

| Property | Type |
|---|---|
| `maxConcurrency` | `number` |
| `browser` | `Browser` |
| `maxRetries` | `number` |
| `retryDelayMs` | `number` |
| `screenshotTimeout` | `number` |
| `defaultViewport` | `ViewportDto` |
| `format` | `Format` |
| `quality` | `number` |
| `checkDuplicates` | `boolean` |

<!-- source: controller-batchscreenshotcontroller.md -->

# BatchScreenshotController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/batch-screenshot.controller.ts` (line 41)

Controller for batch screenshot operations

Endpoints:
- POST /screenshot/batch - Create and start a batch job
- GET /screenshot/batch/:jobId/status - Get job status and results
- POST /screenshot/validate-selectors - Validate selectors exist on a page

`BatchScreenshotController` exposes HTTP endpoints for creating and running screenshot batch jobs, querying their status/results, and validating CSS/XPath selectors against a target page. It acts as the API boundary for the screenshot-worker service, delegating orchestration to underlying services/queues and returning job progress and artifacts to callers.

## Diagram

```mermaid
graph LR
  Client[Client / API Consumer] -->|POST /screenshot/batch| C[BatchScreenshotController]
  Client -->|GET /screenshot/batch/:jobId/status| C
  Client -->|POST /screenshot/validate-selectors| C

  C --> S[Batch Screenshot Service]
  S --> Q[(Job Queue / Worker)]
  Q --> W[Browser Runner (Playwright/Puppeteer)]
  W --> R[(Storage: screenshots & metadata)]
  S --> R
  C -->|status/results| Client
```

## Usage

```ts
// Example: calling the controller endpoints from a Node client (e.g., another service)
import axios from "axios";

const baseURL = process.env.SCREENSHOT_WORKER_URL ?? "http://localhost:3000";

async function runBatch() {
  // 1) Create/start a batch screenshot job
  const createRes = await axios.post(`${baseURL}/screenshot/batch`, {
    // Shape depends on your DTOs; adjust to match your API contract.
    pages: [
      { url: "https://example.com", selectors: ["header", "#main"] },
      { url: "https://example.com/about", selectors: ["h1", ".content"] },
    ],
    viewport: { width: 1280, height: 720 },
    fullPage: true,
  });

  const jobId: string = createRes.data.jobId;
  console.log("Created job:", jobId);

  // 2) Poll for job status/results
  while (true) {
    const statusRes = await axios.get(
      `${baseURL}/screenshot/batch/${encodeURIComponent(jobId)}/status`,
    );

    const { status, progress, results, error } = statusRes.data;
    console.log({ status, progress });

    if (status === "completed") {
      // results commonly include screenshot URLs/paths and per-page metadata
      console.log("Batch results:", results);
      break;
    }

    if (status === "failed") {
      throw new Error(error ?? "Batch screenshot job failed");
    }

    await new Promise((r) => setTimeout(r, 1000));
  }
}

async function validateSelectors() {
  const res = await axios.post(`${baseURL}/screenshot/validate-selectors`, {
    url: "https://example.com",
    selectors: ["#main", ".does-not-exist"],
  });

  // Example response: { valid: ["#main"], invalid: [".does-not-exist"] }
  console.log("Selector validation:", res.data);
}

runBatch()
  .then(validateSelectors)
  .catch((e) => {
    console.error(e);
    process.exit(1);
  });
```

## AI Coding Instructions

- Keep controller methods thin: perform input validation/DTO parsing and delegate orchestration to a service/queue layer; avoid embedding browser/screenshot logic in the controller.
- Preserve idempotency and clarity for `GET /screenshot/batch/:jobId/status`: never mutate job state on reads; return a stable schema for `status`, `progress`, and `results`.
- Normalize and validate all external inputs (URLs, selectors, viewport/fullPage flags) to prevent SSRF-like issues and to avoid expensive browser launches for obviously invalid requests.
- Treat job IDs as opaque: always `encodeURIComponent` in routing/clients and avoid assumptions about format when adding logging or storage keys.
- When adding new endpoints, align with existing NestJS patterns (DTOs, validation pipes, consistent HTTP status codes) and ensure integration points (queue, storage, runner) are injected and testable.

## Relationships

- MODULE_DECLARES → `createBatchJob`
- MODULE_DECLARES → `createFlowJob`
- MODULE_DECLARES → `reshootFlowStep`
- MODULE_DECLARES → `reshootFlowLocales`
- MODULE_DECLARES → `getJobStatus`
- MODULE_DECLARES → `getPageHtml`
- MODULE_DECLARES → `validateSelectors`
- DEPENDS_ON → `batchscreenshotservice`
- DEPENDS_ON → `flowreplayservice`
- DEPENDS_ON → `playwrightservice`

<!-- source: type-billingplankey.md -->

# BillingPlanKey

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/billing/billing.constants.ts` (line 31)

## Definition

```ts
'pro' | 'business'
```

<!-- source: interface-brandvoiceconfig.md -->

# BrandVoiceConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/brand-voice.guardrail.ts` (line 42)

## Properties

| Property | Type |
|---|---|
| `brandVoice` | `string` |
| `additionalBannedTerms` | `string[]` |
| `allowSuperlatives` | `boolean` |

<!-- source: type-browser.md -->

# Browser

**Kind:** Type

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 540)

## Definition

```ts
typeof BROWSERS[number]
```

<!-- source: constant-browsers.md -->

# BROWSERS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 539)

<!-- source: type-bucketkey.md -->

# BucketKey

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 85)

## Definition

```ts
| 'triage'
  | 'needs_first'
  | 'needs_next'
  | 'investigating'
  | 'waiting'
  | 'paused'
  | 'done'
  | 'mine'
  | 'unassigned'
```

<!-- source: function-buildcoordinatorsystemprompt.md -->

# buildCoordinatorSystemPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/coordinator.prompts.ts` (line 21)

## Signature

```ts
function buildCoordinatorSystemPrompt(config: GenerationConfig): string
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |

**Returns:** `string`

<!-- source: function-buildsitegensystemprompt.md -->

# buildSiteGenSystemPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/agents/site-gen.prompts.ts` (line 16)

## Signature

```ts
function buildSiteGenSystemPrompt(config: SiteGenPromptConfig): string
```

## Parameters

| Name | Type |
|---|---|
| `config` | `SiteGenPromptConfig` |

**Returns:** `string`

<!-- source: function-burnredactions.md -->

# burnRedactions

**Kind:** Function

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/crop.service.ts` (line 72)

Burn opaque BLACK rectangles into an image, destroying the underlying pixels.

Boxes are percent (0-100) of the natural image; each is converted to a clamped
pixel rect and composited as a filled black overlay. Unlike an annotation
overlay (coordinates on a URL fragment), this is DESTRUCTIVE by design — a
redacted region can never be recovered from the stored asset. Degenerate boxes
(sub-pixel or off-canvas) are skipped. No boxes → the original buffer is returned
untouched (no re-encode).

## Signature

```ts
async function burnRedactions(buffer: Buffer, boxes: BoxPct[], imgW: number, imgH: number): Promise<Buffer>
```

## Parameters

| Name | Type |
|---|---|
| `buffer` | `Buffer` |
| `boxes` | `BoxPct[]` |
| `imgW` | `number` |
| `imgH` | `number` |

**Returns:** `Promise<Buffer>`

<!-- source: enum-changetype.md -->

# ChangeType

**Kind:** Enum

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/version-diff.ts` (line 13)

Change type

## Values

- `Added`
- `Removed`
- `Modified`

<!-- source: interface-cloneresult-2.md -->

# CloneResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/git/git.service.ts` (line 17)

## Properties

| Property | Type |
|---|---|
| `clonePath` | `string` |
| `targetPath` | `string` |
| `repoUrl` | `string` |
| `branch` | `string` |
| `folderPath` | `string` |

<!-- source: class-cloudstorageprovider.md -->

# CloudStorageProvider

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/storage/cloud-storage.provider.ts` (line 26)

Cloud storage provider implementation

**Implements:** `IStorageProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getMode` | `getMode()` | `StorageMode` |
| `saveScreenshot` | `saveScreenshot(buffer: Buffer, metadata: ScreenshotMetadata)` | `Promise<ScreenshotSaveResult>` |
| `findExistingScreenshot` | `findExistingScreenshot(metadata: Partial<ScreenshotMetadata>)` | `Promise<ScreenshotSaveResult | null>` |
| `saveDocument` | `saveDocument(document: DocumentMetadata)` | `Promise<DocumentSaveResult>` |
| `documentExists` | `documentExists(projectId: string, categoryPath: string[], slug: string)` | `Promise<boolean>` |
| `listDocuments` | `listDocuments(projectId: string, categoryPath: string[])` | `Promise<Array<{ id: string; title: string; slug: string; url: string }>>` |

<!-- source: class-collaborationpage.md -->

# CollaborationPage

**Kind:** Class

**Source:** `atloria-monorepo/apps/web-e2e/src/pages/collaboration.page.ts` (line 7)

Collaboration feature page object

**Extends:** `BasePage`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `goto` | `goto()` | `Promise<void>` |
| `getUserCursors` | `getUserCursors()` | `Locator` |
| `getCursorCount` | `getCursorCount()` | `Promise<number>` |
| `getPresenceIndicators` | `getPresenceIndicators()` | `Locator` |
| `getCollaboratorCount` | `getCollaboratorCount()` | `Promise<number>` |
| `getConnectionStatus` | `getConnectionStatus()` | `Promise<'connected' | 'connecting' | 'disconnected'>` |
| `waitForConnection` | `waitForConnection()` | `Promise<void>` |
| `getUserByName` | `getUserByName(name: string)` | `Locator` |
| `isUserPresent` | `isUserPresent(name: string)` | `Promise<boolean>` |
| `openShareDialog` | `openShareDialog()` | `Promise<void>` |
| `getCursorPosition` | `getCursorPosition(userName: string)` | `Promise<{ x: number; y: number } | null>` |
| `getCollaboratorColor` | `getCollaboratorColor(userName: string)` | `Promise<string | null>` |
| `isStatusBarVisible` | `isStatusBarVisible()` | `Promise<boolean>` |
| `getStatusBarText` | `getStatusBarText()` | `Promise<string>` |
| `simulateDisconnection` | `simulateDisconnection()` | `Promise<void>` |
| `waitForReconnection` | `waitForReconnection()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `statusBar` | `Locator` |
| `userCursors` | `Locator` |
| `presenceIndicators` | `Locator` |
| `connectionStatus` | `Locator` |
| `userList` | `Locator` |
| `shareButton` | `Locator` |

<!-- source: constant-compaction-summary-schema.md -->

# COMPACTION_SUMMARY_SCHEMA

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/context/compaction-types.ts` (line 165)

JSON Schema definition for CompactionSummary.
Passed to the model via `response_format: { type: 'json_schema', json_schema: ... }`
to guarantee structured output.

<!-- source: enum-comparetype.md -->

# CompareType

**Kind:** Enum

**Source:** `atloria-monorepo/apps/api/src/document/dto/compare-document.dto.ts` (line 4)

## Values

- `VERSION`
- `REVISION`

<!-- source: api-endpoint-create.md -->

# create

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/src/users/users.controller.ts` (line 49)

## Endpoint

`POST /users`

## Referenced By

- `UsersController` (MODULE_DECLARES)

<!-- source: api-endpoint-createflowjob.md -->

# createFlowJob

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/batch-screenshot.controller.ts` (line 123)

Create and start a flow-replay job (WS-A)

POST /api/screenshot/flow

Replays a recorded flow (start URL + ordered actions) in ONE browser context,
shooting a screenshot after each action. Returns immediately with a job ID;
poll GET /api/screenshot/batch/:jobId/status?organizationId=… — the status
payload carries a `flowSteps` array ({ flowStepId, blobUrl, annotationsFragment }).

`auth` is OPTIONAL — a PUBLIC startUrl needs none, which makes the endpoint
smoke-testable without customer credentials. `capturedBy` (a real user UUID)
IS required so the job and Screenshot rows satisfy their DB foreign keys.

## Endpoint

`POST /screenshot/flow`

## Referenced By

- `BatchScreenshotController` (MODULE_DECLARES)

<!-- source: graphql-mutation-createpost.md -->

# createPost

**Kind:** Graphql Mutation

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Create a new post

## Relationships

- TYPE_OF → `Post`
- TYPE_OF → `CreatePostInput`

## Referenced By

- `Mutation` (CALLS_API)

<!-- source: type-ctalayout.md -->

# CtaLayout

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 19)

## Definition

```ts
'banner' | 'split-form'
```

<!-- source: module-discoverymodule.md -->

# DiscoveryModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/discovery/discovery.module.ts` (line 7)

## Relationships

- MODULE_IMPORTS → `playwrightmodule`
- MODULE_DECLARES → `discoverycontroller`
- MODULE_PROVIDES → `discoveryservice`
- MODULE_PROVIDES → `pageprofilerservice`
- MODULE_EXPORTS → `discoveryservice`
- MODULE_EXPORTS → `pageprofilerservice`

<!-- source: enum-documentsource.md -->

# DocumentSource

**Kind:** Enum

**Source:** `atloria-monorepo/packages/types/src/enums/index.ts` (line 33)

Document source indicates how the document was created

## Values

- `AI`
- `PARSER`
- `USER`
- `FLOW`
- `API`

<!-- source: enum-entitytype.md -->

# EntityType

**Kind:** Enum

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 15)

Entity Interfaces

Defines all entity types discovered by parsers.
Entities represent code constructs like components, services, models, etc.

## Values

- `COMPONENT`
- `HOOK`
- `PAGE`
- `LAYOUT`
- `ROUTE`
- `CONTEXT`
- `PROVIDER`
- `STORE`
- `CONTROLLER`
- `SERVICE`
- `REPOSITORY`
- `MIDDLEWARE`
- `GUARD`
- `INTERCEPTOR`
- `PIPE`
- `MODULE`
- `EVENT_HANDLER`
- `JOB_PROCESSOR`
- `API_ENDPOINT`
- `GRAPHQL_QUERY`
- `GRAPHQL_MUTATION`
- `GRAPHQL_SUBSCRIPTION`
- `GRAPHQL_TYPE`
- `RPC_METHOD`
- `WEBSOCKET_ENDPOINT`
- `DATABASE_MODEL`
- `DATABASE_MIGRATION`
- `DATABASE_SEED`
- `DATABASE_VIEW`
- `DATABASE_PROCEDURE`
- `DOCKER_SERVICE`
- `K8S_DEPLOYMENT`
- `K8S_SERVICE`
- `K8S_CONFIGMAP`
- `TERRAFORM_RESOURCE`
- `CI_WORKFLOW`
- `MARKDOWN_DOC`
- `API_SCHEMA`
- `DOC_COMMENT`
- `ENV_VARIABLE`
- `CONFIG_FILE`
- `FEATURE_FLAG`
- `CLASS`
- `FUNCTION`
- `INTERFACE`
- `TYPE`
- `ENUM`
- `CONSTANT`
- `VARIABLE`
- `DECORATOR`

<!-- source: class-expressparser.md -->

# ExpressParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/backend-parser/src/parsers/express.parser.ts` (line 42)

Express Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: function-extractcomponentnamefrompath.md -->

# extractComponentNameFromPath

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 483)

Extract the component name from a file path

## Signature

```ts
function extractComponentNameFromPath(filePath: string): string
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |

**Returns:** `string`

<!-- source: type-fetchaudiencesfn.md -->

# FetchAudiencesFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/query-product-knowledge.tool.ts` (line 60)

Fetch target audiences defined for this project.

## Definition

```ts
(
  projectId: string,
) => Promise<ProductAudience[]>
```

<!-- source: constant-fixtures-path-2.md -->

# FIXTURES_PATH

**Kind:** Constant

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/setup.ts` (line 18)

<!-- source: function-generateentityid.md -->

# generateEntityId

**Kind:** Function

**Source:** `atloria-monorepo/apps/database-parser/src/utils/hash.util.ts` (line 19)

Generate a unique entity ID

## Signature

```ts
function generateEntityId(filePath: string, entityType: string, name: string): string
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |
| `entityType` | `string` |
| `name` | `string` |

**Returns:** `string`

<!-- source: api-endpoint-getinfo-2.md -->

# getInfo

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/app.controller.ts` (line 19)

Service info endpoint

## Endpoint

`GET /info`

## Referenced By

- `AppController` (MODULE_DECLARES)

<!-- source: api-endpoint-getparsers.md -->

# getParsers

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api-schema-parser/src/app.controller.ts` (line 29)

List supported parsers

## Endpoint

`GET /parsers`

## Referenced By

- `AppController` (MODULE_DECLARES)

<!-- source: class-grpcparser.md -->

# GrpcParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/api-schema-parser/src/parsers/grpc.parser.ts` (line 37)

gRPC Parser Implementation

Supports:
- Protocol Buffers syntax (proto2 and proto3)
- Services and RPCs
- Messages and nested types
- Enums
- Options and comments

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: interface-importinfo.md -->

# ImportInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 17)

Information about an import statement

## Properties

| Property | Type |
|---|---|
| `source` | `string` |
| `importType` | `'default' | 'named' | 'namespace' | 'side-effect'` |
| `imported` | `string` |
| `local` | `string` |

<!-- source: module-integrationmodule.md -->

# IntegrationModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/integration/integration.module.ts` (line 14)

## Relationships

- MODULE_PROVIDES → `integrationservice`
- MODULE_EXPORTS → `integrationservice`

<!-- source: class-jsonconfigparser.md -->

# JsonConfigParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/config-docs-parser/src/parsers/json-config.parser.ts` (line 63)

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: constant-key-tech-facts.md -->

# KEY_TECH_FACTS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/pme-agent/test/discovery/ground-truth.ts` (line 119)

Key tech stack facts the agent should mention (from READING dependency files)

<!-- source: service-kgsyncservice.md -->

# KGSyncService

**Kind:** Service

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/knowledge-graph/sync/kg-sync.service.ts` (line 23)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `sync` | `sync(parseResult: ParseResult)` | `Promise<SyncResult>` |
| `syncBatch` | `syncBatch(parseResults: ParseResult[])` | `Promise<SyncResult>` |
| `syncProject` | `syncProject(projectResult: ProjectParseResult)` | `Promise<SyncResult>` |
| `resyncProject` | `resyncProject(projectId: string, parseResults: ParseResult[])` | `Promise<SyncResult>` |
| `getSyncStatus` | `getSyncStatus(projectId: string)` | `Promise<{
    totalEntities: number;
    totalRelationships: number;
    lastSyncedAt?: Date;
  }>` |

## Relationships

- DEPENDS_ON → `knowledgegraphservice`

<!-- source: component-milestonecard.md -->

# MilestoneCard

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/social-proof/social-proof-timeline.tsx` (line 50)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `milestone` | `Milestone` | ✓ | - |
| `t` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_MilestoneCard_150ebeb1["MilestoneCard"]
    class component_MilestoneCard_150ebeb1 rootComponent
```

## Relationships

- RENDERS → `DateBadge`

## Referenced By

- `SocialProofTimeline` (RENDERS)

<!-- source: graphql-subscription-newfollower.md -->

# newFollower

**Kind:** Graphql Subscription

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Subscribe to new followers

## Relationships

- TYPE_OF → `Follow`

## Referenced By

- `Subscription` (CALLS_API)

<!-- source: class-nextjsparser.md -->

# NextjsParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/frontend-parser/src/parsers/nextjs.parser.ts` (line 53)

**Extends:** `ReactParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `supportedPatterns` | `string[]` |

<!-- source: class-parseprocessor.md -->

# ParseProcessor

**Kind:** Class

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/queue/processors/parse.processor.ts` (line 68)

**Implements:** `OnModuleInit`, `OnModuleDestroy`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleInit` | `onModuleInit()` | `Promise<void>` |
| `onModuleDestroy` | `onModuleDestroy()` | `Promise<void>` |
| `handleParse` | `handleParse(job: Job<ParseJobPayload>)` | `Promise<ParseResult[]>` |
| `onActive` | `onActive(job: Job<ParseJobPayload>)` | `void` |
| `onCompleted` | `onCompleted(job: Job<ParseJobPayload>, result: ParseResult[])` | `void` |
| `onFailed` | `onFailed(job: Job<ParseJobPayload>, error: Error)` | `void` |
| `onProgress` | `onProgress(job: Job<ParseJobPayload>, progress: number)` | `void` |

<!-- source: interface-parserregistryconfig.md -->

# ParserRegistryConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/config-docs-parser/src/services/parser-registry.service.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `enabledParsers` | `string[]` |
| `parserOptions` | `Record<string, unknown>` |

<!-- source: class-pmecompactionstrategy.md -->

# PmeCompactionStrategy

**Kind:** Class

**Source:** `atloria-monorepo/libs/pme-core/src/context/pme-compaction-strategy.ts` (line 31)

**Implements:** `CompactionStrategy`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `shouldPreserve` | `shouldPreserve(item: ContextItem)` | `boolean` |
| `summarize` | `summarize(items: ContextItem[])` | `string` |

<!-- source: graphql-type-post.md -->

# Post

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Blog post

`Post` is a GraphQL object type representing a blog post in the backend API, including its core content (`title`, `content`) and publication state (`published`, `publishedAt`). It acts as an aggregate root that links to related entities like `author`, `comments`, `likes`, and `tags`, while also exposing derived data such as `commentCount`. This type is typically returned by post-related queries and mutations and drives client rendering of post detail and list views.

## Diagram

```mermaid
graph LR
  Post[Post]
  User[User]
  Comment[Comment]
  Like[Like]
  Tag[Tag]

  Post -->|author: User!| User
  Post -->|comments: [Comment!]!| Comment
  Post -->|likes: [Like!]!| Like
  Post -->|tags: [Tag!]!| Tag

  Post -->|id: ID!| ID[(ID)]
  Post -->|title: String!| String[(String)]
  Post -->|content: String!| String2[(String)]
  Post -->|published: Boolean!| Bool[(Boolean)]
  Post -->|publishedAt: DateTime| DateTime[(DateTime)]
  Post -->|commentCount: Int!| Int[(Int)]
```

## Usage

```ts
// Example using graphql-request in a Next.js/NestJS-compatible setup.
import { GraphQLClient, gql } from "graphql-request";

const client = new GraphQLClient(process.env.API_URL!, {
  headers: {
    // e.g. Authorization: `Bearer ${token}`,
  },
});

const GET_POST = gql`
  query GetPost($id: ID!) {
    post(id: $id) {
      id
      title
      content
      published
      publishedAt
      commentCount
      author {
        id
        name
      }
      tags {
        id
        name
      }
      comments {
        id
        content
        author {
          id
          name
        }
      }
      likes {
        id
        user {
          id
          name
        }
      }
    }
  }
`;

type GetPostResult = {
  post: {
    id: string;
    title: string;
    content: string;
    published: boolean;
    publishedAt: string | null;
    commentCount: number;
    author: { id: string; name: string };
    tags: Array<{ id: string; name: string }>;
    comments: Array<{ id: string; content: string; author: { id: string; name: string } }>;
    likes: Array<{ id: string; user: { id: string; name: string } }>;
  };
};

export async function fetchPost(id: string) {
  const data = await client.request<GetPostResult>(GET_POST, { id });
  return data.post;
}

// Usage:
// const post = await fetchPost("post_123");
// console.log(post.title, post.commentCount);
```

## AI Coding Instructions

- Treat `Post` as an aggregate: keep `author`, `comments`, `likes`, and `tags` resolved consistently (avoid partial resolver behavior that returns `null` for non-nullable fields).
- Ensure `commentCount: Int!` stays in sync with `comments` (compute via DB aggregation where possible; avoid N+1 counting per post).
- Respect publication semantics: if `published` is `false`, `publishedAt` should typically be `null` (enforce in mutations and resolvers).
- When adding fields, keep GraphQL nullability intentional: only mark as non-null (`!`) if the resolver/data layer can guarantee it under all conditions.

## Relationships

- TYPE_OF → `DateTime`
- TYPE_OF → `User`
- TYPE_OF → `Comment`
- TYPE_OF → `Like`
- TYPE_OF → `Tag`
- TYPE_OF → `DateTime`
- TYPE_OF → `DateTime`

## Referenced By

- `post` (TYPE_OF)
- `createPost` (TYPE_OF)
- `updatePost` (TYPE_OF)
- `newPost` (TYPE_OF)
- `User` (TYPE_OF)
- `Comment` (TYPE_OF)
- `Like` (TYPE_OF)
- `Tag` (TYPE_OF)
- `PostConnection` (TYPE_OF)

<!-- source: graphql-query-posts.md -->

# posts

**Kind:** Graphql Query

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Get posts with filters

## Relationships

- TYPE_OF → `PostConnection`

## Referenced By

- `Query` (CALLS_API)

<!-- source: class-prismaparser.md -->

# PrismaParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/database-parser/src/parsers/prisma.parser.ts` (line 67)

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: component-profilepage.md -->

# ProfilePage

**Kind:** Component

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/frontend/src/pages/profile/[id].tsx` (line 21)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `initialUser` | `unknown` | - | - |

## Diagram

```mermaid
graph TD
    component_ProfilePage_560b332b["ProfilePage"]
    class component_ProfilePage_560b332b rootComponent
```

## Relationships

- RENDERS → `Layout`
- RENDERS → `Head`
- RENDERS → `UserProfile`
- USES_HOOK → `useRouter`

<!-- source: interface-projectinfo.md -->

# ProjectInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/pme-agent/test/discovery/ground-truth.ts` (line 12)

Ground Truth — Amlak Project

Known facts about the amlak repo that we score the agent's output against.
Built from manual inspection on 2026-03-22, updated with agent discoveries.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `path` | `string` |
| `tech` | `string` |
| `description` | `string` |
| `language` | `'typescript' | 'python' | 'mixed'` |

<!-- source: module-queuemodule-2.md -->

# QueueModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/pme-agent/src/queue/queue.module.ts` (line 6)

## Relationships

- MODULE_PROVIDES → `pmeprocessor`
- MODULE_EXPORTS → `bullmodule`

<!-- source: service-redisservice.md -->

# RedisService

**Kind:** Service

**Source:** `atloria-monorepo/libs/database/src/lib/redis.service.ts` (line 7)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleInit` | `onModuleInit()` | `unknown` |
| `onModuleDestroy` | `onModuleDestroy()` | `unknown` |
| `getClient` | `getClient()` | `Redis | null` |
| `isAvailable` | `isAvailable()` | `boolean` |
| `get` | `get(key: string)` | `Promise<string | null>` |
| `set` | `set(key: string, value: string, ttlSeconds: number)` | `Promise<void>` |
| `del` | `del(key: string)` | `Promise<void>` |
| `exists` | `exists(key: string)` | `Promise<boolean>` |
| `setJson` | `setJson(key: string, value: T, ttlSeconds: number)` | `Promise<void>` |
| `getJson` | `getJson(key: string)` | `Promise<T | null>` |
| `cached` | `cached(key: string, fetchFn: () => Promise<T>, ttlSeconds: unknown)` | `Promise<T>` |
| `invalidatePattern` | `invalidatePattern(pattern: string)` | `Promise<void>` |

## Relationships

- DEPENDS_ON → `configservice`

<!-- source: component-renderrecursivewrappers.md -->

# RenderRecursiveWrappers

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/MDXEditor.tsx` (line 179)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `wrappers` | `any` | ✓ | - |
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_RenderRecursiveWrappers_4c55724f["RenderRecursiveWrappers"]
    class component_RenderRecursiveWrappers_4c55724f rootComponent
```

## Relationships

- RENDERS → `Wrapper`
- RENDERS → `RenderRecursiveWrappers`

## Referenced By

- `RichTextEditor` (RENDERS)
- `RenderRecursiveWrappers` (RENDERS)

<!-- source: page-root.md -->

# Root

**Kind:** Page

**Source:** `atloria-monorepo/templates/site-bootstrap/src/App.tsx`

<!-- source: constant-superlatives-list.md -->

# SUPERLATIVES_LIST

**Kind:** Constant

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/brand-voice.guardrail.ts` (line 124)

Exported for testing — the list of superlatives the guardrail checks.

<!-- source: service-system-text-json.md -->

# System.Text.Json

**Kind:** Service

**Source:** `atloria-monorepo/libs/parser-core/src/dotnet-bridge/Atloria.CSharpParser/Atloria.CSharpParser.csproj` (line 1)

NuGet package dependency

## Referenced By

- `Atloria.CSharpParser` (DEPENDS_ON)

<!-- source: constant-test.md -->

# test

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web-e2e/src/fixtures/base.fixture.ts` (line 75)

Extended test with custom fixtures

<!-- source: type-testfixtures.md -->

# TestFixtures

**Kind:** Type

**Source:** `atloria-monorepo/apps/web-e2e/src/fixtures/base.fixture.ts` (line 25)

Extended test fixtures for Atloria E2E tests

## Definition

```ts
{
  /**
   * Authenticated page - user is logged in
   */
  authenticatedPage: Page;

  /**
   * Run accessibility checks on the page
   */
  checkAccessibility: (page: Page, options?: AccessibilityOptions) => Promise<void>;

  /**
   * Test user credentials
   */
  testUser: TestUser;

  /**
   * S…
```

<!-- source: type-user.md -->

# User

**Kind:** Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `email` | `string` |
| `name` | `string` |
| `role` | `string` |
| `createdAt` | `string` |

## Referenced By

- `createUser` (REFERENCES)
- `updateUser` (REFERENCES)
- `User Management API` (TYPE_OF)
- `UserWithProfile` (EXTENDS)
- `AuthResponse` (TYPE_OF)

<!-- source: controller-userscontroller.md -->

# UsersController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/src/users/users.controller.ts` (line 29)

## Relationships

- MODULE_DECLARES → `findAll`
- MODULE_DECLARES → `findOne`
- MODULE_DECLARES → `create`
- MODULE_DECLARES → `update`
- MODULE_DECLARES → `remove`
- MODULE_DECLARES → `getUserPosts`
- MODULE_DECLARES → `getFollowers`
- DEPENDS_ON → `usersservice`

<!-- source: function-createdirectivenode.md -->

# $createDirectiveNode

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/directives/DirectiveNode.tsx` (line 147)

## Signature

```ts
function $createDirectiveNode(mdastNode: Directives, key: NodeKey): DirectiveNode
```

## Parameters

| Name | Type |
|---|---|
| `mdastNode` | `Directives` |
| `key` | `NodeKey` |

**Returns:** `DirectiveNode`

<!-- source: api-endpoint-activate.md -->

# activate

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 160)

## Endpoint

`POST /doc-versions/:projectId/:versionId/activate`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: constant-activeeditorsubscriptions.md -->

# activeEditorSubscriptions$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 464)

<!-- source: class-addcardsdto.md -->

# AddCardsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/boards/dto/card.dto.ts` (line 3)

## Properties

| Property | Type |
|---|---|
| `issueIds` | `string[]` |
| `columnId` | `string` |

<!-- source: service-agentanalyticsservice.md -->

# AgentAnalyticsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/events/agent-analytics.service.ts` (line 28)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `agentTraffic` | `agentTraffic(projectId: string, organizationId: string, days: unknown)` | `Promise<AgentTraffic>` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: interface-agentcontextresult.md -->

# AgentContextResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/agent-context.service.ts` (line 36)

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `contextSummary` | `string` |
| `userWorkflow` | `string` |
| `uiElements` | `string[]` |
| `validations` | `string[]` |
| `errorStates` | `string[]` |
| `relatedFeatures` | `string[]` |

<!-- source: controller-agentcontroller.md -->

# AgentController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/agent/agent.controller.ts` (line 12)

## Relationships

- MODULE_DECLARES → `getStatus`
- DEPENDS_ON → `agentservice`

<!-- source: interface-agentdefinition.md -->

# AgentDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/plugins/plugin-types.ts` (line 62)

A sub-agent definition contributed by a plugin.

Each `.md` file in a plugin's `agents/` directory produces one
AgentDefinition.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `instructions` | `string` |
| `tools` | `string[]` |
| `model` | `string` |

<!-- source: interface-agenterrorevent.md -->

# AgentErrorEvent

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/agent/agent.types.ts` (line 139)

## Properties

| Property | Type |
|---|---|
| `message` | `string` |
| `recoverable` | `boolean` |

<!-- source: type-agentinputitem.md -->

# AgentInputItem

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 246)

Opaque SDK input item — domain layers pass these through without interpreting.
The actual type is determined by the underlying SDK.

## Definition

```ts
unknown
```

<!-- source: class-agentsession.md -->

# AgentSession

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/session/agent-session.ts` (line 80)

Interactive agent session.

Usage:
```typescript
const session = new AgentSession(runtime, agentConfig, { maxTurns: 30 });
session.on('tool_start', (e) => console.log(`Using ${e.toolName}...`));
session.on('agent_message', (e) => console.log(e.text));

const result = await session.send('Build a login page');
const result2 = await session.send('Add password validation');
```

**Extends:** `EventEmitter`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `on` | `on(event: K, listener: (data: SessionEventMap[K]) => void)` | `this` |
| `off` | `off(event: K, listener: (data: SessionEventMap[K]) => void)` | `this` |
| `emit` | `emit(event: K, data: SessionEventMap[K])` | `boolean` |
| `send` | `send(message: string)` | `Promise<RunResult>` |
| `inject` | `inject(message: string)` | `void` |
| `cancel` | `cancel()` | `void` |
| `getState` | `getState()` | `SessionState` |
| `getHistory` | `getHistory()` | `AgentHistoryItem[]` |
| `getUsage` | `getUsage()` | `TokenUsage` |
| `getSendCount` | `getSendCount()` | `number` |
| `getTurnCount` | `getTurnCount()` | `number` |
| `getSnapshot` | `getSnapshot()` | `{ conversationHistory: AgentHistoryItem[]; sdkHistory: unknown[] }` |
| `loadHistory` | `loadHistory(conversationHistory: AgentHistoryItem[], sdkHistory: unknown[])` | `void` |
| `end` | `end()` | `void` |
| `setVerbose` | `setVerbose(enabled: boolean)` | `void` |
| `isVerbose` | `isVerbose()` | `boolean` |
| `isPlanMode` | `isPlanMode()` | `boolean` |
| `getActiveModel` | `getActiveModel()` | `string | undefined` |
| `approvePlan` | `approvePlan(feedback: string)` | `Promise<RunResult>` |
| `revisePlan` | `revisePlan(feedback: string)` | `Promise<RunResult>` |
| `fork` | `fork(branchName: string)` | `AgentSession<TContext>` |

<!-- source: module-aimodule.md -->

# AIModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/ai/ai.module.ts` (line 20)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `configmodule`
- MODULE_DECLARES → `aicontroller`
- MODULE_PROVIDES → `aiservice`
- MODULE_PROVIDES → `aiusageservice`
- MODULE_PROVIDES → `azureclaudeprovider`
- MODULE_PROVIDES → `azureopenaiprovider`
- MODULE_PROVIDES → `ratelimitguard`
- MODULE_PROVIDES → `filecontextservice`
- MODULE_PROVIDES → `codeanalysisservice`
- MODULE_PROVIDES → `uianalyzerservice`
- MODULE_PROVIDES → `playwrightgeneratorservice`
- MODULE_PROVIDES → `businesscontextparserservice`
- MODULE_EXPORTS → `aiservice`
- MODULE_EXPORTS → `aiusageservice`
- MODULE_EXPORTS → `azureclaudeprovider`
- MODULE_EXPORTS → `azureopenaiprovider`
- MODULE_EXPORTS → `filecontextservice`
- MODULE_EXPORTS → `codeanalysisservice`
- MODULE_EXPORTS → `uianalyzerservice`
- MODULE_EXPORTS → `playwrightgeneratorservice`
- MODULE_EXPORTS → `businesscontextparserservice`

<!-- source: interface-airequestlog.md -->

# AIRequestLog

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/types/ai.ts` (line 42)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `timestamp` | `Date` |
| `provider` | `AIProviderName` |
| `operation` | `'enhance' | 'outline' | 'improve' | 'summarize' | 'complete'` |
| `status` | `'success' | 'error' | 'pending'` |
| `tokensUsed` | `number` |
| `duration` | `number` |
| `errorMessage` | `string` |

<!-- source: type-analyticsprovider.md -->

# AnalyticsProvider

**Kind:** Type

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/analytics.ts` (line 8)

Analytics Engine

Config-driven analytics — supports Azure Application Insights (default),
Google Analytics 4, and Meta Pixel. No tracking until cookie consent.

## Definition

```ts
| 'azure-app-insights'
  | 'google-analytics'
  | 'meta-pixel'
  | 'none'
```

<!-- source: service-analyzerservice.md -->

# AnalyzerService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-04-analysis/analyzer.service.ts` (line 1)

<!-- source: function-analyzestatemachine.md -->

# analyzeStateMachine

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/state-machine-analyzer.ts` (line 225)

Analyze complete state machine from code

Combines enum parsing and transition extraction to build a complete
state machine definition.

## Signature

```ts
function analyzeStateMachine(code: string, enumName: string, filePath: string): StateMachine
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |
| `enumName` | `string` |
| `filePath` | `string` |

**Returns:** `StateMachine`

<!-- source: class-angularselectorextractor.md -->

# AngularSelectorExtractor

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/angular-selector-extractor.ts` (line 18)

Angular Selector Extractor

## Methods

| Method | Signature | Returns |
|---|---|---|
| `extractFromTemplate` | `extractFromTemplate(template: string)` | `ExtractedSelectors` |

<!-- source: interface-apiflow-2.md -->

# APIFlow

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/relationship.interface.ts` (line 406)

API flow showing component → API → service → model chain

## Properties

| Property | Type |
|---|---|
| `endpoint` | `{
    id: string;
    name: string;
    path: string;
    method: string;
  }` |
| `callers` | `Array<{
    id: string;
    name: string;
    type: string;
    filePath: string;
  }>` |
| `services` | `Array<{
    id: string;
    name: string;
    filePath: string;
  }>` |
| `models` | `Array<{
    id: string;
    name: string;
    tableName: string;
  }>` |
| `relationships` | `Relationship[]` |

<!-- source: constant-apiratelimitingtemplate.md -->

# apiRateLimitingTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/api-rate-limiting.template.ts` (line 3)

<!-- source: interface-appconfig.md -->

# AppConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/config.interface.ts` (line 14)

Configuration Interfaces

Defines configuration types for the parser orchestrator system.

## Properties

| Property | Type |
|---|---|
| `port` | `number` |
| `host` | `string` |
| `environment` | `'development' | 'staging' | 'production'` |
| `debug` | `boolean` |
| `logLevel` | `'debug' | 'info' | 'warn' | 'error'` |

<!-- source: function-applyfilterstoboard.md -->

# applyFiltersToBoard

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 86)

Filter a whole board (returns a new board with filtered cards per column)

## Signature

```ts
function applyFiltersToBoard(board: BoardData, f: BoardFiltersState): BoardData
```

## Parameters

| Name | Type |
|---|---|
| `board` | `BoardData` |
| `f` | `BoardFiltersState` |

**Returns:** `BoardData`

<!-- source: service-appservice.md -->

# AppService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/app.service.ts` (line 4)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getHealth` | `getHealth()` | `unknown` |
| `getInfo` | `getInfo()` | `unknown` |

## Relationships

- DEPENDS_ON → `storageservice`

<!-- source: interface-assemblyresult.md -->

# AssemblyResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 98)

## Properties

| Property | Type |
|---|---|
| `success` | `boolean` |
| `outputDir` | `string` |
| `filesWritten` | `string[]` |
| `errors` | `Array<{ stage: AssemblyStage; message: string; context?: Record<string, unknown> }>` |
| `warnings` | `string[]` |
| `durationMs` | `number` |

<!-- source: function-audienceslugtoscope.md -->

# audienceSlugToScope

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/project/audience-scope.util.ts` (line 20)

Map a public audience slug to its doc-set scope.
'technical' | 'api' | 'developer' → 'technical'; everything else → 'user'.

## Signature

```ts
function audienceSlugToScope(audienceSlug: string | null): DocAudienceScope
```

## Parameters

| Name | Type |
|---|---|
| `audienceSlug` | `string | null` |

**Returns:** `DocAudienceScope`

<!-- source: interface-authdiagnostics.md -->

# AuthDiagnostics

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/utils/ai-auth-debugger.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `phase` | `string` |
| `timestamp` | `number` |
| `screenshots` | `string[]` |
| `pageState` | `{
    url: string;
    title: string;
    hasLoginForm: boolean;
    hasPasswordField: boolean;
    errors: string[];
    alerts: Array<{ text: string; role: string }>;
    formInputsFilled: number;
    localStorageKeys: string[];
    cookieCount: number;
    pendingRequests: number;
  }` |
| `attemptLog` | `Array<{
    action: string;
    method: string;
    success: boolean;
    error?: string;
  }>` |

<!-- source: function-authenticatewithai.md -->

# authenticateWithAI

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/utils/ai-auth-debugger.ts` (line 274)

Main entry point: AI-driven authentication with automatic debugging

## Signature

```ts
async function authenticateWithAI(page: any, _context: any, config: AuthConfig, maxRetries: number): Promise<{
  success: boolean;
  diagnostics: AuthDiagnostics[];
  aiAnalysis?: any;
}>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `any` |
| `_context` | `any` |
| `config` | `AuthConfig` |
| `maxRetries` | `number` |

**Returns:** `Promise<{
  success: boolean;
  diagnostics: AuthDiagnostics[];
  aiAnalysis?: any;
}>`

<!-- source: function-azureruntimeconfig.md -->

# azureRuntimeConfig

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/runtime-config.ts` (line 79)

Helper: create a RuntimeConfig with defaults for Azure GPT-5.4.
Uses DEFAULT_LOOP_ENGINE (env-switchable).

## Signature

```ts
function azureRuntimeConfig(azureConfig: AzureModelProviderConfig): RuntimeConfig
```

## Parameters

| Name | Type |
|---|---|
| `azureConfig` | `AzureModelProviderConfig` |

**Returns:** `RuntimeConfig`

<!-- source: class-batchrequestbuilder.md -->

# BatchRequestBuilder

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/test/helpers/batch-builder.ts` (line 19)

Builder for constructing test batch screenshot requests

Usage:
  const batch = new BatchRequestBuilder()
    .withProjectId('test-project')
    .withScreenshot({ url: 'http://localhost:3000', description: 'Test' })
    .build();

## Methods

| Method | Signature | Returns |
|---|---|---|
| `withProjectId` | `withProjectId(projectId: string)` | `this` |
| `withOrganizationId` | `withOrganizationId(organizationId: string)` | `this` |
| `withCapturedBy` | `withCapturedBy(capturedBy: string)` | `this` |
| `withName` | `withName(name: string)` | `this` |
| `withDescription` | `withDescription(description: string)` | `this` |
| `withConfig` | `withConfig(config: Partial<BatchConfigDto>)` | `this` |
| `withAuth` | `withAuth(auth: Partial<BatchAuthConfigDto>)` | `this` |
| `withScreenshot` | `withScreenshot(screenshot: Partial<BatchScreenshotItemDto>)` | `this` |
| `withScreenshots` | `withScreenshots(screenshots: Partial<BatchScreenshotItemDto>[])` | `this` |
| `build` | `build()` | `TakeBatchScreenshotsDto` |

<!-- source: interface-batchtask.md -->

# BatchTask

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/batch-screenshot.service.ts` (line 33)

Task representation for parallel execution

## Properties

| Property | Type |
|---|---|
| `index` | `number` |
| `item` | `BatchScreenshotItemDto` |
| `priority` | `number` |

<!-- source: type-boardtemplate.md -->

# BoardTemplate

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/boards/dto/create-board.dto.ts` (line 3)

## Definition

```ts
'default' | 'simple' | 'empty'
```

<!-- source: type-browsertype.md -->

# BrowserType

**Kind:** Type

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/playwright/playwright.service.ts` (line 4)

## Definition

```ts
'chromium' | 'firefox' | 'webkit'
```

<!-- source: function-buildcopywritersystemprompt.md -->

# buildCopywriterSystemPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/copywriter.prompts.ts` (line 20)

System prompt for the copywriter agent.
Establishes tone, constraints, and self-critique loop.

## Signature

```ts
function buildCopywriterSystemPrompt(config: GenerationConfig): string
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |

**Returns:** `string`

<!-- source: constant-category-labels.md -->

# CATEGORY_LABELS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 36)

## Definition

```ts
Record<string, string>
```

<!-- source: function-checkarialabels.md -->

# checkAriaLabels

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/accessibility.ts` (line 259)

Check ARIA labels

## Signature

```ts
async function checkAriaLabels(page: Page): Promise<{
  elementsWithoutLabels: string[];
  elementsWithLabels: number;
}>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |

**Returns:** `Promise<{
  elementsWithoutLabels: string[];
  elementsWithLabels: number;
}>`

<!-- source: component-code.md -->

# Code

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/entity/[entityId]/page.tsx` (line 51)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Code_5a818399["Code"]
    class component_Code_5a818399 rootComponent
```

## Referenced By

- `MethodsTable` (RENDERS)
- `FieldsTable` (RENDERS)
- `EntityDetailPage` (RENDERS)

<!-- source: graphql-type-comment.md -->

# Comment

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Comment on a post

## Relationships

- TYPE_OF → `User`
- TYPE_OF → `Post`
- TYPE_OF → `Comment`
- TYPE_OF → `Comment`
- TYPE_OF → `DateTime`
- TYPE_OF → `DateTime`

## Referenced By

- `addComment` (TYPE_OF)
- `newComment` (TYPE_OF)
- `Post` (TYPE_OF)
- `Comment` (TYPE_OF)
- `Comment` (TYPE_OF)

<!-- source: class-commentsidebarpage.md -->

# CommentSidebarPage

**Kind:** Class

**Source:** `atloria-monorepo/apps/web-e2e/src/pages/comments.page.ts` (line 7)

Comment sidebar page object

**Extends:** `BasePage`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `goto` | `goto()` | `Promise<void>` |
| `isVisible` | `isVisible()` | `Promise<boolean>` |
| `waitForLoad` | `waitForLoad()` | `Promise<void>` |
| `getCommentThreads` | `getCommentThreads()` | `Locator` |
| `getCommentByContent` | `getCommentByContent(content: string)` | `Locator` |
| `getCommentCount` | `getCommentCount()` | `Promise<number>` |
| `addComment` | `addComment(content: string)` | `Promise<void>` |
| `replyToComment` | `replyToComment(commentContent: string, replyContent: string)` | `Promise<void>` |
| `resolveComment` | `resolveComment(commentContent: string)` | `Promise<void>` |
| `unresolveComment` | `unresolveComment(commentContent: string)` | `Promise<void>` |
| `deleteComment` | `deleteComment(commentContent: string)` | `Promise<void>` |
| `isCommentResolved` | `isCommentResolved(commentContent: string)` | `Promise<boolean>` |
| `getActiveCommentCount` | `getActiveCommentCount()` | `Promise<number>` |
| `getResolvedCommentCount` | `getResolvedCommentCount()` | `Promise<number>` |
| `hasNoComments` | `hasNoComments()` | `Promise<boolean>` |
| `addCommentWithMention` | `addCommentWithMention(content: string, mentionUsername: string)` | `Promise<void>` |
| `getReplies` | `getReplies(commentContent: string)` | `Locator` |
| `getReplyCount` | `getReplyCount(commentContent: string)` | `Promise<number>` |

## Properties

| Property | Type |
|---|---|
| `sidebar` | `Locator` |
| `header` | `Locator` |
| `commentList` | `Locator` |
| `newCommentForm` | `Locator` |
| `commentInput` | `Locator` |
| `submitButton` | `Locator` |
| `emptyState` | `Locator` |
| `activeCount` | `Locator` |
| `resolvedCount` | `Locator` |
| `loadingSpinner` | `Locator` |

<!-- source: type-configformat.md -->

# ConfigFormat

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/storybook/types.ts` (line 14)

Configuration format detected

## Definition

```ts
'storybook' | 'ladle' | 'atloria' | 'none'
```

<!-- source: type-connectionstatus.md -->

# ConnectionStatus

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/hooks/useCollaboration.ts` (line 59)

Connection status for the collaboration session

## Definition

```ts
'connecting' | 'connected' | 'disconnected' | 'error'
```

<!-- source: interface-contentsafetyconfig.md -->

# ContentSafetyConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/content-safety.guardrail.ts` (line 43)

## Properties

| Property | Type |
|---|---|
| `checkFabricatedStats` | `boolean` |
| `checkDefamation` | `boolean` |
| `checkLegalClaims` | `boolean` |
| `checkFakeTestimonials` | `boolean` |

<!-- source: function-copysections.md -->

# copySections

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/copy.ts` (line 35)

Copy selected section .tsx files and their shared component dependencies
to the output directory.

## Signature

```ts
async function copySections(resolvedSections: ManifestSection[], componentLibraryDir: string, outputDir: string): Promise<string[]>
```

## Parameters

| Name | Type |
|---|---|
| `resolvedSections` | `ManifestSection[]` |
| `componentLibraryDir` | `string` |
| `outputDir` | `string` |

**Returns:** `Promise<string[]>`

<!-- source: function-createauthenticatedbatch.md -->

# createAuthenticatedBatch

**Kind:** Function

**Source:** `atloria-monorepo/apps/screenshot-worker/test/helpers/batch-builder.ts` (line 323)

Helper function to create an authenticated batch request

## Signature

```ts
function createAuthenticatedBatch(urls: string[], auth: {
    loginUrl: string;
    username: string;
    password: string;
    usernameSelector?: string;
    passwordSelector?: string;
    submitSelector?: string;
  }, options: {
    projectId?: string;
    organizationId?: string;
  }): TakeBatchScreenshotsDto
```

## Parameters

| Name | Type |
|---|---|
| `urls` | `string[]` |
| `auth` | `{
    loginUrl: string;
    username: string;
    password: string;
    usernameSelector?: string;
    passwordSelector?: string;
    submitSelector?: string;
  }` |
| `options` | `{
    projectId?: string;
    organizationId?: string;
  }` |

**Returns:** `TakeBatchScreenshotsDto`

<!-- source: function-createmockparser.md -->

# createMockParser

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 92)

Create a mock parser for testing

## Signature

```ts
function createMockParser(name: string, patterns: string[], parseResult: Partial<ParseResult>): IParser
```

## Parameters

| Name | Type |
|---|---|
| `name` | `string` |
| `patterns` | `string[]` |
| `parseResult` | `Partial<ParseResult>` |

**Returns:** `IParser`

<!-- source: api-endpoint-createuser.md -->

# createUser

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

Create a new user

## Endpoint

`POST /users`

## Relationships

- REFERENCES → `CreateUser`
- REFERENCES → `User`
- REFERENCES → `Error`
- REFERENCES → `Error`

## Referenced By

- `User Management API` (IMPLEMENTS_API)

<!-- source: graphql-mutation-createuser.md -->

# createUser

**Kind:** Graphql Mutation

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Create a new user

## Relationships

- TYPE_OF → `User`
- TYPE_OF → `CreateUserInput`

## Referenced By

- `Mutation` (CALLS_API)

<!-- source: constant-default-blocked-patterns.md -->

# DEFAULT_BLOCKED_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/tools/bash.tool.ts` (line 55)

## Definition

```ts
RegExp[]
```

<!-- source: constant-default-retry-config.md -->

# DEFAULT_RETRY_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/retry-handler.service.ts` (line 22)

Default retry configuration

## Definition

```ts
RetryConfig
```

<!-- source: enum-diffchangetype.md -->

# DiffChangeType

**Kind:** Enum

**Source:** `atloria-monorepo/apps/api/src/document/dto/compare-document.dto.ts` (line 44)

Diff change types emitted by the document comparison service.

NOTE: `MODIFIED` is retained for backward compatibility with older clients
but is no longer produced by `calculateTextDiff`. The new LCS-based diff
emits every edited line as a paired `REMOVED` + `ADDED` entry so the old
and new content are both preserved on the response.

## Values

- `ADDED`
- `REMOVED`
- `UNCHANGED`
- `MODIFIED`

<!-- source: controller-discoverycontroller.md -->

# DiscoveryController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/discovery/discovery.controller.ts` (line 5)

## Relationships

- MODULE_DECLARES → `scan`
- DEPENDS_ON → `discoveryservice`

<!-- source: class-djangoparser-2.md -->

# DjangoParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/backend/django.parser.ts` (line 48)

Django REST Framework Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: type-docsearchfn.md -->

# DocSearchFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/tools/query-docs.tool.ts` (line 15)

Search function signature — matches AzureSearchService.search() shape.
Injected at tool creation time.

## Definition

```ts
(
  query: string,
  projectId: string,
  maxResults?: number
) => Promise<DocSearchResult[]>
```

<!-- source: enum-documentstate.md -->

# DocumentState

**Kind:** Enum

**Source:** `atloria-monorepo/packages/types/src/enums/index.ts` (line 55)

Document state tracks the lifecycle stage of a document

## Values

- `DRAFT`
- `REVIEW`
- `PUBLISHED`
- `OUTDATED`

<!-- source: enum-entitytype-3.md -->

# EntityType

**Kind:** Enum

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 16)

Entity types that can be discovered by parsers

## Values

- `COMPONENT`
- `HOOK`
- `PAGE`
- `LAYOUT`
- `ROUTE`
- `CONTEXT`
- `PROVIDER`
- `STORE`
- `STATE_ACTION`
- `STATE_REDUCER`
- `STATE_SELECTOR`
- `STATE_MIDDLEWARE`
- `STATE_EFFECT`
- `STATE_STORE`
- `CONTROLLER`
- `SERVICE`
- `REPOSITORY`
- `MIDDLEWARE`
- `GUARD`
- `INTERCEPTOR`
- `PIPE`
- `MODULE`
- `EVENT_HANDLER`
- `JOB_PROCESSOR`
- `API_ENDPOINT`
- `GRAPHQL_QUERY`
- `GRAPHQL_MUTATION`
- `GRAPHQL_SUBSCRIPTION`
- `GRAPHQL_TYPE`
- `RPC_METHOD`
- `WEBSOCKET_ENDPOINT`
- `DATABASE_MODEL`
- `DATABASE_MIGRATION`
- `DATABASE_SEED`
- `DATABASE_VIEW`
- `DATABASE_PROCEDURE`
- `DOCKER_SERVICE`
- `K8S_DEPLOYMENT`
- `K8S_SERVICE`
- `K8S_CONFIGMAP`
- `TERRAFORM_RESOURCE`
- `CI_WORKFLOW`
- `MARKDOWN_DOC`
- `API_SCHEMA`
- `DOC_COMMENT`
- `ENV_VARIABLE`
- `CONFIG_FILE`
- `FEATURE_FLAG`
- `CLASS`
- `FUNCTION`

<!-- source: type-error.md -->

# Error

**Kind:** Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

## Properties

| Property | Type |
|---|---|
| `statusCode` | `integer` |
| `message` | `string` |
| `error` | `string` |

## Referenced By

- `createUser` (REFERENCES)
- `createUser` (REFERENCES)
- `getUserById` (REFERENCES)
- `User Management API` (TYPE_OF)

<!-- source: function-extractdefaultvalue.md -->

# extractDefaultValue

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 258)

Extract default value as a string representation

## Signature

```ts
function extractDefaultValue(node: t.Node): string
```

## Parameters

| Name | Type |
|---|---|
| `node` | `t.Node` |

**Returns:** `string`

<!-- source: class-fastapiparser.md -->

# FastAPIParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/backend-parser/src/parsers/fastapi.parser.ts` (line 41)

FastAPI Parser implementation

Uses regex-based parsing for Python files since we can't use Python AST directly in Node.js

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: type-fetchcategoriesfn.md -->

# FetchCategoriesFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/query-product-knowledge.tool.ts` (line 43)

Fetch the document category tree for a project.

## Definition

```ts
(
  projectId: string,
) => Promise<ProductCategory[]>
```

<!-- source: class-filesystemprovider.md -->

# FileSystemProvider

**Kind:** Class

**Source:** `atloria-monorepo/apps/cli/src/providers/filesystem.provider.ts` (line 19)

File system data provider
Reads from local JSON files in outputDir

**Implements:** `DataProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: DataProviderConfig)` | `Promise<void>` |
| `getProjectMetadata` | `getProjectMetadata()` | `Promise<ProjectMetadata>` |
| `getEntities` | `getEntities()` | `Promise<Entity[]>` |
| `getEntitiesByType` | `getEntitiesByType(type: string)` | `Promise<Entity[]>` |
| `getEntityById` | `getEntityById(id: string)` | `Promise<Entity | null>` |
| `getRelationships` | `getRelationships()` | `Promise<Relationship[]>` |
| `getRelationshipsForEntity` | `getRelationshipsForEntity(entityId: string)` | `Promise<Relationship[]>` |
| `saveParseResults` | `saveParseResults(results: ParseResult[], project: DetectedProject)` | `Promise<void>` |
| `destroy` | `destroy()` | `Promise<void>` |

<!-- source: function-generaterelationshipid.md -->

# generateRelationshipId

**Kind:** Function

**Source:** `atloria-monorepo/apps/database-parser/src/utils/hash.util.ts` (line 35)

Generate a relationship ID

## Signature

```ts
function generateRelationshipId(sourceId: string, type: string, targetId: string): string
```

## Parameters

| Name | Type |
|---|---|
| `sourceId` | `string` |
| `type` | `string` |
| `targetId` | `string` |

**Returns:** `string`

<!-- source: api-endpoint-gethealth.md -->

# getHealth

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/app.controller.ts` (line 11)

Health check endpoint

## Endpoint

`GET /`

## Referenced By

- `AppController` (MODULE_DECLARES)

<!-- source: api-endpoint-getjobstatus-4.md -->

# getJobStatus

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/analysis/analysis.controller.ts` (line 62)

Get analysis job status

GET /api/analysis/:jobId

Returns:
{
  "id": "uuid",
  "status": "analyzing" | "completed" | "failed",
  "progress": 75,
  "repoUrl": "...",
  "branch": "main",
  "folderPath": "packages/frontend",
  "framework": "react",
  "routesFound": 25,
  "componentsFound": 150,
  "modalsFound": 12,
  "createdAt": "2024-01-01T00:00:00Z",
  "completedAt": "2024-01-01T00:05:00Z"
}

## Endpoint

`GET /analysis/:jobId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `jobId` | query | `string` | ✓ |

## Referenced By

- `AnalysisController` (MODULE_DECLARES)

<!-- source: module-gitmodule.md -->

# GitModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/git/git.module.ts` (line 4)

## Relationships

- MODULE_PROVIDES → `gitservice`
- MODULE_EXPORTS → `gitservice`

<!-- source: service-gitservice.md -->

# GitService

**Kind:** Service

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/git/git.service.ts` (line 35)

Git service for cloning repositories with mono-repo support

Features:
- Shallow clones for speed (depth=1 by default)
- Support for specific branches
- Mono-repo folder path support
- Automatic cleanup of old clones
- Git authentication via tokens (for private repos)

`GitService` is a NestJS backend service responsible for cloning Git repositories to a local workspace for analysis, with built-in support for mono-repo subfolder targeting. It optimizes cloning via shallow clones (default `depth=1`), supports selecting specific branches, and handles authentication for private repositories via tokens. It also manages lifecycle concerns like cleaning up old clones to keep disk usage under control.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `clone` | `clone(options: CloneOptions)` | `Promise<CloneResult>` |
| `cleanup` | `cleanup(clonePath: string)` | `Promise<void>` |
| `cleanupOld` | `cleanupOld()` | `Promise<void>` |
| `checkGitInstalled` | `checkGitInstalled()` | `Promise<boolean>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  actor Caller as Analyzer/Controller
  participant GitService as GitService
  participant FS as Local FS
  participant Git as Git CLI/Library
  participant Cleanup as Cleanup Job

  Caller->>GitService: clone({ repoUrl, branch?, token?, depth=1, monoRepoPath? })
  GitService->>Cleanup: cleanupOldClones()
  Cleanup->>FS: delete stale clone dirs
  GitService->>Git: git clone --depth=1 (--branch <branch>) <repoUrl> <targetDir>
  alt Private repo (token provided)
    GitService->>Git: inject auth (token in URL/headers)
  end
  Git->>FS: write working tree to <targetDir>
  alt monoRepoPath provided
    GitService->>FS: resolve <targetDir>/<monoRepoPath>
    GitService-->>Caller: return path to mono-repo subfolder
  else
    GitService-->>Caller: return path to repo root
  end
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { GitService } from './git.service';

@Injectable()
export class RepoAnalysisService {
  constructor(private readonly git: GitService) {}

  async analyze() {
    const localPath = await this.git.clone({
      repoUrl: 'https://github.com/acme/atloria-monorepo.git',
      branch: 'main',
      depth: 1, // shallow clone for speed (default behavior)
      monoRepoPath: 'apps/code-analyzer', // optional: target subfolder within a mono-repo
      token: process.env.GITHUB_TOKEN, // optional: required for private repos
    });

    // Use localPath as the root for scanning/analysis
    // e.g., await this.scanner.scan(localPath);
    return { localPath };
  }
}
```

## AI Coding Instructions

- Prefer shallow clones (`depth=1`) unless the feature explicitly needs history; increasing depth can dramatically impact performance and disk usage.
- When adding auth changes, ensure tokens are never logged and are not written to disk (avoid persisting tokenized URLs in config files).
- Treat `monoRepoPath` as a resolved, validated subdirectory of the clone target to avoid path traversal or accidental analysis of the wrong folder.
- Keep cleanup idempotent and safe: only delete within the managed clones directory, and never remove user-provided paths outside that root.
- Integration point: callers should rely on the returned local path (repo root or mono-repo subfolder) and avoid assuming directory structure before `clone()` resolves it.

<!-- source: module-knowledgegraphmodule.md -->

# KnowledgeGraphModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/knowledge-graph/kg.module.ts` (line 16)

## Relationships

- MODULE_IMPORTS → `configmodule`
- MODULE_PROVIDES → `knowledgegraphservice`
- MODULE_PROVIDES → `kgsyncservice`
- MODULE_EXPORTS → `knowledgegraphservice`
- MODULE_EXPORTS → `kgsyncservice`

<!-- source: service-knowledgegraphservice.md -->

# KnowledgeGraphService

**Kind:** Service

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/knowledge-graph/kg.service.ts` (line 24)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `isConnected` | `isConnected()` | `boolean` |
| `onModuleInit` | `onModuleInit()` | `unknown` |
| `onModuleDestroy` | `onModuleDestroy()` | `unknown` |
| `upsertEntity` | `upsertEntity(entity: Entity)` | `Promise<void>` |
| `upsertBatch` | `upsertBatch(entities: Entity[])` | `Promise<void>` |
| `getEntity` | `getEntity(id: string)` | `Promise<Entity | null>` |
| `getEntitiesByType` | `getEntitiesByType(type: EntityType, limit: unknown)` | `Promise<Entity[]>` |
| `deleteEntity` | `deleteEntity(id: string)` | `Promise<void>` |
| `createRelationship` | `createRelationship(relationship: Relationship)` | `Promise<void>` |
| `createRelationshipsBatch` | `createRelationshipsBatch(relationships: Relationship[])` | `Promise<void>` |
| `getRelationships` | `getRelationships(entityId: string)` | `Promise<Relationship[]>` |
| `deleteRelationship` | `deleteRelationship(relationshipId: string)` | `Promise<void>` |
| `getComponentDependencies` | `getComponentDependencies(componentId: string, depth: unknown)` | `Promise<DependencyTree | null>` |
| `getAPIFlow` | `getAPIFlow(endpointId: string)` | `Promise<APIFlow | null>` |
| `query` | `query(cypher: string, params: Record<string, unknown>)` | `Promise<any[]>` |
| `clearAll` | `clearAll()` | `Promise<void>` |
| `getStatistics` | `getStatistics()` | `Promise<{
    totalNodes: number;
    totalRelationships: number;
    nodesByLabel: Record<string, number>;
    relationshipsByType: Record<string, number>;
  }>` |

## Relationships

- DEPENDS_ON → `configservice`

<!-- source: constant-known-projects.md -->

# KNOWN_PROJECTS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/pme-agent/test/discovery/ground-truth.ts` (line 25)

## Definition

```ts
ProjectInfo[]
```

<!-- source: class-markdownparser.md -->

# MarkdownParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/config-docs-parser/src/parsers/markdown.parser.ts` (line 62)

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: graphql-subscription-newpost.md -->

# newPost

**Kind:** Graphql Subscription

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Subscribe to new posts from followed users

## Relationships

- TYPE_OF → `Post`

## Referenced By

- `Subscription` (CALLS_API)

<!-- source: class-openapiparser.md -->

# OpenAPIParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/api-schema-parser/src/parsers/openapi.parser.ts` (line 38)

OpenAPI Parser Implementation

Supports:
- OpenAPI 3.0.x and 3.1.x
- Swagger 2.0
- JSON and YAML formats

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: class-parseprojectdto.md -->

# ParseProjectDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/dto/parse-job.dto.ts` (line 75)

DTO for parsing an entire project

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `parsers` | `string[]` |
| `includePatterns` | `string[]` |
| `excludePatterns` | `string[]` |
| `incremental` | `boolean` |
| `maxFiles` | `number` |
| `parallel` | `boolean` |
| `metadata` | `Record<string, unknown>` |

<!-- source: constant-parse-queue-name.md -->

# PARSE_QUEUE_NAME

**Kind:** Constant

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/queue/constants.ts` (line 7)

Queue Constants

<!-- source: enum-parsercategory.md -->

# ParserCategory

**Kind:** Enum

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/parser.interface.ts` (line 118)

Parser category for grouping

## Values

- `FRONTEND`
- `BACKEND`
- `DATABASE`
- `API_SCHEMA`
- `CONFIG`
- `DOCUMENTATION`
- `INFRASTRUCTURE`

<!-- source: module-pdfmodule.md -->

# PdfModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/pdf/pdf.module.ts` (line 6)

## Relationships

- MODULE_IMPORTS → `playwrightmodule`
- MODULE_DECLARES → `pdfcontroller`
- MODULE_PROVIDES → `pdfservice`
- MODULE_EXPORTS → `pdfservice`

<!-- source: interface-performancemetrics.md -->

# PerformanceMetrics

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/performance.ts` (line 24)

Performance metrics result

## Properties

| Property | Type |
|---|---|
| `ttfb` | `number` |
| `fcp` | `number` |
| `domContentLoaded` | `number` |
| `load` | `number` |
| `lcp` | `number` |
| `cls` | `number` |
| `resourceCount` | `number` |
| `totalSize` | `number` |
| `jsHeapSize` | `number` |
| `domNodes` | `number` |

<!-- source: class-pmemetricscollector.md -->

# PmeMetricsCollector

**Kind:** Class

**Source:** `atloria-monorepo/libs/pme-core/src/tracing/pme-metrics.ts` (line 33)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `recordJob` | `recordJob(status: string)` | `void` |
| `recordQaScore` | `recordQaScore(sectionType: string, score: number)` | `void` |
| `recordVariantSelection` | `recordVariantSelection(variantKey: string)` | `void` |
| `recordGenerationTime` | `recordGenerationTime(durationMs: number)` | `void` |
| `recordSectionType` | `recordSectionType(sectionType: string)` | `void` |
| `recordTokenUsage` | `recordTokenUsage(inputTokens: number, outputTokens: number)` | `void` |
| `getMetrics` | `getMetrics()` | `PmeMetrics` |
| `toPrometheus` | `toPrometheus()` | `string` |

<!-- source: interface-propinfo.md -->

# PropInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 31)

Information about a prop definition

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `required` | `boolean` |
| `defaultValue` | `string` |
| `description` | `string` |

<!-- source: class-reactparser.md -->

# ReactParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/frontend-parser/src/parsers/react.parser.ts` (line 76)

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `supportedPatterns` | `string[]` |

<!-- source: graphql-query-searchusers.md -->

# searchUsers

**Kind:** Graphql Query

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Search users by name or email

## Relationships

- TYPE_OF → `User`

## Referenced By

- `Query` (CALLS_API)

<!-- source: class-sequelizeparser.md -->

# SequelizeParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/database-parser/src/parsers/sequelize.parser.ts` (line 25)

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: component-statcard.md -->

# StatCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/frontend/src/components/StatCard.tsx` (line 15)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `label` | `any` | ✓ | - |
| `value` | `any` | ✓ | - |
| `icon` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StatCard_b56783e["StatCard"]
    class component_StatCard_b56783e rootComponent
```

<!-- source: component-stepcard.md -->

# StepCard

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/how-it-works/how-it-works-timeline.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `step` | `Step` | ✓ | - |
| `t` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StepCard_3fd6c6ab["StepCard"]
    class component_StepCard_3fd6c6ab rootComponent
```

## Relationships

- RENDERS → `Icon`

## Referenced By

- `HowItWorksTimeline` (RENDERS)

<!-- source: interface-targetingtask.md -->

# TargetingTask

**Kind:** Interface

**Source:** `atloria-monorepo/apps/pme-agent/test/discovery/ground-truth.ts` (line 152)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `task` | `string` |
| `expectedProjects` | `string[]` |
| `expectedFiles` | `string[]` |
| `expectedKeywords` | `string[]` |

<!-- source: page-terms.md -->

# terms

**Kind:** Page

**Source:** `atloria-monorepo/templates/site-bootstrap/src/App.tsx`

<!-- source: constant-theme-presets-3.md -->

# THEME_PRESETS

**Kind:** Constant

**Source:** `atloria-monorepo/libs/pme-core/src/tools/theme.ts` (line 93)

## Definition

```ts
Record<ThemeMode, ThemeVars>
```

<!-- source: component-treeitem.md -->

# TreeItem

**Kind:** Component

**Source:** `atloria-monorepo/packages/ui-react/src/components/NavigationTree.tsx` (line 59)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `node` | `DocumentTreeNode` | ✓ | - |
| `level` | `number` | ✓ | - |
| `activeId` | `string` | - | - |
| `expandedIds` | `string[]` | ✓ | - |
| `onToggleExpand` | `Function` | ✓ | - |
| `onItemClick` | `Function` | - | - |
| `showStateIndicator` | `boolean` | - | - |
| `focusedId` | `string | null` | ✓ | - |
| `onFocusChange` | `Function` | ✓ | - |
| `onKeyDown` | `Function` | ✓ | - |
| `itemRefs` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TreeItem_636541b4["TreeItem"]
    class component_TreeItem_636541b4 rootComponent
```

## Relationships

- RENDERS → `TreeItem`
- USES_HOOK → `useCallback`

## Referenced By

- `TreeItem` (RENDERS)
- `NavigationTree` (RENDERS)

<!-- source: type-wcaglevel.md -->

# WCAGLevel

**Kind:** Type

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/accessibility.ts` (line 7)

WCAG conformance levels

## Definition

```ts
'A' | 'AA' | 'AAA'
```

<!-- source: constant-web-vitals-thresholds.md -->

# WEB_VITALS_THRESHOLDS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/performance.ts` (line 6)

Web Vitals thresholds (based on Google's guidelines)

<!-- source: function-createlexicaljsxnode.md -->

# $createLexicalJsxNode

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/LexicalJsxNode.tsx` (line 144)

## Signature

```ts
function $createLexicalJsxNode(mdastNode: MdastJsx, importStatement: ImportStatement): LexicalJsxNode
```

## Parameters

| Name | Type |
|---|---|
| `mdastNode` | `MdastJsx` |
| `importStatement` | `ImportStatement` |

**Returns:** `LexicalJsxNode`

<!-- source: constant-activeplugins.md -->

# activePlugins$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 911)

The names of the plugins that are currently active.

<!-- source: api-endpoint-addcards.md -->

# addCards

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 153)

## Endpoint

`POST /projects/:projectId/boards/:boardId/cards`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `boardId` | query | `string` | ✓ |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: class-addmemberdto.md -->

# AddMemberDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/add-member.dto.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `userId` | `string` |
| `role` | `UserRole` |

<!-- source: interface-agentexecutionconfig.md -->

# AgentExecutionConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/support-agent/agent-adapter.service.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `organizationId` | `string` |
| `projectName` | `string` |
| `agentName` | `string` |
| `systemPrompt` | `string` |
| `workspace` | `string` |
| `language` | `string` |
| `conversationHistory` | `Array<{ role: string; content: string }>` |

<!-- source: interface-agenthistoryitem.md -->

# AgentHistoryItem

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 148)

## Properties

| Property | Type |
|---|---|
| `role` | `'user' | 'assistant' | 'tool'` |
| `content` | `string` |
| `agentName` | `string` |
| `toolName` | `string` |

<!-- source: type-agentprotocoleventhandler.md -->

# AgentProtocolEventHandler

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/protocol/agent-protocol.ts` (line 92)

Handler signature used by SessionEventBridge listeners

## Definition

```ts
(
  event: AgentProtocolEvent<T>,
) => void
```

<!-- source: interface-agentscreenshotspec.md -->

# AgentScreenshotSpec

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/agent-screenshot-mapper.ts` (line 74)

Screenshot spec produced by agent analysis — ready for worker

## Properties

| Property | Type |
|---|---|
| `placeholderId` | `string` |
| `description` | `string` |
| `url` | `string` |
| `confidence` | `'exact' | 'inferred'` |
| `matchedRoute` | `string` |
| `actions` | `ScreenshotAction[]` |
| `waitForSelector` | `string` |
| `viewport` | `{ width: number; height: number }` |
| `stateType` | `'default' | 'hover' | 'modal' | 'error' | 'success'` |
| `category` | `string` |

<!-- source: service-agentservice.md -->

# AgentService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/agent/agent.service.ts` (line 84)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createSession` | `createSession(socketId: string, payload: AgentStartPayload)` | `Promise<ManagedSession>` |
| `getSession` | `getSession(socketId: string)` | `ManagedSession | undefined` |
| `destroySession` | `destroySession(socketId: string)` | `void` |
| `getActiveSessionCount` | `getActiveSessionCount()` | `number` |

## Relationships

- DEPENDS_ON → `configservice`

<!-- source: controller-aicontroller.md -->

# AIController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/ai/ai.controller.ts` (line 23)

## Relationships

- MODULE_DECLARES → `enhance`
- MODULE_DECLARES → `generateOutline`
- MODULE_DECLARES → `improve`
- MODULE_DECLARES → `summarize`
- MODULE_DECLARES → `listProviders`
- DEPENDS_ON → `aiservice`

<!-- source: class-aiderpolyglotadapter.md -->

# AiderPolyglotAdapter

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/aider-adapter.ts` (line 49)

**Implements:** `BenchmarkAdapter`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `loadTasks` | `loadTasks(config: BenchmarkRunConfig)` | `Promise<BenchmarkTask[]>` |
| `setupTask` | `setupTask(task: BenchmarkTask, workDir: string)` | `Promise<void>` |
| `buildPrompt` | `buildPrompt(task: BenchmarkTask)` | `string` |
| `evaluate` | `evaluate(task: BenchmarkTask, workDir: string)` | `Promise<{ passed: boolean; details: string }>` |
| `cleanup` | `cleanup(_task: BenchmarkTask, workDir: string)` | `Promise<void>` |

<!-- source: interface-aisettings.md -->

# AISettings

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/types/ai.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `defaultProvider` | `AIProviderName` |
| `maxTokens` | `number` |
| `temperature` | `number` |
| `enableStreaming` | `boolean` |
| `autoSave` | `boolean` |

<!-- source: module-analyticsmodule.md -->

# AnalyticsModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.module.ts` (line 13)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `emailmodule`
- MODULE_DECLARES → `analyticscontroller`
- MODULE_DECLARES → `analyticsexportcontroller`
- MODULE_PROVIDES → `analyticsservice`
- MODULE_PROVIDES → `feedbackservice`
- MODULE_PROVIDES → `analyticsexportservice`
- MODULE_PROVIDES → `scheduledreportsservice`
- MODULE_EXPORTS → `analyticsservice`
- MODULE_EXPORTS → `feedbackservice`
- MODULE_EXPORTS → `analyticsexportservice`
- MODULE_EXPORTS → `scheduledreportsservice`

<!-- source: function-analyzetemplate.md -->

# analyzeTemplate

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/template-analyzer.ts` (line 41)

Main entry point: Analyze a template and extract structured data

## Signature

```ts
function analyzeTemplate(templateContent: string, framework: 'angular' | 'vue' | 'react'): TemplateAnalysis
```

## Parameters

| Name | Type |
|---|---|
| `templateContent` | `string` |
| `framework` | `'angular' | 'vue' | 'react'` |

**Returns:** `TemplateAnalysis`

<!-- source: class-apicallmapper.md -->

# APICallMapper

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/api-call-mapper.ts` (line 80)

API Call Mapper

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectAPICalls` | `detectAPICalls(entities: Entity[])` | `DetectedAPICall[]` |
| `detectEndpoints` | `detectEndpoints(entities: Entity[])` | `DetectedEndpoint[]` |
| `mapCallsToEndpoints` | `mapCallsToEndpoints(calls: DetectedAPICall[], endpoints: DetectedEndpoint[])` | `APIMapping[]` |

<!-- source: interface-apiflowdiagramoptions.md -->

# APIFlowDiagramOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/api-flow-diagram.generator.ts` (line 21)

Options for API flow diagram generation

## Properties

| Property | Type |
|---|---|
| `diagramType` | `'flowchart' | 'sequence'` |
| `showHttpMethods` | `boolean` |
| `showParameters` | `boolean` |
| `showMiddleware` | `boolean` |
| `direction` | `'LR' | 'TD' | 'RL' | 'BT'` |
| `maxDepth` | `number` |
| `includeTheme` | `boolean` |

<!-- source: constant-apiversioningtemplate.md -->

# apiVersioningTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/api-versioning.template.ts` (line 3)

<!-- source: type-astnode.md -->

# ASTNode

**Kind:** Type

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 82)

Union type of all AST nodes

## Definition

```ts
TextNode | AudienceNode | VariantNode | BlockDefinitionNode | IncludeNode
```

<!-- source: service-authcontextservice.md -->

# AuthContextService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/auth-context.service.ts` (line 15)

Service for authenticated browser-context lifecycle.

Extracted verbatim from BatchScreenshotService so that batch capture,
flow-replay (WS-A) and clip capture (WS-B) can all share ONE implementation
of login / session-loss detection / re-auth without forking it.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createAuthenticatedContext` | `createAuthenticatedContext(browser: Browser, auth: BatchAuthConfigDto, config: Required<BatchConfigDto>, locale: string)` | `Promise<BrowserContext>` |
| `isSessionLost` | `isSessionLost(page: Page, auth: BatchAuthConfigDto, targetUrl: string)` | `Promise<boolean>` |
| `reAuthenticate` | `reAuthenticate(context: BrowserContext, auth: BatchAuthConfigDto, config: Required<BatchConfigDto>)` | `Promise<void>` |

<!-- source: interface-authenticationinfo.md -->

# AuthenticationInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 570)

Authentication information

## Properties

| Property | Type |
|---|---|
| `type` | `'jwt' | 'oauth' | 'api-key' | 'basic' | 'bearer' | 'none'` |
| `scopes` | `string[]` |
| `optional` | `boolean` |

<!-- source: type-authresponse.md -->

# AuthResponse

**Kind:** Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

## Properties

| Property | Type |
|---|---|
| `accessToken` | `string` |
| `refreshToken` | `string` |
| `user` | `User` |

## Relationships

- TYPE_OF → `User`

## Referenced By

- `login` (REFERENCES)
- `User Management API` (TYPE_OF)

<!-- source: function-baselang.md -->

# baseLang

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/uiStrings.ts` (line 520)

Normalize a language code ('ar', 'ar-SA', 'AR') to its base lowercase form.

## Signature

```ts
function baseLang(lang: string | null): string
```

## Parameters

| Name | Type |
|---|---|
| `lang` | `string | null` |

**Returns:** `string`

<!-- source: class-batchscreenshotitemdto.md -->

# BatchScreenshotItemDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 346)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `description` | `string` |
| `url` | `string` |
| `expectedState` | `string` |
| `viewport` | `ViewportDto` |
| `fullPage` | `boolean` |
| `waitFor` | `WaitForDto` |
| `waitForSelector` | `string` |
| `waitForTimeout` | `number` |
| `actions` | `ScreenshotActionDto[]` |
| `stateType` | `StateType` |
| `category` | `string` |
| `clip` | `ClipDto` |
| `metadata` | `Record<string, unknown>` |
| `timing` | `TimingConfigDto` |
| `data` | `DataConfigDto` |
| `interaction` | `InteractionConfigDto` |
| `error` | `ErrorConfigDto` |
| `componentHints` | `ComponentHintsDto` |
| `flowStepId` | `string` |
| `priority` | `number` |
| `stateResolution` | `StateResolutionConfigDto` |
| `parentPlaceholderId` | `string` |
| `sequenceOrder` | `number` |

<!-- source: function-benchreportcommand.md -->

# benchReportCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/bench.command.ts` (line 198)

## Signature

```ts
async function benchReportCommand(reportPath: string): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `reportPath` | `string` |

**Returns:** `Promise<void>`

<!-- source: interface-benchrunoptions.md -->

# BenchRunOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/commands/bench.command.ts` (line 32)

## Properties

| Property | Type |
|---|---|
| `preset` | `'starter' | 'full'` |
| `tasks` | `string` |
| `maxTasks` | `string` |
| `parallel` | `string` |
| `maxTurns` | `string` |
| `timeout` | `string` |
| `output` | `string` |
| `model` | `string` |
| `repoDir` | `string` |
| `costLimit` | `string` |
| `attempts` | `string` |
| `provider` | `'azure' | 'anthropic'` |

<!-- source: interface-boxpct.md -->

# BoxPct

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/crop.service.ts` (line 11)

Pure geometry + image helpers shared by the clip-capture (WS-B) flow.

These are intentionally framework-free pure functions (no Playwright, no Nest
DI) so they can be unit-tested in isolation and reused by any workstream.

## Properties

| Property | Type |
|---|---|
| `x` | `number` |
| `y` | `number` |
| `w` | `number` |
| `h` | `number` |

<!-- source: function-buildadaptiveprompt.md -->

# buildAdaptivePrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/adaptive-prompt.ts` (line 52)

## Signature

```ts
function buildAdaptivePrompt(options: AdaptivePromptOptions): string
```

## Parameters

| Name | Type |
|---|---|
| `options` | `AdaptivePromptOptions` |

**Returns:** `string`

<!-- source: function-buildapiexecutor.md -->

# buildApiExecutor

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/mcp/api-executor.ts` (line 44)

## Signature

```ts
function buildApiExecutor(cfg: ApiExecutorConfig): ApiExecFn
```

## Parameters

| Name | Type |
|---|---|
| `cfg` | `ApiExecutorConfig` |

**Returns:** `ApiExecFn`

<!-- source: function-buildlayoutsystemprompt.md -->

# buildLayoutSystemPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/layout.prompts.ts` (line 10)

## Signature

```ts
function buildLayoutSystemPrompt(): string
```

**Returns:** `string`

<!-- source: type-captureaction.md -->

# CaptureAction

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/capture/dto/create-flow.dto.ts` (line 16)

## Definition

```ts
(typeof CAPTURE_ACTIONS)[number]
```

<!-- source: constant-categoryfulllabels.md -->

# categoryFullLabels

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/constants/templateCategories.ts` (line 31)

Full labels for detailed views (preview modal, etc.)

## Definition

```ts
Record<TemplateCategory, string>
```

<!-- source: interface-categorymeta.md -->

# CategoryMeta

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 115)

## Properties

| Property | Type |
|---|---|
| `required` | `boolean` |
| `maxPick` | `number` |

<!-- source: component-cell.md -->

# Cell

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/table/TableEditor.tsx` (line 319)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `align` | `any` | ✓ | - |
| `...props` | `object` | - | - |

## Diagram

```mermaid
graph TD
    component_Cell_6cdf5d6c["Cell"]
    class component_Cell_6cdf5d6c rootComponent
```

## Relationships

- RENDERS → `CellElement`
- RENDERS → `CellEditor`

## Referenced By

- `TableEditor` (RENDERS)

<!-- source: function-checkcolorcontrast.md -->

# checkColorContrast

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/accessibility.ts` (line 200)

Check color contrast

## Signature

```ts
async function checkColorContrast(page: Page, selector: string): Promise<{
  foreground: string;
  background: string;
  ratio: number;
  passes: boolean;
}>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |
| `selector` | `string` |

**Returns:** `Promise<{
  foreground: string;
  background: string;
  ratio: number;
  passes: boolean;
}>`

<!-- source: service-chunkerservice.md -->

# ChunkerService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-02-chunking/chunker.service.ts` (line 1)

<!-- source: type-connectiontype.md -->

# ConnectionType

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/deployment-diagram.generator.ts` (line 57)

Connection types between deployment nodes

## Definition

```ts
'http' | 'https' | 'grpc' | 'tcp' | 'websocket' | 'database' | 'message-queue'
```

<!-- source: interface-coordinatordependencies.md -->

# CoordinatorDependencies

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/agents/coordinator.agent.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `searchFn` | `DocSearchFn` |
| `generateFn` | `ContentGenerateFn` |
| `storeFn` | `StoreAssetFn` |
| `generateImageFn` | `ImageGenerateFn` |
| `findScreenshotsFn` | `FindScreenshotsFn` |

<!-- source: function-copytemplate.md -->

# copyTemplate

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/copy.ts` (line 18)

Copy the entire site-bootstrap template to outputDir,
excluding node_modules and other non-essential files.

## Signature

```ts
async function copyTemplate(templateDir: string, outputDir: string): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `templateDir` | `string` |
| `outputDir` | `string` |

**Returns:** `Promise<void>`

<!-- source: type-countvalue.md -->

# CountValue

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 71)

counts values are numbers per contract; we tolerate {count, breach} if the backend enriches later

## Definition

```ts
number | { count: number; breach?: number }
```

<!-- source: function-createsimplebatch.md -->

# createSimpleBatch

**Kind:** Function

**Source:** `atloria-monorepo/apps/screenshot-worker/test/helpers/batch-builder.ts` (line 295)

Helper function to create a simple batch request

## Signature

```ts
function createSimpleBatch(urls: string[], options: {
    projectId?: string;
    organizationId?: string;
    config?: Partial<BatchConfigDto>;
  }): TakeBatchScreenshotsDto
```

## Parameters

| Name | Type |
|---|---|
| `urls` | `string[]` |
| `options` | `{
    projectId?: string;
    organizationId?: string;
    config?: Partial<BatchConfigDto>;
  }` |

**Returns:** `TakeBatchScreenshotsDto`

<!-- source: constant-default-loop-engine.md -->

# DEFAULT_LOOP_ENGINE

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/runtime-config.ts` (line 72)

Default loop engine. Set to 'live-swe' to use the Live-SWE-agent loop
(79% SWE-bench) by default, or 'openai-sdk' for the SDK-based loop.

Can be overridden per-call via RuntimeConfig.loop.engine or via
ATLORIA_LOOP_ENGINE environment variable.

## Definition

```ts
LoopConfig['engine']
```

<!-- source: graphql-mutation-deletepost.md -->

# deletePost

**Kind:** Graphql Mutation

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Delete a post

## Referenced By

- `Mutation` (CALLS_API)

<!-- source: api-endpoint-deleteuser.md -->

# deleteUser

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

Delete user

## Endpoint

`DELETE /users/{id}`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `User Management API` (IMPLEMENTS_API)

<!-- source: function-destroyallparsers.md -->

# destroyAllParsers

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/queue/processors/parser-registry.ts` (line 146)

Cleanup all parser instances

## Signature

```ts
async function destroyAllParsers(): Promise<void>
```

**Returns:** `Promise<void>`

<!-- source: class-djangotemplateparser.md -->

# DjangoTemplateParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/backend/django-template.parser.ts` (line 71)

Django Template Parser

Extracts entities and relationships from Django template files.

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: { rootDir: string })` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: class-documenteditpage.md -->

# DocumentEditPage

**Kind:** Class

**Source:** `atloria-monorepo/apps/web-e2e/src/pages/documents.page.ts` (line 141)

Document edit page object

**Extends:** `BasePage`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `goto` | `goto(documentId: string)` | `Promise<void>` |
| `setTitle` | `setTitle(title: string)` | `Promise<void>` |
| `getTitle` | `getTitle()` | `Promise<string>` |
| `setContent` | `setContent(content: string)` | `Promise<void>` |
| `getContent` | `getContent()` | `Promise<string>` |
| `waitForSave` | `waitForSave()` | `Promise<void>` |
| `clickDone` | `clickDone()` | `Promise<void>` |
| `setType` | `setType(type: string)` | `Promise<void>` |
| `setSlug` | `setSlug(slug: string)` | `Promise<void>` |
| `toggleAudience` | `toggleAudience(audience: string)` | `Promise<void>` |
| `openSettings` | `openSettings()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `titleInput` | `Locator` |
| `editor` | `Locator` |
| `saveStatus` | `Locator` |
| `doneButton` | `Locator` |
| `settingsButton` | `Locator` |
| `typeSelect` | `Locator` |
| `slugInput` | `Locator` |

<!-- source: enum-documenttype.md -->

# DocumentType

**Kind:** Enum

**Source:** `atloria-monorepo/packages/types/src/enums/index.ts` (line 20)

Document types define the nature of the documentation

## Values

- `MANUAL`
- `GENERATED`
- `HYBRID`
- `WIKI`
- `API_GUIDE`
- `USER_MANUAL`
- `SOP`

<!-- source: enum-entitytype-2.md -->

# EntityType

**Kind:** Enum

**Source:** `atloria-monorepo/apps/api/src/graph/interfaces/entity.interface.ts` (line 1)

## Values

- `FEATURE`
- `API`
- `COMPONENT`
- `USER_STORY`
- `BUG`
- `REQUIREMENT`
- `FUNCTION`
- `CLASS`
- `MODULE`

<!-- source: function-extractexportednamesfromdeclaration.md -->

# extractExportedNamesFromDeclaration

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 386)

Extract exported names from export declarations

## Signature

```ts
function extractExportedNamesFromDeclaration(path: NodePath<t.ExportNamedDeclaration | t.ExportDefaultDeclaration>): Set<string>
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath<t.ExportNamedDeclaration | t.ExportDefaultDeclaration>` |

**Returns:** `Set<string>`

<!-- source: type-faqlayout.md -->

# FaqLayout

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 18)

## Definition

```ts
'accordion' | 'two-column'
```

<!-- source: type-fetchfeaturesfn.md -->

# FetchFeaturesFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/query-product-knowledge.tool.ts` (line 31)

Fetch user-facing features for a project (from doc-automation Stage 3 output or KG).

## Definition

```ts
(
  projectId: string,
  options?: { limit?: number; minConfidence?: number },
) => Promise<ProductFeature[]>
```

<!-- source: constant-fixture-pages.md -->

# FIXTURE_PAGES

**Kind:** Constant

**Source:** `atloria-monorepo/apps/screenshot-worker/test/fixtures/pages/index.ts` (line 9)

Test fixture pages for screenshot testing

<!-- source: type-flowaction.md -->

# FlowAction

**Kind:** Type

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/flow-replay.dto.ts` (line 42)

## Definition

```ts
(typeof FLOW_ACTIONS)[number]
```

<!-- source: graphql-type-follow.md -->

# Follow

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Follow relationship

## Relationships

- TYPE_OF → `User`
- TYPE_OF → `User`
- TYPE_OF → `DateTime`

## Referenced By

- `followUser` (TYPE_OF)
- `newFollower` (TYPE_OF)
- `User` (TYPE_OF)
- `User` (TYPE_OF)

<!-- source: api-endpoint-getinfo.md -->

# getInfo

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/app.controller.ts` (line 19)

Service info endpoint

## Endpoint

`GET /info`

## Referenced By

- `AppController` (MODULE_DECLARES)

<!-- source: api-endpoint-getprojectjobs-2.md -->

# getProjectJobs

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/analysis/analysis.controller.ts` (line 74)

Get all analysis jobs for a project

GET /api/analysis/project/:projectId

Returns: [ { ...job }, { ...job } ]

## Endpoint

`GET /analysis/project/:projectId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `AnalysisController` (MODULE_DECLARES)

<!-- source: class-mdxgenerator.md -->

# MdxGenerator

**Kind:** Class

**Source:** `atloria-monorepo/apps/cli/src/generators/mdx.generator.ts` (line 82)

MDX Generator class
Generates MDX documentation from entities

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate()` | `Promise<void>` |
| `generateContent` | `generateContent()` | `Promise<{ pages: DocPage[]; navigation: NavItem[] }>` |

<!-- source: class-mdxparser.md -->

# MdxParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/config-docs-parser/src/parsers/mdx.parser.ts` (line 60)

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: class-nestjsparser.md -->

# NestjsParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/backend-parser/src/parsers/nestjs.parser.ts` (line 67)

NestJS Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: module-orchestratormodule.md -->

# OrchestratorModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/orchestrator.module.ts` (line 17)

## Relationships

- MODULE_IMPORTS → `queuemodule`
- MODULE_IMPORTS → `knowledgegraphmodule`
- MODULE_DECLARES → `orchestratorcontroller`
- MODULE_PROVIDES → `orchestratorservice`
- MODULE_EXPORTS → `orchestratorservice`

<!-- source: service-orchestratorservice.md -->

# OrchestratorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/orchestrator.service.ts` (line 43)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `dispatchParseJob` | `dispatchParseJob(options: {
    projectId: string;
    files: string[];
    parserType: string;
    config?: Record<string, unknown>;
    priority?: number;
  })` | `Promise<string>` |
| `parseProject` | `parseProject(config: ParseProjectConfig)` | `Promise<ProjectParseResult>` |
| `getJobStatus` | `getJobStatus(jobId: string)` | `Promise<JobStatus | null>` |
| `getResult` | `getResult(jobId: string)` | `Promise<ParseResult[] | null>` |
| `cancelJob` | `cancelJob(jobId: string)` | `Promise<boolean>` |
| `getQueueMetrics` | `getQueueMetrics()` | `unknown` |
| `getKGStatistics` | `getKGStatistics()` | `unknown` |
| `determineParser` | `determineParser(filePath: string)` | `string | null` |
| `getAvailableParsers` | `getAvailableParsers()` | `string[]` |
| `getParserPatterns` | `getParserPatterns(parser: string)` | `string[] | null` |

## Relationships

- DEPENDS_ON → `configservice`
- DEPENDS_ON → `queueservice`
- DEPENDS_ON → `knowledgegraphservice`
- DEPENDS_ON → `kgsyncservice`

<!-- source: enum-parsercategory-2.md -->

# ParserCategory

**Kind:** Enum

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/parser.interface.ts` (line 117)

Parser category for grouping

## Values

- `FRONTEND`
- `BACKEND`
- `DATABASE`
- `API_SCHEMA`
- `CONFIG`
- `DOCUMENTATION`
- `INFRASTRUCTURE`

<!-- source: class-parseresultdto.md -->

# ParseResultDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/dto/parse-job.dto.ts` (line 147)

DTO for parse result response

## Properties

| Property | Type |
|---|---|
| `jobId` | `string` |
| `status` | `string` |
| `entitiesCount` | `number` |
| `relationshipsCount` | `number` |
| `duration` | `number` |

<!-- source: enum-parsestatus.md -->

# ParseStatus

**Kind:** Enum

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/parse-result.interface.ts` (line 18)

Status of a parse operation

## Values

- `SUCCESS`
- `PARTIAL`
- `FAILED`
- `SKIPPED`
- `IN_PROGRESS`
- `QUEUED`

<!-- source: controller-pdfcontroller.md -->

# PdfController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/pdf/pdf.controller.ts` (line 16)

## Relationships

- MODULE_DECLARES → `renderPdf`
- DEPENDS_ON → `pdfservice`

<!-- source: module-playwrightmodule.md -->

# PlaywrightModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/playwright/playwright.module.ts` (line 4)

## Relationships

- MODULE_PROVIDES → `playwrightservice`
- MODULE_EXPORTS → `playwrightservice`

<!-- source: constant-pme-job-options.md -->

# PME_JOB_OPTIONS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/pme-agent/src/queue/constants.ts` (line 3)

<!-- source: class-pmeturnhook.md -->

# PmeTurnHook

**Kind:** Class

**Source:** `atloria-monorepo/libs/pme-core/src/context/pme-turn-hook.ts` (line 127)

**Implements:** `TurnHook`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `beforeModelCall` | `beforeModelCall(args: TurnHookArgs<PmeContext>)` | `Promise<{ instructions?: string; input?: unknown[] }>` |

## Properties

| Property | Type |
|---|---|
| `compactionLog` | `Array<{
    turn: number;
    beforeTokens: number;
    afterTokens: number;
    truncatedResults: number;
  }>` |

<!-- source: constant-project-fixtures.md -->

# PROJECT_FIXTURES

**Kind:** Constant

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 28)

Project fixture paths

<!-- source: component-stepcircle.md -->

# StepCircle

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/how-it-works/how-it-works-timeline.tsx` (line 43)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `num` | `number` | ✓ | - |
| `variant` | `unknown | unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StepCircle_5a4f7255["StepCircle"]
    class component_StepCircle_5a4f7255 rootComponent
```

## Referenced By

- `HowItWorksTimeline` (RENDERS)

<!-- source: interface-testcollaborationsession.md -->

# TestCollaborationSession

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 202)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `documentId` | `string` |
| `users` | `{
    id: string;
    name: string;
    color: string;
    cursor?: { x: number; y: number };
  }[]` |
| `createdAt` | `string` |

<!-- source: class-typeormparser.md -->

# TypeORMParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/database-parser/src/parsers/typeorm.parser.ts` (line 25)

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: graphql-query-user.md -->

# user

**Kind:** Graphql Query

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Get a user by ID

## Relationships

- TYPE_OF → `User`

## Referenced By

- `Query` (CALLS_API)

<!-- source: component-userprofile.md -->

# UserProfile

**Kind:** Component

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/frontend/src/components/UserProfile.tsx` (line 33)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `userId` | `any` | ✓ | - |
| `showStats` | `any` | - | true |
| `onProfileLoad` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_UserProfile_131907c4["UserProfile"]
    class component_UserProfile_131907c4 rootComponent
```

## Relationships

- RENDERS → `LoadingSpinner`
- RENDERS → `Avatar`
- RENDERS → `StatCard`
- USES_HOOK → `useAuth`
- USES_HOOK → `useState`
- USES_HOOK → `useQuery`
- USES_HOOK → `useEffect`

<!-- source: constant-variant-styles.md -->

# VARIANT_STYLES

**Kind:** Constant

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/variant.prompts.ts` (line 18)

## Definition

```ts
VariantStyle[]
```

<!-- source: component-videoembed.md -->

# VideoEmbed

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 471)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `embedUrl` | `string` | ✓ | - |
| `provider` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_VideoEmbed_432f8f5f["VideoEmbed"]
    class component_VideoEmbed_432f8f5f rootComponent
```

## Referenced By

- `CustomDiv` (RENDERS)
- `CustomLink` (RENDERS)
- `CustomImage` (RENDERS)

<!-- source: class-vueparser.md -->

# VueParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/frontend-parser/src/parsers/vue.parser.ts` (line 76)

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `supportedPatterns` | `string[]` |

<!-- source: function-iscodeblocknode.md -->

# $isCodeBlockNode

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/CodeBlockNode.tsx` (line 284)

## Signature

```ts
function $isCodeBlockNode(node: LexicalNode | null | undefined): node is CodeBlockNode
```

## Parameters

| Name | Type |
|---|---|
| `node` | `LexicalNode | null | undefined` |

**Returns:** `node is CodeBlockNode`

<!-- source: component-actionbutton.md -->

# ActionButton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/common/ErrorState.tsx` (line 84)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `href` | `string` | ✓ | - |
| `label` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ActionButton_9f189["ActionButton"]
    class component_ActionButton_9f189 rootComponent
```

## Relationships

- USES_HOOK → `useRouter`

## Referenced By

- `ErrorContent` (RENDERS)
- `ErrorState` (RENDERS)

<!-- source: constant-addactiveplugin.md -->

# addActivePlugin$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 917)

Add a plugin name to the list of active plugins.

<!-- source: api-endpoint-addcolumn.md -->

# addColumn

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 93)

## Endpoint

`POST /projects/:projectId/boards/:boardId/columns`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `boardId` | query | `string` | ✓ |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: interface-agentexecutionresult.md -->

# AgentExecutionResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/support-agent/agent-adapter.service.ts` (line 35)

## Properties

| Property | Type |
|---|---|
| `response` | `string` |
| `toolCalls` | `Array<{ tool: string; input: any; result: any }>` |

<!-- source: interface-agentmodelsettings.md -->

# AgentModelSettings

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 35)

## Properties

| Property | Type |
|---|---|
| `temperature` | `number` |
| `topP` | `number` |
| `maxTokens` | `number` |
| `frequencyPenalty` | `number` |
| `presencePenalty` | `number` |
| `toolChoice` | `'auto' | 'required' | 'none'` |
| `parallelToolCalls` | `boolean` |
| `reasoningEffort` | `'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh'` |

<!-- source: type-agentprotocoleventtype.md -->

# AgentProtocolEventType

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/protocol/agent-protocol.ts` (line 82)

All canonical protocol event names

## Definition

```ts
keyof AgentProtocolEventMap
```

<!-- source: interface-aggregatedresult.md -->

# AggregatedResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/batched-screenshot-processor.ts` (line 56)

## Properties

| Property | Type |
|---|---|
| `totalCaptured` | `number` |
| `totalFailed` | `number` |
| `totalReplaced` | `number` |
| `totalDocumentsUpdated` | `number` |
| `batchesCompleted` | `number` |
| `totalBatches` | `number` |
| `cancelled` | `boolean` |

<!-- source: service-aicostratelimitguard.md -->

# AiCostRateLimitGuard

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/guards/ai-cost-rate-limit.guard.ts` (line 14)

Rate limit for COST-BEARING AI endpoints (/ask, /mcp, /assist, /rag/index, /enrich).
Each request spends real money (embedding + gpt-5.5), and /ask + /mcp are reachable
ANONYMOUSLY on public projects — so unlike the per-user AI guard this one:
 - keys by userId when authenticated, else by client IP (anonymous still limited)
 - never fails open to unlimited: when Redis is unavailable it falls back to a
   per-instance in-memory window (weaker, but bounded) instead of waving traffic through.

`AiCostRateLimitGuard` is a NestJS guard that rate-limits **cost-bearing AI endpoints** (e.g. `/ask`, `/mcp`, `/assist`, `/rag/index`, `/enrich`) to control real spend from embeddings and LLM calls. It keys limits by `userId` when authenticated, otherwise by **client IP** so anonymous access on public projects is still bounded. If Redis is unavailable, it **does not fail open**—it falls back to a per-instance in-memory window to keep traffic limited.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `canActivate` | `canActivate(context: ExecutionContext)` | `Promise<boolean>` |
| `onModuleDestroy` | `onModuleDestroy()` | `unknown` |

## Diagram

```mermaid
sequenceDiagram
  participant Client
  participant Controller
  participant Guard as AiCostRateLimitGuard
  participant Redis
  participant Memory as InMemoryWindow
  participant AI as AI Provider (Embeddings/LLM)

  Client->>Controller: HTTP request to cost-bearing endpoint
  Controller->>Guard: canActivate(context)

  alt Authenticated
    Guard->>Guard: key = userId
  else Anonymous (public project)
    Guard->>Guard: key = client IP
  end

  Guard->>Redis: increment/check window(key)
  alt Redis available + under limit
    Redis-->>Guard: allow
    Guard-->>Controller: proceed
    Controller->>AI: perform embedding/LLM call
    AI-->>Controller: response
    Controller-->>Client: 200 OK
  else Redis available + over limit
    Redis-->>Guard: deny
    Guard-->>Client: 429 Too Many Requests
  else Redis unavailable
    Guard->>Memory: increment/check window(key)
    alt under limit
      Memory-->>Guard: allow
      Guard-->>Controller: proceed
      Controller->>AI: perform embedding/LLM call
      AI-->>Controller: response
      Controller-->>Client: 200 OK
    else over limit
      Memory-->>Guard: deny
      Guard-->>Client: 429 Too Many Requests
    end
  end
```

## Usage

```ts
import { Controller, Post, UseGuards, Body } from '@nestjs/common';
import { AiCostRateLimitGuard } from '../technical-docs/guards/ai-cost-rate-limit.guard';

@Controller()
export class AskController {
  // Apply guard to a cost-bearing endpoint
  @Post('/ask')
  @UseGuards(AiCostRateLimitGuard)
  async ask(@Body() body: { prompt: string }) {
    // If this runs, the request has passed rate limiting.
    // Perform your embedding + LLM call here.
    return { answer: `You asked: ${body.prompt}` };
  }
}

// Alternatively, apply at the controller level:
// @UseGuards(AiCostRateLimitGuard)
// @Controller('/mcp')
// export class McpController { ... }
```

## AI Coding Instructions

- Preserve the **keying strategy**: use `userId` when authenticated; otherwise fall back to **client IP** so anonymous usage is still rate-limited.
- Never change behavior to **fail open** on Redis errors; keep the **in-memory fallback** bounded to prevent unlimited spend during outages.
- Ensure the guard is applied only to **cost-bearing** routes; don’t blanket-apply to non-AI endpoints unless you intend to throttle them too.
- When integrating behind proxies/CDNs, confirm the **true client IP extraction** is correct (e.g., trusted proxy headers) to avoid mis-keying or over-throttling.

## Relationships

- DEPENDS_ON → `configservice`

<!-- source: interface-aiusagestats.md -->

# AIUsageStats

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/types/ai.ts` (line 27)

## Properties

| Property | Type |
|---|---|
| `totalRequests` | `number` |
| `requestsToday` | `number` |
| `requestsThisWeek` | `number` |
| `requestsThisMonth` | `number` |
| `tokenUsage` | `{
    total: number;
    today: number;
    thisWeek: number;
    thisMonth: number;
  }` |
| `topProvider` | `AIProviderName` |
| `lastRequestAt` | `Date` |

<!-- source: controller-analyticscontroller.md -->

# AnalyticsController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 9)

## Relationships

- MODULE_DECLARES → `track`
- MODULE_DECLARES → `getOverview`
- MODULE_DECLARES → `getVersionTraffic`
- MODULE_DECLARES → `getTopDocuments`
- MODULE_DECLARES → `getTopSearchQueries`
- MODULE_DECLARES → `getDailyTraffic`
- MODULE_DECLARES → `getDeviceBreakdown`
- MODULE_DECLARES → `getSourceBreakdown`
- MODULE_DECLARES → `getGeoBreakdown`
- MODULE_DECLARES → `getZeroResultSearches`
- MODULE_DECLARES → `getGhostDocs`
- MODULE_DECLARES → `getTrendingDocs`
- MODULE_DECLARES → `getScrollHistogram`
- MODULE_DECLARES → `submitFeedback`
- MODULE_DECLARES → `getFeedbackSummary`
- DEPENDS_ON → `analyticsservice`
- DEPENDS_ON → `feedbackservice`

<!-- source: function-analyzevuetemplate.md -->

# analyzeVueTemplate

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/template-analyzer.ts` (line 609)

Analyze Vue template section

## Signature

```ts
function analyzeVueTemplate(templateContent: string): TemplateAnalysis
```

## Parameters

| Name | Type |
|---|---|
| `templateContent` | `string` |

**Returns:** `TemplateAnalysis`

<!-- source: class-anthropicmodel.md -->

# AnthropicModel

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/anthropic-adapter.ts` (line 107)

**Implements:** `Model`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getResponse` | `getResponse(request: ModelRequest)` | `Promise<ModelResponse>` |
| `getStreamedResponse` | `getStreamedResponse(request: ModelRequest)` | `AsyncIterable<import('@openai/agents').ResponseStreamEvent>` |
| `getRetryAdvice` | `getRetryAdvice(args: ModelRetryAdviceRequest)` | `ModelRetryAdvice | undefined` |

<!-- source: class-apierror-2.md -->

# APIError

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/types/errors.ts` (line 4)

Base API error class

**Extends:** `Error`

<!-- source: interface-apiflowdiagramresult.md -->

# APIFlowDiagramResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/api-flow-diagram.generator.ts` (line 68)

Result of API flow diagram generation

## Properties

| Property | Type |
|---|---|
| `mermaidCode` | `string` |
| `stats` | `{
    /** Number of frontend callers */
    callerCount: number;
    /** Number of services involved */
    serviceCount: number;
    /** Number of database models accessed */
    modelCount: number;
    /** Total nodes in diagram */
    totalNodes: number;
    /** Total edges/relationships */
    totalEdges: number;
  }` |
| `cssClasses` | `string[]` |

<!-- source: module-appmodule-3.md -->

# AppModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/app/app.module.ts` (line 54)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `throttlingmodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `githubmodule`
- MODULE_IMPORTS → `gitlabmodule`
- MODULE_IMPORTS → `bitbucketmodule`
- MODULE_IMPORTS → `gatewaymodule`
- MODULE_IMPORTS → `collaborationmodule`
- MODULE_IMPORTS → `activitymodule`
- MODULE_IMPORTS → `notificationmodule`
- MODULE_IMPORTS → `assetsmodule`
- MODULE_IMPORTS → `audiencemodule`
- MODULE_IMPORTS → `commentmodule`
- MODULE_IMPORTS → `suggestionmodule`
- MODULE_IMPORTS → `documentmodule`
- MODULE_IMPORTS → `documentationmodule`
- MODULE_IMPORTS → `templatemodule`
- MODULE_IMPORTS → `projectmodule`
- MODULE_IMPORTS → `organizationmodule`
- MODULE_IMPORTS → `invitationmodule`
- MODULE_IMPORTS → `dashboardmodule`
- MODULE_IMPORTS → `aimodule`
- MODULE_IMPORTS → `billingmodule`
- MODULE_IMPORTS → `parsermodule`
- MODULE_IMPORTS → `parsingmodule`
- MODULE_IMPORTS → `graphmodule`
- MODULE_IMPORTS → `screenshotmodule`
- MODULE_IMPORTS → `technicaldocsmodule`
- MODULE_IMPORTS → `eventsmodule`
- MODULE_IMPORTS → `githubappmodule`
- MODULE_IMPORTS → `trialmodule`
- MODULE_IMPORTS → `opsmodule`
- MODULE_IMPORTS → `supportagentmodule`
- MODULE_IMPORTS → `pmemodule`
- MODULE_IMPORTS → `agentmodule`
- MODULE_IMPORTS → `docversionmodule`
- MODULE_IMPORTS → `webhookmodule`
- MODULE_IMPORTS → `analyticsmodule`
- MODULE_IMPORTS → `auditmodule`
- MODULE_IMPORTS → `brandingmodule`
- MODULE_IMPORTS → `issuesmodule`
- MODULE_IMPORTS → `boardsmodule`
- MODULE_IMPORTS → `manualsinsightsmodule`
- MODULE_IMPORTS → `capturemodule`
- MODULE_DECLARES → `appcontroller`
- MODULE_PROVIDES → `appservice`

<!-- source: constant-architecturedecisionrecordtemplate.md -->

# architectureDecisionRecordTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/architecture-decision-record.template.ts` (line 3)

<!-- source: type-audiencelogictree.md -->

# AudienceLogicTree

**Kind:** Type

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 98)

Audience logic expression tree
Used for evaluating complex audience conditions

## Definition

```ts
AudienceLeaf | AudienceNotNode | AudienceAndNode | AudienceOrNode
```

<!-- source: graphql-type-authpayload.md -->

# AuthPayload

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Authentication payload

## Relationships

- TYPE_OF → `User`

## Referenced By

- `login` (TYPE_OF)
- `refreshToken` (TYPE_OF)

<!-- source: class-authresponsedto.md -->

# AuthResponseDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/auth/dto/auth-response.dto.ts` (line 50)

## Properties

| Property | Type |
|---|---|
| `accessToken` | `string` |
| `refreshToken` | `string` |
| `tokenType` | `any` |
| `expiresIn` | `number` |
| `user` | `UserResponseDto` |

<!-- source: interface-authstate.md -->

# AuthState

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/frontend/src/hooks/useAuth.ts` (line 10)

## Properties

| Property | Type |
|---|---|
| `isAuthenticated` | `boolean` |
| `user` | `{ id: string; email: string } | null` |
| `token` | `string | null` |

<!-- source: class-batchscreenshotjobresponsedto.md -->

# BatchScreenshotJobResponseDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 673)

Initial response after creating a batch screenshot job

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `status` | `JobStatus` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `name` | `string` |
| `totalUrls` | `number` |
| `capturedUrls` | `number` |
| `failedUrls` | `number` |
| `progress` | `number` |
| `createdAt` | `Date` |
| `updatedAt` | `Date` |
| `completedAt` | `Date` |
| `error` | `string` |

<!-- source: service-batchscreenshotservice.md -->

# BatchScreenshotService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/batch-screenshot.service.ts` (line 87)

Service for batch screenshot processing

Orchestrates:
- Parallel task execution with concurrency limits
- Authentication session management
- Retry logic with exponential backoff
- Progress tracking and caching
- Content deduplication

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createJob` | `createJob(request: TakeBatchScreenshotsDto)` | `Promise<BatchScreenshotJobResponseDto>` |
| `processBatch` | `processBatch(request: TakeBatchScreenshotsDto)` | `Promise<BatchScreenshotJobResponseDto>` |
| `getJobStatus` | `getJobStatus(jobId: string, organizationId: string)` | `Promise<BatchScreenshotStatusDto | null>` |

## Relationships

- DEPENDS_ON → `playwrightservice`
- DEPENDS_ON → `storageservice`
- DEPENDS_ON → `screenshotmetadataservice`
- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `redisservice`
- DEPENDS_ON → `retryhandlerservice`
- DEPENDS_ON → `actionexecutorservice`
- DEPENDS_ON → `stateresolverservice`
- DEPENDS_ON → `authcontextservice`
- DEPENDS_ON → `pagesettleservice`
- DEPENDS_ON → `configservice`
- DEPENDS_ON → `discoveryservice`

<!-- source: function-benchruncommand.md -->

# benchRunCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/bench.command.ts` (line 49)

## Signature

```ts
async function benchRunCommand(options: BenchRunOptions): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `BenchRunOptions` |

**Returns:** `Promise<void>`

<!-- source: interface-boxpct-2.md -->

# BoxPct

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/annotation-emitter.service.ts` (line 6)

Target box as PERCENT (0-100) of the natural image, top-left origin.

## Properties

| Property | Type |
|---|---|
| `x` | `number` |
| `y` | `number` |
| `w` | `number` |
| `h` | `number` |

<!-- source: function-breachof.md -->

# breachOf

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 242)

## Signature

```ts
function breachOf(v: CountValue | undefined): number
```

## Parameters

| Name | Type |
|---|---|
| `v` | `CountValue | undefined` |

**Returns:** `number`

<!-- source: function-buildautonomousinstructions.md -->

# buildAutonomousInstructions

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/autonomous-loop.ts` (line 94)

Build the autonomous investigation-verify loop instructions.

This generates a system prompt section — not a complete system prompt.
Domain layers combine it with their own base instructions + tool usage guide.

The prompt teaches the agent to:
1. Investigate before acting (read files, explore structure, check config)
2. Prefer existing tools/scripts over writing from scratch
3. Plan based on what it discovers (not on assumptions)
4. Verify after every significant action
5. Loop until quality gates pass

## Signature

```ts
function buildAutonomousInstructions(options: AutonomousInstructionsOptions): string
```

## Parameters

| Name | Type |
|---|---|
| `options` | `AutonomousInstructionsOptions` |

**Returns:** `string`

<!-- source: function-buildcompleteprompt.md -->

# buildCompletePrompt

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/support-agent/prompts/rag-context-formatter.ts` (line 159)

Builds the complete prompt for the AI

## Signature

```ts
function buildCompletePrompt(systemPrompt: string, ragContext: FormattedRagContext, conversationHistory: Array<{ role: string; content: string }>, userMessage: string, projectName: string): string
```

## Parameters

| Name | Type |
|---|---|
| `systemPrompt` | `string` |
| `ragContext` | `FormattedRagContext` |
| `conversationHistory` | `Array<{ role: string; content: string }>` |
| `userMessage` | `string` |
| `projectName` | `string` |

**Returns:** `string`

<!-- source: function-buildlayouttaskprompt.md -->

# buildLayoutTaskPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/layout.prompts.ts` (line 36)

## Signature

```ts
function buildLayoutTaskPrompt(sectionType: SectionType, contentJson: string): string
```

## Parameters

| Name | Type |
|---|---|
| `sectionType` | `SectionType` |
| `contentJson` | `string` |

**Returns:** `string`

<!-- source: constant-categorylabels.md -->

# categoryLabels

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/constants/templateCategories.ts` (line 7)

Human-readable labels for template categories
Used across template components for consistent display

## Definition

```ts
Record<TemplateCategory, string>
```

<!-- source: component-celleditor.md -->

# CellEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/table/TableEditor.tsx` (line 340)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `focus` | `any` | ✓ | - |
| `setActiveCell` | `any` | ✓ | - |
| `parentEditor` | `any` | ✓ | - |
| `lexicalTable` | `any` | ✓ | - |
| `contents` | `any` | ✓ | - |
| `colIndex` | `any` | ✓ | - |
| `rowIndex` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CellEditor_79b7a9f9["CellEditor"]
    class component_CellEditor_79b7a9f9 rootComponent
```

## Relationships

- RENDERS → `LexicalNestedComposer`
- RENDERS → `RichTextPlugin`
- RENDERS → `ContentEditable`
- RENDERS → `Child`
- RENDERS → `HistoryPlugin`
- USES_HOOK → `useCellValues`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

## Referenced By

- `Cell` (RENDERS)

<!-- source: type-changetype.md -->

# ChangeType

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/document/services/document-revision.service.ts` (line 17)

## Definition

```ts
'CREATE' | 'UPDATE' | 'RESTORE'
```

<!-- source: function-checkfocusvisibility.md -->

# checkFocusVisibility

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/accessibility.ts` (line 154)

Check focus visibility

## Signature

```ts
async function checkFocusVisibility(page: Page): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |

**Returns:** `Promise<void>`

<!-- source: interface-comparisonfeaturetableprops.md -->

# ComparisonFeatureTableProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/comparison/comparison-feature-table.tsx` (line 14)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `columns` | `{ nameKey: string; highlighted?: boolean }[]` |
| `features` | `{ featureKey: string; values: (boolean | string)[] }[]` |

<!-- source: interface-copywriterdependencies.md -->

# CopywriterDependencies

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/agents/copywriter.agent.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `searchFn` | `DocSearchFn` |
| `generateFn` | `ContentGenerateFn` |

<!-- source: function-createassemblesitetool.md -->

# createAssembleSiteTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/assemble-site.tool.ts` (line 13)

## Signature

```ts
function createAssembleSiteTool(templateDir: string, componentLibraryDir: string): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `templateDir` | `string` |
| `componentLibraryDir` | `string` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: type-createuser.md -->

# CreateUser

**Kind:** Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

## Properties

| Property | Type |
|---|---|
| `email` | `string` |
| `password` | `string` |
| `name` | `string` |

## Referenced By

- `createUser` (REFERENCES)
- `User Management API` (TYPE_OF)

<!-- source: function-cropbuffer.md -->

# cropBuffer

**Kind:** Function

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/crop.service.ts` (line 111)

Extract a pixel region from an encoded image buffer using sharp.
Returns the cropped image as a new buffer (original untouched).

## Signature

```ts
async function cropBuffer(buffer: Buffer, clip: ClipRect): Promise<Buffer>
```

## Parameters

| Name | Type |
|---|---|
| `buffer` | `Buffer` |
| `clip` | `ClipRect` |

**Returns:** `Promise<Buffer>`

<!-- source: type-csfversion.md -->

# CSFVersion

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/storybook/types.ts` (line 9)

TypeScript types for Component Story Format (CSF) parsing
Supports both CSF 2.0 (Ladle) and CSF 3.0 (Storybook 7+)

## Definition

```ts
'2.0' | '3.0' | 'unknown'
```

<!-- source: interface-dataprovider.md -->

# DataProvider

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/providers/data-provider.interface.ts` (line 47)

Data provider interface
Abstracts fetching entities from file system or API

<!-- source: graphql-mutation-deleteuser.md -->

# deleteUser

**Kind:** Graphql Mutation

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Delete a user (admin only)

## Referenced By

- `Mutation` (CALLS_API)

<!-- source: type-deskaction.md -->

# DeskAction

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 96)

## Definition

```ts
| 'accept'
  | 'investigating'
  | 'waiting'
  | 'snooze'
  | 'wake'
  | 'done'
  | 'reopen'
  | 'decline'
```

<!-- source: api-endpoint-detectparser.md -->

# detectParser

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/orchestrator.controller.ts` (line 200)

Determine parser for a file

## Endpoint

`GET /api/orchestrator/parsers/detect`

| Parameter | In | Type | Required |
|---|---|---|---|
| `filePath` | query | `string` | ✓ |

## Referenced By

- `OrchestratorController` (MODULE_DECLARES)

<!-- source: service-docplannerservice.md -->

# DocPlannerService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-09-planning/doc-planner.service.ts` (line 1)

<!-- source: class-docsmcptoolset.md -->

# DocsMcpToolset

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/mcp-toolset.ts` (line 53)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `toolDefinitions` | `toolDefinitions()` | `McpToolDef[]` |
| `call` | `call(name: string, args: Record<string, any>)` | `Promise<unknown>` |
| `searchDocs` | `searchDocs(query: string, limit: undefined)` | `DocSearchHit[]` |
| `readPage` | `readPage(path: string)` | `{ title: string; path: string; markdown: string } | null` |
| `listPages` | `listPages(section: string)` | `Array<{ title: string; path: string; section?: string }>` |
| `getEntity` | `getEntity(nameOrId: string)` | `{ entity: Entity; relationships: Array<{ direction: 'out' | 'in'; type: string; entity: string }>; source?: string } | null` |
| `searchEntities` | `searchEntities(query: string, kind: string)` | `Array<{ id: string; name: string; type: string }>` |
| `listEndpoints` | `listEndpoints(tag: string)` | `Array<{ method: string; path: string; summary: string }>` |
| `askQuestion` | `askQuestion(question: string)` | `Promise<{ answer: string; citations: string[] }>` |
| `callOperation` | `callOperation(args: Record<string, any>)` | `Promise<unknown>` |

<!-- source: class-documentspage.md -->

# DocumentsPage

**Kind:** Class

**Source:** `atloria-monorepo/apps/web-e2e/src/pages/documents.page.ts` (line 7)

Documents list page object

**Extends:** `BasePage`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `goto` | `goto()` | `Promise<void>` |
| `getDocumentCards` | `getDocumentCards()` | `Locator` |
| `getDocumentByTitle` | `getDocumentByTitle(title: string)` | `Locator` |
| `search` | `search(query: string)` | `Promise<void>` |
| `clearSearch` | `clearSearch()` | `Promise<void>` |
| `clickNewDocument` | `clickNewDocument()` | `Promise<void>` |
| `openDocument` | `openDocument(title: string)` | `Promise<void>` |
| `editDocument` | `editDocument(title: string)` | `Promise<void>` |
| `deleteDocument` | `deleteDocument(title: string)` | `Promise<void>` |
| `getDocumentCount` | `getDocumentCount()` | `Promise<number>` |
| `isEmpty` | `isEmpty()` | `Promise<boolean>` |
| `filterByType` | `filterByType(type: string)` | `Promise<void>` |
| `sortBy` | `sortBy(option: string)` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `newDocumentButton` | `Locator` |
| `searchInput` | `Locator` |
| `documentList` | `Locator` |
| `filterDropdown` | `Locator` |
| `sortDropdown` | `Locator` |
| `emptyState` | `Locator` |

<!-- source: enum-entitytype-4.md -->

# EntityType

**Kind:** Enum

**Source:** `atloria-monorepo/packages/types/src/enums/index.ts` (line 74)

Entity types in the Knowledge Graph

## Values

- `SCREEN`
- `COMPONENT`
- `API`
- `FLOW`
- `DB_ENTITY`
- `ROUTE`

<!-- source: function-extracthooksfrompath.md -->

# extractHooksFromPath

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 273)

Extract hooks used within a function path

## Signature

```ts
function extractHooksFromPath(path: NodePath): HookInfo[]
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath` |

**Returns:** `HookInfo[]`

<!-- source: type-featureslayout.md -->

# FeaturesLayout

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 13)

## Definition

```ts
'grid' | 'alternating' | 'bento' | 'compact'
```

<!-- source: type-fetchscreenshotsfn.md -->

# FetchScreenshotsFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/query-product-knowledge.tool.ts` (line 65)

Fetch product screenshots, optionally filtered.

## Definition

```ts
(
  projectId: string,
  options?: {
    featureArea?: string;
    pageType?: string;
    viewport?: string;
    limit?: number;
  },
) => Promise<ProductScreenshot[]>
```

<!-- source: constant-flow-actions.md -->

# FLOW_ACTIONS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/flow-replay.dto.ts` (line 41)

Recorded actions (mirror api `CAPTURE_ACTIONS` in create-flow.dto.ts).
These are mapped to Playwright actions by the FlowReplayService.

<!-- source: type-format.md -->

# Format

**Kind:** Type

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 543)

## Definition

```ts
typeof FORMATS[number]
```

<!-- source: function-generatelargeprismaschema.md -->

# generateLargePrismaSchema

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 292)

Generate large Prisma schema for testing

## Signature

```ts
function generateLargePrismaSchema(modelCount: number): string
```

## Parameters

| Name | Type |
|---|---|
| `modelCount` | `number` |

**Returns:** `string`

<!-- source: api-endpoint-getjobstatus-2.md -->

# getJobStatus

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/batch-screenshot.controller.ts` (line 239)

Get batch job status and results

GET /api/screenshot/batch/:jobId/status?organizationId=uuid

Poll this endpoint to track progress and retrieve results.

## Endpoint

`GET /screenshot/batch/:jobId/status`

| Parameter | In | Type | Required |
|---|---|---|---|
| `jobId` | query | `string` | ✓ |
| `organizationId` | query | `string` | ✓ |

## Referenced By

- `BatchScreenshotController` (MODULE_DECLARES)

<!-- source: constant-gpt4-standard-profile.md -->

# GPT4_STANDARD_PROFILE

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-profiles.ts` (line 145)

GPT-4.x family (gpt-4o, gpt-4-turbo, gpt-4.1, etc.)
Standard OpenAI models — no reasoning effort, temperature supported.

## Definition

```ts
ModelCapabilityProfile
```

<!-- source: enum-parsejobstatus.md -->

# ParseJobStatus

**Kind:** Enum

**Source:** `atloria-monorepo/apps/api/src/parsing/dto/parse-status.dto.ts` (line 3)

## Values

- `QUEUED`
- `CLONING`
- `PARSING`
- `SYNCING`
- `COMPLETED`
- `FAILED`

<!-- source: enum-parsestatus-2.md -->

# ParseStatus

**Kind:** Enum

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/parse-result.interface.ts` (line 18)

Status of a parse operation

## Values

- `SUCCESS`
- `PARTIAL`
- `FAILED`
- `SKIPPED`
- `IN_PROGRESS`
- `QUEUED`

<!-- source: constant-pme-queue-name.md -->

# PME_QUEUE_NAME

**Kind:** Constant

**Source:** `atloria-monorepo/apps/pme-agent/src/queue/constants.ts` (line 1)

<!-- source: module-queuemodule.md -->

# QueueModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/queue/queue.module.ts` (line 19)

## Relationships

- MODULE_PROVIDES → `queueservice`
- MODULE_PROVIDES → `parseprocessor`
- MODULE_EXPORTS → `queueservice`

<!-- source: service-queueservice.md -->

# QueueService

**Kind:** Service

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/queue/queue.service.ts` (line 18)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `addParseJob` | `addParseJob(payload: Omit<ParseJobPayload, 'jobId' | 'createdAt'>, priority: unknown)` | `Promise<string>` |
| `addParseJobsBulk` | `addParseJobsBulk(payloads: Array<Omit<ParseJobPayload, 'jobId' | 'createdAt'>>)` | `Promise<string[]>` |
| `getJobStatus` | `getJobStatus(jobId: string)` | `Promise<JobStatus | null>` |
| `getJobResult` | `getJobResult(jobId: string)` | `Promise<T | null>` |
| `waitForJob` | `waitForJob(jobId: string, timeout: unknown)` | `Promise<T>` |
| `cancelJob` | `cancelJob(jobId: string)` | `Promise<boolean>` |
| `getMetrics` | `getMetrics()` | `Promise<QueueMetrics>` |
| `getWaitingJobs` | `getWaitingJobs(start: unknown, end: unknown)` | `Promise<Job<ParseJobPayload>[]>` |
| `getActiveJobs` | `getActiveJobs()` | `Promise<Job<ParseJobPayload>[]>` |
| `getFailedJobs` | `getFailedJobs(start: unknown, end: unknown)` | `Promise<Job<ParseJobPayload>[]>` |
| `retryJob` | `retryJob(jobId: string)` | `Promise<void>` |
| `cleanCompleted` | `cleanCompleted(grace: unknown)` | `Promise<void>` |
| `cleanFailed` | `cleanFailed(grace: unknown)` | `Promise<void>` |
| `pause` | `pause()` | `Promise<void>` |
| `resume` | `resume()` | `Promise<void>` |
| `isPaused` | `isPaused()` | `Promise<boolean>` |

## Relationships

- DEPENDS_ON → `queue`

<!-- source: enum-relationshiptype.md -->

# RelationshipType

**Kind:** Enum

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/relationship.interface.ts` (line 15)

Relationship Interfaces

Defines all relationship types between entities.
Relationships describe how code entities connect and interact.

## Values

- `RENDERS`
- `USES_HOOK`
- `USES_CONTEXT`
- `PROVIDES_CONTEXT`
- `USES_STORE`
- `DISPATCHES_ACTION`
- `CALLS_API`
- `IMPLEMENTS_API`
- `DEPENDS_ON`
- `USES_SERVICE`
- `INJECTS`
- `QUERIES_MODEL`
- `HAS_ONE`
- `HAS_MANY`
- `BELONGS_TO`
- `MANY_TO_MANY`
- `REFERENCES_MODEL`
- `IMPORTS`
- `EXTENDS`
- `IMPLEMENTS`
- `TYPE_OF`
- `CALLS`
- `EXPORTS`
- `RE_EXPORTS`
- `MODULE_IMPORTS`
- `MODULE_PROVIDES`
- `MODULE_EXPORTS`
- `MODULE_DECLARES`
- `DOCUMENTS`
- `REFERENCES`
- `LINKS_TO`
- `DEPLOYED_TO`
- `CONNECTS_TO`
- `CONTAINER_DEPENDS_ON`
- `EXPOSES_PORT`
- `USES_ENV`
- `USES_CONFIG`
- `REQUIRES_FEATURE`
- `TESTS`
- `MOCKS`

<!-- source: constant-sample-projects-path.md -->

# SAMPLE_PROJECTS_PATH

**Kind:** Constant

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 23)

<!-- source: controller-screenshotcontroller.md -->

# ScreenshotController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.controller.ts` (line 176)

## Relationships

- MODULE_DECLARES → `takeScreenshot`
- MODULE_DECLARES → `takeResponsiveScreenshots`
- MODULE_DECLARES → `takeAuthenticatedScreenshot`
- MODULE_DECLARES → `takeSmartAuthenticatedScreenshot`
- DEPENDS_ON → `screenshotservice`

<!-- source: module-screenshotmodule.md -->

# ScreenshotModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.module.ts` (line 20)

## Relationships

- MODULE_IMPORTS → `playwrightmodule`
- MODULE_IMPORTS → `storagemodule`
- MODULE_IMPORTS → `discoverymodule`
- MODULE_DECLARES → `screenshotcontroller`
- MODULE_DECLARES → `batchscreenshotcontroller`
- MODULE_PROVIDES → `screenshotservice`
- MODULE_PROVIDES → `screenshotmetadataservice`
- MODULE_PROVIDES → `retryhandlerservice`
- MODULE_PROVIDES → `actionexecutorservice`
- MODULE_PROVIDES → `stateresolverservice`
- MODULE_PROVIDES → `authcontextservice`
- MODULE_PROVIDES → `pagesettleservice`
- MODULE_PROVIDES → `annotationemitterservice`
- MODULE_PROVIDES → `batchscreenshotservice`
- MODULE_PROVIDES → `flowreplayservice`
- MODULE_EXPORTS → `screenshotservice`
- MODULE_EXPORTS → `screenshotmetadataservice`
- MODULE_EXPORTS → `batchscreenshotservice`
- MODULE_EXPORTS → `flowreplayservice`

<!-- source: class-sitegenerator.md -->

# SiteGenerator

**Kind:** Class

**Source:** `atloria-monorepo/apps/cli/src/generators/site.generator.ts` (line 54)

Static Site Generator

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate(metadata: ProjectMetadata, entities: Entity[], relationships: Relationship[])` | `Promise<void>` |

<!-- source: api-endpoint-startanalysis.md -->

# startAnalysis

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/code-analyzer/src/app/analysis/analysis.controller.ts` (line 30)

Start a new code analysis job

POST /api/analysis

Body:
{
  "projectId": "uuid",
  "repoUrl": "https://github.com/user/repo.git",
  "branch": "main",
  "folderPath": "packages/frontend",  // Optional: for mono-repos
  "framework": "react",               // Optional: auto-detect if not provided
  "patterns": ["src/**\/*.tsx"],       // Optional: custom file patterns
  "modules": ["auth", "dashboard"],   // Optional: specific modules to analyze
  "tokenBudget": 150000,              // Optional: token budget for analysis
  "organizationId": "uuid",
  "triggeredBy": "user-uuid"
}

Returns: { jobId: "uuid" }

## Endpoint

`POST /analysis`

## Referenced By

- `AnalysisController` (MODULE_DECLARES)

<!-- source: interface-testcommentdata.md -->

# TestCommentData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 93)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `documentId` | `string` |
| `content` | `string` |
| `authorId` | `string` |
| `authorName` | `string` |
| `resolved` | `boolean` |
| `parentCommentId` | `string` |
| `createdAt` | `string` |
| `updatedAt` | `string` |

<!-- source: component-timelinedot.md -->

# TimelineDot

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/social-proof/social-proof-timeline.tsx` (line 37)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `variant` | `unknown | unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TimelineDot_18ef7c67["TimelineDot"]
    class component_TimelineDot_18ef7c67 rootComponent
```

## Referenced By

- `SocialProofTimeline` (RENDERS)

<!-- source: graphql-query-users.md -->

# users

**Kind:** Graphql Query

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Get all users with pagination

## Relationships

- TYPE_OF → `UserConnection`

## Referenced By

- `Query` (CALLS_API)

<!-- source: class-yamlparser.md -->

# YamlParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/config-docs-parser/src/parsers/yaml.parser.ts` (line 81)

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: function-isdirectivenode.md -->

# $isDirectiveNode

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/directives/DirectiveNode.tsx` (line 155)

## Signature

```ts
function $isDirectiveNode(node: LexicalNode | null | undefined): node is DirectiveNode
```

## Parameters

| Name | Type |
|---|---|
| `node` | `LexicalNode | null | undefined` |

**Returns:** `node is DirectiveNode`

<!-- source: component-accordionitem-2.md -->

# AccordionItem

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/accordion-item.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `questionKey` | `string` | ✓ | - |
| `answerKey` | `string` | ✓ | - |
| `defaultOpen` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_AccordionItem_6bd6a70f["AccordionItem"]
    class component_AccordionItem_6bd6a70f rootComponent
```

## Relationships

- RENDERS → `ChevronDown`
- RENDERS → `AnimatePresence`
- RENDERS → `motion-div`
- USES_HOOK → `useTranslation`
- USES_HOOK → `useState`

<!-- source: constant-addbottomareachild.md -->

# addBottomAreaChild$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 755)

Lets you add React components below the editor.

<!-- source: api-endpoint-addcomment.md -->

# addComment

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/issues.controller.ts` (line 96)

## Endpoint

`POST /projects/:projectId/issues/:issueId/comments`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `issueId` | query | `string` | ✓ |

## Referenced By

- `IssuesController` (MODULE_DECLARES)

<!-- source: interface-agentinjectpayload.md -->

# AgentInjectPayload

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/agent/agent.types.ts` (line 84)

## Properties

| Property | Type |
|---|---|
| `message` | `string` |

<!-- source: interface-agentnote.md -->

# AgentNote

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/autonomous-loop.ts` (line 222)

A session-scoped note/learning the agent records as it works.
Injected into every subsequent turn so the agent builds up context.

## Properties

| Property | Type |
|---|---|
| `turn` | `number` |
| `content` | `string` |

<!-- source: interface-aiassistedconfig.md -->

# AIAssistedConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 158)

AI-assisted capture configuration

## Properties

| Property | Type |
|---|---|
| `verifyAfterActions` | `boolean` |
| `recoveryEnabled` | `boolean` |
| `enrichMetadata` | `boolean` |

<!-- source: service-aiservice.md -->

# AIService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/ai/ai.service.ts` (line 13)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getProvider` | `getProvider(name: string)` | `AIProvider` |
| `listProviders` | `listProviders()` | `unknown` |
| `enhanceDocument` | `enhanceDocument(documentId: string, providerName: string)` | `Promise<any>` |
| `generateOutline` | `generateOutline(topic: string, audience: string, providerName: string)` | `Promise<string>` |
| `improveWriting` | `improveWriting(text: string, providerName: string)` | `Promise<string>` |
| `summarizeDocument` | `summarizeDocument(documentId: string, providerName: string)` | `Promise<string>` |
| `streamCompletion` | `streamCompletion(prompt: string, providerName: string)` | `AsyncIterableIterator<string>` |
| `generateText` | `generateText(prompt: string, providerName: string)` | `Promise<string>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `configservice`
- DEPENDS_ON → `azureclaudeprovider`
- DEPENDS_ON → `azureopenaiprovider`
- DEPENDS_ON → `azureresponsesprovider`
- DEPENDS_ON → `azureresponsesprovider`

<!-- source: controller-analyticsexportcontroller.md -->

# AnalyticsExportController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/analytics/export/analytics-export.controller.ts` (line 34)

## Relationships

- MODULE_DECLARES → `exportNow`
- MODULE_DECLARES → `listReports`
- MODULE_DECLARES → `createReport`
- MODULE_DECLARES → `updateReport`
- MODULE_DECLARES → `deleteReport`
- MODULE_DECLARES → `runReport`
- MODULE_DECLARES → `listExportHistory`
- DEPENDS_ON → `analyticsexportservice`
- DEPENDS_ON → `scheduledreportsservice`

<!-- source: class-anthropicmodelprovider.md -->

# AnthropicModelProvider

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/anthropic-adapter.ts` (line 630)

**Implements:** `ModelProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getProfile` | `getProfile()` | `ModelCapabilityProfile` |
| `getModel` | `getModel(modelName: string)` | `AnthropicModel` |

<!-- source: interface-argtype.md -->

# ArgType

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/storybook/types.ts` (line 19)

Arg type definition

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `type` | `{
    name: string;
    required?: boolean;
  }` |
| `defaultValue` | `unknown` |
| `control` | `{
    type: string;
    [key: string]: unknown;
  }` |
| `table` | `{
    type?: { summary: string };
    defaultValue?: { summary: string };
    category?: string;
  }` |
| `options` | `unknown[]` |

<!-- source: constant-ask-credit-cost.md -->

# ASK_CREDIT_COST

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/billing/billing.constants.ts` (line 22)

<!-- source: module-assetsmodule.md -->

# AssetsModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/assets/assets.module.ts` (line 9)

## Relationships

- MODULE_IMPORTS → `configmodule`
- MODULE_IMPORTS → `databasemodule`
- MODULE_DECLARES → `assetscontroller`
- MODULE_PROVIDES → `assetsservice`
- MODULE_PROVIDES → `azureblobservice`
- MODULE_EXPORTS → `assetsservice`
- MODULE_EXPORTS → `azureblobservice`

<!-- source: class-atloriaapiclient.md -->

# AtloriaAPIClient

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/AtloriaAPIClient.ts` (line 19)

Main Atloria API client
Provides a unified interface for all API operations

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getInterceptors` | `getInterceptors()` | `InterceptorManager` |
| `setToken` | `setToken(token: string)` | `void` |
| `getToken` | `getToken()` | `string` |
| `initWebSocket` | `initWebSocket(url: string, config: WebSocketConfig)` | `WebSocketClient` |
| `getWebSocket` | `getWebSocket()` | `WebSocketClient | null` |
| `disconnectWebSocket` | `disconnectWebSocket()` | `void` |
| `login` | `login(email: string, password: string)` | `Promise<void>` |
| `logout` | `logout()` | `Promise<void>` |
| `refreshToken` | `refreshToken()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `audiences` | `AudienceEndpoints` |
| `auth` | `AuthEndpoints` |
| `comments` | `CommentEndpoints` |
| `documents` | `DocumentEndpoints` |
| `projects` | `ProjectEndpoints` |
| `suggestions` | `SuggestionEndpoints` |
| `users` | `UserEndpoints` |

<!-- source: interface-audienceblockprops.md -->

# AudienceBlockProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Editor/AudienceBlock.tsx` (line 10)

Props for the AudienceBlock component

## Properties

| Property | Type |
|---|---|
| `audience` | `Audience` |
| `audienceLogic` | `string` |
| `children` | `React.ReactNode` |
| `onEdit` | `() => void` |
| `onDelete` | `() => void` |
| `isNested` | `boolean` |

<!-- source: component-avatar-2.md -->

# Avatar

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Comments/CommentThread.tsx` (line 293)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `user` | `unknown` | ✓ | - |
| `size` | `unknown | unknown | unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Avatar_6ab6d3d7["Avatar"]
    class component_Avatar_6ab6d3d7 rootComponent
```

## Referenced By

- `CommentThread` (RENDERS)
- `CommentReply` (RENDERS)

<!-- source: type-avatarshape.md -->

# AvatarShape

**Kind:** Type

**Source:** `atloria-monorepo/packages/ui-core/src/components/avatar/Avatar.ts` (line 6)

## Definition

```ts
'circle' | 'square'
```

<!-- source: class-azureclaudeprovider.md -->

# AzureClaudeProvider

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/ai/providers/azure-claude.provider.ts` (line 48)

Azure AI Foundry Claude Provider
Uses native Anthropic Messages API endpoint through Azure AI Foundry
Endpoint: /anthropic/v1/messages

Authentication priority:
1. API Key (ANTHROPIC_FOUNDRY_API_KEY) - simplest, no az login needed
2. Azure AD (DefaultAzureCredential/AzureCliCredential) - fallback

**Implements:** `AIProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getAzureAIConfig` | `getAzureAIConfig()` | `Promise<{ endpoint: string; accessToken?: string; apiKey?: string; modelName: string } | null>` |
| `isAvailable` | `isAvailable()` | `Promise<boolean>` |
| `generateText` | `generateText(prompt: string, options: GenerateOptions)` | `Promise<string>` |
| `generateTextWithUsage` | `generateTextWithUsage(prompt: string, options: GenerateOptions)` | `Promise<AIResponse>` |
| `generateStream` | `generateStream(prompt: string, options: GenerateOptions)` | `AsyncIterableIterator<string>` |
| `analyze` | `analyze(content: string, type: AnalysisType)` | `Promise<AnalysisResult>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |

<!-- source: function-batchenrichscreenshots.md -->

# batchEnrichScreenshots

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/screenshot-metadata-enricher.ts` (line 321)

Batch enrich multiple screenshots

## Signature

```ts
function batchEnrichScreenshots(screenshots: Array<{ url: string; route: string; title?: string }>, entities: Entity[]): EnhancedScreenshotMetadata[]
```

## Parameters

| Name | Type |
|---|---|
| `screenshots` | `Array<{ url: string; route: string; title?: string }>` |
| `entities` | `Entity[]` |

**Returns:** `EnhancedScreenshotMetadata[]`

<!-- source: class-batchscreenshotstatusdto.md -->

# BatchScreenshotStatusDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 732)

Full batch status response for polling

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `status` | `JobStatus` |
| `progress` | `number` |
| `totalUrls` | `number` |
| `capturedUrls` | `number` |
| `failedUrls` | `number` |
| `currentItem` | `string` |
| `currentStage` | `string` |
| `stageProgress` | `number` |
| `screenshots` | `ScreenshotResultDto[]` |
| `failures` | `ScreenshotFailureDto[]` |
| `flowSteps` | `{ flowStepId: number; blobUrl: string; annotationsFragment: string }[]` |
| `error` | `string` |
| `timestamps` | `{
    createdAt: Date;
    updatedAt: Date;
    startedAt?: Date;
    completedAt?: Date;
  }` |
| `estimatedCompletion` | `Date` |
| `stats` | `{
    averageCaptureTimeMs: number;
    successRate: number;
    retryCount: number;
  }` |

<!-- source: type-benchmarkevent.md -->

# BenchmarkEvent

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/types.ts` (line 274)

Typed events emitted by BenchmarkRunner for monitoring.

## Definition

```ts
| { type: 'run_start';    totalTasks: number; suite: string; model: string }
  | { type: 'task_start';   taskId: string; difficulty?: string; index: number; total: number }
  | { type: 'tool_call';    taskId: string; toolName: string; inputPreview: string }
  | { type: 'tool_result';  taskId: string…
```

<!-- source: function-buildbashenv.md -->

# buildBashEnv

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/agent-hardening.ts` (line 56)

Build bash environment with pager-disabling variables.

Pattern from SWE-agent: Disable all interactive pagers and progress bars
to prevent the agent's bash commands from hanging on user input prompts.

Merges with existing env, overriding pager-related vars.

## Signature

```ts
function buildBashEnv(existingEnv: Record<string, string | undefined>): Record<string, string>
```

## Parameters

| Name | Type |
|---|---|
| `existingEnv` | `Record<string, string | undefined>` |

**Returns:** `Record<string, string>`

<!-- source: function-buildcollectionurl.md -->

# buildCollectionUrl

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/url-utils.ts` (line 66)

Build a collection URL from components

## Signature

```ts
function buildCollectionUrl(slug: string, urlId: string): string
```

## Parameters

| Name | Type |
|---|---|
| `slug` | `string` |
| `urlId` | `string` |

**Returns:** `string`

<!-- source: function-buildmockupanimationscss.md -->

# buildMockupAnimationsCss

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/mockups.ts` (line 103)

## Signature

```ts
function buildMockupAnimationsCss(): string
```

**Returns:** `string`

<!-- source: function-buildsearchindex.md -->

# buildSearchIndex

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/search-index.ts` (line 178)

Pure transform: corpus pages + entity graph → a compact static search index.
Deterministic for identical inputs (stable order, stable ids).

## Signature

```ts
function buildSearchIndex(slugWithId: string, pages: RawIndexPage[], entities: GraphEntity[], relationships: GraphRelationship[], generatedAt: Date): StaticSearchIndex
```

## Parameters

| Name | Type |
|---|---|
| `slugWithId` | `string` |
| `pages` | `RawIndexPage[]` |
| `entities` | `GraphEntity[]` |
| `relationships` | `GraphRelationship[]` |
| `generatedAt` | `Date` |

**Returns:** `StaticSearchIndex`

<!-- source: interface-captureddomstate.md -->

# CapturedDOMState

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/action-executor.service.ts` (line 13)

DOM state captured from a page

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `html` | `string` |
| `hasModal` | `boolean` |
| `hasError` | `boolean` |
| `errorMessages` | `string[]` |
| `visibleButtons` | `{ selector: string; text: string; isEnabled: boolean }[]` |
| `visibleInputs` | `{ selector: string; type: string; placeholder: string }[]` |
| `isLoading` | `boolean` |
| `pageTitle` | `string` |

<!-- source: function-capturediagnostics.md -->

# captureDiagnostics

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/utils/ai-auth-debugger.ts` (line 52)

Capture comprehensive diagnostics about current page state

## Signature

```ts
async function captureDiagnostics(page: any, phase: string, attemptLog: any[]): Promise<AuthDiagnostics>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `any` |
| `phase` | `string` |
| `attemptLog` | `any[]` |

**Returns:** `Promise<AuthDiagnostics>`

<!-- source: constant-categorylabelswithall.md -->

# categoryLabelsWithAll

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/constants/templateCategories.ts` (line 23)

Extended labels including "All" option for filter components

## Definition

```ts
Record<TemplateCategory | 'ALL', string>
```

<!-- source: function-checkheadinghierarchy.md -->

# checkHeadingHierarchy

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/accessibility.ts` (line 317)

Check heading hierarchy

## Signature

```ts
async function checkHeadingHierarchy(page: Page): Promise<{ valid: boolean; issues: string[] }>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |

**Returns:** `Promise<{ valid: boolean; issues: string[] }>`

<!-- source: component-child.md -->

# Child

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/realm-plugin.tsx` (line 25)

## Diagram

```mermaid
graph TD
    component_Child_3b902d1a["Child"]
    class component_Child_3b902d1a rootComponent
```

## Relationships

- USES_HOOK → `useCellValue`

## Referenced By

- `Example` (RENDERS)

<!-- source: interface-codeblockinfo.md -->

# CodeBlockInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 889)

Code block information

## Properties

| Property | Type |
|---|---|
| `language` | `string` |
| `line` | `number` |
| `lines` | `number` |

<!-- source: interface-comparisonrowprops.md -->

# ComparisonRowProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/comparison-row.tsx` (line 11)

## Properties

| Property | Type |
|---|---|
| `featureKey` | `string` |
| `values` | `(boolean | string)[]` |

<!-- source: interface-copywriterinput.md -->

# CopywriterInput

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/copywriter.prompts.ts` (line 10)

## Properties

| Property | Type |
|---|---|
| `sectionType` | `SectionType` |
| `docContext` | `string` |
| `config` | `GenerationConfig` |

<!-- source: function-createqueryproductknowledgetool.md -->

# createQueryProductKnowledgeTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/query-product-knowledge.tool.ts` (line 105)

## Signature

```ts
function createQueryProductKnowledgeTool(deps: ProductKnowledgeDeps): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `deps` | `ProductKnowledgeDeps` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: service-crop.md -->

# Crop

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/crop.service.ts` (line 1)

<!-- source: interface-dataproviderconfig.md -->

# DataProviderConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/providers/data-provider.interface.ts` (line 33)

Data provider configuration

## Properties

| Property | Type |
|---|---|
| `mode` | `'static' | 'dynamic'` |
| `outputDir` | `string` |
| `apiUrl` | `string` |
| `apiKey` | `string` |
| `projectId` | `string` |

<!-- source: type-deploymentnodetype.md -->

# DeploymentNodeType

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/deployment-diagram.generator.ts` (line 22)

Types of deployment nodes

## Definition

```ts
| 'container'
  | 'service'
  | 'database'
  | 'cache'
  | 'queue'
  | 'api-gateway'
  | 'load-balancer'
  | 'external-service'
```

<!-- source: type-deskbucket.md -->

# DeskBucket

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/issues/dto/desk.dto.ts` (line 25)

## Definition

```ts
(typeof DESK_BUCKETS)[number]
```

<!-- source: type-deskstate.md -->

# DeskState

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 137)

## Definition

```ts
'needs_first' | 'needs_next' | 'investigating' | 'waiting' | 'paused' | 'done'
```

<!-- source: api-endpoint-dispatchjob.md -->

# dispatchJob

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/orchestrator.controller.ts` (line 34)

Dispatch a parse job

## Endpoint

`POST /api/orchestrator/jobs`

## Referenced By

- `OrchestratorController` (MODULE_DECLARES)

<!-- source: service-docverifierservice.md -->

# DocVerifierService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/doc-verifier.service.ts` (line 1)

<!-- source: class-dotnetparser.md -->

# DotNetParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/backend/dotnet.parser.ts` (line 34)

.NET Parser implementation using Roslyn bridge

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `parseProject` | `parseProject(rootDir: string)` | `Promise<ParseResult>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: function-extractimportsfromdeclaration.md -->

# extractImportsFromDeclaration

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 98)

Extract imports from an ImportDeclaration node

## Signature

```ts
function extractImportsFromDeclaration(path: NodePath<t.ImportDeclaration>): ImportInfo[]
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath<t.ImportDeclaration>` |

**Returns:** `ImportInfo[]`

<!-- source: type-fetchstatsfn.md -->

# FetchStatsFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/query-product-knowledge.tool.ts` (line 55)

Fetch aggregate product stats from the knowledge graph.

## Definition

```ts
(
  projectId: string,
) => Promise<ProductStats>
```

<!-- source: type-findscreenshotsfn.md -->

# FindScreenshotsFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/tools/find-screenshots.tool.ts` (line 15)

Function signature for querying screenshots.
Injected at creation time — wraps PrismaService.screenshot.findMany().

## Definition

```ts
(
  projectId: string,
  options?: {
    urlPattern?: string;
    featureArea?: string;
    pageType?: string;
    viewport?: string;
    limit?: number;
  }
) => Promise<ScreenshotInfo[]>
```

<!-- source: function-flowkey.md -->

# flowKey

**Kind:** Function

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/crop.service.ts` (line 134)

Deterministic storage key for a flow step screenshot.

Naming scheme (WS-A flow-replay):
  flowKey('abc', 0)          => 'flows/abc/step-0.png'      (initial state, full page)
  flowKey('abc', 2)          => 'flows/abc/step-2.png'      (state after step 2, full page)
  flowKey('abc', 2, 'crop')  => 'flows/abc/step-2-crop.png' (tight crop around the target)

The no-variant key is the canonical FULL-PAGE image the docs reference (it is
the one the annotation fragment's coordinates are computed against). 'crop' is
an auxiliary tight close-up. 'full' is retained for backward compat.

## Signature

```ts
function flowKey(flowId: string, stepOrder: number, variant: 'full' | 'crop'): string
```

## Parameters

| Name | Type |
|---|---|
| `flowId` | `string` |
| `stepOrder` | `number` |
| `variant` | `'full' | 'crop'` |

**Returns:** `string`

<!-- source: graphql-mutation-followuser.md -->

# followUser

**Kind:** Graphql Mutation

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Follow a user

## Relationships

- TYPE_OF → `Follow`

## Referenced By

- `Mutation` (CALLS_API)

<!-- source: constant-formats.md -->

# FORMATS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 542)

<!-- source: type-frameaction.md -->

# FrameAction

**Kind:** Type

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 41)

## Definition

```ts
typeof FRAME_ACTIONS[number]
```

<!-- source: function-generatelargereactfile.md -->

# generateLargeReactFile

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 248)

Generate large file content for performance testing

## Signature

```ts
function generateLargeReactFile(componentCount: number): string
```

## Parameters

| Name | Type |
|---|---|
| `componentCount` | `number` |

**Returns:** `string`

<!-- source: api-endpoint-getpagehtml.md -->

# getPageHtml

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/batch-screenshot.controller.ts` (line 308)

Validate selectors exist on a page

POST /api/screenshot/validate-selectors

Loads the page and checks if all provided selectors exist.
Use this to verify login form selectors before batch processing.

## Endpoint

`POST /screenshot/page-html`

## Referenced By

- `BatchScreenshotController` (MODULE_DECLARES)

<!-- source: constant-gpt5-flagship-profile.md -->

# GPT5_FLAGSHIP_PROFILE

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-profiles.ts` (line 125)

GPT-5.4 (Azure Responses API) — the Atloria primary model.
Key quirks:
  - reasoning_effort defaults to 'none' → skips tool calls
  - temperature is unsupported when reasoning is active
  - tool_choice: 'required' needed on turn 1 to force at least one call

## Definition

```ts
ModelCapabilityProfile
```

<!-- source: graphql-type-like.md -->

# Like

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Like on a post

## Relationships

- TYPE_OF → `User`
- TYPE_OF → `Post`
- TYPE_OF → `DateTime`

## Referenced By

- `likePost` (TYPE_OF)
- `Post` (TYPE_OF)

<!-- source: class-loginpage.md -->

# LoginPage

**Kind:** Class

**Source:** `atloria-monorepo/apps/web-e2e/src/pages/auth.page.ts` (line 7)

Login page object

**Extends:** `BasePage`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `goto` | `goto()` | `Promise<void>` |
| `login` | `login(email: string, password: string)` | `Promise<void>` |
| `loginAndWait` | `loginAndWait(email: string, password: string)` | `Promise<void>` |
| `hasError` | `hasError()` | `Promise<boolean>` |
| `getErrorMessage` | `getErrorMessage()` | `Promise<string>` |
| `toggleRememberMe` | `toggleRememberMe()` | `Promise<void>` |
| `goToRegister` | `goToRegister()` | `Promise<void>` |
| `goToForgotPassword` | `goToForgotPassword()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `emailInput` | `Locator` |
| `passwordInput` | `Locator` |
| `submitButton` | `Locator` |
| `errorMessage` | `Locator` |
| `forgotPasswordLink` | `Locator` |
| `registerLink` | `Locator` |
| `rememberMeCheckbox` | `Locator` |

<!-- source: type-loginrequest.md -->

# LoginRequest

**Kind:** Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

## Properties

| Property | Type |
|---|---|
| `email` | `string` |
| `password` | `string` |

## Referenced By

- `login` (REFERENCES)
- `User Management API` (TYPE_OF)

<!-- source: enum-notificationtype.md -->

# NotificationType

**Kind:** Enum

**Source:** `atloria-monorepo/packages/types/src/enums/index.ts` (line 86)

Notification types

## Values

- `MENTION`
- `COMMENT`
- `SUGGESTION`
- `DOCUMENT_SHARED`
- `REVIEW_REQUEST`
- `SYSTEM`

<!-- source: enum-relationshiptype-2.md -->

# RelationshipType

**Kind:** Enum

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/relationship.interface.ts` (line 14)

Relationship Interfaces

Defines all relationship types between entities.
Relationships describe how code entities connect and interact.

## Values

- `RENDERS`
- `USES_HOOK`
- `USES_CONTEXT`
- `PROVIDES_CONTEXT`
- `USES_STORE`
- `DISPATCHES_ACTION`
- `SELECTS_STATE`
- `REDUCES`
- `TRIGGERS_EFFECT`
- `UPDATES_STORE`
- `CALLS_API`
- `IMPLEMENTS_API`
- `DEPENDS_ON`
- `USES_SERVICE`
- `INJECTS`
- `QUERIES_MODEL`
- `HAS_ONE`
- `HAS_MANY`
- `BELONGS_TO`
- `MANY_TO_MANY`
- `REFERENCES_MODEL`
- `IMPORTS`
- `EXTENDS`
- `IMPLEMENTS`
- `TYPE_OF`
- `CALLS`
- `EXPORTS`
- `RE_EXPORTS`
- `MODULE_IMPORTS`
- `MODULE_PROVIDES`
- `MODULE_EXPORTS`
- `MODULE_DECLARES`
- `DOCUMENTS`
- `REFERENCES`
- `LINKS_TO`
- `DEPLOYED_TO`
- `CONNECTS_TO`
- `CONTAINER_DEPENDS_ON`
- `EXPOSES_PORT`
- `USES_ENV`
- `USES_CONFIG`
- `REQUIRES_FEATURE`
- `TESTS`
- `MOCKS`

<!-- source: enum-relationtype-2.md -->

# RelationType

**Kind:** Enum

**Source:** `atloria-monorepo/apps/api/src/graph/interfaces/entity.interface.ts` (line 13)

## Values

- `IMPLEMENTS`
- `DEPENDS_ON`
- `RELATES_TO`
- `REFERENCES`
- `BLOCKS`
- `CONTAINS`
- `USES`

<!-- source: constant-required-project-roots.md -->

# REQUIRED_PROJECT_ROOTS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/pme-agent/test/discovery/ground-truth.ts` (line 110)

Major project roots the agent MUST identify

<!-- source: constant-sample-projects-path-2.md -->

# SAMPLE_PROJECTS_PATH

**Kind:** Constant

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/setup.ts` (line 19)

<!-- source: class-stdiotransport.md -->

# StdioTransport

**Kind:** Class

**Source:** `atloria-monorepo/apps/cli/src/stdio-transport.ts` (line 34)

**Implements:** `AgentTransport`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `handleEvent` | `handleEvent(event: AgentProtocolEvent)` | `void` |

<!-- source: module-storagemodule.md -->

# StorageModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/storage/storage.module.ts` (line 4)

## Relationships

- MODULE_PROVIDES → `storageservice`
- MODULE_EXPORTS → `storageservice`

<!-- source: interface-testdocumentdata.md -->

# TestDocumentData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 52)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `content` | `string` |
| `type` | `'MANUAL' | 'GENERATED' | 'HYBRID' | 'WIKI' | 'API_GUIDE'` |
| `audiences` | `('TECHNICAL' | 'USER' | 'API' | 'INTERNAL')[]` |
| `createdAt` | `string` |
| `updatedAt` | `string` |

<!-- source: module-usersmodule.md -->

# UsersModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/src/users/users.module.ts` (line 13)

## Relationships

- MODULE_IMPORTS → `prismamodule`
- MODULE_IMPORTS → `eventemittermodule`
- MODULE_DECLARES → `userscontroller`
- MODULE_PROVIDES → `usersservice`
- MODULE_EXPORTS → `usersservice`

<!-- source: service-usersservice.md -->

# UsersService

**Kind:** Service

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/src/users/users.service.ts` (line 15)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `findAll` | `findAll(paginationQuery: PaginationQueryDto)` | `unknown` |
| `findOne` | `findOne(id: string)` | `unknown` |
| `findByEmail` | `findByEmail(email: string)` | `unknown` |
| `create` | `create(createUserDto: CreateUserDto)` | `unknown` |
| `update` | `update(id: string, updateUserDto: UpdateUserDto)` | `unknown` |
| `remove` | `remove(id: string)` | `unknown` |
| `getUserPosts` | `getUserPosts(userId: string)` | `unknown` |
| `getFollowers` | `getFollowers(userId: string)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `eventemitter2`

<!-- source: function-islexicaljsxnode.md -->

# $isLexicalJsxNode

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/LexicalJsxNode.tsx` (line 151)

## Signature

```ts
function $isLexicalJsxNode(node: LexicalNode | null | undefined): node is LexicalJsxNode
```

## Parameters

| Name | Type |
|---|---|
| `node` | `LexicalNode | null | undefined` |

**Returns:** `node is LexicalJsxNode`

<!-- source: constant-addcomposerchild.md -->

# addComposerChild$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 737)

<!-- source: api-endpoint-addmember.md -->

# addMember

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 184)

## Endpoint

`POST /projects/:id/members`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: interface-agentmessageevent.md -->

# AgentMessageEvent

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/agent/agent.types.ts` (line 107)

## Properties

| Property | Type |
|---|---|
| `text` | `string` |
| `agentName` | `string` |
| `delta` | `boolean` |

<!-- source: interface-agentprotocolevent.md -->

# AgentProtocolEvent

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/protocol/agent-protocol.ts` (line 85)

A fully typed protocol event — the unit flowing through transports

## Properties

| Property | Type |
|---|---|
| `type` | `T` |
| `timestamp` | `number` |
| `data` | `AgentProtocolEventMap[T]` |

<!-- source: interface-aigenerateoptions.md -->

# AIGenerateOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/ai-provider.interface.ts` (line 23)

## Properties

| Property | Type |
|---|---|
| `maxTokens` | `number` |
| `temperature` | `number` |
| `systemPrompt` | `string` |
| `messages` | `AIMessage[]` |
| `stopSequences` | `string[]` |
| `responseFormat` | `'text' | 'json_object'` |
| `timeout` | `number` |
| `images` | `string[]` |

<!-- source: service-aiusageservice.md -->

# AIUsageService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/ai/ai-usage.service.ts` (line 87)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `calculateCost` | `calculateCost(model: string, usage: TokenUsage)` | `UsageCost` |
| `trackUsage` | `trackUsage(params: TrackUsageParams)` | `Promise<UsageCost>` |
| `deductCredits` | `deductCredits(organizationId: string, amount: number, transaction: {
      referenceType: string;
      referenceId: string;
      description: string;
      userId: string;
    })` | `Promise<{ balance: number }>` |
| `getOrganizationUsage` | `getOrganizationUsage(organizationId: string, startDate: Date, endDate: Date)` | `unknown` |
| `getOrganizationBalance` | `getOrganizationBalance(organizationId: string)` | `unknown` |
| `addCredits` | `addCredits(organizationId: string, amount: number, userId: string, description: string, reference: { type: string; id: string })` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: controller-appcontroller-2.md -->

# AppController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/app/app.controller.ts` (line 5)

## Relationships

- MODULE_DECLARES → `getData`
- MODULE_DECLARES → `getPublicStats`
- MODULE_DECLARES → `healthCheck`
- DEPENDS_ON → `appservice`

<!-- source: constant-assist-credit-cost.md -->

# ASSIST_CREDIT_COST

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/billing/billing.constants.ts` (line 23)

<!-- source: interface-asyncstatepattern.md -->

# AsyncStatePattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-management.interface.ts` (line 266)

Async state pattern (for React Query, SWR, async Redux)

## Properties

| Property | Type |
|---|---|
| `states` | `{
    idle: boolean;
    loading: boolean;
    success: boolean;
    error: boolean;
  }` |
| `dataField` | `string` |
| `errorField` | `string` |
| `loadingField` | `string` |
| `queryKey` | `string` |
| `mutationFn` | `string` |
| `endpoint` | `string` |
| `hasRetry` | `boolean` |
| `hasOptimisticUpdate` | `boolean` |

<!-- source: class-atloriaapiexplorer.md -->

# AtloriaAPIExplorer

**Kind:** Class

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/APIExplorer.ts` (line 63)

**Extends:** `LitElement`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `willUpdate` | `willUpdate(changed: Map<string | number | symbol, unknown>)` | `void` |
| `connectedCallback` | `connectedCallback()` | `void` |
| `disconnectedCallback` | `disconnectedCallback()` | `void` |
| `render` | `render()` | `void` |

## Properties

| Property | Type |
|---|---|
| `styles` | `any` |
| `spec` | `OpenAPISpec` |
| `endpoints` | `APIEndpoint[]` |
| `environments` | `Environment[]` |
| `mode` | `'explorer' | 'documentation'` |
| `defaultEndpoint` | `string` |
| `proxyUrl` | `string` |
| `presetBearerToken` | `string` |

<!-- source: module-audiencemodule.md -->

# AudienceModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/audience/audience.module.ts` (line 9)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_DECLARES → `audiencecontroller`
- MODULE_PROVIDES → `audienceservice`
- MODULE_EXPORTS → `audienceservice`

<!-- source: interface-audienceselectormodalprops.md -->

# AudienceSelectorModalProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Editor/AudienceSelectorModal.tsx` (line 11)

Props for the AudienceSelectorModal component

## Properties

| Property | Type |
|---|---|
| `open` | `boolean` |
| `onClose` | `() => void` |
| `onApply` | `(logic: string) => void` |
| `audiences` | `Audience[]` |
| `initialSelection` | `string[]` |

<!-- source: class-autonomousturnhook.md -->

# AutonomousTurnHook

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/autonomous-loop.ts` (line 612)

TurnHook that drives autonomous agent behavior.

It watches what the agent is doing (via tool calls in input items)
and injects nudges when the agent skips investigation or verification.

Usage:
```typescript
const hook = new AutonomousTurnHook({
  maxTurns: 40,
  qualityGateProvider: async () => [
    { id: 'tests_pass', description: 'All tests pass', passed: false },
  ],
});
```

**Implements:** `TurnHook`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `updateTokenUsage` | `updateTokenUsage(inputTokens: number)` | `void` |
| `getCircleDetector` | `getCircleDetector()` | `CircleDetector | null` |
| `beforeModelCall` | `beforeModelCall(args: TurnHookArgs<TContext>)` | `Promise<{ instructions?: string; input?: AgentInputItem[] }>` |
| `getState` | `getState()` | `Readonly<LoopState>` |
| `getRecentFiles` | `getRecentFiles()` | `readonly string[]` |

## Properties

| Property | Type |
|---|---|
| `onPreCompact` | `(data: { turnNumber: number; tokenCount: number; recentFiles: string[] }) => void` |
| `onPostCompact` | `(data: { turnNumber: number; summaryInjected: boolean }) => void` |

<!-- source: type-avatarsize.md -->

# AvatarSize

**Kind:** Type

**Source:** `atloria-monorepo/packages/ui-core/src/components/avatar/Avatar.ts` (line 5)

## Definition

```ts
'xs' | 'sm' | 'md' | 'lg' | 'xl'
```

<!-- source: class-azureopenaiprovider.md -->

# AzureOpenAIProvider

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/ai/providers/azure-openai.provider.ts` (line 47)

**Implements:** `AIProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `isAvailable` | `isAvailable()` | `Promise<boolean>` |
| `generateText` | `generateText(prompt: string, options: GenerateOptions)` | `Promise<string>` |
| `generateTextWithUsage` | `generateTextWithUsage(prompt: string, options: GenerateOptions)` | `Promise<AIResponse>` |
| `generateStream` | `generateStream(prompt: string, options: GenerateOptions)` | `AsyncIterableIterator<string>` |
| `analyze` | `analyze(content: string, type: AnalysisType)` | `Promise<AnalysisResult>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |

<!-- source: function-buildbenchmarkprompt.md -->

# buildBenchmarkPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/adaptive-prompt.ts` (line 229)

Build a benchmark-optimized system prompt.

Unlike `buildAdaptivePrompt` (which has a 5-phase workflow including
"run baseline tests first"), this prompt is action-first:

  1. Read the issue → identify the source file and function
  2. Call edit_file immediately with the fix
  3. Run the targeted test to verify

The "establish baseline first" step is intentionally omitted because:
  - Baselines consume 50-80% of the turn budget on analysis
  - The model then produces text describing its plan instead of calling edit_file
  - Azure Responses API expires previous_response_id on completion → no second turn
  - SWE-bench eval applies the diff, not the agent's text response

Used by BenchmarkRunner instead of buildAdaptivePrompt.

## Signature

```ts
function buildBenchmarkPrompt(options: {
  workspace: string;
  toolGuide: string;
  repoMap?: string;
  domainRules?: string[];
  /** Specific test names that must pass (from SWE-bench FAIL_TO_PASS metadata) */
  failToPassTests?: string[];
}): string
```

## Parameters

| Name | Type |
|---|---|
| `options` | `{
  workspace: string;
  toolGuide: string;
  repoMap?: string;
  domainRules?: string[];
  /** Specific test names that must pass (from SWE-bench FAIL_TO_PASS metadata) */
  failToPassTests?: string[];
}` |

**Returns:** `string`

<!-- source: function-buildcomposerinsert.md -->

# buildComposerInsert

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/copilotUtils.ts` (line 69)

## Signature

```ts
function buildComposerInsert(answer: string, sources: CopilotAskSource[]): string
```

## Parameters

| Name | Type |
|---|---|
| `answer` | `string` |
| `sources` | `CopilotAskSource[]` |

**Returns:** `string`

<!-- source: function-buildentitypageindexes.md -->

# buildEntityPageIndexes

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/entity-page.ts` (line 228)

Build the shared indexes renderEntityPage can consume, ONCE, for callers that render many
pages from the same graph. Turns per-page O(entities+relationships) work into O(deg) lookups.

## Signature

```ts
function buildEntityPageIndexes(entities: Entity[], relationships: Relationship[]): {
  nameResolver: (id: string) => string;
  outgoingBySource: Map<string, Relationship[]>;
  incomingByTarget: Map<string, Relationship[]>;
}
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `Entity[]` |
| `relationships` | `Relationship[]` |

**Returns:** `{
  nameResolver: (id: string) => string;
  outgoingBySource: Map<string, Relationship[]>;
  incomingByTarget: Map<string, Relationship[]>;
}`

<!-- source: function-buildqasystemprompt.md -->

# buildQaSystemPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/qa.prompts.ts` (line 7)

QA Agent Prompts

Prompts for visual QA evaluation of generated marketing pages.

## Signature

```ts
function buildQaSystemPrompt(): string
```

**Returns:** `string`

<!-- source: function-buildsystemprompt.md -->

# buildSystemPrompt

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/support-agent/prompts/system-prompt-layers.ts` (line 239)

Assembles all prompt layers into a complete system prompt

## Signature

```ts
function buildSystemPrompt(context: PromptContext): string
```

## Parameters

| Name | Type |
|---|---|
| `context` | `PromptContext` |

**Returns:** `string`

<!-- source: constant-categoryvariants.md -->

# categoryVariants

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/constants/templateCategories.ts` (line 47)

Badge variants for each category

## Definition

```ts
Record<
  TemplateCategory,
  'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error' | 'default'
>
```

<!-- source: function-checkkeyboardnavigation.md -->

# checkKeyboardNavigation

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/accessibility.ts` (line 137)

Check keyboard navigation

## Signature

```ts
async function checkKeyboardNavigation(page: Page, expectedFocusOrder: string[]): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |
| `expectedFocusOrder` | `string[]` |

**Returns:** `Promise<void>`

<!-- source: class-clipdto.md -->

# ClipDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 190)

Clip region DTO for partial page screenshots

## Properties

| Property | Type |
|---|---|
| `x` | `number` |
| `y` | `number` |
| `width` | `number` |
| `height` | `number` |

<!-- source: interface-cliprect.md -->

# ClipRect

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/crop.service.ts` (line 19)

A Playwright clip rect, in PIXELS.

## Properties

| Property | Type |
|---|---|
| `x` | `number` |
| `y` | `number` |
| `width` | `number` |
| `height` | `number` |

<!-- source: component-code-2.md -->

# Code

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/technical/entity/[entityId]/page.tsx` (line 37)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Code_3887f2e4["Code"]
    class component_Code_3887f2e4 rootComponent
```

## Referenced By

- `MethodsTable` (RENDERS)
- `FieldsTable` (RENDERS)

<!-- source: component-codeblockeditorcontextprovider.md -->

# CodeBlockEditorContextProvider

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/CodeBlockNode.tsx` (line 191)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `parentEditor` | `any` | ✓ | - |
| `lexicalNode` | `any` | ✓ | - |
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CodeBlockEditorContextProvider_799537f6["CodeBlockEditorContextProvider"]
    class component_CodeBlockEditorContextProvider_799537f6 rootComponent
```

## Relationships

- RENDERS → `CodeBlockEditorContext-Provider`
- USES_HOOK → `useMemo`

## Referenced By

- `CodeBlockEditorContainer` (RENDERS)

<!-- source: component-comparisonfeaturetable.md -->

# ComparisonFeatureTable

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/comparison/comparison-feature-table.tsx` (line 21)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `columns` | `unknown[]` | ✓ | - |
| `features` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ComparisonFeatureTable_3ab2c8e0["ComparisonFeatureTable"]
    class component_ComparisonFeatureTable_3ab2c8e0 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `ComparisonRow`
- USES_HOOK → `useTranslation`

<!-- source: interface-componententity.md -->

# ComponentEntity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 296)

Component entity (React, Vue, Angular)

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.COMPONENT` |
| `componentType` | `'functional' | 'class'` |
| `props` | `PropDefinition[]` |
| `hooks` | `HookUsage[]` |
| `events` | `EventDefinition[]` |
| `slots` | `SlotDefinition[]` |
| `childComponents` | `string[]` |
| `stateManagement` | `StateManagementInfo` |
| `exports` | `ExportInfo` |

<!-- source: function-configcommand.md -->

# configCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/config.command.ts` (line 99)

Config command handler

## Signature

```ts
async function configCommand(options: ConfigOptions): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `ConfigOptions` |

**Returns:** `Promise<void>`

<!-- source: graphql-type-createpostinput.md -->

# CreatePostInput

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Input for creating a post

## Referenced By

- `createPost` (TYPE_OF)

<!-- source: function-createreadmanifesttool.md -->

# createReadManifestTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/read-manifest.tool.ts` (line 11)

## Signature

```ts
function createReadManifestTool(componentLibraryDir: string): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `componentLibraryDir` | `string` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: interface-ctacardprops.md -->

# CtaCardProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/cta/cta-card.tsx` (line 14)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `primaryCtaKey` | `string` |
| `primaryCtaUrl` | `string` |
| `secondaryCtaKey` | `string` |
| `secondaryCtaUrl` | `string` |
| `icon` | `LucideIcon` |

<!-- source: type-desktransition.md -->

# DeskTransition

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/issues/dto/desk.dto.ts` (line 37)

## Definition

```ts
(typeof DESK_TRANSITIONS)[number]
```

<!-- source: service-discoveryservice.md -->

# DiscoveryService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/discovery/discovery.service.ts` (line 48)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `scan` | `scan(dto: DiscoveryScanRequestDto)` | `Promise<SiteMap>` |
| `scanWithPage` | `scanWithPage(page: Page, baseUrl: string, dto: DiscoveryScanRequestDto, startTime: unknown)` | `Promise<SiteMap>` |

## Relationships

- DEPENDS_ON → `playwrightservice`
- DEPENDS_ON → `pageprofilerservice`

<!-- source: interface-docpage.md -->

# DocPage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/generators/mdx.generator.ts` (line 40)

Documentation page content for API sync

## Properties

| Property | Type |
|---|---|
| `slug` | `string` |
| `title` | `string` |
| `description` | `string` |
| `type` | `string` |
| `content` | `string` |
| `order` | `number` |
| `parentSlug` | `string` |
| `entityId` | `string` |

<!-- source: interface-docsearchresult.md -->

# DocSearchResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 137)

Document search result from Azure AI Search.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `content` | `string` |
| `moduleId` | `string` |
| `score` | `number` |

<!-- source: type-domainstatus.md -->

# DomainStatus

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/lib/api-client.ts` (line 42)

## Definition

```ts
| 'pending_dns'
  | 'verifying'
  | 'issuing_certificate'
  | 'live'
  | 'verification_failed'
  | 'certificate_failed'
  | 'offline'
  | 'removed'
```

<!-- source: service-entitymapper.md -->

# EntityMapper

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/services/entity-mapper.service.ts` (line 1)

<!-- source: class-envparser-2.md -->

# EnvParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/config-docs/env.parser.ts` (line 64)

Environment Variable Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: function-extractjsdocdescription.md -->

# extractJSDocDescription

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 493)

Extract JSDoc description from leading comments

## Signature

```ts
function extractJSDocDescription(path: NodePath): string | undefined
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath` |

**Returns:** `string | undefined`

<!-- source: type-failurecategory.md -->

# FailureCategory

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/types.ts` (line 47)

Classified reason for task failure.

## Definition

```ts
| 'timeout'           // Task exceeded time limit
  | 'no_changes'        // Agent didn't modify any files
  | 'test_failure'      // Changes made but tests still fail
  | 'setup_error'       // Workspace setup failed (clone, patch, install)
  | 'agent_error'       // Agent runtime error
  | 'wrong_…
```

<!-- source: type-fetchworkflowsfn.md -->

# FetchWorkflowsFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/query-product-knowledge.tool.ts` (line 37)

Fetch user workflows (state machines, journeys) discovered from code.

## Definition

```ts
(
  projectId: string,
  options?: { featureId?: string; limit?: number },
) => Promise<ProductWorkflow[]>
```

<!-- source: api-endpoint-findall.md -->

# findAll

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/src/users/users.controller.ts` (line 34)

## Endpoint

`GET /users`

| Parameter | In | Type | Required |
|---|---|---|---|
| `paginationQuery` | query | `PaginationQueryDto` | ✓ |

## Referenced By

- `UsersController` (MODULE_DECLARES)

<!-- source: function-flowstepskey.md -->

# flowStepsKey

**Kind:** Function

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/flow-replay.service.ts` (line 34)

Redis key holding the ordered per-step results for a flow-replay job.

## Signature

```ts
function flowStepsKey(jobId: string)
```

## Parameters

| Name | Type |
|---|---|
| `jobId` | `string` |

<!-- source: constant-frame-actions.md -->

# FRAME_ACTIONS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 40)

<!-- source: function-getallparserinstances.md -->

# getAllParserInstances

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/queue/processors/parser-registry.ts` (line 139)

Get all parser instances

## Signature

```ts
function getAllParserInstances(): Map<string, IParser>
```

**Returns:** `Map<string, IParser>`

<!-- source: constant-gpt54-family-routing-table.md -->

# GPT54_FAMILY_ROUTING_TABLE

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-router.ts` (line 80)

Production routing table for atlas-docs-resource (East US 2).
Use this when all three GPT-5.4 family models are deployed.

Cost profile vs using gpt-5.4 for everything:
  - 60-70% of calls (explore/analyze/tool_dispatch) → nano/mini → ~15-6x cheaper
  - plan/implement (quality-critical) → gpt-5.4 full

## Definition

```ts
ModelRoutingTable
```

<!-- source: type-herolayout.md -->

# HeroLayout

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 12)

PME Core Types

Domain types for the Product Marketing Engine.
These are PME-specific — not generic agent types.

## Definition

```ts
'centered' | 'split-left' | 'split-right' | 'minimal'
```

<!-- source: type-jobstatus-2.md -->

# JobStatus

**Kind:** Type

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 668)

## Definition

```ts
'pending' | 'running' | 'completed' | 'failed'
```

<!-- source: graphql-mutation-likepost.md -->

# likePost

**Kind:** Graphql Mutation

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Like a post

## Relationships

- TYPE_OF → `Like`

## Referenced By

- `Mutation` (CALLS_API)

<!-- source: type-llmcomplete.md -->

# LlmComplete

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/grounded-ask.ts` (line 13)

## Definition

```ts
(prompt: string) => Promise<string>
```

<!-- source: class-newdocumentpage.md -->

# NewDocumentPage

**Kind:** Class

**Source:** `atloria-monorepo/apps/web-e2e/src/pages/documents.page.ts` (line 254)

New document page object

**Extends:** `BasePage`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `goto` | `goto()` | `Promise<void>` |
| `createBlankDocument` | `createBlankDocument(title: string)` | `Promise<void>` |
| `createFromTemplate` | `createFromTemplate(templateName: string)` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `titleInput` | `Locator` |
| `createButton` | `Locator` |
| `templateGallery` | `Locator` |

<!-- source: api-endpoint-renderpdf.md -->

# renderPdf

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/pdf/pdf.controller.ts` (line 30)

Render composed HTML to a PDF binary.

POST /api/screenshot/pdf
Body: { "html": "<!DOCTYPE html>…", "options": { "format": "A4" } }
Returns: application/pdf bytes.

The HTML may use CSS `page-break-after`/`page-break-before` to control
per-page breaks (the API's doc export puts one doc page per printed page).

## Endpoint

`POST /screenshot/pdf`

## Referenced By

- `PdfController` (MODULE_DECLARES)

<!-- source: enum-repositoryprovider.md -->

# RepositoryProvider

**Kind:** Enum

**Source:** `atloria-monorepo/apps/api/src/parsing/dto/parse-project.dto.ts` (line 5)

## Values

- `GITHUB`
- `AZURE_DEVOPS`
- `GITLAB`

<!-- source: enum-suggestionstatus.md -->

# SuggestionStatus

**Kind:** Enum

**Source:** `atloria-monorepo/packages/types/src/enums/index.ts` (line 65)

Suggestion status tracks the review state of document suggestions

## Values

- `PENDING`
- `ACCEPTED`
- `REJECTED`

<!-- source: constant-targeting-tasks.md -->

# TARGETING_TASKS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/pme-agent/test/discovery/ground-truth.ts` (line 164)

## Definition

```ts
TargetingTask[]
```

<!-- source: interface-testtemplatedata.md -->

# TestTemplateData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 153)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `category` | `TemplateCategory` |
| `content` | `string` |
| `thumbnail` | `string` |
| `createdAt` | `string` |
| `updatedAt` | `string` |

<!-- source: type-updateuser.md -->

# UpdateUser

**Kind:** Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `email` | `string` |

## Referenced By

- `updateUser` (REFERENCES)
- `User Management API` (TYPE_OF)

<!-- source: enum-userjourneynodetype.md -->

# UserJourneyNodeType

**Kind:** Enum

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/user-journey.interface.ts` (line 18)

User Journey Interfaces

Defines data structures for representing user journeys and flows
that will be converted into Mermaid flowchart diagrams.

User journeys differ from state machines:
- State machines focus on system states and transitions
- User journeys focus on user actions, screens, and navigation paths

## Values

- `START`
- `END`
- `SCREEN`
- `ACTION`
- `DECISION`
- `MODAL`
- `PROCESS`
- `NAVIGATION`
- `SUBFLOW`

<!-- source: constant-addeditorwrapper.md -->

# addEditorWrapper$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 764)

Lets you add React components as wrappers around the editor.

<!-- source: api-endpoint-addreply.md -->

# addReply

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/comment/comment.controller.ts` (line 315)

Add a reply to an existing comment

## Endpoint

`POST /documents/:documentId/comments/:id/replies`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `CommentController` (MODULE_DECLARES)

<!-- source: function-admonitionlabelsmap.md -->

# admonitionLabelsMap

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/ChangeAdmonitionType.tsx` (line 9)

## Signature

```ts
function admonitionLabelsMap(t: Translation): Record<(typeof ADMONITION_TYPES)[number], string>
```

## Parameters

| Name | Type |
|---|---|
| `t` | `Translation` |

**Returns:** `Record<(typeof ADMONITION_TYPES)[number], string>`

<!-- source: interface-agentprotocoleventmap.md -->

# AgentProtocolEventMap

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/protocol/agent-protocol.ts` (line 36)

## Properties

| Property | Type |
|---|---|
| `'agent:thinking'` | `{ agentName: string }` |
| `'agent:tool_start'` | `{ toolName: string; input: string }` |
| `'agent:tool_end'` | `{ toolName: string; outputPreview: string; durationMs: number }` |
| `'agent:message'` | `{ text: string; agentName: string; delta: boolean }` |
| `'agent:turn_done'` | `{ turnNumber: number; usage: TokenUsage }` |
| `'agent:error'` | `{ message: string; recoverable: boolean }` |
| `'agent:status_update'` | `{ code: string; message: string }` |
| `'agent:input_queued'` | `{ message: string; position: number }` |
| `'agent:verbose'` | `{ category: string; message: string; data?: Record<string, unknown>; timestamp: number }` |
| `'agent:ended'` | `{ totalUsage: TokenUsage; turnCount: number }` |
| `'agent:todo'` | `{ items: ReadonlyArray<TodoItem>; stats: TodoStats }` |
| `'agent:plan_ready'` | `{ plan: string }` |
| `'agent:plan_approved'` | `Record<string, never>` |
| `'agent:model_switched'` | `{ from: string; to: string; reason: string }` |
| `'agent:session_start'` | `{ model: string; workspace?: string }` |
| `'agent:session_end'` | `{ totalUsage: TokenUsage; turnCount: number; reason: 'completed' | 'error' | 'cancelled' }` |
| `'agent:pre_compact'` | `{ turnNumber: number; tokenCount: number; recentFiles: string[] }` |
| `'agent:post_compact'` | `{ turnNumber: number; summaryInjected: boolean }` |
| `'agent:subagent_start'` | `{ agentName: string; task: string }` |
| `'agent:subagent_end'` | `{ agentName: string; output: string; durationMs: number }` |
| `'agent:user_prompt_submit'` | `{ message: string }` |

<!-- source: interface-agentsendpayload.md -->

# AgentSendPayload

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/agent/agent.types.ts` (line 80)

## Properties

| Property | Type |
|---|---|
| `message` | `string` |

<!-- source: interface-aimessage-2.md -->

# AIMessage

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/ai-provider.interface.ts` (line 10)

## Properties

| Property | Type |
|---|---|
| `role` | `'system' | 'user' | 'assistant'` |
| `content` | `string` |

<!-- source: service-analyticsexportservice.md -->

# AnalyticsExportService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/analytics/export/analytics-export.service.ts` (line 46)

Generates analytics exports in PDF and CSV format.

PDF: built with pdfkit, branded cover page + KPIs grid + top tables.
     Returns a Buffer so the controller can stream it as a download or
     attach it to an email without writing to disk.

CSV: streams rows directly from Postgres via a Readable wrapper so we
     can export 100k+ row datasets without loading them into memory.

`AnalyticsExportService` generates analytics exports as branded PDF reports and high-volume CSV files for download or email delivery. It builds PDFs in-memory using `pdfkit` (cover page, KPI grid, and top tables) and returns a `Buffer` so callers can stream without touching disk. For CSV, it streams rows directly from Postgres through a `Readable` wrapper to handle 100k+ rows without loading results into memory.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generatePDF` | `generatePDF(opts: {
    projectId: string;
    period: number;
    sections?: ExportSection[];
  })` | `Promise<{ buffer: Buffer; filename: string }>` |
| `generateCSV` | `generateCSV(opts: {
    projectId: string;
    period: number;
    table: 'pageviews' | 'searches';
  })` | `Promise<{ stream: Readable; filename: string }>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant Client
  participant Controller as AnalyticsExportController
  participant Service as AnalyticsExportService
  participant DB as Postgres
  participant PDF as pdfkit
  participant Stream as Readable Stream

  Client->>Controller: Request export (format=pdf|csv, filters)
  Controller->>Service: generateExport(params)

  alt PDF export
    Service->>PDF: Build branded cover + KPI grid + top tables
    PDF-->>Service: Buffer (in-memory)
    Service-->>Controller: Buffer
    Controller-->>Client: Stream Buffer as download / email attachment
  else CSV export
    Service->>DB: Execute query with cursor/streaming
    DB-->>Service: Row stream
    Service->>Stream: Wrap rows into Readable (CSV lines)
    Stream-->>Controller: Stream<CSV>
    Controller-->>Client: Stream CSV download (no buffering)
  end
```

## Usage

```ts
import { Controller, Get, Query, Res } from '@nestjs/common';
import type { Response } from 'express';
import { AnalyticsExportService } from './analytics-export.service';

@Controller('/analytics/exports')
export class AnalyticsExportController {
  constructor(private readonly exports: AnalyticsExportService) {}

  @Get()
  async export(
    @Query('format') format: 'pdf' | 'csv',
    @Query('from') from: string,
    @Query('to') to: string,
    @Res() res: Response,
  ) {
    const params = { from, to }; // add any filters/grouping required by your service

    if (format === 'pdf') {
      const pdfBuffer = await this.exports.generatePdf(params);

      res.setHeader('Content-Type', 'application/pdf');
      res.setHeader('Content-Disposition', `attachment; filename="analytics-${from}-to-${to}.pdf"`);
      res.send(pdfBuffer);
      return;
    }

    const csvStream = await this.exports.generateCsvStream(params);

    res.setHeader('Content-Type', 'text/csv; charset=utf-8');
    res.setHeader('Content-Disposition', `attachment; filename="analytics-${from}-to-${to}.csv"`);

    // Pipe directly to response to avoid buffering large datasets
    csvStream.pipe(res);
  }
}
```

## AI Coding Instructions

- Keep PDF generation fully in-memory (`Buffer` output); do not write temporary files—controllers should stream the buffer to HTTP or attach it to email.
- For CSV, preserve true streaming from Postgres through a `Readable`/pipe chain; avoid `.map()`/array accumulation or `await`-ing full result sets.
- Ensure headers and backpressure are handled correctly when piping streams; always set `Content-Type`/`Content-Disposition` before piping to the response.
- When adding new fields/tables to exports, update both the PDF layout (cover/KPI grid/top tables) and CSV column order/escaping consistently; test with large datasets (100k+ rows) for memory safety.
- Integration points: controller for HTTP streaming, email sender for PDF attachments, and DB query layer for cursor/streaming access—changes in query shape can impact both formats.

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `analyticsservice`

<!-- source: controller-assetscontroller.md -->

# AssetsController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/assets/assets.controller.ts` (line 21)

## Relationships

- MODULE_DECLARES → `uploadImage`
- MODULE_DECLARES → `listAssets`
- MODULE_DECLARES → `getAsset`
- MODULE_DECLARES → `deleteAsset`
- DEPENDS_ON → `assetsservice`

<!-- source: class-atloriaavatar.md -->

# AtloriaAvatar

**Kind:** Class

**Source:** `atloria-monorepo/packages/ui-core/src/components/avatar/Avatar.ts` (line 17)

An avatar component that displays images or initials

**Extends:** `LitElement`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `render` | `render()` | `void` |

## Properties

| Property | Type |
|---|---|
| `styles` | `any` |
| `src` | `any` |
| `alt` | `any` |
| `name` | `any` |
| `initials` | `any` |
| `size` | `AvatarSize` |
| `shape` | `AvatarShape` |
| `status` | `'online' | 'offline' | 'busy' | 'away'` |
| `ring` | `any` |
| `clickable` | `any` |
| `group` | `any` |

<!-- source: module-auditmodule.md -->

# AuditModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/audit/audit.module.ts` (line 7)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_DECLARES → `auditcontroller`
- MODULE_PROVIDES → `auditservice`
- MODULE_EXPORTS → `auditservice`

<!-- source: interface-authconfigdiscovery.md -->

# AuthConfigDiscovery

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/permission-extractor.ts` (line 40)

Authentication configuration discovered in source code

## Properties

| Property | Type |
|---|---|
| `loginRoute` | `string` |
| `roles` | `string[]` |
| `roleSource` | `RoleSourceType` |
| `templatePermissions` | `string[]` |
| `guardNames` | `string[]` |

<!-- source: constant-auth-login-throttle.md -->

# AUTH_LOGIN_THROTTLE

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/common/throttling.module.ts` (line 19)

<!-- source: interface-awarenessstate.md -->

# AwarenessState

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useCollaboration.ts` (line 48)

Awareness state for a user

## Properties

| Property | Type |
|---|---|
| `userId` | `string` |
| `userName` | `string` |
| `color` | `string` |
| `cursor` | `CursorPosition` |
| `selection` | `SelectionRange` |

<!-- source: class-azuremodelprovider.md -->

# AzureModelProvider

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-adapter.ts` (line 663)

Azure Model Provider — factory that returns AzureResponsesModel instances.
Passed to the SDK Runner as the modelProvider.

Supports model fallback: if a fallbackModel is configured, the provider
wraps the primary model with automatic failover. When the primary model
fails with a non-transient error (e.g., model unavailable, quota exceeded),
it transparently switches to the fallback model for the rest of the run.

Inspired by Claude Code's FallbackTriggeredError → switch models pattern.

**Implements:** `ModelProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getProfile` | `getProfile()` | `ModelCapabilityProfile` |
| `getModel` | `getModel(modelName: string)` | `AzureResponsesModel` |

<!-- source: class-azureresponsesprovider.md -->

# AzureResponsesProvider

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/ai/providers/azure-responses.provider.ts` (line 34)

Azure Responses API Provider

Implements the NestJS AIProvider interface using the Azure OpenAI Responses API.
This is a fundamentally different API format from Chat Completions:
- Request: `input` (not `messages`), `instructions` (not system role), `max_output_tokens`
- Response: `output_text`, `usage.input_tokens`/`output_tokens`
- Streaming: typed `event:` + `data:` pairs with `response.output_text.delta` events

**Implements:** `AIProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `isAvailable` | `isAvailable()` | `Promise<boolean>` |
| `generateText` | `generateText(prompt: string, options: GenerateOptions)` | `Promise<string>` |
| `generateTextWithUsage` | `generateTextWithUsage(prompt: string, options: GenerateOptions)` | `Promise<AIResponse>` |
| `generateStream` | `generateStream(prompt: string, options: GenerateOptions)` | `AsyncIterableIterator<string>` |
| `analyze` | `analyze(content: string, type: AnalysisType)` | `Promise<AnalysisResult>` |

## Properties

| Property | Type |
|---|---|
| `name` | `string` |

<!-- source: type-backendframework.md -->

# BackendFramework

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/framework.types.ts` (line 30)

Detected backend framework

## Definition

```ts
| 'dotnet'
  | 'express'
  | 'nestjs'
  | 'fastify'
  | 'koa'
  | 'hono'
  | 'fastapi'
  | 'django'
  | 'flask'
  | 'spring'
  | 'rails'
  | 'laravel'
  | 'unknown'
```

<!-- source: function-buildcodereviewplan.md -->

# buildCodeReviewPlan

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/workflows/code-review.ts` (line 59)

Build a code review orchestration plan.

Launches 3 parallel reviewers with different focuses and applies
confidence-based filtering to produce a deduplicated, prioritized
issue list.

## Signature

```ts
function buildCodeReviewPlan(options: {
  diffContext?: string;
  guidelines?: string;
  confidenceThreshold?: number;
}): OrchestrationPlan
```

## Parameters

| Name | Type |
|---|---|
| `options` | `{
  diffContext?: string;
  guidelines?: string;
  confidenceThreshold?: number;
}` |

**Returns:** `OrchestrationPlan`

<!-- source: function-builddocumenturl.md -->

# buildDocumentUrl

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/url-utils.ts` (line 52)

Build a document URL from components

## Signature

```ts
function buildDocumentUrl(slug: string, urlId: string, audience: string): string
```

## Parameters

| Name | Type |
|---|---|
| `slug` | `string` |
| `urlId` | `string` |
| `audience` | `string` |

**Returns:** `string`

<!-- source: function-buildgroundedprompt.md -->

# buildGroundedPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/grounded-ask.ts` (line 18)

Build the grounded prompt: each source leads with its citable [path] id.

## Signature

```ts
function buildGroundedPrompt(question: string, context: DocSearchHit[]): string
```

## Parameters

| Name | Type |
|---|---|
| `question` | `string` |
| `context` | `DocSearchHit[]` |

**Returns:** `string`

<!-- source: function-buildqataskprompt.md -->

# buildQaTaskPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/qa.prompts.ts` (line 73)

## Signature

```ts
function buildQaTaskPrompt(pageUrl: string, viewport: string): string
```

## Parameters

| Name | Type |
|---|---|
| `pageUrl` | `string` |
| `viewport` | `string` |

**Returns:** `string`

<!-- source: function-certsecretname.md -->

# certSecretName

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/project/k8s-ingress.service.ts` (line 21)

## Signature

```ts
function certSecretName(domain: string): string
```

## Parameters

| Name | Type |
|---|---|
| `domain` | `string` |

**Returns:** `string`

<!-- source: function-checkmemoryleaks.md -->

# checkMemoryLeaks

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/performance.ts` (line 253)

Check for memory leaks by monitoring heap size

## Signature

```ts
async function checkMemoryLeaks(page: Page, action: () => Promise<void>, iterations): Promise<{
  hasLeak: boolean;
  heapGrowth: number;
  initialHeap: number;
  finalHeap: number;
}>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |
| `action` | `() => Promise<void>` |
| `iterations` | `any` |

**Returns:** `Promise<{
  hasLeak: boolean;
  heapGrowth: number;
  initialHeap: number;
  finalHeap: number;
}>`

<!-- source: component-colorstoolbar.md -->

# ColorsToolbar

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/colors.tsx` (line 27)

## Diagram

```mermaid
graph TD
    component_ColorsToolbar_3f580f2a["ColorsToolbar"]
    class component_ColorsToolbar_3f580f2a rootComponent
```

## Relationships

- USES_HOOK → `useCellValues`
- USES_HOOK → `useMemo`

## Referenced By

- `SpanWithColor` (RENDERS)

<!-- source: component-comparisonrow.md -->

# ComparisonRow

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/comparison-row.tsx` (line 16)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `featureKey` | `string` | ✓ | - |
| `values` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ComparisonRow_2fc9e457["ComparisonRow"]
    class component_ComparisonRow_2fc9e457 rootComponent
```

## Relationships

- RENDERS → `Check`
- RENDERS → `X`
- USES_HOOK → `useTranslation`

<!-- source: class-componenthintsdto.md -->

# ComponentHintsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 293)

Component library hints

## Properties

| Property | Type |
|---|---|
| `componentLibrary` | `'devextreme' | 'mui' | 'antd' | 'primeng'` |
| `componentHints` | `string` |

<!-- source: constant-config.md -->

# config

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/middleware.ts` (line 104)

<!-- source: interface-controllerentity.md -->

# ControllerEntity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 790)

Controller entity

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.CONTROLLER` |
| `basePath` | `string` |
| `guards` | `string[]` |
| `interceptors` | `string[]` |
| `endpoints` | `string[]` |
| `dependencies` | `DependencyInfo[]` |

<!-- source: component-copybutton.md -->

# CopyButton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Domains/DomainTab.tsx` (line 124)

Small copy-to-clipboard button used in every DNS table cell.

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `value` | `string` | ✓ | - |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_CopyButton_308f90ac["CopyButton"]
    class component_CopyButton_308f90ac rootComponent
```

## Relationships

- RENDERS → `CheckIcon`
- RENDERS → `ClipboardDocumentIcon`
- USES_HOOK → `useState`

## Referenced By

- `SubdomainCard` (RENDERS)
- `CustomDomainCard` (RENDERS)

<!-- source: function-createdataprovider.md -->

# createDataProvider

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/providers/index.ts` (line 19)

Create a data provider based on mode

## Signature

```ts
function createDataProvider(config: DataProviderConfig): DataProvider
```

## Parameters

| Name | Type |
|---|---|
| `config` | `DataProviderConfig` |

**Returns:** `DataProvider`

<!-- source: function-createsitegenagent.md -->

# createSiteGenAgent

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/agents/site-gen.agent.ts` (line 74)

Create the site generation agent config.

Usage:
```typescript
const agent = createSiteGenAgent(config, deps);
const result = await runtime.run(agent, {
  data: { projectId, userId, outputDir },
  input: 'Generate a marketing site for this project.',
});
```

## Signature

```ts
function createSiteGenAgent(config: SiteGenConfig, deps: SiteGenDependencies): AgentConfig<SiteGenContext>
```

## Parameters

| Name | Type |
|---|---|
| `config` | `SiteGenConfig` |
| `deps` | `SiteGenDependencies` |

**Returns:** `AgentConfig<SiteGenContext>`

<!-- source: graphql-type-createuserinput.md -->

# CreateUserInput

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Input for creating a user

## Referenced By

- `createUser` (TYPE_OF)

<!-- source: type-deviceclass.md -->

# DeviceClass

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/analytics/utils/tracking-utils.ts` (line 53)

## Definition

```ts
'mobile' | 'tablet' | 'desktop' | 'unknown'
```

<!-- source: type-emptystatetype.md -->

# EmptyStateType

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/components/common/EmptyState.tsx` (line 14)

## Definition

```ts
| 'no-projects'
  | 'no-categories'
  | 'no-documents'
  | 'no-search-results'
  | 'no-templates'
  | 'no-versions'
```

<!-- source: interface-existingscreenshot.md -->

# ExistingScreenshot

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot-metadata.service.ts` (line 26)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `assetId` | `string` |
| `url` | `string` |
| `version` | `number` |
| `contentHash` | `string` |
| `stateType` | `string` |
| `flowStepId` | `string` |

<!-- source: class-expressparser-2.md -->

# ExpressParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/backend/express.parser.ts` (line 41)

Express Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: function-extractpropsfromparameter.md -->

# extractPropsFromParameter

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 147)

Extract props from a function component's first parameter

## Signature

```ts
function extractPropsFromParameter(param: t.Node | null | undefined): PropInfo[]
```

## Parameters

| Name | Type |
|---|---|
| `param` | `t.Node | null | undefined` |

**Returns:** `PropInfo[]`

<!-- source: service-featureextractorservice.md -->

# FeatureExtractorService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-03-features/extractor.service.ts` (line 1)

<!-- source: interface-featureiconprops.md -->

# FeatureIconProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/feature-icon.tsx` (line 11)

## Properties

| Property | Type |
|---|---|
| `icon` | `LucideIcon` |
| `size` | `number` |
| `className` | `string` |

<!-- source: api-endpoint-findone.md -->

# findOne

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/src/users/users.controller.ts` (line 41)

## Endpoint

`GET /users/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `UsersController` (MODULE_DECLARES)

<!-- source: service-flowreplayservice.md -->

# FlowReplayService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/flow-replay.service.ts` (line 51)

FlowReplayService (WS-A) — the sequential single-context walk.

Replays a recorded flow in ONE browser context / ONE page, shooting a
screenshot after each action (plus one for the initial state). The first shot
is uploaded immediately ("first shot fast") so the reader sees something while
the rest of the walk runs. Every step is best-effort: a failed step is logged
and the walk continues, mirroring the batch service's resilience.

All heavy lifting reuses the Phase-0 foundation (AuthContextService,
PageSettleService, ActionExecutorService, AnnotationEmitterService, crop
helpers, StorageService, ScreenshotMetadataService) — nothing is forked.

`FlowReplayService` replays a recorded user flow sequentially in a single browser context and single page, capturing a screenshot for the initial state and after each action. It prioritizes uploading the first screenshot immediately (“first shot fast”) so consumers see early feedback while the remaining steps continue. Each step is executed best-effort: failures are logged and the replay continues, reusing the shared Phase-0 services (auth, settle, action execution, annotations, cropping, storage, metadata).

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createFlowJob` | `createFlowJob(dto: FlowReplayRequestDto)` | `Promise<BatchScreenshotJobResponseDto>` |
| `replayFlow` | `replayFlow(jobId: string, dto: FlowReplayRequestDto)` | `Promise<void>` |
| `getFlowSteps` | `getFlowSteps(jobId: string)` | `Promise<FlowStepResult[] | undefined>` |
| `reshootStep` | `reshootStep(dto: FlowReshootRequestDto)` | `Promise<FlowStepResult | null>` |
| `replayForLocales` | `replayForLocales(dto: FlowLocalesRequestDto)` | `Promise<LocaleFlowResult[]>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant Caller
  participant FlowReplayService as FlowReplayService
  participant Auth as AuthContextService
  participant PageSettle as PageSettleService
  participant Exec as ActionExecutorService
  participant Annot as AnnotationEmitterService
  participant Shot as ScreenshotMetadataService
  participant Storage as StorageService

  Caller->>FlowReplayService: replay(flowRecording, options)
  FlowReplayService->>Auth: init single browser context + page
  FlowReplayService->>PageSettle: settle initial state
  FlowReplayService->>Annot: emit annotations (initial)
  FlowReplayService->>Shot: capture + build metadata (initial)
  FlowReplayService->>Storage: upload(initial) (first shot fast)
  FlowReplayService-->>Caller: emit/return initial result (early)

  loop each recorded action
    FlowReplayService->>Exec: execute(action)
    alt action fails
      FlowReplayService->>FlowReplayService: log error, continue
    end
    FlowReplayService->>PageSettle: settle after action
    FlowReplayService->>Annot: emit annotations (step)
    FlowReplayService->>Shot: capture + build metadata (step)
    FlowReplayService->>Storage: upload(step)
  end

  FlowReplayService->>Auth: dispose/cleanup context
  FlowReplayService-->>Caller: final replay result
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { FlowReplayService } from './screenshot/services/flow-replay.service';

@Injectable()
export class FlowReplayRunner {
  constructor(private readonly flowReplay: FlowReplayService) {}

  async runRecordedFlow(flowRecording: any) {
    // Typical call shape: pass the recorded flow + any replay options.
    // (Exact DTOs/options depend on your app; this illustrates usage.)
    const result = await this.flowReplay.replay(flowRecording, {
      // e.g. storagePrefix, viewport, crop, annotations, etc.
      firstShotFast: true,
    });

    // result usually includes per-step screenshot refs/metadata
    // and any logged step errors (best-effort execution).
    return result;
  }
}
```

## AI Coding Instructions

- Keep replays strictly single-context / single-page; do not introduce parallel pages here—use the batch/parallel service for that.
- Preserve the “first shot fast” behavior: upload/emit the initial screenshot as early as possible before executing the rest of the steps.
- Treat each action as best-effort: catch and log step failures, then continue; avoid failing the entire replay unless setup/teardown is broken.
- Reuse Phase-0 integration points (AuthContextService, PageSettleService, ActionExecutorService, AnnotationEmitterService, crop helpers, StorageService, ScreenshotMetadataService) instead of duplicating logic.
- Always run settle + annotation emission before capturing screenshots to avoid flakey, mid-transition images and inconsistent overlays.

## Relationships

- DEPENDS_ON → `playwrightservice`
- DEPENDS_ON → `storageservice`
- DEPENDS_ON → `screenshotmetadataservice`
- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `redisservice`
- DEPENDS_ON → `actionexecutorservice`
- DEPENDS_ON → `authcontextservice`
- DEPENDS_ON → `pagesettleservice`
- DEPENDS_ON → `annotationemitterservice`
- DEPENDS_ON → `configservice`

<!-- source: interface-generatedimageresult.md -->

# GeneratedImageResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 177)

Generated image result from GPT-image-1.5.

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `cdnUrl` | `string` |
| `width` | `number` |
| `height` | `number` |
| `format` | `string` |
| `sizeBytes` | `number` |

<!-- source: function-getfixtureurl.md -->

# getFixtureUrl

**Kind:** Function

**Source:** `atloria-monorepo/apps/screenshot-worker/test/fixtures/pages/index.ts` (line 20)

Get file:// URL for a fixture page

## Signature

```ts
function getFixtureUrl(page: keyof typeof FIXTURE_PAGES): string
```

## Parameters

| Name | Type |
|---|---|
| `page` | `keyof typeof FIXTURE_PAGES` |

**Returns:** `string`

<!-- source: function-getparserinstance.md -->

# getParserInstance

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/queue/processors/parser-registry.ts` (line 132)

Get a parser instance by name

## Signature

```ts
function getParserInstance(name: string): IParser | undefined
```

## Parameters

| Name | Type |
|---|---|
| `name` | `string` |

**Returns:** `IParser | undefined`

<!-- source: type-hookableevent.md -->

# HookableEvent

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/session/hook-registry.ts` (line 36)

Events that can have external command hooks

## Definition

```ts
| 'session_start'
  | 'session_end'
  | 'pre_tool_use'
  | 'post_tool_use'
  | 'pre_compact'
  | 'post_compact'
  | 'subagent_start'
  | 'subagent_end'
  | 'user_prompt_submit'
```

<!-- source: type-howitworkslayout.md -->

# HowItWorksLayout

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 14)

## Definition

```ts
'horizontal' | 'vertical-timeline' | 'cards'
```

<!-- source: constant-image-extensions.md -->

# IMAGE_EXTENSIONS

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/tools/read-file.tool.ts` (line 14)

Supported image file extensions for base64 encoding

<!-- source: type-loadstate.md -->

# LoadState

**Kind:** Type

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 111)

## Definition

```ts
typeof LOAD_STATES[number]
```

<!-- source: constant-load-states.md -->

# LOAD_STATES

**Kind:** Constant

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 110)

<!-- source: graphql-mutation-login.md -->

# login

**Kind:** Graphql Mutation

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Login user

## Relationships

- TYPE_OF → `AuthPayload`

## Referenced By

- `Mutation` (CALLS_API)

<!-- source: interface-mdxgeneratoroptions.md -->

# MdxGeneratorOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/generators/mdx.generator.ts` (line 71)

MDX generator options

## Properties

| Property | Type |
|---|---|
| `outputDir` | `string` |
| `includeSourceCode` | `boolean` |
| `includeRelationships` | `boolean` |
| `customTemplates` | `Record<string, string>` |

<!-- source: type-modalclosemethod.md -->

# ModalCloseMethod

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/utils/modal-extractor.ts` (line 22)

How a modal should be closed

## Definition

```ts
'button-text' | 'data-dismiss' | 'escape' | 'backdrop' | 'auto'
```

<!-- source: type-productknowledgemode.md -->

# ProductKnowledgeMode

**Kind:** Type

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 145)

## Definition

```ts
| 'features'
  | 'workflows'
  | 'categories'
  | 'search'
  | 'stats'
  | 'audiences'
  | 'screenshots'
```

<!-- source: class-registerpage.md -->

# RegisterPage

**Kind:** Class

**Source:** `atloria-monorepo/apps/web-e2e/src/pages/auth.page.ts` (line 89)

Register page object

**Extends:** `BasePage`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `goto` | `goto()` | `Promise<void>` |
| `register` | `register(name: string, email: string, password: string, confirmPassword: string)` | `Promise<void>` |
| `registerAndWait` | `registerAndWait(name: string, email: string, password: string)` | `Promise<void>` |
| `hasError` | `hasError()` | `Promise<boolean>` |
| `getErrorMessage` | `getErrorMessage()` | `Promise<string>` |
| `goToLogin` | `goToLogin()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `nameInput` | `Locator` |
| `emailInput` | `Locator` |
| `passwordInput` | `Locator` |
| `confirmPasswordInput` | `Locator` |
| `termsCheckbox` | `Locator` |
| `submitButton` | `Locator` |
| `errorMessage` | `Locator` |
| `loginLink` | `Locator` |

<!-- source: api-endpoint-reshootflowlocales.md -->

# reshootFlowLocales

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/batch-screenshot.controller.ts` (line 174)

Locale-fanned reshoot (F2 SUPERIOR, synchronous)

POST /api/screenshot/flow/locales

Replays the WHOLE recipe once per locale, emitting a localized screenshot set
per locale under a locale-namespaced blob key. Returns one entry per locale.

## Endpoint

`POST /screenshot/flow/locales`

## Referenced By

- `BatchScreenshotController` (MODULE_DECLARES)

<!-- source: enum-symboltype.md -->

# SymbolType

**Kind:** Enum

**Source:** `atloria-monorepo/apps/api/src/parser/interfaces/code-parser.interface.ts` (line 33)

## Values

- `FUNCTION`
- `CLASS`
- `INTERFACE`
- `TYPE`
- `VARIABLE`
- `CONSTANT`
- `METHOD`
- `PROPERTY`

<!-- source: enum-templatecategory.md -->

# TemplateCategory

**Kind:** Enum

**Source:** `atloria-monorepo/packages/types/src/enums/index.ts` (line 98)

Template categories for organizing document templates

## Values

- `API_DOCUMENTATION`
- `USER_GUIDES`
- `TECHNICAL_SPECS`
- `MEETING_NOTES`
- `REQUIREMENTS`
- `ARCHITECTURE`
- `RELEASE_NOTES`
- `TROUBLESHOOTING`
- `ONBOARDING`
- `GENERAL`

<!-- source: interface-testuser.md -->

# TestUser

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web-e2e/src/fixtures/base.fixture.ts` (line 7)

Test user credentials

## Properties

| Property | Type |
|---|---|
| `email` | `string` |
| `password` | `string` |
| `name` | `string` |

<!-- source: type-userwithprofile.md -->

# UserWithProfile

**Kind:** Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

## Relationships

- EXTENDS → `User`

## Referenced By

- `getUserById` (REFERENCES)
- `User Management API` (TYPE_OF)

<!-- source: enum-versioncomparison.md -->

# VersionComparison

**Kind:** Enum

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/version-config.ts` (line 55)

Version comparison result

## Values

- `Less`
- `Equal`
- `Greater`
- `Invalid`

<!-- source: constant-addexportvisitor.md -->

# addExportVisitor$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 366)

Adds an export visitor to be used when exporting markdown from the Lexical tree.

<!-- source: api-endpoint-admindelete.md -->

# adminDelete

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/comment/comment.controller.ts` (line 211)

Delete a comment (Admin only - can delete any comment)

## Endpoint

`DELETE /documents/:documentId/comments/:id/admin`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `CommentController` (MODULE_DECLARES)

<!-- source: interface-agentresult.md -->

# AgentResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/orchestrator.ts` (line 57)

Result from a single sub-agent execution

## Properties

| Property | Type |
|---|---|
| `agentName` | `string` |
| `focus` | `string` |
| `output` | `string` |
| `usage` | `TokenUsage` |
| `durationMs` | `number` |
| `success` | `boolean` |
| `error` | `string` |

<!-- source: interface-agentstartpayload.md -->

# AgentStartPayload

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/agent/agent.types.ts` (line 28)

Agent WebSocket Protocol Types

Defines the event contract between frontend and backend for real-time
agent sessions. Mirrors the CLI experience over WebSocket.

Client → Server:
  agent:start    — Create a new session
  agent:send     — Send a message to the agent
  agent:inject   — Inject a message mid-task
  agent:cancel   — Cancel the current operation

Server → Client:
  agent:thinking   — Agent is processing
  agent:tool_start — Tool call started
  agent:tool_end   — Tool call completed
  agent:message    — Agent text output (streamed or full)
  agent:todo       — Todo list updated
  agent:turn_done  — Turn completed with usage stats
  agent:error      — Error occurred
  agent:ended      — Session ended

## Properties

| Property | Type |
|---|---|
| `workspace` | `string` |
| `model` | `string` |
| `maxTurns` | `number` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `superMode` | `boolean` |
| `verbose` | `boolean` |
| `autonomous` | `boolean` |
| `testCommand` | `string` |
| `resumeSessionId` | `string` |
| `routingTable` | `'gpt54-family' | import('@atloria/agent-core').ModelRoutingTable` |
| `mode` | `import('@atloria/agent-core').TaskMode` |

<!-- source: interface-aiprovider-3.md -->

# AIProvider

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/ai-provider.interface.ts` (line 40)

Unified AI Provider Interface
All providers must implement this interface for plug-and-play switching.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |

<!-- source: function-always-2.md -->

# always

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/fp.ts` (line 62)

returns a function which when called always returns the passed value

## Signature

```ts
function always(value: T)
```

## Parameters

| Name | Type |
|---|---|
| `value` | `T` |

<!-- source: service-analyticsservice.md -->

# AnalyticsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.service.ts` (line 15)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `trackPageView` | `trackPageView(data: {
    projectId: string;
    docVersionId?: string;
    documentId?: string;
    documentSlug: string;
    sessionId: string;
    referrer?: string;
    userAgent?: string;
    country?: string;
    timeOnPage?: number;
    scrollDepth?: number;
    fingerprint?: string;
    pathname?: string;
    timestamp?: string;
    type?: string;
  }, req: any)` | `unknown` |
| `trackSearch` | `trackSearch(data: {
    projectId: string;
    docVersionId?: string;
    query: string;
    resultsCount: number;
    clickedDocId?: string;
    sessionId: string;
  })` | `unknown` |
| `getOverview` | `getOverview(projectId: string, days: unknown)` | `unknown` |
| `getVersionTraffic` | `getVersionTraffic(projectId: string, days: unknown)` | `unknown` |
| `getTopDocuments` | `getTopDocuments(projectId: string, days: unknown, limit: unknown)` | `unknown` |
| `getTopSearchQueries` | `getTopSearchQueries(projectId: string, days: unknown, limit: unknown)` | `unknown` |
| `getDailyTraffic` | `getDailyTraffic(projectId: string, days: unknown)` | `unknown` |
| `getDeviceBreakdown` | `getDeviceBreakdown(projectId: string, days: unknown)` | `unknown` |
| `getSourceBreakdown` | `getSourceBreakdown(projectId: string, days: unknown)` | `unknown` |
| `getGeoBreakdown` | `getGeoBreakdown(projectId: string, days: unknown)` | `unknown` |
| `getZeroResultSearches` | `getZeroResultSearches(projectId: string, days: unknown, limit: unknown)` | `unknown` |
| `getGhostDocs` | `getGhostDocs(projectId: string, days: unknown, limit: unknown)` | `unknown` |
| `getTrendingDocs` | `getTrendingDocs(projectId: string, days: unknown, limit: unknown)` | `unknown` |
| `getScrollDepthHistogram` | `getScrollDepthHistogram(projectId: string, days: unknown)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: class-atloriabadge.md -->

# AtloriaBadge

**Kind:** Class

**Source:** `atloria-monorepo/packages/ui-core/src/components/badge/Badge.ts` (line 17)

A badge component for displaying status, counts, or labels

**Extends:** `LitElement`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `render` | `render()` | `void` |

## Properties

| Property | Type |
|---|---|
| `styles` | `any` |
| `variant` | `BadgeVariant` |
| `size` | `BadgeSize` |
| `solid` | `any` |
| `outline` | `any` |
| `pill` | `any` |
| `dot` | `any` |
| `removable` | `any` |

<!-- source: controller-audiencecontroller.md -->

# AudienceController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/audience/audience.controller.ts` (line 22)

## Relationships

- MODULE_DECLARES → `list`
- MODULE_DECLARES → `get`
- MODULE_DECLARES → `create`
- MODULE_DECLARES → `update`
- MODULE_DECLARES → `delete`
- DEPENDS_ON → `audienceservice`

<!-- source: interface-authenticationinfo-2.md -->

# AuthenticationInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 653)

Authentication information

## Properties

| Property | Type |
|---|---|
| `type` | `'jwt' | 'oauth' | 'api-key' | 'basic' | 'bearer' | 'none'` |
| `scopes` | `string[]` |
| `optional` | `boolean` |

<!-- source: module-authmodule.md -->

# AuthModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/auth/auth.module.ts` (line 15)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `emailmodule`
- MODULE_IMPORTS → `samlmodule`
- MODULE_DECLARES → `authcontroller`
- MODULE_PROVIDES → `authservice`
- MODULE_PROVIDES → `jwtstrategy`
- MODULE_PROVIDES → `jwtauthguard`
- MODULE_PROVIDES → `rolesguard`
- MODULE_PROVIDES → `organizationguard`
- MODULE_EXPORTS → `authservice`
- MODULE_EXPORTS → `jwtauthguard`
- MODULE_EXPORTS → `rolesguard`
- MODULE_EXPORTS → `organizationguard`

<!-- source: constant-auth-register-throttle.md -->

# AUTH_REGISTER_THROTTLE

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/common/throttling.module.ts` (line 21)

<!-- source: class-azureresponsesmodel.md -->

# AzureResponsesModel

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-adapter.ts` (line 29)

Azure OpenAI Model — implements the SDK's Model interface using Azure Responses API.

**Implements:** `Model`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getResponse` | `getResponse(request: ModelRequest)` | `Promise<ModelResponse>` |
| `getStreamedResponse` | `getStreamedResponse(request: ModelRequest)` | `AsyncIterable<import('@openai/agents').ResponseStreamEvent>` |
| `getRetryAdvice` | `getRetryAdvice(args: ModelRetryAdviceRequest)` | `ModelRetryAdvice | undefined` |

<!-- source: type-badgesize.md -->

# BadgeSize

**Kind:** Type

**Source:** `atloria-monorepo/packages/ui-core/src/components/badge/Badge.ts` (line 6)

## Definition

```ts
'sm' | 'md' | 'lg'
```

<!-- source: interface-batchfileprocessorprops.md -->

# BatchFileProcessorProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Parser/BatchFileProcessor.tsx` (line 9)

## Properties

| Property | Type |
|---|---|
| `onComplete` | `(results: BatchProcessResult[]) => void` |
| `className` | `string` |

<!-- source: class-boundingboxdto.md -->

# BoundingBoxDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/capture/dto/create-flow.dto.ts` (line 19)

Percentage-of-viewport bounding box, for annotation seeding.

## Properties

| Property | Type |
|---|---|
| `x` | `number` |
| `y` | `number` |
| `w` | `number` |
| `h` | `number` |

<!-- source: function-buildevalcommand.md -->

# buildEvalCommand

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-evaluator.ts` (line 112)

Build the CLI command for running the official SWE-bench evaluation harness.

Requires:
- Docker installed and running
- `swebench` Python package installed (`pip install swebench`)
- Pre-built Docker images available (auto-pulled by harness)

## Signature

```ts
function buildEvalCommand(options: EvalCommandOptions): string
```

## Parameters

| Name | Type |
|---|---|
| `options` | `EvalCommandOptions` |

**Returns:** `string`

<!-- source: function-buildllmsfulltxt.md -->

# buildLlmsFullTxt

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/llms-txt.ts` (line 120)

## Signature

```ts
function buildLlmsFullTxt(doc: LlmsDoc): string
```

## Parameters

| Name | Type |
|---|---|
| `doc` | `LlmsDoc` |

**Returns:** `string`

<!-- source: function-buildprojecturl.md -->

# buildProjectUrl

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/url-utils.ts` (line 122)

Build a project URL from components

In production with NEXT_PUBLIC_DOCS_DOMAIN set, returns the subdomain URL.
Locally (no env var), falls back to the /p/ path.

## Signature

```ts
function buildProjectUrl(slug: string, urlId: string): string
```

## Parameters

| Name | Type |
|---|---|
| `slug` | `string` |
| `urlId` | `string` |

**Returns:** `string`

<!-- source: function-buildsectiontaskprompt.md -->

# buildSectionTaskPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/copywriter.prompts.ts` (line 55)

Section-specific task prompts — each section type gets a tailored brief.

## Signature

```ts
function buildSectionTaskPrompt(sectionType: SectionType, docContext: string): string
```

## Parameters

| Name | Type |
|---|---|
| `sectionType` | `SectionType` |
| `docContext` | `string` |

**Returns:** `string`

<!-- source: function-clampscrolldepth.md -->

# clampScrollDepth

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/analytics/utils/tracking-utils.ts` (line 47)

Clamp scroll depth into the 0–100 range. Some browsers occasionally report
101% on bounce or with sticky footers; clamp instead of dropping the row.

## Signature

```ts
function clampScrollDepth(depth: number | null | undefined): number | null
```

## Parameters

| Name | Type |
|---|---|
| `depth` | `number | null | undefined` |

**Returns:** `number | null`

<!-- source: function-clearandtype.md -->

# clearAndType

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 30)

Clear input field and type new value

## Signature

```ts
async function clearAndType(locator: Locator, text: string): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `locator` | `Locator` |
| `text` | `string` |

**Returns:** `Promise<void>`

<!-- source: component-columneditor-2.md -->

# ColumnEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/table/TableEditor.tsx` (line 490)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `parentEditor` | `any` | ✓ | - |
| `highlightedCoordinates` | `any` | ✓ | - |
| `align` | `any` | ✓ | - |
| `lexicalTable` | `any` | ✓ | - |
| `colIndex` | `any` | ✓ | - |
| `setActiveCellWithBoundaries` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ColumnEditor_594d93["ColumnEditor"]
    class component_ColumnEditor_594d93 rootComponent
```

## Relationships

- RENDERS → `RadixPopover-Root`
- RENDERS → `RadixPopover-PopoverTrigger`
- RENDERS → `RadixPopover-Portal`
- RENDERS → `RadixPopover-PopoverContent`
- RENDERS → `RadixToolbar-Root`
- RENDERS → `RadixToolbar-ToggleGroup`
- RENDERS → `RadixToolbar-ToggleItem`
- RENDERS → `RadixToolbar-Separator`
- RENDERS → `RadixToolbar-Button`
- RENDERS → `RadixPopover-Arrow`
- USES_HOOK → `useCellValues`
- USES_HOOK → `useCallback`
- USES_HOOK → `useTranslation`

## Referenced By

- `TableEditor` (RENDERS)

<!-- source: component-comparisonsidebyside.md -->

# ComparisonSideBySide

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/comparison/comparison-side-by-side.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `before` | `ComparisonColumn` | ✓ | - |
| `after` | `ComparisonColumn` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ComparisonSideBySide_4551bff3["ComparisonSideBySide"]
    class component_ComparisonSideBySide_4551bff3 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `X`
- RENDERS → `Check`
- USES_HOOK → `useTranslation`

<!-- source: function-createvalidateconfigtool.md -->

# createValidateConfigTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/validate-config.tool.ts` (line 12)

## Signature

```ts
function createValidateConfigTool(componentLibraryDir: string): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `componentLibraryDir` | `string` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: interface-databasemodelentity.md -->

# DatabaseModelEntity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 620)

Database Model entity

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.DATABASE_MODEL` |
| `tableName` | `string` |
| `fields` | `FieldDefinition[]` |
| `indexes` | `IndexDefinition[]` |
| `relations` | `RelationDefinition[]` |
| `orm` | `'prisma' | 'typeorm' | 'sequelize' | 'mongoose' | 'drizzle' | 'raw'` |
| `primaryKey` | `string[]` |
| `uniqueConstraints` | `UniqueConstraint[]` |

<!-- source: class-dataconfigdto.md -->

# DataConfigDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 232)

Data state configuration

## Properties

| Property | Type |
|---|---|
| `dataState` | `'empty' | 'populated' | 'error'` |
| `prerequisite` | `string` |
| `mockResponse` | `string` |
| `seedData` | `string` |
| `resetAfter` | `boolean` |

<!-- source: constant-desk-state-labels.md -->

# DESK_STATE_LABELS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 139)

## Definition

```ts
Record<DeskState, string>
```

<!-- source: type-docaudiencescope.md -->

# DocAudienceScope

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/project/audience-scope.util.ts` (line 11)

Audience → doc-set scope mapping.

A project serves multiple doc SETS side-by-side (user manual + technical
reference). Each DocVersion belongs to exactly one scope
(DocVersion.audienceScope) and each scope has its own independent ACTIVE
version. Audiences (viewer URL segments like /p/:slug/:audienceSlug) map
onto a scope so public reads resolve the ACTIVE version of the RIGHT set.

## Definition

```ts
'user' | 'technical'
```

<!-- source: component-entityicon.md -->

# EntityIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/components/EntityTree.tsx` (line 95)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `type` | `string` | - | - |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_EntityIcon_25c38ad2["EntityIcon"]
    class component_EntityIcon_25c38ad2 rootComponent
```

## Relationships

- RENDERS → `CogIcon`
- RENDERS → `CommandLineIcon`
- RENDERS → `CircleStackIcon`
- RENDERS → `CubeIcon`
- RENDERS → `ShieldCheckIcon`
- RENDERS → `PuzzlePieceIcon`
- RENDERS → `CodeBracketIcon`
- RENDERS → `DocumentTextIcon`

## Referenced By

- `AppSection` (RENDERS)
- `EntityTree` (RENDERS)

<!-- source: function-extractpropsfromtypeannotation.md -->

# extractPropsFromTypeAnnotation

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 194)

Extract props from TypeScript type annotation

## Signature

```ts
function extractPropsFromTypeAnnotation(typeNode: t.TSType): PropInfo[]
```

## Parameters

| Name | Type |
|---|---|
| `typeNode` | `t.TSType` |

**Returns:** `PropInfo[]`

<!-- source: class-fastapiparser-2.md -->

# FastAPIParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/backend/fastapi.parser.ts` (line 35)

FastAPI Parser implementation

Uses regex-based parsing for Python files since we can't use Python AST directly in Node.js

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: interface-featureshorizontalflowprops.md -->

# FeaturesHorizontalFlowProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/features/features-horizontal-flow.tsx` (line 19)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `features` | `Feature[]` |

<!-- source: interface-flowstepresult.md -->

# FlowStepResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/flow-replay.dto.ts` (line 172)

Per-step replay result, surfaced through the batch status endpoint so the api
stitcher can place each screenshot as it becomes available.

`flowStepId`:   0 = initial state (before any action); N = state AFTER step N.
`blobUrl`:      the canonical FULL-PAGE image (flowKey without variant).
`annotationsFragment`: `#atloria-annotations=…` overlay fragment, or '' if the
                step's target could not be located.

## Properties

| Property | Type |
|---|---|
| `flowStepId` | `number` |
| `blobUrl` | `string` |
| `annotationsFragment` | `string` |

<!-- source: type-gapdraftstate.md -->

# GapDraftState

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/ThreadList.tsx` (line 25)

## Definition

```ts
| { phase: 'drafting' }
  | { phase: 'drafted'; documentId: string }
  | { phase: 'error'; message: string }
```

<!-- source: function-generatejson.md -->

# generateJson

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/generators/json.generator.ts` (line 67)

Generate JSON output files

## Signature

```ts
async function generateJson(results: ParseResult[], project: DetectedProject, outputDir: string): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `results` | `ParseResult[]` |
| `project` | `DetectedProject` |
| `outputDir` | `string` |

**Returns:** `Promise<void>`

<!-- source: interface-generationconfig.md -->

# GenerationConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 59)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `userId` | `string` |
| `targetAudience` | `string` |
| `brandVoice` | `string` |
| `language` | `string` |
| `additionalLanguages` | `string[]` |
| `pageType` | `PageType` |
| `sections` | `SectionType[]` |
| `model` | `string` |
| `theme` | `ThemeConfig` |
| `visuals` | `VisualConfig` |
| `enableVariants` | `boolean` |
| `enableThemeToggle` | `boolean` |
| `enableImageGeneration` | `boolean` |

<!-- source: service-generatorservice.md -->

# GeneratorService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/generator.service.ts` (line 1)

<!-- source: api-endpoint-getavailableparsers.md -->

# getAvailableParsers

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/orchestrator.controller.ts` (line 182)

Get available parsers

## Endpoint

`GET /api/orchestrator/parsers`

## Referenced By

- `OrchestratorController` (MODULE_DECLARES)

<!-- source: function-getparsersbycategory.md -->

# getParsersByCategory

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/queue/processors/parser-registry.ts` (line 173)

Get parser names by category
Note: API Schema parsers (openapi, graphql) are handled by the api-schema-parser microservice

## Signature

```ts
function getParsersByCategory(): Record<string, string[]>
```

**Returns:** `Record<string, string[]>`

<!-- source: type-hooksconfig.md -->

# HooksConfig

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/session/hook-registry.ts` (line 64)

The top-level hooks configuration object

## Definition

```ts
Partial<Record<HookableEvent, HookDefinition[]>>
```

<!-- source: type-imagegeneratefn.md -->

# ImageGenerateFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/tools/generate-image.tool.ts` (line 18)

Function signature for image generation.
Injected at creation time — keeps tool code framework-agnostic.

## Definition

```ts
(
  prompt: string,
  options?: {
    width?: number;
    height?: number;
    background?: 'transparent' | 'opaque' | 'auto';
    quality?: 'low' | 'medium' | 'high';
  }
) => Promise<GeneratedImageResult>
```

<!-- source: type-modaltriggertype.md -->

# ModalTriggerType

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/utils/modal-extractor.ts` (line 19)

Modal/Popup/Dialog Extractor

Extracts modal, popup, and dialog definitions from source code and templates
across multiple frontend frameworks. Finds:
- Angular: openPopup(), MatDialog.open(), modalService.show(), app-shared-popup
- React: useState modal patterns, <Modal>, <Dialog>
- Vue: v-model dialogs, $modal.show(), $bvModal.show()
- DevExtreme: dx-popup, dxPopupOptions
- Generic: Bootstrap modals, jQuery .modal() calls

Validated against real-world patterns from PAMS (Angular + DevExtreme).

## Definition

```ts
'direct' | 'programmatic' | 'navigation'
```

<!-- source: interface-navitem.md -->

# NavItem

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/generators/mdx.generator.ts` (line 62)

Navigation structure for API sync

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `href` | `string` |
| `children` | `NavItem[]` |

<!-- source: constant-no-routing-table.md -->

# NO_ROUTING_TABLE

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-router.ts` (line 99)

Single-model routing table (no routing).
All categories use the default model.
This is the implicit behavior when no routing table is configured.

## Definition

```ts
ModelRoutingTable
```

<!-- source: service-pageprofilerservice.md -->

# PageProfilerService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/discovery/page-profiler.service.ts` (line 50)

Profiles a page's interactive elements using a single page.evaluate() call.
ARIA-first selectors with framework-specific fallbacks.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `profilePage` | `profilePage(page: Page)` | `Promise<RawPageProfile>` |

<!-- source: graphql-type-postconnection.md -->

# PostConnection

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Paginated post list

## Relationships

- TYPE_OF → `Post`

## Referenced By

- `posts` (TYPE_OF)

<!-- source: type-profile.md -->

# Profile

**Kind:** Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `bio` | `string` |
| `avatarUrl` | `string` |
| `website` | `string` |
| `location` | `string` |

## Referenced By

- `User Management API` (TYPE_OF)

<!-- source: graphql-mutation-refreshtoken.md -->

# refreshToken

**Kind:** Graphql Mutation

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Refresh access token

## Relationships

- TYPE_OF → `AuthPayload`

## Referenced By

- `Mutation` (CALLS_API)

<!-- source: api-endpoint-reshootflowstep.md -->

# reshootFlowStep

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/batch-screenshot.controller.ts` (line 152)

Re-shoot ONE step of a recipe (F2, synchronous)

POST /api/screenshot/flow/reshoot

Walks the recipe up to `targetStepId` in a single context and re-captures just
that step — optionally at a new viewport / UI locale — burning any per-step
redactions into the fresh asset. Overwrites the canonical blob key and returns
the fresh { flowStepId, blobUrl, annotationsFragment } so the api can respond.

## Endpoint

`POST /screenshot/flow/reshoot`

## Referenced By

- `BatchScreenshotController` (MODULE_DECLARES)

<!-- source: class-saveastemplatemodal.md -->

# SaveAsTemplateModal

**Kind:** Class

**Source:** `atloria-monorepo/apps/web-e2e/src/pages/templates.page.ts` (line 216)

Save as template modal page object

**Extends:** `BasePage`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `goto` | `goto()` | `Promise<void>` |
| `fillDetails` | `fillDetails(name: string, description: string, category: string)` | `Promise<void>` |
| `save` | `save()` | `Promise<void>` |
| `cancel` | `cancel()` | `Promise<void>` |
| `isVisible` | `isVisible()` | `Promise<boolean>` |

## Properties

| Property | Type |
|---|---|
| `modal` | `Locator` |
| `nameInput` | `Locator` |
| `descriptionInput` | `Locator` |
| `categorySelect` | `Locator` |
| `saveButton` | `Locator` |
| `cancelButton` | `Locator` |

<!-- source: type-screenshotconfig.md -->

# ScreenshotConfig

**Kind:** Type

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/config/screenshot.config.ts` (line 55)

Type for screenshot configuration

## Definition

```ts
ReturnType<typeof screenshotConfig>
```

<!-- source: constant-screenshot-config-key.md -->

# SCREENSHOT_CONFIG_KEY

**Kind:** Constant

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/config/screenshot.config.ts` (line 60)

Configuration keys for injection

<!-- source: type-searchdocsfn.md -->

# SearchDocsFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/query-product-knowledge.tool.ts` (line 48)

Full-text search across generated documentation.

## Definition

```ts
(
  projectId: string,
  query: string,
  options?: { limit?: number; documentType?: string; audience?: string },
) => Promise<ProductDocument[]>
```

<!-- source: enum-syncjobscope.md -->

# SyncJobScope

**Kind:** Enum

**Source:** `atloria-monorepo/apps/api/src/project/dto/sync-job.dto.ts` (line 17)

Sync job scope

## Values

- `ORGANIZATION`
- `PROJECT`

<!-- source: interface-testuserdata.md -->

# TestUserData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `email` | `string` |
| `name` | `string` |
| `password` | `string` |
| `avatar` | `string` |

<!-- source: enum-userrole.md -->

# UserRole

**Kind:** Enum

**Source:** `atloria-monorepo/packages/types/src/enums/index.ts` (line 10)

Enums for Atloria
These enums match the Prisma schema and are used throughout the application
Note: These are maintained separately from

## Values

- `ADMIN`
- `MAINTAINER`
- `CONTRIBUTOR`
- `VIEWER`

<!-- source: constant-addimportvisitor.md -->

# addImportVisitor$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 348)

Registers a visitor to be used when importing markdown.

<!-- source: interface-agentruntimeoptions.md -->

# AgentRuntimeOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 290)

Options for the AgentRuntime constructor.
These configure Runner-level behavior that applies to all runs.

## Properties

| Property | Type |
|---|---|
| `tracingDisabled` | `boolean` |
| `handoffInputFilter` | `(data: {
    inputHistory: unknown;
    preHandoffItems: unknown[];
    newItems: unknown[];
  }) => { inputHistory: unknown; preHandoffItems: unknown[]; newItems: unknown[] }` |

<!-- source: interface-agentthinkingevent.md -->

# AgentThinkingEvent

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/agent/agent.types.ts` (line 92)

## Properties

| Property | Type |
|---|---|
| `agentName` | `string` |

<!-- source: interface-airesponse-2.md -->

# AIResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/ai-provider.interface.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `content` | `string` |
| `inputTokens` | `number` |
| `outputTokens` | `number` |
| `model` | `string` |
| `stopReason` | `string` |

<!-- source: function-analyzechunkrelationships.md -->

# analyzeChunkRelationships

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-02-chunking/chunk-relationship-graph.ts` (line 244)

Analyze chunk relationships for documentation purposes

## Signature

```ts
function analyzeChunkRelationships(graph: ChunkRelationshipGraph): ChunkRelationshipSummary
```

## Parameters

| Name | Type |
|---|---|
| `graph` | `ChunkRelationshipGraph` |

**Returns:** `ChunkRelationshipSummary`

<!-- source: api-endpoint-applyedit.md -->

# applyEdit

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 84)

## Endpoint

`POST /doc-versions/:projectId/apply-edit`

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: service-appservice-2.md -->

# AppService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/app/app.service.ts` (line 5)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getData` | `getData()` | `unknown` |
| `getPublicStats` | `getPublicStats()` | `unknown` |
| `healthCheck` | `healthCheck()` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `redisservice`

<!-- source: class-atloriabutton.md -->

# AtloriaButton

**Kind:** Class

**Source:** `atloria-monorepo/packages/ui-core/src/components/button/Button.ts` (line 22)

A versatile button component with multiple variants and sizes

**Extends:** `LitElement`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `render` | `render()` | `void` |

## Properties

| Property | Type |
|---|---|
| `styles` | `any` |
| `variant` | `ButtonVariant` |
| `size` | `ButtonSize` |
| `disabled` | `any` |
| `loading` | `any` |
| `type` | `'button' | 'submit' | 'reset'` |
| `ariaLabel` | `string | null` |

<!-- source: controller-auditcontroller.md -->

# AuditController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/audit/audit.controller.ts` (line 8)

## Relationships

- MODULE_DECLARES → `query`
- MODULE_DECLARES → `exportCSV`
- MODULE_DECLARES → `exportJSON`
- DEPENDS_ON → `auditservice`

<!-- source: type-badgevariant.md -->

# BadgeVariant

**Kind:** Type

**Source:** `atloria-monorepo/packages/ui-core/src/components/badge/Badge.ts` (line 5)

## Definition

```ts
'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'info'
```

<!-- source: class-bashsession.md -->

# BashSession

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/tools/bash-session.ts` (line 48)

A persistent shell session that maintains cwd, env vars, and venv activation
across commands. Spawns a single bash process and sends commands via stdin,
reading output until a unique delimiter marker signals completion.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `start` | `start()` | `Promise<void>` |
| `execute` | `execute(command: string, options: { timeout?: number })` | `Promise<BashResult>` |
| `getCwd` | `getCwd()` | `string` |
| `isDisposed` | `isDisposed()` | `boolean` |
| `isRunning` | `isRunning()` | `boolean` |
| `dispose` | `dispose()` | `void` |

<!-- source: interface-batchprocessresult.md -->

# BatchProcessResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Parser/BatchFileProcessor.tsx` (line 14)

## Properties

| Property | Type |
|---|---|
| `filename` | `string` |
| `result` | `ParseResult` |
| `error` | `string` |
| `status` | `'pending' | 'processing' | 'success' | 'error'` |

<!-- source: module-billingmodule.md -->

# BillingModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/billing/billing.module.ts` (line 12)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `configmodule`
- MODULE_IMPORTS → `aimodule`
- MODULE_DECLARES → `billingcontroller`
- MODULE_PROVIDES → `billingservice`
- MODULE_EXPORTS → `billingservice`

<!-- source: constant-bugreporttemplate.md -->

# bugReportTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/bug-report.template.ts` (line 3)

<!-- source: function-buildexplorationplan.md -->

# buildExplorationPlan

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/workflows/exploration.ts` (line 35)

Build a codebase exploration plan.

Launches 3 parallel explorers that investigate the codebase from different
angles, then synthesizes their findings into a unified understanding.

## Signature

```ts
function buildExplorationPlan(options: {
  query?: string;
  workspace?: string;
}): OrchestrationPlan
```

## Parameters

| Name | Type |
|---|---|
| `options` | `{
  query?: string;
  workspace?: string;
}` |

**Returns:** `OrchestrationPlan`

<!-- source: function-buildllmstxt.md -->

# buildLlmsTxt

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/llms-txt.ts` (line 92)

## Signature

```ts
function buildLlmsTxt(doc: LlmsDoc, opts: LlmsTxtOptions): string
```

## Parameters

| Name | Type |
|---|---|
| `doc` | `LlmsDoc` |
| `opts` | `LlmsTxtOptions` |

**Returns:** `string`

<!-- source: function-buildsemanticutilities.md -->

# buildSemanticUtilities

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/theme.ts` (line 162)

Build semantic utility classes that map to CSS vars.
These replace hardcoded Tailwind color classes.

## Signature

```ts
function buildSemanticUtilities(): string
```

**Returns:** `string`

<!-- source: class-bulkcapturescreenshotsdto.md -->

# BulkCaptureScreenshotsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/screenshot/dto/capture-screenshot.dto.ts` (line 101)

DTO for bulk screenshot capture (job-based)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `urls` | `string[]` |
| `viewport` | `ViewportType` |
| `browser` | `BrowserType` |
| `waitTime` | `number` |

<!-- source: interface-buttonelement.md -->

# ButtonElement

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/template-analysis.interface.ts` (line 14)

Template Analysis Interfaces

Defines structured data extracted from Angular/Vue templates
for user journey diagram generation.

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `action` | `string` |
| `line` | `number` |
| `conditionalOn` | `string` |
| `routerLink` | `string` |
| `type` | `string` |
| `attributes` | `Record<string, string>` |

<!-- source: function-calculatedocumentcentriclayout.md -->

# calculateDocumentCentricLayout

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Graph/graphUtils.ts` (line 72)

Calculate hierarchical layout for document-centric view

## Signature

```ts
function calculateDocumentCentricLayout(documentId: string, entities: KGEntity[], relationships: KGRelationship[]): { nodes: GraphNode[]; edges: GraphEdge[] }
```

## Parameters

| Name | Type |
|---|---|
| `documentId` | `string` |
| `entities` | `KGEntity[]` |
| `relationships` | `KGRelationship[]` |

**Returns:** `{ nodes: GraphNode[]; edges: GraphEdge[] }`

<!-- source: function-clamptimeonpage.md -->

# clampTimeOnPage

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/analytics/utils/tracking-utils.ts` (line 37)

Clamp a raw time-on-page value to a reasonable upper bound and floor at 0.
Returns null if the input is null/undefined so the column stays nullable.

## Signature

```ts
function clampTimeOnPage(timeOnPage: number | null | undefined): number | null
```

## Parameters

| Name | Type |
|---|---|
| `timeOnPage` | `number | null | undefined` |

**Returns:** `number | null`

<!-- source: function-closemodal.md -->

# closeModal

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 98)

Close a modal/dialog

## Signature

```ts
async function closeModal(page: Page): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |

**Returns:** `Promise<void>`

<!-- source: function-createvalidatelinkstool.md -->

# createValidateLinksTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/validate-links.tool.ts` (line 38)

## Signature

```ts
function createValidateLinksTool(): ToolDefinition<TContext>
```

**Returns:** `ToolDefinition<TContext>`

<!-- source: component-ctabanner.md -->

# CtaBanner

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/cta/cta-banner.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `icon` | `LucideIcon` | - | - |

## Diagram

```mermaid
graph TD
    component_CtaBanner_54d8e8bc["CtaBanner"]
    class component_CtaBanner_54d8e8bc rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Icon`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- USES_HOOK → `useTranslation`

<!-- source: component-datebadge-2.md -->

# DateBadge

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/social-proof/social-proof-timeline.tsx` (line 23)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `dateKey` | `string` | ✓ | - |
| `t` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DateBadge_257ada65["DateBadge"]
    class component_DateBadge_257ada65 rootComponent
```

## Referenced By

- `MilestoneCard` (RENDERS)

<!-- source: interface-dependencyinfo.md -->

# DependencyInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 750)

Dependency injection info

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `token` | `string` |
| `optional` | `boolean` |

<!-- source: class-discoveryauthconfigdto.md -->

# DiscoveryAuthConfigDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/discovery/dto/discovery.dto.ts` (line 13)

## Properties

| Property | Type |
|---|---|
| `loginUrl` | `string` |
| `username` | `string` |
| `password` | `string` |
| `usernameSelector` | `string` |
| `passwordSelector` | `string` |
| `submitSelector` | `string` |
| `successSelector` | `string` |

<!-- source: constant-dynamic.md -->

# dynamic

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/app/layout.tsx` (line 7)

<!-- source: type-eventtype.md -->

# EventType

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/events/events.service.ts` (line 20)

## Definition

```ts
(typeof EVENT_TYPES)[number]
```

<!-- source: component-externalicon.md -->

# ExternalIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/DependencyGraph.tsx` (line 103)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_ExternalIcon_2da639e7["ExternalIcon"]
    class component_ExternalIcon_2da639e7 rootComponent
```

## Referenced By

- `DependencyGraph` (RENDERS)
- `DependencyCard` (RENDERS)

<!-- source: function-extractrenderedcomponents.md -->

# extractRenderedComponents

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 352)

Extract rendered child components (JSX elements that start with uppercase)

## Signature

```ts
function extractRenderedComponents(path: NodePath): string[]
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath` |

**Returns:** `string[]`

<!-- source: interface-featuresinteractivetabsprops.md -->

# FeaturesInteractiveTabsProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/features/features-interactive-tabs.tsx` (line 23)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `tabs` | `Tab[]` |

<!-- source: class-filescanner.md -->

# FileScanner

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/utils/file-scanner.ts` (line 86)

File Scanner Class

Provides methods for scanning directories, finding files by glob patterns,
and respecting .gitignore rules.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `scan` | `scan(config: FileScannerConfig)` | `Promise<ScannedFile[]>` |
| `scanWithContent` | `scanWithContent(config: FileScannerConfig)` | `Promise<ScannedFile[]>` |
| `getFileStats` | `getFileStats(filePath: string)` | `Promise<FileStats | null>` |
| `readFile` | `readFile(filePath: string)` | `Promise<string | null>` |
| `matchesPattern` | `matchesPattern(filePath: string, pattern: string)` | `boolean` |
| `parseGitignore` | `parseGitignore(rootDir: string)` | `Promise<string[]>` |
| `countFiles` | `countFiles(config: FileScannerConfig)` | `Promise<number>` |
| `groupByExtension` | `groupByExtension(files: ScannedFile[])` | `Record<string, ScannedFile[]>` |
| `groupByDirectory` | `groupByDirectory(files: ScannedFile[])` | `Record<string, ScannedFile[]>` |
| `getSupportedExtensions` | `getSupportedExtensions()` | `ExtensionCategories` |
| `createPatternForExtensions` | `createPatternForExtensions(extensions: string[])` | `string` |
| `getTypescriptPatterns` | `getTypescriptPatterns()` | `string[]` |
| `getDefaultExcludePatterns` | `getDefaultExcludePatterns()` | `string[]` |

<!-- source: function-generatemdx.md -->

# generateMdx

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/generators/mdx.generator.ts` (line 1589)

Generate MDX documentation

## Signature

```ts
async function generateMdx(provider: DataProvider, outputDir: string, options: Partial<MdxGeneratorOptions>): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `provider` | `DataProvider` |
| `outputDir` | `string` |
| `options` | `Partial<MdxGeneratorOptions>` |

**Returns:** `Promise<void>`

<!-- source: api-endpoint-getfollowers.md -->

# getFollowers

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/src/users/users.controller.ts` (line 86)

## Endpoint

`GET /users/:id/followers`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `UsersController` (MODULE_DECLARES)

<!-- source: function-getprojectfilesbyextension.md -->

# getProjectFilesByExtension

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 81)

Get files by extension from a project

## Signature

```ts
function getProjectFilesByExtension(projectPath: string, extensions: string[]): string[]
```

## Parameters

| Name | Type |
|---|---|
| `projectPath` | `string` |
| `extensions` | `string[]` |

**Returns:** `string[]`

<!-- source: type-graphedge.md -->

# GraphEdge

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/components/Graph/types.ts` (line 63)

## Definition

```ts
Edge
```

<!-- source: interface-htmlqualityconfig.md -->

# HtmlQualityConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/html-quality.guardrail.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `requireViewport` | `boolean` |
| `requireAlt` | `boolean` |
| `flagInlineStyles` | `boolean` |
| `maxInlineStyles` | `number` |

<!-- source: service-hybridmapperservice.md -->

# HybridMapperService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/hybrid-mapper.service.ts` (line 1)

<!-- source: type-instructionzone.md -->

# InstructionZone

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/context/instruction-loader.ts` (line 76)

## Definition

```ts
'system' | 'project' | 'task' | 'turn'
```

<!-- source: type-jobstatus-3.md -->

# JobStatus

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 148)

Job status for tracking generation progress.

## Definition

```ts
| 'queued'
  | 'processing'
  | 'generating_content'
  | 'generating_visuals'
  | 'assembling'
  | 'completed'
  | 'failed'
```

<!-- source: interface-localeflowresult.md -->

# LocaleFlowResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/flow-replay.dto.ts` (line 225)

One locale's full screenshot set from a locale-fanned reshoot.

## Properties

| Property | Type |
|---|---|
| `locale` | `string` |
| `steps` | `FlowStepResult[]` |

<!-- source: service-pagesettleservice.md -->

# PageSettleService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/page-settle.service.ts` (line 10)

Service for waiting until a page has fully settled before capture.

Extracted verbatim from BatchScreenshotService so batch capture, flow-replay
(WS-A) and clip capture (WS-B) share one framework-agnostic settle strategy.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectLongPollingApp` | `detectLongPollingApp(page: Page)` | `Promise<boolean>` |
| `waitForAngularAppReady` | `waitForAngularAppReady(page: Page, timeoutMs: number)` | `Promise<void>` |
| `waitForPageReady` | `waitForPageReady(page: Page, timeoutMs: number)` | `Promise<void>` |
| `waitForDomStability` | `waitForDomStability(page: Page, checkIntervalMs: number, maxChecks: number)` | `Promise<void>` |

<!-- source: constant-plan-mode-allowed-tools.md -->

# PLAN_MODE_ALLOWED_TOOLS

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/session/plan-mode-filter.ts` (line 15)

Tools allowed during plan mode (read-only investigation)

<!-- source: graphql-type-profile.md -->

# Profile

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

User profile information

## Referenced By

- `User` (TYPE_OF)

<!-- source: interface-projectmetadata.md -->

# ProjectMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/providers/data-provider.interface.ts` (line 16)

Project metadata from either source

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `type` | `string` |
| `rootDir` | `string` |
| `frameworks` | `string[]` |
| `statistics` | `{
    totalFiles: number;
    parsedFiles: number;
    entityCounts: Record<string, number>;
  }` |
| `generatedAt` | `string` |

<!-- source: type-rolesourcetype.md -->

# RoleSourceType

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/utils/permission-extractor.ts` (line 17)

Permission Extractor

Extracts permission checks, route guards, role definitions, and
authentication configuration from source code. Detects both hardcoded
and dynamic role-based access control patterns.

## Definition

```ts
'hardcoded' | 'database' | 'external' | 'unknown'
```

<!-- source: api-endpoint-scan.md -->

# scan

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/discovery/discovery.controller.ts` (line 17)

POST /api/discovery/scan

Scans a web application via headless browser: login → menu walk → page profiling → grid depth.
Returns a SiteMap with all discovered routes and their element profiles.

Synchronous — typical runtime ~6 min for a 50-page app.

## Endpoint

`POST /discovery/scan`

## Referenced By

- `DiscoveryController` (MODULE_DECLARES)

<!-- source: constant-screenshotconfig.md -->

# screenshotConfig

**Kind:** Constant

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/config/screenshot.config.ts` (line 9)

Screenshot configuration

All values can be overridden via environment variables.
This replaces the hardcoded DEFAULTS object in batch-screenshot.service.ts.

<!-- source: class-sharedocumentmodal.md -->

# ShareDocumentModal

**Kind:** Class

**Source:** `atloria-monorepo/apps/web-e2e/src/pages/collaboration.page.ts` (line 184)

Share document modal page object

**Extends:** `BasePage`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `goto` | `goto()` | `Promise<void>` |
| `inviteUser` | `inviteUser(email: string, permission: 'view' | 'edit')` | `Promise<void>` |
| `getSharedUsers` | `getSharedUsers()` | `Locator` |
| `getSharedUserCount` | `getSharedUserCount()` | `Promise<number>` |
| `removeUser` | `removeUser(email: string)` | `Promise<void>` |
| `copyLink` | `copyLink()` | `Promise<void>` |
| `close` | `close()` | `Promise<void>` |
| `isVisible` | `isVisible()` | `Promise<boolean>` |

## Properties

| Property | Type |
|---|---|
| `modal` | `Locator` |
| `emailInput` | `Locator` |
| `permissionSelect` | `Locator` |
| `inviteButton` | `Locator` |
| `sharedUsersList` | `Locator` |
| `copyLinkButton` | `Locator` |
| `closeButton` | `Locator` |

<!-- source: type-statetype.md -->

# StateType

**Kind:** Type

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 311)

## Definition

```ts
typeof STATE_TYPES[number]
```

<!-- source: enum-syncjobstatus.md -->

# SyncJobStatus

**Kind:** Enum

**Source:** `atloria-monorepo/apps/api/src/project/dto/sync-job.dto.ts` (line 6)

Sync job status enum

## Values

- `PENDING`
- `RUNNING`
- `COMPLETED`
- `FAILED`
- `CANCELLED`

<!-- source: graphql-mutation-unfollowuser.md -->

# unfollowUser

**Kind:** Graphql Mutation

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Unfollow a user

## Referenced By

- `Mutation` (CALLS_API)

<!-- source: enum-websocketstate.md -->

# WebSocketState

**Kind:** Enum

**Source:** `atloria-monorepo/packages/api-client/src/clients/WebSocketClient.ts` (line 4)

WebSocket connection states

## Values

- `CONNECTING`
- `OPEN`
- `CLOSING`
- `CLOSED`

<!-- source: constant-addlexicalnode.md -->

# addLexicalNode$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 342)

Registers a lexical node to be used in the editor.

<!-- source: interface-agenttemplate.md -->

# AgentTemplate

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/orchestrator.ts` (line 28)

A template for spawning a sub-agent within a phase

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `focus` | `string` |
| `instructions` | `string` |
| `tools` | `string[]` |
| `model` | `string` |
| `category` | `TaskCategory` |

<!-- source: interface-agenttodoevent.md -->

# AgentTodoEvent

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/agent/agent.types.ts` (line 114)

## Properties

| Property | Type |
|---|---|
| `items` | `Array<{
    id: string;
    description: string;
    status: 'pending' | 'in_progress' | 'completed' | 'skipped';
    result?: string;
  }>` |
| `stats` | `{
    total: number;
    completed: number;
    pending: number;
    inProgress: number;
    skipped: number;
  }` |

<!-- source: interface-aisession.md -->

# AISession

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-08.types.ts` (line 28)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `phaseId` | `string` |
| `type` | `'parent' | 'child'` |
| `parentSessionId` | `string` |
| `documentIds` | `string[]` |
| `tokenBudget` | `{
    input: number;
    output: number;
  }` |
| `sharedContext` | `SharedContext` |
| `status` | `'pending' | 'running' | 'completed' | 'failed'` |

<!-- source: function-apiclient.md -->

# apiClient

**Kind:** Function

**Source:** `atloria-monorepo/packages/api-client/src/lib/api-client.ts` (line 1)

## Signature

```ts
function apiClient(): string
```

**Returns:** `string`

<!-- source: api-endpoint-approve.md -->

# approve

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 580)

## Endpoint

`POST /doc-versions/:projectId/:versionId/approval/approve`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: service-assetsservice.md -->

# AssetsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/assets/assets.service.ts` (line 24)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `uploadImage` | `uploadImage(options: UploadImageOptions)` | `unknown` |
| `getAsset` | `getAsset(id: string, organizationId: string)` | `unknown` |
| `deleteAsset` | `deleteAsset(id: string, organizationId: string, _userId: string)` | `unknown` |
| `listAssets` | `listAssets(organizationId: string, audienceIds: string[])` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `azureblobservice`

<!-- source: class-atloriacard.md -->

# AtloriaCard

**Kind:** Class

**Source:** `atloria-monorepo/packages/ui-core/src/components/card/Card.ts` (line 19)

A flexible card component with multiple variants and slots

**Extends:** `LitElement`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `render` | `render()` | `void` |

## Properties

| Property | Type |
|---|---|
| `styles` | `any` |
| `variant` | `CardVariant` |
| `clickable` | `any` |
| `noPadding` | `any` |
| `compact` | `any` |

<!-- source: controller-authcontroller.md -->

# AuthController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/auth/auth.controller.ts` (line 20)

## Relationships

- MODULE_DECLARES → `register`
- MODULE_DECLARES → `login`
- MODULE_DECLARES → `refresh`
- MODULE_DECLARES → `verifyEmail`
- MODULE_DECLARES → `forgotPassword`
- MODULE_DECLARES → `resetPassword`
- MODULE_DECLARES → `resendVerification`
- MODULE_DECLARES → `logout`
- MODULE_DECLARES → `getMe`
- DEPENDS_ON → `authservice`

<!-- source: class-benchmarkmonitor.md -->

# BenchmarkMonitor

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/benchmark-monitor.ts` (line 113)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `close` | `close()` | `Promise<void>` |
| `analyze` | `analyze(report: BenchmarkReport)` | `FailureAnalysis` |
| `formatAnalysis` | `formatAnalysis(analysis: FailureAnalysis)` | `string` |

## Properties

| Property | Type |
|---|---|
| `onEvent` | `any` |
| `log` | `any` |

<!-- source: module-bitbucketmodule.md -->

# BitbucketModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/bitbucket/bitbucket.module.ts` (line 10)

## Relationships

- MODULE_IMPORTS → `configmodule`
- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_DECLARES → `bitbucketcontroller`
- MODULE_PROVIDES → `bitbucketservice`
- MODULE_EXPORTS → `bitbucketservice`

<!-- source: type-blocktype.md -->

# BlockType

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 103)

The type of the block that the current selection is in.

## Definition

```ts
'paragraph' | 'quote' | HeadingTagType | ''
```

<!-- source: interface-boardcarddata.md -->

# BoardCardData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 86)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `position` | `number` |
| `columnId` | `string` |
| `issue` | `{
    id: string;
    ticketNumber: number;
    status: string;
    priority: string;
    category: string;
    ticketType?: string;
    description: string;
    pageTitle: string | null;
    pageUrl: string | null;
    assignee: { id: string; name: string | null; email: string } | null;
    createdAt: string;
    updatedAt: string;
    _count?: { comments: number };
  }` |

<!-- source: function-buildfeaturedevplan.md -->

# buildFeatureDevPlan

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/workflows/feature-dev.ts` (line 29)

Build a feature development orchestration plan.

## Signature

```ts
function buildFeatureDevPlan(options: {
  featureDescription?: string;
  workspace?: string;
}): OrchestrationPlan
```

## Parameters

| Name | Type |
|---|---|
| `options` | `{
  featureDescription?: string;
  workspace?: string;
}` |

**Returns:** `OrchestrationPlan`

<!-- source: function-buildngrxstateflow.md -->

# buildNgRxStateFlow

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ngrx-pattern-detector.ts` (line 582)

Build state flow from detected NgRx patterns

## Signature

```ts
function buildNgRxStateFlow(actions: NgRxActionPattern[], _reducers: NgRxReducerPattern[], selectors: NgRxSelectorPattern[], _effects: NgRxEffectPattern[]): StateFlow | null
```

## Parameters

| Name | Type |
|---|---|
| `actions` | `NgRxActionPattern[]` |
| `_reducers` | `NgRxReducerPattern[]` |
| `selectors` | `NgRxSelectorPattern[]` |
| `_effects` | `NgRxEffectPattern[]` |

**Returns:** `StateFlow | null`

<!-- source: function-buildseometadata.md -->

# buildSeoMetadata

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/seo-metadata.tool.ts` (line 70)

Build SEO metadata from page info.
Deterministic template — no AI call needed for basic metadata.

## Signature

```ts
function buildSeoMetadata(params: {
  pageTitle: string;
  pageSummary: string;
  productName?: string;
  heroImageUrl?: string;
  keywords?: string[];
}): SeoMetadata
```

## Parameters

| Name | Type |
|---|---|
| `params` | `{
  pageTitle: string;
  pageSummary: string;
  productName?: string;
  heroImageUrl?: string;
  keywords?: string[];
}` |

**Returns:** `SeoMetadata`

<!-- source: class-bulkdeletedocumentsdto.md -->

# BulkDeleteDocumentsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/bulk-operations.dto.ts` (line 7)

Bulk delete documents

## Properties

| Property | Type |
|---|---|
| `documentIds` | `string[]` |

<!-- source: interface-cacheentry.md -->

# CacheEntry

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/config.interface.ts` (line 235)

Cache entry for incremental parsing

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `contentHash` | `string` |
| `cachedAt` | `Date` |
| `parserName` | `string` |
| `result` | `unknown` |

<!-- source: function-calculateentitycentriclayout.md -->

# calculateEntityCentricLayout

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Graph/graphUtils.ts` (line 134)

Calculate layout for entity-centric view

## Signature

```ts
function calculateEntityCentricLayout(entities: KGEntity[], relationships: KGRelationship[]): { nodes: GraphNode[]; edges: GraphEdge[] }
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `KGEntity[]` |
| `relationships` | `KGRelationship[]` |

**Returns:** `{ nodes: GraphNode[]; edges: GraphEdge[] }`

<!-- source: constant-capture-actions.md -->

# CAPTURE_ACTIONS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/capture/dto/create-flow.dto.ts` (line 15)

<!-- source: function-collectentities.md -->

# collectEntities

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/curation.ts` (line 62)

Look up name/type for a set of entity ids in the UNCURATED navMap — the tree's
"Hidden (n)" section needs names, but hidden entities are filtered out of the served map.

## Signature

```ts
function collectEntities(navMap: NavMap | null | undefined, ids: string[]): Array<{ id: string; name: string; type: string }>
```

## Parameters

| Name | Type |
|---|---|
| `navMap` | `NavMap | null | undefined` |
| `ids` | `string[]` |

**Returns:** `Array<{ id: string; name: string; type: string }>`

<!-- source: function-createmockapiresponse.md -->

# createMockAPIResponse

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 249)

## Signature

```ts
function createMockAPIResponse(data: T, options: {
    status?: number;
    message?: string;
    pagination?: {
      page: number;
      limit: number;
      total: number;
      totalPages: number;
    };
  })
```

## Parameters

| Name | Type |
|---|---|
| `data` | `T` |
| `options` | `{
    status?: number;
    message?: string;
    pagination?: {
      page: number;
      limit: number;
      total: number;
      totalPages: number;
    };
  }` |

<!-- source: function-createvalidateoutputtool.md -->

# createValidateOutputTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/validate-output.tool.ts` (line 29)

## Signature

```ts
function createValidateOutputTool(): ToolDefinition<TContext>
```

**Returns:** `ToolDefinition<TContext>`

<!-- source: component-ctacard.md -->

# CtaCard

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/cta/cta-card.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `icon` | `LucideIcon` | - | - |

## Diagram

```mermaid
graph TD
    component_CtaCard_13ae657c["CtaCard"]
    class component_CtaCard_13ae657c rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Icon`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- USES_HOOK → `useTranslation`

<!-- source: interface-dependencynode.md -->

# DependencyNode

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/relationship.interface.ts` (line 356)

Node in a dependency tree

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `type` | `string` |
| `relationshipType` | `RelationshipType` |
| `children` | `DependencyNode[]` |
| `depth` | `number` |

<!-- source: class-discoveryscanrequestdto.md -->

# DiscoveryScanRequestDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/discovery/dto/discovery.dto.ts` (line 40)

## Properties

| Property | Type |
|---|---|
| `siteUrl` | `string` |
| `auth` | `DiscoveryAuthConfigDto` |
| `exploreGridDepth` | `boolean` |
| `timeoutMs` | `number` |
| `pageProfileTimeoutMs` | `number` |

<!-- source: component-downshiftautocompletewithsuggestions.md -->

# DownshiftAutoCompleteWithSuggestions

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/ui/DownshiftAutoComplete.tsx` (line 29)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `autofocus` | `any` | ✓ | - |
| `suggestions` | `any` | ✓ | - |
| `control` | `any` | ✓ | - |
| `inputName` | `any` | ✓ | - |
| `placeholder` | `any` | ✓ | - |
| `initialInputValue` | `any` | ✓ | - |
| `setValue` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DownshiftAutoCompleteWithSuggestions_158f0032["DownshiftAutoCompleteWithSuggestions"]
    class component_DownshiftAutoCompleteWithSuggestions_158f0032 rootComponent
```

## Relationships

- RENDERS → `Controller`
- USES_HOOK → `useState`
- USES_HOOK → `useCellValue`
- USES_HOOK → `useCombobox`

## Referenced By

- `DownshiftAutoComplete` (RENDERS)

<!-- source: constant-empty-filters.md -->

# EMPTY_FILTERS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 30)

## Definition

```ts
BoardFiltersState
```

<!-- source: type-exportsection.md -->

# ExportSection

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/analytics/export/analytics-export.service.ts` (line 8)

## Definition

```ts
| 'overview'
  | 'topDocs'
  | 'topSearches'
  | 'devices'
  | 'sources'
```

<!-- source: function-extracttypestring.md -->

# extractTypeString

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 222)

Convert TypeScript type to string representation

## Signature

```ts
function extractTypeString(typeNode: t.TSType | null | undefined): string
```

## Parameters

| Name | Type |
|---|---|
| `typeNode` | `t.TSType | null | undefined` |

**Returns:** `string`

<!-- source: class-filesystemstorageprovider.md -->

# FileSystemStorageProvider

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/storage/file-system-storage.provider.ts` (line 27)

File system storage provider implementation

**Implements:** `IStorageProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getMode` | `getMode()` | `StorageMode` |
| `initialize` | `initialize()` | `Promise<void>` |
| `saveScreenshot` | `saveScreenshot(buffer: Buffer, metadata: ScreenshotMetadata)` | `Promise<ScreenshotSaveResult>` |
| `findExistingScreenshot` | `findExistingScreenshot(metadata: Partial<ScreenshotMetadata>)` | `Promise<ScreenshotSaveResult | null>` |
| `saveDocument` | `saveDocument(document: DocumentMetadata)` | `Promise<DocumentSaveResult>` |
| `documentExists` | `documentExists(_projectId: string, categoryPath: string[], slug: string)` | `Promise<boolean>` |
| `listDocuments` | `listDocuments(_projectId: string, categoryPath: string[])` | `Promise<Array<{ id: string; title: string; slug: string; url: string }>>` |

<!-- source: interface-footerconfig.md -->

# FooterConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 61)

## Properties

| Property | Type |
|---|---|
| `descriptionKey` | `string` |
| `linkGroups` | `Array<{
    titleKey: string;
    links: Array<{ labelKey: string; href: string }>;
  }>` |
| `legalLinks` | `Array<{ labelKey: string; href: string }>` |

<!-- source: function-generateuserdocscommand.md -->

# generateUserDocsCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/generate-user-docs.command.ts` (line 237)

Main command handler

## Signature

```ts
async function generateUserDocsCommand(options: GenerateUserDocsOptions): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `GenerateUserDocsOptions` |

**Returns:** `Promise<void>`

<!-- source: api-endpoint-getjobresult.md -->

# getJobResult

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/orchestrator.controller.ts` (line 109)

Get job result

## Endpoint

`GET /api/orchestrator/jobs/:jobId/result`

| Parameter | In | Type | Required |
|---|---|---|---|
| `jobId` | query | `string` | ✓ |

## Referenced By

- `OrchestratorController` (MODULE_DECLARES)

<!-- source: function-getregisteredparsers.md -->

# getRegisteredParsers

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/queue/processors/parse.processor.ts` (line 64)

Get registered parser names

## Signature

```ts
function getRegisteredParsers(): string[]
```

**Returns:** `string[]`

<!-- source: type-graphnode.md -->

# GraphNode

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/components/Graph/types.ts` (line 62)

Extended Node types for our graph

## Definition

```ts
Node<DocumentNodeData | EntityNodeData>
```

<!-- source: interface-htmlvalidationresult.md -->

# HtmlValidationResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/tools/validate-html.tool.ts` (line 11)

## Properties

| Property | Type |
|---|---|
| `valid` | `boolean` |
| `errors` | `string[]` |
| `warnings` | `string[]` |

<!-- source: component-internalicon.md -->

# InternalIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/DependencyGraph.tsx` (line 111)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_InternalIcon_2031600b["InternalIcon"]
    class component_InternalIcon_2031600b rootComponent
```

## Referenced By

- `DependencyGraph` (RENDERS)
- `DependencyCard` (RENDERS)

<!-- source: type-journalentrytype.md -->

# JournalEntryType

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/session-journal.ts` (line 26)

## Definition

```ts
| 'goal'          // Current objective (restated at end of context)
  | 'observation'   // What the agent found (concise)
  | 'hypothesis'    // Suspected root cause (falsifiable)
  | 'failure'       // What didn't work + why (prevents retry)
  | 'progress'
```

<!-- source: type-layouttype.md -->

# LayoutType

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 21)

## Definition

```ts
| HeroLayout
  | FeaturesLayout
  | HowItWorksLayout
  | PricingLayout
  | ProblemLayout
  | SocialProofLayout
  | FaqLayout
  | CtaLayout
```

<!-- source: service-loginselectordetectorservice.md -->

# LoginSelectorDetectorService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/login-selector-detector.service.ts` (line 1)

<!-- source: service-pdfservice.md -->

# PdfService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/pdf/pdf.service.ts` (line 28)

Renders a fully-composed HTML document to PDF bytes using headless Chromium.

This is the ONE place in the platform that owns Chromium PDF rendering — the
screenshot-worker pod is the only image that ships a browser. Other services
(e.g. the API's doc-version export) compose HTML and POST it here over HTTP
rather than launching Chromium in-process.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `renderPdf` | `renderPdf(html: string, options: RenderPdfOptions)` | `Promise<Buffer>` |

## Relationships

- DEPENDS_ON → `playwrightservice`

<!-- source: constant-plan-mode-blocked-tools.md -->

# PLAN_MODE_BLOCKED_TOOLS

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/session/plan-mode-filter.ts` (line 29)

Tools explicitly blocked during plan mode

<!-- source: interface-rawpageprofile.md -->

# RawPageProfile

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/discovery/page-profiler.service.ts` (line 8)

Raw profile data returned from page.evaluate().
Matches the SiteMap types but kept separate to avoid cross-package imports in the worker.

## Properties

| Property | Type |
|---|---|
| `grids` | `Array<{
    framework: string;
    selector: string;
    rowCount: number;
    columns: string[];
    hasDetailNavigation: boolean;
    detailUrl?: string;
    detailProfile?: RawPageProfile;
  }>` |
| `tabs` | `Array<{
    label: string;
    index: number;
    selector: string;
    detectionMethod: string;
  }>` |
| `buttons` | `Array<{
    text: string;
    selector: string;
    isEnabled: boolean;
  }>` |
| `inputs` | `Array<{
    type: string;
    placeholder: string;
    selector: string;
    label?: string;
  }>` |
| `forms` | `Array<{
    selector: string;
    fieldCount: number;
    hasSubmitButton: boolean;
  }>` |
| `modals` | `Array<{
    selector: string;
    title?: string;
  }>` |

<!-- source: interface-screenshotinfo.md -->

# ScreenshotInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/utils/screenshot-storage.helper.ts` (line 16)

## Properties

| Property | Type |
|---|---|
| `localPath` | `string` |
| `pageId` | `string` |
| `route` | `string` |
| `url` | `string` |
| `formState` | `string` |
| `description` | `string` |
| `viewport` | `{ width: number; height: number }` |

<!-- source: type-statecoveragestatus.md -->

# StateCoverageStatus

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/state-machine-diagram.generator.ts` (line 19)

Coverage status for a state

## Definition

```ts
'covered' | 'partial' | 'uncovered' | 'unknown'
```

<!-- source: constant-state-types.md -->

# STATE_TYPES

**Kind:** Constant

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 307)

<!-- source: graphql-type-tag.md -->

# Tag

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Tag for categorizing posts

## Relationships

- TYPE_OF → `Post`

## Referenced By

- `Post` (TYPE_OF)

<!-- source: api-endpoint-takeauthenticatedscreenshot.md -->

# takeAuthenticatedScreenshot

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.controller.ts` (line 248)

Take authenticated screenshot (login first, then capture)

POST /api/screenshot/authenticated

Body:
{
  "url": "https://example.com/dashboard",
  "projectId": "uuid",
  "organizationId": "uuid",
  "capturedBy": "uuid",
  "auth": {
    "loginUrl": "/login",
    "username": "user@example.com",
    "password": "password",
    "usernameSelector": "#username",
    "passwordSelector": "#password",
    "submitSelector": "button[type=submit]",
    "successSelector": ".dashboard"
  },
  "viewport": { "width": 1920, "height": 1080 },
  "fullPage": true
}

## Endpoint

`POST /screenshot/authenticated`

## Referenced By

- `ScreenshotController` (MODULE_DECLARES)

<!-- source: class-templategallerypage.md -->

# TemplateGalleryPage

**Kind:** Class

**Source:** `atloria-monorepo/apps/web-e2e/src/pages/templates.page.ts` (line 7)

Template gallery page object

**Extends:** `BasePage`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `goto` | `goto()` | `Promise<void>` |
| `getTemplateCards` | `getTemplateCards()` | `Locator` |
| `getTemplateByName` | `getTemplateByName(name: string)` | `Locator` |
| `getTemplateCount` | `getTemplateCount()` | `Promise<number>` |
| `search` | `search(query: string)` | `Promise<void>` |
| `clearSearch` | `clearSearch()` | `Promise<void>` |
| `filterByCategory` | `filterByCategory(category: string)` | `Promise<void>` |
| `getCategories` | `getCategories()` | `Promise<string[]>` |
| `previewTemplate` | `previewTemplate(name: string)` | `Promise<void>` |
| `useTemplate` | `useTemplate(name: string)` | `Promise<void>` |
| `hasTemplate` | `hasTemplate(name: string)` | `Promise<boolean>` |
| `getTemplateDetails` | `getTemplateDetails(name: string)` | `Promise<{
    name: string;
    description: string;
    category: string;
  }>` |

## Properties

| Property | Type |
|---|---|
| `gallery` | `Locator` |
| `searchInput` | `Locator` |
| `categoryFilter` | `Locator` |
| `templateCards` | `Locator` |
| `loadingState` | `Locator` |
| `emptyState` | `Locator` |

<!-- source: graphql-mutation-unlikepost.md -->

# unlikePost

**Kind:** Graphql Mutation

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Unlike a post

## Referenced By

- `Mutation` (CALLS_API)

<!-- source: enum-viewporttype.md -->

# ViewportType

**Kind:** Enum

**Source:** `atloria-monorepo/apps/api/src/screenshot/dto/capture-screenshot.dto.ts` (line 14)

## Values

- `DESKTOP`
- `TABLET`
- `MOBILE`

<!-- source: type-waittype.md -->

# WaitType

**Kind:** Type

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 108)

## Definition

```ts
typeof WAIT_TYPES[number]
```

<!-- source: component-activityrow.md -->

# ActivityRow

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/IssueSidePanel.tsx` (line 926)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `event` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ActivityRow_1df84edf["ActivityRow"]
    class component_ActivityRow_1df84edf rootComponent
```

## Referenced By

- `IssueSidePanel` (RENDERS)

<!-- source: constant-addmdastextension.md -->

# addMdastExtension$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 360)

Adds a mdast extension to the markdown parser.

<!-- source: interface-agenttoolendevent.md -->

# AgentToolEndEvent

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/agent/agent.types.ts` (line 101)

## Properties

| Property | Type |
|---|---|
| `toolName` | `string` |
| `outputPreview` | `string` |
| `durationMs` | `number` |

<!-- source: interface-agenttransport.md -->

# AgentTransport

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/protocol/session-event-bridge.ts` (line 37)

A transport is a thin adapter between AgentProtocolEvents and a specific
output surface (terminal, WebSocket, IPC channel, etc.).

Implement this interface to add a new surface without touching the bridge.

<!-- source: interface-analysisinput.md -->

# AnalysisInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-04.types.ts` (line 20)

## Properties

| Property | Type |
|---|---|
| `chunks` | `Chunk[]` |
| `features` | `UserFeature[]` |

<!-- source: function-appender.md -->

# Appender

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 496)

## Signature

```ts
function Appender(cell$: NodeRef<T[]>, init: (r: Realm, sig$: NodeRef<T | T[]>) => void)
```

## Parameters

| Name | Type |
|---|---|
| `cell$` | `NodeRef<T[]>` |
| `init` | `(r: Realm, sig$: NodeRef<T | T[]>) => void` |

<!-- source: api-endpoint-archive.md -->

# archive

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 179)

## Endpoint

`POST /doc-versions/:projectId/:versionId/archive`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: class-atloriacodesample.md -->

# AtloriaCodeSample

**Kind:** Class

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/CodeSample.ts` (line 16)

**Extends:** `LitElement`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `render` | `render()` | `void` |

## Properties

| Property | Type |
|---|---|
| `styles` | `any` |
| `samples` | `CodeSampleData[]` |
| `endpoint` | `any` |
| `method` | `any` |
| `baseUrl` | `any` |

<!-- source: service-audienceservice.md -->

# AudienceService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/audience/audience.service.ts` (line 15)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `list` | `list(user: JwtPayload)` | `Promise<AudienceModel[]>` |
| `get` | `get(id: string, user: JwtPayload)` | `Promise<AudienceModel>` |
| `create` | `create(dto: CreateAudienceDto, user: JwtPayload)` | `Promise<AudienceModel>` |
| `update` | `update(id: string, dto: UpdateAudienceDto, user: JwtPayload)` | `Promise<AudienceModel>` |
| `delete` | `delete(id: string, user: JwtPayload)` | `Promise<void>` |
| `seedStandardAudiences` | `seedStandardAudiences()` | `Promise<void>` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: class-benchmarkrunner.md -->

# BenchmarkRunner

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/runner.ts` (line 99)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `run` | `run(onProgress: (msg: string) => void)` | `Promise<BenchmarkReport>` |

<!-- source: controller-billingcontroller.md -->

# BillingController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/billing/billing.controller.ts` (line 23)

## Relationships

- MODULE_DECLARES → `checkout`
- MODULE_DECLARES → `portal`
- MODULE_DECLARES → `summary`
- MODULE_DECLARES → `webhook`
- DEPENDS_ON → `billingservice`

<!-- source: interface-boardcolumndata.md -->

# BoardColumnData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 107)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `order` | `number` |
| `color` | `string` |
| `mapsToStatus` | `string | null` |
| `wipLimit` | `number | null` |
| `cards` | `BoardCardData[]` |

<!-- source: module-boardsmodule.md -->

# BoardsModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/boards/boards.module.ts` (line 9)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `issuesmodule`
- MODULE_DECLARES → `boardscontroller`
- MODULE_PROVIDES → `boardsservice`
- MODULE_EXPORTS → `boardsservice`

<!-- source: function-buildmemoryextractionprompt.md -->

# buildMemoryExtractionPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/session-memory.ts` (line 75)

Build a prompt for a summarizer model to extract session memories.

This is designed to be sent to a model call. Domain layers can either:
1. Call their model provider directly with this prompt
2. Use a sub-agent with this as the task

Returns null if the session is too short to extract from.

## Signature

```ts
function buildMemoryExtractionPrompt(ctx: SessionContext): string | null
```

## Parameters

| Name | Type |
|---|---|
| `ctx` | `SessionContext` |

**Returns:** `string | null`

<!-- source: function-buildpiniastateflow.md -->

# buildPiniaStateFlow

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/pinia-pattern-detector.ts` (line 467)

Build state flow from detected Pinia patterns

## Signature

```ts
function buildPiniaStateFlow(_stores: PiniaStorePattern[], actions: PiniaActionPattern[], getters: PiniaGetterPattern[]): StateFlow | null
```

## Parameters

| Name | Type |
|---|---|
| `_stores` | `PiniaStorePattern[]` |
| `actions` | `PiniaActionPattern[]` |
| `getters` | `PiniaGetterPattern[]` |

**Returns:** `StateFlow | null`

<!-- source: function-buildseosystemprompt.md -->

# buildSeoSystemPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/seo.prompts.ts` (line 9)

## Signature

```ts
function buildSeoSystemPrompt(config: GenerationConfig): string
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |

**Returns:** `string`

<!-- source: class-bulkmovedocumentsdto.md -->

# BulkMoveDocumentsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/bulk-operations.dto.ts` (line 22)

Bulk move documents to a different category

## Properties

| Property | Type |
|---|---|
| `documentIds` | `string[]` |
| `categoryId` | `string | null` |

<!-- source: type-buttonsize.md -->

# ButtonSize

**Kind:** Type

**Source:** `atloria-monorepo/packages/ui-core/src/components/button/Button.ts` (line 8)

## Definition

```ts
'sm' | 'md' | 'lg'
```

<!-- source: function-calculateflowlayout.md -->

# calculateFlowLayout

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Graph/graphUtils.ts` (line 147)

Calculate layout for flow view with stages

## Signature

```ts
function calculateFlowLayout(stages: FlowStage[]): {
  nodes: GraphNode[];
  edges: GraphEdge[];
}
```

## Parameters

| Name | Type |
|---|---|
| `stages` | `FlowStage[]` |

**Returns:** `{
  nodes: GraphNode[];
  edges: GraphEdge[];
}`

<!-- source: constant-changelogtemplate.md -->

# changelogTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/changelog.template.ts` (line 3)

<!-- source: interface-cloudstorageconfig.md -->

# CloudStorageConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/storage.interface.ts` (line 293)

Cloud storage configuration

## Properties

| Property | Type |
|---|---|
| `apiBaseUrl` | `string` |
| `apiToken` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `timeout` | `number` |

<!-- source: function-computeentityimportance.md -->

# computeEntityImportance

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/search-index.ts` (line 143)

Per-entity importance 0..1 = blend of call-graph in-degree centrality
(how many things reference it) and public-API-surface weight (its kind).

## Signature

```ts
function computeEntityImportance(entities: GraphEntity[], relationships: GraphRelationship[]): Map<string, number>
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `GraphEntity[]` |
| `relationships` | `GraphRelationship[]` |

**Returns:** `Map<string, number>`

<!-- source: function-createmockerrorresponse.md -->

# createMockErrorResponse

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 270)

## Signature

```ts
function createMockErrorResponse(message: string, status)
```

## Parameters

| Name | Type |
|---|---|
| `message` | `string` |
| `status` | `any` |

<!-- source: component-ctasplitform.md -->

# CtaSplitForm

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/cta/cta-split-form.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `contactItems` | `ContactItem[]` | - | - |
| `formId` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_CtaSplitForm_59c28a2f["CtaSplitForm"]
    class component_CtaSplitForm_59c28a2f rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- RENDERS → `motion-ul`
- RENDERS → `ItemIcon`
- USES_HOOK → `useTranslation`

<!-- source: interface-dependencytree.md -->

# DependencyTree

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/relationship.interface.ts` (line 321)

Dependency tree structure

## Properties

| Property | Type |
|---|---|
| `rootId` | `string` |
| `rootName` | `string` |
| `rootType` | `string` |
| `children` | `DependencyNode[]` |
| `depth` | `number` |
| `totalNodes` | `number` |

<!-- source: constant-entity-type-colors.md -->

# ENTITY_TYPE_COLORS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/components/Graph/types.ts` (line 97)

Entity colors by type

## Definition

```ts
Record<string, string>
```

<!-- source: class-errorconfigdto.md -->

# ErrorConfigDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 276)

Error state configuration

## Properties

| Property | Type |
|---|---|
| `errorType` | `'validation' | 'network' | 'permission'` |
| `triggerMethod` | `string` |
| `expectedError` | `string` |

<!-- source: function-generateapp.md -->

# generateApp

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/generate.ts` (line 232)

## Signature

```ts
async function generateApp(outputDir: string, config: SiteAssemblyConfig): Promise<string>
```

## Parameters

| Name | Type |
|---|---|
| `outputDir` | `string` |
| `config` | `SiteAssemblyConfig` |

**Returns:** `Promise<string>`

<!-- source: function-generateentityid-2.md -->

# generateEntityId

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 440)

Generate a unique entity ID

## Signature

```ts
function generateEntityId(filePath: string, name: string, type: string): string
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |
| `name` | `string` |
| `type` | `string` |

**Returns:** `string`

<!-- source: api-endpoint-getjobstatus.md -->

# getJobStatus

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/orchestrator.controller.ts` (line 85)

Get job status

## Endpoint

`GET /api/orchestrator/jobs/:jobId/status`

| Parameter | In | Type | Required |
|---|---|---|---|
| `jobId` | query | `string` | ✓ |

## Referenced By

- `OrchestratorController` (MODULE_DECLARES)

<!-- source: function-getmcpconfigpath.md -->

# getMcpConfigPath

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/mcp.command.ts` (line 23)

## Signature

```ts
function getMcpConfigPath(): string
```

**Returns:** `string`

<!-- source: function-getserversideprops.md -->

# getServerSideProps

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/frontend/src/pages/profile/[id].tsx` (line 47)

## Signature

```ts
async function getServerSideProps({ params })
```

## Parameters

| Name | Type |
|---|---|
| `{ params }` | `any` |

<!-- source: class-graphqlparser-2.md -->

# GraphQLParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/api-schema/graphql.parser.ts` (line 60)

GraphQL Parser Implementation

Supports:
- GraphQL Schema Definition Language (SDL)
- Queries, Mutations, Subscriptions
- Object Types, Input Types, Enums, Interfaces, Unions
- Directives and field arguments

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: type-graphviewmode.md -->

# GraphViewMode

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/components/Graph/types.ts` (line 33)

Graph view modes

## Definition

```ts
'document-centric' | 'entity-centric' | 'flow'
```

<!-- source: interface-herobentogridprops.md -->

# HeroBentoGridProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/hero/hero-bento-grid.tsx` (line 15)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `subheadlineKey` | `string` |
| `primaryCtaKey` | `string` |
| `primaryCtaUrl` | `string` |
| `secondaryCtaKey` | `string` |
| `secondaryCtaUrl` | `string` |
| `badgeKey` | `string` |
| `gridItems` | `{ titleKey: string; descriptionKey?: string; icon?: LucideIcon }[]` |
| `className` | `string` |

<!-- source: component-htmltoolbarcomponent.md -->

# HTMLToolbarComponent

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/html.tsx` (line 75)

## Diagram

```mermaid
graph TD
    component_HTMLToolbarComponent_48da1ddd["HTMLToolbarComponent"]
    class component_HTMLToolbarComponent_48da1ddd rootComponent
```

## Relationships

- USES_HOOK → `useCellValues`
- USES_HOOK → `useMemo`

## Referenced By

- `SpanWithColor` (RENDERS)

<!-- source: interface-imagegenerationoptions.md -->

# ImageGenerationOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/providers/azure-image.provider.ts` (line 16)

## Properties

| Property | Type |
|---|---|
| `prompt` | `string` |
| `size` | `'1024x1024' | '1024x1792' | '1792x1024'` |
| `background` | `'transparent' | 'opaque' | 'auto'` |
| `quality` | `'low' | 'medium' | 'high'` |
| `outputFormat` | `'png' | 'webp'` |

<!-- source: type-loopconfig.md -->

# LoopConfig

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/runtime-config.ts` (line 16)

## Definition

```ts
| { engine: 'openai-sdk' }
  | {
      engine: 'live-swe';
      /** Max same-turn requeries on format errors (default: 3) */
      maxRequeries?: number;
      /** Custom history processor pipeline (default: LastN + ClosedWindow) */
      historyProcessors?: HistoryProcessor[];
    }
```

<!-- source: service-metadocumentationservice.md -->

# MetaDocumentationService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-14-meta/meta-documentation.service.ts` (line 1)

<!-- source: type-mockuptype.md -->

# MockupType

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 37)

## Definition

```ts
'dashboard' | 'editor' | 'terminal' | 'api-playground' | 'analytics-chart' | 'mobile-app'
```

<!-- source: service-playwrightservice.md -->

# PlaywrightService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/playwright/playwright.service.ts` (line 52)

Playwright service for browser automation and screenshots

Features:
- Multiple browser support (Chromium, Firefox, WebKit)
- Custom viewport sizes
- Full-page screenshots
- Wait for selectors/timeouts
- Basic authentication
- Browser pooling for performance

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getBrowser` | `getBrowser(type: BrowserType)` | `Promise<Browser>` |
| `takeScreenshot` | `takeScreenshot(options: ScreenshotOptions)` | `Promise<Buffer>` |
| `takeResponsiveScreenshots` | `takeResponsiveScreenshots(url: string, viewports: Array<{ name: string; width: number; height: number }>)` | `Promise<Array<{ name: string; screenshot: Buffer }>>` |
| `takeAuthenticatedScreenshot` | `takeAuthenticatedScreenshot(options: AuthenticatedScreenshotOptions)` | `Promise<Buffer>` |
| `getPageHtml` | `getPageHtml(url: string, browserType: BrowserType)` | `Promise<string>` |
| `onModuleDestroy` | `onModuleDestroy()` | `unknown` |

<!-- source: interface-renderpdfoptions.md -->

# RenderPdfOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/pdf/pdf.service.ts` (line 5)

## Properties

| Property | Type |
|---|---|
| `format` | `'A4' | 'A3' | 'A5' | 'Letter' | 'Legal' | 'Tabloid'` |
| `margin` | `{ top?: string; bottom?: string; left?: string; right?: string }` |
| `printBackground` | `boolean` |
| `displayHeaderFooter` | `boolean` |
| `headerTemplate` | `string` |
| `footerTemplate` | `string` |

<!-- source: type-reportformat.md -->

# ReportFormat

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/analytics/export/scheduled-reports.service.ts` (line 9)

## Definition

```ts
'PDF' | 'CSV'
```

<!-- source: interface-sessionsdeleteoptions.md -->

# SessionsDeleteOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/commands/sessions.command.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `all` | `boolean` |

<!-- source: constant-standard-profile.md -->

# STANDARD_PROFILE

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-profiles.ts` (line 181)

STANDARD_PROFILE — safe fallback when model is unknown.
Preserves current GPT-5.4 behavior so existing tests and deployments
are unaffected when no profile is specified.

## Definition

```ts
ModelCapabilityProfile
```

<!-- source: type-statemanagementlibrary.md -->

# StateManagementLibrary

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-management.interface.ts` (line 14)

State Management Interfaces

Defines interfaces for state management libraries (Redux, MobX, Zustand, etc.)
and their patterns for user documentation generation.

## Definition

```ts
| 'redux'
  | 'redux-toolkit'
  | 'mobx'
  | 'zustand'
  | 'recoil'
  | 'jotai'
  | 'context-api'
  | 'react-query'
  | 'swr'
  | 'ngrx'
  | 'akita'
  | 'ngxs'
  | 'pinia'
  | 'vuex'
```

<!-- source: api-endpoint-takeresponsivescreenshots.md -->

# takeResponsiveScreenshots

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.controller.ts` (line 213)

Take responsive screenshots (mobile, tablet, desktop)

POST /api/screenshot/responsive

Body:
{
  "url": "https://example.com",
  "projectId": "uuid",
  "organizationId": "uuid",
  "capturedBy": "uuid"
}

## Endpoint

`POST /screenshot/responsive`

## Referenced By

- `ScreenshotController` (MODULE_DECLARES)

<!-- source: class-templatepreviewmodal.md -->

# TemplatePreviewModal

**Kind:** Class

**Source:** `atloria-monorepo/apps/web-e2e/src/pages/templates.page.ts` (line 153)

Template preview modal page object

**Extends:** `BasePage`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `goto` | `goto()` | `Promise<void>` |
| `getTitle` | `getTitle()` | `Promise<string>` |
| `getPreviewContent` | `getPreviewContent()` | `Promise<string>` |
| `use` | `use()` | `Promise<void>` |
| `close` | `close()` | `Promise<void>` |
| `isVisible` | `isVisible()` | `Promise<boolean>` |

## Properties

| Property | Type |
|---|---|
| `modal` | `Locator` |
| `title` | `Locator` |
| `description` | `Locator` |
| `preview` | `Locator` |
| `useButton` | `Locator` |
| `closeButton` | `Locator` |

<!-- source: graphql-mutation-updatepost.md -->

# updatePost

**Kind:** Graphql Mutation

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Update a post

## Relationships

- TYPE_OF → `Post`
- TYPE_OF → `UpdatePostInput`

## Referenced By

- `Mutation` (CALLS_API)

<!-- source: graphql-type-updatepostinput.md -->

# UpdatePostInput

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Input for updating a post

## Referenced By

- `updatePost` (TYPE_OF)

<!-- source: constant-wait-types.md -->

# WAIT_TYPES

**Kind:** Constant

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 107)

<!-- source: component-activitytabbody.md -->

# ActivityTabBody

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/DeskCopilot.tsx` (line 525)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `thread` | `DeskThreadDetail` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ActivityTabBody_1faedad5["ActivityTabBody"]
    class component_ActivityTabBody_1faedad5 rootComponent
```

## Referenced By

- `DeskCopilot` (RENDERS)

<!-- source: constant-addnestededitorchild.md -->

# addNestedEditorChild$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 776)

Lets you add React components as children of any registered nested editor (useful for Lexical plugins).

<!-- source: interface-agenttoolstartevent.md -->

# AgentToolStartEvent

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/agent/agent.types.ts` (line 96)

## Properties

| Property | Type |
|---|---|
| `toolName` | `string` |
| `input` | `string` |

<!-- source: interface-analysisresult-2.md -->

# AnalysisResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-04.types.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `analyses` | `ChunkAnalysis[]` |
| `tokenUsage` | `TokenUsage[]` |

<!-- source: interface-anthropicmodelproviderconfig.md -->

# AnthropicModelProviderConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/anthropic-adapter.ts` (line 36)

## Properties

| Property | Type |
|---|---|
| `apiKey` | `string` |
| `defaultModel` | `string` |
| `baseUrl` | `string` |
| `timeout` | `number` |
| `maxTokens` | `number` |
| `modelProfile` | `ModelCapabilityProfile` |
| `azureHosted` | `boolean` |
| `azureApiVersion` | `string` |

<!-- source: function-applytheme.md -->

# applyTheme

**Kind:** Function

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/theme.ts` (line 96)

## Signature

```ts
function applyTheme(mode: ThemeMode, primaryColor: string)
```

## Parameters

| Name | Type |
|---|---|
| `mode` | `ThemeMode` |
| `primaryColor` | `string` |

<!-- source: api-endpoint-ask.md -->

# ask

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-mcp.controller.ts` (line 284)

## Endpoint

`POST /technical-docs/:projectId/ask`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsMcpController` (MODULE_DECLARES)

<!-- source: class-atloriaendpointdetail.md -->

# AtloriaEndpointDetail

**Kind:** Class

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/EndpointDetail.ts` (line 64)

**Extends:** `LitElement`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `render` | `render()` | `void` |

## Properties

| Property | Type |
|---|---|
| `styles` | `any` |
| `endpoint` | `APIEndpoint` |
| `mode` | `ExplorerMode` |
| `environment` | `Environment` |
| `schemas` | `Record<string, Schema>` |

<!-- source: service-auditservice.md -->

# AuditService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/audit/audit.service.ts` (line 19)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `record` | `record(event: AuditEventInput)` | `Promise<void>` |
| `query` | `query(opts: {
    organizationId: string;
    projectId?: string;
    docVersionId?: string;
    actorId?: string;
    action?: string;
    startDate?: string;
    endDate?: string;
    limit?: number;
    offset?: number;
  })` | `unknown` |
| `exportCSV` | `exportCSV(opts: { organizationId: string; projectId?: string })` | `Promise<string>` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: controller-bitbucketcontroller.md -->

# BitbucketController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/bitbucket/bitbucket.controller.ts` (line 10)

## Relationships

- MODULE_DECLARES → `getAuthUrl`
- MODULE_DECLARES → `handleCallback`
- MODULE_DECLARES → `getStatus`
- MODULE_DECLARES → `listRepos`
- MODULE_DECLARES → `listBranches`
- MODULE_DECLARES → `disconnect`
- DEPENDS_ON → `bitbucketservice`

<!-- source: class-bm25index.md -->

# BM25Index

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/bm25.ts` (line 59)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `addDocument` | `addDocument(id: string, text: string)` | `void` |
| `removeDocument` | `removeDocument(id: string)` | `void` |
| `search` | `search(query: string, topK: undefined)` | `Array<{ id: string; score: number }>` |
| `clear` | `clear()` | `void` |
| `serialize` | `serialize()` | `SerializedIndex` |
| `deserialize` | `deserialize(data: object)` | `BM25Index` |

<!-- source: interface-boarddata.md -->

# BoardData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 117)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string | null` |
| `color` | `string` |
| `isDefault` | `boolean` |
| `settings` | `Record<string, unknown> | null` |
| `columns` | `BoardColumnData[]` |
| `createdAt` | `string` |
| `updatedAt` | `string` |

<!-- source: module-brandingmodule.md -->

# BrandingModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/branding/branding.module.ts` (line 8)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_DECLARES → `brandingcontroller`
- MODULE_PROVIDES → `brandingservice`
- MODULE_EXPORTS → `brandingservice`

<!-- source: function-buildprediction.md -->

# buildPrediction

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-evaluator.ts` (line 58)

Convert a TaskResult to SWE-bench prediction format.
Used for both successful and failed tasks (autosubmit pattern —
even partial patches are worth submitting).

## Signature

```ts
function buildPrediction(result: TaskResult, modelName: string): SWEBenchPrediction
```

## Parameters

| Name | Type |
|---|---|
| `result` | `TaskResult` |
| `modelName` | `string` |

**Returns:** `SWEBenchPrediction`

<!-- source: function-buildreduxstateflow.md -->

# buildReduxStateFlow

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/redux-pattern-detector.ts` (line 501)

Build state flow from detected patterns

## Signature

```ts
function buildReduxStateFlow(actions: ReduxActionPattern[], _reducers: ReduxReducerPattern[], selectors: ReduxSelectorPattern[]): StateFlow | null
```

## Parameters

| Name | Type |
|---|---|
| `actions` | `ReduxActionPattern[]` |
| `_reducers` | `ReduxReducerPattern[]` |
| `selectors` | `ReduxSelectorPattern[]` |

**Returns:** `StateFlow | null`

<!-- source: function-buildseotaskprompt.md -->

# buildSeoTaskPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/seo.prompts.ts` (line 44)

## Signature

```ts
function buildSeoTaskPrompt(pageTitle: string, pageSummary: string, productName: string): string
```

## Parameters

| Name | Type |
|---|---|
| `pageTitle` | `string` |
| `pageSummary` | `string` |
| `productName` | `string` |

**Returns:** `string`

<!-- source: class-bulkpublishdto.md -->

# BulkPublishDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/bulk-operations.dto.ts` (line 68)

Bulk publish all documents in a project

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `audienceSlug` | `string` |
| `setPublic` | `boolean` |

<!-- source: type-buttonvariant.md -->

# ButtonVariant

**Kind:** Type

**Source:** `atloria-monorepo/packages/ui-core/src/components/button/Button.ts` (line 7)

## Definition

```ts
'primary' | 'secondary' | 'danger' | 'ghost'
```

<!-- source: function-calculatenewposition.md -->

# calculateNewPosition

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 137)

Given the current cards in a destination column (excluding the moved card)
and the index where the card will land, compute its new float position.

## Signature

```ts
function calculateNewPosition(destCards: BoardCardData[], insertIndex: number): number
```

## Parameters

| Name | Type |
|---|---|
| `destCards` | `BoardCardData[]` |
| `insertIndex` | `number` |

**Returns:** `number`

<!-- source: interface-codeblockinfo-2.md -->

# CodeBlockInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 972)

Code block information

## Properties

| Property | Type |
|---|---|
| `language` | `string` |
| `line` | `number` |
| `lines` | `number` |

<!-- source: constant-codereviewchecklisttemplate.md -->

# codeReviewChecklistTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/code-review-checklist.template.ts` (line 3)

<!-- source: function-createmockpaginatedresponse.md -->

# createMockPaginatedResponse

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 281)

## Signature

```ts
function createMockPaginatedResponse(items: T[], page, limit, total: number)
```

## Parameters

| Name | Type |
|---|---|
| `items` | `T[]` |
| `page` | `any` |
| `limit` | `any` |
| `total` | `number` |

<!-- source: function-detectaiagent.md -->

# detectAiAgent

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/events/agent-detect.ts` (line 42)

Classify a User-Agent for agent-read recording.
 - Known AI bot           → its normalized vendor name.
 - Empty / scripted UA    → 'Other bot' (record it — it's not a human).
 - Real browser           → null (don't record; that's page-view analytics).
 - Anything else unknown  → 'Other bot' (better to log than to lose the signal).

## Signature

```ts
function detectAiAgent(userAgent: string | null): string | null
```

## Parameters

| Name | Type |
|---|---|
| `userAgent` | `string | null` |

**Returns:** `string | null`

<!-- source: interface-entity.md -->

# Entity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 217)

Base entity interface - all specific entities extend this

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `type` | `EntityType` |
| `name` | `string` |
| `filePath` | `string` |
| `startLine` | `number` |
| `endLine` | `number` |
| `description` | `string` |
| `tags` | `string[]` |
| `metadata` | `Record<string, unknown>` |
| `discoveredAt` | `Date` |
| `contentHash` | `string` |

<!-- source: component-faqaccordion.md -->

# FaqAccordion

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/faq/faq-accordion.tsx` (line 14)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `items` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FaqAccordion_1c913bb0["FaqAccordion"]
    class component_FaqAccordion_1c913bb0 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `AccordionItem`
- USES_HOOK → `useTranslation`

<!-- source: class-flowboundingboxdto.md -->

# FlowBoundingBoxDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/flow-replay.dto.ts` (line 45)

Percentage-of-viewport bounding box carried over from capture time.

## Properties

| Property | Type |
|---|---|
| `x` | `number` |
| `y` | `number` |
| `w` | `number` |
| `h` | `number` |

<!-- source: function-generatei18n.md -->

# generateI18n

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/generate.ts` (line 302)

## Signature

```ts
async function generateI18n(outputDir: string, locales: LocaleConfig[]): Promise<string>
```

## Parameters

| Name | Type |
|---|---|
| `outputDir` | `string` |
| `locales` | `LocaleConfig[]` |

**Returns:** `Promise<string>`

<!-- source: function-generaterelationshipid-2.md -->

# generateRelationshipId

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 462)

Generate a relationship ID

## Signature

```ts
function generateRelationshipId(sourceId: string, targetId: string, type: string): string
```

## Parameters

| Name | Type |
|---|---|
| `sourceId` | `string` |
| `targetId` | `string` |
| `type` | `string` |

**Returns:** `string`

<!-- source: api-endpoint-getkgstatistics.md -->

# getKGStatistics

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/orchestrator.controller.ts` (line 167)

Get Knowledge Graph statistics

## Endpoint

`GET /api/orchestrator/knowledge-graph/stats`

## Referenced By

- `OrchestratorController` (MODULE_DECLARES)

<!-- source: function-hasparser.md -->

# hasParser

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/queue/processors/parse.processor.ts` (line 57)

Check if a parser is registered

## Signature

```ts
function hasParser(name: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `name` | `string` |

**Returns:** `boolean`

<!-- source: interface-herodarkcenteredprops.md -->

# HeroDarkCenteredProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/hero/hero-dark-centered.tsx` (line 14)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `subheadlineKey` | `string` |
| `primaryCtaKey` | `string` |
| `primaryCtaUrl` | `string` |
| `secondaryCtaKey` | `string` |
| `secondaryCtaUrl` | `string` |
| `badgeKey` | `string` |
| `floatingStats` | `{ valueKey: string; labelKey: string }[]` |
| `imageSrc` | `string` |
| `imageAlt` | `string` |

<!-- source: interface-imagegenerationrequest.md -->

# ImageGenerationRequest

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 189)

Image generation request.

## Properties

| Property | Type |
|---|---|
| `prompt` | `string` |
| `width` | `number` |
| `height` | `number` |
| `background` | `'transparent' | 'opaque' | 'auto'` |
| `quality` | `'low' | 'medium' | 'high'` |

<!-- source: function-initscreenshotconfigcommand.md -->

# initScreenshotConfigCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/init-screenshot-config.command.ts` (line 87)

Generate screenshot configuration from AppMap

## Signature

```ts
async function initScreenshotConfigCommand(options: {
  target?: string;
  output?: string;
  appUrl?: string;
})
```

## Parameters

| Name | Type |
|---|---|
| `options` | `{
  target?: string;
  output?: string;
  appUrl?: string;
}` |

<!-- source: component-insertcard.md -->

# InsertCard

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/nested-jsx-elements.tsx` (line 60)

## Diagram

```mermaid
graph TD
    component_InsertCard_422f28bb["InsertCard"]
    class component_InsertCard_422f28bb rootComponent
```

## Relationships

- RENDERS → `Button`
- USES_HOOK → `usePublisher`

## Referenced By

- `Example` (RENDERS)

<!-- source: class-jinja2templateparser.md -->

# Jinja2TemplateParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/backend/jinja2-template.parser.ts` (line 81)

Jinja2 Template Parser

Extracts entities and relationships from Jinja2 template files.

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: { rootDir: string })` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: type-jobstatus.md -->

# JobStatus

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationGenerator.ts` (line 9)

Job status from API

## Definition

```ts
'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED'
```

<!-- source: type-mcpclientoptions.md -->

# McpClientOptions

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/mcp/mcp-client.ts` (line 43)

## Definition

```ts
McpStdioOptions | McpHttpOptions
```

<!-- source: constant-metadata.md -->

# metadata

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/app/(marketing)/groundedness/page.tsx` (line 6)

Public groundedness benchmark (Track C 0.4) — the category-of-one claim: no docs/AI
vendor in any lane publishes accuracy metrics. Numbers from the live benchmark harness
run against Atloria's own monorepo (methodology + harness committed in-repo).

<!-- source: service-openaireviewerservice.md -->

# OpenAIReviewerService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/openai-reviewer.service.ts` (line 1)

<!-- source: type-pagetype.md -->

# PageType

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 88)

## Definition

```ts
'homepage' | 'landing' | 'product' | 'pricing' | 'contact'
```

<!-- source: interface-retryconfig.md -->

# RetryConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/retry-handler.service.ts` (line 6)

Configuration for retry behavior

## Properties

| Property | Type |
|---|---|
| `maxRetries` | `number` |
| `initialDelayMs` | `number` |
| `backoffMultiplier` | `number` |
| `maxDelayMs` | `number` |
| `onRetry` | `(error: Error, attempt: number, delay: number) => void` |

<!-- source: service-retryhandlerservice.md -->

# RetryHandlerService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/retry-handler.service.ts` (line 74)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `isRetryableError` | `isRetryableError(error: Error | string | null | undefined, additionalRetryablePatterns: string[])` | `boolean` |
| `calculateBackoffDelay` | `calculateBackoffDelay(attempt: number, config: RetryConfig)` | `number` |
| `retryWithBackoff` | `retryWithBackoff(fn: () => Promise<T>, config: RetryConfig)` | `Promise<T>` |

<!-- source: type-searchdoctype-2.md -->

# SearchDocType

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/technical-docs/search-index.ts` (line 20)

Prebuilt STATIC search index for a published site (F4).

A compact, self-contained JSON blob the reader fetches once and searches
client-side when the live search API (Azure AI Search / Postgres) is
unavailable — so search survives an API outage or a static export.

This module is a PURE transform (no I/O) so it is fully unit-testable: the
materializer fetches the corpus + entity graph and hands them here.

SUPERIOR: for technical-doc sites each page carries an entity-graph
importance `boost` (call-graph in-degree centrality + public-API-surface
weight). The client scorer uses it as a tie-breaker so the important ~5% of
thousands of generated reference pages float to the top. User-manual pages
(no code graph) get boost 0 and rank on text alone.

## Definition

```ts
'user_manual' | 'technical_ref'
```

<!-- source: interface-sessionslistoptions.md -->

# SessionsListOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/commands/sessions.command.ts` (line 16)

<!-- source: type-storagemode.md -->

# StorageMode

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/storage.interface.ts` (line 15)

Storage Provider Interfaces

Defines storage abstraction for dual-mode operation:
- File System Mode: Local directory storage (CLI)
- Cloud Mode: Azure Storage via API (API/Web)

## Definition

```ts
'file-system' | 'cloud'
```

<!-- source: constant-swebench-starter-ids.md -->

# SWEBENCH_STARTER_IDS

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-subset.ts` (line 228)

Just the task IDs for quick filtering.

## Definition

```ts
string[]
```

<!-- source: api-endpoint-takescreenshot.md -->

# takeScreenshot

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.controller.ts` (line 194)

Take a single screenshot

POST /api/screenshot

Body:
{
  "url": "https://example.com",
  "projectId": "uuid",
  "viewport": { "width": 1920, "height": 1080 },
  "fullPage": true,
  "waitForSelector": ".main-content"
}

## Endpoint

`POST /screenshot`

## Referenced By

- `ScreenshotController` (MODULE_DECLARES)

<!-- source: graphql-mutation-updateuser.md -->

# updateUser

**Kind:** Graphql Mutation

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Update user profile

## Relationships

- TYPE_OF → `User`
- TYPE_OF → `UpdateUserInput`

## Referenced By

- `Mutation` (CALLS_API)

<!-- source: graphql-type-updateuserinput.md -->

# UpdateUserInput

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Input for updating a user

## Referenced By

- `updateUser` (TYPE_OF)

<!-- source: constant-addsyntaxextension.md -->

# addSyntaxExtension$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 354)

Adds a syntax extension to the markdown parser.

<!-- source: interface-agenttraffic.md -->

# AgentTraffic

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/events/agent-analytics.service.ts` (line 15)

Agent-native analytics — "who/what AI is reading your docs".

A read-side aggregation over the `agent_read` interaction_events the public agent
surfaces (llms.txt / llms-full.txt / .md twins / MCP) already record via EventsService.
No new capture. Mirrors ManualsInsightsService.deflection: one org-scoped fetch, JS
aggregation, a zero-filled daily trend. The `refusedQuestions` panel folds in the
`chat_refused` signal — the loop-closer: what agents/users asked that the docs
couldn't answer.

## Properties

| Property | Type |
|---|---|
| `windowDays` | `number` |
| `total` | `number` |
| `byAgent` | `Array<{ agent: string; count: number }>` |
| `bySurface` | `Array<{ surface: string; count: number }>` |
| `topPages` | `Array<{ path: string; count: number }>` |
| `trend` | `Array<{ date: string; count: number }>` |
| `refusedQuestions` | `Array<{ question: string; count: number }>` |

<!-- source: component-aienrichmentcontent.md -->

# AiEnrichmentContent

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/entity/[entityId]/page.tsx` (line 170)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `content` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AiEnrichmentContent_36de275e["AiEnrichmentContent"]
    class component_AiEnrichmentContent_36de275e rootComponent
```

## Relationships

- RENDERS → `MarkdownRenderer`

## Referenced By

- `EntityDetailPage` (RENDERS)

<!-- source: interface-analyticsconfig.md -->

# AnalyticsConfig

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/analytics.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `provider` | `AnalyticsProvider` |
| `trackingId` | `string` |

<!-- source: interface-applypatchoptions.md -->

# ApplyPatchOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/apply-patch.tool.ts` (line 38)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `maxFileSize` | `number` |
| `checkpointManager` | `CheckpointManager` |

<!-- source: api-endpoint-assist.md -->

# assist

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-mcp.controller.ts` (line 321)

## Endpoint

`POST /technical-docs/:projectId/pages/:slug/assist`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `slug` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsMcpController` (MODULE_DECLARES)

<!-- source: class-atloriaendpointlist.md -->

# AtloriaEndpointList

**Kind:** Class

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/EndpointList.ts` (line 23)

**Extends:** `LitElement`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `render` | `render()` | `void` |

## Properties

| Property | Type |
|---|---|
| `styles` | `any` |
| `endpoints` | `APIEndpoint[]` |
| `selectedId` | `any` |
| `groupBy` | `'controller' | 'tag' | 'method'` |

<!-- source: service-authservice.md -->

# AuthService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/auth/auth.service.ts` (line 26)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `register` | `register(registerDto: RegisterDto)` | `Promise<AuthResponseDto>` |
| `verifyEmail` | `verifyEmail(token: string)` | `Promise<{ verified: boolean; email: string }>` |
| `resendVerification` | `resendVerification(userId: string)` | `Promise<{ sent: boolean; alreadyVerified?: boolean }>` |
| `forgotPassword` | `forgotPassword(email: string)` | `Promise<{ message: string }>` |
| `resetPassword` | `resetPassword(token: string, newPassword: string)` | `Promise<{ success: boolean }>` |
| `login` | `login(loginDto: LoginDto)` | `Promise<AuthResponseDto>` |
| `refresh` | `refresh(refreshToken: string)` | `Promise<AuthResponseDto>` |
| `logout` | `logout(userId: string)` | `Promise<void>` |
| `getMe` | `getMe(userId: string)` | `Promise<UserResponseDto>` |
| `validateUser` | `validateUser(email: string, password: string)` | `Promise<User | null>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `redisservice`
- DEPENDS_ON → `jwtservice`
- DEPENDS_ON → `configservice`
- DEPENDS_ON → `emailservice`

<!-- source: interface-boardfiltersstate.md -->

# BoardFiltersState

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 22)

## Properties

| Property | Type |
|---|---|
| `priorities` | `string[]` |
| `categories` | `string[]` |
| `assigneeIds` | `string[]` |
| `audiences` | `string[]` |
| `hasReporterEmail` | `'any' | 'yes' | 'no'` |

<!-- source: controller-boardscontroller.md -->

# BoardsController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 23)

## Relationships

- MODULE_DECLARES → `list`
- MODULE_DECLARES → `create`
- MODULE_DECLARES → `getOne`
- MODULE_DECLARES → `update`
- MODULE_DECLARES → `remove`
- MODULE_DECLARES → `restore`
- MODULE_DECLARES → `addColumn`
- MODULE_DECLARES → `reorderColumns`
- MODULE_DECLARES → `updateColumn`
- MODULE_DECLARES → `deleteColumn`
- MODULE_DECLARES → `listCards`
- MODULE_DECLARES → `addCards`
- MODULE_DECLARES → `moveCard`
- MODULE_DECLARES → `removeCard`
- MODULE_DECLARES → `getBoardsForIssue`
- DEPENDS_ON → `boardsservice`

<!-- source: function-buildchunkrelationshipgraph.md -->

# buildChunkRelationshipGraph

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-02-chunking/chunk-relationship-graph.ts` (line 14)

Build a relationship graph between chunks

## Signature

```ts
function buildChunkRelationshipGraph(chunks: Chunk[], allEntities: Entity[]): ChunkRelationshipGraph
```

## Parameters

| Name | Type |
|---|---|
| `chunks` | `Chunk[]` |
| `allEntities` | `Entity[]` |

**Returns:** `ChunkRelationshipGraph`

<!-- source: function-buildreviewnudge.md -->

# buildReviewNudge

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/self-review.ts` (line 78)

Build a compact review nudge (for injection into instructions).
Shorter than the full review prompt — just highlights what to check.

## Signature

```ts
function buildReviewNudge(editedFiles: EditedFile[]): string
```

## Parameters

| Name | Type |
|---|---|
| `editedFiles` | `EditedFile[]` |

**Returns:** `string`

<!-- source: function-buildstrategyquestionprompt.md -->

# buildStrategyQuestionPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/strategy.prompts.ts` (line 94)

## Signature

```ts
function buildStrategyQuestionPrompt(docSummary: string, screenshotCount: number): string
```

## Parameters

| Name | Type |
|---|---|
| `docSummary` | `string` |
| `screenshotCount` | `number` |

**Returns:** `string`

<!-- source: function-buildsystemoverview.md -->

# buildSystemOverview

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/system-overview.ts` (line 45)

## Signature

```ts
function buildSystemOverview(input: SystemOverviewInput): string
```

## Parameters

| Name | Type |
|---|---|
| `input` | `SystemOverviewInput` |

**Returns:** `string`

<!-- source: class-bulkupdateissuesdto.md -->

# BulkUpdateIssuesDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/issues/dto/update-issue.dto.ts` (line 28)

## Properties

| Property | Type |
|---|---|
| `issueIds` | `string[]` |
| `status` | `IssueStatus` |
| `priority` | `IssuePriority` |
| `assigneeId` | `string | null` |

<!-- source: module-capturemodule.md -->

# CaptureModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/capture/capture.module.ts` (line 11)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `draftdocumentmodule`
- MODULE_DECLARES → `capturecontroller`
- MODULE_DECLARES → `publiccapturecontroller`
- MODULE_PROVIDES → `captureservice`
- MODULE_PROVIDES → `flowdraftstitcherservice`
- MODULE_EXPORTS → `captureservice`

<!-- source: type-captureprogresscallback.md -->

# CaptureProgressCallback

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-capturer.service.ts` (line 34)

## Definition

```ts
(progress: CaptureProgress) => void
```

<!-- source: class-checkpointmanager.md -->

# CheckpointManager

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/checkpoint-manager.ts` (line 43)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createWithGit` | `createWithGit(rootDir: string, config: Omit<CheckpointManagerConfig, 'rootDir' | 'backend'> & {
      sessionId?: string;
      staleAgeDays?: number;
    })` | `CheckpointManager` |
| `snapshot` | `snapshot(relPath: string, label: string)` | `boolean` |
| `rollback` | `rollback(relPath: string, index: number)` | `string | null` |
| `getSnapshots` | `getSnapshots(relPath: string)` | `readonly Snapshot[]` |
| `getSnapshotCount` | `getSnapshotCount(relPath: string)` | `number` |
| `getTotalCount` | `getTotalCount()` | `number` |
| `getTrackedFiles` | `getTrackedFiles()` | `string[]` |
| `clear` | `clear()` | `void` |
| `getBackend` | `getBackend()` | `CheckpointBackend` |

<!-- source: function-clearallpendingupdates.md -->

# clearAllPendingUpdates

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useOfflineSync.ts` (line 379)

Clear all pending updates across all documents
Use with caution - this will discard all offline changes

## Signature

```ts
function clearAllPendingUpdates(): void
```

**Returns:** `void`

<!-- source: interface-codeentity.md -->

# CodeEntity

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 4)

Simplified entity representation for AI analysis

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `type` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `startLine` | `number` |
| `endLine` | `number` |
| `metadata` | `Record<string, any>` |

<!-- source: constant-competitor-docs.md -->

# COMPETITOR_DOCS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/web-search/data/competitor-docs-index.ts` (line 18)

## Definition

```ts
CompetitorDoc[]
```

<!-- source: function-createtestcollaborationsession.md -->

# createTestCollaborationSession

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 214)

## Signature

```ts
function createTestCollaborationSession(documentId: string, userCount): TestCollaborationSession
```

## Parameters

| Name | Type |
|---|---|
| `documentId` | `string` |
| `userCount` | `any` |

**Returns:** `TestCollaborationSession`

<!-- source: interface-entitypath.md -->

# EntityPath

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/relationship.interface.ts` (line 291)

Graph path between entities

## Properties

| Property | Type |
|---|---|
| `startId` | `string` |
| `endId` | `string` |
| `relationships` | `Relationship[]` |
| `entityIds` | `string[]` |
| `length` | `number` |

<!-- source: function-extractclientip.md -->

# extractClientIp

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/analytics/utils/tracking-utils.ts` (line 128)

Extract the client IP from a NestJS/Express request. Checks headers set
by reverse proxies and CDNs in this order:
  1. CF-Connecting-IP (Cloudflare)
  2. X-Real-IP (nginx default)
  3. X-Forwarded-For (standard proxy header — first IP in the chain)
  4. req.ip / connection.remoteAddress (direct connection fallback)

Returns `null` if nothing usable is found (should be rare in production).

## Signature

```ts
function extractClientIp(req: {
  headers?: Record<string, string | string[] | undefined>;
  ip?: string;
  connection?: { remoteAddress?: string };
  socket?: { remoteAddress?: string };
}): string | null
```

## Parameters

| Name | Type |
|---|---|
| `req` | `{
  headers?: Record<string, string | string[] | undefined>;
  ip?: string;
  connection?: { remoteAddress?: string };
  socket?: { remoteAddress?: string };
}` |

**Returns:** `string | null`

<!-- source: component-faqtwocolumn.md -->

# FaqTwoColumn

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/faq/faq-two-column.tsx` (line 14)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `items` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FaqTwoColumn_26bcfedd["FaqTwoColumn"]
    class component_FaqTwoColumn_26bcfedd rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `AccordionItem`
- USES_HOOK → `useTranslation`

<!-- source: class-flowlocalesrequestdto.md -->

# FlowLocalesRequestDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/flow-replay.dto.ts` (line 211)

SUPERIOR: replay the WHOLE recipe once per locale in one call, emitting a
localized screenshot set per locale (blob-namespaced by locale).

**Extends:** `FlowReplayRequestDto`

## Properties

| Property | Type |
|---|---|
| `locales` | `string[]` |
| `viewport` | `ViewportDto` |

<!-- source: function-generatelandingpage.md -->

# generateLandingPage

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/generate.ts` (line 85)

## Signature

```ts
async function generateLandingPage(outputDir: string, sections: SectionSelection[], resolved: ManifestSection[], seo: SiteAssemblyConfig['seo']): Promise<string>
```

## Parameters

| Name | Type |
|---|---|
| `outputDir` | `string` |
| `sections` | `SectionSelection[]` |
| `resolved` | `ManifestSection[]` |
| `seo` | `SiteAssemblyConfig['seo']` |

**Returns:** `Promise<string>`

<!-- source: api-endpoint-getqueuemetrics.md -->

# getQueueMetrics

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/orchestrator.controller.ts` (line 152)

Get queue metrics

## Endpoint

`GET /api/orchestrator/queue/metrics`

## Referenced By

- `OrchestratorController` (MODULE_DECLARES)

<!-- source: function-getreactlifecyclemethods.md -->

# getReactLifecycleMethods

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 523)

Get lifecycle methods for React class components

## Signature

```ts
function getReactLifecycleMethods(): string[]
```

**Returns:** `string[]`

<!-- source: interface-herogradientsplitprops.md -->

# HeroGradientSplitProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/hero/hero-gradient-split.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `subheadlineKey` | `string` |
| `primaryCtaKey` | `string` |
| `primaryCtaUrl` | `string` |
| `secondaryCtaKey` | `string` |
| `secondaryCtaUrl` | `string` |
| `imageSrc` | `string` |
| `imageAlt` | `string` |
| `badges` | `{ textKey: string; icon?: LucideIcon }[]` |
| `className` | `string` |

<!-- source: interface-imagegenerationresponse.md -->

# ImageGenerationResponse

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/providers/azure-image.provider.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `b64Data` | `string` |
| `revisedPrompt` | `string` |

<!-- source: function-initializeallparsers.md -->

# initializeAllParsers

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/queue/processors/parser-registry.ts` (line 93)

Initialize and register all parsers from parser-core

## Signature

```ts
async function initializeAllParsers(rootDir): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `rootDir` | `any` |

**Returns:** `Promise<void>`

<!-- source: component-insertcomplexmarkdownbutton.md -->

# InsertComplexMarkdownButton

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/insert-markdown.tsx` (line 141)

## Diagram

```mermaid
graph TD
    component_InsertComplexMarkdownButton_46eea884["InsertComplexMarkdownButton"]
    class component_InsertComplexMarkdownButton_46eea884 rootComponent
```

## Relationships

- USES_HOOK → `usePublisher`

## Referenced By

- `InsertMarkdownWithTableAndList` (RENDERS)

<!-- source: class-jsonconfigparser-2.md -->

# JsonConfigParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/config-docs/json-config.parser.ts` (line 58)

JSON Config Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: function-logincommand.md -->

# loginCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/login.command.ts` (line 144)

Login command handler

## Signature

```ts
async function loginCommand(options: LoginOptions): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `LoginOptions` |

**Returns:** `Promise<void>`

<!-- source: type-mcpserverconfig.md -->

# McpServerConfig

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/mcp/mcp-manager.ts` (line 45)

## Definition

```ts
McpStdioServerConfig | McpHttpServerConfig
```

<!-- source: type-menustyle.md -->

# MenuStyle

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/BrandingContext.tsx` (line 11)

Project branding fetched from the public project endpoint.
All fields nullable — frontend falls back to defaults (Atloria cyan +
project name) when any field is missing.

## Definition

```ts
'minimal' | 'classic' | 'sidebar' | 'developer'
```

<!-- source: constant-metadata-2.md -->

# metadata

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/app/(marketing)/manuals-benchmark/page.tsx` (line 8)

Public manuals-quality benchmark — the second category-of-one claim (after /groundedness):
no user-manual / help-center vendor publishes a documentation-quality score. Numbers from
the atlorix style-benchmark harness (rubrics per style + structural scorer + 3-judge LLM
median), run against Atloria's own generated doc-sets. Scores are easy to update here as
saas/corporate clear the gate.

<!-- source: service-parsercorebridge.md -->

# ParserCoreBridge

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/services/parser-core-bridge.service.ts` (line 1)

<!-- source: type-pricinglayout.md -->

# PricingLayout

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 15)

## Definition

```ts
'columns' | 'comparison-table' | 'slider'
```

<!-- source: interface-screenshotmetadata.md -->

# ScreenshotMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot-metadata.service.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `url` | `string` |
| `viewport` | `{ width: number; height: number }` |
| `stateType` | `'default' | 'hover' | 'modal' | 'error' | 'success' | 'loading'` |
| `flowStepId` | `string` |
| `browser` | `'chromium' | 'firefox' | 'webkit'` |
| `fullPage` | `boolean` |
| `contentHash` | `string` |

<!-- source: service-screenshotmetadataservice.md -->

# ScreenshotMetadataService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot-metadata.service.ts` (line 36)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `calculateContentHash` | `calculateContentHash(buffer: Buffer)` | `string` |
| `findExisting` | `findExisting(metadata: ScreenshotMetadata)` | `Promise<ExistingScreenshot | null>` |
| `shouldRegenerate` | `shouldRegenerate(existing: ExistingScreenshot, newContentHash: string)` | `boolean` |
| `save` | `save(buffer: Buffer, metadata: ScreenshotMetadata, assetUrl: string, organizationId: string, capturedBy: string, jobId: string)` | `Promise<{ id: string; version: number }>` |
| `getHistory` | `getHistory(projectId: string, flowStepId: string)` | `Promise<ExistingScreenshot[]>` |
| `markAsBaseline` | `markAsBaseline(screenshotId: string)` | `Promise<void>` |
| `getBaseline` | `getBaseline(projectId: string, viewport: string, stateType: string, flowStepId: string)` | `Promise<ExistingScreenshot | null>` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: interface-sessionsshowoptions.md -->

# SessionsShowOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/commands/sessions.command.ts` (line 17)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |

<!-- source: type-stalenesslevel.md -->

# StalenessLevel

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/doc-version/screenshot-staleness.service.ts` (line 3)

## Definition

```ts
'fresh' | 'valid' | 'warning' | 'stale' | 'critical' | 'missing'
```

<!-- source: constant-swebench-starter-subset.md -->

# SWEBENCH_STARTER_SUBSET

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-subset.ts` (line 36)

## Definition

```ts
SubsetEntry[]
```

<!-- source: api-endpoint-takesmartauthenticatedscreenshot.md -->

# takeSmartAuthenticatedScreenshot

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.controller.ts` (line 280)

Smart authenticated screenshot - AI auto-detects login form selectors

POST /api/screenshot/smart-auth

Body:
{
  "url": "https://example.com/dashboard",
  "projectId": "uuid",
  "organizationId": "uuid",
  "capturedBy": "uuid",
  "auth": {
    "loginUrl": "https://example.com/login",
    "username": "user@example.com",
    "password": "password"
  },
  "viewport": { "width": 1920, "height": 1080 },
  "fullPage": true
}

The AI will automatically:
1. Navigate to the login page
2. Analyze the HTML to find username, password, and submit selectors
3. Fill in credentials and submit
4. Navigate to the target URL and take a screenshot

## Endpoint

`POST /screenshot/smart-auth`

## Referenced By

- `ScreenshotController` (MODULE_DECLARES)

<!-- source: type-templateelement.md -->

# TemplateElement

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/template-analysis.interface.ts` (line 206)

Generic template element (union type)

## Definition

```ts
| ButtonElement
  | LinkElement
  | FormElement
  | ComponentUsage
  | ModalTrigger
```

<!-- source: graphql-type-userconnection.md -->

# UserConnection

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

Paginated user list

## Relationships

- TYPE_OF → `User`

## Referenced By

- `users` (TYPE_OF)

<!-- source: constant-addtomarkdownextension.md -->

# addToMarkdownExtension$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 372)

Adds a markdown to string extension to be used when exporting markdown from the Lexical tree.

<!-- source: interface-agentturndoneevent.md -->

# AgentTurnDoneEvent

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/agent/agent.types.ts` (line 130)

## Properties

| Property | Type |
|---|---|
| `turnNumber` | `number` |
| `usage` | `{
    inputTokens: number;
    outputTokens: number;
    totalTokens: number;
  }` |

<!-- source: component-aienrichmentcontent-2.md -->

# AiEnrichmentContent

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/technical/entity/[entityId]/page.tsx` (line 100)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `content` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AiEnrichmentContent_71334741["AiEnrichmentContent"]
    class component_AiEnrichmentContent_71334741 rootComponent
```

## Referenced By

- `PublicEntityDetailPage` (RENDERS)

<!-- source: interface-analyzerprogresscallback.md -->

# AnalyzerProgressCallback

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-04-analysis/analyzer.service.ts` (line 31)

<!-- source: api-endpoint-assistapply.md -->

# assistApply

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-mcp.controller.ts` (line 339)

## Endpoint

`POST /technical-docs/:projectId/pages/:slug/assist/apply`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `slug` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsMcpController` (MODULE_DECLARES)

<!-- source: class-atloriaenvironmentselector.md -->

# AtloriaEnvironmentSelector

**Kind:** Class

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/EnvironmentSelector.ts` (line 14)

**Extends:** `LitElement`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `render` | `render()` | `void` |

## Properties

| Property | Type |
|---|---|
| `styles` | `any` |
| `environments` | `Environment[]` |
| `selected` | `any` |

<!-- source: interface-attemptresult.md -->

# AttemptResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/retry-runner.ts` (line 40)

## Properties

| Property | Type |
|---|---|
| `attemptIndex` | `number` |
| `score` | `number` |

<!-- source: service-azureaisearchservice.md -->

# AzureAISearchService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/web-search/services/azure-ai-search.service.ts` (line 23)

Azure AI Search Service
Queries the indexed competitor documentation

## Methods

| Method | Signature | Returns |
|---|---|---|
| `search` | `search(query: SearchQuery)` | `Promise<CompetitorSearchResult>` |
| `searchByCategory` | `searchByCategory(category: string, limit: unknown)` | `Promise<SearchResult[]>` |
| `getDocumentByUrl` | `getDocumentByUrl(url: string)` | `Promise<SearchResult | null>` |
| `healthCheck` | `healthCheck()` | `Promise<boolean>` |

<!-- source: controller-brandingcontroller.md -->

# BrandingController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/branding/branding.controller.ts` (line 8)

## Relationships

- MODULE_DECLARES → `getBranding`
- MODULE_DECLARES → `updateBranding`
- DEPENDS_ON → `brandingservice`

<!-- source: interface-breadcrumb.md -->

# Breadcrumb

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Layout/Breadcrumbs.tsx` (line 11)

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `href` | `string` |
| `current` | `boolean` |

<!-- source: function-buildextractionprompt.md -->

# buildExtractionPrompt

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/services/business-context-extractor.ts` (line 27)

Build the AI extraction prompt from combined source text.
The caller reads sources, concatenates text, and passes it here.

## Signature

```ts
function buildExtractionPrompt(sourceText: string, productName: string): string
```

## Parameters

| Name | Type |
|---|---|
| `sourceText` | `string` |
| `productName` | `string` |

**Returns:** `string`

<!-- source: function-buildreviewprompt.md -->

# buildReviewPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/self-review.ts` (line 36)

Build a review prompt for a set of file diffs.
Can be sent to a sub-agent or injected as a nudge.

## Signature

```ts
function buildReviewPrompt(editedFiles: EditedFile[]): string
```

## Parameters

| Name | Type |
|---|---|
| `editedFiles` | `EditedFile[]` |

**Returns:** `string`

<!-- source: function-buildstrategysystemprompt.md -->

# buildStrategySystemPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/strategy.prompts.ts` (line 10)

## Signature

```ts
function buildStrategySystemPrompt(config: GenerationConfig): string
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |

**Returns:** `string`

<!-- source: class-bulkupdatevisibilitydto.md -->

# BulkUpdateVisibilityDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/bulk-operations.dto.ts` (line 46)

Bulk update document visibility

## Properties

| Property | Type |
|---|---|
| `documentIds` | `string[]` |
| `isPublic` | `boolean` |

<!-- source: function-calculatecoveragereport.md -->

# calculateCoverageReport

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/coverage-calculator.ts` (line 236)

Calculate overall coverage report

## Signature

```ts
function calculateCoverageReport(entities: Entity[], screenshots: EnhancedScreenshotMetadata[], interactions: UIInteraction[]): CoverageReport
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `Entity[]` |
| `screenshots` | `EnhancedScreenshotMetadata[]` |
| `interactions` | `UIInteraction[]` |

**Returns:** `CoverageReport`

<!-- source: type-capturetype.md -->

# CaptureType

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/screenshot-spec.types.ts` (line 19)

What kind of UI state to capture

## Definition

```ts
| 'page'
  | 'modal'
  | 'tab'
  | 'form-empty'
  | 'form-validation'
  | 'form-filled'
  | 'toast'
  | 'state-guided'
  | 'workflow-sequence'
```

<!-- source: class-chunker.md -->

# Chunker

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/chunker.ts` (line 56)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `chunkFile` | `chunkFile(filePath: string, rootDir: string)` | `CodeChunk[]` |
| `chunkDirectory` | `chunkDirectory(rootDir: string, config: {
      maxFiles?: number;
      includeExtensions?: string[];
      excludeDirs?: string[];
      targetChunkTokens?: number;
    })` | `CodeChunk[]` |
| `extractImports` | `extractImports(content: string)` | `string` |

<!-- source: function-clearcolorcache.md -->

# clearColorCache

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/user-colors.ts` (line 136)

Clear the color cache (useful for testing or cleanup)

## Signature

```ts
function clearColorCache(): void
```

**Returns:** `void`

<!-- source: interface-coderelationship.md -->

# CodeRelationship

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 17)

Simplified relationship representation for AI analysis

## Properties

| Property | Type |
|---|---|
| `sourceId` | `string` |
| `targetId` | `string` |
| `type` | `string` |
| `metadata` | `Record<string, any>` |

<!-- source: module-collaborationmodule.md -->

# CollaborationModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/collaboration/collaboration.module.ts` (line 37)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_PROVIDES → `collaborationservice`
- MODULE_PROVIDES → `collaborationgateway`
- MODULE_PROVIDES → `documentpersistenceservice`
- MODULE_PROVIDES → `collaborationmetricsservice`
- MODULE_EXPORTS → `collaborationservice`
- MODULE_EXPORTS → `documentpersistenceservice`
- MODULE_EXPORTS → `collaborationmetricsservice`

<!-- source: function-createtestcomment.md -->

# createTestComment

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 105)

## Signature

```ts
function createTestComment(overrides: Partial<TestCommentData>): TestCommentData
```

## Parameters

| Name | Type |
|---|---|
| `overrides` | `Partial<TestCommentData>` |

**Returns:** `TestCommentData`

<!-- source: constant-currentuser.md -->

# CurrentUser

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/auth/decorators/current-user.decorator.ts` (line 13)

<!-- source: interface-envvariableentity.md -->

# EnvVariableEntity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 920)

Environment variable entity

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.ENV_VARIABLE` |
| `variableName` | `string` |
| `exampleValue` | `string` |
| `isSensitive` | `boolean` |
| `isRequired` | `boolean` |
| `category` | `string` |

<!-- source: component-featureicon.md -->

# FeatureIcon

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/feature-icon.tsx` (line 17)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `icon` | `LucideIcon` | ✓ | - |
| `size` | `number` | - | 24 |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_FeatureIcon_500ff6b3["FeatureIcon"]
    class component_FeatureIcon_500ff6b3 rootComponent
```

## Relationships

- RENDERS → `Icon`

<!-- source: function-filltemplate.md -->

# fillTemplate

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/ai/prompts/prompt-templates.ts` (line 125)

Replace template variables in a prompt

## Signature

```ts
function fillTemplate(template: string, variables: Record<string, string>): string
```

## Parameters

| Name | Type |
|---|---|
| `template` | `string` |
| `variables` | `Record<string, string>` |

**Returns:** `string`

<!-- source: class-flowredactboxdto.md -->

# FlowRedactBoxDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/flow-replay.dto.ts` (line 57)

A region (PERCENT 0-100 of the natural image) to BLACK OUT before upload. The
worker burns a filled rectangle into the screenshot pixels — destructive by
design, so a redacted value can never be recovered from the stored asset.

## Properties

| Property | Type |
|---|---|
| `x` | `number` |
| `y` | `number` |
| `w` | `number` |
| `h` | `number` |

<!-- source: function-generatelocales.md -->

# generateLocales

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/generate.ts` (line 327)

## Signature

```ts
async function generateLocales(outputDir: string, locales: LocaleConfig[]): Promise<string[]>
```

## Parameters

| Name | Type |
|---|---|
| `outputDir` | `string` |
| `locales` | `LocaleConfig[]` |

**Returns:** `Promise<string[]>`

<!-- source: api-endpoint-getuserbyid.md -->

# getUserById

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

Get user by ID

## Endpoint

`GET /users/{id}`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Relationships

- REFERENCES → `UserWithProfile`
- REFERENCES → `Error`

## Referenced By

- `User Management API` (IMPLEMENTS_API)

<!-- source: function-hashstring.md -->

# hashString

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 449)

Simple hash function for generating unique IDs

## Signature

```ts
function hashString(str: string): string
```

## Parameters

| Name | Type |
|---|---|
| `str` | `string` |

**Returns:** `string`

<!-- source: interface-herominimalcenteredprops.md -->

# HeroMinimalCenteredProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/hero/hero-minimal-centered.tsx` (line 14)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `subheadlineKey` | `string` |
| `primaryCtaKey` | `string` |
| `primaryCtaUrl` | `string` |
| `secondaryCtaKey` | `string` |
| `secondaryCtaUrl` | `string` |
| `badgeKey` | `string` |
| `badgeIcon` | `LucideIcon` |
| `dividerIcons` | `LucideIcon[]` |
| `imageSrc` | `string` |
| `imageAlt` | `string` |

<!-- source: interface-imagemetadata.md -->

# ImageMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/image-quality.guardrail.ts` (line 28)

## Properties

| Property | Type |
|---|---|
| `width` | `number` |
| `height` | `number` |
| `format` | `string` |
| `sizeBytes` | `number` |
| `hasAlpha` | `boolean` |
| `url` | `string` |

<!-- source: component-insertcustomimage.md -->

# InsertCustomImage

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/images.tsx` (line 99)

## Diagram

```mermaid
graph TD
    component_InsertCustomImage_2db81f54["InsertCustomImage"]
    class component_InsertCustomImage_2db81f54 rootComponent
```

## Relationships

- USES_HOOK → `usePublisher`

## Referenced By

- `InsertImageSignal` (RENDERS)

<!-- source: class-markdownparser-2.md -->

# MarkdownParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/config-docs/markdown.parser.ts` (line 64)

Markdown Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: function-mcpaddcommand.md -->

# mcpAddCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/mcp.command.ts` (line 53)

## Signature

```ts
async function mcpAddCommand(name: string, options: McpAddOptions): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `name` | `string` |
| `options` | `McpAddOptions` |

**Returns:** `Promise<void>`

<!-- source: function-measureexecutiontime.md -->

# measureExecutionTime

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 332)

Measure execution time

## Signature

```ts
async function measureExecutionTime(fn: () => Promise<T>): Promise<{ result: T; duration: number }>
```

## Parameters

| Name | Type |
|---|---|
| `fn` | `() => Promise<T>` |

**Returns:** `Promise<{ result: T; duration: number }>`

<!-- source: type-memorypersister.md -->

# MemoryPersister

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/session-memory.ts` (line 60)

Callback that receives extracted memories for persistence.
Domain layers implement this to write memories to disk, database, etc.

## Definition

```ts
(memories: SessionMemory[]) => void | Promise<void>
```

<!-- source: constant-metadata-3.md -->

# metadata

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/app/(marketing)/pricing/page.tsx` (line 7)

Transparent pricing (Phase 1.4). Deliberate contrast with sales-led competitors
(kapa.ai publishes no pricing; median negotiated deals ~$19k/yr): visible credit
economics, self-serve. Prices map to the live billing constants (1 credit unit set):
technical generation 200cr, RAG index 100cr, enrichment 100cr, chat ask 5cr, assist 10cr.

<!-- source: graphql-type-mutation.md -->

# Mutation

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

## Relationships

- CALLS_API → `createUser`
- CALLS_API → `updateUser`
- CALLS_API → `deleteUser`
- CALLS_API → `createPost`
- CALLS_API → `updatePost`
- CALLS_API → `deletePost`
- CALLS_API → `likePost`
- CALLS_API → `unlikePost`
- CALLS_API → `followUser`
- CALLS_API → `unfollowUser`
- CALLS_API → `addComment`
- CALLS_API → `login`
- CALLS_API → `refreshToken`

<!-- source: type-origin.md -->

# Origin

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 199)

## Definition

```ts
'chat escalation' | 'reader report' | 'email'
```

<!-- source: service-parserservice-2.md -->

# ParserService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/parser.service.ts` (line 1)

<!-- source: type-problemlayout.md -->

# ProblemLayout

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 16)

## Definition

```ts
'centered' | 'split-visual'
```

<!-- source: interface-screenshotoptions.md -->

# ScreenshotOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/playwright/playwright.service.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `browserType` | `BrowserType` |
| `viewport` | `{
    width: number;
    height: number;
  }` |
| `fullPage` | `boolean` |
| `waitForSelector` | `string` |
| `waitForTimeout` | `number` |
| `authentication` | `{
    username: string;
    password: string;
  }` |

<!-- source: service-screenshotservice.md -->

# ScreenshotService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.service.ts` (line 78)

Screenshot orchestration service

Coordinates Playwright and Storage services to:
1. Take screenshots
2. Upload to Azure Blob Storage
3. Return public URLs

## Methods

| Method | Signature | Returns |
|---|---|---|
| `takeAndUpload` | `takeAndUpload(request: TakeScreenshotRequest)` | `Promise<ScreenshotResult>` |
| `takeResponsiveScreenshots` | `takeResponsiveScreenshots(url: string, projectId: string, organizationId: string, capturedBy: string)` | `Promise<ScreenshotResult[]>` |
| `takeAuthenticatedScreenshot` | `takeAuthenticatedScreenshot(request: TakeAuthenticatedScreenshotRequest)` | `Promise<ScreenshotResult>` |
| `takeSmartAuthenticatedScreenshot` | `takeSmartAuthenticatedScreenshot(_request: TakeSmartAuthenticatedScreenshotRequest)` | `Promise<ScreenshotResult>` |

## Relationships

- DEPENDS_ON → `playwrightservice`
- DEPENDS_ON → `storageservice`
- DEPENDS_ON → `screenshotmetadataservice`

<!-- source: interface-stdiotransportoptions.md -->

# StdioTransportOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/stdio-transport.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `formatTodo` | `(items: ReadonlyArray<TodoItem>, stats: TodoStats) => string` |

<!-- source: constant-tool-profiles.md -->

# TOOL_PROFILES

**Kind:** Constant

**Source:** `atloria-monorepo/libs/agent-core/src/tools/tool-profiles.ts` (line 24)

Tool name sets per mode. `null` means all tools (full mode).

Note: tool_search is always included — it's the discovery mechanism
for deferred tools. journal and note are always included for working memory.

## Definition

```ts
Record<TaskMode, readonly string[] | null>
```

<!-- source: type-typedefinitionmap.md -->

# TypeDefinitionMap

**Kind:** Type

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 51)

Type definition map for resolving type references

## Definition

```ts
Map<string, t.TSInterfaceDeclaration | t.TSTypeAliasDeclaration>
```

<!-- source: type-updatescheduledreportdto.md -->

# UpdateScheduledReportDto

**Kind:** Type

**Source:** `atloria-monorepo/apps/api/src/analytics/export/scheduled-reports.service.ts` (line 22)

## Definition

```ts
Partial<CreateScheduledReportDto> & {
  enabled?: boolean;
}
```

<!-- source: api-endpoint-validateselectors.md -->

# validateSelectors

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/batch-screenshot.controller.ts` (line 351)

## Endpoint

`POST /screenshot/validate-selectors`

## Referenced By

- `BatchScreenshotController` (MODULE_DECLARES)

<!-- source: constant-addtopareachild.md -->

# addTopAreaChild$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 746)

Lets you add React components on top of the editor (like the toolbar).

<!-- source: interface-agentverboseevent.md -->

# AgentVerboseEvent

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/agent/agent.types.ts` (line 144)

## Properties

| Property | Type |
|---|---|
| `category` | `string` |
| `message` | `string` |
| `data` | `Record<string, unknown>` |
| `timestamp` | `number` |

<!-- source: component-analyticscontent.md -->

# AnalyticsContent

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/analytics/page.tsx` (line 10)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AnalyticsContent_32571187["AnalyticsContent"]
    class component_AnalyticsContent_32571187 rootComponent
```

## Relationships

- RENDERS → `DeflectionCockpit`
- RENDERS → `TicketContentOpportunities`
- RENDERS → `AgentTrafficCockpit`
- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useEffect`

## Referenced By

- `AnalyticsPage` (RENDERS)

<!-- source: interface-angulardetectionconfig.md -->

# AngularDetectionConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/angular.patterns.ts` (line 235)

## Properties

| Property | Type |
|---|---|
| `name` | `'angular'` |
| `filePatterns` | `string[]` |
| `identifiers` | `RegExp[]` |
| `configFiles` | `string[]` |

<!-- source: class-atloriainput.md -->

# AtloriaInput

**Kind:** Class

**Source:** `atloria-monorepo/packages/ui-core/src/components/input/Input.ts` (line 22)

A fully accessible input component with validation states

**Extends:** `LitElement`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `focus` | `focus()` | `void` |
| `blur` | `blur()` | `void` |
| `select` | `select()` | `void` |
| `render` | `render()` | `void` |

## Properties

| Property | Type |
|---|---|
| `styles` | `any` |
| `type` | `InputType` |
| `name` | `any` |
| `value` | `any` |
| `label` | `any` |
| `placeholder` | `any` |
| `helperText` | `any` |
| `errorMessage` | `any` |
| `successMessage` | `any` |
| `required` | `any` |
| `disabled` | `any` |
| `readonly` | `any` |
| `minlength` | `number` |
| `maxlength` | `number` |
| `pattern` | `string` |
| `autocomplete` | `string` |

<!-- source: interface-autonomousinstructionsoptions.md -->

# AutonomousInstructionsOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/autonomous-loop.ts` (line 60)

## Properties

| Property | Type |
|---|---|
| `goal` | `string` |
| `workspaceDir` | `string` |
| `qualityGates` | `QualityGate[]` |
| `context` | `string` |
| `discoveryHints` | `string[]` |

<!-- source: service-azureblobservice.md -->

# AzureBlobService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/assets/azure-blob.service.ts` (line 8)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `upload` | `upload(options: {
    buffer: Buffer;
    filename: string;
    mimeType: string;
    organizationId: string;
  })` | `Promise<{ url: string; cdnUrl: string }>` |
| `delete` | `delete(blobName: string)` | `Promise<void>` |
| `getBlobUrl` | `getBlobUrl(blobName: string)` | `string` |
| `generateSasUrl` | `generateSasUrl(blobName: string, _expiresInMinutes: unknown)` | `Promise<string>` |

## Relationships

- DEPENDS_ON → `configservice`

<!-- source: interface-breadcrumbitem.md -->

# BreadcrumbItem

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/Breadcrumbs.tsx` (line 8)

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `href` | `string` |

<!-- source: function-buildpamsintelligence.md -->

# buildPAMSIntelligence

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/agent-screenshot-mapper.ts` (line 267)

Pre-built intelligence for PAMS — in production this would be generated
by the agent reading the source code. For the POC, we extracted it manually
from the routing analysis.

## Signature

```ts
function buildPAMSIntelligence(): SourceCodeIntelligence
```

**Returns:** `SourceCodeIntelligence`

<!-- source: function-buildsandboxargs.md -->

# buildSandboxArgs

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/bash-sandbox.ts` (line 84)

Build the argument array for spawning a command under sandbox-exec.

## Signature

```ts
function buildSandboxArgs(command: string, rootDir: string): string[]
```

## Parameters

| Name | Type |
|---|---|
| `command` | `string` |
| `rootDir` | `string` |

**Returns:** `string[]`

<!-- source: function-buildthemecss.md -->

# buildThemeCss

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/theme.ts` (line 138)

Build a <style> block with :root CSS custom properties.

## Signature

```ts
function buildThemeCss(theme: ResolvedTheme): string
```

## Parameters

| Name | Type |
|---|---|
| `theme` | `ResolvedTheme` |

**Returns:** `string`

<!-- source: api-endpoint-bulkcapturescreenshots.md -->

# bulkCaptureScreenshots

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/screenshot/screenshot.controller.ts` (line 37)

## Endpoint

`POST /screenshots/bulk`

## Referenced By

- `ScreenshotController` (MODULE_DECLARES)

<!-- source: function-calculatestatemachinecoverage.md -->

# calculateStateMachineCoverage

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/coverage-calculator.ts` (line 144)

Calculate coverage for a single state machine

## Signature

```ts
function calculateStateMachineCoverage(stateMachine: StateMachine, screenshots: EnhancedScreenshotMetadata[], interactions: UIInteraction[]): StateMachineCoverage
```

## Parameters

| Name | Type |
|---|---|
| `stateMachine` | `StateMachine` |
| `screenshots` | `EnhancedScreenshotMetadata[]` |
| `interactions` | `UIInteraction[]` |

**Returns:** `StateMachineCoverage`

<!-- source: controller-capturecontroller.md -->

# CaptureController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/capture/capture.controller.ts` (line 29)

Member-gated capture endpoints. A project member records a walkthrough of
THEIR product; we store the recipe (selectors + actions), never fabricated
screenshots and never secret input values.

## Relationships

- MODULE_DECLARES → `create`
- MODULE_DECLARES → `list`
- MODULE_DECLARES → `get`
- MODULE_DECLARES → `updateSteps`
- MODULE_DECLARES → `reshootStep`
- MODULE_DECLARES → `reshootLocales`
- MODULE_DECLARES → `remove`
- MODULE_DECLARES → `draft`
- DEPENDS_ON → `captureservice`

<!-- source: class-capturedstepdto.md -->

# CapturedStepDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/capture/dto/create-flow.dto.ts` (line 40)

One recorded step in the recipe. Mirrors CapturedStep in the contract.

## Properties

| Property | Type |
|---|---|
| `order` | `number` |
| `action` | `CaptureAction` |
| `selector` | `string` |
| `xpath` | `string` |
| `elementText` | `string` |
| `elementRole` | `string` |
| `url` | `string` |
| `boundingBox` | `BoundingBoxDto` |
| `value` | `string` |
| `note` | `string` |
| `caption` | `string` |
| `redactions` | `RedactBoxDto[]` |
| `ts` | `number` |

<!-- source: type-cardvariant.md -->

# CardVariant

**Kind:** Type

**Source:** `atloria-monorepo/packages/ui-core/src/components/card/Card.ts` (line 5)

## Definition

```ts
'elevated' | 'outlined' | 'flat'
```

<!-- source: class-circledetector.md -->

# CircleDetector

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/circle-detector.ts` (line 307)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `recordTurn` | `recordTurn(record: TurnRecord)` | `void` |
| `analyze` | `analyze()` | `CircleDetectionResult` |
| `getProgressDelta` | `getProgressDelta()` | `number` |
| `suggestBudgetExtension` | `suggestBudgetExtension(currentTurn: number, maxTurns: number)` | `number` |
| `reset` | `reset()` | `void` |
| `getWindow` | `getWindow()` | `readonly TurnRecord[]` |

<!-- source: function-clearwizardstate.md -->

# clearWizardState

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/useNewProjectWizard.ts` (line 104)

<!-- source: interface-codesample.md -->

# CodeSample

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/code-samples.ts` (line 28)

## Properties

| Property | Type |
|---|---|
| `lang` | `string` |
| `source` | `string` |

<!-- source: module-commentmodule.md -->

# CommentModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/comment/comment.module.ts` (line 21)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `gatewaymodule`
- MODULE_IMPORTS → `activitymodule`
- MODULE_IMPORTS → `notificationmodule`
- MODULE_DECLARES → `commentcontroller`
- MODULE_PROVIDES → `commentservice`
- MODULE_PROVIDES → `commentgateway`
- MODULE_EXPORTS → `commentservice`
- MODULE_EXPORTS → `commentgateway`

<!-- source: function-createtestcommentthread.md -->

# createTestCommentThread

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 122)

## Signature

```ts
function createTestCommentThread(documentId: string, replyCount): TestCommentData[]
```

## Parameters

| Name | Type |
|---|---|
| `documentId` | `string` |
| `replyCount` | `any` |

**Returns:** `TestCommentData[]`

<!-- source: constant-databaseschematemplate.md -->

# databaseSchemaTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/database-schema.template.ts` (line 3)

<!-- source: interface-eventdefinition.md -->

# EventDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 380)

Event definition (Vue, Angular)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `payload` | `string` |
| `description` | `string` |

<!-- source: component-featuresalternating.md -->

# FeaturesAlternating

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/features/features-alternating.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `features` | `Feature[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FeaturesAlternating_6cfc90a5["FeaturesAlternating"]
    class component_FeaturesAlternating_6cfc90a5 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- USES_HOOK → `useTranslation`

<!-- source: class-flowreplayrequestdto.md -->

# FlowReplayRequestDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/flow-replay.dto.ts` (line 112)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `organizationId` | `string` |
| `capturedBy` | `string` |
| `documentId` | `string` |
| `flowId` | `string` |
| `startUrl` | `string` |
| `auth` | `BatchAuthConfigDto` |
| `config` | `BatchConfigDto` |
| `steps` | `FlowStepDto[]` |

<!-- source: function-formatconversationhistory.md -->

# formatConversationHistory

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/support-agent/prompts/rag-context-formatter.ts` (line 129)

Formats conversation history for context

## Signature

```ts
function formatConversationHistory(history: Array<{ role: string; content: string }>): string
```

## Parameters

| Name | Type |
|---|---|
| `history` | `Array<{ role: string; content: string }>` |

**Returns:** `string`

<!-- source: function-generatemain.md -->

# generateMain

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/generate.ts` (line 149)

## Signature

```ts
async function generateMain(outputDir: string, config: SiteAssemblyConfig): Promise<string>
```

## Parameters

| Name | Type |
|---|---|
| `outputDir` | `string` |
| `config` | `SiteAssemblyConfig` |

**Returns:** `Promise<string>`

<!-- source: api-endpoint-getuserposts.md -->

# getUserPosts

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/src/users/users.controller.ts` (line 79)

## Endpoint

`GET /users/:id/posts`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `UsersController` (MODULE_DECLARES)

<!-- source: function-hasjsxinpath.md -->

# hasJSXInPath

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 52)

Check if an AST node contains JSX

## Signature

```ts
function hasJSXInPath(path: NodePath): boolean
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath` |

**Returns:** `boolean`

<!-- source: interface-howitworkscardsgridprops.md -->

# HowItWorksCardsGridProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/how-it-works/how-it-works-cards-grid.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `labelKey` | `string` |
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `steps` | `{ icon: LucideIcon; titleKey: string; descriptionKey: string }[]` |

<!-- source: interface-imagequalityconfig.md -->

# ImageQualityConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/image-quality.guardrail.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `maxSizeBytes` | `number` |
| `expectedWidth` | `number` |
| `expectedHeight` | `number` |
| `dimensionTolerance` | `number` |
| `requireTransparent` | `boolean` |

<!-- source: component-insertgrid.md -->

# InsertGrid

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/nested-jsx-elements.tsx` (line 79)

## Diagram

```mermaid
graph TD
    component_InsertGrid_422d1885["InsertGrid"]
    class component_InsertGrid_422d1885 rootComponent
```

## Relationships

- RENDERS → `Button`
- USES_HOOK → `usePublisher`

## Referenced By

- `Example` (RENDERS)

<!-- source: function-mcplistcommand.md -->

# mcpListCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/mcp.command.ts` (line 98)

## Signature

```ts
async function mcpListCommand(options: { configPath?: string }): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `{ configPath?: string }` |

**Returns:** `Promise<void>`

<!-- source: class-mdxparser-2.md -->

# MdxParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/config-docs/mdx.parser.ts` (line 53)

MDX Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: function-measurememoryusage.md -->

# measureMemoryUsage

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 344)

Measure memory usage

## Signature

```ts
function measureMemoryUsage(): {
  heapUsed: number;
  heapTotal: number;
  external: number;
  rss: number;
}
```

**Returns:** `{
  heapUsed: number;
  heapTotal: number;
  external: number;
  rss: number;
}`

<!-- source: constant-metadata-4.md -->

# metadata

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/app/layout.tsx` (line 11)

<!-- source: type-modelinputitem.md -->

# ModelInputItem

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-provider-interface.ts` (line 56)

A single item in the conversation input.
Intentionally simple — providers map to their API's format internally.

## Definition

```ts
| { role: 'user'; content: string }
  | { role: 'assistant'; content: string; toolCalls?: ModelToolCall[] }
  | { role: 'tool'; toolCallId: string; content: string }
```

<!-- source: service-phaseservice.md -->

# PhaseService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-07-phases/divider.service.ts` (line 1)

<!-- source: type-pmejobstatus.md -->

# PmeJobStatus

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/stores/pmeStore.ts` (line 10)

## Definition

```ts
'idle' | 'queued' | 'processing' | 'generating_content' | 'generating_visuals' | 'assembling' | 'completed' | 'failed'
```

<!-- source: graphql-type-query.md -->

# Query

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

GraphQL Schema for User Management API

## Relationships

- CALLS_API → `users`
- CALLS_API → `user`
- CALLS_API → `posts`
- CALLS_API → `post`
- CALLS_API → `searchUsers`

<!-- source: type-renderandcapturefn.md -->

# RenderAndCaptureFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/tools/visual-qa.tool.ts` (line 25)

Function signature for rendering HTML and capturing screenshots.
In production: Playwright. In tests: mock.

## Definition

```ts
(
  html: string,
  viewports: Array<{ name: string; width: number; height: number }>
) => Promise<QaScreenshot[]>
```

<!-- source: interface-screenshotresult.md -->

# ScreenshotResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.service.ts` (line 59)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `url` | `string` |
| `filename` | `string` |
| `size` | `number` |
| `viewport` | `{ width: number; height: number }` |
| `uploadedAt` | `Date` |
| `version` | `number` |
| `isNew` | `boolean` |

<!-- source: service-stateresolverservice.md -->

# StateResolverService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/state-resolver.service.ts` (line 50)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `resolveState` | `resolveState(page: Page, config: StateResolutionConfigDto)` | `Promise<StateResolutionResult>` |

<!-- source: interface-storageconfig.md -->

# StorageConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/cli/src/services/storage-helper.service.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `mode` | `'static' | 'dynamic'` |
| `outputDir` | `string` |
| `apiUrl` | `string` |
| `apiToken` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |

<!-- source: interface-aimessage.md -->

# AIMessage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/interfaces/ai-types.ts` (line 3)

## Properties

| Property | Type |
|---|---|
| `role` | `'user' | 'assistant' | 'system'` |
| `content` | `string` |

<!-- source: constant-all-detection-configs.md -->

# ALL_DETECTION_CONFIGS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/index.ts` (line 44)

All available detection configurations

<!-- source: interface-angularinput.md -->

# AngularInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/angular-detector.ts` (line 48)

Angular input property

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `required` | `boolean` |
| `alias` | `string` |

<!-- source: component-answerskeleton.md -->

# AnswerSkeleton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/DeskCopilot.tsx` (line 95)

## Diagram

```mermaid
graph TD
    component_AnswerSkeleton_3e78c168["AnswerSkeleton"]
    class component_AnswerSkeleton_3e78c168 rootComponent
```

## Referenced By

- `CopilotTabBody` (RENDERS)

<!-- source: class-atloriamodeswitcher.md -->

# AtloriaModeSwitcher

**Kind:** Class

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/ModeSwitcher.ts` (line 10)

**Extends:** `LitElement`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `connectedCallback` | `connectedCallback()` | `void` |
| `disconnectedCallback` | `disconnectedCallback()` | `void` |
| `render` | `render()` | `void` |

## Properties

| Property | Type |
|---|---|
| `styles` | `any` |
| `mode` | `ExplorerMode` |

<!-- source: interface-autonomousturnhookoptions.md -->

# AutonomousTurnHookOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/autonomous-loop.ts` (line 258)

## Properties

| Property | Type |
|---|---|
| `investigationNudgeTurn` | `number` |
| `verificationNudgeTurn` | `number` |
| `maxTurns` | `number` |
| `qualityGateProvider` | `QualityGateProvider` |
| `tokenBudget` | `number` |
| `afterTurn` | `AfterTurnCallback` |
| `errorRecoveryThreshold` | `number` |
| `circuitBreakerThreshold` | `number` |
| `circuitBreakerCooldown` | `number` |
| `noteStore` | `AgentNoteStore` |
| `maxObservations` | `number` |
| `reactiveCompactThreshold` | `number` |
| `historyProcessors` | `HistoryProcessor[]` |
| `postCompactionHook` | `PostCompactionHook` |
| `modelCompactor` | `ModelCompactor` |
| `circleDetector` | `CircleDetectorOptions | false` |
| `envTracker` | `import('../tools/env-tracker').EnvTracker` |
| `sessionJournal` | `import('./session-journal').SessionJournal` |
| `phaseDirectives` | `boolean` |

<!-- source: service-azuresearchservice.md -->

# AzureSearchService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/azure-search.service.ts` (line 105)

Azure AI Search Service

Wrapper around Azure AI Search SDK.
Handles:
- Index creation and management
- Document indexing
- Full-text search with filtering
- Project-level isolation (multi-tenancy)
- Faceted search

`AzureSearchService` is a NestJS service that wraps the Azure AI Search SDK to provide a consistent API for indexing and searching documents within the backend. It manages index lifecycle (create/update), document ingestion, and full‑text search with filtering and faceting. The service enforces project-level isolation (multi-tenancy) so each project’s data is indexed and queried independently.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initializeIndex` | `initializeIndex()` | `Promise<void>` |
| `indexDocument` | `indexDocument(document: SearchDocument)` | `Promise<void>` |
| `indexBatch` | `indexBatch(documents: SearchDocument[])` | `Promise<void>` |
| `updateDocument` | `updateDocument(document: SearchDocument)` | `Promise<void>` |
| `deleteDocument` | `deleteDocument(documentId: string)` | `Promise<void>` |
| `search` | `search(query: string, options: SearchOptions)` | `Promise<SearchResponse>` |
| `getSuggestions` | `getSuggestions(query: string, organizationId: string, projectId: string, limit: number)` | `Promise<string[]>` |
| `deleteProjectDocuments` | `deleteProjectDocuments(projectId: string)` | `Promise<void>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant C as API Controller/Resolver
  participant S as AzureSearchService (NestJS)
  participant SDK as Azure AI Search SDK
  participant IDX as Search Index
  participant DOC as Indexed Documents

  C->>S: ensureIndex(projectId, schema)
  S->>SDK: createOrUpdateIndex(indexName, schema)
  SDK->>IDX: Upsert index definition
  IDX-->>SDK: OK
  SDK-->>S: OK
  S-->>C: ready

  C->>S: indexDocuments(projectId, docs)
  S->>SDK: upload/mergeOrUpload(indexName, docs)
  SDK->>DOC: Write documents
  DOC-->>SDK: Result
  SDK-->>S: Result
  S-->>C: indexed

  C->>S: search(projectId, query, filters, facets)
  S->>SDK: search(indexName, query, options)
  SDK->>IDX: Query w/ filter + facets
  IDX-->>SDK: Hits + facet counts
  SDK-->>S: Results
  S-->>C: results
```

## Usage

```ts
import { Controller, Get, Post, Body, Query } from '@nestjs/common';
import { AzureSearchService } from './azure-search.service';

@Controller('search')
export class SearchController {
  constructor(private readonly azureSearch: AzureSearchService) {}

  @Post('reindex')
  async reindex(@Body() body: { projectId: string; documents: any[] }) {
    // Ensure the tenant-specific index exists and is up to date
    await this.azureSearch.ensureIndex(body.projectId, {
      // Example index schema (shape depends on your implementation)
      name: 'documents',
      fields: [
        { name: 'id', type: 'Edm.String', key: true, filterable: true },
        { name: 'projectId', type: 'Edm.String', filterable: true },
        { name: 'title', type: 'Edm.String', searchable: true },
        { name: 'content', type: 'Edm.String', searchable: true },
        { name: 'tags', type: 'Collection(Edm.String)', filterable: true, facetable: true },
      ],
    });

    // Index documents (typically include projectId for isolation and filtering)
    await this.azureSearch.indexDocuments(body.projectId, body.documents);

    return { ok: true };
  }

  @Get()
  async search(
    @Query('projectId') projectId: string,
    @Query('q') q = '*',
    @Query('tag') tag?: string,
  ) {
    const filter = tag ? `tags/any(t: t eq '${tag}')` : undefined;

    const results = await this.azureSearch.search(projectId, q, {
      filter,
      facets: ['tags,count:10'],
      top: 20,
      skip: 0,
    });

    return results;
  }
}
```

## AI Coding Instructions

- Preserve project-level isolation: always derive the index name and/or filter scope from `projectId` and avoid cross-project queries by default.
- Keep index schema changes backward-compatible where possible; when changing fields, update `ensureIndex` flows and reindex strategy accordingly.
- When adding filters/facets, validate and sanitize user inputs to avoid malformed OData filter strings and unexpected query errors.
- Use Azure SDK batching/merge-or-upload patterns for indexing to avoid payload limits and reduce partial-failure risk; surface indexing errors with actionable logs.
- Ensure integration points (env/config for endpoint, API key, index naming conventions) are centralized so deployments don’t diverge between environments.

## Relationships

- DEPENDS_ON → `configservice`
- DEPENDS_ON → `prismaservice`

<!-- source: function-buildplaceholdermappingprompt.md -->

# buildPlaceholderMappingPrompt

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/agent-screenshot-mapper.ts` (line 191)

Prompt for sub-agents that map doc placeholders to screenshot specs
using the pre-built SourceCodeIntelligence.

## Signature

```ts
function buildPlaceholderMappingPrompt(intelligence: SourceCodeIntelligence, docs: DocScreenshotRequest[], siteUrl: string): string
```

## Parameters

| Name | Type |
|---|---|
| `intelligence` | `SourceCodeIntelligence` |
| `docs` | `DocScreenshotRequest[]` |
| `siteUrl` | `string` |

**Returns:** `string`

<!-- source: function-buildseatbeltprofile.md -->

# buildSeatbeltProfile

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/bash-sandbox.ts` (line 31)

Build a macOS Seatbelt profile (SBPL) that:
- Denies everything by default
- Allows global file reads (metadata, data, xattr)
- Allows file writes only within rootDir
- Allows process exec/fork (needed for sh, node, npm, git, etc.)
- Allows signal sending to own process group

## Signature

```ts
function buildSeatbeltProfile(rootDir: string): string
```

## Parameters

| Name | Type |
|---|---|
| `rootDir` | `string` |

**Returns:** `string`

<!-- source: function-buildthemetogglehtml.md -->

# buildThemeToggleHtml

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/theme.ts` (line 190)

Build the floating theme toggle HTML widget.

## Signature

```ts
function buildThemeToggleHtml(): string
```

**Returns:** `string`

<!-- source: api-endpoint-bulkdelete.md -->

# bulkDelete

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 766)

## Endpoint

`POST /documents/bulk/delete`

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: class-capturescreenshotdto.md -->

# CaptureScreenshotDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/screenshot/dto/capture-screenshot.dto.ts` (line 29)

DTO for capturing a single screenshot

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `url` | `string` |
| `viewport` | `ViewportType` |
| `browser` | `BrowserType` |
| `waitTime` | `number` |
| `isBaseline` | `boolean` |
| `flowStepId` | `string` |
| `stateType` | `string` |

<!-- source: controller-categorycontroller.md -->

# CategoryController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/document/category.controller.ts` (line 23)

## Relationships

- MODULE_DECLARES → `create`
- MODULE_DECLARES → `list`
- MODULE_DECLARES → `getTree`
- MODULE_DECLARES → `get`
- MODULE_DECLARES → `update`
- MODULE_DECLARES → `delete`
- MODULE_DECLARES → `reorder`
- DEPENDS_ON → `categoryservice`

<!-- source: function-checkifexported-2.md -->

# checkIfExported

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 587)

Check if a name is exported

## Signature

```ts
function checkIfExported(name: string, exportedNames: Set<string>): boolean
```

## Parameters

| Name | Type |
|---|---|
| `name` | `string` |
| `exportedNames` | `Set<string>` |

**Returns:** `boolean`

<!-- source: type-clicklinkcallback.md -->

# ClickLinkCallback

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 345)

## Definition

```ts
(url: string) => void
```

<!-- source: class-closedwindowprocessor.md -->

# ClosedWindowProcessor

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/history-processors.ts` (line 169)

Deduplicates file views — keeps only the most recent read of each file.
Older reads of the same file are replaced with a pointer.

Inspired by SWE-agent's ClosedWindowProcessor pattern.

Targets tools that read files: read_file, glob_search, grep_search.
Identifies the file path from tool input, and for duplicate paths,
replaces older outputs with "[Outdated — re-read in a later turn]".

**Implements:** `HistoryProcessor`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `process` | `process(items: AgentInputItem[])` | `AgentInputItem[]` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |

<!-- source: interface-codeparserprops.md -->

# CodeParserProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Parser/CodeParser.tsx` (line 10)

## Properties

| Property | Type |
|---|---|
| `initialCode` | `string` |
| `initialLanguage` | `string` |
| `onParseComplete` | `(result: unknown) => void` |
| `className` | `string` |

<!-- source: interface-competitorinfo-2.md -->

# CompetitorInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/competitor.interface.ts` (line 5)

Competitor documentation interfaces for Stage 2 AI Enhancement

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `docsUrl` | `string` |
| `apiDocsUrl` | `string` |
| `reason` | `string` |
| `category` | `string` |

<!-- source: function-countactivefilters.md -->

# countActiveFilters

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 48)

## Signature

```ts
function countActiveFilters(f: BoardFiltersState): number
```

## Parameters

| Name | Type |
|---|---|
| `f` | `BoardFiltersState` |

**Returns:** `number`

<!-- source: function-createtestdocument.md -->

# createTestDocument

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 63)

## Signature

```ts
function createTestDocument(overrides: Partial<TestDocumentData>): TestDocumentData
```

## Parameters

| Name | Type |
|---|---|
| `overrides` | `Partial<TestDocumentData>` |

**Returns:** `TestDocumentData`

<!-- source: module-dashboardmodule.md -->

# DashboardModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/dashboard/dashboard.module.ts` (line 8)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_DECLARES → `dashboardcontroller`
- MODULE_PROVIDES → `dashboardservice`
- MODULE_EXPORTS → `dashboardservice`

<!-- source: constant-default-sections.md -->

# DEFAULT_SECTIONS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/analytics/export/analytics-export.service.ts` (line 15)

## Definition

```ts
ExportSection[]
```

<!-- source: interface-exportinfo.md -->

# ExportInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 422)

Export information

## Properties

| Property | Type |
|---|---|
| `isDefault` | `boolean` |
| `namedExports` | `string[]` |

<!-- source: component-featuresbentomodern.md -->

# FeaturesBentoModern

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/features/features-bento-modern.tsx` (line 28)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `features` | `BentoFeature[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FeaturesBentoModern_4141f1ec["FeaturesBentoModern"]
    class component_FeaturesBentoModern_4141f1ec rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `FeatureIcon`
- USES_HOOK → `useTranslation`

<!-- source: class-flowreshootrequestdto.md -->

# FlowReshootRequestDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/flow-replay.dto.ts` (line 191)

Re-shoot ONE step of a recipe. The worker replays steps 0..(targetStepId-1) in a
single context to reach the right screen, then re-captures only `targetStepId`
— optionally at a new viewport / UI locale — and burns any per-step redactions
into the fresh asset. Runs SYNCHRONOUSLY (no job row): the caller gets the fresh
result back and the blob overwrites the canonical key, so existing drafts refresh.

`targetStepId` is a flowStepId: 0 = initial state; N = state AFTER the Nth step.

**Extends:** `FlowReplayRequestDto`

## Properties

| Property | Type |
|---|---|
| `targetStepId` | `number` |
| `viewport` | `ViewportDto` |
| `locale` | `string` |

<!-- source: function-formatragcontext.md -->

# formatRagContext

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/support-agent/prompts/rag-context-formatter.ts` (line 27)

Formats RAG search results into a structured context for the AI

## Signature

```ts
function formatRagContext(searchResults: RagSearchResult[], projectName: string): FormattedRagContext
```

## Parameters

| Name | Type |
|---|---|
| `searchResults` | `RagSearchResult[]` |
| `projectName` | `string` |

**Returns:** `FormattedRagContext`

<!-- source: api-endpoint-getusers.md -->

# getUsers

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

Get all users

## Endpoint

`GET /users`

| Parameter | In | Type | Required |
|---|---|---|---|
| `limit` | query | `integer` | - |
| `offset` | query | `integer` | - |

## Referenced By

- `User Management API` (IMPLEMENTS_API)

<!-- source: component-insertmyleaf.md -->

# InsertMyLeaf

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/jsx.tsx` (line 67)

## Diagram

```mermaid
graph TD
    component_InsertMyLeaf_763410a3["InsertMyLeaf"]
    class component_InsertMyLeaf_763410a3 rootComponent
```

## Relationships

- RENDERS → `Button`
- USES_HOOK → `usePublisher`

## Referenced By

- `Example` (RENDERS)

<!-- source: function-islifecyclemethod.md -->

# isLifecycleMethod

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 540)

Check if a method name is a React lifecycle method

## Signature

```ts
function isLifecycleMethod(methodName: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `methodName` | `string` |

**Returns:** `boolean`

<!-- source: function-loadmanifest.md -->

# loadManifest

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/validate.ts` (line 26)

## Signature

```ts
async function loadManifest(componentLibraryDir: string): Promise<Manifest>
```

## Parameters

| Name | Type |
|---|---|
| `componentLibraryDir` | `string` |

**Returns:** `Promise<Manifest>`

<!-- source: interface-localeconfig.md -->

# LocaleConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 70)

## Properties

| Property | Type |
|---|---|
| `code` | `string` |
| `name` | `string` |
| `nativeName` | `string` |
| `dir` | `'ltr' | 'rtl'` |
| `translations` | `Record<string, string>` |

<!-- source: function-mcpremovecommand.md -->

# mcpRemoveCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/mcp.command.ts` (line 125)

## Signature

```ts
async function mcpRemoveCommand(name: string, options: { configPath?: string }): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `name` | `string` |
| `options` | `{ configPath?: string }` |

**Returns:** `Promise<void>`

<!-- source: class-migrationparser-2.md -->

# MigrationParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/database/migration.parser.ts` (line 52)

Migration Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: type-modelproviderconfig.md -->

# ModelProviderConfig

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/runtime-config.ts` (line 30)

## Definition

```ts
| { provider: 'azure-responses'; config: AzureModelProviderConfig }
  | { provider: 'anthropic'; config: import('./anthropic-adapter').AnthropicModelProviderConfig }
  | { provider: 'vercel-ai'; config: VercelAIProviderConfig }
  | { provider: 'custom'; instance: IModelProvider }
```

<!-- source: interface-pagemetadata.md -->

# PageMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 115)

## Properties

| Property | Type |
|---|---|
| `generatedAt` | `Date` |
| `model` | `string` |
| `tokenUsage` | `{
    inputTokens: number;
    outputTokens: number;
  }` |
| `generationTimeMs` | `number` |

<!-- source: constant-position-step.md -->

# POSITION_STEP

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 47)

<!-- source: function-readfixturefile.md -->

# readFixtureFile

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 37)

Read a fixture file

## Signature

```ts
function readFixtureFile(relativePath: string): string
```

## Parameters

| Name | Type |
|---|---|
| `relativePath` | `string` |

**Returns:** `string`

<!-- source: service-screenshotcapturerservice.md -->

# ScreenshotCapturerService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-capturer.service.ts` (line 1)

<!-- source: type-searchdoctype.md -->

# SearchDocType

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/staticSearch.ts` (line 14)

Client-side scorer over the PREBUILT STATIC search index (F4).

PublicSearchModal fetches `/public/p/:slug/search-index.json` once and runs
this tiny inline scorer when the live search API is unavailable — so search
keeps working during an API/Azure outage or on a fully static export. No
external search dependency: a small, well-tuned term scorer.

Ranking = a text score (title/heading/token/excerpt matches, weighted by how
many query terms matched) plus a small entity-graph `boost` tie-breaker, so
the important pages float up among otherwise-similar text matches.

## Definition

```ts
'user_manual' | 'technical_ref'
```

<!-- source: type-sectionchoices.md -->

# SectionChoices

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 232)

Maps section type to chosen variant key for finalization.

## Definition

```ts
Partial<Record<SectionType, 'A' | 'B' | 'C'>>
```

<!-- source: interface-smartauthconfig.md -->

# SmartAuthConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.service.ts` (line 41)

## Properties

| Property | Type |
|---|---|
| `loginUrl` | `string` |
| `username` | `string` |
| `password` | `string` |

<!-- source: service-storageservice.md -->

# StorageService

**Kind:** Service

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/storage/storage.service.ts` (line 27)

Azure Blob Storage service for storing screenshots

Features:
- Upload screenshots to Azure Blob Storage
- Generate public URLs
- Support for metadata
- Auto-create containers

`StorageService` is a NestJS backend service responsible for persisting screenshot files into Azure Blob Storage and returning accessible URLs for later retrieval. It encapsulates container management (including auto-creation), upload operations, and optional blob metadata handling so the screenshot-worker can store outputs reliably without duplicating storage logic.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `upload` | `upload(options: UploadOptions)` | `Promise<UploadResult>` |
| `uploadMultiple` | `uploadMultiple(uploads: UploadOptions[])` | `Promise<UploadResult[]>` |
| `delete` | `delete(filename: string)` | `Promise<void>` |
| `isAvailable` | `isAvailable()` | `boolean` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant Worker as Screenshot Worker
  participant Storage as StorageService
  participant Azure as Azure Blob Storage

  Worker->>Storage: uploadScreenshot(buffer, filename, container, metadata?)
  Storage->>Azure: ensureContainerExists(container)
  Azure-->>Storage: container ready
  Storage->>Azure: uploadBlob(container, filename, buffer, metadata)
  Azure-->>Storage: upload result (etag/version)
  Storage->>Azure: generatePublicUrl(container, filename)
  Azure-->>Storage: public URL
  Storage-->>Worker: { url, blobName, container, etag? }
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { StorageService } from './storage/storage.service';

@Injectable()
export class ScreenshotJobService {
  constructor(private readonly storage: StorageService) {}

  async persistScreenshot(pngBuffer: Buffer, jobId: string) {
    const container = 'screenshots';
    const blobName = `jobs/${jobId}.png`;

    const result = await this.storage.uploadScreenshot(pngBuffer, blobName, {
      container,
      contentType: 'image/png',
      metadata: {
        jobId,
        source: 'screenshot-worker',
      },
    });

    // Store result.url in DB / emit event, etc.
    return result.url;
  }
}
```

## AI Coding Instructions

- Keep Azure-specific logic (container creation, blob client setup, URL generation) inside `StorageService`; call it from jobs/workers/controllers rather than re-implementing storage concerns.
- Always pass a deterministic `blobName` (include job IDs / timestamps) to avoid accidental overwrites; if overwrites are intended, document it explicitly.
- When attaching metadata, ensure values are strings and keep keys stable (Azure metadata constraints); avoid putting sensitive data in metadata since it can be exposed.
- Handle container creation idempotently (create-if-not-exists) and surface meaningful errors (auth, missing connection string, permissions) to the caller for retry/backoff logic.
- Prefer returning the generated public URL from the service (single source of truth for URL format/SAS/public access strategy) and avoid hardcoding URL templates elsewhere.

## Relationships

- DEPENDS_ON → `configservice`

<!-- source: graphql-type-subscription.md -->

# Subscription

**Kind:** Graphql Type

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/schema.graphql` (line 1)

## Relationships

- CALLS_API → `newPost`
- CALLS_API → `newComment`
- CALLS_API → `newFollower`

<!-- source: interface-aiprovider-2.md -->

# AIProvider

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/interfaces/ai-provider.interface.ts` (line 32)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |

<!-- source: constant-all-detectors.md -->

# ALL_DETECTORS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/index.ts` (line 69)

All available detectors

<!-- source: interface-angularservicemapping.md -->

# AngularServiceMapping

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/cross-language.types.ts` (line 81)

Angular Service Analysis - Maps service methods to API endpoints

## Properties

| Property | Type |
|---|---|
| `serviceFile` | `string` |
| `serviceName` | `string` |
| `baseUrl` | `string` |
| `methods` | `Array<{
    methodName: string; // "createJob"
    httpMethod: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
    endpoint: string; // "/api/sales/jobs"
    parameters: string[]; // ["jobData: CreateJobDto"]
    returnType: string; // "Observable<Job>"
    usedByComponents: string[]; // ["OrderFormComponent", "OrderListComponent"]
  }>` |

<!-- source: component-apipanel.md -->

# ApiPanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/page.tsx` (line 290)

## Diagram

```mermaid
graph TD
    component_ApiPanel_5363d6d4["ApiPanel"]
    class component_ApiPanel_5363d6d4 rootComponent
```

## Relationships

- RENDERS → `PreviewShell`

## Referenced By

- `HomePage` (RENDERS)

<!-- source: class-atloriarequestpanel.md -->

# AtloriaRequestPanel

**Kind:** Class

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/RequestPanel.ts` (line 46)

**Extends:** `LitElement`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `connectedCallback` | `connectedCallback()` | `void` |
| `disconnectedCallback` | `disconnectedCallback()` | `void` |
| `updated` | `updated(changedProperties: Map<string, any>)` | `void` |
| `render` | `render()` | `void` |

## Properties

| Property | Type |
|---|---|
| `styles` | `any` |
| `endpoint` | `APIEndpoint` |
| `environment` | `Environment` |
| `globalAuthToken` | `string` |

<!-- source: interface-azuremodelproviderconfig.md -->

# AzureModelProviderConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 177)

Model provider configuration for Azure OpenAI.

## Properties

| Property | Type |
|---|---|
| `modelProfile` | `import('./model-profiles').ModelCapabilityProfile` |
| `endpoint` | `string` |
| `apiKey` | `string` |
| `apiVersion` | `string` |
| `useV1Endpoint` | `boolean` |
| `defaultModel` | `string` |
| `timeout` | `number` |
| `fallbackModel` | `string` |
| `store` | `boolean` |
| `truncation` | `'auto' | 'disabled'` |
| `deferredToolNames` | `Set<string>` |

<!-- source: service-billingservice.md -->

# BillingService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/billing/billing.service.ts` (line 23)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createCheckoutSession` | `createCheckoutSession(user: JwtPayload, plan: BillingPlanKey)` | `Promise<{ url: string }>` |
| `createPortalSession` | `createPortalSession(user: JwtPayload)` | `Promise<{ url: string }>` |
| `handleWebhook` | `handleWebhook(rawBody: Buffer, signature: string)` | `Promise<{ received: boolean }>` |
| `getSummary` | `getSummary(user: JwtPayload)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `configservice`
- DEPENDS_ON → `aiusageservice`
- DEPENDS_ON → `stripe`

<!-- source: function-buildsetupinstructions.md -->

# buildSetupInstructions

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/setup-agent.ts` (line 78)

Build the system prompt / instructions for the setup sub-agent.

The returned string tells the agent exactly what to detect, in what order,
and how to format its final output.

## Signature

```ts
function buildSetupInstructions(workDir: string): string
```

## Parameters

| Name | Type |
|---|---|
| `workDir` | `string` |

**Returns:** `string`

<!-- source: function-buildsourceanalysisprompt.md -->

# buildSourceAnalysisPrompt

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/agent-screenshot-mapper.ts` (line 124)

Prompt for the main agent to analyze the source code and build the
SourceCodeIntelligence artifact. This runs ONCE per project.

## Signature

```ts
function buildSourceAnalysisPrompt(sourceCodePath: string, framework: string): string
```

## Parameters

| Name | Type |
|---|---|
| `sourceCodePath` | `string` |
| `framework` | `string` |

**Returns:** `string`

<!-- source: function-buildthemetogglejs.md -->

# buildThemeToggleJs

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/theme.ts` (line 209)

Build the client-side JS for theme toggling.
Accepts the default theme mode to use as initial value.

## Signature

```ts
function buildThemeToggleJs(defaultMode: ThemeMode): string
```

## Parameters

| Name | Type |
|---|---|
| `defaultMode` | `ThemeMode` |

**Returns:** `string`

<!-- source: api-endpoint-bulkmove.md -->

# bulkMove

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 800)

## Endpoint

`POST /documents/bulk/move`

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: controller-categorydocumentscontroller.md -->

# CategoryDocumentsController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 926)

Category Documents Controller - Handles document ordering within categories

## Relationships

- MODULE_DECLARES → `reorderDocuments`
- DEPENDS_ON → `documentservice`

<!-- source: class-categoryfiltersdto.md -->

# CategoryFiltersDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/category.dto.ts` (line 106)

DTO for category query filters

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `parentId` | `string` |
| `docVersionId` | `string` |

<!-- source: interface-codeviewerprops.md -->

# CodeViewerProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Parser/CodeViewer.tsx` (line 7)

## Properties

| Property | Type |
|---|---|
| `code` | `string` |
| `language` | `string` |
| `symbols` | `Symbol[]` |
| `highlightedSymbol` | `Symbol` |
| `onSymbolClick` | `(symbol: Symbol) => void` |
| `className` | `string` |

<!-- source: interface-competitorresearchresult-2.md -->

# CompetitorResearchResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/competitor.interface.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `projectType` | `string` |
| `competitors` | `CompetitorInfo[]` |
| `crawledPages` | `CrawledCompetitorPage[]` |
| `summary` | `string` |
| `totalContentLength` | `number` |
| `researchedAt` | `Date` |

<!-- source: type-confidencelevel.md -->

# ConfidenceLevel

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 40)

## Definition

```ts
(typeof CONFIDENCE_LEVELS)[number]
```

<!-- source: class-consolidator.md -->

# Consolidator

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/memory/consolidator.ts` (line 33)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `consolidate` | `consolidate(store: MemoryStore, projectId: string)` | `ConsolidationReport` |

<!-- source: function-countof.md -->

# countOf

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 237)

## Signature

```ts
function countOf(v: CountValue | undefined): number
```

## Parameters

| Name | Type |
|---|---|
| `v` | `CountValue | undefined` |

**Returns:** `number`

<!-- source: function-crawlpage.md -->

# crawlPage

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/web-crawler.ts` (line 32)

Crawl a single documentation page

## Signature

```ts
async function crawlPage(url: string): Promise<CrawledPage | null>
```

## Parameters

| Name | Type |
|---|---|
| `url` | `string` |

**Returns:** `Promise<CrawledPage | null>`

<!-- source: function-createtestdocuments.md -->

# createTestDocuments

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 80)

## Signature

```ts
function createTestDocuments(count: number): TestDocumentData[]
```

## Parameters

| Name | Type |
|---|---|
| `count` | `number` |

**Returns:** `TestDocumentData[]`

<!-- source: constant-desk-buckets.md -->

# DESK_BUCKETS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/issues/dto/desk.dto.ts` (line 14)

Plain-style queue buckets, DERIVED from status + assignee + first_agent_reply_at

<!-- source: module-documentationmodule.md -->

# DocumentationModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/documentation/documentation.module.ts` (line 33)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `aimodule`
- MODULE_IMPORTS → `graphmodule`
- MODULE_IMPORTS → `configmodule`
- MODULE_IMPORTS → `forwardref`
- MODULE_IMPORTS → `forwardref`
- MODULE_IMPORTS → `forwardref`
- MODULE_IMPORTS → `docversionmodule`
- MODULE_IMPORTS → `notificationmodule`
- MODULE_IMPORTS → `emailmodule`
- MODULE_DECLARES → `documentationcontroller`
- MODULE_DECLARES → `searchcontroller`
- MODULE_DECLARES → `docautomationcontroller`
- MODULE_PROVIDES → `documentationservice`
- MODULE_PROVIDES → `workflowdetectorservice`
- MODULE_PROVIDES → `userdocsgeneratorservice`
- MODULE_PROVIDES → `featuredetectorservice`
- MODULE_PROVIDES → `featuredocsgeneratorservice`
- MODULE_PROVIDES → `tutorialdetectorservice`
- MODULE_PROVIDES → `tutorialgeneratorservice`
- MODULE_PROVIDES → `neo4jdocsorchestratorservice`
- MODULE_PROVIDES → `keywordextractorservice`
- MODULE_PROVIDES → `azuresearchservice`
- MODULE_PROVIDES → `documentindexingservice`
- MODULE_PROVIDES → `docautomationservice`
- MODULE_PROVIDES → `docautomationgateway`
- MODULE_PROVIDES → `docautomationschedulerservice`
- MODULE_EXPORTS → `documentationservice`
- MODULE_EXPORTS → `featuredetectorservice`
- MODULE_EXPORTS → `featuredocsgeneratorservice`
- MODULE_EXPORTS → `tutorialdetectorservice`
- MODULE_EXPORTS → `tutorialgeneratorservice`
- MODULE_EXPORTS → `documentindexingservice`
- MODULE_EXPORTS → `azuresearchservice`
- MODULE_EXPORTS → `docautomationservice`
- MODULE_EXPORTS → `docautomationgateway`

<!-- source: component-featuresgridcards.md -->

# FeaturesGridCards

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/features/features-grid-cards.tsx` (line 22)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `labelKey` | `string` | - | - |
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `features` | `Feature[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FeaturesGridCards_5329cff6["FeaturesGridCards"]
    class component_FeaturesGridCards_5329cff6 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-span`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `FeatureIcon`
- USES_HOOK → `useTranslation`

<!-- source: interface-fielddefinition.md -->

# FieldDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 648)

Field definition for a database model

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `nullable` | `boolean` |
| `unique` | `boolean` |
| `primaryKey` | `boolean` |
| `autoIncrement` | `boolean` |
| `defaultValue` | `unknown` |
| `description` | `string` |
| `columnName` | `string` |

<!-- source: class-flowstepdto.md -->

# FlowStepDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/flow-replay.dto.ts` (line 68)

One step to replay. Mirrors the api-side CapturedStepDto so a CapturedFlow can
be forwarded to the worker verbatim.

## Properties

| Property | Type |
|---|---|
| `order` | `number` |
| `action` | `FlowAction` |
| `selector` | `string` |
| `xpath` | `string` |
| `elementText` | `string` |
| `url` | `string` |
| `value` | `string` |
| `boundingBox` | `FlowBoundingBoxDto` |
| `redactions` | `FlowRedactBoxDto[]` |

<!-- source: function-generateusercolor-2.md -->

# generateUserColor

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/collaboration/utils/color.ts` (line 29)

Generates a consistent color for a user based on their ID
Uses a hash function to ensure the same user always gets the same color

## Signature

```ts
function generateUserColor(userId: string): string
```

## Parameters

| Name | Type |
|---|---|
| `userId` | `string` |

**Returns:** `string`

<!-- source: api-endpoint-healthcheck.md -->

# healthCheck

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/orchestrator.controller.ts` (line 217)

Health check

## Endpoint

`GET /api/orchestrator/health`

## Referenced By

- `OrchestratorController` (MODULE_DECLARES)

<!-- source: component-insertsimplemarkdownbutton.md -->

# InsertSimpleMarkdownButton

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/insert-markdown.tsx` (line 99)

## Diagram

```mermaid
graph TD
    component_InsertSimpleMarkdownButton_356fd240["InsertSimpleMarkdownButton"]
    class component_InsertSimpleMarkdownButton_356fd240 rootComponent
```

## Relationships

- USES_HOOK → `usePublisher`

## Referenced By

- `InsertSimpleMarkdown` (RENDERS)

<!-- source: function-isreactclasscomponent.md -->

# isReactClassComponent

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 75)

Check if a class extends React.Component or React.PureComponent

## Signature

```ts
function isReactClassComponent(path: NodePath<t.ClassDeclaration>): boolean
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath<t.ClassDeclaration>` |

**Returns:** `boolean`

<!-- source: interface-manifest.md -->

# Manifest

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 109)

## Properties

| Property | Type |
|---|---|
| `version` | `string` |
| `categories` | `Record<string, CategoryMeta>` |
| `sections` | `ManifestSection[]` |

<!-- source: type-modelresponseitem.md -->

# ModelResponseItem

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-provider-interface.ts` (line 87)

A single item in the model's response.

## Definition

```ts
| { type: 'message'; content: string }
  | { type: 'function_call'; callId: string; name: string; arguments: string }
```

<!-- source: class-nestjsparser-2.md -->

# NestjsParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/backend/nestjs.parser.ts` (line 67)

NestJS Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: interface-pageoutput.md -->

# PageOutput

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 108)

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `sections` | `SectionContent[]` |
| `fullHtml` | `string` |
| `metadata` | `PageMetadata` |

<!-- source: function-parsecommand.md -->

# parseCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/parse.command.ts` (line 172)

Parse command handler

## Signature

```ts
async function parseCommand(options: ParseOptions): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `ParseOptions` |

**Returns:** `Promise<void>`

<!-- source: constant-priority-cfg.md -->

# PRIORITY_CFG

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 125)

## Definition

```ts
Record<string, { stripe: string; label: string; bg: string; text: string }>
```

<!-- source: function-readprojectfiles.md -->

# readProjectFiles

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 45)

Read all files in a directory recursively

## Signature

```ts
function readProjectFiles(projectPath: string, extensions: string[]): Array<{ filePath: string; content: string }>
```

## Parameters

| Name | Type |
|---|---|
| `projectPath` | `string` |
| `extensions` | `string[]` |

**Returns:** `Array<{ filePath: string; content: string }>`

<!-- source: service-screenshotextractorservice.md -->

# ScreenshotExtractorService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-extractor.service.ts` (line 1)

<!-- source: type-sectionrenderer.md -->

# SectionRenderer

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/tools/layouts/registry.ts` (line 12)

Signature every layout renderer must match.

## Definition

```ts
(
  content: Record<string, any>,
  visualStrategy: VisualStrategy,
) => string
```

<!-- source: type-slastate.md -->

# SlaState

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 20)

## Definition

```ts
'ok' | 'warn' | 'breach' | null
```

<!-- source: interface-stateresolutionresult.md -->

# StateResolutionResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/state-resolver.service.ts` (line 17)

## Properties

| Property | Type |
|---|---|
| `resolved` | `boolean` |
| `detailUrl` | `string` |
| `matchedRowIndex` | `number` |
| `matchedText` | `string` |
| `error` | `string` |

<!-- source: function-validateconfig.md -->

# validateConfig

**Kind:** Function

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/validate.ts` (line 35)

## Signature

```ts
function validateConfig(config: SiteAssemblyConfig, manifest: Manifest): ValidationResult
```

## Parameters

| Name | Type |
|---|---|
| `config` | `SiteAssemblyConfig` |
| `manifest` | `Manifest` |

**Returns:** `ValidationResult`

<!-- source: interface-airesponse.md -->

# AIResponse

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/interfaces/ai-provider.interface.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `text` | `string` |
| `usage` | `TokenUsage` |
| `model` | `string` |

<!-- source: constant-all-heading-levels.md -->

# ALL_HEADING_LEVELS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/headings/index.ts` (line 22)

<!-- source: interface-antddetectionconfig.md -->

# AntdDetectionConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/antd.patterns.ts` (line 278)

## Properties

| Property | Type |
|---|---|
| `name` | `'antd'` |
| `filePatterns` | `string[]` |
| `identifiers` | `RegExp[]` |
| `configFiles` | `string[]` |

<!-- source: component-appsection.md -->

# AppSection

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/components/EntityTree.tsx` (line 108)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `group` | `NavAppGroup` | ✓ | - |
| `enrichedIds` | `Set` | ✓ | - |
| `projectId` | `string` | ✓ | - |
| `selectedEntityId` | `string` | - | - |
| `isLib` | `boolean` | - | false |
| `entityHrefBase` | `string` | - | - |
| `pinnedIds` | `Set` | - | - |
| `onCurate` | `unknown` | - | - |

## Diagram

```mermaid
graph TD
    component_AppSection_1469504a["AppSection"]
    class component_AppSection_1469504a rootComponent
```

## Relationships

- RENDERS → `ChevronRightIcon`
- RENDERS → `CircleStackIcon`
- RENDERS → `CubeIcon`
- RENDERS → `EntityIcon`
- RENDERS → `CurateButtons`
- USES_HOOK → `useState`

## Referenced By

- `EntityTree` (RENDERS)

<!-- source: class-atloriaresponsepanel.md -->

# AtloriaResponsePanel

**Kind:** Class

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/ResponsePanel.ts` (line 19)

**Extends:** `LitElement`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `render` | `render()` | `void` |

## Properties

| Property | Type |
|---|---|
| `styles` | `any` |
| `response` | `APIResponse` |
| `loading` | `any` |
| `error` | `Error` |

<!-- source: interface-backgroundcompleteevent.md -->

# BackgroundCompleteEvent

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/spawn-agent.tool.ts` (line 77)

## Properties

| Property | Type |
|---|---|
| `agentName` | `string` |
| `task` | `string` |
| `success` | `boolean` |
| `output` | `string` |
| `error` | `string` |
| `durationMs` | `number` |

<!-- source: service-bitbucketservice.md -->

# BitbucketService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/bitbucket/bitbucket.service.ts` (line 5)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getAuthUrl` | `getAuthUrl(userId: string)` | `string` |
| `handleCallback` | `handleCallback(code: string, userId: string)` | `Promise<void>` |
| `getConnectionStatus` | `getConnectionStatus(userId: string)` | `Promise<{ connected: boolean; username: string | null }>` |
| `listRepos` | `listRepos(userId: string)` | `Promise<any[]>` |
| `listBranches` | `listBranches(userId: string, owner: string, repo: string)` | `Promise<any[]>` |
| `disconnect` | `disconnect(userId: string)` | `Promise<void>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `configservice`

<!-- source: function-buildstructuralfeedback.md -->

# buildStructuralFeedback

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/generator.service.ts` (line 902)

Build human-readable structural feedback from a StructureScore.
Used to construct the regeneration prompt when a doc fails the structure gate.

## Signature

```ts
function buildStructuralFeedback(score: StructureScore): string
```

## Parameters

| Name | Type |
|---|---|
| `score` | `StructureScore` |

**Returns:** `string`

<!-- source: function-buildtoolusageguide.md -->

# buildToolUsageGuide

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/tool-usage-guide.ts` (line 34)

Build tool usage instructions to inject into an agent's system prompt.

Example:
```typescript
const guide = buildToolUsageGuide({
  tools: ['read', 'edit', 'write', 'glob', 'grep', 'list_directory'],
});
const instructions = `${baseInstructions}\n\n${guide}`;
```

## Signature

```ts
function buildToolUsageGuide(options: ToolGuideOptions): string
```

## Parameters

| Name | Type |
|---|---|
| `options` | `ToolGuideOptions` |

**Returns:** `string`

<!-- source: function-buildvariantsystemprompt.md -->

# buildVariantSystemPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/variant.prompts.ts` (line 58)

## Signature

```ts
function buildVariantSystemPrompt(config: GenerationConfig, variantStyle: VariantStyle): string
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |
| `variantStyle` | `VariantStyle` |

**Returns:** `string`

<!-- source: api-endpoint-bulkpublish.md -->

# bulkPublish

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 859)

## Endpoint

`POST /documents/bulk/publish`

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: class-categoryskeletondto.md -->

# CategorySkeletonDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/documentation/dto/doc-automation.dto.ts` (line 34)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `icon` | `string` |
| `documents` | `DocumentSkeletonDto[]` |

<!-- source: interface-collaborationuser.md -->

# CollaborationUser

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useCollaboration.ts` (line 19)

Represents an active user in a collaboration session

## Properties

| Property | Type |
|---|---|
| `userId` | `string` |
| `userName` | `string` |
| `email` | `string` |
| `avatar` | `string` |
| `color` | `string` |
| `cursor` | `CursorPosition` |
| `selection` | `SelectionRange` |

<!-- source: controller-commentcontroller.md -->

# CommentController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/comment/comment.controller.ts` (line 34)

Controller for managing document comments
Provides endpoints for CRUD operations, threading, and resolution

## Relationships

- MODULE_DECLARES → `create`
- MODULE_DECLARES → `list`
- MODULE_DECLARES → `getById`
- MODULE_DECLARES → `update`
- MODULE_DECLARES → `delete`
- MODULE_DECLARES → `adminDelete`
- MODULE_DECLARES → `resolve`
- MODULE_DECLARES → `unresolve`
- MODULE_DECLARES → `addReply`
- DEPENDS_ON → `commentservice`

<!-- source: interface-componentaction.md -->

# ComponentAction

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 116)

## Properties

| Property | Type |
|---|---|
| `type` | `'button_click' | 'form_submit' | 'link_click' | 'event'` |
| `handler` | `string` |
| `label` | `string` |
| `filePath` | `string` |
| `lineNumber` | `number` |

<!-- source: class-contextmanager.md -->

# ContextManager

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/context-manager.ts` (line 54)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `add` | `add(item: Omit<ContextItem, 'turn' | 'tokenEstimate'> & { tokenEstimate?: number })` | `void` |
| `nextTurn` | `nextTurn()` | `void` |
| `getItems` | `getItems()` | `ReadonlyArray<ContextItem>` |
| `getTurn` | `getTurn()` | `number` |
| `getTotalTokens` | `getTotalTokens()` | `number` |
| `shouldCompact` | `shouldCompact()` | `boolean` |
| `compact` | `compact()` | `Promise<void>` |
| `clear` | `clear()` | `void` |

<!-- source: function-crawlpages.md -->

# crawlPages

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/web-crawler.ts` (line 89)

Crawl multiple pages with concurrency control

## Signature

```ts
async function crawlPages(urls: string[], concurrency): Promise<CrawledPage[]>
```

## Parameters

| Name | Type |
|---|---|
| `urls` | `string[]` |
| `concurrency` | `any` |

**Returns:** `Promise<CrawledPage[]>`

<!-- source: function-createapiclient.md -->

# createAPIClient

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/api-client.ts` (line 112)

Create an API client for the Atloria application

This client makes HTTP requests to the backend API

## Signature

```ts
function createAPIClient(config: {
  apiUrl: string;
  getToken?: () => string | null;
  /** True while NextAuth is still resolving the session — the fetcher waits instead of firing unauthenticated. */
  isSessionLoading?: () => boolean;
}): APIClient
```

## Parameters

| Name | Type |
|---|---|
| `config` | `{
  apiUrl: string;
  getToken?: () => string | null;
  /** True while NextAuth is still resolving the session — the fetcher waits instead of firing unauthenticated. */
  isSessionLoading?: () => boolean;
}` |

**Returns:** `APIClient`

<!-- source: function-createtesttemplate.md -->

# createTestTemplate

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 164)

## Signature

```ts
function createTestTemplate(overrides: Partial<TestTemplateData>): TestTemplateData
```

## Parameters

| Name | Type |
|---|---|
| `overrides` | `Partial<TestTemplateData>` |

**Returns:** `TestTemplateData`

<!-- source: type-dependencytype.md -->

# DependencyType

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 236)

## Definition

```ts
| 'imports' // import { X } from './x'
  | 'extends' // class X extends Y
  | 'implements' // class X implements Y
  | 'uses' // X uses Y in its implementation
  | 'validates' // X validates using Y (schema)
  | 'calls' // X calls Y.method()
  | 'renders' // X renders <Y />
  | 'state' // X uses Y f…
```

<!-- source: constant-desk-transitions.md -->

# DESK_TRANSITIONS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/issues/dto/desk.dto.ts` (line 27)

<!-- source: module-documentmodule.md -->

# DocumentModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/document/document.module.ts` (line 19)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `forwardref`
- MODULE_DECLARES → `documentcontroller`
- MODULE_DECLARES → `publicdocumentcontroller`
- MODULE_DECLARES → `categorycontroller`
- MODULE_DECLARES → `categorydocumentscontroller`
- MODULE_PROVIDES → `documentservice`
- MODULE_PROVIDES → `categoryservice`
- MODULE_PROVIDES → `urlservice`
- MODULE_PROVIDES → `tocbuilderservice`
- MODULE_PROVIDES → `documentrevisionservice`
- MODULE_PROVIDES → `documentversionservice`
- MODULE_EXPORTS → `documentservice`
- MODULE_EXPORTS → `categoryservice`
- MODULE_EXPORTS → `urlservice`
- MODULE_EXPORTS → `tocbuilderservice`
- MODULE_EXPORTS → `documentversionservice`

<!-- source: component-featureshorizontalflow.md -->

# FeaturesHorizontalFlow

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/features/features-horizontal-flow.tsx` (line 25)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `features` | `Feature[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FeaturesHorizontalFlow_7700544e["FeaturesHorizontalFlow"]
    class component_FeaturesHorizontalFlow_7700544e rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: function-getallenableddocs.md -->

# getAllEnabledDocs

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/web-search/data/competitor-docs-index.ts` (line 372)

Get all enabled documentation sites

## Signature

```ts
function getAllEnabledDocs(): CompetitorDoc[]
```

**Returns:** `CompetitorDoc[]`

<!-- source: interface-headinginfo.md -->

# HeadingInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 875)

Heading information in markdown

## Properties

| Property | Type |
|---|---|
| `level` | `number` |
| `text` | `string` |
| `line` | `number` |

<!-- source: class-interactionconfigdto.md -->

# InteractionConfigDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 257)

Interaction configuration for hover, focus, etc.

## Properties

| Property | Type |
|---|---|
| `interactionType` | `'hover' | 'focus' | 'rightClick'` |
| `holdDuration` | `number` |
| `targetHint` | `string` |

<!-- source: function-isreactcomponent.md -->

# isReactComponent

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 68)

Check if a function component is a React component (returns JSX)

## Signature

```ts
function isReactComponent(path: NodePath<t.FunctionDeclaration | t.ArrowFunctionExpression | t.FunctionExpression>): boolean
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath<t.FunctionDeclaration | t.ArrowFunctionExpression | t.FunctionExpression>` |

**Returns:** `boolean`

<!-- source: component-lazyimage.md -->

# LazyImage

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/ImageEditor.tsx` (line 82)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `title` | `string` | ✓ | - |
| `alt` | `string` | ✓ | - |
| `className` | `string | null` | ✓ | - |
| `imageRef` | `unknown` | ✓ | - |
| `src` | `string` | ✓ | - |
| `width` | `number | unknown` | ✓ | - |
| `height` | `number | unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_LazyImage_7ef42f1d["LazyImage"]
    class component_LazyImage_7ef42f1d rootComponent
```

## Referenced By

- `ImageEditor` (RENDERS)

<!-- source: api-endpoint-login.md -->

# login

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

User login

## Endpoint

`POST /auth/login`

## Relationships

- REFERENCES → `LoginRequest`
- REFERENCES → `AuthResponse`

## Referenced By

- `User Management API` (IMPLEMENTS_API)

<!-- source: interface-manifestprop.md -->

# ManifestProp

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 136)

## Properties

| Property | Type |
|---|---|
| `type` | `string` |
| `required` | `boolean` |
| `description` | `string` |

<!-- source: class-nextjsparser-2.md -->

# NextjsParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/frontend/nextjs.parser.ts` (line 57)

Next.js Parser

Pure TypeScript class that extends ReactParser to add Next.js-specific features.
No NestJS dependencies required.

**Extends:** `ReactParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `supportedPatterns` | `string[]` |

<!-- source: interface-pmecompletedevent.md -->

# PmeCompletedEvent

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 210)

WebSocket completion event payload.

## Properties

| Property | Type |
|---|---|
| `jobId` | `string` |
| `htmlUrl` | `string` |
| `pageCount` | `number` |
| `assetCount` | `number` |
| `durationMs` | `number` |

<!-- source: type-postcompactionhook.md -->

# PostCompactionHook

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/session/types.ts` (line 25)

Callback invoked after context compaction. Receives recently accessed file paths.
Returns file contents to inject as synthetic context items.
This enables "hard rehydration" — automatically restoring working context
after compaction, matching Claude Code's behavior.

## Definition

```ts
(recentFiles: string[]) => Promise<RehydrationItem[]> | RehydrationItem[]
```

<!-- source: constant-priority-cfg-2.md -->

# PRIORITY_CFG

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 15)

## Definition

```ts
Record<
  string,
  { bg: string; text: string; label: string }
>
```

<!-- source: function-processscreenshots.md -->

# processScreenshots

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/utils/screenshot-storage.helper.ts` (line 31)

Process and save screenshots using storage helper

This handles intelligent deduplication and metadata tracking

## Signature

```ts
async function processScreenshots(screenshots: ScreenshotInfo[], storage: StorageHelperService): Promise<Array<{ original: ScreenshotInfo; saved: { id: string; url: string; isNew: boolean } }>>
```

## Parameters

| Name | Type |
|---|---|
| `screenshots` | `ScreenshotInfo[]` |
| `storage` | `StorageHelperService` |

**Returns:** `Promise<Array<{ original: ScreenshotInfo; saved: { id: string; url: string; isNew: boolean } }>>`

<!-- source: function-registerparser.md -->

# registerParser

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/queue/processors/parse.processor.ts` (line 44)

Register a parser implementation

## Signature

```ts
function registerParser(name: string, parser: {
    parseFile: (filePath: string, content?: string) => Promise<ParseResult>;
    parseFiles: (files: Array<{ filePath: string; content?: string }>) => Promise<ParseResult[]>;
  }): void
```

## Parameters

| Name | Type |
|---|---|
| `name` | `string` |
| `parser` | `{
    parseFile: (filePath: string, content?: string) => Promise<ParseResult>;
    parseFiles: (files: Array<{ filePath: string; content?: string }>) => Promise<ParseResult[]>;
  }` |

**Returns:** `void`

<!-- source: service-screenshotmapperservice.md -->

# ScreenshotMapperService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-mapper.service.ts` (line 1)

<!-- source: type-sectiontype.md -->

# SectionType

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 90)

## Definition

```ts
| 'hero'
  | 'problem'
  | 'features'
  | 'how-it-works'
  | 'social-proof'
  | 'pricing'
  | 'faq'
  | 'cta'
```

<!-- source: type-snoozepreset.md -->

# SnoozePreset

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/DeskDialogs.tsx` (line 34)

## Definition

```ts
'1_hour' | 'tomorrow' | 'next_week'
```

<!-- source: interface-takeauthenticatedscreenshotrequest.md -->

# TakeAuthenticatedScreenshotRequest

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.service.ts` (line 29)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `capturedBy` | `string` |
| `auth` | `AuthConfig` |
| `viewport` | `{ width: number; height: number }` |
| `fullPage` | `boolean` |
| `waitForSelector` | `string` |
| `browser` | `'chromium' | 'firefox' | 'webkit'` |

<!-- source: interface-aiusagemetrics.md -->

# AIUsageMetrics

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/interfaces/ai-types.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `promptTokens` | `number` |
| `completionTokens` | `number` |
| `totalTokens` | `number` |
| `provider` | `string` |
| `model` | `string` |
| `timestamp` | `Date` |

<!-- source: constant-allowedheadinglevels.md -->

# allowedHeadingLevels$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/headings/index.ts` (line 42)

Holds the allowed heading levels.

<!-- source: interface-apicallpattern.md -->

# ApiCallPattern

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/cross-language.types.ts` (line 58)

## Properties

| Property | Type |
|---|---|
| `pattern` | `| 'http_client'
    | 'fetch'
    | 'axios'
    | 'angular_http'
    | 'rxjs'
    | 'nuxt_fetch'
    | 'python_requests'
    | 'python_httpx'` |
| `regex` | `RegExp` |
| `extractEndpoint` | `(match: RegExpMatchArray) => string` |

<!-- source: component-areachart.md -->

# AreaChart

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/analytics/AgentTrafficCockpit.tsx` (line 39)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `trend` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AreaChart_4bb8946f["AreaChart"]
    class component_AreaChart_4bb8946f rootComponent
```

## Referenced By

- `AgentTrafficCockpit` (RENDERS)

<!-- source: class-audienceendpoints.md -->

# AudienceEndpoints

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/audiences.ts` (line 30)

Audience endpoints

## Methods

| Method | Signature | Returns |
|---|---|---|
| `list` | `list()` | `Promise<AudienceModel[]>` |
| `get` | `get(id: string)` | `Promise<AudienceModel>` |
| `create` | `create(dto: CreateAudienceDto)` | `Promise<AudienceModel>` |
| `update` | `update(id: string, dto: UpdateAudienceDto)` | `Promise<AudienceModel>` |
| `delete` | `delete(id: string)` | `Promise<void>` |

<!-- source: interface-bashresult.md -->

# BashResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/bash-session.ts` (line 18)

Result of executing a command in a bash session.

## Properties

| Property | Type |
|---|---|
| `stdout` | `string` |
| `stderr` | `string` |
| `exitCode` | `number` |
| `timedOut` | `boolean` |
| `cwd` | `string` |

<!-- source: service-boardsservice.md -->

# BoardsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/boards/boards.service.ts` (line 52)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `list` | `list(projectId: string, user: JwtPayload)` | `unknown` |
| `create` | `create(projectId: string, dto: CreateBoardDto, user: JwtPayload)` | `unknown` |
| `getOne` | `getOne(projectId: string, boardId: string, user: JwtPayload, includeCards: unknown)` | `unknown` |
| `update` | `update(projectId: string, boardId: string, dto: UpdateBoardDto, user: JwtPayload)` | `unknown` |
| `remove` | `remove(projectId: string, boardId: string, user: JwtPayload)` | `unknown` |
| `restore` | `restore(projectId: string, boardId: string, user: JwtPayload)` | `unknown` |
| `addColumn` | `addColumn(projectId: string, boardId: string, dto: CreateColumnDto, user: JwtPayload)` | `unknown` |
| `updateColumn` | `updateColumn(projectId: string, boardId: string, columnId: string, dto: UpdateColumnDto, user: JwtPayload)` | `unknown` |
| `reorderColumns` | `reorderColumns(projectId: string, boardId: string, dto: ReorderColumnsDto, user: JwtPayload)` | `unknown` |
| `deleteColumn` | `deleteColumn(projectId: string, boardId: string, columnId: string, moveCardsTo: string | undefined, user: JwtPayload)` | `unknown` |
| `listCards` | `listCards(projectId: string, boardId: string, since: Date | undefined, user: JwtPayload)` | `unknown` |
| `addCards` | `addCards(projectId: string, boardId: string, dto: AddCardsDto, user: JwtPayload)` | `unknown` |
| `moveCard` | `moveCard(projectId: string, boardId: string, cardId: string, dto: MoveCardDto, user: JwtPayload)` | `unknown` |
| `removeCard` | `removeCard(projectId: string, boardId: string, cardId: string, user: JwtPayload)` | `unknown` |
| `getBoardsForIssue` | `getBoardsForIssue(projectId: string, issueId: string, user: JwtPayload)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `issuesservice`

<!-- source: function-buildvarianttaskprompt.md -->

# buildVariantTaskPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/variant.prompts.ts` (line 80)

## Signature

```ts
function buildVariantTaskPrompt(sectionType: SectionType, contentJson: string, variantKey: VariantKey): string
```

## Parameters

| Name | Type |
|---|---|
| `sectionType` | `SectionType` |
| `contentJson` | `string` |
| `variantKey` | `VariantKey` |

**Returns:** `string`

<!-- source: api-endpoint-bulkscreenshotaction.md -->

# bulkScreenshotAction

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 252)

## Endpoint

`POST /doc-versions/:projectId/:versionId/screenshots/bulk`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: function-calculategroundingscore.md -->

# calculateGroundingScore

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/grounding-checker.ts` (line 139)

Calculate grounding score for entity mentions against known entities.

For each mention, checks if it fuzzy-matches (Jaccard >= 0.5) any known entity.
- score = matchedCount / totalMentions
- Returns 0.5 (neutral) if totalMentions === 0

## Signature

```ts
function calculateGroundingScore(mentions: string[], knownEntities: string[]): GroundingScoreResult
```

## Parameters

| Name | Type |
|---|---|
| `mentions` | `string[]` |
| `knownEntities` | `string[]` |

**Returns:** `GroundingScoreResult`

<!-- source: class-chatdto.md -->

# ChatDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/support-agent/dto/chat.dto.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `message` | `string` |
| `versionNumber` | `number` |
| `conversationHistory` | `ConversationMessageDto[]` |
| `sessionId` | `string` |

<!-- source: function-checkcostlimit.md -->

# checkCostLimit

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/agent-hardening.ts` (line 141)

Check if a task has exceeded its cost budget.

Pattern from SWE-agent: $3/task default limit.
When exceeded, autosubmit whatever patch exists.

## Signature

```ts
function checkCostLimit(currentCost: number, limit: number | undefined): boolean
```

## Parameters

| Name | Type |
|---|---|
| `currentCost` | `number` |
| `limit` | `number | undefined` |

**Returns:** `boolean`

<!-- source: interface-completionsummaryprops.md -->

# CompletionSummaryProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/DocAutomation/CompletionSummary.tsx` (line 22)

## Properties

| Property | Type |
|---|---|
| `result` | `JobResult` |
| `projectSlug` | `string` |
| `projectId` | `string` |
| `onGenerateAgain` | `() => void` |
| `onViewDocs` | `() => void` |
| `screenshotProgress` | `{
    batchIndex: number;
    totalBatches: number;
    captured: number;
    totalMappings: number;
  } | null` |
| `onCancelScreenshots` | `() => void` |

<!-- source: interface-componententity-2.md -->

# ComponentEntity

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 360)

Component entity (React, Vue, Angular)

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.COMPONENT` |
| `componentType` | `'functional' | 'class'` |
| `props` | `PropDefinition[]` |
| `hooks` | `HookUsage[]` |
| `events` | `EventDefinition[]` |
| `slots` | `SlotDefinition[]` |
| `childComponents` | `string[]` |
| `stateManagement` | `StateManagementInfo` |
| `exports` | `ExportInfo` |
| `semanticMetadata` | `SemanticMetadata` |
| `stateMachines` | `StateMachine[]` |

<!-- source: class-coordinationdoc.md -->

# CoordinationDoc

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/coordination-doc.ts` (line 20)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `toMarkdown` | `toMarkdown()` | `string` |
| `getSection` | `getSection(title: string)` | `CoordinationSection | undefined` |
| `getSectionTitles` | `getSectionTitles()` | `string[]` |
| `setSection` | `setSection(title: string, content: string, updatedBy: string)` | `void` |
| `appendToSection` | `appendToSection(title: string, content: string, updatedBy: string)` | `void` |
| `removeSection` | `removeSection(title: string)` | `boolean` |
| `clear` | `clear()` | `void` |
| `isEmpty` | `isEmpty()` | `boolean` |

<!-- source: function-createdefaultorchestrator.md -->

# createDefaultOrchestrator

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/orchestrator/create-default-orchestrator.ts` (line 66)

A ready-to-use orchestrator with all default parsers registered.

## Signature

```ts
function createDefaultOrchestrator(): ParserOrchestrator
```

**Returns:** `ParserOrchestrator`

<!-- source: function-createtesttemplates.md -->

# createTestTemplates

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 181)

## Signature

```ts
function createTestTemplates(count: number): TestTemplateData[]
```

## Parameters

| Name | Type |
|---|---|
| `count` | `number` |

**Returns:** `TestTemplateData[]`

<!-- source: controller-dashboardcontroller.md -->

# DashboardController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/dashboard/dashboard.controller.ts` (line 10)

## Relationships

- MODULE_DECLARES → `getStats`
- MODULE_DECLARES → `getProjectStats`
- MODULE_DECLARES → `getUserActivity`
- DEPENDS_ON → `dashboardservice`

<!-- source: function-deriveautoquestion.md -->

# deriveAutoQuestion

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/copilotUtils.ts` (line 39)

The customer's question = the LAST customer message. The thread description
is the first customer message (ThreadView renders it that way), so the
fallback chain is: last non-internal, non-agent comment → description → title.
Comments with an authorName are agent replies (same rule as the timeline).

## Signature

```ts
function deriveAutoQuestion(thread: Pick<DeskThreadDetail, 'title' | 'description'> & { comments?: DeskComment[] }): string
```

## Parameters

| Name | Type |
|---|---|
| `thread` | `Pick<DeskThreadDetail, 'title' | 'description'> & { comments?: DeskComment[] }` |

**Returns:** `string`

<!-- source: type-detectionconfidence.md -->

# DetectionConfidence

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/framework-detector.ts` (line 26)

Detection confidence level

## Definition

```ts
'high' | 'medium' | 'low'
```

<!-- source: constant-doc-audience-scopes.md -->

# DOC_AUDIENCE_SCOPES

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/project/audience-scope.util.ts` (line 14)

All known scopes, used to aggregate the landing page across doc sets.

## Definition

```ts
readonly DocAudienceScope[]
```

<!-- source: module-docversionmodule.md -->

# DocVersionModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.module.ts` (line 15)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `auditmodule`
- MODULE_DECLARES → `docversioncontroller`
- MODULE_PROVIDES → `docversionservice`
- MODULE_PROVIDES → `versioncarryforwardservice`
- MODULE_PROVIDES → `screenshotstalenessservice`
- MODULE_PROVIDES → `versiondiffservice`
- MODULE_PROVIDES → `changelogservice`
- MODULE_PROVIDES → `docversionexportservice`
- MODULE_PROVIDES → `docversionretentionservice`
- MODULE_PROVIDES → `versionaccessguard`
- MODULE_EXPORTS → `docversionservice`
- MODULE_EXPORTS → `versioncarryforwardservice`
- MODULE_EXPORTS → `screenshotstalenessservice`
- MODULE_EXPORTS → `versiondiffservice`
- MODULE_EXPORTS → `changelogservice`
- MODULE_EXPORTS → `docversionexportservice`
- MODULE_EXPORTS → `docversionretentionservice`
- MODULE_EXPORTS → `versionaccessguard`

<!-- source: component-featuresinteractivetabs.md -->

# FeaturesInteractiveTabs

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/features/features-interactive-tabs.tsx` (line 35)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `tabs` | `Tab[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FeaturesInteractiveTabs_691f6854["FeaturesInteractiveTabs"]
    class component_FeaturesInteractiveTabs_691f6854 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `Icon`
- RENDERS → `motion-span`
- RENDERS → `AnimatePresence`
- USES_HOOK → `useTranslation`
- USES_HOOK → `useState`

<!-- source: function-getdocsbycategory.md -->

# getDocsByCategory

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/web-search/data/competitor-docs-index.ts` (line 363)

Get competitor docs by category

## Signature

```ts
function getDocsByCategory(category: string): CompetitorDoc[]
```

## Parameters

| Name | Type |
|---|---|
| `category` | `string` |

**Returns:** `CompetitorDoc[]`

<!-- source: interface-hookentity.md -->

# HookEntity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 834)

Hook entity (React)

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.HOOK` |
| `returnType` | `string` |
| `parameters` | `ParameterDefinition[]` |
| `dependencies` | `string[]` |
| `isCustom` | `boolean` |

<!-- source: function-isreactfile.md -->

# isReactFile

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 469)

Check if a file is a React/JSX file

## Signature

```ts
function isReactFile(filePath: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |

**Returns:** `boolean`

<!-- source: component-linkeditform.md -->

# LinkEditForm

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/LinkDialog.tsx` (line 45)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `url` | `string` | ✓ | - |
| `title` | `string` | ✓ | - |
| `onSubmit` | `Function` | ✓ | - |
| `onCancel` | `Function` | ✓ | - |
| `linkAutocompleteSuggestions` | `string[]` | ✓ | - |
| `showLinkTitleField` | `boolean` | ✓ | - |
| `showAnchorTextField` | `boolean` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_LinkEditForm_60bd3dbc["LinkEditForm"]
    class component_LinkEditForm_60bd3dbc rootComponent
```

## Relationships

- RENDERS → `DownshiftAutoComplete`
- USES_HOOK → `useForm`
- USES_HOOK → `useTranslation`

## Referenced By

- `LinkDialog` (RENDERS)

<!-- source: interface-manifestsection.md -->

# ManifestSection

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 120)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `category` | `string` |
| `file` | `string` |
| `exportName` | `string` |
| `destinationPath` | `string` |
| `description` | `string` |
| `visual` | `Record<string, unknown>` |
| `tags` | `string[]` |
| `bestFor` | `string[]` |
| `props` | `Record<string, ManifestProp>` |
| `dependencies` | `string[]` |
| `sharedComponents` | `string[]` |
| `sampleTranslationKeys` | `Record<string, string>` |

<!-- source: class-odooxmlparser.md -->

# OdooXmlParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/backend/odoo-xml.parser.ts` (line 37)

Odoo XML View Parser
Extracts UI elements, views, actions, and menus from Odoo XML files

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: api-endpoint-parseproject.md -->

# parseProject

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/orchestrator/orchestrator.controller.ts` (line 58)

Parse an entire project

## Endpoint

`POST /api/orchestrator/projects/parse`

## Referenced By

- `OrchestratorController` (MODULE_DECLARES)

<!-- source: interface-pmecontext.md -->

# PmeContext

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 128)

PME-specific context passed through the agent's RunContext.

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `userId` | `string` |
| `config` | `GenerationConfig` |

<!-- source: type-progresscallback.md -->

# ProgressCallback

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 232)

Progress callback for long-running agent jobs.

## Definition

```ts
(progress: {
  percent: number;
  stage: string;
  message?: string;
}) => void
```

<!-- source: constant-publicapi.md -->

# publicApi

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/lib/public-api.ts` (line 31)

<!-- source: function-registervalidatecoveragecommand.md -->

# registerValidateCoverageCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/validate-coverage.command.ts` (line 221)

Register command with Commander

## Signature

```ts
function registerValidateCoverageCommand(program: any): void
```

## Parameters

| Name | Type |
|---|---|
| `program` | `any` |

**Returns:** `void`

<!-- source: class-renderpdfdto.md -->

# RenderPdfDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/pdf/pdf.controller.ts` (line 5)

## Properties

| Property | Type |
|---|---|
| `html` | `string` |
| `options` | `RenderPdfOptions` |

<!-- source: service-screenshotreplacerservice.md -->

# ScreenshotReplacerService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-replacer.service.ts` (line 1)

<!-- source: type-socialprooflayout.md -->

# SocialProofLayout

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 17)

## Definition

```ts
'stats-grid' | 'testimonial-cards'
```

<!-- source: type-sortoption.md -->

# SortOption

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/components/Documents/SortControl.tsx` (line 6)

## Definition

```ts
| 'order-asc'
  | 'title-asc'
  | 'title-desc'
  | 'updated-desc'
  | 'updated-asc'
  | 'created-desc'
  | 'created-asc'
```

<!-- source: interface-takescreenshotrequest.md -->

# TakeScreenshotRequest

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.service.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `capturedBy` | `string` |
| `viewport` | `{ width: number; height: number }` |
| `fullPage` | `boolean` |
| `waitForSelector` | `string` |
| `stateType` | `'default' | 'hover' | 'modal' | 'error' | 'success' | 'loading'` |
| `flowStepId` | `string` |
| `browser` | `'chromium' | 'firefox' | 'webkit'` |

<!-- source: function-useauth.md -->

# useAuth

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/frontend/src/hooks/useAuth.ts` (line 16)

<!-- source: constant-allowsetimagedimensions.md -->

# allowSetImageDimensions$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 347)

Allow to set width and height of image through dialog window

<!-- source: interface-analysisresult.md -->

# AnalysisResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/interfaces/ai-provider.interface.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `text` | `string` |
| `suggestions` | `string[]` |
| `metadata` | `Record<string, any>` |
| `usage` | `TokenUsage` |

<!-- source: interface-apiclient.md -->

# APIClient

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/types.ts` (line 9)

Shared types for

<!-- source: component-assigneerow.md -->

# AssigneeRow

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 501)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `id` | `string` | ✓ | - |
| `name` | `string` | ✓ | - |
| `active` | `boolean` | ✓ | - |
| `onClick` | `Function` | ✓ | - |
| `muted` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_AssigneeRow_4ab4fea0["AssigneeRow"]
    class component_AssigneeRow_4ab4fea0 rootComponent
```

## Relationships

- RENDERS → `CheckIcon`

## Referenced By

- `FilterPopover` (RENDERS)

<!-- source: class-audiencerenderer.md -->

# AudienceRenderer

**Kind:** Class

**Source:** `atloria-monorepo/packages/core/src/rendering/audience-renderer.ts` (line 64)

Audience Renderer

Evaluates audience logic and filters content based on viewer permissions.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `render` | `render(ast: DocumentAST)` | `string` |

<!-- source: interface-bashsessionoptions.md -->

# BashSessionOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/bash-session.ts` (line 6)

Options for creating a persistent bash session.

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `shell` | `string` |
| `env` | `Record<string, string>` |
| `defaultTimeout` | `number` |

<!-- source: service-brandingservice.md -->

# BrandingService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/branding/branding.service.ts` (line 36)

Project branding — identity + colors + support email. One row per project.
Everything is nullable; the frontend falls back to project name + Atloria
palette when a field is blank.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `get` | `get(projectId: string, user: JwtPayload)` | `unknown` |
| `update` | `update(projectId: string, dto: UpdateBrandingDto, user: JwtPayload)` | `unknown` |
| `getPublic` | `getPublic(projectId: string)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: function-buildvisualsystemprompt.md -->

# buildVisualSystemPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/visual.prompts.ts` (line 9)

## Signature

```ts
function buildVisualSystemPrompt(config: GenerationConfig): string
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |

**Returns:** `string`

<!-- source: api-endpoint-bulkupdate.md -->

# bulkUpdate

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/issues.controller.ts` (line 75)

## Endpoint

`PATCH /projects/:projectId/issues/bulk`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `IssuesController` (MODULE_DECLARES)

<!-- source: function-call.md -->

# call

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/fp.ts` (line 54)

Calls the passed function.

## Signature

```ts
function call(proc: () => unknown)
```

## Parameters

| Name | Type |
|---|---|
| `proc` | `() => unknown` |

<!-- source: class-chatescalatedto.md -->

# ChatEscalateDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/chat-escalate.dto.ts` (line 13)

Body for the PUBLIC chat → human escalation endpoint
(`POST /public/p/:slugWithId/chat/escalate`).

All fields are optional: the widget is anonymous and we never want to block a
"Talk to a human" click on missing data. Email is validated only when present.
`transcript` arrives as newline-joined "role: content" lines from the widget;
the controller parses it back into structured turns before handing off to
IssuesService.createFromChatEscalation.

## Properties

| Property | Type |
|---|---|
| `email` | `string` |
| `note` | `string` |
| `question` | `string` |
| `transcript` | `string` |
| `sessionId` | `string` |

<!-- source: function-clamptimeout.md -->

# clampTimeout

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/agent-hardening.ts` (line 33)

Agent Hardening — Defensive Patterns for Benchmark Execution

Utilities adopted from SWE-agent and Claude Code:
- Bash timeout clamping utility (prevents single commands from hogging budget)
- Pager-disabling environment (PAGER=cat, etc.)
- Cost limit per task ($3-5 budget)
- Autosubmission on error (partial patch > no patch)
- Zero-progress detection (3 consecutive zero-token turns)

Note: Task-level timeout is 1800s (30 min, matching SWE-agent).
Setup time is excluded — timer starts AFTER setupTask() completes.
Per-command bash timeout is 120s (benchmark) / 60s (interactive).

These are pure utility functions — no side effects, easy to test.

## Signature

```ts
function clampTimeout(requested: number | undefined, ceiling: number, defaultMs: number): number
```

## Parameters

| Name | Type |
|---|---|
| `requested` | `number | undefined` |
| `ceiling` | `number` |
| `defaultMs` | `number` |

**Returns:** `number`

<!-- source: interface-componenthierarchydiagramoptions.md -->

# ComponentHierarchyDiagramOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/component-hierarchy-diagram.generator.ts` (line 17)

Options for component hierarchy diagram generation

## Properties

| Property | Type |
|---|---|
| `showProps` | `boolean` |
| `showStateMachines` | `boolean` |
| `showComponentTypes` | `boolean` |
| `maxDepth` | `number` |
| `direction` | `'TD' | 'TB' | 'LR' | 'RL' | 'BT'` |
| `includeTheme` | `boolean` |
| `nodeShape` | `'rectangle' | 'rounded' | 'stadium' | 'circle' | 'hexagon'` |
| `highlightRoot` | `boolean` |

<!-- source: interface-configeditorprops.md -->

# ConfigEditorProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/DocAutomation/ConfigEditor.tsx` (line 21)

## Properties

| Property | Type |
|---|---|
| `config` | `DocumentationConfig | null` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `onSave` | `(data: CreateConfigDto | UpdateConfigDto) => Promise<void>` |
| `onCancel` | `() => void` |

<!-- source: function-createprojectfordir.md -->

# createProjectForDir

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/schema-resolver.ts` (line 247)

Build a ts-morph Project for a repo dir. Uses the nearest tsconfig for compiler options
(type resolution fidelity) but ALWAYS adds source files by glob — solution-style tsconfigs
(`include: []` + project references, as Nx apps use) would otherwise load zero files.

## Signature

```ts
function createProjectForDir(rootDir: string): Project
```

## Parameters

| Name | Type |
|---|---|
| `rootDir` | `string` |

**Returns:** `Project`

<!-- source: function-createtestuser.md -->

# createTestUser

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 32)

## Signature

```ts
function createTestUser(overrides: Partial<TestUserData>): TestUserData
```

## Parameters

| Name | Type |
|---|---|
| `overrides` | `Partial<TestUserData>` |

**Returns:** `TestUserData`

<!-- source: class-cronscheduler.md -->

# CronScheduler

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/tools/cron.tool.ts` (line 39)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `parseInterval` | `parseInterval(schedule: string)` | `number | null` |
| `create` | `create(schedule: string, message: string)` | `CronJob | null` |
| `delete` | `delete(id: string)` | `boolean` |
| `list` | `list()` | `Array<{ id: string; schedule: string; message: string; next_fire_at: number }>` |
| `dispose` | `dispose()` | `void` |

<!-- source: function-derivecaption.md -->

# deriveCaption

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/captionRules.ts` (line 22)

Decide whether an image's alt text is a meaningful <figcaption>.
Returns the trimmed caption, or null when it should be suppressed because it
is empty, a generic placeholder word, a bare filename, or a duplicate of the
page heading (the page already renders that title as the H1).

## Signature

```ts
function deriveCaption(alt: string, documentTitle: string): string | null
```

## Parameters

| Name | Type |
|---|---|
| `alt` | `string` |
| `documentTitle` | `string` |

**Returns:** `string | null`

<!-- source: controller-deskcontroller.md -->

# DeskController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/issues/desk.controller.ts` (line 28)

Support desk: Plain-style queue over the existing ticket store. Authed +
org-scoped (service-level organizationId check, like manuals-insights).

## Relationships

- MODULE_DECLARES → `listThreads`
- MODULE_DECLARES → `counts`
- MODULE_DECLARES → `getThread`
- MODULE_DECLARES → `transition`
- MODULE_DECLARES → `reply`
- MODULE_DECLARES → `duplicate`
- DEPENDS_ON → `deskservice`

<!-- source: type-detectionconfigname.md -->

# DetectionConfigName

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/index.ts` (line 67)

## Definition

```ts
keyof typeof DETECTION_CONFIGS_BY_NAME
```

<!-- source: module-draftdocumentmodule.md -->

# DraftDocumentModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/document/draft-document.module.ts` (line 12)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_PROVIDES → `draftdocumentservice`
- MODULE_EXPORTS → `draftdocumentservice`

<!-- source: constant-enrich-credit-cost.md -->

# ENRICH_CREDIT_COST

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/billing/billing.constants.ts` (line 21)

<!-- source: function-gethighprioritydocs.md -->

# getHighPriorityDocs

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/web-search/data/competitor-docs-index.ts` (line 379)

Get high priority docs

## Signature

```ts
function getHighPriorityDocs(): CompetitorDoc[]
```

**Returns:** `CompetitorDoc[]`

<!-- source: component-herobentogrid.md -->

# HeroBentoGrid

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/hero/hero-bento-grid.tsx` (line 27)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `subheadlineKey` | `string` | ✓ | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `badgeKey` | `string` | - | - |
| `gridItems` | `unknown[]` | - | - |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_HeroBentoGrid_53787f49["HeroBentoGrid"]
    class component_HeroBentoGrid_53787f49 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: interface-hookusage.md -->

# HookUsage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 363)

Hook usage in a component

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `'built-in' | 'custom'` |
| `location` | `string` |
| `dependencies` | `string[]` |

<!-- source: function-istypescriptfile.md -->

# isTypeScriptFile

**Kind:** Function

**Source:** `atloria-monorepo/apps/frontend-parser/src/utils/ast-helpers.ts` (line 476)

Check if a file is a TypeScript file

## Signature

```ts
function isTypeScriptFile(filePath: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |

**Returns:** `boolean`

<!-- source: interface-milestone.md -->

# Milestone

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/social-proof/social-proof-timeline.tsx` (line 11)

## Properties

| Property | Type |
|---|---|
| `dateKey` | `string` |
| `titleKey` | `string` |
| `descriptionKey` | `string` |

<!-- source: component-milestonecard-2.md -->

# MilestoneCard

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/social-proof/social-proof-timeline.tsx` (line 50)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `milestone` | `Milestone` | ✓ | - |
| `t` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_MilestoneCard_3fd5ea70["MilestoneCard"]
    class component_MilestoneCard_3fd5ea70 rootComponent
```

## Relationships

- RENDERS → `DateBadge`

## Referenced By

- `SocialProofTimeline` (RENDERS)

<!-- source: class-openapiparser-2.md -->

# OpenAPIParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/api-schema/openapi.parser.ts` (line 37)

OpenAPI Parser Implementation (Parser-Core Version)

Supports:
- OpenAPI 3.0.x and 3.1.x
- Swagger 2.0
- JSON and YAML formats

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: interface-pmefailedevent.md -->

# PmeFailedEvent

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 221)

WebSocket failure event payload.

## Properties

| Property | Type |
|---|---|
| `jobId` | `string` |
| `error` | `string` |
| `stage` | `string` |

<!-- source: type-qualitygateprovider.md -->

# QualityGateProvider

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/autonomous-loop.ts` (line 54)

Optional callback that lets the domain layer update gate status.
Called by the TurnHook before each model call.

## Definition

```ts
() => QualityGate[] | Promise<QualityGate[]>
```

<!-- source: constant-relationship-type-colors.md -->

# RELATIONSHIP_TYPE_COLORS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/components/Graph/types.ts` (line 109)

Relationship colors by type

## Definition

```ts
Record<string, string>
```

<!-- source: api-endpoint-remove.md -->

# remove

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/src/users/users.controller.ts` (line 67)

## Endpoint

`DELETE /users/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `UsersController` (MODULE_DECLARES)

<!-- source: function-retrywithaisuggestions.md -->

# retryWithAISuggestions

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/utils/ai-auth-debugger.ts` (line 238)

Apply AI-suggested fixes and retry authentication

## Signature

```ts
async function retryWithAISuggestions(_page: any, _config: AuthConfig, suggestions: any[]): Promise<boolean>
```

## Parameters

| Name | Type |
|---|---|
| `_page` | `any` |
| `_config` | `AuthConfig` |
| `suggestions` | `any[]` |

**Returns:** `Promise<boolean>`

<!-- source: class-screenshotactiondto.md -->

# ScreenshotActionDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 57)

Screenshot action DTO for pre-capture interactions

Supports various action types:
- click/dblclick: Click on element (requires selector)
- type/fill: Input text (requires selector and value)
- press: Press keyboard key (requires key)
- wait: Wait for duration or selector
- scroll: Scroll to element or bottom
- hover/focus/blur: Element interactions (require selector)
- select: Select dropdown option (requires selector and value)
- navigate: Navigate to URL (requires value)
- frame: Enter/exit iframe (requires selector and frameAction)

## Properties

| Property | Type |
|---|---|
| `type` | `ActionType` |
| `selector` | `string` |
| `selectorHint` | `string` |
| `value` | `string` |
| `duration` | `number` |
| `key` | `string` |
| `frameAction` | `FrameAction` |
| `optional` | `boolean` |
| `description` | `string` |
| `waitAfter` | `number` |

<!-- source: service-screenshotuploaderservice.md -->

# ScreenshotUploaderService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-uploader.service.ts` (line 1)

<!-- source: type-sourcebadge.md -->

# SourceBadge

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/copilotUtils.ts` (line 58)

## Definition

```ts
'DOC' | 'SRC'
```

<!-- source: type-storeassetfn.md -->

# StoreAssetFn

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/tools/store-asset.tool.ts` (line 14)

Storage function signature — matches AzureBlobService.upload() shape.

## Definition

```ts
(
  content: string | Buffer,
  path: string,
  contentType: string
) => Promise<{ url: string }>
```

<!-- source: interface-takesmartauthenticatedscreenshotrequest.md -->

# TakeSmartAuthenticatedScreenshotRequest

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.service.ts` (line 47)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `capturedBy` | `string` |
| `auth` | `SmartAuthConfig` |
| `viewport` | `{ width: number; height: number }` |
| `fullPage` | `boolean` |
| `waitForSelector` | `string` |
| `browser` | `'chromium' | 'firefox' | 'webkit'` |

<!-- source: function-validateentity.md -->

# validateEntity

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 223)

Validate entity structure

## Signature

```ts
function validateEntity(entity: Entity): boolean
```

## Parameters

| Name | Type |
|---|---|
| `entity` | `Entity` |

**Returns:** `boolean`

<!-- source: interface-analysistype.md -->

# AnalysisType

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/interfaces/ai-provider.interface.ts` (line 20)

## Properties

| Property | Type |
|---|---|
| `type` | `'enhance' | 'summarize' | 'outline' | 'improve' | 'code-analysis' | 'screenshot-caption'` |
| `context` | `Record<string, any>` |

<!-- source: constant-angular-component-patterns.md -->

# ANGULAR_COMPONENT_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/angular.patterns.ts` (line 12)

Angular Pattern Detection

Patterns for detecting Angular components, services, templates, and RxJS usage.
Critical for enterprise applications using Angular + DevExtreme.

<!-- source: interface-apiclient-2.md -->

# APIClient

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/types/api-client.ts` (line 95)

API Client interface for making backend requests
This follows the Repository pattern to abstract data access

## Properties

| Property | Type |
|---|---|
| `audiences` | `{
    list(): Promise<AudienceModel[]>;
    get(id: string): Promise<AudienceModel>;
    create(data: {
      name: string;
      slug: string;
      color: string;
      icon: string;
      description?: string;
    }): Promise<AudienceModel>;
    update(
      id: string,
      data: {
        name?: string;
        slug?: string;
        color?: string;
        icon?: string;
        description?: string;
      },
    ): Promise<AudienceModel>;
    delete(id: string): Promise<void>;
  }` |
| `documents` | `{
    get(id: string): Promise<Document>;
    list(params?: { projectId?: string }): Promise<DocumentListResponse>;
    create(data: Partial<Document>): Promise<Document>;
    update(id: string, data: Partial<Document>): Promise<Document>;
    delete(id: string): Promise<void>;
    publish(id: string, isPublic?: boolean): Promise<Document>;
    unpublish(id: string): Promise<Document>;
    getRevisions(id: string, limit?: number, offset?: number): Promise<DocumentRevision[]>;
    getRevision(id: string, revisionId: string): Promise<DocumentRevision>;
    restoreRevision(id: string, revisionId: string): Promise<Document>;
    compareDocuments(
      id: string,
      from: string,
      to: string,
      type?: 'version' | 'revision',
    ): Promise<DocumentCompareResult>;
  }` |
| `projects` | `{
    get(id: string): Promise<Project>;
    list(params?: { organizationId?: string }): Promise<Project[]>;
    create(data: Partial<Project>): Promise<Project>;
    update(id: string, data: Partial<Project>): Promise<Project>;
    delete(id: string): Promise<void>;
    publish(id: string): Promise<{
      id: string;
      name: string;
      slug: string;
      urlId: string;
      publishedSlug: string;
      publicUrl: string;
      publishedAt: string;
      isPublic: boolean;
    }>;
    unpublish(id: string): Promise<Project>;
  }` |
| `comments` | `{
    list(documentId: string, params?: any): Promise<CommentWithUser[]>;
    get(documentId: string, commentId: string): Promise<CommentWithUser>;
    create(documentId: string, dto: CreateCommentDto): Promise<CommentWithUser>;
    update(
      documentId: string,
      commentId: string,
      dto: UpdateCommentDto,
    ): Promise<CommentWithUser>;
    delete(documentId: string, commentId: string): Promise<void>;
    resolve(documentId: string, commentId: string): Promise<CommentWithUser>;
    unresolve(documentId: string, commentId: string): Promise<CommentWithUser>;
    reply(
      documentId: string,
      parentCommentId: string,
      dto: Omit<CreateCommentDto, 'parentCommentId'>,
    ): Promise<CommentWithUser>;
    getReplies(parentCommentId: string): Promise<CommentWithUser[]>;
  }` |
| `suggestions` | `{
    list(documentId: string, params?: any): Promise<SuggestionWithUser[]>;
    get(suggestionId: string): Promise<SuggestionWithUser>;
    create(documentId: string, dto: CreateSuggestionDto): Promise<SuggestionWithUser>;
    update(suggestionId: string, dto: UpdateSuggestionDto): Promise<SuggestionWithUser>;
    delete(suggestionId: string): Promise<void>;
    accept(suggestionId: string, reviewComment?: string): Promise<SuggestionWithUser>;
    reject(suggestionId: string, reviewComment?: string): Promise<SuggestionWithUser>;
  }` |
| `auth` | `{
    login(email: string, password: string): Promise<{ user: User; token: string }>;
    logout(): Promise<void>;
    getCurrentUser(): Promise<User | null>;
    register(data: {
      email: string;
      password: string;
      name: string;
    }): Promise<{ user: User; token: string }>;
  }` |
| `parser` | `{
    parse(code: string, language: string, filename?: string): Promise<ParseResult>;
    parseDocument(documentId: string): Promise<ParseResult>;
    getSupportedLanguages(): Promise<SupportedLanguagesResponse>;
  }` |
| `templates` | `{
    list(filters?: TemplateFiltersDto): Promise<DocumentTemplate[]>;
    get(id: string): Promise<DocumentTemplate>;
    create(dto: CreateTemplateDto): Promise<DocumentTemplate>;
    update(id: string, dto: Partial<CreateTemplateDto>): Promise<DocumentTemplate>;
    delete(id: string): Promise<void>;
    useTemplate(id: string, dto: CreateFromTemplateDto): Promise<Document>;
    saveAsTemplate(documentId: string, dto: SaveAsTemplateDto): Promise<DocumentTemplate>;
  }` |
| `branding` | `{
    get(projectId: string): Promise<any>;
    update(projectId: string, dto: any): Promise<any>;
  }` |
| `issues` | `{
    list(projectId: string, params?: Record<string, any>): Promise<any>;
    getStats(projectId: string): Promise<any>;
    get(projectId: string, issueId: string): Promise<any>;
    update(projectId: string, issueId: string, dto: any): Promise<any>;
    bulkUpdate(projectId: string, dto: any): Promise<any>;
    addComment(projectId: string, issueId: string, dto: any): Promise<any>;
    getDuplicates(projectId: string, issueId: string): Promise<any>;
    getBoardsForIssue(projectId: string, issueId: string): Promise<any>;
  }` |
| `boards` | `{
    list(projectId: string): Promise<any>;
    create(projectId: string, dto: any): Promise<any>;
    get(projectId: string, boardId: string, includeCards?: boolean): Promise<any>;
    update(projectId: string, boardId: string, dto: any): Promise<any>;
    deleteBoard(projectId: string, boardId: string): Promise<any>;
    restore(projectId: string, boardId: string): Promise<any>;
    addColumn(projectId: string, boardId: string, dto: any): Promise<any>;
    updateColumn(projectId: string, boardId: string, columnId: string, dto: any): Promise<any>;
    reorderColumns(projectId: string, boardId: string, columnIds: string[]): Promise<any>;
    deleteColumn(projectId: string, boardId: string, columnId: string, moveCardsTo?: string): Promise<any>;
    listCards(projectId: string, boardId: string, since?: string): Promise<any>;
    addCards(projectId: string, boardId: string, dto: { issueIds: string[]; columnId?: string }): Promise<any>;
    moveCard(projectId: string, boardId: string, cardId: string, dto: { columnId: string; position: number }): Promise<any>;
    removeCard(projectId: string, boardId: string, cardId: string): Promise<any>;
  }` |
| `analytics` | `{
    getOverview(projectId: string, days: number): Promise<any>;
    getDailyTraffic(projectId: string, days: number): Promise<any>;
    getTopDocuments(projectId: string, days: number): Promise<any>;
    getTopSearchQueries(projectId: string, days: number): Promise<any>;
    getVersionTraffic(projectId: string, days: number): Promise<any>;
    getDeviceBreakdown(projectId: string, days: number): Promise<any>;
    getSourceBreakdown(projectId: string, days: number): Promise<any>;
    getGeoBreakdown(projectId: string, days: number): Promise<any>;
    getZeroResultSearches(projectId: string, days: number): Promise<any>;
    getGhostDocs(projectId: string, days: number): Promise<any>;
    getTrendingDocs(projectId: string, days: number): Promise<any>;
    getScrollHistogram(projectId: string, days: number): Promise<any>;
    getFeedbackSummary(projectId: string, days: number): Promise<any>;
    submitFeedback(data: any): Promise<any>;
    exportNow(projectId: string, data: any): Promise<any>;
    listScheduledReports(projectId: string): Promise<any>;
    createScheduledReport(projectId: string, data: any): Promise<any>;
    updateScheduledReport(projectId: string, id: string, data: any): Promise<any>;
    deleteScheduledReport(projectId: string, id: string): Promise<any>;
    runScheduledReport(projectId: string, id: string): Promise<any>;
    listExportHistory(projectId: string): Promise<any>;
  }` |

<!-- source: component-atloriaproviderwrapper.md -->

# AtloriaProviderWrapper

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Providers.tsx` (line 20)

Inner provider that uses the session. The token is exposed through a REF, not a closure over the session snapshot: on a hard navigation NextAuth resolves the session asynchronously, and a fetch started before that resolution must see the token the moment it arrives. The old closure captured `null` forever, so every full page load of data-fetching pages 401'd after the retry budget (the "No technical snapshot yet" bug on generated projects).

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AtloriaProviderWrapper_5a8540c4["AtloriaProviderWrapper"]
    class component_AtloriaProviderWrapper_5a8540c4 rootComponent
```

## Relationships

- RENDERS → `AtloriaProvider`
- USES_HOOK → `useSession`
- USES_HOOK → `useRef`
- USES_HOOK → `useMemo`

## Referenced By

- `Providers` (RENDERS)

<!-- source: class-authendpoints.md -->

# AuthEndpoints

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/auth.ts` (line 35)

Auth endpoints

## Methods

| Method | Signature | Returns |
|---|---|---|
| `login` | `login(email: string, password: string)` | `Promise<AuthResponse>` |
| `register` | `register(dto: RegisterDto)` | `Promise<AuthResponse>` |
| `refresh` | `refresh()` | `Promise<AuthResponse>` |
| `logout` | `logout()` | `Promise<void>` |
| `verify` | `verify()` | `Promise<{ valid: boolean }>` |

<!-- source: interface-bashtooloptions.md -->

# BashToolOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/bash.tool.ts` (line 20)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `timeout` | `number` |
| `maxOutputSize` | `number` |
| `allowedCommands` | `string[]` |
| `blockedPatterns` | `RegExp[]` |
| `env` | `Record<string, string>` |
| `sandbox` | `boolean` |
| `session` | `BashSession` |
| `envTracker` | `EnvTracker` |

<!-- source: function-buildvisualtaskprompt.md -->

# buildVisualTaskPrompt

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/visual.prompts.ts` (line 44)

## Signature

```ts
function buildVisualTaskPrompt(sectionType: SectionType, contentSummary: string): string
```

## Parameters

| Name | Type |
|---|---|
| `sectionType` | `SectionType` |
| `contentSummary` | `string` |

**Returns:** `string`

<!-- source: api-endpoint-bulkupdatevisibility.md -->

# bulkUpdateVisibility

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 830)

## Endpoint

`POST /documents/bulk/visibility`

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: service-businesscontextparserservice.md -->

# BusinessContextParserService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/ai/services/business-context-parser.service.ts` (line 41)

Business Context Parser Service

Extracts text from PDF, Markdown, and Word files, then uses AI to summarize
and structure the content into actionable business context for documentation.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `parseContextFiles` | `parseContextFiles(filePaths: string[])` | `Promise<BusinessContext>` |
| `parseRawText` | `parseRawText(rawText: string)` | `Promise<BusinessContext>` |
| `formatContextForPrompt` | `formatContextForPrompt(context: BusinessContext)` | `string` |

## Relationships

- DEPENDS_ON → `azureclaudeprovider`

<!-- source: class-chatfeedbackdto.md -->

# ChatFeedbackDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/chat-feedback.dto.ts` (line 12)

Body for the PUBLIC chat feedback endpoint
(`POST /public/p/:slugWithId/chat/feedback`).

Anonymous 👍/👎 signal emitted from the support widget under a completed
assistant answer. Persisted as a `chat_feedback` InteractionEvent on the
shared analytics spine — no ChatInteraction row is created (the public
stream doesn't mint one; the event IS the record).

## Properties

| Property | Type |
|---|---|
| `rating` | `'up' | 'down'` |
| `sessionId` | `string` |
| `question` | `string` |
| `comment` | `string` |

<!-- source: function-classifybashcommand.md -->

# classifyBashCommand

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/session/permission-gate.ts` (line 152)

Classify a bash command into a reversibility tier.
Uses pattern matching — prefers specificity (T3 checked first).

## Signature

```ts
function classifyBashCommand(command: string): ReversibilityResult
```

## Parameters

| Name | Type |
|---|---|
| `command` | `string` |

**Returns:** `ReversibilityResult`

<!-- source: function-classifydoctype.md -->

# classifyDocType

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/doc-type-classifier.ts` (line 184)

Classify a DocumentPlan into a doc type using score-based heuristics.

## Signature

```ts
function classifyDocType(plan: DocumentPlan, categoryName: string): DocTypeClassification
```

## Parameters

| Name | Type |
|---|---|
| `plan` | `DocumentPlan` |
| `categoryName` | `string` |

**Returns:** `DocTypeClassification`

<!-- source: interface-componenttemplate.md -->

# ComponentTemplate

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 101)

## Properties

| Property | Type |
|---|---|
| `component` | `string` |
| `templatePath` | `string` |
| `conditionalRenders` | `ConditionalRender[]` |
| `actions` | `ComponentAction[]` |

<!-- source: interface-copilotaskresult.md -->

# CopilotAskResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/copilotUtils.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `answer` | `string` |
| `citations` | `string[]` |
| `sources` | `CopilotAskSource[]` |

<!-- source: function-createprojectforfiles.md -->

# createProjectForFiles

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/schema-resolver.ts` (line 279)

Build a ts-morph Project scoped to specific files + their import graph (the DTOs those files
reference), NOT the whole repo. This is the memory-bounded path for OpenAPI resolution: the
framework parse already loaded the repo once, so globbing the entire tree here would load a
SECOND full project (a memory doubler that OOMs large monorepos). Loading only the controller
files and resolving their dependencies keeps the second project to the API surface.

## Signature

```ts
function createProjectForFiles(rootDir: string, filePaths: string[]): Project
```

## Parameters

| Name | Type |
|---|---|
| `rootDir` | `string` |
| `filePaths` | `string[]` |

**Returns:** `Project`

<!-- source: function-createtestusers.md -->

# createTestUsers

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 44)

## Signature

```ts
function createTestUsers(count: number): TestUserData[]
```

## Parameters

| Name | Type |
|---|---|
| `count` | `number` |

**Returns:** `TestUserData[]`

<!-- source: function-derivefilteroptions.md -->

# deriveFilterOptions

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 104)

Derive the lists of options to show (only what's actually present on the board)

## Signature

```ts
function deriveFilterOptions(board: BoardData | null)
```

## Parameters

| Name | Type |
|---|---|
| `board` | `BoardData | null` |

<!-- source: type-detectorname.md -->

# DetectorName

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/index.ts` (line 84)

## Definition

```ts
keyof typeof ALL_DETECTORS
```

<!-- source: class-diskbackend.md -->

# DiskBackend

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/checkpoint-backend.ts` (line 188)

**Implements:** `CheckpointBackend`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `save` | `save(snap: Snapshot)` | `void` |
| `load` | `load(relPath: string)` | `Snapshot[]` |
| `loadLatest` | `loadLatest(relPath: string)` | `Snapshot | null` |
| `deleteFile` | `deleteFile(relPath: string)` | `void` |
| `deleteFrom` | `deleteFrom(relPath: string, fromIndex: number)` | `void` |
| `getTrackedFiles` | `getTrackedFiles()` | `string[]` |
| `getTotalCount` | `getTotalCount()` | `number` |
| `getSnapshotCount` | `getSnapshotCount(relPath: string)` | `number` |
| `clear` | `clear()` | `void` |
| `evictOldest` | `evictOldest()` | `boolean` |
| `flush` | `flush()` | `void` |

## Properties

| Property | Type |
|---|---|
| `sessionId` | `string` |
| `sessionDir` | `string` |

<!-- source: controller-docautomationcontroller.md -->

# DocAutomationController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 36)

## Relationships

- MODULE_DECLARES → `createConfig`
- MODULE_DECLARES → `getConfig`
- MODULE_DECLARES → `updateConfig`
- MODULE_DECLARES → `deleteConfig`
- MODULE_DECLARES → `startJob`
- MODULE_DECLARES → `listJobs`
- MODULE_DECLARES → `getJob`
- MODULE_DECLARES → `cancelJob`
- MODULE_DECLARES → `reportExternalProgress`
- MODULE_DECLARES → `runUploadOnExistingJob`
- MODULE_DECLARES → `deleteJobDocuments`
- MODULE_DECLARES → `triggerScreenshots`
- MODULE_DECLARES → `getTriggerConfig`
- MODULE_DECLARES → `updateTriggerConfig`
- MODULE_DECLARES → `generateWebhookSecret`
- MODULE_DECLARES → `getDeliveries`
- MODULE_DECLARES → `getWebhookUrl`
- DEPENDS_ON → `docautomationservice`

<!-- source: module-emailmodule.md -->

# EmailModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/email/email.module.ts` (line 5)

## Relationships

- MODULE_PROVIDES → `emailservice`
- MODULE_EXPORTS → `emailservice`

<!-- source: constant-event-types.md -->

# EVENT_TYPES

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/events/events.service.ts` (line 9)

Foundation F2: ONE append-only interaction-event stream. Chat feedback, escalations,
answered/refused signals, page feedback and search misses all land here — the deflection
dashboard, admin cockpit and "thin page" insights are just queries over this table.

<!-- source: component-heroclassicsplit.md -->

# HeroClassicSplit

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/hero/hero-classic-split.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `subheadlineKey` | `string` | ✓ | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `badgeKey` | `string` | - | - |
| `badgeIcon` | `LucideIcon` | - | - |
| `imageSrc` | `string` | ✓ | - |
| `imageAlt` | `string` | ✓ | - |
| `trustItems` | `unknown[]` | - | - |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_HeroClassicSplit_346e4f89["HeroClassicSplit"]
    class component_HeroClassicSplit_346e4f89 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-span`
- RENDERS → `BadgeIcon`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- RENDERS → `motion-ul`
- RENDERS → `Check`
- USES_HOOK → `useTranslation`

<!-- source: function-hourbucketstart.md -->

# hourBucketStart

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/analytics/utils/tracking-utils.ts` (line 112)

Compute the start of the hour bucket containing `date`. Used by the
session-dedup logic in the analytics service so that multiple page-view
beacons from the same session+slug within the same hour collapse into
a single row instead of stacking up.

## Signature

```ts
function hourBucketStart(date: Date): Date
```

## Parameters

| Name | Type |
|---|---|
| `date` | `Date` |

**Returns:** `Date`

<!-- source: interface-impactanalysis.md -->

# ImpactAnalysis

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/relationship.interface.ts` (line 439)

Impact analysis result

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `directDependencies` | `string[]` |
| `directDependents` | `string[]` |
| `allDependencies` | `string[]` |
| `allDependents` | `string[]` |
| `impactScore` | `number` |
| `recommendations` | `string[]` |

<!-- source: interface-navconfig.md -->

# NavConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 55)

## Properties

| Property | Type |
|---|---|
| `links` | `Array<{ labelKey: string; href: string }>` |
| `ctaKey` | `string` |
| `ctaHref` | `string` |

<!-- source: class-openapischemaresolver.md -->

# OpenApiSchemaResolver

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/schema-resolver.ts` (line 35)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `fromTsConfig` | `fromTsConfig(tsConfigFilePath: string)` | `OpenApiSchemaResolver` |
| `getComponents` | `getComponents()` | `Record<string, Record<string, unknown>>` |
| `resolveMethod` | `resolveMethod(method: MethodDeclaration, opts: { httpMethod?: string })` | `ResolvedOperation` |

<!-- source: interface-pmehandofffilterconfig.md -->

# PmeHandoffFilterConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/context/pme-handoff-filter.ts` (line 15)

PME Handoff Input Filter

Filters context passed to sub-agents during handoffs.
Sub-agents (copywriter, layout, visual, qa) don't need the full
coordinator conversation history — they only need:
- The original user request (inputHistory)
- Recent context (last N items from pre-handoff)
- The handoff trigger (newItems)

This reduces sub-agent context by 60-80%, improving response quality
and reducing token costs.

## Properties

| Property | Type |
|---|---|
| `maxPreHandoffItems` | `number` |

<!-- source: constant-revalidate.md -->

# revalidate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/app/api/stats/route.ts` (line 3)

<!-- source: type-reversibilitytier.md -->

# ReversibilityTier

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/session/permission-gate.ts` (line 17)

Permission Gate — Bash Command Reversibility Classification

Classifies bash commands into reversibility tiers before execution.
Inspired by Claude Code's blast-radius awareness.

Tiers:
 T0 — Read-only: cat, ls, grep, git log — zero side effects
 T1 — Reversible: mkdir, npm install, git add — easy to undo
 T2 — Hard-to-reverse: git push, npm publish — requires effort to undo
 T3 — Irreversible: rm -rf, DROP TABLE, DELETE without WHERE — blocked

Consumers:
 - bash.tool.ts: annotates outputs with tier, hard-blocks T3

## Definition

```ts
'T0' | 'T1' | 'T2' | 'T3'
```

<!-- source: component-roweditor.md -->

# RowEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/table/TableEditor.tsx` (line 598)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `parentEditor` | `any` | ✓ | - |
| `highlightedCoordinates` | `any` | ✓ | - |
| `lexicalTable` | `any` | ✓ | - |
| `rowIndex` | `any` | ✓ | - |
| `setActiveCellWithBoundaries` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_RowEditor_6a961e3["RowEditor"]
    class component_RowEditor_6a961e3 rootComponent
```

## Relationships

- RENDERS → `RadixPopover-Root`
- RENDERS → `RadixPopover-PopoverTrigger`
- RENDERS → `RadixPopover-Portal`
- RENDERS → `RadixPopover-PopoverContent`
- RENDERS → `RadixToolbar-Root`
- RENDERS → `RadixToolbar-Button`
- RENDERS → `RadixPopover-Arrow`
- USES_HOOK → `useCellValues`
- USES_HOOK → `useCallback`
- USES_HOOK → `useTranslation`

## Referenced By

- `TableEditor` (RENDERS)

<!-- source: function-savedocumentation.md -->

# saveDocumentation

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/utils/screenshot-storage.helper.ts` (line 130)

Save documentation with storage helper

## Signature

```ts
async function saveDocumentation(documentation: {
    title: string;
    slug: string;
    content: string;
    categoryPath: string[];
    type: 'user-docs' | 'tutorial' | 'feature';
    metadata?: Record<string, unknown>;
  }, storage: StorageHelperService, aiModel: string): Promise<{ id: string; url: string }>
```

## Parameters

| Name | Type |
|---|---|
| `documentation` | `{
    title: string;
    slug: string;
    content: string;
    categoryPath: string[];
    type: 'user-docs' | 'tutorial' | 'feature';
    metadata?: Record<string, unknown>;
  }` |
| `storage` | `StorageHelperService` |
| `aiModel` | `string` |

**Returns:** `Promise<{ id: string; url: string }>`

<!-- source: class-screenshotfailuredto.md -->

# ScreenshotFailureDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 721)

Screenshot failure record

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `error` | `string` |
| `retryCount` | `number` |
| `stage` | `string` |
| `failedAt` | `Date` |

<!-- source: service-sessionservice.md -->

# SessionService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-08-sessions/planner.service.ts` (line 1)

<!-- source: interface-taskresult.md -->

# TaskResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/services/batch-screenshot.service.ts` (line 42)

Result of a single screenshot task

## Properties

| Property | Type |
|---|---|
| `success` | `boolean` |
| `url` | `string` |
| `screenshotId` | `string` |
| `specId` | `string` |
| `blobUrl` | `string` |
| `error` | `string` |
| `retryCount` | `number` |
| `isNew` | `boolean` |
| `version` | `number` |
| `featureArea` | `string` |
| `pageType` | `string` |
| `semanticTags` | `string[]` |
| `recoveryAttempts` | `number` |
| `recoverySucceeded` | `boolean` |
| `successfulSelector` | `string` |

<!-- source: type-thememode.md -->

# ThemeMode

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 35)

## Definition

```ts
'dark' | 'light' | 'colorful'
```

<!-- source: type-themename.md -->

# ThemeName

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/theme-presets.ts` (line 58)

## Definition

```ts
keyof typeof THEME_PRESETS
```

<!-- source: api-endpoint-update.md -->

# update

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/src/users/users.controller.ts` (line 57)

## Endpoint

`PUT /users/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `UsersController` (MODULE_DECLARES)

<!-- source: function-validateparseresult.md -->

# validateParseResult

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 207)

Validate parse result structure

## Signature

```ts
function validateParseResult(result: ParseResult): boolean
```

## Parameters

| Name | Type |
|---|---|
| `result` | `ParseResult` |

**Returns:** `boolean`

<!-- source: constant-angular-detection-config.md -->

# ANGULAR_DETECTION_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/angular.patterns.ts` (line 242)

## Definition

```ts
AngularDetectionConfig
```

<!-- source: interface-apiendpoint.md -->

# APIEndpoint

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/APIExplorer.ts` (line 39)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `path` | `string` |
| `method` | `string` |
| `summary` | `string` |
| `description` | `string` |
| `tags` | `string[]` |
| `parameters` | `any[]` |
| `requestBody` | `any` |
| `responses` | `Record<string, any>` |
| `requiresAuth` | `boolean` |
| `security` | `Array<Record<string, string[]>>` |
| `samples` | `Array<{ lang: string; source: string }>` |

<!-- source: interface-apiexecruntimeconfig.md -->

# ApiExecRuntimeConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.service.ts` (line 13)

Stored Live-API-target config (project.settings.apiExec). authHeaderValue is a server-side secret.

## Properties

| Property | Type |
|---|---|
| `baseUrl` | `string` |
| `authHeaderName` | `string` |
| `authHeaderValue` | `string` |
| `allowWrites` | `boolean` |
| `enabled` | `boolean` |

<!-- source: class-authenticationerror.md -->

# AuthenticationError

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/types/errors.ts` (line 44)

Authentication error (401 Unauthorized)

**Extends:** `APIError`

<!-- source: component-avatar-3.md -->

# Avatar

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Suggestions/SuggestionCard.tsx` (line 112)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `user` | `unknown` | ✓ | - |
| `size` | `unknown | unknown | unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Avatar_789de8b1["Avatar"]
    class component_Avatar_789de8b1 rootComponent
```

## Referenced By

- `SuggestionCard` (RENDERS)

<!-- source: interface-benchmarkadapter.md -->

# BenchmarkAdapter

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/types.ts` (line 289)

Interface that benchmark adapters must implement.

<!-- source: api-endpoint-callback.md -->

# callback

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/saml/saml.controller.ts` (line 41)

SAML callback - IdP redirects here after authentication

## Endpoint

`POST /auth/saml/callback`

## Referenced By

- `SamlController` (MODULE_DECLARES)

<!-- source: service-captureservice.md -->

# CaptureService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/capture/capture.service.ts` (line 32)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createFlow` | `createFlow(projectId: string, user: JwtPayload, dto: CreateFlowDto)` | `unknown` |
| `listFlows` | `listFlows(projectId: string, user: JwtPayload)` | `unknown` |
| `deleteFlow` | `deleteFlow(projectId: string, user: JwtPayload, id: string)` | `unknown` |
| `getFlow` | `getFlow(projectId: string, user: JwtPayload, id: string)` | `unknown` |
| `updateSteps` | `updateSteps(projectId: string, user: JwtPayload, id: string, dto: UpdateFlowStepsDto)` | `unknown` |
| `reshootStep` | `reshootStep(projectId: string, user: JwtPayload, id: string, stepIndex: number, opts: ReshootStepDto)` | `unknown` |
| `reshootLocales` | `reshootLocales(projectId: string, user: JwtPayload, id: string, dto: ReshootLocalesDto)` | `unknown` |
| `createDraft` | `createDraft(projectId: string, user: JwtPayload, id: string)` | `unknown` |
| `getPublicFlow` | `getPublicFlow(id: string)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `draftdocumentservice`
- DEPENDS_ON → `flowdraftstitcherservice`

<!-- source: class-chatresolutiondto.md -->

# ChatResolutionDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/chat-resolution.dto.ts` (line 11)

Body for the PUBLIC chat resolution endpoint
(`POST /public/p/:slugWithId/chat/resolution`).

Answers the "Did this solve it?" prompt shown once per session after an
assistant answer completes. Persisted as a `chat_resolution` InteractionEvent
on the shared analytics spine (manuals-insights + ops cockpit read it).

## Properties

| Property | Type |
|---|---|
| `outcome` | `'yes' | 'no' | 'partly'` |
| `sessionId` | `string` |

<!-- source: function-classifypersona.md -->

# classifyPersona

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-14-meta/generators/category-restructure.ts` (line 29)

Classify a persona as admin or user based on name/description keywords.
Generic "manager" is NOT admin.

## Signature

```ts
function classifyPersona(persona: { name: string; description: string }): PersonaClassification
```

## Parameters

| Name | Type |
|---|---|
| `persona` | `{ name: string; description: string }` |

**Returns:** `PersonaClassification`

<!-- source: function-classifytask.md -->

# classifyTask

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/tool-profiles.ts` (line 94)

Infer a TaskMode from the user's opening message using keyword heuristics.
Returns 'full' when no clear signal is found.

## Signature

```ts
function classifyTask(message: string): TaskMode
```

## Parameters

| Name | Type |
|---|---|
| `message` | `string` |

**Returns:** `TaskMode`

<!-- source: interface-componentusage.md -->

# ComponentUsage

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/template-analysis.interface.ts` (line 163)

Component usage in template

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `tag` | `string` |
| `line` | `number` |
| `inputs` | `Record<string, string>` |
| `outputs` | `Record<string, string>` |
| `conditionalOn` | `string` |

<!-- source: interface-copilotasksource.md -->

# CopilotAskSource

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/copilotUtils.ts` (line 16)

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `path` | `string` |
| `snippet` | `string` |
| `score` | `number` |
| `docType` | `string` |

<!-- source: function-createallvariantagents.md -->

# createAllVariantAgents

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/agents/variant.agent.ts` (line 51)

Create all three variant agents.

## Signature

```ts
function createAllVariantAgents(config: GenerationConfig, deps: VariantDependencies): AgentConfig<PmeContext>[]
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |
| `deps` | `VariantDependencies` |

**Returns:** `AgentConfig<PmeContext>[]`

<!-- source: function-defaultparsers.md -->

# defaultParsers

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/orchestrator/create-default-orchestrator.ts` (line 38)

The standard parser set — every framework parser-core ships auto-detection for.

## Signature

```ts
function defaultParsers(): IParser[]
```

**Returns:** `IParser[]`

<!-- source: function-deskstateof.md -->

# deskStateOf

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 148)

## Signature

```ts
function deskStateOf(t: Pick<DeskThread, 'status' | 'firstAgentReplyAt' | 'snoozedUntil'>): DeskState
```

## Parameters

| Name | Type |
|---|---|
| `t` | `Pick<DeskThread, 'status' | 'firstAgentReplyAt' | 'snoozedUntil'>` |

**Returns:** `DeskState`

<!-- source: type-doctype.md -->

# DocType

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/doc-type-classifier.ts` (line 12)

## Definition

```ts
'procedural' | 'conceptual' | 'reference' | 'troubleshooting' | 'workflow'
```

<!-- source: controller-documentationcontroller.md -->

# DocumentationController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/documentation/documentation.controller.ts` (line 10)

## Relationships

- MODULE_DECLARES → `generateUserDocumentation`
- MODULE_DECLARES → `generateFromNeo4j`
- DEPENDS_ON → `documentationservice`
- DEPENDS_ON → `neo4jdocsorchestratorservice`

<!-- source: class-embedder.md -->

# Embedder

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/embedder.ts` (line 61)

Azure OpenAI embedding adapter.

Sends texts to the Azure OpenAI embeddings endpoint and returns
vector representations. Handles batching, rate limiting, and
error propagation.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `embedBatch` | `embedBatch(texts: string[])` | `Promise<number[][]>` |
| `embedQuery` | `embedQuery(text: string)` | `Promise<number[]>` |
| `isConfigured` | `isConfigured()` | `boolean` |

<!-- source: module-eventsmodule.md -->

# EventsModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/events/events.module.ts` (line 9)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_DECLARES → `eventscontroller`
- MODULE_DECLARES → `agentanalyticscontroller`
- MODULE_PROVIDES → `eventsservice`
- MODULE_PROVIDES → `agentanalyticsservice`
- MODULE_EXPORTS → `eventsservice`

<!-- source: constant-faqtemplate.md -->

# faqTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/faq.template.ts` (line 3)

<!-- source: function-generateemail.md -->

# generateEmail

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 16)

Generate a unique email

## Signature

```ts
function generateEmail(prefix): string
```

## Parameters

| Name | Type |
|---|---|
| `prefix` | `any` |

**Returns:** `string`

<!-- source: component-herodarkcentered.md -->

# HeroDarkCentered

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/hero/hero-dark-centered.tsx` (line 34)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `subheadlineKey` | `string` | ✓ | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `badgeKey` | `string` | - | - |
| `floatingStats` | `unknown[]` | - | - |
| `imageSrc` | `string` | - | - |
| `imageAlt` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_HeroDarkCentered_46ad98c9["HeroDarkCentered"]
    class component_HeroDarkCentered_46ad98c9 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- USES_HOOK → `useTranslation`

<!-- source: interface-indexdefinition.md -->

# IndexDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 680)

Index definition

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `fields` | `string[]` |
| `unique` | `boolean` |
| `type` | `'btree' | 'hash' | 'gin' | 'gist' | 'fulltext'` |

<!-- source: function-ingressname.md -->

# ingressName

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/project/k8s-ingress.service.ts` (line 25)

## Signature

```ts
function ingressName(domain: string): string
```

## Parameters

| Name | Type |
|---|---|
| `domain` | `string` |

**Returns:** `string`

<!-- source: class-parserorchestrator.md -->

# ParserOrchestrator

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/orchestrator/parser-orchestrator.ts` (line 74)

ParserOrchestrator - Coordinates multiple parsers for project-wide parsing

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(parserConfig: ParserConfig)` | `Promise<void>` |
| `registerParser` | `registerParser(parser: IParser, priority: undefined)` | `void` |
| `unregisterParser` | `unregisterParser(name: string)` | `boolean` |
| `getParser` | `getParser(name: string)` | `IParser | undefined` |
| `getRegisteredParsers` | `getRegisteredParsers()` | `string[]` |
| `findParserForFile` | `findParserForFile(filePath: string)` | `string | null` |
| `findAllParsersForFile` | `findAllParsersForFile(filePath: string)` | `string[]` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFileWithParser` | `parseFileWithParser(parserName: string, filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: string[], onProgress: ProgressCallback)` | `Promise<ParseResult[]>` |
| `parseProject` | `parseProject(config: ParseProjectConfig, onProgress: ProgressCallback)` | `Promise<ProjectParseResult>` |
| `clearCache` | `clearCache()` | `void` |
| `getCacheStats` | `getCacheStats()` | `{ entries: number; size: number }` |
| `destroy` | `destroy()` | `Promise<void>` |

<!-- source: interface-pmemetrics.md -->

# PmeMetrics

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/tracing/pme-metrics.ts` (line 11)

PME Metrics

PME-specific metrics for observability:
- QA scores per section
- Variant generation counts
- Section type distribution
- Generation timing

## Properties

| Property | Type |
|---|---|
| `totalJobs` | `number` |
| `jobsByStatus` | `Record<string, number>` |
| `avgQaScore` | `number` |
| `qaScoresBySection` | `Record<string, number>` |
| `variantSelections` | `Record<string, number>` |
| `avgGenerationTimeMs` | `number` |
| `sectionTypeFrequency` | `Record<string, number>` |
| `tokenUsage` | `{
    totalInput: number;
    totalOutput: number;
  }` |

<!-- source: interface-pricingcomparisontableprops.md -->

# PricingComparisonTableProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/pricing/pricing-comparison-table.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `plans` | `{ nameKey: string; priceKey: string; highlighted?: boolean }[]` |
| `features` | `{ featureKey: string; values: (boolean | string)[] }[]` |

<!-- source: function-savemultipledocuments.md -->

# saveMultipleDocuments

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/utils/screenshot-storage.helper.ts` (line 162)

Save multiple documentation files

## Signature

```ts
async function saveMultipleDocuments(documents: Array<{
    title: string;
    slug: string;
    content: string;
    categoryPath: string[];
    type: 'user-docs' | 'tutorial' | 'feature';
    metadata?: Record<string, unknown>;
  }>, storage: StorageHelperService, aiModel: string): Promise<Array<{ id: string; url: string; title: string }>>
```

## Parameters

| Name | Type |
|---|---|
| `documents` | `Array<{
    title: string;
    slug: string;
    content: string;
    categoryPath: string[];
    type: 'user-docs' | 'tutorial' | 'feature';
    metadata?: Record<string, unknown>;
  }>` |
| `storage` | `StorageHelperService` |
| `aiModel` | `string` |

**Returns:** `Promise<Array<{ id: string; url: string; title: string }>>`

<!-- source: class-screenshotitembuilder.md -->

# ScreenshotItemBuilder

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/test/helpers/batch-builder.ts` (line 133)

Builder for constructing screenshot items

## Methods

| Method | Signature | Returns |
|---|---|---|
| `create` | `create()` | `ScreenshotItemBuilder` |
| `withId` | `withId(id: string)` | `this` |
| `withUrl` | `withUrl(url: string)` | `this` |
| `withDescription` | `withDescription(description: string)` | `this` |
| `withExpectedState` | `withExpectedState(expectedState: string)` | `this` |
| `withWaitForSelector` | `withWaitForSelector(selector: string)` | `this` |
| `withWaitFor` | `withWaitFor(waitFor: WaitForDto)` | `this` |
| `withWaitForTimeout` | `withWaitForTimeout(timeout: number)` | `this` |
| `withActions` | `withActions(actions: Partial<ScreenshotActionDto>[])` | `this` |
| `withClickAction` | `withClickAction(selector: string, options: { waitAfter?: number })` | `this` |
| `withTypeAction` | `withTypeAction(selector: string, value: string, options: { waitAfter?: number })` | `this` |
| `withViewport` | `withViewport(width: number, height: number)` | `this` |
| `withFullPage` | `withFullPage(fullPage: boolean)` | `this` |
| `withStateType` | `withStateType(stateType: 'default' | 'hover' | 'modal' | 'error' | 'success' | 'loading')` | `this` |
| `withPriority` | `withPriority(priority: number)` | `this` |
| `withFlowStepId` | `withFlowStepId(flowStepId: string)` | `this` |
| `build` | `build()` | `Partial<BatchScreenshotItemDto>` |

<!-- source: component-selectcontent.md -->

# SelectContent

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/select.tsx` (line 45)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |
| `className` | `any` | - | unknown |

## Diagram

```mermaid
graph TD
    component_SelectContent_1920d7c2["SelectContent"]
    class component_SelectContent_1920d7c2 rootComponent
```

## Relationships

- RENDERS → `RadixSelect-Portal`
- RENDERS → `RadixSelect-Content`
- RENDERS → `RadixSelect-Viewport`
- USES_HOOK → `useCellValue`

## Referenced By

- `Select` (RENDERS)

<!-- source: type-sessioneventname.md -->

# SessionEventName

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/session/types.ts` (line 88)

All possible session event names

## Definition

```ts
keyof SessionEventMap
```

<!-- source: constant-sla-tone-styles.md -->

# SLA_TONE_STYLES

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 231)

## Definition

```ts
Record<'ok' | 'warn' | 'breach', { bg: string; text: string }>
```

<!-- source: service-structureservice.md -->

# StructureService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-06-structure/structure.service.ts` (line 1)

<!-- source: type-timeperiod.md -->

# TimePeriod

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/TimePeriodSelector.tsx` (line 3)

## Definition

```ts
7 | 30 | 90 | 365
```

<!-- source: api-endpoint-updateuser.md -->

# updateUser

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/fixtures/sample-projects/fullstack-nextjs-nestjs/backend/api/openapi.yaml` (line 1)

Update user

## Endpoint

`PUT /users/{id}`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Relationships

- REFERENCES → `UpdateUser`
- REFERENCES → `User`

## Referenced By

- `User Management API` (IMPLEMENTS_API)

<!-- source: interface-uploadoptions.md -->

# UploadOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/storage/storage.service.ts` (line 5)

## Properties

| Property | Type |
|---|---|
| `filename` | `string` |
| `buffer` | `Buffer` |
| `contentType` | `string` |

<!-- source: function-validaterelationship.md -->

# validateRelationship

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 237)

Validate relationship structure

## Signature

```ts
function validateRelationship(relationship: Relationship): boolean
```

## Parameters

| Name | Type |
|---|---|
| `relationship` | `Relationship` |

**Returns:** `boolean`

<!-- source: type-variantkey.md -->

# VariantKey

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/variant.prompts.ts` (line 9)

## Definition

```ts
'A' | 'B' | 'C'
```

<!-- source: constant-angular-dotnet-api-patterns.md -->

# ANGULAR_DOTNET_API_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/cross-language.types.ts` (line 263)

Angular + .NET specific API patterns

## Definition

```ts
ApiCallPattern[]
```

<!-- source: interface-apiendpoint-2.md -->

# APIEndpoint

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/EndpointDetail.ts` (line 8)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `path` | `string` |
| `method` | `string` |
| `summary` | `string` |
| `description` | `string` |
| `tags` | `string[]` |
| `parameters` | `Parameter[]` |
| `requestBody` | `RequestBody` |
| `responses` | `Record<string, Response>` |
| `samples` | `Array<{ lang: string; source: string }>` |

<!-- source: interface-apiexecutorconfig.md -->

# ApiExecutorConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/mcp/api-executor.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `baseUrl` | `string` |
| `authHeaderName` | `string` |
| `authHeaderValue` | `string` |
| `allowWrites` | `boolean` |

<!-- source: class-authorizationerror.md -->

# AuthorizationError

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/types/errors.ts` (line 55)

Authorization error (403 Forbidden)

**Extends:** `APIError`

<!-- source: component-backgrounddecoration.md -->

# BackgroundDecoration

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/issues/[ticketNumber]/page.tsx` (line 1210)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `accent` | `string` | - | unknown |

## Diagram

```mermaid
graph TD
    component_BackgroundDecoration_25478097["BackgroundDecoration"]
    class component_BackgroundDecoration_25478097 rootComponent
```

## Referenced By

- `PublicTicketPage` (RENDERS)

<!-- source: interface-benchmarkmonitoroptions.md -->

# BenchmarkMonitorOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/benchmark-monitor.ts` (line 100)

## Properties

| Property | Type |
|---|---|
| `outputDir` | `string` |
| `live` | `boolean` |
| `refreshMs` | `number` |

<!-- source: api-endpoint-canceljob-2.md -->

# cancelJob

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 143)

## Endpoint

`POST /doc-automation/jobs/:id/cancel`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: service-categoryservice.md -->

# CategoryService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/document/category.service.ts` (line 14)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `create` | `create(dto: CreateCategoryDto, user: JwtPayload)` | `unknown` |
| `list` | `list(filters: CategoryFiltersDto, user: JwtPayload)` | `unknown` |
| `get` | `get(id: string, user: JwtPayload)` | `unknown` |
| `update` | `update(id: string, dto: UpdateCategoryDto, user: JwtPayload)` | `unknown` |
| `delete` | `delete(id: string, user: JwtPayload)` | `unknown` |
| `reorder` | `reorder(categoryIds: string[], user: JwtPayload)` | `unknown` |
| `getTree` | `getTree(projectId: string, user: JwtPayload, docVersionId: string)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: class-checkoutdto.md -->

# CheckoutDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/billing/dto/checkout.dto.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `plan` | `BillingPlanKey` |

<!-- source: function-classifytier.md -->

# classifyTier

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/services/entity-mapper.service.ts` (line 325)

Classify an entity into a tier based on its mapped type and file path.

## Signature

```ts
function classifyTier(type: DocAutoEntityType, relativePath: string): EntityTier
```

## Parameters

| Name | Type |
|---|---|
| `type` | `DocAutoEntityType` |
| `relativePath` | `string` |

**Returns:** `EntityTier`

<!-- source: function-compareconfidence.md -->

# compareConfidence

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/memory/types.ts` (line 140)

Compare confidence levels. Returns positive if a > b.

## Signature

```ts
function compareConfidence(a: string, b: string): number
```

## Parameters

| Name | Type |
|---|---|
| `a` | `string` |
| `b` | `string` |

**Returns:** `number`

<!-- source: interface-conditionalblock.md -->

# ConditionalBlock

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/template-analysis.interface.ts` (line 100)

Conditional block (ngIf, v-if, v-show)

## Properties

| Property | Type |
|---|---|
| `type` | `'if' | 'else-if' | 'else' | 'show' | 'switch'` |
| `condition` | `string` |
| `line` | `number` |
| `elements` | `TemplateElement[]` |

<!-- source: function-createassemblehtmltool.md -->

# createAssembleHtmlTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/assemble-html.tool.ts` (line 24)

Create the assemble_html tool.
Accepts a storeFn so it can auto-store the generated HTML and return only a summary
(avoids sending 30K+ chars back through the agent loop which causes API timeouts).

## Signature

```ts
function createAssembleHtmlTool(storeFn: StoreAssetFn, config: GenerationConfig): ToolDefinition<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `storeFn` | `StoreAssetFn` |
| `config` | `GenerationConfig` |

**Returns:** `ToolDefinition<PmeContext>`

<!-- source: interface-createconfigdto.md -->

# CreateConfigDto

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationConfig.ts` (line 58)

DTO for creating config

## Properties

| Property | Type |
|---|---|
| `repositoryUrl` | `string` |
| `repositoryBranch` | `string` |
| `frontendPath` | `string` |
| `backendPath` | `string` |
| `siteUrl` | `string` |
| `siteLoginUrl` | `string` |
| `siteEmail` | `string` |
| `sitePassword` | `string` |
| `repoUsername` | `string` |
| `repoPassword` | `string` |
| `skeletonStructure` | `SkeletonStructure` |
| `targetAudience` | `string` |
| `autoPublish` | `boolean` |

<!-- source: function-destroywebsocketclient.md -->

# destroyWebSocketClient

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/websocket-client.ts` (line 307)

Destroy WebSocket client instance

## Signature

```ts
function destroyWebSocketClient(): void
```

**Returns:** `void`

<!-- source: function-detectapprovalstates.md -->

# detectApprovalStates

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/semantic-detector.ts` (line 232)

Detect approval-related states

Finds state references containing "Approval" in their name:
- AwaitingApproval, RejectedApproval, etc.

## Signature

```ts
function detectApprovalStates(code: string): string[]
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |

**Returns:** `string[]`

<!-- source: controller-documentcontroller.md -->

# DocumentController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 39)

## Relationships

- MODULE_DECLARES → `create`
- MODULE_DECLARES → `list`
- MODULE_DECLARES → `search`
- MODULE_DECLARES → `get`
- MODULE_DECLARES → `getStats`
- MODULE_DECLARES → `compare`
- MODULE_DECLARES → `update`
- MODULE_DECLARES → `delete`
- MODULE_DECLARES → `getVersions`
- MODULE_DECLARES → `getVersion`
- MODULE_DECLARES → `revert`
- MODULE_DECLARES → `publish`
- MODULE_DECLARES → `unpublish`
- MODULE_DECLARES → `render`
- MODULE_DECLARES → `getTree`
- MODULE_DECLARES → `getRevisions`
- MODULE_DECLARES → `getRevision`
- MODULE_DECLARES → `restoreFromRevision`
- MODULE_DECLARES → `createVersion`
- MODULE_DECLARES → `getNamedVersions`
- MODULE_DECLARES → `getNamedVersion`
- MODULE_DECLARES → `updateVersionMetadata`
- MODULE_DECLARES → `deleteVersion`
- MODULE_DECLARES → `restoreFromVersion`
- MODULE_DECLARES → `bulkDelete`
- MODULE_DECLARES → `bulkMove`
- MODULE_DECLARES → `bulkUpdateVisibility`
- MODULE_DECLARES → `bulkPublish`
- MODULE_DECLARES → `duplicate`
- DEPENDS_ON → `documentservice`
- DEPENDS_ON → `documentrevisionservice`
- DEPENDS_ON → `documentversionservice`

<!-- source: type-documenttype.md -->

# DocumentType

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-04.types.ts` (line 50)

## Definition

```ts
| 'guide' // How to do something
  | 'tutorial' // Step-by-step learning
  | 'reference' // Lookup information
  | 'faq' // Common questions
  | 'troubleshooting' // Fix problems
  | 'overview' // High-level explanation
  | 'quickstart'
```

<!-- source: class-envtracker.md -->

# EnvTracker

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/tools/env-tracker.ts` (line 70)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `isEnvModifyingCommand` | `isEnvModifyingCommand(command: string)` | `boolean` |
| `capture` | `capture()` | `Promise<EnvSnapshot>` |
| `getSnapshot` | `getSnapshot()` | `EnvSnapshot | null` |
| `getChanges` | `getChanges()` | `Record<string, { from?: string; to: string }>` |
| `formatForContext` | `formatForContext()` | `string` |
| `getCaptureCount` | `getCaptureCount()` | `number` |

<!-- source: constant-featuredocumentationtemplate.md -->

# featureDocumentationTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/feature-documentation.template.ts` (line 3)

<!-- source: module-gatewaymodule.md -->

# GatewayModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/gateway/gateway.module.ts` (line 6)

## Relationships

- MODULE_PROVIDES → `documentgateway`
- MODULE_PROVIDES → `commentgateway`
- MODULE_EXPORTS → `documentgateway`
- MODULE_EXPORTS → `commentgateway`

<!-- source: function-generateid.md -->

# generateId

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/data-factories.ts` (line 9)

Test data factories for E2E tests
Generates realistic test data for P0 features

## Signature

```ts
function generateId(): string
```

**Returns:** `string`

<!-- source: component-herogradientsplit.md -->

# HeroGradientSplit

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/hero/hero-gradient-split.tsx` (line 26)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `subheadlineKey` | `string` | ✓ | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `imageSrc` | `string` | ✓ | - |
| `imageAlt` | `string` | ✓ | - |
| `badges` | `unknown[]` | - | - |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_HeroGradientSplit_2b8b2dfb["HeroGradientSplit"]
    class component_HeroGradientSplit_2b8b2dfb rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- RENDERS → `motion-span`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: interface-iparser.md -->

# IParser

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/parser.interface.ts` (line 60)

Base interface that ALL parsers must implement

Each parser (React, NestJS, Prisma, etc.) implements this interface
to ensure consistent behavior across the system.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `supportedPatterns` | `string[]` |

<!-- source: function-isbot.md -->

# isBot

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/analytics/utils/tracking-utils.ts` (line 20)

Returns true if the given user-agent string looks like a bot/crawler/automation tool.
Empty strings are treated as bots — a real browser always sends a UA.

## Signature

```ts
function isBot(userAgent: string | null | undefined): boolean
```

## Parameters

| Name | Type |
|---|---|
| `userAgent` | `string | null | undefined` |

**Returns:** `boolean`

<!-- source: interface-pmeprogressevent.md -->

# PmeProgressEvent

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 200)

WebSocket progress event payload.

## Properties

| Property | Type |
|---|---|
| `jobId` | `string` |
| `progress` | `number` |
| `stage` | `string` |
| `message` | `string` |

<!-- source: interface-pricingfeature.md -->

# PricingFeature

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/pricing-tier-card.tsx` (line 14)

## Properties

| Property | Type |
|---|---|
| `textKey` | `string` |

<!-- source: class-prismaparser-2.md -->

# PrismaParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/database/prisma.parser.ts` (line 74)

Prisma Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: class-screenshotresultdto.md -->

# ScreenshotResultDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 692)

Individual screenshot result

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `screenshotId` | `string` |
| `url` | `string` |
| `blobUrl` | `string` |
| `viewport` | `{ width: number; height: number }` |
| `dimensions` | `{ width: number; height: number }` |
| `size` | `number` |
| `version` | `number` |
| `isNew` | `boolean` |
| `stateType` | `string` |
| `category` | `string` |
| `description` | `string` |
| `capturedAt` | `Date` |
| `featureArea` | `string` |
| `pageType` | `string` |
| `semanticTags` | `string[]` |
| `recoveryAttempts` | `number` |
| `recoverySucceeded` | `boolean` |
| `successfulSelector` | `string` |

<!-- source: component-selecttrigger.md -->

# SelectTrigger

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/select.tsx` (line 25)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `title` | `any` | ✓ | - |
| `placeholder` | `any` | ✓ | - |
| `className` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SelectTrigger_5ec306ff["SelectTrigger"]
    class component_SelectTrigger_5ec306ff rootComponent
```

## Relationships

- RENDERS → `TooltipWrap`
- RENDERS → `RadixSelect-Trigger`
- RENDERS → `RadixSelect-Value`
- RENDERS → `RadixSelect-Icon`
- USES_HOOK → `useCellValues`

## Referenced By

- `Select` (RENDERS)

<!-- source: function-servecommand.md -->

# serveCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/serve.command.ts` (line 33)

## Signature

```ts
async function serveCommand(options: ServeOptions)
```

## Parameters

| Name | Type |
|---|---|
| `options` | `ServeOptions` |

<!-- source: type-sessionstate.md -->

# SessionState

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/session/types.ts` (line 101)

Current state of the session.
- idle: waiting for user input
- running: agent is processing
- completed: session ended normally
- error: session ended with an error

## Definition

```ts
'idle' | 'running' | 'completed' | 'error'
```

<!-- source: constant-status-cfg.md -->

# STATUS_CFG

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 5)

## Definition

```ts
Record<
  string,
  { bg: string; text: string; label: string; dot: string }
>
```

<!-- source: service-synthesizerservice.md -->

# SynthesizerService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-05-synthesis/synthesizer.service.ts` (line 1)

<!-- source: type-toastvariant.md -->

# ToastVariant

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/components/Boards/Toast.tsx` (line 11)

## Definition

```ts
'success' | 'error' | 'info'
```

<!-- source: interface-uploadresult.md -->

# UploadResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/storage/storage.service.ts` (line 11)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `filename` | `string` |
| `size` | `number` |
| `uploadedAt` | `Date` |

<!-- source: type-visualstrategy.md -->

# VisualStrategy

**Kind:** Type

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 36)

## Definition

```ts
'none' | 'screenshots' | 'mockups'
```

<!-- source: function-wait.md -->

# wait

**Kind:** Function

**Source:** `atloria-monorepo/apps/parser-orchestrator/test/integration/helpers/test-utils.ts` (line 362)

Wait for a specified duration

## Signature

```ts
function wait(ms: number): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `ms` | `number` |

**Returns:** `Promise<void>`

<!-- source: constant-angular-forms-patterns.md -->

# ANGULAR_FORMS_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/angular.patterns.ts` (line 161)

<!-- source: interface-apiendpoint-3.md -->

# APIEndpoint

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/EndpointList.ts` (line 8)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `path` | `string` |
| `method` | `string` |
| `summary` | `string` |
| `description` | `string` |
| `tags` | `string[]` |

<!-- source: interface-apitargetpublicconfig.md -->

# ApiTargetPublicConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.service.ts` (line 22)

What the config read/write endpoints expose — NEVER the auth value (only whether one is set).

## Properties

| Property | Type |
|---|---|
| `baseUrl` | `string` |
| `authHeaderName` | `string` |
| `allowWrites` | `boolean` |
| `enabled` | `boolean` |
| `hasAuth` | `boolean` |

<!-- source: class-azureresponsesprovider-2.md -->

# AzureResponsesProvider

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/azure-responses.provider.ts` (line 61)

**Implements:** `AIProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate(prompt: string, options: AIGenerateOptions, stage: JobStage)` | `Promise<AIResponse>` |
| `generateWithStreaming` | `generateWithStreaming(prompt: string, options: AIGenerateOptions, stage: JobStage)` | `Promise<AIResponse>` |
| `generateText` | `generateText(prompt: string, options: Omit<AIGenerateOptions, 'messages'>, stage: JobStage)` | `Promise<string>` |
| `generateJSON` | `generateJSON(prompt: string, options: AIGenerateOptions, stage: JobStage)` | `Promise<{ data: T; response: AIResponse }>` |
| `generateWithStructuredOutput` | `generateWithStructuredOutput(options: {
    prompt: string;
    schema: object;
    model?: string;
  })` | `Promise<{ content: T; usage: { inputTokens: number; outputTokens: number } }>` |
| `isAvailable` | `isAvailable()` | `Promise<boolean>` |
| `getThrottlingStatus` | `getThrottlingStatus()` | `{ consecutiveFailures: number; adaptiveDelayMs: number; lastFailureTime: number }` |

## Properties

| Property | Type |
|---|---|
| `name` | `string` |

<!-- source: component-badge.md -->

# Badge

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/all/page.tsx` (line 87)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `bg` | `string` | ✓ | - |
| `text` | `string` | ✓ | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Badge_3d9e3d14["Badge"]
    class component_Badge_3d9e3d14 rootComponent
```

## Referenced By

- `IssuesAllPageInner` (RENDERS)

<!-- source: interface-benchmarkreport.md -->

# BenchmarkReport

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/types.ts` (line 214)

Summary of a complete benchmark run.

## Properties

| Property | Type |
|---|---|
| `suite` | `BenchmarkTask['suite']` |
| `model` | `string` |
| `timestamp` | `string` |
| `totalTasks` | `number` |
| `passedTasks` | `number` |
| `passRate` | `number` |
| `totalDurationMs` | `number` |
| `totalTokens` | `{ input: number; output: number; total: number }` |
| `totalCostUsd` | `number` |
| `avgCostPerTask` | `number` |
| `byDifficulty` | `Record<string, { total: number; passed: number; rate: number }>` |
| `byLanguage` | `Record<string, { total: number; passed: number; rate: number }>` |
| `results` | `TaskResult[]` |
| `toolStats` | `Record<string, { count: number; avgDurationMs: number }>` |
| `failureBreakdown` | `Record<string, number>` |
| `byRepo` | `Record<string, { total: number; passed: number; rate: number; topFailure?: string }>` |
| `cumulativePassAtK` | `Record<number, { passed: number; rate: number }>` |
| `marginalGains` | `Record<string, number>` |
| `passAtK` | `{ k: number; passed: number; rate: number }` |
| `passAtKResults` | `PassAtKResult[]` |
| `costEfficiency` | `{
    firstPassSuccess: { avgTokens: number; avgDurationMs: number; avgTurns: number; count: number };
    recoveredSuccess: { avgTokens: number; avgDurationMs: number; avgTurns: number; count: number };
    finalFailure: { avgTokens: number; avgDurationMs: number; avgTurns: number; count: number };
  }` |
| `fileLocalizationStats` | `{
    avgRecall: number;
    avgPrecision: number;
    /** Tasks with >0 overlap that still failed */
    correctAreaButFailed: number;
    /** Tasks with 0 overlap */
    zeroOverlap: number;
  }` |

<!-- source: api-endpoint-canceljob-3.md -->

# cancelJob

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/sync.controller.ts` (line 167)

## Endpoint

`POST /projects/sync/jobs/:jobId/cancel`

| Parameter | In | Type | Required |
|---|---|---|---|
| `jobId` | query | `string` | ✓ |

## Referenced By

- `SyncController` (MODULE_DECLARES)

<!-- source: service-changelogservice.md -->

# ChangelogService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/doc-version/changelog.service.ts` (line 5)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generateChangelog` | `generateChangelog(versionAId: string, versionBId: string)` | `Promise<string>` |
| `generateAndStore` | `generateAndStore(versionId: string)` | `Promise<string>` |

## Relationships

- DEPENDS_ON → `versiondiffservice`
- DEPENDS_ON → `prismaservice`

<!-- source: function-combinesourcetexts.md -->

# combineSourceTexts

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/services/business-context-extractor.ts` (line 115)

Combine multiple source contents into a single text block.

## Signature

```ts
function combineSourceTexts(sources: ContextSource[]): string
```

## Parameters

| Name | Type |
|---|---|
| `sources` | `ContextSource[]` |

**Returns:** `string`

<!-- source: class-commentfiltersdto.md -->

# CommentFiltersDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/comment/dto/comment-filters.dto.ts` (line 8)

DTO for filtering comments when listing

## Properties

| Property | Type |
|---|---|
| `resolved` | `boolean` |
| `search` | `string` |

<!-- source: function-computeactionsignature.md -->

# computeActionSignature

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/circle-detector.ts` (line 118)

Compute an action signature from a set of tool calls.
Order-independent (sorted by toolName).

## Signature

```ts
function computeActionSignature(toolCalls: Array<{ toolName: string; rawInput: string }>): string
```

## Parameters

| Name | Type |
|---|---|
| `toolCalls` | `Array<{ toolName: string; rawInput: string }>` |

**Returns:** `string`

<!-- source: interface-conditionalrender.md -->

# ConditionalRender

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 108)

## Properties

| Property | Type |
|---|---|
| `directive` | `string` |
| `condition` | `string` |
| `renders` | `string` |
| `filePath` | `string` |
| `lineNumber` | `number` |

<!-- source: function-createbrandvoiceguardrail.md -->

# createBrandVoiceGuardrail

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/brand-voice.guardrail.ts` (line 51)

## Signature

```ts
function createBrandVoiceGuardrail(config: BrandVoiceConfig): OutputGuardrailDefinition
```

## Parameters

| Name | Type |
|---|---|
| `config` | `BrandVoiceConfig` |

**Returns:** `OutputGuardrailDefinition`

<!-- source: interface-createjobparams.md -->

# CreateJobParams

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/usePme.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `targetAudience` | `string` |
| `brandVoice` | `string` |
| `language` | `string` |
| `pageType` | `string` |
| `sections` | `string[]` |
| `model` | `string` |

<!-- source: function-detectmodaltriggers.md -->

# detectModalTriggers

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/semantic-detector.ts` (line 171)

Detect modal/dialog trigger methods

Finds methods that open modals/dialogs based on:
- Method names ending with "Prepare"
- Calls to openPopup, showDialog, openModal

## Signature

```ts
function detectModalTriggers(code: string): string[]
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |

**Returns:** `string[]`

<!-- source: function-detectprovider.md -->

# detectProvider

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/useNewProjectWizard.ts` (line 123)

## Signature

```ts
function detectProvider(url: string): { provider: 'github' | 'gitlab' | 'bitbucket'; owner: string; repo: string } | null
```

## Parameters

| Name | Type |
|---|---|
| `url` | `string` |

**Returns:** `{ provider: 'github' | 'gitlab' | 'bitbucket'; owner: string; repo: string } | null`

<!-- source: controller-docversioncontroller.md -->

# DocVersionController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 28)

## Relationships

- MODULE_DECLARES → `list`
- MODULE_DECLARES → `getActive`
- MODULE_DECLARES → `compareVersions`
- MODULE_DECLARES → `diffDocument`
- MODULE_DECLARES → `applyEdit`
- MODULE_DECLARES → `listPendingApprovals`
- MODULE_DECLARES → `get`
- MODULE_DECLARES → `create`
- MODULE_DECLARES → `update`
- MODULE_DECLARES → `activate`
- MODULE_DECLARES → `publish`
- MODULE_DECLARES → `archive`
- MODULE_DECLARES → `deprecate`
- MODULE_DECLARES → `delete`
- MODULE_DECLARES → `getReview`
- MODULE_DECLARES → `resolve`
- MODULE_DECLARES → `resolveAll`
- MODULE_DECLARES → `getScreenshots`
- MODULE_DECLARES → `bulkScreenshotAction`
- MODULE_DECLARES → `previewScreenshot`
- MODULE_DECLARES → `captureScreenshot`
- MODULE_DECLARES → `uploadScreenshot`
- MODULE_DECLARES → `updatePlaceholder`
- MODULE_DECLARES → `getChangelog`
- MODULE_DECLARES → `cherryPick`
- MODULE_DECLARES → `exportMarkdown`
- MODULE_DECLARES → `exportHTML`
- MODULE_DECLARES → `exportPDF`
- MODULE_DECLARES → `getAccess`
- MODULE_DECLARES → `updateAccess`
- MODULE_DECLARES → `requestApproval`
- MODULE_DECLARES → `approve`
- MODULE_DECLARES → `reject`
- MODULE_DECLARES → `getApproval`
- DEPENDS_ON → `docversionservice`
- DEPENDS_ON → `versioncarryforwardservice`
- DEPENDS_ON → `versiondiffservice`
- DEPENDS_ON → `changelogservice`
- DEPENDS_ON → `docversionexportservice`

<!-- source: type-editorsubscription.md -->

# EditorSubscription

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 96)

A function that subscribes to Lexical editor updates or events, and retursns an unsubscribe function.

## Definition

```ts
(activeEditor: LexicalEditor) => () => void
```

<!-- source: constant-featurerequesttemplate.md -->

# featureRequestTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/feature-request.template.ts` (line 3)

<!-- source: function-generateperformancereport.md -->

# generatePerformanceReport

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/performance.ts` (line 305)

Generate performance report

## Signature

```ts
function generatePerformanceReport(metrics: PerformanceMetrics): string
```

## Parameters

| Name | Type |
|---|---|
| `metrics` | `PerformanceMetrics` |

**Returns:** `string`

<!-- source: class-gitbackend.md -->

# GitBackend

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/git-backend.ts` (line 56)

**Implements:** `CheckpointBackend`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `isGitRepo` | `isGitRepo(dir: string)` | `boolean` |
| `save` | `save(snap: Snapshot)` | `void` |
| `load` | `load(relPath: string)` | `Snapshot[]` |
| `loadLatest` | `loadLatest(relPath: string)` | `Snapshot | null` |
| `deleteFile` | `deleteFile(relPath: string)` | `void` |
| `deleteFrom` | `deleteFrom(relPath: string, fromIndex: number)` | `void` |
| `getTrackedFiles` | `getTrackedFiles()` | `string[]` |
| `getTotalCount` | `getTotalCount()` | `number` |
| `getSnapshotCount` | `getSnapshotCount(relPath: string)` | `number` |
| `clear` | `clear()` | `void` |
| `evictOldest` | `evictOldest()` | `boolean` |

## Properties

| Property | Type |
|---|---|
| `sessionId` | `string` |

<!-- source: module-githubappmodule.md -->

# GithubAppModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/github-app/github-app.module.ts` (line 7)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `forwardref`
- MODULE_DECLARES → `githubappcontroller`
- MODULE_PROVIDES → `githubappservice`
- MODULE_EXPORTS → `githubappservice`

<!-- source: component-herominimalcentered.md -->

# HeroMinimalCentered

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/hero/hero-minimal-centered.tsx` (line 28)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `subheadlineKey` | `string` | ✓ | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `badgeKey` | `string` | - | - |
| `badgeIcon` | `LucideIcon` | - | - |
| `dividerIcons` | `LucideIcon[]` | - | - |
| `imageSrc` | `string` | - | - |
| `imageAlt` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_HeroMinimalCentered_3b49a4d3["HeroMinimalCentered"]
    class component_HeroMinimalCentered_3b49a4d3 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `BadgeIcon`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: function-isprivateip.md -->

# isPrivateIp

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/ssrf.ts` (line 12)

Private/link-local/loopback ranges — IPv4, IPv6 and IPv4-mapped IPv6.

## Signature

```ts
function isPrivateIp(addr: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `addr` | `string` |

**Returns:** `boolean`

<!-- source: interface-jobstatus.md -->

# JobStatus

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/config.interface.ts` (line 303)

Job status information

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `status` | `'waiting' | 'active' | 'completed' | 'failed' | 'delayed' | 'paused'` |
| `progress` | `number` |
| `result` | `unknown` |
| `failedReason` | `string` |
| `attemptsMade` | `number` |
| `finishedOn` | `number` |
| `processedOn` | `number` |

<!-- source: interface-pmeturnhookconfig.md -->

# PmeTurnHookConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/context/pme-turn-hook.ts` (line 32)

## Properties

| Property | Type |
|---|---|
| `maxTurns` | `number` |
| `tokenBudget` | `number` |
| `pressureThreshold` | `number` |
| `truncationThreshold` | `number` |
| `truncatedResultMaxChars` | `number` |
| `preserveRecentResults` | `number` |

<!-- source: interface-pricingfeature-2.md -->

# PricingFeature

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/pricing/pricing-hero-card.tsx` (line 12)

## Properties

| Property | Type |
|---|---|
| `textKey` | `string` |
| `included` | `boolean` |

<!-- source: class-projectdetector.md -->

# ProjectDetector

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/detector/project-detector.ts` (line 55)

ProjectDetector class

Detects project type, frameworks, package manager, and build tools
by analyzing project structure and configuration files.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detect` | `detect(rootDir: string)` | `Promise<DetectedProject>` |
| `addFrameworkRule` | `addFrameworkRule(rule: FrameworkRule)` | `void` |
| `getFrameworkRules` | `getFrameworkRules()` | `FrameworkRule[]` |
| `hasFramework` | `hasFramework(rootDir: string, frameworkName: string)` | `Promise<boolean>` |
| `supportsParser` | `supportsParser(rootDir: string, parserName: string)` | `Promise<boolean>` |

<!-- source: class-selectorvalidationresult.md -->

# SelectorValidationResult

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 791)

Result for a single selector validation

## Properties

| Property | Type |
|---|---|
| `selector` | `string` |
| `found` | `boolean` |
| `visible` | `boolean` |
| `tagName` | `string` |
| `attributes` | `Record<string, string>` |
| `suggestion` | `string` |

<!-- source: function-sessionsdeletecommand.md -->

# sessionsDeleteCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/sessions.command.ts` (line 100)

## Signature

```ts
async function sessionsDeleteCommand(options: SessionsDeleteOptions): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `SessionsDeleteOptions` |

**Returns:** `Promise<void>`

<!-- source: component-stepcard-2.md -->

# StepCard

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/how-it-works/how-it-works-timeline.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `step` | `Step` | ✓ | - |
| `t` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StepCard_4524ff8c["StepCard"]
    class component_StepCard_4524ff8c rootComponent
```

## Relationships

- RENDERS → `Icon`

## Referenced By

- `HowItWorksTimeline` (RENDERS)

<!-- source: type-streamevent.md -->

# StreamEvent

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/session/types.ts` (line 201)

Normalized streaming event from the SDK.
Maps SDK's RunStreamEvent types to our domain events.

## Definition

```ts
| { type: 'item'; name: string; item: unknown }
  | { type: 'model_delta'; data: unknown }
  | { type: 'agent_updated'; agentName: string }
```

<!-- source: constant-template-categories.md -->

# TEMPLATE_CATEGORIES

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/constants/templateCategories.ts` (line 66)

All available template categories derived from the enum

<!-- source: type-uistringkey.md -->

# UiStringKey

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/uiStrings.ts` (line 275)

## Definition

```ts
keyof typeof EN
```

<!-- source: service-uploadservice.md -->

# UploadService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.service.ts` (line 1)

<!-- source: constant-angular-routing-patterns.md -->

# ANGULAR_ROUTING_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/angular.patterns.ts` (line 201)

<!-- source: interface-apiendpoint-4.md -->

# APIEndpoint

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/RequestPanel.ts` (line 8)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `path` | `string` |
| `method` | `string` |
| `parameters` | `Parameter[]` |
| `requestBody` | `RequestBody` |
| `requiresAuth` | `boolean` |

<!-- source: interface-auditeventinput.md -->

# AuditEventInput

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/audit/audit.service.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `organizationId` | `string` |
| `projectId` | `string` |
| `docVersionId` | `string` |
| `actorId` | `string` |
| `actorEmail` | `string` |
| `actorRole` | `string` |
| `action` | `string` |
| `entityType` | `string` |
| `entityId` | `string` |
| `metadata` | `Record<string, any>` |
| `ipAddress` | `string` |
| `userAgent` | `string` |

<!-- source: component-badge-2.md -->

# Badge

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/page.tsx` (line 104)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `bg` | `string` | ✓ | - |
| `text` | `string` | ✓ | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Badge_511b3182["Badge"]
    class component_Badge_511b3182 rootComponent
```

## Referenced By

- `RecentTickets` (RENDERS)

<!-- source: class-batchedscreenshotprocessor.md -->

# BatchedScreenshotProcessor

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/batched-screenshot-processor.ts` (line 70)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `splitIntoBatches` | `splitIntoBatches(mappings: ScreenshotMapping[], batchSize: number)` | `ScreenshotMapping[][]` |
| `processInBatches` | `processInBatches(mappings: ScreenshotMapping[], documents: GeneratedDocument[], registry: ScreenshotRegistry, capturer: { captureScreenshots: (mappings: ScreenshotMapping[], progressCallback?: any) => Promise<CaptureResult[]> }, replacer: { replaceInDocuments: (documents: GeneratedDocument[], screenshots: CapturedScreenshot[], registry: ScreenshotRegistry, progressCallback?: any) => { documents: GeneratedDocument[]; results: any[] } }, config: BatchConfig)` | `Promise<AggregatedResult>` |

<!-- source: interface-benchmarkrunconfig.md -->

# BenchmarkRunConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/types.ts` (line 153)

Configuration for a full benchmark run.

## Properties

| Property | Type |
|---|---|
| `suite` | `BenchmarkTask['suite']` |
| `taskIds` | `string[]` |
| `maxTasks` | `number` |
| `shuffle` | `boolean` |
| `repoBaseDir` | `string` |
| `outputDir` | `string` |
| `model` | `{
    endpoint: string;
    apiKey: string;
    apiVersion: string;
    model: string;
  }` |
| `maxTurns` | `number` |
| `timeoutSec` | `number` |
| `braveApiKey` | `string` |
| `embedding` | `{
    endpoint: string;
    apiKey: string;
    model: string;
  }` |
| `parallelism` | `number` |
| `costPerMInputTokens` | `number` |
| `costPerMOutputTokens` | `number` |
| `attemptsPerTask` | `number` |
| `preset` | `'starter' | 'full'` |
| `useDockerEval` | `boolean` |
| `costLimitPerTask` | `number` |
| `onEvent` | `(event: BenchmarkEvent) => void` |
| `modelProvider` | `import('@openai/agents').ModelProvider` |

<!-- source: api-endpoint-cancelparsing.md -->

# cancelParsing

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/parsing/parsing.controller.ts` (line 71)

## Endpoint

`DELETE /projects/:projectId/parse/:jobId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `jobId` | query | `string` | ✓ |

## Referenced By

- `ParsingController` (MODULE_DECLARES)

<!-- source: service-chatratelimitguard.md -->

# ChatRateLimitGuard

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/support-agent/chat-rate-limit.guard.ts` (line 11)

Phase 7: In-memory rate limiter for public chat endpoints.

Three independent limits:
 - Per IP:           10 messages / minute
 - Per project:    1000 messages / hour
 - Per session:      50 messages total (TTL: 24 h)

`ChatRateLimitGuard` is a NestJS guard that enforces in-memory rate limits for public chat endpoints to prevent abuse and protect backend resources. It applies three independent limits—per IP (10/min), per project (1000/hour), and per session (50 total with a 24h TTL)—and blocks requests that exceed any threshold.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `canActivate` | `canActivate(context: ExecutionContext)` | `boolean` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant C as Client
  participant G as ChatRateLimitGuard
  participant R as In-memory Rate Store
  participant H as Controller/Handler

  C->>G: HTTP request (public chat endpoint)
  G->>R: Increment/check counters (IP, project, session)
  alt Any limit exceeded
    R-->>G: Reject (rate limit hit)
    G-->>C: 429 Too Many Requests
  else Within limits
    R-->>G: Allow
    G->>H: canActivate() passes
    H-->>C: Normal response
  end
```

## Usage

```ts
import { Controller, Post, UseGuards, Body } from '@nestjs/common';
import { ChatRateLimitGuard } from './chat-rate-limit.guard';

@Controller('public/chat')
@UseGuards(ChatRateLimitGuard)
export class PublicChatController {
  @Post('message')
  async sendMessage(
    @Body() body: { projectId: string; sessionId: string; message: string },
  ) {
    // If any rate limit is exceeded, the guard will block before reaching here.
    return { ok: true };
  }
}
```

## AI Coding Instructions

- Keep limits independent: evaluate IP, project, and session constraints separately and fail fast if any one is exceeded.
- Ensure stable identifiers: extract IP (respecting proxy setup), projectId, and sessionId consistently; mismatched keys will silently weaken or over-tighten limits.
- Remember this is in-memory: it resets on process restart and does not coordinate across multiple instances; avoid assuming global enforcement in distributed deployments.
- Session limit is total with TTL: do not accidentally implement it as “per window” like the IP/project limits; preserve the 24h TTL semantics.
- When integrating new endpoints, apply the guard only to public-facing chat routes and ensure required identifiers (projectId/sessionId) are present before the guard runs.

<!-- source: function-commentfrommarkdown.md -->

# commentFromMarkdown

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/mdastUtilHtmlComment.ts` (line 38)

## Signature

```ts
function commentFromMarkdown(_options: { ast?: boolean }): Partial<Config>
```

## Parameters

| Name | Type |
|---|---|
| `_options` | `{ ast?: boolean }` |

**Returns:** `Partial<Config>`

<!-- source: class-comparedocumentdto.md -->

# CompareDocumentDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/compare-document.dto.ts` (line 12)

DTO for comparing two versions or revisions of a document

## Properties

| Property | Type |
|---|---|
| `from` | `string` |
| `to` | `string` |
| `type` | `CompareType` |

<!-- source: function-computecontenthash.md -->

# computeContentHash

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/types.ts` (line 87)

Compute a SHA-256 hash of the content for cache hit detection.

## Signature

```ts
function computeContentHash(content: string): string
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |

**Returns:** `string`

<!-- source: interface-conditionaluipattern.md -->

# ConditionalUIPattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-management.interface.ts` (line 321)

Conditional UI based on state

## Properties

| Property | Type |
|---|---|
| `stateCondition` | `string` |
| `showsElements` | `string[]` |
| `hidesElements` | `string[]` |
| `disablesElements` | `string[]` |
| `stateValues` | `string[]` |

<!-- source: function-createcontentsafetyguardrail.md -->

# createContentSafetyGuardrail

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/content-safety.guardrail.ts` (line 125)

## Signature

```ts
function createContentSafetyGuardrail(config: ContentSafetyConfig): OutputGuardrailDefinition
```

## Parameters

| Name | Type |
|---|---|
| `config` | `ContentSafetyConfig` |

**Returns:** `OutputGuardrailDefinition`

<!-- source: interface-cursorposition.md -->

# CursorPosition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useCollaboration.ts` (line 32)

Cursor position in the document

## Properties

| Property | Type |
|---|---|
| `index` | `number` |
| `length` | `number` |

<!-- source: function-detectngrxactions.md -->

# detectNgRxActions

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ngrx-pattern-detector.ts` (line 157)

Detect NgRx actions from code

## Signature

```ts
function detectNgRxActions(content: string): NgRxActionPattern[]
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |

**Returns:** `NgRxActionPattern[]`

<!-- source: function-dirforlang.md -->

# dirForLang

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/captionRules.ts` (line 11)

## Signature

```ts
function dirForLang(lang: string): 'ltr' | 'rtl'
```

## Parameters

| Name | Type |
|---|---|
| `lang` | `string` |

**Returns:** `'ltr' | 'rtl'`

<!-- source: type-entitytier.md -->

# EntityTier

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 163)

Entity tiers control how much context is included in AI prompts.
This is how we manage the 32K token limit.

TIER_1: User-facing code -> FULL source code included
        Examples: Controllers, React components, Pages
        Why: These define what users can do

TIER_2: Business logic -> Only signatures + JSDoc
        Examples: Services, Utilities, Helpers
        Why: Implementation details aren't needed for user docs

TIER_3: Data structures -> Names only
        Examples: Types, Interfaces, DTOs
        Why: Users don't care about data shapes

TIER_4: Infrastructure -> EXCLUDED completely
        Examples: Tests, Configs, Migrations
        Why: Not relevant to user documentation

## Definition

```ts
'TIER_1' | 'TIER_2' | 'TIER_3' | 'TIER_4'
```

<!-- source: controller-eventscontroller.md -->

# EventsController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/events/events.controller.ts` (line 15)

Public event-ingest endpoint for browser surfaces (docs viewer, chat widget). Anonymous
allowed (public docs visitors give feedback too); userId is attached when authenticated.
Throttled — it's an append-only signal sink, not an API.

`EventsController` exposes a public, anonymous-friendly event ingestion endpoint used by browser surfaces like the docs viewer and chat widget. It accepts append-only telemetry/feedback signals, attaching a `userId` when the caller is authenticated, and is intentionally throttled because it is a signal sink rather than a general-purpose API. It routes incoming event payloads into the backend event pipeline/storage without exposing read/query capabilities.

## Diagram

```mermaid
graph LR
  A[Browser Surface<br/>Docs Viewer / Chat Widget] -->|POST /events| B[EventsController]
  B -->|Apply throttling / validation| C[Events Service / Ingestion Pipeline]
  C --> D[(Event Store / Queue)]
  B -->|If authenticated| E[Auth Context]
  E -->|Attach userId| C
```

## Usage

```ts
// Browser-side: send an event from docs viewer / chat widget.
// This endpoint is designed to be callable without auth (anonymous),
// but if you include credentials (cookie/JWT), the backend may attach userId.

type PublicEventPayload = {
  name: string;                 // e.g. "docs_feedback_submitted"
  source: "docs" | "chat";
  timestamp?: string;           // ISO string; optional if server sets
  metadata?: Record<string, any>;
};

async function ingestEvent(payload: PublicEventPayload) {
  const res = await fetch("https://api.example.com/events", {
    method: "POST",
    headers: { "content-type": "application/json" },
    // If your app uses cookies for auth, keep credentials enabled.
    credentials: "include",
    body: JSON.stringify(payload),
  });

  if (!res.ok) {
    // Because this endpoint is throttled, 429 is a common response during bursts.
    // Your UI should treat failures as non-blocking.
    const text = await res.text().catch(() => "");
    throw new Error(`Event ingest failed (${res.status}): ${text}`);
  }

  // Often returns a simple ack; treat as fire-and-forget.
  return res.json().catch(() => ({}));
}

// Example calls
ingestEvent({
  name: "docs_page_viewed",
  source: "docs",
  metadata: { path: "/getting-started", referrer: document.referrer },
});

ingestEvent({
  name: "chat_widget_opened",
  source: "chat",
  metadata: { location: window.location.href },
});
```

## AI Coding Instructions

- Keep this controller **write-only / append-only**: do not add read/query endpoints here; route analytics reads through a separate, secured API.
- Preserve **anonymous access** while enriching events opportunistically: attach `userId` only when an authenticated context is present; never require auth for basic ingest.
- Maintain and test **throttling behavior** (429 responses are expected); client-side usage should be best-effort and non-blocking.
- Validate and sanitize incoming payloads defensively (size limits, allowed fields) to avoid turning the endpoint into a general data dump surface.
- Integrate with the existing ingestion pipeline/service rather than adding persistence logic inside the controller; keep controller thin and side-effect routing centralized.

## Relationships

- MODULE_DECLARES → `record`
- DEPENDS_ON → `eventsservice`
- DEPENDS_ON → `prismaservice`

<!-- source: constant-generation-credit-cost.md -->

# GENERATION_CREDIT_COST

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/billing/billing.constants.ts` (line 10)

Billing constants.

Credits are an abstract unit: 1 documentation generation = 1,000 credits.
Monthly grants per plan:
  FREE     →   5 generations =   5,000 credits
  PRO      →  50 generations =  50,000 credits
  BUSINESS → 200 generations = 200,000 credits

<!-- source: function-getperformancemetrics.md -->

# getPerformanceMetrics

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/performance.ts` (line 47)

Get performance metrics from a page

## Signature

```ts
async function getPerformanceMetrics(page: Page): Promise<PerformanceMetrics>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |

**Returns:** `Promise<PerformanceMetrics>`

<!-- source: module-githubmodule.md -->

# GitHubModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/github/github.module.ts` (line 10)

## Relationships

- MODULE_IMPORTS → `configmodule`
- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_DECLARES → `githubcontroller`
- MODULE_PROVIDES → `githubservice`
- MODULE_EXPORTS → `githubservice`

<!-- source: component-herowavesplit.md -->

# HeroWaveSplit

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/hero/hero-wave-split.tsx` (line 23)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `subheadlineKey` | `string` | ✓ | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `imageSrc` | `string` | ✓ | - |
| `imageAlt` | `string` | ✓ | - |
| `stats` | `unknown[]` | - | - |
| `trustTextKey` | `string` | - | - |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_HeroWaveSplit_3f17960d["HeroWaveSplit"]
    class component_HeroWaveSplit_3f17960d rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- USES_HOOK → `useTranslation`

<!-- source: class-hookregistry.md -->

# HookRegistry

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/session/hook-registry.ts` (line 76)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `has` | `has(event: HookableEvent)` | `boolean` |
| `run` | `run(event: HookableEvent, data: Record<string, unknown>, toolName: string)` | `Promise<HookRunResult>` |

<!-- source: function-isrtl.md -->

# isRtl

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/project/language.util.ts` (line 90)

True when the code is written right-to-left.

## Signature

```ts
function isRtl(code: string | null): boolean
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string | null` |

**Returns:** `boolean`

<!-- source: interface-linkinfo.md -->

# LinkInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 903)

Link information

## Properties

| Property | Type |
|---|---|
| `text` | `string` |
| `url` | `string` |
| `line` | `number` |
| `isInternal` | `boolean` |

<!-- source: interface-pricingherocardprops.md -->

# PricingHeroCardProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/pricing/pricing-hero-card.tsx` (line 27)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `heroPlan` | `PricingPlan` |
| `secondaryPlans` | `PricingPlan[]` |

<!-- source: class-pythonparser-2.md -->

# PythonParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/backend/python.parser.ts` (line 68)

Python Project Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: interface-qaconfig.md -->

# QaConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/agents/qa.agent.ts` (line 20)

## Properties

| Property | Type |
|---|---|
| `htmlQuality` | `HtmlQualityConfig` |
| `contentSafety` | `ContentSafetyConfig` |
| `passThreshold` | `number` |

<!-- source: class-sessionhealthcheckdto.md -->

# SessionHealthCheckDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 472)

Batch authentication configuration DTO

Defines credentials and optional selectors for authentication.
If useSmartDetection is enabled, AI will auto-detect form selectors.

## Properties

| Property | Type |
|---|---|
| `enabled` | `boolean` |
| `loginPageIndicators` | `string[]` |
| `authenticatedIndicators` | `string[]` |
| `loginUrlPatterns` | `string[]` |
| `maxReauthAttempts` | `number` |

<!-- source: function-sessionslistcommand.md -->

# sessionsListCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/sessions.command.ts` (line 20)

## Signature

```ts
async function sessionsListCommand(_options: SessionsListOptions): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `_options` | `SessionsListOptions` |

**Returns:** `Promise<void>`

<!-- source: component-stepcircle-2.md -->

# StepCircle

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/how-it-works/how-it-works-timeline.tsx` (line 43)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `num` | `number` | ✓ | - |
| `variant` | `unknown | unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StepCircle_6fabedb4["StepCircle"]
    class component_StepCircle_6fabedb4 rootComponent
```

## Referenced By

- `HowItWorksTimeline` (RENDERS)

<!-- source: type-taskcategory.md -->

# TaskCategory

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-router.ts` (line 32)

Model Router — Phase 2

Maps task categories to model deployment names.
Enables cost-optimized routing: cheap models for simple tasks,
full models only where quality matters.

Resolution order per call:
  1. Explicit model passed at spawn time (highest priority — always wins)
  2. Category route from routing table
  3. Default model (fallback — zero behavior change when no table configured)

All models must be deployments on the same Azure endpoint.
The router only returns model names — the provider config is unchanged.

Default routing table for atlas-docs-resource (East US 2):
  explore / synthesize / tool_dispatch → gpt-5.4-nano  (150M TPM quota)
  analyze / review / chat              → gpt-5.4-mini  (10M TPM quota)
  plan / implement                     → gpt-5.4       (full reasoning, 1M context)
  default (uncategorized)              → gpt-5.4       (no behavior change)

## Definition

```ts
| 'explore'       // file search, directory listing, reading code — nano
  | 'analyze'       // code understanding, grep, web search — mini
  | 'plan'          // architecture, design decisions — full
  | 'implement'     // writing/editing code — full
  | 'review'        // code review, quality chec…
```

<!-- source: constant-templategallery.md -->

# TemplateGallery

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/components/Templates/TemplateGallery.tsx` (line 26)

TemplateGallery - Main component for browsing and selecting templates

Displays a filterable gallery of document templates with category filtering,
search, preview functionality, and template selection.

<!-- source: type-usercolor.md -->

# UserColor

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/lib/user-colors.ts` (line 148)

## Definition

```ts
(typeof USER_COLORS)[number]
```

<!-- source: service-v4dstructureservice.md -->

# V4dStructureService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-06-structure/v4d-structure.service.ts` (line 1)

<!-- source: constant-angular-service-detection-patterns.md -->

# ANGULAR_SERVICE_DETECTION_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/angular.patterns.ts` (line 120)

<!-- source: interface-apimapping.md -->

# APIMapping

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/api-call-mapper.ts` (line 66)

A mapped connection between frontend call and backend endpoint

## Properties

| Property | Type |
|---|---|
| `frontendCall` | `DetectedAPICall` |
| `backendEndpoint` | `DetectedEndpoint` |
| `matchConfidence` | `'high' | 'medium' | 'low' | 'none'` |
| `matchReason` | `string` |

<!-- source: interface-awarenessstate-2.md -->

# AwarenessState

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/collaboration/interfaces/collaboration.interfaces.ts` (line 19)

Awareness state for a user's cursor and selection

## Properties

| Property | Type |
|---|---|
| `userId` | `string` |
| `userName` | `string` |
| `color` | `string` |
| `cursor` | `CursorPosition` |
| `selection` | `SelectionRange` |

<!-- source: interface-benchmarktask.md -->

# BenchmarkTask

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/types.ts` (line 13)

Benchmark Types

Shared interfaces for all benchmark adapters (Aider Polyglot, SWE-bench).
Zero external dependencies.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `suite` | `'aider-polyglot' | 'swe-bench-verified' | 'swe-bench-pro'` |
| `prompt` | `string` |
| `repo` | `string` |
| `baseRef` | `string` |
| `setupPatch` | `string` |
| `languages` | `string[]` |
| `difficulty` | `'easy' | 'medium' | 'hard'` |
| `timeoutSec` | `number` |
| `expectedFiles` | `string[]` |
| `testCommand` | `string` |
| `goldPatch` | `string` |
| `metadata` | `Record<string, unknown>` |

<!-- source: component-bitbucketicon.md -->

# BitbucketIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/scenes/SceneUrlInput.tsx` (line 20)

## Diagram

```mermaid
graph TD
    component_BitbucketIcon_6a0041d2["BitbucketIcon"]
    class component_BitbucketIcon_6a0041d2 rootComponent
```

## Referenced By

- `SceneUrlInput` (RENDERS)

<!-- source: api-endpoint-capturescreenshot.md -->

# captureScreenshot

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 277)

## Endpoint

`POST /doc-versions/:projectId/:versionId/screenshots/capture`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: class-categoryrestructure.md -->

# CategoryRestructure

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-14-meta/generators/category-restructure.ts` (line 46)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `restructure` | `restructure(existingCategories: DocumentCategoryStructure[], existingDocuments: PlannedDocument[], personas: Array<{ name: string; description: string }>)` | `RestructureResult` |

<!-- source: service-codeanalysisservice.md -->

# CodeAnalysisService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/ai/services/code-analysis.service.ts` (line 28)

Code Analysis Service using optimized file context

Implements Claude Code & Cursor style optimizations:
- Lazy loading of files
- Token budget management
- Relevance-based file selection
- Chunked reading for large codebases

`CodeAnalysisService` is a NestJS service that analyzes source code using an optimized “file context” approach similar to Claude Code/Cursor. It lazily loads and chunks files, manages an explicit token budget, and selects the most relevant files to include in the analysis context. This service typically sits behind API endpoints or other AI orchestration services to prepare high-signal code context for LLM prompts.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `analyzeCodebase` | `analyzeCodebase(options: {
    baseDir: string;
    patterns: string[];
    query: string;
    tokenBudget?: number;
    keywords?: string[];
    provider?: string;
  })` | `Promise<CodeAnalysisResult>` |
| `analyzeFiles` | `analyzeFiles(options: {
    files: Array<{ path: string; lines?: [number, number] }>;
    query: string;
    provider?: string;
  })` | `Promise<CodeAnalysisResult>` |
| `streamCodebaseAnalysis` | `streamCodebaseAnalysis(options: {
    baseDir: string;
    patterns: string[];
    query: string;
    tokenBudget?: number;
    keywords?: string[];
    provider?: string;
  })` | `AsyncIterableIterator<string>` |
| `getCacheStats` | `getCacheStats()` | `unknown` |
| `clearCache` | `clearCache(filePath: string)` | `unknown` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant Caller as API/Orchestrator
  participant CAS as CodeAnalysisService
  participant FS as File System/Repo
  participant TB as Token Budget Manager
  participant RS as Relevance Selector
  participant CH as Chunk Reader

  Caller->>CAS: analyze(query, repoRoot, options)
  CAS->>RS: rankCandidateFiles(query, repoIndex)
  RS-->>CAS: relevantFiles[]
  CAS->>TB: init(budget, model)
  TB-->>CAS: remainingTokens

  loop for each relevant file (until budget exhausted)
    CAS->>FS: stat/read metadata (lazy)
    FS-->>CAS: size/mtime
    alt small file
      CAS->>FS: readFile(path)
      FS-->>CAS: content
    else large file
      CAS->>CH: readChunks(path, chunkSize)
      CH->>FS: stream/read ranges
      FS-->>CH: chunkContent
      CH-->>CAS: chunkContent
    end
    CAS->>TB: estimateTokens(content)
    TB-->>CAS: allow/trim/stop
  end

  CAS-->>Caller: analysisContext (selected files + excerpts)
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { CodeAnalysisService } from './ai/services/code-analysis.service';

@Injectable()
export class AiOrchestrationService {
  constructor(private readonly codeAnalysis: CodeAnalysisService) {}

  async buildPromptContext() {
    const repoRoot = process.cwd();
    const query = 'Find where authentication is enforced and how JWT is validated';

    // Options are illustrative; use the service’s actual option names/types.
    const context = await this.codeAnalysis.analyze(query, repoRoot, {
      tokenBudget: 12000,
      maxFiles: 20,
      chunkSize: 4000,
      includePatterns: ['apps/api/src/**'],
      excludePatterns: ['**/dist/**', '**/node_modules/**'],
    });

    // `context` can then be appended to an LLM prompt.
    return {
      system: 'You are a codebase assistant.',
      user: `Question: ${query}\n\nCode Context:\n${context}`,
    };
  }
}
```

## AI Coding Instructions

- Preserve the optimization pipeline: relevance ranking → lazy loading → chunked reads → token-budget enforcement; avoid eager full-repo reads.
- When modifying file selection, ensure exclude/include patterns are applied before reading content to prevent wasted IO and token usage.
- Be careful with token estimation: always budget using the final text actually sent (post-trim/post-chunk) to avoid prompt overflow.
- Integration point: return a deterministic, ordered context (stable sorting/ranking) so repeated runs produce similar prompts and diff-friendly outputs.
- For large files, prefer excerpting relevant regions over adding more files; adding too many low-signal files is a common quality pitfall.

## Relationships

- DEPENDS_ON → `filecontextservice`
- DEPENDS_ON → `aiservice`

<!-- source: function-compose.md -->

# compose

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/fp.ts` (line 5)

Performs left to right composition of two functions.

## Signature

```ts
function compose(a: (arg: A) => R, b: (arg: I) => A): (arg: I) => R
```

## Parameters

| Name | Type |
|---|---|
| `a` | `(arg: A) => R` |
| `b` | `(arg: I) => A` |

**Returns:** `(arg: I) => R`

<!-- source: function-computeerrorsignature.md -->

# computeErrorSignature

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/circle-detector.ts` (line 130)

Compute an error signature (hash of error text for dedup).

## Signature

```ts
function computeErrorSignature(errorText: string): string
```

## Parameters

| Name | Type |
|---|---|
| `errorText` | `string` |

**Returns:** `string`

<!-- source: interface-configinfo.md -->

# ConfigInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/storybook/types.ts` (line 128)

Configuration detection result

## Properties

| Property | Type |
|---|---|
| `format` | `ConfigFormat` |
| `configDir` | `string` |
| `stories` | `string[]` |
| `excludePatterns` | `string[]` |
| `detected` | `{
    hasStorybookConfig: boolean;
    hasLadleConfig: boolean;
    hasAtloriaConfig: boolean;
  }` |

<!-- source: class-conversationmessagedto.md -->

# ConversationMessageDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/support-agent/dto/chat.dto.ts` (line 5)

## Properties

| Property | Type |
|---|---|
| `role` | `string` |
| `content` | `string` |

<!-- source: function-createcoordinatoragent.md -->

# createCoordinatorAgent

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/agents/coordinator.agent.ts` (line 39)

Create the coordinator agent config.
Dependencies are injected — the agent config itself is a plain object.

## Signature

```ts
function createCoordinatorAgent(config: GenerationConfig, deps: CoordinatorDependencies): AgentConfig<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |
| `deps` | `CoordinatorDependencies` |

**Returns:** `AgentConfig<PmeContext>`

<!-- source: interface-customdomainview.md -->

# CustomDomainView

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/lib/api-client.ts` (line 58)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `domain` | `string` |
| `status` | `DomainStatus` |
| `records` | `DnsRecordSpec[]` |
| `lastError` | `string | null` |
| `lastCheckedAt` | `string | null` |
| `verifiedAt` | `string | null` |
| `createdAt` | `string` |

<!-- source: function-detectngrxeffects.md -->

# detectNgRxEffects

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ngrx-pattern-detector.ts` (line 480)

Detect NgRx effects from code

## Signature

```ts
function detectNgRxEffects(content: string): NgRxEffectPattern[]
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |

**Returns:** `NgRxEffectPattern[]`

<!-- source: function-entitiestonodes.md -->

# entitiesToNodes

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Graph/graphUtils.ts` (line 20)

Convert entities to React Flow nodes

## Signature

```ts
function entitiesToNodes(entities: KGEntity[]): Node<EntityNodeData>[]
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `KGEntity[]` |

**Returns:** `Node<EntityNodeData>[]`

<!-- source: type-entitytype.md -->

# EntityType

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 165)

## Definition

```ts
| 'CLASS'
  | 'FUNCTION'
  | 'COMPONENT' // React/Vue/Angular component
  | 'CONTROLLER' // API endpoint handler
  | 'SERVICE'
  | 'INTERFACE'
  | 'TYPE'
  | 'ENUM'
  | 'CONSTANT'
  | 'HOOK' // React hook
  | 'MIDDLEWARE'
  | 'MODULE'
```

<!-- source: controller-freshnesscontroller.md -->

# FreshnessController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/technical-docs/freshness.controller.ts` (line 14)

Owner "Docs freshness cockpit" — which published pages went stale when the project's
code changed (from technical_snapshots.staleInfo, written on every push by
TechnicalDocsService.checkStaleness). Org-scoped + member-gated, mirroring
ManualsInsightsController's authed surfaces. The public per-page reader badge lives
separately in ManualsInsightsController.freshness.

## Relationships

- MODULE_DECLARES → `stale`
- MODULE_DECLARES → `reshoot`
- DEPENDS_ON → `freshnessservice`

<!-- source: constant-gettingstartedtemplate.md -->

# gettingStartedTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/getting-started.template.ts` (line 3)

<!-- source: function-getvalidationerrors.md -->

# getValidationErrors

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 145)

Get all form validation errors

## Signature

```ts
async function getValidationErrors(page: Page): Promise<string[]>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |

**Returns:** `Promise<string[]>`

<!-- source: module-gitlabmodule.md -->

# GitLabModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/gitlab/gitlab.module.ts` (line 10)

## Relationships

- MODULE_IMPORTS → `configmodule`
- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_DECLARES → `gitlabcontroller`
- MODULE_PROVIDES → `gitlabservice`
- MODULE_EXPORTS → `gitlabservice`

<!-- source: component-howitworkscardsgrid.md -->

# HowItWorksCardsGrid

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/how-it-works/how-it-works-cards-grid.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `labelKey` | `string` | - | - |
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `steps` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_HowItWorksCardsGrid_77f322fc["HowItWorksCardsGrid"]
    class component_HowItWorksCardsGrid_77f322fc rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-span`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `StepIndicator`
- USES_HOOK → `useTranslation`

<!-- source: class-injectionturnhook.md -->

# InjectionTurnHook

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/session/injection-hook.ts` (line 15)

**Implements:** `TurnHook`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `enqueue` | `enqueue(message: string)` | `void` |
| `clear` | `clear()` | `void` |
| `updateTokenUsage` | `updateTokenUsage(inputTokens: number)` | `void` |
| `beforeModelCall` | `beforeModelCall(args: TurnHookArgs<TContext>)` | `Promise<{ instructions?: string; input?: AgentInputItem[] }>` |

<!-- source: function-issensitivefield.md -->

# isSensitiveField

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/capture/capture.redact.ts` (line 34)

True when the target element (by role/selector) implies a secret input.

## Signature

```ts
function isSensitiveField(hint: string | null): boolean
```

## Parameters

| Name | Type |
|---|---|
| `hint` | `string | null` |

**Returns:** `boolean`

<!-- source: interface-markdowndocentity.md -->

# MarkdownDocEntity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 853)

Markdown document entity

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.MARKDOWN_DOC` |
| `title` | `string` |
| `headings` | `HeadingInfo[]` |
| `codeBlocks` | `CodeBlockInfo[]` |
| `links` | `LinkInfo[]` |
| `frontMatter` | `Record<string, unknown>` |

<!-- source: interface-pricingplan.md -->

# PricingPlan

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/pricing/pricing-hero-card.tsx` (line 17)

## Properties

| Property | Type |
|---|---|
| `nameKey` | `string` |
| `priceKey` | `string` |
| `intervalKey` | `string` |
| `descriptionKey` | `string` |
| `features` | `PricingFeature[]` |
| `ctaKey` | `string` |
| `ctaUrl` | `string` |

<!-- source: interface-qadependencies.md -->

# QaDependencies

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/agents/qa.agent.ts` (line 16)

## Properties

| Property | Type |
|---|---|
| `renderAndCaptureFn` | `RenderAndCaptureFn` |

<!-- source: class-reactparser-2.md -->

# ReactParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/frontend/react.parser.ts` (line 95)

React Parser - Pure class implementation (no NestJS dependencies)

Works for both CLI (static) mode and cloud mode.

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `supportedPatterns` | `string[]` |

<!-- source: function-sessionsshowcommand.md -->

# sessionsShowCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/sessions.command.ts` (line 55)

## Signature

```ts
async function sessionsShowCommand(options: SessionsShowOptions): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `SessionsShowOptions` |

**Returns:** `Promise<void>`

<!-- source: class-stateresolutionconfigdto.md -->

# StateResolutionConfigDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 325)

Individual screenshot item DTO

Defines a single screenshot to capture with:
- Required: id, description, url (route), expectedState
- Optional: actions, viewport, edge case configs

## Properties

| Property | Type |
|---|---|
| `listUrl` | `string` |
| `statusColumnHint` | `string` |
| `targetStatusValue` | `string` |
| `maxRowsToScan` | `number` |
| `rowAction` | `'click' | 'dblclick'` |

<!-- source: component-tableofcontentssidebar.md -->

# TableOfContentsSidebar

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/table-of-contents.tsx` (line 44)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `tocItems` | `TOCItem[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TableOfContentsSidebar_19b83cbf["TableOfContentsSidebar"]
    class component_TableOfContentsSidebar_19b83cbf rootComponent
```

## Referenced By

- `TableOfContents` (RENDERS)

<!-- source: type-taskmode.md -->

# TaskMode

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/tools/tool-profiles.ts` (line 16)

Task-Specific Tool Profiles

Maps task modes to curated tool subsets. Reducing visible tools improves
accuracy — research shows accuracy drops from 96% → 25% as tool count
grows from 1 → 8 (Berkeley tool selection study, 2025).

Modes:
 - explore:   Read-only codebase investigation
 - plan:      Analysis + research, no writes
 - implement: Active coding — file edits, bash, rollback
 - review:    Code quality audit — read + analysis only
 - full:      All tools (default, current behavior)

## Definition

```ts
'explore' | 'plan' | 'implement' | 'review' | 'full'
```

<!-- source: constant-theme-presets.md -->

# THEME_PRESETS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/theme-presets.ts` (line 21)

## Definition

```ts
Record<string, { label: string; tokens: ThemeTokens }>
```

<!-- source: service-verifieragentservice.md -->

# VerifierAgentService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/verifier-agent.service.ts` (line 1)

<!-- source: type-viewmode.md -->

# ViewMode

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/components/Documents/ViewToggle.tsx` (line 5)

## Definition

```ts
'card' | 'list'
```

<!-- source: constant-angular-service-patterns.md -->

# ANGULAR_SERVICE_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/cross-language.types.ts` (line 280)

Service method detection patterns for Angular

<!-- source: interface-apiresponse.md -->

# APIResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/types/config.ts` (line 103)

Response wrapper

## Properties

| Property | Type |
|---|---|
| `data` | `T` |
| `status` | `number` |
| `headers` | `Headers` |

<!-- source: interface-awarenessupdatedata.md -->

# AwarenessUpdateData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/collaboration/interfaces/collaboration.interfaces.ts` (line 63)

Awareness update payload

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `awarenessUpdate` | `Uint8Array` |

<!-- source: component-boardlistcard.md -->

# BoardListCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/boards/page.tsx` (line 302)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `board` | `BoardSummary` | ✓ | - |
| `onSettings` | `Function` | ✓ | - |
| `onDuplicate` | `Function` | ✓ | - |
| `onDelete` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_BoardListCard_35986edf["BoardListCard"]
    class component_BoardListCard_35986edf rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `EllipsisHorizontalIcon`
- RENDERS → `MenuItem`
- RENDERS → `Cog6ToothIcon`
- RENDERS → `DocumentDuplicateIcon`
- RENDERS → `TrashIcon`
- USES_HOOK → `useState`

## Referenced By

- `BoardsIndexContent` (RENDERS)

<!-- source: api-endpoint-capturescreenshot-2.md -->

# captureScreenshot

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/screenshot/screenshot.controller.ts` (line 26)

## Endpoint

`POST /screenshots`

## Referenced By

- `ScreenshotController` (MODULE_DECLARES)

<!-- source: interface-checkpointbackend.md -->

# CheckpointBackend

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/checkpoint-backend.ts` (line 25)

<!-- source: class-checkpointerror.md -->

# CheckpointError

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/errors.ts` (line 150)

Error thrown when checkpoint save/load fails

**Extends:** `PipelineError`

## Properties

| Property | Type |
|---|---|
| `checkpointId` | `string` |
| `operation` | `'save' | 'load'` |

<!-- source: service-collaborationmetricsservice.md -->

# CollaborationMetricsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/collaboration/collaboration-metrics.service.ts` (line 28)

Service for tracking and reporting collaboration metrics

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleInit` | `onModuleInit()` | `void` |
| `onModuleDestroy` | `onModuleDestroy()` | `void` |
| `recordMetrics` | `recordMetrics(documentId: string, metrics: Partial<Omit<CollaborationMetrics, 'documentId'>>)` | `Promise<void>` |
| `recordSyncLatency` | `recordSyncLatency(documentId: string, latencyMs: number)` | `Promise<void>` |
| `recordActiveSessions` | `recordActiveSessions(documentId: string, count: number)` | `Promise<void>` |
| `getMetrics` | `getMetrics(documentId: string)` | `Promise<CollaborationMetrics | null>` |
| `getActiveSessions` | `getActiveSessions(documentId: string)` | `Promise<number>` |
| `getSyncLatency` | `getSyncLatency(documentId: string)` | `Promise<number>` |
| `getP95SyncLatency` | `getP95SyncLatency(documentId: string)` | `Promise<number>` |
| `getTotalActiveSessions` | `getTotalActiveSessions()` | `Promise<number>` |
| `getGlobalAverageSyncLatency` | `getGlobalAverageSyncLatency()` | `Promise<number>` |
| `clearMetrics` | `clearMetrics(documentId: string)` | `Promise<void>` |
| `getMetricsSummary` | `getMetricsSummary()` | `Promise<{
    totalActiveDocuments: number;
    totalActiveSessions: number;
    averageSyncLatencyMs: number;
    documentsAboveLatencyThreshold: number;
  }>` |

## Relationships

- DEPENDS_ON → `redisservice`

<!-- source: interface-controllerentity-2.md -->

# ControllerEntity

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 873)

Controller entity

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.CONTROLLER` |
| `basePath` | `string` |
| `guards` | `string[]` |
| `interceptors` | `string[]` |
| `endpoints` | `string[]` |
| `dependencies` | `DependencyInfo[]` |

<!-- source: function-controlormeta.md -->

# controlOrMeta

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/detectMac.ts` (line 14)

Returns true if the user is pressing the control key on Windows or the meta key on Mac.

## Signature

```ts
function controlOrMeta(metaKey: boolean, ctrlKey: boolean): boolean
```

## Parameters

| Name | Type |
|---|---|
| `metaKey` | `boolean` |
| `ctrlKey` | `boolean` |

**Returns:** `boolean`

<!-- source: function-cosinesimilarity.md -->

# cosineSimilarity

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/vector-store.ts` (line 32)

Compute cosine similarity between two vectors.
Returns 0 if either vector is zero-length or they differ in dimensionality.

## Signature

```ts
function cosineSimilarity(a: number[], b: number[]): number
```

## Parameters

| Name | Type |
|---|---|
| `a` | `number[]` |
| `b` | `number[]` |

**Returns:** `number`

<!-- source: class-createactivitydto.md -->

# CreateActivityDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/activity/dto/create-activity.dto.ts` (line 3)

## Properties

| Property | Type |
|---|---|
| `organizationId` | `string` |
| `projectId` | `string` |
| `userId` | `string` |
| `actionType` | `string` |
| `entityType` | `string` |
| `entityId` | `string` |
| `metadata` | `Record<string, any>` |

<!-- source: function-createcopywriteragent.md -->

# createCopywriterAgent

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/agents/copywriter.agent.ts` (line 20)

## Signature

```ts
function createCopywriterAgent(config: GenerationConfig, deps: CopywriterDependencies): AgentConfig<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |
| `deps` | `CopywriterDependencies` |

**Returns:** `AgentConfig<PmeContext>`

<!-- source: interface-dashboardlayoutprops.md -->

# DashboardLayoutProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Layout/DashboardLayout.tsx` (line 15)

Props for DashboardLayout

## Properties

| Property | Type |
|---|---|
| `children` | `ReactNode` |

<!-- source: function-detectngrxreducers.md -->

# detectNgRxReducers

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ngrx-pattern-detector.ts` (line 297)

Detect NgRx reducers from code

## Signature

```ts
function detectNgRxReducers(content: string): NgRxReducerPattern[]
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |

**Returns:** `NgRxReducerPattern[]`

<!-- source: type-errorcode.md -->

# ErrorCode

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 304)

## Definition

```ts
| 'PARSE_FAILED'
  | 'TOKEN_LIMIT_EXCEEDED'
  | 'AI_PROVIDER_ERROR'
  | 'CHECKPOINT_FAILED'
  | 'VERIFICATION_FAILED'
  | 'UPLOAD_FAILED'
  | 'TIMEOUT'
  | 'UNKNOWN'
```

<!-- source: function-filtergraphdata.md -->

# filterGraphData

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Graph/graphUtils.ts` (line 226)

Filter nodes and edges based on search query

## Signature

```ts
function filterGraphData(nodes: GraphNode[], edges: GraphEdge[], searchQuery: string): { nodes: GraphNode[]; edges: GraphEdge[] }
```

## Parameters

| Name | Type |
|---|---|
| `nodes` | `GraphNode[]` |
| `edges` | `GraphEdge[]` |
| `searchQuery` | `string` |

**Returns:** `{ nodes: GraphNode[]; edges: GraphEdge[] }`

<!-- source: controller-githubappcontroller.md -->

# GithubAppController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/github-app/github-app.controller.ts` (line 12)

GitHub App webhook receiver (Foundation F1). Handles installation lifecycle (the install
registry) and push events (delegates to the existing push pipeline: staleness fan-out +
optional auto-regen trigger). Verified by the APP's HMAC secret — one secret for all
customers, unlike per-project manual webhooks.

`GithubAppController` is the NestJS webhook receiver for the Atloria GitHub App (Foundation F1). It verifies incoming webhook requests using the GitHub App HMAC secret, manages the installation lifecycle via the install registry, and handles `push` events by delegating into the existing push pipeline (staleness fan-out and optional auto-regeneration triggers). This centralizes webhook handling under a single shared secret (per app) instead of per-project manual webhook secrets.

## Diagram

```mermaid
graph LR
  GH[GitHub App Webhooks] -->|HTTP POST + HMAC signature| C[GithubAppController]
  C --> V[HMAC Verification]
  V -->|invalid| R401[Reject 401/403]
  V -->|valid| D{Event type}
  D -->|installation / lifecycle| IR[Install Registry]
  D -->|push| PP[Push Pipeline]
  PP --> SF[Staleness Fan-out]
  PP --> AR[Optional Auto-Regen Trigger]
  IR --> OK[200 OK]
  AR --> OK
  SF --> OK
```

## Usage

```ts
import { Controller, Post, Headers, Body, Req, Res } from '@nestjs/common';
import type { Request, Response } from 'express';

// This shows how GithubAppController is typically used: it's mounted as a NestJS controller
// and receives GitHub App webhook POSTs. The verification + routing is handled inside.
@Controller('/github-app')
export class GithubAppController {
  @Post('/webhook')
  async webhook(
    @Headers('x-github-event') event: string,
    @Headers('x-hub-signature-256') signature: string,
    @Body() payload: any,
    @Req() req: Request,
    @Res() res: Response,
  ) {
    // Internally (in the real implementation):
    // 1) Verify signature using the GitHub App webhook secret
    // 2) If installation event: update install registry
    // 3) If push event: delegate to push pipeline (staleness fan-out, optional auto-regen)
    // 4) Return 2xx quickly to GitHub
    return res.status(200).send({ ok: true, event });
  }
}

// Example HTTP call (for local testing) using fetch:
async function sendTestWebhook() {
  await fetch('http://localhost:3000/github-app/webhook', {
    method: 'POST',
    headers: {
      'content-type': 'application/json',
      'x-github-event': 'push',
      // In real GitHub delivery this is computed HMAC SHA-256 of the raw request body:
      'x-hub-signature-256': 'sha256=...',
    },
    body: JSON.stringify({ ref: 'refs/heads/main', repository: { full_name: 'acme/repo' } }),
  });
}
```

## AI Coding Instructions

- Preserve **raw request body** access for HMAC validation; don’t JSON-transform/pretty-print before computing the signature or verification will fail.
- Keep webhook handlers **fast and idempotent**: acknowledge GitHub with 2xx quickly and push heavy work into the existing push pipeline/queues.
- Route by GitHub headers (`x-github-event`, delivery id) and ensure installation lifecycle events update the **install registry** consistently (handle install, uninstall, suspend/unsuspend).
- Treat the webhook secret as **app-wide** (not per project); avoid introducing per-customer secret branching unless the architecture changes explicitly.
- When adding new event types, follow the existing delegation pattern: controller validates + normalizes → service/pipeline performs domain work (staleness fan-out, auto-regen, etc.).

## Relationships

- MODULE_DECLARES → `handle`
- DEPENDS_ON → `githubappservice`
- DEPENDS_ON → `webhookservice`

<!-- source: constant-global-throttle.md -->

# GLOBAL_THROTTLE

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/common/throttling.module.ts` (line 17)

Global rate-limiting configuration.

- GLOBAL_THROTTLE: sane per-IP default applied to every HTTP route.
- AUTH_LOGIN_THROTTLE: strict limit on credential endpoints to slow
  brute-force attacks.
- PUBLIC_SSE_THROTTLE: strict per-IP quota on the public, unauthenticated
  SSE LLM endpoint (each request costs real AI tokens).

Values are exported so specs can assert the exact quotas the guard
enforces on real routes.

<!-- source: module-graphmodule.md -->

# GraphModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/graph/graph.module.ts` (line 17)

## Relationships

- MODULE_IMPORTS → `configmodule`
- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `aimodule`
- MODULE_DECLARES → `graphcontroller`
- MODULE_DECLARES → `kgsynccontroller`
- MODULE_PROVIDES → `neo4jservice`
- MODULE_PROVIDES → `knowledgegraphservice`
- MODULE_PROVIDES → `kgsyncservice`
- MODULE_PROVIDES → `entityextractorservice`
- MODULE_PROVIDES → `flowdetectorservice`
- MODULE_PROVIDES → `workflowdiscoveryservice`
- MODULE_PROVIDES → `workflowstorageservice`
- MODULE_EXPORTS → `neo4jservice`
- MODULE_EXPORTS → `knowledgegraphservice`
- MODULE_EXPORTS → `kgsyncservice`
- MODULE_EXPORTS → `entityextractorservice`
- MODULE_EXPORTS → `flowdetectorservice`
- MODULE_EXPORTS → `workflowdiscoveryservice`
- MODULE_EXPORTS → `workflowstorageservice`

<!-- source: component-howitworkshorizontal.md -->

# HowItWorksHorizontal

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/how-it-works/how-it-works-horizontal.tsx` (line 16)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `labelKey` | `string` | - | - |
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `steps` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_HowItWorksHorizontal_4c471783["HowItWorksHorizontal"]
    class component_HowItWorksHorizontal_4c471783 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-span`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `StepIndicator`
- USES_HOOK → `useTranslation`

<!-- source: class-instructionloader.md -->

# InstructionLoader

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/instruction-loader.ts` (line 99)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `addPersistent` | `addPersistent(layer: InstructionLayer)` | `void` |
| `removePersistent` | `removePersistent(id: string)` | `void` |
| `addTurn` | `addTurn(layer: InstructionLayer)` | `void` |
| `getInstructions` | `getInstructions(_context: RunContext<TContext>)` | `string` |
| `createDynamicInstructions` | `createDynamicInstructions()` | `(context: RunContext<TContext>) => string` |
| `addConditional` | `addConditional(layer: ConditionalLayer)` | `void` |
| `removeConditional` | `removeConditional(id: string)` | `void` |
| `setActiveTools` | `setActiveTools(toolNames: string[])` | `void` |
| `hasActiveTool` | `hasActiveTool(name: string)` | `boolean` |
| `addToZone` | `addToZone(zone: InstructionZone, layer: Omit<InstructionLayer, 'priority'>, offset: undefined)` | `void` |
| `discover` | `discover(rootDir: string, options: DiscoveryOptions)` | `DiscoveredInstruction[]` |
| `loadFromDirectory` | `loadFromDirectory(rootDir: string, options: DiscoveryOptions)` | `DiscoveredInstruction[]` |

<!-- source: function-issensitivevalue.md -->

# isSensitiveValue

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/capture/capture.redact.ts` (line 28)

True when a value looks like a secret and must never be stored.

## Signature

```ts
function isSensitiveValue(value: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `value` | `string` |

**Returns:** `boolean`

<!-- source: function-isvisible.md -->

# isVisible

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 54)

Check if an element is visible

## Signature

```ts
async function isVisible(page: Page, selector: string): Promise<boolean>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |
| `selector` | `string` |

**Returns:** `Promise<boolean>`

<!-- source: interface-methoddefinition.md -->

# MethodDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 767)

Method definition

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `returnType` | `string` |
| `parameters` | `ParameterDefinition[]` |
| `isAsync` | `boolean` |
| `description` | `string` |
| `decorators` | `string[]` |

<!-- source: interface-pricingtiercardprops.md -->

# PricingTierCardProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/pricing-tier-card.tsx` (line 18)

## Properties

| Property | Type |
|---|---|
| `nameKey` | `string` |
| `priceKey` | `string` |
| `intervalKey` | `string` |
| `descriptionKey` | `string` |
| `features` | `PricingFeature[]` |
| `ctaKey` | `string` |
| `ctaUrl` | `string` |
| `highlighted` | `boolean` |
| `badgeKey` | `string` |

<!-- source: interface-qaresult.md -->

# QaResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/tools/visual-qa.tool.ts` (line 30)

## Properties

| Property | Type |
|---|---|
| `screenshots` | `QaScreenshot[]` |
| `renderTimeMs` | `number` |

<!-- source: class-searchindexgenerator.md -->

# SearchIndexGenerator

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/search-index.generator.ts` (line 81)

Search index generator

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate(entities: Entity[], version: string, options: SearchIndexOptions)` | `SearchIndex` |
| `generateJSON` | `generateJSON(index: SearchIndex, pretty: undefined)` | `string` |
| `search` | `search(index: SearchIndex, query: string, limit: undefined)` | `SearchIndexEntry[]` |

<!-- source: function-synccommand.md -->

# syncCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/sync.command.ts` (line 29)

Sync command handler
Reads existing documentation output and syncs to API

## Signature

```ts
async function syncCommand(options: SyncOptions): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `SyncOptions` |

**Returns:** `Promise<void>`

<!-- source: class-takeauthenticatedscreenshotdto.md -->

# TakeAuthenticatedScreenshotDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.controller.ts` (line 91)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `capturedBy` | `string` |
| `auth` | `AuthConfigDto` |
| `viewport` | `{ width: number; height: number }` |
| `fullPage` | `boolean` |
| `waitForSelector` | `string` |
| `browser` | `'chromium' | 'firefox' | 'webkit'` |

<!-- source: constant-ticket-type-cfg.md -->

# TICKET_TYPE_CFG

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 117)

## Definition

```ts
Record<string, { bg: string; text: string; label: string }>
```

<!-- source: component-timelinedot-2.md -->

# TimelineDot

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/social-proof/social-proof-timeline.tsx` (line 37)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `variant` | `unknown | unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TimelineDot_50dd9318["TimelineDot"]
    class component_TimelineDot_50dd9318 rootComponent
```

## Referenced By

- `SocialProofTimeline` (RENDERS)

<!-- source: type-toolpreexecutionhook.md -->

# ToolPreExecutionHook

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 397)

Called BEFORE a tool executes. Can block execution entirely and return
an error/guidance message instead — the tool never runs.

This enables hard tool blocking (e.g., plan mode) where write tools
are genuinely prevented from executing, matching Claude Code's behavior.

Return `undefined` or `null` to allow execution.
Return a string to BLOCK execution and use that string as the tool output.

## Definition

```ts
(
  toolName: string,
  toolInput: string,
) => string | null | undefined | Promise<string | null | undefined>
```

<!-- source: service-verifierservice.md -->

# VerifierService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/verifier.service.ts` (line 1)

<!-- source: type-wizardscene.md -->

# WizardScene

**Kind:** Type

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/useNewProjectWizard.ts` (line 5)

## Definition

```ts
'url-input' | 'project-details' | 'connect-provider' | 'browse-repos' | 'doc-types' | 'generation'
```

<!-- source: constant-angular-template-patterns.md -->

# ANGULAR_TEMPLATE_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/angular.patterns.ts` (line 54)

<!-- source: interface-apiresponse-2.md -->

# APIResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/ResponsePanel.ts` (line 8)

## Properties

| Property | Type |
|---|---|
| `status` | `number` |
| `statusText` | `string` |
| `headers` | `Record<string, string>` |
| `body` | `any` |
| `time` | `number` |
| `size` | `number` |

<!-- source: component-boardpagecontent.md -->

# BoardPageContent

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/boards/[boardId]/page.tsx` (line 61)

## Diagram

```mermaid
graph TD
    component_BoardPageContent_62371551["BoardPageContent"]
    class component_BoardPageContent_62371551 rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `ArrowLeftIcon`
- RENDERS → `BoardFiltersButton`
- RENDERS → `PlusIcon`
- RENDERS → `Cog6ToothIcon`
- RENDERS → `ArrowPathIcon`
- RENDERS → `ActiveFilterChips`
- RENDERS → `BoardView`
- RENDERS → `BoardSettingsDialog`
- RENDERS → `AddIssuesToBoardDialog`
- RENDERS → `ColumnEditor`
- USES_HOOK → `useParams`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useMemo`
- USES_HOOK → `useCallback`

## Referenced By

- `BoardPage` (RENDERS)

<!-- source: interface-brandedemailoptions.md -->

# BrandedEmailOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/email/email-template.ts` (line 9)

Branded transactional-email layout — ONE look for every platform email.

Email-client-safe by construction: table layout, fully inline styles, solid
colors (no CSS vars/flex/grid), 600px column, bulletproof button. Callers pass
content; this owns the chrome (wordmark bar, card, footer).

## Properties

| Property | Type |
|---|---|
| `preheader` | `string` |
| `heading` | `string` |
| `bodyHtml` | `string` |
| `cta` | `{ label: string; url: string }` |
| `footerNote` | `string` |

<!-- source: api-endpoint-chat.md -->

# chat

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.controller.ts` (line 140)

## Endpoint

`POST /support-agent/:projectId/agents/:agentId/chat`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `agentId` | query | `string` | ✓ |

## Referenced By

- `SupportAgentController` (MODULE_DECLARES)

<!-- source: interface-checkpointmanagerconfig.md -->

# CheckpointManagerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/checkpoint-manager.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `maxSnapshotsPerFile` | `number` |
| `maxTotalSnapshots` | `number` |
| `backend` | `CheckpointBackend` |

<!-- source: class-checkpointservice.md -->

# CheckpointService

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/pipeline/checkpoint.ts` (line 27)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `save` | `save(jobState: JobState, stageData: Record<string, unknown>)` | `Promise<string>` |
| `load` | `load(jobId: string)` | `Promise<CheckpointData | null>` |
| `exists` | `exists(jobId: string)` | `Promise<boolean>` |
| `delete` | `delete(jobId: string)` | `Promise<void>` |
| `startAutoSave` | `startAutoSave(getState: () => { jobState: JobState; stageData: Record<string, unknown> })` | `void` |
| `stopAutoSave` | `stopAutoSave()` | `void` |
| `listJobs` | `listJobs()` | `Promise<string[]>` |
| `getHistory` | `getHistory(jobId: string)` | `Promise<{ path: string; timestamp: Date }[]>` |

<!-- source: service-collaborationservice.md -->

# CollaborationService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/collaboration/collaboration.service.ts` (line 36)

Service for managing collaboration sessions and document persistence

## Methods

| Method | Signature | Returns |
|---|---|---|
| `verifyDocumentAccess` | `verifyDocumentAccess(documentId: string, userId: string)` | `Promise<boolean>` |
| `getDocumentContent` | `getDocumentContent(documentId: string)` | `Promise<string | null>` |
| `getCurrentVersion` | `getCurrentVersion(documentId: string)` | `Promise<number>` |
| `getNextVersion` | `getNextVersion(documentId: string)` | `Promise<number>` |
| `saveDocumentState` | `saveDocumentState(documentId: string, content: string)` | `Promise<SaveDocumentResult>` |
| `createSession` | `createSession(documentId: string, userId: string)` | `Promise<void>` |
| `endSession` | `endSession(documentId: string, userId: string)` | `Promise<void>` |
| `updateSessionActivity` | `updateSessionActivity(documentId: string, userId: string)` | `Promise<void>` |
| `getActiveUsers` | `getActiveUsers(documentId: string)` | `Promise<CollaborationUser[]>` |
| `getSessionCount` | `getSessionCount(documentId: string)` | `Promise<number>` |
| `updateCursorPosition` | `updateCursorPosition(documentId: string, userId: string, cursorPosition: number, selectionStart: number, selectionEnd: number)` | `Promise<void>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `redisservice`

<!-- source: function-convertspecstomappings.md -->

# convertSpecsToMappings

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/spec-to-mapping-converter.ts` (line 81)

Convert an array of ScreenshotSpecs into ScreenshotMappings.

## Signature

```ts
function convertSpecsToMappings(specs: ScreenshotSpec[]): ScreenshotMapping[]
```

## Parameters

| Name | Type |
|---|---|
| `specs` | `ScreenshotSpec[]` |

**Returns:** `ScreenshotMapping[]`

<!-- source: interface-coveragecolorscheme.md -->

# CoverageColorScheme

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/state-machine-diagram.generator.ts` (line 24)

Color scheme for coverage visualization

## Properties

| Property | Type |
|---|---|
| `covered` | `string` |
| `partial` | `string` |
| `uncovered` | `string` |
| `unknown` | `string` |

<!-- source: function-createapplypatchtool.md -->

# createApplyPatchTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/apply-patch.tool.ts` (line 654)

Create an `apply_patch` tool definition.

This tool accepts a patch in the Codex `apply_patch` format and applies
it to the filesystem. It supports creating, updating, and deleting files
in a single patch, with fuzzy context matching for reliable hunk application.

## Signature

```ts
function createApplyPatchTool(options: ApplyPatchOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `ApplyPatchOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: class-createaudiencedto.md -->

# CreateAudienceDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/audience/dto/create-audience.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `color` | `string` |
| `icon` | `string` |
| `description` | `string` |

<!-- source: function-createfindscreenshotstool.md -->

# createFindScreenshotsTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/find-screenshots.tool.ts` (line 26)

## Signature

```ts
function createFindScreenshotsTool(findFn: FindScreenshotsFn): ToolDefinition<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `findFn` | `FindScreenshotsFn` |

**Returns:** `ToolDefinition<PmeContext>`

<!-- source: interface-dependencygraphprops.md -->

# DependencyGraphProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Parser/DependencyGraph.tsx` (line 5)

## Properties

| Property | Type |
|---|---|
| `dependencies` | `Dependency[]` |
| `className` | `string` |

<!-- source: function-detectngrxselectors.md -->

# detectNgRxSelectors

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ngrx-pattern-detector.ts` (line 415)

Detect NgRx selectors from code

## Signature

```ts
function detectNgRxSelectors(content: string): NgRxSelectorPattern[]
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |

**Returns:** `NgRxSelectorPattern[]`

<!-- source: type-errorinterceptor.md -->

# ErrorInterceptor

**Kind:** Type

**Source:** `atloria-monorepo/packages/api-client/src/types/config.ts` (line 120)

## Definition

```ts
(error: Error) => Error | Promise<Error>
```

<!-- source: function-findcolumnofcard.md -->

# findColumnOfCard

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 181)

Find the column containing a card, by id

## Signature

```ts
function findColumnOfCard(board: BoardData, cardId: string): BoardColumnData | null
```

## Parameters

| Name | Type |
|---|---|
| `board` | `BoardData` |
| `cardId` | `string` |

**Returns:** `BoardColumnData | null`

<!-- source: controller-githubcontroller.md -->

# GitHubController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/github/github.controller.ts` (line 10)

## Relationships

- MODULE_DECLARES → `getAuthUrl`
- MODULE_DECLARES → `handleCallback`
- MODULE_DECLARES → `getStatus`
- MODULE_DECLARES → `listRepos`
- MODULE_DECLARES → `listBranches`
- MODULE_DECLARES → `disconnect`
- DEPENDS_ON → `githubservice`

<!-- source: constant-graphqlapitemplate.md -->

# graphqlApiTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/graphql-api.template.ts` (line 3)

<!-- source: component-howitworkstimeline.md -->

# HowItWorksTimeline

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/how-it-works/how-it-works-timeline.tsx` (line 59)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `steps` | `Step[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_HowItWorksTimeline_61216c09["HowItWorksTimeline"]
    class component_HowItWorksTimeline_61216c09 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `StepCircle`
- RENDERS → `StepCard`
- USES_HOOK → `useTranslation`

<!-- source: module-invitationmodule.md -->

# InvitationModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/invitation/invitation.module.ts` (line 10)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `emailmodule`
- MODULE_IMPORTS → `configmodule`
- MODULE_DECLARES → `invitationcontroller`
- MODULE_PROVIDES → `invitationservice`
- MODULE_EXPORTS → `invitationservice`

<!-- source: class-jsonstore.md -->

# JsonStore

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/memory/json-store.ts` (line 33)

**Implements:** `MemoryStore`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `save` | `save(record: MemoryRecord)` | `void` |
| `load` | `load(id: string)` | `MemoryRecord | null` |
| `query` | `query(query: MemoryQuery)` | `MemoryRecord[]` |
| `delete` | `delete(id: string)` | `boolean` |
| `getAll` | `getAll(projectId: string)` | `MemoryRecord[]` |
| `count` | `count(projectId: string)` | `number` |
| `touch` | `touch(id: string)` | `void` |

<!-- source: function-lookupcountry.md -->

# lookupCountry

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/analytics/utils/tracking-utils.ts` (line 176)

Resolve a client IP to a 2-letter ISO country code using the bundled
MaxMind GeoLite2 database (via `geoip-lite`). This is the same approach
Umami, Plausible, and Matomo all use for server-side geolocation.

Returns null for:
  - localhost / private IPs (127.*, 10.*, 192.168.*, etc.)
  - IPs not found in the database
  - malformed inputs

The GeoLite2 database is loaded into RAM once at startup (~2MB). All
subsequent lookups are pure memory reads — sub-microsecond latency.

## Signature

```ts
function lookupCountry(ip: string | null): string | null
```

## Parameters

| Name | Type |
|---|---|
| `ip` | `string | null` |

**Returns:** `string | null`

<!-- source: function-measuretimetointeractive.md -->

# measureTimeToInteractive

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/performance.ts` (line 224)

Measure time to interactive

## Signature

```ts
async function measureTimeToInteractive(page: Page): Promise<number>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |

**Returns:** `Promise<number>`

<!-- source: interface-moduleentity.md -->

# ModuleEntity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 812)

Module entity (NestJS, Angular)

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.MODULE` |
| `imports` | `string[]` |
| `controllers` | `string[]` |
| `providers` | `string[]` |
| `exports` | `string[]` |
| `isGlobal` | `boolean` |

<!-- source: interface-problemsplitvisualprops.md -->

# ProblemSplitVisualProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/problem/problem-split-visual.tsx` (line 19)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `problems` | `Problem[]` |
| `imageSrc` | `string` |
| `imageAlt` | `string` |
| `imagePosition` | `'start' | 'end'` |

<!-- source: interface-qascreenshot.md -->

# QaScreenshot

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/tools/visual-qa.tool.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `viewport` | `string` |
| `width` | `number` |
| `height` | `number` |
| `screenshotBase64` | `string` |

<!-- source: class-sequelizeparser-2.md -->

# SequelizeParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/database/sequelize.parser.ts` (line 32)

Sequelize Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: class-takebatchscreenshotsdto.md -->

# TakeBatchScreenshotsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 617)

Main batch screenshot request DTO

Combines all configuration for a batch screenshot job:
- Multi-tenancy identifiers (projectId, organizationId, capturedBy)
- Optional batch metadata (name, description)
- Optional authentication configuration
- Required screenshots array (minimum 1 item)
- Optional batch configuration

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `organizationId` | `string` |
| `capturedBy` | `string` |
| `name` | `string` |
| `description` | `string` |
| `auth` | `BatchAuthConfigDto` |
| `screenshots` | `BatchScreenshotItemDto[]` |
| `config` | `BatchConfigDto` |
| `runDiscovery` | `boolean` |
| `discoverySiteUrl` | `string` |

<!-- source: constant-ticket-type-cfg-2.md -->

# TICKET_TYPE_CFG

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 25)

## Definition

```ts
Record<
  string,
  { bg: string; text: string; label: string }
>
```

<!-- source: type-toolverificationhook.md -->

# ToolVerificationHook

**Kind:** Type

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 377)

Called after a tool executes. Can block the tool output from reaching the
model and inject corrective feedback instead.

Inspired by Claude Code's hooks system (exit code 2 = block + correct).

Return `null` to pass through normally.
Return a string to REPLACE the tool output with corrective feedback.

## Definition

```ts
(
  toolName: string,
  toolInput: string,
  toolOutput: string,
) => string | null | Promise<string | null>
```

<!-- source: function-triggercommand.md -->

# triggerCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/trigger.command.ts` (line 26)

## Signature

```ts
async function triggerCommand(options: TriggerOptions): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `TriggerOptions` |

**Returns:** `Promise<void>`

<!-- source: service-workercapturerservice.md -->

# WorkerCapturerService

**Kind:** Service

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/worker-capturer.service.ts` (line 1)

<!-- source: component-youtubebutton.md -->

# YouTubeButton

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/directives.tsx` (line 64)

## Diagram

```mermaid
graph TD
    component_YouTubeButton_62e9bfd4["YouTubeButton"]
    class component_YouTubeButton_62e9bfd4 rootComponent
```

## Relationships

- RENDERS → `DialogButton`
- USES_HOOK → `usePublisher`

## Referenced By

- `Youtube` (RENDERS)

<!-- source: component-accordionitem-3.md -->

# AccordionItem

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/accordion-item.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `questionKey` | `string` | ✓ | - |
| `answerKey` | `string` | ✓ | - |
| `defaultOpen` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_AccordionItem_5fc5ba74["AccordionItem"]
    class component_AccordionItem_5fc5ba74 rootComponent
```

## Relationships

- RENDERS → `ChevronDown`
- RENDERS → `AnimatePresence`
- RENDERS → `motion-div`
- USES_HOOK → `useTranslation`
- USES_HOOK → `useState`

<!-- source: constant-antd-component-patterns.md -->

# ANTD_COMPONENT_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/antd.patterns.ts` (line 11)

Ant Design Pattern Detection

Patterns for detecting Ant Design components, forms, and tables.

<!-- source: interface-applicationprofile.md -->

# ApplicationProfile

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-05-synthesis/synthesizer.service.ts` (line 33)

## Properties

| Property | Type |
|---|---|
| `domain` | `string` |
| `moduleAreas` | `string[]` |
| `description` | `string` |

<!-- source: component-boardsindexcontent.md -->

# BoardsIndexContent

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/boards/page.tsx` (line 70)

## Diagram

```mermaid
graph TD
    component_BoardsIndexContent_56ce5809["BoardsIndexContent"]
    class component_BoardsIndexContent_56ce5809 rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `ArrowLeftIcon`
- RENDERS → `IssuesViewTabs`
- RENDERS → `ViewColumnsIcon`
- RENDERS → `PlusIcon`
- RENDERS → `ArrowPathIcon`
- RENDERS → `BoardListCard`
- RENDERS → `CreateBoardDialog`
- RENDERS → `BoardSettingsDialog`
- RENDERS → `DeleteBoardDialog`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`
- USES_HOOK → `useMemo`

## Referenced By

- `BoardsIndexPage` (RENDERS)

<!-- source: interface-bulkoperationresult.md -->

# BulkOperationResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/dto/bulk-operations.dto.ts` (line 99)

Result of bulk operation

## Properties

| Property | Type |
|---|---|
| `success` | `number` |
| `failed` | `number` |
| `errors` | `Array<{
    documentId: string;
    error: string;
  }>` |

<!-- source: api-endpoint-chatstream.md -->

# chatStream

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.controller.ts` (line 179)

## Endpoint

`POST /support-agent/:projectId/agents/:agentId/chat-stream`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `agentId` | query | `string` | ✓ |

## Referenced By

- `SupportAgentController` (MODULE_DECLARES)

<!-- source: interface-circledetectionresult.md -->

# CircleDetectionResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/circle-detector.ts` (line 53)

## Properties

| Property | Type |
|---|---|
| `confidence` | `number` |
| `isStuck` | `boolean` |
| `message` | `string` |
| `signals` | `CircleSignal[]` |

<!-- source: class-claudeprovider.md -->

# ClaudeProvider

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/claude.provider.ts` (line 205)

**Implements:** `AIProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate(prompt: string, options: ClaudeGenerateOptions, stage: JobStage)` | `Promise<ClaudeResponse>` |
| `generateWithStreaming` | `generateWithStreaming(prompt: string, options: ClaudeGenerateOptions, stage: JobStage)` | `Promise<ClaudeResponse>` |
| `generateText` | `generateText(prompt: string, options: Omit<ClaudeGenerateOptions, 'messages'>, stage: JobStage)` | `Promise<string>` |
| `generateJSON` | `generateJSON(prompt: string, options: ClaudeGenerateOptions, stage: JobStage)` | `Promise<{ data: T; response: ClaudeResponse }>` |
| `generateWithStructuredOutput` | `generateWithStructuredOutput(options: {
    prompt: string;
    schema: object;
    model?: string;
    maxTokens?: number;
  })` | `Promise<{ content: T; usage: { inputTokens: number; outputTokens: number } }>` |
| `isAvailable` | `isAvailable()` | `Promise<boolean>` |
| `getThrottlingStatus` | `getThrottlingStatus()` | `{ consecutiveFailures: number; adaptiveDelayMs: number; lastFailureTime: number }` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |

<!-- source: service-commentservice.md -->

# CommentService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/comment/comment.service.ts` (line 14)

Service for managing document comments with threading,

## Methods

| Method | Signature | Returns |
|---|---|---|
| `create` | `create(documentId: string, dto: CreateCommentDto, user: JwtPayload)` | `unknown` |
| `list` | `list(documentId: string, filters: CommentFiltersDto)` | `unknown` |
| `update` | `update(id: string, dto: UpdateCommentDto, user: JwtPayload)` | `unknown` |
| `delete` | `delete(id: string, user: JwtPayload, isAdmin: unknown)` | `unknown` |
| `resolve` | `resolve(id: string, user: JwtPayload)` | `unknown` |
| `unresolve` | `unresolve(id: string, user: JwtPayload)` | `unknown` |
| `addReply` | `addReply(commentId: string, dto: CreateReplyDto, user: JwtPayload)` | `unknown` |
| `getById` | `getById(id: string)` | `unknown` |
| `extractMentions` | `extractMentions(content: string)` | `string[]` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `documentgateway`
- DEPENDS_ON → `activityservice`
- DEPENDS_ON → `notificationservice`

<!-- source: function-convertspecstomappingsflattened.md -->

# convertSpecsToMappingsFlattened

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/spec-to-mapping-converter.ts` (line 92)

Convert specs to mappings, flattening workflow sequences into individual
step mappings. Each step gets its own mapping with `parentPlaceholderId`
and `sequenceOrder` so the replacer can reassemble them.

## Signature

```ts
function convertSpecsToMappingsFlattened(specs: ScreenshotSpec[]): ScreenshotMapping[]
```

## Parameters

| Name | Type |
|---|---|
| `specs` | `ScreenshotSpec[]` |

**Returns:** `ScreenshotMapping[]`

<!-- source: interface-coveragereport.md -->

# CoverageReport

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/coverage-calculator.ts` (line 98)

Overall coverage report

## Properties

| Property | Type |
|---|---|
| `overallStateCoverage` | `number` |
| `overallTransitionCoverage` | `number` |
| `stateMachines` | `StateMachineCoverage[]` |
| `totalScreenshots` | `number` |
| `totalInteractions` | `number` |
| `recommendedScreenshotCount` | `number` |
| `recommendations` | `string[]` |
| `qualityScore` | `number` |

<!-- source: function-createbashtool.md -->

# createBashTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/bash.tool.ts` (line 84)

## Signature

```ts
function createBashTool(options: BashToolOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `BashToolOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: class-createboarddto.md -->

# CreateBoardDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/boards/dto/create-board.dto.ts` (line 5)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `color` | `string` |
| `templateColumns` | `BoardTemplate` |
| `seedFromIssues` | `boolean` |
| `duplicateFromBoardId` | `string` |
| `includeCards` | `boolean` |

<!-- source: function-creategeneratecontenttool.md -->

# createGenerateContentTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/generate-content.tool.ts` (line 22)

## Signature

```ts
function createGenerateContentTool(generateFn: ContentGenerateFn): ToolDefinition<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `generateFn` | `ContentGenerateFn` |

**Returns:** `ToolDefinition<PmeContext>`

<!-- source: interface-deskactivity.md -->

# DeskActivity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 53)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `action` | `string` |
| `fromValue` | `string | null` |
| `toValue` | `string | null` |
| `actorName` | `string | null` |
| `label` | `string` |
| `createdAt` | `string` |
| `local` | `boolean` |

<!-- source: function-detectpiniaactions.md -->

# detectPiniaActions

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/pinia-pattern-detector.ts` (line 389)

Detect Pinia actions from stores

## Signature

```ts
function detectPiniaActions(stores: PiniaStorePattern[]): PiniaActionPattern[]
```

## Parameters

| Name | Type |
|---|---|
| `stores` | `PiniaStorePattern[]` |

**Returns:** `PiniaActionPattern[]`

<!-- source: type-explorermode.md -->

# ExplorerMode

**Kind:** Type

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/APIExplorer.ts` (line 61)

## Definition

```ts
'documentation' | 'playground'
```

<!-- source: function-formatdelta.md -->

# formatDelta

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/formatters.ts` (line 26)

## Signature

```ts
function formatDelta(current: number | null | undefined, previous: number | null | undefined): { text: string; direction: 'up' | 'down' | 'flat' }
```

## Parameters

| Name | Type |
|---|---|
| `current` | `number | null | undefined` |
| `previous` | `number | null | undefined` |

**Returns:** `{ text: string; direction: 'up' | 'down' | 'flat' }`

<!-- source: controller-gitlabcontroller.md -->

# GitLabController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/gitlab/gitlab.controller.ts` (line 10)

## Relationships

- MODULE_DECLARES → `getAuthUrl`
- MODULE_DECLARES → `handleCallback`
- MODULE_DECLARES → `getStatus`
- MODULE_DECLARES → `listRepos`
- MODULE_DECLARES → `listBranches`
- MODULE_DECLARES → `disconnect`
- DEPENDS_ON → `gitlabservice`

<!-- source: constant-integrationspectemplate.md -->

# integrationSpecTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/integration-spec.template.ts` (line 3)

<!-- source: module-issuesmodule.md -->

# IssuesModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/issues/issues.module.ts` (line 13)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `emailmodule`
- MODULE_IMPORTS → `eventsmodule`
- MODULE_DECLARES → `issuescontroller`
- MODULE_DECLARES → `publicissuescontroller`
- MODULE_DECLARES → `deskcontroller`
- MODULE_PROVIDES → `issuesservice`
- MODULE_PROVIDES → `deskservice`
- MODULE_EXPORTS → `issuesservice`

<!-- source: class-lastnobservationsprocessor.md -->

# LastNObservationsProcessor

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/history-processors.ts` (line 127)

Keeps the last N tool outputs in full detail.
Older ones are replaced with extractive summaries.

Directly extracted from the existing elideOldObservations() function
in autonomous-loop.ts — same logic, now composable.

SWE-agent default: n=5.

**Implements:** `HistoryProcessor`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `process` | `process(items: AgentInputItem[])` | `AgentInputItem[]` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |

<!-- source: function-mdtonotionblocks.md -->

# mdToNotionBlocks

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/md-to-notion-blocks.ts` (line 61)

## Signature

```ts
function mdToNotionBlocks(md: string): NotionBlock[]
```

## Parameters

| Name | Type |
|---|---|
| `md` | `string` |

**Returns:** `NotionBlock[]`

<!-- source: function-mockapiresponse.md -->

# mockAPIResponse

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 165)

Intercept and mock API responses

## Signature

```ts
async function mockAPIResponse(page: Page, urlPattern: string | RegExp, response: {
    status?: number;
    body?: unknown;
    headers?: Record<string, string>;
  }): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |
| `urlPattern` | `string | RegExp` |
| `response` | `{
    status?: number;
    body?: unknown;
    headers?: Record<string, string>;
  }` |

**Returns:** `Promise<void>`

<!-- source: interface-neo4jconfig.md -->

# Neo4jConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/config.interface.ts` (line 46)

Neo4j configuration

## Properties

| Property | Type |
|---|---|
| `uri` | `string` |
| `user` | `string` |
| `password` | `string` |
| `database` | `string` |
| `maxConnectionPoolSize` | `number` |
| `connectionTimeout` | `number` |

<!-- source: component-pricingcolumns.md -->

# PricingColumns

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/pricing/pricing-columns.tsx` (line 27)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `labelKey` | `string` | - | - |
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `tiers` | `PricingTier[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PricingColumns_1eeb178a["PricingColumns"]
    class component_PricingColumns_1eeb178a rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-span`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `PricingTierCard`
- USES_HOOK → `useTranslation`

<!-- source: interface-productaudience.md -->

# ProductAudience

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 217)

A target audience defined for the project's documentation.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `documentCount` | `number` |

<!-- source: interface-resolvedtheme.md -->

# ResolvedTheme

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/tools/theme.ts` (line 31)

## Properties

| Property | Type |
|---|---|
| `mode` | `ThemeMode` |
| `vars` | `ThemeVars` |
| `fontFamily` | `string` |
| `primaryColor` | `string` |

<!-- source: class-takeresponsivescreenshotsdto.md -->

# TakeResponsiveScreenshotsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.controller.ts` (line 53)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `capturedBy` | `string` |

<!-- source: constant-time-periods.md -->

# TIME_PERIODS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/TimePeriodSelector.tsx` (line 5)

## Definition

```ts
{ label: string; value: TimePeriod }[]
```

<!-- source: class-typeormparser-2.md -->

# TypeORMParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/database/typeorm.parser.ts` (line 70)

TypeORM Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: function-validatecoveragecommand.md -->

# validateCoverageCommand

**Kind:** Function

**Source:** `atloria-monorepo/apps/cli/src/commands/validate-coverage.command.ts` (line 113)

Execute coverage validation

## Signature

```ts
async function validateCoverageCommand(options: ValidateCoverageOptions): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `ValidateCoverageOptions` |

**Returns:** `Promise<void>`

<!-- source: component-admonitions.md -->

# Admonitions

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/directives.tsx` (line 148)

## Diagram

```mermaid
graph TD
    component_Admonitions_21c8a80a["Admonitions"]
    class component_Admonitions_21c8a80a rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`

<!-- source: constant-antd-detection-config.md -->

# ANTD_DETECTION_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/antd.patterns.ts` (line 285)

## Definition

```ts
AntdDetectionConfig
```

<!-- source: interface-applicationprofile-2.md -->

# ApplicationProfile

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-06-structure/structure.service.ts` (line 31)

## Properties

| Property | Type |
|---|---|
| `domain` | `string` |
| `moduleAreas` | `string[]` |
| `description` | `string` |

<!-- source: component-branchpickermodal.md -->

# BranchPickerModal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/scenes/SceneProjectDetails.tsx` (line 547)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `provider` | `unknown | unknown | unknown` | ✓ | - |
| `owner` | `string` | ✓ | - |
| `repo` | `string` | ✓ | - |
| `repoUrl` | `string` | ✓ | - |
| `currentBranch` | `string` | ✓ | - |
| `repoUsername` | `string` | - | - |
| `accessToken` | `string` | - | - |
| `onSelect` | `Function` | ✓ | - |
| `onClose` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_BranchPickerModal_72a5444f["BranchPickerModal"]
    class component_BranchPickerModal_72a5444f rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-svg`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useMemo`

## Referenced By

- `SceneProjectDetails` (RENDERS)

<!-- source: interface-businesscontext.md -->

# BusinessContext

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/services/business-context-parser.service.ts` (line 11)

Structured business context extracted from files

## Properties

| Property | Type |
|---|---|
| `productName` | `string` |
| `productType` | `string` |
| `description` | `string` |
| `features` | `Feature[]` |
| `workflows` | `WorkflowHint[]` |
| `terminology` | `Record<string, string>` |
| `urls` | `string[]` |
| `rawText` | `string` |

<!-- source: api-endpoint-checkcustomdomain.md -->

# checkCustomDomain

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 382)

## Endpoint

`POST /projects/:id/custom-domain/check`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: interface-circledetectoroptions.md -->

# CircleDetectorOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/circle-detector.ts` (line 16)

Circle/Loop Detector

Detects when an agent gets stuck in repetitive cycles:
editing the same files without progress, running the same
failing commands, or alternating between approaches.

Standalone class, consumed by AutonomousTurnHook.
Called every turn with O(windowSize) cost.

## Properties

| Property | Type |
|---|---|
| `windowSize` | `number` |
| `minTurnsBeforeDetection` | `number` |
| `signatureRepetitionThreshold` | `number` |
| `fileRepetitionThreshold` | `number` |
| `testStagnationCount` | `number` |

<!-- source: class-codeblocknode.md -->

# CodeBlockNode

**Kind:** Class

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/CodeBlockNode.tsx` (line 47)

**Extends:** `DecoratorNode`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getType` | `getType()` | `string` |
| `clone` | `clone(node: CodeBlockNode)` | `CodeBlockNode` |
| `importJSON` | `importJSON(serializedNode: SerializedCodeBlockNode)` | `CodeBlockNode` |
| `importDOM` | `importDOM()` | `DOMConversionMap` |
| `exportJSON` | `exportJSON()` | `SerializedCodeBlockNode` |
| `createDOM` | `createDOM(_config: EditorConfig)` | `HTMLDivElement` |
| `updateDOM` | `updateDOM()` | `false` |
| `getCode` | `getCode()` | `string` |
| `getMeta` | `getMeta()` | `string` |
| `getLanguage` | `getLanguage()` | `string` |
| `decorate` | `decorate(editor: LexicalEditor)` | `JSX.Element` |
| `isInline` | `isInline()` | `boolean` |

## Properties

| Property | Type |
|---|---|
| `__code` | `string` |
| `__meta` | `string` |
| `__language` | `string` |
| `__focusEmitter` | `any` |
| `setCode` | `any` |
| `setMeta` | `any` |
| `setLanguage` | `any` |
| `select` | `any` |

<!-- source: service-competitordiscoveryservice.md -->

# CompetitorDiscoveryService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/competitor-discovery.service.ts` (line 15)

Discovers competitor documentation using AI
No search APIs needed - Claude already knows!

## Methods

| Method | Signature | Returns |
|---|---|---|
| `discoverCompetitors` | `discoverCompetitors(projectDescription: string, projectType: string, limit: unknown)` | `Promise<CompetitorInfo[]>` |
| `getCompetitorsForType` | `getCompetitorsForType(projectType: string)` | `Promise<CompetitorInfo[]>` |
| `validateCompetitors` | `validateCompetitors(competitors: CompetitorInfo[])` | `CompetitorInfo[]` |

## Relationships

- DEPENDS_ON → `azureclaudeprovider`

<!-- source: function-convertspectomapping.md -->

# convertSpecToMapping

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/spec-to-mapping-converter.ts` (line 34)

Convert a single ScreenshotSpec into a ScreenshotMapping.

Translates captureType-specific metadata (modal, tab, form) into concrete
action sequences that the screenshot capturer can execute.

## Signature

```ts
function convertSpecToMapping(spec: ScreenshotSpec): ScreenshotMapping
```

## Parameters

| Name | Type |
|---|---|
| `spec` | `ScreenshotSpec` |

**Returns:** `ScreenshotMapping`

<!-- source: interface-coveragethresholds.md -->

# CoverageThresholds

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/coverage-validator.ts` (line 26)

Coverage validation thresholds

## Properties

| Property | Type |
|---|---|
| `minStateCoverage` | `number` |
| `minTransitionCoverage` | `number` |
| `minQualityScore` | `number` |
| `requireTerminalStatesCoverage` | `boolean` |
| `requireApprovalStatesCoverage` | `boolean` |

<!-- source: class-createcategorydto.md -->

# CreateCategoryDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/category.dto.ts` (line 7)

DTO for creating a new category

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `icon` | `string` |
| `color` | `string` |
| `projectId` | `string` |
| `parentId` | `string` |
| `defaultDocId` | `string` |
| `order` | `number` |
| `docVersionId` | `string` |

<!-- source: function-createchunkid.md -->

# createChunkId

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/types.ts` (line 79)

Create a deterministic chunk ID from file path, start line, and content.
Returns first 12 hex chars of a SHA-256 hash.

## Signature

```ts
function createChunkId(file: string, startLine: number, content: string): string
```

## Parameters

| Name | Type |
|---|---|
| `file` | `string` |
| `startLine` | `number` |
| `content` | `string` |

**Returns:** `string`

<!-- source: function-creategenerateimagetool.md -->

# createGenerateImageTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/generate-image.tool.ts` (line 28)

## Signature

```ts
function createGenerateImageTool(generateFn: ImageGenerateFn): ToolDefinition<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `generateFn` | `ImageGenerateFn` |

**Returns:** `ToolDefinition<PmeContext>`

<!-- source: interface-deskcomment.md -->

# DeskComment

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 43)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `body` | `string` |
| `isInternal` | `boolean` |
| `authorName` | `string | null` |
| `createdAt` | `string` |
| `pending` | `boolean` |

<!-- source: function-detectpiniagetters.md -->

# detectPiniaGetters

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/pinia-pattern-detector.ts` (line 446)

Detect Pinia getters from stores

## Signature

```ts
function detectPiniaGetters(stores: PiniaStorePattern[]): PiniaGetterPattern[]
```

## Parameters

| Name | Type |
|---|---|
| `stores` | `PiniaStorePattern[]` |

**Returns:** `PiniaGetterPattern[]`

<!-- source: type-explorermode-2.md -->

# ExplorerMode

**Kind:** Type

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/EndpointDetail.ts` (line 62)

## Definition

```ts
'documentation' | 'playground'
```

<!-- source: function-formatduration.md -->

# formatDuration

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/formatters.ts` (line 13)

## Signature

```ts
function formatDuration(seconds: number | null | undefined): string
```

## Parameters

| Name | Type |
|---|---|
| `seconds` | `number | null | undefined` |

**Returns:** `string`

<!-- source: controller-graphcontroller.md -->

# GraphController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/graph/graph.controller.ts` (line 19)

## Relationships

- MODULE_DECLARES → `createEntity`
- MODULE_DECLARES → `createRelation`
- MODULE_DECLARES → `getEntity`
- MODULE_DECLARES → `getRelated`
- MODULE_DECLARES → `getRelationships`
- MODULE_DECLARES → `findPath`
- MODULE_DECLARES → `search`
- MODULE_DECLARES → `extractEntities`
- MODULE_DECLARES → `detectFlow`
- MODULE_DECLARES → `detectImpact`
- MODULE_DECLARES → `getStatistics`
- MODULE_DECLARES → `deleteEntity`
- DEPENDS_ON → `knowledgegraphservice`
- DEPENDS_ON → `entityextractorservice`
- DEPENDS_ON → `flowdetectorservice`

<!-- source: constant-is-public-key.md -->

# IS_PUBLIC_KEY

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/auth/decorators/public.decorator.ts` (line 3)

<!-- source: class-linttestloop.md -->

# LintTestLoop

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/lint-test-loop.ts` (line 50)

Tracks edit-then-verify cycles and generates appropriate nudges.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `recordEdit` | `recordEdit(filePath: string)` | `void` |
| `recordVerification` | `recordVerification(passed: boolean, turnNumber: number)` | `void` |
| `getNudge` | `getNudge()` | `string | null` |
| `getState` | `getState()` | `Readonly<LintTestState>` |
| `reset` | `reset()` | `void` |
| `isEditTool` | `isEditTool(toolName: string)` | `boolean` |
| `isVerificationCommand` | `isVerificationCommand(command: string)` | `boolean` |

<!-- source: module-manualsinsightsmodule.md -->

# ManualsInsightsModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/manuals-insights/manuals-insights.module.ts` (line 15)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `technicaldocsmodule`
- MODULE_IMPORTS → `draftdocumentmodule`
- MODULE_DECLARES → `manualsinsightscontroller`
- MODULE_PROVIDES → `manualsinsightsservice`

<!-- source: function-mdtostoragehtml.md -->

# mdToStorageHtml

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/techdocs-export.service.ts` (line 19)

Minimal markdown → XHTML for Confluence storage format. Covers what our generated
pages actually use (headings, paragraphs, fenced code, lists, bold/italic/inline
code, links, tables degrade to paragraphs). Dependency-free on purpose: `marked`
is ESM-only and breaks the CJS server build.

## Signature

```ts
function mdToStorageHtml(md: string): string
```

## Parameters

| Name | Type |
|---|---|
| `md` | `string` |

**Returns:** `string`

<!-- source: interface-orchestratorconfig.md -->

# OrchestratorConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/config.interface.ts` (line 183)

Parser orchestration configuration

## Properties

| Property | Type |
|---|---|
| `defaultParsers` | `string[]` |
| `maxConcurrency` | `number` |
| `jobTimeout` | `number` |
| `autoSyncToKG` | `boolean` |
| `kgSyncBatchSize` | `number` |

<!-- source: component-pricingcomparisontable.md -->

# PricingComparisonTable

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/pricing/pricing-comparison-table.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `plans` | `unknown[]` | ✓ | - |
| `features` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PricingComparisonTable_54b4f697["PricingComparisonTable"]
    class component_PricingComparisonTable_54b4f697 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `motion-table`
- RENDERS → `ComparisonRow`
- USES_HOOK → `useTranslation`

<!-- source: interface-productcategory.md -->

# ProductCategory

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 180)

A document category from the generated documentation tree.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `icon` | `string` |
| `documentCount` | `number` |
| `parentId` | `string` |
| `children` | `ProductCategory[]` |

<!-- source: function-retry.md -->

# retry

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 240)

Retry an action until it succeeds or times out

## Signature

```ts
async function retry(action: () => Promise<T>, options: {
    maxAttempts?: number;
    delayMs?: number;
    timeout?: number;
  }): Promise<T>
```

## Parameters

| Name | Type |
|---|---|
| `action` | `() => Promise<T>` |
| `options` | `{
    maxAttempts?: number;
    delayMs?: number;
    timeout?: number;
  }` |

**Returns:** `Promise<T>`

<!-- source: interface-screenshotinfo-2.md -->

# ScreenshotInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 160)

Screenshot info from the existing Screenshot model.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `url` | `string` |
| `title` | `string` |
| `description` | `string` |
| `assetUrl` | `string` |
| `width` | `number` |
| `height` | `number` |
| `viewport` | `string` |
| `featureArea` | `string` |
| `pageType` | `string` |
| `semanticTags` | `string[]` |

<!-- source: class-takescreenshotdto.md -->

# TakeScreenshotDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.controller.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `capturedBy` | `string` |
| `viewport` | `{ width: number; height: number }` |
| `fullPage` | `boolean` |
| `waitForSelector` | `string` |
| `stateType` | `'default' | 'hover' | 'modal' | 'error' | 'success' | 'loading'` |
| `flowStepId` | `string` |
| `browser` | `'chromium' | 'firefox' | 'webkit'` |

<!-- source: class-typescriptsymbolparser.md -->

# TypeScriptSymbolParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/backend/typescript-symbol.parser.ts` (line 40)

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: constant-usepmestore.md -->

# usePmeStore

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/stores/pmeStore.ts` (line 73)

<!-- source: component-admonitionswithcodeblocks.md -->

# AdmonitionsWithCodeBlocks

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/directives.tsx` (line 190)

## Diagram

```mermaid
graph TD
    component_AdmonitionsWithCodeBlocks_321ab331["AdmonitionsWithCodeBlocks"]
    class component_AdmonitionsWithCodeBlocks_321ab331 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: constant-antd-form-patterns.md -->

# ANTD_FORM_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/antd.patterns.ts` (line 179)

<!-- source: interface-applicationsummary.md -->

# ApplicationSummary

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-05.types.ts` (line 40)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `purpose` | `string` |
| `description` | `string` |
| `targetUsers` | `string[]` |
| `keyBenefits` | `string[]` |

<!-- source: component-brandingproviderwrapper.md -->

# BrandingProviderWrapper

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/PublicLayoutShell.tsx` (line 247)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_BrandingProviderWrapper_36c4b574["BrandingProviderWrapper"]
    class component_BrandingProviderWrapper_36c4b574 rootComponent
```

## Relationships

- RENDERS → `BrandingProvider`
- USES_HOOK → `usePathname`

## Referenced By

- `PublicLayoutShell` (RENDERS)

<!-- source: interface-carryforwardresult.md -->

# CarryForwardResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/doc-version/carry-forward.service.ts` (line 5)

## Properties

| Property | Type |
|---|---|
| `carried` | `number` |
| `flagged` | `number` |
| `carriedCategories` | `number` |
| `details` | `{
    carriedDocs: Array<{ id: string; title: string; slug: string }>;
    flaggedDocs: Array<{
      previousDocId: string;
      title: string;
      slug: string;
      newVersionDocId: string | null;
    }>;
  }` |

<!-- source: api-endpoint-checkout.md -->

# checkout

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/billing/billing.controller.ts` (line 29)

## Endpoint

`POST /billing/checkout`

## Referenced By

- `BillingController` (MODULE_DECLARES)

<!-- source: interface-circlesignal.md -->

# CircleSignal

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/circle-detector.ts` (line 64)

## Properties

| Property | Type |
|---|---|
| `type` | `'action_repetition' | 'file_repetition' | 'test_stagnation' |
        'error_repetition' | 'oscillation'` |
| `weight` | `number` |
| `detail` | `string` |

<!-- source: class-commentendpoints.md -->

# CommentEndpoints

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/comments.ts` (line 22)

Comment endpoints

## Methods

| Method | Signature | Returns |
|---|---|---|
| `list` | `list(documentId: string, params: Omit<CommentListParams, 'documentId'>)` | `Promise<CommentWithUser[]>` |
| `get` | `get(commentId: string)` | `Promise<CommentWithUser>` |
| `create` | `create(documentId: string, dto: CreateCommentDto)` | `Promise<CommentWithUser>` |
| `update` | `update(commentId: string, dto: UpdateCommentDto)` | `Promise<CommentWithUser>` |
| `delete` | `delete(commentId: string)` | `Promise<void>` |
| `resolve` | `resolve(commentId: string)` | `Promise<CommentWithUser>` |
| `unresolve` | `unresolve(commentId: string)` | `Promise<CommentWithUser>` |
| `reply` | `reply(parentCommentId: string, dto: Omit<CreateCommentDto, 'parentCommentId'>)` | `Promise<CommentWithUser>` |
| `getReplies` | `getReplies(parentCommentId: string)` | `Promise<CommentWithUser[]>` |

<!-- source: service-competitorresearchservice.md -->

# CompetitorResearchService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/competitor-research.service.ts` (line 18)

Main orchestrator for competitor research
Combines AI discovery + web crawling

`CompetitorResearchService` is the main orchestration layer for competitor research in the backend. It coordinates AI-based competitor discovery with web crawling to gather and normalize data about identified competitors. This service typically sits above lower-level AI/crawler providers and returns consolidated research results to calling modules/controllers.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `researchCompetitors` | `researchCompetitors(projectType: string, projectDescription: string, options: {
      maxCompetitors?: number;
      useCache?: boolean;
      crawlConcurrency?: number;
    })` | `Promise<CompetitorResearchResult>` |
| `formatForAIContext` | `formatForAIContext(research: CompetitorResearchResult)` | `string` |
| `clearCache` | `clearCache()` | `Promise<void>` |
| `onModuleDestroy` | `onModuleDestroy()` | `unknown` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  actor Client
  participant CRS as CompetitorResearchService
  participant AI as AI Discovery Provider
  participant Crawler as Web Crawler
  participant Store as Persistence/Repository

  Client->>CRS: runResearch(input)
  CRS->>AI: discoverCompetitors(input)
  AI-->>CRS: competitorCandidates[]
  loop for each competitor
    CRS->>Crawler: crawl(competitor.url)
    Crawler-->>CRS: pages/content/metadata
    CRS->>CRS: extract + normalize signals
  end
  CRS->>Store: saveResearchResult(result)
  Store-->>CRS: savedResult
  CRS-->>Client: researchResult
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { CompetitorResearchService } from './documentation/services/competitor-research.service';

@Injectable()
export class ResearchRunner {
  constructor(private readonly competitorResearch: CompetitorResearchService) {}

  async run() {
    // Shape depends on your implementation; keep it aligned with the DTO/interface used by the service.
    const input = {
      companyName: 'Atloria',
      domain: 'atloria.com',
      market: 'B2B SaaS',
      maxCompetitors: 10,
    };

    const result = await this.competitorResearch.runResearch(input);

    // e.g., competitors with evidence/links and extracted positioning signals
    return {
      count: result.competitors?.length ?? 0,
      competitors: result.competitors,
      generatedAt: result.generatedAt,
    };
  }
}
```

## AI Coding Instructions

- Keep `CompetitorResearchService` focused on orchestration: delegate AI discovery and crawling details to dedicated providers/services rather than embedding implementation logic here.
- Treat external calls (LLM + crawling) as unreliable: add timeouts, retries/backoff, and graceful partial results instead of failing the entire run on one competitor.
- Normalize outputs at the boundary: ensure AI-discovered competitors and crawled artifacts are mapped into consistent internal DTOs before persistence/return.
- Avoid unbounded loops and crawling: enforce limits (`maxCompetitors`, max pages/depth, allowed domains) to prevent runaway requests and high costs.
- Maintain clear integration points: when changing discovery prompts/schema or crawler extraction, update the parsing/validation in this service to keep downstream consumers stable.

## Relationships

- DEPENDS_ON → `competitordiscoveryservice`
- DEPENDS_ON → `webcrawlerservice`

<!-- source: function-core.md -->

# core

**Kind:** Function

**Source:** `atloria-monorepo/packages/core/src/lib/core.ts` (line 1)

## Signature

```ts
function core(): string
```

**Returns:** `string`

<!-- source: interface-crawledcompetitorpage.md -->

# CrawledCompetitorPage

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/competitor.interface.ts` (line 13)

## Properties

| Property | Type |
|---|---|
| `competitor` | `string` |
| `url` | `string` |
| `title` | `string` |
| `content` | `string` |
| `textLength` | `number` |
| `crawledAt` | `Date` |

<!-- source: function-createcodeanalysistool.md -->

# createCodeAnalysisTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/code-analysis.tool.ts` (line 53)

## Signature

```ts
function createCodeAnalysisTool(options: CodeAnalysisOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `CodeAnalysisOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: class-createcolumndto.md -->

# CreateColumnDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/boards/dto/column.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `color` | `string` |
| `mapsToStatus` | `IssueStatus | null` |
| `wipLimit` | `number | null` |
| `afterColumnId` | `string` |

<!-- source: function-createhtmlqualityguardrail.md -->

# createHtmlQualityGuardrail

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/html-quality.guardrail.ts` (line 118)

## Signature

```ts
function createHtmlQualityGuardrail(config: HtmlQualityConfig): OutputGuardrailDefinition
```

## Parameters

| Name | Type |
|---|---|
| `config` | `HtmlQualityConfig` |

**Returns:** `OutputGuardrailDefinition`

<!-- source: interface-deskcounts.md -->

# DeskCounts

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 73)

## Properties

| Property | Type |
|---|---|
| `triage` | `CountValue` |
| `needs_first` | `CountValue` |
| `needs_next` | `CountValue` |
| `investigating` | `CountValue` |
| `waiting` | `CountValue` |
| `paused` | `CountValue` |
| `done_today` | `CountValue` |
| `mine` | `CountValue` |
| `unassigned` | `CountValue` |

<!-- source: function-detectpiniastores.md -->

# detectPiniaStores

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/pinia-pattern-detector.ts` (line 122)

Detect Pinia stores from code

## Signature

```ts
function detectPiniaStores(content: string): PiniaStorePattern[]
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |

**Returns:** `PiniaStorePattern[]`

<!-- source: type-explorermode-3.md -->

# ExplorerMode

**Kind:** Type

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/ModeSwitcher.ts` (line 8)

## Definition

```ts
'documentation' | 'playground'
```

<!-- source: function-formatnumber.md -->

# formatNumber

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/formatters.ts` (line 6)

Number / duration / percent formatters shared across all chart primitives.
Kept tiny on purpose — no Intl.NumberFormat instances created on every render.

## Signature

```ts
function formatNumber(value: number | null | undefined): string
```

## Parameters

| Name | Type |
|---|---|
| `value` | `number | null | undefined` |

**Returns:** `string`

<!-- source: controller-invitationcontroller.md -->

# InvitationController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/invitation/invitation.controller.ts` (line 21)

Public invitation endpoints (token IS the credential — no JWT required).

## Relationships

- MODULE_DECLARES → `get`
- MODULE_DECLARES → `accept`
- DEPENDS_ON → `invitationservice`

<!-- source: class-livesweloop.md -->

# LiveSweLoop

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/live-swe-loop.ts` (line 85)

**Implements:** `IAgentLoop`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `run` | `run(config: AgentConfig<TContext>, input: string | AgentInputItem[], options: RunOptions<TContext>)` | `Promise<RunResult>` |
| `runStreamed` | `runStreamed(config: AgentConfig<TContext>, input: string | AgentInputItem[], options: RunOptions<TContext>)` | `Promise<StreamedRunHandle>` |

<!-- source: constant-max-time-on-page-seconds.md -->

# MAX_TIME_ON_PAGE_SECONDS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/analytics/utils/tracking-utils.ts` (line 31)

Maximum reasonable time-on-page in seconds. Tabs left open overnight
would otherwise produce values like 80,000 seconds and destroy averages.
30 minutes is generous for "actively reading a long doc" while still
filtering out the long tail of forgotten tabs.

<!-- source: function-normalizecuration.md -->

# normalizeCuration

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/curation.ts` (line 17)

Coerce whatever is stored in settings JSON into a safe, capped curation object.

## Signature

```ts
function normalizeCuration(raw: unknown): TechdocsCuration
```

## Parameters

| Name | Type |
|---|---|
| `raw` | `unknown` |

**Returns:** `TechdocsCuration`

<!-- source: module-notificationmodule.md -->

# NotificationModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/notification/notification.module.ts` (line 9)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_DECLARES → `notificationcontroller`
- MODULE_PROVIDES → `notificationservice`
- MODULE_EXPORTS → `notificationservice`

<!-- source: interface-parameterdefinition.md -->

# ParameterDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 493)

Parameter definition (path, query, header)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `required` | `boolean` |
| `description` | `string` |
| `example` | `unknown` |
| `defaultValue` | `unknown` |

<!-- source: component-pricingherocard.md -->

# PricingHeroCard

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/pricing/pricing-hero-card.tsx` (line 34)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `heroPlan` | `PricingPlan` | ✓ | - |
| `secondaryPlans` | `PricingPlan[]` | - | - |

## Diagram

```mermaid
graph TD
    component_PricingHeroCard_40302ff7["PricingHeroCard"]
    class component_PricingHeroCard_40302ff7 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `Check`
- RENDERS → `ArrowRight`
- USES_HOOK → `useTranslation`

<!-- source: interface-productdocument.md -->

# ProductDocument

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 192)

A document from the generated user documentation.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `content` | `string` |
| `category` | `string` |
| `documentType` | `string` |
| `audience` | `string` |
| `difficulty` | `string` |
| `keywords` | `string[]` |

<!-- source: function-runaccessibilitycheck.md -->

# runAccessibilityCheck

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/accessibility.ts` (line 39)

Run accessibility check on a page

## Signature

```ts
async function runAccessibilityCheck(page: Page, options: {
    level?: WCAGLevel;
    include?: string[];
    exclude?: string[];
    disabledRules?: string[];
  }): Promise<AccessibilityResult>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |
| `options` | `{
    level?: WCAGLevel;
    include?: string[];
    exclude?: string[];
    disabledRules?: string[];
  }` |

**Returns:** `Promise<AccessibilityResult>`

<!-- source: interface-sectioncontent.md -->

# SectionContent

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 100)

## Properties

| Property | Type |
|---|---|
| `type` | `SectionType` |
| `layout` | `string` |
| `content` | `Record<string, unknown>` |
| `html` | `string` |

<!-- source: class-takesmartauthenticatedscreenshotdto.md -->

# TakeSmartAuthenticatedScreenshotDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/screenshot.controller.ts` (line 141)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `capturedBy` | `string` |
| `auth` | `SmartAuthConfigDto` |
| `viewport` | `{ width: number; height: number }` |
| `fullPage` | `boolean` |
| `waitForSelector` | `string` |
| `browser` | `'chromium' | 'firefox' | 'webkit'` |

<!-- source: constant-useprojectcontext.md -->

# useProjectContext

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/stores/projectContext.ts` (line 103)

Project Context Store

Usage:
```tsx
const { currentProject, setCurrentProject } = useProjectContext();
```

<!-- source: class-versiondiffgenerator.md -->

# VersionDiffGenerator

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/version-diff.generator.ts` (line 34)

Version Diff Generator

## Methods

| Method | Signature | Returns |
|---|---|---|
| `compare` | `compare(oldEntities: Entity[], newEntities: Entity[], fromVersion: string, toVersion: string, options: VersionDiffOptions)` | `VersionDiff` |
| `generateReport` | `generateReport(diff: VersionDiff, options: VersionDiffOptions)` | `string` |
| `generateChangelog` | `generateChangelog(diff: VersionDiff)` | `string` |

<!-- source: constant-antd-hooks-patterns.md -->

# ANTD_HOOKS_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/antd.patterns.ts` (line 230)

<!-- source: component-app.md -->

# App

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/controlled-mode.tsx` (line 14)

## Diagram

```mermaid
graph TD
    component_App_7b96f1d2["App"]
    class component_App_7b96f1d2 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `BoldItalicUnderlineToggles`
- RENDERS → `ListsToggle`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `Fragment`
- USES_HOOK → `useState`

<!-- source: interface-approvalcategory.md -->

# ApprovalCategory

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 86)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `subcategories` | `ApprovalSubcategory[]` |
| `canDelete` | `boolean` |

<!-- source: component-card.md -->

# Card

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/page.tsx` (line 548)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `title` | `string` | - | - |
| `subtitle` | `string` | - | - |
| `action` | `unknown` | - | - |
| `children` | `unknown` | ✓ | - |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_Card_5a3d2af["Card"]
    class component_Card_5a3d2af rootComponent
```

## Referenced By

- `IssuesListPage` (RENDERS)

<!-- source: interface-categorydiffentry.md -->

# CategoryDiffEntry

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/doc-version/version-diff.service.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `slug` | `string` |
| `name` | `string` |

<!-- source: api-endpoint-checksubdomain.md -->

# checkSubdomain

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 337)

## Endpoint

`GET /projects/:id/subdomain/check`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `slug` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: interface-codeanalysisoptions.md -->

# CodeAnalysisOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/code-analysis.tool.ts` (line 20)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `maxFileSize` | `number` |
| `tsconfigPath` | `string` |

<!-- source: class-consistencychecker.md -->

# ConsistencyChecker

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/consistency-checker.ts` (line 32)

ConsistencyChecker - Checks consistency across all documents

After individual document verification, this checker reviews all
documents together to catch inconsistencies that wouldn't be visible
when looking at documents in isolation.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `check` | `check(documents: GeneratedDocument[])` | `ConsistencyReport` |

<!-- source: function-countselectors.md -->

# countSelectors

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 168)

Count total selectors in an ExtractedSelectors object

## Signature

```ts
function countSelectors(selectors: ExtractedSelectors): number
```

## Parameters

| Name | Type |
|---|---|
| `selectors` | `ExtractedSelectors` |

**Returns:** `number`

<!-- source: interface-crawledpage-2.md -->

# CrawledPage

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/web-crawler.ts` (line 10)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `title` | `string` |
| `content` | `string` |
| `textLength` | `number` |
| `crawledAt` | `Date` |

<!-- source: class-createcommentdto.md -->

# CreateCommentDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/comment/dto/create-comment.dto.ts` (line 15)

DTO for creating a new comment on a document

## Properties

| Property | Type |
|---|---|
| `content` | `string` |
| `selectionText` | `string` |
| `positionStart` | `number` |
| `positionEnd` | `number` |
| `parentCommentId` | `string` |

<!-- source: function-createcoordinationtool.md -->

# createCoordinationTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/coordination.tool.ts` (line 16)

## Signature

```ts
function createCoordinationTool(options: CoordinationToolOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `CoordinationToolOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-createimagequalityguardrail.md -->

# createImageQualityGuardrail

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/image-quality.guardrail.ts` (line 111)

## Signature

```ts
function createImageQualityGuardrail(config: ImageQualityConfig): OutputGuardrailDefinition
```

## Parameters

| Name | Type |
|---|---|
| `config` | `ImageQualityConfig` |

**Returns:** `OutputGuardrailDefinition`

<!-- source: service-dashboardservice.md -->

# DashboardService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/dashboard/dashboard.service.ts` (line 7)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getStats` | `getStats(user: JwtPayload)` | `unknown` |
| `getProjectStats` | `getProjectStats(user: JwtPayload)` | `unknown` |
| `getUserActivity` | `getUserActivity(user: JwtPayload)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: interface-deskthread.md -->

# DeskThread

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `ticketNumber` | `number` |
| `title` | `string` |
| `description` | `string` |
| `ticketType` | `string` |
| `status` | `string` |
| `priority` | `string` |
| `assignee` | `{ id: string; name: string } | null` |
| `reporterEmail` | `string | null` |
| `chatSessionId` | `string | null` |
| `pageUrl` | `string | null` |
| `createdAt` | `string` |
| `updatedAt` | `string` |
| `commentCount` | `number` |
| `snoozedUntil` | `string | null` |
| `firstAgentReplyAt` | `string | null` |
| `slaDueAt` | `string | null` |
| `slaState` | `SlaState` |

<!-- source: function-detectreduxactions.md -->

# detectReduxActions

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/redux-pattern-detector.ts` (line 122)

Detect Redux actions from code

## Signature

```ts
function detectReduxActions(content: string): ReduxActionPattern[]
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |

**Returns:** `ReduxActionPattern[]`

<!-- source: type-format-2.md -->

# FORMAT

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/FormatConstants.ts` (line 12)

## Definition

```ts
| typeof DEFAULT_FORMAT
  | typeof IS_BOLD
  | typeof IS_ITALIC
  | typeof IS_STRIKETHROUGH
  | typeof IS_UNDERLINE
  | typeof IS_CODE
  | typeof IS_SUBSCRIPT
  | typeof IS_SUPERSCRIPT
  | typeof IS_HIGHLIGHT
```

<!-- source: function-formatpercent.md -->

# formatPercent

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/formatters.ts` (line 21)

## Signature

```ts
function formatPercent(value: number | null | undefined): string
```

## Parameters

| Name | Type |
|---|---|
| `value` | `number | null | undefined` |

**Returns:** `string`

<!-- source: controller-issuescontroller.md -->

# IssuesController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/issues/issues.controller.ts` (line 19)

## Relationships

- MODULE_DECLARES → `list`
- MODULE_DECLARES → `getStats`
- MODULE_DECLARES → `getOne`
- MODULE_DECLARES → `bulkUpdate`
- MODULE_DECLARES → `update`
- MODULE_DECLARES → `addComment`
- MODULE_DECLARES → `getDuplicates`
- DEPENDS_ON → `issuesservice`

<!-- source: class-mcpclient.md -->

# McpClient

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/mcp/mcp-client.ts` (line 87)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize()` | `Promise<McpServerInfo>` |
| `listTools` | `listTools()` | `Promise<McpToolDefinition[]>` |
| `callTool` | `callTool(name: string, args: Record<string, unknown>)` | `Promise<McpCallResult>` |
| `close` | `close()` | `Promise<void>` |

<!-- source: constant-migrationguidetemplate.md -->

# migrationGuideTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/migration-guide.template.ts` (line 3)

<!-- source: function-normalizeicon.md -->

# normalizeIcon

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/document/utils/icon-mapper.ts` (line 246)

Convert an Ant Design icon name to emoji
Returns null if no icon provided, returns emoji if found, otherwise returns original value

## Signature

```ts
function normalizeIcon(icon: string | null | undefined): string | null
```

## Parameters

| Name | Type |
|---|---|
| `icon` | `string | null | undefined` |

**Returns:** `string | null`

<!-- source: module-opsmodule.md -->

# OpsModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/ops/ops.module.ts` (line 9)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `emailmodule`
- MODULE_DECLARES → `opscontroller`
- MODULE_PROVIDES → `opsservice`
- MODULE_PROVIDES → `opsalertsservice`

<!-- source: interface-parseerror.md -->

# ParseError

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/parse-result.interface.ts` (line 53)

Error encountered during parsing

## Properties

| Property | Type |
|---|---|
| `message` | `string` |
| `code` | `string` |
| `severity` | `'error' | 'warning'` |
| `line` | `number` |
| `column` | `number` |
| `filePath` | `string` |
| `stack` | `string` |
| `suggestion` | `string` |

<!-- source: component-pricingtiercard.md -->

# PricingTierCard

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/pricing-tier-card.tsx` (line 30)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `nameKey` | `string` | ✓ | - |
| `priceKey` | `string` | ✓ | - |
| `intervalKey` | `string` | - | - |
| `descriptionKey` | `string` | - | - |
| `features` | `PricingFeature[]` | ✓ | - |
| `ctaKey` | `string` | ✓ | - |
| `ctaUrl` | `string` | ✓ | - |
| `highlighted` | `boolean` | - | false |
| `badgeKey` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_PricingTierCard_32721740["PricingTierCard"]
    class component_PricingTierCard_32721740 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Check`
- USES_HOOK → `useTranslation`

<!-- source: interface-productfeature.md -->

# ProductFeature

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 155)

A user-facing feature extracted from the codebase.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `actions` | `Array<{
    name: string;
    description: string;
    httpMethod?: string;
    path?: string;
    component?: string;
  }>` |
| `confidence` | `number` |
| `relatedFeatures` | `string[]` |

<!-- source: function-scrollintoview.md -->

# scrollIntoView

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 119)

Scroll element into view

## Signature

```ts
async function scrollIntoView(locator: Locator): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `locator` | `Locator` |

**Returns:** `Promise<void>`

<!-- source: interface-seodependencies.md -->

# SeoDependencies

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/agents/seo.agent.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `generateFn` | `ContentGenerateFn` |

<!-- source: class-timingconfigdto.md -->

# TimingConfigDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 215)

Timing configuration for animations and waits

## Properties

| Property | Type |
|---|---|
| `waitStrategy` | `string` |
| `animationHandling` | `'disable' | 'waitForCompletion'` |
| `networkWait` | `string` |

<!-- source: constant-useversioncontext.md -->

# useVersionContext

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/stores/versionContext.ts` (line 33)

<!-- source: class-versionselectorgenerator.md -->

# VersionSelectorGenerator

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/version-selector.generator.ts` (line 17)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate(config: VersionConfig, options: VersionSelectorOptions)` | `string` |
| `generateBanner` | `generateBanner(config: VersionConfig, options: VersionSelectorOptions)` | `string` |
| `generateDropdown` | `generateDropdown(config: VersionConfig, options: Required<Pick<VersionSelectorOptions, 'showLabels'>> & VersionSelectorOptions)` | `string` |
| `generateFrontmatter` | `generateFrontmatter(config: VersionConfig)` | `Record<string, unknown>` |
| `generateEntityVersionSwitcher` | `generateEntityVersionSwitcher(config: VersionConfig, entityPath: string, _options: VersionSelectorOptions)` | `string` |

<!-- source: constant-antd-table-patterns.md -->

# ANTD_TABLE_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/antd.patterns.ts` (line 132)

<!-- source: component-app-2.md -->

# App

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/App.tsx` (line 50)

## Diagram

```mermaid
graph TD
    component_App_68175d70["App"]
    class component_App_68175d70 rootComponent
```

## Relationships

- RENDERS → `Nav`
- RENDERS → `Routes`
- RENDERS → `Route`
- RENDERS → `LandingPage`
- RENDERS → `PrivacyPolicy`
- RENDERS → `TermsOfService`
- RENDERS → `Footer`
- RENDERS → `CookieBanner`

<!-- source: interface-approvalcheckpoint.md -->

# ApprovalCheckpoint

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 58)

## Properties

| Property | Type |
|---|---|
| `checkpointId` | `string` |
| `createdAt` | `Date` |
| `expiresAt` | `Date` |
| `discoveredStructure` | `{
    categories: ApprovalCategory[];
    totalDocuments: number;
    totalScreenshots: number;
    estimatedDurationMinutes: number;
  }` |
| `costEstimate` | `{
    claudeTokens: number;
    openaiTokens: number;
    estimatedCostUsd: number;
    costRange: { min: number; max: number };
  }` |
| `userAction` | `'approved' | 'modified' | 'cancelled'` |
| `userModifications` | `StructureModification[]` |
| `approvedAt` | `Date` |
| `approvedBy` | `string` |

<!-- source: component-categorybadge.md -->

# CategoryBadge

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/PromptLibrary.tsx` (line 288)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `category` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CategoryBadge_72613ef3["CategoryBadge"]
    class component_CategoryBadge_72613ef3 rootComponent
```

## Referenced By

- `PromptCard` (RENDERS)

<!-- source: interface-checkedrecord.md -->

# CheckedRecord

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/project/domain-dns.service.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `observed` | `string[]` |
| `ok` | `boolean` |
| `hint` | `string` |

<!-- source: api-endpoint-cherrypick.md -->

# cherryPick

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 400)

## Endpoint

`POST /doc-versions/:projectId/:versionId/cherry-pick`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: interface-codechunk.md -->

# CodeChunk

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/types.ts` (line 12)

A chunk of source code for indexing.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `file` | `string` |
| `startLine` | `number` |
| `endLine` | `number` |
| `kind` | `'function' | 'class' | 'method' | 'interface' | 'type' | 'block' | 'module'` |
| `name` | `string` |
| `content` | `string` |
| `context` | `string` |
| `embedding` | `number[]` |
| `contentHash` | `string` |

<!-- source: class-contextresolver.md -->

# ContextResolver

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/context-resolver.ts` (line 38)

ContextResolver - Resolves cross-chunk entity references

When generating documentation for a document, we may need entities
that exist in OTHER chunks. This resolver fetches them from the
global entity map without loading everything into memory.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `setEntityMap` | `setEntityMap(entityMap: Map<string, Entity>)` | `void` |
| `resolveForPlan` | `resolveForPlan(plan: DocumentPlan)` | `Promise<Entity[]>` |
| `resolveByName` | `resolveByName(entityName: string)` | `Entity | undefined` |
| `resolveById` | `resolveById(entityId: string)` | `Entity | undefined` |
| `handleDeepLoadRequest` | `handleDeepLoadRequest(request: DeepLoadRequest)` | `Promise<DeepLoadResponse>` |
| `getByFilePath` | `getByFilePath(pattern: string)` | `Entity[]` |
| `getByType` | `getByType(type: Entity['type'])` | `Entity[]` |
| `clearCache` | `clearCache()` | `void` |
| `getCacheStats` | `getCacheStats()` | `{ size: number; hits: string[] }` |
| `hasEntity` | `hasEntity(entityId: string)` | `boolean` |
| `getEntityCount` | `getEntityCount()` | `number` |

<!-- source: function-createazureresponsesprovider.md -->

# createAzureResponsesProvider

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/azure-responses.provider.ts` (line 493)

Create an Azure Responses provider from environment configuration

## Signature

```ts
function createAzureResponsesProvider(config: Partial<AzureResponsesConfig>): AzureResponsesProvider
```

## Parameters

| Name | Type |
|---|---|
| `config` | `Partial<AzureResponsesConfig>` |

**Returns:** `AzureResponsesProvider`

<!-- source: function-createcrontools.md -->

# createCronTools

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/cron.tool.ts` (line 129)

## Signature

```ts
function createCronTools(options: CronToolsOptions): CronTools<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `CronToolsOptions` |

**Returns:** `CronTools<TContext>`

<!-- source: class-createdocautomationconfigdto.md -->

# CreateDocAutomationConfigDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/documentation/dto/doc-automation.dto.ts` (line 77)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `repositoryUrl` | `string` |
| `repositoryBranch` | `string` |
| `frontendPath` | `string` |
| `backendPath` | `string` |
| `siteUrl` | `string` |
| `siteLoginUrl` | `string` |
| `siteEmail` | `string` |
| `sitePassword` | `string` |
| `repoUsername` | `string` |
| `repoPassword` | `string` |
| `skeletonStructure` | `SkeletonStructureDto` |
| `includeApiDocs` | `boolean` |
| `includeDiagrams` | `boolean` |
| `includeScreenshots` | `boolean` |
| `aiEnhancement` | `boolean` |
| `outputFormat` | `string` |
| `screenshotFormat` | `string` |
| `screenshotQuality` | `number` |
| `maxConcurrency` | `number` |
| `timeout` | `number` |
| `excludePatterns` | `string[]` |
| `targetAudience` | `string` |
| `autoPublish` | `boolean` |
| `businessDomain` | `string` |
| `contextSources` | `{ type: 'pdf' | 'url' | 'file' | 'text'; path: string }[]` |

<!-- source: function-createlayoutagent.md -->

# createLayoutAgent

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/agents/layout.agent.ts` (line 13)

## Signature

```ts
function createLayoutAgent(config: GenerationConfig): AgentConfig<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |

**Returns:** `AgentConfig<PmeContext>`

<!-- source: interface-databasemodelentity-2.md -->

# DatabaseModelEntity

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 703)

Database Model entity

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.DATABASE_MODEL` |
| `tableName` | `string` |
| `fields` | `FieldDefinition[]` |
| `indexes` | `IndexDefinition[]` |
| `relations` | `RelationDefinition[]` |
| `orm` | `'prisma' | 'typeorm' | 'sequelize' | 'mongoose' | 'drizzle' | 'raw'` |
| `primaryKey` | `string[]` |
| `uniqueConstraints` | `UniqueConstraint[]` |

<!-- source: service-deskservice.md -->

# DeskService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/issues/desk.service.ts` (line 46)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `listThreads` | `listThreads(projectId: string, user: JwtPayload, bucket: DeskBucket, limit: unknown)` | `unknown` |
| `getCounts` | `getCounts(projectId: string, user: JwtPayload)` | `unknown` |
| `getThread` | `getThread(projectId: string, issueId: string, user: JwtPayload)` | `unknown` |
| `transition` | `transition(projectId: string, issueId: string, dto: DeskTransitionDto, user: JwtPayload)` | `unknown` |
| `reply` | `reply(projectId: string, issueId: string, dto: DeskReplyDto, user: JwtPayload)` | `unknown` |
| `markDuplicate` | `markDuplicate(projectId: string, issueId: string, dto: DeskDuplicateDto, user: JwtPayload)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `issuesservice`

<!-- source: interface-deskthreaddetail.md -->

# DeskThreadDetail

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 65)

## Properties

| Property | Type |
|---|---|
| `comments` | `DeskComment[]` |
| `activities` | `DeskActivity[]` |

<!-- source: function-detectreduxreducers.md -->

# detectReduxReducers

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/redux-pattern-detector.ts` (line 240)

Detect Redux reducers from code

## Signature

```ts
function detectReduxReducers(content: string): ReduxReducerPattern[]
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |

**Returns:** `ReduxReducerPattern[]`

<!-- source: function-formatrelativetime.md -->

# formatRelativeTime

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/uiStrings.ts` (line 600)

Localized relative time ("3 hours ago" / "قبل ٣ ساعات").
Uses Intl.RelativeTimeFormat so ANY documentation language gets correct
plural/dual forms for free; <60s uses the catalog's "just now".

## Signature

```ts
function formatRelativeTime(input: string | Date, lang: string | null): string
```

## Parameters

| Name | Type |
|---|---|
| `input` | `string | Date` |
| `lang` | `string | null` |

**Returns:** `string`

<!-- source: type-frameworktype.md -->

# FrameworkType

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 39)

## Definition

```ts
(typeof FRAMEWORK_TYPES)[number]
```

<!-- source: controller-kgsynccontroller.md -->

# KgSyncController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/graph/kg-sync.controller.ts` (line 38)

Knowledge Graph Sync Controller

Handles CLI dynamic mode sync operations.
Provides endpoints for bulk entity and relationship sync.

## Relationships

- MODULE_DECLARES → `getEntities`
- MODULE_DECLARES → `getEntityById`
- MODULE_DECLARES → `syncEntities`
- MODULE_DECLARES → `getRelationships`
- MODULE_DECLARES → `getRelationshipsForEntity`
- MODULE_DECLARES → `syncRelationships`
- DEPENDS_ON → `kgsyncservice`
- DEPENDS_ON → `workflowdiscoveryservice`
- DEPENDS_ON → `workflowstorageservice`

<!-- source: class-mcpmanager.md -->

# McpManager

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/mcp/mcp-manager.ts` (line 60)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `connect` | `connect()` | `Promise<void>` |
| `getTools` | `getTools()` | `ToolDefinition<any>[]` |
| `listServers` | `listServers()` | `string[]` |
| `close` | `close()` | `Promise<void>` |

<!-- source: function-normalizereferrer.md -->

# normalizeReferrer

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/analytics/utils/tracking-utils.ts` (line 76)

Map a raw referrer URL into a small, normalized source bucket so that
`https://www.google.com/search?q=foo` and `https://google.com/` both
roll up under "google" in the dashboard. Unknown hosts collapse to
the bare hostname so we can still see long-tail sources.

## Signature

```ts
function normalizeReferrer(referrer: string | null | undefined): string
```

## Parameters

| Name | Type |
|---|---|
| `referrer` | `string | null | undefined` |

**Returns:** `string`

<!-- source: constant-notion-max-children.md -->

# NOTION_MAX_CHILDREN

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/technical-docs/md-to-notion-blocks.ts` (line 11)

Dependency-free markdown → Notion block objects (the `children` payload for the Notion API).
Parallels `mdToStorageHtml` (Confluence): covers exactly what our generated pages emit —
headings, paragraphs with inline formatting, fenced code, bulleted lists; tables degrade to
paragraphs. No `@notionhq/client` (ESM-only → would break the CJS server build, like `marked`).

Two hard Notion limits are baked in here so the export never 400s:
 - a single rich-text run's `content` must be ≤ 2000 chars → long runs are split.
 - a request may carry ≤ 100 child blocks → chunking is done by the caller (see NOTION_MAX_CHILDREN).

<!-- source: module-organizationmodule.md -->

# OrganizationModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/organization/organization.module.ts` (line 10)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `invitationmodule`
- MODULE_DECLARES → `organizationcontroller`
- MODULE_PROVIDES → `organizationservice`
- MODULE_EXPORTS → `organizationservice`

<!-- source: interface-parsefileinput.md -->

# ParseFileInput

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/parser.interface.ts` (line 43)

Input for parsing a file

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `content` | `string` |
| `metadata` | `Record<string, unknown>` |

<!-- source: component-problemcentered.md -->

# ProblemCentered

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/problem/problem-centered.tsx` (line 21)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `problems` | `Problem[]` | ✓ | - |
| `solutionKey` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_ProblemCentered_978d3b1["ProblemCentered"]
    class component_ProblemCentered_978d3b1 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: interface-productknowledgedeps.md -->

# ProductKnowledgeDeps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/tools/query-product-knowledge.tool.ts` (line 77)

## Properties

| Property | Type |
|---|---|
| `fetchFeatures` | `FetchFeaturesFn` |
| `fetchWorkflows` | `FetchWorkflowsFn` |
| `fetchCategories` | `FetchCategoriesFn` |
| `searchDocs` | `SearchDocsFn` |
| `fetchStats` | `FetchStatsFn` |
| `fetchAudiences` | `FetchAudiencesFn` |
| `fetchScreenshots` | `FetchScreenshotsFn` |

<!-- source: interface-seometadata.md -->

# SeoMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/tools/seo-metadata.tool.ts` (line 12)

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `metaDescription` | `string` |
| `canonicalSlug` | `string` |
| `ogTags` | `Record<string, string>` |
| `jsonLd` | `Record<string, unknown>` |
| `keywords` | `string[]` |

<!-- source: function-setupconsoleerrorcollection.md -->

# setupConsoleErrorCollection

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 216)

Set up console error collection for a page.
Call this before navigating to collect errors during the action.
Returns a function to get collected errors.

## Signature

```ts
function setupConsoleErrorCollection(page: Page): { getErrors: () => string[]; cleanup: () => void }
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |

**Returns:** `{ getErrors: () => string[]; cleanup: () => void }`

<!-- source: class-validateselectorsrequestdto.md -->

# ValidateSelectorsRequestDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 774)

Request to validate selectors on a page

Used to verify login form selectors exist before batch processing

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `selectors` | `Record<string, string>` |
| `timeout` | `number` |

<!-- source: class-versionutils.md -->

# VersionUtils

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/version-config.ts` (line 65)

Version utilities

## Methods

| Method | Signature | Returns |
|---|---|---|
| `parseVersion` | `parseVersion(version: string)` | `[number, number, number] | null` |
| `compare` | `compare(a: string, b: string)` | `VersionComparison` |
| `sort` | `sort(versions: VersionInfo[], ascending: undefined)` | `VersionInfo[]` |
| `findLatest` | `findLatest(versions: VersionInfo[], includePrerelease: undefined)` | `VersionInfo | null` |
| `isPrerelease` | `isPrerelease(version: string)` | `boolean` |
| `isEOL` | `isEOL(version: VersionInfo)` | `boolean` |
| `generateLabel` | `generateLabel(version: VersionInfo, isLatest: boolean)` | `string` |
| `groupByMajor` | `groupByMajor(versions: VersionInfo[])` | `Map<number, VersionInfo[]>` |
| `getBadgeColor` | `getBadgeColor(version: VersionInfo)` | `string` |

<!-- source: constant-viewport.md -->

# viewport

**Kind:** Constant

**Source:** `atloria-monorepo/apps/web/src/app/layout.tsx` (line 18)

## Definition

```ts
Viewport
```

<!-- source: constant-appendcodeblockeditordescriptor.md -->

# appendCodeBlockEditorDescriptor$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/index.ts` (line 101)

A signal that appends a code block editor descriptor to the list of descriptors.

<!-- source: interface-approvaldocument.md -->

# ApprovalDocument

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 100)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `type` | `| 'overview'
    | 'how-to'
    | 'walkthrough'
    | 'reference'
    | 'faq'
    | 'troubleshoot'` |
| `estimatedReadTime` | `number` |
| `screenshotsNeeded` | `number` |
| `canDelete` | `boolean` |
| `canModify` | `boolean` |

<!-- source: component-atloriaprovider.md -->

# AtloriaProvider

**Kind:** Component

**Source:** `atloria-monorepo/packages/ui-react/src/providers/AtloriaProvider.tsx` (line 47)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |
| `apiClient` | `APIClient` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AtloriaProvider_377dd335["AtloriaProvider"]
    class component_AtloriaProvider_377dd335 rootComponent
```

## Relationships

- RENDERS → `AtloriaContext-Provider`

<!-- source: component-categoryitem.md -->

# CategoryItem

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/DocAutomation/SkeletonBuilder.tsx` (line 258)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `category` | `SkeletonCategory` | ✓ | - |
| `isExpanded` | `boolean` | ✓ | - |
| `isEditing` | `boolean` | ✓ | - |
| `addingDocument` | `boolean` | ✓ | - |
| `newDocumentName` | `string` | ✓ | - |
| `editingDocument` | `unknown | null` | ✓ | - |
| `onToggle` | `Function` | ✓ | - |
| `onStartEdit` | `Function` | ✓ | - |
| `onEndEdit` | `Function` | ✓ | - |
| `onUpdate` | `Function` | ✓ | - |
| `onRemove` | `Function` | ✓ | - |
| `onStartAddDocument` | `Function` | ✓ | - |
| `onCancelAddDocument` | `Function` | ✓ | - |
| `onNewDocumentNameChange` | `Function` | ✓ | - |
| `onAddDocument` | `Function` | ✓ | - |
| `onRemoveDocument` | `Function` | ✓ | - |
| `onUpdateDocument` | `Function` | ✓ | - |
| `onStartEditDocument` | `Function` | ✓ | - |
| `onEndEditDocument` | `Function` | ✓ | - |
| `onReorderDocuments` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CategoryItem_184a0b3["CategoryItem"]
    class component_CategoryItem_184a0b3 rootComponent
```

## Relationships

- RENDERS → `Reorder-Item`
- RENDERS → `GripVertical`
- RENDERS → `ChevronDown`
- RENDERS → `ChevronRight`
- RENDERS → `FilePlus`
- RENDERS → `Trash2`
- RENDERS → `AnimatePresence`
- RENDERS → `motion-div`
- RENDERS → `Button`
- RENDERS → `Reorder-Group`
- RENDERS → `DocumentItem`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`

## Referenced By

- `SkeletonBuilder` (RENDERS)

<!-- source: api-endpoint-clearchathistory.md -->

# clearChatHistory

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.controller.ts` (line 170)

## Endpoint

`DELETE /support-agent/:projectId/agents/:agentId/history`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `agentId` | query | `string` | ✓ |

## Referenced By

- `SupportAgentController` (MODULE_DECLARES)

<!-- source: interface-cloneoptions.md -->

# CloneOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/parsing/git-clone.service.ts` (line 11)

## Properties

| Property | Type |
|---|---|
| `repositoryUrl` | `string` |
| `provider` | `RepositoryProvider` |
| `branch` | `string` |
| `credentials` | `RepositoryCredentialsDto` |

<!-- source: interface-commanddefinition.md -->

# CommandDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/plugins/plugin-types.ts` (line 37)

A slash command contributed by a plugin.

Each `.md` file in a plugin's `commands/` directory produces one
CommandDefinition. The filename (without extension) becomes the command name.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `instructions` | `string` |
| `allowedTools` | `string[]` |
| `model` | `string` |
| `argumentHint` | `string` |

<!-- source: class-contextretriever.md -->

# ContextRetriever

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/context-retriever.ts` (line 22)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `retrieveForDocument` | `retrieveForDocument(plan: DocumentPlan, featureIds: string[])` | `RetrievedContext` |

<!-- source: function-createcheckpointservice.md -->

# createCheckpointService

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/pipeline/checkpoint.ts` (line 300)

Create a checkpoint service with default configuration

## Signature

```ts
function createCheckpointService(checkpointDir: string, options: Partial<Omit<CheckpointServiceConfig, 'checkpointDir'>>): CheckpointService
```

## Parameters

| Name | Type |
|---|---|
| `checkpointDir` | `string` |
| `options` | `Partial<Omit<CheckpointServiceConfig, 'checkpointDir'>>` |

**Returns:** `CheckpointService`

<!-- source: function-createdefaultprocessors.md -->

# createDefaultProcessors

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/context/history-processors.ts` (line 274)

Default processor pipeline order:
1. SourceTruncation — bound individual item sizes
2. LastNObservations — elide old observations
3. ClosedWindow — dedup file reads

## Signature

```ts
function createDefaultProcessors(): HistoryProcessor[]
```

**Returns:** `HistoryProcessor[]`

<!-- source: class-createdocumentdto.md -->

# CreateDocumentDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/create-document.dto.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `slug` | `string` |
| `content` | `string` |
| `type` | `DocumentType` |
| `audiences` | `string[]` |
| `projectId` | `string` |
| `categoryId` | `string` |
| `source` | `DocumentSource` |
| `canRegenerate` | `boolean` |
| `kgEntityId` | `string` |
| `kgEntityType` | `string` |

<!-- source: function-createpmehandofffilter.md -->

# createPmeHandoffFilter

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/context/pme-handoff-filter.ts` (line 28)

Create a handoff input filter for PME agents.

The filter keeps:
- Full inputHistory (original user request — usually small)
- Last N items from preHandoffItems (recent coordinator context)
- All newItems (the handoff trigger with task details)

## Signature

```ts
function createPmeHandoffFilter(config: PmeHandoffFilterConfig)
```

## Parameters

| Name | Type |
|---|---|
| `config` | `PmeHandoffFilterConfig` |

<!-- source: interface-databaseschemadiagramoptions.md -->

# DatabaseSchemaDiagramOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/database-schema-diagram.generator.ts` (line 19)

Options for database schema diagram generation

## Properties

| Property | Type |
|---|---|
| `showFieldTypes` | `boolean` |
| `showConstraints` | `boolean` |
| `showNullable` | `boolean` |
| `showIndexes` | `boolean` |
| `showFieldDescriptions` | `boolean` |
| `maxFieldsPerModel` | `number` |
| `includeModels` | `string[]` |
| `excludeModels` | `string[]` |

<!-- source: function-detectreduxselectors.md -->

# detectReduxSelectors

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/redux-pattern-detector.ts` (line 443)

Detect Redux selectors from code

## Signature

```ts
function detectReduxSelectors(content: string): ReduxSelectorPattern[]
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |

**Returns:** `ReduxSelectorPattern[]`

<!-- source: interface-dnsrecordspec.md -->

# DnsRecordSpec

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/lib/api-client.ts` (line 52)

## Properties

| Property | Type |
|---|---|
| `type` | `'CNAME' | 'TXT'` |
| `name` | `string` |
| `expected` | `string` |

<!-- source: service-docautomationschedulerservice.md -->

# DocAutomationSchedulerService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/doc-automation-scheduler.service.ts` (line 8)

Phase 5: Cron-based scheduled documentation regeneration.
Uses setInterval-based scheduling (no external cron dependency needed).

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleInit` | `onModuleInit()` | `unknown` |
| `onModuleDestroy` | `onModuleDestroy()` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: function-formatshortdate.md -->

# formatShortDate

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/formatters.ts` (line 55)

Format a YYYY-MM-DD date string as a short month/day label for chart axes.
Uses UTC parsing to avoid the local-timezone day boundary surprise.

## Signature

```ts
function formatShortDate(isoDay: string): string
```

## Parameters

| Name | Type |
|---|---|
| `isoDay` | `string` |

**Returns:** `string`

<!-- source: type-frontendframework.md -->

# FrontendFramework

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/framework.types.ts` (line 15)

Framework Detection Types

Types for auto-detecting project tech stacks.
Supports React, Vue, Angular, Next.js, Svelte, and various backends.

## Definition

```ts
| 'react'
  | 'nextjs'
  | 'vue'
  | 'nuxt'
  | 'angular'
  | 'svelte'
  | 'sveltekit'
  | 'solid'
  | 'qwik'
  | 'unknown'
```

<!-- source: controller-manualsinsightscontroller.md -->

# ManualsInsightsController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/manuals-insights/manuals-insights.controller.ts` (line 12)

Content-Intelligence loop (M1). Two surfaces:
 - authed, org-scoped insights for the manual-authoring cockpit
 - a PUBLIC per-slug freshness check for the reader-facing "may be out of date" badge

## Relationships

- MODULE_DECLARES → `insights`
- MODULE_DECLARES → `deflection`
- MODULE_DECLARES → `ticketTopics`
- MODULE_DECLARES → `draftTicketTopic`
- MODULE_DECLARES → `freshness`
- DEPENDS_ON → `manualsinsightsservice`

<!-- source: class-memorybackend.md -->

# MemoryBackend

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/checkpoint-backend.ts` (line 83)

**Implements:** `CheckpointBackend`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `save` | `save(snap: Snapshot)` | `void` |
| `load` | `load(relPath: string)` | `Snapshot[]` |
| `loadLatest` | `loadLatest(relPath: string)` | `Snapshot | null` |
| `deleteFile` | `deleteFile(relPath: string)` | `void` |
| `deleteFrom` | `deleteFrom(relPath: string, fromIndex: number)` | `void` |
| `getTrackedFiles` | `getTrackedFiles()` | `string[]` |
| `getTotalCount` | `getTotalCount()` | `number` |
| `getSnapshotCount` | `getSnapshotCount(relPath: string)` | `number` |
| `clear` | `clear()` | `void` |
| `evictOldest` | `evictOldest()` | `boolean` |

<!-- source: constant-onboardingchecklisttemplate.md -->

# onboardingChecklistTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/onboarding-checklist.template.ts` (line 3)

<!-- source: function-parsedevice.md -->

# parseDevice

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/analytics/utils/tracking-utils.ts` (line 60)

Derive a coarse device class from the user-agent string. Order matters:
we check mobile first (since "Android Mobile" includes both keywords),
then tablet, then desktop, then fall back to unknown.

## Signature

```ts
function parseDevice(userAgent: string | null | undefined): DeviceClass
```

## Parameters

| Name | Type |
|---|---|
| `userAgent` | `string | null | undefined` |

**Returns:** `DeviceClass`

<!-- source: interface-parsejobpayload.md -->

# ParseJobPayload

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/config.interface.ts` (line 262)

Job payload for parse queue

## Properties

| Property | Type |
|---|---|
| `jobId` | `string` |
| `projectId` | `string` |
| `files` | `string[]` |
| `parserType` | `string` |
| `config` | `Record<string, unknown>` |
| `priority` | `number` |
| `createdAt` | `Date` |

<!-- source: module-parsermodule.md -->

# ParserModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/parser/parser.module.ts` (line 12)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_DECLARES → `parsercontroller`
- MODULE_PROVIDES → `parserservice`
- MODULE_PROVIDES → `typescriptparser`
- MODULE_PROVIDES → `javascriptparser`
- MODULE_PROVIDES → `pythonparser`
- MODULE_PROVIDES → `symbolindexservice`
- MODULE_EXPORTS → `parserservice`
- MODULE_EXPORTS → `symbolindexservice`

<!-- source: component-problemsplitvisual.md -->

# ProblemSplitVisual

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/problem/problem-split-visual.tsx` (line 28)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `problems` | `Problem[]` | ✓ | - |
| `imageSrc` | `string` | ✓ | - |
| `imageAlt` | `string` | ✓ | - |
| `imagePosition` | `unknown | unknown` | - | "start" |

## Diagram

```mermaid
graph TD
    component_ProblemSplitVisual_1b95cbc["ProblemSplitVisual"]
    class component_ProblemSplitVisual_1b95cbc rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: interface-productknowledgeresult.md -->

# ProductKnowledgeResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 240)

Unified result shape from query_product_knowledge.

## Properties

| Property | Type |
|---|---|
| `mode` | `ProductKnowledgeMode` |
| `projectId` | `string` |
| `found` | `number` |
| `features` | `ProductFeature[]` |
| `workflows` | `ProductWorkflow[]` |
| `categories` | `ProductCategory[]` |
| `documents` | `ProductDocument[]` |
| `stats` | `ProductStats` |
| `audiences` | `ProductAudience[]` |
| `screenshots` | `ProductScreenshot[]` |

<!-- source: interface-strategydependencies.md -->

# StrategyDependencies

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/agents/strategy.agent.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `searchFn` | `DocSearchFn` |
| `findScreenshotsFn` | `FindScreenshotsFn` |

<!-- source: function-takescreenshot.md -->

# takeScreenshot

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 41)

Take a screenshot with a descriptive name

## Signature

```ts
async function takeScreenshot(page: Page, name: string): Promise<Buffer>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |
| `name` | `string` |

**Returns:** `Promise<Buffer>`

<!-- source: class-validateselectorsresponsedto.md -->

# ValidateSelectorsResponseDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 803)

Response from selector validation

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `success` | `boolean` |
| `results` | `Record<string, SelectorValidationResult>` |
| `allFound` | `boolean` |
| `allVisible` | `boolean` |
| `missingSelectors` | `string[]` |
| `suggestions` | `Record<string, string>` |

<!-- source: class-visibilityfilter.md -->

# VisibilityFilter

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/visibility-filter.ts` (line 35)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `filter` | `filter(entities: Entity[], config: VisibilityFilterConfig)` | `FilteredEntities` |
| `generateFilterUI` | `generateFilterUI(config: VisibilityFilterConfig)` | `string` |
| `generateFrontmatter` | `generateFrontmatter(entity: Entity)` | `Record<string, unknown>` |

<!-- source: constant-applyblocktype.md -->

# applyBlockType$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 791)

Allows you to change the block type of the current selection.

<!-- source: interface-approvalsubcategory.md -->

# ApprovalSubcategory

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 94)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `documents` | `ApprovalDocument[]` |

<!-- source: component-bare.md -->

# Bare

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 36)

## Diagram

```mermaid
graph TD
    component_Bare_f48fc["Bare"]
    class component_Bare_f48fc rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useRef`

<!-- source: component-categorynode.md -->

# CategoryNode

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Categories/CategoryTreeSidebar.tsx` (line 59)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `category` | `unknown` | ✓ | - |
| `selectedCategoryId` | `string | null` | - | - |
| `onSelect` | `Function` | ✓ | - |
| `onEdit` | `Function` | - | - |
| `onDelete` | `Function` | - | - |
| `editMode` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_CategoryNode_70f0830f["CategoryNode"]
    class component_CategoryNode_70f0830f rootComponent
```

## Relationships

- RENDERS → `GripVertical`
- RENDERS → `CategoryIcon`
- RENDERS → `FolderIcon`
- RENDERS → `PencilIcon`
- RENDERS → `TrashIcon`
- USES_HOOK → `useSortable`

## Referenced By

- `CategoryTreeSidebar` (RENDERS)

<!-- source: interface-cloneresult.md -->

# CloneResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/parsing/git-clone.service.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `success` | `boolean` |
| `localPath` | `string` |
| `error` | `string` |

<!-- source: interface-compactionevent.md -->

# CompactionEvent

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/compaction-types.ts` (line 139)

## Properties

| Property | Type |
|---|---|
| `version` | `number` |
| `timestamp` | `number` |
| `itemsCompacted` | `number` |
| `tokensBefore` | `number` |
| `tokensAfter` | `number` |
| `method` | `'model' | 'heuristic'` |
| `durationMs` | `number` |

<!-- source: api-endpoint-compare.md -->

# compare

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 174)

## Endpoint

`GET /documents/:id/compare`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `dto` | query | `CompareDocumentDto` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: function-createclaudeprovider.md -->

# createClaudeProvider

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/claude.provider.ts` (line 623)

Create a Claude provider from environment configuration

## Signature

```ts
function createClaudeProvider(config: Partial<ClaudeConfig>): ClaudeProvider
```

## Parameters

| Name | Type |
|---|---|
| `config` | `Partial<ClaudeConfig>` |

**Returns:** `ClaudeProvider`

<!-- source: class-createdocversiondto.md -->

# CreateDocVersionDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/doc-version/dto/doc-version.dto.ts` (line 5)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `label` | `string` |
| `description` | `string` |
| `commitHash` | `string` |
| `branch` | `string` |
| `gitTag` | `string` |
| `previousVersionId` | `string` |

<!-- source: function-createeditfiletool.md -->

# createEditFileTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/edit-file.tool.ts` (line 61)

## Signature

```ts
function createEditFileTool(options: EditFileOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `EditFileOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-createqaagent.md -->

# createQaAgent

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/agents/qa.agent.ts` (line 27)

## Signature

```ts
function createQaAgent(config: GenerationConfig, deps: QaDependencies, qaConfig: QaConfig): AgentConfig<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |
| `deps` | `QaDependencies` |
| `qaConfig` | `QaConfig` |

**Returns:** `AgentConfig<PmeContext>`

<!-- source: class-crossstackmapper.md -->

# CrossStackMapper

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-03-features/cross-stack-mapper.ts` (line 89)

Cross-Stack Mapper

Maps frontend to backend features to understand full-stack data flow.

**Implements:** `ICrossStackMapper`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `mapCrossStackFeatures` | `mapCrossStackFeatures(chunks: Chunk[], features: UserFeature[])` | `CrossStackMappingResult` |

<!-- source: interface-databaseschemadiagramresult.md -->

# DatabaseSchemaDiagramResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/database-schema-diagram.generator.ts` (line 72)

Result of database schema diagram generation

## Properties

| Property | Type |
|---|---|
| `mermaidCode` | `string` |
| `stats` | `{
    /** Number of models in diagram */
    modelCount: number;
    /** Total number of fields across all models */
    totalFields: number;
    /** Number of relationships */
    relationshipCount: number;
    /** Number of indexes */
    indexCount: number;
    /** Models included */
    modelsIncluded: string[];
  }` |

<!-- source: function-detectsemanticpatterns.md -->

# detectSemanticPatterns

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/semantic-detector.ts` (line 273)

Detect all semantic patterns in code

Main entry point that runs all detection algorithms and
returns comprehensive semantic metadata.

## Signature

```ts
function detectSemanticPatterns(code: string): SemanticMetadata
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |

**Returns:** `SemanticMetadata`

<!-- source: service-docautomationservice.md -->

# DocAutomationService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/doc-automation.service.ts` (line 96)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleInit` | `onModuleInit()` | `Promise<void>` |
| `onModuleDestroy` | `onModuleDestroy()` | `Promise<void>` |
| `createConfig` | `createConfig(dto: CreateDocAutomationConfigDto, user: JwtPayload)` | `unknown` |
| `getConfig` | `getConfig(projectId: string, user: JwtPayload)` | `unknown` |
| `updateConfig` | `updateConfig(projectId: string, dto: UpdateDocAutomationConfigDto, user: JwtPayload)` | `unknown` |
| `deleteConfig` | `deleteConfig(projectId: string, user: JwtPayload)` | `unknown` |
| `triggerJobFromWebhook` | `triggerJobFromWebhook(opts: {
    projectId: string;
    organizationId: string;
    branch?: string;
    commitHash?: string;
    provider: string;          // 'github' | 'gitlab' | 'azure-devops'
    event: string;             // 'push' | 'tag_create' | 'release'
  })` | `Promise<{ jobId: string; status: string }>` |
| `startJob` | `startJob(dto: StartDocJobDto, user: JwtPayload)` | `unknown` |
| `getJob` | `getJob(jobId: string, user: JwtPayload)` | `unknown` |
| `listJobs` | `listJobs(filters: JobFiltersDto, user: JwtPayload)` | `unknown` |
| `reportExternalProgress` | `reportExternalProgress(jobId: string, body: {
      stage: string;
      progress: number;
      stageProgress?: number;
      currentItem?: string;
      eventType?: string;
    }, user: JwtPayload)` | `Promise<{ ok: true }>` |
| `runUploadOnExistingJob` | `runUploadOnExistingJob(jobId: string, externalOutputPath: string, user: JwtPayload, options: { updateAssetsOnly?: boolean; onlySlugs?: string[] })` | `Promise<{ ok: true }>` |
| `cancelJob` | `cancelJob(jobId: string, user: JwtPayload)` | `unknown` |
| `updateJobProgress` | `updateJobProgress(jobId: string, update: JobProgressUpdate)` | `unknown` |
| `completeJob` | `completeJob(jobId: string, data: JobCompletionData)` | `unknown` |
| `failJob` | `failJob(jobId: string, data: JobFailureData)` | `unknown` |
| `deleteJobDocuments` | `deleteJobDocuments(jobId: string, user: JwtPayload)` | `unknown` |
| `triggerBackgroundScreenshots` | `triggerBackgroundScreenshots(jobId: string, user: JwtPayload)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `docautomationgateway`
- DEPENDS_ON → `urlservice`
- DEPENDS_ON → `assetsservice`
- DEPENDS_ON → `documentindexingservice`
- DEPENDS_ON → `aiusageservice`
- DEPENDS_ON → `queue`
- DEPENDS_ON → `azureclaudeprovider`
- DEPENDS_ON → `docversionservice`
- DEPENDS_ON → `versioncarryforwardservice`
- DEPENDS_ON → `notificationservice`
- DEPENDS_ON → `emailservice`

<!-- source: interface-documentationconfig.md -->

# DocumentationConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationConfig.ts` (line 34)

Project auto-doc configuration

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `repositoryUrl` | `string` |
| `repositoryBranch` | `string` |
| `frontendPath` | `string` |
| `backendPath` | `string` |
| `siteUrl` | `string` |
| `siteLoginUrl` | `string` |
| `siteEmail` | `string` |
| `sitePassword` | `string` |
| `repoUsername` | `string` |
| `repoPassword` | `string` |
| `skeletonStructure` | `SkeletonStructure` |
| `targetAudience` | `string` |
| `autoPublish` | `boolean` |
| `createdAt` | `string` |
| `updatedAt` | `string` |

<!-- source: function-gaptokens.md -->

# gapTokens

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/copilotUtils.ts` (line 95)

Case-insensitive tokens, length ≥ 3, stopwords removed, deduped.

## Signature

```ts
function gapTokens(text: string): string[]
```

## Parameters

| Name | Type |
|---|---|
| `text` | `string` |

**Returns:** `string[]`

<!-- source: type-heading-level.md -->

# HEADING_LEVEL

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/headings/index.ts` (line 27)

## Definition

```ts
1 | 2 | 3 | 4 | 5 | 6
```

<!-- source: class-memorymanager.md -->

# MemoryManager

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/memory/memory-manager.ts` (line 45)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `mark` | `mark(memory: SessionMemory, relatedFiles: string[])` | `string` |
| `recall` | `recall(query: Partial<Omit<MemoryQuery, 'projectId'>>)` | `MemoryRecord[]` |
| `extractAndPersist` | `extractAndPersist(ctx: SessionContext)` | `Promise<number>` |
| `formatForContext` | `formatForContext(memories: MemoryRecord[])` | `string` |
| `get` | `get(id: string)` | `MemoryRecord | null` |
| `delete` | `delete(id: string)` | `boolean` |
| `search` | `search(search: string, limit: number)` | `MemoryRecord[]` |
| `consolidate` | `consolidate()` | `ConsolidationReport` |
| `count` | `count()` | `number` |
| `getProjectId` | `getProjectId()` | `string` |

<!-- source: controller-notificationcontroller.md -->

# NotificationController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/notification/notification.controller.ts` (line 13)

Reader API for the in-app notification feed (navbar bell). The producers
(comments, mentions, docs-generation completion hooks) already write rows;
this controller is what finally makes them readable — journey fix P1.d
"The Silent Factory". Every route is scoped to the JWT caller.

`NotificationController` is a NestJS reader API for the in-app notification feed (the navbar bell). It exposes JWT-scoped endpoints that let the authenticated caller list/read their notification rows and update read state, while producers (comments, mentions, doc-generation hooks) only write the underlying records. This controller is the “last mile” that makes notification data consumable per user.

## Diagram

```mermaid
graph LR
  A[Producers<br/>(comments, mentions, docs hooks)] -->|write rows| B[(Notifications Store)]
  C[JWT Caller<br/>(web app)] -->|HTTP requests| D[NotificationController]
  D -->|auth scope: caller| E[NotificationService/Queries]
  E -->|read / update read state| B
  D -->|DTO response| C
```

## Usage

```ts
// Client-side example (e.g., web app) calling the NotificationController endpoints.
// Assumes the controller is mounted under /notification (common NestJS convention).
// Adjust paths to match your actual route decorators.

async function fetchNotifications(jwt: string) {
  const res = await fetch(`${process.env.API_URL}/notification`, {
    method: "GET",
    headers: { Authorization: `Bearer ${jwt}` },
  });

  if (!res.ok) throw new Error(`Failed to fetch notifications: ${res.status}`);
  return (await res.json()) as {
    items: Array<{ id: string; title?: string; createdAt: string; readAt?: string }>;
    nextCursor?: string;
  };
}

async function markNotificationRead(jwt: string, id: string) {
  const res = await fetch(`${process.env.API_URL}/notification/${id}/read`, {
    method: "POST",
    headers: { Authorization: `Bearer ${jwt}` },
  });

  if (!res.ok) throw new Error(`Failed to mark read: ${res.status}`);
  return res.json();
}

async function markAllRead(jwt: string) {
  const res = await fetch(`${process.env.API_URL}/notification/read-all`, {
    method: "POST",
    headers: { Authorization: `Bearer ${jwt}` },
  });

  if (!res.ok) throw new Error(`Failed to mark all read: ${res.status}`);
  return res.json();
}
```

## AI Coding Instructions

- Keep every route strictly scoped to the JWT caller (never accept a `userId` param/body for reads or mutations; derive identity from the auth context/guard).
- Follow the existing read-model pattern: producers write notification rows; the controller should only read/ack/update read state, not generate notifications.
- Ensure pagination/filtering is stable and deterministic (e.g., cursor-based by `createdAt`/`id`), and always apply the caller scope before ordering/limits.
- Be careful with “mark as read” operations: enforce ownership checks at the query level to prevent cross-user updates and avoid leaking existence via error messages.
- Maintain contract consistency for the navbar bell: lightweight list endpoint + unread count/read-state updates; coordinate DTO changes with frontend consumers.

## Relationships

- MODULE_DECLARES → `list`
- MODULE_DECLARES → `markRead`
- MODULE_DECLARES → `readAll`
- DEPENDS_ON → `notificationservice`

<!-- source: constant-oneononetemplate.md -->

# oneOnOneTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/one-on-one.template.ts` (line 3)

<!-- source: function-parseenrichmentcontent.md -->

# parseEnrichmentContent

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-materializer.service.ts` (line 124)

Parse an AI_ENRICHMENT Document's MDX (written by TechnicalDocsEnrichmentService — a
fingerprint comment, then `### Description / ### Diagram / ### Usage Example /
### AI Coding Instructions` sections) into the EntityEnrichment shape renderEntityPage
merges. Server-side twin of the web entity page's fingerprint-strip + section renderer.

## Signature

```ts
function parseEnrichmentContent(content: string): EntityEnrichment | null
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |

**Returns:** `EntityEnrichment | null`

<!-- source: interface-parsemetadata.md -->

# ParseMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/parse-result.interface.ts` (line 144)

Metadata about the parse operation

## Properties

| Property | Type |
|---|---|
| `duration` | `number` |
| `linesOfCode` | `number` |
| `fileSize` | `number` |
| `language` | `string` |
| `framework` | `string` |
| `fileHash` | `string` |
| `complexity` | `number` |

<!-- source: module-parsingmodule.md -->

# ParsingModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/parsing/parsing.module.ts` (line 9)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_DECLARES → `parsingcontroller`
- MODULE_DECLARES → `testconnectioncontroller`
- MODULE_PROVIDES → `parsingservice`
- MODULE_PROVIDES → `parsingqueue`
- MODULE_PROVIDES → `gitcloneservice`
- MODULE_EXPORTS → `parsingservice`
- MODULE_EXPORTS → `gitcloneservice`

<!-- source: interface-productscreenshot.md -->

# ProductScreenshot

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 226)

A product screenshot linked to a feature/page.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `url` | `string` |
| `title` | `string` |
| `description` | `string` |
| `width` | `number` |
| `height` | `number` |
| `viewport` | `string` |
| `featureArea` | `string` |
| `pageType` | `string` |
| `tags` | `string[]` |

<!-- source: component-socialproofstatsgrid.md -->

# SocialProofStatsGrid

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/social-proof/social-proof-stats-grid.tsx` (line 14)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | - | - |
| `descriptionKey` | `string` | - | - |
| `stats` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SocialProofStatsGrid_d1dcef0["SocialProofStatsGrid"]
    class component_SocialProofStatsGrid_d1dcef0 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `StatCard`
- USES_HOOK → `useTranslation`

<!-- source: interface-strategydocument.md -->

# StrategyDocument

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 239)

Output from the strategy agent — feeds into generation config.

## Properties

| Property | Type |
|---|---|
| `audience` | `{
    primary: string;
    painPoints: string[];
    goals: string[];
  }` |
| `valueProposition` | `string` |
| `tone` | `{
    voice: string;
    adjectives: string[];
    avoidTerms: string[];
  }` |
| `differentiators` | `string[]` |
| `sections` | `{
    priority: SectionType[];
    emphasis: Partial<Record<SectionType, string>>;
  }` |
| `visual` | `{
    theme: ThemeConfig;
    strategy: VisualStrategy;
    mockupTypes: MockupType[];
    enableVariants: boolean;
    enableThemeToggle: boolean;
    layouts?: Partial<Record<SectionType, string>>;
  }` |
| `confirmed` | `boolean` |

<!-- source: class-viewportdto.md -->

# ViewportDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 161)

Viewport configuration DTO

Defines browser viewport dimensions and device characteristics

## Properties

| Property | Type |
|---|---|
| `width` | `number` |
| `height` | `number` |
| `deviceScaleFactor` | `number` |
| `isMobile` | `boolean` |
| `hasTouch` | `boolean` |

<!-- source: class-vueparser-2.md -->

# VueParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/frontend/vue.parser.ts` (line 108)

Vue Parser

Pure TypeScript class that parses Vue Single File Components.
No NestJS dependencies required.

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `supportedPatterns` | `string[]` |

<!-- source: function-waitforapirequest.md -->

# waitForAPIRequest

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 187)

Wait for API request to complete

## Signature

```ts
async function waitForAPIRequest(page: Page, urlPattern: string | RegExp): Promise<{ request: Request; response: Response | null }>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |
| `urlPattern` | `string | RegExp` |

**Returns:** `Promise<{ request: Request; response: Response | null }>`

<!-- source: constant-applyformat.md -->

# applyFormat$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 194)

Applies the published format to the current selection.

<!-- source: interface-atloriaconfig.md -->

# AtloriaConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/types/api-client.ts` (line 265)

Configuration for the Atloria provider

## Properties

| Property | Type |
|---|---|
| `apiUrl` | `string` |
| `token` | `string` |

<!-- source: component-bare-2.md -->

# Bare

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/maxlength.tsx` (line 5)

## Diagram

```mermaid
graph TD
    component_Bare_43abf273["Bare"]
    class component_Bare_43abf273 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: component-changepairblock.md -->

# ChangePairBlock

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/documents/[id]/compare/page.tsx` (line 903)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `pair` | `ChangePair` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ChangePairBlock_32a6f2c["ChangePairBlock"]
    class component_ChangePairBlock_32a6f2c rootComponent
```

## Relationships

- RENDERS → `MarkdownRenderer`

## Referenced By

- `TimelineCard` (RENDERS)

<!-- source: interface-codeexample.md -->

# CodeExample

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/feature-detector.service.ts` (line 6)

Code example extracted from component

## Properties

| Property | Type |
|---|---|
| `language` | `string` |
| `code` | `string` |
| `description` | `string` |
| `source` | `string` |
| `lineStart` | `number` |
| `lineEnd` | `number` |

<!-- source: interface-compactionstrategy.md -->

# CompactionStrategy

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/context-manager.ts` (line 26)

Pluggable strategy for deciding what to preserve during compaction.
Domain-specific — agent-core provides the interface, pme-core implements it.

<!-- source: api-endpoint-compareversions.md -->

# compareVersions

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 66)

## Endpoint

`GET /doc-versions/:projectId/compare`

| Parameter | In | Type | Required |
|---|---|---|---|
| `from` | query | `string` | ✓ |
| `to` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: function-createemptyselectors.md -->

# createEmptySelectors

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 133)

Create an empty selectors object

## Signature

```ts
function createEmptySelectors(): ExtractedSelectors
```

**Returns:** `ExtractedSelectors`

<!-- source: function-createemptysummary.md -->

# createEmptySummary

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/context/model-compactor.ts` (line 155)

## Signature

```ts
function createEmptySummary(): CompactionSummary
```

**Returns:** `CompactionSummary`

<!-- source: class-createentitydto.md -->

# CreateEntityDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/graph/dto/create-entity.dto.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `type` | `EntityType` |
| `name` | `string` |
| `description` | `string` |
| `documentId` | `string` |
| `metadata` | `Record<string, any>` |

<!-- source: function-createquerydocstool.md -->

# createQueryDocsTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/query-docs.tool.ts` (line 24)

## Signature

```ts
function createQueryDocsTool(searchFn: DocSearchFn): ToolDefinition<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `searchFn` | `DocSearchFn` |

**Returns:** `ToolDefinition<PmeContext>`

<!-- source: interface-defaultexport.md -->

# DefaultExport

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/storybook/types.ts` (line 84)

Default export metadata

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `component` | `string` |
| `subcomponents` | `Record<string, string>` |
| `args` | `Record<string, unknown>` |
| `argTypes` | `Record<string, ArgType>` |
| `parameters` | `Record<string, unknown>` |
| `decorators` | `string[]` |
| `tags` | `string[]` |
| `locStart` | `number` |
| `locEnd` | `number` |

<!-- source: function-detectstateenums.md -->

# detectStateEnums

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/semantic-detector.ts` (line 69)

Detect state enum definitions

Finds enums with "Stage", "Status", or "State" in their name.

## Signature

```ts
function detectStateEnums(code: string): string[]
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |

**Returns:** `string[]`

<!-- source: class-directivenode.md -->

# DirectiveNode

**Kind:** Class

**Source:** `atloria-monorepo/packages/editor/src/plugins/directives/DirectiveNode.tsx` (line 27)

**Extends:** `DecoratorNode`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getType` | `getType()` | `string` |
| `clone` | `clone(node: DirectiveNode)` | `DirectiveNode` |
| `importJSON` | `importJSON(serializedNode: SerializedDirectiveNode)` | `DirectiveNode` |
| `getMdastNode` | `getMdastNode()` | `Directives` |
| `exportJSON` | `exportJSON()` | `SerializedDirectiveNode` |
| `createDOM` | `createDOM()` | `HTMLElement` |
| `updateDOM` | `updateDOM()` | `false` |
| `setMdastNode` | `setMdastNode(mdastNode: Directives)` | `void` |
| `decorate` | `decorate(parentEditor: LexicalEditor, config: EditorConfig)` | `JSX.Element` |
| `isInline` | `isInline()` | `boolean` |
| `isKeyboardSelectable` | `isKeyboardSelectable()` | `boolean` |

## Properties

| Property | Type |
|---|---|
| `__mdastNode` | `Directives` |
| `__focusEmitter` | `any` |
| `select` | `any` |

<!-- source: interface-documentationjob.md -->

# DocumentationJob

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationGenerator.ts` (line 14)

Documentation job data

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `status` | `JobStatus` |
| `progress` | `number` |
| `currentStage` | `string | null` |
| `stageProgress` | `number` |
| `currentItem` | `string | null` |
| `documentsCreated` | `number` |
| `documentsUpdated` | `number` |
| `screenshotsCaptured` | `number` |
| `createdAt` | `string` |
| `updatedAt` | `string` |
| `completedAt` | `string` |

<!-- source: service-documentationservice.md -->

# DocumentationService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/documentation.service.ts` (line 10)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generateUserDocumentation` | `generateUserDocumentation(dto: GenerateUserDocsDto, user: JwtPayload)` | `Promise<GeneratedDocumentation | SyncBatchResponseDto>` |

## Relationships

- DEPENDS_ON → `workflowdetectorservice`
- DEPENDS_ON → `userdocsgeneratorservice`
- DEPENDS_ON → `azureclaudeprovider`

<!-- source: function-generatemetadata.md -->

# generateMetadata

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/layout.tsx` (line 15)

SERVER layout for published docs sites: crawlers get real <title>/description/OG/
canonical in the initial HTML (the interactive shell stayed a client component —
see PublicLayoutShell). Metadata degrades gracefully when the API is unreachable.

## Signature

```ts
async function generateMetadata({ params }: { params: Promise<{ slugId: string }> }): Promise<Metadata>
```

## Parameters

| Name | Type |
|---|---|
| `{ params }` | `{ params: Promise<{ slugId: string }> }` |

**Returns:** `Promise<Metadata>`

<!-- source: type-imagepreviewhandler.md -->

# ImagePreviewHandler

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 51)

## Definition

```ts
((imageSource: string) => Promise<string>) | null
```

<!-- source: class-messagebus.md -->

# MessageBus

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/tools/send-message.tool.ts` (line 23)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `registerAgent` | `registerAgent(name: string, hook: InjectionTurnHook<any>)` | `void` |
| `unregisterAgent` | `unregisterAgent(name: string)` | `void` |
| `getHook` | `getHook(name: string)` | `InjectionTurnHook<any> | undefined` |
| `listAgents` | `listAgents()` | `string[]` |
| `enqueue` | `enqueue(name: string, message: string)` | `boolean` |

<!-- source: controller-opscontroller.md -->

# OpsController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/ops/ops.controller.ts` (line 8)

Admin cockpit (Phase 2.3) — org-scoped operational overview.

## Relationships

- MODULE_DECLARES → `overview`
- DEPENDS_ON → `opsservice`

<!-- source: interface-parseprojectconfig.md -->

# ParseProjectConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/config.interface.ts` (line 217)

Project parse configuration

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `parsers` | `string[]` |
| `includePatterns` | `string[]` |
| `excludePatterns` | `string[]` |
| `incremental` | `boolean` |
| `maxFiles` | `number` |
| `parallel` | `boolean` |
| `metadata` | `Record<string, unknown>` |

<!-- source: constant-plan-enum.md -->

# PLAN_ENUM

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/billing/billing.constants.ts` (line 40)

Maps the public checkout plan key to the OrganizationPlan enum value.

## Definition

```ts
Record<BillingPlanKey, 'PRO' | 'BUSINESS'>
```

<!-- source: module-pmemodule.md -->

# PmeModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/pme/pme.module.ts` (line 9)

## Relationships

- MODULE_DECLARES → `pmecontroller`
- MODULE_PROVIDES → `pmeservice`
- MODULE_PROVIDES → `pmegateway`
- MODULE_EXPORTS → `pmeservice`
- MODULE_EXPORTS → `pmegateway`

<!-- source: interface-productstats.md -->

# ProductStats

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 205)

Aggregate product stats from the knowledge graph.

## Properties

| Property | Type |
|---|---|
| `entityCount` | `number` |
| `apiEndpointCount` | `number` |
| `componentCount` | `number` |
| `modelCount` | `number` |
| `featureCount` | `number` |
| `documentCount` | `number` |
| `screenshotCount` | `number` |
| `categoryCount` | `number` |

<!-- source: function-public.md -->

# Public

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/auth/decorators/public.decorator.ts` (line 4)

<!-- source: component-socialprooftestimonials.md -->

# SocialProofTestimonials

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/social-proof/social-proof-testimonials.tsx` (line 22)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | - | - |
| `descriptionKey` | `string` | - | - |
| `testimonials` | `Testimonial[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SocialProofTestimonials_19216229["SocialProofTestimonials"]
    class component_SocialProofTestimonials_19216229 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `TestimonialCard`
- USES_HOOK → `useTranslation`

<!-- source: interface-themeconfig.md -->

# ThemeConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 39)

## Properties

| Property | Type |
|---|---|
| `mode` | `ThemeMode` |
| `primaryColor` | `string` |
| `fontFamily` | `string` |

<!-- source: class-waitfordto.md -->

# WaitForDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/screenshot-worker/src/app/screenshot/dto/batch-screenshot.dto.ts` (line 123)

Wait condition DTO for page readiness

Supports various wait strategies:
- selector: Wait for element to appear
- timeout: Wait for fixed duration
- networkIdle: Wait for network to be idle
- loadState: Wait for page load state
- function: Wait for JS expression to be truthy

## Properties

| Property | Type |
|---|---|
| `type` | `WaitType` |
| `selector` | `string` |
| `duration` | `number` |
| `state` | `LoadState` |
| `function` | `string` |
| `timeout` | `number` |

<!-- source: function-waitforelement.md -->

# waitForElement

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 14)

Wait for an element to be visible and stable

## Signature

```ts
async function waitForElement(page: Page, selector: string, options: { timeout?: number }): Promise<Locator>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |
| `selector` | `string` |
| `options` | `{ timeout?: number }` |

**Returns:** `Promise<Locator>`

<!-- source: class-yamlparser-2.md -->

# YamlParser

**Kind:** Class

**Source:** `atloria-monorepo/libs/parser-core/src/parsers/config-docs/yaml.parser.ts` (line 44)

YAML Parser implementation

**Implements:** `IParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `initialize` | `initialize(_config: ParserConfig)` | `Promise<void>` |
| `canParse` | `canParse(filePath: string)` | `boolean` |
| `parseFile` | `parseFile(filePath: string, content: string)` | `Promise<ParseResult>` |
| `parseFiles` | `parseFiles(files: ParseFileInput[])` | `Promise<ParseResult[]>` |
| `destroy` | `destroy()` | `Promise<void>` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |
| `version` | `any` |
| `supportedPatterns` | `any` |

<!-- source: constant-applylinkchanges.md -->

# applyLinkChanges$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 278)

A signal that confirms the updated values of the current link.

<!-- source: interface-atloriaproviderprops.md -->

# AtloriaProviderProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/providers/AtloriaProvider.tsx` (line 21)

Props for AtloriaProvider

## Properties

| Property | Type |
|---|---|
| `children` | `ReactNode` |
| `apiClient` | `APIClient` |

<!-- source: component-basics.md -->

# Basics

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/link-dialog.tsx` (line 17)

## Diagram

```mermaid
graph TD
    component_Basics_5674c091["Basics"]
    class component_Basics_5674c091 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: component-checkicon.md -->

# CheckIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/CodeViewer.tsx` (line 127)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_CheckIcon_5dee0bde["CheckIcon"]
    class component_CheckIcon_5dee0bde rootComponent
```

## Referenced By

- `CodeViewer` (RENDERS)

<!-- source: interface-codeparser.md -->

# CodeParser

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/parser/interfaces/code-parser.interface.ts` (line 1)

## Properties

| Property | Type |
|---|---|
| `language` | `string` |
| `supportedExtensions` | `string[]` |

<!-- source: interface-compactionsummary.md -->

# CompactionSummary

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/compaction-types.ts` (line 25)

Smart Compaction Types

Structured schema for model-based context compaction.
The CompactionSummary is a persistent, evolving document that captures
everything the agent needs to continue working after context compression.

Anchored Iterative Summarization (Factory.ai pattern):
- First compaction: summarize full history into CompactionSummary v1
- Subsequent compactions: merge NEW items into existing summary (delta merge)
- Code snippets are NEVER summarized — preserved verbatim

## Properties

| Property | Type |
|---|---|
| `sessionGoal` | `string` |
| `progress` | `{
    /** Tasks/steps already completed */
    completed: string[];
    /** What the agent is currently working on */
    inProgress: string;
    /** Known remaining steps */
    remaining: string[];
    /** Things preventing progress */
    blockers: string[];
  }` |
| `fileOperations` | `Array<{
    path: string;
    action: 'created' | 'modified' | 'read' | 'deleted';
    /** What was done or learned from this file */
    keyDetails: string;
  }>` |
| `decisions` | `Array<{
    decision: string;
    rationale: string;
  }>` |
| `errors` | `Array<{
    error: string;
    resolved: boolean;
    resolution?: string;
  }>` |
| `preservedCode` | `Array<{
    file: string;
    snippet: string;
    why: string;
  }>` |
| `domainState` | `Record<string, string>` |

<!-- source: api-endpoint-configuresaml.md -->

# configureSaml

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/saml/saml.controller.ts` (line 64)

Configure SAML for organization
Requires admin access

## Endpoint

`POST /auth/saml/:orgId/configure`

| Parameter | In | Type | Required |
|---|---|---|---|
| `orgId` | query | `string` | ✓ |

## Referenced By

- `SamlController` (MODULE_DECLARES)

<!-- source: function-createerrorfromresponse.md -->

# createErrorFromResponse

**Kind:** Function

**Source:** `atloria-monorepo/packages/api-client/src/types/errors.ts` (line 110)

Create appropriate error from HTTP response

## Signature

```ts
function createErrorFromResponse(status: number, data: unknown): APIError
```

## Parameters

| Name | Type |
|---|---|
| `status` | `number` |
| `data` | `unknown` |

**Returns:** `APIError`

<!-- source: class-createflowdto.md -->

# CreateFlowDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/capture/dto/create-flow.dto.ts` (line 106)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `startUrl` | `string` |
| `steps` | `CapturedStepDto[]` |

<!-- source: function-createglobsearchtool.md -->

# createGlobSearchTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/glob-search.tool.ts` (line 23)

## Signature

```ts
function createGlobSearchTool(options: GlobSearchOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `GlobSearchOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-createseoagent.md -->

# createSeoAgent

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/agents/seo.agent.ts` (line 18)

## Signature

```ts
function createSeoAgent(config: GenerationConfig, deps: SeoDependencies): AgentConfig<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |
| `deps` | `SeoDependencies` |

**Returns:** `AgentConfig<PmeContext>`

<!-- source: interface-dependencyinfo-2.md -->

# DependencyInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 833)

Dependency injection info

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `token` | `string` |
| `optional` | `boolean` |

<!-- source: function-detecttransitionmethods.md -->

# detectTransitionMethods

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/semantic-detector.ts` (line 106)

Detect state transition methods

Finds methods that likely change state based on naming patterns:
- convert*, approve*, reject*, cancel*, regret*, submit*, activate*

## Signature

```ts
function detectTransitionMethods(code: string): string[]
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |

**Returns:** `string[]`

<!-- source: class-directiveparser.md -->

# DirectiveParser

**Kind:** Class

**Source:** `atloria-monorepo/packages/core/src/rendering/directive-parser.ts` (line 61)

Directive Parser

## Methods

| Method | Signature | Returns |
|---|---|---|
| `parse` | `parse(content: string)` | `DocumentAST` |

<!-- source: interface-documentationjobentry.md -->

# DocumentationJobEntry

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationJobs.ts` (line 11)

Job entry with expanded fields returned from the API

## Properties

| Property | Type |
|---|---|
| `error` | `string` |
| `errorStage` | `string` |
| `durationMs` | `number` |
| `completedAt` | `string` |
| `categoriesCreated` | `number` |

<!-- source: service-documentindexingservice.md -->

# DocumentIndexingService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/document-indexing.service.ts` (line 20)

Document Indexing Service

Coordinates documentation indexing to Azure AI Search.

**Synchronization Strategy**:
1. Event-driven: Index immediately after document create/update
2. Batch fallback: Hourly cron job syncs any missed documents

**Multi-Tenancy**: All indexed documents include projectId for filtering

**Database as Source of Truth**: PostgreSQL is authoritative, Azure AI Search is read-optimized replica

`DocumentIndexingService` coordinates synchronizing documentation records from PostgreSQL (source of truth) into Azure AI Search (read-optimized index). It supports immediate, event-driven indexing on document create/update and an hourly batch fallback cron job to catch missed changes. All indexed records include `projectId` to enforce multi-tenant filtering in search queries.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleInit` | `onModuleInit()` | `unknown` |
| `indexWorkflow` | `indexWorkflow(documentId: string, workflow: any, projectId: string, organizationId: string, versionInfo: { docVersionId?: string; versionNumber?: number })` | `Promise<void>` |
| `indexFeature` | `indexFeature(documentId: string, feature: any, projectId: string, organizationId: string, versionInfo: { docVersionId?: string; versionNumber?: number })` | `Promise<void>` |
| `indexTutorial` | `indexTutorial(documentId: string, tutorial: any, projectId: string, organizationId: string, versionInfo: { docVersionId?: string; versionNumber?: number })` | `Promise<void>` |
| `indexMdxDocument` | `indexMdxDocument(documentId: string, document: { title: string; content: string; type?: string; audienceIds?: string[] }, projectId: string, organizationId: string, docVersionId: string, versionNumber: number)` | `Promise<void>` |
| `updateIndexedDocument` | `updateIndexedDocument(documentId: string, documentType: 'workflow' | 'feature' | 'tutorial', content: any, projectId: string, organizationId: string, versionInfo: { docVersionId?: string; versionNumber?: number })` | `Promise<void>` |
| `deleteIndexedDocument` | `deleteIndexedDocument(documentId: string)` | `Promise<void>` |
| `deleteProjectIndex` | `deleteProjectIndex(projectId: string)` | `Promise<void>` |
| `syncUnindexedDocuments` | `syncUnindexedDocuments()` | `Promise<void>` |
| `reindexProject` | `reindexProject(projectId: string)` | `Promise<void>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant App as API/NestJS
  participant DB as PostgreSQL
  participant DIS as DocumentIndexingService
  participant Search as Azure AI Search
  participant Cron as Hourly Cron

  App->>DB: Create/Update Document (projectId, content, metadata)
  DB-->>App: Commit OK
  App->>DIS: Emit/Handle document.changed event
  DIS->>DB: Load authoritative document by id
  DB-->>DIS: Document payload
  DIS->>Search: Upsert document into index (includes projectId)
  Search-->>DIS: Ack

  Cron->>DIS: Run hourly sync job
  DIS->>DB: Query for missed/out-of-sync documents
  DB-->>DIS: List of documents
  loop For each document
    DIS->>Search: Upsert document into index (includes projectId)
    Search-->>DIS: Ack
  end
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { DocumentIndexingService } from './documentation/services/document-indexing.service';

@Injectable()
export class DocumentsEventsHandler {
  constructor(private readonly indexing: DocumentIndexingService) {}

  // Example: called after a document is created/updated (event-driven path)
  async onDocumentChanged(documentId: string) {
    // Implementation detail depends on the service API:
    // call the service method that performs a DB fetch + Azure Search upsert.
    await this.indexing.indexDocumentById(documentId);
  }

  // Example: cron/batch fallback entrypoint (hourly)
  async hourlyReindex() {
    await this.indexing.syncMissedDocuments();
  }
}
```

## AI Coding Instructions

- Always treat PostgreSQL as the source of truth: fetch the latest document from DB before indexing; never rely on stale event payloads for final index content.
- Ensure every Azure AI Search document includes `projectId` and keep it filterable; missing `projectId` breaks multi-tenant isolation.
- Preserve idempotency: indexing operations should be safe to retry (upsert, not insert-only) because events/cron can overlap.
- Keep event-driven and cron paths consistent by reusing the same internal indexing routine (normalization, field mapping, serialization).
- When changing document schema/fields, update both DB-to-index mapping and any Azure Search index configuration (fields, analyzers) in lockstep to avoid runtime indexing errors.

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `azuresearchservice`
- DEPENDS_ON → `keywordextractorservice`

<!-- source: function-generateslug.md -->

# generateSlug

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/useNewProjectWizard.ts` (line 134)

## Signature

```ts
function generateSlug(name: string): string
```

## Parameters

| Name | Type |
|---|---|
| `name` | `string` |

**Returns:** `string`

<!-- source: type-imageuploadfn.md -->

# ImageUploadFn

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 20)

Image upload function type
Takes image buffer and filename, returns CDN URL

## Definition

```ts
(
  buffer: Buffer,
  filename: string,
  mimeType: string
) => Promise<string>
```

<!-- source: class-modelcompactor.md -->

# ModelCompactor

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/model-compactor.ts` (line 176)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `compact` | `compact(items: unknown[])` | `Promise<string>` |
| `getSummary` | `getSummary()` | `CompactionSummary | null` |
| `setSummary` | `setSummary(summary: CompactionSummary)` | `void` |
| `getEvents` | `getEvents()` | `readonly CompactionEvent[]` |
| `formatSummaryForContext` | `formatSummaryForContext()` | `string` |
| `hasPendingCompaction` | `hasPendingCompaction()` | `boolean` |
| `flush` | `flush()` | `Promise<void>` |
| `reset` | `reset()` | `void` |

<!-- source: controller-organizationcontroller.md -->

# OrganizationController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/organization/organization.controller.ts` (line 31)

## Relationships

- MODULE_DECLARES → `list`
- MODULE_DECLARES → `get`
- MODULE_DECLARES → `update`
- MODULE_DECLARES → `getMembers`
- MODULE_DECLARES → `inviteMember`
- MODULE_DECLARES → `getSettings`
- MODULE_DECLARES → `updateSettings`
- MODULE_DECLARES → `getUserAudiences`
- MODULE_DECLARES → `updateUserAudiences`
- DEPENDS_ON → `organizationservice`
- DEPENDS_ON → `invitationservice`

<!-- source: interface-parserconfig.md -->

# ParserConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/parser.interface.ts` (line 17)

Configuration for parser initialization

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `tsconfigPath` | `string` |
| `options` | `Record<string, unknown>` |
| `debug` | `boolean` |
| `excludePatterns` | `string[]` |
| `maxFileSize` | `number` |
| `timeout` | `number` |

<!-- source: constant-plan-monthly-credits.md -->

# PLAN_MONTHLY_CREDITS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/billing/billing.constants.ts` (line 25)

## Definition

```ts
Record<'FREE' | 'PRO' | 'BUSINESS', number>
```

<!-- source: interface-productworkflow.md -->

# ProductWorkflow

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 171)

A user workflow (step-by-step journey through the product).

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `steps` | `Array<{ order: number; action: string; component?: string }>` |
| `featureIds` | `string[]` |

<!-- source: module-projectmodule.md -->

# ProjectModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/project/project.module.ts` (line 27)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `aimodule`
- MODULE_IMPORTS → `brandingmodule`
- MODULE_IMPORTS → `emailmodule`
- MODULE_IMPORTS → `eventsmodule`
- MODULE_IMPORTS → `graphmodule`
- MODULE_IMPORTS → `issuesmodule`
- MODULE_IMPORTS → `supportagentmodule`
- MODULE_IMPORTS → `workflowmodule`
- MODULE_IMPORTS → `forwardref`
- MODULE_IMPORTS → `forwardref`
- MODULE_IMPORTS → `forwardref`
- MODULE_DECLARES → `projectcontroller`
- MODULE_DECLARES → `publicprojectcontroller`
- MODULE_DECLARES → `synccontroller`
- MODULE_PROVIDES → `projectservice`
- MODULE_PROVIDES → `projectdomainsservice`
- MODULE_PROVIDES → `domaindnsservice`
- MODULE_PROVIDES → `k8singressservice`
- MODULE_PROVIDES → `syncservice`
- MODULE_PROVIDES → `syncjobservice`
- MODULE_EXPORTS → `projectservice`
- MODULE_EXPORTS → `syncservice`
- MODULE_EXPORTS → `syncjobservice`

<!-- source: function-querymatchespage.md -->

# queryMatchesPage

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/manuals-insights/manuals-insights.service.ts` (line 45)

Does a support query "resemble" a manual page? True when any meaningful query term
appears in the page's title or slug (fuzzy, term-overlap). Used both ways:
 - weakPages: a miss that DOES resolve to a page → that page is under-serving.
 - topicGaps: a miss that resolves to NO page → the topic is undocumented.

## Signature

```ts
function queryMatchesPage(query: string, page: { title: string; slug: string }): boolean
```

## Parameters

| Name | Type |
|---|---|
| `query` | `string` |
| `page` | `{ title: string; slug: string }` |

**Returns:** `boolean`

<!-- source: component-socialprooftimeline.md -->

# SocialProofTimeline

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/social-proof/social-proof-timeline.tsx` (line 78)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `milestones` | `Milestone[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SocialProofTimeline_4ebf2c89["SocialProofTimeline"]
    class component_SocialProofTimeline_4ebf2c89 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `TimelineDot`
- RENDERS → `MilestoneCard`
- USES_HOOK → `useTranslation`

<!-- source: interface-themevars.md -->

# ThemeVars

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/tools/theme.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `'--bg-page'` | `string` |
| `'--bg-surface'` | `string` |
| `'--bg-surface-alt'` | `string` |
| `'--bg-nav'` | `string` |
| `'--text-heading'` | `string` |
| `'--text-body'` | `string` |
| `'--text-muted'` | `string` |
| `'--text-on-accent'` | `string` |
| `'--accent'` | `string` |
| `'--accent-hover'` | `string` |
| `'--accent-subtle'` | `string` |
| `'--accent-glow'` | `string` |
| `'--border'` | `string` |
| `'--border-hover'` | `string` |

<!-- source: function-waitforloadingcomplete.md -->

# waitForLoadingComplete

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 126)

Wait for loading state to complete

## Signature

```ts
async function waitForLoadingComplete(page: Page): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |

**Returns:** `Promise<void>`

<!-- source: constant-applylisttype.md -->

# applyListType$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/lists/index.ts` (line 91)

Converts the current selection to the specified list type.

<!-- source: interface-audienceandnode.md -->

# AudienceAndNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 110)

## Properties

| Property | Type |
|---|---|
| `type` | `'and'` |
| `operands` | `AudienceLogicTree[]` |

<!-- source: component-basics-2.md -->

# Basics

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/print.stories.tsx` (line 24)

## Diagram

```mermaid
graph TD
    component_Basics_27f741e8["Basics"]
    class component_Basics_27f741e8 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useRef`

<!-- source: component-chip.md -->

# Chip

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/ThreadView.tsx` (line 41)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `bg` | `string` | ✓ | - |
| `text` | `string` | ✓ | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Chip_620c5139["Chip"]
    class component_Chip_620c5139 rootComponent
```

## Referenced By

- `ThreadView` (RENDERS)

<!-- source: interface-collaborationmetrics.md -->

# CollaborationMetrics

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/collaboration/interfaces/collaboration.interfaces.ts` (line 96)

Metrics for collaboration session

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `activeSessionsCount` | `number` |
| `syncLatencyMs` | `number` |
| `lastUpdatedAt` | `Date` |

<!-- source: interface-compactoroptions.md -->

# CompactorOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 405)

Options for the context compactor (reactive compaction).

## Properties

| Property | Type |
|---|---|
| `tokenThreshold` | `number` |
| `compact` | `(items: AgentInputItem[]) => AgentInputItem[] | Promise<AgentInputItem[]>` |

<!-- source: api-endpoint-counts.md -->

# counts

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/desk.controller.ts` (line 52)

## Endpoint

`GET /desk/:projectId/counts`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `DeskController` (MODULE_DECLARES)

<!-- source: function-createfileloader.md -->

# createFileLoader

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-04-analysis/iterative-deep-loader.ts` (line 398)

Create a default file loader that reads from the file system

## Signature

```ts
function createFileLoader(basePath: string): (filePath: string, startLine?: number, endLine?: number) => Promise<string>
```

## Parameters

| Name | Type |
|---|---|
| `basePath` | `string` |

**Returns:** `(filePath: string, startLine?: number, endLine?: number) => Promise<string>`

<!-- source: class-createfromtemplatedto.md -->

# CreateFromTemplateDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/template/dto/create-from-template.dto.ts` (line 8)

DTO for creating a new document from a template.
Contains the necessary information to instantiate a template as a document.

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |

<!-- source: function-creategrepsearchtool.md -->

# createGrepSearchTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/grep-search.tool.ts` (line 42)

## Signature

```ts
function createGrepSearchTool(options: GrepSearchOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `GrepSearchOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-createseometadatatool.md -->

# createSeoMetadataTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/seo-metadata.tool.ts` (line 21)

## Signature

```ts
function createSeoMetadataTool(_generateFn: ContentGenerateFn): ToolDefinition<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `_generateFn` | `ContentGenerateFn` |

**Returns:** `ToolDefinition<PmeContext>`

<!-- source: interface-dependencynode-2.md -->

# DependencyNode

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/relationship.interface.ts` (line 371)

Node in a dependency tree

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `type` | `string` |
| `relationshipType` | `RelationshipType` |
| `children` | `DependencyNode[]` |
| `depth` | `number` |

<!-- source: function-detectuiinteractions.md -->

# detectUIInteractions

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ui-interaction-detector.ts` (line 78)

Extract UI interactions from component template code

Analyzes HTML/JSX templates to find interactive elements (buttons, links)
and maps them to state machine transitions.

## Signature

```ts
function detectUIInteractions(templateCode: string, stateMachines: StateMachine[], componentName: string): UIInteraction[]
```

## Parameters

| Name | Type |
|---|---|
| `templateCode` | `string` |
| `stateMachines` | `StateMachine[]` |
| `componentName` | `string` |

**Returns:** `UIInteraction[]`

<!-- source: class-discoveryclient.md -->

# DiscoveryClient

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/discovery.client.ts` (line 32)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `scan` | `scan(request: DiscoveryScanRequest)` | `Promise<SiteMap>` |

<!-- source: interface-documentlayoutprops.md -->

# DocumentLayoutProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Layout/DocumentLayout.tsx` (line 12)

Props for DocumentLayout

## Properties

| Property | Type |
|---|---|
| `children` | `ReactNode` |
| `organizationId` | `string` |
| `projectId` | `string` |
| `activeDocumentId` | `string` |
| `className` | `string` |
| `onNavigate` | `(node: DocumentTreeNode) => void` |

<!-- source: service-documentpersistenceservice.md -->

# DocumentPersistenceService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/collaboration/document-persistence.service.ts` (line 13)

Service for managing periodic document saves
Handles auto-save functionality for collaborative documents

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleDestroy` | `onModuleDestroy()` | `void` |
| `startPeriodicSave` | `startPeriodicSave(documentId: string, ydoc: Y.Doc, intervalMs: number)` | `() => void` |
| `stopPeriodicSave` | `stopPeriodicSave(documentId: string)` | `void` |
| `stopAllPeriodicSaves` | `stopAllPeriodicSaves()` | `void` |
| `saveDocument` | `saveDocument(documentId: string)` | `Promise<boolean>` |
| `saveAllDocuments` | `saveAllDocuments()` | `Promise<Map<string, boolean>>` |
| `hasPeriodicSave` | `hasPeriodicSave(documentId: string)` | `boolean` |
| `getActiveDocumentCount` | `getActiveDocumentCount()` | `number` |
| `getActiveDocumentIds` | `getActiveDocumentIds()` | `string[]` |
| `updateDocument` | `updateDocument(documentId: string, ydoc: Y.Doc)` | `void` |
| `flushAll` | `flushAll()` | `Promise<void>` |
| `getDocumentContent` | `getDocumentContent(documentId: string)` | `string | null` |
| `hasPendingChanges` | `hasPendingChanges(documentId: string)` | `Promise<boolean>` |

## Relationships

- DEPENDS_ON → `collaborationservice`

<!-- source: function-generateslugpreview.md -->

# generateSlugPreview

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/url-utils.ts` (line 101)

Generate an SEO-friendly slug from a title (client-side)
Note: Use the backend UrlService for authoritative slug generation

## Signature

```ts
function generateSlugPreview(title: string): string
```

## Parameters

| Name | Type |
|---|---|
| `title` | `string` |

**Returns:** `string`

<!-- source: type-imageuploadhandler.md -->

# ImageUploadHandler

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 46)

## Definition

```ts
((image: File) => Promise<string>) | null
```

<!-- source: class-modelrouter.md -->

# ModelRouter

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-router.ts` (line 118)

Resolves the model to use for a given task.

Usage:
```typescript
const router = new ModelRouter(GPT54_FAMILY_ROUTING_TABLE, 'gpt-5.4');
const model = router.route('explore');  // → 'gpt-5.4-nano'
const model = router.route('plan');     // → 'gpt-5.4'
const model = router.route();           // → 'gpt-5.4' (default)
```

## Methods

| Method | Signature | Returns |
|---|---|---|
| `route` | `route(category: TaskCategory, explicitModel: string)` | `string` |
| `isActive` | `isActive()` | `boolean` |
| `summary` | `summary()` | `Record<string, string>` |

<!-- source: controller-parsercontroller.md -->

# ParserController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/parser/parser.controller.ts` (line 9)

## Relationships

- MODULE_DECLARES → `parse`
- MODULE_DECLARES → `parseDocument`
- MODULE_DECLARES → `getSupportedLanguages`
- DEPENDS_ON → `parserservice`

<!-- source: interface-parseresult.md -->

# ParseResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/parse-result.interface.ts` (line 208)

Result of parsing a single file

## Properties

| Property | Type |
|---|---|
| `parserName` | `string` |
| `filePath` | `string` |
| `timestamp` | `Date` |
| `status` | `ParseStatus` |
| `entities` | `Entity[]` |
| `relationships` | `Relationship[]` |
| `errors` | `ParseError[]` |
| `warnings` | `ParseWarning[]` |
| `metadata` | `ParseMetadata` |

<!-- source: constant-plan-price-env.md -->

# PLAN_PRICE_ENV

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/billing/billing.constants.ts` (line 34)

Maps the public checkout plan key to env var holding the Stripe price id.

## Definition

```ts
Record<BillingPlanKey, string>
```

<!-- source: function-redactstepvalue.md -->

# redactStepValue

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/capture/capture.redact.ts` (line 43)

Redact a single step's `value` in place-safe (returns a new value string or
undefined). Applies to input/submit actions only.

## Signature

```ts
function redactStepValue(step: {
  action?: string;
  value?: string;
  selector?: string;
  elementRole?: string;
  elementText?: string;
}): string | undefined
```

## Parameters

| Name | Type |
|---|---|
| `step` | `{
  action?: string;
  value?: string;
  selector?: string;
  elementRole?: string;
  elementText?: string;
}` |

**Returns:** `string | undefined`

<!-- source: module-samlmodule.md -->

# SamlModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/auth/saml/saml.module.ts` (line 9)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `passportmodule`
- MODULE_DECLARES → `samlcontroller`
- MODULE_PROVIDES → `samlservice`
- MODULE_PROVIDES → `samlstrategy`
- MODULE_EXPORTS → `samlservice`

<!-- source: interface-sectionselection.md -->

# SectionSelection

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 48)

## Properties

| Property | Type |
|---|---|
| `sectionId` | `string` |
| `props` | `Record<string, unknown>` |

<!-- source: component-socialprooftrustbadges.md -->

# SocialProofTrustBadges

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/social-proof/social-proof-trust-badges.tsx` (line 36)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | - | - |
| `descriptionKey` | `string` | - | - |
| `badges` | `TrustBadge[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SocialProofTrustBadges_46d5741c["SocialProofTrustBadges"]
    class component_SocialProofTrustBadges_46d5741c rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: interface-variantdependencies.md -->

# VariantDependencies

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/agents/variant.agent.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `searchFn` | `DocSearchFn` |
| `generateFn` | `ContentGenerateFn` |

<!-- source: function-waitformodal.md -->

# waitForModal

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 89)

Wait for a modal/dialog to appear

## Signature

```ts
async function waitForModal(page: Page): Promise<Locator>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |

**Returns:** `Promise<Locator>`

<!-- source: interface-audienceleaf.md -->

# AudienceLeaf

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 100)

## Properties

| Property | Type |
|---|---|
| `type` | `'audience'` |
| `slug` | `string` |

<!-- source: constant-auto-generated-file-patterns.md -->

# AUTO_GENERATED_FILE_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 498)

<!-- source: component-basics-3.md -->

# Basics

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/site-demo.tsx` (line 9)

## Diagram

```mermaid
graph TD
    component_Basics_52672bf["Basics"]
    class component_Basics_52672bf rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useRef`

<!-- source: component-chip-2.md -->

# Chip

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 279)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `label` | `string` | ✓ | - |
| `value` | `string` | ✓ | - |
| `onRemove` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Chip_157f3617["Chip"]
    class component_Chip_157f3617 rootComponent
```

## Relationships

- RENDERS → `XMarkIcon`

## Referenced By

- `ActiveFilterChips` (RENDERS)

<!-- source: interface-collaborationuser-2.md -->

# CollaborationUser

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/collaboration/interfaces/collaboration.interfaces.ts` (line 8)

Interfaces and types for real-time collaboration module

## Properties

| Property | Type |
|---|---|
| `userId` | `string` |
| `userName` | `string` |
| `email` | `string` |
| `avatar` | `string` |
| `color` | `string` |

<!-- source: interface-conditionallayer.md -->

# ConditionalLayer

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/instruction-loader.ts` (line 42)

## Properties

| Property | Type |
|---|---|
| `condition` | `() => boolean` |

<!-- source: api-endpoint-create-2.md -->

# create

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/audience/audience.controller.ts` (line 58)

## Endpoint

`POST /audiences`

## Referenced By

- `AudienceController` (MODULE_DECLARES)

<!-- source: function-createinvalidresult.md -->

# createInvalidResult

**Kind:** Function

**Source:** `atloria-monorepo/packages/core/src/validators/validation-result.ts` (line 19)

Create a failed validation result with errors

## Signature

```ts
function createInvalidResult(errors: string[]): ValidationResult
```

## Parameters

| Name | Type |
|---|---|
| `errors` | `string[]` |

**Returns:** `ValidationResult`

<!-- source: class-createissuecommentdto.md -->

# CreateIssueCommentDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/issues/dto/issue-comment.dto.ts` (line 3)

## Properties

| Property | Type |
|---|---|
| `body` | `string` |
| `isInternal` | `boolean` |

<!-- source: function-createjournaltool.md -->

# createJournalTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/journal.tool.ts` (line 29)

## Signature

```ts
function createJournalTool(options: JournalToolOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `JournalToolOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-createstoreassettool.md -->

# createStoreAssetTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/store-asset.tool.ts` (line 20)

## Signature

```ts
function createStoreAssetTool(storeFn: StoreAssetFn): ToolDefinition<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `storeFn` | `StoreAssetFn` |

**Returns:** `ToolDefinition<PmeContext>`

<!-- source: interface-dependencytree-2.md -->

# DependencyTree

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/relationship.interface.ts` (line 336)

Dependency tree structure

## Properties

| Property | Type |
|---|---|
| `rootId` | `string` |
| `rootName` | `string` |
| `rootType` | `string` |
| `children` | `DependencyNode[]` |
| `depth` | `number` |
| `totalNodes` | `number` |

<!-- source: function-diffentities.md -->

# diffEntities

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/staleness.ts` (line 60)

Diff a previous hash map against the current entities → what to regenerate/upsert/delete.

## Signature

```ts
function diffEntities(prevHashes: Record<string, string>, entities: Entity[]): EntityDiff
```

## Parameters

| Name | Type |
|---|---|
| `prevHashes` | `Record<string, string>` |
| `entities` | `Entity[]` |

**Returns:** `EntityDiff`

<!-- source: class-djangodetector.md -->

# DjangoDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/django-detector.ts` (line 119)

Django Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectViews` | `detectViews(entities: Entity[])` | `DetectedDjangoView[]` |
| `detectSerializers` | `detectSerializers(entities: Entity[])` | `DetectedDjangoSerializer[]` |
| `detectModels` | `detectModels(entities: Entity[])` | `DetectedDjangoModel[]` |
| `getViewSummary` | `getViewSummary(view: DetectedDjangoView)` | `string` |

<!-- source: interface-documentnodedata.md -->

# DocumentNodeData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Graph/types.ts` (line 38)

Node data for Document nodes

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `documentId` | `string` |
| `title` | `string` |
| `type` | `string` |
| `entityCount` | `number` |

<!-- source: service-documentrevisionservice.md -->

# DocumentRevisionService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/document/services/document-revision.service.ts` (line 19)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createRevision` | `createRevision(documentId: string, snapshot: RevisionSnapshot, userId: string, changeType: ChangeType)` | `Promise<DocumentRevision>` |
| `getRevisions` | `getRevisions(documentId: string, limit: number, offset: number)` | `Promise<DocumentRevision[]>` |
| `getRevision` | `getRevision(revisionId: string)` | `Promise<DocumentRevision>` |
| `restoreFromRevision` | `restoreFromRevision(documentId: string, revisionId: string, userId: string)` | `Promise<any>` |
| `getRevisionCount` | `getRevisionCount(documentId: string)` | `Promise<number>` |
| `cleanupOldRevisions` | `cleanupOldRevisions(documentId: string, keepLast: number)` | `Promise<number>` |
| `deleteAllRevisions` | `deleteAllRevisions(documentId: string)` | `Promise<number>` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: function-generateusercolor.md -->

# generateUserColor

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/user-colors.ts` (line 66)

Generate a consistent color for a user based on their userId
The same userId will always return the same color

## Signature

```ts
function generateUserColor(userId: string): string
```

## Parameters

| Name | Type |
|---|---|
| `userId` | `string` |

**Returns:** `string`

<!-- source: type-inputstate.md -->

# InputState

**Kind:** Type

**Source:** `atloria-monorepo/packages/ui-core/src/components/input/Input.ts` (line 9)

## Definition

```ts
'default' | 'error' | 'success'
```

<!-- source: class-orchestrator.md -->

# Orchestrator

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/orchestrator.ts` (line 174)

Multi-agent orchestrator that executes phased workflows.
Within each phase, agents run in parallel. Between phases, execution is sequential.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `execute` | `execute(plan: OrchestrationPlan, context: string, baseModel: string)` | `Promise<OrchestrationResult>` |

<!-- source: interface-parsermetadata.md -->

# ParserMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/parser.interface.ts` (line 105)

Parser metadata for registration

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `supportedPatterns` | `string[]` |
| `description` | `string` |
| `category` | `ParserCategory` |
| `languages` | `string[]` |
| `author` | `string` |

<!-- source: controller-parsingcontroller.md -->

# ParsingController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/parsing/parsing.controller.ts` (line 8)

## Relationships

- MODULE_DECLARES → `parseProject`
- MODULE_DECLARES → `getStatus`
- MODULE_DECLARES → `cancelParsing`
- MODULE_DECLARES → `getProjectJobs`
- DEPENDS_ON → `parsingservice`

<!-- source: constant-productrequirementstemplate.md -->

# productRequirementsTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/product-requirements.template.ts` (line 3)

<!-- source: function-renderbrandedemail.md -->

# renderBrandedEmail

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/email/email-template.ts` (line 31)

## Signature

```ts
function renderBrandedEmail(opts: BrandedEmailOptions): string
```

## Parameters

| Name | Type |
|---|---|
| `opts` | `BrandedEmailOptions` |

**Returns:** `string`

<!-- source: module-screenshotmodule-2.md -->

# ScreenshotModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/screenshot/screenshot.module.ts` (line 9)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `assetsmodule`
- MODULE_DECLARES → `screenshotcontroller`
- MODULE_PROVIDES → `screenshotservice`
- MODULE_EXPORTS → `screenshotservice`

<!-- source: interface-seoconfig.md -->

# SeoConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 79)

## Properties

| Property | Type |
|---|---|
| `titleKey` | `string` |
| `descriptionKey` | `string` |
| `ogImage` | `string` |

<!-- source: component-statcard-4.md -->

# StatCard

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/stat-card.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `valueKey` | `string` | ✓ | - |
| `labelKey` | `string` | ✓ | - |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_StatCard_14cf6351["StatCard"]
    class component_StatCard_14cf6351 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- USES_HOOK → `useTranslation`

<!-- source: interface-variantstyle.md -->

# VariantStyle

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/prompts/variant.prompts.ts` (line 11)

## Properties

| Property | Type |
|---|---|
| `key` | `VariantKey` |
| `name` | `string` |
| `description` | `string` |
| `instructions` | `string` |

<!-- source: function-waitfornavigation.md -->

# waitForNavigation

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 62)

Wait for navigation to complete

## Signature

```ts
async function waitForNavigation(page: Page, urlPattern: string | RegExp): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |
| `urlPattern` | `string | RegExp` |

**Returns:** `Promise<void>`

<!-- source: interface-audiencenode.md -->

# AudienceNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 29)

Audience block node
Represents content wrapped in AUDIENCE directives

## Properties

| Property | Type |
|---|---|
| `type` | `'audience_block'` |
| `logic` | `string` |
| `parsedLogic` | `AudienceLogicTree` |
| `children` | `ASTNode[]` |

<!-- source: constant-autofocus.md -->

# autoFocus$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 157)

<!-- source: component-basics-4.md -->

# Basics

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/toolbar.tsx` (line 44)

## Diagram

```mermaid
graph TD
    component_Basics_5df2b6f["Basics"]
    class component_Basics_5df2b6f rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: component-chipactive.md -->

# ChipActive

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/all/page.tsx` (line 132)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `label` | `string` | ✓ | - |
| `value` | `string` | ✓ | - |
| `onClear` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ChipActive_7cc233a1["ChipActive"]
    class component_ChipActive_7cc233a1 rootComponent
```

## Relationships

- RENDERS → `XMarkIcon`

## Referenced By

- `IssuesAllPageInner` (RENDERS)

<!-- source: interface-comparedocumentresult.md -->

# CompareDocumentResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/dto/compare-document.dto.ts` (line 74)

Comparison result response

## Properties

| Property | Type |
|---|---|
| `from` | `{
    id: string;
    version?: number;
    title: string;
    content: string;
    createdAt: Date;
    createdBy: {
      id: string;
      name: string;
      email: string;
    };
    metadata?: any;
  }` |
| `to` | `{
    id: string;
    version?: number;
    title: string;
    content: string;
    createdAt: Date;
    createdBy: {
      id: string;
      name: string;
      email: string;
    };
    metadata?: any;
  }` |
| `diff` | `{
    title: {
      changed: boolean;
      from: string;
      to: string;
    };
    content: DiffChange[];
    metadata: MetadataDiff[];
    stats: {
      additions: number;
      deletions: number;
      modifications: number;
    };
  }` |

<!-- source: interface-consolidationreport.md -->

# ConsolidationReport

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/memory/types.ts` (line 120)

## Properties

| Property | Type |
|---|---|
| `staleCount` | `number` |
| `prunedCount` | `number` |
| `mergedCount` | `number` |
| `totalRemaining` | `number` |

<!-- source: api-endpoint-create-3.md -->

# create

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 38)

## Endpoint

`POST /projects/:projectId/boards`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: class-createissuedto.md -->

# CreateIssueDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/issues/dto/create-issue.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `projectSlugId` | `string` |
| `pageUrl` | `string` |
| `pageTitle` | `string` |
| `sectionHeading` | `string` |
| `ticketType` | `TicketType` |
| `category` | `IssueCategory` |
| `description` | `string` |
| `reporterEmail` | `string` |
| `reporterSessionId` | `string` |
| `scrollPosition` | `number` |
| `userAgent` | `string` |

<!-- source: function-createlearningpathtemplate.md -->

# createLearningPathTemplate

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 396)

Generate a learning path doc template for a given persona.
Learning paths are dynamic (per-persona), so they use this template factory.

## Signature

```ts
function createLearningPathTemplate(persona: { name: string; description: string }): FixedDocTemplate
```

## Parameters

| Name | Type |
|---|---|
| `persona` | `{ name: string; description: string }` |

**Returns:** `FixedDocTemplate`

<!-- source: function-createlistdirectorytool.md -->

# createListDirectoryTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/list-directory.tool.ts` (line 22)

## Signature

```ts
function createListDirectoryTool(options: ListDirectoryOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `ListDirectoryOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-createstrategyagent.md -->

# createStrategyAgent

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/agents/strategy.agent.ts` (line 19)

## Signature

```ts
function createStrategyAgent(config: GenerationConfig, deps: StrategyDependencies): AgentConfig<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |
| `deps` | `StrategyDependencies` |

**Returns:** `AgentConfig<PmeContext>`

<!-- source: interface-deploymentconnection.md -->

# DeploymentConnection

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/deployment-diagram.generator.ts` (line 62)

Represents a connection between deployment nodes

## Properties

| Property | Type |
|---|---|
| `from` | `string` |
| `to` | `string` |
| `type` | `ConnectionType` |
| `port` | `number` |
| `protocol` | `string` |
| `bidirectional` | `boolean` |

<!-- source: function-discoverauthconfig.md -->

# discoverAuthConfig

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/permission-extractor.ts` (line 267)

Discover authentication configuration from source code files.

Analyzes routing modules, auth services, and role definitions
to build a picture of the app's auth system.

## Signature

```ts
function discoverAuthConfig(files: Map<string, string>, _framework: 'angular' | 'vue' | 'react' | 'nextjs' | 'jquery' | 'unknown'): AuthConfigDiscovery
```

## Parameters

| Name | Type |
|---|---|
| `files` | `Map<string, string>` |
| `_framework` | `'angular' | 'vue' | 'react' | 'nextjs' | 'jquery' | 'unknown'` |

**Returns:** `AuthConfigDiscovery`

<!-- source: class-documentendpoints.md -->

# DocumentEndpoints

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/documents.ts` (line 78)

Document endpoints

## Methods

| Method | Signature | Returns |
|---|---|---|
| `list` | `list(params: DocumentListParams)` | `Promise<DocumentListResponse>` |
| `get` | `get(id: string)` | `Promise<Document>` |
| `getBySlug` | `getBySlug(projectId: string, slug: string)` | `Promise<Document>` |
| `create` | `create(dto: CreateDocumentDto)` | `Promise<Document>` |
| `update` | `update(id: string, dto: UpdateDocumentDto)` | `Promise<Document>` |
| `delete` | `delete(id: string)` | `Promise<void>` |
| `publish` | `publish(id: string)` | `Promise<Document>` |
| `unpublish` | `unpublish(id: string)` | `Promise<Document>` |
| `regenerate` | `regenerate(id: string)` | `Promise<Document>` |
| `getRevisions` | `getRevisions(id: string, limit: number, offset: number)` | `Promise<DocumentRevision[]>` |
| `getRevision` | `getRevision(id: string, revisionId: string)` | `Promise<DocumentRevision>` |
| `restoreRevision` | `restoreRevision(id: string, revisionId: string)` | `Promise<Document>` |

<!-- source: service-documentservice.md -->

# DocumentService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/document/document.service.ts` (line 33)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `create` | `create(dto: CreateDocumentDto, user: JwtPayload)` | `Promise<Document>` |
| `get` | `get(id: string, _user: JwtPayload)` | `Promise<Document>` |
| `list` | `list(filters: DocumentFiltersDto, user: JwtPayload)` | `Promise<{ documents: Document[]; totalCount: number; limit: number; offset: number }>` |
| `update` | `update(id: string, dto: UpdateDocumentDto, user: JwtPayload)` | `Promise<Document>` |
| `delete` | `delete(id: string, user: JwtPayload)` | `Promise<void>` |
| `getVersions` | `getVersions(id: string, user: JwtPayload)` | `Promise<Document[]>` |
| `getVersion` | `getVersion(id: string, version: number, user: JwtPayload)` | `Promise<Document>` |
| `revert` | `revert(id: string, version: number, user: JwtPayload)` | `Promise<Document>` |
| `publish` | `publish(id: string, dto: PublishDocumentDto, user: JwtPayload)` | `Promise<Document>` |
| `unpublish` | `unpublish(id: string, dto: UnpublishDocumentDto, user: JwtPayload)` | `Promise<Document>` |
| `render` | `render(id: string, user: JwtPayload, audienceQuery: string)` | `Promise<{
    documentId: string;
    title: string;
    renderedContent: string;
    viewerAudiences: string[];
  }>` |
| `renderPublic` | `renderPublic(id: string, user: JwtPayload)` | `Promise<{
    documentId: string;
    title: string;
    renderedContent: string;
    toc: TocEntry[];
    viewerAudiences: string[];
    createdAt: Date;
    createdBy: {
      name: string | null;
    };
  }>` |
| `renderPublicByUrl` | `renderPublicByUrl(urlId: string, audienceFromUrl: string, user: JwtPayload)` | `Promise<{
    documentId: string;
    title: string;
    slug: string;
    renderedContent: string;
    toc: TocEntry[];
    viewerAudiences: string[];
    createdAt: Date;
    createdBy: {
      name: string | null;
    };
  }>` |
| `getDocumentTree` | `getDocumentTree(projectId: string, _user: JwtPayload)` | `Promise<DocumentTreeNode[]>` |
| `getPublicDocumentTree` | `getPublicDocumentTree(organizationId: string, projectId: string)` | `Promise<DocumentTreeNode[]>` |
| `bulkDelete` | `bulkDelete(documentIds: string[], user: JwtPayload)` | `Promise<BulkOperationResult>` |
| `bulkMove` | `bulkMove(documentIds: string[], categoryId: string | null, user: JwtPayload)` | `Promise<BulkOperationResult>` |
| `bulkUpdateVisibility` | `bulkUpdateVisibility(documentIds: string[], isPublic: boolean, user: JwtPayload)` | `Promise<BulkOperationResult>` |
| `bulkPublish` | `bulkPublish(dto: BulkPublishDto, user: JwtPayload)` | `Promise<{ published: number; skipped: number; total: number }>` |
| `duplicate` | `duplicate(id: string, user: JwtPayload)` | `Promise<Document>` |
| `compareDocuments` | `compareDocuments(documentId: string, fromId: string, toId: string, type: 'version' | 'revision', user: JwtPayload)` | `unknown` |
| `getDocumentStats` | `getDocumentStats(documentId: string, user: JwtPayload)` | `unknown` |
| `searchDocuments` | `searchDocuments(filters: any, user: JwtPayload)` | `unknown` |
| `reorderDocuments` | `reorderDocuments(categoryId: string, documentIds: string[], user: JwtPayload)` | `Promise<void>` |
| `reorderUncategorizedDocuments` | `reorderUncategorizedDocuments(documentIds: string[], user: JwtPayload)` | `Promise<void>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `urlservice`
- DEPENDS_ON → `tocbuilderservice`
- DEPENDS_ON → `documentrevisionservice`
- DEPENDS_ON → `documentversionservice`
- DEPENDS_ON → `documentindexingservice`

<!-- source: interface-docversion.md -->

# DocVersion

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/stores/versionContext.ts` (line 8)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `versionNumber` | `number` |
| `label` | `string` |
| `status` | `string` |
| `createdAt` | `string` |

<!-- source: function-get.md -->

# GET

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/.well-known/llms.txt/route.ts` (line 13)

Tenant-level agent discovery: /.well-known/llms.txt — an INDEX (not one site's content) of every
published docs site's per-site llms.txt. On a multi-tenant single origin (many sites under /p/<slug>)
a root content file can't represent all sites, so this is the honest, discoverable entrypoint: one
fetch → the list of per-site llms.txt / llms-full.txt URLs. Each site also carries its own
<link rel="alternate"> hints (see p/[slugId]/layout.tsx).

<!-- source: type-inputtype.md -->

# InputType

**Kind:** Type

**Source:** `atloria-monorepo/packages/ui-core/src/components/input/Input.ts` (line 8)

## Definition

```ts
'text' | 'email' | 'password' | 'number' | 'tel' | 'url'
```

<!-- source: class-otlpexporter.md -->

# OtlpExporter

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/tracing/otlp-exporter.ts` (line 51)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `startSpan` | `startSpan(operationName: string, parentSpanId: string)` | `TraceSpan` |
| `endSpan` | `endSpan(span: TraceSpan, status: 'ok' | 'error')` | `void` |
| `addEvent` | `addEvent(span: TraceSpan, name: string, attributes: Record<string, string | number | boolean>)` | `void` |
| `setAttributes` | `setAttributes(span: TraceSpan, attributes: Record<string, string | number | boolean>)` | `void` |
| `flush` | `flush()` | `Promise<void>` |
| `getPendingCount` | `getPendingCount()` | `number` |
| `shutdown` | `shutdown()` | `Promise<void>` |

<!-- source: interface-parserstats.md -->

# ParserStats

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/parse-result.interface.ts` (line 383)

Statistics for a single parser

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `filesProcessed` | `number` |
| `entitiesFound` | `number` |
| `relationshipsFound` | `number` |
| `duration` | `number` |
| `errors` | `number` |
| `warnings` | `number` |

<!-- source: controller-pmecontroller.md -->

# PmeController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/pme/pme.controller.ts` (line 26)

## Relationships

- MODULE_DECLARES → `createJob`
- MODULE_DECLARES → `getJob`
- MODULE_DECLARES → `getJobsByProject`
- MODULE_DECLARES → `getVariants`
- MODULE_DECLARES → `selectVariant`
- MODULE_DECLARES → `startStrategy`
- MODULE_DECLARES → `finalizePage`
- DEPENDS_ON → `pmeservice`

<!-- source: constant-projectreadmetemplate.md -->

# projectReadmeTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/project-readme.template.ts` (line 3)

<!-- source: function-resolvelanguage.md -->

# resolveLanguage

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/project/language.util.ts` (line 76)

Resolve a language code to its display + direction metadata. Unknown codes
degrade gracefully: name = the code itself, dir from the base's RTL set.

## Signature

```ts
function resolveLanguage(code: string | null): ResolvedLanguage
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string | null` |

**Returns:** `ResolvedLanguage`

<!-- source: interface-siteassemblyconfig.md -->

# SiteAssemblyConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 10)

Site Assembler Types

All interfaces for the deterministic site assembly pipeline.
The AI agent provides a SiteAssemblyConfig; the assembler produces a working site.

## Properties

| Property | Type |
|---|---|
| `assemblyId` | `string` |
| `outputDir` | `string` |
| `site` | `SiteConfig` |
| `sections` | `SectionSelection[]` |
| `nav` | `NavConfig` |
| `footer` | `FooterConfig` |
| `locales` | `LocaleConfig[]` |
| `seo` | `SeoConfig` |

<!-- source: component-stepindicator-2.md -->

# StepIndicator

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/step-indicator.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `step` | `number` | ✓ | - |
| `icon` | `LucideIcon` | ✓ | - |
| `titleKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StepIndicator_42b507fd["StepIndicator"]
    class component_StepIndicator_42b507fd rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: module-suggestionmodule.md -->

# SuggestionModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/suggestion/suggestion.module.ts` (line 11)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `gatewaymodule`
- MODULE_IMPORTS → `activitymodule`
- MODULE_IMPORTS → `notificationmodule`
- MODULE_DECLARES → `suggestioncontroller`
- MODULE_PROVIDES → `suggestionservice`
- MODULE_EXPORTS → `suggestionservice`

<!-- source: interface-visualconfig.md -->

# VisualConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/types/index.ts` (line 48)

## Properties

| Property | Type |
|---|---|
| `strategy` | `VisualStrategy` |
| `screenshots` | `Record<string, string>` |

<!-- source: function-waitforpageload.md -->

# waitForPageLoad

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 6)

Wait for a page to be fully loaded

## Signature

```ts
async function waitForPageLoad(page: Page): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |

**Returns:** `Promise<void>`

<!-- source: interface-audiencenotnode.md -->

# AudienceNotNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 105)

## Properties

| Property | Type |
|---|---|
| `type` | `'not'` |
| `operand` | `AudienceLogicTree` |

<!-- source: component-blocktypeselect.md -->

# BlockTypeSelect

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/BlockTypeSelect.tsx` (line 14)

## Diagram

```mermaid
graph TD
    component_BlockTypeSelect_6ec587df["BlockTypeSelect"]
    class component_BlockTypeSelect_6ec587df rootComponent
```

## Relationships

- RENDERS → `Select`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useCellValue`
- USES_HOOK → `useTranslation`

<!-- source: constant-bottomareachildren.md -->

# bottomAreaChildren$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 749)

<!-- source: component-coloredselect.md -->

# ColoredSelect

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/[ticketId]/page.tsx` (line 262)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `value` | `string` | ✓ | - |
| `onChange` | `Function` | ✓ | - |
| `options` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ColoredSelect_5e72e597["ColoredSelect"]
    class component_ColoredSelect_5e72e597 rootComponent
```

## Referenced By

- `IssueDetailPageInner` (RENDERS)

<!-- source: interface-competitordoc.md -->

# CompetitorDoc

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/web-search/data/competitor-docs-index.ts` (line 8)

Curated index of popular software documentation sites
Used for competitor research during documentation generation

Categories match common software types we encounter

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `category` | `string[]` |
| `docsUrl` | `string` |
| `apiDocsUrl` | `string` |
| `priority` | `'high' | 'medium' | 'low'` |
| `lastCrawled` | `Date` |
| `crawlEnabled` | `boolean` |

<!-- source: interface-consolidatorconfig.md -->

# ConsolidatorConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/memory/consolidator.ts` (line 20)

## Properties

| Property | Type |
|---|---|
| `stalenessDays` | `number` |
| `mergeThreshold` | `number` |
| `maxMemories` | `number` |

<!-- source: api-endpoint-create-4.md -->

# create

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/capture/capture.controller.ts` (line 36)

## Endpoint

`POST /capture/:projectId/flows`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `CaptureController` (MODULE_DECLARES)

<!-- source: function-createlogger.md -->

# createLogger

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/logger.ts` (line 250)

## Signature

```ts
function createLogger(config: Partial<LoggerConfig>): Logger
```

## Parameters

| Name | Type |
|---|---|
| `config` | `Partial<LoggerConfig>` |

**Returns:** `Logger`

<!-- source: function-creatememorytool.md -->

# createMemoryTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/memory.tool.ts` (line 24)

## Signature

```ts
function createMemoryTool(options: MemoryToolOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `MemoryToolOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: class-createpmejobdto.md -->

# CreatePmeJobDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/pme/dto/pme.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `targetAudience` | `string` |
| `brandVoice` | `string` |
| `language` | `string` |
| `pageType` | `string` |
| `sections` | `string[]` |
| `model` | `string` |

<!-- source: function-createvalidatehtmltool.md -->

# createValidateHtmlTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/validate-html.tool.ts` (line 17)

## Signature

```ts
function createValidateHtmlTool(): ToolDefinition<PmeContext>
```

**Returns:** `ToolDefinition<PmeContext>`

<!-- source: interface-deploymentdiagramoptions.md -->

# DeploymentDiagramOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/deployment-diagram.generator.ts` (line 94)

Options for deployment diagram generation

## Properties

| Property | Type |
|---|---|
| `showPorts` | `boolean` |
| `showTechnology` | `boolean` |
| `showNetworkZones` | `boolean` |
| `showInstanceCounts` | `boolean` |
| `showExternalServices` | `boolean` |
| `direction` | `'TB' | 'BT' | 'LR' | 'RL'` |
| `includeNodeTypes` | `DeploymentNodeType[]` |
| `environment` | `string` |

<!-- source: function-discovercompetitorswithai.md -->

# discoverCompetitorsWithAI

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/competitor-discovery.ts` (line 16)

Ask AI to discover competitors and their documentation URLs

## Signature

```ts
async function discoverCompetitorsWithAI(aiProvider: { generateText: (prompt: string, options?: any) => Promise<string> }, projectDescription: string, projectType: string, limit): Promise<CompetitorInfo[]>
```

## Parameters

| Name | Type |
|---|---|
| `aiProvider` | `{ generateText: (prompt: string, options?: any) => Promise<string> }` |
| `projectDescription` | `string` |
| `projectType` | `string` |
| `limit` | `any` |

**Returns:** `Promise<CompetitorInfo[]>`

<!-- source: class-documentmanager.md -->

# DocumentManager

**Kind:** Class

**Source:** `atloria-monorepo/packages/core/src/managers/document-manager.ts` (line 13)

DocumentManager handles document business logic
This class is framework-agnostic and can be used in any environment

## Methods

| Method | Signature | Returns |
|---|---|---|
| `validate` | `validate(doc: Partial<Document>)` | `ValidationResult` |
| `canEdit` | `canEdit(user: User, doc: Document)` | `boolean` |
| `canPublish` | `canPublish(user: User, _doc: Document)` | `boolean` |
| `canDelete` | `canDelete(user: User, _doc: Document)` | `boolean` |
| `createVersion` | `createVersion(doc: Document)` | `Partial<Document>` |
| `applyAudienceFilter` | `applyAudienceFilter(docs: Document[], audience: string)` | `Document[]` |
| `applyAudiencesFilter` | `applyAudiencesFilter(docs: Document[], audiences: string[])` | `Document[]` |
| `isOutdated` | `isOutdated(doc: Document, allVersions: Document[])` | `boolean` |
| `getLatestPublishedVersion` | `getLatestPublishedVersion(slug: string, allVersions: Document[])` | `Document | null` |
| `canView` | `canView(user: User | null, doc: Document)` | `boolean` |

<!-- source: service-documentversionservice.md -->

# DocumentVersionService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/document/services/document-version.service.ts` (line 16)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createVersion` | `createVersion(documentId: string, dto: CreateVersionDto, userId: string)` | `Promise<DocumentVersion>` |
| `getVersions` | `getVersions(documentId: string)` | `Promise<DocumentVersion[]>` |
| `getVersion` | `getVersion(documentId: string, versionNumber: number)` | `Promise<DocumentVersion>` |
| `updateVersionMetadata` | `updateVersionMetadata(versionId: string, dto: UpdateVersionMetadataDto)` | `Promise<DocumentVersion>` |
| `deleteVersion` | `deleteVersion(versionId: string)` | `Promise<void>` |
| `restoreFromVersion` | `restoreFromVersion(documentId: string, versionNumber: number, userId: string)` | `Promise<any>` |
| `getVersionCount` | `getVersionCount(documentId: string)` | `Promise<number>` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: interface-domaincheckresult.md -->

# DomainCheckResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/lib/api-client.ts` (line 69)

## Properties

| Property | Type |
|---|---|
| `status` | `DomainStatus` |
| `registrar` | `{ name: string; url?: string } | null` |
| `records` | `Array<DnsRecordSpec & { observed: string[]; ok: boolean; hint?: string }>` |
| `issues` | `Array<{ code: string; message: string }>` |

<!-- source: function-get-2.md -->

# GET

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/api/hello/route.ts` (line 1)

## Signature

```ts
async function GET(_request: Request)
```

## Parameters

| Name | Type |
|---|---|
| `_request` | `Request` |

<!-- source: type-insertimageparameters.md -->

# InsertImageParameters

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 76)

## Definition

```ts
FileImageParameters | SrcImageParameters
```

<!-- source: interface-parsesummary.md -->

# ParseSummary

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/parse-result.interface.ts` (line 328)

Summary statistics for a project parse

## Properties

| Property | Type |
|---|---|
| `totalFiles` | `number` |
| `successfulFiles` | `number` |
| `failedFiles` | `number` |
| `skippedFiles` | `number` |
| `totalEntities` | `number` |
| `totalRelationships` | `number` |
| `totalDuration` | `number` |
| `entitiesByType` | `Record<string, number>` |
| `relationshipsByType` | `Record<string, number>` |
| `parserStats` | `Record<string, ParserStats>` |

<!-- source: class-pluginloader.md -->

# PluginLoader

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/plugins/plugin-loader.ts` (line 28)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `loadFromDirectory` | `loadFromDirectory(pluginsDir: string)` | `Promise<LoadedPlugin[]>` |
| `loadPlugin` | `loadPlugin(pluginDir: string)` | `Promise<LoadedPlugin>` |

<!-- source: controller-projectcontroller.md -->

# ProjectController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 35)

## Relationships

- MODULE_DECLARES → `create`
- MODULE_DECLARES → `list`
- MODULE_DECLARES → `get`
- MODULE_DECLARES → `update`
- MODULE_DECLARES → `updatePut`
- MODULE_DECLARES → `delete`
- MODULE_DECLARES → `getMembers`
- MODULE_DECLARES → `addMember`
- MODULE_DECLARES → `updateMemberRole`
- MODULE_DECLARES → `removeMember`
- MODULE_DECLARES → `getSettings`
- MODULE_DECLARES → `updateSettings`
- MODULE_DECLARES → `getStats`
- MODULE_DECLARES → `publish`
- MODULE_DECLARES → `checkSubdomain`
- MODULE_DECLARES → `setSubdomain`
- MODULE_DECLARES → `getCustomDomain`
- MODULE_DECLARES → `createCustomDomain`
- MODULE_DECLARES → `checkCustomDomain`
- MODULE_DECLARES → `retryCustomDomain`
- MODULE_DECLARES → `removeCustomDomain`
- MODULE_DECLARES → `unpublish`
- MODULE_DECLARES → `getProjectAudiences`
- DEPENDS_ON → `projectservice`
- DEPENDS_ON → `projectdomainsservice`

<!-- source: constant-prompt-templates.md -->

# PROMPT_TEMPLATES

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/ai/prompts/prompt-templates.ts` (line 1)

<!-- source: function-roles.md -->

# Roles

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/auth/decorators/roles.decorator.ts` (line 6)

## Signature

```ts
function Roles(roles: UserRole[])
```

## Parameters

| Name | Type |
|---|---|
| `roles` | `UserRole[]` |

<!-- source: interface-siteconfig.md -->

# SiteConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/types.ts` (line 36)

## Properties

| Property | Type |
|---|---|
| `brandName` | `string` |
| `defaultLocale` | `string` |
| `defaultTheme` | `'light' | 'dark' | 'colorful'` |
| `primaryColor` | `string` |
| `fonts` | `{ heading: string; body: string; mono: string }` |
| `analytics` | `{
    provider: 'none' | 'azure-app-insights' | 'google-analytics' | 'meta-pixel';
    trackingId: string;
  }` |

<!-- source: module-supportagentmodule.md -->

# SupportAgentModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.module.ts` (line 11)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `forwardref`
- MODULE_IMPORTS → `aimodule`
- MODULE_DECLARES → `supportagentcontroller`
- MODULE_PROVIDES → `supportagentservice`
- MODULE_PROVIDES → `languagedetectorservice`
- MODULE_PROVIDES → `agentadapterservice`
- MODULE_EXPORTS → `supportagentservice`

<!-- source: component-testimonialcard.md -->

# TestimonialCard

**Kind:** Component

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/testimonial-card.tsx` (line 21)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `quoteKey` | `string` | ✓ | - |
| `authorNameKey` | `string` | ✓ | - |
| `authorRoleKey` | `string` | - | - |
| `avatarSrc` | `string` | - | - |
| `rating` | `number` | - | - |

## Diagram

```mermaid
graph TD
    component_TestimonialCard_731cdbc1["TestimonialCard"]
    class component_TestimonialCard_731cdbc1 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Star`
- USES_HOOK → `useTranslation`

<!-- source: interface-visualdependencies.md -->

# VisualDependencies

**Kind:** Interface

**Source:** `atloria-monorepo/libs/pme-core/src/agents/visual.agent.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `generateImageFn` | `ImageGenerateFn` |
| `findScreenshotsFn` | `FindScreenshotsFn` |

<!-- source: function-waitfortoast.md -->

# waitForToast

**Kind:** Function

**Source:** `atloria-monorepo/apps/web-e2e/src/utils/test-helpers.ts` (line 72)

Wait for a toast/notification to appear

## Signature

```ts
async function waitForToast(page: Page, text: string): Promise<Locator>
```

## Parameters

| Name | Type |
|---|---|
| `page` | `Page` |
| `text` | `string` |

**Returns:** `Promise<Locator>`

<!-- source: interface-audienceornode.md -->

# AudienceOrNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 115)

## Properties

| Property | Type |
|---|---|
| `type` | `'or'` |
| `operands` | `AudienceLogicTree[]` |

<!-- source: component-bolditalicunderlinetoggles.md -->

# BoldItalicUnderlineToggles

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/BoldItalicUnderlineToggles.tsx` (line 44)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `options` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_BoldItalicUnderlineToggles_326c3a3b["BoldItalicUnderlineToggles"]
    class component_BoldItalicUnderlineToggles_326c3a3b rootComponent
```

## Relationships

- RENDERS → `FormatButton`
- USES_HOOK → `useTranslation`

<!-- source: constant-button.md -->

# Button

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/toolbar.tsx` (line 58)

A toolbar button primitive.

<!-- source: component-columnslist.md -->

# ColumnsList

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardSettingsDialog.tsx` (line 277)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `boardId` | `string` | ✓ | - |
| `columns` | `BoardColumnLite[]` | ✓ | - |
| `onEdit` | `Function` | ✓ | - |
| `onReorder` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ColumnsList_668bb1f6["ColumnsList"]
    class component_ColumnsList_668bb1f6 rootComponent
```

## Relationships

- RENDERS → `Bars3Icon`
- RENDERS → `PencilIcon`
- USES_HOOK → `useState`

## Referenced By

- `BoardSettingsDialog` (RENDERS)

<!-- source: interface-competitorinfo.md -->

# CompetitorInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/competitor-discovery.service.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `docsUrl` | `string` |
| `apiDocsUrl` | `string` |
| `reason` | `string` |

<!-- source: interface-contextitem.md -->

# ContextItem

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/context-manager.ts` (line 12)

Context Manager

Generic context window management:
- Token tracking per turn
- Auto-compaction at configurable threshold
- Pluggable compaction strategy

Zero SDK imports — operates on our own interfaces.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `role` | `'system' | 'user' | 'assistant' | 'tool'` |
| `content` | `string` |
| `turn` | `number` |
| `tokenEstimate` | `number` |
| `tags` | `string[]` |

<!-- source: api-endpoint-create-5.md -->

# create

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/comment/comment.controller.ts` (line 44)

Create a new comment on a document

## Endpoint

`POST /documents/:documentId/comments`

| Parameter | In | Type | Required |
|---|---|---|---|
| `documentId` | query | `string` | ✓ |

## Referenced By

- `CommentController` (MODULE_DECLARES)

<!-- source: function-createmultiedittool.md -->

# createMultiEditTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/multi-edit.tool.ts` (line 58)

## Signature

```ts
function createMultiEditTool(options: MultiEditOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `MultiEditOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-createopenaiprovider.md -->

# createOpenAIProvider

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/openai.provider.ts` (line 501)

Create an OpenAI provider from environment configuration

## Signature

```ts
function createOpenAIProvider(config: Partial<OpenAIConfig>): OpenAIProvider
```

## Parameters

| Name | Type |
|---|---|
| `config` | `Partial<OpenAIConfig>` |

**Returns:** `OpenAIProvider`

<!-- source: class-createprojectdto.md -->

# CreateProjectDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/create-project.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `repoUrl` | `string` |
| `repoBranch` | `string` |
| `themeId` | `string` |

<!-- source: function-createvariantagent.md -->

# createVariantAgent

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/agents/variant.agent.ts` (line 23)

Create a variant agent for a specific style (A, B, or C).

## Signature

```ts
function createVariantAgent(config: GenerationConfig, deps: VariantDependencies, variantKey: VariantKey): AgentConfig<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |
| `deps` | `VariantDependencies` |
| `variantKey` | `VariantKey` |

**Returns:** `AgentConfig<PmeContext>`

<!-- source: interface-deploymentdiagramresult.md -->

# DeploymentDiagramResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/deployment-diagram.generator.ts` (line 147)

Result of deployment diagram generation

## Properties

| Property | Type |
|---|---|
| `mermaidCode` | `string` |
| `nodes` | `DeploymentNode[]` |
| `connections` | `DeploymentConnection[]` |
| `zones` | `NetworkZone[]` |
| `stats` | `{
    /** Total number of nodes */
    nodeCount: number;
    /** Number of connections */
    connectionCount: number;
    /** Number of services */
    serviceCount: number;
    /** Number of databases */
    databaseCount: number;
    /** Number of external services */
    externalServiceCount: number;
    /** Node types distribution */
    nodeTypeDistribution: Record<DeploymentNodeType, number>;
  }` |

<!-- source: service-docversionexportservice.md -->

# DocVersionExportService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/doc-version/export.service.ts` (line 13)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `exportMarkdown` | `exportMarkdown(versionId: string)` | `unknown` |
| `exportStaticSite` | `exportStaticSite(versionId: string)` | `unknown` |
| `exportPDFContent` | `exportPDFContent(versionId: string)` | `unknown` |
| `exportPDFBuffer` | `exportPDFBuffer(versionId: string)` | `Promise<{ buffer: Buffer; filename: string }>` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: interface-donutchartprops.md -->

# DonutChartProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/DonutChart.tsx` (line 12)

## Properties

| Property | Type |
|---|---|
| `data` | `DonutDatum[]` |
| `loading` | `boolean` |
| `centerLabel` | `string` |
| `colors` | `string[]` |
| `emptyMessage` | `string` |
| `maxSlices` | `number` |

<!-- source: class-dotnetdetector.md -->

# DotNetDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/dotnet-detector.ts` (line 88)

.NET Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectControllers` | `detectControllers(entities: Entity[])` | `DetectedDotNetController[]` |
| `detectServices` | `detectServices(entities: Entity[])` | `DetectedDotNetService[]` |
| `getControllerSummary` | `getControllerSummary(controller: DetectedDotNetController)` | `string` |

<!-- source: function-enhancedocumentationwithcompetitors.md -->

# enhanceDocumentationWithCompetitors

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ai-enhancement.ts` (line 27)

Main orchestrator for Stage 2: Competitor Enhancement

## Signature

```ts
async function enhanceDocumentationWithCompetitors(aiProvider: { generateText: (prompt: string, options?: any) => Promise<string> }, documentation: string, projectType: string, projectDescription: string, options: AIEnhancementOptions): Promise<EnhancedDocumentation>
```

## Parameters

| Name | Type |
|---|---|
| `aiProvider` | `{ generateText: (prompt: string, options?: any) => Promise<string> }` |
| `documentation` | `string` |
| `projectType` | `string` |
| `projectDescription` | `string` |
| `options` | `AIEnhancementOptions` |

**Returns:** `Promise<EnhancedDocumentation>`

<!-- source: function-get-3.md -->

# GET

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/api/stats/route.ts` (line 5)

<!-- source: type-insertimagepayload.md -->

# InsertImagePayload

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 414)

## Definition

```ts
Readonly<CreateImageNodeParameters>
```

<!-- source: interface-parsewarning.md -->

# ParseWarning

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/parse-result.interface.ts` (line 108)

Warning encountered during parsing (non-blocking)

## Properties

| Property | Type |
|---|---|
| `message` | `string` |
| `code` | `string` |
| `line` | `number` |
| `suggestion` | `string` |

<!-- source: class-pluginmanager.md -->

# PluginManager

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/plugins/plugin-manager.ts` (line 18)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `register` | `register(plugin: LoadedPlugin)` | `void` |
| `unregister` | `unregister(pluginName: string)` | `void` |
| `getCommands` | `getCommands()` | `CommandDefinition[]` |
| `getAgents` | `getAgents()` | `AgentDefinition[]` |
| `getSkills` | `getSkills()` | `SkillDefinition[]` |
| `getPluginNames` | `getPluginNames()` | `string[]` |
| `getCommand` | `getCommand(name: string)` | `CommandDefinition | undefined` |
| `getAgent` | `getAgent(name: string)` | `AgentDefinition | undefined` |
| `activateSkill` | `activateSkill(skillName: string)` | `void` |
| `deactivateSkill` | `deactivateSkill(skillName: string)` | `void` |
| `isSkillActive` | `isSkillActive(skillName: string)` | `boolean` |
| `getSkillDescriptions` | `getSkillDescriptions()` | `string` |

<!-- source: controller-publiccapturecontroller.md -->

# PublicCaptureController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/capture/public-capture.controller.ts` (line 12)

PUBLIC capture endpoint — consumed by the tour player embedded on the
customer's site. Returns the full recipe (selectors + step titles) so the
player can highlight the customer's REAL elements. Secret input values are
re-redacted here; nothing fabricated is ever served.

`PublicCaptureController` exposes a **public** capture endpoint consumed by the embedded tour player running on a customer’s site. It returns the full tour “recipe” (selectors plus step titles) so the player can match and highlight the customer’s real DOM elements. Before responding, it **re-redacts secret input values** to ensure no sensitive data is ever served.

## Diagram

```mermaid
graph LR
  A[Tour Player (embedded on customer site)] -->|HTTP request| B[PublicCaptureController]
  B --> C[Capture/Recipe Service Layer]
  C --> D[(Persistence: capture/recipe data)]
  C --> E[Redaction/Re-redaction]
  E -->|sanitized recipe| B
  B -->|JSON: selectors + step titles (sanitized)| A
```

## Usage

```ts
// Example: the embedded tour player fetching the public capture recipe
// (run in the browser on the customer's site)

type PublicCaptureStep = {
  title: string;
  selector: string;
};

type PublicCaptureRecipeResponse = {
  captureId: string;
  steps: PublicCaptureStep[];
};

async function fetchPublicCaptureRecipe(captureId: string) {
  const res = await fetch(`https://api.example.com/public/capture/${captureId}`, {
    method: "GET",
    headers: {
      "Accept": "application/json",
    },
    credentials: "omit", // typically public/anonymous
  });

  if (!res.ok) {
    throw new Error(`Failed to load recipe (${res.status})`);
  }

  const recipe = (await res.json()) as PublicCaptureRecipeResponse;

  // Use selectors to find and highlight real elements on the customer page
  for (const step of recipe.steps) {
    const el = document.querySelector(step.selector);
    if (el) {
      el.setAttribute("data-tour-highlight", "true");
      // render step.title in your UI
    }
  }

  return recipe;
}

// Usage
fetchPublicCaptureRecipe("cap_12345").catch(console.error);
```

## AI Coding Instructions

- Preserve the contract: the public endpoint must only return what the tour player needs (selectors + step titles + minimal identifiers); avoid adding internal fields.
- Always apply **re-redaction** before responding; never leak original captured input values, even if already stored redacted.
- Keep this controller thin: delegate data fetching/assembly to a service and keep response shaping/sanitization explicit and testable.
- Validate public inputs carefully (e.g., `captureId` format) and return consistent HTTP errors; assume callers are anonymous/untrusted.
- When changing selector/step structures, update the embedded player expectations and version/compatibility behavior together.

## Relationships

- MODULE_DECLARES → `getFlow`
- DEPENDS_ON → `captureservice`

<!-- source: constant-public-sse-throttle.md -->

# PUBLIC_SSE_THROTTLE

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/common/throttling.module.ts` (line 23)

<!-- source: function-sanitizeforjsonb.md -->

# sanitizeForJsonb

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/sanitize-jsonb.ts` (line 10)

Deep-sanitize a value before persisting it into a Postgres `jsonb` column.

Postgres `jsonb` cannot store the NUL character (U+0000) and chokes on other C0 control
characters. These leak in from parsed source (minified bundles, generated/binary-ish files)
and, at monorepo scale, a single bad byte deep in a multi-megabyte snapshot fails the whole
upsert with `unexpected end of hex escape`. Strip them (and lone UTF-16 surrogates, which are
not valid text) so the snapshot always persists. Tab / newline / carriage-return are kept.

## Signature

```ts
function sanitizeForJsonb(value: T): T
```

## Parameters

| Name | Type |
|---|---|
| `value` | `T` |

**Returns:** `T`

<!-- source: interface-sitegenconfig.md -->

# SiteGenConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/agents/site-gen.agent.ts` (line 47)

## Properties

| Property | Type |
|---|---|
| `brandName` | `string` |
| `targetAudience` | `string` |
| `brandVoice` | `string` |
| `language` | `string` |
| `theme` | `'light' | 'dark' | 'colorful'` |
| `model` | `string` |

<!-- source: module-technicaldocsmodule.md -->

# TechnicalDocsModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.module.ts` (line 37)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_IMPORTS → `emailmodule`
- MODULE_IMPORTS → `docversionmodule`
- MODULE_IMPORTS → `parsingmodule`
- MODULE_IMPORTS → `aimodule`
- MODULE_IMPORTS → `graphmodule`
- MODULE_IMPORTS → `eventsmodule`
- MODULE_IMPORTS → `issuesmodule`
- MODULE_IMPORTS → `draftdocumentmodule`
- MODULE_IMPORTS → `notificationmodule`
- MODULE_IMPORTS → `forwardref`
- MODULE_DECLARES → `technicaldocscontroller`
- MODULE_DECLARES → `technicaldocsmcpcontroller`
- MODULE_DECLARES → `technicaldocschatcontroller`
- MODULE_DECLARES → `freshnesscontroller`
- MODULE_PROVIDES → `freshnessservice`
- MODULE_PROVIDES → `technicaldocsservice`
- MODULE_PROVIDES → `technicaldocsparserservice`
- MODULE_PROVIDES → `technicaldocsenrichmentservice`
- MODULE_PROVIDES → `technicaldocsmaterializerservice`
- MODULE_PROVIDES → `technicaldocsgenerationservice`
- MODULE_PROVIDES → `technicaldocsqueue`
- MODULE_PROVIDES → `embeddingsservice`
- MODULE_PROVIDES → `ragchatmodelservice`
- MODULE_PROVIDES → `techdocsragservice`
- MODULE_PROVIDES → `techdocschatservice`
- MODULE_PROVIDES → `techdocssourcesservice`
- MODULE_PROVIDES → `techdocsconnectorsservice`
- MODULE_PROVIDES → `techdocsexportservice`
- MODULE_PROVIDES → `techdocsnotionexportservice`
- MODULE_PROVIDES → `opsalertservice`
- MODULE_PROVIDES → `stalealertservice`
- MODULE_PROVIDES → `aicostratelimitguard`
- MODULE_EXPORTS → `technicaldocsservice`
- MODULE_EXPORTS → `technicaldocsparserservice`
- MODULE_EXPORTS → `technicaldocsenrichmentservice`
- MODULE_EXPORTS → `technicaldocsmaterializerservice`
- MODULE_EXPORTS → `techdocsragservice`
- MODULE_EXPORTS → `technicaldocsqueue`

<!-- source: interface-authconfig-3.md -->

# AuthConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 218)

Authentication configuration

Selectors are optional - if not provided and useSmartDetection is true,
the screenshot-worker will use AI to auto-detect form selectors.

## Properties

| Property | Type |
|---|---|
| `loginUrl` | `string` |
| `username` | `string` |
| `password` | `string` |
| `usernameSelector` | `string` |
| `passwordSelector` | `string` |
| `submitSelector` | `string` |
| `successIndicator` | `string` |
| `useSmartDetection` | `boolean` |

<!-- source: component-breakexample.md -->

# BreakExample

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 110)

## Diagram

```mermaid
graph TD
    component_BreakExample_5d835bb5["BreakExample"]
    class component_BreakExample_5d835bb5 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: constant-buttonwithtooltip.md -->

# ButtonWithTooltip

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/toolbar.tsx` (line 64)

A toolbar button with tooltip primitive.

<!-- source: component-commentform.md -->

# CommentForm

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Comments/CommentForm.tsx` (line 47)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `documentId` | `string` | ✓ | - |
| `projectId` | `string` | - | - |
| `parentId` | `string` | - | - |
| `onSubmit` | `Function` | ✓ | - |
| `onCancel` | `Function` | - | - |
| `placeholder` | `string` | - | "Add a comment..." |
| `compact` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_CommentForm_7859ca39["CommentForm"]
    class component_CommentForm_7859ca39 rootComponent
```

## Relationships

- RENDERS → `MentionsInput`
- RENDERS → `Mention`
- RENDERS → `AtSign`
- RENDERS → `Loader2`
- RENDERS → `Send`
- USES_HOOK → `useState`
- USES_HOOK → `useDocumentCollaborators`
- USES_HOOK → `useMemo`
- USES_HOOK → `useCallback`

## Referenced By

- `ReplyForm` (RENDERS)

<!-- source: interface-competitorresearchresult.md -->

# CompetitorResearchResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/competitor-research.service.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `competitors` | `CompetitorInfo[]` |
| `crawledPages` | `CrawledPage[]` |
| `summary` | `string` |
| `totalContentLength` | `number` |
| `researchedAt` | `Date` |

<!-- source: interface-contextmanagerconfig.md -->

# ContextManagerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/context-manager.ts` (line 36)

## Properties

| Property | Type |
|---|---|
| `maxTokens` | `number` |
| `compactionThreshold` | `number` |
| `minItemsToKeep` | `number` |
| `strategy` | `CompactionStrategy` |

<!-- source: api-endpoint-create-6.md -->

# create

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 129)

## Endpoint

`POST /doc-versions/:projectId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: function-createnotebookedittool.md -->

# createNotebookEditTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/notebook-edit.tool.ts` (line 29)

## Signature

```ts
function createNotebookEditTool(options: NotebookEditOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `NotebookEditOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-createprogresstracker.md -->

# createProgressTracker

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/progress-tracker.ts` (line 191)

Create a progress tracker for a stage

## Signature

```ts
function createProgressTracker(stageName: string, totalItems: number, batchSize: number): ProgressTracker
```

## Parameters

| Name | Type |
|---|---|
| `stageName` | `string` |
| `totalItems` | `number` |
| `batchSize` | `number` |

**Returns:** `ProgressTracker`

<!-- source: class-createrelationdto.md -->

# CreateRelationDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/graph/dto/create-relation.dto.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `from` | `string` |
| `to` | `string` |
| `type` | `RelationType` |
| `metadata` | `Record<string, any>` |
| `weight` | `number` |

<!-- source: function-createvisualagent.md -->

# createVisualAgent

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/agents/visual.agent.ts` (line 20)

## Signature

```ts
function createVisualAgent(config: GenerationConfig, deps: VisualDependencies, imageQualityConfig: ImageQualityConfig): AgentConfig<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `config` | `GenerationConfig` |
| `deps` | `VisualDependencies` |
| `imageQualityConfig` | `ImageQualityConfig` |

**Returns:** `AgentConfig<PmeContext>`

<!-- source: interface-deploymentnode.md -->

# DeploymentNode

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/deployment-diagram.generator.ts` (line 35)

Represents a deployment node in the infrastructure

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `type` | `DeploymentNodeType` |
| `technology` | `string` |
| `port` | `number` |
| `environment` | `string` |
| `instances` | `number` |
| `entity` | `Entity` |

<!-- source: service-docversionretentionservice.md -->

# DocVersionRetentionService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/doc-version/retention.service.ts` (line 11)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleInit` | `onModuleInit()` | `unknown` |
| `onModuleDestroy` | `onModuleDestroy()` | `unknown` |
| `enforceAll` | `enforceAll()` | `unknown` |
| `enforcePolicy` | `enforcePolicy(projectId: string, policy: RetentionPolicy)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `auditservice`

<!-- source: interface-donutdatum.md -->

# DonutDatum

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/DonutChart.tsx` (line 7)

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `count` | `number` |

<!-- source: function-enrichscreenshotmetadata.md -->

# enrichScreenshotMetadata

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/screenshot-metadata-enricher.ts` (line 45)

Enrich screenshot metadata with state machine context

Takes a screenshot URL and parsed entities, finds the matching component,
and adds state machine and UI interaction information.

## Signature

```ts
function enrichScreenshotMetadata(screenshotUrl: string, route: string, entities: Entity[], options: {
    title?: string;
    viewport?: { width: number; height: number };
    capturedAt?: Date;
    isModal?: boolean;
    parentUrl?: string;
  }): EnhancedScreenshotMetadata
```

## Parameters

| Name | Type |
|---|---|
| `screenshotUrl` | `string` |
| `route` | `string` |
| `entities` | `Entity[]` |
| `options` | `{
    title?: string;
    viewport?: { width: number; height: number };
    capturedAt?: Date;
    isModal?: boolean;
    parentUrl?: string;
  }` |

**Returns:** `EnhancedScreenshotMetadata`

<!-- source: class-entityselector.md -->

# EntitySelector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/entity-selector.ts` (line 45)

EntitySelector - Smart entity selection for document generation

Selects entities based on:
1. Tier priority (TIER_1 > TIER_2 > TIER_3)
2. User-facing status
3. Document plan requirements
4. Token budget constraints

## Methods

| Method | Signature | Returns |
|---|---|---|
| `selectForDocument` | `selectForDocument(plan: DocumentPlan, entities: Entity[])` | `Entity[]` |
| `selectRelated` | `selectRelated(entityId: string, entities: Entity[])` | `Entity[]` |
| `selectByType` | `selectByType(entities: Entity[], types: Entity['type'][])` | `Entity[]` |
| `selectUserFacing` | `selectUserFacing(entities: Entity[])` | `Entity[]` |
| `selectByFeatureArea` | `selectByFeatureArea(entities: Entity[], featureArea: string)` | `Entity[]` |

<!-- source: function-get-4.md -->

# GET

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/[audienceSlug]/[documentSlug]/md/route.ts` (line 9)

Same-origin per-page markdown twin: GET /p/<slug>/<audience>/<document>/md — the raw markdown
of a published page for agents / "View as Markdown". Proxies the API's urlId-keyed .md endpoint.

## Signature

```ts
async function GET(req: Request, ctx: { params: Promise<{ slugId: string; audienceSlug: string; documentSlug: string }> })
```

## Parameters

| Name | Type |
|---|---|
| `req` | `Request` |
| `ctx` | `{ params: Promise<{ slugId: string; audienceSlug: string; documentSlug: string }> }` |

<!-- source: type-jobid.md -->

# JobId

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 10)

Common types shared across all pipeline stages.
IMPLEMENT THIS FILE FIRST - all other types depend on it.

## Definition

```ts
string
```

<!-- source: interface-projectparseresult.md -->

# ProjectParseResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/parse-result.interface.ts` (line 278)

Result of parsing an entire project

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `rootDir` | `string` |
| `parsers` | `string[]` |
| `timestamp` | `Date` |
| `status` | `ParseStatus` |
| `results` | `ParseResult[]` |
| `summary` | `ParseSummary` |
| `entities` | `Entity[]` |
| `relationships` | `Relationship[]` |

<!-- source: class-promptsectionregistry.md -->

# PromptSectionRegistry

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/prompt-sections.ts` (line 46)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `register` | `register(section: PromptSection)` | `this` |
| `unregister` | `unregister(id: string)` | `this` |
| `build` | `build(ctx: SectionContext)` | `string` |
| `activeIds` | `activeIds(ctx: SectionContext)` | `string[]` |

<!-- source: controller-publicdocumentcontroller.md -->

# PublicDocumentController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/document/public-document.controller.ts` (line 8)

## Relationships

- MODULE_DECLARES → `getByUrlWithAudience`
- MODULE_DECLARES → `getByUrl`
- MODULE_DECLARES → `getPublicDocument`
- MODULE_DECLARES → `getPublicTree`
- DEPENDS_ON → `documentservice`
- DEPENDS_ON → `urlservice`

<!-- source: constant-rag-index-credit-cost.md -->

# RAG_INDEX_CREDIT_COST

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/billing/billing.constants.ts` (line 20)

<!-- source: function-searchdocs.md -->

# searchDocs

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/web-search/data/competitor-docs-index.ts` (line 386)

Search docs by keywords

## Signature

```ts
function searchDocs(keywords: string[]): CompetitorDoc[]
```

## Parameters

| Name | Type |
|---|---|
| `keywords` | `string[]` |

**Returns:** `CompetitorDoc[]`

<!-- source: interface-sitegencontext.md -->

# SiteGenContext

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/agents/site-gen.agent.ts` (line 28)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `userId` | `string` |
| `outputDir` | `string` |

<!-- source: module-templatemodule.md -->

# TemplateModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/template/template.module.ts` (line 13)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `authmodule`
- MODULE_DECLARES → `templatecontroller`
- MODULE_PROVIDES → `templateservice`
- MODULE_EXPORTS → `templateservice`

<!-- source: interface-authconfigdiscovery-2.md -->

# AuthConfigDiscovery

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 194)

Authentication configuration discovered in source code

## Properties

| Property | Type |
|---|---|
| `loginRoute` | `string` |
| `roles` | `string[]` |
| `roleSource` | `RoleSourceType` |
| `templatePermissions` | `string[]` |
| `guardNames` | `string[]` |

<!-- source: component-buggymarkdown.md -->

# BuggyMarkdown

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/error-handling.tsx` (line 23)

## Diagram

```mermaid
graph TD
    component_BuggyMarkdown_623cb9fa["BuggyMarkdown"]
    class component_BuggyMarkdown_623cb9fa rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: constant-can-use-dom.md -->

# CAN_USE_DOM

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/utils/detectMac.ts` (line 2)

## Definition

```ts
boolean
```

<!-- source: component-commentpreview.md -->

# CommentPreview

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/CommentMarkers.tsx` (line 158)

CommentPreview - Tooltip showing comment preview on hover

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `comments` | `CommentWithUser[]` | ✓ | - |
| `onCommentClick` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CommentPreview_4043f539["CommentPreview"]
    class component_CommentPreview_4043f539 rootComponent
```

## Referenced By

- `CommentMarkers` (RENDERS)

<!-- source: interface-competitorsearchresult.md -->

# CompetitorSearchResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/web-search/interfaces/search.interfaces.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `query` | `string` |
| `results` | `SearchResult[]` |
| `totalResults` | `number` |
| `searchTime` | `number` |
| `source` | `'cache' | 'index' | 'api'` |

<!-- source: interface-coordinationsection.md -->

# CoordinationSection

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/coordination-doc.ts` (line 13)

Shared Coordination Document (Multi-Agent)

A thread-safe in-memory markdown document that multiple agents can read/write
for coordinated work. Each section is keyed by a case-insensitive title and
tracks who last updated it and when.

Usage: create one CoordinationDoc instance and share it across agents via
createCoordinationTool(). Agents use the tool to post status updates,
decisions, blockers, and hand-off notes visible to all other agents.

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `content` | `string` |
| `updatedBy` | `string` |
| `updatedAt` | `string` |

<!-- source: api-endpoint-create-7.md -->

# create

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/category.controller.ts` (line 33)

Create a new category

## Endpoint

`POST /categories`

## Referenced By

- `CategoryController` (MODULE_DECLARES)

<!-- source: function-createnotebookreadtool.md -->

# createNotebookReadTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/notebook-read.tool.ts` (line 131)

## Signature

```ts
function createNotebookReadTool(options: NotebookReadOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `NotebookReadOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-createratelimiter.md -->

# createRateLimiter

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/rate-limiter.ts` (line 155)

Create a rate limiter from environment configuration

## Signature

```ts
function createRateLimiter(config: Partial<RateLimiterConfig>): RateLimiter
```

## Parameters

| Name | Type |
|---|---|
| `config` | `Partial<RateLimiterConfig>` |

**Returns:** `RateLimiter`

<!-- source: class-createreplydto.md -->

# CreateReplyDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/comment/dto/create-reply.dto.ts` (line 7)

DTO for creating a reply to an existing comment

## Properties

| Property | Type |
|---|---|
| `content` | `string` |

<!-- source: function-createvisualqatool.md -->

# createVisualQaTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/visual-qa.tool.ts` (line 35)

## Signature

```ts
function createVisualQaTool(renderFn: RenderAndCaptureFn): ToolDefinition<PmeContext>
```

## Parameters

| Name | Type |
|---|---|
| `renderFn` | `RenderAndCaptureFn` |

**Returns:** `ToolDefinition<PmeContext>`

<!-- source: interface-detectedframework.md -->

# DetectedFramework

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/config.interface.ts` (line 156)

Detected framework information

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `category` | `'frontend' | 'backend' | 'database' | 'testing' | 'build' | 'other'` |
| `detectedFrom` | `string` |
| `confidence` | `number` |
| `parser` | `string` |

<!-- source: service-docversionservice.md -->

# DocVersionService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.service.ts` (line 37)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getNextVersionNumber` | `getNextVersionNumber(projectId: string)` | `Promise<number>` |
| `create` | `create(projectId: string, organizationId: string, createdById: string, opts: {
      label?: string;
      description?: string;
      commitHash?: string;
      branch?: string;
      gitTag?: string;
      previousVersionId?: string;
      jobId?: string;
      /** Doc set this version belongs to: 'user' (default) or 'technical'. */
      audienceScope?: string;
    })` | `unknown` |
| `listByProject` | `listByProject(projectId: string, opts: {
      status?: DocVersionStatus[];
      limit?: number;
      offset?: number;
    })` | `unknown` |
| `getById` | `getById(id: string)` | `unknown` |
| `getActiveVersion` | `getActiveVersion(projectId: string, audienceScope: unknown)` | `unknown` |
| `getPublishedVersions` | `getPublishedVersions(projectId: string)` | `unknown` |
| `activate` | `activate(id: string)` | `unknown` |
| `publish` | `publish(id: string)` | `unknown` |
| `archive` | `archive(id: string)` | `unknown` |
| `deprecate` | `deprecate(id: string)` | `unknown` |
| `update` | `update(id: string, dto: { label?: string; description?: string })` | `unknown` |
| `delete` | `delete(id: string)` | `unknown` |
| `setGenerationSummary` | `setGenerationSummary(id: string, summary: Record<string, any>)` | `unknown` |
| `getReviewData` | `getReviewData(versionId: string)` | `unknown` |
| `getScreenshotInventory` | `getScreenshotInventory(versionId: string)` | `unknown` |
| `removeScreenshotPlaceholders` | `removeScreenshotPlaceholders(versionId: string, routePaths: string[])` | `unknown` |
| `previewScreenshot` | `previewScreenshot(url: string)` | `unknown` |
| `captureScreenshot` | `captureScreenshot(projectId: string, versionId: string, routePath: string, documentId: string, userTargetUrl: string)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `auditservice`
- DEPENDS_ON → `moduleref`

<!-- source: interface-entitynodedata.md -->

# EntityNodeData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Graph/types.ts` (line 50)

Node data for Entity nodes

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `entityId` | `string` |
| `entityType` | `string` |
| `name` | `string` |
| `metadata` | `Record<string, unknown>` |

<!-- source: function-entitysignaturehash.md -->

# entitySignatureHash

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/staleness.ts` (line 21)

A stable hash of an entity's PUBLIC SIGNATURE (not its body/formatting). Two parses of the
same logical API produce the same hash; a signature change (new method, changed return type,
new field, new endpoint shape) changes it. Moves/renames of unrelated code do not.

## Signature

```ts
function entitySignatureHash(entity: Entity): string
```

## Parameters

| Name | Type |
|---|---|
| `entity` | `Entity` |

**Returns:** `string`

<!-- source: class-expressdetector.md -->

# ExpressDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/express-detector.ts` (line 53)

Express Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectRoutes` | `detectRoutes(entities: Entity[])` | `DetectedExpressRoute[]` |
| `detectMiddleware` | `detectMiddleware(entities: Entity[])` | `DetectedExpressMiddleware[]` |
| `getRouteSummary` | `getRouteSummary(route: DetectedExpressRoute)` | `string` |

<!-- source: function-get-5.md -->

# GET

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/llms-full.txt/route.ts` (line 9)

Slug-fronted, same-origin llms-full.txt: /p/<slug>/llms-full.txt — the whole published
corpus concatenated for single-fetch ingestion by an agent. Proxies the API generator.

## Signature

```ts
async function GET(req: Request, ctx: { params: Promise<{ slugId: string }> })
```

## Parameters

| Name | Type |
|---|---|
| `req` | `Request` |
| `ctx` | `{ params: Promise<{ slugId: string }> }` |

<!-- source: type-jobstage.md -->

# JobStage

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/orchestrator.ts` (line 34)

## Definition

```ts
| 'parse'
  | 'chunk'
  | 'extract-features'
  | 'analyze'
  | 'synthesize'
  | 'structure'
  | 'divide-phases'
  | 'plan-sessions'
  | 'plan-documents'
  | 'generate'
  | 'verify'
  | 'meta-docs'
  | 'upload'
  | 'screenshots'
```

<!-- source: interface-propdefinition.md -->

# PropDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 343)

Prop definition for a component

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `required` | `boolean` |
| `defaultValue` | `string` |
| `description` | `string` |

<!-- source: controller-publicissuescontroller.md -->

# PublicIssuesController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/issues/public-issues.controller.ts` (line 8)

## Relationships

- MODULE_DECLARES → `create`
- MODULE_DECLARES → `getTicket`
- MODULE_DECLARES → `reply`
- MODULE_DECLARES → `csat`
- DEPENDS_ON → `issuesservice`

<!-- source: constant-redacted.md -->

# REDACTED

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/capture/capture.redact.ts` (line 13)

Server-side value redaction for captured steps (defense in depth).

The recorder client already redacts sensitive inputs at capture time
(type=password, token/email/card patterns) — but we NEVER trust the client.
Every stored step value is re-scanned here so a secret can never land in the
database even if a tampered/old recorder sends one through.

Moat rule: the recipe (selectors + actions) is the asset — secret VALUES are
not, and are actively harmful to keep. When in doubt, redact.

<!-- source: class-repomap.md -->

# RepoMap

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/repo-map.ts` (line 106)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate(focusQuery: string, recentFiles: string[])` | `Promise<RepoMapResult>` |
| `invalidate` | `invalidate(files: string[])` | `void` |
| `clearCache` | `clearCache()` | `void` |

<!-- source: function-seedtemplates.md -->

# seedTemplates

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/template/seeds/seed-templates.ts` (line 93)

Seeds all document templates into the database.

This function creates or updates all predefined templates.
Templates are marked as public and system-created.

## Signature

```ts
async function seedTemplates(prisma: PrismaClient, systemUserId: string): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `prisma` | `PrismaClient` |
| `systemUserId` | `string` |

**Returns:** `Promise<void>`

<!-- source: interface-sitegendependencies.md -->

# SiteGenDependencies

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/agents/site-gen.agent.ts` (line 36)

## Properties

| Property | Type |
|---|---|
| `componentLibraryDir` | `string` |
| `templateDir` | `string` |
| `productKnowledge` | `ProductKnowledgeDeps` |

<!-- source: module-throttlingmodule.md -->

# ThrottlingModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/common/throttling.module.ts` (line 25)

<!-- source: interface-authresponse.md -->

# AuthResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/auth.ts` (line 20)

## Properties

| Property | Type |
|---|---|
| `user` | `{
    id: string;
    email: string;
    name: string;
    role: string;
    organizationId: string;
  }` |
| `accessToken` | `string` |
| `refreshToken` | `string` |

<!-- source: component-buttonordropdownbutton.md -->

# ButtonOrDropdownButton

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/toolbar.tsx` (line 185)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |
| `title` | `string` | ✓ | - |
| `onChoose` | `Function` | ✓ | - |
| `items` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ButtonOrDropdownButton_88ad2ca["ButtonOrDropdownButton"]
    class component_ButtonOrDropdownButton_88ad2ca rootComponent
```

## Relationships

- RENDERS → `ButtonWithTooltip`
- RENDERS → `RadixSelect-Root`
- RENDERS → `SelectButtonTrigger`
- RENDERS → `SelectContent`
- RENDERS → `SelectItem`
- USES_HOOK → `useCellValue`

<!-- source: constant-cancellinkedit.md -->

# cancelLinkEdit$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 273)

An action that cancel the edit of the current link.

<!-- source: component-commentreply.md -->

# CommentReply

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Comments/CommentThread.tsx` (line 161)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `reply` | `CommentWithUser` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CommentReply_41229965["CommentReply"]
    class component_CommentReply_41229965 rootComponent
```

## Relationships

- RENDERS → `Avatar`

## Referenced By

- `CommentThread` (RENDERS)

<!-- source: interface-confluenceexportdto.md -->

# ConfluenceExportDto

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/techdocs-export.service.ts` (line 60)

## Properties

| Property | Type |
|---|---|
| `baseUrl` | `string` |
| `email` | `string` |
| `apiToken` | `string` |
| `spaceKey` | `string` |
| `scope` | `'technical' | 'user'` |

<!-- source: interface-coordinationtooloptions.md -->

# CoordinationToolOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/coordination.tool.ts` (line 11)

## Properties

| Property | Type |
|---|---|
| `doc` | `CoordinationDoc` |

<!-- source: api-endpoint-create-8.md -->

# create

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 50)

## Endpoint

`POST /documents`

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: function-createnotetool.md -->

# createNoteTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/note.tool.ts` (line 15)

## Signature

```ts
function createNoteTool(noteStore: AgentNoteStore): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `noteStore` | `AgentNoteStore` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-createretryconfig.md -->

# createRetryConfig

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/retry.ts` (line 152)

Merge partial config with defaults

## Signature

```ts
function createRetryConfig(partial: Partial<RetryConfig>): RetryConfig
```

## Parameters

| Name | Type |
|---|---|
| `partial` | `Partial<RetryConfig>` |

**Returns:** `RetryConfig`

<!-- source: class-createsuggestiondto.md -->

# CreateSuggestionDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/suggestion/dto/create-suggestion.dto.ts` (line 3)

## Properties

| Property | Type |
|---|---|
| `originalText` | `string` |
| `suggestedText` | `string` |
| `positionStart` | `number` |
| `positionEnd` | `number` |

<!-- source: interface-detectedproject.md -->

# DetectedProject

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/config.interface.ts` (line 111)

Project detection result

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `projectType` | `'monorepo' | 'single-app' | 'library' | 'unknown'` |
| `frameworks` | `DetectedFramework[]` |
| `packageManager` | `'npm' | 'yarn' | 'pnpm' | 'bun' | 'unknown'` |
| `buildTools` | `string[]` |
| `recommendedParsers` | `string[]` |
| `projectName` | `string` |
| `confidence` | `number` |

<!-- source: service-domaindnsservice.md -->

# DomainDnsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/project/domain-dns.service.ts` (line 68)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `recordSpecs` | `recordSpecs(domain: string, token: string, cnameTarget: string)` | `DnsRecordSpec[]` |
| `check` | `check(domain: string, token: string, cnameTarget: string, clusterIp: string)` | `Promise<DomainDnsResult>` |

<!-- source: function-escapehtml.md -->

# escapeHtml

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/assemble-html.tool.ts` (line 366)

## Signature

```ts
function escapeHtml(str: string): string
```

## Parameters

| Name | Type |
|---|---|
| `str` | `string` |

**Returns:** `string`

<!-- source: function-extractcitations.md -->

# extractCitations

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/grounded-ask.ts` (line 38)

The `[path]` citations present in the answer text.

## Signature

```ts
function extractCitations(answer: string): string[]
```

## Parameters

| Name | Type |
|---|---|
| `answer` | `string` |

**Returns:** `string[]`

<!-- source: class-fastapidetector.md -->

# FastAPIDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/fastapi-detector.ts` (line 70)

FastAPI Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectRoutes` | `detectRoutes(entities: Entity[])` | `DetectedFastAPIRoute[]` |
| `detectModels` | `detectModels(entities: Entity[])` | `DetectedPydanticModel[]` |
| `getRouteSummary` | `getRouteSummary(route: DetectedFastAPIRoute)` | `string` |

<!-- source: interface-fileuploadprops.md -->

# FileUploadProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Parser/FileUpload.tsx` (line 5)

## Properties

| Property | Type |
|---|---|
| `onFileSelect` | `(file: File) => void` |
| `accept` | `string` |
| `maxSize` | `number` |
| `className` | `string` |

<!-- source: function-get-6.md -->

# GET

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/llms.txt/route.ts` (line 10)

Slug-fronted, same-origin llms.txt for a published site: /p/<slug>/llms.txt —
the discoverable agent-native index (Mintlify/GitBook parity). Proxies the API's
urlId-keyed generator so crawlers/agents never touch the internal projectId/API origin.

## Signature

```ts
async function GET(req: Request, ctx: { params: Promise<{ slugId: string }> })
```

## Parameters

| Name | Type |
|---|---|
| `req` | `Request` |
| `ctx` | `{ params: Promise<{ slugId: string }> }` |

<!-- source: type-jobstage-2.md -->

# JobStage

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 12)

## Definition

```ts
| 'parse'
  | 'chunk'
  | 'extract-features'
  | 'analyze'
  | 'synthesize'
  | 'structure'
  | 'divide-phases'
  | 'plan-sessions'
  | 'plan-documents'
  | 'generate'
  | 'verify'
  | 'meta-docs'
  | 'screenshots'
  | 'upload'
```

<!-- source: interface-propertydefinition.md -->

# PropertyDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 533)

Property definition within a schema

## Properties

| Property | Type |
|---|---|
| `type` | `string` |
| `description` | `string` |
| `example` | `unknown` |
| `format` | `string` |
| `enum` | `string[]` |

<!-- source: controller-publicprojectcontroller.md -->

# PublicProjectController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 39)

## Relationships

- MODULE_DECLARES → `getPublishedProjects`
- MODULE_DECLARES → `getBySubdomain`
- MODULE_DECLARES → `getByCustomDomain`
- MODULE_DECLARES → `getByUrl`
- MODULE_DECLARES → `getLlmsTxtByUrl`
- MODULE_DECLARES → `getLlmsFullTxtByUrl`
- MODULE_DECLARES → `getPageMarkdownByUrl`
- MODULE_DECLARES → `getSearchIndexByUrl`
- MODULE_DECLARES → `handleMcp`
- MODULE_DECLARES → `mcpGet`
- MODULE_DECLARES → `getPublishedVersions`
- MODULE_DECLARES → `getPublishedLanguagesByUrl`
- MODULE_DECLARES → `getAudiencesByUrl`
- MODULE_DECLARES → `getAudienceDocuments`
- MODULE_DECLARES → `getDocument`
- MODULE_DECLARES → `getRelatedDocuments`
- MODULE_DECLARES → `getCapabilities`
- MODULE_DECLARES → `getPublicTechnicalSnapshot`
- MODULE_DECLARES → `getPublicEntity`
- MODULE_DECLARES → `getPublicApiSpec`
- MODULE_DECLARES → `getPublicSupportAgents`
- MODULE_DECLARES → `getPublicChatConfig`
- MODULE_DECLARES → `escalatePublicChat`
- MODULE_DECLARES → `recordPublicChatFeedback`
- MODULE_DECLARES → `recordPublicChatResolution`
- MODULE_DECLARES → `publicSearch`
- MODULE_DECLARES → `getScreenshotPlaceholders`
- DEPENDS_ON → `projectservice`
- DEPENDS_ON → `urlservice`
- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `supportagentservice`
- DEPENDS_ON → `aiservice`
- DEPENDS_ON → `brandingservice`
- DEPENDS_ON → `techdocsragservice`
- DEPENDS_ON → `technicaldocsmaterializerservice`
- DEPENDS_ON → `issuesservice`
- DEPENDS_ON → `eventsservice`
- DEPENDS_ON → `technicaldocsservice`
- DEPENDS_ON → `projectdomainsservice`

<!-- source: constant-releasenotestemplate.md -->

# releaseNotesTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/release-notes.template.ts` (line 3)

<!-- source: class-sdkmodelproviderbridge.md -->

# SdkModelProviderBridge

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/sdk-model-bridge.ts` (line 40)

Wraps an existing SDK ModelProvider (AzureModelProvider, AnthropicModelProvider)
as our IModelProvider interface. This lets the Live-SWE loop use the existing
Azure adapter with all its optimizations (retries, incremental input, fallback).

**Implements:** `IModelProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getResponse` | `getResponse(request: ModelProviderRequest)` | `Promise<ModelProviderResponse>` |
| `getStreamedResponse` | `getStreamedResponse(request: ModelProviderRequest)` | `AsyncIterable<unknown>` |
| `getProfile` | `getProfile()` | `ModelCapabilityProfile` |

<!-- source: function-servedocsmcp.md -->

# serveDocsMcp

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/mcp/serve-mcp.ts` (line 12)

The single MCP-over-Streamable-HTTP serving path, shared by the projectId-keyed technical MCP
endpoint and the public slug-fronted MCP endpoint. Stateless: each POST is a self-contained
JSON-RPC exchange (no server-held session), which fits a read-only docs server and scales trivially.

## Signature

```ts
async function serveDocsMcp(corpus: DocsCorpus, askFn: AskFn | undefined, req: Request, res: Response, onError: (msg: string) => void, execFn: ApiExecFn): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `corpus` | `DocsCorpus` |
| `askFn` | `AskFn | undefined` |
| `req` | `Request` |
| `res` | `Response` |
| `onError` | `(msg: string) => void` |
| `execFn` | `ApiExecFn` |

**Returns:** `Promise<void>`

<!-- source: interface-sitegenpromptconfig.md -->

# SiteGenPromptConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/agents/site-gen.prompts.ts` (line 8)

Site Generation Agent — System Prompt

Instructions for the AI agent that builds a complete Vite+React site
from product knowledge and the component library.

## Properties

| Property | Type |
|---|---|
| `brandName` | `string` |
| `targetAudience` | `string` |
| `brandVoice` | `string` |
| `language` | `string` |
| `theme` | `'light' | 'dark' | 'colorful'` |

<!-- source: module-trialmodule.md -->

# TrialModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/trial/trial.module.ts` (line 7)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `technicaldocsmodule`
- MODULE_DECLARES → `trialcontroller`
- MODULE_PROVIDES → `trialservice`

<!-- source: interface-autogeneratedfileinfo.md -->

# AutoGeneratedFileInfo

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-02.types.ts` (line 108)

AutoGeneratedFileInfo - Info about auto-generated files
These files need special handling to avoid including repetitive boilerplate.

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `generator` | `string` |
| `uniqueEndpoints` | `Array<{
    // For API clients
    method: string;
    path: string;
    operationId: string;
  }>` |
| `uniqueTypes` | `Array<{
    // For type files
    name: string;
    fields: string[];
  }>` |
| `templateSummary` | `string` |

<!-- source: component-callouteditor.md -->

# CalloutEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/directives.tsx` (line 238)

## Diagram

```mermaid
graph TD
    component_CalloutEditor_4947da6c["CalloutEditor"]
    class component_CalloutEditor_4947da6c rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: constant-closeimagedialog.md -->

# closeImageDialog$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 336)

Close the image dialog.

<!-- source: component-commentskeleton.md -->

# CommentSkeleton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Comments/CommentSkeleton.tsx` (line 8)

## Diagram

```mermaid
graph TD
    component_CommentSkeleton_236c699["CommentSkeleton"]
    class component_CommentSkeleton_236c699 rootComponent
```

## Referenced By

- `CommentSkeletonList` (RENDERS)

<!-- source: interface-contributorstats.md -->

# ContributorStats

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/dto/document-stats.dto.ts` (line 4)

Contributor statistics

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `email` | `string` |
| `editCount` | `number` |
| `lastEditAt` | `Date` |

<!-- source: api-endpoint-create-9.md -->

# create

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/public-issues.controller.ts` (line 13)

## Endpoint

`POST /public/issues`

## Referenced By

- `PublicIssuesController` (MODULE_DECLARES)

<!-- source: function-createplanmodefilter.md -->

# createPlanModeFilter

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/session/plan-mode-filter.ts` (line 55)

Create a ToolPreExecutionHook that blocks write/mutation tools during plan mode.

When plan mode is active, any tool not in the allowed set gets a clear error
message explaining that it's blocked and suggesting the agent continue with
investigation. The tool never executes — it's blocked before running.

Returns the hook and a `setPlanMode` function to toggle blocking on/off.

## Signature

```ts
function createPlanModeFilter(options: PlanModeFilterOptions): { hook: ToolPreExecutionHook; setPlanMode: (active: boolean) => void }
```

## Parameters

| Name | Type |
|---|---|
| `options` | `PlanModeFilterOptions` |

**Returns:** `{ hook: ToolPreExecutionHook; setPlanMode: (active: boolean) => void }`

<!-- source: function-createroutemapping.md -->

# createRouteMapping

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 147)

Create a route mapping with defaults

## Signature

```ts
function createRouteMapping(options: Pick<RouteMapping, 'path' | 'routeFile' | 'framework'> &
    Partial<Omit<RouteMapping, 'path' | 'routeFile' | 'framework'>>): RouteMapping
```

## Parameters

| Name | Type |
|---|---|
| `options` | `Pick<RouteMapping, 'path' | 'routeFile' | 'framework'> &
    Partial<Omit<RouteMapping, 'path' | 'routeFile' | 'framework'>>` |

**Returns:** `RouteMapping`

<!-- source: class-createtemplatedto.md -->

# CreateTemplateDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/template/dto/create-template.dto.ts` (line 19)

DTO for creating a new document template.
Used by administrators and maintainers to add templates to the system.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `category` | `TemplateCategory` |
| `content` | `string` |
| `thumbnail` | `string` |
| `metadata` | `Record<string, unknown>` |
| `defaultType` | `DocumentType` |
| `defaultAudiences` | `string[]` |
| `isPublic` | `boolean` |
| `organizationId` | `string` |

<!-- source: interface-cronscheduleroptions.md -->

# CronSchedulerOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/cron.tool.ts` (line 30)

## Properties

| Property | Type |
|---|---|
| `inject` | `(message: string) => void` |

<!-- source: interface-diagramgenerationresult.md -->

# DiagramGenerationResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/state-machine-diagram.generator.ts` (line 87)

Result of diagram generation

## Properties

| Property | Type |
|---|---|
| `mermaidCode` | `string` |
| `coverageStats` | `{
    stateCoverage: number;
    transitionCoverage: number;
    qualityScore: number;
  }` |
| `cssClasses` | `string[]` |

<!-- source: service-draftdocumentservice.md -->

# DraftDocumentService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/document/services/draft-document.service.ts` (line 69)

Single reusable draft→publish backbone entry point: create a `state:'DRAFT'`, `version:1`
Document with a unique urlId + slug. Every draft producer (the recorder's flow→manual path,
grounded AI page assist, and the Wave-3 ticket→content loop) funnels through here so they all
land in the SAME review/publish flow (`POST documents/:id/publish`) — no forked publish paths.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createDraftDocument` | `createDraftDocument(params: CreateDraftDocumentParams)` | `Promise<DraftDocumentResult>` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: function-extractcomponentnamefrompath-2.md -->

# extractComponentNameFromPath

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 648)

Extract the component name from a file path

## Signature

```ts
function extractComponentNameFromPath(filePath: string): string
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |

**Returns:** `string`

<!-- source: class-filecache.md -->

# FileCache

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/services/entity-mapper.service.ts` (line 110)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getLines` | `getLines(absolutePath: string)` | `string[] | null` |
| `clear` | `clear()` | `void` |

<!-- source: interface-flowstage.md -->

# FlowStage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Graph/types.ts` (line 87)

Flow stage for flow view

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `entities` | `KGEntity[]` |
| `order` | `number` |

<!-- source: function-get-7.md -->

# GET

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/mcp/route.ts` (line 38)

<!-- source: function-getalllayoutinfo.md -->

# getAllLayoutInfo

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/layouts/registry.ts` (line 55)

Get all registered layouts grouped by section type.

## Signature

```ts
function getAllLayoutInfo(): Record<string, string[]>
```

**Returns:** `Record<string, string[]>`

<!-- source: type-jobstatus-4.md -->

# JobStatus

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 191)

## Definition

```ts
'pending' | 'running' | 'completed' | 'failed'
```

<!-- source: interface-queueconfig.md -->

# QueueConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/config.interface.ts` (line 144)

Queue configuration

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `defaultJobOptions` | `{
    /**
     * Number of retry attempts
     * @default 3
     */
    attempts: number;

    /**
     * Backoff strategy
     */
    backoff: {
      type: 'exponential' | 'fixed';
      delay: number;
    };

    /**
     * Remove job on completion
     */
    removeOnComplete: boolean | number;

    /**
     * Remove job on failure
     */
    removeOnFail: boolean | number;
  }` |

<!-- source: constant-retrospectivetemplate.md -->

# retrospectiveTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/retrospective.template.ts` (line 3)

<!-- source: controller-samlcontroller.md -->

# SamlController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/auth/saml/saml.controller.ts` (line 9)

## Relationships

- MODULE_DECLARES → `login`
- MODULE_DECLARES → `callback`
- MODULE_DECLARES → `configureSaml`
- MODULE_DECLARES → `getConfig`
- MODULE_DECLARES → `toggleSaml`
- MODULE_DECLARES → `getMetadata`
- DEPENDS_ON → `samlservice`

<!-- source: class-semanticindex.md -->

# SemanticIndex

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/semantic-index.ts` (line 31)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `index` | `index()` | `Promise<IndexStats>` |
| `reindexFiles` | `reindexFiles(files: string[])` | `Promise<void>` |
| `search` | `search(query: string, topK: number)` | `Promise<SearchResult[]>` |
| `isIndexed` | `isIndexed()` | `boolean` |

<!-- source: function-slimnavmap.md -->

# slimNavMap

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/curation.ts` (line 40)

Apply curation to a navMap: hidden entities are removed (type groups emptied by hiding are
dropped), pinned entities float to the top of their type group (relative order otherwise
preserved). Pure + non-mutating; a no-op curation returns the input untouched.

## Signature

```ts
function slimNavMap(navMap: T): T
```

## Parameters

| Name | Type |
|---|---|
| `navMap` | `T` |

**Returns:** `T`

<!-- source: interface-socialprooftimelineprops.md -->

# SocialProofTimelineProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/social-proof/social-proof-timeline.tsx` (line 17)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `milestones` | `Milestone[]` |

<!-- source: module-webhookmodule.md -->

# WebhookModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/webhooks/webhook.module.ts` (line 8)

## Relationships

- MODULE_IMPORTS → `databasemodule`
- MODULE_IMPORTS → `forwardref`
- MODULE_IMPORTS → `forwardref`
- MODULE_DECLARES → `webhookcontroller`
- MODULE_PROVIDES → `webhookservice`
- MODULE_EXPORTS → `webhookservice`

<!-- source: interface-azureresponsesconfig.md -->

# AzureResponsesConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/azure-responses.provider.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `endpoint` | `string` |
| `apiKey` | `string` |
| `apiVersion` | `string` |
| `useV1Endpoint` | `boolean` |
| `model` | `string` |
| `maxTokens` | `number` |
| `temperature` | `number` |
| `reasoningEffort` | `string` |
| `verbosity` | `string` |
| `timeout` | `number` |
| `retry` | `Partial<RetryConfig>` |

<!-- source: component-catchall.md -->

# CatchAll

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/bug-97.stories.tsx` (line 7)

## Diagram

```mermaid
graph TD
    component_CatchAll_a10f227["CatchAll"]
    class component_CatchAll_a10f227 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: constant-codeblockeditordescriptors.md -->

# codeBlockEditorDescriptors$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 319)

Contains the currently registered code block descriptors.

<!-- source: component-contrastwarning.md -->

# ContrastWarning

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/branding/page.tsx` (line 1132)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `color` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ContrastWarning_6596dce6["ContrastWarning"]
    class component_ContrastWarning_6596dce6 rootComponent
```

## Relationships

- RENDERS → `ExclamationTriangleIcon`

## Referenced By

- `BrandingSettingsPage` (RENDERS)

<!-- source: interface-crawleddocument.md -->

# CrawledDocument

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/web-search/interfaces/search.interfaces.ts` (line 32)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `title` | `string` |
| `content` | `string` |
| `html` | `string` |
| `markdown` | `string` |
| `metadata` | `{
    source: string;
    category: string[];
    crawledAt: Date;
    lastModified?: Date;
    author?: string;
    tags?: string[];
  }` |

<!-- source: api-endpoint-create-10.md -->

# create

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 45)

## Endpoint

`POST /projects`

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: function-createqualitygatetool.md -->

# createQualityGateTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/quality-gate.tool.ts` (line 13)

## Signature

```ts
function createQualityGateTool(qualityGates: QualityGate[]): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `qualityGates` | `QualityGate[]` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-createtokentracker.md -->

# createTokenTracker

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/pipeline/token-tracker.ts` (line 274)

Create a token tracker with default budget

## Signature

```ts
function createTokenTracker(budget: Partial<TokenBudget>): TokenTracker
```

## Parameters

| Name | Type |
|---|---|
| `budget` | `Partial<TokenBudget>` |

**Returns:** `TokenTracker`

<!-- source: class-createversiondto.md -->

# CreateVersionDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/create-version.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `comment` | `string` |

<!-- source: interface-crontools.md -->

# CronTools

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/cron.tool.ts` (line 123)

## Properties

| Property | Type |
|---|---|
| `cronCreateTool` | `ToolDefinition<TContext>` |
| `cronDeleteTool` | `ToolDefinition<TContext>` |
| `cronListTool` | `ToolDefinition<TContext>` |

<!-- source: interface-diffstatistics.md -->

# DiffStatistics

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/version-diff.ts` (line 77)

Diff statistics

## Properties

| Property | Type |
|---|---|
| `total` | `number` |
| `added` | `number` |
| `removed` | `number` |
| `modified` | `number` |
| `breaking` | `number` |
| `byType` | `Record<string, number>` |
| `bySeverity` | `Record<ChangeSeverity, number>` |

<!-- source: service-emailservice.md -->

# EmailService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/email/email.service.ts` (line 30)

EmailService — one send API, three transports, picked at startup:

 1. gateway — the Sherkety email gateway (EMAIL_GATEWAY_URL + EMAIL_GATEWAY_KEY).
    Managed sending from noreply@atloria.app; the platform default in prod.
 2. smtp    — nodemailer via SMTP_* env vars (self-host escape hatch).
 3. console — logs the email instead of sending; local-dev fallback.

The gateway contract has no attachment support, so sends WITH attachments
fall through to SMTP when configured, else are console-logged with a warning.

`EmailService` is the backend email-sending façade that exposes a single `send` API while selecting one of three transports at startup: Sherkety gateway (default in prod), SMTP via nodemailer, or a console logger for local development. It centralizes email delivery concerns (auth/config, transport selection, fallbacks) so the rest of the system can send emails without knowing the underlying provider. When attachments are present, it bypasses the gateway (no attachment support) and falls back to SMTP if configured, otherwise logs a warning and prints the email.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `sendMail` | `sendMail(opts: SendEmailOptions)` | `Promise<boolean>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant App as NestJS App Code
  participant Email as EmailService
  participant GW as Sherkety Gateway Transport
  participant SMTP as SMTP (nodemailer)
  participant Console as Console Transport

  App->>Email: send(message)
  Note over Email: Transport chosen at startup\n(gateway | smtp | console)

  alt message has attachments
    Note over Email: Gateway contract has no attachments
    alt SMTP configured
      Email->>SMTP: sendWithAttachments(message)
      SMTP-->>Email: result
    else SMTP not configured
      Email->>Console: warn + log(message)
      Console-->>Email: ok (logged)
    end
  else no attachments
    alt Transport = gateway
      Email->>GW: send(message)
      GW-->>Email: result
    else Transport = smtp
      Email->>SMTP: send(message)
      SMTP-->>Email: result
    else Transport = console
      Email->>Console: log(message)
      Console-->>Email: ok (logged)
    end
  end

  Email-->>App: delivery result / completion
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { EmailService } from './email.service';

@Injectable()
export class InviteService {
  constructor(private readonly email: EmailService) {}

  async sendInvite(to: string, inviteUrl: string) {
    await this.email.send({
      to,
      subject: 'You’ve been invited to Atloria',
      // shape may vary; keep to your app’s email DTO/contract
      html: `<p>Join here: <a href="${inviteUrl}">${inviteUrl}</a></p>`,
      text: `Join here: ${inviteUrl}`,
    });
  }

  async sendReport(to: string, pdfBuffer: Buffer) {
    await this.email.send({
      to,
      subject: 'Your monthly report',
      text: 'Attached is your monthly report.',
      attachments: [
        {
          filename: 'report.pdf',
          content: pdfBuffer,
          contentType: 'application/pdf',
        },
      ],
    });
  }
}
```

## AI Coding Instructions

- Treat `EmailService` as the only email entrypoint; do not instantiate transports directly in feature modules—inject the service and call `send`.
- Remember: gateway does **not** support attachments; if you add attachments to a message, ensure SMTP is configured in environments where delivery matters, or expect console fallback + warning.
- Keep transport selection/config at startup via environment variables (`EMAIL_GATEWAY_URL/KEY`, `SMTP_*`); avoid per-request switching or ad-hoc overrides.
- When modifying the send contract/DTO, update all transports consistently (gateway, SMTP, console) and preserve the fallback behavior for attachments.

<!-- source: function-extractcomponentstatemachines.md -->

# extractComponentStateMachines

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/component-state-machine-extractor.ts` (line 25)

Extract state machines from component code
Handles both enums defined in the same file and imported enums

## Signature

```ts
function extractComponentStateMachines(componentCode: string, componentFilePath: string): StateMachine[]
```

## Parameters

| Name | Type |
|---|---|
| `componentCode` | `string` |
| `componentFilePath` | `string` |

**Returns:** `StateMachine[]`

<!-- source: class-frameworkdetector.md -->

# FrameworkDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/framework-detector.ts` (line 31)

Framework Detector - Identifies project tech stack

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detect` | `detect(repoPath: string)` | `Promise<FrameworkDetectionResult>` |

<!-- source: function-get-8.md -->

# GET

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/sitemap.xml/route.ts` (line 10)

Per-published-site sitemap: /p/<slug>/sitemap.xml — landing + every audience +
every published document URL. Table stakes for public docs SEO.

## Signature

```ts
async function GET(_req: Request, ctx: { params: Promise<{ slugId: string }> })
```

## Parameters

| Name | Type |
|---|---|
| `_req` | `Request` |
| `ctx` | `{ params: Promise<{ slugId: string }> }` |

<!-- source: function-getavailablelayouts.md -->

# getAvailableLayouts

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/layouts/registry.ts` (line 50)

List available layout keys for a section type.

## Signature

```ts
function getAvailableLayouts(sectionType: string): string[]
```

## Parameters

| Name | Type |
|---|---|
| `sectionType` | `string` |

**Returns:** `string[]`

<!-- source: interface-graphdata.md -->

# GraphData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Graph/types.ts` (line 78)

Graph data structure

## Properties

| Property | Type |
|---|---|
| `entities` | `KGEntity[]` |
| `relationships` | `KGRelationship[]` |
| `statistics` | `GraphStatistics` |

<!-- source: type-jobstatus-5.md -->

# JobStatus

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 28)

## Definition

```ts
| 'pending'
  | 'running'
  | 'paused'
  | 'awaiting_approval'
  | 'completed'
  | 'failed'
```

<!-- source: interface-queuemetrics.md -->

# QueueMetrics

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/config.interface.ts` (line 348)

Queue metrics

## Properties

| Property | Type |
|---|---|
| `waiting` | `number` |
| `active` | `number` |
| `completed` | `number` |
| `failed` | `number` |
| `delayed` | `number` |
| `paused` | `number` |
| `total` | `number` |

<!-- source: constant-roles-key.md -->

# ROLES_KEY

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/auth/decorators/roles.decorator.ts` (line 5)

<!-- source: controller-screenshotcontroller-2.md -->

# ScreenshotController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/screenshot/screenshot.controller.ts` (line 19)

## Relationships

- MODULE_DECLARES → `captureScreenshot`
- MODULE_DECLARES → `bulkCaptureScreenshots`
- MODULE_DECLARES → `listScreenshots`
- MODULE_DECLARES → `listJobs`
- MODULE_DECLARES → `getJob`
- MODULE_DECLARES → `getScreenshot`
- MODULE_DECLARES → `deleteScreenshot`
- DEPENDS_ON → `screenshotservice`

<!-- source: class-sessioneventbridge.md -->

# SessionEventBridge

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/protocol/session-event-bridge.ts` (line 49)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `addTransport` | `addTransport(transport: AgentTransport)` | `void` |
| `on` | `on(type: T, handler: AgentProtocolEventHandler<T>)` | `void` |
| `dispose` | `dispose()` | `void` |

<!-- source: function-slugify.md -->

# slugify

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/document/services/draft-document.service.ts` (line 24)

Slugify a title into a URL-safe slug (shared with the recorder draft path).

## Signature

```ts
function slugify(text: string, fallback): string
```

## Parameters

| Name | Type |
|---|---|
| `text` | `string` |
| `fallback` | `any` |

**Returns:** `string`

<!-- source: interface-socialprooftrustbadgesprops.md -->

# SocialProofTrustBadgesProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/social-proof/social-proof-trust-badges.tsx` (line 26)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `badges` | `TrustBadge[]` |

<!-- source: module-workflowmodule.md -->

# WorkflowModule

**Kind:** Module

**Source:** `atloria-monorepo/apps/api/src/workflow/workflow.module.ts` (line 14)

## Relationships

- MODULE_IMPORTS → `configmodule`
- MODULE_IMPORTS → `graphmodule`
- MODULE_IMPORTS → `aimodule`
- MODULE_PROVIDES → `workflowdiscoveryservice`
- MODULE_PROVIDES → `workflowstorageservice`
- MODULE_EXPORTS → `workflowdiscoveryservice`
- MODULE_EXPORTS → `workflowstorageservice`

<!-- source: interface-basenode.md -->

# BaseNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 9)

Types for Multi-Audience Directive Parsing and Rendering
Based on DIRECTIVE_SYNTAX_SPECIFICATION.md v1.0

## Properties

| Property | Type |
|---|---|
| `type` | `string` |
| `startLine` | `number` |
| `endLine` | `number` |
| `startOffset` | `number` |
| `endOffset` | `number` |

<!-- source: component-catchall-2.md -->

# CatchAll

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/directives.tsx` (line 121)

## Diagram

```mermaid
graph TD
    component_CatchAll_74b1beaf["CatchAll"]
    class component_CatchAll_74b1beaf rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: constant-codeblockplugin.md -->

# codeBlockPlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/index.ts` (line 107)

A plugin that adds support for code blocks and custom code block editors.

<!-- source: component-copilottabbody.md -->

# CopilotTabBody

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/DeskCopilot.tsx` (line 106)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `thread` | `DeskThreadDetail` | ✓ | - |
| `cache` | `CopilotCache` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CopilotTabBody_423c9aa8["CopilotTabBody"]
    class component_CopilotTabBody_423c9aa8 rootComponent
```

## Relationships

- RENDERS → `ArrowLeftIcon`
- RENDERS → `AnswerSkeleton`
- RENDERS → `ReactMarkdown`
- RENDERS → `ArrowUturnLeftIcon`
- RENDERS → `PaperAirplaneIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useReducer`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

## Referenced By

- `DeskCopilot` (RENDERS)

<!-- source: interface-crawledpage.md -->

# CrawledPage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/web-crawler.service.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `title` | `string` |
| `content` | `string` |
| `html` | `string` |
| `textLength` | `number` |
| `crawledAt` | `Date` |

<!-- source: api-endpoint-create-11.md -->

# create

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/suggestion/suggestion.controller.ts` (line 15)

## Endpoint

`POST /documents/:documentId/suggestions`

| Parameter | In | Type | Required |
|---|---|---|---|
| `documentId` | query | `string` | ✓ |

## Referenced By

- `SuggestionController` (MODULE_DECLARES)

<!-- source: function-createreadfiletool.md -->

# createReadFileTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/read-file.tool.ts` (line 36)

## Signature

```ts
function createReadFileTool(options: ReadFileOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `ReadFileOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-createv2pipeline.md -->

# createV2Pipeline

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/orchestrator.ts` (line 4656)

Create a V2 pipeline orchestrator with default configuration

## Signature

```ts
function createV2Pipeline(config: V2PipelineConfig): V2PipelineOrchestrator
```

## Parameters

| Name | Type |
|---|---|
| `config` | `V2PipelineConfig` |

**Returns:** `V2PipelineOrchestrator`

<!-- source: interface-crontoolsoptions.md -->

# CronToolsOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/cron.tool.ts` (line 119)

## Properties

| Property | Type |
|---|---|
| `scheduler` | `CronScheduler` |

<!-- source: class-deskduplicatedto.md -->

# DeskDuplicateDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/issues/dto/desk.dto.ts` (line 66)

## Properties

| Property | Type |
|---|---|
| `intoTicketNumber` | `number` |

<!-- source: interface-discoveredworkflow.md -->

# DiscoveredWorkflow

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 137)

Discovered Workflow - Output from LLM analysis

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `domain` | `string` |
| `confidence` | `number` |
| `stages` | `WorkflowStage[]` |
| `transitions` | `WorkflowTransition[]` |

<!-- source: service-embeddingsservice.md -->

# EmbeddingsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/rag/embeddings.service.ts` (line 10)

Azure OpenAI text embeddings for the technical-docs RAG. Uses the `text-embedding-3-large`
deployment (3072-dim, regional → data stays in-region). Batches inputs per request and retries
transient failures so indexing tens of thousands of entities is resilient.

`EmbeddingsService` generates Azure OpenAI text embeddings for the technical-docs RAG pipeline, using the `text-embedding-3-large` deployment (3072 dimensions) to keep data in-region. It batches inputs to reduce request overhead and implements retries for transient failures, making large-scale indexing (tens of thousands of entities) resilient. This service is typically used during ingestion/indexing and any workflow that needs deterministic vector representations for search and retrieval.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `embedOne` | `embedOne(text: string, usage: { tokens: number })` | `Promise<number[]>` |
| `embed` | `embed(texts: string[], batchSize: unknown, usage: { tokens: number })` | `Promise<number[][]>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant Indexer as RAG Indexer/Ingester
  participant Embeddings as EmbeddingsService
  participant Azure as Azure OpenAI (text-embedding-3-large)
  participant Store as Vector Store/Index

  Indexer->>Embeddings: embedTexts(texts[])
  note over Embeddings: Split into batches\n(avoid max input limits)
  loop For each batch
    Embeddings->>Azure: createEmbeddings(batch)
    alt transient failure (429/5xx/network)
      Embeddings->>Azure: retry with backoff
    end
    Azure-->>Embeddings: embeddings[]
  end
  Embeddings-->>Indexer: embeddings aligned to inputs
  Indexer->>Store: upsert(vectors + metadata)
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { EmbeddingsService } from './embeddings.service';

@Injectable()
export class DocsIndexer {
  constructor(private readonly embeddings: EmbeddingsService) {}

  async indexEntities(entities: Array<{ id: string; title: string; body: string }>) {
    const texts = entities.map(e => `${e.title}\n\n${e.body}`);

    // Produces 3072-dim vectors (text-embedding-3-large)
    const vectors = await this.embeddings.embedTexts(texts);

    // Example: align embeddings back to entities for vector-store upsert
    const records = entities.map((e, i) => ({
      id: e.id,
      vector: vectors[i],
      metadata: { title: e.title },
    }));

    // upsertRecords(records) // your vector store integration
    return records;
  }
}
```

## AI Coding Instructions

- Keep embeddings aligned with input order: batch splitting must preserve stable indexing so `vectors[i]` maps to `texts[i]`.
- Follow the existing batching strategy (size and token/length constraints) to avoid Azure OpenAI input limits and reduce request overhead.
- Retain and extend the retry policy only for transient errors (e.g., 429, 5xx, network timeouts); avoid retrying deterministic validation errors.
- Integration point: this service should be called from ingestion/indexing paths; store the resulting vectors with the same entity IDs/metadata used by the retriever.
- Treat all content as region-bound: do not add logging or telemetry that leaks raw text outside the intended region or persistence boundaries.

## Relationships

- DEPENDS_ON → `configservice`

<!-- source: function-extractdefaultvalue-2.md -->

# extractDefaultValue

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 403)

Extract default value as a string representation

## Signature

```ts
function extractDefaultValue(node: t.Node): string
```

## Parameters

| Name | Type |
|---|---|
| `node` | `t.Node` |

**Returns:** `string`

<!-- source: function-getallpendingupdates.md -->

# getAllPendingUpdates

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useOfflineSync.ts` (line 338)

Get all pending updates across all documents
Useful for showing a global offline indicator

## Signature

```ts
function getAllPendingUpdates(): Map<string, PendingUpdate[]>
```

**Returns:** `Map<string, PendingUpdate[]>`

<!-- source: function-getlayout.md -->

# getLayout

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/layouts/registry.ts` (line 36)

Get a layout renderer. Falls back to the first registered
layout (the default) if the key is not found.

## Signature

```ts
function getLayout(sectionType: string, layoutKey: string): SectionRenderer | undefined
```

## Parameters

| Name | Type |
|---|---|
| `sectionType` | `string` |
| `layoutKey` | `string` |

**Returns:** `SectionRenderer | undefined`

<!-- source: class-gettingstartedgenerator.md -->

# GettingStartedGenerator

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-14-meta/generators/getting-started.generator.ts` (line 30)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate(input: MetaDocumentationInput, templates: FixedDocTemplate[], reference: MetaCategoryReference)` | `Promise<{
    documents: GeneratedDocument[];
    promptTokens: number;
    completionTokens: number;
  }>` |

<!-- source: interface-graphstatistics.md -->

# GraphStatistics

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Graph/types.ts` (line 68)

Graph statistics

## Properties

| Property | Type |
|---|---|
| `totalEntities` | `number` |
| `totalRelationships` | `number` |
| `entityTypeBreakdown` | `Record<string, number>` |
| `relationshipTypeBreakdown` | `Record<string, number>` |

<!-- source: type-jsxproperties.md -->

# JsxProperties

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/index.ts` (line 127)

## Definition

```ts
Record<string, string | ExpressionValue>
```

<!-- source: interface-rabbitmqconfig.md -->

# RabbitMQConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/config.interface.ts` (line 117)

RabbitMQ configuration

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `parseQueue` | `string` |
| `deadLetterQueue` | `string` |
| `prefetchCount` | `number` |

<!-- source: controller-searchcontroller.md -->

# SearchController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/documentation/search.controller.ts` (line 19)

Search Controller

Provides search endpoints for documentation using Azure AI Search.
Includes:
- Full-text search with filtering
- Autocomplete suggestions
- Faceted search results
- Organization + project isolation

**Graceful Degradation**: When AZURE_SEARCH_ENABLED=false, returns disabled status.

`SearchController` exposes HTTP endpoints for searching the documentation corpus via Azure AI Search. It handles full-text queries with filters, autocomplete suggestions, and faceted results, while enforcing organization/project isolation boundaries. When `AZURE_SEARCH_ENABLED=false`, it gracefully degrades by returning a disabled status instead of attempting search operations.

## Diagram

```mermaid
graph LR
  Client[API Client] -->|HTTP| SC[SearchController]
  SC -->|checks| Flag[AZURE_SEARCH_ENABLED]
  Flag -->|false| Disabled[Return: search disabled status]
  Flag -->|true| Azure[Azure AI Search]
  SC -->|Full-text search + filters| Azure
  SC -->|Autocomplete suggestions| Azure
  SC -->|Facets| Azure
  SC -->|enforce isolation| Scope[Org + Project Scope]
  Scope --> SC
  Azure --> Results[Search / Suggest / Facet Results]
  Results --> Client
```

## Usage

```ts
// Example client-side usage calling the SearchController endpoints.
// (Endpoint paths may vary based on your NestJS routing configuration.)

type SearchResponse = {
  enabled: boolean;
  results?: Array<{ id: string; title: string; snippet?: string; url?: string }>;
  facets?: Record<string, Array<{ value: string; count: number }>>;
  message?: string;
};

type SuggestResponse = {
  enabled: boolean;
  suggestions?: string[];
  message?: string;
};

const API_BASE = process.env.API_BASE ?? "http://localhost:3000";

async function searchDocs(params: {
  orgId: string;
  projectId: string;
  q: string;
  filters?: Record<string, string | string[]>;
  facets?: string[];
  top?: number;
}): Promise<SearchResponse> {
  const url = new URL(`${API_BASE}/documentation/search`);
  url.searchParams.set("orgId", params.orgId);
  url.searchParams.set("projectId", params.projectId);
  url.searchParams.set("q", params.q);
  if (params.top) url.searchParams.set("top", String(params.top));
  if (params.facets?.length) url.searchParams.set("facets", params.facets.join(","));
  if (params.filters) url.searchParams.set("filters", JSON.stringify(params.filters));

  const res = await fetch(url.toString(), { method: "GET" });
  return res.json();
}

async function suggestDocs(params: {
  orgId: string;
  projectId: string;
  prefix: string;
  top?: number;
}): Promise<SuggestResponse> {
  const url = new URL(`${API_BASE}/documentation/search/suggest`);
  url.searchParams.set("orgId", params.orgId);
  url.searchParams.set("projectId", params.projectId);
  url.searchParams.set("prefix", params.prefix);
  if (params.top) url.searchParams.set("top", String(params.top));

  const res = await fetch(url.toString(), { method: "GET" });
  return res.json();
}

(async () => {
  const search = await searchDocs({
    orgId: "org_123",
    projectId: "proj_abc",
    q: "authentication",
    filters: { type: ["guide", "api"], visibility: "public" },
    facets: ["type", "tags"],
    top: 10,
  });

  if (!search.enabled) {
    console.warn("Search is disabled:", search.message);
    return;
  }

  console.log("Results:", search.results);
  console.log("Facets:", search.facets);

  const suggest = await suggestDocs({
    orgId: "org_123",
    projectId: "proj_abc",
    prefix: "auth",
    top: 5,
  });

  console.log("Suggestions:", suggest.suggestions);
})();
```

## AI Coding Instructions

- Preserve **graceful degradation**: always gate Azure calls behind `AZURE_SEARCH_ENABLED`, and return a consistent “disabled” payload when off.
- Enforce **organization + project isolation** on every endpoint (never allow cross-scope querying, even if the client passes broader filters).
- Keep request parameters **validated and normalized** (e.g., parsing JSON `filters`, limiting `top`, sanitizing facet fields) to prevent malformed queries and expensive searches.
- Maintain a stable **response shape** across search/suggest/facet endpoints so clients can handle “enabled vs disabled” without special-casing.
- When adding new filters/facets, update both the controller contract and the Azure index/query mapping together to avoid silent mismatches.

## Relationships

- MODULE_DECLARES → `search`
- MODULE_DECLARES → `getSuggestions`
- MODULE_DECLARES → `getHealth`
- DEPENDS_ON → `azuresearchservice`
- DEPENDS_ON → `configservice`

<!-- source: constant-securityincidenttemplate.md -->

# securityIncidentTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/security-incident.template.ts` (line 3)

<!-- source: class-sessionjournal.md -->

# SessionJournal

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/session-journal.ts` (line 53)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `add` | `add(turn: number, type: JournalEntryType, content: string)` | `JournalEntry` |
| `read` | `read()` | `string` |
| `format` | `format()` | `string` |
| `cleanup` | `cleanup()` | `void` |
| `getGoal` | `getGoal()` | `string` |
| `count` | `count()` | `number` |
| `getAll` | `getAll()` | `readonly JournalEntry[]` |
| `getFilePath` | `getFilePath()` | `string` |

<!-- source: function-stabilizeparseoutput.md -->

# stabilizeParseOutput

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/stabilize-parse-output.ts` (line 24)

## Signature

```ts
function stabilizeParseOutput(entities: Entity[], relationships: Relationship[], rootDir: string): { entities: Entity[]; relationships: Relationship[] }
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `Entity[]` |
| `relationships` | `Relationship[]` |
| `rootDir` | `string` |

**Returns:** `{ entities: Entity[]; relationships: Relationship[] }`

<!-- source: interface-statcardprops.md -->

# StatCardProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/stat-card.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `valueKey` | `string` |
| `labelKey` | `string` |
| `className` | `string` |

<!-- source: interface-batchauthconfig.md -->

# BatchAuthConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 110)

Authentication configuration for batch

## Properties

| Property | Type |
|---|---|
| `loginUrl` | `string` |
| `username` | `string` |
| `password` | `string` |
| `usernameSelector` | `string` |
| `passwordSelector` | `string` |
| `submitSelector` | `string` |
| `successSelector` | `string` |
| `useSmartDetection` | `boolean` |
| `healthCheck` | `SessionHealthCheck` |

<!-- source: component-catchallplugin.md -->

# CatchAllPlugin

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/error-handling.tsx` (line 96)

## Diagram

```mermaid
graph TD
    component_CatchAllPlugin_4a4b9148["CatchAllPlugin"]
    class component_CatchAllPlugin_4a4b9148 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `ConditionalContents`
- RENDERS → `ChangeCodeMirrorLanguage`
- RENDERS → `ShowSandpackInfo`
- RENDERS → `UndoRedo`
- RENDERS → `BoldItalicUnderlineToggles`

<!-- source: constant-codeblockvisitor.md -->

# CodeBlockVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/CodeBlockVisitor.ts` (line 5)

## Definition

```ts
LexicalExportVisitor<CodeBlockNode, Mdast.Code>
```

<!-- source: component-copybutton-2.md -->

# CopyButton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/[ticketId]/page.tsx` (line 238)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `text` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CopyButton_2b361512["CopyButton"]
    class component_CopyButton_2b361512 rootComponent
```

## Relationships

- RENDERS → `AnimatePresence`
- RENDERS → `motion-div`
- RENDERS → `ClipboardDocumentCheckIcon`
- RENDERS → `ClipboardDocumentIcon`
- USES_HOOK → `useState`

## Referenced By

- `IssueDetailPageInner` (RENDERS)

<!-- source: api-endpoint-create-12.md -->

# create

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/template/template.controller.ts` (line 86)

Create a new template.
Only admins and maintainers can create templates.

## Endpoint

`POST /templates`

## Referenced By

- `TemplateController` (MODULE_DECLARES)

<!-- source: interface-createdraftdocumentparams.md -->

# CreateDraftDocumentParams

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/services/draft-document.service.ts` (line 36)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `organizationId` | `string` |
| `userId` | `string` |
| `title` | `string` |
| `markdown` | `string` |
| `source` | `DocumentSource` |
| `type` | `DocumentType` |
| `metadata` | `Record<string, unknown>` |
| `audienceSlug` | `string` |
| `slugFallback` | `string` |

<!-- source: function-createrehydrationhook.md -->

# createRehydrationHook

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/context/rehydration.ts` (line 30)

Create a PostCompactionHook that reads files from disk.
This is the "hard rehydration" implementation — actually reads files
rather than nudging the agent to re-read them.

## Signature

```ts
function createRehydrationHook(config: RehydrationConfig): PostCompactionHook
```

## Parameters

| Name | Type |
|---|---|
| `config` | `RehydrationConfig` |

**Returns:** `PostCompactionHook`

<!-- source: function-createvalidresult.md -->

# createValidResult

**Kind:** Function

**Source:** `atloria-monorepo/packages/core/src/validators/validation-result.ts` (line 12)

Create a successful validation result

## Signature

```ts
function createValidResult(): ValidationResult
```

**Returns:** `ValidationResult`

<!-- source: interface-definition.md -->

# Definition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/repo-map.ts` (line 35)

## Properties

| Property | Type |
|---|---|
| `file` | `string` |
| `line` | `number` |
| `kind` | `string` |
| `name` | `string` |
| `exported` | `boolean` |

<!-- source: class-deskreplydto.md -->

# DeskReplyDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/issues/dto/desk.dto.ts` (line 49)

## Properties

| Property | Type |
|---|---|
| `body` | `string` |
| `internal` | `boolean` |
| `andDone` | `boolean` |

<!-- source: interface-docscorpus.md -->

# DocsCorpus

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/mcp-toolset.ts` (line 13)

## Properties

| Property | Type |
|---|---|
| `projectName` | `string` |
| `pages` | `LlmsPage[]` |
| `entities` | `Entity[]` |
| `relationships` | `Relationship[]` |

<!-- source: service-entityextractorservice.md -->

# EntityExtractorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/graph/services/entity-extractor.service.ts` (line 12)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `extractFromDocument` | `extractFromDocument(documentId: string)` | `Promise<KGEntity[]>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `aiservice`

<!-- source: function-extractexportednamesfromdeclaration-2.md -->

# extractExportedNamesFromDeclaration

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 540)

Extract exported names from export declarations

## Signature

```ts
function extractExportedNamesFromDeclaration(path: NodePath<t.ExportNamedDeclaration | t.ExportDefaultDeclaration>): Set<string>
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath<t.ExportNamedDeclaration | t.ExportDefaultDeclaration>` |

**Returns:** `Set<string>`

<!-- source: function-getalltypeslabel.md -->

# getAllTypesLabel

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/PublishingSidebar/pageTypeLabels.ts` (line 49)

Localized label for the "All" filter chip.

## Signature

```ts
function getAllTypesLabel(lang: string | null): string
```

## Parameters

| Name | Type |
|---|---|
| `lang` | `string | null` |

**Returns:** `string`

<!-- source: function-getvariantstyles.md -->

# getVariantStyles

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/agents/variant.agent.ts` (line 63)

Get the variant styles metadata.

## Signature

```ts
function getVariantStyles(): VariantStyle[]
```

**Returns:** `VariantStyle[]`

<!-- source: interface-horizontalbarchartprops.md -->

# HorizontalBarChartProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/HorizontalBarChart.tsx` (line 16)

## Properties

| Property | Type |
|---|---|
| `items` | `HorizontalBarItem[]` |
| `maxItems` | `number` |
| `loading` | `boolean` |
| `emptyMessage` | `string` |

<!-- source: class-interactionmapbuilder.md -->

# InteractionMapBuilder

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/services/interaction-map-builder.ts` (line 39)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `buildFromRepo` | `buildFromRepo(routeMappings: RouteMappingResult, repoPath: string, framework: FrameworkType)` | `InteractionMap` |
| `build` | `build(routeMappings: RouteMappingResult, files: Map<string, string>, framework: FrameworkType)` | `InteractionMap` |

<!-- source: type-language.md -->

# Language

**Kind:** Type

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/CodeSample.ts` (line 8)

## Definition

```ts
'curl' | 'javascript' | 'python' | 'go' | 'java'
```

<!-- source: interface-ratelimitinfo.md -->

# RateLimitInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 584)

Rate limit configuration

## Properties

| Property | Type |
|---|---|
| `requests` | `number` |
| `period` | `string` |
| `scope` | `'user' | 'ip' | 'global'` |

<!-- source: class-sessionmanager.md -->

# SessionManager

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/session/session-manager.ts` (line 45)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createId` | `createId()` | `string` |
| `save` | `save(id: string, ctx: SessionSaveContext)` | `string` |
| `resume` | `resume(id: string)` | `ResumedSession | undefined` |
| `list` | `list()` | `SessionMeta[]` |
| `delete` | `delete(id: string)` | `boolean` |
| `latest` | `latest()` | `SessionMeta | undefined` |
| `getMeta` | `getMeta(id: string)` | `SessionMeta | undefined` |
| `loadSnapshot` | `loadSnapshot(id: string)` | `SessionSnapshot | undefined` |

<!-- source: constant-soptemplate.md -->

# sopTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/sop.template.ts` (line 3)

<!-- source: interface-stepindicatorprops.md -->

# StepIndicatorProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/step-indicator.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `step` | `number` |
| `icon` | `LucideIcon` |
| `titleKey` | `string` |
| `descriptionKey` | `string` |

<!-- source: function-stripmarkdown.md -->

# stripMarkdown

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/search-index.ts` (line 94)

Strip markdown/HTML to readable plain text (cheap, no deps).

## Signature

```ts
function stripMarkdown(md: string): string
```

## Parameters

| Name | Type |
|---|---|
| `md` | `string` |

**Returns:** `string`

<!-- source: controller-suggestioncontroller.md -->

# SuggestionController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/suggestion/suggestion.controller.ts` (line 10)

## Relationships

- MODULE_DECLARES → `create`
- MODULE_DECLARES → `list`
- MODULE_DECLARES → `accept`
- MODULE_DECLARES → `reject`
- MODULE_DECLARES → `delete`
- MODULE_DECLARES → `getById`
- DEPENDS_ON → `suggestionservice`

<!-- source: interface-batchconfig.md -->

# BatchConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/batched-screenshot-processor.ts` (line 30)

## Properties

| Property | Type |
|---|---|
| `batchSize` | `number` |
| `prisma` | `any` |
| `projectId` | `string` |
| `isCancelled` | `() => boolean` |
| `onBatchComplete` | `(result: BatchResult) => void | Promise<void>` |
| `maxBatchRetries` | `number` |
| `retryDelayMs` | `number` |

<!-- source: component-changeadmonitiontype.md -->

# ChangeAdmonitionType

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/ChangeAdmonitionType.tsx` (line 23)

## Diagram

```mermaid
graph TD
    component_ChangeAdmonitionType_2d8b33b1["ChangeAdmonitionType"]
    class component_ChangeAdmonitionType_2d8b33b1 rootComponent
```

## Relationships

- RENDERS → `Select`
- USES_HOOK → `useCellValues`
- USES_HOOK → `useTranslation`

<!-- source: constant-comment.md -->

# comment

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/mdastUtilHtmlComment.ts` (line 192)

## Definition

```ts
Extension
```

<!-- source: component-copyicon.md -->

# CopyIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/CodeViewer.tsx` (line 119)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_CopyIcon_15a2a7b1["CopyIcon"]
    class component_CopyIcon_15a2a7b1 rootComponent
```

## Referenced By

- `CodeViewer` (RENDERS)

<!-- source: api-endpoint-createagent.md -->

# createAgent

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.controller.ts` (line 111)

## Endpoint

`POST /support-agent/:projectId/agents`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `SupportAgentController` (MODULE_DECLARES)

<!-- source: interface-createinvitationdto.md -->

# CreateInvitationDto

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/invitation/invitation.service.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `email` | `string` |
| `role` | `UserRole` |

<!-- source: function-createrepomaptool.md -->

# createRepoMapTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/repo-map.tool.ts` (line 28)

## Signature

```ts
function createRepoMapTool(options: RepoMapToolOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `RepoMapToolOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-curry1to0.md -->

# curry1to0

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/fp.ts` (line 29)

Takes a 1 argument function and returns a function which when called, executes it with the provided argument.

## Signature

```ts
function curry1to0(proc: (arg: T) => R, arg: T): () => R
```

## Parameters

| Name | Type |
|---|---|
| `proc` | `(arg: T) => R` |
| `arg` | `T` |

**Returns:** `() => R`

<!-- source: class-desktransitiondto.md -->

# DeskTransitionDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/issues/dto/desk.dto.ts` (line 39)

## Properties

| Property | Type |
|---|---|
| `action` | `DeskTransition` |
| `snoozedUntil` | `string` |

<!-- source: interface-diffhunk.md -->

# DiffHunk

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/edit-file.tool.ts` (line 555)

## Properties

| Property | Type |
|---|---|
| `oldStart` | `number` |
| `oldCount` | `number` |
| `oldLines` | `string[]` |
| `newLines` | `string[]` |

<!-- source: interface-docsearchhit.md -->

# DocSearchHit

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/mcp-toolset.ts` (line 20)

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `path` | `string` |
| `snippet` | `string` |
| `score` | `number` |

<!-- source: service-eventsservice.md -->

# EventsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/events/events.service.ts` (line 24)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `record` | `record(input: {
    type: string;
    projectId?: string | null;
    organizationId?: string | null;
    sessionId?: string | null;
    userId?: string | null;
    payload?: Record<string, unknown> | null;
  })` | `Promise<{ id: string }>` |
| `recordSafe` | `recordSafe(input: Parameters<EventsService['record']>[0])` | `void` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: function-extractforms.md -->

# extractForms

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/form-validation-extractor.ts` (line 98)

Combined entry point — merges code + template, enriching template fields with code-level rules.

## Signature

```ts
function extractForms(code: string, templateContent: string | undefined, filePath: string, componentName: string, framework: Framework): FormDefinition[]
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |
| `templateContent` | `string | undefined` |
| `filePath` | `string` |
| `componentName` | `string` |
| `framework` | `Framework` |

**Returns:** `FormDefinition[]`

<!-- source: function-getaudiencelabel.md -->

# getAudienceLabel

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/uiStrings.ts` (line 586)

## Signature

```ts
function getAudienceLabel(slug: string, lang: string | null): string
```

## Parameters

| Name | Type |
|---|---|
| `slug` | `string` |
| `lang` | `string | null` |

**Returns:** `string`

<!-- source: interface-horizontalbaritem.md -->

# HorizontalBarItem

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/HorizontalBarChart.tsx` (line 5)

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `value` | `number` |
| `meta` | `string` |
| `onClick` | `() => void` |

<!-- source: class-interceptormanager.md -->

# InterceptorManager

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/utils/interceptors.ts` (line 12)

Manager for request/response interceptors

## Methods

| Method | Signature | Returns |
|---|---|---|
| `addRequestInterceptor` | `addRequestInterceptor(interceptor: RequestInterceptor)` | `() => void` |
| `addResponseInterceptor` | `addResponseInterceptor(interceptor: ResponseInterceptor)` | `() => void` |
| `addErrorInterceptor` | `addErrorInterceptor(interceptor: ErrorInterceptor)` | `() => void` |
| `executeRequestInterceptors` | `executeRequestInterceptors(config: RequestConfig)` | `Promise<RequestConfig>` |
| `executeResponseInterceptors` | `executeResponseInterceptors(response: APIResponse<T>)` | `Promise<APIResponse<T>>` |
| `executeErrorInterceptors` | `executeErrorInterceptors(error: Error)` | `Promise<Error>` |
| `clear` | `clear()` | `void` |

<!-- source: type-lexicalvisitor.md -->

# LexicalVisitor

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/exportMarkdownFromLexical.ts` (line 96)

A generic visitor that can be used to process any lexical node.

## Definition

```ts
LexicalExportVisitor<LexicalNode, Mdast.RootContent>
```

<!-- source: interface-redisconfig.md -->

# RedisConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/config.interface.ts` (line 85)

Redis configuration

## Properties

| Property | Type |
|---|---|
| `host` | `string` |
| `port` | `number` |
| `password` | `string` |
| `db` | `number` |
| `keyPrefix` | `string` |

<!-- source: function-registerlayout.md -->

# registerLayout

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/layouts/registry.ts` (line 21)

Register a layout renderer for a section type.

## Signature

```ts
function registerLayout(sectionType: string, layoutKey: string, renderer: SectionRenderer): void
```

## Parameters

| Name | Type |
|---|---|
| `sectionType` | `string` |
| `layoutKey` | `string` |
| `renderer` | `SectionRenderer` |

**Returns:** `void`

<!-- source: class-sessionstore.md -->

# SessionStore

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/session/session-store.ts` (line 69)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `save` | `save(snapshot: SessionSnapshot)` | `void` |
| `load` | `load(id: string)` | `SessionSnapshot | undefined` |
| `list` | `list()` | `SessionMeta[]` |
| `delete` | `delete(id: string)` | `boolean` |
| `latest` | `latest()` | `SessionMeta | undefined` |
| `getMeta` | `getMeta(id: string)` | `SessionMeta | undefined` |

<!-- source: constant-sprintplanningtemplate.md -->

# sprintPlanningTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/sprint-planning.template.ts` (line 3)

<!-- source: controller-supportagentcontroller.md -->

# SupportAgentController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.controller.ts` (line 30)

## Relationships

- MODULE_DECLARES → `getConfig`
- MODULE_DECLARES → `upsertConfig`
- MODULE_DECLARES → `search`
- MODULE_DECLARES → `listAgents`
- MODULE_DECLARES → `createAgent`
- MODULE_DECLARES → `getAgent`
- MODULE_DECLARES → `updateAgent`
- MODULE_DECLARES → `deleteAgent`
- MODULE_DECLARES → `chat`
- MODULE_DECLARES → `getChatHistory`
- MODULE_DECLARES → `clearChatHistory`
- MODULE_DECLARES → `chatStream`
- DEPENDS_ON → `supportagentservice`

<!-- source: function-terms.md -->

# terms

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/manuals-insights/manuals-insights.service.ts` (line 29)

Lowercase → alphanumeric words of length >= 3, minus stopwords.

## Signature

```ts
function terms(s: string | null | undefined): string[]
```

## Parameters

| Name | Type |
|---|---|
| `s` | `string | null | undefined` |

**Returns:** `string[]`

<!-- source: interface-testimonialcardprops.md -->

# TestimonialCardProps

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/_shared/testimonial-card.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `quoteKey` | `string` |
| `authorNameKey` | `string` |
| `authorRoleKey` | `string` |
| `avatarSrc` | `string` |
| `rating` | `number` |

<!-- source: interface-batchconfig-2.md -->

# BatchConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 125)

Batch-level configuration

## Properties

| Property | Type |
|---|---|
| `maxConcurrency` | `number` |
| `browser` | `'chromium' | 'firefox' | 'webkit'` |
| `maxRetries` | `number` |
| `retryDelayMs` | `number` |
| `screenshotTimeout` | `number` |
| `defaultViewport` | `Viewport` |
| `format` | `'png' | 'jpeg' | 'webp'` |
| `quality` | `number` |
| `checkDuplicates` | `boolean` |

<!-- source: component-changecodemirrorlanguage.md -->

# ChangeCodeMirrorLanguage

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/ChangeCodeMirrorLanguage.tsx` (line 16)

## Diagram

```mermaid
graph TD
    component_ChangeCodeMirrorLanguage_3b50f35d["ChangeCodeMirrorLanguage"]
    class component_ChangeCodeMirrorLanguage_3b50f35d rootComponent
```

## Relationships

- RENDERS → `Select`
- USES_HOOK → `useCellValues`
- USES_HOOK → `useTranslation`

<!-- source: constant-common-state-config-extensions.md -->

# COMMON_STATE_CONFIG_EXTENSIONS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/codemirror/CodeMirrorEditor.tsx` (line 19)

## Definition

```ts
Extension[]
```

<!-- source: component-counter.md -->

# Counter

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/page.tsx` (line 57)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `to` | `number` | ✓ | - |
| `suffix` | `string` | ✓ | - |
| `display` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_Counter_81da20e["Counter"]
    class component_Counter_81da20e rootComponent
```

## Relationships

- USES_HOOK → `useRef`
- USES_HOOK → `useInView`
- USES_HOOK → `useEffect`

## Referenced By

- `HomePage` (RENDERS)

<!-- source: api-endpoint-createconfig.md -->

# createConfig

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 47)

## Endpoint

`POST /doc-automation/config`

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: interface-createnotificationdto.md -->

# CreateNotificationDto

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/notification/notification.service.ts` (line 5)

## Properties

| Property | Type |
|---|---|
| `userId` | `string` |
| `type` | `'MENTION' | 'COMMENT' | 'SUGGESTION' | 'DOCUMENT_SHARED' | 'REVIEW_REQUEST' | 'SYSTEM'` |
| `title` | `string` |
| `message` | `string` |
| `entityType` | `string` |
| `entityId` | `string` |
| `metadata` | `Record<string, any>` |

<!-- source: function-createrollbacktool.md -->

# createRollbackTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/rollback.tool.ts` (line 16)

## Signature

```ts
function createRollbackTool(options: RollbackToolOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `RollbackToolOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: function-curry2to1.md -->

# curry2to1

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/fp.ts` (line 21)

Takes a 2 argument function and partially applies the first argument.

## Signature

```ts
function curry2to1(proc: (arg1: T, arg2: K) => R, arg1: T): (arg2: K) => R
```

## Parameters

| Name | Type |
|---|---|
| `proc` | `(arg1: T, arg2: K) => R` |
| `arg1` | `T` |

**Returns:** `(arg2: K) => R`

<!-- source: interface-discoveredinstruction.md -->

# DiscoveredInstruction

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/instruction-loader.ts` (line 61)

Discovered instruction file with its directory depth

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `relativePath` | `string` |
| `depth` | `number` |
| `content` | `string` |

<!-- source: class-documentfiltersdto.md -->

# DocumentFiltersDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/document-filters.dto.ts` (line 7)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `categoryId` | `string` |
| `docVersionId` | `string` |
| `state` | `DocumentState` |
| `audience` | `string` |
| `type` | `DocumentType` |
| `search` | `string` |
| `limit` | `number` |
| `offset` | `number` |
| `sortBy` | `string` |
| `sortOrder` | `'asc' | 'desc'` |

<!-- source: interface-documentmetadata.md -->

# DocumentMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/storage.interface.ts` (line 108)

Document metadata for storage

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `type` | `'user-docs' | 'tutorial' | 'feature' | 'api' | 'state-management' | 'database' | 'component' | 'security'` |
| `categoryPath` | `string[]` |
| `content` | `string` |
| `source` | `'AI' | 'manual' | 'template'` |
| `aiModel` | `string` |
| `versionLabel` | `string` |
| `metadata` | `Record<string, unknown>` |

<!-- source: function-extractformsfromcode.md -->

# extractFormsFromCode

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/form-validation-extractor.ts` (line 66)

Extract forms from TypeScript/JavaScript code (FormGroup, Yup, RHF, Vuelidate).

## Signature

```ts
function extractFormsFromCode(code: string, filePath: string, componentName: string): FormDefinition[]
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |
| `filePath` | `string` |
| `componentName` | `string` |

**Returns:** `FormDefinition[]`

<!-- source: service-featuredetectorservice.md -->

# FeatureDetectorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/feature-detector.service.ts` (line 60)

Feature Detector Service

Automatically identifies "features" from parsed codebase

Detection strategies:
1. State Machine-based: Each state machine represents a feature workflow
2. Module-based: Group by application modules (Angular modules, React feature folders)
3. Route-based: Group by route prefix (e.g., /sales/*, /inventory/*)
4. Business Context-based: Extract from marketing/process docs

`FeatureDetectorService` automatically identifies higher-level “features” from a parsed codebase so the system can organize, document, and reason about workflows and domains. It applies multiple detection strategies—state machine workflows, module/folder boundaries, route prefixes, and business-context documentation—to produce a consolidated set of feature definitions for downstream tooling (e.g., docs, navigation, analysis).

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectFeatures` | `detectFeatures(options: {
    entities: any[]; // Parsed entities from parser-core
    appMap?: any; // Application structure map
    businessContext?: {
      marketing: string[];
      workflows: string[];
      features: string[];
    };
  })` | `Promise<DetectedFeature[]>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  actor Caller
  participant FDS as FeatureDetectorService
  participant Code as Parsed Codebase/AST
  participant SM as StateMachine Strategy
  participant Mod as Module Strategy
  participant Rt as Route Strategy
  participant Biz as Business Context Strategy
  participant Out as Feature Set

  Caller->>FDS: detectFeatures(codebase, options)
  FDS->>Code: read parsed structures (AST, routes, modules)
  FDS->>SM: detectFromStateMachines(codebase)
  SM-->>FDS: features (workflow-based)
  FDS->>Mod: detectFromModules(codebase)
  Mod-->>FDS: features (module/folder-based)
  FDS->>Rt: detectFromRoutes(codebase)
  Rt-->>FDS: features (route-prefix-based)
  FDS->>Biz: detectFromBusinessDocs(contextDocs)
  Biz-->>FDS: features (domain/context-based)
  FDS->>FDS: merge/dedupe/score + resolve conflicts
  FDS-->>Out: consolidated features
  Out-->>Caller: Feature[] (with sources/metadata)
```

## Usage

```ts
import { FeatureDetectorService } from './documentation/services/feature-detector.service';

// In NestJS you would usually inject this service; this is a simplified example.
async function runFeatureDetection() {
  const featureDetector = new FeatureDetectorService();

  // Example shape: depends on your parser output; keep it consistent with what the service expects.
  const parsedCodebase = {
    stateMachines: [
      /* ... */
    ],
    modules: [
      /* Angular modules / React feature folders ... */
    ],
    routes: [
      { method: 'GET', path: '/sales/orders' },
      { method: 'POST', path: '/inventory/items' },
    ],
    docs: {
      marketing: 'Sales workflow covers quote -> order -> invoice ...',
      process: 'Inventory receiving and stock adjustments ...',
    },
  };

  const features = await featureDetector.detectFeatures(parsedCodebase, {
    strategies: ['stateMachine', 'module', 'route', 'businessContext'],
    routePrefixDepth: 1, // e.g., "/sales/*" groups under "sales"
  });

  // Use the detected features to generate docs, navigation, or analysis outputs
  for (const f of features) {
    console.log(`[feature] ${f.name}`, {
      key: f.key,
      sources: f.sources,
      confidence: f.confidence,
    });
  }
}

runFeatureDetection().catch(console.error);
```

## AI Coding Instructions

- Preserve the “multi-strategy” pattern: each detector should be independent (pure-ish) and return features with source metadata so merging/deduping can be explained and debugged.
- When adding a new strategy, ensure it produces stable feature keys (deterministic naming) to avoid churn in generated docs and to make deduplication reliable.
- Be careful merging results: handle collisions (same name from different strategies) via scoring/priority rules and keep provenance (`sources`) for traceability.
- Integrate with parsers/ingestors at clear boundaries: this service should consume normalized parsed structures (AST/module/route/doc summaries), not raw filesystem or framework-specific internals.

<!-- source: function-getavailablecolors.md -->

# getAvailableColors

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/user-colors.ts` (line 144)

Get all available colors in the palette
Useful for documentation or debugging

## Signature

```ts
function getAvailableColors(): readonly string[]
```

**Returns:** `readonly string[]`

<!-- source: class-iterativedeeploader.md -->

# IterativeDeepLoader

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-04-analysis/iterative-deep-loader.ts` (line 39)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `executeWithDeepLoading` | `executeWithDeepLoading(initialPrompt: string, chunk: Chunk, options: {
      maxTokens?: number;
      temperature?: number;
      systemPrompt?: string;
    })` | `Promise<DeepLoaderResult>` |

<!-- source: interface-jobhistoryprops.md -->

# JobHistoryProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/DocAutomation/JobHistory.tsx` (line 27)

## Properties

| Property | Type |
|---|---|
| `jobs` | `DocumentationJobEntry[]` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `liveProgress` | `Record<string, LiveJobProgress>` |
| `projectId` | `string` |
| `onRegenerate` | `(projectId: string) => Promise<void>` |
| `onCancelJob` | `(jobId: string) => Promise<void>` |
| `onDeleteJobDocuments` | `(jobId: string) => void` |
| `onRefresh` | `() => void` |

<!-- source: type-loglevel.md -->

# LogLevel

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/logger.ts` (line 8)

Pipeline Logger

Structured logging for the documentation automation pipeline.
Supports different log levels and can output to console or external services.

## Definition

```ts
'debug' | 'info' | 'warn' | 'error'
```

<!-- source: interface-relationdefinition.md -->

# RelationDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 697)

Relation definition between models

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many'` |
| `targetModel` | `string` |
| `foreignKey` | `string` |
| `onDelete` | `'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION'` |
| `onUpdate` | `'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION'` |
| `relationTable` | `string` |

<!-- source: function-rendermockup.md -->

# renderMockup

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/mockups.ts` (line 149)

Render a mockup by type. Returns full HTML string with browser chrome.

## Signature

```ts
function renderMockup(type: MockupType): string
```

## Parameters

| Name | Type |
|---|---|
| `type` | `MockupType` |

**Returns:** `string`

<!-- source: class-setupcache.md -->

# SetupCache

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/setup-agent.ts` (line 273)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `get` | `get(repoKey: string)` | `SetupResult | null` |
| `set` | `set(repoKey: string, result: SetupResult)` | `void` |
| `buildKey` | `buildKey(repo: string, commit: string)` | `string` |
| `clear` | `clear()` | `void` |

<!-- source: constant-stripe-client.md -->

# STRIPE_CLIENT

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/billing/billing.service.ts` (line 19)

Injection token for the Stripe SDK client (mockable in tests).

<!-- source: controller-synccontroller.md -->

# SyncController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/project/sync.controller.ts` (line 27)

## Relationships

- MODULE_DECLARES → `syncDocuments`
- MODULE_DECLARES → `reindexDocuments`
- MODULE_DECLARES → `startFullSync`
- MODULE_DECLARES → `getJobStatus`
- MODULE_DECLARES → `getOrganizationJobs`
- MODULE_DECLARES → `cancelJob`
- MODULE_DECLARES → `syncEntities`
- MODULE_DECLARES → `syncRelationships`
- DEPENDS_ON → `syncservice`
- DEPENDS_ON → `documentindexingservice`
- DEPENDS_ON → `syncjobservice`
- DEPENDS_ON → `kgsyncservice`
- DEPENDS_ON → `workflowdiscoveryservice`
- DEPENDS_ON → `workflowstorageservice`
- DEPENDS_ON → `businesscontextparserservice`
- DEPENDS_ON → `prismaservice`

<!-- source: function-tokenize.md -->

# tokenize

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/search-index.ts` (line 125)

Lowercased, deduped, stopword-filtered significant tokens (capped).

## Signature

```ts
function tokenize(text: string): string[]
```

## Parameters

| Name | Type |
|---|---|
| `text` | `string` |

**Returns:** `string[]`

<!-- source: interface-trustbadge.md -->

# TrustBadge

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/component-library/sections/social-proof/social-proof-trust-badges.tsx` (line 20)

## Properties

| Property | Type |
|---|---|
| `icon` | `LucideIcon` |
| `logoSrc` | `string` |
| `nameKey` | `string` |

<!-- source: interface-batchjobresponse.md -->

# BatchJobResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 196)

Response after creating a batch job

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `status` | `JobStatus` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `name` | `string` |
| `totalUrls` | `number` |
| `capturedUrls` | `number` |
| `failedUrls` | `number` |
| `progress` | `number` |
| `createdAt` | `string` |
| `updatedAt` | `string` |
| `completedAt` | `string` |
| `error` | `string` |

<!-- source: component-changediffmarkdown.md -->

# ChangeDiffMarkdown

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/diff-source.tsx` (line 37)

## Diagram

```mermaid
graph TD
    component_ChangeDiffMarkdown_4c9652d8["ChangeDiffMarkdown"]
    class component_ChangeDiffMarkdown_4c9652d8 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `UndoRedo`
- USES_HOOK → `useRef`
- USES_HOOK → `useState`

<!-- source: constant-common-state-config-extensions-2.md -->

# COMMON_STATE_CONFIG_EXTENSIONS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/diff-source/SourceEditor.tsx` (line 11)

## Definition

```ts
Extension[]
```

<!-- source: component-countup.md -->

# CountUp

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/scenes/SceneGeneration.tsx` (line 73)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `target` | `number` | ✓ | - |
| `duration` | `number` | - | 1000 |

## Diagram

```mermaid
graph TD
    component_CountUp_3f93da91["CountUp"]
    class component_CountUp_3f93da91 rootComponent
```

## Relationships

- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

## Referenced By

- `SceneGeneration` (RENDERS)

<!-- source: api-endpoint-createconnector.md -->

# createConnector

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 252)

## Endpoint

`POST /technical-docs/:projectId/connectors`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: function-createruntime.md -->

# createRuntime

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/runtime-factory.ts` (line 34)

Create an IAgentLoop from config.
This is the recommended way to create a runtime — replaces manual
`new AzureModelProvider() + new AgentRuntime()` construction.

## Signature

```ts
function createRuntime(config: RuntimeConfig): IAgentLoop
```

## Parameters

| Name | Type |
|---|---|
| `config` | `RuntimeConfig` |

**Returns:** `IAgentLoop`

<!-- source: interface-createscheduledreportdto.md -->

# CreateScheduledReportDto

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/analytics/export/scheduled-reports.service.ts` (line 11)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `cron` | `string` |
| `timezone` | `string` |
| `format` | `ReportFormat` |
| `period` | `number` |
| `sections` | `ExportSection[]` |
| `recipientEmails` | `string[]` |

<!-- source: function-describechunkrelationships.md -->

# describeChunkRelationships

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-02-chunking/chunk-relationship-graph.ts` (line 378)

Get a description of how chunks relate for documentation

## Signature

```ts
function describeChunkRelationships(graph: ChunkRelationshipGraph, chunkId: string): string
```

## Parameters

| Name | Type |
|---|---|
| `graph` | `ChunkRelationshipGraph` |
| `chunkId` | `string` |

**Returns:** `string`

<!-- source: interface-discoveryoptions.md -->

# DiscoveryOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/instruction-loader.ts` (line 51)

## Properties

| Property | Type |
|---|---|
| `filename` | `string` |
| `maxDepth` | `number` |
| `excludeDirs` | `string[]` |

<!-- source: interface-documentsaveresult.md -->

# DocumentSaveResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/storage.interface.ts` (line 164)

Document save result

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `url` | `string` |
| `filePath` | `string` |
| `categoryId` | `string` |
| `version` | `number` |

<!-- source: class-documentskeletondto.md -->

# DocumentSkeletonDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/documentation/dto/doc-automation.dto.ts` (line 13)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `features` | `string[]` |
| `description` | `string` |

<!-- source: function-extractformsfromtemplate.md -->

# extractFormsFromTemplate

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/form-validation-extractor.ts` (line 76)

Extract forms from template HTML (inputs, DevExtreme widgets, validation attributes).

## Signature

```ts
function extractFormsFromTemplate(templateContent: string, filePath: string, componentName: string, framework: Framework): FormDefinition[]
```

## Parameters

| Name | Type |
|---|---|
| `templateContent` | `string` |
| `filePath` | `string` |
| `componentName` | `string` |
| `framework` | `Framework` |

**Returns:** `FormDefinition[]`

<!-- source: service-featuredocsgeneratorservice.md -->

# FeatureDocsGeneratorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/feature-docs-generator.service.ts` (line 35)

Feature Documentation Generator Service

Generates comprehensive feature documentation using AI
Leverages Phase 2.1 & 3 context (state machines, UI interactions)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generateFeatureDocumentation` | `generateFeatureDocumentation(feature: DetectedFeature, options: {
      generatorProvider?: 'azure-claude' | 'azure-openai';
      reviewerProvider?: 'azure-claude' | 'azure-openai';
      enableReviewer?: boolean;
      businessContext?: any;
    })` | `Promise<FeatureDocumentation>` |

## Relationships

- DEPENDS_ON → `azureclaudeprovider`
- DEPENDS_ON → `azureopenaiprovider`

<!-- source: function-getpagetypelabel.md -->

# getPageTypeLabel

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/PublishingSidebar/pageTypeLabels.ts` (line 43)

Localized display label for a document pageType.
Falls back to the raw pageType value for unknown languages/types.

## Signature

```ts
function getPageTypeLabel(pageType: string, lang: string | null): string
```

## Parameters

| Name | Type |
|---|---|
| `pageType` | `string` |
| `lang` | `string | null` |

**Returns:** `string`

<!-- source: interface-jobresult.md -->

# JobResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationGenerator.ts` (line 34)

Job completion result

## Properties

| Property | Type |
|---|---|
| `documentsCreated` | `number` |
| `documentsUpdated` | `number` |
| `screenshotsCaptured` | `number` |
| `categoriesCreated` | `number` |
| `durationMs` | `number` |
| `publishedUrl` | `string` |
| `versionId` | `string` |
| `flaggedCount` | `number` |
| `carriedCount` | `number` |

<!-- source: class-knowledgeclassifier.md -->

# KnowledgeClassifier

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/knowledge-classifier.ts` (line 98)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `classify` | `classify(doc: GeneratedDocument, meta: DocClassificationMeta)` | `KnowledgeEntry[]` |

<!-- source: type-mappingsource.md -->

# MappingSource

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/screenshot-spec.types.ts` (line 16)

Where this mapping came from

## Definition

```ts
'interaction-map' | 'site-map' | 'ai-fallback'
```

<!-- source: interface-relationship.md -->

# Relationship

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/relationship.interface.ts` (line 187)

Relationship between two entities

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `type` | `RelationshipType` |
| `sourceId` | `string` |
| `targetId` | `string` |
| `metadata` | `RelationshipMetadata` |

<!-- source: function-renderscreenshotframe.md -->

# renderScreenshotFrame

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/mockups.ts` (line 171)

Render a browser chrome frame wrapping a screenshot <img>.

## Signature

```ts
function renderScreenshotFrame(url: string, alt: string): string
```

## Parameters

| Name | Type |
|---|---|
| `url` | `string` |
| `alt` | `string` |

**Returns:** `string`

<!-- source: class-sourcetruncationprocessor.md -->

# SourceTruncationProcessor

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/history-processors.ts` (line 95)

Hard character limit per tool output observation.
Prevents any single tool from injecting massive payloads into context.

Applied first in the pipeline so downstream processors work with
bounded-size items.

**Implements:** `HistoryProcessor`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `process` | `process(items: AgentInputItem[])` | `AgentInputItem[]` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |

<!-- source: constant-system-prompt-layers.md -->

# SYSTEM_PROMPT_LAYERS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/support-agent/prompts/system-prompt-layers.ts` (line 19)

<!-- source: controller-technicaldocschatcontroller.md -->

# TechnicalDocsChatController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-chat.controller.ts` (line 19)

Conversational grounded chat (Foundation F3): sessions with memory, SSE streaming,
and 👍/👎 feedback. Access mirrors /ask (public project open, else member token);
the owning org pays the flat ask price per streamed question, and token usage is
attributed via trackUsage(skipCreditDeduction).

## Relationships

- MODULE_DECLARES → `createSession`
- MODULE_DECLARES → `stream`
- MODULE_DECLARES → `escalate`
- MODULE_DECLARES → `feedback`
- DEPENDS_ON → `techdocschatservice`
- DEPENDS_ON → `technicaldocsservice`
- DEPENDS_ON → `aiusageservice`
- DEPENDS_ON → `prismaservice`

<!-- source: function-torichtext.md -->

# toRichText

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/md-to-notion-blocks.ts` (line 34)

Tokenize one line of markdown into Notion rich-text runs (code / bold / italic / link).

## Signature

```ts
function toRichText(s: string): NotionRichText[]
```

## Parameters

| Name | Type |
|---|---|
| `s` | `string` |

**Returns:** `NotionRichText[]`

<!-- source: interface-validationresult.md -->

# ValidationResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/site-gen-core/src/assembler/validate.ts` (line 17)

## Properties

| Property | Type |
|---|---|
| `valid` | `boolean` |
| `errors` | `AssemblyError[]` |
| `warnings` | `string[]` |
| `manifest` | `Manifest` |
| `resolvedSections` | `ManifestSection[]` |

<!-- source: interface-batchresult.md -->

# BatchResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/batched-screenshot-processor.ts` (line 47)

## Properties

| Property | Type |
|---|---|
| `batchIndex` | `number` |
| `totalBatches` | `number` |
| `captured` | `number` |
| `failed` | `number` |
| `replaced` | `number` |
| `documentsUpdated` | `string[]` |

<!-- source: component-code-3.md -->

# Code

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 53)

## Diagram

```mermaid
graph TD
    component_Code_ff037["Code"]
    class component_Code_ff037 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useRef`

<!-- source: constant-composerchildren.md -->

# composerChildren$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 731)

<!-- source: api-endpoint-createcustomdomain.md -->

# createCustomDomain

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 369)

## Endpoint

`POST /projects/:id/custom-domain`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: function-createsemanticsearchtool.md -->

# createSemanticSearchTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/semantic-search.tool.ts` (line 42)

## Signature

```ts
function createSemanticSearchTool(options: SemanticSearchToolOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `SemanticSearchToolOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: interface-createversiondto.md -->

# CreateVersionDto

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/services/document-version.service.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `comment` | `string` |

<!-- source: component-csatcard.md -->

# CsatCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/issues/[ticketNumber]/page.tsx` (line 1086)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `slugId` | `string` | ✓ | - |
| `ticketNumber` | `number` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CsatCard_2c4de42["CsatCard"]
    class component_CsatCard_2c4de42 rootComponent
```

## Relationships

- USES_HOOK → `useState`

## Referenced By

- `PublicTicketPage` (RENDERS)

<!-- source: interface-diskbackendconfig.md -->

# DiskBackendConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/checkpoint-backend.ts` (line 173)

## Properties

| Property | Type |
|---|---|
| `sessionId` | `string` |
| `storageDir` | `string` |
| `retention` | `Partial<RetentionPolicy>` |
| `pruneOnInit` | `boolean` |

<!-- source: function-dispatchevent.md -->

# dispatchEvent

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-core/src/test-helpers.ts` (line 32)

Helper to dispatch a custom event on an element

## Signature

```ts
function dispatchEvent(element: HTMLElement, eventName: string, detail: unknown): boolean
```

## Parameters

| Name | Type |
|---|---|
| `element` | `HTMLElement` |
| `eventName` | `string` |
| `detail` | `unknown` |

**Returns:** `boolean`

<!-- source: interface-endpointinput.md -->

# EndpointInput

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/schema-resolver.ts` (line 172)

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `controller` | `string` |
| `methodName` | `string` |
| `httpMethod` | `string` |
| `path` | `string` |

<!-- source: class-enhancedocumentdto.md -->

# EnhanceDocumentDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/ai/dto/enhance-document.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `provider` | `string` |

<!-- source: function-extracthooksfrompath-2.md -->

# extractHooksFromPath

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 419)

Extract hooks used within a function path

## Signature

```ts
function extractHooksFromPath(path: NodePath): HookInfo[]
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath` |

**Returns:** `HookInfo[]`

<!-- source: service-feedbackservice.md -->

# FeedbackService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/analytics/feedback.service.ts` (line 20)

Per-doc helpfulness feedback. One row per (sessionId, documentSlug) —
if a reader changes their mind and clicks the other thumb, the row
upserts in place.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `submit` | `submit(dto: SubmitFeedbackDto)` | `unknown` |
| `getSummary` | `getSummary(projectId: string, days: unknown)` | `unknown` |
| `getWorstRated` | `getWorstRated(projectId: string, days: unknown, limit: unknown, minRatings: unknown)` | `unknown` |
| `getRecentNegativeComments` | `getRecentNegativeComments(projectId: string, days: unknown, limit: unknown)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: function-getpositionfromindex.md -->

# getPositionFromIndex

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Editor/UserCursors.tsx` (line 148)

Convert a character index in the editor's content to screen coordinates
for drawing a remote user's cursor.

## Signature

```ts
function getPositionFromIndex(index: number, contentEditable: HTMLElement | null, overlayReference: HTMLElement | null): { x: number; y: number; height: number } | null
```

## Parameters

| Name | Type |
|---|---|
| `index` | `number` |
| `contentEditable` | `HTMLElement | null` |
| `overlayReference` | `HTMLElement | null` |

**Returns:** `{ x: number; y: number; height: number } | null`

<!-- source: interface-kgentity.md -->

# KGEntity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useKnowledgeGraph.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `type` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `startLine` | `number` |
| `endLine` | `number` |
| `framework` | `string` |
| `metadata` | `Record<string, unknown>` |

<!-- source: class-knowledgecollector.md -->

# KnowledgeCollector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/knowledge-collector.ts` (line 50)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `collect` | `collect(doc: GeneratedDocument, meta: DocClassificationMeta)` | `void` |
| `getReference` | `getReference(category: MetaKnowledgeCategory)` | `MetaCategoryReference` |
| `getAllReferences` | `getAllReferences()` | `KnowledgeReferenceStore` |
| `finalize` | `finalize()` | `KnowledgeReferenceStore` |
| `getStats` | `getStats()` | `{
    totalDocsProcessed: number;
    totalDocsClassified: number;
    classificationFailures: number;
  }` |

<!-- source: type-mdastextension.md -->

# MdastExtension

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/importMarkdownToLexical.ts` (line 150)

An extension for the `fromMarkdown` utility tree construction.

## Definition

```ts
NonNullable<MdastExtensions>[number]
```

<!-- source: interface-relationshipmetadata.md -->

# RelationshipMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/relationship.interface.ts` (line 218)

Metadata for relationships

## Properties

| Property | Type |
|---|---|
| `props` | `string[]` |
| `httpMethod` | `string` |
| `importType` | `'named' | 'default' | 'namespace' | 'side-effect'` |
| `foreignKey` | `string` |
| `line` | `number` |
| `optional` | `boolean` |
| `lazy` | `boolean` |
| `cascade` | `string[]` |

<!-- source: function-resolvetheme.md -->

# resolveTheme

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/theme.ts` (line 106)

Merge user config with preset. If primaryColor is provided, override accent vars.

## Signature

```ts
function resolveTheme(config: ThemeConfig): ResolvedTheme
```

## Parameters

| Name | Type |
|---|---|
| `config` | `ThemeConfig` |

**Returns:** `ResolvedTheme`

<!-- source: class-swebenchadapter.md -->

# SWEBenchAdapter

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-adapter.ts` (line 61)

**Implements:** `BenchmarkAdapter`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `loadTasks` | `loadTasks(config: BenchmarkRunConfig)` | `Promise<BenchmarkTask[]>` |
| `setupTask` | `setupTask(task: BenchmarkTask, workDir: string)` | `Promise<void>` |
| `buildPrompt` | `buildPrompt(task: BenchmarkTask)` | `string` |
| `evaluate` | `evaluate(task: BenchmarkTask, workDir: string)` | `Promise<{ passed: boolean; details: string }>` |
| `cleanup` | `cleanup(_task: BenchmarkTask, workDir: string)` | `Promise<void>` |

<!-- source: constant-systemarchitecturetemplate.md -->

# systemArchitectureTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/system-architecture.template.ts` (line 3)

<!-- source: controller-technicaldocscontroller.md -->

# TechnicalDocsController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 21)

## Relationships

- MODULE_DECLARES → `startJob`
- MODULE_DECLARES → `generate`
- MODULE_DECLARES → `getSnapshot`
- MODULE_DECLARES → `getEntity`
- MODULE_DECLARES → `setCuration`
- MODULE_DECLARES → `importUrlSource`
- MODULE_DECLARES → `importPdfSource`
- MODULE_DECLARES → `importZendesk`
- MODULE_DECLARES → `importIntercom`
- MODULE_DECLARES → `listSources`
- MODULE_DECLARES → `removeSource`
- MODULE_DECLARES → `listConnectors`
- MODULE_DECLARES → `createConnector`
- MODULE_DECLARES → `syncConnector`
- MODULE_DECLARES → `setConnectorEnabled`
- MODULE_DECLARES → `removeConnector`
- MODULE_DECLARES → `exportConfluence`
- MODULE_DECLARES → `exportNotion`
- MODULE_DECLARES → `setEscalation`
- MODULE_DECLARES → `getEscalation`
- MODULE_DECLARES → `setPlaygroundTestKey`
- MODULE_DECLARES → `getApiTarget`
- MODULE_DECLARES → `setApiTarget`
- MODULE_DECLARES → `getApiSpec`
- MODULE_DECLARES → `getStatus`
- DEPENDS_ON → `technicaldocsservice`
- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `technicaldocsqueue`
- DEPENDS_ON → `aiusageservice`
- DEPENDS_ON → `techdocssourcesservice`
- DEPENDS_ON → `techdocsconnectorsservice`
- DEPENDS_ON → `techdocsexportservice`
- DEPENDS_ON → `techdocsnotionexportservice`

<!-- source: function-transformsnapshottodocset.md -->

# transformSnapshotToDocSet

**Kind:** Function

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-materializer.service.ts` (line 165)

Pure transform: navMap + entities + relationships → category tree + entity
reference pages. Deterministic (stable ordering, stable slug dedupe) so
re-runs produce identical output for identical snapshots.

## Signature

```ts
function transformSnapshotToDocSet(navMap: TechnicalNavMap, entities: SnapshotEntity[], relationships: SnapshotRelationship[], options: MaterializeOptions): TechnicalDocSet
```

## Parameters

| Name | Type |
|---|---|
| `navMap` | `TechnicalNavMap` |
| `entities` | `SnapshotEntity[]` |
| `relationships` | `SnapshotRelationship[]` |
| `options` | `MaterializeOptions` |

**Returns:** `TechnicalDocSet`

<!-- source: interface-batchstatusresponse.md -->

# BatchStatusResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 251)

Full batch status response

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `status` | `JobStatus` |
| `progress` | `number` |
| `totalUrls` | `number` |
| `capturedUrls` | `number` |
| `failedUrls` | `number` |
| `currentItem` | `string` |
| `currentStage` | `string` |
| `stageProgress` | `number` |
| `screenshots` | `ScreenshotResult[]` |
| `failures` | `ScreenshotFailure[]` |
| `error` | `string` |
| `timestamps` | `{
    createdAt: string;
    updatedAt: string;
    startedAt?: string;
    completedAt?: string;
  }` |
| `estimatedCompletion` | `string` |
| `stats` | `{
    averageCaptureTimeMs: number;
    successRate: number;
    retryCount: number;
  }` |

<!-- source: component-codeblock.md -->

# CodeBlock

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 304)

## Diagram

```mermaid
graph TD
    component_CodeBlock_61ea916a["CodeBlock"]
    class component_CodeBlock_61ea916a rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: constant-confidence-levels.md -->

# CONFIDENCE_LEVELS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 32)

Confidence levels

<!-- source: api-endpoint-createentity.md -->

# createEntity

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/graph.controller.ts` (line 30)

## Endpoint

`POST /knowledge-graph/entities`

## Referenced By

- `GraphController` (MODULE_DECLARES)

<!-- source: function-createsendmessagetool.md -->

# createSendMessageTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/send-message.tool.ts` (line 63)

## Signature

```ts
function createSendMessageTool(options: SendMessageOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `SendMessageOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: component-curatebuttons.md -->

# CurateButtons

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/components/EntityTree.tsx` (line 64)

Hover pin/hide controls on a tree row — stops the row's navigation.

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `entityId` | `string` | ✓ | - |
| `pinned` | `boolean` | ✓ | - |
| `onCurate` | `NonNullable` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CurateButtons_7d67d75d["CurateButtons"]
    class component_CurateButtons_7d67d75d rootComponent
```

## Referenced By

- `AppSection` (RENDERS)

<!-- source: interface-cursorposition-2.md -->

# CursorPosition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/collaboration/interfaces/collaboration.interfaces.ts` (line 30)

Cursor position in the document

## Properties

| Property | Type |
|---|---|
| `index` | `number` |
| `length` | `number` |

<!-- source: interface-editedfile.md -->

# EditedFile

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/self-review.ts` (line 26)

## Properties

| Property | Type |
|---|---|
| `path` | `string` |
| `before` | `string` |
| `after` | `string` |

<!-- source: interface-enhanceddocumentation.md -->

# EnhancedDocumentation

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/competitor.interface.ts` (line 31)

## Properties

| Property | Type |
|---|---|
| `original` | `string` |
| `enhanced` | `string` |
| `competitorSources` | `CompetitorInfo[]` |
| `enhancementNotes` | `string[]` |

<!-- source: function-ensureuniqueslug.md -->

# ensureUniqueSlug

**Kind:** Function

**Source:** `atloria-monorepo/packages/core/src/utils/slug.ts` (line 27)

Ensure a slug is unique by appending a number if needed

## Signature

```ts
function ensureUniqueSlug(slug: string, existingSlugs: string[]): string
```

## Parameters

| Name | Type |
|---|---|
| `slug` | `string` |
| `existingSlugs` | `string[]` |

**Returns:** `string`

<!-- source: class-externalprogressdto.md -->

# ExternalProgressDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/documentation/dto/doc-automation.dto.ts` (line 524)

ExternalProgressDto — payload from atlorix-runner (or any external
generator) reporting a phase boundary or item progress on a job that
the api created.

## Properties

| Property | Type |
|---|---|
| `stage` | `string` |
| `progress` | `number` |
| `stageProgress` | `number` |
| `currentItem` | `string` |
| `eventType` | `string` |

<!-- source: function-extractimportsfromdeclaration-2.md -->

# extractImportsFromDeclaration

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 111)

Extract imports from an ImportDeclaration node

## Signature

```ts
function extractImportsFromDeclaration(path: NodePath<t.ImportDeclaration>): ImportInfo[]
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath<t.ImportDeclaration>` |

**Returns:** `ImportInfo[]`

<!-- source: service-filecontextservice.md -->

# FileContextService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/ai/services/file-context.service.ts` (line 49)

Optimized file context service inspired by Claude Code & Cursor

Key optimizations:
1. Lazy loading - Only read files when needed
2. Chunking - Read files in segments (line ranges)
3. Token counting - Estimate tokens before sending
4. Caching - Cache file contents with invalidation
5. Smart filtering - Skip irrelevant files (node_modules, binaries, etc.)
6. Relevance ranking - Prioritize most relevant files

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getFileMetadata` | `getFileMetadata(filePath: string)` | `Promise<FileMetadata>` |
| `readFile` | `readFile(filePath: string)` | `Promise<string>` |
| `readFileChunk` | `readFileChunk(filePath: string, startLine: number, endLine: number)` | `Promise<FileChunk>` |
| `findRelevantFiles` | `findRelevantFiles(baseDir: string, patterns: string[], options: {
      maxFiles?: number;
      maxTokens?: number;
      exclude?: string[];
    })` | `Promise<FileMetadata[]>` |
| `buildContext` | `buildContext(files: string[], budget: number, keywords: string[])` | `Promise<{
    chunks: FileChunk[];
    budget: ContextBudget;
    skippedFiles: string[];
  }>` |
| `estimateTokens` | `estimateTokens(content: string)` | `number` |
| `clearCache` | `clearCache(filePath: string)` | `void` |
| `getCacheStats` | `getCacheStats()` | `unknown` |
| `formatChunksForAI` | `formatChunksForAI(chunks: FileChunk[], baseDir: string)` | `string` |

<!-- source: function-getreportersessionid.md -->

# getReporterSessionId

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/reporterSession.ts` (line 24)

## Signature

```ts
function getReporterSessionId(): string
```

**Returns:** `string`

<!-- source: interface-kgrelationship.md -->

# KGRelationship

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Graph/types.ts` (line 21)

Knowledge Graph Relationship

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `type` | `RelationType` |
| `fromEntityId` | `string` |
| `toEntityId` | `string` |
| `metadata` | `Record<string, unknown>` |
| `createdAt` | `Date` |

<!-- source: class-knowledgeformatter.md -->

# KnowledgeFormatter

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-14-meta/knowledge-formatter.ts` (line 20)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `format` | `format(reference: MetaCategoryReference | undefined, options: {
      maxChars: number;
      maxEntries: number;
      snippetTypes?: SnippetType[];
      groupByCategory?: boolean;
    })` | `string` |
| `formatDocList` | `formatDocList(reference: MetaCategoryReference | undefined, options: { maxEntries: number })` | `string` |
| `formatSnippets` | `formatSnippets(entries: KnowledgeEntry[], snippetType: SnippetType, maxChars: number)` | `string` |

<!-- source: type-mdastextensions.md -->

# MdastExtensions

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/importMarkdownToLexical.ts` (line 35)

## Definition

```ts
Options['mdastExtensions']
```

<!-- source: interface-relationshipwithentities.md -->

# RelationshipWithEntities

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/relationship.interface.ts` (line 268)

Relationship with full entity information (for graph queries)

## Properties

| Property | Type |
|---|---|
| `relationship` | `Relationship` |
| `source` | `TSource` |
| `target` | `TTarget` |

<!-- source: constant-techdocs-generate-credit-cost.md -->

# TECHDOCS_GENERATE_CREDIT_COST

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/billing/billing.constants.ts` (line 19)

Technical-docs / RAG operation costs (Tier 1 metering). Scaled against the
1,000-credit full generation: a technical regen is parse+materialize (no
screenshots/AI authoring); indexing/enrichment are bounded worker jobs; ask/assist
are single LLM round-trips. The PROJECT'S OWNING ORG pays — including for anonymous
chat on public projects (your public docs' AI burns your credits).

<!-- source: controller-technicaldocsmcpcontroller.md -->

# TechnicalDocsMcpController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-mcp.controller.ts` (line 46)

Hosts each project's technical docs as a live MCP server over Streamable HTTP, so coding agents
(Claude, Cursor, …) can add `…/technical-docs/:projectId/mcp` and query the docs + entity graph.

Stateless: each POST is a self-contained JSON-RPC exchange (no server-held session), which fits a
read-only docs server and scales trivially. Access mirrors the public docs — a publicly-published
project is open; otherwise a bearer token whose user can access the project is required. (Private
projects with the full MCP OAuth 2.1 flow are a follow-up.)

`TechnicalDocsMcpController` exposes each project’s technical documentation as a live MCP server over Streamable HTTP, enabling coding agents (Claude, Cursor, etc.) to query docs and the entity graph via a JSON-RPC interface. Each request is stateless (a self-contained JSON-RPC exchange), making it scalable and suitable for a read-only docs surface. Access mirrors the public docs: published projects are open; otherwise a bearer token must grant the caller access to the project.

## Diagram

```mermaid
graph LR
  A[Agent / Client<br/>Claude, Cursor, CLI] -->|POST JSON-RPC<br/>/technical-docs/:projectId/mcp| B[TechnicalDocsMcpController]
  B --> C{Authorization}
  C -->|Project is published| D[Allow]
  C -->|Not published| E[Verify Bearer Token<br/>User has project access]
  E -->|OK| D[Allow]
  E -->|Denied| F[401/403]
  D --> G[Docs + Entity Graph Provider]
  G --> H[JSON-RPC Response<br/>(Streamable HTTP)]
  H --> A
```

## Usage

```ts
// Example: calling the MCP endpoint from Node.js using JSON-RPC over HTTP.
// This is the typical way a coding agent or tool would interact with the controller.

const projectId = "proj_123";
const baseUrl = "https://api.example.com";
const url = `${baseUrl}/technical-docs/${projectId}/mcp`;

// Include Authorization only for non-public (unpublished) projects.
const token = process.env.API_TOKEN; // optional
const headers: Record<string, string> = {
  "content-type": "application/json",
  ...(token ? { authorization: `Bearer ${token}` } : {}),
};

const jsonRpcRequest = {
  jsonrpc: "2.0",
  id: "req-1",
  method: "docs.search", // method names depend on your MCP toolset exposed by the server
  params: {
    query: "How is billing handled in the API?",
    limit: 5,
  },
};

const res = await fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(jsonRpcRequest),
});

if (!res.ok) {
  const text = await res.text();
  throw new Error(`MCP request failed: ${res.status} ${res.statusText}\n${text}`);
}

const json = await res.json();
console.log("JSON-RPC response:", json);
```

## AI Coding Instructions

- Preserve the stateless contract: every `POST` must be a complete JSON-RPC exchange (no server-held sessions, no per-connection state).
- Keep auth rules aligned with public docs behavior: allow published projects anonymously; require `Authorization: Bearer ...` and validate project access for unpublished projects.
- Treat this as read-only infrastructure: avoid adding mutations or side effects (writes, background jobs) to MCP handlers exposed through this controller.
- Maintain Streamable HTTP compatibility (chunked/streaming response semantics where applicable) and avoid middleware that buffers the entire response body.
- When extending methods or integrating new docs/entity sources, keep response shapes stable for agents and ensure errors are proper JSON-RPC errors (not ad-hoc HTTP payloads).

## Relationships

- MODULE_DECLARES → `ragIndex`
- MODULE_DECLARES → `enrich`
- MODULE_DECLARES → `handle`
- MODULE_DECLARES → `mcpGet`
- MODULE_DECLARES → `getLlmsTxt`
- MODULE_DECLARES → `getLlmsFullTxt`
- MODULE_DECLARES → `getPageMarkdown`
- MODULE_DECLARES → `downloadSdk`
- MODULE_DECLARES → `ask`
- MODULE_DECLARES → `assist`
- MODULE_DECLARES → `assistApply`
- MODULE_DECLARES → `playgroundProxy`
- DEPENDS_ON → `technicaldocsmaterializerservice`
- DEPENDS_ON → `technicaldocsservice`
- DEPENDS_ON → `techdocsragservice`
- DEPENDS_ON → `technicaldocsqueue`
- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `aiusageservice`
- DEPENDS_ON → `draftdocumentservice`

<!-- source: class-testwatcher.md -->

# TestWatcher

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/test-watcher.ts` (line 44)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onFileEdited` | `onFileEdited(toolName: string)` | `void` |
| `dispose` | `dispose()` | `void` |
| `getLastResult` | `getLastResult()` | `TestRunResult | null` |
| `isRunning` | `isRunning()` | `boolean` |

<!-- source: function-validatecontentsafety.md -->

# validateContentSafety

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/content-safety.guardrail.ts` (line 54)

## Signature

```ts
function validateContentSafety(content: string, config: ContentSafetyConfig): GuardrailResult
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |
| `config` | `ContentSafetyConfig` |

**Returns:** `GuardrailResult`

<!-- source: interface-blockdefinitionnode.md -->

# BlockDefinitionNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 62)

Block definition node
Represents reusable content blocks

## Properties

| Property | Type |
|---|---|
| `type` | `'block_definition'` |
| `blockId` | `string` |
| `content` | `ASTNode[]` |

<!-- source: component-codeblock-2.md -->

# CodeBlock

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/mermaid.tsx` (line 60)

## Diagram

```mermaid
graph TD
    component_CodeBlock_599aa7ba["CodeBlock"]
    class component_CodeBlock_599aa7ba rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: constant-consistency-rules.md -->

# CONSISTENCY_RULES

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-11.types.ts` (line 125)

Consistency Check Rules

<!-- source: api-endpoint-createjob.md -->

# createJob

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/pme/pme.controller.ts` (line 33)

## Endpoint

`POST /pme/generate`

## Referenced By

- `PmeController` (MODULE_DECLARES)

<!-- source: function-createspawnagenttool.md -->

# createSpawnAgentTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/spawn-agent.tool.ts` (line 116)

## Signature

```ts
function createSpawnAgentTool(options: SpawnAgentOptions<TContext>): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `SpawnAgentOptions<TContext>` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: component-cursor.md -->

# Cursor

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/UserCursors.tsx` (line 45)

Individual user cursor component

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `user` | `UserWithPosition` | ✓ | - |
| `showLabel` | `boolean` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Cursor_1d65ea8["Cursor"]
    class component_Cursor_1d65ea8 rootComponent
```

## Referenced By

- `UserCursors` (RENDERS)

<!-- source: interface-customdomainview-2.md -->

# CustomDomainView

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/project/project-domains.service.ts` (line 27)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `domain` | `string` |
| `status` | `string` |
| `records` | `DnsRecordSpec[]` |
| `lastError` | `string | null` |
| `lastCheckedAt` | `Date | null` |
| `verifiedAt` | `Date | null` |
| `createdAt` | `Date` |

<!-- source: interface-editfileoptions.md -->

# EditFileOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/edit-file.tool.ts` (line 17)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `maxFileSize` | `number` |
| `editFormat` | `'search_replace' | 'unified_diff'` |
| `checkpointManager` | `CheckpointManager` |
| `lintCommand` | `string` |

<!-- source: interface-enhancedscreenshotmetadata.md -->

# EnhancedScreenshotMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/screenshot.interface.ts` (line 17)

Enhanced screenshot metadata with state machine context

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `title` | `string` |
| `component` | `string` |
| `componentPath` | `string` |
| `stateMachines` | `string[]` |
| `stateMachineDetails` | `StateMachine[]` |
| `currentState` | `string` |
| `availableTransitions` | `string[]` |
| `modalTriggers` | `string[]` |
| `interactions` | `UIInteraction[]` |
| `approvalStates` | `string[]` |
| `terminalStates` | `string[]` |
| `metadata` | `{
    /**
     * Timestamp when screenshot was captured
     */
    capturedAt?: Date;

    /**
     * Viewport size used
     */
    viewport?: {
      width: number;
      height: number;
    };

    /**
     * Whether this is a modal screenshot
     */
    isModal?: boolean;

    /**
     * Parent page URL if this is a modal
     */
    parentUrl?: string;
  }` |

<!-- source: function-exportlexicaltreetomdast.md -->

# exportLexicalTreeToMdast

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/exportMarkdownFromLexical.ts` (line 113)

## Signature

```ts
function exportLexicalTreeToMdast({
  root,
  visitors,
  jsxComponentDescriptors,
  jsxIsAvailable,
  addImportStatements = true
}: ExportLexicalTreeOptions): Mdast.Root
```

## Parameters

| Name | Type |
|---|---|
| `{
  root,
  visitors,
  jsxComponentDescriptors,
  jsxIsAvailable,
  addImportStatements = true
}` | `ExportLexicalTreeOptions` |

**Returns:** `Mdast.Root`

<!-- source: function-extractjsdocdescription-2.md -->

# extractJSDocDescription

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 658)

Extract JSDoc description from leading comments

## Signature

```ts
function extractJSDocDescription(path: NodePath): string | undefined
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath` |

**Returns:** `string | undefined`

<!-- source: class-finalizepmepagedto.md -->

# FinalizePmePageDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/pme/dto/pme.dto.ts` (line 45)

## Properties

| Property | Type |
|---|---|
| `pageId` | `string` |
| `sectionChoices` | `Record<string, 'A' | 'B' | 'C'>` |

<!-- source: service-flowdetectorservice.md -->

# FlowDetectorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/graph/services/flow-detector.service.ts` (line 9)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectFlow` | `detectFlow(entityId: string, flowName: string)` | `Promise<Flow>` |
| `detectImpact` | `detectImpact(entityId: string)` | `Promise<KGEntity[]>` |

## Relationships

- DEPENDS_ON → `knowledgegraphservice`

<!-- source: function-getselectionrects.md -->

# getSelectionRects

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Editor/UserCursors.tsx` (line 231)

Utility function to get selection rectangles for highlighting

## Signature

```ts
function getSelectionRects(anchor: number, head: number, container: HTMLElement | null): DOMRect[]
```

## Parameters

| Name | Type |
|---|---|
| `anchor` | `number` |
| `head` | `number` |
| `container` | `HTMLElement | null` |

**Returns:** `DOMRect[]`

<!-- source: interface-kgrelationship-2.md -->

# KGRelationship

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useKnowledgeGraph.ts` (line 17)

## Properties

| Property | Type |
|---|---|
| `sourceId` | `string` |
| `targetId` | `string` |
| `type` | `string` |
| `metadata` | `Record<string, unknown>` |

<!-- source: class-largefileindexer.md -->

# LargeFileIndexer

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/large-file-indexer.ts` (line 44)

Large File Indexer - Creates indexes for files >500KB

## Methods

| Method | Signature | Returns |
|---|---|---|
| `isLargeFile` | `isLargeFile(filePath: string)` | `Promise<boolean>` |
| `createIndex` | `createIndex(filePath: string)` | `Promise<LargeFileIndex>` |

<!-- source: type-mdasthtmlnode.md -->

# MdastHTMLNode

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/MdastHTMLNode.ts` (line 30)

A HTML MDAST node.

## Definition

```ts
MdastBlockHTMLNode | MdastInlineHTMLNode
```

<!-- source: interface-responsedefinition.md -->

# ResponseDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 553)

Response definition

## Properties

| Property | Type |
|---|---|
| `statusCode` | `number` |
| `description` | `string` |
| `schema` | `SchemaDefinition` |
| `examples` | `Record<string, unknown>` |

<!-- source: constant-technicaldesigntemplate.md -->

# technicalDesignTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/technical-design.template.ts` (line 3)

<!-- source: controller-templatecontroller.md -->

# TemplateController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/template/template.controller.ts` (line 32)

Controller for document template operations.
Provides endpoints for browsing, using, and creating templates.

`TemplateController` is a NestJS controller responsible for document template operations in the API. It exposes HTTP endpoints to browse available templates, create/manage templates, and apply a template to generate documents. It sits at the edge of the backend, validating request inputs and delegating business logic to the underlying template service layer.

## Diagram

```mermaid
graph LR
  Client[API Client] -->|HTTP request| TC[TemplateController]
  TC -->|validate/parse DTOs| Pipes[Nest Pipes/Guards]
  TC -->|delegate| TS[TemplateService]
  TS -->|read/write| DB[(Database)]
  TS -->|load/store| FS[(Template Storage)]
  TS -->|generate document| DOC[Document Builder/Renderer]
  TS -->|response DTO| TC
  TC -->|HTTP response| Client
```

## Usage

```ts
// Example: calling TemplateController endpoints from a client (Node.js / browser).
// Adjust baseUrl and routes to match your actual API paths.

async function listTemplates(baseUrl: string, token: string) {
  const res = await fetch(`${baseUrl}/templates`, {
    method: "GET",
    headers: { Authorization: `Bearer ${token}` },
  });

  if (!res.ok) throw new Error(`Failed to list templates: ${res.status}`);
  return res.json(); // e.g., [{ id, name, category, ... }]
}

async function createTemplate(baseUrl: string, token: string) {
  const res = await fetch(`${baseUrl}/templates`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${token}`,
    },
    body: JSON.stringify({
      name: "NDA v1",
      description: "Standard NDA template",
      // ...other fields expected by your CreateTemplateDto
    }),
  });

  if (!res.ok) throw new Error(`Failed to create template: ${res.status}`);
  return res.json(); // e.g., { id, ... }
}

async function applyTemplate(baseUrl: string, token: string, templateId: string) {
  const res = await fetch(`${baseUrl}/templates/${templateId}/use`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${token}`,
    },
    body: JSON.stringify({
      variables: { companyName: "Atloria, Inc." },
      // ...other fields expected by your "use template" DTO
    }),
  });

  if (!res.ok) throw new Error(`Failed to use template: ${res.status}`);

  // Could be JSON metadata or a file stream depending on implementation.
  const contentType = res.headers.get("content-type") ?? "";
  return contentType.includes("application/json") ? res.json() : res.blob();
}

// Example runner
(async () => {
  const baseUrl = "https://api.example.com";
  const token = process.env.API_TOKEN!;

  const templates = await listTemplates(baseUrl, token);
  const created = await createTemplate(baseUrl, token);
  const output = await applyTemplate(baseUrl, token, created.id);

  console.log({ templatesCount: templates.length, createdId: created.id, outputType: typeof output });
})();
```

## AI Coding Instructions

- Keep controller methods thin: validate/transform request DTOs and delegate all business logic to the template service; avoid embedding persistence or rendering logic in the controller.
- Use NestJS DTOs + `ValidationPipe` consistently for all inputs (query/params/body) to prevent template injection and malformed payloads from reaching the service.
- Maintain stable route patterns for template listing/creation vs. “use/apply” actions (e.g., `POST /templates/:id/use`) and document the response type (JSON vs file/stream) to avoid client breakages.
- Ensure authentication/authorization guards are applied uniformly, especially for template creation and any endpoint that can access private templates or generate documents.
- When adding new endpoints, align return shapes with existing response DTOs and handle errors with Nest exceptions (`BadRequestException`, `NotFoundException`) rather than raw errors.

## Relationships

- MODULE_DECLARES → `list`
- MODULE_DECLARES → `getById`
- MODULE_DECLARES → `create`
- MODULE_DECLARES → `useTemplate`
- MODULE_DECLARES → `saveAsTemplate`
- MODULE_DECLARES → `update`
- MODULE_DECLARES → `delete`
- DEPENDS_ON → `templateservice`

<!-- source: class-todomanager.md -->

# TodoManager

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/todo-manager.ts` (line 19)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `add` | `add(description: string)` | `TodoItem` |
| `addBatch` | `addBatch(descriptions: string[])` | `TodoItem[]` |
| `start` | `start(id: string)` | `void` |
| `complete` | `complete(id: string, result: string)` | `void` |
| `skip` | `skip(id: string, reason: string)` | `void` |
| `getAll` | `getAll()` | `ReadonlyArray<TodoItem>` |
| `getPending` | `getPending()` | `TodoItem[]` |
| `getCurrent` | `getCurrent()` | `TodoItem | undefined` |
| `getStats` | `getStats()` | `{ total: number; completed: number; pending: number; inProgress: number; skipped: number }` |
| `toContextString` | `toContextString()` | `string` |
| `serialize` | `serialize()` | `string` |
| `deserialize` | `deserialize(json: string)` | `TodoManager` |

<!-- source: function-validatehtml.md -->

# validateHtml

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/tools/validate-html.tool.ts` (line 43)

## Signature

```ts
function validateHtml(html: string): HtmlValidationResult
```

## Parameters

| Name | Type |
|---|---|
| `html` | `string` |

**Returns:** `HtmlValidationResult`

<!-- source: interface-blockregistry.md -->

# BlockRegistry

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 179)

Block registry for storing reusable blocks

## Properties

| Property | Type |
|---|---|
| `blocks` | `Map<string, BlockDefinitionNode>` |

<!-- source: component-codeblockeditorcontainer.md -->

# CodeBlockEditorContainer

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/CodeBlockNode.tsx` (line 236)

## Diagram

```mermaid
graph TD
    component_CodeBlockEditorContainer_1a92dbc9["CodeBlockEditorContainer"]
    class component_CodeBlockEditorContainer_1a92dbc9 rootComponent
```

## Relationships

- RENDERS → `CodeBlockEditorContextProvider`
- RENDERS → `Editor`
- USES_HOOK → `useCellValue`

<!-- source: constant-contenteditableclassname.md -->

# contentEditableClassName$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 135)

Holds the CSS class name of the content editable element.

<!-- source: api-endpoint-createrelation.md -->

# createRelation

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/graph.controller.ts` (line 38)

## Endpoint

`POST /knowledge-graph/relations`

## Referenced By

- `GraphController` (MODULE_DECLARES)

<!-- source: function-createtestgate.md -->

# createTestGate

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/test-watcher.ts` (line 227)

Creates a QualityGate array that checks whether tests pass.
If a TestWatcher is provided, uses its last result to avoid re-running.
If a LintTestLoop is provided, uses its state to check verification recency.

## Signature

```ts
function createTestGate(config: TestGateConfig, lintTestLoop: LintTestLoop, testWatcher: TestWatcher): QualityGate[]
```

## Parameters

| Name | Type |
|---|---|
| `config` | `TestGateConfig` |
| `lintTestLoop` | `LintTestLoop` |
| `testWatcher` | `TestWatcher` |

**Returns:** `QualityGate[]`

<!-- source: component-customdomaincard.md -->

# CustomDomainCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Domains/DomainTab.tsx` (line 330)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `onToast` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomDomainCard_589d45d6["CustomDomainCard"]
    class component_CustomDomainCard_589d45d6 rootComponent
```

## Relationships

- RENDERS → `DomainStatusChip`
- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `XMarkIcon`
- RENDERS → `GlobeAltIcon`
- RENDERS → `CopyButton`
- RENDERS → `ArrowPathIcon`
- RENDERS → `CheckCircleIcon`
- RENDERS → `ArrowTopRightOnSquareIcon`
- RENDERS → `CheckIcon`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

## Referenced By

- `DomainTab` (RENDERS)

<!-- source: interface-dependency.md -->

# Dependency

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/parser/interfaces/code-parser.interface.ts` (line 44)

## Properties

| Property | Type |
|---|---|
| `source` | `string` |
| `symbols` | `string[]` |
| `type` | `'import' | 'require' | 'include'` |
| `isExternal` | `boolean` |

<!-- source: interface-embedderconfig.md -->

# EmbedderConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/embedder.ts` (line 17)

Azure OpenAI Embedding Adapter

Uses direct `fetch` calls to the Azure OpenAI embeddings endpoint.
Zero external dependencies — only Node.js global fetch (Node 18+).

Follows the same Azure API patterns as runtime/model-adapter.ts:
- `api-key` header authentication
- Deployment-based URL routing
- Rate limit (429) handling with Retry-After support
- Structured error propagation

## Properties

| Property | Type |
|---|---|
| `endpoint` | `string` |
| `apiKey` | `string` |
| `model` | `string` |
| `apiVersion` | `string` |
| `batchSize` | `number` |

<!-- source: interface-entity-2.md -->

# Entity

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 240)

Base entity interface - all specific entities extend this

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `type` | `EntityType` |
| `name` | `string` |
| `filePath` | `string` |
| `startLine` | `number` |
| `endLine` | `number` |
| `description` | `string` |
| `framework` | `string` |
| `tags` | `string[]` |
| `metadata` | `Record<string, unknown>` |
| `discoveredAt` | `Date` |
| `contentHash` | `string` |

<!-- source: function-exportmarkdownfromlexical.md -->

# exportMarkdownFromLexical

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/exportMarkdownFromLexical.ts` (line 428)

## Signature

```ts
function exportMarkdownFromLexical({
  root,
  toMarkdownOptions,
  toMarkdownExtensions,
  visitors,
  jsxComponentDescriptors,
  jsxIsAvailable
}: ExportMarkdownFromLexicalOptions): string
```

## Parameters

| Name | Type |
|---|---|
| `{
  root,
  toMarkdownOptions,
  toMarkdownExtensions,
  visitors,
  jsxComponentDescriptors,
  jsxIsAvailable
}` | `ExportMarkdownFromLexicalOptions` |

**Returns:** `string`

<!-- source: function-extractmodals.md -->

# extractModals

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/modal-extractor.ts` (line 478)

Extract all modal definitions from both code and template, deduplicating results.

This is the main entry point for modal extraction. It calls both
extractModalsFromCode and extractModalsFromTemplate, then merges
results by name (code-derived modals take priority for metadata).

## Signature

```ts
function extractModals(code: string, templateContent: string | undefined, filePath: string, componentName: string, framework: 'angular' | 'vue' | 'react'): ModalDefinition[]
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |
| `templateContent` | `string | undefined` |
| `filePath` | `string` |
| `componentName` | `string` |
| `framework` | `'angular' | 'vue' | 'react'` |

**Returns:** `ModalDefinition[]`

<!-- source: service-flowdraftstitcherservice.md -->

# FlowDraftStitcherService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/capture/flow-draft-stitcher.service.ts` (line 43)

FlowDraftStitcherService (WS-A, api side).

Background poll loop: watches a flow-replay job on the screenshot-worker and,
as each step's screenshot becomes available, replaces that step's
`[SCREENSHOT: flow-step-N]` placeholder in the draft Document's markdown with a
real annotated image `![Step N](<blobUrl>#atloria-annotations=…)`. When the job
finishes it clears `metadata.screenshotsPending` and strips any placeholders for
steps that never produced a screenshot (they degrade to text via the reader's
remarkStripScreenshots). Runs HTTP-only — no browser on the api pod.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `start` | `start(params: StartStitchParams)` | `void` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: class-forgotpassworddto.md -->

# ForgotPasswordDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/auth/dto/password.dto.ts` (line 11)

## Properties

| Property | Type |
|---|---|
| `email` | `string` |

<!-- source: function-gettotalpendingcount.md -->

# getTotalPendingCount

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useOfflineSync.ts` (line 366)

Get total count of pending updates across all documents

## Signature

```ts
function getTotalPendingCount(): number
```

**Returns:** `number`

<!-- source: interface-knowledgegraphdata.md -->

# KnowledgeGraphData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useKnowledgeGraph.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `entities` | `KGEntity[]` |
| `relationships` | `KGRelationship[]` |

<!-- source: class-learningpathgenerator.md -->

# LearningPathGenerator

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-14-meta/generators/learning-path.generator.ts` (line 25)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate(input: LearningPathDocInput, reference: MetaCategoryReference)` | `Promise<{
    document: GeneratedDocument;
    promptTokens: number;
    completionTokens: number;
  }>` |

<!-- source: type-mdastjsx.md -->

# MdastJsx

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/index.ts` (line 32)

An MDX JSX MDAST node.

## Definition

```ts
MdxJsxTextElement | MdxJsxFlowElement
```

<!-- source: interface-schemadefinition.md -->

# SchemaDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 516)

Schema definition for request/response bodies

## Properties

| Property | Type |
|---|---|
| `type` | `string` |
| `properties` | `Record<string, PropertyDefinition>` |
| `required` | `string[]` |
| `$ref` | `string` |

<!-- source: controller-testconnectioncontroller.md -->

# TestConnectionController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/parsing/test-connection.controller.ts` (line 25)

## Relationships

- MODULE_DECLARES → `testConnection`
- MODULE_DECLARES → `listBranches`
- DEPENDS_ON → `gitcloneservice`

<!-- source: constant-theme-presets-2.md -->

# THEME_PRESETS

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/branding/branding.service.ts` (line 26)

Theme presets (4.2) — whole-page token packs the public viewer expands client-side.

<!-- source: class-toolregistry.md -->

# ToolRegistry

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/tools/tool-registry.ts` (line 39)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `search` | `search(query: string, maxResults: number)` | `ToolSearchResult[]` |
| `buildDeferredToolsReminder` | `buildDeferredToolsReminder()` | `string` |
| `createToolSearchTool` | `createToolSearchTool()` | `ToolDefinition<any> | null` |
| `get` | `get(name: string)` | `ToolDefinition<any> | undefined` |
| `estimateTokenSavings` | `estimateTokenSavings()` | `{ beforeTokens: number; afterTokens: number; savedTokens: number; savingsPercent: number }` |

## Properties

| Property | Type |
|---|---|
| `alwaysLoaded` | `ToolDefinition<any>[]` |
| `deferred` | `ToolDefinition<any>[]` |

<!-- source: function-validatehtmlquality.md -->

# validateHtmlQuality

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/html-quality.guardrail.ts` (line 25)

## Signature

```ts
function validateHtmlQuality(html: string, config: HtmlQualityConfig): GuardrailResult
```

## Parameters

| Name | Type |
|---|---|
| `html` | `string` |
| `config` | `HtmlQualityConfig` |

**Returns:** `GuardrailResult`

<!-- source: interface-bolditalicunderlinetogglesprops.md -->

# BoldItalicUnderlineTogglesProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/BoldItalicUnderlineToggles.tsx` (line 36)

## Properties

| Property | Type |
|---|---|
| `options` | `('Bold' | 'Italic' | 'Underline')[]` |

<!-- source: component-codeinlists.md -->

# CodeInLists

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/nested-lists.tsx` (line 56)

## Diagram

```mermaid
graph TD
    component_CodeInLists_8b7e7c1["CodeInLists"]
    class component_CodeInLists_8b7e7c1 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `UndoRedo`

<!-- source: constant-contenteditableref.md -->

# contentEditableRef$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 336)

A reference to the content editable element.

<!-- source: api-endpoint-createreport.md -->

# createReport

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/export/analytics-export.controller.ts` (line 95)

## Endpoint

`POST /analytics/:projectId/reports`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `AnalyticsExportController` (MODULE_DECLARES)

<!-- source: function-createtodowritetool.md -->

# createTodoWriteTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/todo-write.tool.ts` (line 17)

## Signature

```ts
function createTodoWriteTool(todoManager: TodoManager): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `todoManager` | `TodoManager` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: component-customdomainpublishingrow.md -->

# CustomDomainPublishingRow

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/page.tsx` (line 1716)

Publishing-card row for the custom domain: shows the shared status chip when a domain exists (fetched once, non-blocking) plus a deep link into Settings → Branding → Domain.

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomDomainPublishingRow_16a8d4e7["CustomDomainPublishingRow"]
    class component_CustomDomainPublishingRow_16a8d4e7 rootComponent
```

## Relationships

- RENDERS → `DomainStatusChip`
- RENDERS → `Link`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

## Referenced By

- `ProjectPage` (RENDERS)

<!-- source: interface-detectedfeature.md -->

# DetectedFeature

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/feature-detector.service.ts` (line 18)

Detected feature from codebase analysis

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `category` | `string` |
| `components` | `any[]` |
| `services` | `any[]` |
| `routes` | `string[]` |
| `stateMachines` | `any[]` |
| `uiInteractions` | `any[]` |
| `codeExamples` | `CodeExample[]` |
| `configOptions` | `{
    envVars: string[];
    settings: Record<string, any>;
  }` |
| `complexity` | `'simple' | 'moderate' | 'complex'` |
| `userRoles` | `string[]` |
| `prerequisites` | `string[]` |
| `relatedFeatures` | `string[]` |

<!-- source: interface-entitychange.md -->

# EntityChange

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/version-diff.ts` (line 31)

Entity change

## Properties

| Property | Type |
|---|---|
| `type` | `ChangeType` |
| `id` | `string` |
| `name` | `string` |
| `entityType` | `string` |
| `oldEntity` | `Entity` |
| `newEntity` | `Entity` |
| `severity` | `ChangeSeverity` |
| `description` | `string` |
| `affectedProperties` | `string[]` |

<!-- source: interface-envsnapshot.md -->

# EnvSnapshot

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/env-tracker.ts` (line 20)

A point-in-time snapshot of shell environment state.

## Properties

| Property | Type |
|---|---|
| `cwd` | `string` |
| `env` | `Record<string, string>` |
| `venvActive` | `string` |
| `condaEnv` | `string` |
| `timestamp` | `number` |

<!-- source: function-extractentitymentions.md -->

# extractEntityMentions

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/grounding-checker.ts` (line 57)

Extract potential entity references from generated markdown.

Looks for:
- Capitalized phrases (2+ words starting with uppercase): "Sales Order", "Journal Entry"
- Quoted terms: "something" or 'something'
- Bold terms: **something**
- Menu paths: "X > Y > Z" or "X → Y → Z"

Returns a deduplicated, normalized (lowercase, trimmed) array.

## Signature

```ts
function extractEntityMentions(markdown: string): string[]
```

## Parameters

| Name | Type |
|---|---|
| `markdown` | `string` |

**Returns:** `string[]`

<!-- source: function-extractmodalsfromcode.md -->

# extractModalsFromCode

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/modal-extractor.ts` (line 79)

Extract modal definitions from TypeScript/JavaScript source code.

Scans for programmatic modal triggers: openPopup(), dialog.open(),
modalService.show(), useState patterns, jQuery .modal() calls, etc.

## Signature

```ts
function extractModalsFromCode(code: string, filePath: string, componentName: string): ModalDefinition[]
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |
| `filePath` | `string` |
| `componentName` | `string` |

**Returns:** `ModalDefinition[]`

<!-- source: service-freshnessservice.md -->

# FreshnessService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/freshness.service.ts` (line 65)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `stale` | `stale(projectId: string, organizationId: string)` | `Promise<StaleResult>` |
| `reshoot` | `reshoot(projectId: string, user: JwtPayload)` | `Promise<ReshootResult>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `docautomationservice`

<!-- source: class-generatefromneo4jdto.md -->

# GenerateFromNeo4jDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/documentation/dto/generate-from-neo4j.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `types` | `('overview' | 'guides' | 'tutorials' | 'features')[]` |
| `saveToDatabase` | `boolean` |
| `createCategories` | `boolean` |

<!-- source: function-getusercolor.md -->

# getUserColor

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/user-colors.ts` (line 83)

Get a consistent color for a user with memoization
This is more efficient when the same userId is requested multiple times

## Signature

```ts
function getUserColor(userId: string): string
```

## Parameters

| Name | Type |
|---|---|
| `userId` | `string` |

**Returns:** `string`

<!-- source: class-lexicaljsxnode.md -->

# LexicalJsxNode

**Kind:** Class

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/LexicalJsxNode.tsx` (line 28)

**Extends:** `DecoratorNode`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getType` | `getType()` | `string` |
| `clone` | `clone(node: LexicalJsxNode)` | `LexicalJsxNode` |
| `importJSON` | `importJSON(serializedNode: SerializedLexicalJsxNode)` | `LexicalJsxNode` |
| `getMdastNode` | `getMdastNode()` | `MdastJsx` |
| `getImportStatement` | `getImportStatement()` | `ImportStatement | undefined` |
| `exportJSON` | `exportJSON()` | `SerializedLexicalJsxNode` |
| `createDOM` | `createDOM()` | `HTMLElement` |
| `updateDOM` | `updateDOM()` | `false` |
| `setMdastNode` | `setMdastNode(mdastNode: MdastJsx)` | `void` |
| `decorate` | `decorate(parentEditor: LexicalEditor, config: EditorConfig)` | `JSX.Element` |
| `isInline` | `isInline()` | `boolean` |
| `isKeyboardSelectable` | `isKeyboardSelectable()` | `boolean` |

## Properties

| Property | Type |
|---|---|
| `__mdastNode` | `MdastJsx` |
| `__focusEmitter` | `any` |
| `__importStatement` | `ImportStatement` |
| `select` | `any` |

<!-- source: interface-lightboxprops.md -->

# LightboxProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/Lightbox.tsx` (line 24)

## Properties

| Property | Type |
|---|---|
| `onClose` | `() => void` |
| `label` | `string` |
| `closeLabel` | `string` |
| `caption` | `string | null` |
| `dir` | `'ltr' | 'rtl'` |
| `returnFocusRef` | `React.RefObject<HTMLElement | null>` |
| `children` | `React.ReactNode` |

<!-- source: type-mdxnodetype.md -->

# MdxNodeType

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/MdastHTMLNode.ts` (line 38)

The MDAST jsx distinction value used to differentiate inline and block level elements.

## Definition

```ts
MdastHTMLNode['type']
```

<!-- source: interface-serviceentity.md -->

# ServiceEntity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 734)

Service entity (NestJS, Express, etc.)

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.SERVICE` |
| `dependencies` | `DependencyInfo[]` |
| `methods` | `MethodDefinition[]` |
| `isSingleton` | `boolean` |

<!-- source: class-toolresultmanager.md -->

# ToolResultManager

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/context/tool-result-manager.ts` (line 30)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `store` | `store(toolName: string, result: string, turn: number)` | `ToolResult` |
| `getAll` | `getAll()` | `ReadonlyArray<ToolResult>` |
| `getByTool` | `getByTool(toolName: string)` | `ToolResult[]` |
| `getLatest` | `getLatest(toolName: string)` | `ToolResult | undefined` |
| `getTotalTokens` | `getTotalTokens()` | `number` |
| `cleanup` | `cleanup(currentTurn: number)` | `void` |
| `toContextString` | `toContextString()` | `string` |
| `clear` | `clear()` | `void` |
| `serialize` | `serialize()` | `string` |
| `deserialize` | `deserialize(json: string, config: ToolResultManagerConfig)` | `ToolResultManager` |

<!-- source: controller-trialcontroller.md -->

# TrialController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/trial/trial.controller.ts` (line 10)

Anonymous one-click trial for PUBLIC GitHub repos (Phase 1.1). Rate-limited per IP by
the AI cost guard + a global daily cap inside the service.

## Relationships

- MODULE_DECLARES → `generate`
- MODULE_DECLARES → `status`
- DEPENDS_ON → `trialservice`

<!-- source: constant-troubleshootingtemplate.md -->

# troubleshootingTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/troubleshooting.template.ts` (line 3)

<!-- source: function-validateimagequality.md -->

# validateImageQuality

**Kind:** Function

**Source:** `atloria-monorepo/libs/pme-core/src/guardrails/image-quality.guardrail.ts` (line 41)

Validate image metadata against quality criteria.
Exported for direct use in tests and pipelines.

## Signature

```ts
function validateImageQuality(metadata: ImageMetadata, config: ImageQualityConfig): GuardrailResult
```

## Parameters

| Name | Type |
|---|---|
| `metadata` | `ImageMetadata` |
| `config` | `ImageQualityConfig` |

**Returns:** `GuardrailResult`

<!-- source: interface-borderradius.md -->

# BorderRadius

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 90)

## Properties

| Property | Type |
|---|---|
| `none` | `string` |
| `sm` | `string` |
| `md` | `string` |
| `lg` | `string` |
| `xl` | `string` |
| `full` | `string` |

<!-- source: component-codemirror.md -->

# Codemirror

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/cm-merge.tsx` (line 82)

## Diagram

```mermaid
graph TD
    component_Codemirror_4289ef46["Codemirror"]
    class component_Codemirror_4289ef46 rootComponent
```

## Relationships

- USES_HOOK → `useCallback`

<!-- source: constant-contenteditablewrapperelement.md -->

# contentEditableWrapperElement$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 461)

<!-- source: api-endpoint-createsession.md -->

# createSession

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-chat.controller.ts` (line 48)

## Endpoint

`POST /technical-docs/:projectId/chat/sessions`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsChatController` (MODULE_DECLARES)

<!-- source: function-createtoolsearchtool.md -->

# createToolSearchTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/tool-search.tool.ts` (line 36)

## Signature

```ts
function createToolSearchTool(options: ToolSearchToolOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `ToolSearchToolOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: component-customertabbody.md -->

# CustomerTabBody

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/DeskCopilot.tsx` (line 473)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `thread` | `DeskThreadDetail` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomerTabBody_1379617c["CustomerTabBody"]
    class component_CustomerTabBody_1379617c rootComponent
```

## Relationships

- RENDERS → `SectionLabel`
- RENDERS → `ArrowTopRightOnSquareIcon`

## Referenced By

- `DeskCopilot` (RENDERS)

<!-- source: interface-detectedtutorial.md -->

# DetectedTutorial

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/tutorial-detector.service.ts` (line 25)

Detected tutorial from state machine analysis

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `difficulty` | `'beginner' | 'intermediate' | 'advanced'` |
| `estimatedTime` | `string` |
| `stateTransition` | `{
    from: string;
    to: string;
    method: string;
    stateMachine: string;
    requiresModal?: boolean;
    requiresApproval?: boolean;
  }` |
| `component` | `any` |
| `feature` | `string` |
| `route` | `string` |
| `uiInteractions` | `any[]` |
| `prerequisites` | `string[]` |
| `requiredRole` | `string` |
| `category` | `string` |
| `tags` | `string[]` |
| `nextSteps` | `string[]` |
| `previousSteps` | `string[]` |
| `formFields` | `any[]` |
| `screenshots` | `any[]` |
| `stateFlow` | `StateFlow` |
| `loadingState` | `LoadingStateMetadata` |
| `errorHandling` | `ErrorHandlingMetadata` |

<!-- source: interface-entitydiff.md -->

# EntityDiff

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/staleness.ts` (line 53)

## Properties

| Property | Type |
|---|---|
| `changed` | `string[]` |
| `added` | `string[]` |
| `removed` | `string[]` |

<!-- source: interface-evalcommandoptions.md -->

# EvalCommandOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-evaluator.ts` (line 40)

Options for building the eval command

## Properties

| Property | Type |
|---|---|
| `predictionsPath` | `string` |
| `runId` | `string` |
| `maxWorkers` | `number` |
| `dataset` | `string` |
| `timeout` | `number` |
| `split` | `string` |

<!-- source: function-extractmodalsfromtemplate.md -->

# extractModalsFromTemplate

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/modal-extractor.ts` (line 251)

Extract modal definitions from HTML template content.

Scans for modal-related elements: app-shared-popup, dx-popup,
Bootstrap modal attributes, ngIf popup conditionals, React/Vue modal components.

## Signature

```ts
function extractModalsFromTemplate(templateContent: string, filePath: string, componentName: string, framework: 'angular' | 'vue' | 'react'): ModalDefinition[]
```

## Parameters

| Name | Type |
|---|---|
| `templateContent` | `string` |
| `filePath` | `string` |
| `componentName` | `string` |
| `framework` | `'angular' | 'vue' | 'react'` |

**Returns:** `ModalDefinition[]`

<!-- source: function-extractsignature.md -->

# extractSignature

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/services/entity-mapper.service.ts` (line 374)

Extract the first declaration line as a signature.

## Signature

```ts
function extractSignature(fileCache: FileCache, absolutePath: string, startLine: number): string | undefined
```

## Parameters

| Name | Type |
|---|---|
| `fileCache` | `FileCache` |
| `absolutePath` | `string` |
| `startLine` | `number` |

**Returns:** `string | undefined`

<!-- source: class-generateoutlinedto.md -->

# GenerateOutlineDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/ai/dto/generate-outline.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `topic` | `string` |
| `audience` | `string` |
| `provider` | `string` |

<!-- source: function-getusercolorrgb.md -->

# getUserColorRGB

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/user-colors.ts` (line 105)

Get an RGB representation of a user color
Useful for creating variations (e.g., with different opacity)

## Signature

```ts
function getUserColorRGB(userId: string): { r: number; g: number; b: number }
```

## Parameters

| Name | Type |
|---|---|
| `userId` | `string` |

**Returns:** `{ r: number; g: number; b: number }`

<!-- source: service-gitcloneservice.md -->

# GitCloneService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/parsing/git-clone.service.ts` (line 32)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `clone` | `clone(options: CloneOptions)` | `Promise<CloneResult>` |
| `testAccess` | `testAccess(options: {
    repositoryUrl: string;
    provider: RepositoryProvider;
    credentials?: RepositoryCredentialsDto;
  })` | `Promise<{ success: boolean; error?: string }>` |
| `listBranchesViaGit` | `listBranchesViaGit(options: {
    repositoryUrl: string;
    provider: RepositoryProvider;
    credentials?: RepositoryCredentialsDto;
  })` | `Promise<{ success: boolean; branches: { name: string }[]; error?: string }>` |
| `buildCloneUrl` | `buildCloneUrl(options: {
    repositoryUrl: string;
    provider: RepositoryProvider;
    credentials?: RepositoryCredentialsDto;
  })` | `string` |
| `parseRepositoryUrl` | `parseRepositoryUrl(repositoryUrl: string)` | `ParsedRepoUrl` |
| `cleanup` | `cleanup(localPath: string)` | `Promise<void>` |
| `cleanupOldClones` | `cleanupOldClones(olderThanHours: number)` | `Promise<void>` |

<!-- source: interface-livejobprogress.md -->

# LiveJobProgress

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationJobs.ts` (line 22)

Live progress state for a running job

## Properties

| Property | Type |
|---|---|
| `jobId` | `string` |
| `progress` | `number` |
| `currentStage` | `string | null` |
| `stageProgress` | `number` |
| `currentItem` | `string | null` |
| `elapsedMs` | `number` |
| `estimatedRemainingMs` | `number` |
| `screenshotProgress` | `{
    batchIndex: number;
    totalBatches: number;
    captured: number;
    totalMappings: number;
  }` |

<!-- source: class-logger.md -->

# Logger

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/logger.ts` (line 43)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `setStage` | `setStage(stage: string)` | `void` |
| `clearStage` | `clearStage()` | `void` |
| `debug` | `debug(message: string, data: Record<string, unknown>)` | `void` |
| `info` | `info(message: string, data: Record<string, unknown>)` | `void` |
| `warn` | `warn(message: string, data: Record<string, unknown>)` | `void` |
| `error` | `error(message: string, error: Error, data: Record<string, unknown>)` | `void` |
| `stageStart` | `stageStart(stage: string, details: Record<string, unknown>)` | `void` |
| `stageComplete` | `stageComplete(stage: string, duration: number, details: Record<string, unknown>)` | `void` |
| `stageFailed` | `stageFailed(stage: string, error: Error, details: Record<string, unknown>)` | `void` |
| `tokenUsage` | `tokenUsage(stage: string, inputTokens: number, outputTokens: number, model: string)` | `void` |
| `child` | `child(prefix: string)` | `Logger` |

<!-- source: type-metaknowledgecategory.md -->

# MetaKnowledgeCategory

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/knowledge-reference.types.ts` (line 13)

Knowledge Reference Types

Types for the knowledge-driven meta-docs feature (Phase 1).
Used by KnowledgeClassifier and KnowledgeCollector during Stage 10
to build a reference store that Stage 14 uses for meta-doc generation.

## Definition

```ts
| 'welcome'
  | 'getting-started'
  | 'learning-paths'
  | 'help-troubleshooting'
  | 'admin-guide'
```

<!-- source: interface-slotdefinition.md -->

# SlotDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 394)

Slot definition (Vue)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `props` | `PropDefinition[]` |

<!-- source: class-trajectorylogger.md -->

# TrajectoryLogger

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/tracing/trajectory-logger.ts` (line 46)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `attach` | `attach(session: AttachableSession)` | `void` |
| `record` | `record(event: string, data: Record<string, unknown>)` | `void` |
| `getEntries` | `getEntries()` | `TrajectoryEntry[]` |
| `toJSONL` | `toJSONL()` | `string` |
| `flush` | `flush()` | `void` |
| `clear` | `clear()` | `void` |

<!-- source: constant-useronboardingtemplate.md -->

# userOnboardingTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/user-onboarding.template.ts` (line 3)

<!-- source: controller-webhookcontroller.md -->

# WebhookController

**Kind:** Controller

**Source:** `atloria-monorepo/apps/api/src/webhooks/webhook.controller.ts` (line 12)

## Relationships

- MODULE_DECLARES → `handleGitHub`
- MODULE_DECLARES → `handleGitLab`
- MODULE_DECLARES → `handleAzureDevOps`
- DEPENDS_ON → `webhookservice`

<!-- source: interface-browsersession.md -->

# BrowserSession

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 172)

Browser session for capturing screenshots

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `baseUrl` | `string` |
| `isAuthenticated` | `boolean` |
| `screenshots` | `string[]` |
| `status` | `'pending' | 'running' | 'completed' | 'failed'` |
| `startedAt` | `Date` |
| `completedAt` | `Date` |
| `error` | `string` |

<!-- source: component-codemirroreditor.md -->

# CodeMirrorEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/codemirror/CodeMirrorEditor.tsx` (line 22)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `language` | `any` | ✓ | - |
| `nodeKey` | `any` | ✓ | - |
| `code` | `any` | ✓ | - |
| `focusEmitter` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CodeMirrorEditor_1b095ce5["CodeMirrorEditor"]
    class component_CodeMirrorEditor_1b095ce5 rootComponent
```

## Relationships

- RENDERS → `Select`
- USES_HOOK → `useTranslation`
- USES_HOOK → `useCodeBlockEditorContext`
- USES_HOOK → `useCellValues`
- USES_HOOK → `useCodeMirrorRef`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: constant-convertselectiontonode.md -->

# convertSelectionToNode$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 797)

Converts the current selection to a node created by the published factory.

<!-- source: function-createunifieddiffedittool.md -->

# createUnifiedDiffEditTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/edit-file.tool.ts` (line 468)

Create an edit tool that accepts unified diff format instead of
search/replace. Better for complex, multi-site edits.

The agent provides a standard unified diff (with

## Signature

```ts
function createUnifiedDiffEditTool(options: EditFileOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `EditFileOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: api-endpoint-createversion.md -->

# createVersion

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 580)

## Endpoint

`POST /documents/:id/versions`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: component-customimage.md -->

# CustomImage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 755)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `src` | `any` | ✓ | - |
| `alt` | `any` | ✓ | - |
| `documentTitle` | `any` | ✓ | - |
| `lang` | `any` | ✓ | - |
| `node` | `any` | ✓ | - |
| `...props` | `object` | - | - |

## Diagram

```mermaid
graph TD
    component_CustomImage_4c354b47["CustomImage"]
    class component_CustomImage_4c354b47 rootComponent
```

## Relationships

- RENDERS → `ScreenshotFigure`
- RENDERS → `VideoEmbed`
- RENDERS → `VideoPlayer`

## Referenced By

- `MarkdownRenderer` (RENDERS)

<!-- source: interface-detectedworkflow.md -->

# DetectedWorkflow

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/workflow-detector.service.ts` (line 6)

Represents a detected business workflow

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `category` | `string` |
| `steps` | `WorkflowStep[]` |
| `relatedPages` | `string[]` |
| `estimatedDuration` | `string` |
| `userRoles` | `string[]` |
| `prerequisites` | `string[]` |

<!-- source: interface-entityenrichment.md -->

# EntityEnrichment

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/entity-page.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `description` | `string` |
| `diagram` | `string` |
| `example` | `string` |
| `instructions` | `string` |

<!-- source: interface-evalresult.md -->

# EvalResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-evaluator.ts` (line 33)

Result from the Docker evaluation harness

## Properties

| Property | Type |
|---|---|
| `instanceId` | `string` |
| `resolved` | `boolean` |
| `details` | `Record<string, unknown>` |

<!-- source: function-extractpermissions.md -->

# extractPermissions

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/permission-extractor.ts` (line 378)

Extract all permission checks from code and template.

## Signature

```ts
function extractPermissions(code: string, templateContent: string | undefined, filePath: string, componentName: string, framework: 'angular' | 'vue' | 'react'): PermissionCheck[]
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |
| `templateContent` | `string | undefined` |
| `filePath` | `string` |
| `componentName` | `string` |
| `framework` | `'angular' | 'vue' | 'react'` |

**Returns:** `PermissionCheck[]`

<!-- source: function-extractsourcecode.md -->

# extractSourceCode

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/services/entity-mapper.service.ts` (line 356)

Extract source code lines from a file (1-indexed, inclusive).

## Signature

```ts
function extractSourceCode(fileCache: FileCache, absolutePath: string, startLine: number, endLine: number): string | undefined
```

## Parameters

| Name | Type |
|---|---|
| `fileCache` | `FileCache` |
| `absolutePath` | `string` |
| `startLine` | `number` |
| `endLine` | `number` |

**Returns:** `string | undefined`

<!-- source: class-generateuserdocsdto.md -->

# GenerateUserDocsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/documentation/dto/generate-user-docs.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `appMap` | `any` |
| `screenshots` | `Record<string, any[]>` |
| `businessContext` | `{
    marketing: string[];
    workflows: string[];
    brand: string[];
    processes: string[];
  }` |
| `workflows` | `string[]` |
| `enableReviewer` | `boolean` |
| `generatorProvider` | `'azure-claude' | 'azure-openai'` |
| `reviewerProvider` | `'azure-claude' | 'azure-openai'` |
| `projectId` | `string` |
| `enableCompetitorResearch` | `boolean` |
| `projectType` | `string` |
| `projectDescription` | `string` |
| `saveIncremental` | `boolean` |

<!-- source: function-getusercolorwithopacity.md -->

# getUserColorWithOpacity

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/user-colors.ts` (line 127)

Get a CSS color string with opacity for a user

## Signature

```ts
function getUserColorWithOpacity(userId: string, opacity: number): string
```

## Parameters

| Name | Type |
|---|---|
| `userId` | `string` |
| `opacity` | `number` |

**Returns:** `string`

<!-- source: service-githubappservice.md -->

# GithubAppService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/github-app/github-app.service.ts` (line 15)

Foundation F1: the Atloria GitHub App. One app, installed per customer org/personal
account with per-install repo grants — GitHub enforces tenant isolation, tokens are
org-owned (survive employee churn), and webhooks arrive tagged with the installation.
Unlocks: one-click public-repo trial, self-serve onboarding, freshness at scale.

Env: GITHUB_APP_ID, GITHUB_APP_PRIVATE_KEY (PEM, \n-escaped), GITHUB_APP_WEBHOOK_SECRET.

`GithubAppService` encapsulates Atloria’s GitHub App (“Foundation F1”) integration: creating and using installation-scoped credentials, validating webhook authenticity, and interacting with GitHub on behalf of a specific customer org/user installation. It relies on GitHub’s installation model to enforce tenant isolation (per-install repo grants) and to ensure tokens are org-owned (survive employee churn), enabling self-serve onboarding, public-repo trials, and scalable data freshness.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `installationToken` | `installationToken(installationId: number | bigint)` | `Promise<string>` |
| `cloneCredentialsFor` | `cloneCredentialsFor(repoUrl: string)` | `Promise<{ username: string; password: string } | null>` |
| `verifySignature` | `verifySignature(signature: string | undefined, rawBody: string | Buffer | undefined)` | `void` |
| `handleInstallationEvent` | `handleInstallationEvent(action: string, payload: any)` | `Promise<void>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant GH as GitHub
  participant API as Atloria API (Webhook Controller)
  participant GAS as GithubAppService
  participant GHA as GitHub API

  GH->>API: Webhook event (X-Hub-Signature-256, installation.id, payload)
  API->>GAS: verifyWebhookSignature(rawBody, headers)
  GAS-->>API: ok / throw (invalid signature)

  API->>GAS: getInstallationClient(installationId)
  GAS->>GH: Create JWT (app id + private key)
  GAS->>GHA: POST /app/installations/{id}/access_tokens (JWT)
  GHA-->>GAS: installation access token (scoped to granted repos)
  GAS-->>API: Octokit client (auth = installation token)

  API->>GHA: GitHub API calls via client (repos, pulls, commits, etc.)
  GHA-->>API: responses (tenant-isolated by installation grants)
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import type { Request } from 'express';
import { GithubAppService } from './github-app.service';

@Injectable()
export class GithubWebhookHandler {
  constructor(private readonly githubApp: GithubAppService) {}

  async handle(req: Request) {
    // IMPORTANT: signature verification typically needs the raw request body
    // Ensure your Nest/Express setup preserves rawBody for webhook routes.
    await this.githubApp.verifyWebhookSignature(
      // @ts-expect-error depends on your raw body middleware
      req.rawBody ?? Buffer.from(JSON.stringify(req.body)),
      req.headers,
    );

    const installationId = req.body?.installation?.id;
    if (!installationId) throw new Error('Missing installation.id in webhook payload');

    const octokit = await this.githubApp.getInstallationClient(installationId);

    // Example: list repos accessible to this installation (tenant-scoped)
    const { data } = await octokit.apps.listReposAccessibleToInstallation();
    return data.repositories.map(r => ({ id: r.id, full_name: r.full_name }));
  }
}
```

## AI Coding Instructions

- Always operate “per installation”: require `installation.id` (from webhook payload or stored mapping) and use installation-scoped tokens/clients; never use a user PAT for backend GitHub operations.
- Webhook verification must use the exact raw bytes of the request body (before JSON parsing/mutation) with `GITHUB_APP_WEBHOOK_SECRET`; failing to preserve `rawBody` is a common pitfall.
- `GITHUB_APP_PRIVATE_KEY` is PEM with `\n`-escaped newlines—normalize it (replace `\\n` with `\n`) before signing JWTs, or token creation will fail.
- Treat installation access tokens as short-lived; do not persist them long-term—recreate via the app JWT flow when needed and handle 401/403 by refreshing.
- Keep tenant isolation intact: never broaden repo access in code; rely on GitHub’s per-installation grants and ensure all queries are made through the installation-authenticated Octokit instance.

## Relationships

- DEPENDS_ON → `configservice`
- DEPENDS_ON → `prismaservice`

<!-- source: interface-managedconnector.md -->

# ManagedConnector

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/lib/api-client.ts` (line 27)

F3 managed connector — client-safe view (never carries the stored config/credentials).

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `type` | `'ZENDESK' | 'INTERCOM' | 'URL'` |
| `enabled` | `boolean` |
| `syncIntervalMinutes` | `number` |
| `status` | `'idle' | 'syncing' | 'ok' | 'error'` |
| `lastError` | `string | null` |
| `lastSyncedAt` | `string | null` |
| `lastItemCount` | `number | null` |
| `cursor` | `string | null` |
| `hasConfig` | `boolean` |
| `createdAt` | `string` |

<!-- source: class-markdownparseerror.md -->

# MarkdownParseError

**Kind:** Class

**Source:** `atloria-monorepo/packages/editor/src/importMarkdownToLexical.ts` (line 162)

An error that gets thrown when the Markdown parsing fails due to a syntax error.

**Extends:** `Error`

<!-- source: type-modalclosemethod-2.md -->

# ModalCloseMethod

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 18)

How a modal should be closed

## Definition

```ts
'button-text' | 'data-dismiss' | 'escape' | 'backdrop' | 'auto'
```

<!-- source: interface-statemanagementinfo.md -->

# StateManagementInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 405)

State management information

## Properties

| Property | Type |
|---|---|
| `type` | `'useState' | 'useReducer' | 'context' | 'redux' | 'zustand' | 'pinia' | 'other'` |
| `stores` | `string[]` |
| `actions` | `string[]` |
| `selectors` | `string[]` |

<!-- source: constant-userstorytemplate.md -->

# userStoryTemplate

**Kind:** Constant

**Source:** `atloria-monorepo/apps/api/src/template/seeds/user-story.template.ts` (line 3)

<!-- source: class-vectorstore.md -->

# VectorStore

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/vector-store.ts` (line 62)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `load` | `load()` | `void` |
| `save` | `save()` | `void` |
| `upsert` | `upsert(chunks: CodeChunk[])` | `void` |
| `remove` | `remove(chunkIds: string[])` | `void` |
| `removeByFile` | `removeByFile(files: string[])` | `void` |
| `getAll` | `getAll()` | `CodeChunk[]` |
| `getByFile` | `getByFile(file: string)` | `CodeChunk[]` |
| `vectorSearch` | `vectorSearch(queryEmbedding: number[], topK: number)` | `Array<{ chunk: CodeChunk; score: number }>` |
| `getMerkle` | `getMerkle()` | `Map<string, string>` |
| `setMerkle` | `setMerkle(merkle: Map<string, string>)` | `void` |

<!-- source: interface-businesscontext-2.md -->

# BusinessContext

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/orchestrator.ts` (line 58)

Structured business context extracted from client-provided sources
(PDF brochure, marketing website, competitor docs, markdown files).

Extracted by the agent pre-pipeline and injected into AI prompts
across Stages 4-10 to ensure generated docs use correct business
terminology, personas, and workflow descriptions.

## Properties

| Property | Type |
|---|---|
| `productName` | `string` |
| `productTagline` | `string` |
| `productDescription` | `string` |
| `domain` | `string` |
| `personas` | `{ name: string; description: string }[]` |
| `features` | `{ name: string; description: string; category?: string }[]` |
| `glossary` | `{ term: string; definition: string }[]` |
| `workflows` | `{ name: string; steps: string[]; description?: string }[]` |
| `tone` | `string` |
| `rawContext` | `string` |
| `sources` | `{ type: 'pdf' | 'url' | 'file' | 'text'; path: string }[]` |

<!-- source: component-codetoggle.md -->

# CodeToggle

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/CodeToggle.tsx` (line 12)

## Diagram

```mermaid
graph TD
    component_CodeToggle_537b2e77["CodeToggle"]
    class component_CodeToggle_537b2e77 rootComponent
```

## Relationships

- RENDERS → `MultipleChoiceToggleGroup`
- USES_HOOK → `useCellValues`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useTranslation`

<!-- source: constant-coreplugin.md -->

# corePlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 932)

<!-- source: function-createwebfetchtool.md -->

# createWebFetchTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/web-fetch.tool.ts` (line 25)

## Signature

```ts
function createWebFetchTool(options: WebFetchOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `WebFetchOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: api-endpoint-csat.md -->

# csat

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/public-issues.controller.ts` (line 41)

## Endpoint

`POST /public/issues/:projectSlugId/:ticketNumber/csat`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectSlugId` | query | `string` | ✓ |
| `ticketNumber` | query | `number` | ✓ |

## Referenced By

- `PublicIssuesController` (MODULE_DECLARES)

<!-- source: component-customtooltip.md -->

# CustomTooltip

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/DonutChart.tsx` (line 34)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `active` | `any` | ✓ | - |
| `payload` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomTooltip_6863ed1["CustomTooltip"]
    class component_CustomTooltip_6863ed1 rootComponent
```

## Referenced By

- `DonutChart` (RENDERS)

<!-- source: interface-diffchange.md -->

# DiffChange

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/dto/compare-document.dto.ts` (line 55)

Single diff change

## Properties

| Property | Type |
|---|---|
| `type` | `DiffChangeType` |
| `value` | `string` |
| `lineNumber` | `number` |

<!-- source: interface-entitypagecontext.md -->

# EntityPageContext

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/entity-page.ts` (line 31)

## Properties

| Property | Type |
|---|---|
| `relationships` | `Relationship[]` |
| `allEntities` | `Entity[]` |
| `enrichment` | `EntityEnrichment` |
| `sourceLinkBase` | `string` |
| `nameResolver` | `(id: string) => string` |
| `outgoingBySource` | `Map<string, Relationship[]>` |
| `incomingByTarget` | `Map<string, Relationship[]>` |

<!-- source: function-extractpermissionsfromcode.md -->

# extractPermissionsFromCode

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/permission-extractor.ts` (line 75)

Extract permission checks from TypeScript/JavaScript source code.

Detects:
- Route guard references (canActivate, canLoad, etc.)
- Permission checking method calls (hasPermission, can, isAuthorized)
- Role-based checks (hasRole, isAdmin, role === 'admin')
- Decorator-based permissions (@Roles,

## Signature

```ts
function extractPermissionsFromCode(code: string, filePath: string, componentName: string): PermissionCheck[]
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |
| `filePath` | `string` |
| `componentName` | `string` |

**Returns:** `PermissionCheck[]`

<!-- source: interface-failureanalysis.md -->

# FailureAnalysis

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/benchmark-monitor.ts` (line 65)

## Properties

| Property | Type |
|---|---|
| `totalTasks` | `number` |
| `passed` | `number` |
| `failed` | `number` |
| `timedOut` | `number` |
| `passRate` | `number` |
| `byCategory` | `Record<string, number>` |
| `correctAreaButFailed` | `TaskResult[]` |
| `noChanges` | `TaskResult[]` |
| `timedOutWithChanges` | `TaskResult[]` |
| `patterns` | `FailurePattern[]` |
| `toolComparison` | `{
    passing: Record<string, number>;
    failing: Record<string, number>;
  }` |
| `avgTurns` | `{ passing: number; failing: number }` |
| `summary` | `string` |

<!-- source: function-fromwithineditorread.md -->

# fromWithinEditorRead

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/lexicalHelpers.ts` (line 17)

Fetches a value from the Lexical editor read cycle.

## Signature

```ts
function fromWithinEditorRead(editor: LexicalEditor, fn: () => T): T
```

## Parameters

| Name | Type |
|---|---|
| `editor` | `LexicalEditor` |
| `fn` | `() => T` |

**Returns:** `T`

<!-- source: function-getwebsocketclient.md -->

# getWebSocketClient

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/websocket-client.ts` (line 297)

Get or create WebSocket client instance

## Signature

```ts
function getWebSocketClient(apiUrl: string): AtloriaWebSocketClient
```

## Parameters

| Name | Type |
|---|---|
| `apiUrl` | `string` |

**Returns:** `AtloriaWebSocketClient`

<!-- source: service-githubservice.md -->

# GitHubService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/github/github.service.ts` (line 5)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getAuthUrl` | `getAuthUrl(userId: string)` | `string` |
| `handleCallback` | `handleCallback(code: string, userId: string)` | `Promise<void>` |
| `getConnectionStatus` | `getConnectionStatus(userId: string)` | `Promise<{ connected: boolean; username: string | null }>` |
| `listRepos` | `listRepos(userId: string)` | `Promise<any[]>` |
| `listBranches` | `listBranches(userId: string, owner: string, repo: string)` | `Promise<any[]>` |
| `disconnect` | `disconnect(userId: string)` | `Promise<void>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `configservice`

<!-- source: class-improvetextdto.md -->

# ImproveTextDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/ai/dto/improve-text.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `text` | `string` |
| `provider` | `string` |

<!-- source: class-megafileindexer.md -->

# MegaFileIndexer

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/mega-file-indexer.ts` (line 47)

Mega File Indexer - Handles extremely large files with phased extraction

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectMegaFile` | `detectMegaFile(filePath: string)` | `Promise<MegaFileDetectionResult>` |
| `createIndex` | `createIndex(filePath: string)` | `Promise<MegaFileIndex>` |
| `extractAllPhases` | `extractAllPhases(filePath: string)` | `Promise<MegaFilePhaseExtractionResult>` |
| `loadSection` | `loadSection(filePath: string, startLine: number, endLine: number)` | `Promise<string>` |
| `loadEntity` | `loadEntity(index: MegaFileIndex, entityName: string)` | `Promise<string | null>` |

<!-- source: interface-memberuser.md -->

# MemberUser

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useProjectMembers.ts` (line 10)

Member type for

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `email` | `string` |
| `avatar` | `string | null` |
| `role` | `string` |

<!-- source: type-modaltriggertype-2.md -->

# ModalTriggerType

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 15)

InteractionMap Types

Defines the structure for source-code-derived interaction maps
that catalog all modals, tabs, forms, permissions, and workflow states
per route/component. Used by the hybrid screenshot mapper to generate
deterministic capture specs instead of AI guessing.

## Definition

```ts
'direct' | 'programmatic' | 'navigation'
```

<!-- source: interface-syncresult.md -->

# SyncResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/knowledge-graph/sync/kg-sync.service.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `entitiesCreated` | `number` |
| `entitiesUpdated` | `number` |
| `relationshipsCreated` | `number` |
| `errors` | `string[]` |
| `duration` | `number` |

<!-- source: class-verboselogger.md -->

# VerboseLogger

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/session/verbose-logger.ts` (line 47)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `setVerbose` | `setVerbose(enabled: boolean)` | `void` |
| `isVerbose` | `isVerbose()` | `boolean` |
| `resetCounters` | `resetCounters()` | `void` |

<!-- source: interface-buttonprofile.md -->

# ButtonProfile

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/site-map.types.ts` (line 28)

## Properties

| Property | Type |
|---|---|
| `text` | `string` |
| `selector` | `string` |
| `isEnabled` | `boolean` |

<!-- source: component-comparisonfeaturetable-2.md -->

# ComparisonFeatureTable

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/comparison/comparison-feature-table.tsx` (line 21)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `columns` | `unknown[]` | ✓ | - |
| `features` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ComparisonFeatureTable_1c03ffe1["ComparisonFeatureTable"]
    class component_ComparisonFeatureTable_1c03ffe1 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `ComparisonRow`
- USES_HOOK → `useTranslation`

<!-- source: constant-countup.md -->

# countUp

**Kind:** Constant

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/animations.ts` (line 82)

Animated number counter — for stats sections

## Definition

```ts
Variants
```

<!-- source: function-createwebsearchtool.md -->

# createWebSearchTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/web-search.tool.ts` (line 75)

## Signature

```ts
function createWebSearchTool(options: WebSearchOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `WebSearchOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: component-customtooltip-2.md -->

# CustomTooltip

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/TimeSeriesChart.tsx` (line 32)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `active` | `any` | ✓ | - |
| `payload` | `any` | ✓ | - |
| `label` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomTooltip_64b1f87["CustomTooltip"]
    class component_CustomTooltip_64b1f87 rootComponent
```

## Referenced By

- `TimeSeriesChart` (RENDERS)

<!-- source: api-endpoint-deflection.md -->

# deflection

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/manuals-insights/manuals-insights.controller.ts` (line 25)

## Endpoint

`GET /manuals-insights/:projectId/deflection`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `ManualsInsightsController` (MODULE_DECLARES)

<!-- source: interface-diffstats.md -->

# DiffStats

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/doc-version/version-diff.service.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `linesA` | `number` |
| `linesB` | `number` |
| `linesAdded` | `number` |
| `linesRemoved` | `number` |
| `changePercent` | `number` |

<!-- source: interface-entitypath-2.md -->

# EntityPath

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/relationship.interface.ts` (line 306)

Graph path between entities

## Properties

| Property | Type |
|---|---|
| `startId` | `string` |
| `endId` | `string` |
| `relationships` | `Relationship[]` |
| `entityIds` | `string[]` |
| `length` | `number` |

<!-- source: function-extractpermissionsfromtemplate.md -->

# extractPermissionsFromTemplate

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/permission-extractor.ts` (line 187)

Extract permission checks from HTML templates.

Detects:
- Angular: *ngIf="hasPermission('x')", *ngIf="can('x')", *ngIf="isAdmin"
- Vue: v-if="hasPermission('x')", v-show="can('x')"
- React: {hasPermission('x') && <Component />}

## Signature

```ts
function extractPermissionsFromTemplate(templateContent: string, filePath: string, componentName: string, framework: 'angular' | 'vue' | 'react'): PermissionCheck[]
```

## Parameters

| Name | Type |
|---|---|
| `templateContent` | `string` |
| `filePath` | `string` |
| `componentName` | `string` |
| `framework` | `'angular' | 'vue' | 'react'` |

**Returns:** `PermissionCheck[]`

<!-- source: interface-failurepattern.md -->

# FailurePattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/benchmark-monitor.ts` (line 54)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `count` | `number` |
| `taskIds` | `string[]` |
| `suggestion` | `string` |

<!-- source: function-generateslug-2.md -->

# generateSlug

**Kind:** Function

**Source:** `atloria-monorepo/packages/core/src/utils/slug.ts` (line 8)

Utility functions for generating and validating slugs

## Signature

```ts
function generateSlug(text: string): string
```

## Parameters

| Name | Type |
|---|---|
| `text` | `string` |

**Returns:** `string`

<!-- source: service-gitlabservice.md -->

# GitLabService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/gitlab/gitlab.service.ts` (line 5)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getAuthUrl` | `getAuthUrl(userId: string)` | `string` |
| `handleCallback` | `handleCallback(code: string, userId: string)` | `Promise<void>` |
| `getConnectionStatus` | `getConnectionStatus(userId: string)` | `Promise<{ connected: boolean; username: string | null }>` |
| `listRepos` | `listRepos(userId: string)` | `Promise<any[]>` |
| `listBranches` | `listBranches(userId: string, owner: string, repo: string)` | `Promise<any[]>` |
| `disconnect` | `disconnect(userId: string)` | `Promise<void>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `configservice`

<!-- source: function-hashcolor.md -->

# hashColor

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 61)

## Signature

```ts
function hashColor(str: string): string
```

## Parameters

| Name | Type |
|---|---|
| `str` | `string` |

**Returns:** `string`

<!-- source: class-invitememberdto.md -->

# InviteMemberDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/organization/dto/invite-member.dto.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `email` | `string` |
| `role` | `UserRole` |

<!-- source: interface-menuconfig.md -->

# MenuConfig

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/BrandingContext.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `bgColor` | `string` |
| `textColor` | `string` |
| `height` | `number` |
| `borderColor` | `string` |
| `borderStyle` | `'solid' | 'none' | 'shadow'` |

<!-- source: class-metricscollector.md -->

# MetricsCollector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/pipeline-metrics.ts` (line 134)

Mutable collector that stages push data into during the run.
Call `toJSON()` at the end to get the final snapshot.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `stageStart` | `stageStart(name: string)` | `void` |
| `stageEnd` | `stageEnd(name: string, status: 'success' | 'failed' | 'skipped')` | `void` |
| `addTokenUsage` | `addTokenUsage(stage: string, input: number, output: number)` | `void` |
| `addScreenshotFailure` | `addScreenshotFailure(url: string, reason: string)` | `void` |
| `addQualityScore` | `addQualityScore(docId: string, title: string, score: number, passed: boolean)` | `void` |
| `addVerificationScore` | `addVerificationScore(docId: string, title: string, accuracy: number, claims: number, flagged: number)` | `void` |
| `toJSON` | `toJSON()` | `PipelineMetrics` |

## Properties

| Property | Type |
|---|---|
| `tokens` | `PipelineMetrics['tokens']` |
| `screenshots` | `PipelineMetrics['screenshots']` |
| `quality` | `PipelineMetrics['quality']` |
| `extraction` | `PipelineMetrics['extraction']` |
| `documents` | `PipelineMetrics['documents']` |

<!-- source: type-pagetype-2.md -->

# PageType

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/site-map.types.ts` (line 63)

## Definition

```ts
'list' | 'detail' | 'form' | 'dashboard' | 'settings' | 'report' | 'unknown'
```

<!-- source: interface-uniqueconstraint.md -->

# UniqueConstraint

**Kind:** Interface

**Source:** `atloria-monorepo/apps/parser-orchestrator/src/interfaces/entity.interface.ts` (line 723)

Unique constraint definition

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `fields` | `string[]` |

<!-- source: class-vercelaimodelprovider.md -->

# VercelAIModelProvider

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/vercel-ai-adapter.ts` (line 33)

**Implements:** `IModelProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getResponse` | `getResponse(request: ModelProviderRequest)` | `Promise<ModelProviderResponse>` |
| `getStreamedResponse` | `getStreamedResponse(request: ModelProviderRequest)` | `AsyncIterable<unknown>` |
| `getProfile` | `getProfile()` | `ModelCapabilityProfile` |

<!-- source: interface-captureconfig.md -->

# CaptureConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 202)

Configuration for the capture service

## Properties

| Property | Type |
|---|---|
| `outputDir` | `string` |
| `maxConcurrentSessions` | `number` |
| `maxRetries` | `number` |
| `retryDelayMs` | `number` |
| `screenshotTimeout` | `number` |
| `sessionTimeout` | `number` |
| `auth` | `AuthConfig` |

<!-- source: component-comparisonrow-2.md -->

# ComparisonRow

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/comparison-row.tsx` (line 16)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `featureKey` | `string` | ✓ | - |
| `values` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ComparisonRow_23b8f7bc["ComparisonRow"]
    class component_ComparisonRow_23b8f7bc rootComponent
```

## Relationships

- RENDERS → `Check`
- RENDERS → `X`
- USES_HOOK → `useTranslation`

<!-- source: constant-createactiveeditorsubscription.md -->

# createActiveEditorSubscription$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 666)

<!-- source: function-createworktreecontroltools.md -->

# createWorktreeControlTools

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/worktree-control.tool.ts` (line 29)

## Signature

```ts
function createWorktreeControlTools(options: WorktreeControlOptions): WorktreeControlTools<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `WorktreeControlOptions` |

**Returns:** `WorktreeControlTools<TContext>`

<!-- source: component-dailybarchart.md -->

# DailyBarChart

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/page.tsx` (line 225)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `data` | `TrendPoint[]` | ✓ | - |
| `height` | `number` | - | 240 |

## Diagram

```mermaid
graph TD
    component_DailyBarChart_24135fa3["DailyBarChart"]
    class component_DailyBarChart_24135fa3 rootComponent
```

## Relationships

- RENDERS → `ResponsiveContainer`
- RENDERS → `BarChart`
- RENDERS → `CartesianGrid`
- RENDERS → `XAxis`
- RENDERS → `YAxis`
- RENDERS → `RTooltip`
- RENDERS → `Bar`

## Referenced By

- `IssuesListPage` (RENDERS)

<!-- source: api-endpoint-delete.md -->

# delete

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/audience/audience.controller.ts` (line 100)

## Endpoint

`DELETE /audiences/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `AudienceController` (MODULE_DECLARES)

<!-- source: interface-dnsrecordspec-2.md -->

# DnsRecordSpec

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/project/domain-dns.service.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `type` | `'CNAME' | 'TXT'` |
| `name` | `string` |
| `expected` | `string` |

<!-- source: interface-entityrelationship.md -->

# EntityRelationship

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 92)

## Properties

| Property | Type |
|---|---|
| `sourceEntity` | `string` |
| `targetEntity` | `string` |
| `relationshipType` | `'one-to-many' | 'many-to-one' | 'one-to-one' | 'many-to-many'` |
| `propertyName` | `string` |
| `filePath` | `string` |
| `lineNumber` | `number` |

<!-- source: function-extractpropsfromparameter-2.md -->

# extractPropsFromParameter

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 187)

Extract props from a function component's first parameter

## Signature

```ts
function extractPropsFromParameter(param: t.Node | null | undefined, typeDefinitions: TypeDefinitionMap): PropInfo[]
```

## Parameters

| Name | Type |
|---|---|
| `param` | `t.Node | null | undefined` |
| `typeDefinitions` | `TypeDefinitionMap` |

**Returns:** `PropInfo[]`

<!-- source: interface-filelocalization.md -->

# FileLocalization

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/types.ts` (line 61)

File localization metrics for a single task result.

## Properties

| Property | Type |
|---|---|
| `filesEdited` | `string[]` |
| `expectedFiles` | `string[]` |
| `overlap` | `string[]` |
| `recall` | `number` |
| `precision` | `number` |

<!-- source: function-generateusers.md -->

# generateUsers

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/examples/assets/dataCode.ts` (line 32)

## Signature

```ts
function generateUsers(length: number, startIndex)
```

## Parameters

| Name | Type |
|---|---|
| `length` | `number` |
| `startIndex` | `any` |

<!-- source: function-htmltomarkdown.md -->

# htmlToMarkdown

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/markdown-converter.ts` (line 28)

Convert HTML to Markdown

## Signature

```ts
function htmlToMarkdown(html: string): string
```

## Parameters

| Name | Type |
|---|---|
| `html` | `string` |

**Returns:** `string`

<!-- source: service-invitationservice.md -->

# InvitationService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/invitation/invitation.service.ts` (line 38)

Invitation-token flow — the ONLY path into an existing organization.
(Open registration always creates a fresh org; see AuthService.register.)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `create` | `create(organizationId: string, dto: CreateInvitationDto, user: JwtPayload)` | `unknown` |
| `getByToken` | `getByToken(token: string)` | `unknown` |
| `accept` | `accept(token: string, dto: AcceptInvitationDto)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `emailservice`
- DEPENDS_ON → `configservice`

<!-- source: class-javascriptparser.md -->

# JavaScriptParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/parser/parsers/javascript.parser.ts` (line 17)

**Implements:** `CodeParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `parse` | `parse(code: string, _filename: undefined)` | `Promise<ParseResult>` |
| `extractSymbols` | `extractSymbols(code: string)` | `Promise<ParserSymbol[]>` |
| `extractDependencies` | `extractDependencies(code: string)` | `Promise<Dependency[]>` |

## Properties

| Property | Type |
|---|---|
| `language` | `any` |
| `supportedExtensions` | `any` |

<!-- source: interface-metriccardprops.md -->

# MetricCardProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/MetricCard.tsx` (line 8)

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `value` | `number | null | undefined` |
| `previousValue` | `number | null` |
| `format` | `'number' | 'percent' | 'duration'` |
| `trend` | `number[]` |
| `icon` | `React.ReactNode` |
| `accent` | `string` |
| `onClick` | `() => void` |
| `loading` | `boolean` |

<!-- source: class-nestjsdetector.md -->

# NestJSDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/nestjs-detector.ts` (line 98)

NestJS Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectControllers` | `detectControllers(entities: Entity[])` | `DetectedNestJSController[]` |
| `detectServices` | `detectServices(entities: Entity[])` | `DetectedNestJSService[]` |
| `getControllerSummary` | `getControllerSummary(controller: DetectedNestJSController)` | `string` |

<!-- source: type-personaclassification.md -->

# PersonaClassification

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 126)

## Definition

```ts
'admin' | 'user'
```

<!-- source: class-watchmode.md -->

# WatchMode

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/tools/watch-mode.ts` (line 28)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `start` | `start()` | `MarkerResult[]` |
| `stop` | `stop()` | `void` |
| `scanFile` | `scanFile(filePath: string)` | `MarkerResult[]` |
| `scanDirectory` | `scanDirectory(dirPath: string)` | `MarkerResult[]` |

<!-- source: interface-capturedscreenshot.md -->

# CapturedScreenshot

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 241)

Captured screenshot with hashes for deduplication

## Properties

| Property | Type |
|---|---|
| `placeholderId` | `string` |
| `description` | `string` |
| `localPath` | `string` |
| `blobUrl` | `string` |
| `contentHash` | `string` |
| `perceptualHash` | `string` |
| `dimensions` | `{ width: number; height: number }` |
| `fileSize` | `number` |
| `format` | `'png' | 'jpeg' | 'webp'` |
| `capturedAt` | `Date` |
| `uploadedAt` | `Date` |
| `isNew` | `boolean` |
| `reusedFromId` | `string` |
| `reusedFromUrl` | `string` |
| `parentPlaceholderId` | `string` |
| `sequenceOrder` | `number` |

<!-- source: component-comparisonsidebyside-2.md -->

# ComparisonSideBySide

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/comparison/comparison-side-by-side.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `before` | `ComparisonColumn` | ✓ | - |
| `after` | `ComparisonColumn` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ComparisonSideBySide_1034af54["ComparisonSideBySide"]
    class component_ComparisonSideBySide_1034af54 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `X`
- RENDERS → `Check`
- USES_HOOK → `useTranslation`

<!-- source: constant-createrooteditorsubscription.md -->

# createRootEditorSubscription$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 540)

<!-- source: function-createwritefiletool.md -->

# createWriteFileTool

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/write-file.tool.ts` (line 25)

## Signature

```ts
function createWriteFileTool(options: WriteFileOptions): ToolDefinition<TContext>
```

## Parameters

| Name | Type |
|---|---|
| `options` | `WriteFileOptions` |

**Returns:** `ToolDefinition<TContext>`

<!-- source: api-endpoint-delete-2.md -->

# delete

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/comment/comment.controller.ts` (line 174)

Delete a comment

## Endpoint

`DELETE /documents/:documentId/comments/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `CommentController` (MODULE_DECLARES)

<!-- source: component-demoterminal.md -->

# DemoTerminal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/page.tsx` (line 88)

## Diagram

```mermaid
graph TD
    component_DemoTerminal_27cbe349["DemoTerminal"]
    class component_DemoTerminal_27cbe349 rootComponent
```

## Relationships

- RENDERS → `motion-span`
- RENDERS → `motion-div`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

## Referenced By

- `HomePage` (RENDERS)

<!-- source: interface-docdiffentry.md -->

# DocDiffEntry

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/doc-version/version-diff.service.ts` (line 12)

## Properties

| Property | Type |
|---|---|
| `slug` | `string` |
| `title` | `string` |
| `type` | `string` |
| `source` | `string` |
| `docId` | `string` |
| `docIdA` | `string` |
| `docIdB` | `string` |
| `titleChanged` | `boolean` |
| `previousTitle` | `string` |
| `contentDiffStats` | `DiffStats` |

<!-- source: interface-enumvalue.md -->

# EnumValue

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 86)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `value` | `number | string` |
| `description` | `string` |

<!-- source: function-extractpropsfromtypeannotation-2.md -->

# extractPropsFromTypeAnnotation

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 267)

Extract props from TypeScript type annotation

## Signature

```ts
function extractPropsFromTypeAnnotation(typeNode: t.TSType, typeDefinitions: TypeDefinitionMap): PropInfo[]
```

## Parameters

| Name | Type |
|---|---|
| `typeNode` | `t.TSType` |
| `typeDefinitions` | `TypeDefinitionMap` |

**Returns:** `PropInfo[]`

<!-- source: function-getglobalratelimiter.md -->

# getGlobalRateLimiter

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/rate-limiter.ts` (line 173)

Get or create a global rate limiter instance

## Signature

```ts
function getGlobalRateLimiter(config: Partial<RateLimiterConfig>): RateLimiter
```

## Parameters

| Name | Type |
|---|---|
| `config` | `Partial<RateLimiterConfig>` |

**Returns:** `RateLimiter`

<!-- source: interface-gitbackendconfig.md -->

# GitBackendConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/git-backend.ts` (line 27)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `sessionId` | `string` |
| `staleAgeDays` | `number` |

<!-- source: function-isemptyfilters.md -->

# isEmptyFilters

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 38)

## Signature

```ts
function isEmptyFilters(f: BoardFiltersState): boolean
```

## Parameters

| Name | Type |
|---|---|
| `f` | `BoardFiltersState` |

**Returns:** `boolean`

<!-- source: service-issuesservice.md -->

# IssuesService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/issues/issues.service.ts` (line 32)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createPublic` | `createPublic(dto: CreateIssueDto)` | `unknown` |
| `createFromChatEscalation` | `createFromChatEscalation(input: {
    projectId: string;
    chatSessionId: string;
    question: string;
    transcript: Array<{ role: string; content: string }>;
    reporterEmail?: string;
    pageUrl?: string;
  })` | `unknown` |
| `getPublicTicket` | `getPublicTicket(projectSlugId: string, ticketNumber: number)` | `unknown` |
| `addCustomerReply` | `addCustomerReply(projectSlugId: string, ticketNumber: number, input: { body: string; reporterSessionId: string })` | `unknown` |
| `recordTicketCsat` | `recordTicketCsat(projectSlugId: string, ticketNumber: number, score: number)` | `unknown` |
| `notifyReporterResolved` | `notifyReporterResolved(projectId: string, issue: {
      ticketNumber: number;
      reporterEmail: string | null;
      pageTitle: string | null;
      category: string;
      priority: string;
      description: string;
      closedReason?: string | null;
    })` | `unknown` |
| `list` | `list(projectId: string, user: JwtPayload, params: {
      status?: string;
      category?: string;
      ticketType?: string;
      priority?: string;
      assigneeId?: string;
      search?: string;
      sortBy?: string;
      sortOrder?: string;
      page?: number;
      limit?: number;
    })` | `unknown` |
| `getStats` | `getStats(projectId: string, user: JwtPayload)` | `unknown` |
| `getOne` | `getOne(projectId: string, issueId: string, user: JwtPayload)` | `unknown` |
| `update` | `update(projectId: string, issueId: string, dto: UpdateIssueDto, user: JwtPayload)` | `unknown` |
| `bulkUpdate` | `bulkUpdate(projectId: string, dto: BulkUpdateIssuesDto, user: JwtPayload)` | `unknown` |
| `addComment` | `addComment(projectId: string, issueId: string, dto: CreateIssueCommentDto, user: JwtPayload, opts: { suppressAutoTransition?: boolean })` | `unknown` |
| `getDuplicates` | `getDuplicates(projectId: string, issueId: string, user: JwtPayload)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `emailservice`
- DEPENDS_ON → `eventsservice`

<!-- source: class-jobfiltersdto.md -->

# JobFiltersDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/documentation/dto/doc-automation.dto.ts` (line 554)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `status` | `string` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: interface-navdoc.md -->

# NavDoc

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/PrevNextNav.tsx` (line 8)

## Properties

| Property | Type |
|---|---|
| `slug` | `string` |
| `title` | `string` |

<!-- source: class-networkerror.md -->

# NetworkError

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/types/errors.ts` (line 19)

Network error (connection issues, timeouts, etc.)

**Extends:** `APIError`

<!-- source: type-providerfamily.md -->

# ProviderFamily

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/prompt-adapter.ts` (line 15)

## Definition

```ts
'claude' | 'gpt'
```

<!-- source: class-websockettransport.md -->

# WebSocketTransport

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/protocol/websocket-transport.ts` (line 45)

**Implements:** `AgentTransport`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `handleEvent` | `handleEvent(event: AgentProtocolEvent)` | `void` |

<!-- source: interface-captureprogress.md -->

# CaptureProgress

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-capturer.service.ts` (line 27)

Progress callback for capture operations

## Properties

| Property | Type |
|---|---|
| `completed` | `number` |
| `total` | `number` |
| `currentItem` | `string` |
| `currentGroup` | `string` |

<!-- source: component-conditionalcontents.md -->

# ConditionalContents

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/toolbar.tsx` (line 296)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `options` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ConditionalContents_51c33312["ConditionalContents"]
    class component_ConditionalContents_51c33312 rootComponent
```

## Relationships

- USES_HOOK → `useCellValue`
- USES_HOOK → `useMemo`

<!-- source: constant-currentblocktype.md -->

# currentBlockType$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 785)

Holds the current block type of the selection (i.e. Heading, Paragraph, etc).

<!-- source: function-deduplicateissues.md -->

# deduplicateIssues

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/confidence-filter.ts` (line 155)

Deduplicate issues from multiple agents.

Two issues are considered duplicates when they share the same file, line, and category.
When duplicates are found, the issue with the highest confidence is kept.

## Signature

```ts
function deduplicateIssues(issues: ScoredIssue[]): ScoredIssue[]
```

## Parameters

| Name | Type |
|---|---|
| `issues` | `ScoredIssue[]` |

**Returns:** `ScoredIssue[]`

<!-- source: api-endpoint-delete-3.md -->

# delete

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 195)

## Endpoint

`DELETE /doc-versions/:projectId/:versionId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-dependencycard.md -->

# DependencyCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/DependencyGraph.tsx` (line 60)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `dependency` | `Dependency` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DependencyCard_765e4510["DependencyCard"]
    class component_DependencyCard_765e4510 rootComponent
```

## Relationships

- RENDERS → `ExternalIcon`
- RENDERS → `InternalIcon`

## Referenced By

- `DependencyGraph` (RENDERS)

<!-- source: interface-documentroom.md -->

# DocumentRoom

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/collaboration/interfaces/collaboration.interfaces.ts` (line 106)

Room info for a document

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `users` | `Map<string, CollaborationUser>` |
| `lastActivity` | `Date` |

<!-- source: interface-envvariableentity-2.md -->

# EnvVariableEntity

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 1003)

Environment variable entity

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.ENV_VARIABLE` |
| `variableName` | `string` |
| `exampleValue` | `string` |
| `isSensitive` | `boolean` |
| `isRequired` | `boolean` |
| `category` | `string` |

<!-- source: function-extractrenderedcomponents-2.md -->

# extractRenderedComponents

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 506)

Extract rendered child components (JSX elements that start with uppercase)

## Signature

```ts
function extractRenderedComponents(path: NodePath): string[]
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath` |

**Returns:** `string[]`

<!-- source: function-getinitialtheme.md -->

# getInitialTheme

**Kind:** Function

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/theme.ts` (line 126)

## Signature

```ts
function getInitialTheme(defaultMode: ThemeMode): ThemeMode
```

## Parameters

| Name | Type |
|---|---|
| `defaultMode` | `ThemeMode` |

**Returns:** `ThemeMode`

<!-- source: interface-globsearchoptions.md -->

# GlobSearchOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/glob-search.tool.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `maxResults` | `number` |
| `excludePatterns` | `string[]` |

<!-- source: function-ispaymentrequired.md -->

# isPaymentRequired

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/api-client.ts` (line 103)

True when the error is the fail-closed billing gate (HTTP 402).

## Signature

```ts
function isPaymentRequired(err: unknown): boolean
```

## Parameters

| Name | Type |
|---|---|
| `err` | `unknown` |

**Returns:** `boolean`

<!-- source: service-jwtauthguard.md -->

# JwtAuthGuard

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/auth/guards/jwt-auth.guard.ts` (line 7)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `canActivate` | `canActivate(context: ExecutionContext)` | `unknown` |

## Relationships

- DEPENDS_ON → `reflector`

<!-- source: class-jwtstrategy.md -->

# JwtStrategy

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/auth/strategies/jwt.strategy.ts` (line 10)

**Extends:** `PassportStrategy(Strategy)`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `validate` | `validate(payload: JwtPayload)` | `Promise<JwtPayload>` |

<!-- source: class-nextjsdetector.md -->

# NextJSDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/nextjs-detector.ts` (line 64)

Next.js Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectPages` | `detectPages(entities: Entity[])` | `DetectedNextJSPage[]` |
| `detectAPIRoutes` | `detectAPIRoutes(entities: Entity[])` | `DetectedNextJSAPIRoute[]` |
| `getPageSummary` | `getPageSummary(page: DetectedNextJSPage)` | `string` |

<!-- source: interface-parseddocumenturl.md -->

# ParsedDocumentUrl

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/lib/url-utils.ts` (line 6)

URL utilities for document navigation
Client-side URL parsing and building functions

## Properties

| Property | Type |
|---|---|
| `slug` | `string` |
| `urlId` | `string` |
| `audience` | `string` |

<!-- source: type-readonlyclicklinkcallback.md -->

# ReadOnlyClickLinkCallback

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 347)

## Definition

```ts
(event: MouseEvent, node: LinkNode, url: string) => void
```

<!-- source: class-worktreemanager.md -->

# WorktreeManager

**Kind:** Class

**Source:** `atloria-monorepo/libs/agent-core/src/tools/worktree-manager.ts` (line 49)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `isGitRepo` | `isGitRepo()` | `boolean` |
| `create` | `create(name: string)` | `WorktreeInfo` |
| `remove` | `remove(name: string)` | `void` |
| `list` | `list()` | `WorktreeInfo[]` |
| `diff` | `diff(name: string)` | `string` |
| `hasChanges` | `hasChanges(name: string)` | `boolean` |
| `activeCount` | `activeCount()` | `number` |
| `pruneStale` | `pruneStale()` | `number` |

<!-- source: interface-captureresult.md -->

# CaptureResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 186)

Result of capturing a single screenshot

## Properties

| Property | Type |
|---|---|
| `placeholderId` | `string` |
| `success` | `boolean` |
| `localPath` | `string` |
| `screenshotId` | `string` |
| `blobUrl` | `string` |
| `error` | `string` |
| `capturedAt` | `Date` |
| `dimensions` | `{ width: number; height: number }` |
| `fileSize` | `number` |
| `retryCount` | `number` |

<!-- source: component-conditionalrendering.md -->

# ConditionalRendering

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 372)

## Diagram

```mermaid
graph TD
    component_ConditionalRendering_142f3310["ConditionalRendering"]
    class component_ConditionalRendering_142f3310 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `UndoRedo`
- USES_HOOK → `useState`

<!-- source: constant-currentformat.md -->

# currentFormat$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 171)

Holds the current format of the selection.

<!-- source: api-endpoint-delete-4.md -->

# delete

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/category.controller.ts` (line 96)

Delete a category

## Endpoint

`DELETE /categories/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `CategoryController` (MODULE_DECLARES)

<!-- source: function-detectzeroprogress.md -->

# detectZeroProgress

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/agent-hardening.ts` (line 118)

Detect consecutive turns with zero tokens (likely API failures).

If the last N turns all produced 0 tokens, the agent is stuck —
probably hitting rate limits or auth errors silently.

## Signature

```ts
function detectZeroProgress(turnHistory: Array<{ tokens: number }>, threshold: number): boolean
```

## Parameters

| Name | Type |
|---|---|
| `turnHistory` | `Array<{ tokens: number }>` |
| `threshold` | `number` |

**Returns:** `boolean`

<!-- source: component-diffchunkblock.md -->

# DiffChunkBlock

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/documents/[id]/compare/page.tsx` (line 605)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `chunk` | `DiffChunk` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DiffChunkBlock_6e9df7bc["DiffChunkBlock"]
    class component_DiffChunkBlock_6e9df7bc rootComponent
```

## Relationships

- RENDERS → `MarkdownRenderer`

## Referenced By

- `SideBySideDiff` (RENDERS)

<!-- source: interface-documentstateresponse.md -->

# DocumentStateResponse

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/collaboration/interfaces/collaboration.interfaces.ts` (line 78)

Document state response sent to clients

## Properties

| Property | Type |
|---|---|
| `state` | `Uint8Array` |
| `activeUsers` | `CollaborationUser[]` |
| `version` | `number` |

<!-- source: interface-errorhandlingpattern.md -->

# ErrorHandlingPattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-management.interface.ts` (line 401)

Error handling pattern

## Properties

| Property | Type |
|---|---|
| `errorField` | `string` |
| `errorActions` | `string[]` |
| `errorMessages` | `string[]` |
| `recoveryActions` | `Array<{
    name: string;
    description: string;
  }>` |
| `hasRetry` | `boolean` |
| `errorBoundaries` | `string[]` |

<!-- source: function-extractstatetransitions.md -->

# extractStateTransitions

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/state-machine-analyzer.ts` (line 123)

Extract state transitions from code by analyzing methods and state assignments

## Signature

```ts
function extractStateTransitions(code: string, enumName: string): StateTransition[]
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |
| `enumName` | `string` |

**Returns:** `StateTransition[]`

<!-- source: function-getselectednode.md -->

# getSelectedNode

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/lexicalHelpers.ts` (line 29)

Gets the selected node from the Lexical editor.

## Signature

```ts
function getSelectedNode(selection: RangeSelection): TextNode | ElementNode | null
```

## Parameters

| Name | Type |
|---|---|
| `selection` | `RangeSelection` |

**Returns:** `TextNode | ElementNode | null`

<!-- source: interface-grepsearchoptions.md -->

# GrepSearchOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/grep-search.tool.ts` (line 17)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `maxResults` | `number` |
| `maxFileSize` | `number` |
| `excludePatterns` | `string[]` |

<!-- source: function-isvalidurlid.md -->

# isValidUrlId

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/url-utils.ts` (line 93)

Validate a URL ID format
Must be exactly 10 alphanumeric characters

## Signature

```ts
function isValidUrlId(urlId: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `urlId` | `string` |

**Returns:** `boolean`

<!-- source: service-k8singressservice.md -->

# K8sIngressService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/project/k8s-ingress.service.ts` (line 29)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `ensureIngress` | `ensureIngress(domain: string)` | `Promise<{ ok: boolean; secretName: string; error?: string }>` |
| `certReady` | `certReady(domain: string)` | `Promise<boolean>` |
| `removeIngress` | `removeIngress(domain: string)` | `Promise<void>` |
| `listManagedHosts` | `listManagedHosts()` | `Promise<string[] | null>` |

<!-- source: class-listdocversionsdto.md -->

# ListDocVersionsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/doc-version/dto/doc-version.dto.ts` (line 53)

## Properties

| Property | Type |
|---|---|
| `status` | `string[]` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: class-notfounderror.md -->

# NotFoundError

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/types/errors.ts` (line 66)

Not found error (404 Not Found)

**Extends:** `APIError`

<!-- source: interface-parsingresultsprops.md -->

# ParsingResultsProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Parser/ParsingResults.tsx` (line 11)

## Properties

| Property | Type |
|---|---|
| `result` | `ParseResult` |
| `code` | `string` |
| `className` | `string` |

<!-- source: type-rectdata.md -->

# RectData

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 26)

Describes the boundaries of the current selection so that the link dialog can position itself accordingly.

## Definition

```ts
Pick<DOMRect, 'height' | 'width' | 'top' | 'left'>
```

<!-- source: interface-categoryfiltersdto.md -->

# CategoryFiltersDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/category.dto.ts` (line 35)

DTO for category query filters

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `parentId` | `string` |

<!-- source: component-conditionaltoolbar.md -->

# ConditionalToolbar

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/toolbar.tsx` (line 102)

## Diagram

```mermaid
graph TD
    component_ConditionalToolbar_70eef2a1["ConditionalToolbar"]
    class component_ConditionalToolbar_70eef2a1 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `UndoRedo`
- RENDERS → `BoldItalicUnderlineToggles`
- RENDERS → `ListsToggle`
- RENDERS → `Separator`
- RENDERS → `BlockTypeSelect`
- RENDERS → `CreateLink`
- RENDERS → `InsertImage`
- USES_HOOK → `useState`

<!-- source: constant-currentlisttype.md -->

# currentListType$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/lists/index.ts` (line 53)

The current list type in the editor.

<!-- source: api-endpoint-delete-5.md -->

# delete

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 247)

## Endpoint

`DELETE /documents/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: component-difflinerow.md -->

# DiffLineRow

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/documents/[id]/compare/page.tsx` (line 479)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `line` | `DiffLine` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DiffLineRow_34bae6d6["DiffLineRow"]
    class component_DiffLineRow_34bae6d6 rootComponent
```

## Referenced By

- `UnifiedDiff` (RENDERS)

<!-- source: interface-documentstatsresult.md -->

# DocumentStatsResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/dto/document-stats.dto.ts` (line 24)

Document statistics response

## Properties

| Property | Type |
|---|---|
| `revisionCount` | `number` |
| `versionCount` | `number` |
| `wordCount` | `number` |
| `characterCount` | `number` |
| `contributors` | `ContributorStats[]` |
| `timeline` | `TimelineStats[]` |
| `lastModified` | `Date` |
| `createdAt` | `Date` |
| `publishedAt` | `Date` |
| `averageRevisionsPerDay` | `number` |
| `mostActiveContributor` | `ContributorStats | null` |

<!-- source: function-estimatetokens.md -->

# estimateTokens

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/context/context-manager.ts` (line 50)

Estimate tokens from string length (rough: ~4 chars per token).

## Signature

```ts
function estimateTokens(text: string): number
```

## Parameters

| Name | Type |
|---|---|
| `text` | `string` |

**Returns:** `number`

<!-- source: interface-eventdefinition-2.md -->

# EventDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 456)

Event definition (Vue, Angular)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `payload` | `string` |
| `description` | `string` |

<!-- source: function-extracttabs.md -->

# extractTabs

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/tab-extractor.ts` (line 405)

## Signature

```ts
function extractTabs(templateContent: string | undefined, filePath: string, componentName: string, framework: 'angular' | 'vue' | 'react'): TabDefinition[]
```

## Parameters

| Name | Type |
|---|---|
| `templateContent` | `string | undefined` |
| `filePath` | `string` |
| `componentName` | `string` |
| `framework` | `'angular' | 'vue' | 'react'` |

**Returns:** `TabDefinition[]`

<!-- source: function-getselectionasmarkdown.md -->

# getSelectionAsMarkdown

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/lexicalHelpers.ts` (line 120)

Gets the markdown representation of the current selection in the Lexical editor.
Returns an empty string if there is no selection or if the selection is collapsed.
Converts selected nodes to markdown by recursively processing them and preserving formatting.
Note: Selects entire nodes, not partial selections within nodes.

## Signature

```ts
function getSelectionAsMarkdown(editor: LexicalEditor, _exportParams: Omit<ExportMarkdownFromLexicalOptions, 'root'>): string
```

## Parameters

| Name | Type |
|---|---|
| `editor` | `LexicalEditor` |
| `_exportParams` | `Omit<ExportMarkdownFromLexicalOptions, 'root'>` |

**Returns:** `string`

<!-- source: interface-guardraildefinition.md -->

# GuardrailDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 158)

Guardrail definitions.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `execute` | `(input: string) => Promise<GuardrailResult>` |

<!-- source: service-keywordextractorservice.md -->

# KeywordExtractorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/keyword-extractor.service.ts` (line 26)

Keyword Extraction Service

Extracts searchable keywords from documentation content.
Leverages Phase 2.1 & 3 context for rich keyword extraction:
- State machines → states, transitions, action verbs
- UI interactions → button labels, form fields
- Code → method names, class names
- Content → natural language terms

Used by DocumentIndexingService to create search indexes.

`KeywordExtractorService` extracts searchable keywords from documentation content to support fast, relevant search. It analyzes multiple signal sources—state machines, UI interactions, code identifiers, and natural language terms—to produce a rich keyword set. The resulting keywords are consumed by `DocumentIndexingService` when building and updating search indexes.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `extractFromWorkflow` | `extractFromWorkflow(workflow: any)` | `ExtractedKeywords` |
| `extractFromFeature` | `extractFromFeature(feature: any)` | `ExtractedKeywords` |
| `extractFromTutorial` | `extractFromTutorial(tutorial: any)` | `ExtractedKeywords` |
| `getAllKeywords` | `getAllKeywords(keywords: ExtractedKeywords)` | `string[]` |
| `getWeightedKeywords` | `getWeightedKeywords(keywords: ExtractedKeywords)` | `Array<{ keyword: string; weight: number }>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant DI as DocumentIndexingService
  participant KE as KeywordExtractorService
  participant IDX as Search Index

  DI->>KE: extractKeywords(docContent, context)
  Note over KE: Parse and normalize tokens<br/>from Phase 2.1 & 3 context
  KE->>KE: State machines → states/transitions/action verbs
  KE->>KE: UI interactions → button labels/fields
  KE->>KE: Code → class/method names
  KE->>KE: Content → natural language terms
  KE-->>DI: keywords[]
  DI->>IDX: upsertDocument({ id, keywords, ... })
```

## Usage

```ts
// Example (NestJS): using KeywordExtractorService within an indexing workflow

import { Injectable } from '@nestjs/common';
import { KeywordExtractorService } from './keyword-extractor.service';

type DocContext = {
  stateMachines?: Array<{ states: string[]; transitions: string[] }>;
  ui?: { buttons?: string[]; fields?: string[] };
  code?: { classes?: string[]; methods?: string[] };
};

@Injectable()
export class ExampleIndexingWorkflow {
  constructor(private readonly keywordExtractor: KeywordExtractorService) {}

  async buildIndexPayload(docId: string, markdown: string, context: DocContext) {
    const keywords = await this.keywordExtractor.extractKeywords(markdown, context);

    return {
      id: docId,
      keywords, // store on the document index record
      content: markdown,
    };
  }
}

// Example (non-Nest): direct instantiation (if it has no DI-only dependencies)
async function extractForSearch(content: string, context: DocContext) {
  const svc = new KeywordExtractorService();
  return svc.extractKeywords(content, context);
}
```

## AI Coding Instructions

- Preserve deterministic output: normalize case/whitespace, deduplicate, and keep keyword ordering stable (or explicitly sort) to avoid index churn.
- When adding new keyword sources, route them through a single normalization/tokenization pipeline so scoring and filtering remain consistent.
- Be careful with noise: avoid indexing stop-words, very short tokens, and overly-generic UI terms unless they improve search recall.
- Integration point: `DocumentIndexingService` depends on this output—keep the return type and semantics stable; any changes should update indexing and tests together.
- Prefer additive changes (new extractors/weights) over breaking changes; validate with real docs to ensure keywords remain relevant and not overly broad.

<!-- source: function-loadfilters.md -->

# loadFilters

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 138)

## Signature

```ts
function loadFilters(boardId: string): BoardFiltersState
```

## Parameters

| Name | Type |
|---|---|
| `boardId` | `string` |

**Returns:** `BoardFiltersState`

<!-- source: class-logindto.md -->

# LoginDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/auth/dto/login.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `email` | `string` |
| `password` | `string` |

<!-- source: class-openaiprovider.md -->

# OpenAIProvider

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/openai.provider.ts` (line 55)

**Implements:** `AIProvider`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate(prompt: string, options: OpenAIGenerateOptions, stage: JobStage)` | `Promise<OpenAIResponse>` |
| `generateWithStreaming` | `generateWithStreaming(prompt: string, options: OpenAIGenerateOptions, stage: JobStage)` | `Promise<OpenAIResponse>` |
| `generateText` | `generateText(prompt: string, options: Omit<OpenAIGenerateOptions, 'messages'>, stage: JobStage)` | `Promise<string>` |
| `generateJSON` | `generateJSON(prompt: string, options: OpenAIGenerateOptions, stage: JobStage)` | `Promise<{ data: T; response: OpenAIResponse }>` |
| `verifyClaim` | `verifyClaim(claim: string, sourceCode: string, context: string)` | `Promise<{
    verified: boolean;
    confidence: number;
    reasoning: string;
    issues?: string[];
  }>` |
| `generateWithStructuredOutput` | `generateWithStructuredOutput(options: {
    prompt: string;
    schema: object;
    model?: string;
  })` | `Promise<{ content: T; usage: { inputTokens: number; outputTokens: number } }>` |
| `isAvailable` | `isAvailable()` | `Promise<boolean>` |
| `getThrottlingStatus` | `getThrottlingStatus()` | `{ consecutiveFailures: number; adaptiveDelayMs: number; lastFailureTime: number }` |

## Properties

| Property | Type |
|---|---|
| `name` | `any` |

<!-- source: interface-pmejob.md -->

# PmeJob

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/stores/pmeStore.ts` (line 12)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `projectId` | `string` |
| `status` | `PmeJobStatus` |
| `progress` | `number` |
| `stage` | `string` |
| `message` | `string` |
| `error` | `string` |
| `pages` | `PmePage[]` |
| `createdAt` | `string` |
| `completedAt` | `string` |

<!-- source: type-replacementformat.md -->

# ReplacementFormat

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 297)

How to format the replacement in documents

## Definition

```ts
'markdown' | 'mdx' | 'html'
```

<!-- source: interface-categorynode.md -->

# CategoryNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 119)

Hierarchical category node

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `icon` | `string` |
| `order` | `number` |
| `level` | `number` |
| `path` | `string` |
| `documents` | `DocumentNode[]` |
| `subcategories` | `CategoryNode[]` |

<!-- source: component-contactform.md -->

# ContactForm

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/layout/contact-form.tsx` (line 38)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `fields` | `FormField[]` | ✓ | - |
| `submitLabelKey` | `string` | ✓ | - |
| `successMessageKey` | `string` | ✓ | - |
| `errorMessageKey` | `string` | ✓ | - |
| `siteId` | `string` | ✓ | - |
| `apiUrl` | `string` | - | "https://api.atloria.app/v1/forms" |
| `headlineKey` | `string` | - | - |
| `descriptionKey` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_ContactForm_36c615a1["ContactForm"]
    class component_ContactForm_36c615a1 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `CheckCircle`
- RENDERS → `AlertCircle`
- RENDERS → `Send`
- USES_HOOK → `useTranslation`
- USES_HOOK → `useState`

<!-- source: constant-currentselection.md -->

# currentSelection$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 204)

Holds the current selection.

<!-- source: api-endpoint-delete-6.md -->

# delete

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 150)

## Endpoint

`DELETE /projects/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: component-documentationautomationsection.md -->

# DocumentationAutomationSection

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/page.tsx` (line 625)

Documentation Automation Section Component Manages automatic documentation generation configuration and execution

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DocumentationAutomationSection_27caeac1["DocumentationAutomationSection"]
    class component_DocumentationAutomationSection_27caeac1 rootComponent
```

## Relationships

- RENDERS → `ChevronUp`
- RENDERS → `ChevronDown`
- RENDERS → `CompletionSummary`
- RENDERS → `ProgressPanel`
- RENDERS → `ConfigEditor`
- RENDERS → `JobHistory`
- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useDocumentationConfig`
- USES_HOOK → `useDocumentationGenerator`
- USES_HOOK → `useDocumentationJobs`

## Referenced By

- `ProjectPage` (RENDERS)

<!-- source: interface-documenttreenode.md -->

# DocumentTreeNode

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/document.service.ts` (line 2217)

Document tree node interface for navigation

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `urlId` | `string | null` |
| `url` | `string` |
| `state` | `string` |
| `collectionId` | `string | null` |
| `children` | `DocumentTreeNode[]` |

<!-- source: interface-exportinfo-2.md -->

# ExportInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 505)

Export information

## Properties

| Property | Type |
|---|---|
| `isDefault` | `boolean` |
| `namedExports` | `string[]` |

<!-- source: function-extracttabsfromtemplate.md -->

# extractTabsFromTemplate

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/tab-extractor.ts` (line 358)

Extract tab definitions from an HTML/template string.

Uses htmlparser2 to parse the template and walks the DOM tree looking for
known tab-group patterns across Angular, React, and Vue frameworks.

## Signature

```ts
function extractTabsFromTemplate(templateContent: string, filePath: string, componentName: string, framework: 'angular' | 'vue' | 'react'): TabDefinition[]
```

## Parameters

| Name | Type |
|---|---|
| `templateContent` | `string` |
| `filePath` | `string` |
| `componentName` | `string` |
| `framework` | `'angular' | 'vue' | 'react'` |

**Returns:** `TabDefinition[]`

<!-- source: function-filterbyconfidence.md -->

# filterByConfidence

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/confidence-filter.ts` (line 142)

Filter to high-confidence issues only.

## Signature

```ts
function filterByConfidence(issues: ScoredIssue[], threshold): ScoredIssue[]
```

## Parameters

| Name | Type |
|---|---|
| `issues` | `ScoredIssue[]` |
| `threshold` | `any` |

**Returns:** `ScoredIssue[]`

<!-- source: function-getselectionrectangle.md -->

# getSelectionRectangle

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/lexicalHelpers.ts` (line 54)

Gets the coordinates of the selection in the Lexical editor.

## Signature

```ts
function getSelectionRectangle(editor: LexicalEditor)
```

## Parameters

| Name | Type |
|---|---|
| `editor` | `LexicalEditor` |

<!-- source: interface-guardrailresult.md -->

# GuardrailResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 168)

## Properties

| Property | Type |
|---|---|
| `passed` | `boolean` |
| `message` | `string` |
| `metadata` | `Record<string, unknown>` |

<!-- source: service-kgsyncservice-2.md -->

# KgSyncService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/graph/services/kg-sync.service.ts` (line 23)

Knowledge Graph Sync Service (Neo4j Implementation)

Handles bulk sync operations from CLI dynamic mode.
Provides efficient batch upsert for entities and relationships in Neo4j.

Neo4j is the ideal storage for knowledge graph data because:
- Optimized for relationship traversals
- Native graph queries with Cypher
- Better performance for complex dependency analysis
- Built-in graph algorithms

`KgSyncService` is a NestJS service that performs high-throughput, bulk synchronization of knowledge-graph data into Neo4j, optimized for CLI “dynamic mode” runs. It batches upserts for both entities (nodes) and relationships (edges) to efficiently keep the graph consistent and queryable for dependency analysis and traversal-heavy workloads.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `syncEntities` | `syncEntities(projectId: string, entities: SyncEntityDto[])` | `Promise<SyncEntitiesResponseDto>` |
| `syncRelationships` | `syncRelationships(projectId: string, relationships: SyncRelationshipDto[])` | `Promise<SyncRelationshipsResponseDto>` |
| `getEntities` | `getEntities(projectId: string, type: string)` | `unknown` |
| `getEntityById` | `getEntityById(projectId: string, entityId: string)` | `unknown` |
| `getRelationships` | `getRelationships(projectId: string)` | `unknown` |
| `getRelationshipsForEntity` | `getRelationshipsForEntity(projectId: string, entityId: string)` | `unknown` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant CLI as CLI Dynamic Mode
  participant API as NestJS API
  participant KG as KgSyncService
  participant N4J as Neo4j

  CLI->>API: Trigger bulk sync (entities + relationships)
  API->>KG: sync(payload)
  KG->>KG: Validate/normalize input\n(chunk into batches)
  loop For each batch
    KG->>N4J: Upsert nodes (MERGE)\n+ set properties
    KG->>N4J: Upsert relationships (MERGE)\n+ set properties
  end
  KG-->>API: Summary (counts/errors)
  API-->>CLI: Sync result
```

## Usage

```ts
// Example NestJS command handler / controller usage
import { Injectable } from '@nestjs/common';
import { KgSyncService } from './graph/services/kg-sync.service';

type KgEntityUpsert = {
  id: string;
  type: string; // e.g. "Package" | "File" | "Symbol"
  props?: Record<string, unknown>;
};

type KgRelationshipUpsert = {
  fromId: string;
  toId: string;
  type: string; // e.g. "DEPENDS_ON" | "IMPORTS" | "REFERENCES"
  props?: Record<string, unknown>;
};

@Injectable()
export class KgSyncRunner {
  constructor(private readonly kgSync: KgSyncService) {}

  async run() {
    const entities: KgEntityUpsert[] = [
      { id: 'pkg:api', type: 'Package', props: { name: 'api' } },
      { id: 'file:src/main.ts', type: 'File', props: { path: 'src/main.ts' } },
    ];

    const relationships: KgRelationshipUpsert[] = [
      {
        fromId: 'file:src/main.ts',
        toId: 'pkg:api',
        type: 'BELONGS_TO',
        props: { inferred: true },
      },
    ];

    // The service typically performs batched upserts into Neo4j.
    // Adjust method name/shape to match the implementation in your repo.
    const result = await this.kgSync.sync({
      entities,
      relationships,
      mode: 'dynamic',
      batchSize: 1000,
    });

    return result; // e.g. { upsertedNodes, upsertedRels, errors }
  }
}
```

## AI Coding Instructions

- Preserve the “batch upsert” pattern (chunk inputs, run Cypher `MERGE` with parameters); avoid per-entity queries, which will destroy performance in dynamic CLI runs.
- Keep node/relationship identity stable (consistent `id`/keys and relationship endpoints); changing identity fields can cause duplicates instead of updates.
- Ensure writes are parameterized Cypher (no string concatenation) and prefer `UNWIND`-based queries to insert/update many rows per transaction.
- Integrate cleanly with the Neo4j driver/session lifecycle (transactions, session close) and surface a compact sync summary (counts + failures) for CLI reporting.
- When adding new entity/relationship types, update the mapping/labeling logic and add minimal indexes/constraints in Neo4j to support the new keys.

## Relationships

- DEPENDS_ON → `neo4jservice`
- DEPENDS_ON → `prismaservice`

<!-- source: function-markdowntohtml.md -->

# markdownToHtml

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/markdown-converter.ts` (line 44)

Convert Markdown to HTML

## Signature

```ts
async function markdownToHtml(markdown: string): Promise<string>
```

## Parameters

| Name | Type |
|---|---|
| `markdown` | `string` |

**Returns:** `Promise<string>`

<!-- source: class-movecarddto.md -->

# MoveCardDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/boards/dto/card.dto.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `columnId` | `string` |
| `position` | `number` |

<!-- source: class-parseerror.md -->

# ParseError

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/errors.ts` (line 58)

Error thrown when parsing fails

**Extends:** `PipelineError`

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `line` | `number` |

<!-- source: interface-pmepage.md -->

# PmePage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/stores/pmeStore.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `pageType` | `string` |
| `htmlUrl` | `string` |
| `htmlContent` | `string` |
| `variants` | `PmeVariant[]` |

<!-- source: type-replacementprogresscallback.md -->

# ReplacementProgressCallback

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-replacer.service.ts` (line 40)

## Definition

```ts
(progress: ReplacementProgress) => void
```

<!-- source: interface-categoryupsertresult.md -->

# CategoryUpsertResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 254)

Category upsert result

## Properties

| Property | Type |
|---|---|
| `operation` | `UpsertOperation` |
| `category` | `{
    id: string; // Database ID
    slug: string;
    name: string;
  }` |

<!-- source: component-cookiebanner.md -->

# CookieBanner

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/layout/cookie-banner.tsx` (line 35)

## Diagram

```mermaid
graph TD
    component_CookieBanner_4a8c72a9["CookieBanner"]
    class component_CookieBanner_4a8c72a9 rootComponent
```

## Relationships

- RENDERS → `AnimatePresence`
- RENDERS → `motion-div`
- USES_HOOK → `useTranslation`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: constant-deep-load-triggers.md -->

# DEEP_LOAD_TRIGGERS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-10.types.ts` (line 139)

Deep Load Trigger - Conditions that trigger deep loading

<!-- source: api-endpoint-delete-7.md -->

# delete

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/suggestion/suggestion.controller.ts` (line 47)

## Endpoint

`DELETE /documents/:documentId/suggestions/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `SuggestionController` (MODULE_DECLARES)

<!-- source: component-documentitem.md -->

# DocumentItem

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/DocAutomation/SkeletonBuilder.tsx` (line 437)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `document` | `SkeletonDocument` | ✓ | - |
| `isEditing` | `boolean` | ✓ | - |
| `onStartEdit` | `Function` | ✓ | - |
| `onEndEdit` | `Function` | ✓ | - |
| `onUpdate` | `Function` | ✓ | - |
| `onRemove` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DocumentItem_6fb2a1b0["DocumentItem"]
    class component_DocumentItem_6fb2a1b0 rootComponent
```

## Relationships

- RENDERS → `Reorder-Item`
- RENDERS → `GripVertical`
- RENDERS → `Trash2`
- USES_HOOK → `useState`

## Referenced By

- `CategoryItem` (RENDERS)

<!-- source: interface-documentupdatedata.md -->

# DocumentUpdateData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/collaboration/interfaces/collaboration.interfaces.ts` (line 55)

Document update payload from Yjs

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `update` | `Uint8Array` |

<!-- source: interface-extensioncategories.md -->

# ExtensionCategories

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/file-scanner.ts` (line 60)

Supported file extension categories

## Properties

| Property | Type |
|---|---|
| `typescript` | `string[]` |
| `javascript` | `string[]` |
| `styles` | `string[]` |
| `config` | `string[]` |
| `documentation` | `string[]` |
| `templates` | `string[]` |

<!-- source: function-extracttypedefinitionsfrompath.md -->

# extractTypeDefinitionsFromPath

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 163)

Extract type definitions (interfaces and type aliases) from file
Returns a map of type name to type declaration node

## Signature

```ts
function extractTypeDefinitionsFromPath(path: NodePath<t.Program>): TypeDefinitionMap
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath<t.Program>` |

**Returns:** `TypeDefinitionMap`

<!-- source: function-filtertoolsbymode.md -->

# filterToolsByMode

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/tool-profiles.ts` (line 129)

Filter a list of tool definitions down to those allowed by the given mode.
Tools not in the profile are omitted. When mode is 'full', returns all tools.

## Signature

```ts
function filterToolsByMode(tools: T[], mode: TaskMode): T[]
```

## Parameters

| Name | Type |
|---|---|
| `tools` | `T[]` |
| `mode` | `TaskMode` |

**Returns:** `T[]`

<!-- source: function-getstateasmarkdown.md -->

# getStateAsMarkdown

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/lexicalHelpers.ts` (line 102)

## Signature

```ts
function getStateAsMarkdown(editor: LexicalEditor, exportParams: Omit<ExportMarkdownFromLexicalOptions, 'root'>)
```

## Parameters

| Name | Type |
|---|---|
| `editor` | `LexicalEditor` |
| `exportParams` | `Omit<ExportMarkdownFromLexicalOptions, 'root'>` |

<!-- source: interface-historyprocessor.md -->

# HistoryProcessor

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/history-processors.ts` (line 25)

A history processor transforms input items before they reach the model.
Must return a new array — never mutate the input.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |

<!-- source: service-knowledgegraphservice-2.md -->

# KnowledgeGraphService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/graph/services/knowledge-graph.service.ts` (line 13)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createEntity` | `createEntity(entity: Partial<KGEntity>)` | `Promise<KGEntity>` |
| `createRelation` | `createRelation(relation: KGRelation)` | `Promise<void>` |
| `getEntity` | `getEntity(id: string)` | `Promise<KGEntity>` |
| `findRelated` | `findRelated(entityId: string, depth: unknown, type: RelationType)` | `Promise<KGEntity[]>` |
| `findPath` | `findPath(fromId: string, toId: string)` | `Promise<Path | null>` |
| `searchEntities` | `searchEntities(query: string, type: EntityType)` | `Promise<KGEntity[]>` |
| `getEntityRelationships` | `getEntityRelationships(entityId: string)` | `Promise<any[]>` |
| `deleteEntity` | `deleteEntity(id: string)` | `Promise<void>` |
| `getStatistics` | `getStatistics()` | `Promise<any>` |

## Relationships

- DEPENDS_ON → `neo4jservice`

<!-- source: function-matchesfilters.md -->

# matchesFilters

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 59)

Apply filters client-side to a card

## Signature

```ts
function matchesFilters(card: BoardCardData, f: BoardFiltersState, knownAssigneeIds: Set<string>): boolean
```

## Parameters

| Name | Type |
|---|---|
| `card` | `BoardCardData` |
| `f` | `BoardFiltersState` |
| `knownAssigneeIds` | `Set<string>` |

**Returns:** `boolean`

<!-- source: class-parsecodedto.md -->

# ParseCodeDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/parser/dto/parse-code.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `code` | `string` |
| `language` | `string` |
| `filename` | `string` |

<!-- source: class-pipelineerror.md -->

# PipelineError

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/errors.ts` (line 13)

Base class for all pipeline errors

**Extends:** `Error`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `toJSON` | `toJSON()` | `PipelineErrorInfo` |

## Properties

| Property | Type |
|---|---|
| `code` | `ErrorCode` |
| `stage` | `JobStage` |
| `recoverable` | `boolean` |
| `details` | `unknown` |
| `cause` | `Error` |

<!-- source: interface-pmestrategy.md -->

# PmeStrategy

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/stores/pmeStore.ts` (line 44)

## Properties

| Property | Type |
|---|---|
| `audience` | `{ primary: string; painPoints: string[]; goals: string[] }` |
| `valueProposition` | `string` |
| `tone` | `{ voice: string; adjectives: string[]; avoidTerms: string[] }` |
| `differentiators` | `string[]` |
| `confirmed` | `boolean` |

<!-- source: type-requestinterceptor.md -->

# RequestInterceptor

**Kind:** Type

**Source:** `atloria-monorepo/packages/api-client/src/types/config.ts` (line 112)

Interceptor function types

## Definition

```ts
(
  config: RequestConfig
) => RequestConfig | Promise<RequestConfig>
```

<!-- source: interface-cellprops.md -->

# CellProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/table/TableEditor.tsx` (line 307)

## Properties

| Property | Type |
|---|---|
| `parentEditor` | `LexicalEditor` |
| `lexicalTable` | `TableNode` |
| `contents` | `Mdast.PhrasingContent[]` |
| `colIndex` | `number` |
| `rowIndex` | `number` |
| `align` | `Mdast.AlignType` |
| `activeCell` | `[number, number] | null` |
| `setActiveCell` | `(cell: [number, number] | null) => void` |
| `focus` | `boolean` |

<!-- source: component-createlink.md -->

# CreateLink

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/CreateLink.tsx` (line 12)

## Diagram

```mermaid
graph TD
    component_CreateLink_42ea935f["CreateLink"]
    class component_CreateLink_42ea935f rootComponent
```

## Relationships

- RENDERS → `ButtonWithTooltip`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useCellValue`
- USES_HOOK → `useTranslation`

<!-- source: constant-default-capture-config.md -->

# DEFAULT_CAPTURE_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 464)

## Definition

```ts
CaptureConfig
```

<!-- source: api-endpoint-delete-8.md -->

# delete

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/template/template.controller.ts` (line 223)

Delete a template.
Only admins can delete templates.

## Endpoint

`DELETE /templates/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `TemplateController` (MODULE_DECLARES)

<!-- source: component-documentlayoutinner.md -->

# DocumentLayoutInner

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/doc/[...segments]/layout.tsx` (line 14)

Inner layout component that uses the DocContext

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DocumentLayoutInner_8e0c690["DocumentLayoutInner"]
    class component_DocumentLayoutInner_8e0c690 rootComponent
```

## Relationships

- RENDERS → `X`
- RENDERS → `Menu`
- RENDERS → `ChevronLeft`
- RENDERS → `ChevronRight`
- RENDERS → `ListX`
- RENDERS → `List`
- USES_HOOK → `useDocContext`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

## Referenced By

- `DocumentLayout` (RENDERS)

<!-- source: interface-domaindnsresult.md -->

# DomainDnsResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/project/domain-dns.service.ts` (line 27)

## Properties

| Property | Type |
|---|---|
| `records` | `CheckedRecord[]` |
| `issues` | `Array<{ code: string; message: string }>` |
| `registrar` | `{ name: string; url?: string } | null` |
| `routingOk` | `boolean` |
| `ownershipOk` | `boolean` |

<!-- source: function-extracttypestring-2.md -->

# extractTypeString

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 365)

Convert TypeScript type to string representation

## Signature

```ts
function extractTypeString(typeNode: t.TSType | null | undefined): string
```

## Parameters

| Name | Type |
|---|---|
| `typeNode` | `t.TSType | null | undefined` |

**Returns:** `string`

<!-- source: interface-fielddefinition-2.md -->

# FieldDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 731)

Field definition for a database model

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `nullable` | `boolean` |
| `unique` | `boolean` |
| `primaryKey` | `boolean` |
| `autoIncrement` | `boolean` |
| `defaultValue` | `unknown` |
| `description` | `string` |
| `columnName` | `string` |

<!-- source: function-formatcompactionsummary.md -->

# formatCompactionSummary

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/context/model-compactor.ts` (line 453)

Format a CompactionSummary into a human-readable string
suitable for injection into the agent's instruction context.

## Signature

```ts
function formatCompactionSummary(summary: CompactionSummary): string
```

## Parameters

| Name | Type |
|---|---|
| `summary` | `CompactionSummary` |

**Returns:** `string`

<!-- source: function-getstoredtheme.md -->

# getStoredTheme

**Kind:** Function

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/theme.ts` (line 86)

## Signature

```ts
function getStoredTheme(): ThemeMode | null
```

**Returns:** `ThemeMode | null`

<!-- source: interface-hookdefinition.md -->

# HookDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/hook-registry.ts` (line 48)

A single hook definition

## Properties

| Property | Type |
|---|---|
| `command` | `string` |
| `timeout` | `number` |
| `matcher` | `string` |

<!-- source: service-languagedetectorservice.md -->

# LanguageDetectorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/support-agent/language-detector.service.ts` (line 3)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectLanguage` | `detectLanguage(text: string)` | `{ code: string; name: string; confidence: number }` |
| `getLanguageName` | `getLanguageName(code: string)` | `string` |

<!-- source: function-originof.md -->

# originOf

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 201)

## Signature

```ts
function originOf(t: Pick<DeskThread, 'chatSessionId' | 'pageUrl'>): Origin
```

## Parameters

| Name | Type |
|---|---|
| `t` | `Pick<DeskThread, 'chatSessionId' | 'pageUrl'>` |

**Returns:** `Origin`

<!-- source: class-parseprojectdto-2.md -->

# ParseProjectDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/parsing/dto/parse-project.dto.ts` (line 70)

## Properties

| Property | Type |
|---|---|
| `repositoryUrl` | `string` |
| `provider` | `RepositoryProvider` |
| `branch` | `string` |
| `credentials` | `RepositoryCredentialsDto` |
| `options` | `ParserOptionsDto` |
| `autoSync` | `boolean` |

<!-- source: interface-pmevariant.md -->

# PmeVariant

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/stores/pmeStore.ts` (line 34)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `variantKey` | `string` |
| `variantName` | `string` |
| `sectionType` | `string` |
| `selected` | `boolean` |
| `content` | `Record<string, unknown>` |
| `htmlContent` | `string` |

<!-- source: class-progresstracker.md -->

# ProgressTracker

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/progress-tracker.ts` (line 26)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `startBatch` | `startBatch(batchIndex: number, itemsInBatch: number, additionalInfo: Record<string, unknown>)` | `number` |
| `completeBatch` | `completeBatch(batchStartTime: number, itemsCompleted: number, additionalInfo: Record<string, unknown>)` | `ProgressStats` |
| `completeItem` | `completeItem(itemStartTime: number, itemName: string, additionalInfo: Record<string, unknown>)` | `ProgressStats` |
| `getStats` | `getStats()` | `ProgressStats` |
| `complete` | `complete(additionalInfo: Record<string, unknown>)` | `void` |

<!-- source: type-responseinterceptor.md -->

# ResponseInterceptor

**Kind:** Type

**Source:** `atloria-monorepo/packages/api-client/src/types/config.ts` (line 116)

## Definition

```ts
<T>(
  response: APIResponse<T>
) => APIResponse<T> | Promise<APIResponse<T>>
```

<!-- source: interface-checkpointdata.md -->

# CheckpointData

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/pipeline/checkpoint.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `jobState` | `JobState` |
| `stageData` | `Record<string, unknown>` |
| `timestamp` | `Date` |
| `version` | `string` |

<!-- source: component-ctabanner-2.md -->

# CtaBanner

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/cta/cta-banner.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `icon` | `LucideIcon` | - | - |

## Diagram

```mermaid
graph TD
    component_CtaBanner_1d8cd003["CtaBanner"]
    class component_CtaBanner_1d8cd003 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Icon`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- USES_HOOK → `useTranslation`

<!-- source: constant-default-document-upload-config.md -->

# DEFAULT_DOCUMENT_UPLOAD_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-13.types.ts` (line 66)

Default upload configuration for document batches

## Definition

```ts
UploadBatchConfig
```

<!-- source: api-endpoint-deleteagent.md -->

# deleteAgent

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.controller.ts` (line 133)

## Endpoint

`DELETE /support-agent/:projectId/agents/:agentId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `agentId` | query | `string` | ✓ |

## Referenced By

- `SupportAgentController` (MODULE_DECLARES)

<!-- source: interface-draftdocumentresult.md -->

# DraftDocumentResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/services/draft-document.service.ts` (line 54)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `urlId` | `string` |
| `state` | `string` |
| `type` | `string` |

<!-- source: component-draftlink.md -->

# DraftLink

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/ops/ManualInsightsPanel.tsx` (line 22)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `href` | `string` | ✓ | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DraftLink_75510c68["DraftLink"]
    class component_DraftLink_75510c68 rootComponent
```

## Referenced By

- `ManualInsightsPanel` (RENDERS)

<!-- source: function-extractuiinteractionsfromfile.md -->

# extractUIInteractionsFromFile

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ui-interaction-detector.ts` (line 357)

Extract UI interactions from Angular component template file

Reads the .html template file associated with an Angular component
and extracts all interactive elements.

## Signature

```ts
function extractUIInteractionsFromFile(templatePath: string, stateMachines: StateMachine[], componentName: string): UIInteraction[]
```

## Parameters

| Name | Type |
|---|---|
| `templatePath` | `string` |
| `stateMachines` | `StateMachine[]` |
| `componentName` | `string` |

**Returns:** `UIInteraction[]`

<!-- source: interface-filescannerconfig.md -->

# FileScannerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/config.interface.ts` (line 67)

File scanner configuration

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `includePatterns` | `string[]` |
| `excludePatterns` | `string[]` |
| `respectGitignore` | `boolean` |
| `maxFileSize` | `number` |
| `followSymlinks` | `boolean` |
| `maxDepth` | `number` |

<!-- source: function-formatissues.md -->

# formatIssues

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/confidence-filter.ts` (line 198)

Format issues for display.

Groups by severity (critical first), then sorts by confidence within each group.
Output format:
```
### Critical Issues
[!!!] (95) file.ts:42 [bug] — Description
      Suggestion: How to fix
      Found by: agent-name
```

## Signature

```ts
function formatIssues(issues: ScoredIssue[]): string
```

## Parameters

| Name | Type |
|---|---|
| `issues` | `ScoredIssue[]` |

**Returns:** `string`

<!-- source: function-getuser.md -->

# getUser

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/examples/assets/dataCode.ts` (line 24)

## Signature

```ts
function getUser(index: number)
```

## Parameters

| Name | Type |
|---|---|
| `index` | `number` |

<!-- source: interface-hookrunresult.md -->

# HookRunResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/hook-registry.ts` (line 67)

Result of running hooks for a given event

## Properties

| Property | Type |
|---|---|
| `blocked` | `boolean` |
| `blockReason` | `string` |

<!-- source: service-manualsinsightsservice.md -->

# ManualsInsightsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/manuals-insights/manuals-insights.service.ts` (line 99)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `insights` | `insights(projectId: string, organizationId: string)` | `unknown` |
| `deflection` | `deflection(projectId: string, organizationId: string, days: unknown)` | `unknown` |
| `ticketTopics` | `ticketTopics(projectId: string, organizationId: string, days: unknown)` | `Promise<TicketTopicProposal[]>` |
| `generateDraftFromCluster` | `generateDraftFromCluster(projectId: string, organizationId: string, userId: string, topicKey: string)` | `Promise<{ documentId: string; slug: string; state: string }>` |
| `freshness` | `freshness(projectId: string, slug: string)` | `Promise<{ stale: boolean; since?: string; staleCount?: number }>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `techdocsragservice`
- DEPENDS_ON → `draftdocumentservice`

<!-- source: function-overlapcount.md -->

# overlapCount

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/copilotUtils.ts` (line 99)

## Signature

```ts
function overlapCount(a: string, b: string): number
```

## Parameters

| Name | Type |
|---|---|
| `a` | `string` |
| `b` | `string` |

**Returns:** `number`

<!-- source: class-parseroptionsdto.md -->

# ParserOptionsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/parsing/dto/parse-project.dto.ts` (line 11)

## Properties

| Property | Type |
|---|---|
| `include` | `string[]` |
| `exclude` | `string[]` |
| `frameworks` | `string[]` |
| `screenshots` | `boolean` |

<!-- source: interface-progresspanelprops.md -->

# ProgressPanelProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/DocAutomation/ProgressPanel.tsx` (line 145)

## Properties

| Property | Type |
|---|---|
| `progress` | `number` |
| `currentStage` | `string | null` |
| `stageProgress` | `number` |
| `currentItem` | `string | null` |
| `elapsedMs` | `number` |
| `estimatedRemainingMs` | `number` |
| `isRunning` | `boolean` |
| `isFailed` | `boolean` |
| `isCancelled` | `boolean` |
| `error` | `Error | null` |
| `onCancel` | `() => void` |
| `screenshotProgress` | `{
    batchIndex: number;
    totalBatches: number;
    captured: number;
    totalMappings: number;
  } | null` |
| `onCancelScreenshots` | `() => void` |

<!-- source: class-projectendpoints.md -->

# ProjectEndpoints

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/projects.ts` (line 37)

Project endpoints

## Methods

| Method | Signature | Returns |
|---|---|---|
| `list` | `list(params: ProjectListParams)` | `Promise<Project[]>` |
| `get` | `get(id: string)` | `Promise<Project>` |
| `getBySlug` | `getBySlug(organizationId: string, slug: string)` | `Promise<Project>` |
| `create` | `create(dto: CreateProjectDto)` | `Promise<Project>` |
| `update` | `update(id: string, dto: UpdateProjectDto)` | `Promise<Project>` |
| `delete` | `delete(id: string)` | `Promise<void>` |

<!-- source: type-rolesourcetype-2.md -->

# RoleSourceType

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 171)

How permissions are managed

## Definition

```ts
'hardcoded' | 'database' | 'external' | 'unknown'
```

<!-- source: interface-checkpointserviceconfig.md -->

# CheckpointServiceConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/pipeline/checkpoint.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `checkpointDir` | `string` |
| `autoSaveInterval` | `number` |
| `maxCheckpoints` | `number` |

<!-- source: component-ctacard-2.md -->

# CtaCard

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/cta/cta-card.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `icon` | `LucideIcon` | - | - |

## Diagram

```mermaid
graph TD
    component_CtaCard_5fb78ac3["CtaCard"]
    class component_CtaCard_5fb78ac3 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Icon`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- USES_HOOK → `useTranslation`

<!-- source: constant-default-format.md -->

# DEFAULT_FORMAT

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/FormatConstants.ts` (line 2)

<!-- source: api-endpoint-deleteasset.md -->

# deleteAsset

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/assets/assets.controller.ts` (line 57)

## Endpoint

`DELETE /assets/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `AssetsController` (MODULE_DECLARES)

<!-- source: component-earlyaccessform.md -->

# EarlyAccessForm

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/page.tsx` (line 480)

## Diagram

```mermaid
graph TD
    component_EarlyAccessForm_2d4dea01["EarlyAccessForm"]
    class component_EarlyAccessForm_2d4dea01 rootComponent
```

## Relationships

- USES_HOOK → `useState`

## Referenced By

- `HomePage` (RENDERS)

<!-- source: interface-emailattachment.md -->

# EmailAttachment

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/email/email.service.ts` (line 5)

## Properties

| Property | Type |
|---|---|
| `filename` | `string` |
| `content` | `Buffer | string` |
| `contentType` | `string` |

<!-- source: function-extractworkflowsignals.md -->

# extractWorkflowSignals

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/workflow-signal-extractor.ts` (line 27)

Extract workflow signals - now just packages all data for AI

## Signature

```ts
function extractWorkflowSignals(entities: Entity[], relationships: Relationship[], rootDir: string): WorkflowSignals
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `Entity[]` |
| `relationships` | `Relationship[]` |
| `rootDir` | `string` |

**Returns:** `WorkflowSignals`

<!-- source: interface-filescannerdefaults.md -->

# FileScannerDefaults

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/file-scanner.ts` (line 50)

Scanner default configuration

## Properties

| Property | Type |
|---|---|
| `defaultExcludePatterns` | `string[]` |
| `defaultMaxFileSize` | `number` |

<!-- source: function-formatpreflightresults.md -->

# formatPreflightResults

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/test-watcher.ts` (line 383)

Format preflight results as a string for the system prompt.

## Signature

```ts
function formatPreflightResults(results: PreflightResult[]): string
```

## Parameters

| Name | Type |
|---|---|
| `results` | `PreflightResult[]` |

**Returns:** `string`

<!-- source: function-getworkerconfig.md -->

# getWorkerConfig

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.config.ts` (line 53)

Get screenshot worker client configuration from environment variables

Environment variables:
- SCREENSHOT_WORKER_URL: Base URL of the worker service (default: http://localhost:3000)
- SCREENSHOT_WORKER_TIMEOUT: Job completion timeout in ms (default: 300000)
- SCREENSHOT_WORKER_POLL_INTERVAL: Poll interval in ms (default: 2000)

## Signature

```ts
function getWorkerConfig(): ScreenshotWorkerClientConfig
```

**Returns:** `ScreenshotWorkerClientConfig`

<!-- source: interface-iagentloop.md -->

# IAgentLoop

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/loop-interface.ts` (line 20)

<!-- source: service-neo4jdocsorchestratorservice.md -->

# Neo4jDocsOrchestratorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/neo4j-docs-orchestrator.service.ts` (line 17)

Orchestrates complete documentation generation from Neo4j knowledge graph data

This service handles the entire documentation workflow:
1. Query Neo4j for workflows, entities, and relationships
2. Generate all documentation types (Overview, Guides, Tutorials, Features)
3. Create category hierarchy (Doc Type → Business Module → Subcategory)
4. Save documents to database with proper ordering
5. Return complete documentation structure

`Neo4jDocsOrchestratorService` orchestrates end-to-end documentation generation by pulling workflows, entities, and relationships from a Neo4j knowledge graph and transforming them into structured docs. It generates multiple doc types (Overview, Guides, Tutorials, Features), builds a hierarchical category structure (Doc Type → Business Module → Subcategory), persists the ordered results to the database, and returns the final documentation tree for consumers.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generateCompleteDocumentation` | `generateCompleteDocumentation(projectId: string, organizationId: string, userId: string, options: {
      types?: ('overview' | 'guides' | 'tutorials' | 'features')[];
      saveToDatabase?: boolean;
      createCategories?: boolean;
    })` | `Promise<GeneratedDocumentationResult>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant Caller
  participant Orchestrator as Neo4jDocsOrchestratorService
  participant Neo4j as Neo4j (Knowledge Graph)
  participant Generators as Doc Generators<br/>(Overview/Guides/Tutorials/Features)
  participant Categorizer as Category Hierarchy Builder
  participant DB as Database (Docs)

  Caller->>Orchestrator: generateDocumentation()
  Orchestrator->>Neo4j: queryWorkflowsEntitiesRelationships()
  Neo4j-->>Orchestrator: graphData (workflows/entities/relationships)
  Orchestrator->>Generators: generateAllDocTypes(graphData)
  Generators-->>Orchestrator: documents[]
  Orchestrator->>Categorizer: buildHierarchy(documents)
  Categorizer-->>Orchestrator: categorizedDocs (DocType→Module→Subcategory)
  Orchestrator->>DB: saveDocumentsWithOrdering(categorizedDocs)
  DB-->>Orchestrator: persistedStructure
  Orchestrator-->>Caller: documentationStructure
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { Neo4jDocsOrchestratorService } from './documentation/services/neo4j-docs-orchestrator.service';

@Injectable()
export class DocsJobRunner {
  constructor(
    private readonly neo4jDocsOrchestrator: Neo4jDocsOrchestratorService,
  ) {}

  async run() {
    // Triggers the full workflow:
    // 1) Query Neo4j
    // 2) Generate Overview/Guides/Tutorials/Features
    // 3) Build category hierarchy
    // 4) Persist ordered docs
    // 5) Return final structure
    const result = await this.neo4jDocsOrchestrator.generateDocumentation();

    // Example: return to an API caller, enqueue follow-up jobs, etc.
    return {
      generatedAt: new Date().toISOString(),
      categories: result.categories,
      documentsCount: result.documents?.length ?? 0,
    };
  }
}
```

## AI Coding Instructions

- Treat this service as the orchestration layer: keep Neo4j querying, doc generation, categorization, and persistence as clearly separated steps (don’t mix responsibilities inside a single method).
- Preserve deterministic ordering when saving documents; ordering impacts navigation and downstream rendering—avoid non-stable sorts or relying on database default ordering.
- When extending doc types (e.g., adding a new generator), integrate it through the “generate all documentation types” step and ensure the category hierarchy logic understands the new type.
- Be defensive about Neo4j result shapes: validate required nodes/relationships before generating docs to prevent partial graphs from producing broken category trees.

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `azureclaudeprovider`
- DEPENDS_ON → `knowledgegraphservice`
- DEPENDS_ON → `neo4jservice`

<!-- source: function-parseaudiencefromurl.md -->

# parseAudienceFromUrl

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 69)

Extract the audience slug from a published doc URL like /p/{slug}/{audience}/{doc}

## Signature

```ts
function parseAudienceFromUrl(pageUrl: string | null | undefined): string
```

## Parameters

| Name | Type |
|---|---|
| `pageUrl` | `string | null | undefined` |

**Returns:** `string`

<!-- source: class-parsestatusdto.md -->

# ParseStatusDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/parsing/dto/parse-status.dto.ts` (line 12)

## Properties

| Property | Type |
|---|---|
| `jobId` | `string` |
| `status` | `ParseJobStatus` |
| `progress` | `number` |
| `currentStep` | `string` |
| `error` | `string` |
| `result` | `{
    entitiesCount: number;
    documentsGenerated: number;
    duration: number;
    frameworks: string[];
  }` |

<!-- source: class-projectmanager.md -->

# ProjectManager

**Kind:** Class

**Source:** `atloria-monorepo/packages/core/src/managers/project-manager.ts` (line 13)

ProjectManager handles project business logic
This class is framework-agnostic and can be used in any environment

## Methods

| Method | Signature | Returns |
|---|---|---|
| `validate` | `validate(project: Partial<Project>)` | `ValidationResult` |
| `canAccess` | `canAccess(user: User, project: Project)` | `boolean` |
| `getUserRole` | `getUserRole(user: User, project: Project)` | `UserRole | null` |
| `canEdit` | `canEdit(user: User, project: Project)` | `boolean` |
| `canDelete` | `canDelete(user: User, project: Project)` | `boolean` |
| `canCreateDocuments` | `canCreateDocuments(user: User, project: Project)` | `boolean` |
| `canManageSettings` | `canManageSettings(user: User, project: Project)` | `boolean` |
| `canView` | `canView(user: User, project: Project)` | `boolean` |
| `getPermissions` | `getPermissions(user: User, project: Project)` | `void` |

<!-- source: interface-prompttemplate.md -->

# PromptTemplate

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/types/ai.ts` (line 53)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `category` | `'enhancement' | 'generation' | 'analysis' | 'custom'` |
| `template` | `string` |
| `variables` | `string[]` |
| `createdAt` | `Date` |
| `updatedAt` | `Date` |

<!-- source: type-screenshotprogresscallback.md -->

# ScreenshotProgressCallback

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 489)

Progress callback for stage 12

## Definition

```ts
(progress: ScreenshotProgress) => void
```

<!-- source: interface-chunk.md -->

# Chunk

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-02.types.ts` (line 33)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `entities` | `Entity[]` |
| `groupingReason` | `string` |
| `featureArea` | `string` |
| `tokens` | `{
    total: number;
    byTier: Record<EntityTier, number>;
  }` |

<!-- source: component-ctasplitform-2.md -->

# CtaSplitForm

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/cta/cta-split-form.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `contactItems` | `ContactItem[]` | - | - |
| `formId` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_CtaSplitForm_1793832["CtaSplitForm"]
    class component_CtaSplitForm_1793832 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- RENDERS → `motion-ul`
- RENDERS → `ItemIcon`
- USES_HOOK → `useTranslation`

<!-- source: constant-default-large-file-config.md -->

# DEFAULT_LARGE_FILE_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/large-file-indexer.ts` (line 35)

Default configuration

## Definition

```ts
LargeFileIndexerConfig
```

<!-- source: api-endpoint-deletecolumn.md -->

# deleteColumn

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 127)

## Endpoint

`DELETE /projects/:projectId/boards/:boardId/columns/:columnId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `boardId` | query | `string` | ✓ |
| `columnId` | query | `string` | ✓ |
| `moveCardsTo` | query | `string` | - |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: component-editabledescription.md -->

# EditableDescription

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/[ticketId]/page.tsx` (line 304)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `text` | `string` | ✓ | - |
| `sectionHeading` | `string` | - | - |
| `onSave` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_EditableDescription_be7c90f["EditableDescription"]
    class component_EditableDescription_be7c90f rootComponent
```

## Relationships

- RENDERS → `LinkIcon`
- RENDERS → `motion-div`
- RENDERS → `ChevronDownIcon`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

## Referenced By

- `IssueDetailPageInner` (RENDERS)

<!-- source: interface-errorhandlingmetadata.md -->

# ErrorHandlingMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/tutorial-detector.service.ts` (line 16)

Error handling metadata for tutorial generation

## Properties

| Property | Type |
|---|---|
| `errorActions` | `string[]` |
| `recoveryActions` | `string[]` |
| `errorMessages` | `string[]` |

<!-- source: function-fileimportsfrom.md -->

# fileImportsFrom

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/framework-detect.ts` (line 35)

True when the file has an `import … from '<pkgPrefix>…'` (or `require('<pkgPrefix>…')`).

## Signature

```ts
function fileImportsFrom(filePath: string, pkgPrefix: string, content: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |
| `pkgPrefix` | `string` |
| `content` | `string` |

**Returns:** `boolean`

<!-- source: interface-filestats.md -->

# FileStats

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/file-scanner.ts` (line 39)

File statistics

## Properties

| Property | Type |
|---|---|
| `size` | `number` |
| `isFile` | `boolean` |
| `isDirectory` | `boolean` |
| `modifiedAt` | `Date` |
| `createdAt` | `Date` |

<!-- source: function-formatrehydrationitems.md -->

# formatRehydrationItems

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/context/rehydration.ts` (line 84)

Format rehydration items as synthetic tool output for injection into
the conversation. Each file becomes a synthetic read_file result.

## Signature

```ts
function formatRehydrationItems(items: RehydrationItem[]): string
```

## Parameters

| Name | Type |
|---|---|
| `items` | `RehydrationItem[]` |

**Returns:** `string`

<!-- source: function-hasselectors.md -->

# hasSelectors

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 182)

Check if a route mapping has any selectors

## Signature

```ts
function hasSelectors(mapping: RouteMapping): boolean
```

## Parameters

| Name | Type |
|---|---|
| `mapping` | `RouteMapping` |

**Returns:** `boolean`

<!-- source: interface-imodelprovider.md -->

# IModelProvider

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-provider-interface.ts` (line 99)

The pluggable model provider interface.
Loops call this to talk to any LLM.

<!-- source: service-neo4jservice.md -->

# Neo4jService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/graph/services/neo4j.service.ts` (line 8)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleInit` | `onModuleInit()` | `unknown` |
| `onModuleDestroy` | `onModuleDestroy()` | `unknown` |
| `getSession` | `getSession()` | `Session` |
| `query` | `query(cypher: string, params: any)` | `Promise<any[]>` |
| `write` | `write(cypher: string, params: any)` | `Promise<any>` |

## Relationships

- DEPENDS_ON → `configservice`

<!-- source: function-parsecollectionurl.md -->

# parseCollectionUrl

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/url-utils.ts` (line 76)

Parse a collection URL to extract slug and urlId

## Signature

```ts
function parseCollectionUrl(pathname: string): { slug: string; urlId: string } | null
```

## Parameters

| Name | Type |
|---|---|
| `pathname` | `string` |

**Returns:** `{ slug: string; urlId: string } | null`

<!-- source: class-parsingqueue.md -->

# ParsingQueue

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/parsing/parsing.queue.ts` (line 30)

**Implements:** `OnModuleInit`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleInit` | `onModuleInit()` | `void` |
| `addParseJob` | `addParseJob(data: ParseJobData)` | `Promise<{ id: string }>` |
| `getJobStatus` | `getJobStatus(jobId: string)` | `Promise<any>` |
| `cancelJob` | `cancelJob(jobId: string)` | `Promise<boolean>` |

<!-- source: class-promptadapter.md -->

# PromptAdapter

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/prompt-adapter.ts` (line 17)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `setCrossModuleRelationships` | `setCrossModuleRelationships(relationships: { sourceArea: string; targetArea: string; sharedEntities: string[]; strength: number }[])` | `void` |
| `adaptSystemPrompt` | `adaptSystemPrompt(baseSystemPrompt: string, stage: string)` | `string` |
| `adaptAnalysisPrompt` | `adaptAnalysisPrompt(basePrompt: string)` | `string` |
| `adaptSynthesisPrompt` | `adaptSynthesisPrompt(basePrompt: string)` | `string` |
| `adaptStructurePrompt` | `adaptStructurePrompt(basePrompt: string)` | `string` |
| `adaptPlanningPrompt` | `adaptPlanningPrompt(basePrompt: string)` | `string` |
| `adaptMetaDocPrompt` | `adaptMetaDocPrompt(basePrompt: string, appName: string)` | `string` |
| `adaptGenerationPrompt` | `adaptGenerationPrompt(basePrompt: string, appName: string)` | `string` |

## Properties

| Property | Type |
|---|---|
| `family` | `ProviderFamily` |

<!-- source: interface-publicbranding.md -->

# PublicBranding

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/BrandingContext.tsx` (line 21)

## Properties

| Property | Type |
|---|---|
| `siteName` | `string | null` |
| `tagline` | `string | null` |
| `logoLightUrl` | `string | null` |
| `faviconUrl` | `string | null` |
| `primaryColor` | `string | null` |
| `accentColor` | `string | null` |
| `supportEmail` | `string | null` |
| `menuStyle` | `MenuStyle | null` |
| `menuConfig` | `MenuConfig | null` |
| `theme` | `string | null` |

<!-- source: type-screenshotstatus.md -->

# ScreenshotStatus

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 46)

## Definition

```ts
| 'pending' // Not yet processed
  | 'mapped' // URL mapping complete
  | 'captured' // Screenshot taken
  | 'uploaded' // Uploaded to Azure
  | 'replaced' // Placeholder replaced in docs
  | 'failed' // Failed at some stage
  | 'skipped'
```

<!-- source: interface-chunkanalysis.md -->

# ChunkAnalysis

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-04.types.ts` (line 30)

## Properties

| Property | Type |
|---|---|
| `chunkId` | `string` |
| `summary` | `string` |
| `userFunctionality` | `string[]` |
| `suggestedTopics` | `DocumentationTopic[]` |
| `complexity` | `'simple' | 'moderate' | 'complex'` |
| `targetAudience` | `string[]` |
| `prerequisites` | `string[]` |
| `warnings` | `string[]` |
| `confidence` | `number` |

<!-- source: component-customcodeblockeditor.md -->

# CustomCodeBlockEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 321)

## Diagram

```mermaid
graph TD
    component_CustomCodeBlockEditor_6a757f72["CustomCodeBlockEditor"]
    class component_CustomCodeBlockEditor_6a757f72 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`

<!-- source: constant-default-mega-file-config.md -->

# DEFAULT_MEGA_FILE_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/mega-file-indexer.ts` (line 38)

Default configuration

## Definition

```ts
MegaFileIndexerConfig
```

<!-- source: api-endpoint-deleteconfig.md -->

# deleteConfig

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 90)

## Endpoint

`DELETE /doc-automation/config/:projectId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: component-editorerror.md -->

# EditorError

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/CollaborativeDocumentEditor.tsx` (line 226)

Error state component

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `error` | `Error | null` | ✓ | - |
| `onRetry` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_EditorError_fbce422["EditorError"]
    class component_EditorError_fbce422 rootComponent
```

## Referenced By

- `CollaborativeDocumentEditor` (RENDERS)

<!-- source: interface-export.md -->

# Export

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/parser/interfaces/code-parser.interface.ts` (line 58)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `'default' | 'named'` |

<!-- source: interface-filesystemstorageconfig.md -->

# FileSystemStorageConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/storage.interface.ts` (line 265)

File system storage configuration

## Properties

| Property | Type |
|---|---|
| `baseDir` | `string` |
| `screenshotsDir` | `string` |
| `documentsDir` | `string` |
| `createDirs` | `boolean` |

<!-- source: function-findapiendpointsforsequence.md -->

# findAPIEndpointsForSequence

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/sequence-diagram.generator.ts` (line 528)

Find all API endpoints suitable for sequence diagrams

## Signature

```ts
function findAPIEndpointsForSequence(entities: Entity[]): APIEndpointEntity[]
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `Entity[]` |

**Returns:** `APIEndpointEntity[]`

<!-- source: function-getdefaultprofile.md -->

# getDefaultProfile

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-profiles.ts` (line 195)

Returns the default capability profile for a known model ID.
Used as the name-based fallback when no explicit profile is declared.

For Azure deployments with arbitrary names (e.g., "my-prod-agent"),
this will return STANDARD_PROFILE — callers should use explicit
modelProfile on AzureModelProviderConfig instead.

## Signature

```ts
function getDefaultProfile(modelId: string | undefined): ModelCapabilityProfile
```

## Parameters

| Name | Type |
|---|---|
| `modelId` | `string | undefined` |

**Returns:** `ModelCapabilityProfile`

<!-- source: function-importmarkdowntolexical.md -->

# importMarkdownToLexical

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/importMarkdownToLexical.ts` (line 210)

## Signature

```ts
function importMarkdownToLexical({
  root,
  markdown,
  visitors,
  syntaxExtensions,
  mdastExtensions,
  ...descriptors
}: MarkdownParseOptions): void
```

## Parameters

| Name | Type |
|---|---|
| `{
  root,
  markdown,
  visitors,
  syntaxExtensions,
  mdastExtensions,
  ...descriptors
}` | `MarkdownParseOptions` |

**Returns:** `void`

<!-- source: interface-indexstats.md -->

# IndexStats

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/types.ts` (line 63)

Returned from index().

## Properties

| Property | Type |
|---|---|
| `totalFiles` | `number` |
| `totalChunks` | `number` |
| `newChunks` | `number` |
| `updatedChunks` | `number` |
| `removedChunks` | `number` |
| `embeddedChunks` | `number` |
| `durationMs` | `number` |

<!-- source: service-notificationservice.md -->

# NotificationService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/notification/notification.service.ts` (line 21)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createNotification` | `createNotification(dto: CreateNotificationDto)` | `unknown` |
| `notifyMentions` | `notifyMentions(comment: { id: string; content: string; documentId: string }, mentionedUserIds: string[], authorName: string)` | `unknown` |
| `notifyNewComment` | `notifyNewComment(documentId: string, commentId: string, authorName: string, subscribedUserIds: string[])` | `unknown` |
| `notifySuggestion` | `notifySuggestion(documentId: string, suggestionId: string, authorName: string, documentOwnerId: string)` | `unknown` |
| `getUnreadNotifications` | `getUnreadNotifications(userId: string)` | `unknown` |
| `listForUser` | `listForUser(userId: string, opts: ListNotificationsOptions)` | `unknown` |
| `markAsRead` | `markAsRead(notificationId: string, userId: string)` | `unknown` |
| `markAllAsRead` | `markAllAsRead(userId: string)` | `unknown` |
| `getUserNotifications` | `getUserNotifications(userId: string, limit: unknown)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: function-parsedocumenturl.md -->

# parseDocumentUrl

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/url-utils.ts` (line 21)

Parse a document URL to extract slug and urlId
Supports formats:
- /doc/{slug}-{urlId}
- /doc/{audience}/{slug}-{urlId}

## Signature

```ts
function parseDocumentUrl(pathname: string): ParsedDocumentUrl | null
```

## Parameters

| Name | Type |
|---|---|
| `pathname` | `string` |

**Returns:** `ParsedDocumentUrl | null`

<!-- source: class-paymentrequiredexception.md -->

# PaymentRequiredException

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/common/payment-required.exception.ts` (line 8)

402 Payment Required — thrown when an organization has insufficient
credits for an operation. NestJS does not ship a built-in exception for
this status code.

**Extends:** `HttpException`

<!-- source: interface-publishedlanguage.md -->

# PublishedLanguage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/LanguageContext.tsx` (line 19)

Public-viewer i18n. Each published DocVersion is written in a single
language; the API exposes the distinct languages (`/public/p/:slug/languages`)
and the viewer applies `dir` (RTL/LTR) + renders a locale switcher when more
than one language exists. Doc slugs are English/ASCII and shared across
languages, so switching keeps the reader on the same document.

## Properties

| Property | Type |
|---|---|
| `code` | `string` |
| `name` | `string` |
| `dir` | `'ltr' | 'rtl'` |
| `versionNumber` | `number` |
| `documentCount` | `number` |
| `isDefault` | `boolean` |

<!-- source: class-qualitygate.md -->

# QualityGate

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/quality-gate.ts` (line 56)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `evaluate` | `evaluate(documents: GeneratedDocument[], plans: DocumentPlan[], entities: Entity[], sharedContext: string, retrievedContexts: Map<string, RetrievedContext>, moduleAreas: string[])` | `Promise<QualityGateResult>` |

<!-- source: type-sectiontype-2.md -->

# SectionType

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-09.types.ts` (line 71)

## Definition

```ts
| 'introduction'
  | 'prerequisites'
  | 'overview'
  | 'step-by-step'
  | 'explanation'
  | 'reference'
  | 'tips'
  | 'troubleshooting'
  | 'related'
  | 'summary'
```

<!-- source: interface-chunkcluster.md -->

# ChunkCluster

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-02-chunking/chunk-relationship-graph.ts` (line 299)

A cluster of related chunks

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `chunkIds` | `string[]` |
| `primaryFeature` | `string` |

<!-- source: component-customtheming.md -->

# CustomTheming

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/toolbar.tsx` (line 61)

## Diagram

```mermaid
graph TD
    component_CustomTheming_4fd2e789["CustomTheming"]
    class component_CustomTheming_4fd2e789 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `KitchenSinkToolbar`

<!-- source: constant-default-poll-interval-ms.md -->

# DEFAULT_POLL_INTERVAL_MS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.config.ts` (line 23)

Default poll interval when waiting for job completion (2 seconds)

<!-- source: api-endpoint-deleteentity.md -->

# deleteEntity

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/graph.controller.ts` (line 152)

## Endpoint

`DELETE /knowledge-graph/entities/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `GraphController` (MODULE_DECLARES)

<!-- source: component-editorskeleton.md -->

# EditorSkeleton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/CollaborativeDocumentEditor.tsx` (line 196)

Loading skeleton component

## Diagram

```mermaid
graph TD
    component_EditorSkeleton_48d0a949["EditorSkeleton"]
    class component_EditorSkeleton_48d0a949 rootComponent
```

## Referenced By

- `CollaborativeDocumentEditor` (RENDERS)

<!-- source: interface-extractedkeywords.md -->

# ExtractedKeywords

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/keyword-extractor.service.ts` (line 6)

Extracted keywords with metadata

## Properties

| Property | Type |
|---|---|
| `primary` | `string[]` |
| `secondary` | `string[]` |
| `technical` | `string[]` |
| `actions` | `string[]` |
| `entities` | `string[]` |

<!-- source: interface-filteredentities.md -->

# FilteredEntities

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/visibility-filter.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `visible` | `Entity[]` |
| `hidden` | `Entity[]` |
| `stats` | `FilterStatistics` |

<!-- source: function-findapiendpointswithcallers.md -->

# findAPIEndpointsWithCallers

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/api-flow-diagram.generator.ts` (line 512)

Find all API endpoints that are called by components

## Signature

```ts
function findAPIEndpointsWithCallers(allEntities: Entity[], relationships: Relationship[]): APIEndpointEntity[]
```

## Parameters

| Name | Type |
|---|---|
| `allEntities` | `Entity[]` |
| `relationships` | `Relationship[]` |

**Returns:** `APIEndpointEntity[]`

<!-- source: function-implementorfull.md -->

# implementOrFull

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/prompt-sections.ts` (line 89)

Only for modes that involve writing code

## Signature

```ts
function implementOrFull(ctx: SectionContext): boolean
```

## Parameters

| Name | Type |
|---|---|
| `ctx` | `SectionContext` |

**Returns:** `boolean`

<!-- source: function-importmdasttreetolexical.md -->

# importMdastTreeToLexical

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/importMarkdownToLexical.ts` (line 244)

## Signature

```ts
function importMdastTreeToLexical({ root, mdastRoot, visitors, ...descriptors }: MdastTreeImportOptions): void
```

## Parameters

| Name | Type |
|---|---|
| `{ root, mdastRoot, visitors, ...descriptors }` | `MdastTreeImportOptions` |

**Returns:** `void`

<!-- source: interface-instructionlayer.md -->

# InstructionLayer

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/instruction-loader.ts` (line 33)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `content` | `string` |
| `priority` | `number` |

<!-- source: service-opsalertservice.md -->

# OpsAlertService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/ops-alert.service.ts` (line 10)

Minimal ops alerting for pipeline failures. Always ERROR-logs; additionally POSTs to
ALERT_WEBHOOK_URL when configured (Slack/Teams/generic — payload is `{ text }`).
Best-effort by design: alerting must never throw into the pipeline it reports on.

`OpsAlertService` provides minimal operational alerting for pipeline failures in the API backend. It always writes an `ERROR` log entry and, when `ALERT_WEBHOOK_URL` is configured, also sends a best-effort POST to that webhook using a simple `{ text }` payload compatible with Slack/Teams/generic receivers. Alerting is designed to never throw or disrupt the pipeline it is reporting on.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `jobFailed` | `jobFailed(kind: string, projectId: string, error: string, jobId: string | null)` | `Promise<void>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant Pipeline as Pipeline/Job Runner
  participant Service as OpsAlertService
  participant Logger as Nest Logger
  participant Webhook as ALERT_WEBHOOK_URL (Slack/Teams/etc.)

  Pipeline->>Service: alert(text)
  Service->>Logger: error(text)
  alt ALERT_WEBHOOK_URL configured
    Service->>Webhook: POST { text }
    Webhook-->>Service: 2xx/4xx/timeout
    Service->>Logger: (optional) debug/warn on delivery failure
  else not configured
    Service->>Logger: (optional) debug: webhook disabled
  end
  Service-->>Pipeline: resolve (never throws)
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { OpsAlertService } from './technical-docs/ops-alert.service';

@Injectable()
export class PipelineRunner {
  constructor(private readonly opsAlert: OpsAlertService) {}

  async runPipeline(pipelineId: string) {
    try {
      // ... pipeline work
      throw new Error('Step "build" failed with exit code 1');
    } catch (err: any) {
      const msg = `[pipeline:${pipelineId}] Failure: ${err?.message ?? String(err)}`;

      // Best-effort: logs ERROR; posts to ALERT_WEBHOOK_URL if configured; will not throw.
      await this.opsAlert.alert(msg);

      // Re-throw (or handle) independently of alerting.
      throw err;
    }
  }
}
```

## AI Coding Instructions

- Keep alerting **best-effort**: never let network/webhook failures throw into callers; swallow/handle errors internally.
- Always emit an **ERROR-level log** for the alert message; webhook delivery is additive and optional.
- When posting to the webhook, send a minimal payload `{ text: string }` and avoid service-specific fields unless explicitly required.
- Treat `ALERT_WEBHOOK_URL` as an integration point: if unset/empty, skip HTTP calls and return quickly.
- Avoid blocking critical paths: use timeouts/retries conservatively (or none) so alerting cannot stall the pipeline.

## Relationships

- DEPENDS_ON → `configservice`

<!-- source: function-parseprojecturl.md -->

# parseProjectUrl

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/url-utils.ts` (line 136)

Parse a project URL to extract slug and urlId

## Signature

```ts
function parseProjectUrl(pathname: string): { slug: string; urlId: string } | null
```

## Parameters

| Name | Type |
|---|---|
| `pathname` | `string` |

**Returns:** `{ slug: string; urlId: string } | null`

<!-- source: class-pdfworkerunavailableerror.md -->

# PdfWorkerUnavailableError

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/doc-version/export.service.ts` (line 6)

Raised when the PDF-rendering worker can't be reached / fails the render.

**Extends:** `Error`

<!-- source: interface-publishedprojectresponse.md -->

# PublishedProjectResponse

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useProjectPublish.ts` (line 11)

Published project response from the API

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `slug` | `string` |
| `urlId` | `string` |
| `publishedSlug` | `string` |
| `publicUrl` | `string` |
| `publishedAt` | `string` |
| `isPublic` | `boolean` |

<!-- source: class-qualityscorer.md -->

# QualityScorer

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/quality-scorer.ts` (line 63)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `scoreAll` | `scoreAll(documents: GeneratedDocument[], plans: DocumentPlan[], entities: Entity[], moduleAreas: string[])` | `QualityScore[]` |
| `scoreDocument` | `scoreDocument(doc: GeneratedDocument, plan: DocumentPlan, entities: Entity[], moduleAreas: string[])` | `QualityScore` |

<!-- source: type-selectortype.md -->

# SelectorType

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 38)

## Definition

```ts
(typeof SELECTOR_TYPES)[number]
```

<!-- source: interface-chunkedge.md -->

# ChunkEdge

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-02.types.ts` (line 147)

## Properties

| Property | Type |
|---|---|
| `from` | `string` |
| `to` | `string` |
| `relationship` | `'imports' | 'uses' | 'extends' | 'implements'` |
| `strength` | `'strong' | 'weak'` |
| `examples` | `string[]` |

<!-- source: constant-default-rate-limiter-config.md -->

# DEFAULT_RATE_LIMITER_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/rate-limiter.ts` (line 17)

## Definition

```ts
RateLimiterConfig
```

<!-- source: api-endpoint-deletejobdocuments.md -->

# deleteJobDocuments

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 199)

## Endpoint

`DELETE /doc-automation/jobs/:id/documents`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: component-dialogform.md -->

# DialogForm

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/DialogButton.tsx` (line 85)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `autocompleteSuggestions` | `any` | ✓ | - |
| `onSubmitCallback` | `any` | ✓ | - |
| `dialogInputPlaceholder` | `any` | ✓ | - |
| `submitButtonTitle` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DialogForm_4436395b["DialogForm"]
    class component_DialogForm_4436395b rootComponent
```

## Relationships

- RENDERS → `Dialog-Close`
- USES_HOOK → `useState`
- USES_HOOK → `useCellValue`
- USES_HOOK → `useCombobox`
- USES_HOOK → `useCallback`

<!-- source: component-emptystate.md -->

# EmptyState

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/MessageList.tsx` (line 71)

Empty state shown when there are no messages

## Diagram

```mermaid
graph TD
    component_EmptyState_35824664["EmptyState"]
    class component_EmptyState_35824664 rootComponent
```

## Referenced By

- `MessageList` (RENDERS)

<!-- source: interface-feature.md -->

# Feature

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/services/business-context-parser.service.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `category` | `string` |
| `capabilities` | `string[]` |

<!-- source: interface-filterstatistics.md -->

# FilterStatistics

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/visibility-filter.ts` (line 27)

## Properties

| Property | Type |
|---|---|
| `total` | `number` |
| `visible` | `number` |
| `hidden` | `number` |
| `byAccess` | `Record<string, number>` |
| `byStability` | `Record<string, number>` |

<!-- source: function-findentrypoints.md -->

# findEntryPoints

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/deployment-diagram.generator.ts` (line 592)

Find services that act as entry points (API gateways, load balancers)

## Signature

```ts
function findEntryPoints(entities: Entity[], relationships: Relationship[]): Entity[]
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `Entity[]` |
| `relationships` | `Relationship[]` |

**Returns:** `Entity[]`

<!-- source: function-inferexports.md -->

# inferExports

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/services/entity-mapper.service.ts` (line 393)

Infer whether an entity is exported.
Checks extended entity properties (ComponentEntity.exports, etc.)
and metadata. Defaults to true if we can't determine.

## Signature

```ts
function inferExports(entity: ParserCoreEntity): boolean
```

## Parameters

| Name | Type |
|---|---|
| `entity` | `ParserCoreEntity` |

**Returns:** `boolean`

<!-- source: function-ishardblocked.md -->

# isHardBlocked

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/session/permission-gate.ts` (line 200)

Quick check: is this command in the T3 hard-block list?
Convenience wrapper around classifyBashCommand for callers that only need
to know whether to block.

## Signature

```ts
function isHardBlocked(command: string): { blocked: boolean; reason?: string }
```

## Parameters

| Name | Type |
|---|---|
| `command` | `string` |

**Returns:** `{ blocked: boolean; reason?: string }`

<!-- source: interface-journalentry.md -->

# JournalEntry

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/session-journal.ts` (line 33)

## Properties

| Property | Type |
|---|---|
| `turn` | `number` |
| `type` | `JournalEntryType` |
| `content` | `string` |
| `timestamp` | `number` |

<!-- source: service-opsalertsservice.md -->

# OpsAlertsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/ops/ops-alerts.service.ts` (line 23)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `sweep` | `sweep()` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `emailservice`

<!-- source: function-pickgapproposal.md -->

# pickGapProposal

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/copilotUtils.ts` (line 105)

Best proposal with token overlap ≥ 2 against the thread title/question, or null.

## Signature

```ts
function pickGapProposal(proposals: TicketTopicProposal[], threadText: string): TicketTopicProposal | null
```

## Parameters

| Name | Type |
|---|---|
| `proposals` | `TicketTopicProposal[]` |
| `threadText` | `string` |

**Returns:** `TicketTopicProposal | null`

<!-- source: class-publicticketreplydto.md -->

# PublicTicketReplyDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/issues/dto/public-ticket.dto.ts` (line 4)

Customer reply from the public tracking page — session id proves ownership

## Properties

| Property | Type |
|---|---|
| `body` | `string` |
| `reporterSessionId` | `string` |

<!-- source: interface-publishedversion.md -->

# PublishedVersion

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/lib/public-api.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `versionNumber` | `number` |
| `label` | `string | null` |
| `status` | `'ACTIVE' | 'PUBLISHED' | 'DEPRECATED'` |
| `publishedAt` | `string | null` |
| `isActive` | `boolean` |
| `documentCount` | `number` |

<!-- source: class-ratelimiter.md -->

# RateLimiter

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/rate-limiter.ts` (line 41)

Rate limiter for controlling concurrent API requests

## Methods

| Method | Signature | Returns |
|---|---|---|
| `acquire` | `acquire()` | `Promise<void>` |
| `release` | `release()` | `void` |
| `withLimit` | `withLimit(operation: () => Promise<T>)` | `Promise<T>` |
| `getStatus` | `getStatus()` | `{ active: number; queued: number; available: number }` |
| `hasAvailableSlot` | `hasAvailableSlot()` | `boolean` |
| `clearQueue` | `clearQueue()` | `number` |

## Properties

| Property | Type |
|---|---|
| `maxConcurrent` | `number` |

<!-- source: type-serializedcodeblocknode.md -->

# SerializedCodeBlockNode

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/CodeBlockNode.tsx` (line 41)

## Definition

```ts
Spread<CreateCodeBlockNodeOptions & { type: 'codeblock'; version: 1 }, SerializedLexicalNode>
```

<!-- source: interface-chunkinput.md -->

# ChunkInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-02.types.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `entities` | `Entity[]` |
| `budget` | `TokenBudget` |
| `largeFileThreshold` | `number` |

<!-- source: constant-default-replacement-config.md -->

# DEFAULT_REPLACEMENT_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-replacer.service.ts` (line 24)

Default replacement configuration

## Definition

```ts
ReplacementConfig
```

<!-- source: api-endpoint-deletereport.md -->

# deleteReport

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/export/analytics-export.controller.ts` (line 119)

## Endpoint

`DELETE /analytics/:projectId/reports/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `AnalyticsExportController` (MODULE_DECLARES)

<!-- source: component-diffsourceplugin.md -->

# DiffSourcePlugin

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 337)

## Diagram

```mermaid
graph TD
    component_DiffSourcePlugin_41dca71d["DiffSourcePlugin"]
    class component_DiffSourcePlugin_41dca71d rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `UndoRedo`

<!-- source: component-errorcontent.md -->

# ErrorContent

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/common/ErrorState.tsx` (line 96)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `config` | `unknown` | ✓ | - |
| `errorType` | `ErrorType` | ✓ | - |
| `error` | `string` | ✓ | - |
| `showAction` | `boolean` | - | - |

## Diagram

```mermaid
graph TD
    component_ErrorContent_a9d81d2["ErrorContent"]
    class component_ErrorContent_a9d81d2 rootComponent
```

## Relationships

- RENDERS → `ActionButton`

## Referenced By

- `ErrorState` (RENDERS)

<!-- source: interface-featuredocumentation.md -->

# FeatureDocumentation

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/feature-docs-generator.service.ts` (line 9)

Generated feature documentation

## Properties

| Property | Type |
|---|---|
| `feature` | `DetectedFeature` |
| `content` | `{
    overview: string;
    gettingStarted: string;
    howItWorks: string;
    usageGuide: string;
    configuration: string;
    examples: string;
    bestPractices: string;
    troubleshooting: string;
    apiReference: string;
  }` |
| `metadata` | `{
    generatedAt: Date;
    estimatedReadTime: string;
    complexity: string;
  }` |

<!-- source: function-findmodelclusters.md -->

# findModelClusters

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/database-schema-diagram.generator.ts` (line 423)

Group models by their relations to find isolated clusters

## Signature

```ts
function findModelClusters(models: DatabaseModelEntity[]): DatabaseModelEntity[][]
```

## Parameters

| Name | Type |
|---|---|
| `models` | `DatabaseModelEntity[]` |

**Returns:** `DatabaseModelEntity[][]`

<!-- source: interface-formdefinition.md -->

# FormDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/form-validation-extractor.ts` (line 31)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `submitMethod` | `string` |
| `fields` | `FormFieldDefinition[]` |
| `route` | `string` |
| `hostComponent` | `string` |
| `sourceFile` | `string` |

<!-- source: function-initanalytics.md -->

# initAnalytics

**Kind:** Function

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/analytics.ts` (line 41)

Initialize analytics provider. Defers until cookie consent is given.

## Signature

```ts
function initAnalytics(config: AnalyticsConfig)
```

## Parameters

| Name | Type |
|---|---|
| `config` | `AnalyticsConfig` |

<!-- source: function-ismacos.md -->

# isMacOS

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/bash-sandbox.ts` (line 98)

Returns true if this process is running on macOS

## Signature

```ts
function isMacOS(): boolean
```

**Returns:** `boolean`

<!-- source: interface-journaltooloptions.md -->

# JournalToolOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/journal.tool.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `journal` | `SessionJournal` |

<!-- source: service-opsservice.md -->

# OpsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/ops/ops.service.ts` (line 11)

Admin cockpit read-side (Phase 2.3): one overview call aggregating what Tier 0/1 already
record — jobs (status/duration/failures), AI spend (AIUsage), credits, queue health and
the F2 interaction stream (deflection). Org-scoped: you see your own organization.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `overview` | `overview(organizationId: string)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `configservice`

<!-- source: function-post.md -->

# POST

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/api/early-access/route.ts` (line 19)

## Signature

```ts
async function POST(req: NextRequest)
```

## Parameters

| Name | Type |
|---|---|
| `req` | `NextRequest` |

<!-- source: class-publishdocumentdto.md -->

# PublishDocumentDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/publish-document.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `isPublic` | `boolean` |

<!-- source: class-reactdetector.md -->

# ReactDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/react-detector.ts` (line 39)

React Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detect` | `detect(entities: Entity[])` | `DetectedReactComponent[]` |
| `getComponentSummary` | `getComponentSummary(component: DetectedReactComponent)` | `string` |

<!-- source: interface-screenshotannotationprops.md -->

# ScreenshotAnnotationProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/ScreenshotAnnotation.tsx` (line 41)

## Properties

| Property | Type |
|---|---|
| `src` | `string` |
| `alt` | `string` |
| `annotations` | `Annotation[]` |

<!-- source: type-serializeddirectivenode.md -->

# SerializedDirectiveNode

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/directives/DirectiveNode.tsx` (line 14)

## Definition

```ts
Spread<
  {
    mdastNode: Directives
    type: 'directive'
    version: 1
  },
  SerializedLexicalNode
>
```

<!-- source: interface-chunknode.md -->

# ChunkNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-02.types.ts` (line 141)

## Properties

| Property | Type |
|---|---|
| `chunkId` | `string` |
| `featureArea` | `string` |
| `entityCount` | `number` |

<!-- source: constant-default-retry-config-2.md -->

# DEFAULT_RETRY_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/retry.ts` (line 21)

## Definition

```ts
RetryConfig
```

<!-- source: api-endpoint-deletescreenshot.md -->

# deleteScreenshot

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/screenshot/screenshot.controller.ts` (line 87)

## Endpoint

`DELETE /screenshots/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ScreenshotController` (MODULE_DECLARES)

<!-- source: component-diffsourcetogglewrapper.md -->

# DiffSourceToggleWrapper

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/DiffSourceToggleWrapper.tsx` (line 23)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |
| `SourceToolbar` | `any` | ✓ | - |
| `options` | `any` | - | [] |

## Diagram

```mermaid
graph TD
    component_DiffSourceToggleWrapper_24233a1["DiffSourceToggleWrapper"]
    class component_DiffSourceToggleWrapper_24233a1 rootComponent
```

## Relationships

- RENDERS → `SingleChoiceToggleGroup`
- USES_HOOK → `useCellValues`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useTranslation`

<!-- source: component-erroricon.md -->

# ErrorIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/ParsingResults.tsx` (line 120)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_ErrorIcon_52464809["ErrorIcon"]
    class component_ErrorIcon_52464809 rootComponent
```

## Referenced By

- `ParsingResults` (RENDERS)

<!-- source: function-findrootcomponents.md -->

# findRootComponents

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/component-hierarchy-diagram.generator.ts` (line 435)

Find all root components (components that are not rendered by others)

## Signature

```ts
function findRootComponents(components: ComponentEntity[], relationships: Relationship[]): string[]
```

## Parameters

| Name | Type |
|---|---|
| `components` | `ComponentEntity[]` |
| `relationships` | `Relationship[]` |

**Returns:** `string[]`

<!-- source: interface-flow.md -->

# Flow

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/graph/interfaces/entity.interface.ts` (line 48)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `stages` | `FlowStage[]` |
| `entities` | `KGEntity[]` |

<!-- source: interface-formelement.md -->

# FormElement

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/template-analysis.interface.ts` (line 63)

Form element detected in template

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `onSubmit` | `string` |
| `fields` | `FormField[]` |
| `line` | `number` |
| `conditionalOn` | `string` |

<!-- source: function-iserrorcode.md -->

# isErrorCode

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/errors.ts` (line 289)

Check if an error is a specific type

## Signature

```ts
function isErrorCode(error: unknown, code: ErrorCode): boolean
```

## Parameters

| Name | Type |
|---|---|
| `error` | `unknown` |
| `code` | `ErrorCode` |

**Returns:** `boolean`

<!-- source: interface-jsonschemaoutput.md -->

# JsonSchemaOutput

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 28)

## Properties

| Property | Type |
|---|---|
| `type` | `'json_schema'` |
| `schema` | `Record<string, unknown>` |
| `name` | `string` |
| `strict` | `boolean` |

<!-- source: function-loadhooksconfig.md -->

# loadHooksConfig

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/session/hook-registry.ts` (line 209)

Load a hooks config from a JSON file.
Returns null if the file doesn't exist or can't be parsed.

## Signature

```ts
function loadHooksConfig(filePath: string): HooksConfig | null
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |

**Returns:** `HooksConfig | null`

<!-- source: service-optionaljwtauthguard.md -->

# OptionalJwtAuthGuard

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/auth/guards/optional-jwt-auth.guard.ts` (line 14)

Optional JWT Auth Guard

This guard attempts to authenticate the user via JWT but doesn't
require authentication. If a valid JWT is present, req.user will
be populated. If not, the request continues with req.user undefined.

Use this for public endpoints that need optional authentication
(e.g., public document viewer that shows more content for authenticated users).

`OptionalJwtAuthGuard` is a NestJS guard that attempts to authenticate incoming requests using a JWT without enforcing authentication. If a valid token is present, it attaches the decoded user to `req.user`; otherwise, the request proceeds normally with `req.user` remaining `undefined`. Use it for public endpoints that can enhance responses when a user is authenticated.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `handleRequest` | `handleRequest(err: any, user: TUser)` | `TUser | undefined` |
| `canActivate` | `canActivate(context: ExecutionContext)` | `unknown` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant C as Client
  participant N as NestJS Pipeline
  participant G as OptionalJwtAuthGuard
  participant J as Jwt Strategy / Auth Service
  participant R as Controller/Route Handler

  C->>N: HTTP Request (may include Authorization: Bearer <jwt>)
  N->>G: canActivate(context)
  G->>J: Validate JWT (if present)
  alt JWT valid
    J-->>G: user payload
    G-->>N: allow; set req.user = payload
  else No JWT or invalid JWT
    J-->>G: validation fails / no token
    G-->>N: allow; req.user remains undefined
  end
  N->>R: Invoke handler
  R-->>C: Response (optionally tailored by req.user)
```

## Usage

```ts
import { Controller, Get, Req, UseGuards } from '@nestjs/common';
import { Request } from 'express';
import { OptionalJwtAuthGuard } from './auth/guards/optional-jwt-auth.guard';

@Controller('documents')
export class DocumentsController {
  @Get(':id/view')
  @UseGuards(OptionalJwtAuthGuard)
  viewDocument(@Req() req: Request) {
    // If authenticated: req.user is populated by the JWT strategy
    const user = (req as any).user;

    if (user) {
      return { mode: 'enhanced', message: `Hello ${user.email ?? 'user'}`, content: 'Full content' };
    }

    // If not authenticated: still allowed, but limited response
    return { mode: 'public', message: 'Hello guest', content: 'Preview content' };
  }
}
```

## AI Coding Instructions

- Keep the guard **non-blocking**: it should never throw/deny solely due to missing or invalid JWT—always allow the request to continue.
- Ensure downstream code treats `req.user` as **optional** (`undefined`), and branch logic accordingly (avoid assuming authenticated state).
- Integrate with the existing **JWT strategy/passport setup** (e.g., the same validation logic as the required JWT guard), but swallow auth failures instead of propagating them.
- When adding new endpoints, use this guard for **public routes with optional personalization**, not for anything that must enforce authorization checks.

<!-- source: function-post-2.md -->

# POST

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/mcp/route.ts` (line 11)

Slug-fronted, same-origin MCP endpoint: POST /p/<slug>/mcp — proxies the API's public,
urlId-keyed MCP server (docs + entity graph over technical + user manuals). Coding agents
(Claude, Cursor, …) add this URL directly. Stateless: each POST is a self-contained JSON-RPC
exchange, so no session state crosses the proxy.

## Signature

```ts
async function POST(req: Request, ctx: { params: Promise<{ slugId: string }> })
```

## Parameters

| Name | Type |
|---|---|
| `req` | `Request` |
| `ctx` | `{ params: Promise<{ slugId: string }> }` |

<!-- source: class-pythonparser.md -->

# PythonParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/parser/parsers/python.parser.ts` (line 15)

**Implements:** `CodeParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `parse` | `parse(code: string, _filename: undefined)` | `Promise<ParseResult>` |
| `extractSymbols` | `extractSymbols(code: string)` | `Promise<ParserSymbol[]>` |
| `extractDependencies` | `extractDependencies(code: string)` | `Promise<Dependency[]>` |

## Properties

| Property | Type |
|---|---|
| `language` | `any` |
| `supportedExtensions` | `any` |

<!-- source: class-reactselectorextractor.md -->

# ReactSelectorExtractor

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/react-selector-extractor.ts` (line 18)

React Selector Extractor

## Methods

| Method | Signature | Returns |
|---|---|---|
| `extractFromJsx` | `extractFromJsx(jsx: string)` | `ExtractedSelectors` |

<!-- source: interface-screenshotfigureprops.md -->

# ScreenshotFigureProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/ScreenshotFigure.tsx` (line 25)

## Properties

| Property | Type |
|---|---|
| `src` | `string` |
| `alt` | `string` |
| `annotations` | `Annotation[]` |
| `caption` | `string | null` |
| `lang` | `string` |
| `dir` | `'ltr' | 'rtl'` |

<!-- source: type-serializedlexicaljsxnode.md -->

# SerializedLexicalJsxNode

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/LexicalJsxNode.tsx` (line 15)

## Definition

```ts
Spread<
  {
    mdastNode: MdastJsx
    importStatement: ImportStatement | undefined
    type: 'jsx'
    version: 1
  },
  SerializedLexicalNode
>
```

<!-- source: interface-chunkrelationshipgraph.md -->

# ChunkRelationshipGraph

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-02.types.ts` (line 136)

ChunkRelationshipGraph - Cross-chunk import/dependency analysis

Helps AI understand how different chunks relate to each other.
Critical for cross-cutting features like "complete a sale" which
spans multiple chunks (customers, products, orders).

## Properties

| Property | Type |
|---|---|
| `nodes` | `ChunkNode[]` |
| `edges` | `ChunkEdge[]` |

<!-- source: constant-default-screenshot-stage-config.md -->

# DEFAULT_SCREENSHOT_STAGE_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 452)

## Definition

```ts
Partial<ScreenshotStageConfig>
```

<!-- source: api-endpoint-deleteversion.md -->

# deleteVersion

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 693)

## Endpoint

`DELETE /documents/:id/versions/:versionId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: component-diffsourcewrapper.md -->

# DiffSourceWrapper

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/diff-source/DiffSourceWrapper.tsx` (line 8)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DiffSourceWrapper_2f3e541c["DiffSourceWrapper"]
    class component_DiffSourceWrapper_2f3e541c rootComponent
```

## Relationships

- RENDERS → `DiffViewer`
- RENDERS → `SourceEditor`
- USES_HOOK → `useCellValues`

<!-- source: component-erroricon-2.md -->

# ErrorIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/common/ErrorState.tsx` (line 76)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `config` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ErrorIcon_408095c0["ErrorIcon"]
    class component_ErrorIcon_408095c0 rootComponent
```

## Referenced By

- `ErrorState` (RENDERS)

<!-- source: function-findrootmodels.md -->

# findRootModels

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/database-schema-diagram.generator.ts` (line 403)

Find models that have no incoming relations (potential root models)

## Signature

```ts
function findRootModels(models: DatabaseModelEntity[]): DatabaseModelEntity[]
```

## Parameters

| Name | Type |
|---|---|
| `models` | `DatabaseModelEntity[]` |

**Returns:** `DatabaseModelEntity[]`

<!-- source: interface-flowstage-2.md -->

# FlowStage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/graph/interfaces/entity.interface.ts` (line 55)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `order` | `number` |
| `entities` | `KGEntity[]` |

<!-- source: interface-formfield.md -->

# FormField

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/template-analysis.interface.ts` (line 83)

Form field within a form

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `required` | `boolean` |
| `model` | `string` |

<!-- source: function-ismdastdirectivesnode.md -->

# isMdastDirectivesNode

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/directives/MdastDirectiveVisitor.ts` (line 13)

Determines if the given node is a HTML MDAST node.

## Signature

```ts
function isMdastDirectivesNode(node: Mdast.Nodes): node is Directives
```

## Parameters

| Name | Type |
|---|---|
| `node` | `Mdast.Nodes` |

**Returns:** `node is Directives`

<!-- source: interface-jsonstoreconfig.md -->

# JsonStoreConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/memory/json-store.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `storageDir` | `string` |

<!-- source: function-meetsconfidence.md -->

# meetsConfidence

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/memory/types.ts` (line 147)

Check if a confidence level meets a minimum threshold.

## Signature

```ts
function meetsConfidence(actual: string, minimum: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `actual` | `string` |
| `minimum` | `string` |

**Returns:** `boolean`

<!-- source: service-organizationguard.md -->

# OrganizationGuard

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/auth/guards/organization.guard.ts` (line 11)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `canActivate` | `canActivate(context: ExecutionContext)` | `boolean` |

<!-- source: function-preprocessmarkdown.md -->

# preprocessMarkdown

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/preprocessMarkdown.ts` (line 6)

Preprocess markdown content to handle custom JSX components
Converts JSX-style components to HTML that ReactMarkdown can handle

## Signature

```ts
function preprocessMarkdown(content: string): string
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |

**Returns:** `string`

<!-- source: class-redactboxdto.md -->

# RedactBoxDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/capture/dto/create-flow.dto.ts` (line 32)

A rectangular region (PERCENT 0-100 of the natural screenshot) the owner marked
to be blacked-out. Unlike annotation overlays (coordinates only), a redaction is
BURNED into the stored asset by the worker on the next (re)shoot — the underlying
pixels are destroyed, so a leaked value can never be recovered from the image.

## Properties

| Property | Type |
|---|---|
| `x` | `number` |
| `y` | `number` |
| `w` | `number` |
| `h` | `number` |

<!-- source: class-requestcancellederror.md -->

# RequestCancelledError

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/types/errors.ts` (line 99)

Request cancelled error

**Extends:** `NetworkError`

<!-- source: interface-selectionrange.md -->

# SelectionRange

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useCollaboration.ts` (line 40)

Selection range in the document

## Properties

| Property | Type |
|---|---|
| `anchor` | `number` |
| `head` | `number` |

<!-- source: type-snippettype.md -->

# SnippetType

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/knowledge-reference.types.ts` (line 20)

## Definition

```ts
| 'overview'
  | 'getting-started'
  | 'navigation-path'
  | 'key-feature'
  | 'troubleshooting'
  | 'faq-candidate'
  | 'admin-only'
  | 'persona-relevant'
  | 'workflow-step'
  | 'quick-win'
```

<!-- source: interface-chunkrelationshipsummary.md -->

# ChunkRelationshipSummary

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-02-chunking/chunk-relationship-graph.ts` (line 285)

Summary of chunk relationships

## Properties

| Property | Type |
|---|---|
| `totalNodes` | `number` |
| `totalEdges` | `number` |
| `mostConnectedChunks` | `Array<{ chunk: ChunkNode; connections: number }>` |
| `clusters` | `ChunkCluster[]` |
| `crossCuttingChunks` | `string[]` |
| `importRelationships` | `number` |
| `extendsRelationships` | `number` |
| `implementsRelationships` | `number` |

<!-- source: constant-default-timeout-ms.md -->

# DEFAULT_TIMEOUT_MS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.config.ts` (line 18)

Default timeout for job completion (5 minutes)

<!-- source: api-endpoint-deprecate.md -->

# deprecate

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 187)

## Endpoint

`POST /doc-versions/:projectId/:versionId/deprecate`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-diffviewer.md -->

# DiffViewer

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/diff-source/DiffViewer.tsx` (line 18)

## Diagram

```mermaid
graph TD
    component_DiffViewer_6fac23e0["DiffViewer"]
    class component_DiffViewer_6fac23e0 rootComponent
```

## Relationships

- USES_HOOK → `useRealm`
- USES_HOOK → `useCellValues`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useRef`
- USES_HOOK → `useCellValue`
- USES_HOOK → `useEffect`

<!-- source: component-escalatepanel.md -->

# EscalatePanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/SupportChatWidget.tsx` (line 579)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `status` | `unknown | unknown | unknown | unknown` | ✓ | - |
| `email` | `string` | ✓ | - |
| `note` | `string` | ✓ | - |
| `ticketNumber` | `number | null` | ✓ | - |
| `trackingUrl` | `string | null` | ✓ | - |
| `lang` | `string | null | undefined` | ✓ | - |
| `onEmailChange` | `Function` | ✓ | - |
| `onNoteChange` | `Function` | ✓ | - |
| `onSubmit` | `Function` | ✓ | - |
| `onCancel` | `Function` | ✓ | - |
| `onRetry` | `Function` | ✓ | - |
| `onDone` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_EscalatePanel_3207206f["EscalatePanel"]
    class component_EscalatePanel_3207206f rootComponent
```

## Relationships

- RENDERS → `CheckCircle2`
- RENDERS → `ArrowLeft`

## Referenced By

- `SupportChatWidget` (RENDERS)

<!-- source: function-formatapiflowasmarkdown.md -->

# formatAPIFlowAsMarkdown

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/api-flow-diagram.generator.ts` (line 479)

Format API flow diagram as markdown

## Signature

```ts
function formatAPIFlowAsMarkdown(mermaidCode: string): string
```

## Parameters

| Name | Type |
|---|---|
| `mermaidCode` | `string` |

**Returns:** `string`

<!-- source: interface-formattedragcontext.md -->

# FormattedRagContext

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/support-agent/prompts/rag-context-formatter.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `text` | `string` |
| `hasResults` | `boolean` |
| `sourceCount` | `number` |

<!-- source: interface-formfielddefinition.md -->

# FormFieldDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/form-validation-extractor.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `required` | `boolean` |
| `model` | `string` |
| `validationRules` | `FormValidationRule[]` |
| `selector` | `string` |
| `conditionalOn` | `string` |

<!-- source: function-ismdasthtmlnode.md -->

# isMdastHTMLNode

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/MdastHTMLNode.ts` (line 44)

Determines if the given node is a HTML MDAST node.

## Signature

```ts
function isMdastHTMLNode(node: Mdast.Nodes): node is MdastHTMLNode
```

## Parameters

| Name | Type |
|---|---|
| `node` | `Mdast.Nodes` |

**Returns:** `node is MdastHTMLNode`

<!-- source: interface-linttestconfig.md -->

# LintTestConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/lint-test-loop.ts` (line 15)

Lint-Test-Fix Loop

Nudge-based post-edit verification. After the agent edits files,
this module generates nudges telling it to run lint/test commands
and tracks retry attempts.

Design: The agent decides whether to lint/test (not forced). Some edits
(adding a comment) don't need it. The nudge makes it a strong suggestion.
If lint/test fails repeatedly, a hard stop is injected.

Integration: Used by AutonomousTurnHook or directly by domain layers.

## Properties

| Property | Type |
|---|---|
| `lintCommand` | `string` |
| `testCommand` | `string` |
| `typeCheckCommand` | `string` |
| `maxRetries` | `number` |
| `minEditsBeforeNudge` | `number` |

<!-- source: function-mergeevalresults.md -->

# mergeEvalResults

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-evaluator.ts` (line 227)

Merge Docker harness evaluation results back into TaskResult objects.
Updates `passed` field based on official harness resolution status.

## Signature

```ts
function mergeEvalResults(taskResults: TaskResult[], evalResults: EvalResult[]): TaskResult[]
```

## Parameters

| Name | Type |
|---|---|
| `taskResults` | `TaskResult[]` |
| `evalResults` | `EvalResult[]` |

**Returns:** `TaskResult[]`

<!-- source: service-organizationservice.md -->

# OrganizationService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/organization/organization.service.ts` (line 20)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `list` | `list(user: JwtPayload)` | `Promise<Organization[]>` |
| `get` | `get(id: string, user: JwtPayload)` | `Promise<Organization>` |
| `update` | `update(id: string, dto: UpdateOrganizationDto, user: JwtPayload)` | `Promise<Organization>` |
| `getMembers` | `getMembers(id: string, user: JwtPayload)` | `Promise<any[]>` |
| `getSettings` | `getSettings(id: string, user: JwtPayload)` | `Promise<Record<string, any>>` |
| `updateSettings` | `updateSettings(id: string, dto: UpdateOrgSettingsDto, user: JwtPayload)` | `Promise<Organization>` |
| `getUserAudiences` | `getUserAudiences(organizationId: string, userId: string, currentUser: JwtPayload)` | `Promise<{ userId: string; audienceIds: string[] }>` |
| `updateUserAudiences` | `updateUserAudiences(organizationId: string, userId: string, dto: UpdateUserAudiencesDto, currentUser: JwtPayload)` | `Promise<{ userId: string; audienceIds: string[] }>` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: class-refreshtokendto.md -->

# RefreshTokenDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/auth/dto/refresh-token.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `refreshToken` | `string` |

<!-- source: function-relationshipstoedges.md -->

# relationshipsToEdges

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Graph/graphUtils.ts` (line 38)

Convert relationships to React Flow edges

## Signature

```ts
function relationshipsToEdges(relationships: KGRelationship[]): GraphEdge[]
```

## Parameters

| Name | Type |
|---|---|
| `relationships` | `KGRelationship[]` |

**Returns:** `GraphEdge[]`

<!-- source: class-requestdeduplicator.md -->

# RequestDeduplicator

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/utils/deduplication.ts` (line 5)

Request deduplication manager
Prevents duplicate requests within a specified time window

## Methods

| Method | Signature | Returns |
|---|---|---|
| `deduplicate` | `deduplicate(method: string, url: string, body: unknown | undefined, executor: () => Promise<T>)` | `Promise<T>` |
| `clear` | `clear()` | `void` |
| `cleanup` | `cleanup()` | `void` |

<!-- source: interface-skeletonbuilderprops.md -->

# SkeletonBuilderProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/DocAutomation/SkeletonBuilder.tsx` (line 21)

## Properties

| Property | Type |
|---|---|
| `skeleton` | `SkeletonStructure | null` |
| `isDirty` | `boolean` |
| `loading` | `boolean` |
| `onAddCategory` | `(category: Omit<SkeletonCategory, 'documents'>) => void` |
| `onRemoveCategory` | `(slug: string) => void` |
| `onUpdateCategory` | `(slug: string, updates: Partial<Omit<SkeletonCategory, 'documents'>>) => void` |
| `onAddDocument` | `(categorySlug: string, document: SkeletonDocument) => void` |
| `onRemoveDocument` | `(categorySlug: string, documentSlug: string) => void` |
| `onUpdateDocument` | `(categorySlug: string, documentSlug: string, updates: Partial<SkeletonDocument>) => void` |
| `onReorderCategories` | `(slugs: string[]) => void` |
| `onReorderDocuments` | `(categorySlug: string, documentSlugs: string[]) => void` |
| `onSave` | `() => Promise<void>` |
| `onReset` | `() => void` |

<!-- source: type-statemanagement.md -->

# StateManagement

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/framework.types.ts` (line 65)

Detected state management

## Definition

```ts
| 'redux'
  | 'zustand'
  | 'jotai'
  | 'recoil'
  | 'mobx'
  | 'pinia'
  | 'vuex'
  | 'ngrx'
  | 'xstate'
  | 'none'
```

<!-- source: interface-chunkresult.md -->

# ChunkResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-02.types.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `chunks` | `Chunk[]` |
| `largeFiles` | `LargeFileSummary[]` |
| `largeFileIndexes` | `LargeFileIndex[]` |
| `autoGeneratedFiles` | `AutoGeneratedFileInfo[]` |
| `relationshipGraph` | `ChunkRelationshipGraph` |
| `stats` | `ChunkStats` |

<!-- source: constant-default-upload-config.md -->

# DEFAULT_UPLOAD_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 473)

## Definition

```ts
UploadConfig
```

<!-- source: api-endpoint-detectflow.md -->

# detectFlow

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/graph.controller.ts` (line 129)

## Endpoint

`GET /knowledge-graph/flow/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `GraphController` (MODULE_DECLARES)

<!-- source: component-directiveeditorcontainer.md -->

# DirectiveEditorContainer

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/directives/DirectiveNode.tsx` (line 120)

## Diagram

```mermaid
graph TD
    component_DirectiveEditorContainer_258feab1["DirectiveEditorContainer"]
    class component_DirectiveEditorContainer_258feab1 rootComponent
```

## Relationships

- RENDERS → `NestedEditorsContext-Provider`
- RENDERS → `Editor`
- USES_HOOK → `useCellValues`

<!-- source: component-fieldstable.md -->

# FieldsTable

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/entity/[entityId]/page.tsx` (line 134)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `fields` | `any[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FieldsTable_3544c969["FieldsTable"]
    class component_FieldsTable_3544c969 rootComponent
```

## Relationships

- RENDERS → `Code`
- RENDERS → `CheckIcon`

## Referenced By

- `EntityDetailPage` (RENDERS)

<!-- source: function-formatasmarkdown.md -->

# formatAsMarkdown

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/state-machine-diagram.generator.ts` (line 403)

Format diagram as markdown code block

## Signature

```ts
function formatAsMarkdown(mermaidCode: string): string
```

## Parameters

| Name | Type |
|---|---|
| `mermaidCode` | `string` |

**Returns:** `string`

<!-- source: interface-formvalidationrule.md -->

# FormValidationRule

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/form-validation-extractor.ts` (line 15)

Form Validation Extractor

Extracts form fields and validation rules from source code across multiple
frameworks (Angular, React, Vue). Goes deeper than template-analyzer's basic
FormField extraction by capturing validation rules, DevExtreme widgets,
and programmatic validator definitions.

## Properties

| Property | Type |
|---|---|
| `type` | `string` |
| `param` | `string` |
| `message` | `string` |

<!-- source: interface-generateddocumentation.md -->

# GeneratedDocumentation

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/user-docs-generator.service.ts` (line 12)

Generated documentation structure

## Properties

| Property | Type |
|---|---|
| `workflows` | `WorkflowDocumentation[]` |
| `overview` | `string` |
| `tableOfContents` | `TableOfContentsItem[]` |
| `metadata` | `{
    generatedAt: Date;
    totalPages: number;
    totalWorkflows: number;
    estimatedReadTime: string;
  }` |

<!-- source: function-ismdastjsxnode.md -->

# isMdastJsxNode

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/index.ts` (line 107)

Determines whether the given node is a JSX node.

## Signature

```ts
function isMdastJsxNode(node: Mdast.Nodes): node is MdastJsx
```

## Parameters

| Name | Type |
|---|---|
| `node` | `Mdast.Nodes` |

**Returns:** `node is MdastJsx`

<!-- source: interface-lintteststate.md -->

# LintTestState

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/lint-test-loop.ts` (line 32)

## Properties

| Property | Type |
|---|---|
| `editsSinceLastVerification` | `number` |
| `editedFiles` | `string[]` |
| `consecutiveFailures` | `number` |
| `verified` | `boolean` |
| `maxRetriesExceeded` | `boolean` |
| `lastVerificationTurn` | `number` |

<!-- source: function-needsapplypatch.md -->

# needsApplyPatch

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/prompt-sections.ts` (line 93)

Only for models that use apply_patch format

## Signature

```ts
function needsApplyPatch(ctx: SectionContext): boolean
```

## Parameters

| Name | Type |
|---|---|
| `ctx` | `SectionContext` |

**Returns:** `boolean`

<!-- source: service-parserservice.md -->

# ParserService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/parser/parser.service.ts` (line 11)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `parse` | `parse(code: string, language: string, filename: string)` | `Promise<ParseResult>` |
| `parseDocument` | `parseDocument(documentId: string)` | `Promise<any>` |
| `getSupportedLanguages` | `getSupportedLanguages()` | `string[]` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `typescriptparser`
- DEPENDS_ON → `javascriptparser`
- DEPENDS_ON → `pythonparser`

<!-- source: class-registerdto.md -->

# RegisterDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/auth/dto/register.dto.ts` (line 14)

Public registration DTO.

SECURITY: This DTO deliberately does NOT accept `organizationId` or `role`.
Open registration always creates a fresh organization with the registrant
as its ADMIN. Joining an existing organization is only possible through
the invitation-token flow (see InvitationService). The global
ValidationPipe uses `whitelist` + `forbidNonWhitelisted`, so payloads
carrying extra fields like `organizationId` are rejected with 400.

## Properties

| Property | Type |
|---|---|
| `email` | `string` |
| `name` | `string` |
| `password` | `string` |

<!-- source: function-remarkscreenshot.md -->

# remarkScreenshot

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/remark-screenshot.ts` (line 9)

Remark plugin to transform <Screenshot> HTML tags into React-compatible format
This ensures ReactMarkdown can properly render the Screenshot component

<!-- source: class-restclient.md -->

# RestClient

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/clients/RestClient.ts` (line 20)

REST client for making HTTP requests

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getInterceptors` | `getInterceptors()` | `InterceptorManager` |
| `setToken` | `setToken(token: string)` | `void` |
| `getToken` | `getToken()` | `string` |
| `request` | `request(config: RequestConfig)` | `Promise<T>` |
| `get` | `get(path: string, params: Record<string, string | number | boolean | undefined>, config: Partial<RequestConfig>)` | `Promise<T>` |
| `post` | `post(path: string, body: unknown, config: Partial<RequestConfig>)` | `Promise<T>` |
| `put` | `put(path: string, body: unknown, config: Partial<RequestConfig>)` | `Promise<T>` |
| `patch` | `patch(path: string, body: unknown, config: Partial<RequestConfig>)` | `Promise<T>` |
| `delete` | `delete(path: string, config: Partial<RequestConfig>)` | `Promise<T>` |

<!-- source: interface-skeletoncategory.md -->

# SkeletonCategory

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationConfig.ts` (line 18)

Category in skeleton structure

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `documents` | `SkeletonDocument[]` |

<!-- source: type-syntaxextension.md -->

# SyntaxExtension

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/importMarkdownToLexical.ts` (line 156)

An extension for the `fromMarkdown` utility markdown parse.

## Definition

```ts
MarkdownParseOptions['syntaxExtensions'][number]
```

<!-- source: interface-chunkstats.md -->

# ChunkStats

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-02.types.ts` (line 155)

## Properties

| Property | Type |
|---|---|
| `inputEntities` | `number` |
| `filteredEntities` | `number` |
| `outputChunks` | `number` |
| `totalTokens` | `number` |
| `avgTokensPerChunk` | `number` |
| `largeFileCount` | `number` |

<!-- source: constant-default-viewport.md -->

# DEFAULT_VIEWPORT

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 444)

## Definition

```ts
Viewport
```

<!-- source: api-endpoint-detectimpact.md -->

# detectImpact

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/graph.controller.ts` (line 137)

## Endpoint

`GET /knowledge-graph/impact/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `GraphController` (MODULE_DECLARES)

<!-- source: component-documentlist-2.md -->

# DocumentList

**Kind:** Component

**Source:** `atloria-monorepo/packages/ui-react/src/components/DocumentList.tsx` (line 37)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `documents` | `Document[]` | ✓ | - |
| `onDocumentClick` | `Function` | - | - |
| `loading` | `boolean` | - | false |
| `emptyMessage` | `string` | - | "No documents found" |

## Diagram

```mermaid
graph TD
    component_DocumentList_6a3928c3["DocumentList"]
    class component_DocumentList_6a3928c3 rootComponent
```

## Relationships

- RENDERS → `DocumentTextIcon`
- RENDERS → `ClockIcon`

<!-- source: component-fieldstable-2.md -->

# FieldsTable

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/technical/entity/[entityId]/page.tsx` (line 78)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `fields` | `any[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FieldsTable_10cc1686["FieldsTable"]
    class component_FieldsTable_10cc1686 rootComponent
```

## Relationships

- RENDERS → `Code`
- RENDERS → `CheckIcon`

## Referenced By

- `PublicEntityDetailPage` (RENDERS)

<!-- source: function-formatcompetitorsforaicontext.md -->

# formatCompetitorsForAIContext

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/competitor-discovery.ts` (line 71)

Format competitor research for AI context

## Signature

```ts
function formatCompetitorsForAIContext(_competitors: CompetitorInfo[], crawledContent: Array<{ competitor: string; url: string; title: string; content: string }>): string
```

## Parameters

| Name | Type |
|---|---|
| `_competitors` | `CompetitorInfo[]` |
| `crawledContent` | `Array<{ competitor: string; url: string; title: string; content: string }>` |

**Returns:** `string`

<!-- source: interface-generateoptions.md -->

# GenerateOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/interfaces/ai-provider.interface.ts` (line 1)

## Properties

| Property | Type |
|---|---|
| `model` | `string` |
| `temperature` | `number` |
| `maxTokens` | `number` |
| `stream` | `boolean` |

<!-- source: interface-headinginfo-2.md -->

# HeadingInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 958)

Heading information in markdown

## Properties

| Property | Type |
|---|---|
| `level` | `number` |
| `text` | `string` |
| `line` | `number` |

<!-- source: function-ismdasttext.md -->

# isMdastText

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/LexicalTextVisitor.ts` (line 19)

## Signature

```ts
function isMdastText(mdastNode: Mdast.Nodes): mdastNode is Mdast.Text
```

## Parameters

| Name | Type |
|---|---|
| `mdastNode` | `Mdast.Nodes` |

**Returns:** `mdastNode is Mdast.Text`

<!-- source: interface-listdirectoryoptions.md -->

# ListDirectoryOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/list-directory.tool.ts` (line 13)

## Properties

| Property | Type |
|---|---|
| `maxDepth` | `number` |
| `excludePatterns` | `string[]` |
| `rootDir` | `string` |

<!-- source: function-parseevalresults.md -->

# parseEvalResults

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-evaluator.ts` (line 186)

Parse evaluation results from the harness output.

The harness writes results to `{run_id}/results.json` with format:
```json
{
  "instance_id": {
    "resolved": true|false,
    "tests_status": { "FAIL_TO_PASS": {...}, "PASS_TO_PASS": {...} }
  }
}
```

## Signature

```ts
function parseEvalResults(resultsDir: string): EvalResult[]
```

## Parameters

| Name | Type |
|---|---|
| `resultsDir` | `string` |

**Returns:** `EvalResult[]`

<!-- source: service-parsingservice.md -->

# ParsingService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/parsing/parsing.service.ts` (line 7)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `startParsing` | `startParsing(projectId: string, dto: ParseProjectDto)` | `Promise<ParseStatusDto>` |
| `getParseStatus` | `getParseStatus(projectId: string, jobId: string)` | `Promise<ParseStatusDto>` |
| `cancelParsing` | `cancelParsing(projectId: string, jobId: string)` | `Promise<{ success: boolean; message: string }>` |
| `getProjectParsingJobs` | `getProjectParsingJobs(projectId: string, limit: number)` | `Promise<ParseStatusDto[]>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `parsingqueue`

<!-- source: class-reordercolumnsdto.md -->

# ReorderColumnsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/boards/dto/column.dto.ts` (line 48)

## Properties

| Property | Type |
|---|---|
| `columnIds` | `string[]` |

<!-- source: function-robots.md -->

# robots

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/robots.ts` (line 10)

robots.txt — allow crawlers (incl. AI crawlers) to index published docs under /p/,
keep the authenticated app (/app) and API-ish paths out, and advertise the sitemap.
Per-site llms.txt is discovered via the <link rel="alternate"> hints in each site's <head>.

## Signature

```ts
function robots(): MetadataRoute.Robots
```

**Returns:** `MetadataRoute.Robots`

<!-- source: class-routetemplatelinker.md -->

# RouteTemplateLinker

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/services/route-template-linker.ts` (line 31)

Route-Template Linker Service

## Methods

| Method | Signature | Returns |
|---|---|---|
| `linkRoutes` | `linkRoutes(files: Map<string, string>, framework: FrameworkType)` | `RouteMappingResult` |

<!-- source: interface-skeletondocument.md -->

# SkeletonDocument

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationConfig.ts` (line 8)

Document in skeleton structure

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `features` | `string[]` |
| `screenshots` | `{ path: string; name: string }[]` |

<!-- source: type-themeeventlistener.md -->

# ThemeEventListener

**Kind:** Type

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 155)

Theme event listener

## Definition

```ts
(event: ThemeUpdateEvent) => void
```

<!-- source: interface-claimtoverify.md -->

# ClaimToVerify

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/openai-reviewer.service.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `claim` | `string` |

<!-- source: constant-default-worker-url.md -->

# DEFAULT_WORKER_URL

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.config.ts` (line 13)

Default URL for the screenshot-worker service

<!-- source: api-endpoint-diffdocument.md -->

# diffDocument

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 75)

## Endpoint

`GET /doc-versions/:projectId/compare/document`

| Parameter | In | Type | Required |
|---|---|---|---|
| `docA` | query | `string` | ✓ |
| `docB` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-downshiftautocomplete.md -->

# DownshiftAutoComplete

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/ui/DownshiftAutoComplete.tsx` (line 21)

## Diagram

```mermaid
graph TD
    component_DownshiftAutoComplete_2ca298fb["DownshiftAutoComplete"]
    class component_DownshiftAutoComplete_2ca298fb rootComponent
```

## Relationships

- RENDERS → `DownshiftAutoCompleteWithSuggestions`

<!-- source: component-filterbutton.md -->

# FilterButton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/SymbolList.tsx` (line 124)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |
| `active` | `boolean` | ✓ | - |
| `onClick` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FilterButton_3226009c["FilterButton"]
    class component_FilterButton_3226009c rootComponent
```

## Referenced By

- `SymbolList` (RENDERS)

<!-- source: function-formatdeploymentasmarkdown.md -->

# formatDeploymentAsMarkdown

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/deployment-diagram.generator.ts` (line 522)

Format deployment diagram as markdown

## Signature

```ts
function formatDeploymentAsMarkdown(mermaidCode: string): string
```

## Parameters

| Name | Type |
|---|---|
| `mermaidCode` | `string` |

**Returns:** `string`

<!-- source: interface-graphentity.md -->

# GraphEntity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/search-index.ts` (line 59)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `type` | `string` |

<!-- source: interface-hierarchydiagramresult.md -->

# HierarchyDiagramResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/component-hierarchy-diagram.generator.ts` (line 70)

Result of hierarchy diagram generation

## Properties

| Property | Type |
|---|---|
| `mermaidCode` | `string` |
| `stats` | `{
    /** Total components in diagram */
    totalComponents: number;
    /** Maximum depth reached */
    maxDepth: number;
    /** Number of leaf components (no children) */
    leafComponents: number;
    /** Total relationships shown */
    totalRelationships: number;
  }` |
| `cssClasses` | `string[]` |

<!-- source: function-isreasoningmodel.md -->

# isReasoningModel

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/azure-responses.provider.ts` (line 47)

GPT-5 series (gpt-5, gpt-5.1/.2/.4/.5, gpt-5.3-codex) and the o-series (o1/o3/o4)
are REASONING models. On the Responses API they reject sampling params
(`temperature`, `top_p`, penalties, `stop`, `max_tokens`) with a 400, and are
instead steered by `reasoning.effort` + `text.verbosity`. The non-reasoning chat
variant `gpt-5-chat` still takes `temperature`, so it's excluded here.

## Signature

```ts
function isReasoningModel(model: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `model` | `string` |

**Returns:** `boolean`

<!-- source: interface-livesweloopoptions.md -->

# LiveSweLoopOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/live-swe-loop.ts` (line 71)

Options for the Live-SWE loop.

## Properties

| Property | Type |
|---|---|
| `maxRequeries` | `number` |
| `historyProcessors` | `HistoryProcessor[]` |

<!-- source: function-parseissues.md -->

# parseIssues

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/confidence-filter.ts` (line 51)

Parse scored issues from agent output text.

Tries line-format first (one issue per line), then falls back to JSON array.
Returns empty array if neither format is found.

## Signature

```ts
function parseIssues(agentOutput: string, agentName: string): ScoredIssue[]
```

## Parameters

| Name | Type |
|---|---|
| `agentOutput` | `string` |
| `agentName` | `string` |

**Returns:** `ScoredIssue[]`

<!-- source: service-playwrightgeneratorservice.md -->

# PlaywrightGeneratorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/ai/services/playwright-generator.service.ts` (line 47)

Playwright Test Generator Service

Generates comprehensive Playwright tests from UI documentation:
1. Page Object Models
2. Test suites with fixtures
3. Selectors and utilities
4. Test data generators

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generateTestSuite` | `generateTestSuite(pageDoc: {
    path: string;
    component: string;
    title: string;
    description: string;
    elements: any[];
    validations: any[];
    interactions: any[];
  })` | `Promise<PlaywrightTestSuite>` |
| `writeTestSuite` | `writeTestSuite(suite: PlaywrightTestSuite, outputDir: string)` | `Promise<void>` |

## Relationships

- DEPENDS_ON → `aiservice`

<!-- source: class-repositorycredentialsdto.md -->

# RepositoryCredentialsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/parsing/dto/parse-project.dto.ts` (line 47)

## Properties

| Property | Type |
|---|---|
| `username` | `string` |
| `password` | `string` |
| `sshKey` | `string` |

<!-- source: function-savefilters.md -->

# saveFilters

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 149)

## Signature

```ts
function saveFilters(boardId: string, f: BoardFiltersState)
```

## Parameters

| Name | Type |
|---|---|
| `boardId` | `string` |
| `f` | `BoardFiltersState` |

<!-- source: class-screenshotworkerclient.md -->

# ScreenshotWorkerClient

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.client.ts` (line 35)

Client for interacting with the screenshot-worker API

## Methods

| Method | Signature | Returns |
|---|---|---|
| `submitBatch` | `submitBatch(request: ScreenshotBatchRequest)` | `Promise<BatchJobResponse>` |
| `getJobStatus` | `getJobStatus(jobId: string, organizationId: string)` | `Promise<BatchStatusResponse | null>` |
| `waitForCompletion` | `waitForCompletion(jobId: string, organizationId: string, timeoutMs: number)` | `Promise<BatchStatusResponse>` |

<!-- source: interface-skeletonstructure.md -->

# SkeletonStructure

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationConfig.ts` (line 27)

Skeleton structure for documentation

## Properties

| Property | Type |
|---|---|
| `categories` | `SkeletonCategory[]` |

<!-- source: type-themeeventtype.md -->

# ThemeEventType

**Kind:** Type

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 150)

Theme engine event types

## Definition

```ts
'theme-change' | 'mode-change'
```

<!-- source: interface-claimverification.md -->

# ClaimVerification

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-11.types.ts` (line 52)

## Properties

| Property | Type |
|---|---|
| `claimId` | `string` |
| `status` | `'verified' | 'flagged' | 'uncertain'` |
| `groundingScore` | `number` |
| `openaiScore` | `number` |
| `issues` | `string[]` |

<!-- source: constant-defaultcodeblocklanguage.md -->

# defaultCodeBlockLanguage$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/index.ts` (line 76)

Contains the default language to use when creating a new code block if no language is passed.

<!-- source: api-endpoint-disconnect.md -->

# disconnect

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/bitbucket/bitbucket.controller.ts` (line 89)

## Endpoint

`POST /bitbucket/disconnect`

## Referenced By

- `BitbucketController` (MODULE_DECLARES)

<!-- source: component-editimagetoolbar.md -->

# EditImageToolbar

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/EditImageToolbar.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `nodeKey` | `string` | ✓ | - |
| `imageSource` | `string` | ✓ | - |
| `initialImagePath` | `string | null` | ✓ | - |
| `title` | `string` | ✓ | - |
| `alt` | `string` | ✓ | - |
| `width` | `number | unknown` | - | - |
| `height` | `number | unknown` | - | - |

## Diagram

```mermaid
graph TD
    component_EditImageToolbar_35492e0e["EditImageToolbar"]
    class component_EditImageToolbar_35492e0e rootComponent
```

## Relationships

- USES_HOOK → `useCellValues`
- USES_HOOK → `useLexicalComposerContext`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useTranslation`

<!-- source: component-filterbutton-2.md -->

# FilterButton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Suggestions/SuggestionPanel.tsx` (line 158)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `active` | `boolean` | ✓ | - |
| `onClick` | `Function` | ✓ | - |
| `count` | `number` | ✓ | - |
| `variant` | `unknown | unknown | unknown` | - | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FilterButton_6084db22["FilterButton"]
    class component_FilterButton_6084db22 rootComponent
```

## Referenced By

- `SuggestionPanel` (RENDERS)

<!-- source: function-formathierarchyasmarkdown.md -->

# formatHierarchyAsMarkdown

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/component-hierarchy-diagram.generator.ts` (line 424)

Format diagram as markdown code block

## Signature

```ts
function formatHierarchyAsMarkdown(mermaidCode: string): string
```

## Parameters

| Name | Type |
|---|---|
| `mermaidCode` | `string` |

**Returns:** `string`

<!-- source: interface-graphrelationship.md -->

# GraphRelationship

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/search-index.ts` (line 64)

## Properties

| Property | Type |
|---|---|
| `sourceId` | `string` |
| `targetId` | `string` |
| `type` | `string` |

<!-- source: interface-hookentity-2.md -->

# HookEntity

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 917)

Hook entity (React)

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.HOOK` |
| `returnType` | `string` |
| `parameters` | `ParameterDefinition[]` |
| `dependencies` | `string[]` |
| `isCustom` | `boolean` |

<!-- source: function-isrecoverable.md -->

# isRecoverable

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/errors.ts` (line 296)

Check if an error is recoverable

## Signature

```ts
function isRecoverable(error: unknown): boolean
```

## Parameters

| Name | Type |
|---|---|
| `error` | `unknown` |

**Returns:** `boolean`

<!-- source: interface-loadedplugin.md -->

# LoadedPlugin

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/plugins/plugin-types.ts` (line 104)

A fully loaded and validated plugin ready for registration.

## Properties

| Property | Type |
|---|---|
| `manifest` | `PluginManifest` |
| `rootDir` | `string` |
| `commands` | `CommandDefinition[]` |
| `agents` | `AgentDefinition[]` |
| `skills` | `SkillDefinition[]` |

<!-- source: function-parsememoryextractionresponse.md -->

# parseMemoryExtractionResponse

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/session-memory.ts` (line 148)

Parse the model's response into SessionMemory objects.
Handles common response formats (raw JSON, markdown-wrapped JSON, etc.).

## Signature

```ts
function parseMemoryExtractionResponse(response: string): SessionMemory[]
```

## Parameters

| Name | Type |
|---|---|
| `response` | `string` |

**Returns:** `SessionMemory[]`

<!-- source: service-pmeservice.md -->

# PmeService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/pme/pme.service.ts` (line 9)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createJob` | `createJob(dto: CreatePmeJobDto, userId: string)` | `unknown` |
| `getJob` | `getJob(jobId: string)` | `unknown` |
| `getJobsByProject` | `getJobsByProject(projectId: string)` | `unknown` |
| `getVariants` | `getVariants(jobId: string)` | `unknown` |
| `selectVariant` | `selectVariant(variantId: string)` | `unknown` |
| `startStrategy` | `startStrategy(dto: CreatePmeJobDto, userId: string)` | `unknown` |
| `finalizePage` | `finalizePage(dto: FinalizePmePageDto)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `queue`

<!-- source: class-resetpassworddto.md -->

# ResetPasswordDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/auth/dto/password.dto.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `token` | `string` |
| `password` | `string` |

<!-- source: function-scorestaticindex.md -->

# scoreStaticIndex

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/staticSearch.ts` (line 71)

Rank the static index for a query. Returns modal-ready results (highest
first), dropping docs that match no query term. Pure + deterministic.

## Signature

```ts
function scoreStaticIndex(index: StaticSearchIndex, query: string, limit): StaticSearchResult[]
```

## Parameters

| Name | Type |
|---|---|
| `index` | `StaticSearchIndex` |
| `query` | `string` |
| `limit` | `any` |

**Returns:** `StaticSearchResult[]`

<!-- source: class-servererror.md -->

# ServerError

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/types/errors.ts` (line 88)

Server error (5xx)

**Extends:** `APIError`

<!-- source: interface-staticsearchdoc.md -->

# StaticSearchDoc

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/staticSearch.ts` (line 16)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `url` | `string` |
| `documentType` | `SearchDocType` |
| `headings` | `string[]` |
| `excerpt` | `string` |
| `tokens` | `string[]` |
| `boost` | `number` |

<!-- source: type-thememode-2.md -->

# ThemeMode

**Kind:** Type

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 120)

Theme mode

## Definition

```ts
'light' | 'dark' | 'system'
```

<!-- source: interface-claimverificationresult.md -->

# ClaimVerificationResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/openai-reviewer.service.ts` (line 29)

## Properties

| Property | Type |
|---|---|
| `claimId` | `string` |
| `verdict` | `'verified' | 'flagged' | 'uncertain'` |
| `confidence` | `number` |
| `issue` | `string` |
| `suggestion` | `string` |

<!-- source: constant-defaultdarktokens.md -->

# defaultDarkTokens

**Kind:** Constant

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/default-tokens.ts` (line 131)

Default dark theme tokens

## Definition

```ts
ThemeTokens
```

<!-- source: api-endpoint-disconnect-2.md -->

# disconnect

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/github/github.controller.ts` (line 109)

Disconnect GitHub from user account

## Endpoint

`POST /github/disconnect`

## Referenced By

- `GitHubController` (MODULE_DECLARES)

<!-- source: component-editorchild.md -->

# EditorChild

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/link/index.tsx` (line 36)

## Diagram

```mermaid
graph TD
    component_EditorChild_72e8cdd4["EditorChild"]
    class component_EditorChild_72e8cdd4 rootComponent
```

## Relationships

- RENDERS → `LexicalLinkPlugin`
- RENDERS → `LexicalAutoLinkPlugin`

<!-- source: component-filterpill.md -->

# FilterPill

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Comments/CommentSidebar.tsx` (line 144)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `value` | `CommentFilter` | ✓ | - |
| `label` | `string` | ✓ | - |
| `count` | `number` | - | - |

## Diagram

```mermaid
graph TD
    component_FilterPill_46adcadd["FilterPill"]
    class component_FilterPill_46adcadd rootComponent
```

## Referenced By

- `CommentSidebar` (RENDERS)

<!-- source: function-formatschemaasmarkdown.md -->

# formatSchemaAsMarkdown

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/database-schema-diagram.generator.ts` (line 357)

Format database schema diagram as markdown

## Signature

```ts
function formatSchemaAsMarkdown(mermaidCode: string): string
```

## Parameters

| Name | Type |
|---|---|
| `mermaidCode` | `string` |

**Returns:** `string`

<!-- source: interface-hookinfo-2.md -->

# HookInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 41)

Information about a hook usage

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `'built-in' | 'custom'` |
| `location` | `string` |
| `dependencies` | `string[]` |

<!-- source: interface-import.md -->

# Import

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/parser/interfaces/code-parser.interface.ts` (line 51)

## Properties

| Property | Type |
|---|---|
| `module` | `string` |
| `symbols` | `string[]` |
| `isDefault` | `boolean` |
| `alias` | `string` |

<!-- source: function-isvalidslug.md -->

# isValidSlug

**Kind:** Function

**Source:** `atloria-monorepo/packages/core/src/utils/slug.ts` (line 20)

Validate a slug format

## Signature

```ts
function isValidSlug(slug: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `slug` | `string` |

**Returns:** `boolean`

<!-- source: interface-loopstate.md -->

# LoopState

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/autonomous-loop.ts` (line 389)

Tracks which "phases" the agent has entered based on tool calls.
Used to decide when to nudge. Exported so runners can inspect/display it.

## Properties

| Property | Type |
|---|---|
| `hasInvestigated` | `boolean` |
| `hasPlanned` | `boolean` |
| `hasActed` | `boolean` |
| `hasVerified` | `boolean` |
| `lastInvestigationTurn` | `number` |
| `lastActionTurn` | `number` |
| `consecutiveErrors` | `number` |
| `totalErrors` | `number` |
| `circuitBreakerBlocks` | `Record<string, number>` |

<!-- source: function-parseprediction.md -->

# parsePrediction

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-evaluator.ts` (line 72)

Parse a JSONL line back to a prediction object.

## Signature

```ts
function parsePrediction(line: string): SWEBenchPrediction
```

## Parameters

| Name | Type |
|---|---|
| `line` | `string` |

**Returns:** `SWEBenchPrediction`

<!-- source: service-projectdomainsservice.md -->

# ProjectDomainsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/project/project-domains.service.ts` (line 38)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `get` | `get(projectId: string, user: JwtPayload)` | `Promise<CustomDomainView | null>` |
| `create` | `create(projectId: string, user: JwtPayload, rawDomain: string)` | `Promise<CustomDomainView>` |
| `check` | `check(projectId: string, user: JwtPayload)` | `unknown` |
| `retry` | `retry(projectId: string, user: JwtPayload)` | `Promise<CustomDomainView>` |
| `remove` | `remove(projectId: string, user: JwtPayload)` | `Promise<{ ok: boolean; warning?: string }>` |
| `resolvePublicHost` | `resolvePublicHost(host: string)` | `Promise<{ publishedSlug: string; urlId: string } | null>` |
| `reconcile` | `reconcile()` | `unknown` |
| `monitor` | `monitor()` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `domaindnsservice`
- DEPENDS_ON → `k8singressservice`
- DEPENDS_ON → `emailservice`

<!-- source: class-reshootlocalesdto.md -->

# ReshootLocalesDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/capture/dto/update-flow.dto.ts` (line 62)

SUPERIOR: re-shoot the WHOLE recipe under N locales in one run, emitting a
localized screenshot set per locale (blob-namespaced by locale).

## Properties

| Property | Type |
|---|---|
| `locales` | `string[]` |
| `viewport` | `ReshootViewportDto` |

<!-- source: function-sitemap.md -->

# sitemap

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/sitemap.ts` (line 13)

Dynamic sitemap — only includes pages from ACTIVE versions.
Non-active version pages are crawlable via links but excluded.

Structure generated:
  /p/{slugWithId}                              — project landing
  /p/{slugWithId}/{audienceSlug}               — audience landing
  /p/{slugWithId}/{audienceSlug}/{docSlug}     — document page

## Signature

```ts
async function sitemap(): Promise<MetadataRoute.Sitemap>
```

**Returns:** `Promise<MetadataRoute.Sitemap>`

<!-- source: class-springdetector.md -->

# SpringDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/spring-detector.ts` (line 130)

Spring Boot Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectControllers` | `detectControllers(entities: Entity[])` | `DetectedSpringController[]` |
| `detectServices` | `detectServices(entities: Entity[])` | `DetectedSpringService[]` |
| `detectEntities` | `detectEntities(entities: Entity[])` | `DetectedJPAEntity[]` |
| `getControllerSummary` | `getControllerSummary(controller: DetectedSpringController)` | `string` |

<!-- source: interface-staticsearchindex.md -->

# StaticSearchIndex

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/staticSearch.ts` (line 27)

## Properties

| Property | Type |
|---|---|
| `v` | `number` |
| `slugWithId` | `string` |
| `generatedAt` | `string` |
| `count` | `number` |
| `docs` | `StaticSearchDoc[]` |

<!-- source: type-thememode-3.md -->

# ThemeMode

**Kind:** Type

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/theme.ts` (line 8)

Theme Engine

CSS custom properties approach: one set of components, multiple theme presets.
Client-side toggle via JS, persisted to localStorage.

## Definition

```ts
'dark' | 'light' | 'colorful'
```

<!-- source: interface-claudeconfig.md -->

# ClaudeConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/claude.provider.ts` (line 165)

## Properties

| Property | Type |
|---|---|
| `azureEndpoint` | `string` |
| `azureApiKey` | `string` |
| `azureAccessToken` | `string` |
| `anthropicApiKey` | `string` |
| `model` | `string` |
| `maxTokens` | `number` |
| `temperature` | `number` |
| `timeout` | `number` |
| `retry` | `Partial<RetryConfig>` |

<!-- source: constant-defaultlighttokens.md -->

# defaultLightTokens

**Kind:** Constant

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/default-tokens.ts` (line 7)

Default Atloria theme tokens
These match the CSS variables defined in global.css

## Definition

```ts
ThemeTokens
```

<!-- source: api-endpoint-disconnect-3.md -->

# disconnect

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/gitlab/gitlab.controller.ts` (line 109)

Disconnect GitLab from user account

## Endpoint

`POST /gitlab/disconnect`

## Referenced By

- `GitLabController` (MODULE_DECLARES)

<!-- source: component-editorinaform.md -->

# EditorInAForm

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/link-dialog.tsx` (line 121)

## Diagram

```mermaid
graph TD
    component_EditorInAForm_1785f799["EditorInAForm"]
    class component_EditorInAForm_1785f799 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `CreateLink`

<!-- source: component-filterpopover.md -->

# FilterPopover

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 295)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `anchorRect` | `DOMRect` | ✓ | - |
| `filters` | `BoardFiltersState` | ✓ | - |
| `options` | `ReturnType` | ✓ | - |
| `onChange` | `Function` | ✓ | - |
| `onClose` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FilterPopover_7619f95e["FilterPopover"]
    class component_FilterPopover_7619f95e rootComponent
```

## Relationships

- RENDERS → `FilterSection`
- RENDERS → `CheckIcon`
- RENDERS → `AssigneeRow`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

## Referenced By

- `BoardFiltersButton` (RENDERS)

<!-- source: function-formatscreenshotplanmarkdown.md -->

# formatScreenshotPlanMarkdown

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/screenshot-instruction-generator.ts` (line 568)

Format screenshot plan as markdown

## Signature

```ts
function formatScreenshotPlanMarkdown(plan: ScreenshotPlan): string
```

## Parameters

| Name | Type |
|---|---|
| `plan` | `ScreenshotPlan` |

**Returns:** `string`

<!-- source: interface-hookusage-2.md -->

# HookUsage

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 439)

Hook usage in a component

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `'built-in' | 'custom'` |
| `location` | `string` |
| `dependencies` | `string[]` |

<!-- source: function-isvisible-2.md -->

# isVisible

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-core/src/test-helpers.ts` (line 66)

Helper to check if an element is visible

## Signature

```ts
function isVisible(element: HTMLElement): boolean
```

## Parameters

| Name | Type |
|---|---|
| `element` | `HTMLElement` |

**Returns:** `boolean`

<!-- source: interface-jobcompletiondata.md -->

# JobCompletionData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/doc-automation.service.ts` (line 66)

## Properties

| Property | Type |
|---|---|
| `documentsCreated` | `number` |
| `documentsUpdated` | `number` |
| `categoriesCreated` | `number` |
| `screenshotsCaptured` | `number` |
| `durationMs` | `number` |
| `commitHash` | `string` |
| `publishedUrl` | `string` |
| `routeMappings` | `unknown` |
| `metrics` | `unknown` |
| `stageResults` | `unknown` |

<!-- source: interface-markerresult.md -->

# MarkerResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/watch-mode.ts` (line 13)

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `relativePath` | `string` |
| `line` | `number` |
| `marker` | `string` |
| `instruction` | `string` |
| `context` | `string` |

<!-- source: function-parsereviewresponse.md -->

# parseReviewResponse

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/self-review.ts` (line 104)

Parse a structured review response into a ReviewResult.
Handles both JSON responses and free-text responses.

## Signature

```ts
function parseReviewResponse(response: string): ReviewResult
```

## Parameters

| Name | Type |
|---|---|
| `response` | `string` |

**Returns:** `ReviewResult`

<!-- source: service-projectservice.md -->

# ProjectService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/project/project.service.ts` (line 40)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `create` | `create(dto: CreateProjectDto, user: JwtPayload)` | `Promise<Project>` |
| `list` | `list(user: JwtPayload)` | `Promise<Project[]>` |
| `get` | `get(id: string, user: JwtPayload)` | `Promise<Project>` |
| `update` | `update(id: string, dto: UpdateProjectDto, user: JwtPayload)` | `Promise<Project>` |
| `delete` | `delete(id: string, user: JwtPayload)` | `Promise<void>` |
| `getMembers` | `getMembers(id: string, user: JwtPayload)` | `Promise<ProjectMember[]>` |
| `addMember` | `addMember(id: string, dto: AddMemberDto, user: JwtPayload)` | `Promise<ProjectMember>` |
| `updateMemberRole` | `updateMemberRole(id: string, userId: string, dto: UpdateMemberRoleDto, user: JwtPayload)` | `Promise<ProjectMember>` |
| `removeMember` | `removeMember(id: string, userId: string, user: JwtPayload)` | `Promise<void>` |
| `getSettings` | `getSettings(id: string, user: JwtPayload)` | `Promise<Record<string, any>>` |
| `updateSettings` | `updateSettings(id: string, dto: UpdateSettingsDto, user: JwtPayload)` | `Promise<Project>` |
| `getStats` | `getStats(id: string, user: JwtPayload)` | `unknown` |
| `publish` | `publish(id: string, user: JwtPayload)` | `Promise<PublishedProjectResult>` |
| `resolveAvailableSlug` | `resolveAvailableSlug(desired: string, selfId: string)` | `Promise<string>` |
| `checkSlugAvailability` | `checkSlugAvailability(id: string, desired: string, user: JwtPayload)` | `unknown` |
| `setPublishedSlug` | `setPublishedSlug(id: string, desired: string, user: JwtPayload)` | `unknown` |
| `unpublish` | `unpublish(id: string, user: JwtPayload)` | `Promise<Project>` |
| `getPublishedByUrlId` | `getPublishedByUrlId(urlId: string)` | `Promise<Project>` |
| `getPublishedBySlug` | `getPublishedBySlug(publishedSlug: string)` | `Promise<Project>` |
| `getProjectAudiences` | `getProjectAudiences(id: string, docVersionId: string | string[])` | `unknown` |
| `getAudienceDocuments` | `getAudienceDocuments(projectId: string, audienceSlug: string, docVersionId: string)` | `unknown` |
| `getPublishedDocument` | `getPublishedDocument(projectId: string, audienceSlug: string, documentSlug: string, docVersionId: string)` | `Promise<{
    id: string;
    title: string;
    slug: string;
    content: string;
    toc: TocEntry[];
    order: number | null;
    categoryId: string | null;
    pageType: string | null;
    updatedAt: Date;
    category: {
      id: string;
      name: string;
      slug: string;
      icon: string | null;
      color: string | null;
    } | null;
  }>` |
| `getRelatedDocuments` | `getRelatedDocuments(projectId: string, audienceSlug: string, documentSlug: string, docVersionId: string, limit: unknown)` | `Promise<
    Array<{
      id: string;
      slug: string;
      title: string;
      category: { name: string; slug: string } | null;
    }>
  >` |
| `resolvePublicDocVersionId` | `resolvePublicDocVersionId(projectId: string, opts: { version?: string; lang?: string; audienceScope?: string })` | `Promise<string | null>` |
| `getActiveScopeDocVersionIds` | `getActiveScopeDocVersionIds(projectId: string, lang: string)` | `Promise<string[]>` |
| `resolveVersion` | `resolveVersion(projectId: string, versionNumber: number)` | `unknown` |
| `getPublishedVersions` | `getPublishedVersions(projectId: string)` | `unknown` |
| `getPublishedLanguages` | `getPublishedLanguages(projectId: string)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `urlservice`
- DEPENDS_ON → `tocbuilderservice`
- DEPENDS_ON → `techdocsragservice`

<!-- source: class-reshootstepdto.md -->

# ReshootStepDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/capture/dto/update-flow.dto.ts` (line 45)

Re-shoot ONE step of a stored flow. The worker walks the recipe up to this step
(in one Playwright context) and re-captures just its screenshot, optionally at a
new viewport size / UI locale. Any redaction boxes stored on the step are burned
into the fresh asset before upload.

## Properties

| Property | Type |
|---|---|
| `viewport` | `ReshootViewportDto` |
| `locale` | `string` |

<!-- source: function-slainfo.md -->

# slaInfo

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 211)

SLA countdown chip. Live-ticks: pass a `now` timestamp refreshed on an interval.
Quiet gray 'SLA 22m' → amber warn → red 'SLA -4m' breach.

## Signature

```ts
function slaInfo(t: Pick<DeskThread, 'slaDueAt' | 'slaState' | 'status' | 'firstAgentReplyAt' | 'snoozedUntil'>, now: number): { label: string; tone: 'ok' | 'warn' | 'breach' } | null
```

## Parameters

| Name | Type |
|---|---|
| `t` | `Pick<DeskThread, 'slaDueAt' | 'slaState' | 'status' | 'firstAgentReplyAt' | 'snoozedUntil'>` |
| `now` | `number` |

**Returns:** `{ label: string; tone: 'ok' | 'warn' | 'breach' } | null`

<!-- source: class-stageresultstore.md -->

# StageResultStore

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/stage-result-store.ts` (line 31)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `setParseResult` | `setParseResult(result: ParseResult)` | `void` |
| `setChunkResult` | `setChunkResult(result: ChunkResult)` | `void` |
| `setFeatureResult` | `setFeatureResult(result: FeatureResult)` | `void` |
| `setAnalysisResult` | `setAnalysisResult(result: AnalysisResult)` | `void` |
| `setSynthesisResult` | `setSynthesisResult(result: SynthesisResult)` | `void` |
| `setStructureResult` | `setStructureResult(result: StructureResult)` | `void` |
| `setPhaseResult` | `setPhaseResult(result: PhaseResult)` | `void` |
| `setSessionResult` | `setSessionResult(result: SessionResult)` | `void` |
| `setPlanResult` | `setPlanResult(result: PlanResult)` | `void` |
| `setGenerationResult` | `setGenerationResult(result: GenerationResult)` | `void` |
| `setVerificationResult` | `setVerificationResult(result: VerificationResult)` | `void` |
| `setMetaDocResult` | `setMetaDocResult(result: MetaDocumentationResult)` | `void` |
| `setKnowledgeReferenceStore` | `setKnowledgeReferenceStore(store: KnowledgeReferenceStore)` | `void` |
| `getParseResult` | `getParseResult()` | `ParseResult | undefined` |
| `getChunkResult` | `getChunkResult()` | `ChunkResult | undefined` |
| `getFeatureResult` | `getFeatureResult()` | `FeatureResult | undefined` |
| `getAnalysisResult` | `getAnalysisResult()` | `AnalysisResult | undefined` |
| `getSynthesisResult` | `getSynthesisResult()` | `SynthesisResult | undefined` |
| `getStructureResult` | `getStructureResult()` | `StructureResult | undefined` |
| `getPhaseResult` | `getPhaseResult()` | `PhaseResult | undefined` |
| `getSessionResult` | `getSessionResult()` | `SessionResult | undefined` |
| `getPlanResult` | `getPlanResult()` | `PlanResult | undefined` |
| `getGenerationResult` | `getGenerationResult()` | `GenerationResult | undefined` |
| `getVerificationResult` | `getVerificationResult()` | `VerificationResult | undefined` |
| `getMetaDocResult` | `getMetaDocResult()` | `MetaDocumentationResult | undefined` |
| `getKnowledgeReferenceStore` | `getKnowledgeReferenceStore()` | `KnowledgeReferenceStore | undefined` |
| `getKnowledgeReference` | `getKnowledgeReference(category: MetaKnowledgeCategory)` | `MetaCategoryReference | undefined` |
| `getChunkAnalysis` | `getChunkAnalysis(chunkId: string)` | `ChunkAnalysis | undefined` |
| `getChunkAnalyses` | `getChunkAnalyses()` | `ChunkAnalysis[]` |
| `getChunksForFeature` | `getChunksForFeature(featureId: string)` | `string[]` |
| `getFeaturesForChunk` | `getFeaturesForChunk(chunkId: string)` | `string[]` |
| `getChunkById` | `getChunkById(chunkId: string)` | `Chunk | undefined` |
| `getFeatureById` | `getFeatureById(featureId: string)` | `UserFeature | undefined` |
| `getEntitiesForChunk` | `getEntitiesForChunk(chunkId: string)` | `Entity[]` |
| `clear` | `clear()` | `void` |
| `getMemoryEstimate` | `getMemoryEstimate()` | `number` |

<!-- source: interface-staticsearchresult.md -->

# StaticSearchResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/staticSearch.ts` (line 35)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `url` | `string` |
| `documentType` | `SearchDocType` |
| `snippet` | `string` |
| `score` | `number` |

<!-- source: type-tomarkdownextension.md -->

# ToMarkdownExtension

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/exportMarkdownFromLexical.ts` (line 387)

## Definition

```ts
NonNullable<ToMarkdownOptions['extensions']>[number]
```

<!-- source: interface-claudegenerateoptions.md -->

# ClaudeGenerateOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/claude.provider.ts` (line 197)

## Properties

| Property | Type |
|---|---|
| `maxTokens` | `number` |
| `temperature` | `number` |
| `systemPrompt` | `string` |
| `messages` | `ClaudeMessage[]` |
| `stopSequences` | `string[]` |

<!-- source: constant-defaults.md -->

# DEFAULTS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 326)

<!-- source: api-endpoint-downloadsdk.md -->

# downloadSdk

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-mcp.controller.ts` (line 255)

## Endpoint

`GET /technical-docs/:projectId/sdk.ts`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsMcpController` (MODULE_DECLARES)

<!-- source: component-editorrootelement.md -->

# EditorRootElement

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/MDXEditor.tsx` (line 194)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |
| `className` | `any` | ✓ | - |
| `overlayContainer` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_EditorRootElement_2f524900["EditorRootElement"]
    class component_EditorRootElement_2f524900 rootComponent
```

## Relationships

- USES_HOOK → `useRef`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useEffect`

<!-- source: component-filtersection.md -->

# FilterSection

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 492)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `title` | `string` | ✓ | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FilterSection_16d326e2["FilterSection"]
    class component_FilterSection_16d326e2 rootComponent
```

## Referenced By

- `FilterPopover` (RENDERS)

<!-- source: function-formatsequenceasmarkdown.md -->

# formatSequenceAsMarkdown

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/sequence-diagram.generator.ts` (line 468)

Format sequence diagram as markdown

## Signature

```ts
function formatSequenceAsMarkdown(mermaidCode: string): string
```

## Parameters

| Name | Type |
|---|---|
| `mermaidCode` | `string` |

**Returns:** `string`

<!-- source: interface-httpendpoint.md -->

# HttpEndpoint

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 47)

## Properties

| Property | Type |
|---|---|
| `method` | `'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'` |
| `path` | `string` |
| `service` | `string` |
| `serviceMethod` | `string` |
| `parameters` | `string[]` |
| `returnType` | `string` |
| `filePath` | `string` |
| `lineNumber` | `number` |

<!-- source: function-jaccardsimilarity.md -->

# jaccardSimilarity

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/grounding-checker.ts` (line 110)

Calculate Jaccard similarity between two strings.
Splits both strings into word sets (lowercase) and returns |intersection| / |union|.

## Signature

```ts
function jaccardSimilarity(a: string, b: string): number
```

## Parameters

| Name | Type |
|---|---|
| `a` | `string` |
| `b` | `string` |

**Returns:** `number`

<!-- source: interface-jobfailuredata.md -->

# JobFailureData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/doc-automation.service.ts` (line 81)

## Properties

| Property | Type |
|---|---|
| `error` | `string` |
| `errorStage` | `string` |
| `errorStack` | `string` |
| `durationMs` | `number` |
| `metrics` | `unknown` |
| `stageResults` | `unknown` |

<!-- source: interface-mcpcallresult.md -->

# McpCallResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/mcp/mcp-client.ts` (line 57)

## Properties

| Property | Type |
|---|---|
| `content` | `Array<{ type: string; text?: string; data?: string; mimeType?: string }>` |
| `isError` | `boolean` |

<!-- source: function-parsesetupresult.md -->

# parseSetupResult

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/setup-agent.ts` (line 194)

## Signature

```ts
function parseSetupResult(output: string): SetupResult
```

## Parameters

| Name | Type |
|---|---|
| `output` | `string` |

**Returns:** `SetupResult`

<!-- source: service-ragchatmodelservice.md -->

# RagChatModelService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/rag/chat-model.service.ts` (line 11)

Generation model for grounded chat. Uses gpt-5.5 on the primary Azure OpenAI resource via
chat/completions. gpt-5.5 is a reasoning model, so we send `max_completion_tokens` (not
`max_tokens`) and omit `temperature` (rejected by reasoning models). Self-contained on purpose:
the shared Responses provider targets a different Azure resource that doesn't host gpt-5.5.

`RagChatModelService` is a NestJS service that generates grounded chat completions using the **gpt-5.5** reasoning model on the **primary Azure OpenAI** resource via the `chat/completions` API. It is intentionally self-contained because the shared Responses provider targets a different Azure resource that does not host gpt-5.5. It also applies reasoning-model constraints by sending `max_completion_tokens` (not `max_tokens`) and omitting `temperature`.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `complete` | `complete(prompt: string, maxCompletionTokens: unknown)` | `Promise<string>` |
| `completeStream` | `completeStream(prompt: string, maxCompletionTokens: unknown)` | `AsyncGenerator<string, { text: string; inputTokens: number; outputTokens: number; totalTokens: number }, void>` |
| `completeWithUsage` | `completeWithUsage(prompt: string, maxCompletionTokens: unknown)` | `Promise<{ text: string; inputTokens: number; outputTokens: number; totalTokens: number }>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant Caller as API Handler / RAG Orchestrator
  participant RagSvc as RagChatModelService
  participant Azure as Azure OpenAI (Primary Resource)
  participant Model as gpt-5.5 (reasoning)

  Caller->>RagSvc: build messages (system + user + grounded context)
  RagSvc->>RagSvc: validate reasoning-model params\n(no temperature, use max_completion_tokens)
  RagSvc->>Azure: POST /chat/completions\n{ model: "gpt-5.5", messages, max_completion_tokens, ... }
  Azure->>Model: Run reasoning completion
  Model-->>Azure: completion output
  Azure-->>RagSvc: response (choices/message)
  RagSvc-->>Caller: grounded assistant message/content
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { RagChatModelService } from './technical-docs/rag/chat-model.service';

@Injectable()
export class RagAnswerService {
  constructor(private readonly ragChatModel: RagChatModelService) {}

  async answer(question: string, contextChunks: string[]) {
    const groundedContext = contextChunks.map((c, i) => `Source ${i + 1}:\n${c}`).join('\n\n');

    // Typical RAG shape: system rules + user question + grounded context
    const messages = [
      {
        role: 'system',
        content:
          'You are a helpful assistant. Use ONLY the provided sources. ' +
          'If the answer is not in the sources, say you do not know.',
      },
      { role: 'user', content: `Question:\n${question}\n\nSources:\n${groundedContext}` },
    ];

    // NOTE: reasoning model usage: omit temperature; use max_completion_tokens
    const result = await this.ragChatModel.createChatCompletion({
      model: 'gpt-5.5',
      messages,
      max_completion_tokens: 800,
    });

    return {
      answer: result.choices?.[0]?.message?.content ?? '',
      raw: result,
    };
  }
}
```

## AI Coding Instructions

- Keep this service **self-contained**: do not “refactor to shared Responses provider” unless the target Azure resource is confirmed to host **gpt-5.5**.
- For **reasoning models**, send `max_completion_tokens` and **do not** include `temperature` (Azure/OpenAI will reject it for reasoning models).
- Preserve the grounded-chat contract: callers should pass **messages that include the retrieved context** and system constraints (e.g., “use only sources”).
- When integrating, verify the **Azure OpenAI deployment/model name** and endpoint correspond to the **primary resource** intended for gpt-5.5 `chat/completions`.

## Relationships

- DEPENDS_ON → `configservice`

<!-- source: class-reshootviewportdto.md -->

# ReshootViewportDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/capture/dto/update-flow.dto.ts` (line 34)

Optional viewport override for a single-step / locale reshoot.

## Properties

| Property | Type |
|---|---|
| `width` | `number` |
| `height` | `number` |

<!-- source: function-snoozeuntil.md -->

# snoozeUntil

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/DeskDialogs.tsx` (line 36)

## Signature

```ts
function snoozeUntil(preset: SnoozePreset): string
```

## Parameters

| Name | Type |
|---|---|
| `preset` | `SnoozePreset` |

**Returns:** `string`

<!-- source: class-statemachinedetector.md -->

# StateMachineDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/state-machine-detector.ts` (line 60)

State Machine Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detect` | `detect(entities: Entity[])` | `DetectedStateMachine[]` |
| `linkTransitions` | `linkTransitions(stateMachines: DetectedStateMachine[], entities: Entity[])` | `void` |

<!-- source: interface-subdomaincheckresult.md -->

# SubdomainCheckResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/lib/api-client.ts` (line 76)

## Properties

| Property | Type |
|---|---|
| `slug` | `string` |
| `available` | `boolean` |
| `reason` | `string` |

<!-- source: type-translation.md -->

# Translation

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 919)

## Definition

```ts
(
  key: string,
  defaultValue: string,
  interpolations?: Record<string, any>,
) => string
```

<!-- source: interface-claudemessage.md -->

# ClaudeMessage

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/claude.provider.ts` (line 184)

## Properties

| Property | Type |
|---|---|
| `role` | `'user' | 'assistant'` |
| `content` | `string` |

<!-- source: constant-detection-configs-by-name.md -->

# DETECTION_CONFIGS_BY_NAME

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/index.ts` (line 57)

Detection config by name

<!-- source: api-endpoint-draft.md -->

# draft

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/capture/capture.controller.ts` (line 109)

## Endpoint

`POST /capture/:projectId/flows/:id/draft`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `CaptureController` (MODULE_DECLARES)

<!-- source: component-escapeunknowntextdirectives.md -->

# EscapeUnknownTextDirectives

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/directives.tsx` (line 130)

## Diagram

```mermaid
graph TD
    component_EscapeUnknownTextDirectives_22319f91["EscapeUnknownTextDirectives"]
    class component_EscapeUnknownTextDirectives_22319f91 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useState`

<!-- source: component-filterselect.md -->

# FilterSelect

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/all/page.tsx` (line 98)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `value` | `string` | ✓ | - |
| `onChange` | `Function` | ✓ | - |
| `label` | `string` | - | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FilterSelect_54797ffd["FilterSelect"]
    class component_FilterSelect_54797ffd rootComponent
```

## Referenced By

- `IssuesAllPageInner` (RENDERS)

<!-- source: function-formatvalidationreport.md -->

# formatValidationReport

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/coverage-validator.ts` (line 484)

Format validation report as human-readable text

## Signature

```ts
function formatValidationReport(report: ValidationReport): string
```

## Parameters

| Name | Type |
|---|---|
| `report` | `ValidationReport` |

**Returns:** `string`

<!-- source: interface-impactanalysis-2.md -->

# ImpactAnalysis

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/relationship.interface.ts` (line 454)

Impact analysis result

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `directDependencies` | `string[]` |
| `directDependents` | `string[]` |
| `allDependencies` | `string[]` |
| `allDependents` | `string[]` |
| `impactScore` | `number` |
| `recommendations` | `string[]` |

<!-- source: interface-jobprogressupdate.md -->

# JobProgressUpdate

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/doc-automation.service.ts` (line 56)

## Properties

| Property | Type |
|---|---|
| `status` | `DocumentationJobStatus` |
| `progress` | `number` |
| `currentStage` | `string` |
| `stageProgress` | `number` |
| `currentItem` | `string` |
| `elapsedMs` | `number` |
| `estimatedRemainingMs` | `number` |

<!-- source: function-joinproc.md -->

# joinProc

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/fp.ts` (line 71)

returns a function which calls all passed functions in the passed order.
joinProc does not pass arguments or collect return values.

## Signature

```ts
function joinProc(procs: (() => unknown)[])
```

## Parameters

| Name | Type |
|---|---|
| `procs` | `(() => unknown)[]` |

<!-- source: interface-mcpconfig.md -->

# McpConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/mcp/mcp-manager.ts` (line 47)

## Properties

| Property | Type |
|---|---|
| `mcpServers` | `Record<string, McpServerConfig>` |

<!-- source: function-parseunifieddiff.md -->

# parseUnifiedDiff

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/tools/edit-file.tool.ts` (line 569)

Parse a unified diff string into hunks.

## Signature

```ts
function parseUnifiedDiff(diff: string): DiffHunk[]
```

## Parameters

| Name | Type |
|---|---|
| `diff` | `string` |

**Returns:** `DiffHunk[]`

<!-- source: service-ratelimitguard.md -->

# RateLimitGuard

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/ai/guards/rate-limit.guard.ts` (line 7)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `canActivate` | `canActivate(context: ExecutionContext)` | `Promise<boolean>` |
| `onModuleDestroy` | `onModuleDestroy()` | `unknown` |

## Relationships

- DEPENDS_ON → `configservice`

<!-- source: class-reviewsuggestiondto.md -->

# ReviewSuggestionDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/suggestion/dto/review-suggestion.dto.ts` (line 3)

## Properties

| Property | Type |
|---|---|
| `reviewComment` | `string` |

<!-- source: function-sourcebadgeof.md -->

# sourceBadgeOf

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/copilotUtils.ts` (line 60)

## Signature

```ts
function sourceBadgeOf(source: Pick<CopilotAskSource, 'path' | 'docType'>): SourceBadge
```

## Parameters

| Name | Type |
|---|---|
| `source` | `Pick<CopilotAskSource, 'path' | 'docType'>` |

**Returns:** `SourceBadge`

<!-- source: interface-subdomainupdateresult.md -->

# SubdomainUpdateResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/lib/api-client.ts` (line 82)

## Properties

| Property | Type |
|---|---|
| `publishedSlug` | `string` |
| `publicUrl` | `string` |
| `project` | `{ id: string; publishedSlug: string }` |

<!-- source: class-suggestionendpoints.md -->

# SuggestionEndpoints

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/suggestions.ts` (line 23)

Suggestion endpoints

## Methods

| Method | Signature | Returns |
|---|---|---|
| `list` | `list(documentId: string, params: Omit<SuggestionListParams, 'documentId'>)` | `Promise<SuggestionWithUser[]>` |
| `get` | `get(suggestionId: string)` | `Promise<SuggestionWithUser>` |
| `create` | `create(documentId: string, dto: CreateSuggestionDto)` | `Promise<SuggestionWithUser>` |
| `update` | `update(suggestionId: string, dto: UpdateSuggestionDto)` | `Promise<SuggestionWithUser>` |
| `delete` | `delete(suggestionId: string)` | `Promise<void>` |
| `accept` | `accept(suggestionId: string, reviewComment: string)` | `Promise<SuggestionWithUser>` |
| `reject` | `reject(suggestionId: string, reviewComment: string)` | `Promise<SuggestionWithUser>` |

<!-- source: type-uilibrary.md -->

# UILibrary

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/framework.types.ts` (line 48)

Detected UI component library

## Definition

```ts
| 'devextreme'
  | 'mui'
  | 'antd'
  | 'chakra'
  | 'shadcn'
  | 'radix'
  | 'primereact'
  | 'primevue'
  | 'vuetify'
  | 'bootstrap'
  | 'tailwind'
  | 'none'
```

<!-- source: interface-clauderesponse.md -->

# ClaudeResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/claude.provider.ts` (line 189)

## Properties

| Property | Type |
|---|---|
| `content` | `string` |
| `inputTokens` | `number` |
| `outputTokens` | `number` |
| `model` | `string` |
| `stopReason` | `string` |

<!-- source: constant-dialogbutton.md -->

# DialogButton

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/DialogButton.tsx` (line 19)

Use this primitive to create a toolbar button that opens a dialog with a text input, autocomplete suggestions, and a submit button.

<!-- source: api-endpoint-drafttickettopic.md -->

# draftTicketTopic

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/manuals-insights/manuals-insights.controller.ts` (line 55)

## Endpoint

`POST /manuals-insights/:projectId/ticket-topics/draft`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `ManualsInsightsController` (MODULE_DECLARES)

<!-- source: component-example.md -->

# Example

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/bug-683.tsx` (line 38)

## Diagram

```mermaid
graph TD
    component_Example_d4914e1["Example"]
    class component_Example_d4914e1 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`

<!-- source: component-flaggeddoccard.md -->

# FlaggedDocCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/versions/[versionId]/review/page.tsx` (line 40)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `doc` | `unknown` | ✓ | - |
| `onResolve` | `Function` | ✓ | - |
| `resolving` | `boolean` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FlaggedDocCard_4fb68cee["FlaggedDocCard"]
    class component_FlaggedDocCard_4fb68cee rootComponent
```

## Relationships

- USES_HOOK → `useState`

## Referenced By

- `ReviewPage` (RENDERS)

<!-- source: function-generateallapiflowdiagrams.md -->

# generateAllAPIFlowDiagrams

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/api-flow-diagram.generator.ts` (line 492)

Generate flow diagrams for all API endpoints

## Signature

```ts
function generateAllAPIFlowDiagrams(endpoints: APIEndpointEntity[], allEntities: Entity[], relationships: Relationship[], options: APIFlowDiagramOptions): Array<{ endpointPath: string; method: string; result: APIFlowDiagramResult }>
```

## Parameters

| Name | Type |
|---|---|
| `endpoints` | `APIEndpointEntity[]` |
| `allEntities` | `Entity[]` |
| `relationships` | `Relationship[]` |
| `options` | `APIFlowDiagramOptions` |

**Returns:** `Array<{ endpointPath: string; method: string; result: APIFlowDiagramResult }>`

<!-- source: interface-importinfo-2.md -->

# ImportInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 16)

Information about an import statement

## Properties

| Property | Type |
|---|---|
| `source` | `string` |
| `importType` | `'default' | 'named' | 'namespace' | 'side-effect'` |
| `imported` | `string` |
| `local` | `string` |

<!-- source: interface-joindocumentdata.md -->

# JoinDocumentData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/collaboration/interfaces/collaboration.interfaces.ts` (line 46)

Data for joining a document collaboration session

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `userId` | `string` |
| `userName` | `string` |

<!-- source: function-loadfonts.md -->

# loadFonts

**Kind:** Function

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/fonts.ts` (line 26)

Load fonts from Google Fonts and update CSS custom properties.
Call once during app initialization.

## Signature

```ts
function loadFonts(config: FontConfig)
```

## Parameters

| Name | Type |
|---|---|
| `config` | `FontConfig` |

<!-- source: interface-mcphttpoptions.md -->

# McpHttpOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/mcp/mcp-client.ts` (line 35)

## Properties

| Property | Type |
|---|---|
| `transport` | `'http'` |
| `url` | `string` |
| `token` | `string` |

<!-- source: function-planorfull.md -->

# planOrFull

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/prompt-sections.ts` (line 97)

Mode is plan or full

## Signature

```ts
function planOrFull(ctx: SectionContext): boolean
```

## Parameters

| Name | Type |
|---|---|
| `ctx` | `SectionContext` |

**Returns:** `boolean`

<!-- source: service-rolesguard.md -->

# RolesGuard

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/auth/guards/roles.guard.ts` (line 10)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `canActivate` | `canActivate(context: ExecutionContext)` | `boolean` |

## Relationships

- DEPENDS_ON → `reflector`

<!-- source: class-samlstrategy.md -->

# SamlStrategy

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/auth/saml/saml.strategy.ts` (line 6)

**Extends:** `PassportStrategy(Strategy, 'saml')`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `validate` | `validate(req: any, profile: Profile | null)` | `Promise<any>` |

<!-- source: class-sveltedetector.md -->

# SvelteDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/svelte-detector.ts` (line 57)

Svelte Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detect` | `detect(entities: Entity[])` | `DetectedSvelteComponent[]` |
| `getComponentSummary` | `getComponentSummary(component: DetectedSvelteComponent)` | `string` |

<!-- source: interface-symbollistprops.md -->

# SymbolListProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Parser/SymbolList.tsx` (line 8)

## Properties

| Property | Type |
|---|---|
| `symbols` | `Symbol[]` |
| `onSymbolClick` | `(symbol: Symbol) => void` |
| `selectedSymbol` | `Symbol` |
| `className` | `string` |

<!-- source: function-threadmatchesbucket.md -->

# threadMatchesBucket

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 162)

Does this thread still belong in the given bucket after a local mutation?

## Signature

```ts
function threadMatchesBucket(bucket: BucketKey, t: DeskThread): boolean
```

## Parameters

| Name | Type |
|---|---|
| `bucket` | `BucketKey` |
| `t` | `DeskThread` |

**Returns:** `boolean`

<!-- source: type-uploadprogresscallback.md -->

# UploadProgressCallback

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 185)

## Definition

```ts
(progress: UploadProgress) => void | Promise<void>
```

<!-- source: interface-clientconfig.md -->

# ClientConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/types/config.ts` (line 4)

Configuration for the Atloria API client

## Properties

| Property | Type |
|---|---|
| `baseURL` | `string` |
| `token` | `string` |
| `timeout` | `number` |
| `maxRetries` | `number` |
| `enableDeduplication` | `boolean` |
| `enableLogging` | `boolean` |
| `headers` | `Record<string, string>` |
| `onTokenRefresh` | `(token: string) => void` |
| `onAuthError` | `() => void` |

<!-- source: constant-directivedescriptors.md -->

# directiveDescriptors$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 313)

Contains the currently registered Markdown directive descriptors.

<!-- source: api-endpoint-duplicate.md -->

# duplicate

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 893)

## Endpoint

`POST /documents/:id/duplicate`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: component-example-2.md -->

# Example

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/cm-merge.tsx` (line 42)

## Diagram

```mermaid
graph TD
    component_Example_30c25bb0["Example"]
    class component_Example_30c25bb0 rootComponent
```

## Relationships

- USES_HOOK → `useRef`
- USES_HOOK → `useCallback`

<!-- source: component-gapcard.md -->

# GapCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/ThreadList.tsx` (line 38)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `topic` | `TicketTopicProposal` | ✓ | - |
| `draft` | `GapDraftState | undefined` | ✓ | - |
| `onDraft` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_GapCard_4219f712["GapCard"]
    class component_GapCard_4219f712 rootComponent
```

## Referenced By

- `ThreadList` (RENDERS)

<!-- source: function-generateallcomponenthierarchydiagrams.md -->

# generateAllComponentHierarchyDiagrams

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/component-hierarchy-diagram.generator.ts` (line 461)

Generate hierarchy diagrams for all root components

## Signature

```ts
function generateAllComponentHierarchyDiagrams(components: ComponentEntity[], relationships: Relationship[], options: ComponentHierarchyDiagramOptions): Array<{ componentName: string; componentId: string; result: HierarchyDiagramResult }>
```

## Parameters

| Name | Type |
|---|---|
| `components` | `ComponentEntity[]` |
| `relationships` | `Relationship[]` |
| `options` | `ComponentHierarchyDiagramOptions` |

**Returns:** `Array<{ componentName: string; componentId: string; result: HierarchyDiagramResult }>`

<!-- source: interface-indexdefinition-2.md -->

# IndexDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 763)

Index definition

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `fields` | `string[]` |
| `unique` | `boolean` |
| `type` | `'btree' | 'hash' | 'gin' | 'gist' | 'fulltext'` |

<!-- source: interface-jwtpayload.md -->

# JwtPayload

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/auth/decorators/current-user.decorator.ts` (line 5)

## Properties

| Property | Type |
|---|---|
| `sub` | `string` |
| `email` | `string` |
| `role` | `string` |
| `organizationId` | `string` |
| `audienceIds` | `string[]` |

<!-- source: function-loggroundingsummary.md -->

# logGroundingSummary

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/grounding-checker.ts` (line 178)

Log a summary of grounding validation results.

Categories:
- Well-grounded (>= 0.7)
- Partially grounded (0.3-0.7)
- Unverifiable (< 0.3)

## Signature

```ts
function logGroundingSummary(results: GroundingResult[]): void
```

## Parameters

| Name | Type |
|---|---|
| `results` | `GroundingResult[]` |

**Returns:** `void`

<!-- source: interface-mcphttpserverconfig.md -->

# McpHttpServerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/mcp/mcp-manager.ts` (line 40)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `token` | `string` |

<!-- source: function-readheavy.md -->

# readHeavy

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/prompt-sections.ts` (line 101)

Mode is explore, plan, or full

## Signature

```ts
function readHeavy(ctx: SectionContext): boolean
```

## Parameters

| Name | Type |
|---|---|
| `ctx` | `SectionContext` |

**Returns:** `boolean`

<!-- source: service-samlservice.md -->

# SamlService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/auth/saml/saml.service.ts` (line 6)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getConfigByOrgSlug` | `getConfigByOrgSlug(orgSlug: string)` | `unknown` |
| `getConfig` | `getConfig(orgId: string)` | `unknown` |
| `configureSaml` | `configureSaml(orgId: string, dto: { entityId: string; ssoUrl: string; certificate: string })` | `unknown` |
| `toggleSaml` | `toggleSaml(orgId: string, isEnabled: boolean)` | `unknown` |
| `getLoginUrl` | `getLoginUrl(config: any)` | `Promise<string>` |
| `generateToken` | `generateToken(user: any)` | `Promise<string>` |
| `getMetadata` | `getMetadata(orgId: string)` | `Promise<string>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `jwtservice`

<!-- source: class-saveastemplatedto.md -->

# SaveAsTemplateDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/template/dto/save-as-template.dto.ts` (line 10)

DTO for saving an existing document as a new template.
Allows users to convert their documents into reusable templates.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `category` | `TemplateCategory` |
| `isPrivate` | `boolean` |

<!-- source: interface-templategalleryprops.md -->

# TemplateGalleryProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Templates/TemplateGallery.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `onSelect` | `(template: DocumentTemplate) => void` |
| `organizationId` | `string` |
| `title` | `string` |
| `showSearch` | `boolean` |

<!-- source: class-themeengine.md -->

# ThemeEngine

**Kind:** Class

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/theme-engine.ts` (line 25)

ThemeEngine - A framework-agnostic theming system for Atloria

Features:
- CSS Variables-based theming
- Dark/Light mode support
- localStorage persistence
- System preference detection
- SSR support (no flash of unstyled content)
- Cross-tab synchronization
- White-label support via custom tokens

## Methods

| Method | Signature | Returns |
|---|---|---|
| `setMode` | `setMode(mode: ThemeMode)` | `void` |
| `getMode` | `getMode()` | `ThemeMode` |
| `getEffectiveThemeMode` | `getEffectiveThemeMode()` | `'light' | 'dark'` |
| `enableDarkMode` | `enableDarkMode()` | `void` |
| `disableDarkMode` | `disableDarkMode()` | `void` |
| `toggleDarkMode` | `toggleDarkMode()` | `void` |
| `useSystemPreference` | `useSystemPreference()` | `void` |
| `getTheme` | `getTheme()` | `ThemeTokens` |
| `updateTheme` | `updateTheme(updates: Partial<ThemeTokens>)` | `void` |
| `subscribe` | `subscribe(listener: ThemeEventListener)` | `() => void` |
| `getSSRScript` | `getSSRScript(config: ThemeConfig)` | `string` |
| `destroy` | `destroy()` | `void` |

<!-- source: function-timeago.md -->

# timeAgo

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 187)

## Signature

```ts
function timeAgo(iso: string): string
```

## Parameters

| Name | Type |
|---|---|
| `iso` | `string` |

**Returns:** `string`

<!-- source: type-uploadprogresscallback-2.md -->

# UploadProgressCallback

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-uploader.service.ts` (line 32)

## Definition

```ts
(progress: UploadProgress) => void
```

<!-- source: interface-clip.md -->

# Clip

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 55)

Clip region for partial page screenshots

## Properties

| Property | Type |
|---|---|
| `x` | `number` |
| `y` | `number` |
| `width` | `number` |
| `height` | `number` |

<!-- source: constant-directivesplugin.md -->

# directivesPlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/directives/index.ts` (line 101)

A plugin that adds support for markdown directives.

<!-- source: api-endpoint-duplicate-2.md -->

# duplicate

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/desk.controller.ts` (line 98)

## Endpoint

`POST /desk/:projectId/threads/:id/duplicate`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `DeskController` (MODULE_DECLARES)

<!-- source: component-example-3.md -->

# Example

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/i18n.tsx` (line 35)

## Diagram

```mermaid
graph TD
    component_Example_7d33a559["Example"]
    class component_Example_7d33a559 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: function-generateallsequencediagrams.md -->

# generateAllSequenceDiagrams

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/sequence-diagram.generator.ts` (line 540)

Generate sequence diagrams for all API endpoints

## Signature

```ts
function generateAllSequenceDiagrams(entities: Entity[], relationships: Relationship[], options: SequenceDiagramOptions): Map<string, SequenceDiagramResult>
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `Entity[]` |
| `relationships` | `Relationship[]` |
| `options` | `SequenceDiagramOptions` |

**Returns:** `Map<string, SequenceDiagramResult>`

<!-- source: component-generatedocmodal.md -->

# GenerateDocModal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/page.tsx` (line 1117)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `visible` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `onReopen` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_GenerateDocModal_5453a0cb["GenerateDocModal"]
    class component_GenerateDocModal_5453a0cb rootComponent
```

## Relationships

- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

## Referenced By

- `ProjectPage` (RENDERS)

<!-- source: interface-iparser-2.md -->

# IParser

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/parser.interface.ts` (line 59)

Base interface that ALL parsers must implement

Each parser (React, NestJS, Prisma, etc.) implements this interface
to ensure consistent behavior across the system.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `supportedPatterns` | `string[]` |

<!-- source: interface-kgentity-2.md -->

# KGEntity

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/graph/interfaces/entity.interface.ts` (line 23)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `type` | `EntityType` |
| `name` | `string` |
| `description` | `string` |
| `documentId` | `string` |
| `metadata` | `Record<string, any>` |
| `createdAt` | `Date` |
| `updatedAt` | `Date` |

<!-- source: function-makehsltransparent.md -->

# makeHslTransparent

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/makeHslTransparent.ts` (line 2)

## Signature

```ts
function makeHslTransparent(hsl: string, alpha: number)
```

## Parameters

| Name | Type |
|---|---|
| `hsl` | `string` |
| `alpha` | `number` |

<!-- source: interface-mcpmanageroptions.md -->

# McpManagerOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/mcp/mcp-manager.ts` (line 51)

## Properties

| Property | Type |
|---|---|
| `configPath` | `string` |

<!-- source: function-reciprocalrankfusion.md -->

# reciprocalRankFusion

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/hybrid-search.ts` (line 38)

Merge BM25 and vector search results using Reciprocal Rank Fusion.

## Signature

```ts
function reciprocalRankFusion(bm25Results: RankedItem[], vectorResults: RankedItem[], topK: number, k: number): SearchResult[]
```

## Parameters

| Name | Type |
|---|---|
| `bm25Results` | `RankedItem[]` |
| `vectorResults` | `RankedItem[]` |
| `topK` | `number` |
| `k` | `number` |

**Returns:** `SearchResult[]`

<!-- source: service-scheduledreportsservice.md -->

# ScheduledReportsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/analytics/export/scheduled-reports.service.ts` (line 35)

ScheduledReportsService — CRUD for saved scheduled reports + the cron
evaluator that fires due reports every 5 minutes.

The evaluator is intentionally simple: every tick it queries enabled
reports, computes their next-run time from `cron` and `lastRunAt`, and
fires any that are overdue. Failed reports record their error in
`lastStatus` but never crash the loop.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `list` | `list(projectId: string)` | `unknown` |
| `get` | `get(projectId: string, id: string)` | `unknown` |
| `create` | `create(projectId: string, userId: string, dto: CreateScheduledReportDto)` | `unknown` |
| `update` | `update(projectId: string, id: string, dto: UpdateScheduledReportDto)` | `unknown` |
| `remove` | `remove(projectId: string, id: string)` | `unknown` |
| `runNow` | `runNow(projectId: string, id: string)` | `unknown` |
| `evaluateScheduledReports` | `evaluateScheduledReports()` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `analyticsexportservice`
- DEPENDS_ON → `emailservice`

<!-- source: class-screenshotfiltersdto.md -->

# ScreenshotFiltersDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/screenshot/dto/screenshot-filters.dto.ts` (line 8)

DTO for filtering screenshots

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `url` | `string` |
| `viewport` | `string` |
| `browser` | `string` |
| `isBaseline` | `boolean` |
| `flowStepId` | `string` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: interface-themetokens.md -->

# ThemeTokens

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/theme-presets.ts` (line 7)

Theme presets (4.2): whole-page token packs for the published docs viewer.
Light-spectrum on purpose — content surfaces stay readable without a dark-mode
overhaul of every page. A preset sets page/sidebar/border tokens plus default
primary/accent; explicit custom brand colors always override the preset's.

## Properties

| Property | Type |
|---|---|
| `primary` | `string` |
| `accent` | `string` |
| `pageBg` | `string` |
| `surface` | `string` |
| `border` | `string` |
| `sidebarText` | `string` |
| `dark` | `boolean` |
| `text` | `string` |
| `textMuted` | `string` |
| `codeBg` | `string` |

<!-- source: function-timeago-2.md -->

# timeAgo

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/helpers.ts` (line 49)

## Signature

```ts
function timeAgo(iso: string): string
```

## Parameters

| Name | Type |
|---|---|
| `iso` | `string` |

**Returns:** `string`

<!-- source: class-timeouterror.md -->

# TimeoutError

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/types/errors.ts` (line 77)

Timeout error

**Extends:** `NetworkError`

<!-- source: type-upsertoperation.md -->

# UpsertOperation

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 249)

Upsert operation type

## Definition

```ts
'create' | 'update' | 'skip'
```

<!-- source: interface-codeblockeditorcontextvalue.md -->

# CodeBlockEditorContextValue

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/CodeBlockNode.tsx` (line 165)

## Properties

| Property | Type |
|---|---|
| `setCode` | `(code: string) => void` |
| `setLanguage` | `(language: string) => void` |
| `setMeta` | `(meta: string) => void` |
| `lexicalNode` | `CodeBlockNode` |
| `parentEditor` | `LexicalEditor` |

<!-- source: constant-directivevisitor.md -->

# DirectiveVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/directives/DirectiveVisitor.ts` (line 5)

## Definition

```ts
LexicalExportVisitor<DirectiveNode, LeafDirective>
```

<!-- source: api-endpoint-enhance.md -->

# enhance

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/ai/ai.controller.ts` (line 30)

## Endpoint

`POST /ai/enhance`

## Referenced By

- `AIController` (MODULE_DECLARES)

<!-- source: component-example-4.md -->

# Example

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/jsx.tsx` (line 98)

## Diagram

```mermaid
graph TD
    component_Example_3b01900a["Example"]
    class component_Example_3b01900a rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `InsertMyLeaf`

<!-- source: function-generateallstatemachinediagrams.md -->

# generateAllStateMachineDiagrams

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/state-machine-diagram.generator.ts` (line 416)

Generate multiple diagrams for all state machines in a component

## Signature

```ts
function generateAllStateMachineDiagrams(stateMachines: StateMachine[], screenshots: EnhancedScreenshotMetadata[], interactions: UIInteraction[], options: StateMachineDiagramOptions): Array<{ name: string; result: DiagramGenerationResult }>
```

## Parameters

| Name | Type |
|---|---|
| `stateMachines` | `StateMachine[]` |
| `screenshots` | `EnhancedScreenshotMetadata[]` |
| `interactions` | `UIInteraction[]` |
| `options` | `StateMachineDiagramOptions` |

**Returns:** `Array<{ name: string; result: DiagramGenerationResult }>`

<!-- source: component-githubicon.md -->

# GitHubIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/scenes/SceneUrlInput.tsx` (line 8)

## Diagram

```mermaid
graph TD
    component_GitHubIcon_2dd13e9a["GitHubIcon"]
    class component_GitHubIcon_2dd13e9a rootComponent
```

## Referenced By

- `SceneUrlInput` (RENDERS)

<!-- source: interface-istorageprovider.md -->

# IStorageProvider

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/storage.interface.ts` (line 196)

Storage provider interface

Abstracts storage operations to support both file system and cloud modes

<!-- source: interface-kgrelation.md -->

# KGRelation

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/graph/interfaces/entity.interface.ts` (line 34)

## Properties

| Property | Type |
|---|---|
| `from` | `string` |
| `to` | `string` |
| `type` | `RelationType` |
| `metadata` | `Record<string, any>` |
| `weight` | `number` |

<!-- source: function-mapplaceholderswithintelligence.md -->

# mapPlaceholdersWithIntelligence

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/agent-screenshot-mapper.ts` (line 448)

Maps screenshot placeholders to exact specs using source code intelligence.
In production, the inner mapping would be done by an AI agent with the
intelligence injected into its context. For the POC, we use heuristic matching.

## Signature

```ts
function mapPlaceholdersWithIntelligence(intelligence: SourceCodeIntelligence, docs: DocScreenshotRequest[], siteUrl: string): AgentScreenshotSpec[]
```

## Parameters

| Name | Type |
|---|---|
| `intelligence` | `SourceCodeIntelligence` |
| `docs` | `DocScreenshotRequest[]` |
| `siteUrl` | `string` |

**Returns:** `AgentScreenshotSpec[]`

<!-- source: interface-mcpserverinfo.md -->

# McpServerInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/mcp/mcp-client.ts` (line 45)

## Properties

| Property | Type |
|---|---|
| `protocolVersion` | `string` |
| `capabilities` | `Record<string, unknown>` |
| `serverInfo` | `{ name: string; version: string }` |

<!-- source: function-resolvemodelprofile.md -->

# resolveModelProfile

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-profiles.ts` (line 224)

Resolves the capability profile to use for a given request.

## Signature

```ts
function resolveModelProfile(modelId: string | undefined, explicit: ModelCapabilityProfile): ModelCapabilityProfile
```

## Parameters

| Name | Type |
|---|---|
| `modelId` | `string | undefined` |
| `explicit` | `ModelCapabilityProfile` |

**Returns:** `ModelCapabilityProfile`

<!-- source: class-screenshotjobfiltersdto.md -->

# ScreenshotJobFiltersDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/screenshot/dto/screenshot-filters.dto.ts` (line 84)

DTO for filtering screenshot jobs

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `status` | `string` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: service-screenshotservice-2.md -->

# ScreenshotService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/screenshot/screenshot.service.ts` (line 19)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `captureScreenshot` | `captureScreenshot(dto: CaptureScreenshotDto, user: JwtPayload)` | `unknown` |
| `listScreenshots` | `listScreenshots(filters: ScreenshotFiltersDto, user: JwtPayload)` | `unknown` |
| `getScreenshot` | `getScreenshot(id: string, user: JwtPayload)` | `unknown` |
| `deleteScreenshot` | `deleteScreenshot(id: string, user: JwtPayload)` | `unknown` |
| `bulkCaptureScreenshots` | `bulkCaptureScreenshots(dto: BulkCaptureScreenshotsDto, user: JwtPayload)` | `unknown` |
| `listJobs` | `listJobs(filters: ScreenshotJobFiltersDto, user: JwtPayload)` | `unknown` |
| `getJob` | `getJob(id: string, user: JwtPayload)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `assetsservice`

<!-- source: interface-tickettopicproposal.md -->

# TicketTopicProposal

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/deskTypes.ts` (line 107)

## Properties

| Property | Type |
|---|---|
| `topicKey` | `string` |
| `title` | `string` |
| `ticketCount` | `number` |
| `exampleQuestions` | `string[]` |
| `suggestedAnswerSourcePages` | `Array<{ slug: string; title: string }>` |

<!-- source: class-timeouterror-2.md -->

# TimeoutError

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/errors.ts` (line 233)

Error thrown when operation times out

**Extends:** `PipelineError`

## Properties

| Property | Type |
|---|---|
| `timeoutMs` | `number` |
| `operation` | `string` |

<!-- source: function-trackcustomevent.md -->

# trackCustomEvent

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/analytics/usePageTracking.ts` (line 337)

Track custom events (e.g., button clicks, downloads)

## Signature

```ts
async function trackCustomEvent(options: {
  projectId: string;
  eventName: string;
  metadata?: Record<string, any>;
})
```

## Parameters

| Name | Type |
|---|---|
| `options` | `{
  projectId: string;
  eventName: string;
  metadata?: Record<string, any>;
}` |

<!-- source: type-v2progresscallback.md -->

# V2ProgressCallback

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/orchestrator.ts` (line 290)

## Definition

```ts
(update: V2ProgressUpdate) => void | Promise<void>
```

<!-- source: interface-codeblockeditordescriptor.md -->

# CodeBlockEditorDescriptor

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/index.ts` (line 54)

## Properties

| Property | Type |
|---|---|
| `priority` | `number` |
| `match` | `(language: string | null | undefined, meta: string | null | undefined) => boolean` |
| `Editor` | `React.ComponentType<CodeBlockEditorProps>` |

<!-- source: constant-disableautolink.md -->

# disableAutoLink$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link/index.tsx` (line 15)

Holds whether the auto-linking of URLs and email addresses is disabled.

<!-- source: api-endpoint-enrich.md -->

# enrich

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-mcp.controller.ts` (line 126)

## Endpoint

`POST /technical-docs/:projectId/enrich`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsMcpController` (MODULE_DECLARES)

<!-- source: component-example-5.md -->

# Example

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/nested-jsx-elements.tsx` (line 98)

## Diagram

```mermaid
graph TD
    component_Example_389a950e["Example"]
    class component_Example_389a950e rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `UndoRedo`
- RENDERS → `InsertCard`
- RENDERS → `InsertGrid`

<!-- source: function-generateapiflowcss.md -->

# generateAPIFlowCSS

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/api-flow-diagram.generator.ts` (line 462)

Generate CSS for API flow diagram styling

## Signature

```ts
function generateAPIFlowCSS(): string
```

**Returns:** `string`

<!-- source: component-gitlabicon.md -->

# GitLabIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/scenes/SceneUrlInput.tsx` (line 14)

## Diagram

```mermaid
graph TD
    component_GitLabIcon_20b6c0ce["GitLabIcon"]
    class component_GitLabIcon_20b6c0ce rootComponent
```

## Referenced By

- `SceneUrlInput` (RENDERS)

<!-- source: interface-learningpath.md -->

# LearningPath

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/tutorial-detector.service.ts` (line 76)

Learning path grouping related tutorials

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `description` | `string` |
| `category` | `string` |
| `difficulty` | `'beginner' | 'intermediate' | 'advanced'` |
| `estimatedTime` | `string` |
| `tutorials` | `string[]` |
| `outcomes` | `string[]` |

<!-- source: interface-linkelement.md -->

# LinkElement

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/template-analysis.interface.ts` (line 40)

Link/anchor element detected in template

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `path` | `string` |
| `isRouterLink` | `boolean` |
| `isDynamic` | `boolean` |
| `line` | `number` |
| `conditionalOn` | `string` |

<!-- source: function-markdownengine.md -->

# markdownEngine

**Kind:** Function

**Source:** `atloria-monorepo/packages/markdown-engine/src/lib/markdown-engine.ts` (line 1)

## Signature

```ts
function markdownEngine(): string
```

**Returns:** `string`

<!-- source: interface-mcpstdiooptions.md -->

# McpStdioOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/mcp/mcp-client.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `transport` | `'stdio'` |
| `command` | `string` |
| `args` | `string[]` |
| `env` | `Record<string, string>` |

<!-- source: function-revieworfull.md -->

# reviewOrFull

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/prompt-sections.ts` (line 105)

Mode is review or full

## Signature

```ts
function reviewOrFull(ctx: SectionContext): boolean
```

## Parameters

| Name | Type |
|---|---|
| `ctx` | `SectionContext` |

**Returns:** `boolean`

<!-- source: service-screenshotstalenessservice.md -->

# ScreenshotStalenessService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/doc-version/screenshot-staleness.service.ts` (line 15)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getStalenessLevel` | `getStalenessLevel(capturedAt: string | Date | null, isCurrentVersion: boolean)` | `StalenessLevel` |
| `getDaysAge` | `getDaysAge(date: string | Date)` | `number` |
| `getStalenessReason` | `getStalenessReason(level: StalenessLevel, age: number)` | `string` |

<!-- source: class-searchdocumentsdto.md -->

# SearchDocumentsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/search-document.dto.ts` (line 9)

DTO for searching documents with full-text and filters

## Properties

| Property | Type |
|---|---|
| `q` | `string` |
| `projectId` | `string` |
| `categoryId` | `string` |
| `state` | `DocumentState` |
| `type` | `DocumentType` |
| `author` | `string` |
| `dateFrom` | `string` |
| `dateTo` | `string` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: interface-timeserieschartprops.md -->

# TimeSeriesChartProps

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/TimeSeriesChart.tsx` (line 21)

## Properties

| Property | Type |
|---|---|
| `data` | `TimeSeriesDataPoint[]` |
| `loading` | `boolean` |
| `title` | `string` |
| `height` | `number` |

<!-- source: class-tokenlimiterror.md -->

# TokenLimitError

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/errors.ts` (line 85)

Error thrown when token limit is exceeded

**Extends:** `PipelineError`

## Properties

| Property | Type |
|---|---|
| `tokenCount` | `number` |
| `maxTokens` | `number` |

<!-- source: function-tracksearch.md -->

# trackSearch

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/analytics/usePageTracking.ts` (line 317)

Track search queries

## Signature

```ts
async function trackSearch(options: {
  projectId: string;
  docVersionId?: string;
  query: string;
  resultsCount: number;
  clickedDocId?: string;
})
```

## Parameters

| Name | Type |
|---|---|
| `options` | `{
  projectId: string;
  docVersionId?: string;
  query: string;
  resultsCount: number;
  clickedDocId?: string;
}` |

<!-- source: type-viewmode-2.md -->

# ViewMode

**Kind:** Type

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 854)

## Definition

```ts
'rich-text' | 'source' | 'diff'
```

<!-- source: interface-codeblockeditorprops.md -->

# CodeBlockEditorProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/index.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `code` | `string` |
| `language` | `string` |
| `meta` | `string` |
| `nodeKey` | `string` |
| `focusEmitter` | `VoidEmitter` |

<!-- source: constant-disabledstate.md -->

# disabledState

**Kind:** Constant

**Source:** `atloria-monorepo/packages/ui-core/src/utils/styles.ts` (line 43)

<!-- source: api-endpoint-escalate.md -->

# escalate

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-chat.controller.ts` (line 126)

## Endpoint

`POST /technical-docs/:projectId/chat/sessions/:sessionId/escalate`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `sessionId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsChatController` (MODULE_DECLARES)

<!-- source: component-example-6.md -->

# Example

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/realm-plugin.tsx` (line 30)

## Diagram

```mermaid
graph TD
    component_Example_138f5b4c["Example"]
    class component_Example_138f5b4c rootComponent
```

## Relationships

- RENDERS → `RealmWithPlugins`
- RENDERS → `Child`
- USES_HOOK → `useState`

<!-- source: function-generateapiflowdiagram.md -->

# generateAPIFlowDiagram

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/api-flow-diagram.generator.ts` (line 418)

Generate API flow diagram

## Signature

```ts
function generateAPIFlowDiagram(endpoint: APIEndpointEntity, allEntities: Entity[], relationships: Relationship[], options: APIFlowDiagramOptions): APIFlowDiagramResult
```

## Parameters

| Name | Type |
|---|---|
| `endpoint` | `APIEndpointEntity` |
| `allEntities` | `Entity[]` |
| `relationships` | `Relationship[]` |
| `options` | `APIFlowDiagramOptions` |

**Returns:** `APIFlowDiagramResult`

<!-- source: component-issuedetailpageinner.md -->

# IssueDetailPageInner

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/[ticketId]/page.tsx` (line 476)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_IssueDetailPageInner_22b710c4["IssueDetailPageInner"]
    class component_IssueDetailPageInner_22b710c4 rootComponent
```

## Relationships

- RENDERS → `Shimmer`
- RENDERS → `Button`
- RENDERS → `ArrowLeftIcon`
- RENDERS → `motion-div`
- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `CopyButton`
- RENDERS → `ArrowTopRightOnSquareIcon`
- RENDERS → `currentStatus-icon`
- RENDERS → `ChatBubbleLeftEllipsisIcon`
- RENDERS → `CategoryIcon`
- RENDERS → `CheckCircleSolid`
- RENDERS → `UserCircleIcon`
- RENDERS → `StatusJourney`
- RENDERS → `ClockIcon`
- RENDERS → `CheckCircleIcon`
- RENDERS → `ArrowPathIcon`
- RENDERS → `ViewColumnsIcon`
- RENDERS → `card-icon`
- RENDERS → `Card`
- RENDERS → `DocumentTextIcon`
- RENDERS → `EditableDescription`
- RENDERS → `AnimatePresence`
- RENDERS → `EyeSlashIcon`
- RENDERS → `ActionIcon`
- RENDERS → `PaperAirplaneIcon`
- RENDERS → `AdjustmentsHorizontalIcon`
- RENDERS → `PropertyRow`
- RENDERS → `ColoredSelect`
- RENDERS → `Badge`
- RENDERS → `ComputerDesktopIcon`
- RENDERS → `motion-button`
- RENDERS → `RIcon`
- RENDERS → `TrashIcon`
- RENDERS → `XCircleIcon`
- RENDERS → `BoardPicker`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useRouter`
- USES_HOOK → `useRef`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`
- USES_HOOK → `useMemo`

## Referenced By

- `IssueDetailPage` (RENDERS)

<!-- source: interface-leavedocumentdata.md -->

# LeaveDocumentData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/collaboration/interfaces/collaboration.interfaces.ts` (line 71)

Leave document payload

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |

<!-- source: interface-linkinfo-2.md -->

# LinkInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 986)

Link information

## Properties

| Property | Type |
|---|---|
| `text` | `string` |
| `url` | `string` |
| `line` | `number` |
| `isInternal` | `boolean` |

<!-- source: interface-mcpstdioserverconfig.md -->

# McpStdioServerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/mcp/mcp-manager.ts` (line 34)

## Properties

| Property | Type |
|---|---|
| `command` | `string` |
| `args` | `string[]` |
| `env` | `Record<string, string>` |

<!-- source: function-mdastdirectivevisitor.md -->

# MdastDirectiveVisitor

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/directives/MdastDirectiveVisitor.ts` (line 17)

## Signature

```ts
function MdastDirectiveVisitor(escapeUnknownTextDirectives)
```

## Parameters

| Name | Type |
|---|---|
| `escapeUnknownTextDirectives` | `any` |

<!-- source: function-runevaluation.md -->

# runEvaluation

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-evaluator.ts` (line 144)

Run the SWE-bench Docker evaluation harness.

This executes the official harness which:
1. Pulls pre-built Docker images per task (correct Python, conda, deps)
2. Applies the agent's patch to a clean repo checkout
3. Runs the gold test patch and tests
4. Reports pass/fail per task

## Signature

```ts
function runEvaluation(options: EvalCommandOptions, log: (msg: string) => void): EvalResult[]
```

## Parameters

| Name | Type |
|---|---|
| `options` | `EvalCommandOptions` |
| `log` | `(msg: string) => void` |

**Returns:** `EvalResult[]`

<!-- source: class-skeletonstructuredto.md -->

# SkeletonStructureDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/documentation/dto/doc-automation.dto.ts` (line 60)

## Properties

| Property | Type |
|---|---|
| `categories` | `CategorySkeletonDto[]` |
| `defaultLanguage` | `string` |

<!-- source: service-stalealertservice.md -->

# StaleAlertService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/stale-alert.service.ts` (line 38)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `notifyStaleTransition` | `notifyStaleTransition(projectId: string, info: StaleTransitionInfo)` | `Promise<void>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `emailservice`
- DEPENDS_ON → `configservice`

<!-- source: interface-timeseriesdatapoint.md -->

# TimeSeriesDataPoint

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/TimeSeriesChart.tsx` (line 15)

## Properties

| Property | Type |
|---|---|
| `date` | `string` |
| `views` | `number` |
| `uniqueVisitors` | `number` |

<!-- source: class-tokentracker.md -->

# TokenTracker

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/pipeline/token-tracker.ts` (line 54)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `recordUsage` | `recordUsage(usage: Omit<TokenUsage, 'timestamp' | 'cost'>)` | `TokenUsage` |
| `calculateCost` | `calculateCost(inputTokens: number, outputTokens: number, model: 'claude' | 'openai')` | `number` |
| `hasCapacity` | `hasCapacity(estimatedTokens: number)` | `boolean` |
| `getRemainingBudget` | `getRemainingBudget()` | `number` |
| `getStageUsage` | `getStageUsage(stage: JobStage)` | `StageTokenSummary` |
| `getSummary` | `getSummary()` | `TokenSummary` |
| `getHistory` | `getHistory()` | `TokenUsage[]` |
| `estimateCost` | `estimateCost(estimatedInputTokens: number, estimatedOutputTokens: number, model: 'claude' | 'openai')` | `{
    estimatedCostUsd: number;
    withinBudget: boolean;
    budgetRemaining: number;
  }` |
| `reset` | `reset()` | `void` |

<!-- source: function-uifmt.md -->

# uiFmt

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/uiStrings.ts` (line 530)

Localized UI string with `{token}` replacement.

## Signature

```ts
function uiFmt(lang: string | null | undefined, key: UiStringKey, params: Record<string, string | number>): string
```

## Parameters

| Name | Type |
|---|---|
| `lang` | `string | null | undefined` |
| `key` | `UiStringKey` |
| `params` | `Record<string, string | number>` |

**Returns:** `string`

<!-- source: type-workercaptureprogresscallback.md -->

# WorkerCaptureProgressCallback

**Kind:** Type

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/worker-capturer.service.ts` (line 37)

## Definition

```ts
(progress: WorkerCaptureProgress) => void
```

<!-- source: interface-codesampledata.md -->

# CodeSampleData

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/CodeSample.ts` (line 11)

Matches the OpenAPI `x-codeSamples` entries the spec pipeline generates (lang + source).

## Properties

| Property | Type |
|---|---|
| `lang` | `string` |
| `source` | `string` |

<!-- source: constant-disableimageresize.md -->

# disableImageResize$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 161)

Holds the disable image resize configuration flag.

<!-- source: api-endpoint-escalatepublicchat.md -->

# escalatePublicChat

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 854)

## Endpoint

`POST /public/p/:slugWithId/chat/escalate`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: component-example-7.md -->

# Example

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/remote.tsx` (line 18)

## Diagram

```mermaid
graph TD
    component_Example_1c49d601["Example"]
    class component_Example_1c49d601 rootComponent
```

## Relationships

- RENDERS → `RemoteMDXEditorRealmProvider`
- RENDERS → `ExampleRemoteRealmAccessor`
- RENDERS → `MDXEditor`
- USES_HOOK → `useRef`

<!-- source: function-generatecomponenthierarchydiagram.md -->

# generateComponentHierarchyDiagram

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/component-hierarchy-diagram.generator.ts` (line 363)

Generate component hierarchy diagram

## Signature

```ts
function generateComponentHierarchyDiagram(rootComponent: ComponentEntity, allComponents: ComponentEntity[], relationships: Relationship[], options: ComponentHierarchyDiagramOptions): HierarchyDiagramResult
```

## Parameters

| Name | Type |
|---|---|
| `rootComponent` | `ComponentEntity` |
| `allComponents` | `ComponentEntity[]` |
| `relationships` | `Relationship[]` |
| `options` | `ComponentHierarchyDiagramOptions` |

**Returns:** `HierarchyDiagramResult`

<!-- source: component-issuesallpageinner.md -->

# IssuesAllPageInner

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/all/page.tsx` (line 190)

## Diagram

```mermaid
graph TD
    component_IssuesAllPageInner_5dae5991["IssuesAllPageInner"]
    class component_IssuesAllPageInner_5dae5991 rootComponent
```

## Relationships

- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `ArrowLeftIcon`
- RENDERS → `IssuesViewTabs`
- RENDERS → `Bars3BottomLeftIcon`
- RENDERS → `ArrowDownTrayIcon`
- RENDERS → `ArrowPathIcon`
- RENDERS → `FilterSelect`
- RENDERS → `Squares2X2Icon`
- RENDERS → `AdjustmentsHorizontalIcon`
- RENDERS → `MagnifyingGlassIcon`
- RENDERS → `ChipActive`
- RENDERS → `ViewColumnsIcon`
- RENDERS → `BoardPicker`
- RENDERS → `React-Fragment`
- RENDERS → `Badge`
- RENDERS → `ChatBubbleLeftRightIcon`
- RENDERS → `EllipsisHorizontalIcon`
- RENDERS → `ChevronLeftIcon`
- RENDERS → `ChevronRightIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`
- USES_HOOK → `useMemo`

## Referenced By

- `IssuesAllPage` (RENDERS)

<!-- source: interface-listnotificationsoptions.md -->

# ListNotificationsOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/notification/notification.service.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `unreadOnly` | `boolean` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: interface-llmsdoc.md -->

# LlmsDoc

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/llms-txt.ts` (line 28)

## Properties

| Property | Type |
|---|---|
| `projectName` | `string` |
| `summary` | `string` |
| `pages` | `LlmsPage[]` |

<!-- source: interface-mcptooldefinition.md -->

# McpToolDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/mcp/mcp-client.ts` (line 51)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `inputSchema` | `Record<string, unknown>` |

<!-- source: function-mergestyleattributes.md -->

# mergeStyleAttributes

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/mergeStyleAttributes.ts` (line 1)

## Signature

```ts
function mergeStyleAttributes(style1: string, style2: string): string
```

## Parameters

| Name | Type |
|---|---|
| `style1` | `string` |
| `style2` | `string` |

**Returns:** `string`

<!-- source: function-runpreflightchecks.md -->

# runPreflightChecks

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/test-watcher.ts` (line 307)

Run pre-flight environment checks before agent starts.

## Signature

```ts
function runPreflightChecks(config: PreflightConfig): PreflightResult[]
```

## Parameters

| Name | Type |
|---|---|
| `config` | `PreflightConfig` |

**Returns:** `PreflightResult[]`

<!-- source: class-startdocjobdto.md -->

# StartDocJobDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/documentation/dto/doc-automation.dto.ts` (line 355)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `skipCloneIfExists` | `boolean` |
| `skipScreenshots` | `boolean` |
| `screenshotsOnly` | `boolean` |
| `useV4dStructure` | `boolean` |
| `skipUpload` | `boolean` |
| `useAgentWriter` | `boolean` |
| `enableAgentVerification` | `boolean` |
| `includePaths` | `string[]` |
| `excludePaths` | `string[]` |
| `targetAudience` | `'beginner' | 'intermediate' | 'advanced'` |
| `audienceScope` | `string` |
| `tone` | `'formal' | 'friendly' | 'technical'` |
| `maxDocuments` | `number` |
| `commitHash` | `string` |
| `branch` | `string` |
| `gitTag` | `string` |
| `versionLabel` | `string` |
| `versionDescription` | `string` |
| `triggeredBy` | `'manual' | 'webhook' | 'schedule' | 'cli'` |
| `useExternalOutput` | `boolean` |
| `externalOutputPath` | `string` |
| `updateAssetsOnly` | `boolean` |
| `onlySlugs` | `string[]` |
| `captureOnlySlugs` | `string[]` |

<!-- source: service-suggestionservice.md -->

# SuggestionService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/suggestion/suggestion.service.ts` (line 16)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `create` | `create(documentId: string, dto: CreateSuggestionDto, user: JwtPayload)` | `unknown` |
| `list` | `list(documentId: string)` | `unknown` |
| `accept` | `accept(id: string, user: JwtPayload, reviewDto: ReviewSuggestionDto)` | `unknown` |
| `reject` | `reject(id: string, user: JwtPayload, reviewDto: ReviewSuggestionDto)` | `unknown` |
| `delete` | `delete(id: string, user: JwtPayload)` | `unknown` |
| `getById` | `getById(id: string)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `documentgateway`
- DEPENDS_ON → `activityservice`
- DEPENDS_ON → `notificationservice`

<!-- source: interface-toastaction.md -->

# ToastAction

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Boards/Toast.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `onClick` | `() => void` |

<!-- source: class-troubleshootinggenerator.md -->

# TroubleshootingGenerator

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-14-meta/generators/troubleshooting.generator.ts` (line 45)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `extractTroubleshootingSections` | `extractTroubleshootingSections(documents: Array<{ title: string; slug: string; content?: string }>)` | `ExtractedTroubleshootingSection[]` |
| `generate` | `generate(input: TroubleshootingGeneratorInput, templates: FixedDocTemplate[], reference: MetaCategoryReference)` | `Promise<{
    documents: GeneratedDocument[];
    promptTokens: number;
    completionTokens: number;
  }>` |
| `generateOverview` | `generateOverview(input: TroubleshootingGeneratorInput, templates: FixedDocTemplate[], reference: MetaCategoryReference)` | `Promise<{
    documents: GeneratedDocument[];
    promptTokens: number;
    completionTokens: number;
  }>` |

<!-- source: function-uiplural.md -->

# uiPlural

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/uiStrings.ts` (line 547)

Simple one/other pluralization over `<base>_one` / `<base>_other` keys.
(Approximation for languages with richer plural rules — good enough for
viewer chrome; counts are also shown as digits.)

## Signature

```ts
function uiPlural(lang: string | null | undefined, base: | 'resultCount'
    | 'documentCount'
    | 'categoryCount'
    | 'documentsAvailable'
    | 'articleCount', n: number): string
```

## Parameters

| Name | Type |
|---|---|
| `lang` | `string | null | undefined` |
| `base` | `| 'resultCount'
    | 'documentCount'
    | 'categoryCount'
    | 'documentsAvailable'
    | 'articleCount'` |
| `n` | `number` |

**Returns:** `string`

<!-- source: interface-colorscale.md -->

# ColorScale

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 5)

Design Tokens - Complete type definitions for the Atloria design system

## Properties

| Property | Type |
|---|---|
| `50` | `string` |
| `100` | `string` |
| `200` | `string` |
| `300` | `string` |
| `400` | `string` |
| `500` | `string` |
| `600` | `string` |
| `700` | `string` |
| `800` | `string` |
| `900` | `string` |

<!-- source: constant-disableimagesettingsbutton.md -->

# disableImageSettingsButton$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 340)

<!-- source: api-endpoint-exportconfluence.md -->

# exportConfluence

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 300)

## Endpoint

`POST /technical-docs/:projectId/export/confluence`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-expressionattributes.md -->

# ExpressionAttributes

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/jsx.tsx` (line 202)

## Diagram

```mermaid
graph TD
    component_ExpressionAttributes_148b0091["ExpressionAttributes"]
    class component_ExpressionAttributes_148b0091 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: function-generatecoveragecss.md -->

# generateCoverageCSS

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/state-machine-diagram.generator.ts` (line 377)

Generate CSS for coverage visualization

## Signature

```ts
function generateCoverageCSS(colorScheme: Record<string, string>): string
```

## Parameters

| Name | Type |
|---|---|
| `colorScheme` | `Record<string, string>` |

**Returns:** `string`

<!-- source: component-issuetrendchart.md -->

# IssueTrendChart

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/page.tsx` (line 125)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `data` | `TrendPoint[]` | ✓ | - |
| `height` | `number` | - | 260 |

## Diagram

```mermaid
graph TD
    component_IssueTrendChart_62728ae7["IssueTrendChart"]
    class component_IssueTrendChart_62728ae7 rootComponent
```

## Relationships

- RENDERS → `ResponsiveContainer`
- RENDERS → `AreaChart`
- RENDERS → `CartesianGrid`
- RENDERS → `XAxis`
- RENDERS → `YAxis`
- RENDERS → `RTooltip`
- RENDERS → `Area`

## Referenced By

- `IssuesListPage` (RENDERS)

<!-- source: interface-llmspage.md -->

# LlmsPage

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/llms-txt.ts` (line 16)

Agent-native docs layer — llms.txt + llms-full.txt generators (llmstxt.org).

`llms.txt` is a curated, link-based INDEX an LLM reads to navigate the docs: an H1 project
name, a blockquote summary, then `##` sections each holding a bullet list of
`[title](path.md): description`. A section literally named `## Optional` is lower-priority
(an agent may skip it under a tight context budget) and is emitted last.

`llms-full.txt` is the entire documentation concatenated into one markdown file for a single
ingest, each page prefixed with a `<!-- source: … -->` comment for traceability.

Both are pure functions over a generic doc shape so the CLI and the web materializer can feed
their own doc sets in.

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `path` | `string` |
| `section` | `string` |
| `description` | `string` |
| `markdown` | `string` |
| `importance` | `number` |

<!-- source: interface-loadingstatemetadata.md -->

# LoadingStateMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/tutorial-detector.service.ts` (line 7)

Loading state metadata for tutorial generation

## Properties

| Property | Type |
|---|---|
| `indicatorType` | `'spinner' | 'skeleton' | 'progress' | 'overlay'` |
| `disabledElements` | `string[]` |
| `loadingMessage` | `string` |

<!-- source: interface-memorymanagerconfig.md -->

# MemoryManagerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/memory/types.ts` (line 105)

## Properties

| Property | Type |
|---|---|
| `storageDir` | `string` |
| `maxMemoriesPerProject` | `number` |
| `stalenessDays` | `number` |
| `maxContextMemories` | `number` |

<!-- source: function-noop.md -->

# noop

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/fp.ts` (line 81)

an empty function

<!-- source: function-runprocessorpipeline.md -->

# runProcessorPipeline

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/context/history-processors.ts` (line 286)

Run the processor pipeline over input items.
Returns the transformed items (never mutates the originals).

## Signature

```ts
function runProcessorPipeline(processors: HistoryProcessor[], items: AgentInputItem[]): AgentInputItem[]
```

## Parameters

| Name | Type |
|---|---|
| `processors` | `HistoryProcessor[]` |
| `items` | `AgentInputItem[]` |

**Returns:** `AgentInputItem[]`

<!-- source: class-startfullsyncdto.md -->

# StartFullSyncDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/sync-job.dto.ts` (line 86)

Start full sync request DTO

## Properties

| Property | Type |
|---|---|
| `scope` | `SyncJobScope` |
| `projectId` | `string` |
| `force` | `boolean` |

<!-- source: service-supportagentservice.md -->

# SupportAgentService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.service.ts` (line 24)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getConfig` | `getConfig(projectId: string)` | `unknown` |
| `upsertConfig` | `upsertConfig(projectId: string, organizationId: string, dto: UpsertSupportAgentConfigDto)` | `unknown` |
| `listAgents` | `listAgents(projectId: string)` | `unknown` |
| `createAgent` | `createAgent(projectId: string, organizationId: string, dto: any)` | `unknown` |
| `getAgent` | `getAgent(agentId: string)` | `unknown` |
| `updateAgent` | `updateAgent(agentId: string, dto: any)` | `unknown` |
| `deleteAgent` | `deleteAgent(agentId: string)` | `unknown` |
| `chat` | `chat(projectId: string, agentId: string, organizationId: string, message: string, opts: {
      versionNumber?: number;
      conversationHistory?: Array<{ role: string; content: string }>;
      sessionId?: string;
    })` | `unknown` |
| `chatStream` | `chatStream(projectId: string, agentId: string, organizationId: string, message: string, opts: {
      versionNumber?: number;
      conversationHistory?: Array<{ role: string; content: string }>;
      sessionId?: string;
    })` | `unknown` |
| `getChatHistory` | `getChatHistory(projectId: string, agentId: string, limit: unknown)` | `unknown` |
| `clearChatHistory` | `clearChatHistory(projectId: string, agentId: string)` | `unknown` |
| `search` | `search(projectId: string, organizationId: string, query: string, limit: unknown, docVersionId: string)` | `unknown` |
| `searchAll` | `searchAll(projectId: string, organizationId: string, query: string, limit: unknown)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `azuresearchservice`
- DEPENDS_ON → `languagedetectorservice`
- DEPENDS_ON → `agentadapterservice`

<!-- source: class-uilibrarydetector.md -->

# UILibraryDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/ui-library-detector.ts` (line 51)

UI Library Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detect` | `detect(entities: Entity[])` | `DetectedUIComponent[]` |
| `getSummary` | `getSummary(components: DetectedUIComponent[])` | `UILibrarySummary[]` |
| `getComponentSummary` | `getComponentSummary(component: DetectedUIComponent)` | `string` |

<!-- source: function-uistr.md -->

# uiStr

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/uiStrings.ts` (line 525)

Localized UI string; unknown language → English.

## Signature

```ts
function uiStr(lang: string | null | undefined, key: UiStringKey): string
```

## Parameters

| Name | Type |
|---|---|
| `lang` | `string | null | undefined` |
| `key` | `UiStringKey` |

**Returns:** `string`

<!-- source: interface-updateconfigdto.md -->

# UpdateConfigDto

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationConfig.ts` (line 77)

DTO for updating config

## Properties

| Property | Type |
|---|---|
| `repositoryUrl` | `string` |
| `repositoryBranch` | `string` |
| `frontendPath` | `string` |
| `backendPath` | `string` |
| `siteUrl` | `string` |
| `siteLoginUrl` | `string` |
| `siteEmail` | `string` |
| `sitePassword` | `string` |
| `repoUsername` | `string` |
| `repoPassword` | `string` |
| `skeletonStructure` | `SkeletonStructure` |
| `targetAudience` | `string` |
| `autoPublish` | `boolean` |

<!-- source: interface-commentlistparams.md -->

# CommentListParams

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/comments.ts` (line 12)

Comment list query parameters

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `resolved` | `boolean` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: constant-documentation-critical-patterns.md -->

# DOCUMENTATION_CRITICAL_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 529)

<!-- source: api-endpoint-exportcsv.md -->

# exportCSV

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/audit/audit.controller.ts` (line 39)

## Endpoint

`GET /audit/:projectId/export/csv`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `AuditController` (MODULE_DECLARES)

<!-- source: component-fakeimage.md -->

# FakeImage

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/images.tsx` (line 83)

## Diagram

```mermaid
graph TD
    component_FakeImage_3a618d69["FakeImage"]
    class component_FakeImage_3a618d69 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `InsertImage`

<!-- source: function-generatedatabaseschemadiagram.md -->

# generateDatabaseSchemaDiagram

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/database-schema-diagram.generator.ts` (line 304)

Generate database schema diagram

## Signature

```ts
function generateDatabaseSchemaDiagram(models: DatabaseModelEntity[], options: DatabaseSchemaDiagramOptions): DatabaseSchemaDiagramResult
```

## Parameters

| Name | Type |
|---|---|
| `models` | `DatabaseModelEntity[]` |
| `options` | `DatabaseSchemaDiagramOptions` |

**Returns:** `DatabaseSchemaDiagramResult`

<!-- source: component-jobrow.md -->

# JobRow

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/DocAutomation/JobHistory.tsx` (line 133)

Individual job row component

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `job` | `DocumentationJobEntry` | ✓ | - |
| `liveProgress` | `LiveJobProgress` | - | - |
| `allLiveProgress` | `Record` | ✓ | - |
| `projectId` | `string` | ✓ | - |
| `onRegenerate` | `Function` | - | - |
| `onCancelJob` | `Function` | - | - |
| `onDeleteJobDocuments` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_JobRow_4f8f4a36["JobRow"]
    class component_JobRow_4f8f4a36 rootComponent
```

## Relationships

- RENDERS → `StatusIcon`
- RENDERS → `Clock`
- RENDERS → `FileText`
- RENDERS → `StopCircle`
- RENDERS → `ChevronUp`
- RENDERS → `ChevronDown`
- RENDERS → `motion-div`
- RENDERS → `AnimatePresence`
- RENDERS → `CompletionSummary`
- RENDERS → `AlertTriangle`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`

## Referenced By

- `JobHistory` (RENDERS)

<!-- source: interface-llmstxtoptions.md -->

# LlmsTxtOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/llms-txt.ts` (line 34)

## Properties

| Property | Type |
|---|---|
| `baseUrl` | `string` |
| `tierThreshold` | `number` |
| `topCount` | `number` |

<!-- source: interface-managedsession.md -->

# ManagedSession

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/agent/agent.service.ts` (line 71)

## Properties

| Property | Type |
|---|---|
| `session` | `AgentSession` |
| `todoManager` | `TodoManager` |
| `workspace` | `string` |
| `reliability` | `ReliabilityContext` |
| `bashSession` | `BashSession` |
| `pluginManager` | `PluginManager` |
| `orchestrator` | `Orchestrator` |
| `cronScheduler` | `CronScheduler` |
| `remoteTriggerServer` | `RemoteTriggerServer` |
| `mcpManager` | `McpManager` |

<!-- source: interface-memorymanageroptions.md -->

# MemoryManagerOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/memory/memory-manager.ts` (line 34)

## Properties

| Property | Type |
|---|---|
| `store` | `MemoryStore` |
| `modelCall` | `(prompt: string) => Promise<string>` |

<!-- source: function-normalizepath.md -->

# normalizePath

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/services/entity-mapper.service.ts` (line 304)

Normalize a file path: resolve and convert backslashes to forward slashes.

## Signature

```ts
function normalizePath(filePath: string): string
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |

**Returns:** `string`

<!-- source: function-runwithretry.md -->

# runWithRetry

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/retry-runner.ts` (line 69)

Run a benchmark task with retries, picking the best result.

## Signature

```ts
async function runWithRetry(task: BenchmarkTask, runOnce: (task: BenchmarkTask, temperature?: number) => Promise<TaskResult>, config: RetryConfig, log: (msg: string) => void): Promise<RetryResult>
```

## Parameters

| Name | Type |
|---|---|
| `task` | `BenchmarkTask` |
| `runOnce` | `(task: BenchmarkTask, temperature?: number) => Promise<TaskResult>` |
| `config` | `RetryConfig` |
| `log` | `(msg: string) => void` |

**Returns:** `Promise<RetryResult>`

<!-- source: class-summarizedocumentdto.md -->

# SummarizeDocumentDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/ai/dto/summarize-document.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `provider` | `string` |

<!-- source: service-symbolindexservice.md -->

# SymbolIndexService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/parser/services/symbol-index.service.ts` (line 7)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `indexDocument` | `indexDocument(documentId: string)` | `Promise<void>` |
| `searchSymbols` | `searchSymbols(query: string, type: string)` | `Promise<any[]>` |
| `getSymbolsByDocument` | `getSymbolsByDocument(documentId: string)` | `Promise<any[]>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `parserservice`

<!-- source: class-unrecognizedmarkdownconstructerror.md -->

# UnrecognizedMarkdownConstructError

**Kind:** Class

**Source:** `atloria-monorepo/packages/editor/src/importMarkdownToLexical.ts` (line 174)

**Extends:** `Error`

<!-- source: interface-uploadedimage.md -->

# UploadedImage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useImageUpload.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `url` | `string` |
| `filename` | `string` |
| `size` | `number` |
| `width` | `number` |
| `height` | `number` |
| `altText` | `string` |
| `caption` | `string` |
| `audiences` | `string[]` |

<!-- source: function-useai.md -->

# useAI

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/AI/useAI.ts` (line 50)

Custom hook for AI operations with SSE streaming support

Handles:
- Multiple AI providers (Azure Claude, Azure OpenAI)
- Streaming responses via Server-Sent Events
- Document enhancement, outline generation, text improvement, summarization
- Error handling and loading states
- Provider selection

## Signature

```ts
function useAI(options: UseAIOptions): UseAIReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseAIOptions` |

**Returns:** `UseAIReturn`

<!-- source: interface-commentwithuser.md -->

# CommentWithUser

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/comment.dto.ts` (line 7)

Comment DTO with populated user relation

## Properties

| Property | Type |
|---|---|
| `user` | `Pick<User, 'id' | 'name' | 'email'>` |
| `replies` | `CommentWithUser[]` |

<!-- source: constant-documentation-dependency-rules.md -->

# DOCUMENTATION_DEPENDENCY_RULES

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 568)

<!-- source: api-endpoint-exporthtml.md -->

# exportHTML

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 471)

## Endpoint

`GET /doc-versions/:projectId/:versionId/export/html`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-faqaccordion-2.md -->

# FaqAccordion

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/faq/faq-accordion.tsx` (line 14)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `items` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FaqAccordion_6193292f["FaqAccordion"]
    class component_FaqAccordion_6193292f rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `AccordionItem`
- USES_HOOK → `useTranslation`

<!-- source: function-generatedeploymentcss.md -->

# generateDeploymentCSS

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/deployment-diagram.generator.ts` (line 531)

Generate CSS for deployment diagram styling

## Signature

```ts
function generateDeploymentCSS(): string
```

**Returns:** `string`

<!-- source: component-kbpanel.md -->

# KbPanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/page.tsx` (line 225)

## Diagram

```mermaid
graph TD
    component_KbPanel_792a2d1d["KbPanel"]
    class component_KbPanel_792a2d1d rootComponent
```

## Relationships

- RENDERS → `PreviewShell`

## Referenced By

- `HomePage` (RENDERS)

<!-- source: interface-loadingstatepattern.md -->

# LoadingStatePattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-management.interface.ts` (line 439)

Loading state pattern

## Properties

| Property | Type |
|---|---|
| `loadingField` | `string` |
| `indicatorType` | `'spinner' | 'skeleton' | 'progress' | 'overlay'` |
| `disabledElements` | `string[]` |
| `loadingMessage` | `string` |
| `hasOptimisticUpdate` | `boolean` |

<!-- source: interface-materializeoptions.md -->

# MaterializeOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-materializer.service.ts` (line 92)

## Properties

| Property | Type |
|---|---|
| `projectName` | `string` |
| `readme` | `string` |
| `enrichment` | `Map<string, EntityEnrichment>` |

<!-- source: interface-memoryquery.md -->

# MemoryQuery

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/memory/types.ts` (line 59)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `category` | `MemoryRecord['category'] | MemoryRecord['category'][]` |
| `tags` | `string[]` |
| `relatedFiles` | `string[]` |
| `minConfidence` | `'high' | 'medium' | 'low'` |
| `limit` | `number` |
| `excludeSuperseded` | `boolean` |
| `excludeExpired` | `boolean` |
| `search` | `string` |

<!-- source: function-parsedirectives.md -->

# parseDirectives

**Kind:** Function

**Source:** `atloria-monorepo/packages/core/src/rendering/directive-parser.ts` (line 726)

Convenience function to parse markdown content

## Signature

```ts
function parseDirectives(content: string, options: ParserOptions): DocumentAST
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |
| `options` | `ParserOptions` |

**Returns:** `DocumentAST`

<!-- source: function-savepredictions.md -->

# savePredictions

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-evaluator.ts` (line 84)

Save TaskResults as a JSONL predictions file for the SWE-bench harness.
Skips results with empty/whitespace-only patches.

## Signature

```ts
function savePredictions(results: TaskResult[], outputPath: string, modelName: string): void
```

## Parameters

| Name | Type |
|---|---|
| `results` | `TaskResult[]` |
| `outputPath` | `string` |
| `modelName` | `string` |

**Returns:** `void`

<!-- source: class-syncbatchdto.md -->

# SyncBatchDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/sync.dto.ts` (line 84)

Batch sync request DTO

## Properties

| Property | Type |
|---|---|
| `documents` | `SyncDocumentDto[]` |
| `conflictStrategy` | `'skip' | 'overwrite' | 'version'` |
| `autoCreateCategories` | `boolean` |
| `deleteOrphans` | `boolean` |
| `docVersionId` | `string` |

<!-- source: service-syncjobservice.md -->

# SyncJobService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/project/sync-job.service.ts` (line 35)

SyncJobService

Manages background sync jobs for reindexing documents across organization or project.
Provides progress tracking and status reporting.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `startFullSync` | `startFullSync(dto: StartFullSyncDto, organizationId: string, userId: string)` | `Promise<SyncJobDto>` |
| `getJobStatus` | `getJobStatus(jobId: string)` | `Promise<SyncJobDto>` |
| `getOrganizationJobs` | `getOrganizationJobs(organizationId: string)` | `Promise<SyncJobDto[]>` |
| `cancelJob` | `cancelJob(jobId: string)` | `Promise<SyncJobDto>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `documentindexingservice`

<!-- source: class-uploaderror.md -->

# UploadError

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/errors.ts` (line 207)

Error thrown when upload fails

**Extends:** `PipelineError`

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `statusCode` | `number` |

<!-- source: interface-uploadimageoptions.md -->

# UploadImageOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useImageUpload.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `file` | `File` |
| `altText` | `string` |
| `caption` | `string` |
| `tags` | `string[]` |
| `audiences` | `string[]` |

<!-- source: function-useaiproviders.md -->

# useAIProviders

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useAIProviders.ts` (line 10)

Custom hook to fetch and manage AI providers

<!-- source: interface-comparisonfeaturetableprops-2.md -->

# ComparisonFeatureTableProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/comparison/comparison-feature-table.tsx` (line 14)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `columns` | `{ nameKey: string; highlighted?: boolean }[]` |
| `features` | `{ featureKey: string; values: (boolean | string)[] }[]` |

<!-- source: constant-dramatic.md -->

# dramatic

**Kind:** Constant

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/animations.ts` (line 92)

Dramatic entrance — for hero sections

## Definition

```ts
Variants
```

<!-- source: api-endpoint-exportjson.md -->

# exportJSON

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/audit/audit.controller.ts` (line 56)

## Endpoint

`GET /audit/:projectId/export/json`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `AuditController` (MODULE_DECLARES)

<!-- source: component-faqtwocolumn-2.md -->

# FaqTwoColumn

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/faq/faq-two-column.tsx` (line 14)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `items` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FaqTwoColumn_347ec384["FaqTwoColumn"]
    class component_FaqTwoColumn_347ec384 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `AccordionItem`
- USES_HOOK → `useTranslation`

<!-- source: function-generatedeploymentdiagram.md -->

# generateDeploymentDiagram

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/deployment-diagram.generator.ts` (line 492)

Generate deployment diagram from entities and relationships

## Signature

```ts
function generateDeploymentDiagram(entities: Entity[], relationships: Relationship[], options: DeploymentDiagramOptions): DeploymentDiagramResult
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `Entity[]` |
| `relationships` | `Relationship[]` |
| `options` | `DeploymentDiagramOptions` |

**Returns:** `DeploymentDiagramResult`

<!-- source: component-kpicard.md -->

# KpiCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/analytics/DeflectionCockpit.tsx` (line 94)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `label` | `string` | ✓ | - |
| `subtitle` | `string` | ✓ | - |
| `rate` | `number | null` | ✓ | - |
| `sub` | `string` | ✓ | - |
| `spark` | `number[]` | ✓ | - |
| `color` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_KpiCard_3d1f416b["KpiCard"]
    class component_KpiCard_3d1f416b rootComponent
```

## Relationships

- RENDERS → `Sparkline`

## Referenced By

- `DeflectionCockpit` (RENDERS)

<!-- source: interface-loopblock.md -->

# LoopBlock

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/template-analysis.interface.ts` (line 117)

Loop block (ngFor, v-for)

## Properties

| Property | Type |
|---|---|
| `type` | `'for'` |
| `variable` | `string` |
| `collection` | `string` |
| `line` | `number` |
| `indexVariable` | `string` |
| `elements` | `TemplateElement[]` |

<!-- source: interface-materializeresult.md -->

# MaterializeResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-materializer.service.ts` (line 387)

## Properties

| Property | Type |
|---|---|
| `docVersionId` | `string` |
| `versionNumber` | `number` |
| `categoriesCreated` | `number` |
| `documentsCreated` | `number` |

<!-- source: interface-memoryrecord.md -->

# MemoryRecord

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/memory/types.ts` (line 18)

Memory Persistence Types

Extends the existing SessionMemory extraction system with persistence,
lifecycle management, and cross-session recall.

Storage: JSON index + individual markdown files (Claude Code pattern).
Zero dependencies — uses Node.js fs only.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `projectId` | `string` |
| `category` | `'pattern' | 'pitfall' | 'environment' | 'optimization' | 'decision' | 'preference'` |
| `title` | `string` |
| `content` | `string` |
| `confidence` | `'high' | 'medium' | 'low'` |
| `createdAt` | `string` |
| `lastAccessedAt` | `string` |
| `accessCount` | `number` |
| `updatedAt` | `string` |
| `tags` | `string[]` |
| `relatedFiles` | `string[]` |
| `expiresAt` | `string` |
| `supersededBy` | `string` |

<!-- source: function-parseextractionresponse.md -->

# parseExtractionResponse

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/services/business-context-extractor.ts` (line 76)

Parse the AI response into a BusinessContext object.
Handles JSON extraction from various response formats (raw, code blocks, wrapped).

## Signature

```ts
function parseExtractionResponse(response: string, sources: ContextSource[], rawText: string): BusinessContext
```

## Parameters

| Name | Type |
|---|---|
| `response` | `string` |
| `sources` | `ContextSource[]` |
| `rawText` | `string` |

**Returns:** `BusinessContext`

<!-- source: function-serializehistoryitems.md -->

# serializeHistoryItems

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/context/model-compactor.ts` (line 91)

Serialize SDK input items into a text representation for the compaction model.
Handles the various formats the OpenAI Agents SDK uses.

## Signature

```ts
function serializeHistoryItems(items: unknown[]): string
```

## Parameters

| Name | Type |
|---|---|
| `items` | `unknown[]` |

**Returns:** `string`

<!-- source: class-syncbatchresponsedto.md -->

# SyncBatchResponseDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/sync.dto.ts` (line 161)

Batch sync response

## Properties

| Property | Type |
|---|---|
| `success` | `number` |
| `failed` | `number` |
| `skipped` | `number` |
| `results` | `SyncResultDto[]` |
| `categoriesCreated` | `string[]` |

<!-- source: service-syncservice.md -->

# SyncService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/project/sync.service.ts` (line 14)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `syncBatch` | `syncBatch(projectId: string, dto: SyncBatchDto, user: JwtPayload)` | `Promise<SyncBatchResponseDto>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `documentservice`
- DEPENDS_ON → `documentversionservice`
- DEPENDS_ON → `documentindexingservice`

<!-- source: function-useaisettings.md -->

# useAISettings

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useAISettings.ts` (line 20)

Custom hook to manage AI settings with localStorage persistence

<!-- source: interface-usecollaborationoptions.md -->

# UseCollaborationOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useCollaboration.ts` (line 64)

Options for the useCollaboration hook

## Properties

| Property | Type |
|---|---|
| `serverUrl` | `string` |
| `autoReconnect` | `boolean` |
| `maxReconnectAttempts` | `number` |
| `reconnectDelay` | `number` |

<!-- source: class-userendpoints.md -->

# UserEndpoints

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/users.ts` (line 32)

User endpoints

## Methods

| Method | Signature | Returns |
|---|---|---|
| `me` | `me()` | `Promise<User>` |
| `list` | `list(params: UserListParams)` | `Promise<User[]>` |
| `get` | `get(id: string)` | `Promise<User>` |
| `update` | `update(id: string, dto: UpdateUserDto)` | `Promise<User>` |
| `updateMe` | `updateMe(dto: UpdateUserDto)` | `Promise<User>` |
| `delete` | `delete(id: string)` | `Promise<void>` |

<!-- source: interface-comparisonrowprops-2.md -->

# ComparisonRowProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/comparison-row.tsx` (line 11)

## Properties

| Property | Type |
|---|---|
| `featureKey` | `string` |
| `values` | `(boolean | string)[]` |

<!-- source: constant-editimagetoolbarcomponent.md -->

# editImageToolbarComponent$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 359)

Holds the custom EditImageToolbar component.

<!-- source: api-endpoint-exportmarkdown.md -->

# exportMarkdown

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 465)

## Endpoint

`GET /doc-versions/:projectId/:versionId/export/markdown`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-featureicon-2.md -->

# FeatureIcon

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/feature-icon.tsx` (line 17)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `icon` | `LucideIcon` | ✓ | - |
| `size` | `number` | - | 24 |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_FeatureIcon_a8d7b68["FeatureIcon"]
    class component_FeatureIcon_a8d7b68 rootComponent
```

## Relationships

- RENDERS → `Icon`

<!-- source: function-generateentityid-3.md -->

# generateEntityId

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 597)

Generate a unique entity ID

## Signature

```ts
function generateEntityId(filePath: string, name: string, type: string): string
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |
| `name` | `string` |
| `type` | `string` |

**Returns:** `string`

<!-- source: component-languageproviderwrapper.md -->

# LanguageProviderWrapper

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/PublicLayoutShell.tsx` (line 267)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_LanguageProviderWrapper_8238777["LanguageProviderWrapper"]
    class component_LanguageProviderWrapper_8238777 rootComponent
```

## Relationships

- RENDERS → `LanguageProvider`
- USES_HOOK → `usePathname`

## Referenced By

- `PublicLayoutShell` (RENDERS)

<!-- source: interface-markdowndocentity-2.md -->

# MarkdownDocEntity

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 936)

Markdown document entity

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.MARKDOWN_DOC` |
| `title` | `string` |
| `headings` | `HeadingInfo[]` |
| `codeBlocks` | `CodeBlockInfo[]` |
| `links` | `LinkInfo[]` |
| `frontMatter` | `Record<string, unknown>` |

<!-- source: interface-memorystore.md -->

# MemoryStore

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/memory/types.ts` (line 84)

<!-- source: interface-metadatadiff.md -->

# MetadataDiff

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/dto/compare-document.dto.ts` (line 64)

Metadata diff

## Properties

| Property | Type |
|---|---|
| `field` | `string` |
| `changed` | `boolean` |
| `from` | `any` |
| `to` | `any` |

<!-- source: function-parseimagedimension.md -->

# parseImageDimension

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 361)

## Signature

```ts
function parseImageDimension(value: string | number | undefined)
```

## Parameters

| Name | Type |
|---|---|
| `value` | `string | number | undefined` |

<!-- source: function-setupreliability.md -->

# setupReliability

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/reliability-config.ts` (line 96)

Wire all reliability features into a session.

## Signature

```ts
function setupReliability(session: SessionLike, options: ReliabilityOptions, existingGateProvider: QualityGateProvider): ReliabilityContext
```

## Parameters

| Name | Type |
|---|---|
| `session` | `SessionLike` |
| `options` | `ReliabilityOptions` |
| `existingGateProvider` | `QualityGateProvider` |

**Returns:** `ReliabilityContext`

<!-- source: class-syncdocumentdto.md -->

# SyncDocumentDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/sync.dto.ts` (line 18)

Document sync DTO for batch operations

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `slug` | `string` |
| `content` | `string` |
| `type` | `string` |
| `description` | `string` |
| `audiences` | `string[]` |
| `categoryName` | `string` |
| `kgEntityId` | `string` |
| `kgEntityType` | `string` |
| `canRegenerate` | `boolean` |
| `order` | `number` |
| `parentSlug` | `string` |

<!-- source: service-techdocschatservice.md -->

# TechDocsChatService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/rag/techdocs-chat.service.ts` (line 17)

Foundation F3: conversational grounded chat — sessions, memory, streaming, feedback.
Wraps the one-shot TechDocsRagService with per-session history so follow-up questions
("what about its retry behavior?") resolve against the conversation, and records
answered/refused/feedback signals into the F2 event stream for the deflection dashboard.

`TechDocsChatService` provides session-based, grounded conversational chat over technical documentation. It wraps the one-shot `TechDocsRagService` by maintaining per-session message history (memory) so follow-up questions resolve in context, supports streaming responses, and records answered/refused/feedback signals into the F2 event stream for deflection analytics.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `createSession` | `createSession(projectId: string, organizationId: string | null, channel: string, userId: string | null)` | `unknown` |
| `askStream` | `askStream(projectId: string, sessionId: string, question: string)` | `AsyncGenerator<string, {
    messageId: string;
    citations: string[];
    sources: DocSearchHit[];
    usage: { inputTokens: number; outputTokens: number; totalTokens: number };
  }, void>` |
| `escalate` | `escalate(projectId: string, sessionId: string, dto: { email?: string; note?: string; pageUrl?: string })` | `unknown` |
| `feedback` | `feedback(projectId: string, messageId: string, rating: 'up' | 'down', comment: string)` | `unknown` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  actor User
  participant API as Controller/Resolver
  participant Chat as TechDocsChatService
  participant Store as Session Memory Store
  participant RAG as TechDocsRagService
  participant F2 as F2 Event Stream

  User->>API: sendMessage(sessionId, prompt)
  API->>Chat: chat(sessionId, prompt, opts)
  Chat->>Store: loadHistory(sessionId)
  Store-->>Chat: history[]
  Chat->>RAG: ask({ prompt, history, streaming: true })
  RAG-->>Chat: stream tokens / final answer
  Chat-->>API: stream to client
  Chat->>Store: appendTurn(sessionId, user+assistant)
  Chat->>F2: emit(answered|refused, metadata)
  User->>API: submitFeedback(sessionId, messageId, vote)
  API->>Chat: recordFeedback(...)
  Chat->>F2: emit(feedback, metadata)
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { TechDocsChatService } from './technical-docs/rag/techdocs-chat.service';

@Injectable()
export class TechDocsChatController {
  constructor(private readonly chat: TechDocsChatService) {}

  // Pseudo-handler; adapt to your transport (REST/GraphQL/WebSocket/SSE)
  async ask(sessionId: string, prompt: string) {
    // Non-streaming example (if supported by your method signature)
    const result = await this.chat.chat({
      sessionId,
      message: prompt,
      // optional: userId/tenantId/document scope/etc. depending on your app
    });

    return {
      sessionId,
      answer: result.answer,
      refused: result.refused,
      citations: result.citations,
    };
  }

  // Streaming example (SSE/WebSocket): consume async iterator/callback stream
  async askStream(sessionId: string, prompt: string, onToken: (t: string) => void) {
    const stream = await this.chat.chatStream({ sessionId, message: prompt });

    for await (const chunk of stream) {
      // chunk could be token/text delta depending on implementation
      onToken(chunk.text ?? String(chunk));
    }
  }

  async feedback(sessionId: string, messageId: string, vote: 'up' | 'down') {
    await this.chat.recordFeedback({ sessionId, messageId, vote });
    return { ok: true };
  }
}
```

## AI Coding Instructions

- Preserve the “one-shot RAG + session memory” layering: `TechDocsChatService` should manage history/streaming/telemetry, while `TechDocsRagService` stays focused on retrieval + answer generation.
- Always load and append conversation turns atomically per `sessionId` to avoid interleaving history when multiple requests stream concurrently.
- Emit consistent F2 events for answered/refused and feedback, including stable identifiers (sessionId, messageId, doc scope) so the deflection dashboard can aggregate correctly.
- When adding new options (e.g., doc filters, tenant scoping), pass them through to the RAG call and include them in event metadata; avoid storing large retrieved context blobs in session memory.

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `techdocsragservice`
- DEPENDS_ON → `ragchatmodelservice`
- DEPENDS_ON → `eventsservice`
- DEPENDS_ON → `issuesservice`

<!-- source: function-useauth-2.md -->

# useAuth

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useAuth.ts` (line 10)

Convenience wrapper around NextAuth's useSession.
Returns { session, status } where session is the typed Session object.

<!-- source: interface-usecollaborationreturn.md -->

# UseCollaborationReturn

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useCollaboration.ts` (line 78)

Return value of the useCollaboration hook

## Properties

| Property | Type |
|---|---|
| `ydoc` | `Y.Doc | null` |
| `ytext` | `Y.Text | null` |
| `awareness` | `awarenessProtocol.Awareness | null` |
| `synced` | `boolean` |
| `activeUsers` | `CollaborationUser[]` |
| `connectionStatus` | `ConnectionStatus` |
| `error` | `Error | null` |
| `updateCursor` | `(cursor: CursorPosition) => void` |
| `updateSelection` | `(selection: SelectionRange) => void` |
| `disconnect` | `() => void` |
| `reconnect` | `() => void` |
| `version` | `number` |

<!-- source: class-v2pipelineorchestrator.md -->

# V2PipelineOrchestrator

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/orchestrator.ts` (line 350)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `getStore` | `getStore()` | `StageResultStore` |
| `run` | `run(progressCallback: V2ProgressCallback)` | `Promise<V2PipelineResult>` |
| `cancel` | `cancel()` | `void` |

<!-- source: interface-componentservicedependency.md -->

# ComponentServiceDependency

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/cross-language.types.ts` (line 102)

Component-to-Service dependency tracking

Tracks which components use which services to build user journey maps.

## Properties

| Property | Type |
|---|---|
| `componentFile` | `string` |
| `componentName` | `string` |
| `injectedServices` | `Array<{
    serviceName: string;
    serviceFile: string;
    methodsCalled: string[]; // Which service methods this component calls
  }>` |

<!-- source: constant-editorinfocus.md -->

# editorInFocus$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 477)

The currently focused editor

<!-- source: api-endpoint-exportnotion.md -->

# exportNotion

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 311)

## Endpoint

`POST /technical-docs/:projectId/export/notion`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-featuresalternating-2.md -->

# FeaturesAlternating

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/features/features-alternating.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `features` | `Feature[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FeaturesAlternating_3ede4484["FeaturesAlternating"]
    class component_FeaturesAlternating_3ede4484 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- USES_HOOK → `useTranslation`

<!-- source: function-generatehierarchycss.md -->

# generateHierarchyCSS

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/component-hierarchy-diagram.generator.ts` (line 411)

Generate CSS for hierarchy diagram styling

## Signature

```ts
function generateHierarchyCSS(): string
```

**Returns:** `string`

<!-- source: component-linechart.md -->

# LineChart

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/analytics/DeflectionCockpit.tsx` (line 58)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `trend` | `TrendPoint[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_LineChart_745fba35["LineChart"]
    class component_LineChart_745fba35 rootComponent
```

## Referenced By

- `DeflectionCockpit` (RENDERS)

<!-- source: interface-mcptooldef.md -->

# McpToolDef

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/mcp-toolset.ts` (line 27)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `inputSchema` | `{ type: 'object'; properties: Record<string, unknown>; required?: string[] }` |

<!-- source: interface-memorytooloptions.md -->

# MemoryToolOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/memory.tool.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `memoryManager` | `MemoryManager` |

<!-- source: interface-notionblock.md -->

# NotionBlock

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/md-to-notion-blocks.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `object` | `'block'` |
| `type` | `string` |

<!-- source: function-prop.md -->

# prop

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/fp.ts` (line 37)

Returns a function which extracts the property from from the passed object.

## Signature

```ts
function prop(property: keyof T)
```

## Parameters

| Name | Type |
|---|---|
| `property` | `keyof T` |

<!-- source: function-shouldautosubmit.md -->

# shouldAutosubmit

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/agent-hardening.ts` (line 91)

Determine if we should extract and submit a partial patch.

Pattern from SWE-agent: On ANY non-success exit (timeout, max turns,
cost limit, API error), submit whatever git diff exists. A partial
fix is better than no submission.

Returns false if: task passed cleanly, or no changes exist.

## Signature

```ts
function shouldAutosubmit(result: {
  passed?: boolean;
  timedOut?: boolean;
  hasChanges?: boolean;
  error?: string;
}): boolean
```

## Parameters

| Name | Type |
|---|---|
| `result` | `{
  passed?: boolean;
  timedOut?: boolean;
  hasChanges?: boolean;
  error?: string;
}` |

**Returns:** `boolean`

<!-- source: class-syncentitiesdto.md -->

# SyncEntitiesDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/graph/dto/sync-entities.dto.ts` (line 66)

Request body for bulk entity sync

## Properties

| Property | Type |
|---|---|
| `entities` | `SyncEntityDto[]` |
| `workflowSignals` | `WorkflowSignals` |
| `enableAiWorkflows` | `boolean` |
| `aiModel` | `string` |
| `forceWorkflowDiscovery` | `boolean` |
| `businessContext` | `string` |

<!-- source: service-techdocsconnectorsservice.md -->

# TechDocsConnectorsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/techdocs-connectors.service.ts` (line 52)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `create` | `create(projectId: string, userId: string, dto: CreateConnectorDto)` | `unknown` |
| `list` | `list(projectId: string, userId: string)` | `unknown` |
| `setEnabled` | `setEnabled(projectId: string, userId: string, id: string, enabled: boolean)` | `unknown` |
| `remove` | `remove(projectId: string, userId: string, id: string)` | `unknown` |
| `syncNow` | `syncNow(projectId: string, userId: string, id: string)` | `unknown` |
| `syncDue` | `syncDue()` | `unknown` |
| `syncOne` | `syncOne(id: string)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `techdocssourcesservice`

<!-- source: function-useboardstoast.md -->

# useBoardsToast

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Boards/Toast.tsx` (line 32)

## Signature

```ts
function useBoardsToast(): ToastContextValue
```

**Returns:** `ToastContextValue`

<!-- source: interface-usedocumentationconfigoptions.md -->

# UseDocumentationConfigOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationConfig.ts` (line 96)

Hook options

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `apiUrl` | `string` |
| `getToken` | `() => string | null` |
| `autoLoad` | `boolean` |

<!-- source: class-validationdetector.md -->

# ValidationDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/validation-detector.ts` (line 67)

Validation Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detect` | `detect(entities: Entity[])` | `DetectedValidation[]` |
| `describeValidation` | `describeValidation(validation: DetectedValidation)` | `string` |

<!-- source: interface-conditionalcontentsoption.md -->

# ConditionalContentsOption

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/toolbar.tsx` (line 247)

## Properties

| Property | Type |
|---|---|
| `when` | `(rootNode: EditorInFocus | null) => boolean` |
| `contents` | `() => React.ReactNode` |

<!-- source: constant-editorrootelementref.md -->

# editorRootElementRef$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 325)

A reference to a DOM element. used for the various popups, dialogs, and tooltips

<!-- source: api-endpoint-exportnow.md -->

# exportNow

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/export/analytics-export.controller.ts` (line 46)

## Endpoint

`POST /analytics/:projectId/export`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `format` | query | `'pdf' | 'csv'` | ✓ |

## Referenced By

- `AnalyticsExportController` (MODULE_DECLARES)

<!-- source: component-featuresbentomodern-2.md -->

# FeaturesBentoModern

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/features/features-bento-modern.tsx` (line 28)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `features` | `BentoFeature[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FeaturesBentoModern_54694613["FeaturesBentoModern"]
    class component_FeaturesBentoModern_54694613 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `FeatureIcon`
- USES_HOOK → `useTranslation`

<!-- source: function-generatemermaiddiagram.md -->

# generateMermaidDiagram

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/state-machine-analyzer.ts` (line 273)

Generate Mermaid state diagram from state machine definition

Creates a Mermaid stateDiagram-v2 syntax representation of the workflow.

## Signature

```ts
function generateMermaidDiagram(stateMachine: StateMachine): string
```

## Parameters

| Name | Type |
|---|---|
| `stateMachine` | `StateMachine` |

**Returns:** `string`

<!-- source: component-loadinggrid.md -->

# LoadingGrid

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Documents/DocumentList.tsx` (line 435)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `viewMode` | `ViewMode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_LoadingGrid_6ac76090["LoadingGrid"]
    class component_LoadingGrid_6ac76090 rootComponent
```

## Referenced By

- `DocumentList` (RENDERS)

<!-- source: interface-methodcall.md -->

# MethodCall

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 67)

## Properties

| Property | Type |
|---|---|
| `type` | `'http' | 'internal'` |
| `target` | `string` |
| `method` | `string` |

<!-- source: interface-modelcapabilityprofile.md -->

# ModelCapabilityProfile

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-profiles.ts` (line 15)

Model Capability Profiles

Describes what each model needs at the API level and prompt level.
This makes AgentSession and buildAdaptivePrompt model-agnostic:
instead of scattering `if (model.includes('gpt-5'))` checks, callers
declare what a model needs via a profile.

Resolution order (first wins):
  1. Explicit `modelProfile` on AzureModelProviderConfig (deployer knows their model)
  2. Name-based detection via getDefaultProfile(modelId) (well-known slugs)
  3. STANDARD_PROFILE (safe default — preserves current GPT-5.4 behavior)

## Properties

| Property | Type |
|---|---|
| `supportsReasoningEffort` | `boolean` |
| `supportsTemperature` | `boolean` |
| `supportsStrictTools` | `boolean` |
| `defaults` | `{
    /**
     * Reasoning effort applied when the agent has tools and the caller
     * hasn't explicitly set reasoningEffort.
     * GPT-5.4: 'medium' (defaults to 'none' otherwise, skipping tool calls).
     * Claude / GPT-4.x: undefined (field not sent).
     */
    reasoningEffort?: 'none' | 'low' | 'medium' | 'high';

    /**
     * toolChoice for the FIRST turn only.
     * After turn 1, the session resets to 'auto' to prevent loops.
     * GPT-5.4: 'required' (forces at least one tool call on turn 1).
     * Claude / GPT-4.x: undefined.
     *
     * IMPORTANT: Do NOT set 'required' when built-in tools (web_search,
     * code_interpreter) are in the tool list — the API rejects mixed types
     * with tool_choice: 'required'.
     */
    toolChoiceFirstTurn?: 'required' | 'auto';

    /**
     * Whether to request strict schema validation for tool calls.
     * GPT-5.4: true.
     */
    strictToolSchemas?: boolean;

    /**
     * Whether to run tool calls in parallel.
     * GPT-5.4: true (default behavior, but explicit is safer).
     */
    parallelToolCalls?: boolean;
  }` |
| `needsToolPersistence` | `boolean` |
| `needsApplyPatchFormat` | `boolean` |
| `needsPreambleGuidance` | `boolean` |
| `guidanceLevel` | `'minimal' | 'standard' | 'verbose'` |

<!-- source: interface-notionexportdto.md -->

# NotionExportDto

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/techdocs-notion-export.service.ts` (line 17)

## Properties

| Property | Type |
|---|---|
| `integrationToken` | `string` |
| `parentPageId` | `string` |
| `scope` | `'technical' | 'user'` |
| `dryRun` | `boolean` |

<!-- source: function-realmplugin.md -->

# realmPlugin

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/RealmWithPlugins.tsx` (line 20)

A function that creates an editor plugin.

## Signature

```ts
function realmPlugin(plugin: {
  /**
   * Called when the MDXEditor component is mounted and the plugin is initialized.
   */
  init?: (realm: Realm, params?: Params) => void

  /**
   * Called after the MDXEditor component is mounted and all plugins are initialized.
   */
  postInit?: (realm: Realm, params?: Params) => void
  /**
   * Called on each re-render. Use this to update the realm with updated property values.
   */
  update?: (realm: Realm, params?: Params) => void
}): (params?: Params) => RealmPlugin
```

## Parameters

| Name | Type |
|---|---|
| `plugin` | `{
  /**
   * Called when the MDXEditor component is mounted and the plugin is initialized.
   */
  init?: (realm: Realm, params?: Params) => void

  /**
   * Called after the MDXEditor component is mounted and all plugins are initialized.
   */
  postInit?: (realm: Realm, params?: Params) => void
  /**
   * Called on each re-render. Use this to update the realm with updated property values.
   */
  update?: (realm: Realm, params?: Params) => void
}` |

**Returns:** `(params?: Params) => RealmPlugin`

<!-- source: class-syncentitiesresponsedto.md -->

# SyncEntitiesResponseDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/graph/dto/sync-entities.dto.ts` (line 120)

Response for bulk entity sync

## Properties

| Property | Type |
|---|---|
| `success` | `number` |
| `failed` | `number` |
| `updated` | `number` |
| `created` | `number` |
| `errors` | `Array<{ entityId: string; error: string }>` |

<!-- source: function-tagoverlap.md -->

# tagOverlap

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/memory/consolidator.ts` (line 214)

Tag overlap ratio: intersection / union.

## Signature

```ts
function tagOverlap(a: string[], b: string[]): number
```

## Parameters

| Name | Type |
|---|---|
| `a` | `string[]` |
| `b` | `string[]` |

**Returns:** `number`

<!-- source: service-techdocsexportservice.md -->

# TechDocsExportService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/techdocs-export.service.ts` (line 70)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `exportToConfluence` | `exportToConfluence(projectId: string, userId: string, dto: ConfluenceExportDto)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `technicaldocsmaterializerservice`

<!-- source: function-usebranding.md -->

# useBranding

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/BrandingContext.tsx` (line 169)

<!-- source: interface-usedocumentationconfigreturn.md -->

# UseDocumentationConfigReturn

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationConfig.ts` (line 106)

Hook return type

## Properties

| Property | Type |
|---|---|
| `config` | `DocumentationConfig | null` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `hasConfig` | `boolean` |
| `localSkeleton` | `SkeletonStructure | null` |
| `isDirty` | `boolean` |
| `loadConfig` | `() => Promise<DocumentationConfig | null>` |
| `createConfig` | `(data: CreateConfigDto) => Promise<DocumentationConfig>` |
| `updateConfig` | `(data: UpdateConfigDto) => Promise<DocumentationConfig>` |
| `deleteConfig` | `() => Promise<void>` |
| `addCategory` | `(category: Omit<SkeletonCategory, 'documents'>) => void` |
| `removeCategory` | `(slug: string) => void` |
| `updateCategory` | `(slug: string, updates: Partial<Omit<SkeletonCategory, 'documents'>>) => void` |
| `addDocument` | `(categorySlug: string, document: SkeletonDocument) => void` |
| `removeDocument` | `(categorySlug: string, documentSlug: string) => void` |
| `updateDocument` | `(categorySlug: string, documentSlug: string, updates: Partial<SkeletonDocument>) => void` |
| `reorderCategories` | `(categoryIds: string[]) => void` |
| `reorderDocuments` | `(categorySlug: string, documentSlugs: string[]) => void` |
| `resetLocalChanges` | `() => void` |
| `saveLocalChanges` | `() => Promise<DocumentationConfig>` |

<!-- source: class-validationerror.md -->

# ValidationError

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/types/errors.ts` (line 30)

Validation error (400 Bad Request)

**Extends:** `APIError`

<!-- source: interface-consistencycheckinput.md -->

# ConsistencyCheckInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-11.types.ts` (line 72)

CrossDocumentConsistencyCheck - Batch review of all documents

After individual document verification, OpenAI reviews all documents
together to catch inconsistencies that wouldn't be visible when
looking at documents in isolation.

## Properties

| Property | Type |
|---|---|
| `documents` | `DocumentSummary[]` |
| `projectContext` | `{
    appName: string;
    primaryAudience: string;
    userRoles: string[];
  }` |

<!-- source: constant-editorwrapperelementref.md -->

# editorWrapperElementRef$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 330)

<!-- source: api-endpoint-exportpdf.md -->

# exportPDF

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 477)

## Endpoint

`GET /doc-versions/:projectId/:versionId/export/pdf`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |
| `format` | query | `string` | - |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-featuresgridcards-2.md -->

# FeaturesGridCards

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/features/features-grid-cards.tsx` (line 22)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `labelKey` | `string` | - | - |
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `features` | `Feature[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FeaturesGridCards_4309208b["FeaturesGridCards"]
    class component_FeaturesGridCards_4309208b rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-span`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `FeatureIcon`
- USES_HOOK → `useTranslation`

<!-- source: function-generatemermaidflowchart.md -->

# generateMermaidFlowchart

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/user-journey-diagram.generator.ts` (line 796)

Generate Mermaid flowchart syntax from a UserJourneyFlow

## Signature

```ts
function generateMermaidFlowchart(flow: UserJourneyFlow): string
```

## Parameters

| Name | Type |
|---|---|
| `flow` | `UserJourneyFlow` |

**Returns:** `string`

<!-- source: component-loadingspinner.md -->

# LoadingSpinner

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/MessageList.tsx` (line 116)

Loading spinner animation

## Diagram

```mermaid
graph TD
    component_LoadingSpinner_5fa13a3["LoadingSpinner"]
    class component_LoadingSpinner_5fa13a3 rootComponent
```

## Referenced By

- `MessageList` (RENDERS)

<!-- source: interface-methodcaller.md -->

# MethodCaller

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 73)

## Properties

| Property | Type |
|---|---|
| `component` | `string` |
| `method` | `string` |

<!-- source: interface-modelcompactorconfig.md -->

# ModelCompactorConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/compaction-types.ts` (line 83)

## Properties

| Property | Type |
|---|---|
| `endpoint` | `string` |
| `apiKey` | `string` |
| `model` | `string` |
| `apiVersion` | `string` |
| `useV1Endpoint` | `boolean` |
| `maxSummaryTokens` | `number` |
| `domainFields` | `string[]` |
| `parallel` | `boolean` |
| `timeout` | `number` |
| `onCompactionComplete` | `(summary: CompactionSummary, durationMs: number) => void` |
| `onCompactionError` | `(error: Error) => void` |

<!-- source: interface-notionrichtext.md -->

# NotionRichText

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/md-to-notion-blocks.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `type` | `'text'` |
| `text` | `{ content: string; link: { url: string } | null }` |
| `annotations` | `{ bold?: boolean; italic?: boolean; code?: boolean }` |

<!-- source: function-renderdocument.md -->

# renderDocument

**Kind:** Function

**Source:** `atloria-monorepo/packages/core/src/rendering/audience-renderer.ts` (line 242)

Convenience function to render a document AST

## Signature

```ts
function renderDocument(ast: DocumentAST, options: RenderOptions): string
```

## Parameters

| Name | Type |
|---|---|
| `ast` | `DocumentAST` |
| `options` | `RenderOptions` |

**Returns:** `string`

<!-- source: class-syncentitydto.md -->

# SyncEntityDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/graph/dto/sync-entities.dto.ts` (line 20)

Entity DTO for bulk sync operations from CLI
Matches the format sent by CLI's ApiProvider

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `type` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `startLine` | `number` |
| `endLine` | `number` |
| `framework` | `string` |
| `metadata` | `Record<string, unknown>` |

<!-- source: service-techdocsnotionexportservice.md -->

# TechDocsNotionExportService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/techdocs-notion-export.service.ts` (line 28)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `exportToNotion` | `exportToNotion(projectId: string, userId: string, dto: NotionExportDto)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `technicaldocsmaterializerservice`

<!-- source: function-titlesimilarity.md -->

# titleSimilarity

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/memory/consolidator.ts` (line 196)

Simple title similarity using normalized Levenshtein-like comparison.
For our use case (short titles < 80 chars), word overlap is sufficient.

## Signature

```ts
function titleSimilarity(a: string, b: string): number
```

## Parameters

| Name | Type |
|---|---|
| `a` | `string` |
| `b` | `string` |

**Returns:** `number`

<!-- source: function-usecollaboration.md -->

# useCollaboration

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useCollaboration.ts` (line 138)

Hook for real-time document collaboration using Yjs

## Signature

```ts
function useCollaboration(documentId: string | null | undefined, userId: string | null | undefined, userName: string | null | undefined, options: UseCollaborationOptions): UseCollaborationReturn
```

## Parameters

| Name | Type |
|---|---|
| `documentId` | `string | null | undefined` |
| `userId` | `string | null | undefined` |
| `userName` | `string | null | undefined` |
| `options` | `UseCollaborationOptions` |

**Returns:** `UseCollaborationReturn`

<!-- source: interface-usedocumentationgeneratoroptions.md -->

# UseDocumentationGeneratorOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationGenerator.ts` (line 50)

Hook options

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `apiUrl` | `string` |
| `getToken` | `() => string | null` |

<!-- source: class-verificationerror.md -->

# VerificationError

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/errors.ts` (line 177)

Error thrown when verification fails below threshold

**Extends:** `PipelineError`

## Properties

| Property | Type |
|---|---|
| `accuracyScore` | `number` |
| `threshold` | `number` |
| `documentId` | `string` |

<!-- source: interface-consistencycorrection.md -->

# ConsistencyCorrection

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-11.types.ts` (line 107)

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `original` | `string` |
| `corrected` | `string` |
| `reason` | `string` |
| `autoApplied` | `boolean` |

<!-- source: constant-editorwrappers.md -->

# editorWrappers$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 758)

<!-- source: api-endpoint-extractentities.md -->

# extractEntities

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/graph.controller.ts` (line 113)

## Endpoint

`POST /knowledge-graph/document/:id/extract`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `GraphController` (MODULE_DECLARES)

<!-- source: component-featureshorizontalflow-2.md -->

# FeaturesHorizontalFlow

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/features/features-horizontal-flow.tsx` (line 25)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `features` | `Feature[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FeaturesHorizontalFlow_87b510d["FeaturesHorizontalFlow"]
    class component_FeaturesHorizontalFlow_87b510d rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: function-generatemodelschemadiagram.md -->

# generateModelSchemaDiagram

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/database-schema-diagram.generator.ts` (line 333)

Generate schema diagram for a single model and its direct relations

## Signature

```ts
function generateModelSchemaDiagram(model: DatabaseModelEntity, allModels: DatabaseModelEntity[], options: DatabaseSchemaDiagramOptions): DatabaseSchemaDiagramResult
```

## Parameters

| Name | Type |
|---|---|
| `model` | `DatabaseModelEntity` |
| `allModels` | `DatabaseModelEntity[]` |
| `options` | `DatabaseSchemaDiagramOptions` |

**Returns:** `DatabaseSchemaDiagramResult`

<!-- source: component-manualpanel.md -->

# ManualPanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/page.tsx` (line 257)

## Diagram

```mermaid
graph TD
    component_ManualPanel_41e3c52c["ManualPanel"]
    class component_ManualPanel_41e3c52c rootComponent
```

## Relationships

- RENDERS → `PreviewShell`

## Referenced By

- `HomePage` (RENDERS)

<!-- source: interface-methoddefinition-2.md -->

# MethodDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 850)

Method definition

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `returnType` | `string` |
| `parameters` | `ParameterDefinition[]` |
| `isAsync` | `boolean` |
| `description` | `string` |
| `decorators` | `string[]` |

<!-- source: interface-modelproviderrequest.md -->

# ModelProviderRequest

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-provider-interface.ts` (line 37)

Request to the model provider.

## Properties

| Property | Type |
|---|---|
| `systemInstructions` | `string` |
| `input` | `ModelInputItem[]` |
| `tools` | `ToolSchema[]` |
| `modelSettings` | `AgentModelSettings` |
| `previousResponseId` | `string` |
| `signal` | `AbortSignal` |

<!-- source: interface-parameter.md -->

# Parameter

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/parser/interfaces/code-parser.interface.ts` (line 63)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `optional` | `boolean` |
| `defaultValue` | `string` |

<!-- source: function-rendermarkdowntohtml.md -->

# renderMarkdownToHtml

**Kind:** Function

**Source:** `atloria-monorepo/packages/markdown-engine/src/lib/render.ts` (line 55)

Render a Markdown string to an HTML fragment (no <html>/<body> wrapper).
Returns an empty string for empty input.

## Signature

```ts
async function renderMarkdownToHtml(markdown: string): Promise<string>
```

## Parameters

| Name | Type |
|---|---|
| `markdown` | `string` |

**Returns:** `Promise<string>`

<!-- source: class-syncjobdto.md -->

# SyncJobDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/sync-job.dto.ts` (line 51)

Sync job response DTO

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `status` | `SyncJobStatus` |
| `scope` | `SyncJobScope` |
| `organizationId` | `string` |
| `projectId` | `string` |
| `progress` | `SyncJobProgress` |
| `startedAt` | `Date` |
| `completedAt` | `Date` |
| `error` | `string` |
| `initiatedBy` | `string` |

<!-- source: service-techdocsragservice.md -->

# TechDocsRagService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/rag/techdocs-rag.service.ts` (line 38)

Grounded codebase chat (GraphRAG) over the technical docs.

 index(projectId): embed each published page → upsert as (:TechChunk) with its vector in Neo4j,
 backed by a native vector index.
 ask(projectId, q): embed the question → Neo4j vector search (scoped to the project) → feed the
 top hits to gpt-5.x with citation-forced grounding → return an answer + validated citations
 (invented references are dropped by validateCitations).

The same ask() backs both the web "ask about this codebase" endpoint and the MCP ask_question tool.

`TechDocsRagService` provides grounded, citation-backed Q&A over a project’s published technical documentation using a GraphRAG-style pipeline. It indexes docs by embedding each published page into vectorized `(:TechChunk)` nodes in Neo4j (with a native vector index), then answers questions by running scoped vector search and prompting `gpt-5.x` with strict citation grounding. It powers both the web “ask about this codebase” endpoint and the MCP `ask_question` tool, dropping any invented references via `validateCitations`.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `index` | `index(projectId: string)` | `Promise<{ indexed: number; embeddingTokens: number }>` |
| `retrieve` | `retrieve(projectId: string, question: string, k: unknown, docTypes: Array<'technical' | 'user_manual' | 'external'>)` | `Promise<DocSearchHit[]>` |
| `purgePath` | `purgePath(projectId: string, pathPrefix: string)` | `Promise<void>` |
| `purgeProject` | `purgeProject(projectId: string)` | `Promise<void>` |
| `askFn` | `askFn(projectId: string)` | `AskFn` |
| `ask` | `ask(projectId: string, question: string)` | `Promise<{
    answer: string;
    citations: string[];
    sources: DocSearchHit[];
    usage: { inputTokens: number; outputTokens: number; totalTokens: number };
  }>` |
| `assistPage` | `assistPage(projectId: string, currentMarkdown: string, instruction: string, pageTitle: unknown)` | `Promise<{
    content: string;
    citations: string[];
    sources: DocSearchHit[];
    usage: { inputTokens: number; outputTokens: number; totalTokens: number };
  }>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  actor User
  participant API as API Endpoint / MCP Tool
  participant Svc as TechDocsRagService
  participant Embed as Embeddings Provider
  participant Neo4j as Neo4j (Vector Index)
  participant LLM as gpt-5.x
  participant Val as validateCitations

  rect rgb(245,245,245)
    note over Svc,Neo4j: Indexing: index(projectId)
    Svc->>API: index(projectId) triggered
    Svc->>Embed: Embed each published page
    Embed-->>Svc: Page vectors
    Svc->>Neo4j: Upsert (:TechChunk) + vector<br/>scoped to projectId
    Neo4j-->>Svc: Indexed
  end

  rect rgb(245,245,245)
    note over User,Val: Q&A: ask(projectId, q)
    User->>API: Ask question (q)
    API->>Svc: ask(projectId, q)
    Svc->>Embed: Embed question
    Embed-->>Svc: Question vector
    Svc->>Neo4j: Vector search (projectId scope)
    Neo4j-->>Svc: Top-k matching chunks (+ metadata)
    Svc->>LLM: Prompt with chunks + citation-forced grounding
    LLM-->>Svc: Draft answer + citations
    Svc->>Val: Validate citations (drop invented refs)
    Val-->>Svc: Answer + validated citations
    Svc-->>API: Response
    API-->>User: Grounded answer
  end
```

## Usage

```ts
// NestJS-style usage (e.g., in a controller or another service)
import { Controller, Post, Param, Body } from '@nestjs/common';
import { TechDocsRagService } from './technical-docs/rag/techdocs-rag.service';

@Controller('projects/:projectId/techdocs')
export class TechDocsController {
  constructor(private readonly techDocsRag: TechDocsRagService) {}

  @Post('index')
  async index(@Param('projectId') projectId: string) {
    // Embeds each published page and upserts (:TechChunk) with vectors into Neo4j
    await this.techDocsRag.index(projectId);
    return { ok: true };
  }

  @Post('ask')
  async ask(
    @Param('projectId') projectId: string,
    @Body() body: { q: string },
  ) {
    // Vector-searches within the project scope and returns an answer + validated citations
    const result = await this.techDocsRag.ask(projectId, body.q);
    return result; // typically: { answer: string, citations: [...] }
  }
}
```

## AI Coding Instructions

- Keep `ask(projectId, q)` strictly grounded: only feed Neo4j-retrieved chunks to the model and run `validateCitations` to drop any invented references.
- Always scope retrieval and indexing by `projectId` (both Neo4j upserts and vector searches) to prevent cross-project leakage.
- Treat `index(projectId)` as idempotent: upsert `(:TechChunk)` deterministically so re-indexing doesn’t duplicate or drift.
- When modifying prompts or chunk metadata, preserve the citation contract (stable identifiers/URLs/anchors) so validation can reliably match citations to retrieved chunks.
- Watch for embedding/vector index mismatches (dimension/model changes): ensure Neo4j vector index configuration stays aligned with the embedding provider used by both `index` and `ask`.

## Relationships

- DEPENDS_ON → `neo4jservice`
- DEPENDS_ON → `embeddingsservice`
- DEPENDS_ON → `ragchatmodelservice`
- DEPENDS_ON → `technicaldocsmaterializerservice`

<!-- source: function-tokenize-2.md -->

# tokenize

**Kind:** Function

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/bm25.ts` (line 19)

BM25 (Okapi BM25) — Inline Implementation

Standard BM25 ranking with k1=1.2, b=0.75.
Zero external dependencies — pure TypeScript.

## Signature

```ts
function tokenize(text: string): string[]
```

## Parameters

| Name | Type |
|---|---|
| `text` | `string` |

**Returns:** `string[]`

<!-- source: function-usecurrentprojectid.md -->

# useCurrentProjectId

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/stores/projectContext.ts` (line 198)

Hook to get current project ID (useful for API calls)

## Signature

```ts
function useCurrentProjectId(): string | null
```

**Returns:** `string | null`

<!-- source: interface-usedocumentationgeneratorreturn.md -->

# UseDocumentationGeneratorReturn

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationGenerator.ts` (line 59)

Hook return type

## Properties

| Property | Type |
|---|---|
| `job` | `DocumentationJob | null` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `progress` | `number` |
| `currentStage` | `string | null` |
| `stageProgress` | `number` |
| `currentItem` | `string | null` |
| `elapsedMs` | `number` |
| `estimatedRemainingMs` | `number` |
| `isRunning` | `boolean` |
| `isCompleted` | `boolean` |
| `isFailed` | `boolean` |
| `isCancelled` | `boolean` |
| `result` | `JobResult | null` |
| `screenshotProgress` | `{
    batchIndex: number;
    totalBatches: number;
    captured: number;
    totalMappings: number;
  } | null` |
| `startGeneration` | `(options?: { includeScreenshots?: boolean }) => Promise<DocumentationJob>` |
| `cancel` | `() => Promise<void>` |
| `reset` | `() => void` |

<!-- source: class-vuedetector.md -->

# VueDetector

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/vue-detector.ts` (line 55)

Vue Detector

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detect` | `detect(entities: Entity[])` | `DetectedVueComponent[]` |
| `getComponentSummary` | `getComponentSummary(component: DetectedVueComponent)` | `string` |

<!-- source: interface-consistencyissue.md -->

# ConsistencyIssue

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-11.types.ts` (line 99)

## Properties

| Property | Type |
|---|---|
| `type` | `'terminology' | 'role' | 'navigation' | 'contradiction'` |
| `severity` | `'critical' | 'major' | 'minor'` |
| `description` | `string` |
| `affectedDocuments` | `string[]` |
| `examples` | `string[]` |

<!-- source: constant-exportvisitors.md -->

# exportVisitors$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 289)

Contains the currently registered export visitors.

<!-- source: component-featuresinteractivetabs-2.md -->

# FeaturesInteractiveTabs

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/features/features-interactive-tabs.tsx` (line 35)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `tabs` | `Tab[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FeaturesInteractiveTabs_4a709f55["FeaturesInteractiveTabs"]
    class component_FeaturesInteractiveTabs_4a709f55 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `Icon`
- RENDERS → `motion-span`
- RENDERS → `AnimatePresence`
- USES_HOOK → `useTranslation`
- USES_HOOK → `useState`

<!-- source: api-endpoint-feedback.md -->

# feedback

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-chat.controller.ts` (line 142)

## Endpoint

`POST /technical-docs/:projectId/chat/messages/:messageId/feedback`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `messageId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsChatController` (MODULE_DECLARES)

<!-- source: function-generaterelationshipid-3.md -->

# generateRelationshipId

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 623)

Generate a relationship ID

## Signature

```ts
function generateRelationshipId(sourceId: string, targetId: string, type: string): string
```

## Parameters

| Name | Type |
|---|---|
| `sourceId` | `string` |
| `targetId` | `string` |
| `type` | `string` |

**Returns:** `string`

<!-- source: component-menuitem.md -->

# MenuItem

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/boards/page.tsx` (line 430)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |
| `icon` | `unknown` | ✓ | - |
| `onClick` | `Function` | ✓ | - |
| `danger` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_MenuItem_70ac4127["MenuItem"]
    class component_MenuItem_70ac4127 rootComponent
```

## Referenced By

- `BoardListCard` (RENDERS)

<!-- source: interface-modaldefinition.md -->

# ModalDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/modal-extractor.ts` (line 28)

A modal/popup/dialog discovered in source code.
Compatible with ModalDefinition from interaction-map.types.ts.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `title` | `string` |
| `triggerType` | `ModalTriggerType` |
| `triggerSelector` | `string` |
| `triggerMethod` | `string` |
| `closeMethod` | `ModalCloseMethod` |
| `closeButtonTexts` | `string[]` |
| `conditionalOn` | `string` |
| `hostComponent` | `string` |
| `sourceFile` | `string` |
| `line` | `number` |

<!-- source: interface-modelproviderresponse.md -->

# ModelProviderResponse

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-provider-interface.ts` (line 73)

Response from the model provider.

## Properties

| Property | Type |
|---|---|
| `output` | `ModelResponseItem[]` |
| `usage` | `{ inputTokens: number; outputTokens: number }` |
| `responseId` | `string` |
| `providerData` | `unknown` |

<!-- source: interface-parseddocumenturl-2.md -->

# ParsedDocumentUrl

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/services/url.service.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `slug` | `string` |
| `urlId` | `string` |
| `audience` | `string` |

<!-- source: function-resetglobalratelimiter.md -->

# resetGlobalRateLimiter

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/rate-limiter.ts` (line 183)

Reset the global rate limiter (useful for testing)

## Signature

```ts
function resetGlobalRateLimiter(): void
```

**Returns:** `void`

<!-- source: class-syncjobprogress.md -->

# SyncJobProgress

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/sync-job.dto.ts` (line 25)

Sync job progress information

## Properties

| Property | Type |
|---|---|
| `total` | `number` |
| `processed` | `number` |
| `succeeded` | `number` |
| `failed` | `number` |
| `skipped` | `number` |
| `percentage` | `number` |
| `currentDocument` | `string` |

<!-- source: service-techdocssourcesservice.md -->

# TechDocsSourcesService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/techdocs-sources.service.ts` (line 50)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `importUrl` | `importUrl(projectId: string, userId: string, rawUrl: string)` | `unknown` |
| `importPdf` | `importPdf(projectId: string, userId: string, buffer: Buffer, filename: string)` | `unknown` |
| `importZendesk` | `importZendesk(projectId: string, userId: string, dto: { subdomain?: string; email?: string; apiToken?: string; max?: number })` | `unknown` |
| `importIntercom` | `importIntercom(projectId: string, userId: string, dto: { accessToken?: string; max?: number })` | `unknown` |
| `pullZendesk` | `pullZendesk(config: { subdomain?: string; email?: string; apiToken?: string; max?: number }, since: string, max: unknown)` | `Promise<TicketItem[]>` |
| `pullIntercom` | `pullIntercom(config: { accessToken?: string; max?: number }, since: string, max: unknown)` | `Promise<TicketItem[]>` |
| `ingestTickets` | `ingestTickets(projectId: string, organizationId: string, userId: string, provider: 'zendesk' | 'intercom', tickets: TicketItem[], connectorId: string)` | `unknown` |
| `list` | `list(projectId: string, userId: string)` | `unknown` |
| `remove` | `remove(projectId: string, userId: string, documentId: string)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `technicaldocsqueue`
- DEPENDS_ON → `techdocsragservice`

<!-- source: function-usecurrentversionid.md -->

# useCurrentVersionId

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/stores/versionContext.ts` (line 98)

Helper: get just the current version ID

<!-- source: interface-usedocumentationjobsoptions.md -->

# UseDocumentationJobsOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationJobs.ts` (line 41)

Hook options

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `limit` | `number` |
| `apiUrl` | `string` |
| `getToken` | `() => string | null` |
| `autoLoad` | `boolean` |

<!-- source: class-websocketclient.md -->

# WebSocketClient

**Kind:** Class

**Source:** `atloria-monorepo/packages/api-client/src/clients/WebSocketClient.ts` (line 66)

WebSocket client for real-time updates

## Methods

| Method | Signature | Returns |
|---|---|---|
| `connect` | `connect(url: string, token: string)` | `void` |
| `disconnect` | `disconnect()` | `void` |
| `subscribe` | `subscribe(channel: string, callback: (data: unknown) => void)` | `() => void` |
| `unsubscribe` | `unsubscribe(channel: string, callback: (data: unknown) => void)` | `void` |
| `send` | `send(channel: string, data: unknown)` | `void` |
| `getState` | `getState()` | `WebSocketState` |
| `isConnected` | `isConnected()` | `boolean` |

<!-- source: interface-consistencyreport.md -->

# ConsistencyReport

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-11.types.ts` (line 92)

## Properties

| Property | Type |
|---|---|
| `overallScore` | `number` |
| `issues` | `ConsistencyIssue[]` |
| `corrections` | `ConsistencyCorrection[]` |
| `glossary` | `TermDefinition[]` |

<!-- source: constant-fadein.md -->

# fadeIn

**Kind:** Constant

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/animations.ts` (line 21)

Simple opacity fade

## Definition

```ts
Variants
```

<!-- source: api-endpoint-finalizepage.md -->

# finalizePage

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/pme/pme.controller.ts` (line 109)

## Endpoint

`POST /pme/finalize`

## Referenced By

- `PmeController` (MODULE_DECLARES)

<!-- source: component-focusempty.md -->

# FocusEmpty

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 90)

## Diagram

```mermaid
graph TD
    component_FocusEmpty_396e6a1f["FocusEmpty"]
    class component_FocusEmpty_396e6a1f rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useRef`

<!-- source: function-generateschemacss.md -->

# generateSchemaCSS

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/database-schema-diagram.generator.ts` (line 366)

Generate CSS for database schema diagram styling

## Signature

```ts
function generateSchemaCSS(): string
```

**Returns:** `string`

<!-- source: component-messagebody.md -->

# MessageBody

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/ThreadView.tsx` (line 60)

Message bodies are MARKDOWN (agents format replies; the tracking page renders the same). `invert` flips prose colors for the dark agent bubble.

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `body` | `string` | ✓ | - |
| `invert` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_MessageBody_21b87892["MessageBody"]
    class component_MessageBody_21b87892 rootComponent
```

## Relationships

- RENDERS → `ReactMarkdown`

## Referenced By

- `ThreadView` (RENDERS)

<!-- source: interface-modaltrigger.md -->

# ModalTrigger

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/template-analysis.interface.ts` (line 186)

Modal/dialog trigger

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `action` | `string` |
| `modalRef` | `string` |
| `line` | `number` |
| `conditionalOn` | `string` |

<!-- source: interface-modelroute.md -->

# ModelRoute

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-router.ts` (line 45)

A single route entry: maps a category to a model deployment name.

## Properties

| Property | Type |
|---|---|
| `model` | `string` |

<!-- source: interface-parsedrepourl.md -->

# ParsedRepoUrl

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/parsing/git-clone.service.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `provider` | `RepositoryProvider` |
| `owner` | `string` |
| `repo` | `string` |
| `organization` | `string` |
| `project` | `string` |

<!-- source: function-scorestructure.md -->

# scoreStructure

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/structure-scorer.ts` (line 65)

## Signature

```ts
function scoreStructure(content: string, docType: DocType, options: ScoringOptions): StructureScore
```

## Parameters

| Name | Type |
|---|---|
| `content` | `string` |
| `docType` | `DocType` |
| `options` | `ScoringOptions` |

**Returns:** `StructureScore`

<!-- source: class-syncrelationshipdto.md -->

# SyncRelationshipDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/graph/dto/sync-relationships.dto.ts` (line 17)

Relationship DTO for bulk sync operations from CLI
Matches the format sent by CLI's ApiProvider

## Properties

| Property | Type |
|---|---|
| `sourceId` | `string` |
| `targetId` | `string` |
| `type` | `string` |
| `metadata` | `Record<string, unknown>` |

<!-- source: service-technicaldocsenrichmentservice.md -->

# TechnicalDocsEnrichmentService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-enrichment.service.ts` (line 28)

Enriches parsed entities with AI-generated documentation:
- Description (if entity has no JSDoc / thin metadata)
- Mermaid diagram (sequence for services, ER for models, component hierarchy)
- Usage example
- AI coding instructions (Cursor / Claude Code style)

Each enrichment is stored as a Document record:
  source: 'AI', type: 'AI_ENRICHMENT', kgEntityId: entity.id

Enrichments survive re-parses — upsert is keyed by deterministic Document.id.
Runs async/non-blocking from TechnicalDocsParserService after snapshot is saved.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `enrichProject` | `enrichProject(projectId: string, organizationId: string, userId: string, limit: number)` | `Promise<{ entities: number; enriched: number }>` |
| `enrichSnapshot` | `enrichSnapshot(projectId: string, organizationId: string, entities: Entity[], userId: string, limit: number, relationships: Relationship[])` | `Promise<number>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `aiprovider`
- DEPENDS_ON → `aiusageservice`

<!-- source: function-usedoccontext.md -->

# useDocContext

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/doc/[...segments]/doc-context.tsx` (line 222)

<!-- source: interface-usedocumentationjobsreturn.md -->

# UseDocumentationJobsReturn

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationJobs.ts` (line 52)

Hook return type

## Properties

| Property | Type |
|---|---|
| `jobs` | `DocumentationJobEntry[]` |
| `total` | `number` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `liveProgress` | `Record<string, LiveJobProgress>` |
| `refresh` | `() => Promise<void>` |
| `startRegeneration` | `(projectId: string) => Promise<DocumentationJob>` |
| `cancelJob` | `(jobId: string) => Promise<void>` |
| `deleteJobDocuments` | `(jobId: string) => Promise<void>` |

<!-- source: class-welcomegenerator.md -->

# WelcomeGenerator

**Kind:** Class

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-14-meta/generators/welcome.generator.ts` (line 23)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generate` | `generate(input: MetaDocumentationInput, templates: FixedDocTemplate[], reference: MetaCategoryReference)` | `Promise<{
    documents: GeneratedDocument[];
    promptTokens: number;
    completionTokens: number;
  }>` |

<!-- source: interface-contextrequest.md -->

# ContextRequest

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-04-analysis/iterative-deep-loader.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `type` | `'entity' | 'file' | 'dependency' | 'related'` |
| `identifier` | `string` |
| `reason` | `string` |

<!-- source: constant-fadeup.md -->

# fadeUp

**Kind:** Constant

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/animations.ts` (line 11)

Fade in from below — default for most sections

## Definition

```ts
Variants
```

<!-- source: api-endpoint-findpath.md -->

# findPath

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/graph.controller.ts` (line 89)

## Endpoint

`GET /knowledge-graph/path`

| Parameter | In | Type | Required |
|---|---|---|---|
| `from` | query | `string` | ✓ |
| `to` | query | `string` | ✓ |

## Referenced By

- `GraphController` (MODULE_DECLARES)

<!-- source: component-footer.md -->

# Footer

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/layout/footer.tsx` (line 29)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `brandName` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `linkGroups` | `FooterLinkGroup[]` | ✓ | - |
| `socialLinks` | `SocialLink[]` | - | [] |
| `legalLinks` | `unknown[]` | - | [] |

## Diagram

```mermaid
graph TD
    component_Footer_1b0f62e8["Footer"]
    class component_Footer_1b0f62e8 rootComponent
```

## Relationships

- USES_HOOK → `useTranslation`

<!-- source: function-generatescreenshotinstructions.md -->

# generateScreenshotInstructions

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/screenshot-instruction-generator.ts` (line 176)

Generate screenshot instructions from coverage report

## Signature

```ts
function generateScreenshotInstructions(entities: Entity[], existingScreenshots: EnhancedScreenshotMetadata[], options: {
    baseUrl?: string;
    includeWorkflows?: boolean;
  }): ScreenshotPlan
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `Entity[]` |
| `existingScreenshots` | `EnhancedScreenshotMetadata[]` |
| `options` | `{
    baseUrl?: string;
    includeWorkflows?: boolean;
  }` |

**Returns:** `ScreenshotPlan`

<!-- source: component-methodstable.md -->

# MethodsTable

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/entity/[entityId]/page.tsx` (line 98)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `methods` | `any[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_MethodsTable_19c91718["MethodsTable"]
    class component_MethodsTable_19c91718 rootComponent
```

## Relationships

- RENDERS → `Code`

## Referenced By

- `EntityDetailPage` (RENDERS)

<!-- source: interface-modelroutingtable.md -->

# ModelRoutingTable

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-router.ts` (line 54)

Full routing configuration.
Pass to CLI via --routing-table or API via payload.routingTable.

## Properties

| Property | Type |
|---|---|
| `default` | `string` |
| `routes` | `Partial<Record<TaskCategory, ModelRoute>>` |

<!-- source: interface-moduleentity-2.md -->

# ModuleEntity

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 895)

Module entity (NestJS, Angular)

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.MODULE` |
| `imports` | `string[]` |
| `controllers` | `string[]` |
| `providers` | `string[]` |
| `exports` | `string[]` |
| `isGlobal` | `boolean` |

<!-- source: interface-parseerror-2.md -->

# ParseError

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/parser/interfaces/code-parser.interface.ts` (line 70)

## Properties

| Property | Type |
|---|---|
| `message` | `string` |
| `line` | `number` |
| `column` | `number` |
| `severity` | `'error' | 'warning'` |

<!-- source: function-scrolltosection.md -->

# scrollToSection

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useActiveSection.ts` (line 112)

Scroll to a section smoothly

## Signature

```ts
function scrollToSection(id: string, offset: number): void
```

## Parameters

| Name | Type |
|---|---|
| `id` | `string` |
| `offset` | `number` |

**Returns:** `void`

<!-- source: class-syncrelationshipsdto.md -->

# SyncRelationshipsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/graph/dto/sync-relationships.dto.ts` (line 42)

Request body for bulk relationship sync

## Properties

| Property | Type |
|---|---|
| `relationships` | `SyncRelationshipDto[]` |

<!-- source: service-technicaldocsgenerationservice.md -->

# TechnicalDocsGenerationService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-generation.service.ts` (line 36)

The technical-docs generation UNIT OF WORK (clone → parse → snapshot → materialize).

Extracted from the controller so it runs OFF the API request path: a queue worker (its own
deployment, sized for parsing) calls process(), not the api pod. This is what keeps a large-
repo parse — which can consume several GB — from OOM-ing the pod that serves users. The method
is self-contained and records progress/outcome on the DocumentationJob so it never throws into
the worker; the worker just needs to run it.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `process` | `process(jobId: string | null, options: TechnicalDocsJobPayload)` | `Promise<boolean>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `technicaldocsparserservice`
- DEPENDS_ON → `technicaldocsmaterializerservice`
- DEPENDS_ON → `technicaldocsservice`
- DEPENDS_ON → `opsalertservice`
- DEPENDS_ON → `aiusageservice`
- DEPENDS_ON → `notificationservice`
- DEPENDS_ON → `emailservice`

<!-- source: function-usedocumentationconfig.md -->

# useDocumentationConfig

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationConfig.ts` (line 137)

Custom hook for documentation configuration

Manages auto-doc configuration for projects including:
- Loading/Creating/Updating/Deleting config
- Local skeleton structure editing
- Dirty state tracking

## Signature

```ts
function useDocumentationConfig(options: UseDocumentationConfigOptions): UseDocumentationConfigReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseDocumentationConfigOptions` |

**Returns:** `UseDocumentationConfigReturn`

<!-- source: interface-useimageuploadreturn.md -->

# UseImageUploadReturn

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useImageUpload.ts` (line 26)

## Properties

| Property | Type |
|---|---|
| `uploadImage` | `(file: File, options?: Omit<UploadImageOptions, 'file'>) => Promise<string>` |
| `uploading` | `boolean` |
| `error` | `Error | null` |
| `progress` | `number` |

<!-- source: interface-contextresolverconfig.md -->

# ContextResolverConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/context-resolver.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `maxDeepLoadIterations` | `number` |
| `maxTokensForCrossChunk` | `number` |
| `charsPerToken` | `number` |

<!-- source: constant-fixed-doc-templates.md -->

# FIXED_DOC_TEMPLATES

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 241)

Fixed doc templates per category. Each defines a doc to generate.
No AI decides WHAT to generate -- only the CONTENT is AI-generated.

## Definition

```ts
FixedDocTemplate[]
```

<!-- source: api-endpoint-forgotpassword.md -->

# forgotPassword

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/auth.controller.ts` (line 93)

## Endpoint

`POST /auth/forgot-password`

## Referenced By

- `AuthController` (MODULE_DECLARES)

<!-- source: component-frontmatter.md -->

# Frontmatter

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 265)

## Diagram

```mermaid
graph TD
    component_Frontmatter_65c8f0a0["Frontmatter"]
    class component_Frontmatter_65c8f0a0 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `InsertFrontmatter`

<!-- source: function-generatesequencecss.md -->

# generateSequenceCSS

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/sequence-diagram.generator.ts` (line 477)

Generate CSS for sequence diagram styling

## Signature

```ts
function generateSequenceCSS(): string
```

**Returns:** `string`

<!-- source: component-methodstable-2.md -->

# MethodsTable

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/technical/entity/[entityId]/page.tsx` (line 56)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `methods` | `any[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_MethodsTable_7b993f6b["MethodsTable"]
    class component_MethodsTable_7b993f6b rootComponent
```

## Relationships

- RENDERS → `Code`

## Referenced By

- `PublicEntityDetailPage` (RENDERS)

<!-- source: interface-modeltoolcall.md -->

# ModelToolCall

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-provider-interface.ts` (line 64)

Tool call from the model's response.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `arguments` | `string` |

<!-- source: interface-networkzone.md -->

# NetworkZone

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/deployment-diagram.generator.ts` (line 80)

Network/subnet grouping

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `type` | `'public' | 'private' | 'dmz' | 'internal'` |
| `nodeIds` | `string[]` |

<!-- source: interface-parsejobdata.md -->

# ParseJobData

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/parsing/parsing.queue.ts` (line 11)

## Properties

| Property | Type |
|---|---|
| `jobId` | `string` |
| `projectId` | `string` |
| `repositoryUrl` | `string` |
| `branch` | `string` |
| `provider` | `RepositoryProvider` |
| `credentials` | `{
    username?: string;
    password?: string;
  }` |
| `options` | `{
    include?: string[];
    exclude?: string[];
    frameworks?: string[];
    screenshots?: boolean;
  }` |
| `autoSync` | `boolean` |

<!-- source: function-setanalyticsconsent.md -->

# setAnalyticsConsent

**Kind:** Function

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/analytics.ts` (line 31)

Set cookie consent status. Analytics won't fire until consent is true.

## Signature

```ts
function setAnalyticsConsent(consent: boolean)
```

## Parameters

| Name | Type |
|---|---|
| `consent` | `boolean` |

<!-- source: class-syncrelationshipsresponsedto.md -->

# SyncRelationshipsResponseDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/graph/dto/sync-relationships.dto.ts` (line 58)

Response for bulk relationship sync

## Properties

| Property | Type |
|---|---|
| `success` | `number` |
| `failed` | `number` |
| `updated` | `number` |
| `created` | `number` |
| `errors` | `Array<{ relationshipId: string; error: string }>` |

<!-- source: service-technicaldocsmaterializerservice.md -->

# TechnicalDocsMaterializerService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-materializer.service.ts` (line 394)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `materialize` | `materialize(projectId: string, organizationId: string, createdById: string)` | `Promise<MaterializeResult>` |
| `buildRagCorpus` | `buildRagCorpus(projectId: string)` | `Promise<{
    projectName: string;
    organizationId: string;
    pages: Array<LlmsPage & { docType: 'technical' | 'user_manual' | 'external'; entityId?: string | null }>;
  } | null>` |
| `getStaticSearchIndex` | `getStaticSearchIndex(projectId: string, slugWithId: string)` | `Promise<StaticSearchIndex | null>` |
| `buildMcpCorpus` | `buildMcpCorpus(projectId: string)` | `Promise<DocsCorpus | null>` |
| `getLlmsTxt` | `getLlmsTxt(projectId: string)` | `Promise<string | null>` |
| `getLlmsFullTxt` | `getLlmsFullTxt(projectId: string)` | `Promise<string | null>` |
| `getPublicLlmsTxt` | `getPublicLlmsTxt(projectId: string)` | `Promise<string | null>` |
| `getPublicLlmsFullTxt` | `getPublicLlmsFullTxt(projectId: string)` | `Promise<string | null>` |
| `buildPublicMcpCorpus` | `buildPublicMcpCorpus(projectId: string)` | `Promise<DocsCorpus | null>` |
| `getPublicPageMarkdown` | `getPublicPageMarkdown(projectId: string, slug: string)` | `Promise<string | null>` |
| `getPageMarkdown` | `getPageMarkdown(projectId: string, slug: string)` | `Promise<string | null>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `docversionservice`

<!-- source: function-usedocumentationgenerator.md -->

# useDocumentationGenerator

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationGenerator.ts` (line 94)

Custom hook for documentation generation

Manages the lifecycle of documentation generation jobs including:
- Starting new jobs
- Real-time progress updates via WebSocket
- Cancellation
- Error handling

## Signature

```ts
function useDocumentationGenerator(options: UseDocumentationGeneratorOptions): UseDocumentationGeneratorReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseDocumentationGeneratorOptions` |

**Returns:** `UseDocumentationGeneratorReturn`

<!-- source: interface-useofflinesyncoptions.md -->

# UseOfflineSyncOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useOfflineSync.ts` (line 29)

Options for the useOfflineSync hook

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `userId` | `string` |
| `onSync` | `(updates: PendingUpdate[]) => Promise<void>` |
| `maxAge` | `number` |
| `autoSync` | `boolean` |

<!-- source: interface-contextsource.md -->

# ContextSource

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/services/business-context-extractor.ts` (line 17)

A source of business context

## Properties

| Property | Type |
|---|---|
| `type` | `'pdf' | 'url' | 'file' | 'text'` |
| `path` | `string` |
| `content` | `string` |

<!-- source: constant-fixed-meta-categories.md -->

# FIXED_META_CATEGORIES

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 161)

Fixed top-level categories. These never change across runs.
Order determines navigation order in the final docs portal.

<!-- source: api-endpoint-freshness.md -->

# freshness

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/manuals-insights/manuals-insights.controller.ts` (line 68)

PUBLIC — powers the reader-facing freshness badge. No guard by design.

## Endpoint

`GET /manuals-insights/:projectId/freshness`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `slug` | query | `string` | ✓ |

## Referenced By

- `ManualsInsightsController` (MODULE_DECLARES)

<!-- source: component-frontmattereditor.md -->

# FrontmatterEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/frontmatter/FrontmatterEditor.tsx` (line 18)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `yaml` | `string` | ✓ | - |
| `onChange` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FrontmatterEditor_3f108175["FrontmatterEditor"]
    class component_FrontmatterEditor_3f108175 rootComponent
```

## Relationships

- RENDERS → `Dialog-Root`
- RENDERS → `Dialog-Portal`
- RENDERS → `Dialog-Overlay`
- RENDERS → `Dialog-Content`
- RENDERS → `Dialog-Title`
- RENDERS → `TableInput`
- RENDERS → `Dialog-Close`
- USES_HOOK → `useCellValues`
- USES_HOOK → `useTranslation`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useMemo`
- USES_HOOK → `useForm`
- USES_HOOK → `useFieldArray`
- USES_HOOK → `useCallback`

<!-- source: function-generatesequencediagram.md -->

# generateSequenceDiagram

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/sequence-diagram.generator.ts` (line 437)

Generate sequence diagram for an API endpoint or function

## Signature

```ts
function generateSequenceDiagram(entity: Entity, allEntities: Entity[], allRelationships: Relationship[], options: SequenceDiagramOptions): SequenceDiagramResult
```

## Parameters

| Name | Type |
|---|---|
| `entity` | `Entity` |
| `allEntities` | `Entity[]` |
| `allRelationships` | `Relationship[]` |
| `options` | `SequenceDiagramOptions` |

**Returns:** `SequenceDiagramResult`

<!-- source: component-mobilenavigation.md -->

# MobileNavigation

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Layout/DocumentLayout.tsx` (line 129)

Mobile navigation component - collapsible drawer

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `items` | `DocumentTreeNode[]` | ✓ | - |
| `activeId` | `string` | - | - |
| `loading` | `boolean` | ✓ | - |
| `onItemClick` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_MobileNavigation_199792c["MobileNavigation"]
    class component_MobileNavigation_199792c rootComponent
```

## Relationships

- RENDERS → `NavigationTree`
- USES_HOOK → `useState`

## Referenced By

- `DocumentLayout` (RENDERS)

<!-- source: interface-multieditoptions.md -->

# MultiEditOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/multi-edit.tool.ts` (line 16)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `maxFileSize` | `number` |

<!-- source: interface-ngrxactionpattern.md -->

# NgRxActionPattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ngrx-pattern-detector.ts` (line 19)

NgRx action pattern

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `actionType` | `string` |
| `line` | `number` |
| `hasPayload` | `boolean` |
| `payloadType` | `string` |
| `asyncGroup` | `{
    type: 'start' | 'success' | 'failure';
    baseName: string;
  }` |

<!-- source: interface-parseresult-2.md -->

# ParseResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/parser/interfaces/code-parser.interface.ts` (line 9)

## Properties

| Property | Type |
|---|---|
| `language` | `string` |
| `symbols` | `Symbol[]` |
| `dependencies` | `Dependency[]` |
| `imports` | `Import[]` |
| `exports` | `Export[]` |
| `ast` | `any` |
| `errors` | `ParseError[]` |

<!-- source: function-simulatekeypress.md -->

# simulateKeyPress

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-core/src/test-helpers.ts` (line 49)

Helper to simulate keyboard events

## Signature

```ts
function simulateKeyPress(element: HTMLElement, key: string, options: Partial<KeyboardEventInit>): void
```

## Parameters

| Name | Type |
|---|---|
| `element` | `HTMLElement` |
| `key` | `string` |
| `options` | `Partial<KeyboardEventInit>` |

**Returns:** `void`

<!-- source: class-syncresultdto.md -->

# SyncResultDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/sync.dto.ts` (line 131)

Single sync result

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `slug` | `string` |
| `status` | `'created' | 'updated' | 'skipped' | 'failed'` |
| `error` | `string` |
| `version` | `number` |

<!-- source: service-technicaldocsparserservice.md -->

# TechnicalDocsParserService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-parser.service.ts` (line 57)

Parses a git repository and builds a TechnicalSnapshot:
- entity graph (Entity[] + Relationship[])
- navMap (3-level: apps/libs → type → entities)
- OpenAPI spec (from API_ENDPOINT entities)

Also imports standalone repo MD files as Documents linked via kgEntityId,
and indexes all entities into Azure AI Search as technical_ref.

`TechnicalDocsParserService` scans a git repository to produce a `TechnicalSnapshot` used by the platform’s technical documentation and knowledge graph features. It builds the entity graph (entities + relationships), a 3-level navigation map (apps/libs → type → entities), and derives an OpenAPI spec from `API_ENDPOINT` entities. It also ingests standalone Markdown files as `Document` nodes linked via `kgEntityId`, and indexes all parsed entities into Azure AI Search under the `technical_ref` index.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `run` | `run(options: TechnicalDocsJobOptions)` | `Promise<TechnicalDocsJobResult>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant Caller
  participant Parser as TechnicalDocsParserService
  participant Repo as Git Repo (apps/libs)
  participant MD as Standalone MD Files
  participant KG as TechnicalSnapshot (graph+navMap+openapi)
  participant Search as Azure AI Search (technical_ref)

  Caller->>Parser: parseRepository(repoPath | gitRef)
  Parser->>Repo: traverse source tree
  Repo-->>Parser: code entities (apps/libs/types)
  Parser->>Parser: build Entity[] + Relationship[]
  Parser->>Parser: build navMap (apps/libs → type → entities)
  Parser->>Parser: derive OpenAPI spec from API_ENDPOINT entities

  Parser->>MD: scan/import *.md
  MD-->>Parser: Documents (linked via kgEntityId)

  Parser-->>KG: TechnicalSnapshot
  Parser->>Search: index entities as technical_ref
  Search-->>Parser: indexing result
  Parser-->>Caller: return TechnicalSnapshot
```

## Usage

```ts
// Example in a NestJS context (e.g., inside a controller or another service)
import { Injectable } from '@nestjs/common';
import { TechnicalDocsParserService } from './technical-docs-parser.service';

@Injectable()
export class TechnicalDocsJob {
  constructor(private readonly parser: TechnicalDocsParserService) {}

  async run() {
    // Adjust inputs to match your app’s configuration (repo path, git ref, tenant/project id, etc.)
    const snapshot = await this.parser.parseRepository({
      repoPath: '/var/repos/atloria-monorepo',
      // gitRef: 'main',
      // includeDocs: true,
      // indexToSearch: true,
    });

    // Use snapshot outputs downstream
    console.log('Entities:', snapshot.entities.length);
    console.log('Relationships:', snapshot.relationships.length);
    console.log('NavMap keys:', Object.keys(snapshot.navMap));
    console.log('OpenAPI paths:', Object.keys(snapshot.openApi?.paths ?? {}));
  }
}
```

## AI Coding Instructions

- Keep parsing deterministic: stable entity IDs, consistent relationship directions, and sorted outputs to avoid noisy diffs and re-index churn.
- Treat `API_ENDPOINT` entities as the single source of truth for OpenAPI generation; validate required fields early to prevent producing partial specs.
- When importing standalone Markdown, always link to the KG via `kgEntityId` and avoid creating duplicate `Document` nodes for the same target.
- Azure AI Search integration should be idempotent and resilient: batch indexing, handle retries, and ensure the `technical_ref` schema stays compatible with entity shape changes.
- Maintain the 3-level `navMap` contract (apps/libs → type → entities); changing its shape will break consumers in docs UI and graph explorers.

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `gitcloneservice`
- DEPENDS_ON → `technicaldocsservice`
- DEPENDS_ON → `documentindexingservice`
- DEPENDS_ON → `technicaldocsenrichmentservice`

<!-- source: function-usedocumentationjobs.md -->

# useDocumentationJobs

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useDocumentationJobs.ts` (line 72)

Custom hook for fetching documentation job history

Manages:
- Fetching recent jobs for a project
- Live WebSocket progress for RUNNING/PENDING jobs
- Re-generation (starting a new job)

## Signature

```ts
function useDocumentationJobs(options: UseDocumentationJobsOptions): UseDocumentationJobsReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseDocumentationJobsOptions` |

**Returns:** `UseDocumentationJobsReturn`

<!-- source: interface-useofflinesyncreturn.md -->

# UseOfflineSyncReturn

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useOfflineSync.ts` (line 45)

Return value of the useOfflineSync hook

## Properties

| Property | Type |
|---|---|
| `isOnline` | `boolean` |
| `hasPendingUpdates` | `boolean` |
| `pendingCount` | `number` |
| `isSyncing` | `boolean` |
| `error` | `Error | null` |
| `queueUpdate` | `(content: string) => void` |
| `sync` | `() => Promise<void>` |
| `clearPendingUpdates` | `() => void` |
| `getPendingUpdates` | `() => PendingUpdate[]` |

<!-- source: interface-createaudiencedto.md -->

# CreateAudienceDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/audiences.ts` (line 8)

Audience creation DTO

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `color` | `string` |
| `icon` | `string` |
| `description` | `string` |

<!-- source: constant-fixture.md -->

# fixture

**Kind:** Constant

**Source:** `atloria-monorepo/packages/ui-core/src/test-helpers.ts` (line 12)

Create a test fixture with proper typing

<!-- source: api-endpoint-generate.md -->

# generate

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 69)

Generate the full technical doc set for a project:
clone → parse → TechnicalSnapshot (navMap + apiSpec), then materialize a
browsable 'technical' doc set (entity reference pages in a DocVersion with
audienceScope='technical') and activate it — without touching the user
manual's ACTIVE version. Tracked as a DocumentationJob when the project
has an auto-doc config; otherwise poll GET :projectId/status.

## Endpoint

`POST /technical-docs/:projectId/generate`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: function-generatestatemachinediagram.md -->

# generateStateMachineDiagram

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/state-machine-diagram.generator.ts` (line 240)

Generate Mermaid state machine diagram

## Signature

```ts
function generateStateMachineDiagram(stateMachine: StateMachine, screenshots: EnhancedScreenshotMetadata[], interactions: UIInteraction[], options: StateMachineDiagramOptions): DiagramGenerationResult
```

## Parameters

| Name | Type |
|---|---|
| `stateMachine` | `StateMachine` |
| `screenshots` | `EnhancedScreenshotMetadata[]` |
| `interactions` | `UIInteraction[]` |
| `options` | `StateMachineDiagramOptions` |

**Returns:** `DiagramGenerationResult`

<!-- source: component-genericdirectiveeditor.md -->

# GenericDirectiveEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/directive-editors/GenericDirectiveEditor.tsx` (line 17)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `mdastNode` | `any` | ✓ | - |
| `descriptor` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_GenericDirectiveEditor_3317ab78["GenericDirectiveEditor"]
    class component_GenericDirectiveEditor_3317ab78 rootComponent
```

## Relationships

- RENDERS → `PropertyPopover`
- RENDERS → `NestedLexicalEditor`
- USES_HOOK → `useMdastNodeUpdater`
- USES_HOOK → `useMemo`
- USES_HOOK → `useCallback`

<!-- source: interface-ngrxeffectpattern.md -->

# NgRxEffectPattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ngrx-pattern-detector.ts` (line 122)

NgRx effect pattern

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `line` | `number` |
| `triggerAction` | `string` |
| `successAction` | `string` |
| `errorAction` | `string` |
| `isLegacy` | `boolean` |

<!-- source: interface-notebookeditoptions.md -->

# NotebookEditOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/notebook-edit.tool.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |

<!-- source: component-orb.md -->

# Orb

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/page.tsx` (line 377)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `style` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Orb_374b21d5["Orb"]
    class component_Orb_374b21d5 rootComponent
```

## Relationships

- RENDERS → `motion-div`

## Referenced By

- `HomePage` (RENDERS)

<!-- source: interface-path.md -->

# Path

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/graph/interfaces/entity.interface.ts` (line 42)

## Properties

| Property | Type |
|---|---|
| `entities` | `KGEntity[]` |
| `relationships` | `KGRelation[]` |
| `length` | `number` |

<!-- source: function-specstoworkerbatch.md -->

# specsToWorkerBatch

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/agent-screenshot-mapper.ts` (line 629)

Convert agent screenshot specs to the BatchScreenshotItem format
expected by the screenshot worker.

## Signature

```ts
function specsToWorkerBatch(specs: AgentScreenshotSpec[], siteUrl: string): any[]
```

## Parameters

| Name | Type |
|---|---|
| `specs` | `AgentScreenshotSpec[]` |
| `siteUrl` | `string` |

**Returns:** `any[]`

<!-- source: service-technicaldocsqueue.md -->

# TechnicalDocsQueue

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-queue.service.ts` (line 32)

Queues technical-docs generation OFF the api request path (BullMQ, like the parsing queue).

The api pods only ENQUEUE. The heavy clone+parse (several GB for a big repo) runs in the WORKER,
which is gated by TECHNICAL_DOCS_WORKER=true — so it only spins up in a dedicated worker
deployment (sized for parsing, like atlorix-runner), never in the request-serving pods. If a
parse OOMs, only that job fails/retries; the api keeps serving. Concurrency is bounded so a
couple of large parses can't pile up.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `onModuleInit` | `onModuleInit()` | `unknown` |
| `enqueue` | `enqueue(data: TechnicalDocsQueueJob)` | `Promise<string | undefined>` |
| `onModuleDestroy` | `onModuleDestroy()` | `unknown` |

## Relationships

- DEPENDS_ON → `configservice`
- DEPENDS_ON → `technicaldocsgenerationservice`
- DEPENDS_ON → `techdocsragservice`
- DEPENDS_ON → `technicaldocsenrichmentservice`
- DEPENDS_ON → `technicaldocsmaterializerservice`
- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `opsalertservice`
- DEPENDS_ON → `aiusageservice`

<!-- source: class-templatefiltersdto.md -->

# TemplateFiltersDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/template/dto/template-filters.dto.ts` (line 10)

DTO for filtering templates in list queries.
Supports filtering by category and organization.

## Properties

| Property | Type |
|---|---|
| `category` | `TemplateCategory` |
| `organizationId` | `string` |
| `search` | `string` |

<!-- source: function-usedocumentcollaborators.md -->

# useDocumentCollaborators

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useProjectMembers.ts` (line 170)

useDocumentCollaborators - Hook for fetching users who can be mentioned in a document

This is a convenience wrapper that determines the appropriate members to fetch
based on the document context.

## Signature

```ts
function useDocumentCollaborators(documentId: string): UseProjectMembersReturn
```

## Parameters

| Name | Type |
|---|---|
| `documentId` | `string` |

**Returns:** `UseProjectMembersReturn`

<!-- source: interface-useparseroptions.md -->

# UseParserOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useParser.ts` (line 7)

## Properties

| Property | Type |
|---|---|
| `apiUrl` | `string` |
| `getToken` | `() => string | null` |

<!-- source: interface-createcategorydto.md -->

# CreateCategoryDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/category.dto.ts` (line 6)

DTO for creating a new category

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `icon` | `string` |
| `color` | `string` |
| `order` | `number` |
| `projectId` | `string` |
| `parentId` | `string` |
| `defaultDocId` | `string` |

<!-- source: constant-flask-blueprint-patterns.md -->

# FLASK_BLUEPRINT_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/flask.patterns.ts` (line 48)

<!-- source: api-endpoint-generate-2.md -->

# generate

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/trial/trial.controller.ts` (line 16)

## Endpoint

`POST /trial/generate`

## Referenced By

- `TrialController` (MODULE_DECLARES)

<!-- source: function-generatetypescriptsdk.md -->

# generateTypeScriptSdk

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/sdk-generator.ts` (line 97)

Generate the full sdk.ts source for a spec.

## Signature

```ts
function generateTypeScriptSdk(spec: {
  info?: { title?: string; version?: string };
  servers?: Array<{ url?: string }>;
  paths?: Record<string, Record<string, OpenApiOperation>>;
  components?: { schemas?: Record<string, JsonSchema> };
}): string
```

## Parameters

| Name | Type |
|---|---|
| `spec` | `{
  info?: { title?: string; version?: string };
  servers?: Array<{ url?: string }>;
  paths?: Record<string, Record<string, OpenApiOperation>>;
  components?: { schemas?: Record<string, JsonSchema> };
}` |

**Returns:** `string`

<!-- source: component-genericjsxeditor.md -->

# GenericJsxEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/jsx-editors/GenericJsxEditor.tsx` (line 68)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `mdastNode` | `any` | ✓ | - |
| `descriptor` | `any` | ✓ | - |
| `PropertyEditor` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_GenericJsxEditor_3c825878["GenericJsxEditor"]
    class component_GenericJsxEditor_3c825878 rootComponent
```

## Relationships

- RENDERS → `PropertyEditorComponent`
- RENDERS → `NestedLexicalEditor`
- USES_HOOK → `useMdastNodeUpdater`
- USES_HOOK → `useMemo`
- USES_HOOK → `useCallback`

<!-- source: interface-ngrxreducerpattern.md -->

# NgRxReducerPattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ngrx-pattern-detector.ts` (line 57)

NgRx reducer pattern

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `sliceName` | `string` |
| `line` | `number` |
| `initialState` | `Record<string, unknown>` |
| `handlesActions` | `string[]` |
| `stateShape` | `Record<string, string>` |

<!-- source: interface-notebookreadoptions.md -->

# NotebookReadOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/notebook-read.tool.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `maxOutputLength` | `number` |

<!-- source: component-overflowindicator.md -->

# OverflowIndicator

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/CollaborationStatusBar.tsx` (line 121)

Overflow indicator showing additional users count

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `count` | `number` | ✓ | - |
| `users` | `CollaborationUser[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_OverflowIndicator_2dc14045["OverflowIndicator"]
    class component_OverflowIndicator_2dc14045 rootComponent
```

## Relationships

- USES_HOOK → `useState`

## Referenced By

- `CollaborationStatusBar` (RENDERS)

<!-- source: interface-promptcontext.md -->

# PromptContext

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/support-agent/prompts/system-prompt-layers.ts` (line 9)

Layered System Prompt Architecture for Support Agent

Each layer serves a specific purpose and they are assembled in order.
Core layers (1-6) are IMMUTABLE and cannot be overridden by user customization.
Layer 7 (custom) is where user-specific personality/behavior is added.

## Properties

| Property | Type |
|---|---|
| `projectName` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `docVersion` | `string` |
| `agentName` | `string` |
| `userSystemPrompt` | `string` |
| `language` | `string` |

<!-- source: function-tap.md -->

# tap

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/fp.ts` (line 45)

Calls callback with the first argument, and returns it.

## Signature

```ts
function tap(arg: T, proc: (arg: T) => unknown): T
```

## Parameters

| Name | Type |
|---|---|
| `arg` | `T` |
| `proc` | `(arg: T) => unknown` |

**Returns:** `T`

<!-- source: service-technicaldocsservice.md -->

# TechnicalDocsService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.service.ts` (line 30)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `resolveProjectForJob` | `resolveProjectForJob(projectId: string, user: JwtPayload, opts: { requireRepo?: boolean })` | `unknown` |
| `getSnapshot` | `getSnapshot(projectId: string)` | `unknown` |
| `setCuration` | `setCuration(projectId: string, userId: string, dto: { pinned?: unknown; hidden?: unknown })` | `Promise<TechdocsCuration>` |
| `setPlaygroundTestToken` | `setPlaygroundTestToken(projectId: string, userId: string, token: unknown)` | `Promise<{ hasTestToken: boolean }>` |
| `setEscalationConfig` | `setEscalationConfig(projectId: string, userId: string, dto: { webhookUrl?: string })` | `unknown` |
| `getEscalationConfig` | `getEscalationConfig(projectId: string, userId: string)` | `unknown` |
| `getApiTargetConfig` | `getApiTargetConfig(projectId: string, userId: string)` | `Promise<ApiTargetPublicConfig>` |
| `setApiTargetConfig` | `setApiTargetConfig(projectId: string, userId: string, dto: { baseUrl?: string; authHeaderName?: string; authHeaderValue?: string; allowWrites?: boolean; enabled?: boolean })` | `Promise<ApiTargetPublicConfig>` |
| `getApiExecRuntimeConfig` | `getApiExecRuntimeConfig(projectId: string)` | `Promise<ApiExecRuntimeConfig | null>` |
| `getEntity` | `getEntity(projectId: string, entityId: string)` | `unknown` |
| `getApiSpec` | `getApiSpec(projectId: string)` | `unknown` |
| `getJobStatus` | `getJobStatus(projectId: string)` | `unknown` |
| `upsertSnapshot` | `upsertSnapshot(projectId: string, data: {
      entitiesJson: any[];
      relationshipsJson: any[];
      apiSpecJson?: any;
      navMapJson: any;
    })` | `unknown` |
| `checkStaleness` | `checkStaleness(projectId: string, changedFiles: string[], commit: string, branch: string)` | `Promise<{ staleCount: number } | null>` |
| `clearStaleness` | `clearStaleness(projectId: string)` | `Promise<void>` |
| `createTrackedJob` | `createTrackedJob(projectId: string, organizationId: string, userId: string, stage: string, branch: string | null)` | `Promise<string | null>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `documentindexingservice`
- DEPENDS_ON → `stalealertservice`

<!-- source: class-ticketcsatdto.md -->

# TicketCsatDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/issues/dto/public-ticket.dto.ts` (line 16)

Ticket-level CSAT from the public tracking page

## Properties

| Property | Type |
|---|---|
| `score` | `number` |

<!-- source: function-usegraph.md -->

# useGraph

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/Graph/useGraph.ts` (line 33)

Custom hook for fetching and managing knowledge graph data

## Signature

```ts
function useGraph(options: UseGraphOptions): UseGraphReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseGraphOptions` |

**Returns:** `UseGraphReturn`

<!-- source: interface-useparserreturn.md -->

# UseParserReturn

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useParser.ts` (line 12)

## Properties

| Property | Type |
|---|---|
| `parse` | `(code: string, language: string, filename?: string) => Promise<ParseResult>` |
| `parseDocument` | `(documentId: string) => Promise<ParseResult>` |
| `getSupportedLanguages` | `() => Promise<string[]>` |
| `parseResult` | `ParseResult | null` |
| `loading` | `boolean` |
| `error` | `Error | null` |

<!-- source: interface-createcodeblocknodeoptions.md -->

# CreateCodeBlockNodeOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/CodeBlockNode.tsx` (line 22)

The options necessary to construct a new code block node.

## Properties

| Property | Type |
|---|---|
| `code` | `string` |
| `language` | `string` |
| `meta` | `string` |

<!-- source: constant-flask-detection-config.md -->

# FLASK_DETECTION_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/flask.patterns.ts` (line 247)

## Definition

```ts
FlaskDetectionConfig
```

<!-- source: api-endpoint-generatefromneo4j.md -->

# generateFromNeo4j

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/documentation.controller.ts` (line 72)

## Endpoint

`POST /documentation/generate-from-neo4j`

## Referenced By

- `DocumentationController` (MODULE_DECLARES)

<!-- source: function-generateuserjourneydiagrams.md -->

# generateUserJourneyDiagrams

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/user-journey-diagram.generator.ts` (line 80)

Main function to generate user journey diagrams from parsed entities

## Signature

```ts
function generateUserJourneyDiagrams(entities: Entity[], options: UserJourneyGenerationOptions): UserJourneyDiagramResult
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `Entity[]` |
| `options` | `UserJourneyGenerationOptions` |

**Returns:** `UserJourneyDiagramResult`

<!-- source: component-getmarkdowninsourcemode.md -->

# GetMarkdownInSourceMode

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/diff-source.tsx` (line 14)

## Diagram

```mermaid
graph TD
    component_GetMarkdownInSourceMode_1fd8740c["GetMarkdownInSourceMode"]
    class component_GetMarkdownInSourceMode_1fd8740c rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useRef`

<!-- source: interface-ngrxselectorpattern.md -->

# NgRxSelectorPattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ngrx-pattern-detector.ts` (line 92)

NgRx selector pattern

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `line` | `number` |
| `isMemoized` | `boolean` |
| `statePath` | `string[]` |
| `dependsOn` | `string[]` |

<!-- source: interface-orchestrationcallbacks.md -->

# OrchestrationCallbacks

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/orchestrator.ts` (line 106)

Callbacks for orchestration lifecycle

## Properties

| Property | Type |
|---|---|
| `onPhaseStart` | `(phaseId: string, phaseName: string) => void` |
| `onAgentStart` | `(phaseId: string, agentName: string) => void` |
| `onAgentComplete` | `(phaseId: string, result: AgentResult) => void` |
| `onPhaseComplete` | `(result: PhaseResult) => void | Promise<void>` |
| `onApprovalRequired` | `(phaseId: string, synthesis: string) => Promise<boolean>` |

<!-- source: component-parsercard.md -->

# ParserCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/languages/page.tsx` (line 390)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `parser` | `unknown` | ✓ | - |
| `color` | `string` | ✓ | - |
| `bg` | `string` | ✓ | - |
| `border` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ParserCard_261c8a8d["ParserCard"]
    class component_ParserCard_261c8a8d rootComponent
```

## Referenced By

- `LanguagesPage` (RENDERS)

<!-- source: interface-publishedprojectresult.md -->

# PublishedProjectResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/project/project.service.ts` (line 29)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `slug` | `string` |
| `urlId` | `string` |
| `publishedSlug` | `string` |
| `publicUrl` | `string` |
| `publishedAt` | `Date` |
| `isPublic` | `boolean` |

<!-- source: service-templateservice.md -->

# TemplateService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/template/template.service.ts` (line 16)

Service for managing document templates.
Provides CRUD operations and template usage tracking.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `list` | `list(filters: TemplateFiltersDto)` | `Promise<DocumentTemplate[]>` |
| `getById` | `getById(id: string)` | `Promise<DocumentTemplate>` |
| `create` | `create(dto: CreateTemplateDto, userId: string)` | `Promise<DocumentTemplate>` |
| `createDocumentFromTemplate` | `createDocumentFromTemplate(templateId: string, dto: CreateFromTemplateDto, userId: string)` | `Promise<Document>` |
| `saveAsTemplate` | `saveAsTemplate(documentId: string, dto: SaveAsTemplateDto, userId: string)` | `Promise<DocumentTemplate>` |
| `update` | `update(id: string, dto: Partial<CreateTemplateDto>, userId: string)` | `Promise<DocumentTemplate>` |
| `delete` | `delete(id: string, userId: string)` | `Promise<void>` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: function-thrush.md -->

# thrush

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/fp.ts` (line 13)

Takes a value and applies a function to it.

## Signature

```ts
function thrush(arg: I, proc: (arg: I) => K)
```

## Parameters

| Name | Type |
|---|---|
| `arg` | `I` |
| `proc` | `(arg: I) => K` |

<!-- source: class-typescriptparser.md -->

# TypeScriptParser

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/parser/parsers/typescript.parser.ts` (line 16)

**Implements:** `CodeParser`

## Methods

| Method | Signature | Returns |
|---|---|---|
| `parse` | `parse(code: string, filename: undefined)` | `Promise<ParseResult>` |
| `extractSymbols` | `extractSymbols(code: string)` | `Promise<ParserSymbol[]>` |
| `extractDependencies` | `extractDependencies(code: string)` | `Promise<Dependency[]>` |

## Properties

| Property | Type |
|---|---|
| `language` | `any` |
| `supportedExtensions` | `any` |

<!-- source: function-usehasprojectselected.md -->

# useHasProjectSelected

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/stores/projectContext.ts` (line 205)

Hook to check if a project is selected

## Signature

```ts
function useHasProjectSelected(): boolean
```

**Returns:** `boolean`

<!-- source: interface-useprojectmembersoptions.md -->

# UseProjectMembersOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useProjectMembers.ts` (line 21)

Options for useProjectMembers hook

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `organizationId` | `string` |
| `autoFetch` | `boolean` |

<!-- source: interface-createcommentdto.md -->

# CreateCommentDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/comment.dto.ts` (line 15)

Create comment DTO

## Properties

| Property | Type |
|---|---|
| `content` | `string` |
| `selectionText` | `string` |
| `positionStart` | `number` |
| `positionEnd` | `number` |
| `parentCommentId` | `string` |

<!-- source: constant-flask-error-patterns.md -->

# FLASK_ERROR_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/flask.patterns.ts` (line 220)

<!-- source: api-endpoint-generateoutline.md -->

# generateOutline

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/ai/ai.controller.ts` (line 52)

## Endpoint

`POST /ai/outline`

## Referenced By

- `AIController` (MODULE_DECLARES)

<!-- source: function-generateworkflowdocumentation.md -->

# generateWorkflowDocumentation

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/workflow-documentation.generator.ts` (line 42)

Generate workflow documentation from enhanced screenshot metadata

Takes a collection of screenshots with state machine context and creates
comprehensive workflow documentation including state diagrams, actions, and guides.

## Signature

```ts
function generateWorkflowDocumentation(screenshots: EnhancedScreenshotMetadata[], options: WorkflowDocGenerationOptions): WorkflowDocumentation[]
```

## Parameters

| Name | Type |
|---|---|
| `screenshots` | `EnhancedScreenshotMetadata[]` |
| `options` | `WorkflowDocGenerationOptions` |

**Returns:** `WorkflowDocumentation[]`

<!-- source: component-getselectionmarkdown.md -->

# GetSelectionMarkdown

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/get-selection-markdown.tsx` (line 33)

## Diagram

```mermaid
graph TD
    component_GetSelectionMarkdown_66ab9fef["GetSelectionMarkdown"]
    class component_GetSelectionMarkdown_66ab9fef rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useRef`
- USES_HOOK → `useState`

<!-- source: interface-openapifragment.md -->

# OpenApiFragment

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/schema-resolver.ts` (line 185)

## Properties

| Property | Type |
|---|---|
| `paths` | `Record<string, Record<string, unknown>>` |
| `components` | `{ schemas: Record<string, Record<string, unknown>> }` |
| `resolvedCount` | `number` |

<!-- source: interface-orchestrationplan.md -->

# OrchestrationPlan

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/orchestrator.ts` (line 82)

A complete multi-phase workflow

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `phases` | `Phase[]` |

<!-- source: component-portaltableofcontents.md -->

# PortalTableOfContents

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/[audienceSlug]/[documentSlug]/page.tsx` (line 165)

Portal-Compatible ToC Component Uses same hooks as TableOfContents but adapted for portal rendering

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `entries` | `TocEntry[]` | ✓ | - |
| `title` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PortalTableOfContents_640b163e["PortalTableOfContents"]
    class component_PortalTableOfContents_640b163e rootComponent
```

## Relationships

- RENDERS → `ChevronDown`
- RENDERS → `ChevronRight`
- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useMemo`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useActiveSection`
- USES_HOOK → `useCallback`

## Referenced By

- `PublicDocumentPage` (RENDERS)

<!-- source: interface-ragsearchresult.md -->

# RagSearchResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/support-agent/prompts/rag-context-formatter.ts` (line 8)

RAG Context Formatter

Formats search results into a structured context that the AI can understand
and reference in its responses.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `content` | `string` |
| `description` | `string` |
| `score` | `number` |
| `documentType` | `string` |

<!-- source: service-tocbuilderservice.md -->

# TocBuilderService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/document/services/toc-builder.service.ts` (line 10)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `extractToc` | `extractToc(content: string)` | `TocEntry[]` |

<!-- source: function-togglebg.md -->

# toggleBg

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/examples/assets/dataCode.ts` (line 3)

## Signature

```ts
function toggleBg(index: number)
```

## Parameters

| Name | Type |
|---|---|
| `index` | `number` |

<!-- source: class-unpublishdocumentdto.md -->

# UnpublishDocumentDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/publish-document.dto.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `reason` | `string` |

<!-- source: function-useimageupload.md -->

# useImageUpload

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useImageUpload.ts` (line 67)

useImageUpload - Hook for uploading images to Azure Blob Storage

Provides a simple interface for uploading images from the editor.
Returns the CDN URL of the uploaded image for embedding in documents.

## Signature

```ts
function useImageUpload(): UseImageUploadReturn
```

**Returns:** `UseImageUploadReturn`

<!-- source: interface-useprojectmembersreturn.md -->

# UseProjectMembersReturn

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useProjectMembers.ts` (line 33)

Return type for useProjectMembers hook

## Properties

| Property | Type |
|---|---|
| `members` | `MemberUser[]` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `refresh` | `() => Promise<void>` |

<!-- source: interface-createdocumentdto.md -->

# CreateDocumentDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/document.dto.ts` (line 7)

DTO for creating a new document

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `slug` | `string` |
| `content` | `string` |
| `contentHtml` | `string` |
| `type` | `DocumentType` |
| `source` | `DocumentSource` |
| `audiences` | `Audience[]` |
| `projectId` | `string` |
| `createdById` | `string` |
| `kgEntityId` | `string` |
| `kgEntityType` | `string` |
| `isPublic` | `boolean` |
| `canRegenerate` | `boolean` |

<!-- source: constant-flask-extensions-patterns.md -->

# FLASK_EXTENSIONS_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/flask.patterns.ts` (line 156)

<!-- source: api-endpoint-generateuserdocumentation.md -->

# generateUserDocumentation

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/documentation.controller.ts` (line 20)

## Endpoint

`POST /documentation/generate-user-docs`

## Referenced By

- `DocumentationController` (MODULE_DECLARES)

<!-- source: function-generateworkflowdocumentationfile.md -->

# generateWorkflowDocumentationFile

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/workflow-documentation.generator.ts` (line 213)

Generate workflow documentation and write to file

## Signature

```ts
async function generateWorkflowDocumentationFile(screenshots: EnhancedScreenshotMetadata[], outputPath: string, options: WorkflowDocGenerationOptions): Promise<WorkflowDocGenerationResult[]>
```

## Parameters

| Name | Type |
|---|---|
| `screenshots` | `EnhancedScreenshotMetadata[]` |
| `outputPath` | `string` |
| `options` | `WorkflowDocGenerationOptions` |

**Returns:** `Promise<WorkflowDocGenerationResult[]>`

<!-- source: component-headings.md -->

# Headings

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 167)

## Diagram

```mermaid
graph TD
    component_Headings_74f4b005["Headings"]
    class component_Headings_74f4b005 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: interface-openapiref.md -->

# OpenApiRef

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/schema-resolver.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `schema` | `Record<string, unknown>` |

<!-- source: interface-orchestrationresult.md -->

# OrchestrationResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/orchestrator.ts` (line 98)

Result of executing a full orchestration plan

## Properties

| Property | Type |
|---|---|
| `planName` | `string` |
| `phaseResults` | `PhaseResult[]` |
| `totalUsage` | `TokenUsage` |
| `totalDurationMs` | `number` |

<!-- source: component-previewpane.md -->

# PreviewPane

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/branding/page.tsx` (line 1423)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `form` | `BrandingState` | ✓ | - |
| `project` | `unknown | null` | ✓ | - |
| `device` | `unknown | unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PreviewPane_a6dfc30["PreviewPane"]
    class component_PreviewPane_a6dfc30 rootComponent
```

## Referenced By

- `BrandingSettingsPage` (RENDERS)

<!-- source: interface-rawindexpage.md -->

# RawIndexPage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/search-index.ts` (line 50)

## Properties

| Property | Type |
|---|---|
| `slug` | `string` |
| `title` | `string` |
| `content` | `string` |
| `docType` | `'technical' | 'user_manual'` |
| `entityId` | `string | null` |

<!-- source: function-torelativepath.md -->

# toRelativePath

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/services/entity-mapper.service.ts` (line 312)

Convert an absolute file path to a path relative to the repo root.
Always uses forward slashes.

## Signature

```ts
function toRelativePath(absolutePath: string, normalizedRepoPath: string): string
```

## Parameters

| Name | Type |
|---|---|
| `absolutePath` | `string` |
| `normalizedRepoPath` | `string` |

**Returns:** `string`

<!-- source: service-trialservice.md -->

# TrialService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/trial/trial.service.ts` (line 18)

One-click public-repo trial (Phase 1.1) — the answer to DeepWiki's zero-friction entry.
Paste a public GitHub URL → docs hub + grounded chat + MCP + SDK, no signup. Public repos
clone anonymously, so this needs NO GitHub App/OAuth. Guardrails: URL shape validation,
per-repo dedupe (same repo → same trial project, regenerations reused), a global daily
cap, and per-IP rate limiting at the controller. All trials live under a system org whose
credits are auto-topped — normal metering still records every token for cost visibility.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `startTrial` | `startTrial(repoUrl: string)` | `Promise<{
    projectId: string;
    status: 'ready' | 'generating';
    repo: string;
  }>` |
| `status` | `status(projectId: string)` | `unknown` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `technicaldocsqueue`
- DEPENDS_ON → `technicaldocsservice`

<!-- source: class-updateaudiencedto.md -->

# UpdateAudienceDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/audience/dto/update-audience.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `color` | `string` |
| `icon` | `string` |
| `description` | `string` |

<!-- source: function-useknowledgegraph.md -->

# useKnowledgeGraph

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useKnowledgeGraph.ts` (line 32)

Hook to fetch and manage knowledge graph data for the current project

<!-- source: interface-useprojectpublishreturn.md -->

# UseProjectPublishReturn

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useProjectPublish.ts` (line 25)

Return type for useProjectPublish hook

## Properties

| Property | Type |
|---|---|
| `publish` | `(projectId: string) => Promise<PublishedProjectResponse>` |
| `unpublish` | `(projectId: string) => Promise<Project>` |
| `loading` | `boolean` |
| `error` | `Error | null` |

<!-- source: interface-createorganizationdto.md -->

# CreateOrganizationDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/organization.dto.ts` (line 4)

DTO for creating a new organization

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |

<!-- source: constant-flask-request-response-patterns.md -->

# FLASK_REQUEST_RESPONSE_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/flask.patterns.ts` (line 66)

<!-- source: api-endpoint-generatewebhooksecret.md -->

# generateWebhookSecret

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 265)

## Endpoint

`POST /doc-automation/config/:projectId/webhook-secret`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: function-generateworkflowmdx.md -->

# generateWorkflowMDX

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/workflow-documentation.generator.ts` (line 80)

Generate MDX content from workflow documentation

## Signature

```ts
function generateWorkflowMDX(workflow: WorkflowDocumentation, options: WorkflowDocGenerationOptions): string
```

## Parameters

| Name | Type |
|---|---|
| `workflow` | `WorkflowDocumentation` |
| `options` | `WorkflowDocGenerationOptions` |

**Returns:** `string`

<!-- source: component-herobentogrid-2.md -->

# HeroBentoGrid

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/hero/hero-bento-grid.tsx` (line 27)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `subheadlineKey` | `string` | ✓ | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `badgeKey` | `string` | - | - |
| `gridItems` | `unknown[]` | - | - |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_HeroBentoGrid_6437694a["HeroBentoGrid"]
    class component_HeroBentoGrid_6437694a rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: interface-orchestratorconfig-2.md -->

# OrchestratorConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/config.interface.ts` (line 191)

Parser orchestrator configuration

## Properties

| Property | Type |
|---|---|
| `defaultParsers` | `string[]` |
| `maxConcurrency` | `number` |
| `fileTimeout` | `number` |
| `projectTimeout` | `number` |
| `enableCaching` | `boolean` |
| `cacheDir` | `string` |
| `parserConfigs` | `Record<string, ParserConfig>` |

<!-- source: interface-otlpexporterconfig.md -->

# OtlpExporterConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tracing/otlp-exporter.ts` (line 31)

## Properties

| Property | Type |
|---|---|
| `endpoint` | `string` |
| `serviceName` | `string` |
| `enabled` | `boolean` |
| `batchSize` | `number` |
| `flushIntervalMs` | `number` |
| `headers` | `Record<string, string>` |
| `onExportError` | `(error: Error, droppedSpanCount: number) => void` |

<!-- source: component-prioritygauge.md -->

# PriorityGauge

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/page.tsx` (line 298)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `data` | `PriorityDatum[]` | ✓ | - |
| `total` | `number` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PriorityGauge_708c9494["PriorityGauge"]
    class component_PriorityGauge_708c9494 rootComponent
```

## Relationships

- RENDERS → `ResponsiveContainer`
- RENDERS → `PieChart`
- RENDERS → `Pie`
- RENDERS → `Cell`
- RENDERS → `RTooltip`

## Referenced By

- `IssuesListPage` (RENDERS)

<!-- source: interface-reshootresult.md -->

# ReshootResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/freshness.service.ts` (line 53)

Result of the one-click screenshot re-shoot trigger.

## Properties

| Property | Type |
|---|---|
| `enqueued` | `boolean` |
| `reason` | `'no-stale-pages' | 'no-provenance'` |
| `jobId` | `string` |
| `screenSlugs` | `string[]` |
| `pagesWithoutProvenance` | `number` |

<!-- source: function-trackevent.md -->

# trackEvent

**Kind:** Function

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/analytics.ts` (line 122)

Track a custom event.

## Signature

```ts
function trackEvent(name: string, properties: Record<string, string>)
```

## Parameters

| Name | Type |
|---|---|
| `name` | `string` |
| `properties` | `Record<string, string>` |

<!-- source: service-tutorialdetectorservice.md -->

# TutorialDetectorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/tutorial-detector.service.ts` (line 108)

Tutorial Detector Service

Detects single-step tutorials from state transitions.
Each state transition becomes a quick-start tutorial (2-5 minutes).

Strategy:
1. Find all state machines
2. For each transition, create a tutorial
3. Link tutorials via prerequisites/next steps
4. Group into learning paths by category

Example:
- State machine: JobStageEnum
- Transition: Offer → Order (convertToOrder)
- Tutorial: "How to Convert an Offer to an Order"
- Difficulty: Beginner
- Time: 2-3 minutes
- Prerequisites: "How to Create a Job Offer"
- Next steps: "How to Deliver an Order"

`TutorialDetectorService` scans application state machines and derives micro-tutorials from their state transitions. Each transition becomes a single-step quick-start tutorial (typically 2–5 minutes), enriched with difficulty, estimated time, and navigation links (prerequisites/next steps). It helps automatically generate structured learning paths by grouping tutorials by domain/category.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectTutorials` | `detectTutorials(entities: any[], appMap: any, features: any[])` | `Promise<{
    tutorials: DetectedTutorial[];
    learningPaths: LearningPath[];
  }>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant Caller as API/CLI/Job
  participant TDS as TutorialDetectorService
  participant SM as StateMachineRegistry
  participant GEN as TutorialGenerator
  participant LINK as TutorialLinker
  participant PATH as LearningPathGrouper
  participant OUT as Docs/DB Output

  Caller->>TDS: detectTutorials()
  TDS->>SM: listStateMachines()
  SM-->>TDS: stateMachines[]
  loop for each stateMachine
    TDS->>SM: getTransitions(stateMachine)
    SM-->>TDS: transitions[]
    loop for each transition
      TDS->>GEN: createTutorialFromTransition(transition)
      GEN-->>TDS: tutorial
    end
  end
  TDS->>LINK: linkPrerequisitesAndNextSteps(tutorials)
  LINK-->>TDS: linkedTutorials
  TDS->>PATH: groupByCategory(linkedTutorials)
  PATH-->>TDS: learningPaths
  TDS->>OUT: persistOrRender(learningPaths)
  OUT-->>Caller: result
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { TutorialDetectorService } from './documentation/services/tutorial-detector.service';

@Injectable()
export class DocsGenerationJob {
  constructor(private readonly tutorialDetector: TutorialDetectorService) {}

  async run() {
    // Detect tutorials derived from all known state machine transitions.
    const result = await this.tutorialDetector.detectTutorials();

    // Example: iterate and print a few generated tutorial titles.
    for (const path of result.learningPaths ?? []) {
      console.log(`Learning Path: ${path.title}`);
      for (const tutorial of path.tutorials.slice(0, 3)) {
        console.log(` - ${tutorial.title} (${tutorial.difficulty}, ${tutorial.estimatedTime})`);
        console.log(`   prereq: ${tutorial.prerequisites?.join(', ') ?? 'none'}`);
        console.log(`   next:   ${tutorial.nextSteps?.join(', ') ?? 'none'}`);
      }
    }

    return result;
  }
}
```

## AI Coding Instructions

- Treat each state transition as the single source of truth for tutorial generation; avoid hand-curated tutorial definitions that drift from the state machine.
- Keep tutorial titles/action verbs deterministic (e.g., derived from transition name like `convertToOrder`) so linking and deduplication remain stable across runs.
- When adding or renaming states/transitions, ensure the detector can still resolve prerequisites/next steps (ordering or adjacency rules are a common failure point).
- Integrate category/grouping from domain metadata (state machine ownership/module) rather than parsing strings from enum names whenever possible.
- Prefer idempotent outputs (stable IDs/keys for tutorials and learning paths) so re-running generation doesn’t create duplicates in persisted docs/DB.

<!-- source: class-updateboarddto.md -->

# UpdateBoardDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/boards/dto/update-board.dto.ts` (line 3)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `color` | `string` |
| `isDefault` | `boolean` |
| `settings` | `Record<string, unknown>` |

<!-- source: function-uselanguagecontext.md -->

# useLanguageContext

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/LanguageContext.tsx` (line 50)

<!-- source: interface-usepublishreturn.md -->

# UsePublishReturn

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/usePublish.ts` (line 11)

Return type for usePublish hook

## Properties

| Property | Type |
|---|---|
| `publish` | `(documentId: string) => Promise<Document>` |
| `unpublish` | `(documentId: string) => Promise<Document>` |
| `loading` | `boolean` |
| `error` | `Error | null` |

<!-- source: interface-createprojectdto.md -->

# CreateProjectDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/project.dto.ts` (line 4)

DTO for creating a new project

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `organizationId` | `string` |
| `themeId` | `string` |
| `repoUrl` | `string` |
| `repoBranch` | `string` |

<!-- source: constant-flask-route-patterns.md -->

# FLASK_ROUTE_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/flask.patterns.ts` (line 11)

Flask Pattern Detection

Patterns for detecting Flask routes, blueprints, and extensions.

<!-- source: api-endpoint-get.md -->

# get

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/audience/audience.controller.ts` (line 39)

## Endpoint

`GET /audiences/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `AudienceController` (MODULE_DECLARES)

<!-- source: function-getlowestcoveragestatemachines.md -->

# getLowestCoverageStateMachines

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/coverage-calculator.ts` (line 376)

Get state machines with lowest coverage

## Signature

```ts
function getLowestCoverageStateMachines(report: CoverageReport, limit): StateMachineCoverage[]
```

## Parameters

| Name | Type |
|---|---|
| `report` | `CoverageReport` |
| `limit` | `any` |

**Returns:** `StateMachineCoverage[]`

<!-- source: component-heroclassicsplit-2.md -->

# HeroClassicSplit

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/hero/hero-classic-split.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `subheadlineKey` | `string` | ✓ | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `badgeKey` | `string` | - | - |
| `badgeIcon` | `LucideIcon` | - | - |
| `imageSrc` | `string` | ✓ | - |
| `imageAlt` | `string` | ✓ | - |
| `trustItems` | `unknown[]` | - | - |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_HeroClassicSplit_7cdf55b8["HeroClassicSplit"]
    class component_HeroClassicSplit_7cdf55b8 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-span`
- RENDERS → `BadgeIcon`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- RENDERS → `motion-ul`
- RENDERS → `Check`
- USES_HOOK → `useTranslation`

<!-- source: interface-outputguardraildefinition.md -->

# OutputGuardrailDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 163)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `execute` | `(output: string) => Promise<GuardrailResult>` |

<!-- source: interface-parameterdefinition-2.md -->

# ParameterDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 576)

Parameter definition (path, query, header)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `required` | `boolean` |
| `description` | `string` |
| `example` | `unknown` |
| `defaultValue` | `unknown` |

<!-- source: component-projectcardcustom.md -->

# ProjectCardCustom

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/page.tsx` (line 255)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `project` | `Project` | ✓ | - |
| `onClick` | `Function` | ✓ | - |
| `onDelete` | `Function` | ✓ | - |
| `showMenu` | `boolean` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ProjectCardCustom_12efb7c9["ProjectCardCustom"]
    class component_ProjectCardCustom_12efb7c9 rootComponent
```

## Relationships

- RENDERS → `FolderIcon`

## Referenced By

- `ProjectsPage` (RENDERS)

<!-- source: interface-resolvedlanguage.md -->

# ResolvedLanguage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/project/language.util.ts` (line 14)

Language metadata for the public viewer's i18n (RTL layout + locale switcher).

Mirrors the doc generator's `_resolve_language` (atlorix tools) so a
DocVersion.language code resolves to the same {code, base, name, dir} the
docs were written for. `dir` drives the viewer's RTL/LTR layout; `name`
(native) labels the locale switcher.

Codes are BCP-47-ish: a base language ("ar", "pt") optionally with a script
or region subtag ("pt-BR", "zh-Hant"). Resolution is base-driven so any
region variant of Arabic is still RTL and still labelled "العربية".

## Properties

| Property | Type |
|---|---|
| `code` | `string` |
| `base` | `string` |
| `name` | `string` |
| `dir` | `'ltr' | 'rtl'` |

<!-- source: function-trackpageview.md -->

# trackPageView

**Kind:** Function

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/analytics.ts` (line 146)

Track a page view.

## Signature

```ts
function trackPageView(path: string)
```

## Parameters

| Name | Type |
|---|---|
| `path` | `string` |

<!-- source: service-tutorialgeneratorservice.md -->

# TutorialGeneratorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/tutorial-generator.service.ts` (line 72)

Tutorial Generator Service

Generates beginner-friendly tutorial content using AI.
Each tutorial teaches a single state transition (2-5 minutes).

Leverages Phase 2.1 & 3 context:
- State machines → explain state changes
- UI interactions → use exact button labels
- Screenshots → reference visuals

Multi-agent approach:
- Generator (Claude): Creates initial content
- Reviewer (OpenAI): Reviews for clarity and beginner-friendliness

`TutorialGeneratorService` is a NestJS backend service that generates short, beginner-friendly tutorials (2–5 minutes) that each teach a single state transition in the product. It builds tutorials using app context (state machine transitions, exact UI button labels, and referenced screenshots) and improves quality via a multi-agent pipeline where one model generates and another reviews for clarity and approachability.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generateTutorial` | `generateTutorial(tutorial: DetectedTutorial, options: {
      generatorProvider?: 'azure-claude' | 'azure-openai';
      reviewerProvider?: 'azure-claude' | 'azure-openai';
      enableReviewer?: boolean;
    })` | `Promise<TutorialContent>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant Caller as API/Controller
  participant TGS as TutorialGeneratorService
  participant Ctx as Context Builder<br/>(Phase 2.1/3)
  participant Gen as Generator Agent<br/>(Claude)
  participant Rev as Reviewer Agent<br/>(OpenAI)
  participant Store as Output/DB/Filesystem

  Caller->>TGS: generateTutorial(request)
  TGS->>Ctx: collect state machine + UI labels + screenshots
  Ctx-->>TGS: tutorial context package
  TGS->>Gen: create draft tutorial(context)
  Gen-->>TGS: draft tutorial content
  TGS->>Rev: review & refine(draft, context)
  Rev-->>TGS: approved/refined tutorial
  TGS->>Store: persist/return tutorial
  Store-->>Caller: tutorial result
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { TutorialGeneratorService } from './documentation/services/tutorial-generator.service';

@Injectable()
export class TutorialsControllerFacade {
  constructor(private readonly tutorialGenerator: TutorialGeneratorService) {}

  async generateBeginnerTutorial() {
    // Example request shape (adjust to your actual DTO/interface)
    const request = {
      // The single transition the tutorial should teach
      transition: {
        fromState: 'Draft',
        toState: 'Published',
        event: 'PUBLISH_CLICKED',
      },
      // UI constraints: exact button label(s) to reference
      ui: {
        primaryActionLabel: 'Publish',
        confirmActionLabel: 'Confirm publish',
      },
      // Optional: screenshot identifiers/URLs to reference in steps
      screenshots: [
        { id: 'editor-toolbar', description: 'Toolbar with Publish button' },
        { id: 'publish-confirmation', description: 'Publish confirmation modal' },
      ],
      audience: 'beginner',
      targetDurationMinutes: 3,
    };

    // Returns a tutorial artifact (e.g., markdown/steps + metadata)
    return this.tutorialGenerator.generateTutorial(request);
  }
}
```

## AI Coding Instructions

- Keep tutorials scoped to **one** state transition only; do not combine multiple transitions or “advanced” detours even if context includes them.
- When describing UI actions, **use exact button labels** from context (case-sensitive) and avoid inventing UI text; reference screenshots by their provided IDs/descriptions.
- Preserve the multi-agent flow: generator produces a draft, reviewer refines for beginner clarity; avoid bypassing review unless explicitly configured.
- Ensure the output stays within **2–5 minutes** and is step-based with clear “what to click” instructions tied to the state change being taught.
- When adding new context fields (state machine/UI/screenshot metadata), thread them through both generator and reviewer prompts to prevent hallucinated steps.

## Relationships

- DEPENDS_ON → `azureclaudeprovider`
- DEPENDS_ON → `azureopenaiprovider`

<!-- source: class-updatecategorydto.md -->

# UpdateCategoryDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/category.dto.ts` (line 60)

DTO for updating an existing category

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `icon` | `string` |
| `color` | `string` |
| `parentId` | `string` |
| `defaultDocId` | `string` |
| `order` | `number` |

<!-- source: function-usenewprojectwizard.md -->

# useNewProjectWizard

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/useNewProjectWizard.ts` (line 143)

## Signature

```ts
function useNewProjectWizard(apiClient: any)
```

## Parameters

| Name | Type |
|---|---|
| `apiClient` | `any` |

<!-- source: interface-userwithposition.md -->

# UserWithPosition

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/Editor/UserCursors.tsx` (line 10)

Extended user type with cursor position coordinates

## Properties

| Property | Type |
|---|---|
| `position` | `{
    x: number;
    y: number;
    /** Height of the line the cursor sits on, in pixels */
    height: number;
  }` |

<!-- source: interface-createsuggestiondto.md -->

# CreateSuggestionDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/suggestion.dto.ts` (line 15)

Create suggestion DTO

## Properties

| Property | Type |
|---|---|
| `originalText` | `string` |
| `suggestedText` | `string` |
| `positionStart` | `number` |
| `positionEnd` | `number` |

<!-- source: constant-flask-validation-patterns.md -->

# FLASK_VALIDATION_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/flask.patterns.ts` (line 107)

<!-- source: api-endpoint-get-2.md -->

# get

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/capture/capture.controller.ts` (line 55)

## Endpoint

`GET /capture/:projectId/flows/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `CaptureController` (MODULE_DECLARES)

<!-- source: function-getprioritystates.md -->

# getPriorityStates

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/coverage-calculator.ts` (line 393)

Get priority states that need screenshots

## Signature

```ts
function getPriorityStates(report: CoverageReport): Array<{
  stateMachine: string;
  state: string;
  priority: 'critical' | 'high' | 'medium';
  reason: string;
}>
```

## Parameters

| Name | Type |
|---|---|
| `report` | `CoverageReport` |

**Returns:** `Array<{
  stateMachine: string;
  state: string;
  priority: 'critical' | 'high' | 'medium';
  reason: string;
}>`

<!-- source: component-herodarkcentered-2.md -->

# HeroDarkCentered

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/hero/hero-dark-centered.tsx` (line 34)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `subheadlineKey` | `string` | ✓ | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `badgeKey` | `string` | - | - |
| `floatingStats` | `unknown[]` | - | - |
| `imageSrc` | `string` | - | - |
| `imageAlt` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_HeroDarkCentered_804c1f6["HeroDarkCentered"]
    class component_HeroDarkCentered_804c1f6 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- USES_HOOK → `useTranslation`

<!-- source: interface-parseerror-3.md -->

# ParseError

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/parse-result.interface.ts` (line 53)

Error encountered during parsing

## Properties

| Property | Type |
|---|---|
| `message` | `string` |
| `code` | `string` |
| `severity` | `'error' | 'warning'` |
| `line` | `number` |
| `column` | `number` |
| `filePath` | `string` |
| `stack` | `string` |
| `suggestion` | `string` |

<!-- source: interface-passatkresult.md -->

# PassAtKResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/types.ts` (line 129)

Per-task result for pass@k evaluation.

## Properties

| Property | Type |
|---|---|
| `taskId` | `string` |
| `k` | `number` |
| `attempts` | `TaskResult[]` |
| `passedAny` | `boolean` |
| `firstPassAttempt` | `number` |

<!-- source: component-promptcard.md -->

# PromptCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/PromptLibrary.tsx` (line 110)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `prompt` | `PromptTemplate` | ✓ | - |
| `onEdit` | `Function` | ✓ | - |
| `onDelete` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PromptCard_158cdc5a["PromptCard"]
    class component_PromptCard_158cdc5a rootComponent
```

## Relationships

- RENDERS → `CategoryBadge`
- USES_HOOK → `useState`

## Referenced By

- `PromptLibrary` (RENDERS)

<!-- source: interface-revisionsnapshot.md -->

# RevisionSnapshot

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/services/document-revision.service.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `content` | `string` |
| `title` | `string` |
| `type` | `string` |
| `state` | `string` |
| `audienceIds` | `string[]` |
| `contentHtml` | `string` |
| `canRegenerate` | `boolean` |

<!-- source: function-types.md -->

# types

**Kind:** Function

**Source:** `atloria-monorepo/packages/types/src/lib/types.ts` (line 1)

## Signature

```ts
function types(): string
```

**Returns:** `string`

<!-- source: service-uianalyzerservice.md -->

# UIAnalyzerService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/ai/services/ui-analyzer.service.ts` (line 115)

UI Analyzer Service

Extracts UI elements, routes, interactions from frontend code
Builds comprehensive documentation for:
1. Manual testing
2. Playwright automation
3. Architecture understanding
4. Visual diagrams

Handles large codebases incrementally with progress tracking

## Methods

| Method | Signature | Returns |
|---|---|---|
| `analyzeApplication` | `analyzeApplication(options: {
    baseDir: string;
    framework: 'react' | 'angular' | 'vue';
    modules?: string[]; // Specific modules to analyze
    resume?: boolean; // Resume from last checkpoint
  })` | `Promise<ApplicationMap>` |
| `analyzeModule` | `analyzeModule(baseDir: string, modulePath: string, framework: 'react' | 'angular' | 'vue')` | `Promise<ModuleDocumentation>` |
| `generatePlaywrightTests` | `generatePlaywrightTests(pageDoc: PageDocumentation)` | `Promise<PlaywrightTestConfig>` |
| `exportDocumentation` | `exportDocumentation(map: ApplicationMap, format: 'markdown' | 'html' | 'json')` | `Promise<string>` |

## Relationships

- DEPENDS_ON → `filecontextservice`
- DEPENDS_ON → `aiservice`
- DEPENDS_ON → `prismaservice`

<!-- source: class-updatecolumndto.md -->

# UpdateColumnDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/boards/dto/column.dto.ts` (line 28)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `color` | `string` |
| `mapsToStatus` | `IssueStatus | null` |
| `wipLimit` | `number | null` |

<!-- source: function-useofflinesync.md -->

# useOfflineSync

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useOfflineSync.ts` (line 152)

Hook for offline document synchronization

Provides:
- Online/offline status detection
- Queuing updates when offline
- Automatic sync when back online
- Manual sync trigger
- Persistent storage in localStorage

## Signature

```ts
function useOfflineSync(options: UseOfflineSyncOptions): UseOfflineSyncReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseOfflineSyncOptions` |

**Returns:** `UseOfflineSyncReturn`

<!-- source: interface-usetemplatesoptions.md -->

# UseTemplatesOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useTemplates.ts` (line 20)

Options for useTemplates hook

## Properties

| Property | Type |
|---|---|
| `filters` | `TemplateFiltersDto` |
| `autoFetch` | `boolean` |

<!-- source: interface-createthemedto.md -->

# CreateThemeDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/theme.dto.ts` (line 6)

DTO for creating a new theme

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `organizationId` | `string` |
| `projectId` | `string` |
| `colors` | `ThemeColors` |
| `typography` | `ThemeTypography` |
| `layout` | `ThemeLayout` |
| `customCss` | `string` |
| `darkModeEnabled` | `boolean` |
| `darkModeDefault` | `string` |
| `darkModeColors` | `ThemeColors` |
| `whiteLabelEnabled` | `boolean` |
| `hidePoweredBy` | `boolean` |
| `customDomain` | `string` |
| `customFooter` | `string` |
| `audienceThemes` | `AudienceThemes` |

<!-- source: constant-focusring.md -->

# focusRing

**Kind:** Constant

**Source:** `atloria-monorepo/packages/ui-core/src/utils/styles.ts` (line 7)

Common CSS utilities and mixins for Atloria components

<!-- source: api-endpoint-get-3.md -->

# get

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 121)

## Endpoint

`GET /doc-versions/:projectId/:versionId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: function-getreactlifecyclemethods-2.md -->

# getReactLifecycleMethods

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 689)

Get lifecycle methods for React class components

## Signature

```ts
function getReactLifecycleMethods(): string[]
```

**Returns:** `string[]`

<!-- source: component-herogradientsplit-2.md -->

# HeroGradientSplit

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/hero/hero-gradient-split.tsx` (line 26)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `subheadlineKey` | `string` | ✓ | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `imageSrc` | `string` | ✓ | - |
| `imageAlt` | `string` | ✓ | - |
| `badges` | `unknown[]` | - | - |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_HeroGradientSplit_3ffb7904["HeroGradientSplit"]
    class component_HeroGradientSplit_3ffb7904 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- RENDERS → `motion-span`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: interface-parseerror-4.md -->

# ParseError

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/storybook/types.ts` (line 180)

Parse error

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `message` | `string` |
| `line` | `number` |
| `column` | `number` |
| `stack` | `string` |

<!-- source: interface-phase.md -->

# Phase

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/orchestrator.ts` (line 68)

A phase in a multi-agent workflow

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `agents` | `AgentTemplate[]` |
| `requiresApproval` | `boolean` |
| `synthesize` | `(results: AgentResult[]) => string` |
| `maxTurnsPerAgent` | `number` |

<!-- source: component-promptform.md -->

# PromptForm

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/PromptLibrary.tsx` (line 173)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `initialData` | `PromptTemplate` | - | - |
| `onSave` | `Function` | ✓ | - |
| `onCancel` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PromptForm_158b4aa6["PromptForm"]
    class component_PromptForm_158b4aa6 rootComponent
```

## Relationships

- USES_HOOK → `useState`

## Referenced By

- `PromptLibrary` (RENDERS)

<!-- source: interface-savedocumentresult.md -->

# SaveDocumentResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/collaboration/interfaces/collaboration.interfaces.ts` (line 87)

Result of saving document state

## Properties

| Property | Type |
|---|---|
| `success` | `boolean` |
| `version` | `number` |
| `savedAt` | `Date` |

<!-- source: function-uicore.md -->

# uiCore

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-core/src/lib/ui-core.ts` (line 1)

## Signature

```ts
function uiCore(): string
```

**Returns:** `string`

<!-- source: class-updatecommentdto.md -->

# UpdateCommentDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/comment/dto/update-comment.dto.ts` (line 7)

DTO for updating an existing comment

## Properties

| Property | Type |
|---|---|
| `content` | `string` |

<!-- source: service-urlservice.md -->

# UrlService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/document/services/url.service.ts` (line 27)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `generateUrlId` | `generateUrlId(maxAttempts: unknown)` | `Promise<string>` |
| `generateCollectionUrlId` | `generateCollectionUrlId(maxAttempts: unknown)` | `Promise<string>` |
| `generateProjectUrlId` | `generateProjectUrlId(maxAttempts: unknown)` | `Promise<string>` |
| `buildProjectUrl` | `buildProjectUrl(slug: string, urlId: string)` | `string` |
| `parseProjectUrl` | `parseProjectUrl(path: string)` | `{ slug: string; urlId: string } | null` |
| `generateSlug` | `generateSlug(title: string)` | `string` |
| `parseDocumentUrl` | `parseDocumentUrl(path: string)` | `ParsedDocumentUrl | null` |
| `buildDocumentUrl` | `buildDocumentUrl(slug: string, urlId: string, audience: string)` | `string` |
| `buildCollectionUrl` | `buildCollectionUrl(slug: string, urlId: string)` | `string` |
| `isValidUrlId` | `isValidUrlId(urlId: string)` | `boolean` |
| `isValidSlug` | `isValidSlug(slug: string)` | `boolean` |
| `isValidAudienceSlug` | `isValidAudienceSlug(slug: string)` | `boolean` |
| `extractUrlIdFromPath` | `extractUrlIdFromPath(path: string)` | `string | null` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: function-usepagetracking.md -->

# usePageTracking

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/lib/analytics/usePageTracking.ts` (line 182)

Hook to track page views with time on page and scroll depth

Best practices implemented:
1. Session-based tracking (browser session)
2. Time on page measurement
3. Scroll depth tracking
4. Debounced scroll events
5. Beacon API for reliable tracking on page unload
6. No PII collection (anonymous tracking)

## Signature

```ts
function usePageTracking(options: PageTrackingOptions)
```

## Parameters

| Name | Type |
|---|---|
| `options` | `PageTrackingOptions` |

<!-- source: interface-usetemplatesreturn.md -->

# UseTemplatesReturn

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/hooks/useTemplates.ts` (line 28)

Return type for useTemplates hook

## Properties

| Property | Type |
|---|---|
| `templates` | `DocumentTemplate[]` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `refresh` | `() => Promise<void>` |
| `getTemplate` | `(id: string) => Promise<DocumentTemplate>` |
| `useTemplate` | `(id: string, dto: CreateFromTemplateDto) => Promise<Document>` |
| `saveAsTemplate` | `(documentId: string, dto: SaveAsTemplateDto) => Promise<DocumentTemplate>` |
| `categories` | `TemplateCategory[]` |

<!-- source: interface-createuserdto.md -->

# CreateUserDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/user.dto.ts` (line 6)

DTO for creating a new user

## Properties

| Property | Type |
|---|---|
| `email` | `string` |
| `name` | `string` |
| `passwordHash` | `string` |
| `role` | `UserRole` |
| `organizationId` | `string` |

<!-- source: constant-formattingvisitors.md -->

# formattingVisitors

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/MdastFormattingVisitor.ts` (line 87)

<!-- source: api-endpoint-get-4.md -->

# get

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/category.controller.ts` (line 70)

Get a single category

## Endpoint

`GET /categories/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `CategoryController` (MODULE_DECLARES)

<!-- source: function-groupbyenvironment.md -->

# groupByEnvironment

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/deployment-diagram.generator.ts` (line 617)

Group nodes by deployment environment

## Signature

```ts
function groupByEnvironment(nodes: DeploymentNode[]): Map<string, DeploymentNode[]>
```

## Parameters

| Name | Type |
|---|---|
| `nodes` | `DeploymentNode[]` |

**Returns:** `Map<string, DeploymentNode[]>`

<!-- source: component-herominimalcentered-2.md -->

# HeroMinimalCentered

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/hero/hero-minimal-centered.tsx` (line 28)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `subheadlineKey` | `string` | ✓ | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `badgeKey` | `string` | - | - |
| `badgeIcon` | `LucideIcon` | - | - |
| `dividerIcons` | `LucideIcon[]` | - | - |
| `imageSrc` | `string` | - | - |
| `imageAlt` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_HeroMinimalCentered_2e836aac["HeroMinimalCentered"]
    class component_HeroMinimalCentered_2e836aac rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `BadgeIcon`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: interface-parsefileinput-2.md -->

# ParseFileInput

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/parser.interface.ts` (line 42)

Input for parsing a file

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `content` | `string` |
| `metadata` | `Record<string, unknown>` |

<!-- source: interface-phaseresult.md -->

# PhaseResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/orchestrator.ts` (line 89)

Result of executing a single phase

## Properties

| Property | Type |
|---|---|
| `phaseId` | `string` |
| `agentResults` | `AgentResult[]` |
| `synthesis` | `string` |
| `totalUsage` | `TokenUsage` |
| `durationMs` | `number` |

<!-- source: component-propertyrow.md -->

# PropertyRow

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/[ticketId]/page.tsx` (line 292)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `label` | `string` | ✓ | - |
| `icon` | `unknown` | - | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PropertyRow_2c1b40be["PropertyRow"]
    class component_PropertyRow_2c1b40be rootComponent
```

## Relationships

- RENDERS → `Icon`

## Referenced By

- `IssueDetailPageInner` (RENDERS)

<!-- source: interface-screenshotstatus.md -->

# ScreenshotStatus

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/doc-version/screenshot-staleness.service.ts` (line 5)

## Properties

| Property | Type |
|---|---|
| `routePath` | `string` |
| `status` | `StalenessLevel` |
| `assetUrl` | `string` |
| `capturedAt` | `string` |
| `fromVersionNumber` | `number` |
| `age` | `number` |
| `reason` | `string` |

<!-- source: class-updatedocautomationconfigdto.md -->

# UpdateDocAutomationConfigDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/documentation/dto/doc-automation.dto.ts` (line 219)

## Properties

| Property | Type |
|---|---|
| `repositoryUrl` | `string` |
| `repositoryBranch` | `string` |
| `frontendPath` | `string` |
| `backendPath` | `string` |
| `siteUrl` | `string` |
| `siteLoginUrl` | `string` |
| `siteEmail` | `string` |
| `sitePassword` | `string` |
| `repoUsername` | `string` |
| `repoPassword` | `string` |
| `skeletonStructure` | `SkeletonStructureDto` |
| `includeApiDocs` | `boolean` |
| `includeDiagrams` | `boolean` |
| `includeScreenshots` | `boolean` |
| `aiEnhancement` | `boolean` |
| `outputFormat` | `string` |
| `screenshotFormat` | `string` |
| `screenshotQuality` | `number` |
| `maxConcurrency` | `number` |
| `timeout` | `number` |
| `excludePatterns` | `string[]` |
| `targetAudience` | `string` |
| `autoPublish` | `boolean` |
| `businessDomain` | `string` |

<!-- source: function-useactivesection.md -->

# useActiveSection

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useActiveSection.ts` (line 22)

## Signature

```ts
function useActiveSection(headingIds: string[]): {
  activeId: string | null;
  setActiveId: (id: string | null) => void;
}
```

## Parameters

| Name | Type |
|---|---|
| `headingIds` | `string[]` |

**Returns:** `{
  activeId: string | null;
  setActiveId: (id: string | null) => void;
}`

<!-- source: function-useparser.md -->

# useParser

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useParser.ts` (line 24)

Custom hook for parsing code

## Signature

```ts
function useParser(options: UseParserOptions): UseParserReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseParserOptions` |

**Returns:** `UseParserReturn`

<!-- source: service-userdocsgeneratorservice.md -->

# UserDocsGeneratorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/user-docs-generator.service.ts` (line 67)

Multi-agent service for generating user documentation

Architecture:
1. Generator Agent (Azure Claude) - Creates initial documentation
2. Reviewer Agent (Azure OpenAI) - Humanizes and improves language (optional)

`UserDocsGeneratorService` is a NestJS backend service that orchestrates a multi-agent pipeline to generate end-user documentation from internal inputs (e.g., domain context, feature notes, or source artifacts). It delegates first-pass drafting to a “Generator” agent (Azure Claude) and can optionally pass the draft through a “Reviewer” agent (Azure OpenAI) to improve tone, clarity, and human readability. This service sits in the API layer and acts as the coordination point between application code and external LLM providers.

## Methods

| Method | Signature | Returns |
|---|---|---|
| `setCompetitorContext` | `setCompetitorContext(competitorContext: string | null)` | `void` |
| `generateDocumentation` | `generateDocumentation(appMap: any, screenshots: Record<string, any[]>, workflows: DetectedWorkflow[], businessContext: {
      marketing: string[];
      workflows: string[];
      brand: string[];
      processes: string[];
    }, options: {
      generatorProvider?: 'azure-claude' | 'azure-openai';
      reviewerProvider?: 'azure-claude' | 'azure-openai';
      enableReviewer?: boolean;
      competitorContext?: string; // NEW: Optional competitor docs context
    })` | `Promise<GeneratedDocumentation>` |
| `generateDocumentationWithSaving` | `generateDocumentationWithSaving(projectId: string, user: JwtPayload, appMap: any, screenshots: Record<string, any[]>, workflows: DetectedWorkflow[], businessContext: {
      marketing: string[];
      workflows: string[];
      brand: string[];
      processes: string[];
    }, options: {
      generatorProvider?: 'azure-claude' | 'azure-openai';
      reviewerProvider?: 'azure-claude' | 'azure-openai';
      enableReviewer?: boolean;
      competitorContext?: string;
    })` | `Promise<SyncBatchResponseDto>` |

## Diagram

```mermaid
sequenceDiagram
  autonumber
  participant Caller as API/Controller/Job
  participant Service as UserDocsGeneratorService
  participant Gen as Generator Agent (Azure Claude)
  participant Rev as Reviewer Agent (Azure OpenAI, optional)

  Caller->>Service: generateUserDocs(input, options)
  Service->>Gen: createInitialDocumentation(input)
  Gen-->>Service: draftDocs

  alt reviewer enabled
    Service->>Rev: refineLanguage(draftDocs)
    Rev-->>Service: reviewedDocs
    Service-->>Caller: reviewedDocs
  else reviewer disabled
    Service-->>Caller: draftDocs
  end
```

## Usage

```ts
import { Injectable } from '@nestjs/common';
import { UserDocsGeneratorService } from './documentation/services/user-docs-generator.service';

@Injectable()
export class DocsJob {
  constructor(private readonly userDocs: UserDocsGeneratorService) {}

  async run() {
    const input = {
      productName: 'Atloria',
      audience: 'End users',
      features: [
        { name: 'Workspaces', notes: 'Create and organize projects and docs.' },
        { name: 'Search', notes: 'Find content across the workspace.' },
      ],
      constraints: {
        tone: 'Clear, friendly, non-technical',
        format: 'Markdown',
      },
    };

    // Optionally enable a second pass to humanize wording and improve flow.
    const options = { reviewerEnabled: true };

    const docsMarkdown = await this.userDocs.generateUserDocs(input, options);

    // Persist, return, or publish documentation content.
    return docsMarkdown;
  }
}
```

## AI Coding Instructions

- Keep the service as an **orchestrator**: generation logic lives in the agent adapters/clients; this service should coordinate steps, inputs, and outputs.
- Treat the Reviewer step as **optional** and make it a clear, explicit flag; avoid silently adding reviewer calls (cost/latency).
- Normalize and validate the model inputs (tone/format/audience) before sending to providers to prevent prompt drift and inconsistent outputs.
- Handle provider failures deterministically: timeouts, retries, and fallbacks should be centralized so callers get a predictable error/result shape.

## Relationships

- DEPENDS_ON → `azureclaudeprovider`
- DEPENDS_ON → `azureopenaiprovider`
- DEPENDS_ON → `syncservice`

<!-- source: interface-wizardstate.md -->

# WizardState

**Kind:** Interface

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/useNewProjectWizard.ts` (line 7)

## Properties

| Property | Type |
|---|---|
| `currentScene` | `WizardScene` |
| `completedSteps` | `number[]` |
| `repoUrl` | `string` |
| `detectedProvider` | `'github' | 'gitlab' | 'bitbucket' | null` |
| `detectedOwner` | `string` |
| `detectedRepo` | `string` |
| `projectName` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `branch` | `string` |
| `frontendPath` | `string` |
| `backendPath` | `string` |
| `siteUrl` | `string` |
| `loginUrl` | `string` |
| `siteEmail` | `string` |
| `sitePassword` | `string` |
| `needsAuth` | `boolean` |
| `authMethod` | `'token' | 'ssh' | null` |
| `repoUsername` | `string` |
| `accessToken` | `string` |
| `connectionTested` | `boolean` |
| `githubConnected` | `boolean` |
| `gitlabConnected` | `boolean` |
| `bitbucketConnected` | `boolean` |
| `selectedDocTypes` | `string[]` |
| `createdProjectId` | `string | null` |

<!-- source: interface-crosslanguagemapping.md -->

# CrossLanguageMapping

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/cross-language.types.ts` (line 23)

CrossLanguageMapping - Links frontend to backend for user journey docs

Example: When user clicks "Submit Order":
- React: OrderForm.tsx -> POST /api/orders -> Express/NestJS route
- Angular: OrderFormComponent.ts -> POST /api/orders -> .NET Controller
- Vue: OrderForm.vue -> POST /api/orders -> FastAPI endpoint

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `frontendStack` | `FrontendFramework` |
| `backendStack` | `BackendFramework` |
| `screenMappings` | `ScreenToApiMapping[]` |
| `apiCallPatterns` | `ApiCallPattern[]` |

<!-- source: constant-framework-detection-configs.md -->

# FRAMEWORK_DETECTION_CONFIGS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/framework.types.ts` (line 173)

Default framework detection configurations

## Definition

```ts
FrameworkDetectionConfig[]
```

<!-- source: api-endpoint-get-5.md -->

# get

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 116)

## Endpoint

`GET /documents/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: function-hashstring-2.md -->

# hashString

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 610)

Simple hash function for generating unique IDs

## Signature

```ts
function hashString(str: string): string
```

## Parameters

| Name | Type |
|---|---|
| `str` | `string` |

**Returns:** `string`

<!-- source: component-herowavesplit-2.md -->

# HeroWaveSplit

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/hero/hero-wave-split.tsx` (line 23)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `subheadlineKey` | `string` | ✓ | - |
| `primaryCtaKey` | `string` | ✓ | - |
| `primaryCtaUrl` | `string` | ✓ | - |
| `secondaryCtaKey` | `string` | - | - |
| `secondaryCtaUrl` | `string` | - | - |
| `imageSrc` | `string` | ✓ | - |
| `imageAlt` | `string` | ✓ | - |
| `stats` | `unknown[]` | - | - |
| `trustTextKey` | `string` | - | - |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_HeroWaveSplit_4fd6800e["HeroWaveSplit"]
    class component_HeroWaveSplit_4fd6800e rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `ArrowRight`
- USES_HOOK → `useTranslation`

<!-- source: interface-parsemetadata-2.md -->

# ParseMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/parse-result.interface.ts` (line 144)

Metadata about the parse operation

## Properties

| Property | Type |
|---|---|
| `duration` | `number` |
| `linesOfCode` | `number` |
| `fileSize` | `number` |
| `language` | `string` |
| `framework` | `string` |
| `fileHash` | `string` |
| `complexity` | `number` |

<!-- source: interface-planmodefilteroptions.md -->

# PlanModeFilterOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/plan-mode-filter.ts` (line 37)

## Properties

| Property | Type |
|---|---|
| `additionalAllowed` | `string[]` |
| `additionalBlocked` | `string[]` |
| `blockMessage` | `string` |

<!-- source: component-providerselector.md -->

# ProviderSelector

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/AIAssistant.tsx` (line 265)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `providers` | `Array` | ✓ | - |
| `selectedProvider` | `string` | ✓ | - |
| `onSelect` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ProviderSelector_76e8d801["ProviderSelector"]
    class component_ProviderSelector_76e8d801 rootComponent
```

## Relationships

- RENDERS → `ChevronDown`
- USES_HOOK → `useState`

## Referenced By

- `AIAssistant` (RENDERS)

<!-- source: interface-searchdocument.md -->

# SearchDocument

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/azure-search.service.ts` (line 14)

Document to be indexed in Azure AI Search

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `documentType` | `'workflow' | 'feature' | 'tutorial' | 'user_manual' | 'technical_ref'` |
| `title` | `string` |
| `description` | `string` |
| `content` | `string` |
| `keywords` | `string[]` |
| `category` | `string` |
| `categoryId` | `string` |
| `categoryPath` | `string` |
| `collectionId` | `string` |
| `collectionName` | `string` |
| `parentDocumentId` | `string` |
| `parentDocumentTitle` | `string` |
| `breadcrumbs` | `string[]` |
| `difficulty` | `string` |
| `estimatedTime` | `string` |
| `audiences` | `string[]` |
| `createdAt` | `Date` |
| `updatedAt` | `Date` |
| `docVersionId` | `string` |
| `versionNumber` | `number` |

<!-- source: class-updatedocumentdto.md -->

# UpdateDocumentDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/update-document.dto.ts` (line 5)

**Extends:** `PartialType(CreateDocumentDto)`

<!-- source: function-useapiclient.md -->

# useAPIClient

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-react/src/providers/AtloriaProvider.tsx` (line 78)

Hook to access the API client

## Signature

```ts
function useAPIClient(): APIClient
```

**Returns:** `APIClient`

<!-- source: function-usepme.md -->

# usePme

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/usePme.ts` (line 24)

<!-- source: service-versionaccessguard.md -->

# VersionAccessGuard

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/doc-version/version-access.guard.ts` (line 4)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `canActivate` | `canActivate(context: ExecutionContext)` | `Promise<boolean>` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: interface-crossmodulerelationship.md -->

# CrossModuleRelationship

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-05.types.ts` (line 23)

## Properties

| Property | Type |
|---|---|
| `sourceArea` | `string` |
| `targetArea` | `string` |
| `sharedEntities` | `string[]` |
| `strength` | `number` |

<!-- source: constant-framework-types.md -->

# FRAMEWORK_TYPES

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 23)

Supported framework types

<!-- source: api-endpoint-get-6.md -->

# get

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/invitation/invitation.controller.ts` (line 26)

## Endpoint

`GET /invitations/:token`

| Parameter | In | Type | Required |
|---|---|---|---|
| `token` | query | `string` | ✓ |

## Referenced By

- `InvitationController` (MODULE_DECLARES)

<!-- source: function-hasjsxinpath-2.md -->

# hasJSXInPath

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 56)

Check if an AST node contains JSX

## Signature

```ts
function hasJSXInPath(path: NodePath): boolean
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath` |

**Returns:** `boolean`

<!-- source: component-highlighttoggle.md -->

# HighlightToggle

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/HighlightToggle.tsx` (line 11)

## Diagram

```mermaid
graph TD
    component_HighlightToggle_5db46bbf["HighlightToggle"]
    class component_HighlightToggle_5db46bbf rootComponent
```

## Relationships

- RENDERS → `MultipleChoiceToggleGroup`
- USES_HOOK → `useCellValues`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useTranslation`

<!-- source: interface-parseprojectconfig-2.md -->

# ParseProjectConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/config.interface.ts` (line 16)

Project parse configuration

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `parsers` | `string[]` |
| `includePatterns` | `string[]` |
| `excludePatterns` | `string[]` |
| `incremental` | `boolean` |
| `maxFiles` | `number` |
| `parallel` | `boolean` |
| `concurrency` | `number` |
| `metadata` | `Record<string, unknown>` |

<!-- source: interface-pluginmanifest.md -->

# PluginManifest

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/plugins/plugin-types.ts` (line 16)

Plugin System Type Definitions

Defines the contract for Atloria's plugin architecture. Plugins let users
extend the agent with custom commands, agents, skills, and hooks by dropping
markdown files with YAML frontmatter into a plugins directory.

Inspired by Claude Code's plugin architecture.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `description` | `string` |
| `author` | `string | { name: string; email?: string }` |

<!-- source: component-publicprojectlayoutinner.md -->

# PublicProjectLayoutInner

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/PublicLayoutShell.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PublicProjectLayoutInner_16664031["PublicProjectLayoutInner"]
    class component_PublicProjectLayoutInner_16664031 rootComponent
```

## Relationships

- RENDERS → `HeaderByStyle`
- RENDERS → `ChevronLeft`
- RENDERS → `ChevronRight`
- RENDERS → `VersionSeoHead`
- RENDERS → `VersionBanners`
- RENDERS → `SupportChatWidget`
- USES_HOOK → `usePublicProjectContext`
- USES_HOOK → `usePathname`
- USES_HOOK → `useVersionContext`
- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

## Referenced By

- `PublicLayoutShell` (RENDERS)

<!-- source: interface-searchdocumentsresult.md -->

# SearchDocumentsResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/dto/search-document.dto.ts` (line 115)

Search result response

## Properties

| Property | Type |
|---|---|
| `results` | `any[]` |
| `total` | `number` |
| `facets` | `SearchFacets` |
| `query` | `string` |
| `took` | `number` |

<!-- source: class-updatedocversiondto.md -->

# UpdateDocVersionDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/doc-version/dto/doc-version.dto.ts` (line 41)

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `description` | `string` |

<!-- source: function-useatloriacontext.md -->

# useAtloriaContext

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-react/src/providers/AtloriaProvider.tsx` (line 59)

Hook to access the Atloria context

## Signature

```ts
function useAtloriaContext(): AtloriaContextValue
```

**Returns:** `AtloriaContextValue`

<!-- source: function-useprojectmembers.md -->

# useProjectMembers

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useProjectMembers.ts` (line 66)

useProjectMembers - Hook for fetching project/organization members

Used for

## Signature

```ts
function useProjectMembers(options: UseProjectMembersOptions): UseProjectMembersReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseProjectMembersOptions` |

**Returns:** `UseProjectMembersReturn`

<!-- source: service-versioncarryforwardservice.md -->

# VersionCarryForwardService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/doc-version/carry-forward.service.ts` (line 20)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `carryForward` | `carryForward(newVersionId: string)` | `Promise<CarryForwardResult>` |
| `resolveFlag` | `resolveFlag(previousDocId: string, newVersionId: string, action: 'keep_previous' | 'use_new' | 'discard')` | `Promise<void>` |
| `extractPlaceholders` | `extractPlaceholders(docs: Array<{ id: string; content: string }>)` | `Array<{ text: string; routePath: string; documentId: string }>` |
| `carryForwardScreenshots` | `carryForwardScreenshots(previousVersionId: string, newVersionId: string)` | `Promise<{ carried: number; missing: number }>` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `docversionservice`

<!-- source: interface-crossstackevidence.md -->

# CrossStackEvidence

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-03-features/cross-stack-mapper.ts` (line 29)

Evidence for a cross-stack mapping

## Properties

| Property | Type |
|---|---|
| `frontendSnippet` | `string` |
| `backendSnippet` | `string` |
| `matchedPath` | `string` |
| `matchedName` | `string` |

<!-- source: constant-frontmatterdialogopen.md -->

# frontmatterDialogOpen$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/frontmatter/index.ts` (line 34)

Whether the frontmatter dialog is open.

<!-- source: api-endpoint-get-7.md -->

# get

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/organization/organization.controller.ts` (line 51)

## Endpoint

`GET /organizations/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `OrganizationController` (MODULE_DECLARES)

<!-- source: component-howitworkscardsgrid-2.md -->

# HowItWorksCardsGrid

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/how-it-works/how-it-works-cards-grid.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `labelKey` | `string` | - | - |
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `steps` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_HowItWorksCardsGrid_1987d9c3["HowItWorksCardsGrid"]
    class component_HowItWorksCardsGrid_1987d9c3 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-span`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `StepIndicator`
- USES_HOOK → `useTranslation`

<!-- source: function-impactedentities.md -->

# impactedEntities

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/staleness.ts` (line 82)

Given the files that changed in a push, return the set of entity ids that must be
regenerated: the entities DEFINED in those files, expanded to their dependents (things that
reference them) up to `hops` levels via the relationship graph. This is the SCIP-style
incremental fan-out — regenerate the transitive closure, not the whole repo.

## Signature

```ts
function impactedEntities(changedFiles: string[], entities: Entity[], relationships: Relationship[], opts: { hops?: number }): Set<string>
```

## Parameters

| Name | Type |
|---|---|
| `changedFiles` | `string[]` |
| `entities` | `Entity[]` |
| `relationships` | `Relationship[]` |
| `opts` | `{ hops?: number }` |

**Returns:** `Set<string>`

<!-- source: interface-parserconfig-2.md -->

# ParserConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/parser.interface.ts` (line 16)

Configuration for parser initialization

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `tsconfigPath` | `string` |
| `options` | `Record<string, unknown>` |
| `debug` | `boolean` |
| `excludePatterns` | `string[]` |
| `maxFileSize` | `number` |
| `timeout` | `number` |

<!-- source: interface-preflightcheck.md -->

# PreflightCheck

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/test-watcher.ts` (line 284)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `check` | `() => PreflightResult` |

<!-- source: component-quickactionbutton.md -->

# QuickActionButton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/PromptInput.tsx` (line 157)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `icon` | `unknown` | ✓ | - |
| `label` | `string` | ✓ | - |
| `onClick` | `Function` | - | - |
| `disabled` | `boolean` | - | - |

## Diagram

```mermaid
graph TD
    component_QuickActionButton_74cffc6c["QuickActionButton"]
    class component_QuickActionButton_74cffc6c rootComponent
```

## Referenced By

- `PromptInput` (RENDERS)

<!-- source: interface-searchfacets.md -->

# SearchFacets

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/dto/search-document.dto.ts` (line 105)

Search facets for filtering

## Properties

| Property | Type |
|---|---|
| `byState` | `Record<string, number>` |
| `byType` | `Record<string, number>` |
| `byAuthor` | `Record<string, number>` |
| `byCategory` | `Record<string, number>` |

<!-- source: class-updateflowstepsdto.md -->

# UpdateFlowStepsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/capture/dto/update-flow.dto.ts` (line 25)

Owner edits to a captured flow's step list (F2 step-list editor).

The client sends the FULL desired ordered array — reorders, caption edits,
deletions and redaction boxes already applied. The service re-sanitizes +
re-redacts every value (defense in depth) and re-indexes `order` before storing,
so a tampered client can never smuggle a secret back in.

## Properties

| Property | Type |
|---|---|
| `steps` | `CapturedStepDto[]` |

<!-- source: function-useaudiences.md -->

# useAudiences

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useAudiences.ts` (line 68)

useAudiences - Hook for managing audience data

Provides a list of audiences with CRUD operations.

## Signature

```ts
function useAudiences(options: UseAudiencesOptions): UseAudiencesReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseAudiencesOptions` |

**Returns:** `UseAudiencesReturn`

<!-- source: function-useprojectpublish.md -->

# useProjectPublish

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useProjectPublish.ts` (line 68)

useProjectPublish - Hook for publishing and unpublishing projects

Provides a simple interface for changing project publication state.
Requires MAINTAINER or ADMIN role.

## Signature

```ts
function useProjectPublish(): UseProjectPublishReturn
```

**Returns:** `UseProjectPublishReturn`

<!-- source: service-versiondiffservice.md -->

# VersionDiffService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/doc-version/version-diff.service.ts` (line 54)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `compareVersions` | `compareVersions(versionAId: string, versionBId: string)` | `Promise<VersionDiff>` |
| `diffDocument` | `diffDocument(docIdA: string, docIdB: string)` | `unknown` |
| `computeDiffStats` | `computeDiffStats(contentA: string, contentB: string)` | `DiffStats` |

## Relationships

- DEPENDS_ON → `prismaservice`

<!-- source: interface-crossstackfeature.md -->

# CrossStackFeature

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-03-features/cross-stack-mapper.ts` (line 39)

Cross-stack feature (full-stack feature)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `frontendComponents` | `string[]` |
| `backendEndpoints` | `string[]` |
| `dataFlow` | `DataFlowStep[]` |
| `actions` | `UserAction[]` |
| `confidence` | `number` |

<!-- source: constant-frontmatterplugin.md -->

# frontmatterPlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/frontmatter/index.ts` (line 91)

A plugin that adds support for frontmatter.

<!-- source: api-endpoint-get-8.md -->

# get

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 76)

## Endpoint

`GET /projects/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: component-howitworkshorizontal-2.md -->

# HowItWorksHorizontal

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/how-it-works/how-it-works-horizontal.tsx` (line 16)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `labelKey` | `string` | - | - |
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `steps` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_HowItWorksHorizontal_519d839e["HowItWorksHorizontal"]
    class component_HowItWorksHorizontal_519d839e rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-span`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `StepIndicator`
- USES_HOOK → `useTranslation`

<!-- source: function-isangularfile.md -->

# isAngularFile

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/framework-detect.ts` (line 48)

True for a file that imports from any '@angular/…' package.

## Signature

```ts
function isAngularFile(filePath: string, content: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |
| `content` | `string` |

**Returns:** `boolean`

<!-- source: interface-parseresult-3.md -->

# ParseResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/parse-result.interface.ts` (line 208)

Result of parsing a single file

## Properties

| Property | Type |
|---|---|
| `parserName` | `string` |
| `filePath` | `string` |
| `timestamp` | `Date` |
| `status` | `ParseStatus` |
| `entities` | `Entity[]` |
| `relationships` | `Relationship[]` |
| `errors` | `ParseError[]` |
| `warnings` | `ParseWarning[]` |
| `metadata` | `ParseMetadata` |

<!-- source: interface-preflightconfig.md -->

# PreflightConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/test-watcher.ts` (line 295)

## Properties

| Property | Type |
|---|---|
| `cwd` | `string` |
| `testCommand` | `string` |
| `customChecks` | `PreflightCheck[]` |

<!-- source: component-recenttickets.md -->

# RecentTickets

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/page.tsx` (line 488)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `items` | `any[]` | ✓ | - |
| `onOpen` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_RecentTickets_5067c2eb["RecentTickets"]
    class component_RecentTickets_5067c2eb rootComponent
```

## Relationships

- RENDERS → `Badge`
- RENDERS → `ArrowTopRightOnSquareIcon`

## Referenced By

- `IssuesListPage` (RENDERS)

<!-- source: interface-searchoptions.md -->

# SearchOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/azure-search.service.ts` (line 54)

Search query options

## Properties

| Property | Type |
|---|---|
| `organizationId` | `string` |
| `projectId` | `string` |
| `documentType` | `'workflow' | 'feature' | 'tutorial' | 'user_manual' | 'technical_ref'` |
| `category` | `string` |
| `difficulty` | `'beginner' | 'intermediate' | 'advanced'` |
| `audience` | `string` |
| `docVersionId` | `string` |
| `limit` | `number` |
| `offset` | `number` |
| `includeFacets` | `boolean` |

<!-- source: class-updateissuedto.md -->

# UpdateIssueDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/issues/dto/update-issue.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `status` | `IssueStatus` |
| `priority` | `IssuePriority` |
| `assigneeId` | `string | null` |
| `closedReason` | `IssueCloseReason` |
| `description` | `string` |

<!-- source: function-useauth-3.md -->

# useAuth

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useAuth.ts` (line 39)

useAuth - Hook for authentication

Provides user state and authentication methods.
All business logic is handled by the backend.

## Signature

```ts
function useAuth(): UseAuthReturn
```

**Returns:** `UseAuthReturn`

<!-- source: function-usepublicprojectcontext.md -->

# usePublicProjectContext

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/project-context.tsx` (line 253)

<!-- source: service-webcrawlerservice.md -->

# WebCrawlerService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/web-crawler.service.ts` (line 19)

Simple web crawler for documentation pages
Fetches and converts HTML to markdown

## Methods

| Method | Signature | Returns |
|---|---|---|
| `crawlPage` | `crawlPage(url: string)` | `Promise<CrawledPage | null>` |
| `crawlPages` | `crawlPages(urls: string[], concurrency: unknown)` | `Promise<CrawledPage[]>` |
| `extractText` | `extractText(page: CrawledPage)` | `string` |
| `summarize` | `summarize(page: CrawledPage, maxLength: unknown)` | `string` |
| `validateUrl` | `validateUrl(url: string)` | `Promise<boolean>` |
| `healthCheck` | `healthCheck()` | `Promise<boolean>` |

<!-- source: interface-crossstackmapping.md -->

# CrossStackMapping

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-03-features/cross-stack-mapper.ts` (line 17)

A cross-stack mapping between frontend and backend

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `frontendEntity` | `string` |
| `backendEntity` | `string` |
| `type` | `'api-call' | 'route-match' | 'name-correlation'` |
| `confidence` | `'high' | 'medium' | 'low'` |
| `evidence` | `CrossStackEvidence` |

<!-- source: api-endpoint-getaccess.md -->

# getAccess

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 526)

## Endpoint

`GET /doc-versions/:projectId/:versionId/access`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: constant-hasfrontmatter.md -->

# hasFrontmatter$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/frontmatter/index.ts` (line 77)

Whether the markdown document has a frontmatter node.

<!-- source: component-howitworkstimeline-2.md -->

# HowItWorksTimeline

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/how-it-works/how-it-works-timeline.tsx` (line 59)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `steps` | `Step[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_HowItWorksTimeline_41381868["HowItWorksTimeline"]
    class component_HowItWorksTimeline_41381868 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `StepCircle`
- RENDERS → `StepCard`
- USES_HOOK → `useTranslation`

<!-- source: function-isjunkentity.md -->

# isJunkEntity

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/significance.ts` (line 47)

True when an entity should never get a reference page / nav entry / search doc.

## Signature

```ts
function isJunkEntity(entity: SignificanceCheckable): boolean
```

## Parameters

| Name | Type |
|---|---|
| `entity` | `SignificanceCheckable` |

**Returns:** `boolean`

<!-- source: interface-parseresult-4.md -->

# ParseResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/storybook/types.ts` (line 166)

Parse result

## Properties

| Property | Type |
|---|---|
| `files` | `StoryFile[]` |
| `config` | `ConfigInfo` |
| `totalStories` | `number` |
| `errors` | `ParseError[]` |

<!-- source: interface-preflightresult.md -->

# PreflightResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/test-watcher.ts` (line 289)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `passed` | `boolean` |
| `message` | `string` |

<!-- source: component-redactioncanvas.md -->

# RedactionCanvas

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/StepEditor.tsx` (line 386)

Draw/clear rectangular redaction regions on a step's screenshot. Coordinates are stored as PERCENT (0-100) of the natural image so they survive re-shoots at any viewport. Drag to add a box; click an existing box to remove it.

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `src` | `string` | - | - |
| `boxes` | `RedactBox[]` | ✓ | - |
| `onChange` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_RedactionCanvas_2030974d["RedactionCanvas"]
    class component_RedactionCanvas_2030974d rootComponent
```

## Relationships

- USES_HOOK → `useRef`
- USES_HOOK → `useState`

## Referenced By

- `StepEditor` (RENDERS)

<!-- source: interface-searchquery.md -->

# SearchQuery

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/web-search/interfaces/search.interfaces.ts` (line 17)

## Properties

| Property | Type |
|---|---|
| `query` | `string` |
| `categories` | `string[]` |
| `limit` | `number` |
| `minScore` | `number` |

<!-- source: class-updatememberroledto.md -->

# UpdateMemberRoleDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/update-member-role.dto.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `role` | `UserRole` |

<!-- source: function-usecodeblockeditorcontext.md -->

# useCodeBlockEditorContext

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/CodeBlockNode.tsx` (line 228)

Use this hook in your custom code block editors to modify the underlying node code, language, and meta.

<!-- source: function-usepublish.md -->

# usePublish

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/usePublish.ts` (line 53)

usePublish - Hook for publishing and unpublishing documents

Provides a simple interface for changing document publication state.
Requires MAINTAINER or ADMIN role.

## Signature

```ts
function usePublish(): UsePublishReturn
```

**Returns:** `UsePublishReturn`

<!-- source: service-webhookservice.md -->

# WebhookService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/webhooks/webhook.service.ts` (line 21)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `verifyGitHubSignature` | `verifyGitHubSignature(signature: string, body: string | Buffer, secret: string)` | `void` |
| `verifyGitLabToken` | `verifyGitLabToken(token: string, secret: string)` | `void` |
| `verifyAzureDevOpsAuth` | `verifyAzureDevOpsAuth(authHeader: string, secret: string)` | `void` |
| `findProjectByRepoUrl` | `findProjectByRepoUrl(repoUrl: string, event: 'push' | 'tag_create' | 'release')` | `unknown` |
| `getTriggerConfig` | `getTriggerConfig(projectId: string)` | `unknown` |
| `handleTagCreate` | `handleTagCreate(repoUrl: string, tagName: string, commitHash: string, provider: string, rawPayload: any, verify: WebhookVerification)` | `Promise<{ status: string; jobId?: string }>` |
| `handlePush` | `handlePush(repoUrl: string, branch: string, commitHash: string, provider: string, rawPayload: any, verify: WebhookVerification)` | `Promise<{ status: string; jobId?: string }>` |
| `handleRelease` | `handleRelease(repoUrl: string, tagName: string, releaseName: string, commitHash: string, provider: string, rawPayload: any, verify: WebhookVerification)` | `Promise<{ status: string; jobId?: string }>` |
| `generateWebhookSecret` | `generateWebhookSecret()` | `string` |

## Relationships

- DEPENDS_ON → `prismaservice`
- DEPENDS_ON → `docautomationservice`
- DEPENDS_ON → `technicaldocsservice`

<!-- source: interface-crossstackmappingresult.md -->

# CrossStackMappingResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-03-features/cross-stack-mapper.ts` (line 73)

Result of cross-stack mapping

## Properties

| Property | Type |
|---|---|
| `mappings` | `CrossStackMapping[]` |
| `crossStackFeatures` | `CrossStackFeature[]` |
| `stats` | `{
    totalMappings: number;
    apiCallMappings: number;
    routeMatchMappings: number;
    nameCorrelationMappings: number;
  }` |

<!-- source: api-endpoint-getactive.md -->

# getActive

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 55)

## Endpoint

`GET /doc-versions/:projectId/active`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `scope` | query | `string` | - |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: constant-headingsplugin.md -->

# headingsPlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/headings/index.ts` (line 75)

A plugin that adds support for markdown headings.

<!-- source: component-htag.md -->

# HTag

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/html.tsx` (line 32)

## Diagram

```mermaid
graph TD
    component_HTag_2263c682["HTag"]
    class component_HTag_2263c682 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: function-isjunkpath.md -->

# isJunkPath

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/significance.ts` (line 31)

Source path that can never yield hand-written API surface (generated/build/vendor/test).

## Signature

```ts
function isJunkPath(filePath: string | undefined): boolean
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string | undefined` |

**Returns:** `boolean`

<!-- source: interface-parsermetadata-2.md -->

# ParserMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/parser.interface.ts` (line 104)

Parser metadata for registration

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `version` | `string` |
| `supportedPatterns` | `string[]` |
| `description` | `string` |
| `category` | `ParserCategory` |
| `languages` | `string[]` |
| `author` | `string` |

<!-- source: interface-promptsection.md -->

# PromptSection

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/prompt-sections.ts` (line 28)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `condition` | `(ctx: SectionContext) => boolean` |
| `content` | `string` |
| `priority` | `number` |

<!-- source: component-relitem.md -->

# RelItem

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/components/RelationsPanel.tsx` (line 70)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `entityId` | `string` | ✓ | - |
| `relType` | `string` | ✓ | - |
| `entityMap` | `Record` | ✓ | - |
| `projectId` | `string` | ✓ | - |
| `entityHrefBase` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_RelItem_48d06e52["RelItem"]
    class component_RelItem_48d06e52 rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `TypeIcon`

## Referenced By

- `RelationsPanel` (RENDERS)

<!-- source: interface-searchresponse.md -->

# SearchResponse

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/azure-search.service.ts` (line 84)

Search response with facets

## Properties

| Property | Type |
|---|---|
| `results` | `SearchResult[]` |
| `total` | `number` |
| `facets` | `{
    documentType?: Record<string, number>;
    category?: Record<string, number>;
    difficulty?: Record<string, number>;
  }` |

<!-- source: class-updateorganizationdto.md -->

# UpdateOrganizationDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/organization/dto/update-organization.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |

<!-- source: function-usecodemirrorref.md -->

# useCodeMirrorRef

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/sandpack/useCodeMirrorRef.ts` (line 9)

## Signature

```ts
function useCodeMirrorRef(nodeKey: string, editorType: 'codeblock' | 'sandpack', language: string, focusEmitter: VoidEmitter)
```

## Parameters

| Name | Type |
|---|---|
| `nodeKey` | `string` |
| `editorType` | `'codeblock' | 'sandpack'` |
| `language` | `string` |
| `focusEmitter` | `VoidEmitter` |

<!-- source: function-useresizable.md -->

# useResizable

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/doc/[...segments]/useResizable.ts` (line 28)

Hook for creating resizable panels with drag functionality

## Signature

```ts
function useResizable({
  initialWidth,
  minWidth,
  maxWidth,
  storageKey,
  direction,
}: UseResizableOptions): UseResizableReturn
```

## Parameters

| Name | Type |
|---|---|
| `{
  initialWidth,
  minWidth,
  maxWidth,
  storageKey,
  direction,
}` | `UseResizableOptions` |

**Returns:** `UseResizableReturn`

<!-- source: service-workflowdetectorservice.md -->

# WorkflowDetectorService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/documentation/services/workflow-detector.service.ts` (line 52)

Service for detecting business workflows from various sources

Detection strategies:
1. Business context files (workflow diagrams, process docs)
2. Navigation patterns (sequences of page visits)
3. Form sequences (multi-step processes)
4. User journey analysis (common paths through the app)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `detectWorkflows` | `detectWorkflows(appMap: any, businessContext: {
      marketing: string[];
      workflows: string[];
      brand: string[];
      processes: string[];
    })` | `Promise<DetectedWorkflow[]>` |

<!-- source: interface-ctacardprops-2.md -->

# CtaCardProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/cta/cta-card.tsx` (line 14)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `primaryCtaKey` | `string` |
| `primaryCtaUrl` | `string` |
| `secondaryCtaKey` | `string` |
| `secondaryCtaUrl` | `string` |
| `icon` | `LucideIcon` |

<!-- source: api-endpoint-getagent.md -->

# getAgent

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.controller.ts` (line 121)

## Endpoint

`GET /support-agent/:projectId/agents/:agentId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `agentId` | query | `string` | ✓ |

## Referenced By

- `SupportAgentController` (MODULE_DECLARES)

<!-- source: constant-historystate.md -->

# historyState$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 779)

<!-- source: component-html.md -->

# Html

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/jsx.tsx` (line 125)

## Diagram

```mermaid
graph TD
    component_Html_5759f2f5["Html"]
    class component_Html_5759f2f5 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: function-islifecyclemethod-2.md -->

# isLifecycleMethod

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 706)

Check if a method name is a React lifecycle method

## Signature

```ts
function isLifecycleMethod(methodName: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `methodName` | `string` |

**Returns:** `boolean`

<!-- source: interface-parseroptions.md -->

# ParserOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/storybook/types.ts` (line 148)

Parser options

## Properties

| Property | Type |
|---|---|
| `projectRoot` | `string` |
| `enableCSF2` | `boolean` |
| `enableCSF3` | `boolean` |
| `autoDetectConfig` | `boolean` |
| `stories` | `string[]` |
| `exclude` | `string[]` |

<!-- source: interface-qualitygate.md -->

# QualityGate

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/autonomous-loop.ts` (line 41)

A quality gate is a concrete, measurable condition the agent must meet
before it can consider the task done.

Domain layers define these; the autonomous loop checks and injects them.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `description` | `string` |
| `passed` | `boolean` |

<!-- source: component-replycomposer.md -->

# ReplyComposer

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/issues/[ticketNumber]/page.tsx` (line 993)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `slugId` | `string` | ✓ | - |
| `ticketNumber` | `number` | ✓ | - |
| `onPosted` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ReplyComposer_2610e661["ReplyComposer"]
    class component_ReplyComposer_2610e661 rootComponent
```

## Relationships

- USES_HOOK → `useState`

## Referenced By

- `PublicTicketPage` (RENDERS)

<!-- source: interface-searchresult.md -->

# SearchResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/web-search/interfaces/search.interfaces.ts` (line 5)

Search-related interfaces for web search and competitor docs

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `url` | `string` |
| `content` | `string` |
| `snippet` | `string` |
| `category` | `string[]` |
| `source` | `string` |
| `lastCrawled` | `Date` |
| `score` | `number` |

<!-- source: class-updateorgsettingsdto.md -->

# UpdateOrgSettingsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/organization/dto/update-org-settings.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `allowPublicDocs` | `boolean` |
| `enableAI` | `boolean` |
| `defaultProjectVisibility` | `string` |
| `enableKnowledgeGraph` | `boolean` |
| `maxProjects` | `number` |
| `maxUsers` | `number` |

<!-- source: function-usecomments.md -->

# useComments

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useComments.ts` (line 61)

useComments - Hook for comment management with real-time updates

Provides comment state and operations with WebSocket support.

## Signature

```ts
function useComments(options: UseCommentsOptions): UseCommentsReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseCommentsOptions` |

**Returns:** `UseCommentsReturn`

<!-- source: function-usetemplates.md -->

# useTemplates

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/hooks/useTemplates.ts` (line 65)

useTemplates - Hook for fetching and managing document templates

Provides a list of templates with optional filtering by category.
Also provides actions for using templates and saving documents as templates.

## Signature

```ts
function useTemplates(options: UseTemplatesOptions): UseTemplatesReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseTemplatesOptions` |

**Returns:** `UseTemplatesReturn`

<!-- source: service-workflowdiscoveryservice.md -->

# WorkflowDiscoveryService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/workflow/workflow-discovery.service.ts` (line 31)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `discoverWorkflows` | `discoverWorkflows(projectId: string, workflowSignals: WorkflowSignals, options: {
      model?: string;
      force?: boolean;
      businessContext?: BusinessContext;
    })` | `Promise<WorkflowDiscoveryResult>` |
| `estimateCost` | `estimateCost(workflowSignals: WorkflowSignals, model: string)` | `{
    inputTokens: number;
    outputTokens: number;
    costUSD: number;
  }` |
| `clearCache` | `clearCache(projectId: string)` | `void` |

## Relationships

- DEPENDS_ON → `configservice`
- DEPENDS_ON → `azureclaudeprovider`

<!-- source: interface-dataflowstep.md -->

# DataFlowStep

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-03-features/cross-stack-mapper.ts` (line 53)

A step in the data flow

## Properties

| Property | Type |
|---|---|
| `step` | `number` |
| `layer` | `'frontend' | 'api' | 'service' | 'database'` |
| `entity` | `string` |
| `action` | `string` |

<!-- source: api-endpoint-getapispec.md -->

# getApiSpec

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 372)

## Endpoint

`GET /technical-docs/:projectId/api-spec`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-htmlimage.md -->

# HtmlImage

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/images.tsx` (line 161)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `readOnly` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_HtmlImage_71a0dd2d["HtmlImage"]
    class component_HtmlImage_71a0dd2d rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`

<!-- source: constant-htmltags.md -->

# htmlTags

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/MdastHTMLNode.ts` (line 55)

All the HTML tags supported by the generic html node.

## Definition

```ts
string[]
```

<!-- source: function-isnestjsfile.md -->

# isNestJsFile

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/framework-detect.ts` (line 43)

True for a file that imports from any '@nestjs/…' package.

## Signature

```ts
function isNestJsFile(filePath: string, content: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |
| `content` | `string` |

**Returns:** `boolean`

<!-- source: interface-parserstats-2.md -->

# ParserStats

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/parse-result.interface.ts` (line 388)

Statistics for a single parser

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `filesProcessed` | `number` |
| `entitiesFound` | `number` |
| `relationshipsFound` | `number` |
| `duration` | `number` |
| `errors` | `number` |
| `warnings` | `number` |

<!-- source: interface-rankeditem.md -->

# RankedItem

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/hybrid-search.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `chunk` | `CodeChunk` |
| `score` | `number` |

<!-- source: component-resetpasswordform.md -->

# ResetPasswordForm

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/(auth)/reset-password/page.tsx` (line 9)

## Diagram

```mermaid
graph TD
    component_ResetPasswordForm_429d4524["ResetPasswordForm"]
    class component_ResetPasswordForm_429d4524 rootComponent
```

## Relationships

- RENDERS → `Link`
- USES_HOOK → `useSearchParams`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`

## Referenced By

- `ResetPasswordPage` (RENDERS)

<!-- source: interface-searchresult-2.md -->

# SearchResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/azure-search.service.ts` (line 70)

Search result item

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `description` | `string` |
| `snippet` | `string` |
| `documentType` | `string` |
| `category` | `string` |
| `difficulty` | `string` |
| `score` | `number` |

<!-- source: class-updateprojectdto.md -->

# UpdateProjectDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/update-project.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `slug` | `string` |
| `repoUrl` | `string` |
| `repoBranch` | `string` |
| `themeId` | `string` |
| `settings` | `Record<string, unknown>` |

<!-- source: function-usedocument.md -->

# useDocument

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useDocument.ts` (line 65)

useDocument - Hook for document management

Provides document state and operations.
Business logic (validation, permissions) is delegated to DocumentManager from

## Signature

```ts
function useDocument(options: UseDocumentOptions): UseDocumentReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseDocumentOptions` |

**Returns:** `UseDocumentReturn`

<!-- source: function-useversioncontext.md -->

# useVersionContext

**Kind:** Function

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/VersionContext.tsx` (line 35)

<!-- source: service-workflowstorageservice.md -->

# WorkflowStorageService

**Kind:** Service

**Source:** `atloria-monorepo/apps/api/src/workflow/workflow-storage.service.ts` (line 11)

## Methods

| Method | Signature | Returns |
|---|---|---|
| `storeWorkflows` | `storeWorkflows(projectId: string, workflows: DiscoveredWorkflow[])` | `Promise<void>` |
| `getWorkflows` | `getWorkflows(projectId: string)` | `Promise<DiscoveredWorkflow[]>` |
| `deleteWorkflows` | `deleteWorkflows(projectId: string)` | `Promise<void>` |

## Relationships

- DEPENDS_ON → `neo4jservice`

<!-- source: interface-deeploaderconfig.md -->

# DeepLoaderConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-04-analysis/iterative-deep-loader.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `maxIterations` | `number` |
| `entityResolver` | `(entityId: string) => Entity | undefined` |
| `fileLoader` | `(filePath: string, startLine?: number, endLine?: number) => Promise<string>` |
| `largeFileIndexes` | `LargeFileIndex[]` |

<!-- source: api-endpoint-getapitarget.md -->

# getApiTarget

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 352)

## Endpoint

`GET /technical-docs/:projectId/api-target`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-i18nprovider.md -->

# I18nProvider

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/i18n.tsx` (line 74)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `defaultLocale` | `string` | - | "en" |
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_I18nProvider_2ae60c3d["I18nProvider"]
    class component_I18nProvider_2ae60c3d rootComponent
```

## Relationships

- RENDERS → `I18nContext-Provider`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: constant-iconcomponentfor.md -->

# iconComponentFor$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 491)

A callback that returns the icon component for the given name.

<!-- source: function-isreactclasscomponent-2.md -->

# isReactClassComponent

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 83)

Check if a class extends React.Component or React.PureComponent

## Signature

```ts
function isReactClassComponent(path: NodePath<t.ClassDeclaration>): boolean
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath<t.ClassDeclaration>` |

**Returns:** `boolean`

<!-- source: interface-parsesummary-2.md -->

# ParseSummary

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/parse-result.interface.ts` (line 333)

Summary statistics for a project parse

## Properties

| Property | Type |
|---|---|
| `totalFiles` | `number` |
| `successfulFiles` | `number` |
| `failedFiles` | `number` |
| `skippedFiles` | `number` |
| `totalEntities` | `number` |
| `totalRelationships` | `number` |
| `totalDuration` | `number` |
| `entitiesByType` | `Record<string, number>` |
| `relationshipsByType` | `Record<string, number>` |
| `parserStats` | `Record<string, ParserStats>` |

<!-- source: interface-readfileoptions.md -->

# ReadFileOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/read-file.tool.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `maxFileSize` | `number` |
| `maxLines` | `number` |
| `maxImageSize` | `number` |

<!-- source: component-resolutiontimechart.md -->

# ResolutionTimeChart

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/page.tsx` (line 388)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `buckets` | `ResolutionBucket[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ResolutionTimeChart_3705964["ResolutionTimeChart"]
    class component_ResolutionTimeChart_3705964 rootComponent
```

## Referenced By

- `IssuesListPage` (RENDERS)

<!-- source: interface-selectionrange-2.md -->

# SelectionRange

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/collaboration/interfaces/collaboration.interfaces.ts` (line 38)

Selection range in the document

## Properties

| Property | Type |
|---|---|
| `anchor` | `number` |
| `head` | `number` |

<!-- source: class-updatesettingsdto.md -->

# UpdateSettingsDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/project/dto/update-settings.dto.ts` (line 6)

## Properties

| Property | Type |
|---|---|
| `allowComments` | `boolean` |
| `allowSuggestions` | `boolean` |
| `autoPublish` | `boolean` |
| `defaultAudience` | `string` |
| `themeId` | `string` |

<!-- source: function-usedocuments.md -->

# useDocuments

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useDocuments.ts` (line 54)

useDocuments - Hook for fetching lists of documents

Provides a list of documents with optional filtering, searching, and pagination.

## Signature

```ts
function useDocuments(options: UseDocumentsOptions): UseDocumentsReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseDocumentsOptions` |

**Returns:** `UseDocumentsReturn`

<!-- source: interface-deeploaderresult.md -->

# DeepLoaderResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-04-analysis/iterative-deep-loader.ts` (line 31)

## Properties

| Property | Type |
|---|---|
| `finalResponse` | `ClaudeResponse` |
| `iterations` | `number` |
| `additionalContext` | `string[]` |

<!-- source: api-endpoint-getapproval.md -->

# getApproval

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 632)

## Endpoint

`GET /doc-versions/:projectId/:versionId/approval`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-imageasdirective.md -->

# ImageAsDirective

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/directives.tsx` (line 305)

## Diagram

```mermaid
graph TD
    component_ImageAsDirective_17466cab["ImageAsDirective"]
    class component_ImageAsDirective_17466cab rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: constant-imageautocompletesuggestions.md -->

# imageAutocompleteSuggestions$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 155)

Holds the autocomplete suggestions for image sources.

<!-- source: function-isreactcomponent-2.md -->

# isReactComponent

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 72)

Check if a function component is a React component (returns JSX)

## Signature

```ts
function isReactComponent(path: NodePath<
    t.FunctionDeclaration | t.ArrowFunctionExpression | t.FunctionExpression
  >): boolean
```

## Parameters

| Name | Type |
|---|---|
| `path` | `NodePath<
    t.FunctionDeclaration | t.ArrowFunctionExpression | t.FunctionExpression
  >` |

**Returns:** `boolean`

<!-- source: interface-parsewarning-2.md -->

# ParseWarning

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/parse-result.interface.ts` (line 108)

Warning encountered during parsing (non-blocking)

## Properties

| Property | Type |
|---|---|
| `message` | `string` |
| `code` | `string` |
| `line` | `number` |
| `suggestion` | `string` |

<!-- source: interface-rehydrationconfig.md -->

# RehydrationConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/rehydration.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `maxCharsPerFile` | `number` |
| `maxTotalChars` | `number` |
| `maxFiles` | `number` |

<!-- source: component-retentionpolicysection.md -->

# RetentionPolicySection

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/page.tsx` (line 1051)

Phase 8: Retention policy configuration.

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_RetentionPolicySection_16afe4e0["RetentionPolicySection"]
    class component_RetentionPolicySection_16afe4e0 rootComponent
```

## Relationships

- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`

## Referenced By

- `ProjectPage` (RENDERS)

<!-- source: interface-sendemailoptions.md -->

# SendEmailOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/email/email.service.ts` (line 11)

## Properties

| Property | Type |
|---|---|
| `to` | `string | string[]` |
| `subject` | `string` |
| `html` | `string` |
| `text` | `string` |
| `attachments` | `EmailAttachment[]` |

<!-- source: class-updateuseraudiencesdto.md -->

# UpdateUserAudiencesDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/organization/dto/update-user-audiences.dto.ts` (line 7)

DTO for updating a user's audience memberships

## Properties

| Property | Type |
|---|---|
| `audienceIds` | `string[]` |

<!-- source: function-uselexicalnoderemove.md -->

# useLexicalNodeRemove

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/NestedLexicalEditor.tsx` (line 129)

A hook that returns a function that removes the lexical node from the editor.

<!-- source: interface-deeploadrequest.md -->

# DeepLoadRequest

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-10.types.ts` (line 92)

DeepLoadRequest - AI requests additional code context

During generation, if AI is uncertain about something, it can
request the full implementation of a specific entity.
Max 3 iterations per document to prevent infinite loops.

## Properties

| Property | Type |
|---|---|
| `entityName` | `string` |
| `reason` | `string` |
| `requestedBy` | `'generator' | 'verifier'` |
| `urgency` | `'required' | 'helpful'` |

<!-- source: api-endpoint-getasset.md -->

# getAsset

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/assets/assets.controller.ts` (line 51)

## Endpoint

`GET /assets/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `AssetsController` (MODULE_DECLARES)

<!-- source: component-imagedialog.md -->

# ImageDialog

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/ImageDialog.tsx` (line 27)

## Diagram

```mermaid
graph TD
    component_ImageDialog_13a9e0e4["ImageDialog"]
    class component_ImageDialog_13a9e0e4 rootComponent
```

## Relationships

- RENDERS → `Dialog-Root`
- RENDERS → `Dialog-Portal`
- RENDERS → `Dialog-Overlay`
- RENDERS → `Dialog-Content`
- RENDERS → `Dialog-Title`
- RENDERS → `DownshiftAutoComplete`
- RENDERS → `Dialog-Close`
- USES_HOOK → `useCellValues`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useTranslation`
- USES_HOOK → `useForm`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`

<!-- source: constant-imagedialogstate.md -->

# imageDialogState$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 185)

Holds the current state of the image dialog.

<!-- source: function-isreactfile-2.md -->

# isReactFile

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 634)

Check if a file is a React/JSX file

## Signature

```ts
function isReactFile(filePath: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |

**Returns:** `boolean`

<!-- source: interface-permissioncheck.md -->

# PermissionCheck

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/permission-extractor.ts` (line 22)

A permission check found in source code

## Properties

| Property | Type |
|---|---|
| `permission` | `string` |
| `checkType` | `'route-guard' | 'template-conditional' | 'code-check' | 'decorator'` |
| `affectedElement` | `string` |
| `location` | `string` |
| `sourceFile` | `string` |
| `line` | `number` |

<!-- source: interface-rehydrationitem.md -->

# RehydrationItem

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/types.ts` (line 27)

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `content` | `string` |
| `success` | `boolean` |

<!-- source: component-reveal.md -->

# Reveal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/languages/page.tsx` (line 379)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |
| `delay` | `number` | - | 0 |
| `style` | `unknown` | - | - |

## Diagram

```mermaid
graph TD
    component_Reveal_3d467d8b["Reveal"]
    class component_Reveal_3d467d8b rootComponent
```

## Relationships

- RENDERS → `motion-div`
- USES_HOOK → `useRef`
- USES_HOOK → `useInView`

## Referenced By

- `LanguagesPage` (RENDERS)

<!-- source: interface-stalepage.md -->

# StalePage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/freshness.service.ts` (line 30)

One stale, redraftable page for the cockpit list.

## Properties

| Property | Type |
|---|---|
| `slug` | `string` |
| `title` | `string` |
| `scope` | `'manual'` |

<!-- source: class-updateversionmetadatadto.md -->

# UpdateVersionMetadataDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/document/dto/update-version-metadata.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `comment` | `string` |

<!-- source: function-usemdastnodeupdater.md -->

# useMdastNodeUpdater

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/NestedLexicalEditor.tsx` (line 107)

A hook that returns a function that can be used to update the mdast node. Use this in your custom editor components.

<!-- source: interface-deeploadresponse.md -->

# DeepLoadResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-10.types.ts` (line 99)

## Properties

| Property | Type |
|---|---|
| `entityName` | `string` |
| `found` | `boolean` |
| `content` | `string` |
| `relatedEntities` | `string[]` |
| `tokenCost` | `number` |

<!-- source: api-endpoint-getaudiencedocuments.md -->

# getAudienceDocuments

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 430)

## Endpoint

`GET /public/p/:slugWithId/audiences/:audienceSlug/documents`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |
| `audienceSlug` | query | `string` | ✓ |
| `version` | query | `string` | - |
| `lang` | query | `string` | - |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: component-imagedialogbuttonexample.md -->

# ImageDialogButtonExample

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/images.tsx` (line 238)

## Diagram

```mermaid
graph TD
    component_ImageDialogButtonExample_732330ae["ImageDialogButtonExample"]
    class component_ImageDialogButtonExample_732330ae rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `InsertImage`

<!-- source: constant-imageplaceholder.md -->

# imagePlaceholder$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 179)

Holds the image placeholder.

<!-- source: function-istypescriptfile-2.md -->

# isTypeScriptFile

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 641)

Check if a file is a TypeScript file

## Signature

```ts
function isTypeScriptFile(filePath: string): boolean
```

## Parameters

| Name | Type |
|---|---|
| `filePath` | `string` |

**Returns:** `boolean`

<!-- source: interface-piniaactionpattern.md -->

# PiniaActionPattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/pinia-pattern-detector.ts` (line 59)

Pinia action pattern

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `storeName` | `string` |
| `line` | `number` |
| `isAsync` | `boolean` |
| `asyncGroup` | `{
    type: 'start' | 'success' | 'failure';
    baseName: string;
  }` |

<!-- source: interface-reliabilitycontext.md -->

# ReliabilityContext

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/reliability-config.ts` (line 58)

## Properties

| Property | Type |
|---|---|
| `testWatcher` | `TestWatcher | null` |
| `circleDetector` | `CircleDetector | null` |
| `preflightResults` | `PreflightResult[]` |
| `qualityGateProvider` | `QualityGateProvider | undefined` |
| `preflightSummary` | `string` |
| `dispose` | `() => void` |

<!-- source: component-reveal-2.md -->

# Reveal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/page.tsx` (line 389)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |
| `delay` | `number` | - | 0 |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_Reveal_6b57f6e9["Reveal"]
    class component_Reveal_6b57f6e9 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- USES_HOOK → `useRef`
- USES_HOOK → `useInView`

## Referenced By

- `HomePage` (RENDERS)

<!-- source: interface-staleresult.md -->

# StaleResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/freshness.service.ts` (line 36)

## Properties

| Property | Type |
|---|---|
| `checkedAt` | `string | null` |
| `staleCount` | `number` |
| `commitHash` | `string | null` |
| `changedFiles` | `string[]` |
| `changedFileCount` | `number` |
| `technicalStaleCount` | `number` |
| `sampleNames` | `string[]` |
| `pages` | `StalePage[]` |

<!-- source: class-uploadassetdto.md -->

# UploadAssetDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/assets/dto/upload-asset.dto.ts` (line 5)

## Properties

| Property | Type |
|---|---|
| `audiences` | `string[]` |
| `altText` | `string` |
| `caption` | `string` |
| `tags` | `string[]` |

<!-- source: function-usenestededitorcontext.md -->

# useNestedEditorContext

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/NestedLexicalEditor.tsx` (line 95)

<!-- source: interface-dependencyedge.md -->

# DependencyEdge

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 229)

## Properties

| Property | Type |
|---|---|
| `from` | `string` |
| `to` | `string` |
| `type` | `DependencyType` |
| `isDocumentationRelevant` | `boolean` |

<!-- source: api-endpoint-getaudiencesbyurl.md -->

# getAudiencesByUrl

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 382)

## Endpoint

`GET /public/p/:slugWithId/audiences`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |
| `version` | query | `string` | - |
| `lang` | query | `string` | - |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: component-imagedimensionsexample.md -->

# ImageDimensionsExample

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/images.tsx` (line 263)

## Diagram

```mermaid
graph TD
    component_ImageDimensionsExample_1021eb3f["ImageDimensionsExample"]
    class component_ImageDimensionsExample_1021eb3f rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `InsertImage`

<!-- source: constant-imageplugin.md -->

# imagePlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 372)

A plugin that adds support for images.

<!-- source: function-kindlabel.md -->

# kindLabel

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/entity-page.ts` (line 54)

"DATABASE_MODEL" → "Database Model", "API_ENDPOINT" → "API Endpoint", "SERVICE" → "Service".

## Signature

```ts
function kindLabel(type: string): string
```

## Parameters

| Name | Type |
|---|---|
| `type` | `string` |

**Returns:** `string`

<!-- source: interface-piniagetterpattern.md -->

# PiniaGetterPattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/pinia-pattern-detector.ts` (line 92)

Pinia getter pattern

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `storeName` | `string` |
| `line` | `number` |
| `statePath` | `string[]` |
| `dependsOn` | `string[]` |

<!-- source: interface-reliabilityoptions.md -->

# ReliabilityOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/reliability-config.ts` (line 33)

## Properties

| Property | Type |
|---|---|
| `testCommand` | `string` |
| `cwd` | `string` |
| `enableTestWatcher` | `boolean` |
| `enableTestGate` | `boolean` |
| `enablePreflight` | `boolean` |
| `enableCircleDetection` | `boolean` |
| `debounceMs` | `number` |
| `testTimeoutMs` | `number` |
| `reportPassingTests` | `boolean` |
| `preflightChecks` | `PreflightCheck[]` |
| `circleDetectorOptions` | `CircleDetectorOptions` |

<!-- source: component-reveal-3.md -->

# Reveal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/privacy/page.tsx` (line 7)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |
| `delay` | `number` | - | 0 |

## Diagram

```mermaid
graph TD
    component_Reveal_35e5367e["Reveal"]
    class component_Reveal_35e5367e rootComponent
```

## Relationships

- RENDERS → `motion-div`
- USES_HOOK → `useRef`
- USES_HOOK → `useInView`

## Referenced By

- `PrivacyPage` (RENDERS)

<!-- source: interface-staletransitioninfo.md -->

# StaleTransitionInfo

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/stale-alert.service.ts` (line 27)

## Properties

| Property | Type |
|---|---|
| `staleCount` | `number` |
| `manualStaleCount` | `number` |
| `sampleNames` | `Array<string | undefined>` |
| `commit` | `string | null` |
| `branch` | `string | null` |

<!-- source: function-useproject.md -->

# useProject

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useProject.ts` (line 66)

useProject - Hook for project management

Provides project state and operations.
Business logic (validation, permissions) is delegated to ProjectManager from

## Signature

```ts
function useProject(options: UseProjectOptions): UseProjectReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseProjectOptions` |

**Returns:** `UseProjectReturn`

<!-- source: class-userresponsedto.md -->

# UserResponseDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/auth/dto/auth-response.dto.ts` (line 5)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `email` | `string` |
| `name` | `string` |
| `role` | `UserRole` |
| `organizationId` | `string` |
| `createdAt` | `Date` |
| `updatedAt` | `Date` |

<!-- source: interface-descriptors.md -->

# Descriptors

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/importMarkdownToLexical.ts` (line 28)

The registered descriptors for composite nodes (jsx, directives, code blocks).

## Properties

| Property | Type |
|---|---|
| `jsxComponentDescriptors` | `JsxComponentDescriptor[]` |
| `directiveDescriptors` | `DirectiveDescriptor[]` |
| `codeBlockEditorDescriptors` | `CodeBlockEditorDescriptor[]` |

<!-- source: api-endpoint-getauthurl.md -->

# getAuthUrl

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/bitbucket/bitbucket.controller.ts` (line 17)

## Endpoint

`GET /bitbucket/auth-url`

## Referenced By

- `BitbucketController` (MODULE_DECLARES)

<!-- source: component-imageeditor.md -->

# ImageEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/ImageEditor.tsx` (line 113)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `src` | `string` | ✓ | - |
| `title` | `string` | - | - |
| `alt` | `string` | - | - |
| `nodeKey` | `string` | ✓ | - |
| `width` | `number | unknown` | ✓ | - |
| `height` | `number | unknown` | ✓ | - |
| `rest` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ImageEditor_214d8dbc["ImageEditor"]
    class component_ImageEditor_214d8dbc rootComponent
```

## Relationships

- RENDERS → `React-Suspense`
- RENDERS → `ImagePlaceholderComponent`
- RENDERS → `LazyImage`
- RENDERS → `ImageResizer`
- RENDERS → `EditImageToolbar`
- USES_HOOK → `useCellValues`
- USES_HOOK → `useRef`
- USES_HOOK → `useLexicalNodeSelection`
- USES_HOOK → `useLexicalComposerContext`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`
- USES_HOOK → `useMemo`

<!-- source: constant-imagepreviewhandler.md -->

# imagePreviewHandler$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 173)

Holds the image preview handler callback.

<!-- source: function-linkinteractionstoscreenshot.md -->

# linkInteractionsToScreenshot

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ui-interaction-detector.ts` (line 398)

Link UI interactions to screenshots

Takes a screenshot URL and a list of interactions, and determines
which interactions are available on that screenshot based on the
current state detected from the URL.

## Signature

```ts
function linkInteractionsToScreenshot(_screenshotUrl: string, interactions: UIInteraction[], currentState: string): UIInteraction[]
```

## Parameters

| Name | Type |
|---|---|
| `_screenshotUrl` | `string` |
| `interactions` | `UIInteraction[]` |
| `currentState` | `string` |

**Returns:** `UIInteraction[]`

<!-- source: interface-piniastorepattern.md -->

# PiniaStorePattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/pinia-pattern-detector.ts` (line 19)

Pinia store pattern

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `storeId` | `string` |
| `line` | `number` |
| `isCompositionAPI` | `boolean` |
| `stateProps` | `Array<{ name: string; type?: string }>` |
| `getters` | `string[]` |
| `actions` | `Array<{ name: string; isAsync: boolean }>` |

<!-- source: interface-repomapconfig.md -->

# RepoMapConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/repo-map.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `tokenBudget` | `number` |
| `includePatterns` | `RegExp[]` |
| `excludeDirs` | `string[]` |
| `maxFiles` | `number` |

<!-- source: component-reveal-4.md -->

# Reveal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/terms/page.tsx` (line 7)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |
| `delay` | `number` | - | 0 |

## Diagram

```mermaid
graph TD
    component_Reveal_6bbfa161["Reveal"]
    class component_Reveal_6bbfa161 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- USES_HOOK → `useRef`
- USES_HOOK → `useInView`

## Referenced By

- `TermsPage` (RENDERS)

<!-- source: interface-startstitchparams.md -->

# StartStitchParams

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/capture/flow-draft-stitcher.service.ts` (line 16)

## Properties

| Property | Type |
|---|---|
| `jobId` | `string` |
| `documentId` | `string` |
| `organizationId` | `string` |
| `workerApiBase` | `string` |

<!-- source: function-useprojects.md -->

# useProjects

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useProjects.ts` (line 49)

useProjects - Hook for fetching lists of projects

Provides a list of projects with optional filtering by organization.

## Signature

```ts
function useProjects(options: UseProjectsOptions): UseProjectsReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseProjectsOptions` |

**Returns:** `UseProjectsReturn`

<!-- source: class-verifyemaildto.md -->

# VerifyEmailDto

**Kind:** Class

**Source:** `atloria-monorepo/apps/api/src/auth/dto/password.dto.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `token` | `string` |

<!-- source: interface-detectedangularcomponent.md -->

# DetectedAngularComponent

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/angular-detector.ts` (line 17)

Detected Angular component

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `selector` | `string` |
| `templateType` | `'inline' | 'external'` |
| `styleType` | `'inline' | 'external' | 'none'` |
| `inputs` | `AngularInput[]` |
| `outputs` | `string[]` |
| `injectedServices` | `string[]` |
| `formType` | `'reactive' | 'template-driven'` |
| `lifecycleHooks` | `string[]` |
| `rxjsOperators` | `string[]` |
| `childComponents` | `string[]` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getauthurl-2.md -->

# getAuthUrl

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/github/github.controller.ts` (line 20)

Get the GitHub OAuth authorization URL

## Endpoint

`GET /github/auth-url`

## Referenced By

- `GitHubController` (MODULE_DECLARES)

<!-- source: component-imageplaceholder.md -->

# ImagePlaceholder

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/ImagePlaceholder.tsx` (line 6)

## Diagram

```mermaid
graph TD
    component_ImagePlaceholder_5a3f4c56["ImagePlaceholder"]
    class component_ImagePlaceholder_5a3f4c56 rootComponent
```

## Relationships

- RENDERS → `ImageIcon`

<!-- source: constant-imageuploadhandler.md -->

# imageUploadHandler$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 167)

Holds the image upload handler callback.

<!-- source: function-looksminifiedname.md -->

# looksMinifiedName

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/significance.ts` (line 36)

Minified-looking name: 1-2 chars, or 3 chars with a digit / no vowel — unless allowlisted.

## Signature

```ts
function looksMinifiedName(name: string | undefined): boolean
```

## Parameters

| Name | Type |
|---|---|
| `name` | `string | undefined` |

**Returns:** `boolean`

<!-- source: interface-progresscallback.md -->

# ProgressCallback

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/config.interface.ts` (line 265)

Progress callback for long-running operations

<!-- source: interface-repomapresult.md -->

# RepoMapResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/repo-map.ts` (line 48)

## Properties

| Property | Type |
|---|---|
| `content` | `string` |
| `definitionCount` | `number` |
| `totalDefinitions` | `number` |
| `tokenCount` | `number` |
| `filesScanned` | `number` |

<!-- source: component-revisioncard.md -->

# RevisionCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Document/VersionHistoryPanel.tsx` (line 343)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `revision` | `DocumentRevision` | ✓ | - |
| `isCurrent` | `boolean` | ✓ | - |
| `isSelected` | `boolean` | ✓ | - |
| `isSelectedForCompare` | `boolean` | ✓ | - |
| `compareMode` | `boolean` | ✓ | - |
| `isRestoring` | `boolean` | ✓ | - |
| `onSelect` | `Function` | ✓ | - |
| `onRestore` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_RevisionCard_268b157f["RevisionCard"]
    class component_RevisionCard_268b157f rootComponent
```

## Relationships

- RENDERS → `CheckIcon`
- RENDERS → `TagIcon`
- RENDERS → `ArrowPathIcon`

## Referenced By

- `VersionHistoryPanel` (RENDERS)

<!-- source: interface-staticsearchdoc-2.md -->

# StaticSearchDoc

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/search-index.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `url` | `string` |
| `documentType` | `SearchDocType` |
| `headings` | `string[]` |
| `excerpt` | `string` |
| `tokens` | `string[]` |
| `boost` | `number` |

<!-- source: function-user.md -->

# user

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/examples/assets/dataCode.ts` (line 7)

## Signature

```ts
function user(index)
```

## Parameters

| Name | Type |
|---|---|
| `index` | `any` |

<!-- source: interface-detectedangularservice.md -->

# DetectedAngularService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/angular-detector.ts` (line 58)

Detected Angular service

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `providedIn` | `'root' | 'any' | 'platform' | string` |
| `methods` | `string[]` |
| `dependencies` | `string[]` |
| `httpMethods` | `string[]` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getauthurl-3.md -->

# getAuthUrl

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/gitlab/gitlab.controller.ts` (line 20)

Get the GitLab OAuth authorization URL

## Endpoint

`GET /gitlab/auth-url`

## Referenced By

- `GitLabController` (MODULE_DECLARES)

<!-- source: component-imageresizer.md -->

# ImageResizer

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/ImageResizer.tsx` (line 27)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onResizeStart` | `Function` | ✓ | - |
| `onResizeEnd` | `Function` | ✓ | - |
| `imageRef` | `unknown` | ✓ | - |
| `maxWidth` | `number` | - | - |
| `editor` | `LexicalEditor` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ImageResizer_48b7bb40["ImageResizer"]
    class component_ImageResizer_48b7bb40 rootComponent
```

## Relationships

- USES_HOOK → `useRef`

<!-- source: constant-importvisitors.md -->

# importVisitors$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 274)

<!-- source: function-makegroundedask.md -->

# makeGroundedAsk

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/grounded-ask.ts` (line 55)

Make an AskFn from an LLM completion function. Retrieval is done upstream (the toolset passes
the retrieved `context`); this grounds the prompt, calls the LLM, and returns only validated
citations. Refuses (no LLM call) when context is empty.

## Signature

```ts
function makeGroundedAsk(complete: LlmComplete): AskFn
```

## Parameters

| Name | Type |
|---|---|
| `complete` | `LlmComplete` |

**Returns:** `AskFn`

<!-- source: interface-progressinfo.md -->

# ProgressInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/config.interface.ts` (line 276)

Progress information

## Properties

| Property | Type |
|---|---|
| `percent` | `number` |
| `phase` | `string` |
| `filesProcessed` | `number` |
| `totalFiles` | `number` |
| `currentFile` | `string` |
| `elapsedTime` | `number` |
| `estimatedTimeRemaining` | `number` |

<!-- source: interface-repomaptooloptions.md -->

# RepoMapToolOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/repo-map.tool.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `tokenBudget` | `number` |
| `includePatterns` | `RegExp[]` |
| `excludeDirs` | `string[]` |
| `maxFiles` | `number` |

<!-- source: component-row.md -->

# Row

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/IssueSidePanel.tsx` (line 914)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `icon` | `any` | ✓ | - |
| `label` | `string` | ✓ | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Row_1c8760b0["Row"]
    class component_Row_1c8760b0 rootComponent
```

## Relationships

- RENDERS → `Icon`

## Referenced By

- `IssueSidePanel` (RENDERS)

<!-- source: interface-staticsearchindex-2.md -->

# StaticSearchIndex

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/search-index.ts` (line 39)

## Properties

| Property | Type |
|---|---|
| `v` | `1` |
| `slugWithId` | `string` |
| `generatedAt` | `string` |
| `count` | `number` |
| `docs` | `StaticSearchDoc[]` |

<!-- source: function-useremotemdxeditorrealm.md -->

# useRemoteMDXEditorRealm

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/remote/index.tsx` (line 81)

## Signature

```ts
function useRemoteMDXEditorRealm(editorId: string)
```

## Parameters

| Name | Type |
|---|---|
| `editorId` | `string` |

<!-- source: interface-detectedapicall.md -->

# DetectedAPICall

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/api-call-mapper.ts` (line 14)

A detected API call from frontend code

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `method` | `'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'` |
| `path` | `string` |
| `sourceEntityId` | `string` |
| `sourceFile` | `string` |
| `lineNumber` | `number` |
| `requestBody` | `string` |
| `responseType` | `string` |
| `apiClient` | `'fetch' | 'axios' | 'ky' | 'got' | 'custom' | 'unknown'` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getboardsforissue.md -->

# getBoardsForIssue

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 189)

## Endpoint

`GET /projects/:projectId/issues/:issueId/boards`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `issueId` | query | `string` | ✓ |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: component-images.md -->

# Images

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 244)

## Diagram

```mermaid
graph TD
    component_Images_45f45a42["Images"]
    class component_Images_45f45a42 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: constant-infocus.md -->

# inFocus$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 165)

Holds whether the editor is in focus or not.

<!-- source: function-operationcodesamples.md -->

# operationCodeSamples

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/code-samples.ts` (line 38)

Samples for a single operation; [] on any failure (never throws into the spec build).

## Signature

```ts
function operationCodeSamples(spec: any, path: string, method: string, targets: string[]): CodeSample[]
```

## Parameters

| Name | Type |
|---|---|
| `spec` | `any` |
| `path` | `string` |
| `method` | `string` |
| `targets` | `string[]` |

**Returns:** `CodeSample[]`

<!-- source: interface-projectparseresult-2.md -->

# ProjectParseResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/parse-result.interface.ts` (line 278)

Result of parsing an entire project

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `rootDir` | `string` |
| `parsers` | `string[]` |
| `timestamp` | `Date` |
| `status` | `ParseStatus` |
| `results` | `ParseResult[]` |
| `summary` | `ParseSummary` |
| `entities` | `Entity[]` |
| `relationships` | `Relationship[]` |
| `workflowSignals` | `WorkflowSignals` |

<!-- source: interface-resumedsession.md -->

# ResumedSession

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/session-manager.ts` (line 27)

What gets passed back on resume — everything needed to restore a session

## Properties

| Property | Type |
|---|---|
| `meta` | `SessionMeta` |
| `conversationHistory` | `AgentHistoryItem[]` |
| `sdkHistory` | `unknown[]` |

<!-- source: component-runningjobcard.md -->

# RunningJobCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/versions/page.tsx` (line 55)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `job` | `any` | ✓ | - |
| `onViewDetails` | `Function` | ✓ | - |
| `onForceComplete` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_RunningJobCard_2f1856eb["RunningJobCard"]
    class component_RunningJobCard_2f1856eb rootComponent
```

## Referenced By

- `VersionsContent` (RENDERS)

<!-- source: interface-stepdocumentation.md -->

# StepDocumentation

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/user-docs-generator.service.ts` (line 41)

Documentation for a single step

## Properties

| Property | Type |
|---|---|
| `stepNumber` | `number` |
| `title` | `string` |
| `content` | `string` |
| `screenshots` | `string[]` |
| `tips` | `string[]` |
| `warnings` | `string[]` |

<!-- source: function-usesuggestions.md -->

# useSuggestions

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useSuggestions.ts` (line 61)

useSuggestions - Hook for suggestion management with real-time updates

Provides suggestion state and operations with WebSocket support.

## Signature

```ts
function useSuggestions(options: UseSuggestionsOptions): UseSuggestionsReturn
```

## Parameters

| Name | Type |
|---|---|
| `options` | `UseSuggestionsOptions` |

**Returns:** `UseSuggestionsReturn`

<!-- source: interface-detecteddjangomodel.md -->

# DetectedDjangoModel

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/django-detector.ts` (line 70)

Detected Django model

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `tableName` | `string` |
| `fields` | `DjangoModelField[]` |
| `relationships` | `DjangoRelationship[]` |
| `meta` | `DjangoModelMeta` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getbranding.md -->

# getBranding

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/branding/branding.controller.ts` (line 13)

## Endpoint

`GET /projects/:projectId/branding`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `BrandingController` (MODULE_DECLARES)

<!-- source: component-imagewithbackend.md -->

# ImageWithBackend

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/images.tsx` (line 59)

## Diagram

```mermaid
graph TD
    component_ImageWithBackend_375df930["ImageWithBackend"]
    class component_ImageWithBackend_375df930 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `InsertImage`

<!-- source: constant-initialmarkdown.md -->

# initialMarkdown$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 236)

<!-- source: function-parsestateenum.md -->

# parseStateEnum

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/state-machine-analyzer.ts` (line 55)

Parse a state enum from code and extract all states

## Signature

```ts
function parseStateEnum(code: string, enumName: string): StateNode[]
```

## Parameters

| Name | Type |
|---|---|
| `code` | `string` |
| `enumName` | `string` |

**Returns:** `StateNode[]`

<!-- source: interface-projectstats.md -->

# ProjectStats

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 27)

Project statistics for context

## Properties

| Property | Type |
|---|---|
| `totalEntities` | `number` |
| `entityTypeBreakdown` | `Record<string, number>` |
| `totalRelationships` | `number` |
| `relationshipTypeBreakdown` | `Record<string, number>` |
| `framework` | `string` |

<!-- source: interface-retentionpolicy.md -->

# RetentionPolicy

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/checkpoint-backend.ts` (line 61)

## Properties

| Property | Type |
|---|---|
| `maxSnapshotsPerFile` | `number` |
| `maxTotalSnapshots` | `number` |
| `maxAgeDays` | `number` |
| `maxTotalBytes` | `number` |

<!-- source: component-screenshotreviewsection.md -->

# ScreenshotReviewSection

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/versions/[versionId]/review/page.tsx` (line 346)

Phase 4: Screenshot review section with coverage threshold check.

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `versionId` | `string` | ✓ | - |
| `router` | `any` | ✓ | - |
| `apiClient` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ScreenshotReviewSection_604f38c3["ScreenshotReviewSection"]
    class component_ScreenshotReviewSection_604f38c3 rootComponent
```

## Relationships

- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

## Referenced By

- `ReviewPage` (RENDERS)

<!-- source: interface-streamchunk.md -->

# StreamChunk

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/interfaces/ai-types.ts` (line 8)

## Properties

| Property | Type |
|---|---|
| `type` | `'text' | 'error' | 'done'` |
| `content` | `string` |
| `metadata` | `Record<string, any>` |

<!-- source: function-usetranslation.md -->

# useTranslation

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 1075)

<!-- source: interface-detecteddjangoserializer.md -->

# DetectedDjangoSerializer

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/django-detector.ts` (line 41)

Detected Django serializer

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `model` | `string` |
| `fields` | `DjangoField[]` |
| `readOnly` | `string[]` |
| `nestedSerializers` | `string[]` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getbycustomdomain.md -->

# getByCustomDomain

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 115)

## Endpoint

`GET /public/domain/:host`

| Parameter | In | Type | Required |
|---|---|---|---|
| `host` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: component-imagewithnobackend.md -->

# ImageWithNoBackend

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/images.tsx` (line 37)

## Diagram

```mermaid
graph TD
    component_ImageWithNoBackend_191a5931["ImageWithNoBackend"]
    class component_ImageWithNoBackend_191a5931 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `InsertImage`

<!-- source: constant-initialmarkdownnormalize.md -->

# initialMarkdownNormalize$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 244)

<!-- source: interface-propdefinition-2.md -->

# PropDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 419)

Prop definition for a component

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `required` | `boolean` |
| `defaultValue` | `string` |
| `description` | `string` |

<!-- source: function-registerdefaultparsers.md -->

# registerDefaultParsers

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/orchestrator/create-default-orchestrator.ts` (line 54)

Register the default parser set onto an existing orchestrator (idempotent per name).

## Signature

```ts
function registerDefaultParsers(orchestrator: ParserOrchestrator): ParserOrchestrator
```

## Parameters

| Name | Type |
|---|---|
| `orchestrator` | `ParserOrchestrator` |

**Returns:** `ParserOrchestrator`

<!-- source: interface-retryconfig-2.md -->

# RetryConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/retry-runner.ts` (line 16)

## Properties

| Property | Type |
|---|---|
| `maxAttempts` | `number` |
| `strategy` | `'best_patch' | 'first_pass'` |
| `scorer` | `(patch: string, task: BenchmarkTask) => Promise<number>` |
| `temperatureSchedule` | `number[]` |

<!-- source: component-screenshotscontent.md -->

# ScreenshotsContent

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/versions/[versionId]/screenshots/page.tsx` (line 25)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `versionId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ScreenshotsContent_5ae8d135["ScreenshotsContent"]
    class component_ScreenshotsContent_5ae8d135 rootComponent
```

## Relationships

- USES_HOOK → `useSession`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useEffect`

## Referenced By

- `ScreenshotDashboard` (RENDERS)

<!-- source: interface-submitfeedbackdto.md -->

# SubmitFeedbackDto

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/analytics/feedback.service.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `documentId` | `string` |
| `documentSlug` | `string` |
| `sessionId` | `string` |
| `rating` | `'HELPFUL' | 'NOT_HELPFUL'` |
| `comment` | `string` |
| `userAgent` | `string` |
| `country` | `string` |

<!-- source: function-usetranslation-2.md -->

# useTranslation

**Kind:** Function

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/i18n.tsx` (line 157)

## Signature

```ts
function useTranslation(): I18nContextValue
```

**Returns:** `I18nContextValue`

<!-- source: interface-detecteddjangoview.md -->

# DetectedDjangoView

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/django-detector.ts` (line 16)

Detected Django view

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `type` | `'function' | 'class' | 'viewset' | 'apiview'` |
| `methods` | `('GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE')[]` |
| `urlPath` | `string` |
| `permissions` | `string[]` |
| `serializer` | `string` |
| `model` | `string` |
| `actions` | `string[]` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getbyid.md -->

# getById

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/comment/comment.controller.ts` (line 106)

Get a single comment by ID

## Endpoint

`GET /documents/:documentId/comments/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `CommentController` (MODULE_DECLARES)

<!-- source: component-imagewithpreviewhook.md -->

# ImageWithPreviewHook

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/images.tsx` (line 214)

## Diagram

```mermaid
graph TD
    component_ImageWithPreviewHook_365a54b9["ImageWithPreviewHook"]
    class component_ImageWithPreviewHook_365a54b9 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`

<!-- source: constant-insert-image-command.md -->

# INSERT_IMAGE_COMMAND

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 421)

## Definition

```ts
LexicalCommand<InsertImagePayload>
```

<!-- source: interface-propertydefinition-2.md -->

# PropertyDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 616)

Property definition within a schema

## Properties

| Property | Type |
|---|---|
| `type` | `string` |
| `description` | `string` |
| `example` | `unknown` |
| `format` | `string` |
| `enum` | `string[]` |

<!-- source: function-renderentitypage.md -->

# renderEntityPage

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/entity-page.ts` (line 71)

## Signature

```ts
function renderEntityPage(entity: Entity, ctx: EntityPageContext): string
```

## Parameters

| Name | Type |
|---|---|
| `entity` | `Entity` |
| `ctx` | `EntityPageContext` |

**Returns:** `string`

<!-- source: interface-retryresult.md -->

# RetryResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/retry-runner.ts` (line 45)

## Properties

| Property | Type |
|---|---|
| `best` | `TaskResult` |
| `attempts` | `AttemptResult[]` |
| `passedAny` | `boolean` |
| `firstPassAttempt` | `number` |

<!-- source: component-section.md -->

# Section

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/IssueSidePanel.tsx` (line 903)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `title` | `string` | ✓ | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Section_9863545["Section"]
    class component_Section_9863545 rootComponent
```

## Referenced By

- `IssueSidePanel` (RENDERS)

<!-- source: interface-symbol.md -->

# Symbol

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/parser/interfaces/code-parser.interface.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `SymbolType` |
| `startLine` | `number` |
| `endLine` | `number` |
| `startColumn` | `number` |
| `endColumn` | `number` |
| `signature` | `string` |
| `docstring` | `string` |
| `modifiers` | `string[]` |
| `parameters` | `Parameter[]` |
| `returnType` | `string` |

<!-- source: function-uuidv4.md -->

# uuidv4

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/uuid4.ts` (line 2)

<!-- source: interface-detecteddotnetcontroller.md -->

# DetectedDotNetController

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/dotnet-detector.ts` (line 16)

Detected .NET controller

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `route` | `string` |
| `apiVersion` | `string` |
| `endpoints` | `DotNetEndpoint[]` |
| `dependencies` | `string[]` |
| `authorization` | `string[]` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getbyid-2.md -->

# getById

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/suggestion/suggestion.controller.ts` (line 52)

## Endpoint

`GET /documents/:documentId/suggestions/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `SuggestionController` (MODULE_DECLARES)

<!-- source: component-importstatements.md -->

# ImportStatements

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/jsx.tsx` (line 231)

## Diagram

```mermaid
graph TD
    component_ImportStatements_cf34037["ImportStatements"]
    class component_ImportStatements_cf34037 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useRef`
- USES_HOOK → `useState`

<!-- source: constant-insertcodeblock.md -->

# insertCodeBlock$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/index.ts` (line 82)

A signal that inserts a new code block into the editor with the published options.

<!-- source: interface-propinfo-2.md -->

# PropInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ast-helpers.ts` (line 30)

Information about a prop definition

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `required` | `boolean` |
| `defaultValue` | `string` |
| `description` | `string` |

<!-- source: function-researchcompetitorsonly.md -->

# researchCompetitorsOnly

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/ai-enhancement.ts` (line 150)

Research competitors without enhancing documentation
Useful for preview/testing

## Signature

```ts
async function researchCompetitorsOnly(aiProvider: { generateText: (prompt: string, options?: any) => Promise<string> }, projectType: string, projectDescription: string, maxCompetitors): Promise<CompetitorResearchResult>
```

## Parameters

| Name | Type |
|---|---|
| `aiProvider` | `{ generateText: (prompt: string, options?: any) => Promise<string> }` |
| `projectType` | `string` |
| `projectDescription` | `string` |
| `maxCompetitors` | `any` |

**Returns:** `Promise<CompetitorResearchResult>`

<!-- source: interface-reversibilityresult.md -->

# ReversibilityResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/permission-gate.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `tier` | `ReversibilityTier` |
| `label` | `string` |
| `warning` | `string` |
| `blocked` | `boolean` |

<!-- source: component-sectionlabel.md -->

# SectionLabel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/DeskCopilot.tsx` (line 46)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SectionLabel_52d0fa74["SectionLabel"]
    class component_SectionLabel_52d0fa74 rootComponent
```

## Referenced By

- `CustomerTabBody` (RENDERS)

<!-- source: interface-tableofcontentsitem.md -->

# TableOfContentsItem

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/user-docs-generator.service.ts` (line 53)

Table of contents item

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `slug` | `string` |
| `level` | `number` |
| `children` | `TableOfContentsItem[]` |

<!-- source: function-validatedocument.md -->

# validateDocument

**Kind:** Function

**Source:** `atloria-monorepo/packages/core/src/validators/document-validator.ts` (line 10)

Validates a document

## Signature

```ts
function validateDocument(doc: Partial<Document>): ValidationResult
```

## Parameters

| Name | Type |
|---|---|
| `doc` | `Partial<Document>` |

**Returns:** `ValidationResult`

<!-- source: interface-detecteddotnetservice.md -->

# DetectedDotNetService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/dotnet-detector.ts` (line 59)

Detected .NET service

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `interface` | `string` |
| `methods` | `DotNetMethod[]` |
| `dependencies` | `string[]` |
| `usesEF` | `boolean` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getbyid-3.md -->

# getById

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/template/template.controller.ts` (line 60)

Get a single template by ID.

## Endpoint

`GET /templates/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `TemplateController` (MODULE_DECLARES)

<!-- source: component-importstatementsnested.md -->

# ImportStatementsNested

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/jsx.tsx` (line 263)

## Diagram

```mermaid
graph TD
    component_ImportStatementsNested_53e55220["ImportStatementsNested"]
    class component_ImportStatementsNested_53e55220 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `Button`
- USES_HOOK → `useRef`
- USES_HOOK → `useState`
- USES_HOOK → `usePublisher`

<!-- source: constant-insertdecoratornode.md -->

# insertDecoratorNode$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 815)

Inserts a decorator node (constructed by the published factory) at the current selection.

<!-- source: interface-ratelimitinfo-2.md -->

# RateLimitInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 667)

Rate limit configuration

## Properties

| Property | Type |
|---|---|
| `requests` | `number` |
| `period` | `string` |
| `scope` | `'user' | 'ip' | 'global'` |

<!-- source: function-resolveopenapischemas.md -->

# resolveOpenApiSchemas

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/schema-resolver.ts` (line 198)

Resolve request/response schemas for a set of endpoints against a ts-morph Project,
assembling OpenAPI 3.1 `paths` (with `content.application/json.schema`) and the shared
`components.schemas`. Endpoints whose method/type cannot be resolved fall back to a bare
response description — they simply carry no schema, never a broken one.

## Signature

```ts
function resolveOpenApiSchemas(project: Project, endpoints: EndpointInput[]): OpenApiFragment
```

## Parameters

| Name | Type |
|---|---|
| `project` | `Project` |
| `endpoints` | `EndpointInput[]` |

**Returns:** `OpenApiFragment`

<!-- source: interface-reviewissue.md -->

# ReviewIssue

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/self-review.ts` (line 13)

Self-Review Pass

After implementation, generates a review prompt analyzing the diff
for quality issues, bugs, and missed edge cases.

Design: The review runs as a sub-agent with read-only tools, or as
a nudge injected into the main agent's instructions.

Opt-in via AutonomousTurnHookOptions.selfReview

## Properties

| Property | Type |
|---|---|
| `severity` | `'error' | 'warning' | 'info'` |
| `file` | `string` |
| `line` | `number` |
| `description` | `string` |

<!-- source: component-select.md -->

# Select

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Documents/FilterBar.tsx` (line 77)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `label` | `string` | ✓ | - |
| `value` | `string` | ✓ | - |
| `onChange` | `Function` | ✓ | - |
| `options` | `Array` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Select_2eea87b4["Select"]
    class component_Select_2eea87b4 rootComponent
```

## Referenced By

- `FilterBar` (RENDERS)

<!-- source: interface-techdocscuration.md -->

# TechdocsCuration

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/curation.ts` (line 8)

Curation (Phase 2.2): maintainers pin the entities readers should find first and hide
internal noise (generated helpers, migration scaffolding). Stored per-project in
project.settings.techdocsCuration and applied SERVER-SIDE when the snapshot is served,
so the sidebar tree, the Cmd+K palette and any future consumer inherit it for free.

## Properties

| Property | Type |
|---|---|
| `pinned` | `string[]` |
| `hidden` | `string[]` |

<!-- source: function-validateproject.md -->

# validateProject

**Kind:** Function

**Source:** `atloria-monorepo/packages/core/src/validators/project-validator.ts` (line 10)

Validates a project

## Signature

```ts
function validateProject(project: Partial<Project>): ValidationResult
```

## Parameters

| Name | Type |
|---|---|
| `project` | `Partial<Project>` |

**Returns:** `ValidationResult`

<!-- source: interface-detectedendpoint.md -->

# DetectedEndpoint

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/api-call-mapper.ts` (line 40)

A detected backend endpoint

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `method` | `'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'` |
| `path` | `string` |
| `entityId` | `string` |
| `filePath` | `string` |
| `handlerName` | `string` |
| `requestType` | `string` |
| `responseType` | `string` |
| `requiredRoles` | `string[]` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getbysubdomain.md -->

# getBySubdomain

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 97)

## Endpoint

`GET /public/subdomain/:slug`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slug` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: component-insertadmonition.md -->

# InsertAdmonition

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/InsertAdmonition.tsx` (line 15)

## Diagram

```mermaid
graph TD
    component_InsertAdmonition_7d1df671["InsertAdmonition"]
    class component_InsertAdmonition_7d1df671 rootComponent
```

## Relationships

- RENDERS → `ButtonOrDropdownButton`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useCellValue`
- USES_HOOK → `useTranslation`
- USES_HOOK → `useMemo`

<!-- source: constant-insertdirective.md -->

# insertDirective$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/directives/index.ts` (line 81)

A signal that inserts a new directive node with the published payload.

<!-- source: interface-reduxactionpattern.md -->

# ReduxActionPattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/redux-pattern-detector.ts` (line 19)

Redux action pattern

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `actionType` | `string` |
| `line` | `number` |
| `hasPayload` | `boolean` |
| `payloadType` | `string` |
| `asyncGroup` | `{
    type: 'start' | 'success' | 'failure';
    baseName: string;
  }` |

<!-- source: function-resolveopenapischemasfromdir.md -->

# resolveOpenApiSchemasFromDir

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/schema-resolver.ts` (line 300)

Resolve schemas for endpoints against a repo directory. Scopes the ts-morph project to the
endpoints' controller files + their imports (memory-bounded); falls back to a whole-dir glob
only when no file paths are available.

## Signature

```ts
function resolveOpenApiSchemasFromDir(rootDir: string, endpoints: EndpointInput[]): OpenApiFragment
```

## Parameters

| Name | Type |
|---|---|
| `rootDir` | `string` |
| `endpoints` | `EndpointInput[]` |

**Returns:** `OpenApiFragment`

<!-- source: interface-reviewresult.md -->

# ReviewResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/self-review.ts` (line 20)

## Properties

| Property | Type |
|---|---|
| `issues` | `ReviewIssue[]` |
| `approved` | `boolean` |
| `summary` | `string` |

<!-- source: component-sharerow.md -->

# ShareRow

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/analytics/AgentTrafficCockpit.tsx` (line 71)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `label` | `string` | ✓ | - |
| `count` | `number` | ✓ | - |
| `total` | `number` | ✓ | - |
| `color` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ShareRow_53d9ac5["ShareRow"]
    class component_ShareRow_53d9ac5 rootComponent
```

## Referenced By

- `AgentTrafficCockpit` (RENDERS)

<!-- source: interface-technicaldoccategory.md -->

# TechnicalDocCategory

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-materializer.service.ts` (line 74)

## Properties

| Property | Type |
|---|---|
| `slug` | `string` |
| `name` | `string` |
| `parentSlug` | `string | null` |
| `order` | `number` |

<!-- source: function-voidemitter.md -->

# voidEmitter

**Kind:** Function

**Source:** `atloria-monorepo/packages/editor/src/utils/voidEmitter.ts` (line 19)

Creates a void emitter.

<!-- source: interface-detectedexpressmiddleware.md -->

# DetectedExpressMiddleware

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/express-detector.ts` (line 40)

Detected Express middleware

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `type` | `'error' | 'auth' | 'validation' | 'logging' | 'custom'` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getbyurl.md -->

# getByUrl

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/public-document.controller.ts` (line 64)

## Endpoint

`GET /public/doc/:slugWithId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicDocumentController` (MODULE_DECLARES)

<!-- source: component-insertblocknodewithexpressionattribute.md -->

# InsertBlockNodeWithExpressionAttribute

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/jsx.tsx` (line 184)

## Diagram

```mermaid
graph TD
    component_InsertBlockNodeWithExpressionAttribute_66701348["InsertBlockNodeWithExpressionAttribute"]
    class component_InsertBlockNodeWithExpressionAttribute_66701348 rootComponent
```

## Relationships

- RENDERS → `Button`
- USES_HOOK → `usePublisher`

<!-- source: constant-insertfrontmatter.md -->

# insertFrontmatter$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/frontmatter/index.ts` (line 40)

Inserts a frontmatter node at the beginning of the markdown document.

<!-- source: interface-reduxreducerpattern.md -->

# ReduxReducerPattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/redux-pattern-detector.ts` (line 57)

Redux reducer pattern

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `sliceName` | `string` |
| `line` | `number` |
| `initialState` | `Record<string, unknown>` |
| `handlesActions` | `string[]` |
| `stateShape` | `Record<string, string>` |

<!-- source: interface-rollbacktooloptions.md -->

# RollbackToolOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/rollback.tool.ts` (line 11)

## Properties

| Property | Type |
|---|---|
| `checkpointManager` | `CheckpointManager` |

<!-- source: function-schematotstype.md -->

# schemaToTsType

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/sdk-generator.ts` (line 37)

JSON Schema (our pipeline's subset) → TypeScript type expression.

## Signature

```ts
function schemaToTsType(schema: JsonSchema | undefined, indent): string
```

## Parameters

| Name | Type |
|---|---|
| `schema` | `JsonSchema | undefined` |
| `indent` | `any` |

**Returns:** `string`

<!-- source: component-shimmer.md -->

# Shimmer

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/[ticketId]/page.tsx` (line 456)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `className` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Shimmer_610afd86["Shimmer"]
    class component_Shimmer_610afd86 rootComponent
```

## Referenced By

- `IssueDetailPageInner` (RENDERS)

<!-- source: interface-technicaldocpage.md -->

# TechnicalDocPage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-materializer.service.ts` (line 81)

## Properties

| Property | Type |
|---|---|
| `slug` | `string` |
| `title` | `string` |
| `content` | `string` |
| `pageType` | `'reference' | 'concept'` |
| `categorySlug` | `string` |
| `order` | `number` |
| `entityId` | `string` |

<!-- source: function-waitfor.md -->

# waitFor

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-core/src/test-helpers.ts` (line 17)

Helper to wait for a specific amount of time

## Signature

```ts
function waitFor(ms: number): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `ms` | `number` |

**Returns:** `Promise<void>`

<!-- source: interface-detectedexpressroute.md -->

# DetectedExpressRoute

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/express-detector.ts` (line 16)

Detected Express route

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `filePath` | `string` |
| `method` | `'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'ALL'` |
| `path` | `string` |
| `handlerName` | `string` |
| `middleware` | `string[]` |
| `queryParams` | `string[]` |
| `routeParams` | `string[]` |
| `bodyType` | `string` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getbyurl-2.md -->

# getByUrl

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 130)

## Endpoint

`GET /public/p/:slugWithId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: component-insertcodeblock.md -->

# InsertCodeBlock

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/InsertCodeBlock.tsx` (line 14)

## Diagram

```mermaid
graph TD
    component_InsertCodeBlock_533e1d5f["InsertCodeBlock"]
    class component_InsertCodeBlock_533e1d5f rootComponent
```

## Relationships

- RENDERS → `ButtonWithTooltip`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useCellValue`
- USES_HOOK → `useTranslation`

<!-- source: constant-insertimage.md -->

# insertImage$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 134)

A signal that inserts a new image node with the published payload.

<!-- source: interface-reduxselectorpattern.md -->

# ReduxSelectorPattern

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/redux-pattern-detector.ts` (line 92)

Redux selector pattern

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `line` | `number` |
| `isMemoized` | `boolean` |
| `statePath` | `string[]` |
| `dependsOn` | `string[]` |

<!-- source: interface-runcontext.md -->

# RunContext

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 106)

Run context passed to tools and instruction functions.

## Properties

| Property | Type |
|---|---|
| `data` | `TContext` |
| `signal` | `AbortSignal` |
| `nestingDepth` | `number` |

<!-- source: component-sidebysidediff.md -->

# SideBySideDiff

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/documents/[id]/compare/page.tsx` (line 630)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `diffLines` | `DiffLine[]` | ✓ | - |
| `fromRevision` | `DocumentRevision | null` | ✓ | - |
| `toRevision` | `DocumentRevision | null` | ✓ | - |
| `formatDate` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SideBySideDiff_c189fe1["SideBySideDiff"]
    class component_SideBySideDiff_c189fe1 rootComponent
```

## Relationships

- RENDERS → `MarkdownRenderer`
- RENDERS → `DiffChunkBlock`

## Referenced By

- `CompareDocumentsPage` (RENDERS)

<!-- source: function-snapshothashes.md -->

# snapshotHashes

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/staleness.ts` (line 47)

Map of entityId → signature hash for a whole snapshot.

## Signature

```ts
function snapshotHashes(entities: Entity[]): Record<string, string>
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `Entity[]` |

**Returns:** `Record<string, string>`

<!-- source: interface-technicaldocset.md -->

# TechnicalDocSet

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-materializer.service.ts` (line 100)

## Properties

| Property | Type |
|---|---|
| `categories` | `TechnicalDocCategory[]` |
| `documents` | `TechnicalDocPage[]` |

<!-- source: function-waitforelement-2.md -->

# waitForElement

**Kind:** Function

**Source:** `atloria-monorepo/packages/ui-core/src/test-helpers.ts` (line 23)

Helper to wait for an element to be updated

## Signature

```ts
async function waitForElement(element: HTMLElement): Promise<void>
```

## Parameters

| Name | Type |
|---|---|
| `element` | `HTMLElement` |

**Returns:** `Promise<void>`

<!-- source: interface-detectedfastapiroute.md -->

# DetectedFastAPIRoute

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/fastapi-detector.ts` (line 16)

Detected FastAPI route

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `filePath` | `string` |
| `method` | `'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'` |
| `path` | `string` |
| `functionName` | `string` |
| `requestModel` | `string` |
| `responseModel` | `string` |
| `dependencies` | `string[]` |
| `tags` | `string[]` |
| `deprecated` | `boolean` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getbyurlwithaudience.md -->

# getByUrlWithAudience

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/public-document.controller.ts` (line 21)

## Endpoint

`GET /public/doc/:audience/:slugWithId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `audience` | query | `string` | ✓ |
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicDocumentController` (MODULE_DECLARES)

<!-- source: component-insertfrontmatter.md -->

# InsertFrontmatter

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/InsertFrontmatter.tsx` (line 14)

## Diagram

```mermaid
graph TD
    component_InsertFrontmatter_3a44ff1f["InsertFrontmatter"]
    class component_InsertFrontmatter_3a44ff1f rootComponent
```

## Relationships

- RENDERS → `ButtonWithTooltip`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useCellValues`
- USES_HOOK → `useTranslation`

<!-- source: constant-insertjsx.md -->

# insertJsx$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/index.ts` (line 143)

A signal that inserts a new JSX node with the published payload.

<!-- source: interface-relationdefinition-2.md -->

# RelationDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 780)

Relation definition between models

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many'` |
| `targetModel` | `string` |
| `foreignKey` | `string` |
| `onDelete` | `'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION'` |
| `onUpdate` | `'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION'` |
| `relationTable` | `string` |

<!-- source: interface-runoptions.md -->

# RunOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 312)

Options for running an agent.

## Properties

| Property | Type |
|---|---|
| `context` | `TContext` |
| `maxTurns` | `number` |
| `signal` | `AbortSignal` |
| `stream` | `boolean` |
| `onProgress` | `ProgressCallback` |
| `turnHook` | `TurnHook<TContext>` |
| `guardrailRetries` | `number` |
| `onAgentStart` | `(agentName: string) => void` |
| `onAgentEnd` | `(agentName: string, output: string) => void` |
| `maxOutputRecoveries` | `number` |
| `toolVerificationHook` | `ToolVerificationHook` |
| `toolPreExecutionHook` | `ToolPreExecutionHook` |
| `previousResponseId` | `string` |
| `nestingDepth` | `number` |

<!-- source: component-siteurlfield.md -->

# SiteUrlField

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/page.tsx` (line 1759)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SiteUrlField_5eb3fb03["SiteUrlField"]
    class component_SiteUrlField_5eb3fb03 rootComponent
```

## Relationships

- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

## Referenced By

- `ProjectPage` (RENDERS)

<!-- source: function-sweepframeworkfilesforsymbols.md -->

# sweepFrameworkFilesForSymbols

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/symbol-sweep.ts` (line 18)

## Signature

```ts
async function sweepFrameworkFilesForSymbols(results: ParseResult[]): Promise<ParseResult[]>
```

## Parameters

| Name | Type |
|---|---|
| `results` | `ParseResult[]` |

**Returns:** `Promise<ParseResult[]>`

<!-- source: interface-technicaldocsjoboptions.md -->

# TechnicalDocsJobOptions

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-parser.service.ts` (line 23)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `organizationId` | `string` |
| `repoUrl` | `string` |
| `branch` | `string` |
| `credentials` | `{ username?: string; password?: string }` |
| `userId` | `string` |

<!-- source: function-withretry.md -->

# withRetry

**Kind:** Function

**Source:** `atloria-monorepo/packages/api-client/src/utils/retry.ts` (line 77)

Retry a function with exponential backoff

## Signature

```ts
async function withRetry(fn: () => Promise<T>, options: RetryOptions): Promise<T>
```

## Parameters

| Name | Type |
|---|---|
| `fn` | `() => Promise<T>` |
| `options` | `RetryOptions` |

**Returns:** `Promise<T>`

<!-- source: interface-detectedjpaentity.md -->

# DetectedJPAEntity

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/spring-detector.ts` (line 92)

Detected JPA entity

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `tableName` | `string` |
| `fields` | `JPAField[]` |
| `relationships` | `JPARelationship[]` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getcapabilities.md -->

# getCapabilities

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 585)

## Endpoint

`GET /public/p/:slugWithId/capabilities`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |
| `version` | query | `string` | - |
| `lang` | query | `string` | - |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: component-insertimagesignal.md -->

# InsertImageSignal

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/images.tsx` (line 137)

## Diagram

```mermaid
graph TD
    component_InsertImageSignal_19edc6cd["InsertImageSignal"]
    class component_InsertImageSignal_19edc6cd rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `InsertCustomImage`

<!-- source: constant-insertmarkdown.md -->

# insertMarkdown$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 415)

Inserts new markdown value into the current cursor position of the active editor.

<!-- source: interface-relationship-2.md -->

# Relationship

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/relationship.interface.ts` (line 202)

Relationship between two entities

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `type` | `RelationshipType` |
| `sourceId` | `string` |
| `targetId` | `string` |
| `metadata` | `RelationshipMetadata` |

<!-- source: interface-runresult.md -->

# RunResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 123)

Result of running an agent.

## Properties

| Property | Type |
|---|---|
| `output` | `string` |
| `outputJson` | `unknown` |
| `history` | `AgentHistoryItem[]` |
| `usage` | `TokenUsage` |
| `handedOff` | `boolean` |
| `finalAgentName` | `string` |
| `raw` | `unknown` |
| `responseId` | `string` |

<!-- source: component-sortabledocumentitem.md -->

# SortableDocumentItem

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/PublishingSidebar/SortableDocumentList.tsx` (line 72)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `document` | `Document` | ✓ | - |
| `isSelected` | `boolean` | ✓ | - |
| `editMode` | `boolean` | ✓ | - |
| `onSelect` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SortableDocumentItem_6869a021["SortableDocumentItem"]
    class component_SortableDocumentItem_6869a021 rootComponent
```

## Relationships

- RENDERS → `GripVertical`
- RENDERS → `FileText`
- USES_HOOK → `useSortable`

## Referenced By

- `SortableDocumentList` (RENDERS)

<!-- source: interface-technicaldocsjobpayload.md -->

# TechnicalDocsJobPayload

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-generation.service.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `organizationId` | `string` |
| `repoUrl` | `string` |
| `branch` | `string` |
| `credentials` | `{ username?: string; password?: string }` |
| `userId` | `string` |

<!-- source: function-validatecitations.md -->

# validateCitations

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/grounded-ask.ts` (line 45)

Keep only citations that correspond to a retrieved source path (drop hallucinated ones).

## Signature

```ts
function validateCitations(answer: string, context: DocSearchHit[]): string[]
```

## Parameters

| Name | Type |
|---|---|
| `answer` | `string` |
| `context` | `DocSearchHit[]` |

**Returns:** `string[]`

<!-- source: function-withretry-2.md -->

# withRetry

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/retry.ts` (line 87)

Execute an async operation with retry logic

## Signature

```ts
async function withRetry(operation: () => Promise<T>, config: RetryConfig): Promise<T>
```

## Parameters

| Name | Type |
|---|---|
| `operation` | `() => Promise<T>` |
| `config` | `RetryConfig` |

**Returns:** `Promise<T>`

<!-- source: interface-detectednestjscontroller.md -->

# DetectedNestJSController

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/nestjs-detector.ts` (line 16)

Detected NestJS controller

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `path` | `string` |
| `version` | `string` |
| `endpoints` | `NestJSEndpoint[]` |
| `dependencies` | `string[]` |
| `guards` | `string[]` |
| `interceptors` | `string[]` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getchangelog.md -->

# getChangelog

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 391)

## Endpoint

`GET /doc-versions/:projectId/:versionId/changelog`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-insertmarkdowntonestededitor.md -->

# InsertMarkdownToNestedEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/insert-markdown.tsx` (line 168)

## Diagram

```mermaid
graph TD
    component_InsertMarkdownToNestedEditor_d729e25["InsertMarkdownToNestedEditor"]
    class component_InsertMarkdownToNestedEditor_d729e25 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useRef`

<!-- source: constant-inserttable.md -->

# insertTable$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/table/index.ts` (line 57)

A signal that will insert a table with the published amount of rows and columns into the active editor.

<!-- source: interface-relationshipmetadata-2.md -->

# RelationshipMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/relationship.interface.ts` (line 233)

Metadata for relationships

## Properties

| Property | Type |
|---|---|
| `props` | `string[]` |
| `httpMethod` | `string` |
| `importType` | `'named' | 'default' | 'namespace' | 'side-effect'` |
| `foreignKey` | `string` |
| `line` | `number` |
| `optional` | `boolean` |
| `lazy` | `boolean` |
| `cascade` | `string[]` |

<!-- source: interface-runtimeconfig.md -->

# RuntimeConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/runtime-config.ts` (line 55)

## Properties

| Property | Type |
|---|---|
| `loop` | `LoopConfig` |
| `model` | `ModelProviderConfig` |
| `options` | `{
    tracingDisabled?: boolean;
    handoffInputFilter?: (data: unknown) => unknown;
  }` |

<!-- source: component-sparkline.md -->

# Sparkline

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/analytics/DeflectionCockpit.tsx` (line 40)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `values` | `number[]` | ✓ | - |
| `color` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Sparkline_26a4de2e["Sparkline"]
    class component_Sparkline_26a4de2e rootComponent
```

## Referenced By

- `KpiCard` (RENDERS)

<!-- source: interface-technicaldocsjobresult.md -->

# TechnicalDocsJobResult

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-parser.service.ts` (line 41)

## Properties

| Property | Type |
|---|---|
| `entityCount` | `number` |
| `relationshipCount` | `number` |
| `hasApiSpec` | `boolean` |
| `durationMs` | `number` |

<!-- source: function-validatecoverage.md -->

# validateCoverage

**Kind:** Function

**Source:** `atloria-monorepo/libs/parser-core/src/utils/coverage-validator.ts` (line 182)

Validate coverage against thresholds

## Signature

```ts
function validateCoverage(entities: Entity[], screenshots: EnhancedScreenshotMetadata[], interactions: UIInteraction[], thresholds: CoverageThresholds): ValidationReport
```

## Parameters

| Name | Type |
|---|---|
| `entities` | `Entity[]` |
| `screenshots` | `EnhancedScreenshotMetadata[]` |
| `interactions` | `UIInteraction[]` |
| `thresholds` | `CoverageThresholds` |

**Returns:** `ValidationReport`

<!-- source: function-withretrywrapper.md -->

# withRetryWrapper

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/retry.ts` (line 142)

Create a retryable version of an async function

## Signature

```ts
function withRetryWrapper(fn: (...args: TArgs) => Promise<TResult>, config: RetryConfig): (...args: TArgs) => Promise<TResult>
```

## Parameters

| Name | Type |
|---|---|
| `fn` | `(...args: TArgs) => Promise<TResult>` |
| `config` | `RetryConfig` |

**Returns:** `(...args: TArgs) => Promise<TResult>`

<!-- source: interface-detectednestjsservice.md -->

# DetectedNestJSService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/nestjs-detector.ts` (line 69)

Detected NestJS service

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `methods` | `NestJSMethod[]` |
| `dependencies` | `string[]` |
| `usesPrisma` | `boolean` |
| `usesTypeORM` | `boolean` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getchathistory.md -->

# getChatHistory

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.controller.ts` (line 159)

## Endpoint

`GET /support-agent/:projectId/agents/:agentId/history`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `agentId` | query | `string` | ✓ |
| `limit` | query | `string` | - |

## Referenced By

- `SupportAgentController` (MODULE_DECLARES)

<!-- source: component-insertmarkdownwithtableandlist.md -->

# InsertMarkdownWithTableAndList

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/insert-markdown.tsx` (line 115)

## Diagram

```mermaid
graph TD
    component_InsertMarkdownWithTableAndList_d306937["InsertMarkdownWithTableAndList"]
    class component_InsertMarkdownWithTableAndList_d306937 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `InsertComplexMarkdownButton`

<!-- source: constant-insertthematicbreak.md -->

# insertThematicBreak$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/thematic-break/index.ts` (line 13)

Inserts a thematic break at the current selection.

<!-- source: interface-relationshipwithentities-2.md -->

# RelationshipWithEntities

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/relationship.interface.ts` (line 283)

Relationship with full entity information (for graph queries)

## Properties

| Property | Type |
|---|---|
| `relationship` | `Relationship` |
| `source` | `TSource` |
| `target` | `TTarget` |

<!-- source: interface-scoredissue.md -->

# ScoredIssue

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/confidence-filter.ts` (line 18)

Confidence-Based Code Review Filter

Parses, filters, deduplicates, and formats scored issues from multiple
review agents. Each issue has a confidence score (0-100) that determines
whether it should surface to the user.

Supports two output formats from agents:
1. Line format: `[confidence: 85] (critical/bug) file.ts:42 — Description. Suggestion: fix`
2. JSON array format: `[{"confidence": 85, "file": "...", ...}]`

## Properties

| Property | Type |
|---|---|
| `description` | `string` |
| `file` | `string` |
| `line` | `number` |
| `confidence` | `number` |
| `severity` | `'critical' | 'important' | 'minor'` |
| `category` | `string` |
| `source` | `string` |
| `suggestion` | `string` |

<!-- source: component-stat.md -->

# Stat

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/ops/page.tsx` (line 29)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `label` | `string` | ✓ | - |
| `value` | `unknown` | ✓ | - |
| `sub` | `string` | - | - |
| `tone` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_Stat_72419b77["Stat"]
    class component_Stat_72419b77 rootComponent
```

## Referenced By

- `OpsPage` (RENDERS)

<!-- source: interface-technicaldocsqueuejob.md -->

# TechnicalDocsQueueJob

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-queue.service.ts` (line 13)

## Properties

| Property | Type |
|---|---|
| `jobId` | `string | null` |
| `options` | `TechnicalDocsJobPayload & { limit?: number }` |
| `kind` | `'generate' | 'index' | 'enrich'` |

<!-- source: function-wraperror.md -->

# wrapError

**Kind:** Function

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/errors.ts` (line 260)

Utility to wrap unknown errors in PipelineError

## Signature

```ts
function wrapError(error: unknown, stage: JobStage, message: string): PipelineError
```

## Parameters

| Name | Type |
|---|---|
| `error` | `unknown` |
| `stage` | `JobStage` |
| `message` | `string` |

**Returns:** `PipelineError`

<!-- source: interface-detectednextjsapiroute.md -->

# DetectedNextJSAPIRoute

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/nextjs-detector.ts` (line 44)

Detected Next.js API route

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `filePath` | `string` |
| `routePath` | `string` |
| `methods` | `('GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE')[]` |
| `isAppRouter` | `boolean` |
| `requestType` | `string` |
| `responseType` | `string` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getconfig.md -->

# getConfig

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/saml/saml.controller.ts` (line 83)

Get SAML configuration

## Endpoint

`GET /auth/saml/:orgId/config`

| Parameter | In | Type | Required |
|---|---|---|---|
| `orgId` | query | `string` | ✓ |

## Referenced By

- `SamlController` (MODULE_DECLARES)

<!-- source: component-insertsandpack.md -->

# InsertSandpack

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/InsertSandpack.tsx` (line 12)

## Diagram

```mermaid
graph TD
    component_InsertSandpack_6acaa0e1["InsertSandpack"]
    class component_InsertSandpack_6acaa0e1 rootComponent
```

## Relationships

- RENDERS → `ButtonOrDropdownButton`
- USES_HOOK → `useCellValues`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useMemo`
- USES_HOOK → `useTranslation`

<!-- source: constant-is-apple.md -->

# IS_APPLE

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/utils/detectMac.ts` (line 8)

Used to detect if the current platform is Apple based, mostly for keyboard shortcuts.

## Definition

```ts
boolean
```

<!-- source: interface-resolvedoperation.md -->

# ResolvedOperation

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/schema-resolver.ts` (line 28)

## Properties

| Property | Type |
|---|---|
| `requestBody` | `OpenApiRef` |
| `responses` | `Record<string, ResolvedResponse>` |

<!-- source: interface-searchmodeldeployment.md -->

# SearchModelDeployment

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/web-search.tool.ts` (line 28)

Azure OpenAI model deployment for web search grounding.
Each deployment has its own rate limit bucket.

## Properties

| Property | Type |
|---|---|
| `endpoint` | `string` |
| `apiKey` | `string` |
| `model` | `string` |
| `apiVersion` | `string` |
| `useV1Endpoint` | `boolean` |

<!-- source: component-statcard-2.md -->

# StatCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/page.tsx` (line 239)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `icon` | `unknown` | ✓ | - |
| `label` | `string` | ✓ | - |
| `value` | `number` | ✓ | - |
| `color` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StatCard_4d0fd575["StatCard"]
    class component_StatCard_4d0fd575 rootComponent
```

## Referenced By

- `ProjectsPage` (RENDERS)

<!-- source: interface-technicalnavmap.md -->

# TechnicalNavMap

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-materializer.service.ts` (line 52)

## Properties

| Property | Type |
|---|---|
| `apps` | `NavSection[]` |
| `libs` | `NavSection[]` |
| `other` | `NavTypeGroup[]` |

<!-- source: interface-detectednextjspage.md -->

# DetectedNextJSPage

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/nextjs-detector.ts` (line 17)

Detected Next.js page/component

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `routerType` | `'app' | 'pages'` |
| `routePath` | `string` |
| `renderingType` | `'server' | 'client' | 'unknown'` |
| `isStaticRoute` | `boolean` |
| `hasLoadingState` | `boolean` |
| `hasErrorBoundary` | `boolean` |
| `hasMetadata` | `boolean` |
| `dataFetching` | `('fetch' | 'getServerSideProps' | 'getStaticProps' | 'use')[]` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getconfig-2.md -->

# getConfig

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 61)

## Endpoint

`GET /doc-automation/config/:projectId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: component-insertsimplemarkdown.md -->

# InsertSimpleMarkdown

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/insert-markdown.tsx` (line 75)

## Diagram

```mermaid
graph TD
    component_InsertSimpleMarkdown_4059f692["InsertSimpleMarkdown"]
    class component_InsertSimpleMarkdown_4059f692 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `InsertSimpleMarkdownButton`

<!-- source: constant-is-bold.md -->

# IS_BOLD

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/FormatConstants.ts` (line 3)

<!-- source: interface-resolvedresponse.md -->

# ResolvedResponse

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/openapi/schema-resolver.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `description` | `string` |
| `schema` | `Record<string, unknown>` |

<!-- source: interface-searchresult-3.md -->

# SearchResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/types.ts` (line 36)

A search hit.

## Properties

| Property | Type |
|---|---|
| `chunk` | `CodeChunk` |
| `score` | `number` |
| `vectorScore` | `number` |
| `bm25Score` | `number` |

<!-- source: component-statcard-3.md -->

# StatCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/UsageDashboard.tsx` (line 135)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `label` | `string` | ✓ | - |
| `value` | `string` | ✓ | - |
| `icon` | `string` | ✓ | - |
| `bgColor` | `string` | ✓ | - |
| `textColor` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StatCard_6eca61b2["StatCard"]
    class component_StatCard_6eca61b2 rootComponent
```

## Referenced By

- `UsageDashboard` (RENDERS)

<!-- source: interface-ticketitem.md -->

# TicketItem

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/technical-docs/techdocs-sources.service.ts` (line 15)

A pulled ticket/conversation with the `updatedAt` used to advance a connector's sync cursor.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `subject` | `string` |
| `body` | `string` |
| `updatedAt` | `string` |

<!-- source: interface-detectedpydanticmodel.md -->

# DetectedPydanticModel

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/fastapi-detector.ts` (line 42)

Detected Pydantic model

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `baseClass` | `string` |
| `fields` | `PydanticField[]` |
| `validators` | `string[]` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getconfig-3.md -->

# getConfig

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.controller.ts` (line 41)

GET /support-agent/:projectId/config
Returns the support agent config for a project, or null if not configured.

## Endpoint

`GET /support-agent/:projectId/config`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `SupportAgentController` (MODULE_DECLARES)

<!-- source: component-inserttable.md -->

# InsertTable

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/InsertTable.tsx` (line 22)

## Diagram

```mermaid
graph TD
    component_InsertTable_ede8c9f["InsertTable"]
    class component_InsertTable_ede8c9f rootComponent
```

## Relationships

- RENDERS → `ButtonWithTooltip`
- USES_HOOK → `useCellValue`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useTranslation`

<!-- source: constant-is-code.md -->

# IS_CODE

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/FormatConstants.ts` (line 7)

<!-- source: interface-responsedefinition-2.md -->

# ResponseDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 636)

Response definition

## Properties

| Property | Type |
|---|---|
| `statusCode` | `number` |
| `description` | `string` |
| `schema` | `SchemaDefinition` |
| `examples` | `Record<string, unknown>` |

<!-- source: interface-sectioncontext.md -->

# SectionContext

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/prompt-sections.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `mode` | `TaskMode` |
| `modelProfile` | `ModelCapabilityProfile` |

<!-- source: component-statusbadge.md -->

# StatusBadge

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/enterprise/screenshots/page.tsx` (line 22)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `status` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StatusBadge_3a39041b["StatusBadge"]
    class component_StatusBadge_3a39041b rootComponent
```

## Referenced By

- `ScreenshotsPage` (RENDERS)

<!-- source: interface-tickettopicproposal-2.md -->

# TicketTopicProposal

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/manuals-insights/manuals-insights.service.ts` (line 80)

One redacted, human-facing content-loop proposal (what the cockpit/GET returns).

## Properties

| Property | Type |
|---|---|
| `topicKey` | `string` |
| `title` | `string` |
| `ticketCount` | `number` |
| `exampleQuestions` | `string[]` |
| `suggestedAnswerSourcePages` | `Array<{ slug: string; title: string }>` |
| `alreadyDocumented` | `false` |

<!-- source: interface-detectedreactcomponent.md -->

# DetectedReactComponent

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/react-detector.ts` (line 13)

Detected React component

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `type` | `'functional' | 'class'` |
| `filePath` | `string` |
| `propsType` | `string` |
| `stateManagement` | `string[]` |
| `hooks` | `string[]` |
| `childComponents` | `string[]` |
| `eventHandlers` | `string[]` |
| `formElements` | `string[]` |
| `apiCalls` | `string[]` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getcustomdomain.md -->

# getCustomDomain

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 362)

## Endpoint

`GET /projects/:id/custom-domain`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: component-insertthematicbreak.md -->

# InsertThematicBreak

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/InsertThematicBreak.tsx` (line 12)

## Diagram

```mermaid
graph TD
    component_InsertThematicBreak_1b8faf9f["InsertThematicBreak"]
    class component_InsertThematicBreak_1b8faf9f rootComponent
```

## Relationships

- RENDERS → `ButtonWithTooltip`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useCellValue`
- USES_HOOK → `useTranslation`

<!-- source: constant-is-highlight.md -->

# IS_HIGHLIGHT

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/FormatConstants.ts` (line 10)

<!-- source: interface-route.md -->

# Route

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 124)

## Properties

| Property | Type |
|---|---|
| `path` | `string` |
| `component` | `string` |
| `method` | `string` |
| `parameters` | `string[]` |
| `guards` | `string[]` |
| `filePath` | `string` |
| `lineNumber` | `number` |

<!-- source: interface-semanticindexconfig.md -->

# SemanticIndexConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/types.ts` (line 44)

Configuration for the semantic index.

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `embeddingEndpoint` | `string` |
| `embeddingApiKey` | `string` |
| `embeddingModel` | `string` |
| `storageDir` | `string` |
| `targetChunkTokens` | `number` |
| `maxFiles` | `number` |
| `includeExtensions` | `string[]` |
| `excludeDirs` | `string[]` |

<!-- source: component-statusbadge-2.md -->

# StatusBadge

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/ProviderConfig.tsx` (line 114)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `available` | `boolean` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StatusBadge_429048bd["StatusBadge"]
    class component_StatusBadge_429048bd rootComponent
```

## Referenced By

- `ProviderConfig` (RENDERS)

<!-- source: interface-timelinestats.md -->

# TimelineStats

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/dto/document-stats.dto.ts` (line 15)

Timeline statistics

## Properties

| Property | Type |
|---|---|
| `date` | `string` |
| `revisions` | `number` |
| `versions` | `number` |

<!-- source: interface-detectedspringcontroller.md -->

# DetectedSpringController

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/spring-detector.ts` (line 16)

Detected Spring controller

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `basePath` | `string` |
| `isRestController` | `boolean` |
| `endpoints` | `SpringEndpoint[]` |
| `dependencies` | `string[]` |
| `security` | `string[]` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getdailytraffic.md -->

# getDailyTraffic

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 74)

## Endpoint

`GET /analytics/:projectId/daily-traffic`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: constant-is-italic.md -->

# IS_ITALIC

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/FormatConstants.ts` (line 4)

<!-- source: component-jsxeditorcontainer.md -->

# JsxEditorContainer

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/LexicalJsxNode.tsx` (line 105)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `parentEditor` | `LexicalEditor` | ✓ | - |
| `lexicalJsxNode` | `LexicalJsxNode` | ✓ | - |
| `mdastNode` | `MdastJsx` | ✓ | - |
| `config` | `EditorConfig` | ✓ | - |
| `focusEmitter` | `VoidEmitter` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_JsxEditorContainer_7000f178["JsxEditorContainer"]
    class component_JsxEditorContainer_7000f178 rootComponent
```

## Relationships

- RENDERS → `NestedEditorsContext-Provider`
- RENDERS → `Editor`
- USES_HOOK → `useCellValue`

<!-- source: interface-routerlinkelement.md -->

# RouterLinkElement

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/template-analysis.interface.ts` (line 140)

Router link element (routerLink, router-link)

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `path` | `string` |
| `isDynamic` | `boolean` |
| `line` | `number` |
| `conditionalOn` | `string` |
| `params` | `Record<string, string>` |

<!-- source: interface-semanticsearchtooloptions.md -->

# SemanticSearchToolOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/semantic-search.tool.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `embeddingEndpoint` | `string` |
| `embeddingApiKey` | `string` |
| `embeddingModel` | `string` |
| `storageDir` | `string` |
| `includeExtensions` | `string[]` |
| `excludeDirs` | `string[]` |
| `maxFiles` | `number` |

<!-- source: component-statusbadge-3.md -->

# StatusBadge

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/RequestHistory.tsx` (line 152)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `status` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StatusBadge_2b1de691["StatusBadge"]
    class component_StatusBadge_2b1de691 rootComponent
```

## Referenced By

- `RequestHistory` (RENDERS)

<!-- source: interface-tocentry.md -->

# TocEntry

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/services/toc-builder.service.ts` (line 3)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `text` | `string` |
| `level` | `number` |
| `children` | `TocEntry[]` |

<!-- source: interface-detectedspringservice.md -->

# DetectedSpringService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/spring-detector.ts` (line 56)

Detected Spring service

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `methods` | `SpringMethod[]` |
| `dependencies` | `string[]` |
| `isTransactional` | `boolean` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getdata.md -->

# getData

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/app/app.controller.ts` (line 9)

## Endpoint

`GET /`

## Referenced By

- `AppController` (MODULE_DECLARES)

<!-- source: constant-is-strikethrough.md -->

# IS_STRIKETHROUGH

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/FormatConstants.ts` (line 5)

<!-- source: component-jsxexpression.md -->

# JsxExpression

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/jsx.tsx` (line 136)

## Diagram

```mermaid
graph TD
    component_JsxExpression_23fa3ae7["JsxExpression"]
    class component_JsxExpression_23fa3ae7 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: interface-scannedfile.md -->

# ScannedFile

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/file-scanner.ts` (line 19)

Scanned file information

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `relativePath` | `string` |
| `size` | `number` |
| `extension` | `string` |
| `fileName` | `string` |
| `modifiedAt` | `Date` |
| `content` | `string` |

<!-- source: interface-sendmessageoptions.md -->

# SendMessageOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/send-message.tool.ts` (line 59)

## Properties

| Property | Type |
|---|---|
| `bus` | `MessageBus` |

<!-- source: component-statusbadge-4.md -->

# StatusBadge

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Suggestions/SuggestionCard.tsx` (line 140)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `status` | `unknown | unknown | unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StatusBadge_4325f69b["StatusBadge"]
    class component_StatusBadge_4325f69b rootComponent
```

## Referenced By

- `SuggestionCard` (RENDERS)

<!-- source: interface-tokenusage.md -->

# TokenUsage

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/interfaces/ai-provider.interface.ts` (line 8)

## Properties

| Property | Type |
|---|---|
| `inputTokens` | `number` |
| `outputTokens` | `number` |
| `totalTokens` | `number` |

<!-- source: interface-detectedstatemachine.md -->

# DetectedStateMachine

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/state-machine-detector.ts` (line 14)

Detected state machine or workflow

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `type` | `'enum' | 'xstate' | 'custom' | 'status_field'` |
| `states` | `StateDefinition[]` |
| `transitions` | `StateTransition[]` |
| `entityId` | `string` |
| `filePath` | `string` |
| `confidence` | `'high' | 'medium' | 'low'` |
| `reason` | `string` |

<!-- source: api-endpoint-getdeliveries.md -->

# getDeliveries

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 277)

## Endpoint

`GET /doc-automation/config/:projectId/deliveries`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: constant-is-subscript.md -->

# IS_SUBSCRIPT

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/FormatConstants.ts` (line 8)

<!-- source: component-jsxfragment.md -->

# JsxFragment

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/jsx.tsx` (line 150)

## Diagram

```mermaid
graph TD
    component_JsxFragment_4682ada1["JsxFragment"]
    class component_JsxFragment_4682ada1 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: interface-schemadefinition-2.md -->

# SchemaDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 599)

Schema definition for request/response bodies

## Properties

| Property | Type |
|---|---|
| `type` | `string` |
| `properties` | `Record<string, PropertyDefinition>` |
| `required` | `string[]` |
| `$ref` | `string` |

<!-- source: interface-sessioncontext.md -->

# SessionContext

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/session-memory.ts` (line 41)

Input for memory extraction.

## Properties

| Property | Type |
|---|---|
| `task` | `string` |
| `history` | `AgentHistoryItem[]` |
| `notes` | `AgentNote[]` |
| `qualityGates` | `{ id: string; description: string; passed: boolean }[]` |
| `durationSeconds` | `number` |
| `turnCount` | `number` |

<!-- source: component-statusicon.md -->

# StatusIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/BatchFileProcessor.tsx` (line 232)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `status` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StatusIcon_47b9dfd5["StatusIcon"]
    class component_StatusIcon_47b9dfd5 rootComponent
```

## Referenced By

- `BatchFileProcessor` (RENDERS)

<!-- source: interface-trackusageparams.md -->

# TrackUsageParams

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/ai-usage.service.ts` (line 59)

## Properties

| Property | Type |
|---|---|
| `organizationId` | `string` |
| `projectId` | `string` |
| `userId` | `string` |
| `provider` | `string` |
| `model` | `string` |
| `operationType` | `string` |
| `entityType` | `string` |
| `entityId` | `string` |
| `usage` | `TokenUsage` |
| `metadata` | `Record<string, any>` |
| `skipCreditDeduction` | `boolean` |

<!-- source: interface-detectedsveltecomponent.md -->

# DetectedSvelteComponent

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/svelte-detector.ts` (line 16)

Detected Svelte component

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `props` | `SvelteProp[]` |
| `events` | `string[]` |
| `slots` | `string[]` |
| `reactiveStatements` | `number` |
| `stores` | `string[]` |
| `actions` | `string[]` |
| `childComponents` | `string[]` |
| `svelteKit` | `{
    isPage: boolean;
    isLayout: boolean;
    hasLoad: boolean;
    hasActions: boolean;
  }` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getdevicebreakdown.md -->

# getDeviceBreakdown

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 85)

## Endpoint

`GET /analytics/:projectId/devices`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: constant-is-superscript.md -->

# IS_SUPERSCRIPT

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/FormatConstants.ts` (line 9)

<!-- source: component-jsximage.md -->

# JsxImage

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/images.tsx` (line 195)

## Diagram

```mermaid
graph TD
    component_JsxImage_3f1fc077["JsxImage"]
    class component_JsxImage_3f1fc077 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`

<!-- source: interface-screenshotinstruction.md -->

# ScreenshotInstruction

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/screenshot-instruction-generator.ts` (line 29)

Single screenshot instruction

## Properties

| Property | Type |
|---|---|
| `priority` | `'critical' | 'high' | 'medium' | 'low'` |
| `stateMachine` | `string` |
| `state` | `string` |
| `component` | `string` |
| `componentPath` | `string` |
| `url` | `string` |
| `queryParams` | `Record<string, string>` |
| `setupSteps` | `string[]` |
| `filename` | `string` |
| `notes` | `string[]` |
| `availableTransitions` | `string[]` |
| `requiresApproval` | `boolean` |
| `isTerminal` | `boolean` |

<!-- source: interface-sessioneventmap.md -->

# SessionEventMap

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/types.ts` (line 44)

Typed event map for AgentSession.
Consumers call `session.on('tool_start', (e) => ...)` with full type safety.

## Properties

| Property | Type |
|---|---|
| `agent_thinking` | `{ agentName: string }` |
| `tool_start` | `{ toolName: string; input: string }` |
| `tool_end` | `{ toolName: string; outputPreview: string; durationMs: number }` |
| `agent_message` | `{ text: string; agentName: string; delta?: boolean }` |
| `turn_complete` | `{ turnNumber: number; usage: TokenUsage }` |
| `session_complete` | `{ totalUsage: TokenUsage; turnCount: number }` |
| `error` | `{ error: Error; recoverable: boolean }` |
| `status` | `{ code: string; message: string }` |
| `user_input_queued` | `{ message: string; position: number }` |
| `plan_ready` | `{ plan: string }` |
| `plan_approved` | `{}` |
| `model_switched` | `{ from: string; to: string; reason: string }` |
| `verbose` | `{ category: string; message: string; data?: Record<string, unknown>; timestamp: number }` |
| `session_start` | `{ model: string; workspace?: string }` |
| `session_end` | `{ totalUsage: TokenUsage; turnCount: number; reason: 'completed' | 'error' | 'cancelled' }` |
| `pre_compact` | `{ turnNumber: number; tokenCount: number; recentFiles: string[] }` |
| `post_compact` | `{ turnNumber: number; summaryInjected: boolean }` |
| `subagent_start` | `{ agentName: string; task: string }` |
| `subagent_end` | `{ agentName: string; output: string; durationMs: number }` |
| `user_prompt_submit` | `{ message: string }` |

<!-- source: component-statusjourney.md -->

# StatusJourney

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/[ticketId]/page.tsx` (line 181)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `current` | `string` | ✓ | - |
| `size` | `unknown | unknown` | - | "sm" |

## Diagram

```mermaid
graph TD
    component_StatusJourney_91ed227["StatusJourney"]
    class component_StatusJourney_91ed227 rootComponent
```

## Relationships

- RENDERS → `React-Fragment`
- RENDERS → `motion-div`
- RENDERS → `opt-icon`

## Referenced By

- `IssueDetailPageInner` (RENDERS)

<!-- source: interface-troubleshootingitem.md -->

# TroubleshootingItem

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/tutorial-generator.service.ts` (line 52)

## Properties

| Property | Type |
|---|---|
| `issue` | `string` |
| `solution` | `string` |

<!-- source: interface-detectedtechstack.md -->

# DetectedTechStack

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/framework.types.ts` (line 80)

Complete detected tech stack for a project

## Properties

| Property | Type |
|---|---|
| `frontend` | `{
    framework: FrontendFramework;
    version?: string;
    language: 'typescript' | 'javascript';
    uiLibrary: UILibrary;
    stateManagement: StateManagement;
    router?: string; // react-router, vue-router, etc.
    formLibrary?: string; // react-hook-form, formik, vee-validate
    validationLibrary?: string; // yup, zod, joi
  }` |
| `backend` | `{
    framework: BackendFramework;
    version?: string;
    language:
      | 'typescript'
      | 'javascript'
      | 'python'
      | 'csharp'
      | 'java'
      | 'ruby'
      | 'php';
    orm?: string; // prisma, typeorm, ef-core, sqlalchemy
    validationLibrary?: string; // class-validator, pydantic, data-annotations
  }` |
| `database` | `{
    type: 'postgresql' | 'mysql' | 'mongodb' | 'sqlite' | 'mssql' | 'unknown';
    orm?: string;
  }` |
| `isMonorepo` | `boolean` |
| `isFullStack` | `boolean` |
| `confidence` | `'high' | 'medium' | 'low'` |
| `detectionSource` | `string[]` |

<!-- source: api-endpoint-getdocument.md -->

# getDocument

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 479)

## Endpoint

`GET /public/p/:slugWithId/audiences/:audienceSlug/documents/:documentSlug`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |
| `audienceSlug` | query | `string` | ✓ |
| `documentSlug` | query | `string` | ✓ |
| `version` | query | `string` | - |
| `lang` | query | `string` | - |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-is-underline.md -->

# IS_UNDERLINE

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/FormatConstants.ts` (line 6)

<!-- source: component-kitchensinktoolbar.md -->

# KitchenSinkToolbar

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/KitchenSinkToolbar.tsx` (line 40)

## Diagram

```mermaid
graph TD
    component_KitchenSinkToolbar_2b1e513d["KitchenSinkToolbar"]
    class component_KitchenSinkToolbar_2b1e513d rootComponent
```

## Relationships

- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `ConditionalContents`
- RENDERS → `ChangeCodeMirrorLanguage`
- RENDERS → `ShowSandpackInfo`
- RENDERS → `UndoRedo`
- RENDERS → `Separator`
- RENDERS → `BoldItalicUnderlineToggles`
- RENDERS → `CodeToggle`
- RENDERS → `HighlightToggle`
- RENDERS → `StrikeThroughSupSubToggles`
- RENDERS → `ListsToggle`
- RENDERS → `ChangeAdmonitionType`
- RENDERS → `BlockTypeSelect`
- RENDERS → `CreateLink`
- RENDERS → `InsertImage`
- RENDERS → `InsertTable`
- RENDERS → `InsertThematicBreak`
- RENDERS → `InsertCodeBlock`
- RENDERS → `InsertSandpack`
- RENDERS → `InsertAdmonition`
- RENDERS → `InsertFrontmatter`

<!-- source: interface-screenshotmetadata-2.md -->

# ScreenshotMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/storage.interface.ts` (line 20)

Screenshot metadata for intelligent regeneration

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `url` | `string` |
| `viewport` | `{
    width: number;
    height: number;
  }` |
| `stateType` | `'default' | 'hover' | 'modal' | 'error' | 'success' | 'loading'` |
| `flowStepId` | `string` |
| `browser` | `'chromium' | 'firefox' | 'webkit'` |
| `fullPage` | `boolean` |
| `contentHash` | `string` |
| `capturedAt` | `Date` |
| `customMetadata` | `Record<string, string>` |

<!-- source: interface-sessionjournalconfig.md -->

# SessionJournalConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/session-journal.ts` (line 40)

## Properties

| Property | Type |
|---|---|
| `workDir` | `string` |
| `filename` | `string` |
| `maxEntries` | `number` |

<!-- source: component-statusjourney-2.md -->

# StatusJourney

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/issues/[ticketNumber]/page.tsx` (line 205)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `current` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StatusJourney_53ae911d["StatusJourney"]
    class component_StatusJourney_53ae911d rootComponent
```

## Referenced By

- `PublicTicketPage` (RENDERS)

<!-- source: interface-tutorialcontent.md -->

# TutorialContent

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/tutorial-generator.service.ts` (line 9)

Generated tutorial content

## Properties

| Property | Type |
|---|---|
| `tutorialId` | `string` |
| `title` | `string` |
| `description` | `string` |
| `difficulty` | `string` |
| `estimatedTime` | `string` |
| `category` | `string` |
| `tags` | `string[]` |
| `prerequisites` | `{
    requirements: string[];
    requiredRole?: string;
    beforeYouBegin?: string;
  }` |
| `overview` | `string` |
| `steps` | `TutorialStep[]` |
| `whatYouLearned` | `string` |
| `nextSteps` | `string[]` |
| `tips` | `string[]` |
| `commonMistakes` | `string[]` |
| `troubleshooting` | `TroubleshootingItem[]` |
| `generatedAt` | `Date` |
| `tokensUsed` | `number` |

<!-- source: interface-detecteduicomponent.md -->

# DetectedUIComponent

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/ui-library-detector.ts` (line 17)

Detected UI component usage

## Properties

| Property | Type |
|---|---|
| `library` | `UILibrary` |
| `componentName` | `string` |
| `entityId` | `string` |
| `filePath` | `string` |
| `propsUsed` | `string[]` |
| `eventsHandled` | `string[]` |
| `isFormElement` | `boolean` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getdocumentactivities.md -->

# getDocumentActivities

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/activity/activity.controller.ts` (line 25)

## Endpoint

`GET /activities/documents/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ActivityController` (MODULE_DECLARES)

<!-- source: constant-jsxcomponentdescriptors.md -->

# jsxComponentDescriptors$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 307)

Contains the currently registered JSX component descriptors.

<!-- source: component-landingpage.md -->

# LandingPage

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/pages/LandingPage.tsx` (line 10)

## Diagram

```mermaid
graph TD
    component_LandingPage_6446a245["LandingPage"]
    class component_LandingPage_6446a245 rootComponent
```

## Relationships

- RENDERS → `SEO`

<!-- source: interface-screenshotplan.md -->

# ScreenshotPlan

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/screenshot-instruction-generator.ts` (line 136)

Complete screenshot plan

## Properties

| Property | Type |
|---|---|
| `coverageReport` | `CoverageReport` |
| `instructions` | `ScreenshotInstruction[]` |
| `workflows` | `WorkflowSequence[]` |
| `totalScreenshots` | `number` |
| `estimatedMinutes` | `number` |
| `summary` | `{
    critical: number;
    high: number;
    medium: number;
    low: number;
  }` |

<!-- source: interface-sessionmanagerconfig.md -->

# SessionManagerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/session-manager.ts` (line 24)

<!-- source: component-statusjourney-3.md -->

# StatusJourney

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/IssueSidePanel.tsx` (line 46)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `current` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StatusJourney_94f693c["StatusJourney"]
    class component_StatusJourney_94f693c rootComponent
```

## Referenced By

- `IssueSidePanel` (RENDERS)

<!-- source: interface-tutorialstep.md -->

# TutorialStep

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/tutorial-generator.service.ts` (line 43)

## Properties

| Property | Type |
|---|---|
| `stepNumber` | `number` |
| `title` | `string` |
| `instructions` | `string` |
| `screenshot` | `string` |
| `expectedResult` | `string` |
| `tips` | `string[]` |

<!-- source: interface-detectedvalidation.md -->

# DetectedValidation

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/validation-detector.ts` (line 17)

Detected validation schema/rule

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `framework` | `| 'yup'
    | 'zod'
    | 'joi'
    | 'class-validator'
    | 'pydantic'
    | 'data-annotations'
    | 'fluent-validation'
    | 'bean-validation'
    | 'custom'` |
| `fields` | `ValidationField[]` |
| `entityId` | `string` |
| `filePath` | `string` |
| `confidence` | `'high' | 'medium' | 'low'` |
| `schemaCode` | `string` |

<!-- source: api-endpoint-getduplicates.md -->

# getDuplicates

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/issues.controller.ts` (line 107)

## Endpoint

`GET /projects/:projectId/issues/:issueId/duplicates`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `issueId` | query | `string` | ✓ |

## Referenced By

- `IssuesController` (MODULE_DECLARES)

<!-- source: constant-jsxisavailable.md -->

# jsxIsAvailable$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 301)

This JSX plugin will fill this value.

<!-- source: component-languageswitcher-2.md -->

# LanguageSwitcher

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/language-switcher.tsx` (line 13)

## Diagram

```mermaid
graph TD
    component_LanguageSwitcher_2ec54755["LanguageSwitcher"]
    class component_LanguageSwitcher_2ec54755 rootComponent
```

## Relationships

- RENDERS → `Globe`
- USES_HOOK → `useTranslation`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-screenshotsaveresult.md -->

# ScreenshotSaveResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/storage.interface.ts` (line 78)

Screenshot save result

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `url` | `string` |
| `filePath` | `string` |
| `version` | `number` |
| `isNew` | `boolean` |

<!-- source: interface-sessionmemory.md -->

# SessionMemory

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/session-memory.ts` (line 27)

A memory extracted from a session.

## Properties

| Property | Type |
|---|---|
| `category` | `'pattern' | 'pitfall' | 'environment' | 'optimization'` |
| `title` | `string` |
| `content` | `string` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: component-statusoverview.md -->

# StatusOverview

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/page.tsx` (line 438)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `counts` | `Record` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StatusOverview_7fba48c["StatusOverview"]
    class component_StatusOverview_7fba48c rootComponent
```

## Referenced By

- `IssuesListPage` (RENDERS)

<!-- source: interface-updatebrandingdto.md -->

# UpdateBrandingDto

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/branding/branding.service.ts` (line 12)

## Properties

| Property | Type |
|---|---|
| `siteName` | `string | null` |
| `tagline` | `string | null` |
| `logoLightUrl` | `string | null` |
| `faviconUrl` | `string | null` |
| `primaryColor` | `string | null` |
| `accentColor` | `string | null` |
| `supportEmail` | `string | null` |
| `menuStyle` | `string | null` |
| `menuConfig` | `Record<string, any> | null` |
| `theme` | `string | null` |

<!-- source: interface-detectedvuecomponent.md -->

# DetectedVueComponent

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/vue-detector.ts` (line 16)

Detected Vue component

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `filePath` | `string` |
| `apiStyle` | `'composition' | 'options' | 'setup-script'` |
| `props` | `VueProp[]` |
| `emits` | `string[]` |
| `reactiveState` | `string[]` |
| `computed` | `string[]` |
| `methods` | `string[]` |
| `composables` | `string[]` |
| `childComponents` | `string[]` |
| `watchers` | `string[]` |
| `confidence` | `'high' | 'medium' | 'low'` |

<!-- source: api-endpoint-getentities.md -->

# getEntities

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/kg-sync.controller.ts` (line 54)

Get all entities for a project

## Endpoint

`GET /projects/:projectId/entities`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `type` | query | `string` | - |

## Referenced By

- `KgSyncController` (MODULE_DECLARES)

<!-- source: constant-jsxplugin.md -->

# jsxPlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/index.ts` (line 224)

a plugin that adds support for JSX elements (MDX).

<!-- source: component-lexicalautolinkplugin.md -->

# LexicalAutoLinkPlugin

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/link/AutoLinkPlugin.tsx` (line 26)

## Diagram

```mermaid
graph TD
    component_LexicalAutoLinkPlugin_5f60c401["LexicalAutoLinkPlugin"]
    class component_LexicalAutoLinkPlugin_5f60c401 rootComponent
```

## Relationships

- RENDERS → `AutoLinkPlugin`

<!-- source: interface-screenshotstatecontext.md -->

# ScreenshotStateContext

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/screenshot.interface.ts` (line 126)

Screenshot with state context
Used internally to associate screenshots with parsed component data

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `componentId` | `string` |
| `componentName` | `string` |
| `detectedState` | `string` |
| `confidence` | `number` |
| `detectionMethod` | `string` |

<!-- source: interface-sessionmeta.md -->

# SessionMeta

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/session-store.ts` (line 23)

Metadata stored per session — used for listing without loading full history

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `workspace` | `string` |
| `model` | `string` |
| `createdAt` | `number` |
| `updatedAt` | `number` |
| `status` | `'active' | 'completed' | 'error'` |
| `sendCount` | `number` |
| `turnCount` | `number` |
| `totalUsage` | `TokenUsage` |
| `title` | `string` |

<!-- source: component-stepssection.md -->

# StepsSection

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/page.tsx` (line 401)

## Diagram

```mermaid
graph TD
    component_StepsSection_bf13b88["StepsSection"]
    class component_StepsSection_bf13b88 rootComponent
```

## Relationships

- USES_HOOK → `useRef`
- USES_HOOK → `useInView`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

## Referenced By

- `HomePage` (RENDERS)

<!-- source: interface-updateversionmetadatadto.md -->

# UpdateVersionMetadataDto

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/document/services/document-version.service.ts` (line 11)

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `comment` | `string` |

<!-- source: interface-directivedescriptor.md -->

# DirectiveDescriptor

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/directives/index.ts` (line 26)

Implement this interface to create a custom editor for markdown directives.
Pass the object in the `directivesPlugin` parameters.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `attributes` | `string[]` |
| `hasChildren` | `boolean` |
| `type` | `'leafDirective' | 'containerDirective' | 'textDirective'` |
| `Editor` | `React.ComponentType<DirectiveEditorProps<T>>` |

<!-- source: api-endpoint-getentity.md -->

# getEntity

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/graph.controller.ts` (line 48)

## Endpoint

`GET /knowledge-graph/entities/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `GraphController` (MODULE_DECLARES)

<!-- source: constant-lexicalfrontmattervisitor.md -->

# LexicalFrontmatterVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/frontmatter/LexicalFrontmatterVisitor.ts` (line 5)

## Definition

```ts
LexicalExportVisitor<FrontmatterNode, Mdast.YAML>
```

<!-- source: component-lexicalprovider.md -->

# LexicalProvider

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/MDXEditor.tsx` (line 47)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_LexicalProvider_68752f28["LexicalProvider"]
    class component_LexicalProvider_68752f28 rootComponent
```

## Relationships

- RENDERS → `LexicalComposerContext-Provider`
- USES_HOOK → `useCellValue`
- USES_HOOK → `useMemo`

<!-- source: interface-searchindex.md -->

# SearchIndex

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/search-index.generator.ts` (line 41)

Search index

## Properties

| Property | Type |
|---|---|
| `entries` | `SearchIndexEntry[]` |
| `metadata` | `SearchIndexMetadata` |

<!-- source: interface-sessionoptions.md -->

# SessionOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/types.ts` (line 107)

## Properties

| Property | Type |
|---|---|
| `maxTurns` | `number` |
| `context` | `TContext` |
| `turnHook` | `TurnHook<TContext>` |
| `stream` | `boolean` |
| `toolVerificationHook` | `ToolVerificationHook` |
| `toolPreExecutionHook` | `ToolPreExecutionHook` |
| `guardrailRetries` | `number` |
| `maxOutputRecoveries` | `number` |
| `enableInjection` | `boolean` |
| `postCompactionHook` | `PostCompactionHook` |
| `planMode` | `boolean` |
| `hardPlanMode` | `boolean` |
| `architectModel` | `string` |
| `implementModel` | `string` |
| `verbose` | `boolean` |
| `onUserPromptSubmit` | `(message: string) => Promise<{ blocked: boolean; blockReason?: string }>` |
| `workspace` | `string` |

<!-- source: component-streamingdots.md -->

# StreamingDots

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/SupportChatWidget.tsx` (line 682)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_StreamingDots_4a538795["StreamingDots"]
    class component_StreamingDots_4a538795 rootComponent
```

## Referenced By

- `SupportChatWidget` (RENDERS)

<!-- source: interface-upsertsupportagentconfigdto.md -->

# UpsertSupportAgentConfigDto

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.service.ts` (line 12)

## Properties

| Property | Type |
|---|---|
| `includeUserDocs` | `boolean` |
| `includeTechnicalDocs` | `boolean` |
| `includeApiDocs` | `boolean` |
| `scopedCategoryIds` | `string[] | null` |
| `scopedCollectionIds` | `string[] | null` |
| `agentName` | `string` |
| `welcomeMessage` | `string | null` |
| `systemPrompt` | `string | null` |
| `isEnabled` | `boolean` |

<!-- source: interface-directiveeditorprops.md -->

# DirectiveEditorProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/directives/index.ts` (line 58)

## Properties

| Property | Type |
|---|---|
| `mdastNode` | `T` |
| `parentEditor` | `LexicalEditor` |
| `lexicalNode` | `DirectiveNode` |
| `descriptor` | `DirectiveDescriptor` |

<!-- source: api-endpoint-getentity-2.md -->

# getEntity

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 151)

## Endpoint

`GET /technical-docs/:projectId/entity/:entityId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `entityId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: constant-lexicalgenerichtmlvisitor.md -->

# LexicalGenericHTMLVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/LexicalGenericHTMLNodeVisitor.ts` (line 7)

## Definition

```ts
LexicalExportVisitor<
  GenericHTMLNode,
  MdxJsxFlowElement | MdxJsxTextElement
>
```

<!-- source: component-link.md -->

# Link

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 240)

## Diagram

```mermaid
graph TD
    component_Link_13f244["Link"]
    class component_Link_13f244 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: interface-searchindexentry.md -->

# SearchIndexEntry

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/search-index.generator.ts` (line 15)

Search index entry

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `type` | `string` |
| `description` | `string` |
| `filePath` | `string` |
| `url` | `string` |
| `keywords` | `string[]` |
| `content` | `string` |
| `tags` | `string[]` |
| `weight` | `number` |

<!-- source: interface-sessionsavecontext.md -->

# SessionSaveContext

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/session-manager.ts` (line 34)

Caller-supplied context needed to build/update session metadata

## Properties

| Property | Type |
|---|---|
| `workspace` | `string` |
| `model` | `string` |
| `sendCount` | `number` |
| `turnCount` | `number` |
| `totalUsage` | `TokenUsage` |
| `conversationHistory` | `AgentHistoryItem[]` |
| `sdkHistory` | `unknown[]` |
| `status` | `'active' | 'completed' | 'error'` |

<!-- source: component-streamingindicator.md -->

# StreamingIndicator

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/ChatMessage.tsx` (line 158)

Animated streaming indicator (three dots)

## Diagram

```mermaid
graph TD
    component_StreamingIndicator_6f1ac849["StreamingIndicator"]
    class component_StreamingIndicator_6f1ac849 rootComponent
```

## Referenced By

- `ChatMessage` (RENDERS)

<!-- source: interface-usagecost.md -->

# UsageCost

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/ai-usage.service.ts` (line 78)

## Properties

| Property | Type |
|---|---|
| `inputCost` | `number` |
| `outputCost` | `number` |
| `totalCost` | `number` |
| `inputTokens` | `number` |
| `outputTokens` | `number` |
| `totalTokens` | `number` |

<!-- source: interface-directivematch.md -->

# DirectiveMatch

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 206)

Directive match result

## Properties

| Property | Type |
|---|---|
| `type` | `| 'audience'
    | 'variant'
    | 'block'
    | 'include'
    | 'closing'
    | 'variant_child'
    | 'variant_child_close'` |
| `raw` | `string` |
| `content` | `string` |
| `line` | `number` |
| `offset` | `number` |
| `closing` | `boolean` |

<!-- source: api-endpoint-getentitybyid.md -->

# getEntityById

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/kg-sync.controller.ts` (line 92)

Get a single entity by ID

## Endpoint

`GET /projects/:projectId/entities/:entityId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `entityId` | query | `string` | ✓ |

## Referenced By

- `KgSyncController` (MODULE_DECLARES)

<!-- source: constant-lexicalheadingvisitor.md -->

# LexicalHeadingVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/headings/LexicalHeadingVisitor.ts` (line 5)

## Definition

```ts
LexicalExportVisitor<HeadingNode, Mdast.Heading>
```

<!-- source: component-linkdialog.md -->

# LinkDialog

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/LinkDialog.tsx` (line 137)

## Diagram

```mermaid
graph TD
    component_LinkDialog_65d0031e["LinkDialog"]
    class component_LinkDialog_65d0031e rootComponent
```

## Relationships

- RENDERS → `Popover-Root`
- RENDERS → `Popover-Anchor`
- RENDERS → `Popover-Portal`
- RENDERS → `Popover-Content`
- RENDERS → `LinkEditForm`
- RENDERS → `ActionButton`
- RENDERS → `Tooltip-Provider`
- RENDERS → `Tooltip-Root`
- RENDERS → `Tooltip-Trigger`
- RENDERS → `Tooltip-Portal`
- RENDERS → `Tooltip-Content`
- RENDERS → `Tooltip-Arrow`
- RENDERS → `Popover-Arrow`
- USES_HOOK → `useCellValues`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useEffect`
- USES_HOOK → `useState`
- USES_HOOK → `useTranslation`

<!-- source: interface-searchindexmetadata.md -->

# SearchIndexMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/search-index.generator.ts` (line 51)

Search index metadata

## Properties

| Property | Type |
|---|---|
| `version` | `string` |
| `totalEntries` | `number` |
| `generatedAt` | `string` |
| `entityTypes` | `string[]` |

<!-- source: interface-sessionsnapshot.md -->

# SessionSnapshot

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/session-store.ts` (line 46)

Full session snapshot written to {id}.json

## Properties

| Property | Type |
|---|---|
| `meta` | `SessionMeta` |
| `conversationHistory` | `AgentHistoryItem[]` |
| `sdkHistory` | `unknown[]` |

<!-- source: component-subdomaincard.md -->

# SubdomainCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Domains/DomainTab.tsx` (line 155)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `publishedSlug` | `string | null` | ✓ | - |
| `onToast` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SubdomainCard_3456e791["SubdomainCard"]
    class component_SubdomainCard_3456e791 rootComponent
```

## Relationships

- RENDERS → `CopyButton`
- RENDERS → `ArrowTopRightOnSquareIcon`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

## Referenced By

- `DomainTab` (RENDERS)

<!-- source: interface-versiondiff.md -->

# VersionDiff

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/doc-version/version-diff.service.ts` (line 30)

## Properties

| Property | Type |
|---|---|
| `versionA` | `string` |
| `versionB` | `string` |
| `summary` | `{
    added: number;
    removed: number;
    modified: number;
    unchanged: number;
    totalA: number;
    totalB: number;
  }` |
| `documents` | `{
    added: DocDiffEntry[];
    removed: DocDiffEntry[];
    modified: DocDiffEntry[];
    unchanged: DocDiffEntry[];
  }` |
| `categories` | `{
    added: CategoryDiffEntry[];
    removed: CategoryDiffEntry[];
    unchanged: CategoryDiffEntry[];
  }` |

<!-- source: interface-discoveredroute.md -->

# DiscoveredRoute

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/site-map.types.ts` (line 65)

## Properties

| Property | Type |
|---|---|
| `path` | `string` |
| `fullUrl` | `string` |
| `menuLabel` | `string` |
| `menuSelector` | `string` |
| `pageType` | `PageType` |
| `profile` | `PageElementProfile` |
| `routeSegments` | `string[]` |
| `profileTimeMs` | `number` |

<!-- source: api-endpoint-getescalation.md -->

# getEscalation

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 333)

## Endpoint

`GET /technical-docs/:projectId/escalation`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: constant-lexicalimagevisitor.md -->

# LexicalImageVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/LexicalImageVisitor.ts` (line 5)

## Definition

```ts
LexicalExportVisitor<ImageNode, Mdast.Image>
```

<!-- source: component-lists.md -->

# Lists

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 202)

## Diagram

```mermaid
graph TD
    component_Lists_26a6a8b["Lists"]
    class component_Lists_26a6a8b rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `UndoRedo`

<!-- source: interface-searchindexoptions.md -->

# SearchIndexOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/search-index.generator.ts` (line 65)

Search index options

## Properties

| Property | Type |
|---|---|
| `baseUrl` | `string` |
| `includeCode` | `boolean` |
| `minWeight` | `number` |
| `keywordExtractor` | `(entity: Entity) => string[]` |
| `weightCalculator` | `(entity: Entity) => number` |

<!-- source: interface-sessionstoreconfig.md -->

# SessionStoreConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/session-store.ts` (line 62)

## Properties

| Property | Type |
|---|---|
| `dir` | `string` |
| `maxSessions` | `number` |

<!-- source: component-summarycard.md -->

# SummaryCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/versions/[versionId]/review/page.tsx` (line 25)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `icon` | `string` | ✓ | - |
| `count` | `number` | ✓ | - |
| `label` | `string` | ✓ | - |
| `color` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SummaryCard_733d09f2["SummaryCard"]
    class component_SummaryCard_733d09f2 rootComponent
```

## Referenced By

- `ReviewPage` (RENDERS)

<!-- source: interface-webhookverification.md -->

# WebhookVerification

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/webhooks/webhook.service.ts` (line 14)

Per-request material used to authenticate an incoming webhook.

## Properties

| Property | Type |
|---|---|
| `signature` | `string` |
| `token` | `string` |
| `authHeader` | `string` |
| `rawBody` | `string | Buffer` |

<!-- source: interface-discoveryclientconfig.md -->

# DiscoveryClientConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/discovery.client.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `baseUrl` | `string` |
| `timeoutMs` | `number` |

<!-- source: api-endpoint-getfeedbacksummary.md -->

# getFeedbackSummary

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 178)

## Endpoint

`GET /analytics/:projectId/feedback-summary`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: constant-lexicaljsxvisitor.md -->

# LexicalJsxVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/LexicalJsxVisitor.ts` (line 8)

## Definition

```ts
LexicalExportVisitor<LexicalJsxNode, MdxJsxFlowElement | MdxJsxTextElement>
```

<!-- source: component-liststoggle.md -->

# ListsToggle

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/ListsToggle.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `options` | `any` | - | [] |

## Diagram

```mermaid
graph TD
    component_ListsToggle_e13b1e1["ListsToggle"]
    class component_ListsToggle_e13b1e1 rootComponent
```

## Relationships

- RENDERS → `SingleChoiceToggleGroup`
- USES_HOOK → `useCellValues`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useTranslation`

<!-- source: interface-semanticmetadata.md -->

# SemanticMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 309)

Semantic metadata for components with business logic patterns

Detects state machines, workflows, modals, and approval processes
to enable comprehensive documentation and screenshot capture.

## Properties

| Property | Type |
|---|---|
| `hasStateMachine` | `boolean` |
| `stateEnums` | `string[]` |
| `transitionMethods` | `string[]` |
| `modalTriggers` | `string[]` |
| `approvalStates` | `string[]` |

<!-- source: interface-setupagentoptions.md -->

# SetupAgentOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/setup-agent.ts` (line 42)

Options accepted by the setup agent entry-point.

## Properties

| Property | Type |
|---|---|
| `workDir` | `string` |
| `timeout` | `number` |

<!-- source: component-supportpanel.md -->

# SupportPanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/page.tsx` (line 326)

## Diagram

```mermaid
graph TD
    component_SupportPanel_dea53f["SupportPanel"]
    class component_SupportPanel_dea53f rootComponent
```

## Relationships

- RENDERS → `PreviewShell`

## Referenced By

- `HomePage` (RENDERS)

<!-- source: interface-workflowaction.md -->

# WorkflowAction

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/workflow-detector.service.ts` (line 36)

An action within a workflow step

## Properties

| Property | Type |
|---|---|
| `type` | `'navigate' | 'fill-form' | 'click' | 'select' | 'upload' | 'verify'` |
| `target` | `string` |
| `value` | `string` |
| `description` | `string` |

<!-- source: interface-discoveryscanrequest.md -->

# DiscoveryScanRequest

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/discovery.client.ts` (line 9)

## Properties

| Property | Type |
|---|---|
| `siteUrl` | `string` |
| `auth` | `{
    loginUrl: string;
    username: string;
    password: string;
    usernameSelector?: string;
    passwordSelector?: string;
    submitSelector?: string;
    successSelector?: string;
  }` |
| `exploreGridDepth` | `boolean` |
| `timeoutMs` | `number` |
| `pageProfileTimeoutMs` | `number` |

<!-- source: api-endpoint-getflow.md -->

# getFlow

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/capture/public-capture.controller.ts` (line 17)

## Endpoint

`GET /public/capture/flows/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `PublicCaptureController` (MODULE_DECLARES)

<!-- source: constant-lexicallinebreakvisitor.md -->

# LexicalLinebreakVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/LexicalLinebreakVisitor.ts` (line 7)

## Definition

```ts
LexicalExportVisitor<LineBreakNode, Mdast.Text>
```

<!-- source: component-markdownshortcuts.md -->

# MarkdownShortcuts

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 356)

## Diagram

```mermaid
graph TD
    component_MarkdownShortcuts_87dcd4c["MarkdownShortcuts"]
    class component_MarkdownShortcuts_87dcd4c rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: interface-semanticmetadata-2.md -->

# SemanticMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/semantic-detector.ts` (line 19)

Semantic Pattern Detector

Detects semantic patterns in code to understand business logic:
- State machines (enums with Stage/Status/State)
- State transitions (methods that change state)
- Modal/dialog triggers
- Approval workflows

This enables comprehensive documentation and screenshot capture.

## Properties

| Property | Type |
|---|---|
| `hasStateMachine` | `boolean` |
| `stateEnums` | `string[]` |
| `transitionMethods` | `string[]` |
| `modalTriggers` | `string[]` |
| `approvalStates` | `string[]` |

<!-- source: interface-setupresult.md -->

# SetupResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/setup-agent.ts` (line 16)

Setup Agent — Environment discovery and configuration sub-agent.

Runs in parallel with the main agent's initial investigation phase to
detect the project language, runtime, package manager, and test command,
then installs dependencies and runs a smoke test.

This module is fully self-contained — no local project imports.

## Properties

| Property | Type |
|---|---|
| `os` | `string` |
| `shell` | `string` |
| `language` | `string` |
| `runtimeVersion` | `string` |
| `packageManager` | `string` |
| `activateCommand` | `string` |
| `depsInstalled` | `boolean` |
| `smokeTestPassed` | `boolean` |
| `warnings` | `string[]` |
| `projectDocs` | `string[]` |
| `testCommand` | `string` |

<!-- source: component-symbolicon.md -->

# SymbolIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/SymbolList.tsx` (line 138)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `type` | `SymbolType` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SymbolIcon_40b4134b["SymbolIcon"]
    class component_SymbolIcon_40b4134b rootComponent
```

## Referenced By

- `SymbolList` (RENDERS)

<!-- source: interface-workflowdocumentation.md -->

# WorkflowDocumentation

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/user-docs-generator.service.ts` (line 27)

Documentation for a single workflow

## Properties

| Property | Type |
|---|---|
| `workflowId` | `string` |
| `workflowName` | `string` |
| `category` | `string` |
| `overview` | `string` |
| `prerequisites` | `string` |
| `steps` | `StepDocumentation[]` |
| `troubleshooting` | `string` |
| `relatedWorkflows` | `string[]` |

<!-- source: interface-djangofield.md -->

# DjangoField

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/django-detector.ts` (line 60)

Django field

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `required` | `boolean` |
| `source` | `string` |

<!-- source: api-endpoint-getgeobreakdown.md -->

# getGeoBreakdown

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 109)

## Endpoint

`GET /analytics/:projectId/geo`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: constant-lexicallinkvisitor.md -->

# LexicalLinkVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link/LexicalLinkVisitor.ts` (line 5)

## Definition

```ts
LexicalExportVisitor<LinkNode, Mdast.Link>
```

<!-- source: component-mermaidpreview.md -->

# MermaidPreview

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/mermaid.tsx` (line 11)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `code` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_MermaidPreview_4d19a319["MermaidPreview"]
    class component_MermaidPreview_4d19a319 rootComponent
```

## Relationships

- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-sequencediagramoptions.md -->

# SequenceDiagramOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/sequence-diagram.generator.ts` (line 55)

Options for sequence diagram generation

## Properties

| Property | Type |
|---|---|
| `showMiddleware` | `boolean` |
| `showDatabase` | `boolean` |
| `showReturns` | `boolean` |
| `showActivation` | `boolean` |
| `maxDepth` | `number` |
| `includeNotes` | `boolean` |
| `includeParticipantTypes` | `Array<'client' | 'middleware' | 'controller' | 'service' | 'database' | 'external'>` |

<!-- source: interface-skilldefinition.md -->

# SkillDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/plugins/plugin-types.ts` (line 86)

A knowledge module (skill) contributed by a plugin.

Each subdirectory in a plugin's `skills/` directory that contains a
`SKILL.md` file produces one SkillDefinition. Skills are loaded on-demand
and injected into the system prompt when activated.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `version` | `string` |
| `body` | `string` |
| `referencePaths` | `string[]` |

<!-- source: component-syncstatusindicator.md -->

# SyncStatusIndicator

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/CollaborationStatusBar.tsx` (line 175)

Sync status indicator showing connection and sync state

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `synced` | `boolean` | ✓ | - |
| `connectionStatus` | `ConnectionStatus` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SyncStatusIndicator_5bbce5d0["SyncStatusIndicator"]
    class component_SyncStatusIndicator_5bbce5d0 rootComponent
```

## Relationships

- USES_HOOK → `useMemo`

## Referenced By

- `CollaborationStatusBar` (RENDERS)

<!-- source: interface-workflowhint.md -->

# WorkflowHint

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/ai/services/business-context-parser.service.ts` (line 29)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `steps` | `string[]` |
| `module` | `string` |

<!-- source: interface-djangomodelfield.md -->

# DjangoModelField

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/django-detector.ts` (line 89)

Django model field

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `nullable` | `boolean` |
| `unique` | `boolean` |
| `choices` | `string[]` |

<!-- source: api-endpoint-getghostdocs.md -->

# getGhostDocs

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 134)

## Endpoint

`GET /analytics/:projectId/ghost-docs`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: constant-lexicallistitemvisitor.md -->

# LexicalListItemVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/lists/LexicalListItemVisitor.ts` (line 6)

## Definition

```ts
LexicalExportVisitor<ListItemNode, Mdast.ListItem>
```

<!-- source: component-mermaidpreview-2.md -->

# MermaidPreview

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/mermaid/index.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `code` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_MermaidPreview_7553a5a5["MermaidPreview"]
    class component_MermaidPreview_7553a5a5 rootComponent
```

## Relationships

- USES_HOOK → `useRef`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-sequencediagramresult.md -->

# SequenceDiagramResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/sequence-diagram.generator.ts` (line 102)

Result of sequence diagram generation

## Properties

| Property | Type |
|---|---|
| `mermaidCode` | `string` |
| `participants` | `SequenceParticipant[]` |
| `messages` | `SequenceMessage[]` |
| `stats` | `{
    /** Number of participants */
    participantCount: number;
    /** Number of messages */
    messageCount: number;
    /** Maximum depth reached */
    maxDepthReached: number;
    /** Number of async calls */
    asyncCallCount: number;
    /** Number of database interactions */
    databaseInteractionCount: number;
  }` |

<!-- source: interface-snapshot.md -->

# Snapshot

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/checkpoint-manager.ts` (line 32)

## Properties

| Property | Type |
|---|---|
| `file` | `string` |
| `content` | `string` |
| `timestamp` | `number` |
| `label` | `string` |

<!-- source: component-tab.md -->

# Tab

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/entity/[entityId]/page.tsx` (line 60)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `label` | `string` | ✓ | - |
| `count` | `number` | - | - |
| `active` | `boolean` | - | - |
| `aiTag` | `boolean` | - | - |
| `onClick` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Tab_d987b97["Tab"]
    class component_Tab_d987b97 rootComponent
```

## Referenced By

- `EntityDetailPage` (RENDERS)

<!-- source: interface-workflowstep.md -->

# WorkflowStep

**Kind:** Interface

**Source:** `atloria-monorepo/apps/api/src/documentation/services/workflow-detector.service.ts` (line 21)

A single step in a workflow

## Properties

| Property | Type |
|---|---|
| `stepNumber` | `number` |
| `title` | `string` |
| `description` | `string` |
| `pageId` | `string` |
| `route` | `string` |
| `actions` | `WorkflowAction[]` |
| `expectedOutcome` | `string` |
| `errorHandling` | `string` |
| `screenshots` | `string[]` |

<!-- source: interface-djangomodelmeta.md -->

# DjangoModelMeta

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/django-detector.ts` (line 110)

Django model meta

## Properties

| Property | Type |
|---|---|
| `ordering` | `string[]` |
| `verboseName` | `string` |
| `permissions` | `string[]` |

<!-- source: api-endpoint-gethealth-2.md -->

# getHealth

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/search.controller.ts` (line 189)

Health check for search service

GET /search/health

Returns search service status:
- enabled: true/false (from AZURE_SEARCH_ENABLED)
- configured: true/false (credentials present)
- indexName: The index being used

## Endpoint

`GET /search/health`

## Referenced By

- `SearchController` (MODULE_DECLARES)

<!-- source: constant-lexicallistvisitor.md -->

# LexicalListVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/lists/LexicalListVisitor.ts` (line 5)

## Definition

```ts
LexicalExportVisitor<ListNode, Mdast.List>
```

<!-- source: component-missingplugins.md -->

# MissingPlugins

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/error-handling.tsx` (line 38)

## Diagram

```mermaid
graph TD
    component_MissingPlugins_3ba3f4e9["MissingPlugins"]
    class component_MissingPlugins_3ba3f4e9 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `ConditionalContents`
- RENDERS → `ChangeCodeMirrorLanguage`
- RENDERS → `ShowSandpackInfo`
- RENDERS → `UndoRedo`
- RENDERS → `BoldItalicUnderlineToggles`

<!-- source: interface-sequencemessage.md -->

# SequenceMessage

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/sequence-diagram.generator.ts` (line 35)

Represents a message/interaction in the sequence

## Properties

| Property | Type |
|---|---|
| `from` | `string` |
| `to` | `string` |
| `label` | `string` |
| `type` | `'sync' | 'async' | 'return'` |
| `note` | `string` |
| `activates` | `boolean` |
| `deactivates` | `boolean` |

<!-- source: interface-socketlike.md -->

# SocketLike

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/protocol/websocket-transport.ts` (line 37)

Minimal interface for a Socket.IO-compatible socket.
Using a structural type instead of importing from socket.io keeps
agent-core free of the socket.io peer dependency.

<!-- source: component-tab-2.md -->

# Tab

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/technical/entity/[entityId]/page.tsx` (line 41)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `label` | `string` | ✓ | - |
| `count` | `number` | - | - |
| `active` | `boolean` | - | - |
| `aiTag` | `boolean` | - | - |
| `onClick` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Tab_69883e86["Tab"]
    class component_Tab_69883e86 rootComponent
```

## Referenced By

- `PublicEntityDetailPage` (RENDERS)

<!-- source: interface-djangorelationship.md -->

# DjangoRelationship

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/django-detector.ts` (line 100)

Django model relationship

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `'ForeignKey' | 'ManyToManyField' | 'OneToOneField'` |
| `relatedModel` | `string` |
| `relatedName` | `string` |

<!-- source: api-endpoint-getjob.md -->

# getJob

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 133)

## Endpoint

`GET /doc-automation/jobs/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: constant-lexicalmdxexpressionvisitor.md -->

# LexicalMdxExpressionVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/LexicalMdxExpressionVisitor.ts` (line 5)

## Definition

```ts
LexicalExportVisitor<LexicalMdxExpressionNode, MdxTextExpression>
```

<!-- source: component-moreformatting.md -->

# MoreFormatting

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 73)

## Diagram

```mermaid
graph TD
    component_MoreFormatting_596b699c["MoreFormatting"]
    class component_MoreFormatting_596b699c rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useRef`

<!-- source: interface-sequenceparticipant.md -->

# SequenceParticipant

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/sequence-diagram.generator.ts` (line 21)

Represents a participant in the sequence diagram

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `type` | `'client' | 'middleware' | 'controller' | 'service' | 'database' | 'external'` |
| `entity` | `Entity` |

<!-- source: interface-spawnagentoptions.md -->

# SpawnAgentOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/spawn-agent.tool.ts` (line 40)

## Properties

| Property | Type |
|---|---|
| `runtime` | `IAgentLoop` |
| `agentFactory` | `AgentFactory<TContext>` |
| `timeout` | `number` |
| `onBackgroundComplete` | `(event: BackgroundCompleteEvent) => void` |
| `worktreeManager` | `WorktreeManager` |
| `router` | `ModelRouter` |
| `onSubagentStart` | `(event: { agentName: string; task: string }) => void` |
| `onSubagentEnd` | `(event: { agentName: string; output: string; durationMs: number }) => void` |

<!-- source: component-tabbutton.md -->

# TabButton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/ParsingResults.tsx` (line 107)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |
| `active` | `boolean` | ✓ | - |
| `onClick` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TabButton_23277783["TabButton"]
    class component_TabButton_23277783 rootComponent
```

## Referenced By

- `ParsingResults` (RENDERS)

<!-- source: interface-docclassificationmeta.md -->

# DocClassificationMeta

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/knowledge-reference.types.ts` (line 91)

## Properties

| Property | Type |
|---|---|
| `categoryName` | `string` |
| `targetPersonas` | `string[]` |
| `featureIds` | `string[]` |
| `difficulty` | `string` |

<!-- source: api-endpoint-getjob-2.md -->

# getJob

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/pme/pme.controller.ts` (line 47)

## Endpoint

`GET /pme/jobs/:jobId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `jobId` | query | `string` | ✓ |

## Referenced By

- `PmeController` (MODULE_DECLARES)

<!-- source: constant-lexicalparagraphvisitor.md -->

# LexicalParagraphVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/LexicalParagraphVisitor.ts` (line 7)

## Definition

```ts
LexicalExportVisitor<ParagraphNode, Mdast.Paragraph>
```

<!-- source: component-multiplechoicetogglegroup.md -->

# MultipleChoiceToggleGroup

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/toolbar.tsx` (line 108)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `items` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_MultipleChoiceToggleGroup_50de21a8["MultipleChoiceToggleGroup"]
    class component_MultipleChoiceToggleGroup_50de21a8 rootComponent
```

## Relationships

- RENDERS → `ToggleSingleGroupWithItem`

<!-- source: interface-serviceentity-2.md -->

# ServiceEntity

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 817)

Service entity (NestJS, Express, etc.)

## Properties

| Property | Type |
|---|---|
| `type` | `EntityType.SERVICE` |
| `dependencies` | `DependencyInfo[]` |
| `methods` | `MethodDefinition[]` |
| `isSingleton` | `boolean` |

<!-- source: interface-streamedrunhandle.md -->

# StreamedRunHandle

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/types.ts` (line 180)

Wrapper around the SDK's StreamedRunResult.
Provides a clean interface for AgentSession to consume streaming events
without importing SDK types directly.

## Properties

| Property | Type |
|---|---|
| `events` | `AsyncIterable<StreamEvent>` |
| `completed` | `Promise<void>` |
| `getNewItems` | `() => unknown[]` |
| `getRawResponses` | `() => unknown[]` |
| `getFinalOutput` | `() => string` |
| `getLastAgentName` | `() => string` |
| `getHistory` | `() => unknown[]` |

<!-- source: component-tableofcontents.md -->

# TableOfContents

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/DocumentViewer.tsx` (line 220)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `items` | `TocItem[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TableOfContents_6ec138bf["TableOfContents"]
    class component_TableOfContents_6ec138bf rootComponent
```

## Relationships

- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

## Referenced By

- `DocumentViewer` (RENDERS)

<!-- source: interface-docscreenshotrequest.md -->

# DocScreenshotRequest

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/agent-screenshot-mapper.ts` (line 107)

Input: a doc's screenshot placeholders to be mapped

## Properties

| Property | Type |
|---|---|
| `docPath` | `string` |
| `docTitle` | `string` |
| `category` | `string` |
| `placeholders` | `Array<{
    id: string;
    description: string;
    sectionHeading: string;
  }>` |

<!-- source: api-endpoint-getjob-3.md -->

# getJob

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/screenshot/screenshot.controller.ts` (line 69)

## Endpoint

`GET /screenshots/jobs/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ScreenshotController` (MODULE_DECLARES)

<!-- source: constant-lexicalquotevisitor.md -->

# LexicalQuoteVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/quote/LexicalQuoteVisitor.ts` (line 5)

## Definition

```ts
LexicalExportVisitor<QuoteNode, Mdast.Blockquote>
```

<!-- source: component-nav.md -->

# Nav

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/layout/nav.tsx` (line 32)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `logoText` | `string` | - | - |
| `logoSrc` | `string` | - | - |
| `links` | `NavLink[]` | ✓ | - |
| `defaultTheme` | `ThemeMode` | - | "dark" |
| `primaryColor` | `string` | - | - |
| `ctaKey` | `string` | - | - |
| `ctaHref` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_Nav_12ab4064["Nav"]
    class component_Nav_12ab4064 rootComponent
```

## Relationships

- RENDERS → `LanguageSwitcher`
- RENDERS → `ThemeToggle`
- RENDERS → `X`
- RENDERS → `Menu`
- RENDERS → `AnimatePresence`
- RENDERS → `motion-div`
- USES_HOOK → `useTranslation`
- USES_HOOK → `useState`

<!-- source: interface-servicemethod.md -->

# ServiceMethod

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 58)

## Properties

| Property | Type |
|---|---|
| `service` | `string` |
| `method` | `string` |
| `filePath` | `string` |
| `lineNumber` | `number` |
| `calls` | `MethodCall[]` |
| `calledBy` | `MethodCaller[]` |

<!-- source: interface-subsetentry.md -->

# SubsetEntry

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-subset.ts` (line 21)

SWE-bench Verified — Curated Starter Subset

30 hand-picked tasks from the actual SWE-bench Verified dataset (500 tasks).
Balanced 10/10/10 across difficulty for clean comparison.
Selected for: well-defined test targets (FAIL_TO_PASS), pure Python,
and coverage across 9 repos.

Difficulty based on gold patch line count:
  easy   = < 20 lines
  medium = 20-80 lines
  hard   = > 80 lines

IDs verified against princeton-nlp/SWE-bench_Verified (2026-03-25).

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `repo` | `string` |
| `difficulty` | `'easy' | 'medium' | 'hard'` |
| `description` | `string` |

<!-- source: component-technicaldocssection.md -->

# TechnicalDocsSection

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/page.tsx` (line 860)

Technical Docs Section — links to the technical docs viewer and shows snapshot status.

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TechnicalDocsSection_7581d2a8["TechnicalDocsSection"]
    class component_TechnicalDocsSection_7581d2a8 rootComponent
```

## Relationships

- RENDERS → `ChevronUp`
- RENDERS → `ChevronDown`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

## Referenced By

- `ProjectPage` (RENDERS)

<!-- source: interface-doctypeclassification.md -->

# DocTypeClassification

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/doc-type-classifier.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `type` | `DocType` |
| `secondaryType` | `DocType` |
| `confidence` | `number` |
| `signals` | `string[]` |

<!-- source: api-endpoint-getjobsbyproject.md -->

# getJobsByProject

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/pme/pme.controller.ts` (line 57)

## Endpoint

`GET /pme/projects/:projectId/jobs`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `PmeController` (MODULE_DECLARES)

<!-- source: constant-lexicalrootvisitor.md -->

# LexicalRootVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/LexicalRootVisitor.ts` (line 7)

## Definition

```ts
LexicalExportVisitor<LexicalRootNode, Mdast.Root>
```

<!-- source: component-navigationtree.md -->

# NavigationTree

**Kind:** Component

**Source:** `atloria-monorepo/packages/ui-react/src/components/NavigationTree.tsx` (line 167)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `items` | `DocumentTreeNode[]` | ✓ | - |
| `activeId` | `string` | - | - |
| `defaultExpanded` | `string[]` | - | [] |
| `expanded` | `string[]` | - | - |
| `onExpandedChange` | `Function` | - | - |
| `onItemClick` | `Function` | - | - |
| `showStateIndicator` | `boolean` | - | false |
| `loading` | `boolean` | - | false |
| `emptyMessage` | `string` | - | - |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_NavigationTree_7b35908b["NavigationTree"]
    class component_NavigationTree_7b35908b rootComponent
```

## Relationships

- RENDERS → `TreeItem`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-significancecheckable.md -->

# SignificanceCheckable

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/significance.ts` (line 12)

Significance gate for technical reference docs (audit FIX 1).

The published corpus was 28% junk: entities mined from generated/minified/vendored code
(literal `Bn` pages from a checked-in Prisma client) plus test scaffolding. This is the ONE
shared predicate both the parse pipeline (navMap + snapshot) and the materializer
(transformSnapshotToDocSet) apply, so pages, nav, llms.txt and search all agree on what exists.

Pure + dependency-free so it is trivially unit-testable and usable from any surface.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `filePath` | `string` |

<!-- source: interface-swebenchprediction.md -->

# SWEBenchPrediction

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/swebench-evaluator.ts` (line 26)

SWE-bench prediction format (one per line in JSONL)

## Properties

| Property | Type |
|---|---|
| `instance_id` | `string` |
| `model_name_or_path` | `string` |
| `model_patch` | `string` |

<!-- source: component-testresultbadge.md -->

# TestResultBadge

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/ProviderConfig.tsx` (line 128)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `success` | `boolean` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TestResultBadge_157732fa["TestResultBadge"]
    class component_TestResultBadge_157732fa rootComponent
```

## Referenced By

- `ProviderConfig` (RENDERS)

<!-- source: interface-document.md -->

# Document

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/documents.ts` (line 11)

Document model for API responses

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `content` | `string` |
| `contentHtml` | `string` |
| `type` | `string` |
| `source` | `string` |
| `audiences` | `string[]` |
| `projectId` | `string` |
| `createdById` | `string` |
| `updatedById` | `string` |
| `state` | `string` |
| `isPublic` | `boolean` |
| `canRegenerate` | `boolean` |
| `kgEntityId` | `string` |
| `kgEntityType` | `string` |
| `createdAt` | `string` |
| `updatedAt` | `string` |

<!-- source: api-endpoint-getjobstatus-3.md -->

# getJobStatus

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/sync.controller.ts` (line 132)

## Endpoint

`GET /projects/sync/jobs/:jobId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `jobId` | query | `string` | ✓ |

## Referenced By

- `SyncController` (MODULE_DECLARES)

<!-- source: constant-lexicaltablevisitor.md -->

# LexicalTableVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/table/LexicalTableVisitor.ts` (line 5)

## Definition

```ts
LexicalExportVisitor<TableNode, Mdast.Table>
```

<!-- source: component-nestedlexicaleditor.md -->

# NestedLexicalEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/NestedLexicalEditor.tsx` (line 158)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `getContent` | `Function` | ✓ | - |
| `getUpdatedMdastNode` | `Function` | ✓ | - |
| `contentEditableProps` | `unknown` | - | - |
| `block` | `boolean` | - | - |

## Diagram

```mermaid
graph TD
    component_NestedLexicalEditor_4667bcd6["NestedLexicalEditor"]
    class component_NestedLexicalEditor_4667bcd6 rootComponent
```

## Relationships

- RENDERS → `LexicalNestedComposer`
- RENDERS → `RichTextPlugin`
- RENDERS → `ContentEditable`
- RENDERS → `SharedHistoryPlugin`
- RENDERS → `Child`
- USES_HOOK → `useNestedEditorContext`
- USES_HOOK → `useMdastNodeUpdater`
- USES_HOOK → `useLexicalNodeRemove`
- USES_HOOK → `useRealm`
- USES_HOOK → `useCellValues`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-slotdefinition-2.md -->

# SlotDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 470)

Slot definition (Vue)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `props` | `PropDefinition[]` |

<!-- source: interface-taskresult-2.md -->

# TaskResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/types.ts` (line 79)

Result of running the agent on a single task.

## Properties

| Property | Type |
|---|---|
| `taskId` | `string` |
| `suite` | `BenchmarkTask['suite']` |
| `passed` | `boolean` |
| `hasChanges` | `boolean` |
| `agentPatch` | `string` |
| `durationMs` | `number` |
| `turns` | `number` |
| `tokens` | `{ input: number; output: number; total: number }` |
| `costUsd` | `number` |
| `toolCalls` | `ToolCallRecord[]` |
| `error` | `string` |
| `timedOut` | `boolean` |
| `failureCategory` | `FailureCategory` |
| `attemptIndex` | `number` |
| `difficulty` | `'easy' | 'medium' | 'hard'` |
| `language` | `string` |
| `repo` | `string` |
| `fileLocalization` | `FileLocalization` |
| `terminationReason` | `'success' | 'max_turns_hit' | 'timeout_hit' | 'harness_error' | 'no_progress' | 'duplicate_patch'` |
| `setupDurationMs` | `number` |
| `agentDurationMs` | `number` |
| `patchSaved` | `boolean` |

<!-- source: component-ticker.md -->

# Ticker

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/page.tsx` (line 455)

## Diagram

```mermaid
graph TD
    component_Ticker_67be73ac["Ticker"]
    class component_Ticker_67be73ac rootComponent
```

## Referenced By

- `HomePage` (RENDERS)

<!-- source: interface-documentast.md -->

# DocumentAST

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 87)

Document AST root

## Properties

| Property | Type |
|---|---|
| `nodes` | `ASTNode[]` |
| `blocks` | `Map<string, BlockDefinitionNode>` |
| `errors` | `ParseError[]` |
| `warnings` | `ParseWarning[]` |

<!-- source: api-endpoint-getllmsfulltxt.md -->

# getLlmsFullTxt

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-mcp.controller.ts` (line 226)

## Endpoint

`GET /technical-docs/:projectId/llms-full.txt`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsMcpController` (MODULE_DECLARES)

<!-- source: constant-lexicaltextvisitor.md -->

# LexicalTextVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/LexicalTextVisitor.ts` (line 24)

## Definition

```ts
LexicalExportVisitor<
  TextNode,
  Mdast.Text | Mdast.Html | MdxJsxTextElement
>
```

<!-- source: component-nestedlists.md -->

# NestedLists

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/nested-lists.tsx` (line 25)

## Diagram

```mermaid
graph TD
    component_NestedLists_508f825a["NestedLists"]
    class component_NestedLists_508f825a rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `UndoRedo`

<!-- source: interface-stateactionmetadata.md -->

# StateActionMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-management.interface.ts` (line 83)

State action metadata (Redux, NgRx, Pinia)

## Properties

| Property | Type |
|---|---|
| `actionType` | `string` |
| `payloadShape` | `Record<string, string>` |
| `isAsync` | `boolean` |
| `relatedActions` | `{
    start?: string;
    success?: string;
    failure?: string;
  }` |
| `dispatchedBy` | `string[]` |
| `handledBy` | `string[]` |
| `triggersEffects` | `string[]` |

<!-- source: interface-testgateconfig.md -->

# TestGateConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/test-watcher.ts` (line 213)

## Properties

| Property | Type |
|---|---|
| `testCommand` | `string` |
| `cwd` | `string` |
| `timeoutMs` | `number` |

<!-- source: component-timelinecard.md -->

# TimelineCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/documents/[id]/compare/page.tsx` (line 838)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `change` | `VersionChange` | ✓ | - |
| `formatDate` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TimelineCard_2e54a068["TimelineCard"]
    class component_TimelineCard_2e54a068 rootComponent
```

## Relationships

- RENDERS → `ChangePairBlock`

## Referenced By

- `TimelineView` (RENDERS)

<!-- source: interface-documentationplan.md -->

# DocumentationPlan

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-05.types.ts` (line 65)

## Properties

| Property | Type |
|---|---|
| `totalDocuments` | `number` |
| `categories` | `DocumentCategory[]` |
| `readingOrder` | `string[]` |
| `estimatedSections` | `number` |

<!-- source: api-endpoint-getllmsfulltxtbyurl.md -->

# getLlmsFullTxtByUrl

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 233)

## Endpoint

`GET /public/p/:slugWithId/llms-full.txt`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-lexicalthematicbreakvisitor.md -->

# LexicalThematicBreakVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/thematic-break/LexicalThematicBreakVisitor.ts` (line 5)

## Definition

```ts
LexicalExportVisitor<HorizontalRuleNode, Mdast.ThematicBreak>
```

<!-- source: component-optimizedimage.md -->

# OptimizedImage

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/layout/optimized-image.tsx` (line 22)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `src` | `string` | ✓ | - |
| `alt` | `string` | ✓ | - |
| `width` | `number` | - | - |
| `height` | `number` | - | - |
| `srcSet` | `string` | - | - |
| `sizes` | `string` | - | - |
| `className` | `string` | - | "" |
| `loading` | `unknown | unknown` | - | "lazy" |
| `priority` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_OptimizedImage_1529e593["OptimizedImage"]
    class component_OptimizedImage_1529e593 rootComponent
```

## Relationships

- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-stateeffectmetadata.md -->

# StateEffectMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-management.interface.ts` (line 192)

State effect metadata (NgRx Effects, Redux Saga)

## Properties

| Property | Type |
|---|---|
| `effectName` | `string` |
| `triggerAction` | `string` |
| `successAction` | `string` |
| `errorAction` | `string` |
| `isLegacy` | `boolean` |
| `dependencies` | `string[]` |

<!-- source: interface-testrunresult.md -->

# TestRunResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/test-watcher.ts` (line 36)

## Properties

| Property | Type |
|---|---|
| `passed` | `boolean` |
| `stdout` | `string` |
| `stderr` | `string` |
| `durationMs` | `number` |
| `timedOut` | `boolean` |

<!-- source: component-timelineview.md -->

# TimelineView

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/documents/[id]/compare/page.tsx` (line 791)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `changes` | `VersionChange[]` | ✓ | - |
| `loading` | `boolean` | ✓ | - |
| `formatDate` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TimelineView_2e5d5ffd["TimelineView"]
    class component_TimelineView_2e5d5ffd rootComponent
```

## Relationships

- RENDERS → `ClockIcon`
- RENDERS → `TimelineCard`

## Referenced By

- `CompareDocumentsPage` (RENDERS)

<!-- source: interface-documentationrelevantdeps.md -->

# DocumentationRelevantDeps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 256)

DocumentationRelevantDeps - What to load when extracting an entity

When we extract OrderForm.tsx, we should also load:
- orderValidationSchema.ts (FULLY - contains validation rules)
- OrderService.create() (signature + JSDoc)
- useOrderState hook (state shape)
- ORDER_STATUS enum (ALL values)

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `required` | `Array<{
    entityId: string;
    reason: 'validation' | 'state' | 'constants' | 'error_handling';
    loadStrategy: 'full' | 'signature_only' | 'values_only';
  }>` |
| `helpful` | `Array<{
    entityId: string;
    reason: string;
    loadStrategy: 'full' | 'signature_only';
  }>` |
| `estimatedTokens` | `{
    required: number;
    helpful: number;
    total: number;
  }` |

<!-- source: api-endpoint-getllmstxt.md -->

# getLlmsTxt

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-mcp.controller.ts` (line 212)

## Endpoint

`GET /technical-docs/:projectId/llms.txt`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsMcpController` (MODULE_DECLARES)

<!-- source: constant-lexicaltheme.md -->

# lexicalTheme

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/styles/lexicalTheme.ts` (line 5)

## Definition

```ts
EditorThemeClasses
```

<!-- source: component-parentoffsetofanchor.md -->

# ParentOffsetOfAnchor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/link-dialog.tsx` (line 104)

## Diagram

```mermaid
graph TD
    component_ParentOffsetOfAnchor_a4dae0b["ParentOffsetOfAnchor"]
    class component_ParentOffsetOfAnchor_a4dae0b rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: interface-stateflow.md -->

# StateFlow

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-management.interface.ts` (line 351)

Complete state flow for documentation

## Properties

| Property | Type |
|---|---|
| `flowName` | `string` |
| `library` | `StateManagementLibrary` |
| `states` | `string[]` |
| `transitions` | `StateTransition[]` |
| `conditionalUI` | `ConditionalUIPattern[]` |
| `components` | `string[]` |
| `actions` | `string[]` |
| `selectors` | `string[]` |
| `asyncPattern` | `AsyncStatePattern` |

<!-- source: interface-testsnapshot.md -->

# TestSnapshot

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/circle-detector.ts` (line 44)

## Properties

| Property | Type |
|---|---|
| `passed` | `number` |
| `failed` | `number` |
| `failingTests` | `string[]` |

<!-- source: component-toastview.md -->

# ToastView

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/Toast.tsx` (line 75)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `toast` | `ToastItem` | ✓ | - |
| `onDismiss` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ToastView_64df5a3b["ToastView"]
    class component_ToastView_64df5a3b rootComponent
```

## Relationships

- RENDERS → `Icon`
- RENDERS → `XMarkIcon`

## Referenced By

- `BoardsToastProvider` (RENDERS)

<!-- source: interface-documentationtopic.md -->

# DocumentationTopic

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-04.types.ts` (line 42)

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `description` | `string` |
| `type` | `DocumentType` |
| `priority` | `1 | 2 | 3 | 4 | 5` |
| `estimatedSections` | `number` |

<!-- source: api-endpoint-getllmstxtbyurl.md -->

# getLlmsTxtByUrl

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 217)

## Endpoint

`GET /public/p/:slugWithId/llms.txt`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-lexicaltheme-2.md -->

# lexicalTheme$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 929)

<!-- source: component-placeholder.md -->

# Placeholder

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 100)

## Diagram

```mermaid
graph TD
    component_Placeholder_36b00417["Placeholder"]
    class component_Placeholder_36b00417 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: interface-statemachine.md -->

# StateMachine

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-machine.interface.ts` (line 144)

Complete state machine definition

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `enumName` | `string` |
| `states` | `StateNode[]` |
| `transitions` | `StateTransition[]` |
| `validationRules` | `string[]` |
| `initialState` | `string` |
| `filePath` | `string` |
| `metadata` | `Record<string, unknown>` |

<!-- source: interface-testwatcherconfig.md -->

# TestWatcherConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/test-watcher.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `testCommand` | `string` |
| `cwd` | `string` |
| `debounceMs` | `number` |
| `timeoutMs` | `number` |
| `enabled` | `boolean` |
| `reportPassingTests` | `boolean` |

<!-- source: component-toolbarbutton.md -->

# ToolbarButton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/EditorToolbar.tsx` (line 10)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onClick` | `Function` | ✓ | - |
| `active` | `boolean` | - | - |
| `disabled` | `boolean` | - | - |
| `children` | `unknown` | ✓ | - |
| `title` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ToolbarButton_1f84a7ff["ToolbarButton"]
    class component_ToolbarButton_1f84a7ff rootComponent
```

## Referenced By

- `EditorToolbar` (RENDERS)

<!-- source: interface-documentcategory.md -->

# DocumentCategory

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-05.types.ts` (line 72)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `documentCount` | `number` |
| `priority` | `number` |

<!-- source: api-endpoint-getme.md -->

# getMe

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/auth.controller.ts` (line 143)

## Endpoint

`GET /auth/me`

## Referenced By

- `AuthController` (MODULE_DECLARES)

<!-- source: constant-linkautocompletesuggestions.md -->

# linkAutocompleteSuggestions$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 343)

<!-- source: component-popoverportal.md -->

# PopoverPortal

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/ui/PopoverUtils.tsx` (line 7)

## Diagram

```mermaid
graph TD
    component_PopoverPortal_5c262bd4["PopoverPortal"]
    class component_PopoverPortal_5c262bd4 rootComponent
```

## Relationships

- RENDERS → `RadixPopover-Portal`
- USES_HOOK → `useCellValue`

<!-- source: interface-statemachineanalysisresult.md -->

# StateMachineAnalysisResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-machine.interface.ts` (line 190)

Result of state machine analysis

## Properties

| Property | Type |
|---|---|
| `stateMachines` | `StateMachine[]` |
| `totalStates` | `number` |
| `totalTransitions` | `number` |
| `filePath` | `string` |
| `analyzedAt` | `Date` |

<!-- source: interface-todoitem.md -->

# TodoItem

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/todo-manager.ts` (line 10)

Todo Manager

Structured task list re-injected after every tool call.
Prevents objective drift after 3-4 steps in the agent loop.

Zero SDK imports — operates on our own interfaces.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `description` | `string` |
| `status` | `'pending' | 'in_progress' | 'completed' | 'skipped'` |
| `result` | `string` |
| `createdAt` | `number` |
| `completedAt` | `number` |

<!-- source: component-topbar.md -->

# TopBar

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/issues/[ticketNumber]/page.tsx` (line 316)

## Diagram

```mermaid
graph TD
    component_TopBar_92a4a9["TopBar"]
    class component_TopBar_92a4a9 rootComponent
```

## Relationships

- RENDERS → `Link`

## Referenced By

- `PublicTicketPage` (RENDERS)

<!-- source: interface-documentcategorystructure.md -->

# DocumentCategoryStructure

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-06.types.ts` (line 50)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `icon` | `string` |
| `order` | `number` |
| `documentIds` | `string[]` |
| `parentId` | `string` |
| `level` | `1 | 2 | 3` |
| `subcategoryIds` | `string[]` |

<!-- source: api-endpoint-getmembers.md -->

# getMembers

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/organization/organization.controller.ts` (line 99)

## Endpoint

`GET /organizations/:id/members`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `OrganizationController` (MODULE_DECLARES)

<!-- source: constant-linkdialogplugin.md -->

# linkDialogPlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 387)

<!-- source: component-pricingcolumns-2.md -->

# PricingColumns

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/pricing/pricing-columns.tsx` (line 27)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `labelKey` | `string` | - | - |
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `tiers` | `PricingTier[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PricingColumns_445ce9f7["PricingColumns"]
    class component_PricingColumns_445ce9f7 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-span`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `PricingTierCard`
- USES_HOOK → `useTranslation`

<!-- source: interface-statemachinecoverage.md -->

# StateMachineCoverage

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/coverage-calculator.ts` (line 23)

Coverage metrics for a single state machine

## Properties

| Property | Type |
|---|---|
| `stateMachineName` | `string` |
| `enumName` | `string` |
| `totalStates` | `number` |
| `coveredStates` | `number` |
| `stateCoveragePercent` | `number` |
| `totalTransitions` | `number` |
| `coveredTransitions` | `number` |
| `transitionCoveragePercent` | `number` |
| `uncoveredStates` | `string[]` |
| `uncoveredTransitions` | `string[]` |
| `terminalStatesCovered` | `string[]` |
| `terminalStatesUncovered` | `string[]` |
| `approvalStatesCovered` | `string[]` |
| `approvalStatesUncovered` | `string[]` |

<!-- source: interface-todostats.md -->

# TodoStats

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/protocol/agent-protocol.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `total` | `number` |
| `completed` | `number` |
| `pending` | `number` |
| `inProgress` | `number` |
| `skipped` | `number` |

<!-- source: component-typeicon.md -->

# TypeIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/components/RelationsPanel.tsx` (line 46)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `type` | `string` | ✓ | - |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_TypeIcon_28cc00b1["TypeIcon"]
    class component_TypeIcon_28cc00b1 rootComponent
```

## Relationships

- RENDERS → `CogIcon`
- RENDERS → `CommandLineIcon`
- RENDERS → `CircleStackIcon`
- RENDERS → `CubeIcon`
- RENDERS → `ShieldCheckIcon`
- RENDERS → `PuzzlePieceIcon`
- RENDERS → `CodeBracketIcon`
- RENDERS → `DocumentTextIcon`

## Referenced By

- `RelItem` (RENDERS)

<!-- source: interface-documentcompareresult.md -->

# DocumentCompareResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/types/api-client.ts` (line 45)

Result of comparing two document versions or revisions

## Properties

| Property | Type |
|---|---|
| `from` | `{
    id: string;
    version?: number;
    title: string;
    content: string;
    createdAt: string;
    createdBy?: { id: string; name: string; email: string };
  }` |
| `to` | `{
    id: string;
    version?: number;
    title: string;
    content: string;
    createdAt: string;
    createdBy?: { id: string; name: string; email: string };
  }` |
| `diff` | `{
    title?: { changed: boolean; from: string; to: string };
    content?: Array<{ type: string; value: string; lineNumber?: number }>;
    metadata?: Array<{ field: string; changed: boolean; from: any; to: any }>;
    stats?: {
      additions: number;
      deletions: number;
      modifications: number;
    };
  }` |

<!-- source: api-endpoint-getmembers-2.md -->

# getMembers

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 173)

## Endpoint

`GET /projects/:id/members`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: constant-linkdialogstate.md -->

# linkDialogState$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 91)

The current state of the link dialog.

<!-- source: component-pricingcomparisontable-2.md -->

# PricingComparisonTable

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/pricing/pricing-comparison-table.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `plans` | `unknown[]` | ✓ | - |
| `features` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PricingComparisonTable_762df8ca["PricingComparisonTable"]
    class component_PricingComparisonTable_762df8ca rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `motion-table`
- RENDERS → `ComparisonRow`
- USES_HOOK → `useTranslation`

<!-- source: interface-statemachinediagramoptions.md -->

# StateMachineDiagramOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/diagrams/state-machine-diagram.generator.ts` (line 34)

Options for state machine diagram generation

## Properties

| Property | Type |
|---|---|
| `showCoverage` | `boolean` |
| `colorScheme` | `CoverageColorScheme` |
| `annotations` | `boolean` |
| `showMethods` | `boolean` |
| `showApprovalRequirements` | `boolean` |
| `showModalTriggers` | `boolean` |
| `direction` | `'TB' | 'LR'` |
| `includeTheme` | `boolean` |

<!-- source: interface-tokenusage-2.md -->

# TokenUsage

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 142)

## Properties

| Property | Type |
|---|---|
| `inputTokens` | `number` |
| `outputTokens` | `number` |
| `totalTokens` | `number` |

<!-- source: component-unifieddiff.md -->

# UnifiedDiff

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/documents/[id]/compare/page.tsx` (line 438)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `diffLines` | `DiffLine[]` | ✓ | - |
| `fromRevision` | `DocumentRevision | null` | ✓ | - |
| `toRevision` | `DocumentRevision | null` | ✓ | - |
| `formatDate` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_UnifiedDiff_27573860["UnifiedDiff"]
    class component_UnifiedDiff_27573860 rootComponent
```

## Relationships

- RENDERS → `DiffLineRow`

## Referenced By

- `CompareDocumentsPage` (RENDERS)

<!-- source: interface-documentfilters.md -->

# DocumentFilters

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/document.dto.ts` (line 57)

DTO for filtering/searching documents

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `categoryId` | `string` |
| `docVersionId` | `string` |
| `type` | `DocumentType` |
| `state` | `DocumentState` |
| `audiences` | `Audience[]` |
| `search` | `string` |
| `sortBy` | `string` |
| `sortOrder` | `'asc' | 'desc'` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: api-endpoint-getmetadata.md -->

# getMetadata

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/saml/saml.controller.ts` (line 126)

Get SAML metadata for IdP configuration

## Endpoint

`GET /auth/saml/:orgId/metadata`

| Parameter | In | Type | Required |
|---|---|---|---|
| `orgId` | query | `string` | ✓ |

## Referenced By

- `SamlController` (MODULE_DECLARES)

<!-- source: constant-linkplugin.md -->

# linkPlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link/index.tsx` (line 21)

A plugin that adds support for links in the editor.

<!-- source: component-pricingherocard-2.md -->

# PricingHeroCard

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/pricing/pricing-hero-card.tsx` (line 34)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `heroPlan` | `PricingPlan` | ✓ | - |
| `secondaryPlans` | `PricingPlan[]` | - | - |

## Diagram

```mermaid
graph TD
    component_PricingHeroCard_3836d2e8["PricingHeroCard"]
    class component_PricingHeroCard_3836d2e8 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `Check`
- RENDERS → `ArrowRight`
- USES_HOOK → `useTranslation`

<!-- source: interface-statemanagementinfo-2.md -->

# StateManagementInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 481)

State management information

## Properties

| Property | Type |
|---|---|
| `type` | `| 'useState'
    | 'useReducer'
    | 'context'
    | 'redux'
    | 'zustand'
    | 'pinia'
    | 'other'` |
| `stores` | `string[]` |
| `actions` | `string[]` |
| `selectors` | `string[]` |

<!-- source: interface-toolcallrecord.md -->

# ToolCallRecord

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/benchmark/types.ts` (line 141)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `durationMs` | `number` |
| `inputPreview` | `string` |
| `outputPreview` | `string` |

<!-- source: component-usagepanel.md -->

# UsagePanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/ai/page.tsx` (line 224)

Usage panel — renders REAL current-billing-month AI usage from /billing/summary. Only surfaces figures the API actually provides (this-month totals + per-provider breakdown). No fabricated daily/weekly buckets; honest-empty when there is no usage.

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `usage` | `RealUsage | null` | ✓ | - |
| `loading` | `boolean` | - | - |

## Diagram

```mermaid
graph TD
    component_UsagePanel_9b1dcca["UsagePanel"]
    class component_UsagePanel_9b1dcca rootComponent
```

## Referenced By

- `AISettingsPage` (RENDERS)

<!-- source: interface-documentfrontmatter.md -->

# DocumentFrontmatter

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-10.types.ts` (line 55)

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `description` | `string` |
| `keywords` | `string[]` |
| `category` | `string` |
| `difficulty` | `string` |
| `estimatedReadTime` | `number` |
| `lastUpdated` | `string` |

<!-- source: api-endpoint-getnamedversion.md -->

# getNamedVersion

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 629)

## Endpoint

`GET /documents/:id/versions/:versionNumber`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `versionNumber` | query | `number` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: constant-listsplugin.md -->

# listsPlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/lists/index.ts` (line 101)

A plugin that adds support for markdown lists.

<!-- source: component-pricingtiercard-2.md -->

# PricingTierCard

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/pricing-tier-card.tsx` (line 30)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `nameKey` | `string` | ✓ | - |
| `priceKey` | `string` | ✓ | - |
| `intervalKey` | `string` | - | - |
| `descriptionKey` | `string` | - | - |
| `features` | `PricingFeature[]` | ✓ | - |
| `ctaKey` | `string` | ✓ | - |
| `ctaUrl` | `string` | ✓ | - |
| `highlighted` | `boolean` | - | false |
| `badgeKey` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_PricingTierCard_74505afb["PricingTierCard"]
    class component_PricingTierCard_74505afb rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Check`
- USES_HOOK → `useTranslation`

<!-- source: interface-statenode.md -->

# StateNode

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-machine.interface.ts` (line 25)

State Machine Interfaces

Defines types for representing state machines extracted from code.
Used to model business workflows like job approval, order processing, etc.

## Properties

| Property | Type |
|---|---|
| `value` | `number | string` |
| `name` | `string` |
| `isTerminal` | `boolean` |
| `requiresApproval` | `boolean` |
| `metadata` | `Record<string, unknown>` |

<!-- source: interface-tooldefinition.md -->

# ToolDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 60)

Tool definition — domain layers define these as plain objects.
agent-runtime.ts converts them to SDK FunctionTool instances.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `parameters` | `Record<string, unknown>` |
| `execute` | `(context: RunContext<TContext>, input: string) => Promise<string>` |
| `timeoutMs` | `number` |
| `isConcurrencySafe` | `boolean` |
| `deferLoading` | `boolean` |
| `strict` | `boolean` |

<!-- source: component-useravatar.md -->

# UserAvatar

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/CollaborationStatusBar.tsx` (line 39)

User avatar component with color-coded border

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `user` | `CollaborationUser` | ✓ | - |
| `size` | `unknown | unknown | unknown` | - | "default" |
| `showTooltip` | `boolean` | - | true |

## Diagram

```mermaid
graph TD
    component_UserAvatar_100ae536["UserAvatar"]
    class component_UserAvatar_100ae536 rootComponent
```

## Relationships

- USES_HOOK → `useState`

## Referenced By

- `CollaborationStatusBar` (RENDERS)

<!-- source: interface-documentlistparams.md -->

# DocumentListParams

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/documents.ts` (line 52)

Document list query parameters

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `categoryId` | `string` |
| `type` | `string` |
| `state` | `string` |
| `audience` | `string` |
| `search` | `string` |
| `sortBy` | `string` |
| `sortOrder` | `'asc' | 'desc'` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: api-endpoint-getnamedversions.md -->

# getNamedVersions

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 612)

## Endpoint

`GET /documents/:id/versions`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: constant-logger.md -->

# logger

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/logger.ts` (line 247)

<!-- source: component-privacypolicy.md -->

# PrivacyPolicy

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/pages/PrivacyPolicy.tsx` (line 11)

## Diagram

```mermaid
graph TD
    component_PrivacyPolicy_2efdb285["PrivacyPolicy"]
    class component_PrivacyPolicy_2efdb285 rootComponent
```

## Relationships

- RENDERS → `SEO`
- USES_HOOK → `useTranslation`

<!-- source: interface-statereducermetadata.md -->

# StateReducerMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-management.interface.ts` (line 127)

State reducer metadata (Redux, NgRx)

## Properties

| Property | Type |
|---|---|
| `sliceName` | `string` |
| `initialState` | `Record<string, unknown>` |
| `handlesActions` | `string[]` |
| `stateShape` | `Record<string, string>` |
| `stateTransitions` | `StateTransition[]` |

<!-- source: interface-toolguideoptions.md -->

# ToolGuideOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/tool-usage-guide.ts` (line 16)

Tool Usage Guide

Generates instruction text that teaches agents how to use filesystem tools
effectively. Modeled after Claude Code's system prompt approach:
- Read before Edit (mandatory)
- Glob to find, Read to understand, Edit to modify
- Uniqueness discipline for surgical edits
- Verification after changes

Inject this into agent instructions when the agent has access to
edit/write tools. Without this guidance, agents will attempt to
regenerate entire files instead of making targeted edits.

## Properties

| Property | Type |
|---|---|
| `tools` | `('read' | 'edit' | 'write' | 'glob' | 'grep' | 'list_directory' | 'bash' | 'todo' | 'spawn_agent' | 'code_analysis' | 'quality_gate' | 'note' | 'web_search' | 'web_fetch' | 'rollback_file' | 'memory' | 'semantic_search' | 'tool_search' | 'apply_patch' | 'journal' | 'multi_edit' | 'notebook_read' | 'notebook_edit' | 'send_message' | 'cron_create' | 'cron_delete' | 'cron_list' | 'enter_worktree' | 'exit_worktree')[]` |
| `includeWorkflow` | `boolean` |

<!-- source: component-verifyemailcontent.md -->

# VerifyEmailContent

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/(auth)/verify-email/page.tsx` (line 9)

## Diagram

```mermaid
graph TD
    component_VerifyEmailContent_b432c11["VerifyEmailContent"]
    class component_VerifyEmailContent_b432c11 rootComponent
```

## Relationships

- RENDERS → `Link`
- USES_HOOK → `useSearchParams`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

## Referenced By

- `VerifyEmailPage` (RENDERS)

<!-- source: interface-documentlistprops.md -->

# DocumentListProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/components/DocumentList.tsx` (line 8)

Props for DocumentList component

## Properties

| Property | Type |
|---|---|
| `documents` | `Document[]` |
| `onDocumentClick` | `(document: Document) => void` |
| `loading` | `boolean` |
| `emptyMessage` | `string` |

<!-- source: api-endpoint-getone.md -->

# getOne

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 48)

## Endpoint

`GET /projects/:projectId/boards/:boardId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `boardId` | query | `string` | ✓ |
| `includeCards` | query | `string` | - |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: constant-markdown-export-css.md -->

# MARKDOWN_EXPORT_CSS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/markdown-engine/src/lib/render.ts` (line 67)

A compact github-flavoured highlight.js theme plus base prose styles, meant to
be inlined into a <style> tag of a self-contained export document (PDF/HTML).
Kept here so the renderer's highlight output and the CSS that styles it stay
in one place.

<!-- source: component-problemcentered-2.md -->

# ProblemCentered

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/problem/problem-centered.tsx` (line 21)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `problems` | `Problem[]` | ✓ | - |
| `solutionKey` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_ProblemCentered_582b2e70["ProblemCentered"]
    class component_ProblemCentered_582b2e70 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: interface-stateselectormetadata.md -->

# StateSelectorMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-management.interface.ts` (line 157)

State selector metadata (Redux, NgRx, Pinia)

## Properties

| Property | Type |
|---|---|
| `selectorName` | `string` |
| `statePath` | `string[]` |
| `isMemoized` | `boolean` |
| `dependsOn` | `string[]` |
| `usedBy` | `string[]` |
| `returnType` | `string` |

<!-- source: interface-toolregistryconfig.md -->

# ToolRegistryConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/tool-registry.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `tools` | `ToolDefinition<any>[]` |

<!-- source: component-versionproviderwrapper.md -->

# VersionProviderWrapper

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/PublicLayoutShell.tsx` (line 255)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_VersionProviderWrapper_245f773d["VersionProviderWrapper"]
    class component_VersionProviderWrapper_245f773d rootComponent
```

## Relationships

- RENDERS → `VersionProvider`
- USES_HOOK → `usePathname`

## Referenced By

- `PublicLayoutShell` (RENDERS)

<!-- source: interface-documentlistresponse.md -->

# DocumentListResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/documents.ts` (line 68)

Document list response with pagination

## Properties

| Property | Type |
|---|---|
| `documents` | `Document[]` |
| `totalCount` | `number` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: api-endpoint-getone-2.md -->

# getOne

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/issues.controller.ts` (line 65)

## Endpoint

`GET /projects/:projectId/issues/:issueId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `issueId` | query | `string` | ✓ |

## Referenced By

- `IssuesController` (MODULE_DECLARES)

<!-- source: constant-markdown.md -->

# markdown$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 242)

Holds the current markdown value.

<!-- source: component-problemsplitvisual-2.md -->

# ProblemSplitVisual

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/problem/problem-split-visual.tsx` (line 28)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `problems` | `Problem[]` | ✓ | - |
| `imageSrc` | `string` | ✓ | - |
| `imageAlt` | `string` | ✓ | - |
| `imagePosition` | `unknown | unknown` | - | "start" |

## Diagram

```mermaid
graph TD
    component_ProblemSplitVisual_2e71c2e3["ProblemSplitVisual"]
    class component_ProblemSplitVisual_2e71c2e3 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: interface-statesideeffect.md -->

# StateSideEffect

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-management.interface.ts` (line 63)

Side effect during state transition

## Properties

| Property | Type |
|---|---|
| `type` | `'api-call' | 'navigation' | 'notification' | 'cache-update' | 'analytics'` |
| `description` | `string` |
| `metadata` | `Record<string, unknown>` |

<!-- source: interface-toolresult.md -->

# ToolResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/tool-result-manager.ts` (line 12)

Tool Result Manager

Manages tool call results in the context window:
- Truncates results exceeding a token budget
- Clears results older than N turns
- Large outputs can be stored as files instead

Zero SDK imports — operates on our own interfaces.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `toolName` | `string` |
| `result` | `string` |
| `turn` | `number` |
| `tokenEstimate` | `number` |
| `truncated` | `boolean` |

<!-- source: component-versionseohead.md -->

# VersionSeoHead

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/PublicLayoutShell.tsx` (line 281)

Phase 3: SEO meta tags for versioned docs. - Active version: canonical = self (no version prefix) - Other versions: canonical points to active version - Deprecated: noindex

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `slugId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_VersionSeoHead_6c24ab48["VersionSeoHead"]
    class component_VersionSeoHead_6c24ab48 rootComponent
```

## Relationships

- USES_HOOK → `useVersionContext`
- USES_HOOK → `usePathname`

## Referenced By

- `PublicProjectLayoutInner` (RENDERS)

<!-- source: interface-documentlistresponse-2.md -->

# DocumentListResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/document.dto.ts` (line 74)

Response for list documents with pagination

## Properties

| Property | Type |
|---|---|
| `documents` | `Document[]` |
| `totalCount` | `number` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: api-endpoint-getorganizationjobs.md -->

# getOrganizationJobs

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/sync.controller.ts` (line 153)

## Endpoint

`GET /projects/sync/jobs`

## Referenced By

- `SyncController` (MODULE_DECLARES)

<!-- source: constant-markdownerrorsignal.md -->

# markdownErrorSignal$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 180)

<!-- source: component-projectcard.md -->

# ProjectCard

**Kind:** Component

**Source:** `atloria-monorepo/packages/ui-react/src/components/ProjectCard.tsx` (line 46)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `project` | `Project` | ✓ | - |
| `onClick` | `Function` | - | - |
| `showDescription` | `boolean` | - | true |
| `showMenu` | `boolean` | - | false |
| `onDelete` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_ProjectCard_778a6dfb["ProjectCard"]
    class component_ProjectCard_778a6dfb rootComponent
```

## Relationships

- RENDERS → `FolderIcon`
- RENDERS → `EllipsisVerticalIcon`
- RENDERS → `TrashIcon`
- RENDERS → `CalendarIcon`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-statestoremetadata.md -->

# StateStoreMetadata

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-management.interface.ts` (line 227)

State store metadata (Zustand, MobX, Pinia)

## Properties

| Property | Type |
|---|---|
| `storeName` | `string` |
| `stateShape` | `Record<string, string>` |
| `actions` | `Array<{
    name: string;
    parameters?: Array<{ name: string; type: string }>;
    isAsync: boolean;
    sideEffects?: StateSideEffect[];
  }>` |
| `getters` | `Array<{
    name: string;
    dependsOn: string[];
    returnType?: string;
  }>` |
| `usedBy` | `string[]` |

<!-- source: interface-toolresultmanagerconfig.md -->

# ToolResultManagerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/context/tool-result-manager.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `maxTokensPerResult` | `number` |
| `maxAgeTurns` | `number` |
| `maxTotalTokens` | `number` |

<!-- source: component-videoplayer.md -->

# VideoPlayer

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 493)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `src` | `string` | ✓ | - |
| `alt` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_VideoPlayer_100b4de7["VideoPlayer"]
    class component_VideoPlayer_100b4de7 rootComponent
```

## Referenced By

- `CustomImage` (RENDERS)

<!-- source: interface-documentlistresponse-3.md -->

# DocumentListResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/types/api-client.ts` (line 35)

Document list response

## Properties

| Property | Type |
|---|---|
| `documents` | `Document[]` |
| `totalCount` | `number` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: api-endpoint-getoverview.md -->

# getOverview

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 30)

## Endpoint

`GET /analytics/:projectId/overview`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: constant-markdownprocessingerror.md -->

# markdownProcessingError$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 177)

Emits a processing error when such happens

<!-- source: component-propertypopover.md -->

# PropertyPopover

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/PropertyPopover.tsx` (line 16)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `title` | `any` | ✓ | - |
| `properties` | `any` | ✓ | - |
| `onChange` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PropertyPopover_7bdce1ea["PropertyPopover"]
    class component_PropertyPopover_7bdce1ea rootComponent
```

## Relationships

- RENDERS → `RadixPopover-Root`
- RENDERS → `RadixPopover-Trigger`
- RENDERS → `PopoverPortal`
- RENDERS → `PopoverContent`
- USES_HOOK → `useState`
- USES_HOOK → `useCellValue`
- USES_HOOK → `useForm`

<!-- source: interface-statetransition.md -->

# StateTransition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-machine.interface.ts` (line 67)

A transition between two states

## Properties

| Property | Type |
|---|---|
| `from` | `string` |
| `to` | `string` |
| `method` | `string` |
| `requiresModal` | `boolean` |
| `approvalRequired` | `boolean` |
| `trigger` | `'user-action' | 'system-event' | 'time-based' | 'automatic'` |
| `conditions` | `string[]` |
| `metadata` | `Record<string, unknown>` |

<!-- source: interface-toolschema.md -->

# ToolSchema

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/model-provider-interface.ts` (line 26)

Tool schema sent to the model.
Matches the OpenAI function-calling format (industry standard).

## Properties

| Property | Type |
|---|---|
| `type` | `'function'` |
| `name` | `string` |
| `description` | `string` |
| `parameters` | `Record<string, unknown>` |
| `strict` | `boolean` |

<!-- source: component-viewbutton.md -->

# ViewButton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/CodeParser.tsx` (line 184)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |
| `active` | `boolean` | ✓ | - |
| `onClick` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ViewButton_2e580519["ViewButton"]
    class component_ViewButton_2e580519 rootComponent
```

## Referenced By

- `CodeParser` (RENDERS)

<!-- source: interface-documentnode.md -->

# DocumentNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 135)

Document node in category

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `type` | `string` |
| `description` | `string` |
| `priority` | `number` |
| `metadata` | `{
    sourceScreenSlugs?: string[];
    /** screen-slug → relative screenshot ref paths within the output dir */
    screenImages?: Record<string, string[]>;
    [key: string]: unknown;
  }` |

<!-- source: api-endpoint-getpagemarkdown.md -->

# getPageMarkdown

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-mcp.controller.ts` (line 240)

## Endpoint

`GET /technical-docs/:projectId/pages/:slug.md`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `slug` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsMcpController` (MODULE_DECLARES)

<!-- source: constant-markdownsourceeditorvalue.md -->

# markdownSourceEditorValue$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 898)

The current value of the source/diff editors.

<!-- source: component-readonly.md -->

# ReadOnly

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/link-dialog.tsx` (line 50)

## Diagram

```mermaid
graph TD
    component_ReadOnly_41143212["ReadOnly"]
    class component_ReadOnly_41143212 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useState`

<!-- source: interface-statetransition-2.md -->

# StateTransition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/state-management.interface.ts` (line 33)

State transition for async operations

## Properties

| Property | Type |
|---|---|
| `from` | `string` |
| `to` | `string` |
| `trigger` | `string` |
| `condition` | `string` |
| `sideEffects` | `StateSideEffect[]` |

<!-- source: interface-toolsearchresult.md -->

# ToolSearchResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/tool-registry.ts` (line 29)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `parameters` | `Record<string, unknown>` |

<!-- source: component-viewerfooter.md -->

# ViewerFooter

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/DocumentViewer.tsx` (line 295)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `document` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ViewerFooter_33064d35["ViewerFooter"]
    class component_ViewerFooter_33064d35 rootComponent
```

## Referenced By

- `DocumentViewer` (RENDERS)

<!-- source: interface-documentplan.md -->

# DocumentPlan

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-09.types.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `title` | `string` |
| `sections` | `SectionPlan[]` |
| `frontmatter` | `{
    description: string;
    keywords: string[];
    difficulty: 'beginner' | 'intermediate' | 'advanced';
    estimatedReadTime: number; // minutes
  }` |
| `requiredEntities` | `{
    primary: string[]; // Entity IDs that MUST be included fully
    secondary: string[]; // Entity IDs for context (can be summarized)
    crossChunk: string[]; // Entity IDs from OTHER chunks (need fetching)
  }` |
| `criticalCode` | `Array<{
    entityId: string;
    reason: 'validation' | 'state_machine' | 'error_messages' | 'permissions';
    minCharacters: number; // Minimum chars to include (default: 2000)
  }>` |
| `sourceChunkId` | `string` |
| `relatedChunkIds` | `string[]` |

<!-- source: api-endpoint-getpagemarkdownbyurl.md -->

# getPageMarkdownByUrl

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 249)

## Endpoint

`GET /public/p/:slugWithId/pages/:slug.md`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |
| `slug` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-maxlengthplugin.md -->

# maxLengthPlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/maxlength/index.ts` (line 16)

A plugin that limits the maximum length of the text content of the editor.
Adapted from the Lexical plugin. https://github.com/facebook/lexical/blob/main/packages/lexical-playground/src/plugins/MaxLengthPlugin/index.tsx

<!-- source: component-readonly-2.md -->

# ReadOnly

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/toolbar.tsx` (line 48)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `readOnly` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ReadOnly_27e2e1ee["ReadOnly"]
    class component_ReadOnly_27e2e1ee rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: interface-storyentry.md -->

# StoryEntry

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/storybook/types.ts` (line 49)

Individual story entry

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `exportName` | `string` |
| `parameters` | `Record<string, unknown>` |
| `args` | `Record<string, unknown>` |
| `argTypes` | `Record<string, ArgType>` |
| `locStart` | `number` |
| `locEnd` | `number` |
| `meta` | `{
    /** Custom story name */
    storyName?: string;
    /** Width hint */
    width?: number;
    /** Height hint */
    height?: number;
    /** Additional metadata */
    [key: string]: unknown;
  }` |
| `render` | `string` |

<!-- source: interface-toolsearchtooloptions.md -->

# ToolSearchToolOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/tool-search.tool.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `registry` | `ToolRegistry` |
| `maxResults` | `number` |

<!-- source: component-viewerheader.md -->

# ViewerHeader

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/DocumentViewer.tsx` (line 72)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `document` | `unknown` | ✓ | - |
| `readingTime` | `number` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ViewerHeader_30302043["ViewerHeader"]
    class component_ViewerHeader_30302043 rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `ChevronRightIcon`
- RENDERS → `CheckIcon`
- RENDERS → `LinkIcon`
- RENDERS → `PrinterIcon`
- RENDERS → `PencilIcon`
- RENDERS → `ClockIcon`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`

## Referenced By

- `DocumentViewer` (RENDERS)

<!-- source: interface-documentrevision.md -->

# DocumentRevision

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/documents.ts` (line 35)

Document revision — snapshot of a document's state at a point in time

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `documentId` | `string` |
| `version` | `number` |
| `content` | `string` |
| `title` | `string` |
| `createdAt` | `string` |
| `createdBy` | `{
    id: string;
    name: string;
    email: string;
  } | null` |

<!-- source: api-endpoint-getprojectactivities.md -->

# getProjectActivities

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/activity/activity.controller.ts` (line 32)

## Endpoint

`GET /activities/projects/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ActivityController` (MODULE_DECLARES)

<!-- source: constant-mdastblockquotevisitor.md -->

# MdastBlockQuoteVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/quote/MdastBlockQuoteVisitor.ts` (line 5)

## Definition

```ts
MdastImportVisitor<Mdast.Blockquote>
```

<!-- source: component-readonlydiffmode.md -->

# ReadOnlyDiffMode

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/diff-source.tsx` (line 93)

## Diagram

```mermaid
graph TD
    component_ReadOnlyDiffMode_24ae3442["ReadOnlyDiffMode"]
    class component_ReadOnlyDiffMode_24ae3442 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- USES_HOOK → `useRef`

<!-- source: interface-storyfile.md -->

# StoryFile

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/storybook/types.ts` (line 110)

Parsed story file result

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `fileId` | `string` |
| `stories` | `StoryEntry[]` |
| `defaultExport` | `DefaultExport` |
| `source` | `string` |
| `version` | `CSFVersion` |

<!-- source: interface-traceevent.md -->

# TraceEvent

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tracing/otlp-exporter.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `timestamp` | `number` |
| `attributes` | `Record<string, string | number | boolean>` |

<!-- source: component-warningicon.md -->

# WarningIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/ParsingResults.tsx` (line 128)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_WarningIcon_60b0ae0b["WarningIcon"]
    class component_WarningIcon_60b0ae0b rootComponent
```

## Referenced By

- `ParsingResults` (RENDERS)

<!-- source: interface-documentrevision-2.md -->

# DocumentRevision

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/types/api-client.ts` (line 77)

Document revision — snapshot of a document at a point in time

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `documentId` | `string` |
| `version` | `number` |
| `content` | `string` |
| `title` | `string` |
| `createdAt` | `string` |
| `createdBy` | `{
    id: string;
    name: string;
    email: string;
  } | null` |

<!-- source: api-endpoint-getprojectaudiences.md -->

# getProjectAudiences

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 431)

## Endpoint

`GET /projects/:id/audiences`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: constant-mdastbreakvisitor.md -->

# MdastBreakVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/MdastBreakVisitor.ts` (line 7)

## Definition

```ts
MdastImportVisitor<Mdast.Paragraph>
```

<!-- source: component-realmwithplugins.md -->

# RealmWithPlugins

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/RealmWithPlugins.tsx` (line 45)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |
| `plugins` | `RealmPlugin[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_RealmWithPlugins_6f3f6733["RealmWithPlugins"]
    class component_RealmWithPlugins_6f3f6733 rootComponent
```

## Relationships

- RENDERS → `RealmContext-Provider`
- USES_HOOK → `useMemo`
- USES_HOOK → `useEffect`

<!-- source: interface-systemoverviewinput.md -->

# SystemOverviewInput

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/techdocs/system-overview.ts` (line 11)

## Properties

| Property | Type |
|---|---|
| `projectName` | `string` |
| `entities` | `Entity[]` |
| `relationships` | `Relationship[]` |
| `readme` | `string` |

<!-- source: interface-tracespan.md -->

# TraceSpan

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tracing/otlp-exporter.ts` (line 11)

OTLP Tracing Exporter

Generic: SDK TracingExporter → OpenTelemetry → Grafana.
Reusable by any agent (doc-automation, support AI, etc.)

Phase 6: Collects spans from the agent runtime and exports
them in OpenTelemetry format.

## Properties

| Property | Type |
|---|---|
| `traceId` | `string` |
| `spanId` | `string` |
| `parentSpanId` | `string` |
| `operationName` | `string` |
| `serviceName` | `string` |
| `startTime` | `number` |
| `endTime` | `number` |
| `duration` | `number` |
| `status` | `'ok' | 'error' | 'unset'` |
| `attributes` | `Record<string, string | number | boolean>` |
| `events` | `TraceEvent[]` |

<!-- source: component-webhookscontent.md -->

# WebhooksContent

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/settings/webhooks/page.tsx` (line 37)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_WebhooksContent_4eefa935["WebhooksContent"]
    class component_WebhooksContent_4eefa935 rootComponent
```

## Relationships

- USES_HOOK → `useSession`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useEffect`

## Referenced By

- `WebhooksPage` (RENDERS)

<!-- source: component-acceptinvitepage.md -->

# AcceptInvitePage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/invite/[token]/page.tsx` (line 17)

## Diagram

```mermaid
graph TD
    component_AcceptInvitePage_171c1d80["AcceptInvitePage"]
    class component_AcceptInvitePage_171c1d80 rootComponent
```

## Relationships

- RENDERS → `Link`
- USES_HOOK → `useParams`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-documentsummary.md -->

# DocumentSummary

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-11.types.ts` (line 81)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `category` | `string` |
| `type` | `string` |
| `keyTerms` | `string[]` |
| `referencedScreens` | `string[]` |
| `referencedRoles` | `string[]` |
| `navigationPaths` | `string[]` |

<!-- source: api-endpoint-getprojectjobs.md -->

# getProjectJobs

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/parsing/parsing.controller.ts` (line 99)

## Endpoint

`GET /projects/:projectId/parse`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `limit` | query | `number` | - |

## Referenced By

- `ParsingController` (MODULE_DECLARES)

<!-- source: constant-mdastcodevisitor.md -->

# MdastCodeVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/codeblock/MdastCodeVisitor.ts` (line 5)

## Definition

```ts
MdastImportVisitor<Mdast.Code>
```

<!-- source: component-remotemdxeditorrealmprovider.md -->

# RemoteMDXEditorRealmProvider

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/remote/index.tsx` (line 22)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_RemoteMDXEditorRealmProvider_73d336b9["RemoteMDXEditorRealmProvider"]
    class component_RemoteMDXEditorRealmProvider_73d336b9 rootComponent
```

## Relationships

- RENDERS → `RemoteMDXEditorRealmContext-Provider`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`
- USES_HOOK → `useMemo`

<!-- source: interface-tabdefinition.md -->

# TabDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/tab-extractor.ts` (line 21)

A tab definition extracted from template source code.

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `index` | `number` |
| `selector` | `string` |
| `tabSystem` | `string` |
| `conditionalOn` | `string` |
| `hostComponent` | `string` |
| `sourceFile` | `string` |

<!-- source: interface-trajectoryentry.md -->

# TrajectoryEntry

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tracing/trajectory-logger.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `timestamp` | `string` |
| `turn` | `number` |
| `event` | `string` |
| `data` | `Record<string, unknown>` |

<!-- source: component-accordion.md -->

# Accordion

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 317)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Accordion_2806ab21["Accordion"]
    class component_Accordion_2806ab21 rootComponent
```

<!-- source: interface-documenttreenode-2.md -->

# DocumentTreeNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/components/NavigationTree.tsx` (line 10)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `urlId` | `string` |
| `url` | `string` |
| `state` | `'DRAFT' | 'PUBLISHED' | 'ARCHIVED'` |
| `children` | `DocumentTreeNode[]` |

<!-- source: api-endpoint-getprojectstats.md -->

# getProjectStats

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/dashboard/dashboard.controller.ts` (line 28)

## Endpoint

`GET /dashboard/projects`

## Referenced By

- `DashboardController` (MODULE_DECLARES)

<!-- source: constant-mdastextensions.md -->

# mdastExtensions$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 282)

<!-- source: component-richtexteditor.md -->

# RichTextEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/MDXEditor.tsx` (line 58)

## Diagram

```mermaid
graph TD
    component_RichTextEditor_167e68e3["RichTextEditor"]
    class component_RichTextEditor_167e68e3 rootComponent
```

## Relationships

- RENDERS → `Child`
- RENDERS → `RenderRecursiveWrappers`
- RENDERS → `RichTextPlugin`
- RENDERS → `ContentEditable`
- USES_HOOK → `useTranslation`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useCellValues`

<!-- source: interface-templateanalysis.md -->

# TemplateAnalysis

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/template-analysis.interface.ts` (line 216)

Complete template analysis result

## Properties

| Property | Type |
|---|---|
| `framework` | `'angular' | 'vue' | 'react'` |
| `buttons` | `ButtonElement[]` |
| `links` | `LinkElement[]` |
| `forms` | `FormElement[]` |
| `conditionals` | `ConditionalBlock[]` |
| `loops` | `LoopBlock[]` |
| `routerLinks` | `RouterLinkElement[]` |
| `childComponents` | `ComponentUsage[]` |
| `modalTriggers` | `ModalTrigger[]` |
| `errors` | `string[]` |

<!-- source: interface-trajectoryloggerconfig.md -->

# TrajectoryLoggerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tracing/trajectory-logger.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `onEntry` | `(line: string) => void` |
| `outputPath` | `string` |
| `includeTokenUsage` | `boolean` |

<!-- source: component-accordionitem.md -->

# AccordionItem

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 325)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `title` | `any` | ✓ | - |
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AccordionItem_2067436e["AccordionItem"]
    class component_AccordionItem_2067436e rootComponent
```

## Relationships

- USES_HOOK → `useState`

<!-- source: interface-documentupdateresult.md -->

# DocumentUpdateResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 313)

Result of replacing placeholders in a document

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `documentPath` | `string` |
| `replacementsCount` | `number` |
| `failedReplacements` | `{ placeholder: string; reason: string }[]` |
| `updatedContent` | `string` |

<!-- source: api-endpoint-getpublicapispec.md -->

# getPublicApiSpec

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 698)

## Endpoint

`GET /public/p/:slugWithId/api-spec`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |
| `version` | query | `string` | - |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-mdastfrontmattervisitor.md -->

# MdastFrontmatterVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/frontmatter/MdastFrontmatterVisitor.ts` (line 5)

## Definition

```ts
MdastImportVisitor<Mdast.YAML>
```

<!-- source: component-root.md -->

# Root

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/toolbar.tsx` (line 43)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `readOnly` | `any` | ✓ | - |
| `children` | `any` | ✓ | - |
| `className` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Root_7914ca8c["Root"]
    class component_Root_7914ca8c rootComponent
```

## Relationships

- RENDERS → `RadixToolbar-Root`

<!-- source: interface-turnhook.md -->

# TurnHook

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 274)

Hook invoked before each model call within the agent loop.
Allows domain layers to:
- Inject runtime state into instructions (turn budget, progress, tool result summaries)
- Monitor context pressure and warn the agent
- Track turn progression

Implemented by domain layers (e.g., PmeTurnHook), wired in agent-runtime.ts
via the SDK's callModelInputFilter.

<!-- source: interface-uiinteraction.md -->

# UIInteraction

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/ui-interaction.interface.ts` (line 27)

UI Interaction Interface

Represents an interactive element on a page that can trigger state transitions.
Used to link buttons, forms, and other UI elements to their corresponding
state machine transitions.

## Properties

| Property | Type |
|---|---|
| `element` | `string` |
| `action` | `string` |
| `transition` | `string` |
| `targetState` | `string` |
| `requiresModal` | `boolean` |
| `selector` | `string` |
| `componentSource` | `string` |

<!-- source: component-activefilterchips.md -->

# ActiveFilterChips

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 219)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `filters` | `BoardFiltersState` | ✓ | - |
| `onChange` | `Function` | ✓ | - |
| `options` | `ReturnType` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ActiveFilterChips_f30d1c2["ActiveFilterChips"]
    class component_ActiveFilterChips_f30d1c2 rootComponent
```

## Relationships

- RENDERS → `Chip`

<!-- source: interface-documentuploadresult.md -->

# DocumentUploadResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 194)

Result of document upload operation

## Properties

| Property | Type |
|---|---|
| `success` | `boolean` |
| `uploaded` | `UploadedItem[]` |
| `failed` | `FailedUpload[]` |
| `stats` | `UploadStats` |
| `error` | `string` |

<!-- source: api-endpoint-getpublicchatconfig.md -->

# getPublicChatConfig

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 754)

## Endpoint

`GET /public/p/:slugWithId/chat/config`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-mdastheadingvisitor.md -->

# MdastHeadingVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/headings/MdastHeadingVisitor.ts` (line 5)

## Definition

```ts
MdastImportVisitor<Mdast.Heading>
```

<!-- source: component-sandpackeditor.md -->

# SandpackEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/sandpack/SandpackEditor.tsx` (line 26)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `nodeKey` | `any` | ✓ | - |
| `code` | `any` | ✓ | - |
| `focusEmitter` | `any` | ✓ | - |
| `preset` | `SandpackPreset` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SandpackEditor_725231f6["SandpackEditor"]
    class component_SandpackEditor_725231f6 rootComponent
```

## Relationships

- RENDERS → `SandpackProvider`
- RENDERS → `SandpackLayout`
- RENDERS → `SandpackCodeEditor`
- RENDERS → `SandpackPreview`
- RENDERS → `CodeUpdateEmitter`
- USES_HOOK → `useCodeMirrorRef`
- USES_HOOK → `useCellValues`
- USES_HOOK → `useCodeBlockEditorContext`
- USES_HOOK → `useTranslation`

<!-- source: interface-turnhookargs.md -->

# TurnHookArgs

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/types.ts` (line 251)

Arguments passed to TurnHook.beforeModelCall() before each model invocation.

## Properties

| Property | Type |
|---|---|
| `instructions` | `string | undefined` |
| `input` | `AgentInputItem[]` |
| `agentName` | `string` |
| `turnNumber` | `number` |
| `context` | `TContext | undefined` |

<!-- source: interface-uniqueconstraint-2.md -->

# UniqueConstraint

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/entity.interface.ts` (line 806)

Unique constraint definition

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `fields` | `string[]` |

<!-- source: component-addissuestoboarddialog.md -->

# AddIssuesToBoardDialog

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/AddIssuesToBoardDialog.tsx` (line 43)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `open` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `boardId` | `string` | ✓ | - |
| `columns` | `BoardColumnLite[]` | ✓ | - |
| `alreadyOnBoardIds` | `string[]` | ✓ | - |
| `onAdded` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_AddIssuesToBoardDialog_ad211fa["AddIssuesToBoardDialog"]
    class component_AddIssuesToBoardDialog_ad211fa rootComponent
```

## Relationships

- RENDERS → `Modal`
- RENDERS → `MagnifyingGlassIcon`
- RENDERS → `ExclamationTriangleIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useBoardsToast`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`
- USES_HOOK → `useMemo`

<!-- source: interface-documentuploadresult-2.md -->

# DocumentUploadResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-13.types.ts` (line 20)

## Properties

| Property | Type |
|---|---|
| `uploaded` | `UploadedDocument[]` |
| `failed` | `UploadFailure[]` |
| `stats` | `{
    totalDocuments: number;
    successful: number;
    failed: number;
    totalScreenshots: number;
  }` |

<!-- source: api-endpoint-getpublicdocument.md -->

# getPublicDocument

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/public-document.controller.ts` (line 102)

## Endpoint

`GET /public/documents/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `PublicDocumentController` (MODULE_DECLARES)

<!-- source: constant-mdasthtmlimagevisitor.md -->

# MdastHtmlImageVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/MdastImageVisitor.ts` (line 20)

## Definition

```ts
MdastImportVisitor<Mdast.Html>
```

<!-- source: component-select-2.md -->

# Select

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/select.tsx` (line 89)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `value` | `T` | ✓ | - |
| `onChange` | `Function` | ✓ | - |
| `triggerTitle` | `string` | ✓ | - |
| `placeholder` | `string` | ✓ | - |
| `disabled` | `boolean` | - | - |
| `items` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Select_1a72f749["Select"]
    class component_Select_1a72f749 rootComponent
```

## Relationships

- RENDERS → `RadixSelect-Root`
- RENDERS → `SelectTrigger`
- RENDERS → `SelectContent`
- RENDERS → `RadixSelect-Separator`
- RENDERS → `SelectItem`

<!-- source: interface-turnrecord.md -->

# TurnRecord

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/autonomous/circle-detector.ts` (line 29)

## Properties

| Property | Type |
|---|---|
| `turn` | `number` |
| `actionSignature` | `string` |
| `filesEdited` | `string[]` |
| `bashCommands` | `string[]` |
| `testResult` | `TestSnapshot | null` |
| `errorSignatures` | `string[]` |

<!-- source: interface-userjourneyanalysisoptions.md -->

# UserJourneyAnalysisOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/user-journey.interface.ts` (line 218)

Options for user journey analysis

## Properties

| Property | Type |
|---|---|
| `criticalOnly` | `boolean` |
| `maxDepth` | `number` |
| `includeSubflows` | `boolean` |
| `includeTemplateFlows` | `boolean` |
| `includeStateMachineFlows` | `boolean` |
| `minNodes` | `number` |

<!-- source: component-adminpage.md -->

# AdminPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/admin/page.tsx` (line 34)

## Diagram

```mermaid
graph TD
    component_AdminPage_2c35d3ba["AdminPage"]
    class component_AdminPage_2c35d3ba rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `ShieldCheckIcon`
- RENDERS → `Link`
- RENDERS → `Icon`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-documentupsertresult.md -->

# DocumentUpsertResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 266)

Document upsert result

## Properties

| Property | Type |
|---|---|
| `operation` | `UpsertOperation` |
| `document` | `{
    id: string; // Database ID
    slug: string;
    title: string;
    version: number;
  }` |

<!-- source: api-endpoint-getpublicentity.md -->

# getPublicEntity

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 657)

## Endpoint

`GET /public/p/:slugWithId/entity/:entityId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |
| `entityId` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-mdasthtmlvisitor.md -->

# MdastHTMLVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/MdastHTMLVisitor.ts` (line 8)

## Definition

```ts
MdastImportVisitor<MdastHTMLNode>
```

<!-- source: component-selectbuttontrigger.md -->

# SelectButtonTrigger

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/select.tsx` (line 69)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |
| `title` | `any` | ✓ | - |
| `className` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SelectButtonTrigger_193b0d51["SelectButtonTrigger"]
    class component_SelectButtonTrigger_193b0d51 rootComponent
```

## Relationships

- RENDERS → `TooltipWrap`
- RENDERS → `RadixSelect-Trigger`
- RENDERS → `RadixSelect-Icon`
- USES_HOOK → `useCellValues`

<!-- source: interface-userjourneyanalysisresult.md -->

# UserJourneyAnalysisResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/user-journey.interface.ts` (line 181)

Result of analyzing a component for user journeys

## Properties

| Property | Type |
|---|---|
| `source` | `string` |
| `framework` | `'angular' | 'react' | 'vue'` |
| `flows` | `UserJourneyFlow[]` |
| `errors` | `string[]` |
| `warnings` | `string[]` |
| `metadata` | `{
    /** Duration in milliseconds */
    duration: number;

    /** Number of flows found */
    flowCount: number;

    /** Number of nodes across all flows */
    totalNodeCount: number;

    /** Number of edges across all flows */
    totalEdgeCount: number;

    [key: string]: any;
  }` |

<!-- source: interface-vectorstoreconfig.md -->

# VectorStoreConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/semantic/vector-store.ts` (line 53)

## Properties

| Property | Type |
|---|---|
| `storageDir` | `string` |
| `projectRoot` | `string` |

<!-- source: component-agentactionsconfig.md -->

# AgentActionsConfig

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/components/AgentActionsConfig.tsx` (line 15)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AgentActionsConfig_1173e685["AgentActionsConfig"]
    class component_AgentActionsConfig_1173e685 rootComponent
```

## Relationships

- RENDERS → `BoltIcon`
- RENDERS → `XMarkIcon`
- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `CheckCircleIcon`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-dotnetendpoint.md -->

# DotNetEndpoint

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/dotnet-detector.ts` (line 37)

.NET API endpoint

## Properties

| Property | Type |
|---|---|
| `method` | `'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'` |
| `route` | `string` |
| `actionName` | `string` |
| `parameters` | `DotNetParameter[]` |
| `returnType` | `string` |
| `authorization` | `string` |

<!-- source: api-endpoint-getpublicstats.md -->

# getPublicStats

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/app/app.controller.ts` (line 14)

## Endpoint

`GET /stats`

## Referenced By

- `AppController` (MODULE_DECLARES)

<!-- source: constant-mdastimagevisitor.md -->

# MdastImageVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/MdastImageVisitor.ts` (line 7)

## Definition

```ts
MdastImportVisitor<Mdast.Image>
```

<!-- source: component-seo.md -->

# SEO

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/seo.tsx` (line 31)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `titleKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | ✓ | - |
| `canonicalUrl` | `string` | - | - |
| `ogImage` | `string` | - | - |
| `ogType` | `string` | - | "website" |
| `twitterCard` | `unknown | unknown` | - | "summary_large_image" |
| `structuredData` | `StructuredData` | - | - |
| `noIndex` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_SEO_5fae89e6["SEO"]
    class component_SEO_5fae89e6 rootComponent
```

## Relationships

- RENDERS → `Helmet`
- USES_HOOK → `useTranslation`

<!-- source: interface-userjourneybuildcontext.md -->

# UserJourneyBuildContext

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/user-journey.interface.ts` (line 246)

Context for building user journey nodes

Tracks state while traversing code to build journey flows

## Properties

| Property | Type |
|---|---|
| `componentName` | `string` |
| `currentRoute` | `string` |
| `nodes` | `Map<string, UserJourneyNode>` |
| `edges` | `UserJourneyEdge[]` |
| `visitedNodeIds` | `Set<string>` |
| `depth` | `number` |
| `options` | `UserJourneyAnalysisOptions` |

<!-- source: interface-verboseevent.md -->

# VerboseEvent

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/verbose-logger.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `category` | `string` |
| `message` | `string` |
| `data` | `Record<string, unknown>` |
| `timestamp` | `number` |

<!-- source: component-agenttrafficcockpit.md -->

# AgentTrafficCockpit

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/analytics/AgentTrafficCockpit.tsx` (line 86)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AgentTrafficCockpit_204a76d1["AgentTrafficCockpit"]
    class component_AgentTrafficCockpit_204a76d1 rootComponent
```

## Relationships

- RENDERS → `AreaChart`
- RENDERS → `ShareRow`
- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-dotnetmethod.md -->

# DotNetMethod

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/dotnet-detector.ts` (line 78)

.NET method

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `returnType` | `string` |
| `isAsync` | `boolean` |
| `parameters` | `DotNetParameter[]` |

<!-- source: api-endpoint-getpublicsupportagents.md -->

# getPublicSupportAgents

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 729)

## Endpoint

`GET /public/p/:slugWithId/support-agents`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-mdastinlinecodevisitor.md -->

# MdastInlineCodeVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/MdastInlineCodeVisitor.ts` (line 26)

## Definition

```ts
MdastImportVisitor<Mdast.InlineCode>
```

<!-- source: component-sharedhistoryplugin.md -->

# SharedHistoryPlugin

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/SharedHistoryPlugin.tsx` (line 6)

## Diagram

```mermaid
graph TD
    component_SharedHistoryPlugin_8198dd6["SharedHistoryPlugin"]
    class component_SharedHistoryPlugin_8198dd6 rootComponent
```

## Relationships

- RENDERS → `HistoryPlugin`
- USES_HOOK → `useCellValue`

<!-- source: interface-userjourneydiagramresult.md -->

# UserJourneyDiagramResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/user-journey-diagram.generator.ts` (line 51)

Result of user journey diagram generation

## Properties

| Property | Type |
|---|---|
| `flows` | `UserJourneyFlow[]` |
| `diagrams` | `Map<string, string>` |
| `errors` | `string[]` |
| `warnings` | `string[]` |
| `stats` | `{
    totalFlows: number;
    totalNodes: number;
    totalEdges: number;
    byFramework: Record<string, number>;
  }` |

<!-- source: interface-verboseloggeroptions.md -->

# VerboseLoggerOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/session/verbose-logger.ts` (line 33)

## Properties

| Property | Type |
|---|---|
| `previewLimit` | `number` |

<!-- source: component-aiassistant.md -->

# AIAssistant

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/AIAssistant.tsx` (line 28)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `_documentId` | `string` | - | - |
| `documentContent` | `string` | - | - |
| `onClose` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_AIAssistant_b06d1fb["AIAssistant"]
    class component_AIAssistant_b06d1fb rootComponent
```

## Relationships

- RENDERS → `ProviderSelector`
- RENDERS → `Settings`
- RENDERS → `Trash2`
- RENDERS → `X`
- RENDERS → `MessageList`
- RENDERS → `PromptInput`
- USES_HOOK → `useState`
- USES_HOOK → `useAI`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-dotnetparameter.md -->

# DotNetParameter

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/dotnet-detector.ts` (line 49)

.NET parameter

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `source` | `'body' | 'query' | 'route' | 'header' | 'form'` |
| `required` | `boolean` |

<!-- source: api-endpoint-getpublictechnicalsnapshot.md -->

# getPublicTechnicalSnapshot

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 624)

## Endpoint

`GET /public/p/:slugWithId/technical-snapshot`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |
| `version` | query | `string` | - |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-mdastjsximagevisitor.md -->

# MdastJsxImageVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/MdastImageVisitor.ts` (line 65)

## Definition

```ts
MdastImportVisitor<MdxJsxTextElement | MdxJsxFlowElement>
```

<!-- source: component-showsandpackinfo.md -->

# ShowSandpackInfo

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/ShowSandpackInfo.tsx` (line 15)

## Diagram

```mermaid
graph TD
    component_ShowSandpackInfo_27202d3b["ShowSandpackInfo"]
    class component_ShowSandpackInfo_27202d3b rootComponent
```

## Relationships

- RENDERS → `ButtonWithTooltip`
- USES_HOOK → `useCellValues`
- USES_HOOK → `useTranslation`

<!-- source: interface-userjourneyedge.md -->

# UserJourneyEdge

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/user-journey.interface.ts` (line 94)

Connection between two nodes in a user journey

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `from` | `string` |
| `to` | `string` |
| `label` | `string` |
| `condition` | `string` |
| `isDefault` | `boolean` |
| `metadata` | `Record<string, any>` |

<!-- source: interface-vercelaiproviderconfig.md -->

# VercelAIProviderConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/runtime/runtime-config.ts` (line 40)

Vercel AI SDK provider configuration.
Uses the `ai` package to call any supported LLM provider.

## Properties

| Property | Type |
|---|---|
| `provider` | `string` |
| `model` | `string` |
| `apiKey` | `string` |
| `baseUrl` | `string` |

<!-- source: component-aipage.md -->

# AIPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/ai/page.tsx` (line 11)

## Diagram

```mermaid
graph TD
    component_AIPage_6c973cfa["AIPage"]
    class component_AIPage_6c973cfa rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `SparklesIcon`
- RENDERS → `Card`
- RENDERS → `CardHeader`
- RENDERS → `CardContent`

<!-- source: interface-editimagetoolbarprops.md -->

# EditImageToolbarProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/EditImageToolbar.tsx` (line 10)

## Properties

| Property | Type |
|---|---|
| `nodeKey` | `string` |
| `imageSource` | `string` |
| `initialImagePath` | `string | null` |
| `title` | `string` |
| `alt` | `string` |
| `width` | `number | 'inherit'` |
| `height` | `number | 'inherit'` |

<!-- source: api-endpoint-getpublictree.md -->

# getPublicTree

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/public-document.controller.ts` (line 146)

## Endpoint

`GET /public/documents/tree/:organizationId/:projectId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `organizationId` | query | `string` | ✓ |
| `projectId` | query | `string` | ✓ |

## Referenced By

- `PublicDocumentController` (MODULE_DECLARES)

<!-- source: constant-mdastlinkvisitor.md -->

# MdastLinkVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link/MdastLinkVisitor.ts` (line 5)

## Definition

```ts
MdastImportVisitor<Mdast.Link>
```

<!-- source: component-simpletoolbar.md -->

# SimpleToolbar

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/toolbar.tsx` (line 157)

## Diagram

```mermaid
graph TD
    component_SimpleToolbar_622ad2a3["SimpleToolbar"]
    class component_SimpleToolbar_622ad2a3 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `UndoRedo`
- RENDERS → `Separator`

<!-- source: interface-userjourneyflow.md -->

# UserJourneyFlow

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/user-journey.interface.ts` (line 123)

A complete user journey flow

Represents an end-to-end user interaction flow through the application,
including screens, actions, decisions, and navigation.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `framework` | `'angular' | 'react' | 'vue'` |
| `component` | `string` |
| `nodes` | `UserJourneyNode[]` |
| `edges` | `UserJourneyEdge[]` |
| `startNodeId` | `string` |
| `endNodeIds` | `string[]` |
| `tags` | `string[]` |
| `metadata` | `{
    /** Estimated complexity (1-10) */
    complexity?: number;

    /** Number of user actions required */
    actionCount?: number;

    /** Number of decision points */
    decisionCount?: number;

    /** Number of screens involved */
    screenCount?: number;

    /** Is this a critical user flow? */
    isCritical?: boolean;

    /** Related state machine IDs */
    relatedStateMachines?: string[];

    [key: string]: any;
  }` |

<!-- source: interface-watchmodeconfig.md -->

# WatchModeConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/watch-mode.ts` (line 4)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `includePatterns` | `string[]` |
| `excludeDirs` | `string[]` |
| `markers` | `string[]` |
| `onMarkerFound` | `(marker: MarkerResult) => void` |
| `debounceMs` | `number` |

<!-- source: component-aisettingspage.md -->

# AISettingsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/ai/page.tsx` (line 36)

## Diagram

```mermaid
graph TD
    component_AISettingsPage_2013264d["AISettingsPage"]
    class component_AISettingsPage_2013264d rootComponent
```

## Relationships

- RENDERS → `ProviderConfig`
- RENDERS → `UsagePanel`
- RENDERS → `RequestHistory`
- RENDERS → `PromptLibrary`
- RENDERS → `SettingsManager`
- USES_HOOK → `useSession`
- USES_HOOK → `useAIProviders`
- USES_HOOK → `useAISettings`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-editingimagedialogstate.md -->

# EditingImageDialogState

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 106)

The state of the image dialog when it is in editing an existing node.

## Properties

| Property | Type |
|---|---|
| `type` | `'editing'` |
| `nodeKey` | `string` |
| `initialValues` | `Omit<SaveImageParameters, 'file'>` |

<!-- source: api-endpoint-getpublishedlanguagesbyurl.md -->

# getPublishedLanguagesByUrl

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 354)

## Endpoint

`GET /public/p/:slugWithId/languages`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-mdastlistitemvisitor.md -->

# MdastListItemVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/lists/MdastListItemVisitor.ts` (line 5)

## Definition

```ts
MdastImportVisitor<Mdast.ListItem>
```

<!-- source: component-singlechoicetogglegroup.md -->

# SingleChoiceToggleGroup

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/toolbar.tsx` (line 140)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `value` | `T | unknown` | ✓ | - |
| `onChange` | `Function` | ✓ | - |
| `className` | `string` | - | - |
| `ggClassName` | `string` | - | - |
| `items` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SingleChoiceToggleGroup_79ca4df0["SingleChoiceToggleGroup"]
    class component_SingleChoiceToggleGroup_79ca4df0 rootComponent
```

## Relationships

- RENDERS → `RadixToolbar-ToggleGroup`
- RENDERS → `ToolbarToggleItem`
- RENDERS → `TooltipWrap`
- USES_HOOK → `useTranslation`

<!-- source: interface-userjourneygenerationoptions.md -->

# UserJourneyGenerationOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/user-journey-diagram.generator.ts` (line 31)

Options for generating user journey diagrams

## Properties

| Property | Type |
|---|---|
| `includeRouteFlows` | `boolean` |
| `includeComponentFlows` | `boolean` |
| `componentFilter` | `string[]` |
| `routeFilter` | `string[]` |
| `frameworkFilter` | `Array<'angular' | 'react' | 'vue'>` |

<!-- source: interface-webfetchoptions.md -->

# WebFetchOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/web-fetch.tool.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `maxContentLength` | `number` |
| `timeout` | `number` |

<!-- source: component-alert.md -->

# Alert

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 188)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `type` | `any` | - | "info" |
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Alert_217a838d["Alert"]
    class component_Alert_217a838d rootComponent
```

<!-- source: interface-editlinkdialog.md -->

# EditLinkDialog

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 54)

The state of the link dialog when it is in edit mode.

## Properties

| Property | Type |
|---|---|
| `type` | `'edit'` |
| `initialUrl` | `string` |
| `hasInitialText` | `boolean` |
| `url` | `string` |
| `title` | `string` |
| `linkNodeKey` | `string` |
| `rectangle` | `RectData` |

<!-- source: api-endpoint-getpublishedprojects.md -->

# getPublishedProjects

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 64)

## Endpoint

`GET /public/projects`

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-mdastlistvisitor.md -->

# MdastListVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/lists/MdastListVisitor.ts` (line 6)

## Definition

```ts
MdastImportVisitor<Mdast.List>
```

<!-- source: component-socialproofstatsgrid-2.md -->

# SocialProofStatsGrid

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/social-proof/social-proof-stats-grid.tsx` (line 14)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | - | - |
| `descriptionKey` | `string` | - | - |
| `stats` | `unknown[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SocialProofStatsGrid_54fd95ef["SocialProofStatsGrid"]
    class component_SocialProofStatsGrid_54fd95ef rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `StatCard`
- USES_HOOK → `useTranslation`

<!-- source: interface-userjourneynode.md -->

# UserJourneyNode

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/user-journey.interface.ts` (line 53)

A single node in a user journey

Represents a step in the user's interaction with the application.
Could be a screen they see, an action they take, or a decision point.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `type` | `UserJourneyNodeType` |
| `label` | `string` |
| `description` | `string` |
| `componentName` | `string` |
| `routePath` | `string` |
| `userAction` | `string` |
| `handlerMethod` | `string` |
| `condition` | `string` |
| `sourceLine` | `number` |
| `sourceFile` | `string` |
| `metadata` | `Record<string, any>` |

<!-- source: interface-websearchoptions.md -->

# WebSearchOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/web-search.tool.ts` (line 41)

## Properties

| Property | Type |
|---|---|
| `braveApiKey` | `string` |
| `models` | `SearchModelDeployment[]` |
| `maxResults` | `number` |
| `timeout` | `number` |
| `perModelCooldownMs` | `number` |

<!-- source: component-analyticspage.md -->

# AnalyticsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/analytics/page.tsx` (line 201)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AnalyticsPage_6c7dafbf["AnalyticsPage"]
    class component_AnalyticsPage_6c7dafbf rootComponent
```

## Relationships

- RENDERS → `AnalyticsContent`

<!-- source: interface-editorinfocus.md -->

# EditorInFocus

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 109)

The type of the editor being edited currently. Custom editors can override this, so that the toolbar can change its contents.

## Properties

| Property | Type |
|---|---|
| `editorType` | `string` |
| `rootNode` | `LexicalNode | null` |
| `editorRef` | `unknown` |

<!-- source: api-endpoint-getpublishedversions.md -->

# getPublishedVersions

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 342)

## Endpoint

`GET /public/p/:slugWithId/versions`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-mdastmdxexpressionvisitor.md -->

# MdastMdxExpressionVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/MdastMdxExpressionVisitor.ts` (line 6)

## Definition

```ts
MdastImportVisitor<MdxTextExpression | MdxFlowExpression>
```

<!-- source: component-socialprooftestimonials-2.md -->

# SocialProofTestimonials

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/social-proof/social-proof-testimonials.tsx` (line 22)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | - | - |
| `descriptionKey` | `string` | - | - |
| `testimonials` | `Testimonial[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SocialProofTestimonials_413593a8["SocialProofTestimonials"]
    class component_SocialProofTestimonials_413593a8 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `TestimonialCard`
- USES_HOOK → `useTranslation`

<!-- source: interface-validationcheck.md -->

# ValidationCheck

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/coverage-validator.ts` (line 61)

Validation result for a single check

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `passed` | `boolean` |
| `severity` | `'critical' | 'error' | 'warning' | 'info'` |
| `message` | `string` |
| `actual` | `number | string` |
| `expected` | `number | string` |
| `recommendation` | `string` |

<!-- source: interface-worktreecontroloptions.md -->

# WorktreeControlOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/worktree-control.tool.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `worktreeManager` | `WorktreeManager` |

<!-- source: component-apiplaygroundpage.md -->

# ApiPlaygroundPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/api/page.tsx` (line 28)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ApiPlaygroundPage_63398d9e["ApiPlaygroundPage"]
    class component_ApiPlaygroundPage_63398d9e rootComponent
```

## Relationships

- RENDERS → `KeyIcon`
- RENDERS → `AgentActionsConfig`
- RENDERS → `Link`
- RENDERS → `ArrowLeftIcon`
- RENDERS → `ArrowPathIcon`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useEffect`

<!-- source: interface-entity-3.md -->

# Entity

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 179)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `type` | `EntityType` |
| `filePath` | `string` |
| `tier` | `EntityTier` |
| `sourceCode` | `string` |
| `signature` | `string` |
| `summary` | `string` |
| `startLine` | `number` |
| `endLine` | `number` |
| `exports` | `boolean` |
| `isUserFacing` | `boolean` |
| `dependencies` | `string[]` |
| `dependents` | `string[]` |

<!-- source: api-endpoint-getrecentdocuments.md -->

# getRecentDocuments

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/activity/activity.controller.ts` (line 48)

## Endpoint

`GET /activities/recent/documents`

| Parameter | In | Type | Required |
|---|---|---|---|
| `limit` | query | `number` | - |
| `projectId` | query | `string` | - |

## Referenced By

- `ActivityController` (MODULE_DECLARES)

<!-- source: constant-mdastmdxjsesmvisitor.md -->

# MdastMdxJsEsmVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/MdastMdxJsEsmVisitor.ts` (line 4)

## Definition

```ts
MdastImportVisitor<MdxjsEsm>
```

<!-- source: component-socialprooftimeline-2.md -->

# SocialProofTimeline

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/social-proof/social-proof-timeline.tsx` (line 78)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | - | - |
| `milestones` | `Milestone[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SocialProofTimeline_2c004d08["SocialProofTimeline"]
    class component_SocialProofTimeline_2c004d08 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `TimelineDot`
- RENDERS → `MilestoneCard`
- USES_HOOK → `useTranslation`

<!-- source: interface-validationreport.md -->

# ValidationReport

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/coverage-validator.ts` (line 101)

Complete validation report

## Properties

| Property | Type |
|---|---|
| `isValid` | `boolean` |
| `coverageReport` | `CoverageReport` |
| `checks` | `ValidationCheck[]` |
| `criticalCount` | `number` |
| `errorCount` | `number` |
| `warningCount` | `number` |
| `summary` | `string` |
| `topPriorityActions` | `string[]` |
| `effortEstimate` | `{
    /**
     * Number of additional screenshots needed
     */
    screenshotsNeeded: number;

    /**
     * Number of uncovered states
     */
    uncoveredStatesCount: number;

    /**
     * Number of uncovered transitions
     */
    uncoveredTransitionsCount: number;

    /**
     * Estimated time in hours (rough estimate)
     */
    estimatedHours: number;
  }` |

<!-- source: interface-worktreecontroltools.md -->

# WorktreeControlTools

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/worktree-control.tool.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `enterWorktreeTool` | `ToolDefinition<TContext>` |
| `exitWorktreeTool` | `ToolDefinition<TContext>` |
| `activeWorktree` | `WorktreeInfo | undefined` |

<!-- source: component-audienceblock.md -->

# AudienceBlock

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/AudienceBlock.tsx` (line 46)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `audience` | `Audience` | - | - |
| `audienceLogic` | `string` | - | - |
| `children` | `unknown` | ✓ | - |
| `onEdit` | `Function` | - | - |
| `onDelete` | `Function` | - | - |
| `isNested` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_AudienceBlock_1eec9820["AudienceBlock"]
    class component_AudienceBlock_1eec9820 rootComponent
```

## Relationships

- USES_HOOK → `useState`

<!-- source: interface-entitydependencygraph.md -->

# EntityDependencyGraph

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 216)

EntityDependencyGraph - Tracks what code depends on what

Used to ensure we don't just extract a form, but also its
validation schema, services, and state management.

## Properties

| Property | Type |
|---|---|
| `nodes` | `Map<string, EntityNode>` |
| `edges` | `DependencyEdge[]` |

<!-- source: api-endpoint-getrecentprojects.md -->

# getRecentProjects

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/activity/activity.controller.ts` (line 40)

## Endpoint

`GET /activities/recent/projects`

| Parameter | In | Type | Required |
|---|---|---|---|
| `limit` | query | `number` | - |

## Referenced By

- `ActivityController` (MODULE_DECLARES)

<!-- source: constant-mdastmdxjsxelementvisitor.md -->

# MdastMdxJsxElementVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/MdastMdxJsxElementVisitor.ts` (line 7)

## Definition

```ts
MdastImportVisitor<MdxJsxTextElement | MdxJsxFlowElement>
```

<!-- source: component-socialprooftrustbadges-2.md -->

# SocialProofTrustBadges

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/social-proof/social-proof-trust-badges.tsx` (line 36)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `headlineKey` | `string` | - | - |
| `descriptionKey` | `string` | - | - |
| `badges` | `TrustBadge[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SocialProofTrustBadges_4f1aae85["SocialProofTrustBadges"]
    class component_SocialProofTrustBadges_4f1aae85 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h2`
- RENDERS → `motion-p`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: interface-versionconfig.md -->

# VersionConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/version-config.ts` (line 41)

Version configuration

## Properties

| Property | Type |
|---|---|
| `currentVersion` | `string` |
| `latestVersion` | `string` |
| `versions` | `VersionInfo[]` |
| `defaultVersion` | `string` |

<!-- source: interface-worktreeinfo.md -->

# WorktreeInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/worktree-manager.ts` (line 32)

## Properties

| Property | Type |
|---|---|
| `branch` | `string` |
| `path` | `string` |
| `createdAt` | `number` |

<!-- source: component-audiencelist.md -->

# AudienceList

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/PublishingSidebar/AudienceList.tsx` (line 32)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `audiences` | `Audience[]` | ✓ | - |
| `selectedAudience` | `string | null` | ✓ | - |
| `onSelectAudience` | `Function` | ✓ | - |
| `loading` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_AudienceList_451cca0c["AudienceList"]
    class component_AudienceList_451cca0c rootComponent
```

## Relationships

- RENDERS → `Users`
- RENDERS → `ChevronRight`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-entitynode.md -->

# EntityNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 221)

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `name` | `string` |
| `type` | `EntityType` |
| `tier` | `EntityTier` |
| `isDocumentationRelevant` | `boolean` |

<!-- source: api-endpoint-getrelated.md -->

# getRelated

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/graph.controller.ts` (line 57)

## Endpoint

`GET /knowledge-graph/entities/:id/related`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `depth` | query | `number` | - |
| `type` | query | `string` | - |

## Referenced By

- `GraphController` (MODULE_DECLARES)

<!-- source: constant-mdastparagraphvisitor.md -->

# MdastParagraphVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/MdastParagraphVisitor.ts` (line 8)

## Definition

```ts
MdastImportVisitor<Mdast.Paragraph>
```

<!-- source: component-sourceeditor.md -->

# SourceEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/diff-source/SourceEditor.tsx` (line 19)

## Diagram

```mermaid
graph TD
    component_SourceEditor_676a5c02["SourceEditor"]
    class component_SourceEditor_676a5c02 rootComponent
```

## Relationships

- USES_HOOK → `useCellValues`
- USES_HOOK → `usePublisher`
- USES_HOOK → `useRef`
- USES_HOOK → `useCallback`

<!-- source: interface-versiondiff-2.md -->

# VersionDiff

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/version-diff.ts` (line 55)

Version diff result

## Properties

| Property | Type |
|---|---|
| `fromVersion` | `string` |
| `toVersion` | `string` |
| `changes` | `EntityChange[]` |
| `added` | `EntityChange[]` |
| `removed` | `EntityChange[]` |
| `modified` | `EntityChange[]` |
| `statistics` | `DiffStatistics` |
| `generatedAt` | `Date` |

<!-- source: interface-worktreemanagerconfig.md -->

# WorktreeManagerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/worktree-manager.ts` (line 23)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `maxWorktrees` | `number` |
| `staleThresholdMs` | `number` |

<!-- source: component-audiencepreviewpanel.md -->

# AudiencePreviewPanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/AudiencePreviewPanel.tsx` (line 12)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `documentId` | `string` | ✓ | - |
| `selectedAudiences` | `string[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AudiencePreviewPanel_511d98f6["AudiencePreviewPanel"]
    class component_AudiencePreviewPanel_511d98f6 rootComponent
```

## Relationships

- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `MarkdownRenderer`
- USES_HOOK → `useState`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useEffect`

<!-- source: interface-entityselectionconfig.md -->

# EntitySelectionConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/entity-selector.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `maxEntities` | `number` |
| `maxTokens` | `number` |
| `charsPerToken` | `number` |

<!-- source: api-endpoint-getrelateddocuments.md -->

# getRelatedDocuments

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 539)

## Endpoint

`GET /public/p/:slugWithId/related`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |
| `doc` | query | `string` | ✓ |
| `audience` | query | `string` | ✓ |
| `version` | query | `string` | - |
| `lang` | query | `string` | - |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-mdastrootvisitor.md -->

# MdastRootVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/MdastRootVisitor.ts` (line 4)

## Definition

```ts
MdastImportVisitor<Mdast.Root>
```

<!-- source: component-spanwithcolor.md -->

# SpanWithColor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/colors.tsx` (line 77)

## Diagram

```mermaid
graph TD
    component_SpanWithColor_32d45efe["SpanWithColor"]
    class component_SpanWithColor_32d45efe rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `ColorsToolbar`

<!-- source: interface-versiondiffoptions.md -->

# VersionDiffOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/version-diff.generator.ts` (line 22)

Version diff options

## Properties

| Property | Type |
|---|---|
| `includeDescriptions` | `boolean` |
| `detectBreaking` | `boolean` |
| `includeSourceDiff` | `boolean` |

<!-- source: interface-writefileoptions.md -->

# WriteFileOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/agent-core/src/tools/write-file.tool.ts` (line 16)

## Properties

| Property | Type |
|---|---|
| `rootDir` | `string` |
| `maxFileSize` | `number` |
| `checkpointManager` | `CheckpointManager` |

<!-- source: component-audienceselector.md -->

# AudienceSelector

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/AudienceSelector.tsx` (line 16)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `audiences` | `Audience[]` | ✓ | - |
| `selected` | `Audience` | ✓ | - |
| `onChange` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AudienceSelector_350e59f7["AudienceSelector"]
    class component_AudienceSelector_350e59f7 rootComponent
```

<!-- source: interface-environment.md -->

# Environment

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/APIExplorer.ts` (line 55)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `variables` | `Record<string, string>` |

<!-- source: api-endpoint-getrelationships.md -->

# getRelationships

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/graph.controller.ts` (line 81)

## Endpoint

`GET /knowledge-graph/entities/:id/relationships`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `GraphController` (MODULE_DECLARES)

<!-- source: constant-mdasttablevisitor.md -->

# MdastTableVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/table/MdastTableVisitor.ts` (line 6)

## Definition

```ts
MdastImportVisitor<Mdast.Table>
```

<!-- source: component-spanwithcolor-2.md -->

# SpanWithColor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/html.tsx` (line 51)

## Diagram

```mermaid
graph TD
    component_SpanWithColor_29241ba3["SpanWithColor"]
    class component_SpanWithColor_29241ba3 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `HTMLToolbarComponent`

<!-- source: interface-versioninfo.md -->

# VersionInfo

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/version-config.ts` (line 11)

Version Configuration and Utilities

## Properties

| Property | Type |
|---|---|
| `version` | `string` |
| `label` | `string` |
| `releaseDate` | `Date` |
| `isLatest` | `boolean` |
| `isPrerelease` | `boolean` |
| `isDeprecated` | `boolean` |
| `deprecationMessage` | `string` |
| `docsPath` | `string` |
| `gitRef` | `string` |
| `changelogUrl` | `string` |
| `supportStatus` | `'active' | 'maintenance' | 'eol'` |
| `eolDate` | `Date` |

<!-- source: component-audienceselectormodal.md -->

# AudienceSelectorModal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/AudienceSelectorModal.tsx` (line 43)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `open` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `onApply` | `Function` | ✓ | - |
| `audiences` | `Audience[]` | ✓ | - |
| `initialSelection` | `string[]` | - | [] |

## Diagram

```mermaid
graph TD
    component_AudienceSelectorModal_14481940["AudienceSelectorModal"]
    class component_AudienceSelectorModal_14481940 rootComponent
```

## Relationships

- RENDERS → `Transition`
- RENDERS → `Dialog`
- RENDERS → `Transition-Child`
- RENDERS → `Dialog-Panel`
- RENDERS → `Dialog-Title`
- USES_HOOK → `useState`
- USES_HOOK → `useMemo`

<!-- source: interface-environment-2.md -->

# Environment

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/EndpointDetail.ts` (line 56)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `variables` | `Record<string, string>` |

<!-- source: api-endpoint-getrelationships-2.md -->

# getRelationships

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/kg-sync.controller.ts` (line 223)

Get all relationships for a project

## Endpoint

`GET /projects/:projectId/relationships`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `KgSyncController` (MODULE_DECLARES)

<!-- source: constant-mdasttextvisitor.md -->

# MdastTextVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/MdastTextVisitor.ts` (line 6)

## Definition

```ts
MdastImportVisitor<Mdast.Text>
```

<!-- source: component-statcard-5.md -->

# StatCard

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/stat-card.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `valueKey` | `string` | ✓ | - |
| `labelKey` | `string` | ✓ | - |
| `className` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_StatCard_3978ba54["StatCard"]
    class component_StatCard_3978ba54 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- USES_HOOK → `useTranslation`

<!-- source: interface-versionselectoroptions.md -->

# VersionSelectorOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/version-selector.generator.ts` (line 10)

## Properties

| Property | Type |
|---|---|
| `className` | `string` |
| `showBanner` | `boolean` |
| `showLabels` | `boolean` |
| `showSupportStatus` | `boolean` |

<!-- source: component-audiencesettingspage.md -->

# AudienceSettingsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/audiences/page.tsx` (line 15)

## Diagram

```mermaid
graph TD
    component_AudienceSettingsPage_4ff5807e["AudienceSettingsPage"]
    class component_AudienceSettingsPage_4ff5807e rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `UsersIcon`
- RENDERS → `Button`
- RENDERS → `PlusIcon`
- RENDERS → `Card`
- RENDERS → `CardHeader`
- RENDERS → `CardContent`
- RENDERS → `PencilIcon`
- RENDERS → `TrashIcon`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-environment-3.md -->

# Environment

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/EnvironmentSelector.ts` (line 8)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `variables` | `Record<string, string>` |

<!-- source: api-endpoint-getrelationshipsforentity.md -->

# getRelationshipsForEntity

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/kg-sync.controller.ts` (line 252)

Get relationships for a specific entity

## Endpoint

`GET /projects/:projectId/entities/:entityId/relationships`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `entityId` | query | `string` | ✓ |

## Referenced By

- `KgSyncController` (MODULE_DECLARES)

<!-- source: constant-mdastthematicbreakvisitor.md -->

# MdastThematicBreakVisitor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/thematic-break/MdastThematicBreakVisitor.ts` (line 5)

## Definition

```ts
MdastImportVisitor<Mdast.ThematicBreak>
```

<!-- source: component-stepindicator-3.md -->

# StepIndicator

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/step-indicator.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `step` | `number` | ✓ | - |
| `icon` | `LucideIcon` | ✓ | - |
| `titleKey` | `string` | ✓ | - |
| `descriptionKey` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StepIndicator_36a41b62["StepIndicator"]
    class component_StepIndicator_36a41b62 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Icon`
- USES_HOOK → `useTranslation`

<!-- source: interface-visibilityfilterconfig.md -->

# VisibilityFilterConfig

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/generators/versioning/visibility-filter.ts` (line 10)

## Properties

| Property | Type |
|---|---|
| `showPrivate` | `boolean` |
| `showProtected` | `boolean` |
| `showInternal` | `boolean` |
| `showAlpha` | `boolean` |
| `showBeta` | `boolean` |
| `showDeprecated` | `boolean` |
| `showExperimental` | `boolean` |
| `customFilter` | `(entity: Entity) => boolean` |

<!-- source: component-audiencespage.md -->

# AudiencesPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/audiences/page.tsx` (line 16)

## Diagram

```mermaid
graph TD
    component_AudiencesPage_3ab997a["AudiencesPage"]
    class component_AudiencesPage_3ab997a rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Button`
- RENDERS → `PlusIcon`
- RENDERS → `UsersIcon`
- RENDERS → `PencilIcon`
- RENDERS → `TrashIcon`
- RENDERS → `AnimatePresence`
- RENDERS → `XMarkIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useAudiences`
- USES_HOOK → `useState`

<!-- source: interface-environment-4.md -->

# Environment

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/RequestPanel.ts` (line 29)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `variables` | `Record<string, string>` |

<!-- source: api-endpoint-getreview.md -->

# getReview

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 206)

## Endpoint

`GET /doc-versions/:projectId/:versionId/review`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: constant-mdxeditor.md -->

# MDXEditor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/MDXEditor.tsx` (line 407)

The MDXEditor React component.

<!-- source: component-strikethroughsupsubtoggles.md -->

# StrikeThroughSupSubToggles

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/BoldItalicUnderlineToggles.tsx` (line 89)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `options` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StrikeThroughSupSubToggles_77078597["StrikeThroughSupSubToggles"]
    class component_StrikeThroughSupSubToggles_77078597 rootComponent
```

## Relationships

- RENDERS → `FormatButton`
- USES_HOOK → `useTranslation`

<!-- source: interface-workflowactiondocumentation.md -->

# WorkflowActionDocumentation

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-documentation.interface.ts` (line 148)

Documentation for a workflow action/transition

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `label` | `string` |
| `description` | `string` |
| `targetState` | `string` |
| `requiresModal` | `boolean` |
| `triggers` | `UIInteraction[]` |
| `type` | `'primary' | 'secondary' | 'destructive'` |

<!-- source: component-audittrailpage.md -->

# AuditTrailPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/audit/page.tsx` (line 7)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AuditTrailPage_62503ee7["AuditTrailPage"]
    class component_AuditTrailPage_62503ee7 rootComponent
```

## Relationships

- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useEffect`

<!-- source: interface-evidencedclaim.md -->

# EvidencedClaim

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-10.types.ts` (line 72)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `claim` | `string` |
| `entityIds` | `string[]` |
| `confidence` | `number` |

<!-- source: api-endpoint-getrevision.md -->

# getRevision

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 518)

## Endpoint

`GET /documents/:id/revisions/:revisionId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `revisionId` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: constant-mega-file-default-phases.md -->

# MEGA_FILE_DEFAULT_PHASES

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/mega-file.types.ts` (line 49)

Default mega-file extraction strategy

For a 12,560 line Angular component:
Phase 1: Extract class signature and all method names (overview)
Phase 2: Extract all state-related code (stage/status handling)
Phase 3: Extract all validation code
Phase 4: Extract all user-action handlers
Phase 5: Extract DevExtreme configurations from template

## Definition

```ts
MegaFilePhase[]
```

<!-- source: component-table.md -->

# Table

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 221)

## Diagram

```mermaid
graph TD
    component_Table_2d742c4["Table"]
    class component_Table_2d742c4 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `DiffSourceToggleWrapper`
- RENDERS → `UndoRedo`

<!-- source: interface-workflowdocgenerationoptions.md -->

# WorkflowDocGenerationOptions

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-documentation.interface.ts` (line 191)

Options for workflow documentation generation

## Properties

| Property | Type |
|---|---|
| `includeDiagrams` | `boolean` |
| `includeScreenshots` | `boolean` |
| `includeInteractions` | `boolean` |
| `format` | `'mdx' | 'markdown' | 'json'` |
| `screenshotBaseUrl` | `string` |
| `groupByCategory` | `boolean` |

<!-- source: component-authlayout.md -->

# AuthLayout

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/(auth)/layout.tsx` (line 7)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_AuthLayout_22549ad3["AuthLayout"]
    class component_AuthLayout_22549ad3 rootComponent
```

<!-- source: interface-executionbatch.md -->

# ExecutionBatch

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-08.types.ts` (line 48)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `sessionIds` | `string[]` |
| `order` | `number` |

<!-- source: api-endpoint-getrevisions.md -->

# getRevisions

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 496)

## Endpoint

`GET /documents/:id/revisions`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `limit` | query | `number` | - |
| `offset` | query | `number` | - |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: constant-mermaidcodeeditordescriptor.md -->

# MermaidCodeEditorDescriptor

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/mermaid/index.tsx` (line 68)

Code block editor descriptor for Mermaid diagrams
This provides read-only visualization of Mermaid diagrams

## Definition

```ts
CodeBlockEditorDescriptor
```

<!-- source: component-tableeditor.md -->

# TableEditor

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/table/TableEditor.tsx` (line 76)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `mdastNode` | `any` | ✓ | - |
| `parentEditor` | `any` | ✓ | - |
| `lexicalTable` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TableEditor_6c312391["TableEditor"]
    class component_TableEditor_6c312391 rootComponent
```

## Relationships

- RENDERS → `ColumnEditor`
- RENDERS → `CellElement`
- RENDERS → `RowEditor`
- RENDERS → `Cell`
- USES_HOOK → `useState`
- USES_HOOK → `useCellValues`
- USES_HOOK → `useMemo`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`
- USES_HOOK → `useTranslation`

<!-- source: interface-workflowdocgenerationresult.md -->

# WorkflowDocGenerationResult

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-documentation.interface.ts` (line 231)

Result of workflow documentation generation

## Properties

| Property | Type |
|---|---|
| `documentation` | `WorkflowDocumentation` |
| `content` | `string` |
| `outputPath` | `string` |
| `warnings` | `string[]` |

<!-- source: component-backbutton.md -->

# BackButton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/BackButton.tsx` (line 9)

## Diagram

```mermaid
graph TD
    component_BackButton_24bc4112["BackButton"]
    class component_BackButton_24bc4112 rootComponent
```

## Relationships

- RENDERS → `ChevronRightIcon`
- USES_HOOK → `useRouter`
- USES_HOOK → `useParams`
- USES_HOOK → `usePublicProjectContext`
- USES_HOOK → `useLanguageContext`

<!-- source: interface-exportlexicaltreeoptions.md -->

# ExportLexicalTreeOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/exportMarkdownFromLexical.ts` (line 101)

## Properties

| Property | Type |
|---|---|
| `root` | `LexicalRootNode` |
| `visitors` | `LexicalVisitor[]` |
| `jsxComponentDescriptors` | `JsxComponentDescriptor[]` |
| `jsxIsAvailable` | `boolean` |
| `addImportStatements` | `boolean` |

<!-- source: api-endpoint-getscreenshot.md -->

# getScreenshot

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/screenshot/screenshot.controller.ts` (line 78)

## Endpoint

`GET /screenshots/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ScreenshotController` (MODULE_DECLARES)

<!-- source: constant-meta-category-ids.md -->

# META_CATEGORY_IDS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 74)

<!-- source: component-tableofcontents-2.md -->

# TableOfContents

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/table-of-contents.tsx` (line 79)

## Diagram

```mermaid
graph TD
    component_TableOfContents_77233c23["TableOfContents"]
    class component_TableOfContents_77233c23 rootComponent
```

## Relationships

- RENDERS → `TableOfContentsSidebar`
- RENDERS → `MDXEditor`
- USES_HOOK → `useState`

<!-- source: interface-workflowdocumentation-2.md -->

# WorkflowDocumentation

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-documentation.interface.ts` (line 18)

Complete workflow documentation for a component

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `component` | `string` |
| `componentPath` | `string` |
| `description` | `string` |
| `stateMachines` | `StateMachine[]` |
| `states` | `WorkflowStateDocumentation[]` |
| `diagram` | `string` |
| `metadata` | `{
    /**
     * When documentation was generated
     */
    generatedAt: Date;

    /**
     * Total number of screenshots
     */
    screenshotCount: number;

    /**
     * Total number of interactive elements
     */
    interactionCount: number;
  }` |

<!-- source: component-batchfileprocessor.md -->

# BatchFileProcessor

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/BatchFileProcessor.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onComplete` | `Function` | - | - |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_BatchFileProcessor_67991fc["BatchFileProcessor"]
    class component_BatchFileProcessor_67991fc rootComponent
```

## Relationships

- RENDERS → `StatusIcon`
- USES_HOOK → `useState`
- USES_HOOK → `useParser`
- USES_HOOK → `useCallback`

<!-- source: interface-exportmarkdownfromlexicaloptions.md -->

# ExportMarkdownFromLexicalOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/exportMarkdownFromLexical.ts` (line 392)

## Properties

| Property | Type |
|---|---|
| `visitors` | `LexicalVisitor[]` |
| `toMarkdownExtensions` | `ToMarkdownExtension[]` |
| `toMarkdownOptions` | `ToMarkdownOptions` |

<!-- source: api-endpoint-getscreenshotplaceholders.md -->

# getScreenshotPlaceholders

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 1125)

## Endpoint

`GET /public/p/:slugWithId/screenshots`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |
| `documentId` | query | `string` | - |
| `status` | query | `string` | - |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-meta-doc-ids.md -->

# META_DOC_IDS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 83)

<!-- source: component-tableofcontents-3.md -->

# TableOfContents

**Kind:** Component

**Source:** `atloria-monorepo/packages/ui-react/src/components/TableOfContents.tsx` (line 54)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `entries` | `TocEntry[]` | ✓ | - |
| `onNavigate` | `Function` | - | - |
| `title` | `string` | - | "On This Page" |
| `className` | `string` | - | "" |
| `scrollOffset` | `number` | - | 80 |

## Diagram

```mermaid
graph TD
    component_TableOfContents_1fddc5c5["TableOfContents"]
    class component_TableOfContents_1fddc5c5 rootComponent
```

## Relationships

- RENDERS → `ChevronDown`
- RENDERS → `ChevronRight`
- RENDERS → `X`
- RENDERS → `List`
- USES_HOOK → `useState`
- USES_HOOK → `useMemo`
- USES_HOOK → `useActiveSection`
- USES_HOOK → `useCallback`

<!-- source: interface-workflowenum.md -->

# WorkflowEnum

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 78)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `filePath` | `string` |
| `lineNumber` | `number` |
| `values` | `EnumValue[]` |
| `usageLocations` | `string[]` |

<!-- source: component-billingsettingspage.md -->

# BillingSettingsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/billing/page.tsx` (line 59)

## Diagram

```mermaid
graph TD
    component_BillingSettingsPage_419d7571["BillingSettingsPage"]
    class component_BillingSettingsPage_419d7571 rootComponent
```

## Relationships

- RENDERS → `CreditCardIcon`
- RENDERS → `CheckIcon`
- RENDERS → `ArrowTopRightOnSquareIcon`
- RENDERS → `BoltIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useSearchParams`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-expressionvalue.md -->

# ExpressionValue

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/index.ts` (line 114)

## Properties

| Property | Type |
|---|---|
| `type` | `'expression'` |
| `value` | `string` |

<!-- source: api-endpoint-getscreenshots.md -->

# getScreenshots

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 246)

## Endpoint

`GET /doc-versions/:projectId/:versionId/screenshots`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: constant-mui-component-patterns.md -->

# MUI_COMPONENT_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/material-ui.patterns.ts` (line 11)

Material-UI (MUI) Pattern Detection

Patterns for detecting MUI components, theming, and styling.

<!-- source: component-termsofservice.md -->

# TermsOfService

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/pages/TermsOfService.tsx` (line 11)

## Diagram

```mermaid
graph TD
    component_TermsOfService_4f0b681f["TermsOfService"]
    class component_TermsOfService_4f0b681f rootComponent
```

## Relationships

- RENDERS → `SEO`
- USES_HOOK → `useTranslation`

<!-- source: interface-workflowsequence.md -->

# WorkflowSequence

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/utils/screenshot-instruction-generator.ts` (line 101)

Workflow sequence of screenshots

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `stateMachine` | `string` |
| `description` | `string` |
| `states` | `string[]` |
| `instructions` | `ScreenshotInstruction[]` |
| `estimatedMinutes` | `number` |

<!-- source: component-bitbucketicon-2.md -->

# BitbucketIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/integrations/page.tsx` (line 23)

## Diagram

```mermaid
graph TD
    component_BitbucketIcon_2bcd6354["BitbucketIcon"]
    class component_BitbucketIcon_2bcd6354 rootComponent
```

<!-- source: interface-extractedselectors.md -->

# ExtractedSelectors

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 63)

Collection of extracted selectors by type

## Properties

| Property | Type |
|---|---|
| `buttons` | `SelectorInfo[]` |
| `inputs` | `SelectorInfo[]` |
| `links` | `SelectorInfo[]` |
| `modals` | `SelectorInfo[]` |
| `tables` | `SelectorInfo[]` |
| `forms` | `SelectorInfo[]` |

<!-- source: api-endpoint-getscrollhistogram.md -->

# getScrollHistogram

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 156)

## Endpoint

`GET /analytics/:projectId/scroll-histogram`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: constant-mui-data-grid-patterns.md -->

# MUI_DATA_GRID_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/material-ui.patterns.ts` (line 227)

<!-- source: component-testimonialcard-2.md -->

# TestimonialCard

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/testimonial-card.tsx` (line 21)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `quoteKey` | `string` | ✓ | - |
| `authorNameKey` | `string` | ✓ | - |
| `authorRoleKey` | `string` | - | - |
| `avatarSrc` | `string` | - | - |
| `rating` | `number` | - | - |

## Diagram

```mermaid
graph TD
    component_TestimonialCard_17264b5a["TestimonialCard"]
    class component_TestimonialCard_17264b5a rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Star`
- USES_HOOK → `useTranslation`

<!-- source: interface-workflowsignals.md -->

# WorkflowSignals

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 39)

Workflow Signals - Raw entities and relationships for AI analysis
Uses reverse-engineering approach: AI determines what it needs from the data

## Properties

| Property | Type |
|---|---|
| `entities` | `CodeEntity[]` |
| `relationships` | `CodeRelationship[]` |
| `projectStats` | `ProjectStats` |

<!-- source: component-boardcard.md -->

# BoardCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardCard.tsx` (line 26)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `card` | `BoardCardData` | ✓ | - |
| `asOverlay` | `boolean` | - | false |
| `onCardClick` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_BoardCard_1a154160["BoardCard"]
    class component_BoardCard_1a154160 rootComponent
```

## Relationships

- RENDERS → `ChatBubbleLeftEllipsisIcon`
- USES_HOOK → `useSortable`

<!-- source: interface-extractedtroubleshootingsection.md -->

# ExtractedTroubleshootingSection

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 132)

## Properties

| Property | Type |
|---|---|
| `heading` | `string` |
| `content` | `string` |
| `sourceTitle` | `string` |
| `sourceSlug` | `string` |

<!-- source: api-endpoint-getsearchindexbyurl.md -->

# getSearchIndexByUrl

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 273)

## Endpoint

`GET /public/p/:slugWithId/search-index.json`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: constant-mui-detection-config.md -->

# MUI_DETECTION_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/material-ui.patterns.ts` (line 276)

## Definition

```ts
MuiDetectionConfig
```

<!-- source: component-thematicbreaks.md -->

# ThematicBreaks

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/basics.tsx` (line 177)

## Diagram

```mermaid
graph TD
    component_ThematicBreaks_4d52f727["ThematicBreaks"]
    class component_ThematicBreaks_4d52f727 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: interface-workflowstage.md -->

# WorkflowStage

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 147)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `stageValue` | `number` |
| `entity` | `string` |
| `routes` | `string[]` |
| `components` | `string[]` |
| `uiElements` | `string[]` |

<!-- source: component-boardcolumn.md -->

# BoardColumn

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardColumn.tsx` (line 18)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `column` | `BoardColumnData` | ✓ | - |
| `onAddCard` | `Function` | - | - |
| `onEditColumn` | `Function` | - | - |
| `onCardClick` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_BoardColumn_4c47b60["BoardColumn"]
    class component_BoardColumn_4c47b60 rootComponent
```

## Relationships

- RENDERS → `EllipsisHorizontalIcon`
- RENDERS → `SortableContext`
- RENDERS → `BoardCard`
- RENDERS → `PlusIcon`
- USES_HOOK → `useDroppable`

<!-- source: interface-failedupload.md -->

# FailedUpload

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 218)

Failed upload record

## Properties

| Property | Type |
|---|---|
| `type` | `'category' | 'document' | 'screenshot'` |
| `id` | `string` |
| `title` | `string` |
| `error` | `string` |
| `retryCount` | `number` |

<!-- source: api-endpoint-getsettings.md -->

# getSettings

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/organization/organization.controller.ts` (line 140)

## Endpoint

`GET /organizations/:id/settings`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `OrganizationController` (MODULE_DECLARES)

<!-- source: constant-mui-hooks-patterns.md -->

# MUI_HOOKS_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/material-ui.patterns.ts` (line 213)

<!-- source: component-themetoggle-2.md -->

# ThemeToggle

**Kind:** Component

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/theme-toggle.tsx` (line 31)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `defaultTheme` | `ThemeMode` | - | "dark" |
| `primaryColor` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_ThemeToggle_7a27254b["ThemeToggle"]
    class component_ThemeToggle_7a27254b rootComponent
```

## Relationships

- RENDERS → `Icon`
- USES_HOOK → `useState`

<!-- source: interface-workflowstatedocumentation.md -->

# WorkflowStateDocumentation

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-documentation.interface.ts` (line 86)

Documentation for a specific workflow state

## Properties

| Property | Type |
|---|---|
| `state` | `string` |
| `title` | `string` |
| `description` | `string` |
| `screenshots` | `EnhancedScreenshotMetadata[]` |
| `actions` | `WorkflowActionDocumentation[]` |
| `isTerminal` | `boolean` |
| `requiresApproval` | `boolean` |
| `flags` | `{
    /**
     * State is the initial/starting state
     */
    isInitial?: boolean;

    /**
     * State has approval sub-states
     */
    hasApproval?: boolean;

    /**
     * State has modal interactions
     */
    hasModals?: boolean;
  }` |

<!-- source: component-boardfiltersbutton.md -->

# BoardFiltersButton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardFilters.tsx` (line 170)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `filters` | `BoardFiltersState` | ✓ | - |
| `onChange` | `Function` | ✓ | - |
| `options` | `ReturnType` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_BoardFiltersButton_6a5627ae["BoardFiltersButton"]
    class component_BoardFiltersButton_6a5627ae rootComponent
```

## Relationships

- RENDERS → `FunnelIcon`
- RENDERS → `FilterPopover`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`

<!-- source: interface-fallbackoption.md -->

# FallbackOption

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/toolbar.tsx` (line 262)

## Properties

| Property | Type |
|---|---|
| `fallback` | `() => React.ReactNode` |

<!-- source: api-endpoint-getsettings-2.md -->

# getSettings

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 269)

## Endpoint

`GET /projects/:id/settings`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: constant-mui-props-patterns.md -->

# MUI_PROPS_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/material-ui.patterns.ts` (line 131)

<!-- source: component-undoredo.md -->

# UndoRedo

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/UndoRedo.tsx` (line 13)

## Diagram

```mermaid
graph TD
    component_UndoRedo_6ea7afb9["UndoRedo"]
    class component_UndoRedo_6ea7afb9 rootComponent
```

## Relationships

- RENDERS → `MultipleChoiceToggleGroup`
- USES_HOOK → `useCellValues`
- USES_HOOK → `useState`
- USES_HOOK → `useTranslation`
- USES_HOOK → `useEffect`

<!-- source: interface-workflowtransition.md -->

# WorkflowTransition

**Kind:** Interface

**Source:** `atloria-monorepo/libs/parser-core/src/interfaces/workflow-signals.interface.ts` (line 158)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `action` | `string` |
| `fromStage` | `string` |
| `toStage` | `string` |
| `method` | `string` |
| `service` | `string` |
| `endpoint` | `string` |
| `httpMethod` | `string` |
| `uiTrigger` | `string` |
| `permissions` | `string[]` |
| `isBackward` | `boolean` |
| `isTerminal` | `boolean` |

<!-- source: component-boardloadingskeleton.md -->

# BoardLoadingSkeleton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardLoadingSkeleton.tsx` (line 3)

## Diagram

```mermaid
graph TD
    component_BoardLoadingSkeleton_73832c5c["BoardLoadingSkeleton"]
    class component_BoardLoadingSkeleton_73832c5c rootComponent
```

<!-- source: interface-featurearea.md -->

# FeatureArea

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-05.types.ts` (line 57)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `features` | `string[]` |
| `priority` | `number` |

<!-- source: api-endpoint-getsnapshot.md -->

# getSnapshot

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 142)

## Endpoint

`GET /technical-docs/:projectId/snapshot`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: constant-mui-theming-patterns.md -->

# MUI_THEMING_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/material-ui.patterns.ts` (line 177)

<!-- source: component-withindialog.md -->

# WithinDialog

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/within-dialog.tsx` (line 13)

## Diagram

```mermaid
graph TD
    component_WithinDialog_58f15a0e["WithinDialog"]
    class component_WithinDialog_58f15a0e rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `BoldItalicUnderlineToggles`
- RENDERS → `BlockTypeSelect`
- RENDERS → `CreateLink`
- USES_HOOK → `useRef`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`

<!-- source: component-boardpage.md -->

# BoardPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/boards/[boardId]/page.tsx` (line 53)

## Diagram

```mermaid
graph TD
    component_BoardPage_4443a1f8["BoardPage"]
    class component_BoardPage_4443a1f8 rootComponent
```

## Relationships

- RENDERS → `BoardsToastProvider`
- RENDERS → `BoardPageContent`

<!-- source: interface-featureevidence.md -->

# FeatureEvidence

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-03.types.ts` (line 54)

## Properties

| Property | Type |
|---|---|
| `entityId` | `string` |
| `type` | `'route' | 'controller' | 'component' | 'service' | 'model'` |
| `snippet` | `string` |
| `reasoning` | `string` |

<!-- source: api-endpoint-getsourcebreakdown.md -->

# getSourceBreakdown

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 96)

## Endpoint

`GET /analytics/:projectId/sources`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: constant-mutechange.md -->

# muteChange$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 374)

<!-- source: component-withnestededitors.md -->

# WithNestedEditors

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/link-dialog.tsx` (line 85)

## Diagram

```mermaid
graph TD
    component_WithNestedEditors_3060a27d["WithNestedEditors"]
    class component_WithNestedEditors_3060a27d rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: component-boardpicker.md -->

# BoardPicker

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardPicker.tsx` (line 50)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `issueId` | `string` | ✓ | - |
| `issueStatus` | `string` | ✓ | - |
| `bulkIssueIds` | `string[]` | - | - |
| `open` | `boolean` | ✓ | - |
| `anchorRect` | `DOMRect | null` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `onChanged` | `Function` | - | - |
| `onCreateBoard` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_BoardPicker_68dc6460["BoardPicker"]
    class component_BoardPicker_68dc6460 rootComponent
```

## Relationships

- RENDERS → `MagnifyingGlassIcon`
- RENDERS → `CheckIcon`
- RENDERS → `PlusIcon`
- RENDERS → `ViewColumnsIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useBoardsToast`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-featureiconprops-2.md -->

# FeatureIconProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/feature-icon.tsx` (line 11)

## Properties

| Property | Type |
|---|---|
| `icon` | `LucideIcon` |
| `size` | `number` |
| `className` | `string` |

<!-- source: api-endpoint-getstatistics.md -->

# getStatistics

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/graph.controller.ts` (line 145)

## Endpoint

`GET /knowledge-graph/statistics`

## Referenced By

- `GraphController` (MODULE_DECLARES)

<!-- source: constant-nested-editor-updated-command.md -->

# NESTED_EDITOR_UPDATED_COMMAND

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 115)

<!-- source: component-withoutlinktitlefield.md -->

# WithoutLinkTitleField

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/link-dialog.tsx` (line 32)

## Diagram

```mermaid
graph TD
    component_WithoutLinkTitleField_5a7a0808["WithoutLinkTitleField"]
    class component_WithoutLinkTitleField_5a7a0808 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`

<!-- source: component-boardsettingsdialog.md -->

# BoardSettingsDialog

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardSettingsDialog.tsx` (line 47)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `open` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `board` | `BoardLite | null` | ✓ | - |
| `onChanged` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_BoardSettingsDialog_3821d8c0["BoardSettingsDialog"]
    class component_BoardSettingsDialog_3821d8c0 rootComponent
```

## Relationships

- RENDERS → `Modal`
- RENDERS → `ColumnsList`
- RENDERS → `PlusIcon`
- RENDERS → `ColumnEditor`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useBoardsToast`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-featureinput.md -->

# FeatureInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-03.types.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `chunks` | `Chunk[]` |

<!-- source: api-endpoint-getstats.md -->

# getStats

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/dashboard/dashboard.controller.ts` (line 17)

## Endpoint

`GET /dashboard/stats`

## Referenced By

- `DashboardController` (MODULE_DECLARES)

<!-- source: constant-nestededitorchildren.md -->

# nestedEditorChildren$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 770)

React Components registered to be rendered inside `LexicalNestedComposer`. Useful if you're using lexical editor plugins that are wrapped as react components.

<!-- source: component-youtube.md -->

# Youtube

**Kind:** Component

**Source:** `atloria-monorepo/packages/editor/src/examples/directives.tsx` (line 91)

## Diagram

```mermaid
graph TD
    component_Youtube_37711bc6["Youtube"]
    class component_Youtube_37711bc6 rootComponent
```

## Relationships

- RENDERS → `MDXEditor`
- RENDERS → `YouTubeButton`

<!-- source: component-boardsindexpage.md -->

# BoardsIndexPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/boards/page.tsx` (line 62)

## Diagram

```mermaid
graph TD
    component_BoardsIndexPage_3ab59701["BoardsIndexPage"]
    class component_BoardsIndexPage_3ab59701 rootComponent
```

## Relationships

- RENDERS → `BoardsToastProvider`
- RENDERS → `BoardsIndexContent`

<!-- source: interface-featureresult.md -->

# FeatureResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-03.types.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `features` | `UserFeature[]` |
| `chunkFeatureMap` | `Record<string, string[]>` |
| `stats` | `{
    totalFeatures: number;
    totalActions: number;
    avgConfidence: number;
  }` |

<!-- source: api-endpoint-getstats-2.md -->

# getStats

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 138)

## Endpoint

`GET /documents/:id/stats`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: constant-nestededitorscontext.md -->

# NestedEditorsContext

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/NestedLexicalEditor.tsx` (line 89)

<!-- source: component-boardstoastprovider.md -->

# BoardsToastProvider

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/Toast.tsx` (line 43)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_BoardsToastProvider_74b88104["BoardsToastProvider"]
    class component_BoardsToastProvider_74b88104 rootComponent
```

## Relationships

- RENDERS → `ToastContext-Provider`
- RENDERS → `ToastView`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`

<!-- source: interface-featureshorizontalflowprops-2.md -->

# FeaturesHorizontalFlowProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/features/features-horizontal-flow.tsx` (line 19)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `features` | `Feature[]` |

<!-- source: api-endpoint-getstats-3.md -->

# getStats

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/issues.controller.ts` (line 56)

## Endpoint

`GET /projects/:projectId/issues/stats`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `IssuesController` (MODULE_DECLARES)

<!-- source: constant-never-truncate-patterns.md -->

# NEVER_TRUNCATE_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 434)

<!-- source: component-boardview.md -->

# BoardView

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/BoardView.tsx` (line 54)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `boardId` | `string` | ✓ | - |
| `onEditColumn` | `Function` | - | - |
| `onAddColumn` | `Function` | - | - |
| `refreshKey` | `number` | - | 0 |
| `filters` | `BoardFiltersState` | - | unknown |
| `onBoardLoaded` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_BoardView_5699fb80["BoardView"]
    class component_BoardView_5699fb80 rootComponent
```

## Relationships

- RENDERS → `BoardLoadingSkeleton`
- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `DndContext`
- RENDERS → `BoardColumn`
- RENDERS → `PlusIcon`
- RENDERS → `DragOverlay`
- RENDERS → `BoardCard`
- RENDERS → `IssueSidePanel`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`
- USES_HOOK → `useSensors`
- USES_HOOK → `useSensor`

<!-- source: interface-featuresinteractivetabsprops-2.md -->

# FeaturesInteractiveTabsProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/features/features-interactive-tabs.tsx` (line 23)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `tabs` | `Tab[]` |

<!-- source: api-endpoint-getstats-4.md -->

# getStats

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 302)

## Endpoint

`GET /projects/:id/stats`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: constant-onblur.md -->

# onBlur$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 485)

Emits when the editor loses focus

<!-- source: component-brandedheader.md -->

# BrandedHeader

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/BrandedHeader.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `slugId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_BrandedHeader_6c50e2f6["BrandedHeader"]
    class component_BrandedHeader_6c50e2f6 rootComponent
```

## Relationships

- RENDERS → `Link`
- USES_HOOK → `useBranding`

<!-- source: interface-fileimageparameters.md -->

# FileImageParameters

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 63)

## Properties

| Property | Type |
|---|---|
| `file` | `File` |

<!-- source: api-endpoint-getstatus.md -->

# getStatus

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/agent/agent.controller.ts` (line 20)

Health check / session stats for monitoring.

## Endpoint

`GET /agent/status`

## Referenced By

- `AgentController` (MODULE_DECLARES)

<!-- source: constant-onclicklinkcallback.md -->

# onClickLinkCallback$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 350)

<!-- source: component-brandingprovider.md -->

# BrandingProvider

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/BrandingContext.tsx` (line 59)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `slugId` | `string` | ✓ | - |
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_BrandingProvider_369ca96a["BrandingProvider"]
    class component_BrandingProvider_369ca96a rootComponent
```

## Relationships

- RENDERS → `BrandingContext-Provider`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-fixeddoctemplate.md -->

# FixedDocTemplate

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 225)

Type for a fixed doc template.
The `referenceNeeds` field tells the KnowledgeCollector what snippet types to prioritize.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `categoryId` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `order` | `number` |
| `referenceNeeds` | `SnippetType[]` |
| `promptGuidance` | `string` |
| `maxTokens` | `number` |
| `subcategory` | `string` |

<!-- source: api-endpoint-getstatus-2.md -->

# getStatus

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/bitbucket/bitbucket.controller.ts` (line 70)

## Endpoint

`GET /bitbucket/status`

## Referenced By

- `BitbucketController` (MODULE_DECLARES)

<!-- source: constant-onreadonlyclicklinkcallback.md -->

# onReadOnlyClickLinkCallback$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 353)

<!-- source: component-brandingsettingspage.md -->

# BrandingSettingsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/branding/page.tsx` (line 119)

## Diagram

```mermaid
graph TD
    component_BrandingSettingsPage_687aa0f3["BrandingSettingsPage"]
    class component_BrandingSettingsPage_687aa0f3 rootComponent
```

## Relationships

- RENDERS → `PaintBrushIcon`
- RENDERS → `ArrowTopRightOnSquareIcon`
- RENDERS → `PhotoIcon`
- RENDERS → `SwatchIcon`
- RENDERS → `GlobeAltIcon`
- RENDERS → `ArrowUpTrayIcon`
- RENDERS → `SparklesIcon`
- RENDERS → `CheckIcon`
- RENDERS → `ContrastWarning`
- RENDERS → `DomainTab`
- RENDERS → `ComputerDesktopIcon`
- RENDERS → `DevicePhoneMobileIcon`
- RENDERS → `PreviewPane`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`
- USES_HOOK → `useMemo`

<!-- source: interface-flaskdetectionconfig.md -->

# FlaskDetectionConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/flask.patterns.ts` (line 240)

## Properties

| Property | Type |
|---|---|
| `name` | `'flask'` |
| `filePatterns` | `string[]` |
| `identifiers` | `RegExp[]` |
| `configFiles` | `string[]` |

<!-- source: api-endpoint-getstatus-3.md -->

# getStatus

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/github/github.controller.ts` (line 81)

Check GitHub connection status

## Endpoint

`GET /github/status`

## Referenced By

- `GitHubController` (MODULE_DECLARES)

<!-- source: constant-onwindowchange.md -->

# onWindowChange$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 85)

Emits when the window is resized.

<!-- source: component-breadcrumb.md -->

# Breadcrumb

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 180)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Breadcrumb_61456cb4["Breadcrumb"]
    class component_Breadcrumb_61456cb4 rootComponent
```

<!-- source: interface-flatcategory.md -->

# FlatCategory

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 160)

Flat category entry (for quick lookups)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `slug` | `string` |
| `level` | `number` |
| `parentId` | `string | null` |
| `path` | `string` |

<!-- source: api-endpoint-getstatus-4.md -->

# getStatus

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/gitlab/gitlab.controller.ts` (line 81)

Check GitLab connection status

## Endpoint

`GET /gitlab/status`

## Referenced By

- `GitLabController` (MODULE_DECLARES)

<!-- source: constant-open-link-dialog.md -->

# OPEN_LINK_DIALOG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/LinkDialog.tsx` (line 27)

## Definition

```ts
LexicalCommand<undefined>
```

<!-- source: component-breadcrumbs.md -->

# Breadcrumbs

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/Breadcrumbs.tsx` (line 22)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `items` | `BreadcrumbItem[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Breadcrumbs_3e3fee6a["Breadcrumbs"]
    class component_Breadcrumbs_3e3fee6a rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `ChevronRightIcon`
- USES_HOOK → `useLanguageContext`

<!-- source: interface-fontconfig.md -->

# FontConfig

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/fonts.ts` (line 11)

Dynamic Font Loading

Loads Google Fonts at runtime based on site configuration.
AI picks fonts matching the brand voice during assembly.

Fonts are loaded via the Google Fonts CSS API with display=swap
for optimal loading performance (no FOIT).

## Properties

| Property | Type |
|---|---|
| `heading` | `string` |
| `body` | `string` |
| `mono` | `string` |
| `weights` | `number[]` |

<!-- source: api-endpoint-getstatus-5.md -->

# getStatus

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/parsing/parsing.controller.ts` (line 42)

## Endpoint

`GET /projects/:projectId/parse/:jobId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `jobId` | query | `string` | ✓ |

## Referenced By

- `ParsingController` (MODULE_DECLARES)

<!-- source: constant-openeditimagedialog.md -->

# openEditImageDialog$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 322)

Opens the edit image dialog with the published parameters.

<!-- source: component-breadcrumbs-2.md -->

# Breadcrumbs

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Layout/Breadcrumbs.tsx` (line 28)

## Diagram

```mermaid
graph TD
    component_Breadcrumbs_7e8905e3["Breadcrumbs"]
    class component_Breadcrumbs_7e8905e3 rootComponent
```

## Relationships

- RENDERS → `ChevronRightIcon`
- RENDERS → `Link`
- USES_HOOK → `usePathname`
- USES_HOOK → `useSearchParams`
- USES_HOOK → `useProjectContext`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-fontfamily.md -->

# FontFamily

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 34)

## Properties

| Property | Type |
|---|---|
| `sans` | `string` |
| `serif` | `string` |
| `mono` | `string` |

<!-- source: api-endpoint-getstatus-6.md -->

# getStatus

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 381)

## Endpoint

`GET /technical-docs/:projectId/status`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: constant-openlinkeditdialog.md -->

# openLinkEditDialog$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 300)

An action that opens the link dialog.

<!-- source: component-browsecollectionspage.md -->

# BrowseCollectionsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/browse/page.tsx` (line 15)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_BrowseCollectionsPage_1a6e1de1["BrowseCollectionsPage"]
    class component_BrowseCollectionsPage_1a6e1de1 rootComponent
```

## Relationships

- RENDERS → `CollectionsBrowse`
- USES_HOOK → `useSearchParams`
- USES_HOOK → `useLanguageContext`

<!-- source: interface-fontsize.md -->

# FontSize

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 40)

## Properties

| Property | Type |
|---|---|
| `xs` | `string` |
| `sm` | `string` |
| `base` | `string` |
| `lg` | `string` |
| `xl` | `string` |
| `'2xl'` | `string` |
| `'3xl'` | `string` |
| `'4xl'` | `string` |
| `'5xl'` | `string` |

<!-- source: api-endpoint-getsuggestions.md -->

# getSuggestions

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/search.controller.ts` (line 125)

Get autocomplete suggestions

GET /search/suggestions?q=partial

Query Parameters:
- q (required): Partial search query
- projectId: Filter to specific project (default: all projects in user's organization)
- limit: Max suggestions (default: 5)

## Endpoint

`GET /search/suggestions`

| Parameter | In | Type | Required |
|---|---|---|---|
| `q` | query | `string` | ✓ |
| `projectId` | query | `string` | - |
| `limit` | query | `string` | - |

## Referenced By

- `SearchController` (MODULE_DECLARES)

<!-- source: constant-opennewimagedialog.md -->

# openNewImageDialog$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 314)

Opens the new image dialog.

<!-- source: component-capturedflows.md -->

# CapturedFlows

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/CapturedFlows.tsx` (line 47)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CapturedFlows_1e080fdd["CapturedFlows"]
    class component_CapturedFlows_1e080fdd rootComponent
```

## Relationships

- RENDERS → `Clapperboard`
- RENDERS → `Code2`
- RENDERS → `RefreshCw`
- RENDERS → `Check`
- RENDERS → `Copy`
- RENDERS → `ExternalLink`
- RENDERS → `ListChecks`
- RENDERS → `Route`
- RENDERS → `FileText`
- RENDERS → `Trash2`
- RENDERS → `StepEditor`
- RENDERS → `TourEmbed`
- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-fontweight.md -->

# FontWeight

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 52)

## Properties

| Property | Type |
|---|---|
| `light` | `number` |
| `normal` | `number` |
| `medium` | `number` |
| `semibold` | `number` |
| `bold` | `number` |

<!-- source: api-endpoint-getsupportedlanguages.md -->

# getSupportedLanguages

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/parser/parser.controller.ts` (line 28)

## Endpoint

`GET /parser/languages`

## Referenced By

- `ParserController` (MODULE_DECLARES)

<!-- source: constant-placeholder.md -->

# placeholder$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 154)

<!-- source: component-capturemodal.md -->

# CaptureModal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/enterprise/screenshots/CaptureModal.tsx` (line 17)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `siteUrl` | `string` | ✓ | - |
| `routePath` | `string` | ✓ | - |
| `description` | `string` | - | - |
| `documentId` | `string` | ✓ | - |
| `projectId` | `string` | ✓ | - |
| `versionId` | `string` | ✓ | - |
| `apiClient` | `any` | ✓ | - |
| `onCapture` | `Function` | ✓ | - |
| `onClose` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CaptureModal_7825c8f5["CaptureModal"]
    class component_CaptureModal_7825c8f5 rootComponent
```

## Relationships

- USES_HOOK → `useState`

<!-- source: interface-footerlinkgroup.md -->

# FooterLinkGroup

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/layout/footer.tsx` (line 10)

## Properties

| Property | Type |
|---|---|
| `titleKey` | `string` |
| `links` | `{ labelKey: string; href: string }[]` |

<!-- source: api-endpoint-getthread.md -->

# getThread

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/desk.controller.ts` (line 60)

## Endpoint

`GET /desk/:projectId/threads/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `DeskController` (MODULE_DECLARES)

<!-- source: constant-popovercontent.md -->

# PopoverContent

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/ui/PopoverUtils.tsx` (line 12)

<!-- source: component-categorydocumentlist.md -->

# CategoryDocumentList

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/PublishingSidebar/CategoryDocumentList.tsx` (line 53)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `categories` | `CategoryNode[]` | ✓ | - |
| `selectedDocument` | `string | null` | ✓ | - |
| `onSelectDocument` | `Function` | ✓ | - |
| `onHoverDocument` | `Function` | - | - |
| `loading` | `boolean` | - | false |
| `lang` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_CategoryDocumentList_61ceec8a["CategoryDocumentList"]
    class component_CategoryDocumentList_61ceec8a rootComponent
```

## Relationships

- RENDERS → `FileText`
- RENDERS → `ChevronDown`
- RENDERS → `ChevronRight`
- RENDERS → `CategoryIcon`
- RENDERS → `FolderOpen`
- RENDERS → `Folder`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useMemo`
- USES_HOOK → `useEffect`

<!-- source: interface-formcapturespec.md -->

# FormCaptureSpec

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/screenshot-spec.types.ts` (line 122)

Form state capture specification

## Properties

| Property | Type |
|---|---|
| `formState` | `'empty' | 'validation-errors' | 'filled' | 'partial'` |
| `fieldsToFill` | `{ selector: string; value: string }[]` |
| `submitSelector` | `string` |

<!-- source: api-endpoint-getticket.md -->

# getTicket

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/public-issues.controller.ts` (line 19)

## Endpoint

`GET /public/issues/:projectSlugId/:ticketNumber`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectSlugId` | query | `string` | ✓ |
| `ticketNumber` | query | `number` | ✓ |

## Referenced By

- `PublicIssuesController` (MODULE_DECLARES)

<!-- source: constant-quoteplugin.md -->

# quotePlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/quote/index.ts` (line 11)

A plugin that adds support for block quotes to the editor.

<!-- source: component-categoryicon.md -->

# CategoryIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Categories/CategoryIcon.tsx` (line 9)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `icon` | `string | null | undefined` | ✓ | - |
| `fallback` | `unknown` | - | - |
| `className` | `string` | - | "w-4 h-4" |
| `emojiClassName` | `string` | - | "text-base" |

## Diagram

```mermaid
graph TD
    component_CategoryIcon_37f8cc2b["CategoryIcon"]
    class component_CategoryIcon_37f8cc2b rootComponent
```

## Relationships

- RENDERS → `LucideComponent`

<!-- source: interface-formdefinition-2.md -->

# FormDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 111)

A form discovered in source code

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `submitMethod` | `string` |
| `fields` | `FormFieldDefinition[]` |
| `route` | `string` |
| `hostComponent` | `string` |
| `sourceFile` | `string` |

<!-- source: api-endpoint-gettopdocuments.md -->

# getTopDocuments

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 52)

## Endpoint

`GET /analytics/:projectId/documents`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: constant-readonly.md -->

# readOnly$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 147)

Holds the readOnly state of the editor.

<!-- source: component-categorymodal.md -->

# CategoryModal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Categories/CategoryModal.tsx` (line 48)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `isOpen` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `onSuccess` | `Function` | ✓ | - |
| `projectId` | `string` | ✓ | - |
| `category` | `Category | null` | - | - |
| `parentId` | `string | null` | - | - |
| `mode` | `unknown | unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CategoryModal_1150262f["CategoryModal"]
    class component_CategoryModal_1150262f rootComponent
```

## Relationships

- RENDERS → `XMarkIcon`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-formfield-2.md -->

# FormField

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/layout/contact-form.tsx` (line 16)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `'text' | 'email' | 'tel' | 'textarea' | 'select'` |
| `labelKey` | `string` |
| `placeholderKey` | `string` |
| `required` | `boolean` |
| `options` | `{ labelKey: string; value: string }[]` |

<!-- source: api-endpoint-gettopsearchqueries.md -->

# getTopSearchQueries

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 63)

## Endpoint

`GET /analytics/:projectId/search-queries`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: constant-remoterealmplugin.md -->

# remoteRealmPlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/remote/index.tsx` (line 63)

A plugin that allows you to access the editor's realm outside of the editor's component tree.
Requires wrapping your application in the `RemoteMDXEditorRealmProvider` component.

<!-- source: component-categorytreesidebar.md -->

# CategoryTreeSidebar

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Categories/CategoryTreeSidebar.tsx` (line 145)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `selectedCategoryId` | `string | null` | - | - |
| `onSelectCategory` | `Function` | ✓ | - |
| `onCreateCategory` | `Function` | - | - |
| `onEditCategory` | `Function` | - | - |
| `onDeleteCategory` | `Function` | - | - |
| `editMode` | `boolean` | - | false |
| `onReorderCategories` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_CategoryTreeSidebar_40c8abcf["CategoryTreeSidebar"]
    class component_CategoryTreeSidebar_40c8abcf rootComponent
```

## Relationships

- RENDERS → `ErrorState`
- RENDERS → `MagnifyingGlassIcon`
- RENDERS → `XMarkIcon`
- RENDERS → `DocumentTextIcon`
- RENDERS → `DndContext`
- RENDERS → `SortableContext`
- RENDERS → `CategoryNode`
- RENDERS → `PlusIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useSensors`
- USES_HOOK → `useSensor`
- USES_HOOK → `useCallback`
- USES_HOOK → `useMemo`
- USES_HOOK → `useEffect`

<!-- source: interface-formfielddefinition-2.md -->

# FormFieldDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 91)

A form field discovered in source code

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `required` | `boolean` |
| `model` | `string` |
| `validationRules` | `FormValidationRule[]` |
| `selector` | `string` |
| `conditionalOn` | `string` |

<!-- source: api-endpoint-gettree.md -->

# getTree

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/category.controller.ts` (line 55)

Get category tree for a project

## Endpoint

`GET /categories/tree/:projectId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `docVersionId` | query | `string | undefined` | ✓ |

## Referenced By

- `CategoryController` (MODULE_DECLARES)

<!-- source: constant-removefrontmatter.md -->

# removeFrontmatter$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/frontmatter/index.ts` (line 61)

Removes the frontmatter node from the markdown document.

<!-- source: component-chatmessage.md -->

# ChatMessage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/ChatMessage.tsx` (line 27)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `message` | `Message` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ChatMessage_2eec20e5["ChatMessage"]
    class component_ChatMessage_2eec20e5 rootComponent
```

## Relationships

- RENDERS → `StreamingIndicator`
- RENDERS → `ReactMarkdown`

<!-- source: interface-formprofile.md -->

# FormProfile

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/site-map.types.ts` (line 41)

## Properties

| Property | Type |
|---|---|
| `selector` | `string` |
| `fieldCount` | `number` |
| `hasSubmitButton` | `boolean` |

<!-- source: api-endpoint-gettree-2.md -->

# getTree

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 461)

## Endpoint

`GET /documents/tree/:projectId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: constant-removelink.md -->

# removeLink$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 290)

A signal that removes the current link.

<!-- source: component-codebasechat.md -->

# CodebaseChat

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/CodebaseChat.tsx` (line 23)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CodebaseChat_2e0d7f59["CodebaseChat"]
    class component_CodebaseChat_2e0d7f59 rootComponent
```

## Relationships

- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-formvalidationrule-2.md -->

# FormValidationRule

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 79)

A validation rule on a form field

## Properties

| Property | Type |
|---|---|
| `type` | `string` |
| `param` | `string` |
| `message` | `string` |

<!-- source: api-endpoint-gettrendingdocs.md -->

# getTrendingDocs

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 145)

## Endpoint

`GET /analytics/:projectId/trending-docs`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: constant-resetbutton.md -->

# resetButton

**Kind:** Constant

**Source:** `atloria-monorepo/packages/ui-core/src/utils/styles.ts` (line 15)

<!-- source: component-codeparser.md -->

# CodeParser

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/CodeParser.tsx` (line 22)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `initialCode` | `string` | - | "" |
| `initialLanguage` | `string` | - | "typescript" |
| `onParseComplete` | `Function` | - | - |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_CodeParser_2086ed1c["CodeParser"]
    class component_CodeParser_2086ed1c rootComponent
```

## Relationships

- RENDERS → `ViewButton`
- RENDERS → `FileUpload`
- RENDERS → `BatchFileProcessor`
- RENDERS → `ParsingResults`
- USES_HOOK → `useState`
- USES_HOOK → `useParser`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-frameworkdetectionconfig.md -->

# FrameworkDetectionConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/framework.types.ts` (line 150)

Framework detection configuration

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `'frontend' | 'backend' | 'fullstack'` |
| `indicatorFiles` | `string[]` |
| `dependencies` | `string[]` |
| `filePatterns` | `RegExp[]` |
| `codePatterns` | `RegExp[]` |
| `priority` | `number` |

<!-- source: api-endpoint-gettriggerconfig.md -->

# getTriggerConfig

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 225)

## Endpoint

`GET /doc-automation/config/:projectId/triggers`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: constant-rooteditor.md -->

# rootEditor$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 123)

Holds a reference to the root Lexical editor instance.

<!-- source: component-codeviewer.md -->

# CodeViewer

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/CodeViewer.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `code` | `string` | ✓ | - |
| `language` | `string` | ✓ | - |
| `symbols` | `Symbol[]` | - | [] |
| `highlightedSymbol` | `Symbol` | - | - |
| `onSymbolClick` | `Function` | - | - |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_CodeViewer_4d8bf3c2["CodeViewer"]
    class component_CodeViewer_4d8bf3c2 rootComponent
```

## Relationships

- RENDERS → `CheckIcon`
- RENDERS → `CopyIcon`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`

<!-- source: interface-frameworkdetectionresult.md -->

# FrameworkDetectionResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/framework.types.ts` (line 127)

Framework detection result with patterns to apply

## Properties

| Property | Type |
|---|---|
| `techStack` | `DetectedTechStack` |
| `patternsToApply` | `string[]` |
| `detectorsToRun` | `string[]` |
| `fileExtensions` | `string[]` |
| `priorityPaths` | `string[]` |

<!-- source: api-endpoint-getuseractivity.md -->

# getUserActivity

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/dashboard/dashboard.controller.ts` (line 38)

## Endpoint

`GET /dashboard/activity`

## Referenced By

- `DashboardController` (MODULE_DECLARES)

<!-- source: constant-rooteditorsubscriptions.md -->

# rootEditorSubscriptions$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 469)

<!-- source: component-collaborationstatusbar.md -->

# CollaborationStatusBar

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/CollaborationStatusBar.tsx` (line 342)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `synced` | `boolean` | ✓ | - |
| `activeUsers` | `CollaborationUser[]` | ✓ | - |
| `connectionStatus` | `ConnectionStatus` | ✓ | - |
| `maxVisibleUsers` | `number` | - | 5 |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_CollaborationStatusBar_20048f2e["CollaborationStatusBar"]
    class component_CollaborationStatusBar_20048f2e rootComponent
```

## Relationships

- RENDERS → `SyncStatusIndicator`
- RENDERS → `UserAvatar`
- RENDERS → `OverflowIndicator`

<!-- source: interface-frontmattereditorprops.md -->

# FrontmatterEditorProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/frontmatter/FrontmatterEditor.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `yaml` | `string` |
| `onChange` | `(yaml: string) => void` |

<!-- source: api-endpoint-getuseraudiences.md -->

# getUserAudiences

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/organization/organization.controller.ts` (line 176)

## Endpoint

`GET /organizations/:id/members/:userId/audiences`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `userId` | query | `string` | ✓ |

## Referenced By

- `OrganizationController` (MODULE_DECLARES)

<!-- source: constant-saveimage.md -->

# saveImage$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 353)

Saves the data from the image dialog

<!-- source: component-collaborativedocumenteditor.md -->

# CollaborativeDocumentEditor

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/CollaborativeDocumentEditor.tsx` (line 277)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `documentId` | `string` | ✓ | - |
| `initialContent` | `string` | - | "" |
| `userId` | `string` | ✓ | - |
| `userName` | `string` | ✓ | - |
| `onChange` | `Function` | - | - |
| `editable` | `boolean` | - | true |
| `serverUrl` | `string` | - | - |
| `className` | `string` | - | "" |
| `showStatusBar` | `boolean` | - | true |
| `showCursors` | `boolean` | - | true |

## Diagram

```mermaid
graph TD
    component_CollaborativeDocumentEditor_61abc9e0["CollaborativeDocumentEditor"]
    class component_CollaborativeDocumentEditor_61abc9e0 rootComponent
```

## Relationships

- RENDERS → `EditorSkeleton`
- RENDERS → `EditorError`
- RENDERS → `CollaborationStatusBar`
- RENDERS → `UserCursors`
- RENDERS → `MDXEditor`
- RENDERS → `KitchenSinkToolbar`
- RENDERS → `Separator`
- RENDERS → `InsertAudienceButton`
- USES_HOOK → `useRef`
- USES_HOOK → `useState`
- USES_HOOK → `useCollaboration`
- USES_HOOK → `useSession`
- USES_HOOK → `useAudiences`
- USES_HOOK → `useMemo`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-generateddocument.md -->

# GeneratedDocument

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-10.types.ts` (line 40)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `content` | `string` |
| `frontmatter` | `DocumentFrontmatter` |
| `sections` | `GeneratedSection[]` |
| `claims` | `EvidencedClaim[]` |
| `screenshotPlaceholders` | `string[]` |
| `metadata` | `{
    groundingScore?: number;       // 0-1, % of entity mentions verified against source code
    ungroundedEntities?: string[]; // entities mentioned but not found in code
  }` |

<!-- source: api-endpoint-getvariants.md -->

# getVariants

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/pme/pme.controller.ts` (line 69)

## Endpoint

`GET /pme/jobs/:jobId/variants`

| Parameter | In | Type | Required |
|---|---|---|---|
| `jobId` | query | `string` | ✓ |

## Referenced By

- `PmeController` (MODULE_DECLARES)

<!-- source: constant-scalein.md -->

# scaleIn

**Kind:** Constant

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/animations.ts` (line 30)

Scale in from slightly smaller

## Definition

```ts
Variants
```

<!-- source: component-collectionsbrowse.md -->

# CollectionsBrowse

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/CollectionsBrowse.tsx` (line 63)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `slugId` | `string` | ✓ | - |
| `audienceSlug` | `string` | - | - |
| `version` | `string` | - | - |
| `lang` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_CollectionsBrowse_1c13d76["CollectionsBrowse"]
    class component_CollectionsBrowse_1c13d76 rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `FolderIcon`
- RENDERS → `ArrowRightIcon`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-generatedsection.md -->

# GeneratedSection

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-10.types.ts` (line 65)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `content` | `string` |
| `order` | `number` |

<!-- source: api-endpoint-getversion.md -->

# getVersion

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 296)

## Endpoint

`GET /documents/:id/versions/:version`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `version` | query | `number` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: constant-sectionviewport.md -->

# sectionViewport

**Kind:** Constant

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/animations.ts` (line 115)

Section viewport trigger defaults.
Use with whileInView on section containers.

<!-- source: component-colorfield.md -->

# ColorField

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/branding/page.tsx` (line 1073)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `value` | `string` | ✓ | - |
| `onChange` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ColorField_2d432677["ColorField"]
    class component_ColorField_2d432677 rootComponent
```

## Relationships

- RENDERS → `CheckIcon`
- RENDERS → `ClipboardDocumentIcon`
- USES_HOOK → `useState`

<!-- source: interface-generationcontext.md -->

# GenerationContext

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-10.types.ts` (line 112)

GenerationContext - Extended context for AI generation

Includes mechanisms for the AI to request more context.

## Properties

| Property | Type |
|---|---|
| `chunkSummary` | `string` |
| `relevantEntities` | `Entity[]` |
| `deepLoadedEntities` | `Map<string, DeepLoadResponse>` |
| `deepLoadIterations` | `number` |
| `maxDeepLoadIterations` | `number` |
| `uncertainties` | `Uncertainty[]` |

<!-- source: api-endpoint-getversions.md -->

# getVersions

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 275)

## Endpoint

`GET /documents/:id/versions`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: constant-selectitem.md -->

# SelectItem

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/select.tsx` (line 12)

<!-- source: component-columneditor.md -->

# ColumnEditor

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/ColumnEditor.tsx` (line 56)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `open` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `boardId` | `string` | ✓ | - |
| `column` | `unknown | null` | ✓ | - |
| `afterColumnId` | `string` | - | - |
| `onSaved` | `Function` | - | - |
| `onDeleted` | `Function` | - | - |
| `otherColumns` | `Array` | - | [] |

## Diagram

```mermaid
graph TD
    component_ColumnEditor_5e59bd5c["ColumnEditor"]
    class component_ColumnEditor_5e59bd5c rootComponent
```

## Relationships

- RENDERS → `Modal`
- RENDERS → `TrashIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useBoardsToast`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-generationinput.md -->

# GenerationInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-10.types.ts` (line 26)

## Properties

| Property | Type |
|---|---|
| `plans` | `DocumentPlan[]` |
| `entities` | `Entity[]` |
| `sharedContext` | `string` |
| `retrievedContexts` | `Map<string, RetrievedContext>` |
| `appName` | `string` |
| `categoryMap` | `Map<string, { categoryId: string; categorySlug: string; categoryName: string }>` |

<!-- source: api-endpoint-getversiontraffic.md -->

# getVersionTraffic

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 41)

## Endpoint

`GET /analytics/:projectId/versions`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: constant-selector-types.md -->

# SELECTOR_TYPES

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 13)

Route Mapping Types

Type definitions for linking routes to components, templates, and extracted selectors.
Used to provide accurate selector information to the screenshot-worker.

<!-- source: component-commandpalette.md -->

# CommandPalette

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/CommandPalette.tsx` (line 40)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `navMap` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CommandPalette_320cc491["CommandPalette"]
    class component_CommandPalette_320cc491 rootComponent
```

## Relationships

- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useMemo`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-generationresult.md -->

# GenerationResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-10.types.ts` (line 35)

## Properties

| Property | Type |
|---|---|
| `documents` | `GeneratedDocument[]` |
| `tokenUsage` | `TokenUsage[]` |

<!-- source: api-endpoint-getwebhookurl.md -->

# getWebhookUrl

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 289)

## Endpoint

`GET /doc-automation/config/:projectId/webhook-url`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: constant-separator.md -->

# Separator

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/toolbar.tsx` (line 326)

A toolbar primitive that allows you to show a separator between toolbar items.
By default, the separator is styled as vertical line.

<!-- source: component-commentformskeleton.md -->

# CommentFormSkeleton

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Comments/CommentSkeleton.tsx` (line 53)

## Diagram

```mermaid
graph TD
    component_CommentFormSkeleton_698dd283["CommentFormSkeleton"]
    class component_CommentFormSkeleton_698dd283 rootComponent
```

<!-- source: interface-generatorserviceconfig.md -->

# GeneratorServiceConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/generator.service.ts` (line 41)

## Properties

| Property | Type |
|---|---|
| `maxOutputTokens` | `number` |
| `temperature` | `number` |
| `batchSize` | `number` |
| `onDocumentGenerated` | `(doc: GeneratedDocument) => Promise<void>` |
| `useTemplatePrefill` | `boolean` |

<!-- source: api-endpoint-getzeroresultsearches.md -->

# getZeroResultSearches

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 120)

## Endpoint

`GET /analytics/:projectId/zero-result-searches`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: constant-setmarkdown.md -->

# setMarkdown$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 379)

Sets a new markdown value for the editor, replacing the current one.

<!-- source: component-commenthighlight.md -->

# CommentHighlight

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/CommentMarkers.tsx` (line 224)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |
| `isActive` | `boolean` | - | - |
| `onClick` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_CommentHighlight_482205e5["CommentHighlight"]
    class component_CommentHighlight_482205e5 rootComponent
```

<!-- source: interface-genericjsxeditorprops.md -->

# GenericJsxEditorProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/jsx-editors/GenericJsxEditor.tsx` (line 55)

Properties for the Generic Jsx Editor

## Properties

| Property | Type |
|---|---|
| `PropertyEditor` | `PropertyEditorType` |

<!-- source: api-endpoint-handle.md -->

# handle

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/github-app/github-app.controller.ts` (line 22)

## Endpoint

`POST /webhooks/github-app`

## Referenced By

- `GithubAppController` (MODULE_DECLARES)

<!-- source: constant-shadcn-component-patterns.md -->

# SHADCN_COMPONENT_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/shadcn.patterns.ts` (line 12)

shadcn/ui Pattern Detection

Patterns for detecting shadcn/ui components (built on Radix UI primitives).
shadcn/ui copies component code into your project rather than being a package.

<!-- source: component-commentmarkers.md -->

# CommentMarkers

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/CommentMarkers.tsx` (line 38)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `comments` | `CommentWithUser[]` | ✓ | - |
| `onMarkerClick` | `Function` | - | - |
| `editorContent` | `string` | - | "" |
| `containerHeight` | `number` | - | 800 |

## Diagram

```mermaid
graph TD
    component_CommentMarkers_7abefb16["CommentMarkers"]
    class component_CommentMarkers_7abefb16 rootComponent
```

## Relationships

- RENDERS → `MessageCircle`
- RENDERS → `CommentPreview`
- USES_HOOK → `useState`
- USES_HOOK → `useMemo`
- USES_HOOK → `useCallback`

<!-- source: interface-gridprofile.md -->

# GridProfile

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/site-map.types.ts` (line 10)

SiteMap Types — Browser-discovered route and page profile data.

Generated by the DiscoveryService in screenshot-worker via Playwright.
Feeds HybridMapper Tier 2 (confidence 0.95) for screenshot placeholder matching.

## Properties

| Property | Type |
|---|---|
| `framework` | `'devextreme' | 'ag-grid' | 'aria' | 'html-table'` |
| `selector` | `string` |
| `rowCount` | `number` |
| `columns` | `string[]` |
| `hasDetailNavigation` | `boolean` |
| `detailUrl` | `string` |
| `detailProfile` | `PageElementProfile` |

<!-- source: api-endpoint-handle-2.md -->

# handle

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-mcp.controller.ts` (line 164)

## Endpoint

`POST /technical-docs/:projectId/mcp`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsMcpController` (MODULE_DECLARES)

<!-- source: constant-shadcn-data-table-patterns.md -->

# SHADCN_DATA_TABLE_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/shadcn.patterns.ts` (line 216)

<!-- source: component-commentsidebar.md -->

# CommentSidebar

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Comments/CommentSidebar.tsx` (line 42)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `documentId` | `string` | ✓ | - |
| `isOpen` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `enableRealtime` | `boolean` | - | true |
| `projectId` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_CommentSidebar_cc3c3f7["CommentSidebar"]
    class component_CommentSidebar_cc3c3f7 rootComponent
```

## Relationships

- RENDERS → `MessageCircle`
- RENDERS → `X`
- RENDERS → `FilterPill`
- RENDERS → `CommentSkeletonList`
- RENDERS → `CommentThread`
- RENDERS → `CommentForm`
- USES_HOOK → `useComments`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useMemo`
- USES_HOOK → `useEffect`

<!-- source: interface-groundingresult.md -->

# GroundingResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/grounding-checker.ts` (line 13)

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `title` | `string` |
| `score` | `number` |
| `matched` | `string[]` |
| `unmatched` | `string[]` |

<!-- source: api-endpoint-handleazuredevops.md -->

# handleAzureDevOps

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/webhooks/webhook.controller.ts` (line 94)

## Endpoint

`POST /webhooks/azure-devops`

## Referenced By

- `WebhookController` (MODULE_DECLARES)

<!-- source: constant-shadcn-detection-config.md -->

# SHADCN_DETECTION_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/shadcn.patterns.ts` (line 287)

## Definition

```ts
ShadcnDetectionConfig
```

<!-- source: component-commentskeletonlist.md -->

# CommentSkeletonList

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Comments/CommentSkeleton.tsx` (line 40)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `count` | `number` | - | 3 |

## Diagram

```mermaid
graph TD
    component_CommentSkeletonList_1a0c0929["CommentSkeletonList"]
    class component_CommentSkeletonList_1a0c0929 rootComponent
```

## Relationships

- RENDERS → `CommentSkeleton`

<!-- source: interface-groundingscoreresult.md -->

# GroundingScoreResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/grounding-checker.ts` (line 21)

## Properties

| Property | Type |
|---|---|
| `score` | `number` |
| `matched` | `string[]` |
| `unmatched` | `string[]` |

<!-- source: api-endpoint-handlecallback.md -->

# handleCallback

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/bitbucket/bitbucket.controller.ts` (line 23)

## Endpoint

`GET /bitbucket/callback`

| Parameter | In | Type | Required |
|---|---|---|---|
| `code` | query | `string` | ✓ |
| `state` | query | `string` | ✓ |

## Referenced By

- `BitbucketController` (MODULE_DECLARES)

<!-- source: constant-shadcn-form-patterns.md -->

# SHADCN_FORM_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/shadcn.patterns.ts` (line 178)

<!-- source: component-commentthread.md -->

# CommentThread

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Comments/CommentThread.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `comment` | `CommentWithUser` | ✓ | - |
| `onResolve` | `Function` | ✓ | - |
| `onUnresolve` | `Function` | ✓ | - |
| `onReply` | `Function` | ✓ | - |
| `onDelete` | `Function` | - | - |
| `projectId` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_CommentThread_20643079["CommentThread"]
    class component_CommentThread_20643079 rootComponent
```

## Relationships

- RENDERS → `Check`
- RENDERS → `Avatar`
- RENDERS → `MessageSquare`
- RENDERS → `RotateCcw`
- RENDERS → `Trash2`
- RENDERS → `CommentReply`
- RENDERS → `ReplyForm`
- USES_HOOK → `useState`

<!-- source: api-endpoint-handlecallback-2.md -->

# handleCallback

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/github/github.controller.ts` (line 31)

GitHub OAuth callback - exchanges code for token
This is called by GitHub after the user authorizes.
Returns HTML that sends a message to the opener window and closes itself.

## Endpoint

`GET /github/callback`

| Parameter | In | Type | Required |
|---|---|---|---|
| `code` | query | `string` | ✓ |
| `state` | query | `string` | ✓ |

## Referenced By

- `GitHubController` (MODULE_DECLARES)

<!-- source: interface-herobentogridprops-2.md -->

# HeroBentoGridProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/hero/hero-bento-grid.tsx` (line 15)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `subheadlineKey` | `string` |
| `primaryCtaKey` | `string` |
| `primaryCtaUrl` | `string` |
| `secondaryCtaKey` | `string` |
| `secondaryCtaUrl` | `string` |
| `badgeKey` | `string` |
| `gridItems` | `{ titleKey: string; descriptionKey?: string; icon?: LucideIcon }[]` |
| `className` | `string` |

<!-- source: constant-shadcn-utility-patterns.md -->

# SHADCN_UTILITY_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/shadcn.patterns.ts` (line 252)

<!-- source: component-compactupload.md -->

# CompactUpload

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/branding/page.tsx` (line 1250)

Compact upload — preview + upload + clear all in one interactive zone. Click the zone to pick a file, hover to see the replace/clear overlay.

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `url` | `string` | ✓ | - |
| `uploading` | `boolean` | ✓ | - |
| `inputRef` | `unknown` | ✓ | - |
| `onUpload` | `Function` | ✓ | - |
| `onClear` | `Function` | ✓ | - |
| `size` | `unknown | unknown` | - | "lg" |

## Diagram

```mermaid
graph TD
    component_CompactUpload_26ad441c["CompactUpload"]
    class component_CompactUpload_26ad441c rootComponent
```

## Relationships

- RENDERS → `ArrowUpTrayIcon`
- USES_HOOK → `useState`

<!-- source: api-endpoint-handlecallback-3.md -->

# handleCallback

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/gitlab/gitlab.controller.ts` (line 31)

GitLab OAuth callback - exchanges code for token
This is called by GitLab after the user authorizes.
Returns HTML that sends a message to the opener window and closes itself.

## Endpoint

`GET /gitlab/callback`

| Parameter | In | Type | Required |
|---|---|---|---|
| `code` | query | `string` | ✓ |
| `state` | query | `string` | ✓ |

## Referenced By

- `GitLabController` (MODULE_DECLARES)

<!-- source: interface-herodarkcenteredprops-2.md -->

# HeroDarkCenteredProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/hero/hero-dark-centered.tsx` (line 14)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `subheadlineKey` | `string` |
| `primaryCtaKey` | `string` |
| `primaryCtaUrl` | `string` |
| `secondaryCtaKey` | `string` |
| `secondaryCtaUrl` | `string` |
| `badgeKey` | `string` |
| `floatingStats` | `{ valueKey: string; labelKey: string }[]` |
| `imageSrc` | `string` |
| `imageAlt` | `string` |

<!-- source: constant-showlinktitlefield.md -->

# showLinkTitleField$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 382)

<!-- source: component-comparedocumentspage.md -->

# CompareDocumentsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/documents/[id]/compare/page.tsx` (line 35)

## Diagram

```mermaid
graph TD
    component_CompareDocumentsPage_5d965af9["CompareDocumentsPage"]
    class component_CompareDocumentsPage_5d965af9 rootComponent
```

## Relationships

- RENDERS → `ArrowLeftIcon`
- RENDERS → `ChartBarIcon`
- RENDERS → `Squares2X2Icon`
- RENDERS → `ViewColumnsIcon`
- RENDERS → `ClockIcon`
- RENDERS → `TimelineView`
- RENDERS → `ArrowsRightLeftIcon`
- RENDERS → `UnifiedDiff`
- RENDERS → `SideBySideDiff`
- USES_HOOK → `useParams`
- USES_HOOK → `useRouter`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: api-endpoint-handlegithub.md -->

# handleGitHub

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/webhooks/webhook.controller.ts` (line 19)

## Endpoint

`POST /webhooks/github`

## Referenced By

- `WebhookController` (MODULE_DECLARES)

<!-- source: interface-herogradientsplitprops-2.md -->

# HeroGradientSplitProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/hero/hero-gradient-split.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `subheadlineKey` | `string` |
| `primaryCtaKey` | `string` |
| `primaryCtaUrl` | `string` |
| `secondaryCtaKey` | `string` |
| `secondaryCtaUrl` | `string` |
| `imageSrc` | `string` |
| `imageAlt` | `string` |
| `badges` | `{ textKey: string; icon?: LucideIcon }[]` |
| `className` | `string` |

<!-- source: constant-singletogglegroup.md -->

# SingleToggleGroup

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/toolbar.tsx` (line 77)

<!-- source: component-compareversionspage.md -->

# CompareVersionsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/versions/compare/page.tsx` (line 15)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CompareVersionsPage_ac18b08["CompareVersionsPage"]
    class component_CompareVersionsPage_ac18b08 rootComponent
```

## Relationships

- USES_HOOK → `useSession`
- USES_HOOK → `useRouter`
- USES_HOOK → `useSearchParams`
- USES_HOOK → `useState`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useEffect`

<!-- source: api-endpoint-handlegitlab.md -->

# handleGitLab

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/webhooks/webhook.controller.ts` (line 64)

## Endpoint

`POST /webhooks/gitlab`

## Referenced By

- `WebhookController` (MODULE_DECLARES)

<!-- source: interface-herominimalcenteredprops-2.md -->

# HeroMinimalCenteredProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/hero/hero-minimal-centered.tsx` (line 14)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `subheadlineKey` | `string` |
| `primaryCtaKey` | `string` |
| `primaryCtaUrl` | `string` |
| `secondaryCtaKey` | `string` |
| `secondaryCtaUrl` | `string` |
| `badgeKey` | `string` |
| `badgeIcon` | `LucideIcon` |
| `dividerIcons` | `LucideIcon[]` |
| `imageSrc` | `string` |
| `imageAlt` | `string` |

<!-- source: constant-slidefromend.md -->

# slideFromEnd

**Kind:** Constant

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/animations.ts` (line 72)

Slide from inline-end (LTR: right, RTL: left)

## Definition

```ts
Variants
```

<!-- source: component-completionsummary.md -->

# CompletionSummary

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/DocAutomation/CompletionSummary.tsx` (line 51)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `result` | `JobResult` | ✓ | - |
| `projectSlug` | `string` | - | - |
| `projectId` | `string` | - | - |
| `onGenerateAgain` | `Function` | - | - |
| `onViewDocs` | `Function` | - | - |
| `screenshotProgress` | `unknown | null` | - | - |
| `onCancelScreenshots` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_CompletionSummary_7657cbf4["CompletionSummary"]
    class component_CompletionSummary_7657cbf4 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `CheckCircle2`
- RENDERS → `Icon`
- RENDERS → `Globe`
- RENDERS → `Camera`
- RENDERS → `Button`
- RENDERS → `ExternalLink`
- RENDERS → `Check`
- RENDERS → `Copy`
- RENDERS → `RefreshCw`
- USES_HOOK → `useState`

<!-- source: api-endpoint-handlemcp.md -->

# handleMcp

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 289)

## Endpoint

`POST /public/p/:slugWithId/mcp`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: interface-howitworkscardsgridprops-2.md -->

# HowItWorksCardsGridProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/how-it-works/how-it-works-cards-grid.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `labelKey` | `string` |
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `steps` | `{ icon: LucideIcon; titleKey: string; descriptionKey: string }[]` |

<!-- source: constant-slidefromstart.md -->

# slideFromStart

**Kind:** Constant

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/animations.ts` (line 62)

Slide from inline-start (LTR: left, RTL: right)

## Definition

```ts
Variants
```

<!-- source: component-configeditor.md -->

# ConfigEditor

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/DocAutomation/ConfigEditor.tsx` (line 65)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `config` | `DocumentationConfig | null` | ✓ | - |
| `loading` | `boolean` | - | false |
| `error` | `Error | null` | - | - |
| `onSave` | `Function` | ✓ | - |
| `onCancel` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_ConfigEditor_5e2992a0["ConfigEditor"]
    class component_ConfigEditor_5e2992a0 rootComponent
```

## Relationships

- RENDERS → `GitBranch`
- RENDERS → `Lock`
- RENDERS → `EyeOff`
- RENDERS → `Eye`
- RENDERS → `FolderCode`
- RENDERS → `Globe`
- RENDERS → `Users`
- RENDERS → `AlertCircle`
- RENDERS → `Button`
- RENDERS → `Loader2`
- RENDERS → `Save`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: api-endpoint-healthcheck-2.md -->

# healthCheck

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/app/app.controller.ts` (line 19)

## Endpoint

`GET /health`

## Referenced By

- `AppController` (MODULE_DECLARES)

<!-- source: interface-hybridmappingoptions.md -->

# HybridMappingOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/hybrid-mapper.service.ts` (line 50)

## Properties

| Property | Type |
|---|---|
| `interactionMap` | `InteractionMap` |
| `siteMap` | `SiteMap` |
| `siteUrl` | `string` |
| `appName` | `string` |

<!-- source: constant-spellcheck.md -->

# spellCheck$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 141)

Holds the spellcheck value of the content editable element.

<!-- source: component-connectaimenu.md -->

# ConnectAiMenu

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/ConnectAiMenu.tsx` (line 15)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `slugId` | `string` | ✓ | - |
| `audienceSlug` | `string` | ✓ | - |
| `documentSlug` | `string` | ✓ | - |
| `title` | `string` | ✓ | - |
| `content` | `string` | ✓ | - |
| `lang` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ConnectAiMenu_1e6ecca["ConnectAiMenu"]
    class component_ConnectAiMenu_1e6ecca rootComponent
```

## Relationships

- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-hybridmappingresult.md -->

# HybridMappingResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/hybrid-mapper.service.ts` (line 61)

## Properties

| Property | Type |
|---|---|
| `mapped` | `ScreenshotSpec[]` |
| `unmapped` | `ScreenshotPlaceholder[]` |
| `stats` | `HybridMappingStats` |

<!-- source: api-endpoint-importintercom.md -->

# importIntercom

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 213)

## Endpoint

`POST /technical-docs/:projectId/sources/intercom`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: constant-spring-async-patterns.md -->

# SPRING_ASYNC_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/spring.patterns.ts` (line 233)

<!-- source: component-connectorspanel.md -->

# ConnectorsPanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/components/ConnectorsPanel.tsx` (line 30)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ConnectorsPanel_755ea9db["ConnectorsPanel"]
    class component_ConnectorsPanel_755ea9db rootComponent
```

## Relationships

- RENDERS → `BoltIcon`
- RENDERS → `PlusIcon`
- RENDERS → `ArrowPathIcon`
- RENDERS → `TrashIcon`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-hybridmappingstats.md -->

# HybridMappingStats

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/hybrid-mapper.service.ts` (line 70)

## Properties

| Property | Type |
|---|---|
| `total` | `number` |
| `interactionMapMatches` | `number` |
| `siteMapMatches` | `number` |
| `unmatchedCount` | `number` |
| `averageConfidence` | `number` |

<!-- source: api-endpoint-importpdfsource.md -->

# importPdfSource

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 189)

## Endpoint

`POST /technical-docs/:projectId/sources/pdf`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: constant-spring-controller-patterns.md -->

# SPRING_CONTROLLER_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/spring.patterns.ts` (line 11)

Spring Boot Pattern Detection

Patterns for detecting Spring Boot controllers, services, and annotations.

<!-- source: component-createboarddialog.md -->

# CreateBoardDialog

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/CreateBoardDialog.tsx` (line 44)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `open` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `onCreated` | `Function` | - | - |
| `duplicateFrom` | `unknown | null` | - | - |

## Diagram

```mermaid
graph TD
    component_CreateBoardDialog_786a7a20["CreateBoardDialog"]
    class component_CreateBoardDialog_786a7a20 rootComponent
```

## Relationships

- RENDERS → `Modal`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useRouter`
- USES_HOOK → `useBoardsToast`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-ianalyzerservice.md -->

# IAnalyzerService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-04-analysis/analyzer.service.ts` (line 35)

<!-- source: api-endpoint-importurlsource.md -->

# importUrlSource

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 177)

## Endpoint

`POST /technical-docs/:projectId/sources/url`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: constant-spring-data-patterns.md -->

# SPRING_DATA_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/spring.patterns.ts` (line 89)

<!-- source: component-customaccordion.md -->

# CustomAccordion

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 738)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |
| `...props` | `object` | - | - |

## Diagram

```mermaid
graph TD
    component_CustomAccordion_15ea9134["CustomAccordion"]
    class component_CustomAccordion_15ea9134 rootComponent
```

<!-- source: interface-ichunkerservice.md -->

# IChunkerService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-02-chunking/chunker.service.ts` (line 28)

Chunker service interface for dependency injection

<!-- source: api-endpoint-importzendesk.md -->

# importZendesk

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 202)

## Endpoint

`POST /technical-docs/:projectId/sources/zendesk`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: constant-spring-detection-config.md -->

# SPRING_DETECTION_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/spring.patterns.ts` (line 259)

## Definition

```ts
SpringDetectionConfig
```

<!-- source: component-customaccordionitem.md -->

# CustomAccordionItem

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 746)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |
| `title` | `any` | ✓ | - |
| `...props` | `object` | - | - |

## Diagram

```mermaid
graph TD
    component_CustomAccordionItem_f39c667["CustomAccordionItem"]
    class component_CustomAccordionItem_f39c667 rootComponent
```

<!-- source: interface-icrossstackmapper.md -->

# ICrossStackMapper

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-03-features/cross-stack-mapper.ts` (line 63)

Cross-Stack Mapper Service Interface

<!-- source: api-endpoint-improve.md -->

# improve

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/ai/ai.controller.ts` (line 76)

## Endpoint

`POST /ai/improve`

## Referenced By

- `AIController` (MODULE_DECLARES)

<!-- source: constant-spring-error-patterns.md -->

# SPRING_ERROR_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/spring.patterns.ts` (line 218)

<!-- source: component-customalert.md -->

# CustomAlert

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 729)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |
| `type` | `any` | ✓ | - |
| `...props` | `object` | - | - |

## Diagram

```mermaid
graph TD
    component_CustomAlert_4bc42b48["CustomAlert"]
    class component_CustomAlert_4bc42b48 rootComponent
```

<!-- source: interface-idocplannerservice.md -->

# IDocPlannerService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-09-planning/doc-planner.service.ts` (line 29)

<!-- source: api-endpoint-insights.md -->

# insights

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/manuals-insights/manuals-insights.controller.ts` (line 17)

## Endpoint

`GET /manuals-insights/:projectId/insights`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `ManualsInsightsController` (MODULE_DECLARES)

<!-- source: constant-spring-security-patterns.md -->

# SPRING_SECURITY_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/spring.patterns.ts` (line 172)

<!-- source: component-custombreadcrumb.md -->

# CustomBreadcrumb

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 721)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |
| `...props` | `object` | - | - |

## Diagram

```mermaid
graph TD
    component_CustomBreadcrumb_1ef0e197["CustomBreadcrumb"]
    class component_CustomBreadcrumb_1ef0e197 rootComponent
```

<!-- source: interface-ifeatureextractorservice.md -->

# IFeatureExtractorService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-03-features/extractor.service.ts` (line 24)

<!-- source: api-endpoint-invitemember.md -->

# inviteMember

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/organization/organization.controller.ts` (line 114)

## Endpoint

`POST /organizations/:id/invite`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `OrganizationController` (MODULE_DECLARES)

<!-- source: constant-spring-service-patterns.md -->

# SPRING_SERVICE_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/spring.patterns.ts` (line 57)

<!-- source: component-customcodeblock.md -->

# CustomCodeBlock

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 203)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `className` | `any` | ✓ | - |
| `children` | `any` | ✓ | - |
| `...props` | `object` | - | - |

## Diagram

```mermaid
graph TD
    component_CustomCodeBlock_de2077a["CustomCodeBlock"]
    class component_CustomCodeBlock_de2077a rootComponent
```

<!-- source: interface-igeneratorservice.md -->

# IGeneratorService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/generator.service.ts` (line 37)

<!-- source: api-endpoint-list.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/activity/activity.controller.ts` (line 18)

## Endpoint

`GET /activities`

| Parameter | In | Type | Required |
|---|---|---|---|
| `filters` | query | `ActivityFiltersDto` | ✓ |

## Referenced By

- `ActivityController` (MODULE_DECLARES)

<!-- source: constant-spring-validation-patterns.md -->

# SPRING_VALIDATION_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/spring.patterns.ts` (line 136)

<!-- source: component-customcodeblock-2.md -->

# CustomCodeBlock

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 561)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `node` | `any` | ✓ | - |
| `inline` | `any` | ✓ | - |
| `className` | `any` | ✓ | - |
| `children` | `any` | ✓ | - |
| `...props` | `object` | - | - |

## Diagram

```mermaid
graph TD
    component_CustomCodeBlock_3e369e8c["CustomCodeBlock"]
    class component_CustomCodeBlock_3e369e8c rootComponent
```

<!-- source: interface-imageeditorprops.md -->

# ImageEditorProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/ImageEditor.tsx` (line 46)

## Properties

| Property | Type |
|---|---|
| `nodeKey` | `string` |
| `src` | `string` |
| `alt` | `string` |
| `title` | `string` |
| `width` | `number | 'inherit'` |
| `height` | `number | 'inherit'` |
| `rest` | `(MdxJsxAttribute | MdxJsxExpressionAttribute)[]` |

<!-- source: api-endpoint-list-2.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/audience/audience.controller.ts` (line 29)

## Endpoint

`GET /audiences`

## Referenced By

- `AudienceController` (MODULE_DECLARES)

<!-- source: constant-sronly.md -->

# srOnly

**Kind:** Constant

**Source:** `atloria-monorepo/packages/ui-core/src/utils/styles.ts` (line 25)

<!-- source: component-customdiv.md -->

# CustomDiv

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 513)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |
| `className` | `any` | ✓ | - |
| `...props` | `object` | - | - |

## Diagram

```mermaid
graph TD
    component_CustomDiv_7dec4e83["CustomDiv"]
    class component_CustomDiv_7dec4e83 rootComponent
```

## Relationships

- RENDERS → `VideoEmbed`
- RENDERS → `Screenshot`

<!-- source: interface-importpoint.md -->

# ImportPoint

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/importMarkdownToLexical.ts` (line 124)

<!-- source: api-endpoint-list-3.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 32)

## Endpoint

`GET /projects/:projectId/boards`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: constant-staggerchildren.md -->

# staggerChildren

**Kind:** Constant

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/animations.ts` (line 40)

Stagger children — use on parent container

## Definition

```ts
Variants
```

<!-- source: component-customem.md -->

# CustomEm

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 681)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomEm_35be923c["CustomEm"]
    class component_CustomEm_35be923c rootComponent
```

<!-- source: interface-importstatement.md -->

# ImportStatement

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/importMarkdownToLexical.ts` (line 13)

## Properties

| Property | Type |
|---|---|
| `source` | `string` |
| `defaultExport` | `boolean` |

<!-- source: api-endpoint-list-4.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/capture/capture.controller.ts` (line 46)

## Endpoint

`GET /capture/:projectId/flows`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `CaptureController` (MODULE_DECLARES)

<!-- source: constant-staggerfast.md -->

# staggerFast

**Kind:** Constant

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/animations.ts` (line 51)

Faster stagger for grids with many items

## Definition

```ts
Variants
```

<!-- source: component-customheading1.md -->

# CustomHeading1

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 232)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomHeading1_302e3837["CustomHeading1"]
    class component_CustomHeading1_302e3837 rootComponent
```

<!-- source: interface-inactiveimagedialogstate.md -->

# InactiveImageDialogState

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 90)

The state of the image dialog when it is inactive.

## Properties

| Property | Type |
|---|---|
| `type` | `'inactive'` |

<!-- source: api-endpoint-list-5.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/comment/comment.controller.ts` (line 73)

List all comments for a document with optional filters

## Endpoint

`GET /documents/:documentId/comments`

| Parameter | In | Type | Required |
|---|---|---|---|
| `documentId` | query | `string` | ✓ |
| `filters` | query | `CommentFiltersDto` | ✓ |

## Referenced By

- `CommentController` (MODULE_DECLARES)

<!-- source: constant-state-management-detection-configs.md -->

# STATE_MANAGEMENT_DETECTION_CONFIGS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/framework.types.ts` (line 403)

State management detection configurations

<!-- source: component-customheading1-2.md -->

# CustomHeading1

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 589)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomHeading1_5ea94903["CustomHeading1"]
    class component_CustomHeading1_5ea94903 rootComponent
```

<!-- source: interface-inactivelinkdialog.md -->

# InactiveLinkDialog

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 32)

The state of the link dialog when it is inactive.

## Properties

| Property | Type |
|---|---|
| `type` | `'inactive'` |
| `rectangle` | `undefined` |
| `linkNodeKey` | `undefined` |

<!-- source: api-endpoint-list-6.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 41)

## Endpoint

`GET /doc-versions/:projectId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `query` | query | `ListDocVersionsDto` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: constant-streaming-config.md -->

# STREAMING_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 388)

<!-- source: component-customheading2.md -->

# CustomHeading2

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 241)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomHeading2_302e3836["CustomHeading2"]
    class component_CustomHeading2_302e3836 rootComponent
```

<!-- source: interface-includenode.md -->

# IncludeNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 72)

Include reference node
Represents a reference to a reusable block

## Properties

| Property | Type |
|---|---|
| `type` | `'include_reference'` |
| `blockId` | `string` |
| `resolved` | `boolean` |
| `resolvedContent` | `ASTNode[]` |

<!-- source: api-endpoint-list-7.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/category.controller.ts` (line 45)

List categories with filters

## Endpoint

`GET /categories`

| Parameter | In | Type | Required |
|---|---|---|---|
| `filters` | query | `CategoryFiltersDto` | ✓ |

## Referenced By

- `CategoryController` (MODULE_DECLARES)

<!-- source: constant-subtle.md -->

# subtle

**Kind:** Constant

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/animations.ts` (line 103)

Subtle entrance — minimal animation

## Definition

```ts
Variants
```

<!-- source: component-customheading2-2.md -->

# CustomHeading2

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 594)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomHeading2_5ea94904["CustomHeading2"]
    class component_CustomHeading2_5ea94904 rootComponent
```

<!-- source: interface-inputprofile.md -->

# InputProfile

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/site-map.types.ts` (line 34)

## Properties

| Property | Type |
|---|---|
| `type` | `string` |
| `placeholder` | `string` |
| `selector` | `string` |
| `label` | `string` |

<!-- source: api-endpoint-list-8.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 77)

## Endpoint

`GET /documents`

| Parameter | In | Type | Required |
|---|---|---|---|
| `filters` | query | `DocumentFiltersDto` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: constant-supported-locales.md -->

# SUPPORTED_LOCALES

**Kind:** Constant

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/i18n.tsx` (line 46)

Supported locales — assembler populates this during generation.
Each generated site has its own set of locales.

## Definition

```ts
LocaleInfo[]
```

<!-- source: component-customheading3.md -->

# CustomHeading3

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 250)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomHeading3_302e3835["CustomHeading3"]
    class component_CustomHeading3_302e3835 rootComponent
```

<!-- source: interface-interactionmap.md -->

# InteractionMap

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 243)

Complete interaction map for an entire application.
Generated by source code analysis in Phase 1.

## Properties

| Property | Type |
|---|---|
| `framework` | `'angular' | 'react' | 'vue' | 'nextjs' | 'jquery' | 'unknown'` |
| `routes` | `RouteInteractionMap[]` |
| `globalPermissions` | `PermissionCheck[]` |
| `authConfig` | `AuthConfigDiscovery` |
| `stats` | `InteractionMapStats` |
| `generatedAt` | `Date` |

<!-- source: api-endpoint-list-9.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/issues.controller.ts` (line 26)

## Endpoint

`GET /projects/:projectId/issues`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `status` | query | `string` | - |
| `category` | query | `string` | - |
| `ticketType` | query | `string` | - |
| `priority` | query | `string` | - |
| `assigneeId` | query | `string` | - |
| `search` | query | `string` | - |
| `sortBy` | query | `string` | - |
| `sortOrder` | query | `string` | - |
| `page` | query | `string` | - |
| `limit` | query | `string` | - |

## Referenced By

- `IssuesController` (MODULE_DECLARES)

<!-- source: constant-svelte-component-patterns.md -->

# SVELTE_COMPONENT_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/svelte.patterns.ts` (line 11)

Svelte Pattern Detection

Patterns for detecting Svelte components, stores, and reactivity.

<!-- source: component-customheading3-2.md -->

# CustomHeading3

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 599)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomHeading3_5ea94905["CustomHeading3"]
    class component_CustomHeading3_5ea94905 rootComponent
```

<!-- source: interface-interactionmapstats.md -->

# InteractionMapStats

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 261)

Statistics about the interaction map

## Properties

| Property | Type |
|---|---|
| `totalRoutes` | `number` |
| `routesWithModals` | `number` |
| `routesWithTabs` | `number` |
| `routesWithForms` | `number` |
| `routesWithWorkflowStates` | `number` |
| `totalModals` | `number` |
| `totalTabs` | `number` |
| `totalFormFields` | `number` |
| `totalPermissions` | `number` |
| `totalWorkflowStates` | `number` |

<!-- source: api-endpoint-list-10.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/notification/notification.controller.ts` (line 20)

## Endpoint

`GET /notifications`

| Parameter | In | Type | Required |
|---|---|---|---|
| `unreadOnly` | query | `string` | - |
| `limit` | query | `string` | - |
| `offset` | query | `string` | - |

## Referenced By

- `NotificationController` (MODULE_DECLARES)

<!-- source: constant-svelte-detection-config.md -->

# SVELTE_DETECTION_CONFIG

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/svelte.patterns.ts` (line 250)

## Definition

```ts
SvelteDetectionConfig
```

<!-- source: component-customheading4.md -->

# CustomHeading4

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 259)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomHeading4_302e3834["CustomHeading4"]
    class component_CustomHeading4_302e3834 rootComponent
```

<!-- source: interface-iparserservice.md -->

# IParserService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/parser.service.ts` (line 40)

Parser service interface for dependency injection

<!-- source: api-endpoint-list-11.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/organization/organization.controller.ts` (line 41)

## Endpoint

`GET /organizations`

## Referenced By

- `OrganizationController` (MODULE_DECLARES)

<!-- source: constant-svelte-store-patterns.md -->

# SVELTE_STORE_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/svelte.patterns.ts` (line 148)

<!-- source: component-customheading4-2.md -->

# CustomHeading4

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 604)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomHeading4_5ea94906["CustomHeading4"]
    class component_CustomHeading4_5ea94906 rootComponent
```

<!-- source: interface-iphaseservice.md -->

# IPhaseService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-07-phases/divider.service.ts` (line 24)

<!-- source: api-endpoint-list-12.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 66)

## Endpoint

`GET /projects`

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: constant-svelte-template-patterns.md -->

# SVELTE_TEMPLATE_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/svelte.patterns.ts` (line 63)

<!-- source: component-customheading5.md -->

# CustomHeading5

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 268)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomHeading5_302e3833["CustomHeading5"]
    class component_CustomHeading5_302e3833 rootComponent
```

<!-- source: interface-isessionservice.md -->

# ISessionService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-08-sessions/planner.service.ts` (line 24)

<!-- source: api-endpoint-list-13.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/suggestion/suggestion.controller.ts` (line 24)

## Endpoint

`GET /documents/:documentId/suggestions`

| Parameter | In | Type | Required |
|---|---|---|---|
| `documentId` | query | `string` | ✓ |

## Referenced By

- `SuggestionController` (MODULE_DECLARES)

<!-- source: constant-sveltekit-patterns.md -->

# SVELTEKIT_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/svelte.patterns.ts` (line 185)

<!-- source: component-customheading5-2.md -->

# CustomHeading5

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 609)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomHeading5_5ea94907["CustomHeading5"]
    class component_CustomHeading5_5ea94907 rootComponent
```

<!-- source: interface-istructureservice.md -->

# IStructureService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-06-structure/structure.service.ts` (line 37)

<!-- source: api-endpoint-list-14.md -->

# list

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/template/template.controller.ts` (line 43)

List all available templates.
Returns public templates and organization-specific templates.

## Endpoint

`GET /templates`

| Parameter | In | Type | Required |
|---|---|---|---|
| `filters` | query | `TemplateFiltersDto` | ✓ |

## Referenced By

- `TemplateController` (MODULE_DECLARES)

<!-- source: constant-switchfrompreviewtolinkedit.md -->

# switchFromPreviewToLinkEdit$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 284)

An action that switches the link dialog from preview mode to edit mode.

<!-- source: component-customheading6.md -->

# CustomHeading6

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 277)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomHeading6_302e3832["CustomHeading6"]
    class component_CustomHeading6_302e3832 rootComponent
```

<!-- source: interface-isynthesizerservice.md -->

# ISynthesizerService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-05-synthesis/synthesizer.service.ts` (line 39)

<!-- source: api-endpoint-listagents.md -->

# listAgents

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.controller.ts` (line 105)

## Endpoint

`GET /support-agent/:projectId/agents`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `SupportAgentController` (MODULE_DECLARES)

<!-- source: constant-syntaxextensions.md -->

# syntaxExtensions$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 280)

<!-- source: component-customheading6-2.md -->

# CustomHeading6

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 614)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomHeading6_5ea94908["CustomHeading6"]
    class component_CustomHeading6_5ea94908 rootComponent
```

<!-- source: interface-iverifierservice.md -->

# IVerifierService

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/verifier.service.ts` (line 30)

<!-- source: api-endpoint-listassets.md -->

# listAssets

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/assets/assets.controller.ts` (line 43)

## Endpoint

`GET /assets`

| Parameter | In | Type | Required |
|---|---|---|---|
| `audiences` | query | `string` | - |

## Referenced By

- `AssetsController` (MODULE_DECLARES)

<!-- source: constant-tableplugin.md -->

# tablePlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/table/index.ts` (line 82)

A plugin that adds support for tables to the editor.

<!-- source: component-customlink.md -->

# CustomLink

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 294)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `href` | `any` | ✓ | - |
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomLink_1870dac["CustomLink"]
    class component_CustomLink_1870dac rootComponent
```

<!-- source: interface-jobconfig.md -->

# JobConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 124)

## Properties

| Property | Type |
|---|---|
| `repositoryUrl` | `string` |
| `branch` | `string` |
| `includePaths` | `string[]` |
| `excludePaths` | `string[]` |
| `targetAudience` | `'beginner' | 'intermediate' | 'advanced'` |
| `tone` | `'formal' | 'friendly' | 'technical'` |
| `language` | `string` |
| `maxDocuments` | `number` |
| `maxTokenBudget` | `number` |
| `enableScreenshots` | `boolean` |
| `screenshotBaseUrl` | `string` |

<!-- source: api-endpoint-listbranches.md -->

# listBranches

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/bitbucket/bitbucket.controller.ts` (line 80)

## Endpoint

`GET /bitbucket/repos/:owner/:repo/branches`

| Parameter | In | Type | Required |
|---|---|---|---|
| `owner` | query | `string` | ✓ |
| `repo` | query | `string` | ✓ |

## Referenced By

- `BitbucketController` (MODULE_DECLARES)

<!-- source: constant-thematicbreakplugin.md -->

# thematicBreakPlugin

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/thematic-break/index.ts` (line 23)

A plugin that adds support for thematic breaks.

<!-- source: component-customlink-2.md -->

# CustomLink

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 648)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `href` | `any` | ✓ | - |
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomLink_3f99df72["CustomLink"]
    class component_CustomLink_3f99df72 rootComponent
```

## Relationships

- RENDERS → `VideoEmbed`

<!-- source: interface-jobstate.md -->

# JobState

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 36)

## Properties

| Property | Type |
|---|---|
| `id` | `JobId` |
| `projectId` | `string` |
| `repositoryUrl` | `string` |
| `branch` | `string` |
| `status` | `JobStatus` |
| `currentStage` | `JobStage` |
| `progress` | `number` |
| `startedAt` | `Date` |
| `updatedAt` | `Date` |
| `completedAt` | `Date` |
| `error` | `string` |
| `config` | `JobConfig` |
| `approvalCheckpoint` | `ApprovalCheckpoint` |

<!-- source: api-endpoint-listbranches-2.md -->

# listBranches

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/github/github.controller.ts` (line 97)

List branches for a specific repository

## Endpoint

`GET /github/repos/:owner/:repo/branches`

| Parameter | In | Type | Required |
|---|---|---|---|
| `owner` | query | `string` | ✓ |
| `repo` | query | `string` | ✓ |

## Referenced By

- `GitHubController` (MODULE_DECLARES)

<!-- source: constant-theme-presets-4.md -->

# THEME_PRESETS

**Kind:** Constant

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/theme.ts` (line 78)

## Definition

```ts
Record<ThemeMode, ThemeVars>
```

<!-- source: component-customparagraph.md -->

# CustomParagraph

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 548)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |
| `node` | `any` | ✓ | - |
| `...props` | `object` | - | - |

## Diagram

```mermaid
graph TD
    component_CustomParagraph_8d06aa6["CustomParagraph"]
    class component_CustomParagraph_8d06aa6 rootComponent
```

<!-- source: interface-jpafield.md -->

# JPAField

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/spring-detector.ts` (line 109)

JPA field

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `column` | `string` |
| `nullable` | `boolean` |
| `unique` | `boolean` |

<!-- source: api-endpoint-listbranches-3.md -->

# listBranches

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/gitlab/gitlab.controller.ts` (line 97)

List branches for a specific repository

## Endpoint

`GET /gitlab/repos/:owner/:repo/branches`

| Parameter | In | Type | Required |
|---|---|---|---|
| `owner` | query | `string` | ✓ |
| `repo` | query | `string` | ✓ |

## Referenced By

- `GitLabController` (MODULE_DECLARES)

<!-- source: constant-themeengine.md -->

# themeEngine

**Kind:** Constant

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/theme-engine.ts` (line 389)

<!-- source: component-customscreenshot.md -->

# CustomScreenshot

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 795)

## Diagram

```mermaid
graph TD
    component_CustomScreenshot_3bd8c906["CustomScreenshot"]
    class component_CustomScreenshot_3bd8c906 rootComponent
```

## Relationships

- RENDERS → `Screenshot`

<!-- source: interface-jparelationship.md -->

# JPARelationship

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/spring-detector.ts` (line 120)

JPA relationship

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `'OneToOne' | 'OneToMany' | 'ManyToOne' | 'ManyToMany'` |
| `targetEntity` | `string` |
| `mappedBy` | `string` |

<!-- source: api-endpoint-listbranches-4.md -->

# listBranches

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/parsing/test-connection.controller.ts` (line 53)

## Endpoint

`POST /git/branches`

## Referenced By

- `TestConnectionController` (MODULE_DECLARES)

<!-- source: constant-tier-classification-rules.md -->

# TIER_CLASSIFICATION_RULES

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 402)

<!-- source: component-customstrong.md -->

# CustomStrong

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 673)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomStrong_4bef122b["CustomStrong"]
    class component_CustomStrong_4bef122b rootComponent
```

<!-- source: interface-jsxcomponentdescriptor.md -->

# JsxComponentDescriptor

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/index.ts` (line 57)

Defines the structure of a JSX component that can be used within the markdown document.

## Properties

| Property | Type |
|---|---|
| `name` | `string | null` |
| `kind` | `'flow' | 'text'` |
| `source` | `string` |
| `defaultExport` | `boolean` |
| `props` | `JsxPropertyDescriptor[]` |
| `hasChildren` | `boolean` |
| `Editor` | `React.ComponentType<JsxEditorProps>` |

<!-- source: api-endpoint-listcards.md -->

# listCards

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 141)

## Endpoint

`GET /projects/:projectId/boards/:boardId/cards`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `boardId` | query | `string` | ✓ |
| `since` | query | `string` | - |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: constant-togglesinglegroupwithitem.md -->

# ToggleSingleGroupWithItem

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/toolbar.tsx` (line 85)

<!-- source: component-customtable.md -->

# CustomTable

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 307)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomTable_2eedbb4c["CustomTable"]
    class component_CustomTable_2eedbb4c rootComponent
```

<!-- source: interface-jsxeditorprops.md -->

# JsxEditorProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/index.ts` (line 96)

The properties passed to a custom JSX Editor component.

## Properties

| Property | Type |
|---|---|
| `mdastNode` | `MdastJsx` |
| `descriptor` | `JsxComponentDescriptor` |

<!-- source: api-endpoint-listconnectors.md -->

# listConnectors

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 245)

## Endpoint

`GET /technical-docs/:projectId/connectors`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: constant-tomarkdownextensions.md -->

# toMarkdownExtensions$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 291)

<!-- source: component-customtable-2.md -->

# CustomTable

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 689)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomTable_4ccaddba["CustomTable"]
    class component_CustomTable_4ccaddba rootComponent
```

<!-- source: interface-jsxpluginparams.md -->

# JsxPluginParams

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/index.ts` (line 189)

## Properties

| Property | Type |
|---|---|
| `jsxComponentDescriptors` | `JsxComponentDescriptor[]` |
| `allowFragment` | `boolean` |

<!-- source: api-endpoint-listexporthistory.md -->

# listExportHistory

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/export/analytics-export.controller.ts` (line 145)

## Endpoint

`GET /analytics/:projectId/export-history`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `AnalyticsExportController` (MODULE_DECLARES)

<!-- source: constant-tomarkdownoptions.md -->

# toMarkdownOptions$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 295)

<!-- source: component-customtbody.md -->

# CustomTbody

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 704)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomTbody_4ccb8202["CustomTbody"]
    class component_CustomTbody_4ccb8202 rootComponent
```

<!-- source: interface-jsxpropertydescriptor.md -->

# JsxPropertyDescriptor

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/jsx/index.ts` (line 38)

Defines the structure of a JSX component property.

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `'string' | 'number' | 'expression'` |
| `required` | `boolean` |

<!-- source: api-endpoint-listjobs.md -->

# listJobs

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 120)

## Endpoint

`GET /doc-automation/jobs`

| Parameter | In | Type | Required |
|---|---|---|---|
| `filters` | query | `JobFiltersDto` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: constant-toolbartoggleitem.md -->

# ToolbarToggleItem

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/primitives/toolbar.tsx` (line 69)

<!-- source: component-customtd.md -->

# CustomTd

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 716)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomTd_35be9404["CustomTd"]
    class component_CustomTd_35be9404 rootComponent
```

<!-- source: interface-knowledgecollectorconfig.md -->

# KnowledgeCollectorConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/knowledge-reference.types.ts` (line 79)

## Properties

| Property | Type |
|---|---|
| `maxSnippetsPerEntry` | `number` |
| `maxSnippetChars` | `number` |
| `minConfidence` | `number` |
| `maxEntriesPerCategory` | `number` |
| `enableAdminClassification` | `boolean` |

<!-- source: api-endpoint-listjobs-2.md -->

# listJobs

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/screenshot/screenshot.controller.ts` (line 60)

## Endpoint

`GET /screenshots/jobs`

| Parameter | In | Type | Required |
|---|---|---|---|
| `filters` | query | `ScreenshotJobFiltersDto` | ✓ |

## Referenced By

- `ScreenshotController` (MODULE_DECLARES)

<!-- source: constant-topareachildren.md -->

# topAreaChildren$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 740)

<!-- source: component-customth.md -->

# CustomTh

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 712)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomTh_35be9408["CustomTh"]
    class component_CustomTh_35be9408 rootComponent
```

<!-- source: interface-knowledgeentry.md -->

# KnowledgeEntry

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/knowledge-reference.types.ts` (line 42)

## Properties

| Property | Type |
|---|---|
| `sourceDocId` | `string` |
| `sourceTitle` | `string` |
| `sourceSlug` | `string` |
| `sourceCategory` | `string` |
| `targetCategory` | `MetaKnowledgeCategory` |
| `confidence` | `number` |
| `relevanceReason` | `string` |
| `snippets` | `KnowledgeSnippet[]` |

<!-- source: api-endpoint-listpendingapprovals.md -->

# listPendingApprovals

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 111)

## Endpoint

`GET /doc-versions/:projectId/approvals/pending`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: constant-transition.md -->

# transition

**Kind:** Constant

**Source:** `atloria-monorepo/packages/ui-core/src/utils/styles.ts` (line 37)

<!-- source: component-customthead.md -->

# CustomThead

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 700)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomThead_4cce1640["CustomThead"]
    class component_CustomThead_4cce1640 rootComponent
```

<!-- source: interface-knowledgereferencestore.md -->

# KnowledgeReferenceStore

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/knowledge-reference.types.ts` (line 64)

## Properties

| Property | Type |
|---|---|
| `references` | `Record<MetaKnowledgeCategory, MetaCategoryReference>` |
| `metadata` | `{
    buildStartedAt: Date;
    buildCompletedAt?: Date;
    totalDocsProcessed: number;
    totalDocsClassified: number;
    classificationFailures: number;
  }` |

<!-- source: api-endpoint-listproviders.md -->

# listProviders

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/ai/ai.controller.ts` (line 160)

## Endpoint

`GET /ai/providers`

## Referenced By

- `AIController` (MODULE_DECLARES)

<!-- source: constant-translation.md -->

# translation$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 925)

<!-- source: component-customtr.md -->

# CustomTr

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 708)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `any` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_CustomTr_35be9412["CustomTr"]
    class component_CustomTr_35be9412 rootComponent
```

<!-- source: interface-knowledgesnippet.md -->

# KnowledgeSnippet

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/knowledge-reference.types.ts` (line 36)

## Properties

| Property | Type |
|---|---|
| `type` | `SnippetType` |
| `sectionTitle` | `string` |
| `content` | `string` |

<!-- source: api-endpoint-listreports.md -->

# listReports

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/export/analytics-export.controller.ts` (line 87)

## Endpoint

`GET /analytics/:projectId/reports`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `AnalyticsExportController` (MODULE_DECLARES)

<!-- source: constant-ui-library-detection-configs.md -->

# UI_LIBRARY_DETECTION_CONFIGS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/framework.types.ts` (line 352)

UI Library detection configurations

<!-- source: component-dashboardlayout.md -->

# DashboardLayout

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Layout/DashboardLayout.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DashboardLayout_47a9a6a3["DashboardLayout"]
    class component_DashboardLayout_47a9a6a3 rootComponent
```

## Relationships

- RENDERS → `Navbar`
- RENDERS → `Sidebar`
- RENDERS → `AnimatePresence`
- RENDERS → `motion-div`
- RENDERS → `XMarkIcon`
- RENDERS → `Bars3Icon`
- USES_HOOK → `useState`

<!-- source: interface-largefileindex.md -->

# LargeFileIndex

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-02.types.ts` (line 63)

LargeFileIndex - Detailed index for lazy loading from large files (>500KB)

Instead of loading full content of large files (which would overflow context),
we create an index that enables on-demand loading of specific sections.
This supports the iterative deep loading mechanism.

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `fileSize` | `number` |
| `lineCount` | `number` |
| `tokenEstimate` | `number` |
| `overview` | `{
    purpose: string; // What this file is for
    primaryExports: string[]; // Main exports
    imports: string[]; // Key imports
    isAutoGenerated: boolean; // Detected auto-generated file
  }` |
| `entities` | `Array<{
    name: string;
    type: string; // FUNCTION, CLASS, etc.
    startLine: number;
    endLine: number;
    signature: string; // Quick reference
    summary: string; // Brief description
    hasNeverTruncatePatterns: boolean; // Contains critical patterns
  }>` |
| `sections` | `Array<{
    startLine: number;
    endLine: number;
    summary: string; // What this section does
    entities: string[]; // Entity names in this section
  }>` |
| `criticalExtracts` | `Array<{
    entityName: string;
    reason: 'validation' | 'error_messages' | 'permissions' | 'state_machine';
    content: string; // Full source code
  }>` |

<!-- source: api-endpoint-listrepos.md -->

# listRepos

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/bitbucket/bitbucket.controller.ts` (line 75)

## Endpoint

`GET /bitbucket/repos`

## Referenced By

- `BitbucketController` (MODULE_DECLARES)

<!-- source: constant-universal-api-call-patterns.md -->

# UNIVERSAL_API_CALL_PATTERNS

**Kind:** Constant

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/cross-language.types.ts` (line 212)

## Definition

```ts
ApiCallPattern[]
```

<!-- source: component-dashboardpage.md -->

# DashboardPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/page.tsx` (line 17)

## Diagram

```mermaid
graph TD
    component_DashboardPage_736be54b["DashboardPage"]
    class component_DashboardPage_736be54b rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `NewProjectWizard`
- RENDERS → `Link`
- RENDERS → `FolderIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useProjects`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-largefileindexerconfig.md -->

# LargeFileIndexerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/large-file-indexer.ts` (line 23)

Configuration for large file indexing

## Properties

| Property | Type |
|---|---|
| `sizeThreshold` | `number` |
| `maxOverviewLines` | `number` |
| `maxCriticalExtracts` | `number` |

<!-- source: api-endpoint-listrepos-2.md -->

# listRepos

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/github/github.controller.ts` (line 89)

List repositories from the connected GitHub account

## Endpoint

`GET /github/repos`

## Referenced By

- `GitHubController` (MODULE_DECLARES)

<!-- source: constant-updatelink.md -->

# updateLink$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 268)

A signal that updates the current link with the published payload.

<!-- source: component-dashboardtabbar.md -->

# DashboardTabBar

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/dashboard/DashboardTabBar.tsx` (line 11)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `activeTab` | `string` | ✓ | - |
| `onTabChange` | `Function` | ✓ | - |
| `projectId` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_DashboardTabBar_3fa6f1d8["DashboardTabBar"]
    class component_DashboardTabBar_3fa6f1d8 rootComponent
```

<!-- source: interface-largefilesummary.md -->

# LargeFileSummary

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-02.types.ts` (line 44)

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `fileSize` | `number` |
| `summary` | `string` |
| `exports` | `Array<{
    name: string;
    type: string;
    signature: string;
  }>` |
| `purpose` | `string` |

<!-- source: api-endpoint-listrepos-3.md -->

# listRepos

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/gitlab/gitlab.controller.ts` (line 89)

List repositories from the connected GitLab account

## Endpoint

`GET /gitlab/repos`

## Referenced By

- `GitLabController` (MODULE_DECLARES)

<!-- source: constant-usedlexicalnodes.md -->

# usedLexicalNodes$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 279)

Contains the currently registered lexical nodes.

<!-- source: component-deflectioncockpit.md -->

# DeflectionCockpit

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/analytics/DeflectionCockpit.tsx` (line 110)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DeflectionCockpit_678306f1["DeflectionCockpit"]
    class component_DeflectionCockpit_678306f1 rootComponent
```

## Relationships

- RENDERS → `KpiCard`
- RENDERS → `LineChart`
- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-learningpathdocinput.md -->

# LearningPathDocInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 99)

## Properties

| Property | Type |
|---|---|
| `appName` | `string` |
| `persona` | `{
    name: string;
    description: string;
    goals?: string[];
    relevantFeatures?: string[];
  }` |
| `matchedDocs` | `MatchedDocForPath[]` |

<!-- source: api-endpoint-listscreenshots.md -->

# listScreenshots

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/screenshot/screenshot.controller.ts` (line 51)

## Endpoint

`GET /screenshots`

| Parameter | In | Type | Required |
|---|---|---|---|
| `filters` | query | `ScreenshotFiltersDto` | ✓ |

## Referenced By

- `ScreenshotController` (MODULE_DECLARES)

<!-- source: constant-viewmode.md -->

# viewMode$

**Kind:** Constant

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/index.ts` (line 860)

<!-- source: component-deleteboarddialog.md -->

# DeleteBoardDialog

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/DeleteBoardDialog.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `open` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `board` | `unknown | null` | ✓ | - |
| `onDeleted` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_DeleteBoardDialog_74c76980["DeleteBoardDialog"]
    class component_DeleteBoardDialog_74c76980 rootComponent
```

## Relationships

- RENDERS → `Modal`
- RENDERS → `TrashIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useBoardsToast`
- USES_HOOK → `useState`

<!-- source: interface-lexicalconvertoptions.md -->

# LexicalConvertOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/exportMarkdownFromLexical.ts` (line 409)

Configures how the lexical tree is converted to a mdast tree and then to markdown.

## Properties

| Property | Type |
|---|---|
| `visitors` | `LexicalVisitor[]` |
| `toMarkdownExtensions` | `ToMarkdownExtension[]` |
| `toMarkdownOptions` | `ToMarkdownOptions` |

<!-- source: api-endpoint-listsources.md -->

# listSources

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 224)

## Endpoint

`GET /technical-docs/:projectId/sources`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-deletecategorymodal.md -->

# DeleteCategoryModal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Categories/CategoryModal.tsx` (line 288)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `isOpen` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `onConfirm` | `Function` | ✓ | - |
| `category` | `Category | null` | ✓ | - |
| `loading` | `boolean` | - | - |

## Diagram

```mermaid
graph TD
    component_DeleteCategoryModal_7c6ea866["DeleteCategoryModal"]
    class component_DeleteCategoryModal_7c6ea866 rootComponent
```

<!-- source: interface-lexicalexportvisitor.md -->

# LexicalExportVisitor

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/exportMarkdownFromLexical.ts` (line 17)

Implement this interface in order to process mdast node(s) into a lexical tree.
This is part of the process that converts the editor contents to markdown.

## Properties

| Property | Type |
|---|---|
| `priority` | `number` |

<!-- source: api-endpoint-listthreads.md -->

# listThreads

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/desk.controller.ts` (line 33)

## Endpoint

`GET /desk/:projectId/threads`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `bucket` | query | `string` | - |
| `limit` | query | `string` | - |

## Referenced By

- `DeskController` (MODULE_DECLARES)

<!-- source: component-deletedocumentmodal.md -->

# DeleteDocumentModal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Documents/DeleteDocumentModal.tsx` (line 14)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `isOpen` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `onConfirm` | `Function` | ✓ | - |
| `document` | `Document | null` | ✓ | - |
| `loading` | `boolean` | - | - |

## Diagram

```mermaid
graph TD
    component_DeleteDocumentModal_13b2853d["DeleteDocumentModal"]
    class component_DeleteDocumentModal_13b2853d rootComponent
```

## Relationships

- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `XMarkIcon`

<!-- source: interface-lineheight.md -->

# LineHeight

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 60)

## Properties

| Property | Type |
|---|---|
| `tight` | `number` |
| `normal` | `number` |
| `relaxed` | `number` |

<!-- source: api-endpoint-login-2.md -->

# login

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/auth.controller.ts` (line 48)

## Endpoint

`POST /auth/login`

## Referenced By

- `AuthController` (MODULE_DECLARES)

<!-- source: component-deleteprojectmodal.md -->

# DeleteProjectModal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/DeleteProjectModal.tsx` (line 14)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `project` | `Project | null` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `onConfirm` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DeleteProjectModal_4733800["DeleteProjectModal"]
    class component_DeleteProjectModal_4733800 rootComponent
```

## Relationships

- RENDERS → `AnimatePresence`
- RENDERS → `motion-div`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-localeinfo.md -->

# LocaleInfo

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/i18n.tsx` (line 21)

## Properties

| Property | Type |
|---|---|
| `code` | `string` |
| `name` | `string` |
| `nativeName` | `string` |
| `dir` | `'ltr' | 'rtl'` |

<!-- source: api-endpoint-login-3.md -->

# login

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/saml/saml.controller.ts` (line 18)

Initiate SAML login
User is redirected to their IdP for authentication

## Endpoint

`GET /auth/saml/login/:orgSlug`

| Parameter | In | Type | Required |
|---|---|---|---|
| `orgSlug` | query | `string` | ✓ |

## Referenced By

- `SamlController` (MODULE_DECLARES)

<!-- source: component-dependencygraph.md -->

# DependencyGraph

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/DependencyGraph.tsx` (line 13)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `dependencies` | `Dependency[]` | ✓ | - |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_DependencyGraph_552a8292["DependencyGraph"]
    class component_DependencyGraph_552a8292 rootComponent
```

## Relationships

- RENDERS → `ExternalIcon`
- RENDERS → `DependencyCard`
- RENDERS → `InternalIcon`

<!-- source: interface-logentry.md -->

# LogEntry

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/logger.ts` (line 10)

## Properties

| Property | Type |
|---|---|
| `timestamp` | `Date` |
| `level` | `LogLevel` |
| `stage` | `string` |
| `message` | `string` |
| `data` | `Record<string, unknown>` |
| `error` | `Error` |

<!-- source: api-endpoint-logout.md -->

# logout

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/auth.controller.ts` (line 127)

## Endpoint

`POST /auth/logout`

## Referenced By

- `AuthController` (MODULE_DECLARES)

<!-- source: component-deskcopilot.md -->

# DeskCopilot

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/DeskCopilot.tsx` (line 552)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `thread` | `DeskThreadDetail | null` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DeskCopilot_19c1892a["DeskCopilot"]
    class component_DeskCopilot_19c1892a rootComponent
```

## Relationships

- RENDERS → `ChatBubbleLeftEllipsisIcon`
- RENDERS → `CopilotTabBody`
- RENDERS → `CustomerTabBody`
- RENDERS → `ActivityTabBody`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-loggerconfig.md -->

# LoggerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/logger.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `level` | `LogLevel` |
| `prefix` | `string` |
| `includeTimestamp` | `boolean` |
| `includeStage` | `boolean` |
| `silent` | `boolean` |

<!-- source: api-endpoint-markread.md -->

# markRead

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/notification/notification.controller.ts` (line 35)

## Endpoint

`PATCH /notifications/:id/read`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `NotificationController` (MODULE_DECLARES)

<!-- source: component-deskpage.md -->

# DeskPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/page.tsx` (line 49)

## Diagram

```mermaid
graph TD
    component_DeskPage_6149f886["DeskPage"]
    class component_DeskPage_6149f886 rootComponent
```

## Relationships

- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `QueueRail`
- RENDERS → `ThreadList`
- RENDERS → `ThreadView`
- RENDERS → `DeskCopilot`
- RENDERS → `SnoozeMenu`
- RENDERS → `DuplicateDialog`
- RENDERS → `ShortcutOverlay`
- RENDERS → `DeskToast`
- USES_HOOK → `useSession`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useMemo`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-logindto.md -->

# LoginDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/auth.ts` (line 6)

Auth DTOs

## Properties

| Property | Type |
|---|---|
| `email` | `string` |
| `password` | `string` |

<!-- source: api-endpoint-mcpget.md -->

# mcpGet

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 335)

## Endpoint

`GET /public/p/:slugWithId/mcp`

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: component-desktoast.md -->

# DeskToast

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/DeskDialogs.tsx` (line 248)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `toast` | `unknown | null` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DeskToast_7c09524e["DeskToast"]
    class component_DeskToast_7c09524e rootComponent
```

<!-- source: interface-mappingoptions.md -->

# MappingOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-mapper.service.ts` (line 45)

Options for mapping placeholders

## Properties

| Property | Type |
|---|---|
| `siteUrl` | `string` |
| `appName` | `string` |
| `knownRoutes` | `string[]` |
| `batchSize` | `number` |
| `confidenceThreshold` | `number` |
| `routeMappings` | `RouteMappingResult` |
| `framework` | `string` |

<!-- source: api-endpoint-mcpget-2.md -->

# mcpGet

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-mcp.controller.ts` (line 203)

## Endpoint

`GET /technical-docs/:projectId/mcp`

## Referenced By

- `TechnicalDocsMcpController` (MODULE_DECLARES)

<!-- source: component-docmeta.md -->

# DocMeta

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/DocMeta.tsx` (line 18)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `content` | `string` | ✓ | - |
| `updatedAt` | `string | Date` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DocMeta_54e453ca["DocMeta"]
    class component_DocMeta_54e453ca rootComponent
```

## Relationships

- RENDERS → `ClockIcon`
- RENDERS → `CalendarDaysIcon`
- USES_HOOK → `useLanguageContext`

<!-- source: interface-mappingresult.md -->

# MappingResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 158)

Result of AI mapping stage

## Properties

| Property | Type |
|---|---|
| `mappings` | `ScreenshotMapping[]` |
| `unmapped` | `{ placeholderId: string; description: string; reason: string }[]` |
| `lowConfidence` | `ScreenshotMapping[]` |
| `tokenUsage` | `TokenUsage` |

<!-- source: api-endpoint-movecard.md -->

# moveCard

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 164)

## Endpoint

`PATCH /projects/:projectId/boards/:boardId/cards/:cardId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `boardId` | query | `string` | ✓ |
| `cardId` | query | `string` | ✓ |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: component-docpage.md -->

# DocPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/doc/[...segments]/page.tsx` (line 134)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DocPage_2e26b721["DocPage"]
    class component_DocPage_2e26b721 rootComponent
```

## Relationships

- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `TableOfContents`
- RENDERS → `MDXEditor`
- USES_HOOK → `useSession`
- USES_HOOK → `useDocContext`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useMemo`
- USES_HOOK → `useEffect`

<!-- source: interface-markdownparseoptions.md -->

# MarkdownParseOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/importMarkdownToLexical.ts` (line 140)

## Properties

| Property | Type |
|---|---|
| `markdown` | `string` |
| `syntaxExtensions` | `NonNullable<ParseOptions['extensions']>` |
| `mdastExtensions` | `MdastExtensions` |

<!-- source: api-endpoint-overview.md -->

# overview

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/ops/ops.controller.ts` (line 15)

## Endpoint

`GET /ops/overview`

## Referenced By

- `OpsController` (MODULE_DECLARES)

<!-- source: component-docprovider.md -->

# DocProvider

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/doc/[...segments]/doc-context.tsx` (line 46)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DocProvider_3b2b1910["DocProvider"]
    class component_DocProvider_3b2b1910 rootComponent
```

## Relationships

- RENDERS → `DocContext-Provider`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-matcheddocforpath.md -->

# MatchedDocForPath

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 110)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `difficulty` | `string` |
| `estimatedReadTime` | `number` |
| `prerequisites` | `string[]` |
| `featureIds` | `string[]` |
| `priority` | `number` |

<!-- source: api-endpoint-parse.md -->

# parse

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/parser/parser.controller.ts` (line 16)

## Endpoint

`POST /parser/parse`

## Referenced By

- `ParserController` (MODULE_DECLARES)

<!-- source: component-documentcard.md -->

# DocumentCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Documents/DocumentCard.tsx` (line 18)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `document` | `unknown` | ✓ | - |
| `onDelete` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_DocumentCard_5fc3e2f["DocumentCard"]
    class component_DocumentCard_5fc3e2f rootComponent
```

## Relationships

- RENDERS → `PencilIcon`
- RENDERS → `TrashIcon`
- USES_HOOK → `useRouter`

<!-- source: interface-mdastblockhtmlnode.md -->

# MdastBlockHTMLNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/MdastHTMLNode.ts` (line 8)

A block-level HTML node.

## Properties

| Property | Type |
|---|---|
| `name` | `(typeof htmlTags)[number]` |

<!-- source: api-endpoint-parsedocument.md -->

# parseDocument

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/parser/parser.controller.ts` (line 22)

## Endpoint

`POST /parser/document/:id/parse`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ParserController` (MODULE_DECLARES)

<!-- source: component-documenteditor.md -->

# DocumentEditor

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/DocumentEditor.tsx` (line 156)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `content` | `string` | ✓ | - |
| `onChange` | `Function` | ✓ | - |
| `editable` | `boolean` | - | true |
| `originalContent` | `string` | - | - |
| `previewMode` | `boolean` | - | false |
| `selectedAudiences` | `string[]` | - | [] |
| `documentId` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_DocumentEditor_702dfdfa["DocumentEditor"]
    class component_DocumentEditor_702dfdfa rootComponent
```

## Relationships

- RENDERS → `AudiencePreviewPanel`
- RENDERS → `MDXEditor`
- RENDERS → `KitchenSinkToolbar`
- RENDERS → `Separator`
- RENDERS → `InsertAudienceButton`
- USES_HOOK → `useRef`
- USES_HOOK → `useImageUpload`
- USES_HOOK → `useSession`
- USES_HOOK → `useAudiences`
- USES_HOOK → `useMemo`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-mdastimportvisitor.md -->

# MdastImportVisitor

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/importMarkdownToLexical.ts` (line 42)

Implement this interface to convert certain mdast nodes into lexical nodes.

## Properties

| Property | Type |
|---|---|
| `testNode` | `((mdastNode: Mdast.Nodes, descriptors: Descriptors) => boolean) | string` |
| `priority` | `number` |

<!-- source: api-endpoint-parseproject-2.md -->

# parseProject

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/parsing/parsing.controller.ts` (line 15)

## Endpoint

`POST /projects/:projectId/parse`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `ParsingController` (MODULE_DECLARES)

<!-- source: component-documentlayout.md -->

# DocumentLayout

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/doc/[...segments]/layout.tsx` (line 207)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DocumentLayout_10c8777a["DocumentLayout"]
    class component_DocumentLayout_10c8777a rootComponent
```

## Relationships

- RENDERS → `DocProvider`
- RENDERS → `DocumentLayoutInner`

<!-- source: interface-mdastinlinehtmlnode.md -->

# MdastInlineHTMLNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/MdastHTMLNode.ts` (line 19)

An inline HTML node.

## Properties

| Property | Type |
|---|---|
| `name` | `(typeof htmlTags)[number]` |

<!-- source: api-endpoint-playgroundproxy.md -->

# playgroundProxy

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-mcp.controller.ts` (line 438)

## Endpoint

`POST /technical-docs/:projectId/playground/proxy`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsMcpController` (MODULE_DECLARES)

<!-- source: component-documentlayout-2.md -->

# DocumentLayout

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Layout/DocumentLayout.tsx` (line 30)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |
| `organizationId` | `string` | ✓ | - |
| `projectId` | `string` | ✓ | - |
| `activeDocumentId` | `string` | - | - |
| `className` | `string` | - | - |
| `onNavigate` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_DocumentLayout_739b223["DocumentLayout"]
    class component_DocumentLayout_739b223 rootComponent
```

## Relationships

- RENDERS → `NavigationTree`
- RENDERS → `MobileNavigation`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-mdasttreeimportoptions.md -->

# MdastTreeImportOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/importMarkdownToLexical.ts` (line 133)

The options of the tree import utility. Not meant to be used directly.

## Properties

| Property | Type |
|---|---|
| `root` | `ImportPoint` |
| `visitors` | `MdastImportVisitor<Mdast.RootContent>[]` |
| `mdastRoot` | `Mdast.Root` |

<!-- source: api-endpoint-portal.md -->

# portal

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/billing/billing.controller.ts` (line 41)

## Endpoint

`GET /billing/portal`

## Referenced By

- `BillingController` (MODULE_DECLARES)

<!-- source: component-documentlist.md -->

# DocumentList

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Documents/DocumentList.tsx` (line 32)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | - | - |
| `categoryId` | `string | null` | - | - |
| `documents` | `any[]` | ✓ | - |
| `loading` | `boolean` | ✓ | - |
| `error` | `Error | null` | ✓ | - |
| `totalCount` | `number` | ✓ | - |
| `onFiltersChange` | `Function` | ✓ | - |
| `onCreateDocument` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_DocumentList_6733cd4b["DocumentList"]
    class component_DocumentList_6733cd4b rootComponent
```

## Relationships

- RENDERS → `SearchBar`
- RENDERS → `SortControl`
- RENDERS → `ViewToggle`
- RENDERS → `FilterChips`
- RENDERS → `LoadingGrid`
- RENDERS → `ErrorState`
- RENDERS → `EmptyState`
- RENDERS → `DocumentCard`
- RENDERS → `DocumentListItem`
- RENDERS → `Pagination`
- RENDERS → `DeleteDocumentModal`
- USES_HOOK → `useRouter`
- USES_HOOK → `useSearchParams`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useRef`
- USES_HOOK → `useCallback`

<!-- source: interface-mdxeditormethods.md -->

# MDXEditorMethods

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/MDXEditor.tsx` (line 140)

## Properties

| Property | Type |
|---|---|
| `getMarkdown` | `() => string` |
| `setMarkdown` | `(value: string) => void` |
| `insertMarkdown` | `(value: string) => void` |
| `focus` | `(
    callbackFn?: (() => void) | undefined,
    opts?: {
      defaultSelection?: 'rootStart' | 'rootEnd'
      preventScroll?: boolean
    }
  ) => void` |
| `getContentEditableHTML` | `() => string` |
| `getSelectionMarkdown` | `() => string` |

<!-- source: api-endpoint-previewscreenshot.md -->

# previewScreenshot

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 267)

## Endpoint

`POST /doc-versions/:projectId/:versionId/screenshots/preview`

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-documentlistitem.md -->

# DocumentListItem

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Documents/DocumentListItem.tsx` (line 17)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `document` | `unknown` | ✓ | - |
| `onDelete` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_DocumentListItem_63ee54cf["DocumentListItem"]
    class component_DocumentListItem_63ee54cf rootComponent
```

## Relationships

- RENDERS → `PencilIcon`
- RENDERS → `TrashIcon`
- USES_HOOK → `useRouter`

<!-- source: interface-mdxeditorprops.md -->

# MDXEditorProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/MDXEditor.tsx` (line 300)

## Properties

| Property | Type |
|---|---|
| `contentEditableClassName` | `string` |
| `spellCheck` | `boolean` |
| `markdown` | `string` |
| `onChange` | `(markdown: string, initialMarkdownNormalize: boolean) => void` |
| `onError` | `(payload: { error: string; source: string }) => void` |
| `toMarkdownOptions` | `ToMarkdownOptions` |
| `plugins` | `RealmPlugin[]` |
| `className` | `string` |
| `autoFocus` | `boolean | { defaultSelection?: 'rootStart' | 'rootEnd'; preventScroll?: boolean }` |
| `onBlur` | `(e: FocusEvent) => void` |
| `placeholder` | `React.ReactNode` |
| `readOnly` | `boolean` |
| `iconComponentFor` | `(name: IconKey) => JSX.Element` |
| `suppressHtmlProcessing` | `boolean` |
| `translation` | `Translation` |
| `trim` | `boolean` |
| `lexicalTheme` | `EditorThemeClasses` |
| `overlayContainer` | `HTMLElement | null` |
| `suppressSharedHistory` | `boolean` |
| `editorState` | `EditorState | undefined | null` |
| `additionalLexicalNodes` | `AdditionalLexicalNode[]` |
| `lexicalEditorNamespace` | `string` |

<!-- source: api-endpoint-publicsearch.md -->

# publicSearch

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 1030)

## Endpoint

`GET /public/p/:slugWithId/search`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |
| `q` | query | `string` | ✓ |
| `limit` | query | `string` | - |
| `version` | query | `string` | - |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: component-documentpage.md -->

# DocumentPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/documents/[id]/page.tsx` (line 13)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DocumentPage_12029c29["DocumentPage"]
    class component_DocumentPage_12029c29 rootComponent
```

## Relationships

- RENDERS → `DocumentViewer`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useDocument`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-megafiledetectionresult.md -->

# MegaFileDetectionResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/mega-file.types.ts` (line 147)

Strategy for determining which phased approach to use

## Properties

| Property | Type |
|---|---|
| `isMegaFile` | `boolean` |
| `reason` | `string` |
| `fileSize` | `number` |
| `lineCount` | `number` |
| `suggestedStrategy` | `MegaFileStrategy | null` |

<!-- source: api-endpoint-publish.md -->

# publish

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 171)

## Endpoint

`POST /doc-versions/:projectId/:versionId/publish`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-documentsettingsdrawer.md -->

# DocumentSettingsDrawer

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Document/DocumentSettingsDrawer.tsx` (line 18)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `isOpen` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `canRegenerate` | `boolean` | ✓ | - |
| `kgEntityId` | `string` | ✓ | - |
| `kgEntityType` | `string` | ✓ | - |
| `onSave` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DocumentSettingsDrawer_15d260da["DocumentSettingsDrawer"]
    class component_DocumentSettingsDrawer_15d260da rootComponent
```

## Relationships

- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-megafileindex.md -->

# MegaFileIndex

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/mega-file.types.ts` (line 115)

Mega-file index - Enhanced version of LargeFileIndex for 600KB+ files

## Properties

| Property | Type |
|---|---|
| `isMegaFile` | `true` |
| `phaseExtractions` | `Array<{
    phase: number;
    name: string;
    tokenCount: number;
    content: string; // Extracted content for this phase
    entityNames: string[]; // Entities found in this phase
  }>` |
| `crossPhaseReferences` | `Array<{
    fromPhase: number;
    toPhase: number;
    reference: string; // Method/variable name
    type: 'calls' | 'uses' | 'extends';
  }>` |

<!-- source: api-endpoint-publish-2.md -->

# publish

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 363)

## Endpoint

`POST /documents/:id/publish`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: component-documentspage.md -->

# DocumentsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/documents/page.tsx` (line 20)

## Diagram

```mermaid
graph TD
    component_DocumentsPage_5a3064d8["DocumentsPage"]
    class component_DocumentsPage_5a3064d8 rootComponent
```

## Relationships

- RENDERS → `CategoryTreeSidebar`
- RENDERS → `SortableDocumentList`
- RENDERS → `DocumentList`
- RENDERS → `CategoryModal`
- RENDERS → `DeleteCategoryModal`
- RENDERS → `ErrorState`
- USES_HOOK → `useRouter`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useProjectContext`
- USES_HOOK → `useState`
- USES_HOOK → `useVersionContext`
- USES_HOOK → `useEffect`
- USES_HOOK → `useDocuments`
- USES_HOOK → `useCallback`

<!-- source: interface-megafileindexerconfig.md -->

# MegaFileIndexerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/mega-file-indexer.ts` (line 26)

Configuration for mega file indexing

## Properties

| Property | Type |
|---|---|
| `sizeThreshold` | `number` |
| `lineThreshold` | `number` |
| `phases` | `MegaFilePhase[]` |

<!-- source: api-endpoint-publish-3.md -->

# publish

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 314)

## Endpoint

`POST /projects/:id/publish`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: component-documenttoc.md -->

# DocumentToC

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/PublishingSidebar/DocumentToC.tsx` (line 28)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `content` | `string` | ✓ | - |
| `title` | `string` | ✓ | - |
| `loading` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_DocumentToC_725ad64e["DocumentToC"]
    class component_DocumentToC_725ad64e rootComponent
```

## Relationships

- RENDERS → `FileText`
- RENDERS → `ChevronDown`
- RENDERS → `ChevronRight`
- USES_HOOK → `useState`
- USES_HOOK → `useMemo`
- USES_HOOK → `useEffect`

<!-- source: interface-megafilephase.md -->

# MegaFilePhase

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/mega-file.types.ts` (line 31)

## Properties

| Property | Type |
|---|---|
| `phase` | `number` |
| `name` | `string` |
| `description` | `string` |
| `extractPatterns` | `RegExp[]` |
| `maxTokens` | `number` |

<!-- source: api-endpoint-query.md -->

# query

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/audit/audit.controller.ts` (line 15)

## Endpoint

`GET /audit/:projectId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `action` | query | `string` | - |
| `actorId` | query | `string` | - |
| `startDate` | query | `string` | - |
| `endDate` | query | `string` | - |
| `limit` | query | `string` | - |
| `offset` | query | `string` | - |

## Referenced By

- `AuditController` (MODULE_DECLARES)

<!-- source: component-documentviewer.md -->

# DocumentViewer

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/DocumentViewer.tsx` (line 35)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `document` | `unknown` | ✓ | - |
| `capturedScreenshots` | `Record` | - | - |

## Diagram

```mermaid
graph TD
    component_DocumentViewer_24e17c0b["DocumentViewer"]
    class component_DocumentViewer_24e17c0b rootComponent
```

## Relationships

- RENDERS → `ViewerHeader`
- RENDERS → `MarkdownRenderer`
- RENDERS → `ViewerFooter`
- RENDERS → `TableOfContents`
- USES_HOOK → `useMemo`

<!-- source: interface-megafilephaseextractionresult.md -->

# MegaFilePhaseExtractionResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/mega-file.types.ts` (line 158)

Result of mega-file phase extraction

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `phases` | `Array<{
    phase: MegaFilePhase;
    extractedContent: string;
    tokenCount: number;
    entityCount: number;
    success: boolean;
    error?: string;
  }>` |
| `totalTokens` | `number` |
| `coveragePercent` | `number` |

<!-- source: api-endpoint-ragindex.md -->

# ragIndex

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-mcp.controller.ts` (line 83)

## Endpoint

`POST /technical-docs/:projectId/rag/index`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsMcpController` (MODULE_DECLARES)

<!-- source: component-domainstatuschip.md -->

# DomainStatusChip

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Domains/DomainStatusChip.tsx` (line 57)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `status` | `DomainStatus` | ✓ | - |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_DomainStatusChip_7eb6346["DomainStatusChip"]
    class component_DomainStatusChip_7eb6346 rootComponent
```

<!-- source: interface-megafilestrategy.md -->

# MegaFileStrategy

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/mega-file.types.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `sizeThreshold` | `number` |
| `lineThreshold` | `number` |
| `phases` | `MegaFilePhase[]` |

<!-- source: api-endpoint-readall.md -->

# readAll

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/notification/notification.controller.ts` (line 41)

## Endpoint

`POST /notifications/read-all`

## Referenced By

- `NotificationController` (MODULE_DECLARES)

<!-- source: component-domaintab.md -->

# DomainTab

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Domains/DomainTab.tsx` (line 854)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `publishedSlug` | `string | null` | ✓ | - |
| `onToast` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DomainTab_7a023614["DomainTab"]
    class component_DomainTab_7a023614 rootComponent
```

## Relationships

- RENDERS → `SubdomainCard`
- RENDERS → `CustomDomainCard`

<!-- source: interface-metacategoryreference.md -->

# MetaCategoryReference

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/knowledge-reference.types.ts` (line 53)

## Properties

| Property | Type |
|---|---|
| `category` | `MetaKnowledgeCategory` |
| `entries` | `KnowledgeEntry[]` |
| `stats` | `{
    totalEntries: number;
    totalSnippets: number;
    uniqueSourceDocs: number;
    avgConfidence: number;
  }` |

<!-- source: api-endpoint-record.md -->

# record

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/events/events.controller.ts` (line 24)

## Endpoint

`POST /events`

## Referenced By

- `EventsController` (MODULE_DECLARES)

<!-- source: component-donutchart.md -->

# DonutChart

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/DonutChart.tsx` (line 54)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `data` | `DonutDatum[]` | ✓ | - |
| `loading` | `boolean` | - | false |
| `centerLabel` | `string` | - | - |
| `colors` | `string[]` | - | unknown |
| `emptyMessage` | `string` | - | "No data yet" |
| `maxSlices` | `number` | - | 6 |

## Diagram

```mermaid
graph TD
    component_DonutChart_24b992bd["DonutChart"]
    class component_DonutChart_24b992bd rootComponent
```

## Relationships

- RENDERS → `ResponsiveContainer`
- RENDERS → `PieChart`
- RENDERS → `Pie`
- RENDERS → `Cell`
- RENDERS → `Tooltip`
- RENDERS → `CustomTooltip`

<!-- source: interface-metadocstats.md -->

# MetaDocStats

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 60)

## Properties

| Property | Type |
|---|---|
| `categoriesCreated` | `number` |
| `categoriesMoved` | `number` |
| `metaDocsGenerated` | `number` |
| `aiCallsMade` | `number` |
| `totalTokens` | `number` |
| `adminDocsFound` | `number` |
| `personaPathsGenerated` | `number` |

<!-- source: api-endpoint-recordpublicchatfeedback.md -->

# recordPublicChatFeedback

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 911)

## Endpoint

`POST /public/p/:slugWithId/chat/feedback`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: component-duplicatedialog.md -->

# DuplicateDialog

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/DeskDialogs.tsx` (line 102)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `ticketNumber` | `number` | ✓ | - |
| `busy` | `boolean` | ✓ | - |
| `onSubmit` | `Function` | ✓ | - |
| `onClose` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_DuplicateDialog_774f45d7["DuplicateDialog"]
    class component_DuplicateDialog_774f45d7 rootComponent
```

## Relationships

- RENDERS → `Backdrop`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-metadocumentationconfig.md -->

# MetaDocumentationConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `skipMetaDocGeneration` | `boolean` |
| `maxConcurrency` | `number` |
| `temperature` | `number` |
| `maxOutputTokens` | `number` |

<!-- source: api-endpoint-recordpublicchatresolution.md -->

# recordPublicChatResolution

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/public-project.controller.ts` (line 951)

## Endpoint

`POST /public/p/:slugWithId/chat/resolution`

| Parameter | In | Type | Required |
|---|---|---|---|
| `slugWithId` | query | `string` | ✓ |

## Referenced By

- `PublicProjectController` (MODULE_DECLARES)

<!-- source: component-editdocumentpage.md -->

# EditDocumentPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/documents/[id]/edit/page.tsx` (line 78)

## Diagram

```mermaid
graph TD
    component_EditDocumentPage_1d1bc2e0["EditDocumentPage"]
    class component_EditDocumentPage_1d1bc2e0 rootComponent
```

## Relationships

- RENDERS → `Clock`
- RENDERS → `MessageCircle`
- RENDERS → `PublishButton`
- RENDERS → `Pencil`
- RENDERS → `CollaborativeDocumentEditor`
- RENDERS → `DocumentEditor`
- RENDERS → `CommentMarkers`
- RENDERS → `Check`
- RENDERS → `Copy`
- RENDERS → `ExternalLink`
- RENDERS → `Eye`
- RENDERS → `Users`
- RENDERS → `SaveAsTemplateButton`
- RENDERS → `DocumentSettingsDrawer`
- RENDERS → `CommentSidebar`
- RENDERS → `AnimatePresence`
- RENDERS → `VersionHistoryPanel`
- USES_HOOK → `useRouter`
- USES_HOOK → `useParams`
- USES_HOOK → `useSearchParams`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useComments`
- USES_HOOK → `useAudiences`
- USES_HOOK → `useMemo`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-metadocumentationinput.md -->

# MetaDocumentationInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 38)

## Properties

| Property | Type |
|---|---|
| `appName` | `string` |
| `synthesis` | `{
    summary: string;
    personas: MetaDocumentationPersona[];
    featureAreas: Array<{ name: string; description: string; modules: string[] }>;
    crossModuleRelationships: Array<{ from: string; to: string; description: string }>;
  }` |
| `existingCategories` | `DocumentCategoryStructure[]` |
| `existingDocuments` | `PlannedDocument[]` |
| `generatedDocuments` | `GeneratedDocument[]` |
| `knowledgeReferences` | `KnowledgeReferenceStore` |

<!-- source: api-endpoint-refresh.md -->

# refresh

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/auth.controller.ts` (line 66)

## Endpoint

`POST /auth/refresh`

## Referenced By

- `AuthController` (MODULE_DECLARES)

<!-- source: component-editortoolbar.md -->

# EditorToolbar

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/EditorToolbar.tsx` (line 9)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `editor` | `Editor` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_EditorToolbar_7d08cec0["EditorToolbar"]
    class component_EditorToolbar_7d08cec0 rootComponent
```

## Relationships

- RENDERS → `ToolbarButton`

<!-- source: interface-metadocumentationpersona.md -->

# MetaDocumentationPersona

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 30)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `id` | `string` |
| `goals` | `string[]` |
| `relevantFeatures` | `string[]` |

<!-- source: api-endpoint-register.md -->

# register

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/auth.controller.ts` (line 26)

## Endpoint

`POST /auth/register`

## Referenced By

- `AuthController` (MODULE_DECLARES)

<!-- source: component-emailverificationbanner.md -->

# EmailVerificationBanner

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/EmailVerificationBanner.tsx` (line 12)

## Diagram

```mermaid
graph TD
    component_EmailVerificationBanner_55803c2c["EmailVerificationBanner"]
    class component_EmailVerificationBanner_55803c2c rootComponent
```

## Relationships

- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-metadocumentationresult.md -->

# MetaDocumentationResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 52)

## Properties

| Property | Type |
|---|---|
| `restructuredCategories` | `DocumentCategoryStructure[]` |
| `restructuredDocuments` | `PlannedDocument[]` |
| `newDocuments` | `GeneratedDocument[]` |
| `tokenUsage` | `{ promptTokens: number; completionTokens: number; totalTokens: number }` |
| `stats` | `MetaDocStats` |

<!-- source: api-endpoint-reindexdocuments.md -->

# reindexDocuments

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/sync.controller.ts` (line 71)

## Endpoint

`POST /projects/:projectId/documents/reindex`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `SyncController` (MODULE_DECLARES)

<!-- source: component-embedcodegenerator.md -->

# EmbedCodeGenerator

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/EmbedCodeGenerator.tsx` (line 16)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `agentSlug` | `string` | - | "default" |
| `primaryColor` | `string` | - | "#0891B2" |
| `agentEnabled` | `boolean` | - | - |

## Diagram

```mermaid
graph TD
    component_EmbedCodeGenerator_5fb33733["EmbedCodeGenerator"]
    class component_EmbedCodeGenerator_5fb33733 rootComponent
```

## Relationships

- RENDERS → `Globe`
- RENDERS → `Link`
- RENDERS → `Icon`
- RENDERS → `AlertTriangle`
- RENDERS → `Check`
- RENDERS → `Copy`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-milestone-2.md -->

# Milestone

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/social-proof/social-proof-timeline.tsx` (line 11)

## Properties

| Property | Type |
|---|---|
| `dateKey` | `string` |
| `titleKey` | `string` |
| `descriptionKey` | `string` |

<!-- source: api-endpoint-reject.md -->

# reject

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 606)

## Endpoint

`POST /doc-versions/:projectId/:versionId/approval/reject`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-emptystate-2.md -->

# EmptyState

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Templates/TemplateGallery.tsx` (line 176)

Empty state component

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `category` | `TemplateCategory | unknown` | ✓ | - |
| `searchQuery` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_EmptyState_45a47a7a["EmptyState"]
    class component_EmptyState_45a47a7a rootComponent
```

## Relationships

- RENDERS → `FileText`

<!-- source: interface-modalcapturespec.md -->

# ModalCaptureSpec

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/screenshot-spec.types.ts` (line 92)

Modal capture specification

## Properties

| Property | Type |
|---|---|
| `modalName` | `string` |
| `triggerSelector` | `string` |
| `triggerText` | `string` |
| `closeMethod` | `'button-text' | 'data-dismiss' | 'escape'` |
| `closeButtonTexts` | `string[]` |

<!-- source: api-endpoint-reject-2.md -->

# reject

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/suggestion/suggestion.controller.ts` (line 38)

## Endpoint

`POST /documents/:documentId/suggestions/:id/reject`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `SuggestionController` (MODULE_DECLARES)

<!-- source: component-emptystate-3.md -->

# EmptyState

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/common/EmptyState.tsx` (line 151)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `type` | `EmptyStateType` | ✓ | - |
| `searchQuery` | `string` | - | - |
| `onAction` | `Function` | - | - |
| `actionLabel` | `string` | - | - |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_EmptyState_43e558a0["EmptyState"]
    class component_EmptyState_43e558a0 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Icon`
- RENDERS → `motion-button`
- RENDERS → `PlusCircleIcon`

<!-- source: interface-modaldefinition-2.md -->

# ModalDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 23)

A modal/popup/dialog discovered in source code

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `title` | `string` |
| `triggerType` | `ModalTriggerType` |
| `triggerSelector` | `string` |
| `triggerMethod` | `string` |
| `closeMethod` | `ModalCloseMethod` |
| `closeButtonTexts` | `string[]` |
| `conditionalOn` | `string` |
| `hostComponent` | `string` |
| `sourceFile` | `string` |
| `line` | `number` |

<!-- source: api-endpoint-remove-2.md -->

# remove

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 71)

## Endpoint

`DELETE /projects/:projectId/boards/:boardId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `boardId` | query | `string` | ✓ |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: component-enhancepanel.md -->

# EnhancePanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/EnhancePanel.tsx` (line 30)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `slug` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_EnhancePanel_1f5e4b27["EnhancePanel"]
    class component_EnhancePanel_1f5e4b27 rootComponent
```

## Relationships

- RENDERS → `OutOfCredits`
- USES_HOOK → `useSession`
- USES_HOOK → `useState`

<!-- source: interface-modalprofile.md -->

# ModalProfile

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/site-map.types.ts` (line 47)

## Properties

| Property | Type |
|---|---|
| `selector` | `string` |
| `title` | `string` |

<!-- source: api-endpoint-remove-3.md -->

# remove

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/capture/capture.controller.ts` (line 99)

## Endpoint

`DELETE /capture/:projectId/flows/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `CaptureController` (MODULE_DECLARES)

<!-- source: component-enterpriseanalyticspage.md -->

# EnterpriseAnalyticsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/enterprise/analytics/page.tsx` (line 207)

## Diagram

```mermaid
graph TD
    component_EnterpriseAnalyticsPage_5420c7df["EnterpriseAnalyticsPage"]
    class component_EnterpriseAnalyticsPage_5420c7df rootComponent
```

## Relationships

- RENDERS → `ChartBarIcon`
- RENDERS → `ClipboardDocumentListIcon`
- RENDERS → `EyeIcon`
- RENDERS → `ArrowDownTrayIcon`
- RENDERS → `TimePeriodSelector`
- RENDERS → `MetricCard`
- RENDERS → `UsersIcon`
- RENDERS → `ClockSolidIcon`
- RENDERS → `ArrowTrendingUpIcon`
- RENDERS → `ArrowTrendingDownIcon`
- RENDERS → `MagnifyingGlassIcon`
- RENDERS → `TimeSeriesChart`
- RENDERS → `HorizontalBarChart`
- RENDERS → `DonutChart`
- RENDERS → `React-Fragment`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-modeltokensummary.md -->

# ModelTokenSummary

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/pipeline/token-tracker.ts` (line 48)

## Properties

| Property | Type |
|---|---|
| `inputTokens` | `number` |
| `outputTokens` | `number` |
| `costUsd` | `number` |

<!-- source: api-endpoint-removecard.md -->

# removeCard

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 176)

## Endpoint

`DELETE /projects/:projectId/boards/:boardId/cards/:cardId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `boardId` | query | `string` | ✓ |
| `cardId` | query | `string` | ✓ |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: component-entitydetailpage.md -->

# EntityDetailPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/entity/[entityId]/page.tsx` (line 184)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_EntityDetailPage_6f886d91["EntityDetailPage"]
    class component_EntityDetailPage_6f886d91 rootComponent
```

## Relationships

- RENDERS → `EntityTree`
- RENDERS → `RelationsPanel`
- RENDERS → `SparklesIcon`
- RENDERS → `TypeIcon`
- RENDERS → `CheckIcon`
- RENDERS → `DocumentDuplicateIcon`
- RENDERS → `ShareIcon`
- RENDERS → `EnhancePanel`
- RENDERS → `Tab`
- RENDERS → `MethodsTable`
- RENDERS → `FieldsTable`
- RENDERS → `Code`
- RENDERS → `AiEnrichmentContent`
- USES_HOOK → `useState`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useEffect`

<!-- source: interface-muidetectionconfig.md -->

# MuiDetectionConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/material-ui.patterns.ts` (line 269)

## Properties

| Property | Type |
|---|---|
| `name` | `'material-ui'` |
| `filePatterns` | `string[]` |
| `identifiers` | `RegExp[]` |
| `configFiles` | `string[]` |

<!-- source: api-endpoint-removeconnector.md -->

# removeConnector

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 288)

## Endpoint

`DELETE /technical-docs/:projectId/connectors/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-entitytree.md -->

# EntityTree

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/components/EntityTree.tsx` (line 246)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `navMap` | `NavMap` | ✓ | - |
| `enrichedEntityIds` | `Set` | ✓ | - |
| `projectId` | `string` | ✓ | - |
| `selectedEntityId` | `string` | - | - |
| `entityHrefBase` | `string` | - | - |
| `curation` | `Curation` | - | - |
| `onCurate` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_EntityTree_25be53ad["EntityTree"]
    class component_EntityTree_25be53ad rootComponent
```

## Relationships

- RENDERS → `EntityIcon`
- RENDERS → `AppSection`
- RENDERS → `ChevronRightIcon`
- USES_HOOK → `useState`
- USES_HOOK → `useMemo`

<!-- source: interface-navigationtreeprops.md -->

# NavigationTreeProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/components/NavigationTree.tsx` (line 20)

## Properties

| Property | Type |
|---|---|
| `items` | `DocumentTreeNode[]` |
| `activeId` | `string` |
| `defaultExpanded` | `string[]` |
| `expanded` | `string[]` |
| `onExpandedChange` | `(expandedIds: string[]) => void` |
| `onItemClick` | `(node: DocumentTreeNode) => void` |
| `showStateIndicator` | `boolean` |
| `loading` | `boolean` |
| `emptyMessage` | `string` |
| `className` | `string` |
| `'aria-label'` | `string` |

<!-- source: api-endpoint-removecustomdomain.md -->

# removeCustomDomain

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 400)

## Endpoint

`DELETE /projects/:id/custom-domain`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: component-errorstate.md -->

# ErrorState

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Templates/TemplateGallery.tsx` (line 155)

Error state component

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `error` | `Error` | ✓ | - |
| `onRetry` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ErrorState_19b41561["ErrorState"]
    class component_ErrorState_19b41561 rootComponent
```

## Relationships

- RENDERS → `AlertCircle`

<!-- source: interface-navlink.md -->

# NavLink

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/layout/nav.tsx` (line 17)

## Properties

| Property | Type |
|---|---|
| `labelKey` | `string` |
| `href` | `string` |

<!-- source: api-endpoint-removemember.md -->

# removeMember

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 237)

## Endpoint

`DELETE /projects/:id/members/:userId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `userId` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: component-errorstate-2.md -->

# ErrorState

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/common/ErrorState.tsx` (line 114)

## Diagram

```mermaid
graph TD
    component_ErrorState_2fd96bd6["ErrorState"]
    class component_ErrorState_2fd96bd6 rootComponent
```

## Relationships

- RENDERS → `ErrorIcon`
- RENDERS → `AnimatePresence`
- RENDERS → `motion-div`
- RENDERS → `ErrorContent`
- RENDERS → `ActionButton`

<!-- source: interface-nestededitorscontextvalue.md -->

# NestedEditorsContextValue

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/core/NestedLexicalEditor.tsx` (line 56)

## Properties

| Property | Type |
|---|---|
| `parentEditor` | `LexicalEditor` |
| `config` | `EditorConfig` |
| `mdastNode` | `T` |
| `lexicalNode` | `DecoratorNode<any> & {
    /**
     * Use this method to update the mdast node. This will also update the mdast tree of the parent editor.
     */
    setMdastNode: (mdastNode: any) => void
  }` |
| `focusEmitter` | `VoidEmitter` |

<!-- source: api-endpoint-removesource.md -->

# removeSource

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 231)

## Endpoint

`DELETE /technical-docs/:projectId/sources/:documentId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `documentId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-exportmodal.md -->

# ExportModal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/components/ExportModal.tsx` (line 48)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `open` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `defaultScope` | `ExportScope` | - | "technical" |

## Diagram

```mermaid
graph TD
    component_ExportModal_37cf2205["ExportModal"]
    class component_ExportModal_37cf2205 rootComponent
```

## Relationships

- RENDERS → `AnimatePresence`
- RENDERS → `motion-div`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-nestjsendpoint.md -->

# NestJSEndpoint

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/nestjs-detector.ts` (line 39)

NestJS endpoint

## Properties

| Property | Type |
|---|---|
| `method` | `'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'` |
| `path` | `string` |
| `handlerName` | `string` |
| `requestDto` | `string` |
| `responseDto` | `string` |
| `roles` | `string[]` |
| `guard` | `string` |
| `isPublic` | `boolean` |
| `parameters` | `NestJSParameter[]` |

<!-- source: api-endpoint-render.md -->

# render

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 427)

## Endpoint

`GET /documents/:id/render`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `audiences` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: component-field.md -->

# Field

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/branding/page.tsx` (line 1048)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `label` | `string` | ✓ | - |
| `hint` | `string` | - | - |
| `counter` | `string` | - | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Field_1065d226["Field"]
    class component_Field_1065d226 rootComponent
```

<!-- source: interface-nestjsmethod.md -->

# NestJSMethod

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/nestjs-detector.ts` (line 88)

NestJS method

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `returnType` | `string` |
| `isAsync` | `boolean` |
| `parameters` | `NestJSParameter[]` |

<!-- source: api-endpoint-reorder.md -->

# reorder

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/category.controller.ts` (line 109)

Reorder categories

## Endpoint

`POST /categories/reorder`

## Referenced By

- `CategoryController` (MODULE_DECLARES)

<!-- source: component-fileupload.md -->

# FileUpload

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/FileUpload.tsx` (line 15)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onFileSelect` | `Function` | ✓ | - |
| `accept` | `string` | - | ".ts,.tsx,.js,.jsx,.py" |
| `maxSize` | `number` | - | unknown |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_FileUpload_7bfea7be["FileUpload"]
    class component_FileUpload_7bfea7be rootComponent
```

## Relationships

- USES_HOOK → `useState`
- USES_HOOK → `useCallback`

<!-- source: interface-nestjsparameter.md -->

# NestJSParameter

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/nestjs-detector.ts` (line 60)

NestJS parameter

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `decorator` | `'Body' | 'Query' | 'Param' | 'Headers' | 'Req' | 'Res'` |

<!-- source: api-endpoint-reordercolumns.md -->

# reorderColumns

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 104)

## Endpoint

`PATCH /projects/:projectId/boards/:boardId/columns/reorder`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `boardId` | query | `string` | ✓ |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: component-filterbar.md -->

# FilterBar

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Documents/FilterBar.tsx` (line 16)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `filters` | `DocumentFilters` | ✓ | - |
| `onChange` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FilterBar_1fba083d["FilterBar"]
    class component_FilterBar_1fba083d rootComponent
```

## Relationships

- RENDERS → `Select`

<!-- source: interface-newimagedialogstate.md -->

# NewImageDialogState

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 98)

The state of the image dialog when it is in new mode.

## Properties

| Property | Type |
|---|---|
| `type` | `'new'` |

<!-- source: api-endpoint-reorderdocuments.md -->

# reorderDocuments

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 933)

## Endpoint

`PATCH /categories/:categoryId/documents/order`

| Parameter | In | Type | Required |
|---|---|---|---|
| `categoryId` | query | `string` | ✓ |

## Referenced By

- `CategoryDocumentsController` (MODULE_DECLARES)

<!-- source: component-filterchips.md -->

# FilterChips

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Documents/FilterChips.tsx` (line 28)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `filters` | `DocumentFilters` | ✓ | - |
| `onRemoveFilter` | `Function` | ✓ | - |
| `onClearAll` | `Function` | ✓ | - |
| `categoryName` | `string` | - | - |
| `projectName` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_FilterChips_62faa03d["FilterChips"]
    class component_FilterChips_62faa03d rootComponent
```

## Relationships

- RENDERS → `AnimatePresence`
- RENDERS → `motion-div`
- RENDERS → `XMarkIcon`
- RENDERS → `motion-button`

<!-- source: interface-openaiconfig.md -->

# OpenAIConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/openai.provider.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `apiKey` | `string` |
| `baseUrl` | `string` |
| `model` | `string` |
| `maxTokens` | `number` |
| `temperature` | `number` |
| `timeout` | `number` |
| `azureEndpoint` | `string` |
| `azureApiKey` | `string` |
| `azureDeployment` | `string` |
| `azureApiVersion` | `string` |
| `retry` | `Partial<RetryConfig>` |

<!-- source: api-endpoint-reply.md -->

# reply

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/desk.controller.ts` (line 85)

## Endpoint

`POST /desk/:projectId/threads/:id/reply`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `DeskController` (MODULE_DECLARES)

<!-- source: component-forgotpasswordpage.md -->

# ForgotPasswordPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/(auth)/forgot-password/page.tsx` (line 8)

## Diagram

```mermaid
graph TD
    component_ForgotPasswordPage_4692b37["ForgotPasswordPage"]
    class component_ForgotPasswordPage_4692b37 rootComponent
```

## Relationships

- RENDERS → `Link`
- USES_HOOK → `useState`

<!-- source: interface-openaigenerateoptions.md -->

# OpenAIGenerateOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/openai.provider.ts` (line 46)

## Properties

| Property | Type |
|---|---|
| `maxTokens` | `number` |
| `temperature` | `number` |
| `systemPrompt` | `string` |
| `messages` | `OpenAIMessage[]` |
| `responseFormat` | `'text' | 'json_object'` |
| `stopSequences` | `string[]` |

<!-- source: api-endpoint-reply-2.md -->

# reply

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/public-issues.controller.ts` (line 28)

## Endpoint

`POST /public/issues/:projectSlugId/:ticketNumber/reply`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectSlugId` | query | `string` | ✓ |
| `ticketNumber` | query | `number` | ✓ |

## Referenced By

- `PublicIssuesController` (MODULE_DECLARES)

<!-- source: component-formsection.md -->

# FormSection

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/branding/page.tsx` (line 1013)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `icon` | `unknown` | ✓ | - |
| `title` | `string` | ✓ | - |
| `description` | `string` | - | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FormSection_4fa0b59f["FormSection"]
    class component_FormSection_4fa0b59f rootComponent
```

<!-- source: interface-openaimessage.md -->

# OpenAIMessage

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/openai.provider.ts` (line 33)

## Properties

| Property | Type |
|---|---|
| `role` | `'system' | 'user' | 'assistant'` |
| `content` | `string` |

<!-- source: api-endpoint-reportexternalprogress.md -->

# reportExternalProgress

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 155)

## Endpoint

`POST /doc-automation/jobs/:id/external-progress`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: component-freshnesscockpit.md -->

# FreshnessCockpit

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/components/FreshnessCockpit.tsx` (line 56)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_FreshnessCockpit_109afe6b["FreshnessCockpit"]
    class component_FreshnessCockpit_109afe6b rootComponent
```

## Relationships

- RENDERS → `ArrowPathIcon`
- RENDERS → `CameraIcon`
- RENDERS → `SparklesIcon`
- RENDERS → `OutOfCredits`
- RENDERS → `CheckCircleIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-openairesponse.md -->

# OpenAIResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/openai.provider.ts` (line 38)

## Properties

| Property | Type |
|---|---|
| `content` | `string` |
| `inputTokens` | `number` |
| `outputTokens` | `number` |
| `model` | `string` |
| `finishReason` | `string` |

<!-- source: api-endpoint-requestapproval.md -->

# requestApproval

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 563)

## Endpoint

`POST /doc-versions/:projectId/:versionId/approval/request`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-generationhistory.md -->

# GenerationHistory

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/dashboard/GenerationHistory.tsx` (line 38)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `jobs` | `Job[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_GenerationHistory_5d76ce28["GenerationHistory"]
    class component_GenerationHistory_5d76ce28 rootComponent
```

<!-- source: interface-openapispec.md -->

# OpenAPISpec

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/APIExplorer.ts` (line 17)

## Properties

| Property | Type |
|---|---|
| `openapi` | `string` |
| `info` | `{
    title: string;
    version: string;
    description?: string;
  }` |
| `paths` | `Record<string, any>` |
| `components` | `{
    securitySchemes?: Record<string, SecurityScheme>;
  }` |

<!-- source: api-endpoint-resendverification.md -->

# resendVerification

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/auth.controller.ts` (line 117)

## Endpoint

`POST /auth/resend-verification`

## Referenced By

- `AuthController` (MODULE_DECLARES)

<!-- source: component-generationprogress.md -->

# GenerationProgress

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/pme/generation-progress.tsx` (line 26)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onComplete` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_GenerationProgress_3fbedf8c["GenerationProgress"]
    class component_GenerationProgress_3fbedf8c rootComponent
```

## Relationships

- USES_HOOK → `usePmeStore`

<!-- source: interface-pageelementprofile.md -->

# PageElementProfile

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/site-map.types.ts` (line 52)

## Properties

| Property | Type |
|---|---|
| `grids` | `GridProfile[]` |
| `tabs` | `TabProfile[]` |
| `buttons` | `ButtonProfile[]` |
| `inputs` | `InputProfile[]` |
| `forms` | `FormProfile[]` |
| `modals` | `ModalProfile[]` |

<!-- source: api-endpoint-resetpassword.md -->

# resetPassword

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/auth.controller.ts` (line 106)

## Endpoint

`POST /auth/reset-password`

## Referenced By

- `AuthController` (MODULE_DECLARES)

<!-- source: component-generationwizard.md -->

# GenerationWizard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/pme/generation-wizard.tsx` (line 32)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onStarted` | `Function` | ✓ | - |
| `onBack` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_GenerationWizard_ffd9b70["GenerationWizard"]
    class component_GenerationWizard_ffd9b70 rootComponent
```

## Relationships

- USES_HOOK → `useProjectContext`
- USES_HOOK → `usePme`
- USES_HOOK → `useState`

<!-- source: interface-parameter-2.md -->

# Parameter

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/EndpointDetail.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `in` | `'query' | 'path' | 'header' | 'cookie'` |
| `description` | `string` |
| `required` | `boolean` |
| `schema` | `Schema` |
| `example` | `any` |

<!-- source: api-endpoint-reshoot.md -->

# reshoot

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/freshness.controller.ts` (line 27)

## Endpoint

`POST /freshness/:projectId/reshoot`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `FreshnessController` (MODULE_DECLARES)

<!-- source: component-githubicon-2.md -->

# GitHubIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/integrations/page.tsx` (line 11)

## Diagram

```mermaid
graph TD
    component_GitHubIcon_1e895c58["GitHubIcon"]
    class component_GitHubIcon_1e895c58 rootComponent
```

<!-- source: interface-parameter-3.md -->

# Parameter

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/RequestPanel.ts` (line 17)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `in` | `'query' | 'path' | 'header' | 'cookie'` |
| `description` | `string` |
| `required` | `boolean` |
| `schema` | `{ type?: string; example?: any }` |

<!-- source: api-endpoint-reshootlocales.md -->

# reshootLocales

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/capture/capture.controller.ts` (line 88)

## Endpoint

`POST /capture/:projectId/flows/:id/reshoot-locales`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `CaptureController` (MODULE_DECLARES)

<!-- source: component-githubicon-3.md -->

# GitHubIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/scenes/SceneConnectProvider.tsx` (line 20)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `size` | `number` | - | 36 |
| `color` | `string` | - | "#24292F" |

## Diagram

```mermaid
graph TD
    component_GitHubIcon_48ed4f36["GitHubIcon"]
    class component_GitHubIcon_48ed4f36 rootComponent
```

<!-- source: interface-parseerror-5.md -->

# ParseError

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 123)

Parse error

## Properties

| Property | Type |
|---|---|
| `type` | `'error'` |
| `message` | `string` |
| `line` | `number` |
| `column` | `number` |
| `severity` | `'error'` |

<!-- source: api-endpoint-reshootstep.md -->

# reshootStep

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/capture/capture.controller.ts` (line 76)

## Endpoint

`POST /capture/:projectId/flows/:id/steps/:stepIndex/reshoot`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |
| `stepIndex` | query | `number` | ✓ |

## Referenced By

- `CaptureController` (MODULE_DECLARES)

<!-- source: component-gitlabicon-2.md -->

# GitLabIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/integrations/page.tsx` (line 17)

## Diagram

```mermaid
graph TD
    component_GitLabIcon_2ffea310["GitLabIcon"]
    class component_GitLabIcon_2ffea310 rootComponent
```

<!-- source: interface-parseerrorinfo.md -->

# ParseErrorInfo

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-01.types.ts` (line 59)

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `line` | `number` |
| `message` | `string` |
| `severity` | `'warning' | 'error'` |

<!-- source: api-endpoint-resolve.md -->

# resolve

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/comment/comment.controller.ts` (line 247)

Resolve a comment thread

## Endpoint

`POST /documents/:documentId/comments/:id/resolve`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `CommentController` (MODULE_DECLARES)

<!-- source: component-gitlabicon-3.md -->

# GitLabIcon

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/scenes/SceneConnectProvider.tsx` (line 26)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `size` | `number` | - | 36 |

## Diagram

```mermaid
graph TD
    component_GitLabIcon_688ab162["GitLabIcon"]
    class component_GitLabIcon_688ab162 rootComponent
```

<!-- source: interface-parseinput.md -->

# ParseInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-01.types.ts` (line 23)

## Properties

| Property | Type |
|---|---|
| `config` | `Pick<
    JobConfig,
    'repositoryUrl' | 'branch' | 'includePaths' | 'excludePaths'
  > & {
    /** Parser-core configuration */
    parsers?: ParserCoreConfig;
    /** Scope paths for file discovery */
    scopePaths?: {
      frontend?: string;
      backend?: string;
    };
  }` |
| `workDir` | `string` |

<!-- source: api-endpoint-resolve-2.md -->

# resolve

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 212)

## Endpoint

`POST /doc-versions/:projectId/:versionId/review/resolve`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-graphlegend.md -->

# GraphLegend

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Graph/GraphLegend.tsx` (line 23)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `showRelationships` | `boolean` | - | true |

## Diagram

```mermaid
graph TD
    component_GraphLegend_62dd9e93["GraphLegend"]
    class component_GraphLegend_62dd9e93 rootComponent
```

## Relationships

- RENDERS → `Icon`

<!-- source: interface-parsercoreconfig.md -->

# ParserCoreConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-01.types.ts` (line 14)

Parser configuration for parser-core integration

## Properties

| Property | Type |
|---|---|
| `explicit` | `string[]` |
| `additionalPatterns` | `string[]` |
| `useParserCore` | `boolean` |

<!-- source: api-endpoint-resolveall.md -->

# resolveAll

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 224)

## Endpoint

`POST /doc-versions/:projectId/:versionId/review/resolve-all`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-graphpage.md -->

# GraphPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/graph/page.tsx` (line 59)

## Diagram

```mermaid
graph TD
    component_GraphPage_6ebb50fc["GraphPage"]
    class component_GraphPage_6ebb50fc rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Card`
- RENDERS → `CardContent`
- RENDERS → `ShareIcon`
- RENDERS → `CardHeader`
- RENDERS → `ReactFlowProvider`
- RENDERS → `MagnifyingGlassIcon`
- RENDERS → `FunnelIcon`
- RENDERS → `ReactFlow`
- RENDERS → `Background`
- RENDERS → `Controls`
- RENDERS → `MiniMap`
- RENDERS → `Panel`
- USES_HOOK → `useKnowledgeGraph`
- USES_HOOK → `useNodesState`
- USES_HOOK → `useEdgesState`
- USES_HOOK → `useState`
- USES_HOOK → `useMemo`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-parseresult-5.md -->

# ParseResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-01.types.ts` (line 39)

## Properties

| Property | Type |
|---|---|
| `entities` | `Entity[]` |
| `repoPath` | `string` |
| `stats` | `ParseStats` |
| `errors` | `ParseErrorInfo[]` |
| `routeMappings` | `RouteMappingResult` |

<!-- source: api-endpoint-restore.md -->

# restore

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 81)

## Endpoint

`POST /projects/:projectId/boards/:boardId/restore`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `boardId` | query | `string` | ✓ |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: component-graphvisualization.md -->

# GraphVisualization

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Graph/GraphVisualization.tsx` (line 45)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `documentId` | `string` | - | - |
| `entityId` | `string` | - | - |
| `projectId` | `string` | - | - |
| `defaultView` | `GraphViewMode` | - | "entity-centric" |
| `height` | `string` | - | "600px" |

## Diagram

```mermaid
graph TD
    component_GraphVisualization_abfd36f["GraphVisualization"]
    class component_GraphVisualization_abfd36f rootComponent
```

## Relationships

- RENDERS → `Panel`
- RENDERS → `Search`
- RENDERS → `RefreshCw`
- RENDERS → `ReactFlow`
- RENDERS → `Background`
- RENDERS → `Controls`
- RENDERS → `MiniMap`
- RENDERS → `GraphLegend`
- USES_HOOK → `useGraph`
- USES_HOOK → `useState`
- USES_HOOK → `useNodesState`
- USES_HOOK → `useEdgesState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useMemo`
- USES_HOOK → `useCallback`

<!-- source: interface-parseroptions-2.md -->

# ParserOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 145)

Parser options

## Properties

| Property | Type |
|---|---|
| `expandIncludes` | `boolean` |
| `validateAudiences` | `boolean` |
| `knownAudiences` | `string[]` |
| `maxNestingDepth` | `number` |
| `allowUnknownAudiences` | `boolean` |

<!-- source: api-endpoint-restorefromrevision.md -->

# restoreFromRevision

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 543)

## Endpoint

`POST /documents/:id/revisions/:revisionId/restore`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `revisionId` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: component-groundednesspage.md -->

# GroundednessPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/(marketing)/groundedness/page.tsx` (line 18)

## Diagram

```mermaid
graph TD
    component_GroundednessPage_1e3f0944["GroundednessPage"]
    class component_GroundednessPage_1e3f0944 rootComponent
```

<!-- source: interface-parsestats.md -->

# ParseStats

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-01.types.ts` (line 48)

## Properties

| Property | Type |
|---|---|
| `totalFiles` | `number` |
| `parsedFiles` | `number` |
| `skippedFiles` | `number` |
| `totalEntities` | `number` |
| `totalLines` | `number` |
| `byType` | `Record<string, number>` |
| `byTier` | `Record<string, number>` |
| `byExtension` | `Record<string, number>` |

<!-- source: api-endpoint-restorefromversion.md -->

# restoreFromVersion

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 728)

## Endpoint

`POST /documents/:id/versions/:versionNumber/restore`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `versionNumber` | query | `number` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: component-helpfulnesswidget.md -->

# HelpfulnessWidget

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/HelpfulnessWidget.tsx` (line 52)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `documentId` | `string` | - | - |
| `documentSlug` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_HelpfulnessWidget_b37518a["HelpfulnessWidget"]
    class component_HelpfulnessWidget_b37518a rootComponent
```

## Relationships

- RENDERS → `HandThumbUpIcon`
- RENDERS → `HandThumbDownIcon`
- RENDERS → `CheckIcon`
- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`

<!-- source: interface-parsewarning-3.md -->

# ParseWarning

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 134)

Parse warning

## Properties

| Property | Type |
|---|---|
| `type` | `'warning'` |
| `message` | `string` |
| `line` | `number` |
| `column` | `number` |
| `severity` | `'warning'` |

<!-- source: api-endpoint-retrycustomdomain.md -->

# retryCustomDomain

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 390)

## Endpoint

`POST /projects/:id/custom-domain/retry`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: component-homepage.md -->

# HomePage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/page.tsx` (line 567)

## Diagram

```mermaid
graph TD
    component_HomePage_266c528["HomePage"]
    class component_HomePage_266c528 rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `Orb`
- RENDERS → `motion-div`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `DemoTerminal`
- RENDERS → `Reveal`
- RENDERS → `Counter`
- RENDERS → `KbPanel`
- RENDERS → `ManualPanel`
- RENDERS → `ApiPanel`
- RENDERS → `SupportPanel`
- RENDERS → `StepsSection`
- RENDERS → `Ticker`
- RENDERS → `EarlyAccessForm`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-permissioncheck-2.md -->

# PermissionCheck

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 176)

A permission check found in source code

## Properties

| Property | Type |
|---|---|
| `permission` | `string` |
| `checkType` | `'route-guard' | 'template-conditional' | 'code-check' | 'decorator'` |
| `affectedElement` | `string` |
| `location` | `string` |
| `sourceFile` | `string` |
| `line` | `number` |

<!-- source: api-endpoint-revert.md -->

# revert

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 326)

## Endpoint

`POST /documents/:id/revert/:version`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `version` | query | `number` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: component-horizontalbarchart.md -->

# HorizontalBarChart

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/HorizontalBarChart.tsx` (line 36)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `items` | `HorizontalBarItem[]` | ✓ | - |
| `maxItems` | `number` | - | 10 |
| `loading` | `boolean` | - | false |
| `emptyMessage` | `string` | - | "No data yet" |

## Diagram

```mermaid
graph TD
    component_HorizontalBarChart_60e61b63["HorizontalBarChart"]
    class component_HorizontalBarChart_60e61b63 rootComponent
```

<!-- source: interface-phase-2.md -->

# Phase

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-07.types.ts` (line 32)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `number` | `number` |
| `name` | `string` |
| `documents` | `PhaseDocument[]` |
| `priority` | `number` |
| `sharedContext` | `string[]` |
| `estimatedTokens` | `number` |

<!-- source: api-endpoint-runreport.md -->

# runReport

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/export/analytics-export.controller.ts` (line 130)

## Endpoint

`POST /analytics/:projectId/reports/:id/run`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `AnalyticsExportController` (MODULE_DECLARES)

<!-- source: component-imageuploadfield.md -->

# ImageUploadField

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/branding/page.tsx` (line 1146)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `url` | `string` | ✓ | - |
| `placeholder` | `string` | ✓ | - |
| `uploading` | `boolean` | ✓ | - |
| `inputRef` | `unknown` | ✓ | - |
| `onUpload` | `Function` | ✓ | - |
| `onClear` | `Function` | ✓ | - |
| `small` | `boolean` | - | - |

## Diagram

```mermaid
graph TD
    component_ImageUploadField_78cc0a3e["ImageUploadField"]
    class component_ImageUploadField_78cc0a3e rootComponent
```

## Relationships

- RENDERS → `PhotoIcon`
- RENDERS → `ArrowUpTrayIcon`
- RENDERS → `XMarkIcon`
- USES_HOOK → `useState`

<!-- source: interface-phasedocument.md -->

# PhaseDocument

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-07.types.ts` (line 42)

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `order` | `number` |
| `dependencies` | `string[]` |

<!-- source: api-endpoint-runuploadonexistingjob.md -->

# runUploadOnExistingJob

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 174)

## Endpoint

`POST /doc-automation/jobs/:id/run-upload`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: component-index-ts.md -->

# index.ts

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/stores/index.ts` (line 1)

## Diagram

```mermaid
graph TD
    component_index_ts_6ee637cf["index.ts"]
    class component_index_ts_6ee637cf rootComponent
```

<!-- source: interface-phaseinput.md -->

# PhaseInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-07.types.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `documents` | `PlannedDocument[]` |
| `maxDocsPerPhase` | `number` |

<!-- source: api-endpoint-saveastemplate.md -->

# saveAsTemplate

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/template/template.controller.ts` (line 150)

Save an existing document as a template.
Any contributor or higher can save their documents as templates.

## Endpoint

`POST /templates/from-document/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `TemplateController` (MODULE_DECLARES)

<!-- source: component-integrationspage.md -->

# IntegrationsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/integrations/page.tsx` (line 80)

## Diagram

```mermaid
graph TD
    component_IntegrationsPage_cb1f736["IntegrationsPage"]
    class component_IntegrationsPage_cb1f736 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `AnimatePresence`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-phaseresult-2.md -->

# PhaseResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-07.types.ts` (line 23)

## Properties

| Property | Type |
|---|---|
| `phases` | `Phase[]` |
| `stats` | `{
    totalPhases: number;
    avgDocsPerPhase: number;
    maxDocsInPhase: number;
  }` |

<!-- source: api-endpoint-search.md -->

# search

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 93)

## Endpoint

`GET /documents/search`

| Parameter | In | Type | Required |
|---|---|---|---|
| `filters` | query | `SearchDocumentsDto` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: component-issuedetailpage.md -->

# IssueDetailPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/[ticketId]/page.tsx` (line 468)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_IssueDetailPage_97c934e["IssueDetailPage"]
    class component_IssueDetailPage_97c934e rootComponent
```

## Relationships

- RENDERS → `BoardsToastProvider`
- RENDERS → `IssueDetailPageInner`

<!-- source: interface-pipelineerrorinfo.md -->

# PipelineErrorInfo

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 314)

## Properties

| Property | Type |
|---|---|
| `code` | `ErrorCode` |
| `message` | `string` |
| `stage` | `JobStage` |
| `recoverable` | `boolean` |
| `details` | `unknown` |

<!-- source: api-endpoint-search-2.md -->

# search

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/search.controller.ts` (line 44)

Search documentation

GET /search?q=query&type=workflow&category=sales&projectId=123

Query Parameters:
- q (required): Search query
- type: Document type filter (workflow, feature, tutorial)
- category: Category filter
- difficulty: Difficulty filter (beginner, intermediate, advanced)
- projectId: Filter to specific project (default: all projects in user's organization)
- limit: Max results (default: 20)
- offset: Pagination offset (default: 0)
- includeFacets: Include facet counts (default: true)

## Endpoint

`GET /search`

| Parameter | In | Type | Required |
|---|---|---|---|
| `q` | query | `string` | ✓ |
| `type` | query | `'workflow' | 'feature' | 'tutorial'` | - |
| `category` | query | `string` | - |
| `difficulty` | query | `'beginner' | 'intermediate' | 'advanced'` | - |
| `projectId` | query | `string` | - |
| `limit` | query | `string` | - |
| `offset` | query | `string` | - |
| `includeFacets` | query | `string` | - |

## Referenced By

- `SearchController` (MODULE_DECLARES)

<!-- source: component-issuesallpage.md -->

# IssuesAllPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/all/page.tsx` (line 182)

## Diagram

```mermaid
graph TD
    component_IssuesAllPage_601947d9["IssuesAllPage"]
    class component_IssuesAllPage_601947d9 rootComponent
```

## Relationships

- RENDERS → `BoardsToastProvider`
- RENDERS → `IssuesAllPageInner`

<!-- source: interface-pipelinemetrics.md -->

# PipelineMetrics

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/pipeline-metrics.ts` (line 17)

Pipeline Metrics Collector

Collects comprehensive metrics across all pipeline stages for
post-run analysis. Persisted to documentation_jobs.metrics as JSONB.

Categories tracked:
- Token usage per stage and total
- Screenshot mapping/capture/failure breakdown
- Quality gate + verification scores per document
- Business context extraction stats
- InteractionMap discovery stats
- Stage timing with timestamps
- Document-level metrics (word count, section count)

## Properties

| Property | Type |
|---|---|
| `tokens` | `{
    total: { input: number; output: number; cost?: number };
    byStage: Record<string, { input: number; output: number; calls: number }>;
  }` |
| `screenshots` | `{
    totalPlaceholders: number;
    mapped: number;
    unmapped: number;
    captured: number;
    failed: number;
    replaced: number;
    /** Breakdown by mapping source */
    mappingSources: {
      interactionMap: number;
      siteMap: number;
      aiFallback: number;
    };
    /** Capture types breakdown */
    captureTypes: Record<string, number>;
    /** Failed capture reasons */
    failureReasons: { url: string; reason: string }[];
    /** State-guided captures attempted/succeeded */
    stateGuided: { attempted: number; succeeded: number };
    /** Workflow sequences detected */
    workflowSequences: number;
  }` |
| `quality` | `{
    /** Quality gate scores */
    qualityGate: {
      totalScored: number;
      passed: number;
      failed: number;
      regenerated: number;
      averageScore: number;
      scores: { docId: string; title: string; score: number; passed: boolean }[];
    };
    /** Verification scores */
    verification: {
      totalVerified: number;
      passed: number;
      failed: number;
      averageAccuracy: number;
      scores: { docId: string; title: string; accuracy: number; claims: number; flagged: number }[];
    };
    /** Grounding scores */
    grounding: {
      averageScore: number;
      belowThreshold: number;
      scores: { docId: string; score: number }[];
    };
  }` |
| `extraction` | `{
    /** InteractionMap stats */
    interactionMap: {
      totalRoutes: number;
      routesWithModals: number;
      routesWithTabs: number;
      routesWithForms: number;
      totalModals: number;
      totalTabs: number;
      totalFormFields: number;
      totalPermissions: number;
    } | null;
    /** Business context extraction */
    businessContext: {
      sourcesProcessed: number;
      personas: number;
      features: number;
      glossaryTerms: number;
      workflows: number;
      extracted: boolean;
    } | null;
    /** Route mappings from Stage 1 */
    routeMappings: {
      totalRoutes: number;
      framework: string;
      withComponents: number;
      withTemplates: number;
    } | null;
  }` |
| `timing` | `{
    pipelineStartedAt: string;
    pipelineEndedAt: string;
    totalDurationMs: number;
    stages: {
      name: string;
      startedAt: string;
      endedAt: string;
      durationMs: number;
      status: 'success' | 'failed' | 'skipped';
    }[];
  }` |
| `documents` | `{
    total: number;
    byType: Record<string, number>;
    averageWordCount: number;
    averageSections: number;
    totalWordCount: number;
  }` |

<!-- source: api-endpoint-search-3.md -->

# search

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/graph.controller.ts` (line 99)

## Endpoint

`GET /knowledge-graph/search`

| Parameter | In | Type | Required |
|---|---|---|---|
| `q` | query | `string` | ✓ |
| `type` | query | `string` | - |

## Referenced By

- `GraphController` (MODULE_DECLARES)

<!-- source: component-issuesidepanel.md -->

# IssueSidePanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/IssueSidePanel.tsx` (line 163)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `card` | `BoardCardData | null` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `onIssueChanged` | `Function` | - | - |
| `onStatusChanged` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_IssueSidePanel_5e5fd282["IssueSidePanel"]
    class component_IssueSidePanel_5e5fd282 rootComponent
```

## Relationships

- RENDERS → `CheckCircleSolid`
- RENDERS → `ClipboardDocumentIcon`
- RENDERS → `XMarkIcon`
- RENDERS → `PencilSquareIcon`
- RENDERS → `StatusJourney`
- RENDERS → `Section`
- RENDERS → `Row`
- RENDERS → `ChevronDownIcon`
- RENDERS → `CheckIcon`
- RENDERS → `UserCircleIcon`
- RENDERS → `MagnifyingGlassIcon`
- RENDERS → `ArrowTopRightOnSquareIcon`
- RENDERS → `ActivityRow`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-placeholderoccurrence.md -->

# PlaceholderOccurrence

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 27)

Where a placeholder appears in the documentation

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `documentPath` | `string` |
| `lineNumber` | `number` |
| `context` | `string` |

<!-- source: api-endpoint-search-4.md -->

# search

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.controller.ts` (line 79)

GET /support-agent/:projectId/search?q=...

Scoped RAG search for the support agent. Returns relevant documents
from the types enabled in the agent config, scoped to this project
and organization.

## Endpoint

`GET /support-agent/:projectId/search`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `q` | query | `string` | ✓ |
| `limit` | query | `string` | - |

## Referenced By

- `SupportAgentController` (MODULE_DECLARES)

<!-- source: component-issueslistpage.md -->

# IssuesListPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/issues/page.tsx` (line 581)

## Diagram

```mermaid
graph TD
    component_IssuesListPage_52341a28["IssuesListPage"]
    class component_IssuesListPage_52341a28 rootComponent
```

## Relationships

- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `ChartBarSquareIcon`
- RENDERS → `ListBulletIcon`
- RENDERS → `ViewColumnsIcon`
- RENDERS → `ArrowPathIcon`
- RENDERS → `MetricCard`
- RENDERS → `InboxIcon`
- RENDERS → `TicketIcon`
- RENDERS → `BoltIcon`
- RENDERS → `CheckCircleIcon`
- RENDERS → `FireIcon`
- RENDERS → `ClockIcon`
- RENDERS → `Card`
- RENDERS → `IssueTrendChart`
- RENDERS → `PriorityGauge`
- RENDERS → `DailyBarChart`
- RENDERS → `ArrowTopRightOnSquareIcon`
- RENDERS → `RecentTickets`
- RENDERS → `DonutChart`
- RENDERS → `StatusOverview`
- RENDERS → `ResolutionTimeChart`
- RENDERS → `HorizontalBarChart`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`
- USES_HOOK → `useMemo`

<!-- source: interface-planinput.md -->

# PlanInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-09.types.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `documents` | `PlannedDocument[]` |
| `features` | `UserFeature[]` |

<!-- source: api-endpoint-selectvariant.md -->

# selectVariant

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/pme/pme.controller.ts` (line 79)

## Endpoint

`PATCH /pme/variants/:variantId/select`

| Parameter | In | Type | Required |
|---|---|---|---|
| `variantId` | query | `string` | ✓ |

## Referenced By

- `PmeController` (MODULE_DECLARES)

<!-- source: component-issuesviewtabs.md -->

# IssuesViewTabs

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Issues/IssuesViewTabs.tsx` (line 44)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `rightSlot` | `unknown` | - | - |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_IssuesViewTabs_27fd783["IssuesViewTabs"]
    class component_IssuesViewTabs_27fd783 rootComponent
```

## Relationships

- RENDERS → `Icon`
- USES_HOOK → `usePathname`
- USES_HOOK → `useRouter`

<!-- source: interface-planneddocument.md -->

# PlannedDocument

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-06.types.ts` (line 35)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `type` | `DocumentType` |
| `category` | `string` |
| `description` | `string` |
| `targetPersonas` | `string[]` |
| `prerequisites` | `string[]` |
| `relatedDocuments` | `string[]` |
| `estimatedSections` | `number` |
| `priority` | `number` |
| `featureIds` | `string[]` |

<!-- source: api-endpoint-setapitarget.md -->

# setApiTarget

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 360)

## Endpoint

`PUT /technical-docs/:projectId/api-target`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-jobhistory.md -->

# JobHistory

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/DocAutomation/JobHistory.tsx` (line 426)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `jobs` | `DocumentationJobEntry[]` | ✓ | - |
| `loading` | `boolean` | ✓ | - |
| `error` | `Error | null` | ✓ | - |
| `liveProgress` | `Record` | ✓ | - |
| `projectId` | `string` | ✓ | - |
| `onRegenerate` | `Function` | - | - |
| `onCancelJob` | `Function` | - | - |
| `onDeleteJobDocuments` | `Function` | - | - |
| `onRefresh` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_JobHistory_156a1910["JobHistory"]
    class component_JobHistory_156a1910 rootComponent
```

## Relationships

- RENDERS → `History`
- RENDERS → `RefreshCw`
- RENDERS → `Loader2`
- RENDERS → `JobRow`

<!-- source: interface-plannerprogresscallback.md -->

# PlannerProgressCallback

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-09-planning/doc-planner.service.ts` (line 25)

<!-- source: api-endpoint-setconnectorenabled.md -->

# setConnectorEnabled

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 275)

## Endpoint

`PUT /technical-docs/:projectId/connectors/:id/enabled`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-languageprovider.md -->

# LanguageProvider

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/LanguageContext.tsx` (line 54)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |
| `slugId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_LanguageProvider_6b75a88a["LanguageProvider"]
    class component_LanguageProvider_6b75a88a rootComponent
```

## Relationships

- RENDERS → `LanguageContext-Provider`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-planresult.md -->

# PlanResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-09.types.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `plans` | `DocumentPlan[]` |
| `tokenUsage` | `TokenUsage[]` |

<!-- source: api-endpoint-setcuration.md -->

# setCuration

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 164)

## Endpoint

`PUT /technical-docs/:projectId/curation`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-languagespage.md -->

# LanguagesPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/languages/page.tsx` (line 454)

## Diagram

```mermaid
graph TD
    component_LanguagesPage_67dc41cc["LanguagesPage"]
    class component_LanguagesPage_67dc41cc rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `motion-div`
- RENDERS → `motion-h1`
- RENDERS → `motion-p`
- RENDERS → `Reveal`
- RENDERS → `ParserCard`
- RENDERS → `React-Fragment`

<!-- source: interface-previewlinkdialog.md -->

# PreviewLinkDialog

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/link-dialog/index.ts` (line 42)

The state of the link dialog when it is in preview mode.

## Properties

| Property | Type |
|---|---|
| `type` | `'preview'` |
| `title` | `string` |
| `url` | `string` |
| `linkNodeKey` | `string` |
| `rectangle` | `RectData` |

<!-- source: api-endpoint-setescalation.md -->

# setEscalation

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 322)

## Endpoint

`PUT /technical-docs/:projectId/escalation`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-languageswitcher.md -->

# LanguageSwitcher

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/LanguageSwitcher.tsx` (line 14)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `dark` | `boolean` | - | - |

## Diagram

```mermaid
graph TD
    component_LanguageSwitcher_61645552["LanguageSwitcher"]
    class component_LanguageSwitcher_61645552 rootComponent
```

## Relationships

- RENDERS → `Globe`
- RENDERS → `ChevronDown`
- RENDERS → `Check`
- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-pricingcomparisontableprops-2.md -->

# PricingComparisonTableProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/pricing/pricing-comparison-table.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `plans` | `{ nameKey: string; priceKey: string; highlighted?: boolean }[]` |
| `features` | `{ featureKey: string; values: (boolean | string)[] }[]` |

<!-- source: api-endpoint-setplaygroundtestkey.md -->

# setPlaygroundTestKey

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 340)

## Endpoint

`PUT /technical-docs/:projectId/playground/test-key`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-layout.md -->

# Layout

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/layout.tsx` (line 9)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Layout_603a2683["Layout"]
    class component_Layout_603a2683 rootComponent
```

## Relationships

- RENDERS → `EmailVerificationBanner`
- RENDERS → `DashboardLayout`

<!-- source: interface-pricingfeature-3.md -->

# PricingFeature

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/pricing-tier-card.tsx` (line 14)

## Properties

| Property | Type |
|---|---|
| `textKey` | `string` |

<!-- source: api-endpoint-setsubdomain.md -->

# setSubdomain

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 348)

## Endpoint

`PATCH /projects/:id/subdomain`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: component-lightbox.md -->

# Lightbox

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/Lightbox.tsx` (line 40)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onClose` | `Function` | ✓ | - |
| `label` | `string` | ✓ | - |
| `closeLabel` | `string` | ✓ | - |
| `caption` | `string | null` | - | - |
| `dir` | `unknown | unknown` | - | "ltr" |
| `returnFocusRef` | `unknown` | - | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Lightbox_5b913125["Lightbox"]
    class component_Lightbox_5b913125 rootComponent
```

## Relationships

- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-pricingfeature-4.md -->

# PricingFeature

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/pricing/pricing-hero-card.tsx` (line 12)

## Properties

| Property | Type |
|---|---|
| `textKey` | `string` |
| `included` | `boolean` |

<!-- source: api-endpoint-stale.md -->

# stale

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/freshness.controller.ts` (line 19)

## Endpoint

`GET /freshness/:projectId/stale`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `FreshnessController` (MODULE_DECLARES)

<!-- source: component-loadingstate.md -->

# LoadingState

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Templates/TemplateGallery.tsx` (line 143)

Loading state component

## Diagram

```mermaid
graph TD
    component_LoadingState_38c1466b["LoadingState"]
    class component_LoadingState_38c1466b rootComponent
```

## Relationships

- RENDERS → `Loader2`

<!-- source: interface-pricingherocardprops-2.md -->

# PricingHeroCardProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/pricing/pricing-hero-card.tsx` (line 27)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `heroPlan` | `PricingPlan` |
| `secondaryPlans` | `PricingPlan[]` |

<!-- source: api-endpoint-startfullsync.md -->

# startFullSync

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/sync.controller.ts` (line 111)

## Endpoint

`POST /projects/sync/full`

## Referenced By

- `SyncController` (MODULE_DECLARES)

<!-- source: component-loginpage.md -->

# LoginPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/(auth)/login/page.tsx` (line 12)

## Diagram

```mermaid
graph TD
    component_LoginPage_502dfa92["LoginPage"]
    class component_LoginPage_502dfa92 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h1`
- RENDERS → `motion-button`
- RENDERS → `Link`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`

<!-- source: interface-pricingplan-2.md -->

# PricingPlan

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/pricing/pricing-hero-card.tsx` (line 17)

## Properties

| Property | Type |
|---|---|
| `nameKey` | `string` |
| `priceKey` | `string` |
| `intervalKey` | `string` |
| `descriptionKey` | `string` |
| `features` | `PricingFeature[]` |
| `ctaKey` | `string` |
| `ctaUrl` | `string` |

<!-- source: api-endpoint-startjob.md -->

# startJob

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 109)

## Endpoint

`POST /doc-automation/jobs`

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: component-manualfreshnessbadge.md -->

# ManualFreshnessBadge

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/ManualFreshnessBadge.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `slug` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ManualFreshnessBadge_41f0c858["ManualFreshnessBadge"]
    class component_ManualFreshnessBadge_41f0c858 rootComponent
```

## Relationships

- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-pricingtiercardprops-2.md -->

# PricingTierCardProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/pricing-tier-card.tsx` (line 18)

## Properties

| Property | Type |
|---|---|
| `nameKey` | `string` |
| `priceKey` | `string` |
| `intervalKey` | `string` |
| `descriptionKey` | `string` |
| `features` | `PricingFeature[]` |
| `ctaKey` | `string` |
| `ctaUrl` | `string` |
| `highlighted` | `boolean` |
| `badgeKey` | `string` |

<!-- source: api-endpoint-startjob-2.md -->

# startJob

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 43)

Trigger a technical docs generation job for a project.
Uses the project's stored repoUrl. Runs async — returns immediately with status.

## Endpoint

`POST /technical-docs/:projectId/jobs`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-manualinsightspanel.md -->

# ManualInsightsPanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/ops/ManualInsightsPanel.tsx` (line 31)

## Diagram

```mermaid
graph TD
    component_ManualInsightsPanel_53af0050["ManualInsightsPanel"]
    class component_ManualInsightsPanel_53af0050 rootComponent
```

## Relationships

- RENDERS → `DraftLink`
- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-problemsplitvisualprops-2.md -->

# ProblemSplitVisualProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/problem/problem-split-visual.tsx` (line 19)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `problems` | `Problem[]` |
| `imageSrc` | `string` |
| `imageAlt` | `string` |
| `imagePosition` | `'start' | 'end'` |

<!-- source: api-endpoint-startstrategy.md -->

# startStrategy

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/pme/pme.controller.ts` (line 93)

## Endpoint

`POST /pme/strategy`

## Referenced By

- `PmeController` (MODULE_DECLARES)

<!-- source: component-manualsbenchmarkpage.md -->

# ManualsBenchmarkPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/(marketing)/manuals-benchmark/page.tsx` (line 66)

## Diagram

```mermaid
graph TD
    component_ManualsBenchmarkPage_41c079a1["ManualsBenchmarkPage"]
    class component_ManualsBenchmarkPage_41c079a1 rootComponent
```

<!-- source: interface-progressstats.md -->

# ProgressStats

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/utils/progress-tracker.ts` (line 10)

## Properties

| Property | Type |
|---|---|
| `totalItems` | `number` |
| `completedItems` | `number` |
| `currentBatch` | `number` |
| `totalBatches` | `number` |
| `avgTimePerItem` | `number` |
| `avgTimePerItemFormatted` | `string` |
| `estimatedRemainingMs` | `number` |
| `estimatedRemainingFormatted` | `string` |
| `etaFormatted` | `string` |
| `elapsedMs` | `number` |
| `elapsedFormatted` | `string` |
| `percentComplete` | `number` |
| `progressPercent` | `number` |

<!-- source: api-endpoint-status.md -->

# status

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/trial/trial.controller.ts` (line 24)

## Endpoint

`GET /trial/:projectId/status`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TrialController` (MODULE_DECLARES)

<!-- source: component-markdowneditor.md -->

# MarkdownEditor

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/MarkdownEditor.tsx` (line 12)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `content` | `string` | ✓ | - |
| `onChange` | `Function` | ✓ | - |
| `editable` | `boolean` | - | true |

## Diagram

```mermaid
graph TD
    component_MarkdownEditor_7b2c1152["MarkdownEditor"]
    class component_MarkdownEditor_7b2c1152 rootComponent
```

## Relationships

- RENDERS → `Editor`
- USES_HOOK → `useRef`

<!-- source: interface-project.md -->

# Project

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/projects.ts` (line 11)

Project model for API responses

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `organizationId` | `string` |
| `themeId` | `string` |
| `repoUrl` | `string` |
| `repoBranch` | `string` |
| `createdAt` | `string` |
| `updatedAt` | `string` |

<!-- source: api-endpoint-stream.md -->

# stream

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs-chat.controller.ts` (line 65)

## Endpoint

`POST /technical-docs/:projectId/chat/stream`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsChatController` (MODULE_DECLARES)

<!-- source: component-markdownrenderer.md -->

# MarkdownRenderer

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MarkdownRenderer.tsx` (line 279)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `content` | `string` | ✓ | - |
| `capturedScreenshots` | `Record` | - | - |
| `screenshotPlaceholders` | `Record` | - | - |
| `projectSlugId` | `string` | - | - |
| `audienceSlug` | `string` | - | - |
| `documentSlugs` | `string[]` | - | - |
| `categorySlugs` | `Record` | - | - |
| `documentTitle` | `string` | - | - |
| `lang` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_MarkdownRenderer_14b499eb["MarkdownRenderer"]
    class component_MarkdownRenderer_14b499eb rootComponent
```

## Relationships

- RENDERS → `ReactMarkdown`
- RENDERS → `CustomImage`

<!-- source: interface-projectcardprops.md -->

# ProjectCardProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/components/ProjectCard.tsx` (line 9)

Props for ProjectCard component

## Properties

| Property | Type |
|---|---|
| `project` | `Project` |
| `onClick` | `(project: Project) => void` |
| `showDescription` | `boolean` |
| `showMenu` | `boolean` |
| `onDelete` | `(project: Project) => void` |

<!-- source: api-endpoint-submitfeedback.md -->

# submitFeedback

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 172)

## Endpoint

`POST /analytics/feedback`

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: component-marketinglayout.md -->

# MarketingLayout

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/(marketing)/layout.tsx` (line 8)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_MarketingLayout_7ec31db9["MarketingLayout"]
    class component_MarketingLayout_7ec31db9 rootComponent
```

## Relationships

- RENDERS → `Link`

<!-- source: interface-projectcomplexity.md -->

# ProjectComplexity

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-05.types.ts` (line 84)

Project complexity assessment for adaptive documentation generation.
Determines document count targets and category depth based on project characteristics.

## Properties

| Property | Type |
|---|---|
| `level` | `'simple' | 'medium' | 'complex' | 'enterprise'` |
| `score` | `number` |
| `factors` | `{
    featureCount: number;
    personaCount: number;
    chunkCount: number; // From stage 4 analyses
    topicCount: number; // Aggregated suggested topics
    avgComplexity: number; // Average chunk complexity score (1-3)
  }` |
| `recommendations` | `{
    targetDocuments: { min: number; max: number };
    categoryDepth: 1 | 2 | 3;
    topLevelCategories: { min: number; max: number };
  }` |

<!-- source: api-endpoint-summarize.md -->

# summarize

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/ai/ai.controller.ts` (line 100)

## Endpoint

`POST /ai/summarize`

## Referenced By

- `AIController` (MODULE_DECLARES)

<!-- source: component-mdxrenderer.md -->

# MDXRenderer

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/MDXRenderer.tsx` (line 36)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `content` | `string` | ✓ | - |
| `capturedScreenshots` | `Record` | - | - |

## Diagram

```mermaid
graph TD
    component_MDXRenderer_626cfb7b["MDXRenderer"]
    class component_MDXRenderer_626cfb7b rootComponent
```

## Relationships

- RENDERS → `MDXContent`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-projectlistparams.md -->

# ProjectListParams

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/projects.ts` (line 27)

Project list query parameters

## Properties

| Property | Type |
|---|---|
| `organizationId` | `string` |
| `search` | `string` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: api-endpoint-summary.md -->

# summary

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/billing/billing.controller.ts` (line 49)

## Endpoint

`GET /billing/summary`

## Referenced By

- `BillingController` (MODULE_DECLARES)

<!-- source: component-messagelist.md -->

# MessageList

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/MessageList.tsx` (line 27)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `messages` | `Message[]` | ✓ | - |
| `isLoading` | `boolean` | - | - |

## Diagram

```mermaid
graph TD
    component_MessageList_3afe25["MessageList"]
    class component_MessageList_3afe25 rootComponent
```

## Relationships

- RENDERS → `EmptyState`
- RENDERS → `ChatMessage`
- RENDERS → `LoadingSpinner`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-publishdocumentdto.md -->

# PublishDocumentDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/document.dto.ts` (line 48)

DTO for publishing a document

## Properties

| Property | Type |
|---|---|
| `state` | `DocumentState.PUBLISHED` |
| `isPublic` | `boolean` |
| `updatedById` | `string` |

<!-- source: api-endpoint-syncconnector.md -->

# syncConnector

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/technical-docs/technical-docs.controller.ts` (line 263)

## Endpoint

`POST /technical-docs/:projectId/connectors/:id/sync`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `TechnicalDocsController` (MODULE_DECLARES)

<!-- source: component-metriccard.md -->

# MetricCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/MetricCard.tsx` (line 41)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `label` | `string` | ✓ | - |
| `value` | `number | null | undefined` | ✓ | - |
| `previousValue` | `number | null` | - | - |
| `format` | `unknown | unknown | unknown` | - | "number" |
| `trend` | `number[]` | - | - |
| `icon` | `unknown` | - | - |
| `accent` | `string` | - | unknown |
| `onClick` | `Function` | - | - |
| `loading` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_MetricCard_622499c5["MetricCard"]
    class component_MetricCard_622499c5 rootComponent
```

## Relationships

- RENDERS → `ArrowUpIcon`
- RENDERS → `ArrowDownIcon`
- RENDERS → `MinusIcon`
- RENDERS → `ResponsiveContainer`
- RENDERS → `AreaChart`
- RENDERS → `Area`

<!-- source: interface-publishedprojectresponse-2.md -->

# PublishedProjectResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/project.dto.ts` (line 36)

Response after publishing a project

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `slug` | `string` |
| `urlId` | `string` |
| `publishedSlug` | `string` |
| `publicUrl` | `string` |
| `publishedAt` | `Date` |
| `isPublic` | `boolean` |

<!-- source: api-endpoint-syncdocuments.md -->

# syncDocuments

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/sync.controller.ts` (line 45)

## Endpoint

`POST /projects/:projectId/documents/sync`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `SyncController` (MODULE_DECLARES)

<!-- source: component-modal.md -->

# Modal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Boards/Modal.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `open` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `title` | `string` | ✓ | - |
| `subtitle` | `string` | - | - |
| `children` | `unknown` | ✓ | - |
| `footer` | `unknown` | - | - |
| `maxWidth` | `number` | - | 520 |

## Diagram

```mermaid
graph TD
    component_Modal_6532d240["Modal"]
    class component_Modal_6532d240 rootComponent
```

## Relationships

- RENDERS → `XMarkIcon`
- USES_HOOK → `useEffect`

<!-- source: interface-publishprojectdto.md -->

# PublishProjectDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/project.dto.ts` (line 29)

DTO for publishing a project

## Properties

| Property | Type |
|---|---|
| `isPublic` | `boolean` |

<!-- source: api-endpoint-syncentities.md -->

# syncEntities

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/kg-sync.controller.ts` (line 136)

Bulk sync entities

## Endpoint

`POST /projects/:projectId/entities/sync`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `KgSyncController` (MODULE_DECLARES)

<!-- source: component-navbar.md -->

# Navbar

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Layout/Navbar.tsx` (line 42)

## Diagram

```mermaid
graph TD
    component_Navbar_a0423c7["Navbar"]
    class component_Navbar_a0423c7 rootComponent
```

## Relationships

- RENDERS → `motion-nav`
- RENDERS → `Link`
- RENDERS → `Breadcrumbs`
- RENDERS → `ProjectDropdown`
- RENDERS → `VersionDropdown`
- RENDERS → `motion-button`
- RENDERS → `MagnifyingGlassIcon`
- RENDERS → `BellIcon`
- RENDERS → `ThemeToggle`
- USES_HOOK → `useSession`
- USES_HOOK → `useProjectContext`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-pydanticfield.md -->

# PydanticField

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/fastapi-detector.ts` (line 59)

Pydantic field

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `required` | `boolean` |
| `default` | `string` |
| `description` | `string` |

<!-- source: api-endpoint-syncentities-2.md -->

# syncEntities

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/sync.controller.ts` (line 187)

## Endpoint

`POST /projects/:projectId/entities/sync`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `SyncController` (MODULE_DECLARES)

<!-- source: component-newcommentform.md -->

# NewCommentForm

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Comments/NewCommentForm.tsx` (line 14)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `documentId` | `string` | ✓ | - |
| `onSubmit` | `Function` | ✓ | - |
| `placeholder` | `string` | - | "Add a comment..." |

## Diagram

```mermaid
graph TD
    component_NewCommentForm_13199295["NewCommentForm"]
    class component_NewCommentForm_13199295 rootComponent
```

## Relationships

- RENDERS → `Send`
- USES_HOOK → `useState`

<!-- source: interface-qualitygateconfig.md -->

# QualityGateConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/quality-gate.ts` (line 30)

## Properties

| Property | Type |
|---|---|
| `maxRegenAttempts` | `number` |
| `regenBatchSize` | `number` |
| `enabled` | `boolean` |

<!-- source: api-endpoint-syncrelationships.md -->

# syncRelationships

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/graph/kg-sync.controller.ts` (line 285)

Bulk sync relationships

## Endpoint

`POST /projects/:projectId/relationships/sync`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `KgSyncController` (MODULE_DECLARES)

<!-- source: component-newdocumentpage.md -->

# NewDocumentPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/documents/new/page.tsx` (line 25)

## Diagram

```mermaid
graph TD
    component_NewDocumentPage_11ba364c["NewDocumentPage"]
    class component_NewDocumentPage_11ba364c rootComponent
```

## Relationships

- RENDERS → `Button`
- RENDERS → `PenLine`
- RENDERS → `TemplateGallery`
- RENDERS → `ArrowLeft`
- RENDERS → `FileText`
- USES_HOOK → `useRouter`
- USES_HOOK → `useSearchParams`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useProjects`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-qualitygateresult.md -->

# QualityGateResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/quality-gate.ts` (line 36)

## Properties

| Property | Type |
|---|---|
| `documents` | `GeneratedDocument[]` |
| `scores` | `QualityScore[]` |
| `regenScores` | `QualityScore[]` |
| `tokenUsage` | `TokenUsage[]` |
| `stats` | `{
    total: number;
    passed: number;
    failed: number;
    regenerated: number;
    improvedAfterRegen: number;
  }` |

<!-- source: api-endpoint-syncrelationships-2.md -->

# syncRelationships

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/sync.controller.ts` (line 307)

## Endpoint

`POST /projects/:projectId/relationships/sync`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `SyncController` (MODULE_DECLARES)

<!-- source: component-newprojectpage.md -->

# NewProjectPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/new/page.tsx` (line 13)

## Diagram

```mermaid
graph TD
    component_NewProjectPage_13d75a88["NewProjectPage"]
    class component_NewProjectPage_13d75a88 rootComponent
```

## Relationships

- RENDERS → `NewProjectWizard`
- USES_HOOK → `useProjectContext`
- USES_HOOK → `useEffect`

<!-- source: interface-qualityscore.md -->

# QualityScore

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/quality-scorer.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `title` | `string` |
| `overall` | `number` |
| `dimensions` | `{
    domainSpecificity: number;   // 0.35 weight
    contentDepth: number;        // 0.25 weight
    sectionCompleteness: number; // 0.25 weight
    entityCoverage: number;      // 0.15 weight
  }` |
| `passesThreshold` | `boolean` |
| `failureReasons` | `string[]` |
| `suggestions` | `string[]` |

<!-- source: api-endpoint-testconnection.md -->

# testConnection

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/parsing/test-connection.controller.ts` (line 32)

## Endpoint

`POST /git/test-connection`

## Referenced By

- `TestConnectionController` (MODULE_DECLARES)

<!-- source: component-newprojectwizard.md -->

# NewProjectWizard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/NewProjectWizard.tsx` (line 23)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onComplete` | `Function` | - | - |
| `compact` | `boolean` | - | - |

## Diagram

```mermaid
graph TD
    component_NewProjectWizard_3328f9a7["NewProjectWizard"]
    class component_NewProjectWizard_3328f9a7 rootComponent
```

## Relationships

- RENDERS → `StepIndicator`
- RENDERS → `AnimatePresence`
- RENDERS → `SceneUrlInput`
- RENDERS → `SceneProjectDetails`
- RENDERS → `SceneBrowseRepos`
- RENDERS → `SceneDocTypes`
- RENDERS → `SceneGeneration`
- RENDERS → `SceneConnectProvider`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useNewProjectWizard`
- USES_HOOK → `useEffect`

<!-- source: interface-ratelimiterconfig.md -->

# RateLimiterConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/rate-limiter.ts` (line 10)

## Properties

| Property | Type |
|---|---|
| `maxConcurrent` | `number` |
| `minDelayMs` | `number` |

<!-- source: api-endpoint-tickettopics.md -->

# ticketTopics

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/manuals-insights/manuals-insights.controller.ts` (line 41)

## Endpoint

`GET /manuals-insights/:projectId/ticket-topics`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `ManualsInsightsController` (MODULE_DECLARES)

<!-- source: component-notfound.md -->

# NotFound

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/not-found.tsx` (line 3)

## Diagram

```mermaid
graph TD
    component_NotFound_1039b42e["NotFound"]
    class component_NotFound_1039b42e rootComponent
```

## Relationships

- RENDERS → `Link`

<!-- source: interface-realmplugin.md -->

# RealmPlugin

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/RealmWithPlugins.tsx` (line 9)

A plugin for the editor.

## Properties

| Property | Type |
|---|---|
| `init` | `(realm: Realm) => void` |
| `update` | `(realm: Realm) => void` |
| `postInit` | `(realm: Realm) => void` |

<!-- source: api-endpoint-togglesaml.md -->

# toggleSaml

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/saml/saml.controller.ts` (line 108)

Enable/disable SAML

## Endpoint

`POST /auth/saml/:orgId/toggle`

| Parameter | In | Type | Required |
|---|---|---|---|
| `orgId` | query | `string` | ✓ |

## Referenced By

- `SamlController` (MODULE_DECLARES)

<!-- source: component-opspage.md -->

# OpsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/ops/page.tsx` (line 13)

## Diagram

```mermaid
graph TD
    component_OpsPage_5b7d60c["OpsPage"]
    class component_OpsPage_5b7d60c rootComponent
```

## Relationships

- RENDERS → `Stat`
- RENDERS → `ManualInsightsPanel`
- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-registerdto.md -->

# RegisterDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/auth.ts` (line 14)

## Properties

| Property | Type |
|---|---|
| `email` | `string` |
| `password` | `string` |
| `name` | `string` |

<!-- source: api-endpoint-track.md -->

# track

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/analytics.controller.ts` (line 17)

## Endpoint

`POST /analytics/track`

## Referenced By

- `AnalyticsController` (MODULE_DECLARES)

<!-- source: component-organizationsettingspage.md -->

# OrganizationSettingsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/organization/page.tsx` (line 34)

## Diagram

```mermaid
graph TD
    component_OrganizationSettingsPage_ca1d90d["OrganizationSettingsPage"]
    class component_OrganizationSettingsPage_ca1d90d rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `UserGroupIcon`
- RENDERS → `Card`
- RENDERS → `CardHeader`
- RENDERS → `CardContent`
- RENDERS → `EnvelopeIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-renderoptions.md -->

# RenderOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/audience-renderer.ts` (line 23)

Render options

## Properties

| Property | Type |
|---|---|
| `viewerAudiences` | `string[]` |
| `expandIncludes` | `boolean` |
| `stripDirectives` | `boolean` |
| `maxIncludeDepth` | `number` |

<!-- source: api-endpoint-traffic.md -->

# traffic

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/events/agent-analytics.controller.ts` (line 17)

## Endpoint

`GET /agent-analytics/:projectId/traffic`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `days` | query | `string` | - |

## Referenced By

- `AgentAnalyticsController` (MODULE_DECLARES)

<!-- source: component-outofcredits.md -->

# OutOfCredits

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/common/OutOfCredits.tsx` (line 10)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `message` | `string` | - | - |
| `compact` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_OutOfCredits_100c002["OutOfCredits"]
    class component_OutOfCredits_100c002 rootComponent
```

## Relationships

- RENDERS → `Link`

<!-- source: interface-reordercategoriesdto.md -->

# ReorderCategoriesDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/category.dto.ts` (line 43)

DTO for reordering categories

## Properties

| Property | Type |
|---|---|
| `categoryIds` | `string[]` |

<!-- source: api-endpoint-transition.md -->

# transition

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/desk.controller.ts` (line 72)

## Endpoint

`POST /desk/:projectId/threads/:id/transition`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `DeskController` (MODULE_DECLARES)

<!-- source: component-overviewtab.md -->

# OverviewTab

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/dashboard/OverviewTab.tsx` (line 21)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `project` | `any` | ✓ | - |
| `documentCount` | `number` | ✓ | - |
| `categoryCount` | `number` | ✓ | - |
| `lastGeneratedAt` | `string | null` | ✓ | - |
| `recentDocuments` | `any[]` | ✓ | - |
| `jobs` | `any[]` | ✓ | - |
| `onGenerate` | `Function` | ✓ | - |
| `onNavigateSettings` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_OverviewTab_6d674d18["OverviewTab"]
    class component_OverviewTab_6d674d18 rootComponent
```

## Relationships

- RENDERS → `StatsRow`
- RENDERS → `RecentDocuments`
- RENDERS → `GenerationHistory`
- RENDERS → `QuickActions`
- RENDERS → `RepositoryInfo`
- RENDERS → `TeamActivity`

<!-- source: interface-replacementconfig.md -->

# ReplacementConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 302)

Replacement configuration

## Properties

| Property | Type |
|---|---|
| `format` | `ReplacementFormat` |
| `imageBaseUrl` | `string` |
| `addAltText` | `boolean` |
| `addCaption` | `boolean` |
| `wrapInFigure` | `boolean` |

<!-- source: api-endpoint-triggerscreenshots.md -->

# triggerScreenshots

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 211)

## Endpoint

`POST /doc-automation/jobs/:id/screenshots`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: component-pagination.md -->

# Pagination

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/enterprise/screenshots/Pagination.tsx` (line 9)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `currentPage` | `number` | ✓ | - |
| `totalPages` | `number` | ✓ | - |
| `totalItems` | `number` | ✓ | - |
| `pageSize` | `number` | ✓ | - |
| `onPageChange` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Pagination_642a4f8f["Pagination"]
    class component_Pagination_642a4f8f rootComponent
```

<!-- source: interface-replacementprogress.md -->

# ReplacementProgress

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-replacer.service.ts` (line 34)

Progress callback for replacement operations

## Properties

| Property | Type |
|---|---|
| `completed` | `number` |
| `total` | `number` |
| `currentDocument` | `string` |

<!-- source: api-endpoint-unpublish.md -->

# unpublish

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 395)

## Endpoint

`POST /documents/:id/unpublish`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: component-pagination-2.md -->

# Pagination

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Documents/Pagination.tsx` (line 9)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `currentPage` | `number` | ✓ | - |
| `totalPages` | `number` | ✓ | - |
| `onPageChange` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Pagination_1dabc9f3["Pagination"]
    class component_Pagination_1dabc9f3 rootComponent
```

<!-- source: interface-replacementstats.md -->

# ReplacementStats

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-replacer.service.ts` (line 45)

Replacement statistics

## Properties

| Property | Type |
|---|---|
| `documentsProcessed` | `number` |
| `totalReplacements` | `number` |
| `successfulReplacements` | `number` |
| `failedReplacements` | `number` |
| `skippedPlaceholders` | `number` |

<!-- source: api-endpoint-unpublish-2.md -->

# unpublish

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 409)

## Endpoint

`POST /projects/:id/unpublish`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: component-parserpage.md -->

# ParserPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/parser/page.tsx` (line 11)

## Diagram

```mermaid
graph TD
    component_ParserPage_1c3ca46["ParserPage"]
    class component_ParserPage_1c3ca46 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `CodeBracketIcon`
- RENDERS → `Card`
- RENDERS → `CardHeader`
- RENDERS → `CardContent`

<!-- source: interface-requestbody.md -->

# RequestBody

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/EndpointDetail.ts` (line 31)

## Properties

| Property | Type |
|---|---|
| `description` | `string` |
| `required` | `boolean` |
| `content` | `Record<string, { schema?: Schema; example?: any }>` |

<!-- source: api-endpoint-unresolve.md -->

# unresolve

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/comment/comment.controller.ts` (line 281)

Unresolve a previously resolved comment thread

## Endpoint

`POST /documents/:documentId/comments/:id/unresolve`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `CommentController` (MODULE_DECLARES)

<!-- source: component-parsingresults.md -->

# ParsingResults

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/ParsingResults.tsx` (line 22)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `result` | `ParseResult` | ✓ | - |
| `code` | `string` | ✓ | - |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_ParsingResults_746c7c70["ParsingResults"]
    class component_ParsingResults_746c7c70 rootComponent
```

## Relationships

- RENDERS → `TabButton`
- RENDERS → `SymbolList`
- RENDERS → `DependencyGraph`
- RENDERS → `CodeViewer`
- RENDERS → `ErrorIcon`
- RENDERS → `WarningIcon`
- USES_HOOK → `useState`

<!-- source: interface-requestbody-2.md -->

# RequestBody

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/RequestPanel.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `content` | `Record<string, { schema?: any; example?: any }>` |

<!-- source: api-endpoint-update-2.md -->

# update

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/audience/audience.controller.ts` (line 73)

## Endpoint

`PATCH /audiences/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `AudienceController` (MODULE_DECLARES)

<!-- source: component-pmepage.md -->

# PmePage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/pme/page.tsx` (line 20)

## Diagram

```mermaid
graph TD
    component_PmePage_4b64d5b8["PmePage"]
    class component_PmePage_4b64d5b8 rootComponent
```

## Relationships

- RENDERS → `GenerationWizard`
- RENDERS → `GenerationProgress`
- RENDERS → `VariantPicker`
- RENDERS → `PreviewPanel`
- USES_HOOK → `useState`
- USES_HOOK → `usePme`
- USES_HOOK → `useProjectContext`
- USES_HOOK → `useEffect`

<!-- source: interface-requestconfig.md -->

# RequestConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/types/config.ts` (line 58)

Request configuration for individual API calls

## Properties

| Property | Type |
|---|---|
| `method` | `'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'` |
| `path` | `string` |
| `params` | `Record<string, string | number | boolean | undefined>` |
| `body` | `unknown` |
| `headers` | `Record<string, string>` |
| `signal` | `AbortSignal` |
| `skipRetry` | `boolean` |
| `skipAuth` | `boolean` |

<!-- source: api-endpoint-update-3.md -->

# update

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 60)

## Endpoint

`PATCH /projects/:projectId/boards/:boardId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `boardId` | query | `string` | ✓ |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: component-pmestore-ts.md -->

# pmeStore.ts

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/stores/pmeStore.ts` (line 1)

## Diagram

```mermaid
graph TD
    component_pmeStore_ts_4662f3c5["pmeStore.ts"]
    class component_pmeStore_ts_4662f3c5 rootComponent
```

<!-- source: interface-requestdata.md -->

# RequestData

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/RequestPanel.ts` (line 35)

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `method` | `string` |
| `headers` | `Record<string, string>` |
| `queryParams` | `Record<string, string>` |
| `pathParams` | `Record<string, string>` |
| `body` | `string` |

<!-- source: api-endpoint-update-4.md -->

# update

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/comment/comment.controller.ts` (line 136)

Update a comment's content

## Endpoint

`PATCH /documents/:documentId/comments/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `CommentController` (MODULE_DECLARES)

<!-- source: component-previewpanel.md -->

# PreviewPanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/pme/preview-panel.tsx` (line 16)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onBack` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PreviewPanel_4d929768["PreviewPanel"]
    class component_PreviewPanel_4d929768 rootComponent
```

## Relationships

- USES_HOOK → `usePmeStore`
- USES_HOOK → `usePme`

<!-- source: interface-requiredstate.md -->

# RequiredState

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/screenshot-spec.types.ts` (line 33)

Required application state to capture this screenshot

## Properties

| Property | Type |
|---|---|
| `workflowStage` | `string` |
| `role` | `string` |
| `permission` | `string` |
| `dataCondition` | `string` |
| `resolution` | `StateResolutionHint` |

<!-- source: api-endpoint-update-5.md -->

# update

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 149)

## Endpoint

`PATCH /doc-versions/:projectId/:versionId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-prevnextnav.md -->

# PrevNextNav

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/PrevNextNav.tsx` (line 25)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `previous` | `NavDoc | null` | ✓ | - |
| `next` | `NavDoc | null` | ✓ | - |
| `slugId` | `string` | ✓ | - |
| `audienceSlug` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PrevNextNav_40589eca["PrevNextNav"]
    class component_PrevNextNav_40589eca rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `ArrowLeftIcon`
- RENDERS → `ArrowRightIcon`
- USES_HOOK → `useLanguageContext`

<!-- source: interface-response.md -->

# Response

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/EndpointDetail.ts` (line 37)

## Properties

| Property | Type |
|---|---|
| `description` | `string` |
| `content` | `Record<string, { schema?: Schema; example?: any }>` |

<!-- source: api-endpoint-update-6.md -->

# update

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/category.controller.ts` (line 81)

Update a category

## Endpoint

`PATCH /categories/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `CategoryController` (MODULE_DECLARES)

<!-- source: component-pricingpage.md -->

# PricingPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/(marketing)/pricing/page.tsx` (line 70)

## Diagram

```mermaid
graph TD
    component_PricingPage_f84597e["PricingPage"]
    class component_PricingPage_f84597e rootComponent
```

<!-- source: interface-restructureresult.md -->

# RestructureResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-14-meta/generators/category-restructure.ts` (line 39)

## Properties

| Property | Type |
|---|---|
| `categories` | `DocumentCategoryStructure[]` |
| `documents` | `PlannedDocument[]` |
| `adminDocIds` | `Set<string>` |
| `categoriesMoved` | `number` |

<!-- source: api-endpoint-update-7.md -->

# update

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 215)

## Endpoint

`PATCH /documents/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: component-privacypage.md -->

# PrivacyPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/privacy/page.tsx` (line 182)

## Diagram

```mermaid
graph TD
    component_PrivacyPage_41ce2e26["PrivacyPage"]
    class component_PrivacyPage_41ce2e26 rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `motion-div`
- RENDERS → `Reveal`

<!-- source: interface-retrievedcontext.md -->

# RetrievedContext

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-10.types.ts` (line 19)

Context retrieved from earlier pipeline stages for a specific document.
Built by ContextRetriever (Phase 2) using the StageResultStore.

## Properties

| Property | Type |
|---|---|
| `primaryChunkAnalysis` | `ChunkAnalysis` |
| `relatedChunkAnalyses` | `ChunkAnalysis[]` |
| `features` | `UserFeature[]` |
| `contextSummary` | `string` |

<!-- source: api-endpoint-update-8.md -->

# update

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/issues/issues.controller.ts` (line 85)

## Endpoint

`PATCH /projects/:projectId/issues/:issueId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `issueId` | query | `string` | ✓ |

## Referenced By

- `IssuesController` (MODULE_DECLARES)

<!-- source: component-progresspanel.md -->

# ProgressPanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/DocAutomation/ProgressPanel.tsx` (line 177)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `progress` | `number` | ✓ | - |
| `currentStage` | `string | null` | ✓ | - |
| `stageProgress` | `number` | ✓ | - |
| `currentItem` | `string | null` | ✓ | - |
| `elapsedMs` | `number` | - | - |
| `estimatedRemainingMs` | `number` | - | - |
| `isRunning` | `boolean` | ✓ | - |
| `isFailed` | `boolean` | ✓ | - |
| `isCancelled` | `boolean` | ✓ | - |
| `error` | `Error | null` | ✓ | - |
| `onCancel` | `Function` | - | - |
| `screenshotProgress` | `unknown | null` | - | - |
| `onCancelScreenshots` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_ProgressPanel_95fc7d4["ProgressPanel"]
    class component_ProgressPanel_95fc7d4 rootComponent
```

## Relationships

- RENDERS → `StopCircle`
- RENDERS → `motion-div`
- RENDERS → `Clock`
- RENDERS → `Loader2`
- RENDERS → `XCircle`
- RENDERS → `CheckCircle2`
- RENDERS → `Icon`
- RENDERS → `Camera`

<!-- source: interface-retryconfig-3.md -->

# RetryConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/providers/retry.ts` (line 10)

## Properties

| Property | Type |
|---|---|
| `maxRetries` | `number` |
| `baseDelayMs` | `number` |
| `maxDelayMs` | `number` |
| `retryableErrors` | `string[]` |

<!-- source: api-endpoint-update-9.md -->

# update

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/organization/organization.controller.ts` (line 70)

## Endpoint

`PATCH /organizations/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `OrganizationController` (MODULE_DECLARES)

<!-- source: component-projectcontext-ts.md -->

# projectContext.ts

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/stores/projectContext.ts` (line 1)

## Diagram

```mermaid
graph TD
    component_projectContext_ts_4b94091b["projectContext.ts"]
    class component_projectContext_ts_4b94091b rootComponent
```

<!-- source: interface-retryoptions.md -->

# RetryOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/utils/retry.ts` (line 6)

Options for retry logic

## Properties

| Property | Type |
|---|---|
| `maxRetries` | `number` |
| `baseDelay` | `number` |
| `maxDelay` | `number` |
| `shouldRetry` | `(error: Error, attempt: number) => boolean` |
| `onRetry` | `(error: Error, attempt: number, delay: number) => void` |

<!-- source: api-endpoint-update-10.md -->

# update

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 95)

## Endpoint

`PATCH /projects/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: component-projectdropdown.md -->

# ProjectDropdown

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Layout/ProjectDropdown.tsx` (line 28)

## Diagram

```mermaid
graph TD
    component_ProjectDropdown_2feb723["ProjectDropdown"]
    class component_ProjectDropdown_2feb723 rootComponent
```

## Relationships

- RENDERS → `FolderIcon`
- RENDERS → `Menu`
- RENDERS → `Menu-Button`
- RENDERS → `ChevronDownIcon`
- RENDERS → `Transition`
- RENDERS → `Menu-Items`
- RENDERS → `MagnifyingGlassIcon`
- RENDERS → `ClockIcon`
- RENDERS → `Menu-Item`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useProjectContext`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-reviewresult-2.md -->

# ReviewResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/openai-reviewer.service.ts` (line 37)

## Properties

| Property | Type |
|---|---|
| `overallScore` | `number` |
| `categories` | `{
    accuracy: number;
    completeness: number;
    clarity: number;
    userFriendliness: number;
  }` |
| `suggestions` | `string[]` |
| `issues` | `string[]` |

<!-- source: api-endpoint-update-11.md -->

# update

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/template/template.controller.ts` (line 187)

Update a template.
Only admins and maintainers can update templates.

## Endpoint

`PATCH /templates/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `TemplateController` (MODULE_DECLARES)

<!-- source: component-projectheader.md -->

# ProjectHeader

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/dashboard/ProjectHeader.tsx` (line 21)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `project` | `any` | ✓ | - |
| `onRegenerate` | `Function` | ✓ | - |
| `onNavigateSettings` | `Function` | ✓ | - |
| `onGenerate` | `Function` | - | - |
| `onExport` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_ProjectHeader_4cf00d68["ProjectHeader"]
    class component_ProjectHeader_4cf00d68 rootComponent
```

## Relationships

- RENDERS → `Link`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`

<!-- source: interface-routeinteractionmap.md -->

# RouteInteractionMap

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 214)

Complete interaction map for a single route

## Properties

| Property | Type |
|---|---|
| `route` | `string` |
| `componentName` | `string` |
| `sourceFile` | `string` |
| `templateFile` | `string` |
| `modals` | `ModalDefinition[]` |
| `tabs` | `TabDefinition[]` |
| `forms` | `FormDefinition[]` |
| `workflowStates` | `WorkflowStateDefinition[]` |
| `permissions` | `PermissionCheck[]` |

<!-- source: api-endpoint-updateaccess.md -->

# updateAccess

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 535)

## Endpoint

`POST /doc-versions/:projectId/:versionId/access`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-projectpage.md -->

# ProjectPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/page.tsx` (line 40)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ProjectPage_767b481d["ProjectPage"]
    class component_ProjectPage_767b481d rootComponent
```

## Relationships

- RENDERS → `ProjectHeader`
- RENDERS → `DashboardTabBar`
- RENDERS → `OverviewTab`
- RENDERS → `VersionsContent`
- RENDERS → `ExportModal`
- RENDERS → `GenerateDocModal`
- RENDERS → `Check`
- RENDERS → `Copy`
- RENDERS → `ExternalLink`
- RENDERS → `SiteUrlField`
- RENDERS → `CustomDomainPublishingRow`
- RENDERS → `ProjectPublishButton`
- RENDERS → `DocumentationAutomationSection`
- RENDERS → `WebhooksContent`
- RENDERS → `TechnicalDocsSection`
- RENDERS → `CapturedFlows`
- RENDERS → `RetentionPolicySection`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useProjectContext`
- USES_HOOK → `useProject`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useSearchParams`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-routemapentry.md -->

# RouteMapEntry

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 141)

Route mapping entry for AI-assisted screenshot capture
Maps URL paths to their component/template files and extracted selectors

## Properties

| Property | Type |
|---|---|
| `componentFile` | `string` |
| `templateFile` | `string` |
| `selectors` | `{
    buttons?: Array<{ selector: string; text?: string }>;
    inputs?: Array<{ selector: string }>;
    links?: Array<{ selector: string; text?: string }>;
    modals?: Array<{ selector: string }>;
    tables?: Array<{ selector: string }>;
    forms?: Array<{ selector: string }>;
  }` |
| `requiredAuth` | `boolean` |

<!-- source: api-endpoint-updateagent.md -->

# updateAgent

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.controller.ts` (line 127)

## Endpoint

`PUT /support-agent/:projectId/agents/:agentId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `agentId` | query | `string` | ✓ |

## Referenced By

- `SupportAgentController` (MODULE_DECLARES)

<!-- source: component-projectspage.md -->

# ProjectsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/page.tsx` (line 31)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `showMenu` | `boolean` | - | true |
| `limit` | `number` | - | 0 |

## Diagram

```mermaid
graph TD
    component_ProjectsPage_781eeb9a["ProjectsPage"]
    class component_ProjectsPage_781eeb9a rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `EmptyState-98f5e`
- RENDERS → `MagnifyingGlassIcon`
- RENDERS → `PlusIcon`
- RENDERS → `StatCard`
- RENDERS → `FolderIcon`
- RENDERS → `BoltIcon`
- RENDERS → `CheckCircleIcon`
- RENDERS → `DocumentTextIcon`
- RENDERS → `AnimatePresence`
- RENDERS → `ProjectCardCustom`
- RENDERS → `DeleteProjectModal`
- USES_HOOK → `useSession`
- USES_HOOK → `useProjects`
- USES_HOOK → `useRouter`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useProjectContext`
- USES_HOOK → `useState`
- USES_HOOK → `useMemo`

<!-- source: interface-routemapping.md -->

# RouteMapping

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 75)

Mapping from a route path to its component, template, and selectors

## Properties

| Property | Type |
|---|---|
| `path` | `string` |
| `fullUrl` | `string` |
| `routeFile` | `string` |
| `componentFile` | `string` |
| `templateFile` | `string` |
| `extractedSelectors` | `ExtractedSelectors` |
| `requiredAuth` | `boolean` |
| `requiredRoles` | `string[]` |
| `framework` | `FrameworkType` |
| `confidence` | `ConfidenceLevel` |

<!-- source: api-endpoint-updatebranding.md -->

# updateBranding

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/branding/branding.controller.ts` (line 24)

## Endpoint

`PATCH /projects/:projectId/branding`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `BrandingController` (MODULE_DECLARES)

<!-- source: component-promptinput.md -->

# PromptInput

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/PromptInput.tsx` (line 27)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onSubmit` | `Function` | ✓ | - |
| `onEnhance` | `Function` | - | - |
| `onOutline` | `Function` | - | - |
| `onImprove` | `Function` | - | - |
| `onSummarize` | `Function` | - | - |
| `isLoading` | `boolean` | - | false |
| `isStreaming` | `boolean` | - | false |
| `placeholder` | `string` | - | "Ask the AI assistant..." |

## Diagram

```mermaid
graph TD
    component_PromptInput_25256c05["PromptInput"]
    class component_PromptInput_25256c05 rootComponent
```

## Relationships

- RENDERS → `QuickActionButton`
- RENDERS → `Sparkles`
- RENDERS → `FileText`
- RENDERS → `Edit3`
- RENDERS → `FileCheck`
- RENDERS → `Loader2`
- RENDERS → `Send`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`

<!-- source: interface-routemappingresult.md -->

# RouteMappingResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 119)

Result of route mapping extraction

## Properties

| Property | Type |
|---|---|
| `mappings` | `RouteMapping[]` |
| `stats` | `RouteMappingStats` |

<!-- source: api-endpoint-updatecolumn.md -->

# updateColumn

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/boards/boards.controller.ts` (line 115)

## Endpoint

`PATCH /projects/:projectId/boards/:boardId/columns/:columnId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `boardId` | query | `string` | ✓ |
| `columnId` | query | `string` | ✓ |

## Referenced By

- `BoardsController` (MODULE_DECLARES)

<!-- source: component-promptlibrary.md -->

# PromptLibrary

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/PromptLibrary.tsx` (line 14)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `prompts` | `PromptTemplate[]` | ✓ | - |
| `onCreatePrompt` | `Function` | ✓ | - |
| `onUpdatePrompt` | `Function` | ✓ | - |
| `onDeletePrompt` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PromptLibrary_15c6ac65["PromptLibrary"]
    class component_PromptLibrary_15c6ac65 rootComponent
```

## Relationships

- RENDERS → `PromptForm`
- RENDERS → `PromptCard`
- USES_HOOK → `useState`

<!-- source: interface-routemappingstats.md -->

# RouteMappingStats

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 101)

Statistics about route mapping extraction

## Properties

| Property | Type |
|---|---|
| `totalRoutes` | `number` |
| `mappedRoutes` | `number` |
| `unmappedRoutes` | `number` |
| `routesWithSelectors` | `number` |
| `totalSelectors` | `number` |
| `framework` | `FrameworkType` |

<!-- source: api-endpoint-updateconfig.md -->

# updateConfig

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 74)

## Endpoint

`PUT /doc-automation/config/:projectId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: component-providerconfig.md -->

# ProviderConfig

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/ProviderConfig.tsx` (line 14)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `providers` | `AIProvider[]` | ✓ | - |
| `defaultProvider` | `AIProviderName` | ✓ | - |
| `onProviderChange` | `Function` | ✓ | - |
| `onTestConnection` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ProviderConfig_5a261ae1["ProviderConfig"]
    class component_ProviderConfig_5a261ae1 rootComponent
```

## Relationships

- RENDERS → `StatusBadge`
- RENDERS → `TestResultBadge`
- USES_HOOK → `useState`

<!-- source: interface-sandpackeditorprops.md -->

# SandpackEditorProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/sandpack/SandpackEditor.tsx` (line 22)

## Properties

| Property | Type |
|---|---|
| `preset` | `SandpackPreset` |

<!-- source: api-endpoint-updatememberrole.md -->

# updateMemberRole

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 210)

## Endpoint

`PATCH /projects/:id/members/:userId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `userId` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: component-providers.md -->

# Providers

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Providers.tsx` (line 44)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_Providers_715f6a8c["Providers"]
    class component_Providers_715f6a8c rootComponent
```

## Relationships

- RENDERS → `SessionProvider`
- RENDERS → `AtloriaProviderWrapper`

<!-- source: interface-saveimageparameters.md -->

# SaveImageParameters

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 81)

## Properties

| Property | Type |
|---|---|
| `src` | `string` |
| `file` | `FileList` |

<!-- source: api-endpoint-updateplaceholder.md -->

# updatePlaceholder

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 357)

PATCH a screenshot placeholder — update blob URL, status, or other fields.
Used by the screenshot management page to manually replace or update screenshots.

## Endpoint

`PATCH /doc-versions/:projectId/:versionId/screenshots/placeholders/:placeholderId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `versionId` | query | `string` | ✓ |
| `placeholderId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-publicapiplaygroundpage.md -->

# PublicApiPlaygroundPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/api/page.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PublicApiPlaygroundPage_a977278["PublicApiPlaygroundPage"]
    class component_PublicApiPlaygroundPage_a977278 rootComponent
```

## Relationships

- RENDERS → `Link`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-schema.md -->

# Schema

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/EndpointDetail.ts` (line 42)

## Properties

| Property | Type |
|---|---|
| `type` | `string` |
| `format` | `string` |
| `properties` | `Record<string, Schema>` |
| `items` | `Schema` |
| `required` | `string[]` |
| `example` | `any` |
| `enum` | `any[]` |
| `description` | `string` |
| `$ref` | `string` |
| `nullable` | `boolean` |

<!-- source: api-endpoint-updateput.md -->

# updatePut

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 120)

## Endpoint

`PUT /projects/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: component-publicdocumentpage.md -->

# PublicDocumentPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/[audienceSlug]/[documentSlug]/page.tsx` (line 286)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PublicDocumentPage_9f14768["PublicDocumentPage"]
    class component_PublicDocumentPage_9f14768 rootComponent
```

## Relationships

- RENDERS → `CategoryDocumentList`
- RENDERS → `PortalTableOfContents`
- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `Breadcrumbs`
- RENDERS → `ManualFreshnessBadge`
- RENDERS → `DocMeta`
- RENDERS → `ConnectAiMenu`
- RENDERS → `MarkdownRenderer`
- RENDERS → `HelpfulnessWidget`
- RENDERS → `RelatedArticles`
- RENDERS → `PrevNextNav`
- RENDERS → `ReportIssueModal`
- USES_HOOK → `useParams`
- USES_HOOK → `useSession`
- USES_HOOK → `useRouter`
- USES_HOOK → `usePublicProjectContext`
- USES_HOOK → `useVersionContext`
- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useBranding`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useMemo`
- USES_HOOK → `useEffect`
- USES_HOOK → `usePageTracking`
- USES_HOOK → `useCallback`

<!-- source: interface-screenapimap.md -->

# ScreenApiMap

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/cross-language.types.ts` (line 117)

Full Screen-to-API map for a component

The final output connecting UI to backend for documentation.

## Properties

| Property | Type |
|---|---|
| `componentName` | `string` |
| `componentPath` | `string` |
| `route` | `string` |
| `apiCalls` | `Array<{
    userAction: string; // "Click Save button"
    serviceMethod: string; // "newJobService.createJob()"
    httpMethod: string; // "POST"
    endpoint: string; // "/api/sales/jobs"
    purpose: string; // "Create new sales job"
    triggerElement?: string; // "dx-button[text='Save']"
  }>` |
| `stateBasedCalls` | `Array<{
    state: string; // "OrderStageEnum.Pending"
    availableActions: string[]; // ["approve", "reject", "cancel"]
    disabledActions: string[]; // ["createNew"]
  }>` |

<!-- source: api-endpoint-updatereport.md -->

# updateReport

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/analytics/export/analytics-export.controller.ts` (line 107)

## Endpoint

`PATCH /analytics/:projectId/reports/:id`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `AnalyticsExportController` (MODULE_DECLARES)

<!-- source: component-publicdocumentpage-2.md -->

# PublicDocumentPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/public/documents/[id]/page.tsx` (line 33)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PublicDocumentPage_12b0d4c8["PublicDocumentPage"]
    class component_PublicDocumentPage_12b0d4c8 rootComponent
```

## Relationships

- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `MDXEditor`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-screenshotaction.md -->

# ScreenshotAction

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 16)

Screenshot Worker Client Types

Type definitions for communication with the screenshot-worker API.
These types mirror the screenshot-worker DTOs but are decoupled for
use in the doc-automation package.

## Properties

| Property | Type |
|---|---|
| `type` | `'click' | 'dblclick' | 'type' | 'fill' | 'press' | 'wait' | 'scroll' | 'hover' | 'focus' | 'blur' | 'select' | 'navigate' | 'frame' | 'close-modal' | 'switch-tab' | 'freeze-toast'` |
| `selector` | `string` |
| `selectorHint` | `string` |
| `value` | `string` |
| `duration` | `number` |
| `key` | `string` |
| `frameAction` | `'enter' | 'exit'` |
| `optional` | `boolean` |
| `description` | `string` |
| `waitAfter` | `number` |

<!-- source: api-endpoint-updatesettings.md -->

# updateSettings

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/organization/organization.controller.ts` (line 155)

## Endpoint

`PATCH /organizations/:id/settings`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `OrganizationController` (MODULE_DECLARES)

<!-- source: component-publicentitydetailpage.md -->

# PublicEntityDetailPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/technical/entity/[entityId]/page.tsx` (line 109)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PublicEntityDetailPage_6bd574bb["PublicEntityDetailPage"]
    class component_PublicEntityDetailPage_6bd574bb rootComponent
```

## Relationships

- RENDERS → `EntityTree`
- RENDERS → `RelationsPanel`
- RENDERS → `Link`
- RENDERS → `typeConfig-Icon`
- RENDERS → `SparklesIcon`
- RENDERS → `Tab`
- RENDERS → `FieldsTable`
- RENDERS → `MethodsTable`
- RENDERS → `AiEnrichmentContent`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-screenshotaction-2.md -->

# ScreenshotAction

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 78)

Action to perform before taking screenshot

## Properties

| Property | Type |
|---|---|
| `type` | `'click' | 'dblclick' | 'type' | 'fill' | 'press' | 'wait' | 'scroll' | 'hover' | 'focus' | 'blur' | 'select' | 'navigate' | 'frame' | 'close-modal' | 'switch-tab' | 'freeze-toast'` |
| `selector` | `string` |
| `value` | `string` |
| `duration` | `number` |
| `key` | `string` |
| `optional` | `boolean` |
| `waitAfter` | `number` |
| `description` | `string` |

<!-- source: api-endpoint-updatesettings-2.md -->

# updateSettings

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/project/project.controller.ts` (line 280)

## Endpoint

`PATCH /projects/:id/settings`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `ProjectController` (MODULE_DECLARES)

<!-- source: component-publiclayoutshell.md -->

# PublicLayoutShell

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/PublicLayoutShell.tsx` (line 223)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PublicLayoutShell_20e422b6["PublicLayoutShell"]
    class component_PublicLayoutShell_20e422b6 rootComponent
```

## Relationships

- RENDERS → `PublicProjectProvider`
- RENDERS → `BrandingProviderWrapper`
- RENDERS → `VersionProviderWrapper`
- RENDERS → `LanguageProviderWrapper`
- RENDERS → `PublicProjectLayoutInner`
- USES_HOOK → `usePathname`

<!-- source: interface-screenshotbatchrequest.md -->

# ScreenshotBatchRequest

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 170)

Main batch screenshot request

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `organizationId` | `string` |
| `capturedBy` | `string` |
| `name` | `string` |
| `description` | `string` |
| `auth` | `BatchAuthConfig` |
| `screenshots` | `ScreenshotItem[]` |
| `config` | `BatchConfig` |
| `repoPath` | `string` |
| `routeMap` | `Record<string, RouteMapEntry>` |
| `aiAssisted` | `AIAssistedConfig` |

<!-- source: api-endpoint-updatesteps.md -->

# updateSteps

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/capture/capture.controller.ts` (line 65)

## Endpoint

`PATCH /capture/:projectId/flows/:id/steps`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |
| `id` | query | `string` | ✓ |

## Referenced By

- `CaptureController` (MODULE_DECLARES)

<!-- source: component-publicprojectaudiencepage.md -->

# PublicProjectAudiencePage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/[audienceSlug]/page.tsx` (line 50)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PublicProjectAudiencePage_8337f31["PublicProjectAudiencePage"]
    class component_PublicProjectAudiencePage_8337f31 rootComponent
```

## Relationships

- RENDERS → `CategoryDocumentList`
- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `Breadcrumbs`
- RENDERS → `Link`
- RENDERS → `ArrowRightIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useRouter`
- USES_HOOK → `usePublicProjectContext`
- USES_HOOK → `useVersionContext`
- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`
- USES_HOOK → `useMemo`
- USES_HOOK → `useEffect`

<!-- source: interface-screenshoterror.md -->

# ScreenshotError

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 431)

Error during screenshot processing

## Properties

| Property | Type |
|---|---|
| `stage` | `'12A' | '12B' | '12C' | '12D' | '12E'` |
| `placeholderId` | `string` |
| `documentId` | `string` |
| `error` | `string` |
| `recoverable` | `boolean` |
| `timestamp` | `Date` |

<!-- source: api-endpoint-updatetriggerconfig.md -->

# updateTriggerConfig

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/documentation/doc-automation.controller.ts` (line 243)

## Endpoint

`PUT /doc-automation/config/:projectId/triggers`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `DocAutomationController` (MODULE_DECLARES)

<!-- source: component-publicprojectlayout.md -->

# PublicProjectLayout

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/layout.tsx` (line 59)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PublicProjectLayout_4eda7201["PublicProjectLayout"]
    class component_PublicProjectLayout_4eda7201 rootComponent
```

## Relationships

- RENDERS → `PublicLayoutShell`

<!-- source: interface-screenshotfailure.md -->

# ScreenshotFailure

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 240)

Screenshot failure record

## Properties

| Property | Type |
|---|---|
| `url` | `string` |
| `error` | `string` |
| `retryCount` | `number` |
| `stage` | `string` |
| `failedAt` | `string` |

<!-- source: api-endpoint-updateuseraudiences.md -->

# updateUserAudiences

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/organization/organization.controller.ts` (line 206)

## Endpoint

`PATCH /organizations/:id/members/:userId/audiences`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `userId` | query | `string` | ✓ |

## Referenced By

- `OrganizationController` (MODULE_DECLARES)

<!-- source: component-publicprojectpage.md -->

# PublicProjectPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/page.tsx` (line 65)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PublicProjectPage_6b0f4c1f["PublicProjectPage"]
    class component_PublicProjectPage_6b0f4c1f rootComponent
```

## Relationships

- RENDERS → `FileText`
- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `VersionSwitcher`
- USES_HOOK → `useSession`
- USES_HOOK → `useRouter`
- USES_HOOK → `usePathname`
- USES_HOOK → `useSearchParams`
- USES_HOOK → `usePublicProjectContext`
- USES_HOOK → `useVersionContext`
- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`
- USES_HOOK → `useMemo`
- USES_HOOK → `usePageTracking`
- USES_HOOK → `useEffect`

<!-- source: interface-screenshotitem.md -->

# ScreenshotItem

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 65)

Individual screenshot item in a batch request

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `description` | `string` |
| `url` | `string` |
| `expectedState` | `string` |
| `viewport` | `Viewport` |
| `fullPage` | `boolean` |
| `waitFor` | `WaitFor` |
| `waitForSelector` | `string` |
| `waitForTimeout` | `number` |
| `actions` | `ScreenshotAction[]` |
| `stateType` | `'default' | 'hover' | 'modal' | 'error' | 'success' | 'loading' | 'focus' | 'active' | 'disabled'` |
| `category` | `string` |
| `clip` | `Clip` |
| `metadata` | `Record<string, unknown>` |
| `flowStepId` | `string` |
| `priority` | `number` |
| `stateResolution` | `{
    listUrl: string;
    statusColumnHint: string;
    targetStatusValue: string;
    maxRowsToScan?: number;
    rowAction: 'click' | 'dblclick';
  }` |
| `parentPlaceholderId` | `string` |
| `sequenceOrder` | `number` |

<!-- source: api-endpoint-updateversionmetadata.md -->

# updateVersionMetadata

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/document/document.controller.ts` (line 658)

## Endpoint

`PATCH /documents/:id/versions/:versionId`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocumentController` (MODULE_DECLARES)

<!-- source: component-publicprojectprovider.md -->

# PublicProjectProvider

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/project-context.tsx` (line 58)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PublicProjectProvider_3203aa9f["PublicProjectProvider"]
    class component_PublicProjectProvider_3203aa9f rootComponent
```

## Relationships

- RENDERS → `PublicProjectContext-Provider`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-screenshotmapping.md -->

# ScreenshotMapping

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 279)

Screenshot upload mapping

## Properties

| Property | Type |
|---|---|
| `localPath` | `string` |
| `cdnUrl` | `string` |
| `screenshotId` | `string` |

<!-- source: api-endpoint-uploadimage.md -->

# uploadImage

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/assets/assets.controller.ts` (line 26)

## Endpoint

`POST /assets/upload`

## Referenced By

- `AssetsController` (MODULE_DECLARES)

<!-- source: component-publicsearchmodal.md -->

# PublicSearchModal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/PublicSearchModal.tsx` (line 45)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `slugId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PublicSearchModal_78f3e556["PublicSearchModal"]
    class component_PublicSearchModal_78f3e556 rootComponent
```

## Relationships

- RENDERS → `Search`
- RENDERS → `X`
- RENDERS → `FileText`
- RENDERS → `ArrowRight`
- RENDERS → `WifiOff`
- USES_HOOK → `useRouter`
- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-screenshotmapping-2.md -->

# ScreenshotMapping

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 103)

Mapping from description to capture instructions

## Properties

| Property | Type |
|---|---|
| `placeholderId` | `string` |
| `description` | `string` |
| `url` | `string` |
| `waitForSelector` | `string` |
| `waitForTimeout` | `number` |
| `actions` | `ScreenshotAction[]` |
| `viewport` | `Viewport` |
| `fullPage` | `boolean` |
| `clip` | `{ x: number; y: number; width: number; height: number }` |
| `category` | `string` |
| `confidence` | `number` |
| `requiresAuth` | `boolean` |
| `notes` | `string` |
| `stateResolution` | `StateResolutionConfig` |
| `sequenceSteps` | `ScreenshotMapping[]` |
| `sequenceOrder` | `number` |
| `parentPlaceholderId` | `string` |

<!-- source: api-endpoint-uploadscreenshot.md -->

# uploadScreenshot

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/doc-version/doc-version.controller.ts` (line 289)

## Endpoint

`POST /doc-versions/:projectId/:versionId/screenshots/upload`

| Parameter | In | Type | Required |
|---|---|---|---|
| `versionId` | query | `string` | ✓ |

## Referenced By

- `DocVersionController` (MODULE_DECLARES)

<!-- source: component-publictechnicalpage.md -->

# PublicTechnicalPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/technical/page.tsx` (line 14)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PublicTechnicalPage_313152cd["PublicTechnicalPage"]
    class component_PublicTechnicalPage_313152cd rootComponent
```

## Relationships

- RENDERS → `EntityTree`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-screenshotplaceholder.md -->

# ScreenshotPlaceholder

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 37)

A screenshot placeholder extracted from documents

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `description` | `string` |
| `occurrences` | `PlaceholderOccurrence[]` |
| `status` | `ScreenshotStatus` |
| `category` | `string` |
| `priority` | `number` |

<!-- source: api-endpoint-upsertconfig.md -->

# upsertConfig

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/support-agent/support-agent.controller.ts` (line 54)

PUT /support-agent/:projectId/config
Upserts the support agent config.

## Endpoint

`PUT /support-agent/:projectId/config`

| Parameter | In | Type | Required |
|---|---|---|---|
| `projectId` | query | `string` | ✓ |

## Referenced By

- `SupportAgentController` (MODULE_DECLARES)

<!-- source: component-publicticketpage.md -->

# PublicTicketPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/issues/[ticketNumber]/page.tsx` (line 264)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_PublicTicketPage_6cb2e091["PublicTicketPage"]
    class component_PublicTicketPage_6cb2e091 rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `BackgroundDecoration`
- RENDERS → `TopBar`
- RENDERS → `StatusJourney`
- RENDERS → `ReactMarkdown`
- RENDERS → `CsatCard`
- RENDERS → `ReplyComposer`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-screenshotprogress.md -->

# ScreenshotProgress

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 491)

## Properties

| Property | Type |
|---|---|
| `stage` | `'12A' | '12B' | '12C' | '12D' | '12E'` |
| `stageProgress` | `number` |
| `overallProgress` | `number` |
| `currentItem` | `string` |
| `stats` | `Partial<ScreenshotStats>` |

<!-- source: api-endpoint-usetemplate.md -->

# useTemplate

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/template/template.controller.ts` (line 114)

Create a document from a template.
Any authenticated user can use templates to create documents.

## Endpoint

`POST /templates/:id/use`

| Parameter | In | Type | Required |
|---|---|---|---|
| `id` | query | `string` | ✓ |

## Referenced By

- `TemplateController` (MODULE_DECLARES)

<!-- source: component-queuerail.md -->

# QueueRail

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/QueueRail.tsx` (line 51)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `bucket` | `BucketKey` | ✓ | - |
| `counts` | `DeskCounts | null` | ✓ | - |
| `hotBuckets` | `Set` | ✓ | - |
| `onSelect` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_QueueRail_17b0a62a["QueueRail"]
    class component_QueueRail_17b0a62a rootComponent
```

## Relationships

- RENDERS → `InboxIcon`

<!-- source: interface-screenshotregistry.md -->

# ScreenshotRegistry

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 58)

Registry of all screenshot placeholders for a job

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `configId` | `string` |
| `jobId` | `string` |
| `totalPlaceholders` | `number` |
| `uniqueDescriptions` | `number` |
| `placeholders` | `ScreenshotPlaceholder[]` |
| `urlGroups` | `UrlGroup[]` |
| `stats` | `ScreenshotStats` |
| `createdAt` | `Date` |
| `updatedAt` | `Date` |

<!-- source: api-endpoint-verifyemail.md -->

# verifyEmail

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/auth/auth.controller.ts` (line 83)

## Endpoint

`POST /auth/verify-email`

## Referenced By

- `AuthController` (MODULE_DECLARES)

<!-- source: component-quickactions.md -->

# QuickActions

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/dashboard/QuickActions.tsx` (line 51)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `onGenerate` | `Function` | ✓ | - |
| `onNavigateSettings` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_QuickActions_7a290d12["QuickActions"]
    class component_QuickActions_7a290d12 rootComponent
```

## Relationships

- USES_HOOK → `useRouter`

<!-- source: interface-screenshotresult-2.md -->

# ScreenshotResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 215)

Individual screenshot result

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `screenshotId` | `string` |
| `url` | `string` |
| `blobUrl` | `string` |
| `viewport` | `{ width: number; height: number }` |
| `dimensions` | `{ width: number; height: number }` |
| `size` | `number` |
| `version` | `number` |
| `isNew` | `boolean` |
| `stateType` | `string` |
| `category` | `string` |
| `description` | `string` |
| `capturedAt` | `string` |
| `featureArea` | `string` |
| `pageType` | `string` |
| `semanticTags` | `string[]` |
| `recoveryAttempts` | `number` |
| `recoverySucceeded` | `boolean` |
| `successfulSelector` | `string` |

<!-- source: api-endpoint-webhook.md -->

# webhook

**Kind:** API Endpoint

**Source:** `atloria-monorepo/apps/api/src/billing/billing.controller.ts` (line 57)

## Endpoint

`POST /billing/webhook`

## Referenced By

- `BillingController` (MODULE_DECLARES)

<!-- source: component-recentdocuments.md -->

# RecentDocuments

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/dashboard/RecentDocuments.tsx` (line 46)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `documents` | `RecentDoc[]` | ✓ | - |
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_RecentDocuments_6feb1c08["RecentDocuments"]
    class component_RecentDocuments_6feb1c08 rootComponent
```

## Relationships

- USES_HOOK → `useRouter`

<!-- source: interface-screenshotspec.md -->

# ScreenshotSpec

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/screenshot-spec.types.ts` (line 135)

Enhanced screenshot specification combining InteractionMap + SiteMap data.
Extends the base ScreenshotMapping with source-grounded metadata.

## Properties

| Property | Type |
|---|---|
| `placeholderId` | `string` |
| `description` | `string` |
| `url` | `string` |
| `source` | `MappingSource` |
| `confidence` | `number` |
| `captureType` | `CaptureType` |
| `requiredState` | `RequiredState` |
| `modal` | `ModalCaptureSpec` |
| `tab` | `TabCaptureSpec` |
| `form` | `FormCaptureSpec` |
| `workflowSequence` | `WorkflowSequenceSpec` |
| `actions` | `ScreenshotAction[]` |
| `viewport` | `Viewport` |
| `fullPage` | `boolean` |
| `clip` | `{ x: number; y: number; width: number; height: number }` |
| `category` | `string` |
| `requiresAuth` | `boolean` |
| `notes` | `string` |
| `componentName` | `string` |
| `sourceFile` | `string` |

<!-- source: component-registerpage.md -->

# RegisterPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/(auth)/register/page.tsx` (line 12)

## Diagram

```mermaid
graph TD
    component_RegisterPage_270199ae["RegisterPage"]
    class component_RegisterPage_270199ae rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-h1`
- RENDERS → `motion-button`
- RENDERS → `Link`
- USES_HOOK → `useRouter`
- USES_HOOK → `useSearchParams`
- USES_HOOK → `useState`

<!-- source: interface-screenshotstageconfig.md -->

# ScreenshotStageConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 343)

Configuration for the entire screenshot stage

## Properties

| Property | Type |
|---|---|
| `siteUrl` | `string` |
| `siteLoginUrl` | `string` |
| `siteEmail` | `string` |
| `sitePassword` | `string` |
| `framework` | `string` |
| `viewport` | `Viewport` |
| `fullPage` | `boolean` |
| `format` | `'png' | 'jpeg' | 'webp'` |
| `quality` | `number` |
| `maxConcurrentSessions` | `number` |
| `batchSize` | `number` |
| `maxRetries` | `number` |
| `uploadToAzure` | `boolean` |
| `azureContainerName` | `string` |
| `checkForDuplicates` | `boolean` |
| `replacementFormat` | `ReplacementFormat` |
| `skipCapture` | `boolean` |
| `skipUpload` | `boolean` |
| `skipReplacement` | `boolean` |

<!-- source: component-relatedarticles.md -->

# RelatedArticles

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/RelatedArticles.tsx` (line 36)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `slugId` | `string` | ✓ | - |
| `audienceSlug` | `string` | ✓ | - |
| `docSlug` | `string` | ✓ | - |
| `version` | `string` | - | - |
| `lang` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_RelatedArticles_1614f3ea["RelatedArticles"]
    class component_RelatedArticles_1614f3ea rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `DocumentTextIcon`
- RENDERS → `ArrowUpRightIcon`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-screenshotstageinput.md -->

# ScreenshotStageInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 328)

Input to Stage 12

## Properties

| Property | Type |
|---|---|
| `documents` | `GeneratedDocument[]` |
| `config` | `ScreenshotStageConfig` |
| `outputDir` | `string` |
| `jobId` | `string` |
| `projectId` | `string` |
| `routeMappings` | `RouteMappingResult` |
| `repoPath` | `string` |

<!-- source: component-relationspanel.md -->

# RelationsPanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/components/RelationsPanel.tsx` (line 104)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `entity` | `any` | ✓ | - |
| `outgoing` | `Relationship[]` | ✓ | - |
| `incoming` | `Relationship[]` | ✓ | - |
| `linkedDocs` | `LinkedDoc[]` | ✓ | - |
| `projectId` | `string` | ✓ | - |
| `entityMap` | `Record` | ✓ | - |
| `entityHrefBase` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_RelationsPanel_656c85ab["RelationsPanel"]
    class component_RelationsPanel_656c85ab rootComponent
```

## Relationships

- RENDERS → `RelItem`
- RENDERS → `SparklesIcon`

<!-- source: interface-screenshotstageoutput.md -->

# ScreenshotStageOutput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 380)

Output from Stage 12

## Properties

| Property | Type |
|---|---|
| `registry` | `ScreenshotRegistry` |
| `screenshots` | `CapturedScreenshot[]` |
| `updatedDocuments` | `GeneratedDocument[]` |
| `stats` | `ScreenshotStats` |
| `errors` | `ScreenshotError[]` |

<!-- source: component-replyform.md -->

# ReplyForm

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Comments/CommentForm.tsx` (line 359)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `documentId` | `string` | ✓ | - |
| `projectId` | `string` | - | - |
| `parentId` | `string` | ✓ | - |
| `onSubmit` | `Function` | ✓ | - |
| `onCancel` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ReplyForm_5dcf293c["ReplyForm"]
    class component_ReplyForm_5dcf293c rootComponent
```

## Relationships

- RENDERS → `CommentForm`

<!-- source: interface-screenshotstats.md -->

# ScreenshotStats

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 391)

Statistics for the screenshot stage

## Properties

| Property | Type |
|---|---|
| `totalPlaceholders` | `number` |
| `uniqueDescriptions` | `number` |
| `mapped` | `number` |
| `unmapped` | `number` |
| `lowConfidence` | `number` |
| `captured` | `number` |
| `captureFailed` | `number` |
| `captureSkipped` | `number` |
| `uploaded` | `number` |
| `uploadFailed` | `number` |
| `reused` | `number` |
| `replaced` | `number` |
| `replacementFailed` | `number` |
| `extractionTimeMs` | `number` |
| `mappingTimeMs` | `number` |
| `captureTimeMs` | `number` |
| `uploadTimeMs` | `number` |
| `replacementTimeMs` | `number` |
| `totalTimeMs` | `number` |
| `mappingTokenUsage` | `TokenUsage` |
| `estimatedCost` | `number` |

<!-- source: component-reportissuemodal.md -->

# ReportIssueModal

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/ReportIssueModal.tsx` (line 140)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `open` | `boolean` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `slugId` | `string` | ✓ | - |
| `pageTitle` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ReportIssueModal_1c70b190["ReportIssueModal"]
    class component_ReportIssueModal_1c70b190 rootComponent
```

## Relationships

- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-screenshotworkerclientconfig.md -->

# ScreenshotWorkerClientConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.client.ts` (line 17)

Configuration for the screenshot worker client

## Properties

| Property | Type |
|---|---|
| `baseUrl` | `string` |
| `timeoutMs` | `number` |
| `pollIntervalMs` | `number` |

<!-- source: component-repositoryinfo.md -->

# RepositoryInfo

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/dashboard/RepositoryInfo.tsx` (line 27)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `repoUrl` | `string | null` | - | - |
| `repoBranch` | `string` | ✓ | - |
| `lastSyncedAt` | `string | null` | - | - |

## Diagram

```mermaid
graph TD
    component_RepositoryInfo_670d61c2["RepositoryInfo"]
    class component_RepositoryInfo_670d61c2 rootComponent
```

<!-- source: interface-screentoapimapping.md -->

# ScreenToApiMapping

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/cross-language.types.ts` (line 35)

## Properties

| Property | Type |
|---|---|
| `screenId` | `string` |
| `screenName` | `string` |
| `screenPath` | `string` |
| `apiCalls` | `Array<{
    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
    endpoint: string; // "/api/sales/orders"
    controllerId?: string; // Entity ID of controller
    controllerName?: string; // "SalesOrderController"
    purpose: string; // "Create new order"
  }>` |
| `userActions` | `Array<{
    trigger: 'button_click' | 'form_submit' | 'page_load' | 'auto';
    label: string; // "Submit Order"
    resultingCall: string; // endpoint reference
  }>` |

<!-- source: component-requesthistory.md -->

# RequestHistory

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/RequestHistory.tsx` (line 13)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `logs` | `AIRequestLog[]` | ✓ | - |
| `loading` | `boolean` | - | - |
| `onRefresh` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_RequestHistory_5ad820bb["RequestHistory"]
    class component_RequestHistory_5ad820bb rootComponent
```

## Relationships

- RENDERS → `StatusBadge`
- USES_HOOK → `useState`

<!-- source: interface-sectionplan.md -->

# SectionPlan

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-09.types.ts` (line 54)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `type` | `SectionType` |
| `order` | `number` |
| `contentOutline` | `string[]` |
| `codeExamples` | `boolean` |
| `screenshots` | `boolean` |
| `subsections` | `SubsectionPlan[]` |

<!-- source: component-resetpasswordpage.md -->

# ResetPasswordPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/(auth)/reset-password/page.tsx` (line 112)

## Diagram

```mermaid
graph TD
    component_ResetPasswordPage_42a19aef["ResetPasswordPage"]
    class component_ResetPasswordPage_42a19aef rootComponent
```

## Relationships

- RENDERS → `Suspense`
- RENDERS → `ResetPasswordForm`

<!-- source: interface-securityscheme.md -->

# SecurityScheme

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-core/src/components/api-explorer/APIExplorer.ts` (line 30)

## Properties

| Property | Type |
|---|---|
| `type` | `'http' | 'apiKey' | 'oauth2' | 'openIdConnect'` |
| `scheme` | `string` |
| `bearerFormat` | `string` |
| `description` | `string` |
| `name` | `string` |
| `in` | `'query' | 'header' | 'cookie'` |

<!-- source: component-reviewpage.md -->

# ReviewPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/versions/[versionId]/review/page.tsx` (line 139)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ReviewPage_191d786b["ReviewPage"]
    class component_ReviewPage_191d786b rootComponent
```

## Relationships

- RENDERS → `SummaryCard`
- RENDERS → `FlaggedDocCard`
- RENDERS → `ScreenshotReviewSection`
- USES_HOOK → `useSession`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useEffect`

<!-- source: interface-selectorinfo.md -->

# SelectorInfo

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/types/route-mapping.ts` (line 45)

Information about an interactive element selector

## Properties

| Property | Type |
|---|---|
| `selector` | `string` |
| `type` | `SelectorType` |
| `text` | `string` |
| `testId` | `string` |
| `ariaLabel` | `string` |
| `confidence` | `ConfidenceLevel` |

<!-- source: component-rootlayout.md -->

# RootLayout

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/layout.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_RootLayout_99adbaf["RootLayout"]
    class component_RootLayout_99adbaf rootComponent
```

## Relationships

- RENDERS → `Providers`

<!-- source: interface-semanticcolorscale.md -->

# SemanticColorScale

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `500` | `string` |
| `600` | `string` |
| `700` | `string` |

<!-- source: component-scenebrowserepos.md -->

# SceneBrowseRepos

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/scenes/SceneBrowseRepos.tsx` (line 73)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `state` | `WizardState` | ✓ | - |
| `provider` | `unknown | unknown` | - | "github" |
| `onUpdate` | `Function` | ✓ | - |
| `onContinue` | `Function` | ✓ | - |
| `onBack` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SceneBrowseRepos_301eda0b["SceneBrowseRepos"]
    class component_SceneBrowseRepos_301eda0b rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-button`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useMemo`

<!-- source: interface-sessionhealthcheck.md -->

# SessionHealthCheck

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 99)

Session health check configuration

## Properties

| Property | Type |
|---|---|
| `enabled` | `boolean` |
| `loginPageIndicators` | `string[]` |
| `authenticatedIndicators` | `string[]` |
| `loginUrlPatterns` | `string[]` |
| `maxReauthAttempts` | `number` |

<!-- source: component-sceneconnectprovider.md -->

# SceneConnectProvider

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/scenes/SceneConnectProvider.tsx` (line 64)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `state` | `WizardState` | ✓ | - |
| `provider` | `unknown | unknown | unknown` | - | "github" |
| `onUpdate` | `Function` | ✓ | - |
| `onConnected` | `Function` | ✓ | - |
| `onCancel` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SceneConnectProvider_4948ccc3["SceneConnectProvider"]
    class component_SceneConnectProvider_4948ccc3 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `AnimatePresence`
- USES_HOOK → `useState`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useEffect`

<!-- source: interface-sessioninput.md -->

# SessionInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-08.types.ts` (line 18)

## Properties

| Property | Type |
|---|---|
| `phases` | `Phase[]` |
| `budget` | `TokenBudget` |

<!-- source: component-scenedoctypes.md -->

# SceneDocTypes

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/scenes/SceneDocTypes.tsx` (line 55)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `state` | `WizardState` | ✓ | - |
| `onUpdate` | `Function` | ✓ | - |
| `onGenerate` | `Function` | ✓ | - |
| `onBack` | `Function` | ✓ | - |
| `generating` | `boolean` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SceneDocTypes_1eacf889["SceneDocTypes"]
    class component_SceneDocTypes_1eacf889 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-button`

<!-- source: interface-sessionresult.md -->

# SessionResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-08.types.ts` (line 23)

## Properties

| Property | Type |
|---|---|
| `sessions` | `AISession[]` |
| `batches` | `ExecutionBatch[]` |

<!-- source: component-scenegeneration.md -->

# SceneGeneration

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/scenes/SceneGeneration.tsx` (line 105)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `selectedDocTypes` | `string[]` | - | [] |
| `onRetry` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SceneGeneration_496b04d7["SceneGeneration"]
    class component_SceneGeneration_496b04d7 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `CountUp`
- USES_HOOK → `useRouter`
- USES_HOOK → `useSession`
- USES_HOOK → `useRef`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-shadcndetectionconfig.md -->

# ShadcnDetectionConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/shadcn.patterns.ts` (line 280)

## Properties

| Property | Type |
|---|---|
| `name` | `'shadcn'` |
| `filePatterns` | `string[]` |
| `identifiers` | `RegExp[]` |
| `configFiles` | `string[]` |

<!-- source: component-sceneprojectdetails.md -->

# SceneProjectDetails

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/scenes/SceneProjectDetails.tsx` (line 18)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `state` | `WizardState` | ✓ | - |
| `onUpdate` | `Function` | ✓ | - |
| `onContinue` | `Function` | ✓ | - |
| `onBack` | `Function` | ✓ | - |
| `onConnectProvider` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_SceneProjectDetails_7dfd9b89["SceneProjectDetails"]
    class component_SceneProjectDetails_7dfd9b89 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-button`
- RENDERS → `AnimatePresence`
- RENDERS → `BranchPickerModal`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`

<!-- source: interface-shadows.md -->

# Shadows

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 99)

## Properties

| Property | Type |
|---|---|
| `sm` | `string` |
| `md` | `string` |
| `lg` | `string` |
| `xl` | `string` |

<!-- source: component-sceneurlinput.md -->

# SceneUrlInput

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/scenes/SceneUrlInput.tsx` (line 34)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `state` | `WizardState` | ✓ | - |
| `onUrlChange` | `Function` | ✓ | - |
| `onGetStarted` | `Function` | ✓ | - |
| `onSkipRepo` | `Function` | ✓ | - |
| `onProviderClick` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SceneUrlInput_55eddbc9["SceneUrlInput"]
    class component_SceneUrlInput_55eddbc9 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-button`
- RENDERS → `AnimatePresence`
- RENDERS → `motion-p`
- RENDERS → `GitHubIcon`
- RENDERS → `GitLabIcon`
- RENDERS → `BitbucketIcon`
- USES_HOOK → `useState`

<!-- source: interface-sharedcontext.md -->

# SharedContext

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-08.types.ts` (line 42)

## Properties

| Property | Type |
|---|---|
| `featureIds` | `string[]` |
| `entitySummaries` | `string[]` |
| `previousDocSummaries` | `string[]` |

<!-- source: component-screenshot.md -->

# Screenshot

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/Screenshot.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `src` | `string` | - | - |
| `alt` | `string` | - | - |
| `caption` | `string` | - | - |
| `metadata` | `string | unknown` | - | - |
| `children` | `any` | - | - |

## Diagram

```mermaid
graph TD
    component_Screenshot_55886afd["Screenshot"]
    class component_Screenshot_55886afd rootComponent
```

## Relationships

- RENDERS → `Image`

<!-- source: interface-sitemap.md -->

# SiteMap

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/site-map.types.ts` (line 100)

## Properties

| Property | Type |
|---|---|
| `baseUrl` | `string` |
| `routes` | `DiscoveredRoute[]` |
| `discoveryTimeMs` | `number` |
| `generatedAt` | `string` |
| `stats` | `SiteMapStats` |

<!-- source: component-screenshotannotation.md -->

# ScreenshotAnnotation

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/ScreenshotAnnotation.tsx` (line 52)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `src` | `string` | ✓ | - |
| `alt` | `string` | - | - |
| `annotations` | `Annotation[]` | - | - |

## Diagram

```mermaid
graph TD
    component_ScreenshotAnnotation_703f4aa5["ScreenshotAnnotation"]
    class component_ScreenshotAnnotation_703f4aa5 rootComponent
```

<!-- source: interface-sitemapstats.md -->

# SiteMapStats

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/site-map.types.ts` (line 86)

## Properties

| Property | Type |
|---|---|
| `totalRoutes` | `number` |
| `listPages` | `number` |
| `detailPages` | `number` |
| `formPages` | `number` |
| `dashboardPages` | `number` |
| `totalGrids` | `number` |
| `totalTabs` | `number` |
| `totalButtons` | `number` |
| `totalForms` | `number` |
| `routesWithGrids` | `number` |
| `routesWithTabs` | `number` |

<!-- source: component-screenshotdashboard.md -->

# ScreenshotDashboard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/versions/[versionId]/screenshots/page.tsx` (line 248)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ScreenshotDashboard_41993c5b["ScreenshotDashboard"]
    class component_ScreenshotDashboard_41993c5b rootComponent
```

## Relationships

- RENDERS → `ScreenshotsContent`

<!-- source: interface-sociallink.md -->

# SocialLink

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/layout/footer.tsx` (line 15)

## Properties

| Property | Type |
|---|---|
| `platform` | `string` |
| `href` | `string` |
| `icon` | `React.ReactNode` |

<!-- source: component-screenshotfigure.md -->

# ScreenshotFigure

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Viewer/ScreenshotFigure.tsx` (line 38)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `src` | `string` | ✓ | - |
| `alt` | `string` | - | - |
| `annotations` | `Annotation[]` | - | - |
| `caption` | `string | null` | - | - |
| `lang` | `string` | - | - |
| `dir` | `unknown | unknown` | - | "ltr" |

## Diagram

```mermaid
graph TD
    component_ScreenshotFigure_16491445["ScreenshotFigure"]
    class component_ScreenshotFigure_16491445 rootComponent
```

## Relationships

- RENDERS → `ScreenshotAnnotation`
- RENDERS → `Lightbox`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`

<!-- source: interface-socialprooftimelineprops-2.md -->

# SocialProofTimelineProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/social-proof/social-proof-timeline.tsx` (line 17)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `milestones` | `Milestone[]` |

<!-- source: component-screenshotgallery.md -->

# ScreenshotGallery

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/enterprise/screenshots/ScreenshotGallery.tsx` (line 16)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `screenshots` | `any[]` | ✓ | - |
| `onPreview` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ScreenshotGallery_12a9ee39["ScreenshotGallery"]
    class component_ScreenshotGallery_12a9ee39 rootComponent
```

## Relationships

- USES_HOOK → `useRef`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-socialprooftrustbadgesprops-2.md -->

# SocialProofTrustBadgesProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/social-proof/social-proof-trust-badges.tsx` (line 26)

## Properties

| Property | Type |
|---|---|
| `headlineKey` | `string` |
| `descriptionKey` | `string` |
| `badges` | `TrustBadge[]` |

<!-- source: component-screenshotplaceholder.md -->

# ScreenshotPlaceholder

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/ScreenshotPlaceholder.tsx` (line 17)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `routePath` | `string` | ✓ | - |
| `description` | `string` | - | - |
| `onCapture` | `Function` | - | - |
| `onUpload` | `Function` | - | - |
| `onRemove` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_ScreenshotPlaceholder_61a40aa0["ScreenshotPlaceholder"]
    class component_ScreenshotPlaceholder_61a40aa0 rootComponent
```

## Relationships

- RENDERS → `Camera`
- RENDERS → `Upload`
- RENDERS → `X`

<!-- source: interface-sourcecodeintelligence.md -->

# SourceCodeIntelligence

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/agent-screenshot-mapper.ts` (line 53)

Complete intelligence extracted from source code

## Properties

| Property | Type |
|---|---|
| `routes` | `SourceRoute[]` |
| `menuTree` | `SourceMenuItem[]` |
| `framework` | `string` |
| `routingStrategy` | `'hash' | 'html5'` |
| `commonSelectors` | `Record<string, string>` |
| `auth` | `{
    loginRoute: string;
    usernameSelector?: string;
    passwordSelector?: string;
    submitSelector?: string;
  }` |

<!-- source: component-screenshotspage.md -->

# ScreenshotsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/enterprise/screenshots/page.tsx` (line 40)

## Diagram

```mermaid
graph TD
    component_ScreenshotsPage_35829f10["ScreenshotsPage"]
    class component_ScreenshotsPage_35829f10 rootComponent
```

## Relationships

- RENDERS → `CaptureModal`
- RENDERS → `StatusBadge`
- RENDERS → `ScreenshotGallery`
- RENDERS → `Pagination`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-sourcemenuitem.md -->

# SourceMenuItem

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/agent-screenshot-mapper.ts` (line 44)

Menu item from sidebar/navigation analysis

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `route` | `string` |
| `icon` | `string` |
| `parent` | `string` |
| `children` | `SourceMenuItem[]` |

<!-- source: component-screenshotstabcontent.md -->

# ScreenshotsTabContent

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/page.tsx` (line 1027)

Phase 4: Screenshots tab — loads active version's screenshot dashboard.

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ScreenshotsTabContent_391b89a["ScreenshotsTabContent"]
    class component_ScreenshotsTabContent_391b89a rootComponent
```

## Relationships

- RENDERS → `ScreenshotsContent`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-sourceroute.md -->

# SourceRoute

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/agent-screenshot-mapper.ts` (line 26)

Route extracted from source code analysis

## Properties

| Property | Type |
|---|---|
| `path` | `string` |
| `component` | `string` |
| `requiresAuth` | `boolean` |
| `hasDeactivateGuard` | `boolean` |
| `params` | `string[]` |
| `menuPath` | `string[]` |
| `menuIcon` | `string` |

<!-- source: component-scrollprogress.md -->

# ScrollProgress

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/ScrollProgress.tsx` (line 13)

## Diagram

```mermaid
graph TD
    component_ScrollProgress_2f94e9ec["ScrollProgress"]
    class component_ScrollProgress_2f94e9ec rootComponent
```

## Relationships

- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-spacing.md -->

# Spacing

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 73)

## Properties

| Property | Type |
|---|---|
| `0` | `string` |
| `1` | `string` |
| `2` | `string` |
| `3` | `string` |
| `4` | `string` |
| `5` | `string` |
| `6` | `string` |
| `8` | `string` |
| `10` | `string` |
| `12` | `string` |
| `16` | `string` |
| `20` | `string` |
| `24` | `string` |
| `32` | `string` |

<!-- source: component-searchbar.md -->

# SearchBar

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Documents/SearchBar.tsx` (line 9)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onSearch` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SearchBar_1ddcd63d["SearchBar"]
    class component_SearchBar_1ddcd63d rootComponent
```

## Relationships

- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-springdetectionconfig.md -->

# SpringDetectionConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/spring.patterns.ts` (line 252)

## Properties

| Property | Type |
|---|---|
| `name` | `'spring'` |
| `filePatterns` | `string[]` |
| `identifiers` | `RegExp[]` |
| `configFiles` | `string[]` |

<!-- source: component-securitypage.md -->

# SecurityPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/admin/security/page.tsx` (line 9)

## Diagram

```mermaid
graph TD
    component_SecurityPage_d8aafe6["SecurityPage"]
    class component_SecurityPage_d8aafe6 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `ShieldCheckIcon`

<!-- source: interface-springendpoint.md -->

# SpringEndpoint

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/spring-detector.ts` (line 37)

Spring endpoint

## Properties

| Property | Type |
|---|---|
| `method` | `'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'` |
| `path` | `string` |
| `handlerName` | `string` |
| `requestBody` | `string` |
| `responseType` | `string` |
| `pathVariables` | `string[]` |
| `requestParams` | `string[]` |
| `security` | `string` |

<!-- source: component-settingsmanager.md -->

# SettingsManager

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/SettingsManager.tsx` (line 13)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `settings` | `AISettings` | ✓ | - |
| `onSettingsChange` | `Function` | ✓ | - |
| `onReset` | `Function` | ✓ | - |
| `onExport` | `Function` | ✓ | - |
| `onImport` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SettingsManager_2e1b2e05["SettingsManager"]
    class component_SettingsManager_2e1b2e05 rootComponent
```

<!-- source: interface-springmethod.md -->

# SpringMethod

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/spring-detector.ts` (line 73)

Spring method

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `returnType` | `string` |
| `parameters` | `SpringParameter[]` |
| `isTransactional` | `boolean` |

<!-- source: component-settingspage.md -->

# SettingsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/page.tsx` (line 11)

## Diagram

```mermaid
graph TD
    component_SettingsPage_e60fd46["SettingsPage"]
    class component_SettingsPage_e60fd46 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `Cog6ToothIcon`
- RENDERS → `Card`
- RENDERS → `CardHeader`
- RENDERS → `CardContent`

<!-- source: interface-springparameter.md -->

# SpringParameter

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/spring-detector.ts` (line 83)

Spring parameter

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `annotation` | `string` |

<!-- source: component-shortcutoverlay.md -->

# ShortcutOverlay

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/DeskDialogs.tsx` (line 207)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onClose` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ShortcutOverlay_471308ce["ShortcutOverlay"]
    class component_ShortcutOverlay_471308ce rootComponent
```

## Relationships

- RENDERS → `Backdrop`
- RENDERS → `XMarkIcon`

<!-- source: interface-srcimageparameters.md -->

# SrcImageParameters

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/image/index.ts` (line 70)

## Properties

| Property | Type |
|---|---|
| `src` | `string` |

<!-- source: component-sidebar.md -->

# Sidebar

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Layout/Sidebar.tsx` (line 44)

## Diagram

```mermaid
graph TD
    component_Sidebar_72fc4ee3["Sidebar"]
    class component_Sidebar_72fc4ee3 rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `motion-div`
- RENDERS → `Icon`
- USES_HOOK → `usePathname`

<!-- source: interface-stagetokensummary.md -->

# StageTokenSummary

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/pipeline/token-tracker.ts` (line 40)

## Properties

| Property | Type |
|---|---|
| `inputTokens` | `number` |
| `outputTokens` | `number` |
| `totalTokens` | `number` |
| `costUsd` | `number` |
| `callCount` | `number` |

<!-- source: component-skeletonbuilder.md -->

# SkeletonBuilder

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/DocAutomation/SkeletonBuilder.tsx` (line 37)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `skeleton` | `SkeletonStructure | null` | ✓ | - |
| `isDirty` | `boolean` | - | false |
| `loading` | `boolean` | - | false |
| `onAddCategory` | `Function` | ✓ | - |
| `onRemoveCategory` | `Function` | ✓ | - |
| `onUpdateCategory` | `Function` | ✓ | - |
| `onAddDocument` | `Function` | ✓ | - |
| `onRemoveDocument` | `Function` | ✓ | - |
| `onUpdateDocument` | `Function` | ✓ | - |
| `onReorderCategories` | `Function` | ✓ | - |
| `onReorderDocuments` | `Function` | ✓ | - |
| `onSave` | `Function` | ✓ | - |
| `onReset` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SkeletonBuilder_4d65a3cc["SkeletonBuilder"]
    class component_SkeletonBuilder_4d65a3cc rootComponent
```

## Relationships

- RENDERS → `Button`
- RENDERS → `RotateCcw`
- RENDERS → `Loader2`
- RENDERS → `Save`
- RENDERS → `FolderPlus`
- RENDERS → `Reorder-Group`
- RENDERS → `CategoryItem`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`

<!-- source: interface-statcardprops-2.md -->

# StatCardProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/stat-card.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `valueKey` | `string` |
| `labelKey` | `string` |
| `className` | `string` |

<!-- source: component-snoozemenu.md -->

# SnoozeMenu

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/DeskDialogs.tsx` (line 52)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onPick` | `Function` | ✓ | - |
| `onClose` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SnoozeMenu_a1545bf["SnoozeMenu"]
    class component_SnoozeMenu_a1545bf rootComponent
```

## Relationships

- RENDERS → `Backdrop`
- USES_HOOK → `useEffect`

<!-- source: interface-statedefinition.md -->

# StateDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/state-machine-detector.ts` (line 38)

A single state/status value

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `value` | `string | number` |
| `description` | `string` |
| `isInitial` | `boolean` |
| `isFinal` | `boolean` |

<!-- source: component-sortabledocumentlist.md -->

# SortableDocumentList

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/PublishingSidebar/SortableDocumentList.tsx` (line 141)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `categories` | `CategoryGroup[]` | ✓ | - |
| `selectedDocument` | `string | null` | ✓ | - |
| `onSelectDocument` | `Function` | ✓ | - |
| `onReorder` | `Function` | ✓ | - |
| `loading` | `boolean` | - | false |
| `loadingProgress` | `unknown` | - | {} |
| `processing` | `boolean` | - | false |
| `editMode` | `boolean` | - | false |

## Diagram

```mermaid
graph TD
    component_SortableDocumentList_68686a96["SortableDocumentList"]
    class component_SortableDocumentList_68686a96 rootComponent
```

## Relationships

- RENDERS → `FileText`
- RENDERS → `CategoryIcon`
- RENDERS → `Folder`
- RENDERS → `DndContext`
- RENDERS → `SortableContext`
- RENDERS → `SortableDocumentItem`
- USES_HOOK → `useSensors`
- USES_HOOK → `useSensor`

<!-- source: interface-stateresolutionconfig.md -->

# StateResolutionConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 131)

Configuration for resolving a record in a specific workflow state at capture time.
Used by the screenshot-worker's StateResolverService.

## Properties

| Property | Type |
|---|---|
| `listUrl` | `string` |
| `statusColumnHint` | `string` |
| `targetStatusValue` | `string` |
| `maxRowsToScan` | `number` |
| `rowAction` | `'click' | 'dblclick'` |

<!-- source: component-sortcontrol.md -->

# SortControl

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Documents/SortControl.tsx` (line 30)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `value` | `SortOption` | ✓ | - |
| `onChange` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SortControl_65f325c3["SortControl"]
    class component_SortControl_65f325c3 rootComponent
```

## Relationships

- RENDERS → `BarsArrowDownIcon`
- RENDERS → `BarsArrowUpIcon`
- USES_HOOK → `useState`

<!-- source: interface-stateresolutionhint.md -->

# StateResolutionHint

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/screenshot-spec.types.ts` (line 51)

Hints for the state resolver about where/how to find matching records.
Used by the screenshot-worker's StateResolverService to navigate to a
list view, scan the grid, and click into a matching record.

## Properties

| Property | Type |
|---|---|
| `listRoute` | `string` |
| `statusColumnHint` | `string` |
| `statusValue` | `string` |
| `entityType` | `string` |

<!-- source: interface-statetransition-3.md -->

# StateTransition

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/state-machine-detector.ts` (line 49)

A transition between states

## Properties

| Property | Type |
|---|---|
| `from` | `string` |
| `to` | `string` |
| `trigger` | `string` |
| `condition` | `string` |
| `action` | `string` |

<!-- source: component-statsrow.md -->

# StatsRow

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/dashboard/StatsRow.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `documentCount` | `number` | ✓ | - |
| `categoryCount` | `number` | ✓ | - |
| `lastGeneratedAt` | `string | null` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StatsRow_27f4ffc4["StatsRow"]
    class component_StatsRow_27f4ffc4 rootComponent
```

<!-- source: component-stepeditor.md -->

# StepEditor

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/StepEditor.tsx` (line 56)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `flowId` | `string` | ✓ | - |
| `token` | `string` | - | - |
| `onClose` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StepEditor_62b70f9b["StepEditor"]
    class component_StepEditor_62b70f9b rootComponent
```

## Relationships

- RENDERS → `Loader2`
- RENDERS → `Save`
- RENDERS → `X`
- RENDERS → `Languages`
- RENDERS → `Camera`
- RENDERS → `ArrowUp`
- RENDERS → `ArrowDown`
- RENDERS → `SquareDashedMousePointer`
- RENDERS → `Trash2`
- RENDERS → `RedactionCanvas`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-stepindicatorprops-2.md -->

# StepIndicatorProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/step-indicator.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `step` | `number` |
| `icon` | `LucideIcon` |
| `titleKey` | `string` |
| `descriptionKey` | `string` |

<!-- source: component-stepindicator.md -->

# StepIndicator

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/NewProjectWizard/StepIndicator.tsx` (line 17)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `activeStep` | `number` | ✓ | - |
| `completedSteps` | `number[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StepIndicator_20f10177["StepIndicator"]
    class component_StepIndicator_20f10177 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `motion-svg`

<!-- source: interface-strikethroughsupsubtogglesprops.md -->

# StrikeThroughSupSubTogglesProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/toolbar/components/BoldItalicUnderlineToggles.tsx` (line 81)

## Properties

| Property | Type |
|---|---|
| `options` | `('Strikethrough' | 'Sub' | 'Sup')[]` |

<!-- source: interface-structureindex.md -->

# StructureIndex

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 100)

Structure index loaded from _structure.json

## Properties

| Property | Type |
|---|---|
| `generatedAt` | `string` |
| `project` | `string` |
| `categories` | `CategoryNode[]` |
| `flatCategories` | `FlatCategory[]` |
| `stats` | `{
    totalDocuments: number;
    totalCategories: number;
    categoriesByLevel: {
      level1: number;
      level2: number;
      level3: number;
    };
  }` |

<!-- source: component-stylecard.md -->

# StyleCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/settings/branding/page.tsx` (line 1355)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `name` | `string` | ✓ | - |
| `description` | `string` | ✓ | - |
| `tag` | `string` | ✓ | - |
| `active` | `boolean` | ✓ | - |
| `onClick` | `Function` | ✓ | - |
| `primaryColor` | `string` | ✓ | - |
| `accentColor` | `string` | ✓ | - |
| `children` | `unknown` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_StyleCard_390ce941["StyleCard"]
    class component_StyleCard_390ce941 rootComponent
```

## Relationships

- RENDERS → `CheckIcon`

<!-- source: interface-structureinput.md -->

# StructureInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-06.types.ts` (line 15)

## Properties

| Property | Type |
|---|---|
| `synthesis` | `SynthesisResult` |
| `suggestedCategories` | `string[]` |
| `routeMappings` | `RouteMappingResult` |

<!-- source: component-suggestioncard.md -->

# SuggestionCard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Suggestions/SuggestionCard.tsx` (line 13)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `suggestion` | `SuggestionWithUser` | ✓ | - |
| `onAccept` | `Function` | ✓ | - |
| `onReject` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SuggestionCard_6b94172a["SuggestionCard"]
    class component_SuggestionCard_6b94172a rootComponent
```

## Relationships

- RENDERS → `Avatar`
- RENDERS → `StatusBadge`
- RENDERS → `Check`
- RENDERS → `X`

<!-- source: interface-structureissue.md -->

# StructureIssue

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/structure-scorer.ts` (line 32)

## Properties

| Property | Type |
|---|---|
| `type` | `| 'long-paragraph'
    | 'no-lists'
    | 'no-tables'
    | 'sparse-headings'
    | 'uniform-blocks'
    | 'long-document'
    | 'no-callouts'` |
| `severity` | `'warning' | 'fail'` |
| `location` | `string` |
| `detail` | `string` |
| `suggestion` | `string` |

<!-- source: component-suggestionpanel.md -->

# SuggestionPanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Suggestions/SuggestionPanel.tsx` (line 18)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `documentId` | `string` | ✓ | - |
| `enableRealtime` | `boolean` | - | true |

## Diagram

```mermaid
graph TD
    component_SuggestionPanel_c0049cc["SuggestionPanel"]
    class component_SuggestionPanel_c0049cc rootComponent
```

## Relationships

- RENDERS → `Loader2`
- RENDERS → `Filter`
- RENDERS → `FilterButton`
- RENDERS → `SuggestionCard`
- USES_HOOK → `useSuggestions`
- USES_HOOK → `useState`

<!-- source: interface-structuremodification.md -->

# StructureModification

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 116)

## Properties

| Property | Type |
|---|---|
| `action` | `'add' | 'remove' | 'rename' | 'move'` |
| `targetType` | `'category' | 'subcategory' | 'document'` |
| `targetId` | `string` |
| `newValue` | `string` |
| `newParentId` | `string` |

<!-- source: component-supportagentpage.md -->

# SupportAgentPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/enterprise/support-agent/page.tsx` (line 43)

## Diagram

```mermaid
graph TD
    component_SupportAgentPage_2af58ae9["SupportAgentPage"]
    class component_SupportAgentPage_2af58ae9 rootComponent
```

## Relationships

- USES_HOOK → `useSession`
- USES_HOOK → `useRouter`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-structureresult.md -->

# StructureResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-06.types.ts` (line 29)

## Properties

| Property | Type |
|---|---|
| `documents` | `PlannedDocument[]` |
| `categories` | `DocumentCategoryStructure[]` |
| `tokenUsage` | `TokenUsage[]` |

<!-- source: component-supportagentsection.md -->

# SupportAgentSection

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/SupportAgentSection.tsx` (line 86)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SupportAgentSection_4a89d7a3["SupportAgentSection"]
    class component_SupportAgentSection_4a89d7a3 rootComponent
```

## Relationships

- RENDERS → `ChevronUp`
- RENDERS → `ChevronDown`
- RENDERS → `Code2`
- RENDERS → `EmbedCodeGenerator`
- RENDERS → `Sparkles`
- RENDERS → `MessageCircle`
- RENDERS → `Send`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`
- USES_HOOK → `useRef`
- USES_HOOK → `useCallback`

<!-- source: interface-structurescore.md -->

# StructureScore

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/structure-scorer.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `overall` | `number` |
| `dimensions` | `{
    paragraphDensity: number;
    listUsage: number;
    tablePresence: number;
    headingGranularity: number;
    visualVariety: number;
  }` |
| `issues` | `StructureIssue[]` |
| `passesGate` | `boolean` |

<!-- source: component-supportagentsettingspage.md -->

# SupportAgentSettingsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/enterprise/support-agent/settings/page.tsx` (line 66)

## Diagram

```mermaid
graph TD
    component_SupportAgentSettingsPage_68057196["SupportAgentSettingsPage"]
    class component_SupportAgentSettingsPage_68057196 rootComponent
```

## Relationships

- RENDERS → `ArrowLeft`
- RENDERS → `Sparkles`
- RENDERS → `Code2`
- RENDERS → `EmbedCodeGenerator`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useCurrentProjectId`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useCallback`
- USES_HOOK → `useEffect`

<!-- source: interface-subsectionplan.md -->

# SubsectionPlan

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-09.types.ts` (line 65)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `title` | `string` |
| `contentOutline` | `string[]` |

<!-- source: component-supportchatwidget.md -->

# SupportChatWidget

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/SupportChatWidget.tsx` (line 38)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `slugId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_SupportChatWidget_41827e0a["SupportChatWidget"]
    class component_SupportChatWidget_41827e0a rootComponent
```

## Relationships

- RENDERS → `MessageCircle`
- RENDERS → `X`
- RENDERS → `LifeBuoy`
- RENDERS → `ReactMarkdown`
- RENDERS → `StreamingDots`
- RENDERS → `ThumbsUp`
- RENDERS → `ThumbsDown`
- RENDERS → `Send`
- RENDERS → `EscalatePanel`
- USES_HOOK → `useVersionContext`
- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`
- USES_HOOK → `useCallback`

<!-- source: interface-suggestionlistparams.md -->

# SuggestionListParams

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/suggestions.ts` (line 13)

Suggestion list query parameters

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `status` | `SuggestionStatus` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: component-symbollist.md -->

# SymbolList

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Parser/SymbolList.tsx` (line 18)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `symbols` | `Symbol[]` | ✓ | - |
| `onSymbolClick` | `Function` | - | - |
| `selectedSymbol` | `Symbol` | - | - |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_SymbolList_40b58770["SymbolList"]
    class component_SymbolList_40b58770 rootComponent
```

## Relationships

- RENDERS → `FilterButton`
- RENDERS → `SymbolIcon`
- USES_HOOK → `useState`
- USES_HOOK → `useMemo`

<!-- source: interface-suggestionwithuser.md -->

# SuggestionWithUser

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/suggestion.dto.ts` (line 8)

Suggestion DTO with populated user relation

## Properties

| Property | Type |
|---|---|
| `user` | `Pick<User, 'id' | 'name' | 'email'>` |

<!-- source: component-teamactivity.md -->

# TeamActivity

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/dashboard/TeamActivity.tsx` (line 44)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `documents` | `RecentDoc[]` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TeamActivity_3ecf8766["TeamActivity"]
    class component_TeamActivity_3ecf8766 rootComponent
```

<!-- source: interface-sveltedetectionconfig.md -->

# SvelteDetectionConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/patterns/svelte.patterns.ts` (line 243)

## Properties

| Property | Type |
|---|---|
| `name` | `'svelte'` |
| `filePatterns` | `string[]` |
| `identifiers` | `RegExp[]` |
| `configFiles` | `string[]` |

<!-- source: component-technicaldocsindexpage.md -->

# TechnicalDocsIndexPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/page.tsx` (line 19)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TechnicalDocsIndexPage_32fb2aea["TechnicalDocsIndexPage"]
    class component_TechnicalDocsIndexPage_32fb2aea rootComponent
```

## Relationships

- RENDERS → `EntityTree`
- RENDERS → `ArrowUpTrayIcon`
- RENDERS → `ArrowPathIcon`
- RENDERS → `FreshnessCockpit`
- RENDERS → `ConnectorsPanel`
- RENDERS → `ExportModal`
- RENDERS → `CodebaseChat`
- RENDERS → `CommandPalette`
- USES_HOOK → `useState`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useRouter`
- USES_HOOK → `useEffect`

<!-- source: interface-svelteprop.md -->

# SvelteProp

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/svelte-detector.ts` (line 48)

Svelte prop

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `defaultValue` | `string` |

<!-- source: component-technicaldocslayout.md -->

# TechnicalDocsLayout

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/technical-docs/layout.tsx` (line 16)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `unknown` | ✓ | - |
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TechnicalDocsLayout_5fecf67a["TechnicalDocsLayout"]
    class component_TechnicalDocsLayout_5fecf67a rootComponent
```

## Relationships

- RENDERS → `Link`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-synthesisinput.md -->

# SynthesisInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-05.types.ts` (line 19)

## Properties

| Property | Type |
|---|---|
| `analyses` | `ChunkAnalysis[]` |

<!-- source: component-termspage.md -->

# TermsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/terms/page.tsx` (line 159)

## Diagram

```mermaid
graph TD
    component_TermsPage_6db3bb5c["TermsPage"]
    class component_TermsPage_6db3bb5c rootComponent
```

## Relationships

- RENDERS → `Link`
- RENDERS → `motion-div`
- RENDERS → `Reveal`

<!-- source: interface-synthesisresult.md -->

# SynthesisResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-05.types.ts` (line 30)

## Properties

| Property | Type |
|---|---|
| `summary` | `ApplicationSummary` |
| `personas` | `UserPersona[]` |
| `featureAreas` | `FeatureArea[]` |
| `plan` | `DocumentationPlan` |
| `complexity` | `ProjectComplexity` |
| `crossModuleRelationships` | `CrossModuleRelationship[]` |
| `tokenUsage` | `TokenUsage[]` |

<!-- source: component-themetoggle.md -->

# ThemeToggle

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/ui/theme-toggle.tsx` (line 9)

## Diagram

```mermaid
graph TD
    component_ThemeToggle_a6ab26a["ThemeToggle"]
    class component_ThemeToggle_a6ab26a rootComponent
```

## Relationships

- RENDERS → `motion-button`
- RENDERS → `AnimatePresence`
- RENDERS → `motion-div`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-tabcapturespec.md -->

# TabCaptureSpec

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/screenshot-spec.types.ts` (line 108)

Tab capture specification

## Properties

| Property | Type |
|---|---|
| `tabLabel` | `string` |
| `tabIndex` | `number` |
| `tabSelector` | `string` |
| `tabSystem` | `string` |

<!-- source: component-threadlist.md -->

# ThreadList

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/ThreadList.tsx` (line 80)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `bucket` | `BucketKey` | ✓ | - |
| `threads` | `DeskThread[]` | ✓ | - |
| `loading` | `boolean` | ✓ | - |
| `selectedIndex` | `number` | ✓ | - |
| `openThreadId` | `string | null` | ✓ | - |
| `now` | `number` | ✓ | - |
| `gaps` | `TicketTopicProposal[]` | ✓ | - |
| `gapDrafts` | `Record` | ✓ | - |
| `onSelect` | `Function` | ✓ | - |
| `onOpen` | `Function` | ✓ | - |
| `onDraftGap` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ThreadList_6947c1c4["ThreadList"]
    class component_ThreadList_6947c1c4 rootComponent
```

## Relationships

- RENDERS → `ChatBubbleLeftRightIcon`
- RENDERS → `InboxIcon`
- RENDERS → `GapCard`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-tabdefinition-2.md -->

# TabDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 55)

A tab discovered in source code

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `index` | `number` |
| `selector` | `string` |
| `tabSystem` | `string` |
| `conditionalOn` | `string` |
| `hostComponent` | `string` |
| `sourceFile` | `string` |

<!-- source: component-threadview.md -->

# ThreadView

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/desk/components/ThreadView.tsx` (line 95)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `thread` | `DeskThreadDetail | null` | ✓ | - |
| `loading` | `boolean` | ✓ | - |
| `composerBody` | `string` | ✓ | - |
| `onComposerBodyChange` | `Function` | ✓ | - |
| `internalMode` | `boolean` | ✓ | - |
| `onToggleInternal` | `Function` | ✓ | - |
| `composerRef` | `unknown` | ✓ | - |
| `sending` | `boolean` | ✓ | - |
| `onSend` | `Function` | ✓ | - |
| `onTransition` | `Function` | ✓ | - |
| `onOpenSnooze` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ThreadView_3f845f6["ThreadView"]
    class component_ThreadView_3f845f6 rootComponent
```

## Relationships

- RENDERS → `ChatBubbleLeftEllipsisIcon`
- RENDERS → `Chip`
- RENDERS → `LockClosedIcon`
- RENDERS → `MessageBody`
- RENDERS → `ExclamationTriangleIcon`
- RENDERS → `PaperClipIcon`
- RENDERS → `EyeIcon`
- RENDERS → `PaperAirplaneIcon`
- USES_HOOK → `useRef`
- USES_HOOK → `useState`
- USES_HOOK → `useMemo`
- USES_HOOK → `useEffect`

<!-- source: interface-tableeditorprops.md -->

# TableEditorProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/plugins/table/TableEditor.tsx` (line 70)

## Properties

| Property | Type |
|---|---|
| `parentEditor` | `LexicalEditor` |
| `lexicalTable` | `TableNode` |
| `mdastNode` | `Mdast.Table` |

<!-- source: component-ticketcontentopportunities.md -->

# TicketContentOpportunities

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/analytics/TicketContentOpportunities.tsx` (line 35)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TicketContentOpportunities_65340e73["TicketContentOpportunities"]
    class component_TicketContentOpportunities_65340e73 rootComponent
```

## Relationships

- USES_HOOK → `useSession`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-tableofcontentsprops.md -->

# TableOfContentsProps

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/components/TableOfContents.tsx` (line 18)

## Properties

| Property | Type |
|---|---|
| `entries` | `TocEntry[]` |
| `onNavigate` | `(id: string) => void` |
| `title` | `string` |
| `className` | `string` |
| `scrollOffset` | `number` |

<!-- source: component-timeperiodselector.md -->

# TimePeriodSelector

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/TimePeriodSelector.tsx` (line 21)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `value` | `TimePeriod` | ✓ | - |
| `onChange` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_TimePeriodSelector_7d8b7e65["TimePeriodSelector"]
    class component_TimePeriodSelector_7d8b7e65 rootComponent
```

<!-- source: interface-tabprofile.md -->

# TabProfile

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/site-map.types.ts` (line 20)

## Properties

| Property | Type |
|---|---|
| `label` | `string` |
| `index` | `number` |
| `selector` | `string` |
| `detectionMethod` | `string` |

<!-- source: component-timeserieschart.md -->

# TimeSeriesChart

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Analytics/charts/TimeSeriesChart.tsx` (line 60)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `data` | `TimeSeriesDataPoint[]` | ✓ | - |
| `loading` | `boolean` | - | false |
| `title` | `string` | - | - |
| `height` | `number` | - | 280 |

## Diagram

```mermaid
graph TD
    component_TimeSeriesChart_b9d8671["TimeSeriesChart"]
    class component_TimeSeriesChart_b9d8671 rootComponent
```

## Relationships

- RENDERS → `ResponsiveContainer`
- RENDERS → `AreaChart`
- RENDERS → `CartesianGrid`
- RENDERS → `XAxis`
- RENDERS → `YAxis`
- RENDERS → `Tooltip`
- RENDERS → `CustomTooltip`
- RENDERS → `Area`

<!-- source: interface-termdefinition.md -->

# TermDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-11.types.ts` (line 115)

## Properties

| Property | Type |
|---|---|
| `term` | `string` |
| `variants` | `string[]` |
| `definition` | `string` |
| `usageGuideline` | `string` |

<!-- source: component-tourembed.md -->

# TourEmbed

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/components/TourEmbed.tsx` (line 38)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `flowId` | `string` | ✓ | - |
| `flowName` | `string` | - | - |
| `primaryColor` | `string` | - | "#0891B2" |

## Diagram

```mermaid
graph TD
    component_TourEmbed_4b72491d["TourEmbed"]
    class component_TourEmbed_4b72491d rootComponent
```

## Relationships

- RENDERS → `Route`
- RENDERS → `Square`
- RENDERS → `Play`
- RENDERS → `Check`
- RENDERS → `Copy`
- USES_HOOK → `useState`

<!-- source: interface-testimonialcardprops-2.md -->

# TestimonialCardProps

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/components/shared/testimonial-card.tsx` (line 13)

## Properties

| Property | Type |
|---|---|
| `quoteKey` | `string` |
| `authorNameKey` | `string` |
| `authorRoleKey` | `string` |
| `avatarSrc` | `string` |
| `rating` | `number` |

<!-- source: component-trypage.md -->

# TryPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/(marketing)/try/page.tsx` (line 20)

## Diagram

```mermaid
graph TD
    component_TryPage_79b58c98["TryPage"]
    class component_TryPage_79b58c98 rootComponent
```

## Relationships

- RENDERS → `CodebaseChat`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-textnode.md -->

# TextNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 20)

Text content node (markdown)

## Properties

| Property | Type |
|---|---|
| `type` | `'text'` |
| `content` | `string` |

<!-- source: component-usagedashboard.md -->

# UsageDashboard

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/AI/UsageDashboard.tsx` (line 10)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `stats` | `AIUsageStats` | ✓ | - |
| `loading` | `boolean` | - | - |

## Diagram

```mermaid
graph TD
    component_UsageDashboard_75f6d25f["UsageDashboard"]
    class component_UsageDashboard_75f6d25f rootComponent
```

## Relationships

- RENDERS → `StatCard`

<!-- source: interface-themecolors.md -->

# ThemeColors

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `primary` | `ColorScale` |
| `secondary` | `ColorScale` |
| `neutral` | `ColorScale` |
| `success` | `SemanticColorScale` |
| `warning` | `SemanticColorScale` |
| `error` | `SemanticColorScale` |
| `info` | `SemanticColorScale` |

<!-- source: component-usercursors.md -->

# UserCursors

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Editor/UserCursors.tsx` (line 111)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `users` | `UserWithPosition[]` | ✓ | - |
| `showLabels` | `boolean` | - | true |
| `containerRef` | `unknown` | - | - |
| `className` | `string` | - | "" |

## Diagram

```mermaid
graph TD
    component_UserCursors_31adce80["UserCursors"]
    class component_UserCursors_31adce80 rootComponent
```

## Relationships

- RENDERS → `Cursor`
- USES_HOOK → `useMemo`

<!-- source: interface-themeconfig-2.md -->

# ThemeConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 125)

Theme configuration

## Properties

| Property | Type |
|---|---|
| `defaultMode` | `ThemeMode` |
| `enablePersistence` | `boolean` |
| `storageKey` | `string` |
| `enableSystemPreference` | `boolean` |
| `customTokens` | `Partial<ThemeTokens>` |

<!-- source: component-userspage.md -->

# UsersPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/admin/users/page.tsx` (line 9)

## Diagram

```mermaid
graph TD
    component_UsersPage_2f8baf48["UsersPage"]
    class component_UsersPage_2f8baf48 rootComponent
```

## Relationships

- RENDERS → `motion-div`
- RENDERS → `UsersIcon`

<!-- source: interface-themetokens-2.md -->

# ThemeTokens

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 109)

Complete theme token definition

## Properties

| Property | Type |
|---|---|
| `colors` | `ThemeColors` |
| `typography` | `Typography` |
| `spacing` | `Spacing` |
| `borderRadius` | `BorderRadius` |
| `shadows` | `Shadows` |

<!-- source: component-variantpicker.md -->

# VariantPicker

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/pme/variant-picker.tsx` (line 24)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `onPreview` | `Function` | ✓ | - |
| `onBack` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_VariantPicker_1aaae3b4["VariantPicker"]
    class component_VariantPicker_1aaae3b4 rootComponent
```

## Relationships

- USES_HOOK → `usePmeStore`
- USES_HOOK → `usePme`
- USES_HOOK → `useState`

<!-- source: interface-themeupdateevent.md -->

# ThemeUpdateEvent

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 141)

Theme update event

## Properties

| Property | Type |
|---|---|
| `mode` | `ThemeMode` |
| `tokens` | `ThemeTokens` |
| `timestamp` | `number` |

<!-- source: component-verifyemailpage.md -->

# VerifyEmailPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/(auth)/verify-email/page.tsx` (line 58)

## Diagram

```mermaid
graph TD
    component_VerifyEmailPage_357d51f7["VerifyEmailPage"]
    class component_VerifyEmailPage_357d51f7 rootComponent
```

## Relationships

- RENDERS → `Suspense`
- RENDERS → `VerifyEmailContent`

<!-- source: interface-themevars-2.md -->

# ThemeVars

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/lib/theme.ts` (line 10)

## Properties

| Property | Type |
|---|---|
| `'--bg-page'` | `string` |
| `'--bg-surface'` | `string` |
| `'--bg-surface-alt'` | `string` |
| `'--bg-nav'` | `string` |
| `'--text-heading'` | `string` |
| `'--text-body'` | `string` |
| `'--text-muted'` | `string` |
| `'--text-on-accent'` | `string` |
| `'--accent'` | `string` |
| `'--accent-hover'` | `string` |
| `'--accent-subtle'` | `string` |
| `'--accent-glow'` | `string` |
| `'--border'` | `string` |
| `'--border-hover'` | `string` |

<!-- source: component-versionbanners.md -->

# VersionBanners

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/DeprecationBanner.tsx` (line 8)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `slugId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_VersionBanners_2111a7a5["VersionBanners"]
    class component_VersionBanners_2111a7a5 rootComponent
```

## Relationships

- USES_HOOK → `useVersionContext`
- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`

<!-- source: interface-tocentry-2.md -->

# TocEntry

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/components/TableOfContents.tsx` (line 11)

Table of Contents entry interface

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `text` | `string` |
| `level` | `number` |
| `children` | `TocEntry[]` |

<!-- source: component-versioncontext-ts.md -->

# versionContext.ts

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/stores/versionContext.ts` (line 1)

## Diagram

```mermaid
graph TD
    component_versionContext_ts_61f905["versionContext.ts"]
    class component_versionContext_ts_61f905 rootComponent
```

<!-- source: interface-tokenbudget.md -->

# TokenBudget

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 285)

## Properties

| Property | Type |
|---|---|
| `maxInput` | `number` |
| `maxOutput` | `number` |
| `maxTotal` | `number` |

<!-- source: component-versiondropdown.md -->

# VersionDropdown

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Layout/VersionDropdown.tsx` (line 12)

## Diagram

```mermaid
graph TD
    component_VersionDropdown_4ed9973d["VersionDropdown"]
    class component_VersionDropdown_4ed9973d rootComponent
```

## Relationships

- RENDERS → `TagIcon`
- USES_HOOK → `useSession`
- USES_HOOK → `useProjectContext`
- USES_HOOK → `useVersionContext`
- USES_HOOK → `useEffect`

<!-- source: interface-tokensummary.md -->

# TokenSummary

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/pipeline/token-tracker.ts` (line 29)

## Properties

| Property | Type |
|---|---|
| `totalInputTokens` | `number` |
| `totalOutputTokens` | `number` |
| `totalTokens` | `number` |
| `totalCostUsd` | `number` |
| `byStage` | `Record<string, StageTokenSummary>` |
| `byModel` | `Record<string, ModelTokenSummary>` |
| `budgetRemaining` | `number` |
| `budgetUsedPercent` | `number` |

<!-- source: component-versionedaudiencepage.md -->

# VersionedAudiencePage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/v/[versionNumber]/[audienceSlug]/page.tsx` (line 9)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_VersionedAudiencePage_64a5ab97["VersionedAudiencePage"]
    class component_VersionedAudiencePage_64a5ab97 rootComponent
```

## Relationships

- RENDERS → `Link`
- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-tokentrackerconfig.md -->

# TokenTrackerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/pipeline/token-tracker.ts` (line 24)

## Properties

| Property | Type |
|---|---|
| `budget` | `TokenBudget` |
| `warnThreshold` | `number` |

<!-- source: component-versioneddocumentpage.md -->

# VersionedDocumentPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/v/[versionNumber]/[audienceSlug]/[documentSlug]/page.tsx` (line 8)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_VersionedDocumentPage_2cb8a95b["VersionedDocumentPage"]
    class component_VersionedDocumentPage_2cb8a95b rootComponent
```

## Relationships

- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-tokenusage-3.md -->

# TokenUsage

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/common.types.ts` (line 291)

## Properties

| Property | Type |
|---|---|
| `stage` | `JobStage` |
| `inputTokens` | `number` |
| `outputTokens` | `number` |
| `model` | `'claude' | 'openai'` |
| `timestamp` | `Date` |
| `cost` | `number` |

<!-- source: component-versionedprojectpage.md -->

# VersionedProjectPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/v/[versionNumber]/page.tsx` (line 10)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_VersionedProjectPage_6b6f3d00["VersionedProjectPage"]
    class component_VersionedProjectPage_6b6f3d00 rootComponent
```

## Relationships

- RENDERS → `Link`
- USES_HOOK → `useVersionContext`
- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-troubleshootinggeneratorinput.md -->

# TroubleshootingGeneratorInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-14.types.ts` (line 139)

## Properties

| Property | Type |
|---|---|
| `appName` | `string` |
| `synthesis` | `{
    summary: string;
    personas: Array<{ name: string; description: string }>;
    featureAreas: Array<{ name: string; description: string; modules: string[] }>;
  }` |
| `troubleshootingSections` | `ExtractedTroubleshootingSection[]` |
| `existingCategories` | `DocumentCategoryStructure[]` |
| `existingDocuments` | `PlannedDocument[]` |
| `generatedDocuments` | `GeneratedDocument[]` |
| `adminDocIds` | `Set<string>` |

<!-- source: component-versionhistorypanel.md -->

# VersionHistoryPanel

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Document/VersionHistoryPanel.tsx` (line 41)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `documentId` | `string` | ✓ | - |
| `currentVersion` | `number` | ✓ | - |
| `onSelectVersion` | `Function` | ✓ | - |
| `onRestore` | `Function` | ✓ | - |
| `onClose` | `Function` | ✓ | - |
| `selectedRevisionId` | `string` | - | - |

## Diagram

```mermaid
graph TD
    component_VersionHistoryPanel_48e35512["VersionHistoryPanel"]
    class component_VersionHistoryPanel_48e35512 rootComponent
```

## Relationships

- RENDERS → `motion-aside`
- RENDERS → `ClockIcon`
- RENDERS → `XMarkIcon`
- RENDERS → `ArrowsRightLeftIcon`
- RENDERS → `CheckIcon`
- RENDERS → `RevisionCard`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useEffect`
- USES_HOOK → `useMemo`

<!-- source: interface-trustbadge-2.md -->

# TrustBadge

**Kind:** Interface

**Source:** `atloria-monorepo/templates/site-bootstrap/src/sections/social-proof/social-proof-trust-badges.tsx` (line 20)

## Properties

| Property | Type |
|---|---|
| `icon` | `LucideIcon` |
| `logoSrc` | `string` |
| `nameKey` | `string` |

<!-- source: component-versioningtogglesection.md -->

# VersioningToggleSection

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/page.tsx` (line 959)

Versioning Toggle Section — enables/disables doc versioning for a project.

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_VersioningToggleSection_255523a4["VersioningToggleSection"]
    class component_VersioningToggleSection_255523a4 rootComponent
```

## Relationships

- USES_HOOK → `useAPIClient`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-typography.md -->

# Typography

**Kind:** Interface

**Source:** `atloria-monorepo/packages/theme-engine/src/lib/types.ts` (line 66)

## Properties

| Property | Type |
|---|---|
| `fontFamily` | `FontFamily` |
| `fontSize` | `FontSize` |
| `fontWeight` | `FontWeight` |
| `lineHeight` | `LineHeight` |

<!-- source: component-versionprovider.md -->

# VersionProvider

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/VersionContext.tsx` (line 39)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `children` | `ReactNode` | ✓ | - |
| `slugId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_VersionProvider_6eaf0372["VersionProvider"]
    class component_VersionProvider_6eaf0372 rootComponent
```

## Relationships

- RENDERS → `VersionContext-Provider`
- USES_HOOK → `usePathname`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-uilibrarysummary.md -->

# UILibrarySummary

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/ui-library-detector.ts` (line 39)

UI library usage summary

## Properties

| Property | Type |
|---|---|
| `library` | `UILibrary` |
| `componentCount` | `number` |
| `uniqueComponents` | `string[]` |
| `formComponents` | `number` |
| `dataComponents` | `number` |
| `layoutComponents` | `number` |

<!-- source: component-versionscontent.md -->

# VersionsContent

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/versions/page.tsx` (line 96)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `projectId` | `string` | ✓ | - |
| `onGenerate` | `Function` | - | - |

## Diagram

```mermaid
graph TD
    component_VersionsContent_7bbc343f["VersionsContent"]
    class component_VersionsContent_7bbc343f rootComponent
```

## Relationships

- RENDERS → `RunningJobCard`
- USES_HOOK → `useSession`
- USES_HOOK → `useAPIClient`
- USES_HOOK → `useRouter`
- USES_HOOK → `useState`
- USES_HOOK → `useEffect`

<!-- source: interface-uncertainty.md -->

# Uncertainty

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-10.types.ts` (line 128)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `description` | `string` |
| `severity` | `'low' | 'medium' | 'high'` |
| `resolved` | `boolean` |
| `resolution` | `string` |

<!-- source: component-versionspage.md -->

# VersionsPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/versions/page.tsx` (line 535)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_VersionsPage_6627afb9["VersionsPage"]
    class component_VersionsPage_6627afb9 rootComponent
```

## Relationships

- USES_HOOK → `useRouter`
- USES_HOOK → `useEffect`

<!-- source: interface-updateaudiencedto.md -->

# UpdateAudienceDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/audiences.ts` (line 19)

Audience update DTO

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `color` | `string` |
| `icon` | `string` |
| `description` | `string` |

<!-- source: component-versionswitcher.md -->

# VersionSwitcher

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/p/[slugId]/components/VersionSwitcher.tsx` (line 9)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `slugId` | `string` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_VersionSwitcher_5bf937b6["VersionSwitcher"]
    class component_VersionSwitcher_5bf937b6 rootComponent
```

## Relationships

- RENDERS → `ChevronDownIcon`
- RENDERS → `CheckIcon`
- USES_HOOK → `useVersionContext`
- USES_HOOK → `useLanguageContext`
- USES_HOOK → `useState`
- USES_HOOK → `useRef`
- USES_HOOK → `useEffect`

<!-- source: interface-updatecategorydto.md -->

# UpdateCategoryDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/category.dto.ts` (line 21)

DTO for updating an existing category

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `icon` | `string` |
| `color` | `string` |
| `order` | `number` |
| `parentId` | `string` |
| `defaultDocId` | `string` |

<!-- source: component-viewtoggle.md -->

# ViewToggle

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/components/Documents/ViewToggle.tsx` (line 16)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `view` | `ViewMode` | ✓ | - |
| `onChange` | `Function` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_ViewToggle_5307b14b["ViewToggle"]
    class component_ViewToggle_5307b14b rootComponent
```

## Relationships

- RENDERS → `Squares2X2Icon`
- RENDERS → `ListBulletIcon`

<!-- source: interface-updatecommentdto.md -->

# UpdateCommentDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/comment.dto.ts` (line 26)

Update comment DTO

## Properties

| Property | Type |
|---|---|
| `content` | `string` |
| `resolved` | `boolean` |

<!-- source: component-webhookspage.md -->

# WebhooksPage

**Kind:** Component

**Source:** `atloria-monorepo/apps/web/src/app/app/projects/[id]/settings/webhooks/page.tsx` (line 272)

## Props

| Name | Type | Required | Default |
|---|---|---|---|
| `params` | `Promise` | ✓ | - |

## Diagram

```mermaid
graph TD
    component_WebhooksPage_41434e83["WebhooksPage"]
    class component_WebhooksPage_41434e83 rootComponent
```

## Relationships

- RENDERS → `WebhooksContent`

<!-- source: interface-updatedocumentdto.md -->

# UpdateDocumentDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/document.dto.ts` (line 28)

DTO for updating a document

## Properties

| Property | Type |
|---|---|
| `title` | `string` |
| `slug` | `string` |
| `content` | `string` |
| `contentHtml` | `string` |
| `type` | `DocumentType` |
| `audiences` | `Audience[]` |
| `state` | `DocumentState` |
| `kgEntityId` | `string` |
| `kgEntityType` | `string` |
| `isPublic` | `boolean` |
| `canRegenerate` | `boolean` |
| `updatedById` | `string` |

<!-- source: interface-updateorganizationdto.md -->

# UpdateOrganizationDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/organization.dto.ts` (line 12)

DTO for updating an organization

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |

<!-- source: interface-updateprojectdto.md -->

# UpdateProjectDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/project.dto.ts` (line 17)

DTO for updating a project

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `slug` | `string` |
| `description` | `string` |
| `themeId` | `string` |
| `repoUrl` | `string` |
| `repoBranch` | `string` |

<!-- source: interface-updatesuggestiondto.md -->

# UpdateSuggestionDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/suggestion.dto.ts` (line 25)

Update suggestion DTO

## Properties

| Property | Type |
|---|---|
| `status` | `SuggestionStatus` |
| `reviewComment` | `string` |

<!-- source: interface-updatethemedto.md -->

# UpdateThemeDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/theme.dto.ts` (line 27)

DTO for updating a theme

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `colors` | `ThemeColors` |
| `typography` | `ThemeTypography` |
| `layout` | `ThemeLayout` |
| `customCss` | `string` |
| `darkModeEnabled` | `boolean` |
| `darkModeDefault` | `string` |
| `darkModeColors` | `ThemeColors` |
| `whiteLabelEnabled` | `boolean` |
| `hidePoweredBy` | `boolean` |
| `customDomain` | `string` |
| `customFooter` | `string` |
| `audienceThemes` | `AudienceThemes` |
| `isActive` | `boolean` |

<!-- source: interface-updateuserdto.md -->

# UpdateUserDto

**Kind:** Interface

**Source:** `atloria-monorepo/packages/types/src/dtos/user.dto.ts` (line 17)

DTO for updating a user

## Properties

| Property | Type |
|---|---|
| `email` | `string` |
| `name` | `string` |
| `passwordHash` | `string` |
| `role` | `UserRole` |

<!-- source: interface-uploadbatchconfig.md -->

# UploadBatchConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 76)

Upload batch configuration

## Properties

| Property | Type |
|---|---|
| `maxRetries` | `number` |
| `retryDelay` | `number` |
| `maxConcurrency` | `number` |
| `requestsPerSecond` | `number` |
| `uploadScreenshotsFirst` | `boolean` |

<!-- source: interface-uploadbatchconfig-2.md -->

# UploadBatchConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-13.types.ts` (line 48)

Upload batch configuration

## Properties

| Property | Type |
|---|---|
| `maxConcurrency` | `number` |
| `maxRetries` | `number` |
| `retryDelay` | `number` |
| `requestsPerSecond` | `number` |
| `uploadScreenshotsFirst` | `boolean` |

<!-- source: interface-uploadconfig.md -->

# UploadConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 29)

Upload configuration

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `organizationId` | `string` |
| `audienceSlug` | `string` |
| `outputDir` | `string` |
| `jobId` | `string` |
| `batch` | `UploadBatchConfig` |
| `uploadImage` | `ImageUploadFn` |
| `skipUnverifiableContent` | `boolean` |
| `skipSlugs` | `string[]` |
| `docVersionId` | `string` |
| `updateAssetsOnly` | `boolean` |
| `onlySlugs` | `string[]` |

<!-- source: interface-uploadconfig-2.md -->

# UploadConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 280)

Configuration for the upload service

## Properties

| Property | Type |
|---|---|
| `connectionString` | `string` |
| `containerName` | `string` |
| `projectPrefix` | `string` |
| `checkForDuplicates` | `boolean` |
| `duplicateThreshold` | `number` |
| `maxConcurrentUploads` | `number` |
| `retryCount` | `number` |

<!-- source: interface-uploadeddocument.md -->

# UploadedDocument

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-13.types.ts` (line 31)

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `title` | `string` |
| `url` | `string` |
| `uploadedAt` | `Date` |

<!-- source: interface-uploadeditem.md -->

# UploadedItem

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 205)

Successfully uploaded item

## Properties

| Property | Type |
|---|---|
| `type` | `'category' | 'document' | 'screenshot'` |
| `id` | `string` |
| `databaseId` | `string` |
| `title` | `string` |
| `slug` | `string` |
| `action` | `'created' | 'updated'` |
| `version` | `number` |

<!-- source: interface-uploadfailure.md -->

# UploadFailure

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-13.types.ts` (line 38)

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `title` | `string` |
| `error` | `string` |
| `retryable` | `boolean` |

<!-- source: interface-uploadinput.md -->

# UploadInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-13.types.ts` (line 13)

## Properties

| Property | Type |
|---|---|
| `documents` | `GeneratedDocument[]` |
| `screenshots` | `CapturedScreenshot[]` |
| `projectId` | `string` |
| `apiKey` | `string` |

<!-- source: interface-uploadprogress.md -->

# UploadProgress

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 176)

Upload progress update

## Properties

| Property | Type |
|---|---|
| `phase` | `'screenshots' | 'categories' | 'documents'` |
| `current` | `number` |
| `total` | `number` |
| `currentItem` | `string` |
| `percentage` | `number` |
| `message` | `string` |

<!-- source: interface-uploadprogress-2.md -->

# UploadProgress

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-13.types.ts` (line 77)

Upload progress tracking

## Properties

| Property | Type |
|---|---|
| `phase` | `'screenshots' | 'documents' | 'complete'` |
| `total` | `number` |
| `completed` | `number` |
| `failed` | `number` |
| `currentItem` | `string` |
| `estimatedTimeRemaining` | `number` |

<!-- source: interface-uploadprogress-3.md -->

# UploadProgress

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-uploader.service.ts` (line 26)

Progress callback for upload operations

## Properties

| Property | Type |
|---|---|
| `completed` | `number` |
| `total` | `number` |
| `currentItem` | `string` |

<!-- source: interface-uploadresult-2.md -->

# UploadResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 265)

Result of uploading a screenshot

## Properties

| Property | Type |
|---|---|
| `placeholderId` | `string` |
| `success` | `boolean` |
| `blobUrl` | `string` |
| `isNew` | `boolean` |
| `reusedFromId` | `string` |
| `reusedFromUrl` | `string` |
| `contentHash` | `string` |
| `perceptualHash` | `string` |
| `error` | `string` |

<!-- source: interface-uploadstats.md -->

# UploadStats

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-13-upload/upload.types.ts` (line 229)

Upload statistics

## Properties

| Property | Type |
|---|---|
| `categoriesCreated` | `number` |
| `categoriesUpdated` | `number` |
| `documentsCreated` | `number` |
| `documentsUpdated` | `number` |
| `documentsOutdated` | `number` |
| `screenshotsUploaded` | `number` |
| `screenshotsFailed` | `number` |
| `assetsUpdated` | `number` |
| `totalDurationMs` | `number` |

<!-- source: interface-uploadstats-2.md -->

# UploadStats

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-uploader.service.ts` (line 37)

Upload statistics

## Properties

| Property | Type |
|---|---|
| `totalUploaded` | `number` |
| `newUploads` | `number` |
| `reused` | `number` |
| `failed` | `number` |
| `totalBytes` | `number` |

<!-- source: interface-urlgroup.md -->

# UrlGroup

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 147)

Group of screenshots on the same URL (for efficient capture)

## Properties

| Property | Type |
|---|---|
| `baseUrl` | `string` |
| `screenshotIds` | `string[]` |
| `requiresAuth` | `boolean` |
| `estimatedCaptureTime` | `number` |
| `priority` | `number` |

<!-- source: interface-useaudiencesoptions.md -->

# UseAudiencesOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useAudiences.ts` (line 10)

Options for useAudiences hook

## Properties

| Property | Type |
|---|---|
| `autoFetch` | `boolean` |

<!-- source: interface-useaudiencesreturn.md -->

# UseAudiencesReturn

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useAudiences.ts` (line 17)

Return type for useAudiences hook

## Properties

| Property | Type |
|---|---|
| `audiences` | `AudienceModel[]` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `refresh` | `() => Promise<void>` |
| `createAudience` | `(data: {
    name: string;
    slug: string;
    color: string;
    icon: string;
    description?: string;
  }) => Promise<AudienceModel>` |
| `updateAudience` | `(
    id: string,
    data: {
      name?: string;
      slug?: string;
      color?: string;
      icon?: string;
      description?: string;
    },
  ) => Promise<AudienceModel>` |
| `deleteAudience` | `(id: string) => Promise<void>` |

<!-- source: interface-useauthreturn.md -->

# UseAuthReturn

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useAuth.ts` (line 10)

Return type for useAuth hook

## Properties

| Property | Type |
|---|---|
| `user` | `User | null` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `login` | `(email: string, password: string) => Promise<void>` |
| `logout` | `() => Promise<void>` |
| `register` | `(data: { email: string; password: string; name: string }) => Promise<void>` |
| `isAuthenticated` | `boolean` |

<!-- source: interface-usecommentsoptions.md -->

# UseCommentsOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useComments.ts` (line 10)

Options for useComments hook

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `autoFetch` | `boolean` |
| `enableRealtime` | `boolean` |

<!-- source: interface-usecommentsreturn.md -->

# UseCommentsReturn

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useComments.ts` (line 19)

Return type for useComments hook

## Properties

| Property | Type |
|---|---|
| `comments` | `CommentWithUser[]` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `addComment` | `(dto: CreateCommentDto) => Promise<CommentWithUser>` |
| `updateComment` | `(commentId: string, content: string) => Promise<CommentWithUser>` |
| `deleteComment` | `(commentId: string) => Promise<void>` |
| `resolveComment` | `(commentId: string) => Promise<CommentWithUser>` |
| `unresolveComment` | `(commentId: string) => Promise<CommentWithUser>` |
| `addReply` | `(parentCommentId: string, content: string) => Promise<CommentWithUser>` |
| `refresh` | `() => Promise<void>` |

<!-- source: interface-usedocumentoptions.md -->

# UseDocumentOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useDocument.ts` (line 11)

Options for useDocument hook

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `autoFetch` | `boolean` |

<!-- source: interface-usedocumentreturn.md -->

# UseDocumentReturn

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useDocument.ts` (line 19)

Return type for useDocument hook

## Properties

| Property | Type |
|---|---|
| `document` | `Document | null` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `save` | `(doc: Partial<Document>) => Promise<Document>` |
| `create` | `(doc: Partial<Document>) => Promise<Document>` |
| `remove` | `() => Promise<void>` |
| `refresh` | `() => Promise<void>` |
| `canEdit` | `(user: User) => boolean` |
| `canPublish` | `(user: User) => boolean` |
| `canDelete` | `(user: User) => boolean` |
| `canView` | `(user: User | null) => boolean` |
| `manager` | `DocumentManager` |

<!-- source: interface-usedocumentsoptions.md -->

# UseDocumentsOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useDocuments.ts` (line 10)

Options for useDocuments hook

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `autoFetch` | `boolean` |
| `filters` | `DocumentFilters` |

<!-- source: interface-usedocumentsreturn.md -->

# UseDocumentsReturn

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useDocuments.ts` (line 19)

Return type for useDocuments hook

## Properties

| Property | Type |
|---|---|
| `documents` | `Document[]` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `totalCount` | `number` |
| `refresh` | `() => Promise<void>` |

<!-- source: interface-useprojectoptions.md -->

# UseProjectOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useProject.ts` (line 11)

Options for useProject hook

## Properties

| Property | Type |
|---|---|
| `projectId` | `string` |
| `autoFetch` | `boolean` |

<!-- source: interface-useprojectreturn.md -->

# UseProjectReturn

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useProject.ts` (line 19)

Return type for useProject hook

## Properties

| Property | Type |
|---|---|
| `project` | `Project | null` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `save` | `(project: Partial<Project>) => Promise<Project>` |
| `create` | `(project: Partial<Project>) => Promise<Project>` |
| `remove` | `() => Promise<void>` |
| `refresh` | `() => Promise<void>` |
| `canAccess` | `(user: User) => boolean` |
| `canEdit` | `(user: User) => boolean` |
| `canDelete` | `(user: User) => boolean` |
| `canCreateDocuments` | `(user: User) => boolean` |
| `canManageSettings` | `(user: User) => boolean` |
| `getPermissions` | `(user: User) => {
    canView: boolean;
    canEdit: boolean;
    canDelete: boolean;
    canCreateDocuments: boolean;
    canManageSettings: boolean;
  }` |
| `manager` | `ProjectManager` |

<!-- source: interface-useprojectsoptions.md -->

# UseProjectsOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useProjects.ts` (line 10)

Options for useProjects hook

## Properties

| Property | Type |
|---|---|
| `organizationId` | `string` |
| `autoFetch` | `boolean` |

<!-- source: interface-useprojectsreturn.md -->

# UseProjectsReturn

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useProjects.ts` (line 18)

Return type for useProjects hook

## Properties

| Property | Type |
|---|---|
| `projects` | `Project[]` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `refresh` | `() => Promise<void>` |
| `deleteProject` | `(id: string) => Promise<void>` |

<!-- source: interface-user.md -->

# User

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/users.ts` (line 8)

User model for API responses

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `email` | `string` |
| `name` | `string` |
| `role` | `string` |
| `organizationId` | `string` |
| `createdAt` | `string` |
| `updatedAt` | `string` |

<!-- source: interface-useraction.md -->

# UserAction

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-03.types.ts` (line 46)

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `description` | `string` |
| `httpMethod` | `'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'` |
| `path` | `string` |
| `component` | `string` |

<!-- source: interface-userfeature.md -->

# UserFeature

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-03.types.ts` (line 35)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `actions` | `UserAction[]` |
| `requiredRoles` | `string[]` |
| `relatedFeatures` | `string[]` |
| `evidence` | `FeatureEvidence[]` |
| `confidence` | `number` |

<!-- source: interface-userjourneystep.md -->

# UserJourneyStep

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/cross-language.types.ts` (line 150)

UserJourneyStep - Complete step in a user workflow

Combines frontend action with backend processing for clear user docs.

## Properties

| Property | Type |
|---|---|
| `order` | `number` |
| `action` | `string` |
| `screen` | `string` |
| `screenPath` | `string` |
| `processing` | `{
    description: string; // "System validates and saves order"
    validationRules?: string[]; // ["Customer is required", "At least one item"]
    permissionRequired?: string; // "Sales Manager or Admin"
  }` |
| `outcomes` | `Array<{
    type: 'success' | 'error' | 'redirect';
    description: string; // "Order created successfully"
    nextScreen?: string; // Where user goes next
  }>` |

<!-- source: interface-userlistparams.md -->

# UserListParams

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/endpoints/users.ts` (line 21)

User list query parameters

## Properties

| Property | Type |
|---|---|
| `organizationId` | `string` |
| `role` | `string` |
| `search` | `string` |
| `limit` | `number` |
| `offset` | `number` |

<!-- source: interface-userpersona.md -->

# UserPersona

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-05.types.ts` (line 48)

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `description` | `string` |
| `goals` | `string[]` |
| `painPoints` | `string[]` |
| `relevantFeatures` | `string[]` |

<!-- source: interface-usesuggestionsoptions.md -->

# UseSuggestionsOptions

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useSuggestions.ts` (line 10)

Options for useSuggestions hook

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `autoFetch` | `boolean` |
| `enableRealtime` | `boolean` |

<!-- source: interface-usesuggestionsreturn.md -->

# UseSuggestionsReturn

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/hooks/useSuggestions.ts` (line 19)

Return type for useSuggestions hook

## Properties

| Property | Type |
|---|---|
| `suggestions` | `SuggestionWithUser[]` |
| `loading` | `boolean` |
| `error` | `Error | null` |
| `addSuggestion` | `(dto: CreateSuggestionDto) => Promise<SuggestionWithUser>` |
| `updateSuggestion` | `(suggestionId: string, status: SuggestionStatus, reviewComment?: string) => Promise<SuggestionWithUser>` |
| `deleteSuggestion` | `(suggestionId: string) => Promise<void>` |
| `acceptSuggestion` | `(suggestionId: string, reviewComment?: string) => Promise<SuggestionWithUser>` |
| `rejectSuggestion` | `(suggestionId: string, reviewComment?: string) => Promise<SuggestionWithUser>` |
| `refresh` | `() => Promise<void>` |

<!-- source: interface-v2pipelineconfig.md -->

# V2PipelineConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/orchestrator.ts` (line 87)

## Properties

| Property | Type |
|---|---|
| `repository` | `{
    url: string;
    branch: string;
    username?: string;
    password?: string;
    paths: {
      frontend?: string;
      backend?: string;
    };
    /** Parser configuration for parser-core integration */
    parsers?: {
      /** Explicit parser names to use (e.g. ['odoo-xml', 'python', 'django']). If omitted, auto-detect. */
      explicit?: string[];
      /** Additional file patterns to include beyond parser defaults */
      additionalPatterns?: string[];
      /** Use parser-core for parsing (default: true). Set false for legacy regex fallback. */
      useParserCore?: boolean;
    };
  }` |
| `project` | `{
    id: string;
    name: string;
    description?: string;
  }` |
| `ai` | `{
    /** AI provider to use (default: 'claude') */
    provider?: 'openai' | 'claude' | 'azure-responses';
    // Claude/Anthropic config
    azureEndpoint?: string;
    azureApiKey?: string;
    anthropicApiKey?: string;
    // OpenAI config
    openaiApiKey?: string;
    azureOpenaiEndpoint?: string;
    azureOpenaiApiKey?: string;
    azureOpenaiDeployment?: string;
    // Azure Responses API config (gpt-5.4 by default, overridable via AZURE_OPENAI_MODEL)
    azureResponsesEndpoint?: string;
    azureResponsesApiKey?: string;
    azureResponsesApiVersion?: string;
    // Per-stage model override (used with azure-responses provider)
    stageModels?: {
      analysis?: string;
      synthesis?: string;
      structure?: string;
      planning?: string;
      generation?: string;
      verification?: string;
      screenshots?: string;
    };
    // Shared config
    model?: string;
    maxTokens?: number;
  }` |
| `documentation` | `{
    targetAudience: 'beginner' | 'intermediate' | 'advanced';
    tone: 'formal' | 'friendly' | 'technical';
    language: string;
    maxDocuments: number;
    // User-suggested categories from project config (AI can add/remove based on codebase)
    suggestedCategories?: string[];
  }` |
| `output` | `{
    workDir: string;
    outputDir: string;
  }` |
| `options` | `{
    skipScreenshots?: boolean;
    skipUpload?: boolean;
    skipVerification?: boolean;
    resumeFromCheckpoint?: boolean;
    skipQualityGate?: boolean;
    /** Run screenshots in background (non-blocking). Default: true */
    asyncScreenshots?: boolean;
    /** Skip AI verification for docs that passed quality gate. Default: true */
    skipVerificationForPassingDocs?: boolean;
    /** Screenshots only — skip doc generation, read existing docs from DB */
    screenshotsOnly?: boolean;
    /** Use V4d structure generation — replaces Stages 4+5+6 with parser-based approach.
     *  Uses slim synthesis (1 AI call) + 3 parallel structure sessions.
     *  ~3 min, ~$0.50 vs current ~37 min, ~$8. */
    useV4dStructure?: boolean;
    /** Enable agent-powered verification — uses AI agent with code tools to verify
     *  generated docs against source code. More thorough than Stage 11's LLM-only check.
     *  Runs after Quality Gate, before Stage 11. Default: false (opt-in). */
    enableAgentVerification?: boolean;
    /** Use agent-writer for Stage 10 — AI agent explores source code AND writes docs
     *  in the same session. More accurate than GeneratorService because the agent reads
     *  actual code while writing. Requires Azure Responses API credentials.
     *  Default: false (opt-in). */
    useAgentWriter?: boolean;
  }` |
| `businessDomain` | `'ERP' | 'SaaS' | 'E-commerce' | 'CMS' | 'Generic'` |
| `businessContext` | `BusinessContext` |
| `contextSources` | `{ type: 'pdf' | 'url' | 'file' | 'text'; path: string; content?: string }[]` |
| `rateLimiter` | `{
    /** Max concurrent AI requests. Default: 5 for Azure, 30 for others */
    maxConcurrent?: number;
    /** Min delay between requests in ms. Default: 1000 for Azure, 25 for others */
    minDelayMs?: number;
  }` |
| `screenshots` | `{
    /** URL of the screenshot-worker microservice */
    workerUrl?: string;
    /** Site URL for screenshots (defaults to siteUrl from config) */
    siteUrl?: string;
    /** Login URL for authentication */
    loginUrl?: string;
    /** Login credentials */
    credentials?: {
      username: string;
      password: string;
      usernameSelector?: string;
      passwordSelector?: string;
      submitSelector?: string;
      successSelector?: string;
    };
    /** Viewport configuration */
    viewport?: {
      width: number;
      height: number;
    };
    /** Screenshot format */
    format?: 'png' | 'jpeg' | 'webp';
    /** Screenshot quality (for jpeg/webp) */
    quality?: number;
    /** Maximum concurrent capture sessions */
    maxConcurrency?: number;
    /** Azure blob storage container name */
    azureContainerName?: string;
    /** Whether to check for duplicate screenshots */
    checkDuplicates?: boolean;
    /** Frontend framework hint (e.g. 'angular', 'react', 'vue') — used for URL validation */
    framework?: string;
  }` |
| `onScreenshotsComplete` | `(stats: { captured: number; failed: number; replaced: number; totalPlaceholders: number }) => void` |
| `onScreenshotProgress` | `(progress: { captured: number; failed: number; total: number; currentUrl?: string }) => void` |
| `upload` | `{
    /** Prisma client for database access */
    prisma: any; // Using 'any' to avoid circular dependency with @prisma/client
    /** Organization ID for document ownership */
    organizationId: string;
    /** User ID who created the documents */
    createdById: string;
    /** Job ID for tracking which job created documents */
    jobId?: string;
    /** Target audience slug (e.g., 'user', 'developer') */
    audienceSlug?: string;
    /** Optional function to upload images to Azure via assets API */
    uploadImage?: (buffer: Buffer, filename: string, mimeType: string) => Promise<string>;
    /** Batch configuration */
    batch?: {
      maxRetries?: number;
      retryDelay?: number;
      maxConcurrency?: number;
      requestsPerSecond?: number;
      uploadScreenshotsFirst?: boolean;
    };
    /** When true, documents with groundingScore < 0.3 are excluded from upload. Default: false */
    skipUnverifiableContent?: boolean;
    /** DocVersion ID (Phase 1) — when set, upload operates in create-only mode */
    docVersionId?: string;
  }` |

<!-- source: interface-v2pipelineresult.md -->

# V2PipelineResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/orchestrator.ts` (line 292)

## Properties

| Property | Type |
|---|---|
| `success` | `boolean` |
| `stages` | `V2StageResult[]` |
| `totalDurationMs` | `number` |
| `error` | `string` |
| `metrics` | `import('./utils/pipeline-metrics').PipelineMetrics` |
| `output` | `{
    documentsGenerated: number;
    documentsVerified: number;
    categories: number;
    totalTokensUsed: number;
    // Screenshot stats
    screenshotsCaptured?: number;
    screenshotsUploaded?: number;
    screenshotsFailed?: number;
    // Upload stats (Stage-13)
    documentsUploaded?: number;
    categoriesCreated?: number;
    categoriesUpdated?: number;
    documentsOutdated?: number;
    // Route mappings from Stage 1 (persisted for background screenshots)
    routeMappings?: unknown;
    /** True when screenshots are running in the background (async mode) */
    backgroundScreenshots?: boolean;
  }` |

<!-- source: interface-v2progressupdate.md -->

# V2ProgressUpdate

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/orchestrator.ts` (line 280)

## Properties

| Property | Type |
|---|---|
| `stage` | `JobStage` |
| `progress` | `number` |
| `stageProgress` | `number` |
| `currentItem` | `string` |
| `message` | `string` |
| `elapsedMs` | `number` |
| `estimatedRemainingMs` | `number` |

<!-- source: interface-v2stageresult.md -->

# V2StageResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/orchestrator.ts` (line 320)

## Properties

| Property | Type |
|---|---|
| `stage` | `JobStage` |
| `status` | `'success' | 'failed' | 'skipped'` |
| `durationMs` | `number` |
| `details` | `Record<string, unknown>` |
| `error` | `string` |

<!-- source: interface-v4dstructureinput.md -->

# V4dStructureInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-06-structure/v4d-structure.service.ts` (line 30)

## Properties

| Property | Type |
|---|---|
| `interactionMap` | `any` |
| `entities` | `any[]` |
| `businessContext` | `BusinessContext` |
| `projectName` | `string` |
| `routeMappings` | `any` |
| `applicationProfile` | `{ domain: string; moduleAreas: string[]; description: string }` |

<!-- source: interface-validationfield.md -->

# ValidationField

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/validation-detector.ts` (line 48)

A field with validation rules

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `rules` | `ValidationRule[]` |
| `errorMessage` | `string` |

<!-- source: interface-validationresult-2.md -->

# ValidationResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/validators/validation-result.ts` (line 4)

Validation result interface

## Properties

| Property | Type |
|---|---|
| `valid` | `boolean` |
| `errors` | `string[]` |

<!-- source: interface-validationrule.md -->

# ValidationRule

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/validation-detector.ts` (line 58)

A single validation rule

## Properties

| Property | Type |
|---|---|
| `type` | `string` |
| `value` | `string | number` |
| `message` | `string` |

<!-- source: interface-variantchild.md -->

# VariantChild

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 49)

Individual variant within a variant section

## Properties

| Property | Type |
|---|---|
| `audienceSlug` | `string` |
| `content` | `ASTNode[]` |
| `startLine` | `number` |
| `endLine` | `number` |
| `startOffset` | `number` |
| `endOffset` | `number` |

<!-- source: interface-variantnode.md -->

# VariantNode

**Kind:** Interface

**Source:** `atloria-monorepo/packages/core/src/rendering/types.ts` (line 40)

Variant section node
Represents a VARIANT:AUDIENCE wrapper with multiple variants

## Properties

| Property | Type |
|---|---|
| `type` | `'variant_section'` |
| `variants` | `VariantChild[]` |
| `defaultVariant` | `VariantChild` |

<!-- source: interface-verificationcorrection.md -->

# VerificationCorrection

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/verifier-agent.service.ts` (line 48)

## Properties

| Property | Type |
|---|---|
| `wrong` | `string` |
| `correct` | `string` |
| `file` | `string` |

<!-- source: interface-verificationinput.md -->

# VerificationInput

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-11.types.ts` (line 17)

## Properties

| Property | Type |
|---|---|
| `documents` | `GeneratedDocument[]` |
| `entities` | `Entity[]` |

<!-- source: interface-verificationissue.md -->

# VerificationIssue

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-11.types.ts` (line 43)

## Properties

| Property | Type |
|---|---|
| `claimId` | `string` |
| `claim` | `string` |
| `severity` | `'critical' | 'major' | 'minor'` |
| `reason` | `string` |
| `suggestion` | `string` |
| `autoFixed` | `boolean` |

<!-- source: interface-verificationreport.md -->

# VerificationReport

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/verifier-agent.service.ts` (line 38)

## Properties

| Property | Type |
|---|---|
| `documentId` | `string` |
| `title` | `string` |
| `verified` | `string[]` |
| `unverified` | `string[]` |
| `corrections` | `VerificationCorrection[]` |
| `confidence` | `number` |

<!-- source: interface-verificationresponse.md -->

# VerificationResponse

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/openai-reviewer.service.ts` (line 23)

## Properties

| Property | Type |
|---|---|
| `verifications` | `ClaimVerificationResult[]` |
| `inputTokens` | `number` |
| `outputTokens` | `number` |

<!-- source: interface-verificationresult.md -->

# VerificationResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-11.types.ts` (line 22)

## Properties

| Property | Type |
|---|---|
| `reports` | `AccuracyReport[]` |
| `correctedDocuments` | `GeneratedDocument[]` |
| `tokenUsage` | `TokenUsage[]` |

<!-- source: interface-verifieragentconfig.md -->

# VerifierAgentConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/verifier-agent.service.ts` (line 25)

## Properties

| Property | Type |
|---|---|
| `repoPath` | `string` |
| `concurrency` | `number` |
| `routeDataMap` | `Map<string, any>` |
| `documentRouteMap` | `Map<string, string[]>` |
| `onProgress` | `(completed: number, total: number, title: string) => void` |

<!-- source: interface-verifieragentresult.md -->

# VerifierAgentResult

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-10-generation/verifier-agent.service.ts` (line 57)

## Properties

| Property | Type |
|---|---|
| `reports` | `VerificationReport[]` |
| `correctedDocuments` | `GeneratedDocument[]` |
| `tokenUsage` | `TokenUsage[]` |
| `stats` | `{
    totalDocuments: number;
    totalVerified: number;
    totalUnverified: number;
    totalCorrections: number;
    durationMs: number;
  }` |

<!-- source: interface-verifierserviceconfig.md -->

# VerifierServiceConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-11-verification/verifier.service.ts` (line 34)

## Properties

| Property | Type |
|---|---|
| `accuracyThreshold` | `number` |
| `maxClaimsPerDocument` | `number` |
| `enableAutoFix` | `boolean` |
| `batchSize` | `number` |

<!-- source: interface-viewport.md -->

# Viewport

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 44)

Viewport configuration

## Properties

| Property | Type |
|---|---|
| `width` | `number` |
| `height` | `number` |
| `deviceScaleFactor` | `number` |
| `isMobile` | `boolean` |
| `hasTouch` | `boolean` |

<!-- source: interface-viewport-2.md -->

# Viewport

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/stage-12.types.ts` (line 92)

Viewport configuration for screenshot

## Properties

| Property | Type |
|---|---|
| `width` | `number` |
| `height` | `number` |
| `deviceScaleFactor` | `number` |
| `isMobile` | `boolean` |
| `hasTouch` | `boolean` |

<!-- source: interface-voidemitter.md -->

# VoidEmitter

**Kind:** Interface

**Source:** `atloria-monorepo/packages/editor/src/utils/voidEmitter.ts` (line 8)

An emitter object that has a single subscription that will be executed.
The construct is used so that the lexical nodes can focus their React component editors.

## Properties

| Property | Type |
|---|---|
| `subscribe` | `(cb: () => void) => void` |

<!-- source: interface-vueprop.md -->

# VueProp

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-01-parse/detectors/vue-detector.ts` (line 45)

Vue prop definition

## Properties

| Property | Type |
|---|---|
| `name` | `string` |
| `type` | `string` |
| `required` | `boolean` |
| `default` | `string` |

<!-- source: interface-waitfor.md -->

# WaitFor

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/screenshot-worker.types.ts` (line 32)

Wait condition for page readiness

## Properties

| Property | Type |
|---|---|
| `type` | `'selector' | 'timeout' | 'networkIdle' | 'loadState' | 'function'` |
| `selector` | `string` |
| `duration` | `number` |
| `state` | `'load' | 'domcontentloaded' | 'networkidle'` |
| `function` | `string` |
| `timeout` | `number` |

<!-- source: interface-websocketclient.md -->

# WebSocketClient

**Kind:** Interface

**Source:** `atloria-monorepo/packages/ui-react/src/types/api-client.ts` (line 24)

WebSocket client interface

<!-- source: interface-websocketconfig.md -->

# WebSocketConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/clients/WebSocketClient.ts` (line 31)

WebSocket client configuration

## Properties

| Property | Type |
|---|---|
| `autoReconnect` | `boolean` |
| `reconnectDelay` | `number` |
| `maxReconnectAttempts` | `number` |
| `enableLogging` | `boolean` |
| `heartbeatInterval` | `number` |

<!-- source: interface-websocketmessage.md -->

# WebSocketMessage

**Kind:** Interface

**Source:** `atloria-monorepo/packages/api-client/src/clients/WebSocketClient.ts` (line 14)

WebSocket message types

## Properties

| Property | Type |
|---|---|
| `type` | `string` |
| `channel` | `string` |
| `data` | `unknown` |

<!-- source: interface-workercaptureprogress.md -->

# WorkerCaptureProgress

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/worker-capturer.service.ts` (line 29)

Progress callback for capture operations

## Properties

| Property | Type |
|---|---|
| `completed` | `number` |
| `total` | `number` |
| `currentItem` | `string` |
| `jobId` | `string` |
| `status` | `string` |

<!-- source: interface-workercapturerconfig.md -->

# WorkerCapturerConfig

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/stages/stage-12-screenshots/worker-capturer.service.ts` (line 42)

Configuration for the worker capturer service

## Properties

| Property | Type |
|---|---|
| `workerUrl` | `string` |
| `siteUrl` | `string` |
| `projectId` | `string` |
| `organizationId` | `string` |
| `capturedBy` | `string` |
| `timeoutMs` | `number` |
| `pollIntervalMs` | `number` |
| `auth` | `AuthConfig` |
| `authHealthCheck` | `SessionHealthCheck` |
| `batchConfig` | `WorkerBatchConfig` |
| `name` | `string` |
| `description` | `string` |
| `repoPath` | `string` |
| `routeMappings` | `RouteMappingResult` |
| `aiAssisted` | `AIAssistedConfig` |

<!-- source: interface-workflowdocumentation-3.md -->

# WorkflowDocumentation

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/cross-language.types.ts` (line 176)

WorkflowDocumentation - Full workflow documentation for users

Generated from combining frontend screens with backend business logic.

## Properties

| Property | Type |
|---|---|
| `id` | `string` |
| `name` | `string` |
| `category` | `string` |
| `description` | `string` |
| `prerequisites` | `{
    roles: string[]; // ["Sales Rep", "Sales Manager"]
    permissions: string[]; // ["sales:orders:create"]
    priorSteps?: string[]; // ["Create a customer first"]
  }` |
| `steps` | `UserJourneyStep[]` |
| `stateMachine` | `{
    initialState: string; // "Draft"
    transitions: Array<{
      from: string; // "Draft"
      to: string; // "Submitted"
      action: string; // "Submit for approval"
      conditions?: string[]; // ["All required fields filled"]
    }>;
  }` |
| `relatedWorkflows` | `string[]` |

<!-- source: interface-workflowsequencespec.md -->

# WorkflowSequenceSpec

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/screenshot-spec.types.ts` (line 66)

Specification for a multi-step workflow screenshot sequence.
Each step is captured independently and presented as a numbered sequence.

## Properties

| Property | Type |
|---|---|
| `steps` | `WorkflowStep[]` |
| `presentation` | `'sequence' | 'composite'` |

<!-- source: interface-workflowstatedefinition.md -->

# WorkflowStateDefinition

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 151)

Workflow states for an entity type

## Properties

| Property | Type |
|---|---|
| `entityType` | `string` |
| `enumName` | `string` |
| `states` | `string[]` |
| `transitions` | `WorkflowTransition[]` |
| `hostComponent` | `string` |
| `sourceFile` | `string` |

<!-- source: interface-workflowstep-2.md -->

# WorkflowStep

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/screenshot-spec.types.ts` (line 76)

A single step in a workflow sequence capture.

## Properties

| Property | Type |
|---|---|
| `order` | `number` |
| `description` | `string` |
| `url` | `string` |
| `requiredState` | `RequiredState` |
| `actions` | `import('./stage-12.types').ScreenshotAction[]` |

<!-- source: interface-workflowtransition-2.md -->

# WorkflowTransition

**Kind:** Interface

**Source:** `atloria-monorepo/packages/doc-automation/src/v2/types/interaction-map.types.ts` (line 133)

A workflow state transition

## Properties

| Property | Type |
|---|---|
| `from` | `string` |
| `to` | `string` |
| `method` | `string` |
| `triggerLabel` | `string` |
| `requiresModal` | `boolean` |
| `modalName` | `string` |