@mulmoclaude/core 3.0.0 → 3.1.0

package/dist/collection/server/schemaDocs.d.ts

@@ -1,3 +1,7 @@
+export type AuthoringVariant = "staged" | "direct";
+/** Strip the fences and drop whichever variant's body doesn't apply. Runs
+ *  BEFORE section parsing, so a variant may contain headings or code fences. */
+export declare function applyAuthoringVariant(doc: string, variant: AuthoringVariant): string;
 /** A doc at/below this size is returned whole — sectioning something the
  *  agent can read in one gulp only costs round-trips. This is also what
  *  keeps short user-authored workspace copies (config/helps) verbatim. */
@@ -18,4 +22,4 @@ export declare const SCHEMA_DOCS_RESULT_BUDGET = 36000;
  *  up outside any single piece's budget, and the ceiling must hold no
  *  matter what shape of document arrives. Only the explicit \`"all"\`
  *  opt-in and the small-doc verbatim path may exceed it. */
-export declare function renderSchemaDocs(doc: string, topic?: string): string;
+export declare function renderSchemaDocs(rawDoc: string, topic?: string, variant?: AuthoringVariant): string;

package/dist/collection-watchers/config.d.ts

@@ -14,8 +14,17 @@ export interface CollectionNotificationAdapter {
     pluginPkg: string;
     /** Map a record's completion priority onto the host's bell severity. */
     priorityToSeverity: (priority: CompletionPriority) => NotifierSeverity;
-    /** Build the in-app deep-link the bell row routes to on click. */
-    buildNavigateTarget: (slug: string, itemId: string) => string;
+    /** Build the in-app deep-link the bell row routes to on click.
+     *
+     *  `root` is the absolute project/workspace root the record lives under, and
+     *  is present ONLY when the engine call carried an explicit `workspaceRoot`
+     *  — so a single-workspace host never sees it and its targets are unchanged.
+     *  A multi-root host uses it to deep-link into the RIGHT project: two roots
+     *  can own the same slug, and a slug-only target would open whichever project
+     *  happens to be selected. The URL shape is entirely the host's — the engine
+     *  only guarantees to pass the root through. Resolve it to an OPAQUE project
+     *  id in the target rather than embedding the absolute path. */
+    buildNavigateTarget: (slug: string, itemId: string, root?: string) => string;
     /** Wrap the reconciler's internal key + priority into the host's
      *  `pluginData` shape. Stored verbatim on the entry; recovered via
      *  `readEntry`. */
@@ -25,6 +34,10 @@ export interface CollectionNotificationAdapter {
         itemId: string;
         priority: CompletionPriority;
         navigateTarget: string;
+        /** The record's root, present only under an explicit-root call (see
+         *  `buildNavigateTarget`). `legacyId` already encodes it; this is the
+         *  parsed form so a host doesn't have to decode the key. */
+        root?: string | undefined;
     }) => unknown;
     /** Recognise a bell entry produced by this reconciler and recover its
      *  internal key + stored priority. Returns null for entries that didn't