@gobing-ai/knowledge-kit 0.0.36 → 0.1.0

package/plugins/ingestions/web-search/dist/index.js

@@ -12005,6 +12005,83 @@ import { createHash } from "crypto";
 import { dirname as dirname2, join } from "path";
 import { parseArgs } from "util";
 
+// ../../packages/kk-core/src/content-limits.ts
+var PLATFORM_CONTENT_LIMITS = Object.freeze({
+  schemaVersion: 5,
+  tagLimits: Object.freeze({
+    default: 7,
+    imageText: Object.freeze({
+      instagram: 5,
+      douyin: 5,
+      kuaishou: 4,
+      weixin: 1,
+      xiaohongshu: 10
+    }),
+    shortVideo: Object.freeze({
+      douyin: 5,
+      kuaishou: 4,
+      xiaohongshu: 10,
+      bilibili: 10,
+      zhihu: 5,
+      tiktok: 20,
+      youtube: 60
+    })
+  }),
+  titleCapabilities: Object.freeze({
+    dynamic: Object.freeze({
+      bilibili: Object.freeze({ max: 20, unit: "utf16_code_units" }),
+      zhihu: Object.freeze({ max: 50, unit: "utf16_code_units" }),
+      douban: Object.freeze({ max: 70, unit: "utf16_code_units" }),
+      x: null,
+      threads: null,
+      weibo: null,
+      jike: null,
+      zsxq: null,
+      toutiao: null,
+      juejin: null
+    }),
+    imageText: Object.freeze({
+      xiaohongshu: Object.freeze({ max: 20, unit: "xiaohongshu_title_weighted" }),
+      weixin: Object.freeze({ max: 20, unit: "utf16_code_units" }),
+      douyin: Object.freeze({ max: 20, unit: "utf16_code_units" }),
+      shipinhao: Object.freeze({ max: 22, unit: "utf16_code_units" }),
+      reddit: Object.freeze({ max: 300, unit: "utf16_code_units" })
+    }),
+    article: Object.freeze({
+      juejin: Object.freeze({ max: 100, unit: "utf16_code_units" }),
+      csdn: Object.freeze({ max: 100, unit: "utf16_code_units" }),
+      cnblogs: Object.freeze({ max: 128, unit: "utf16_code_units" }),
+      weibo: Object.freeze({ max: 30, unit: "utf16_code_units" }),
+      sspai: Object.freeze({ max: 80, unit: "utf16_code_units" })
+    }),
+    shortVideo: Object.freeze({
+      shipinhao: Object.freeze({ max: 16, unit: "utf16_code_units" }),
+      douyin: Object.freeze({ max: 30, unit: "utf16_code_units" }),
+      bilibili: Object.freeze({ max: 80, unit: "utf16_code_units" })
+    })
+  }),
+  bodyCapabilities: Object.freeze({
+    dynamic: Object.freeze({
+      threads: Object.freeze({ max: 500, unit: "unicode_code_points", behavior: "split_thread" }),
+      x: Object.freeze({ max: 280, unit: "weighted", behavior: "split_thread" }),
+      weibo: Object.freeze({ max: 2000, unit: "unicode_code_points" }),
+      jike: Object.freeze({ max: 1000, unit: "unicode_code_points" })
+    }),
+    imageText: Object.freeze({
+      xiaohongshu: Object.freeze({ max: 1000, unit: "unicode_code_points" }),
+      douyin: Object.freeze({ max: 1000, unit: "unicode_code_points" })
+    }),
+    article: Object.freeze({
+      wechatmp: Object.freeze({ max: 50000, unit: "unicode_code_points" }),
+      juejin: Object.freeze({ max: 50000, unit: "unicode_code_points" })
+    }),
+    shortVideo: Object.freeze({
+      douyin: Object.freeze({ max: 1000, unit: "unicode_code_points" }),
+      kuaishou: Object.freeze({ max: 1000, unit: "unicode_code_points" }),
+      shipinhao: Object.freeze({ max: 1000, unit: "unicode_code_points" })
+    })
+  })
+});
 // ../../packages/kk-core/src/kinds.ts
 init_zod();
 
@@ -12095,6 +12172,67 @@ var BrowserSessionDescriptorSchema = object({
     }
   }).optional()
 }).strict();
+var ContentCountUnitSchema = _enum([
+  "utf16_code_units",
+  "unicode_code_points",
+  "weighted",
+  "xiaohongshu_title_weighted"
+]);
+var LimitEntrySchema = object({
+  max: number2().int().positive(),
+  unit: ContentCountUnitSchema
+}).strict();
+var PublishingProfileLimitsSchema = object({
+  title: LimitEntrySchema.optional(),
+  body: LimitEntrySchema.optional()
+}).strict();
+var PublishingProfileRequiresSchema = object({
+  cover: boolean2().optional(),
+  orderedImages: boolean2().optional()
+}).strict();
+var PublishingProfileModeBindingSchema = object({
+  metadata: record(string2(), unknown())
+}).strict();
+var PublishingProfileModesSchema = object({
+  draft: PublishingProfileModeBindingSchema.optional(),
+  live: PublishingProfileModeBindingSchema.optional()
+}).strict().superRefine((modes, ctx) => {
+  if (modes.draft === undefined && modes.live === undefined) {
+    ctx.addIssue({
+      code: "custom",
+      message: 'modes must define at least one of "draft" or "live"'
+    });
+  }
+});
+var PublishingProfileSchema = object({
+  format: string2().min(1),
+  locale: string2().regex(/^(source|[a-z]{2,3}(-[A-Za-z0-9]+)*)$/, {
+    message: 'locale must be "source" or a valid language tag'
+  }),
+  limits: PublishingProfileLimitsSchema.optional(),
+  requires: PublishingProfileRequiresSchema.optional(),
+  modes: PublishingProfileModesSchema
+}).strict();
+var PublishingCapabilitiesSchema = object({
+  defaultProfile: string2().min(1),
+  profiles: record(string2().regex(/^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$/), PublishingProfileSchema)
+}).strict().superRefine((data, ctx) => {
+  const keys = Object.keys(data.profiles);
+  if (keys.length === 0) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["profiles"],
+      message: "profiles record must be nonempty"
+    });
+  }
+  if (!(data.defaultProfile in data.profiles)) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["defaultProfile"],
+      message: `defaultProfile "${data.defaultProfile}" must reference a declared profile`
+    });
+  }
+});
 var PluginManifestSchemaBase = looseObject({
   name: string2().min(1),
   kind: PluginKindSchema,
@@ -12103,23 +12241,31 @@ var PluginManifestSchemaBase = looseObject({
   version: string2().optional(),
   description: string2().optional(),
   operations: record(string2(), PluginOperationSchema).optional(),
-  browserSession: BrowserSessionDescriptorSchema.optional()
+  browserSession: BrowserSessionDescriptorSchema.optional(),
+  publishing: PublishingCapabilitiesSchema.optional()
 });
 var PluginManifestSchema = PluginManifestSchemaBase.superRefine((manifest, ctx) => {
-  if (manifest.browserSession === undefined)
-    return;
-  if (manifest.kind !== "publish") {
-    ctx.addIssue({
-      code: "custom",
-      path: ["browserSession"],
-      message: `browserSession requires kind "publish", not "${manifest.kind}"`
-    });
+  if (manifest.browserSession !== undefined) {
+    if (manifest.kind !== "publish") {
+      ctx.addIssue({
+        code: "custom",
+        path: ["browserSession"],
+        message: `browserSession requires kind "publish", not "${manifest.kind}"`
+      });
+    }
+    if (manifest.check === undefined) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["browserSession"],
+        message: "browserSession requires a check probe entry that owns the session routines"
+      });
+    }
   }
-  if (manifest.check === undefined) {
+  if (manifest.publishing !== undefined && manifest.kind !== "publish") {
     ctx.addIssue({
       code: "custom",
-      path: ["browserSession"],
-      message: "browserSession requires a check probe entry that owns the session routines"
+      path: ["publishing"],
+      message: `publishing requires kind "publish", not "${manifest.kind}"`
     });
   }
 });

package/plugins/kk/commands/workflow-run.md

@@ -33,12 +33,14 @@ Parse per the frozen rule:
 - `--in <file>` → file mode. `--force` → overwrite an existing dest YAML / existing `brief.md`.
 - Profile `kk-storm-research`: `--dir <path>` (default `$works_dir/kk-storm-research/<topic-id>`),
   `--fixture` → force `fixture: "true"`.
-- Profile `kk-itc`: `--dir <path>` (default `$works_dir/kk-itc/<kebab>`), `--playbook generic|english|wechat` (default `generic`),
-  `--research` (`true`|`false`, default `false`), `--judge` (`true`|`false`, default `false`),
-  `--outline <a|b|c>` (default empty), `--writer itc-generating|topic` (default `itc-generating`),
-  `--auto`, `--unslop true|false` (default `false`), `--max-revisions <N>` (default `2`),
-  `--cover`, `--inline-images`, `--targets <a,b>` (default empty), `--live`,
-  `--source-locale en|zh|ja` (default `en`; `--playbook wechat` without it implies `zh`).
+- Profile `kk-itc`: `--dir <path>` (default `$works_dir/kk-itc/<kebab>[/<run-date>]`),
+  `--from-collect <topic-profile>` (a third source, XOR with `<topic>` / `--in`),
+  `--topic-profile <slug>`, `--run-date <YYYYMMDD>`, `--playbook generic|english|wechat`,
+  `--research`, `--judge`, `--outline <a|b|c>`, `--writer itc-generating|topic`, `--auto`,
+  `--unslop true|false`, `--max-revisions <N>`, `--cover`, `--inline-images`, `--targets <a,b>`,
+  `--publish-preset <name>`, `--seo off|handoff`, `--live`, `--source-locale en|zh|ja`. Unpassed
+  flags take `workflows.kk-itc` config, then compiled defaults (`generic`, `itc-generating`, `en`,
+  `seo: off`, max revisions `2`, booleans `false`) — resolved once by `itc-prepare` (§4).
   `--fixture` passed with `kk-itc` or `kk-solo-podcast` → exit 1 (`fixture is storm-only`).
 - Profile `kk-solo-podcast`: `--dir <path>` (default `$works_dir/kk-solo-podcast/<date>`), `--outline <a|b|c>`
   (default empty), `--duration <min>` (default `8`), `--language <code>` (default `en`),
@@ -185,18 +187,51 @@ mkdir -p "$work_dir"
 
 ### Profile `kk-itc` (authoring workspace)
 
-`raw` = `TOPIC` or file-mode first ATX H1 else basename without extension.
-`kebab` = lower-case, `[^a-z0-9]+` → `-`, trimmed dashes (no length cap, no sha256 hash).
-`work_dir="${DIR:-$works_dir/kk-itc/$kebab}"`. Empty derived `kebab` → exit 1. An explicit
-`--dir` still wins, and the default never writes into the caller's cwd.
+The workspace and every config-backed option are resolved and **frozen** by
+`kk stage run itc-prepare` (0303) — never re-derived here. Pre-generate the run id first, so the
+frozen `itc-options.json` binds to the run that will consume it:
 
-Binding (0153): `--auto` binds `auto=true` and defaults `research`, `judge` and `unslop` to
+```bash
+RUN_ID="kk-itc-$(date +%Y%m%dT%H%M%S)-$$"
+launch="$(mktemp)"
+# Unpassed flags stay "" and are dropped: they fall to workflows.kk-itc config, then compiled defaults.
+jq -n --arg topic "$TOPIC" --arg inputFile "$INPUT_FILE" --arg fromCollect "$FROM_COLLECT" --arg dir "$DIR" \
+  --arg parentRunId "$RUN_ID" --arg topicProfile "$TOPIC_PROFILE" --arg runDate "$RUN_DATE" \
+  --arg writer "$WRITER" --arg playbook "$PLAYBOOK" --arg sourceLocale "$SOURCE_LOCALE" \
+  --arg publishTargets "$TARGETS" --arg publishPreset "$PRESET" --arg seo "$SEO" --arg maxRevisions "$MAX_REVISIONS" \
+  --arg research "$RESEARCH" --arg judge "$JUDGE" --arg auto "$AUTO" --arg unslop "$UNSLOP" --arg force "$FORCE" \
+  --arg publishLive "$LIVE" --arg coverEnabled "$COVER" --arg inlineImages "$INLINE_IMAGES" \
+  '$ARGS.named | with_entries(select(.value != ""))
+    | with_entries(if (.key | IN("research","judge","auto","unslop","force","publishLive","coverEnabled","inlineImages"))
+        then .value = (.value == "true") else . end)
+    | if has("maxRevisions") then .maxRevisions |= tonumber else . end' > "$launch"
+work_dir=$(kk stage run itc-prepare --request "$launch" | jq -r '.workDir')
+```
+
+Exactly one of `topic` | `inputFile` | `fromCollect`. An invalid key, config file or source fails
+before any workspace is written.
+
+Binding (0153), applied once by `itc-prepare`: `--auto` binds `auto=true` and defaults `research`, `judge` and `unslop` to
 `true` unless the operator passed them explicitly. `--live` is never implied — `publish_live`
 stays `false` unless `--live` is passed explicitly (ADR-022). `--playbook wechat` without
 `--source-locale` binds `source_locale=zh`; an explicit `--source-locale` always wins.
 `--targets <a,b>` binds `publish_targets`; `--cover` / `--inline-images` bind
 `cover_enabled` / `inline_images` (`false` unless passed); `--max-revisions` binds
-`max_revisions` (default `2`).
+`max_revisions` (default `2`). Each lands in `itc-options.json` under its camelCase key.
+
+**Collected topic (`--from-collect <profile>`, 0299).** `itc-prepare` without `--chosen` returns
+an *intake* snapshot (`status: intake`, `workDir: null`). Choose the topic in a run-scoped intake
+dir, then finalize:
+
+1. `kk stage run itc-topic-extract --request` `{parentRunId, intakeDir, topicProfile}` → the pool.
+2. The agent writes `$intakeDir/topic-candidates.json` (≤3 candidates `a|b|c` with
+   `title`/`reason`/`itemIds` from the pool); `kk stage run itc-topic-validate --request`
+   `{parentRunId, intakeDir}` must pass.
+3. `kk stage run itc-decision --topic "$intakeDir" "$RUN_ID"` prints the chosen id or `defer`.
+   **`defer` stops** — ask the operator to pick (never fall back to the first candidate).
+4. `kk stage run itc-topic-select --request` `{parentRunId, intakeDir, selectedCandidateId}`.
+5. `work_dir=$(kk stage run itc-prepare --request "$launch" --chosen "$intakeDir" | jq -r .workDir)`
+   finalizes the snapshot under the chosen title and copies the selection evidence into the workspace.
 
 ### Profile `kk-solo-podcast`
 
@@ -231,14 +266,17 @@ spur workflow run "$dest" --vars \
 
 ### Profile `kk-itc`
 
-Bind vars: `topic`, `input_file`, `work_dir`, `writer`, `playbook`, `research`, `judge`, `auto`,
-`unslop`, `max_revisions`, `outline`, `force`, `rubric` (`tech-accuracy`), `agent`,
-`cover_enabled`, `inline_images`, `publish_targets`, `publish_live`, `source_locale`. The judge
-verdict lands at `$work_dir/.itc-verdict.json` (fixed path inside the workflow).
+Launch under the **same** `RUN_ID` the snapshot was frozen for; the `prepare` node refuses a
+snapshot owned by another run unless `force=true`. Downstream nodes read options from
+`$work_dir/itc-options.json`, so the vars only locate the workspace and carry run-local inputs:
+`work_dir`, `topic_profile`, `publish_preset`, `seo_mode`, `from_collect`, `run_date`, `outline`,
+`force`, `rubric` (`tech-accuracy`), `agent`. The judge verdict lands at
+`$work_dir/.itc-verdict.json`. A live plan with targets pauses at `send-confirm`: resuming
+(`spur workflow continue $RUN_ID`) approves the send, cancelling rejects it.
 
 ```bash
-spur workflow run "$dest" --vars \
-  "{\"topic\":\"$TOPIC\",\"input_file\":\"$INPUT_FILE\",\"work_dir\":\"$work_dir\",\"writer\":\"$WRITER\",\"playbook\":\"$PLAYBOOK\",\"research\":\"$RESEARCH\",\"judge\":\"$JUDGE\",\"auto\":\"$AUTO\",\"unslop\":\"$UNSLOP\",\"max_revisions\":\"$MAX_REVISIONS\",\"outline\":\"$OUTLINE\",\"force\":\"$FORCE\",\"rubric\":\"tech-accuracy\",\"agent\":\"$AGENT\",\"cover_enabled\":\"$COVER\",\"inline_images\":\"$INLINE_IMAGES\",\"publish_targets\":\"$TARGETS\",\"publish_live\":\"$LIVE\",\"source_locale\":\"$SOURCE_LOCALE\"}"
+spur workflow run "$dest" --run-id "$RUN_ID" --vars \
+  "{\"work_dir\":\"$work_dir\",\"topic_profile\":\"$TOPIC_PROFILE\",\"publish_preset\":\"$PRESET\",\"seo_mode\":\"$SEO\",\"from_collect\":\"$FROM_COLLECT\",\"run_date\":\"$RUN_DATE\",\"outline\":\"$OUTLINE\",\"force\":\"$FORCE\",\"rubric\":\"tech-accuracy\",\"agent\":\"$AGENT\"}"
 ```
 
 ### Profile `kk-solo-podcast`

package/plugins/kk/decisions/kk-itc.yaml

@@ -0,0 +1,46 @@
+$schema: "@gobing-ai/spur/schemas/decision-catalog.schema.json"
+version: 1
+
+defaults:
+    minConfidence: 0
+
+decisions:
+    kk-itc-topic-choice:
+        type: choice
+        description: Choose the strongest topic candidate from the candidate evidence pool, or defer to operator
+        parameters:
+            candidates:
+                type: string
+                description: Formatted candidate options with title, rationale, item IDs and source URLs
+        criteria:
+            a: Candidate slot a is the strongest and most cohesive technical article topic.
+            b: Candidate slot b is the strongest and most cohesive technical article topic.
+            c: Candidate slot c is the strongest and most cohesive technical article topic.
+            defer: Candidates are insufficient, contradictory, or need explicit operator review.
+        fallback: defer
+
+    kk-itc-outline-choice:
+        type: choice
+        description: Choose the best structured technical article outline option, or defer to operator
+        parameters:
+            options:
+                type: string
+                description: Candidate outline options with structure, headings, and rationale
+        criteria:
+            a: Outline option a has the strongest narrative arc and technical depth.
+            b: Outline option b has the strongest narrative arc and technical depth.
+            c: Outline option c has the strongest narrative arc and technical depth.
+            defer: Outlines require manual operator adjustment or refinement.
+        fallback: defer
+
+    kk-itc-preset-choice:
+        type: choice
+        description: Accept the suggested channel publication preset, or publish to no targets by default
+        parameters:
+            suggestion:
+                type: string
+                description: The recommended publication preset name and target channels
+        criteria:
+            suggested: Accept the suggested preset for publication.
+            none: Do not use the suggested preset; leave targets unselected.
+        fallback: none

package/plugins/kk/decisions/kk-seo-keyword.yaml

@@ -0,0 +1,57 @@
+$schema: "@gobing-ai/spur/schemas/decision-catalog.schema.json"
+version: 1
+
+defaults:
+    minConfidence: 0
+
+decisions:
+    kk-seo-keyword-relevance:
+        type: score
+        description: Relevance of a keyword query to the target page content and topic.
+        parameters:
+            subject_id:
+                type: string
+                description: Keyword identifier or query string.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            - Unrelated or tangential keyword query with no relevance.
+            - Low relevance or secondary query with modest topical connection.
+            - Highly relevant keyword directly addressed by primary page content.
+            - Perfect primary target query with comprehensive topical alignment.
+        fallback: 0
+
+    kk-seo-keyword-other-brand:
+        type: noul
+        description: Whether the keyword query references a competitor or third-party brand.
+        parameters:
+            subject_id:
+                type: string
+                description: Keyword identifier or query string.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            "true": Query contains an explicit competitor brand, trademark, or proprietary product name.
+            "false": Query consists of generic, unbranded or owned brand search terms.
+        fallback: false
+
+    kk-seo-keyword-page:
+        type: choice
+        description: Mapping strategy for targeting this keyword query across site pages.
+        parameters:
+            subject_id:
+                type: string
+                description: Keyword identifier or query string.
+            locale:
+                type: string
+                description: Target audience locale.
+            candidates:
+                type: json
+                description: Serialized list of candidate page titles and URLs (max 30 candidates).
+        criteria:
+            existing: Map keyword to an existing candidate page that already best satisfies intent.
+            new: Create a dedicated new landing page or article to satisfy search intent.
+            unclear: Ambiguous intent, low commercial relevance, or insufficient evidence to map.
+        fallback: unclear

package/plugins/kk/decisions/kk-seo-page.yaml

@@ -0,0 +1,230 @@
+$schema: "@gobing-ai/spur/schemas/decision-catalog.schema.json"
+version: 1
+
+defaults:
+    minConfidence: 0
+
+decisions:
+    kk-seo-page-type:
+        type: choice
+        description: Functional structural role of this webpage within the site.
+        parameters:
+            subject_id:
+                type: string
+                description: Canonical URL of the page.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            homepage: Primary domain root or brand entry point.
+            product: Specific item, merchandise or standalone paid SKU.
+            category: Collection, catalogue index, listing or facet filter page.
+            service: Specific professional or client service offering.
+            article: Editorial blog post, knowledge article, guide or news story.
+            landing: Targeted campaign, lead generation or conversion page.
+            about: Organization background, team or company history.
+            contact: Communication, physical location or support contact page.
+            policy: Terms of service, privacy policy or legal disclosure.
+            other: Functional page outside the standard classifications.
+            unclear: Ambiguous, mixed, or insufficient content signals.
+        fallback: unclear
+
+    kk-seo-search-intent:
+        type: choice
+        description: Primary user search intent targeted by this page.
+        parameters:
+            subject_id:
+                type: string
+                description: Canonical URL of the page.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            informational: User seeks knowledge, explanations, answers or tutorials.
+            navigational: User seeks to locate a specific brand, tool or destination.
+            commercial: User evaluates options, reviews, comparisons or solutions.
+            transactional: User is ready to purchase, subscribe, sign up or download.
+            mixed: Multiple distinct search intents addressed equally.
+            unclear: Ambiguous or undefined user intent.
+        fallback: unclear
+
+    kk-seo-page-action:
+        type: choice
+        description: Strategic editorial action recommended for this page.
+        parameters:
+            subject_id:
+                type: string
+                description: Canonical URL of the page.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            keep-or-improve: Valuable page worth retaining and updating incrementally.
+            rewrite: Substantive content overhaul required to meet search intent.
+            review-consolidation: Potential cannibalization or thin page to consolidate.
+            unclear: Insufficient evidence to determine strategic page action.
+        fallback: unclear
+
+    kk-seo-importance:
+        type: score
+        description: Strategic importance of this page to site search authority.
+        parameters:
+            subject_id:
+                type: string
+                description: Canonical URL of the page.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            - Incidental or utility page with negligible search potential.
+            - Secondary supporting page with modest targeted relevance.
+            - Core pillar or commercial page driving regular search authority.
+            - Essential primary asset or high-converting flagship page.
+        fallback: 0
+
+    kk-seo-helpfulness:
+        type: score
+        description: Depth and utility of the page content for human visitors.
+        parameters:
+            subject_id:
+                type: string
+                description: Canonical URL of the page.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            - Thin, repetitive or boilerplate text offering little value.
+            - Basic overview covering surface facts without original insight.
+            - Thorough and genuinely helpful content with practical utility.
+            - Exceptional, comprehensive resource with expert depth and clarity.
+        fallback: 0
+
+    kk-seo-specificity:
+        type: score
+        description: Precision and concrete focus of the topic discussion.
+        parameters:
+            subject_id:
+                type: string
+                description: Canonical URL of the page.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            - Vague, generic claims with no specific details or examples.
+            - Mostly general statements with a few isolated specifics.
+            - Concrete discussion with precise details, steps or terminology.
+            - Highly rigorous and exact specification with actionable details.
+        fallback: 0
+
+    kk-seo-trust:
+        type: score
+        description: Credibility, evidence and verifiable signals of expertise.
+        parameters:
+            subject_id:
+                type: string
+                description: Canonical URL of the page.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            - Unsubstantiated claims with zero sourcing or author attribution.
+            - Modest credibility signals with basic organizational context.
+            - Clear author expertise, cited sources, and verifiable claims.
+            - Authoritative industry benchmark with transparent methodology.
+        fallback: 0
+
+    kk-seo-citability:
+        type: score
+        description: Ease and likelihood of being quoted by answer engines.
+        parameters:
+            subject_id:
+                type: string
+                description: Canonical URL of the page.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            - Prose structure is unfocused and difficult to extract citations from.
+            - Contains extractable points buried in dense conversational prose.
+            - Clear, concise statements directly answering user questions.
+            - Structured, highly quotable definitions, data points and conclusions.
+        fallback: 0
+
+    kk-seo-title-fit:
+        type: score
+        description: How accurately the HTML title describes the page substance.
+        parameters:
+            subject_id:
+                type: string
+                description: Canonical URL of the page.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            - Title is misleading, irrelevant or clickbait disconnected from body.
+            - Title loosely matches body but misses primary topic emphasis.
+            - Title accurately reflects main subject and matches search intent.
+            - Title is concise, compelling and perfectly aligned with page content.
+        fallback: 0
+
+    kk-seo-meta-fit:
+        type: score
+        description: How accurately the meta description summarizes the page content.
+        parameters:
+            subject_id:
+                type: string
+                description: Canonical URL of the page.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            - Meta description is missing, generic or irrelevant.
+            - Description is partially relevant but lacks distinct proposition.
+            - Description clearly summarizes key page value and answers intent.
+            - Description is compelling, perfectly accurate and snippet-ready.
+        fallback: 0
+
+    kk-seo-answer-first:
+        type: noul
+        description: Whether the page answers the primary question early before the fold.
+        parameters:
+            subject_id:
+                type: string
+                description: Canonical URL of the page.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            "true": Direct answer or core conclusion appears in the opening section.
+            "false": Direct answer is buried deep after extensive filler or intro prose.
+        fallback: false
+
+    kk-seo-next-step:
+        type: noul
+        description: Whether the page guides the reader toward a clear next step or CTA.
+        parameters:
+            subject_id:
+                type: string
+                description: Canonical URL of the page.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            "true": Identifiable next action, link or relevant resource provided.
+            "false": Dead-end page with no contextual navigation or clear next step.
+        fallback: false
+
+    kk-seo-heading-fit:
+        type: noul
+        description: Whether the heading hierarchy accurately mirrors page topic flow.
+        parameters:
+            subject_id:
+                type: string
+                description: Canonical URL of the page.
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            "true": Headings outline a coherent logical structure matching body sections.
+            "false": Headings are disorganized, misleading, decorative or missing.
+        fallback: false

package/plugins/kk/decisions/kk-seo-pair.yaml

@@ -0,0 +1,21 @@
+$schema: "@gobing-ai/spur/schemas/decision-catalog.schema.json"
+version: 1
+
+defaults:
+    minConfidence: 0
+
+decisions:
+    kk-seo-intent-overlap:
+        type: noul
+        description: Whether two sampled pages target substantially identical search intent and topic.
+        parameters:
+            subject_id:
+                type: string
+                description: Sorted pair identifier (pageA_id::pageB_id).
+            locale:
+                type: string
+                description: Target audience locale.
+        criteria:
+            "true": Both pages compete for the same primary query intent and cannibalize search authority.
+            "false": Pages serve distinct user queries or complementary stages of user intent.
+        fallback: false