Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,15 @@

Museon CLI follows semantic versioning for its package and command contract.

## 3.2.0

Creator Sourcing reads what people wrote on their forms. Other domains are unchanged.

- `ugc sourcing +questions` lists the form questions people answered, most answered first, with how many answered each and, for a choice question, how many chose each value.
- `ugc sourcing +list --answer 'QUESTION::VALUE'` narrows by their latest answer to a question (the same question on every project's form counts as one). Values of one question match any; different questions must all match. Each row now carries `form_answers`, `sample_videos` and `creator_link`, and `--search` also matches answer text.
- `--category` and `--content-type` take only the creator form's values, and `--country` / `--language` take only codes (`US`, `en`, `zh-Hant`; country in any case). A misspelt value used to match nobody without a word; it is now refused with the accepted values.
- The command contract revision moves with the package to 3.2.0. Sync the API's vendored `agent_cli_command_catalog.json` to this revision before tagging.

## 3.1.0

Creator Sourcing for MuseOn staff, matching the internal `/creator-sourcing` page. Other domains are unchanged.
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -154,7 +154,7 @@ If you prefer to install the CLI yourself, use Python 3.11+, `uv`, and the exact
wheel from the official GitHub release:

```bash
uv tool install "https://github.com/Museon-AI/museon-cli/releases/download/v3.1.0/museoncli-3.1.0-py3-none-any.whl"
uv tool install "https://github.com/Museon-AI/museon-cli/releases/download/v3.2.0/museoncli-3.2.0-py3-none-any.whl"
```

Then continue with Skill setup and browser authorization:
Expand Down
2 changes: 1 addition & 1 deletion README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -122,7 +122,7 @@ MuseOn 只有组织:访问权限由组织角色加 Campaign 范围决定。每
固定版本的 wheel:

```bash
uv tool install "https://github.com/Museon-AI/museon-cli/releases/download/v3.1.0/museoncli-3.1.0-py3-none-any.whl"
uv tool install "https://github.com/Museon-AI/museon-cli/releases/download/v3.2.0/museoncli-3.2.0-py3-none-any.whl"
```

安装成功后继续配置 Skills 和浏览器授权:
Expand Down
196 changes: 174 additions & 22 deletions contracts/command-catalog.json
Original file line number Diff line number Diff line change
Expand Up @@ -18448,7 +18448,34 @@
"risk_level": "read",
"shortcut": "+list",
"stability": "stable",
"summary": "Find creators for a new project: everyone who joined the community or applied to a project, filtered and sorted, with how they joined, what they declared, their projects, performance (posts, average and best views, viral posts, last post), latest stills and the team's note. Total in `total`. MuseOn staff only, as in the web.",
"summary": "Find creators for a new project: everyone who joined the community or applied to a project, filtered and sorted, with how they joined, what they declared, their latest form answers (`form_answers`), sample videos and work link, their projects, performance (posts, average and best views, viral posts, last post), latest stills and the team's note. Total in `total`. Narrow by form answers with --answer; `sourcing +questions` lists the questions and choices. MuseOn staff only, as in the web.",
"supports_dry_run": false,
"transport": "agent_cli_api"
},
{
"authorization": {
"authentication_required": true,
"enforcement": "museon_server",
"organization_bound": true,
"required_roles": [
"staff"
],
"required_scopes": [
"agent_cli.access"
],
"resource_policy": "staff_with_organization_creator_read"
},
"capability_key": "ugc.sourcing-questions",
"cli": "museoncli ugc sourcing +questions",
"domain": "ugc",
"execution": "direct",
"name": "ugc.sourcing-questions",
"requires_confirmation": false,
"resource": "sourcing",
"risk_level": "read",
"shortcut": "+questions",
"stability": "stable",
"summary": "List the form questions creators in scope answered, most answered first: each question's label and type, how many people answered it, and for a choice question how many chose each value. Use a label and value with `sourcing +list --answer 'QUESTION::VALUE'`. MuseOn staff only, as in the web.",
"supports_dry_run": false,
"transport": "agent_cli_api"
},
Expand Down Expand Up @@ -18610,7 +18637,7 @@
"html-documents"
]
},
"contract_revision": "3.1.0",
"contract_revision": "3.2.0",
"package": "museoncli",
"schema_version": 3,
"schemas": {
Expand Down Expand Up @@ -89265,7 +89292,7 @@
"cli": "museoncli ugc sourcing +list",
"domain": "ugc",
"examples": [
"museoncli ugc sourcing +list --country US --language en --platform tiktok --sort avg-views --page-size 20"
"museoncli ugc sourcing +list --country US --language en --answer 'Which of these have you done before?::3D design' --sort avg-views --page-size 20"
],
"execution": "direct",
"input_schema": {
Expand All @@ -89284,32 +89311,66 @@
],
"type": "string"
},
"answer": {
"description": "Their latest answer to a form question holds this value, written QUESTION::VALUE with the question and value exactly as `sourcing +questions` lists them (question in any case). Repeatable: values of one question match any, different questions must all match.",
"items": {
"description": "Form answer filter.",
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"maxItems": 50,
"minItems": 0,
"type": "array"
},
"campaign_id": {
"description": "Only people in this project (UGC Campaign id).",
"format": "uuid",
"type": "string"
},
"category": {
"description": "Primary topic they declared, e.g. technology. Repeatable.",
"description": "Primary topic they declared. Repeatable.",
"items": {
"description": "Primary topic they declared, e.g. technology. Repeatable.",
"maxLength": 80,
"minLength": 1,
"description": "Primary topic they declared. Repeatable.",
"enum": [
"beauty",
"fashion",
"food",
"pets",
"technology",
"gaming",
"home",
"fitness",
"travel",
"parenting",
"lifestyle",
"other",
"exploring"
],
"type": "string"
},
"maxItems": 50,
"maxItems": 13,
"minItems": 0,
"type": "array"
},
"content_type": {
"description": "Content type they declared, e.g. tutorials. Repeatable.",
"description": "Content type they declared. Repeatable.",
"items": {
"description": "Content type they declared, e.g. tutorials. Repeatable.",
"maxLength": 80,
"minLength": 1,
"description": "Content type they declared. Repeatable.",
"enum": [
"tutorial",
"review",
"unboxing",
"vlog",
"comedy",
"testimonial",
"screen-recording",
"other",
"exploring"
],
"type": "string"
},
"maxItems": 50,
"maxItems": 9,
"minItems": 0,
"type": "array"
},
Expand All @@ -89325,10 +89386,10 @@
"type": "string"
},
"country": {
"description": "ISO country code they declared, e.g. US. Repeatable.",
"description": "Two-letter ISO country code they declared, e.g. US. Repeatable.",
"items": {
"description": "ISO country code they declared, e.g. US. Repeatable.",
"maxLength": 80,
"description": "Two-letter ISO country code they declared, e.g. US. Repeatable.",
"maxLength": 40,
"minLength": 1,
"type": "string"
},
Expand All @@ -89337,10 +89398,10 @@
"type": "array"
},
"language": {
"description": "Language tag they speak, e.g. en. Repeatable.",
"description": "Language code they speak, e.g. en, es, zh-Hant (not a language name). Repeatable.",
"items": {
"description": "Language tag they speak, e.g. en. Repeatable.",
"maxLength": 80,
"description": "Language code they speak, e.g. en, es, zh-Hant (not a language name). Repeatable.",
"maxLength": 40,
"minLength": 1,
"type": "string"
},
Expand All @@ -89354,7 +89415,7 @@
"type": "integer"
},
"min_followers": {
"description": "Largest follower count at least this.",
"description": "Largest follower count at least this, among the accounts they post with in our projects (the accounts on their forms are not measured).",
"minimum": 0,
"type": "integer"
},
Expand Down Expand Up @@ -89396,7 +89457,7 @@
"type": "array"
},
"search": {
"description": "Name, handle or note contains this.",
"description": "Name, handle, note or any form answer contains this.",
"maxLength": 200,
"minLength": 1,
"type": "string"
Expand Down Expand Up @@ -89503,7 +89564,98 @@
"risk_level": "read",
"shortcut": "+list",
"stability": "stable",
"summary": "Find creators for a new project: everyone who joined the community or applied to a project, filtered and sorted, with how they joined, what they declared, their projects, performance (posts, average and best views, viral posts, last post), latest stills and the team's note. Total in `total`. MuseOn staff only, as in the web.",
"summary": "Find creators for a new project: everyone who joined the community or applied to a project, filtered and sorted, with how they joined, what they declared, their latest form answers (`form_answers`), sample videos and work link, their projects, performance (posts, average and best views, viral posts, last post), latest stills and the team's note. Total in `total`. Narrow by form answers with --answer; `sourcing +questions` lists the questions and choices. MuseOn staff only, as in the web.",
"supports_dry_run": false,
"transport": "agent_cli_api"
},
"ugc.sourcing-questions": {
"authorization": {
"authentication_required": true,
"enforcement": "museon_server",
"organization_bound": true,
"required_roles": [
"staff"
],
"required_scopes": [
"agent_cli.access"
],
"resource_policy": "staff_with_organization_creator_read"
},
"capability_key": "ugc.sourcing-questions",
"cli": "museoncli ugc sourcing +questions",
"domain": "ugc",
"examples": [
"museoncli ugc sourcing +questions"
],
"execution": "direct",
"input_schema": {
"additionalProperties": false,
"properties": {},
"required": [],
"type": "object"
},
"name": "ugc.sourcing-questions",
"output_schema": {
"description": "The questions (items), each with label, type, people and options.",
"properties": {
"command": {
"type": "string"
},
"data": {
"type": [
"object",
"array",
"string",
"number",
"boolean",
"null"
]
},
"next_steps": {
"items": {
"type": "string"
},
"type": "array"
},
"ok": {
"type": "boolean"
},
"organization": {
"description": "The organization this command addressed (id, name).",
"type": [
"object",
"null"
]
},
"run": {
"type": [
"object",
"null"
]
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"ok",
"command",
"data",
"run",
"warnings",
"next_steps"
],
"type": "object"
},
"requires_confirmation": false,
"resource": "sourcing",
"risk_level": "read",
"shortcut": "+questions",
"stability": "stable",
"summary": "List the form questions creators in scope answered, most answered first: each question's label and type, how many people answered it, and for a choice question how many chose each value. Use a label and value with `sourcing +list --answer 'QUESTION::VALUE'`. MuseOn staff only, as in the web.",
"supports_dry_run": false,
"transport": "agent_cli_api"
},
Expand Down
5 changes: 3 additions & 2 deletions contracts/task-index.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -444,10 +444,11 @@ chapters:
see: [creator-ids]
- id: ugc-creator-sourcing
title: Find creators for a new project (MuseOn staff)
when: ["creator sourcing", "source creators", "find creators for a project", "creator forms", "creator works", "创作者寻源", "找创作者", "报名表", "大群注册表", "作品"]
when: ["creator sourcing", "source creators", "find creators for a project", "creator forms", "creator works", "form answers", "创作者寻源", "找创作者", "报名表", "大群注册表", "表单回答", "作品"]
before: MuseOn staff only, as the Creator Sourcing page; the team's notes are edited in the web.
steps:
- ugc.sourcing-list: "Everyone who joined the community or applied; filter by country, language, topic, platform, views; --sort avg-views."
- ugc.sourcing-questions: "The form questions people answered and each choice's count: the labels and values for --answer."
- ugc.sourcing-list: "Everyone who joined the community or applied, with their latest form answers; filter by country, language, topic, platform, views, --answer 'QUESTION::VALUE'; --search also matches answers; --sort avg-views."
- ugc.sourcing-forms: "Every form one person filled in: the community registration and each project application."
- ugc.sourcing-works: "Their newest works in our projects with views, stills and media links."
see: [creator-ids]
Expand Down
5 changes: 3 additions & 2 deletions docs/agent-discoverability.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ after changing specs; `tests/test_docs_sync.py` fails CI on drift.

<!-- BEGIN GENERATED COMMANDS (scripts/gen_command_docs.py) -->

504 commands across 18 domains (source of truth: `museoncli schema`).
505 commands across 18 domains (source of truth: `museoncli schema`).

### research

Expand Down Expand Up @@ -547,7 +547,8 @@ after changing specs; `tests/test_docs_sync.py` fails CI on drift.
| `ugc enrollment +get-contract` | read | — | — | direct | Read one enrollment's contract: its state (draft, sent, signed, terminated), rendered terms and signatures. Owner/admin and the Campaign's operators; members cannot read it. |
| `ugc creator +list` | read | — | — | direct | List the creators the organization works with across its Campaigns, newest first: name, accounts and Campaigns. Operating organization's owner, admin and operators (an operator sees their assigned Campaigns' creators). |
| `ugc creator +get` | read | — | — | direct | Read one creator of the organization: profile, accounts and the Campaigns they are in. Same visibility as creator +list. |
| `ugc sourcing +list` | read | — | — | direct | Find creators for a new project: everyone who joined the community or applied to a project, filtered and sorted, with how they joined, what they declared, their projects, performance (posts, average and best views, viral posts, last post), latest stills and the team's note. Total in `total`. MuseOn staff only, as in the web. |
| `ugc sourcing +list` | read | — | — | direct | Find creators for a new project: everyone who joined the community or applied to a project, filtered and sorted, with how they joined, what they declared, their latest form answers (`form_answers`), sample videos and work link, their projects, performance (posts, average and best views, viral posts, last post), latest stills and the team's note. Total in `total`. Narrow by form answers with --answer; `sourcing +questions` lists the questions and choices. MuseOn staff only, as in the web. |
| `ugc sourcing +questions` | read | — | — | direct | List the form questions creators in scope answered, most answered first: each question's label and type, how many people answered it, and for a choice question how many chose each value. Use a label and value with `sourcing +list --answer 'QUESTION::VALUE'`. MuseOn staff only, as in the web. |
| `ugc sourcing +forms` | read | — | — | direct | Read every form one creator filled in, newest first: the community registration form (naming the project it was sent with, if any) and each project application with its answers, accounts and sample videos. MuseOn staff only, as in the web. |
| `ugc sourcing +works` | read | — | — | direct | Read one creator's newest works in our projects (up to `limit`): each cut's still, media and original links, project, platform, publish date and views of its latest post. MuseOn staff only, as in the web. |
| `ugc client-report +list` | read | — | — | direct | List a Campaign's generated client reports (daily and weekly), newest first: type, title, status (draft, in review, ready, sent, skipped), period, revision and due time. The operating organization's owner, admin and the Campaign's operators; a shared Campaign's partner cannot read them. |
Expand Down
Loading
Loading