project-librarian 0.5.0 → 0.5.2

package/README.ko.md

@@ -208,6 +208,7 @@ npx project-librarian@latest install --scope project --agents all
 | 위키 그래프 시각화 생성 | "Project Librarian 위키 그래프 시각화를 생성해줘." | `--wiki-visualize` |
 | 후보 메모 저장 | "이 내용을 Project Librarian 후보 메모로 저장해줘: <내용>." | `--capture-inbox --title "Candidate" --content "Details"` |
 | 오래되었거나 미해결인 위키 페이지 보고 | "Project Librarian에서 오래되었거나 미해결인 페이지를 확인해줘." | `--prune-check` |
+| 신호가 높은 오래되었거나 미해결인 위키 페이지만 보고 | "Project Librarian에서 엄격한 기준으로 오래되었거나 미해결인 페이지를 확인해줘." | `--prune-check --prune-check-strict` |
 | git 설정 변경 없이 훅 파일 설치 | "git 설정은 바꾸지 말고 Project Librarian 훅 파일만 설정해줘." | `--no-git-config` |
 
 코드 근거:
@@ -386,6 +387,7 @@ node .codex/skills/project-librarian/dist/init-project-wiki.js install [--scope
 | `--issue-create --issue-title <title>` | 명시적 사용자 승인 후 `gh`로 GitHub 이슈를 생성합니다. |
 | `--glossary-init` | 선택적 용어집 페이지를 만들고 라우팅합니다. |
 | `--prune-check` | 오래되거나 미해결인 수명 주기 신호가 있는 active 페이지를 보고합니다. |
+| `--prune-check --prune-check-strict` | `updated` 날짜가 오늘보다 이전이라는 이유만으로 선택된 페이지는 제외합니다. |
 | `--review-migration`, `--semantic-migrate` | 마이그레이션 coverage와 수신함 상태를 마이그레이션 검토 파일에 동기화합니다. |
 | `--no-git-config` | `git core.hooksPath`를 바꾸지 않고 훅 파일을 설치합니다. |
 | `--code-index` | 폐기 가능한 코드 근거 인덱스를 빌드합니다. |
@@ -422,7 +424,7 @@ npm pack --dry-run
 
 `release:check` 통과는 런타임 보증이 아니라 재현 가능한 릴리스 준비 근거로 봐야 합니다. 현재 checkout에서 위 로컬 게이트를 통과했음을 증명하며, package dry run이 예상 publish 경계(`agents/`, `dist/`, `LICENSE`, `README.md`, `README.ko.md`, `SKILL.md`) 안에 머물고 소스 파일, 테스트, 저장소 로컬 위키/워크플로 상태, raw 벤치마크 출력, 로컬 캐시를 제외하는지도 확인합니다.
 
-배포는 GitHub Release가 published 상태가 된 뒤 `.github/workflows/publish.yml`에서 처리합니다. 이 워크플로는 GitHub OIDC 기반 npm trusted publishing(`id-token: write`)과 `npm publish --access public`을 사용하므로 npm provenance가 자동 생성됩니다. `NODE_AUTH_TOKEN`이나 npm token secret을 쓰면 안 되며, 릴리스 핵심 GitHub 공식 Actions는 전체 commit SHA로 고정합니다. `release:check`는 이 워크플로 계약도 로컬에서 검사합니다.
+배포는 GitHub Release가 published 상태가 된 뒤 `.github/workflows/publish.yml`에서 처리합니다. 이 워크플로는 보호된 `npm-publish` GitHub Environment를 대상으로 하고, GitHub OIDC 기반 npm trusted publishing(`id-token: write`)과 `npm publish --access public`을 사용하므로 npm provenance가 자동 생성됩니다. `NODE_AUTH_TOKEN`이나 npm token secret을 쓰면 안 되며, 릴리스 핵심 GitHub 공식 Actions는 전체 commit SHA로 고정합니다. `release:check`는 이 워크플로 계약도 로컬에서 검사합니다.
 
 trusted publishing과 npm provenance는 패키지가 이 GitHub OIDC 워크플로를 통해 게시되었음을 증명합니다. 벤치마크 정확성, 최종 사용자 저장소의 코드 근거 freshness, 보안 감사를 증명하지는 않으며, 그런 항목은 별도의 근거 트랙으로 다룹니다.
 

package/README.md

@@ -208,6 +208,7 @@ Wiki setup and maintenance:
 | Generate a wiki graph visualizer | "Generate the Project Librarian wiki graph visualizer." | `--wiki-visualize` |
 | Capture a candidate note | "Capture this as a Project Librarian candidate note: <details>." | `--capture-inbox --title "Candidate" --content "Details"` |
 | Report stale or unresolved wiki pages | "Check Project Librarian for stale or unresolved pages." | `--prune-check` |
+| Report only higher-signal stale or unresolved wiki pages | "Check Project Librarian for strict stale or unresolved pages." | `--prune-check --prune-check-strict` |
 | Install hook files without changing git config | "Set up Project Librarian hook files without changing git config." | `--no-git-config` |
 
 Code evidence:
@@ -386,6 +387,7 @@ Important options:
 | `--issue-create --issue-title <title>` | Create a GitHub issue through `gh` after explicit user approval. |
 | `--glossary-init` | Create and route the optional glossary page. |
 | `--prune-check` | Report active pages with stale or unresolved lifecycle signals. |
+| `--prune-check --prune-check-strict` | Omit pages selected only because their `updated` date is older than today. |
 | `--review-migration`, `--semantic-migrate` | Sync migration coverage and inbox statuses into migration review files. |
 | `--no-git-config` | Install hook files without changing `git core.hooksPath`. |
 | `--code-index` | Build the disposable code evidence index. |
@@ -422,7 +424,7 @@ When editing TypeScript under `src/`, rebuild before committing so `dist/` stays
 
 Treat a green `release:check` as a reproducible release-readiness bundle, not a runtime guarantee: it proves those local gates on the current checkout, including that the package dry run stays inside the expected publish boundary (`agents/`, `dist/`, `LICENSE`, `README.md`, `README.ko.md`, and `SKILL.md`) and excludes source files, tests, repo-local wiki/workflow state, raw benchmark output, and local caches.
 
-Publishing is handled by `.github/workflows/publish.yml` after a GitHub Release is published. The workflow uses npm trusted publishing through GitHub OIDC (`id-token: write`) and `npm publish --access public`, which generates npm provenance automatically; it must not use `NODE_AUTH_TOKEN` or npm token secrets, and release-critical first-party GitHub Actions are pinned to full commit SHAs. `release:check` verifies this workflow contract locally.
+Publishing is handled by `.github/workflows/publish.yml` after a GitHub Release is published. The workflow targets the protected `npm-publish` GitHub Environment, uses npm trusted publishing through GitHub OIDC (`id-token: write`) and `npm publish --access public`, and generates npm provenance automatically; it must not use `NODE_AUTH_TOKEN` or npm token secrets, and release-critical first-party GitHub Actions are pinned to full commit SHAs. `release:check` verifies this workflow contract locally.
 
 Trusted publishing and npm provenance prove the package was published through that GitHub OIDC workflow. They do not prove benchmark correctness, code-evidence freshness in an end-user repository, or a security audit; those remain separate evidence tracks.
 

package/dist/args.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.codeQuerySql = exports.codeImpactTarget = exports.codeContextPackTarget = exports.wikiVisualizeOutput = exports.wikiVisualizeMode = exports.wikiImpactTarget = exports.wikiImpactMode = exports.queryTerm = exports.codeSearchSymbolMode = exports.codeQueryMode = exports.codeImpactMode = exports.codeParserMode = exports.codeContextPackMode = exports.codeFilesMode = exports.codeStatusMode = exports.codeReportMode = exports.codeIndexHealthMode = exports.codeIndexFullMode = exports.codeIndexIncrementalMode = exports.codeIndexMode = exports.acknowledgeSmallRepoMode = exports.noGitConfigMode = exports.reviewMigrationMode = exports.pruneCheckMode = exports.captureInboxMode = exports.refreshIndexMode = exports.issueDraftMode = exports.issueCreateMode = exports.glossaryMode = exports.fixMode = exports.doctorMode = exports.qualityCheckMode = exports.linkCheckMode = exports.migrationQualityCheckMode = exports.migrationLintMode = exports.migrationDoctorMode = exports.lintMode = exports.migrateMode = exports.invalidAgentTargets = exports.missingValueOptions = exports.unexpectedValueOptions = exports.unknownOptions = exports.args = exports.commandArgs = exports.command = exports.unknownCommand = exports.helpMode = exports.agentTargets = exports.parsedArgs = exports.rawArgs = void 0;
-exports.issueDraftTitle = exports.issueBodyFile = exports.captureCategory = exports.captureContent = exports.captureTitle = exports.codeIndexScopes = exports.codeParser = exports.codeIndexOutput = exports.codeSearchSymbol = exports.codeReportSection = void 0;
+exports.codeImpactTarget = exports.codeContextPackTarget = exports.wikiVisualizeOutput = exports.wikiVisualizeMode = exports.wikiImpactTarget = exports.wikiImpactMode = exports.queryTerm = exports.codeSearchSymbolMode = exports.codeQueryMode = exports.codeImpactMode = exports.codeParserMode = exports.codeContextPackMode = exports.codeFilesMode = exports.codeStatusMode = exports.codeReportMode = exports.codeIndexHealthMode = exports.codeIndexFullMode = exports.codeIndexIncrementalMode = exports.codeIndexMode = exports.acknowledgeSmallRepoMode = exports.noGitConfigMode = exports.reviewMigrationMode = exports.pruneCheckStrictMode = exports.pruneCheckMode = exports.captureInboxMode = exports.refreshIndexMode = exports.issueDraftMode = exports.issueCreateMode = exports.glossaryMode = exports.fixMode = exports.doctorMode = exports.qualityCheckMode = exports.linkCheckMode = exports.migrationQualityCheckMode = exports.migrationLintMode = exports.migrationDoctorMode = exports.lintMode = exports.migrateMode = exports.invalidAgentTargets = exports.missingValueOptions = exports.unexpectedValueOptions = exports.unknownOptions = exports.args = exports.commandArgs = exports.command = exports.unknownCommand = exports.helpMode = exports.agentTargets = exports.parsedArgs = exports.rawArgs = void 0;
+exports.issueDraftTitle = exports.issueBodyFile = exports.captureCategory = exports.captureContent = exports.captureTitle = exports.codeIndexScopes = exports.codeParser = exports.codeIndexOutput = exports.codeSearchSymbol = exports.codeReportSection = exports.codeQuerySql = void 0;
 exports.parseArgs = parseArgs;
 exports.argValue = argValue;
 exports.argValues = argValues;
@@ -46,6 +46,7 @@ const flagDefinitions = [
     { name: "--migration-quality-check", value: "none" },
     { name: "--no-git-config", value: "none" },
     { name: "--prune-check", value: "none" },
+    { name: "--prune-check-strict", value: "none" },
     { name: "--quality-check", value: "none" },
     { name: "--query", value: "value" },
     { name: "--refresh-index", value: "none" },
@@ -185,6 +186,7 @@ function parseArgs(argv) {
         missingValueOptions: Array.from(flagsWithValues).filter((flag) => hasFlag(flag) && !flagHasValue(commandArgs, flag)),
         noGitConfigMode: args.has("--no-git-config"),
         pruneCheckMode: args.has("--prune-check"),
+        pruneCheckStrictMode: args.has("--prune-check-strict"),
         qualityCheckMode: args.has("--quality-check"),
         queryTerm: argValue("--query"),
         rawArgs: argv,
@@ -231,6 +233,7 @@ exports.issueDraftMode = exports.parsedArgs.issueDraftMode;
 exports.refreshIndexMode = exports.parsedArgs.refreshIndexMode;
 exports.captureInboxMode = exports.parsedArgs.captureInboxMode;
 exports.pruneCheckMode = exports.parsedArgs.pruneCheckMode;
+exports.pruneCheckStrictMode = exports.parsedArgs.pruneCheckStrictMode;
 exports.reviewMigrationMode = exports.parsedArgs.reviewMigrationMode;
 exports.noGitConfigMode = exports.parsedArgs.noGitConfigMode;
 exports.acknowledgeSmallRepoMode = exports.parsedArgs.acknowledgeSmallRepoMode;

package/dist/code-index/modes.js

@@ -60,11 +60,12 @@ function printJson(value) {
 function requireCompatibleDatabase(database, runtime) {
     const schemaVersion = (0, schema_1.readMetaValue)(database, "schema_version");
     if (schemaVersion !== schema_1.codeIndexSchemaVersion) {
+        const health = runtime.codeIndexHealth();
         const databasePath = runtime.codeEvidenceDatabasePath();
         runtime.fail([
-            `code evidence index schema version ${schemaVersion || "(missing)"} is incompatible with ${schema_1.codeIndexSchemaVersion}`,
+            health.message,
             `inspect: project-librarian --code-index-health`,
-            `rebuild: project-librarian --code-index --code-index-full`,
+            `rebuild: ${health.recommended_rebuild_command}`,
             `database: ${databasePath.relativePath}`,
         ].join("\n"));
     }

package/dist/init-project-wiki.js

@@ -42,6 +42,7 @@ Options:
   --glossary-init                  Create and route the optional glossary page.
   --agents <list>                  With init/update, write only selected agent surfaces: codex, claude, cursor, gemini, or all. Existing project skill/setup surfaces are preserved by default.
   --prune-check                    Report active pages with stale or unresolved signals.
+  --prune-check-strict             With --prune-check, omit age-only candidates and show only higher-signal lifecycle items.
   --review-migration               Sync unit coverage and compatible inbox statuses into migration review files.
   --no-git-config                  Install hook files without changing git core.hooksPath.
   --code-index                     Build the disposable .project-wiki code evidence index.
@@ -136,6 +137,10 @@ if (args_1.wikiVisualizeOutput && !args_1.wikiVisualizeMode) {
     console.error("--wiki-visualize-out is only supported with --wiki-visualize.");
     process.exit(1);
 }
+if (args_1.pruneCheckStrictMode && !args_1.pruneCheckMode) {
+    console.error("--prune-check-strict is only supported with --prune-check.");
+    process.exit(1);
+}
 if (args_1.codeIndexIncrementalMode && !args_1.codeIndexMode) {
     console.error("--incremental is only supported with --code-index.");
     process.exit(1);
@@ -217,7 +222,7 @@ function runInitCommand() {
         return;
     }
     if (args_1.pruneCheckMode) {
-        (0, modes_1.runPruneCheckMode)();
+        (0, modes_1.runPruneCheckMode)({ strict: args_1.pruneCheckStrictMode });
         process.exit(0);
     }
     if (args_1.reviewMigrationMode) {

package/dist/modes.js

@@ -40,6 +40,7 @@ exports.projectCandidatesContent = projectCandidatesContent;
 exports.appendCaptureInbox = appendCaptureInbox;
 exports.runIssueDraftMode = runIssueDraftMode;
 exports.runIssueCreateMode = runIssueCreateMode;
+exports.buildPruneCandidate = buildPruneCandidate;
 exports.runPruneCheckMode = runPruneCheckMode;
 exports.collectLinkDiagnostics = collectLinkDiagnostics;
 exports.collectQualityDiagnostics = collectQualityDiagnostics;
@@ -69,6 +70,7 @@ const wiki_diagnostics_1 = require("./wiki-diagnostics");
 const scopedAutoIndexThreshold = 40;
 const scopedAutoIndexCharLimit = 7600;
 const scopedAutoIndexMarker = "<!-- PROJECT-WIKI-SCOPED-AUTO-INDEX -->";
+const pruneCheckAgeReasonPrefix = "updated before today:";
 function isScopedAutoIndex(file) {
     return /^wiki\/indexes\/auto-[a-z0-9-]+\.md$/.test(file);
 }
@@ -547,27 +549,32 @@ function runIssueCreateMode() {
             fs.rmSync(body.cleanupDir, { recursive: true, force: true });
     }
 }
-function runPruneCheckMode() {
+function buildPruneCandidate(file, text, options = {}) {
+    const status = (0, workspace_1.metadataValue)(text, "status");
+    const updated = (0, workspace_1.metadataValue)(text, "updated");
+    const trigger = (0, workspace_1.metadataValue)(text, "review_trigger");
+    const scope = (0, workspace_1.metadataValue)(text, "scope");
+    const body = (0, workspace_1.stripMetadataHeader)(text);
+    const reasons = [];
+    const lifecycleScope = /project-canonical|project-decisions|inbox|migration-inbox/.test(scope);
+    if (status === "active" && lifecycleScope && /pending|proposed|undecided|TODO|TBD|미정/i.test(body))
+        reasons.push("contains pending/proposed/undecided signal");
+    if (status === "active" && trigger && /stale|old|expired|due|오래|도래|만료/i.test(trigger))
+        reasons.push(`review trigger: ${trigger}`);
+    if (updated && updated < (options.today ?? workspace_1.today) && status === "active")
+        reasons.push(`${pruneCheckAgeReasonPrefix} ${updated}`);
+    if (options.strict && !reasons.some((reason) => !reason.startsWith(pruneCheckAgeReasonPrefix)))
+        return null;
+    return reasons.length > 0 ? { file, status, updated, reasons } : null;
+}
+function runPruneCheckMode(options = {}) {
     const candidates = [];
     for (const file of (0, wiki_files_1.wikiMarkdownFiles)()) {
-        const text = (0, workspace_1.read)(file);
-        const status = (0, workspace_1.metadataValue)(text, "status");
-        const updated = (0, workspace_1.metadataValue)(text, "updated");
-        const trigger = (0, workspace_1.metadataValue)(text, "review_trigger");
-        const scope = (0, workspace_1.metadataValue)(text, "scope");
-        const body = (0, workspace_1.stripMetadataHeader)(text);
-        const reasons = [];
-        const lifecycleScope = /project-canonical|project-decisions|inbox|migration-inbox/.test(scope);
-        if (status === "active" && lifecycleScope && /pending|proposed|undecided|TODO|TBD|미정/i.test(body))
-            reasons.push("contains pending/proposed/undecided signal");
-        if (status === "active" && trigger && /stale|old|expired|due|오래|도래|만료/i.test(trigger))
-            reasons.push(`review trigger: ${trigger}`);
-        if (updated && updated < workspace_1.today && status === "active")
-            reasons.push(`updated before today: ${updated}`);
-        if (reasons.length > 0)
-            candidates.push({ file, status, updated, reasons });
+        const candidate = buildPruneCandidate(file, (0, workspace_1.read)(file), options);
+        if (candidate)
+            candidates.push(candidate);
     }
-    console.log("Project wiki prune-check");
+    console.log(options.strict ? "Project wiki prune-check (strict)" : "Project wiki prune-check");
     if (candidates.length === 0)
         console.log("no candidates");
     for (const item of candidates) {

package/dist/templates.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultStarterFilePaths = exports.starterFiles = exports.documentTaxonomy = exports.decisionPolicy = exports.wikiOperatingModel = exports.inboxIndexBlock = exports.glossaryIndexBlock = exports.glossary = exports.index = exports.startup = exports.metadata = exports.wikiAgentsSection = exports.cursorRule = exports.geminiSection = exports.claudeSection = exports.STARTUP_TLDR_MAX_CHARS = exports.startupTldrSyncLabel = exports.codeEvidenceTrustContract = exports.wikiTrustContract = void 0;
+exports.defaultStarterFilePaths = exports.starterFiles = exports.documentTaxonomy = exports.decisionPolicy = exports.wikiOperatingModel = exports.inboxIndexBlock = exports.glossaryIndexBlock = exports.glossary = exports.index = exports.startup = exports.metadata = exports.wikiAgentsSection = exports.cursorRule = exports.geminiSection = exports.claudeSection = exports.STARTUP_TLDR_MAX_CHARS = exports.startupTldrSyncLabel = exports.guidanceClaimEvidenceContract = exports.codeEvidenceTrustContract = exports.wikiTrustContract = void 0;
 exports.extractStartupTldr = extractStartupTldr;
 exports.agentsSection = agentsSection;
 const workspace_1 = require("./workspace");
@@ -16,6 +16,10 @@ exports.wikiTrustContract = "Wiki decision documents are authoritative for proje
 // closing clause is the scale-conditional guidance (2026-06-12 decision, stageR1
 // evidence): on small repos simple lookups measured cheaper via direct reads.
 exports.codeEvidenceTrustContract = "Code-evidence tool and report outputs (`--code-impact`, `--code-report`, and the `project-librarian mcp` tools) are authoritative for code-structure questions: do not re-verify them with repo-wide greps unless `--code-status`/`code_status` reports staleness; on small repos below the measured scale threshold, prefer direct reads over these tools for simple lookups (measured cheaper at small scale).";
+// Guidance-refinement analogue for agent-instruction changes. The measured
+// evidence is scoped to local probe reports, not transferred across models,
+// surfaces, repos, or user projects without their own passing claim gate.
+exports.guidanceClaimEvidenceContract = "Guidance-refinement claims are evidence-scoped: do not promote or claim an agent-instruction improvement unless a local guidance-probe or equivalent report has a passed claim gate with complete measured pairs, variant digests, and zero read-only file changes where requested; otherwise describe it as an unverified candidate.";
 // B1 fallback: label for the auto-synced startup TL;DR sub-block embedded in the
 // managed AGENTS.md marker section. Non-interactive `codex exec` does not run
 // SessionStart hooks (measured 2026-06-10), so AGENTS.md is the only startup
@@ -85,6 +89,7 @@ During conversation:
 - Let \`.githooks/prepare-commit-msg\` append wiki trailers automatically for staged wiki, hook, AGENTS, or project-librarian files.
 - ${exports.wikiTrustContract}
 - ${exports.codeEvidenceTrustContract}
+- ${exports.guidanceClaimEvidenceContract}
 <!-- PROJECT-WIKI-FIRST:END -->`;
 }
 exports.claudeSection = `<!-- PROJECT-WIKI-CLAUDE:START -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-librarian",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Create and maintain compact project context for humans and LLM coding agents.",
   "license": "MIT",
   "type": "commonjs",
@@ -46,6 +46,8 @@
     "benchmark:llm:parse-smoke": "node tests/validators/codex-llm-benchmark-smoke.js",
     "benchmark:llm:prune-raw": "node benchmarks/tools/prune-llm-raw.js",
     "benchmark:llm:raw-audit": "node benchmarks/tools/audit-llm-raw.js",
+    "benchmark:guidance": "npm run build && node benchmarks/tools/guidance-probe-runner.js",
+    "benchmark:guidance:dry-run": "npm run build && node benchmarks/tools/guidance-probe-runner.js --dry-run --markdown",
     "benchmark:injection-sentinel": "node benchmarks/tools/injection-sentinel.js",
     "benchmark:agent-surface-smoke": "node benchmarks/tools/agent-surface-smoke.js",
     "benchmark:claim-ledger": "node benchmarks/tools/benchmark-claim-ledger.js benchmarks/llm/samples/codex-measured-report.json benchmarks/reports/llm/payload-preview.json",