flieber 0.0.1__tar.gz

flieber-0.0.1/.gitignore

@@ -0,0 +1,16 @@
+__pycache__/
+*.py[cod]
+.venv/
+.env
+.env.*
+!.env.example
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+.idea/
+.vscode/

flieber-0.0.1/.gitlab-ci.yml

@@ -0,0 +1,38 @@
+# Build on every pipeline; publish to PyPI only from a version tag (vX.Y.Z).
+# Publishing uses PyPI trusted publishing (OIDC): no stored token. The job must match the
+# PyPI trusted publisher exactly: this file, environment `pypi`, ID token audience `pypi`.
+
+stages: [build, publish]
+
+default:
+  image: python:3.12-slim
+
+build:
+  stage: build
+  script:
+    - pip install --quiet build
+    - python -m build
+    - pip install --quiet dist/*.whl
+    - ver=$(flieber --version | cut -d' ' -f2)
+    - if [ -n "${CI_COMMIT_TAG}" ] && [ "${CI_COMMIT_TAG}" != "v${ver}" ]; then echo "Tag ${CI_COMMIT_TAG} does not match package version ${ver}"; exit 1; fi
+  artifacts:
+    paths: [dist/]
+    expire_in: 1 week
+
+publish-pypi:
+  stage: publish
+  rules:
+    - if: '$CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+([ab]\d+|rc\d+)?$/'
+  environment: pypi
+  id_tokens:
+    PYPI_ID_TOKEN:
+      aud: pypi
+  needs: [build]
+  script:
+    - pip install --quiet twine
+    - apt-get update -qq && apt-get install -y -qq curl jq > /dev/null
+    # Exchange the GitLab OIDC token for a short-lived PyPI upload token.
+    - resp=$(curl -sS -X POST https://pypi.org/_/oidc/mint-token -d "{\"token\":\"${PYPI_ID_TOKEN}\"}")
+    - api_token=$(echo "${resp}" | jq -r '.token')
+    - if [ -z "${api_token}" ] || [ "${api_token}" = "null" ]; then echo "PyPI token exchange failed:"; echo "${resp}" | jq 'del(.token)'; exit 1; fi
+    - twine upload --non-interactive -u __token__ -p "${api_token}" dist/*

flieber-0.0.1/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.0.1 (2026-09-29)
+
+- Placeholder release that reserves the `flieber` name on PyPI. `flieber` prints a notice; `flieber --version` prints the version.

flieber-0.0.1/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.5
+Name: flieber
+Version: 0.0.1
+Summary: The flieber command: CLI and MCP server for Flieber commerce data (actual sales, adjusted sales, forecast).
+Project-URL: Homepage, https://flieber.com
+Author: Flieber
+License: Proprietary
+Classifier: Development Status :: 1 - Planning
+Classifier: Environment :: Console
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# flieber-cli
+
+`flieber` is the command-line and agent interface to Flieber's commerce data. It gives developers, scripts and AI agents (Claude, Cursor, Lovable, custom agents) one stable, versioned way to read a tenant's:
+
+- **actual sales**: what each channel recorded, per product × store;
+- **adjusted sales**: actuals corrected for stockouts, outliers and price effects, used as the forecast input;
+- **forecast**: expected daily demand per product × store, about 12–14 months ahead.
+
+> **Status: v0 in design.** This README is the charter. The code arrives through the issues in the Linear project "Vibee Backend: v0 → greenfield gate" (team Flieber AI - R&D, milestone M3).
+
+## Shape
+
+One Python package: a shared core, and several surfaces built on it.
+
+```
+            ┌──────────────────── flieber (Python package) ────────────────────┐
+            │  core: auth · GraphQL client · versioned tool contract · shaping  │
+            └──────┬──────────────────────┬───────────────────────┬────────────┘
+                   │                      │                       │
+          CLI  `flieber …`      MCP (local)  `flieber mcp`   MCP (hosted)  `flieber mcp --http`
+          humans & scripts      stdio, launched by           container behind a stable URL,
+                                Claude / Cursor              used by the self-serve product
+```
+
+- **Core**
+  - Authentication with a Flieber public-API key (`FLIEBER_API_KEY`, or a config file written by `flieber auth login`).
+  - A client for core-service's public GraphQL API.
+  - **The versioned tool contract:** one definition per capability. It drives both the CLI command and the MCP tool, so the two can never drift.
+  - Output shaping for humans (tables) and for LLMs (compact `{columns, rows}`, point caps, pagination).
+- **CLI:** `flieber status`, `flieber listings`, `flieber sales`, `flieber adjusted`, `flieber forecast`, `flieber trends`. JSON output is available for scripts.
+- **MCP:** the same capabilities as MCP tools, over stdio (local) or streamable HTTP (hosted, stateless). The hosted mode forwards the caller's own API key and stores nothing.
+
+**Design rule:** customers bind to this contract, never to the raw GraphQL schema. The backend behind it may change; the contract changes only through versioning.
+
+## Principles
+
+- **The three signals are never mixed.**
+  - Adjusted sales never include today or later.
+  - The forecast never includes dates before today.
+  - Actual sales come only from the sales-analytics fields.
+- **Least privilege:** the key's grants in core-service decide what can be read. The tool reports a missing grant by name.
+- **No secrets at rest in the hosted mode.** Logs carry only a hash prefix of the key.
+- **Honest errors:** rate limits, missing grants and stale data are reported plainly, with a hint about what to do next.
+
+## Tooling (v0)
+
+- Python 3.12.
+- Packaging with `uv` and `pyproject.toml`; installable as `uvx flieber …` / `pipx install flieber`.
+- Tests with `pytest`.
+
+The PyPI names `flieber` and `flieber-cli` were free on 2026-09-29.
+
+## Related
+
+- **core-service:** the public GraphQL API at `/api/graphql`, and public-API keys with per-resource grants.
+- **flieber-build-front:** the self-serve portal, which issues API keys and shows the MCP and CLI configuration.
+- **ai-lab `tools/flieber_agent_tunnel`:** the existing `ask_flieber` MCP server. It is the reference for the streamable-HTTP MCP skeleton and the Clerk OAuth pieces.

flieber-0.0.1/README.md

@@ -0,0 +1,57 @@
+# flieber-cli
+
+`flieber` is the command-line and agent interface to Flieber's commerce data. It gives developers, scripts and AI agents (Claude, Cursor, Lovable, custom agents) one stable, versioned way to read a tenant's:
+
+- **actual sales**: what each channel recorded, per product × store;
+- **adjusted sales**: actuals corrected for stockouts, outliers and price effects, used as the forecast input;
+- **forecast**: expected daily demand per product × store, about 12–14 months ahead.
+
+> **Status: v0 in design.** This README is the charter. The code arrives through the issues in the Linear project "Vibee Backend: v0 → greenfield gate" (team Flieber AI - R&D, milestone M3).
+
+## Shape
+
+One Python package: a shared core, and several surfaces built on it.
+
+```
+            ┌──────────────────── flieber (Python package) ────────────────────┐
+            │  core: auth · GraphQL client · versioned tool contract · shaping  │
+            └──────┬──────────────────────┬───────────────────────┬────────────┘
+                   │                      │                       │
+          CLI  `flieber …`      MCP (local)  `flieber mcp`   MCP (hosted)  `flieber mcp --http`
+          humans & scripts      stdio, launched by           container behind a stable URL,
+                                Claude / Cursor              used by the self-serve product
+```
+
+- **Core**
+  - Authentication with a Flieber public-API key (`FLIEBER_API_KEY`, or a config file written by `flieber auth login`).
+  - A client for core-service's public GraphQL API.
+  - **The versioned tool contract:** one definition per capability. It drives both the CLI command and the MCP tool, so the two can never drift.
+  - Output shaping for humans (tables) and for LLMs (compact `{columns, rows}`, point caps, pagination).
+- **CLI:** `flieber status`, `flieber listings`, `flieber sales`, `flieber adjusted`, `flieber forecast`, `flieber trends`. JSON output is available for scripts.
+- **MCP:** the same capabilities as MCP tools, over stdio (local) or streamable HTTP (hosted, stateless). The hosted mode forwards the caller's own API key and stores nothing.
+
+**Design rule:** customers bind to this contract, never to the raw GraphQL schema. The backend behind it may change; the contract changes only through versioning.
+
+## Principles
+
+- **The three signals are never mixed.**
+  - Adjusted sales never include today or later.
+  - The forecast never includes dates before today.
+  - Actual sales come only from the sales-analytics fields.
+- **Least privilege:** the key's grants in core-service decide what can be read. The tool reports a missing grant by name.
+- **No secrets at rest in the hosted mode.** Logs carry only a hash prefix of the key.
+- **Honest errors:** rate limits, missing grants and stale data are reported plainly, with a hint about what to do next.
+
+## Tooling (v0)
+
+- Python 3.12.
+- Packaging with `uv` and `pyproject.toml`; installable as `uvx flieber …` / `pipx install flieber`.
+- Tests with `pytest`.
+
+The PyPI names `flieber` and `flieber-cli` were free on 2026-09-29.
+
+## Related
+
+- **core-service:** the public GraphQL API at `/api/graphql`, and public-API keys with per-resource grants.
+- **flieber-build-front:** the self-serve portal, which issues API keys and shows the MCP and CLI configuration.
+- **ai-lab `tools/flieber_agent_tunnel`:** the existing `ask_flieber` MCP server. It is the reference for the streamable-HTTP MCP skeleton and the Clerk OAuth pieces.

flieber-0.0.1/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "flieber"
+version = "0.0.1"
+description = "The flieber command: CLI and MCP server for Flieber commerce data (actual sales, adjusted sales, forecast)."
+readme = "README.md"
+requires-python = ">=3.12"
+license = { text = "Proprietary" }
+authors = [{ name = "Flieber" }]
+classifiers = [
+  "Development Status :: 1 - Planning",
+  "Environment :: Console",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.12",
+  "License :: Other/Proprietary License",
+]
+
+[project.urls]
+Homepage = "https://flieber.com"
+
+[project.scripts]
+flieber = "flieber.__main__:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/flieber"]

flieber-0.0.1/src/flieber/__init__.py

@@ -0,0 +1,3 @@
+"""flieber: the command-line and agent interface to Flieber commerce data."""
+
+__version__ = "0.0.1"

flieber-0.0.1/src/flieber/__main__.py

@@ -0,0 +1,27 @@
+"""Entry point for the `flieber` command.
+
+0.0.1 is a placeholder release that reserves the package name. The real CLI and
+MCP server (actual sales, adjusted sales and forecast) arrive in later versions.
+"""
+
+import sys
+
+from flieber import __version__
+
+MESSAGE = (
+    f"flieber {__version__}: placeholder release.\n"
+    "The Flieber CLI and MCP server (actual sales, adjusted sales and forecast) are coming soon."
+)
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = sys.argv[1:] if argv is None else argv
+    if args in (["--version"], ["-V"]):
+        print(f"flieber {__version__}")
+        return 0
+    print(MESSAGE)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())