@holdpoint/types 0.1.0-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,90 @@
+/** Lifecycle hook that fires the check. Currently only "before_done". */
+type HookEvent = "before_done";
+/** Named file-scope filter. Custom regexes are plain strings not in this union. */
+type WhenScope = "frontend" | "backend" | "socket" | "visual" | "python" | "go" | "rust" | "java" | "ruby" | "database" | "prisma" | "testing" | "infra" | "ci" | "docs" | "structural";
+type ConditionOperator = "file_exists" | "file_contains" | "env_var_set" | "shell_returns_0";
+interface ConditionDef {
+    id: string;
+    operator: ConditionOperator;
+    /** Path glob for file_exists / file_contains */
+    path?: string;
+    /** Substring to look for in file_contains */
+    contains?: string;
+    /** Env var name for env_var_set */
+    envVar?: string;
+    /** Shell command for shell_returns_0 */
+    cmd?: string;
+}
+interface CheckDef {
+    id: string;
+    label: string;
+    /** Lifecycle hook — defaults to "before_done" when absent */
+    on?: HookEvent;
+    /** File filter: a named WhenScope or a regex string. Absent = run always. */
+    when?: string;
+    /** Shell command — task (runs automatically) */
+    cmd?: string;
+    /** Structured prompt/instruction the agent must read and act on before finishing */
+    prompt?: string;
+    /** Reference to a ConditionDef id */
+    conditionId?: string;
+}
+interface HoldpointContext {
+    guides: Record<string, string>;
+}
+interface HoldpointConfig {
+    version: number;
+    context: HoldpointContext;
+    conditions: ConditionDef[];
+    /** All checks — each has `on`, optional `when`, and either `cmd` (task) or `prompt` (agent instruction). */
+    checks: CheckDef[];
+    /**
+     * Named regex patterns for use in `when:` fields.
+     * Keys are human-readable names (e.g. "checks-file", "api-routes").
+     * Values are regex strings matched against changed file paths.
+     * Built-in scope names (frontend, backend, structural, etc.) cannot be overridden here.
+     */
+    patterns?: Record<string, string>;
+    /**
+     * Files to inject as `additionalContext` at the start of every agent session.
+     * Paths are repo-root-relative. Useful for injecting MASTER_PROMPT.md, AGENT_CONTEXT.md, etc.
+     */
+    session_context_files?: string[];
+}
+type CheckStatus = "pass" | "fail" | "skip" | "pending";
+interface CheckResult {
+    check: CheckDef;
+    status: CheckStatus;
+    /** stdout/stderr from a deterministic check */
+    output?: string;
+    /** Exit code from a deterministic check */
+    exitCode?: number;
+    /** Human-readable reason for skip */
+    skipReason?: string;
+}
+interface ValidationError {
+    path: string;
+    message: string;
+}
+interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+type AgentType = "copilot" | "claude" | "cursor" | "unknown";
+type StackType = "typescript" | "python" | "go" | "nextjs" | "fullstack" | "unknown";
+type NodeKind = "trigger" | "filter" | "task" | "prompt" | "condition";
+interface CanvasNodeData {
+    [key: string]: unknown;
+    kind: NodeKind;
+    label: string;
+    /** Lifecycle hook on the trigger node */
+    on?: HookEvent;
+    /** File filter on the trigger node */
+    when?: string;
+    cmd?: string;
+    prompt?: string;
+    condition?: ConditionDef;
+    conditionId?: string;
+}
+
+export type { AgentType, CanvasNodeData, CheckDef, CheckResult, CheckStatus, ConditionDef, ConditionOperator, HoldpointConfig, HoldpointContext, HookEvent, NodeKind, StackType, ValidationError, ValidationResult, WhenScope };

package/dist/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@holdpoint/types",
+  "version": "0.1.0-alpha.0",
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
+  "description": "Shared TypeScript types for Holdpoint",
+  "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/types"
+  },
+  "license": "MIT",
+  "keywords": [
+    "holdpoint",
+    "ai",
+    "agents",
+    "claude-code",
+    "github-copilot",
+    "cursor",
+    "eval",
+    "checkpoints",
+    "ci",
+    "yaml"
+  ],
+  "type": "module",
+  "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",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  }
+}