@event4u/agent-config 5.4.0 → 5.5.0

package/dist/discovery/discovery-manifest.json

@@ -1586,7 +1586,7 @@
     },
     {
       "category": "command",
-      "checksum": "sha256:c2b679ded04056a7199cd36996024fe315064df9ec23ca7d69fc39deca19e4a9",
+      "checksum": "sha256:ff47e49e1555b8fbd297fc8d8aa4e92837f1355fc96993da885115beae9ad8f8",
       "install": {
         "default": true,
         "removable": false
@@ -1606,6 +1606,28 @@
         "agent-config-maintainer"
       ]
     },
+    {
+      "category": "command",
+      "checksum": "sha256:48dbe18aa96ff7cd22c71e35bbc3b11fe474a0f524f4ee39a1485aeee7198e1f",
+      "install": {
+        "default": true,
+        "removable": false
+      },
+      "lifecycle": "active",
+      "name": "knowledge:cross-repo",
+      "packs": [
+        "meta"
+      ],
+      "path": "packages/core/.agent-src.uncondensed/commands/knowledge/cross-repo.md",
+      "trust": {
+        "confidence": "high",
+        "human_review_required": false,
+        "level": "core"
+      },
+      "workspaces": [
+        "agent-config-maintainer"
+      ]
+    },
     {
       "category": "command",
       "checksum": "sha256:245b6e0e15cccc2eff64876b41461ac2f7cdf671e165b8d05ca9a36e7fa9e198",
@@ -2640,6 +2662,94 @@
         "agent-config-maintainer"
       ]
     },
+    {
+      "category": "command",
+      "checksum": "sha256:636b5c749457be6aaf06addee61d7d67ac6079d4b444f6d3eccf7332b1b0c6a2",
+      "install": {
+        "default": true,
+        "removable": false
+      },
+      "lifecycle": "active",
+      "name": "skill",
+      "packs": [
+        "meta"
+      ],
+      "path": "packages/core/.agent-src.uncondensed/commands/skill.md",
+      "trust": {
+        "confidence": "high",
+        "human_review_required": false,
+        "level": "core"
+      },
+      "workspaces": [
+        "agent-config-maintainer"
+      ]
+    },
+    {
+      "category": "command",
+      "checksum": "sha256:40626ab81f60dcade69e5073cb1d95adacf8bad790ca6741512c6f4ea8425019",
+      "install": {
+        "default": true,
+        "removable": false
+      },
+      "lifecycle": "active",
+      "name": "skill:preview",
+      "packs": [
+        "meta"
+      ],
+      "path": "packages/core/.agent-src.uncondensed/commands/skill/preview.md",
+      "trust": {
+        "confidence": "high",
+        "human_review_required": false,
+        "level": "core"
+      },
+      "workspaces": [
+        "agent-config-maintainer"
+      ]
+    },
+    {
+      "category": "command",
+      "checksum": "sha256:6d594b6410e3fe19b70ece3092256fa3b7ee8178617a931d1acf3a4ca1dc51c4",
+      "install": {
+        "default": true,
+        "removable": false
+      },
+      "lifecycle": "active",
+      "name": "skills",
+      "packs": [
+        "meta"
+      ],
+      "path": "packages/core/.agent-src.uncondensed/commands/skills.md",
+      "trust": {
+        "confidence": "high",
+        "human_review_required": false,
+        "level": "core"
+      },
+      "workspaces": [
+        "agent-config-maintainer"
+      ]
+    },
+    {
+      "category": "command",
+      "checksum": "sha256:69076a5661075eee015fb52d22203fe21863c515bb5c7f4f21808b2581ef379c",
+      "install": {
+        "default": true,
+        "removable": false
+      },
+      "lifecycle": "active",
+      "name": "skills:discover",
+      "packs": [
+        "meta"
+      ],
+      "path": "packages/core/.agent-src.uncondensed/commands/skills/discover.md",
+      "trust": {
+        "confidence": "high",
+        "human_review_required": false,
+        "level": "core"
+      },
+      "workspaces": [
+        "agent-config-maintainer"
+      ]
+    },
     {
       "category": "command",
       "checksum": "sha256:4eb4c108c880a41706f61afe66f5682a772dccb4f41310b306fc41bd298c3c73",
@@ -2840,7 +2950,7 @@
     },
     {
       "category": "command",
-      "checksum": "sha256:1a261b560ee5960ac92cd00a66ab1b22c9efd691e957f70bbd82a8f8e255a641",
+      "checksum": "sha256:c4aed68f1fcdebd26ab8022d42932b4394501babd4451b2d01d62ff07a045067",
       "install": {
         "default": true,
         "removable": false
@@ -2882,6 +2992,28 @@
         "agent-config-maintainer"
       ]
     },
+    {
+      "category": "command",
+      "checksum": "sha256:dac28649cc18c4d61a10be2a3cefaa839403727c7cffca83ada228e970baf562",
+      "install": {
+        "default": false,
+        "removable": true
+      },
+      "lifecycle": "experimental",
+      "name": "video:from-song",
+      "packs": [
+        "meta"
+      ],
+      "path": "packages/core/.agent-src.uncondensed/commands/video/from-song.md",
+      "trust": {
+        "confidence": "high",
+        "human_review_required": false,
+        "level": "experimental"
+      },
+      "workspaces": [
+        "agent-config-maintainer"
+      ]
+    },
     {
       "category": "command",
       "checksum": "sha256:4487ac71beea3200af2e922fc2368f11e2cb77ed39084484417d71ffa72dfd45",
@@ -3644,7 +3776,7 @@
     },
     {
       "category": "rule",
-      "checksum": "sha256:a118756c8f27c6ac6208f7daa7a8f268327a3a7a182321e72b307ef9895b1602",
+      "checksum": "sha256:6d96f7999e37d12fd1458d8e3a1d9fbf98e2713df5033fff99fb044fb17fceb8",
       "install": {
         "default": true,
         "removable": true
@@ -7454,6 +7586,28 @@
         "small-business"
       ]
     },
+    {
+      "category": "skill",
+      "checksum": "sha256:50b3da1d289905ec799969e527748e15fc65a3cdc8bb647abf6dd64c8114bc85",
+      "install": {
+        "default": false,
+        "removable": true
+      },
+      "lifecycle": "experimental",
+      "name": "song-to-script",
+      "packs": [
+        "ai-video"
+      ],
+      "path": "packages/pack-ai-video/.agent-src.uncondensed/skills/song-to-script/SKILL.md",
+      "trust": {
+        "confidence": "high",
+        "human_review_required": false,
+        "level": "experimental"
+      },
+      "workspaces": [
+        "small-business"
+      ]
+    },
     {
       "category": "skill",
       "checksum": "sha256:7a746efd8d2eeef3f543317a1990c556a3ef2da74709a7a4aa8c1154458a1124",
@@ -9452,7 +9606,7 @@
       ]
     }
   ],
-  "checksum": "sha256:9fefaad4a6276325abcfc38b4b92e823973bba39efa92db3e0f6e262a1395cdb",
+  "checksum": "sha256:179774d9f11641c6a2709286fb24d3ff708743bf6e58c697f8987c9fbcab31ae",
   "documented_unassigned": [
     {
       "category": "template",
@@ -9565,7 +9719,7 @@
       "reason": "scaffold for new SKILL.md authoring"
     }
   ],
-  "generated_at": "2026-05-30T13:53:39Z",
+  "generated_at": "2026-05-30T23:34:47Z",
   "packs": [
     {
       "artefact_count": 85,
@@ -9952,7 +10106,7 @@
       ]
     },
     {
-      "artefact_count": 6,
+      "artefact_count": 7,
       "description": "AI video pipeline.",
       "human_review_required": 0,
       "id": "ai-video",
@@ -9961,7 +10115,7 @@
       "trust_summary": {
         "advisory": 0,
         "core": 0,
-        "experimental": 6,
+        "experimental": 7,
         "professional": 0,
         "restricted": 0
       },
@@ -9970,7 +10124,7 @@
       ]
     },
     {
-      "artefact_count": 252,
+      "artefact_count": 258,
       "description": "Artefacts that maintain this package (agent-config itself).",
       "human_review_required": 0,
       "id": "meta",
@@ -9978,8 +10132,8 @@
       "trust_level_default": "core",
       "trust_summary": {
         "advisory": 0,
-        "core": 252,
-        "experimental": 0,
+        "core": 257,
+        "experimental": 1,
         "professional": 0,
         "restricted": 0
       },
@@ -9991,26 +10145,26 @@
   "scanner_version": "ca7acd2ec7af",
   "stats": {
     "by_category": {
-      "command": 135,
+      "command": 141,
       "rule": 78,
-      "skill": 219,
+      "skill": 220,
       "template": 1
     },
     "by_lifecycle": {
-      "active": 424,
+      "active": 429,
       "archived": 0,
       "deprecated": 0,
-      "experimental": 9
+      "experimental": 11
     },
     "by_trust_level": {
       "advisory": 2,
-      "core": 345,
-      "experimental": 7,
+      "core": 350,
+      "experimental": 9,
       "professional": 79,
       "restricted": 0
     },
     "documented_unassigned_count": 22,
-    "total_artefacts": 433,
+    "total_artefacts": 440,
     "unassigned_count": 0
   },
   "unassigned": [],

package/dist/discovery/discovery-manifest.json.sha256

@@ -1 +1 @@
-da906c7eabe30a645a5ed6a6731b1542968b0204b94f359fdf8be14870950349  discovery-manifest.json
+4899ff3ab9b0d366795f7cda664646b990f52a17c5a050837052d1fcd86e372a  discovery-manifest.json

package/dist/discovery/discovery-manifest.summary.md

@@ -1,8 +1,8 @@
 # Discovery Manifest — Summary
 
-- Generated: `2026-05-30T13:53:39Z`
+- Generated: `2026-05-30T23:34:47Z`
 - Scanner: `ca7acd2ec7af`
-- Artefacts: **433**
+- Artefacts: **440**
 - Unassigned: **0**
 
 ## `engineering` — Engineering
@@ -73,7 +73,7 @@
 | Pack | Artefacts |
 |---|---|
 | `small-business` — Small Business | 0 |
-| `ai-video` — AI Video | 6 |
+| `ai-video` — AI Video | 7 |
 
 ## `construction` — Construction
 
@@ -89,5 +89,5 @@
 
 | Pack | Artefacts |
 |---|---|
-| `meta` — Meta | 252 |
+| `meta` — Meta | 258 |
 

package/dist/discovery/orphan-report.md

@@ -1,6 +1,6 @@
 # Discovery — Orphan Report
 
-- Generated: `2026-05-30T13:53:39Z`
+- Generated: `2026-05-30T23:34:47Z`
 - Orphan artefacts: **0**
 
 > An orphan is an artefact whose declared pack has no other members.

package/dist/discovery/packs.json

@@ -1,6 +1,6 @@
 {
-  "checksum": "sha256:9fefaad4a6276325abcfc38b4b92e823973bba39efa92db3e0f6e262a1395cdb",
-  "generated_at": "2026-05-30T13:53:39Z",
+  "checksum": "sha256:179774d9f11641c6a2709286fb24d3ff708743bf6e58c697f8987c9fbcab31ae",
+  "generated_at": "2026-05-30T23:34:47Z",
   "packs": [
     {
       "artefact_count": 85,
@@ -717,25 +717,26 @@
       ]
     },
     {
-      "artefact_count": 6,
+      "artefact_count": 7,
       "artefacts": [
         "packages/pack-ai-video/.agent-src.uncondensed/skills/canvas-design/SKILL.md",
         "packages/pack-ai-video/.agent-src.uncondensed/skills/character-consistency/SKILL.md",
         "packages/pack-ai-video/.agent-src.uncondensed/skills/motion-choreographer/SKILL.md",
         "packages/pack-ai-video/.agent-src.uncondensed/skills/pixar-storyteller/SKILL.md",
         "packages/pack-ai-video/.agent-src.uncondensed/skills/scene-expander/SKILL.md",
+        "packages/pack-ai-video/.agent-src.uncondensed/skills/song-to-script/SKILL.md",
         "packages/pack-ai-video/.agent-src.uncondensed/skills/video-director/SKILL.md"
       ],
       "by_lifecycle": {
         "active": 0,
         "archived": 0,
         "deprecated": 0,
-        "experimental": 6
+        "experimental": 7
       },
       "by_trust_level": {
         "advisory": 0,
         "core": 0,
-        "experimental": 6,
+        "experimental": 7,
         "professional": 0,
         "restricted": 0
       },
@@ -750,7 +751,7 @@
       ]
     },
     {
-      "artefact_count": 252,
+      "artefact_count": 258,
       "artefacts": [
         "packages/core/.agent-src.uncondensed/commands/agent-handoff.md",
         "packages/core/.agent-src.uncondensed/commands/agent-status.md",
@@ -825,6 +826,7 @@
         "packages/core/.agent-src.uncondensed/commands/judge/solo.md",
         "packages/core/.agent-src.uncondensed/commands/judge/steps.md",
         "packages/core/.agent-src.uncondensed/commands/knowledge.md",
+        "packages/core/.agent-src.uncondensed/commands/knowledge/cross-repo.md",
         "packages/core/.agent-src.uncondensed/commands/knowledge/forget.md",
         "packages/core/.agent-src.uncondensed/commands/knowledge/ingest.md",
         "packages/core/.agent-src.uncondensed/commands/knowledge/list.md",
@@ -872,6 +874,10 @@
         "packages/core/.agent-src.uncondensed/commands/roadmap/process-step.md",
         "packages/core/.agent-src.uncondensed/commands/rule-compliance-audit.md",
         "packages/core/.agent-src.uncondensed/commands/set-cost-profile.md",
+        "packages/core/.agent-src.uncondensed/commands/skill.md",
+        "packages/core/.agent-src.uncondensed/commands/skill/preview.md",
+        "packages/core/.agent-src.uncondensed/commands/skills.md",
+        "packages/core/.agent-src.uncondensed/commands/skills/discover.md",
         "packages/core/.agent-src.uncondensed/commands/sync-agent-settings.md",
         "packages/core/.agent-src.uncondensed/commands/sync-gitignore.md",
         "packages/core/.agent-src.uncondensed/commands/sync-gitignore/fix.md",
@@ -883,6 +889,7 @@
         "packages/core/.agent-src.uncondensed/commands/upstream-contribute.md",
         "packages/core/.agent-src.uncondensed/commands/video.md",
         "packages/core/.agent-src.uncondensed/commands/video/from-script.md",
+        "packages/core/.agent-src.uncondensed/commands/video/from-song.md",
         "packages/core/.agent-src.uncondensed/commands/video/scene.md",
         "packages/core/.agent-src.uncondensed/commands/video/stitch.md",
         "packages/core/.agent-src.uncondensed/commands/video/storyboard.md",
@@ -1006,15 +1013,15 @@
         "packages/core/.agent-src.uncondensed/templates/agents/proposal.example.md"
       ],
       "by_lifecycle": {
-        "active": 252,
+        "active": 257,
         "archived": 0,
         "deprecated": 0,
-        "experimental": 0
+        "experimental": 1
       },
       "by_trust_level": {
         "advisory": 0,
-        "core": 252,
-        "experimental": 0,
+        "core": 257,
+        "experimental": 1,
         "professional": 0,
         "restricted": 0
       },

package/dist/discovery/trust-report.md

@@ -1,6 +1,6 @@
 # Discovery — Trust Report
 
-- Generated: `2026-05-30T13:53:39Z`
+- Generated: `2026-05-30T23:34:47Z`
 - Workspaces tracked: **8**
 - Human-review-required artefacts: **2**
 
@@ -8,14 +8,14 @@
 
 | Workspace | core | professional | experimental | advisory | restricted |
 |---|---|---|---|---|---|
-| `agent-config-maintainer` | 252 | 0 | 1 | 0 | 0 |
+| `agent-config-maintainer` | 257 | 0 | 2 | 0 | 0 |
 | `engineering` | 86 | 41 | 1 | 0 | 0 |
 | `finance` | 2 | 3 | 0 | 1 | 0 |
 | `founder` | 7 | 0 | 0 | 1 | 0 |
 | `gtm` | 0 | 12 | 0 | 0 | 0 |
 | `ops` | 0 | 8 | 0 | 0 | 0 |
 | `product` | 0 | 15 | 0 | 0 | 0 |
-| `small-business` | 0 | 0 | 6 | 0 | 0 |
+| `small-business` | 0 | 0 | 7 | 0 | 0 |
 
 ## Human-review-required artefacts
 

package/dist/discovery/workspaces.json

@@ -1,6 +1,6 @@
 {
-  "checksum": "sha256:9fefaad4a6276325abcfc38b4b92e823973bba39efa92db3e0f6e262a1395cdb",
-  "generated_at": "2026-05-30T13:53:39Z",
+  "checksum": "sha256:179774d9f11641c6a2709286fb24d3ff708743bf6e58c697f8987c9fbcab31ae",
+  "generated_at": "2026-05-30T23:34:47Z",
   "scanner_version": "ca7acd2ec7af",
   "workspaces": [
     {
@@ -394,7 +394,7 @@
       ]
     },
     {
-      "artefact_count": 6,
+      "artefact_count": 7,
       "default_packs": [
         "small-business"
       ],
@@ -411,13 +411,14 @@
           "id": "small-business"
         },
         {
-          "artefact_count": 6,
+          "artefact_count": 7,
           "artefacts": [
             "packages/pack-ai-video/.agent-src.uncondensed/skills/canvas-design/SKILL.md",
             "packages/pack-ai-video/.agent-src.uncondensed/skills/character-consistency/SKILL.md",
             "packages/pack-ai-video/.agent-src.uncondensed/skills/motion-choreographer/SKILL.md",
             "packages/pack-ai-video/.agent-src.uncondensed/skills/pixar-storyteller/SKILL.md",
             "packages/pack-ai-video/.agent-src.uncondensed/skills/scene-expander/SKILL.md",
+            "packages/pack-ai-video/.agent-src.uncondensed/skills/song-to-script/SKILL.md",
             "packages/pack-ai-video/.agent-src.uncondensed/skills/video-director/SKILL.md"
           ],
           "id": "ai-video"
@@ -442,7 +443,7 @@
       ]
     },
     {
-      "artefact_count": 252,
+      "artefact_count": 258,
       "default_packs": [
         "meta"
       ],
@@ -452,7 +453,7 @@
       "optional_packs": [],
       "packs": [
         {
-          "artefact_count": 252,
+          "artefact_count": 258,
           "artefacts": [
             "packages/core/.agent-src.uncondensed/commands/agent-handoff.md",
             "packages/core/.agent-src.uncondensed/commands/agent-status.md",
@@ -527,6 +528,7 @@
             "packages/core/.agent-src.uncondensed/commands/judge/solo.md",
             "packages/core/.agent-src.uncondensed/commands/judge/steps.md",
             "packages/core/.agent-src.uncondensed/commands/knowledge.md",
+            "packages/core/.agent-src.uncondensed/commands/knowledge/cross-repo.md",
             "packages/core/.agent-src.uncondensed/commands/knowledge/forget.md",
             "packages/core/.agent-src.uncondensed/commands/knowledge/ingest.md",
             "packages/core/.agent-src.uncondensed/commands/knowledge/list.md",
@@ -574,6 +576,10 @@
             "packages/core/.agent-src.uncondensed/commands/roadmap/process-step.md",
             "packages/core/.agent-src.uncondensed/commands/rule-compliance-audit.md",
             "packages/core/.agent-src.uncondensed/commands/set-cost-profile.md",
+            "packages/core/.agent-src.uncondensed/commands/skill.md",
+            "packages/core/.agent-src.uncondensed/commands/skill/preview.md",
+            "packages/core/.agent-src.uncondensed/commands/skills.md",
+            "packages/core/.agent-src.uncondensed/commands/skills/discover.md",
             "packages/core/.agent-src.uncondensed/commands/sync-agent-settings.md",
             "packages/core/.agent-src.uncondensed/commands/sync-gitignore.md",
             "packages/core/.agent-src.uncondensed/commands/sync-gitignore/fix.md",
@@ -585,6 +591,7 @@
             "packages/core/.agent-src.uncondensed/commands/upstream-contribute.md",
             "packages/core/.agent-src.uncondensed/commands/video.md",
             "packages/core/.agent-src.uncondensed/commands/video/from-script.md",
+            "packages/core/.agent-src.uncondensed/commands/video/from-song.md",
             "packages/core/.agent-src.uncondensed/commands/video/scene.md",
             "packages/core/.agent-src.uncondensed/commands/video/stitch.md",
             "packages/core/.agent-src.uncondensed/commands/video/storyboard.md",

package/dist/mcp/registry-manifest.json

@@ -1,6 +1,6 @@
 {
   "discovery": {
-    "artefact_count": 433,
+    "artefact_count": 440,
     "scanner_version": "ca7acd2ec7af"
   },
   "generated_at": "2026-05-30",
@@ -9,7 +9,7 @@
     "homepage": "https://github.com/event4u-app/agent-config#readme",
     "name": "@event4u/agent-config",
     "repository": "https://github.com/event4u-app/agent-config",
-    "version": "5.4.0"
+    "version": "5.5.0"
   },
   "registries": [
     {

package/docs/architecture.md

@@ -146,9 +146,9 @@ note, package-internal path-swap, description budget, and the
 
 | Layer | Count | Purpose |
 |---|---|---|
-| **Skills** | 219 | On-demand expertise — stack analysis (Laravel · Symfony · Zend / Laminas · Next.js · React · Node), testing, Docker, API design, security, observability, … |
+| **Skills** | 220 | On-demand expertise — stack analysis (Laravel · Symfony · Zend / Laminas · Next.js · React · Node), testing, Docker, API design, security, observability, … |
 | **Rules** | 78 | Always-active constraints — coding standards, scope control, verification, language-and-tone, agent-authority |
-| **Commands** | 135 | Slash-command workflows — `/commit`, `/create-pr`, `/fix ci`, `/optimize skills`, `/feature plan`, `/work`, `/implement-ticket`, `/condense`, … |
+| **Commands** | 141 | Slash-command workflows — `/commit`, `/create-pr`, `/fix ci`, `/optimize skills`, `/feature plan`, `/work`, `/implement-ticket`, `/condense`, … |
 | **Guidelines** | 73 | Reference material cited by skills — PHP patterns, Eloquent, Playwright, agent-infra, … |
 | **Templates** | 7 | Scaffolds for features, roadmaps, contexts, skills, overrides |
 | **Contexts** | 5 | Shared knowledge about the system itself |

package/docs/contracts/command-clusters.md

@@ -49,7 +49,10 @@ column 1 of this table.
 | `sync-gitignore` | — | `fix` | new sub-command 2026-05-11 — cluster head retains the existing append-only sync as its default flow; `:fix` adds `--cleanup-legacy` semantics, scrubbing pre-`/agents/` runtime patterns wherever they appear in the consumer's `.gitignore` (inside or outside the managed block) and re-syncing the canonical entries. |
 | `ghostwriter` | — | `fetch` · `write` · `list` · `show` · `delete` | new cluster 2026-05-15 — third voice primitive for AI-assisted writing in the public voice of a public figure. Hybrid storage: real-person profiles live consumer-side under `agents/reference/ghostwriter/<slug>.md` (gitignored by default); package source ships only `fictional: true` fixtures. Zero network code in the package — `:fetch` delegates web-fetch / web-search to the host agent. Mandatory disclosure footer on every `:write` output (no opt-out). Schema: [`ghostwriter-schema`](ghostwriter-schema.md). |
 | `post-as` | — | `me` · `ghostwriter` | new cluster 2026-05-15 — consumer-facing write entry points. `:me` reads `.agent-user.md.voice_sample` and drafts in the maintainer's own voice (no disclosure footer — the user is the author); `:ghostwriter` is a thin alias for `/ghostwriter:write` with the mandatory disclosure footer. Both share the procedural [`write-engine`](write-engine.md) contract — style source and footer are the only axes of variation. |
-| `video` | — | `from-script` · `scene` · `storyboard` · `stitch` | new cluster 2026-05-17 — AI video generation pipeline. Cluster head orchestrates the full flow; `:scene` runs a single scene end-to-end (script → blueprint → still → motion → clip); `:storyboard` expands a script into per-scene blueprints + reference stills with character-lock JSON; `:from-script` walks a multi-scene script through storyboard + per-scene generation; `:stitch` concatenates scene clips with `ffmpeg` against a scene manifest. Provider-agnostic via the adapter contract under `scripts/ai-video/lib/adapter-contract.md`; cost-gated with mandatory `AIV_DRYRUN=true` default and explicit confirmation before live provider calls. |
+| `video` | — | `from-script` · `from-song` · `scene` · `storyboard` · `stitch` | new cluster 2026-05-17 — AI video generation pipeline. Cluster head orchestrates the full flow; `:scene` runs a single scene end-to-end (script → blueprint → still → motion → clip); `:storyboard` expands a script into per-scene blueprints + reference stills with character-lock JSON; `:from-script` walks a multi-scene script through storyboard + per-scene generation; `:from-song` builds a music-video from a song + reference images — derived/briefed timed script (via the `song-to-script` skill + `probe-audio.sh` hybrid segmentation), optional character-lock, then stitch with the song muxed as the master track and a mandatory AI-generation disclosure; `:stitch` concatenates scene clips with `ffmpeg` against a scene manifest. Provider-agnostic via the adapter contract under `scripts/ai-video/lib/adapter-contract.md`; cost-gated with mandatory `AIV_DRYRUN=true` default and explicit confirmation before live provider calls. |
+| `knowledge` | — | `ingest` · `list` · `forget` · `cross-repo` | local-knowledge namespace (employee-product Phase 7); `:cross-repo` added 2026-05-30 (`road-to-leaner-core-and-discovery` Phase 4) — read-only targeted retrieval over opted-in `linked_projects` siblings (ADR-032 Option A), per [`cross-repo-retrieval`](cross-repo-retrieval.md). The pre-existing `ingest`/`list`/`forget` sub-commands are recorded in the registry here for the first time. |
+| `skills` | — | `discover` | new cluster 2026-05-30 (`road-to-leaner-core-and-discovery` Phase 3) — local, explained skill-recommendation surface over the catalog + role shortlists + optional local analytics, per [`skill-discovery`](skill-discovery.md). Every result carries a non-empty `why`; no network, honours the analytics opt-out. |
+| `skill` | — | `preview` | new cluster 2026-05-30 (`road-to-leaner-core-and-discovery` Phase 5) — non-destructive skill/command preview: surfaces the declared steps + files/commands a skill would touch before it runs, per [`skill-dry-run`](skill-dry-run.md). Singular `skill` (one target) vs plural `skills` (the catalog) by design. |
 
 **Net change:** Phase 1 collapsed 15 atomics → 3 clusters; Phase 2
 collapses 26 atomics → 11 sub-command clusters. Sub-commands use

package/docs/contracts/cross-repo-retrieval.md

@@ -0,0 +1,64 @@
+---
+stability: experimental
+---
+
+# Cross-Repo Retrieval Contract
+
+> **Status** · v0 / design · 2026-05-30. Phase 4 of `road-to-leaner-core-and-discovery`.
+> Extends [ADR-032](../decisions/ADR-032-linked-projects-scope.md) **Option A** (passive,
+> read-only, opt-in-per-sibling, no bulk inclusion). Does **not** advance to Option B (auto-scan)
+> or Option C (implicit inclusion).
+
+## Problem
+
+The ADR-032 detector finds IDE-attached sibling repos but today only produces a passive *awareness
+note* — the agent knows a sibling exists but cannot pull context from it. This contract makes opted-in
+siblings a **read-only, targeted retrieval source**: the agent can fetch a shared type, an API contract
+the frontend consumes, or a config the sibling owns, **without bulk-including** its files.
+
+## Scope guards (Option A, non-negotiable)
+
+```
+READ-ONLY. OPT-IN-PER-SIBLING. TARGETED QUERY, NEVER A FULL-TREE SWEEP.
+```
+
+- **Read-only.** No writes to any sibling. Out-of-root writes still pass the host permission gate;
+  this surface never writes.
+- **Opt-in only.** Only siblings with `include: true` in `agents/settings/.agent-settings.local.yml`
+  → `linked_projects[]` are read. A sibling not opted in is never touched.
+- **Targeted query only.** Every retrieval is a bounded path-glob + content grep — never a blind walk.
+  A `large`-flagged sibling (per the detector) **requires a path scope** and rejects an unscoped query.
+- **Bounded.** ≤ `max_chunks` results per query (default 8). One concept per query.
+
+## Retrieval envelope
+
+Each match is returned as:
+
+```json
+{ "source_repo": "<sibling dir name>", "path": "<rel path in sibling>",
+  "chunk": "<≤ 2 KB redacted excerpt>", "freshness": "<git last-commit date or mtime>",
+  "match_reason": "<why this matched: path-glob or content term>" }
+```
+
+`chunk` passes the same redaction floor as `knowledge_ingest.py` — secrets and PII are scrubbed before
+any cross-repo text is surfaced. Cross-repo text never leaks a secret.
+
+## Memory integration — tagged + discounted
+
+Cross-repo matches projected into `memory_retrieve` carry `source: cross-repo` and are scored **below**
+local curated knowledge — the same 0.85× discount the `knowledge:` namespace already applies — so
+cross-repo context never outranks the project's own truth.
+
+## Surfaces
+
+- CLI: `agent-config linked-projects:list` — prints opted-in siblings (`path · detected_via · large`).
+  Closes the ADR-032 follow-up "expose the detector as a CLI subcommand for consumer reach."
+- CLI / agent: `/knowledge:cross-repo <query>` — renders matches as `source_repo · path · freshness · why`.
+  Honours opt-out (a sibling not `include: true` is never read); inert with a clear message when no
+  siblings are opted in.
+
+## Implementation
+
+`scripts/cross_repo_retrieve.py` (≤ 300 LOC). Pure-local, read-only, no network. Reuses the chunking +
+redaction floor from `knowledge_ingest.py`. Coverage: `tests/test_cross_repo_retrieve.py` against
+fixture sibling repos under `tests/fixtures/cross-repo/`.