trellis 3.1.35 → 3.2.0

package/dist/chunk-BQBUVMRN.js

@@ -0,0 +1,171 @@
+import {
+  inferProjectContext,
+  init_infer,
+  init_profile,
+  init_write,
+  loadProfile
+} from "./chunk-7WQGTFVJ.js";
+
+// src/scaffold/seed.ts
+init_profile();
+init_infer();
+import { existsSync, writeFileSync } from "fs";
+import { join } from "path";
+async function seedContext(opts) {
+  const { rootPath, ide = "none", force = false } = opts;
+  const filesUpdated = [];
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const profile = loadProfile();
+  const context = await inferProjectContext(rootPath);
+  const agentsDir = join(rootPath, ".trellis", "agents");
+  if (existsSync(agentsDir)) {
+    const agentsMdPath = join(agentsDir, "AGENTS.md");
+    if (existsSync(agentsMdPath) || force) {
+      const content = renderSeedAgentsMd(profile, context, timestamp);
+      writeFileSync(agentsMdPath, content, "utf-8");
+      filesUpdated.push(".trellis/agents/AGENTS.md");
+    }
+    const agentContextPath = join(agentsDir, "agent-context.json");
+    if (existsSync(agentContextPath) || force) {
+      const config = {
+        domain: context.domain,
+        ecosystem: context.ecosystem,
+        tools: [],
+        ontologies: [],
+        generatedAt: timestamp,
+        confidence: context.confidence,
+        lastSeed: timestamp
+      };
+      writeFileSync(
+        agentContextPath,
+        JSON.stringify(config, null, 2),
+        "utf-8"
+      );
+      filesUpdated.push(".trellis/agents/agent-context.json");
+    }
+  }
+  switch (ide) {
+    case "cursor": {
+      const cursorRulesPath = join(rootPath, ".cursor", "rules.md");
+      if (existsSync(cursorRulesPath) || force) {
+        const content = renderSeedIdeRules(profile, context, "cursor", timestamp);
+        writeFileSync(cursorRulesPath, content, "utf-8");
+        filesUpdated.push(".cursor/rules.md");
+      }
+      break;
+    }
+    case "windsurf": {
+      const windsurfRulesPath = join(rootPath, ".windsurf", "rules.md");
+      if (existsSync(windsurfRulesPath) || force) {
+        const content = renderSeedIdeRules(profile, context, "windsurf", timestamp);
+        writeFileSync(windsurfRulesPath, content, "utf-8");
+        filesUpdated.push(".windsurf/rules.md");
+      }
+      break;
+    }
+    case "claude": {
+      const claudeSettingsPath = join(rootPath, ".claude", "settings.md");
+      if (existsSync(claudeSettingsPath) || force) {
+        const content = renderSeedIdeRules(profile, context, "claude", timestamp);
+        writeFileSync(claudeSettingsPath, content, "utf-8");
+        filesUpdated.push(".claude/settings.md");
+      }
+      break;
+    }
+    case "none":
+      break;
+  }
+  return {
+    success: true,
+    filesUpdated,
+    timestamp
+  };
+}
+function renderSeedAgentsMd(profile, context, timestamp) {
+  const userName = profile?.name ?? "the user";
+  const userBio = profile?.bio ?? "(not provided)";
+  const userSkills = profile?.skills?.length ? profile.skills.join(", ") : "(not specified)";
+  return `# Trellis Agent Context
+
+> This file was seeded by \`trellis seed\` on ${timestamp}
+> Inference confidence: **${context.confidence}**
+
+---
+
+## About the User
+
+| Field | Value |
+|-------|-------|
+| **Name** | ${userName} |
+| **Bio** | ${userBio} |
+| **Skills** | ${userSkills} |
+
+---
+
+## About This Project
+
+| Field | Value |
+|-------|-------|
+| **Name** | ${context.name ?? "(unnamed)"} |
+| **Domain** | ${context.domain ?? "(not determined)"} |
+| **Description** | ${context.description ?? "(no description found)"} |
+| **Ecosystem** | ${context.ecosystem ?? "unknown"} |
+| **File count** | ~${context.fileCount} |
+
+---
+
+## Agent Instructions
+
+You are operating in a Trellis-tracked repository. Follow these guidelines:
+
+1. **Read \`agent-context.json\`** in this directory for registered tools, ontologies, and domain settings.
+2. **Check \`skills/\`** for domain-specific operating instructions relevant to this project.
+3. **Check \`workflows/\`** for repeatable task procedures.
+4. **Run \`trellis seed\`** to refresh this context file when the project evolves.
+
+---
+
+## Quick Reference
+
+\`\`\`bash
+trellis status          # Current repo state
+trellis log             # Causal operation history
+trellis seed            # Refresh this context
+trellis milestone       # Create narrative checkpoints
+\`\`\`
+`;
+}
+function renderSeedIdeRules(profile, context, ide, timestamp) {
+  const ideName = ide.charAt(0).toUpperCase() + ide.slice(1);
+  const projectName = context.name ?? "this project";
+  return `# ${ideName} Rules for ${projectName}
+
+> Generated by \`trellis seed\` on ${timestamp}
+
+## Project Context
+- **Domain**: ${context.domain ?? "(not determined)"}
+- **Ecosystem**: ${context.ecosystem ?? "unknown"}
+- **File count**: ~${context.fileCount}
+- **Confidence**: ${context.confidence}
+
+## Agent Instructions
+You are working in a Trellis-tracked repository. See \`.trellis/agents/AGENTS.md\` for full context.
+
+## Commands
+- \`trellis status\` \u2014 Check repo state
+- \`trellis seed\` \u2014 Refresh this context file
+- \`trellis log\` \u2014 View causal history
+
+---
+*Auto-generated by Trellis. Run \`trellis seed\` to refresh context.*
+`;
+}
+
+// src/scaffold/index.ts
+init_infer();
+init_profile();
+init_write();
+
+export {
+  seedContext
+};

package/dist/chunk-BRGYDO7D.js

@@ -0,0 +1,223 @@
+// src/schema/entity-projection.ts
+function entityRecordToPlain(entity) {
+  const obj = { id: entity.id, type: entity.type };
+  for (const f of entity.facts) {
+    if (f.a !== "type") obj[f.a] = f.v;
+  }
+  return obj;
+}
+function bindingEntityId(row) {
+  const id = row.id ?? row.e ?? row["?e"];
+  return typeof id === "string" && id.length > 0 ? id : null;
+}
+function isSparseBinding(row) {
+  const id = bindingEntityId(row);
+  if (!id) return false;
+  return typeof row.type !== "string";
+}
+function bindingToEntity(row) {
+  const id = bindingEntityId(row);
+  if (id && typeof row.type === "string") {
+    return { ...row, id, type: row.type };
+  }
+  if (id) return { id, type: String(row.type ?? ""), ...row };
+  return row;
+}
+function hydrateBindings(kernel, bindings) {
+  return bindings.map((row) => {
+    if (!isSparseBinding(row)) return bindingToEntity(row);
+    const id = bindingEntityId(row);
+    const entity = kernel.getEntity(id);
+    return entity ? entityRecordToPlain(entity) : bindingToEntity(row);
+  });
+}
+
+// src/schema/eql.ts
+function escapeValue(v) {
+  return v.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+var WHERE_OP_TO_EQL = {
+  eq: "=",
+  ne: "!=",
+  lt: "<",
+  lte: "<=",
+  gt: ">",
+  gte: ">=",
+  contains: "contains",
+  startsWith: "startsWith",
+  endsWith: "endsWith"
+};
+function isWhereFilter(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  return Object.keys(WHERE_OP_TO_EQL).some(
+    (op) => value[op] !== void 0
+  );
+}
+function formatEqlLiteral(value) {
+  if (typeof value === "string") return `"${escapeValue(value)}"`;
+  if (typeof value === "boolean") return value ? "true" : "false";
+  if (typeof value === "number" && Number.isFinite(value)) return String(value);
+  if (value === null || value === void 0) {
+    throw new Error("Cannot format null/undefined as an EQL literal");
+  }
+  return `"${escapeValue(String(value))}"`;
+}
+function whereCondition(attr, value) {
+  if (isWhereFilter(value)) {
+    const ops = Object.keys(WHERE_OP_TO_EQL).filter(
+      (op2) => value[op2] !== void 0
+    );
+    if (ops.length === 0) {
+      throw new Error(`Empty where filter for attribute "${attr}"`);
+    }
+    if (ops.length > 1) {
+      throw new Error(
+        `Where filter for "${attr}" must specify one operator, got: ${ops.join(", ")}`
+      );
+    }
+    const op = ops[0];
+    return `${attr} ${WHERE_OP_TO_EQL[op]} ${formatEqlLiteral(value[op])}`;
+  }
+  return `${attr} = ${formatEqlLiteral(value)}`;
+}
+function entitiesQuery(type, where) {
+  const conds = [`type = "${escapeValue(type)}"`];
+  for (const [k, v] of Object.entries(where ?? {})) {
+    if (v === void 0 || v === null) continue;
+    conds.push(whereCondition(k, v));
+  }
+  return `find ?e where ${conds.join(" and ")}`;
+}
+
+// src/schema/resolve.ts
+function isNestedResolveSpec(v) {
+  return typeof v === "object" && v !== null;
+}
+function relationTargetName(r) {
+  return typeof r.target === "string" ? r.target : r.target().type;
+}
+function relationTargetSchema(r, schemaLookup) {
+  if (typeof r.target !== "string") return r.target();
+  return schemaLookup?.(r.target) ?? null;
+}
+function inverseForeignKey(parent, relationName, child) {
+  for (const [key, r] of Object.entries(child.relations)) {
+    if (relationTargetName(r) === parent.type) return key;
+  }
+  return null;
+}
+async function loadByIds(client, ids, cache) {
+  const missing = ids.filter((id) => !cache.has(id));
+  if (missing.length === 0) return;
+  await Promise.all(
+    missing.map(async (id) => {
+      cache.set(id, await client.read(id));
+    })
+  );
+}
+async function resolveReverseMany(client, parent, relationName, parents, cache, schemaLookup) {
+  const rel = parent.relations[relationName];
+  if (!rel || rel.cardinality !== "many") return;
+  const childSchema = relationTargetSchema(rel, schemaLookup);
+  if (!childSchema) return;
+  const foreignKey = inverseForeignKey(parent, relationName, childSchema);
+  if (!foreignKey) return;
+  const parentIds = new Set(parents.map((p) => p.id));
+  const qr = await client.query(entitiesQuery(childSchema.type));
+  const childIds = qr.bindings.map((b) => bindingEntityId(b)).filter((id) => Boolean(id));
+  await loadByIds(client, childIds, cache);
+  const grouped = /* @__PURE__ */ new Map();
+  for (const id of childIds) {
+    const child = cache.get(id);
+    if (!child) continue;
+    const fk = child[foreignKey];
+    if (typeof fk !== "string" || !parentIds.has(fk)) continue;
+    if (!grouped.has(fk)) grouped.set(fk, []);
+    grouped.get(fk).push(child);
+  }
+  for (const row of parents) {
+    row[relationName] = grouped.get(row.id) ?? [];
+  }
+}
+async function resolveForwardOne(client, parents, relationName, cache) {
+  const ids = parents.map((p) => p[relationName]).filter((v) => typeof v === "string" && v.length > 0);
+  await loadByIds(client, ids, cache);
+  for (const row of parents) {
+    const ref = row[relationName];
+    if (typeof ref !== "string") continue;
+    const loaded = cache.get(ref);
+    if (loaded) row[relationName] = loaded;
+  }
+}
+async function resolveRelations(client, schema, entities, spec, opts) {
+  if (entities.length === 0 || Object.keys(spec).length === 0) return entities;
+  const cache = /* @__PURE__ */ new Map();
+  const rows = opts?.copy === false ? entities : entities.map((e) => ({ ...e }));
+  for (const [name, enabled] of Object.entries(spec)) {
+    if (!enabled) continue;
+    const rel = schema.relations[name];
+    if (!rel) continue;
+    if (rel.cardinality === "many") {
+      await resolveReverseMany(
+        client,
+        schema,
+        name,
+        rows,
+        cache,
+        opts?.schemaLookup
+      );
+      if (isNestedResolveSpec(enabled)) {
+        const childSchema = relationTargetSchema(rel, opts?.schemaLookup);
+        if (childSchema) {
+          for (const row of rows) {
+            const kids = row[name];
+            if (kids?.length) {
+              await resolveRelations(client, childSchema, kids, enabled, {
+                copy: false,
+                schemaLookup: opts?.schemaLookup
+              });
+            }
+          }
+        }
+      }
+    } else if (isNestedResolveSpec(enabled)) {
+      await resolveForwardOne(client, rows, name, cache);
+      const childSchema = relationTargetSchema(rel, opts?.schemaLookup);
+      if (childSchema) {
+        const nested = [];
+        for (const row of rows) {
+          const loaded = row[name];
+          if (loaded && typeof loaded === "object" && "id" in loaded) {
+            nested.push(loaded);
+          }
+        }
+        if (nested.length) {
+          await resolveRelations(client, childSchema, nested, enabled, {
+            copy: false,
+            schemaLookup: opts?.schemaLookup
+          });
+        }
+      }
+    } else {
+      await resolveForwardOne(client, rows, name, cache);
+    }
+  }
+  return rows;
+}
+
+export {
+  entityRecordToPlain,
+  bindingEntityId,
+  isSparseBinding,
+  bindingToEntity,
+  hydrateBindings,
+  escapeValue,
+  isWhereFilter,
+  formatEqlLiteral,
+  whereCondition,
+  entitiesQuery,
+  inverseForeignKey,
+  resolveRelations
+};

package/dist/chunk-BXSTJVE3.js

@@ -0,0 +1,67 @@
+import {
+  __esm
+} from "./chunk-KFQGP6VL.js";
+
+// src/vcs/types.ts
+function fileEntityId(path) {
+  return `file:${path}`;
+}
+function dirEntityId(path) {
+  return `dir:${path}`;
+}
+function branchEntityId(name) {
+  return `branch:${name}`;
+}
+function milestoneEntityId(hash) {
+  return `milestone:${hash}`;
+}
+function checkpointEntityId(hash) {
+  return `checkpoint:${hash}`;
+}
+function issueEntityId(id) {
+  return id.startsWith("issue:") ? id : `issue:${id}`;
+}
+function criterionEntityId(issueId, index) {
+  const bare = issueId.replace(/^issue:/, "");
+  return `criterion:${bare}:ac-${index}`;
+}
+function decisionEntityId(id) {
+  return id.startsWith("decision:") ? id : `decision:${id}`;
+}
+function laneEntityId(id) {
+  return id.startsWith("lane:") ? id : `lane:${id}`;
+}
+var DEFAULT_CONFIG;
+var init_types = __esm({
+  "src/vcs/types.ts"() {
+    "use strict";
+    DEFAULT_CONFIG = {
+      ignorePatterns: [
+        "node_modules",
+        ".git",
+        ".trellis",
+        "dist",
+        "build",
+        ".DS_Store",
+        "*.log"
+      ],
+      debounceMs: 300,
+      defaultBranch: "main",
+      dbPath: ".trellis/trellis.db"
+    };
+  }
+});
+
+export {
+  fileEntityId,
+  dirEntityId,
+  branchEntityId,
+  milestoneEntityId,
+  checkpointEntityId,
+  issueEntityId,
+  criterionEntityId,
+  decisionEntityId,
+  laneEntityId,
+  DEFAULT_CONFIG,
+  init_types
+};