@homeostat/core 0.1.2 → 0.1.3

package/dist/src/conflicts.d.ts

@@ -1,3 +1,4 @@
+import type { Entry } from "./entry.ts";
 import type { Severity } from "./issues.ts";
 import type { Frontmatter } from "./schema.ts";
 export type ConflictKind = "duplicate-id" | "missing-reference" | "one-sided-conflict" | "supersedes-cycle" | "superseded-not-retired" | "possible-duplicate";
@@ -21,3 +22,11 @@ export declare function titleSimilarity(a: string, b: string): number;
  * the other. It can report overlap for globs that are in fact disjoint, never the reverse.
  */
 export declare function scopesOverlap(a: readonly string[], b: readonly string[]): boolean;
+/** Functions, file paths and code spans a rule names: `withRetry()`, `services/http.ts`. */
+export declare function codeReferences(text: string): Set<string>;
+/**
+ * Whether two rules teach the same lesson, for the daily run: near-identical titles, or the same
+ * code named in both (two people rarely word a lesson alike, but they name the same function).
+ * Scopes must overlap either way.
+ */
+export declare function sameLesson(a: Entry, b: Entry): boolean;

package/dist/src/conflicts.js

@@ -130,3 +130,25 @@ export function scopesOverlap(a, b) {
         return pa.slice(0, n).every((s, i) => s === pb[i]);
     }));
 }
+/** Functions, file paths and code spans a rule names: `withRetry()`, `services/http.ts`. */
+export function codeReferences(text) {
+    const found = text.match(/[A-Za-z_$][\w$.]*\(\)|[\w.-]+(?:\/[\w.-]+)+\.\w{1,5}|`[^`\n]+`/g) ?? [];
+    return new Set(found.map((s) => s.replace(/`/g, "").toLowerCase()));
+}
+/**
+ * Whether two rules teach the same lesson, for the daily run: near-identical titles, or the same
+ * code named in both (two people rarely word a lesson alike, but they name the same function).
+ * Scopes must overlap either way.
+ */
+export function sameLesson(a, b) {
+    if (!scopesOverlap(a.frontmatter.scope, b.frontmatter.scope))
+        return false;
+    if (titleSimilarity(a.frontmatter.title, b.frontmatter.title) >= TITLE_SIMILARITY)
+        return true;
+    const ra = codeReferences(a.sections.rule ?? "");
+    const rb = codeReferences(b.sections.rule ?? "");
+    if (ra.size === 0 || rb.size === 0)
+        return false;
+    const shared = [...ra].filter((r) => rb.has(r)).length;
+    return shared / new Set([...ra, ...rb]).size >= 0.5;
+}

package/dist/src/events.js

@@ -116,6 +116,15 @@ export function describeEvent(e) {
                 return `${rest.entries?.join(", ") ?? ""} in ${rest.url}`;
             case "agent-run":
                 return `${rest.agent} ${rest.ok ? "ok" : "failed"}: ${rest.summary ?? ""}`;
+            case "doc-read":
+                return `${rest.doc}${rest.section ? `#${rest.section}` : ""}`;
+            case "doc-injection": {
+                const docs = rest.docs ?? [];
+                const sections = rest.sections ?? [];
+                return `${docs.length} document${docs.length === 1 ? "" : "s"} listed, ${sections.length} section${sections.length === 1 ? "" : "s"} included`;
+            }
+            case "seed-run":
+                return `${rest.repo}: ${rest.topics?.join(", ") ?? ""} from ${rest.paths} paths (${rest.chars} chars sent)`;
             default:
                 return JSON.stringify(rest);
         }

package/dist/src/index.d.ts

@@ -8,7 +8,7 @@ export { bedrockAsker, bedrockModelId, type CloudAskerOptions, type CloudClient,
 export { CODEOWNERS_FILE, generateCodeowners } from "./codeowners.ts";
 export { type Confidence, type ConfidenceInput, confidence, explainConfidence, } from "./confidence.ts";
 export { CONFIG_FILE, type Config, configSchema, DEFAULT_AGENT_MODEL, DEFAULT_WEIGHTS, EXPORT_TARGETS, isSenior, parseConfig, ROLES, type Role, type Weights, } from "./config.ts";
-export { type Conflict, type ConflictKind, detectConflicts, scopesOverlap, TITLE_SIMILARITY, titleSimilarity, } from "./conflicts.ts";
+export { type Conflict, type ConflictKind, codeReferences, detectConflicts, sameLesson, scopesOverlap, TITLE_SIMILARITY, titleSimilarity, } from "./conflicts.ts";
 export { type AgentName, cronMatches, digestCron, digestDue, dueAgents, nextRun, } from "./cron.ts";
 export { type CuratedEntry, CurateError, type CurateInput, type CurateResult, curate, type DocUpdate, type Skipped, } from "./curator/curate.ts";
 export { ClaudeDocPatcher, DOC_PATCH_SYSTEM, type DocCandidate, type DocPatcher, type DocProposal, docPatchPrompt, docPatchSchema, } from "./curator/doc-patcher.ts";

package/dist/src/index.js

@@ -8,7 +8,7 @@ export { bedrockAsker, bedrockModelId, vertexAsker, } from "./cloud.js";
 export { CODEOWNERS_FILE, generateCodeowners } from "./codeowners.js";
 export { confidence, explainConfidence, } from "./confidence.js";
 export { CONFIG_FILE, configSchema, DEFAULT_AGENT_MODEL, DEFAULT_WEIGHTS, EXPORT_TARGETS, isSenior, parseConfig, ROLES, } from "./config.js";
-export { detectConflicts, scopesOverlap, TITLE_SIMILARITY, titleSimilarity, } from "./conflicts.js";
+export { codeReferences, detectConflicts, sameLesson, scopesOverlap, TITLE_SIMILARITY, titleSimilarity, } from "./conflicts.js";
 export { cronMatches, digestCron, digestDue, dueAgents, nextRun, } from "./cron.js";
 export { CurateError, curate, } from "./curator/curate.js";
 export { ClaudeDocPatcher, DOC_PATCH_SYSTEM, docPatchPrompt, docPatchSchema, } from "./curator/doc-patcher.js";

package/dist/src/version.d.ts

@@ -1,2 +1,2 @@
 /** The release version; `scripts/version.mjs` keeps it in step with every package.json. */
-export declare const VERSION = "0.1.2";
+export declare const VERSION = "0.1.3";

package/dist/src/version.js

@@ -1,2 +1,2 @@
 /** The release version; `scripts/version.mjs` keeps it in step with every package.json. */
-export const VERSION = "0.1.2";
+export const VERSION = "0.1.3";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homeostat/core",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Schemas, validation, scoring and agents behind homeostat, the team knowledge base for coding agents.",
   "keywords": [
     "homeostat",