Surfaces
Autonomous Code Factory
Self-improving code generation surface for the Allternit platform
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Self-improving code generation surface for the Allternit platform
https://ai.allternit.com/shell?view=acf
open('acf');
| Pillar | Purpose |
|---|---|
| RiskPolicy | Classify changes by risk tier |
| Evidence Validation | Bind artifacts to SHA-bound evidence |
| Merge Governance | Apply risk-tiered auto-merge rules |
| Remediation Loop | Re-apply deterministic patches until clean |
| Tier | Description |
|---|---|
low | Safe documentation, comment, and test-only changes |
medium | Localized logic changes with passing tests |
high | Structural changes requiring human review |
critical | Changes blocked for manual approval |
| Method | Path | Description |
|---|---|---|
POST | /api/v1/acf/generate | Submit a generation request |
POST | /api/v1/acf/validate | Validate evidence for a proposed change |
POST | /api/v1/acf/merge | Request merge governance decision |
POST | /api/v1/acf/remediate | Run a deterministic remediation loop |
curl -X POST https://api.allternit.com/api/v1/acf/generate \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Add input validation to the login handler",
"context": {
"repository": "allternit/api",
"file_paths": ["src/auth.ts"]
},
"risk_tier": "medium"
}'
{
"generation_id": "gen_1a2b...",
"status": "completed",
"risk_tier": "medium",
"artifacts": [
{
"path": "src/auth.ts",
"diff": "@@ -10,6 +10,10 @@...",
"evidence_sha": "sha256:abc123..."
}
]
}
curl -X POST https://api.allternit.com/api/v1/acf/validate \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"generation_id": "gen_1a2b...",
"artifact_path": "src/auth.ts",
"expected_sha": "sha256:abc123..."
}'
{
"valid": true,
"artifact_path": "src/auth.ts",
"evidence_sha": "sha256:abc123..."
}
curl -X POST https://api.allternit.com/api/v1/acf/merge \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"generation_id": "gen_1a2b...",
"risk_tier": "medium"
}'
{
"decision": "approved",
"conditions": ["tests_pass", "no_security_alerts"]
}
| HTTP | Code | Meaning |
|---|---|---|
| 200 | — | Operation succeeded |
| 400 | invalid_risk_tier | Risk tier not recognized |
| 401 | unauthorized | Missing or invalid bearer token |
| 409 | evidence_mismatch | Artifact SHA does not match evidence |
| 422 | merge_blocked | Governance conditions not met |
| 500 | internal_error | Factory service failure |