@zack/devwork-maintainer-state

Workflow-oriented Memory Blueprint for maintainer preferences, active work threads, and follow-up notes across repository review sessions.

Install
agentpm install @zack/devwork-maintainer-state@0.1.0
Inspect / load
agentpm memory inspect @zack/devwork-maintainer-state@0.1.0
Weekly installs
1
0%
Last publish
Today
v0.1.0
agent.json
{
  "name": "devwork-maintainer-state",
  "version": "0.1.0",
  "description": "Workflow-oriented Memory Blueprint for maintainer preferences, active work threads, and follow-up notes across repository review sessions.",
  "memory": {
    "scopes": {
      "user": {
        "description": "The maintainer whose working state is being retained."
      },
      "repository": {
        "description": "The repository where the maintainer workflow is happening."
      }
    },
    "record_types": {
      "work_thread": {
        "schema": "schemas/work-thread.schema.json",
        "version": "1.0.0",
        "description": "A durable summary of one active maintainer work thread."
      },
      "follow_up_note": {
        "schema": "schemas/follow-up-note.schema.json",
        "version": "1.0.0",
        "description": "A small follow-up note or decision cue attached to maintainer workflow."
      },
      "maintainer_preference": {
        "schema": "schemas/maintainer-preference.schema.json",
        "version": "1.0.0",
        "description": "Durable maintainer preferences for triage and follow-through style."
      }
    },
    "spaces": {
      "follow_up_notes": {
        "model": "collection",
        "scope": [
          "user",
          "repository"
        ],
        "capacity": {
          "max_records": 50
        },
        "retention": {
          "ttl": "P30D",
          "on_expire": "delete"
        },
        "retrieval": {
          "modes": [
            "filter",
            "semantic"
          ]
        },
        "constraints": {
          "append_only": true
        },
        "description": "Small maintainer notes that should survive across review sessions until acted on.",
        "record_types": [
          "follow_up_note"
        ]
      },
      "maintainer_profile": {
        "model": "document",
        "scope": [
          "user"
        ],
        "retention": {
          "ttl": "P365D",
          "on_expire": "archive"
        },
        "retrieval": {
          "modes": [
            "key",
            "semantic"
          ]
        },
        "description": "The current durable maintainer profile for triage and review preferences.",
        "record_types": [
          "maintainer_preference"
        ]
      },
      "active_work_threads": {
        "model": "collection",
        "scope": [
          "user",
          "repository"
        ],
        "retention": {
          "ttl": "P90D",
          "on_expire": "archive"
        },
        "retrieval": {
          "modes": [
            "filter",
            "semantic"
          ]
        },
        "description": "Current active maintainer threads for one repository.",
        "record_types": [
          "work_thread"
        ]
      }
    },
    "operations": {
      "refresh_work_thread": {
        "type": "transform",
        "inputs": [
          {
            "space": "active_work_threads",
            "record_type": "work_thread"
          }
        ],
        "output": {
          "space": "active_work_threads",
          "record_type": "work_thread"
        },
        "trigger": {
          "type": "interval",
          "every": "P14D"
        },
        "description": "Refresh one active work thread so the maintainer summary stays current.",
        "source_handling": "retain",
        "preserve_provenance": true
      },
      "delete_maintainer_state": {
        "type": "delete",
        "targets": [
          {
            "space": "maintainer_profile"
          },
          {
            "space": "active_work_threads"
          },
          {
            "space": "follow_up_notes"
          }
        ],
        "trigger": {
          "type": "external"
        },
        "description": "Delete maintainer workflow state for a repository when an external workflow requests removal.",
        "cascade_derived_records": true
      },
      "consolidate_follow_up_notes": {
        "type": "consolidate",
        "inputs": [
          {
            "space": "follow_up_notes",
            "record_type": "follow_up_note"
          }
        ],
        "output": {
          "space": "active_work_threads",
          "record_type": "work_thread"
        },
        "trigger": {
          "type": "record_count",
          "space": "follow_up_notes",
          "threshold": 4
        },
        "description": "Consolidate accumulated maintainer notes into one current work-thread summary.",
        "source_handling": "retain",
        "preserve_provenance": true
      }
    }
  },
  "readme": "README.md",
  "license": {
    "spdx": "MIT"
  }
}
Memory model
Scopes
user
The maintainer whose working state is being retained.
repository
The repository where the maintainer workflow is happening.
Record types
work_thread
v1.0.0
A durable summary of one active maintainer work thread.
Schema path: schemas/work-thread.schema.json
follow_up_note
v1.0.0
A small follow-up note or decision cue attached to maintainer workflow.
Schema path: schemas/follow-up-note.schema.json
maintainer_preference
v1.0.0
Durable maintainer preferences for triage and follow-through style.
Schema path: schemas/maintainer-preference.schema.json
Spaces
follow_up_notes
collection
Small maintainer notes that should survive across review sessions until acted on.
Scopes
user, repository
Record types
follow_up_note
Retrieval
filter, semantic
Capacity
50 records
Retention TTL
P30D
Expire action
delete
Append only
true
maintainer_profile
document
The current durable maintainer profile for triage and review preferences.
Scopes
user
Record types
maintainer_preference
Retrieval
key, semantic
Capacity
Not declared
Retention TTL
P365D
Expire action
archive
Append only
Not declared
active_work_threads
collection
Current active maintainer threads for one repository.
Scopes
user, repository
Record types
work_thread
Retrieval
filter, semantic
Capacity
Not declared
Retention TTL
P90D
Expire action
archive
Append only
Not declared
Build metadata
Build type
agentpm-memory-contracts
Format version
1
Contract count
3
Built at
2026-07-30T00:15:37Z
AgentPM version
0.1.19
Manifest path
agent.json