psycgod-sage 1.0.24 → 1.0.26
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -5
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/install/targets.d.ts +2 -2
- package/dist/install/targets.d.ts.map +1 -1
- package/dist/install/targets.js +12 -21
- package/dist/install/targets.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -9,15 +9,15 @@ and PyPI behavior stay identical. ML V1 is included. ML V2 remains optional.
|
|
|
9
9
|
|
|
10
10
|
```bash
|
|
11
11
|
npm install -g psycgod-sage
|
|
12
|
-
npx -y psycgod-sage
|
|
12
|
+
npx -y psycgod-sage install
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
`
|
|
15
|
+
`install` is the explicit one-command onboarding step before you expect Claude, Codex, Cursor, Windsurf, OpenCode, Cline, or other AI agents to use SAGE automatically. It connects this machine, writes/repairs local AI-agent memory files and supported shell-wrapper hooks, then prints a verification report. It does **not** auto-enable SAGE MCP. Restart open AI-agent sessions after install.
|
|
16
16
|
|
|
17
17
|
One-shot npx usage:
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
|
-
npx -y psycgod-sage
|
|
20
|
+
npx -y psycgod-sage install
|
|
21
21
|
npx -y psycgod-sage run -- npm test
|
|
22
22
|
```
|
|
23
23
|
|
|
@@ -25,14 +25,14 @@ Equivalent Python install:
|
|
|
25
25
|
|
|
26
26
|
```bash
|
|
27
27
|
pip install psycgod-sage
|
|
28
|
-
sage
|
|
28
|
+
sage install
|
|
29
29
|
sage run -- npm test
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
## Usage
|
|
33
33
|
|
|
34
34
|
```bash
|
|
35
|
-
npx -y psycgod-sage
|
|
35
|
+
npx -y psycgod-sage install
|
|
36
36
|
npx -y psycgod-sage run -- npm test
|
|
37
37
|
npx -y psycgod-sage history
|
|
38
38
|
npx -y psycgod-sage explain --failed
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export { ensurePythonSage, findPython, runPythonSage, setupPythonSage, showPythonSageApiStatus } from './python/bridge.js';
|
|
2
|
-
export declare const VERSION = "1.0.
|
|
2
|
+
export declare const VERSION = "1.0.25";
|
|
3
3
|
export declare const PYPI_PACKAGE = "psycgod-sage";
|
|
4
4
|
export declare const NPM_RUN_PREFIX = "npx -y psycgod-sage run --";
|
|
5
5
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
export { ensurePythonSage, findPython, runPythonSage, setupPythonSage, showPythonSageApiStatus } from './python/bridge.js';
|
|
2
|
-
export const VERSION = '1.0.
|
|
2
|
+
export const VERSION = '1.0.25';
|
|
3
3
|
export const PYPI_PACKAGE = 'psycgod-sage';
|
|
4
4
|
export const NPM_RUN_PREFIX = 'npx -y psycgod-sage run --';
|
|
5
5
|
//# sourceMappingURL=index.js.map
|
|
@@ -2,8 +2,8 @@ export declare const SAGE_RUN_PREFIX = "npx -y psycgod-sage run --";
|
|
|
2
2
|
export declare const PYPI_RUN_PREFIX = "sage run --";
|
|
3
3
|
export declare const SAGE_BLOCK_START = "# SAGE MANAGED BLOCK START";
|
|
4
4
|
export declare const SAGE_BLOCK_END = "# SAGE MANAGED BLOCK END";
|
|
5
|
-
export declare const SAGE_INSTRUCTION = "# SAGE MANAGED BLOCK START\n## SAGE Integration - MANDATORY\n\nWhen a user asks for any coding, repo, file, debugging, documentation, or project task, start through SAGE automatically. The user should not need to type `sage`.\n\nFirst actions for normal repo work:\n-
|
|
6
|
-
export declare const SAGE_INSTRUCTION_SHORT = "# SAGE MANAGED BLOCK START\n# SAGE Integration - MANDATORY\n#
|
|
5
|
+
export declare const SAGE_INSTRUCTION = "# SAGE MANAGED BLOCK START\n## SAGE Integration - MANDATORY\n\nWhen a user asks for any coding, repo, file, debugging, documentation, or project task, start through SAGE automatically. The user should not need to type `sage`.\n\nFirst actions for normal repo work:\n- Use native file/search/edit tools normally.\n- Route every terminal command through the npm SAGE wrapper: `npx -y psycgod-sage run -- <command>`.\n\nRoute every shell command through SAGE. Do not run bare terminal commands.\n\nAllowed wrappers:\n- `npx -y psycgod-sage run -- <command>`\n- Backup when npm/npx is unavailable: `sage run -- <command>`\n\nRules:\n- Python: `npx -y psycgod-sage run -- python script.py`\n- Packages: `npx -y psycgod-sage run -- npm install`\n- Tests: `npx -y psycgod-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 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- Backup: `sage run -- python test.py`\n- Wrong: `git status`\n- Correct: `npx -y psycgod-sage run -- git status`\n\nExample user request:\n- User: \"Please help me with my general book in this folder\"\n- Correct agent start: inspect/read/edit files with available native tools, then use `npx -y psycgod-sage run -- <command>` only when a terminal command is needed.\n- Wrong agent start: bare `python`, `git`, `npm`, or `ls`.\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";
|
|
6
|
+
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# Backup when npm/npx is unavailable: sage run -- <command>\n# SAGE MANAGED BLOCK END\n";
|
|
7
7
|
export interface AgentTarget {
|
|
8
8
|
name: string;
|
|
9
9
|
path: string;
|
|
@@ -1 +1 @@
|
|
|
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,
|
|
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,42DA2C5B,CAAC;AAEF,eAAO,MAAM,sBAAsB,kOAKlC,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
CHANGED
|
@@ -9,24 +9,23 @@ export const SAGE_INSTRUCTION = `${SAGE_BLOCK_START}
|
|
|
9
9
|
When a user asks for any coding, repo, file, debugging, documentation, or project task, start through SAGE automatically. The user should not need to type \`sage\`.
|
|
10
10
|
|
|
11
11
|
First actions for normal repo work:
|
|
12
|
-
-
|
|
13
|
-
-
|
|
14
|
-
- Route every terminal command through a SAGE wrapper
|
|
12
|
+
- Use native file/search/edit tools normally.
|
|
13
|
+
- Route every terminal command through the npm SAGE wrapper: \`${SAGE_RUN_PREFIX} <command>\`.
|
|
15
14
|
|
|
16
15
|
Route every shell command through SAGE. Do not run bare terminal commands.
|
|
17
16
|
|
|
18
17
|
Allowed wrappers:
|
|
19
|
-
-
|
|
20
|
-
-
|
|
18
|
+
- \`${SAGE_RUN_PREFIX} <command>\`
|
|
19
|
+
- Backup when npm/npx is unavailable: \`${PYPI_RUN_PREFIX} <command>\`
|
|
21
20
|
|
|
22
21
|
Rules:
|
|
23
|
-
- Python: \`${SAGE_RUN_PREFIX} python script.py\`
|
|
24
|
-
- Packages: \`${SAGE_RUN_PREFIX} npm install\`
|
|
25
|
-
- Tests: \`${SAGE_RUN_PREFIX} pytest\`
|
|
22
|
+
- Python: \`${SAGE_RUN_PREFIX} python script.py\`
|
|
23
|
+
- Packages: \`${SAGE_RUN_PREFIX} npm install\`
|
|
24
|
+
- Tests: \`${SAGE_RUN_PREFIX} pytest\`
|
|
26
25
|
- If the wrapper fails before the target command starts, stop and report the wrapper failure.
|
|
27
26
|
|
|
28
27
|
Why:
|
|
29
|
-
- npm/npx SAGE delegates to the canonical
|
|
28
|
+
- npm/npx SAGE delegates to the canonical SAGE core, so behavior matches \`psycgod-sage\`.
|
|
30
29
|
- Tracks local command history for the user.
|
|
31
30
|
- Compresses noisy output before it reaches AI context.
|
|
32
31
|
- Captures safe proof metrics for token savings and ML V1 prediction.
|
|
@@ -35,21 +34,14 @@ Why:
|
|
|
35
34
|
Examples:
|
|
36
35
|
- Wrong: \`python test.py\`
|
|
37
36
|
- Correct: \`${SAGE_RUN_PREFIX} python test.py\`
|
|
38
|
-
-
|
|
37
|
+
- Backup: \`${PYPI_RUN_PREFIX} python test.py\`
|
|
39
38
|
- Wrong: \`git status\`
|
|
40
39
|
- Correct: \`${SAGE_RUN_PREFIX} git status\`
|
|
41
40
|
|
|
42
|
-
For agents with native file/search/edit tools, shell wrapping is not enough. Use SAGE MCP tools for repository work:
|
|
43
|
-
- \`mcp__sage__sage_read_file\` instead of direct \`Read\`
|
|
44
|
-
- \`mcp__sage__sage_grep\` instead of direct \`Grep\`
|
|
45
|
-
- \`mcp__sage__sage_glob\` instead of direct \`Glob\`
|
|
46
|
-
- \`mcp__sage__sage_tree\` instead of direct tree/listing tools
|
|
47
|
-
- \`mcp__sage__sage_write_file\` and \`mcp__sage__sage_edit_file\` instead of direct \`Write\` or \`Edit\`
|
|
48
|
-
|
|
49
41
|
Example user request:
|
|
50
42
|
- User: "Please help me with my general book in this folder"
|
|
51
|
-
- Correct agent start:
|
|
52
|
-
- Wrong agent start:
|
|
43
|
+
- Correct agent start: inspect/read/edit files with available native tools, then use \`${SAGE_RUN_PREFIX} <command>\` only when a terminal command is needed.
|
|
44
|
+
- Wrong agent start: bare \`python\`, \`git\`, \`npm\`, or \`ls\`.
|
|
53
45
|
|
|
54
46
|
ML V1 is included. Optional ML V2 can be installed later by the user with:
|
|
55
47
|
\`npx -y psycgod-sage ml setup\`
|
|
@@ -57,9 +49,8 @@ ${SAGE_BLOCK_END}
|
|
|
57
49
|
`;
|
|
58
50
|
export const SAGE_INSTRUCTION_SHORT = `${SAGE_BLOCK_START}
|
|
59
51
|
# SAGE Integration - MANDATORY
|
|
60
|
-
# Start user repo/file/debugging tasks with SAGE MCP tools when available.
|
|
61
52
|
# Route all shell commands through: ${SAGE_RUN_PREFIX} <command>
|
|
62
|
-
#
|
|
53
|
+
# Backup when npm/npx is unavailable: ${PYPI_RUN_PREFIX} <command>
|
|
63
54
|
${SAGE_BLOCK_END}
|
|
64
55
|
`;
|
|
65
56
|
export const AGENT_TARGETS = [
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../src/install/targets.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAG,4BAA4B,CAAC;AAC5D,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAC7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,4BAA4B,CAAC;AAC7D,MAAM,CAAC,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAEzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,gBAAgB
|
|
1
|
+
{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../src/install/targets.ts"],"names":[],"mappings":"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"}
|