trellis 3.2.3 → 3.2.4

package/dist/{chunk-L5N5PR2S.js → chunk-2WW2X2BR.js}

@@ -4,11 +4,11 @@ import {
   init_decisions,
   queryDecisions,
   recordDecision
-} from "./chunk-GU374KWZ.js";
+} from "./chunk-NLFRRGX6.js";
 import {
   EAVStore,
   init_eav_store
-} from "./chunk-4XIVMVHC.js";
+} from "./chunk-G3XIHPSQ.js";
 import {
   BlobStore,
   JsonOpLog,
@@ -66,20 +66,20 @@ import {
   unblockIssue,
   updateIssue,
   updateLaneHead
-} from "./chunk-VBYUTRXX.js";
+} from "./chunk-YKVB4LUQ.js";
 import {
   DEFAULT_CONFIG,
   init_types
-} from "./chunk-N6MYZT4O.js";
+} from "./chunk-547FZFKO.js";
 import {
   createVcsOp,
   init_ops,
   isVcsOpKind,
   verifyVcsOpHash
-} from "./chunk-GLM4HGN4.js";
+} from "./chunk-GRWQPKYK.js";
 import {
   __esm
-} from "./chunk-KFQGP6VL.js";
+} from "./chunk-2ESYSVXG.js";
 
 // src/watcher/fs-watcher.ts
 import { watch } from "fs";
@@ -698,6 +698,11 @@ function writeTrellisHooks(rootPath, ide) {
   if (!existsSync3(adaptersDir)) {
     mkdirSync2(adaptersDir, { recursive: true });
   }
+  writeFileSync2(
+    join4(trellisHarnessDir, "trellis-cli.sh"),
+    readHarnessTemplate("trellis-cli.sh"),
+    "utf-8"
+  );
   writeFileSync2(
     join4(trellisHarnessDir, "pre-prompt-recall.sh"),
     renderPrePromptRecallScript(),
@@ -1078,8 +1083,9 @@ function renderPrePromptRecallScript() {
 # Normalized contract: TRELLIS_ORIGIN, TRELLIS_DESK_ROOT, TRELLIS_HOOK_OUTPUT
 set -euo pipefail
 
-# Import desk root detection
-source "$(dirname "$0")/../../desk-root.sh"
+# Import desk root detection + trellis CLI helpers
+source "$(dirname "$0")/../desk-root.sh"
+source "$(dirname "$0")/trellis-cli.sh"
 
 # Environment variables from contract
 ORIGIN="\${TRELLIS_ORIGIN:-unknown}"
@@ -1091,24 +1097,18 @@ if ! command -v trellis >/dev/null 2>&1; then
 fi
 
 # Try to get Trellis context (non-blocking)
-if [ -f ".trellis/config.json" ]; then
-  # Query recent memories and entities for context
-  CONTEXT_OUTPUT=$(trellis query --limit 5 --format json 2>/dev/null || echo '{"entities":[],"relations":[]}')
-
-  # Query recent operations for context
-  OPS_OUTPUT=$(trellis log --limit 3 --format json 2>/dev/null || echo '{"operations":[]}')
+if [ -f ".trellis/config.json" ] || [ -f "$(trellis_harness_vcs_path)/.trellis/config.json" ]; then
+  CONTEXT_OUTPUT='{"entities":[],"relations":[]}'
+  OPS_COUNT=$(trellis_harness_recent_log_count 3)
+  ISSUES_COUNT=$(trellis_harness_active_issue_count)
+  OPS_OUTPUT="{\\"count\\":\${OPS_COUNT}}"
+  ISSUES_OUTPUT="{\\"count\\":\${ISSUES_COUNT},\\"status\\":\\"in_progress\\"}"
 
-  # Query active issues
-  ISSUES_OUTPUT=$(trellis issue list --status active --format json 2>/dev/null || echo '{"issues":[]}')
-
-  # Format output based on hook type
   case "$OUTPUT" in
     "agent-stop")
-      # For Codex/Gemini blocking hooks
       echo "{}"
       ;;
     "gemini")
-      # For Gemini CLI format
       cat << EOF
 {
   "decision": "allow",
@@ -1122,12 +1122,10 @@ if [ -f ".trellis/config.json" ]; then
 EOF
       ;;
     *)
-      # Default stdout for Cursor/Devin/Claude
       echo ""
       echo "\u{1F33F} Trellis Context ($ORIGIN):"
-      echo "  Recent memories: $(echo "$CONTEXT_OUTPUT" | jq -r '.entities | length' 2>/dev/null || echo "0")"
-      echo "  Recent ops: $(echo "$OPS_OUTPUT" | jq -r '.operations | length' 2>/dev/null || echo "0")"
-      echo "  Active issues: $(echo "$ISSUES_OUTPUT" | jq -r '.issues | length' 2>/dev/null || echo "0")"
+      echo "  Recent ops: $OPS_COUNT"
+      echo "  Active issues: $ISSUES_COUNT"
       echo ""
       ;;
   esac
@@ -1180,7 +1178,8 @@ function renderPostToolMemoryCaptureScript() {
 set -euo pipefail
 
 # Import desk root detection
-source "$(dirname "$0")/../../desk-root.sh"
+source "$(dirname "$0")/../desk-root.sh"
+source "$(dirname "$0")/trellis-cli.sh"
 
 # Environment variables from contract
 ORIGIN="\${TRELLIS_ORIGIN:-unknown}"
@@ -1255,8 +1254,9 @@ function renderStopTriageScript() {
 # Normalized contract: TRELLIS_ORIGIN, TRELLIS_DESK_ROOT, TRELLIS_HOOK_OUTPUT
 set -euo pipefail
 
-# Import desk root detection
-source "$(dirname "$0")/../../desk-root.sh"
+# Import desk root detection + trellis CLI helpers
+source "$(dirname "$0")/../desk-root.sh"
+source "$(dirname "$0")/trellis-cli.sh"
 
 # Environment variables from contract
 ORIGIN="\${TRELLIS_ORIGIN:-unknown}"
@@ -1267,10 +1267,8 @@ if ! command -v trellis >/dev/null 2>&1; then
   exit 0
 fi
 
-if [ -f ".trellis/config.json" ]; then
-  # Check for active issues that need attention
-  ACTIVE_ISSUES=$(trellis issue list --status active --format json 2>/dev/null || echo '{"issues":[]}')
-  ACTIVE_COUNT=$(echo "$ACTIVE_ISSUES" | jq -r '.issues | length' 2>/dev/null || echo "0")
+if [ -f ".trellis/config.json" ] || [ -f "$(trellis_harness_vcs_path)/.trellis/config.json" ]; then
+  ACTIVE_COUNT=$(trellis_harness_active_issue_count)
 
   # Check for pending memory suggestions
   MEMORY_DIR=".trellis/agent-suggestions"
@@ -1289,7 +1287,7 @@ if [ -f ".trellis/config.json" ]; then
   RECOMMENDATIONS=()
 
   if [ "$ACTIVE_COUNT" -gt 0 ]; then
-    RECOMMENDATIONS+=("\u{1F3AF} $ACTIVE_COUNT active issues need attention - run 'trellis issue list'")
+    RECOMMENDATIONS+=("\u{1F3AF} $ACTIVE_COUNT active issues need attention - run 'trellis issue active'")
   fi
 
   if [ "$SUGGESTION_COUNT" -gt 0 ]; then
@@ -1909,8 +1907,9 @@ function renderBugIntakeScript() {
 # Creates structured issues with acceptance criteria and test requirements
 set -euo pipefail
 
-# Import desk root detection
+# Import desk root detection + trellis CLI helpers
 source "\\$(dirname "\\$0")/../desk-root.sh"
+source "\\$(dirname "\\$0")/trellis-cli.sh"
 
 # Environment variables from contract
 ORIGIN="\${TRELLIS_ORIGIN:-unknown}"
@@ -2001,12 +2000,12 @@ This bug is considered **DONE** when:
 **Template:** bug-intake-v1.0
 "
 
-# Create the Trellis issue
-ISSUE_ID=$(echo "\\$ISSUE_CONTENT" | trellis issue create --title "\\$TITLE" --content-from-stdin --format json 2>/dev/null | jq -r '.id // empty' || echo "")
+# Create the Trellis issue (real CLI \u2014 no --format json)
+BUG_LABELS="bug,severity-\${SEVERITY},component-\${COMPONENT},tdd-required,needs-investigation,needs-triage"
+ISSUE_ID=$(trellis_harness_issue_create "\\$TITLE" "\\$BUG_LABELS" "Bug intake report" "" "queue" || true)
 
 if [ -n "\\$ISSUE_ID" ]; then
-  # Add labels to the issue
-  trellis issue label "\\$ISSUE_ID" add "bug" "severity-\\$SEVERITY" "component-\\$COMPONENT" "tdd-required" "needs-investigation" 2>/dev/null || true
+  trellis_harness_issue_set_description "\\$ISSUE_ID" "\\$ISSUE_CONTENT" || true
 
   echo ""
   echo "\u{1F41B} Bug Intake Completed (\\$ORIGIN):"
@@ -2016,7 +2015,7 @@ if [ -n "\\$ISSUE_ID" ]; then
   echo "  \u2705 TDD requirements enforced"
   echo ""
   echo "\u{1F4CB} Next Steps:"
-  echo "  1. Investigate the bug: trellis issue view \\$ISSUE_ID"
+  echo "  1. Investigate the bug: trellis issue show \\$ISSUE_ID"
   echo "  2. Develop tests with TDD approach"
   echo "  3. Implement fix"
   echo ""
@@ -2032,8 +2031,9 @@ function renderBugInvestigateScript() {
 # Ensures thorough investigation before fix implementation
 set -euo pipefail
 
-# Import desk root detection
+# Import desk root detection + trellis CLI helpers
 source "\\$(dirname "\\$0")/../desk-root.sh"
+source "\\$(dirname "\\$0")/trellis-cli.sh"
 
 # Environment variables from contract
 ORIGIN="\${TRELLIS_ORIGIN:-unknown}"
@@ -2052,8 +2052,7 @@ if [ -z "\\$ISSUE_ID" ]; then
 fi
 
 # Get issue details
-ISSUE_DETAILS=$(trellis issue view "\\$ISSUE_ID" --format json 2>/dev/null || echo "{}")
-TITLE=$(echo "\\$ISSUE_DETAILS" | jq -r '.title // "Unknown Issue"' 2>/dev/null || echo "Unknown Issue")
+TITLE=$(trellis_harness_issue_parse_title "\\$ISSUE_ID" 2>/dev/null || echo "Unknown Issue")
 
 # Create test directory structure
 TEST_DIR="tests/bugs/\\$ISSUE_ID"
@@ -2135,12 +2134,13 @@ echo ""
 }
 function renderMilestoneTriageScript() {
   return `#!/usr/bin/env bash
-# Milestone and cycle triage for Trellis integration
-# Integrates bugs with project milestones and development cycles
+# Milestone and sprint (label) triage for Trellis integration
+# Sprint time-boxing via sprint:* labels \u2014 no trellis cycle * CLI
 set -euo pipefail
 
-# Import desk root detection
+# Import desk root detection + trellis CLI helpers
 source "\\$(dirname "\\$0")/../desk-root.sh"
+source "\\$(dirname "\\$0")/trellis-cli.sh"
 
 # Environment variables from contract
 ORIGIN="\${TRELLIS_ORIGIN:-unknown}"
@@ -2159,17 +2159,17 @@ if [ -z "\\$ISSUE_ID" ]; then
 fi
 
 # Get issue details and calculate priority
-ISSUE_DETAILS=$(trellis issue view "\\$ISSUE_ID" --format json 2>/dev/null || echo "{}")
-TITLE=$(echo "\\$ISSUE_DETAILS" | jq -r '.title // "Unknown Issue"' 2>/dev/null || echo "Unknown Issue")
-LABELS=$(echo "\\$ISSUE_DETAILS" | jq -r '.labels // []' 2>/dev/null || echo "[]")
-SEVERITY=$(echo "\\$LABELS" | jq -r '.[] | select(startswith("severity-")) | split("-")[1]' 2>/dev/null || echo "medium")
-
-# Get current milestone and cycle info
-CURRENT_MILESTONE=$(trellis milestone current --format json 2>/dev/null || echo "{}")
-MILESTONE_NAME=$(echo "\\$CURRENT_MILESTONE" | jq -r '.name // "current"' 2>/dev/null || echo "current")
-
-CURRENT_CYCLE=$(trellis cycle current --format json 2>/dev/null || echo "{}")
-CYCLE_NAME=$(echo "\\$CURRENT_CYCLE" | jq -r '.name // "current"' 2>/dev/null || echo "current")
+TITLE=$(trellis_harness_issue_parse_title "\\$ISSUE_ID" 2>/dev/null || echo "Unknown Issue")
+LABELS_LINE=$(trellis_harness_issue_parse_labels "\\$ISSUE_ID" 2>/dev/null || echo "")
+SEVERITY="medium"
+case "\\$LABELS_LINE" in
+  *severity-critical*) SEVERITY="critical" ;;
+  *severity-high*) SEVERITY="high" ;;
+  *severity-low*) SEVERITY="low" ;;
+esac
+
+MILESTONE_NAME=$(trellis_harness_latest_milestone_name)
+SPRINT_LABEL=$(trellis_harness_sprint_label)
 
 # Calculate priority based on severity
 calculate_priority() {
@@ -2185,29 +2185,33 @@ calculate_priority() {
 
 PRIORITY=$(calculate_priority "\\$SEVERITY")
 
-# Update issue labels and assign to milestone/cycle
-trellis issue label "\\$ISSUE_ID" add "triaged" "priority-\\$PRIORITY" "milestone-\\$MILESTONE_NAME" "cycle-\\$CYCLE_NAME" 2>/dev/null || true
-
-# Update issue priority
-trellis issue priority "\\$ISSUE_ID" set "\\$PRIORITY" 2>/dev/null || true
+MERGED_LABELS=$(trellis_harness_merge_labels "\\$LABELS_LINE" "triaged,priority-\${PRIORITY},milestone-\${MILESTONE_NAME}")
+trellis_harness_issue_update_labels "\\$ISSUE_ID" "\\$MERGED_LABELS" || true
+case "\\$PRIORITY" in
+  urgent) trellis_harness_issue_update_priority "\\$ISSUE_ID" "critical" || true ;;
+  high) trellis_harness_issue_update_priority "\\$ISSUE_ID" "high" || true ;;
+  low) trellis_harness_issue_update_priority "\\$ISSUE_ID" "low" || true ;;
+  *) trellis_harness_issue_update_priority "\\$ISSUE_ID" "medium" || true ;;
+esac
 
 echo ""
-echo "\u{1F3AF} Milestone & Cycle Triage Completed (\\$ORIGIN):"
+echo "\u{1F3AF} Milestone & Sprint Triage Completed (\\$ORIGIN):"
 echo "  \u{1F4DD} Issue: #\\$ISSUE_ID - \\$TITLE"
 echo "  \u{1F6A6} Priority: \\$PRIORITY"
 echo "  \u{1F3AF} Milestone: \\$MILESTONE_NAME"
-echo "  \u{1F504} Cycle: \\$CYCLE_NAME"
+echo "  \u{1F3F7}\uFE0F Sprint (label): \\$SPRINT_LABEL"
 echo ""
 `;
 }
 function renderCyclePlanningScript() {
   return `#!/usr/bin/env bash
-# Cycle planning and workload management for Trellis integration
-# Manages development cycles, sprint planning, and resource allocation
+# Sprint planning (label convention) for Trellis integration
+# Time-boxed WIP via sprint:* issue labels \u2014 no trellis cycle * CLI
 set -euo pipefail
 
-# Import desk root detection
+# Import desk root detection + trellis CLI helpers
 source "\\$(dirname "\\$0")/../desk-root.sh"
+source "\\$(dirname "\\$0")/trellis-cli.sh"
 
 # Environment variables from contract
 ORIGIN="\${TRELLIS_ORIGIN:-unknown}"
@@ -2218,17 +2222,15 @@ if ! command -v trellis >/dev/null 2>&1; then
   exit 0
 fi
 
-# Get current cycle information
-CURRENT_CYCLE=$(trellis cycle current --format json 2>/dev/null || echo "{}")
-CYCLE_NAME=$(echo "\\$CURRENT_CYCLE" | jq -r '.name // "current"' 2>/dev/null || echo "current")
-
-# Get all issues in current cycle
-CYCLE_ISSUES=$(trellis cycle issues --format json 2>/dev/null || echo "[]")
+# Sprint = label convention; plan from in_progress issues + milestones
+SPRINT_LABEL=$(trellis_harness_sprint_label)
+WORKLOAD=$(trellis_harness_active_issue_count)
+MILESTONE_NAME=$(trellis_harness_latest_milestone_name)
 
-# Analyze cycle workload
-total_issues=$(echo "\\$CYCLE_ISSUES" | jq 'length' 2>/dev/null || echo "0")
-urgent_issues=$(echo "\\$CYCLE_ISSUES" | jq '[.[] | select(.labels[] | contains("priority-urgent"))] | length' 2>/dev/null || echo "0")
-high_issues=$(echo "\\$CYCLE_ISSUES" | jq '[.[] | select(.labels[] | contains("priority-high"))] | length' 2>/dev/null || echo "0")
+# Analyze sprint workload
+total_issues="\\$WORKLOAD"
+urgent_issues=0
+high_issues=0
 
 # Calculate health score
 health_score=100
@@ -2240,8 +2242,8 @@ if [ "\\$health_score" -lt 0 ]; then
 fi
 
 echo ""
-echo "\u{1F504} Cycle Planning Completed (\\$ORIGIN):"
-echo "  \u{1F4CA} Cycle: \\$CYCLE_NAME"
+echo "\u{1F504} Sprint Planning Completed (\\$ORIGIN):"
+echo "  \u{1F4CA} Sprint (label): \\$SPRINT_LABEL"
 echo "  \u{1F4C8} Health Score: \\$health_score/100"
 echo "  \u{1F4DD} Total Issues: \\$total_issues"
 echo "  \u{1F6A8} Urgent Issues: \\$urgent_issues"
@@ -2261,6 +2263,170 @@ var init_write = __esm({
   }
 });
 
+// src/vcs/store.ts
+function getEntity(ctx, entityId) {
+  const facts = ctx.store.getFactsByEntity(entityId);
+  if (facts.length === 0) return null;
+  const typeFact = facts.find((f) => f.a === "type");
+  return {
+    id: entityId,
+    type: typeFact?.v ?? "unknown",
+    facts,
+    links: ctx.store.getLinksByEntity(entityId)
+  };
+}
+function listEntities(ctx, type, filters, opts) {
+  let entityIds;
+  if (type) {
+    entityIds = new Set(
+      ctx.store.getFactsByValue("type", type).map((f) => f.e)
+    );
+  } else {
+    entityIds = new Set(ctx.store.getFactsByAttribute("type").map((f) => f.e));
+  }
+  if (!opts?.includeVcs) {
+    for (const id of entityIds) {
+      if (VCS_ENTITY_PREFIXES.some((p) => id.startsWith(p))) {
+        entityIds.delete(id);
+      }
+    }
+  }
+  if (filters) {
+    for (const [attr, value] of Object.entries(filters)) {
+      const matching = new Set(
+        ctx.store.getFactsByValue(attr, value).map((f) => f.e)
+      );
+      for (const id of entityIds) {
+        if (!matching.has(id)) entityIds.delete(id);
+      }
+    }
+  }
+  return Array.from(entityIds).map((id) => getEntity(ctx, id)).filter(Boolean);
+}
+async function createEntity(ctx, entityId, type, attributes = {}, opts) {
+  const facts = [
+    { e: entityId, a: "type", v: type },
+    { e: entityId, a: "createdAt", v: (/* @__PURE__ */ new Date()).toISOString() }
+  ];
+  for (const [attr, value] of Object.entries(attributes)) {
+    facts.push({ e: entityId, a: attr, v: value });
+  }
+  const op = await createVcsOp("vcs:storeAssert", {
+    agentId: ctx.agentId,
+    previousHash: ctx.getLastOp()?.hash,
+    vcs: { facts }
+  });
+  await ctx.applyOp(op);
+  if (opts?.links?.length) {
+    for (const link of opts.links) {
+      await addLink(ctx, entityId, link.attribute, link.targetEntityId);
+    }
+  }
+  return op;
+}
+async function updateEntity(ctx, entityId, updates) {
+  const existing = ctx.store.getFactsByEntity(entityId);
+  if (existing.length === 0) {
+    throw new Error(`Entity ${entityId} not found.`);
+  }
+  const deleteFacts = [];
+  const addFacts = [
+    { e: entityId, a: "updatedAt", v: (/* @__PURE__ */ new Date()).toISOString() }
+  ];
+  for (const [attr, newValue] of Object.entries(updates)) {
+    for (const f of existing.filter((x) => x.a === attr)) {
+      deleteFacts.push(f);
+    }
+    addFacts.push({ e: entityId, a: attr, v: newValue });
+  }
+  if (deleteFacts.length > 0) {
+    const retractOp = await createVcsOp("vcs:storeRetract", {
+      agentId: ctx.agentId,
+      previousHash: ctx.getLastOp()?.hash,
+      vcs: { facts: deleteFacts }
+    });
+    await ctx.applyOp(retractOp);
+  }
+  const op = await createVcsOp("vcs:storeAssert", {
+    agentId: ctx.agentId,
+    previousHash: ctx.getLastOp()?.hash,
+    vcs: { facts: addFacts }
+  });
+  await ctx.applyOp(op);
+  return op;
+}
+async function deleteEntity(ctx, entityId) {
+  const facts = ctx.store.getFactsByEntity(entityId);
+  const links = ctx.store.getLinksByEntity(entityId);
+  if (facts.length === 0 && links.length === 0) {
+    throw new Error(`Entity ${entityId} not found.`);
+  }
+  let lastOp;
+  if (facts.length > 0) {
+    lastOp = await createVcsOp("vcs:storeRetract", {
+      agentId: ctx.agentId,
+      previousHash: ctx.getLastOp()?.hash,
+      vcs: { facts }
+    });
+    await ctx.applyOp(lastOp);
+  }
+  if (links.length > 0) {
+    lastOp = await createVcsOp("vcs:storeUnlink", {
+      agentId: ctx.agentId,
+      previousHash: ctx.getLastOp()?.hash,
+      vcs: { links }
+    });
+    await ctx.applyOp(lastOp);
+  }
+  return lastOp;
+}
+async function addFact(ctx, entityId, attribute, value) {
+  const op = await createVcsOp("vcs:storeAssert", {
+    agentId: ctx.agentId,
+    previousHash: ctx.getLastOp()?.hash,
+    vcs: { facts: [{ e: entityId, a: attribute, v: value }] }
+  });
+  await ctx.applyOp(op);
+  return op;
+}
+async function removeFact(ctx, entityId, attribute, value) {
+  const op = await createVcsOp("vcs:storeRetract", {
+    agentId: ctx.agentId,
+    previousHash: ctx.getLastOp()?.hash,
+    vcs: { facts: [{ e: entityId, a: attribute, v: value }] }
+  });
+  await ctx.applyOp(op);
+  return op;
+}
+async function addLink(ctx, sourceId, attribute, targetId) {
+  const link = { e1: sourceId, a: attribute, e2: targetId };
+  const op = await createVcsOp("vcs:storeLink", {
+    agentId: ctx.agentId,
+    previousHash: ctx.getLastOp()?.hash,
+    vcs: { links: [link] }
+  });
+  await ctx.applyOp(op);
+  return op;
+}
+async function removeLink(ctx, sourceId, attribute, targetId) {
+  const link = { e1: sourceId, a: attribute, e2: targetId };
+  const op = await createVcsOp("vcs:storeUnlink", {
+    agentId: ctx.agentId,
+    previousHash: ctx.getLastOp()?.hash,
+    vcs: { links: [link] }
+  });
+  await ctx.applyOp(op);
+  return op;
+}
+var VCS_ENTITY_PREFIXES;
+var init_store = __esm({
+  "src/vcs/store.ts"() {
+    "use strict";
+    init_ops();
+    VCS_ENTITY_PREFIXES = ["issue:", "file:", "dir:", "branch:", "milestone:", "checkpoint:", "criterion:", "lane:", "decision:"];
+  }
+});
+
 // src/garden/cluster.ts
 function isFileOp(op) {
   return FILE_OP_KINDS.has(op.kind);
@@ -6026,6 +6192,7 @@ var init_engine = __esm({
     init_diff();
     init_merge();
     init_issue();
+    init_store();
     init_decisions();
     init_garden2();
     init_semantic();
@@ -7210,6 +7377,75 @@ var init_engine = __esm({
         return getActiveIssues(this._ctx());
       }
       // -------------------------------------------------------------------------
+      // EAV Store (delegated to src/vcs/store.ts — ADR 0008)
+      // -------------------------------------------------------------------------
+      async createStoreEntity(entityId, type, attributes = {}, opts) {
+        const op = await createEntity(
+          this._ctx(),
+          entityId,
+          type,
+          attributes,
+          opts
+        );
+        await this.flushAutoCheckpoint();
+        return op;
+      }
+      async updateStoreEntity(entityId, updates) {
+        const op = await updateEntity(this._ctx(), entityId, updates);
+        await this.flushAutoCheckpoint();
+        return op;
+      }
+      async deleteStoreEntity(entityId) {
+        const op = await deleteEntity(this._ctx(), entityId);
+        await this.flushAutoCheckpoint();
+        return op;
+      }
+      getStoreEntity(entityId) {
+        return getEntity(this._ctx(), entityId);
+      }
+      listStoreEntities(type, filters, opts) {
+        return listEntities(this._ctx(), type, filters, opts);
+      }
+      /** Raw EAV store (materialized from ops.json in VCS repos). */
+      getEavStore() {
+        return this._ctx().store;
+      }
+      async addStoreFact(entityId, attribute, value) {
+        const op = await addFact(this._ctx(), entityId, attribute, value);
+        await this.flushAutoCheckpoint();
+        return op;
+      }
+      async removeStoreFact(entityId, attribute, value) {
+        const op = await removeFact(
+          this._ctx(),
+          entityId,
+          attribute,
+          value
+        );
+        await this.flushAutoCheckpoint();
+        return op;
+      }
+      async addStoreLink(sourceId, attribute, targetId) {
+        const op = await addLink(
+          this._ctx(),
+          sourceId,
+          attribute,
+          targetId
+        );
+        await this.flushAutoCheckpoint();
+        return op;
+      }
+      async removeStoreLink(sourceId, attribute, targetId) {
+        const op = await removeLink(
+          this._ctx(),
+          sourceId,
+          attribute,
+          targetId
+        );
+        await this.flushAutoCheckpoint();
+        return op;
+      }
+      // -------------------------------------------------------------------------
       // Decision Traces
       // -------------------------------------------------------------------------
       async recordDecision(input) {

package/dist/chunk-3XCOAP6G.js

@@ -0,0 +1,48 @@
+// src/server/deploy-meta.ts
+var DEPLOY_NAME_RE = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+var MIN_LEN = 3;
+var MAX_LEN = 32;
+var DeployNameError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "DeployNameError";
+  }
+};
+function normalizeDeployName(name) {
+  return name.trim().toLowerCase();
+}
+function validateDeployName(name) {
+  const normalized = normalizeDeployName(name);
+  if (!normalized) {
+    throw new DeployNameError("Deploy name is required.");
+  }
+  if (normalized.length < MIN_LEN || normalized.length > MAX_LEN) {
+    throw new DeployNameError(
+      `Deploy name must be ${MIN_LEN}\u2013${MAX_LEN} characters (got ${normalized.length}).`
+    );
+  }
+  if (normalized.includes("--")) {
+    throw new DeployNameError(
+      "Deploy name cannot contain consecutive hyphens."
+    );
+  }
+  if (!DEPLOY_NAME_RE.test(normalized)) {
+    throw new DeployNameError(
+      "Deploy name must start with a letter and use only lowercase letters, numbers, and single hyphens (e.g. my-app)."
+    );
+  }
+  return normalized;
+}
+function buildDeployUrl(name) {
+  const slug = validateDeployName(name);
+  return `https://${slug}.sprites.app`;
+}
+var SPRITE_PUBLIC_HTTP_PORT = 8080;
+
+export {
+  DeployNameError,
+  normalizeDeployName,
+  validateDeployName,
+  buildDeployUrl,
+  SPRITE_PUBLIC_HTTP_PORT
+};