@primitive.ai/prim 0.1.0-alpha.1 → 0.1.0-alpha.11

package/README.md

@@ -1,6 +1,6 @@
 # @primitive.ai/prim
 
-The official CLI for [Primitive](https://getprimitive.ai). Manage specs, contexts, tasks, and git hooks from the command line.
+The official CLI for [Primitive](https://getprimitive.ai). Manage specs, contexts, projects, and git hooks from the command line.
 
 > [!WARNING]
 > This project is in **alpha**. Commands and APIs may change between releases.
@@ -45,16 +45,16 @@ prim auth status             # Check authentication status
 
 ### Specs
 
-Specs are documents that drive implementation. They can be synced to a task DAG and mapped to file patterns for automatic pre-commit hook integration.
+Specs are documents that drive implementation. They can be synced to a project DAG and mapped to file patterns for automatic pre-commit hook integration.
 
 ```bash
 prim spec list                        # List all specs
-prim spec list --task-id <id>         # Find spec for a root task
+prim spec list --project-id <id>      # Find spec for a root project
 prim spec get <id>                    # Show spec details
 prim spec get <id> --text-only        # Print raw spec text
 prim spec update <id> --file spec.md  # Update spec from file
 prim spec update <id> --name "New"    # Rename a spec
-prim spec sync <id>                   # Trigger spec-to-task sync
+prim spec sync <id>                   # Trigger spec-to-project sync
 prim spec map <id> -p "src/auth/**"   # Map file patterns to a spec
 prim spec unmap <id>                  # Clear all file patterns
 prim spec unmap <id> -p "src/auth/**" # Remove specific pattern
@@ -64,24 +64,24 @@ prim spec auto-map <id>              # Auto-detect file patterns
 ### Contexts
 
 ```bash
-prim context list                     # List all contexts
-prim context list --scope task        # Filter by scope
-prim context list --task-id <id>      # List contexts for a task
-prim context get <id>                 # Get context details
-prim context create -s task -n "Name" # Create a context
-prim context create -s task -n "Name" --file path/to/file
-prim context update <id> --name "New" # Update a context
-prim context delete <id>              # Delete a context
-prim context link <id> --task <tid>   # Link context to task
-prim context unlink <id> --task <tid> # Unlink context from task
+prim context list                        # List all contexts
+prim context list --scope project        # Filter by scope
+prim context list --project-id <id>      # List contexts for a project
+prim context get <id>                    # Get context details
+prim context create -s project -n "Name" # Create a context
+prim context create -s project -n "Name" --file path/to/file
+prim context update <id> --name "New"    # Update a context
+prim context delete <id>                 # Delete a context
+prim context link <id> --project <pid>   # Link context to project
+prim context unlink <id> --project <pid> # Unlink context from project
 ```
 
-### Tasks
+### Projects
 
 ```bash
-prim task create -n "Task name"                    # Create a task
-prim task create -n "Task name" -d "Description"   # Create with description
-prim task create -n "Task name" --spec <contextId> # Create and link a spec
+prim project create -n "Project name"                    # Create a project
+prim project create -n "Project name" -d "Description"   # Create with description
+prim project create -n "Project name" --spec <contextId> # Create and link a spec
 ```
 
 ### Hooks

package/dist/hooks/pre-commit.js

@@ -11,6 +11,11 @@ function getStagedFiles() {
   });
   return output.trim().split("\n").filter((f) => f.length > 0);
 }
+function getStagedDiff(files) {
+  return execSync(`git diff --cached -- ${files.map((f) => `"${f}"`).join(" ")}`, {
+    encoding: "utf-8"
+  });
+}
 function matchPattern(filePath, pattern) {
   const regexStr = pattern.replaceAll("**", "\xA7GLOBSTAR\xA7").replaceAll("*", "[^/]*").replaceAll("\xA7GLOBSTAR\xA7", ".*");
   const regex = new RegExp(`^${regexStr}$`);
@@ -39,29 +44,35 @@ function findAffectedContexts(stagedFiles, specs) {
   return affected;
 }
 var HOOK_TIMEOUT_MS = 1e4;
-async function main() {
-  const stagedFiles = getStagedFiles();
+var defaultDeps = {
+  getClient,
+  getStagedFiles,
+  getStagedDiff
+};
+async function syncAffectedSpecs(deps = defaultDeps) {
+  const stagedFiles = deps.getStagedFiles();
   if (stagedFiles.length === 0) {
-    process.exit(0);
+    return [];
   }
-  const client = getClient();
+  const client = deps.getClient();
   let mappings = [];
   try {
     mappings = await client.get("/api/cli/specs/mappings", {
       signal: AbortSignal.timeout(HOOK_TIMEOUT_MS)
     });
   } catch {
-    process.exit(0);
+    return [];
   }
   if (mappings.length === 0) {
-    process.exit(0);
+    return [];
   }
   const affectedContexts = findAffectedContexts(stagedFiles, mappings);
   if (affectedContexts.size === 0) {
-    process.exit(0);
+    return [];
   }
   console.log(`[prim] ${String(affectedContexts.size)} spec(s) affected by staged changes:`);
-  for (const [contextId] of affectedContexts) {
+  const synced = [];
+  for (const [contextId, affected] of affectedContexts) {
     try {
       const ctx = await client.get(`/api/cli/contexts/${contextId}`, {
         signal: AbortSignal.timeout(HOOK_TIMEOUT_MS)
@@ -74,18 +85,47 @@ async function main() {
         console.log(`  [skip] ${contextId} \u2014 not a spec document`);
         continue;
       }
-      await client.post(`/api/cli/contexts/${contextId}/sync`, void 0, {
-        signal: AbortSignal.timeout(HOOK_TIMEOUT_MS)
-      });
-      console.log(`  [synced] ${contextId} \u2014 ${ctx.name ?? "(unnamed)"}`);
+      const diffContent = deps.getStagedDiff(affected.matchedFiles);
+      if (!diffContent) {
+        console.log(`  [skip] ${contextId} \u2014 no diff content`);
+        continue;
+      }
+      const response = await client.post(
+        `/api/cli/contexts/${contextId}/sync-diff`,
+        { diffContent, affectedFiles: affected.matchedFiles },
+        { signal: AbortSignal.timeout(HOOK_TIMEOUT_MS) }
+      );
+      const name = ctx.name ?? "(unnamed)";
+      if (response.truncated && response.sizeChars && response.limitChars) {
+        const sizeKiB = Math.round(response.sizeChars / 1024);
+        const limitKiB = Math.round(response.limitChars / 1024);
+        console.log(
+          `  [synced] ${contextId} \u2014 ${name} (truncated: ${String(sizeKiB)} KiB \u2192 ${String(limitKiB)} KiB analyzed)`
+        );
+      } else {
+        console.log(`  [synced] ${contextId} \u2014 ${name}`);
+      }
+      synced.push(contextId);
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       console.error(`  [error] ${contextId} \u2014 ${message}`);
     }
   }
-  process.exit(0);
+  return synced;
 }
-main().catch((error) => {
-  console.error("[prim] Pre-commit hook error:", error);
+async function main() {
+  await syncAffectedSpecs();
   process.exit(0);
-});
+}
+if (!process.env.VITEST) {
+  main().catch((error) => {
+    console.error("[prim] Pre-commit hook error:", error);
+    process.exit(0);
+  });
+}
+export {
+  HOOK_TIMEOUT_MS,
+  findAffectedContexts,
+  matchPattern,
+  syncAffectedSpecs
+};

package/dist/index.js

@@ -11,6 +11,9 @@ import {
 } from "./chunk-3APLWTLB.js";
 
 // src/index.ts
+import { readFileSync as readFileSync5 } from "fs";
+import { dirname as dirname2, resolve as resolve2 } from "path";
+import { fileURLToPath } from "url";
 import { Command } from "commander";
 
 // src/commands/auth.ts
@@ -100,10 +103,10 @@ function registerAuthCommands(program2) {
         process.exit(1);
       });
     });
-    const port = await new Promise((resolve2) => {
+    const port = await new Promise((resolve3) => {
       server.listen(CALLBACK_PORT, LOCALHOST, () => {
         const addr = server.address();
-        resolve2(typeof addr === "object" && addr ? addr.port : 0);
+        resolve3(typeof addr === "object" && addr ? addr.port : 0);
       });
     });
     const redirectUri = `http://${LOCALHOST}:${port}/callback`;
@@ -234,14 +237,14 @@ async function exchangeCode(siteUrl, code, codeVerifier, redirectUri) {
 import { readFileSync as readFileSync2 } from "fs";
 function registerContextCommands(program2) {
   const context = program2.command("context").description("Manage contexts");
-  context.command("list").description("List contexts").option("-s, --scope <scope>", "Filter by scope: task, global, external").option("-t, --task-id <taskId>", "List contexts linked to a specific task").action(async (opts) => {
+  context.command("list").description("List contexts").option("-s, --scope <scope>", "Filter by scope: project, global, external").option("-t, --project-id <projectId>", "List contexts linked to a specific project").action(async (opts) => {
     const client = getClient();
     const params = new URLSearchParams();
-    if (opts.taskId) {
-      params.set("taskId", opts.taskId);
+    if (opts.projectId) {
+      params.set("taskId", opts.projectId);
     }
     if (opts.scope) {
-      params.set("scope", opts.scope);
+      params.set("scope", opts.scope === "project" ? "task" : opts.scope);
     }
     const contexts = await client.get(`/api/cli/contexts?${params.toString()}`);
     printContextList(contexts);
@@ -251,16 +254,16 @@ function registerContextCommands(program2) {
     const ctx = await client.get(`/api/cli/contexts/${contextId}`);
     console.log(JSON.stringify(ctx, null, 2));
   });
-  context.command("create").description("Create a new context").requiredOption("-s, --scope <scope>", "Scope: task, global, external").requiredOption("-n, --name <name>", "Context name").option("-t, --text <text>", "Context text content").option("-f, --file <path>", "Read text content from file").option("--task-id <taskId>", "Link to task(s), comma-separated").option("--spec", "Mark as a spec document").action(
+  context.command("create").description("Create a new context").requiredOption("-s, --scope <scope>", "Scope: project, global, external").requiredOption("-n, --name <name>", "Context name").option("-t, --text <text>", "Context text content").option("-f, --file <path>", "Read text content from file").option("--project-id <projectId>", "Link to project(s), comma-separated").option("--spec", "Mark as a spec document").action(
     async (opts) => {
       const client = getClient();
       let text = opts.text;
       if (opts.file) {
         text = readFileSync2(opts.file, "utf-8");
       }
-      const taskIds = opts.taskId ? opts.taskId.split(",").map((id) => id.trim()) : void 0;
+      const taskIds = opts.projectId ? opts.projectId.split(",").map((id) => id.trim()) : void 0;
       const result = await client.post("/api/cli/contexts", {
-        scope: opts.scope,
+        scope: opts.scope === "project" ? "task" : opts.scope,
         name: opts.name,
         text,
         taskIds,
@@ -286,19 +289,19 @@ function registerContextCommands(program2) {
     await client.delete(`/api/cli/contexts/${contextId}`);
     console.log(`Deleted context: ${contextId}`);
   });
-  context.command("link <contextId>").description("Link a context to a task").requiredOption("--task <taskId>", "Task ID to link to").action(async (contextId, opts) => {
+  context.command("link <contextId>").description("Link a context to a project").requiredOption("--project <projectId>", "Project ID to link to").action(async (contextId, opts) => {
     const client = getClient();
     await client.post(`/api/cli/contexts/${contextId}/link`, {
-      taskId: opts.task
+      taskId: opts.project
     });
-    console.log(`Linked context ${contextId} to task ${opts.task}`);
+    console.log(`Linked context ${contextId} to project ${opts.project}`);
   });
-  context.command("unlink <contextId>").description("Unlink a context from a task").requiredOption("--task <taskId>", "Task ID to unlink from").action(async (contextId, opts) => {
+  context.command("unlink <contextId>").description("Unlink a context from a project").requiredOption("--project <projectId>", "Project ID to unlink from").action(async (contextId, opts) => {
     const client = getClient();
     await client.post(`/api/cli/contexts/${contextId}/unlink`, {
-      taskId: opts.task
+      taskId: opts.project
     });
-    console.log(`Unlinked context ${contextId} from task ${opts.task}`);
+    console.log(`Unlinked context ${contextId} from project ${opts.project}`);
   });
 }
 function printContextList(contexts) {
@@ -307,7 +310,7 @@ function printContextList(contexts) {
     return;
   }
   for (const ctx of contexts) {
-    const scope = ctx.scope ?? "task";
+    const scope = ctx.scope === "task" ? "project" : ctx.scope ?? "project";
     const spec = ctx.isSpecDocument ? " [SPEC]" : "";
     const name = ctx.name ?? ctx.title ?? "(unnamed)";
     console.log(`${ctx._id}  ${scope.padEnd(8)} ${name}${spec}`);
@@ -330,7 +333,7 @@ if command -v prim-pre-commit >/dev/null 2>&1; then
 elif [ -f "./node_modules/.bin/prim-pre-commit" ]; then
   ./node_modules/.bin/prim-pre-commit
 else
-  npx --yes @primitive.ai/prim pre-commit-hook 2>/dev/null || true
+  npx --yes -p @primitive.ai/prim prim-pre-commit 2>/dev/null || true
 fi
 `;
 var PRIM_BLOCK_START = "# >>> prim pre-commit hook >>>";
@@ -341,7 +344,7 @@ if command -v prim-pre-commit >/dev/null 2>&1; then
 elif [ -f "./node_modules/.bin/prim-pre-commit" ]; then
   ./node_modules/.bin/prim-pre-commit
 else
-  npx --yes @primitive.ai/prim pre-commit-hook 2>/dev/null || true
+  npx --yes -p @primitive.ai/prim prim-pre-commit 2>/dev/null || true
 fi
 ${PRIM_BLOCK_END}`;
 function getGitRoot() {
@@ -357,8 +360,8 @@ function detectHusky(gitRoot) {
   const pkgPath = resolve(gitRoot, "package.json");
   if (existsSync2(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync3(pkgPath, "utf-8"));
-      const scripts = pkg.scripts ?? {};
+      const pkg2 = JSON.parse(readFileSync3(pkgPath, "utf-8"));
+      const scripts = pkg2.scripts ?? {};
       if (/husky/i.test(scripts.prepare ?? "") || /husky/i.test(scripts.postinstall ?? "")) {
         return true;
       }
@@ -453,16 +456,33 @@ function registerHooksCommands(program2) {
   });
 }
 
+// src/commands/project.ts
+function registerProjectCommands(program2) {
+  const project = program2.command("project").description("Manage projects");
+  project.command("create").description("Create a new project").requiredOption("-n, --name <name>", "Project name").option("-d, --description <description>", "Project description").option("--spec <contextId>", "Link an existing spec as this project's spec").action(async (opts) => {
+    const client = getClient();
+    const result = await client.post("/api/cli/tasks", {
+      name: opts.name,
+      description: opts.description,
+      specContextId: opts.spec
+    });
+    console.log(`Created project: ${result._id}`);
+    if (opts.spec) {
+      console.log(`Linked spec: ${opts.spec}`);
+    }
+  });
+}
+
 // src/commands/spec.ts
 import { readFileSync as readFileSync4 } from "fs";
 function registerSpecCommands(program2) {
   const spec = program2.command("spec").description("Manage spec documents");
-  spec.command("list").description("List spec documents").option("-t, --task-id <taskId>", "List spec for a specific root task").action(async (opts) => {
+  spec.command("list").description("List spec documents").option("-t, --project-id <projectId>", "List spec for a specific root project").action(async (opts) => {
     const client = getClient();
-    if (opts.taskId) {
-      const specs = await client.get(`/api/cli/specs?rootTaskId=${opts.taskId}`);
+    if (opts.projectId) {
+      const specs = await client.get(`/api/cli/specs?rootTaskId=${opts.projectId}`);
       if (specs.length === 0) {
-        console.log("No spec document found for this task.");
+        console.log("No spec document found for this project.");
         return;
       }
       printSpec(specs[0]);
@@ -474,7 +494,7 @@ function registerSpecCommands(program2) {
       return;
     }
     for (const ctx of contexts) {
-      const scope = ctx.scope ?? "task";
+      const scope = ctx.scope === "task" ? "project" : ctx.scope ?? "project";
       const review = ctx.specReviewStatus ?? "\u2014";
       const name = ctx.name ?? "(unnamed)";
       console.log(`${ctx._id}  ${scope.padEnd(8)} ${String(review).padEnd(10)} ${name}`);
@@ -511,7 +531,7 @@ ${contexts.length} spec(s)`);
     }
     console.log(`Updated spec: ${contextId}`);
   });
-  spec.command("sync <contextId>").description("Trigger spec \u2194 task DAG synchronization").action(async (contextId) => {
+  spec.command("sync <contextId>").description("Trigger spec \u2194 project DAG synchronization").action(async (contextId) => {
     const client = getClient();
     const ctx = await client.get(`/api/cli/contexts/${contextId}`);
     if (!ctx.isSpecDocument) {
@@ -521,7 +541,7 @@ ${contexts.length} spec(s)`);
     await client.post(`/api/cli/contexts/${contextId}/sync`);
     console.log(`Triggered sync for spec: ${contextId}`);
     if (ctx.specRootTaskId) {
-      console.log(`Root task: ${ctx.specRootTaskId}`);
+      console.log(`Root project: ${ctx.specRootTaskId}`);
     }
   });
   spec.command("map <contextId>").description("Map file patterns to a spec (used by pre-commit hook to detect affected specs)").requiredOption(
@@ -563,9 +583,9 @@ function printSpec(ctx) {
   const patterns = ctx.filePatterns;
   console.log(`ID:              ${ctx._id}`);
   console.log(`Name:            ${name}`);
-  console.log(`Scope:           ${ctx.scope ?? "task"}`);
+  console.log(`Scope:           ${ctx.scope === "task" ? "project" : ctx.scope ?? "project"}`);
   console.log(`Review Status:   ${review}`);
-  console.log(`Root Task:       ${ctx.specRootTaskId ?? "\u2014"}`);
+  console.log(`Root Project:    ${ctx.specRootTaskId ?? "\u2014"}`);
   console.log(`Sync Version:    ${ctx.syncVersion ?? 0}`);
   console.log(`Index Status:    ${ctx.indexStatus ?? "\u2014"}`);
   console.log(`File Patterns:   ${patterns?.length ? patterns.join(", ") : "\u2014"}`);
@@ -578,30 +598,15 @@ ${preview}`);
   }
 }
 
-// src/commands/task.ts
-function registerTaskCommands(program2) {
-  const task = program2.command("task").description("Manage tasks");
-  task.command("create").description("Create a new task").requiredOption("-n, --name <name>", "Task name").option("-d, --description <description>", "Task description").option("--spec <contextId>", "Link an existing spec as this task's spec").action(async (opts) => {
-    const client = getClient();
-    const result = await client.post("/api/cli/tasks", {
-      name: opts.name,
-      description: opts.description,
-      specContextId: opts.spec
-    });
-    console.log(`Created task: ${result._id}`);
-    if (opts.spec) {
-      console.log(`Linked spec: ${opts.spec}`);
-    }
-  });
-}
-
 // src/index.ts
+var __dirname = dirname2(fileURLToPath(import.meta.url));
+var pkg = JSON.parse(readFileSync5(resolve2(__dirname, "../package.json"), "utf-8"));
 var program = new Command();
-program.name("prim").description("CLI for managing Primitive specs and contexts").version("0.1.0-alpha.1");
+program.name("prim").description("CLI for managing Primitive specs and contexts").version(pkg.version);
 registerAuthCommands(program);
 registerContextCommands(program);
 registerSpecCommands(program);
-registerTaskCommands(program);
+registerProjectCommands(program);
 registerHooksCommands(program);
 process.on("unhandledRejection", (err) => {
   const msg = err instanceof Error ? err.message : String(err);

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@primitive.ai/prim",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.11",
   "description": "CLI for managing Primitive specs, contexts, and git hooks",
   "type": "module",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/campus-ai/prim.git"
+    "url": "git+https://github.com/campus-ai/prim.git"
   },
   "homepage": "https://github.com/campus-ai/prim#readme",
   "bugs": {
@@ -26,9 +26,10 @@
   "engines": {
     "node": ">=20.0.0"
   },
+  "packageManager": "pnpm@9.15.9",
   "bin": {
-    "prim": "./dist/index.js",
-    "prim-pre-commit": "./dist/hooks/pre-commit.js"
+    "prim": "dist/index.js",
+    "prim-pre-commit": "dist/hooks/pre-commit.js"
   },
   "main": "./dist/index.js",
   "files": [
@@ -36,17 +37,6 @@
     "LICENSE",
     "README.md"
   ],
-  "dependencies": {
-    "commander": "^12.1.0"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^1.9.0",
-    "@types/node": "^25.5.0",
-    "@vitest/coverage-v8": "^3.1.0",
-    "tsup": "^8.0.0",
-    "typescript": "^5.5.0",
-    "vitest": "^3.1.0"
-  },
   "scripts": {
     "build": "tsup src/index.ts src/hooks/pre-commit.ts --format esm --clean",
     "postbuild": "chmod +x ./dist/index.js ./dist/hooks/pre-commit.js",
@@ -59,5 +49,16 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.0",
+    "@types/node": "^25.5.0",
+    "@vitest/coverage-v8": "^3.1.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^3.1.0"
   }
-}
+}