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.
Files changed (92) hide show
  1. package/README.md +58 -11
  2. package/dist/cli.js +7 -0
  3. package/dist/cli.js.map +1 -1
  4. package/dist/commands/bench.d.ts +1 -1
  5. package/dist/commands/bench.js +126 -2
  6. package/dist/commands/bench.js.map +1 -1
  7. package/dist/commands/context.d.ts +2 -0
  8. package/dist/commands/context.js +27 -0
  9. package/dist/commands/context.js.map +1 -0
  10. package/dist/commands/hooks.d.ts +3 -0
  11. package/dist/commands/hooks.js +45 -8
  12. package/dist/commands/hooks.js.map +1 -1
  13. package/dist/commands/init.js +220 -1
  14. package/dist/commands/init.js.map +1 -1
  15. package/dist/commands/mcp.d.ts +2 -0
  16. package/dist/commands/mcp.js +21 -0
  17. package/dist/commands/mcp.js.map +1 -0
  18. package/dist/commands/memory.d.ts +1 -0
  19. package/dist/commands/memory.js +2 -1
  20. package/dist/commands/memory.js.map +1 -1
  21. package/dist/commands/release.js +178 -7
  22. package/dist/commands/release.js.map +1 -1
  23. package/dist/commands/skills.d.ts +2 -0
  24. package/dist/commands/skills.js +43 -0
  25. package/dist/commands/skills.js.map +1 -0
  26. package/dist/core/config.d.ts +5 -0
  27. package/dist/core/config.js +12 -2
  28. package/dist/core/config.js.map +1 -1
  29. package/dist/core/context-pack.d.ts +13 -0
  30. package/dist/core/context-pack.js +102 -0
  31. package/dist/core/context-pack.js.map +1 -0
  32. package/dist/core/mcp-resources.d.ts +13 -0
  33. package/dist/core/mcp-resources.js +46 -0
  34. package/dist/core/mcp-resources.js.map +1 -0
  35. package/dist/core/mcp-server.d.ts +14 -0
  36. package/dist/core/mcp-server.js +81 -0
  37. package/dist/core/mcp-server.js.map +1 -0
  38. package/dist/core/mcp-tools.d.ts +7 -0
  39. package/dist/core/mcp-tools.js +73 -0
  40. package/dist/core/mcp-tools.js.map +1 -0
  41. package/dist/core/release-preflight.js +2 -0
  42. package/dist/core/release-preflight.js.map +1 -1
  43. package/dist/core/skill-exporter.d.ts +3 -0
  44. package/dist/core/skill-exporter.js +72 -0
  45. package/dist/core/skill-exporter.js.map +1 -0
  46. package/dist/core/skill-schema.d.ts +55 -0
  47. package/dist/core/skill-schema.js +91 -0
  48. package/dist/core/skill-schema.js.map +1 -0
  49. package/dist/core/skill-store.d.ts +4 -0
  50. package/dist/core/skill-store.js +139 -0
  51. package/dist/core/skill-store.js.map +1 -0
  52. package/dist/core/skill-validator.d.ts +12 -0
  53. package/dist/core/skill-validator.js +94 -0
  54. package/dist/core/skill-validator.js.map +1 -0
  55. package/dist/core/version.d.ts +1 -1
  56. package/dist/core/version.js +1 -1
  57. package/docs/benchmarking.md +6 -1
  58. package/docs/comparisons.md +35 -0
  59. package/docs/context-packs.md +39 -0
  60. package/docs/examples/skills/README.md +11 -0
  61. package/docs/first-real-workflow.md +60 -0
  62. package/docs/hooks/claude.md +6 -4
  63. package/docs/hooks/codex.md +4 -3
  64. package/docs/hooks/cursor.md +4 -3
  65. package/docs/hooks/gemini.md +4 -3
  66. package/docs/hooks/mcp.md +10 -0
  67. package/docs/hooks.md +18 -15
  68. package/docs/mcp.md +60 -0
  69. package/docs/release-checklist.md +3 -0
  70. package/docs/release-workflow.md +15 -22
  71. package/docs/security-model.md +6 -0
  72. package/docs/skill-rail.md +18 -20
  73. package/docs/usage.md +23 -0
  74. package/docs/windows.md +21 -1
  75. package/docs/workflow-rail.md +7 -1
  76. package/examples/README.md +22 -0
  77. package/examples/context-packs/README.md +17 -0
  78. package/examples/context-packs/generic-workflow.md +9 -0
  79. package/examples/hooks/README.md +11 -0
  80. package/examples/hooks/prompt-only-codex.md +7 -0
  81. package/examples/mcp/README.md +17 -0
  82. package/examples/mcp/initialize.json +1 -0
  83. package/examples/mcp/resources-list.json +1 -0
  84. package/examples/mcp/resources-read-repo-map.json +1 -0
  85. package/examples/mcp/tools-list.json +1 -0
  86. package/examples/skills/README.md +13 -0
  87. package/examples/skills/bug-triage-skill.yml +26 -0
  88. package/examples/skills/code-review-skill.yml +28 -0
  89. package/examples/skills/java-student-helper-skill.yml +25 -0
  90. package/examples/skills/php-web-reviewer-skill.yml +27 -0
  91. package/examples/skills/release-manager-skill.yml +26 -0
  92. 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.2.3",
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 scripts/release.mjs check",
34
- "release:prepare": "node scripts/release.mjs prepare",
35
- "release:publish": "node scripts/release.mjs publish",
36
- "release:full": "node scripts/release.mjs full"
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",