kiokuko-dsh 0.1.0

package/dist/memory/curator-trust.js

@@ -0,0 +1,58 @@
+import { GLOBAL_WORKSPACE } from './workspaces.js';
+export const CURATOR_DRAFT_VERSION = 'deterministic-v1';
+export const CURATOR_MEMORY_ACTOR = 'kiokuko-curator';
+function hasCuratorReference(value) {
+    if (typeof value !== 'string')
+        return false;
+    const suffix = `#${CURATOR_DRAFT_VERSION}`;
+    if (!value.endsWith(suffix))
+        return false;
+    const identity = value.slice(0, -suffix.length);
+    const separator = identity.lastIndexOf('@');
+    if (separator <= 0)
+        return false;
+    const revision = Number(identity.slice(separator + 1));
+    return Number.isSafeInteger(revision) && revision > 0;
+}
+function hasCuratorProjectionIdentity(entry) {
+    const scope = entry.scope;
+    const provenance = entry.provenance;
+    return entry.workspace === GLOBAL_WORKSPACE
+        && entry.revision === 1
+        && entry.createdBy === CURATOR_MEMORY_ACTOR
+        && entry.updatedAt === entry.createdAt
+        && scope.schemaVersion === 3
+        && scope.visibility === 'global'
+        && scope.retrievalScope === 'global'
+        && provenance.type === 'curator_globalize'
+        && hasCuratorReference(provenance.reference)
+        && typeof provenance.sourceWorkspace === 'string'
+        && provenance.sourceWorkspace.length > 0
+        && provenance.sourceWorkspace !== GLOBAL_WORKSPACE
+        && provenance.clientKind === CURATOR_MEMORY_ACTOR
+        && provenance.timestamp === entry.createdAt
+        && entry.tags.includes('skill:curated')
+        && entry.tags.includes(`curator:${CURATOR_DRAFT_VERSION}`);
+}
+/** Identify a current Curator projection whose provenance and lifecycle are system-verified. */
+export function isTrustedCuratorGlobalMemory(entry) {
+    return hasCuratorProjectionIdentity(entry)
+        && entry.status === 'verified'
+        && entry.trustLevel === 'system_verified'
+        && entry.verifiedAt === entry.createdAt;
+}
+/**
+ * Preserve intake compatibility for deterministic Curator rows written before
+ * Curator projections became system-verified. A replay through Curator upgrades
+ * this exact legacy lifecycle without changing its content revision.
+ */
+export function isLegacyCuratorGlobalMemory(entry) {
+    return hasCuratorProjectionIdentity(entry)
+        && entry.status === 'candidate'
+        && entry.trustLevel === 'untrusted'
+        && entry.verifiedAt === null;
+}
+export function isCuratorManagedGlobalMemory(entry) {
+    return isTrustedCuratorGlobalMemory(entry) || isLegacyCuratorGlobalMemory(entry);
+}
+//# sourceMappingURL=curator-trust.js.map

package/dist/memory/curator-trust.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curator-trust.js","sourceRoot":"","sources":["../../src/memory/curator-trust.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAA2B,CAAC;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAA0B,CAAC;AAE/D,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC3C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC;AACxD,CAAC;AAOD,SAAS,4BAA4B,CAAC,KAAwB;IAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAgC,CAAC;IACrD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAqC,CAAC;IAC/D,OAAO,KAAK,CAAC,SAAS,KAAK,gBAAgB;WACtC,KAAK,CAAC,QAAQ,KAAK,CAAC;WACpB,KAAK,CAAC,SAAS,KAAK,oBAAoB;WACxC,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;WACnC,KAAK,CAAC,aAAa,KAAK,CAAC;WACzB,KAAK,CAAC,UAAU,KAAK,QAAQ;WAC7B,KAAK,CAAC,cAAc,KAAK,QAAQ;WACjC,UAAU,CAAC,IAAI,KAAK,mBAAmB;WACvC,mBAAmB,CAAC,UAAU,CAAC,SAAS,CAAC;WACzC,OAAO,UAAU,CAAC,eAAe,KAAK,QAAQ;WAC9C,UAAU,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;WACrC,UAAU,CAAC,eAAe,KAAK,gBAAgB;WAC/C,UAAU,CAAC,UAAU,KAAK,oBAAoB;WAC9C,UAAU,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS;WACxC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;WACpC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,qBAAqB,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,4BAA4B,CAAC,KAAwB;IACnE,OAAO,4BAA4B,CAAC,KAAK,CAAC;WACrC,KAAK,CAAC,MAAM,KAAK,UAAU;WAC3B,KAAK,CAAC,UAAU,KAAK,iBAAiB;WACtC,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,SAAS,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAwB;IAClE,OAAO,4BAA4B,CAAC,KAAK,CAAC;WACrC,KAAK,CAAC,MAAM,KAAK,WAAW;WAC5B,KAAK,CAAC,UAAU,KAAK,WAAW;WAChC,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,KAAwB;IACnE,OAAO,4BAA4B,CAAC,KAAK,CAAC,IAAI,2BAA2B,CAAC,KAAK,CAAC,CAAC;AACnF,CAAC"}

package/dist/memory/curator.d.ts

@@ -0,0 +1,115 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+import { type EntryKind } from '../serialization/validate.js';
+import { type EntryRecord } from './entries.js';
+import { type Applicability, type MemoryClass, type MemorySignals } from './structured-memory.js';
+import { type KnowledgeEvidence, type KnowledgeEvidenceTier } from '../akinator/knowledge-path.js';
+import { CURATOR_DRAFT_VERSION } from './curator-trust.js';
+export { CURATOR_DRAFT_VERSION } from './curator-trust.js';
+export type CuratorDraftChange = 'portable-sections-generated' | 'project-references-normalized' | 'paths-generalized' | 'applicability-retained';
+export interface CuratorDraft {
+    version: typeof CURATOR_DRAFT_VERSION;
+    title: string;
+    summary: string;
+    body: string;
+    changes: CuratorDraftChange[];
+}
+export interface CuratorCandidate {
+    entryId: string;
+    workspace: string;
+    revision: number;
+    updatedAt: string;
+    kind: EntryKind;
+    tags: string[];
+    memoryClass?: MemoryClass;
+    applicability?: Applicability;
+    skillName: string;
+    overview: [string, string, string];
+    draft: CuratorDraft;
+    score: number;
+    reasons: string[];
+    warnings: string[];
+    knowledge: KnowledgeEvidence & {
+        skillReady: boolean;
+        readinessReasons: string[];
+    };
+}
+export interface CuratorCandidatesInput {
+    workspace?: string;
+    cwd?: string;
+    workspaces?: string[];
+    tags?: string[];
+    tagMode?: 'any' | 'all';
+    frameworks?: string[];
+    languages?: string[];
+    memoryClasses?: MemoryClass[];
+    tiers?: KnowledgeEvidenceTier[];
+    search?: string;
+    limit?: number;
+    cursor?: string;
+    skillReadyOnly?: boolean;
+    allWorkspaces?: boolean;
+    includeGlobalized?: boolean;
+}
+export interface CuratorCandidatesResult {
+    workspace: string | null;
+    candidates: CuratorCandidate[];
+    count: number;
+    truncated: boolean;
+    nextCursor: string | null;
+    totalApproximate: number;
+    securityNotice: string;
+}
+export interface CuratorFacetResult {
+    projects: Array<{
+        workspace: string;
+        name: string;
+        count: number;
+    }>;
+    tags: Array<{
+        value: string;
+        count: number;
+    }>;
+    frameworks: Array<{
+        value: string;
+        count: number;
+    }>;
+    languages: Array<{
+        value: string;
+        count: number;
+    }>;
+    memoryClasses: Array<{
+        value: MemoryClass;
+        count: number;
+    }>;
+}
+export interface GlobalizeCuratorInput {
+    workspace: string;
+    entryId: string;
+    expectedRevision: number;
+    actor?: string;
+    now?: string;
+}
+export interface GlobalizeCuratorResult {
+    candidate: CuratorCandidate;
+    global: EntryRecord;
+    idempotent: boolean;
+}
+interface StructuredMetadata {
+    memoryClass?: MemoryClass;
+    applicability?: Applicability;
+    signals?: MemorySignals;
+}
+export declare function regenerateCuratorDraft(entry: EntryRecord, metadata?: StructuredMetadata): CuratorDraft;
+export declare function curateMemoryCandidates(database: SqliteDatabase, input?: CuratorCandidatesInput): Promise<CuratorCandidatesResult>;
+export declare function curatorFacets(database: SqliteDatabase, input?: {
+    includeGlobalized?: boolean;
+    workspace?: string;
+    workspaces?: string[];
+}): CuratorFacetResult;
+export declare function globalizeCuratorCandidate(database: SqliteDatabase, input: GlobalizeCuratorInput): GlobalizeCuratorResult;
+export declare function formatCuratorCandidate(candidate: CuratorCandidate): string;
+export declare function curatorCandidateForEntry(database: SqliteDatabase, input: {
+    workspace: string;
+    entryId: string;
+}): CuratorCandidate;
+//# sourceMappingURL=curator.d.ts.map

package/dist/memory/curator.d.ts.map

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