# in03/not-a-haiku architecture

> Architecture diagram of the GitHub repository in03/not-a-haiku, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/in03/not-a-haiku
- Repository: https://github.com/in03/not-a-haiku

## Overview

##### Project type and purpose
- From the file tree and README, this is a full-stack web application built with SvelteKit.
- Purpose: an interactive haiku (and other syllable-constrained poetry) editor that validates syllable count in real time, performs AI-powered analysis/tagging, and syncs data via GitHub Gists.

##### File structure
- Top level: configuration (pnpm, Vite, PostCSS, Tailwind, Vercel), README, environment example.
- src/:
- app.html / app.css – entrypoint template and global styles
- lib/ – client-side code
· auth/ (GitHub OAuth helper)
· components/ (Svelte UI components: editor, dialogs, grid, toasts)
· config/, data/ (CMU dictionary JSON, syllable-counter logic, external API wrappers)
· stores/ (Svelte writable stores: auth state, settings, in-memory “DB”)
· ml/ (ONNX model & metadata for client inference)
- routes/ – SvelteKit pages and serverless endpoints
· +page.svelte / +layout.* – UI pages (editor, settings, test onnx)
· api/auth/github/... – server routes for OAuth token, callback
- static/: serves the ONNX model for browser fetch
- .cursor/: editor rules, which inform UI/UX constraints

##### README for additional insights
- Architecture section highlights syllable-count strategy (CMU lookup → ONNX fallback).
- Performance: small binary model, JSON dictionary, sub-5ms inference.
- Components called out: HaikuEditor, Toast, onnx-syllable-counter.
- Deployment: Vercel serverless.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Browser UI Components
    subgraph "Browser UI"
        direction TB
        UInput["Unified Haiku Input"]:::frontend
        GridView["Haiku Grid View"]:::frontend
        Viewer["Haiku Viewer"]:::frontend
        AnalysisRes["Analysis Results"]:::frontend
        Toast["Toast Notifications"]:::frontend
        ConfirmDlg["Confirmation Dialog"]:::frontend
        OnboardModal["Onboarding Modal"]:::frontend
        SettingsPanel["Settings Panel"]:::frontend
        TagSelect["Tag Multi-Select"]:::frontend
        ModelError["Model Error Modal"]:::frontend
    end

    %% State Management
    subgraph "State Management (Svelte Stores)"
        direction TB
        AuthStore["Authentication State"]:::stores
        HaikuDB["In-Memory Haiku DB"]:::stores
        SettingsStore["User Settings Store"]:::stores
    end

    %% ML Assets & Data
    subgraph "ML Assets & Data"
        direction TB
        CMUJSON["CMU Dictionary JSON"]:::asset
        PureCounter["Pure-JS Syllable Counter"]:::asset
        ONNXCounter["ONNX Fallback Counter"]:::asset
        ONNXModel["ONNX Model"]:::asset
        ModelMeta["ONNX Model Metadata"]:::asset
        StaticModel["Static ONNX Asset"]:::asset
    end

    %% Serverless API
    subgraph "Serverless API (SvelteKit)"
        direction TB
        AuthInit["GitHub OAuth Init"]:::serverless
        AuthCallback["OAuth Callback Handler"]:::serverless
        TokenExchange["Token Exchange Endpoint"]:::serverless
    end

    %% External Services
    subgraph "External Services"
        direction TB
        GitHub["GitHub (OAuth & Gist)"]:::external
        ElevenTTS["ElevenLabs TTS"]:::external
    end

    %% Connections
    UInput -->|"reads/writes"| AuthStore
    UInput -->|"reads/writes"| HaikuDB
    UInput -->|"reads/writes"| SettingsStore
    GridView -->|"reads data"| HaikuDB
    Viewer -->|"reads data"| HaikuDB
    AnalysisRes -->|"reads data"| HaikuDB
    Toast -->|"subscribes to"| SettingsStore
    SettingsPanel -->|"updates"| SettingsStore
    TagSelect -->|"updates tags"| SettingsStore
    ModelError -->|"listens to"| ONNXCounter

    UInput -->|"lookup syllables"| PureCounter
    PureCounter -->|"uses data"| CMUJSON
    UInput -->|"fallback inference"| ONNXCounter
    ONNXCounter -->|"loads model"| ONNXModel
    ONNXCounter -->|"loads metadata"| ModelMeta
    ONNXModel -->|"served from"| StaticModel

    UInput -->|"API calls"| AuthInit
    UInput -->|"API calls"| AuthCallback
    UInput -->|"API calls"| TokenExchange
    AuthInit -->|"redirect"| GitHub
    AuthCallback -->|"exchange code"| GitHub
    TokenExchange -->|"fetch token"| GitHub

    UInput -->|"trigger TTS"| ElevenTTS

    %% Click Events
    click UInput "https://github.com/in03/not-a-haiku/blob/main/src/lib/components/UnifiedHaikuInput.svelte"
    click GridView "https://github.com/in03/not-a-haiku/blob/main/src/lib/components/HaikuGridView.svelte"
    click Viewer "https://github.com/in03/not-a-haiku/blob/main/src/lib/components/HaikuViewer.svelte"
    click AnalysisRes "https://github.com/in03/not-a-haiku/blob/main/src/lib/components/AnalysisResults.svelte"
    click Toast "https://github.com/in03/not-a-haiku/blob/main/src/lib/components/Toast.svelte"
    click ConfirmDlg "https://github.com/in03/not-a-haiku/blob/main/src/lib/components/ConfirmationDialog.svelte"
    click OnboardModal "https://github.com/in03/not-a-haiku/blob/main/src/lib/components/OnboardingModal.svelte"
    click SettingsPanel "https://github.com/in03/not-a-haiku/blob/main/src/lib/components/Settings.svelte"
    click TagSelect "https://github.com/in03/not-a-haiku/blob/main/src/lib/components/TagMultiSelect.svelte"
    click ModelError "https://github.com/in03/not-a-haiku/blob/main/src/lib/components/ModelErrorModal.svelte"
    click AuthInit "https://github.com/in03/not-a-haiku/blob/main/src/routes/api/auth/github/+server.js"
    click AuthCallback "https://github.com/in03/not-a-haiku/blob/main/src/routes/api/auth/github/callback/+server.js"
    click TokenExchange "https://github.com/in03/not-a-haiku/blob/main/src/routes/api/auth/github/token/+server.js"
    click AuthStore "https://github.com/in03/not-a-haiku/blob/main/src/lib/stores/auth.js"
    click HaikuDB "https://github.com/in03/not-a-haiku/blob/main/src/lib/stores/haiku-db.js"
    click SettingsStore "https://github.com/in03/not-a-haiku/blob/main/src/lib/stores/settings.js"
    click CMUJSON "https://github.com/in03/not-a-haiku/blob/main/src/lib/data/cmu-syllables.json"
    click PureCounter "https://github.com/in03/not-a-haiku/blob/main/src/lib/syllable-counter.js"
    click ONNXCounter "https://github.com/in03/not-a-haiku/blob/main/src/lib/onnx-syllable-counter.js"
    click ONNXModel "https://github.com/in03/not-a-haiku/blob/main/src/ml/syllable_model.onnx"
    click ModelMeta "https://github.com/in03/not-a-haiku/blob/main/src/ml/model_metadata.json"
    click StaticModel "https://github.com/in03/not-a-haiku/blob/main/static/syllable_model.onnx"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366d6;
    classDef stores fill:#E3FCEF,stroke:#28a745,stroke-dasharray:5 5;
    classDef asset fill:#E6FFFA,stroke:#00b894,stroke-width:2px;
    classDef serverless fill:#FFF4E6,stroke:#FF8C00;
    classDef external fill:#F3E6FF,stroke:#6f42c1;
```
