@holmes-lab/holmes-kit 0.25.1 → 0.26.1

package/dist/holmes/spec/renumber.js

@@ -489,9 +489,17 @@ function readSourcesForRenumber(projectRoot) {
     }
     return out;
 }
-/** Spec documents as the planner needs them, with store-relative POSIX paths. */
+/**
+ * Spec documents as the planner needs them, with store-relative POSIX paths.
+ *
+ * @implements A-SPEC-699 — `unreadable` exists because the absence of it cost a day. A `.md` whose
+ * frontmatter would not parse used to be skipped by a bare `continue`, so "this store holds no
+ * specs" and "I could not read any of these specs" reached the caller as the same answer. They are
+ * different facts and the caller has to be able to tell them apart.
+ */
 function readSpecsForRenumber(specsRoot) {
     const out = [];
+    const unreadable = [];
     for (const abs of walk(specsRoot).concat((function md(dir, acc = []) {
         let entries;
         try {
@@ -511,21 +519,32 @@ function readSpecsForRenumber(specsRoot) {
     })(specsRoot))) {
         if (!abs.endsWith('.md'))
             continue;
+        const rel = path.relative(specsRoot, abs).split(path.sep).join('/');
         let text;
         try {
             text = fs.readFileSync(abs, 'utf8');
         }
         catch {
+            unreadable.push(rel);
             continue;
         }
-        const fm = /^---\n([\s\S]*?)\n---/.exec(text);
-        if (!fm)
+        // @implements A-SPEC-699 — `\r?\n`, not `\n`. A checkout with core.autocrlf=true holds every
+        // spec as CRLF, and an LF-only fence matched none of them.
+        const fm = /^---\r?\n([\s\S]*?)\r?\n---/.exec(text);
+        if (!fm) {
+            unreadable.push(rel);
             continue;
+        }
         const field = (k) => (new RegExp(`^${k}:[ \\t]*(.+)$`, 'm').exec(fm[1])?.[1] ?? '').trim();
         const id = field('id');
-        if (id === '')
+        if (id === '') {
+            unreadable.push(rel);
             continue;
-        const deps = (/^depends_on:\n((?:[ \t]*-[ \t]*.+\n?)+)/m.exec(fm[1])?.[1] ?? '')
+        }
+        // @implements A-SPEC-699 — the fence is not the only LF-only site. Fixing it alone would leave
+        // this one matching nothing on CRLF, so every family would come back with no edges and both
+        // unsealOrder and approveOrder would arrive empty: the same silence, one layer down.
+        const deps = (/^depends_on:\r?\n((?:[ \t]*-[ \t]*.+\r?\n?)+)/m.exec(fm[1])?.[1] ?? '')
             .split('\n').map((l) => l.replace(/^[ \t]*-[ \t]*/, '').trim()).filter((x) => x !== '');
         const inline = /^depends_on:[ \t]*\[(.*)\]/m.exec(fm[1])?.[1];
         out.push({
@@ -536,5 +555,5 @@ function readSpecsForRenumber(specsRoot) {
             body: text,
         });
     }
-    return out;
+    return { specs: out, unreadable };
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "//": "@implements A-SPEC-209",
   "name": "@holmes-lab/holmes-kit",
-  "version": "0.25.1",
+  "version": "0.26.1",
   "description": "Holmes-Kit — deterministic Agentic Software Engineering (ASE) harness with causal traceability (spec chain + D-CPG + RTM + phase guardrail)",
   "main": "dist/holmes/mcp/server.js",
   "types": "dist/holmes/mcp/server.d.ts",

package/playbooks/publish/PLAYBOOK.md

@@ -58,6 +58,24 @@ README 에 현재형으로 남은 사고, 그리고 **0.16.0 — 신기능 3건
 
 ---
 
+### 2.6단계: 해결된 현장 보고 기록 (Resolved Field Reports) — 소비자에게 닫히는 고리
+
+소비자가 `holmes-kit report` 로 보고한 결함을 이번 릴리스가 고쳤다면, 그 **fingerprint 를
+`src/holmes/project/resolved-reports.ts` 에 기록**한다. 그래야 그 소비자의 다음 세션에서
+"당신이 보고한 것이 고쳐졌다"가 한 번 발화된다(A-SPEC-687).
+
+- fingerprint 는 GitHub 이슈 본문에 이미 실려 있다(`fingerprint: <16 hex>`).
+- `{ fingerprint, version, note }` — version 은 지금 자르는 릴리스, note 는 사람이 읽을 한 문장.
+- 해결한 보고가 없으면 아무것도 하지 않는다. 빈 목록은 정상이고, 브리핑은 침묵한다.
+
+> [!NOTE]
+> 이 단계가 **명령이 아니라 의식 안에 있는 이유**: 안 도는 명령은 목록을 비워두고 브리핑을
+> 영구히 침묵시킨다. 이 저장소에는 만들어만 지고 소비되지 않은 계측기가 여섯 개 기록돼 있고,
+> 지식이 있는 순간(유지보수자가 이슈를 닫는 때)과 이미 도는 절차에 붙이는 것이 그 일곱 번째를
+> 막는 유일한 방법이다.
+
+---
+
 ### 3단계: 릴리스 자율 판정 (Release Autonomy) — auto 또는 HITL
 `releaseAutonomy(specsSinceTag, versionBump, process.env, root, now)` 로 이번 릴리스를 분류한다
 (`versionBumpKind(현재버전, 대상버전)` 으로 범프 종류 산출):