prism0x2a 0.7.2 → 0.11.0

package/.next/standalone/CHANGELOG.md

@@ -1,5 +1,110 @@
 # Changelog
 
+## 0.11.0 — Architect Mode UI + Landing Reposition
+
+### Added
+
+- **Landing:** Hero repositioned as "The architecture map your codebase actually has." (LeanIX angle)
+- **Landing:** Blueprint Explorer Showcase section — 5 view-preview cards + CTAs
+- **Landing:** Architect Mode Showcase section — chat mockup + feature list
+- **Landing:** Bot-Family updated to 4 cards (BLUE leads, Blueprint Explorer as 4th)
+- **Landing:** Spectrum 0x55 bundle featured banner in pricing snippet
+- **Landing:** 3 new FAQ entries (Blueprint Explorer, 1M-LOC, Architect Mode)
+- **HeroVisual:** 5 spectrum rays (was 3) — one per Blueprint Explorer view
+- **`/blue/explorer/ask`:** Architect chat UI — textarea, conversation history, suggested questions
+- **`/blue/explorer/explain`:** Module explain page — file picker + synthesised markdown deep-dive
+- **`/blue/explorer/refactor`:** Refactor suggestions — severity-sorted list, kind filter, file links
+- **`/api/blue/explorer/ask`:** POST — calls `askArchitect()` if available, graceful fallback
+- **`/api/blue/explorer/explain`:** POST — calls `explainModule()` if available, blueprint-derived fallback
+- **`/api/blue/explorer/refactor`:** GET — calls `suggestRefactor()` if available, derives from cycles+heat+coverage
+- **ExplorerNav:** Ask ✦ + Refactor tabs added to sub-navigation
+- **Pricing page:** Blueprint Explorer + Architect Mode in Pro features + tier table; CSS vars fixed
+
+### Notes
+
+- prismlens@0.4.0 is not yet published. All Architect routes degrade gracefully — derived/fallback responses until the library ships.
+
+---
+
+## 0.10.0 — Blueprint Explorer FULL (live integration)
+
+### Added
+
+- **`prismlens@0.3.0`** + **`@xyflow/react`** + **`dagre`** installed as dependencies.
+- **`app/api/blue/explorer/route.ts`**: GET now loads via `readBlueprint()`; POST calls `generateBlueprint()` and persists to `.prism/blueprint.json`.
+- **`app/api/blue/explorer/outdated/route.ts`**: GET checks `hasSourceChanged(target, lastScanTime)` — returns `{ outdated: boolean }`.
+- **`lib/prism/blue/explorer/types.ts`**: Re-exports canonical types from `prismlens/blueprint`.
+- **`components/blue-explorer/RescanButton.tsx`**: Standalone rescan button — POSTs, shows spinner, calls `onComplete`.
+- **`components/blue-explorer/ExplorerNav.tsx`**: Shared tab bar + RescanButton + outdated banner.
+- **`components/blue-explorer/BlueprintGraph.tsx`**: Import graph — @xyflow/react + dagre layout, heat-colored nodes.
+- **`components/blue-explorer/ZonesView.tsx`**: Directory zones — files grouped by top-level dir, heat-sorted.
+- **`components/blue-explorer/WireView.tsx`**: Next.js layout hierarchy — nested route blocks.
+- **`components/blue-explorer/FlowView.tsx`**: Page navigation graph — ReactFlow nodes per route.
+- **All 4 stub pages replaced** with functional implementations.
+
+### Changed
+
+- **`app/blue/explorer/page.tsx`**: Uses shared `ExplorerNav` + outdated-detection.
+- **`components/blue-explorer/ExplorerSummary.tsx`**: Fixed for prismlens shape (`hottestFiles`, `avgHeat`).
+
+---
+
+## 0.9.0 — Blueprint Explorer (Pro)
+
+### Added
+
+- **`app/blue/explorer/`**: Full Pro-gated route tree — List, Graph, Zones, Wire, Flow, and `file/[path]` inspector deep-dive.
+- **`ExplorerGate`**: Client-side Pro-tier gate — shows `ProGate` upgrade wall for free users, children for Pro+.
+- **`ProGate`**: Upgrade wall with feature pill list and `/pricing` CTA.
+- **`ExplorerFileCard`**: File list item with heat/coverage/neutral colour modes, progress bar, tag badges, hot-file indicator.
+- **`ExplorerSummary`**: Left-panel KPI overview (file counts, heat, coverage, hot files, most-imported).
+- **`ExplorerFileInspector`**: Right-panel detail view — coverage, metrics, exports, symbols, imports.
+- **`primitives.tsx`**: `Section`, `MiniSpark` (hover sparkline tooltip), `MetricRow`, `SummaryCard`.
+- **`app/api/blue/explorer/route.ts`**: GET loads `blueprint.json` from `.prism/` or `blueprint-tool/output/`; POST stub for `prismlens v0.3.0` `generateBlueprint()`.
+- **`app/api/blue/explorer/comments/[hash]/route.ts`**: Per-file comment store — GET/POST/DELETE, writes to `.prism/comments/<hash>.json`.
+- **`lib/prism/blue/explorer/types.ts`**: `BlueprintData`, `FileEntry`, `FileCoverage`, `ExplorerComment` types.
+- **`lib/prism/blue/explorer/heatHelpers.ts`**: Heat badge/bar colour helpers + inline coverage bucket utils.
+- **`features.shared.ts`**: Added `blueprint_explorer: { tier: "pro" }`.
+- **`PrismDock`**: Explorer link shown for Pro users between BLUE and AMBER.
+- **File inspector deep-dive** (`/blue/explorer/file/[path]`): Full inspector + per-file comment thread.
+
+### Notes
+
+- `generateBlueprint()` POST endpoint returns 501 until `prismlens v0.3.0` ships. Manually place `blueprint.json` in `.prism/` to use all views now.
+- Graph, Zones, Wire, Flow views are "coming soon" stubs — placeholders for Phase 2.
+
+---
+
+## 0.8.1 — SEO: robots.txt + sitemap.xml
+
+### Added
+
+- **`app/robots.ts`**: `/robots.txt` route — allows all crawlers, references sitemap.
+- **`app/sitemap.ts`**: `/sitemap.xml` route — homepage (weekly, priority 1.0) + pricing (monthly, priority 0.8).
+
+---
+
+## 0.8.0 — Marketing Landing + Hero
+
+### Added
+
+- **Marketing landing page** at `/` (context-detected: shows when `PRISM_TARGET` not set).
+- **`app/page.tsx`** now server component with context-detection: `PRISM_TARGET` set → dashboard; unset → landing.
+- **`components/landing/LandingPage.tsx`**: full marketing page — Hero, Problem, How-It-Works, Bot-Family, forge0x2B Coming-Soon, Pricing Snippet, FAQ (8 questions), Final CTA.
+- **`components/landing/HeroVisual.tsx`**: static SVG Prism-Spektrum visual — code chaos → glass prism → 3 colored rays → BLUE/AMBER/GREEN output cards.
+- **`components/landing/NavBar.tsx`**: sticky glass-blur nav with Features/Pricing/Docs links.
+- **`components/landing/Footer.tsx`**: footer with Product/Resources/Legal columns, "0x2A = 42" easter egg.
+- **`components/dashboard/DashboardHome.tsx`**: extracted dashboard home from old root page.
+- **Copy-to-clipboard** on hero npm install command.
+- **forge0x2B Coming-Soon section** + Spectrum 0x55 bundle teaser.
+- **SEO**: full `<Metadata>` in `app/layout.tsx` — title, description, keywords, openGraph, twitter card.
+- **`app/opengraph-image.tsx`**: edge-rendered OG image (1200×630) with prism brand + badges.
+- **`app/layout.tsx`**: `metadataBase` set to `https://prism0x2a.dev`.
+
+### Changed
+
+- Root `/` route now context-detects dashboard vs landing mode.
+
 ## 0.7.2 — Pricing Page
 
 ### Added

package/.next/standalone/app/amber/page.tsx

@@ -6,6 +6,7 @@ import { PrismDock } from "@/components/PrismDock";
 import { useTargetPath } from "@/lib/prism/hooks/useTargetPath";
 import { useActiveWorkspace } from "@/lib/prism/hooks/useActiveWorkspace";
 import type { AmberScanSnapshot } from "@/lib/prism/amber/types";
+import { DemoModeNotice, useDemoMode } from "@/components/DemoModeNotice";
 
 const AMBER = "rgb(251,191,36)";
 
@@ -73,6 +74,15 @@ export default function AmberPage() {
     { href: "/amber/coverage", label: "Coverage", icon: "📊", desc: scan ? `${scan.drift_count} drift entries` : "No scan yet" },
   ];
 
+  if (useDemoMode()) {
+    return (
+      <>
+        <PrismDock />
+        <DemoModeNotice botName="AMBER" botColor="rgb(251,191,36)" botTagline="Capability Registry + Coverage" />
+      </>
+    );
+  }
+
   return (
     <div className="flex flex-col min-h-screen" style={{ background: "var(--bg-app)" }}>
       <PrismDock />

package/.next/standalone/app/api/blue/explorer/ask/route.ts

@@ -0,0 +1,49 @@
+import { NextRequest, NextResponse } from "next/server";
+import { isFeatureAvailable } from "@/lib/prism/features";
+
+export async function POST(req: NextRequest) {
+  const { target, question } = (await req.json()) as {
+    target: string;
+    question: string;
+  };
+
+  if (!target || !question) {
+    return NextResponse.json({ error: "target and question required" }, { status: 400 });
+  }
+
+  if (!isFeatureAvailable(target, "blueprint_explorer")) {
+    return NextResponse.json({ error: "Pro tier required" }, { status: 403 });
+  }
+
+  const { readBlueprint } = await import("prismlens/blueprint");
+  const blueprint =
+    readBlueprint(target, ".prism/blueprint.json") ??
+    readBlueprint(target, "blueprint-tool/output/blueprint.json");
+
+  if (!blueprint) {
+    return NextResponse.json(
+      { error: "No blueprint found. Run a scan first." },
+      { status: 400 }
+    );
+  }
+
+  // Attempt prismlens@0.4.0 Architect function
+  const pl = await import("prismlens/blueprint");
+  if (typeof (pl as Record<string, unknown>).askArchitect === "function") {
+    const askArchitect = (pl as Record<string, unknown>).askArchitect as (
+      blueprint: unknown,
+      question: string
+    ) => Promise<{ text: string; referencedFiles?: string[] }>;
+    const answer = await askArchitect(blueprint, question);
+    return NextResponse.json({ answer });
+  }
+
+  // prismlens@0.4.0 not yet published — return an informative response
+  return NextResponse.json({
+    answer: {
+      text: `**Architect Mode** requires prismlens@0.4.0 (coming soon).\n\nYour blueprint is ready with **${blueprint.summary.fileCount} files** scanned. Once the library ships, I'll be able to answer:\n\n> ${question}\n\n…grounded in your actual architecture.`,
+      referencedFiles: [],
+      pending: true,
+    },
+  });
+}

package/.next/standalone/app/api/blue/explorer/comments/[hash]/route.ts

@@ -0,0 +1,65 @@
+// Per-file comment store — reads/writes .prism/comments/<hash>.json
+import { NextRequest, NextResponse } from "next/server";
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import type { CommentFile, ExplorerComment } from "@/lib/prism/blue/explorer/types";
+
+function commentsDir(target: string) {
+  return join(target, ".prism", "comments");
+}
+
+function commentPath(target: string, hash: string) {
+  return join(commentsDir(target), `${hash}.json`);
+}
+
+function readFile(target: string, hash: string): CommentFile | null {
+  const p = commentPath(target, hash);
+  if (!existsSync(p)) return null;
+  try { return JSON.parse(readFileSync(p, "utf-8")) as CommentFile; } catch { return null; }
+}
+
+function saveFile(target: string, hash: string, file: CommentFile) {
+  mkdirSync(commentsDir(target), { recursive: true });
+  writeFileSync(commentPath(target, hash), JSON.stringify(file, null, 2));
+}
+
+export async function GET(req: NextRequest, { params }: { params: Promise<{ hash: string }> }) {
+  const { hash } = await params;
+  const target = req.nextUrl.searchParams.get("target") ?? "";
+  if (!target) return NextResponse.json({ error: "target required" }, { status: 400 });
+  const file = readFile(target, hash);
+  return NextResponse.json({ comments: file?.comments ?? [], filePath: file?.filePath ?? null });
+}
+
+export async function POST(req: NextRequest, { params }: { params: Promise<{ hash: string }> }) {
+  const { hash } = await params;
+  const target = req.nextUrl.searchParams.get("target") ?? "";
+  if (!target) return NextResponse.json({ error: "target required" }, { status: 400 });
+  const { text, filePath } = (await req.json()) as { text: string; filePath: string };
+  if (!text?.trim()) return NextResponse.json({ error: "text required" }, { status: 400 });
+
+  const existing = readFile(target, hash) ?? { filePath, comments: [] };
+  const comment: ExplorerComment = {
+    id: `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+    filePathHash: hash,
+    filePath,
+    text: text.trim(),
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
+  };
+  existing.comments = [comment, ...existing.comments];
+  saveFile(target, hash, existing);
+  return NextResponse.json({ comment });
+}
+
+export async function DELETE(req: NextRequest, { params }: { params: Promise<{ hash: string }> }) {
+  const { hash } = await params;
+  const target = req.nextUrl.searchParams.get("target") ?? "";
+  const id = req.nextUrl.searchParams.get("id") ?? "";
+  if (!target || !id) return NextResponse.json({ error: "target + id required" }, { status: 400 });
+  const existing = readFile(target, hash);
+  if (!existing) return NextResponse.json({ ok: true });
+  existing.comments = existing.comments.filter((c) => c.id !== id);
+  saveFile(target, hash, existing);
+  return NextResponse.json({ ok: true });
+}

package/.next/standalone/app/api/blue/explorer/explain/route.ts

@@ -0,0 +1,81 @@
+import { NextRequest, NextResponse } from "next/server";
+import { isFeatureAvailable } from "@/lib/prism/features";
+
+export async function POST(req: NextRequest) {
+  const { target, modulePath } = (await req.json()) as {
+    target: string;
+    modulePath: string;
+  };
+
+  if (!target || !modulePath) {
+    return NextResponse.json({ error: "target and modulePath required" }, { status: 400 });
+  }
+
+  if (!isFeatureAvailable(target, "blueprint_explorer")) {
+    return NextResponse.json({ error: "Pro tier required" }, { status: 403 });
+  }
+
+  const { readBlueprint } = await import("prismlens/blueprint");
+  const blueprint =
+    readBlueprint(target, ".prism/blueprint.json") ??
+    readBlueprint(target, "blueprint-tool/output/blueprint.json");
+
+  if (!blueprint) {
+    return NextResponse.json({ error: "No blueprint found. Run a scan first." }, { status: 400 });
+  }
+
+  const file = blueprint.files.find((f) => f.path === modulePath);
+  if (!file) {
+    return NextResponse.json({ error: `Module not found in blueprint: ${modulePath}` }, { status: 404 });
+  }
+
+  // Attempt prismlens@0.4.0
+  const pl = await import("prismlens/blueprint");
+  if (typeof (pl as Record<string, unknown>).explainModule === "function") {
+    const explainModule = (pl as Record<string, unknown>).explainModule as (
+      blueprint: unknown,
+      path: string
+    ) => Promise<{ markdown: string }>;
+    const result = await explainModule(blueprint, modulePath);
+    return NextResponse.json({ markdown: result.markdown, file });
+  }
+
+  // Fallback: synthesise from existing blueprint data
+  const lines: string[] = [
+    `# ${modulePath.split("/").pop()}`,
+    "",
+    `**Path:** \`${modulePath}\``,
+    `**Category:** ${file.category}`,
+    `**LOC:** ${file.metrics.loc} · **Heat score:** ${file.metrics.heatScore.toFixed(1)}`,
+    `**Cyclic:** ${file.isCyclic ? "yes ⚠" : "no"} · **Client component:** ${file.hasUseClientDirective ? "yes" : "no"}`,
+    "",
+  ];
+
+  if (file.docSummary) {
+    lines.push("## Summary", "", file.docSummary, "");
+  }
+
+  if (file.exports.length > 0) {
+    lines.push("## Exports", "", ...file.exports.map((e) => `- \`${e}\``), "");
+  }
+
+  lines.push(
+    "## Metrics",
+    "",
+    `| Metric | Value |`,
+    `|--------|-------|`,
+    `| Incoming deps | ${file.metrics.incomingRuntimeDeps} |`,
+    `| Outgoing deps | ${file.metrics.outgoingRuntimeDeps} |`,
+  );
+
+  if (file.metrics.complexityScore !== null) {
+    lines.push(`| Complexity | ${file.metrics.complexityScore.toFixed(1)} |`);
+  }
+
+  lines.push(
+    "",
+    "> *Full AI-powered explanation available with prismlens@0.4.0 (coming soon).*"
+  );
+
+  return NextResponse.json({ markdown: lines.join("\n"), file });
+}

package/.next/standalone/app/api/blue/explorer/outdated/route.ts

@@ -0,0 +1,20 @@
+import { NextRequest, NextResponse } from "next/server";
+import { isFeatureAvailable } from "@/lib/prism/features";
+
+export async function GET(req: NextRequest) {
+  const target = req.nextUrl.searchParams.get("target") ?? "";
+  const since  = req.nextUrl.searchParams.get("since") ?? "";
+
+  if (!target || !since) return NextResponse.json({ outdated: false });
+
+  if (!isFeatureAvailable(target, "blueprint_explorer")) {
+    return NextResponse.json({ error: "Pro tier required" }, { status: 403 });
+  }
+
+  const lastScan = new Date(since);
+  if (isNaN(lastScan.getTime())) return NextResponse.json({ outdated: false });
+
+  const { hasSourceChanged } = await import("prismlens/blueprint");
+  const outdated = hasSourceChanged(target, lastScan);
+  return NextResponse.json({ outdated });
+}

package/.next/standalone/app/api/blue/explorer/refactor/route.ts

@@ -0,0 +1,97 @@
+import { NextRequest, NextResponse } from "next/server";
+import { isFeatureAvailable } from "@/lib/prism/features";
+
+export interface RefactorSuggestion {
+  id: string;
+  kind: "cycle" | "coverage" | "hotspot" | "complexity";
+  severity: "critical" | "high" | "medium" | "low";
+  title: string;
+  description: string;
+  files: string[];
+}
+
+export async function GET(req: NextRequest) {
+  const target = req.nextUrl.searchParams.get("target") ?? "";
+  if (!target) return NextResponse.json({ error: "target required" }, { status: 400 });
+
+  if (!isFeatureAvailable(target, "blueprint_explorer")) {
+    return NextResponse.json({ error: "Pro tier required" }, { status: 403 });
+  }
+
+  const { readBlueprint } = await import("prismlens/blueprint");
+  const blueprint =
+    readBlueprint(target, ".prism/blueprint.json") ??
+    readBlueprint(target, "blueprint-tool/output/blueprint.json");
+
+  if (!blueprint) {
+    return NextResponse.json({ error: "No blueprint found. Run a scan first." }, { status: 400 });
+  }
+
+  // Attempt prismlens@0.4.0
+  const pl = await import("prismlens/blueprint");
+  if (typeof (pl as Record<string, unknown>).suggestRefactor === "function") {
+    const suggestRefactor = (pl as Record<string, unknown>).suggestRefactor as (
+      blueprint: unknown
+    ) => Promise<RefactorSuggestion[]>;
+    const suggestions = await suggestRefactor(blueprint);
+    return NextResponse.json({ suggestions });
+  }
+
+  // Fallback: derive suggestions from existing blueprint data
+  const suggestions: RefactorSuggestion[] = [];
+
+  // Cyclic imports
+  if (blueprint.analysis?.stronglyConnectedComponents?.length > 0) {
+    for (const cycle of blueprint.analysis.stronglyConnectedComponents.slice(0, 5)) {
+      suggestions.push({
+        id: `cycle-${cycle.id}`,
+        kind: "cycle",
+        severity: "critical",
+        title: `Import cycle (${cycle.size} files)`,
+        description: "Circular imports prevent tree-shaking and create tight coupling. Break the cycle by extracting shared logic to a new module.",
+        files: cycle.paths ?? [],
+      });
+    }
+  }
+
+  // Hot-spots
+  const hotFiles = blueprint.files
+    .filter((f) => f.metrics.heatScore >= 75)
+    .sort((a, b) => b.metrics.heatScore - a.metrics.heatScore)
+    .slice(0, 5);
+
+  for (const f of hotFiles) {
+    suggestions.push({
+      id: `hotspot-${f.id}`,
+      kind: "hotspot",
+      severity: f.metrics.heatScore >= 90 ? "critical" : "high",
+      title: `Hot file: ${f.path.split("/").pop()} (heat ${f.metrics.heatScore.toFixed(0)})`,
+      description: `High heat score indicates this file is heavily imported, frequently changed, or has high complexity. Consider splitting into smaller modules.`,
+      files: [f.path],
+    });
+  }
+
+  // Coverage gaps
+  const lowCovFiles = blueprint.files
+    .filter((f) => f.coverage !== null && f.coverage.statements < 50)
+    .sort((a, b) => (a.coverage?.statements ?? 0) - (b.coverage?.statements ?? 0))
+    .slice(0, 5);
+
+  for (const f of lowCovFiles) {
+    suggestions.push({
+      id: `cov-${f.id}`,
+      kind: "coverage",
+      severity: (f.coverage?.statements ?? 0) < 20 ? "high" : "medium",
+      title: `Low coverage: ${f.path.split("/").pop()} (${f.coverage?.statements.toFixed(0)}%)`,
+      description: `Statement coverage below 50%. Add unit tests for the untested branches — especially important for high-heat files.`,
+      files: [f.path],
+    });
+  }
+
+  suggestions.sort((a, b) => {
+    const order = { critical: 0, high: 1, medium: 2, low: 3 };
+    return order[a.severity] - order[b.severity];
+  });
+
+  return NextResponse.json({ suggestions, derived: true });
+}

package/.next/standalone/app/api/blue/explorer/route.ts

@@ -0,0 +1,45 @@
+// Blueprint Explorer API
+// GET  → load blueprint from disk (readBlueprint from prismlens)
+// POST → run full scan (generateBlueprint from prismlens)
+import { NextRequest, NextResponse } from "next/server";
+import { writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+import { isFeatureAvailable } from "@/lib/prism/features";
+
+export async function GET(req: NextRequest) {
+  const target = req.nextUrl.searchParams.get("target") ?? "";
+  if (!target) return NextResponse.json({ error: "target required" }, { status: 400 });
+
+  if (!isFeatureAvailable(target, "blueprint_explorer")) {
+    return NextResponse.json({ error: "Pro tier required" }, { status: 403 });
+  }
+
+  const { readBlueprint } = await import("prismlens/blueprint");
+
+  // Try .prism/blueprint.json first, then legacy blueprint-tool output path
+  const blueprint =
+    readBlueprint(target, ".prism/blueprint.json") ??
+    readBlueprint(target, "blueprint-tool/output/blueprint.json");
+
+  return NextResponse.json({ data: blueprint ?? null });
+}
+
+export async function POST(req: NextRequest) {
+  const { target } = (await req.json()) as { target: string };
+  if (!target) return NextResponse.json({ error: "target required" }, { status: 400 });
+
+  if (!isFeatureAvailable(target, "blueprint_explorer")) {
+    return NextResponse.json({ error: "Pro tier required" }, { status: 403 });
+  }
+
+  const { generateBlueprint } = await import("prismlens/blueprint");
+
+  const blueprint = await generateBlueprint(target, { write: false });
+
+  // Persist to .prism/blueprint.json
+  const dir = join(target, ".prism");
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(join(dir, "blueprint.json"), JSON.stringify(blueprint, null, 2));
+
+  return NextResponse.json({ data: blueprint });
+}