@rubytech/create-realagent-code 0.1.174 → 0.1.175

package/package.json

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

package/payload/platform/neo4j/schema.cypher

@@ -1279,13 +1279,17 @@ CREATE INDEX postal_address_postcode IF NOT EXISTS
 FOR (a:PostalAddress) ON (a.postalCode);
 
 // ----------------------------------------------------------
-// Voice Mirror (Task 356) — authorial-voice capture + application
+// Voice Mirror (Task 356 + Task 462) — authorial-voice capture + application
 // ----------------------------------------------------------
-// :VoiceProfile holds the distilled style card for one :AdminUser.
-// One profile per AdminUser; the (accountId, adminUserId) pair is unique.
+// :VoiceProfile holds the distilled style card for one (AdminUser, format).
+// Task 462: one profile per (accountId, userId, format); format ∈
+// {text, email, social-post, article, marketing-copy, note}.
+// The old (accountId, adminUserId) unique constraint is dropped and replaced.
+//
 // :VoiceEdit captures operator edits on agent drafts as feedback,
 // stamped with a Haiku-summarised intent; many edits feed back into
-// the next distillation.
+// the next distillation. VoiceEdit now carries `format` to route
+// FEEDBACK_FOR edges to the matching per-format :VoiceProfile.
 //
 // `authorshipMode` is an enum property on content-bearing labels
 // (`:KnowledgeDocument`, `:ConversationArchive` (Task 397 — every chat
@@ -1293,30 +1297,62 @@ FOR (a:PostalAddress) ON (a.postalCode);
 // `:Message`, `:SocialPost`) with
 // values `human-only | human-led-agent-assisted | agent-led-human-reviewed
 // | agent-only | unknown`. Legacy nodes default to `unknown` until
-// reviewed via the voice-mirror backfill flow. The index lets the
-// distillation walk filter on `authorshipMode = 'human-only'` cheaply.
+// reviewed via the voice-mirror backfill flow. The per-label authorship
+// index lets the distillation walk filter cheaply.
+//
+// `format` is an enum property on corpus nodes (same label set) and on
+// :VoiceProfile nodes. The per-label format index lets per-format corpus
+// walks and profile reads avoid full-label scans.
+
+// Task 462 — drop the old (accountId, adminUserId) constraint before
+// creating the new (accountId, userId, format) three-key constraint.
+// `IF EXISTS` makes the DROP idempotent on fresh installs.
+DROP CONSTRAINT voice_profile_admin_unique IF EXISTS;
 
-CREATE CONSTRAINT voice_profile_admin_unique IF NOT EXISTS
-FOR (v:VoiceProfile) REQUIRE (v.accountId, v.adminUserId) IS UNIQUE;
+CREATE CONSTRAINT voice_profile_format_unique IF NOT EXISTS
+FOR (v:VoiceProfile) REQUIRE (v.accountId, v.userId, v.format) IS UNIQUE;
 
 CREATE INDEX voice_profile_account IF NOT EXISTS
 FOR (v:VoiceProfile) ON (v.accountId);
 
-CREATE INDEX voice_edit_admin IF NOT EXISTS
-FOR (e:VoiceEdit) ON (e.adminUserId);
+CREATE INDEX voice_profile_format IF NOT EXISTS
+FOR (v:VoiceProfile) ON (v.format);
+
+CREATE INDEX voice_edit_user IF NOT EXISTS
+FOR (e:VoiceEdit) ON (e.userId);
 
 CREATE INDEX knowledge_document_authorship IF NOT EXISTS
 FOR (k:KnowledgeDocument) ON (k.authorshipMode);
 
+CREATE INDEX knowledge_document_format IF NOT EXISTS
+FOR (k:KnowledgeDocument) ON (k.format);
+
 CREATE INDEX conversation_archive_authorship IF NOT EXISTS
 FOR (c:ConversationArchive) ON (c.authorshipMode);
 
+CREATE INDEX conversation_archive_format IF NOT EXISTS
+FOR (c:ConversationArchive) ON (c.format);
+
 CREATE INDEX message_authorship IF NOT EXISTS
 FOR (m:Message) ON (m.authorshipMode);
 
+CREATE INDEX message_format IF NOT EXISTS
+FOR (m:Message) ON (m.format);
+
+// contentHash index — deduplication MERGE in voice-ingest-session-text uses
+// MERGE (n:Message {contentHash: $hash, accountId: $accountId}). Without this
+// index, each MERGE scans all :Message nodes for the account. The index on
+// contentHash alone lets neo4j narrow the lookup before applying the
+// accountId predicate.
+CREATE INDEX message_content_hash IF NOT EXISTS
+FOR (m:Message) ON (m.contentHash);
+
 CREATE INDEX social_post_authorship IF NOT EXISTS
 FOR (s:SocialPost) ON (s.authorshipMode);
 
+CREATE INDEX social_post_format IF NOT EXISTS
+FOR (s:SocialPost) ON (s.format);
+
 // :Section authorshipMode — the corpus walk includes conversation-archive
 // :Section chunks (parent :ConversationArchive) alongside ordinary
 // document sections under :KnowledgeDocument. Index on the :Section label
@@ -1325,6 +1361,9 @@ FOR (s:SocialPost) ON (s.authorshipMode);
 CREATE INDEX section_authorship IF NOT EXISTS
 FOR (s:Section) ON (s.authorshipMode);
 
+CREATE INDEX section_format IF NOT EXISTS
+FOR (s:Section) ON (s.format);
+
 CREATE INDEX social_post_account IF NOT EXISTS
 FOR (s:SocialPost) ON (s.accountId);
 

package/payload/platform/plugins/docs/references/voice-mirror-guide.md

@@ -2,7 +2,7 @@
 
 ## What It Does
 
-{{productName}} reads emails, posts, and documents that you wrote yourself, and uses them to make sure agent-drafted copy reads like you wrote it — not like generic AI prose.
+{{productName}} reads emails, posts, documents, and your own chat messages, and uses them to make sure agent-drafted copy reads like you wrote it — not like generic AI prose.
 
 Anthropic models cannot be fine-tuned. Voice mirror works by feeding the model two things alongside every drafting task:
 
@@ -11,32 +11,34 @@ Anthropic models cannot be fine-tuned. Voice mirror works by feeding the model t
 
 The model conditions on both and produces copy that reads as yours.
 
-## Setup
+Voice mirror maintains a separate profile for each type of content you write: plain text, email, social posts, articles, notes, and marketing copy. The right profile is applied automatically based on what you're drafting.
 
-### 1. Tell {{productName}} what you wrote
+## How Your Voice Is Captured
 
-Voice mirror only learns from content you genuinely authored. Everything else stays unknown until you say otherwise.
+### Automatically — from chat
+
+Every admin chat session feeds your writing into the `text` profile automatically. When the session ends, {{productName}} reads the transcript, filters out slash commands, system messages, and large paste blocks, and adds each genuine turn as a corpus entry. This happens in the background with no action needed from you.
+
+### Via backfill — from historical content
+
+Use the backfill flow to teach {{productName}} your writing from emails, documents, and social posts you've already written.
 
 In the admin chat, ask: **"Start the voice-mirror backfill."**
 
 {{productName}} asks which stream to backfill first — discrete documents (emails, posts, PDFs) or chat archives (WhatsApp, Telegram, etc.). **Pick chat archives first if you have any imported.** Chat is where your unguarded voice lives; email is the same voice in dress clothes.
 
 - **Chat archives** — tag a whole conversation in one click. {{productName}} doesn't ask about individual messages because chunks within a conversation almost always share the same voice. Options per conversation: yours, mixed (multiple authors on your side — rare), or not yours (e.g. a Slack channel where you only forwarded other people's messages).
-- **Documents and posts** — paginated 10 at a time. Tag the whole batch, a subset by number, or per-item if you want a precise label like `human-led-agent-assisted` (you wrote the content, {{productName}} polished).
+- **Documents and posts** — paginated 10 at a time. {{productName}} shows each item with its detected format (email, article, note, social-post). Tag the whole batch, a subset by number, or per-item if you want a precise label like `human-led-agent-assisted` (you wrote the content, {{productName}} polished). Override the detected format if one is wrong.
 
 Skip a batch if none qualify, or stop at any time — the next session resumes where you left off.
 
-### 2. Distil the profile
-
-Once you have at least ~20 `human-only` items tagged, ask: **"Build my voice profile."**
-
-{{productName}} reads the corpus, summarises your style as a YAML card, and saves it to the graph. It picks up your sentence rhythms, the constructions you reach for, the words you avoid.
+## Distilling Your Profile
 
-The profile re-runs automatically when your corpus grows by ≥20% or every 30 days, whichever comes first.
+Once you have corpus entries tagged (or after automatic PTY ingestion fills the `text` profile), ask: **"Build my voice profile."**
 
-### 3. Done
+{{productName}} reads the corpus for each format, summarises your style as a YAML card, and saves it to the graph. It picks up your sentence rhythms, the constructions you reach for, the words you avoid — separately for email, articles, social posts, and so on.
 
-That's it. Every agent-drafted email, social post, brochure paragraph, and prospectus section from this point conditions on your voice. You don't need to ask for it.
+The profile re-runs automatically when your corpus grows by ≥20% for any format or every 30 days, whichever comes first.
 
 ## Feedback Loop
 
@@ -50,11 +52,11 @@ Voice mirror is on by default for every drafting skill. To opt out for one, set
 
 ## What It Won't Do
 
-- **Blend voices** — one profile per person, no "Joel + Neo combined".
+- **Blend voices** — one profile set per person, no "Joel + Neo combined".
 - **Copy public figures** — voice mirror only learns from your own writing.
 - **Clone audio** — text only, no speech synthesis.
-- **Guess** — content stays `unknown` until you mark it. {{productName}} never auto-classifies your historical writing.
+- **Guess** — historical content stays `unknown` until you mark it. {{productName}} never auto-classifies your writing. (Automatic ingestion applies only to your live PTY sessions where authorship is certain.)
 
 ## Status
 
-Voice mirror shipped end-to-end. The schema, the four tools (`voice-tag-content`, `voice-distil-profile`, `voice-retrieve-conditioning`, `voice-record-feedback`), and wiring into the three live drafting surfaces (email composition, property brochures, investor data room) are all live. When no voice profile exists on the account, every drafting skill degrades gracefully — the output matches what it was before voice mirror was installed.
+Voice mirror is live end-to-end. Six corpus formats (text, email, social-post, article, note, marketing-copy), five tools (`voice-tag-content`, `voice-distil-profile`, `voice-retrieve-conditioning`, `voice-record-feedback`, `voice-ingest-session-text`), automatic PTY-turn ingestion via SessionEnd hook, and wiring into the three live drafting surfaces (email composition, property brochures, investor data room) are all live. When no voice profile exists on the account for a given format, every drafting skill degrades gracefully — the output matches what it was before voice mirror was installed.

package/payload/platform/scripts/setup-account.sh

@@ -58,6 +58,7 @@ mkdir -p "$ACCOUNT_DIR/agents/admin" "$ACCOUNT_DIR/agents/public" "$ACCOUNT_DIR/
 # to locate scripts relative to the platform installation, not the account dir.
 ACCOUNT_SETTINGS="$ACCOUNT_DIR/.claude/settings.json"
 HOOKS_PATH="\$PLATFORM_ROOT/plugins/admin/hooks"
+WRITER_CRAFT_HOOKS_PATH="\$PLATFORM_ROOT/../premium-plugins/writer-craft/hooks"
 cat > "$ACCOUNT_SETTINGS" << SETTINGS_EOF
 {
   "hooks": {
@@ -146,6 +147,13 @@ cat > "$ACCOUNT_SETTINGS" << SETTINGS_EOF
           { "type": "command", "command": "bash $HOOKS_PATH/session-end-retrospective.sh" }
         ]
       }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          { "type": "command", "command": "bash $WRITER_CRAFT_HOOKS_PATH/voice-session-end-text.sh" }
+        ]
+      }
     ]
   }
 }

package/payload/platform/scripts/verify-skill-tool-surface.sh

@@ -326,26 +326,45 @@ def main() -> int:
             )
             pairs_checked += 1
 
-    # Built-in-tool rule + WebFetch rule: sweep all specialist templates directly.
-    # These rules are orthogonal to the skill-pairing loop above — they check the
-    # specialist's own prompt body for directives that require built-in CC tools.
+    # Built-in-tool rule + WebFetch rule: sweep all agent template .md files.
+    # Covers platform specialists (SPECIALISTS_DIR) and premium-plugin agent
+    # templates (premium-plugins/*/agents/). These rules are orthogonal to the
+    # skill-pairing loop above — they check each agent's own prompt body for
+    # directives that require built-in CC tools.
     known_skills = collect_skill_names()
     builtin_checked = 0
+
+    agent_template_dirs: list[str] = []
     if os.path.isdir(SPECIALISTS_DIR):
-        for fname in sorted(os.listdir(SPECIALISTS_DIR)):
+        agent_template_dirs.append(SPECIALISTS_DIR)
+    pp_root = os.path.join(REPO_ROOT, "premium-plugins")
+    if os.path.isdir(pp_root):
+        for plugin in sorted(os.listdir(pp_root)):
+            adir = os.path.join(pp_root, plugin, "agents")
+            if os.path.isdir(adir):
+                agent_template_dirs.append(adir)
+
+    for adir in agent_template_dirs:
+        for fname in sorted(os.listdir(adir)):
             if not fname.endswith(".md"):
                 continue
-            specialist = fname[:-3]
-            spath = os.path.join(SPECIALISTS_DIR, fname)
-            tools = specialist_tools(specialist)
-            if tools is None:
+            spath = os.path.join(adir, fname)
+            fm = parse_frontmatter(spath)
+            if fm is None:
                 continue
+            specialist = fm.get("name") or fname[:-3]
+            raw = fm.get("tools", "")
+            if isinstance(raw, list):
+                tools = {t for t in raw if t}
+            else:
+                tools = {t.strip() for t in str(raw).split(",") if t.strip()}
             body = specialist_body(spath)
             for err in check_builtin_tool_rule(specialist, body, tools, known_skills):
                 errors.append(err)
             for err in check_webfetch_rule(specialist, body, tools):
                 errors.append(err)
             builtin_checked += 1
+
     summary.append(
         f"[verify] builtin-tool-check specialists_checked={builtin_checked}"
     )