@ductape/cli 0.2.18 → 0.2.20

package/dist/commands/apply.js

@@ -13,20 +13,62 @@ async function syncItems(type, items, productTag, proxy, dryRun) {
     const listResult = await proxy.execute(module, 'list', buildCrudParams(module, 'list', productTag, {}));
     const existingList = Array.isArray(listResult) ? listResult : [];
     const existingTags = new Set(existingList.map((r) => r.tag ?? '').filter(Boolean));
+    const existingNotificationMessages = new Set();
+    if (type === 'notifications') {
+        for (const notification of existingList) {
+            const record = notification;
+            for (const message of record.messages ?? []) {
+                if (record.tag && message.tag) {
+                    existingNotificationMessages.add(message.tag.includes(':') ? message.tag : `${record.tag}:${message.tag}`);
+                }
+            }
+        }
+    }
     for (const item of items) {
         if (!item.tag) {
             console.warn(`  [${type}] skipped — missing "tag" field`);
             continue;
         }
         const verb = existingTags.has(item.tag) ? 'update' : 'create';
+        const nestedMessages = type === 'notifications' && Array.isArray(item.messages)
+            ? item.messages
+            : [];
+        const componentBody = type === 'notifications'
+            ? Object.fromEntries(Object.entries(item).filter(([key]) => key !== 'messages'))
+            : item;
         if (dryRun) {
             console.log(`  [${type}] would ${verb}: ${item.tag}`);
+            for (const message of nestedMessages) {
+                const rawTag = String(message.tag ?? '');
+                const fullTag = rawTag.includes(':') ? rawTag : `${item.tag}:${rawTag}`;
+                const messageVerb = existingNotificationMessages.has(fullTag) ? 'update' : 'create';
+                console.log(`  [notifications] would ${messageVerb} message: ${fullTag}`);
+            }
             continue;
         }
         try {
-            const params = buildCrudParams(module, verb, productTag, { tag: item.tag, body: item });
+            const params = buildCrudParams(module, verb, productTag, {
+                tag: item.tag,
+                body: componentBody,
+            });
             await proxy.execute(module, verb, params);
             console.log(`  [${type}] ${verb}d: ${item.tag}`);
+            for (const message of nestedMessages) {
+                const rawTag = String(message.tag ?? '');
+                if (!rawTag)
+                    throw new Error(`notification "${item.tag}" contains a message without "tag"`);
+                const fullTag = rawTag.includes(':') ? rawTag : `${item.tag}:${rawTag}`;
+                if (!fullTag.startsWith(`${item.tag}:`)) {
+                    throw new Error(`message tag "${fullTag}" must belong to notification "${item.tag}"`);
+                }
+                const messageBody = { ...message, tag: fullTag };
+                const messageVerb = existingNotificationMessages.has(fullTag) ? 'update' : 'create';
+                const messageParams = messageVerb === 'create'
+                    ? [productTag, messageBody]
+                    : [productTag, fullTag, messageBody];
+                await proxy.execute('notifications', `messages.${messageVerb}`, messageParams);
+                console.log(`  [notifications] ${messageVerb}d message: ${fullTag}`);
+            }
         }
         catch (err) {
             console.error(`  [${type}] ${verb} failed for "${item.tag}": ${err instanceof Error ? err.message : String(err)}`);
@@ -54,8 +96,7 @@ export async function runApply(type, opts) {
             items = loaders[t]();
         }
         catch (err) {
-            console.error(`[${t}] parse error: ${err instanceof Error ? err.message : String(err)}`);
-            continue;
+            fail(`[${t}] parse error: ${err instanceof Error ? err.message : String(err)}`);
         }
         if (items === null) {
             console.log(`[${t}] no ductape/${t}.json found — skipping`);

package/dist/commands/products.d.ts

@@ -12,6 +12,12 @@ export declare function runProductApps(verb: string, opts: {
     product?: string;
     json?: boolean;
 }, extraArgs: string[]): Promise<void>;
+export declare function runProductComponents(verb: string, opts: {
+    profile?: string;
+    tag?: string;
+    type?: string;
+    json?: boolean;
+}): Promise<void>;
 export declare function runProductEnvironments(verb: string, opts: {
     product?: string;
     tag?: string;

package/dist/commands/products.js

@@ -73,6 +73,91 @@ export async function runProductApps(verb, opts, extraArgs) {
     const result = await listProductApps(ctx, productId);
     printJson(result, Boolean(opts.json));
 }
+const COMPONENT_KEYS = {
+    apps: ['apps'],
+    databases: ['databases'],
+    storage: ['storage'],
+    caches: ['caches'],
+    graphs: ['graphs'],
+    vectors: ['vectors', 'vector_databases'],
+    notifications: ['notifications'],
+    events: ['message_brokers', 'messageBrokers', 'brokers'],
+    sessions: ['sessions'],
+    features: ['features'],
+    jobs: ['jobs'],
+};
+function unwrapProduct(value) {
+    if (!value || typeof value !== 'object')
+        return {};
+    const record = value;
+    return record.data && typeof record.data === 'object'
+        ? record.data
+        : record;
+}
+function summarizeComponent(value) {
+    const component = (value && typeof value === 'object' ? value : {});
+    const summary = {};
+    for (const key of ['_id', 'id', 'tag', 'name', 'description', 'type', 'status']) {
+        if (component[key] !== undefined)
+            summary[key] = component[key];
+    }
+    if (Array.isArray(component.envs)) {
+        summary.envs = component.envs.map((env) => {
+            const item = (env && typeof env === 'object' ? env : {});
+            return { slug: item.slug, type: item.type, cloud: item.cloud };
+        });
+    }
+    for (const nestedKey of ['topics', 'messages']) {
+        if (Array.isArray(component[nestedKey])) {
+            summary[nestedKey] = component[nestedKey].map((nested) => {
+                const item = (nested && typeof nested === 'object' ? nested : {});
+                return {
+                    tag: item.tag,
+                    name: item.name,
+                    description: item.description,
+                };
+            });
+        }
+    }
+    return summary;
+}
+export async function runProductComponents(verb, opts) {
+    const normalizedVerb = verb.toLowerCase();
+    if (!['list', 'get'].includes(normalizedVerb)) {
+        throw new Error('Product components verb must be: list | get');
+    }
+    if (!opts.tag)
+        throw new Error('--tag <product_tag> is required');
+    const ctx = requireWorkspaceContext({ profile: opts.profile });
+    const product = unwrapProduct(await getProduct(ctx, { tag: opts.tag }));
+    const selectedTypes = normalizedVerb === 'get'
+        ? [opts.type?.toLowerCase()].filter(Boolean)
+        : Object.keys(COMPONENT_KEYS);
+    if (normalizedVerb === 'get' && !selectedTypes.length) {
+        throw new Error('--type <component_type> is required for get');
+    }
+    for (const type of selectedTypes) {
+        if (!COMPONENT_KEYS[type]) {
+            throw new Error(`Unknown component type "${type}". Use: ${Object.keys(COMPONENT_KEYS).join(', ')}`);
+        }
+    }
+    const components = {};
+    for (const type of selectedTypes) {
+        const sourceKey = COMPONENT_KEYS[type].find((key) => Array.isArray(product[key]));
+        components[type] = sourceKey
+            ? product[sourceKey].map(summarizeComponent)
+            : [];
+    }
+    const envSource = Array.isArray(product.envs) ? product.envs : [];
+    printJson({
+        tag: product.tag ?? opts.tag,
+        environments: envSource.map((env) => {
+            const item = (env && typeof env === 'object' ? env : {});
+            return { slug: item.slug, name: item.name ?? item.env_name };
+        }),
+        components,
+    }, Boolean(opts.json));
+}
 export async function runProductEnvironments(verb, opts, extraArgs) {
     const v = verb.toLowerCase();
     const allowed = ['list', 'get', 'fetch'];

package/dist/commands/resources.d.ts

@@ -5,6 +5,12 @@ export declare function runEventTopicCrud(verb: string, opts: {
     file?: string;
     json?: boolean;
 } & CommandInteractiveFlags, extraArgs: string[]): Promise<void>;
+export declare function runNotificationMessageCrud(verb: string, opts: {
+    tag?: string;
+    notification?: string;
+    file?: string;
+    json?: boolean;
+}): Promise<void>;
 export declare function runResourceCrud(typeName: string, verb: string, opts: {
     tag?: string;
     file?: string;

package/dist/commands/resources.js

@@ -61,6 +61,56 @@ export async function runEventTopicCrud(verb, opts, extraArgs) {
     const result = await proxy.execute('messageBrokers', method, params);
     printJson(result, Boolean(opts.json));
 }
+export async function runNotificationMessageCrud(verb, opts) {
+    const crud = verb.toLowerCase();
+    if (!['create', 'list', 'get', 'update'].includes(crud)) {
+        throw new Error('Notification message verb must be: create | list | get | update');
+    }
+    const session = requireSession();
+    const proxy = getSdkProxy(session);
+    const product = session.project.product_tag;
+    const body = ['create', 'update'].includes(crud)
+        ? await resolveBody({ file: opts.file, patch: crud === 'update', requireBody: crud === 'create', interactive: false })
+        : undefined;
+    const method = `messages.${crud === 'get' ? 'fetch' : crud}`;
+    let params;
+    if (crud === 'create')
+        params = [product, body ?? {}];
+    else if (crud === 'list') {
+        if (!opts.notification)
+            throw new Error('--notification <notification-tag> is required');
+        params = [product, opts.notification];
+    }
+    else if (crud === 'get') {
+        if (!opts.tag)
+            throw new Error('--tag <notification:message> is required');
+        params = [product, opts.tag];
+    }
+    else {
+        if (!opts.tag)
+            throw new Error('--tag <notification:message> is required');
+        params = [product, opts.tag, body ?? {}];
+    }
+    try {
+        printJson(await proxy.execute('notifications', method, params), Boolean(opts.json));
+    }
+    catch (error) {
+        if (crud !== 'list' || !opts.notification)
+            throw error;
+        // Compatibility fallback for platform versions whose message lookup uses a stale product
+        // snapshot while the component inventory already contains the notification.
+        const listed = await proxy.execute('notifications', 'list', buildCrudParams('notifications', 'list', product, {}));
+        const notifications = Array.isArray(listed)
+            ? listed
+            : Array.isArray(listed?.data)
+                ? listed.data
+                : [];
+        const notification = notifications.find((item) => item.tag === opts.notification);
+        if (!notification)
+            throw error;
+        printJson(notification.messages ?? [], Boolean(opts.json));
+    }
+}
 export async function runResourceCrud(typeName, verb, opts, extraArgs) {
     const crud = verb.toLowerCase();
     if (!CRUD_VERBS.includes(crud)) {

package/dist/index.js

@@ -12,7 +12,7 @@ import { runUnlink } from './commands/unlink.js';
 import { runInit } from './commands/init.js';
 import { runInstall } from './commands/install.js';
 import { runStart, runStop, runStatus } from './commands/platform.js';
-import { runResourceCrud, runResourcesList, runEventTopicCrud } from './commands/resources.js';
+import { runResourceCrud, runResourcesList, runEventTopicCrud, runNotificationMessageCrud } from './commands/resources.js';
 import { runCloud } from './commands/cloud.js';
 import { runDb, runDbContext } from './commands/db.js';
 import { runDbMigrate, runDbMigrateStatus, runDbMigrateRollback } from './commands/db-migrate.js';
@@ -22,7 +22,7 @@ import { runSecrets } from './commands/secrets.js';
 import { runWorkspacesCurrent, runWorkspacesList, runWorkspacesRefresh, runWorkspacesUse, } from './commands/workspaces.js';
 import { runGeneratePayload, runGenerateSnippet } from './commands/generate.js';
 import { runCompletion } from './commands/completion.js';
-import { runProducts, runProductApps, runProductEnvironments } from './commands/products.js';
+import { runProducts, runProductApps, runProductComponents, runProductEnvironments } from './commands/products.js';
 import { runApps } from './commands/apps.js';
 import { runAppsImport } from './commands/apps-import.js';
 import { runApply } from './commands/apply.js';
@@ -192,6 +192,22 @@ productApps
     .option('--product <id>', 'Product _id')
     .option('--json', 'JSON output')
     .action(wrap((opts) => runProductApps('list', opts, [])));
+const productComponents = products
+    .command('components')
+    .description('Compact, non-secret product component inventory');
+productComponents
+    .command('list')
+    .requiredOption('-t, --tag <tag>', 'Product tag')
+    .option('--profile <name>')
+    .option('--json', 'JSON output')
+    .action(wrap((opts) => runProductComponents('list', opts)));
+productComponents
+    .command('get')
+    .requiredOption('-t, --tag <tag>', 'Product tag')
+    .requiredOption('--type <type>', 'Component type, e.g. notifications or events')
+    .option('--profile <name>')
+    .option('--json', 'JSON output')
+    .action(wrap((opts) => runProductComponents('get', opts)));
 const productEnvironments = products
     .command('environments')
     .description('Product environments (list, get)');
@@ -255,6 +271,14 @@ eventTopics
     .option('--json', 'JSON output')
     .action(wrap((verb, opts) => runEventTopicCrud(verb, opts, [])));
 const resources = program.command('resources').description('Component CRUD (sdk-proxy)');
+const notificationMessages = program.command('notifications').description('Notification templates');
+notificationMessages
+    .command('messages <verb>')
+    .option('-t, --tag <tag>', 'Full notification:message tag')
+    .option('-n, --notification <tag>', 'Notification tag for list')
+    .option('-f, --file <path>', 'JSON template body for create/update')
+    .option('--json', 'JSON output')
+    .action(wrap((verb, opts) => runNotificationMessageCrud(verb, opts)));
 resources.command('types').option('--json', 'JSON output').action(wrap((opts) => runResourcesList(Boolean(opts.json))));
 resources
     .argument('<type>', 'Resource type (e.g. storage, database, cache …)')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ductape/cli",
-  "version": "0.2.18",
+  "version": "0.2.20",
   "description": "Ductape CLI — local platform, login, link projects, and manage resources via the proxy (Workbench-compatible)",
   "type": "module",
   "main": "dist/index.js",

package/src/commands/apply.ts

@@ -36,6 +36,19 @@ async function syncItems(
   const existingTags = new Set(
     existingList.map((r) => (r as { tag?: string }).tag ?? '').filter(Boolean),
   );
+  const existingNotificationMessages = new Set<string>();
+  if (type === 'notifications') {
+    for (const notification of existingList) {
+      const record = notification as { tag?: string; messages?: Array<{ tag?: string }> };
+      for (const message of record.messages ?? []) {
+        if (record.tag && message.tag) {
+          existingNotificationMessages.add(
+            message.tag.includes(':') ? message.tag : `${record.tag}:${message.tag}`,
+          );
+        }
+      }
+    }
+  }
 
   for (const item of items) {
     if (!item.tag) {
@@ -44,16 +57,52 @@ async function syncItems(
     }
 
     const verb: 'create' | 'update' = existingTags.has(item.tag) ? 'update' : 'create';
+    const nestedMessages =
+      type === 'notifications' && Array.isArray(item.messages)
+        ? item.messages as Array<Record<string, unknown>>
+        : [];
+    const componentBody =
+      type === 'notifications'
+        ? Object.fromEntries(Object.entries(item).filter(([key]) => key !== 'messages'))
+        : item;
 
     if (dryRun) {
       console.log(`  [${type}] would ${verb}: ${item.tag}`);
+      for (const message of nestedMessages) {
+        const rawTag = String(message.tag ?? '');
+        const fullTag = rawTag.includes(':') ? rawTag : `${item.tag}:${rawTag}`;
+        const messageVerb = existingNotificationMessages.has(fullTag) ? 'update' : 'create';
+        console.log(`  [notifications] would ${messageVerb} message: ${fullTag}`);
+      }
       continue;
     }
 
     try {
-      const params = buildCrudParams(module, verb, productTag, { tag: item.tag, body: item });
+      const params = buildCrudParams(module, verb, productTag, {
+        tag: item.tag,
+        body: componentBody,
+      });
       await proxy.execute(module, verb, params);
       console.log(`  [${type}] ${verb}d: ${item.tag}`);
+
+      for (const message of nestedMessages) {
+        const rawTag = String(message.tag ?? '');
+        if (!rawTag) throw new Error(`notification "${item.tag}" contains a message without "tag"`);
+        const fullTag = rawTag.includes(':') ? rawTag : `${item.tag}:${rawTag}`;
+        if (!fullTag.startsWith(`${item.tag}:`)) {
+          throw new Error(
+            `message tag "${fullTag}" must belong to notification "${item.tag}"`,
+          );
+        }
+        const messageBody = { ...message, tag: fullTag };
+        const messageVerb = existingNotificationMessages.has(fullTag) ? 'update' : 'create';
+        const messageParams =
+          messageVerb === 'create'
+            ? [productTag, messageBody]
+            : [productTag, fullTag, messageBody];
+        await proxy.execute('notifications', `messages.${messageVerb}`, messageParams);
+        console.log(`  [notifications] ${messageVerb}d message: ${fullTag}`);
+      }
     } catch (err) {
       console.error(
         `  [${type}] ${verb} failed for "${item.tag}": ${err instanceof Error ? err.message : String(err)}`,
@@ -85,8 +134,7 @@ export async function runApply(type: ApplyType | undefined, opts: ApplyOpts): Pr
     try {
       items = loaders[t]();
     } catch (err) {
-      console.error(`[${t}] parse error: ${err instanceof Error ? err.message : String(err)}`);
-      continue;
+      fail(`[${t}] parse error: ${err instanceof Error ? err.message : String(err)}`);
     }
 
     if (items === null) {

package/src/commands/products.ts

@@ -104,6 +104,101 @@ export async function runProductApps(
   printJson(result, Boolean(opts.json));
 }
 
+const COMPONENT_KEYS: Record<string, string[]> = {
+  apps: ['apps'],
+  databases: ['databases'],
+  storage: ['storage'],
+  caches: ['caches'],
+  graphs: ['graphs'],
+  vectors: ['vectors', 'vector_databases'],
+  notifications: ['notifications'],
+  events: ['message_brokers', 'messageBrokers', 'brokers'],
+  sessions: ['sessions'],
+  features: ['features'],
+  jobs: ['jobs'],
+};
+
+function unwrapProduct(value: unknown): Record<string, unknown> {
+  if (!value || typeof value !== 'object') return {};
+  const record = value as Record<string, unknown>;
+  return record.data && typeof record.data === 'object'
+    ? (record.data as Record<string, unknown>)
+    : record;
+}
+
+function summarizeComponent(value: unknown): Record<string, unknown> {
+  const component = (value && typeof value === 'object' ? value : {}) as Record<string, unknown>;
+  const summary: Record<string, unknown> = {};
+  for (const key of ['_id', 'id', 'tag', 'name', 'description', 'type', 'status']) {
+    if (component[key] !== undefined) summary[key] = component[key];
+  }
+  if (Array.isArray(component.envs)) {
+    summary.envs = component.envs.map((env) => {
+      const item = (env && typeof env === 'object' ? env : {}) as Record<string, unknown>;
+      return { slug: item.slug, type: item.type, cloud: item.cloud };
+    });
+  }
+  for (const nestedKey of ['topics', 'messages']) {
+    if (Array.isArray(component[nestedKey])) {
+      summary[nestedKey] = (component[nestedKey] as unknown[]).map((nested) => {
+        const item = (nested && typeof nested === 'object' ? nested : {}) as Record<string, unknown>;
+        return {
+          tag: item.tag,
+          name: item.name,
+          description: item.description,
+        };
+      });
+    }
+  }
+  return summary;
+}
+
+export async function runProductComponents(
+  verb: string,
+  opts: { profile?: string; tag?: string; type?: string; json?: boolean },
+): Promise<void> {
+  const normalizedVerb = verb.toLowerCase();
+  if (!['list', 'get'].includes(normalizedVerb)) {
+    throw new Error('Product components verb must be: list | get');
+  }
+  if (!opts.tag) throw new Error('--tag <product_tag> is required');
+
+  const ctx = requireWorkspaceContext({ profile: opts.profile });
+  const product = unwrapProduct(await getProduct(ctx, { tag: opts.tag }));
+  const selectedTypes =
+    normalizedVerb === 'get'
+      ? [opts.type?.toLowerCase()].filter(Boolean) as string[]
+      : Object.keys(COMPONENT_KEYS);
+  if (normalizedVerb === 'get' && !selectedTypes.length) {
+    throw new Error('--type <component_type> is required for get');
+  }
+  for (const type of selectedTypes) {
+    if (!COMPONENT_KEYS[type]) {
+      throw new Error(`Unknown component type "${type}". Use: ${Object.keys(COMPONENT_KEYS).join(', ')}`);
+    }
+  }
+
+  const components: Record<string, unknown[]> = {};
+  for (const type of selectedTypes) {
+    const sourceKey = COMPONENT_KEYS[type].find((key) => Array.isArray(product[key]));
+    components[type] = sourceKey
+      ? (product[sourceKey] as unknown[]).map(summarizeComponent)
+      : [];
+  }
+  const envSource = Array.isArray(product.envs) ? product.envs : [];
+  printJson(
+    {
+      tag: product.tag ?? opts.tag,
+      environments: envSource.map((env) => {
+        const item = (env && typeof env === 'object' ? env : {}) as Record<string, unknown>;
+        return { slug: item.slug, name: item.name ?? item.env_name };
+      }),
+      components,
+    },
+    Boolean(opts.json),
+  );
+}
+
 export async function runProductEnvironments(
   verb: string,
   opts: { product?: string; tag?: string; slug?: string; json?: boolean },

package/src/commands/resources.ts

@@ -73,6 +73,58 @@ export async function runEventTopicCrud(
   printJson(result, Boolean(opts.json));
 }
 
+export async function runNotificationMessageCrud(
+  verb: string,
+  opts: { tag?: string; notification?: string; file?: string; json?: boolean },
+): Promise<void> {
+  const crud = verb.toLowerCase();
+  if (!['create', 'list', 'get', 'update'].includes(crud)) {
+    throw new Error('Notification message verb must be: create | list | get | update');
+  }
+  const session = requireSession();
+  const proxy = getSdkProxy(session);
+  const product = session.project.product_tag;
+  const body = ['create', 'update'].includes(crud)
+    ? await resolveBody({ file: opts.file, patch: crud === 'update', requireBody: crud === 'create', interactive: false })
+    : undefined;
+  const method = `messages.${crud === 'get' ? 'fetch' : crud}`;
+  let params: unknown[];
+  if (crud === 'create') params = [product, body ?? {}];
+  else if (crud === 'list') {
+    if (!opts.notification) throw new Error('--notification <notification-tag> is required');
+    params = [product, opts.notification];
+  } else if (crud === 'get') {
+    if (!opts.tag) throw new Error('--tag <notification:message> is required');
+    params = [product, opts.tag];
+  } else {
+    if (!opts.tag) throw new Error('--tag <notification:message> is required');
+    params = [product, opts.tag, body ?? {}];
+  }
+  try {
+    printJson(await proxy.execute('notifications', method, params), Boolean(opts.json));
+  } catch (error) {
+    if (crud !== 'list' || !opts.notification) throw error;
+
+    // Compatibility fallback for platform versions whose message lookup uses a stale product
+    // snapshot while the component inventory already contains the notification.
+    const listed = await proxy.execute<unknown>(
+      'notifications',
+      'list',
+      buildCrudParams('notifications', 'list', product, {}),
+    );
+    const notifications = Array.isArray(listed)
+      ? listed
+      : Array.isArray((listed as { data?: unknown[] } | null)?.data)
+        ? (listed as { data: unknown[] }).data
+        : [];
+    const notification = notifications.find(
+      (item) => (item as { tag?: string }).tag === opts.notification,
+    ) as { messages?: unknown[] } | undefined;
+    if (!notification) throw error;
+    printJson(notification.messages ?? [], Boolean(opts.json));
+  }
+}
+
 export async function runResourceCrud(
   typeName: string,
   verb: string,

package/src/index.ts

@@ -12,7 +12,7 @@ import { runUnlink } from './commands/unlink.js';
 import { runInit } from './commands/init.js';
 import { runInstall } from './commands/install.js';
 import { runStart, runStop, runStatus } from './commands/platform.js';
-import { runResourceCrud, runResourcesList, runEventTopicCrud } from './commands/resources.js';
+import { runResourceCrud, runResourcesList, runEventTopicCrud, runNotificationMessageCrud } from './commands/resources.js';
 import { runCloud } from './commands/cloud.js';
 import { runDb, runDbContext } from './commands/db.js';
 import { runDbMigrate, runDbMigrateStatus, runDbMigrateRollback } from './commands/db-migrate.js';
@@ -27,7 +27,7 @@ import {
 } from './commands/workspaces.js';
 import { runGeneratePayload, runGenerateSnippet } from './commands/generate.js';
 import { runCompletion } from './commands/completion.js';
-import { runProducts, runProductApps, runProductEnvironments } from './commands/products.js';
+import { runProducts, runProductApps, runProductComponents, runProductEnvironments } from './commands/products.js';
 import { runApps } from './commands/apps.js';
 import { runAppsImport } from './commands/apps-import.js';
 import { runApply, type ApplyType } from './commands/apply.js';
@@ -248,6 +248,25 @@ productApps
   .option('--json', 'JSON output')
   .action(wrap((opts) => runProductApps('list', opts, [])));
 
+const productComponents = products
+  .command('components')
+  .description('Compact, non-secret product component inventory');
+
+productComponents
+  .command('list')
+  .requiredOption('-t, --tag <tag>', 'Product tag')
+  .option('--profile <name>')
+  .option('--json', 'JSON output')
+  .action(wrap((opts) => runProductComponents('list', opts)));
+
+productComponents
+  .command('get')
+  .requiredOption('-t, --tag <tag>', 'Product tag')
+  .requiredOption('--type <type>', 'Component type, e.g. notifications or events')
+  .option('--profile <name>')
+  .option('--json', 'JSON output')
+  .action(wrap((opts) => runProductComponents('get', opts)));
+
 const productEnvironments = products
   .command('environments')
   .description('Product environments (list, get)');
@@ -332,6 +351,15 @@ eventTopics
 
 const resources = program.command('resources').description('Component CRUD (sdk-proxy)');
 
+const notificationMessages = program.command('notifications').description('Notification templates');
+notificationMessages
+  .command('messages <verb>')
+  .option('-t, --tag <tag>', 'Full notification:message tag')
+  .option('-n, --notification <tag>', 'Notification tag for list')
+  .option('-f, --file <path>', 'JSON template body for create/update')
+  .option('--json', 'JSON output')
+  .action(wrap((verb: string, opts) => runNotificationMessageCrud(verb, opts)));
+
 resources.command('types').option('--json', 'JSON output').action(wrap((opts) => runResourcesList(Boolean(opts.json))));
 
 resources

package/test/apply-loaders.test.ts

@@ -0,0 +1,40 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+import { loadNotifications } from '../src/lib/apply-loaders.js';
+
+test('notifications declaration must be a top-level array', () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'ductape-notifications-'));
+  const configDir = path.join(dir, 'ductape');
+  fs.mkdirSync(configDir);
+  fs.writeFileSync(
+    path.join(configDir, 'notifications.json'),
+    JSON.stringify({ notifications: [], messages: [] }),
+  );
+
+  assert.throws(
+    () => loadNotifications(dir),
+    /notifications\.json must be a JSON array/,
+  );
+});
+
+test('notifications declaration accepts nested messages', () => {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'ductape-notifications-'));
+  const configDir = path.join(dir, 'ductape');
+  fs.mkdirSync(configDir);
+  fs.writeFileSync(
+    path.join(configDir, 'notifications.json'),
+    JSON.stringify([
+      {
+        tag: 'game-alerts-critical',
+        messages: [{ tag: 'game-alerts-critical:match-launch', name: 'Match launch' }],
+      },
+    ]),
+  );
+
+  const result = loadNotifications(dir);
+  assert.equal(result?.length, 1);
+  assert.equal(result?.[0].tag, 'game-alerts-critical');
+});

package/test/platform-api.test.ts

@@ -30,4 +30,13 @@ describe('platform-api helpers', () => {
       /getPath<unknown>\(`\/integrations\/v1\/fetch\/tag`/,
     );
   });
+
+  it('exposes notification message administration', () => {
+    const source = readFileSync(
+      fileURLToPath(new URL('../src/commands/resources.ts', import.meta.url)),
+      'utf8',
+    );
+    assert.match(source, /runNotificationMessageCrud/);
+    assert.match(source, /`messages\.\$\{crud === 'get' \? 'fetch' : crud\}`/);
+  });
 });