{"owner":"EverMind-AI","repo":"EverOS","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["CLAUDE.md"],"skills":{"CLAUDE.md":"# EverOS — md-first Memory Extraction Framework\n\nThis is a Python framework for md-first memory extraction (lightweight; single-user or small-team).\n\n## Quick commands\n\n```bash\nuv sync                    # install deps\nmake lint                  # ruff (check + format-check) + import-linter\nmake format                # auto-fix formatting\nmake test                  # pytest tests/unit\nmake integration           # pytest tests/integration\nmake ci                    # full CI: lint + test + integration\n```\n\n## Architecture\n\nDDD 5 layers + cross-cutting:\n\n```\nentrypoints  →  service  →  memory  →  infra\n                              ↓\n                        component / core / config\n```\n\n- `entrypoints/` — cli + api (Presentation)\n- `service/` — use case orchestration (memorize / retrieve / evolve / manage)\n- `memory/` — domain (extract + search + cascade + prompt_slots + models)\n- `infra/` — storage adapters (markdown + sqlite + lancedb)\n- `component/` — injectable providers (llm / embedding / config / utils)\n- `core/` — runtime base (observability / lifespan / context)\n- `config/` — configuration data (Settings + default.toml)\n\n**Dependency rule**: `entrypoints → service → memory → infra`. Single-direction, enforced by `import-linter`.\n\nDetailed: [docs/architecture.md](docs/architecture.md).\n\n## Engineering practices\n\n- **Coding rules** auto-loaded from [.claude/rules/](.claude/rules/) (10 rules; the three always-loaded ones cover architecture / code-style / language-policy, the rest are path-scoped and load when Claude Code opens a matching file)\n- **Workflows** as slash commands in [.claude/skills/](.claude/skills/) — `/commit`, `/new-branch`, `/pr`, `/release`\n- **Project-level decisions** in [docs/](docs/) (low-frequency, human-judgment-required)\n- **Language policy**: the project targets a global audience — docs and code are English; CJK appears only in test fixtures and locale-suffixed mirrors. Scanned by `make check-cjk`.\n- **Datetime discipline**: never call `datetime.now()` / `time.time()` directly — use `everos.component.utils.datetime`. Enforced by `make check-datetime`.\n\nContributor engineering reference — build, test, CI gates, branch & commit conventions: [docs/engineering.md](docs/engineering.md).\n\n## Branch strategy\n\n`main` is the default and protected branch. Create scoped branches from\n`main` (`feat/*`, `fix/*`, `docs/*`, `ci/*`, `chore/*`, `refactor/*`) and open\npull requests back to `main` after the required checks pass.\n\nSee [.claude/skills/new-branch/SKILL.md](.claude/skills/new-branch/SKILL.md)\nfor the full branch workflow.\n\n## GitHub sync guard\n\nWhen refreshing this repository from an internal source archive, preserve\nGitHub-only contributor and automation files. Do not overwrite `CLAUDE.md`,\n`.claude/skills/*`, `CONTRIBUTING.md`, or `.github/*` workflow/template files\nwithout checking [docs/github-sync.md](docs/github-sync.md).\n\n## Storage three-piece set\n\n```\nMarkdown (truth)  +  SQLite (state)  +  LanceDB (vector + BM25 + scalar)\n```\n\n- Memory root: `~/.everos/{agents,users,knowledge}/` (md files = single source of truth)\n- System DB: `~/.everos/.index/sqlite/system.db` (state + audit + queue + metadata)\n- Index: `~/.everos/.index/lancedb/` (rebuildable from md)\n\nSelection rationale: [docs/architecture.md](docs/architecture.md).\n\n## Source layout\n\n**src layout** (`src/everos/<...>`): standard PyPA project structure — code lives under `src/` so the working tree is not on the import path until installed, preventing accidental imports of in-development modules.\n\nAlgorithm assets (prompts, extractors) live in the separate [`everalgo`](https://github.com/EverMind-AI/EverAlgo) library, consumed here as the `everalgo-*` PyPI packages.\n\n## Where things go\n\n| Want to... | Look at |\n|---|---|\n| Understand architecture | [docs/architecture.md](docs/architecture.md) |\n| Understand storage choice | [docs/architecture.md](docs/architecture.md) (storage section) |\n| Build, test, CI & conventions | [docs/engineering.md](docs/engineering.md) |\n| Add a new module | [.claude/rules/init-py-and-reexport.md](.claude/rules/init-py-and-reexport.md) |\n| Make a commit | use `/commit` |\n| Open a branch / PR | use `/new-branch` / `/pr` |\n| Run checks before pushing | `make ci` |\n"},"files":{"CLAUDE.md":"# EverOS — md-first Memory Extraction Framework\n\nThis is a Python framework for md-first memory extraction (lightweight; single-user or small-team).\n\n## Quick commands\n\n```bash\nuv sync                    # install deps\nmake lint                  # ruff (check + format-check) + import-linter\nmake format                # auto-fix formatting\nmake test                  # pytest tests/unit\nmake integration           # pytest tests/integration\nmake ci                    # full CI: lint + test + integration\n```\n\n## Architecture\n\nDDD 5 layers + cross-cutting:\n\n```\nentrypoints  →  service  →  memory  →  infra\n                              ↓\n                        component / core / config\n```\n\n- `entrypoints/` — cli + api (Presentation)\n- `service/` — use case orchestration (memorize / retrieve / evolve / manage)\n- `memory/` — domain (extract + search + cascade + prompt_slots + models)\n- `infra/` — storage adapters (markdown + sqlite + lancedb)\n- `component/` — injectable providers (llm / embedding / config / utils)\n- `core/` — runtime base (observability / lifespan / context)\n- `config/` — configuration data (Settings + default.toml)\n\n**Dependency rule**: `entrypoints → service → memory → infra`. Single-direction, enforced by `import-linter`.\n\nDetailed: [docs/architecture.md](docs/architecture.md).\n\n## Engineering practices\n\n- **Coding rules** auto-loaded from [.claude/rules/](.claude/rules/) (10 rules; the three always-loaded ones cover architecture / code-style / language-policy, the rest are path-scoped and load when Claude Code opens a matching file)\n- **Workflows** as slash commands in [.claude/skills/](.claude/skills/) — `/commit`, `/new-branch`, `/pr`, `/release`\n- **Project-level decisions** in [docs/](docs/) (low-frequency, human-judgment-required)\n- **Language policy**: the project targets a global audience — docs and code are English; CJK appears only in test fixtures and locale-suffixed mirrors. Scanned by `make check-cjk`.\n- **Datetime discipline**: never call `datetime.now()` / `time.time()` directly — use `everos.component.utils.datetime`. Enforced by `make check-datetime`.\n\nContributor engineering reference — build, test, CI gates, branch & commit conventions: [docs/engineering.md](docs/engineering.md).\n\n## Branch strategy\n\n`main` is the default and protected branch. Create scoped branches from\n`main` (`feat/*`, `fix/*`, `docs/*`, `ci/*`, `chore/*`, `refactor/*`) and open\npull requests back to `main` after the required checks pass.\n\nSee [.claude/skills/new-branch/SKILL.md](.claude/skills/new-branch/SKILL.md)\nfor the full branch workflow.\n\n## GitHub sync guard\n\nWhen refreshing this repository from an internal source archive, preserve\nGitHub-only contributor and automation files. Do not overwrite `CLAUDE.md`,\n`.claude/skills/*`, `CONTRIBUTING.md`, or `.github/*` workflow/template files\nwithout checking [docs/github-sync.md](docs/github-sync.md).\n\n## Storage three-piece set\n\n```\nMarkdown (truth)  +  SQLite (state)  +  LanceDB (vector + BM25 + scalar)\n```\n\n- Memory root: `~/.everos/{agents,users,knowledge}/` (md files = single source of truth)\n- System DB: `~/.everos/.index/sqlite/system.db` (state + audit + queue + metadata)\n- Index: `~/.everos/.index/lancedb/` (rebuildable from md)\n\nSelection rationale: [docs/architecture.md](docs/architecture.md).\n\n## Source layout\n\n**src layout** (`src/everos/<...>`): standard PyPA project structure — code lives under `src/` so the working tree is not on the import path until installed, preventing accidental imports of in-development modules.\n\nAlgorithm assets (prompts, extractors) live in the separate [`everalgo`](https://github.com/EverMind-AI/EverAlgo) library, consumed here as the `everalgo-*` PyPI packages.\n\n## Where things go\n\n| Want to... | Look at |\n|---|---|\n| Understand architecture | [docs/architecture.md](docs/architecture.md) |\n| Understand storage choice | [docs/architecture.md](docs/architecture.md) (storage section) |\n| Build, test, CI & conventions | [docs/engineering.md](docs/engineering.md) |\n| Add a new module | [.claude/rules/init-py-and-reexport.md](.claude/rules/init-py-and-reexport.md) |\n| Make a commit | use `/commit` |\n| Open a branch / PR | use `/new-branch` / `/pr` |\n| Run checks before pushing | `make ci` |\n"},"items":[{"name":"CLAUDE.md","path":"CLAUDE.md","title":"CLAUDE.md","content":"# EverOS — md-first Memory Extraction Framework\n\nThis is a Python framework for md-first memory extraction (lightweight; single-user or small-team).\n\n## Quick commands\n\n```bash\nuv sync                    # install deps\nmake lint                  # ruff (check + format-check) + import-linter\nmake format                # auto-fix formatting\nmake test                  # pytest tests/unit\nmake integration           # pytest tests/integration\nmake ci                    # full CI: lint + test + integration\n```\n\n## Architecture\n\nDDD 5 layers + cross-cutting:\n\n```\nentrypoints  →  service  →  memory  →  infra\n                              ↓\n                        component / core / config\n```\n\n- `entrypoints/` — cli + api (Presentation)\n- `service/` — use case orchestration (memorize / retrieve / evolve / manage)\n- `memory/` — domain (extract + search + cascade + prompt_slots + models)\n- `infra/` — storage adapters (markdown + sqlite + lancedb)\n- `component/` — injectable providers (llm / embedding / config / utils)\n- `core/` — runtime base (observability / lifespan / context)\n- `config/` — configuration data (Settings + default.toml)\n\n**Dependency rule**: `entrypoints → service → memory → infra`. Single-direction, enforced by `import-linter`.\n\nDetailed: [docs/architecture.md](docs/architecture.md).\n\n## Engineering practices\n\n- **Coding rules** auto-loaded from [.claude/rules/](.claude/rules/) (10 rules; the three always-loaded ones cover architecture / code-style / language-policy, the rest are path-scoped and load when Claude Code opens a matching file)\n- **Workflows** as slash commands in [.claude/skills/](.claude/skills/) — `/commit`, `/new-branch`, `/pr`, `/release`\n- **Project-level decisions** in [docs/](docs/) (low-frequency, human-judgment-required)\n- **Language policy**: the project targets a global audience — docs and code are English; CJK appears only in test fixtures and locale-suffixed mirrors. Scanned by `make check-cjk`.\n- **Datetime discipline**: never call `datetime.now()` / `time.time()` directly — use `everos.component.utils.datetime`. Enforced by `make check-datetime`.\n\nContributor engineering reference — build, test, CI gates, branch & commit conventions: [docs/engineering.md](docs/engineering.md).\n\n## Branch strategy\n\n`main` is the default and protected branch. Create scoped branches from\n`main` (`feat/*`, `fix/*`, `docs/*`, `ci/*`, `chore/*`, `refactor/*`) and open\npull requests back to `main` after the required checks pass.\n\nSee [.claude/skills/new-branch/SKILL.md](.claude/skills/new-branch/SKILL.md)\nfor the full branch workflow.\n\n## GitHub sync guard\n\nWhen refreshing this repository from an internal source archive, preserve\nGitHub-only contributor and automation files. Do not overwrite `CLAUDE.md`,\n`.claude/skills/*`, `CONTRIBUTING.md`, or `.github/*` workflow/template files\nwithout checking [docs/github-sync.md](docs/github-sync.md).\n\n## Storage three-piece set\n\n```\nMarkdown (truth)  +  SQLite (state)  +  LanceDB (vector + BM25 + scalar)\n```\n\n- Memory root: `~/.everos/{agents,users,knowledge}/` (md files = single source of truth)\n- System DB: `~/.everos/.index/sqlite/system.db` (state + audit + queue + metadata)\n- Index: `~/.everos/.index/lancedb/` (rebuildable from md)\n\nSelection rationale: [docs/architecture.md](docs/architecture.md).\n\n## Source layout\n\n**src layout** (`src/everos/<...>`): standard PyPA project structure — code lives under `src/` so the working tree is not on the import path until installed, preventing accidental imports of in-development modules.\n\nAlgorithm assets (prompts, extractors) live in the separate [`everalgo`](https://github.com/EverMind-AI/EverAlgo) library, consumed here as the `everalgo-*` PyPI packages.\n\n## Where things go\n\n| Want to... | Look at |\n|---|---|\n| Understand architecture | [docs/architecture.md](docs/architecture.md) |\n| Understand storage choice | [docs/architecture.md](docs/architecture.md) (storage section) |\n| Build, test, CI & conventions | [docs/engineering.md](docs/engineering.md) |\n| Add a new module | [.claude/rules/init-py-and-reexport.md](.claude/rules/init-py-and-reexport.md) |\n| Make a commit | use `/commit` |\n| Open a branch / PR | use `/new-branch` / `/pr` |\n| Run checks before pushing | `make ci` |\n","category":"root","tokens":1065}]}