gramatr 0.3.43 → 0.3.45

package/AGENTS.md

@@ -0,0 +1,17 @@
+# Gramatr Codex Guidance
+
+## Repo Expectations
+
+- Prefer gramatr memory and project handoff context over ad hoc local summaries.
+- Treat Codex hook augmentation as authoritative when a `[GMTR Intelligence]` block is present.
+- If gramatr augmentation is missing, query gramatr memory before relying on stale local notes.
+- Prefer TypeScript implementations over shell scripts for client integration code unless the platform requires shell.
+- Maintain test coverage for new hook and utility logic.
+
+## Codex Integration
+
+- Repo-local Codex hooks are configured in `.codex/hooks.json`.
+- `UserPromptSubmit` is responsible for prompt enrichment.
+- `SessionStart` is responsible for session restore and continuity.
+- Hook failures must degrade cleanly and never block the user session.
+

package/bin/install.ts

@@ -577,7 +577,7 @@ function registerMcpServer(url: string, token: string): void {
 
 // ── Step 4c: Additional CLIs ──
 
-function installAdditionalClis(tsRunner: string): void {
+async function installAdditionalClis(): Promise<void> {
   log('━━━ Step 4c: Additional CLI platforms ━━━');
   log('');
 
@@ -585,14 +585,12 @@ function installAdditionalClis(tsRunner: string): void {
   const codexDir = join(HOME, '.codex');
   if (existsSync(codexDir) || which('codex')) {
     log('  Codex CLI detected — installing gramatr hooks...');
-    const codexInstall = join(SCRIPT_DIR, 'codex', 'install.ts');
-    if (existsSync(codexInstall)) {
-      const result = spawnSync(tsRunner, [codexInstall], { stdio: 'inherit' });
-      if (result.status === 0) {
-        log('  OK Codex hooks installed');
-      } else {
-        log('  X Codex install failed (non-fatal)');
-      }
+    try {
+      const { main: installCodex } = await import('../codex/install.ts');
+      installCodex();
+      log('  OK Codex hooks installed');
+    } catch (err: any) {
+      log(`  X Codex install failed (non-fatal): ${err.message}`);
     }
     log('');
   } else {
@@ -603,14 +601,12 @@ function installAdditionalClis(tsRunner: string): void {
   const geminiDir = join(HOME, '.gemini');
   if (existsSync(geminiDir) || which('gemini')) {
     log('  Gemini CLI detected — installing gramatr extension...');
-    const geminiInstall = join(SCRIPT_DIR, 'gemini', 'install.ts');
-    if (existsSync(geminiInstall)) {
-      const result = spawnSync(tsRunner, [geminiInstall], { stdio: 'inherit' });
-      if (result.status === 0) {
-        log('  OK Gemini extension installed');
-      } else {
-        log('  X Gemini install failed (non-fatal)');
-      }
+    try {
+      const { main: installGemini } = await import('../gemini/install.ts');
+      await installGemini();
+      log('  OK Gemini extension installed');
+    } catch (err: any) {
+      log(`  X Gemini install failed (non-fatal): ${err.message}`);
     }
     log('');
   } else {
@@ -721,7 +717,7 @@ async function main(): Promise<void> {
   await configureIdentity();
   updateClaudeSettings(tsRunner, url, token);
   registerMcpServer(url, token);
-  installAdditionalClis(tsRunner);
+  await installAdditionalClis();
 
   const allOk = verify(url, token);
 

package/codex/install.ts

@@ -41,7 +41,7 @@ function readJsonFile<T>(path: string, fallback: T): T {
   return JSON.parse(readFileSync(path, 'utf8')) as T;
 }
 
-function main(): void {
+export function main(): void {
   const home = process.env.HOME || process.env.USERPROFILE;
   if (!home) {
     throw new Error('HOME is not set');
@@ -56,12 +56,25 @@ function main(): void {
   const currentFile = fileURLToPath(import.meta.url);
   const codexSourceDir = dirname(currentFile);
   const clientSourceDir = dirname(codexSourceDir);
-  const packagesDir = dirname(clientSourceDir);
-  const repoRoot = dirname(packagesDir);
   const codexTargetDir = join(gmtrDir, 'codex');
   const sharedHookUtilsSource = join(clientSourceDir, 'hooks', 'lib', 'gmtr-hook-utils.ts');
   const sharedHookUtilsTarget = join(gmtrDir, 'hooks', 'lib', 'gmtr-hook-utils.ts');
-  const managedAgentsContent = readFileSync(join(repoRoot, 'AGENTS.md'), 'utf8');
+
+  // AGENTS.md: check package root first (npm install), then repo root (dev)
+  let managedAgentsContent = '';
+  const agentsMdCandidates = [
+    join(clientSourceDir, 'AGENTS.md'),               // npm package root
+    join(dirname(dirname(clientSourceDir)), 'AGENTS.md'), // monorepo root
+  ];
+  for (const candidate of agentsMdCandidates) {
+    if (existsSync(candidate)) {
+      managedAgentsContent = readFileSync(candidate, 'utf8');
+      break;
+    }
+  }
+  if (!managedAgentsContent) {
+    log('  WARN: AGENTS.md not found — skipping Codex agents block');
+  }
 
   ensureDir(gmtrDir);
   ensureDir(codexHome);
@@ -96,4 +109,8 @@ function main(): void {
   log('Restart Codex or start a new session to load the updated hook configuration.');
 }
 
-main();
+// Run directly when executed as a script
+const isDirectRun = typeof require !== 'undefined'
+  ? require.main === module
+  : !import.meta.url.includes('node_modules/gramatr/bin/');
+if (isDirectRun) main();

package/core/version.ts

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

package/gemini/install.ts

@@ -163,7 +163,7 @@ async function resolveApiKey(home: string): Promise<string | null> {
   return null;
 }
 
-async function main(): Promise<void> {
+export async function main(): Promise<void> {
   const home = process.env.HOME || process.env.USERPROFILE;
   if (!home) {
     throw new Error('HOME is not set');
@@ -269,4 +269,8 @@ async function main(): Promise<void> {
   log('');
 }
 
-main();
+// Run directly when executed as a script
+const isDirectRun = typeof require !== 'undefined'
+  ? require.main === module
+  : !import.meta.url.includes('node_modules/gramatr/bin/');
+if (isDirectRun) main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gramatr",
-  "version": "0.3.43",
+  "version": "0.3.45",
   "description": "gramatr — your cross-agent AI brain. Intelligence layer for Claude Code, Codex, Gemini CLI.",
   "license": "MIT",
   "repository": {