ctxr-cli 0.1.0

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "ctxr-cli",
+  "version": "0.1.0",
+  "description": "A context store that ingests, organizes, and retrieves context for any AI agent",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.11"
+  },
+  "bin": {
+    "ctxr": "./dist/bin.js",
+    "contexture": "./dist/bin.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./adapter": {
+      "types": "./dist/adapter.d.ts",
+      "import": "./dist/adapter.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "verify:phase0": "bash scripts/verify-phase0.sh"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.7.0",
+    "commander": "^15.0.0",
+    "yaml": "^2.9.0",
+    "zod": "^4.5.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "keywords": [
+    "contexture",
+    "context",
+    "context-store",
+    "ai-agents",
+    "knowledge-base",
+    "cli"
+  ]
+}

package/templates/hooks/pre-commit.sh

@@ -0,0 +1,21 @@
+#!/bin/sh
+# Installed by `ctxr init` (write-lifecycle spec). Version-controlled —
+# do not edit by hand; re-run `ctxr init` or `ctxr doctor` to
+# regenerate. Runs `doctor --staged` against the exact contexture install
+# that wrote this hook, and refuses the commit if it finds a real problem.
+set -eu
+
+CONTEXTURE_BIN="__CONTEXTURE_BIN__"
+
+if [ ! -f "$CONTEXTURE_BIN" ]; then
+  echo "ctxr: warning — could not find $CONTEXTURE_BIN; skipping pre-commit validation." >&2
+  exit 0
+fi
+
+if ! output=$(node "$CONTEXTURE_BIN" doctor --staged --json 2>&1); then
+  echo "$output" >&2
+  echo "ctxr: commit refused — staged changes failed 'doctor --staged'." >&2
+  exit 1
+fi
+
+exit 0

package/templates/hooks/pre-push.sh

@@ -0,0 +1,24 @@
+#!/bin/sh
+# Installed by `ctxr init` (write-lifecycle spec). Version-controlled —
+# do not edit by hand; re-run `ctxr init` or `ctxr doctor` to
+# regenerate. Refuses any push whose remote ref is this store's default
+# branch — every write lands via a session and a reviewed pull request.
+set -eu
+
+if [ "${CONTEXTURE_ALLOW_DEFAULT_BRANCH_PUSH:-}" = "1" ]; then
+  exit 0
+fi
+
+DEFAULT_BRANCH="__DEFAULT_BRANCH__"
+BLOCKED_REF="refs/heads/$DEFAULT_BRANCH"
+
+while read -r local_ref local_sha remote_ref remote_sha; do
+  if [ "$remote_ref" = "$BLOCKED_REF" ]; then
+    echo "ctxr: push refused — '$DEFAULT_BRANCH' is this store's default branch." >&2
+    echo "ctxr: land your work via a pull request instead ('ctxr session submit')." >&2
+    echo "ctxr: emergency override: CONTEXTURE_ALLOW_DEFAULT_BRANCH_PUSH=1 git push ..." >&2
+    exit 1
+  fi
+done
+
+exit 0