BPOS-MVP/activities/quote-archive/src/manifest.ts

/**
 * 活动包清单 —— 统一报价 A7 · 情报归档。
 *
 * 业务素材:docs/MVP示例工作流.html §1.7(S1 结果登记 → S2 画像更新 → S3 落地率统计)。
 * 「不成交也留资产:情报、客户画像、落地率」—— 写的是**共享域**,跨活动的沉淀事实。
 */
import type { ActivityManifest } from '@contracts';
import { ARCHIVE_SKILLS } from './skills.ts';
import { CMMN_XML, NARRATIVE, ARCHIVE_STEPS } from './case-model.ts';
import { activityIdSchema } from '@contracts';
import { ARCHIVE_LOGGED, ARCHIVE_RELEASE } from './views/report.ts';

const ACTIVITY_ID = activityIdSchema.parse('quote-archive');
/** 本活动自己的数据域 —— 三张沉淀表落 `shared`,只有归档结论落这儿 */
const DOMAIN = 'quote_archive';

export const manifest: ActivityManifest = {
  identity: {
    activityId: ACTIVITY_ID,
    name: 'A7 · 情报归档',
    packageVersion: '2.1.0',
    category: '统一报价',
    sdkVersion: '0.1.0-m5',
    checksum: 'dev-checksum-quote-archive',
  },

  contract: {
    activityId: ACTIVITY_ID,
    version: '0.1.0',
    input: {
      data: {
        type: 'object',
        required: ['rfqRef', 'customerCode', 'quoteNo'],
        properties: {
          /** 归档写 (pn, quoted_at) 这一行,两个主键都由调用方给定 */
          rfqRef: { type: 'string', title: '询价单号(单标识,贯穿全流程)' },
          pn: { type: 'string' },
          quotedAt: { type: 'string' },
          customerCode: { type: 'string' },
          quoteNo: { type: 'string' },
          reason: { type: 'string' },
          competitorPrice: { type: 'number' },
        },
      },
      messageAllowed: true,
    },
    output: {
      mandatory: [
        {
          name: 'archived',
          payload: { type: 'object', properties: { landingRate: { type: 'number' } } },
          description: '归档闭环:情报回写 + 落地率落账',
        },
      ],
      selective: [],
    },
    /*
     * 必交付物**必须给 `ledger` 地址**(2026-07-31 修)。
     * 不给的话预检退回 `scope[key]` 去找 —— key 是 `benchmark-table` 这样的短横线别名,
     * 任务视图里永远没有这个键,于是「必交付物缺一不得提交放行」永远拒,
     * 活办完了也放不了行,连拒五拍熔断(实测 A2 死于此)。
     */
    requiredDeliverables: [
      { key: 'history-archive', label: '历史价格情报(归档)', ledger: 'market.price_history' },
      { key: 'landing-stats', label: '报价落地率统计', ledger: 'shared.landing_stats' },
    ],
    /*
     * 机检谓词读的是 `verdict` 那张**汇总表**的列(照 A1 的口径)。
     * 上一版的名字(reasonLogged / profileUpdated)**台账里根本没有** —— S-FEEL 拿未绑定的名字
     * 比大小求值为假,判据永远达不了标,submit 门永远拒,连拒五拍熔断。
     * 判据的名字必须落在台账上,否则「机检」是一句空话(2026-07-31 销账)。
     */
    acceptanceCriteria: [
      { key: 'reason-logged', label: '拒绝原因 / 竞对价位已回写', level: 'L1', predicate: 'reason_logged_total > 0' },
      { key: 'profile-updated', label: '客户画像标签已更新', level: 'L2', predicate: 'profile_updated_total > 0' },
      { key: 'bd-release', label: 'BD 放行', level: 'L5' },
    ],
    revisableAtRelease: [],
    prohibitions: [{ key: 'no-blank-archive', statement: '不得空归档 —— 每一单不成交的报价也是情报资产' }],
    authorization: { discretion: [], preauthorizedActions: [], humanCallBudget: 2 },
    resources: {
      tools: [],
      skills: ARCHIVE_SKILLS.map((s) => s.id),
      models: ['deepseek-v4-flash'],
      roles: ['BD'],
      budget: { steps: 30, tokens: 60_000, activeMinutes: 60, humanCalls: 2 },
    },
  },

  declarations: {
    models: ['deepseek-v4-flash'],
    tools: [],
    ledger: [
      {
        // 共享域:跨活动的沉淀事实(AM 11.3 暗耦合禁令的两条合法路径之一)
        domain: 'market',
        object: 'price_history',
        kind: 'master',
        label: '历史价格情报',
        fields: [
          { name: 'pn', type: 'text', primaryKey: true, masked: false },
          { name: 'quoted_at', type: 'date', primaryKey: true, masked: false },
          { name: 'lost_reason', type: 'text', primaryKey: false, masked: false, label: '拒绝原因' },
          { name: 'competitor_price', type: 'number', primaryKey: false, masked: false, label: '竞对价位' },
        ],
      },
      {
        domain: 'customer',
        object: 'profile',
        kind: 'master',
        label: '客户资料库',
        fields: [
          { name: 'customer_code', type: 'text', primaryKey: true, masked: false, label: '客户码' },
          { name: 'grade', type: 'text', primaryKey: false, masked: false, label: '客户等级' },
          { name: 'profile_tags', type: 'text', primaryKey: false, masked: false, label: '画像标签' },
        ],
      },
      {
        domain: 'shared',
        object: 'landing_stats',
        kind: 'derived',
        label: '报价落地率统计',
        fields: [
          { name: 'period', type: 'text', primaryKey: true, masked: false, label: '月份' },
          { name: 'landing_rate', type: 'number', primaryKey: false, masked: false, label: '落地率' },
          { name: 'type_a_hit', type: 'number', primaryKey: false, masked: false, label: 'TypeA命中' },
          { name: 'reply_rate_d3', type: 'number', primaryKey: false, masked: false, label: 'D+3回复率' },
        ],
      },
      {
        /*
         * 归档结论 —— 一单一行的**汇总表**,验收机检谓词的入参就在这儿。
         * 汇总列与逐行列**故意不同名**:任务视图把草稿行摊平到顶层是「后写的赢」,
         * 拿逐行列求值只会验到最后写的那一行,那不叫机检、叫抽样(A1 的教训)。
         */
        domain: DOMAIN,
        object: 'verdict',
        kind: 'record',
        caseKey: 'rfq_ref',
        label: '归档结论',
        fields: [
          { name: 'rfq_ref', type: 'text', primaryKey: true, masked: false, label: '询价单号' },
          { name: 'quote_no', type: 'text', primaryKey: false, masked: false, label: '报价单号' },
          { name: 'archived_total', type: 'integer', primaryKey: false, masked: false, label: '已归档条数' },
          { name: 'reason_logged_total', type: 'integer', primaryKey: false, masked: false, label: '已回写原因条数' },
          { name: 'profile_updated_total', type: 'integer', primaryKey: false, masked: false, label: '已更新画像条数' },
          { name: 'summary', type: 'text', primaryKey: false, masked: false, label: '归档结论' },
        ],
      },
    ],
    listeners: [],
    // 7 天闭环(MVP示例 §1.7)
    harness: { memoryWindow: 15, stallAfter: 'P1D', nudge: [], retry: { times: 2, backoff: 'PT30S' } },
  },

  assets: {
    /* 资产初始版:案例模型(2026-07-29 起活动只有这一种业务模型) */
    businessModel: {
      cmmnXml: CMMN_XML,
      narrative: NARRATIVE,
      dmn: { drd: [], tables: [] },
      /* 步骤剧本 —— 与 A1 同一套:doneWhen 真了引擎自己收步,不问模型 */
      steps: ARCHIVE_STEPS,
    },
    skills: ARCHIVE_SKILLS,
    viewTemplates: [
      { name: 'archive-logged', html: ARCHIVE_LOGGED },
      { name: 'archive-release', html: ARCHIVE_RELEASE },
    ],
    cardSchemas: {},
    distillHooks: [
      { on: 'terminal', prompt: '归纳丢单的共性:价格、交期、竞对、客户类型 —— 供下一单更快更准。' },
    ],
  },

  samples: [
    {
      name: '客户拒绝',
      input: { customerCode: 'C001', quoteNo: 'Q202601', reason: '竞对报价更低' },
      expect: { ports: ['archived'] },
    },
  ],

  entry: { file: 'index.js', checksum: 'dev-entry-quote-archive' },
};