homeostat 0.1.1 → 0.1.2

package/README.md

@@ -6,7 +6,7 @@ Homeostat turns review feedback that led to a code change into short, scored rul
 
 ```sh
 # In a repo for your team's knowledge base:
-npx --yes homeostat@0.1.1 init
+npx --yes homeostat@0.1.2 init
 
 # In Claude Code:
 claude plugin marketplace add ysugarmen/homeostat

package/dist/src/doctor.js

@@ -108,7 +108,9 @@ function pinnedVersions(root) {
     const checks = [];
     for (const path of ci) {
         const text = readFileSync(join(root, path), "utf8");
-        for (const m of text.matchAll(/\bhomeostat(@[^\s"']*)?\s+(validate|daily|curate|deep-dive|export)\b/g)) {
+        // Only command lines (npx, dlx, a run: step or a script list item): a job's `name:` or a
+        // `git config user.name "homeostat deep-dive"` line reads the same but runs nothing.
+        for (const m of text.matchAll(/(?:\bnpx(?:\s+(?:--yes|-y))?|\bdlx|\brun:|^\s*-)\s+homeostat(@[^\s"']*)?\s+(validate|daily|curate|deep-dive|digest|export)\b/gm)) {
             const version = m[1]?.slice(1);
             if (!version || !/^\d+\.\d+\.\d+(-[\w.]+)?$/.test(version)) {
                 checks.push(fail(`${path} runs homeostat${m[1] ?? ""}: pin an exact version (homeostat@${VERSION}) so a new release cannot run unreviewed`));
@@ -147,8 +149,8 @@ export async function securityReport(root, config, io) {
     const changes = [
         ...access,
         am.enabled
-            ? info(`auto-merge: on for review feedback scoring ${config.scoring.autoMergeThreshold}+ with a code change and no findings; ${am.areas.length ? `areas ${am.areas.join(", ")}` : "all areas"}${am.excludeAreas.length ? ` except ${am.excludeAreas.join(", ")}` : ""}; at most ${am.maxPerRun} per run`)
-            : ok("auto-merge is off: every entry needs a reviewer"),
+            ? info(`the daily run merges lessons at confidence ${config.scoring.confidence.accept}+ (${config.scoring.confidence.coreAccept}+ for core), declines below ${config.scoring.confidence.decline}, and asks a reviewer in between; risky content, conflicts and document edits always go to a reviewer; ${am.areas.length ? `areas ${am.areas.join(", ")}` : "all areas"}${am.excludeAreas.length ? ` except ${am.excludeAreas.join(", ")}` : ""}`)
+            : ok("auto-merge is off: the daily run sends every lesson to a reviewer"),
         existsSync(join(root, ".github/CODEOWNERS")) || existsSync(join(root, "CODEOWNERS"))
             ? ok("CODEOWNERS routes each area to its reviewers")
             : warn("no CODEOWNERS file: run homeostat codeowners"),

package/dist/src/learn.js

@@ -134,7 +134,9 @@ async function learn(url, opts, io) {
     };
     frontmatter.score = score(frontmatter, { config }).score;
     const text = formatEntry(frontmatter, body);
-    const issues = validate({ ...files, [path]: text }).issues.filter((i) => i.file === path && i.severity === "error");
+    const found = validate({ ...files, [path]: text }).issues.filter((i) => i.file === path);
+    const issues = found.filter((i) => i.severity === "error");
+    const warnings = found.filter((i) => i.severity !== "error");
     if (issues.length > 0) {
         io.stdout(`${formatIssues(issues, io).text}nothing written\n`);
         return 1;
@@ -166,6 +168,8 @@ async function learn(url, opts, io) {
     writePendingFile(root, path, text);
     sendPending(root, io);
     io.stdout(`saved ${id} ${summary}: it applies to your sessions now, and tomorrow's daily run decides it for the team\n`);
+    if (warnings.length)
+        io.stdout(formatIssues(warnings, io).text);
     return 0;
 }
 /**
@@ -203,7 +207,9 @@ function learnDoc(root, files, config, opts, io) {
             throw new LearnError(e.message);
         throw e;
     }
-    const issues = validate({ ...files, [path]: text }).issues.filter((i) => i.file === path && i.severity === "error");
+    const found = validate({ ...files, [path]: text }).issues.filter((i) => i.file === path);
+    const issues = found.filter((i) => i.severity === "error");
+    const warnings = found.filter((i) => i.severity !== "error");
     if (issues.length > 0) {
         io.stdout(`${formatIssues(issues, io).text}nothing written\n`);
         return 1;
@@ -226,6 +232,8 @@ function learnDoc(root, files, config, opts, io) {
     writePendingFile(root, path, text);
     sendPending(root, io);
     io.stdout(`${what}: it applies to your sessions now, and tomorrow's daily run decides it for the team\n`);
+    if (warnings.length)
+        io.stdout(formatIssues(warnings, io).text);
     return 0;
 }
 /** Sends pending lessons to the daily run in the background, when the KB has an origin. */

package/dist/src/query.js

@@ -18,6 +18,7 @@ function load(opts, io, view = {}) {
     const pendingIds = new Set(kb.entries.filter((e) => pending.has(e.path)).map((e) => e.entry.frontmatter.id));
     return {
         root,
+        issues: kb.issues,
         config: kb.config,
         entries: kb.entries.map((e) => e.entry),
         docs: kb.docs,
@@ -75,9 +76,11 @@ export function runExplain(id, opts, io) {
         }
         io.stdout(opts.json
             ? `${JSON.stringify({ ...entry.frontmatter, sections: entry.sections }, null, 2)}\n`
-            : `${explainEntry(entry, config)}\n${pendingIds.has(id)
-                ? "Pending in this clone: it applies to your sessions now; the next daily run decides it for the team.\n"
-                : ""}`);
+            : `${explainEntry(entry, config)}\n${!pendingIds.has(id)
+                ? ""
+                : entry.frontmatter.flags?.length
+                    ? "Pending in this clone, flagged: it is out of your sessions until the next daily run takes the flag to the team.\n"
+                    : "Pending in this clone: it applies to your sessions now; the next daily run decides it for the team.\n"}`);
         return 0;
     });
 }
@@ -105,7 +108,7 @@ export function runList(opts, io) {
 }
 export function runStatus(opts, io) {
     return guard(io, () => {
-        const { root, config, entries, docs } = load(opts, io);
+        const { root, config, entries, docs, issues } = load(opts, io);
         const days = opts.days ? Number(opts.days) : 7;
         const now = io.now?.() ?? new Date();
         // The report counts its own window; document decay looks back 90 days.
@@ -113,6 +116,14 @@ export function runStatus(opts, io) {
             since: new Date(now.getTime() - Math.max(days, 90) * 86_400_000).toISOString(),
         });
         io.stdout(`${kbReport(entries, config, { days, now, events, docs })}\n`);
+        // Includes pending lessons, which CI's validate never sees: say so here, before the daily run.
+        const errors = issues.filter((i) => i.severity === "error");
+        if (errors.length) {
+            io.stdout(`- Problems: ${errors.length}, including pending lessons\n${errors
+                .slice(0, 5)
+                .map((i) => `  ${i.file ?? ""}: ${i.message}\n`)
+                .join("")}`);
+        }
         return 0;
     });
 }

package/dist/src/sync.js

@@ -28,7 +28,9 @@ export function pendingFingerprint(root) {
 const idOf = (path) => path.split("/").at(-1)?.replace(/\.md$/, "") ?? path;
 export async function runSync(opts, io) {
     const root = resolve(opts.dir ?? io.env?.HOMEOSTAT_DIR ?? ".");
+    let said = false;
     const say = (s) => {
+        said = true;
         if (!opts.quiet)
             io.stdout(s);
     };
@@ -124,6 +126,15 @@ export async function runSync(opts, io) {
     }
     for (const n of notices)
         say(`${n.text}\n`);
+    // A sync by hand that changed nothing still says so, rather than printing nothing.
+    if (!said) {
+        const count = Object.keys(readPendingFiles(root)).length;
+        say(!isMember
+            ? `up to date with ${base}; "${member}" is not a member in homeostat.yaml, so lessons stay local\n`
+            : count
+                ? `up to date: ${count} pending lesson(s) already on ${candidatesBranch(member)}\n`
+                : `up to date with ${base}; no pending lessons\n`);
+    }
     writeSyncState(root, {
         lastSync: now,
         ...(lastHeartbeat ? { lastHeartbeat } : {}),

package/dist/src/validate.js

@@ -1,10 +1,12 @@
 import { resolve } from "node:path";
-import { applyFixes, readKbFiles, validate, writeKbFile, } from "@homeostat/core";
+import { applyFixes, readKbView, validate, writeKbFile, writePendingFile, } from "@homeostat/core";
 import { formatIssues, painter, plural } from "./format.js";
 /** `homeostat validate [dir]`. Returns the process exit code: 1 when there are errors. */
 export function runValidate(dir, opts, io) {
     const root = resolve(dir);
-    let files = readKbFiles(root);
+    // Pending lessons are checked too: CI never sees them, so this is where a developer would.
+    let view = readKbView(root);
+    let files = view.files;
     let result = validate(files);
     if (opts.fix) {
         const byFile = new Map();
@@ -15,16 +17,24 @@ export function runValidate(dir, opts, io) {
         }
         let fields = 0;
         for (const [path, fixes] of byFile) {
-            writeKbFile(root, path, applyFixes(files[path] ?? "", fixes));
+            const fixed = applyFixes(files[path] ?? "", fixes);
+            if (view.pending.has(path))
+                writePendingFile(root, path, fixed);
+            else
+                writeKbFile(root, path, fixed);
             fields += fixes.length;
         }
         if (byFile.size > 0 && !opts.json) {
             io.stdout(`fixed ${plural(fields, "field")} in ${plural(byFile.size, "file")}\n`);
-            files = readKbFiles(root);
+            view = readKbView(root);
+            files = view.files;
             result = validate(files);
         }
     }
     io.stdout(opts.json ? `${JSON.stringify(toJson(result), null, 2)}\n` : format(result, io));
+    if (!opts.json && view.pending.size > 0) {
+        io.stdout(`(including ${plural(view.pending.size, "pending lesson")} from .homeostat/pending, which the daily run decides)\n`);
+    }
     return result.ok ? 0 : 1;
 }
 function toJson(result) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "homeostat",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Turn your team's code-review lessons into rules every coding agent follows: Claude Code, MCP, Cursor, Copilot, AGENTS.md.",
   "keywords": [
     "claude-code",
@@ -39,9 +39,9 @@
   },
   "dependencies": {
     "commander": "^15.0.0",
-    "@homeostat/core": "0.1.1",
-    "@homeostat/dashboard": "0.1.1",
-    "@homeostat/mcp": "0.1.1"
+    "@homeostat/mcp": "0.1.2",
+    "@homeostat/core": "0.1.2",
+    "@homeostat/dashboard": "0.1.2"
   },
   "publishConfig": {
     "access": "public",