# 1nsharma/slash architecture

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

- Interactive diagram: https://gitdiagram.com/1nsharma/slash
- Repository: https://github.com/1nsharma/slash

## Overview

SLASH turns websites, repositories, API specs, database schemas, and documentation into connected architecture intelligence, then supports comparison, business-gap analysis, human-approved copilot recommendations, and app generation/export. The main flow starts in the workspace, analyzes source types through separate APIs, unifies their reports into a graph, and presents it for inspection or launch. Edges are limited to relationships visible in the README or supplied excerpts and SOURCE INDEX references; several documented capabilities have unsampled implementations, so their internal links are omitted.

Main entry points: [`app/page.tsx`](https://github.com/1nsharma/slash/blob/main/app/page.tsx) (Workspace Controller), [`lib/graph/unifier.ts`](https://github.com/1nsharma/slash/blob/main/lib/graph/unifier.ts) (Unified Graph Engine), [`app/api/chat/route.ts`](https://github.com/1nsharma/slash/blob/main/app/api/chat/route.ts) (Copilot Chat API), [`app/api/graph/unify/route.ts`](https://github.com/1nsharma/slash/blob/main/app/api/graph/unify/route.ts) (Graph Unify API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Workspace & Inspection"]
  node_workspace["Workspace Controller<br/>[page.tsx]"]
  node_landing["Smart Source Input"]
  node_inspector["Source Workspaces"]
  node_compareview["Architecture Comparison<br/>[CompareView.tsx]"]
  node_pipelineview["Pipeline &amp; Adapters<br/>[PipelineView.tsx]"]
end

subgraph group_extract["Source Analysis"]
  node_urlapi["URL Analyze API<br/>[route.ts]"]
  node_urlengine["URL Intelligence<br/>[analyzer.ts]"]
  node_repoapi["Repository API<br/>[route.ts]"]
  node_repoengine["Repository Intelligence<br/>[analyzer.ts]"]
  node_connectapi["Connector Ingest API<br/>[route.ts]"]
  node_connectors["Schema &amp; Spec Connectors"]
  node_social["Social URL Adapters<br/>[social.ts]"]
end

subgraph group_graph["Graph &amp; Business OS"]
  node_unifyapi["Graph Unify API<br/>[route.ts]"]
  node_unifier["Unified Graph Engine<br/>[unifier.ts]"]
  node_zones["Business Zones &amp; Gaps<br/>[zones.ts]"]
  node_blocks["Verified Business Blocks<br/>[blocks.ts]"]
  node_layout["Graph Layout &amp; Diff<br/>[graphLayout.ts]"]
  node_compareapi["Compare API<br/>[route.ts]"]
end

subgraph group_launch["Copilot &amp; Launch"]
  node_chatapi["Copilot Chat API<br/>[route.ts]"]
  node_copilot["Proposal Normalizer<br/>[copilot.ts]"]
  node_composerapi["Composer Analyze &amp; Generate<br/>[route.ts]"]
  node_composerengine["Launch Composer<br/>[engine.ts]"]
  node_exportapi["Bundle Export API<br/>[route.ts]"]
  node_zip["ZIP Archive Builder<br/>[zip.ts]"]
  node_blueprint["Blueprint Export<br/>[blueprintExport.ts]"]
  node_ai["AI Provider Router<br/>[router.ts]"]
  node_gemini["Gemini Client<br/>[gemini.ts]"]
end

subgraph group_security["Identity &amp; Safety"]
  node_vault["GitHub Token Vault<br/>[tokenVault.ts]"]
  node_limits["Repository Safety Limits<br/>[limits.ts]"]
  node_guard["URL Safety Guard<br/>[urlGuard.ts]"]
end

node_user(("Engineer"))
node_actor(("GitHub"))

node_user -->|"enters source"| node_landing
node_landing -->|"starts analysis"| node_workspace
node_workspace -.->|"requests URL scan"| node_urlapi
node_workspace -.->|"requests repo scan"| node_repoapi
node_workspace -.->|"submits connector"| node_connectapi
node_workspace -->|"unifies sources"| node_unifyapi
node_workspace -->|"shows workspace"| node_inspector
node_urlapi -->|"analyzes URL"| node_urlengine
node_repoapi -->|"analyzes repository"| node_repoengine
node_repoapi -->|"uses credentials"| node_vault
node_connectapi -->|"dispatches ingestion"| node_connectors
node_unifyapi -->|"analyzes URLs"| node_urlengine
node_unifyapi -->|"analyzes repositories"| node_repoengine
node_unifyapi -->|"builds unified graph"| node_unifier
node_urlengine -.->|"provides reports"| node_unifier
node_repoengine -.->|"provides reports"| node_unifier
node_unifyapi -->|"synthesizes summary"| node_gemini
node_compareview -->|"requests comparison"| node_compareapi
node_compareapi -->|"analyzes URLs"| node_urlengine
node_compareapi -->|"computes diff"| node_layout
node_compareapi -->|"synthesizes findings"| node_gemini
node_unifier -.->|"classifies business zones"| node_zones
node_unifier -.->|"positions graph"| node_layout
node_chatapi -->|"detects missing gaps"| node_zones
node_chatapi -->|"checks verified blocks"| node_blocks
node_chatapi -->|"wraps untrusted context"| node_limits
node_chatapi -->|"normalizes proposals"| node_copilot
node_chatapi -->|"answers questions"| node_gemini
node_composerapi -->|"generates bundle"| node_composerengine
node_composerengine -->|"classifies components"| node_zones
node_composerengine -->|"checks graph conflicts"| node_unifier
node_composerengine -->|"plans composition"| node_gemini
node_exportapi -->|"creates archive"| node_zip
node_exportapi -->|"exports graph views"| node_blueprint
node_ai -->|"routes provider call"| node_gemini
node_actor -.->|"authorizes repository access"| node_vault
node_urlengine -.->|"validates targets"| node_guard
node_repoengine -.->|"applies scan limits"| node_limits

click node_workspace "https://github.com/1nsharma/slash/blob/main/app/page.tsx"
click node_landing "https://github.com/1nsharma/slash/blob/main/components/UrlAnalyzerLanding.tsx"
click node_inspector "https://github.com/1nsharma/slash/blob/main/components/UnifiedGraphWorkspace.tsx"
click node_compareview "https://github.com/1nsharma/slash/blob/main/components/CompareView.tsx"
click node_pipelineview "https://github.com/1nsharma/slash/blob/main/components/PipelineView.tsx"
click node_urlapi "https://github.com/1nsharma/slash/blob/main/app/api/analyze/route.ts"
click node_urlengine "https://github.com/1nsharma/slash/blob/main/lib/analyzer.ts"
click node_repoapi "https://github.com/1nsharma/slash/blob/main/app/api/repo/analyze/route.ts"
click node_repoengine "https://github.com/1nsharma/slash/blob/main/lib/repo/analyzer.ts"
click node_connectapi "https://github.com/1nsharma/slash/blob/main/app/api/connectors/ingest/route.ts"
click node_connectors "https://github.com/1nsharma/slash/tree/main/lib/connectors"
click node_social "https://github.com/1nsharma/slash/blob/main/lib/adapters/social.ts"
click node_unifyapi "https://github.com/1nsharma/slash/blob/main/app/api/graph/unify/route.ts"
click node_unifier "https://github.com/1nsharma/slash/blob/main/lib/graph/unifier.ts"
click node_zones "https://github.com/1nsharma/slash/blob/main/lib/business/zones.ts"
click node_blocks "https://github.com/1nsharma/slash/blob/main/lib/business/blocks.ts"
click node_layout "https://github.com/1nsharma/slash/blob/main/lib/graphLayout.ts"
click node_chatapi "https://github.com/1nsharma/slash/blob/main/app/api/chat/route.ts"
click node_copilot "https://github.com/1nsharma/slash/blob/main/lib/copilot.ts"
click node_composerapi "https://github.com/1nsharma/slash/blob/main/app/api/composer/generate/route.ts"
click node_composerengine "https://github.com/1nsharma/slash/blob/main/lib/composer/engine.ts"
click node_exportapi "https://github.com/1nsharma/slash/blob/main/app/api/composer/export/route.ts"
click node_zip "https://github.com/1nsharma/slash/blob/main/lib/composer/zip.ts"
click node_blueprint "https://github.com/1nsharma/slash/blob/main/lib/graph/blueprintExport.ts"
click node_ai "https://github.com/1nsharma/slash/blob/main/lib/ai/router.ts"
click node_gemini "https://github.com/1nsharma/slash/blob/main/lib/gemini.ts"
click node_compareapi "https://github.com/1nsharma/slash/blob/main/app/api/compare/route.ts"
click node_vault "https://github.com/1nsharma/slash/blob/main/lib/security/tokenVault.ts"
click node_limits "https://github.com/1nsharma/slash/blob/main/lib/repo/limits.ts"
click node_guard "https://github.com/1nsharma/slash/blob/main/lib/security/urlGuard.ts"

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_workspace,node_landing,node_inspector,node_compareview,node_pipelineview toneBlue
class node_urlapi,node_urlengine,node_repoapi,node_repoengine,node_connectapi,node_connectors,node_social toneAmber
class node_unifyapi,node_unifier,node_zones,node_blocks,node_layout,node_compareapi toneMint
class node_chatapi,node_copilot,node_composerapi,node_composerengine,node_exportapi,node_zip,node_blueprint,node_ai,node_gemini toneRose
class node_vault,node_limits,node_guard,node_user,node_actor toneIndigo
```

## Components

### Workspace & Inspection

- [Workspace Controller](https://github.com/1nsharma/slash/blob/main/app/page.tsx): `app/page.tsx`
- [Smart Source Input](https://github.com/1nsharma/slash/blob/main/components/UrlAnalyzerLanding.tsx): `components/UrlAnalyzerLanding.tsx`
- [Source Workspaces](https://github.com/1nsharma/slash/blob/main/components/UnifiedGraphWorkspace.tsx): `components/UnifiedGraphWorkspace.tsx`
- [Architecture Comparison](https://github.com/1nsharma/slash/blob/main/components/CompareView.tsx): `components/CompareView.tsx`
- [Pipeline & Adapters](https://github.com/1nsharma/slash/blob/main/components/PipelineView.tsx): `components/PipelineView.tsx`

### Source Analysis

- [URL Analyze API](https://github.com/1nsharma/slash/blob/main/app/api/analyze/route.ts): `app/api/analyze/route.ts`
- [URL Intelligence](https://github.com/1nsharma/slash/blob/main/lib/analyzer.ts): `lib/analyzer.ts`
- [Repository API](https://github.com/1nsharma/slash/blob/main/app/api/repo/analyze/route.ts): `app/api/repo/analyze/route.ts`
- [Repository Intelligence](https://github.com/1nsharma/slash/blob/main/lib/repo/analyzer.ts): `lib/repo/analyzer.ts`
- [Connector Ingest API](https://github.com/1nsharma/slash/blob/main/app/api/connectors/ingest/route.ts): `app/api/connectors/ingest/route.ts`
- [Schema & Spec Connectors](https://github.com/1nsharma/slash/tree/main/lib/connectors): `lib/connectors`
- [Social URL Adapters](https://github.com/1nsharma/slash/blob/main/lib/adapters/social.ts): `lib/adapters/social.ts`

### Graph & Business OS

- [Graph Unify API](https://github.com/1nsharma/slash/blob/main/app/api/graph/unify/route.ts): `app/api/graph/unify/route.ts`
- [Unified Graph Engine](https://github.com/1nsharma/slash/blob/main/lib/graph/unifier.ts): `lib/graph/unifier.ts`
- [Business Zones & Gaps](https://github.com/1nsharma/slash/blob/main/lib/business/zones.ts): `lib/business/zones.ts`
- [Verified Business Blocks](https://github.com/1nsharma/slash/blob/main/lib/business/blocks.ts): `lib/business/blocks.ts`
- [Graph Layout & Diff](https://github.com/1nsharma/slash/blob/main/lib/graphLayout.ts): `lib/graphLayout.ts`
- [Compare API](https://github.com/1nsharma/slash/blob/main/app/api/compare/route.ts): `app/api/compare/route.ts`

### Copilot & Launch

- [Copilot Chat API](https://github.com/1nsharma/slash/blob/main/app/api/chat/route.ts): `app/api/chat/route.ts`
- [Proposal Normalizer](https://github.com/1nsharma/slash/blob/main/lib/copilot.ts): `lib/copilot.ts`
- [Composer Analyze & Generate](https://github.com/1nsharma/slash/blob/main/app/api/composer/generate/route.ts): `app/api/composer/generate/route.ts`
- [Launch Composer](https://github.com/1nsharma/slash/blob/main/lib/composer/engine.ts): `lib/composer/engine.ts`
- [Bundle Export API](https://github.com/1nsharma/slash/blob/main/app/api/composer/export/route.ts): `app/api/composer/export/route.ts`
- [ZIP Archive Builder](https://github.com/1nsharma/slash/blob/main/lib/composer/zip.ts): `lib/composer/zip.ts`
- [Blueprint Export](https://github.com/1nsharma/slash/blob/main/lib/graph/blueprintExport.ts): `lib/graph/blueprintExport.ts`
- [AI Provider Router](https://github.com/1nsharma/slash/blob/main/lib/ai/router.ts): `lib/ai/router.ts`
- [Gemini Client](https://github.com/1nsharma/slash/blob/main/lib/gemini.ts): `lib/gemini.ts`

### Identity & Safety

- [GitHub Token Vault](https://github.com/1nsharma/slash/blob/main/lib/security/tokenVault.ts): `lib/security/tokenVault.ts`
- [Repository Safety Limits](https://github.com/1nsharma/slash/blob/main/lib/repo/limits.ts): `lib/repo/limits.ts`
- [URL Safety Guard](https://github.com/1nsharma/slash/blob/main/lib/security/urlGuard.ts): `lib/security/urlGuard.ts`

### Other components

- **Engineer**
- **GitHub**

## Connections

- Engineer → Smart Source Input: enters source (evidence: `README.md`)
- Smart Source Input → Workspace Controller: starts analysis (evidence: `README.md`)
- Workspace Controller → URL Analyze API: requests URL scan
- Workspace Controller → Repository API: requests repo scan
- Workspace Controller → Connector Ingest API: submits connector
- Workspace Controller → Graph Unify API: unifies sources (evidence: `app/page.tsx`)
- Workspace Controller → Source Workspaces: shows workspace (evidence: `app/page.tsx`)
- URL Analyze API → URL Intelligence: analyzes URL (evidence: `app/api/analyze/route.ts`)
- Repository API → Repository Intelligence: analyzes repository (evidence: `app/api/repo/analyze/route.ts`)
- Repository API → GitHub Token Vault: uses credentials (evidence: `app/api/repo/analyze/route.ts`)
- Connector Ingest API → Schema & Spec Connectors: dispatches ingestion (evidence: `app/api/connectors/ingest/route.ts`)
- Graph Unify API → URL Intelligence: analyzes URLs (evidence: `app/api/graph/unify/route.ts`)
- Graph Unify API → Repository Intelligence: analyzes repositories (evidence: `app/api/graph/unify/route.ts`)
- Graph Unify API → Unified Graph Engine: builds unified graph (evidence: `app/api/graph/unify/route.ts`)
- URL Intelligence → Unified Graph Engine: provides reports
- Repository Intelligence → Unified Graph Engine: provides reports
- Graph Unify API → Gemini Client: synthesizes summary (evidence: `app/api/graph/unify/route.ts`)
- Architecture Comparison → Compare API: requests comparison (evidence: `components/CompareView.tsx`)
- Compare API → URL Intelligence: analyzes URLs (evidence: `app/api/compare/route.ts`)
- Compare API → Graph Layout & Diff: computes diff (evidence: `app/api/compare/route.ts`)
- Compare API → Gemini Client: synthesizes findings (evidence: `app/api/compare/route.ts`)
- Unified Graph Engine → Business Zones & Gaps: classifies business zones
- Unified Graph Engine → Graph Layout & Diff: positions graph
- Copilot Chat API → Business Zones & Gaps: detects missing gaps (evidence: `app/api/chat/route.ts`)
- Copilot Chat API → Verified Business Blocks: checks verified blocks (evidence: `app/api/chat/route.ts`)
- Copilot Chat API → Repository Safety Limits: wraps untrusted context (evidence: `app/api/chat/route.ts`)
- Copilot Chat API → Proposal Normalizer: normalizes proposals (evidence: `app/api/chat/route.ts`)
- Copilot Chat API → Gemini Client: answers questions (evidence: `app/api/chat/route.ts`)
- Composer Analyze & Generate → Launch Composer: generates bundle (evidence: `app/api/composer/generate/route.ts`)
- Launch Composer → Business Zones & Gaps: classifies components (evidence: `lib/composer/engine.ts`)
- Launch Composer → Unified Graph Engine: checks graph conflicts (evidence: `lib/composer/engine.ts`)
- Launch Composer → Gemini Client: plans composition (evidence: `lib/composer/engine.ts`)
- Bundle Export API → ZIP Archive Builder: creates archive (evidence: `app/api/composer/export/route.ts`)
- Bundle Export API → Blueprint Export: exports graph views (evidence: `app/api/composer/export/route.ts`)
- AI Provider Router → Gemini Client: routes provider call (evidence: `lib/ai/router.ts`)
- GitHub → GitHub Token Vault: authorizes repository access
- URL Intelligence → URL Safety Guard: validates targets
- Repository Intelligence → Repository Safety Limits: applies scan limits