@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.
@@ -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 `npx @holdpoint/cli@alpha check` — all tasks must exit 0.
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, `npx @holdpoint/cli@alpha evolve` runs and **exits 1 if `checks.yaml` is out of sync** — blocking task completion until you apply the proposals.
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
- npx @holdpoint/cli@alpha evolve --apply # scan, apply proposals, regenerate engine files
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
- npx @holdpoint/cli@alpha update
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 `npx @holdpoint/cli@alpha update`.
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 | What it does |
287
- | ----------------------------------------- | ------------------------------------------------------- |
288
- | `npx @holdpoint/cli@alpha check` | Run checks against all files changed vs HEAD |
289
- | `npx @holdpoint/cli@alpha check --staged` | Run checks against staged files only |
290
- | `npx @holdpoint/cli@alpha evolve` | Scan project and show proposed additions to checks.yaml |
291
- | `npx @holdpoint/cli@alpha evolve --apply` | Apply proposals and regenerate engine files |
292
- | `npx @holdpoint/cli@alpha update` | Regenerate engine files from the current `checks.yaml` |
293
- | `npx @holdpoint/cli@alpha validate` | Validate `checks.yaml` schema (no commands run) |
294
- | `npx @holdpoint/cli@alpha builder` | Open the visual builder UI at localhost:4321 |
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 `npx @holdpoint/cli@alpha update`. Edit `checks.yaml`,
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: "npx @holdpoint/cli@alpha evolve"
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: "npx @holdpoint/cli@alpha evolve"
89
+ cmd: "node_modules/.bin/holdpoint evolve"
90
90
 
91
91
  - id: git-commit
92
92
  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: "npx @holdpoint/cli@alpha evolve"
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: "npx @holdpoint/cli@alpha evolve"
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: "npx @holdpoint/cli@alpha evolve"
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: "npx @holdpoint/cli@alpha evolve"
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.14",
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/engine-claude": "0.1.0-alpha.9",
53
- "@holdpoint/engine-codex": "0.1.0-alpha.10",
54
- "@holdpoint/engine-cursor": "0.1.0-alpha.8",
55
- "@holdpoint/types": "0.1.0-alpha.6",
56
- "@holdpoint/engine-copilot": "0.1.0-alpha.10",
57
- "@holdpoint/yaml-core": "0.1.0-alpha.7"
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.4"
67
+ "@holdpoint/builder": "0.1.1-alpha.5"
65
68
  },
66
69
  "scripts": {
67
70
  "build": "tsup && node scripts/copy-builder.mjs",