@pikaa-ai/pikaa 0.3.11 → 0.3.13

package/dist/cli.js

@@ -6043,7 +6043,7 @@ function parsePatch(oldSrc, newSrc, contextLines = 3) {
 // package.json
 var package_default = {
   name: "@pikaa-ai/pikaa",
-  version: "0.3.11",
+  version: "0.3.13",
   description: "PIKAA CLI - AI coding agent that runs locally in your terminal.",
   main: "./dist/index.js",
   module: "./dist/index.js",
@@ -7767,7 +7767,7 @@ var __dirname = "/home/runner/work/agent-cli/agent-cli/src/mcp/servers/sqlite";
 var SQLITE_MCP_SERVER_PATH = resolve20(__dirname, "server.ts");
 
 // src/init/project-analyzer.ts
-import { existsSync as existsSync18, readFileSync as readFileSync13, readdirSync as readdirSync6, statSync as statSync4 } from "fs";
+import { existsSync as existsSync18, readFileSync as readFileSync13, readdirSync as readdirSync6 } from "fs";
 import { join as join9, basename as basename2 } from "path";
 
 class ProjectAnalyzer {
@@ -7776,23 +7776,30 @@ class ProjectAnalyzer {
     this.cwd = cwd;
   }
   analyze() {
-    const projectName = this.detectProjectName();
+    const readmeInfo = this.extractReadmeMetadata();
+    const projectName = readmeInfo.title || this.detectProjectName();
     const languages = this.detectLanguages();
     const packageManager = this.detectPackageManager();
     const frameworks = [];
+    const infrastructure = [];
     const commands = {};
+    const architectureNotes = [];
     const codeConventions = [];
-    let description;
+    let description = readmeInfo.description;
     const pkgPath = join9(this.cwd, "package.json");
     if (existsSync18(pkgPath)) {
       try {
         const pkg = JSON.parse(readFileSync13(pkgPath, "utf8"));
-        if (pkg.description)
+        if (!description && pkg.description)
           description = pkg.description;
         const pm = packageManager || "npm";
         const runPrefix = pm === "bun" || pm === "yarn" || pm === "pnpm" ? `${pm} run` : "npm run";
         const testPrefix = pm === "bun" ? "bun test" : pm === "pnpm" ? "pnpm test" : pm === "yarn" ? "yarn test" : "npm test";
         if (pkg.scripts) {
+          if (pkg.scripts.dev)
+            commands.dev = `${runPrefix} dev`;
+          else if (pkg.scripts.start)
+            commands.dev = `${runPrefix} start`;
           if (pkg.scripts.build)
             commands.build = `${runPrefix} build`;
           if (pkg.scripts.test)
@@ -7803,10 +7810,6 @@ class ProjectAnalyzer {
             commands.typecheck = `${runPrefix} check`;
           if (pkg.scripts.lint)
             commands.lint = `${runPrefix} lint`;
-          if (pkg.scripts.dev)
-            commands.dev = `${runPrefix} dev`;
-          else if (pkg.scripts.start)
-            commands.dev = `${runPrefix} start`;
           if (pkg.scripts.format)
             commands.format = `${runPrefix} format`;
         }
@@ -7824,6 +7827,8 @@ class ProjectAnalyzer {
           frameworks.push("Svelte");
         if (allDeps.astro)
           frameworks.push("Astro");
+        if (allDeps.vite)
+          frameworks.push("Vite");
         if (allDeps.express)
           frameworks.push("Express");
         if (allDeps.hono)
@@ -7834,6 +7839,16 @@ class ProjectAnalyzer {
           frameworks.push("NestJS");
         if (allDeps.tailwindcss)
           frameworks.push("TailwindCSS");
+        if (allDeps["lucide-react"] || allDeps.lucide)
+          frameworks.push("Lucide Icons");
+        if (allDeps.zustand)
+          frameworks.push("Zustand");
+        if (allDeps["@tanstack/react-query"])
+          frameworks.push("TanStack Query");
+        if (allDeps.oxlint)
+          frameworks.push("Oxlint");
+        if (allDeps.eslint)
+          frameworks.push("ESLint");
         if (allDeps.vitest)
           frameworks.push("Vitest");
         if (allDeps.jest)
@@ -7841,9 +7856,7 @@ class ProjectAnalyzer {
         if (allDeps.playwright || allDeps["@playwright/test"])
           frameworks.push("Playwright");
         if (pkg.type === "module") {
-          codeConventions.push('ES Modules enabled (`"type": "module"`)');
-        } else {
-          codeConventions.push("CommonJS module format");
+          codeConventions.push("Use ES modules (`import/export`), not CommonJS (`require`).");
         }
       } catch {}
     }
@@ -7852,7 +7865,7 @@ class ProjectAnalyzer {
       try {
         const tsconfig = JSON.parse(readFileSync13(tsconfigPath, "utf8"));
         if (tsconfig.compilerOptions?.strict) {
-          codeConventions.push("TypeScript Strict Mode enabled");
+          codeConventions.push("TypeScript strict mode enabled.");
         }
         if (!commands.typecheck) {
           commands.typecheck = "tsc --noEmit";
@@ -7862,34 +7875,21 @@ class ProjectAnalyzer {
     const cargoPath = join9(this.cwd, "Cargo.toml");
     if (existsSync18(cargoPath)) {
       try {
-        const content = readFileSync13(cargoPath, "utf8");
+        commands.dev = commands.dev || "cargo run";
         commands.build = commands.build || "cargo build";
         commands.test = commands.test || "cargo test";
         commands.lint = commands.lint || "cargo clippy";
-        commands.dev = commands.dev || "cargo run";
-        if (content.includes('edition = "2021"')) {
-          codeConventions.push("Rust 2021 Edition");
-        }
-        if (content.includes("tokio"))
-          frameworks.push("Tokio (Async Runtime)");
-        if (content.includes("axum"))
-          frameworks.push("Axum");
-        if (content.includes("actix-web"))
-          frameworks.push("Actix-Web");
+        frameworks.push("Rust Cargo");
       } catch {}
     }
     const goModPath = join9(this.cwd, "go.mod");
     if (existsSync18(goModPath)) {
       try {
-        const content = readFileSync13(goModPath, "utf8");
+        commands.dev = commands.dev || "go run .";
         commands.build = commands.build || "go build ./...";
         commands.test = commands.test || "go test ./...";
         commands.lint = commands.lint || "golangci-lint run";
-        commands.dev = commands.dev || "go run .";
-        const goVer = content.match(/go\s+(\d+\.\d+)/);
-        if (goVer?.[1]) {
-          codeConventions.push(`Go ${goVer[1]}`);
-        }
+        frameworks.push("Go Modules");
       } catch {}
     }
     const pyprojectPath = join9(this.cwd, "pyproject.toml");
@@ -7897,16 +7897,44 @@ class ProjectAnalyzer {
     if (existsSync18(pyprojectPath) || existsSync18(requirementsPath)) {
       commands.test = commands.test || "pytest";
       commands.lint = commands.lint || "ruff check .";
-      commands.format = commands.format || "black .";
       if (existsSync18(join9(this.cwd, "uv.lock"))) {
-        codeConventions.push("uv package & project manager");
+        frameworks.push("uv");
         commands.test = "uv run pytest";
       } else if (existsSync18(join9(this.cwd, "poetry.lock"))) {
-        codeConventions.push("Poetry dependency manager");
+        frameworks.push("Poetry");
         commands.test = "poetry run pytest";
       }
     }
-    const directoryStructure = this.scanDirectoryStructure();
+    if (existsSync18(join9(this.cwd, "Dockerfile"))) {
+      infrastructure.push("Docker");
+      const sanitizedName = projectName.toLowerCase().replace(/[^a-z0-9_-]/g, "-").replace(/^-+|-+$/g, "");
+      commands.dockerBuild = `docker build -t ${sanitizedName || "app"} .`;
+    }
+    if (existsSync18(join9(this.cwd, "nginx.conf"))) {
+      infrastructure.push("Nginx");
+    }
+    if (existsSync18(join9(this.cwd, "src/api.ts")) || existsSync18(join9(this.cwd, "src/api"))) {
+      architectureNotes.push("Backend API endpoints and network client logic are centralized in `src/api`.");
+    }
+    if (existsSync18(join9(this.cwd, "src/components"))) {
+      architectureNotes.push("Reusable UI presentation components live in `src/components/`.");
+    }
+    if (existsSync18(join9(this.cwd, "src/types.ts")) || existsSync18(join9(this.cwd, "src/types"))) {
+      architectureNotes.push("Shared TypeScript data models and interfaces are defined in `src/types`.");
+    }
+    if (existsSync18(join9(this.cwd, ".env.example"))) {
+      architectureNotes.push("Environment configuration template is in `.env.example`.");
+    }
+    if (commands.typecheck || commands.lint || commands.test) {
+      const checks = [];
+      if (commands.typecheck)
+        checks.push(`typecheck (\`${commands.typecheck}\`)`);
+      if (commands.lint)
+        checks.push(`lint (\`${commands.lint}\`)`);
+      if (commands.test)
+        checks.push(`tests (\`${commands.test}\`)`);
+      codeConventions.push(`Run ${checks.join(" and ")} before concluding any major code edits.`);
+    }
     const instructionFiles = ["AGENTS.md", "CLAUDE.md", ".agents.md", "AGENTS.override.md"];
     let hasExistingInstructions = false;
     let existingInstructionFile;
@@ -7923,8 +7951,9 @@ class ProjectAnalyzer {
       languages,
       packageManager,
       frameworks,
+      infrastructure,
       commands,
-      directoryStructure,
+      architectureNotes,
       codeConventions,
       hasExistingInstructions,
       existingInstructionFile
@@ -7938,21 +7967,11 @@ class ProjectAnalyzer {
       lines.push(`> ${analysis.description}`);
       lines.push("");
     }
-    lines.push("## Tech Stack");
-    lines.push("");
-    if (analysis.languages.length > 0) {
-      lines.push(`- **Languages**: ${analysis.languages.join(", ")}`);
-    }
-    if (analysis.packageManager) {
-      lines.push(`- **Package Manager**: ${analysis.packageManager}`);
-    }
-    if (analysis.frameworks.length > 0) {
-      lines.push(`- **Frameworks & Libraries**: ${analysis.frameworks.join(", ")}`);
-    }
-    lines.push("");
-    lines.push("## Development Commands");
+    lines.push("## Commands");
     lines.push("");
     if (Object.keys(analysis.commands).length > 0) {
+      if (analysis.commands.dev)
+        lines.push(`- **Dev Server**: \`${analysis.commands.dev}\``);
       if (analysis.commands.build)
         lines.push(`- **Build**: \`${analysis.commands.build}\``);
       if (analysis.commands.test)
@@ -7961,44 +7980,77 @@ class ProjectAnalyzer {
         lines.push(`- **Typecheck**: \`${analysis.commands.typecheck}\``);
       if (analysis.commands.lint)
         lines.push(`- **Lint**: \`${analysis.commands.lint}\``);
-      if (analysis.commands.dev)
-        lines.push(`- **Dev / Run**: \`${analysis.commands.dev}\``);
       if (analysis.commands.format)
         lines.push(`- **Format**: \`${analysis.commands.format}\``);
+      if (analysis.commands.dockerBuild)
+        lines.push(`- **Docker Build**: \`${analysis.commands.dockerBuild}\``);
     } else {
       lines.push("- *No standard build/test commands detected.*");
     }
     lines.push("");
-    lines.push("## Architecture & Directory Structure");
+    lines.push("## Architecture & Stack");
     lines.push("");
-    if (Object.keys(analysis.directoryStructure).length > 0) {
-      for (const [dir, purpose] of Object.entries(analysis.directoryStructure)) {
-        lines.push(`- \`${dir}\`: ${purpose}`);
-      }
-    } else {
-      lines.push("- Root project workspace");
+    const stackItems = [];
+    if (analysis.languages.length > 0)
+      stackItems.push(analysis.languages.join(", "));
+    if (analysis.frameworks.length > 0)
+      stackItems.push(analysis.frameworks.join(", "));
+    if (analysis.infrastructure.length > 0)
+      stackItems.push(analysis.infrastructure.join(", "));
+    if (stackItems.length > 0) {
+      lines.push(`- **Core Stack**: ${stackItems.join(" \u2022 ")}`);
+    }
+    for (const note of analysis.architectureNotes) {
+      lines.push(`- ${note}`);
     }
     lines.push("");
-    lines.push("## Code Style & Guidelines");
+    lines.push("## Workflow & Code Guidelines");
     lines.push("");
     if (analysis.codeConventions.length > 0) {
       for (const conv of analysis.codeConventions) {
         lines.push(`- ${conv}`);
       }
     }
-    lines.push("- Keep functions focused and modular.");
-    lines.push("- Maintain clean error handling and avoid unhandled exceptions.");
-    lines.push("- Run automated test suite before completing major code changes.");
+    lines.push("- Prefer targeted edits over whole-file rewrites.");
+    lines.push("- When fixing errors, address the root cause rather than suppressing compiler warnings.");
     lines.push("");
     return lines.join(`
 `);
   }
+  extractReadmeMetadata() {
+    const readmeFiles = ["README.md", "readme.md", "README.MD"];
+    for (const file of readmeFiles) {
+      const fullPath = join9(this.cwd, file);
+      if (existsSync18(fullPath)) {
+        try {
+          const content = readFileSync13(fullPath, "utf8");
+          const lines = content.split(`
+`);
+          let title;
+          let description;
+          for (const line of lines) {
+            const trimmed = line.trim();
+            if (!title && trimmed.startsWith("# ")) {
+              title = trimmed.replace(/^#\s+/, "").trim();
+              continue;
+            }
+            if (title && !description && trimmed.length > 0 && !trimmed.startsWith("#") && !trimmed.startsWith("```") && !trimmed.startsWith("[")) {
+              description = trimmed;
+              break;
+            }
+          }
+          return { title, description };
+        } catch {}
+      }
+    }
+    return {};
+  }
   detectProjectName() {
     const pkgPath = join9(this.cwd, "package.json");
     if (existsSync18(pkgPath)) {
       try {
         const pkg = JSON.parse(readFileSync13(pkgPath, "utf8"));
-        if (pkg.name) {
+        if (pkg.name && pkg.name !== "frontend" && pkg.name !== "backend" && pkg.name !== "app") {
           return pkg.name.startsWith("@") ? pkg.name.split("/")[1] || pkg.name : pkg.name;
         }
       } catch {}
@@ -8067,46 +8119,6 @@ class ProjectAnalyzer {
       return "npm";
     return;
   }
-  scanDirectoryStructure() {
-    const structure = {};
-    const commonDirPurposes = {
-      src: "Core application source code and business logic",
-      lib: "Shared libraries, utilities, and helper modules",
-      tests: "Automated unit and integration test suites",
-      test: "Automated test suite",
-      dist: "Compiled production distribution output",
-      build: "Compiled build artifacts",
-      docs: "Documentation and architectural specifications",
-      pkg: "Reusable public Go/Rust/JS packages",
-      cmd: "Main application CLI commands and entry points",
-      bin: "CLI executable launcher scripts and binaries",
-      templates: "Prompt and code generator templates",
-      components: "Reusable UI components",
-      app: "Application pages and routing handlers",
-      pages: "Page views and route controllers",
-      api: "Backend API endpoints and server routes",
-      public: "Static public assets and web resources",
-      assets: "Media assets, icons, and graphic resources",
-      scripts: "Build automation, CI helpers, and deployment scripts",
-      config: "Application configuration files",
-      storage: "Local databases, caches, and persistent state files"
-    };
-    try {
-      const entries = readdirSync6(this.cwd);
-      for (const entry of entries) {
-        if (entry.startsWith(".") || entry === "node_modules" || entry === "target")
-          continue;
-        const fullPath = join9(this.cwd, entry);
-        try {
-          if (statSync4(fullPath).isDirectory()) {
-            const purpose = commonDirPurposes[entry.toLowerCase()] || `Directory for ${entry} modules`;
-            structure[`${entry}/`] = purpose;
-          }
-        } catch {}
-      }
-    } catch {}
-    return structure;
-  }
   hasFileWithExtension(...exts) {
     try {
       const entries = readdirSync6(this.cwd);
@@ -8282,8 +8294,15 @@ async function handleSlashCommand(input, ctx) {
 `);
       return true;
     case "/init":
-      const initResult = runProjectInit({ cwd: ctx.session.cwd });
-      printInitSummary(initResult);
+      console.log(`
+  \x1B[38;2;217;119;87m\u2733 Initializing project instructions via AI agent...\x1B[0m
+`);
+      if (ctx.repl) {
+        await ctx.repl.submitTurn("Analyze this codebase and create or update the AGENTS.md project instruction file in the workspace root following Claude Code best practices. Inspect key config files (package.json, tsconfig, etc.), test/build scripts, and main source directories to discover exact development commands, architectural conventions, and workflow requirements. Write the finalized AGENTS.md using the write_file tool.");
+      } else {
+        const initResult = runProjectInit({ cwd: ctx.session.cwd });
+        printInitSummary(initResult);
+      }
       return true;
     case "/agents":
       printAgents(ctx);
@@ -9934,24 +9953,27 @@ class CliRepl {
           continue;
         }
       }
-      try {
-        const turnPromise = new Promise((resolve21) => {
-          this.turnDoneResolver = resolve21;
-        });
-        await this.session.submit({
-          type: "TurnInput",
-          request: {
-            text: line
-          }
-        });
-        await turnPromise;
-      } catch (err) {
-        console.error(style.red(`Failed to submit turn: ${err instanceof Error ? err.message : String(err)}
-`));
-      }
+      await this.submitTurn(line);
     }
     await this.close();
   }
+  async submitTurn(text) {
+    try {
+      const turnPromise = new Promise((resolve21) => {
+        this.turnDoneResolver = resolve21;
+      });
+      await this.session.submit({
+        type: "TurnInput",
+        request: {
+          text
+        }
+      });
+      await turnPromise;
+    } catch (err) {
+      console.error(style.red(`Failed to submit turn: ${err instanceof Error ? err.message : String(err)}
+`));
+    }
+  }
   async close() {
     if (this.isClosed)
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikaa-ai/pikaa",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "description": "PIKAA CLI - AI coding agent that runs locally in your terminal.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",