ACP Attempts

AI Context Protocol debug session tracking file

Type object
File match **/.acp/acp.attempts.json acp.attempts.json
Schema URL https://catalog.lintel.tools/schemas/schemastore/acp-attempts/latest.json
Source https://acp-protocol.dev/schemas/v1/attempts.schema.json

Validate with Lintel

npx @lintel/lintel check
Type: object

AI Context Protocol attempts tracking file format (.acp/acp.attempts.json)

Properties

version string required

ACP specification version

Examples: "1.0.0"
pattern=^\d+\.\d+\.\d+
updated_at string required

Last update timestamp (ISO 8601)

format=date-time
attempts Record<string, object> required

Active attempts indexed by ID

checkpoints Record<string, object> required

Checkpoints indexed by name

history attempt_history_entry[] required

History of completed/reverted attempts (max 1000 entries)

maxItems=1000
$schema string

JSON Schema URL for validation

Definitions

tracked_attempt object
id string required

Unique attempt identifier

minLength=1
status string required

Current status of the attempt

Values: "active" "testing" "failed" "verified" "reverted"
created_at string required

When the attempt was started

format=date-time
updated_at string required

When the attempt was last updated

format=date-time
files attempt_file[] required

Files modified in this attempt

revert_if string[] required

Conditions that should trigger automatic revert

for_issue string

Related issue/ticket reference

description string

Description of what this attempt is trying to accomplish

attempt_file object
path string required

File path relative to project root

minLength=1
original_hash string required

MD5 hash of original content

pattern=^[a-f0-9]{32}$
modified_hash string required

MD5 hash of modified content

pattern=^[a-f0-9]{32}$
original_content string

Original file content (stored if under size limit)

lines_changed integer[]

[start_line, end_line] of changes. Semantic constraint: start_line <= end_line

minItems=2maxItems=2
tracked_checkpoint object
name string required

Checkpoint name

minLength=1
created_at string required

When the checkpoint was created

format=date-time
files Record<string, object> required

File states at checkpoint time

description string

Description of checkpoint state

git_commit string

Git commit SHA at checkpoint time

pattern=^[a-f0-9]{40}$
file_state object
hash string required

MD5 hash of file content

pattern=^[a-f0-9]{32}$
content string

File content (stored if under size limit)

attempt_history_entry object
id string required

Attempt identifier

minLength=1
status string required

Current status of the attempt

Values: "active" "testing" "failed" "verified" "reverted"
started_at string required

When the attempt started

format=date-time
ended_at string required

When the attempt ended

format=date-time
files_modified integer required

Number of files modified

min=0
for_issue string

Related issue/ticket reference

outcome string

Description of outcome

attempt_status string

Current status of the attempt