Integrate Tractatus framework into your AI systems with practical guides, code examples, and battle-tested patterns for real-world deployment.
Complete framework integration for new AI-powered applications. All five services active with persistent instruction storage.
Add Tractatus validation as middleware in existing AI pipelines. Non-invasive integration with gradual rollout support.
Use individual Tractatus services à la carte. Mix and match components based on your specific safety requirements.
npm install @tractatus/framework
# or
yarn add @tractatus/frameworkInstall the framework package and its dependencies (MongoDB for instruction storage).
const { TractatusFramework } = require('@tractatus/framework');
const tractatus = new TractatusFramework({
mongoUri: process.env.MONGODB_URI,
verbosity: 'SUMMARY', // or 'VERBOSE', 'SILENT'
components: {
classifier: true,
validator: true,
boundary: true,
pressure: true,
metacognitive: 'selective'
}
});
await tractatus.initialize();Configure and initialize the framework with your preferred settings.
const instruction = "Always use MongoDB on port 27017";
const classification = await tractatus.classify(instruction);
// {
// quadrant: 'SYSTEM',
// persistence: 'HIGH',
// temporal_scope: 'PROJECT',
// verification_required: 'MANDATORY',
// explicitness: 0.85
// }
if (classification.explicitness >= 0.6) {
await tractatus.store(instruction, classification);
}Classify user instructions and store those that meet explicitness threshold.
// Before executing AI-generated action
const action = {
type: 'db_config',
parameters: { port: 27027 } // Wrong port!
};
const validation = await tractatus.validate(action);
if (validation.status === 'REJECTED') {
console.error(`Validation failed: ${validation.reason}`);
console.log(`Conflicts with: ${validation.conflicting_instruction}`);
// Do not execute action
} else {
// Safe to proceed
executeAction(action);
}Validate AI actions against stored instructions before execution.
// Check if decision crosses Tractatus boundary
const decision = {
domain: 'values',
description: 'Change privacy policy to enable analytics'
};
const boundary = await tractatus.checkBoundary(decision);
if (!boundary.allowed) {
// Requires human decision
await notifyHuman({
decision,
reason: boundary.reason,
alternatives: boundary.ai_can_provide
});
}Enforce boundaries: AI cannot make values decisions without human approval.
app.use(tractatus.middleware({
mode: 'enforce', // or 'monitor'
onViolation: async (req, res, violation) => {
await logViolation(violation);
res.status(403).json({
error: 'Tractatus boundary violation',
reason: violation.reason
});
}
}));async function moderateContent(content) {
const decision = {
domain: 'values',
action: 'auto_moderate',
content
};
const check = await tractatus.checkBoundary(decision);
if (!check.allowed) {
return { action: 'human_review', alternatives: check.ai_can_provide };
}
}const pressure = await tractatus.checkPressure({
tokens: 150000,
messages: 45,
errors: 2
});
if (pressure.level === 'CRITICAL') {
await suggestHandoff(pressure.recommendations);
} else if (pressure.level === 'HIGH') {
await increaseVerification();
}const customClassifier = {
patterns: {
CRITICAL: /security|auth|password/i,
HIGH: /database|config|api/i
},
classify(text) {
for (const [level, pattern] of Object.entries(this.patterns)) {
if (pattern.test(text)) return level;
}
return 'MEDIUM';
}
};Get help with implementation, integration, and troubleshooting.
Join organizations building safer AI systems with architectural guarantees.