[codex] add taskfile common tasks

[KooshaPari]

This change adds a common Taskfile entrypoint for the repository and aligns it with the actual language surfaces detected in the checkout.

The repo is Go-first at the root, with a chat/ Next.js workspace and a docs/ Node-based documentation site. The new Taskfile.yml keeps the top-level commands stable while dispatching to language-specific subtasks only when the corresponding files exist.

What changed:

• build now runs Go, chat, and docs builds when those surfaces are present.
• test runs the Go test path for the detected Go module.
• lint runs Go vet plus the chat lint command.
• clean removes generated Go, chat, and docs artifacts.
• Session docs were added under docs/sessions/20260428-taskfile-agentapi-plusplus/ to capture the research, spec, implementation, and validation notes for this work.

Validation:

• task --list on the cloned repository, which now exposes build, test, lint, and clean.

The worktree still contains unrelated pre-existing deletions in generated docs artifacts, but those were not part of this change.

---

Note

Medium Risk
Build tooling is restructured and may change local/CI task behavior across Go, chat, and docs targets, potentially breaking automation if assumptions changed.

Overview
Introduces a new, language-aware Taskfile.yml (mirrored in agentapi-plusplus/Taskfile.yml) that standardizes top-level build, test, lint, and clean tasks and dispatches to Go/chat/docs subtasks only when their marker files exist.

The new tasks add explicit Go build/test with a pinned GOCACHE, chat build/lint via Bun, docs build via npm, and cleanup steps to remove generated artifacts for each surface.

Adds session documentation under docs/sessions/20260428-taskfile-agentapi-plusplus/ capturing goals, research, specs, and validation notes for the Taskfile work.

^{Reviewed by Cursor Bugbot for commit fb85236. Bugbot is set up for automated code reviews on this repo. Configure here.}

[gemini-code-assist]

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

[codeant-ai]

CodeAnt AI is reviewing your PR.

---

Thanks for using CodeAnt! 🎉

We're free for open-source projects. if you're enjoying it, help us grow by sharing.

Share on X ·
Reddit ·
LinkedIn

[coderabbitai]

Warning

Rate limit exceeded

@KooshaPari has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 55 minutes and 46 seconds before requesting another review.

To keep reviews running without waiting, you can enable usage-based add-on for your organization. This allows additional reviews beyond the hourly cap. Account admins can enable it under billing.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro

Run ID: 3f8cf795-ee6b-4786-9927-64fcb7d9bd34

📥 Commits

Reviewing files that changed from the base of the PR and between d63553d and fb85236.

📒 Files selected for processing (9)

• Taskfile.yml
• agentapi-plusplus/Taskfile.yml
• docs/sessions/20260428-taskfile-agentapi-plusplus/00_SESSION_OVERVIEW.md
• docs/sessions/20260428-taskfile-agentapi-plusplus/01_RESEARCH.md
• docs/sessions/20260428-taskfile-agentapi-plusplus/02_SPECIFICATIONS.md
• docs/sessions/20260428-taskfile-agentapi-plusplus/03_DAG_WBS.md
• docs/sessions/20260428-taskfile-agentapi-plusplus/04_IMPLEMENTATION_STRATEGY.md
• docs/sessions/20260428-taskfile-agentapi-plusplus/05_KNOWN_ISSUES.md
• docs/sessions/20260428-taskfile-agentapi-plusplus/06_TESTING_STRATEGY.md

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/add-taskfile-common-tasks

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is ON, but it could not run because the branch was deleted or merged before autofix could start.}

^{Reviewed by Cursor Bugbot for commit fb85236. Configure here.}

[cursor]

lint:chat status check skips task incorrectly

Medium Severity

The lint:chat task sets dir: chat while its status check uses test ! -f chat/package.json. Because status runs from the task's dir, it actually probes chat/chat/package.json, which never exists, so the status returns success and task treats the task as up-to-date and skips it. As a result task lint silently never runs the chat linter, contradicting the PR description. The sibling build:chat task uses the correct relative path package.json.

Additional Locations (1)

• agentapi-plusplus/Taskfile.yml#L75-L83

 

^{Reviewed by Cursor Bugbot for commit fb85236. Configure here.}