gramatr 0.3.47 → 0.3.49

package/README.md

@@ -1,78 +1,108 @@
-# grāmatr Client Package
+# gramatr
 
-This package contains the shared grāmatr client runtime plus per-target adapters.
+**Intelligence layer for AI coding agents.** Pre-classifies every request so Claude Code, Codex, and Gemini CLI spend tokens on your work, not on routing overhead.
 
-Current target model:
+## What it does
 
-- local / thick-client targets
-  - `claude-code`
-  - `codex`
-- hosted / remote targets
-  - `remote-mcp`
-  - `claude-web`
-  - `chatgpt-web`
+gramatr sits between you and your AI agent. Before the agent sees your prompt, gramatr's decision router (BERT classifiers running in <5ms) pre-classifies:
 
-The important distinction is that hosted targets are not local hook installs. They use remote MCP or future hosted-client packaging.
+- **Effort level** — instant, fast, standard, extended, advanced, deep, comprehensive
+- **Intent type** — search, retrieve, create, update, analyze, generate
+- **Skill matching** — which of 25 capabilities are relevant
+- **Memory tier** — what context to pre-load from your knowledge graph
+- **Reverse engineering** — what you want, what you don't want, gotchas
 
-## CLI
+The agent receives this as a pre-computed intelligence packet, saving ~2,700 tokens per request that would otherwise be spent on the agent figuring out what you need.
 
-The package exposes a `gramatr` CLI:
+## Install
 
 ```bash
-gramatr install
-gramatr install claude-code
-gramatr install codex
-gramatr install all
-gramatr detect
-gramatr doctor
-gramatr migrate
-gramatr migrate --apply
-gramatr upgrade
+npx gramatr install claude-code
 ```
 
-## Command Behavior
+That's it. One command installs hooks, registers the MCP server, and configures your AI agent.
 
-- `gramatr install`
-  - interactive local target selection
-  - installs local adapter(s)
-  - prints remote target guidance separately
-- `gramatr detect`
-  - reports detected local targets and known hosted targets
-- `gramatr doctor`
-  - reports current target detection, payload presence, and stale legacy artifacts
-- `gramatr migrate`
-  - dry-run legacy cleanup and Claude config sanitization
-- `gramatr migrate --apply`
-  - applies legacy cleanup and configuration sanitization
-- `gramatr upgrade`
-  - performs migration cleanup when needed, then re-syncs detected local targets
+### Non-interactive (CI, remote provisioning)
 
-## Thin-Client Default
+```bash
+npx gramatr install claude-code --yes --name "Your Name" --timezone "America/Chicago"
+```
 
-Claude installs now default to the thin-client hook set.
+### Supported platforms
 
-Optional Claude UX hooks are disabled by default and can be enabled with:
+| Platform | Status | Install |
+|---|---|---|
+| Claude Code | Stable | `npx gramatr install claude-code` |
+| OpenAI Codex | Stable | Auto-detected during install |
+| Google Gemini CLI | Stable | Auto-detected during install |
+| Claude Desktop | Coming soon | — |
+| ChatGPT Desktop | Coming soon | — |
 
-```bash
-GMTR_ENABLE_OPTIONAL_CLAUDE_UX=1
+## How it works
+
+```
+You type a prompt
+  |
+gramatr hooks intercept (UserPromptSubmit)
+  |
+Decision router classifies in <5ms (BERT on GPU)
+  |
+Intelligence packet injected into agent context
+  |
+Agent receives pre-classified request
+  = skips routing overhead
+  = starts working immediately
+  = saves ~2,700 tokens per request
 ```
 
-## Development
+### The flywheel
 
-Install dependencies:
+Every interaction trains the classifier. Memory powers routing, routing generates patterns, patterns improve routing. The system gets smarter with use.
 
-```bash
-pnpm install --frozen-lockfile
-```
+## Architecture
 
-Run package tests:
+gramatr is a thin client + smart server:
 
-```bash
-pnpm --filter @aios-v2/client test
+- **Client** (this package): 29 files, ~290KB. Hooks into your AI agent, forwards to server.
+- **Server**: Decision routing engine (BERT + Qwen), knowledge graph (PostgreSQL + pgvector), pattern learning.
+- **Protocol**: MCP (Model Context Protocol) for Claude Code/Codex, REST API for web/mobile.
+
+The client never stores intelligence locally. The server delivers everything: behavioral rules, skill routing, agent composition, ISC scaffolds, capability audits.
+
+## What gets installed
+
+```
+~/gmtr-client/          # Client runtime
+  hooks/                # 8 lifecycle hooks
+  core/                 # Shared routing + session logic
+  bin/                  # Status line, login, utilities
+  CLAUDE.md             # Minimal behavioral framework
+~/.claude/settings.json # Hook configuration (merged, not overwritten)
+~/.claude.json          # MCP server registration
+~/.gmtr.json            # Auth token (canonical source)
 ```
 
-Run target detection locally:
+## Commands
 
 ```bash
-pnpm --filter @aios-v2/client exec bun bin/gramatr.ts detect
+gramatr install          # Interactive target selection
+gramatr install claude-code  # Install for Claude Code
+gramatr detect           # Show detected AI platforms
+gramatr doctor           # Health check (coming soon)
+gramatr uninstall        # Clean removal
+gramatr --version        # Show version
 ```
+
+## Requirements
+
+- Node.js 20+
+- One of: Claude Code, OpenAI Codex, Google Gemini CLI
+
+## Links
+
+- [gramatr.com](https://gramatr.com)
+- [GitHub](https://github.com/gramatr/gramatr)
+
+## License
+
+MIT

package/core/version.ts

@@ -1,2 +1,2 @@
 /** Auto-generated by version-sync.ts — do not edit */
-export const VERSION = '0.3.47';
+export const VERSION = '0.3.49';

package/gemini/install.ts

@@ -130,7 +130,12 @@ async function resolveApiKey(home: string): Promise<string | null> {
     log('  Environment token is invalid.');
   }
 
-  // 3. Prompt
+  // 3. Prompt (skip in non-interactive mode)
+  const nonInteractive = process.argv.includes('--yes') || process.argv.includes('-y') || !process.stdin.isTTY;
+  if (nonInteractive) {
+    log('  Non-interactive: no token found. Run gmtr-login after install.');
+    return null;
+  }
   const prompted = await promptForApiKey();
   if (prompted) {
     log('  Testing token...');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gramatr",
-  "version": "0.3.47",
-  "description": "gramatr — your cross-agent AI brain. Intelligence layer for Claude Code, Codex, Gemini CLI.",
+  "version": "0.3.49",
+  "description": "gramatr — intelligence layer for AI coding agents. Pre-classifies every request so Claude Code, Codex, and Gemini CLI spend tokens on your work, not on routing overhead.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -12,13 +12,20 @@
   "keywords": [
     "ai",
     "claude",
+    "claude-code",
+    "codex",
+    "gemini",
     "mcp",
+    "mcp-server",
+    "ai-agent",
     "intelligence",
-    "routing",
+    "decision-routing",
     "classifier",
-    "memory",
-    "codex",
-    "gemini"
+    "bert",
+    "prompt-engineering",
+    "token-savings",
+    "hooks",
+    "developer-tools"
   ],
   "bin": {
     "gramatr": "./bin/gramatr.js"