codex-services 0.1.2__tar.gz → 0.1.4__tar.gz

codex_services-0.1.4/.agents/rules/graphify.md

@@ -0,0 +1,10 @@
+## Local code graph
+
+This repository uses only its own `graphify-out/`. It does not depend on the parent workspace graph.
+
+- Before architecture or code-navigation work, read `graphify-out/GRAPH_REPORT.md` when available. If a local `graphify-out/wiki/index.md` exists, use it as an additional entrypoint; native code updates do not generate a wiki.
+- Follow `.graphifyignore` to keep environments, caches, build outputs, generated documentation sites, and graph output out of the corpus. Never run the update from the parent workspace for work on this library.
+- Build or refresh with `graphify update .` from this repository root, using the separately installed Graphify tool. This is an AST-only code update, with no LLM/API calls. Documentation may be counted in corpus detection but is not semantically extracted by this command; consult source documentation and skills directly.
+- For relationships within this library, use `graphify query`, `graphify path`, or `graphify explain` from this repository root when they help. Verify inferred relationships against current code. For cross-library contracts, consult public APIs and the relevant library skills.
+- After changing code or graph exclusions, refresh the local graph. If no graph exists or the tool fails, inspect current source and report the missing/stale graph; do not silently fall back to a shared graph.
+- `graphify-out/` is generated local data, ignored by Git and excluded from release artifacts. Commit `.graphifyignore` and these instructions, not graph JSON, reports, HTML, wiki pages, caches, or machine-specific interpreter paths.

codex_services-0.1.4/.agents/skills/codex-services-development/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: codex-services-development
+description: Develop and validate the codex-services library itself, including booking algorithms, calendar behavior, packaged consumer skills and release artifacts. Use in its source checkout; consumer integrations use the shipped codex-services skill.
+---
+
+# codex-services development
+
+## Ownership and navigation
+
+This repository publishes `codex-services` through `pyproject.toml` and `.github/workflows/publish.yml`. Keep development guidance here. Consumer guidance belongs in `src/codex_services/agent_skills/resources/`; do not install that managed copy over this development skill.
+
+Read `.agents/rules/graphify.md` for the library-local `graphify-out/` scope and rebuild command. Use the local report (and wiki when present) for orientation, then inspect the relevant current source and tests: graph edges may be inferred or stale. Cross-library contracts belong in public APIs and the relevant library skills, not a shared workspace graph.
+
+- Booking search: `src/codex_services/booking/slot_master/` and `tests/unit/`, `tests/integration/`; architecture context in `docs/en/architecture/booking_engine.md`.
+- Slot arithmetic and provider contracts: `src/codex_services/booking/_shared/`.
+- Calendar rendering data: `src/codex_services/calendar/`.
+- Skill installation and packaged instructions: `src/codex_services/agent_skills/` and its tests. Treat installed consumer copies and manifests as managed output.
+
+## Contracts that affect changes
+
+- Business engines remain framework-independent. ORM access, persistence, HTTP and application policy belong in consumer adapters, not the booking/calendar engines.
+- Preserve the distinction between the dictionary facade (`find_slots`, `find_nearest_slots`) and the typed `ChainFinder` API. Verify actual signatures before adapting examples; resource IDs use `possible_resource_ids` and `resource_id`.
+- Booking DTOs derive from `codex-core` BaseDTO. Preserve immutable-model semantics and PII-safe representations; do not add customer payloads to logs.
+- Recursive search uses lightweight `_SlotCandidate` instances and creates Pydantic solutions at the result boundary. Avoid moving model validation into the backtracking loop without evidence.
+- An enum value is not proof a booking mode is implemented. Check `ChainFinder` guards and tests before documenting support.
+- Calendar holiday support is optional (`calendar` extra). Keep the base installation usable without it.
+- Skill delivery is explicitly invoked and offline. Changes to update/delete must preserve unrelated consumer content and detect modified managed files; test against an isolated project.
+
+## Verification and release work
+
+Use the configured environment; project commands are `uv run pytest`, `uv run mypy src/`, and `uv run pre-commit run --all-files`. An existing environment can run the equivalent Python modules. Inspect `.github/workflows/ci.yml` for the Python-version unit-test matrix and the subsequent full-suite coverage gate (including integration tests). Coverage is configured with a 90% threshold; report failing or skipped checks honestly.
+
+For packaging or skill payload changes, build with `uv build --no-sources`, inspect wheel and sdist contents, and exercise installation from the wheel outside the source checkout. Check executable examples against the packaged public API and ensure reference links stay inside the shipped payload.
+
+Version comes from Git tags via hatch-vcs. Record pending changes under `CHANGELOG.md` Unreleased; a local dirty-build version is not a release tag. Publishing is triggered by a `v*` tag. Preparing a release does not itself authorize creating/pushing that tag or publishing.
+
+After changes affecting graph inputs, rebuild the local graph using `.agents/rules/graphify.md`. Keep generated graph files out of Git and release artifacts; commit only build rules and instructions. If the graph is missing or rebuilding fails, inspect current sources and report the limitation rather than treating a stale graph as current.

{codex_services-0.1.2 → codex_services-0.1.4}/.github/workflows/ci.yml

@@ -56,10 +56,10 @@ jobs:
         run: uv sync --locked --extra dev
 
       - name: Run unit tests
-        run: uv run pytest tests/ -m "unit" -v --tb=short
+        run: uv run pytest tests/ -m "unit" --no-cov -v --tb=short
 
   integration-tests:
-    name: Integration Tests
+    name: Full Suite and Coverage
     needs: unit-tests
     runs-on: ubuntu-latest
     env:
@@ -76,5 +76,5 @@ jobs:
       - name: Sync dev environment
         run: uv sync --locked --extra dev
 
-      - name: Run integration tests
-        run: uv run pytest tests/ -m "integration" -v --tb=short
+      - name: Run full suite including integration tests and enforce total coverage
+        run: uv run pytest tests/ -v --tb=short

{codex_services-0.1.2 → codex_services-0.1.4}/.gitignore

@@ -217,3 +217,6 @@ __marimo__/
 # OS junk
 .DS_Store
 Thumbs.db
+
+# Generated, library-local knowledge graph (rebuild from tracked sources)
+/graphify-out/

codex_services-0.1.4/.graphifyignore

@@ -0,0 +1,31 @@
+# Graphify runs from this library root. Do not ingest generated artifacts or
+# local environments; the graph is rebuilt from library source, tests, scripts,
+# and documentation in this checkout.
+graphify-out/
+project_structure.txt
+site/
+dist/
+build/
+sdist/
+wheels/
+htmlcov/
+coverage/
+out/
+target/
+downloads/
+*.egg-info/
+.venv/
+venv/
+env/
+.cache/
+.git/
+.agents/
+.claude/
+.idea/
+.vscode/
+node_modules/
+__pycache__/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.uv-cache/

codex_services-0.1.4/AGENTS.md

@@ -0,0 +1,11 @@
+## Project skills
+
+For development of this library, read `.agents/skills/codex-services-development/SKILL.md`.
+Consumer usage guidance is maintained separately in `src/codex_services/agent_skills/resources/`
+and shipped with the library; do not replace the development skill with an installed consumer copy.
+
+## graphify
+
+This library owns its local graph in `graphify-out/`. Follow `.agents/rules/graphify.md`
+for scope, navigation, and rebuilding. Graph commands run from this repository root,
+not the parent workspace. The generated graph is ignored by Git.

{codex_services-0.1.2 → codex_services-0.1.4}/CHANGELOG.md

@@ -7,6 +7,30 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
+## [0.1.4] - 2026-10-09
+
+### Added
+- Packaged consumer agent skill with booking and calendar usage guidance and an offline install/update/delete/status CLI.
+- Source-development skill in `.agents/skills/codex-services-development`, linked from project agent instructions.
+
+### Changed
+- Moved development graph navigation to a library-local, Git-ignored `graphify-out/` with reproducible source-scoped generation.
+- CI enforces the existing 90% coverage threshold on the full test suite after the Python-version unit-test matrix.
+- Documented agent skill installation, discovery, updates, and local-edit recovery; corrected the README booking example to use the current dictionary API.
+- Translated all Russian comments and Pydantic field descriptions to English across `booking/_shared/calculator.py` and `booking/slot_master/dto.py`.
+
+### Security
+- Refreshed vulnerable locked dependencies (`idna`, `msgpack`, `pip`, `pydantic-settings`, `pytest`, `urllib3`, and `virtualenv`) within the existing package constraints, including the required `python-discovery` update.
+
+## [0.1.3] - 2026-04-05
+
+### Changed
+- **Core dependency**:
+  - Updated the supported `codex-core` dependency range to `>=0.3.0,<1.0.0` so the package remains compatible with the planned pre-`1.0` `codex-core` line without repeated dependency-range bumps.
+- **Development tooling**:
+  - Moved project quality-gate policy into `[tool.codex-check]` in `pyproject.toml`.
+  - Simplified `tools/dev/check.py` to a thin launcher compatible with the `codex-core 0.3.x` runner flow.
+
 ## [0.1.2] - 2026-03-29
 
 ### Added

codex_services-0.1.4/CLAUDE.md

@@ -0,0 +1,11 @@
+## Project skills
+
+For development of this library, read `.agents/skills/codex-services-development/SKILL.md`.
+Consumer usage guidance is maintained separately in `src/codex_services/agent_skills/resources/`
+and shipped with the library; do not replace the development skill with an installed consumer copy.
+
+## graphify
+
+This library owns its local graph in `graphify-out/`. Follow `.agents/rules/graphify.md`
+for scope, navigation, and rebuilding. Graph commands run from this repository root,
+not the parent workspace. The generated graph is ignored by Git.

{codex_services-0.1.2 → codex_services-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: codex-services
-Version: 0.1.2
+Version: 0.1.4
 Summary: Reusable business logic engines for Codex platform (CRM, finance, HR, inventory)
 Project-URL: Homepage, https://github.com/codexdlc/codex-services
 Project-URL: Documentation, https://codexdlc.github.io/codex-services/
@@ -15,7 +15,7 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.12
-Requires-Dist: codex-core<0.3.0,>=0.2.0
+Requires-Dist: codex-core<1.0.0,>=0.3.0
 Requires-Dist: pydantic<3.0,>=2.0
 Provides-Extra: all
 Requires-Dist: holidays>=0.40; extra == 'all'
@@ -47,7 +47,7 @@ Description-Content-Type: text/markdown
 [![PyPI version](https://img.shields.io/pypi/v/codex-services.svg)](https://pypi.org/project/codex-services/)
 [![Python](https://img.shields.io/pypi/pyversions/codex-services.svg)](https://pypi.org/project/codex-services/)
 [![CI](https://github.com/codexdlc/codex-services/actions/workflows/ci.yml/badge.svg)](https://github.com/codexdlc/codex-services/actions/workflows/ci.yml)
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
 
 Pure-Python business logic engines for booking, scheduling, and CRM workflows.
 No ORM, no framework dependencies — drop into any Python project or use as a building block inside the Codex ecosystem.
@@ -75,25 +75,55 @@ uv run pre-commit run --all-files
 uv build --no-sources
 ```
 
+### Local code graph
+
+For source-checkout navigation, install Graphify separately and run from this repository root:
+
+```bash
+graphify update .
+```
+
+This builds an AST-only code graph in `graphify-out/`, using `.graphifyignore` to exclude environments, caches, and generated outputs. It does not use the parent workspace graph or an LLM API. Read documentation and skills directly for explanations beyond the code structure; this command does not perform semantic documentation extraction or generate a wiki.
+
+The graph is generated local data and is not committed or shipped in releases. Commit only `.graphifyignore` and the build instructions. See [.agents/rules/graphify.md](.agents/rules/graphify.md) for navigation and refresh rules.
+
 ## Quick Start
 
 ```python
-from codex_services.booking.slot_master import find_slots, BookingEngineRequest, ServiceRequest, BookingMode
-from datetime import date
-
-request = BookingEngineRequest(
-    service_requests=[
-        ServiceRequest(service_id="haircut", duration_minutes=60, possible_master_ids=["m1", "m2"]),
+from codex_services.booking.slot_master import find_slots
+
+result = find_slots(
+    request_data={
+        "booking_date": "2026-10-12",
+        "service_requests": [
+            {"service_id": "haircut", "duration_minutes": 60, "possible_resource_ids": ["m1"]},
+        ],
+    },
+    resources_availability=[
+        {"resource_id": "m1", "free_windows": [["2026-10-12T09:00:00", "2026-10-12T11:00:00"]]},
     ],
-    booking_date=date.today(),
-    mode=BookingMode.SINGLE_DAY,
 )
+for chain in result["solutions"]:
+    print(chain["items"][0]["start_time"])
+```
+
+## Optional agent skill
+
+Starting with **0.1.4**, the package includes an optional skill that helps coding agents use its booking, slot arithmetic, and calendar APIs. The skill is bundled with the library; no separate plugin or download is needed.
+
+From the root of a consuming project, using the Python environment where `codex-services` is installed:
 
-result = find_slots(request, masters_availability=[...])
-if result.has_solutions:
-    print(result.best.starts_at)
+```bash
+python -m codex_services.agent_skills install --project .
+python -m codex_services.agent_skills status --project .
 ```
 
+`install` copies the versioned guide to `.agents/skills/codex-services` and adds a scoped instruction to the project's `AGENTS.md`. The installer stores file hashes in `.manifest.json`; `update` and `delete` refuse to replace locally edited managed files. Put local rules in a separate project-owned skill. The installer preserves unrelated files and `AGENTS.md` content, and no skill is installed as part of importing or installing the package.
+
+After upgrading the Python package, refresh the project's skill with `python -m codex_services.agent_skills update --project .`. To remove the managed skill, use `python -m codex_services.agent_skills delete --project .`.
+
+See the [agent skill guide](docs/en/agent_skills.md) for paths with spaces, status checks, updates, and local-edit recovery.
+
 ## Modules
 
 | Module | Extra | Description |

codex_services-0.1.4/README.md

@@ -0,0 +1,110 @@
+# codex-services
+<!-- Type: LANDING -->
+
+[![PyPI version](https://img.shields.io/pypi/v/codex-services.svg)](https://pypi.org/project/codex-services/)
+[![Python](https://img.shields.io/pypi/pyversions/codex-services.svg)](https://pypi.org/project/codex-services/)
+[![CI](https://github.com/codexdlc/codex-services/actions/workflows/ci.yml/badge.svg)](https://github.com/codexdlc/codex-services/actions/workflows/ci.yml)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
+
+Pure-Python business logic engines for booking, scheduling, and CRM workflows.
+No ORM, no framework dependencies — drop into any Python project or use as a building block inside the Codex ecosystem.
+
+---
+
+## Install
+
+```bash
+pip install codex-services
+
+# With holiday calendar support
+pip install "codex-services[calendar]"
+```
+
+Requires Python 3.12 or newer.
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run pytest
+uv run mypy src/
+uv run pre-commit run --all-files
+uv build --no-sources
+```
+
+### Local code graph
+
+For source-checkout navigation, install Graphify separately and run from this repository root:
+
+```bash
+graphify update .
+```
+
+This builds an AST-only code graph in `graphify-out/`, using `.graphifyignore` to exclude environments, caches, and generated outputs. It does not use the parent workspace graph or an LLM API. Read documentation and skills directly for explanations beyond the code structure; this command does not perform semantic documentation extraction or generate a wiki.
+
+The graph is generated local data and is not committed or shipped in releases. Commit only `.graphifyignore` and the build instructions. See [.agents/rules/graphify.md](.agents/rules/graphify.md) for navigation and refresh rules.
+
+## Quick Start
+
+```python
+from codex_services.booking.slot_master import find_slots
+
+result = find_slots(
+    request_data={
+        "booking_date": "2026-10-12",
+        "service_requests": [
+            {"service_id": "haircut", "duration_minutes": 60, "possible_resource_ids": ["m1"]},
+        ],
+    },
+    resources_availability=[
+        {"resource_id": "m1", "free_windows": [["2026-10-12T09:00:00", "2026-10-12T11:00:00"]]},
+    ],
+)
+for chain in result["solutions"]:
+    print(chain["items"][0]["start_time"])
+```
+
+## Optional agent skill
+
+Starting with **0.1.4**, the package includes an optional skill that helps coding agents use its booking, slot arithmetic, and calendar APIs. The skill is bundled with the library; no separate plugin or download is needed.
+
+From the root of a consuming project, using the Python environment where `codex-services` is installed:
+
+```bash
+python -m codex_services.agent_skills install --project .
+python -m codex_services.agent_skills status --project .
+```
+
+`install` copies the versioned guide to `.agents/skills/codex-services` and adds a scoped instruction to the project's `AGENTS.md`. The installer stores file hashes in `.manifest.json`; `update` and `delete` refuse to replace locally edited managed files. Put local rules in a separate project-owned skill. The installer preserves unrelated files and `AGENTS.md` content, and no skill is installed as part of importing or installing the package.
+
+After upgrading the Python package, refresh the project's skill with `python -m codex_services.agent_skills update --project .`. To remove the managed skill, use `python -m codex_services.agent_skills delete --project .`.
+
+See the [agent skill guide](docs/en/agent_skills.md) for paths with spaces, status checks, updates, and local-edit recovery.
+
+## Modules
+
+| Module | Extra | Description |
+| :--- | :--- | :--- |
+| `codex_services.booking.slot_master` | — | Recursive chain-finder for multi-service bookings with scoring and waitlist |
+| `codex_services.booking._shared` | — | Low-level slot arithmetic — windows, gaps, busy interval merging |
+| `codex_services.calendar` | `[calendar]` | Calendar grid generator for UI rendering with holiday awareness |
+
+## Documentation
+
+Full docs with architecture, API reference, and data flow diagrams:
+
+**[https://codexdlc.github.io/codex-services/](https://codexdlc.github.io/codex-services/)**
+
+## Part of the Codex ecosystem
+
+| Package | Role |
+| :--- | :--- |
+| [codex-core](https://github.com/codexdlc/codex-core) | Foundation — immutable DTOs, PII masking, env settings |
+| [codex-platform](https://github.com/codexdlc/codex-platform) | Infrastructure — Redis, Streams, ARQ workers, Notifications |
+| [codex-ai](https://github.com/codexdlc/codex-ai) | LLM layer — unified async interface for OpenAI, Gemini, Anthropic |
+| **codex-services** | Business logic — Booking engine, CRM, Calendar |
+
+Each library is **fully standalone** — install only what your project needs.
+Together they form the backbone of **[codex-bot](https://github.com/codexdlc/codex-bot)**
+(Telegram AI-agent infrastructure built on aiogram) and
+**[codex-django](https://github.com/codexdlc/codex-django)** (Django integration layer).

codex_services-0.1.4/docs/en/agent_skills.md

@@ -0,0 +1,33 @@
+# Optional agent skill
+
+Starting with version **0.1.4**, `codex-services` ships a versioned, offline skill for coding agents covering booking chains, slot arithmetic, and calendar grids. Installing the Python package does not change your project files. Run the command explicitly from the environment where the package is installed:
+
+```bash
+python -m codex_services.agent_skills install --project /path/to/project
+python -m codex_services.agent_skills status --project /path/to/project
+python -m codex_services.agent_skills update --project /path/to/project
+python -m codex_services.agent_skills delete --project /path/to/project
+```
+
+The guide lives at `.agents/skills/codex-services/SKILL.md` in the consumer project. The installer adds one marked instruction to `AGENTS.md` and records the package version and SHA-256 hashes in `.manifest.json`. `status` reports missing or edited files and whether the payload matches the installed package. `update` requires an existing managed installation and refuses to overwrite local edits; `delete` likewise refuses to discard edited managed files. Both preserve unrelated files and the rest of `AGENTS.md`.
+
+Keep project-specific business rules and integrations in a separate project-owned skill. The copied library guide and its manifest are managed outputs. Restore edited managed files or move custom notes to a project-owned file before running `update` or `delete` again.
+
+## Project paths and discovery
+
+Use `--project .` when running from the consuming project's root. The target directory must already exist. Quote paths containing spaces, for example `--project "D:/Projects/My App"` on Windows. The installer does not install a global skill or modify the agent's global configuration.
+
+Agents that read project `AGENTS.md` or discover `.agents/skills/` can find the installed guide. Agents with different discovery conventions may need to be pointed at `.agents/skills/codex-services/SKILL.md` explicitly.
+
+## Upgrading and checking
+
+Upgrade the Python package with your project's normal dependency manager, then run:
+
+```bash
+python -m codex_services.agent_skills update --project .
+python -m codex_services.agent_skills status --project .
+```
+
+The refresh uses only resources bundled with the installed package and does not access the network. `status` exits with code 0 only when the managed installation matches that package. Exit code 1 means it is absent, outdated, edited, corrupt, or could not be checked; read the accompanying message before acting. On a project without the skill, use `install` rather than `update`.
+
+If an update or deletion is refused, keep a copy of your changes outside the managed directory, move application-specific instructions into a project-owned skill, and restore the original managed content before retrying. Do not edit the manifest hashes to bypass the check. Deleting the skill does not uninstall the Python package.

{codex_services-0.1.2 → codex_services-0.1.4}/docs/index.md

@@ -10,4 +10,5 @@ Welcome to the central documentation hub for Codex Services, organized by the Do
 | :--- | :--- |
 | **[Architecture](en/architecture/README.md)** | Ecosystem architecture, concepts, and data-flow specifications |
 | **[API Reference](en/api/index.md)** | Precise code reference directly mapped from docstrings |
+| **[Agent skill](en/agent_skills.md)** | Install and maintain the bundled coding-agent guide in a consuming project |
 | **[Evolution / Changelog](evolution/changelog.md)** | Project history, semantic versioning, and deprecation details |

{codex_services-0.1.2 → codex_services-0.1.4}/mkdocs.yml

@@ -69,6 +69,7 @@ nav:
       - Architecture:
           - Overview: en/architecture/README.md
           - Booking Engine: en/architecture/booking_engine.md
+      - Optional agent skill: en/agent_skills.md
   - Руководство (RU):
       - Архитектура:
           - Обзор: ru/architecture/README.md

{codex_services-0.1.2 → codex_services-0.1.4}/pyproject.toml

@@ -20,7 +20,7 @@ classifiers = [
 ]
 dependencies = [
     "pydantic>=2.0,<3.0",
-    "codex-core>=0.2.0,<0.3.0", # Зависимость от ядра
+    "codex-core>=0.3.0,<1.0.0", # Зависимость от ядра
 ]
 
 [project.urls]
@@ -110,3 +110,12 @@ exclude_lines = [
 [tool.bandit]
 exclude_dirs = ["tests"]
 skips = ["B602", "B605", "B607", "B404"]
+
+[tool.codex-check]
+project-name = "codex-services"
+audit-flags = "--skip-editable --ignore-vuln CVE-2026-4539"
+integration-requires = "pure Python, no external deps"
+test-stages = ["unit", "integration"]
+prompt-test-stages = ["integration"]
+test-paths = ["tests"]
+types-paths = ["src"]

codex_services-0.1.4/src/codex_services/agent_skills/__init__.py

@@ -0,0 +1 @@
+# empty module

codex_services-0.1.4/src/codex_services/agent_skills/__main__.py

@@ -0,0 +1,4 @@
+from codex_services.agent_skills.cli import main
+
+if __name__ == "__main__":
+    main()

codex_services-0.1.4/src/codex_services/agent_skills/cli.py

@@ -0,0 +1,39 @@
+import argparse
+import sys
+from collections.abc import Sequence
+from pathlib import Path
+
+from codex_services.agent_skills.fs_transaction import FSError
+from codex_services.agent_skills.orchestrator import OrchestratorError, check_status, perform_delete, perform_install
+
+
+def main(args: Sequence[str] | None = None) -> None:
+    parser = argparse.ArgumentParser(prog="python -m codex_services.agent_skills")
+    parser.add_argument("action", choices=["install", "update", "delete", "status"])
+    parser.add_argument("--project", required=True, help="Path to project root")
+
+    parsed = parser.parse_args(args)
+
+    project_dir = Path(parsed.project).absolute()
+    if not project_dir.is_dir():
+        print(f"Error: Project directory does not exist or is not a directory: {project_dir}", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        if parsed.action == "install":
+            perform_install(project_dir, update=False)
+            print("Installed successfully.")
+        elif parsed.action == "update":
+            perform_install(project_dir, update=True)
+            print("Updated successfully.")
+        elif parsed.action == "delete":
+            perform_delete(project_dir)
+            print("Deleted successfully.")
+        elif parsed.action == "status":
+            is_valid, msg = check_status(project_dir)
+            print(msg)
+            if not is_valid:
+                sys.exit(1)
+    except (OrchestratorError, FSError) as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)