Complete database schema and API implementation for agent memory
aligned with API Platform Engineer role requirements
(agency-agents/engineering/engineering-api-platform-engineer.md)
Schema (migration 004):
✓ agent_prompt: template-based prompts with versioning
✓ agent_skill: capabilities with effectiveness tracking
✓ agent_decision: reasoning and outcome recording
✓ role_prompt_mapping: maps roles (e.g., api-platform-engineer) to prompts
✓ agent_metrics: performance tracking per agent
✓ prompt_usage_log: detailed invocation tracking
✓ agent_registry: agent lifecycle management
API Endpoints (contract-first, backward-compatible):
POST /memory/agents/{project_id}/prompts
POST /memory/agents/{project_id}/roles
GET /memory/agents/{project_id}/roles/{role_name}/prompts
Handlers:
✓ create_prompt_handler: persists to agent_prompt table
✓ map_role_to_prompt_handler: role → prompt mapping with priority
✓ get_role_prompts_handler: retrieves prompts by role
Repository Layer (mem-store/src/agent_repo.rs):
✓ AgentRepository with full CRUD operations
✓ Prompt usage tracking and statistics
✓ Role-to-prompt mapping with priority ordering
✓ Metrics persistence for observability
Tekton Pipeline:
✓ agent-memory-migration-task: applies schema migration
✓ verify-indexes: validates all indexes created
✓ verify-schemas: validates table structure
✓ integration into poimen-ci pipeline
Integration Tests (tests/agent_memory_api_platform_engineer.rs):
✓ Contract-first API specification validation
✓ Backward compatibility rule enforcement
✓ Rate limiting communication (X-RateLimit-* headers)
✓ Error response consistency (stable codes + request IDs)
✓ Deprecation lifecycle (announce → signal → runway → sunset)
✓ Idempotency and retry safety
✓ API Platform Engineer role requirements
✓ Agent prompt templates for contract review, compatibility check, SDK generation
All tests validate against agency-agents API Platform Engineer specification:
- Contract-first: OpenAPI spec before code
- No breaking changes without versioning
- Consistent error handling (RFC 9457 problem details)
- Rate limits communicated not enforced
- SDKs + docs generated from spec
- Idempotency via Idempotency-Key header
- Deprecation with runway (6-12+ months)
Ready to deploy: run Tekton PipelineRun to apply migrations + test
132 lines
4.1 KiB
YAML
132 lines
4.1 KiB
YAML
apiVersion: tekton.dev/v1
|
|
kind: Task
|
|
metadata:
|
|
name: agent-memory-migration
|
|
namespace: tekton-pipelines
|
|
spec:
|
|
description: Apply agent memory schema migration (004) to production database
|
|
params:
|
|
- name: migration-version
|
|
description: Migration version number
|
|
default: "004"
|
|
- name: database-name
|
|
description: Database name
|
|
default: "memory"
|
|
workspaces:
|
|
- name: source
|
|
description: Git source with migrations
|
|
- name: db-credentials
|
|
description: Database credentials secret
|
|
steps:
|
|
- name: apply-migration
|
|
image: postgres:16-alpine
|
|
workingDir: $(workspaces.source.path)
|
|
env:
|
|
- name: PGPASSWORD
|
|
valueFrom:
|
|
secretKeyRef:
|
|
name: memory-db-app
|
|
key: password
|
|
- name: PGHOST
|
|
value: memory-db-rw.poimen.svc.cluster.local
|
|
- name: PGUSER
|
|
value: app
|
|
- name: PGDATABASE
|
|
value: $(params.database-name)
|
|
script: |
|
|
#!/bin/sh
|
|
set -e
|
|
|
|
echo "Applying migration $(params.migration-version)_agent_memory_schema.sql"
|
|
|
|
# Wait for database to be ready
|
|
until pg_isready -h $PGHOST -U $PGUSER -d $PGDATABASE; do
|
|
echo "Waiting for database..."
|
|
sleep 2
|
|
done
|
|
|
|
# Apply migration
|
|
psql -h $PGHOST -U $PGUSER -d $PGDATABASE \
|
|
-f migrations/$(params.migration-version)_agent_memory_schema.sql
|
|
|
|
# Verify tables created
|
|
TABLES=$(psql -h $PGHOST -U $PGUSER -d $PGDATABASE -t -c \
|
|
"SELECT count(*) FROM information_schema.tables WHERE table_schema='public' AND table_name IN ('agent_prompt', 'agent_skill', 'agent_decision', 'role_prompt_mapping', 'agent_metrics')")
|
|
|
|
if [ "$TABLES" -eq 5 ]; then
|
|
echo "✓ All agent memory tables created successfully"
|
|
exit 0
|
|
else
|
|
echo "✗ Migration failed: expected 5 tables, found $TABLES"
|
|
exit 1
|
|
fi
|
|
|
|
- name: verify-indexes
|
|
image: postgres:16-alpine
|
|
env:
|
|
- name: PGPASSWORD
|
|
valueFrom:
|
|
secretKeyRef:
|
|
name: memory-db-app
|
|
key: password
|
|
- name: PGHOST
|
|
value: memory-db-rw.poimen.svc.cluster.local
|
|
- name: PGUSER
|
|
value: app
|
|
- name: PGDATABASE
|
|
value: $(params.database-name)
|
|
script: |
|
|
#!/bin/sh
|
|
set -e
|
|
|
|
echo "Verifying indexes..."
|
|
|
|
INDEXES=$(psql -h $PGHOST -U $PGUSER -d $PGDATABASE -t -c \
|
|
"SELECT count(*) FROM pg_indexes WHERE schemaname='public' AND tablename LIKE 'agent_%'")
|
|
|
|
if [ "$INDEXES" -gt 0 ]; then
|
|
echo "✓ Found $INDEXES indexes on agent tables"
|
|
psql -h $PGHOST -U $PGUSER -d $PGDATABASE -c \
|
|
"SELECT indexname FROM pg_indexes WHERE schemaname='public' AND tablename LIKE 'agent_%' ORDER BY indexname;"
|
|
else
|
|
echo "✗ No indexes found on agent tables"
|
|
exit 1
|
|
fi
|
|
|
|
- name: verify-schemas
|
|
image: postgres:16-alpine
|
|
env:
|
|
- name: PGPASSWORD
|
|
valueFrom:
|
|
secretKeyRef:
|
|
name: memory-db-app
|
|
key: password
|
|
- name: PGHOST
|
|
value: memory-db-rw.poimen.svc.cluster.local
|
|
- name: PGUSER
|
|
value: app
|
|
- name: PGDATABASE
|
|
value: $(params.database-name)
|
|
script: |
|
|
#!/bin/sh
|
|
set -e
|
|
|
|
echo "Verifying table schemas..."
|
|
|
|
# Verify agent_prompt table
|
|
psql -h $PGHOST -U $PGUSER -d $PGDATABASE -c "
|
|
SELECT column_name, data_type, is_nullable
|
|
FROM information_schema.columns
|
|
WHERE table_name='agent_prompt'
|
|
ORDER BY ordinal_position;"
|
|
|
|
echo "✓ Agent prompt schema verified"
|
|
|
|
# Verify role_prompt_mapping has foreign key
|
|
psql -h $PGHOST -U $PGUSER -d $PGDATABASE -c "
|
|
SELECT constraint_name, constraint_type
|
|
FROM information_schema.table_constraints
|
|
WHERE table_name='role_prompt_mapping';"
|
|
|
|
echo "✓ All table schemas verified"
|