Skip to content

PROJECT_MAP.md

Latest commit

 

History

History
67 lines (48 loc) · 3.69 KB

PROJECT_MAP.md

File metadata and controls

67 lines (48 loc) · 3.69 KB
Raw

Project Map

This is the current ownership map after the package cleanup.

The repo root intentionally has four product directories: atulya/, tantra/, yantra/, and drishti/. Shared support files live inside the product folder that owns them.

Allowed root support directories:

  • assets/: runtime-local app state such as generated voice audio, temp uploads, and scheduler state.
  • config/: cross-package static configuration that is not owned by one runtime package.
  • outputs/: generated reports, invoices, benchmarks, and other local run artifacts.

Do not add new root directories unless they are documented here and in the structure audit. New implementation should go into the owning product package.

Tantra: Support And Compatibility

Support-layer and legacy compatibility files live under tantra/. Active custom LLM/model architecture, tokenizer development, training jobs, checkpoints, and model release artifacts belong in the separate model repository.

  • tantra/core/: task classification, context control, security, encryption, audit logging, and model/provider failover helpers.
  • tantra/config/: support-layer configuration.
  • tantra/scripts/: support and compatibility utilities.
  • tantra/npdna/: legacy/reference NP-DNA compatibility code retained for older routes, tests, and artifacts.
  • tantra/training/: legacy/reference dataset and training utilities retained for compatibility.
  • tantra/outputs/: generated local artifacts. Do not treat this as the active model release location.
  • tantra/README.md: current boundary for what Tantra owns in this app repo.

Drishti: User Interface Surface

Drishti-owned files live under drishti/.

  • drishti/frontend/src/: editable React source and browser API client.
  • drishti/dist/, drishti/build/: generated frontend/package artifacts.
  • drishti/backend/app.py: dashboard launcher for python -m drishti.backend.app.
  • drishti/backend/dashboard/: FastAPI dashboard app, helpers, state, and API route implementation.
  • drishti/api/: Drishti import wrappers around shared dashboard routes.
  • drishti/package.json, drishti/vite.config.js, drishti/index.html: frontend build and Vite setup.
  • start_dashboard.bat: root-level convenience launcher for the Drishti.

Yantra: Automation And Tools

Automation-owned files live under yantra/.

  • yantra/capabilities/: tool registry, workflow engine, browser automation, voice pipeline, and web search.
  • yantra/tools/: compatibility imports for older callers.
  • yantra/mcp/: MCP server, client, transport, signed manifests, dashboard bridge, and agent runner.
  • yantra/mcp/external_client.py: external MCP server connection manager.
  • yantra/assistant/: assistant channels, task brain, cron scheduler, and source ingestion.
  • yantra/channels.py: unified 14-channel system (Discord, Telegram, Slack, Email, Webhook, WhatsApp, Signal, Matrix, Teams, IRC, WebChat, Console, Log, Twitter).
  • yantra/plugins/: plugin lifecycle and safety checks.
  • yantra/dispatch.py: classifier-aware capability dispatch.
  • yantra/selfimprovement/: unified self-improvement tracker (bridge.py merged into unified.py).

Atulya: Application AI Layer

Application-owned AI files live under atulya/.

  • memory/: memory orchestrator, session search, prompt cache, subconscious log, reflection, memory tree, and Obsidian export.
  • docs/: architecture, contribution, security, project map, and product direction notes.
  • tests/: Atulya and integration tests.
  • atulya/identity.py: identity and role-aware prompt helpers.
  • atulya/cli.py: command-line entry point.

New implementation should go into the owning package above. Do not add duplicate compatibility packages unless a real external API requires it.