yamtam-engine 0.15.0__tar.gz

yamtam_engine-0.15.0/.claude/templates/README.md

@@ -0,0 +1,130 @@
+# [Project Name]
+
+> [One-sentence description of what this project does and who it's for.]
+
+---
+
+## Overview
+
+[2–3 paragraphs describing the project in detail. What problem does it solve? Who uses it? Why does it exist? What makes it different from alternatives?]
+
+---
+
+## Tech Stack
+
+| Layer | Technology | Notes |
+|-------|-----------|-------|
+| Frontend | [e.g., Next.js 14, React 18, TypeScript] | [e.g., App Router] |
+| Styling | [e.g., Tailwind CSS, shadcn/ui] | |
+| Backend | [e.g., Node.js, Fastify] | |
+| Database | [e.g., PostgreSQL 15] | |
+| ORM | [e.g., Prisma] | |
+| Auth | [e.g., NextAuth.js] | |
+| Hosting | [e.g., Railway, Vercel, Fly.io] | |
+| CI/CD | [e.g., GitHub Actions] | |
+
+---
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js [x.x.x]+ (see `.nvmrc`)
+- [Package manager: npm / pnpm / yarn]
+- [e.g., PostgreSQL 15 running locally, or Docker]
+- [Any other prerequisites]
+
+### Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/[org]/[repo].git
+cd [repo]
+
+# Install dependencies
+[npm install]
+
+# Copy environment variables
+cp .env.example .env.local
+# Edit .env.local and fill in required values
+```
+
+### Running Locally
+
+```bash
+# Start the development server
+[npm run dev]
+```
+
+Open [http://localhost:3000](http://localhost:3000) in your browser.
+
+### Running Tests
+
+```bash
+# Unit tests
+[npm test]
+
+# E2E tests (requires dev server running)
+[npm run test:e2e]
+
+# Type checking
+[npm run typecheck]
+```
+
+---
+
+## Project Structure
+
+```
+[project-root]/
+├── src/
+│   ├── app/              # [e.g., Next.js App Router pages and layouts]
+│   ├── components/       # Shared UI components
+│   └── lib/              # Utilities, helpers, shared logic
+├── tests/
+│   └── e2e/              # Playwright E2E tests
+├── docs/
+│   ├── user/             # User-facing documentation
+│   └── technical/        # Architecture, API, database docs
+├── .claude/agents/       # Claude Code specialist agents
+├── public/               # Static assets
+├── PRD.md                # Product requirements (source of truth)
+├── TODO.md               # Project backlog
+└── CLAUDE.md             # Claude AI instructions
+```
+
+---
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `DATABASE_URL` | Yes | PostgreSQL connection string |
+| `[NEXTAUTH_SECRET]` | Yes | [Auth secret] |
+| `[NEXTAUTH_URL]` | Yes | [App base URL] |
+| `[OTHER_VAR]` | No | [Description] |
+
+See `.env.example` for all available variables.
+
+---
+
+## Deployment
+
+[Describe the deployment process. E.g.:]
+
+The application deploys automatically via GitHub Actions on merge to `main`.
+
+- **Production**: [URL]
+- **Staging**: [URL]
+
+Manual deployment:
+```bash
+[npm run build]
+[deployment command]
+```
+
+---
+
+## License
+
+[MIT / proprietary / other] — see [LICENSE](LICENSE)

yamtam_engine-0.15.0/.gitignore

@@ -0,0 +1,56 @@
+# Secrets
+*.env
+*.env.*
+.env.local
+.env.production
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Node
+node_modules/
+
+# Memory pipeline
+memory/L0_raw/
+memory/L1_atomic/private/
+# L2 session facts are provisional — not persisted across sessions
+memory/L2_session/*.md
+!memory/L2_session/SCHEMA.md
+
+# Build
+dist/
+.next/
+.claude/state/
+releases/logs/
+.mcp.json
+.codegraph/
+
+# Local runtime audit logs
+core/memory/audit/*
+!core/memory/audit/.gitkeep
+
+# Local backup files generated by adapter switching
+*.bak
+*.bak.*
+
+# Local artifacts
+__pycache__/
+*.pyc
+reports/audit-local.*
+
+
+# Added by cargo
+
+/target
+
+# YAMTAM
+.yamtam/
+yamtam-*.html
+yamtam-*.sarif
+releases/*.zip
+releases/*.bundle
+releases/*.bundle.sha256
+yamtam-transfer*.zip
+yamtam-patch-files*.zip
+.yamtam/graph/

yamtam_engine-0.15.0/.out-of-scope/README.md

@@ -0,0 +1,28 @@
+# YAMTAM ENGINE — Out of Scope
+
+Things YAMTAM will deliberately NOT do, and why.
+
+This folder exists to resist scope creep. Every item here was considered and rejected.
+Before adding a new feature, check if it belongs here instead.
+
+---
+
+## How to read this
+
+Each file documents one rejected direction:
+- **What it is** — the feature or capability
+- **Why it's tempting** — the real use case that makes it feel worth adding
+- **Why we don't do it** — the actual reason (complexity, wrong layer, existing solution)
+- **What to do instead** — the right path if you actually need this
+
+---
+
+## Index
+
+| File | Topic |
+|------|-------|
+| [real-time-cost-dashboard.md](real-time-cost-dashboard.md) | Live token/cost monitoring UI |
+| [enterprise-rbac.md](enterprise-rbac.md) | Full role-based access control system |
+| [multi-agent-coordination.md](multi-agent-coordination.md) | Orchestrating multiple YAMTAM instances |
+| [cloud-console-protection.md](cloud-console-protection.md) | Protecting cloud infrastructure |
+| [l3-l4-memory-tiers.md](l3-l4-memory-tiers.md) | Episodic and long-term memory layers |