@sumant.pathak/devjar 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sumnt Pathak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,125 @@
+# devjar
+
+Scan your project into a Claude-ready knowledge map. Rewrite vague prompts into structured ones. Use 60–70% fewer tokens on any AI coding tool.
+
+---
+
+Every Claude Code session starts blind. You re-explain the same context, re-read the same files, burn tokens on clarification. devjar fixes both.
+
+---
+
+## Quick start
+
+```bash
+npm install -g devjar
+cd your-project
+devjar init
+```
+
+Your project is now mapped. Claude reads `CLAUDE.md` at session start and never re-reads your files again.
+
+For prompt normalization, pick a provider once:
+
+```bash
+ollama pull llama3.2          # free, runs locally
+devjar config --provider ollama --model llama3.2
+devjar prompt "fix login bug"
+```
+
+---
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `devjar init` | Scan project → generate `CLAUDE.md` (stack, file map, rules) |
+| `devjar prompt "text"` | Rewrite vague input into STAR-C format, copy to clipboard |
+| `devjar update` | Regenerate `CLAUDE.md` after major changes |
+| `devjar update --watch` | Live watcher — updates file map on every save |
+| `devjar stats` | Token savings estimate, streak, per-project breakdown |
+| `devjar config` | Set AI provider, or run setup wizard |
+
+---
+
+## Provider setup
+
+**Ollama — free, local, no account needed (recommended)**
+
+```bash
+# Install from https://ollama.com, then:
+ollama pull llama3.2
+devjar config --provider ollama --model llama3.2
+```
+
+**Cloud providers**
+
+```bash
+devjar config --provider gemini    --key AIza...    # free tier at aistudio.google.com
+devjar config --provider anthropic --key sk-ant-...
+devjar config --provider openai    --key sk-...
+```
+
+First time you run `devjar prompt` with no config, the setup wizard runs automatically.
+
+---
+
+## What it looks like
+
+```
+$ devjar init
+⬡ devjar init → /your-project
+────────────────────────────────────────────────────
+Phase 1  Scanning project structure...
+  ✓ 115 files | Stack: React + Vite
+Phase 2  Pattern extraction via Haiku...
+  ✓ 5 rules extracted from 4 key files
+Phase 3  Writing CLAUDE.md...
+────────────────────────────────────────────────────
+✓ CLAUDE.md generated — 115 files scanned, 5 rules extracted
+  → /your-project/CLAUDE.md
+```
+
+```
+$ devjar prompt "login not working after deploy"
+⬡ devjar prompt
+────────────────────────────────────────────────────
+  Provider: ollama/llama3.2
+  Input:    login not working after deploy
+  ✓ CLAUDE.md loaded (7236 chars)
+
+─── STAR-C Prompt ───────────────────────────────────
+S — care-home — React + Vite, auth via httpOnly cookie
+T — Debug login failure introduced after deployment
+A — Check src/routes/auth.js COOKIE_OPTIONS (SameSite attr)
+    Verify KV session creation on login success
+R — Login succeeds, sc_token cookie set, /api/auth/me returns user
+C — Don't change PBKDF2 iterations (CF Workers hard cap: 100k)
+    Don't rotate JWT_SECRET without flushing KV sessions
+────────────────────────────────────────────────────
+
+Copy to clipboard? (Y/n) y
+✓ Copied
+```
+
+---
+
+## How it works
+
+`devjar init` walks your project, reads `package.json` + config files, then sends 3–5 key files to your AI provider and extracts naming conventions, patterns, and 5 unbreakable rules. Writes everything to `CLAUDE.md`.
+
+`devjar prompt` sends your vague input + your `CLAUDE.md` to your provider. Gets back a structured prompt with the exact files to check, expected result, and constraints inferred from your codebase. One provider call ≈ $0.00 with Ollama.
+
+---
+
+## Requirements
+
+- Node.js 18+
+- `devjar init` — fully offline, no provider needed
+- `devjar prompt` — Ollama (free) or any cloud API key
+- `devjar stats` / `devjar update` — fully offline
+
+---
+
+## License
+
+MIT

package/bin/devjar.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { init } from '../src/init.js';
+import { prompt } from '../src/prompt.js';
+import { update } from '../src/update.js';
+import { stats } from '../src/stats.js';
+import { configCommand } from '../src/config.js';
+
+const program = new Command();
+
+program
+  .name('devjar')
+  .description('Jarvis CLI — scan projects, normalize prompts, watch files, track tokens')
+  .version('0.1.0');
+
+program
+  .command('init [dir]')
+  .description('Scan project and build Jarvis knowledge map')
+  .option('-o, --output <file>', 'output map file', 'jarvis-map.txt')
+  .option('--depth <n>', 'max directory depth to scan', '4')
+  .action(init);
+
+program
+  .command('prompt <text...>')
+  .description('Normalize a prompt into STAR-C format')
+  .option('--copy', 'copy result to clipboard')
+  .option('--inject', 'inject into Claude Code session context')
+  .action(prompt);
+
+program
+  .command('update [dir]')
+  .description('Regenerate CLAUDE.md, or watch for live updates with --watch')
+  .option('--watch', 'watch for file changes and update live')
+  .option('--depth <n>', 'max directory depth to scan', '2')
+  .option('--debounce <ms>', 'debounce delay in ms for watch mode', '500')
+  .action(update);
+
+program
+  .command('stats')
+  .description('Show prompt history and estimated token savings')
+  .option('--reset', 'clear all history')
+  .option('--json', 'output raw JSON')
+  .action(stats);
+
+program
+  .command('config')
+  .description('Set AI provider (ollama/anthropic/gemini/openai) or run setup wizard')
+  .option('--provider <name>', 'provider name: ollama, anthropic, gemini, openai')
+  .option('--model <name>',    'model name (e.g. llama3.2, gpt-4o-mini)')
+  .option('--key <apikey>',    'API key for cloud providers')
+  .option('--url <url>',       'custom Ollama base URL (default: http://localhost:11434)')
+  .option('--show',            'show current config')
+  .action(configCommand);
+
+program.parse();

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@sumant.pathak/devjar",
+  "version": "1.0.0",
+  "description": "Scan your project into a Claude-ready knowledge map. Use 60-70% fewer tokens on any AI coding tool.",
+  "type": "module",
+  "bin": {
+    "devjar": "bin/devjar.js"
+  },
+  "scripts": {
+    "start": "node bin/devjar.js"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "chalk": "^5.6.2",
+    "chokidar": "^5.0.0",
+    "clipboardy": "^5.3.1",
+    "commander": "^12.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "claude",
+    "ai",
+    "prompt",
+    "developer-tools",
+    "ollama",
+    "token",
+    "cli",
+    "jarvis",
+    "star-c",
+    "token-tracker"
+  ],
+  "license": "MIT"
+}

package/src/config.js

@@ -0,0 +1,103 @@
+// devjar config — provider setup, wizard, config display
+
+import readline from 'readline';
+import chalk from 'chalk';
+import { loadConfig, saveConfig } from './providers/index.js';
+
+const PROVIDERS = {
+  1: { name: 'ollama',    label: 'Ollama       (free, local, recommended)', defaultModel: 'llama3.2',               needsKey: false },
+  2: { name: 'anthropic', label: 'Anthropic    (API key required)',          defaultModel: 'claude-haiku-4-5-20251001', needsKey: true },
+  3: { name: 'gemini',    label: 'Gemini       (free tier available)',       defaultModel: 'gemini-2.0-flash',       needsKey: true },
+  4: { name: 'openai',    label: 'OpenAI       (API key required)',          defaultModel: 'gpt-4o-mini',            needsKey: true },
+};
+
+function ask(rl, question) {
+  return new Promise(resolve => rl.question(question, ans => resolve(ans.trim())));
+}
+
+export async function runWizard() {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  console.log(chalk.bold.blue('⬡ devjar') + chalk.gray(' — first run setup'));
+  console.log(chalk.gray('─'.repeat(52)));
+  console.log(chalk.white('Which AI provider do you want to use?\n'));
+
+  for (const [num, p] of Object.entries(PROVIDERS)) {
+    const tag = num === '1' ? chalk.green(' ← default') : '';
+    console.log(`  ${chalk.cyan(num + '.')} ${p.label}${tag}`);
+  }
+
+  console.log();
+  const choice = await ask(rl, chalk.bold('Enter number') + chalk.gray(' [1]: ')) || '1';
+  const provider = PROVIDERS[choice] || PROVIDERS[1];
+
+  let apiKey = '';
+  if (provider.needsKey) {
+    console.log(chalk.gray(`\n  ${provider.name} requires an API key.`));
+    apiKey = await ask(rl, chalk.bold('  Paste API key: '));
+    if (!apiKey) {
+      console.log(chalk.yellow('  No key entered — switching to Ollama.'));
+      rl.close();
+      return runWizard(); // restart with ollama default path
+    }
+  }
+
+  rl.close();
+
+  const cfg = { provider: provider.name, model: provider.defaultModel, ...(apiKey && { apiKey }) };
+  saveConfig(cfg);
+
+  console.log();
+  console.log(chalk.green('✓ Configured: ') + chalk.white(`${provider.name} / ${provider.defaultModel}`));
+  if (provider.name === 'ollama') {
+    console.log(chalk.gray('  Make sure Ollama is running: ') + chalk.cyan('ollama serve'));
+    console.log(chalk.gray('  Pull model if needed:        ') + chalk.cyan(`ollama pull ${provider.defaultModel}`));
+  }
+  console.log();
+
+  return cfg;
+}
+
+export async function configCommand(options) {
+  // devjar config --show
+  if (options.show) {
+    const cfg = loadConfig();
+    if (!cfg) {
+      console.log(chalk.yellow('No config found.') + chalk.gray(' Run `devjar config` to set up.'));
+      return;
+    }
+    console.log(chalk.bold.blue('⬡ devjar') + chalk.gray(' config'));
+    console.log(chalk.gray('─'.repeat(52)));
+    console.log(chalk.gray('  Provider: ') + chalk.cyan(cfg.provider));
+    console.log(chalk.gray('  Model:    ') + chalk.white(cfg.model));
+    if (cfg.apiKey) console.log(chalk.gray('  API Key:  ') + chalk.white(cfg.apiKey.slice(0, 8) + '••••••••'));
+    if (cfg.ollamaUrl) console.log(chalk.gray('  Ollama:   ') + chalk.white(cfg.ollamaUrl));
+    return;
+  }
+
+  // devjar config --provider X --model Y --key Z
+  if (options.provider) {
+    const known = Object.values(PROVIDERS).map(p => p.name);
+    if (!known.includes(options.provider)) {
+      console.log(chalk.red(`Unknown provider "${options.provider}".`) + chalk.gray(` Choose: ${known.join(', ')}`));
+      process.exit(1);
+    }
+
+    const existing = loadConfig() || {};
+    const defaultModel = Object.values(PROVIDERS).find(p => p.name === options.provider)?.defaultModel;
+    const cfg = {
+      ...existing,
+      provider: options.provider,
+      model: options.model || existing.model || defaultModel,
+      ...(options.key && { apiKey: options.key }),
+      ...(options.url && { ollamaUrl: options.url }),
+    };
+    saveConfig(cfg);
+
+    console.log(chalk.green('✓ Saved: ') + chalk.white(`${cfg.provider} / ${cfg.model}`));
+    return;
+  }
+
+  // No flags — run wizard
+  await runWizard();
+}