@andre.li/memoark 0.3.1

package/dist/core/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/core/schemas.ts"],"names":[],"mappings":"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"}

package/dist/core/schemas.js

@@ -0,0 +1,229 @@
+/**
+ * Zod runtime validation schemas for LLM output
+ * Corresponds to types in types.ts but with runtime validation
+ */
+import { z } from "zod";
+// Base schemas
+export const SignalConfidenceSchema = z.enum(["direct", "paraphrased", "inferred", "speculative"]);
+// Coerce null → undefined for optional string fields (LLM sometimes outputs null)
+const optionalString = z
+    .union([z.string(), z.null()])
+    .optional()
+    .transform((v) => (v == null ? undefined : v));
+// Accept both full ISO datetime and date-only strings like "2026-05-27"
+const optionalDatetime = z
+    .union([z.string(), z.null()])
+    .optional()
+    .transform((v, ctx) => {
+    if (v == null)
+        return undefined;
+    if (/^\d{4}-\d{2}-\d{2}$/.test(v)) {
+        const normalized = `${v}T00:00:00.000Z`;
+        if (!Number.isNaN(Date.parse(normalized)))
+            return normalized;
+    }
+    if (/^\d{4}-\d{2}-\d{2}T/.test(v) && !Number.isNaN(Date.parse(v))) {
+        return v;
+    }
+    ctx.addIssue({ code: z.ZodIssueCode.custom, message: "Invalid ISO 8601 datetime" });
+    return z.NEVER;
+});
+export const SourceRefSchema = z.object({
+    platform: z.string(),
+    channel: z.string(),
+    timestamp: z.string().default(() => new Date().toISOString()),
+    message_id: optionalString,
+    thread_id: optionalString,
+    file_path: optionalString,
+    line_range: z.object({ start: z.number(), end: z.number() }).optional(),
+    attachment_id: optionalString,
+    url: optionalString,
+    raw_hash: z.string().default(""),
+    quote: z.string().default(""),
+});
+// Signal schemas
+export const EntitySchema = z.object({
+    slug: z.string(),
+    name: z.string(),
+    type: z.enum(["person", "project", "organization", "tool", "concept"]),
+    context: z.string(),
+    confidence: SignalConfidenceSchema,
+});
+export const TimelineEntrySchema = z.object({
+    date: z.string(), // ISO 8601 or partial
+    summary: z.string(),
+    entities: z.array(z.string()), // slugs
+    source: SourceRefSchema,
+    confidence: SignalConfidenceSchema,
+});
+const VALID_LINK_TYPES = [
+    "works_on",
+    "works_at",
+    "reports_to",
+    "collaborates",
+    "depends_on",
+    "mentions",
+    "custom",
+];
+export const LinkTypeSchema = z
+    .string()
+    .transform((val) => VALID_LINK_TYPES.includes(val) ? val : "custom");
+export const LinkSchema = z.object({
+    from: z.string(), // entity slug
+    to: z.string(), // entity slug
+    type: LinkTypeSchema,
+    context: z.string(),
+    confidence: SignalConfidenceSchema,
+    source: SourceRefSchema.optional().transform((v) => v ?? {
+        platform: "",
+        channel: "",
+        timestamp: new Date().toISOString(),
+        raw_hash: "",
+        quote: "",
+    }),
+});
+export const DecisionSchema = z.object({
+    summary: z.string(),
+    reasoning: optionalString,
+    alternatives: z.array(z.string()).optional(),
+    entities: z.array(z.string()),
+    date: z.string(),
+    valid_at: optionalDatetime,
+    invalid_at: optionalDatetime,
+    confidence: SignalConfidenceSchema,
+    source: SourceRefSchema,
+});
+export const TaskSignalSchema = z.object({
+    title: z.string(),
+    status: z.enum(["open", "in_progress", "done", "cancelled"]),
+    owner: optionalString,
+    project: optionalString,
+    due_date: optionalDatetime,
+    valid_at: optionalDatetime,
+    invalid_at: optionalDatetime,
+    source: SourceRefSchema,
+    confidence: SignalConfidenceSchema,
+});
+export const DiscoverySchema = z.object({
+    summary: z.string(),
+    detail: z.string().optional(),
+    type: z.enum(["procedure", "pattern", "insight", "risk"]),
+    entities: z.array(z.string()), // slugs
+    source: SourceRefSchema,
+    confidence: SignalConfidenceSchema,
+});
+export const PreferenceSchema = z.object({
+    summary: z.string(),
+    detail: optionalString,
+    category: z.enum(["communication", "tooling", "scheduling", "workflow", "other"]),
+    entities: z.array(z.string()),
+    source: SourceRefSchema,
+    confidence: SignalConfidenceSchema,
+});
+export const ReferenceSchema = z.object({
+    title: z.string(),
+    url: z.string(),
+    summary: z.string(),
+    trigger: optionalString,
+    entities: z.array(z.string()),
+    source: SourceRefSchema,
+    confidence: SignalConfidenceSchema,
+});
+export const KnowledgeSourceTypeSchema = z.enum(["conversation", "document", "teaching"]);
+function normalizeTopicSlug(raw) {
+    const slug = raw
+        .toLowerCase()
+        .replace(/[^a-z0-9一-鿿㐀-䶿]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 80);
+    if (slug)
+        return slug;
+    // Fallback: generate hash-based slug for pure non-latin text
+    let hash = 0;
+    for (let i = 0; i < raw.length; i++) {
+        hash = (hash * 31 + raw.charCodeAt(i)) >>> 0;
+    }
+    return hash.toString(16).padStart(12, "0").slice(0, 12);
+}
+export const KnowledgeSchema = z
+    .object({
+    topic: z.string().min(1).transform(normalizeTopicSlug),
+    content: z.string().min(1),
+    source_type: KnowledgeSourceTypeSchema,
+    related_entities: z.array(z.string()),
+    valid_at: optionalDatetime,
+    invalid_at: optionalDatetime,
+    source: SourceRefSchema,
+    confidence: SignalConfidenceSchema,
+})
+    .refine((k) => !k.valid_at || !k.invalid_at || k.invalid_at > k.valid_at, {
+    message: "invalid_at must be after valid_at",
+});
+// Full extraction result schema
+export const ExtractionResultSchema = z.object({
+    source: SourceRefSchema,
+    entities: z.array(EntitySchema),
+    timeline: z.array(TimelineEntrySchema),
+    links: z.array(LinkSchema),
+    decisions: z.array(DecisionSchema),
+    tasks: z.array(TaskSignalSchema),
+    discoveries: z.array(DiscoverySchema),
+    knowledge: z.array(KnowledgeSchema).default([]),
+    preferences: z.array(PreferenceSchema).default([]),
+    references: z.array(ReferenceSchema).default([]),
+});
+// Significance verdict schema (L2 judgment)
+export const SignificanceVerdictSchema = z.object({
+    worth_processing: z.boolean(),
+    reason: z.string(),
+    topics: z.array(z.string()),
+    confidence: z.number().min(0).max(1), // 0.0 to 1.0
+});
+/**
+ * Parse and validate LLM output as ExtractionResult
+ * @param raw - Raw JSON from LLM (unknown type)
+ * @returns Validated ExtractionResult
+ * @throws ZodError with clear field-level validation messages
+ */
+export function parseExtractionResult(raw) {
+    try {
+        return ExtractionResultSchema.parse(raw);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            // Enhance error messages for better debugging
+            const formattedErrors = error.errors.map((err) => {
+                const path = err.path.join(".");
+                return `${path}: ${err.message}`;
+            });
+            throw new Error(`ExtractionResult validation failed:\n${formattedErrors.join("\n")}`, {
+                cause: error,
+            });
+        }
+        throw error;
+    }
+}
+/**
+ * Parse and validate LLM output as SignificanceVerdict
+ * @param raw - Raw JSON from LLM (unknown type)
+ * @returns Validated SignificanceVerdict
+ * @throws ZodError with clear field-level validation messages
+ */
+export function parseSignificanceVerdict(raw) {
+    try {
+        return SignificanceVerdictSchema.parse(raw);
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const formattedErrors = error.errors.map((err) => {
+                const path = err.path.join(".");
+                return `${path}: ${err.message}`;
+            });
+            throw new Error(`SignificanceVerdict validation failed:\n${formattedErrors.join("\n")}`, {
+                cause: error,
+            });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=schemas.js.map

package/dist/core/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/core/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAe;AACf,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;AAEnG,kFAAkF;AAClF,MAAM,cAAc,GAAG,CAAC;KACrB,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;KAC7B,QAAQ,EAAE;KACV,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjD,wEAAwE;AACxE,MAAM,gBAAgB,GAAG,CAAC;KACvB,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;KAC7B,QAAQ,EAAE;KACV,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;IACpB,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAChC,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,GAAG,CAAC,gBAAgB,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAAE,OAAO,UAAU,CAAC;IAC/D,CAAC;IACD,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAC;IACpF,OAAO,CAAC,CAAC,KAAK,CAAC;AACjB,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7D,UAAU,EAAE,cAAc;IAC1B,SAAS,EAAE,cAAc;IACzB,SAAS,EAAE,cAAc;IACzB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvE,aAAa,EAAE,cAAc;IAC7B,GAAG,EAAE,cAAc;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAC9B,CAAC,CAAC;AAEH,iBAAiB;AACjB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IACtE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,UAAU,EAAE,sBAAsB;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,sBAAsB;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ;IACvC,MAAM,EAAE,eAAe;IACvB,UAAU,EAAE,sBAAsB;CACnC,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG;IACvB,UAAU;IACV,UAAU;IACV,YAAY;IACZ,cAAc;IACd,YAAY;IACZ,UAAU;IACV,QAAQ;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,EAAE;KACR,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAChB,gBAAsC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CACvB,CAAC;AAEpD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,cAAc;IAChC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,cAAc;IAC9B,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,UAAU,EAAE,sBAAsB;IAClC,MAAM,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,SAAS,CAC1C,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,IAAI;QACH,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,EAAE;QACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE;KACV,CACJ;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,cAAc;IACzB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5C,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,gBAAgB;IAC1B,UAAU,EAAE,gBAAgB;IAC5B,UAAU,EAAE,sBAAsB;IAClC,MAAM,EAAE,eAAe;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC5D,KAAK,EAAE,cAAc;IACrB,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,gBAAgB;IAC1B,QAAQ,EAAE,gBAAgB;IAC1B,UAAU,EAAE,gBAAgB;IAC5B,MAAM,EAAE,eAAe;IACvB,UAAU,EAAE,sBAAsB;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACzD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ;IACvC,MAAM,EAAE,eAAe;IACvB,UAAU,EAAE,sBAAsB;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,cAAc;IACtB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACjF,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,eAAe;IACvB,UAAU,EAAE,sBAAsB;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,eAAe;IACvB,UAAU,EAAE,sBAAsB;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAE1F,SAAS,kBAAkB,CAAC,GAAW;IACrC,MAAM,IAAI,GAAG,GAAG;SACb,WAAW,EAAE;SACb,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC;SACjC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,6DAA6D;IAC7D,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC;IACtD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,WAAW,EAAE,yBAAyB;IACtC,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACrC,QAAQ,EAAE,gBAAgB;IAC1B,UAAU,EAAE,gBAAgB;IAC5B,MAAM,EAAE,eAAe;IACvB,UAAU,EAAE,sBAAsB;CACnC,CAAC;KACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,QAAQ,EAAE;IACxE,OAAO,EAAE,mCAAmC;CAC7C,CAAC,CAAC;AAEL,gCAAgC;AAChC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,eAAe;IACvB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IAC/B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAChC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAClD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACjD,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,aAAa;CACpD,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,CAAC;QACH,OAAO,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,8CAA8C;YAC9C,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC/C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAChC,OAAO,GAAG,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;YACnC,CAAC,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CAAC,wCAAwC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;gBACpF,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACnD,IAAI,CAAC;QACH,OAAO,yBAAyB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC/C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAChC,OAAO,GAAG,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;YACnC,CAAC,CAAC,CAAC;YACH,MAAM,IAAI,KAAK,CAAC,2CAA2C,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE;gBACvF,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/core/signal-scoring.d.ts

@@ -0,0 +1,3 @@
+import type { CanonicalisedBlock, SignalScore } from "./types.js";
+export declare function scoreBlock(cb: CanonicalisedBlock): SignalScore;
+//# sourceMappingURL=signal-scoring.d.ts.map

package/dist/core/signal-scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-scoring.d.ts","sourceRoot":"","sources":["../../src/core/signal-scoring.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAkB,WAAW,EAAc,MAAM,YAAY,CAAC;AA+B9F,wBAAgB,UAAU,CAAC,EAAE,EAAE,kBAAkB,GAAG,WAAW,CAqD9D"}

package/dist/core/signal-scoring.js

@@ -0,0 +1,124 @@
+import { estimateTokens } from "./block-builder.js";
+import { extractQuickEntities } from "./entity-extract.js";
+const SOURCE_WEIGHTS = {
+    email: 0.9,
+    document: 0.9,
+    structured: 0.8,
+    dm: 0.7,
+    chat: 0.5,
+};
+const TAG_SCORES = {
+    sent: 0.6,
+    reply: 0.5,
+    dm: 0.6,
+};
+const WEIGHTS = {
+    token: 1.0,
+    unique_words: 1.0,
+    source: 1.5,
+    interaction: 3.0,
+    entity_density: 1.0,
+};
+const TOTAL_WEIGHT = WEIGHTS.token +
+    WEIGHTS.unique_words +
+    WEIGHTS.source +
+    WEIGHTS.interaction +
+    WEIGHTS.entity_density; // 7.5
+export function scoreBlock(cb) {
+    const text = cb.canonical_markdown;
+    const tokens = estimateTokens(text);
+    const entities = extractQuickEntities(text);
+    const token_score = scoreTokens(tokens);
+    const unique_words_score = scoreTTR(text);
+    const source_score = SOURCE_WEIGHTS[cb.source_type];
+    const interaction_score = scoreInteraction(cb.interaction_tags);
+    const entity_density_score = tokens === 0 ? 0 : Math.min(1.0, entities.length / (tokens / 100));
+    const combined = (token_score * WEIGHTS.token +
+        unique_words_score * WEIGHTS.unique_words +
+        source_score * WEIGHTS.source +
+        interaction_score * WEIGHTS.interaction +
+        entity_density_score * WEIGHTS.entity_density) /
+        TOTAL_WEIGHT;
+    let decision;
+    let drop_reason;
+    // Extra guard: extremely short, no entities, no interaction, AND low-value source → force drop
+    // Email/document/structured sources get protection (never force-dropped by extra guard)
+    if (tokens < 20 &&
+        entities.length === 0 &&
+        cb.interaction_tags.length === 0 &&
+        cb.source_type !== "email" &&
+        cb.source_type !== "document" &&
+        cb.source_type !== "structured") {
+        decision = "drop";
+        drop_reason = "extra_guard:short_no_signal";
+    }
+    else if (combined >= 0.85) {
+        decision = "admit";
+    }
+    else if (combined <= 0.15) {
+        decision = "drop";
+        drop_reason = "score_below_threshold";
+    }
+    else {
+        decision = "evaluate";
+    }
+    return {
+        token_score,
+        unique_words_score,
+        source_score,
+        interaction_score,
+        entity_density_score,
+        combined,
+        decision,
+        drop_reason,
+    };
+}
+function scoreTokens(tokens) {
+    if (tokens < 50)
+        return tokens / 50;
+    if (tokens <= 500)
+        return 1.0;
+    if (tokens <= 3000)
+        return 1.0 - (tokens - 500) / 5000;
+    return 0.5;
+}
+function scoreInteraction(tags) {
+    if (tags.length === 0)
+        return 0.5;
+    const sum = tags.reduce((acc, tag) => acc + TAG_SCORES[tag], 0);
+    return Math.min(1.0, sum);
+}
+function scoreTTR(text) {
+    if (!text.trim())
+        return 0;
+    const words = [];
+    const tokens = text.split(/\s+/).filter(Boolean);
+    for (const token of tokens) {
+        let hasOther = false;
+        for (let i = 0; i < token.length; i++) {
+            const code = token.charCodeAt(i);
+            const isCJK = (code >= 0x4e00 && code <= 0x9fff) || (code >= 0x3400 && code <= 0x4dbf);
+            if (isCJK) {
+                words.push(token[i]);
+            }
+            else {
+                hasOther = true;
+            }
+        }
+        if (hasOther) {
+            const nonCjk = token.replace(/[一-鿿㐀-䶿]/g, "");
+            if (nonCjk)
+                words.push(nonCjk.toLowerCase());
+        }
+    }
+    if (words.length === 0)
+        return 0;
+    const unique = new Set(words).size;
+    const ttr = unique / words.length;
+    if (ttr > 0.6)
+        return 1.0;
+    if (ttr < 0.2)
+        return 0.1;
+    return (ttr - 0.2) / 0.4;
+}
+//# sourceMappingURL=signal-scoring.js.map

package/dist/core/signal-scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-scoring.js","sourceRoot":"","sources":["../../src/core/signal-scoring.ts"],"names":[],"mappings":"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"}

package/dist/core/state.d.ts

@@ -0,0 +1,22 @@
+/**
+ * State directory management for DigitalBrainExtractor
+ * Ensures .memoark/ directory exists and provides path utilities
+ */
+/**
+ * Ensure state directory exists (creates .memoark/ in base directory)
+ * Uses mkdir -p equivalent to create all intermediate directories
+ *
+ * @param base - Base directory path (default: current working directory)
+ * @returns Full path to the state directory
+ */
+export declare function ensureStateDir(base?: string): string;
+/**
+ * Get full path for a state file
+ * Returns .memoark/{filename} path without creating directories
+ * Call ensureStateDir() first to ensure the directory exists
+ *
+ * @param filename - Name of the state file (e.g., 'cursors.yaml', 'checkpoints.jsonl')
+ * @returns Full path to the state file
+ */
+export declare function statePath(filename: string): string;
+//# sourceMappingURL=state.d.ts.map

package/dist/core/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGlD"}

package/dist/core/state.js

@@ -0,0 +1,32 @@
+/**
+ * State directory management for DigitalBrainExtractor
+ * Ensures .memoark/ directory exists and provides path utilities
+ */
+import { mkdirSync } from "node:fs";
+import { resolve } from "node:path";
+/**
+ * Ensure state directory exists (creates .memoark/ in base directory)
+ * Uses mkdir -p equivalent to create all intermediate directories
+ *
+ * @param base - Base directory path (default: current working directory)
+ * @returns Full path to the state directory
+ */
+export function ensureStateDir(base) {
+    const baseDir = base || process.cwd();
+    const stateDir = resolve(baseDir, ".memoark");
+    mkdirSync(stateDir, { recursive: true });
+    return stateDir;
+}
+/**
+ * Get full path for a state file
+ * Returns .memoark/{filename} path without creating directories
+ * Call ensureStateDir() first to ensure the directory exists
+ *
+ * @param filename - Name of the state file (e.g., 'cursors.yaml', 'checkpoints.jsonl')
+ * @returns Full path to the state file
+ */
+export function statePath(filename) {
+    const stateDir = resolve(process.cwd(), ".memoark");
+    return resolve(stateDir, filename);
+}
+//# sourceMappingURL=state.js.map

package/dist/core/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAa;IAC1C,MAAM,OAAO,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAE9C,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC"}