@newlandnpt/pep-cli 0.1.0 → 0.1.2

package/dist/pep.cjs

@@ -21,8 +21,8 @@ function issuerForEnvironment(environment) {
 }
 var BUILD_ENVIRONMENT = false ? "development" : "production";
 var DEFAULT_ISSUER = issuerForEnvironment(BUILD_ENVIRONMENT);
-function configuredIssuer(explicitIssuer, savedIssuer) {
-  return explicitIssuer ?? savedIssuer ?? DEFAULT_ISSUER;
+function configuredIssuer(explicitIssuer) {
+  return explicitIssuer ?? DEFAULT_ISSUER;
 }
 function configDirectory() {
   if (process.platform === "win32") return (0, import_node_path.join)((0, import_node_os.homedir)(), "AppData", "Roaming", "PEP");
@@ -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.0";
+var VERSION = "0.1.2";
 function usage() {
   return `PEP CLI ${VERSION}
 
@@ -949,15 +986,22 @@ Usage:
   pep docs list [--docs-url <url>]
   pep docs get <path> [--docs-url <url>]
 
-The issuer is built into this executable. Use --issuer only to override it temporarily.
+The issuer is built into this executable. --issuer overrides it for that one command and is
+NOT remembered \u2014 pass it every time you log in against a non-default deployment.
 --resource names which resource server the token is for (RFC 8707); repeat it for more than
 one. It defaults to the docs platform \u2014 a token minted without it is rejected by every
 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
@@ -982,15 +1026,21 @@ function option(args, name) {
   args.splice(index, 2);
   return value;
 }
-async function loginConfig(args) {
-  const store = fileConfigStore();
-  const saved = await store.read();
-  const issuer = configuredIssuer(option(args, "--issuer"), saved?.issuer);
-  const clientId = option(args, "--client-id") ?? saved?.clientId ?? DEFAULT_CLIENT_ID;
+async function loginConfig(args, store = fileConfigStore()) {
+  const issuer = configuredIssuer(option(args, "--issuer"));
+  const clientId = option(args, "--client-id") ?? DEFAULT_CLIENT_ID;
   const explicit = repeatedOption(args, "--resource");
-  const resources = explicit.length > 0 ? explicit : saved?.resources ?? [...DEFAULT_RESOURCES];
+  const resources = explicit.length > 0 ? explicit : [...DEFAULT_RESOURCES];
   if (args.length > 0) throw new Error(`Unknown option: ${args[0]}`);
-  return { version: 1, issuer, clientId, redirectUri: DEFAULT_REDIRECT_URI, resources };
+  const saved = await store.read();
+  return {
+    version: 1,
+    issuer,
+    clientId,
+    redirectUri: DEFAULT_REDIRECT_URI,
+    resources,
+    ...saved?.docsUrl !== void 0 ? { docsUrl: saved.docsUrl } : {}
+  };
 }
 async function main() {
   const args = process.argv.slice(2);
@@ -1049,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") {
@@ -1065,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(" ")}`);
@@ -1113,6 +1170,8 @@ ${url}`)
 
 ${usage()}`);
 }
+
+// src/main.ts
 main().catch((error) => {
   console.error(`pep: ${error.message}`);
   process.exitCode = 1;

package/package.json

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