nowaikit 2.6.0 → 3.0.0

package/dist/prompts/capabilities/build-uib.js

@@ -0,0 +1,309 @@
+const capability = {
+    name: 'build-uib',
+    title: 'Build UI Builder Component',
+    description: 'Guided UI Builder component creation — macroponents, data sources, responsive layouts, Next Experience',
+    category: 'build',
+    arguments: [
+        {
+            name: 'description',
+            description: 'what the component should do in plain language',
+            required: true,
+        },
+        {
+            name: 'component_type',
+            description: 'page, macroponent, data_resource. Default: macroponent',
+            required: false,
+        },
+    ],
+    recommendedTools: [
+        'query_records',
+        'list_uib_pages',
+        'get_uib_page',
+        'create_uib_page',
+        'create_uib_component',
+        'list_uib_components',
+        'list_uib_data_brokers',
+        'create_uib_data_broker',
+    ],
+    buildPrompt(args = {}) {
+        const desc = args.description ?? '<not provided>';
+        const componentType = args.component_type ?? 'macroponent';
+        return [
+            {
+                role: 'assistant',
+                content: {
+                    type: 'text',
+                    text: [
+                        '# Capability: Build UI Builder Component (Next Experience)',
+                        '',
+                        '## UI Builder Architecture — Platform Knowledge',
+                        '',
+                        '### Core Concepts',
+                        '- **UI Builder (UIB):** the declarative page builder for Next Experience (workspace, configurable workspace, app shell). Replaces Service Portal for new development.',
+                        '- **Next Experience:** ServiceNow\'s modern UI framework built on web components (not AngularJS). Uses the Seismic framework (`@seismic/core`).',
+                        '- **Now Experience Design System (NEDS):** ServiceNow\'s component library providing consistent, accessible, themeable components (now-button, now-input, now-heading, now-card, now-modal, etc.).',
+                        '',
+                        '### Component Hierarchy',
+                        '- **UX Application:** top-level container that defines a workspace or portal experience. Contains pages and navigation.',
+                        '- **Page:** a routable view within a UX Application. Composed of layout containers, macroponents, and components.',
+                        '- **Macroponent:** a composite component that bundles child components, data resources, event handlers, and layout. The primary reusable building block.',
+                        '- **Component:** a single Now Experience web component (NEDS component or custom). The atomic UI unit.',
+                        '- **Data Resource:** provides data to components. Types: REST, GraphQL, Script, Transform.',
+                        '',
+                        '### Macroponent Architecture',
+                        '- **Composition:** a macroponent arranges child components in a layout tree. Each child is a reference to a base component (NEDS or custom) with configured properties.',
+                        '- **Properties:** typed inputs that page designers configure. Types: string, number, boolean, object, array, json, choice, reference, glide_object.',
+                        '- **Internal state:** managed via `updateState` and `state` in component actions. State is private to the macroponent instance.',
+                        '- **Data Resources:** bound to properties via data binding expressions. When data changes, bound properties update automatically.',
+                        '- **Event Handlers:** respond to events dispatched by child components. Can trigger component actions, data resource refreshes, or dispatch events upward.',
+                        '- **Component Actions:** JavaScript functions that execute logic, update state, or interact with data resources.',
+                        '',
+                        '### @seismic/core Framework',
+                        '- **`createCustomElement`:** defines a custom web component with lifecycle hooks.',
+                        '- **`dispatch`:** emit custom events from a component to its parent macroponent or page.',
+                        '- **`updateState`:** update internal component state, triggering a re-render.',
+                        '- **`actionHandlers`:** define named actions that can be triggered by event handlers in the macroponent.',
+                        '- **Lifecycle hooks:** `connected` (element added to DOM), `disconnected` (removed from DOM), `propertyChanged` (a property value changed).',
+                        '- **`state` and `properties`:** state is internal/mutable; properties are external/immutable (set by parent).',
+                        '',
+                        '### Data Resources',
+                        '- **REST:** call a ServiceNow REST API (Table API, Import Set API, custom Scripted REST) or external API. Configure URL, method, headers, query params, body. Supports pagination.',
+                        '- **GraphQL:** query the ServiceNow GraphQL API for efficient, typed data retrieval. Define query, variables, and field mappings.',
+                        '- **Script:** server-side GlideRecord/GlideQuery script that returns data. Most flexible, but less cacheable. Runs in a scoped script environment.',
+                        '- **Transform:** take output from another data resource and transform/filter/map it client-side.',
+                        '- **Binding:** data resource outputs bind to component properties via `@data.resourceName.output.fieldName`.',
+                        '- **Refresh triggers:** data resources can be configured to refresh on events, intervals, or page parameter changes.',
+                        '',
+                        '### Layout System',
+                        '- UIB uses a **responsive grid** system with configurable breakpoints.',
+                        '- Layout containers: `now-container`, `now-row`, `now-col` for grid-based layouts.',
+                        '- **CSS Grid and Flexbox** are supported via custom CSS on macroponents.',
+                        '- **Breakpoint-aware properties:** set different property values per breakpoint (mobile, tablet, desktop) for responsive behavior.',
+                        '- Use **layout variants** to define different compositions for different screen sizes.',
+                        '',
+                        '### Theming',
+                        '- UIB supports **theme inheritance** — components inherit theme variables from the UX Application.',
+                        '- Use NEDS CSS custom properties (e.g., `--now-color--primary-1`, `--now-font-size--md`) for consistent theming.',
+                        '- Custom CSS should reference theme variables, not hardcoded values.',
+                        '- Dark mode support is built-in when using NEDS variables.',
+                        '',
+                        '### Accessibility (A11y)',
+                        '- NEDS components are **WCAG 2.1 AA compliant** out of the box.',
+                        '- Custom macroponents must maintain accessibility: ARIA roles, labels, live regions, keyboard navigation.',
+                        '- Use `role`, `aria-label`, `aria-labelledby`, `aria-describedby`, `aria-live` on custom containers.',
+                        '- Ensure keyboard focus management: `tabindex`, focus trapping in modals, skip navigation links.',
+                        '- Use semantic HTML structure (headings hierarchy, landmarks).',
+                        '- Screen reader testing: verify all dynamic content changes are announced.',
+                        '',
+                        '### Event System',
+                        '- Components dispatch events via `dispatch(eventName, payload)`.',
+                        '- Macroponents handle events via event handler mappings: `event → action`.',
+                        '- Events can propagate upward: component → macroponent → page → UX App.',
+                        '- Standard events: `NOW_RECORD#SELECTED`, `NOW_MODAL#OPENED`, `NOW_BUTTON#CLICKED`, etc.',
+                        '- Custom events: define with clear naming convention `[SCOPE]_[COMPONENT]#[ACTION]`.',
+                        '',
+                        '### Performance Considerations',
+                        '- Minimize data resource calls — use GraphQL for efficient field selection.',
+                        '- Avoid unnecessary re-renders — use `shouldComponentUpdate` logic in action handlers.',
+                        '- Lazy-load macroponents that are not immediately visible.',
+                        '- Use data resource caching (TTL) for infrequently changing data.',
+                        '- Keep component tree depth shallow for faster rendering.',
+                        '',
+                        '---',
+                        '',
+                        `Starting UIB component build for: **${desc}**`,
+                        `Component type: **${componentType}**`,
+                    ].join('\n'),
+                },
+            },
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: [
+                        `Build a UI Builder component for the following requirement:`,
+                        `**Requirement:** ${desc}`,
+                        `**Component type:** ${componentType}`,
+                        '',
+                        'Follow these steps exactly:',
+                        '',
+                        '### Step 1 — Understand the Requirement',
+                        'Parse the requirement and determine:',
+                        `- **Component type:** ${componentType}. Validate this is appropriate:`,
+                        '  - **Page:** a full routable view (list page, record page, dashboard). Use when building a complete screen.',
+                        '  - **Macroponent:** a reusable composite component (data table with filters, form section, card collection). Use for reusable building blocks.',
+                        '  - **Data Resource:** a data-fetching component (REST, GraphQL, Script). Use when the primary need is data access logic.',
+                        '  If the chosen type is not appropriate, recommend the correct type and explain why.',
+                        '- **Data needs:** what tables/APIs provide the data. Identify data sources and their output shape.',
+                        '- **User interaction:** what actions the user performs (select, filter, create, edit, navigate, approve).',
+                        '- **Responsive requirements:** how the component behaves on desktop vs tablet vs mobile.',
+                        '',
+                        '### Step 2 — Check Existing UIB Components for Reuse',
+                        'Use **list_uib_pages** and **list_uib_components** to find existing components with similar functionality:',
+                        '- Check NEDS components first — many common patterns (tables, forms, cards, modals) already exist.',
+                        '- Check custom macroponents in the instance for domain-specific components.',
+                        '- If a suitable component exists, recommend composing with it rather than building from scratch.',
+                        '',
+                        '### Step 3 — Design Component Architecture',
+                        'Plan the full component structure before building:',
+                        '',
+                        '```',
+                        `COMPONENT: [Name] (${componentType})`,
+                        '  PROPERTIES (configurable inputs):',
+                        '    - propertyName: type — description (default value)',
+                        '  ',
+                        '  DATA RESOURCES:',
+                        '    - resourceName: [REST|GraphQL|Script]',
+                        '      Source: [API/table/script details]',
+                        '      Output shape: { field: type, ... }',
+                        '      Refresh: [event|interval|manual]',
+                        '  ',
+                        '  CHILD COMPONENTS:',
+                        '    - now-heading: bound to data.title',
+                        '    - now-card (repeated): bound to data.items[]',
+                        '    - now-button: dispatches CUSTOM#ACTION',
+                        '  ',
+                        '  EVENT HANDLERS:',
+                        '    - CHILD_EVENT → actionName → [update state | refresh data | dispatch parent event]',
+                        '  ',
+                        '  COMPONENT ACTIONS:',
+                        '    - actionName(payload): [logic description]',
+                        '  ',
+                        '  LAYOUT:',
+                        '    - Desktop: [grid/flex description]',
+                        '    - Tablet: [adaptations]',
+                        '    - Mobile: [adaptations]',
+                        '```',
+                        '',
+                        '### Step 4 — Define Data Sources',
+                        'For each data resource the component needs:',
+                        '',
+                        '**REST Data Resource:**',
+                        '- API endpoint (Table API path, Scripted REST endpoint, or external URL).',
+                        '- HTTP method, headers, query parameters.',
+                        '- Request body template (for POST/PUT).',
+                        '- Response mapping: which fields from the response map to output properties.',
+                        '- Pagination configuration (limit, offset parameters).',
+                        '',
+                        '**GraphQL Data Resource:**',
+                        '- GraphQL query string with variables.',
+                        '- Variable bindings from component properties.',
+                        '- Field selection (only request what the template needs).',
+                        '',
+                        '**Script Data Resource:**',
+                        '- Server-side script using GlideRecord/GlideQuery.',
+                        '- Input parameters from component properties.',
+                        '- Output object shape.',
+                        '- Error handling and fallback data.',
+                        '',
+                        'Use **create_uib_data_broker** for each data resource. Bind outputs to component properties using `@data.resourceName.output.fieldName`.',
+                        '',
+                        '### Step 5 — Build Responsive Layout',
+                        'Design the layout for all breakpoints:',
+                        '',
+                        '**Desktop (>= 1200px):**',
+                        '- Full layout with sidebars, multi-column grids.',
+                        '- All interactive elements visible.',
+                        '',
+                        '**Tablet (768px - 1199px):**',
+                        '- Reduce columns (3-col → 2-col).',
+                        '- Collapse secondary sidebars into expandable panels.',
+                        '',
+                        '**Mobile (< 768px):**',
+                        '- Single-column stacked layout.',
+                        '- Collapse complex tables into card lists.',
+                        '- Touch-friendly tap targets (min 44x44px).',
+                        '',
+                        'Use NEDS layout components (`now-container`, `now-row`, `now-col`) with breakpoint-aware properties. Set different values per breakpoint for properties like `columns`, `gap`, `visibility`.',
+                        '',
+                        '### Step 6 — Implement Client-Side Logic',
+                        'Write component actions using @seismic/core patterns:',
+                        '',
+                        '**Action Handlers:**',
+                        '```javascript',
+                        'actionHandlers: {',
+                        '  HANDLE_ITEM_CLICK: ({ action, state, updateState, dispatch }) => {',
+                        '    const { payload } = action;',
+                        '    updateState({ selectedItem: payload.item });',
+                        '    dispatch("ITEM_SELECTED", { sys_id: payload.item.sys_id });',
+                        '  },',
+                        '  HANDLE_FILTER_CHANGE: ({ action, state, updateState }) => {',
+                        '    updateState({ filterValue: action.payload.value, page: 1 });',
+                        '    // Data resource bound to state.filterValue will auto-refresh',
+                        '  },',
+                        '  HANDLE_DATA_LOADED: ({ action, updateState }) => {',
+                        '    updateState({ items: action.payload.result, loading: false });',
+                        '  },',
+                        '  HANDLE_ERROR: ({ action, updateState }) => {',
+                        '    updateState({ error: action.payload.message, loading: false });',
+                        '  },',
+                        '}',
+                        '```',
+                        '',
+                        '**Event Handler Mappings (macroponent config):**',
+                        '- Map child component events to action handlers.',
+                        '- Map data resource events (success, error) to action handlers.',
+                        '- Map page-level events (parameter changes, navigation) to action handlers.',
+                        '',
+                        '**State Management:**',
+                        '- Keep state minimal — derive computed values in actions, not state.',
+                        '- Use `updateState` for batched state updates (single re-render).',
+                        '- Avoid storing data resource output in state unless transformation is needed.',
+                        '',
+                        '### Step 7 — Accessibility Review',
+                        'Verify the component meets WCAG 2.1 AA:',
+                        '- **ARIA roles:** containers have appropriate landmark roles (`main`, `navigation`, `region`, `complementary`).',
+                        '- **ARIA labels:** all interactive elements have `aria-label` or `aria-labelledby`.',
+                        '- **Keyboard navigation:** all interactive elements are reachable via Tab. Enter/Space activate buttons. Escape closes modals.',
+                        '- **Focus management:** after data loads or view changes, focus moves to the appropriate element. Modals trap focus.',
+                        '- **Screen reader:** dynamic content changes use `aria-live="polite"` regions. Loading states are announced.',
+                        '- **Color contrast:** text meets 4.5:1 contrast ratio against background (NEDS handles this when using theme variables).',
+                        '- **Heading hierarchy:** use proper heading levels (h1 → h2 → h3) without skipping.',
+                        '',
+                        '### Step 8 — Create the Component',
+                        `Use the appropriate tool to create the ${componentType}:`,
+                        '',
+                        componentType === 'page'
+                            ? [
+                                '- Use **create_uib_page** with:',
+                                '  - Page title and route path.',
+                                '  - Layout definition with containers, rows, columns.',
+                                '  - Macroponent/component instances in each layout slot.',
+                                '  - Data resource bindings.',
+                                '  - Page-level event handlers.',
+                            ].join('\n')
+                            : componentType === 'data_resource'
+                                ? [
+                                    '- Use **create_uib_data_broker** with:',
+                                    '  - Resource type (REST, GraphQL, Script).',
+                                    '  - Configuration (endpoint, query, script).',
+                                    '  - Input parameter definitions.',
+                                    '  - Output schema.',
+                                    '  - Caching and refresh configuration.',
+                                ].join('\n')
+                                : [
+                                    '- Use **create_uib_component** with:',
+                                    '  - Macroponent name and description.',
+                                    '  - Property definitions (name, type, default, description).',
+                                    '  - Child component composition tree.',
+                                    '  - Data resource definitions and bindings.',
+                                    '  - Event handler mappings.',
+                                    '  - Component actions (JavaScript).',
+                                    '  - CSS/SCSS for layout and styling.',
+                                ].join('\n'),
+                        '',
+                        'Report the sys_id of the created component.',
+                        '',
+                        'Provide deployment guidance:',
+                        '1. How to add the component to a UIB page.',
+                        '2. Which properties need to be configured by the page designer.',
+                        '3. Which data resources need to be connected.',
+                        '4. Any workspace or UX App configuration needed.',
+                    ].join('\n'),
+                },
+            },
+        ];
+    },
+};
+export default capability;
+//# sourceMappingURL=build-uib.js.map

package/dist/prompts/capabilities/build-uib.js.map

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

package/dist/prompts/capabilities/docs-app.d.ts

@@ -0,0 +1,4 @@
+import type { CapabilityDefinition } from '../types.js';
+declare const capability: CapabilityDefinition;
+export default capability;
+//# sourceMappingURL=docs-app.d.ts.map

package/dist/prompts/capabilities/docs-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-app.d.ts","sourceRoot":"","sources":["../../../src/prompts/capabilities/docs-app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,QAAA,MAAM,UAAU,EAAE,oBA4OjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/prompts/capabilities/docs-app.js

@@ -0,0 +1,234 @@
+const capability = {
+    name: 'docs-app',
+    title: 'Document Application',
+    description: 'Auto-generate comprehensive documentation for a scoped application — tables, scripts, flows, ACLs, catalog items, and architecture',
+    category: 'docs',
+    arguments: [
+        {
+            name: 'app',
+            description: 'scoped app name or scope prefix e.g. x_myco_app',
+            required: true,
+        },
+    ],
+    recommendedTools: [
+        'get_scoped_app',
+        'query_records',
+        'get_table_schema',
+        'list_business_rules',
+        'list_script_includes',
+        'list_client_scripts',
+        'list_ui_policies',
+        'list_ui_actions',
+        'list_acls',
+        'list_flows',
+        'list_catalog_items',
+    ],
+    buildPrompt(args) {
+        const app = args?.app ?? 'Document the application';
+        return [
+            {
+                role: 'assistant',
+                content: {
+                    type: 'text',
+                    text: [
+                        '# Capability: Document Application',
+                        '',
+                        'I am a **ServiceNow application documentation specialist**. I generate comprehensive',
+                        'documentation for a scoped application by discovering and documenting every artifact type.',
+                        '',
+                        '## Documentation Sections',
+                        '',
+                        '### 1. Application Overview',
+                        '',
+                        'Use `get_scoped_app` and `query_records` on `sys_scope` to gather:',
+                        '- Application name, scope (e.g. `x_myco_app`)',
+                        '- Version, vendor, description',
+                        '- License model and entitlements',
+                        '- Dependencies on other apps/plugins',
+                        '- Application menus and modules',
+                        '',
+                        '### 2. Data Model',
+                        '',
+                        'Use `get_table_schema` and `query_records` on `sys_db_object`, `sys_dictionary`, `sys_relationship`:',
+                        '',
+                        'For each table in the app scope:',
+                        '- **Table definition** — name, label, extends, access controls',
+                        '- **Fields** — name, type, max length, mandatory, default value, reference target',
+                        '- **Relationships** — parent-child, reference, many-to-many',
+                        '- **Indexes** — indexed fields and composite indexes',
+                        '- **Number prefix** — auto-number configuration',
+                        '- **Table hierarchy** — inheritance chain and extended tables',
+                        '',
+                        'Output: ER diagram description and field-level detail tables',
+                        '',
+                        '### 3. Server-Side Logic',
+                        '',
+                        '#### Business Rules',
+                        'Use `list_business_rules` filtered by app scope:',
+                        '- Table, when (before/after/async/display), order',
+                        '- Filter conditions and role conditions',
+                        '- Insert/update/delete/query operations',
+                        '- Script summary — what it does in plain language',
+                        '- Active/inactive status',
+                        '',
+                        '#### Script Includes',
+                        'Use `list_script_includes` filtered by app scope:',
+                        '- Name, API name (scope.ClassName)',
+                        '- Client callable (true/false)',
+                        '- Methods and their purposes',
+                        '- Dependencies on other script includes',
+                        '- Extends/implements relationships',
+                        '',
+                        '#### Fix Scripts',
+                        'Use `query_records` on `sys_script_fix`:',
+                        '- Name, description, run count',
+                        '- What data it modifies',
+                        '- When it should be run (install, upgrade, manual)',
+                        '',
+                        '#### Scheduled Jobs',
+                        'Use `query_records` on `sysauto_script`:',
+                        '- Name, schedule/frequency, run-as user',
+                        '- What it does, tables affected',
+                        '- Active/inactive, last run status',
+                        '',
+                        '### 4. Client-Side Logic',
+                        '',
+                        '#### Client Scripts',
+                        'Use `list_client_scripts` filtered by app scope:',
+                        '- Type (onChange, onLoad, onSubmit, onCellEdit)',
+                        '- Table and field (for onChange)',
+                        '- What it does — UI behavior, validations, field manipulation',
+                        '- Global vs. scoped',
+                        '',
+                        '#### UI Policies',
+                        'Use `list_ui_policies` filtered by app scope:',
+                        '- Table, order, conditions',
+                        '- Actions: mandatory, visible, read-only (for which fields)',
+                        '- Script actions (if any)',
+                        '- Reverse if false behavior',
+                        '',
+                        '#### UI Actions',
+                        'Use `list_ui_actions` filtered by app scope:',
+                        '- Table, name, label, action type (form button, list button, link)',
+                        '- Client/server script behavior',
+                        '- Conditions and role requirements',
+                        '',
+                        '### 5. Security Model',
+                        '',
+                        '#### Roles',
+                        'Use `query_records` on `sys_user_role`:',
+                        '- Role names and descriptions',
+                        '- Role hierarchy (contains/contained by)',
+                        '- Application-specific roles vs. inherited platform roles',
+                        '',
+                        '#### ACLs',
+                        'Use `list_acls` filtered by app scope:',
+                        '- **Table-level ACLs** — read, write, create, delete per role',
+                        '- **Field-level ACLs** — restricted fields and who can access them',
+                        '- **Row-level ACLs** — conditional access based on record values',
+                        '- Advanced scripts in ACLs',
+                        '- ACL evaluation order',
+                        '',
+                        '#### Data Policies',
+                        'Use `query_records` on `sys_data_policy2`:',
+                        '- Read-only fields, mandatory fields (enforced at database level)',
+                        '- Conditions under which policies apply',
+                        '',
+                        '### 6. Flows & Automation',
+                        '',
+                        'Use `list_flows` and `query_records` on flow-related tables:',
+                        '- **Flows** — trigger type, trigger conditions, actions, subflow calls',
+                        '- **Subflows** — inputs/outputs, reusable logic',
+                        '- **Actions** — custom flow actions in the app scope',
+                        '- **Workflows (legacy)** — if any classic workflows exist',
+                        '',
+                        '### 7. Service Catalog',
+                        '',
+                        'Use `list_catalog_items` and `query_records`:',
+                        '- **Catalog items** — name, category, description, price',
+                        '- **Variables** — variable sets, types, mandatory, reference qualifiers',
+                        '- **Variable sets** — reusable variable groups',
+                        '- **Approval rules** — who approves, conditions, stages',
+                        '- **Fulfillment** — workflow/flow that processes the request',
+                        '- **Order guides** — multi-item ordering configurations',
+                        '',
+                        '### 8. Integrations',
+                        '',
+                        '#### REST Messages',
+                        'Use `query_records` on `sys_rest_message`, `sys_rest_message_fn`:',
+                        '- Outbound REST endpoints, methods, authentication',
+                        '- Request/response format, headers',
+                        '',
+                        '#### Scripted REST APIs',
+                        'Use `query_records` on `sys_ws_definition`, `sys_ws_operation`:',
+                        '- Inbound API resources, methods, ACLs',
+                        '- Request/response format',
+                        '',
+                        '#### Transform Maps',
+                        'Use `query_records` on `sys_transform_map`, `sys_transform_entry`:',
+                        '- Source-to-target field mappings',
+                        '- Transform scripts and conditions',
+                        '',
+                        '#### Import Sets',
+                        'Use `query_records` on `sys_data_source`:',
+                        '- Data sources, type (file, JDBC, REST, etc.)',
+                        '- Scheduled imports and frequency',
+                        '',
+                        '### 9. Portal',
+                        '',
+                        'Use `query_records` on portal-related tables:',
+                        '- **Widgets** — name, template (HTML), client script, server script, CSS',
+                        '- **Pages** — URL, layout, widget instances',
+                        '- **Angular providers** — services, factories',
+                        '- **Portal themes** — branding, CSS variables',
+                        '',
+                        '### 10. Notifications',
+                        '',
+                        'Use `query_records` on `sysevent_email_action`, `sysevent_email_template`:',
+                        '- **Email notifications** — event/condition, recipients, template',
+                        '- **Email templates** — subject, body (with variable replacements)',
+                        '- **SMS/push notifications** — if configured',
+                        '',
+                        '## Output Format',
+                        '',
+                        'Generate the complete documentation in clean markdown format:',
+                        '',
+                        '```',
+                        '# [Application Name] — Technical Documentation',
+                        '## Version: [version]  |  Scope: [scope]',
+                        '',
+                        '### Table of Contents',
+                        '1. Application Overview',
+                        '2. Data Model',
+                        '3. Server-Side Logic',
+                        '4. Client-Side Logic',
+                        '5. Security Model',
+                        '6. Flows & Automation',
+                        '7. Service Catalog',
+                        '8. Integrations',
+                        '9. Portal',
+                        '10. Notifications',
+                        '',
+                        '[Each section with tables, descriptions, and cross-references]',
+                        '```',
+                        '',
+                        'The documentation should be ready for direct use in a wiki, Confluence, or markdown repository.',
+                        '',
+                        '---',
+                        '',
+                        'Starting application documentation.',
+                    ].join('\n'),
+                },
+            },
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: app,
+                },
+            },
+        ];
+    },
+};
+export default capability;
+//# sourceMappingURL=docs-app.js.map

package/dist/prompts/capabilities/docs-app.js.map

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

package/dist/prompts/capabilities/docs-release.d.ts

@@ -0,0 +1,4 @@
+import type { CapabilityDefinition } from '../types.js';
+declare const capability: CapabilityDefinition;
+export default capability;
+//# sourceMappingURL=docs-release.d.ts.map

package/dist/prompts/capabilities/docs-release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-release.d.ts","sourceRoot":"","sources":["../../../src/prompts/capabilities/docs-release.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,QAAA,MAAM,UAAU,EAAE,oBAuMjB,CAAC;AAEF,eAAe,UAAU,CAAC"}