akurai-tasks

public

Latest change 0ebc8f7b869c597e18bb88dcc45206e7cc21c930 - Add project archive/unarchive/delete across core, CLI, REST, and MCP by Ólafur Búi Ólafsson

---
title: AkurAI-Tasks agent index
project: AkurAI-Tasks
repository: akurai-build:akurai-tasks
kind: agents
status: implementation
notes_notebook_id: 34
passvault_folder_id: 5
updated: 2026-07-14
---

# AkurAI-Tasks

Repository work runs on Titan. Follow the global host, maintained-operations,
UI-feedback, and secret-handling rules. Read `PLAN.md` before implementation.

## Current state

The local vertical slice now provides one Rust binary, embedded BTree command core,
multi-project/repository tasks, CLI, authenticated REST, a 25-tool MCP surface, and the human
Kanban UI. MCP parity includes `work_list`, `work_block`, `work_unblock`, `events_read`, and
`system_doctor`.
`scripts/check.sh` is the current executable gate. Import, OIDC/session auth, complete lease
expiry fencing, backup/restore, deployment, production data, source migration, and cutover do
not exist yet. Never report production operation or plan completion until the remaining
acceptance gates in `PLAN.md` pass.

## Architecture rules

- Build on AkurAI-Framework crates and the AkurAI Notes pattern: one Rust workspace, one
binary, one embedded BTree database, web/REST/MCP in the same process.
- Keep domain rules in one core command layer. REST, MCP, CLI, and web handlers call that
layer; they do not implement parallel transition logic.
- Current task state and its append-only audit event are committed atomically under one
database lock.
- Every mutation is idempotent, actor-attributed, revision-checked, and validated server-side.
- Preserve source records losslessly during migration. Never overwrite collisions, infer
missing history, or treat audit snapshots as live boards.
- Use structured filters. Do not build a JQL clone, workflow DSL, plugin system, queue,
semantic index, or microservice without measured need.
- ACP connects editors to agents; AkurAI-Tasks is an MCP tool server. Do not implement an ACP
task-store server.

## Project records

- Canonical implementation plan: `PLAN.md`; mirror each approved revision to the AkurAI Notes
notebook as an approval record and handoff summary.
- Operational and architectural notes: AkurAI Notes notebook `AkurAI-Tasks` (ID 34).
- Credentials and connector tokens: AkurAI PassVault folder `AkurAI-Tasks` (ID 5). Store only
PassVault entry references in configuration; never secret values.
- Source of truth is AkurAI Build hosted Git at
`https://akurai-build.olibuijr.com/git/akurai-tasks.git`; publish with
`./deploy.sh cli repo sync akurai-tasks <checkout>` and run CI with
`./deploy.sh cli run akurai-tasks --git-ref main`. GitHub is no longer used.
- Repository code and executable public documentation stay in Git. Notes do not replace
build/runtime inputs.
- Install and verify the Titan-local CLI only through `akurai-data-cli install|status`.
Local installation is not a deployment, migration, cutover, or production-readiness claim.

## Required implementation gates

Use focused commands during development. Add a gate only when its real capability exists:

- Increment 1: `scripts/check.sh` plus a focused local authenticated CLI/REST/MCP smoke;
- Increment 3: `scripts/test-import.sh`;
- Increment 5/final pre-deploy: `scripts/validate.sh --local`;
- post-deploy and before enabling writes: `scripts/validate.sh --live` plus the restore and
complete source-fence probes named in `PLAN.md`.

Never add placeholder scripts that return success. Pre-deploy production gate:

```sh
./scripts/check.sh
./scripts/test-import.sh
./scripts/validate.sh --local
```

Post-deploy/pre-write-enable gate:

```sh
./scripts/validate.sh --live
```

Deployment must use the maintained AkurAI Build/AkurAI deployment path from Titan. No ad-hoc
systemd, Nginx, TLS, database copy, or secret provisioning commands.