forktex-cloud 0.2.3__tar.gz → 0.5.0__tar.gz

forktex_cloud-0.5.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ForkTex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{forktex_cloud-0.2.3 → forktex_cloud-0.5.0}/PKG-INFO

@@ -1,23 +1,21 @@
 Metadata-Version: 2.4
 Name: forktex-cloud
-Version: 0.2.3
+Version: 0.5.0
 Summary: Typed Python SDK for the ForkTex Cloud platform — provision, deploy, and manage VPS-backed apps via a declarative manifest.
-License-Expression: AGPL-3.0-only
+License-Expression: MIT
 License-File: LICENSE
-License-File: NOTICE
 Keywords: forktex,cloud,deployment,vps,hetzner,ansible,blue-green,iac,infrastructure-as-code,sdk
-Author: FORKTEX
+Author: ForkTex
 Author-email: info@forktex.com
-Requires-Python: >=3.12
+Requires-Python: >=3.11
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Distributed Computing
 Classifier: Topic :: System :: Installation/Setup
@@ -52,17 +50,17 @@ You can use it directly from any Python application — no `forktex` CLI require
 pip install forktex-cloud
 ```
 
-**Requires Python 3.12+.** Tested on 3.12, 3.13, 3.14.
+Requires Python ≥ 3.11.
 
 ## Quick Start
 
 ### Authenticated client
 
 ```python
-from forktex_cloud import ForktexCloudClient, CloudContext
+from forktex_cloud import Cloud, CloudContext
 
 ctx = CloudContext(controller="https://cloud.forktex.com", account_key="ftx-...")
-with ForktexCloudClient.from_context(ctx) as client:
+with Cloud.from_context(ctx) as client:
     projects = client.list_projects()
     servers  = client.list_servers()
     health   = client.health()
@@ -71,14 +69,14 @@ with ForktexCloudClient.from_context(ctx) as client:
 ### Direct auth
 
 ```python
-from forktex_cloud import ForktexCloudClient
+from forktex_cloud import Cloud
 
 # JWT bearer (user login)
-with ForktexCloudClient("https://cloud.forktex.com", access_token="eyJ...") as client:
+with Cloud("https://cloud.forktex.com", access_token="eyJ...") as client:
     me = client.me()
 
 # Org-scoped API key (CI/CD)
-with ForktexCloudClient(
+with Cloud(
     "https://cloud.forktex.com",
     account_key="ftx-...",
     org_id="00000000-0000-0000-0000-000000000001",
@@ -90,7 +88,7 @@ with ForktexCloudClient(
 ### Local dev (point at your `make local` stack)
 
 ```python
-client = ForktexCloudClient(
+client = Cloud(
     base_url="http://localhost:8000",
     account_key="ftx-dev-key-2026",
     org_id="<your-org-uuid>",
@@ -100,15 +98,23 @@ client = ForktexCloudClient(
 ### Trigger a deploy pipeline
 
 ```python
-# Full up (provision + bootstrap + deploy + DNS + SSL)
-job = client.up(project_dir=Path("./my-project"))      # reads forktex.json
+# Preview what an apply WOULD do (read-only, no mutation):
+plan = client.plan(project_dir=Path("./my-project"), env="production")
+print(plan.manifest_diff)            # added / removed / changed paths
+for role in plan.ansible_plan:
+    print(f"  {role.role}: {role.changed} changed, {role.failed} failed")
+    for d in role.diffs:
+        print(f"    {d.task}: {d.before_header}")  # file-level diff hints
+
+# Full apply (provision + bootstrap + deploy + DNS + SSL)
+job = client.apply(project_dir=Path("./my-project"))      # reads forktex.json
 print(job.job_id, job.deployment_id, job.status)
 
 # Code push to an existing server (no re-provision)
 job = client.deploy(server_id="...", service="api")    # Ansible deploy tag
 
 # Tear down
-job = client.down(keep_dns=True)                       # preserves DNS record
+job = client.destroy(keep_dns=True)                       # preserves DNS record
 ```
 
 ### Manifest loading + validation
@@ -146,11 +152,11 @@ client.vault_delete("POSTGRES_PASSWORD")
 
 | Module | Purpose |
 |---|---|
-| `forktex_cloud.client` | Typed sync httpx client (`ForktexCloudClient`) + all OpenAPI-codegenned Pydantic models (`ServerRead`, `ProjectRead`, `EventRead`, `VaultGetResponse`, ...) |
+| `forktex_cloud.client` | Typed sync httpx client (`Cloud`) + all OpenAPI-codegenned Pydantic models (`ServerRead`, `ProjectRead`, `EventRead`, `VaultGetResponse`, ...) |
 | `forktex_cloud.manifest` | `Manifest` loader, discriminated-union schema (v1beta2), deep-merge for env overlays, `ManifestError` |
 | `forktex_cloud.config` | `CloudContext` — controller URL, JWT / account-key, current org + project keys |
 | `forktex_cloud.scaffold` | `forktex cloud init` template generator (ProjectDeployment / StaticSite / SingleContainer / NativeBuild) |
-| `forktex_cloud.bridge` | docker-compose generator (local mode), Loki config, log formatters used by `forktex cloud up --env local` |
+| `forktex_cloud.bridge` | docker-compose generator (local mode), Loki config, log formatters used by `forktex cloud apply --env local` |
 | `forktex_cloud.secrets` | Fernet vault + `${vault:KEY}` resolver for compile-time secret injection |
 | `forktex_cloud.paths` | Cross-platform `.forktex/` + `~/.forktex/` filesystem spec (V1). See [docs/forktex-directory-spec.md](https://github.com/forktex/cloud/blob/master/docs/forktex-directory-spec.md) |
 
@@ -161,7 +167,7 @@ All response models come from the OpenAPI codegen pipeline — **one source of t
 ```python
 from forktex_cloud import (
     # Client
-    ForktexCloudClient, CloudAPIError,
+    Cloud, CloudAPIError,
     # Config
     CloudContext,
     # Manifest
@@ -188,39 +194,7 @@ This SDK lives inside the [`forktex/cloud`](https://github.com/forktex/cloud) mo
 - Production runbook: [production-runbook.md](https://github.com/forktex/cloud/blob/master/docs/production-runbook.md)
 - Issues: [https://github.com/forktex/cloud/issues](https://github.com/forktex/cloud/issues)
 
-## Development
-
-The [`Makefile`](Makefile) is generated by `forktex fsd makefile sync` from [`forktex.json`](forktex.json) — do not hand-edit.
-
-```bash
-make help              # list every available target
-make deps              # editable install with the dev group
-make format            # ruff format
-make lint              # ruff check
-make test              # pytest tests/
-make codegen-check     # verify the generated client imports cleanly
-make build             # python3 -m build → dist/
-make ci                # format-check + lint + license-check + audit + test + build
-make clean             # remove caches and dist/
-```
-
-`make ci` is the single command that gates a publish: format-check, lint, dual-license header check, dependency CVE audit, full test suite, and `python -m build` + `twine check`.
-
-### License headers
-
-Every source file carries the AGPL-3.0 + Commercial dual-license SPDX header, applied idempotently via:
-
-```bash
-make license-check    # CI gate — fails if any source file is missing the header
-make license-fix      # add or refresh headers across src/, tests/, scripts/
-make license-strip    # remove headers (used before license-model changes)
-```
-
 ## License
 
-Dual-licensed — **AGPL-3.0-or-later** for open-source use, **commercial** for everything else (proprietary products, SaaS without source release, redistribution in closed-source form). See [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE) for the full terms.
-
-Commercial licensing inquiries: info@forktex.com.
-
-The 1.0.x releases on PyPI remain under MIT; from **0.2.3** onwards the package ships AGPL-3.0+Commercial.
+MIT — see [LICENSE](LICENSE).
 

{forktex_cloud-0.2.3 → forktex_cloud-0.5.0}/README.md

@@ -16,17 +16,17 @@ You can use it directly from any Python application — no `forktex` CLI require
 pip install forktex-cloud
 ```
 
-**Requires Python 3.12+.** Tested on 3.12, 3.13, 3.14.
+Requires Python ≥ 3.11.
 
 ## Quick Start
 
 ### Authenticated client
 
 ```python
-from forktex_cloud import ForktexCloudClient, CloudContext
+from forktex_cloud import Cloud, CloudContext
 
 ctx = CloudContext(controller="https://cloud.forktex.com", account_key="ftx-...")
-with ForktexCloudClient.from_context(ctx) as client:
+with Cloud.from_context(ctx) as client:
     projects = client.list_projects()
     servers  = client.list_servers()
     health   = client.health()
@@ -35,14 +35,14 @@ with ForktexCloudClient.from_context(ctx) as client:
 ### Direct auth
 
 ```python
-from forktex_cloud import ForktexCloudClient
+from forktex_cloud import Cloud
 
 # JWT bearer (user login)
-with ForktexCloudClient("https://cloud.forktex.com", access_token="eyJ...") as client:
+with Cloud("https://cloud.forktex.com", access_token="eyJ...") as client:
     me = client.me()
 
 # Org-scoped API key (CI/CD)
-with ForktexCloudClient(
+with Cloud(
     "https://cloud.forktex.com",
     account_key="ftx-...",
     org_id="00000000-0000-0000-0000-000000000001",
@@ -54,7 +54,7 @@ with ForktexCloudClient(
 ### Local dev (point at your `make local` stack)
 
 ```python
-client = ForktexCloudClient(
+client = Cloud(
     base_url="http://localhost:8000",
     account_key="ftx-dev-key-2026",
     org_id="<your-org-uuid>",
@@ -64,15 +64,23 @@ client = ForktexCloudClient(
 ### Trigger a deploy pipeline
 
 ```python
-# Full up (provision + bootstrap + deploy + DNS + SSL)
-job = client.up(project_dir=Path("./my-project"))      # reads forktex.json
+# Preview what an apply WOULD do (read-only, no mutation):
+plan = client.plan(project_dir=Path("./my-project"), env="production")
+print(plan.manifest_diff)            # added / removed / changed paths
+for role in plan.ansible_plan:
+    print(f"  {role.role}: {role.changed} changed, {role.failed} failed")
+    for d in role.diffs:
+        print(f"    {d.task}: {d.before_header}")  # file-level diff hints
+
+# Full apply (provision + bootstrap + deploy + DNS + SSL)
+job = client.apply(project_dir=Path("./my-project"))      # reads forktex.json
 print(job.job_id, job.deployment_id, job.status)
 
 # Code push to an existing server (no re-provision)
 job = client.deploy(server_id="...", service="api")    # Ansible deploy tag
 
 # Tear down
-job = client.down(keep_dns=True)                       # preserves DNS record
+job = client.destroy(keep_dns=True)                       # preserves DNS record
 ```
 
 ### Manifest loading + validation
@@ -110,11 +118,11 @@ client.vault_delete("POSTGRES_PASSWORD")
 
 | Module | Purpose |
 |---|---|
-| `forktex_cloud.client` | Typed sync httpx client (`ForktexCloudClient`) + all OpenAPI-codegenned Pydantic models (`ServerRead`, `ProjectRead`, `EventRead`, `VaultGetResponse`, ...) |
+| `forktex_cloud.client` | Typed sync httpx client (`Cloud`) + all OpenAPI-codegenned Pydantic models (`ServerRead`, `ProjectRead`, `EventRead`, `VaultGetResponse`, ...) |
 | `forktex_cloud.manifest` | `Manifest` loader, discriminated-union schema (v1beta2), deep-merge for env overlays, `ManifestError` |
 | `forktex_cloud.config` | `CloudContext` — controller URL, JWT / account-key, current org + project keys |
 | `forktex_cloud.scaffold` | `forktex cloud init` template generator (ProjectDeployment / StaticSite / SingleContainer / NativeBuild) |
-| `forktex_cloud.bridge` | docker-compose generator (local mode), Loki config, log formatters used by `forktex cloud up --env local` |
+| `forktex_cloud.bridge` | docker-compose generator (local mode), Loki config, log formatters used by `forktex cloud apply --env local` |
 | `forktex_cloud.secrets` | Fernet vault + `${vault:KEY}` resolver for compile-time secret injection |
 | `forktex_cloud.paths` | Cross-platform `.forktex/` + `~/.forktex/` filesystem spec (V1). See [docs/forktex-directory-spec.md](https://github.com/forktex/cloud/blob/master/docs/forktex-directory-spec.md) |
 
@@ -125,7 +133,7 @@ All response models come from the OpenAPI codegen pipeline — **one source of t
 ```python
 from forktex_cloud import (
     # Client
-    ForktexCloudClient, CloudAPIError,
+    Cloud, CloudAPIError,
     # Config
     CloudContext,
     # Manifest
@@ -152,38 +160,6 @@ This SDK lives inside the [`forktex/cloud`](https://github.com/forktex/cloud) mo
 - Production runbook: [production-runbook.md](https://github.com/forktex/cloud/blob/master/docs/production-runbook.md)
 - Issues: [https://github.com/forktex/cloud/issues](https://github.com/forktex/cloud/issues)
 
-## Development
-
-The [`Makefile`](Makefile) is generated by `forktex fsd makefile sync` from [`forktex.json`](forktex.json) — do not hand-edit.
-
-```bash
-make help              # list every available target
-make deps              # editable install with the dev group
-make format            # ruff format
-make lint              # ruff check
-make test              # pytest tests/
-make codegen-check     # verify the generated client imports cleanly
-make build             # python3 -m build → dist/
-make ci                # format-check + lint + license-check + audit + test + build
-make clean             # remove caches and dist/
-```
-
-`make ci` is the single command that gates a publish: format-check, lint, dual-license header check, dependency CVE audit, full test suite, and `python -m build` + `twine check`.
-
-### License headers
-
-Every source file carries the AGPL-3.0 + Commercial dual-license SPDX header, applied idempotently via:
-
-```bash
-make license-check    # CI gate — fails if any source file is missing the header
-make license-fix      # add or refresh headers across src/, tests/, scripts/
-make license-strip    # remove headers (used before license-model changes)
-```
-
 ## License
 
-Dual-licensed — **AGPL-3.0-or-later** for open-source use, **commercial** for everything else (proprietary products, SaaS without source release, redistribution in closed-source form). See [`LICENSE`](LICENSE) and [`NOTICE`](NOTICE) for the full terms.
-
-Commercial licensing inquiries: info@forktex.com.
-
-The 1.0.x releases on PyPI remain under MIT; from **0.2.3** onwards the package ships AGPL-3.0+Commercial.
+MIT — see [LICENSE](LICENSE).

{forktex_cloud-0.2.3 → forktex_cloud-0.5.0}/pyproject.toml

@@ -1,37 +1,14 @@
-# Copyright (C) 2026 FORKTEX S.R.L.
-#
-# SPDX-License-Identifier: AGPL-3.0-or-later OR LicenseRef-ForkTex-Commercial
-#
-# This file is part of forktex-cloud.
-#
-# For commercial licensing -- including use in proprietary products, SaaS
-# deployments, or any context where AGPL obligations cannot be met -- you
-# MUST obtain a commercial license from FORKTEX S.R.L. (info@forktex.com).
-#
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU Affero General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU Affero General Public License for more details.
-#
-# You should have received a copy of the GNU Affero General Public License
-# along with this program. If not, see <https://www.gnu.org/licenses/>.
-
 [project]
 name = "forktex-cloud"
-version = "0.2.3"
+version = "0.5.0"
 description = "Typed Python SDK for the ForkTex Cloud platform — provision, deploy, and manage VPS-backed apps via a declarative manifest."
 authors = [
-    {name = "FORKTEX", email = "info@forktex.com"}
+    {name = "ForkTex", email = "info@forktex.com"}
 ]
 readme = "README.md"
-license = "AGPL-3.0-only"
-license-files = ["LICENSE", "NOTICE"]
-requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
 keywords = [
     "forktex",
     "cloud",
@@ -51,9 +28,8 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.13",
-    "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Topic :: System :: Distributed Computing",
     "Topic :: System :: Installation/Setup",
@@ -83,14 +59,12 @@ dev = [
     "pytest (>=8.4.2,<9.0.0)",
     "pytest-asyncio (>=1.2.0,<2.0.0)",
     "ruff (>=0.8.0)",
-    "pyright>=1.1.350",
-    "pip-audit>=2.7.0",
-    "build>=1.2.0",
-    "twine>=5.0.0",
+    "pyright (>=1.1.0,<2.0.0)",
+    "mypy (>=1.11.0,<2.0.0)",
 ]
 
 [tool.ruff]
-target-version = "py312"
+target-version = "py311"
 line-length = 100
 extend-exclude = [
     # Auto-generated by OpenAPI codegen. Canonical import shape comes from

forktex_cloud-0.5.0/src/forktex_cloud/__init__.py

@@ -0,0 +1,76 @@
+"""forktex_cloud — Standalone Python SDK for the ForkTex Cloud platform.
+
+Usage::
+
+    from forktex_cloud import Cloud
+
+    with Cloud("https://cloud.forktex.com", account_key="ftx-...") as cloud:
+        projects = cloud.list_projects()
+        servers = cloud.list_servers()
+
+Or, when you already hold a ``CloudContext``::
+
+    from forktex_cloud import Cloud, CloudContext
+
+    ctx = CloudContext(controller="https://cloud.forktex.com", account_key="ftx-...")
+    with Cloud.from_context(ctx) as cloud:
+        ...
+"""
+
+__version__ = "0.5.0"
+
+from forktex_cloud import paths
+from forktex_cloud.client.client import Cloud, CloudAPIError
+from forktex_cloud.client.generated import (
+    SPEC_HASH,
+    SPEC_VERSION,
+    ApiKeyCreated,
+    ApiKeyRead,
+    AuditEventRead,
+    EnvironmentRead,
+    HealthRead,
+    JobResponse,
+    MeResponse,
+    OrgRead,
+    ProjectRead,
+    ServerRead,
+    StatusResponse,
+    TokenResponse,
+    UserRead,
+    VaultGetResponse,
+    WorkspaceRead,
+)
+from forktex_cloud.config import CloudContext
+from forktex_cloud.manifest.loader import Manifest, ManifestError
+
+__all__ = [
+    # Filesystem layout spec (V1)
+    "paths",
+    # Codegen contract (wire-compatibility markers)
+    "SPEC_VERSION",
+    "SPEC_HASH",
+    # Client
+    "Cloud",
+    "CloudAPIError",
+    # Config
+    "CloudContext",
+    # Manifest
+    "Manifest",
+    "ManifestError",
+    # Models (from OpenAPI codegen — the single source of truth)
+    "ApiKeyCreated",
+    "ApiKeyRead",
+    "AuditEventRead",
+    "EnvironmentRead",
+    "HealthRead",
+    "JobResponse",
+    "MeResponse",
+    "OrgRead",
+    "ProjectRead",
+    "ServerRead",
+    "StatusResponse",
+    "TokenResponse",
+    "UserRead",
+    "VaultGetResponse",
+    "WorkspaceRead",
+]

forktex_cloud-0.5.0/src/forktex_cloud/bridge/__init__.py

@@ -0,0 +1 @@
+"""Bridge modules: manifest-to-Docker Compose for local dev."""

{forktex_cloud-0.2.3 → forktex_cloud-0.5.0}/src/forktex_cloud/bridge/local_compose.py

@@ -1,26 +1,3 @@
-# Copyright (C) 2026 FORKTEX S.R.L.
-#
-# SPDX-License-Identifier: AGPL-3.0-or-later OR LicenseRef-ForkTex-Commercial
-#
-# This file is part of forktex-cloud.
-#
-# For commercial licensing -- including use in proprietary products, SaaS
-# deployments, or any context where AGPL obligations cannot be met -- you
-# MUST obtain a commercial license from FORKTEX S.R.L. (info@forktex.com).
-#
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU Affero General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU Affero General Public License for more details.
-#
-# You should have received a copy of the GNU Affero General Public License
-# along with this program. If not, see <https://www.gnu.org/licenses/>.
-
 """Manifest -> local docker-compose generator.
 
 Generates a simple local-oriented docker-compose.local.yml from a forktex manifest.
@@ -165,24 +142,23 @@ def local_compose_from_manifest(
 
         svc: dict[str, Any] = {"image": image}
 
-        if svc_type == "compute":
-            build_cfg = svc_def.get("build")
-            if build_cfg and isinstance(build_cfg, dict):
-                # Use explicit build config from manifest overlay
-                build_entry: dict[str, str] = {}
-                ctx = build_cfg.get("context", f"./{sid}")
-                # Rewrite relative context to be relative to .forktex/ dir
-                if ctx.startswith("./"):
-                    build_entry["context"] = f"../{ctx[2:]}"
-                else:
-                    build_entry["context"] = ctx
-                if build_cfg.get("dockerfile"):
-                    build_entry["dockerfile"] = build_cfg["dockerfile"]
-                svc["build"] = build_entry
-            else:
-                dockerfile = project_root / sid / "Dockerfile"
-                if dockerfile.is_file():
-                    svc["build"] = {"context": f"../{sid}"}
+        # Build context — explicit overlay first, else auto-detect a sibling
+        # Dockerfile for compute services. Persistence services only opt in
+        # when the manifest explicitly declares `build` (zot is the canonical
+        # case — persistence-typed but first-party).
+        build_cfg = svc_def.get("build")
+        if build_cfg and isinstance(build_cfg, dict):
+            build_entry: dict[str, str] = {}
+            ctx = build_cfg.get("context", f"./{sid}")
+            # Rewrite relative context to be relative to .forktex/ dir
+            build_entry["context"] = f"../{ctx.removeprefix('./')}" if ctx.startswith("./") else ctx
+            if build_cfg.get("dockerfile"):
+                build_entry["dockerfile"] = build_cfg["dockerfile"]
+            svc["build"] = build_entry
+        elif svc_type == "compute":
+            dockerfile = project_root / sid / "Dockerfile"
+            if dockerfile.is_file():
+                svc["build"] = {"context": f"../{sid}"}
 
         if sid in host_ports:
             host_port = host_ports[sid]
@@ -230,12 +206,17 @@ def local_compose_from_manifest(
                 else:
                     rewritten.append(v)
             svc["volumes"] = rewritten
-        elif svc_type == "persistence":
+        if svc_type == "persistence":
+            # Bind-mount persistence data under .forktex/data/{sid}/ so it
+            # survives `docker compose down -v` and is visible on the host
+            # for inspection + backups. Mirrors api/src/bridge/local_compose.py.
             defaults = detect_persistence_defaults(image)
             if defaults and defaults.get("default_volume"):
-                vol_name = f"{sid}-data"
-                svc["volumes"] = [f"{vol_name}:{defaults['default_volume']}"]
-                named_volumes[vol_name] = None
+                target = defaults["default_volume"]
+                existing = svc.get("volumes", [])
+                if not any(isinstance(v, str) and v.endswith(f":{target}") for v in existing):
+                    existing.append(f"./data/{sid}:{target}")
+                    svc["volumes"] = existing
 
         cmd = svc_def.get("command")
         if cmd:

forktex_cloud-0.5.0/src/forktex_cloud/bridge/log_formatter.py

@@ -0,0 +1,39 @@
+"""ANSI color formatting for log output."""
+
+from __future__ import annotations
+
+import time
+
+# 8 distinct ANSI colors for service names
+COLORS = [
+    "\033[36m",  # cyan
+    "\033[32m",  # green
+    "\033[33m",  # yellow
+    "\033[35m",  # magenta
+    "\033[34m",  # blue
+    "\033[31m",  # red
+    "\033[37m",  # white
+    "\033[96m",  # bright cyan
+]
+
+DIM = "\033[2m"
+RESET = "\033[0m"
+
+
+def assign_colors(service_ids: list[str]) -> dict[str, str]:
+    """Assign a distinct ANSI color to each service (round-robin)."""
+    return {sid: COLORS[i % len(COLORS)] for i, sid in enumerate(sorted(service_ids))}
+
+
+def format_line(
+    ts_ns: int,
+    service: str,
+    line: str,
+    color: str,
+    max_name_len: int,
+) -> str:
+    """Format a single log line with timestamp, colored service name, and separator."""
+    t = time.gmtime(ts_ns // 1_000_000_000)
+    ts_str = time.strftime("%H:%M:%S", t)
+    padded = service.ljust(max_name_len)
+    return f"{DIM}{ts_str}{RESET} {color}{padded}{RESET} {DIM}|{RESET} {line}"

{forktex_cloud-0.2.3 → forktex_cloud-0.5.0}/src/forktex_cloud/bridge/loki.py

@@ -1,26 +1,3 @@
-# Copyright (C) 2026 FORKTEX S.R.L.
-#
-# SPDX-License-Identifier: AGPL-3.0-or-later OR LicenseRef-ForkTex-Commercial
-#
-# This file is part of forktex-cloud.
-#
-# For commercial licensing -- including use in proprietary products, SaaS
-# deployments, or any context where AGPL obligations cannot be met -- you
-# MUST obtain a commercial license from FORKTEX S.R.L. (info@forktex.com).
-#
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU Affero General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU Affero General Public License for more details.
-#
-# You should have received a copy of the GNU Affero General Public License
-# along with this program. If not, see <https://www.gnu.org/licenses/>.
-
 """Thin Loki HTTP API client using stdlib only."""
 
 from __future__ import annotations

{forktex_cloud-0.2.3 → forktex_cloud-0.5.0}/src/forktex_cloud/bridge/persistence_defaults.py

@@ -1,26 +1,3 @@
-# Copyright (C) 2026 FORKTEX S.R.L.
-#
-# SPDX-License-Identifier: AGPL-3.0-or-later OR LicenseRef-ForkTex-Commercial
-#
-# This file is part of forktex-cloud.
-#
-# For commercial licensing -- including use in proprietary products, SaaS
-# deployments, or any context where AGPL obligations cannot be met -- you
-# MUST obtain a commercial license from FORKTEX S.R.L. (info@forktex.com).
-#
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU Affero General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-# GNU Affero General Public License for more details.
-#
-# You should have received a copy of the GNU Affero General Public License
-# along with this program. If not, see <https://www.gnu.org/licenses/>.
-
 """Shared auto-config defaults for persistence services.
 
 Used by the dev compose generator to auto-detect healthchecks, volumes,