noctrace 1.0.0 → 1.2.0

package/README.md

@@ -88,6 +88,7 @@ Requires Node.js 20+. Optional `--install-hooks` flag enables real-time hook eve
 - **Agent Teams Panel** — detects running Agent Teams at `~/.claude/teams/`, shows members and task counts in a flyout
 - **Context Startup Flyout** — shows which instruction files (CLAUDE.md and others) loaded at session start with estimated token counts, parsed from JSONL system records
 - **Docker Support** — `npx noctrace --docker <container>` attaches to a running Docker container, injects a lightweight watcher, and streams JSONL events back to your host in real time. Zero container setup required
+- **Patterns View (new in v1.2)** — a second top-level tab that aggregates across every session in the chosen time window (today, 7 days, 30 days). Three panels: health distribution (A/B/C/D/F grade counts with week-over-week delta arrows), project rot leaderboard (which codebases are degrading, ranked), and tool health grid (per-tool failure rate and p50/p95 latency). Zero spend or token tracking — this is about quality and waste
 
 ![Noctrace waterfall timeline](docs/screenshots/noctrace-waterfall.gif)
 
@@ -143,6 +144,7 @@ No config files. No cloud. Everything stays local. Optional hooks for richer rea
 | CLI Flag | Description |
 |----------|-------------|
 | `--docker <container>` | Attach to a running Docker container and stream its Claude Code sessions back to your host. Zero container setup |
+| `--devcontainer <path>` | Resolve the running devcontainer for a local folder path and attach to it. Pass `.` for the current directory. Falls back to `--docker` if you pass a container name directly |
 | `--install-hooks` | Configure Claude Code to push real-time events to noctrace |
 | `--uninstall-hooks` | Remove noctrace hooks from Claude Code |
 

package/bin/noctrace.js

@@ -197,14 +197,11 @@ if (args.includes('--disable')) {
   process.exit(0);
 }
 
-if (args.includes('--docker')) {
-  const containerArg = args[args.indexOf('--docker') + 1];
-  if (!containerArg || containerArg.startsWith('--')) {
-    console.error('[noctrace] Usage: npx noctrace --docker <container-name-or-id>');
-    console.error('[noctrace] Example: npx noctrace --docker my-claude-container');
-    process.exit(1);
-  }
-
+/**
+ * Run Docker watcher mode with a known, already-validated container ID.
+ * Shared by --docker and --devcontainer.
+ */
+async function runDockerMode(containerArg) {
   const {
     isValidContainerName,
     assertContainerRunning,
@@ -320,6 +317,44 @@ if (args.includes('--docker')) {
   await new Promise(() => {});
 }
 
+if (args.includes('--docker')) {
+  const containerArg = args[args.indexOf('--docker') + 1];
+  if (!containerArg || containerArg.startsWith('--')) {
+    console.error('[noctrace] Usage: npx noctrace --docker <container-name-or-id>');
+    console.error('[noctrace] Example: npx noctrace --docker my-claude-container');
+    process.exit(1);
+  }
+  await runDockerMode(containerArg);
+}
+
+if (args.includes('--devcontainer')) {
+  const devcontainerArg = args[args.indexOf('--devcontainer') + 1];
+  if (!devcontainerArg || devcontainerArg.startsWith('--')) {
+    console.error('[noctrace] Usage: npx noctrace --devcontainer <path-or-container>');
+    console.error('[noctrace] Examples:');
+    console.error('[noctrace]   npx noctrace --devcontainer .');
+    console.error('[noctrace]   npx noctrace --devcontainer /Users/me/myproject');
+    console.error('[noctrace]   npx noctrace --devcontainer my-devcontainer-id');
+    process.exit(1);
+  }
+
+  const { resolveDevcontainerContainer, defaultDockerRunner } =
+    await import('../dist/server/server/docker.js');
+
+  let resolvedContainer;
+  try {
+    resolvedContainer = resolveDevcontainerContainer(devcontainerArg, defaultDockerRunner);
+  } catch (err) {
+    const lines = err.message.split('\n');
+    for (const line of lines) {
+      console.error(`[noctrace] ${line}`);
+    }
+    process.exit(1);
+  }
+
+  await runDockerMode(resolvedContainer);
+}
+
 if (args.includes('--mcp')) {
   // MCP mode: boot the Express server and speak JSON-RPC over stdio.
   // stdout is the JSON-RPC channel — all logging must go to stderr.