archbyte 0.4.2 → 0.5.0

package/dist/cli/workflow.js

@@ -8,7 +8,7 @@ const BUILTIN_WORKFLOWS = [
     {
         id: "full-analysis",
         name: "Full Analysis Pipeline",
-        description: "Complete architecture pipeline: analyze, generate, validate, and report",
+        description: "Complete architecture pipeline: analyze, generate, audit, and report",
         steps: [
             {
                 id: "generate",
@@ -17,13 +17,6 @@ const BUILTIN_WORKFLOWS = [
                 needs: [],
                 description: "Generate architecture diagram from analysis JSON",
             },
-            {
-                id: "validate",
-                name: "Validate Architecture",
-                command: "archbyte validate",
-                needs: ["generate"],
-                description: "Run fitness function rules against the architecture",
-            },
             {
                 id: "stats",
                 name: "Architecture Stats",
@@ -34,23 +27,23 @@ const BUILTIN_WORKFLOWS = [
             {
                 id: "export",
                 name: "Export Mermaid",
-                command: "archbyte export --format mermaid",
+                command: "archbyte export --format mermaid --output .archbyte/architecture.mmd",
                 needs: ["generate"],
-                description: "Export architecture as Mermaid diagram",
+                description: "Export architecture as Mermaid diagram to .archbyte/architecture.mmd",
             },
         ],
     },
     {
         id: "ci-check",
         name: "CI Architecture Check",
-        description: "Lightweight CI pipeline: validate and diff against baseline",
+        description: "Lightweight CI pipeline: audit architecture health",
         steps: [
             {
-                id: "validate",
-                name: "Validate",
-                command: "archbyte validate --ci",
+                id: "stats",
+                name: "Stats",
+                command: "archbyte stats --ci",
                 needs: [],
-                description: "Run validation in CI mode (JSON output, exit code on failure)",
+                description: "Run architecture stats in CI mode",
             },
         ],
     },

package/dist/server/src/index.js

@@ -15,13 +15,16 @@ let config;
 let sseClients = new Set();
 let diagramWatcher = null;
 let isAnalyzing = false;
+// Source file watcher — detects changes to notify UI for manual re-analysis
+let sourceWatcher = null;
+const pendingSourceChanges = new Map();
+let changeDebounceTimer = null;
+const CHANGE_DEBOUNCE_MS = 2500;
 const sessionChanges = [];
 const MAX_SESSION_CHANGES = 50;
 let currentArchitecture = null;
 // Process tracking for run-from-UI
 const runningWorkflows = new Map();
-let patrolProcess = null;
-let patrolRunning = false;
 let chatProcess = null;
 // Resolve archbyte CLI binary path
 function getArchbyteBin() {
@@ -331,7 +334,7 @@ function createHttpServer() {
             return;
         }
         // API: Audit — unified validation + health endpoint
-        if ((url === "/api/audit" || url === "/api/validate") && req.method === "GET") {
+        if (url === "/api/audit" && req.method === "GET") {
             const arch = currentArchitecture || (await loadArchitecture());
             if (!arch) {
                 res.writeHead(404, { "Content-Type": "application/json" });
@@ -937,51 +940,13 @@ function createHttpServer() {
             res.end(content);
             return;
         }
-        // API: Patrol history
-        if (url === "/api/patrol/latest" && req.method === "GET") {
-            const latestPath = path.join(config.workspaceRoot, ".archbyte/patrols/latest.json");
-            if (!existsSync(latestPath)) {
-                res.writeHead(200, { "Content-Type": "application/json" });
-                res.end(JSON.stringify(null));
-                return;
-            }
-            try {
-                const content = readFileSync(latestPath, "utf-8");
-                res.writeHead(200, { "Content-Type": "application/json" });
-                res.end(content);
-            }
-            catch {
-                res.writeHead(200, { "Content-Type": "application/json" });
-                res.end(JSON.stringify(null));
-            }
-            return;
-        }
-        if (url === "/api/patrol/history" && req.method === "GET") {
-            const historyPath = path.join(config.workspaceRoot, ".archbyte/patrols/history.jsonl");
-            if (!existsSync(historyPath)) {
-                res.writeHead(200, { "Content-Type": "application/json" });
-                res.end(JSON.stringify([]));
-                return;
-            }
-            try {
-                const content = readFileSync(historyPath, "utf-8");
-                const records = content.trim().split("\n").filter(Boolean).slice(-50).map((line) => JSON.parse(line));
-                res.writeHead(200, { "Content-Type": "application/json" });
-                res.end(JSON.stringify(records));
-            }
-            catch {
-                res.writeHead(200, { "Content-Type": "application/json" });
-                res.end(JSON.stringify([]));
-            }
-            return;
-        }
         // API: Workflow list and status
         if (url === "/api/workflow/list" && req.method === "GET") {
             const workflows = [];
             // Built-in workflows
             const builtins = [
-                { id: "full-analysis", name: "Full Analysis Pipeline", description: "Complete architecture pipeline", steps: ["generate", "validate", "stats", "export"] },
-                { id: "ci-check", name: "CI Architecture Check", description: "Lightweight CI pipeline", steps: ["validate"] },
+                { id: "full-analysis", name: "Full Analysis Pipeline", description: "Complete architecture pipeline", steps: ["generate", "stats", "export"] },
+                { id: "ci-check", name: "CI Architecture Check", description: "Lightweight CI pipeline", steps: ["stats"] },
                 { id: "drift-check", name: "Architecture Drift Check", description: "Check for architecture drift", steps: ["snapshot", "generate", "diff"] },
             ];
             for (const b of builtins) {
@@ -1197,6 +1162,14 @@ function createHttpServer() {
             res.end(JSON.stringify(sessionChanges));
             return;
         }
+        // API: Pending source file changes — hydrates UI on reconnect
+        if (url === "/api/changes/pending" && req.method === "GET") {
+            const files = Array.from(pendingSourceChanges.values()).map((c) => ({ event: c.event, path: c.path }));
+            const count = files.length;
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ count, files: files.slice(0, 20), truncated: count > 20 }));
+            return;
+        }
         // API: Run workflow
         if (url.startsWith("/api/workflow/run/") && req.method === "POST") {
             const id = url.split("/").pop();
@@ -1269,56 +1242,6 @@ function createHttpServer() {
             });
             return;
         }
-        // API: Start patrol
-        if (url === "/api/patrol/start" && req.method === "POST") {
-            if (patrolRunning) {
-                res.writeHead(409, { "Content-Type": "application/json" });
-                res.end(JSON.stringify({ error: "Patrol already running" }));
-                return;
-            }
-            let body = "";
-            req.on("data", (chunk) => { body += chunk.toString(); });
-            req.on("end", () => {
-                const { interval } = JSON.parse(body || "{}");
-                const bin = getArchbyteBin();
-                const args = [bin, "patrol"];
-                if (interval)
-                    args.push("--interval", String(interval));
-                patrolProcess = spawn(process.execPath, args, {
-                    cwd: config.workspaceRoot,
-                    stdio: ["ignore", "inherit", "inherit"],
-                    env: { ...process.env, FORCE_COLOR: "1" },
-                });
-                patrolRunning = true;
-                broadcastOpsEvent({ type: "patrol:started" });
-                patrolProcess.on("close", () => {
-                    patrolProcess = null;
-                    patrolRunning = false;
-                    broadcastOpsEvent({ type: "patrol:stopped" });
-                });
-                res.writeHead(200, { "Content-Type": "application/json" });
-                res.end(JSON.stringify({ ok: true }));
-            });
-            return;
-        }
-        // API: Stop patrol
-        if (url === "/api/patrol/stop" && req.method === "POST") {
-            if (patrolProcess) {
-                patrolProcess.kill("SIGTERM");
-                patrolProcess = null;
-                patrolRunning = false;
-                broadcastOpsEvent({ type: "patrol:stopped" });
-            }
-            res.writeHead(200, { "Content-Type": "application/json" });
-            res.end(JSON.stringify({ ok: true }));
-            return;
-        }
-        // API: Patrol running status
-        if (url === "/api/patrol/running" && req.method === "GET") {
-            res.writeHead(200, { "Content-Type": "application/json" });
-            res.end(JSON.stringify({ running: patrolRunning }));
-            return;
-        }
         // API: Config — read project config (including provider settings)
         if (url === "/api/config" && req.method === "GET") {
             const configPath = path.join(config.workspaceRoot, ".archbyte/config.json");
@@ -1732,12 +1655,22 @@ function diffArchitectures(prev, curr) {
         .map((e) => ({ source: e.source, target: e.target, label: e.label }));
     return { addedNodes, removedNodes, modifiedNodes, addedEdges, removedEdges };
 }
-// Run analyze → generate pipeline (used by /api/analyze and patrol)
+// Run analyze → generate pipeline (used by /api/analyze)
 function runAnalyzePipeline(mode = "static", fileChanges) {
     if (isAnalyzing)
         return;
     isAnalyzing = true;
     const pipelineStart = Date.now();
+    // Capture and clear pending source changes
+    if (!fileChanges) {
+        fileChanges = Array.from(pendingSourceChanges.values()).map((c) => ({ event: c.event, path: c.path }));
+    }
+    pendingSourceChanges.clear();
+    if (changeDebounceTimer) {
+        clearTimeout(changeDebounceTimer);
+        changeDebounceTimer = null;
+    }
+    broadcastOpsEvent({ type: "changes:cleared" });
     // Snapshot current architecture for diffing after pipeline completes
     const prevArchitecture = currentArchitecture
         ? { ...currentArchitecture, nodes: [...currentArchitecture.nodes], edges: [...currentArchitecture.edges] }
@@ -1828,6 +1761,56 @@ function setupWatcher() {
         broadcastUpdate();
     });
 }
+// Broadcast pending source changes to SSE clients
+function broadcastPendingChanges() {
+    const files = Array.from(pendingSourceChanges.values()).map((c) => c.path);
+    const count = files.length;
+    const truncated = count > 20;
+    broadcastOpsEvent({
+        type: "changes:detected",
+        count,
+        files: files.slice(0, 20),
+        truncated,
+    });
+}
+// Setup source file watcher — watches workspace for code changes
+function setupSourceWatcher() {
+    sourceWatcher = watch(config.workspaceRoot, {
+        ignoreInitial: true,
+        ignored: [
+            /(^|[/\\])\../, // dotfiles/dirs
+            "**/node_modules/**",
+            "**/dist/**",
+            "**/build/**",
+            "**/out/**",
+            "**/.archbyte/**",
+            "**/coverage/**",
+            "**/*.lock",
+            "**/package-lock.json",
+            "**/__pycache__/**",
+            "**/target/**",
+            "**/vendor/**",
+        ],
+        depth: 10,
+    });
+    sourceWatcher.on("all", (event, filePath) => {
+        if (event !== "change" && event !== "add" && event !== "unlink")
+            return;
+        const relativePath = path.relative(config.workspaceRoot, filePath);
+        pendingSourceChanges.set(relativePath, {
+            event,
+            path: relativePath,
+            timestamp: Date.now(),
+        });
+        // Debounce: reset timer on each change, broadcast after settling
+        if (changeDebounceTimer)
+            clearTimeout(changeDebounceTimer);
+        changeDebounceTimer = setTimeout(() => {
+            changeDebounceTimer = null;
+            broadcastPendingChanges();
+        }, CHANGE_DEBOUNCE_MS);
+    });
+}
 // Graceful shutdown
 function setupShutdown() {
     const shutdown = async () => {
@@ -1840,14 +1823,6 @@ function setupShutdown() {
             catch { }
         }
         runningWorkflows.clear();
-        if (patrolProcess) {
-            try {
-                patrolProcess.kill("SIGTERM");
-            }
-            catch { }
-            patrolProcess = null;
-            patrolRunning = false;
-        }
         if (chatProcess) {
             try {
                 chatProcess.kill("SIGTERM");
@@ -1862,6 +1837,7 @@ function setupShutdown() {
             catch { }
         }
         sseClients.clear();
+        await sourceWatcher?.close();
         await diagramWatcher?.close();
         httpServer?.close();
         process.exit(0);
@@ -1878,8 +1854,7 @@ function loadLicenseInfo() {
         tier: "free",
         features: {
             analyze: true,
-            validate: false,
-            patrol: false,
+            audit: false,
             workflows: false,
             chat: false,
             premiumAgents: false,
@@ -1931,8 +1906,7 @@ function loadLicenseInfo() {
             tier: isPremium ? "premium" : "free",
             features: {
                 analyze: true,
-                validate: isPremium,
-                patrol: isPremium,
+                audit: isPremium,
                 workflows: isPremium,
                 chat: isPremium,
                 premiumAgents: isPremium,
@@ -1956,6 +1930,7 @@ export async function startServer(cfg) {
         process.exit(1);
     }
     setupWatcher();
+    setupSourceWatcher();
     console.error(`[archbyte] Serving ${config.name}`);
     console.error(`[archbyte] Diagram: ${config.diagramPath}`);
     // Listen for 'q' keypress to quit gracefully

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archbyte",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "ArchByte - See what agents build. As they build it.",
   "type": "module",
   "bin": {
@@ -36,7 +36,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.74.0",
-    "@google/genai": "^1.41.0",
+    "@google/genai": "^1.42.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "chalk": "^5.3.0",
     "chokidar": "^3.5.3",

package/templates/archbyte.yaml

@@ -102,10 +102,31 @@ rules:
   #     to: { type: external }
   #     level: warn
 
-# ── Patrol ──
-# Configure the continuous monitoring daemon (archbyte patrol).
-# patrol:
-#   ignore:
-#     - "docs/"
-#     - "*.md"
-#     - "scripts/"
+# ── Workflows ──
+# Composable multi-step architecture pipelines.
+# Run built-in workflows:
+#   archbyte workflow --list           # see available workflows
+#   archbyte workflow --run full-analysis
+#   archbyte workflow --run ci-check
+#   archbyte workflow --run drift-check
+#
+# Create custom workflows in .archbyte/workflows/:
+#   archbyte workflow --create "My Pipeline"
+#
+# Custom workflow format (.archbyte/workflows/my-pipeline.yaml):
+# id: my-pipeline
+# name: "My Pipeline"
+# description: "Custom architecture pipeline"
+# steps:
+#   - id: generate
+#     name: "Generate Diagram"
+#     command: "archbyte generate"
+#     needs: []
+#   - id: validate
+#     name: "Validate"
+#     command: "archbyte validate"
+#     needs: [generate]
+#   - id: export
+#     name: "Export"
+#     command: "archbyte export --format mermaid"
+#     needs: [validate]