@rubytech/create-realagent-code 0.1.583 → 0.1.585

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-realagent-code",
-  "version": "0.1.583",
+  "version": "0.1.585",
   "description": "Install Real Agent — Built for agents. By agents.",
   "bin": {
     "create-realagent-code": "./dist/index.js"

package/payload/platform/config/brand.json

@@ -5,6 +5,7 @@
   "installDir": "realagent-code",
   "configDir": ".realagent-code",
   "tagline": "Built for agents. By agents.",
+  "productMandate": "You are the back office of an estate agency. Your work is the administration behind properties, listings, viewings, offers and applicants: records kept straight, correspondence answered, progress chased, deadlines met.",
   "marketingUrl": "https://realagent.network",
   "neo4jPort": 7688,
   "ttydPort": 7682,

package/payload/platform/lib/brand-templating/dist/index.d.ts

@@ -1,18 +1,24 @@
 /**
- * Brand templating — single source of truth for the operator-visible brand name.
+ * Brand templating — single source of truth for the operator-visible brand
+ * name and the admin agent's stated purpose.
  *
  * Skills, agent templates, plugin manifests, and reference content reference
- * the brand only via the literal `{{productName}}` placeholder. This module
- * substitutes at read time from `brand.json`. Same shadow-source defect class
- * as Tasks 787/788: there is no fallback; missing or empty `productName`
- * hard-fails so the wrong brand can never reach the system prompt or the
- * operator UI silently.
+ * the brand only via literal `{{field}}` placeholders, one per entry in
+ * `BRAND_FIELDS`. This module substitutes at read time from `brand.json`. Same
+ * shadow-source defect class as Tasks 787/788: there is no fallback; a missing
+ * or empty value hard-fails so the wrong brand can never reach the system
+ * prompt or the operator UI silently.
  *
  * Used by both `platform/ui` (admin/public agent system-prompt assembly) and
  * `platform/plugins/admin/mcp` (the `plugin-read` MCP tool). Both call sites
  * pass the absolute file path as `sourcePath` so the diagnostic line names
  * exactly which file was substituted.
  */
-export declare function getBrandProductName(): string;
+/** Every brand.json field a template may reference as `{{field}}`.
+ *  Task 2646 added `productMandate`, the admin agent's stated purpose. */
+declare const BRAND_FIELDS: readonly ["productName", "productMandate"];
+export type BrandField = (typeof BRAND_FIELDS)[number];
+export declare function getBrandValue(field: BrandField): string;
 export declare function substituteBrandPlaceholders(content: string, sourcePath: string): string;
+export {};
 //# sourceMappingURL=index.d.ts.map

package/payload/platform/lib/brand-templating/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAmBH,wBAAgB,mBAAmB,IAAI,MAAM,CAsB5C;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAkBvF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH;0EAC0E;AAC1E,QAAA,MAAM,YAAY,4CAA6C,CAAC;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAiBvD,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAwBvD;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAyBvF"}

package/payload/platform/lib/brand-templating/dist/index.js

@@ -1,13 +1,14 @@
 "use strict";
 /**
- * Brand templating — single source of truth for the operator-visible brand name.
+ * Brand templating — single source of truth for the operator-visible brand
+ * name and the admin agent's stated purpose.
  *
  * Skills, agent templates, plugin manifests, and reference content reference
- * the brand only via the literal `{{productName}}` placeholder. This module
- * substitutes at read time from `brand.json`. Same shadow-source defect class
- * as Tasks 787/788: there is no fallback; missing or empty `productName`
- * hard-fails so the wrong brand can never reach the system prompt or the
- * operator UI silently.
+ * the brand only via literal `{{field}}` placeholders, one per entry in
+ * `BRAND_FIELDS`. This module substitutes at read time from `brand.json`. Same
+ * shadow-source defect class as Tasks 787/788: there is no fallback; a missing
+ * or empty value hard-fails so the wrong brand can never reach the system
+ * prompt or the operator UI silently.
  *
  * Used by both `platform/ui` (admin/public agent system-prompt assembly) and
  * `platform/plugins/admin/mcp` (the `plugin-read` MCP tool). Both call sites
@@ -15,12 +16,17 @@
  * exactly which file was substituted.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getBrandProductName = getBrandProductName;
+exports.getBrandValue = getBrandValue;
 exports.substituteBrandPlaceholders = substituteBrandPlaceholders;
 const node_path_1 = require("node:path");
 const node_fs_1 = require("node:fs");
-const PLACEHOLDER = "{{productName}}";
-let cachedProductName = null;
+/** Every brand.json field a template may reference as `{{field}}`.
+ *  Task 2646 added `productMandate`, the admin agent's stated purpose. */
+const BRAND_FIELDS = ["productName", "productMandate"];
+/** Keyed by manifest path and field, not by field alone: a process that
+ *  changes MAXY_PLATFORM_ROOT (only tests do) must not read a previous root's
+ *  value back out of the cache. */
+const cache = new Map();
 function brandJsonPath() {
     const platformRoot = process.env.MAXY_PLATFORM_ROOT;
     if (!platformRoot) {
@@ -28,10 +34,12 @@ function brandJsonPath() {
     }
     return (0, node_path_1.join)(platformRoot, "config", "brand.json");
 }
-function getBrandProductName() {
-    if (cachedProductName !== null)
-        return cachedProductName;
+function getBrandValue(field) {
     const path = brandJsonPath();
+    const key = `${path}::${field}`;
+    const cached = cache.get(key);
+    if (cached !== undefined)
+        return cached;
     if (!(0, node_fs_1.existsSync)(path)) {
         throw new Error(`[skill-loader] brand.json missing at ${path}`);
     }
@@ -42,28 +50,35 @@ function getBrandProductName() {
     catch (err) {
         throw new Error(`[skill-loader] brand.json unreadable at ${path}: ${err instanceof Error ? err.message : String(err)}`);
     }
-    const value = parsed.productName;
+    const value = parsed[field];
     if (typeof value !== "string" || value.trim() === "") {
-        throw new Error(`[skill-loader] brand.json at ${path} has missing or empty productName`);
+        throw new Error(`[skill-loader] brand.json at ${path} has missing or empty ${field}`);
     }
-    cachedProductName = value;
+    cache.set(key, value);
     return value;
 }
 function substituteBrandPlaceholders(content, sourcePath) {
-    if (!content.includes(PLACEHOLDER))
-        return content;
-    let productName;
-    try {
-        productName = getBrandProductName();
-    }
-    catch (err) {
-        console.error(`[skill-loader] ERROR: brand.json missing — cannot resolve productName for skill ${sourcePath}`);
-        throw err;
+    let out = content;
+    for (const field of BRAND_FIELDS) {
+        const placeholder = `{{${field}}}`;
+        // Per-placeholder, not per-call: a file using only one placeholder must
+        // never read the other field, so a brand.json predating a field keeps
+        // rendering every file that does not use it.
+        if (!out.includes(placeholder))
+            continue;
+        let value;
+        try {
+            value = getBrandValue(field);
+        }
+        catch (err) {
+            console.error(`[skill-loader] ERROR: brand.json missing — cannot resolve ${field} for skill ${sourcePath}`);
+            throw err;
+        }
+        // split-length counts non-overlapping literal matches without regex-escape risk.
+        const occurrences = out.split(placeholder).length - 1;
+        out = out.split(placeholder).join(value);
+        console.log(`[skill-loader] brand-substituted ${field}=${value} skill=${sourcePath} occurrences=${occurrences}`);
     }
-    // split-length counts non-overlapping literal matches without regex-escape risk.
-    const occurrences = content.split(PLACEHOLDER).length - 1;
-    const substituted = content.split(PLACEHOLDER).join(productName);
-    console.log(`[skill-loader] brand-substituted productName=${productName} skill=${sourcePath} occurrences=${occurrences}`);
-    return substituted;
+    return out;
 }
 //# sourceMappingURL=index.js.map

package/payload/platform/lib/brand-templating/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AAmBH,kDAsBC;AAED,kEAkBC;AA3DD,yCAAiC;AACjC,qCAAmD;AAEnD,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAEtC,IAAI,iBAAiB,GAAkB,IAAI,CAAC;AAE5C,SAAS,aAAa;IACpB,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACpD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,uEAAuE,CACxE,CAAC;IACJ,CAAC;IACD,OAAO,IAAA,gBAAI,EAAC,YAAY,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;AACpD,CAAC;AAED,SAAgB,mBAAmB;IACjC,IAAI,iBAAiB,KAAK,IAAI;QAAE,OAAO,iBAAiB,CAAC;IACzD,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,MAAiC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,2CAA2C,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACvG,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC;IACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,mCAAmC,CACxE,CAAC;IACJ,CAAC;IACD,iBAAiB,GAAG,KAAK,CAAC;IAC1B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAgB,2BAA2B,CAAC,OAAe,EAAE,UAAkB;IAC7E,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,OAAO,CAAC;IACnD,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC;QACH,WAAW,GAAG,mBAAmB,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,mFAAmF,UAAU,EAAE,CAChG,CAAC;QACF,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,iFAAiF;IACjF,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CACT,gDAAgD,WAAW,UAAU,UAAU,gBAAgB,WAAW,EAAE,CAC7G,CAAC;IACF,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/payload/platform/lib/brand-templating/src/__tests__/brand-templating.test.ts

@@ -0,0 +1,103 @@
+// Task 2646 — the admin identity carries a per-brand purpose, so brand.json now
+// supplies two fields rather than one. These cases pin the property that makes
+// that safe: each placeholder resolves independently, so a manifest predating a
+// field keeps rendering every file that does not use it.
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { getBrandValue, substituteBrandPlaceholders } from "../index";
+
+const roots: string[] = [];
+const previousRoot = process.env.MAXY_PLATFORM_ROOT;
+
+/** Seed a fresh platform root holding one brand.json and point the env at it.
+ *  Fresh per test, so the path-keyed cache never carries a value across. */
+function seedBrand(brand: Record<string, unknown>): string {
+  const root = mkdtempSync(join(tmpdir(), "brand-templating-"));
+  roots.push(root);
+  mkdirSync(join(root, "config"), { recursive: true });
+  writeFileSync(join(root, "config", "brand.json"), JSON.stringify(brand));
+  process.env.MAXY_PLATFORM_ROOT = root;
+  return root;
+}
+
+afterEach(() => {
+  for (const root of roots.splice(0)) rmSync(root, { recursive: true, force: true });
+  if (previousRoot === undefined) delete process.env.MAXY_PLATFORM_ROOT;
+  else process.env.MAXY_PLATFORM_ROOT = previousRoot;
+  vi.restoreAllMocks();
+});
+
+describe("substituteBrandPlaceholders", () => {
+  it("substitutes both placeholders in one pass", () => {
+    seedBrand({ productName: "Real Agent", productMandate: "You are the back office." });
+    const out = substituteBrandPlaceholders(
+      "{{productName}} — {{productMandate}}",
+      "/tmp/IDENTITY.md",
+    );
+    expect(out).toBe("Real Agent — You are the back office.");
+  });
+
+  it("never reads productMandate for content that only uses productName", () => {
+    // The regression this guards: a brand.json predating the new field must keep
+    // rendering every existing productName-only file.
+    seedBrand({ productName: "Maxy" });
+    expect(substituteBrandPlaceholders("Hello from {{productName}}", "/tmp/x.md")).toBe(
+      "Hello from Maxy",
+    );
+  });
+
+  it("returns content unchanged and logs nothing when no placeholder is present", () => {
+    seedBrand({ productName: "Maxy", productMandate: "m" });
+    const log = vi.spyOn(console, "log").mockImplementation(() => {});
+    const content = "no placeholders here";
+    expect(substituteBrandPlaceholders(content, "/tmp/x.md")).toBe(content);
+    expect(log).not.toHaveBeenCalled();
+  });
+
+  it("replaces every occurrence of the mandate placeholder", () => {
+    seedBrand({ productName: "Maxy", productMandate: "M" });
+    expect(substituteBrandPlaceholders("{{productMandate}}/{{productMandate}}", "/tmp/x.md")).toBe(
+      "M/M",
+    );
+  });
+
+  it("logs the substitution with field, value and occurrence count", () => {
+    seedBrand({ productName: "Maxy", productMandate: "M" });
+    const log = vi.spyOn(console, "log").mockImplementation(() => {});
+    substituteBrandPlaceholders("{{productMandate}} {{productMandate}}", "/tmp/IDENTITY.md");
+    expect(log).toHaveBeenCalledWith(
+      "[skill-loader] brand-substituted productMandate=M skill=/tmp/IDENTITY.md occurrences=2",
+    );
+  });
+
+  it("throws when the mandate placeholder is used and the field is missing", () => {
+    seedBrand({ productName: "Maxy" });
+    expect(() => substituteBrandPlaceholders("{{productMandate}}", "/tmp/x.md")).toThrow(
+      /missing or empty productMandate/,
+    );
+  });
+
+  it("throws when the mandate field is not a string", () => {
+    seedBrand({ productName: "Maxy", productMandate: 42 });
+    expect(() => substituteBrandPlaceholders("{{productMandate}}", "/tmp/x.md")).toThrow(
+      /missing or empty productMandate/,
+    );
+  });
+
+  it("throws when the mandate field is whitespace only", () => {
+    seedBrand({ productName: "Maxy", productMandate: "   " });
+    expect(() => substituteBrandPlaceholders("{{productMandate}}", "/tmp/x.md")).toThrow(
+      /missing or empty productMandate/,
+    );
+  });
+});
+
+describe("getBrandValue", () => {
+  it("reads each field independently from the same manifest", () => {
+    seedBrand({ productName: "SiteDesk", productMandate: "jobs" });
+    expect(getBrandValue("productName")).toBe("SiteDesk");
+    expect(getBrandValue("productMandate")).toBe("jobs");
+  });
+});

package/payload/platform/lib/brand-templating/src/index.ts

@@ -1,12 +1,13 @@
 /**
- * Brand templating — single source of truth for the operator-visible brand name.
+ * Brand templating — single source of truth for the operator-visible brand
+ * name and the admin agent's stated purpose.
  *
  * Skills, agent templates, plugin manifests, and reference content reference
- * the brand only via the literal `{{productName}}` placeholder. This module
- * substitutes at read time from `brand.json`. Same shadow-source defect class
- * as Tasks 787/788: there is no fallback; missing or empty `productName`
- * hard-fails so the wrong brand can never reach the system prompt or the
- * operator UI silently.
+ * the brand only via literal `{{field}}` placeholders, one per entry in
+ * `BRAND_FIELDS`. This module substitutes at read time from `brand.json`. Same
+ * shadow-source defect class as Tasks 787/788: there is no fallback; a missing
+ * or empty value hard-fails so the wrong brand can never reach the system
+ * prompt or the operator UI silently.
  *
  * Used by both `platform/ui` (admin/public agent system-prompt assembly) and
  * `platform/plugins/admin/mcp` (the `plugin-read` MCP tool). Both call sites
@@ -17,9 +18,15 @@
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
 
-const PLACEHOLDER = "{{productName}}";
+/** Every brand.json field a template may reference as `{{field}}`.
+ *  Task 2646 added `productMandate`, the admin agent's stated purpose. */
+const BRAND_FIELDS = ["productName", "productMandate"] as const;
+export type BrandField = (typeof BRAND_FIELDS)[number];
 
-let cachedProductName: string | null = null;
+/** Keyed by manifest path and field, not by field alone: a process that
+ *  changes MAXY_PLATFORM_ROOT (only tests do) must not read a previous root's
+ *  value back out of the cache. */
+const cache = new Map<string, string>();
 
 function brandJsonPath(): string {
   const platformRoot = process.env.MAXY_PLATFORM_ROOT;
@@ -31,13 +38,15 @@ function brandJsonPath(): string {
   return join(platformRoot, "config", "brand.json");
 }
 
-export function getBrandProductName(): string {
-  if (cachedProductName !== null) return cachedProductName;
+export function getBrandValue(field: BrandField): string {
   const path = brandJsonPath();
+  const key = `${path}::${field}`;
+  const cached = cache.get(key);
+  if (cached !== undefined) return cached;
   if (!existsSync(path)) {
     throw new Error(`[skill-loader] brand.json missing at ${path}`);
   }
-  let parsed: { productName?: unknown };
+  let parsed: Record<string, unknown>;
   try {
     parsed = JSON.parse(readFileSync(path, "utf-8"));
   } catch (err) {
@@ -45,32 +54,39 @@ export function getBrandProductName(): string {
       `[skill-loader] brand.json unreadable at ${path}: ${err instanceof Error ? err.message : String(err)}`,
     );
   }
-  const value = parsed.productName;
+  const value = parsed[field];
   if (typeof value !== "string" || value.trim() === "") {
     throw new Error(
-      `[skill-loader] brand.json at ${path} has missing or empty productName`,
+      `[skill-loader] brand.json at ${path} has missing or empty ${field}`,
     );
   }
-  cachedProductName = value;
+  cache.set(key, value);
   return value;
 }
 
 export function substituteBrandPlaceholders(content: string, sourcePath: string): string {
-  if (!content.includes(PLACEHOLDER)) return content;
-  let productName: string;
-  try {
-    productName = getBrandProductName();
-  } catch (err) {
-    console.error(
-      `[skill-loader] ERROR: brand.json missing — cannot resolve productName for skill ${sourcePath}`,
+  let out = content;
+  for (const field of BRAND_FIELDS) {
+    const placeholder = `{{${field}}}`;
+    // Per-placeholder, not per-call: a file using only one placeholder must
+    // never read the other field, so a brand.json predating a field keeps
+    // rendering every file that does not use it.
+    if (!out.includes(placeholder)) continue;
+    let value: string;
+    try {
+      value = getBrandValue(field);
+    } catch (err) {
+      console.error(
+        `[skill-loader] ERROR: brand.json missing — cannot resolve ${field} for skill ${sourcePath}`,
+      );
+      throw err;
+    }
+    // split-length counts non-overlapping literal matches without regex-escape risk.
+    const occurrences = out.split(placeholder).length - 1;
+    out = out.split(placeholder).join(value);
+    console.log(
+      `[skill-loader] brand-substituted ${field}=${value} skill=${sourcePath} occurrences=${occurrences}`,
     );
-    throw err;
   }
-  // split-length counts non-overlapping literal matches without regex-escape risk.
-  const occurrences = content.split(PLACEHOLDER).length - 1;
-  const substituted = content.split(PLACEHOLDER).join(productName);
-  console.log(
-    `[skill-loader] brand-substituted productName=${productName} skill=${sourcePath} occurrences=${occurrences}`,
-  );
-  return substituted;
+  return out;
 }

package/payload/platform/lib/brand-templating/tsconfig.json

@@ -4,5 +4,6 @@
     "outDir": "dist",
     "rootDir": "src"
   },
-  "include": ["src"]
+  "include": ["src"],
+  "exclude": ["src/__tests__"]
 }

package/payload/platform/lib/brand-templating/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    globals: false,
+    include: ["src/__tests__/**/*.test.ts"],
+  },
+});

package/payload/platform/lib/telegram-reach/dist/index.d.ts

@@ -77,4 +77,10 @@ export declare function collectTelegramReach(input: {
     storeDir: string;
     bots: ReachBotInput[];
 }): ReachResult;
+/** The brand's Telegram message store root, for a given platform root.
+ *
+ *  The ONE derivation of this path. `ui/app/lib/telegram/message-store.ts`
+ *  writes under it and `plugins/telegram/mcp` reads under it, both through this
+ *  function, so the writer and the reader cannot name different directories. */
+export declare function telegramStoreRoot(platformRoot: string): string;
 //# sourceMappingURL=index.d.ts.map

package/payload/platform/lib/telegram-reach/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwBA;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;;6EAK6E;AAC7E,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;;kEAKkE;AAClE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ/D;AAED;;;;;WAKW;AACX,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED;4DAC4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB;+CAC2C;IAC3C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qEAAqE;IACrE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;4EACwE;IACxE,KAAK,EAAE,OAAO,CAAC;IACf,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gFAAgF;IAChF,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB;;;;4BAIwB;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AA+FD;iEACiE;AACjE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,EAAE,CAAC;CACvB,GAAG,WAAW,CAsCd"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;;6EAK6E;AAC7E,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;;kEAKkE;AAClE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ/D;AAED;;;;;WAKW;AACX,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED;4DAC4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB;+CAC2C;IAC3C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,qEAAqE;IACrE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;4EACwE;IACxE,KAAK,EAAE,OAAO,CAAC;IACf,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gFAAgF;IAChF,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB;;;;4BAIwB;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AA+FD;iEACiE;AACjE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,EAAE,CAAC;CACvB,GAAG,WAAW,CAsCd;AAqBD;;;;gFAIgF;AAChF,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAG9D"}

package/payload/platform/lib/telegram-reach/dist/index.js

@@ -5,6 +5,7 @@ exports.isBusinessChannelKey = isBusinessChannelKey;
 exports.channelKeyToFileStem = channelKeyToFileStem;
 exports.fileStemToChannelKey = fileStemToChannelKey;
 exports.collectTelegramReach = collectTelegramReach;
+exports.telegramStoreRoot = telegramStoreRoot;
 /**
  * Task 2625 — which Telegram chats a registered bot can already message.
  *
@@ -22,11 +23,16 @@ exports.collectTelegramReach = collectTelegramReach;
  * re-exports it, so the store that writes a filename and the walk that reads one
  * cannot disagree.
  *
- * Path-free by construction: the caller passes `storeDir`. The plugin derives it
- * from PLATFORM_ROOT and the server from the brand config dir, and neither
- * derivation belongs in a library that must not know what a brand is.
+ * `collectTelegramReach` takes `storeDir` from its caller, but the DERIVATION of
+ * that directory lives here too, in `telegramStoreRoot`. Task 2625 left it to
+ * each caller on the grounds that a library must not know what a brand is, and
+ * the two callers promptly disagreed: the webhook wrote the brand config dir
+ * while `telegram-reach` read the brand install dir, so the tool reported every
+ * chat unreachable and named its own live sender as never having messaged
+ * (Task 2644). One derivation, for the same reason the filename rule is here.
  */
 const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
 const node_path_1 = require("node:path");
 /**
  * Is this a channel key that can safely become a path segment?
@@ -208,4 +214,33 @@ function collectTelegramReach(input) {
     });
     return { bots, storeRows };
 }
+/** The brand's config directory NAME, from its own brand.json.
+ *
+ *  Resolved WITHOUT the platform's `paths.ts`, which throws at module init on a
+ *  brand.json missing a port field. The inbound Telegram webhook imports this
+ *  path, so a throw here takes delivery down; a brand.json that cannot be read
+ *  falls back to `.maxy` instead. */
+function configDirName(platformRoot) {
+    const brandPath = (0, node_path_1.join)(platformRoot, "config", "brand.json");
+    if ((0, node_fs_1.existsSync)(brandPath)) {
+        try {
+            const parsed = JSON.parse((0, node_fs_1.readFileSync)(brandPath, "utf8"));
+            if (typeof parsed.configDir === "string")
+                return parsed.configDir;
+        }
+        catch {
+            // A brand.json that will not parse falls back rather than throwing.
+        }
+    }
+    return ".maxy";
+}
+/** The brand's Telegram message store root, for a given platform root.
+ *
+ *  The ONE derivation of this path. `ui/app/lib/telegram/message-store.ts`
+ *  writes under it and `plugins/telegram/mcp` reads under it, both through this
+ *  function, so the writer and the reader cannot name different directories. */
+function telegramStoreRoot(platformRoot) {
+    const brandDir = process.env.MAXY_DIR_OVERRIDE ?? (0, node_path_1.resolve)((0, node_os_1.homedir)(), configDirName(platformRoot));
+    return (0, node_path_1.join)(brandDir, "data", "telegram-messages");
+}
 //# sourceMappingURL=index.js.map

package/payload/platform/lib/telegram-reach/dist/index.js.map

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

package/payload/platform/lib/telegram-reach/src/__tests__/telegram-reach.test.ts

@@ -1,6 +1,6 @@
 import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { mkdtempSync, writeFileSync, rmSync } from "node:fs";
-import { tmpdir } from "node:os";
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { tmpdir, homedir } from "node:os";
 import { join } from "node:path";
 import {
   collectTelegramReach,
@@ -8,6 +8,7 @@ import {
   isBusinessChannelKey,
   channelKeyToFileStem,
   fileStemToChannelKey,
+  telegramStoreRoot,
 } from "../index.js";
 
 const BOT = "8801383568";
@@ -214,3 +215,54 @@ describe("collectTelegramReach", () => {
     expect(out.bots[0].chats.map((c) => c.senderId)).toEqual([NEO, KIT, "5555555555"]);
   });
 });
+
+describe("telegramStoreRoot", () => {
+  let root: string;
+
+  beforeEach(() => {
+    root = mkdtempSync(join(tmpdir(), "tg-store-root-"));
+    delete process.env.MAXY_DIR_OVERRIDE;
+  });
+
+  afterEach(() => {
+    delete process.env.MAXY_DIR_OVERRIDE;
+    rmSync(root, { recursive: true, force: true });
+  });
+
+  function writeBrand(configDir: unknown): string {
+    const platformRoot = join(root, "platform");
+    mkdirSync(join(platformRoot, "config"), { recursive: true });
+    writeFileSync(
+      join(platformRoot, "config", "brand.json"),
+      typeof configDir === "string" ? JSON.stringify({ configDir }) : "{ not json",
+      "utf8",
+    );
+    return platformRoot;
+  }
+
+  it("reads configDir from brand.json", () => {
+    expect(telegramStoreRoot(writeBrand(".maxy-code"))).toBe(
+      join(homedir(), ".maxy-code", "data", "telegram-messages"),
+    );
+  });
+
+  it("falls back to .maxy when brand.json is absent", () => {
+    const platformRoot = join(root, "platform");
+    mkdirSync(platformRoot, { recursive: true });
+    expect(telegramStoreRoot(platformRoot)).toBe(
+      join(homedir(), ".maxy", "data", "telegram-messages"),
+    );
+  });
+
+  it("falls back to .maxy when brand.json is unparseable, without throwing", () => {
+    expect(telegramStoreRoot(writeBrand(null))).toBe(
+      join(homedir(), ".maxy", "data", "telegram-messages"),
+    );
+  });
+
+  it("MAXY_DIR_OVERRIDE wins over brand.json", () => {
+    const platformRoot = writeBrand(".maxy-code");
+    process.env.MAXY_DIR_OVERRIDE = root;
+    expect(telegramStoreRoot(platformRoot)).toBe(join(root, "data", "telegram-messages"));
+  });
+});