@holdpoint/cli 0.1.0-alpha.14 → 0.1.0-alpha.16
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/dist/builder-ui/assets/{index-CaEfVl3b.js → index-DezgTDRo.js} +4 -4
- package/dist/builder-ui/assets/{index-CaEfVl3b.js.map → index-DezgTDRo.js.map} +1 -1
- package/dist/builder-ui/index.html +1 -1
- package/dist/index.js +861 -113
- package/dist/index.js.map +1 -1
- package/dist/templates/HOLDPOINT_PREREQUISITES.md +9 -0
- package/dist/templates/MASTER_PROMPT.md +15 -15
- package/dist/templates/_base.yaml +1 -1
- package/dist/templates/fullstack.yaml +1 -1
- package/dist/templates/go.yaml +1 -1
- package/dist/templates/nextjs.yaml +1 -1
- package/dist/templates/python.yaml +1 -1
- package/dist/templates/typescript.yaml +1 -1
- package/package.json +11 -8
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# Holdpoint prerequisites
|
|
2
|
+
|
|
3
|
+
Holdpoint installed repo-local adapters for one or more AI coding agents. Before relying on them locally, review these setup notes:
|
|
4
|
+
|
|
5
|
+
- **GitHub Copilot CLI** — Holdpoint's `.github/extensions/holdpoint/extension.mjs` uses the Copilot CLI **EXTENSIONS** feature. Today that feature is gated behind experimental mode. In Copilot CLI, run `/experimental on` so **EXTENSIONS** appears in the enabled feature set before using Holdpoint locally.
|
|
6
|
+
- **OpenAI Codex** — project-level hooks require trust approval. Run `codex trust` in the Codex TUI or review the hook with `/hooks`.
|
|
7
|
+
- **General** — Holdpoint expects Node.js 18+ and a git repository so `holdpoint init`, `holdpoint update`, and `holdpoint check` can run normally.
|
|
8
|
+
|
|
9
|
+
Docs: https://holdpoint.dev/docs
|
|
@@ -9,7 +9,7 @@ eval checkpoints. Before marking any task done, all checks must pass.
|
|
|
9
9
|
|
|
10
10
|
Before marking **any** task complete:
|
|
11
11
|
|
|
12
|
-
1. Run `
|
|
12
|
+
1. Run `holdpoint check` — all tasks must exit 0.
|
|
13
13
|
2. `holdpoint check` also prints every **prompt** check whose `when` matches the
|
|
14
14
|
files you changed. Read and act on each listed instruction before finishing.
|
|
15
15
|
|
|
@@ -19,12 +19,12 @@ Before marking **any** task complete:
|
|
|
19
19
|
|
|
20
20
|
`checks.yaml` is not static — it grows alongside the project automatically.
|
|
21
21
|
|
|
22
|
-
**`holdpoint-evolve` is a deterministic check** in `checks.yaml` that fires whenever you change a structural file (`package.json`, `pyproject.toml`, `go.mod`, `Dockerfile`, `tsconfig.json`, `vitest.config.*`, etc.). When it fires, `
|
|
22
|
+
**`holdpoint-evolve` is a deterministic check** in `checks.yaml` that fires whenever you change a structural file (`package.json`, `pyproject.toml`, `go.mod`, `Dockerfile`, `tsconfig.json`, `vitest.config.*`, etc.). When it fires, `holdpoint evolve` runs and **exits 1 if `checks.yaml` is out of sync** — blocking task completion until you apply the proposals.
|
|
23
23
|
|
|
24
24
|
When blocked by `holdpoint-evolve`, run:
|
|
25
25
|
|
|
26
26
|
```
|
|
27
|
-
|
|
27
|
+
holdpoint evolve --apply # scan, apply proposals, regenerate engine files
|
|
28
28
|
```
|
|
29
29
|
|
|
30
30
|
Then commit:
|
|
@@ -56,7 +56,7 @@ remove, or change checkpoints.
|
|
|
56
56
|
After every edit, regenerate the engine files and commit everything together:
|
|
57
57
|
|
|
58
58
|
```
|
|
59
|
-
|
|
59
|
+
holdpoint update
|
|
60
60
|
git add checks.yaml .github/holdpoint/generated/ .github/hooks/
|
|
61
61
|
git commit -m "chore: update holdpoint checks"
|
|
62
62
|
```
|
|
@@ -200,7 +200,7 @@ context:
|
|
|
200
200
|
|
|
201
201
|
1. Open `checks.yaml`.
|
|
202
202
|
2. Add your entry under `checks:`.
|
|
203
|
-
3. Run `
|
|
203
|
+
3. Run `holdpoint update`.
|
|
204
204
|
4. Commit `checks.yaml` and the generated files.
|
|
205
205
|
|
|
206
206
|
**Add a task check (runs a shell command automatically):**
|
|
@@ -283,15 +283,15 @@ skipped.
|
|
|
283
283
|
|
|
284
284
|
## Commands
|
|
285
285
|
|
|
286
|
-
| Command
|
|
287
|
-
|
|
|
288
|
-
| `
|
|
289
|
-
| `
|
|
290
|
-
| `
|
|
291
|
-
| `
|
|
292
|
-
| `
|
|
293
|
-
| `
|
|
294
|
-
| `
|
|
286
|
+
| Command | What it does |
|
|
287
|
+
| -------------------------- | ------------------------------------------------------- |
|
|
288
|
+
| `holdpoint check` | Run checks against all files changed vs HEAD |
|
|
289
|
+
| `holdpoint check --staged` | Run checks against staged files only |
|
|
290
|
+
| `holdpoint evolve` | Scan project and show proposed additions to checks.yaml |
|
|
291
|
+
| `holdpoint evolve --apply` | Apply proposals and regenerate engine files |
|
|
292
|
+
| `holdpoint update` | Regenerate engine files from the current `checks.yaml` |
|
|
293
|
+
| `holdpoint validate` | Validate `checks.yaml` schema (no commands run) |
|
|
294
|
+
| `holdpoint builder` | Open the visual builder UI at localhost:4321 |
|
|
295
295
|
|
|
296
296
|
---
|
|
297
297
|
|
|
@@ -305,5 +305,5 @@ skipped.
|
|
|
305
305
|
| `.claude/settings.json` | Claude |
|
|
306
306
|
| `.cursorrules` (Holdpoint section) | Cursor |
|
|
307
307
|
|
|
308
|
-
All generated files are overwritten by `
|
|
308
|
+
All generated files are overwritten by `holdpoint update`. Edit `checks.yaml`,
|
|
309
309
|
then run `update` — never edit the generated files directly.
|
|
@@ -50,7 +50,7 @@ checks:
|
|
|
50
50
|
- id: holdpoint-evolve
|
|
51
51
|
label: "Evolve checks when project structure changes"
|
|
52
52
|
when: structural
|
|
53
|
-
cmd: "
|
|
53
|
+
cmd: "node_modules/.bin/holdpoint evolve"
|
|
54
54
|
|
|
55
55
|
- id: git-commit
|
|
56
56
|
label: "Commit all changes before finishing"
|
|
@@ -86,7 +86,7 @@ checks:
|
|
|
86
86
|
- id: holdpoint-evolve
|
|
87
87
|
label: "Evolve checks when project structure changes"
|
|
88
88
|
when: structural
|
|
89
|
-
cmd: "
|
|
89
|
+
cmd: "node_modules/.bin/holdpoint evolve"
|
|
90
90
|
|
|
91
91
|
- id: git-commit
|
|
92
92
|
label: "Commit all changes before finishing"
|
package/dist/templates/go.yaml
CHANGED
|
@@ -53,7 +53,7 @@ checks:
|
|
|
53
53
|
- id: holdpoint-evolve
|
|
54
54
|
label: "Evolve checks when project structure changes"
|
|
55
55
|
when: structural
|
|
56
|
-
cmd: "
|
|
56
|
+
cmd: "node_modules/.bin/holdpoint evolve"
|
|
57
57
|
|
|
58
58
|
- id: git-commit
|
|
59
59
|
label: "Commit all changes before finishing"
|
|
@@ -69,7 +69,7 @@ checks:
|
|
|
69
69
|
- id: holdpoint-evolve
|
|
70
70
|
label: "Evolve checks when project structure changes"
|
|
71
71
|
when: structural
|
|
72
|
-
cmd: "
|
|
72
|
+
cmd: "node_modules/.bin/holdpoint evolve"
|
|
73
73
|
|
|
74
74
|
- id: git-commit
|
|
75
75
|
label: "Commit all changes before finishing"
|
|
@@ -53,7 +53,7 @@ checks:
|
|
|
53
53
|
- id: holdpoint-evolve
|
|
54
54
|
label: "Evolve checks when project structure changes"
|
|
55
55
|
when: structural
|
|
56
|
-
cmd: "
|
|
56
|
+
cmd: "node_modules/.bin/holdpoint evolve"
|
|
57
57
|
|
|
58
58
|
- id: git-commit
|
|
59
59
|
label: "Commit all changes before finishing"
|
|
@@ -45,7 +45,7 @@ checks:
|
|
|
45
45
|
- id: holdpoint-evolve
|
|
46
46
|
label: "Evolve checks when project structure changes"
|
|
47
47
|
when: structural
|
|
48
|
-
cmd: "
|
|
48
|
+
cmd: "node_modules/.bin/holdpoint evolve"
|
|
49
49
|
|
|
50
50
|
- id: git-commit
|
|
51
51
|
label: "Commit all changes before finishing"
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@holdpoint/cli",
|
|
3
|
-
"version": "0.1.0-alpha.
|
|
3
|
+
"version": "0.1.0-alpha.16",
|
|
4
4
|
"publishConfig": {
|
|
5
5
|
"access": "public",
|
|
6
6
|
"tag": "alpha"
|
|
@@ -49,19 +49,22 @@
|
|
|
49
49
|
"chalk": "^5.3.0",
|
|
50
50
|
"commander": "^12.1.0",
|
|
51
51
|
"ora": "^8.1.1",
|
|
52
|
-
"@holdpoint/
|
|
53
|
-
"@holdpoint/
|
|
54
|
-
"@holdpoint/engine-
|
|
55
|
-
"@holdpoint/
|
|
56
|
-
"@holdpoint/engine-copilot": "0.1.0-alpha.
|
|
57
|
-
"@holdpoint/
|
|
52
|
+
"@holdpoint/live-daemon": "0.1.0-alpha.2",
|
|
53
|
+
"@holdpoint/sdk": "0.1.0-alpha.2",
|
|
54
|
+
"@holdpoint/engine-claude": "0.1.0-alpha.11",
|
|
55
|
+
"@holdpoint/engine-codex": "0.1.0-alpha.12",
|
|
56
|
+
"@holdpoint/engine-copilot": "0.1.0-alpha.12",
|
|
57
|
+
"@holdpoint/engine-cursor": "0.1.0-alpha.10",
|
|
58
|
+
"@holdpoint/live-protocol": "0.1.0-alpha.2",
|
|
59
|
+
"@holdpoint/types": "0.1.0-alpha.7",
|
|
60
|
+
"@holdpoint/yaml-core": "0.1.0-alpha.8"
|
|
58
61
|
},
|
|
59
62
|
"devDependencies": {
|
|
60
63
|
"@types/node": "^22.10.2",
|
|
61
64
|
"tsup": "^8.3.5",
|
|
62
65
|
"typescript": "^5.7.2",
|
|
63
66
|
"vitest": "^2.1.8",
|
|
64
|
-
"@holdpoint/builder": "0.1.1-alpha.
|
|
67
|
+
"@holdpoint/builder": "0.1.1-alpha.5"
|
|
65
68
|
},
|
|
66
69
|
"scripts": {
|
|
67
70
|
"build": "tsup && node scripts/copy-builder.mjs",
|