# t091926/gstack architecture

> Architecture diagram of the GitHub repository t091926/gstack, 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/t091926/gstack
- Repository: https://github.com/t091926/gstack

## Overview

gstack is a toolkit for AI-assisted product development: specialist workflows and utilities support planning, implementation, browser-based QA, review, security checks, and release work. The principal user workflow is documented as planning a feature, implementing it, testing it, and shipping it; the README also highlights standalone browser, PDF, design, memory, and security capabilities. The tree and excerpts expose several supporting runtimes, but not the skill Markdown or enough wiring to map the full workflow. Edges below are limited to documented or indexed references.

Main entry points: [`browse/src/server.ts`](https://github.com/t091926/gstack/blob/main/browse/src/server.ts) (Browse daemon), [`browse/src/browser-manager.ts`](https://github.com/t091926/gstack/blob/main/browse/src/browser-manager.ts) (Browser manager), [`make-pdf/src/orchestrator.ts`](https://github.com/t091926/gstack/blob/main/make-pdf/src/orchestrator.ts) (PDF orchestration), [`autoplan/bin/phase-publication-hook.ts`](https://github.com/t091926/gstack/blob/main/autoplan/bin/phase-publication-hook.ts) (Autoplan publication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Workflow support"]
  node_autoplan["Autoplan publication"]
  node_snapshot["Plan snapshots"]
  node_hosts["Agent host registry<br/>[index.ts]"]
end

subgraph group_browser["Browser and QA"]
  node_browse_server["Browse daemon<br/>[server.ts]"]
  node_browser_manager["Browser manager<br/>[browser-manager.ts]"]
  node_cookie_routes["Cookie picker"]
  node_browser_client["Browse client<br/>[browse-client.ts]"]
  node_ios_qa["iOS QA daemon<br/>[index.ts]"]
end

subgraph group_creation["Design and documents"]
  node_pdf_orchestrator["PDF orchestration<br/>[orchestrator.ts]"]
  node_pdf_client["PDF render client<br/>[asideClient.ts]"]
  node_aside_render["Browser rendering<br/>[aside-render.ts]"]
  node_design["Design workflows<br/>[commands.ts]"]
end

subgraph group_security["Security assessment"]
  node_cso_cli["Security assessment<br/>[cli.ts]"]
  node_cso_state[("Assessment state<br/>[state.ts]")]
  node_egress[("Egress receipts<br/>[egress-receipt.ts]")]
end

subgraph group_context["Memory and intelligence"]
  node_memory_ingest["Memory ingestion"]
  node_memory_helpers["Memory helpers"]
  node_gbrain_sync["Knowledge sync"]
  node_code_intel["Code intelligence<br/>[index.ts]"]
  node_repo_policy["Repository policy"]
end

node_user(("Builder"))

node_user -.->|"plans with"| node_autoplan
node_autoplan -->|"publishes via"| node_snapshot
node_browse_server -->|"uses"| node_browser_manager
node_browse_server -->|"routes to"| node_cookie_routes
node_browser_manager -->|"called by"| node_browse_server
node_cookie_routes -->|"uses"| node_browser_manager
node_pdf_orchestrator -->|"renders PDF"| node_pdf_client
node_pdf_orchestrator -->|"renders content"| node_aside_render
node_pdf_client -->|"calls render"| node_aside_render
node_cso_cli -->|"saves reports"| node_cso_state
node_browse_server -->|"writes receipts"| node_egress
node_memory_ingest -->|"uses"| node_memory_helpers
node_memory_helpers -.->|"supports"| node_gbrain_sync
node_code_intel -.->|"policy integration"| node_repo_policy

click node_autoplan "https://github.com/t091926/gstack/blob/main/autoplan/bin/phase-publication-hook.ts"
click node_snapshot "https://github.com/t091926/gstack/blob/main/bin/gstack-autoplan-snapshot.ts"
click node_hosts "https://github.com/t091926/gstack/blob/main/hosts/index.ts"
click node_browse_server "https://github.com/t091926/gstack/blob/main/browse/src/server.ts"
click node_browser_manager "https://github.com/t091926/gstack/blob/main/browse/src/browser-manager.ts"
click node_cookie_routes "https://github.com/t091926/gstack/blob/main/browse/src/cookie-picker-routes.ts"
click node_browser_client "https://github.com/t091926/gstack/blob/main/browse/src/browse-client.ts"
click node_pdf_orchestrator "https://github.com/t091926/gstack/blob/main/make-pdf/src/orchestrator.ts"
click node_pdf_client "https://github.com/t091926/gstack/blob/main/make-pdf/src/asideClient.ts"
click node_aside_render "https://github.com/t091926/gstack/blob/main/lib/aside-render.ts"
click node_design "https://github.com/t091926/gstack/blob/main/design/src/commands.ts"
click node_cso_cli "https://github.com/t091926/gstack/blob/main/lib/cso/cli.ts"
click node_cso_state "https://github.com/t091926/gstack/blob/main/lib/cso/state.ts"
click node_egress "https://github.com/t091926/gstack/blob/main/lib/egress-receipt.ts"
click node_memory_ingest "https://github.com/t091926/gstack/blob/main/bin/gstack-memory-ingest.ts"
click node_memory_helpers "https://github.com/t091926/gstack/blob/main/lib/gstack-memory-helpers.ts"
click node_gbrain_sync "https://github.com/t091926/gstack/blob/main/bin/gstack-gbrain-sync.ts"
click node_code_intel "https://github.com/t091926/gstack/blob/main/lib/code-intelligence/index.ts"
click node_repo_policy "https://github.com/t091926/gstack/blob/main/lib/gbrain-repo-policy-client.ts"
click node_ios_qa "https://github.com/t091926/gstack/blob/main/ios-qa/daemon/src/index.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_autoplan,node_snapshot,node_hosts toneBlue
class node_browse_server,node_browser_manager,node_cookie_routes,node_browser_client,node_ios_qa toneAmber
class node_pdf_orchestrator,node_pdf_client,node_aside_render,node_design toneMint
class node_cso_cli,node_cso_state,node_egress toneRose
class node_memory_ingest,node_memory_helpers,node_gbrain_sync,node_code_intel,node_repo_policy,node_user toneIndigo
```

## Components

### Workflow support

- [Autoplan publication](https://github.com/t091926/gstack/blob/main/autoplan/bin/phase-publication-hook.ts): `autoplan/bin/phase-publication-hook.ts`
- [Plan snapshots](https://github.com/t091926/gstack/blob/main/bin/gstack-autoplan-snapshot.ts): `bin/gstack-autoplan-snapshot.ts`
- [Agent host registry](https://github.com/t091926/gstack/blob/main/hosts/index.ts): `hosts/index.ts`

### Browser and QA

- [Browse daemon](https://github.com/t091926/gstack/blob/main/browse/src/server.ts): `browse/src/server.ts`
- [Browser manager](https://github.com/t091926/gstack/blob/main/browse/src/browser-manager.ts): `browse/src/browser-manager.ts`
- [Cookie picker](https://github.com/t091926/gstack/blob/main/browse/src/cookie-picker-routes.ts): `browse/src/cookie-picker-routes.ts`
- [Browse client](https://github.com/t091926/gstack/blob/main/browse/src/browse-client.ts): `browse/src/browse-client.ts`
- [iOS QA daemon](https://github.com/t091926/gstack/blob/main/ios-qa/daemon/src/index.ts): `ios-qa/daemon/src/index.ts`

### Design and documents

- [PDF orchestration](https://github.com/t091926/gstack/blob/main/make-pdf/src/orchestrator.ts): `make-pdf/src/orchestrator.ts`
- [PDF render client](https://github.com/t091926/gstack/blob/main/make-pdf/src/asideClient.ts): `make-pdf/src/asideClient.ts`
- [Browser rendering](https://github.com/t091926/gstack/blob/main/lib/aside-render.ts): `lib/aside-render.ts`
- [Design workflows](https://github.com/t091926/gstack/blob/main/design/src/commands.ts): `design/src/commands.ts`

### Security assessment

- [Security assessment](https://github.com/t091926/gstack/blob/main/lib/cso/cli.ts): `lib/cso/cli.ts`
- [Assessment state](https://github.com/t091926/gstack/blob/main/lib/cso/state.ts): `lib/cso/state.ts`
- [Egress receipts](https://github.com/t091926/gstack/blob/main/lib/egress-receipt.ts): `lib/egress-receipt.ts`

### Memory and intelligence

- [Memory ingestion](https://github.com/t091926/gstack/blob/main/bin/gstack-memory-ingest.ts): `bin/gstack-memory-ingest.ts`
- [Memory helpers](https://github.com/t091926/gstack/blob/main/lib/gstack-memory-helpers.ts): `lib/gstack-memory-helpers.ts`
- [Knowledge sync](https://github.com/t091926/gstack/blob/main/bin/gstack-gbrain-sync.ts): `bin/gstack-gbrain-sync.ts`
- [Code intelligence](https://github.com/t091926/gstack/blob/main/lib/code-intelligence/index.ts): `lib/code-intelligence/index.ts`
- [Repository policy](https://github.com/t091926/gstack/blob/main/lib/gbrain-repo-policy-client.ts): `lib/gbrain-repo-policy-client.ts`

### Other components

- **Builder**

## Connections

- Builder → Autoplan publication: plans with (evidence: `README.md`)
- Autoplan publication → Plan snapshots: publishes via (evidence: `autoplan/bin/phase-publication-hook.ts`)
- Browse daemon → Browser manager: uses (evidence: `browse/src/server.ts`)
- Browse daemon → Cookie picker: routes to (evidence: `browse/src/server.ts`)
- Browser manager → Browse daemon: called by (evidence: `browse/src/browser-manager.ts`)
- Cookie picker → Browser manager: uses (evidence: `browse/src/cookie-picker-routes.ts`)
- PDF orchestration → PDF render client: renders PDF (evidence: `make-pdf/src/orchestrator.ts`)
- PDF orchestration → Browser rendering: renders content (evidence: `make-pdf/src/orchestrator.ts`)
- PDF render client → Browser rendering: calls render (evidence: `make-pdf/src/asideClient.ts`)
- Security assessment → Assessment state: saves reports (evidence: `lib/cso/cli.ts`)
- Browse daemon → Egress receipts: writes receipts (evidence: `browse/src/server.ts`)
- Memory ingestion → Memory helpers: uses (evidence: `bin/gstack-memory-ingest.ts`)
- Memory helpers → Knowledge sync: supports
- Code intelligence → Repository policy: policy integration