Change Log

New Feature

• @insites/logic-engine npm package — new TypeScript library that loads the rule and decision corpus, evaluates when/then decisions, renders scaffold templates, and exposes an MCP-server entry point.
• Versioned rule + decision corpus — markdown rule files plus JSON decision files for module detection, feature-pattern recognition, and scaffolding, used by the engine and by AI tooling.
• API endpoints reference — building inbound JSON endpoints under the V2 surface (api/_external/v2/<resource>/<action>.json.liquid), with auth, method, status-code, error, and pagination conventions.
• CRM controllers reference — controllers conforming to the CRM module's V2 surface using the path: front-matter alias.
• User profile types reference — schema location, GraphQL read via related_record + property accessors, write via record_create/record_update, multi-profile users.
• Payments reference — Stripe integration assembled from api_calls/, constants/, and form callback_actions. Worked Checkout Session example and webhook receiver shape.
• CRM module reference — V2 REST endpoints, custom and system fields, webhook coverage, tasks, activities, attachments, event streams, and a field-by-field schema reference.
• CMS module reference — covers 10 object types (Pages, Layouts, Partials, Web Files, Globals, Collections, Emails, SMS, Authorization Policies), file-based stance, IIA admin paths, and override patterns.
• Data module reference — V2 endpoints for user-defined databases, schema discovery, bulk-loop patterns, and an IIA configuration walkthrough.
• GraphQL profile queries — new section explaining how user_profile_types/ schemas are queried via related_record + property accessors, with multi-profile-type users called out explicitly.

Improvement

• Repository renamed insites-ai-tools → insites-logic-engine to align with the npm package identifier @insites/logic-engine. Install URLs and the GitHub repository updated; the previous URLs remain redirected for a transition period.
• README rewritten around the two deliverables shipped from this repository: skills/insites/ for AI-tool consumption (Claude Code, OpenCode, Cursor) and engine/ + logic-engine/ for programmatic tooling.
• Modules-based project layout documented as the canonical structure: modules/<name>/public/{views,forms,graphql,authorization_policies,api_calls,schema,user_profile_types,emails,migrations,assets}/. New project-structure reference covers per-directory purpose, naming conventions, and module-prefixed render/include/graphql paths.
• State changes via form callback_actions — form definitions at modules/<name>/public/forms/<name>.liquid are documented as the canonical pattern for create/update/delete operations: YAML schema for field declarations and per-field validation, a Liquid callback_actions block for GraphQL mutations and side effects. Worked update_password example covering form_set_error / form_set_field_error / form.errors.
• Pages-as-controllers rule calibrated — small page-specific markup, JSON-page bodies, and short redirect/error pages may live inline; reusable markup belongs in partials, with ~10 lines of HTML as the extract-it threshold.
• Data-fetching boundary — pages own GraphQL calls for new code; partials receive their data through render arguments.
• CLI reference rewritten against the actual insites-cli help output (see also Bug Fix below).

Bug Fix

• Authorization policy output invariant — corrected the truthy/falsy framing. Policies are not Liquid return true/false controllers; the platform compares the file's output as a string against the literal "true". Canonical examples now use single-line {%- ... -%} whitespace-trimmed Liquid that emits exactly true or false. Three concrete failure modes documented: trailing newline, returning a Liquid truthy object, and policy-name typos.
• Logic Engine corpus loading — discriminated-union schema for decision kinds so every module-detection decision is loaded and validated correctly. Added a prepack script that bundles the corpus into the published npm package, plus regex tightening on partial-resolution rules. 23/23 tests passing.
• CLI reference accuracy — the CLI command reference contained 8 inaccurate command signatures, 1 invented command, and 6 missing real commands. Rewritten against the actual insites-cli help output.
• 26 broken markdown links across the skill repaired in a single sweep. Post-fix scan: 0 broken across 812 relative links in 201 files.
• Modules install messaging — replaced misleading 'insites-cli modules install is not yet available' copy with accurate prose: modules are preinstalled per Insites instance and updated through the Insites console; there is no CLI command to install or uninstall modules.
• Install URL branch reference — install scripts pointed at master, but the repository's default branch is main. Corrected to main everywhere so install commands work.

New Features

• Real-Time Instance Creation Status
  • The instance creation process now shows live status updates as each step completes — from setting up the instance to installing each module. The instance card updates in real time (e.g. "Installing CRM / System on My Instance...") so you always know exactly what's happening. The connection automatically recovers if you lose and regain network during the process.
• Custom Date Range for Usage Charts
  • Monthly usage charts (Data Objects, Peak Storage) now include a custom date range picker. Select a specific Start Month and End Month, or use quick presets — This Year, Last Year, Last 12 Months, or Last 6 Months — to filter the chart to the period you need.

Improvements

• Localisation-Aware Date Display
  • Dates across the Console now follow your account's localisation settings, applied consistently across Module Versions, Marketplace items, the Dashboard, and other date displays.
• Relative Dates on Module Versions
  • The Module Version list now shows both the formatted publish date and a relative time label (e.g. "3 months ago", "yesterday", "today") for quicker reference.
• Mobile Filter Layout
  • Filters on the People and Marketplace pages now display as full-width rows on mobile, matching the layout used on the Instances list.
• Usage Charts Default to Last Month
  • Daily usage charts now default to showing the previous month's data instead of the current month, giving you a complete data set to start with.
• CRM / System Breakdown in Data Objects
  • The Data Objects chart now includes a per-table record count breakdown for the CRM / System module, showing exactly where your data objects are being used.
• Retry Mechanism for Module Installation
  • Module installations now automatically retry on transient failures, reducing the chance of a failed install requiring manual intervention.

Bug Fixes

• Fixed an issue where changing the date filter on daily usage charts did not update the chart.
• Fixed "Invalid Date" appearing in the module version list for users with a day-before-month date format (DD/MM/YYYY).

Improvement

• context.environment and context.location.host in background jobs: Background jobs now receive the same context.environment (e.g., production, staging) and context.location.host values that are available in web requests. This makes it easier to branch logic by environment or build host-aware URLs from asynchronous code.

• skip_ssl_verification option for api_call_send: The api_call_send mutation accepts a new skip_ssl_verification boolean in its options. When set to true, SSL certificate verification is skipped for HTTPS requests - useful when integrating with internal services that use self-signed certificates. Disabled by default.

• assign and function tags accept arguments in multiline.

• assign tag supports string interpolation inside hash values.

• [] and {} empty array/hash literals can be used as argument values.

• pos-cli deploy improvements:

  • Significantly faster cold deploys: Deploying a ~1,000-file application is now approximately 3× faster. Benchmarked against a real-world pos application (5,883 files): cold deploy time dropped from ~11.8s to ~3.9s. Warm deploys (no file changes) are slightly faster thanks to a better algorithm for skipping unchanged files. It also affects the Instance Clone feature.
  • All validation errors reported at once: When a deploy contains multiple invalid files, all errors are now collected and reported together in a single response instead of stopping at the first failure. This means you can fix all issues in one round rather than discovering them one by one.
  • Deploy report: Each deploy now returns a structured report listing which files were upserted or deleted per resource type (partials, GraphQL queries, pages, assets, etc.), making it easier to understand exactly what changed. Requires pos-cli 6.0.0+.
  • pos-cli deploy --dry-run now includes assets: Dry-run mode reports which assets would be added or removed without uploading them. Requires pos-cli 6.0.0+.
  • Automatic cleanup for public-only modules (opt-in, requires auto_manage_public_only_modules: true in config.yml): platformOS can now detect when a module contains only public files and, when it does, treat those files with the same lifecycle rules as regular application files - meaning files removed from the deploy are automatically deleted from the instance. Previously, module files were never deleted on deploy, which required adding each module name individually to the modules_that_allow_delete_on_deploy setting in the config. Because this changes deletion behaviour, it is disabled by default and must be explicitly opted into.

• Improved asset_manifest generation during pos-cli pull: greatly improves internal memory management and performance of generating asset_manifest (which includes all Assets). This also affects the Instance Clone feature.

• Module handling — warning when a declared module is missing: If a module is listed in pos-modules.lock.json but its source files are missing from the deploy, a warning is now emitted.

• Unknown app/config.yml properties are now warnings, not errors: If your config.yml contains a feature flag that does not exist in the target environment (for example when deploying from staging to a production environment that hasn't received that flag yet), the deploy no longer fails.

• Better error messages for duplicate translation keys: When multiple translation files define the same key for the same locale, the reported error now lists each offending key alongside the specific files that defined it, instead of lumping all files together.

• Duplicate model name detection on deploy: If two Model Schemas, Profile Types, or User Profiles resolve to the same parameterized name, the deploy now fails fast with a clear error listing the conflicting name and the files that introduced it.

Bug Fix

• raw_url handling for cloned instances: When an asset's raw_url points at an instance CDN path (/instances/N/assets/...), the host and instance ID are now rewritten to match the current instance's CDN configuration. This fixes broken asset URLs on cloned instances. External raw_url values (without the instance path segment) continue to be served as-is.

New Features

• External API V2 Endpoints - New v2 API endpoints are now available. Please visit API > Insites API Endpoints for more details.
  • Pipelines
  • Pipeline Stages
  • Opportunities
  • Opportunity Related Contacts
  • System Fields
  • Opportunity Custom Fields

Deploy, manage, and interact with your Insites instances directly from Claude Desktop — no CLI installation or browser login required.

What is CloudShell?

CloudShell is an MCP (Model Context Protocol) server that connects Claude Desktop to your live Insites instances over HTTP. It gives you a direct bridge between your AI assistant and your Insites environment, so you can deploy files, manage environment variables, check logs, and more - all from a single conversational interface.

Why it matters

Traditional Insites development workflows require switching between terminal commands, browser tabs, and deployment tools. CloudShell removes that friction. With a single connection, Claude can read from and write to your instance without you ever leaving the conversation.

This is particularly useful for:

• Rapid prototyping and iteration on pages and templates
• Debugging issues by pulling logs in real time
• Managing environment variables across instances
• Deploying changes without touching the command line

What you can do with CloudShell

Getting started

CloudShell connects via a single endpoint and authenticates using your Insites console credentials passed as HTTP headers. Once configured in Claude Desktop, your AI assistant has direct access to your instance - no additional software to install.

For full setup instructions and tool reference, see the CloudShell documentation.

New Features

• New constants command: set, unset, and list constant variables on an instance.
• New exec command: execute Liquid code or GraphQL queries directly on an instance without deploying files. Supports inline code and --file option.
• --json flag added across 11 commands for structured JSON output (constants list, exec graphql, exec liquid, logsv2 search, logsv2 searchAround, logsv2 alerts list/add/trigger, logsv2 reports, migrations list, modules list).

Bug Fixes

• Fixed data import sending incorrect payload structure.
• Fixed sync error handling for 401 Unauthorized, 404 Not Found, and network connection failures providing unclear or missing error messages.
• Fixed missing authData guard in deploy and sync commands.
• Fixed report module throwing MODULE_NOT_FOUND error.

Improvements

• Expanded logsv2 subcommands: search, searchAround, alerts (list, add, trigger), and reports.
• Various stability and error handling improvements.

Improvement

• Update ins-table Timezone Overlay formatting.

Bug Fix

• Fix ins-sidebar-item icon flickering issue on hover.

New Features

• Event Ticket Purchases - View all tickets purchased by a company directly from their company profile.
• SendGrid Account Management - You can now delete custom SendGrid accounts when they're no longer needed.
• Version Control Activity Stream - Track all version control changes in real time via the Event Stream.
• Admin Action Tracking - Administrator actions are now logged and visible in the Event Stream.

Improvements

• Clearer Company Deletion - When deleting a company, you'll now see exactly what data will be removed and what will be kept.
• Company Profile Tabs - Improved layout and usability for the Opportunities, Event Sponsorships, and Orders tabs.
• Delete Confirmation - A clear warning message now appears before deleting a company.
• API Key Interface - Updated design for managing Instance API Keys.
• Advanced Filter - Boolean Fields - Boolean field type filters now work correctly in Advanced Filter.
• Advanced Filter - Address Fields - You can now filter CRM records by address fields.
• Redirects Interface - Cleaner, updated UI for managing redirects.
• CRM Export Filters - Export filters now apply correctly when exporting CRM data.
• Contact Prefix Options - More prefix choices available when creating or editing CRM contacts.

Bug Fixes

• Fixed an issue where bulk deleting companies could fail.
• Fixed incorrect values showing for event sponsorships on company profiles.
• Fixed column sorting on the Relationships tab of company profiles.
• Fixed contact imports when profiles are included.
• Fixed display issues for archiving and restoring contacts.
• Fixed Event Stream not displaying entries with a log.action value.

New Features

• V2 Get carts endpoint filter by contact_uuid,session_id,company_id

Improvements

• When deleting the cart, all of it’s cart_items must be deleted
• Cart Items V2 API

Bug Fixes

• Using partial modules/insites_ecommerce/seo, the code returns empty canonical which is flagged as an error by w3C
• Adding products with variants sometimes lead to double value
• Opening order details linked from Dashboard->Events Stream shows popup error.
• Order item is not added when adding order via IIA
• Cart Item total displayed is 0
• Updates to products should reflect in cart items (updated cart_item to be linked to product and not use screenshot of the product details)
• The computation for order_total is wrong when the product is_tax_included=true or is_sale_price_tax_included=true (for is_on_sale=true)
• Product variant get controller not working
• Table Data Styles
• Fix local storage for localisationData

Breaking Change

• Update all v2 PUT endpoint to PATCH
• Updated cart_item schema. Removed product snapshot details and now using the product details from product database.

Hotfix

• Fix Loading and editing field type issue on custom fields

What is this?

Insites AI Tools is a skill documentation package that teaches LLMs (Claude, GPT, etc.) how to write correct code for the Insites platform. When installed, AI assistants can help developers build pages, query data, create commands, handle authentication, deploy code, and follow Insites coding conventions — without hallucinating unsupported features.

GitHub repository: https://github.com/insites-io/insites-ai-tool/