@lythos/skill-deck 0.9.29 → 0.9.31

package/README.md

@@ -9,7 +9,7 @@
 This package exposes a **CLI**. Invoke via:
 
 ```bash
-bunx @lythos/skill-deck@0.9.29 <command> [options]
+bunx @lythos/skill-deck@0.9.31 <command> [options]
 ```
 
 No installation required. `bunx` auto-downloads the package.
@@ -55,14 +55,14 @@ prompt = "Search for latest info, then generate professional document with diagr
 
 | Situation | Command |
 |-----------|---------|
-| Sync working set with `skill-deck.toml` | `bunx @lythos/skill-deck@0.9.29 link` |
-| Validate `skill-deck.toml` before committing | `bunx @lythos/skill-deck@0.9.29 validate` |
-| Download a skill to cold pool and add to deck | `bunx @lythos/skill-deck@0.9.29 add owner/repo` |
-| Pull latest versions of declared skills | `bunx @lythos/skill-deck@0.9.29 refresh` |
-| Refresh a single skill by alias | `bunx @lythos/skill-deck@0.9.29 refresh tdd` |
-| Remove a skill from deck and working set | `bunx @lythos/skill-deck@0.9.29 remove tdd` |
-| GC unreferenced repos from cold pool | `bunx @lythos/skill-deck@0.9.29 prune` |
-| Use a custom deck file or working dir | `bunx @lythos/skill-deck@0.9.29 link --deck ./my-deck.toml --workdir /path/to/project` |
+| Sync working set with `skill-deck.toml` | `bunx @lythos/skill-deck@0.9.31 link` |
+| Validate `skill-deck.toml` before committing | `bunx @lythos/skill-deck@0.9.31 validate` |
+| Download a skill to cold pool and add to deck | `bunx @lythos/skill-deck@0.9.31 add owner/repo` |
+| Pull latest versions of declared skills | `bunx @lythos/skill-deck@0.9.31 refresh` |
+| Refresh a single skill by alias | `bunx @lythos/skill-deck@0.9.31 refresh tdd` |
+| Remove a skill from deck and working set | `bunx @lythos/skill-deck@0.9.31 remove tdd` |
+| GC unreferenced repos from cold pool | `bunx @lythos/skill-deck@0.9.31 prune` |
+| Use a custom deck file or working dir | `bunx @lythos/skill-deck@0.9.31 link --deck ./my-deck.toml --workdir /path/to/project` |
 
 ### Commands
 
@@ -119,7 +119,7 @@ path = "github.com/lythos-labs/lythoskill/skills/lythoskill-deck"
 EOF
 
 # 2. Link — creates symlinks in .claude/skills/
-bunx @lythos/skill-deck@0.9.29 link
+bunx @lythos/skill-deck@0.9.31 link
 ```
 
 ### Key Concepts
@@ -148,7 +148,7 @@ Different agents look for skills in different directories. `skill-deck.toml` con
 
 | Symptom | Cause | Fix |
 |---------|-------|-----|
-| `❌ Skill not found: <name>` | Skill declared in deck but not in cold pool | `bunx @lythos/skill-deck@0.9.29 add github.com/owner/repo/skill` or clone manually into cold pool |
+| `❌ Skill not found: <name>` | Skill declared in deck but not in cold pool | `bunx @lythos/skill-deck@0.9.31 add github.com/owner/repo/skill` or clone manually into cold pool |
 | `link` skips entries with warnings | Real files/directories exist in working set (not symlinks) | Delete the real directories in `working_set` and re-run `link`. Never create directories manually there |
 | `refresh` reports "Not a git repository" | Skill was copied (not cloned) into cold pool | Re-clone with `git clone` or use `deck add` which clones by default |
 | `deck update` prints deprecation warning | `update` was renamed to `refresh` in v0.8+ | Use `deck refresh` instead |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lythos/skill-deck",
-  "version": "0.9.29",
+  "version": "0.9.31",
   "description": "Declarative skill deck governance — cold pool, working set, deny-by-default",
   "keywords": [
     "ai-agent",

package/src/add.ts

@@ -270,7 +270,7 @@ export async function addSkill(
 
   console.log('🔗 Running deck link...')
   const { linkDeck } = await import('./link.js')
-  linkDeck(deckPath, workdir, { mode: options.mode })
+  await linkDeck(deckPath, workdir, { mode: options.mode })
 
   // ── Metadata recording (content-level only; deck refs reconciled by link) ─
 

package/src/cli.ts

@@ -64,7 +64,7 @@ switch (command) {
     console.log(formatHelp(HELP_CONFIG))
     process.exit(0)
   case 'link':
-    linkDeck(deckPath, workdir, { noBackup, mode })
+    await linkDeck(deckPath, workdir, { noBackup, mode })
     break
   case 'add': {
     const locator = args[1]

package/src/link.ts

@@ -125,12 +125,37 @@ const BACKUP_SIZE_THRESHOLD = 100 * 1024 * 1024; // 100MB
 
 // ── 主流程 ──────────────────────────────────────────────────
 
-export function linkDeck(cliDeckPath?: string, cliWorkdir?: string, opts?: { noBackup?: boolean; mode?: 'symlink' | 'snapshot' }): void {
+export async function linkDeck(cliDeckPath?: string, cliWorkdir?: string, opts?: { noBackup?: boolean; mode?: 'symlink' | 'snapshot' }): Promise<void> {
 const MODE = opts?.mode ?? 'symlink'
 const cliDeck = cliDeckPath || process.argv.find((_, i, a) => a[i - 1] === "--deck");
-const DECK_PATH = cliDeck
-  ? resolve(cliDeck)
-  : findDeckToml(process.cwd()) || resolve("skill-deck.toml");
+
+// If --deck is a URL, fetch it first (discovered via quick-agent.sh dogfooding)
+let DECK_PATH: string
+if (cliDeck && (cliDeck.startsWith('http://') || cliDeck.startsWith('https://'))) {
+  let url = cliDeck
+  if (url.includes('github.com/') && url.includes('/blob/')) {
+    url = url.replace('github.com/', 'raw.githubusercontent.com/').replace('/blob/', '/')
+  }
+  const dest = resolve(process.cwd(), 'skill-deck.toml')
+  console.log(`📥 Fetching deck: ${url}`)
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(30_000) })
+    if (!res.ok) {
+      console.error(`❌ Failed to fetch deck (HTTP ${res.status}): ${url}`)
+      process.exit(1)
+    }
+    writeFileSync(dest, await res.text())
+    console.log(`   → saved to ${dest}`)
+    DECK_PATH = dest
+  } catch (e: any) {
+    console.error(`❌ Failed to fetch deck: ${e.message || e}`)
+    process.exit(1)
+  }
+} else {
+  DECK_PATH = cliDeck
+    ? resolve(cliDeck)
+    : findDeckToml(process.cwd()) || resolve("skill-deck.toml");
+}
 
 if (!existsSync(DECK_PATH)) {
   console.error(`❌ skill-deck.toml not found in ${process.cwd()}`);

package/src/refresh.ts

@@ -63,10 +63,10 @@ export function refreshDeck(cliDeckPath?: string, cliWorkdir?: string, target?:
   const results = executeRefreshPlan(plan, {
     gitPull,
     log: console.log,
-    linkDeck: () => {
+    linkDeck: async () => {
       console.log(`\n💡 Run 'bunx @lythos/skill-deck link' to sync refreshed skills to working set.`)
       console.log('🔗 Running deck link...')
-      linkDeck(cliDeckPath, cliWorkdir)
+      await linkDeck(cliDeckPath, cliWorkdir)
     },
   })