@shardworks/nexus-core 0.1.99 → 0.1.101

package/dist/id.js

@@ -0,0 +1,19 @@
+import crypto from 'node:crypto';
+/**
+ * Generate a sortable, prefixed ID.
+ *
+ * Format: `{prefix}-{base36_timestamp}-{hex_random}`
+ *
+ * The timestamp component (Date.now() in base36) gives lexicographic sort
+ * order by creation time. The random suffix prevents collisions without
+ * coordination.
+ *
+ * @param prefix     Short, type-identifying string (e.g. `w`, `ses`, `turn`)
+ * @param randomByteCount  Number of random bytes; produces 2× hex digits (default 6 → 12 hex chars)
+ */
+export function generateId(prefix, randomByteCount = 6) {
+    const ts = Date.now().toString(36);
+    const rand = crypto.randomBytes(randomByteCount).toString('hex');
+    return `${prefix}-${ts}-${rand}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../src/id.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,kBAA0B,CAAC;IACpE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjE,OAAO,GAAG,MAAM,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;AACnC,CAAC"}

package/dist/index.d.ts

@@ -1,32 +1,8 @@
 export declare const VERSION: string;
-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';
+export { type Kit, type Apparatus, type Plugin, type LoadedKit, type LoadedApparatus, type LoadedPlugin, type StartupContext, isKit, isApparatus, isLoadedKit, isLoadedApparatus, } from './plugin.ts';
+export { type Guild, guild, setGuild, clearGuild, } from './guild.ts';
+export { findGuildRoot, nexusDir, worktreesPath, clockPidPath, clockLogPath, } from './nexus-home.ts';
+export { derivePluginId, readGuildPackageJson, resolvePackageNameForPluginId, resolveGuildPackageEntry, } from './resolve-package.ts';
+export { type GuildConfig, createInitialGuildConfig, readGuildConfig, writeGuildConfig, type EventDeclaration, type StandingOrder, type ClockworksConfig, type GuildSettings, guildConfigPath, } from './guild-config.ts';
+export { generateId } from './id.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,OAAO,EAAE,MAAqB,CAAC;AAI5C,OAAO,EAEL,KAAK,GAAG,EACR,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,EACL,WAAW,EACX,WAAW,EACX,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,KAAK,KAAK,EACV,KAAK,EACL,QAAQ,EACR,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,WAAW,EAChB,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -4,36 +4,11 @@ const _require = createRequire(import.meta.url);
 const _pkg = _require('../package.json');
 export const VERSION = _pkg.version;
 // ── Promoted modules — canonical source lives here at top-level ────────
-export { isRig, } from "./rig.js";
-export {} from "./book.js";
-export {} from "./rig-context.js";
-export { tool, isToolDefinition, resolveToolFromExport, resolveAllToolsFromExport, } from "./tool.js";
-// ToolContext is a backward-compat alias for RigContext — lives in legacy/1.
-export {} from "./legacy/1/tool.js";
-export { findGuildRoot, nexusDir, worktreesPath, workshopsPath, workshopBarePath, clockPidPath, clockLogPath, } from "./nexus-home.js";
-export { createInitialGuildConfigV2, readGuildConfigV2, writeGuildConfigV2, guildConfigPath, } from "./guild-config.js";
-export {} from "./rig-descriptor.js";
-// ── Legacy modules — not yet promoted, still live in legacy/1 ─────────
-export { engine, isClockworkEngine, resolveEngineFromExport, } from "./legacy/1/engine.js";
-export { signalEvent, validateCustomEvent, isFrameworkEvent, readPendingEvents, readEvent, markEventProcessed, recordDispatch, listEvents, listDispatches, } from "./legacy/1/events.js";
-export { clockTick, clockRun, clockStart, clockStop, clockStatus, desugarOrder, extractParams, } from "./legacy/1/clockworks.js";
-export { classifySource, installTool, } from "./legacy/1/install-tool.js";
-export { removeTool, } from "./legacy/1/remove-tool.js";
-export { instantiate, } from "./legacy/1/instantiate.js";
-export { initGuild } from "./legacy/1/init-guild.js";
-export { readBundleManifest, installBundle, isBundleDir, } from "./legacy/1/bundle.js";
-export { rehydrate, } from "./legacy/1/rehydrate.js";
-export { addWorkshop, removeWorkshop, listWorkshops, showWorkshop, createWorkshop, checkGhAuth, deriveWorkshopName, } from "./legacy/1/workshop.js";
-export { readPreconditions, checkOne, checkPreconditions, checkAllPreconditions, checkToolPreconditions, } from "./legacy/1/preconditions.js";
-export { setupWorktree, teardownWorktree, listWorktrees, } from "./legacy/1/worktree.js";
-export { discoverMigrations, applyMigrations, applyCoreMigrations, ensureBooks, } from "./legacy/1/migrate.js";
-export { readAnima, resolveTools, readCodex, readRoleInstructions, assembleSystemPrompt, manifest, } from "./legacy/1/manifest.js";
-export { registerSessionProvider, getSessionProvider, resolveWorkspace, createTempWorktree, removeTempWorktree, launchSession, listSessions, countSessionsForWrit, showSession, } from "./legacy/1/session.js";
-export { createConversation, takeTurn, endConversation, nextParticipant, listConversations, showConversation, formatConveneMessage, } from "./legacy/1/conversation.js";
-export { planUpgrade, applyUpgrade, } from "./legacy/1/upgrade.js";
-export { generateId } from "./legacy/1/id.js";
-export { resolveAnimaByRole, listAnimas, showAnima, updateAnima, removeAnima, checkAnimaStaleness, checkAllAnimaStaleness, } from "./legacy/1/anima.js";
-export { listTools, } from "./legacy/1/tool-registry.js";
-export { BUILTIN_WRIT_TYPES, validateWritType, createWrit, readWrit, listWrits, activateWrit, completeWrit, adminCompleteWrit, failWrit, cancelWrit, interruptWrit, reopenFailedWrit, rollupParent, getWritChildren, buildProgressAppendix, hydratePromptTemplate, } from "./legacy/1/writ.js";
-export { listAuditLog, } from "./legacy/1/audit.js";
+export { isKit, isApparatus, isLoadedKit, isLoadedApparatus, } from "./plugin.js";
+// Guild — the process-level singleton for accessing guild infrastructure.
+export { guild, setGuild, clearGuild, } from "./guild.js";
+export { findGuildRoot, nexusDir, worktreesPath, clockPidPath, clockLogPath, } from "./nexus-home.js";
+export { derivePluginId, readGuildPackageJson, resolvePackageNameForPluginId, resolveGuildPackageEntry, } from "./resolve-package.js";
+export { createInitialGuildConfig, readGuildConfig, writeGuildConfig, guildConfigPath, } from "./guild-config.js";
+export { generateId } from "./id.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AACzC,MAAM,CAAC,MAAM,OAAO,GAAW,IAAI,CAAC,OAAO,CAAC;AAE5C,0EAA0E;AAE1E,OAAO,EASL,KAAK,EACL,WAAW,EACX,WAAW,EACX,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,0EAA0E;AAC1E,OAAO,EAEL,KAAK,EACL,QAAQ,EACR,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,wBAAwB,EACxB,eAAe,EACf,gBAAgB,EAKhB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/nexus-home.d.ts

@@ -12,10 +12,6 @@ export declare function findGuildRoot(startDir?: string): string;
 export declare function nexusDir(home: string): string;
 /** Path to the top-level worktrees directory (for writ worktrees). */
 export declare function worktreesPath(home: string): string;
-/** Path to the workshops directory (contains bare clones). */
-export declare function workshopsPath(home: string): string;
-/** Path to a specific workshop's bare clone. */
-export declare function workshopBarePath(home: string, name: string): string;
 /** Path to the clockworks daemon PID file. */
 export declare function clockPidPath(home: string): string;
 /** Path to the clockworks daemon log file. */

package/dist/nexus-home.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nexus-home.d.ts","sourceRoot":"","sources":["../src/nexus-home.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAYvD;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD"}
+{"version":3,"file":"nexus-home.d.ts","sourceRoot":"","sources":["../src/nexus-home.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAYvD;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/nexus-home.js

@@ -16,7 +16,7 @@ export function findGuildRoot(startDir) {
             return dir;
         const parent = path.dirname(dir);
         if (parent === dir) {
-            throw new Error('Not inside a guild. Run `nexus init` to create one, or use --guild-root.');
+            throw new Error('Not inside a guild. Run `nsg init` to create one, or use --guild-root.');
         }
         dir = parent;
     }
@@ -29,14 +29,6 @@ export function nexusDir(home) {
 export function worktreesPath(home) {
     return path.join(home, '.nexus', 'worktrees');
 }
-/** Path to the workshops directory (contains bare clones). */
-export function workshopsPath(home) {
-    return path.join(home, '.nexus', 'workshops');
-}
-/** Path to a specific workshop's bare clone. */
-export function workshopBarePath(home, name) {
-    return path.join(home, '.nexus', 'workshops', `${name}.git`);
-}
 /** Path to the clockworks daemon PID file. */
 export function clockPidPath(home) {
     return path.join(home, '.nexus', 'clock.pid');

package/dist/nexus-home.js.map

@@ -1 +1 @@
-{"version":3,"file":"nexus-home.js","sourceRoot":"","sources":["../src/nexus-home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,QAAiB;IAC7C,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAClD,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,IAAY;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"nexus-home.js","sourceRoot":"","sources":["../src/nexus-home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,QAAiB;IAC7C,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAClD,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAC;QACJ,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Plugin system — core types for the Kit/Apparatus model.
+ *
+ * Plugins come in two kinds:
+ * - Kit:       passive package contributing capabilities to consuming apparatuses.
+ *              No lifecycle, no running state. Read at load time.
+ * - Apparatus: package contributing persistent running infrastructure.
+ *              Has a start/stop lifecycle. Receives StartupContext at start.
+ *
+ * See: docs/architecture/plugins.md
+ */
+/** A kit as tracked by the Arbor runtime. */
+export interface LoadedKit {
+    readonly packageName: string;
+    readonly id: string;
+    readonly version: string;
+    readonly kit: Kit;
+}
+/** An apparatus as tracked by the Arbor runtime. */
+export interface LoadedApparatus {
+    readonly packageName: string;
+    readonly id: string;
+    readonly version: string;
+    readonly apparatus: Apparatus;
+}
+/** Union of loaded kit and loaded apparatus. */
+export type LoadedPlugin = LoadedKit | LoadedApparatus;
+/**
+ * Startup context passed to an apparatus's start(ctx).
+ *
+ * Provides lifecycle-event subscription — the only capability that is
+ * meaningful only during startup. All other guild access (apparatus APIs,
+ * config, home path, loaded plugins) goes through the `guild()` singleton,
+ * which is available during start() and in all handlers.
+ *
+ * See: docs/architecture/plugins.md
+ */
+export interface StartupContext {
+    /** Subscribe to a guild lifecycle event. Handlers may be async; run sequentially. */
+    on(event: string, handler: (...args: unknown[]) => void | Promise<void>): void;
+}
+/**
+ * A kit — passive package contributing capabilities to consuming apparatuses.
+ * Open record: contribution fields (engines, relays, tools, etc.) are defined
+ * by the apparatus packages that consume them. `requires` and `recommends` are
+ * the only framework-level fields.
+ *
+ * `requires`: apparatus names whose runtime APIs this kit's contributions depend
+ *   on at handler invocation time. Hard startup validation failure if a declared
+ *   apparatus is not installed.
+ *
+ * `recommends`: advisory apparatus names — generates startup warnings when
+ *   expected apparatuses are absent. Not enforced.
+ */
+export type Kit = {
+    requires?: string[];
+    recommends?: string[];
+    [key: string]: unknown;
+};
+/**
+ * An apparatus — package contributing persistent running infrastructure.
+ * Has a start/stop lifecycle. Receives StartupContext at start.
+ *
+ * `requires`: apparatus names that must be started before this apparatus's
+ *   start() runs. Determines start ordering. Hard startup validation failure
+ *   if a declared apparatus is not installed.
+ *
+ * `recommends`: advisory apparatus names — generates startup warnings when
+ *   expected apparatuses are absent. Not enforced — the apparatus starts
+ *   regardless. Use for soft dependencies needed by optional API methods
+ *   (e.g. The Animator recommends The Loom for summon(), but animate()
+ *   works without it).
+ *
+ * `provides`: the runtime API object this apparatus exposes to other plugins.
+ *   Retrieved via guild().apparatus<T>(name). Created at manifest-definition time,
+ *   populated during start.
+ *
+ * `supportKit`: kit contributions this apparatus exposes to consuming apparatuses.
+ *   Treated identically to standalone kit contributions by consumers.
+ *
+ * `consumes`: kit contribution field types this apparatus scans for and registers.
+ *   Enables framework startup warnings when kits contribute types with no consumer.
+ */
+export type Apparatus = {
+    requires?: string[];
+    recommends?: string[];
+    provides?: unknown;
+    start: (ctx: StartupContext) => void | Promise<void>;
+    stop?: () => void | Promise<void>;
+    supportKit?: Kit;
+    consumes?: string[];
+};
+/**
+ * The discriminated union plugin type. A plugin is either a kit or an apparatus.
+ * The plugin name is always inferred from the npm package name at load time —
+ * it is never declared in the manifest.
+ */
+export type Plugin = {
+    kit: Kit;
+} | {
+    apparatus: Apparatus;
+};
+/** Type guard: is this value a kit plugin export? */
+export declare function isKit(obj: unknown): obj is {
+    kit: Kit;
+};
+/** Type guard: is this value an apparatus plugin export? */
+export declare function isApparatus(obj: unknown): obj is {
+    apparatus: Apparatus;
+};
+/** Type guard: narrows a LoadedPlugin to LoadedKit. */
+export declare function isLoadedKit(p: LoadedPlugin): p is LoadedKit;
+/** Type guard: narrows a LoadedPlugin to LoadedApparatus. */
+export declare function isLoadedApparatus(p: LoadedPlugin): p is LoadedApparatus;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,EAAE,EAAW,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAM,MAAM,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAU,GAAG,CAAA;CAC1B;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,EAAE,EAAW,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAM,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAI,SAAS,CAAA;CAChC;AAED,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,eAAe,CAAA;AAItD;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,qFAAqF;IACrF,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC/E;AAID;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,GAAG,GAAG;IAChB,QAAQ,CAAC,EAAI,MAAM,EAAE,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AAID;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,EAAK,MAAM,EAAE,CAAA;IACtB,UAAU,CAAC,EAAG,MAAM,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAK,OAAO,CAAA;IACrB,KAAK,EAAS,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3D,IAAI,CAAC,EAAS,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,UAAU,CAAC,EAAG,GAAG,CAAA;IACjB,QAAQ,CAAC,EAAK,MAAM,EAAE,CAAA;CACvB,CAAA;AAID;;;;GAIG;AACH,MAAM,MAAM,MAAM,GACd;IAAE,GAAG,EAAQ,GAAG,CAAA;CAAE,GAClB;IAAE,SAAS,EAAE,SAAS,CAAA;CAAE,CAAA;AAI5B,qDAAqD;AACrD,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,CASvD;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI;IAAE,SAAS,EAAE,SAAS,CAAA;CAAE,CAWzE;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,IAAI,SAAS,CAE3D;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,IAAI,eAAe,CAEvE"}

package/dist/plugin.js

@@ -0,0 +1,39 @@
+/**
+ * Plugin system — core types for the Kit/Apparatus model.
+ *
+ * Plugins come in two kinds:
+ * - Kit:       passive package contributing capabilities to consuming apparatuses.
+ *              No lifecycle, no running state. Read at load time.
+ * - Apparatus: package contributing persistent running infrastructure.
+ *              Has a start/stop lifecycle. Receives StartupContext at start.
+ *
+ * See: docs/architecture/plugins.md
+ */
+// ── Type guards ────────────────────────────────────────────────────────
+/** Type guard: is this value a kit plugin export? */
+export function isKit(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'kit' in obj &&
+        typeof obj.kit === 'object' &&
+        obj.kit !== null &&
+        !Array.isArray(obj.kit));
+}
+/** Type guard: is this value an apparatus plugin export? */
+export function isApparatus(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        'apparatus' in obj &&
+        typeof obj.apparatus === 'object' &&
+        obj.apparatus !== null &&
+        typeof (obj.apparatus.start) === 'function');
+}
+/** Type guard: narrows a LoadedPlugin to LoadedKit. */
+export function isLoadedKit(p) {
+    return 'kit' in p;
+}
+/** Type guard: narrows a LoadedPlugin to LoadedApparatus. */
+export function isLoadedApparatus(p) {
+    return 'apparatus' in p;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA4GH,0EAA0E;AAE1E,qDAAqD;AACrD,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,KAAK,IAAI,GAAG;QACZ,OAAQ,GAAwB,CAAC,GAAG,KAAK,QAAQ;QAChD,GAAwB,CAAC,GAAG,KAAK,IAAI;QACtC,CAAC,KAAK,CAAC,OAAO,CAAE,GAAwB,CAAC,GAAG,CAAC,CAC9C,CAAA;AACH,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,WAAW,IAAI,GAAG;QAClB,OAAQ,GAA8B,CAAC,SAAS,KAAK,QAAQ;QAC5D,GAA8B,CAAC,SAAS,KAAK,IAAI;QAClD,OAAO,CACJ,GAA8C,CAAC,SAAS,CAAC,KAAK,CAChE,KAAK,UAAU,CACjB,CAAA;AACH,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,WAAW,CAAC,CAAe;IACzC,OAAO,KAAK,IAAI,CAAC,CAAA;AACnB,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,iBAAiB,CAAC,CAAe;IAC/C,OAAO,WAAW,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/resolve-package.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Package resolution utilities for guild-installed npm packages.
+ *
+ * Resolves entry points from the guild's node_modules by reading package.json
+ * exports maps directly. Needed because guild plugins are ESM-only packages
+ * and createRequire() can't resolve their exports.
+ *
+ * Also owns:
+ * - derivePluginId — canonical npm package name → plugin id derivation
+ */
+/**
+ * Derive the guild-facing plugin id from an npm package name.
+ *
+ * Convention:
+ * - `@shardworks/nexus-ledger`      → `nexus-ledger`   (official scope stripped)
+ * - `@shardworks/books-apparatus`   → `books`           (descriptor suffix stripped)
+ * - `@acme/my-plugin`               → `acme/my-plugin`  (third-party: drop @ only)
+ * - `my-relay-kit`                  → `my-relay`        (descriptor suffix stripped)
+ * - `my-plugin`                     → `my-plugin`       (unscoped: unchanged)
+ *
+ * The `@shardworks` scope is the official Nexus namespace — its plugins are
+ * referenced by bare name in guild.json, CLI commands, and config keys.
+ * Third-party scoped packages retain the scope as a prefix (without @) to
+ * prevent collisions between `@acme/foo` and `@other/foo`.
+ *
+ * Descriptor suffixes (`-plugin`, `-apparatus`, `-kit`) are stripped after
+ * scope resolution so that package naming conventions don't leak into ids.
+ */
+export declare function derivePluginId(packageName: string): string;
+/**
+ * Read a package.json from the guild's node_modules.
+ * Returns the parsed JSON and version. Falls back gracefully.
+ */
+export declare function readGuildPackageJson(guildRoot: string, pkgName: string): {
+    version: string;
+    pkgJson: Record<string, unknown> | null;
+};
+/**
+ * Resolve the npm package name for a plugin id by consulting the guild's root package.json.
+ *
+ * Scans all dependencies and runs `derivePluginId()` on each to find the
+ * package whose derived id matches. This correctly handles descriptor
+ * suffixes (-kit, -apparatus, -plugin) that derivePluginId strips.
+ *
+ * When multiple packages derive to the same id (unlikely but possible),
+ * prefers @shardworks-scoped packages over third-party ones.
+ *
+ * Returns null if no matching dependency is found.
+ */
+export declare function resolvePackageNameForPluginId(guildRoot: string, pluginId: string): string | null;
+/**
+ * Resolve the entry point for a guild-installed package.
+ *
+ * Reads the package's exports map to find the ESM entry point.
+ * Returns an absolute path suitable for dynamic import().
+ */
+export declare function resolveGuildPackageEntry(guildRoot: string, pkgName: string): string;
+//# sourceMappingURL=resolve-package.d.ts.map

package/dist/resolve-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-package.d.ts","sourceRoot":"","sources":["../src/resolve-package.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAY1D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAAE,CAQ9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBhG;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAmBnF"}

package/dist/resolve-package.js

@@ -0,0 +1,123 @@
+/**
+ * Package resolution utilities for guild-installed npm packages.
+ *
+ * Resolves entry points from the guild's node_modules by reading package.json
+ * exports maps directly. Needed because guild plugins are ESM-only packages
+ * and createRequire() can't resolve their exports.
+ *
+ * Also owns:
+ * - derivePluginId — canonical npm package name → plugin id derivation
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Derive the guild-facing plugin id from an npm package name.
+ *
+ * Convention:
+ * - `@shardworks/nexus-ledger`      → `nexus-ledger`   (official scope stripped)
+ * - `@shardworks/books-apparatus`   → `books`           (descriptor suffix stripped)
+ * - `@acme/my-plugin`               → `acme/my-plugin`  (third-party: drop @ only)
+ * - `my-relay-kit`                  → `my-relay`        (descriptor suffix stripped)
+ * - `my-plugin`                     → `my-plugin`       (unscoped: unchanged)
+ *
+ * The `@shardworks` scope is the official Nexus namespace — its plugins are
+ * referenced by bare name in guild.json, CLI commands, and config keys.
+ * Third-party scoped packages retain the scope as a prefix (without @) to
+ * prevent collisions between `@acme/foo` and `@other/foo`.
+ *
+ * Descriptor suffixes (`-plugin`, `-apparatus`, `-kit`) are stripped after
+ * scope resolution so that package naming conventions don't leak into ids.
+ */
+export function derivePluginId(packageName) {
+    // Step 1: strip scope
+    let name;
+    if (packageName.startsWith('@shardworks/')) {
+        name = packageName.slice('@shardworks/'.length);
+    }
+    else if (packageName.startsWith('@')) {
+        name = packageName.slice(1); // @acme/foo → acme/foo
+    }
+    else {
+        name = packageName;
+    }
+    // Step 2: strip descriptor suffix
+    return name.replace(/-(plugin|apparatus|kit)$/, '');
+}
+/**
+ * Read a package.json from the guild's node_modules.
+ * Returns the parsed JSON and version. Falls back gracefully.
+ */
+export function readGuildPackageJson(guildRoot, pkgName) {
+    const pkgJsonPath = path.join(guildRoot, 'node_modules', pkgName, 'package.json');
+    try {
+        const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8'));
+        return { version: pkgJson.version ?? 'unknown', pkgJson };
+    }
+    catch {
+        return { version: 'unknown', pkgJson: null };
+    }
+}
+/**
+ * Resolve the npm package name for a plugin id by consulting the guild's root package.json.
+ *
+ * Scans all dependencies and runs `derivePluginId()` on each to find the
+ * package whose derived id matches. This correctly handles descriptor
+ * suffixes (-kit, -apparatus, -plugin) that derivePluginId strips.
+ *
+ * When multiple packages derive to the same id (unlikely but possible),
+ * prefers @shardworks-scoped packages over third-party ones.
+ *
+ * Returns null if no matching dependency is found.
+ */
+export function resolvePackageNameForPluginId(guildRoot, pluginId) {
+    const pkgPath = path.join(guildRoot, 'package.json');
+    let deps = [];
+    try {
+        const pkgJson = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        deps = Object.keys(pkgJson.dependencies ?? {});
+    }
+    catch {
+        return null;
+    }
+    let match = null;
+    for (const dep of deps) {
+        if (derivePluginId(dep) === pluginId) {
+            // Prefer @shardworks-scoped packages (official namespace)
+            if (dep.startsWith('@shardworks/'))
+                return dep;
+            // Keep the first match as fallback
+            if (!match)
+                match = dep;
+        }
+    }
+    return match;
+}
+/**
+ * Resolve the entry point for a guild-installed package.
+ *
+ * Reads the package's exports map to find the ESM entry point.
+ * Returns an absolute path suitable for dynamic import().
+ */
+export function resolveGuildPackageEntry(guildRoot, pkgName) {
+    const pkgDir = path.join(guildRoot, 'node_modules', pkgName);
+    const { pkgJson } = readGuildPackageJson(guildRoot, pkgName);
+    if (pkgJson) {
+        const exports = pkgJson.exports;
+        if (exports) {
+            if (typeof exports === 'string')
+                return path.join(pkgDir, exports);
+            const main = exports['.'];
+            if (typeof main === 'string')
+                return path.join(pkgDir, main);
+            if (main && typeof main === 'object') {
+                const importPath = main.import;
+                if (importPath)
+                    return path.join(pkgDir, importPath);
+            }
+        }
+        if (pkgJson.main)
+            return path.join(pkgDir, pkgJson.main);
+    }
+    return path.join(pkgDir, 'index.js');
+}
+//# sourceMappingURL=resolve-package.js.map

package/dist/resolve-package.js.map

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

package/package.json

@@ -1,35 +1,26 @@
 {
   "name": "@shardworks/nexus-core",
-  "version": "0.1.99",
+  "version": "0.1.101",
   "license": "ISC",
   "repository": {
     "type": "git",
     "url": "https://github.com/shardworks/nexus",
-    "directory": "packages/core"
+    "directory": "packages/framework/core"
   },
-  "description": "Nexus core library — shared infrastructure for the guild system",
+  "description": "Nexus core — public SDK surface: guild singleton, plugin/kit/apparatus types, guild config, package resolution",
   "type": "module",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    },
-    "./legacy/1": {
-      "types": "./dist/legacy/1/index.d.ts",
-      "import": "./dist/legacy/1/index.js"
     }
   },
-  "dependencies": {
-    "better-sqlite3": "12.8.0",
-    "zod": "4.3.6"
-  },
+  "dependencies": {},
   "devDependencies": {
-    "@types/better-sqlite3": "7.6.13",
     "@types/node": "25.5.0"
   },
   "files": [
-    "dist",
-    "migrations"
+    "dist"
   ],
   "scripts": {
     "build": "tsc",