@runcore-sh/runcore 0.3.1 → 0.4.0

package/dist/config/schema.js

@@ -0,0 +1,93 @@
+import { z } from "zod";
+// ── Sub-schemas ─────────────────────────────────────────────────────────────
+const DatabaseSchema = z.object({
+    url: z.string().default(""),
+    poolMin: z.number().int().min(0).default(2),
+    poolMax: z.number().int().min(1).default(10),
+});
+const ApiSchema = z.object({
+    port: z.number().int().min(0).max(65535).default(0),
+    cors: z.array(z.string()).default(["*"]),
+    trustProxy: z.boolean().default(false),
+});
+const LoggingSchema = z.object({
+    level: z.enum(["trace", "debug", "info", "warn", "error", "fatal"]).default("warn"),
+    format: z.enum(["json", "pretty"]).default("pretty"),
+});
+const FeaturesSchema = z.record(z.string(), z.boolean()).default({});
+const BuildSchema = z.object({
+    outDir: z.string().default("dist"),
+    sourceMaps: z.boolean().default(true),
+    minify: z.boolean().default(false),
+});
+// ── Unified config schema ───────────────────────────────────────────────────
+export const ProjectConfigSchema = z.object({
+    projectName: z.string().default("runcore"),
+    environment: z.enum(["dev", "staging", "prod", "test"]).default("dev"),
+    brainDir: z.string().default("./brain"),
+    dataDir: z.string().default(".core"),
+    encrypt: z.boolean().default(false),
+    safeWord: z.string().optional(),
+    database: DatabaseSchema.default(() => ({ url: "", poolMin: 2, poolMax: 10 })),
+    api: ApiSchema.default(() => ({ port: 0, cors: ["*"], trustProxy: false })),
+    logging: LoggingSchema.default(() => ({ level: "warn", format: "pretty" })),
+    features: FeaturesSchema,
+    build: BuildSchema.default(() => ({ outDir: "dist", sourceMaps: true, minify: false })),
+});
+export function parseConfig(raw) {
+    return ProjectConfigSchema.parse(raw);
+}
+export function safeParseConfig(raw) {
+    return ProjectConfigSchema.safeParse(raw);
+}
+export function configFromEnv(env = process.env, overrides = {}) {
+    const raw = {
+        projectName: env.CORE_PROJECT_NAME,
+        environment: env.NODE_ENV === "production" ? "prod"
+            : env.NODE_ENV === "staging" ? "staging"
+                : env.NODE_ENV === "test" ? "test"
+                    : env.NODE_ENV === "development" ? "dev"
+                        : env.CORE_ENV,
+        brainDir: env.CORE_HOME,
+        dataDir: env.CORE_DATA,
+        encrypt: env.CORE_ENCRYPT === "true" ? true : undefined,
+        safeWord: env.CORE_SAFE_WORD,
+        database: {
+            url: env.DATABASE_URL,
+            poolMin: env.DB_POOL_MIN ? parseInt(env.DB_POOL_MIN, 10) : undefined,
+            poolMax: env.DB_POOL_MAX ? parseInt(env.DB_POOL_MAX, 10) : undefined,
+        },
+        api: {
+            port: env.CORE_PORT ? parseInt(env.CORE_PORT, 10) : undefined,
+            cors: env.CORS_ORIGINS ? env.CORS_ORIGINS.split(",") : undefined,
+            trustProxy: env.TRUST_PROXY === "true" ? true : undefined,
+        },
+        logging: {
+            level: env.LOG_LEVEL,
+            format: env.LOG_FORMAT,
+        },
+        features: env.FEATURE_FLAGS ? JSON.parse(env.FEATURE_FLAGS) : undefined,
+        build: {
+            outDir: env.BUILD_OUT_DIR,
+            sourceMaps: env.BUILD_SOURCE_MAPS === "false" ? false : undefined,
+            minify: env.BUILD_MINIFY === "true" ? true : undefined,
+        },
+    };
+    const cleaned = JSON.parse(JSON.stringify(raw));
+    const merged = deepMerge(cleaned, overrides);
+    return ProjectConfigSchema.parse(merged);
+}
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const sv = source[key];
+        if (sv !== undefined && sv !== null && typeof sv === "object" && !Array.isArray(sv)) {
+            result[key] = deepMerge(result[key] ?? {}, sv);
+        }
+        else if (sv !== undefined) {
+            result[key] = sv;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+EAA+E;AAE/E,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC;IACxC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACnF,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;CACrD,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAErE,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IAClC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACnC,CAAC,CAAC;AAEH,+EAA+E;AAE/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1C,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9E,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAe,EAAE,MAAM,EAAE,QAAiB,EAAE,CAAC,CAAC;IAC7F,QAAQ,EAAE,cAAc;IACxB,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;CACxF,CAAC,CAAC;AAIH,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,mBAAmB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,mBAAmB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,MAA0C,OAAO,CAAC,GAAyC,EAC3F,YAAoC,EAAE;IAEtC,MAAM,GAAG,GAA4B;QACnC,WAAW,EAAE,GAAG,CAAC,iBAAiB;QAClC,WAAW,EAAE,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM;YACjD,CAAC,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS;gBACxC,CAAC,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM;oBAClC,CAAC,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK;wBACxC,CAAC,CAAC,GAAG,CAAC,QAAQ;QAChB,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,OAAO,EAAE,GAAG,CAAC,SAAS;QACtB,OAAO,EAAE,GAAG,CAAC,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACvD,QAAQ,EAAE,GAAG,CAAC,cAAc;QAC5B,QAAQ,EAAE;YACR,GAAG,EAAE,GAAG,CAAC,YAAY;YACrB,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YACpE,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;SACrE;QACD,GAAG,EAAE;YACH,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;YAC7D,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;YAChE,UAAU,EAAE,GAAG,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;SAC1D;QACD,OAAO,EAAE;YACP,KAAK,EAAE,GAAG,CAAC,SAAS;YACpB,MAAM,EAAE,GAAG,CAAC,UAAU;SACvB;QACD,QAAQ,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS;QACvE,KAAK,EAAE;YACL,MAAM,EAAE,GAAG,CAAC,aAAa;YACzB,UAAU,EAAE,GAAG,CAAC,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YACjE,MAAM,EAAE,GAAG,CAAC,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;SACvD;KACF,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,SAAoC,CAAC,CAAC;IACxE,OAAO,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,SAAS,CAChB,MAA+B,EAC/B,MAA+B;IAE/B,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACpF,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACpB,MAAM,CAAC,GAAG,CAA6B,IAAI,EAAE,EAC9C,EAA6B,CAC9B,CAAC;QACJ,CAAC;aAAM,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/dictionary/challenge.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Dictionary Protocol — Challenge mechanism.
+ *
+ * Instances can challenge dictionary entries by emitting structured signals.
+ * Challenges carry the target spec, evidence, proposed change, and confidence.
+ *
+ * Portable: signal emission is injectable via SignalEmitter interface
+ * instead of importing a specific compost module.
+ */
+/** Minimal signal result returned by the emitter. */
+export interface EmittedSignal {
+    id: string;
+}
+/**
+ * Interface for emitting compost signals.
+ * Inject an implementation that wraps your compost/emitter module.
+ * If not provided, challenges are stored locally but not emitted.
+ */
+export interface SignalEmitter {
+    emitSignal(input: {
+        signalType: string;
+        pattern: Record<string, unknown>;
+        confidence: number;
+        contextTag: string;
+    }): Promise<EmittedSignal>;
+}
+export type ChallengeCategory = "spec_feedback" | "default_value" | "glossary_term" | "protocol_change";
+export type ChallengeStatus = "pending" | "accepted" | "rejected" | "superseded" | "withdrawn";
+export interface ChallengeRequest {
+    spec: string;
+    section?: string;
+    challenge: string;
+    evidence: string;
+    proposed: string;
+    confidence: number;
+    category?: ChallengeCategory;
+}
+export interface ChallengeRecord {
+    id: string;
+    signalId: string;
+    createdAt: string;
+    category: ChallengeCategory;
+    spec: string;
+    section?: string;
+    challenge: string;
+    evidence: string;
+    proposed: string;
+    confidence: number;
+    dictionaryVersion: string;
+    status: ChallengeStatus;
+    updatedAt: string;
+}
+export declare function setChallengeLogPath(path: string): void;
+/**
+ * Submit a dictionary challenge.
+ *
+ * If a SignalEmitter is provided, emits a governance signal.
+ * Always appends a ChallengeRecord to the local challenge log.
+ */
+export declare function submitChallenge(request: ChallengeRequest, dictionaryVersion: string, emitter?: SignalEmitter): Promise<ChallengeRecord>;
+export declare function readChallenges(): Promise<ChallengeRecord[]>;
+export declare function readChallengesByStatus(status: ChallengeStatus): Promise<ChallengeRecord[]>;
+export declare function readChallengesForSpec(spec: string): Promise<ChallengeRecord[]>;
+export declare function updateChallengeStatus(challengeId: string, newStatus: ChallengeStatus): Promise<ChallengeRecord | null>;
+export declare function getCurrentChallenges(): Promise<ChallengeRecord[]>;
+//# sourceMappingURL=challenge.d.ts.map

package/dist/dictionary/challenge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"challenge.d.ts","sourceRoot":"","sources":["../../src/dictionary/challenge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,KAAK,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5B;AAID,MAAM,MAAM,iBAAiB,GACzB,eAAe,GACf,eAAe,GACf,eAAe,GACf,iBAAiB,CAAC;AAEtB,MAAM,MAAM,eAAe,GACvB,SAAS,GACT,UAAU,GACV,UAAU,GACV,YAAY,GACZ,WAAW,CAAC;AAEhB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEtD;AAQD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,EACzB,iBAAiB,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,eAAe,CAAC,CAkE1B;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAQjE;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CAG5B;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,EAAE,CAAC,CAG5B;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,eAAe,GACzB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAoBjC;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAavE"}

package/dist/dictionary/challenge.js

@@ -0,0 +1,145 @@
+/**
+ * Dictionary Protocol — Challenge mechanism.
+ *
+ * Instances can challenge dictionary entries by emitting structured signals.
+ * Challenges carry the target spec, evidence, proposed change, and confidence.
+ *
+ * Portable: signal emission is injectable via SignalEmitter interface
+ * instead of importing a specific compost module.
+ */
+import { readFile, appendFile, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { randomBytes } from "node:crypto";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("dictionary:challenge");
+// ── Local challenge log ──────────────────────────────────────────────────
+const DEFAULT_CHALLENGE_LOG = "brain/dictionary/challenges.jsonl";
+let challengeLogPath = DEFAULT_CHALLENGE_LOG;
+export function setChallengeLogPath(path) {
+    challengeLogPath = path;
+}
+function genChallengeId() {
+    return "dc_" + Date.now().toString(36) + "_" + randomBytes(4).toString("hex");
+}
+// ── Core API ─────────────────────────────────────────────────────────────
+/**
+ * Submit a dictionary challenge.
+ *
+ * If a SignalEmitter is provided, emits a governance signal.
+ * Always appends a ChallengeRecord to the local challenge log.
+ */
+export async function submitChallenge(request, dictionaryVersion, emitter) {
+    if (!request.spec)
+        throw new Error("Challenge must target a spec");
+    if (!request.challenge)
+        throw new Error("Challenge must include a description");
+    if (!request.evidence)
+        throw new Error("Challenge must include evidence");
+    if (!request.proposed)
+        throw new Error("Challenge must include a proposed alternative");
+    const confidence = Math.max(0, Math.min(1, request.confidence));
+    const category = request.category ?? "spec_feedback";
+    const now = new Date().toISOString();
+    const pattern = {
+        type: "dictionary_challenge",
+        category,
+        spec: request.spec,
+        challenge: request.challenge,
+        evidence: request.evidence,
+        proposed: request.proposed,
+        confidence,
+        dictionaryVersion,
+    };
+    if (request.section) {
+        pattern.section = request.section;
+    }
+    // Emit signal if emitter provided
+    let signalId = `local_${genChallengeId()}`;
+    if (emitter) {
+        const signal = await emitter.emitSignal({
+            signalType: "governance",
+            pattern,
+            confidence,
+            contextTag: `dictionary-challenge:${request.spec}`,
+        });
+        signalId = signal.id;
+        log.info("Dictionary challenge emitted", {
+            spec: request.spec,
+            challenge: request.challenge,
+            signalId,
+        });
+    }
+    else {
+        log.info("Dictionary challenge stored locally (no signal emitter)", {
+            spec: request.spec,
+            challenge: request.challenge,
+        });
+    }
+    const record = {
+        id: genChallengeId(),
+        signalId,
+        createdAt: now,
+        category,
+        spec: request.spec,
+        section: request.section,
+        challenge: request.challenge,
+        evidence: request.evidence,
+        proposed: request.proposed,
+        confidence,
+        dictionaryVersion,
+        status: "pending",
+        updatedAt: now,
+    };
+    await mkdir(dirname(challengeLogPath), { recursive: true });
+    await appendFile(challengeLogPath, JSON.stringify(record) + "\n", "utf-8");
+    return record;
+}
+export async function readChallenges() {
+    try {
+        const raw = await readFile(challengeLogPath, "utf-8");
+        const lines = raw.trim().split("\n").filter(Boolean);
+        return lines.map(line => JSON.parse(line)).reverse();
+    }
+    catch {
+        return [];
+    }
+}
+export async function readChallengesByStatus(status) {
+    const all = await readChallenges();
+    return all.filter(c => c.status === status);
+}
+export async function readChallengesForSpec(spec) {
+    const all = await readChallenges();
+    return all.filter(c => c.spec === spec);
+}
+export async function updateChallengeStatus(challengeId, newStatus) {
+    const all = await readChallenges();
+    const existing = all.find(c => c.id === challengeId);
+    if (!existing)
+        return null;
+    const updated = {
+        ...existing,
+        status: newStatus,
+        updatedAt: new Date().toISOString(),
+    };
+    await appendFile(challengeLogPath, JSON.stringify(updated) + "\n", "utf-8");
+    log.info("Challenge status updated", {
+        id: challengeId,
+        from: existing.status,
+        to: newStatus,
+    });
+    return updated;
+}
+export async function getCurrentChallenges() {
+    const all = await readChallenges();
+    const seen = new Set();
+    const current = [];
+    for (const record of all) {
+        if (!seen.has(record.id)) {
+            seen.add(record.id);
+            current.push(record);
+        }
+    }
+    return current;
+}
+//# sourceMappingURL=challenge.js.map

package/dist/dictionary/challenge.js.map

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

package/dist/dictionary/client.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Dictionary Protocol — Instance client.
+ *
+ * Handles dictionary sync for instances:
+ * - Check for updates on boot
+ * - Periodic checks (every 24h)
+ * - Offline-safe: uses local dictionary when remote is unreachable
+ */
+import type { Dictionary, DictionaryVersionFile, SyncResult } from "./types.js";
+export interface DictionaryClientOptions {
+    brainDir: string;
+    apiBase?: string;
+    syncIntervalMs?: number;
+}
+export declare class DictionaryClient {
+    private readonly dictDir;
+    private readonly apiBase;
+    private readonly syncIntervalMs;
+    private lastSyncCheck;
+    constructor(options: DictionaryClientOptions);
+    getLocalVersion(): Promise<string>;
+    getLocalVersionFile(): Promise<DictionaryVersionFile | null>;
+    fetchRemoteVersion(): Promise<string | null>;
+    fetchRemoteDictionary(): Promise<Dictionary | null>;
+    private applyUpdate;
+    sync(options?: {
+        force?: boolean;
+    }): Promise<SyncResult>;
+    tickCheck(): Promise<SyncResult>;
+    bootSync(): Promise<SyncResult>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/dictionary/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/dictionary/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EAErB,UAAU,EACX,MAAM,YAAY,CAAC;AAOpB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,aAAa,CAAa;gBAEtB,OAAO,EAAE,uBAAuB;IAMtC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAUlC,mBAAmB,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAS5D,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW5C,qBAAqB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;YAY3C,WAAW;IAkCnB,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAsDxD,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC;IAIhC,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC;CAGtC"}

package/dist/dictionary/client.js

@@ -0,0 +1,139 @@
+/**
+ * Dictionary Protocol — Instance client.
+ *
+ * Handles dictionary sync for instances:
+ * - Check for updates on boot
+ * - Periodic checks (every 24h)
+ * - Offline-safe: uses local dictionary when remote is unreachable
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { compareSemver } from "./versioning.js";
+import { checkCompatibility, validateDictionary } from "./compatibility.js";
+const SYNC_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const DEFAULT_API_BASE = "https://runcore.sh/api/dictionary";
+export class DictionaryClient {
+    dictDir;
+    apiBase;
+    syncIntervalMs;
+    lastSyncCheck = 0;
+    constructor(options) {
+        this.dictDir = join(options.brainDir, "dictionary");
+        this.apiBase = (options.apiBase ?? DEFAULT_API_BASE).replace(/\/$/, "");
+        this.syncIntervalMs = options.syncIntervalMs ?? SYNC_INTERVAL_MS;
+    }
+    async getLocalVersion() {
+        try {
+            const raw = await readFile(join(this.dictDir, "version.json"), "utf-8");
+            const parsed = JSON.parse(raw);
+            return parsed.version;
+        }
+        catch {
+            return "0.0.0";
+        }
+    }
+    async getLocalVersionFile() {
+        try {
+            const raw = await readFile(join(this.dictDir, "version.json"), "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    async fetchRemoteVersion() {
+        try {
+            const res = await fetch(`${this.apiBase}/version`);
+            if (!res.ok)
+                return null;
+            const data = (await res.json());
+            return data.version;
+        }
+        catch {
+            return null;
+        }
+    }
+    async fetchRemoteDictionary() {
+        try {
+            const res = await fetch(this.apiBase);
+            if (!res.ok)
+                return null;
+            const data = await res.json();
+            if (!validateDictionary(data))
+                return null;
+            return data;
+        }
+        catch {
+            return null;
+        }
+    }
+    async applyUpdate(dict) {
+        await mkdir(join(this.dictDir, "specs"), { recursive: true });
+        const now = new Date().toISOString();
+        await writeFile(join(this.dictDir, "version.json"), JSON.stringify({ version: dict.version, synced_at: now }, null, 2));
+        for (const spec of dict.specs) {
+            await writeFile(join(this.dictDir, "specs", `${spec.name}.md`), spec.content);
+        }
+        await writeFile(join(this.dictDir, "glossary.json"), JSON.stringify(dict.glossary, null, 2));
+        await writeFile(join(this.dictDir, "defaults.json"), JSON.stringify(dict.defaults, null, 2));
+        const entry = {
+            version: dict.version,
+            timestamp: now,
+            specsAdded: dict.specs.map((s) => s.name),
+            specsUpdated: [],
+            specsRemoved: [],
+            summary: `Synced dictionary v${dict.version} with ${dict.specs.length} specs`,
+        };
+        await writeFile(join(this.dictDir, "changelog.jsonl"), JSON.stringify(entry) + "\n", { flag: "a" });
+        return entry;
+    }
+    async sync(options) {
+        const localVersion = await this.getLocalVersion();
+        if (!options?.force) {
+            const now = Date.now();
+            if (this.lastSyncCheck > 0 && now - this.lastSyncCheck < this.syncIntervalMs) {
+                return { status: "current", localVersion };
+            }
+        }
+        this.lastSyncCheck = Date.now();
+        const remoteVersion = await this.fetchRemoteVersion();
+        if (remoteVersion === null) {
+            return { status: "offline", localVersion };
+        }
+        if (compareSemver(remoteVersion, localVersion) <= 0) {
+            return { status: "current", localVersion, remoteVersion };
+        }
+        const remoteDictionary = await this.fetchRemoteDictionary();
+        if (!remoteDictionary) {
+            return { status: "offline", localVersion };
+        }
+        const compat = checkCompatibility(localVersion, remoteDictionary);
+        if (!compat.compatible) {
+            const entry = {
+                version: remoteVersion,
+                timestamp: new Date().toISOString(),
+                specsAdded: [],
+                specsUpdated: [],
+                specsRemoved: [],
+                summary: `Skipped incompatible update: ${compat.breakingChanges.join("; ")}`,
+            };
+            await mkdir(this.dictDir, { recursive: true });
+            await writeFile(join(this.dictDir, "changelog.jsonl"), JSON.stringify(entry) + "\n", { flag: "a" });
+            return { status: "current", localVersion, remoteVersion };
+        }
+        const changes = await this.applyUpdate(remoteDictionary);
+        return {
+            status: "updated",
+            localVersion: remoteDictionary.version,
+            remoteVersion,
+            changes,
+        };
+    }
+    async tickCheck() {
+        return this.sync({ force: false });
+    }
+    async bootSync() {
+        return this.sync({ force: true });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/dictionary/client.js.map

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

package/dist/dictionary/compatibility.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Dictionary Protocol — Backward compatibility checks.
+ */
+import type { Dictionary, CompatibilityResult } from "./types.js";
+export declare function checkCompatibility(localVersion: string, remoteDictionary: Dictionary): CompatibilityResult;
+export declare function canCommunicate(versionA: string, versionB: string): boolean;
+export declare function validateDictionary(dict: unknown): dict is Dictionary;
+//# sourceMappingURL=compatibility.d.ts.map

package/dist/dictionary/compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/dictionary/compatibility.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGlE,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,UAAU,GAC3B,mBAAmB,CAqCrB;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI1E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,UAAU,CASpE"}

package/dist/dictionary/compatibility.js

@@ -0,0 +1,56 @@
+/**
+ * Dictionary Protocol — Backward compatibility checks.
+ */
+import { parseSemver, getBumpType } from "./versioning.js";
+export function checkCompatibility(localVersion, remoteDictionary) {
+    const remoteVersion = remoteDictionary.version;
+    const bump = getBumpType(localVersion, remoteVersion);
+    const breakingChanges = [];
+    const warnings = [];
+    if (bump === "downgrade") {
+        return {
+            compatible: false,
+            localVersion,
+            remoteVersion,
+            breakingChanges: [`Remote version ${remoteVersion} is older than local ${localVersion}`],
+            warnings: [],
+        };
+    }
+    if (bump === "major") {
+        const local = parseSemver(localVersion);
+        const remote = parseSemver(remoteVersion);
+        breakingChanges.push(`Major version bump ${local.major} -> ${remote.major} — protocol changes may be breaking`);
+    }
+    if (bump === "minor") {
+        warnings.push(`Minor version bump — new features may be available but existing behavior is preserved`);
+    }
+    return {
+        compatible: breakingChanges.length === 0,
+        localVersion,
+        remoteVersion,
+        breakingChanges,
+        warnings,
+    };
+}
+export function canCommunicate(versionA, versionB) {
+    const a = parseSemver(versionA);
+    const b = parseSemver(versionB);
+    return a.major === b.major;
+}
+export function validateDictionary(dict) {
+    if (!dict || typeof dict !== "object")
+        return false;
+    const d = dict;
+    if (typeof d.version !== "string")
+        return false;
+    if (typeof d.publishedAt !== "string")
+        return false;
+    if (!Array.isArray(d.specs))
+        return false;
+    if (!d.glossary || typeof d.glossary !== "object")
+        return false;
+    if (!d.defaults || typeof d.defaults !== "object")
+        return false;
+    return true;
+}
+//# sourceMappingURL=compatibility.js.map

package/dist/dictionary/compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../../src/dictionary/compatibility.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,UAAU,kBAAkB,CAChC,YAAoB,EACpB,gBAA4B;IAE5B,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAC/C,MAAM,IAAI,GAAG,WAAW,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IACtD,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,YAAY;YACZ,aAAa;YACb,eAAe,EAAE,CAAC,kBAAkB,aAAa,wBAAwB,YAAY,EAAE,CAAC;YACxF,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;QAC1C,eAAe,CAAC,IAAI,CAClB,sBAAsB,KAAK,CAAC,KAAK,OAAO,MAAM,CAAC,KAAK,qCAAqC,CAC1F,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,QAAQ,CAAC,IAAI,CACX,uFAAuF,CACxF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,UAAU,EAAE,eAAe,CAAC,MAAM,KAAK,CAAC;QACxC,YAAY;QACZ,aAAa;QACb,eAAe;QACf,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,QAAgB;IAC/D,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,CAAC,GAAG,IAA+B,CAAC;IAC1C,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChE,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/dictionary/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Dictionary Protocol — Barrel export.
+ *
+ * The dictionary is the canonical set of specs, patterns, and protocols
+ * that define how Core works. Published via npm, synced by instances.
+ */
+export type { Dictionary, DictionarySpec, DictionaryDefaults, DictionaryVersionFile, DictionaryChangelogEntry, Glossary, SyncResult, CompatibilityResult, } from "./types.js";
+export { parseSemver, formatSemver, compareSemver, isValidSemver, getBumpType, bumpVersion, } from "./versioning.js";
+export { checkCompatibility, canCommunicate, validateDictionary, } from "./compatibility.js";
+export { scanSpecs, publishDictionary, buildDiff, } from "./publisher.js";
+export type { PublishOptions } from "./publisher.js";
+export { DictionaryClient } from "./client.js";
+export type { DictionaryClientOptions } from "./client.js";
+export { startDictionaryUpdater, stopDictionaryUpdater, isDictionaryUpdaterRunning, getLastSyncResult, getDictionaryClient, } from "./updater.js";
+export type { DictionaryUpdaterConfig } from "./updater.js";
+export { bootSync } from "./sync.js";
+export type { SyncConfig, BootSyncResult } from "./sync.js";
+export { matchSpecs, indexSpecs, buildSpecIndex } from "./matcher.js";
+export type { IndexedSpec } from "./matcher.js";
+export { submitChallenge, readChallenges, readChallengesByStatus, readChallengesForSpec, updateChallengeStatus, getCurrentChallenges, setChallengeLogPath, } from "./challenge.js";
+export type { ChallengeCategory, ChallengeStatus, ChallengeRequest, ChallengeRecord, SignalEmitter, EmittedSignal, } from "./challenge.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/dictionary/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dictionary/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,QAAQ,EACR,UAAU,EACV,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,SAAS,GACV,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EACL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC"}

package/dist/dictionary/index.js

@@ -0,0 +1,15 @@
+/**
+ * Dictionary Protocol — Barrel export.
+ *
+ * The dictionary is the canonical set of specs, patterns, and protocols
+ * that define how Core works. Published via npm, synced by instances.
+ */
+export { parseSemver, formatSemver, compareSemver, isValidSemver, getBumpType, bumpVersion, } from "./versioning.js";
+export { checkCompatibility, canCommunicate, validateDictionary, } from "./compatibility.js";
+export { scanSpecs, publishDictionary, buildDiff, } from "./publisher.js";
+export { DictionaryClient } from "./client.js";
+export { startDictionaryUpdater, stopDictionaryUpdater, isDictionaryUpdaterRunning, getLastSyncResult, getDictionaryClient, } from "./updater.js";
+export { bootSync } from "./sync.js";
+export { matchSpecs, indexSpecs, buildSpecIndex } from "./matcher.js";
+export { submitChallenge, readChallenges, readChallengesByStatus, readChallengesForSpec, updateChallengeStatus, getCurrentChallenges, setChallengeLogPath, } from "./challenge.js";
+//# sourceMappingURL=index.js.map

package/dist/dictionary/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dictionary/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,SAAS,GACV,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGtE,OAAO,EACL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC"}