@produck/agent-toolkit 0.1.4 → 0.1.5
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 +40 -50
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -14,34 +14,46 @@ Central CLI toolkit for organization-level AI execution workflows.
|
|
|
14
14
|
|
|
15
15
|
Run preflight checks:
|
|
16
16
|
|
|
17
|
+
```bash
|
|
17
18
|
npm exec --package=@produck/agent-toolkit@latest \
|
|
18
|
-
|
|
19
|
+
agent-toolkit preflight --cwd . --require package.json --ensure-dir logs
|
|
20
|
+
```
|
|
19
21
|
|
|
20
22
|
Capture long output safely:
|
|
21
23
|
|
|
24
|
+
```bash
|
|
22
25
|
npm exec --package=@produck/agent-toolkit@latest \
|
|
23
|
-
|
|
26
|
+
agent-toolkit run-capture --cwd . --cmd "npm run test" --out logs/test.log
|
|
27
|
+
```
|
|
24
28
|
|
|
25
29
|
Summarize captured output:
|
|
26
30
|
|
|
31
|
+
```bash
|
|
27
32
|
npm exec --package=@produck/agent-toolkit@latest \
|
|
28
|
-
|
|
33
|
+
agent-toolkit summarize-log --file logs/test.log --match "FAIL|ERROR"
|
|
34
|
+
```
|
|
29
35
|
|
|
30
36
|
Validate commit message format:
|
|
31
37
|
|
|
38
|
+
```bash
|
|
32
39
|
npm exec --package=@produck/agent-toolkit@latest \
|
|
33
|
-
|
|
40
|
+
agent-toolkit validate-commit-msg --file .git/COMMIT_EDITMSG
|
|
41
|
+
```
|
|
34
42
|
|
|
35
43
|
Manual per-repository instruction distribution (write .instructions.md):
|
|
36
44
|
|
|
45
|
+
```bash
|
|
37
46
|
npm exec --package=@produck/agent-toolkit@latest \
|
|
38
|
-
|
|
47
|
+
agent-toolkit sync-instructions --cwd .
|
|
48
|
+
```
|
|
39
49
|
|
|
40
50
|
Use organization source file instead of built-in template:
|
|
41
51
|
|
|
52
|
+
```bash
|
|
42
53
|
npm exec --package=@produck/agent-toolkit@latest \
|
|
43
|
-
|
|
44
|
-
|
|
54
|
+
agent-toolkit sync-instructions --cwd . \
|
|
55
|
+
--source path/to/org/.instructions.md --force
|
|
56
|
+
```
|
|
45
57
|
|
|
46
58
|
Built-in template location (for review and updates):
|
|
47
59
|
|
|
@@ -52,53 +64,30 @@ Built-in template location (for review and updates):
|
|
|
52
64
|
|
|
53
65
|
From repository root:
|
|
54
66
|
|
|
67
|
+
```bash
|
|
55
68
|
npm --workspace @produck/agent-toolkit run verify
|
|
56
69
|
npm --workspace @produck/agent-toolkit run pack:check
|
|
70
|
+
```
|
|
57
71
|
|
|
58
|
-
##
|
|
72
|
+
## Publishing
|
|
59
73
|
|
|
60
|
-
|
|
74
|
+
Publishing is centralized at workspace root via lerna, not via
|
|
75
|
+
package-level release scripts.
|
|
61
76
|
|
|
62
|
-
|
|
77
|
+
From monorepo root (`produck/.github`):
|
|
63
78
|
|
|
64
|
-
|
|
79
|
+
```bash
|
|
80
|
+
npm run format:check
|
|
81
|
+
npm run test
|
|
82
|
+
npm run publish:dry-run
|
|
83
|
+
npm run publish
|
|
84
|
+
```
|
|
65
85
|
|
|
66
|
-
|
|
86
|
+
Notes:
|
|
67
87
|
|
|
68
|
-
-
|
|
69
|
-
|
|
70
|
-
-
|
|
71
|
-
|
|
72
|
-
Default choices:
|
|
73
|
-
|
|
74
|
-
- patch
|
|
75
|
-
- dry-run
|
|
76
|
-
- commit + tag
|
|
77
|
-
|
|
78
|
-
Interactive mode handles both:
|
|
79
|
-
|
|
80
|
-
- version bump level (patch/minor/major)
|
|
81
|
-
- action mode (dry-run or publish)
|
|
82
|
-
- auto commit and tag after dry-run
|
|
83
|
-
|
|
84
|
-
Non-interactive flags:
|
|
85
|
-
|
|
86
|
-
- `npm --workspace @produck/agent-toolkit run release -- patch --publish`
|
|
87
|
-
- `npm --workspace @produck/agent-toolkit run release -- patch --no-tag`
|
|
88
|
-
- `npm --workspace @produck/agent-toolkit run release -- patch --no-commit --no-tag`
|
|
89
|
-
|
|
90
|
-
Note:
|
|
91
|
-
|
|
92
|
-
- Release requires a clean working tree in `packages/agent-toolkit` before
|
|
93
|
-
start.
|
|
94
|
-
- After release success, push commit and tags:
|
|
95
|
-
- `git -C d:/workspace/PRODUCK/.github push`
|
|
96
|
-
- `git -C d:/workspace/PRODUCK/.github push --tags`
|
|
97
|
-
|
|
98
|
-
Low-level commands (optional):
|
|
99
|
-
|
|
100
|
-
npm --workspace @produck/agent-toolkit run publish:dry-run
|
|
101
|
-
npm --workspace @produck/agent-toolkit run publish:latest
|
|
88
|
+
- `publish:dry-run` validates package contents by running `npm pack --dry-run`
|
|
89
|
+
across non-private workspace packages.
|
|
90
|
+
- `publish` runs lerna publish flow from workspace root.
|
|
102
91
|
|
|
103
92
|
## GitHub workflow
|
|
104
93
|
|
|
@@ -108,19 +97,20 @@ Repository includes manual workflow:
|
|
|
108
97
|
|
|
109
98
|
Workflow behavior:
|
|
110
99
|
|
|
111
|
-
- Always runs verify
|
|
100
|
+
- Always runs verify and pack:check for `@produck/agent-toolkit`.
|
|
112
101
|
- Does not publish to npm.
|
|
113
|
-
- Used as release gate before
|
|
102
|
+
- Used as release gate before workspace-level publish.
|
|
114
103
|
|
|
115
104
|
Release policy:
|
|
116
105
|
|
|
117
106
|
- Default organization usage is @latest.
|
|
118
|
-
- Run
|
|
107
|
+
- Run format:check and test first, then workspace `publish:dry-run` before
|
|
108
|
+
`publish`.
|
|
119
109
|
- Keep rollback option by republishing previous stable version if needed.
|
|
120
110
|
|
|
121
111
|
Rollback quick steps:
|
|
122
112
|
|
|
123
113
|
1. Check latest published version:
|
|
124
114
|
`npm view @produck/agent-toolkit version`
|
|
125
|
-
2. Fix source and
|
|
115
|
+
2. Fix source and rerun workspace publish flow with a new version.
|
|
126
116
|
3. Push commit and tags.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@produck/agent-toolkit",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.5",
|
|
4
4
|
"description": "Central CLI toolkit for organization AI execution workflows",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"repository": {
|
|
@@ -26,5 +26,5 @@
|
|
|
26
26
|
"node": ">=18.0.0"
|
|
27
27
|
},
|
|
28
28
|
"license": "MIT",
|
|
29
|
-
"gitHead": "
|
|
29
|
+
"gitHead": "13afa6b9d747360fedf569a619274d90a038c0f3"
|
|
30
30
|
}
|