socialseed-tasker 0.9.0

A graph-based task management framework for AI agents

🌌 SocialSeed Tasker

The Operational Brain for AI-Driven Engineering

SocialSeed Tasker is the definitive framework for teams and organizations scaling their development with AI Agents. While agents provide speed, Tasker provides the Architectural Guardrails that prevent your codebase from descending into chaos.

---

🚀 Why SocialSeed Tasker?

In the age of autonomous coding, speed is no longer the bottleneck—context and safety are. Tasker turns your repository into a living, reasoning graph that AI agents can navigate with precision, ensuring every change is calculated, documented, and safe.

🛡️ Develop with Agents, Without the Breakage

Agents can't see what they might break three layers deep. Tasker can. Our Graph-Based Impact Analysis maps every dependency, blocking risky changes before they happen.

🧠 Infinite Context for LLMs

Stop feeding agents raw text. Tasker's Code-as-Graph (powered by Tree-Sitter) provides agents with a semantic map of your functions, classes, and imports, reducing "hallucinations" and increasing success rates.

👁️ Human-in-the-Loop Visibility

With AI Reasoning Logs, you see exactly why an agent made a decision. No more black boxes—just clear, traceable engineering logic.

---

💎 Key Features for the Modern Tech Stack

• Graph-Native Management: Powered by Neo4j, managing complex microservices dependencies is as simple as a single query.
• Impact Analysis Engine: Instantly calculate the "Blast Radius" of any code change or issue resolution.
• RAG-Powered Discovery: Semantic search across your entire task history and codebase to find similar solutions in seconds.
• Architectural Constraints: Set "Hard Rules" (e.g., "No circular dependencies", "Must use PostgreSQL") that both agents and humans must follow.
• Vue-Powered Observability: A stunning Kanban and Graph dashboard to visualize your project's health in real-time.

---

🤖 Quick Start for AI Agents

Getting your agents up and running with Tasker takes seconds.

# 1. Install the Brain
pip install socialseed-tasker

# 2. Spin up the Infrastructure
docker compose up -d

# 3. Give the Agent Context (The Magic Part)
tasker agent context --issue "ISSUE_ID"

This single command provides an agent with the specific code symbols, dependencies, and historical context needed to solve the task safely.

---

🏢 Built for Scale

Whether you are a solo developer managing a dozen agents or an enterprise architect overseeing 50 microservices, Tasker scales with you.

• CTOs & Tech Leads: Enforce architectural standards automatically across all teams.
• DevOps: Monitor system stability and root-cause failures through causal graph inference.
• Product Managers: Get real-time, data-driven insights into project blockers and critical paths.

---

📚 Full Documentation

For detailed technical guides, API references, and architectural deep-dives, visit our official documentation site:

👉 https://daironpf.github.io/socialseed-tasker/

📖 v0.9.0 Documentation

• CLI Commands Reference
• API Reference
• Graph Model Schema
• RAG & Vector Indexes Guide
• Code-as-Graph Guide

---

🔧 Troubleshooting

Neo4j Container Fails to Start

If you see the error: Invalid value for password. It cannot be 'neo4j', which is the default.

Cause: Neo4j 5.x security policy prevents using "neo4j" as the password (it must differ from the username).

Solution: Use a different password in docker-compose.yml:

environment:
  - NEO4J_AUTH=neo4j/neoSocial  # password must NOT be "neo4j"

Also ensure the API environment variables match:

- TASKER_NEO4J_PASSWORD=neoSocial

Restart after changing:

docker compose down -v
docker compose up -d

---

🤝 Contributing

We are building the future of autonomous engineering. Join us!

• GitHub: daironpf/socialseed-tasker
• License: Apache 2.0

---

"Speed is a byproduct of clarity. Tasker provides the clarity."