@cspeach/cli 0.6.2 → 0.6.3

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 (2) hide show
  1. package/README.md +116 -108
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,108 +1,116 @@
1
- # CSPeach
2
-
3
- AI-assisted ABAP development CLI. 34 skills, direct SAP access, safety
4
- gates the model cannot bypass.
5
-
6
- ## Install
7
-
8
- ```bash
9
- npm install -g @cspeach/cli
10
- ```
11
-
12
- Requires Node.js 20+. After install:
13
-
14
- ```bash
15
- cspeach login # opens browser, authorizes this machine
16
- cspeach config add-sap
17
- cspeach # interactive REPL
18
- ```
19
-
20
- ## What it does
21
-
22
- CSPeach runs an AI consultant against your own SAP. Pick a skill (or type a
23
- prompt — the classifier picks one for you):
24
-
25
- ```text
26
- /abap-spec-gap find missing questions before any code is written
27
- /abap-design object list + dependency DAG
28
- /abap-estimate component-level hours with optimistic / realistic /
29
- pessimistic ranges
30
- /abap-cca estate-wide custom-code analysis for S/4HANA
31
- /abap-upgrade-scan baseline scan against the readiness variant
32
- /abap-upgrade-fix interactive fix loop with per-object approval
33
- /abap-incident short dump → fix → verify → handover
34
- cspeach --help full skill list (34 total)
35
- ```
36
-
37
- Every turn runs locally on your machine. SAP source and SAP data flow through
38
- `api.cspeach.dev` to the LLM. The proxy logs request metadata (skill, model,
39
- token counts, latency) for billing; the message body is forwarded to
40
- Anthropic and not stored on the proxy. SAP credentials never leave your
41
- machine.
42
-
43
- ## Safety
44
-
45
- - **Snapshot gate** — every write auto-snapshots first
46
- - **Approval gate** — mutating tools require a single-use JWT bound to
47
- (object, operation); the model sees a plan, you see each change
48
- - **Verify gate** — every write is syntax-checked; activation blocked on errors
49
- - **Transport discipline** — all writes land in your session transport; `$TMP`
50
- is opt-in
51
-
52
- Ten Forge Rules are non-negotiable. Full philosophy in the `CSPeach Principles`
53
- preamble shown to the model every turn.
54
-
55
- ## Configuration
56
-
57
- `~/.cspeach/config.toml` is created on first `cspeach config add-sap`:
58
-
59
- ```toml
60
- proxy_url = "https://api.cspeach.dev"
61
- default_model = "claude-opus-4-7"
62
-
63
- [sap.S4H-DEV]
64
- host = "sap-dev.company.com"
65
- port = 44300
66
- client = "100"
67
- useSsl = true
68
- username = "S.LAEEQ"
69
- ```
70
-
71
- SAP passwords are stored in your OS keychain.
72
-
73
- ## Common commands
74
-
75
- ```text
76
- cspeach login sign in to api.cspeach.dev
77
- cspeach whoami show signed-in identity + plan/trial
78
- cspeach logout clear local auth
79
- cspeach config add-sap add a SAP system
80
- cspeach doctor diagnose install + connectivity
81
- cspeach --resume resume a prior session
82
- cspeach --upgrade pull the latest CLI release
83
- cspeach --version
84
- ```
85
-
86
- ## Troubleshooting
87
-
88
- If `cspeach doctor` fails:
89
-
90
- - **`auth`** — run `cspeach login` again
91
- - **`keychain`** — Windows Credential Manager / libsecret missing; CSPeach
92
- falls back to per-session prompts, slower but functional
93
- - **`sap`** — host unreachable; check VPN + the host/port in config
94
-
95
- If the REPL hangs on first prompt, check `https://api.cspeach.dev/health`.
96
-
97
- ## Links
98
-
99
- - **Landing**: https://cspeach.dev
100
- - **Contact**: laeeq.siddique@cremencing.com
101
- - **LinkedIn**: @laeeqsiddique
102
-
103
- ## License
104
-
105
- Proprietary. Copyright (c) 2026 Cremencing Solutions. All rights reserved.
106
- Free to use under your active [CSPeach plan](https://cspeach.dev); not free
107
- to redistribute, fork, or sublicense. Commercial / OEM licensing:
108
- laeeq.siddique@cremencing.com.
1
+ # CSPeach
2
+
3
+ AI-assisted ABAP development CLI. 34 skills, direct SAP access, safety
4
+ gates the model cannot bypass.
5
+
6
+ ## Install
7
+
8
+ ```bash
9
+ npm install -g @cspeach/cli
10
+ ```
11
+
12
+ Requires Node.js 20+. After install:
13
+
14
+ ```bash
15
+ cspeach login # opens browser, authorizes this machine
16
+ cspeach config add-sap
17
+ cspeach # interactive REPL
18
+ ```
19
+
20
+ ## What it does
21
+
22
+ CSPeach runs an AI consultant against your own SAP. Pick a skill (or type a
23
+ prompt — the classifier picks one for you):
24
+
25
+ ```text
26
+ /abap-spec-gap find missing questions before any code is written
27
+ /abap-design object list + dependency DAG
28
+ /abap-estimate component-level hours with optimistic / realistic /
29
+ pessimistic ranges
30
+ /abap-cca estate-wide custom-code analysis for S/4HANA
31
+ /abap-upgrade-scan baseline scan against the readiness variant
32
+ /abap-upgrade-fix interactive fix loop with per-object approval
33
+ /abap-incident short dump → fix → verify → handover
34
+ cspeach --help full skill list (34 total)
35
+ ```
36
+
37
+ Every turn runs locally on your machine. SAP source and SAP data flow through
38
+ `api.cspeach.dev` to the LLM. The proxy logs request metadata (skill, model,
39
+ token counts, latency) for billing; the message body is forwarded to
40
+ Anthropic and not stored on the proxy. SAP credentials never leave your
41
+ machine.
42
+
43
+ ## Safety
44
+
45
+ - **Snapshot gate** — every SAP write auto-snapshots first
46
+ - **SAP approval gate** — SAP-write and transport tools (`sap_set_source`,
47
+ `sap_create_object`, `sap_delete_object`, `sap_update_method`,
48
+ `sap_activate`, `sap_transport_*`) require a single-use JWT bound to
49
+ (object, operation); the model sees a plan, you approve each change
50
+ - **Optional tools default OFF** — filesystem, shell, web, and subagent
51
+ tools are invisible to the model unless you set `CSPEACH_TOOL_<NAME>=on`
52
+ in the environment
53
+ - **Batch-write interrupt** — any second mutating call in a single turn
54
+ (Rule 8, any tool category) pauses for an explicit yes/no before it runs
55
+ - **Verify gate** — every SAP write is syntax-checked; activation blocked on
56
+ errors
57
+ - **Transport discipline** — all SAP writes land in your session transport;
58
+ `$TMP` is opt-in
59
+
60
+ Ten Forge Rules are non-negotiable. Full philosophy in the `CSPeach Principles`
61
+ preamble shown to the model every turn.
62
+
63
+ ## Configuration
64
+
65
+ `~/.cspeach/config.toml` is created on first `cspeach config add-sap`:
66
+
67
+ ```toml
68
+ proxy_url = "https://api.cspeach.dev"
69
+ default_model = "claude-opus-4-7"
70
+
71
+ [sap.S4H-DEV]
72
+ host = "sap-dev.company.com"
73
+ port = 44300
74
+ client = "100"
75
+ useSsl = true
76
+ username = "S.LAEEQ"
77
+ ```
78
+
79
+ SAP passwords are stored in your OS keychain.
80
+
81
+ ## Common commands
82
+
83
+ ```text
84
+ cspeach login sign in to api.cspeach.dev
85
+ cspeach whoami show signed-in identity + plan/trial
86
+ cspeach logout clear local auth
87
+ cspeach config add-sap add a SAP system
88
+ cspeach doctor diagnose install + connectivity
89
+ cspeach --resume resume a prior session
90
+ cspeach --upgrade pull the latest CLI release
91
+ cspeach --version
92
+ ```
93
+
94
+ ## Troubleshooting
95
+
96
+ If `cspeach doctor` fails:
97
+
98
+ - **`auth`** — run `cspeach login` again
99
+ - **`keychain`** — Windows Credential Manager / libsecret missing; CSPeach
100
+ falls back to per-session prompts, slower but functional
101
+ - **`sap`** — host unreachable; check VPN + the host/port in config
102
+
103
+ If the REPL hangs on first prompt, check `https://api.cspeach.dev/health`.
104
+
105
+ ## Links
106
+
107
+ - **Landing**: https://cspeach.dev
108
+ - **Contact**: laeeq.siddique@cremencing.com
109
+ - **LinkedIn**: @laeeqsiddique
110
+
111
+ ## License
112
+
113
+ Proprietary. Copyright (c) 2026 Cremencing Solutions. All rights reserved.
114
+ Free to use under your active [CSPeach plan](https://cspeach.dev); not free
115
+ to redistribute, fork, or sublicense. Commercial / OEM licensing:
116
+ laeeq.siddique@cremencing.com.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@cspeach/cli",
3
- "version": "0.6.2",
4
- "description": "CSPeach — AI-assisted ABAP development CLI. Direct SAP access, 33 skills, safety gates.",
3
+ "version": "0.6.3",
4
+ "description": "CSPeach — AI-assisted ABAP development CLI. Direct SAP access, 34 skills, safety gates.",
5
5
  "keywords": [
6
6
  "abap",
7
7
  "sap",