pacxio 0.0.1__py3-none-any.whl

pacxio/__init__.py

@@ -0,0 +1,3 @@
+"""pacxio —— 包装印前引擎。"""
+
+__version__ = "0.0.1"

pacxio/__main__.py

@@ -0,0 +1,6 @@
+"""python -m pacxio ... 等价于 pacxio ...（没有把命令装进 PATH 时用）。"""
+
+from pacxio.cli import main
+
+if __name__ == "__main__":
+    main()

pacxio/_conventions/paint.yaml

@@ -0,0 +1,58 @@
+# 常规参考表："Home improvement · Paint"（docs/FLOW_V2.md 2.2）
+#
+# 用途：出概念图时写进提示词，告诉 AI "这类包装一般这么排"——只是提示，AI 可以按设计需要变通；
+# 看图后 agent 用它核对：哪些信息放得不寻常、有没有漏掉通常必有的东西。
+# 全部是【初值】：来自通常做法，未经品牌方、印厂或法规顾问确认。法规相关的只做提醒，由用户确认。
+
+id: paint
+name_zh: "Home improvement · Paint"
+description: "Folding cartons and shipping cases for wall paint, wood finishes and primers"
+verified: false
+
+# 各类信息通常放在哪些面（front 正面 / back 背面 / side 侧面 / top 顶面 / bottom 底面），排在前面的更常见
+faces:
+  brand: [front, back, top, side]
+  logo: [front, back, top, side]
+  product_name: [front, back]
+  variant: [front]            # 内墙 / 外墙、木器、底漆面漆；颜色、光泽
+  spec: [front, side]         # 容量（1L、5L）
+  net_content: [front]
+  slogan: [front, side]
+  selling_point: [front, back, side]
+  icon: [front, side]
+  description: [back, side]
+  usage: [back, side]         # 施工步骤
+  technical: [back, side]     # 涂布率、表干 / 实干、重涂间隔、VOC
+  ingredients: [side]
+  caution: [side, back]       # 安全警示、急救
+  storage: [side]
+  standard: [side]
+  manufacturer: [side]
+  contact: [side]
+  origin: [side]
+  barcode: [side]
+  certification: [side, front]
+  batch: [bottom, side]
+
+# 常见版式（提示词里给 AI 参考；也用于看图后说明这个方向属于哪一种）
+layouts:
+  - id: same_front_back
+    name_zh: "Matching front and back"
+    front: "Key visual, brand, product name, category / colour and sheen, volume, main selling points"
+    back: "Same as the front"
+    sides: "Use one side for application instructions and technical data. Use the other for precautions, applicable standards, manufacturer, barcode and country of origin. Vertical branding is also common."
+    common_for: "Shipping cases, cartons for large paint containers, and products displayed with either face outward"
+  - id: split
+    name_zh: "Different roles for front and back"
+    front: "Key visual, brand, product name, category / colour and sheen, volume, main selling points"
+    back: "Brand story or product introduction, application steps and technical data"
+    sides: "Precautions, applicable standards, manufacturer, barcode and country of origin. Use the other side for the brand or tagline."
+    common_for: "Small retail cartons and gift boxes"
+
+# 提醒（不是规定）：看图核对时逐条提示用户，由用户按现行标准与法规确认
+reminders:
+  - "For paint packaging, check the applicable marking standard in the target market (for example, GB/T 9750 in China). Verify requirements for product name and model, applicable standards, net contents, production date or batch, manufacturer name and address, storage and safety information."
+  - "Check whether the target market requires packaging disclosures about hazardous substance limits for architectural coatings and wood finishes."
+  - "Net contents usually appear on the principal display panel. Check the target market’s requirements for placement and character height."
+  - "Leave sufficient quiet zones around the barcode, use a white or light background, and keep it clear of folds."
+  - "Batch codes and production dates are usually added after printing. Reserve blank space for them in the artwork."

pacxio/_profiles/default.yaml

@@ -0,0 +1,157 @@
+id: default
+name: Default
+verified: true                 # 2026-10-24 用户：实物打样验证通过，配置档数值经工厂确认（规格补 21）
+units: mm
+
+bleed_mm: 3                    # 出血
+safe_margin_mm: 3              # 文字/Logo 距切线与折线
+glue_flap:
+  ink: bleed_only              # none | bleed_only | full
+  bleed_into_mm: 2             # 图文可伸入糊口的距离
+tac_limit_pct: 300             # 总墨量上限，铜版纸胶印常见 300–320%
+flexo:                         # 柔印（开槽箱水印）：job 的 print.method = flexo 时代替上面的数值
+  tac_limit_pct: 240           # 水印直接印在瓦楞纸板上，吃墨多、干得慢，总墨量比胶印低
+  min_text_pt: 8               # 水印网线粗、易糊版，小字要大一些
+  min_print_line_mm: 0.3       # 图形里最细的线（开槽箱测试 R-09，补 47，要工厂确认，不在 2026-10-24 确认的范围里）
+  min_print_reverse_mm: 0.5    # 最窄的反白（没墨的细缝、小白点），比正线更容易糊
+min_text_pt: 6                 # 最小字号（pt），小于它给 T05 提醒；法规对净含量等另有字高要求
+icc:
+  path: null                   # 工厂给了自己的 ICC 时填：嵌入生产文件、声明 PDF/X-4
+  name: null
+  auto:                        # 没填 path 时按纸张自动选本机已有的标准 ICC（docs/COLOR_V1.md）：
+    coated:   [JapanColor2001Coated.icc, CoatedFOGRA39.icc]       # 只用来把照片转成印刷色，
+    uncoated: [JapanColor2001Uncoated.icc, UncoatedFOGRA29.icc]   # 不嵌入、不声明 PDF/X-4
+  search_dirs:                 # 装了 Adobe 软件就有；ICC 文件不进代码仓库（CLAUDE.md）
+    - /Library/Application Support/Adobe/Color/Profiles/Recommended
+    - /Library/Application Support/Adobe/Color/Profiles
+    - /Library/ColorSync/Profiles
+    - ~/Library/ColorSync/Profiles
+    - C:/Program Files (x86)/Common Files/Adobe/Color/Profiles/Recommended
+    - C:/Windows/System32/spool/drivers/color
+finish_rules:
+  foil:     { min_line_mm: 0.2, min_gap_mm: 0.3 }
+  spot_uv:  { min_line_mm: 0.3, min_gap_mm: 0.5 }
+  spot_uv_digital: { min_line_mm: 0.1, min_gap_mm: 0.2 }   # 数码 UV（喷墨）：用户确认工厂能做时，工艺加 --process digital 才用（2026-10-30 用户定，补 41；不在工厂确认的范围里）
+  emboss:   { min_line_mm: 0.5, min_gap_mm: 1.0 }   # 击凸、压凹共用
+  white:    { min_line_mm: 0.3, min_gap_mm: 0.5 }   # 白墨
+  crease_clearance_mm: 2
+  registration_tolerance_mm: 0.1   # 工艺超出对应的印刷图形多少就提醒没对齐（F04，补 20 新加，不在工厂确认的范围里）【初值】
+attachment:                    # 配件（金属标，docs/ATTACHMENTS.md；补 40 新加，不在工厂确认的范围里）
+  fold_clearance_mm: 3          # 标的外形离折线 / 刀线至少多远（A01）【初值】
+labels:                        # 不干胶标签（C4，docs/C4_CARRIER_FRAMEWORK.md；不在工厂确认的范围里，全部【初值】）
+  bleed_mm: 2                  # 标签出血
+  safe_margin_mm: 2            # 文字、条码离模切外形至少多远
+  wrap_overlap_mm: 6           # 环标默认搭接
+  wrap_tolerance_mm: 1         # 环标长度和瓶周长 + 搭接差多少就报（L02）
+  panel_max_arc: 0.45          # 前 / 背标最宽占瓶周长的比例
+  min_corner_r_mm: 1           # 模切外形最小圆弧半径（L05）
+  min_concave_r_mm: 2          # 内凹圆弧最小半径（太小模切会撕，L05）
+  arc_fit_tol_mm: 0.05         # 椭圆 / 异形外形用双圆弧逼近的最大误差（守 D4）
+  barcode_max_arc_deg: 30      # 条码横跨的圆心角超过这个就提醒（L04；GS1 资料待查）
+  roll:                        # 卷标交付参数：规格书里写"请标签厂确认"
+    unwind: 1                  # 出标方向（标准 8 个方位）
+    core_mm: 76                # 卷芯内径
+    max_roll_od_mm: 300        # 卷外径上限
+    gap_mm: 3                  # 标签间距
+    across: 1                  # 排数
+    liner_margin_mm: 1.5       # 底纸两边留边
+pouches:                       # 软包装（C5，docs/C5_POUCHES.md；参照 Pacdora 参数化模板，不在工厂确认的范围里，全部【初值】）
+  bleed_mm: 3
+  safe_margin_mm: 3            # 文字离封边内沿至少多远
+  seal_small_mm: 5             # 封边宽：袋宽 ≤ seal_break_w 时 5，否则 7
+  seal_large_mm: 7
+  seal_break_w: 90
+  gusset_k: 0.3                # 自立袋底褶深 G = 0.3·W − 10
+  gusset_b: -10
+  zipper_top_mm: 13            # 拉链带离顶 13–25
+  zipper_w_mm: 12
+  tear_from_top_mm: 9          # 撕口离顶
+  tear_size_mm: 3
+  fin_seal_mm: 9               # 背封袋中缝封
+  end_seal_mm: 12              # 背封袋上下封
+  tolerance_mm: 1.5            # 制袋尺寸公差（规格书写"请制袋厂确认"）
+  flat_depth_k: 0.4            # 平底袋不给底深时 = 0.4 × 正面宽
+  flat_top_seal_mm: 10         # 平底袋顶封
+  flat_bottom_seal_mm: 6       # 平底袋底片四边封、袋身下沿
+  flat_fin_mm: 10              # 平底袋背中缝每边（Pacdora 10）
+  flat_bottom_gap_mm: 10       # 平底袋的底单独一片，排在右边、和袋身之间空 10
+  corner_seal_mm: 3            # 平底袋四条竖角封（跨折线）
+  valve_d_mm: 22               # 单向排气阀直径
+  valve_gap_mm: 10             # 排气阀离拉链带 / 顶封
+  spout_d_mm: 10               # 吸嘴口径（常见 8.6 / 10 / 16 / 22）
+  spout_base_k: 2.6            # 吸嘴船形底座宽 = 2.6 × 口径
+  spout_base_h_mm: 12
+  spout_corner_mm: 28          # 斜角吸嘴的切角直角边
+  handle_w_k: 0.4              # 手提孔宽 = 0.4 × 袋宽，最多 90
+  handle_max_w_mm: 90
+  handle_h_mm: 20
+  handle_top_mm: 15            # 手提孔上沿离顶
+  handle_margin_mm: 8          # 孔四周的手提封
+  window_min_mm: 15            # 透明窗最小边
+  shape_tol_mm: 0.05           # 异形外形转圆弧误差
+  roll:                        # 卷膜交付（自动包装机制袋；请印刷厂、包装机厂确认）
+    unwind: 1                  # 出卷方向（标准 8 个方位）
+    core_mm: 76
+    max_roll_od_mm: 400
+    max_splices: 2             # 每卷接头上限，接头处做标记
+    eye_w_mm: 10               # 光标（电眼色标）横向宽
+    eye_h_mm: 5                # 光标沿走膜方向长
+    eye_edge_mm: 2             # 光标离膜边 / 中缝封
+    eye_lane_mm: 3             # 光标两边留空的电眼通道
+    eye_cmyk: [0, 0, 0, 100]
+    lane_min_lum: 0.6          # 通道里亮度低于 0.6（0 黑 – 1 白）算深，电眼会误读（PO07）
+  fill_default: 0.7            # 装满效果图的鼓起量（job.json 的 pouch.fill 可改）
+  puff_k: 0.25                 # 每面最大鼓起 = 鼓起量 × 0.25 × 内容区短边
+  base_k: 0.9                  # 自立袋底 / 侧风琴撑开的半深 = 鼓起量 × 0.9 × 褶深
+  stretch_warn: 0.08           # PO05：装满后膜要变形超过 8% 的地方
+  small_text_pt: 8             # PO05：小于 8 pt 算小字
+window:                        # 开窗（docs/M4_WINDOW.md）
+  min_size_mm: 10              # 窗口最小边长
+  min_corner_r_mm: 1           # 最小圆角（尖角容易撕裂）
+  default_corner_r_mm: 3       # 圆角矩形窗不给 --r 时的圆角
+  edge_clearance_mm: 6         # 窗口离压线 / 外轮廓 / 糊口落胶位置至少多远（贴窗是工厂的后续工序，不在这里管）
+  min_web_mm: 8                # 两个窗口之间至少留多宽的纸
+  max_area_ratio: 0.6          # 窗口占面积的比例超过这个就提醒（盒子变软）
+
+spot_names:                    # PDF 专色名
+  cut: Dieline_Cut
+  crease: Dieline_Crease
+  perf: Dieline_Perf
+  partial_cut: Dieline_Score
+  reverse_crease: Dieline_ReverseCrease
+  foil_gold: Foil_Gold
+  foil_silver: Foil_Silver
+  foil_copper: Foil_Copper     # 铜金 / 玫瑰金一类的箔（2026-10-29 天地盖测试 F-01）
+  spot_uv: Spot_UV
+  emboss: Emboss
+  deboss: Deboss
+  white: White_Ink
+  glue_area: Glue_Area         # 糊胶区标注（信息层，不印；补 17 起生产文件里也有这一层）
+  keep_clear: Keep_Clear       # 封口 / 拉链 / 撕口 / 搭接区标注（软袋、标签；信息层，不印；C5）
+  annotation: Info_Annotation  # 生产文件的"标注"层（各面尺寸、图例、文件信息；只在出血外，不印）
+  attachment: Attach_Position  # 配件（金属标）的贴标位置：外形线 + 中心十字，信息层，不印（补 40 新加，不在工厂确认的范围里）
+
+dxf:
+  version: R12
+  layers:                      # ACI 颜色号：1 红 3 绿 5 蓝 6 洋红 2 黄
+    cut:            { name: CUT,      aci: 1 }
+    crease:         { name: CREASE,   aci: 3 }
+    perf:           { name: PERF,     aci: 5 }
+    partial_cut:    { name: SCORE,    aci: 6 }
+    reverse_crease: { name: RCREASE,  aci: 2 }
+    glue_area:      { name: GLUE,     aci: 4 }   # 糊胶区标注图层（不是刀线；常规标法）
+    keep_clear:     { name: SEAL,     aci: 6 }   # 封口 / 拉链 / 撕口区标注图层（软袋、标签；不是刀线）
+    attachment:     { name: ATTACH,   aci: 30 }  # 配件贴标位置（不是刀线；补 40）
+
+cf2:
+  units: mm
+  linetypes: { cut: 1, crease: 2, perf: 3, partial_cut: 4, reverse_crease: 5 }   # 参照 CFF2 线型表；反压线按常规单独编号，刀模厂按需映射【初值】
+
+compensation:                  # 见规格 8.5
+  folding_carton: { k_panel: 1.0, k_height: 1.0, k_lid: 1.0 }
+  corrugated:     { k_panel: 1.0, k_height: 1.0, k_lid: 1.0, k_flap: 0.5 }   # k_lid：飞机盒的盖（v0.2）
+
+deliverables: [production_pdf, spec_sheet, dxf]   # 交付包（发给工厂）：分层的生产文件、规格书、刀模 DXF（补 17）
+archive: [confirm_png, preflight_report, preview_png, dieline_pdf, cf2, finish_pdfs]   # 存档（<交付包>_archive/，工厂另要时再给）
+file_preferences:
+  editable_source: layered_pdf   # 有工厂要求 ai / cdr 时在这里标注

pacxio/_profiles/materials.yaml

@@ -0,0 +1,28 @@
+# 材料预设。厚度【初值】，以工厂实测为准（规格第 7 节）。
+sbs_300:   { name: SBS 300 g/m²,     type: folding_carton, caliper_mm: 0.42, flute: null, surface: coated }
+sbs_350:   { name: SBS 350 g/m²,     type: folding_carton, caliper_mm: 0.48, flute: null, surface: coated }
+sbs_400:   { name: SBS 400 g/m²,     type: folding_carton, caliper_mm: 0.55, flute: null, surface: coated }
+gd_350:    { name: White-lined greyback 350 g/m², type: folding_carton, caliper_mm: 0.48, flute: null, surface: coated }
+kraft_350: { name: Kraft board 350 g/m²,   type: folding_carton, caliper_mm: 0.50, flute: null, surface: uncoated }
+flute_e:   { name: E-flute corrugated,     type: corrugated,     caliper_mm: 1.5,  flute: E }
+flute_b:   { name: B-flute corrugated,     type: corrugated,     caliper_mm: 3.0,  flute: B }
+flute_c:   { name: C-flute corrugated,     type: corrugated,     caliper_mm: 4.0,  flute: C }
+flute_bc:  { name: BC double-wall corrugated,  type: corrugated,     caliper_mm: 6.5,  flute: BC }
+# 不干胶标签（C4）：厚度是面材（不含底纸），只用于 3D 离瓶面的距离；film 是膜材种类（透明 / 镀铝要白墨打底）
+label_coated:   { name: Coated paper label stock,   type: label_stock, caliper_mm: 0.08, flute: null, surface: coated }
+label_kraft:    { name: Kraft paper label stock,   type: label_stock, caliper_mm: 0.09, flute: null, surface: uncoated }
+label_textured: { name: Textured paper label stock (wine label), type: label_stock, caliper_mm: 0.12, flute: null, surface: uncoated }
+label_pp_white: { name: White PP label stock,   type: label_stock, caliper_mm: 0.06, flute: null, surface: coated, film: white }
+label_pp_clear: { name: Clear PP label stock, type: label_stock, caliper_mm: 0.05, flute: null, surface: coated, film: clear }
+label_pe_white: { name: White PE label stock (squeeze bottles), type: label_stock, caliper_mm: 0.08, flute: null, surface: coated, film: white }
+label_metallized: { name: Silver metallized label stock, type: label_stock, caliper_mm: 0.06, flute: null, surface: coated, film: metallized }
+# 软包装复合膜（C5）：厚度是总厚（只用于 3D），film 决定要不要白墨（透明 / 镀铝）；复合结构以制袋厂为准【初值】
+pouch_pet_pe_clear:  { name: Clear PET/PE laminate,      type: film_laminate, caliper_mm: 0.10, flute: null, surface: coated, film: clear }
+pouch_pet_vmpet_pe:  { name: Metallized PET/VMPET/PE laminate, type: film_laminate, caliper_mm: 0.11, flute: null, surface: coated, film: metallized }
+pouch_pet_al_pe:     { name: PET/AL/PE foil laminate,    type: film_laminate, caliper_mm: 0.12, flute: null, surface: coated, film: metallized }
+pouch_matte_white:   { name: Matte BOPP/white PE laminate,   type: film_laminate, caliper_mm: 0.10, flute: null, surface: coated, film: white }
+pouch_kraft_pe:      { name: Kraft/PE laminate,          type: film_laminate, caliper_mm: 0.13, flute: null, surface: uncoated, film: kraft }
+pouch_pet_al_rcpp:   { name: PET/AL/RCPP retort laminate (121 °C; ready meals and meat), type: film_laminate, caliper_mm: 0.12, flute: null, surface: coated, film: metallized }
+pouch_ny_pe_clear:   { name: Clear NY/PE laminate (freezer and vacuum), type: film_laminate, caliper_mm: 0.09, flute: null, surface: coated, film: clear }
+pouch_mono_pe_white: { name: White mono-material PE/PE (recyclable), type: film_laminate, caliper_mm: 0.11, flute: null, surface: coated, film: white }
+pouch_kraft_pla:     { name: Kraft/PLA laminate (biodegradable),   type: film_laminate, caliper_mm: 0.13, flute: null, surface: uncoated, film: kraft }

pacxio/_profiles/render-materials.json

@@ -0,0 +1,121 @@
+{
+  "version": "5",
+  "note": "仅供视觉示意的材质预设；不是工厂实测或制造公差。roughness/metallic/clearcoat 为 0–255。relief_* 是击凸 / 压凹在屏幕上的显示参数，不是模具深度：relief_edge_mm 是沿轮廓一圈斜坡的宽度（里外各一半），relief_height_mm 是平顶高出纸面多少，relief_cavity 是凹处压暗的强度（0–1）。 attachment 是配件（金属标）：field 是底面（喷砂哑光，粗糙度高）、relief 是凸起图案（抛光），height 是标面在高度图里的值（128 平、255 最高），edge_mm 是外缘斜坡宽。 static_reflection 是静态效果图的影棚（只看，不随视角换灯）：左前方一块竖长柔光灯板（方向 strip_az_deg / strip_el_deg，0 正前、负值往左；距盒子中心 strip_distance、宽 strip_width、高 strip_height，都是盒子对角线的倍数）加浅色地面（往下看 floor_fade_deg 度提亮到最大）；灯板软边 edge + edge_per_rough × 粗糙度（对角线倍数）；粗糙度 ≥ rough_none 不反光、≤ rough_full 最强；strip_strength / floor_strength 是灯板、地面反光往白色混的最大比例。",
+  "fold": {
+    "crease_radius_caliper": 1.0
+  },
+  "paper": [
+    173,
+    0,
+    0
+  ],
+  "matte_lamination": [
+    150,
+    0,
+    90
+  ],
+  "gloss_lamination": [
+    48,
+    0,
+    240
+  ],
+  "matte_varnish": [
+    140,
+    0,
+    60
+  ],
+  "gloss_varnish": [
+    65,
+    0,
+    210
+  ],
+  "foil_gold": {
+    "base": [
+      217,
+      174,
+      73
+    ],
+    "material": [
+      59,
+      255,
+      0
+    ]
+  },
+  "foil_silver": {
+    "base": [
+      218,
+      222,
+      230
+    ],
+    "material": [
+      51,
+      255,
+      0
+    ]
+  },
+  "foil_copper": {
+    "base": [
+      196,
+      122,
+      84
+    ],
+    "material": [
+      59,
+      255,
+      0
+    ]
+  },
+  "foil_holo": {
+    "base": [
+      200,
+      206,
+      215
+    ],
+    "material": [
+      64,
+      255,
+      0
+    ]
+  },
+  "spot_uv": [
+    30,
+    0,
+    255
+  ],
+  "white": [
+    250,
+    250,
+    250
+  ],
+  "relief_height_mm": 0.3,
+  "relief_edge_mm": 0.5,
+  "relief_cavity": 0.2,
+  "attachment": {
+    "field": [
+      110,
+      255,
+      0
+    ],
+    "relief": [
+      50,
+      255,
+      0
+    ],
+    "height": 200,
+    "edge_mm": 1.0
+  },
+  "static_reflection": {
+    "strip_az_deg": -33,
+    "strip_el_deg": -8,
+    "strip_distance": 1.2,
+    "strip_width": 0.18,
+    "strip_height": 2.6,
+    "edge": 0.05,
+    "edge_per_rough": 0.5,
+    "floor_fade_deg": 30,
+    "strip_strength": 0.24,
+    "floor_strength": 0.04,
+    "rough_none": 160,
+    "rough_full": 30
+  }
+}

pacxio/_skill/packaging-prepress/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: packaging-prepress
+description: "Packaging design to factory-ready print files. First concept images so the decision maker picks a direction, then the final design, confirmed on the dieline confirmation image (3D mockups show the finished look), then a production pack the factory accepts: dieline DXF/CF2/PDF, CMYK print PDF, foil / spot UV plates, spec sheet, preflight report. Use when the user wants packaging design, concept images, mockups, dielines or print files for folding cartons (reverse tuck end, straight tuck end, snap-lock or auto-lock bottom), mailer boxes, corrugated shipping boxes, tray-and-lid or drawer boxes; wants foil, spot UV or embossing; wants to check files for a printer; or wants to view stages on the local workbench and fold the 3D view along the dieline. Also bottle and jar labels and flexible pouches (stand-up, three-side seal, pillow, flat-bottom). Not for: imposition, rigid set-up boxes, shrink sleeves, or structures outside the FEFCO / ECMA catalog that the engine cannot build (see references/structures.md)."
+---
+
+# Packaging prepress (packaging-prepress)
+
+The whole workflow runs through the `pacxio` command line:
+
+> Brief → content list → (lots of copy: layout draft) → **concept images**: main view (pick a direction) → back view → flats → final design rebuilt from the flats → **dieline confirmation image (confirm)** → 3D mockups (view only) → preflight → delivery pack
+
+The user confirms: the content list wording, the layout draft, the concept direction, the flats, and the dieline confirmation image. The first four are records; **`approve` on the dieline confirmation image is the only gate before export**. Concept images confirm the **direction and feel** (AI-drawn: proportions and text are not guaranteed, the images never go into print files; graphics on the flats are traced to vectors for the final artwork). The dieline confirmation image confirms **exactly what will be printed** (it is the same data as the print files). 3D mockups are for viewing, not confirming.
+
+Dielines, 3D views and the structure library run on this machine. Composing artwork, separations, preflight and the delivery pack run on the pacxio server. AI images (concepts and assets) cost the user image credits.
+
+## Hard rules (read first)
+
+1. **Errors mean no factory files.** When `preflight` / `export` report errors, tell the user as they are and fix each one by its `fix` until it passes; never say "the files can go to the factory" while there are errors.
+2. **All text in print files is set by the engine and outlined.** Only concept images may contain AI-drawn text; the engine forces "no text" on print asset prompts, and you must not ask for text in them either. Every piece of text in the final files is placed with `art add --kind text`.
+3. **Concept images are never assets.** Main views, back views and flats must not be cropped, cut out or enlarged into the layout (the engine refuses, and recognises identical pixels). The final design is **rebuilt from the confirmed flats** (from the main view when there are no flats).
+4. **Only the user confirms; never confirm for them.** Run `content confirm`, `plan --confirm`, `concept choose`, `concept confirm` (this set of flats) and `approve` only after the user **clearly says** they confirm / which one they choose. If the design changes after confirmation, `render` again and ask the user to confirm again. The user can also click confirm on the workbench themselves; the agent never clicks it for them and never calls the workbench's confirm endpoint.
+5. **Say plainly what is not verified.** Profile `verified=false`, lid / tuck direction not confirmed (PROFILE / ORIENT / MK03), CF2 not checked by a die maker, no standard ICC found — pass these on as they are, without softening (the `default` profile and the directions of the original eight box styles are confirmed; newer structures are not physically checked yet). ICC profiles are picked by paper automatically; do not ask the user.
+6. **Explain the gap between the concept and the product.** Tell the user when they pick a direction what the engine cannot reproduce (gradients / transparency / shadows inside vectors, special fonts without a font file, AI letterforms and proportions; see `references/design.md`).
+7. **A physical proof comes before a production run.** Remind the user at every delivery.
+8. **Never install anything at run time** (no `pip install` / `uv add`). If something is missing, stop and give the user the install instructions.
+9. **Do not guess key parameters**: size basis (inside / outside), material, text content, finishes. Ask for everything missing at once. Which information **must appear** depends on the category and market regulations; the engine cannot judge it, so ask the user, who is responsible for it.
+10. **The user confirms font licenses.** When `font add` refuses, do not add `--accept-license-risk` yourself; add it only after the user clearly says they have checked (`references/fonts.md`).
+11. **Report structural problems first.** If the dieline does not match expectations, record the style, dieline version, size and where it goes wrong and report it to the developers; do not hand-edit cut lines, switch to a similar style, tweak parameters to make it look right, or change the size and structure the user decided (normal structure options are in `references/box-styles.md`).
+12. **Use the user's copy exactly as given.** Only check spelling, grammar, punctuation and capitalisation, and list them as "original → suggestion" for the user to decide; do not rewrite or polish, do not judge whether claims are supported or compliant, and do not delete, change or mark anything pending because of that (pending is only for information the user has not given; `references/content.md`).
+
+## How to start, how to continue
+
+1. **Check the environment**: `python3 <skill-dir>/scripts/check_env.py --json` (`<skill-dir>` is this Skill's real folder). If the engine or fonts are missing, **stop** and give the user the instructions; if only Ghostscript is missing you can go on, but separation checks (B02, F01) are skipped — tell the user.
+2. **New project**: ask for the whole brief at once, create the job, open the workbench right away, build the content list — `references/requirements.md`.
+3. **Continuing** (the user gives an existing job, or says "continue / change this"): `references/resume.md`. Confirmations that still hold carry over; only ask about what is missing or what this change made expire.
+4. **Run `pacxio next <job>` before every round of work**: it shares its source with the workbench's "Now" and says where the job stands, who it waits on, which command runs next and which reference to read; user notes come first (`notes list --open` first, `notes reply` when done). In stages that wait on the user it only tells you what to show and what to run after they confirm.
+5. **The user wants to see their own dieline folded** (they give a DXF / vector PDF): not supported at the moment; tell the user so.
+6. **Images**: use the agent's built-in image tool if it has one (Codex); otherwise a configured API, or ask the user for images. Prompts come from `pacxio concept prompt`; tell the user how many images you will make before you make them.
+7. **Cloud sign-in**: composing, rendering, preflight and export run on the pacxio server, and the first time they return `CLOUD_LOGIN` (an address and an 8-character code). Give the user the address and code exactly; **the user** signs in in the browser with an email code, checks the code and clicks Approve (the agent never signs in or approves for them, and never uses a browser tool to click it). When they say it is done, rerun the same command (`references/troubleshooting.md`).
+
+## Stage map
+
+| Stage | Key commands | What the user does | Read |
+|---|---|---|---|
+| Brief, structure, job, workbench | `structures suggest / show`, `job init` (`--fefco` / `--ecma` / `--recipe`), `panels`, `studio start`, `window add` | Answer the brief, pick a structure | `requirements.md`, `structures.md`, `box-styles.md`, `studio.md` |
+| Content list (lots of copy: layout draft first, route A) | `content import / list / confirm`; `style set`, `art add`, `plan` | Confirm the wording (and the draft) | `content.md`, `layout-draft.md` |
+| Main-view concepts: one image for each of 2 directions | `concept prompt --step main` / `concept gen`, `concept import` | **Pick a direction** (`concept choose --region …`) | `concept.md` |
+| Back view (always first) → flats | `plan`, `concept prompt --step back / flat`, `concept import --view … --faces …` (several flat candidates can be imported at once; only the most accurate is kept), `concept rectify` | **Confirm the set of flats** (ask only when every proportion is within 10%; then `concept confirm --by`) | `concept.md` |
+| Final design from the flats | `art add / set / move`, `restore strip / face`, `visual trace / gen / import / prepare`, `finish add`, `surface add`, `color add`, `font add` | — | `design.md`, `vector.md`, `fonts.md`, `finishes.md`, `visual-prompts.md` |
+| Dieline confirmation image | `render`, `flat --diff`, `approve` | **Confirm (the only gate before export)** | `mockup.md` |
+| 3D mockups | `mockup` | View only | `mockup.md`, `finishes.md` |
+| Preflight | `preflight --json` | — | `prepress-rules.md`, `troubleshooting.md` |
+| Export | `export --proof --require-approval` | — | `delivery.md` |
+
+Multi-part styles `tray_lid`, `drawer`: same workflow (back view and flats too); panels use full names `part.panel`, flats cover the panels visible when closed (`lid.top` …), and each part gets its own dieline confirmation image (`box-styles.md`).
+
+Every command takes `--json` and prints `{ok, command, job, artifacts, data, errors, warnings}`; exit codes 0 success, 1 errors, 2 bad arguments, 3 environment missing. All commands: `references/commands.md`.
+
+## References
+
+| File | When to read |
+|---|---|
+| `references/requirements.md` | New project: the brief, creating the job, opening the workbench, the content list, choosing route A / B |
+| `references/resume.md` | Continuing an existing project |
+| `references/content.md` | Content list: organising, importing, the user confirming wording, using items in the layout |
+| `references/layout-draft.md` | Layout draft when there is a lot of copy (route A); the layout after the flats are confirmed |
+| `references/concept.md` | Main view, back view, flats: prompts, import, choosing, proportion checks, straightening, comparison |
+| `references/design.md` | Final design from the flats: color, text, graphics, photos, finishes, coordinates, stacking, what the engine cannot reproduce |
+| `references/vector.md` | Tracing vectors from the flats, hand-written SVG, clip shapes, continuity across folds |
+| `references/fonts.md` | Built-in fonts, tracking and line spacing, hanging indents, brand fonts and licenses |
+| `references/visual-prompts.md` | Image prompts for print assets, sizes, product photos on transparent backgrounds |
+| `references/finishes.md` | Foil / spot UV / embossing, lamination and varnish, checking finishes in 3D |
+| `references/mockup.md` | Dieline confirmation image, 3D mockups, confirmation and required content |
+| `references/studio.md` | Local workbench, notes, confirmations the user clicks on the page |
+| `references/structures.md` | Choosing a structure: by code, suggestions from the catalog (with 3D previews), co-designing a new one, how to state maturity |
+| `references/box-styles.md` | Box styles, parameters, windows, material presets, panel-local coordinates |
+| `references/factory-profile.md` | Factory profiles, ICC |
+| `references/prepress-rules.md` | Preflight rules in plain words |
+| `references/troubleshooting.md` | Common errors and fixes, exit codes |
+| `references/delivery.md` | Preflight, export, what is in the delivery pack, what to tell the user |
+| `references/commands.md` | Command reference |

pacxio/_skill/packaging-prepress/agents/openai.yaml

@@ -0,0 +1,8 @@
+# Codex-only metadata (SKILL.md frontmatter only uses name / description, for cross-agent compatibility)
+interface:
+  display_name: "Packaging prepress"
+  short_description: "Turn box sizes and brand assets into factory-ready dielines, print files and preflight reports"
+  default_prompt: "Use $packaging-prepress to make a reverse tuck end box, 80×50×180 mm, SBS 350 g, gold foil logo on the front, for Tidewell sea salt crackers."
+
+policy:
+  allow_implicit_invocation: true