coaia-visualizer 1.0.0

package/.hch/issues.json

@@ -0,0 +1,156 @@
+[
+  {
+    "url": "https://api.github.com/repos/jgwill/coaia-visualizer/issues/2",
+    "repository_url": "https://api.github.com/repos/jgwill/coaia-visualizer",
+    "labels_url": "https://api.github.com/repos/jgwill/coaia-visualizer/issues/2/labels{/name}",
+    "comments_url": "https://api.github.com/repos/jgwill/coaia-visualizer/issues/2/comments",
+    "events_url": "https://api.github.com/repos/jgwill/coaia-visualizer/issues/2/events",
+    "html_url": "https://github.com/jgwill/coaia-visualizer/issues/2",
+    "id": 3801143336,
+    "node_id": "I_kwDOQzbrH87ikNgo",
+    "number": 2,
+    "title": "CLI Web UI Launcher",
+    "user": {
+      "login": "jgwill",
+      "id": 23141173,
+      "node_id": "MDQ6VXNlcjIzMTQxMTcz",
+      "avatar_url": "https://avatars.githubusercontent.com/u/23141173?v=4",
+      "gravatar_id": "",
+      "url": "https://api.github.com/users/jgwill",
+      "html_url": "https://github.com/jgwill",
+      "followers_url": "https://api.github.com/users/jgwill/followers",
+      "following_url": "https://api.github.com/users/jgwill/following{/other_user}",
+      "gists_url": "https://api.github.com/users/jgwill/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/jgwill/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/jgwill/subscriptions",
+      "organizations_url": "https://api.github.com/users/jgwill/orgs",
+      "repos_url": "https://api.github.com/users/jgwill/repos",
+      "events_url": "https://api.github.com/users/jgwill/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/jgwill/received_events",
+      "type": "User",
+      "user_view_type": "public",
+      "site_admin": false
+    },
+    "labels": [
+
+    ],
+    "state": "open",
+    "locked": false,
+    "assignee": null,
+    "assignees": [
+
+    ],
+    "milestone": null,
+    "comments": 0,
+    "created_at": "2026-01-11T11:38:37Z",
+    "updated_at": "2026-01-11T11:38:37Z",
+    "closed_at": null,
+    "author_association": "OWNER",
+    "active_lock_reason": null,
+    "sub_issues_summary": {
+      "total": 0,
+      "completed": 0,
+      "percent_completed": 0
+    },
+    "issue_dependencies_summary": {
+      "blocked_by": 0,
+      "total_blocked_by": 0,
+      "blocking": 0,
+      "total_blocking": 0
+    },
+    "body": "....",
+    "closed_by": null,
+    "reactions": {
+      "url": "https://api.github.com/repos/jgwill/coaia-visualizer/issues/2/reactions",
+      "total_count": 0,
+      "+1": 0,
+      "-1": 0,
+      "laugh": 0,
+      "hooray": 0,
+      "confused": 0,
+      "heart": 0,
+      "rocket": 0,
+      "eyes": 0
+    },
+    "timeline_url": "https://api.github.com/repos/jgwill/coaia-visualizer/issues/2/timeline",
+    "performed_via_github_app": null,
+    "state_reason": null
+  },
+  {
+    "url": "https://api.github.com/repos/jgwill/coaia-visualizer/issues/1",
+    "repository_url": "https://api.github.com/repos/jgwill/coaia-visualizer",
+    "labels_url": "https://api.github.com/repos/jgwill/coaia-visualizer/issues/1/labels{/name}",
+    "comments_url": "https://api.github.com/repos/jgwill/coaia-visualizer/issues/1/comments",
+    "events_url": "https://api.github.com/repos/jgwill/coaia-visualizer/issues/1/events",
+    "html_url": "https://github.com/jgwill/coaia-visualizer/issues/1",
+    "id": 3801141885,
+    "node_id": "I_kwDOQzbrH87ikNJ9",
+    "number": 1,
+    "title": "Init",
+    "user": {
+      "login": "jgwill",
+      "id": 23141173,
+      "node_id": "MDQ6VXNlcjIzMTQxMTcz",
+      "avatar_url": "https://avatars.githubusercontent.com/u/23141173?v=4",
+      "gravatar_id": "",
+      "url": "https://api.github.com/users/jgwill",
+      "html_url": "https://github.com/jgwill",
+      "followers_url": "https://api.github.com/users/jgwill/followers",
+      "following_url": "https://api.github.com/users/jgwill/following{/other_user}",
+      "gists_url": "https://api.github.com/users/jgwill/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/jgwill/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/jgwill/subscriptions",
+      "organizations_url": "https://api.github.com/users/jgwill/orgs",
+      "repos_url": "https://api.github.com/users/jgwill/repos",
+      "events_url": "https://api.github.com/users/jgwill/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/jgwill/received_events",
+      "type": "User",
+      "user_view_type": "public",
+      "site_admin": false
+    },
+    "labels": [
+
+    ],
+    "state": "open",
+    "locked": false,
+    "assignee": null,
+    "assignees": [
+
+    ],
+    "milestone": null,
+    "comments": 0,
+    "created_at": "2026-01-11T11:37:31Z",
+    "updated_at": "2026-01-11T11:37:31Z",
+    "closed_at": null,
+    "author_association": "OWNER",
+    "active_lock_reason": null,
+    "sub_issues_summary": {
+      "total": 0,
+      "completed": 0,
+      "percent_completed": 0
+    },
+    "issue_dependencies_summary": {
+      "blocked_by": 0,
+      "total_blocked_by": 0,
+      "blocking": 0,
+      "total_blocking": 0
+    },
+    "body": "...",
+    "closed_by": null,
+    "reactions": {
+      "url": "https://api.github.com/repos/jgwill/coaia-visualizer/issues/1/reactions",
+      "total_count": 0,
+      "+1": 0,
+      "-1": 0,
+      "laugh": 0,
+      "hooray": 0,
+      "confused": 0,
+      "heart": 0,
+      "rocket": 0,
+      "eyes": 0
+    },
+    "timeline_url": "https://api.github.com/repos/jgwill/coaia-visualizer/issues/1/timeline",
+    "performed_via_github_app": null,
+    "state_reason": null
+  }
+]

package/.hch/issues.md

@@ -0,0 +1,2 @@
+[2::CLI Web UI Launcher](https://github.com/jgwill/coaia-visualizer/issues/2)
+[1::Init](https://github.com/jgwill/coaia-visualizer/issues/1)

package/README.md

@@ -0,0 +1,67 @@
+# `coaia-visualizer`
+
+## Overview
+
+`coaia-visualizer` is the dedicated client-side application for visualizing and interacting with data generated by the `coaia-narrative` system. It transforms raw JSONL (JSON Lines) data, representing Structural Tension Charts and Multi-Universe Narrative Beats, into an intuitive and interactive user interface.
+
+This tool allows users to upload their `coaia-narrative` memory files and gain clear insights into their creative projects, understanding the dynamic interplay of their Desired Outcomes, Current Realities, and Action Steps, alongside the rich context of Narrative Beats.
+
+This project's development and deployment are automatically synchronized with `v0.app`, ensuring continuous access to the latest visual interpretations of your creative journey.
+
+## Key Features
+
+*   **Local JSONL File Upload & Export:** Securely upload `coaia-narrative` JSONL files from your local system for visualization and export the processed data back.
+*   **Hierarchical Chart Visualization:** Explore your Structural Tension Charts in both a comprehensive list view and an expandable, nested hierarchy, revealing master charts and their telescoped sub-charts.
+*   **Detailed Chart Inspector:** Select any chart to access a detailed view, showcasing its Desired Outcome, Current Reality, metadata (creation/due dates, level), and associated components.
+*   **Dynamic Structural Tension Display:** Clearly distinguishes and presents the core Desired Outcome and Current Reality observations, making the generative force of structural tension visible.
+*   **Action Step Tracking:** View all Action Steps for a selected chart, complete with their descriptions, completion status, and due dates, facilitating a clear understanding of strategic advancement.
+*   **Narrative Beat Integration:** Displays associated Narrative Beats, offering multi-universe perspectives (Engineer-World, Ceremony-World, Story-Engine-World) to enrich the context of your creative efforts.
+*   **Inter-Chart Relation Graph:** Visualizes the relationships between charts and entities, illustrating how different creative projects and their components are interconnected.
+*   **Data Statistics Overview:** Provides summary statistics of the loaded data, including total charts, entities, and relations, for quick comprehension of your creative landscape.
+
+## Technologies Used
+
+*   **Framework:** Next.js
+*   **Language:** TypeScript
+*   **UI Library:** React
+*   **Styling:** Tailwind CSS with Radix UI components (for accessible and customizable UI)
+*   **Charting:** `recharts` (for potential future data visualizations)
+*   **Form Management:** `react-hook-form`
+*   **Schema Validation:** `zod`
+
+## Getting Started
+
+1.  **Clone the repository:**
+    ```bash
+    git clone <repository-url>
+    cd coaia-visualizer
+    ```
+2.  **Install dependencies:**
+    ```bash
+    pnpm install
+    ```
+3.  **Run the development server:**
+    ```bash
+    pnpm run dev
+    ```
+4.  Open your browser to `http://localhost:3000` (or the port indicated by `pnpm run dev`).
+5.  Upload a `coaia-narrative` generated JSONL file to begin visualizing your creative projects.
+
+## Deployment
+
+Your project is live at:
+
+**[https://vercel.com/jgwills-projects/v0-jsonl-visualizer](https://vercel.com/jgwills-projects/v0-jsonl-visualizer)**
+
+## Build your app
+
+Continue building your app on:
+
+**[https://v0.app/chat/drYe7XUyCIv](https://v0.app/chat/drYe7XUyCIv)**
+
+## How It Works (v0.app Integration)
+
+1.  Create and modify your project using [v0.app](https://v0.app).
+2.  Deploy your chats from the v0 interface.
+3.  Changes are automatically pushed to this repository.
+4.  Vercel deploys the latest version from this repository.

package/app/api/jsonl/route.ts

@@ -0,0 +1,71 @@
+// app/api/jsonl/route.ts
+import { NextRequest, NextResponse } from 'next/server';
+import { promises as fs } from 'fs';
+import path from 'path';
+
+export async function GET(request: NextRequest) {
+  const memoryPath = process.env.COAIAV_MEMORY_PATH;
+
+  if (!memoryPath) {
+    return NextResponse.json(
+      { error: 'No memory file configured. Launch with --memory-path flag.' },
+      { status: 400 }
+    );
+  }
+
+  try {
+    const content = await fs.readFile(memoryPath, 'utf-8');
+    const filename = path.basename(memoryPath);
+    
+    return NextResponse.json({
+      content,
+      filename,
+      path: memoryPath
+    });
+  } catch (error: any) {
+    return NextResponse.json(
+      { error: `Failed to read memory file: ${error.message}` },
+      { status: 500 }
+    );
+  }
+}
+
+export async function POST(request: NextRequest) {
+  const memoryPath = process.env.COAIAV_MEMORY_PATH;
+
+  if (!memoryPath) {
+    return NextResponse.json(
+      { error: 'No memory file configured' },
+      { status: 400 }
+    );
+  }
+
+  try {
+    const { content } = await request.json();
+    
+    if (!content) {
+      return NextResponse.json(
+        { error: 'No content provided' },
+        { status: 400 }
+      );
+    }
+
+    // Backup original file
+    const backupPath = `${memoryPath}.backup-${Date.now()}`;
+    await fs.copyFile(memoryPath, backupPath);
+
+    // Write new content
+    await fs.writeFile(memoryPath, content, 'utf-8');
+
+    return NextResponse.json({
+      success: true,
+      backup: backupPath,
+      message: 'Memory file updated successfully'
+    });
+  } catch (error: any) {
+    return NextResponse.json(
+      { error: `Failed to write memory file: ${error.message}` },
+      { status: 500 }
+    );
+  }
+}

package/app/globals.css

@@ -0,0 +1,125 @@
+@import 'tailwindcss';
+@import 'tw-animate-css';
+
+@custom-variant dark (&:is(.dark *));
+
+:root {
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --destructive-foreground: oklch(0.577 0.245 27.325);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+  --chart-1: oklch(0.646 0.222 41.116);
+  --chart-2: oklch(0.6 0.118 184.704);
+  --chart-3: oklch(0.398 0.07 227.392);
+  --chart-4: oklch(0.828 0.189 84.429);
+  --chart-5: oklch(0.769 0.188 70.08);
+  --radius: 0.625rem;
+  --sidebar: oklch(0.985 0 0);
+  --sidebar-foreground: oklch(0.145 0 0);
+  --sidebar-primary: oklch(0.205 0 0);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.97 0 0);
+  --sidebar-accent-foreground: oklch(0.205 0 0);
+  --sidebar-border: oklch(0.922 0 0);
+  --sidebar-ring: oklch(0.708 0 0);
+}
+
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.145 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.145 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.985 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.396 0.141 25.723);
+  --destructive-foreground: oklch(0.637 0.237 25.331);
+  --border: oklch(0.269 0 0);
+  --input: oklch(0.269 0 0);
+  --ring: oklch(0.439 0 0);
+  --chart-1: oklch(0.488 0.243 264.376);
+  --chart-2: oklch(0.696 0.17 162.48);
+  --chart-3: oklch(0.769 0.188 70.08);
+  --chart-4: oklch(0.627 0.265 303.9);
+  --chart-5: oklch(0.645 0.246 16.439);
+  --sidebar: oklch(0.205 0 0);
+  --sidebar-foreground: oklch(0.985 0 0);
+  --sidebar-primary: oklch(0.488 0.243 264.376);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.269 0 0);
+  --sidebar-accent-foreground: oklch(0.985 0 0);
+  --sidebar-border: oklch(0.269 0 0);
+  --sidebar-ring: oklch(0.439 0 0);
+}
+
+@theme inline {
+  --font-sans: 'Geist', 'Geist Fallback';
+  --font-mono: 'Geist Mono', 'Geist Mono Fallback';
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --color-chart-1: var(--chart-1);
+  --color-chart-2: var(--chart-2);
+  --color-chart-3: var(--chart-3);
+  --color-chart-4: var(--chart-4);
+  --color-chart-5: var(--chart-5);
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
+}
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}

package/app/layout.tsx

@@ -0,0 +1,48 @@
+import type React from "react"
+import type { Metadata } from "next"
+import { Geist, Geist_Mono } from "next/font/google"
+import { Analytics } from "@vercel/analytics/next"
+import { Toaster } from "sonner"
+import "./globals.css"
+
+const _geist = Geist({ subsets: ["latin"] })
+const _geistMono = Geist_Mono({ subsets: ["latin"] })
+
+export const metadata: Metadata = {
+  title: "COAIA Narrative Visualizer",
+  description: "Visualize and explore structural tension charts from coaia-narrative JSONL files",
+  generator: "v0.app",
+  icons: {
+    icon: [
+      {
+        url: "/icon-light-32x32.png",
+        media: "(prefers-color-scheme: light)",
+      },
+      {
+        url: "/icon-dark-32x32.png",
+        media: "(prefers-color-scheme: dark)",
+      },
+      {
+        url: "/icon.svg",
+        type: "image/svg+xml",
+      },
+    ],
+    apple: "/apple-icon.png",
+  },
+}
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode
+}>) {
+  return (
+    <html lang="en">
+      <body className={`font-sans antialiased`}>
+        {children}
+        <Toaster />
+        <Analytics />
+      </body>
+    </html>
+  )
+}