trellis 2.1.7 → 3.0.2

package/dist/scaffold/profile.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Global User Profile
+ *
+ * Manages a persistent user profile stored at ~/.trellis/profile.json.
+ * This profile is captured once on first-ever Trellis use and injected
+ * into every repo's agent scaffold to provide personal context to AI tools.
+ *
+ * The profile is a *soft metadata* layer distinct from the cryptographic
+ * identity in `src/identity/`. If an identity already exists for the repo,
+ * the profile prompt pre-fills the name from `identity.displayName`.
+ *
+ * @module trellis/scaffold/profile
+ */
+export interface UserProfile {
+    name: string;
+    bio: string;
+    skills: string[];
+    style: string;
+    preferences: {
+        verbosity: 'concise' | 'detailed' | 'balanced';
+        tone: 'peer' | 'mentor' | 'formal';
+    };
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Load the global user profile, or null if not yet created.
+ */
+export declare function loadProfile(): UserProfile | null;
+/**
+ * Save (or overwrite) the global user profile.
+ */
+export declare function saveProfile(profile: UserProfile): void;
+/**
+ * Returns true if a global profile exists.
+ */
+export declare function hasProfile(): boolean;
+/**
+ * Interactive terminal prompt to collect user profile.
+ * Called only from the CLI layer, never from programmatic API consumers.
+ *
+ * @param hints Optional pre-fill hints (e.g. from an existing identity)
+ */
+export declare function promptForProfile(hints?: {
+    name?: string;
+}): Promise<UserProfile>;
+/**
+ * Update specific fields of the existing profile without full re-prompting.
+ */
+export declare function updateProfile(updates: Partial<Omit<UserProfile, 'createdAt'>>): UserProfile;
+//# sourceMappingURL=profile.d.ts.map

package/dist/scaffold/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/scaffold/profile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE;QACX,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;QAC/C,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;KACpC,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAkBD;;GAEG;AACH,wBAAgB,WAAW,IAAI,WAAW,GAAG,IAAI,CAShD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAMtD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAeD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,CAAC,EAAE;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,WAAW,CAAC,CAiEvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,GAC/C,WAAW,CAqBb"}

package/dist/scaffold/seed.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Context Seeding
+ *
+ * Rewrites agent context files based on current repository state.
+ * Provides the `trellis seed` command to refresh context without re-running init.
+ *
+ * @module trellis/scaffold/seed
+ */
+import type { IdeType } from './write.js';
+export interface SeedOptions {
+    rootPath: string;
+    ide?: IdeType;
+    force?: boolean;
+}
+export interface SeedResult {
+    success: boolean;
+    filesUpdated: string[];
+    timestamp: string;
+}
+/**
+ * Refresh the agent context files by re-inferring project context.
+ *
+ * @param opts - Options including rootPath and IDE target
+ * @returns SeedResult with success status and list of updated files
+ */
+export declare function seedContext(opts: SeedOptions): Promise<SeedResult>;
+//# sourceMappingURL=seed.d.ts.map

package/dist/scaffold/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/scaffold/seed.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA6ExE"}

package/dist/scaffold/write.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Agent Scaffold Writer
+ *
+ * Writes the agent context directory (.trellis/agents/) during `trellis init`.
+ * Produces AGENTS.md (human + AI readable), agent-context.json (machine
+ * readable), and stub directories for skills and workflows.
+ *
+ * The agent config is named `agent-context.json` (not `config.json`) to avoid
+ * collision with `.trellis/config.json` which stores engine configuration.
+ *
+ * @module trellis/scaffold/write
+ */
+import type { ProjectContext } from './infer.js';
+import type { UserProfile } from './profile.js';
+export interface AgentScaffoldConfig {
+    domain: string | null;
+    ecosystem: string | null;
+    tools: string[];
+    ontologies: string[];
+    generatedAt: string;
+    confidence: string;
+}
+export interface ScaffoldInput {
+    profile: UserProfile | null;
+    context: ProjectContext;
+}
+export type IdeType = 'cursor' | 'windsurf' | 'claude' | 'copilot' | 'codex' | 'gemini' | 'none';
+export type WorkspaceFootprint = 'minimal' | 'standard' | 'full';
+export type FrameworkType = 'react' | 'vue' | 'svelte' | 'next' | 'nuxt' | 'remotion' | 'expo' | 'bun' | 'node' | 'cli' | 'library' | 'animation' | 'games' | 'none';
+export interface IdeScaffoldInput {
+    ide: IdeType;
+    footprint: WorkspaceFootprint;
+    framework: FrameworkType;
+    plugins: string[];
+    rootPath: string;
+    context: ProjectContext;
+    profile: UserProfile | null;
+}
+/**
+ * Write the full agent scaffold into .trellis/agents/.
+ *
+ * @param rootPath - Absolute path to the repository root
+ * @param input    - Profile and inferred project context
+ */
+export declare function writeAgentScaffold(rootPath: string, input: ScaffoldInput): void;
+/**
+ * Write IDE-specific dotfolder scaffolds.
+ *
+ * @param rootPath - Absolute path to the repository root
+ * @param input    - IDE type, footprint, plugins, context, and profile
+ */
+export declare function writeIdeScaffold(rootPath: string, input: IdeScaffoldInput): void;
+//# sourceMappingURL=write.d.ts.map

package/dist/scaffold/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/scaffold/write.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAMhD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AACjG,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AACjE,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAErK,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;IACxB,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAmJD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,GACnB,IAAI,CAoCN;AAwKD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,gBAAgB,GACtB,IAAI,CAmHN"}

package/dist/sdk-snn5gad3.js

@@ -0,0 +1,15 @@
+// @bun
+import {
+  FetchError,
+  TrellisDb
+} from "./index-7e27kvvj.js";
+import"./index-xzym9w0m.js";
+import"./index-y3d71wzd.js";
+import"./index-0zk3fx2s.js";
+import"./index-yhwjgfvj.js";
+import"./index-yp88he8n.js";
+import"./index-a76rekgs.js";
+export {
+  TrellisDb,
+  FetchError
+};

package/dist/semantic/csharp-parser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * C# Parser Adapter
+ *
+ * Tier 1 regex-based parser for C# source files.
+ * Extracts classes, interfaces, structs, enums, records,
+ * methods, properties, fields, using directives, and namespace exports.
+ *
+ * @see TRL-10
+ */
+import type { ParserAdapter } from './types.js';
+export declare const csharpParser: ParserAdapter;
+//# sourceMappingURL=csharp-parser.d.ts.map

package/dist/semantic/csharp-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csharp-parser.d.ts","sourceRoot":"","sources":["../../src/semantic/csharp-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,YAAY,CAAC;AAMpB,eAAO,MAAM,YAAY,EAAE,aAmB1B,CAAC"}

package/dist/semantic/go-parser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Go Parser Adapter
+ *
+ * Tier 1 regex-based parser for Go source files.
+ * Extracts structs, interfaces, functions, methods, type aliases,
+ * constants, variables, and imports.
+ *
+ * @see TRL-6
+ */
+import type { ParserAdapter } from './types.js';
+export declare const goParser: ParserAdapter;
+//# sourceMappingURL=go-parser.d.ts.map

package/dist/semantic/go-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-parser.d.ts","sourceRoot":"","sources":["../../src/semantic/go-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,YAAY,CAAC;AAMpB,eAAO,MAAM,QAAQ,EAAE,aAmBtB,CAAC"}

package/dist/semantic/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Semantic Patching — Public Surface
+ *
+ * @module semantic
+ *
+ * Re-exports the {@link ParserAdapter} interface, the built-in
+ * {@link typescriptParser} (Tier 1 regex-based TS/JS parser), and the
+ * {@link semanticMerge} engine that merges patch sets with commutativity
+ * analysis.
+ *
+ * @see DESIGN.md §4 for the full semantic patching specification.
+ */
+export type { ASTEntity, ASTEntityKind, ImportRelation, ExportRelation, ParseResult, ParserAdapter, SemanticPatch, SemanticMergeConflict, SemanticMergeResult, } from './types.js';
+export { typescriptParser } from './ts-parser.js';
+export { pythonParser } from './python-parser.js';
+export { goParser } from './go-parser.js';
+export { rustParser } from './rust-parser.js';
+export { rubyParser } from './ruby-parser.js';
+export { javaParser } from './java-parser.js';
+export { csharpParser } from './csharp-parser.js';
+export { patchesCommute, semanticMerge } from './semantic-merge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/semantic/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/semantic/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/semantic/java-parser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Java Parser Adapter
+ *
+ * Tier 1 regex-based parser for Java source files.
+ * Extracts classes, interfaces, enums, methods, fields,
+ * annotations, imports, and package declarations.
+ *
+ * @see TRL-9
+ */
+import type { ParserAdapter } from './types.js';
+export declare const javaParser: ParserAdapter;
+//# sourceMappingURL=java-parser.d.ts.map

package/dist/semantic/java-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"java-parser.d.ts","sourceRoot":"","sources":["../../src/semantic/java-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,YAAY,CAAC;AAMpB,eAAO,MAAM,UAAU,EAAE,aAmBxB,CAAC"}

package/dist/semantic/python-parser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Python Parser Adapter
+ *
+ * Tier 1 regex-based parser for Python source files.
+ * Extracts classes, functions, decorators, async functions,
+ * type hints, imports, and module-level variables.
+ *
+ * @see TRL-5
+ */
+import type { ParserAdapter } from './types.js';
+export declare const pythonParser: ParserAdapter;
+//# sourceMappingURL=python-parser.d.ts.map

package/dist/semantic/python-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-parser.d.ts","sourceRoot":"","sources":["../../src/semantic/python-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,YAAY,CAAC;AAMpB,eAAO,MAAM,YAAY,EAAE,aAmB1B,CAAC"}

package/dist/semantic/ruby-parser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Ruby Parser Adapter
+ *
+ * Tier 1 regex-based parser for Ruby source files.
+ * Extracts classes, modules, methods, constants, attributes,
+ * require/include statements, and module_function exports.
+ *
+ * @see TRL-8
+ */
+import type { ParserAdapter } from './types.js';
+export declare const rubyParser: ParserAdapter;
+//# sourceMappingURL=ruby-parser.d.ts.map

package/dist/semantic/ruby-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruby-parser.d.ts","sourceRoot":"","sources":["../../src/semantic/ruby-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,YAAY,CAAC;AAMpB,eAAO,MAAM,UAAU,EAAE,aAmBxB,CAAC"}

package/dist/semantic/rust-parser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Rust Parser Adapter
+ *
+ * Tier 1 regex-based parser for Rust source files.
+ * Extracts structs, enums, traits, impl blocks, functions,
+ * methods, type aliases, constants, macros, and use statements.
+ *
+ * @see TRL-7
+ */
+import type { ParserAdapter } from './types.js';
+export declare const rustParser: ParserAdapter;
+//# sourceMappingURL=rust-parser.d.ts.map

package/dist/semantic/rust-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rust-parser.d.ts","sourceRoot":"","sources":["../../src/semantic/rust-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,YAAY,CAAC;AAMpB,eAAO,MAAM,UAAU,EAAE,aAmBxB,CAAC"}

package/dist/semantic/semantic-merge.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Semantic Merge Engine
+ *
+ * DESIGN.md §4.4 — Patch Commutativity and Conflict Detection.
+ * Two patches commute when they operate on disjoint entities.
+ * Two patches conflict when they both modify the same entity
+ * in incompatible ways.
+ */
+import type { SemanticPatch, SemanticMergeResult } from './types.js';
+/**
+ * Check if two patches commute (can be applied in either order).
+ * Returns true if they operate on disjoint entities or are identical.
+ */
+export declare function patchesCommute(a: SemanticPatch, b: SemanticPatch): boolean;
+/**
+ * Merge two sets of semantic patches (ours and theirs) against a common base.
+ * Produces a merged patch list or structured conflicts.
+ */
+export declare function semanticMerge(oursPatches: SemanticPatch[], theirsPatches: SemanticPatch[], filePath?: string): SemanticMergeResult;
+//# sourceMappingURL=semantic-merge.d.ts.map

package/dist/semantic/semantic-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-merge.d.ts","sourceRoot":"","sources":["../../src/semantic/semantic-merge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EAEb,mBAAmB,EACpB,MAAM,YAAY,CAAC;AA0EpB;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAwB1E;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,aAAa,EAAE,EAC5B,aAAa,EAAE,aAAa,EAAE,EAC9B,QAAQ,GAAE,MAAW,GACpB,mBAAmB,CAgFrB"}

package/dist/semantic/ts-parser.d.ts

@@ -0,0 +1,13 @@
+/**
+ * TypeScript/JavaScript Parser Adapter
+ *
+ * DESIGN.md §4.2 — Structural extraction of top-level declarations
+ * using regex-based parsing. This is a Tier 1 implementation that
+ * extracts functions, classes, interfaces, type aliases, enums,
+ * variables, imports, and exports without requiring tree-sitter.
+ *
+ * Tree-sitter can be swapped in later for full Tier 2 AST fidelity.
+ */
+import type { ParserAdapter } from './types.js';
+export declare const typescriptParser: ParserAdapter;
+//# sourceMappingURL=ts-parser.d.ts.map

package/dist/semantic/ts-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-parser.d.ts","sourceRoot":"","sources":["../../src/semantic/ts-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,YAAY,CAAC;AAMpB,eAAO,MAAM,gBAAgB,EAAE,aAoB9B,CAAC"}

package/dist/semantic/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Semantic Patching — Type Definitions
+ *
+ * DESIGN.md §4.1–4.4 — Pillar 2: Semantic Patching.
+ * Types for parser adapters, AST entities, parse results,
+ * semantic patches, and structured merge conflicts.
+ */
+export interface ASTEntity {
+    /** Stable ID derived from structural signature (name + kind + scope path). */
+    id: string;
+    /** Entity type. */
+    kind: ASTEntityKind;
+    /** Human-readable name. */
+    name: string;
+    /** Scope path for disambiguation (e.g. 'MyClass.myMethod'). */
+    scopePath: string;
+    /** Byte range in source for roundtrip (start, end). */
+    span: [number, number];
+    /** Raw source text of this declaration. */
+    rawText: string;
+    /** Structural signature for identity matching (excludes whitespace/comments). */
+    signature: string;
+    /** Child entities (nested functions, inner classes, etc.). */
+    children: ASTEntity[];
+}
+export type ASTEntityKind = 'FunctionDef' | 'ClassDef' | 'InterfaceDef' | 'TypeAlias' | 'EnumDef' | 'VariableDecl' | 'MethodDef' | 'PropertyDef' | 'Constructor' | 'Unknown';
+export interface ImportRelation {
+    source: string;
+    specifiers: string[];
+    isDefault: boolean;
+    isNamespace: boolean;
+    rawText: string;
+    span: [number, number];
+}
+export interface ExportRelation {
+    name: string;
+    isDefault: boolean;
+    source?: string;
+    rawText: string;
+    span: [number, number];
+}
+export interface ParseResult {
+    /** The file entity this parse belongs to. */
+    fileEntityId: string;
+    /** File path. */
+    filePath: string;
+    /** Language identifier. */
+    language: string;
+    /** Top-level declarations found in the file. */
+    declarations: ASTEntity[];
+    /** Import relationships. */
+    imports: ImportRelation[];
+    /** Export relationships. */
+    exports: ExportRelation[];
+}
+export interface ParserAdapter {
+    /** Languages this adapter supports. */
+    languages: string[];
+    /** Parse a source file into AST-level entities. */
+    parse(content: string, filePath: string): ParseResult;
+    /** Compute semantic patches between two parse results. */
+    diff(oldResult: ParseResult, newResult: ParseResult): SemanticPatch[];
+}
+export type SemanticPatch = {
+    kind: 'symbolAdd';
+    entity: ASTEntity;
+} | {
+    kind: 'symbolRemove';
+    entityId: string;
+    entityName: string;
+} | {
+    kind: 'symbolModify';
+    entityId: string;
+    entityName: string;
+    oldSignature: string;
+    newSignature: string;
+    oldRawText: string;
+    newRawText: string;
+} | {
+    kind: 'symbolRename';
+    entityId: string;
+    oldName: string;
+    newName: string;
+} | {
+    kind: 'symbolMove';
+    entityId: string;
+    entityName: string;
+    oldFile: string;
+    newFile: string;
+} | {
+    kind: 'importAdd';
+    fileId: string;
+    source: string;
+    specifiers: string[];
+    rawText: string;
+} | {
+    kind: 'importRemove';
+    fileId: string;
+    source: string;
+} | {
+    kind: 'importModify';
+    fileId: string;
+    source: string;
+    oldSpecifiers: string[];
+    newSpecifiers: string[];
+} | {
+    kind: 'exportAdd';
+    fileId: string;
+    name: string;
+    rawText: string;
+} | {
+    kind: 'exportRemove';
+    fileId: string;
+    name: string;
+};
+export interface SemanticMergeConflict {
+    entityId: string;
+    entityName: string;
+    entityKind: string;
+    filePath: string;
+    ours: SemanticPatch;
+    theirs: SemanticPatch;
+    suggestion?: 'accept-ours' | 'accept-theirs' | 'combine';
+}
+export interface SemanticMergeResult {
+    clean: boolean;
+    patches: SemanticPatch[];
+    conflicts: SemanticMergeConflict[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/semantic/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/semantic/types.ts"],"names":[],"mappings":"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"}

package/dist/server/auth.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Trellis Server — Auth
+ *
+ * Produces an `AuthContext` from a request using one of:
+ *   - Bearer JWT (signed with jwtSecret)
+ *   - API key (compared against configured key)
+ *   - Unauthenticated (public access)
+ *
+ * OAuth provider flows (Google, GitHub) are handled separately and ultimately
+ * issue a JWT, so this module just needs to verify tokens.
+ *
+ * @module trellis/server
+ */
+export interface AuthContext {
+    /** User entity ID (null = unauthenticated). */
+    userId: string | null;
+    /** Tenant ID (null = default tenant). */
+    tenantId: string | null;
+    /** Roles assigned to this user. */
+    roles: string[];
+    /** Raw JWT claims (if authenticated via JWT). */
+    claims: Record<string, unknown>;
+    /** Whether this request passed authentication. */
+    authenticated: boolean;
+}
+export declare const ANONYMOUS: AuthContext;
+/**
+ * Sign a JWT payload with HS256.
+ */
+export declare function signJwt(payload: Record<string, unknown>, secret: string, expiresInSeconds?: number): Promise<string>;
+/**
+ * Verify and decode a JWT. Returns null if invalid or expired.
+ */
+export declare function verifyJwt(token: string, secret: string): Promise<Record<string, unknown> | null>;
+export interface AuthConfig {
+    /** Secret for JWT verification. Required for JWT auth. */
+    jwtSecret?: string;
+    /** Static API key. If set, `Authorization: Bearer <key>` is also accepted. */
+    apiKey?: string;
+    /** Allow unauthenticated (public) access. Default: true. */
+    allowPublic?: boolean;
+}
+/**
+ * Resolve an `AuthContext` from an HTTP request's Authorization header.
+ */
+export declare function resolveAuth(authHeader: string | null | undefined, config: AuthConfig): Promise<AuthContext>;
+export interface OAuthProvider {
+    name: string;
+    clientId: string;
+    clientSecret: string;
+    authUrl: string;
+    tokenUrl: string;
+    userInfoUrl: string;
+    scopes: string[];
+}
+export declare const GOOGLE_PROVIDER: Omit<OAuthProvider, 'clientId' | 'clientSecret'>;
+export declare const GITHUB_PROVIDER: Omit<OAuthProvider, 'clientId' | 'clientSecret'>;
+/**
+ * Build an OAuth authorization redirect URL.
+ */
+export declare function buildOAuthUrl(provider: OAuthProvider, redirectUri: string, state: string): string;
+/**
+ * Exchange an OAuth code for an access token + user info.
+ * Returns normalized user profile.
+ */
+export declare function exchangeOAuthCode(provider: OAuthProvider, code: string, redirectUri: string): Promise<{
+    id: string;
+    email: string;
+    name: string;
+    avatarUrl?: string;
+}>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/server/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/server/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,mCAAmC;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,SAAS,EAAE,WAMvB,CAAC;AA+BF;;GAEG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,gBAAgB,SAAQ,GACvB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAkCzC;AAMD,MAAM,WAAW,UAAU;IACzB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACrC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,WAAW,CAAC,CAyCtB;AAMD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,eAAO,MAAM,eAAe,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,cAAc,CAO1E,CAAC;AAEJ,eAAO,MAAM,eAAe,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,cAAc,CAO1E,CAAC;AAEJ;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,MAAM,CASR;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA2C1E"}

package/dist/server/deploy.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Trellis DB — Sprites Deployment
+ *
+ * Deploys a Trellis DB server to a Sprites cloud environment.
+ *
+ * Sprites is a cloud VM platform. Each Sprite gets a persistent URL:
+ *   https://<name>.sprites.app
+ *
+ * Deployment steps:
+ *   1. Bundle the server entrypoint with Bun
+ *   2. Create or wake the target Sprite via `sprite exec`
+ *   3. Upload the bundle + SQLite file (if seeding)
+ *   4. Install dependencies and start the server as a detached session
+ *   5. Write the resulting URL + API key back to .trellis-db.json
+ *
+ * Prerequisites:
+ *   - `sprite` CLI installed and authenticated (https://docs.sprites.dev)
+ *   - SPRITES_API_KEY env var (or passed directly)
+ *
+ * @module trellis/server
+ */
+export interface DeployOptions {
+    /** Sprite name (becomes the subdomain: <name>.sprites.app). */
+    name: string;
+    /** Path to the local .trellis-db directory to deploy. */
+    dbPath?: string;
+    /** API key for the deployed server. Auto-generated if not provided. */
+    apiKey?: string;
+    /** JWT secret for the deployed server. Auto-generated if not provided. */
+    jwtSecret?: string;
+    /** Port to run on inside the Sprite (default: 3000). */
+    port?: number;
+    /** Directory where .trellis-db.json lives. Default: cwd. */
+    configDir?: string;
+    /** Progress callback. */
+    onProgress?: (msg: string) => void;
+}
+export interface DeployResult {
+    url: string;
+    name: string;
+    apiKey: string;
+}
+export declare function deploy(opts: DeployOptions): Promise<DeployResult>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/server/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/server/deploy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAWH,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAsB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAuGvE"}

package/dist/server/import.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Trellis Server — Data Import
+ *
+ * Ingest records from CSV, JSON, NDJSON, and Parquet files into the kernel.
+ * Each row becomes a Trellis entity of the given type.
+ *
+ * @module trellis/server
+ */
+import type { TrellisKernel } from '../core/kernel/trellis-kernel.js';
+export interface ImportOptions {
+    /** Entity type to assign to every imported record. */
+    type: string;
+    /** Optional: field to use as entity ID. Defaults to auto-generated UUIDs. */
+    idField?: string;
+    /** Optional: prefix for generated entity IDs. Default: `import:` */
+    idPrefix?: string;
+    /** Skip rows where this field is falsy. */
+    skipEmpty?: boolean;
+    /** Max rows to import (useful for testing). */
+    limit?: number;
+}
+export interface ImportResult {
+    imported: number;
+    skipped: number;
+    errors: Array<{
+        row: number;
+        message: string;
+    }>;
+    entityIds: string[];
+}
+/**
+ * Import data from a file into the kernel.
+ * Format is inferred from the file extension.
+ */
+export declare function importFile(kernel: TrellisKernel, filePath: string, opts: ImportOptions): Promise<ImportResult>;
+/**
+ * Import from an array of plain objects directly (useful for programmatic use).
+ */
+export declare function importRecords(kernel: TrellisKernel, records: Record<string, unknown>[], opts: ImportOptions): Promise<ImportResult>;
+//# sourceMappingURL=import.d.ts.map

package/dist/server/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/server/import.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAOtE,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAMD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,YAAY,CAAC,CAmBvB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAClC,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,YAAY,CAAC,CAEvB"}