@badgie/crm-cli 0.7.0 → 0.9.0

package/dist/commands/marketing.js

@@ -1,135 +1,1426 @@
 import { getAuthedClient } from '../core/supabase.js';
 import { commonListOptions, output, parseColumns, parseLimit } from '../core/format.js';
+import { maybeResolve } from '../core/resolve.js';
+// ─── Enums (replicated from lib/crm/marketing-planner-types.ts) ────────────
+const POST_STATUSES = [
+    'idea',
+    'draft',
+    'needs_review',
+    'approved',
+    'scheduled',
+    'published',
+    'failed',
+    'manual_required',
+    'cancelled',
+];
+const CAMPAIGN_STATUSES = [
+    'draft',
+    'scheduled',
+    'active',
+    'paused',
+    'completed',
+    'cancelled',
+];
+const PUBLICATION_STATUSES = [
+    'pending',
+    'scheduled',
+    'published',
+    'failed',
+    'manual_required',
+    'cancelled',
+];
+const REVIEW_STATUSES = ['requested', 'approved', 'changes_requested', 'rejected'];
+const CHANNEL_TYPES = ['social', 'blog', 'email', 'messaging', 'video'];
+const PUBLISHING_METHODS = ['manual', 'zapier', 'api', 'native', 'not_supported_yet'];
+const ASSET_TYPES = ['image', 'video', 'thumbnail', 'audio', 'document', 'other'];
+const ASSET_ROLES = ['primary', 'secondary', 'thumbnail', 'source', 'final'];
+const METRIC_SOURCES = ['manual', 'api', 'zapier'];
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function ensureEnum(allowed, value, label) {
+    if (!allowed.includes(value)) {
+        throw new Error(`Invalid ${label} "${value}". Allowed: ${allowed.join(', ')}`);
+    }
+    return value;
+}
+function slugify(input) {
+    return input
+        .toLowerCase()
+        .normalize('NFD')
+        .replace(/[̀-ͯ]/g, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/(^-|-$)+/g, '');
+}
+// ─── Resolution helpers (id ↔ slug ↔ name) ─────────────────────────────────
+async function resolveCampaign(client, idOrSlug) {
+    if (UUID_RE.test(idOrSlug))
+        return idOrSlug;
+    const { data, error } = await client
+        .from('marketing_campaigns')
+        .select('id, slug, name')
+        .or(`slug.eq.${idOrSlug},name.ilike.%${idOrSlug}%`)
+        .limit(2);
+    if (error)
+        throw error;
+    const rows = (data ?? []);
+    if (rows.length === 0) {
+        throw new Error(`No campaign matches "${idOrSlug}". Try: badgie-crm marketing campaigns list --pretty`);
+    }
+    if (rows.length > 1) {
+        const names = rows.map((r) => `${r.slug} (${r.name})`).join(', ');
+        throw new Error(`Ambiguous campaign "${idOrSlug}": ${names}. Use slug or UUID.`);
+    }
+    return rows[0].id;
+}
+async function resolveChannel(client, idOrSlug) {
+    if (UUID_RE.test(idOrSlug))
+        return idOrSlug;
+    const { data, error } = await client
+        .from('marketing_channels')
+        .select('id, slug')
+        .eq('slug', idOrSlug)
+        .maybeSingle();
+    if (error)
+        throw error;
+    if (!data) {
+        throw new Error(`No channel matches "${idOrSlug}". Try: badgie-crm marketing channels list --pretty`);
+    }
+    return data.id;
+}
+async function resolvePost(client, idOrSlug) {
+    if (UUID_RE.test(idOrSlug))
+        return idOrSlug;
+    const { data, error } = await client
+        .from('marketing_posts')
+        .select('id, slug')
+        .eq('slug', idOrSlug)
+        .maybeSingle();
+    if (error)
+        throw error;
+    if (!data) {
+        throw new Error(`No post matches "${idOrSlug}". Try: badgie-crm marketing posts list --pretty`);
+    }
+    return data.id;
+}
+async function getCallerTeamMemberId(client) {
+    const { data: userRes } = await client.auth.getUser();
+    const email = userRes.user?.email;
+    if (!email)
+        return null;
+    const { data } = await client
+        .from('team_members')
+        .select('id')
+        .eq('email', email)
+        .maybeSingle();
+    return data?.id ?? null;
+}
+// ─── Planner reads (Coach daily flow) ──────────────────────────────────────
+async function plannerToday(_a, opts) {
+    const { client } = await getAuthedClient();
+    const start = new Date();
+    start.setHours(0, 0, 0, 0);
+    const end = new Date(start);
+    end.setDate(end.getDate() + 1);
+    const { data, error } = await client
+        .from('marketing_posts')
+        .select(`id, internal_title, slug, status, scheduled_at, copy_main, cta_label, cta_url, hashtags,
+       campaign:marketing_campaigns(id, name, slug),
+       primary_channel:marketing_channels!marketing_posts_primary_channel_id_fkey(id, name, slug, publishing_method),
+       owner:team_members!marketing_posts_owner_id_fkey(id, full_name, email)`)
+        .gte('scheduled_at', start.toISOString())
+        .lt('scheduled_at', end.toISOString())
+        .order('scheduled_at', { ascending: true });
+    if (error)
+        throw error;
+    output(data ?? [], { pretty: !!opts.pretty, columns: parseColumns(opts) });
+}
+async function plannerWeek(_a, opts) {
+    const { client } = await getAuthedClient();
+    const anchor = typeof opts.week === 'string' ? new Date(`${opts.week}T00:00:00`) : new Date();
+    // Lunes 00:00 de la semana del anchor.
+    const day = anchor.getDay(); // 0 dom .. 6 sáb
+    const offsetToMonday = day === 0 ? -6 : 1 - day;
+    const start = new Date(anchor);
+    start.setDate(start.getDate() + offsetToMonday);
+    start.setHours(0, 0, 0, 0);
+    const end = new Date(start);
+    end.setDate(end.getDate() + 7);
+    const { data, error } = await client
+        .from('marketing_posts')
+        .select(`id, internal_title, slug, status, scheduled_at, copy_main, hashtags,
+       campaign:marketing_campaigns(id, name, slug),
+       primary_channel:marketing_channels!marketing_posts_primary_channel_id_fkey(id, name, slug),
+       owner:team_members!marketing_posts_owner_id_fkey(id, full_name, email)`)
+        .gte('scheduled_at', start.toISOString())
+        .lt('scheduled_at', end.toISOString())
+        .order('scheduled_at', { ascending: true });
+    if (error)
+        throw error;
+    // Agrupar por día (YYYY-MM-DD).
+    const groups = {};
+    for (const row of (data ?? [])) {
+        const key = row.scheduled_at.slice(0, 10);
+        groups[key] ??= [];
+        groups[key].push(row);
+    }
+    output({
+        week_start: start.toISOString().slice(0, 10),
+        week_end: end.toISOString().slice(0, 10),
+        posts_by_day: groups,
+        total_posts: (data ?? []).length,
+    }, { pretty: !!opts.pretty });
+}
+async function plannerBlockers(_a, opts) {
+    const { client } = await getAuthedClient();
+    const { data, error } = await client
+        .from('marketing_posts')
+        .select(`id, internal_title, slug, status, scheduled_at, copy_main, primary_channel_id, error_message,
+       campaign:marketing_campaigns(name, slug),
+       primary_channel:marketing_channels!marketing_posts_primary_channel_id_fkey(name, slug),
+       owner:team_members!marketing_posts_owner_id_fkey(full_name, email)`)
+        .or('status.in.(needs_review,manual_required,failed),copy_main.is.null,primary_channel_id.is.null')
+        .order('scheduled_at', { ascending: true, nullsFirst: false })
+        .limit(parseLimit(opts));
+    if (error)
+        throw error;
+    const enriched = (data ?? []).map((row) => {
+        const blockers = [];
+        if (!row.copy_main)
+            blockers.push('falta_copy');
+        if (!row.primary_channel_id)
+            blockers.push('falta_canal');
+        if (!row.scheduled_at)
+            blockers.push('falta_fecha');
+        const status = row.status;
+        if (status === 'manual_required')
+            blockers.push('manual_required');
+        if (status === 'failed')
+            blockers.push('failed');
+        if (status === 'needs_review')
+            blockers.push('needs_review');
+        return { ...row, blockers };
+    });
+    output(enriched, { pretty: !!opts.pretty, columns: parseColumns(opts) });
+}
+async function plannerReportsWeekly(_a, opts) {
+    const { client } = await getAuthedClient();
+    const anchor = typeof opts.week === 'string' ? new Date(`${opts.week}T00:00:00`) : new Date();
+    const day = anchor.getDay();
+    const offsetToMonday = day === 0 ? -6 : 1 - day;
+    const start = new Date(anchor);
+    start.setDate(start.getDate() + offsetToMonday);
+    start.setHours(0, 0, 0, 0);
+    const end = new Date(start);
+    end.setDate(end.getDate() + 7);
+    const { data: posts, error } = await client
+        .from('marketing_posts')
+        .select(`id, status, primary_channel_id, campaign_id,
+       primary_channel:marketing_channels!marketing_posts_primary_channel_id_fkey(slug),
+       campaign:marketing_campaigns(slug)`)
+        .gte('scheduled_at', start.toISOString())
+        .lt('scheduled_at', end.toISOString());
+    if (error)
+        throw error;
+    const { data: pubs } = await client
+        .from('marketing_publications')
+        .select('id, status, channel_id, marketing_channels(slug)')
+        .gte('created_at', start.toISOString())
+        .lt('created_at', end.toISOString());
+    const byStatus = {};
+    const byChannel = {};
+    const byCampaign = {};
+    const slugOf = (e) => {
+        if (!e)
+            return null;
+        if (Array.isArray(e))
+            return e[0]?.slug ?? null;
+        return e.slug ?? null;
+    };
+    for (const p of (posts ?? [])) {
+        byStatus[p.status] = (byStatus[p.status] ?? 0) + 1;
+        const cs = slugOf(p.primary_channel) ?? '∅';
+        byChannel[cs] = (byChannel[cs] ?? 0) + 1;
+        const cas = slugOf(p.campaign) ?? '∅';
+        byCampaign[cas] = (byCampaign[cas] ?? 0) + 1;
+    }
+    const pubsByStatus = {};
+    const errors = 0;
+    for (const pub of (pubs ?? [])) {
+        pubsByStatus[pub.status] = (pubsByStatus[pub.status] ?? 0) + 1;
+    }
+    output({
+        week_start: start.toISOString().slice(0, 10),
+        week_end: end.toISOString().slice(0, 10),
+        posts_total: (posts ?? []).length,
+        posts_by_status: byStatus,
+        posts_by_channel: byChannel,
+        posts_by_campaign: byCampaign,
+        publications_by_status: pubsByStatus,
+        publications_total: (pubs ?? []).length,
+        errors,
+    }, { pretty: !!opts.pretty });
+}
+// ─── Campaigns ─────────────────────────────────────────────────────────────
 async function listCampaigns(_a, opts) {
     const { client } = await getAuthedClient();
     let q = client
         .from('marketing_campaigns')
-        .select('id, name, type, status, budget, start_date, end_date, assigned_to, created_at')
+        .select('id, name, slug, objective, status, start_date, end_date, budget_amount, owner_id, created_at')
         .order('created_at', { ascending: false })
         .limit(parseLimit(opts));
     if (typeof opts.status === 'string')
         q = q.eq('status', opts.status);
+    const { data, error } = await q;
+    if (error)
+        throw error;
+    output(data ?? [], { pretty: !!opts.pretty, columns: parseColumns(opts) });
+}
+async function getCampaign(args, opts) {
+    const ref = args.id;
+    if (!ref)
+        throw new Error('Falta <id-or-slug>');
+    const { client } = await getAuthedClient();
+    const id = await resolveCampaign(client, ref);
+    const [campRes, postsRes] = await Promise.all([
+        client.from('marketing_campaigns').select('*').eq('id', id).single(),
+        client
+            .from('marketing_posts')
+            .select('id, internal_title, slug, status, scheduled_at, primary_channel_id')
+            .eq('campaign_id', id)
+            .order('scheduled_at', { ascending: true, nullsFirst: false })
+            .limit(50),
+    ]);
+    if (campRes.error)
+        throw campRes.error;
+    output({ campaign: campRes.data, posts: postsRes.data ?? [] }, { pretty: !!opts.pretty });
+}
+async function createCampaign(_a, opts) {
+    const name = typeof opts.name === 'string' ? opts.name : null;
+    if (!name)
+        throw new Error('--name requerido');
+    const slug = typeof opts.slug === 'string' && opts.slug ? slugify(opts.slug) : slugify(name);
+    const status = typeof opts.status === 'string' ? ensureEnum(CAMPAIGN_STATUSES, opts.status, 'campaign status') : 'draft';
+    const { client } = await getAuthedClient();
+    const ownerId = await maybeResolve(client, 'team_member', opts.ownerEmail);
+    const callerId = await getCallerTeamMemberId(client);
+    const payload = {
+        name,
+        slug,
+        objective: typeof opts.objective === 'string' ? opts.objective : null,
+        status,
+        start_date: typeof opts.startDate === 'string' ? opts.startDate : null,
+        end_date: typeof opts.endDate === 'string' ? opts.endDate : null,
+        budget_amount: typeof opts.budget === 'string' ? Number(opts.budget) : null,
+        primary_landing_url: typeof opts.landingUrl === 'string' ? opts.landingUrl : null,
+        utm_campaign: typeof opts.utmCampaign === 'string' ? opts.utmCampaign : slug,
+        notes: typeof opts.notes === 'string' ? opts.notes : null,
+        owner_id: ownerId,
+        created_by: callerId,
+    };
+    const { data, error } = await client.from('marketing_campaigns').insert(payload).select('*').single();
+    if (error)
+        throw error;
+    output(data, { pretty: !!opts.pretty });
+}
+async function updateCampaign(args, opts) {
+    const ref = args.id;
+    if (!ref)
+        throw new Error('Falta <id-or-slug>');
+    const { client } = await getAuthedClient();
+    const id = await resolveCampaign(client, ref);
+    const patch = {};
+    if (typeof opts.name === 'string')
+        patch.name = opts.name;
+    if (typeof opts.objective === 'string')
+        patch.objective = opts.objective;
+    if (typeof opts.status === 'string')
+        patch.status = ensureEnum(CAMPAIGN_STATUSES, opts.status, 'status');
+    if (typeof opts.startDate === 'string')
+        patch.start_date = opts.startDate;
+    if (typeof opts.endDate === 'string')
+        patch.end_date = opts.endDate;
+    if (typeof opts.budget === 'string')
+        patch.budget_amount = Number(opts.budget);
+    if (typeof opts.landingUrl === 'string')
+        patch.primary_landing_url = opts.landingUrl;
+    if (typeof opts.utmCampaign === 'string')
+        patch.utm_campaign = opts.utmCampaign;
+    if (typeof opts.notes === 'string')
+        patch.notes = opts.notes;
+    if (typeof opts.ownerEmail === 'string') {
+        patch.owner_id = await maybeResolve(client, 'team_member', opts.ownerEmail);
+    }
+    if (Object.keys(patch).length === 0)
+        throw new Error('Sin cambios. Pasa al menos un --flag.');
+    const { data, error } = await client
+        .from('marketing_campaigns')
+        .update(patch)
+        .eq('id', id)
+        .select('*')
+        .single();
+    if (error)
+        throw error;
+    output(data, { pretty: !!opts.pretty });
+}
+async function deleteCampaign(args, opts) {
+    const ref = args.id;
+    if (!ref)
+        throw new Error('Falta <id-or-slug>');
+    if (!opts.confirm)
+        throw new Error('Pasa --confirm para borrar (las piezas asociadas mantienen campaign_id=NULL).');
+    const { client } = await getAuthedClient();
+    const id = await resolveCampaign(client, ref);
+    const { error } = await client.from('marketing_campaigns').delete().eq('id', id);
+    if (error)
+        throw error;
+    output({ deleted: id }, { pretty: !!opts.pretty });
+}
+// ─── Channels ──────────────────────────────────────────────────────────────
+async function listChannels(_a, opts) {
+    const { client } = await getAuthedClient();
+    let q = client.from('marketing_channels').select('*').order('name').limit(parseLimit(opts));
     if (typeof opts.type === 'string')
         q = q.eq('type', opts.type);
+    if (opts.activeOnly)
+        q = q.eq('is_active', true);
     const { data, error } = await q;
     if (error)
         throw error;
     output(data ?? [], { pretty: !!opts.pretty, columns: parseColumns(opts) });
 }
-async function listMarketingLeads(_a, opts) {
+async function createChannel(_a, opts) {
+    const name = typeof opts.name === 'string' ? opts.name : null;
+    if (!name)
+        throw new Error('--name requerido');
+    const slug = typeof opts.slug === 'string' && opts.slug ? slugify(opts.slug) : slugify(name);
+    const type = ensureEnum(CHANNEL_TYPES, String(opts.type ?? ''), 'type');
+    const publishing_method = ensureEnum(PUBLISHING_METHODS, String(opts.publishingMethod ?? 'manual'), 'publishing-method');
+    const { client } = await getAuthedClient();
+    const payload = {
+        name,
+        slug,
+        type,
+        publishing_method,
+        is_active: opts.isActive === false ? false : true,
+        public_config: typeof opts.config === 'string' ? JSON.parse(opts.config) : {},
+        notes: typeof opts.notes === 'string' ? opts.notes : null,
+    };
+    const { data, error } = await client.from('marketing_channels').insert(payload).select('*').single();
+    if (error)
+        throw error;
+    output(data, { pretty: !!opts.pretty });
+}
+async function updateChannel(args, opts) {
+    const ref = args.id;
+    if (!ref)
+        throw new Error('Falta <id-or-slug>');
+    const { client } = await getAuthedClient();
+    const id = await resolveChannel(client, ref);
+    const patch = {};
+    if (typeof opts.name === 'string')
+        patch.name = opts.name;
+    if (typeof opts.publishingMethod === 'string')
+        patch.publishing_method = ensureEnum(PUBLISHING_METHODS, opts.publishingMethod, 'publishing-method');
+    if (typeof opts.isActive === 'boolean')
+        patch.is_active = opts.isActive;
+    if (typeof opts.notes === 'string')
+        patch.notes = opts.notes;
+    if (typeof opts.config === 'string')
+        patch.public_config = JSON.parse(opts.config);
+    if (Object.keys(patch).length === 0)
+        throw new Error('Sin cambios.');
+    const { data, error } = await client.from('marketing_channels').update(patch).eq('id', id).select('*').single();
+    if (error)
+        throw error;
+    output(data, { pretty: !!opts.pretty });
+}
+// ─── Posts ─────────────────────────────────────────────────────────────────
+async function listPosts(_a, opts) {
     const { client } = await getAuthedClient();
     let q = client
-        .from('marketing_leads')
-        .select('id, lead_id, campaign_id, source, attribution_data, created_at')
-        .order('created_at', { ascending: false })
+        .from('marketing_posts')
+        .select(`id, internal_title, slug, status, scheduled_at, primary_channel_id, campaign_id, owner_id, updated_at,
+       primary_channel:marketing_channels!marketing_posts_primary_channel_id_fkey(slug, name),
+       campaign:marketing_campaigns(slug, name)`)
+        .order('scheduled_at', { ascending: true, nullsFirst: false })
         .limit(parseLimit(opts));
-    if (typeof opts.campaignId === 'string')
-        q = q.eq('campaign_id', opts.campaignId);
-    if (typeof opts.source === 'string')
-        q = q.eq('source', opts.source);
+    if (typeof opts.status === 'string')
+        q = q.eq('status', opts.status);
+    if (typeof opts.from === 'string')
+        q = q.gte('scheduled_at', opts.from);
+    if (typeof opts.to === 'string')
+        q = q.lte('scheduled_at', opts.to);
+    if (typeof opts.channel === 'string') {
+        const channelId = await resolveChannel(client, opts.channel);
+        q = q.eq('primary_channel_id', channelId);
+    }
+    if (typeof opts.campaign === 'string') {
+        const campaignId = await resolveCampaign(client, opts.campaign);
+        q = q.eq('campaign_id', campaignId);
+    }
     const { data, error } = await q;
     if (error)
         throw error;
     output(data ?? [], { pretty: !!opts.pretty, columns: parseColumns(opts) });
 }
-async function listMetrics(_a, opts) {
+async function getPost(args, opts) {
+    const ref = args.id;
+    if (!ref)
+        throw new Error('Falta <id-or-slug>');
+    const { client } = await getAuthedClient();
+    const id = await resolvePost(client, ref);
+    const [postRes, assetsRes, pubsRes, eventsRes, reviewsRes] = await Promise.all([
+        client
+            .from('marketing_posts')
+            .select(`*, campaign:marketing_campaigns(*), primary_channel:marketing_channels!marketing_posts_primary_channel_id_fkey(*)`)
+            .eq('id', id)
+            .single(),
+        client
+            .from('marketing_post_assets')
+            .select('*, asset:marketing_assets(*)')
+            .eq('post_id', id)
+            .order('sort_order'),
+        client
+            .from('marketing_publications')
+            .select('*, channel:marketing_channels(slug, name)')
+            .eq('post_id', id)
+            .order('created_at', { ascending: false }),
+        client
+            .from('marketing_status_events')
+            .select('*')
+            .eq('post_id', id)
+            .order('created_at', { ascending: false })
+            .limit(20),
+        client
+            .from('marketing_reviews')
+            .select('*')
+            .eq('post_id', id)
+            .order('created_at', { ascending: false }),
+    ]);
+    if (postRes.error)
+        throw postRes.error;
+    output({
+        post: postRes.data,
+        assets: assetsRes.data ?? [],
+        publications: pubsRes.data ?? [],
+        status_events: eventsRes.data ?? [],
+        reviews: reviewsRes.data ?? [],
+    }, { pretty: !!opts.pretty });
+}
+async function createPost(_a, opts) {
+    const title = typeof opts.title === 'string' ? opts.title : null;
+    if (!title)
+        throw new Error('--title requerido');
+    const channelRef = typeof opts.channel === 'string' ? opts.channel : null;
+    if (!channelRef)
+        throw new Error('--channel <slug-or-id> requerido');
+    const { client } = await getAuthedClient();
+    const channelId = await resolveChannel(client, channelRef);
+    const campaignId = typeof opts.campaign === 'string' ? await resolveCampaign(client, opts.campaign) : null;
+    const ownerId = await maybeResolve(client, 'team_member', opts.ownerEmail);
+    const callerId = await getCallerTeamMemberId(client);
+    const status = typeof opts.status === 'string' ? ensureEnum(POST_STATUSES, opts.status, 'status') : 'draft';
+    const slug = typeof opts.slug === 'string' && opts.slug ? slugify(opts.slug) : slugify(title);
+    const payload = {
+        internal_title: title,
+        slug,
+        campaign_id: campaignId,
+        primary_channel_id: channelId,
+        audience: typeof opts.audience === 'string' ? opts.audience : null,
+        objective: typeof opts.objective === 'string' ? opts.objective : null,
+        format: typeof opts.format === 'string' ? opts.format : null,
+        copy_main: typeof opts.copy === 'string' ? opts.copy : null,
+        cta_label: typeof opts.ctaLabel === 'string' ? opts.ctaLabel : null,
+        cta_url: typeof opts.ctaUrl === 'string' ? opts.ctaUrl : null,
+        owner_id: ownerId,
+        status,
+        scheduled_at: typeof opts.scheduledAt === 'string' ? new Date(opts.scheduledAt).toISOString() : null,
+        internal_notes: typeof opts.notes === 'string' ? opts.notes : null,
+        hashtags: typeof opts.hashtags === 'string'
+            ? opts.hashtags.split(',').map((s) => s.trim().replace(/^#/, '')).filter(Boolean)
+            : [],
+        created_by: callerId,
+    };
+    const { data, error } = await client.from('marketing_posts').insert(payload).select('*').single();
+    if (error)
+        throw error;
+    const post = data;
+    await client.from('marketing_status_events').insert({
+        post_id: post.id,
+        from_status: null,
+        to_status: status,
+        changed_by: callerId,
+        changed_by_type: 'user',
+    });
+    output(data, { pretty: !!opts.pretty });
+}
+async function updatePost(args, opts) {
+    const ref = args.id;
+    if (!ref)
+        throw new Error('Falta <id-or-slug>');
     const { client } = await getAuthedClient();
+    const id = await resolvePost(client, ref);
+    const patch = {};
+    if (typeof opts.title === 'string')
+        patch.internal_title = opts.title;
+    if (typeof opts.copy === 'string')
+        patch.copy_main = opts.copy;
+    if (typeof opts.ctaLabel === 'string')
+        patch.cta_label = opts.ctaLabel;
+    if (typeof opts.ctaUrl === 'string')
+        patch.cta_url = opts.ctaUrl;
+    if (typeof opts.finalUrl === 'string')
+        patch.final_url = opts.finalUrl;
+    if (typeof opts.audience === 'string')
+        patch.audience = opts.audience;
+    if (typeof opts.objective === 'string')
+        patch.objective = opts.objective;
+    if (typeof opts.format === 'string')
+        patch.format = opts.format;
+    if (typeof opts.notes === 'string')
+        patch.internal_notes = opts.notes;
+    if (typeof opts.scheduledAt === 'string')
+        patch.scheduled_at = new Date(opts.scheduledAt).toISOString();
+    if (typeof opts.hashtags === 'string')
+        patch.hashtags = opts.hashtags.split(',').map((s) => s.trim().replace(/^#/, '')).filter(Boolean);
+    if (typeof opts.campaign === 'string')
+        patch.campaign_id = await resolveCampaign(client, opts.campaign);
+    if (typeof opts.channel === 'string')
+        patch.primary_channel_id = await resolveChannel(client, opts.channel);
+    if (typeof opts.ownerEmail === 'string')
+        patch.owner_id = await maybeResolve(client, 'team_member', opts.ownerEmail);
+    if (Object.keys(patch).length === 0)
+        throw new Error('Sin cambios.');
+    const { data, error } = await client.from('marketing_posts').update(patch).eq('id', id).select('*').single();
+    if (error)
+        throw error;
+    output(data, { pretty: !!opts.pretty });
+}
+async function setPostStatus(args, opts) {
+    const ref = args.id;
+    const newStatusRaw = args.status;
+    if (!ref)
+        throw new Error('Falta <id-or-slug>');
+    if (!newStatusRaw)
+        throw new Error('Falta <new-status>');
+    const newStatus = ensureEnum(POST_STATUSES, newStatusRaw, 'status');
+    const { client } = await getAuthedClient();
+    const id = await resolvePost(client, ref);
+    const { data: prev, error: prevErr } = await client
+        .from('marketing_posts')
+        .select('status')
+        .eq('id', id)
+        .single();
+    if (prevErr)
+        throw prevErr;
+    const previousStatus = prev.status;
+    const { error } = await client.from('marketing_posts').update({ status: newStatus }).eq('id', id);
+    if (error)
+        throw error;
+    const callerId = await getCallerTeamMemberId(client);
+    await client.from('marketing_status_events').insert({
+        post_id: id,
+        from_status: previousStatus,
+        to_status: newStatus,
+        changed_by: callerId,
+        changed_by_type: 'user',
+        reason: typeof opts.reason === 'string' ? opts.reason : null,
+    });
+    output({ post_id: id, from: previousStatus, to: newStatus, reason: opts.reason ?? null }, { pretty: !!opts.pretty });
+}
+async function deletePost(args, opts) {
+    const ref = args.id;
+    if (!ref)
+        throw new Error('Falta <id-or-slug>');
+    if (!opts.confirm)
+        throw new Error('Pasa --confirm para borrar (cascade en assets, publications, events).');
+    const { client } = await getAuthedClient();
+    const id = await resolvePost(client, ref);
+    const { error } = await client.from('marketing_posts').delete().eq('id', id);
+    if (error)
+        throw error;
+    output({ deleted: id }, { pretty: !!opts.pretty });
+}
+// ─── Post Assets ───────────────────────────────────────────────────────────
+async function listPostAssets(args, opts) {
+    const ref = args.postId;
+    if (!ref)
+        throw new Error('Falta <post-id>');
+    const { client } = await getAuthedClient();
+    const id = await resolvePost(client, ref);
+    const { data, error } = await client
+        .from('marketing_post_assets')
+        .select('*, asset:marketing_assets(*)')
+        .eq('post_id', id)
+        .order('sort_order');
+    if (error)
+        throw error;
+    output(data ?? [], { pretty: !!opts.pretty, columns: parseColumns(opts) });
+}
+async function addPostAsset(args, opts) {
+    const ref = args.postId;
+    if (!ref)
+        throw new Error('Falta <post-id>');
+    const value = typeof opts.assetIdOrUrl === 'string' ? opts.assetIdOrUrl : null;
+    if (!value)
+        throw new Error('--asset-id-or-url requerido');
+    const role = typeof opts.role === 'string' ? ensureEnum(ASSET_ROLES, opts.role, 'role') : 'primary';
+    const sortOrder = typeof opts.sortOrder === 'string' ? Number(opts.sortOrder) : 0;
+    const { client } = await getAuthedClient();
+    const postId = await resolvePost(client, ref);
+    let assetId;
+    if (UUID_RE.test(value)) {
+        assetId = value;
+    }
+    else {
+        // Tratamos como URL externa.
+        const guess = value.match(/\.(mp4|mov|webm)/i)
+            ? 'video'
+            : value.match(/\.(jpg|jpeg|png|gif|webp|avif)/i)
+                ? 'image'
+                : 'other';
+        const callerId = await getCallerTeamMemberId(client);
+        const { data: created, error: cErr } = await client
+            .from('marketing_assets')
+            .insert({
+            asset_type: guess,
+            url: value,
+            storage_provider: 'external',
+            created_by: callerId,
+        })
+            .select('id')
+            .single();
+        if (cErr)
+            throw cErr;
+        assetId = created.id;
+    }
+    const { data, error } = await client
+        .from('marketing_post_assets')
+        .insert({ post_id: postId, asset_id: assetId, role, sort_order: sortOrder })
+        .select('*')
+        .single();
+    if (error)
+        throw error;
+    output(data, { pretty: !!opts.pretty });
+}
+async function removePostAsset(args, opts) {
+    const postRef = args.postId;
+    const assetId = args.assetId;
+    if (!postRef || !assetId)
+        throw new Error('Faltan args <post-id> <asset-id>');
+    const { client } = await getAuthedClient();
+    const postId = await resolvePost(client, postRef);
     let q = client
-        .from('marketing_metrics')
-        .select('id, campaign_id, post_id, platform, metric_type, metric_date, value, created_at')
-        .order('metric_date', { ascending: false })
+        .from('marketing_post_assets')
+        .delete()
+        .eq('post_id', postId)
+        .eq('asset_id', assetId);
+    if (typeof opts.role === 'string')
+        q = q.eq('role', ensureEnum(ASSET_ROLES, opts.role, 'role'));
+    const { error } = await q;
+    if (error)
+        throw error;
+    output({ removed: { post_id: postId, asset_id: assetId } }, { pretty: !!opts.pretty });
+}
+// ─── Assets ────────────────────────────────────────────────────────────────
+async function listAssets(_a, opts) {
+    const { client } = await getAuthedClient();
+    let q = client
+        .from('marketing_assets')
+        .select('*')
+        .order('created_at', { ascending: false })
         .limit(parseLimit(opts));
-    if (typeof opts.campaignId === 'string')
-        q = q.eq('campaign_id', opts.campaignId);
-    if (typeof opts.platform === 'string')
-        q = q.eq('platform', opts.platform);
+    if (typeof opts.type === 'string')
+        q = q.eq('asset_type', ensureEnum(ASSET_TYPES, opts.type, 'type'));
     if (typeof opts.since === 'string')
-        q = q.gte('metric_date', opts.since);
+        q = q.gte('created_at', opts.since);
     const { data, error } = await q;
     if (error)
         throw error;
     output(data ?? [], { pretty: !!opts.pretty, columns: parseColumns(opts) });
 }
-async function listPosts(_a, opts) {
+async function createAsset(_a, opts) {
+    const url = typeof opts.url === 'string' ? opts.url : null;
+    if (!url)
+        throw new Error('--url requerido');
+    const type = ensureEnum(ASSET_TYPES, String(opts.type ?? 'image'), 'type');
     const { client } = await getAuthedClient();
-    let q = client
-        .from('social_media_posts')
+    const callerId = await getCallerTeamMemberId(client);
+    const { data, error } = await client
+        .from('marketing_assets')
+        .insert({
+        asset_type: type,
+        url,
+        storage_provider: 'external',
+        filename: typeof opts.filename === 'string' ? opts.filename : null,
+        alt_text: typeof opts.altText === 'string' ? opts.altText : null,
+        notes: typeof opts.notes === 'string' ? opts.notes : null,
+        created_by: callerId,
+    })
         .select('*')
-        .order('created_at', { ascending: false })
+        .single();
+    if (error)
+        throw error;
+    output(data, { pretty: !!opts.pretty });
+}
+// ─── Publications ──────────────────────────────────────────────────────────
+async function listPublications(_a, opts) {
+    const { client } = await getAuthedClient();
+    let q = client
+        .from('marketing_publications')
+        .select(`*, channel:marketing_channels(slug, name), post:marketing_posts(internal_title, slug)`)
+        .order('scheduled_at', { ascending: false, nullsFirst: false })
         .limit(parseLimit(opts));
-    if (typeof opts.platform === 'string')
-        q = q.eq('platform', opts.platform);
+    if (typeof opts.status === 'string')
+        q = q.eq('status', ensureEnum(PUBLICATION_STATUSES, opts.status, 'status'));
+    if (typeof opts.channel === 'string') {
+        const channelId = await resolveChannel(client, opts.channel);
+        q = q.eq('channel_id', channelId);
+    }
+    if (typeof opts.from === 'string')
+        q = q.gte('scheduled_at', opts.from);
+    if (typeof opts.to === 'string')
+        q = q.lte('scheduled_at', opts.to);
     const { data, error } = await q;
     if (error)
         throw error;
     output(data ?? [], { pretty: !!opts.pretty, columns: parseColumns(opts) });
 }
-async function listAssets(_a, opts) {
+async function listPostPublications(args, opts) {
+    const ref = args.postId;
+    if (!ref)
+        throw new Error('Falta <post-id>');
     const { client } = await getAuthedClient();
+    const id = await resolvePost(client, ref);
     const { data, error } = await client
-        .from('marketing_assets')
+        .from('marketing_publications')
+        .select('*, channel:marketing_channels(slug, name)')
+        .eq('post_id', id)
+        .order('created_at', { ascending: false });
+    if (error)
+        throw error;
+    output(data ?? [], { pretty: !!opts.pretty, columns: parseColumns(opts) });
+}
+async function createPublication(args, opts) {
+    const ref = args.postId;
+    const channelRef = typeof opts.channel === 'string' ? opts.channel : null;
+    if (!ref)
+        throw new Error('Falta <post-id>');
+    if (!channelRef)
+        throw new Error('--channel <slug-or-id> requerido');
+    const { client } = await getAuthedClient();
+    const postId = await resolvePost(client, ref);
+    const channelId = await resolveChannel(client, channelRef);
+    const status = typeof opts.status === 'string'
+        ? ensureEnum(PUBLICATION_STATUSES, opts.status, 'status')
+        : 'pending';
+    const { data, error } = await client
+        .from('marketing_publications')
+        .insert({
+        post_id: postId,
+        channel_id: channelId,
+        status,
+        scheduled_at: typeof opts.scheduledAt === 'string' ? new Date(opts.scheduledAt).toISOString() : null,
+    })
+        .select('*')
+        .single();
+    if (error)
+        throw error;
+    output(data, { pretty: !!opts.pretty });
+}
+async function updatePublication(args, opts) {
+    const id = args.id;
+    if (!id || !UUID_RE.test(id))
+        throw new Error('Falta <id> de la publicación (uuid)');
+    const patch = {};
+    if (typeof opts.status === 'string')
+        patch.status = ensureEnum(PUBLICATION_STATUSES, opts.status, 'status');
+    if (typeof opts.externalUrl === 'string')
+        patch.external_url = opts.externalUrl;
+    if (typeof opts.externalId === 'string')
+        patch.external_id = opts.externalId;
+    if (typeof opts.evidenceUrl === 'string')
+        patch.evidence_url = opts.evidenceUrl;
+    if (typeof opts.publishedAt === 'string')
+        patch.published_at = new Date(opts.publishedAt).toISOString();
+    if (typeof opts.errorMessage === 'string')
+        patch.error_message = opts.errorMessage;
+    if (Object.keys(patch).length === 0)
+        throw new Error('Sin cambios.');
+    const { client } = await getAuthedClient();
+    const { data, error } = await client
+        .from('marketing_publications')
+        .update(patch)
+        .eq('id', id)
+        .select('*')
+        .single();
+    if (error)
+        throw error;
+    output(data, { pretty: !!opts.pretty });
+}
+async function markPublicationPublished(args, opts) {
+    const id = args.id;
+    if (!id || !UUID_RE.test(id))
+        throw new Error('Falta <id> de la publicación (uuid)');
+    if (typeof opts.externalUrl !== 'string' || !opts.externalUrl)
+        throw new Error('--external-url requerido');
+    const { client } = await getAuthedClient();
+    const callerId = await getCallerTeamMemberId(client);
+    const { data, error } = await client
+        .from('marketing_publications')
+        .update({
+        status: 'published',
+        external_url: opts.externalUrl,
+        evidence_url: typeof opts.evidenceUrl === 'string' ? opts.evidenceUrl : null,
+        published_at: typeof opts.publishedAt === 'string'
+            ? new Date(opts.publishedAt).toISOString()
+            : new Date().toISOString(),
+        published_by: callerId,
+    })
+        .eq('id', id)
+        .select('*')
+        .single();
+    if (error)
+        throw error;
+    output(data, { pretty: !!opts.pretty });
+}
+// ─── Events (status histórico) ─────────────────────────────────────────────
+async function listPostEvents(args, opts) {
+    const ref = args.postId;
+    if (!ref)
+        throw new Error('Falta <post-id>');
+    const { client } = await getAuthedClient();
+    const id = await resolvePost(client, ref);
+    const { data, error } = await client
+        .from('marketing_status_events')
         .select('*')
+        .eq('post_id', id)
         .order('created_at', { ascending: false })
         .limit(parseLimit(opts));
     if (error)
         throw error;
     output(data ?? [], { pretty: !!opts.pretty, columns: parseColumns(opts) });
 }
+// ─── Reviews ───────────────────────────────────────────────────────────────
+async function requestReview(args, opts) {
+    const ref = args.postId;
+    if (!ref)
+        throw new Error('Falta <post-id>');
+    const { client } = await getAuthedClient();
+    const postId = await resolvePost(client, ref);
+    const reviewerId = await maybeResolve(client, 'team_member', opts.reviewerEmail);
+    const { data, error } = await client
+        .from('marketing_reviews')
+        .insert({ post_id: postId, reviewer_id: reviewerId, status: 'requested' })
+        .select('*')
+        .single();
+    if (error)
+        throw error;
+    output(data, { pretty: !!opts.pretty });
+}
+async function resolveReview(args, opts) {
+    const id = args.id;
+    if (!id || !UUID_RE.test(id))
+        throw new Error('Falta <id> de la revisión (uuid)');
+    const status = ensureEnum(REVIEW_STATUSES, String(opts.status ?? ''), 'review status');
+    if (status === 'requested')
+        throw new Error('Usa otro estado: approved | changes_requested | rejected');
+    const { client } = await getAuthedClient();
+    const { data, error } = await client
+        .from('marketing_reviews')
+        .update({
+        status,
+        comment: typeof opts.comment === 'string' ? opts.comment : null,
+        resolved_at: new Date().toISOString(),
+    })
+        .eq('id', id)
+        .select('*')
+        .single();
+    if (error)
+        throw error;
+    output(data, { pretty: !!opts.pretty });
+}
+// ─── Metrics ───────────────────────────────────────────────────────────────
+async function listMetrics(_a, opts) {
+    const { client } = await getAuthedClient();
+    let q = client
+        .from('marketing_metrics')
+        .select('*')
+        .order('captured_at', { ascending: false })
+        .limit(parseLimit(opts));
+    if (typeof opts.publicationId === 'string')
+        q = q.eq('publication_id', opts.publicationId);
+    if (typeof opts.from === 'string')
+        q = q.gte('captured_at', opts.from);
+    if (typeof opts.to === 'string')
+        q = q.lte('captured_at', opts.to);
+    const { data, error } = await q;
+    if (error)
+        throw error;
+    output(data ?? [], { pretty: !!opts.pretty, columns: parseColumns(opts) });
+}
+async function recordMetric(_a, opts) {
+    const publicationId = typeof opts.publicationId === 'string' ? opts.publicationId : null;
+    if (!publicationId || !UUID_RE.test(publicationId))
+        throw new Error('--publication-id (uuid) requerido');
+    const source = typeof opts.source === 'string' ? ensureEnum(METRIC_SOURCES, opts.source, 'source') : 'manual';
+    const numericKeys = ['impressions', 'reach', 'clicks', 'likes', 'comments', 'shares', 'saves', 'leads'];
+    const payload = { publication_id: publicationId, source };
+    for (const k of numericKeys) {
+        if (typeof opts[k] === 'string')
+            payload[k] = Number(opts[k]);
+    }
+    if (typeof opts.ctr === 'string')
+        payload.ctr = Number(opts.ctr);
+    if (typeof opts.rawData === 'string')
+        payload.raw_data = JSON.parse(opts.rawData);
+    const { client } = await getAuthedClient();
+    const { data, error } = await client.from('marketing_metrics').insert(payload).select('*').single();
+    if (error)
+        throw error;
+    output(data, { pretty: !!opts.pretty });
+}
+// ─── Module spec ───────────────────────────────────────────────────────────
 export const marketingModule = {
     name: 'marketing',
-    summary: 'Marketing — campaigns, attribution, metrics, posts, assets',
+    summary: 'Marketing Planner — campañas, canales, posts, assets, publicaciones, reviews, métricas',
     specs: [
+        // Planner reads ────────────────────────────────────────────────────────
+        {
+            path: ['marketing', 'planner', 'today'],
+            summary: 'Posts programados para hoy con estado, canal y owner',
+            tags: ['read'],
+            options: commonListOptions(),
+            handler: plannerToday,
+        },
+        {
+            path: ['marketing', 'planner', 'week'],
+            summary: 'Posts agrupados por día de la semana',
+            tags: ['read'],
+            options: [
+                { flag: '--week <YYYY-MM-DD>', description: 'fecha-ancla, default = hoy' },
+                ...commonListOptions(),
+            ],
+            handler: plannerWeek,
+        },
+        {
+            path: ['marketing', 'planner', 'blockers'],
+            summary: 'Piezas con falta de copy/canal/fecha o estados que requieren acción',
+            tags: ['read'],
+            options: commonListOptions(),
+            handler: plannerBlockers,
+        },
+        {
+            path: ['marketing', 'planner', 'reports', 'weekly'],
+            summary: 'Resumen semanal: conteos por estado, canal y campaña',
+            tags: ['read'],
+            options: [
+                { flag: '--week <YYYY-MM-DD>', description: 'fecha-ancla, default = hoy' },
+                ...commonListOptions(),
+            ],
+            handler: plannerReportsWeekly,
+        },
+        // Campaigns ────────────────────────────────────────────────────────────
         {
             path: ['marketing', 'campaigns', 'list'],
-            summary: 'List marketing campaigns',
+            summary: 'Listar campañas',
             tags: ['read'],
             options: [
-                { flag: '--status <s>', description: 'status filter' },
-                { flag: '--type <t>', description: 'type filter' },
+                { flag: '--status <s>', description: `filtra estado (${CAMPAIGN_STATUSES.join('|')})` },
                 ...commonListOptions(),
             ],
             handler: listCampaigns,
         },
         {
-            path: ['marketing', 'leads', 'list'],
-            summary: 'List marketing_leads (attribution records)',
+            path: ['marketing', 'campaigns', 'get'],
+            summary: 'Detalle de campaña con sus piezas asociadas',
+            args: [{ name: 'id', required: true, description: 'id (uuid) o slug' }],
             tags: ['read'],
+            options: commonListOptions(),
+            handler: getCampaign,
+        },
+        {
+            path: ['marketing', 'campaigns', 'create'],
+            summary: 'Crear campaña',
+            tags: ['write'],
             options: [
-                { flag: '--campaign-id <uuid>', description: 'filter by campaign' },
-                { flag: '--source <s>', description: 'filter by source' },
+                { flag: '--name <n>', description: 'nombre' },
+                { flag: '--slug <s>', description: 'slug (auto desde name si vacío)' },
+                { flag: '--objective <o>', description: 'objetivo' },
+                { flag: '--status <s>', description: `estado (${CAMPAIGN_STATUSES.join('|')}), default draft` },
+                { flag: '--start-date <YYYY-MM-DD>', description: 'inicio' },
+                { flag: '--end-date <YYYY-MM-DD>', description: 'fin' },
+                { flag: '--budget <amount>', description: 'presupuesto' },
+                { flag: '--landing-url <url>', description: 'landing principal' },
+                { flag: '--utm-campaign <v>', description: 'override utm_campaign (default = slug)' },
+                { flag: '--owner-email <e>', description: 'email del owner' },
+                { flag: '--notes <n>', description: 'notas' },
                 ...commonListOptions(),
             ],
-            handler: listMarketingLeads,
+            handler: createCampaign,
         },
         {
-            path: ['marketing', 'metrics', 'list'],
-            summary: 'List marketing_metrics',
+            path: ['marketing', 'campaigns', 'update'],
+            summary: 'Actualizar campaña',
+            args: [{ name: 'id', required: true, description: 'id (uuid) o slug' }],
+            tags: ['write'],
+            options: [
+                { flag: '--name <n>', description: 'nuevo nombre' },
+                { flag: '--objective <o>', description: 'objetivo' },
+                { flag: '--status <s>', description: `estado (${CAMPAIGN_STATUSES.join('|')})` },
+                { flag: '--start-date <d>', description: 'inicio' },
+                { flag: '--end-date <d>', description: 'fin' },
+                { flag: '--budget <n>', description: 'presupuesto' },
+                { flag: '--landing-url <u>', description: 'landing' },
+                { flag: '--utm-campaign <v>', description: 'utm_campaign' },
+                { flag: '--owner-email <e>', description: 'nuevo owner' },
+                { flag: '--notes <n>', description: 'notas' },
+                ...commonListOptions(),
+            ],
+            handler: updateCampaign,
+        },
+        {
+            path: ['marketing', 'campaigns', 'delete'],
+            summary: 'Borrar campaña (las piezas mantienen campaign_id=NULL)',
+            args: [{ name: 'id', required: true, description: 'id o slug' }],
+            tags: ['destructive', 'write'],
+            options: [
+                { flag: '--confirm', description: 'requerido para confirmar el borrado' },
+                ...commonListOptions(),
+            ],
+            handler: deleteCampaign,
+        },
+        // Channels ─────────────────────────────────────────────────────────────
+        {
+            path: ['marketing', 'channels', 'list'],
+            summary: 'Listar canales',
             tags: ['read'],
             options: [
-                { flag: '--campaign-id <uuid>', description: 'filter by campaign' },
-                { flag: '--platform <p>', description: 'filter by platform' },
-                { flag: '--since <date>', description: 'metric_date >= YYYY-MM-DD' },
+                { flag: '--type <t>', description: `tipo (${CHANNEL_TYPES.join('|')})` },
+                { flag: '--active-only', description: 'solo activos' },
                 ...commonListOptions(),
             ],
-            handler: listMetrics,
+            handler: listChannels,
+        },
+        {
+            path: ['marketing', 'channels', 'create'],
+            summary: 'Crear canal',
+            tags: ['write'],
+            options: [
+                { flag: '--name <n>', description: 'nombre' },
+                { flag: '--slug <s>', description: 'slug (auto desde name)' },
+                { flag: '--type <t>', description: `tipo (${CHANNEL_TYPES.join('|')})` },
+                {
+                    flag: '--publishing-method <m>',
+                    description: `método (${PUBLISHING_METHODS.join('|')}), default manual`,
+                },
+                { flag: '--is-active', description: 'activar (default true)' },
+                { flag: '--config <json>', description: 'public_config como JSON string' },
+                { flag: '--notes <n>', description: 'notas' },
+                ...commonListOptions(),
+            ],
+            handler: createChannel,
         },
+        {
+            path: ['marketing', 'channels', 'update'],
+            summary: 'Actualizar canal',
+            args: [{ name: 'id', required: true, description: 'id (uuid) o slug' }],
+            tags: ['write'],
+            options: [
+                { flag: '--name <n>', description: 'nombre' },
+                { flag: '--publishing-method <m>', description: `método (${PUBLISHING_METHODS.join('|')})` },
+                { flag: '--is-active', description: 'activar' },
+                { flag: '--config <json>', description: 'public_config JSON' },
+                { flag: '--notes <n>', description: 'notas' },
+                ...commonListOptions(),
+            ],
+            handler: updateChannel,
+        },
+        // Posts ────────────────────────────────────────────────────────────────
         {
             path: ['marketing', 'posts', 'list'],
-            summary: 'List social media posts',
+            summary: 'Listar piezas con filtros por estado/canal/campaña/fecha',
             tags: ['read'],
             options: [
-                { flag: '--platform <p>', description: 'filter by platform' },
+                { flag: '--status <s>', description: `estado (${POST_STATUSES.join('|')})` },
+                { flag: '--channel <slug-or-id>', description: 'canal principal' },
+                { flag: '--campaign <slug-or-id>', description: 'campaña' },
+                { flag: '--from <iso>', description: 'scheduled_at >=' },
+                { flag: '--to <iso>', description: 'scheduled_at <=' },
                 ...commonListOptions(),
             ],
             handler: listPosts,
         },
         {
-            path: ['marketing', 'assets', 'list'],
-            summary: 'List marketing assets',
+            path: ['marketing', 'posts', 'get'],
+            summary: 'Pieza con assets, publicaciones, histórico de estado y reviews',
+            args: [{ name: 'id', required: true, description: 'id (uuid) o slug' }],
+            tags: ['read'],
+            options: commonListOptions(),
+            handler: getPost,
+        },
+        {
+            path: ['marketing', 'posts', 'create'],
+            summary: 'Crear nueva pieza editorial',
+            tags: ['write'],
+            options: [
+                { flag: '--title <t>', description: 'título interno' },
+                { flag: '--slug <s>', description: 'slug (auto desde title)' },
+                { flag: '--channel <slug-or-id>', description: 'canal principal' },
+                { flag: '--campaign <slug-or-id>', description: 'campaña' },
+                { flag: '--status <s>', description: `estado (${POST_STATUSES.join('|')}), default draft` },
+                { flag: '--scheduled-at <iso>', description: 'fecha/hora programada' },
+                { flag: '--copy <text>', description: 'copy principal' },
+                { flag: '--cta-label <t>', description: 'texto CTA' },
+                { flag: '--cta-url <u>', description: 'URL CTA' },
+                { flag: '--audience <a>', description: 'audiencia' },
+                { flag: '--objective <o>', description: 'objetivo' },
+                { flag: '--format <f>', description: 'formato' },
+                { flag: '--hashtags <list>', description: 'lista separada por coma' },
+                { flag: '--owner-email <e>', description: 'email del owner' },
+                { flag: '--notes <n>', description: 'notas internas' },
+                ...commonListOptions(),
+            ],
+            handler: createPost,
+        },
+        {
+            path: ['marketing', 'posts', 'update'],
+            summary: 'Actualizar pieza',
+            args: [{ name: 'id', required: true, description: 'id o slug' }],
+            tags: ['write'],
+            options: [
+                { flag: '--title <t>', description: 'título' },
+                { flag: '--copy <text>', description: 'copy' },
+                { flag: '--cta-label <t>', description: 'CTA texto' },
+                { flag: '--cta-url <u>', description: 'CTA URL' },
+                { flag: '--final-url <u>', description: 'URL final con UTM' },
+                { flag: '--scheduled-at <iso>', description: 'fecha programada' },
+                { flag: '--audience <a>', description: 'audiencia' },
+                { flag: '--objective <o>', description: 'objetivo' },
+                { flag: '--format <f>', description: 'formato' },
+                { flag: '--hashtags <list>', description: 'separados por coma' },
+                { flag: '--channel <slug-or-id>', description: 'canal principal' },
+                { flag: '--campaign <slug-or-id>', description: 'campaña' },
+                { flag: '--owner-email <e>', description: 'owner' },
+                { flag: '--notes <n>', description: 'notas internas' },
+                ...commonListOptions(),
+            ],
+            handler: updatePost,
+        },
+        {
+            path: ['marketing', 'posts', 'status', 'set'],
+            summary: 'Cambiar estado de la pieza con histórico',
+            args: [
+                { name: 'id', required: true, description: 'post id o slug' },
+                { name: 'status', required: true, description: POST_STATUSES.join('|') },
+            ],
+            tags: ['write'],
+            options: [{ flag: '--reason <r>', description: 'motivo del cambio' }, ...commonListOptions()],
+            handler: setPostStatus,
+        },
+        {
+            path: ['marketing', 'posts', 'delete'],
+            summary: 'Borrar pieza (cascade en assets, publicaciones, eventos)',
+            args: [{ name: 'id', required: true, description: 'id o slug' }],
+            tags: ['destructive', 'write'],
+            options: [{ flag: '--confirm', description: 'requerido' }, ...commonListOptions()],
+            handler: deletePost,
+        },
+        // Post assets ──────────────────────────────────────────────────────────
+        {
+            path: ['marketing', 'posts', 'assets', 'list'],
+            summary: 'Assets de una pieza',
+            args: [{ name: 'postId', required: true, description: 'post id o slug' }],
             tags: ['read'],
             options: commonListOptions(),
+            handler: listPostAssets,
+        },
+        {
+            path: ['marketing', 'posts', 'assets', 'add'],
+            summary: 'Vincular asset (uuid existente o URL externa) a la pieza',
+            args: [{ name: 'postId', required: true, description: 'post id o slug' }],
+            tags: ['write'],
+            options: [
+                { flag: '--asset-id-or-url <v>', description: 'uuid de asset o URL externa' },
+                { flag: '--role <r>', description: `rol (${ASSET_ROLES.join('|')}), default primary` },
+                { flag: '--sort-order <n>', description: 'orden, default 0' },
+                ...commonListOptions(),
+            ],
+            handler: addPostAsset,
+        },
+        {
+            path: ['marketing', 'posts', 'assets', 'remove'],
+            summary: 'Desvincular asset de la pieza',
+            args: [
+                { name: 'postId', required: true, description: 'post id o slug' },
+                { name: 'assetId', required: true, description: 'asset uuid' },
+            ],
+            tags: ['destructive', 'write'],
+            options: [
+                { flag: '--role <r>', description: 'desvincular solo en este rol' },
+                ...commonListOptions(),
+            ],
+            handler: removePostAsset,
+        },
+        // Assets ───────────────────────────────────────────────────────────────
+        {
+            path: ['marketing', 'assets', 'list'],
+            summary: 'Listar assets',
+            tags: ['read'],
+            options: [
+                { flag: '--type <t>', description: `tipo (${ASSET_TYPES.join('|')})` },
+                { flag: '--since <iso>', description: 'created_at >=' },
+                ...commonListOptions(),
+            ],
             handler: listAssets,
         },
+        {
+            path: ['marketing', 'assets', 'create'],
+            summary: 'Registrar asset por URL externa (sin upload)',
+            tags: ['write'],
+            options: [
+                { flag: '--url <u>', description: 'URL pública del asset' },
+                { flag: '--type <t>', description: `tipo (${ASSET_TYPES.join('|')}), default image` },
+                { flag: '--filename <f>', description: 'nombre del archivo' },
+                { flag: '--alt-text <t>', description: 'alt text' },
+                { flag: '--notes <n>', description: 'notas' },
+                ...commonListOptions(),
+            ],
+            handler: createAsset,
+        },
+        // Publications ─────────────────────────────────────────────────────────
+        {
+            path: ['marketing', 'publications', 'list'],
+            summary: 'Listar publicaciones',
+            tags: ['read'],
+            options: [
+                { flag: '--status <s>', description: `estado (${PUBLICATION_STATUSES.join('|')})` },
+                { flag: '--channel <slug-or-id>', description: 'canal' },
+                { flag: '--from <iso>', description: 'scheduled_at >=' },
+                { flag: '--to <iso>', description: 'scheduled_at <=' },
+                ...commonListOptions(),
+            ],
+            handler: listPublications,
+        },
+        {
+            path: ['marketing', 'posts', 'publications', 'list'],
+            summary: 'Publicaciones de una pieza',
+            args: [{ name: 'postId', required: true, description: 'post id o slug' }],
+            tags: ['read'],
+            options: commonListOptions(),
+            handler: listPostPublications,
+        },
+        {
+            path: ['marketing', 'posts', 'publications', 'create'],
+            summary: 'Crear publicación para un canal',
+            args: [{ name: 'postId', required: true, description: 'post id o slug' }],
+            tags: ['write'],
+            options: [
+                { flag: '--channel <slug-or-id>', description: 'canal' },
+                { flag: '--scheduled-at <iso>', description: 'fecha programada' },
+                {
+                    flag: '--status <s>',
+                    description: `estado (${PUBLICATION_STATUSES.join('|')}), default pending`,
+                },
+                ...commonListOptions(),
+            ],
+            handler: createPublication,
+        },
+        {
+            path: ['marketing', 'publications', 'update'],
+            summary: 'Actualizar publicación (URL final, evidencia, status, error)',
+            args: [{ name: 'id', required: true, description: 'publication uuid' }],
+            tags: ['write'],
+            options: [
+                { flag: '--status <s>', description: `estado (${PUBLICATION_STATUSES.join('|')})` },
+                { flag: '--external-url <u>', description: 'URL pública publicada' },
+                { flag: '--external-id <id>', description: 'id externo (post id de la red)' },
+                { flag: '--evidence-url <u>', description: 'screenshot/log URL' },
+                { flag: '--published-at <iso>', description: 'fecha real publicación' },
+                { flag: '--error-message <m>', description: 'mensaje de error si falló' },
+                ...commonListOptions(),
+            ],
+            handler: updatePublication,
+        },
+        {
+            path: ['marketing', 'publications', 'mark-published'],
+            summary: 'Atajo: marcar publicada con URL final y evidencia',
+            args: [{ name: 'id', required: true, description: 'publication uuid' }],
+            tags: ['write'],
+            options: [
+                { flag: '--external-url <u>', description: 'URL final (requerido)' },
+                { flag: '--evidence-url <u>', description: 'screenshot/log URL' },
+                { flag: '--published-at <iso>', description: 'fecha (default ahora)' },
+                ...commonListOptions(),
+            ],
+            handler: markPublicationPublished,
+        },
+        // Events / status histórico ────────────────────────────────────────────
+        {
+            path: ['marketing', 'posts', 'events', 'list'],
+            summary: 'Histórico de cambios de estado de una pieza',
+            args: [{ name: 'postId', required: true, description: 'post id o slug' }],
+            tags: ['read'],
+            options: commonListOptions(),
+            handler: listPostEvents,
+        },
+        // Reviews ──────────────────────────────────────────────────────────────
+        {
+            path: ['marketing', 'reviews', 'request'],
+            summary: 'Solicitar revisión de una pieza',
+            args: [{ name: 'postId', required: true, description: 'post id o slug' }],
+            tags: ['write'],
+            options: [
+                { flag: '--reviewer-email <e>', description: 'email del reviewer' },
+                ...commonListOptions(),
+            ],
+            handler: requestReview,
+        },
+        {
+            path: ['marketing', 'reviews', 'resolve'],
+            summary: 'Resolver revisión (approved | changes_requested | rejected)',
+            args: [{ name: 'id', required: true, description: 'review uuid' }],
+            tags: ['write'],
+            options: [
+                { flag: '--status <s>', description: `(${REVIEW_STATUSES.filter((s) => s !== 'requested').join('|')})` },
+                { flag: '--comment <c>', description: 'comentario' },
+                ...commonListOptions(),
+            ],
+            handler: resolveReview,
+        },
+        // Metrics ──────────────────────────────────────────────────────────────
+        {
+            path: ['marketing', 'metrics', 'list'],
+            summary: 'Métricas registradas',
+            tags: ['read'],
+            options: [
+                { flag: '--publication-id <uuid>', description: 'filtrar por publicación' },
+                { flag: '--from <iso>', description: 'captured_at >=' },
+                { flag: '--to <iso>', description: 'captured_at <=' },
+                ...commonListOptions(),
+            ],
+            handler: listMetrics,
+        },
+        {
+            path: ['marketing', 'metrics', 'record'],
+            summary: 'Registrar métricas para una publicación',
+            tags: ['write'],
+            options: [
+                { flag: '--publication-id <uuid>', description: 'requerido' },
+                { flag: '--impressions <n>', description: 'impresiones' },
+                { flag: '--reach <n>', description: 'reach' },
+                { flag: '--clicks <n>', description: 'clicks' },
+                { flag: '--likes <n>', description: 'likes' },
+                { flag: '--comments <n>', description: 'comments' },
+                { flag: '--shares <n>', description: 'shares' },
+                { flag: '--saves <n>', description: 'saves' },
+                { flag: '--leads <n>', description: 'leads atribuidos' },
+                { flag: '--ctr <decimal>', description: 'CTR (0-1)' },
+                { flag: '--source <s>', description: `(${METRIC_SOURCES.join('|')}), default manual` },
+                { flag: '--raw-data <json>', description: 'JSON crudo extra' },
+                ...commonListOptions(),
+            ],
+            handler: recordMetric,
+        },
     ],
 };
 //# sourceMappingURL=marketing.js.map