Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
16 changes: 5 additions & 11 deletions .github/workflows/docker-publish.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,7 @@
# * Platforms : linux/amd64, linux/arm64
# * Registry : ghcr.io/<owner>/<repo>
# (the owner is normalised to lower-case below, since
# GHCR rejects upper-case namespaces -- ``firefly-operationOS``
# -> ``firefly-operationos``).
# GHCR requires lower-case repository namespaces).
#
# The Dockerfile uses BuildKit named contexts for the pyfly +
# fireflyframework-agentic sibling repos. We clone them into ./vendor/
Expand Down Expand Up @@ -112,7 +111,7 @@ jobs:
type=raw,value=manual-${{ github.run_id }},enable=${{ github.event_name == 'workflow_dispatch' }}
labels: |
org.opencontainers.image.title=flyquery
org.opencontainers.image.description=flyquery -- Operational Structured-Data Intelligence (upload-driven). Multi-tenant ingestion + Text-to-SQL service over user-uploaded structured files (CSV / TSV / XLSX / XLS / ODS / JSON / JSONL / Parquet / Avro / ORC / Arrow / Feather + compression variants). Materialises uploads to Parquet on object storage; indexes a long-lived schema knowledge base; answers natural-language questions via a multi-agent pipeline. Part of Firefly OperationOS.
org.opencontainers.image.description=flyquery -- Operational Structured-Data Intelligence (upload-driven). Multi-tenant ingestion + Text-to-SQL service over user-uploaded structured files (CSV / TSV / XLSX / XLS / ODS / JSON / JSONL / Parquet / Avro / ORC / Arrow / Feather + compression variants). Materialises uploads to Parquet on object storage; indexes a long-lived schema knowledge base; answers natural-language questions via a multi-agent pipeline. Part of Firefly Framework.
org.opencontainers.image.source=https://github.com/${{ github.repository }}
org.opencontainers.image.licenses=Apache-2.0
org.opencontainers.image.vendor=Firefly Software Foundation
Expand All @@ -125,14 +124,9 @@ jobs:
file: ./Dockerfile
platforms: linux/amd64,linux/arm64
push: true
# provenance + sbom attestations require GitHub
# 'Build & Validate Attestations' which is an Enterprise /
# paid org feature. firefly-operationOS is on the free tier
# so the attestation persist call returns
# 'Feature not available for the firefly-operationOS
# organization' and fails the build. Disable both flags
# here; the optional attest-build-provenance step below
# is already wrapped with continue-on-error.
# Preserve the existing publication policy during the source transfer.
# Re-enable these only after attestation support is verified for the
# destination organization; the separate provenance step is advisory.
provenance: false
sbom: false
tags: ${{ steps.meta.outputs.tags }}
Expand Down
5 changes: 4 additions & 1 deletion .github/workflows/pr-gate.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
# Notes
# -----
# * pyfly + fireflyframework-agentic live in the public
# ``fireflyframework`` org (NOT ``firefly-operationOS``). The
# ``fireflyframework`` organization. The
# per-job ``Check out sibling firefly framework repos`` step
# clones the tagged refs into ``./vendor/`` and ``sed``-rewrites
# ``[tool.uv.sources]`` to point there for the duration of CI.
Expand Down Expand Up @@ -182,13 +182,16 @@ jobs:
pyproject.toml
- name: uv sync (dev + s3 for MinIO conformance)
run: uv sync --extra dev --extra s3 --extra file-readers
- name: Build the pinned upstream MinIO test server
run: docker build --tag flyquery-integration-minio:${{ github.sha }} tests/integration/minio
- name: pytest tests/integration
# Integration tests boot real Postgres + Redis + MinIO
# containers via testcontainers. GitHub Actions Ubuntu runners
# ship with Docker, so the testcontainers handshakes succeed.
# GCS / Azure conformance tests stay skipped (no testcontainer
# images installed); LLM-gated tests stay deselected.
env:
FLYQUERY_TEST_MINIO_IMAGE: flyquery-integration-minio:${{ github.sha }}
OPENAI_API_KEY: sk-dummy-key
ANTHROPIC_API_KEY: sk-dummy-key
AWS_DEFAULT_REGION: eu-west-1
Expand Down
8 changes: 4 additions & 4 deletions .github/workflows/publish-sdks.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,13 @@
# - workflow_dispatch -> manual re-publish
#
# * Java SDK -> ``mvn deploy`` to GitHub Packages at
# https://maven.pkg.github.com/firefly-operationOS/flyquery
# https://maven.pkg.github.com/fireflyframework/flyquery
#
# * Python SDK -> build sdist + wheel with ``uv build`` and attach
# both to the GitHub Release. We do NOT publish to
# PyPI -- users install directly from the release URL:
#
# uv add https://github.com/firefly-operationOS/flyquery/releases/download/v26.05.04/flyquery_sdk-26.5.4-py3-none-any.whl
# uv add https://github.com/fireflyframework/flyquery/releases/download/v26.05.04/flyquery_sdk-26.5.4-py3-none-any.whl
#
# Docs-only commits do not trigger this workflow (tags only).

Expand Down Expand Up @@ -90,7 +90,7 @@ jobs:
# pre-check the .pom URL with a HEAD; a 200 means the version
# is already on Packages and we treat this run as a success.
VERSION=$(mvn -B -q -DforceStdout help:evaluate -Dexpression=project.version)
URL="https://maven.pkg.github.com/firefly-operationOS/flyquery/com/firefly/flyquery-sdk/${VERSION}/flyquery-sdk-${VERSION}.pom"
URL="https://maven.pkg.github.com/fireflyframework/flyquery/com/firefly/flyquery-sdk/${VERSION}/flyquery-sdk-${VERSION}.pom"
code=$(curl -s -o /dev/null -w "%{http_code}" -u "${GITHUB_ACTOR}:${GITHUB_TOKEN}" -I "$URL")
echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
echo "url=${URL}" >> "$GITHUB_OUTPUT"
Expand Down Expand Up @@ -122,7 +122,7 @@ jobs:
echo "### Published Java SDK"
echo
echo "**Coordinates**: \`com.firefly:flyquery-sdk:$(mvn -B -q -DforceStdout help:evaluate -Dexpression=project.version)\`"
echo "**Repository**: https://maven.pkg.github.com/firefly-operationOS/flyquery"
echo "**Repository**: https://maven.pkg.github.com/fireflyframework/flyquery"
echo
echo "Add to your \`pom.xml\`:"
echo '```xml'
Expand Down
14 changes: 13 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,11 @@
<div align="center">

<img src="docs/assets/logo.png" alt="flyquery — tabular intelligence" width="520" />
<picture>
<source media="(prefers-color-scheme: dark) and (max-width: 600px)" srcset="docs/assets/brand/banner-dark-mobile.svg">
<source media="(max-width: 600px)" srcset="docs/assets/brand/banner-light-mobile.svg">
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/brand/banner-dark.svg">
<img src="docs/assets/brand/banner-light.svg" alt="flyquery by Firefly" width="100%">
</picture>

### **Tabular Intelligence**

Expand Down Expand Up @@ -293,6 +298,13 @@ See [docs/architecture.md](docs/architecture.md) for the full picture.

---

## Repository and identity

Source, issues and release downloads are hosted under the
[fireflyframework organization](https://github.com/fireflyframework/flyquery).
See [identity and package registries](docs/branding.md) for banner provenance
and the distinction between source transfers and historical package namespaces.

## License

flyquery is released under the [Apache License 2.0](LICENSE) —
Expand Down
12 changes: 11 additions & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,11 @@
<div align="center">

<img src="assets/logo.png" alt="flyquery — tabular intelligence" width="380" />
<picture>
<source media="(prefers-color-scheme: dark) and (max-width: 600px)" srcset="assets/brand/banner-dark-mobile.svg">
<source media="(max-width: 600px)" srcset="assets/brand/banner-light-mobile.svg">
<source media="(prefers-color-scheme: dark)" srcset="assets/brand/banner-dark.svg">
<img src="assets/brand/banner-light.svg" alt="flyquery by Firefly" width="100%">
</picture>

### **Documentation**

Expand Down Expand Up @@ -195,3 +200,8 @@ task openapi-snapshot
```

The Swagger UI at `/docs` and Redoc at `/redoc` both browse the live spec.

## Repository and identity

See [branding.md](branding.md) for the canonical repository, light/dark and
mobile banners, artwork provenance, and package-registry transition.
2 changes: 1 addition & 1 deletion docs/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@

## 1. System position

flyquery is the third pillar of **Firefly OperationOS**, alongside flycanon
flyquery is the third pillar of **Firefly Framework**, alongside flycanon
(operational knowledge repository for unstructured content) and flyradar
(operations-discovery and diagnostic intelligence).

Expand Down
2 changes: 2 additions & 0 deletions docs/assets/brand/banner-dark-mobile.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 2 additions & 0 deletions docs/assets/brand/banner-dark.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 2 additions & 0 deletions docs/assets/brand/banner-light-mobile.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 2 additions & 0 deletions docs/assets/brand/banner-light.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 2 additions & 0 deletions docs/assets/brand/logo-dark.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 2 additions & 0 deletions docs/assets/brand/logo-light.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Loading