@newlandnpt/pep-cli 0.1.1 → 0.1.3

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 {
@@ -192,12 +196,12 @@ async function waitForAuthorizationCallback(args) {
     throw new Error("CLI redirect URI must be an http://localhost URL with an explicit port.");
   }
   let server;
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const finish = (error, code) => {
       clearTimeout(timeout);
       server?.close();
       if (error) reject(error);
-      else resolve(code);
+      else resolve2(code);
     };
     const timeout = setTimeout(
       () => finish(new Error("Login timed out while waiting for the browser callback.")),
@@ -240,7 +244,7 @@ async function waitForAuthorizationCallback(args) {
 function openBrowser(url) {
   const command = process.platform === "win32" ? "rundll32.exe" : process.platform === "darwin" ? "open" : "xdg-open";
   const commandArgs = process.platform === "win32" ? ["url.dll,FileProtocolHandler", url] : [url];
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const child = (0, import_node_child_process.spawn)(command, commandArgs, {
       detached: true,
       stdio: "ignore",
@@ -249,7 +253,7 @@ function openBrowser(url) {
     child.once("error", reject);
     child.once("spawn", () => {
       child.unref();
-      resolve();
+      resolve2();
     });
   });
 }
@@ -360,7 +364,7 @@ var REFRESH_EARLY_MS = 60 * 1e3;
 var LOCK_STALE_MS = 30 * 1e3;
 var LOCK_WAIT_MS = 10 * 1e3;
 async function delay(milliseconds) {
-  await new Promise((resolve) => setTimeout(resolve, milliseconds));
+  await new Promise((resolve2) => setTimeout(resolve2, milliseconds));
 }
 async function withAuthorizationLock(path, action) {
   await (0, import_promises2.mkdir)((0, import_node_path2.dirname)(path), { recursive: true });
@@ -554,7 +558,7 @@ function encodedPowerShell(script) {
   return Buffer.from(script, "utf16le").toString("base64");
 }
 async function runPowerShell(script, input) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const child = (0, import_node_child_process2.spawn)(
       "powershell.exe",
       [
@@ -577,7 +581,7 @@ async function runPowerShell(script, input) {
     );
     child.once("close", (code) => {
       clearTimeout(timeout);
-      if (code === 0) resolve(stdout.trim());
+      if (code === 0) resolve2(stdout.trim());
       else
         reject(
           new Error(
@@ -627,7 +631,7 @@ $raw = [Console]::In.ReadToEnd()
 }
 var SECURITY_NOT_FOUND = 44;
 async function runSecurity(args) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const child = (0, import_node_child_process2.spawn)("/usr/bin/security", [...args], {
       stdio: ["ignore", "pipe", "pipe"]
     });
@@ -642,7 +646,7 @@ async function runSecurity(args) {
     );
     child.once("close", (code) => {
       clearTimeout(timeout);
-      resolve({ code: code ?? -1, stdout, stderr });
+      resolve2({ code: code ?? -1, stdout, stderr });
     });
   });
 }
@@ -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,31 @@ function describeFailure2(status) {
   }
   return `PEP answered ${status}.`;
 }
+async function physicalDir(path) {
+  const absolute = (0, import_node_path3.resolve)(path);
+  try {
+    return (0, import_node_path3.join)(await (0, import_promises3.realpath)((0, import_node_path3.dirname)(absolute)), (0, import_node_path3.basename)(absolute));
+  } catch {
+    return absolute;
+  }
+}
+async function linkSkill(canonicalSkillDir, linkPath) {
+  await (0, import_promises3.rm)(linkPath, { recursive: true, force: true });
+  const linkDir = (0, import_node_path3.dirname)(linkPath);
+  await (0, import_promises3.mkdir)(linkDir, { recursive: true });
+  try {
+    const junction = (0, import_node_os2.platform)() === "win32";
+    await (0, import_promises3.symlink)(
+      junction ? canonicalSkillDir : (0, import_node_path3.relative)(await physicalDir(linkDir), 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 +939,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 +957,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 +975,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.3";
 function usage() {
   return `PEP CLI ${VERSION}
 
@@ -956,9 +1002,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 +1108,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 +1126,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.3",
   "description": "PEP CLI —— 凭 PEP 身份读取 Newland 开发者文档与 agent skills",
   "license": "UNLICENSED",
   "type": "module",