@deepidealab/n8n-nodes-tracira

This is an n8n community node for Tracira.

Tracira monitors AI outputs from your automations, evaluates them against rules, and lets you inspect log results from inside n8n workflows.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the n8n community node installation guide.

Install package name:

@deepidealab/n8n-nodes-tracira

If you already installed the legacy unscoped package n8n-nodes-tracira, uninstall it and install the scoped package instead.

For local development:

npm install
npm run verify

Operations

The node currently supports the Log resource with these operations:

• Log: Send an AI output to Tracira for evaluation. Supports async (default) and sync modes, callback URL with event filtering, and all standard context fields.
• Get: Fetch a single log by ID.
• Get Many: List logs with filters such as status, project, task, and date range.
• Set Decision: Approve or reject a flagged log.

The node also supports the API resource with:

• Call: Make an arbitrary authenticated request to the Tracira API.

Sync vs async

By default the Log operation is async: Tracira responds immediately with { ok, id, status: "pending" } and evaluates in the background. Your workflow continues without waiting.

Enable Sync mode in the Options to make Tracira wait for the full evaluation before responding. Use this when you want to branch immediately on status or verdict in the same workflow execution.

Keeping this node in sync with the Tracira API

The Tracira Make custom app (make-app/ in the main repo) is the reference integration. When the Tracira API changes — new webhook fields, renamed endpoints, new status values — both the Make app and this n8n node must be updated together.

Not yet implemented (deferred — too complex for n8n's current node UI):

• Multimodal input / file attachments (attachments, inputText). The Make app supports uploading files or passing URLs; the n8n equivalent requires a complex array param and is deferred until a cleaner pattern is established.

Credentials

Use the Tracira API credential.

You need a workspace webhook token from your Tracira dashboard:

1. Open Tracira.
2. Go to the integrations/token area of your workspace.
3. Copy the webhook token.
4. Paste it into the Workspace Token field in n8n.

The credential test calls GET /api/verify on Tracira and uses the token as a query parameter.

Compatibility

This package is being set up against the current n8n community-node tooling and Tracira API endpoints available as of March 7, 2026.

Usage

Typical pattern:

1. Run your AI step in n8n.
2. Send the model output to Tracira -> Log -> Log.
3. Branch on the returned status, verdict, or confidenceScore.
4. Optionally query historic logs with Get or Get Many.

Example workflow

An importable example workflow is available at examples/log-and-branch.workflow.json.

The example does this:

1. Starts from a manual trigger.
2. Logs an execution to Tracira.
3. Branches with an If node based on the returned status.

Verification notes

This package is structured to align with n8n's verification guidance:

• Built with the n8n-node toolchain.
• No runtime dependencies in package.json.
• No access to environment variables or file system from node code.
• MIT licensed.
• Published from GitHub Actions with npm provenance configured in .github/workflows/publish.yml.
• The published package is scanned with @n8n/scan-community-package after npm publication.

Maintainer release instructions are documented in PUBLISHING.md.

Releasing a new version

1. Make changes, bump package.json version, update CHANGELOG.md.
2. Commit and push to main.
3. Run gh release create vX.Y.Z --title "vX.Y.Z" --notes "..." — this triggers the GitHub Actions publish workflow automatically.
4. The workflow builds, publishes to npm with provenance, and runs the n8n package scan.

Do not publish manually from a local machine — provenance requires the GitHub Actions trusted publisher.

Resources

• n8n community nodes documentation
• Tracira
• Tracira API schema

Version history

0.3.1

Add Sync mode and Callback Events options to the Log operation, matching the Make custom app.

0.3.0

Rename terminology to match Tracira API: Execution→Log, Flow→Project, Check→Task. API paths updated from /executions to /logs. Breaking change — existing workflows must update the resource value and field names.

0.2.1

Bring the n8n node surface back in line with the Make app by adding Set Decision and Make API Call, and make the decision endpoint token-authenticated for automation clients.

0.2.0

Move the package to the @deepidealab npm scope so the node is published under the business organization instead of a personal npm account.

0.1.8

Add codex categories and search aliases to improve Tracira discoverability in the editor node picker.

0.1.7

Remove the invalid Developer Tools node category so Tracira remains visible in the editor on self-hosted n8n.

0.1.6

Replace newer declarative node features with a plain execute-style implementation for broader self-hosted n8n compatibility.

0.1.5

Reduce node-description metadata to older-safe fields for self-hosted n8n compatibility.

0.1.4

Use a current npm CLI in the publish workflow to satisfy npm trusted publishing requirements.

0.1.3

Force GitHub Actions to publish via npm trusted publishing instead of any inherited token environment.

0.1.2

Allow GitHub Actions trusted publishing while continuing to block accidental local publishes.

0.1.1

First GitHub Actions release with npm provenance and trusted publishing.

0.1.0

Initial Tracira node setup with execution logging and read operations.