@codeyam/codeyam-cli 0.1.0-staging.d0ad4ae → 0.1.0-staging.d3e886e

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-YzfkRwdn.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 H,Z as I,M as J,N as K,W as L,O as _,R as $,T as rr,V as tr,U as or,X as ir,Q as pr}from"./assets/server-build-D4DT0nM_.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"v8";import"react-syntax-highlighter";import"react-syntax-highlighter/dist/cjs/styles/prism/index.js";import"node:crypto";import"minimatch";import"react-markdown";import"remark-gfm";import"react-diff-viewer-continued";export{H as allowedActionOrigins,I as assets,J as assetsBuildDirectory,K as basename,L as entry,_ as future,$ as isSpaMode,rr as prerender,tr as publicPath,or as routeDiscovery,ir as routes,pr as ssr};

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

@@ -1,7 +1,7 @@
 {
-  "buildTimestamp": "2026-01-13T17:06:14.706Z",
-  "buildTime": 1768323974706,
-  "buildNumber": 415,
-  "semanticVersion": "0.1.415",
-  "version": "0.1.415 (2026-01-13T17:06)"
+  "buildTimestamp": "2026-02-13T23:03:59.454Z",
+  "buildTime": 1771023839454,
+  "buildNumber": 645,
+  "semanticVersion": "0.1.645",
+  "version": "0.1.645 (2026-02-13T23:03)"
 }

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-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