@wji.ai/cli 0.8.3 → 0.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wji.ai/cli",
-  "version": "0.8.3",
+  "version": "0.9.1",
   "description": "Command line interface for the WJI AI platform",
   "license": "UNLICENSED",
   "author": "WJI AI",

package/skill/backreel/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: backreel
-description: Run a creator's works on Backreel (the film / short-drama showcase and crowdfunding site that shares accounts with WJI) with the `wji` CLI — create and publish a post (作品), prepare and upload cover / portrait / LookBook images at the right size and ratio, add cast and crew credits, upload and maintain episode videos (分集 via BytePlus VOD), set who can watch each episode, run a crowdfunding campaign with donation tiers and offline supporters, read donation records, and answer enquiries (查詢 / 合作邀請 / 投資 / 授權) — reply, accept or decline, grant partner access. Use whenever a task mentions Backreel, a Backreel post / work / reel, its episodes, trailer, cover or poster sizes, crowdfunding / 眾籌 / 捐款, supporters, or enquiries / 查詢 on a creator's work.
+description: Run a creator's works on Backreel (the film / short-drama showcase and crowdfunding site that shares accounts with WJI) with the `wji` CLI — create and publish a post (作品), prepare and upload cover / portrait / LookBook images at the right size and ratio, add cast and crew credits, upload and maintain episode videos (分集 via BytePlus VOD), set who can watch each episode, run a crowdfunding campaign with donation tiers and offline supporters, read donation records, answer enquiries (查詢 / 合作邀請 / 投資 / 授權) — reply, accept or decline, grant partner access — write blog posts (文章 / 作品動態) on a profile or under a project, and work the Job Plaza (接單廣場) — post a job, place a sealed bid, award it, then run the contract: payment plan, project credits, milestones, top-ups, change requests and disputes. Use whenever a task mentions Backreel, a Backreel post / work / reel, its episodes, trailer, cover or poster sizes, crowdfunding / 眾籌 / 捐款, supporters, enquiries / 查詢 on a creator's work, a Backreel blog post, project update or behind-the-scenes note, or a Backreel job, bid, quote, contract / 合約, milestone or dispute.
 ---
 
 # Backreel
@@ -97,6 +97,10 @@ wji br episode set <postId> 3 E03_v2.mp4               # replace the video
 wji br episode move <postId> 4 2
 wji br episode rm <postId> 6 -y
 wji br episode play <postId> 1        # short-lived URL to watch it yourself
+wji br episode play <postId> 1 --qualities   # renditions VOD made (1080p / 720p / …)
+wji br episode subs add <postId> 1 E01.zh-Hant.srt      # language guessed from the name
+wji br episode subs add <postId> 1 E01_en.vtt --lang en --default
+wji br episode subs <postId> 1        # list tracks; the first is the default
 ```
 
 Episodes exist on **showcase** posts only (≤30). A local file goes straight
@@ -105,7 +109,7 @@ nothing on the page can be copied and shared. Transcoding takes a few minutes;
 an episode stays `processing` until then and viewers get "still
 transcoding". Numbers on the command line are 1-based positions. Read
 [reference/episodes.md](reference/episodes.md) for the trailer, the legacy
-asset path, tier strategy and failure handling.
+asset path, tier strategy, subtitles and failure handling.
 
 ## 4. Crowdfunding and donations
 
@@ -148,6 +152,70 @@ accept, decline or grant on your own judgement. Read
 [reference/enquiries.md](reference/enquiries.md) for triage and reply
 patterns.
 
+## 6. Blog posts (文章 / 作品動態)
+
+Anyone can write a post on their profile, or under one of **their own**
+projects as a project update. Posts are drafts until published, and
+published posts go live straight away (admins can hide them afterwards).
+
+```bash
+wji br blog create --title "殺青了！拍攝第 21 天" --body @update.md \
+  --post <postId> --tags "幕後, 殺青" --cover ./still.jpg      # draft
+wji br blog get <blogId>                    # body prints back as Markdown
+wji br blog update <blogId> --body @update.md --excerpt "一句話摘要"
+wji br blog publish <blogId>                # | unpublish — back to drafts
+wji br blog list --mine                     # yours, drafts and hidden included
+wji br blog list --post <postId>            # a project's updates
+wji br blog list --official                 # Backreel press releases
+wji br blog delete <blogId> -y
+```
+
+`--body` is Markdown by default (`## heading`, `- list`, `**bold**`,
+`[link](https://…)`, `![image](https://…)`; blank line between paragraphs) —
+pass `--html` to send HTML. Only full `http(s)` links survive; site paths
+like `(/blog)` are removed. `--post none` moves a post back to the profile;
+`--cover none` clears the cover. If `publish` reports the post is hidden, an
+admin hid it — tell the user the reason; republishing does not unhide it.
+Publishing is outward-facing: show the user the title and body first.
+
+Official press releases are written with the private `wji-admin backreel
+blog` commands, not here.
+
+## 7. Job Plaza and contracts (接單廣場 / 合約)
+
+Someone posts a job, creators bid (sealed), the poster awards one bid and a
+contract is drafted. The contract has 2–3 payments, at least 25% in WJI
+credits; the poster funds the credits into a project workspace, the creator
+delivers payment by payment.
+
+```bash
+wji br job list -k teaser                    # open jobs; --mine for yours
+wji br job create "30s teaser" --category advertising --brief @brief.md \
+  --deliverables "1 × 30s" --budget 8000-12000 --currency HKD --credits 30000 --deadline 2026-12-01
+wji br job bid <jobId> --price 9000 --currency HKD --credits 30000 --days 14 --pitch @pitch.md
+wji br job bids <jobId> ; wji br job award <bidId> -y      # poster
+wji br contract plan <id> --credits 30000 --payment "Draft|2026-12-08|4000" --payment "Final|2026-12-20|5000"
+wji br contract accept <id> ; wji br contract fund <id> -y
+wji br contract submit <id> 1 --note "First cut" --link https://…
+wji br contract approve <id> 1               # | revise <id> 1 --note "…"
+wji br contract get <id>                     # what to do next
+```
+
+Contract commands take the contract id or the job id. Top-ups, change
+requests, cancelling and disputes are in
+[reference/jobs.md](reference/jobs.md) — read it before any contract step.
+Act as an organization with `--org <orgId>` (`wji br org` lists yours).
+
+## Profile, organizations and history
+
+```bash
+wji br org                                   # organizations you belong to, with your role
+wji br org get <orgId>                       # an org's public page
+wji br about --text @about.md --region HK    # your profile; --org <orgId> for an org you manage
+wji br history                               # what you've viewed; rm <id> | clear -y
+wji br create "Harbour" --org <orgId>        # publish as an org (only the author can change it later)
+```
+
 ## Credits
 
 ```bash
@@ -160,8 +228,10 @@ wji br credit rm <postId> 3 -y
 
 ## Rules of thumb
 
-- **Ask before anything outward-facing**: publishing, unpublishing, deleting,
-  replying to or deciding an enquiry, granting access, turning donations on.
+- **Ask before anything outward-facing**: publishing (posts and blog posts), unpublishing, deleting,
+  replying to or deciding an enquiry, granting access, turning donations on, posting a job,
+  bidding, awarding, sending / accepting a plan, funding, approving a payment, top-ups,
+  change requests, cancelling and disputes (most of these move WJI credits).
   Draft edits are safe to make and show.
 - Generating images (e.g. the AI poster) spends WJI credits — confirm first.
 - Episode uploads go to the live VOD space even from a test post; don't

package/skill/backreel/reference/episodes.md

@@ -78,6 +78,44 @@ wji br episode rm <postId> 7 8 -y
 Removing an episode does not delete the video from VOD; re-adding it later
 with `--vid` works.
 
+## Subtitles
+
+Each episode takes up to 8 subtitle tracks, one per language, from `.srt` or
+`.vtt` files (≤1 MB). The server cleans them into plain WebVTT — italics,
+colours and `{\an8}` positioning are dropped. The **first** track is the
+default; viewers who never chose one get the track matching the site's
+language, else the default.
+
+```bash
+wji br episode subs add <postId> 2 E02.zh-Hant.srt       # zh-Hant guessed from the name
+wji br episode subs add <postId> 2 E02.srt --lang en --label "English (CC)"
+wji br episode subs add <postId> 2 E02_en_v2.srt --lang en --replace
+wji br episode subs default <postId> 2 en
+wji br episode subs label <postId> 2 en                  # back to the language name
+wji br episode subs rm <postId> 2 ja ko
+wji br episode subs <postId> 2
+```
+
+Languages are BCP 47 tags: `zh-Hant`, `zh-Hans`, `yue`, `en`, `ja`, `ko`,
+`th`, `vi`, `id`, `ms`, `es`, `pt`, `fr`, `de` (others are accepted, but the
+player shows the raw code). A file the server can't read fails at upload,
+before the episode changes. `add` warns when the last line runs past the
+episode's length — usually the wrong episode's file.
+
+Subtitles follow the episode's tier: a locked episode never serves its text.
+Replacing the video (`episode set <post> <n> new.mp4`) keeps the tracks; remove
+them if the new cut changed the timing.
+
+## Quality
+
+VOD transcodes each upload into the renditions its template defines. The
+player offers Auto plus each one; with a single rendition the menu hides.
+
+```bash
+wji br episode play <postId> 1 --qualities   # what VOD made
+wji br episode play <postId> 1 -q 720p       # URL of one rendition
+```
+
 ## Who can watch: tiers
 
 `public` anyone · `member` signed in · `supporter` has donated to this post ·

package/skill/backreel/reference/jobs.md

@@ -0,0 +1,154 @@
+# Job Plaza and job contracts
+
+The Job Plaza (接單廣場) is where someone who needs a film, ad or short drama
+**posts a job**, creators **place sealed bids**, and the poster **awards one**.
+Award drafts a **contract**; the contract carries the work through a payment
+plan, project credits held in a WJI workspace, milestones and, if needed, a
+dispute.
+
+Everything is `wji br job …` and `wji br contract …`. Add `--json` for ids.
+
+## Who can do what
+
+| Step | Who | Command |
+| --- | --- | --- |
+| post / edit / close / reopen / cancel a job | the poster (or a member of the posting org) | `br job create`, `set`, `close`, `reopen`, `cancel` |
+| see bids on a job | the poster only — bids are sealed | `br job bids <jobId>` |
+| bid, change, withdraw | any creator (verified only, if the job says so) | `br job bid`, `bid-set`, `withdraw` |
+| award | the poster | `br job award <bidId>` |
+| plan | either side; sending counts as your acceptance | `br contract plan` |
+| accept the other side's plan | the side that didn't send it | `br contract accept` |
+| fund | poster | `br contract fund` |
+| submit a payment | creator | `br contract submit` |
+| approve / revise | poster | `br contract approve`, `revise` |
+| mark cash paid / received | poster / creator | `br contract paid`, `received` |
+| top up project credits | creator | `br contract topup` |
+| change request | creator proposes, poster accepts or declines | `br contract change …` |
+| dispute | either side | `br contract dispute`, `statement` |
+
+`wji br org` lists the organizations you can act for; pass `--org <orgId>` to
+`job create`, `job bid`, `br create` or `blog create` to act as one.
+
+## Posting a job
+
+```bash
+wji br job create "30s product teaser" --category advertising \
+  --brief @brief.md --deliverables "1 × 30s, 16:9 and 9:16" \
+  --budget 8000-12000 --currency HKD --credits 30000 \
+  --duration 30 --resolution 1080p --upscale --model seedance-2.5 \
+  --deadline 2026-12-01 --delivery 2026-12-20 --verified-only
+wji br job list --mine                # yours, every status
+wji br job get <jobId>
+wji br job close <jobId>              # stop bids early | reopen | cancel
+```
+
+- Amounts are typed in `--currency` and stored in USD; everyone sees them in
+  their own display currency.
+- `--duration` takes `90`, `3m`, `1h30m` or `2:30`. `--resolution` is
+  480p / 720p / 1080p / 2k / 4k; `--upscale` says upscaling to it is fine.
+- The bid deadline is at most 90 days out. Posting is public right away —
+  confirm the text with the user first.
+
+## Bidding
+
+```bash
+wji br job list -k teaser --category advertising --sort budget
+wji br job quota                       # bids left this month, per identity
+wji br job bid <jobId> --price 9000 --currency HKD --credits 30000 \
+  --days 14 --pitch @pitch.md --work <postId> --work <postId>
+wji br job bids                        # your bids and their status
+wji br job bid-set <bidId> --price 8500 ; wji br job withdraw <bidId>
+```
+
+Each identity (you, each org) has a monthly bid quota (VIP unlimited). Bids
+are sealed: only the poster sees them. A bid can show up to 3 of the
+bidder's published Backreel works.
+
+## Award → contract
+
+```bash
+wji br job bids <jobId>                # poster: compare
+wji br job award <bidId> -y            # declines the others, drafts the contract
+```
+
+`award` prints the contract id. Every `br contract` command takes the
+contract id **or the job id**.
+
+## The payment plan
+
+2 or 3 payments, each with a title, due date and cash amount. At least 25% of
+the contract total must be WJI credits (credits ÷ credits-per-USD, frozen at
+250 per US$ when the plan locks).
+
+```bash
+wji br contract plan <id> --currency HKD --credits 30000 \
+  --payment "Draft|2026-12-08|4000|First cut at 720p" \
+  --payment "Final|2026-12-20|5000|Final 1080p with sound"
+wji br contract get <id>               # totals, payments, what to do next
+wji br contract accept <id>            # the other side locks it
+```
+
+- `--payment "Title|YYYY-MM-DD|cash[|credits[|deliverable]]"`. Without
+  `--payment`, `plan` keeps the current payments and only changes what you
+  pass (e.g. `--credits`).
+- Credits are released **all at once** by default (`--release upfront`); with
+  `--release milestones` each payment carries its own credits (4th field).
+- Sending a plan counts as your acceptance; the other side accepts or sends
+  back an edited one.
+
+## Funding and production
+
+```bash
+wji br contract fund <id> -y           # poster: takes the credits from the poster's WJI balance
+wji br contract submit <id> 1 --note "First cut" --link https://…
+wji br contract revise <id> 1 --note "Tighter opening"   # 2 revisions included per payment
+wji br contract approve <id> 1         # starts the next payment; the last one completes the contract
+wji br contract paid <id> 1 ; wji br contract received <id> 1   # cash is paid off-platform
+```
+
+- Funding creates a WJI workspace owned by the poster with the creator as
+  editor. Generations there spend only the project credits; nobody can spend
+  them elsewhere. `contract get` shows credits left and the workspace id.
+- A submitted payment auto-approves after 7 days if the poster does nothing.
+- On completion the poster's unused credits go to the creator; on cancel
+  they go back to the poster. Creator top-ups that weren't used always go
+  back to the creator.
+
+## When the budget runs out
+
+- 5% overdraft is automatic; both sides are told at 80% and when it's used up.
+- The creator can add their own credits: `wji br contract topup <id> 5000`.
+- If the poster changed the scope or asked for a third revision, the creator
+  asks for more:
+
+```bash
+wji br contract change request <id> --credits 10000 --cash 100 --reason scope --note "Two extra scenes"
+wji br contract change accept <id> --note "OK"      # poster; takes the credits from their balance
+wji br contract change decline <id> --note "…"      # | withdraw (creator)
+```
+
+Extra cash also needs ≥25% in credits; the CLI checks before sending.
+
+## Cancelling, silence and disputes
+
+```bash
+wji br contract cancel <id> --reason "…"     # planning/funding: immediate; production: the other side confirms
+wji br contract cancel <id> --decline        # | --withdraw
+wji br contract dispute <id> --reason @what-happened.md -y
+wji br contract statement <id> --text @my-side.md --link https://…
+wji br contract dispute <id> --withdraw      # only the side that raised it
+```
+
+- A dispute stops generation in the project workspace and pauses due dates
+  until a WJI admin decides: continue, or cancel and split the poster's unused
+  credits. The admin side is `wji-admin backreel contracts`.
+- If the creator does nothing for 14 days after a due date, `contract get`
+  says so to the poster and `cancel` goes through immediately.
+
+## Rules
+
+- Ask before every outward or money step: posting a job, bidding, awarding,
+  sending or accepting a plan, funding, approving, top-ups, change requests,
+  cancelling and disputes.
+- Server errors are Chinese (e.g. `至少 25% 的合約總值須以 WJI 積分支付`); relay
+  them and say what to change.

package/skill/npc-character/SKILL.md

@@ -21,7 +21,7 @@ NPC is addressed by id, `@handle` or name.
    permission; it starts private), then upload the headshot and at least one
    scene image on the web — live stages need both:
    ```bash
-   wji npc handle nagi.npc                                  # is the handle free?
+   wji npc handle nagi.npc                                  # is the handle free? (system / brand names like admin, official, npccity are reserved)
    wji npc create "NAGI" --role "Radio Host" --genre "Lo-fi" --handle nagi.npc
    ```
    The handle is fixed from here on; the name is stored in capitals.

package/skill/wji/SKILL.md

@@ -487,11 +487,15 @@ wji npc doc apply @mika @mika.md --dry-run     # see the diff, then without --dr
 - `npc create` needs NPC City spawn permission on the account (a 403 says so);
   only an admin can grant it. Admin actions — spawn permission, featured / hero
   slider, moderation — are not in `wji`.
+- Handles are 2–32 of a-z 0-9 . _ -; NPC City reserves system and brand names (admin, official,
+  npccity, wji, backreel, …) anywhere in the handle — `wji npc handle <h>` says why one is refused.
+  An NPC created without `--image` has no avatar (NPC City shows its initials).
 - `npc transfer send <npc> --to <email>` offers the NPC to someone; they
   `npc transfer accept <id>` within 7 days. You lose it on acceptance.
 
 **Backreel posts** are your film / project pages. `create` always makes a
-draft; publishing needs a cover, media or an episode.
+draft; publishing needs a cover, media or an episode. Jobs, bids and contracts
+(`wji br job …`, `wji br contract …`) are covered by the `backreel` skill.
 
 ```bash
 wji backreel list                              # yours, drafts included; --all for published posts