@rubytech/create-sitedesk-code 0.1.446 → 0.1.448

package/payload/platform/plugins/voice-mirror/mcp/dist/lib/voice-corpus.js

@@ -0,0 +1,138 @@
+/**
+ * Cypher fragment that excludes trashed nodes for the given alias.
+ *
+ * Mirrors the platform's soft-delete model: a node is trashed if it
+ * carries the `:Trashed` label OR a non-null `deletedAt` timestamp.
+ * Inlined here (Task 473) instead of imported from
+ * `platform/lib/graph-trash` — the cross-package import path did not
+ * survive `tsc` emit (the `rootDir: "src"` config collapsed
+ * `../../../../../platform/...` to `../../...`, pointing the dist
+ * file at a non-existent location and crashing the MCP on boot). The
+ * predicate is one line; copying it costs less than the build coupling.
+ */
+export function notTrashed(alias) {
+    return `(NOT \`${alias}\`:Trashed AND \`${alias}\`.deletedAt IS NULL)`;
+}
+/**
+ * Shared corpus-filter clauses and format helpers for the voice-mirror tools.
+ *
+ * Imported by `voice-distil-profile` (count + sample walks),
+ * `voice-retrieve-conditioning` (exemplar walk), `voice-tag-content` (tag
+ * writes), and `voice-ingest-session-text` (on-demand session-text ingest). The single
+ * load-bearing filter — when the corpus rules change, this is the only place
+ * to edit.
+ *
+ * Three predicates in VOICE_CORPUS_WHERE:
+ *
+ *   1. `authorshipMode IN ['human-only', 'human-led-agent-assisted']`.
+ *      `human-only` is the operator's own writing verbatim;
+ *      `human-led-agent-assisted` is operator-authored with light agent
+ *      polish, which still carries voice signal (the operator chose the
+ *      claims and the structure). Including this expands the available
+ *      corpus to match how most modern writing actually happens.
+ *
+ *   2. Label is one of the four primary content labels OR is a
+ *      conversation-document `:Section` chunk (unguarded chat voice from
+ *      WhatsApp / Telegram / Signal / Granola / Otter / Circleback etc.
+ *      archives). After the Task 324 collapse, conversation transcripts
+ *      land as `:KnowledgeDocument` parents carrying `conversationIdentity`
+ *      with plain `:Section` children — no `:Conversation` secondary label.
+ *      Conversation-document sections are identified by their parent's
+ *      `conversationIdentity` property via an EXISTS sub-pattern. The
+ *      conversation parent must itself be live — a trashed parent excludes
+ *      its child chunks.
+ *      Chat captures voice in a way email rarely does — this is the
+ *      single highest-leverage corpus addition for voice fidelity.
+ *
+ *   3. The node is not trashed — `notTrashed("n")` filters both the
+ *      `:Trashed` label and the `deletedAt` property (Task 472). This is
+ *      the read-side equivalent of `graph-trash`'s soft-delete model: a
+ *      node marked by either signal is excluded from every voice-mirror
+ *      walk that goes through VOICE_CORPUS_WHERE.
+ *
+ * The clause expects `$accountId` to be bound in the calling Cypher
+ * parameters. It does not bind any other parameters.
+ */
+export const VOICE_CORPUS_WHERE = `n.accountId = $accountId
+  AND n.authorshipMode IN ['human-only', 'human-led-agent-assisted']
+  AND ${notTrashed("n")}
+  AND (
+    any(lbl IN labels(n) WHERE lbl IN ['KnowledgeDocument', 'Message', 'SocialPost'])
+    OR ('Section' IN labels(n) AND EXISTS {
+      MATCH (parent:KnowledgeDocument)-[:HAS_SECTION]->(n)
+      WHERE parent.conversationIdentity IS NOT NULL
+        AND ${notTrashed("parent")}
+    })
+  )`;
+/**
+ * The label set the tag tool accepts when stamping `authorshipMode`.
+ * Mirrors the label predicate inside VOICE_CORPUS_WHERE so the tag tool
+ * and the corpus walk stay in lockstep. The tag tool does not filter
+ * by authorshipMode (that's the property it's setting).
+ *
+ * `:Email` retired with Task 321 — email threads now land as
+ * `:KnowledgeDocument {source:'email'}` and are already covered.
+ */
+export const TAGGABLE_PRIMARY_LABELS = [
+    "KnowledgeDocument",
+    "Message",
+    "SocialPost",
+];
+/**
+ * Closed enum of writing-format values. One `:VoiceProfile` exists per
+ * `(accountId, userId, format)`. Adding a new value is a separate task.
+ *
+ * Format is an editorial classification set by the operator at tag time.
+ * The only auto-tagged path is `voice-ingest-session-text`, which hard-codes
+ * `format='text'` on `:Message` because chat turns are unambiguously text and
+ * the operator is not in the loop on session end.
+ */
+export const FORMAT_VALUES = [
+    "text",
+    "email",
+    "social-post",
+    "article",
+    "marketing-copy",
+    "note",
+];
+/**
+ * Returns VOICE_CORPUS_WHERE with an additional `n.format = $format`
+ * predicate appended. Requires `$format` to be bound alongside `$accountId`
+ * in the calling Cypher parameters.
+ *
+ * Format-discovery queries (which enumerate distinct formats from the
+ * corpus) use the base `VOICE_CORPUS_WHERE` directly; per-format corpus
+ * walks use this function.
+ */
+export function voiceCorpusWhereWithFormat(format) {
+    return `${VOICE_CORPUS_WHERE}\n  AND n.format = $format`;
+}
+/**
+ * Reserved sentinel userId for the per-account org voice profile (Task 676).
+ *
+ * Keeps the `(accountId, userId, format)` UNIQUE constraint valid with no
+ * migration: exactly one org profile per `(account, format)`. A real
+ * `:AdminUser` must never hold this userId — `voice-distil-profile` surfaces
+ * a Neo4j constraint error (does not swallow it) if one does.
+ */
+export const ORG_USER_ID = "__org__";
+/**
+ * The profile-key userId for a scope: the operator's own id for personal, the
+ * reserved sentinel for org. The single place that maps scope → key userId, so
+ * distillation, retrieval, and feedback agree on where an org profile lives.
+ */
+export function profileUserIdForScope(scope, userId) {
+    return scope === "org" ? ORG_USER_ID : userId;
+}
+/**
+ * `VOICE_CORPUS_WHERE` + format predicate + author predicate. Requires both
+ * `$format` and `$voiceAuthor` bound in the calling Cypher parameters.
+ *
+ * Personal distillation and personal retrieval use this to narrow the
+ * account-wide corpus to one author's content; org walks use the unchanged
+ * account-wide `voiceCorpusWhereWithFormat`.
+ */
+export function voiceCorpusWhereWithFormatAndAuthor(format) {
+    return `${VOICE_CORPUS_WHERE}\n  AND n.format = $format\n  AND n.voiceAuthor = $voiceAuthor`;
+}
+//# sourceMappingURL=voice-corpus.js.map

package/payload/platform/plugins/voice-mirror/mcp/dist/lib/voice-corpus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-corpus.js","sourceRoot":"","sources":["../../src/lib/voice-corpus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,UAAU,KAAK,oBAAoB,KAAK,uBAAuB,CAAC;AACzE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;QAE1B,UAAU,CAAC,GAAG,CAAC;;;;;;cAMT,UAAU,CAAC,QAAQ,CAAC;;IAE9B,CAAC;AAEL;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,mBAAmB;IACnB,SAAS;IACT,YAAY;CACJ,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM;IACN,OAAO;IACP,aAAa;IACb,SAAS;IACT,gBAAgB;IAChB,MAAM;CACE,CAAC;AAIX;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAmB;IAC5D,OAAO,GAAG,kBAAkB,4BAA4B,CAAC;AAC3D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AAUrC;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAiB,EAAE,MAAc;IACrE,OAAO,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mCAAmC,CAAC,MAAmB;IACrE,OAAO,GAAG,kBAAkB,gEAAgE,CAAC;AAC/F,CAAC"}

package/payload/platform/plugins/voice-mirror/mcp/dist/tools/voice-distil-profile.d.ts

@@ -0,0 +1,90 @@
+import { type VoiceFormat, type VoiceScope } from "../lib/voice-corpus.js";
+export interface VoiceDistilProfileParams {
+    accountId: string;
+    userId: string;
+    /**
+     * Profile scope (Task 676). `'personal'` (default) distils the operator's
+     * own author-filtered corpus onto `:AdminUser`; `'org'` distils the whole
+     * account onto `:LocalBusiness` under the reserved sentinel userId.
+     */
+    scope?: VoiceScope;
+    force?: boolean;
+    /**
+     * Writing format to distil. When omitted on `sample`, enumerates distinct
+     * format values in the corpus and distils each that fires the cadence
+     * guard. Required on `amend` and `write`.
+     */
+    format?: VoiceFormat;
+    /**
+     * Operation mode:
+     *   - `'sample'` (default, Task 424) — walk the full per-format corpus and
+     *     return exemplars + feedback intents. No write. The calling agent
+     *     composes the style-card YAML in-turn.
+     *   - `'write'` (Task 424) — persist the style card the agent produced.
+     *     Requires `styleCardYaml`. Optional `amendedFromNodeIds` adds
+     *     `LEARNED_FROM` edges to the named nodes (additive — MERGE preserves
+     *     prior edges).
+     *   - `'amend'` (Task 472) — operator-initiated incremental update from
+     *     one or more named documents. Reads only those nodes plus the
+     *     existing `:VoiceProfile.styleCard` so the agent can decide whether
+     *     the document moves the profile. Format predicate is dropped on the
+     *     read (the operator picked the docs); `authorshipMode` + trashed +
+     *     label predicates still apply per-document. Cadence guard does not
+     *     apply.
+     */
+    mode?: "sample" | "write" | "amend";
+    /** Required when `mode='write'`. The style-card YAML produced by the agent. */
+    styleCardYaml?: string;
+    /**
+     * Required when `mode='amend'`. ElementIds of the documents to fold into
+     * the profile. Each id is eligibility-checked; ineligible ones are
+     * reported in the return payload (the agent surfaces them to the operator).
+     */
+    nodeIds?: string[];
+    /**
+     * Optional on `mode='write'` after an `amend` sample. ElementIds the
+     * agent decided moved the profile. Each becomes a `LEARNED_FROM` edge
+     * from the persisted `:VoiceProfile`. Additive — pre-existing edges
+     * remain via `MERGE`.
+     */
+    amendedFromNodeIds?: string[];
+}
+export interface VoiceCorpusExemplar {
+    id: string;
+    label: string;
+    body: string;
+}
+export interface VoiceDistilProfileResult {
+    profileId: string | null;
+    corpusSize: number;
+    generatedAt: string | null;
+    feedbackEntries: number;
+    skipped: boolean;
+    /** Present only on the multi-format path: the format this result was distilled for. */
+    format?: VoiceFormat;
+    skipReason?: "below-threshold" | "recent" | "empty-corpus" | "missing-style-card" | "no-format-tagged-content" | "amend-no-eligible-documents";
+    errorReason?: string;
+    /** Present when `mode='sample'` or `mode='amend'`: corpus exemplars for the agent to read. */
+    exemplars?: VoiceCorpusExemplar[];
+    /** Present when `mode='sample'` or `mode='amend'`: operator-edit intents to fold into the style card. */
+    feedbackIntents?: string[];
+    /**
+     * Present when `mode='amend'`: the current `:VoiceProfile.styleCard` (or
+     * null if no profile exists yet) so the agent can compare the named
+     * documents against the prior card and decide update-or-skip.
+     */
+    existingStyleCard?: string | null;
+    /** Present when `mode='amend'`: count of input nodeIds that passed eligibility. */
+    eligible?: number;
+    /**
+     * Present when `mode='amend'`: per-input-id ineligibility records. Each
+     * entry names the nodeId and the first failing predicate so the agent
+     * can tell the operator which documents were rejected and why.
+     */
+    ineligible?: {
+        nodeId: string;
+        reason: string;
+    }[];
+}
+export declare function voiceDistilProfile(params: VoiceDistilProfileParams): Promise<VoiceDistilProfileResult | VoiceDistilProfileResult[]>;
+//# sourceMappingURL=voice-distil-profile.d.ts.map

package/payload/platform/plugins/voice-mirror/mcp/dist/tools/voice-distil-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-distil-profile.d.ts","sourceRoot":"","sources":["../../src/tools/voice-distil-profile.ts"],"names":[],"mappings":"AA4BA,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AA0BhC,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IACpC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EACP,iBAAiB,GACjB,QAAQ,GACR,cAAc,GACd,oBAAoB,GACpB,0BAA0B,GAC1B,6BAA6B,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8FAA8F;IAC9F,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,yGAAyG;IACzG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnD;AA8jBD,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,wBAAwB,GAAG,wBAAwB,EAAE,CAAC,CAuGhE"}