@codeyam/codeyam-cli 0.1.0-staging.b8a55ba → 0.1.0-staging.c90f8c9

package/codeyam-cli/src/webserver/build/server/index.js

@@ -1 +1 @@
-import{Z as E,N as F,O as G,X as H,Q as I,T as J,U as K,W as L,V as _,Y as $,R as rr}from"./assets/server-build-BDlyhfrv.js";import"react/jsx-runtime";import"node:stream";import"@react-router/node";import"react-router";import"isbot";import"react-dom/server";import"react";import"lucide-react";import"fetch-retry";import"better-sqlite3";import"pg";import"fs";import"path";import"kysely";import"kysely/helpers/sqlite";import"kysely/helpers/postgres";import"typescript";import"fs/promises";import"os";import"prompts";import"chalk";import"crypto";import"child_process";import"util";import"dotenv";import"events";import"uuid";import"url";import"openai";import"p-queue";import"p-retry";import"@aws-sdk/client-dynamodb";import"lru-cache";import"pluralize";import"piscina";import"json5";import"@aws-sdk/util-dynamodb";import"react-syntax-highlighter";import"react-syntax-highlighter/dist/cjs/styles/prism/index.js";import"node:crypto";import"v8";import"react-diff-viewer-continued";export{E as assets,F as assetsBuildDirectory,G as basename,H as entry,I as future,J as isSpaMode,K as prerender,L as publicPath,_ as routeDiscovery,$ as routes,rr as ssr};
+import{Y as G,M as H,N as I,W as J,O as K,R as L,T as Z,V as _,U as $,X as rr,Q as tr}from"./assets/server-build-B08qC4Y7.js";import"react/jsx-runtime";import"node:stream";import"@react-router/node";import"react-router";import"isbot";import"react-dom/server";import"react";import"lucide-react";import"fetch-retry";import"better-sqlite3";import"pg";import"fs";import"path";import"kysely";import"kysely/helpers/sqlite";import"kysely/helpers/postgres";import"typescript";import"fs/promises";import"os";import"prompts";import"chalk";import"crypto";import"child_process";import"url";import"util";import"dotenv";import"events";import"uuid";import"openai";import"p-queue";import"p-retry";import"@aws-sdk/client-dynamodb";import"lru-cache";import"pluralize";import"piscina";import"json5";import"@aws-sdk/util-dynamodb";import"react-syntax-highlighter";import"react-syntax-highlighter/dist/cjs/styles/prism/index.js";import"node:crypto";import"v8";import"react-markdown";import"react-diff-viewer-continued";export{G as assets,H as assetsBuildDirectory,I as basename,J as entry,K as future,L as isSpaMode,Z as prerender,_ as publicPath,$ as routeDiscovery,rr as routes,tr as ssr};

package/codeyam-cli/src/webserver/build-info.json

@@ -1,7 +1,7 @@
 {
-  "buildTimestamp": "2026-01-08T16:34:32.051Z",
-  "buildTime": 1767890072051,
-  "buildNumber": 353,
-  "semanticVersion": "0.1.353",
-  "version": "0.1.353 (2026-01-08T16:34)"
+  "buildTimestamp": "2026-01-28T11:45:08.248Z",
+  "buildTime": 1769600708248,
+  "buildNumber": 560,
+  "semanticVersion": "0.1.560",
+  "version": "0.1.560 (2026-01-28T11:45)"
 }

package/codeyam-cli/src/webserver/server.js

@@ -1,11 +1,12 @@
 // codeyam-cli/src/webserver/server.ts
-import express from "express";
-import path from "path";
-import { fileURLToPath } from "url";
-import { createRequestHandler } from "@react-router/express";
-import fs from "fs";
+import express from 'express';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { createRequestHandler } from '@react-router/express';
+import fs from 'fs';
+import { cliVersion } from "../utils/versionInfo.js";
 // BUILD VERSION MARKER - Change this timestamp when rebuilding to verify build is current
-const SERVER_BUILD_VERSION = "2025-01-07T16:00:00.000Z";
+const SERVER_BUILD_VERSION = '2025-01-07T16:00:00.000Z';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 function toFileUrl(p) {
@@ -21,22 +22,31 @@ function exists(p) {
     }
 }
 const WEBSERVER_ROOT = __dirname;
-const BUILD_FILE = path.join(WEBSERVER_ROOT, "build", "server", "index.js");
-const CLIENT_BUILD_DIR = path.join(WEBSERVER_ROOT, "build", "client");
+const BUILD_FILE = path.join(WEBSERVER_ROOT, 'build', 'server', 'index.js');
+const CLIENT_BUILD_DIR = path.join(WEBSERVER_ROOT, 'build', 'client');
 async function loadBuild(cacheBust = false) {
-    const href = cacheBust ? `${toFileUrl(BUILD_FILE)}?t=${Date.now()}` : toFileUrl(BUILD_FILE);
+    const href = cacheBust
+        ? `${toFileUrl(BUILD_FILE)}?t=${Date.now()}`
+        : toFileUrl(BUILD_FILE);
     const mod = await import(href);
     return (mod.default ?? mod);
 }
 const app = express();
-app.use(express.static(path.join(WEBSERVER_ROOT, "public")));
+app.use(express.static(path.join(WEBSERVER_ROOT, 'public')));
 // Serve Vite-built assets with immutable cache FIRST (these never conflict with routes)
-app.use("/assets", express.static(path.join(CLIENT_BUILD_DIR, "assets"), { immutable: true, maxAge: "1y" }));
-app.get("/api/health", (_req, res) => {
-    res.json({ status: "ok", message: "CodeYam Remix server is running" });
+app.use('/assets', express.static(path.join(CLIENT_BUILD_DIR, 'assets'), {
+    immutable: true,
+    maxAge: '1y',
+}));
+app.get('/api/health', (_req, res) => {
+    res.json({
+        status: 'ok',
+        version: cliVersion,
+        message: 'CodeYam Remix server is running',
+    });
 });
 // Handle Chrome DevTools protocol discovery request
-app.get("/.well-known/appspecific/com.chrome.devtools.json", (_req, res) => {
+app.get('/.well-known/appspecific/com.chrome.devtools.json', (_req, res) => {
     res.status(204).end();
 });
 function createDevHandler() {
@@ -45,11 +55,11 @@ function createDevHandler() {
             const build = await loadBuild(true); // cache-bust per request
             return createRequestHandler({
                 build,
-                mode: "development",
+                mode: 'development',
                 getLoadContext: () => ({
                     analysisQueue: app.locals.analysisQueue,
-                    dbNotifier: app.locals.dbNotifier
-                })
+                    dbNotifier: app.locals.dbNotifier,
+                }),
             })(req, res, next);
         }
         catch (err) {
@@ -66,11 +76,11 @@ function createProdHandler() {
             const build = await buildPromise;
             return createRequestHandler({
                 build,
-                mode: "production",
+                mode: 'production',
                 getLoadContext: () => ({
                     analysisQueue: app.locals.analysisQueue,
-                    dbNotifier: app.locals.dbNotifier
-                })
+                    dbNotifier: app.locals.dbNotifier,
+                }),
             })(req, res, next);
         }
         catch (err) {
@@ -79,15 +89,15 @@ function createProdHandler() {
     };
 }
 // Handle Remix routes (API routes, page routes, etc.)
-if (process.env.NODE_ENV === "development") {
+if (process.env.NODE_ENV === 'development') {
     app.use(createDevHandler());
 }
 else {
     app.use(createProdHandler());
 }
 // Serve other client files as fallback
-app.use(express.static(CLIENT_BUILD_DIR, { maxAge: "1h" }));
-export function startRemixServer({ port, analysisQueue, dbNotifier }) {
+app.use(express.static(CLIENT_BUILD_DIR, { maxAge: '1h' }));
+export function startRemixServer({ port, analysisQueue, dbNotifier, }) {
     console.log('[Server] ========================================');
     console.log('[Server] SERVER BUILD VERSION:', SERVER_BUILD_VERSION);
     console.log('[Server] Starting Remix server initialization...');
@@ -98,7 +108,7 @@ export function startRemixServer({ port, analysisQueue, dbNotifier }) {
         console.log('[Server] ✅ Analysis queue stored in app.locals');
         console.log('[Server]    Queue state:', {
             jobs: analysisQueue.getState().jobs.length,
-            paused: analysisQueue.getState().paused
+            paused: analysisQueue.getState().paused,
         });
     }
     else {
@@ -137,7 +147,7 @@ export function startRemixServer({ port, analysisQueue, dbNotifier }) {
             console.log('[Server] ========================================');
             resolve({ url, server });
         });
-        server.on("error", reject);
+        server.on('error', reject);
     });
 }
 //# sourceMappingURL=server.js.map

package/codeyam-cli/src/webserver/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../src/webserver/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../src/webserver/server.ts"],"names":[],"mappings":"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"}

package/codeyam-cli/templates/codeyam-power-rules-hook.sh

@@ -0,0 +1,200 @@
+#!/bin/bash
+# CodeYam Power Rules - Pre-commit Hook (BLOCKING)
+# Ensures rules are reviewed when associated code changes
+#
+# This hook checks that rules with matching `paths` patterns have been reviewed
+# (indicated by an updated `timestamp` field) when associated code files are modified.
+
+set -e
+
+RULES_DIR=".claude/rules"
+
+# Skip if no rules directory
+if [ ! -d "$RULES_DIR" ]; then
+  exit 0
+fi
+
+# Get staged code files (added, copied, modified, renamed)
+STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACMR 2>/dev/null | grep -E '\.(ts|tsx|js|jsx)$' || true)
+
+if [ -z "$STAGED_FILES" ]; then
+  exit 0
+fi
+
+# Function to convert ISO 8601 timestamp to epoch seconds
+# Handles both macOS and Linux date commands
+timestamp_to_epoch() {
+  local ts="$1"
+  # Remove trailing Z if present
+  ts="${ts%Z}"
+
+  if date --version >/dev/null 2>&1; then
+    # GNU date (Linux)
+    date -d "$ts" +%s 2>/dev/null || echo "0"
+  else
+    # BSD date (macOS)
+    # Handle ISO 8601 format: 2026-01-27T10:30:00
+    date -j -f "%Y-%m-%dT%H:%M:%S" "$ts" +%s 2>/dev/null || echo "0"
+  fi
+}
+
+# Function to get file modification time as epoch
+get_file_mtime() {
+  local file="$1"
+  if [ ! -f "$file" ]; then
+    echo "0"
+    return
+  fi
+
+  if stat --version >/dev/null 2>&1; then
+    # GNU stat (Linux)
+    stat -c %Y "$file" 2>/dev/null || echo "0"
+  else
+    # BSD stat (macOS)
+    stat -f %m "$file" 2>/dev/null || echo "0"
+  fi
+}
+
+# Function to check if a file matches a glob pattern
+# This is a simplified matcher - complex globs may not work perfectly
+matches_pattern() {
+  local file="$1"
+  local pattern="$2"
+
+  # Handle ** patterns by converting to simpler form
+  # This is a simplification - proper glob matching would need a more robust solution
+  local regex_pattern="$pattern"
+
+  # Escape regex special chars except * and ?
+  regex_pattern=$(echo "$regex_pattern" | sed 's/\./\\./g; s/\[/\\[/g; s/\]/\\]/g')
+
+  # Convert glob patterns to regex
+  # ** matches any path segment(s)
+  regex_pattern=$(echo "$regex_pattern" | sed 's/\*\*/DOUBLESTAR/g')
+  # * matches anything except /
+  regex_pattern=$(echo "$regex_pattern" | sed 's/\*/[^/]*/g')
+  # ** matches any path
+  regex_pattern=$(echo "$regex_pattern" | sed 's/DOUBLESTAR/.*/g')
+  # ? matches single char
+  regex_pattern=$(echo "$regex_pattern" | sed 's/?/./g')
+
+  # Anchor the pattern
+  regex_pattern="^${regex_pattern}$"
+
+  echo "$file" | grep -qE "$regex_pattern" 2>/dev/null
+}
+
+# Parse timestamp from YAML frontmatter
+get_rule_timestamp() {
+  local rule_file="$1"
+  # Extract content between first two --- lines, then find timestamp
+  sed -n '1,/^---$/!{/^---$/q;p}' "$rule_file" 2>/dev/null | \
+    grep -E '^timestamp:' | \
+    sed 's/timestamp:[[:space:]]*//' | \
+    tr -d "'" | tr -d '"' | \
+    head -1
+}
+
+# Parse paths from YAML frontmatter
+get_rule_paths() {
+  local rule_file="$1"
+  # Extract the paths array from YAML frontmatter
+  # This handles both inline array and multi-line array formats
+  sed -n '1,/^---$/!{/^---$/q;p}' "$rule_file" 2>/dev/null | \
+    sed -n '/^paths:/,/^[a-z]/p' | \
+    grep -E "^[[:space:]]*-" | \
+    sed "s/^[[:space:]]*-[[:space:]]*//" | \
+    tr -d "'" | tr -d '"'
+}
+
+OUTDATED_RULES=""
+CHECKED_RULES=""
+
+# Find all rule files and check them
+while IFS= read -r rule_file; do
+  # Skip if already checked this rule
+  if echo "$CHECKED_RULES" | grep -qF "$rule_file"; then
+    continue
+  fi
+  CHECKED_RULES="$CHECKED_RULES $rule_file"
+
+  rule_timestamp=$(get_rule_timestamp "$rule_file")
+
+  # Skip rules without timestamp
+  if [ -z "$rule_timestamp" ]; then
+    continue
+  fi
+
+  rule_epoch=$(timestamp_to_epoch "$rule_timestamp")
+
+  if [ "$rule_epoch" = "0" ]; then
+    continue
+  fi
+
+  # Get paths for this rule
+  rule_paths=$(get_rule_paths "$rule_file")
+
+  if [ -z "$rule_paths" ]; then
+    continue
+  fi
+
+  # Check each staged file against this rule's paths
+  rule_is_outdated=false
+  matched_file=""
+
+  while IFS= read -r staged_file; do
+    if [ -z "$staged_file" ]; then
+      continue
+    fi
+
+    while IFS= read -r pattern; do
+      if [ -z "$pattern" ]; then
+        continue
+      fi
+
+      if matches_pattern "$staged_file" "$pattern"; then
+        # Get file modification time
+        file_epoch=$(get_file_mtime "$staged_file")
+
+        # If file is newer than rule timestamp, flag it
+        if [ "$file_epoch" -gt "$rule_epoch" ]; then
+          rule_is_outdated=true
+          matched_file="$staged_file"
+          break 2
+        fi
+      fi
+    done <<< "$rule_paths"
+  done <<< "$STAGED_FILES"
+
+  if [ "$rule_is_outdated" = true ]; then
+    OUTDATED_RULES="$OUTDATED_RULES
+    - $rule_file
+      (matched: $matched_file)"
+  fi
+
+done < <(find "$RULES_DIR" -name "*.md" -type f 2>/dev/null)
+
+if [ -n "$OUTDATED_RULES" ]; then
+  echo ""
+  echo "================================================================"
+  echo "  Power Rules: Outdated Documentation Detected"
+  echo "================================================================"
+  echo ""
+  echo "  The following rules have timestamps older than the code"
+  echo "  files they cover:"
+  echo "$OUTDATED_RULES"
+  echo ""
+  echo "  To proceed:"
+  echo "    1. Review each rule to ensure it's still accurate"
+  echo "    2. Update the 'timestamp' field in the YAML frontmatter"
+  echo "    3. Stage the updated rule file(s)"
+  echo "    4. Commit again"
+  echo ""
+  echo "  Or run: /codeyam:power-rules to review all rules"
+  echo ""
+  echo "================================================================"
+  echo ""
+  exit 1  # BLOCK the commit
+fi
+
+exit 0

package/codeyam-cli/templates/{codeyam-debug-skill.md → codeyam:debug.md}

@@ -1,5 +1,5 @@
 ---
-name: CodeYam Debug
+name: codeyam:debug
 autoApprove: true
 description: |
   Use this skill when entity analysis or capture fails with errors.
@@ -37,6 +37,49 @@ The `codeyam init` command has already auto-approved:
 
 You can freely work with logs and update configuration without asking for permission.
 
+## Important: File Locations
+
+Understanding where files live is critical for debugging:
+
+| What                | Location                                               | Notes                                                                                                         |
+| ------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
+| **Database**        | `.codeyam/db.sqlite3`                                  | In the **original project directory** (where you ran `codeyam init`). Contains entities, analyses, scenarios. |
+| **Config**          | `.codeyam/config.json`                                 | In the **original project directory**. Universal mocks go here.                                               |
+| **LLM Calls**       | `.codeyam/llm-calls/`                                  | In the **original project directory**. JSON files recording LLM inputs/outputs for each analysis.             |
+| **Logs**            | `/tmp/codeyam/local-dev/{projectSlug}/codeyam/log.txt` | In the temp folder. Analysis and capture logs.                                                                |
+| **Generated files** | `/tmp/codeyam/local-dev/{projectSlug}/project/`        | A **copy** of your project with mock injections.                                                              |
+| **Analyzer**        | `/tmp/codeyam/local-dev/{projectSlug}/codeyam/`        | The analysis engine runtime.                                                                                  |
+
+**Common mistake:** Looking for the database in `/tmp/codeyam/local-dev/{projectSlug}/project/.codeyam/db.sqlite3` - this is a **copy** and may be empty or stale. Always query the database in the **original project directory**.
+
+### Debugging with LLM Calls
+
+The `.codeyam/llm-calls/` directory contains JSON files recording every LLM interaction during analysis. Examining these is often key to understanding why analysis produced unexpected results:
+
+```bash
+# List recent LLM calls
+ls -lt .codeyam/llm-calls/ | head -10
+
+# View a specific call (shows both the prompt sent and response received)
+cat .codeyam/llm-calls/{filename}.json | jq .
+```
+
+**What to look for:**
+
+- **Input context**: Was the right code/context sent to the LLM?
+- **Response parsing**: Did the LLM return valid JSON? Were fields missing or malformed?
+- **Scenario generation**: For scenario issues, check if the LLM generated the expected data structures
+
+**Example database query:**
+
+```bash
+# CORRECT - query the original project database
+sqlite3 /path/to/your/project/.codeyam/db.sqlite3 "SELECT id, entityName FROM analyses LIMIT 5"
+
+# WRONG - the temp copy doesn't have the real data
+sqlite3 /tmp/codeyam/local-dev/{projectSlug}/project/.codeyam/db.sqlite3 "..."
+```
+
 ## Debugging Workflow
 
 ### Step 1: Read the Error Log
@@ -44,8 +87,8 @@ You can freely work with logs and update configuration without asking for permis
 The simulation log contains all error details:
 
 ```bash
-# For local development
-tail -n 100 /tmp/codeyam/local-dev/{projectSlug}/log.txt
+# For local development (note the /codeyam/ folder in the path)
+tail -n 100 /tmp/codeyam/local-dev/{projectSlug}/codeyam/log.txt
 ```
 
 Look for:
@@ -92,7 +135,8 @@ Cannot destructure property 'entities' of 'useLoaderData()' as it is null
 This is a **SCENARIO MOCK ISSUE**, not a universal mock issue. Follow these steps:
 
 1. **Check the analysis metadata** for `scenariosDataStructure`:
-   - Query the database or check analysis records
+   - Query the database **in the original project directory** (`.codeyam/db.sqlite3`)
+   - Example: `sqlite3 .codeyam/db.sqlite3 "SELECT json_extract(analysis, '$.scenariosDataStructure') FROM analyses WHERE entityName='MyEntity'"`
    - Look for the `dataForMocks` property
    - This shows what data the analysis engine expected to mock