sqlew 4.3.0 → 5.0.0

package/dist/formatters/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Document Formatters (v5.0.0)
+ *
+ * Converts SaaS export blocks to various document formats:
+ * - Markdown: Standard markdown for README, Wiki
+ * - ADR: Architecture Decision Records format
+ * - Notion: Notion Blocks API JSON
+ * - Confluence: Confluence Storage Format (XHTML)
+ */
+export type { DocumentFormatter, FormatterOptions, ExportBlocks } from './types.js';
+export { MarkdownFormatter } from './markdown-formatter.js';
+export { AdrFormatter } from './adr-formatter.js';
+export { NotionFormatter } from './notion-formatter.js';
+export { ConfluenceFormatter } from './confluence-formatter.js';
+import type { ExportFormat } from '../types.js';
+import type { DocumentFormatter, FormatterOptions, ExportBlocks } from './types.js';
+/**
+ * Create a formatter instance for the given format
+ * @param format - Output format type
+ * @returns DocumentFormatter instance
+ * @throws Error if format is 'blocks' (no transformation needed) or unknown
+ */
+export declare function createFormatter(format: ExportFormat): DocumentFormatter;
+/**
+ * Format export blocks using the specified format
+ * Convenience function that creates formatter and applies it
+ *
+ * @param blocks - Export blocks from SaaS
+ * @param format - Output format
+ * @param options - Formatter options
+ * @returns Formatted string (or ExportBlocks JSON string for 'blocks' format)
+ */
+export declare function formatBlocks(blocks: ExportBlocks, format: ExportFormat, options?: FormatterOptions): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/formatters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAMpF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,iBAAiB,CAevE;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,gBAAgB,GACzB,MAAM,CAOR"}

package/dist/formatters/index.js

@@ -0,0 +1,57 @@
+/**
+ * Document Formatters (v5.0.0)
+ *
+ * Converts SaaS export blocks to various document formats:
+ * - Markdown: Standard markdown for README, Wiki
+ * - ADR: Architecture Decision Records format
+ * - Notion: Notion Blocks API JSON
+ * - Confluence: Confluence Storage Format (XHTML)
+ */
+// Formatters
+export { MarkdownFormatter } from './markdown-formatter.js';
+export { AdrFormatter } from './adr-formatter.js';
+export { NotionFormatter } from './notion-formatter.js';
+export { ConfluenceFormatter } from './confluence-formatter.js';
+import { MarkdownFormatter } from './markdown-formatter.js';
+import { AdrFormatter } from './adr-formatter.js';
+import { NotionFormatter } from './notion-formatter.js';
+import { ConfluenceFormatter } from './confluence-formatter.js';
+/**
+ * Create a formatter instance for the given format
+ * @param format - Output format type
+ * @returns DocumentFormatter instance
+ * @throws Error if format is 'blocks' (no transformation needed) or unknown
+ */
+export function createFormatter(format) {
+    switch (format) {
+        case 'markdown':
+            return new MarkdownFormatter();
+        case 'adr':
+            return new AdrFormatter();
+        case 'notion':
+            return new NotionFormatter();
+        case 'confluence':
+            return new ConfluenceFormatter();
+        case 'blocks':
+            throw new Error('blocks format does not require a formatter - return raw ExportBlocks');
+        default:
+            throw new Error(`Unknown format: ${format}`);
+    }
+}
+/**
+ * Format export blocks using the specified format
+ * Convenience function that creates formatter and applies it
+ *
+ * @param blocks - Export blocks from SaaS
+ * @param format - Output format
+ * @param options - Formatter options
+ * @returns Formatted string (or ExportBlocks JSON string for 'blocks' format)
+ */
+export function formatBlocks(blocks, format, options) {
+    if (format === 'blocks') {
+        return JSON.stringify(blocks, null, 2);
+    }
+    const formatter = createFormatter(format);
+    return formatter.format(blocks, options);
+}
+//# sourceMappingURL=index.js.map

package/dist/formatters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,aAAa;AACb,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAKhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAoB;IAClD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU;YACb,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACjC,KAAK,KAAK;YACR,OAAO,IAAI,YAAY,EAAE,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,IAAI,eAAe,EAAE,CAAC;QAC/B,KAAK,YAAY;YACf,OAAO,IAAI,mBAAmB,EAAE,CAAC;QACnC,KAAK,QAAQ;YACX,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;QAC1F;YACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAoB,EACpB,MAAoB,EACpB,OAA0B;IAE1B,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/dist/formatters/markdown-formatter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Markdown document formatter
+ * Converts export blocks to Markdown format
+ */
+import type { DocumentFormatter, FormatterOptions, ExportBlocks } from './types.js';
+/**
+ * Markdown formatter implementation
+ * Generates standard Markdown that can be used in README, Wiki, etc.
+ */
+export declare class MarkdownFormatter implements DocumentFormatter {
+    format(blocks: ExportBlocks, options?: FormatterOptions): string;
+    private formatSection;
+    private formatConstraint;
+    private toAnchor;
+}
+//# sourceMappingURL=markdown-formatter.d.ts.map

package/dist/formatters/markdown-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-formatter.d.ts","sourceRoot":"","sources":["../../src/formatters/markdown-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAA6C,MAAM,YAAY,CAAC;AAE/H;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,iBAAiB;IACzD,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM;IA6CpE,OAAO,CAAC,aAAa;IAuDrB,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,QAAQ;CAMjB"}

package/dist/formatters/markdown-formatter.js

@@ -0,0 +1,110 @@
+/**
+ * Markdown document formatter
+ * Converts export blocks to Markdown format
+ */
+/**
+ * Markdown formatter implementation
+ * Generates standard Markdown that can be used in README, Wiki, etc.
+ */
+export class MarkdownFormatter {
+    format(blocks, options = {}) {
+        const lines = [];
+        const { include_metadata = true, include_context = false, include_toc = false } = options;
+        // Title
+        lines.push('# Decisions Export');
+        lines.push('');
+        // Metadata
+        if (include_metadata) {
+            lines.push(`*Exported on ${blocks.metadata.exported_at}*`);
+            lines.push('');
+        }
+        // Table of contents
+        if (include_toc && blocks.blocks.length > 0) {
+            lines.push('## Table of Contents');
+            lines.push('');
+            for (const section of blocks.blocks) {
+                const anchor = this.toAnchor(section.title);
+                lines.push(`- [${section.title}](#${anchor})`);
+            }
+            if (blocks.constraints && blocks.constraints.length > 0) {
+                lines.push('- [Constraints](#constraints)');
+            }
+            lines.push('');
+        }
+        // Decision sections
+        for (const section of blocks.blocks) {
+            lines.push(...this.formatSection(section, include_metadata, include_context));
+        }
+        // Constraints section
+        if (blocks.constraints && blocks.constraints.length > 0) {
+            lines.push('## Constraints');
+            lines.push('');
+            for (const constraint of blocks.constraints) {
+                lines.push(...this.formatConstraint(constraint));
+            }
+        }
+        return lines.join('\n');
+    }
+    formatSection(section, includeMetadata, includeContext) {
+        const lines = [];
+        lines.push(`## ${section.title}`);
+        lines.push('');
+        for (const item of section.items) {
+            lines.push(`### ${item.key}`);
+            lines.push('');
+            lines.push(`**Value:** ${item.value}`);
+            if (includeMetadata) {
+                if (item.version) {
+                    lines.push(`**Version:** ${item.version}`);
+                }
+                if (item.updated) {
+                    lines.push(`**Updated:** ${item.updated}`);
+                }
+                if (item.tags && item.tags.length > 0) {
+                    lines.push(`**Tags:** ${item.tags.join(', ')}`);
+                }
+            }
+            if (includeContext) {
+                if (item.rationale) {
+                    lines.push('');
+                    lines.push('**Rationale:**');
+                    lines.push(item.rationale);
+                }
+                if (item.alternatives && item.alternatives.length > 0) {
+                    lines.push('');
+                    lines.push('**Alternatives Considered:**');
+                    for (const alt of item.alternatives) {
+                        lines.push(`- ${alt}`);
+                    }
+                }
+                if (item.tradeoffs) {
+                    lines.push('');
+                    lines.push('**Tradeoffs:**');
+                    lines.push(item.tradeoffs);
+                }
+            }
+            lines.push('');
+            lines.push('---');
+            lines.push('');
+        }
+        return lines;
+    }
+    formatConstraint(constraint) {
+        const lines = [];
+        lines.push(`### [${constraint.category}] ${constraint.rule}`);
+        lines.push('');
+        lines.push(`**Priority:** ${constraint.priority}`);
+        if (constraint.tags && constraint.tags.length > 0) {
+            lines.push(`**Tags:** ${constraint.tags.join(', ')}`);
+        }
+        lines.push('');
+        return lines;
+    }
+    toAnchor(title) {
+        return title
+            .toLowerCase()
+            .replace(/[^a-z0-9\s-]/g, '')
+            .replace(/\s+/g, '-');
+    }
+}
+//# sourceMappingURL=markdown-formatter.js.map

package/dist/formatters/markdown-formatter.js.map

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

package/dist/formatters/notion-formatter.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Notion blocks formatter
+ * Converts export blocks to Notion Blocks API format
+ *
+ * Output can be:
+ * - Copied and pasted directly into Notion
+ * - Posted via Notion API
+ *
+ * @see https://developers.notion.com/reference/block
+ */
+import type { DocumentFormatter, FormatterOptions, ExportBlocks } from './types.js';
+/**
+ * Notion formatter implementation
+ * Generates Notion Blocks API compatible JSON
+ */
+export declare class NotionFormatter implements DocumentFormatter {
+    format(blocks: ExportBlocks, options?: FormatterOptions): string;
+    private formatItem;
+    private formatConstraint;
+    private richText;
+    private heading1;
+    private heading2;
+    private heading3;
+    private paragraph;
+    private bulletedListItem;
+    private callout;
+    private divider;
+}
+//# sourceMappingURL=notion-formatter.d.ts.map

package/dist/formatters/notion-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion-formatter.d.ts","sourceRoot":"","sources":["../../src/formatters/notion-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAA0C,MAAM,YAAY,CAAC;AAsB5H;;;GAGG;AACH,qBAAa,eAAgB,YAAW,iBAAiB;IACvD,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM;IAoCpE,OAAO,CAAC,UAAU;IAkElB,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,OAAO;CAMhB"}

package/dist/formatters/notion-formatter.js

@@ -0,0 +1,177 @@
+/**
+ * Notion blocks formatter
+ * Converts export blocks to Notion Blocks API format
+ *
+ * Output can be:
+ * - Copied and pasted directly into Notion
+ * - Posted via Notion API
+ *
+ * @see https://developers.notion.com/reference/block
+ */
+/**
+ * Notion formatter implementation
+ * Generates Notion Blocks API compatible JSON
+ */
+export class NotionFormatter {
+    format(blocks, options = {}) {
+        const { include_metadata = true, include_context = false } = options;
+        const notionBlocks = [];
+        // Title
+        notionBlocks.push(this.heading1('Decisions Export'));
+        // Metadata
+        if (include_metadata) {
+            notionBlocks.push(this.paragraph([
+                this.richText(`Exported on ${blocks.metadata.exported_at}`, { italic: true })
+            ]));
+            notionBlocks.push(this.divider());
+        }
+        // Decision sections
+        for (const section of blocks.blocks) {
+            notionBlocks.push(this.heading2(section.title));
+            for (const item of section.items) {
+                notionBlocks.push(...this.formatItem(item, include_metadata, include_context));
+            }
+        }
+        // Constraints section
+        if (blocks.constraints && blocks.constraints.length > 0) {
+            notionBlocks.push(this.heading2('Constraints'));
+            for (const constraint of blocks.constraints) {
+                notionBlocks.push(...this.formatConstraint(constraint));
+            }
+        }
+        return JSON.stringify({ blocks: notionBlocks }, null, 2);
+    }
+    formatItem(item, includeMetadata, includeContext) {
+        const blocks = [];
+        // Item title
+        blocks.push(this.heading3(item.key));
+        // Value
+        blocks.push(this.paragraph([
+            this.richText('Value: ', { bold: true }),
+            this.richText(item.value)
+        ]));
+        // Metadata fields
+        if (includeMetadata) {
+            const metaFields = [];
+            if (item.version) {
+                metaFields.push(this.richText('Version: ', { bold: true }));
+                metaFields.push(this.richText(`${item.version}  `));
+            }
+            if (item.updated) {
+                metaFields.push(this.richText('Updated: ', { bold: true }));
+                metaFields.push(this.richText(`${item.updated}  `));
+            }
+            if (item.tags && item.tags.length > 0) {
+                metaFields.push(this.richText('Tags: ', { bold: true }));
+                metaFields.push(this.richText(item.tags.join(', ')));
+            }
+            if (metaFields.length > 0) {
+                blocks.push(this.paragraph(metaFields));
+            }
+        }
+        // Context fields
+        if (includeContext) {
+            if (item.rationale) {
+                blocks.push(this.callout(item.rationale, '💡'));
+            }
+            if (item.alternatives && item.alternatives.length > 0) {
+                blocks.push(this.paragraph([
+                    this.richText('Alternatives Considered:', { bold: true })
+                ]));
+                for (const alt of item.alternatives) {
+                    blocks.push(this.bulletedListItem(alt));
+                }
+            }
+            if (item.tradeoffs) {
+                blocks.push(this.paragraph([
+                    this.richText('Tradeoffs:', { bold: true })
+                ]));
+                blocks.push(this.paragraph([this.richText(item.tradeoffs)]));
+            }
+        }
+        blocks.push(this.divider());
+        return blocks;
+    }
+    formatConstraint(constraint) {
+        const blocks = [];
+        blocks.push(this.heading3(`[${constraint.category}] ${constraint.rule}`));
+        blocks.push(this.paragraph([
+            this.richText('Priority: ', { bold: true }),
+            this.richText(constraint.priority)
+        ]));
+        if (constraint.tags && constraint.tags.length > 0) {
+            blocks.push(this.paragraph([
+                this.richText('Tags: ', { bold: true }),
+                this.richText(constraint.tags.join(', '))
+            ]));
+        }
+        return blocks;
+    }
+    // ========== Notion Block Helpers ==========
+    richText(content, annotations) {
+        const rt = {
+            type: 'text',
+            text: { content }
+        };
+        if (annotations) {
+            rt.annotations = annotations;
+        }
+        return rt;
+    }
+    heading1(text) {
+        return {
+            type: 'heading_1',
+            heading_1: {
+                rich_text: [this.richText(text)]
+            }
+        };
+    }
+    heading2(text) {
+        return {
+            type: 'heading_2',
+            heading_2: {
+                rich_text: [this.richText(text)]
+            }
+        };
+    }
+    heading3(text) {
+        return {
+            type: 'heading_3',
+            heading_3: {
+                rich_text: [this.richText(text)]
+            }
+        };
+    }
+    paragraph(richTexts) {
+        return {
+            type: 'paragraph',
+            paragraph: {
+                rich_text: richTexts
+            }
+        };
+    }
+    bulletedListItem(text) {
+        return {
+            type: 'bulleted_list_item',
+            bulleted_list_item: {
+                rich_text: [this.richText(text)]
+            }
+        };
+    }
+    callout(text, emoji) {
+        return {
+            type: 'callout',
+            callout: {
+                rich_text: [this.richText(text)],
+                icon: { type: 'emoji', emoji }
+            }
+        };
+    }
+    divider() {
+        return {
+            type: 'divider',
+            divider: {}
+        };
+    }
+}
+//# sourceMappingURL=notion-formatter.js.map

package/dist/formatters/notion-formatter.js.map

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

package/dist/formatters/types.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Formatter type definitions
+ * Shared types for document formatters (v5.0.0)
+ */
+import type { ExportBlocks } from '../types.js';
+/**
+ * Options for document formatters
+ */
+export interface FormatterOptions {
+    /** Include metadata (timestamps, versions) in output */
+    include_metadata?: boolean;
+    /** Include decision context (rationale, alternatives, tradeoffs) */
+    include_context?: boolean;
+    /** Include table of contents (Markdown/ADR only) */
+    include_toc?: boolean;
+}
+/**
+ * Document formatter interface
+ * All formatters must implement this interface
+ */
+export interface DocumentFormatter {
+    /**
+     * Format export blocks to output string
+     * @param blocks - Structured blocks from SaaS
+     * @param options - Formatting options
+     * @returns Formatted document string
+     */
+    format(blocks: ExportBlocks, options?: FormatterOptions): string;
+}
+export type { ExportBlocks, ExportBlockItem, ExportBlockSection, ExportBlockConstraint } from '../types.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/formatters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/formatters/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oDAAoD;IACpD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;CAClE;AAGD,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC"}

package/dist/formatters/types.js

@@ -0,0 +1,6 @@
+/**
+ * Formatter type definitions
+ * Shared types for document formatters (v5.0.0)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/formatters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/formatters/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/help-data/_schema.toml

@@ -0,0 +1,21 @@
+# Help System Schema Metadata
+# Version tracking for help data files
+
+version = "5.0.0"
+help_data_version = "1.0.0"
+last_updated = "2026-01-08"
+
+[conventions]
+# Naming conventions used in this help system
+action_naming = "snake_case"
+parameter_naming = "snake_case"
+
+[tools]
+# List of available tools (for quick reference)
+available = ["decision", "constraint", "suggest", "help", "example", "use_case"]
+
+[complexity_levels]
+# Use case complexity definitions
+basic = "Simple single-tool operations"
+intermediate = "Multi-step workflows within a tool"
+advanced = "Cross-tool workflows with dependencies"