lotux-mcp 0.26.0 → 0.28.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lotux-mcp",
-  "version": "0.26.0",
+  "version": "0.28.0",
   "type": "module",
   "description": "Local MCP server that lets Claude create LOTUX concepts (fetch brand-DB entities, create concepts, fill scripts + copy). Talks to the LOTUX app with a personal token; no business logic or secrets live here.",
   "bin": {

package/tools.mjs

@@ -75,7 +75,7 @@ export function registerTools(server, rpc) {
 
   server.tool(
     "plan_items",
-    "Plan 1–60 items on ONE person's calendar on a date. With start_time they run back to back, each as long as that person's HR output allows (40 h ÷ weekly output; tasks 1 h); without start_time they land all-day. The person becomes the maker (post: video editor on video concepts, static designer on statics) or media buyer (go_live); on a task they are added to the assignees. Planning concept blocks needs Creative edit rights. More than 10 items → returns a PREVIEW only and changes nothing: show the list, ask for a yes, then call apply_planning_preview. Never deletes anything.",
+    "Plan 1–60 items on ONE person's calendar from a date. Concepts (post) without start_time go into that person's day blocks, in the blocks the planner baseline keeps for the concept's client (the client's goal for the week, max clients a day, block changes, meetings and planned work respected), starting on the date and continuing on the next working days up to the planning horizon. Concepts that don't fit (goal covered, person not on the client's team, not ready, someone else's) stay in the Unplanned Log and come back in not_planned with the reason: tell the user. With start_time they run back to back from that time instead, each as long as that person's HR output allows (40 h ÷ weekly output; tasks 1 h); all_day: true = all-day. go_live and tasks without start_time land all-day. The person becomes the maker (post: video editor on video concepts, static designer on statics) or media buyer (go_live); on a task they are added to the assignees. Planning concept blocks needs Creative edit rights. More than 10 items → returns a PREVIEW only and changes nothing: show the list, ask for a yes, then call apply_planning_preview. Never deletes anything.",
     {
       person: z.string().describe("id, name or 'me'"),
       items: PLAN_ITEMS,
@@ -702,6 +702,15 @@ export function registerTools(server, rpc) {
 
   // ── Kennisbank (knowledge base) ─────────────────────────────────────────────────
 
+  // How a Second Brain page's markdown is laid out — the app renders these.
+  const KB_FORMAT =
+    " Page markdown supports, besides normal markdown (headings, lists, tables, --- dividers, images): " +
+    "fenced blocks the app renders as page blocks — ```cards (one card per line: Label | Title | Text), " +
+    "```stats (Value | Label | Note), ```steps (Title | Text), ```callout (first line = title, the rest = body), " +
+    "```buttons (Label | link), ```mermaid (a Mermaid diagram). Any of those may start with a line " +
+    "`tone: gray|yellow|blue|green|red|purple|ink` for its colour. Link to another page with a normal markdown link " +
+    "to /brain/second-brain?ws=<workspace id>&doc=<page id>.";
+
   server.tool(
     "list_kb_workspaces",
     "List the Kennisbank (knowledge base) workspaces you can access — markdown docs the team and AI share. Returns id, name, visibility. Use a workspace id with list_kb_docs / create_kb_doc. Only each workspace's \"Exposed to MCP\" section is visible to the MCP; the rest is the team's own notes.",
@@ -711,37 +720,41 @@ export function registerTools(server, rpc) {
 
   server.tool(
     "list_kb_docs",
-    "List the pages in a Kennisbank workspace's \"Exposed to MCP\" section (id, title, folder path inside the section; \"\" = its top level). Pages outside the section are not listed. Use a doc id with get_kb_doc.",
+    "List the pages in a Kennisbank workspace's \"Exposed to MCP\" section (id, title, folder path inside the section; \"\" = its top level; tags; date). Pages outside the section are not listed. Use a doc id with get_kb_doc.",
     { workspace_id: z.string().describe("Workspace id from list_kb_workspaces") },
     async ({ workspace_id }) => ok(await rpc("list_kb_docs", { workspace_id }))
   );
 
   server.tool(
     "get_kb_doc",
-    "Read one Kennisbank page's full markdown content by id. Only pages in the \"Exposed to MCP\" section can be read.",
+    "Read one Kennisbank page by id: title, author, date, tags, full markdown content and linked_pages (the pages it links to; a linked page outside an \"Exposed to MCP\" section shows only its id with exposed: false). Only pages in the \"Exposed to MCP\" section can be read." + KB_FORMAT,
     { doc_id: z.string() },
     async ({ doc_id }) => ok(await rpc("get_kb_doc", { doc_id }))
   );
 
   server.tool(
     "create_kb_doc",
-    "Create a new markdown page in a Kennisbank workspace's \"Exposed to MCP\" section. Returns the new doc id. content is markdown; folder_id is optional (top of the section if omitted) and must be a folder from list_kb_folders.",
+    "Create a new markdown page in a Kennisbank workspace's \"Exposed to MCP\" section. Returns the new doc id. content is markdown; folder_id is optional (top of the section if omitted) and must be a folder from list_kb_folders. You become the page's author." + KB_FORMAT,
     {
       workspace_id: z.string().describe("Workspace id from list_kb_workspaces"),
       title: z.string(),
       content: z.string().optional().describe("Markdown body"),
       folder_id: z.string().optional(),
+      tags: z.array(z.string()).optional().describe("Page tags"),
+      date: z.string().optional().describe("Page date, YYYY-MM-DD (default: today)"),
     },
     async (args) => ok(await rpc("create_kb_doc", args))
   );
 
   server.tool(
     "update_kb_doc",
-    "Update a Kennisbank page's title and/or markdown content (pages in the \"Exposed to MCP\" section only). Omitted fields are left unchanged.",
+    "Update a Kennisbank page's title, markdown content, tags and/or date (pages in the \"Exposed to MCP\" section only). Omitted fields are left unchanged." + KB_FORMAT,
     {
       doc_id: z.string(),
       title: z.string().optional(),
       content: z.string().optional().describe("Markdown body (replaces the page content)"),
+      tags: z.array(z.string()).optional().describe("Replaces the page's tags"),
+      date: z.string().nullable().optional().describe("Page date YYYY-MM-DD; null = back to the created date"),
     },
     async (args) => ok(await rpc("update_kb_doc", args))
   );