@cplace/mcp-server 1.6.0 → 1.6.1

package/dist/plugin-registry.js

@@ -0,0 +1,138 @@
+import { debugLogWithTag } from './logger.js';
+import { loadWidgetSpecifications } from './plugins/widget-specifications.js';
+import { loadAppCatalog } from './plugins/app-catalog.js';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { corePlugin, workspaceAdminPlugin, layoutsPlugin, typesWritePlugin, lowCodePlugin, jobsPlugin, projectPlanningPlugin, historyPlugin, solutionManagementPlugin, applicationSettingsPlugin, resourceManagementPlugin } from './plugins/index.js';
+export class PluginRegistry {
+    plugins = new Map();
+    constructor() {
+        this.registerBuiltinPlugins();
+    }
+    registerBuiltinPlugins() {
+        const builtins = [
+            corePlugin, workspaceAdminPlugin, layoutsPlugin,
+            typesWritePlugin, lowCodePlugin, jobsPlugin, projectPlanningPlugin,
+            historyPlugin, solutionManagementPlugin, applicationSettingsPlugin,
+            resourceManagementPlugin
+        ];
+        for (const plugin of builtins) {
+            this.register(plugin);
+        }
+    }
+    register(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            throw new Error(`Plugin '${plugin.name}' is already registered`);
+        }
+        const registered = { plugin };
+        const widgetSpecsDir = join(plugin.sourcePath, `${plugin.name}-widget-specifications`);
+        if (existsSync(widgetSpecsDir)) {
+            registered.widgetSpecifications = loadWidgetSpecifications(widgetSpecsDir);
+            debugLogWithTag('PLUGINS', `Auto-discovered widget specifications for '${plugin.name}' at ${widgetSpecsDir}`);
+        }
+        const appCatalogDir = join(plugin.sourcePath, `${plugin.name}-app-catalog`);
+        if (existsSync(appCatalogDir)) {
+            registered.appCatalog = loadAppCatalog(appCatalogDir);
+            debugLogWithTag('PLUGINS', `Auto-discovered app catalog for '${plugin.name}' at ${appCatalogDir}`);
+        }
+        this.plugins.set(plugin.name, registered);
+    }
+    hasProfile(name) {
+        return this.plugins.has(name);
+    }
+    getAvailableProfileNames() {
+        return new Set(this.plugins.keys());
+    }
+    getAvailableProfiles() {
+        const result = {};
+        for (const [name, registered] of this.plugins) {
+            result[name] = { description: registered.plugin.description };
+        }
+        return result;
+    }
+    getToolDefinitions(profileName) {
+        const registered = this.plugins.get(profileName);
+        if (!registered)
+            return {};
+        const result = {};
+        for (const [moduleName, mod] of Object.entries(registered.plugin.modules)) {
+            if (mod.toolDefinitions) {
+                result[moduleName] = mod.toolDefinitions;
+            }
+        }
+        return result;
+    }
+    validateToolNameCollisions() {
+        const toolToPlugin = new Map();
+        const warnings = [];
+        for (const [pluginName, registered] of this.plugins) {
+            for (const [moduleName, mod] of Object.entries(registered.plugin.modules)) {
+                if (!mod.toolDefinitions)
+                    continue;
+                for (const toolName of Object.keys(mod.toolDefinitions)) {
+                    const existingPlugin = toolToPlugin.get(toolName);
+                    if (existingPlugin) {
+                        warnings.push(`Tool name collision: '${toolName}' is defined by both ` +
+                            `plugin '${existingPlugin}' and plugin '${pluginName}' (module '${moduleName}'). ` +
+                            `The tool from '${existingPlugin}' will be used.`);
+                    }
+                    else {
+                        toolToPlugin.set(toolName, pluginName);
+                    }
+                }
+            }
+        }
+        return warnings;
+    }
+    getAggregatedWidgetSpecifications(activeProfiles) {
+        const merged = {};
+        for (const profileName of activeProfiles) {
+            const registered = this.plugins.get(profileName);
+            if (!registered?.widgetSpecifications)
+                continue;
+            for (const [widgetKind, specData] of Object.entries(registered.widgetSpecifications)) {
+                if (merged[widgetKind]) {
+                    debugLogWithTag('PLUGINS', `Widget spec overlap for '${widgetKind}' from plugin '${profileName}' — overriding existing keys`);
+                    merged[widgetKind] = { ...merged[widgetKind], ...specData };
+                }
+                else {
+                    merged[widgetKind] = { ...specData };
+                }
+            }
+        }
+        return merged;
+    }
+    getAggregatedAppCatalog(activeProfiles) {
+        const merged = {};
+        for (const profileName of activeProfiles) {
+            const registered = this.plugins.get(profileName);
+            if (!registered?.appCatalog)
+                continue;
+            for (const [appName, entry] of Object.entries(registered.appCatalog)) {
+                if (merged[appName]) {
+                    debugLogWithTag('PLUGINS', `App catalog overlap for '${appName}' from plugin '${profileName}' — overriding`);
+                }
+                merged[appName] = { ...entry };
+            }
+        }
+        return merged;
+    }
+    registerTools(server, client, activeProfiles) {
+        const registeredModules = new Set();
+        for (const profileName of activeProfiles) {
+            const registered = this.plugins.get(profileName);
+            if (!registered) {
+                debugLogWithTag('MCP', `Warning: Unknown profile '${profileName}' — skipping`);
+                continue;
+            }
+            for (const [moduleName, mod] of Object.entries(registered.plugin.modules)) {
+                if (!registeredModules.has(moduleName)) {
+                    mod.register(server, client);
+                    registeredModules.add(moduleName);
+                }
+            }
+        }
+        debugLogWithTag('MCP', `Registered ${registeredModules.size} modules: ${Array.from(registeredModules).join(', ')}`);
+    }
+}
+//# sourceMappingURL=plugin-registry.js.map

package/dist/plugin-registry.js.map

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

package/dist/plugin-types.d.ts

@@ -0,0 +1,14 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CplaceApiClient } from './api.js';
+export interface McpPluginModule {
+    register: (server: McpServer, client: CplaceApiClient) => void;
+    toolDefinitions?: Record<string, any>;
+}
+export interface McpPlugin {
+    name: string;
+    version: string;
+    description: string;
+    sourcePath: string;
+    modules: Record<string, McpPluginModule>;
+}
+//# sourceMappingURL=plugin-types.d.ts.map

package/dist/plugin-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../src/plugin-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IAC/D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C"}

package/dist/plugin-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin-types.js.map

package/dist/plugin-types.js.map

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

package/dist/plugins/app-catalog.d.ts

@@ -0,0 +1,6 @@
+export type AppCatalogEntry = {
+    readme: string;
+};
+export type AppCatalog = Record<string, AppCatalogEntry>;
+export declare function loadAppCatalog(dirPath: string): AppCatalog;
+//# sourceMappingURL=app-catalog.d.ts.map

package/dist/plugins/app-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-catalog.d.ts","sourceRoot":"","sources":["../../src/plugins/app-catalog.ts"],"names":[],"mappings":"AAkBA,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAazD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAwC1D"}

package/dist/plugins/app-catalog.js

@@ -0,0 +1,37 @@
+import { readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+export function loadAppCatalog(dirPath) {
+    const catalog = {};
+    try {
+        try {
+            const masterReadme = readFileSync(join(dirPath, 'README.md'), 'utf8');
+            catalog['_catalog'] = { readme: masterReadme };
+        }
+        catch {
+        }
+        try {
+            const investigationPrompt = readFileSync(join(dirPath, 'INVESTIGATION-PROMPT.md'), 'utf8');
+            catalog['_investigationPrompt'] = { readme: investigationPrompt };
+        }
+        catch {
+        }
+        const entries = readdirSync(dirPath, { withFileTypes: true });
+        const appDirs = entries.filter(d => d.isDirectory());
+        for (const dir of appDirs) {
+            const appName = dir.name;
+            const readmePath = join(dirPath, appName, 'README.md');
+            try {
+                const readme = readFileSync(readmePath, 'utf8');
+                catalog[appName] = { readme };
+            }
+            catch (error) {
+                console.error(`Warning: Could not read app catalog entry ${appName}/README.md:`, error);
+            }
+        }
+    }
+    catch (error) {
+        console.error('Warning: Could not load app catalog:', error);
+    }
+    return catalog;
+}
+//# sourceMappingURL=app-catalog.js.map

package/dist/plugins/app-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-catalog.js","sourceRoot":"","sources":["../../src/plugins/app-catalog.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAmB5B,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,OAAO,GAAe,EAAE,CAAC;IAE/B,IAAI,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;YACtE,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;QAET,CAAC;QAGD,IAAI,CAAC;YACH,MAAM,mBAAmB,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,yBAAyB,CAAC,EAAE,MAAM,CAAC,CAAC;YAC3F,OAAO,CAAC,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;QAET,CAAC;QAGD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAErD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;YACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;YAEvD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;gBAChD,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;YAChC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,OAAO,aAAa,EAAE,KAAK,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/plugins/application-settings.d.ts

@@ -0,0 +1,3 @@
+import type { McpPlugin } from '../plugin-types.js';
+export declare const applicationSettingsPlugin: McpPlugin;
+//# sourceMappingURL=application-settings.d.ts.map

package/dist/plugins/application-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-settings.d.ts","sourceRoot":"","sources":["../../src/plugins/application-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AASpD,eAAO,MAAM,yBAAyB,EAAE,SAQvC,CAAC"}

package/dist/plugins/application-settings.js

@@ -0,0 +1,16 @@
+import { PLUGIN_VERSION } from './version.js';
+import { registerExpertSettingsTools, EXPERT_SETTINGS_TOOL_DEFINITIONS } from '../tools/expert-settings.js';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export const applicationSettingsPlugin = {
+    name: 'application-settings',
+    version: PLUGIN_VERSION,
+    description: 'Tenant-wide application settings including expert settings for theming (LESS, SCSS, CSS, JavaScript)',
+    sourcePath: __dirname,
+    modules: {
+        'expert-settings': { register: registerExpertSettingsTools, toolDefinitions: EXPERT_SETTINGS_TOOL_DEFINITIONS },
+    }
+};
+//# sourceMappingURL=application-settings.js.map

package/dist/plugins/application-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-settings.js","sourceRoot":"","sources":["../../src/plugins/application-settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,2BAA2B,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAC5G,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,CAAC,MAAM,yBAAyB,GAAc;IAClD,IAAI,EAAE,sBAAsB;IAC5B,OAAO,EAAE,cAAc;IACvB,WAAW,EAAE,sGAAsG;IACnH,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE;QACP,iBAAiB,EAAE,EAAE,QAAQ,EAAE,2BAA2B,EAAE,eAAe,EAAE,gCAAgC,EAAE;KAChH;CACF,CAAC"}

package/dist/plugins/core-app-catalog/INVESTIGATION-PROMPT.md

@@ -0,0 +1,158 @@
+# App Investigation Prompt
+
+Use this prompt template to investigate cplace apps and document their capabilities.
+
+---
+
+## Workspace Naming Convention
+
+All investigation workspaces use this uniform naming pattern:
+
+```
+[App Investigation] <qualified.name>
+```
+
+**Examples:**
+- `[App Investigation] cf.cplace.meeting`
+- `[App Investigation] cf.cplace.gantt`
+- `[App Investigation] cf.cplace.okr`
+
+This makes investigation workspaces:
+- Easy to identify in the workspace list
+- Easy to clean up later
+- Clearly distinguishable from production workspaces
+
+---
+
+## Prerequisites
+
+Before investigating, you need to know the app's qualified name. To discover available apps:
+
+```
+Use mcp__cplace__cplace_list_workspace_apps with:
+- workspaceId: <any existing workspace>
+- category: "all"
+- responseFormat: "minimal"
+
+This returns all apps (installed and available) with their qualified names.
+```
+
+---
+
+## Generic Investigation Prompt
+
+Replace `<APP_NAME>` and `<APP_QUALIFIED_NAME>` with the target app:
+
+```
+I'm investigating cplace apps to build a catalog for the /building-blocks skill. Read the context in the apps catalog (use cplace_list_apps_catalog MCP tool)
+
+Now investigate the **<APP_NAME>** app (`<APP_QUALIFIED_NAME>`) following this process:
+
+## Step 1: Create Investigation Workspace
+
+Use mcp__cplace__cplace_create_workspace:
+- name: "[App Investigation] <APP_QUALIFIED_NAME>"
+- (no apps - we want a minimal workspace)
+
+Record the workspace ID for subsequent steps.
+
+## Step 2: Check Pre-Installation State
+
+Before installing, document the baseline:
+
+1. Use mcp__cplace__cplace_list_workspace_apps with category="installed" to see what's already there (should be minimal/platform only)
+2. Use mcp__cplace__cplace_list_types to see baseline types
+
+## Step 3: Install the App
+
+Use mcp__cplace__cplace_install_workspace_app:
+- workspaceId: <from step 1>
+- appQualifiedName: "<APP_QUALIFIED_NAME>"
+
+Note: Dependencies auto-install.
+
+## Step 4: Document What Changed
+
+After installation, gather:
+
+1. **Installed Apps** (including dependencies):
+   Use mcp__cplace__cplace_list_workspace_apps with category="installed"
+   → Compare to Step 2 to identify what got auto-installed
+
+2. **Types Provided**:
+   Use mcp__cplace__cplace_list_types
+   → For each NEW type (not in Step 2), get details with:
+   mcp__cplace__cplace_get_type_datamodel with responseFormat="minimal"
+
+3. **Widgets Provided**:
+   Use mcp__cplace__cplace_list_widget_definitions
+   → Filter results where requiredApp matches "<APP_QUALIFIED_NAME>"
+
+## Step 5: Create Documentation
+
+Create folder and README:
+   ai-builder/apps/<APP_QUALIFIED_NAME>/
+   └── README.md
+
+Follow the template structure from ai-builder/apps/README.md
+
+## Step 6: Update Tracking
+
+Update ai-builder/apps/README.md to mark <APP_NAME> as complete.
+
+## Step 7: Cleanup (Optional)
+
+The investigation workspace can be kept for reference or deleted.
+The `[App Investigation]` prefix makes these workspaces easy to find and clean up later.
+```
+
+---
+
+## Example: Investigating the Meeting App
+
+```
+I'm investigating cplace apps to build a catalog for the /building-blocks skill. Read the context in the apps catalog (use cplace_list_apps_catalog MCP tool)
+
+Now investigate the **Meeting** app (`cf.cplace.meeting`) following this process:
+
+## Step 1: Create Investigation Workspace
+
+Use mcp__cplace__cplace_create_workspace:
+- name: "[App Investigation] cf.cplace.meeting"
+
+Record the workspace ID for subsequent steps.
+
+## Step 2: Check Pre-Installation State
+...
+(continue with steps 2-7 as above)
+```
+
+---
+
+## Apps Pending Investigation
+
+See [README.md](./README.md) for the full categorized list of 70+ available apps.
+
+**Recommended investigation order:**
+
+1. **Start with `cf.cplace.platform`** - understand the baseline (always installed)
+2. **Core building blocks** - Board, Meetings, Forms Wizard, Item List
+3. **Project planning family** - Basic → Extended → Schedule Mgmt → New Gantt
+4. **UI/Navigation** - Tile Navigation, Breadcrumbs, Landing Page
+5. **Specialized** - as needed for specific use cases
+
+---
+
+## Tips for Investigation
+
+1. **Run Steps 2-4 in parallel where possible** - use sub-agents for concurrent API calls
+
+2. **Platform types are always present** - focus on types that are NEW after app installation
+
+3. **Widget filtering** - the `cplace_list_widget_definitions` returns ALL widgets; filter by `requiredApp` to find app-specific widgets
+
+4. **Dependencies matter** - document what auto-installs, as this affects workspace complexity
+
+5. **Keep investigation workspaces** - they're useful for verifying documentation accuracy later
+
+6. **Bulk cleanup** - search for workspaces starting with `[App Investigation]` to find all investigation workspaces

package/dist/plugins/core-app-catalog/README.md

@@ -0,0 +1,174 @@
+# cplace Apps Investigation
+
+## Context
+
+This directory contains investigations of cplace Apps. The goal is to document what each app provides (types, attributes, widgets) so that the `/building-blocks` skill can intelligently select appropriate apps based on requirements.
+
+## Goal
+
+**Primary Objective:** Create a catalog of apps that documents:
+- What types each app provides
+- What attributes are on those types
+- What widgets the app makes available
+- What dependencies the app has (and what gets auto-installed)
+
+**Usage:** The `/building-blocks` skill uses this catalog to:
+1. Match requirements to app capabilities
+2. Select appropriate apps for a workspace
+3. Understand what functionality comes "for free" with each app
+
+## Investigation Approach
+
+Unlike PPM modules (which come with pre-configured workspaces), Apps are installed INTO workspaces. The investigation process is:
+
+1. **Create a fresh workspace** - minimal setup, no apps
+2. **Install the target app** - dependencies auto-install
+3. **Document what the app provides**:
+   - Types and their attributes
+   - Widgets (filtered by `requiredApp`)
+   - Dependencies that got pulled in
+4. **Clean up** - optionally delete the investigation workspace
+
+See [INVESTIGATION-PROMPT.md](./INVESTIGATION-PROMPT.md) for the detailed process.
+
+## Apps to Investigate
+
+### Priority: High (Core Building Blocks)
+
+| App | Qualified Name | Status | Notes |
+|-----|----------------|--------|-------|
+| cplace Basis | `cf.cplace.platform` | **Complete** | Base platform, always installed |
+| Board | `cf.cplace.cboard.main` | **Complete** | Kanban-style boards |
+| Meetings | `cf.cplace.meeting` | Complete | Appointments and minutes |
+| Forms Wizard | `cf.cplace.formsWizard` | **Complete** | Multi-step input wizards |
+| Item List | `cf.cplace.itemList` | **Complete** | Task/decision tracking |
+
+### Priority: High (Project Planning)
+
+| App | Qualified Name | Status | Notes |
+|-----|----------------|--------|-------|
+| Project Planning (Basic) | `cf.cplace.projektplanung.projektplanungBasic` | **Complete** | Basic Gantt |
+| Project Planning (Extended) | `cf.cplace.projektplanung.projektplanungExtended` | **Complete** | Advanced scheduling |
+| Schedule Mgmt. (Basic) | `cf.cplace.projectPlanning.app.basic.basicScheduleManagement` | **Complete** | Schedule, Task, Milestone types |
+| Schedule Mgmt. (Advanced) | `cf.cplace.projectPlanning.app.advanced.advancedScheduleManagement` | **Complete** | Collaboration features |
+| New Gantt | `cf.cplace.projectPlanning.app.gantt2.gantt2` | **Complete** | New Gantt widget (no types, widget only) |
+| Project Structure | `cf.cplace.projectTree` | Pending | Project hierarchy |
+| Task Classes | `cf.cplace.projektplanungMasterData` | **Complete** | Visual categorization |
+| Building Blocks | `cf.cplace.buildingBlockSchedule` | **Complete** | Reusable schedule templates |
+
+### Priority: Medium (Resource & Time)
+
+| App | Qualified Name | Status | Notes |
+|-----|----------------|--------|-------|
+| Resource Management | `cf.cplace.resourceManagement` | **Complete** | Resource planning |
+| Resource Management: Charts | `cf.cplace.resourceManagement.resourceManagementChart` | **Complete** | Visualization |
+| Timebooking | `cf.cplace.ctts.main` | **Complete** | Time tracking (5 widgets, no types) |
+| Project Planning Calendar | `cf.cplace.projektplanungCalendar` | **Complete** | Non-working days (singleton app, 2 types) |
+| Timeline Process | `cf.cplace.timelineProcess` | **Complete** | Process aligned to dates (3 types, no widgets) |
+
+### Priority: Medium (UI & Navigation)
+
+| App | Qualified Name | Status | Notes |
+|-----|----------------|--------|-------|
+| Tile Navigation | `cf.cplace.navigationTileWidget` | **Complete** | Page-to-page navigation (widget only, no types) |
+| Breadcrumbs | `cf.cplace.breadcrumbs` | **Complete** | Hierarchical path display (widget only, no types) |
+| Drag and Drop List | `cf.cplace.draggablePageList` | **Complete** | Sortable lists (widget only, no types) |
+| Tree-structure Table | `cf.cplace.treeTableWidget` | **Complete** | Hierarchical tables (widget only, no types) |
+| Landing Page | `cf.cplace.landingPage` | **Complete** | Custom start pages (4 types, no widgets) |
+| QR Code | `cf.cplace.qrCodeWidget` | **Complete** | QR code widget (widget only, no types) |
+
+### Priority: Medium (Export & Reports)
+
+| App | Qualified Name | Status | Notes |
+|-----|----------------|--------|-------|
+| Presentation Graphic | `cf.cplace.pptexport` | **Complete** | Schedule export (1 type, 1 widget) |
+| Printing Schedules | `cf.cplace.pptexport.print` | **Complete** | Print profile storage for schedule exports |
+| cplace Office Reports | `cf.cplace.officeReports` | **Complete** | Office document generation (1 type, 3 widgets) |
+| cplace Report Generation | `cf.cplace.officeReports.cplaceReportGeneration` | **Complete** | Report download widget (1 widget, no types) |
+
+### Priority: Low (Specialized)
+
+| App | Qualified Name | Status | Notes |
+|-----|----------------|--------|-------|
+| Organizational Structure | `cf.cplace.orgaTree` | Pending | Org tree management |
+| Visual Domain Model | `cf.cplace.visualDomainModel` | Pending | Data model visualization |
+| Attribute Dependencies | `cf.cplace.attributeDependencies` | Pending | Conditional attributes |
+| cplace Calendar | `cf.cplace.simpleCalendar` | Pending | Calendar display |
+| Jira Connector | `cf.cplace.jira.connector.jiraConnector` | Pending | Jira integration |
+| REST-API Configuration | `cf.cplace.rest.config` | **Complete** | No-code REST APIs (config types only, no widgets) |
+| Low-Code REST-API | `cf.cplace.rest.lowcode` | Pending | Low-code REST endpoints |
+| Low-Code Job Scheduler | `cf.cplace.lowcodeJobScheduler` | Pending | Scheduled jobs |
+| Citizen AI | `cf.cplace.lowcode.ai` | Pending | AI assistant |
+| Generic Interface | `cf.cplace.genericInterface.api.genericInterface` | Pending | Data import/export |
+
+### Not for Investigation (Internal/Test)
+
+| App | Qualified Name | Notes |
+|-----|----------------|-------|
+| Solution Management Test App | `cf.cplace.platform.solutionmanagement.*` | Internal testing only |
+| Various dependency apps | `*becomeWriter*`, `*restrictedDeputyAccess*` | Helper apps, auto-installed |
+
+*Full list obtained via `cplace_list_workspace_apps` with `category='all'` on 2026-02-02.*
+
+## Directory Structure
+
+Each investigated app gets its own folder named by qualified name:
+
+```
+apps/
+├── README.md                    # This file
+├── INVESTIGATION-PROMPT.md      # How to investigate new apps
+├── cf.cplace.platform/          # Platform base app
+│   └── README.md                # Types, attributes, widgets
+├── cf.cplace.meeting/           # Meeting app
+│   └── README.md
+├── cf.cplace.itemList/          # Item List app
+│   └── README.md
+├── cf.cplace.formsWizard/       # Forms Wizard app
+│   └── README.md
+└── ...
+```
+
+## Document Template
+
+Each app's README.md follows this structure:
+
+```markdown
+# App Name (qualified.name)
+
+## Overview
+Brief description of what the app provides.
+
+## Dependencies
+- List of apps that auto-install with this one
+
+## Types Provided
+
+### type.name.one
+| Attribute | Type | Description |
+|-----------|------|-------------|
+| attr1 | String | ... |
+| attr2 | Reference | ... |
+
+### type.name.two
+...
+
+## Widgets Provided
+| Widget | Description | Use Case |
+|--------|-------------|----------|
+| widget.name | ... | ... |
+
+## Usage Notes
+When to use this app, common patterns, etc.
+```
+
+## Relationship to PPM Modules
+
+| Aspect | Apps | PPM Modules |
+|--------|------|-------------|
+| **Granularity** | Building blocks (types, widgets) | Complete solutions (workspaces, pages, layouts) |
+| **Installation** | Into existing workspace | Creates entire workspace structure |
+| **Documentation** | One file per app | One file per workspace |
+| **Selection** | Based on needed types/widgets | Based on business domain |
+
+Both are "building blocks" for the `/building-blocks` skill, but at different levels of abstraction.

package/dist/plugins/core-app-catalog/cf.cplace.breadcrumbs/README.md

@@ -0,0 +1,74 @@
+# Breadcrumbs (cf.cplace.breadcrumbs)
+
+## Overview
+
+The Breadcrumbs app provides a simple navigation widget that displays the hierarchical path from the current page to the workspace home page. This enables users to understand their location within the workspace hierarchy and quickly navigate to parent pages.
+
+**Key Characteristics:**
+- Widget-only app (no custom types)
+- No dependencies beyond the base platform
+- Lightweight navigation enhancement
+
+## Dependencies
+
+| App | Qualified Name | Notes |
+|-----|----------------|-------|
+| cplace Basis | `cf.cplace.platform` | Always installed (base platform) |
+
+The Breadcrumbs app has no additional dependencies - it only requires the base cplace platform.
+
+## Types Provided
+
+**None** - This app does not provide any custom types. It is purely a UI widget app.
+
+## Widgets Provided
+
+| Widget | Kind | Description | Use Case |
+|--------|------|-------------|----------|
+| Breadcrumbs | `cf.cplace.breadcrumbs.breadcrumbsWidget` | Shows the hierarchical path to the workspace home page as clickable links | Navigation context and quick parent-page access |
+
+### Widget Details: Breadcrumbs
+
+**Widget Kind:** `cf.cplace.breadcrumbs.breadcrumbsWidget`
+
+**Description:** Displays clickable breadcrumb links showing the page hierarchy from the current page up to the workspace root. Users can click any ancestor page to navigate directly to it.
+
+**Configuration:** The widget has minimal configuration - it automatically detects the page hierarchy based on the page's parent-child relationships.
+
+**Typical Placement:** Top of page layouts, often spanning the full width, to provide persistent navigation context.
+
+## Usage Notes
+
+### When to Use
+
+- **Deep hierarchies**: When workspaces have multiple levels of nested pages and users need orientation
+- **Consistent navigation**: When you want users to always see their location in the workspace structure
+- **Quick parent access**: When users frequently need to navigate back to parent pages
+
+### When NOT to Use
+
+- **Flat workspaces**: Workspaces with only one or two levels of hierarchy gain little benefit
+- **Alternative navigation**: If tile navigation or tree widgets already provide sufficient navigation
+- **Minimal layouts**: When screen space is at a premium and the workspace structure is obvious
+
+### Best Practices
+
+1. **Placement**: Add breadcrumbs at the top of type layouts, typically in the first row
+2. **Width**: Use full-width (span all columns) for visual prominence
+3. **Consistency**: Apply to all types in a workspace for consistent user experience
+4. **Combine with title**: Often paired with a Simple Headline widget below it
+
+### Example Layout Pattern
+
+```
+Row 1: [Breadcrumbs - full width]
+Row 2: [Simple Headline - full width]
+Row 3: [Grouped Attributes] [Other widgets...]
+```
+
+## Investigation Metadata
+
+- **Investigated on:** 2026-02-02
+- **Investigation workspace:** `[App Investigation] cf.cplace.breadcrumbs` (ID: ny3wpq790k80pt8qd4hh6pvwt)
+- **Pre-installation baseline:** Only `cf.cplace.platform` with `default.page` and `default.file` types
+- **Post-installation changes:** Added Breadcrumbs app with one widget, no new types