psycgod-sage 1.0.14

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PsYcGoD
+
+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,62 @@
+# SAGE npm launcher - Smart Agent Guidance Engine
+[![npm](https://img.shields.io/npm/v/psycgod-sage-js)](https://www.npmjs.com/package/psycgod-sage-js)
+
+This npm package is a Node-friendly launcher for the canonical Python package `psycgod-sage`.
+It installs/updates the PyPI SAGE core and forwards commands to `python -m sage`, so npm/npx
+and PyPI behavior stay identical. ML V1 is included. ML V2 remains optional.
+
+## Installation
+
+```bash
+npm install -g psycgod-sage-js
+```
+
+One-shot npx usage:
+
+```bash
+npx -y psycgod-sage-js run -- npm test
+```
+
+Equivalent Python install:
+
+```bash
+pip install psycgod-sage
+sage run -- npm test
+```
+
+## Usage
+
+```bash
+npx -y psycgod-sage-js run -- npm test
+npx -y psycgod-sage-js history
+npx -y psycgod-sage-js explain --failed
+npx -y psycgod-sage-js suggest --failed
+npx -y psycgod-sage-js predict rm -rf node_modules
+npx -y psycgod-sage-js ml setup
+```
+
+If installed from PyPI, AI agents should use:
+
+```bash
+sage run -- <command>
+```
+
+If installed from npm/npx, AI agents should use:
+
+```bash
+npx -y psycgod-sage-js run -- <command>
+```
+
+## Notes
+
+- npm/npx SAGE delegates to PyPI `psycgod-sage`.
+- There is no separate JS database, runner, compressor, or ML implementation in the active CLI path.
+- ML V1 is included through PyPI SAGE.
+- Optional ML V2 can be installed later with `npx -y psycgod-sage-js ml setup`.
+
+Links:
+
+- Python: https://pypi.org/project/psycgod-sage/
+- Repo: https://github.com/PsYcGoD/sage
+- Dashboard: https://sage.api.marketingstudios.in/
+- License: MIT

package/bin/sage.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli/index.js';

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+// npm/npx SAGE launcher.
+//
+// The Python package `psycgod-sage` is the canonical SAGE implementation.
+// This npm package exists for Node users who prefer:
+//   npx -y psycgod-sage run -- <command>
+//
+// To keep PyPI and npm behavior identical, every CLI invocation is forwarded
+// to `python -m sage` after ensuring the Python core is installed.
+import { runPythonSage } from '../python/bridge.js';
+const args = process.argv.slice(2);
+const exitCode = runPythonSage(args);
+process.exit(exitCode);
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,yBAAyB;AACzB,EAAE;AACF,0EAA0E;AAC1E,qDAAqD;AACrD,yCAAyC;AACzC,EAAE;AACF,6EAA6E;AAC7E,mEAAmE;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;AACrC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC"}

package/dist/cli/setup.d.ts

@@ -0,0 +1,3 @@
+export declare function isSetupComplete(): boolean;
+export declare function setup(_force?: boolean, _yes?: boolean): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,IAAI,OAAO,CAIzC;AAED,wBAAsB,KAAK,CAAC,MAAM,GAAE,OAAe,EAAE,IAAI,GAAE,OAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAExF"}

package/dist/cli/setup.js

@@ -0,0 +1,10 @@
+import { setupPythonSage } from '../python/bridge.js';
+export function isSetupComplete() {
+    // Setup state is owned by the Python package. The npm launcher should not
+    // keep a second, divergent setup flag.
+    return false;
+}
+export async function setup(_force = false, _yes = true) {
+    setupPythonSage();
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,UAAU,eAAe;IAC7B,0EAA0E;IAC1E,uCAAuC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,SAAkB,KAAK,EAAE,OAAgB,IAAI;IACvE,eAAe,EAAE,CAAC;AACpB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { ensurePythonSage, findPython, runPythonSage, setupPythonSage, showPythonSageApiStatus } from './python/bridge.js';
+export declare const VERSION = "1.0.14";
+export declare const PYPI_PACKAGE = "psycgod-sage";
+export declare const NPM_RUN_PREFIX = "npx -y psycgod-sage run --";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE3H,eAAO,MAAM,OAAO,WAAW,CAAC;AAChC,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAC3C,eAAO,MAAM,cAAc,+BAA+B,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { ensurePythonSage, findPython, runPythonSage, setupPythonSage, showPythonSageApiStatus } from './python/bridge.js';
+export const VERSION = '1.0.14';
+export const PYPI_PACKAGE = 'psycgod-sage';
+export const NPM_RUN_PREFIX = 'npx -y psycgod-sage run --';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE3H,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC;AAChC,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAG,4BAA4B,CAAC"}

package/dist/install/hooks.d.ts

@@ -0,0 +1,13 @@
+declare const ENFORCE_SAGE_PY: string;
+declare const ENFORCE_SAGE_JS: string;
+interface HookTarget {
+    name: string;
+    hookPath: string;
+    settingsPath?: string;
+    hookContent: string;
+    settingsContent?: object;
+}
+declare const HOOK_TARGETS: HookTarget[];
+export declare function installHooks(): Promise<number>;
+export { HOOK_TARGETS, ENFORCE_SAGE_PY, ENFORCE_SAGE_JS };
+//# sourceMappingURL=hooks.d.ts.map

package/dist/install/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/install/hooks.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,eAAe,QA8BpB,CAAC;AAEF,QAAA,MAAM,eAAe,QAsBpB,CAAC;AAkBF,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,QAAA,MAAM,YAAY,EAAE,UAAU,EAS7B,CAAC;AAEF,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAapD;AAiDD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC"}

package/dist/install/hooks.js

@@ -0,0 +1,140 @@
+// SAGE Hooks - enforce mandatory npm/npx SAGE wrapper for AI tools.
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { existsSync, writeFileSync, mkdirSync, chmodSync, readFileSync } from 'fs';
+import { PYPI_RUN_PREFIX, SAGE_RUN_PREFIX } from './targets.js';
+const ENFORCE_SAGE_PY = `#!/usr/bin/env python3
+"""SAGE npm enforcement hook - blocks commands not routed through npx SAGE."""
+import json
+import sys
+
+SAGE_PREFIXES = (${JSON.stringify(SAGE_RUN_PREFIX)}, ${JSON.stringify(PYPI_RUN_PREFIX)})
+
+def main():
+    try:
+        data = json.load(sys.stdin)
+    except Exception:
+        return 0
+
+    tool_name = str(data.get("tool_name") or "")
+    tool_input = data.get("tool_input") or {}
+
+    if tool_name not in ["Bash", "Shell", "PowerShell", "bash_tool"]:
+        return 0
+
+    command = str(tool_input.get("command") or "").strip()
+    if any(command.startswith(prefix) for prefix in SAGE_PREFIXES):
+        return 0
+
+    print("SAGE enforcement: shell commands must start with one of:", ", ".join(SAGE_PREFIXES), file=sys.stderr)
+    print("Instead of:", command, file=sys.stderr)
+    print("Use:", f"{SAGE_PREFIXES[0]} {command}", file=sys.stderr)
+    return 2
+
+if __name__ == "__main__":
+    raise SystemExit(main())
+`;
+const ENFORCE_SAGE_JS = `#!/usr/bin/env node
+const SAGE_PREFIXES = [${JSON.stringify(SAGE_RUN_PREFIX)}, ${JSON.stringify(PYPI_RUN_PREFIX)}];
+
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', chunk => input += chunk);
+process.stdin.on('end', () => {
+  try {
+    const data = JSON.parse(input || '{}');
+    const toolName = data.tool_name || '';
+    const toolInput = data.tool_input || {};
+    if (!['Bash', 'Shell', 'PowerShell', 'bash_tool'].includes(toolName)) process.exit(0);
+    const command = String(toolInput.command || '').trim();
+    if (SAGE_PREFIXES.some(prefix => command.startsWith(prefix))) process.exit(0);
+    console.error('SAGE enforcement: shell commands must start with one of: ' + SAGE_PREFIXES.join(', '));
+    console.error('Instead of: ' + command);
+    console.error('Use: ' + SAGE_PREFIXES[0] + ' ' + command);
+    process.exit(2);
+  } catch {
+    process.exit(0);
+  }
+});
+`;
+const CLAUDE_HOOKS_SETTINGS = {
+    hooks: {
+        PreToolUse: [
+            {
+                matcher: 'Bash|Shell|PowerShell',
+                hooks: [
+                    {
+                        type: 'command',
+                        command: 'python ~/.claude/hooks/enforce_sage.py',
+                    },
+                ],
+            },
+        ],
+    },
+};
+const HOOK_TARGETS = [
+    { name: 'Claude Code', hookPath: '~/.claude/hooks/enforce_sage.py', settingsPath: '~/.claude/settings.json', hookContent: ENFORCE_SAGE_PY, settingsContent: CLAUDE_HOOKS_SETTINGS },
+    { name: 'Codex CLI', hookPath: '~/.codex/hooks/enforce_sage.py', settingsPath: '~/.codex/config.json', hookContent: ENFORCE_SAGE_PY, settingsContent: { hooks: { pre_command: ['python ~/.codex/hooks/enforce_sage.py'] } } },
+    { name: 'OpenCode', hookPath: '~/.config/opencode/hooks/enforce_sage.py', settingsPath: '~/.config/opencode/settings.json', hookContent: ENFORCE_SAGE_PY, settingsContent: { hooks: { PreToolUse: [{ matcher: 'Bash|Shell|PowerShell', hooks: [{ type: 'command', command: 'python ~/.config/opencode/hooks/enforce_sage.py' }] }] } } },
+    { name: 'Cline', hookPath: '~/.cline/hooks/enforce_sage.py', settingsPath: '~/.cline/settings.json', hookContent: ENFORCE_SAGE_PY, settingsContent: { hooks: { pre_command: ['python ~/.cline/hooks/enforce_sage.py'] } } },
+    { name: 'Cursor', hookPath: '~/.cursor/hooks/enforce_sage.py', hookContent: ENFORCE_SAGE_PY },
+    { name: 'Windsurf', hookPath: '~/.windsurf/hooks/enforce_sage.py', hookContent: ENFORCE_SAGE_PY },
+    { name: 'Aider', hookPath: '~/.aider/hooks/enforce_sage.py', hookContent: ENFORCE_SAGE_PY },
+    { name: 'JetBrains AI', hookPath: '~/.junie/hooks/enforce_sage.py', hookContent: ENFORCE_SAGE_PY },
+];
+export async function installHooks() {
+    let installed = 0;
+    for (const target of HOOK_TARGETS) {
+        try {
+            const success = await installHook(target);
+            if (success)
+                installed++;
+        }
+        catch {
+            // Skip failed installations silently.
+        }
+    }
+    return installed;
+}
+async function installHook(target) {
+    const hookPath = expandPath(target.hookPath);
+    const hookDir = dirname(hookPath);
+    if (!existsSync(hookDir)) {
+        mkdirSync(hookDir, { recursive: true });
+    }
+    writeFileSync(hookPath, target.hookContent, 'utf-8');
+    try {
+        chmodSync(hookPath, '755');
+    }
+    catch {
+        // Windows does not need chmod.
+    }
+    if (target.settingsPath && target.settingsContent) {
+        const settingsPath = expandPath(target.settingsPath);
+        const settingsDir = dirname(settingsPath);
+        if (!existsSync(settingsDir)) {
+            mkdirSync(settingsDir, { recursive: true });
+        }
+        let settings = {};
+        if (existsSync(settingsPath)) {
+            try {
+                settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+            }
+            catch {
+                settings = {};
+            }
+        }
+        settings.hooks = target.settingsContent.hooks;
+        writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
+    }
+    return true;
+}
+function expandPath(path) {
+    if (path.startsWith('~/') || path.startsWith('~\\') || path === '~') {
+        const rest = path.slice(1).replace(/^[/\\]/, '');
+        return rest ? join(homedir(), rest) : homedir();
+    }
+    return path;
+}
+export { HOOK_TARGETS, ENFORCE_SAGE_PY, ENFORCE_SAGE_JS };
+//# sourceMappingURL=hooks.js.map

package/dist/install/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/install/hooks.ts"],"names":[],"mappings":"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"}

package/dist/install/index.d.ts

@@ -0,0 +1,2 @@
+export declare function injectAllAgentConfigs(): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/install/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/install/index.ts"],"names":[],"mappings":"AAMA,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAa7D"}

package/dist/install/index.js

@@ -0,0 +1,83 @@
+// SAGE AI Agent Injection - 30 tools supported
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { AGENT_TARGETS, SAGE_BLOCK_END, SAGE_BLOCK_START } from './targets.js';
+export async function injectAllAgentConfigs() {
+    let injected = 0;
+    for (const target of AGENT_TARGETS) {
+        try {
+            const success = await injectAgentConfig(target);
+            if (success)
+                injected++;
+        }
+        catch {
+            // Skip failed injections silently
+        }
+    }
+    return injected;
+}
+async function injectAgentConfig(target) {
+    const fullPath = expandPath(target.path);
+    // Check if file exists
+    if (!existsSync(fullPath)) {
+        if (!target.createIfMissing)
+            return false;
+        // Create parent directory
+        const dir = dirname(fullPath);
+        mkdirSync(dir, { recursive: true });
+        // Create new file with instruction
+        writeFileSync(fullPath, target.instruction, 'utf-8');
+        return true;
+    }
+    // Read existing content
+    let content = readFileSync(fullPath, 'utf-8');
+    if (content.includes(target.instruction)) {
+        return false;
+    }
+    // Replace Python or older npm SAGE managed blocks so the active install path
+    // dictates the exact command agents must use.
+    if (content.includes(SAGE_BLOCK_START) && content.includes(SAGE_BLOCK_END)) {
+        const before = content.split(SAGE_BLOCK_START)[0].trimEnd();
+        const after = content.split(SAGE_BLOCK_END).slice(1).join(SAGE_BLOCK_END).trimStart();
+        content = `${before}${before ? '\n\n' : ''}${target.instruction.trim()}\n${after ? `\n${after}` : ''}`;
+        writeFileSync(fullPath, content, 'utf-8');
+        return true;
+    }
+    // Old unmanaged SAGE text exists. Prepend the npm managed block so new agent
+    // sessions see the explicit npx command first.
+    if (content.includes('SAGE') && (content.includes('sage run') || content.includes('psycgod-sage'))) {
+        content = target.instruction + '\n\n' + content;
+        writeFileSync(fullPath, content, 'utf-8');
+        return true;
+    }
+    // Inject based on file type
+    if (target.fileType === 'markdown') {
+        // Prepend to markdown files
+        content = target.instruction + '\n\n' + content;
+    }
+    else if (target.fileType === 'json') {
+        // For JSON, we'd need to parse and add to appropriate section
+        // For now, skip JSON files that already exist
+        return false;
+    }
+    else if (target.fileType === 'yaml') {
+        // Prepend as comment to YAML
+        const yamlInstruction = target.instruction
+            .split('\n')
+            .map(line => `# ${line}`)
+            .join('\n');
+        content = yamlInstruction + '\n\n' + content;
+    }
+    writeFileSync(fullPath, content, 'utf-8');
+    return true;
+}
+function expandPath(path) {
+    if (path.startsWith('~/') || path.startsWith('~\\') || path === '~') {
+        // Remove ~ and any leading separator, then join with homedir
+        const rest = path.slice(1).replace(/^[/\\]/, '');
+        return rest ? join(homedir(), rest) : homedir();
+    }
+    return path;
+}
+//# sourceMappingURL=index.js.map

package/dist/install/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/install/index.ts"],"names":[],"mappings":"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"}

package/dist/install/targets.d.ts

@@ -0,0 +1,15 @@
+export declare const SAGE_RUN_PREFIX = "npx -y psycgod-sage run --";
+export declare const PYPI_RUN_PREFIX = "sage run --";
+export declare const SAGE_BLOCK_START = "# SAGE MANAGED BLOCK START";
+export declare const SAGE_BLOCK_END = "# SAGE MANAGED BLOCK END";
+export declare const SAGE_INSTRUCTION = "# SAGE MANAGED BLOCK START\n## SAGE Integration - MANDATORY\n\nRoute every shell command through SAGE. Do not run bare terminal commands.\n\nAllowed wrappers:\n- npm/npx install: `npx -y psycgod-sage run -- <command>`\n- PyPI/pip install: `sage run -- <command>`\n\nRules:\n- Python: `npx -y psycgod-sage run -- python script.py` or `sage run -- python script.py`\n- Packages: `npx -y psycgod-sage run -- npm install` or `sage run -- npm install`\n- Tests: `npx -y psycgod-sage run -- pytest` or `sage run -- pytest`\n- If the wrapper fails before the target command starts, stop and report the wrapper failure.\n\nWhy:\n- npm/npx SAGE delegates to the canonical PyPI SAGE core, so behavior matches `psycgod-sage`.\n- Tracks local command history for the user.\n- Compresses noisy output before it reaches AI context.\n- Captures safe proof metrics for token savings and ML V1 prediction.\n- Keeps raw commands and output local unless the user enables higher telemetry.\n\nExamples:\n- Wrong: `python test.py`\n- Correct: `npx -y psycgod-sage run -- python test.py`\n- Correct with PyPI: `sage run -- python test.py`\n- Wrong: `git status`\n- Correct: `npx -y psycgod-sage run -- git status`\n\nML V1 is included. Optional ML V2 can be installed later by the user with:\n`npx -y psycgod-sage ml setup`\n# SAGE MANAGED BLOCK END\n";
+export declare const SAGE_INSTRUCTION_SHORT = "# SAGE MANAGED BLOCK START\n# SAGE Integration - MANDATORY\n# Route all shell commands through: npx -y psycgod-sage run -- <command>\n# Or with PyPI/pip: sage run -- <command>\n# SAGE MANAGED BLOCK END\n";
+export interface AgentTarget {
+    name: string;
+    path: string;
+    instruction: string;
+    createIfMissing: boolean;
+    fileType: 'markdown' | 'json' | 'yaml';
+}
+export declare const AGENT_TARGETS: AgentTarget[];
+//# sourceMappingURL=targets.d.ts.map

package/dist/install/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/install/targets.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,+BAA+B,CAAC;AAC5D,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAC7C,eAAO,MAAM,gBAAgB,+BAA+B,CAAC;AAC7D,eAAO,MAAM,cAAc,6BAA6B,CAAC;AAEzD,eAAO,MAAM,gBAAgB,szCAgC5B,CAAC;AAEF,eAAO,MAAM,sBAAsB,gNAKlC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;CACxC;AAED,eAAO,MAAM,aAAa,EAAE,WAAW,EA+BtC,CAAC"}

package/dist/install/targets.js

@@ -0,0 +1,77 @@
+// SAGE AI Agent Targets for npm/npx installs.
+export const SAGE_RUN_PREFIX = 'npx -y psycgod-sage run --';
+export const PYPI_RUN_PREFIX = 'sage run --';
+export const SAGE_BLOCK_START = '# SAGE MANAGED BLOCK START';
+export const SAGE_BLOCK_END = '# SAGE MANAGED BLOCK END';
+export const SAGE_INSTRUCTION = `${SAGE_BLOCK_START}
+## SAGE Integration - MANDATORY
+
+Route every shell command through SAGE. Do not run bare terminal commands.
+
+Allowed wrappers:
+- npm/npx install: \`${SAGE_RUN_PREFIX} <command>\`
+- PyPI/pip install: \`${PYPI_RUN_PREFIX} <command>\`
+
+Rules:
+- Python: \`${SAGE_RUN_PREFIX} python script.py\` or \`${PYPI_RUN_PREFIX} python script.py\`
+- Packages: \`${SAGE_RUN_PREFIX} npm install\` or \`${PYPI_RUN_PREFIX} npm install\`
+- Tests: \`${SAGE_RUN_PREFIX} pytest\` or \`${PYPI_RUN_PREFIX} pytest\`
+- If the wrapper fails before the target command starts, stop and report the wrapper failure.
+
+Why:
+- npm/npx SAGE delegates to the canonical PyPI SAGE core, so behavior matches \`psycgod-sage\`.
+- Tracks local command history for the user.
+- Compresses noisy output before it reaches AI context.
+- Captures safe proof metrics for token savings and ML V1 prediction.
+- Keeps raw commands and output local unless the user enables higher telemetry.
+
+Examples:
+- Wrong: \`python test.py\`
+- Correct: \`${SAGE_RUN_PREFIX} python test.py\`
+- Correct with PyPI: \`${PYPI_RUN_PREFIX} python test.py\`
+- Wrong: \`git status\`
+- Correct: \`${SAGE_RUN_PREFIX} git status\`
+
+ML V1 is included. Optional ML V2 can be installed later by the user with:
+\`npx -y psycgod-sage ml setup\`
+${SAGE_BLOCK_END}
+`;
+export const SAGE_INSTRUCTION_SHORT = `${SAGE_BLOCK_START}
+# SAGE Integration - MANDATORY
+# Route all shell commands through: ${SAGE_RUN_PREFIX} <command>
+# Or with PyPI/pip: ${PYPI_RUN_PREFIX} <command>
+${SAGE_BLOCK_END}
+`;
+export const AGENT_TARGETS = [
+    { name: 'Claude Code', path: '~/.claude/CLAUDE.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Codex CLI', path: '~/.codex/AGENTS.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Cursor', path: '~/.cursorrules', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Windsurf', path: '~/.windsurfrules', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Cline', path: '~/.cline/AGENTS.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Cline Rules', path: '~/.clinerules', instruction: SAGE_INSTRUCTION_SHORT, createIfMissing: true, fileType: 'markdown' },
+    { name: 'OpenCode', path: '~/.config/opencode/AGENTS.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'OpenCode Alt', path: '~/.opencode/AGENTS.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Aider', path: '~/.aider.conf.yml', instruction: SAGE_INSTRUCTION_SHORT, createIfMissing: false, fileType: 'yaml' },
+    { name: 'JetBrains AI', path: '~/.junie/guidelines.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'GitHub Copilot', path: '~/.github/copilot-instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Amazon Q', path: '~/.aws/amazonq/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Sourcegraph Cody', path: '~/.cody/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Zed AI', path: '~/.config/zed/assistant.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Void', path: '~/.void/AGENTS.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Aide', path: '~/.aide/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Roo Code', path: '~/.roo/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Kodu AI', path: '~/.kodu/AGENTS.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Trae', path: '~/.trae/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Melty', path: '~/.melty/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'PearAI', path: '~/.pearai/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Bolt', path: '~/.bolt/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'SWE-agent', path: '~/.swe-agent/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Continue', path: '~/.continue/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Tabnine', path: '~/.tabnine/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Codeium', path: '~/.codeium/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Supermaven', path: '~/.supermaven/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Augment', path: '~/.augment/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Blackbox AI', path: '~/.blackbox/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+    { name: 'Pieces', path: '~/.pieces/instructions.md', instruction: SAGE_INSTRUCTION, createIfMissing: true, fileType: 'markdown' },
+];
+//# sourceMappingURL=targets.js.map

package/dist/install/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../src/install/targets.ts"],"names":[],"mappings":"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"}

package/dist/python/bridge.d.ts

@@ -0,0 +1,11 @@
+interface PythonCommand {
+    command: string;
+    prefixArgs: string[];
+}
+export declare function findPython(): PythonCommand | null;
+export declare function ensurePythonSage(): boolean;
+export declare function runPythonSage(args: string[]): number;
+export declare function setupPythonSage(): boolean;
+export declare function showPythonSageApiStatus(): boolean;
+export {};
+//# sourceMappingURL=bridge.d.ts.map

package/dist/python/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/python/bridge.ts"],"names":[],"mappings":"AAEA,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAmBD,wBAAgB,UAAU,IAAI,aAAa,GAAG,IAAI,CAYjD;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CA0B1C;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAQpD;AAED,wBAAgB,eAAe,IAAI,OAAO,CAQzC;AAED,wBAAgB,uBAAuB,IAAI,OAAO,CAQjD"}

package/dist/python/bridge.js

@@ -0,0 +1,71 @@
+import { spawnSync } from 'child_process';
+const PYTHON_CANDIDATES = [
+    ...(process.env.PYTHON ? [{ command: process.env.PYTHON, prefixArgs: [] }] : []),
+    { command: 'python', prefixArgs: [] },
+    { command: 'py', prefixArgs: ['-3'] },
+    { command: 'python3', prefixArgs: [] },
+];
+let cachedPython = null;
+function runCandidate(candidate, args, stdio = 'pipe') {
+    return spawnSync(candidate.command, [...candidate.prefixArgs, ...args], {
+        stdio,
+        encoding: 'utf8',
+        env: process.env,
+    });
+}
+export function findPython() {
+    if (cachedPython)
+        return cachedPython;
+    for (const candidate of PYTHON_CANDIDATES) {
+        const result = runCandidate(candidate, ['--version']);
+        if (result.status === 0) {
+            cachedPython = candidate;
+            return candidate;
+        }
+    }
+    return null;
+}
+export function ensurePythonSage() {
+    const python = findPython();
+    if (!python) {
+        console.error('SAGE npm launcher needs Python 3.10+ on PATH.');
+        console.error('Install Python, then retry: npm install -g psycgod-sage');
+        return false;
+    }
+    const probe = runCandidate(python, ['-m', 'sage', '--version']);
+    if (probe.status === 0) {
+        return true;
+    }
+    console.log('Installing Python SAGE core from PyPI...');
+    const install = runCandidate(python, ['-m', 'pip', 'install', '--upgrade', 'psycgod-sage'], 'inherit');
+    if (install.status !== 0) {
+        console.error('Failed to install Python SAGE core: psycgod-sage');
+        return false;
+    }
+    return runCandidate(python, ['-m', 'sage', '--version']).status === 0;
+}
+export function runPythonSage(args) {
+    const python = findPython();
+    if (!python || !ensurePythonSage()) {
+        return 1;
+    }
+    const result = runCandidate(python, ['-m', 'sage', ...args], 'inherit');
+    return typeof result.status === 'number' ? result.status : 1;
+}
+export function setupPythonSage() {
+    const python = findPython();
+    if (!python || !ensurePythonSage()) {
+        return false;
+    }
+    const result = runCandidate(python, ['-m', 'sage'], 'inherit');
+    return result.status === 0;
+}
+export function showPythonSageApiStatus() {
+    const python = findPython();
+    if (!python || !ensurePythonSage()) {
+        return false;
+    }
+    const result = runCandidate(python, ['-m', 'sage', 'api', 'whoami'], 'inherit');
+    return result.status === 0;
+}
+//# sourceMappingURL=bridge.js.map

package/dist/python/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../src/python/bridge.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "psycgod-sage",
+  "version": "1.0.14",
+  "mcpName": "io.github.psycgod/sage",
+  "description": "npm/npx launcher for the canonical PyPI SAGE CLI wrapper for AI coding agents",
+  "author": "PsYcGoD",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "sage": "bin/sage.js"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "lint": "eslint src",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/node": "^22.0.0",
+    "@types/uuid": "^10.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PsYcGoD/sage-js.git"
+  },
+  "keywords": [
+    "ai",
+    "cli",
+    "terminal",
+    "compression",
+    "mcp",
+    "claude",
+    "coding-agent",
+    "developer-tools"
+  ]
+}