@lythos/skill-deck 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lythos-labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+# @lythos/skill-deck
+
+> Declarative skill deck governance. Reconcile declared skills against your cold pool via symlinks.
+
+Part of the [lythoskill](https://github.com/lythos-labs/lythoskill) meta-skill ecosystem.
+
+## What it does
+
+Manages your agent's working set of skills. You declare which skills you want in `skill-deck.toml`; `deck link` creates symlinks from the cold pool to `.claude/skills/`. Supports deny-by-default isolation, max_cards budgeting, transient expiry, and managed directory overlap detection.
+
+## Install
+
+```bash
+bun add -d @lythos/skill-deck
+# or
+bunx @lythos/skill-deck <command>
+```
+
+## Commands
+
+```bash
+# Link declared skills to working set
+bunx @lythos/skill-deck link
+
+# Link with custom deck file
+bunx @lythos/skill-deck link --deck ./my-deck.toml
+
+# Show current deck status
+bunx @lythos/skill-deck status
+
+# Migrate from old deck format
+bunx @lythos/skill-deck migrate
+```
+
+## Architecture
+
+This is the **Starter** layer of the thin-skill pattern. The agent-visible **Skill** layer lives in `packages/lythoskill-deck/skill/` and is built to `skills/lythoskill-deck/`.
+
+## License
+
+MIT

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "@lythos/skill-deck",
-  "version": "0.1.0",
+  "version": "0.1.2",
+  "description": "Declarative skill deck governance — cold pool, working set, deny-by-default",
+  "license": "MIT",
   "type": "module",
   "bin": {
-    "lythoskill-deck": "./src/cli.ts"
+    "lythoskill-deck": "src/cli.ts"
   },
-  "files": ["src"],
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
   "dependencies": {
     "@iarna/toml": "^2.2.5",
     "zod": "^4.3.6"

package/src/link.ts

@@ -23,14 +23,8 @@ import {
 // ── 路径工具 ────────────────────────────────────────────────
 
 function findDeckToml(from: string): string | null {
-  let dir = from;
-  for (let i = 0; i < 10; i++) {
-    const p = join(dir, "skill-deck.toml");
-    if (existsSync(p)) return p;
-    const parent = dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
+  const p = join(from, "skill-deck.toml");
+  if (existsSync(p)) return p;
   return null;
 }
 
@@ -127,7 +121,15 @@ const DECK_PATH = cliDeck
   : findDeckToml(process.cwd()) || resolve("skill-deck.toml");
 
 if (!existsSync(DECK_PATH)) {
-  console.error(`❌ ${DECK_PATH} 不存在`);
+  console.error(`❌ skill-deck.toml not found in ${process.cwd()}`);
+  console.error(`\nCreate one:`);
+  console.error(`  cat > skill-deck.toml <<'EOF'`);
+  console.error(`  [deck]`);
+  console.error(`  max_cards = 10`);
+  console.error(`  \n  [tool]`);
+  console.error(`  skills = ["lythoskill-deck"]`);
+  console.error(`  EOF`);
+  console.error(`\nOr specify a path: bunx @lythos/skill-deck link --deck /path/to/deck.toml`);
   process.exit(1);
 }