@prorigo/protrak-forge 0.3.4 → 0.3.5

package/README.md

@@ -10,6 +10,7 @@ Protrak Forge is an MCP server for Protrak customization workspaces. It gives AI
 - Create or inspect query definitions used by your customization
 - Design new layouts with awareness of existing forms, widgets, and templates
 - Scaffold new entity types — Types, Lifecycles, Attributes, and RelationTypes — in one shot
+- Create notification templates using the correct Razor syntax and `@Model` variables
 
 ## Requirements
 
@@ -267,6 +268,7 @@ Once the server is connected, you can ask your assistant things like:
 - "Create a query definition for active projects assigned to the current user."
 - "Design a dashboard layout for Diary using the existing workspace patterns."
 - "Scaffold a Diary entity with an Active/Inactive lifecycle and a FarmerGatToDiary relation."
+- "Create a notification template for the Invoice type that emails the manager when an invoice is promoted to Sent."
 
 ## Workspace Detection
 

package/bin/protrak-forge.js

@@ -3223,8 +3223,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path15) {
-      let input = path15;
+    function removeDotSegments(path17) {
+      let input = path17;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -3423,8 +3423,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path15, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path15 && path15 !== "/" ? path15 : void 0;
+        const [path17, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path17 && path17 !== "/" ? path17 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -6786,12 +6786,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f;
     };
-    function addFormats(ajv, list, fs19, exportName) {
+    function addFormats(ajv, list, fs21, exportName) {
       var _a2;
       var _b;
       (_a2 = (_b = ajv.opts.code).formats) !== null && _a2 !== void 0 ? _a2 : _b.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f of list)
-        ajv.addFormat(f, fs19[f]);
+        ajv.addFormat(f, fs21[f]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -7158,8 +7158,8 @@ function getErrorMap() {
 
 // node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path15, errorMaps, issueData } = params;
-  const fullPath = [...path15, ...issueData.path || []];
+  const { data, path: path17, errorMaps, issueData } = params;
+  const fullPath = [...path17, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -7274,11 +7274,11 @@ var errorUtil;
 
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path15, key) {
+  constructor(parent, value, path17, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path15;
+    this._path = path17;
     this._key = key;
   }
   get path() {
@@ -10924,10 +10924,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path15) {
-  if (!path15)
+function getElementAtPath(obj, path17) {
+  if (!path17)
     return obj;
-  return path15.reduce((acc, key) => acc?.[key], obj);
+  return path17.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -11310,11 +11310,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path15, issues) {
+function prefixIssues(path17, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path15);
+    iss.path.unshift(path17);
     return iss;
   });
 }
@@ -20869,7 +20869,8 @@ function makeWorkspace(root, namespace) {
     formsDir: path.join(root, "Forms"),
     typeWidgetsDir: path.join(root, "TypeWidgets"),
     layoutTemplatesDir: path.join(root, "LayoutTemplates"),
-    homeLayoutsDir: path.join(root, "HomeLayouts")
+    homeLayoutsDir: path.join(root, "HomeLayouts"),
+    notificationTemplatesDir: path.join(root, "NotificationTemplates")
   };
 }
 function extractNamespace(csprojPath) {
@@ -21430,9 +21431,9 @@ var SearchableMap = class _SearchableMap {
     if (!prefix.startsWith(this._prefix)) {
       throw new Error("Mismatched prefix");
     }
-    const [node, path15] = trackDown(this._tree, prefix.slice(this._prefix.length));
+    const [node, path17] = trackDown(this._tree, prefix.slice(this._prefix.length));
     if (node === void 0) {
-      const [parentNode, key] = last(path15);
+      const [parentNode, key] = last(path17);
       for (const k of parentNode.keys()) {
         if (k !== LEAF && k.startsWith(key)) {
           const node2 = /* @__PURE__ */ new Map();
@@ -21652,18 +21653,18 @@ var SearchableMap = class _SearchableMap {
     return _SearchableMap.from(Object.entries(object3));
   }
 };
-var trackDown = (tree, key, path15 = []) => {
+var trackDown = (tree, key, path17 = []) => {
   if (key.length === 0 || tree == null) {
-    return [tree, path15];
+    return [tree, path17];
   }
   for (const k of tree.keys()) {
     if (k !== LEAF && key.startsWith(k)) {
-      path15.push([tree, k]);
-      return trackDown(tree.get(k), key.slice(k.length), path15);
+      path17.push([tree, k]);
+      return trackDown(tree.get(k), key.slice(k.length), path17);
     }
   }
-  path15.push([tree, key]);
-  return trackDown(void 0, "", path15);
+  path17.push([tree, key]);
+  return trackDown(void 0, "", path17);
 };
 var lookup = (tree, key) => {
   if (key.length === 0 || tree == null) {
@@ -21705,38 +21706,38 @@ var createPath = (node, key) => {
   return node;
 };
 var remove = (tree, key) => {
-  const [node, path15] = trackDown(tree, key);
+  const [node, path17] = trackDown(tree, key);
   if (node === void 0) {
     return;
   }
   node.delete(LEAF);
   if (node.size === 0) {
-    cleanup(path15);
+    cleanup(path17);
   } else if (node.size === 1) {
     const [key2, value] = node.entries().next().value;
-    merge2(path15, key2, value);
+    merge2(path17, key2, value);
   }
 };
-var cleanup = (path15) => {
-  if (path15.length === 0) {
+var cleanup = (path17) => {
+  if (path17.length === 0) {
     return;
   }
-  const [node, key] = last(path15);
+  const [node, key] = last(path17);
   node.delete(key);
   if (node.size === 0) {
-    cleanup(path15.slice(0, -1));
+    cleanup(path17.slice(0, -1));
   } else if (node.size === 1) {
     const [key2, value] = node.entries().next().value;
     if (key2 !== LEAF) {
-      merge2(path15.slice(0, -1), key2, value);
+      merge2(path17.slice(0, -1), key2, value);
     }
   }
 };
-var merge2 = (path15, key, value) => {
-  if (path15.length === 0) {
+var merge2 = (path17, key, value) => {
+  if (path17.length === 0) {
     return;
   }
-  const [node, nodeKey] = last(path15);
+  const [node, nodeKey] = last(path17);
   node.set(nodeKey + key, value);
   node.delete(nodeKey);
 };
@@ -23318,7 +23319,7 @@ function getClient() {
 }
 
 // src/version.ts
-var PACKAGE_VERSION = "0.3.4";
+var PACKAGE_VERSION = "0.3.5";
 
 // src/tools/_schema-write-utils.ts
 var fs4 = __toESM(require("fs"));
@@ -24089,6 +24090,8 @@ var LocalLayoutProvider = class {
   _layoutTemplateMeta = null;
   _homeLayouts = null;
   _homeLayoutMeta = null;
+  _notificationTemplates = null;
+  _notificationTemplateMeta = null;
   constructor(ws) {
     this.ws = ws;
   }
@@ -24159,6 +24162,34 @@ var LocalLayoutProvider = class {
       "home layout"
     );
   }
+  ensureNotificationTemplates() {
+    if (this._notificationTemplates !== null) return;
+    this._notificationTemplates = /* @__PURE__ */ new Map();
+    this._notificationTemplateMeta = [];
+    const dir = this.ws.notificationTemplatesDir;
+    if (!fs9.existsSync(dir) || !fs9.statSync(dir).isDirectory()) return;
+    for (const entry of fs9.readdirSync(dir).sort()) {
+      if (!entry.endsWith(".json")) continue;
+      const fp = path7.join(dir, entry);
+      try {
+        const data = JSON.parse(fs9.readFileSync(fp, "utf8"));
+        const name = path7.basename(entry, ".json");
+        const htmlPath = path7.join(dir, `${name}.html`);
+        this._notificationTemplates.set(name, data);
+        this._notificationTemplateMeta.push({
+          name,
+          title: String(data["title"] ?? name),
+          target: String(data["target"] ?? ""),
+          templateState: String(data["templateState"] ?? ""),
+          hasEmailBody: fs9.existsSync(htmlPath),
+          hasMessageText: Boolean(data["messageText"]),
+          filePath: fp
+        });
+      } catch (e) {
+        log("warn", `Failed to load notification template ${fp}: ${e}`);
+      }
+    }
+  }
   formsForType(typeName, mode) {
     this.ensureForms();
     return this._formMeta.filter(
@@ -24181,6 +24212,12 @@ var LocalLayoutProvider = class {
     this.ensureHomeLayouts();
     return this._homeLayoutMeta;
   }
+  notificationTemplatesForType(typeName) {
+    this.ensureNotificationTemplates();
+    if (!typeName) return this._notificationTemplateMeta;
+    const lower = typeName.toLowerCase();
+    return this._notificationTemplateMeta.filter((t) => t.title.toLowerCase().includes(lower));
+  }
   getLayoutJson(layoutType, name) {
     switch (layoutType) {
       case "form":
@@ -24231,6 +24268,10 @@ var LocalLayoutProvider = class {
         this._homeLayouts = null;
         this._homeLayoutMeta = null;
         break;
+      case "notificationTemplate":
+        this._notificationTemplates = null;
+        this._notificationTemplateMeta = null;
+        break;
     }
   }
 };
@@ -27487,6 +27528,194 @@ function handle25(provider, args) {
   );
 }
 
+// src/tools/get-notification-context.ts
+var get_notification_context_exports = {};
+__export(get_notification_context_exports, {
+  TOOL_DEF: () => TOOL_DEF26,
+  VALID_TARGETS: () => VALID_TARGETS,
+  handle: () => handle26
+});
+var fs19 = __toESM(require("fs"));
+var path15 = __toESM(require("path"));
+var DATA_DIR2 = path15.join(__dirname, "..", "..", "data");
+var NOTIFICATION_TEMPLATE_REFERENCE_PATH = path15.join(
+  DATA_DIR2,
+  "patterns",
+  "notification-template-reference.md"
+);
+var VALID_TARGETS = [
+  "PromoteNotification",
+  "AccountNotification",
+  "WorkflowNotification",
+  "WorkflowTaskNotification"
+];
+var TARGET_DESCRIPTIONS = {
+  PromoteNotification: "Triggered by a lifecycle promote action. Link the template in the lifecycle Send Notification command.",
+  AccountNotification: "Triggered by user creation or password reset. Link in Tenant Settings \u2192 Notifications.",
+  WorkflowNotification: "Triggered by a workflow Notification Activity. Link in Workflow \u2192 Notification Activity.",
+  WorkflowTaskNotification: "Triggered by workflow Input/Checklist Task Activity creation. Link in Workflow \u2192 Input/Checklist Task Activity."
+};
+var TOOL_DEF26 = {
+  name: "get_protrak_notification_context",
+  description: "RECOMMENDED first call when creating a Protrak notification template. Returns existing templates from the workspace (optionally filtered by type name) and the full @Model variable reference for all target types. Templates use Razor syntax (@Model.*), NOT {{}} placeholders. Email notifications require two separate templates: one for Subject, one for Body. Missing notificationTemplates/ directory returns an empty list without error.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      type_name: {
+        type: "string",
+        description: "Optional. Filter existing templates whose title contains this name (e.g. 'Invoice'). Omit to return all templates."
+      },
+      target: {
+        type: "string",
+        description: "Optional. Filter by target type: 'PromoteNotification', 'AccountNotification', 'WorkflowNotification', or 'WorkflowTaskNotification'. Omit to return all."
+      }
+    },
+    required: []
+  }
+};
+function handle26(provider, args) {
+  const typeName = args["type_name"] || void 0;
+  const targetFilter = args["target"] || void 0;
+  const lp = getOrCreateProvider(provider.ws);
+  let templates = lp.notificationTemplatesForType(typeName);
+  if (targetFilter) {
+    templates = templates.filter((t) => t.target === targetFilter);
+  }
+  let variableReference = "";
+  try {
+    variableReference = fs19.readFileSync(NOTIFICATION_TEMPLATE_REFERENCE_PATH, "utf8");
+  } catch {
+    variableReference = "Variable reference file not found.";
+  }
+  const targetTypes = VALID_TARGETS.map((t) => ({
+    value: t,
+    description: TARGET_DESCRIPTIONS[t]
+  }));
+  const nextSteps = [];
+  if (templates.length > 0) {
+    nextSteps.push(
+      "Review existing_templates above for naming conventions and patterns used in this workspace."
+    );
+  }
+  nextSteps.push(
+    "Call generate_protrak_notification_template(name='<Title> Body', target='PromoteNotification', email_html='<Razor HTML>') to write both .json and .html files.",
+    "For email notifications, also call generate_protrak_notification_template for the subject: name='<Title> Subject', email_html='<one-line subject>'."
+  );
+  const result = {
+    existing_templates: templates,
+    target_types: targetTypes,
+    variable_reference: variableReference,
+    next_steps: nextSteps
+  };
+  return JSON.stringify(result, null, 2);
+}
+
+// src/tools/generate-notification-template.ts
+var generate_notification_template_exports = {};
+__export(generate_notification_template_exports, {
+  TOOL_DEF: () => TOOL_DEF27,
+  handle: () => handle27
+});
+var fs20 = __toESM(require("fs"));
+var path16 = __toESM(require("path"));
+function buildTemplateJson(name, target, messageText) {
+  return {
+    title: name,
+    target,
+    emailText: null,
+    hashCode: "",
+    messageText: messageText ?? null,
+    templateState: "Published"
+  };
+}
+var TOOL_DEF27 = {
+  name: "generate_protrak_notification_template",
+  description: "Write a Protrak notification template to disk. Creates NotificationTemplates/<name>.json (metadata) and, when email_html is provided, NotificationTemplates/<name>.html (Razor HTML email body). hashCode is left empty \u2014 Protrak recomputes it on import. Templates use @Model.* Razor syntax (NOT {{}} placeholders). For a full email notification, call this tool twice: once for the Subject template (name='<Title> Subject') and once for the Body template (name='<Title> Body'). Call get_protrak_notification_context first to see existing templates and variable reference.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      name: {
+        type: "string",
+        description: "Template title and filename (e.g. 'Invoice Sent Body', 'Invoice Sent Subject'). Spaces are allowed \u2014 matches MIS.Customization naming convention. Subject templates end with 'Subject'; body templates end with 'Body'."
+      },
+      target: {
+        type: "string",
+        description: "Notification event type. One of: 'PromoteNotification' (lifecycle promote), 'AccountNotification' (user creation/password reset), 'WorkflowNotification' (workflow notification activity), 'WorkflowTaskNotification' (workflow input/checklist task)."
+      },
+      email_html: {
+        type: "string",
+        description: "Razor HTML content for the email template. Written to <name>.html. Use @Model.* variables (see get_protrak_notification_context for the full reference). Omit if this is a push-only template."
+      },
+      message_text: {
+        type: "string",
+        description: "Short plain-text push notification content. Stored in the JSON as messageText. Razor syntax is supported. Omit if this is an email-only template."
+      },
+      overwrite: {
+        type: "boolean",
+        description: "When true, overwrite existing files. Default: false (errors on conflict).",
+        default: false
+      }
+    },
+    required: ["name", "target"]
+  }
+};
+function handle27(provider, args) {
+  const name = args["name"] ?? "";
+  const target = args["target"] ?? "";
+  const emailHtml = args["email_html"] || void 0;
+  const messageText = args["message_text"] || void 0;
+  const overwrite = args["overwrite"] === true;
+  if (!name) return errorResponse("name is required");
+  if (!target) return errorResponse("target is required");
+  if (!VALID_TARGETS.includes(target)) {
+    return errorResponse(
+      `Unknown target '${target}'. Valid values: ${VALID_TARGETS.join(", ")}.`,
+      { valid_targets: [...VALID_TARGETS] }
+    );
+  }
+  if (!emailHtml && !messageText) {
+    return errorResponse(
+      "At least one of email_html or message_text must be provided."
+    );
+  }
+  const dir = provider.ws.notificationTemplatesDir;
+  if (!fs20.existsSync(dir)) {
+    fs20.mkdirSync(dir, { recursive: true });
+  }
+  const jsonPath = path16.join(dir, `${name}.json`);
+  const htmlPath = emailHtml ? path16.join(dir, `${name}.html`) : null;
+  if (!overwrite) {
+    const existing = [];
+    if (fs20.existsSync(jsonPath)) existing.push(jsonPath);
+    if (htmlPath && fs20.existsSync(htmlPath)) existing.push(htmlPath);
+    if (existing.length > 0) {
+      return errorResponse(
+        `Refusing to overwrite existing file(s): ${existing.join(", ")}. Pass overwrite:true to replace.`,
+        { existing_paths: existing }
+      );
+    }
+  }
+  const templateJson = buildTemplateJson(name, target, messageText);
+  fs20.writeFileSync(jsonPath, JSON.stringify(templateJson, null, JSON_INDENT), "utf8");
+  if (emailHtml && htmlPath) {
+    fs20.writeFileSync(htmlPath, emailHtml, "utf8");
+  }
+  const nextSteps = [
+    `Verify by calling get_protrak_notification_context(type_name='${name.split(" ")[0]}').`,
+    "On import, Protrak recomputes hashCode automatically \u2014 leaving it empty here is intentional."
+  ];
+  return successResponse(
+    {
+      name,
+      target,
+      json_path: jsonPath,
+      ...htmlPath ? { html_path: htmlPath } : {},
+      written_json: templateJson
+    },
+    { nextSteps }
+  );
+}
+
 // src/index.ts
 function semverGte(a, b) {
   const parse3 = (v) => v.split(".").map((n) => parseInt(n, 10) || 0);
@@ -27500,6 +27729,7 @@ var TOOLS = [
   // Workflow entry points (call these first)
   get_program_context_exports,
   get_layout_context_exports,
+  get_notification_context_exports,
   scaffold_entity_exports,
   validate_program_exports,
   // Knowledge search (patterns / api / programs)
@@ -27523,6 +27753,7 @@ var TOOLS = [
   generate_type_widget_exports,
   generate_layout_template_exports,
   generate_program_exports,
+  generate_notification_template_exports,
   // Surgical mutators — modify existing files without regeneration/clobber
   attach_attribute_to_type_exports,
   attach_attribute_to_layout_exports,
@@ -27589,6 +27820,13 @@ WORKFLOW for scaffolding schema elements (Types, Lifecycles, Attributes, Relatio
 6. All schema names must be PascalCase. Aliases are allowed for attribute_type: Number\u2192Numeric, File\u2192Attachment.
 7. All generators refuse to overwrite an existing file unless overwrite:true.
 
+WORKFLOW for writing a notification template:
+1. Call get_protrak_notification_context first \u2014 returns existing templates and the full @Model variable reference.
+2. Write the Razor HTML email body using @Model.* syntax (NOT {{}} placeholders).
+3. Call generate_protrak_notification_template for the Body template (name="<Title> Body", target, email_html).
+4. Call generate_protrak_notification_template again for the Subject template (name="<Title> Subject", email_html="<one-liner subject>").
+5. For push-only notifications, omit email_html and provide message_text instead.
+
 WORKFLOW for designing a Design Studio layout:
 1. Call get_protrak_layout_context first \u2014 returns type schema and all existing layouts for the type+mode.
 2. Use list_protrak_layouts to browse all artifacts; use read_protrak_layout to read a specific one's full JSON.

package/data/CLAUDE.md.template

@@ -124,6 +124,31 @@ These are **Protrak-specific gotchas you cannot catch by reading the code**. Alw
 - Return `ProgramResult { IsSuccess = false, Message = "..." }` to block operations in
   Pre-triggers (style rule).
 
+## How to write notification templates
+
+Notification templates define the email/push content sent by Protrak. They use **Razor syntax**
+(`@Model.*`), not `{{}}` placeholders.
+
+### Writing a new notification template:
+1. Call `get_protrak_notification_context(type_name?)` — returns existing templates and the full
+   `@Model` variable reference for all target types.
+2. Write the Razor HTML body using `@Model.*` variables.
+3. Call `generate_protrak_notification_template(name='<Title> Body', target='PromoteNotification', email_html='<Razor HTML>')`.
+4. Call again for the subject: `generate_protrak_notification_template(name='<Title> Subject', target='PromoteNotification', email_html='<subject line>')`.
+
+```
+get_protrak_notification_context(type_name='Invoice')
+# ... agent writes the Razor HTML ...
+generate_protrak_notification_template(name='Invoice Sent Body', target='PromoteNotification', email_html='<p>Hi @Model.AttributeValues["Manager"].UserValues[0].UserName,...</p>')
+generate_protrak_notification_template(name='Invoice Sent Subject', target='PromoteNotification', email_html='Invoice @Model.InstanceName has been sent')
+```
+
+Each call creates `NotificationTemplates/<name>.json` (metadata) and `NotificationTemplates/<name>.html`
+(email body). `hashCode` is left empty — Protrak recomputes it on import.
+
+Valid `target` values: `PromoteNotification`, `AccountNotification`, `WorkflowNotification`,
+`WorkflowTaskNotification`.
+
 ## Project structure
 - `Types/` — entity type JSON definitions
 - `Attributes/` — attribute JSON definitions
@@ -131,3 +156,5 @@ These are **Protrak-specific gotchas you cannot catch by reading the code**. Alw
 - `Programs/` — C# program source + JSON metadata (paired files; use
   `generate_protrak_program` to keep them in sync)
 - `RelationTypes/` — relation definitions between types
+- `NotificationTemplates/` — notification template files (paired `.json` + `.html`; use
+  `generate_protrak_notification_template` to keep them in sync)

package/data/patterns/notification-template-reference.md

@@ -0,0 +1,191 @@
+# Notification Template Reference
+
+## Overview
+
+Protrak notification templates define the content of notifications (email + push) triggered by
+platform events. Templates use **Razor markup syntax** (`@Model.*`) and are stored as paired files:
+
+- `NotificationTemplates/<title>.json` — metadata (title, target, push message, state)
+- `NotificationTemplates/<title>.html` — HTML email body (Razor template)
+
+Two templates are needed for a complete email notification: one for the **subject** (title ending
+in `Subject`) and one for the **body** (title ending in `Body`). Push-only templates need only
+the `.json` with a `messageText` value.
+
+## Target Types
+
+| Target | Trigger event | Usage |
+|---|---|---|
+| `PromoteNotification` | Lifecycle promote action | Link in a lifecycle's "Send Notification" command |
+| `AccountNotification` | User creation / password reset | Link in Tenant Settings → Notifications |
+| `WorkflowNotification` | Workflow notification activity | Link in Workflow → Notification Activity |
+| `WorkflowTaskNotification` | Workflow input/checklist task creation | Link in Workflow → Input/Checklist Task Activity |
+
+## @Model Variables — PromoteNotification
+
+Available when `target` is `PromoteNotification`. These reflect the promoted instance.
+
+```
+@Model.InstanceName          — Display name of the instance
+@Model.InstanceUrl           — Deep link URL to the instance
+@Model.InstanceId            — GUID of the instance
+@Model.InstanceTrackingId    — Tracking / reference number
+@Model.PreviousStateName     — Lifecycle state before the promote
+@Model.CurrentStateName      — Lifecycle state after the promote
+@Model.ModifiedDate          — Date/time of the promote (UTC)
+@Model.ModifiedBy            — Name of the user who triggered it
+@Model.CreatedBy             — Name of the user who created the instance
+@Model.Remarks               — Remarks entered on the promote action
+@Model.AttributeValues["<AttributeName>"]   — Attribute accessor (see below)
+@Model.TenantInfo.TenantName
+@Model.TenantInfo.LogoUrl
+@Model.TenantInfo.DateTimeFormat.DateFormat
+@Model.TenantInfo.DateTimeFormat.TimeFormat
+@Model.TenantInfo.DateTimeFormat.TimeZone
+@Model.TenantInfo.Locale.Name
+@Model.TenantInfo.Locale.DisplayName
+@Model.ApplicationUrl
+```
+
+## @Model Variables — AccountNotification
+
+Available when `target` is `AccountNotification`. These reflect the Protrak user account.
+
+```
+@Model.UserName
+@Model.UserFullName
+@Model.UserEmail
+@Model.UserPassword
+@Model.CompanyName
+@Model.CompanyEmail
+@Model.CompanyDomain
+@Model.CompanyLogoUrl
+@Model.UserRoles[index]
+@Model.UserAttributes["<AttributeName>"]
+@Model.MFAVerificationCode
+@Model.MFAVerificationCodeValidity
+```
+
+## @Model Variables — WorkflowNotification
+
+Available when `target` is `WorkflowNotification`. These reflect the instance attached to the workflow.
+
+```
+@Model.InstanceName
+@Model.InstanceUrl
+@Model.InstanceId
+@Model.InstanceTrackingId
+@Model.ApplicationUrl
+@Model.StateName
+@Model.ModifiedDate
+@Model.ModifiedBy
+@Model.CreatedBy
+@Model.AttributeValues["<AttributeName>"]
+```
+
+## @Model Variables — WorkflowTaskNotification
+
+Available when `target` is `WorkflowTaskNotification`. These reflect the workflow task.
+
+```
+@Model.InstanceName
+@Model.InstanceUrl
+@Model.InstanceId
+@Model.InstanceTrackingId
+@Model.ApplicationUrl
+@Model.StateName
+@Model.ModifiedDate
+@Model.ModifiedBy
+@Model.CreatedBy
+@Model.AttributeValues["<AttributeName>"]
+@Model.WorkflowTask.Id
+@Model.WorkflowTask.Name
+@Model.WorkflowTask.Description
+@Model.WorkflowTask.Comments
+@Model.WorkflowTask.Type
+@Model.WorkflowTask.WorkflowInstanceId
+@Model.WorkflowTask.PausedWorkflowInstActivityId
+@Model.WorkflowTask.TypeInstId
+@Model.WorkflowTask.Status
+@Model.WorkflowTask.AssignedUserId
+@Model.WorkflowTask.AssignedRoleId
+@Model.WorkflowTask.Created
+@Model.WorkflowTask.Due
+@Model.WorkflowTask.Completed
+@Model.WorkflowTask.CompletedBy
+@Model.WorkflowTask.ChecklistItems[index].Id
+@Model.WorkflowTask.ChecklistItems[index].Name
+@Model.WorkflowTask.ChecklistItems[index].IsMandatory
+@Model.WorkflowTask.ChecklistItems[index].IsCompleted
+```
+
+## Attribute Value Accessors
+
+The `@Model.AttributeValues["<AttributeName>"]` accessor returns an object with type-specific
+properties. Access the correct property based on the attribute type:
+
+```
+.TextValue                          — Text attributes
+.NumericValue                       — Numeric attributes
+.DateValue                          — Date attributes (stored as UTC DateTime)
+.ArrayValue[0]                      — Picklist (single) — string value
+.UserValues[0].UserName             — User attributes (first user)
+.UserValues[0].UserEmail
+.UserValues[0].UserId
+.ReferenceValue[0].Name             — Reference attributes (first linked instance)
+.ReferenceValue[0].Id
+```
+
+## Razor Syntax Examples
+
+### Simple substitution
+```html
+<p>Hi @Model.AttributeValues["Employee"].UserValues[0].UserName,</p>
+<p>Your <a href='@Model.InstanceUrl'>@Model.InstanceName</a> has been approved.</p>
+```
+
+### Conditional content
+```html
+@if (Model.AttributeValues["Country"].ArrayValue[0] == "India")
+{
+    <span>Tax rate: @Model.AttributeValues["GSTRate"].NumericValue%</span>
+}
+else
+{
+    <span>No tax applicable.</span>
+}
+```
+
+### Null-safe access
+```html
+@(Model.AttributeValues.ContainsKey("Title")
+    ? Model.AttributeValues["Title"]?.TextValue ?? "N/A"
+    : "N/A")
+```
+
+## File Format
+
+### `<title>.json`
+```json
+{
+  "title": "Invoice Sent Body",
+  "target": "PromoteNotification",
+  "emailText": null,
+  "hashCode": "",
+  "messageText": null,
+  "templateState": "Published"
+}
+```
+
+- `emailText` is always `null` in file-based templates — the email body lives in the `.html` file.
+- `hashCode` is left empty; Protrak recomputes it on import (same pattern as `programHashCode`).
+- `messageText` is the plain-text push notification content (Razor syntax supported).
+- `templateState`: `"Published"` or `"InProgress"`.
+
+### `<title>.html`
+```html
+<p>Hi @Model.AttributeValues["Manager"].UserValues[0].UserName,</p>
+<p>Invoice <strong>@Model.InstanceName</strong> has been sent to the client.</p>
+<p><a href='@Model.InstanceUrl'>View invoice</a></p>
+<p><i>This is a system generated mail, please do not reply.</i></p>
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prorigo/protrak-forge",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Protrak domain context for coding agents — MCP server for GitHub Copilot, Claude, and Cursor",
   "bin": {
     "protrak-forge": "./bin/protrak-forge.js"