Skip to content

docs: implement Perry Human-in-the-Loop (HITL) technical documentation#17

Merged
aperezmarquez merged 1 commit into
mainfrom
la-ia
May 5, 2026
Merged

docs: implement Perry Human-in-the-Loop (HITL) technical documentation#17
aperezmarquez merged 1 commit into
mainfrom
la-ia

Conversation

@D3n3bX

@D3n3bX D3n3bX commented May 5, 2026

Copy link
Copy Markdown
Contributor

Description

This PR introduces the technical documentation for the Perry HITL module (perry.pending.action). This module is the cornerstone of Perry's security architecture, ensuring all AI intents undergo human verification before execution.

Fixes #16

Key Technical Implementations

  • Staging Architecture: Documented how AI payloads are stored in JSON and rendered into human-readable HTML tables via computed fields.
  • Multi-Module Execution: Detailed the specific logic for automated creation of CRM Leads, Account Payments, and Calendar Events.
  • Lookup & Validation Logic: Explained the fuzzy-search strategy for finding Partners/Journals and the automated posting of accounting entries.
  • UTC Normalization: Documented the timezone handling for the Calendar integration.
  • End-to-End Tracing: Integrated Logfire instrumentation details for auditing the transition from AI suggestion to Human confirmation.

This safety layer prevents 'Administrative Noise' by allowing users to quickly verify and commit AI-prepared tasks with a single click.

@aperezmarquez aperezmarquez merged commit ae50934 into main May 5, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add documentation for perry human in the loop

2 participants