project-librarian 0.6.0 → 0.6.1

package/README.ko.md

@@ -41,7 +41,7 @@ npx project-librarian@latest install --scope project --agents all
 npx project-librarian@latest update
 ```
 
-이 명령은 관리 설정 파일, 에이전트 훅, 위키 운영/메타 파일, 기존 프로젝트 범위 스킬 복사본을 갱신합니다. 현재 `wiki/`는 보존하고 migration flag는 거부하므로 위키를 `wiki_legacy*`로 바꾸지 않습니다.
+이 명령은 관리 설정 파일, 에이전트 훅, 위키 운영/메타 파일, 기존 프로젝트 범위 스킬 복사본을 갱신합니다. 기존 공유 `.agents/skills/project-librarian/` 복사본도 특정 에이전트 설정 표면을 암묵적으로 추가하지 않고 갱신합니다. 현재 `wiki/`는 보존하고 migration flag는 거부하므로 위키를 `wiki_legacy*`로 바꾸지 않습니다.
 
 특정 프로젝트 표면을 의도적으로 추가하거나 갱신할 때는 `--agents`를 명시합니다.
 

package/README.md

@@ -41,7 +41,7 @@ To refresh an existing setup without migrating the wiki, run:
 npx project-librarian@latest update
 ```
 
-That updates managed setup files, agent hooks, wiki operating/meta files, and existing project-scoped skill copies. It preserves the current `wiki/` and rejects migration flags, so it will not rename the wiki to `wiki_legacy*`.
+That updates managed setup files, agent hooks, wiki operating/meta files, and existing project-scoped skill copies. Existing shared `.agents/skills/project-librarian/` copies are refreshed without implying any agent-specific setup surface. It preserves the current `wiki/` and rejects migration flags, so it will not rename the wiki to `wiki_legacy*`.
 
 Use `--agents` when you intentionally want to add or refresh a specific project surface:
 

package/SKILL.md

@@ -37,6 +37,7 @@ Supported actions:
 Prefer an already installed local runner over network package execution:
 
 - In the project-librarian source repository, use `node dist/init-project-wiki.js` when `dist/init-project-wiki.js` exists.
+- In a target repository with a shared project-scoped skill install, use `node .agents/skills/project-librarian/dist/init-project-wiki.js`.
 - In a target repository with a project-scoped Codex skill install, use `node .codex/skills/project-librarian/dist/init-project-wiki.js`.
 - In a target repository with a project-scoped Claude skill install, use `node .claude/skills/project-librarian/dist/init-project-wiki.js`.
 - In a target repository with a project-scoped Cursor skill install, use `node .cursor/skills/project-librarian/dist/init-project-wiki.js`.

package/dist/agent-surfaces.js

@@ -20,6 +20,7 @@ const agentSurfaceProjectSkillFiles = {
     gemini: [".gemini/skills/project-librarian/SKILL.md"],
 };
 const projectLibrarianCommonInstallFiles = [
+    ".agents/skills/project-librarian/SKILL.md",
     "wiki/startup.md",
     "wiki/index.md",
     "wiki/AGENTS.md",

package/dist/hooks.js

@@ -149,6 +149,7 @@ const mcpServerName = "project-librarian";
 // runner wins; absent any local install we register the published binary.
 const localRunnerCandidates = [
     "tools/project-librarian/dist/init-project-wiki.js",
+    ".agents/skills/project-librarian/dist/init-project-wiki.js",
     ".codex/skills/project-librarian/dist/init-project-wiki.js",
     ".claude/skills/project-librarian/dist/init-project-wiki.js",
     ".cursor/skills/project-librarian/dist/init-project-wiki.js",
@@ -458,7 +459,7 @@ function wikiScope(files) {
     else if (file.startsWith(".gemini/hooks/") || file === ".gemini/settings.json") add("gemini-hooks");
     else if (file === "AGENTS.md" || file === "CLAUDE.md" || file === "GEMINI.md") add("agents");
     else if (file.startsWith(".githooks/")) add("git-hooks");
-    else if (file.startsWith("tools/project-librarian/")) add("skill");
+    else if (file.startsWith("tools/project-librarian/") || file.startsWith(".agents/skills/project-librarian/")) add("skill");
   }
   return scopes.length === 0 ? "none" : scopes.join(", ");
 }
@@ -467,6 +468,7 @@ function validationTrailers() {
   const home = process.env.HOME || "";
   const lintScript = [
     "tools/project-librarian/dist/init-project-wiki.js",
+    ".agents/skills/project-librarian/dist/init-project-wiki.js",
     path.join(home, ".codex/skills/project-librarian/dist/init-project-wiki.js"),
     path.join(home, ".claude/skills/project-librarian/dist/init-project-wiki.js"),
     path.join(home, ".cursor/skills/project-librarian/dist/init-project-wiki.js"),
@@ -517,7 +519,8 @@ const wikiFiles = staged.filter((file) => {
     || file === ".gemini/settings.json"
     || file.startsWith(".gemini/hooks/")
     || file.startsWith(".githooks/")
-    || file.startsWith("tools/project-librarian/");
+    || file.startsWith("tools/project-librarian/")
+    || file.startsWith(".agents/skills/project-librarian/");
 });
 
 if (wikiFiles.length === 0) process.exit(0);

package/dist/init-project-wiki.js

@@ -328,6 +328,7 @@ function runInitCommand() {
     const projectSkillSyncSurfaces = args_1.command === "update"
         ? (0, install_skill_1.installedProjectSkillSurfaces)().filter((surface) => (0, agent_surfaces_1.includesAgentSurface)(selectedAgentSurfaces, surface))
         : [];
+    const syncSharedProjectSkill = args_1.command === "update" && (0, install_skill_1.hasSharedProjectSkillInstall)();
     const shouldWriteSurface = (surface) => (0, agent_surfaces_1.includesAgentSurface)(selectedAgentSurfaces, surface);
     const writeCodexSurface = shouldWriteSurface("codex");
     const writeClaudeSurface = shouldWriteSurface("claude");
@@ -357,6 +358,10 @@ function runInitCommand() {
         for (const result of (0, install_skill_1.syncProjectSkillInstall)(surface))
             results.push(result);
     }
+    if (syncSharedProjectSkill) {
+        for (const result of (0, install_skill_1.syncSharedProjectSkillInstall)())
+            results.push(result);
+    }
     // B1 fallback: sync the CURRENT startup.md TL;DR into the managed AGENTS.md block
     // so non-interactive `codex exec` (which does not run SessionStart hooks) still
     // gets compact startup context. Routers are starter files written later in this

package/dist/install-skill.js

@@ -34,8 +34,11 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.projectSkillTarget = projectSkillTarget;
+exports.sharedProjectSkillTarget = sharedProjectSkillTarget;
 exports.installedProjectSkillSurfaces = installedProjectSkillSurfaces;
+exports.hasSharedProjectSkillInstall = hasSharedProjectSkillInstall;
 exports.syncProjectSkillInstall = syncProjectSkillInstall;
+exports.syncSharedProjectSkillInstall = syncSharedProjectSkillInstall;
 exports.runInstallSkillMode = runInstallSkillMode;
 const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
@@ -43,6 +46,7 @@ const path = __importStar(require("node:path"));
 const agent_surfaces_1 = require("./agent-surfaces");
 const args_1 = require("./args");
 const skillName = "project-librarian";
+const sharedProjectSkillRelativeRoot = path.join(".agents", "skills", skillName);
 const packageFiles = [
     "SKILL.md",
     "dist",
@@ -121,6 +125,9 @@ function projectSkillRelativeRoot(agent) {
 function projectSkillTarget(agent) {
     return path.join(process.cwd(), projectSkillRelativeRoot(agent));
 }
+function sharedProjectSkillTarget() {
+    return path.join(process.cwd(), sharedProjectSkillRelativeRoot);
+}
 function installTarget(agent, scope) {
     const base = scope === "user" ? userAgentRoot(agent) : path.join(process.cwd(), projectAgentRoot(agent));
     return path.join(base, "skills", skillName);
@@ -247,6 +254,9 @@ function copyPath(source, target, targetRoot, dryRun) {
 function installedProjectSkillSurfaces() {
     return agent_surfaces_1.allAgentSurfaces.filter((agent) => fs.existsSync(path.join(projectSkillTarget(agent), "SKILL.md")));
 }
+function hasSharedProjectSkillInstall() {
+    return fs.existsSync(path.join(sharedProjectSkillTarget(), "SKILL.md"));
+}
 function copyPackageFiles(targetRoot, dryRun, labelRoot = targetRoot) {
     const root = packageRoot();
     const packageRows = packageFiles.map((relativePath) => {
@@ -269,6 +279,13 @@ function syncProjectSkillInstall(agent) {
         return [label, status];
     });
 }
+function syncSharedProjectSkillInstall() {
+    return copyPackageFiles(sharedProjectSkillTarget(), false, sharedProjectSkillRelativeRoot).map(([label, status]) => {
+        if (status === "dry-run")
+            throw new Error("shared project skill sync does not support dry-run status");
+        return [label, status];
+    });
+}
 function runInstallSkillMode() {
     const scope = installScope();
     const agents = installAgents();

package/dist/native/project-librarian-indexer-manifest.json

@@ -21,8 +21,8 @@
       "architecture": "arm64",
       "format": "elf",
       "path": "dist/native/linux-arm64/project-librarian-indexer",
-      "sha256": "f3cc884acca4f5863fb6a6545a4a9f9a37a67872bfe780f4b14f0c4a8a667f16",
-      "size": 3065520,
+      "sha256": "88146d5bbe5b77bb53e2cbe872ad6d2a8a93a58fa1b53671841cc94463443f46",
+      "size": 3065568,
       "triple": "linux-arm64"
     },
     {
@@ -45,15 +45,15 @@
       "architecture": "x64",
       "format": "elf",
       "path": "dist/native/linux-x64-musl/project-librarian-indexer",
-      "sha256": "0055ec9fefa385d6d637fa1e457308c38f892e0fbdb389db3fcbdf546f0daca8",
-      "size": 3247400,
+      "sha256": "811221a87fe5d8ef9f67f4eafe4386ef7aa03bdc1601e89fa191c0e0d7b0dcd5",
+      "size": 3247424,
       "triple": "linux-x64-musl"
     },
     {
       "architecture": "arm64",
       "format": "pe",
       "path": "dist/native/win32-arm64/project-librarian-indexer.exe",
-      "sha256": "b49ad30a72a9a93ff524cc1643b141c94de4850655ce646d80579edc5b832f71",
+      "sha256": "69aeecd89d8ec8e7e4e85adfdf15cd682df9eaa14b8e6d0e99f445eeb70e6267",
       "size": 2098688,
       "triple": "win32-arm64"
     },
@@ -61,7 +61,7 @@
       "architecture": "x64",
       "format": "pe",
       "path": "dist/native/win32-x64/project-librarian-indexer.exe",
-      "sha256": "36a8416e4975100f89bc57281b311b45158469fb12ea37d33dac2d5855a5e47a",
+      "sha256": "ae493dbea6ddd4cd6831ad9a21db07df0c6e2989602e6048dfbfa9aa1eb80ee5",
       "size": 2375680,
       "triple": "win32-x64"
     }

package/docs/cli-reference.md

@@ -9,7 +9,7 @@ node .codex/skills/project-librarian/dist/init-project-wiki.js install [--scope
 
 `install-skill` remains a compatibility alias for `install`.
 
-`update` is the explicit existing-project update command. It rejects `--migrate` and `--adopt-existing`; use top-level `--migrate` when legacy docs or wiki content should be preserved into `wiki_legacy*` and reviewed. When project-scoped Project Librarian skill installs already exist for the selected agent surfaces, `update` copies the current package's reusable skill files and required local-runner runtime dependencies into those project skill directories before refreshing the managed setup.
+`update` is the explicit existing-project update command. It rejects `--migrate` and `--adopt-existing`; use top-level `--migrate` when legacy docs or wiki content should be preserved into `wiki_legacy*` and reviewed. When project-scoped Project Librarian skill installs already exist for the selected agent surfaces, `update` copies the current package's reusable skill files and required local-runner runtime dependencies into those project skill directories before refreshing the managed setup. An existing shared `.agents/skills/project-librarian/` install is synchronized independently without selecting agent-specific setup surfaces.
 
 ### Important Options
 

package/docs/ko/cli-reference.md

@@ -9,7 +9,7 @@ node .codex/skills/project-librarian/dist/init-project-wiki.js install [--scope
 
 `install-skill`은 `install`의 호환성 별칭으로 계속 지원됩니다.
 
-`update`는 기존 프로젝트 갱신을 명시하는 명령입니다. `--migrate`와 `--adopt-existing`를 거부합니다. 기존 문서나 위키 내용을 `wiki_legacy*`로 보존하고 검토해야 한다면 top-level `--migrate`를 사용합니다. 선택된 에이전트 표면에 프로젝트 범위 Project Librarian 스킬 설치가 이미 있으면 `update`는 현재 패키지의 재사용 가능한 스킬 파일과 로컬 실행기에 필요한 필수 런타임 의존성을 해당 프로젝트 스킬 디렉터리에 복사한 뒤 관리 설정을 갱신합니다.
+`update`는 기존 프로젝트 갱신을 명시하는 명령입니다. `--migrate`와 `--adopt-existing`를 거부합니다. 기존 문서나 위키 내용을 `wiki_legacy*`로 보존하고 검토해야 한다면 top-level `--migrate`를 사용합니다. 선택된 에이전트 표면에 프로젝트 범위 Project Librarian 스킬 설치가 이미 있으면 `update`는 현재 패키지의 재사용 가능한 스킬 파일과 로컬 실행기에 필요한 필수 런타임 의존성을 해당 프로젝트 스킬 디렉터리에 복사한 뒤 관리 설정을 갱신합니다. 기존 공유 `.agents/skills/project-librarian/` 설치는 에이전트별 설정 표면을 선택하지 않고 별도로 동기화합니다.
 
 ### 주요 옵션
 

package/docs/ko/usage.md

@@ -34,7 +34,7 @@ npx project-librarian@latest install --scope project --agents all
 
 마이그레이션 없는 기존 설정 갱신은 저장소에 이미 있는 에이전트 표면만 보존해서 갱신합니다. 따라서 Codex와 Claude 파일만 있던 저장소는 일반 갱신만으로 Cursor나 Gemini 파일이 새로 생기지 않습니다. 새 표면을 의도적으로 추가하려면 `project-librarian update --agents cursor` 또는 `project-librarian update --agents all`처럼 명시합니다. 목록에 없는 표면을 삭제하지는 않습니다.
 
-`project-librarian update`는 선택된 표면에 이미 프로젝트 범위 Project Librarian 스킬 설치가 있으면 현재 실행 중인 패키지의 재사용 가능한 스킬 파일과 프로젝트 로컬 실행기에 필요한 런타임 의존성을 그 프로젝트 스킬 디렉터리로 동기화합니다. 기본적으로 새 프로젝트 범위 스킬 설치를 만들지는 않고, 사용자 범위 스킬 설치도 갱신하지 않습니다. 사용자 범위 스킬은 `install --scope user`로 명시적으로 갱신합니다.
+`project-librarian update`는 선택된 표면에 이미 프로젝트 범위 Project Librarian 스킬 설치가 있으면 현재 실행 중인 패키지의 재사용 가능한 스킬 파일과 프로젝트 로컬 실행기에 필요한 런타임 의존성을 그 프로젝트 스킬 디렉터리로 동기화합니다. 기존 공유 `.agents/skills/project-librarian/` 설치는 별도로 동기화하며 Codex, Claude, Cursor, Gemini 설정 표면을 암묵적으로 추가하지 않습니다. 기본적으로 새 프로젝트 범위 스킬 설치를 만들지는 않고, 사용자 범위 스킬 설치도 갱신하지 않습니다. 사용자 범위 스킬은 `install --scope user`로 명시적으로 갱신합니다.
 
 ## 실행 경로
 
@@ -42,6 +42,7 @@ npx project-librarian@latest install --scope project --agents all
 
 | 설치 위치 | 실행 경로 |
 | --- | --- |
+| 공유 프로젝트 범위 스킬 | `node .agents/skills/project-librarian/dist/init-project-wiki.js` |
 | 프로젝트 범위 Codex 스킬 | `node .codex/skills/project-librarian/dist/init-project-wiki.js` |
 | 프로젝트 범위 Claude 스킬 | `node .claude/skills/project-librarian/dist/init-project-wiki.js` |
 | 프로젝트 범위 Cursor 스킬 | `node .cursor/skills/project-librarian/dist/init-project-wiki.js` |

package/docs/usage.md

@@ -32,7 +32,7 @@ npx project-librarian@latest install --scope project --agents all
 
 The project setup/update runner also accepts `--agents`. Fresh setup defaults to all supported agent surfaces only when no project-scoped Project Librarian skill install is present. If the repository already has project-scoped skills such as `.codex/skills/project-librarian/` and `.claude/skills/project-librarian/`, the first setup uses that installed agent set by default. Existing non-migration updates preserve the agent surfaces already present in the repository, so a repo that has only Codex and Claude files will not gain Cursor or Gemini files on a plain update. Use `project-librarian update --agents cursor` or `project-librarian update --agents all` when you intentionally want to add newly supported surfaces; unlisted surfaces are not deleted.
 
-`project-librarian update` also syncs any project-scoped Project Librarian skill installs that already exist for the selected surfaces from the currently running package, including the runtime dependencies needed by the project-local runner. This means `npx project-librarian@latest update` can refresh the repository's managed setup, hooks, wiki meta files, and existing project-scoped skill copies without migration. It does not create new project-scoped skill installs by default and does not update user-scoped skill installs; use `install --scope user` for that.
+`project-librarian update` also syncs any project-scoped Project Librarian skill installs that already exist for the selected surfaces from the currently running package, including the runtime dependencies needed by the project-local runner. An existing shared `.agents/skills/project-librarian/` install is synchronized independently and does not imply Codex, Claude, Cursor, or Gemini setup surfaces. This means `npx project-librarian@latest update` can refresh the repository's managed setup, hooks, wiki meta files, and existing project-scoped skill copies without migration. It does not create new project-scoped skill installs by default and does not update user-scoped skill installs; use `install --scope user` for that.
 
 ## Runner Paths
 
@@ -40,6 +40,7 @@ These paths are mainly for agents and automation. After installation, agents sho
 
 | Installation | Runner |
 | --- | --- |
+| Shared project-scoped skill | `node .agents/skills/project-librarian/dist/init-project-wiki.js` |
 | Project-scoped Codex skill | `node .codex/skills/project-librarian/dist/init-project-wiki.js` |
 | Project-scoped Claude skill | `node .claude/skills/project-librarian/dist/init-project-wiki.js` |
 | Project-scoped Cursor skill | `node .cursor/skills/project-librarian/dist/init-project-wiki.js` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-librarian",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Create and maintain compact project context for humans and LLM coding agents.",
   "license": "MIT",
   "type": "commonjs",