# huuduyle07-ops/idk-what-is-this-- architecture

> Architecture diagram of the GitHub repository huuduyle07-ops/idk-what-is-this--, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/huuduyle07-ops/idk-what-is-this--
- Repository: https://github.com/huuduyle07-ops/idk-what-is-this--

## Overview

C.A.T.T.U.S is an AI coding mentor and repair system, exposed through a terminal and a Flask workspace. The main workflow takes a user request through task routing, repository context and code understanding, model-assisted analysis, patch authoring, safety and human-authorization checks, then application and validation; run lifecycle and telemetry track outcomes. Separate capabilities include goal-brief intake, learning and retained lessons, dream runs, benchmarks, and program graphs. The README documents these workspace features; unsampled implementation details are represented only where their paths are supported, and edges avoid inferring calls from directory structure.

Main entry points: [`core/pipeline.py`](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/pipeline.py) (Agent Pipeline), [`core/executor.py`](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/executor.py) (Patch Execution), [`main.py`](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/main.py) (Application Entry), [`web/app.py`](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/web/app.py) (Web Workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["User Interfaces"]
  node_main["Application Entry<br/>[main.py]"]
  node_cli["Interactive CLI<br/>[interactive.py]"]
  node_web["Web Workspace<br/>[app.py]"]
end

subgraph group_analysis["Request Analysis"]
  node_routing["Task Routing"]
  node_pipeline["Agent Pipeline<br/>[pipeline.py]"]
  node_retriever["Context Retrieval<br/>[retriever.py]"]
  node_inventory["Repository Inventory"]
  node_control["Code Analysis<br/>[control_engine.py]"]
  node_graphbuild["Program Graph<br/>[builder.py]"]
  node_graphquery["Graph Queries<br/>[query.py]"]
  node_reasoning["Risk Reasoning"]
  node_provider["Model Providers<br/>[gemini_client.py]"]
end

subgraph group_repair["Safe Repair"]
  node_author["Patch Authoring<br/>[patch_engine.py]"]
  node_safety["Patch Safety<br/>[patch_safety.py]"]
  node_authorization["Apply Authorization"]
  node_executor["Patch Execution<br/>[executor.py]"]
  node_validation["Validation"]
  node_lifecycle["Run Lifecycle<br/>[run_lifecycle.py]"]
  node_telemetry["Outcome Telemetry"]
end

subgraph group_learning["Learning and Memory"]
  node_memory[("Agent Memory<br/>[memory.py]")]
  node_learning["Learning Workspace<br/>[chat_retrieval.py]"]
end

subgraph group_workspace["Workspace Capabilities"]
  node_goal["Goal Brief Intake<br/>[goal_brief.py]"]
  node_dream["Dream Runs<br/>[dream_trials.py]"]
  node_benchmark["Benchmarks<br/>[benchmarks_view.py]"]
  node_semantic["Graph Export"]
end

node_user(("User"))

node_user -->|"starts"| node_main
node_main -->|"imports"| node_cli
node_main -->|"runs"| node_pipeline
node_main -->|"offers workspace"| node_web
node_user -->|"uses"| node_web
node_pipeline -->|"routes tasks"| node_routing
node_pipeline -->|"retrieves context"| node_retriever
node_pipeline -->|"analyzes project"| node_control
node_retriever -->|"uses inventory"| node_inventory
node_control -->|"uses graph"| node_graphbuild
node_control -->|"queries graph"| node_graphquery
node_reasoning -->|"queries symbols"| node_graphquery
node_pipeline -->|"requests models"| node_provider
node_pipeline -.->|"authors patch"| node_author
node_pipeline -->|"checks safety"| node_safety
node_web -->|"requests approval"| node_authorization
node_web -->|"applies patches"| node_executor
node_executor -->|"uses patch engine"| node_author
node_executor -->|"checks safety"| node_safety
node_executor -->|"runs validation"| node_validation
node_executor -->|"records run"| node_lifecycle
node_lifecycle -->|"tracks outcome"| node_telemetry
node_pipeline -.->|"uses memory"| node_memory
node_user -->|"structures request"| node_goal
node_user -->|"learns with"| node_learning
node_user -->|"queues work"| node_dream
node_user -->|"views results"| node_benchmark
node_semantic -->|"builds graph"| node_graphbuild

click node_main "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/main.py"
click node_cli "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/cli/interactive.py"
click node_web "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/web/app.py"
click node_routing "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/live_task_routing.py"
click node_pipeline "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/pipeline.py"
click node_retriever "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/retriever.py"
click node_inventory "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/repository_inventory.py"
click node_control "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/control_engine.py"
click node_graphbuild "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/graph/builder.py"
click node_graphquery "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/graph/query.py"
click node_reasoning "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/reasoning/reasoning_engine.py"
click node_provider "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/agents/gemini_client.py"
click node_author "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/patching/patch_engine.py"
click node_safety "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/patch_safety.py"
click node_authorization "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/human_apply_authorization.py"
click node_executor "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/executor.py"
click node_validation "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/validation_execution.py"
click node_lifecycle "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/run_lifecycle.py"
click node_telemetry "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/execution_outcome_telemetry.py"
click node_memory "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/database/memory.py"
click node_learning "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/learning/chat_retrieval.py"
click node_goal "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/goal_brief.py"
click node_dream "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/dream_trials.py"
click node_benchmark "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/benchmarks_view.py"
click node_semantic "https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/semantic_graph_pipeline.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_cli,node_web,node_user toneBlue
class node_routing,node_pipeline,node_retriever,node_inventory,node_control,node_graphbuild,node_graphquery,node_reasoning,node_provider toneAmber
class node_author,node_safety,node_authorization,node_executor,node_validation,node_lifecycle,node_telemetry toneMint
class node_memory,node_learning toneRose
class node_goal,node_dream,node_benchmark,node_semantic toneIndigo
```

## Components

### User Interfaces

- [Application Entry](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/main.py): `main.py`
- [Interactive CLI](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/cli/interactive.py): `cli/interactive.py`
- [Web Workspace](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/web/app.py): `web/app.py`

### Request Analysis

- [Task Routing](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/live_task_routing.py): `core/live_task_routing.py`
- [Agent Pipeline](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/pipeline.py): `core/pipeline.py`
- [Context Retrieval](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/retriever.py): `core/retriever.py`
- [Repository Inventory](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/repository_inventory.py): `core/repository_inventory.py`
- [Code Analysis](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/control_engine.py): `core/control_engine.py`
- [Program Graph](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/graph/builder.py): `graph/builder.py`
- [Graph Queries](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/graph/query.py): `graph/query.py`
- [Risk Reasoning](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/reasoning/reasoning_engine.py): `reasoning/reasoning_engine.py`
- [Model Providers](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/agents/gemini_client.py): `agents/gemini_client.py`

### Safe Repair

- [Patch Authoring](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/patching/patch_engine.py): `patching/patch_engine.py`
- [Patch Safety](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/patch_safety.py): `core/patch_safety.py`
- [Apply Authorization](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/human_apply_authorization.py): `core/human_apply_authorization.py`
- [Patch Execution](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/executor.py): `core/executor.py`
- [Validation](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/validation_execution.py): `core/validation_execution.py`
- [Run Lifecycle](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/run_lifecycle.py): `core/run_lifecycle.py`
- [Outcome Telemetry](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/execution_outcome_telemetry.py): `core/execution_outcome_telemetry.py`

### Learning and Memory

- [Agent Memory](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/database/memory.py): `database/memory.py`
- [Learning Workspace](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/learning/chat_retrieval.py): `core/learning/chat_retrieval.py`

### Workspace Capabilities

- [Goal Brief Intake](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/goal_brief.py): `core/goal_brief.py`
- [Dream Runs](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/dream_trials.py): `core/dream_trials.py`
- [Benchmarks](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/benchmarks_view.py): `core/benchmarks_view.py`
- [Graph Export](https://github.com/huuduyle07-ops/idk-what-is-this--/blob/main/core/semantic_graph_pipeline.py): `core/semantic_graph_pipeline.py`

### Other components

- **User**

## Connections

- User → Application Entry: starts
- Application Entry → Interactive CLI: imports (evidence: `main.py`)
- Application Entry → Agent Pipeline: runs (evidence: `main.py`)
- Application Entry → Web Workspace: offers workspace
- User → Web Workspace: uses
- Agent Pipeline → Task Routing: routes tasks (evidence: `core/pipeline.py`)
- Agent Pipeline → Context Retrieval: retrieves context (evidence: `core/pipeline.py`)
- Agent Pipeline → Code Analysis: analyzes project (evidence: `core/pipeline.py`)
- Context Retrieval → Repository Inventory: uses inventory (evidence: `core/retriever.py`)
- Code Analysis → Program Graph: uses graph (evidence: `core/control_engine.py`)
- Code Analysis → Graph Queries: queries graph (evidence: `core/control_engine.py`)
- Risk Reasoning → Graph Queries: queries symbols (evidence: `reasoning/reasoning_engine.py`)
- Agent Pipeline → Model Providers: requests models (evidence: `core/pipeline.py`)
- Agent Pipeline → Patch Authoring: authors patch
- Agent Pipeline → Patch Safety: checks safety (evidence: `core/pipeline.py`)
- Web Workspace → Apply Authorization: requests approval (evidence: `web/app.py`)
- Web Workspace → Patch Execution: applies patches
- Patch Execution → Patch Authoring: uses patch engine (evidence: `core/executor.py`)
- Patch Execution → Patch Safety: checks safety (evidence: `core/executor.py`)
- Patch Execution → Validation: runs validation (evidence: `core/executor.py`)
- Patch Execution → Run Lifecycle: records run (evidence: `core/run_lifecycle.py`)
- Run Lifecycle → Outcome Telemetry: tracks outcome (evidence: `core/execution_outcome_telemetry.py`)
- Agent Pipeline → Agent Memory: uses memory
- User → Goal Brief Intake: structures request
- User → Learning Workspace: learns with
- User → Dream Runs: queues work
- User → Benchmarks: views results
- Graph Export → Program Graph: builds graph (evidence: `core/semantic_graph_pipeline.py`)