takomi 2.0.5 → 2.0.7

package/assets/.agent/workflows/spawn-jstar-code-review.md

@@ -1,121 +1,161 @@
----
-description: Spawn J Star Code Review bot into the current repository
----
-
-# /spawn-jstar - Add J Star Reviewer v2 to Any Project
-
-Works with **any programming language** — TypeScript, Python, Rust, Go, etc.
-
-## Prerequisites
-- Node.js 18+ installed on your machine
-
-## Steps
-
-### 1. Install the CLI Globally (One Time) use pnpm by default else revert to npm
-// turbo
-```bash
-pnpm install -g jstar-reviewer
-```
-
-### 2. Run your First Command
-// turbo
-```bash
-jstar setup
-```
-*(Or simply run `jstar review` if you already have your keys ready)*
-
-This **auto-creates** (or updates):
-- `.jstar/` directory
-- `.env.example` with required variables
-- `.gitignore` (appends `.jstar/` and `.env.local`)
-
-
-### 3. Configure Environment Variables
-```bash
-cp .env.example .env.local
-```
-
-Edit `.env.local` and add your API keys:
-```env
-GEMINI_API_KEY=your_gemini_api_key_here
-GROQ_API_KEY=your_groq_api_key_here
-```
-
-**Where to get keys:**
-- Google API Key: [Google AI Studio](https://aistudio.google.com/apikey)
-- Groq API Key: [console.groq.com](https://console.groq.com)
-
-### 4. Index Your Codebase (Build the Brain)
-```bash
-jstar init
-```
-
-This scans your codebase and creates embeddings for context-aware reviews.
-
-### 5. (Optional) Create Rules File
-Create `.jstar/rules.md` with your project-specific coding guidelines:
-
-```markdown
-# Project Coding Rules
-
-## General
-- Follow PEP 8 (Python) / Google Style Guide
-- Add docstrings to all public functions
-
-
-
-## Security  
-- Never log sensitive data
-- Validate all user inputs
-```
-
-### 6. Understanding Review Modes
-Before running a review, understand the available modes:
-
-| Mode | Command | Best For |
-| :--- | :--- | :--- |
-| **Standard** | `jstar review` | checking staged changes *before* committing. |
-| **Retroactive** | `jstar review --last` | checking the *last commit* (if you forgot to review). |
-| **Pull Request** | `jstar review --pr` | checking an entire feature branch against `main`. |
-
-### 7. Run Your First Review
-
-**Agent Instruction:** Ask the user: *"Would you like to run the review yourself, or should I run a headless check for you?"*
-
-#### Option A: User Runs It (Recommended)
-The user runs the interactive TUI command in their terminal:
-```bash
-jstar review
-```
-
-#### Option B: Agent Runs It (Headless)
-If the user asks YOU to do it, use the headless flag to avoid hanging:
-// turbo
-```bash
-jstar review --headless
-```
-*(This outputs JSON-formatted results that you can parse)*
-
-The dashboard will be saved to `.jstar/last-review.md`.
-
-## Done! 🎉
-
-**CLI Commands:**
-| Command | Description |
-|---------|-------------|
-| `jstar setup` | Create config files in current project |
-| `jstar init` | Index codebase (after major changes) |
-| `jstar review` | Review staged changes (Default) |
-| `jstar review --last` | Review last commit (Retroactive) |
-| `jstar review --pr` | Review branch against main (PR Mode) |
-
-**Output:**
-- Console: Quick summary with severity counts
-- `.jstar/last-review.md`: Full dashboard with fix prompts
-
-## Alternative: Without Global Install
-
-If you don't want to install globally:
-```bash
-npx jstar-reviewer review
-```
+---
+description: Install J-Star Reviewer in the current repository and set up the up-to-date review and audit flows.
+---
+
+# /spawn-jstar - Install J-Star Reviewer in This Repository
+
+Use this workflow to install the `jstar-reviewer` npm package and wire the repository for both code review and security audit.
+
+## Core Rule
+
+`review` and `audit` are separate steps.
+
+For a serious verification pass, run both. Do not present one as a substitute for the other.
+
+## Command Prefix
+
+Examples below use `jstar`.
+
+If you do not want a global install, replace `jstar` with `npx jstar-reviewer`.
+
+## 1. Prerequisites
+
+- Node.js 18+
+- Git repository
+- Gemini API key
+- Groq API key
+
+## 2. Install the CLI
+
+Preferred:
+
+```bash
+pnpm add -g jstar-reviewer
+```
+
+Fallback:
+
+```bash
+npm install -g jstar-reviewer
+```
+
+No global install:
+
+```bash
+npx jstar-reviewer --help
+```
+
+## 3. Set Up the Repository
+
+```bash
+jstar setup
+```
+
+This should create or update:
+- `.jstar/`
+- `.env.example`
+- `.gitignore`
+
+## 4. Create `.env.local`
+
+PowerShell:
+
+```powershell
+Copy-Item .env.example .env.local
+```
+
+POSIX shell:
+
+```bash
+cp .env.example .env.local
+```
+
+Required variables:
+
+```env
+GEMINI_API_KEY=your_gemini_key
+GROQ_API_KEY=your_groq_key
+```
+
+Optional but useful:
+
+```env
+GEMINI_EMBEDDING_MODEL=gemini-embedding-001
+REVIEW_MODEL_NAME=moonshotai/kimi-k2-instruct-0905
+```
+
+## 5. Build the Local Index
+
+```bash
+jstar init
+```
+
+If indexing fails with a Google 404 for the embedding model, set:
+
+```env
+GEMINI_EMBEDDING_MODEL=gemini-embedding-001
+```
+
+## 6. First Verification Pass
+
+### Option A: Interactive user flow
+
+```bash
+jstar review
+jstar audit
+```
+
+Use this when the user wants the normal CLI/TUI experience.
+
+### Option B: Agent automation flow
+
+```bash
+jstar review --json > .jstar/last-review.json
+jstar audit --json > .jstar/audit_report.json
+```
+
+Use this when an agent needs machine-readable output.
+
+### Option C: Review debate flow
+
+```bash
+jstar chat --headless
+```
+
+Headless commands:
+- `{"action":"list"}`
+- `{"action":"debate","issueId":0,"argument":"..."}`
+- `{"action":"ignore","issueId":0}`
+- `{"action":"accept","issueId":0}`
+- `{"action":"exit"}`
+
+## 7. Common Target Modes
+
+Staged changes:
+
+```bash
+jstar review
+jstar audit
+```
+
+Last commit:
+
+```bash
+jstar review --last
+jstar audit --last
+```
+
+Branch or PR scope:
+
+```bash
+jstar review --pr
+jstar audit --pr
+```
+
+## Outputs
+
+- `.jstar/last-review.md`
+- `.jstar/session.json`
+- `.jstar/audit_report.md`
+- `.jstar/audit_report.json`
+- `.jstar/audit-ignore.json`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "takomi",
-  "version": "2.0.5",
-  "description": "🎯 Stop wrestling with AI. Start building with purpose. The artisan's toolkit that transforms AI from chatbot to development partner.",
+  "version": "2.0.7",
+  "description": "🎯 Stop wrestling with AI. Start building with purpose. The artisan's toolkit for agent workflows, Codex skills, and original Takomi capabilities like 21st.dev integration.",
   "type": "module",
   "bin": {
     "takomi": "./bin/takomi.js"
@@ -21,13 +21,17 @@
   "keywords": [
     "takomi",
     "ai",
+    "skills",
+    "codex",
+    "agentic",
+    "21st.dev",
     "vibecode",
     "cursor",
     "windsurf",
     "protocols"
   ],
   "author": "J StaR Films Studios",
-  "license": "ISC",
+  "license": "UNLICENSED",
   "dependencies": {
     "commander": "^13.1.0",
     "figlet": "^1.8.0",

package/src/cli.js

@@ -160,11 +160,11 @@ async function init() {
       // Handle Skills
       if (response.skillMode === 'core') {
         console.log(pc.green('✔ Downloading Core Skills...'));
-        const coreSkills = [
-          'takomi',
-          'ai-sdk', 'code-review', 'component-analysis',
-          'nextjs-standards', 'security-audit', 'spawn-task',
-          'stitch', 'sync-docs'
+        const coreSkills = [
+          'takomi',
+          'ai-sdk', 'code-review', 'component-analysis',
+          'nextjs-standards', 'security-audit', 'spawn-task',
+          'stitch', 'sync-docs'
         ];
         await copySpecificSkills(coreSkills, skillsDest);
       } else if (response.skillMode === 'all') {
@@ -220,7 +220,7 @@ async function install() {
 
   if (detected.length === 0) {
     console.log(pc.yellow('  No AI harnesses detected on this machine.'));
-    console.log(pc.dim('  We support: Antigravity, KiloCode, Windsurf, Cursor, Gemini CLI'));
+    console.log(pc.dim('  We support: Antigravity, KiloCode, Windsurf, Codex, Cursor, Gemini CLI'));
     console.log(pc.dim('  Run "takomi init" instead for per-project setup.\n'));
     return;
   }
@@ -535,7 +535,7 @@ async function harnesses() {
 program
   .name('takomi')
   .description('Your AI team. Activated. 🎯')
-  .version('2.0.0');
+  .version('2.0.7');
 
 // Per-project setup (backward compatible)
 program

package/src/harness.js

@@ -73,6 +73,19 @@ export const HARNESS_MAP = {
     },
   },
 
+  codex: {
+    name: 'Codex',
+    rootPath: path.join(HOME, '.codex'),
+    detect() {
+      return fs.existsSync(this.rootPath);
+    },
+    targets: {
+      skills: path.join(HOME, '.codex', 'skills'),
+      workflows: null,
+      yamls: null,
+    },
+  },
+
   cursor: {
     name: 'Cursor',
     rootPath: path.join(HOME, '.cursor'),