@tikomni/skills 0.1.0

package/skills/creator-analysis/references/schemas/author-analysis-input-v1.schema.json

@@ -0,0 +1,325 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "tikomni/author-analysis-input-v1.schema.json",
+  "title": "TikOmni Author Analysis Input V1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "author_profile",
+    "sampled_works",
+    "aggregate_stats",
+    "platform_context",
+    "analysis_metadata"
+  ],
+  "$defs": {
+    "distributionItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["value", "count", "ratio"],
+      "properties": {
+        "value": { "type": "string", "minLength": 1 },
+        "count": { "type": "integer", "minimum": 0 },
+        "ratio": { "type": "number", "minimum": 0 }
+      }
+    },
+    "distribution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["items"],
+      "properties": {
+        "total": { "type": "integer", "minimum": 0 },
+        "counting_mode": { "type": "string" },
+        "items": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/distributionItem" }
+        }
+      }
+    },
+    "engagementPattern": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "count",
+        "avg_digg_count",
+        "avg_comment_count",
+        "avg_collect_count",
+        "avg_share_count",
+        "avg_play_count"
+      ],
+      "properties": {
+        "count": { "type": "integer", "minimum": 0 },
+        "avg_digg_count": { "type": "number", "minimum": 0 },
+        "avg_comment_count": { "type": "number", "minimum": 0 },
+        "avg_collect_count": { "type": "number", "minimum": 0 },
+        "avg_share_count": { "type": "number", "minimum": 0 },
+        "avg_play_count": { "type": "number", "minimum": 0 }
+      }
+    },
+    "bucketDelta": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "title_keywords",
+        "caption_keywords",
+        "primary_text_keywords",
+        "hook_types",
+        "structure_types",
+        "cta_types",
+        "content_forms",
+        "engagement_pattern"
+      ],
+      "properties": {
+        "title_keywords": { "type": "array", "items": { "$ref": "#/$defs/distributionItem" } },
+        "caption_keywords": { "type": "array", "items": { "$ref": "#/$defs/distributionItem" } },
+        "primary_text_keywords": { "type": "array", "items": { "$ref": "#/$defs/distributionItem" } },
+        "hook_types": { "type": "array", "items": { "$ref": "#/$defs/distributionItem" } },
+        "structure_types": { "type": "array", "items": { "$ref": "#/$defs/distributionItem" } },
+        "cta_types": { "type": "array", "items": { "$ref": "#/$defs/distributionItem" } },
+        "content_forms": { "type": "array", "items": { "$ref": "#/$defs/distributionItem" } },
+        "engagement_pattern": { "$ref": "#/$defs/engagementPattern" }
+      }
+    },
+    "work": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "platform_work_id",
+        "title",
+        "caption_raw",
+        "work_modality",
+        "primary_text",
+        "primary_text_source",
+        "published_date",
+        "publish_days_ago",
+        "duration_ms",
+        "digg_count",
+        "comment_count",
+        "collect_count",
+        "share_count",
+        "play_count",
+        "content_form",
+        "tags",
+        "author_id",
+        "author_name",
+        "performance_score",
+        "performance_score_norm",
+        "bucket",
+        "hook_type",
+        "structure_type",
+        "cta_type",
+        "style_markers",
+        "analysis_eligibility",
+        "analysis_exclusion_reason"
+      ],
+      "properties": {
+        "platform_work_id": { "type": "string", "minLength": 1 },
+        "title": { "type": "string" },
+        "caption_raw": { "type": "string" },
+        "work_modality": { "type": "string", "enum": ["video", "text"] },
+        "primary_text": { "type": "string" },
+        "primary_text_source": { "type": "string", "enum": ["asr_clean", "caption_raw"] },
+        "published_date": { "type": "string" },
+        "publish_time": { "type": ["string", "integer", "number", "null"] },
+        "publish_days_ago": { "type": ["integer", "null"], "minimum": 0 },
+        "duration_ms": { "type": "integer", "minimum": 0 },
+        "digg_count": { "type": "integer", "minimum": 0 },
+        "comment_count": { "type": "integer", "minimum": 0 },
+        "collect_count": { "type": "integer", "minimum": 0 },
+        "share_count": { "type": "integer", "minimum": 0 },
+        "play_count": { "type": "integer", "minimum": 0 },
+        "content_form": {
+          "type": "string",
+          "enum": ["talking_head", "voiceover", "screen_recording", "slideshow", "mixed_edit", "live_clip", "interview_clip"]
+        },
+        "tags": { "type": "array", "items": { "type": "string" } },
+        "author_id": { "type": "string", "minLength": 1 },
+        "author_name": { "type": "string", "minLength": 1 },
+        "performance_score": { "type": "number", "minimum": 0 },
+        "performance_score_norm": { "type": "number", "minimum": 0 },
+        "bucket": { "type": "string", "enum": ["Top", "Strong", "Mid", "Bottom"] },
+        "hook_type": {
+          "type": "string",
+          "enum": ["result_hook", "curiosity_hook", "shortcut_hook", "pain_point_hook", "comparison_hook", "proof_hook"]
+        },
+        "structure_type": {
+          "type": "string",
+          "enum": ["hook_demo_result", "benchmark_then_clone", "problem_solution_cta", "proof_then_pitch"]
+        },
+        "cta_type": {
+          "type": "string",
+          "enum": ["comment_cta", "private_message_cta", "follow_cta", "collect_cta", "share_cta", "lead_magnet_cta", "weak_cta", "no_cta"]
+        },
+        "style_markers": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["rhetorical_question", "imperative_tone", "strong_assertion", "self_mockery", "quote_like_phrase", "emotional_wording"]
+          }
+        },
+        "analysis_eligibility": { "type": "string", "enum": ["eligible", "incomplete"] },
+        "analysis_exclusion_reason": { "type": "string" },
+        "analysis_artifact_status": { "type": ["string", "null"] },
+        "all_time_score_rank": { "type": "integer", "minimum": 1 },
+        "recent_30d_score_rank": { "type": ["integer", "null"], "minimum": 1 }
+      }
+    }
+  },
+  "properties": {
+    "author_profile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "platform",
+        "platform_author_id",
+        "nickname",
+        "author_handle",
+        "signature",
+        "fans_count",
+        "liked_count",
+        "collected_count",
+        "works_count",
+        "verified",
+        "ip_location"
+      ],
+      "properties": {
+        "platform": { "type": "string", "minLength": 1 },
+        "platform_author_id": { "type": "string", "minLength": 1 },
+        "nickname": { "type": "string", "minLength": 1 },
+        "author_handle": { "type": "string" },
+        "signature": { "type": "string" },
+        "fans_count": { "type": "integer", "minimum": 0 },
+        "liked_count": { "type": "integer", "minimum": 0 },
+        "collected_count": { "type": "integer", "minimum": 0 },
+        "works_count": { "type": "integer", "minimum": 0 },
+        "verified": { "type": "boolean" },
+        "ip_location": { "type": "string" }
+      }
+    },
+    "sampled_works": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/work" }
+    },
+    "aggregate_stats": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "total_works",
+        "excluded_works_count",
+        "sampled_works_count",
+        "sampling_ratio",
+        "sampling_mode",
+        "analysis_window",
+        "global_title_keyword_distribution",
+        "global_caption_keyword_distribution",
+        "global_primary_text_keyword_distribution",
+        "global_hook_type_distribution",
+        "global_structure_type_distribution",
+        "global_cta_type_distribution",
+        "global_content_form_distribution",
+        "global_work_modality_distribution",
+        "global_performance_distribution",
+        "global_publish_time_distribution",
+        "global_duration_distribution",
+        "global_bucket_distribution",
+        "global_top_vs_mid_vs_bottom_deltas"
+      ],
+      "properties": {
+        "total_works": { "type": "integer", "minimum": 0 },
+        "excluded_works_count": { "type": "integer", "minimum": 0 },
+        "sampled_works_count": { "type": "integer", "minimum": 0 },
+        "sampling_ratio": { "type": "number", "minimum": 0 },
+        "sampling_mode": { "type": "string", "enum": ["standard"] },
+        "analysis_window": { "type": "string" },
+        "global_title_keyword_distribution": { "$ref": "#/$defs/distribution" },
+        "global_caption_keyword_distribution": { "$ref": "#/$defs/distribution" },
+        "global_primary_text_keyword_distribution": { "$ref": "#/$defs/distribution" },
+        "global_hook_type_distribution": { "$ref": "#/$defs/distribution" },
+        "global_structure_type_distribution": { "$ref": "#/$defs/distribution" },
+        "global_cta_type_distribution": { "$ref": "#/$defs/distribution" },
+        "global_content_form_distribution": { "$ref": "#/$defs/distribution" },
+        "global_work_modality_distribution": { "$ref": "#/$defs/distribution" },
+        "global_performance_distribution": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["available"],
+          "properties": {
+            "available": { "type": "boolean" },
+            "reason": { "type": "string" },
+            "max": { "type": "number" },
+            "min": { "type": "number" },
+            "p20": { "type": "number" },
+            "p50": { "type": "number" },
+            "p85": { "type": "number" }
+          }
+        },
+        "global_publish_time_distribution": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["weekday", "hour", "unavailable_count"],
+          "properties": {
+            "weekday": { "type": "array", "items": { "$ref": "#/$defs/distributionItem" } },
+            "hour": { "type": "array", "items": { "$ref": "#/$defs/distributionItem" } },
+            "unavailable_count": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "global_duration_distribution": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["available"],
+          "properties": {
+            "available": { "type": "boolean" },
+            "reason": { "type": "string" },
+            "items": { "type": "array", "items": { "$ref": "#/$defs/distributionItem" } }
+          }
+        },
+        "global_bucket_distribution": { "$ref": "#/$defs/distribution" },
+        "global_top_vs_mid_vs_bottom_deltas": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["top", "mid", "bottom"],
+          "properties": {
+            "top": { "$ref": "#/$defs/bucketDelta" },
+            "mid": { "$ref": "#/$defs/bucketDelta" },
+            "bottom": { "$ref": "#/$defs/bucketDelta" }
+          }
+        }
+      }
+    },
+    "platform_context": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["platform", "content_kind"],
+      "properties": {
+        "platform": { "type": "string", "minLength": 1 },
+        "content_kind": { "type": "string", "minLength": 1 },
+        "primary_work_modality": { "type": ["string", "null"], "enum": ["video", "text", null] }
+      }
+    },
+    "analysis_metadata": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "input_object_name",
+        "prompt_contract_path",
+        "input_schema_path",
+        "output_schema_path",
+        "analysis_mode",
+        "total_works",
+        "eligible_works_count",
+        "excluded_works_count",
+        "sampled_works_count"
+      ],
+      "properties": {
+        "input_object_name": { "type": "string", "minLength": 1 },
+        "prompt_contract_path": { "type": "string", "minLength": 1 },
+        "input_schema_path": { "type": "string", "minLength": 1 },
+        "output_schema_path": { "type": "string", "minLength": 1 },
+        "analysis_mode": { "type": "string", "minLength": 1 },
+        "total_works": { "type": "integer", "minimum": 0 },
+        "eligible_works_count": { "type": "integer", "minimum": 0 },
+        "excluded_works_count": { "type": "integer", "minimum": 0 },
+        "sampled_works_count": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}

package/skills/creator-analysis/references/schemas/author-analysis-v2.schema.json

@@ -0,0 +1,158 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "author_analysis_v2",
+  "type": "object",
+  "required": [
+    "author_positioning",
+    "trust_model",
+    "cognitive_engine",
+    "expression_hooks",
+    "content_mechanism",
+    "commercial_bridge",
+    "core_tensions",
+    "evidence_pack",
+    "clone_guidance"
+  ],
+  "properties": {
+    "author_positioning": {
+      "type": "object",
+      "required": ["role", "audience", "problem", "value"],
+      "properties": {
+        "role": { "type": "string" },
+        "audience": { "type": "string" },
+        "problem": { "type": "string" },
+        "value": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "trust_model": {
+      "type": "object",
+      "required": ["trust_source", "relationship_posture", "trust_risks"],
+      "properties": {
+        "trust_source": { "type": "string" },
+        "relationship_posture": { "type": "string" },
+        "trust_risks": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "cognitive_engine": {
+      "type": "object",
+      "required": ["worldview", "problem_definition", "reasoning_modes"],
+      "properties": {
+        "worldview": { "type": "string" },
+        "problem_definition": { "type": "string" },
+        "reasoning_modes": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "expression_hooks": {
+      "type": "object",
+      "required": ["hook_keywords", "hook_patterns", "memorability_sources"],
+      "properties": {
+        "hook_keywords": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "hook_patterns": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "memorability_sources": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "content_mechanism": {
+      "type": "object",
+      "required": ["topic_sources", "topic_goals", "winning_structures", "traffic_drivers"],
+      "properties": {
+        "topic_sources": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "topic_goals": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "winning_structures": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "traffic_drivers": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "commercial_bridge": {
+      "type": "object",
+      "required": ["funnel_role", "conversion_path", "commercial_risks"],
+      "properties": {
+        "funnel_role": { "type": "string" },
+        "conversion_path": { "type": "string" },
+        "commercial_risks": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "core_tensions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["label", "surface", "deep_reason", "strategic_implication"],
+        "properties": {
+          "label": { "type": "string" },
+          "surface": { "type": "string" },
+          "deep_reason": { "type": "string" },
+          "strategic_implication": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "evidence_pack": {
+      "type": "object",
+      "required": ["sample_size", "sample_confidence", "boundaries"],
+      "properties": {
+        "sample_size": { "type": "integer", "minimum": 0 },
+        "sample_confidence": {
+          "type": "string",
+          "enum": ["low", "medium", "high"]
+        },
+        "boundaries": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "clone_guidance": {
+      "type": "object",
+      "required": ["copyable_elements", "non_copyable_elements", "danger_zones", "if_only_learn_one_thing"],
+      "properties": {
+        "copyable_elements": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "non_copyable_elements": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "danger_zones": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "if_only_learn_one_thing": { "type": "string" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/skills/creator-analysis/references/schemas/sampled-work-batch-explanations.schema.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "sampled_work_batch_explanations",
+  "type": "object",
+  "required": ["sampled_work_explanations"],
+  "properties": {
+    "sampled_work_explanations": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": [
+          "why_it_worked_or_failed",
+          "copyable_elements",
+          "non_copyable_elements",
+          "emotional_triggers",
+          "cognitive_gap",
+          "commercial_signal"
+        ],
+        "properties": {
+          "why_it_worked_or_failed": { "type": "string" },
+          "copyable_elements": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "non_copyable_elements": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "emotional_triggers": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "cognitive_gap": { "type": "string" },
+          "commercial_signal": { "type": "string" }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/skills/creator-analysis/references/service-guides/asr-u2-u3-fallback.md

@@ -0,0 +1,75 @@
+# U2 ASR and U3 Public URL Fallback
+
+## Purpose
+
+- This guide defines the primary ASR path and timeout fallback for video tasks. It does not apply to text-only works.
+- Always try U2 ASR first. U3 is fallback-only and must not bypass U2 by default.
+- If a U1 detail route returns a no-watermark download link or another download URL that may not be publicly readable, use this guide to decide when to switch to U3.
+- Source: `https://app.tikomni.com/openapi/tikomni-openapi.full.with-u2.public.latest.json`
+- Fetched at: `2026-03-08T06:54:04+00:00`
+
+## Fixed Policy
+
+1. Call a U1 detail route first and collect `video_download_url`, a no-watermark download URL, or another directly downloadable media URL.
+2. Submit that URL to U2 ASR directly. Do not start with U3.
+3. If there is still no complete result after 90 seconds, stay in soft observation and keep the primary path unchanged.
+4. If there is still no result or still no complete result after 120 seconds, treat the source URL as likely not publicly readable and only then allow U3 fallback.
+5. After U3 completes, obtain a public URL and submit it to U2 ASR again.
+6. If U3 or the second U2 attempt still fails, keep the fact card and return `incomplete`. Do not fabricate the main text or any analysis conclusion.
+
+## Scenario Notes
+
+- Single content task: run this flow only for the current item.
+- Creator batch task: apply U3 fallback only to the subset that still has no result after 120 seconds. Do not re-upload items that already succeeded.
+
+## Route Facts
+
+### Submit U2 ASR job
+
+- Purpose: Default primary path. Submit the no-watermark or download URL returned by U1 directly to U2 ASR. Do not start with U3.
+- Tag: [`ASR-API`](../api-tags/asr-api.md)
+- Route: `POST /api/u2/v1/services/audio/asr/transcription`
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- Parameters: None
+- Request body: application/json: `input*`{`file_urls*`[string(uri)]}
+- Success response: 200 application/json: `request_id*`:string, `output*`{`task_id*`:string, `task_status*`:string, `submit_time`:string, `scheduled_time`:string, `end_time`:string, `task_metrics`{...}, `results`[object]}, `usage`{...}
+- Full contract: [`api-contracts/asr-api.md#post-api-u2-v1-services-audio-asr-transcription`](../api-contracts/asr-api.md#post-api-u2-v1-services-audio-asr-transcription)
+
+### Poll U2 job status
+
+- Purpose: Observe job completion. Stay in soft observation after 90 seconds. Trigger U3 fallback only if there is still no result after 120 seconds.
+- Tag: [`ASR-API`](../api-tags/asr-api.md)
+- Route: `POST /api/u2/v1/tasks/{task_id}`
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- Parameters: path: `task_id*`
+- Request body: None
+- Success response: 200 application/json: `time*`:string, `time_stamp*`:integer, `time_zone*`:string, `params*`{`task_id*`:string}, `data*`{`task_id*`:string, `task_status*`:string | null, `platform_task_status*`:string, `is_fully_succeeded*`:boolean, `submit_time`:string, `scheduled_time`:string, `end_time`:string, `task_metrics`{...}, ...}, `code*`:integer, `request_id*`:string, `message*`:string, ...
+- Full contract: [`api-contracts/asr-api.md#post-api-u2-v1-tasks-task-id`](../api-contracts/asr-api.md#post-api-u2-v1-tasks-task-id)
+
+### Request U3 upload / relay
+
+- Purpose: Use only if U2 still has no result after 120 seconds. Its purpose is to convert a private or non-publicly-readable source link into a public URL.
+- Tag: [`Media-Ingest-API`](../api-tags/media-ingest-api.md)
+- Route: `POST /api/u3/v1/uploads`
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- Parameters: None
+- Request body: application/json: `provider*`:string, `file_name*`:string, `content_type*`:string, `size_bytes*`:integer
+- Success response: 200 application/json: `time*`:string, `time_stamp*`:integer, `time_zone*`:string, `params*`{`provider*`:string, `file_name*`:string, `content_type*`:string, `size_bytes*`:integer}, `data*`{`upload_id*`:string, `provider*`:string, `upload_method*`:string, `upload_url*`:string, `upload_headers*`{...}, `upload_expires_at*`:string, `file_ttl_seconds*`:integer}, `code*`:integer, `request_id*`:string, `message*`:string, ...
+- Full contract: [`api-contracts/media-ingest-api.md#post-api-u3-v1-uploads`](../api-contracts/media-ingest-api.md#post-api-u3-v1-uploads)
+
+### Complete U3 upload and get a public URL
+
+- Purpose: Completion should return a public URL. Submit that URL to U2 ASR again. If it still fails, keep the fact card and return incomplete.
+- Tag: [`Media-Ingest-API`](../api-tags/media-ingest-api.md)
+- Route: `POST /api/u3/v1/uploads/{upload_id}/complete`
+- Auth: Header `Authorization: Bearer {token}`; docs also allow Cookie `Authorization` as fallback (`HTTPBearer`)
+- Parameters: path: `upload_id*`
+- Request body: application/json: dynamic object
+- Success response: 200 application/json: `time*`:string, `time_stamp*`:integer, `time_zone*`:string, `params*`{`upload_id*`:string}, `data*`{`upload_id*`:string, `provider*`:string, `file_url*`:string, `file_expires_at*`:string}, `code*`:integer, `request_id*`:string, `message*`:string, ...
+- Full contract: [`api-contracts/media-ingest-api.md#post-api-u3-v1-uploads-upload-id-complete`](../api-contracts/media-ingest-api.md#post-api-u3-v1-uploads-upload-id-complete)
+
+## Execution Notes
+
+- This guide only defines route order and fallback order. It does not replace platform-specific detail-route selection.
+- The U1 source route depends on the platform, for example a Douyin or Xiaohongshu detail route. This guide only requires using the returned download URL first.
+- If the platform already returns usable `subtitle_raw`, map it directly to `asr_raw` instead of calling U2 or U3.

package/skills/creator-analysis/references/workflow.md

@@ -0,0 +1,18 @@
+# Creator Workflow
+
+## Main Flow
+
+1. Collect creator fact fields.
+2. Collect the content set and write a fact card for each work.
+3. Run batch ASR for video items.
+4. Exclude works with `analysis_eligibility=incomplete` from downstream analysis.
+5. Run full aggregation, bucketing, and sampling.
+6. Run one batch explanation step for sampled works.
+7. Generate `author_analysis_v2`.
+8. Return the creator card, work cards, and aggregated conclusions.
+
+## Required Rules
+
+- Do not run per-work LLM deep analysis.
+- `sampled_work_explanations` must come from one batch stage only.
+- `author_analysis_v2` is the formal creator-level primary output.