@gobing-ai/knowledge-kit 0.0.28 → 0.0.30

package/plugins/generations/image-gen/src/presets.ts

@@ -31,6 +31,28 @@ export interface FormatVariable {
     default: string;
 }
 
+/**
+ * Optional compose block in a format preset (task 0180, F616).
+ * When present, image-gen typesets the on-card copy from Noto Sans SC via
+ * headless Chromium instead of generating text as pixels. Requires `width`
+ * and `height` on the format (enforced by FormatPresetSchema refine).
+ */
+export interface ComposeConfig {
+    /** The only v1 engine value; zod literal enforces it. */
+    engine: 'text-card';
+    /** Safe-area inset in px on all sides. */
+    safeArea: number;
+    /** Headline minimum font size in px. */
+    headlineMinPx: number;
+    /** Body/bullets minimum font size in px. */
+    bodyMinPx: number;
+    /** Height in px of the illustration band (top); text panel takes the rest. */
+    illustrationHeight: number;
+    palette: { background: string; text: string; accent: string };
+    /** Font filenames under `assets/fonts/`. */
+    fonts: { headline: string; body: string };
+}
+
 /** R1 — `formats/<name>.yaml`: the job skeleton (template, keywords, variables). */
 export interface FormatPreset {
     /** Filename stem must equal this. */
@@ -51,6 +73,8 @@ export interface FormatPreset {
     variables: Record<string, FormatVariable>;
     /** Prompt body; YAML block scalar, embedded newlines preserved. */
     template: string;
+    /** Optional compose block (0180): when present, image-gen typesets card copy from a real font. */
+    compose?: ComposeConfig;
 }
 
 /** R1 — `styles/<name>.yaml`; `modifiers` is the only required prompt field. */
@@ -76,21 +100,37 @@ const PresetSourceSchema = z.object({
     confidence: z.enum(['high', 'medium', 'low']).optional(),
 });
 
-/** Parse gate for `formats/<name>.yaml`. */
-export const FormatPresetSchema = z.object({
-    name: z.string(),
-    description: z.string(),
-    job: z.enum(['free', 'cover', 'illustration']),
-    aspectRatio: z.string(),
-    width: z.number().optional(),
-    height: z.number().optional(),
-    defaultStyle: z.string(),
-    keywords: z.array(z.string()),
-    outputFilename: z.string(),
-    variables: z.record(z.string(), z.object({ description: z.string(), default: z.string() })),
-    template: z.string(),
+/** The zod schema for the optional compose block (0180). */
+const ComposeConfigSchema = z.object({
+    engine: z.literal('text-card'),
+    safeArea: z.number(),
+    headlineMinPx: z.number(),
+    bodyMinPx: z.number(),
+    illustrationHeight: z.number(),
+    palette: z.object({ background: z.string(), text: z.string(), accent: z.string() }),
+    fonts: z.object({ headline: z.string(), body: z.string() }),
 });
 
+/** Parse gate for `formats/<name>.yaml`. */
+export const FormatPresetSchema = z
+    .object({
+        name: z.string(),
+        description: z.string(),
+        job: z.enum(['free', 'cover', 'illustration']),
+        aspectRatio: z.string(),
+        width: z.number().optional(),
+        height: z.number().optional(),
+        defaultStyle: z.string(),
+        keywords: z.array(z.string()),
+        outputFilename: z.string(),
+        variables: z.record(z.string(), z.object({ description: z.string(), default: z.string() })),
+        template: z.string(),
+        compose: ComposeConfigSchema.optional(),
+    })
+    .refine((data) => data.compose === undefined || (data.width !== undefined && data.height !== undefined), {
+        message: 'A format preset with a compose block requires both width and height to be declared',
+    });
+
 /** Parse gate for `styles/<name>.yaml`. */
 export const StylePresetSchema = z.object({
     name: z.string(),

package/plugins/generations/image-gen/src/providers/minimax.ts

@@ -50,11 +50,17 @@ export function parsePixelSize(size: string): { width: number; height: number }
     return { width, height };
 }
 
+/** 0182 R4: image-01 accepts an exact canvas of 512..2048 per edge, divisible by 8. */
+function isAcceptablePixelSize(width: number, height: number): boolean {
+    return width >= 512 && width <= 2048 && height >= 512 && height <= 2048 && width % 8 === 0 && height % 8 === 0;
+}
+
+/** Throwing twin of {@link isAcceptablePixelSize} for the request-body path; messages are frozen (tests pin them). */
 function validatePixelSize(width: number, height: number): void {
-    if (width < 512 || width > 2048 || height < 512 || height > 2048) {
-        throw new Error('MiniMax custom size must keep width and height between 512 and 2048.');
-    }
-    if (width % 8 !== 0 || height % 8 !== 0) {
+    if (!isAcceptablePixelSize(width, height)) {
+        if (width < 512 || width > 2048 || height < 512 || height > 2048) {
+            throw new Error('MiniMax custom size must keep width and height between 512 and 2048.');
+        }
         throw new Error('MiniMax custom size requires width and height divisible by 8.');
     }
 }
@@ -146,6 +152,8 @@ export const createMinimax: ProviderFactory = (options?: ProviderOptions): Image
         defaultModel: () => DEFAULT_MODEL,
         isAvailable: () => readEnv('MINIMAX_API_KEY') !== '',
         supportsReferenceImages: () => true,
+        exactSize: (model: string, width: number, height: number): boolean =>
+            model === 'image-01' && isAcceptablePixelSize(width, height),
         validate(req: ImageRequest): void {
             requestBody(req.prompt, req.model, req);
         },

package/plugins/generations/image-gen/src/providers/types.ts

@@ -32,7 +32,11 @@ export interface ImageRequest {
     model: string;
     /** e.g. '21:9' — from FormatPreset.aspectRatio (0102). */
     aspectRatio?: string;
-    /** Optional exact pixels; providers that only take an aspect ratio ignore them. */
+    /**
+     * Declared preset canvas (0182 R1). Sent only when the resolved provider's
+     * `exactSize(model, width, height)` returns true — with `aspectRatio` omitted;
+     * every other provider receives the aspect-only request shape and never sees them.
+     */
     width?: number;
     height?: number;
     quality?: ImageQuality;
@@ -64,6 +68,13 @@ export interface ImageProvider {
     isAvailable(): boolean;
     /** Queryable ref-image capability; 0105 routes `--ref` work on this fact. */
     supportsReferenceImages(model: string): boolean;
+    /**
+     * Exact-size capability (0182 R1/R4): can this adapter deliver the exact pixel canvas
+     * for this model? Absent = aspect-only — `processGeneratorIO` then sends only
+     * `aspectRatio`, byte-for-byte as before 0182. Adapters opt in one at a time, on
+     * measured evidence (task 0182 Q&A, closed).
+     */
+    exactSize?(model: string, width: number, height: number): boolean;
     /** Throw on an impossible combination (e.g. Imagen + referenceImages) before spending money. */
     validate?(req: ImageRequest): void;
     generate(req: ImageRequest): Promise<ImageResult>;

package/plugins/kk/plugin.json

@@ -1,5 +1,5 @@
 {
     "name": "kk",
-    "version": "0.0.28",
+    "version": "0.0.30",
     "description": "knowledge-kit Claude Code plugin: skills, commands, subagents, hooks, and rules"
 }

package/plugins/kk/scripts/daily-voice-style.zh.md

@@ -1,37 +1,45 @@
-# 每日AI科技漫谈 · 主持风格契约（zh）
+# AI 乱炖 · 主持风格契约（zh）
 
-`kk-daily-ai-voice` 的每一句口播都受这份契约约束（F613 R1）。`script-write` 提示词与
-`dailynews-gen` 的校验器读取同一份机器可读块，因此提示词与校验永远一致。
+`kk-daily-ai-voice` 的每一句口播都受这份契约约束（F613 R1；0189 R1 改定位）。`script-write`
+提示词与 `dailynews-gen` 的校验器读取同一份机器可读块，因此提示词与校验永远一致。
+
+## 栏目定位（0189 R1）
+
+「AI 乱炖」是「咸话咸说」下的 AI 技术分享栏目，副题「工具、论文与实践随聊」。口播是开发者
+视角的技术分享，不是新闻通报：不播报时事，不以任何代称、绰号或「闲聊」包装政治、外交、
+军事、公共政策争议或社会公共事件主线的内容——这类条目在选题/QC 阶段就应被排除（0189 R2）。
+身份与经历必须真实：只讲真实做过的实测与实践，AI 配音参与按真实程度说明。
 
 ## 人设与语域
 
-- 口语化普通话，第一人称「我」，像一位冷静、有依据的科技播客主播。
+- 口语化普通话，第一人称「我」，像一位冷静、有依据的 AI 技术分享主播。
 - 平实、克制、不炒作：不夸大单一消息的意义，不使用惊叹式渲染或营销话术。
-- 面向普通听众说明「这件事为什么重要」，而不是堆砌术语。
+- 面向普通听众说明「这件事为什么重要」或「怎么用得上」，而不是堆砌术语。
 
 ## 固定开场与收尾
 
 开场问候与收尾致谢由 builder 固定输出，计划文本只填充两者之间的内容，节目身份永不漂移：
 
-- 开场：`大家好，今天是<日期>，欢迎收听由<主持人>为您带来的今日AI科技漫谈。`
+- 开场：`大家好，今天是<日期>，欢迎收听「咸话咸说」的「AI 乱炖」栏目，我是<主持人>。`
 - 收尾：`感谢您的收听，我是<主持人>，祝您拥有充实高效的一天，我们下期节目不见不散！`
 
 ## 段落角色
 
-- `intro`：开场导语，串起今天几条主题，接在固定问候之后，不超过 120 字。
-- `lead`：一句话口语桥段，引出下一条新闻的【标题】；只做铺垫，不得复述标题本身，不超过 60 字。
-- `insight`：只基于这条新闻自身事实的 1–2 句点评，说明它为什么重要；不得挪用其他新闻的话题，不超过 160 字。
-- `outro`：简短收束语，接在固定致谢之前，不超过 120 字。
+- `intro`：开场导语，串起今天几个主题，接在固定问候之后，不超过 150 字。
+- `lead`：一句话口语桥段，引出下一个主题的【标题】；只做铺垫，不得复述标题本身，不超过 80 字。
+- `insight`：只基于这一条自身可核事实的点评（3–6 句），展开这一条自身的机制→意义→实用角度；不得挪用其他条目的话题，不超过 380 字。时长契约：全片按 15–20 分钟口播设计，insight 应写到接近上限——宁可深挖这一条的事实，也不要浅尝辄止。字数按配音驱动折算：gemini ≈3.3 字/秒（正文约 4300–5800 字）；Voicebox robin-news ≈6.3 字/秒（正文约 5700–7600 字，或增加条目数）。
+- `outro`：简短收束语，接在固定致谢之前，不超过 150 字。
 
 ## 机器可读契约
 
 `caps` 是各字段的字数上限；`banned` 是任何计划字段都不得出现的短语——包括旧模板的全部罐头
-点评、旧模板的 首先/接着/最后 开头，以及 0133 的研究脚手架标签与对冲语（校验规则
-`banned:<短语>`）。
+点评、旧模板的 首先/接着/最后 开头、0133 的研究脚手架标签与对冲语（校验规则
+`banned:<短语>`），以及 0189 R4 退役的旧栏目名（「每日 AI 资讯」「AI科技漫谈」
+「AI Daily Briefing」）：任何路径都不得让旧新闻定位复活。
 
 ```json
 {
-  "caps": { "intro": 120, "outro": 120, "lead": 60, "insight": 160 },
+  "caps": { "intro": 150, "outro": 150, "lead": 80, "insight": 380 },
   "banned": [
     "在各种技术光环背后，正是这样专注而不知疲倦的底层攻坚者，为今天整个大模型生态奠定了最坚实的技术基石。",
     "这其实释放了一个非常明确的信号：AI竞争的下半场，已经不再只是单纯拼模型参数，更是电力、能源和全栈工业基础设施的硬核较量。",
@@ -46,7 +54,12 @@
     "背景",
     "潜在影响",
     "读者宜另行核实",
-    "仍待验证"
+    "仍待验证",
+    "每日AI资讯",
+    "每日 AI 资讯",
+    "今日AI科技漫谈",
+    "AI科技漫谈",
+    "AI Daily Briefing"
   ]
 }
 ```

package/plugins/kk/scripts/itc-stages.ts

@@ -131,7 +131,18 @@ export function itcReport(args: string[]): void {
     const [workDir = '', maxRevisions = ''] = args;
     if (!workDir) fail('usage: itc-report <work_dir> [max_revisions]');
     const verdictPath = join(workDir, '.itc-verdict.json');
-    const verdict = existsSync(verdictPath) ? ((readJson(verdictPath) as { verdict?: unknown }).verdict ?? '') : '';
+    const verdictJson = existsSync(verdictPath)
+        ? (readJson(verdictPath) as { verdict?: unknown; confidence?: unknown })
+        : {};
+    const verdict = verdictJson.verdict ?? '';
+    // Same enum as the workflow guards and `daily-safety-gate`: a PASS without a HIGH/MEDIUM/LOW
+    // confidence never cleared the judge gate, so the report must not claim a publish-ready draft.
+    // An absent verdict file stays the dry-run PASS convention (verdict '').
+    const unusablePass =
+        verdict === 'PASS' &&
+        verdictJson.confidence !== 'HIGH' &&
+        verdictJson.confidence !== 'MEDIUM' &&
+        verdictJson.confidence !== 'LOW';
     // Auto runs count on .auto-revise-count; interactive runs keep the existing .revise-count.
     const revisions = readCount(join(workDir, '.auto-revise-count')) ?? readCount(join(workDir, '.revise-count')) ?? 0;
     // Exhaustion only fails the run when the last verdict still asks for another revision —
@@ -186,7 +197,8 @@ export function itcReport(args: string[]): void {
     }
 
     const publishFailed = targets.some((t) => !t.ok);
-    const outcome = verdict === 'FAIL' || exhausted || publishFailed ? 'failed' : declined ? 'declined' : 'done';
+    const outcome =
+        verdict === 'FAIL' || unusablePass || exhausted || publishFailed ? 'failed' : declined ? 'declined' : 'done';
     const reportDir = join(workDir, '5-report');
     const jsonPath = join(reportDir, 'report.json');
     const publish = hasPlan ? { targets, retryCommands } : undefined;
@@ -198,7 +210,13 @@ export function itcReport(args: string[]): void {
         );
         writeFileSync(
             join(reportDir, 'report.md'),
-            `# kk-itc run report\n\n- Outcome: ${outcome}\n- Verdict: ${verdict === '' ? 'PASS (empty)' : verdict}\n- Revisions: ${revisions}\n` +
+            `# kk-itc run report\n\n- Outcome: ${outcome}\n- Verdict: ${
+                verdict === ''
+                    ? 'PASS (empty)'
+                    : unusablePass
+                      ? 'PASS (no HIGH/MEDIUM/LOW confidence — the judge gate never cleared)'
+                      : verdict
+            }\n- Revisions: ${revisions}\n` +
                 (declined
                     ? '\n## Publish\n\n- Declined by the operator — nothing was sent.\n'
                     : targets.length > 0