@newlandnpt/pep-cli 0.1.1 → 0.1.2

package/dist/pep.cjs

@@ -38,6 +38,9 @@ function skillsStatePath() {
   return (0, import_node_path.join)(configDirectory(), "skills.json");
 }
 function defaultSkillsDirectory() {
+  return (0, import_node_path.join)((0, import_node_os.homedir)(), ".agents", "skills");
+}
+function claudeSkillsDirectory() {
   return (0, import_node_path.join)((0, import_node_os.homedir)(), ".claude", "skills");
 }
 function isCliConfig(value) {
@@ -73,7 +76,8 @@ function fileConfigStore(path = configPath()) {
 function isSkillsState(value) {
   if (typeof value !== "object" || value === null) return false;
   const candidate = value;
-  return candidate.version === 1 && typeof candidate.directory === "string" && Array.isArray(candidate.skills) && candidate.skills.every((one) => typeof one === "string") && (candidate.commit === void 0 || typeof candidate.commit === "string");
+  return candidate.version === 1 && typeof candidate.directory === "string" && Array.isArray(candidate.skills) && candidate.skills.every((one) => typeof one === "string") && (candidate.commit === void 0 || typeof candidate.commit === "string") && // 可选：0.1.1 及更早写下的 skills.json 没有这个键，读它们不该报「状态损坏」。
+  (candidate.linkedInto === void 0 || typeof candidate.linkedInto === "string");
 }
 function fileSkillsStateStore(path = skillsStatePath()) {
   return {
@@ -763,6 +767,7 @@ async function fetchDocContent(dependencies, path) {
 
 // src/skills-service.ts
 var import_promises3 = require("node:fs/promises");
+var import_node_os2 = require("node:os");
 var import_node_path3 = require("node:path");
 var import_node_zlib = require("node:zlib");
 
@@ -852,11 +857,11 @@ function planSkillFiles(entries) {
       );
     }
     const withoutRoot = segments.slice(1);
-    const relative = withoutRoot[0] === SKILLS_SEGMENT ? withoutRoot.slice(1) : withoutRoot;
-    if (relative.length < 2) continue;
+    const relative2 = withoutRoot[0] === SKILLS_SEGMENT ? withoutRoot.slice(1) : withoutRoot;
+    if (relative2.length < 2) continue;
     files.push({
-      skill: relative[0],
-      path: relative.slice(1).join("/"),
+      skill: relative2[0],
+      path: relative2.slice(1).join("/"),
       data: entry.data
     });
   }
@@ -876,6 +881,22 @@ function describeFailure2(status) {
   }
   return `PEP answered ${status}.`;
 }
+async function linkSkill(canonicalSkillDir, linkPath) {
+  await (0, import_promises3.rm)(linkPath, { recursive: true, force: true });
+  await (0, import_promises3.mkdir)((0, import_node_path3.dirname)(linkPath), { recursive: true });
+  try {
+    const junction = (0, import_node_os2.platform)() === "win32";
+    await (0, import_promises3.symlink)(
+      junction ? canonicalSkillDir : (0, import_node_path3.relative)((0, import_node_path3.dirname)(linkPath), canonicalSkillDir),
+      linkPath,
+      junction ? "junction" : void 0
+    );
+    return "linked";
+  } catch {
+    await (0, import_promises3.cp)(canonicalSkillDir, linkPath, { recursive: true });
+    return "copied";
+  }
+}
 async function syncSkills(dependencies) {
   const doFetch = dependencies.fetch ?? globalThis.fetch;
   const response = await doFetch(`${dependencies.issuer}${ARCHIVE_PATH}`, {
@@ -909,6 +930,16 @@ async function syncSkills(dependencies) {
     await (0, import_promises3.mkdir)((0, import_node_path3.dirname)(target), { recursive: true });
     await (0, import_promises3.writeFile)(target, file.data);
   }
+  let copiedCount = 0;
+  if (dependencies.linkInto !== void 0) {
+    for (const skill of skills) {
+      const how = await linkSkill(
+        (0, import_node_path3.join)(dependencies.directory, skill),
+        (0, import_node_path3.join)(dependencies.linkInto, skill)
+      );
+      if (how === "copied") copiedCount += 1;
+    }
+  }
   const removed = (previous?.skills ?? []).filter(
     (skill) => !skills.includes(skill)
   );
@@ -917,11 +948,15 @@ async function syncSkills(dependencies) {
       recursive: true,
       force: true
     });
+    if (previous?.linkedInto !== void 0) {
+      await (0, import_promises3.rm)((0, import_node_path3.join)(previous.linkedInto, skill), { recursive: true, force: true });
+    }
   }
   const state = {
     version: 1,
     skills,
     directory: dependencies.directory,
+    ...dependencies.linkInto !== void 0 ? { linkedInto: dependencies.linkInto } : {},
     ...commit ? { commit } : {}
   };
   await dependencies.stateStore.write(state);
@@ -931,12 +966,14 @@ async function syncSkills(dependencies) {
     fileCount: files.length,
     removed,
     directory: dependencies.directory,
+    ...dependencies.linkInto !== void 0 ? { linkedInto: dependencies.linkInto } : {},
+    ...copiedCount > 0 ? { copiedCount } : {},
     ...commit ? { commit } : {}
   };
 }
 
 // src/cli.ts
-var VERSION = "0.1.1";
+var VERSION = "0.1.2";
 function usage() {
   return `PEP CLI ${VERSION}
 
@@ -956,9 +993,15 @@ one. It defaults to the docs platform \u2014 a token minted without it is reject
 resource server, and their answer looks exactly like "this token does not exist".
 Use \`pep auth token\` when another agent needs a fresh bearer token.
 
-\`pep skills sync\` fetches the latest skills from PEP and writes them where Claude Code
-looks for them (${defaultSkillsDirectory()} unless --dir says otherwise). It only touches
-skills it wrote itself; anything you put there by hand is left alone.
+\`pep skills sync\` fetches the latest skills from PEP and writes them to the shared agent
+directory (${defaultSkillsDirectory()}), which Codex, Cursor, Amp and ~20 other agents read
+directly. Claude Code keeps its own directory, so each skill is also linked into
+${claudeSkillsDirectory()} \u2014 one copy on disk, updated in one place. Where links are not
+available the skill is copied instead and the run says so.
+
+--dir <path> writes to that path ONLY and skips the linking, for an agent that reads neither
+directory. Either way sync only touches skills it wrote itself; anything you put there by
+hand is left alone.
 
 \`pep docs list\` prints the documents this account can read (path + description); feed a path
 straight to \`pep docs get\` to print that document as markdown on stdout. The documentation
@@ -1056,13 +1099,15 @@ ${usage()}`);
     if (command !== "sync") throw new Error(`Unknown skills command.
 
 ${usage()}`);
-    const directory = option(args, "--dir") ?? defaultSkillsDirectory();
+    const explicitDirectory = option(args, "--dir");
+    const directory = explicitDirectory ?? defaultSkillsDirectory();
     if (args.length > 0) throw new Error(`Unknown option: ${args[0]}`);
     const authorization = await auth.currentAuthorization();
     const result = await syncSkills({
       issuer: authorization.issuer,
       accessToken: authorization.accessToken,
       directory,
+      ...explicitDirectory === void 0 ? { linkInto: claudeSkillsDirectory() } : {},
       stateStore: fileSkillsStateStore()
     });
     if (result.status === "unchanged") {
@@ -1072,6 +1117,11 @@ ${usage()}`);
     console.log(
       `Wrote ${result.fileCount} file(s) across ${result.skills.length} skill(s) to ${result.directory}`
     );
+    if (result.linkedInto !== void 0) {
+      console.log(
+        result.copiedCount === void 0 ? `Linked into ${result.linkedInto} for Claude Code` : `Linked into ${result.linkedInto} for Claude Code (${result.copiedCount} copied instead \u2014 links unavailable here)`
+      );
+    }
     if (result.commit) console.log(`Commit: ${result.commit}`);
     if (result.removed.length > 0)
       console.log(`Removed (gone upstream): ${result.removed.join(" ")}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newlandnpt/pep-cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "PEP CLI —— 凭 PEP 身份读取 Newland 开发者文档与 agent skills",
   "license": "UNLICENSED",
   "type": "module",