@dk/jolly 0.1.8 → 0.1.9
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 +16 -92
- package/package.json +26 -24
- package/src/index.ts +2095 -0
- package/src/lib/cloud-api.ts +527 -0
- package/src/lib/env-file.ts +68 -0
- package/src/lib/saleor-url.ts +37 -0
- package/.env.example +0 -3
- package/.mcp.json +0 -7
- package/.sisyphus/boulder.json +0 -13
- package/.sisyphus/notepads/saleor-agent-cli/decisions.md +0 -11
- package/.sisyphus/notepads/saleor-agent-cli/issues.md +0 -6
- package/.sisyphus/notepads/saleor-agent-cli/learnings.md +0 -6
- package/.sisyphus/plans/saleor-agent-cli.md +0 -600
- package/AGENTS.md +0 -46
- package/bun.lock +0 -123
- package/bunfig.toml +0 -8
- package/dist/agent.js +0 -258
- package/dist/bootstrap.js +0 -184
- package/dist/index.js +0 -722
- package/src/agents/index.ts +0 -1
- package/src/agents/setup.ts +0 -210
- package/src/api/auth.ts +0 -75
- package/src/api/client.ts +0 -152
- package/src/api/endpoints.ts +0 -8
- package/src/api/index.ts +0 -4
- package/src/cli/agent.ts +0 -26
- package/src/cli/bootstrap.ts +0 -24
- package/src/cli/commands/agent.ts +0 -40
- package/src/cli/commands/app.ts +0 -61
- package/src/cli/commands/config.ts +0 -38
- package/src/cli/commands/store.ts +0 -75
- package/src/cli/index.ts +0 -16
- package/src/commands/app.ts +0 -126
- package/src/commands/index.ts +0 -1
- package/src/commands/store.ts +0 -64
- package/src/test/command-handlers.test.ts +0 -232
- package/src/test/e2e-flows.test.ts +0 -231
- package/src/test/entry-points.test.ts +0 -126
- package/src/test/error-handling.test.ts +0 -137
- package/src/test/helpers.ts +0 -49
- package/src/test/index.ts +0 -1
- package/src/test/mocks.ts +0 -172
- package/src/test/setup.ts +0 -29
- package/src/tui/components.ts +0 -77
- package/src/tui/index.ts +0 -3
- package/src/tui/renderer.ts +0 -34
- package/src/tui/theme.ts +0 -38
- package/tsconfig.json +0 -20
package/README.md
CHANGED
|
@@ -1,121 +1,45 @@
|
|
|
1
|
-
# Jolly
|
|
1
|
+
# Jolly
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Ahoy, agent. Go build a store.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Jolly is a homepage + `npx` CLI + agent setup workflow that helps a customer's own agent set up and iterate on an end-to-end Saleor Cloud storefront.
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
npm install -g @saleor/jolly
|
|
9
|
-
```
|
|
10
|
-
|
|
11
|
-
## Commands
|
|
12
|
-
|
|
13
|
-
### Store Management
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
# Create a new Saleor Cloud store
|
|
17
|
-
jolly store create --name my-store
|
|
18
|
-
|
|
19
|
-
# Create with specific region
|
|
20
|
-
jolly store create --name my-store --region eu-west-1
|
|
21
|
-
|
|
22
|
-
# List your stores
|
|
23
|
-
jolly store list
|
|
24
|
-
|
|
25
|
-
# Create environment
|
|
26
|
-
jolly store env create --store <store-id> --name production
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
### App Scaffolding
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
# Create a dashboard extension
|
|
33
|
-
jolly app create --name my-dashboard --type dashboard-extension
|
|
34
|
-
|
|
35
|
-
# Create a payment app (hosted)
|
|
36
|
-
jolly app create --name my-payment --type payment --provider stripe
|
|
37
|
-
|
|
38
|
-
# Create a webhook handler
|
|
39
|
-
jolly app create --name my-webhook --type webhook
|
|
40
|
-
```
|
|
7
|
+
## Agent workflow
|
|
41
8
|
|
|
42
|
-
|
|
9
|
+
This repository uses Shipshape for its three-role, spec-driven agent workflow.
|
|
43
10
|
|
|
44
|
-
|
|
45
|
-
# Setup AI agent with Saleor skills and MCP
|
|
46
|
-
jolly agent setup
|
|
47
|
-
|
|
48
|
-
# Install skills only
|
|
49
|
-
jolly agent skills install
|
|
50
|
-
|
|
51
|
-
# Setup in specific directory
|
|
52
|
-
jolly agent setup --path /my/project
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
### Configuration
|
|
11
|
+
Before substantive agent work, install or load Shipshape:
|
|
56
12
|
|
|
57
13
|
```bash
|
|
58
|
-
|
|
59
|
-
jolly config deploy --store <store-id>
|
|
60
|
-
|
|
61
|
-
# Introspect current configuration
|
|
62
|
-
jolly config introspect --store <store-id>
|
|
14
|
+
npx skills add dmytri/shipshape --skill '*'
|
|
63
15
|
```
|
|
64
16
|
|
|
65
|
-
|
|
17
|
+
For Claude Code:
|
|
66
18
|
|
|
67
19
|
```bash
|
|
68
|
-
|
|
69
|
-
npm create @saleor/jolly my-project
|
|
70
|
-
|
|
71
|
-
# Configure AI agent for Saleor
|
|
72
|
-
npm init @saleor/jolly
|
|
20
|
+
npx skills add dmytri/shipshape --agent claude-code --skill '*'
|
|
73
21
|
```
|
|
74
22
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
You can set environment variables via a `.env` file:
|
|
23
|
+
For Zed:
|
|
78
24
|
|
|
79
25
|
```bash
|
|
80
|
-
|
|
81
|
-
cp .env.example .env
|
|
82
|
-
|
|
83
|
-
# Edit with your token
|
|
84
|
-
SALEOR_CLOUD_TOKEN=your-token-here
|
|
26
|
+
npx skills add dmytri/shipshape --agent zed --skill '*'
|
|
85
27
|
```
|
|
86
28
|
|
|
87
|
-
|
|
29
|
+
For Pi:
|
|
88
30
|
|
|
89
31
|
```bash
|
|
90
|
-
|
|
32
|
+
pi install npm:pi-shipshape
|
|
91
33
|
```
|
|
92
34
|
|
|
93
|
-
|
|
35
|
+
Read `AGENTS.md` for Jolly-specific constraints and `HANDOVER.md` for current state.
|
|
94
36
|
|
|
95
37
|
## Development
|
|
96
38
|
|
|
97
39
|
```bash
|
|
98
|
-
# Install dependencies
|
|
99
40
|
bun install
|
|
100
|
-
|
|
101
|
-
# Build
|
|
102
|
-
bun run build
|
|
103
|
-
|
|
104
|
-
# Run tests
|
|
105
41
|
bun test
|
|
106
|
-
|
|
107
|
-
|
|
42
|
+
bun run test:logic
|
|
43
|
+
bun run test:bdd
|
|
108
44
|
bun run typecheck
|
|
109
45
|
```
|
|
110
|
-
|
|
111
|
-
## Architecture
|
|
112
|
-
|
|
113
|
-
- **CLI Framework**: yargs for argument parsing
|
|
114
|
-
- **Runtime**: Bun
|
|
115
|
-
- **API Client**: Direct Saleor Cloud API integration
|
|
116
|
-
- **Agent Skills**: saleor/agent-skills from GitHub
|
|
117
|
-
- **MCP**: Official saleor-mcp at mcp.saleor.app
|
|
118
|
-
|
|
119
|
-
## License
|
|
120
|
-
|
|
121
|
-
MIT
|
package/package.json
CHANGED
|
@@ -1,34 +1,36 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@dk/jolly",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.1.9",
|
|
4
|
+
"description": "Ahoy, agent. Go build a Saleor storefront.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
|
-
"jolly": "./
|
|
8
|
-
"create-jolly": "./dist/bootstrap.js",
|
|
9
|
-
"init-jolly": "./dist/agent.js"
|
|
7
|
+
"jolly": "./src/index.ts"
|
|
10
8
|
},
|
|
11
|
-
"
|
|
12
|
-
"
|
|
13
|
-
"
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
"
|
|
17
|
-
"typecheck": "bun tsc --noEmit",
|
|
18
|
-
"release": "npm version patch --no-git-tag-version && npm publish",
|
|
19
|
-
"release:minor": "npm version minor --no-git-tag-version && npm publish",
|
|
20
|
-
"release:major": "npm version major --no-git-tag-version && npm publish"
|
|
9
|
+
"files": [
|
|
10
|
+
"src/",
|
|
11
|
+
"README.md"
|
|
12
|
+
],
|
|
13
|
+
"publishConfig": {
|
|
14
|
+
"access": "public"
|
|
21
15
|
},
|
|
22
|
-
"
|
|
23
|
-
"
|
|
24
|
-
"yargs": "^17.7.2"
|
|
16
|
+
"engines": {
|
|
17
|
+
"bun": ">=1.1.0"
|
|
25
18
|
},
|
|
26
|
-
"
|
|
27
|
-
"
|
|
28
|
-
"
|
|
29
|
-
"
|
|
19
|
+
"scripts": {
|
|
20
|
+
"dev": "bun run --watch src/index.ts",
|
|
21
|
+
"start": "bun run src/index.ts",
|
|
22
|
+
"test": "bun test tests/",
|
|
23
|
+
"test:bdd": "bun x --bun cucumber-js",
|
|
24
|
+
"test:logic": "bun x --bun cucumber-js -p logic",
|
|
25
|
+
"test:sandbox": "bun x --bun cucumber-js -p sandbox",
|
|
26
|
+
"typecheck": "bun x tsc --noEmit"
|
|
30
27
|
},
|
|
31
|
-
"
|
|
32
|
-
"
|
|
28
|
+
"devDependencies": {
|
|
29
|
+
"@cucumber/cucumber": "^11.3.0",
|
|
30
|
+
"@earendil-works/pi-coding-agent": "^0.79.1",
|
|
31
|
+
"@types/bun": "^1.3.14",
|
|
32
|
+
"@types/node": "^22.10.0",
|
|
33
|
+
"happy-dom": "^15.11.0",
|
|
34
|
+
"typescript": "^5.7.0"
|
|
33
35
|
}
|
|
34
36
|
}
|