Skip to content
View Amyvdev1's full-sized avatar

Block or report Amyvdev1

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
Amyvdev1/README.md

Amy Villa — Full-Stack & AI Systems Engineer (Python / TypeScript)

I build deterministic full-stack applications, human-in-the-loop (HITL) agentic workflows, and fault-tolerant API integrations. My engineering methodology focuses on replacing fragile AI improvisation with strict state machines, cryptographic webhook verification, typed schema contracts (Pydantic/Zod), and reproducible test suites (800+ automated tests shipped).

Production SaaS Architectures (Private / Commercial)

  • Human-in-the-Loop (HITL) Multi-Agent Operations Platform: Full-stack orchestration engine (TypeScript, React, Node 24) featuring task runtime recovery, multi-party transaction rooms, pipeline attribution, and strict approval gates. Verified across 600+ automated web tests and 15 analytics suites.
  • B2B Commercial Procurement & Document Discrepancy Engine: Automated multi-document diffing engine comparing supplier quotes, purchase orders, and confirmations across pricing, freight, incoterms, and specifications with confidence scoring. 100% detection of 20 critical discrepancy cases across a 60-pair synthetic benchmark.
  • Encrypted Bilingual Professional Matching Platform: Bilingual (EN/ES) matching engine with automated credit-reservation lifecycles, encrypted messaging, RBAC admin queues, and Stripe webhook billing. Verified via 166 automated unit/integration tests and 26 Playwright E2E browser journeys.

Commercial Stealth Architectures — System Flow Overview

flowchart LR
    A[User or webhook input] --> B[Authentication and schema validation]
    B --> C[Deterministic state machine]
    C --> D{Sensitive action?}
    D -->|Yes| E[Human approval queue]
    D -->|No| F[Execution and audit ledger]
    E -->|Approved and scope unchanged| F
    E -->|Blocked or expired| G[Structured fallback and recovery]
Loading

The diagram summarizes a shared design approach. Provider-specific webhook signatures, human identity, tenant scope and approval consumption are enforced at their respective boundaries.

Architecture Engineering focus Evidence
HITL Multi-Agent Operations Scoped approvals, argument binding, recovery and auditability Public reference tests; private-suite receipt reconciliation pending
B2B Document Discrepancy Engine Provenance-aware comparisons and explicit uncertainty Historical synthetic benchmark: 60/60 pairs, 20/20 critical findings, zero unsupported critical findings
Encrypted Bilingual Matching Credit lifecycle, role boundaries and encrypted messaging Historical release gate: 166 tests and 26 browser journeys

Public architecture showcases expose synthetic contracts and independently authored utilities while retaining commercial implementations privately.

Featured Engineering Publications & Architectural Deep-Dives (medium.com/@amyv.dev)

Open-Source Engineering Labs (Public Repositories)

  • webhook-trust-lab (Python / SQLite / AppSec): Deterministic webhook security reference architecture enforcing HMAC-SHA256 verification, signed timestamp replay windows, concurrent delivery locking, and atomic SQLite rollbacks (39 deterministic tests, 9 failure scenarios).
  • olostep-integration-reliability-lab (Python / Async APIs): Asynchronous batch-processing and fault-recovery harness handling polling, pagination, partial dataset failures, and idempotent retries across 9 offline failure scenarios.
  • dx-orbit & hookforge-sdk (Python / TypeScript / OpenAPI): Explainable OpenAPI contract gap analyzer and type-safe TypeScript SDK generator enforcing predictable API error contracts.
  • signalos-developer-experience-platform (TypeScript / React / Node 24 / Zod): 5-application ecosystem (MailTrace DX Lab, ClearRoute API, ForgeFlow, AccessPath Console) testing out-of-order events, RBAC state transitions, and accessible error recovery.

Stack: Python FastAPI TypeScript React Next.js Node 24 SQLite Pydantic Zod Playwright Vitest Pytest Docker GitHub Actions



Amy V

Technical writing · API reliability · Developer education

I build software and write the documentation that makes it usable. My work connects API contracts, SDK behavior, failure recovery, application security, and the decisions developers need to make along the way.

My approach starts with a working example: reproduce the behavior, test the difficult paths, explain the tradeoffs, and give the reader a clear next step. The result is a body of independent projects with source code, tests, technical reports, and walkthroughs you can inspect together.

Portfolio · Engineering evidence · LinkedIn · Medium · Contact

Start with the evidence

Explore The question it answers Review the work
API documentation — HookForge SDK Can a developer install, run, and evaluate an SDK from the documentation? Quickstart and examples · Developer-experience report
Security explanation — Webhook Trust Lab Why does a valid signature still need freshness, event identity, and a transaction boundary? Implementation and tests · Case study and video
Integration education — Olostep Reliability Lab What should an integration do when a batch is partial, interrupted, or uncertain? Recovery model · Case study and video

For a five-minute review, choose one question, open its walkthrough, then compare the explanation with the implementation and tests. For the broader product architecture, explore SignalOS below.

Selected writing

Read more on Medium →

Security and API reliability — six companion articles

Two independent case studies connect code, tests, recorded walkthroughs, and technical writing. Each article is available online and as a designed PDF.

Flagship — SignalOS

SignalOS — The Developer Experience Reliability Platform

One payment-launch investigation connects contract findings, an outdated quickstart, timeout recovery, duplicate protection, agent approval, policy replay, and an exportable evidence trail.

  • Analyze OpenAPI contract gaps and supported breaking changes.
  • Reproduce local HTTP failures; retry a committed operation without duplicating it.
  • Inspect HMAC verification, replay windows, and synthetic event ordering.
  • Require an expiring, argument-and-policy-bound approval before a simulated financial action.
  • Preserve investigation history in SQLite and export Markdown, JSON, HTML, or CSV.
  • Inspect estimated economics with explicit inputs; unknown costs remain unknown.

Working local MVP: React, TypeScript, Node 24, SQLite, 44 behavioral tests, desktop/mobile browser checks, and GitHub Actions. The broader platform is a documented roadmap; the current SDK, documentation, and economics features support the payment scenario.

Case study and console preview · Architecture · Engineering article · Verification

Security and integration reliability

Webhook Trust Lab follows an event from HMAC verification and signed timestamps to persistent event identity and an atomic SQLite-local effect. Inspect 39 deterministic tests, concurrent delivery, rollback, a threat model, and nine recorded scenarios. Case study and walkthrough.

Olostep Integration Reliability Lab makes asynchronous batches, polling, pagination, partial results, and recovery explainable. Nine offline scenarios accompany a sanitized two-URL live compatibility check. Case study and walkthrough.

Both are independent reference projects. Local security behavior and a bounded live compatibility check do not establish production adoption or exactly-once remote effects.

AI economics, controls & decision systems

Explore five projects on cost, permissions, evidence, and onboarding
Project Purpose Implementation to inspect
AgentLedger AI Agent Economics and Decision Ledger Model/tool/retry/review cost estimates, persistent events, unknown-cost propagation, human baseline and risk-adjusted value
TrustBoundary AI Agent Permissions, Policy and Human Approval Strict tool schemas, role/scope gates, expiring approvals, idempotent execution and policy-aware replay
EvidenceGraph Research Provenance and Decision Support Source-to-claim links, contradictory evidence, freshness, human decisions and preserved evidence snapshots
WorkflowROI Automation Economics and Human-in-the-Loop Simulation Manual/partial/AI-assisted comparison, review and error costs, adoption, break-even and sensitivity analysis
DeveloperJourney Observatory Developer Onboarding, Friction and Recovery Analytics Synthetic journeys, first-success and recovery metrics, privacy validation and documentation comparisons

These five applications use React, Node 24 and SQLite, with local setup, tests, browser verification, reports, architecture notes and engineering articles. Explore the collection.

API & developer tools

Explore six API, SDK, and developer-experience projects
Project Purpose Implementation to inspect
DX Orbit Developer Experience Intelligence for OpenAPI Explainable contract findings, integration friction, revision comparison and report export
DevStart API Developer Onboarding & Recovery Environment Authentication, validation, rate limits, failure states and actionable recovery scenarios
HookForge Webhook Reliability & Debugging Workbench Signatures, retries, duplicate delivery, event ordering, malformed payloads and recovery
ToolTrust AI Agent Tool Reliability Infrastructure Tool schemas, permissions, side effects, confirmation, idempotency and replayable simulated execution
SignalDesk Developer Feedback Intelligence Structured friction and documentation feedback, prioritization, resolution and issue-draft export
HookForge SDK TypeScript SDK & Generator Evaluation MIT SDK generated with Voxgig, setup/examples, generated checks, local HTTP verification and a developer-experience report

Full-stack systems & interface engineering

Explore workflow engineering, webhook debugging, and accessible interfaces
Project Focus
ForgeFlow AI Automation React/TypeScript and FastAPI workflows, validated inputs, SQLite run history, visible fallback behavior and human review
MailTrace DX Lab Signed webhooks, retries, idempotency, event ordering and developer-facing failure investigation
ClearRoute API Typed validation, legal workflow transitions, predictable errors, audit events, tests and CI
AccessPath Console Keyboard-first workflows, semantic interfaces, visible focus, accessible recovery and accessibility checks

Portfolio & supporting assets

Engineering principles

  • Make inputs, state transitions and failure paths explicit.
  • Validate before acting; keep permission and approval decisions inspectable.
  • Test recovery, malformed requests and duplicates alongside the happy path.
  • Keep measured behavior, estimates, assumptions and synthetic fixtures distinguishable.
  • Document what runs today and what production operation would still require.

Working stack: TypeScript · React · Node.js · Python · FastAPI · Pydantic · Zod · REST/OpenAPI · JSON Schema · SQLite · pytest · Vitest · Playwright · Docker · GitHub Actions

Evidence boundary: These are independent engineering projects. Simulated payments, agent execution, feedback and onboarding sessions are labelled. Forecasts are not measured savings; tests and local verification do not imply production adoption, scale, authenticated security or customer outcomes. Each repository documents its own implemented scope and limitations.

Pinned Loading

  1. olostep-integration-reliability-lab olostep-integration-reliability-lab Public

    Asynchronous API reliability & fault-recovery harness in Python: handles batch polling, pagination, partial dataset corruption, and idempotent retry states across 9 deterministic failure scenarios.

    Python 1

  2. signalos-developer-experience-platform signalos-developer-experience-platform Public

    Full-Stack TypeScript, React & Node 24 monorepo featuring typed API state machines, out-of-order webhook recovery, human-in-the-loop AI execution gates, and Playwright E2E browser verification.

    TypeScript 1

  3. webhook-trust-lab webhook-trust-lab Public

    Deterministic webhook security architecture in Python & SQLite: HMAC-SHA256 signature verification, timestamp replay protection, idempotency locks, and atomic rollbacks across 39 automated security…

    Python 1

  4. b2b-procurement-discrepancy-benchmark b2b-procurement-discrepancy-benchmark Public

    Provenance-aware commercial document comparison contracts, synthetic benchmark evidence and deterministic price/date tolerance tests. Historical private-build evaluation: 60 pairs, 20/20 critical f…

    Python

  5. encrypted-bilingual-matching-architecture encrypted-bilingual-matching-architecture Public

    Sanitized EN/ES matching architecture: credit reservation state machine, encrypted messaging boundaries, role-based review and historical verification of 166 tests and 26 browser journeys.

    Python

  6. hitl-agent-operations-architecture hitl-agent-operations-architecture Public

    Sanitized architecture, scoped approval contracts, deterministic state transitions and offline verification for human-in-the-loop agent operations.

    Python