Manifest and Environment

tasksAgent uses a Ploinky-compatible manifest and explicit filesystem-related environment variables for root and lock handling.

Manifest

Main runtime file: tasksAgent/manifest.json.

{
  "container": "node:24.15.0-alpine",
  "lite-sandbox": true,
  "profiles": {
    "default": {
      "env": [
        "ASSISTOS_FS_ROOT",
        "WORKSPACE_ROOT",
        "PLOINKY_WORKSPACE_ROOT",
        "LOCK_FOLDER"
      ]
    }
  }
}

Environment Variables

Variable	Usage
`ASSISTOS_FS_ROOT`, `WORKSPACE_ROOT`, `PLOINKY_WORKSPACE_ROOT`, `MCP_FS_ROOT`	Used for workspace and path normalization and root resolution.
`LOCK_FOLDER`	Used for lock coordination where runtime lock-aware behavior applies.

Backlog File Contract

Backlog files must end with .backlog, history files must end with .history, and both must remain inside the selected repository root. The agent normalizes /.ploinky/... style inputs before validation.

Test Validation

Code changes should be treated as complete only after tasks agent tests under tasksAgent/tests pass, together with docs and specifications updates.