@holdpoint/cli 0.1.0-alpha.0

package/dist/templates/fullstack.yaml

@@ -0,0 +1,93 @@
+version: 1
+
+context:
+  guides: {}
+
+conditions:
+  - id: has-openapi
+    operator: file_exists
+    path: openapi.yaml
+
+  - id: has-playwright
+    operator: file_exists
+    path: playwright.config.ts
+
+checks:
+  - id: lint
+    label: "ESLint — no warnings"
+    cmd: "pnpm lint --max-warnings 0"
+
+  - id: typecheck
+    label: "TypeScript type check"
+    cmd: "pnpm typecheck"
+
+  - id: unit-tests
+    label: "Vitest unit tests"
+    cmd: "pnpm test --run"
+
+  - id: backend-tests
+    label: "Backend integration tests"
+    when: backend
+    cmd: "pnpm test:integration --run"
+
+  - id: build
+    label: "Production build"
+    cmd: "pnpm build"
+
+  - id: jsdoc
+    label: "JSDoc on changed public functions"
+    prompt: >
+      All changed public functions and exports must have JSDoc.
+
+  - id: openapi-updated
+    label: "OpenAPI spec updated for API changes"
+    when: backend
+    conditionId: has-openapi
+    prompt: >
+      If any API routes were added or changed, update openapi.yaml to match.
+
+  - id: visual-regression
+    label: "Visual regression check"
+    when: frontend
+    conditionId: has-playwright
+    prompt: >
+      Run playwright tests for any UI changes: `pnpm playwright test`
+      Review screenshots for regressions.
+
+  - id: i18n
+    label: "i18n — no hardcoded user-facing strings"
+    when: frontend
+    prompt: >
+      Confirm all user-visible strings are wrapped in t() and locale files updated.
+
+  - id: db-migrations
+    label: "Database migration for schema changes"
+    when: database
+    prompt: >
+      If schema or migration files changed, ensure the appropriate migration was
+      generated with your ORM tool (e.g. `prisma migrate dev`, `alembic revision`,
+      `rails db:migrate`) and committed alongside the schema change.
+
+  - id: changelog-update
+    label: "Add a CHANGELOG.md entry for this session"
+    prompt: >
+      Before committing, add an entry to CHANGELOG.md describing what was done.
+      Use Keep a Changelog format — add under ## [Unreleased] (create the file
+      and that section if absent). Group entries as Added, Changed, Fixed, or Removed.
+      Be concise but specific. The entry text will serve as the commit message.
+
+  - id: readme-sync
+    label: "Update README.md if user-facing changes were made"
+    prompt: >
+      If you added, changed, or removed user-facing functionality — CLI commands,
+      configuration options, public APIs, or significant new features — update
+      README.md to reflect those changes.
+
+  - id: holdpoint-evolve
+    label: "Evolve checks when project structure changes"
+    when: structural
+    cmd: "npx holdpoint evolve"
+
+  - id: git-commit
+    label: "Commit all changes before finishing"
+    cmd: 'git rev-parse --is-inside-work-tree 2>/dev/null || exit 0; [ -z "$(git status --porcelain)" ] && exit 0; git status --short; exit 1'

package/dist/templates/go.yaml

@@ -0,0 +1,60 @@
+version: 1
+
+context:
+  guides: {}
+
+conditions: []
+
+checks:
+  - id: go-build
+    label: "go build — no compilation errors"
+    when: go
+    cmd: "go build ./..."
+
+  - id: go-vet
+    label: "go vet — no suspicious constructs"
+    when: go
+    cmd: "go vet ./..."
+
+  - id: go-test
+    label: "go test — all unit tests pass"
+    when: go
+    cmd: "go test ./..."
+
+  - id: godoc
+    label: "GoDoc on exported symbols"
+    when: go
+    prompt: >
+      Ensure all exported functions, types, methods, and packages have GoDoc
+      comments (one-line summary starting on the same line as the declaration).
+
+  - id: test-coverage
+    label: "Meaningful test coverage for new logic"
+    when: testing
+    prompt: >
+      Confirm any new non-trivial logic has corresponding unit tests in
+      *_test.go files in the same package.
+
+  - id: changelog-update
+    label: "Add a CHANGELOG.md entry for this session"
+    prompt: >
+      Before committing, add an entry to CHANGELOG.md describing what was done.
+      Use Keep a Changelog format — add under ## [Unreleased] (create the file
+      and that section if absent). Group entries as Added, Changed, Fixed, or Removed.
+      Be concise but specific. The entry text will serve as the commit message.
+
+  - id: readme-sync
+    label: "Update README.md if user-facing changes were made"
+    prompt: >
+      If you added, changed, or removed user-facing functionality — CLI commands,
+      configuration options, public APIs, or significant new features — update
+      README.md to reflect those changes.
+
+  - id: holdpoint-evolve
+    label: "Evolve checks when project structure changes"
+    when: structural
+    cmd: "npx holdpoint evolve"
+
+  - id: git-commit
+    label: "Commit all changes before finishing"
+    cmd: 'git rev-parse --is-inside-work-tree 2>/dev/null || exit 0; [ -z "$(git status --porcelain)" ] && exit 0; git status --short; exit 1'

package/dist/templates/nextjs.yaml

@@ -0,0 +1,76 @@
+version: 1
+
+context:
+  guides: {}
+
+conditions:
+  - id: has-openapi
+    operator: file_exists
+    path: openapi.yaml
+
+checks:
+  - id: lint
+    label: "ESLint — no warnings"
+    cmd: "pnpm lint --max-warnings 0"
+
+  - id: typecheck
+    label: "TypeScript type check"
+    cmd: "pnpm typecheck"
+
+  - id: unit-tests
+    label: "Vitest unit tests"
+    cmd: "pnpm test --run"
+
+  - id: build
+    label: "Next.js production build"
+    cmd: "pnpm build"
+
+  - id: jsdoc
+    label: "JSDoc on changed public functions"
+    prompt: >
+      Ensure all changed public functions and exports have JSDoc comments.
+
+  - id: visual-regression
+    label: "Visual regression check"
+    when: frontend
+    prompt: >
+      For any UI changes, confirm the layout is correct at 1280px desktop,
+      768px tablet, and 375px mobile breakpoints.
+
+  - id: i18n
+    label: "i18n — no hardcoded strings"
+    when: frontend
+    prompt: >
+      Ensure all user-visible text is wrapped in the t() translation function
+      and has corresponding entries in all locale files.
+
+  - id: openapi-updated
+    label: "OpenAPI spec updated for API changes"
+    when: backend
+    conditionId: has-openapi
+    prompt: >
+      If any API routes were added or changed, confirm the openapi.yaml
+      spec has been updated to match.
+
+  - id: changelog-update
+    label: "Add a CHANGELOG.md entry for this session"
+    prompt: >
+      Before committing, add an entry to CHANGELOG.md describing what was done.
+      Use Keep a Changelog format — add under ## [Unreleased] (create the file
+      and that section if absent). Group entries as Added, Changed, Fixed, or Removed.
+      Be concise but specific. The entry text will serve as the commit message.
+
+  - id: readme-sync
+    label: "Update README.md if user-facing changes were made"
+    prompt: >
+      If you added, changed, or removed user-facing functionality — pages, features,
+      or configuration options — update README.md to reflect those changes.
+
+  - id: holdpoint-evolve
+    label: "Evolve checks when project structure changes"
+    when: structural
+    cmd: "npx holdpoint evolve"
+
+  - id: git-commit
+    label: "Commit all changes before finishing"
+    cmd: 'git rev-parse --is-inside-work-tree 2>/dev/null || exit 0; [ -z "$(git status --porcelain)" ] && exit 0; git status --short; exit 1'

package/dist/templates/python.yaml

@@ -0,0 +1,60 @@
+version: 1
+
+context:
+  guides: {}
+
+conditions: []
+
+checks:
+  - id: ruff
+    label: "Ruff linter"
+    when: python
+    cmd: "ruff check ."
+
+  - id: mypy
+    label: "Mypy type check"
+    when: python
+    cmd: "mypy . --ignore-missing-imports"
+
+  - id: pytest
+    label: "pytest"
+    when: python
+    cmd: "pytest --tb=short -q"
+
+  - id: docstrings
+    label: "Docstrings on changed functions"
+    when: python
+    prompt: >
+      Ensure all changed public functions and classes have PEP-257 compliant
+      docstrings (one-line summary + extended description where needed).
+
+  - id: type-hints
+    label: "Type hints on new functions"
+    when: python
+    prompt: >
+      Confirm that all new functions have complete type annotations on
+      all parameters and return values.
+
+  - id: changelog-update
+    label: "Add a CHANGELOG.md entry for this session"
+    prompt: >
+      Before committing, add an entry to CHANGELOG.md describing what was done.
+      Use Keep a Changelog format — add under ## [Unreleased] (create the file
+      and that section if absent). Group entries as Added, Changed, Fixed, or Removed.
+      Be concise but specific. The entry text will serve as the commit message.
+
+  - id: readme-sync
+    label: "Update README.md if user-facing changes were made"
+    prompt: >
+      If you added, changed, or removed user-facing functionality — CLI commands,
+      configuration options, public APIs, or significant new features — update
+      README.md to reflect those changes.
+
+  - id: holdpoint-evolve
+    label: "Evolve checks when project structure changes"
+    when: structural
+    cmd: "npx holdpoint evolve"
+
+  - id: git-commit
+    label: "Commit all changes before finishing"
+    cmd: 'git rev-parse --is-inside-work-tree 2>/dev/null || exit 0; [ -z "$(git status --porcelain)" ] && exit 0; git status --short; exit 1'

package/dist/templates/typescript.yaml

@@ -0,0 +1,55 @@
+version: 1
+
+context:
+  guides: {}
+
+conditions: []
+
+checks:
+  - id: lint
+    label: "ESLint — no warnings"
+    cmd: "pnpm lint --max-warnings 0"
+
+  - id: typecheck
+    label: "TypeScript type check"
+    cmd: "pnpm typecheck"
+
+  - id: unit-tests
+    label: "Vitest unit tests"
+    cmd: "pnpm test --run"
+
+  - id: jsdoc
+    label: "JSDoc on changed public functions"
+    prompt: >
+      Ensure all changed public functions and exports have JSDoc comments
+      with description, @param, and @returns where applicable.
+
+  - id: test-coverage
+    label: "Meaningful test coverage for new logic"
+    prompt: >
+      Confirm that any new non-trivial logic introduced in this change
+      has corresponding unit tests in the __tests__ directory.
+
+  - id: changelog-update
+    label: "Add a CHANGELOG.md entry for this session"
+    prompt: >
+      Before committing, add an entry to CHANGELOG.md describing what was done.
+      Use Keep a Changelog format — add under ## [Unreleased] (create the file
+      and that section if absent). Group entries as Added, Changed, Fixed, or Removed.
+      Be concise but specific. The entry text will serve as the commit message.
+
+  - id: readme-sync
+    label: "Update README.md if user-facing changes were made"
+    prompt: >
+      If you added, changed, or removed user-facing functionality — CLI commands,
+      configuration options, public APIs, or significant new features — update
+      README.md to reflect those changes.
+
+  - id: holdpoint-evolve
+    label: "Evolve checks when project structure changes"
+    when: structural
+    cmd: "npx holdpoint evolve"
+
+  - id: git-commit
+    label: "Commit all changes before finishing"
+    cmd: 'git rev-parse --is-inside-work-tree 2>/dev/null || exit 0; [ -z "$(git status --porcelain)" ] && exit 0; git status --short; exit 1'

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@holdpoint/cli",
+  "version": "0.1.0-alpha.0",
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
+  "description": "Holdpoint CLI — enforce deterministic eval checkpoints on AI coding agents",
+  "homepage": "https://holdpoint.dev",
+  "bugs": {
+    "url": "https://github.com/holdpoint-dev/holdpoint/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/holdpoint-dev/holdpoint.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT",
+  "keywords": [
+    "holdpoint",
+    "ai",
+    "agents",
+    "claude-code",
+    "github-copilot",
+    "cursor",
+    "eval",
+    "checkpoints",
+    "ci",
+    "yaml"
+  ],
+  "type": "module",
+  "bin": {
+    "holdpoint": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "dependencies": {
+    "@holdpoint/engine-claude": "workspace:*",
+    "@holdpoint/engine-copilot": "workspace:*",
+    "@holdpoint/engine-cursor": "workspace:*",
+    "@holdpoint/types": "workspace:*",
+    "@holdpoint/yaml-core": "workspace:*",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "ora": "^8.1.1"
+  },
+  "devDependencies": {
+    "@holdpoint/builder": "workspace:*",
+    "@types/node": "^22.10.2",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}