soturail 0.2.3 → 0.3.1
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 +58 -11
- package/dist/cli.js +7 -0
- package/dist/cli.js.map +1 -1
- package/dist/commands/bench.d.ts +1 -1
- package/dist/commands/bench.js +126 -2
- package/dist/commands/bench.js.map +1 -1
- package/dist/commands/context.d.ts +2 -0
- package/dist/commands/context.js +27 -0
- package/dist/commands/context.js.map +1 -0
- package/dist/commands/hooks.d.ts +3 -0
- package/dist/commands/hooks.js +45 -8
- package/dist/commands/hooks.js.map +1 -1
- package/dist/commands/init.js +220 -1
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/mcp.d.ts +2 -0
- package/dist/commands/mcp.js +21 -0
- package/dist/commands/mcp.js.map +1 -0
- package/dist/commands/memory.d.ts +1 -0
- package/dist/commands/memory.js +2 -1
- package/dist/commands/memory.js.map +1 -1
- package/dist/commands/release.js +178 -7
- package/dist/commands/release.js.map +1 -1
- package/dist/commands/skills.d.ts +2 -0
- package/dist/commands/skills.js +43 -0
- package/dist/commands/skills.js.map +1 -0
- package/dist/core/config.d.ts +5 -0
- package/dist/core/config.js +12 -2
- package/dist/core/config.js.map +1 -1
- package/dist/core/context-pack.d.ts +13 -0
- package/dist/core/context-pack.js +102 -0
- package/dist/core/context-pack.js.map +1 -0
- package/dist/core/mcp-resources.d.ts +13 -0
- package/dist/core/mcp-resources.js +46 -0
- package/dist/core/mcp-resources.js.map +1 -0
- package/dist/core/mcp-server.d.ts +14 -0
- package/dist/core/mcp-server.js +81 -0
- package/dist/core/mcp-server.js.map +1 -0
- package/dist/core/mcp-tools.d.ts +7 -0
- package/dist/core/mcp-tools.js +73 -0
- package/dist/core/mcp-tools.js.map +1 -0
- package/dist/core/release-preflight.js +2 -0
- package/dist/core/release-preflight.js.map +1 -1
- package/dist/core/skill-exporter.d.ts +3 -0
- package/dist/core/skill-exporter.js +72 -0
- package/dist/core/skill-exporter.js.map +1 -0
- package/dist/core/skill-schema.d.ts +55 -0
- package/dist/core/skill-schema.js +91 -0
- package/dist/core/skill-schema.js.map +1 -0
- package/dist/core/skill-store.d.ts +4 -0
- package/dist/core/skill-store.js +139 -0
- package/dist/core/skill-store.js.map +1 -0
- package/dist/core/skill-validator.d.ts +12 -0
- package/dist/core/skill-validator.js +94 -0
- package/dist/core/skill-validator.js.map +1 -0
- package/dist/core/version.d.ts +1 -1
- package/dist/core/version.js +1 -1
- package/docs/benchmarking.md +6 -1
- package/docs/comparisons.md +35 -0
- package/docs/context-packs.md +39 -0
- package/docs/examples/skills/README.md +11 -0
- package/docs/first-real-workflow.md +60 -0
- package/docs/hooks/claude.md +6 -4
- package/docs/hooks/codex.md +4 -3
- package/docs/hooks/cursor.md +4 -3
- package/docs/hooks/gemini.md +4 -3
- package/docs/hooks/mcp.md +10 -0
- package/docs/hooks.md +18 -15
- package/docs/mcp.md +60 -0
- package/docs/release-checklist.md +3 -0
- package/docs/release-workflow.md +15 -22
- package/docs/security-model.md +6 -0
- package/docs/skill-rail.md +18 -20
- package/docs/usage.md +23 -0
- package/docs/windows.md +21 -1
- package/docs/workflow-rail.md +7 -1
- package/examples/README.md +22 -0
- package/examples/context-packs/README.md +17 -0
- package/examples/context-packs/generic-workflow.md +9 -0
- package/examples/hooks/README.md +11 -0
- package/examples/hooks/prompt-only-codex.md +7 -0
- package/examples/mcp/README.md +17 -0
- package/examples/mcp/initialize.json +1 -0
- package/examples/mcp/resources-list.json +1 -0
- package/examples/mcp/resources-read-repo-map.json +1 -0
- package/examples/mcp/tools-list.json +1 -0
- package/examples/skills/README.md +13 -0
- package/examples/skills/bug-triage-skill.yml +26 -0
- package/examples/skills/code-review-skill.yml +28 -0
- package/examples/skills/java-student-helper-skill.yml +25 -0
- package/examples/skills/php-web-reviewer-skill.yml +27 -0
- package/examples/skills/release-manager-skill.yml +26 -0
- package/package.json +8 -6
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
id: bug-triage
|
|
2
|
+
name: Bug Triage
|
|
3
|
+
description: Turn a bug report into reproduction steps, likely causes, evidence and verification commands.
|
|
4
|
+
version: 0.1.0
|
|
5
|
+
author: Rafael Ryan Ramos de Souza
|
|
6
|
+
risk_level: low
|
|
7
|
+
targets:
|
|
8
|
+
- claude
|
|
9
|
+
- codex
|
|
10
|
+
- gemini
|
|
11
|
+
- cursor
|
|
12
|
+
- generic
|
|
13
|
+
allowed_tools:
|
|
14
|
+
- read
|
|
15
|
+
- search
|
|
16
|
+
- summarize
|
|
17
|
+
- format
|
|
18
|
+
forbidden_patterns:
|
|
19
|
+
- rm -rf
|
|
20
|
+
- curl | sh
|
|
21
|
+
- secret exfiltration
|
|
22
|
+
requires_human_approval:
|
|
23
|
+
- destructive_command
|
|
24
|
+
- remote_write
|
|
25
|
+
created_at: 2026-05-21T00:00:00.000Z
|
|
26
|
+
content_hash: 0000000000000000000000000000000000000000000000000000000000000000
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
id: code-review
|
|
2
|
+
name: Code Review
|
|
3
|
+
description: Review code changes for correctness, safety, regression risk and missing tests.
|
|
4
|
+
version: 0.1.0
|
|
5
|
+
author: Rafael Ryan Ramos de Souza
|
|
6
|
+
risk_level: low
|
|
7
|
+
targets:
|
|
8
|
+
- claude
|
|
9
|
+
- codex
|
|
10
|
+
- gemini
|
|
11
|
+
- cursor
|
|
12
|
+
- generic
|
|
13
|
+
allowed_tools:
|
|
14
|
+
- read
|
|
15
|
+
- search
|
|
16
|
+
- summarize
|
|
17
|
+
- format
|
|
18
|
+
forbidden_patterns:
|
|
19
|
+
- rm -rf
|
|
20
|
+
- curl | sh
|
|
21
|
+
- git push
|
|
22
|
+
- secret exfiltration
|
|
23
|
+
requires_human_approval:
|
|
24
|
+
- destructive_command
|
|
25
|
+
- remote_write
|
|
26
|
+
- dependency_install
|
|
27
|
+
created_at: 2026-05-21T00:00:00.000Z
|
|
28
|
+
content_hash: 0000000000000000000000000000000000000000000000000000000000000000
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
id: java-student-helper
|
|
2
|
+
name: Java Student Helper
|
|
3
|
+
description: Help review Java exercises with explanations, compiler diagnostics and safe next practice steps.
|
|
4
|
+
version: 0.1.0
|
|
5
|
+
author: Rafael Ryan Ramos de Souza
|
|
6
|
+
risk_level: low
|
|
7
|
+
targets:
|
|
8
|
+
- claude
|
|
9
|
+
- codex
|
|
10
|
+
- gemini
|
|
11
|
+
- cursor
|
|
12
|
+
- generic
|
|
13
|
+
allowed_tools:
|
|
14
|
+
- read
|
|
15
|
+
- search
|
|
16
|
+
- summarize
|
|
17
|
+
- format
|
|
18
|
+
forbidden_patterns:
|
|
19
|
+
- delete student files without approval
|
|
20
|
+
- secret exfiltration
|
|
21
|
+
requires_human_approval:
|
|
22
|
+
- destructive_command
|
|
23
|
+
- dependency_install
|
|
24
|
+
created_at: 2026-05-21T00:00:00.000Z
|
|
25
|
+
content_hash: 0000000000000000000000000000000000000000000000000000000000000000
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
id: php-web-reviewer
|
|
2
|
+
name: PHP Web Reviewer
|
|
3
|
+
description: Review PHP web changes for routing, validation, database safety and deployment risk.
|
|
4
|
+
version: 0.1.0
|
|
5
|
+
author: Rafael Ryan Ramos de Souza
|
|
6
|
+
risk_level: medium
|
|
7
|
+
targets:
|
|
8
|
+
- claude
|
|
9
|
+
- codex
|
|
10
|
+
- gemini
|
|
11
|
+
- cursor
|
|
12
|
+
- generic
|
|
13
|
+
allowed_tools:
|
|
14
|
+
- read
|
|
15
|
+
- search
|
|
16
|
+
- summarize
|
|
17
|
+
- format
|
|
18
|
+
forbidden_patterns:
|
|
19
|
+
- dumping environment variables
|
|
20
|
+
- committing credentials
|
|
21
|
+
- secret exfiltration
|
|
22
|
+
requires_human_approval:
|
|
23
|
+
- destructive_command
|
|
24
|
+
- remote_write
|
|
25
|
+
- dependency_install
|
|
26
|
+
created_at: 2026-05-21T00:00:00.000Z
|
|
27
|
+
content_hash: 0000000000000000000000000000000000000000000000000000000000000000
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
id: release-manager
|
|
2
|
+
name: Release Manager
|
|
3
|
+
description: Prepare release validation, changelog notes, npm package checks and GitHub release evidence.
|
|
4
|
+
version: 0.1.0
|
|
5
|
+
author: Rafael Ryan Ramos de Souza
|
|
6
|
+
risk_level: medium
|
|
7
|
+
targets:
|
|
8
|
+
- claude
|
|
9
|
+
- codex
|
|
10
|
+
- gemini
|
|
11
|
+
- cursor
|
|
12
|
+
- generic
|
|
13
|
+
allowed_tools:
|
|
14
|
+
- read
|
|
15
|
+
- search
|
|
16
|
+
- summarize
|
|
17
|
+
- format
|
|
18
|
+
forbidden_patterns:
|
|
19
|
+
- npm publish without validation
|
|
20
|
+
- git push without explicit user request
|
|
21
|
+
- secret exfiltration
|
|
22
|
+
requires_human_approval:
|
|
23
|
+
- remote_write
|
|
24
|
+
- dependency_install
|
|
25
|
+
created_at: 2026-05-21T00:00:00.000Z
|
|
26
|
+
content_hash: 0000000000000000000000000000000000000000000000000000000000000000
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "soturail",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.1",
|
|
4
4
|
"description": "Local-first context rails for AI coding agents: reversible terminal compression, progressive repo reading, SDD workflows, hooks, benchmarks, memory and cache-friendly payloads.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -13,7 +13,8 @@
|
|
|
13
13
|
"dist",
|
|
14
14
|
"README.md",
|
|
15
15
|
"LICENSE",
|
|
16
|
-
"docs"
|
|
16
|
+
"docs",
|
|
17
|
+
"examples"
|
|
17
18
|
],
|
|
18
19
|
"scripts": {
|
|
19
20
|
"sync:version": "node scripts/sync-version.mjs",
|
|
@@ -30,10 +31,11 @@
|
|
|
30
31
|
"bench:report": "node dist/cli.js bench report",
|
|
31
32
|
"bench:native": "node dist/cli.js bench run --engine native",
|
|
32
33
|
"bench:compare": "node dist/cli.js bench compare-engines",
|
|
33
|
-
"release:check": "node
|
|
34
|
-
"release:
|
|
35
|
-
"release:publish": "node
|
|
36
|
-
"release:
|
|
34
|
+
"release:check": "npm run build && node dist/cli.js release check",
|
|
35
|
+
"release:notes": "npm run build && node dist/cli.js release notes",
|
|
36
|
+
"release:publish": "npm run build && node dist/cli.js release publish",
|
|
37
|
+
"release:github": "npm run build && node dist/cli.js release github",
|
|
38
|
+
"release:full": "npm run build && node dist/cli.js release full"
|
|
37
39
|
},
|
|
38
40
|
"keywords": [
|
|
39
41
|
"ai-agents",
|