@lemoncat7/dsh-partner 2.4.2 → 2.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lemoncat7/dsh-partner",
-  "version": "2.4.2",
+  "version": "2.7.0",
   "description": "Long-lived AI companions with WeChat, Matrix and Mattermost channels for DeepSeek Harness",
   "keywords": [
     "deepseek-harness",
@@ -26,6 +26,8 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "resources/skills/**/*",
+    "docs/director-skills.md",
     "lib/**/*.js",
     "lib/**/*.d.ts",
     "lib/**/*.map",
@@ -39,6 +41,8 @@
     "docs/releases/2.4.0.md",
     "docs/releases/2.4.1.md",
     "docs/releases/2.4.2.md",
+    "docs/releases/2.5.0.md",
+    "docs/releases/2.6.0.md",
     "docs/mcp.md",
     "docs/channel-questions-and-avatar.md",
     "docs/memory-quality.md",
@@ -51,12 +55,15 @@
     "docs/releases/1.16.1.md",
     "docs/releases/1.16.2.md",
     "docs/channel-reply-progress.md",
+    "docs/long-task-continuation.md",
     "docs/channel-message-format.md",
     "docs/notification-delivery.md",
     "docs/direct-channels.md",
     "docs/THIRD_PARTY_LICENSES.md",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "docs/releases/2.7.0.md",
+    "docs/attachment-storage.md"
   ],
   "dsh": {
     "bundle": {
@@ -70,7 +77,8 @@
         "@deepseek-ai/dsh-client-ui-sidebar",
         "@deepseek-ai/dsh-client-ui-layout",
         "@deepseek-ai/dsh-client-ui-slots",
-        "@deepseek-ai/dsh-client-ui-theme"
+        "@deepseek-ai/dsh-client-ui-theme",
+        "@deepseek-ai/dsh-client-ui-workspace"
       ]
     }
   },
@@ -85,7 +93,7 @@
     "pack:check": "npm pack --dry-run"
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-ai/schemastery": "~3.18.4",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "mdast-util-from-markdown": "2.0.3",
     "mdast-util-gfm": "3.1.0",
@@ -93,45 +101,50 @@
     "micromark-extension-gfm": "3.0.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-agent-default-model": "^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-attachment": "^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-credentials": "^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-scope": "^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-session": "^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-user-questions": "^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-workspace": "^0.1.2-rc.1 || ^0.1.5-rc.1"
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-agent": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-agent-default-model": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-agent-preset-registry": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-attachment": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-credentials": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-scope": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-user-questions": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-workspace": "^0.1.7-rc.2"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-agent-default-model": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-agent-presets": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-api-remotes": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-api-session-controller": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-attachment": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-layout": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-theme": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-credentials": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-llm": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-scope": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-session": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-settings": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-system-prompt": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-tools": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-user-questions": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-workspace": "0.1.2-rc.1",
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-agent-default-model": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-agent-preset-registry": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-layout": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-theme": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-workspace": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-credentials": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-ptc-runtime": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-sandbox": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-sandbox-policy": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-scope": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-user-approval": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-user-questions": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-workspace": "0.1.7-rc.2",
     "@dimforge/rapier3d-compat": "0.20.0",
     "@types/node": "^24.0.0",
     "@types/react": "18.3.28",
@@ -139,6 +152,7 @@
     "esbuild": "^0.25.0",
     "qrcode.react": "^4.2.0",
     "react": "18.3.1",
+    "react-dom": "18.3.1",
     "three": "0.185.1",
     "typescript": "^5.9.3"
   },

package/resources/skills/cinematic-director/manifest.json

@@ -0,0 +1,205 @@
+{
+  "schemaVersion": 1,
+  "repository": "https://github.com/wuwangzhang1216/DirectorSKILL",
+  "commit": "c65ae0d14457053efb1e354c7e7f7e120d97fad1",
+  "license": "MIT",
+  "normalization": "LF line endings and terminal newline only",
+  "files": [
+    {
+      "path": "upstream/CHANGELOG.md",
+      "sha256": "ebcbaf9bb45908127b0c3bd71873b90bc42e356293b2b32edd72b79ebc431401"
+    },
+    {
+      "path": "upstream/CONTRIBUTING.md",
+      "sha256": "b457e8094b71f8619685073032b38dcb342a5df4d3439f1f20440b9f71a9d1ad"
+    },
+    {
+      "path": "upstream/LICENSE",
+      "sha256": "df731ea2e1ffd3b8890ad246da3df96ceba3301c16fb4970c16811df4c728b56"
+    },
+    {
+      "path": "upstream/README.md",
+      "sha256": "de61800434c2ff91cb5aff1b86d35d542b70d3b64716ecb09c1fa8322b9c1fd9"
+    },
+    {
+      "path": "upstream/SKILL.md",
+      "sha256": "543be6ece626beaa7dbc36b8225dcdc0b763d8044563189e842b306bb5cfd792"
+    },
+    {
+      "path": "upstream/assets/beat-sheet-template.md",
+      "sha256": "e53e846e9f43cdc80cf261bde4978001628d6383a6d4bd702762f88131e04bda"
+    },
+    {
+      "path": "upstream/assets/director-book-template.md",
+      "sha256": "d6f0901207a822220fe87a7ca2feeea0ddeaf142a168a03704456e69b0ad68b0"
+    },
+    {
+      "path": "upstream/assets/edit-timeline-template.md",
+      "sha256": "b6a6ad673094a419ada6afb9d8e613b4d2c8538cface5cb17031bc7b408fc5ee"
+    },
+    {
+      "path": "upstream/assets/keyframe-prompt-template.md",
+      "sha256": "9d9f4463e87551c29268e6179890291ce90bbd1adb6cc2c48e62116df90fa527"
+    },
+    {
+      "path": "upstream/assets/qc-checklist.md",
+      "sha256": "ca10d9bd57a253d555b18a5ca4f1e29e7ff944434adb1e74b45fa4dffe2f4a11"
+    },
+    {
+      "path": "upstream/assets/shot-plan-template.md",
+      "sha256": "74aad412013e13ff0b3ff05880f55f74aadf009a080188a7adc91b4b3ff87688"
+    },
+    {
+      "path": "upstream/assets/sound-plan-template.md",
+      "sha256": "f8a4064cc2817aaba3e49027e6c93552693b773ffce2ab4058223f8745cc42d6"
+    },
+    {
+      "path": "upstream/assets/video-prompt-template.md",
+      "sha256": "0f70494e620e9ad72355799421ff53b02b8e347eb1fb10a80a008bba9bb4473b"
+    },
+    {
+      "path": "upstream/evals/run.md",
+      "sha256": "27f46fdbefab8eb7b21991d6d8ef7d5afa6cac7a5b980693276d7e8462c7ca1a"
+    },
+    {
+      "path": "upstream/references/ai-video-tool-adapters.md",
+      "sha256": "4fec32bd0dbe95a87af84f6319c428af1f58f0e266e42f907e2dfc51edbe7334"
+    },
+    {
+      "path": "upstream/references/blocking-and-staging.md",
+      "sha256": "16203dd654d61459df6eabb7754d5b450a17774ad18484f27a1c05e73d392402"
+    },
+    {
+      "path": "upstream/references/cinematic-language.md",
+      "sha256": "2e899733fdefb12d316faeeaed1a5dc466dea55ef3818b28e7cec13d7a501933"
+    },
+    {
+      "path": "upstream/references/continuity-bible.md",
+      "sha256": "92aad85488aee0fcad6d432ce29f66286d66245bb2a17499a325afb356c74826"
+    },
+    {
+      "path": "upstream/references/director_styles/01_spielberg.md",
+      "sha256": "c1d8db44ae145e3a5bc1791967afb2d02a9f838ae5691dbbe47d006b754d7783"
+    },
+    {
+      "path": "upstream/references/director_styles/02_hitchcock.md",
+      "sha256": "fcd7952d7c1970ed9b477d1d8ac3c03b3c3c956d4fc057dfb2a061a8a180b4a8"
+    },
+    {
+      "path": "upstream/references/director_styles/03_kubrick.md",
+      "sha256": "fb63f95a6e0467cac92c7a876bf5d371d844ac60bee160280cbf94f895f32117"
+    },
+    {
+      "path": "upstream/references/director_styles/04_kurosawa.md",
+      "sha256": "492e644362f4942616f28ae51c330a82c0116094a20a0bcf7c54378009a8e2ac"
+    },
+    {
+      "path": "upstream/references/director_styles/05_scorsese.md",
+      "sha256": "cf1449787769cd918b6b8438a66a61979211005039ffba24c48ec4ab1969c942"
+    },
+    {
+      "path": "upstream/references/director_styles/06_fellini.md",
+      "sha256": "6f6fe403c2da97e8bda4c6c2429f5f9418e9f04da74d91f201df6b5b3fd74211"
+    },
+    {
+      "path": "upstream/references/director_styles/07_bergman.md",
+      "sha256": "e277116732258c3557eba5c040ade8b71646fa5c23b704355017f4688bb6fd00"
+    },
+    {
+      "path": "upstream/references/director_styles/08_tarkovsky.md",
+      "sha256": "fe7e26e409ae727a859f07374d8a5f910e6a8a737695b0a6605db8f24bd6d77d"
+    },
+    {
+      "path": "upstream/references/director_styles/09_wong_kar_wai.md",
+      "sha256": "c60e33b3d99cc1e52dc02d57e40f61fb008c5647ac2eab30a51c45544711c57b"
+    },
+    {
+      "path": "upstream/references/director_styles/10_nolan.md",
+      "sha256": "ef506940f2447567427c819725351f6bafc91e51c935c3bbdc6cacdf94f5a6dd"
+    },
+    {
+      "path": "upstream/references/director_styles/11_villeneuve.md",
+      "sha256": "8f825927d68091767cd901e293484bfe50646b778c1cac8a8f77cccca198ca9c"
+    },
+    {
+      "path": "upstream/references/director_styles/12_fincher.md",
+      "sha256": "4cf9cce055dd14088ba7cd01446b389ac62e327a7aea7dac2d345939526061b5"
+    },
+    {
+      "path": "upstream/references/director_styles/13_refn.md",
+      "sha256": "05dc74f79684cc9f1bb4ec760d69ba4498e1fcca904fa504f58acde96442de74"
+    },
+    {
+      "path": "upstream/references/director_styles/14_bi_gan.md",
+      "sha256": "47ca34530e8573fbe49818c0dcaf8553ce92be37279c03ae388e92e6faf6a82a"
+    },
+    {
+      "path": "upstream/references/director_styles/15_zhang_yimou.md",
+      "sha256": "9bc951babbf3e51f8c2f0e129216578378536d17fac42663596a8397b28505c3"
+    },
+    {
+      "path": "upstream/references/director_styles/16_hou_hsiao_hsien.md",
+      "sha256": "c336fab4d549603beaf47a01ec0dbdcb52be99837d774425e50ec0350691f8b1"
+    },
+    {
+      "path": "upstream/references/director_styles/17_park_chan_wook.md",
+      "sha256": "8ada598768c187ea8b057a1b5e1107045b567811487eee73f64199507c1efb7b"
+    },
+    {
+      "path": "upstream/references/director_styles/18_malick.md",
+      "sha256": "ee5c6786c58385772e99eb003430bd24eafea83db19023619d63e47954af1f95"
+    },
+    {
+      "path": "upstream/references/director_styles/19_michael_mann.md",
+      "sha256": "b34fd4c8b0ca4833818f4d3f6471777341c6b23481b6efc6f69b4cfb0554cf79"
+    },
+    {
+      "path": "upstream/references/director_styles/20_coen_brothers.md",
+      "sha256": "4809d2861e696a54df4b28f3abe442311dc722b0a67f2f6e99db19dd385d5a68"
+    },
+    {
+      "path": "upstream/references/director_styles/README.md",
+      "sha256": "fcd5fc6193e0b86765be168af4cb43ee30bd1cb805ceb5bcc27241dbcd2d1798"
+    },
+    {
+      "path": "upstream/references/director_styles/example_comparisons.md",
+      "sha256": "d13bd746f88418fdf259b25115b6cab4d259ba31ef6d57f251fdeeaddebc9504"
+    },
+    {
+      "path": "upstream/references/editing-and-assembly.md",
+      "sha256": "8256bb843e8d45ba66aba927edef30cd586a0a32030e4a4639d26be156e850de"
+    },
+    {
+      "path": "upstream/references/failure-modes.md",
+      "sha256": "9a374e78ac8257ed8c91d7c247ebc2f1d27a3484b0c1486fee7d77e554fb9be7"
+    },
+    {
+      "path": "upstream/references/genre-playbooks.md",
+      "sha256": "5713431b20dcd6c4804d086385106ecce9ef483210287dfdceacc351077d33e1"
+    },
+    {
+      "path": "upstream/references/image-model-adapters.md",
+      "sha256": "307f429a66ce7ae2c4f4e7d6893e59b8017549dd12d944c2a1aefd605b2f543a"
+    },
+    {
+      "path": "upstream/references/lighting-and-color.md",
+      "sha256": "fb34edea030bbb29b047ff7e489968dded8978f1a3acb768ede230a1c106792b"
+    },
+    {
+      "path": "upstream/references/product-and-macro.md",
+      "sha256": "c6b791fe96db082517c8e3d639269228cee3ae68d55ddababbb7b09d967ca350"
+    },
+    {
+      "path": "upstream/references/production-workflow.md",
+      "sha256": "3f5e431b23931ae636d6637c92b63bc084407a1b4a8b1625fb5e9c393bb97998"
+    },
+    {
+      "path": "upstream/references/prompt-lexicon.md",
+      "sha256": "8e2172f9255dbc9ce51b7f54af9cb570283808a6ad4aa34fcf439c56c513138f"
+    },
+    {
+      "path": "upstream/references/sound-and-dialogue.md",
+      "sha256": "fcc99cacf1bc35caf3dd5e9430a0f3c731b5b65868171cc488282559017d43de"
+    }
+  ]
+}

package/resources/skills/cinematic-director/upstream/CHANGELOG.md

@@ -0,0 +1,213 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [2.1.0] - 2026-08-27
+
+An audit release. A full adversarial audit of the package found the content layer sound and the
+delivery layer not: the entry point's frontmatter was not valid YAML, `SKILL.md` contradicted the
+files it named as owners in four places, an entire current capability class was missing, and the
+behaviour contract had never been executed. Everything below is the repair.
+
+### Fixed
+
+- **`SKILL.md` frontmatter was not parseable YAML.** An unquoted scalar containing `": "` made
+  `yaml.safe_load` fail, so any strict parser dropped the skill or read an empty description. It is
+  now a folded (`>-`) block. The `description` was also 1327 characters against the 1024-character
+  spec cap — a regression introduced in 2.0.0 — and is now 1022. CI checks both from now on.
+- **Four contradictions between `SKILL.md` and its own owner files.** The intake block emitted
+  `must_avoid: modern objects`, the exact category hard rule 9 calls unresolvable; the S4 skeleton
+  emitted an `[emotion]` slot against hard rule 5; the self-check stated the two-size-step cut rule
+  unconditionally where four other files state it conditionally; and Mode J chaining contradicted
+  the response-size ceiling thirteen lines below it.
+- **The lighting invariant was specified in two opposite coordinate systems.** The director's book
+  template required world space; `lighting-and-color.md` shipped a camera-space template slot and a
+  camera-space worked example that, pasted into a reverse, flips the key. One system now, world
+  space, with the camera-relative wording derived per shot-plan row.
+- **The shot-size ladder had two definitions.** `prompt-lexicon.md` carried an eight-step table that
+  the two-size-step rule cannot be counted on. `cinematic-language.md` now declares ownership of the
+  six rungs and everything else cites it.
+- **F2 had no QC gate row.** The package's own flagship symptom — the slideshow — was the one code
+  of nineteen that Gate 2 could not score, so a static clip was miscoded F4/F5 and repaired down the
+  wrong branch.
+- **The flagship identity string violated the recipe it demonstrates.** `ID_COURIER` carried zero
+  face-structure facts and no hair spec, so an agent imitating it produced strings with no face
+  geometry — the definition of F1. Rewritten to the recipe, synchronised byte-identically across all
+  six copies, and `continuity-bible.md` is now loaded at the step where the string is written.
+- **An absolute dBFS figure that was about 20 dB hot** in `sound-and-dialogue.md`, in a file whose
+  own convention is dB relative to dialogue.
+- **Two craft errors**: the occlusion geometry on the orbit arc in `blocking-and-staging.md`, and a
+  proportional-trim rule in `editing-and-assembly.md` that disagreed with its own fixed-frame rule
+  for exactly the slow gestures this package recommends most.
+- Stale doc claims: the reference count, the next free F-code, the "stays lean" comparison row, and
+  the `LICENSE` file, which appended a non-MIT restriction while the frontmatter declared MIT.
+
+### Added
+
+- **Video-to-video as the fifth control surface.** Restyle, relight, regrade, reframe and
+  performance transfer over existing footage were absent from the capability matrices, the prompt
+  shapes and the repair ladder, though the description advertised working from existing video. It is
+  now a matrix row in both adapter files and rung **L4.5** on the cost ladder — one generation, keeps
+  the take — resolving F12, F16, F17 and framing-only F9, which previously jumped to rebuilding the
+  keyframe.
+- **Cross-cutting and time compression.** The cut-motivation taxonomy had no entry for juxtaposing
+  two lines of action, and nothing said why a run of shots reads as time passing rather than as a
+  list. Both are now sections in `editing-and-assembly.md`, with a `Thread` column in the beat sheet
+  so parallel action can be planned upstream.
+- **Two-hander lighting** in `lighting-and-color.md`, which was written end to end for a single
+  subject while two-hander dialogue is the package's default drama coverage.
+- **Sound perspective**: a level/filter/reverb table across the four space cases, and a `Space`
+  column in the sound plan, so a bed no longer sits at one perspective from wide to close-up.
+- **The axis of action for three or more people**, which was defined only for pairs.
+- **Per-family blocks in `image-model-adapters.md`**, which had none while the video side had twelve.
+- **`evals/run.md`** — grader prompt, pass criteria, ship bar — and a CI job that validates
+  `evals.json` and the `SKILL.md` frontmatter. The suite had never been executed; it now has a
+  procedure and a build that fails when it drifts.
+- **Capability snapshot dates** in both adapter files. Nine "as of writing" hedges carried no date
+  anywhere, so nothing said what was due for recheck.
+- **Routing that was missing**: a staging/blocking row, `example_comparisons.md` (the package's one
+  orphan file), `production-workflow.md` on the shot-list row, `continuity-bible.md` at Step 5, and
+  `qc-checklist.md` on the keyframe row it gates.
+- **A defined fallback for unnamed directors.** Naming a director with no module was undefined
+  behaviour; the skill now says so, names the nearest module and the axis it differs on, and builds
+  an ad-hoc lens rather than substituting silently.
+- **Style-lens application at Steps 7, 8 and 10.** The lens was declared at Step 4 and then never
+  mentioned again at the steps it is supposed to override — including Step 8, which Step 4 calls the
+  one that matters most.
+- **Scoped reads.** The partial-read instruction that existed only for `failure-modes.md` now covers
+  the other three large index-plus-sections references.
+- **27 eval cases (30 → 57).** All 20 director lenses now covered (12 had none), prompt shapes S3 and
+  S4 forced, over-production tested, the no-artifact repair path tested against the guardrail it was
+  previously written to violate, and every output mode above one case.
+
+## [2.0.0] - 2026-07-27
+
+A depth release. v1.x knew the vocabulary of directing; v2 knows the craft behind it — lens choice, lighting ratios, continuity geometry, staging, sound, editing, and the operational reality of running a generation queue. The pipeline grew from 10 steps to 13, output modes from 6 to 10, references from 4 to 13, director lenses from 14 to 20, and `SKILL.md` gained an explicit routing table so depth loads on demand instead of all at once.
+
+### Added
+
+- `references/blocking-and-staging.md` — staging geometry library with plan-view diagrams, proxemics, power blocking, entrances and exits, eyeline geometry, a compact blocking notation the skill can emit in shot lists, and an honest reliability grading of what AI video models can and cannot render.
+- `references/lighting-and-color.md` — key/fill/back setups, lighting ratios with emotional reads, key direction, hard/soft quality and falloff, a practicals catalogue by era, a time-of-day table, contrast schemes, palette systems, color scripting, source-based color naming for prompts, grading language, and lighting continuity across generated shots.
+- `references/sound-and-dialogue.md` — the five-layer sound brief, diegetic boundaries, sound-led pacing, silence engineering, dialogue that actually generates (one speaker per clip, syllable-to-duration guidance, shot-reverse workarounds), voice-over, and a BPM-to-cut-length music brief.
+- `references/editing-and-assembly.md` — pacing math from target duration to shot count, cut motivation taxonomy, transition engineering for separately generated clips (match cuts built from paired last/first frames, dissolves as honest repairs, cutaways as continuity patches), trim handles, rhythm patterns, and anti-slideshow rules at the edit stage.
+- `references/genre-playbooks.md` — per-genre directorial defaults across 19 genres with a fixed field set, a cross-genre comparison table, and a tone-dial section showing how to move a scene between registers by changing three variables.
+- `references/prompt-lexicon.md` — verb banks by body system and environment, a replacement table converting intention words into observable behavior, disambiguated camera vocabulary, material and texture language, prompt slot ordering per prompt shape, a negative-prompt library organized by failure class, token economy rules, and an EN↔中文 craft-term table.
+- `references/failure-modes.md` — a coded diagnosis manual (F1–F18) with symptom, ranked root causes, cost-ordered fixes and before/after prompt pairs for each; a 60-second triage tree; the cost ladder; the three-strike rule; a root-cause interview; and an honest list of irreducible model failures with directorial workarounds.
+- `references/image-model-adapters.md` — keyframe generation as the real control point: control-surface matrix for image models, nine-slot keyframe anatomy, the character consistency playbook (identity strings, character sheets, reference binding, seed locking, inpaint repair), the location plate technique, reliable first/last-frame pair construction, and a pre-video QC gate.
+- `references/production-workflow.md` — the operating loop, the keyframe approval gate, a shot difficulty rubric with retry budgeting, sequencing strategy, versioning and review formats, the handoff package, and where the time actually goes.
+- `references/product-and-macro.md` — product, packshot, cosmetics, food, and macro work: the light-moves-not-the-camera principle, lighting by material class (specular, transparent, matte), macro depth-of-field reality, brand hue and logo fidelity as a discrete constraint on a continuous generator, the shot grammar of a spot, the 6s and 15s vertical structures, and an honest shoot-instead-of-generate decision table.
+- `assets/beat-sheet-template.md` (Mode B), `assets/director-book-template.md` (Mode C), `assets/sound-plan-template.md` (Mode H), `assets/edit-timeline-template.md` (Mode I) — each with a filled worked example.
+- Six director-style overlays, filling real gaps in the library (now 20 total):
+  - `15_zhang_yimou.md` — saturated single-color fields, mass choreography as image, folk-ritual iconography.
+  - `16_hou_hsiao_hsien.md` — static distant long take, doorway depth, real-time duration, ellipsis over exposition.
+  - `17_park_chan_wook.md` — baroque revenge, improbable camera geometry, ironic beauty over cruelty.
+  - `18_malick.md` — available light, wide wandering handheld at magic hour, whispered voice-over, associative montage.
+  - `19_michael_mann.md` — urban night as a cold luminous field, professional competence, loneliness as architecture.
+  - `20_coen_brothers.md` — deadpan geometric dark comedy, closing the comedy gap none of the first 14 covered.
+- Three new pipeline steps: 1 Intake and scope, 11 Sound and dialogue plan, 12 Edit and assembly plan.
+- Four new output modes: B Beat Sheet, C Director's Book, H Sound & Dialogue Plan, I Edit & Assembly Plan.
+- A routing table in `SKILL.md` mapping request type to output mode to the exact files to load, so `SKILL.md` stays lean and depth is pulled in on demand.
+- A hard-rules block and a self-check block in `SKILL.md`.
+- Prompt shapes S1–S4 (motion-only, full-description, keyframe-pair, multi-shot timestamped) and a capability-first routing model, so unfamiliar tools are handled by control surface rather than by guesswork.
+- The motion-budget model: subject motion plus camera motion plus environmental motion plus duration is a finite budget, and exceeding it is what produces warping.
+- A `Response size` table and a proportionality hard rule in `SKILL.md`, plus an explicit instruction never to print the intake schema back at the user — over-production was the most common failure in dry runs.
+- Non-narrative handling: Steps 2 and 3 now state that commercial, product, corporate, fashion, music-video, and trailer briefs replace the dramatic-core block with the genre playbook's engine and audience contract, and replace pressure-delta beats with the format's structural blocks.
+- A single-owner map in `CONTRIBUTING.md` for the eight concepts two files could each plausibly claim, plus reserved id prefixes (`S` prompt shapes, `F` failure codes, `P`/`G`/`Q` QC gates, `SH` shot ids, `L` cost-ladder rungs) so an id in a note is never ambiguous.
+
+### Fixed
+
+Findings from an adversarial verification pass and three live dry runs of the finished skill:
+
+- **F19 — object permanence break.** A prop that *disappears* had no code anywhere; the taxonomy only covered entities appearing. The triage tree also returned exactly one code and hid every additional failure in a clip that had several — it now collects every code before proposing anything, and there is a multi-failure repair format with a shared-root line.
+- **Negative prompts named a category the skill's own manual identifies as unresolvable.** `NEG_BASE` shipped "no modern objects" — the documented mechanism behind F8 — in every template and worked example. Negatives now name instances everywhere.
+- **Two files defined the identity string with incompatible word budgets**, and the file Step 8 routes to taught a length the owning file declares non-reproducible. `references/continuity-bible.md` is now the sole owner.
+- **The 30° rule was restated wrongly** in the adapters file ("one size step *or* 30°" instead of "30°, or two size steps on the same axis").
+- **Lighting ratios were quoted in two conventions**, key-to-fill in one file and lit-side-to-shadow-side in another, which is a factor-of-difference error on the same shot.
+- **Clip durations, generation handles, retry budgets, and sound levels each disagreed across two or three files.** Each now has one owner and the rest quote it.
+- **A one-symptom repair loaded 670 lines** to answer a one-line question, and Mode J was modelled as terminal when in practice it chains to F, I, and G.
+- **The root-cause interview contradicted the entry point** — `SKILL.md` forbids interrogating the user while `references/failure-modes.md` prescribed a six-question questionnaire. It is now a list of what to infer, in descending order of yield.
+- Craft errors caught in review: an inverted lookroom rule, a geometrically wrong 180° diagram whose crossing camera sat on the legal side, backwards eyeline logic in shot-reverse-shot, a depth-of-field claim with no hyperfocal caveat, and wrong sensor crop factors.
+- Unhedged vendor claims — exact durations, parameter names, and capability assertions stated as fact — rewritten as capability classes with a staleness warning.
+
+### Changed
+
+- **Breaking:** pipeline renumbered from 10 steps to 13, and output modes renumbered from A–F to A–J. Anything referencing the old numbers needs updating.
+- **Breaking:** tool adapter selection now precedes prompt construction (Step 9 before Step 10). In v1 the pipeline wrote prompts at Step 8 and only then consulted the adapter at Step 9, which was backwards.
+- `SKILL.md` — rewritten around routing and progressive disclosure; frontmatter description broadened to cover sound, editing, genre, image models, and the six new lenses; intake schema gained genre, more tools, and more aspect ratios.
+- `references/cinematic-language.md` — substantially expanded: lens and focal-length psychology, focus as direction, camera height, continuity geometry (axis of action, the 30° rule, screen direction, eyeline match) with AI-specific encoding notes, coverage patterns, aspect ratio and format including a dedicated vertical 9:16 section, and motion rendition.
+- `references/ai-video-tool-adapters.md` — restructured around a control-surface matrix and four prompt shapes; adapters added for Sora-class, Hailuo/MiniMax, Pika, Vidu, Midjourney Video, and open-source/ComfyUI-class models; all model-specific claims hedged as capability classes.
+- `references/continuity-bible.md` — schemas expanded (identity strings, wardrobe state, injury and dirt progression, light direction, screen direction, seeds, reference asset IDs), plus prop and wardrobe schemas, an asset naming grammar, a seed registry, a state-change ledger, and a fully filled six-shot worked example.
+- `assets/shot-plan-template.md` — added a field dictionary with good/bad examples per column, lens and light-direction columns, a risk column, a compact variant, and a filled example.
+- `assets/keyframe-prompt-template.md` and `assets/video-prompt-template.md` — slot dictionaries, more templates (character sheet, location plate, continuation, dialogue shot), filled examples, and per-prompt self-checks.
+- `assets/qc-checklist.md` — restructured into three gates (pre-generation, post-generation, sequence), converted to a scored rubric with a pass threshold and a blocker list, and cross-referenced to failure codes F1–F18.
+- All 14 existing director-style modules retrofitted to the v2 structure: a bilingual one-line lens, a `反例 / What this lens is NOT` section naming the adjacent styles each gets confused with and the mechanical difference, a machine-readable `风格参数` YAML override block, three prompt templates, and a worked example. Every module now directs the same control scene so the twenty can be read side by side.
+- `evals/evals.json` — expanded from 7 cases to a broader suite covering intake with minimal information, motion-budget overload, vertical framing, dialogue two-handers, sound and edit modes, continuity, era risk, commercial and comedy registers, genre-versus-style precedence, unknown tools, shot re-planning, style mixing, and the new lenses. Cases now carry `mode` and `loads` fields.
+- `CONTRIBUTING.md` — rewritten for the v2 layout, the step and mode contracts, the new style module structure, and the no-invented-tool-facts rule.
+- `README.md` — architecture diagram, feature list, style tables, adapter tables, and repo structure updated for v2 in both EN and 中文.
+
+## [1.2.0] - 2026-05-25
+
+### Added
+
+- `CONTRIBUTING.md` — bilingual guide covering how to add a director style, AI video tool adapter, output mode, or eval case; project layout; style conventions; PR checklist; copyright-safety rule.
+- `CHANGELOG.md` — this file.
+- `references/director_styles/example_comparisons.md` — same scene treated by four different directors (Spielberg, Kubrick, Wong Kar-wai, Bi Gan), demonstrating how a style overlay actually changes blocking, camera grammar, color, sound, and prompt template.
+
+### Changed
+
+- `references/director_styles/README.md` — links to `example_comparisons.md`.
+- Top-level `README.md` — references CONTRIBUTING and CHANGELOG; minor wording polish.
+
+## [1.1.0] - 2026-05-25
+
+### Added
+
+- Four contemporary director-style overlays (now 14 total):
+  - `11_villeneuve.md` — monumental scale, mist, geometric symmetry, low-rumble silence.
+  - `12_fincher.md` — surgical control, teal-amber palette, procedural investigation, restrained dread.
+  - `13_refn.md` — neon color blocks, symmetric ritual framing, slow gaze, sudden violence.
+  - `14_bi_gan.md` — misty SW-China small towns, single ultra-long take, dream-memory loops, poetic voice-over.
+- GitHub Actions workflows:
+  - `.github/workflows/markdownlint.yml` (DavidAnson/markdownlint-cli2-action)
+  - `.github/workflows/links.yml` (lycheeverse/lychee-action, `--offline` mode)
+- `.markdownlint.json` calibrated for compact prose-heavy bilingual markdown.
+- Four style-overlay eval cases (now 7 total):
+  - `kubrick-style-corporate-office`
+  - `wong-kar-wai-style-rain-street` (overlay variant of `rain-street-image-to-video`)
+  - `villeneuve-style-desert-encounter`
+  - `bi-gan-style-small-town-walk`
+- CI status badges in README (markdownlint, links).
+
+### Changed
+
+- `SKILL.md` frontmatter `description:`, YAML `director_style:` enum, Step 3 "Available styles:" line, and "When to activate" bullet now include the four new directors.
+- `SKILL.md` `version` bumped to `1.1.0`.
+- `references/director_styles/README.md` table extended to 14 rows.
+- Top-level `README.md` EN and 中文 director tables extended; repo-structure tree extended.
+- `.markdownlint.json` disables MD022, MD031, MD032 — the director-style files use compact prose-under-heading by design, and the rules don't add real value for this content.
+- The three ASCII-diagram fences in `README.md` are tagged `text` so MD040 stays useful.
+
+## [1.0.0] - 2026-05-25
+
+### Added
+
+- Initial release of the `cinematic-director` skill.
+- `SKILL.md` — 10-step directorial pipeline: script breakdown → beat map → director style selection → director's book → blocking → shot list → keyframe strategy → AI video prompt construction → tool adapter selection → QC & repair.
+- 6 output modes: Director Analysis, Shot Plan, Keyframe Prompt Pack, Video Motion Prompt Pack, Continuity Bible, QC & Repair.
+- 10 director-style overlays in `references/director_styles/`: Spielberg, Hitchcock, Kubrick, Kurosawa, Scorsese, Fellini, Bergman, Tarkovsky, Wong Kar-wai, Nolan.
+- 6 AI video tool adapters in `references/ai-video-tool-adapters.md`: Runway, Veo, Kling, Luma, 即梦/Dreamina/Seedance, Wanxiang.
+- Shared references: `cinematic-language.md`, `continuity-bible.md`.
+- Reusable templates in `assets/`: `shot-plan-template.md`, `keyframe-prompt-template.md`, `video-prompt-template.md`, `qc-checklist.md`.
+- `evals/evals.json` with 3 baseline cases.
+- Bilingual README (EN + 中文), MIT license.
+
+[Unreleased]: https://github.com/wuwangzhang1216/DirectorSKILL/compare/v2.1.0...HEAD
+[2.1.0]: https://github.com/wuwangzhang1216/DirectorSKILL/compare/v2.0.0...v2.1.0
+[2.0.0]: https://github.com/wuwangzhang1216/DirectorSKILL/compare/v1.2.0...v2.0.0
+[1.2.0]: https://github.com/wuwangzhang1216/DirectorSKILL/compare/v1.1.0...v1.2.0
+[1.1.0]: https://github.com/wuwangzhang1216/DirectorSKILL/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/wuwangzhang1216/DirectorSKILL/releases/tag/v1.0.0