@doclift/workflows-mcp 0.1.0 → 0.1.2

package/dist/guidance.js

@@ -69,6 +69,18 @@ The name is the **inner text**; only an *image* token reads \`data-src\`. A
 integrity check, and prints the name of the variable instead of its value.
 \`workflow_validate\` reports those as \`inert_tokens\`.
 
+Which of \`text\` and \`checkbox\` you pick is a **different** matter, and one
+you cannot get wrong: for a name the workflow declares, the renderer reads the
+genre off the variable's \`field_type\`, not off the class. Declare a box and
+write it with either token and a box is drawn. Get the *type* right in
+\`variable_create\` — that is the declaration everything follows — and stop
+worrying about which of the two classes you wrote.
+
+Two places the class still decides, because nothing declares a type there: a
+row field (\`collection.field\`, which no \`fields\` entry types) and a name no
+variable declares at all. A box inside a repeated table row is therefore
+written with the checkbox class and only with it.
+
 **2 quinquies. A CSS property is dropped from inside a \`style\` that survives.**
 The attribute is on the allow list, its contents are filtered against a list of
 their own. \`text-transform\` goes, \`style\` stays, and nothing about the element
@@ -89,6 +101,17 @@ makes no network request at render time, so every picture has to go through
 \`image_upload\` and be cited by the URL it answers with. \`workflow_validate\`
 reports the others under \`unreachable_images\`.
 
+**2 sexies. A running title band is clipped at the height of its margin.** The
+band is framed at the margin reserved for its side — never less than
+\`capabilities.authoring.band.reserved_mm_minimum\` — and what does not fit is
+hidden. Measured at the default margins: it holds
+\`capabilities.authoring.band.usable_lines_at_minimum\` lines and loses the rest,
+**from the top for a footer**, so a paragraph of legal text comes back starting
+mid-sentence. No write refuses it, \`workflow_validate\` sees nothing wrong with
+the markup, and the render answers 200. \`workflow_selfcheck\` reports these as
+\`clipped_bands\`. A band is a line, not a paragraph: legal text belongs in a
+content section, which flows onto the next page instead of being cut.
+
 **3. Declaring inline what the theme already says freezes the document.** It
 looks identical today and stops following the theme forever. Set the theme, then
 write only what departs from it. This is the mistake that costs the most and
@@ -194,10 +217,13 @@ satisfied.
    the integrity check, and is invisible everywhere else.
 3. **No picture is unreachable.** The engine makes no network request, and a
    token that no longer names a stored image is removed at render time.
-4. **No variable was declared and never used.** The mirror of a broken
+4. **No band is longer than the margin reserved for it.** A running head or
+   foot is clipped, without an error, and a footer loses its opening rather
+   than its end.
+5. **No variable was declared and never used.** The mirror of a broken
    reference: it usually means a token was written with a typo, and the typo
    became a second, dead name.
-5. **A PDF exists, and it is newer than your last edit.** If you rendered before
+6. **A PDF exists, and it is newer than your last edit.** If you rendered before
    your last change, what you looked at is not what you have.
 
 ## What it cannot check, and you must

package/dist/index.js

@@ -6,6 +6,7 @@
 // organization the key belongs to. The only knowledge that lives here is the
 // knowledge the API cannot express — the order to do things in, and the failures
 // that succeed.
+import { createRequire } from 'node:module';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
@@ -13,6 +14,10 @@ import { ApiClient } from './client.js';
 import { registerTools } from './tools/index.js';
 import { ANOMALIES, BEFORE_YOU_FINISH, CONDITIONS, HOW_TO_BUILD, REPETITIONS } from './guidance.js';
 const DEFAULT_BASE_URL = 'https://app.doclift.io';
+// Read rather than written a second time: the first publish that changed the
+// guides shipped as 0.1.1 and still announced 0.1.0 in the handshake, which is
+// the version a client shows its user and a bug report quotes.
+const { version } = createRequire(import.meta.url)('../package.json');
 const readConfig = () => {
     const apiKey = process.env['DOCLIFT_API_KEY'];
     if (!apiKey) {
@@ -55,7 +60,7 @@ const GUIDES = [
 ];
 const main = async () => {
     const { baseUrl, apiKey } = readConfig();
-    const server = new McpServer({ name: 'doclift-workflows', version: '0.1.0' }, {
+    const server = new McpServer({ name: 'doclift-workflows', version }, {
         instructions: 'Authoring of Doclift workflows: conditional PDF documents assembled from a tree of sections. ' +
             'Call `workflow_capabilities` before writing anything — it carries the catalogues and the ' +
             'limits for this organization, and nothing in this server duplicates them. Read the ' +

package/dist/tools/checks.js

@@ -99,6 +99,13 @@ const selfcheck = (validation, template, payload) => {
     };
     lines.push(listLine('inert_tokens', 'No variable token is inert', 'Rewrite each token with the class capabilities.content.tokens gives, then section_update.'));
     lines.push(listLine('unreachable_images', 'No picture is unreachable', 'Upload each picture with image_upload and cite the URL it answers with.'));
+    // A band is framed at the height of the margin reserved for it and clipped.
+    // Measured: at the default margins it holds two lines and loses the third,
+    // from the top for a footer — so a paragraph of legal text comes back
+    // starting mid-sentence, and nothing else in this API says a word about it.
+    lines.push(listLine('clipped_bands', 'No running title band is longer than the margin reserved for it', 'Shorten the band, or widen the margin on that side. A band is not a place ' +
+        'for a paragraph: move legal text into a content section, which flows and ' +
+        'is never cut.'));
     lines.push(listLine('layout_tables', 'No table is used for a column layout with its rules showing', 'Put capabilities.authoring.table.layout_row_class on the <tr>: it takes the rules away and ' +
         'leaves the columns. A ruled table around two blocks set side by side is a shape no ' +
         'hand-made document has.'));

package/dist/tools/sections.js

@@ -31,7 +31,10 @@ export const registerSections = (server, api, base) => {
                 'CLASS, not by its tag: <variable class="editor-text-variable non-editable-content editor-parsed">name</variable>, the name being ' +
                 'the inner text. Take the exact string from capabilities.content.tokens — a token ' +
                 'without the editor-parsed class prints the name instead of the value, and every ' +
-                'other check passes.'),
+                'other check passes. Which of text and checkbox you write does NOT decide: for a ' +
+                "declared name the renderer reads the genre off the variable's field_type. The " +
+                'class still decides for a row field and for a name nothing declares, since no type ' +
+                'is attached to either.'),
             parent_id: z.number().int().nullable().optional().describe('Must name a group of the same workflow.'),
             position: z
                 .number()

package/dist/tools/variables.js

@@ -17,7 +17,11 @@ export const registerVariables = (server, api, base) => {
         inputSchema: {
             template_id: templateId,
             name: z.string().min(1),
-            field_type: z.string().describe('See capabilities.variable.field_types.'),
+            field_type: z
+                .string()
+                .describe('See capabilities.variable.field_types. This is what decides how a token for this ' +
+                'name renders: a `checkbox` prints a box whichever of the two token classes the ' +
+                'content was written with, anything else prints the value.'),
             description: z.string().min(1).describe('Required. What the variable holds, for whoever fills it in.'),
             required: z.boolean().optional(),
             seed_value: z.string().optional().describe('What the preview shows in its place.'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doclift/workflows-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP server over the Doclift workflow authoring API",
   "license": "MIT",
   "homepage": "https://www.doclift.io/docs/getting-started",
@@ -14,7 +14,7 @@
   ],
   "type": "module",
   "bin": {
-    "doclift-workflows-mcp": "./dist/index.js"
+    "doclift-workflows-mcp": "dist/index.js"
   },
   "files": [
     "dist"