@shardworks/nexus-core 0.1.97 → 0.1.99

package/README.md

@@ -0,0 +1,243 @@
+# `@shardworks/nexus-core`
+
+The public SDK for Nexus Mk 2.1. Rig authors import from this package to define tools, declare books, and read guild configuration.
+
+This package is a dependency of every rig. It does not depend on mainspring or the CLI — the dependency graph runs one way: rigs → core.
+
+---
+
+## `tool()` — Tool SDK
+
+Define a Nexus tool. This is the primary authoring entry point for rig packages.
+
+```typescript
+import { tool } from '@shardworks/nexus-core';
+import { z } from 'zod';
+
+export default tool({
+  name: 'greet',
+  description: 'Greet an anima by name',
+  params: {
+    name: z.string().describe('Anima name'),
+  },
+  handler: async ({ name }, ctx) => {
+    return `Hello, ${name}! Guild root: ${ctx.home}`;
+  },
+});
+```
+
+A rig package exports a `Rig` object, a single tool, or an array of tools as its default export. Mainspring discovers them automatically at install time.
+
+### `ToolDefinition`
+
+The return type of `tool()`. MCP, CLI, and engines all consume this shape.
+
+### `ToolCaller`
+
+`'cli' | 'mcp'` — controls which surfaces a tool appears on. Set via `callableFrom`:
+
+```typescript
+tool({
+  name: 'rig-install',
+  callableFrom: ['cli'],   // CLI only — not exposed to animas via MCP
+  ...
+});
+```
+
+Defaults to all callers if omitted.
+
+### Resolution helpers
+
+```typescript
+// Find one tool from a module's default export
+resolveToolFromExport(moduleDefault, toolName?)
+
+// Find all tools from a module's default export
+resolveAllToolsFromExport(moduleDefault)
+
+// Type guard
+isToolDefinition(obj)
+```
+
+---
+
+## `Rig` — Rig Export Type
+
+The author-facing export type for a rig package. Rig packages export this as their default export. Mainspring reads it at load time to discover the rig's contributions.
+
+```typescript
+import { type Rig, tool } from '@shardworks/nexus-core';
+
+const myTool = tool({ ... });
+
+export default {
+  tools: [myTool],
+  books: {
+    writs: { indexes: ['status', 'createdAt', 'parent.id'] },
+  },
+} satisfies Rig;
+```
+
+| Field | Type | Description |
+|---|---|---|
+| `tools?` | `ToolDefinition[]` | Tools this rig contributes to the guild |
+| `books?` | `Record<string, BookOptions>` | Named document collections — mainspring creates SQLite tables and indexes at startup |
+
+Backward-compatible: rigs may still export a bare `ToolDefinition` or `ToolDefinition[]` directly.
+
+### `BookOptions`
+
+Schema declaration for a single book:
+
+```typescript
+interface BookOptions {
+  indexes?: string[];  // field names to index (plain or dot-notation)
+}
+```
+
+### `isRig(obj)`
+
+Type guard distinguishing a `Rig` export from a bare tool or array.
+
+---
+
+## `RigContext` — Handler Context
+
+Injected into every tool and engine handler. Scoped to the rig that owns the handler.
+
+```typescript
+interface RigContext {
+  home: string;
+
+  book<T extends { id: string }>(name: string): Book<T>;
+  rigBook<T extends { id: string }>(rigId: string, name: string): ReadOnlyBook<T>;
+}
+```
+
+| Member | Returns | Description |
+|---|---|---|
+| `home` | `string` | Absolute path to the guild root |
+| `book(name)` | `Book<T>` | Read-write handle to one of this rig's declared books |
+| `rigBook(rigId, name)` | `ReadOnlyBook<T>` | Read-only handle to another rig's book |
+
+`ToolContext` is a deprecated alias for `RigContext`, re-exported from legacy for backward compatibility.
+
+---
+
+## `Book<T>` — Document Store
+
+The NoSQL document store primitive for rig authors. `T` must extend `{ id: string }` — rig authors own ID generation.
+
+| Method | Description |
+|---|---|
+| `put(content)` | Upsert a document (creates or replaces entirely by `content.id`) |
+| `get(id)` | Retrieve by id, or `null` |
+| `delete(id)` | Remove by id (silent no-op if absent) |
+| `find(query)` | Query with `where`, `orderBy`, `order`, `limit`, `offset` |
+| `list(options?)` | List all documents, optionally paginated and sorted |
+| `count(where?)` | Count documents matching an optional filter |
+
+### `BookQuery`
+
+```typescript
+type BookQuery = {
+  where?: Record<string, unknown>;  // field equality filters, ANDed
+  orderBy?: string;                 // plain name or dot-notation
+  order?: 'asc' | 'desc';
+  limit?: number;
+  offset?: number;                  // requires limit
+}
+```
+
+### `ReadOnlyBook<T>`
+
+Returned by `rigBook()` for cross-rig access. Same as `Book<T>` minus `put` and `delete`.
+
+---
+
+## `guild-config` — Guild Configuration
+
+Read and write `guild.json`, the guild's central configuration file.
+
+```typescript
+import { readGuildConfigV2, writeGuildConfigV2 } from '@shardworks/nexus-core';
+
+const config = readGuildConfigV2(home);
+config.baseTools.push('my-tool');
+writeGuildConfigV2(home, config);
+```
+
+### `GuildConfigV2`
+
+The shape of `guild.json` for V2 guilds:
+
+| Field | Type | Description |
+|---|---|---|
+| `name` | `string` | Guild name |
+| `nexus` | `string` | Framework version at last init/upgrade |
+| `rigs` | `string[]` | Installed rig keys (derived from npm package names) |
+| `baseTools` | `string[]` | Tools available to all animas |
+| `roles` | `Record<string, RoleDefinition>` | Guild roles with seats, tools, instructions |
+| `workshops` | `Record<string, WorkshopEntry>` | Registered workshops |
+| `settings?` | `GuildSettings` | Operational flags including default `model` |
+| `clockworks?` | `ClockworksConfig` | Standing orders and custom events |
+| `writTypes?` | `Record<string, WritTypeDeclaration>` | Custom writ type declarations |
+
+### Other exports
+
+```typescript
+guildConfigPath(home)              // path to guild.json
+createInitialGuildConfigV2(...)    // default config for nsg init
+```
+
+---
+
+## `nexus-home` — Path Resolution
+
+Resolve standard paths within a guild's `.nexus/` directory.
+
+```typescript
+import { findGuildRoot, nexusDir } from '@shardworks/nexus-core';
+
+const home = findGuildRoot();          // walks up from cwd to find guild.json
+const dir  = nexusDir(home);           // .nexus/
+```
+
+### All path helpers
+
+| Function | Returns |
+|---|---|
+| `findGuildRoot(startDir?)` | Guild root (walks up from cwd, throws if not found) |
+| `nexusDir(home)` | `.nexus/` |
+| `worktreesPath(home)` | `.nexus/worktrees/` |
+| `workshopsPath(home)` | `.nexus/workshops/` |
+| `workshopBarePath(home, name)` | `.nexus/workshops/<name>.git` |
+| `clockPidPath(home)` | `.nexus/clock.pid` |
+| `clockLogPath(home)` | `.nexus/clock.log` |
+
+---
+
+## `rig-descriptor` — Rig Descriptor Types
+
+Types for `rig.json`, the optional descriptor a rig package can include at its root to declare dependencies on other rigs.
+
+```typescript
+import type { RigDescriptor } from '@shardworks/nexus-core';
+```
+
+### `RigDescriptor`
+
+```typescript
+interface RigDescriptor {
+  description?: string;
+  dependencies?: RigDependency[];
+}
+
+interface RigDependency {
+  rig: string;   // rig key, e.g. 'nexus-stdlib'
+}
+```
+
+Mainspring reads `rig.json` at install time. If declared dependencies aren't installed, `nsg rig install` fails with a clear error.
+
+A rig with no dependencies needs no `rig.json` at all.

package/dist/book.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Book — the NoSQL document store primitive for rig authors.
+ *
+ * A Book is a named, schemaless collection of JSON documents. Content types
+ * must include `id: string` — rig authors own ID generation and include it
+ * as part of their domain type. No framework-managed envelope or timestamps.
+ *
+ * Books are declared in the rig's `Rig` export via `books?: Record<string, BookOptions>`.
+ * Mainspring creates the backing SQLite tables and indexes at startup.
+ *
+ * Rig authors access books through `RigContext.book()` and `RigContext.rigBook()`.
+ * The storage backend (SQLite) is an implementation detail — field names in
+ * indexes and queries use plain dot-notation, not JSONPath syntax.
+ */
+/**
+ * Pagination options for `Book.find()` and `Book.list()`.
+ *
+ * `offset` requires `limit` — passing offset alone is a type error.
+ * This mirrors SQLite's requirement and makes the constraint explicit at
+ * the call site rather than silently patching it in the adapter.
+ */
+export type Pagination = {
+    limit: number;
+    offset?: number;
+} | {
+    limit?: never;
+    offset?: never;
+};
+/**
+ * Query options for `Book.find()`.
+ */
+export type BookQuery = {
+    /**
+     * Field equality filters, ANDed together.
+     *
+     * Use plain field names or dot notation for nested fields.
+     * The storage adapter handles translation internally.
+     *
+     * @example { status: 'active', anima: 'vera' }
+     * @example { 'parent.id': '123' }
+     */
+    where?: Record<string, unknown>;
+    /**
+     * Field to sort by. Plain name or dot notation for nested fields.
+     * @example 'createdAt'
+     * @example 'parent.id'
+     */
+    orderBy?: string;
+    /** Sort direction. Defaults to 'asc'. */
+    order?: 'asc' | 'desc';
+} & Pagination;
+/** Options for `Book.list()` — pagination and sorting without a where clause. */
+export type ListOptions = {
+    orderBy?: string;
+    order?: 'asc' | 'desc';
+} & Pagination;
+/**
+ * A document collection — the primary Books API surface for rig authors.
+ *
+ * `T` must extend `{ id: string }` — the id is part of the content type,
+ * not a framework-managed wrapper. Rig authors generate IDs (e.g. ULIDs)
+ * and include them in the content passed to `put()`.
+ *
+ * Obtained via `RigContext.book<T>(name)` for own-rig books or
+ * `RigContext.rigBook<T>(rigId, name)` for cross-rig read access.
+ */
+export interface Book<T extends {
+    id: string;
+}> {
+    /**
+     * Upsert a document. Creates if `content.id` is new; replaces the stored
+     * document entirely if it already exists.
+     */
+    put(content: T): Promise<void>;
+    /**
+     * Get a document by id. Returns null if not found.
+     */
+    get(id: string): Promise<T | null>;
+    /**
+     * Delete a document by id. Silent no-op if the document does not exist.
+     */
+    delete(id: string): Promise<void>;
+    /**
+     * Find documents matching a query.
+     *
+     * All `where` conditions are ANDed. Results are returned as `T[]` — no
+     * envelope, no metadata wrapper.
+     */
+    find(query: BookQuery): Promise<T[]>;
+    /**
+     * List all documents, optionally paginated and sorted.
+     * Equivalent to `find()` with no `where` clause.
+     */
+    list(options?: ListOptions): Promise<T[]>;
+    /**
+     * Count documents matching an optional where clause.
+     * Efficient — does not fetch payloads.
+     */
+    count(where?: BookQuery['where']): Promise<number>;
+}
+/**
+ * Read-only view of a Book — returned by `RigContext.rigBook()` for cross-rig access.
+ *
+ * Omits write operations (`put`, `delete`). Rig authors should not write to
+ * another rig's books.
+ */
+export type ReadOnlyBook<T extends {
+    id: string;
+}> = Pick<Book<T>, 'get' | 'find' | 'list' | 'count'>;
+//# sourceMappingURL=book.d.ts.map

package/dist/book.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"book.d.ts","sourceRoot":"","sources":["../src/book.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,yCAAyC;IACzC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB,GAAG,UAAU,CAAC;AAEf,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB,GAAG,UAAU,CAAC;AAEf;;;;;;;;;GASG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IAC5C;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEnC;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAErC;;;OAGG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAE1C;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpD;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,IAAI,IAAI,CACvD,IAAI,CAAC,CAAC,CAAC,EACP,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAClC,CAAC"}

package/dist/book.js

@@ -0,0 +1,16 @@
+/**
+ * Book — the NoSQL document store primitive for rig authors.
+ *
+ * A Book is a named, schemaless collection of JSON documents. Content types
+ * must include `id: string` — rig authors own ID generation and include it
+ * as part of their domain type. No framework-managed envelope or timestamps.
+ *
+ * Books are declared in the rig's `Rig` export via `books?: Record<string, BookOptions>`.
+ * Mainspring creates the backing SQLite tables and indexes at startup.
+ *
+ * Rig authors access books through `RigContext.book()` and `RigContext.rigBook()`.
+ * The storage backend (SQLite) is an implementation detail — field names in
+ * indexes and queries use plain dot-notation, not JSONPath syntax.
+ */
+export {};
+//# sourceMappingURL=book.js.map

package/dist/book.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"book.js","sourceRoot":"","sources":["../src/book.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/guild-config.d.ts

@@ -13,17 +13,6 @@ export interface RoleDefinition {
      */
     instructions?: string;
 }
-/** A reference to a tool or engine registered in guild.json. */
-export interface ToolEntry {
-    /** Upstream package identifier, e.g. "@shardworks/tool-commission@1.11.3". Null for locally-built tools. */
-    upstream: string | null;
-    /** ISO-8601 timestamp of when the tool was installed. */
-    installedAt: string;
-    /** npm package name for runtime resolution via node_modules. Omitted for script-only tools. */
-    package?: string;
-    /** Bundle that delivered this artifact, e.g. "@shardworks/guild-starter-kit@0.1.0". */
-    bundle?: string;
-}
 /** A custom event declaration in guild.json clockworks.events. */
 export interface EventDeclaration {
     /** Human-readable description of what this event means. */
@@ -55,15 +44,6 @@ export interface ClockworksConfig {
     /** Standing orders — event → action mappings. */
     standingOrders?: StandingOrder[];
 }
-/** A reference to a curriculum or temperament registered in guild.json. */
-export interface TrainingEntry {
-    /** Upstream package identifier, or null for locally-authored content. */
-    upstream: string | null;
-    /** ISO-8601 timestamp of when the content was installed. */
-    installedAt: string;
-    /** Bundle that delivered this artifact, e.g. "@shardworks/guild-starter-kit@0.1.0". */
-    bundle?: string;
-}
 /** A registered workshop — a repository where the guild does its work. */
 export interface WorkshopEntry {
     /** Git remote URL (the clone source). */
@@ -73,6 +53,11 @@ export interface WorkshopEntry {
 }
 /** Guild-level settings — operational flags and preferences. */
 export interface GuildSettings {
+    /**
+     * Default LLM model for anima sessions (e.g. 'sonnet', 'opus').
+     * Replaces the top-level `model` field from GuildConfig V1.
+     */
+    model?: string;
     /**
      * Automatically apply pending database migrations when the Books are opened.
      * Defaults to `true` when not specified. Set to `false` to require explicit
@@ -80,44 +65,46 @@ export interface GuildSettings {
      */
     autoMigrate?: boolean;
 }
-/** The guild's central configuration file shape (`guild.json`). */
-export interface GuildConfig {
+/**
+ * Guild configuration — V2.
+ *
+ * The rig-centric model: rigs are npm packages; capabilities (tools, engines,
+ * training content) are declared by rigs and discovered dynamically at runtime.
+ * No per-capability registries — `config.rigs` + `node_modules` is the source
+ * of truth. The default model moves into `settings`.
+ *
+ * Breaking change from GuildConfig (V1): drops `tools`, `engines`, `curricula`,
+ * `temperaments`, and top-level `model`. Requires `rigs` (was optional).
+ */
+export interface GuildConfigV2 {
     /** Guild name — used as the guildhall npm package name. */
     name: string;
     /** Installed Nexus framework version. */
     nexus: string;
-    /** Default model for anima sessions. */
-    model: string;
     /** Registered workshops indexed by name. */
     workshops: Record<string, WorkshopEntry>;
     /** Guild roles — structural positions that animas fill. */
     roles: Record<string, RoleDefinition>;
-    /** Tools available to all animas regardless of role. */
+    /** Tool names available to all animas regardless of role. */
     baseTools: string[];
-    /** Active tools indexed by name. */
-    tools: Record<string, ToolEntry>;
-    /** Active engines indexed by name. */
-    engines: Record<string, ToolEntry>;
-    /** Available curricula indexed by name. */
-    curricula: Record<string, TrainingEntry>;
-    /** Available temperaments indexed by name. */
-    temperaments: Record<string, TrainingEntry>;
+    /** Installed rig keys (derived from npm package names). Always present; starts empty. */
+    rigs: string[];
     /** Clockworks configuration — events, standing orders. */
     clockworks?: ClockworksConfig;
     /** Writ types declared by this guild. Built-in types (mandate, summon) are implicit. */
     writTypes?: Record<string, WritTypeDeclaration>;
-    /** Guild-level settings — operational flags and preferences. */
+    /** Guild-level settings — operational flags and preferences. Includes default model. */
     settings?: GuildSettings;
 }
 /**
- * Create the default guild.json content for a new guild.
- * All registries start empty. Roles and baseTools populated by the init sequence.
+ * Create the default guild.json content for a new V2 guild.
+ * All collections start empty. The default model is stored in settings.
  */
-export declare function createInitialGuildConfig(name: string, nexusVersion: string, model: string): GuildConfig;
+export declare function createInitialGuildConfigV2(name: string, nexusVersion: string, model: string): GuildConfigV2;
+/** Read and parse a V2 guild.json from the guild root. */
+export declare function readGuildConfigV2(home: string): GuildConfigV2;
+/** Write a V2 guild.json to the guild root. */
+export declare function writeGuildConfigV2(home: string, config: GuildConfigV2): void;
 /** Resolve the path to guild.json in the guild root. */
 export declare function guildConfigPath(home: string): string;
-/** Read and parse guild.json from the guild root. */
-export declare function readGuildConfig(home: string): GuildConfig;
-/** Write guild.json to the guild root. */
-export declare function writeGuildConfig(home: string, config: GuildConfig): void;
 //# sourceMappingURL=guild-config.d.ts.map

package/dist/guild-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guild-config.d.ts","sourceRoot":"","sources":["../src/guild-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"guild-config.d.ts","sourceRoot":"","sources":["../src/guild-config.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wEAAwE;IACxE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC1C,iDAAiD;IACjD,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACzC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACtC,6DAA6D;IAC7D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yFAAyF;IACzF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,0DAA0D;IAC1D,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAChD,wFAAwF;IACxF,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAU3G;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAG7D;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAG5E;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/guild-config.js

@@ -1,35 +1,32 @@
 import fs from 'node:fs';
 import path from 'node:path';
 /**
- * Create the default guild.json content for a new guild.
- * All registries start empty. Roles and baseTools populated by the init sequence.
+ * Create the default guild.json content for a new V2 guild.
+ * All collections start empty. The default model is stored in settings.
  */
-export function createInitialGuildConfig(name, nexusVersion, model) {
+export function createInitialGuildConfigV2(name, nexusVersion, model) {
     return {
         name,
         nexus: nexusVersion,
-        model,
         workshops: {},
         roles: {},
         baseTools: [],
-        tools: {},
-        engines: {},
-        curricula: {},
-        temperaments: {},
+        rigs: [],
+        settings: { model },
     };
 }
-/** Resolve the path to guild.json in the guild root. */
-export function guildConfigPath(home) {
-    return path.join(home, 'guild.json');
-}
-/** Read and parse guild.json from the guild root. */
-export function readGuildConfig(home) {
+/** Read and parse a V2 guild.json from the guild root. */
+export function readGuildConfigV2(home) {
     const configFile = guildConfigPath(home);
     return JSON.parse(fs.readFileSync(configFile, 'utf-8'));
 }
-/** Write guild.json to the guild root. */
-export function writeGuildConfig(home, config) {
+/** Write a V2 guild.json to the guild root. */
+export function writeGuildConfigV2(home, config) {
     const configFile = guildConfigPath(home);
     fs.writeFileSync(configFile, JSON.stringify(config, null, 2) + '\n');
 }
+/** Resolve the path to guild.json in the guild root. */
+export function guildConfigPath(home) {
+    return path.join(home, 'guild.json');
+}
 //# sourceMappingURL=guild-config.js.map

package/dist/guild-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"guild-config.js","sourceRoot":"","sources":["../src/guild-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAoH7B;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,YAAoB,EAAE,KAAa;IACxF,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,YAAY;QACnB,KAAK;QACL,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,EAAE;QACX,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,EAAE;KACjB,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAgB,CAAC;AACzE,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,MAAmB;IAChE,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACzC,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"guild-config.js","sourceRoot":"","sources":["../src/guild-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAqG7B;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY,EAAE,YAAoB,EAAE,KAAa;IAC1F,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,YAAY;QACnB,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;QACb,IAAI,EAAE,EAAE;QACR,QAAQ,EAAE,EAAE,KAAK,EAAE;KACpB,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAkB,CAAC;AAC3E,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,MAAqB;IACpE,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACzC,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACvE,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AACvC,CAAC"}

package/dist/index.d.ts

@@ -1,27 +1,32 @@
 export declare const VERSION: string;
-export { type ToolContext, type ToolDefinition, tool, isToolDefinition, resolveToolFromExport, resolveAllToolsFromExport, } from './tool.ts';
-export { type GuildEvent, type EngineContext, type EngineDefinition, engine, isClockworkEngine, resolveEngineFromExport, } from './engine.ts';
-export { signalEvent, validateCustomEvent, isFrameworkEvent, readPendingEvents, readEvent, markEventProcessed, recordDispatch, type ListEventsOptions, type DispatchRecord, type ListDispatchesOptions, listEvents, listDispatches, } from './events.ts';
-export { type TickResult, type DispatchSummary, type ClockRunResult, type ClockStartOptions, type ClockStartResult, type ClockStopResult, type ClockStatus, clockTick, clockRun, clockStart, clockStop, clockStatus, desugarOrder, extractParams, } from './clockworks.ts';
-export { type GuildConfig, type RoleDefinition, type ToolEntry, type TrainingEntry, type WorkshopEntry, type EventDeclaration, type StandingOrder, type ClockworksConfig, type WritTypeDeclaration, type GuildSettings, createInitialGuildConfig, guildConfigPath, readGuildConfig, writeGuildConfig, } from './guild-config.ts';
-export { findGuildRoot, nexusDir, booksPath, ledgerPath, worktreesPath, workshopsPath, workshopBarePath, clockPidPath, clockLogPath, } from './nexus-home.ts';
-export { type InstallToolOptions, type InstallResult, type SourceKind, classifySource, installTool, } from './install-tool.ts';
-export { type RemoveToolOptions, type RemoveResult, removeTool, } from './remove-tool.ts';
-export { type InstantiateOptions, type InstantiateResult, instantiate, } from './instantiate.ts';
-export { initGuild } from './init-guild.ts';
-export { type BundleManifest, type BundlePackageEntry, type BundleContentEntry, type BundleMigrationEntry, type InstallBundleOptions, type InstallBundleResult, readBundleManifest, installBundle, isBundleDir, } from './bundle.ts';
-export { type RehydrateResult, rehydrate, } from './rehydrate.ts';
-export { type AddWorkshopOptions, type AddWorkshopResult, type RemoveWorkshopOptions, type WorkshopInfo, type WorkshopDetail, type CreateWorkshopOptions, addWorkshop, removeWorkshop, listWorkshops, showWorkshop, createWorkshop, checkGhAuth, deriveWorkshopName, } from './workshop.ts';
-export { type Precondition, type CommandPrecondition, type CommandOutputPrecondition, type EnvPrecondition, type PreconditionCheckResult, type ToolPreconditionResult, readPreconditions, checkOne, checkPreconditions, checkAllPreconditions, checkToolPreconditions, } from './preconditions.ts';
-export { type WorktreeConfig, type WorktreeResult, setupWorktree, teardownWorktree, listWorktrees, } from './worktree.ts';
-export { type MigrationFile, type MigrationProvenance, type MigrateResult, discoverMigrations, applyMigrations, applyCoreMigrations, ensureBooks, } from './migrate.ts';
-export { type AnimaRecord, type ResolvedTool, type UnavailableTool, type ManifestResult, readAnima, resolveTools, readCodex, readRoleInstructions, assembleSystemPrompt, manifest, } from './manifest.ts';
-export { type SessionProvider, type SessionProviderLaunchOptions, type SessionProviderResult, type SessionLaunchOptions, type SessionResult, type SessionChunk, type WorkspaceContext, type ResolvedWorkspace, type SessionRecord, type SessionSummary, type SessionDetail, type ListSessionsOptions, registerSessionProvider, getSessionProvider, resolveWorkspace, createTempWorktree, removeTempWorktree, launchSession, listSessions, countSessionsForWrit, showSession, } from './session.ts';
-export { type ConversationChunk, type CreateConversationOptions, type CreateConversationResult, type ConversationSummary, type ConversationDetail, type ListConversationsOptions, createConversation, takeTurn, endConversation, nextParticipant, listConversations, showConversation, formatConveneMessage, } from './conversation.ts';
-export { type UpgradePlan, type UpgradeResult, type ApplyUpgradeOptions, type MigrationPlanEntry, type ContentUpdateEntry, type ToolPlanEntry, type StaleAnimaEntry, planUpgrade, applyUpgrade, } from './upgrade.ts';
-export { generateId } from './id.ts';
-export { type AnimaSummary, type AnimaDetail, type ListAnimasOptions, type UpdateAnimaOptions, type AnimaStaleness, type StalenessInfo, resolveAnimaByRole, listAnimas, showAnima, updateAnima, removeAnima, checkAnimaStaleness, checkAllAnimaStaleness, } from './anima.ts';
-export { type ToolSummary, listTools, } from './tool-registry.ts';
-export { type WritRecord, type WritStatus, type CreateWritOptions, type ListWritsOptions, type WritChildSummary, BUILTIN_WRIT_TYPES, validateWritType, createWrit, readWrit, listWrits, activateWrit, completeWrit, adminCompleteWrit, failWrit, cancelWrit, interruptWrit, reopenFailedWrit, rollupParent, getWritChildren, buildProgressAppendix, hydratePromptTemplate, } from './writ.ts';
-export { type AuditEntry, type ListAuditLogOptions, listAuditLog, } from './audit.ts';
+export { type Rig, type BookOptions, isRig, } from './rig.ts';
+export { type Book, type ReadOnlyBook, type BookQuery, type ListOptions, type Pagination, } from './book.ts';
+export { type RigContext, } from './rig-context.ts';
+export { type ToolCaller, type ToolDefinition, tool, isToolDefinition, resolveToolFromExport, resolveAllToolsFromExport, } from './tool.ts';
+export { type ToolContext } from './legacy/1/tool.ts';
+export { findGuildRoot, nexusDir, worktreesPath, workshopsPath, workshopBarePath, clockPidPath, clockLogPath, } from './nexus-home.ts';
+export { type GuildConfigV2, createInitialGuildConfigV2, readGuildConfigV2, writeGuildConfigV2, type RoleDefinition, type WorkshopEntry, type EventDeclaration, type StandingOrder, type ClockworksConfig, type WritTypeDeclaration, type GuildSettings, guildConfigPath, } from './guild-config.ts';
+export { type RigDescriptor, type RigDependency, } from './rig-descriptor.ts';
+export { type GuildEvent, type EngineContext, type EngineDefinition, engine, isClockworkEngine, resolveEngineFromExport, } from './legacy/1/engine.ts';
+export { signalEvent, validateCustomEvent, isFrameworkEvent, readPendingEvents, readEvent, markEventProcessed, recordDispatch, type ListEventsOptions, type DispatchRecord, type ListDispatchesOptions, listEvents, listDispatches, } from './legacy/1/events.ts';
+export { type TickResult, type DispatchSummary, type ClockRunResult, type ClockStartOptions, type ClockStartResult, type ClockStopResult, type ClockStatus, clockTick, clockRun, clockStart, clockStop, clockStatus, desugarOrder, extractParams, } from './legacy/1/clockworks.ts';
+export { type InstallToolOptions, type InstallResult, type SourceKind, classifySource, installTool, } from './legacy/1/install-tool.ts';
+export { type RemoveToolOptions, type RemoveResult, removeTool, } from './legacy/1/remove-tool.ts';
+export { type InstantiateOptions, type InstantiateResult, instantiate, } from './legacy/1/instantiate.ts';
+export { initGuild } from './legacy/1/init-guild.ts';
+export { type BundleManifest, type BundlePackageEntry, type BundleContentEntry, type BundleMigrationEntry, type InstallBundleOptions, type InstallBundleResult, readBundleManifest, installBundle, isBundleDir, } from './legacy/1/bundle.ts';
+export { type RehydrateResult, rehydrate, } from './legacy/1/rehydrate.ts';
+export { type AddWorkshopOptions, type AddWorkshopResult, type RemoveWorkshopOptions, type WorkshopInfo, type WorkshopDetail, type CreateWorkshopOptions, addWorkshop, removeWorkshop, listWorkshops, showWorkshop, createWorkshop, checkGhAuth, deriveWorkshopName, } from './legacy/1/workshop.ts';
+export { type Precondition, type CommandPrecondition, type CommandOutputPrecondition, type EnvPrecondition, type PreconditionCheckResult, type ToolPreconditionResult, readPreconditions, checkOne, checkPreconditions, checkAllPreconditions, checkToolPreconditions, } from './legacy/1/preconditions.ts';
+export { type WorktreeConfig, type WorktreeResult, setupWorktree, teardownWorktree, listWorktrees, } from './legacy/1/worktree.ts';
+export { type MigrationFile, type MigrationProvenance, type MigrateResult, discoverMigrations, applyMigrations, applyCoreMigrations, ensureBooks, } from './legacy/1/migrate.ts';
+export { type AnimaRecord, type ResolvedTool, type UnavailableTool, type ManifestResult, readAnima, resolveTools, readCodex, readRoleInstructions, assembleSystemPrompt, manifest, } from './legacy/1/manifest.ts';
+export { type SessionProvider, type SessionProviderLaunchOptions, type SessionProviderResult, type SessionLaunchOptions, type SessionResult, type SessionChunk, type WorkspaceContext, type ResolvedWorkspace, type SessionRecord, type SessionSummary, type SessionDetail, type ListSessionsOptions, registerSessionProvider, getSessionProvider, resolveWorkspace, createTempWorktree, removeTempWorktree, launchSession, listSessions, countSessionsForWrit, showSession, } from './legacy/1/session.ts';
+export { type ConversationChunk, type CreateConversationOptions, type CreateConversationResult, type ConversationSummary, type ConversationDetail, type ListConversationsOptions, createConversation, takeTurn, endConversation, nextParticipant, listConversations, showConversation, formatConveneMessage, } from './legacy/1/conversation.ts';
+export { type UpgradePlan, type UpgradeResult, type ApplyUpgradeOptions, type MigrationPlanEntry, type ContentUpdateEntry, type ToolPlanEntry, type StaleAnimaEntry, planUpgrade, applyUpgrade, } from './legacy/1/upgrade.ts';
+export { generateId } from './legacy/1/id.ts';
+export { type AnimaSummary, type AnimaDetail, type ListAnimasOptions, type UpdateAnimaOptions, type AnimaStaleness, type StalenessInfo, resolveAnimaByRole, listAnimas, showAnima, updateAnima, removeAnima, checkAnimaStaleness, checkAllAnimaStaleness, } from './legacy/1/anima.ts';
+export { type ToolSummary, listTools, } from './legacy/1/tool-registry.ts';
+export { type WritRecord, type WritStatus, type CreateWritOptions, type ListWritsOptions, type WritChildSummary, BUILTIN_WRIT_TYPES, validateWritType, createWrit, readWrit, listWrits, activateWrit, completeWrit, adminCompleteWrit, failWrit, cancelWrit, interruptWrit, reopenFailedWrit, rollupParent, getWritChildren, buildProgressAppendix, hydratePromptTemplate, } from './legacy/1/writ.ts';
+export { type AuditEntry, type ListAuditLogOptions, listAuditLog, } from './legacy/1/audit.ts';
 //# sourceMappingURL=index.d.ts.map