@orquentra/codebuddy 0.0.0-stage → 2.4.1

package/package.json

@@ -1,6 +1,110 @@
 {
   "name": "@orquentra/codebuddy",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.4.1",
+  "description": "Local-first project context and memory for AI coding agents.",
+  "type": "module",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Orquentra Inc",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Orquentra-Inc/CodeBuddy"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "codebuddy": "./dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./langgraph": {
+      "types": "./dist/langgraph/index.d.ts",
+      "import": "./dist/langgraph/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/db/migrations",
+    "README.md",
+    "CLAUDE_CODEX.md",
+    "ARCHITECTURE.md",
+    "WORKFLOW.md",
+    "LICENSE",
+    "docker-compose.yml",
+    "examples"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/cli/index.ts",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:pg": "bash scripts/test-pg-recovery.sh",
+    "eval:agent-ab": "tsx scripts/eval-agent-ab.mts",
+    "eval:memory-ab": "tsx scripts/eval-memory-ab.mts",
+    "eval:retrieval": "tsx scripts/eval-retrieval.mts",
+    "eval:savings": "tsx scripts/eval-task-savings.mts",
+    "branches:prune": "bash scripts/prune-merged-branches.sh",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "memory",
+    "agent",
+    "multi-agent",
+    "huggingface",
+    "pgvector",
+    "postgres",
+    "langgraph",
+    "claude"
+  ],
+  "homepage": "https://github.com/Orquentra-Inc/CodeBuddy",
+  "bugs": {
+    "url": "https://github.com/Orquentra-Inc/CodeBuddy/issues"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "@huggingface/inference": "^4.13.19",
+    "@modelcontextprotocol/sdk": "^1.17.5",
+    "commander": "^14.0.0",
+    "drizzle-orm": "^0.45.2",
+    "js-tiktoken": "^1.0.21",
+    "langsmith": "^0.7.10",
+    "ora": "^8.2.0",
+    "p-queue": "^8.1.0",
+    "p-retry": "^6.2.1",
+    "p-timeout": "^6.1.4",
+    "picocolors": "^1.1.1",
+    "pino": "^9.9.0",
+    "pino-pretty": "^13.1.1",
+    "postgres": "^3.4.7",
+    "yaml": "^2.9.0",
+    "zod": "^4.6.7"
+  },
+  "peerDependencies": {
+    "@langchain/langgraph": "^0.2.0 || ^0.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@langchain/langgraph": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.0",
+    "@types/node": "^24.3.0",
+    "drizzle-kit": "^0.31.10",
+    "tsup": "^8.5.0",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2",
+    "vitest": "^4.1.12"
+  }
+}

package/src/db/migrations/0000_cultured_satana.sql

@@ -0,0 +1,144 @@
+CREATE TYPE "public"."audit_action" AS ENUM('remember', 'remember_batch', 'share', 'forget', 'config');--> statement-breakpoint
+CREATE TYPE "public"."embedding_owner_type" AS ENUM('interaction', 'fact', 'summary');--> statement-breakpoint
+CREATE TYPE "public"."embedding_status" AS ENUM('pending', 'ready', 'failed');--> statement-breakpoint
+CREATE TYPE "public"."interaction_role" AS ENUM('user', 'assistant', 'system');--> statement-breakpoint
+CREATE TYPE "public"."memory_type" AS ENUM('interaction', 'fact', 'summary');--> statement-breakpoint
+CREATE TYPE "public"."model_call_status" AS ENUM('success', 'failed', 'timeout', 'rate_limited', 'gated', 'fallback');--> statement-breakpoint
+CREATE TYPE "public"."model_call_type" AS ENUM('embedding', 'llm');--> statement-breakpoint
+CREATE TYPE "public"."share_mode" AS ENUM('reference', 'snapshot');--> statement-breakpoint
+CREATE TABLE "audit_log" (
+	"id" text PRIMARY KEY NOT NULL,
+	"namespace_id" text,
+	"action" "audit_action" NOT NULL,
+	"entity_type" text NOT NULL,
+	"entity_id" text,
+	"created_by_agent" text,
+	"metadata" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "checkpoints" (
+	"id" text PRIMARY KEY NOT NULL,
+	"namespace_id" text NOT NULL,
+	"thread_id" text NOT NULL,
+	"checkpoint_id" text NOT NULL,
+	"parent_id" text,
+	"channel_values" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"metadata" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "embeddings" (
+	"id" text PRIMARY KEY NOT NULL,
+	"namespace_id" text NOT NULL,
+	"owner_type" "embedding_owner_type" NOT NULL,
+	"owner_id" text NOT NULL,
+	"vector" vector(384) NOT NULL,
+	"embedding_model" text NOT NULL,
+	"status" "embedding_status" DEFAULT 'pending' NOT NULL,
+	"attempts" integer DEFAULT 0 NOT NULL,
+	"last_error" text,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "facts" (
+	"id" text PRIMARY KEY NOT NULL,
+	"namespace_id" text NOT NULL,
+	"subject" text NOT NULL,
+	"predicate" text NOT NULL,
+	"object" text NOT NULL,
+	"content" text NOT NULL,
+	"content_hash" text NOT NULL,
+	"confidence" numeric(5, 4) DEFAULT '1' NOT NULL,
+	"source_interaction_id" text,
+	"source_deleted" boolean DEFAULT false NOT NULL,
+	"embedding_model" text,
+	"created_by_agent" text,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "interactions" (
+	"id" text PRIMARY KEY NOT NULL,
+	"namespace_id" text NOT NULL,
+	"session_id" text NOT NULL,
+	"role" "interaction_role" DEFAULT 'user' NOT NULL,
+	"content" text NOT NULL,
+	"content_hash" text NOT NULL,
+	"token_count" integer DEFAULT 0 NOT NULL,
+	"created_by_agent" text,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "model_calls" (
+	"id" text PRIMARY KEY NOT NULL,
+	"namespace_id" text,
+	"model" text NOT NULL,
+	"type" "model_call_type" NOT NULL,
+	"latency_ms" integer,
+	"tokens" integer,
+	"status" "model_call_status" NOT NULL,
+	"error" text,
+	"metadata" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "namespaces" (
+	"id" text PRIMARY KEY NOT NULL,
+	"name" text NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "session_summaries" (
+	"id" text PRIMARY KEY NOT NULL,
+	"namespace_id" text NOT NULL,
+	"session_id" text NOT NULL,
+	"content" text NOT NULL,
+	"version" integer DEFAULT 1 NOT NULL,
+	"token_count" integer DEFAULT 0 NOT NULL,
+	"created_by_agent" text,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "shares" (
+	"id" text PRIMARY KEY NOT NULL,
+	"from_namespace_id" text NOT NULL,
+	"to_namespace_id" text NOT NULL,
+	"source_fact_id" text NOT NULL,
+	"snapshot_fact_id" text,
+	"mode" "share_mode" DEFAULT 'reference' NOT NULL,
+	"tombstoned" boolean DEFAULT false NOT NULL,
+	"created_by_agent" text,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+ALTER TABLE "audit_log" ADD CONSTRAINT "audit_log_namespace_id_namespaces_id_fk" FOREIGN KEY ("namespace_id") REFERENCES "public"."namespaces"("id") ON DELETE set null ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "checkpoints" ADD CONSTRAINT "checkpoints_namespace_id_namespaces_id_fk" FOREIGN KEY ("namespace_id") REFERENCES "public"."namespaces"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "embeddings" ADD CONSTRAINT "embeddings_namespace_id_namespaces_id_fk" FOREIGN KEY ("namespace_id") REFERENCES "public"."namespaces"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "facts" ADD CONSTRAINT "facts_namespace_id_namespaces_id_fk" FOREIGN KEY ("namespace_id") REFERENCES "public"."namespaces"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "facts" ADD CONSTRAINT "facts_source_interaction_id_interactions_id_fk" FOREIGN KEY ("source_interaction_id") REFERENCES "public"."interactions"("id") ON DELETE set null ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "interactions" ADD CONSTRAINT "interactions_namespace_id_namespaces_id_fk" FOREIGN KEY ("namespace_id") REFERENCES "public"."namespaces"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "model_calls" ADD CONSTRAINT "model_calls_namespace_id_namespaces_id_fk" FOREIGN KEY ("namespace_id") REFERENCES "public"."namespaces"("id") ON DELETE set null ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "session_summaries" ADD CONSTRAINT "session_summaries_namespace_id_namespaces_id_fk" FOREIGN KEY ("namespace_id") REFERENCES "public"."namespaces"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "shares" ADD CONSTRAINT "shares_from_namespace_id_namespaces_id_fk" FOREIGN KEY ("from_namespace_id") REFERENCES "public"."namespaces"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "shares" ADD CONSTRAINT "shares_to_namespace_id_namespaces_id_fk" FOREIGN KEY ("to_namespace_id") REFERENCES "public"."namespaces"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "shares" ADD CONSTRAINT "shares_source_fact_id_facts_id_fk" FOREIGN KEY ("source_fact_id") REFERENCES "public"."facts"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "shares" ADD CONSTRAINT "shares_snapshot_fact_id_facts_id_fk" FOREIGN KEY ("snapshot_fact_id") REFERENCES "public"."facts"("id") ON DELETE set null ON UPDATE no action;--> statement-breakpoint
+CREATE INDEX "audit_log_namespace_action_created_idx" ON "audit_log" USING btree ("namespace_id","action","created_at");--> statement-breakpoint
+CREATE UNIQUE INDEX "checkpoints_thread_checkpoint_unique" ON "checkpoints" USING btree ("namespace_id","thread_id","checkpoint_id");--> statement-breakpoint
+CREATE UNIQUE INDEX "embeddings_owner_unique" ON "embeddings" USING btree ("owner_type","owner_id");--> statement-breakpoint
+CREATE INDEX "embeddings_namespace_model_status_idx" ON "embeddings" USING btree ("namespace_id","embedding_model","status");--> statement-breakpoint
+CREATE INDEX "embeddings_vector_hnsw_idx" ON "embeddings" USING hnsw ("vector" vector_cosine_ops);--> statement-breakpoint
+CREATE UNIQUE INDEX "facts_namespace_content_hash_unique" ON "facts" USING btree ("namespace_id","content_hash");--> statement-breakpoint
+CREATE INDEX "facts_namespace_subject_idx" ON "facts" USING btree ("namespace_id","subject");--> statement-breakpoint
+CREATE INDEX "facts_source_interaction_idx" ON "facts" USING btree ("source_interaction_id");--> statement-breakpoint
+CREATE UNIQUE INDEX "interactions_namespace_content_hash_unique" ON "interactions" USING btree ("namespace_id","content_hash");--> statement-breakpoint
+CREATE INDEX "interactions_namespace_session_created_idx" ON "interactions" USING btree ("namespace_id","session_id","created_at");--> statement-breakpoint
+CREATE INDEX "model_calls_model_created_idx" ON "model_calls" USING btree ("model","created_at");--> statement-breakpoint
+CREATE INDEX "model_calls_namespace_created_idx" ON "model_calls" USING btree ("namespace_id","created_at");--> statement-breakpoint
+CREATE UNIQUE INDEX "namespaces_name_unique" ON "namespaces" USING btree ("name");--> statement-breakpoint
+CREATE INDEX "session_summaries_namespace_session_version_idx" ON "session_summaries" USING btree ("namespace_id","session_id","version");--> statement-breakpoint
+CREATE UNIQUE INDEX "shares_target_source_unique" ON "shares" USING btree ("to_namespace_id","source_fact_id","mode");--> statement-breakpoint
+CREATE INDEX "shares_from_namespace_idx" ON "shares" USING btree ("from_namespace_id");

package/src/db/migrations/0001_embedding_lease.sql

@@ -0,0 +1,3 @@
+ALTER TYPE "embedding_status" ADD VALUE 'processing';--> statement-breakpoint
+ALTER TABLE "embeddings" ADD COLUMN "lease_until" timestamp with time zone;--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "embeddings_status_created_idx" ON "embeddings" ("status","created_at");

package/src/db/migrations/0002_embedding_lease_token.sql

@@ -0,0 +1 @@
+ALTER TABLE "embeddings" ADD COLUMN "lease_token" text;

package/src/db/migrations/0003_embedding_space.sql

@@ -0,0 +1,9 @@
+ALTER TABLE "embeddings" ADD COLUMN "embedding_space" text;--> statement-breakpoint
+CREATE INDEX "embeddings_namespace_space_status_idx" ON "embeddings" USING btree ("namespace_id","embedding_space","status");
+--> statement-breakpoint
+-- Legacy vectors cannot prove revision/preprocessing identity. Preserve owners and
+-- requeue derived vectors so the worker assigns the actual response space.
+UPDATE "embeddings"
+SET "status" = 'pending', "attempts" = 0, "last_error" = NULL,
+    "lease_until" = NULL, "lease_token" = NULL, "updated_at" = now()
+WHERE "embedding_space" IS NULL;

package/src/db/migrations/0004_markdown_reconcile.sql

@@ -0,0 +1,5 @@
+ALTER TABLE "facts" DROP CONSTRAINT IF EXISTS "facts_source_interaction_id_interactions_id_fk";
+--> statement-breakpoint
+ALTER TABLE "facts" ADD COLUMN IF NOT EXISTS "superseded_by" text;--> statement-breakpoint
+ALTER TABLE "facts" ADD COLUMN IF NOT EXISTS "file_backed" boolean DEFAULT false NOT NULL;--> statement-breakpoint
+ALTER TABLE "session_summaries" ADD COLUMN IF NOT EXISTS "file_backed" boolean DEFAULT false NOT NULL;

package/src/db/migrations/0005_fact_propositions.sql

@@ -0,0 +1 @@
+ALTER TABLE "facts" ADD COLUMN "proposition_key" text;