@creator-notes/cnotes 0.33.0 → 0.35.0

package/dist/lib/mention-lint.js

@@ -83,6 +83,181 @@ export function lintMentionMarkdown(markdown, allowAtKey) {
     }
     return issues;
 }
+/** Parse a wiki-link body (`[[inner]]`): target + optional type, either order
+ *  (`[[blocks::DEC-3]]` and `[[DEC-3::blocks]]` both bind — mirror of
+ *  lib/tiptap/markdown-extensions.ts). Returns null for ordinary wiki prose. */
+function parseWikiInner(inner) {
+    const noAlias = inner.split("|")[0].trim();
+    const parts = noAlias.split("::").map((s) => s.trim());
+    const isTarget = (s) => DISPLAY_ID_RE.test(s) || AT_KEY_RE.test(s);
+    if (parts.length === 1) {
+        return isTarget(parts[0]) ? { target: parts[0], type: null } : null;
+    }
+    if (parts.length === 2) {
+        if (isTarget(parts[1]))
+            return { target: parts[1], type: parts[0].toLowerCase() || null };
+        if (isTarget(parts[0]))
+            return { target: parts[0], type: parts[1].toLowerCase() || null };
+    }
+    return null;
+}
+const WIKI_RE = /\[\[([^\]]+)\]\]/g;
+/** Collect every mention on one line, both `[T](relationship:t)` and `[[T]]`. */
+function findMentions(line) {
+    const found = [];
+    for (const m of line.matchAll(MENTION_RE)) {
+        const linkText = m[1];
+        found.push({
+            raw: m[0],
+            index: m.index ?? 0,
+            effectiveType: m[2].trim().toLowerCase(),
+            retype: (t) => `[${linkText}](relationship:${t})`,
+        });
+    }
+    for (const m of line.matchAll(WIKI_RE)) {
+        const parsed = parseWikiInner(m[1]);
+        if (!parsed)
+            continue;
+        found.push({
+            raw: m[0],
+            index: m.index ?? 0,
+            effectiveType: parsed.type ?? "references",
+            retype: (t) => `[[${t}::${parsed.target}]]`,
+        });
+    }
+    return found.sort((a, b) => a.index - b.index);
+}
+/** Prose forms for each type: the label and the de-hyphenated slug. The
+ *  `references` type is excluded — it's what generic mentions already are. */
+function buildTypePhrases(types) {
+    const phrases = [];
+    const seen = new Set();
+    for (const t of types) {
+        const value = t.value.trim().toLowerCase();
+        if (!value || value === "references")
+            continue;
+        for (const phrase of new Set([
+            t.label.trim().toLowerCase(),
+            value.replace(/-/g, " "),
+        ])) {
+            if (!phrase || seen.has(phrase))
+                continue;
+            seen.add(phrase);
+            phrases.push({ phrase, value, label: t.label });
+        }
+    }
+    // Longest first so "depends on" wins over a hypothetical "depends".
+    return phrases.sort((a, b) => b.phrase.length - a.phrase.length);
+}
+/** Strip list/quote/heading markers and opening emphasis from a line start. */
+function stripLineDecoration(line) {
+    return line
+        .replace(/^[\s>]*/, "")
+        .replace(/^(?:[-*+]\s+|\d+[.)]\s+|#{1,6}\s+)/, "")
+        .replace(/^[*_]{1,3}/, "");
+}
+/**
+ * Lint one markdown body for relationship verbs narrated in prose next to a
+ * GENERIC mention (`relationship:references` or untyped `[[NOTE-12]]`).
+ * Fires when a line STARTS with a type's verb, or when the verb sits
+ * immediately before the mention. Mentions that already carry a specific type
+ * are never flagged, even if the prose disagrees — that's a judgment call, not
+ * a lint. Fenced code blocks are skipped.
+ *
+ * @param types workspace relationship types (fetch via
+ *              `fetchRelationshipTypeOptions`); pass [] to disable.
+ */
+export function lintNarratedVerbMentions(markdown, types) {
+    const typePhrases = buildTypePhrases(types);
+    if (typePhrases.length === 0)
+        return [];
+    const warnings = [];
+    let inFence = false;
+    markdown.split(/\r?\n/).forEach((line, i) => {
+        if (/^\s*(```|~~~)/.test(line)) {
+            inFence = !inFence;
+            return;
+        }
+        if (inFence)
+            return;
+        const generics = findMentions(line).filter((m) => m.effectiveType === "references");
+        if (generics.length === 0)
+            return;
+        // Rule B: verb immediately before a generic mention ("this blocks [[X]]").
+        const claimed = new Set();
+        for (const mention of generics) {
+            const before = line.slice(0, mention.index).trimEnd().toLowerCase();
+            for (const p of typePhrases) {
+                if (!before.endsWith(p.phrase))
+                    continue;
+                const pre = before.slice(0, before.length - p.phrase.length);
+                if (pre !== "" && !/[^a-z0-9]$/.test(pre))
+                    continue;
+                const start = line.toLowerCase().lastIndexOf(p.phrase, mention.index);
+                warnings.push(makeWarning(i + 1, line.slice(start, start + p.phrase.length), p, mention));
+                claimed.add(mention);
+                break;
+            }
+        }
+        // Rule A: line leads with a verb, generic mention anywhere after it
+        // ("Blocks clean filmstrip of [[X]]."). First unclaimed mention gets it.
+        const stripped = stripLineDecoration(line);
+        const strippedLower = stripped.toLowerCase();
+        const target = generics.find((m) => !claimed.has(m));
+        if (!target)
+            return;
+        for (const p of typePhrases) {
+            if (!strippedLower.startsWith(p.phrase))
+                continue;
+            if (!/^[\s:,.!*_—-]/.test(strippedLower.slice(p.phrase.length)))
+                continue;
+            warnings.push(makeWarning(i + 1, stripped.slice(0, p.phrase.length), p, target));
+            break;
+        }
+    });
+    return warnings;
+}
+function makeWarning(line, verb, p, mention) {
+    const rewrite = mention.retype(p.value);
+    return {
+        line,
+        verb,
+        suggestedType: p.value,
+        mention: mention.raw,
+        rewrite,
+        message: `prose "${verb}" narrates a relationship the graph can't see — ` +
+            `${mention.raw} files a plain reference. If the claim is real, retype ` +
+            `the mention: ${rewrite} (workspace type "${p.label}") and drop the ` +
+            `now-redundant verb. If "${verb}" isn't asserting a relationship here, ` +
+            `ignore this warning.`,
+    };
+}
+/** Cheap gate: does this body contain any generic mention at all? Used to
+ *  skip the relationship-types fetch when no warning could possibly fire. */
+export function hasGenericMention(markdown) {
+    for (const m of markdown.matchAll(MENTION_RE)) {
+        if (m[2].trim().toLowerCase() === "references")
+            return true;
+    }
+    for (const m of markdown.matchAll(WIKI_RE)) {
+        const parsed = parseWikiInner(m[1]);
+        if (parsed && parsed.type === null)
+            return true;
+    }
+    return false;
+}
+/** Fetch the workspace's relationship types for the narrated-verb lint.
+ *  Best-effort: returns null on any failure — the lint is advisory and must
+ *  never fail (or slow-fail) a write. */
+export async function fetchRelationshipTypeOptions(api, workspaceId) {
+    try {
+        const data = await api.get("/api/relationship-types", { workspaceId });
+        return data.relationshipTypes ?? [];
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Format the server's `unresolvedMentions` into an actionable block. Returns
  * null when there's nothing to report.

package/dist/lib/mention-lint.js.map

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

package/dist/lib/rubrics.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Type-rubric helpers for the authoring loop.
+ *
+ * Rubrics (`validationPrompt` on each supertag) are the quality standard for
+ * a note type. Agents habitually filter create responses down to
+ * `.results[].displayId`, so a sibling top-level `rubrics` array is invisible
+ * unless the agent already knows to look. These helpers:
+ *
+ *   1. Load the workspace's type → rubric map (non-fatal on failure).
+ *   2. Attach `type` + `rubric` onto each create result item so a `.results[]`
+ *      extraction carries the standard along with the displayId.
+ *   3. Build a compact `{ type, rubric }[]` list for pre-write surfaces
+ *      (`operations begin`), so the text is in context before authoring starts.
+ */
+import type { ApiClient } from "./api-client.js";
+export type TypeRubric = {
+    type: string;
+    /** Null when the type exists but has no validationPrompt. */
+    rubric: string | null;
+};
+/** Case-insensitive map of type display name → validationPrompt text. */
+export type RubricMap = Map<string, string>;
+/**
+ * Fetch every workspace type that has a validationPrompt.
+ * Returns an empty map (never throws) when the request fails — rubric echo
+ * must never fail a successful create / begin.
+ */
+export declare function loadRubricMap(api: ApiClient, workspaceId: string): Promise<RubricMap>;
+/**
+ * Compact list of `{ type, rubric }` for the distinct types in `typeNames`
+ * that have a validationPrompt. Preserves first-seen casing from `typeNames`.
+ */
+export declare function rubricsForTypes(typeNames: string[], map: RubricMap): Array<{
+    type: string;
+    rubric: string;
+}>;
+/**
+ * Every type in the workspace that has a validationPrompt, for pre-write
+ * surfaces (`operations begin`). Sorted by type name for stable output.
+ */
+export declare function allWorkspaceRubrics(map: RubricMap): Array<{
+    type: string;
+    rubric: string;
+}>;
+type CreateResult = Record<string, unknown> & {
+    key?: string;
+    displayId?: string;
+    noteId?: string;
+    title?: string;
+};
+/**
+ * Attach `type` + `rubric` onto each create result.
+ *
+ * `typeByKey` maps the batch item key → type string from the create request.
+ * Types without a validationPrompt get `rubric: null` so the gap is visible
+ * (several default types ship without one).
+ */
+export declare function attachRubricsToResults<T extends CreateResult>(results: T[], typeByKey: Map<string, string>, map: RubricMap): Array<T & TypeRubric>;
+export {};
+//# sourceMappingURL=rubrics.d.ts.map

package/dist/lib/rubrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rubrics.d.ts","sourceRoot":"","sources":["../../src/lib/rubrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5C;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,SAAS,EACd,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,CAAC,CAiBpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EAAE,EACnB,GAAG,EAAE,SAAS,GACb,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAWzC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAI3F;AAED,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,YAAY,EAC3D,OAAO,EAAE,CAAC,EAAE,EACZ,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,GAAG,EAAE,SAAS,GACb,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC,CAMvB"}

package/dist/lib/rubrics.js

@@ -0,0 +1,66 @@
+/**
+ * Fetch every workspace type that has a validationPrompt.
+ * Returns an empty map (never throws) when the request fails — rubric echo
+ * must never fail a successful create / begin.
+ */
+export async function loadRubricMap(api, workspaceId) {
+    try {
+        const supertags = await api.get("/api/supertags", {
+            workspaceId,
+        });
+        const byName = new Map();
+        for (const s of Array.isArray(supertags) ? supertags : []) {
+            const nm = String(s.name || "").toLowerCase();
+            const prompt = s.validationPrompt;
+            if (nm && typeof prompt === "string" && prompt.trim()) {
+                byName.set(nm, prompt);
+            }
+        }
+        return byName;
+    }
+    catch {
+        return new Map();
+    }
+}
+/**
+ * Compact list of `{ type, rubric }` for the distinct types in `typeNames`
+ * that have a validationPrompt. Preserves first-seen casing from `typeNames`.
+ */
+export function rubricsForTypes(typeNames, map) {
+    const seen = new Set();
+    const out = [];
+    for (const raw of typeNames) {
+        const key = raw.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        const rubric = map.get(key);
+        if (rubric)
+            out.push({ type: raw, rubric });
+    }
+    return out;
+}
+/**
+ * Every type in the workspace that has a validationPrompt, for pre-write
+ * surfaces (`operations begin`). Sorted by type name for stable output.
+ */
+export function allWorkspaceRubrics(map) {
+    return Array.from(map.entries())
+        .map(([type, rubric]) => ({ type, rubric }))
+        .sort((a, b) => a.type.localeCompare(b.type));
+}
+/**
+ * Attach `type` + `rubric` onto each create result.
+ *
+ * `typeByKey` maps the batch item key → type string from the create request.
+ * Types without a validationPrompt get `rubric: null` so the gap is visible
+ * (several default types ship without one).
+ */
+export function attachRubricsToResults(results, typeByKey, map) {
+    return results.map((r) => {
+        const type = (r.key ? typeByKey.get(String(r.key)) : undefined) ?? String(r.type ?? "");
+        const rubric = type ? map.get(type.toLowerCase()) ?? null : null;
+        return { ...r, type, rubric };
+    });
+}
+//# sourceMappingURL=rubrics.js.map

package/dist/lib/rubrics.js.map

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

package/dist/mcp-server.js

@@ -29,6 +29,8 @@ import { resolveNoteId } from "./lib/resolve-note.js";
 import { readCanvasMarkdown } from "./lib/canvas-read.js";
 import { buildSchema } from "./lib/build-schema.js";
 import { assertMcpLocalFileReadable, getMcpLocalFileRoots, } from "./lib/mcp-local-file.js";
+import { attachRubricsToResults, loadRubricMap, rubricsForTypes, } from "./lib/rubrics.js";
+import { lintNarratedVerbMentions, hasGenericMention, fetchRelationshipTypeOptions, } from "./lib/mention-lint.js";
 // ---------------------------------------------------------------------------
 // Environment
 // ---------------------------------------------------------------------------
@@ -233,41 +235,40 @@ const NoteCreateItem = z.object({
     markdown: z.string().describe("Note content as markdown (the first # h1 heading becomes the title)"),
     tags: z.array(z.string()).optional().describe("Tags for this note"),
 });
-server.tool("cnotes_notes_create", "Create one or more interlinked notes in a single atomic transaction. FIRST read the target type's rubric (cnotes_types_show) and author to it. Pass `notes` as one item object or an array; each note's title is its first # h1 heading. Cross-reference in markdown with [@key: Title](relationship:type) (same-batch — @key resolves to the new display ID) or [NOTE-12: Title](relationship:references) (existing note); ALWAYS include the ': Title' part, and the relationship name is free-form (use 'references' if unsure). The response echoes each type's rubric under `rubrics`; on validation failure, `details.items` pinpoints the bad item by index + key.", {
+server.tool("cnotes_notes_create", "Create one or more interlinked notes in a single atomic transaction. FIRST call cnotes_types_show for each target type and author to that rubric — do not skip this. Pass `notes` as one item object or an array; each note's title is its first # h1 heading. Cross-reference in markdown with [@key: Title](relationship:type) (same-batch — @key resolves to the new display ID) or [NOTE-12: Title](relationship:type) (existing note); ALWAYS include the ': Title' part. Pick the relationship type from the verb your own prose uses ('blocks', 'depends-on', …; free-form — unknown types auto-create); reserve 'references' for pure citations — a verb narrated in prose around a 'references' chip is invisible to backlinks. A `mentionWarnings` array in the result flags narrated verbs it detects; treat each as a retype instruction unless the prose genuinely isn't asserting a relationship. Each result item carries `type` + `rubric` (null when the type has no validationPrompt); a top-level `rubrics` array is also present. On validation failure, `details.items` pinpoints the bad item by index + key.", {
     notes: z
         .union([NoteCreateItem, z.array(NoteCreateItem).min(1)])
         .describe("Either a single item object or a non-empty array of items."),
 }, async ({ notes }) => withErrorHandling(async () => {
     const items = Array.isArray(notes) ? notes : [notes];
+    // Narrated-verb lint (warn-only, pre-send): MCP has no stderr channel,
+    // so `mentionWarnings` in the result is the only way the model sees it.
+    let mentionWarnings = [];
+    if (items.some((n) => hasGenericMention(String(n.markdown ?? "")))) {
+        const relTypes = await fetchRelationshipTypeOptions(api, workspaceId);
+        if (relTypes) {
+            mentionWarnings = items.flatMap((n) => lintNarratedVerbMentions(String(n.markdown ?? ""), relTypes).map((w) => ({ item: n.key, ...w })));
+        }
+    }
     const result = await api.post("/api/notes/bulk", {
         action: "bulkCreate",
         workspaceId,
         notes: items,
     });
-    // A1 — echo the rubric for each type used so the agent sees the standard
-    // for what it just wrote and can revise in-loop. Zero LLM. Non-fatal: the
-    // create already succeeded if we got here.
-    try {
-        const supertags = await api.get("/api/supertags", {
-            workspaceId,
-        });
-        const byName = new Map();
-        for (const s of Array.isArray(supertags) ? supertags : []) {
-            const nm = String(s.name || "").toLowerCase();
-            if (nm && s.validationPrompt)
-                byName.set(nm, String(s.validationPrompt));
-        }
-        const rubrics = Array.from(new Set(items.map((n) => String(n.type))))
-            .map((t) => ({ type: t, rubric: byName.get(t.toLowerCase()) || "" }))
-            .filter((r) => r.rubric);
-        if (rubrics.length > 0 && result && typeof result === "object") {
-            result.rubrics = rubrics;
-        }
-    }
-    catch {
-        // Skip the rubric echo if supertags can't be fetched.
-    }
-    return result;
+    // Attach rubrics ON EACH result so filtering to results[] still carries
+    // the standard. Top-level rubrics kept for backward compatibility.
+    // Non-fatal: create already succeeded if we got here.
+    const rubricMap = await loadRubricMap(api, workspaceId);
+    const typeByKey = new Map(items.map((n) => [n.key, n.type]));
+    const rawResults = (result.results || []);
+    const enriched = attachRubricsToResults(rawResults, typeByKey, rubricMap);
+    const rubrics = rubricsForTypes(items.map((n) => String(n.type)), rubricMap);
+    return {
+        ...result,
+        results: enriched,
+        ...(rubrics.length > 0 ? { rubrics } : {}),
+        ...(mentionWarnings.length > 0 ? { mentionWarnings } : {}),
+    };
 }));
 server.tool("cnotes_notes_retype", "Change a single note's type. Atomic operation: creates a new note with the target type, archives the old one, and cross-links both.", {
     noteId: z.string().describe("Display ID of the note to retype (e.g. NOTE-1)"),
@@ -590,7 +591,7 @@ server.tool("cnotes_canvas_bulk_remove", "Remove multiple nodes from a canvas in
     action: "bulkRemoveNodes",
     nodeIds,
 })));
-server.tool("cnotes_canvas_add_edge", "Connect two nodes on a canvas with an edge. Defaults to an arrow at the target end and a solid line.", {
+server.tool("cnotes_canvas_add_edge", "Connect two nodes on a canvas with an edge (any node type, including section frames). Defaults to an arrow at the target end and a solid line.", {
     canvasId: z.string().describe("Canvas ID"),
     sourceNodeId: z.string().describe("Source node ID"),
     targetNodeId: z.string().describe("Target node ID"),
@@ -852,16 +853,28 @@ server.tool("cnotes_versions_list", "List versions of a note.", {
         throw new Error(`Note not found: ${noteId}`);
     return note.versions || [];
 }));
-server.tool("cnotes_versions_create", "Create a new version of a note. Content is markdown. To link to other notes, use [NOTE-123: Title](relationship:references) inside the markdown — always include the title (the part after the colon) or the chip renders as 'Untitled'. The relationship name is free-form (e.g. references, triggers, caused-by); use 'references' if unsure.", {
+server.tool("cnotes_versions_create", "Create a new version of a note. Content is markdown. To link to other notes, use [NOTE-123: Title](relationship:type) inside the markdown — always include the title (the part after the colon) or the chip renders as 'Untitled'. Pick the relationship type from the verb your own prose uses ('blocks', 'depends-on', 'caused-by', …; free-form — unknown types auto-create); reserve 'references' for pure citations — a verb narrated in prose around a 'references' chip is invisible to backlinks. A `mentionWarnings` array in the result flags narrated verbs it detects; treat each as a retype instruction unless the prose genuinely isn't asserting a relationship.", {
     noteId: z.string().describe("Note display ID or Convex ID"),
     markdown: z.string().describe("New content as markdown"),
     description: z.string().describe("Change description (required)"),
 }, async ({ noteId, markdown, description }) => withErrorHandling(async () => {
+    // Narrated-verb lint (warn-only): same contract as cnotes_notes_create.
+    let mentionWarnings = [];
+    if (hasGenericMention(markdown)) {
+        const relTypes = await fetchRelationshipTypeOptions(api, workspaceId);
+        if (relTypes) {
+            mentionWarnings = lintNarratedVerbMentions(markdown, relTypes).map((w) => ({ ...w }));
+        }
+    }
     const resolvedId = await resolveNoteId(api, workspaceId, noteId);
-    return api.post(`/api/notes/${resolvedId}/versions`, {
+    const data = await api.post(`/api/notes/${resolvedId}/versions`, {
         content: markdown,
         description,
     });
+    return {
+        ...data,
+        ...(mentionWarnings.length > 0 ? { mentionWarnings } : {}),
+    };
 }));
 // ---------------------------------------------------------------------------
 // Workspace