@zelari/core 0.7.12 → 1.0.0

package/dist/council/verification/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Types for deterministic post-council implementation verification.
+ */
+export type VerificationSeverity = 'error' | 'warn';
+/** Evidence ladder: claimed < grep < tool < build. */
+export type EvidenceTier = 'claimed' | 'grep' | 'tool' | 'build' | 'n/a';
+export type VerificationCheckId = 'motion.keyframes' | 'motion.transitions' | 'inline-js.budget' | 'css.dead-hook' | 'plan.reality' | 'docs.readme-stale' | 'synthesis.honesty' | 'synthesis.tier-inflation' | 'synthesis.cite-invalid' | 'synthesis.degraded-banner' | 'nfr-spec.missing';
+export interface VerificationCheckResult {
+    id: VerificationCheckId;
+    severity: VerificationSeverity;
+    ok: boolean;
+    message: string;
+    /** Evidence tier achieved by this check (deterministic checks default to grep). */
+    tier?: EvidenceTier;
+    /** project-relative path */
+    file?: string;
+    line?: number;
+    evidence?: string;
+}
+export interface NfrAnimationSpec {
+    /** Only transform and opacity in @keyframes and transitions. */
+    compositorOnly?: boolean;
+    /** Also flag layout-affecting props (grid-template-rows, padding, width, …). */
+    forbidLayoutProps?: boolean;
+}
+export interface NfrSpec {
+    version: 1;
+    /** Paths relative to project root. */
+    targets: string[];
+    animation?: NfrAnimationSpec;
+    inlineJs?: {
+        maxBytes: number;
+    };
+    /** Grep milestone descriptions for these phrases; warn if absent in targets. */
+    planFeatureKeywords?: string[];
+}
+export interface VerificationReport {
+    ok: boolean;
+    generatedAt: string;
+    runMode: 'implementation';
+    targets: string[];
+    results: VerificationCheckResult[];
+}
+export interface RunVerificationInput {
+    projectRoot: string;
+    zelariRoot: string;
+    nfrSpec?: NfrSpec | null;
+    /** Chairman synthesis text for honesty lint. */
+    synthesisText?: string;
+    /** Council run was degraded (abort/error/no writes). */
+    degradedRun?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/council/verification/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/council/verification/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD,sDAAsD;AACtD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;AAEzE,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,GAClB,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,mBAAmB,GACnB,0BAA0B,GAC1B,wBAAwB,GACxB,2BAA2B,GAC3B,kBAAkB,CAAC;AAEvB,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,mBAAmB,CAAC;IACxB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,CAAC,CAAC;IACX,sCAAsC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,gFAAgF;IAChF,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/council/verification/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for deterministic post-council implementation verification.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/council/verification/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/council/verification/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/index.d.ts

@@ -10,4 +10,5 @@ export * from './types/index.js';
 export * from './harness/index.js';
 export * from './council/index.js';
 export * from './skills/index.js';
+export * from './memory/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -15,4 +15,6 @@ export * from './harness/index.js';
 export * from './council/index.js';
 // Skills (built-in)
 export * from './skills/index.js';
+// Memory backend contract (implementation lives in the CLI)
+export * from './memory/types.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qCAAqC;AACrC,cAAc,mBAAmB,CAAC;AAElC,eAAe;AACf,cAAc,kBAAkB,CAAC;AAEjC,aAAa;AACb,cAAc,oBAAoB,CAAC;AAEnC,sCAAsC;AACtC,cAAc,oBAAoB,CAAC;AAEnC,oBAAoB;AACpB,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qCAAqC;AACrC,cAAc,mBAAmB,CAAC;AAElC,eAAe;AACf,cAAc,kBAAkB,CAAC;AAEjC,aAAa;AACb,cAAc,oBAAoB,CAAC;AAEnC,sCAAsC;AACtC,cAAc,oBAAoB,CAAC;AAEnC,oBAAoB;AACpB,cAAc,mBAAmB,CAAC;AAElC,4DAA4D;AAC5D,cAAc,mBAAmB,CAAC"}

package/dist/memory/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Memory backend contract — provider-neutral, zero-dependency.
+ *
+ * The v1.0 implementation shipped by the CLI is a file-backed keyword store
+ * (`FileMemoryBackend`, see `src/cli/memory/fileBackend.ts`). This interface
+ * is deliberately shaped so a future semantic backend (LanceDB + embeddings,
+ * or an MCP-backed palace) can be dropped in behind the same seam without
+ * touching callers — the council loop only ever sees `MemoryBackend`.
+ *
+ * Only types live here, so `@zelari/core` stays dependency-free.
+ */
+export interface MemoryChunk {
+    id: string;
+    text: string;
+    metadata: Record<string, unknown>;
+}
+export interface MemorySearchOptions {
+    /** Max results to return. Default 8. */
+    limit?: number;
+    /**
+     * Reserved for graph-aware backends (1-hop expansion). The file backend
+     * ignores this flag; it is part of the contract so semantic/graph backends
+     * can honour it later without an interface change.
+     */
+    useGraph?: boolean;
+    /**
+     * Shallow key/value match applied to each chunk's metadata. Only chunks
+     * whose metadata contains every provided key with an equal value are kept.
+     * Typically `{ projectRoot }` to keep projects isolated.
+     */
+    metadataFilter?: Record<string, unknown>;
+}
+export interface MemoryResult {
+    id: string;
+    text: string;
+    /** Relevance score (backend-defined; higher is better). */
+    score: number;
+    metadata: Record<string, unknown>;
+}
+/** Optional graph payload accepted by `add` — stored/ignored per backend. */
+export interface MemoryAddGraph {
+    entities?: Array<{
+        name: string;
+        type?: string;
+    }>;
+    relations?: Array<{
+        from: string;
+        to: string;
+        type: string;
+        weight?: number;
+    }>;
+}
+export interface MemoryBackend {
+    /** Prepare storage for a project (create dirs, open handles, …). Idempotent. */
+    init(projectRoot: string): Promise<void>;
+    /** Persist a chunk of text with optional metadata/graph. Returns its id. */
+    add(content: string, metadata?: Record<string, unknown>, graph?: MemoryAddGraph): Promise<string>;
+    /** Retrieve the most relevant chunks for a query. */
+    search(query: string, options?: MemorySearchOptions): Promise<MemoryResult[]>;
+    /** Release any resources. Safe to call multiple times. */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,4EAA4E;IAC5E,GAAG,CACD,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,KAAK,CAAC,EAAE,cAAc,GACrB,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,qDAAqD;IACrD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC9E,0DAA0D;IAC1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/memory/types.js

@@ -0,0 +1,13 @@
+/**
+ * Memory backend contract — provider-neutral, zero-dependency.
+ *
+ * The v1.0 implementation shipped by the CLI is a file-backed keyword store
+ * (`FileMemoryBackend`, see `src/cli/memory/fileBackend.ts`). This interface
+ * is deliberately shaped so a future semantic backend (LanceDB + embeddings,
+ * or an MCP-backed palace) can be dropped in behind the same seam without
+ * touching callers — the council loop only ever sees `MemoryBackend`.
+ *
+ * Only types live here, so `@zelari/core` stays dependency-free.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/memory/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zelari/core",
-  "version": "0.7.12",
+  "version": "1.0.0",
   "description": "Zelari Code core library — provider-neutral agent loop (AgentHarness), multi-agent council orchestration, and built-in skills. Used by the zelari-code CLI; consumable by other agent frontends.",
   "author": "N-THEM Studio",
   "license": "MIT",
@@ -60,6 +60,10 @@
       "types": "./dist/council/index.d.ts",
       "default": "./dist/council/index.js"
     },
+    "./memory": {
+      "types": "./dist/memory/types.d.ts",
+      "default": "./dist/memory/types.js"
+    },
     "./skills": {
       "types": "./dist/skills/index.d.ts",
       "default": "./dist/skills/index.js"