bikky 0.4.2 → 0.4.4

package/dist/mcp/helpers.js

@@ -5,6 +5,7 @@
  */
 import crypto from "node:crypto";
 import { DEFAULT_DOMAIN, getDecayHalfLife, STALENESS_DAYS } from "./taxonomy.js";
+import { isOperationOrigin } from "../provenance/origin.js";
 // ---------------------------------------------------------------------------
 // Hashing
 // ---------------------------------------------------------------------------
@@ -97,7 +98,7 @@ export function isStale(payload) {
 export const MEMORY_RECALL_EXCLUDED_KINDS = ["telemetry"];
 /** Build a Qdrant filter object from optional params. */
 export function buildFilter(params = {}) {
-    const { category, domain, kind, memory_subtype, actor_id, entity, session_id, episode_id, workstream_key, task_key, repo, branch, review_status, since, until, excludeSuperseded = true, excludeKinds = [], metadata, } = params;
+    const { category, domain, kind, memory_subtype, origin_user_id, origin_agent_id, origin_interface, actor_id, entity, session_id, episode_id, workstream_key, task_key, repo, branch, review_status, since, until, excludeSuperseded = true, excludeKinds = [], metadata, } = params;
     const must = [];
     const must_not = [];
     if (excludeSuperseded) {
@@ -115,8 +116,23 @@ export function buildFilter(params = {}) {
     if (memory_subtype) {
         must.push({ key: "memory_subtype", match: { value: memory_subtype } });
     }
+    if (origin_user_id) {
+        must.push({ key: "origin.user.id", match: { value: origin_user_id } });
+    }
+    if (origin_agent_id) {
+        must.push({ key: "origin.agent.id", match: { value: origin_agent_id } });
+    }
+    if (origin_interface) {
+        must.push({ key: "origin.interface", match: { value: origin_interface } });
+    }
     if (actor_id) {
-        must.push({ key: "actor_id", match: { value: actor_id } });
+        must.push({
+            should: [
+                { key: "origin.user.id", match: { value: actor_id } },
+                { key: "origin.agent.id", match: { value: actor_id } },
+                { key: "actor_id", match: { value: actor_id } },
+            ],
+        });
     }
     if (entity) {
         must.push({ key: "entities", match: { value: entity.toLowerCase() } });
@@ -173,8 +189,14 @@ export function formatFact(point) {
         parts.push(`kind: ${p.kind}`);
     if (p.memory_subtype)
         parts.push(`subtype: ${p.memory_subtype}`);
-    if (p.actor_id)
+    if (isOperationOrigin(p.origin)) {
+        const user = p.origin.user?.name ?? p.origin.user?.id;
+        const agent = p.origin.agent.name ?? p.origin.agent.id ?? p.origin.agent.type;
+        parts.push(`origin: ${user ? `${user} via ` : ""}${agent} (${p.origin.interface}/${p.origin.operation.action})`);
+    }
+    else if (p.actor_id) {
         parts.push(`actor: ${p.actor_id}`);
+    }
     if (p.workstream_key)
         parts.push(`workstream: ${p.workstream_key}`);
     if (p.episode_id)
@@ -195,6 +217,12 @@ export function formatFact(point) {
         parts.push(`useful: ${p.useful_count}x`);
     if ((p.not_useful_count ?? 0) > 0)
         parts.push(`not useful: ${p.not_useful_count}x`);
+    if ((p.misleading_count ?? 0) > 0)
+        parts.push(`misleading: ${p.misleading_count}x`);
+    if ((p.wrong_count ?? 0) > 0)
+        parts.push(`wrong: ${p.wrong_count}x`);
+    if ((p.irrelevant_count ?? 0) > 0)
+        parts.push(`irrelevant: ${p.irrelevant_count}x`);
     if (p.redaction?.redacted)
         parts.push(`redacted: ${p.redaction.summary}`);
     if (p.metadata && Object.keys(p.metadata).length > 0) {
@@ -234,6 +262,8 @@ export function structuredFact(point) {
         ...(p.domain ? { domain: p.domain } : {}),
         ...(p.kind ? { kind: p.kind } : {}),
         ...(p.memory_subtype ? { memory_subtype: p.memory_subtype } : {}),
+        ...(isOperationOrigin(p.origin) ? { origin: p.origin } : {}),
+        ...(isOperationOrigin(p.last_operation_origin) ? { last_operation_origin: p.last_operation_origin } : {}),
         ...(p.actor_id ? { actor_id: p.actor_id } : {}),
         ...(p.source ? { source: p.source } : {}),
         entities: p.entities ?? [],
@@ -244,6 +274,9 @@ export function structuredFact(point) {
         ...(p.verification_count !== undefined ? { verification_count: p.verification_count } : {}),
         ...(p.useful_count !== undefined ? { useful_count: p.useful_count } : {}),
         ...(p.not_useful_count !== undefined ? { not_useful_count: p.not_useful_count } : {}),
+        ...(p.misleading_count !== undefined ? { misleading_count: p.misleading_count } : {}),
+        ...(p.wrong_count !== undefined ? { wrong_count: p.wrong_count } : {}),
+        ...(p.irrelevant_count !== undefined ? { irrelevant_count: p.irrelevant_count } : {}),
         ...(p.redaction ? { redaction: p.redaction } : {}),
         ...(p.metadata && Object.keys(p.metadata).length > 0 ? { metadata: p.metadata } : {}),
         ...(p.workstream_key ? { workstream_key: p.workstream_key } : {}),

package/dist/mcp/taxonomy.d.ts

@@ -13,10 +13,6 @@ export declare const CATEGORIES: {
         readonly description: "Product context: domain rules, product decisions, requirements, user workflows, roadmap, success metrics, and market or community insight.";
         readonly examples: readonly ["Bikky should show categories and concrete subtype chips directly, with no extra sub-tab layer.", "Activation should be measured by whether agents successfully reuse recalled memory."];
     };
-    readonly human: {
-        readonly description: "Human context: explicit preferences, people and roles, ownership, working agreements, and durable actor-action activity events.";
-        readonly examples: readonly ["Saber prefers concise implementation plans before code changes.", "Alex approved PR #85 for merge."];
-    };
     readonly system: {
         readonly description: "System context: Bikky-owned lifecycle memory, session indexes, episodes, workstreams, recall/feedback/outcome telemetry, and aggregate rollups.";
         readonly examples: readonly ["Session indexes are routing/audit artifacts rather than durable project boundaries.", "Recall telemetry is excluded from normal semantic recall."];
@@ -27,15 +23,15 @@ export declare const DEFAULT_CATEGORY: Category;
 export declare const DOMAINS: {
     readonly software_engineering: {
         readonly description: "Coding-agent work: repositories, code changes, architecture, infrastructure, debugging, tests, CI, and developer workflow.";
-        readonly defaultCategories: readonly ["engineering", "product", "human", "system"];
+        readonly defaultCategories: readonly ["engineering", "product", "system"];
     };
     readonly product_strategy: {
         readonly description: "Product direction, positioning, roadmap tradeoffs, customer problems, metrics, and market learning.";
-        readonly defaultCategories: readonly ["product", "human", "system"];
+        readonly defaultCategories: readonly ["product", "engineering", "system"];
     };
     readonly business_operations: {
         readonly description: "Business process, vendors, finance, legal/admin operations, recurring procedures, and ownership.";
-        readonly defaultCategories: readonly ["product", "human", "system"];
+        readonly defaultCategories: readonly ["product", "engineering", "system"];
     };
     readonly research: {
         readonly description: "Research questions, sources, hypotheses, experiment findings, synthesis, and reusable insights.";
@@ -43,7 +39,7 @@ export declare const DOMAINS: {
     };
     readonly personal_productivity: {
         readonly description: "Individual productivity, habits, planning preferences, reminders, and personal operating context.";
-        readonly defaultCategories: readonly ["human", "product", "system"];
+        readonly defaultCategories: readonly ["engineering", "product", "system"];
     };
 };
 export type Domain = keyof typeof DOMAINS;
@@ -121,11 +117,11 @@ export declare const MEMORY_SUBTYPE_DEFAULT_CATEGORY: {
     readonly success_metric: "product";
     readonly market_insight: "product";
     readonly troubleshooting_gotcha: "engineering";
-    readonly preference: "human";
-    readonly person_profile: "human";
-    readonly ownership_note: "human";
-    readonly working_agreement: "human";
-    readonly activity_event: "human";
+    readonly preference: "engineering";
+    readonly person_profile: "engineering";
+    readonly ownership_note: "engineering";
+    readonly working_agreement: "engineering";
+    readonly activity_event: "engineering";
     readonly session_index: "system";
     readonly episode: "system";
     readonly workstream: "system";

package/dist/mcp/taxonomy.js

@@ -22,13 +22,6 @@ export const CATEGORIES = {
             "Activation should be measured by whether agents successfully reuse recalled memory.",
         ],
     },
-    human: {
-        description: "Human context: explicit preferences, people and roles, ownership, working agreements, and durable actor-action activity events.",
-        examples: [
-            "Saber prefers concise implementation plans before code changes.",
-            "Alex approved PR #85 for merge.",
-        ],
-    },
     system: {
         description: "System context: Bikky-owned lifecycle memory, session indexes, episodes, workstreams, recall/feedback/outcome telemetry, and aggregate rollups.",
         examples: [
@@ -47,7 +40,6 @@ export const DOMAINS = {
         defaultCategories: [
             "engineering",
             "product",
-            "human",
             "system",
         ],
     },
@@ -55,7 +47,7 @@ export const DOMAINS = {
         description: "Product direction, positioning, roadmap tradeoffs, customer problems, metrics, and market learning.",
         defaultCategories: [
             "product",
-            "human",
+            "engineering",
             "system",
         ],
     },
@@ -63,7 +55,7 @@ export const DOMAINS = {
         description: "Business process, vendors, finance, legal/admin operations, recurring procedures, and ownership.",
         defaultCategories: [
             "product",
-            "human",
+            "engineering",
             "system",
         ],
     },
@@ -78,7 +70,7 @@ export const DOMAINS = {
     personal_productivity: {
         description: "Individual productivity, habits, planning preferences, reminders, and personal operating context.",
         defaultCategories: [
-            "human",
+            "engineering",
             "product",
             "system",
         ],
@@ -195,11 +187,11 @@ export const MEMORY_SUBTYPE_DEFAULT_CATEGORY = {
     success_metric: "product",
     market_insight: "product",
     troubleshooting_gotcha: "engineering",
-    preference: "human",
-    person_profile: "human",
-    ownership_note: "human",
-    working_agreement: "human",
-    activity_event: "human",
+    preference: "engineering",
+    person_profile: "engineering",
+    ownership_note: "engineering",
+    working_agreement: "engineering",
+    activity_event: "engineering",
     session_index: "system",
     episode: "system",
     workstream: "system",
@@ -267,19 +259,18 @@ export const DECAY_HALF_LIFE = {
     // Software-engineering defaults.
     "engineering.software_engineering": 120,
     "product.software_engineering": 120,
-    "human.software_engineering": 180,
     "system.software_engineering": 45,
     // Other domain profiles.
+    "engineering.product_strategy": 180,
     "product.product_strategy": 180,
-    "human.product_strategy": 180,
     "system.product_strategy": 60,
+    "engineering.business_operations": 180,
     "product.business_operations": 120,
-    "human.business_operations": 180,
     "system.business_operations": 90,
     "product.research": 120,
     "engineering.research": 120,
     "system.research": 90,
-    "human.personal_productivity": 180,
+    "engineering.personal_productivity": 180,
     "product.personal_productivity": 90,
     "system.personal_productivity": 45,
 };
@@ -291,11 +282,22 @@ export const QDRANT_INDEXES = [
     { field_name: "domain", field_schema: "keyword" },
     { field_name: "kind", field_schema: "keyword" },
     { field_name: "memory_subtype", field_schema: "keyword" },
-    { field_name: "source", field_schema: "keyword" },
     { field_name: "content_hash", field_schema: "keyword" },
     { field_name: "entities", field_schema: "keyword" },
     { field_name: "workspace_id", field_schema: "keyword" },
+    // Deprecated legacy provenance fields remain indexed for fresh collections
+    // that still need to browse/filter records written before origin metadata.
+    { field_name: "source", field_schema: "keyword" },
     { field_name: "actor_id", field_schema: "keyword" },
+    { field_name: "origin.user.id", field_schema: "keyword" },
+    { field_name: "origin.user.source", field_schema: "keyword" },
+    { field_name: "origin.agent.id", field_schema: "keyword" },
+    { field_name: "origin.agent.type", field_schema: "keyword" },
+    { field_name: "origin.agent.source", field_schema: "keyword" },
+    { field_name: "origin.interface", field_schema: "keyword" },
+    { field_name: "origin.operation.action", field_schema: "keyword" },
+    { field_name: "last_operation_origin.agent.id", field_schema: "keyword" },
+    { field_name: "last_operation_origin.operation.action", field_schema: "keyword" },
     { field_name: "entity_name", field_schema: "keyword" },
     { field_name: "from_entity", field_schema: "keyword" },
     { field_name: "to_entity", field_schema: "keyword" },
@@ -318,6 +320,22 @@ export const QDRANT_INDEXES = [
     { field_name: "superseded", field_schema: "bool" },
     { field_name: "superseded_by", field_schema: "keyword" },
     { field_name: "is_bad_exemplar", field_schema: "bool" },
+    { field_name: "target_fact_id", field_schema: "keyword" },
+    { field_name: "feedback_kind", field_schema: "keyword" },
+    { field_name: "outcome", field_schema: "keyword" },
+    { field_name: "result_count", field_schema: "integer" },
+    { field_name: "scope_type", field_schema: "keyword" },
+    { field_name: "scope_value", field_schema: "keyword" },
+    { field_name: "rollup_type", field_schema: "keyword" },
+    { field_name: "rollup_generated_at", field_schema: "datetime" },
+    { field_name: "active_fact_count", field_schema: "integer" },
+    { field_name: "useful_count", field_schema: "integer" },
+    { field_name: "not_useful_count", field_schema: "integer" },
+    { field_name: "misleading_count", field_schema: "integer" },
+    { field_name: "wrong_count", field_schema: "integer" },
+    { field_name: "irrelevant_count", field_schema: "integer" },
+    { field_name: "stale_count", field_schema: "integer" },
+    { field_name: "low_confidence_count", field_schema: "integer" },
     { field_name: "useful_feedback_count", field_schema: "integer" },
     { field_name: "not_useful_feedback_count", field_schema: "integer" },
     { field_name: "recall_count", field_schema: "integer" },
@@ -347,16 +365,6 @@ export function normalizeCategory(category) {
         normalized.includes("customer") ||
         normalized === "projects")
         return "product";
-    if (normalized.includes("human") ||
-        normalized.includes("people") ||
-        normalized.includes("person") ||
-        normalized.includes("owner") ||
-        normalized.includes("team") ||
-        normalized.includes("preference") ||
-        normalized.includes("agreement") ||
-        normalized.includes("activity") ||
-        normalized.includes("actor"))
-        return "human";
     if (normalized.includes("system") ||
         normalized.includes("session") ||
         normalized.includes("episode") ||
@@ -374,7 +382,16 @@ export function normalizeCategory(category) {
         normalized.includes("code") ||
         normalized.includes("architecture") ||
         normalized.includes("troubleshoot") ||
-        normalized.includes("observation"))
+        normalized.includes("observation") ||
+        normalized.includes("human") ||
+        normalized.includes("people") ||
+        normalized.includes("person") ||
+        normalized.includes("owner") ||
+        normalized.includes("team") ||
+        normalized.includes("preference") ||
+        normalized.includes("agreement") ||
+        normalized.includes("activity") ||
+        normalized.includes("actor"))
         return "engineering";
     return DEFAULT_CATEGORY;
 }
@@ -503,15 +520,6 @@ export function getDecayHalfLife(input) {
         rawCategory.includes("market") ||
         rawCategory.includes("customer") ||
         rawCategory === "projects" ||
-        rawCategory.includes("human") ||
-        rawCategory.includes("people") ||
-        rawCategory.includes("person") ||
-        rawCategory.includes("owner") ||
-        rawCategory.includes("team") ||
-        rawCategory.includes("preference") ||
-        rawCategory.includes("agreement") ||
-        rawCategory.includes("activity") ||
-        rawCategory.includes("actor") ||
         rawCategory.includes("system") ||
         rawCategory.includes("session") ||
         rawCategory.includes("episode") ||
@@ -528,7 +536,16 @@ export function getDecayHalfLife(input) {
         rawCategory.includes("code") ||
         rawCategory.includes("architecture") ||
         rawCategory.includes("troubleshoot") ||
-        rawCategory.includes("observation");
+        rawCategory.includes("observation") ||
+        rawCategory.includes("human") ||
+        rawCategory.includes("people") ||
+        rawCategory.includes("person") ||
+        rawCategory.includes("owner") ||
+        rawCategory.includes("team") ||
+        rawCategory.includes("preference") ||
+        rawCategory.includes("agreement") ||
+        rawCategory.includes("activity") ||
+        rawCategory.includes("actor");
     if (categoryWasProvided && !categoryIsKnown) {
         return DECAY_DEFAULT_HALF_LIFE;
     }