flow-atelier 0.1.7__tar.gz

flow_atelier-0.1.7/.env.example

@@ -0,0 +1,43 @@
+# flow-atelier environment variables
+# Copy to .env and uncomment/override as needed. All have sensible defaults.
+
+# Base directory for conduits/ and flows/. Default: ./.atelier
+# ATELIER_ATELIER_DIR=.atelier
+
+# Global directory for shared conduits (flows are always project-local).
+# Default: ~/.atelier
+# ATELIER_GLOBAL_ATELIER_DIR=~/.atelier
+
+# Per-task default timeout in seconds. Default: 3600
+# ATELIER_DEFAULT_TIMEOUT=3600
+
+# Max tasks running in parallel within a conduit. Default: 3
+# ATELIER_DEFAULT_MAX_CONCURRENCY=3
+
+# Override the argv used to launch the harness:claude-code ACP agent.
+# JSON array. Empty (default) uses: ["npx","-y","@zed-industries/claude-code-acp@0.16.2"]
+# ATELIER_CLAUDE_LAUNCH_CMD=["npx","-y","@zed-industries/claude-code-acp@0.16.2"]
+
+# Override the argv used to launch the harness:codex ACP agent.
+# JSON array. Empty (default) uses: ["npx","-y","@zed-industries/codex-acp@0.11.1"]
+# ATELIER_CODEX_LAUNCH_CMD=["npx","-y","@zed-industries/codex-acp@0.11.1"]
+
+# Override the argv used to launch the harness:opencode ACP agent.
+# JSON array. Empty (default) uses: ["opencode","acp"]
+# ATELIER_OPENCODE_LAUNCH_CMD=["opencode","acp"]
+
+# Override the argv used to launch the harness:copilot ACP agent.
+# JSON array. Empty (default) uses: ["copilot","--acp"]
+# ATELIER_COPILOT_LAUNCH_CMD=["copilot","--acp"]
+
+# Override the argv used to launch the harness:cursor ACP agent.
+# JSON array. Empty (default) uses: ["npx","-y","@blowmage/cursor-agent-acp@0.7.1"]
+# ATELIER_CURSOR_LAUNCH_CMD=["npx","-y","@blowmage/cursor-agent-acp@0.7.1"]
+
+# Token the harness looks for in interactive mode. Default: [ATELIER_DONE]
+# ATELIER_DONE_MARKER=[ATELIER_DONE]
+
+# Optional bearer token for the HTTP/WS API served by `atelier serve`.
+# When set, REST requests need 'Authorization: Bearer <token>' and WS
+# connections need '?token=<token>'. Empty (default) = no auth.
+# ATELIER_API_TOKEN=

flow_atelier-0.1.7/.github/workflows/ci.yml

@@ -0,0 +1,36 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv python install 3.13
+      - run: uv sync --dev
+      - name: Lint (ruff)
+        run: uv run ruff check .
+
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv python install 3.13
+      - run: uv sync --dev
+      - name: Tests (live harness excluded via marker)
+        run: uv run pytest

flow_atelier-0.1.7/.github/workflows/cla.yml

@@ -0,0 +1,36 @@
+name: "CLA Assistant"
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_target:
+    types: [opened, closed, synchronize]
+
+# Required so the action can store signatures and set the PR status.
+permissions:
+  actions: write
+  contents: write
+  pull-requests: write
+  statuses: write
+
+jobs:
+  CLAAssistant:
+    runs-on: ubuntu-latest
+    steps:
+      - name: "CLA Assistant"
+        if: (github.event.comment.body == 'recheck' || github.event.comment.body == 'I have read the CLA Document and I hereby sign the CLA') || github.event_name == 'pull_request_target'
+        # Pin: verify the latest release at
+        # https://github.com/contributor-assistant/github-action/releases and bump as needed.
+        uses: contributor-assistant/github-action@v2.6.1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          path-to-signatures: "signatures/version1/cla.json"
+          path-to-document: "https://github.com/LGuillermoAngaritaG/flow-atelier/blob/main/CLA.md"
+          # Signatures are committed here directly; it must be an UNPROTECTED
+          # branch (the main ruleset requires PRs, which blocks the action).
+          branch: "cla-signatures"
+          allowlist: LGuillermoAngaritaG,dependabot[bot],*[bot]
+          custom-notsigned-prcomment: "Thank you for your contribution. Before we can merge it, please read our [Contributor License Agreement](https://github.com/LGuillermoAngaritaG/flow-atelier/blob/main/CLA.md) and sign it by posting the comment below."
+          custom-pr-sign-comment: "I have read the CLA Document and I hereby sign the CLA"
+          custom-allsigned-prcomment: "All contributors have signed the CLA. Thank you!"

flow_atelier-0.1.7/.github/workflows/frontend.yml

@@ -0,0 +1,77 @@
+name: Frontend
+
+# Builds the React/Vite UI under frontend/ and syncs its build output into
+# flow_atelier/dist/ — the bundled SPA that ships in the wheel and is served by
+# the FastAPI app (see flow_atelier/services/api/app.py, _STATIC_DIR).
+#
+# On pushes to main the rebuilt bundle is committed back so the repo (and the
+# published wheel) always carry a current UI. The commit is made with
+# GITHUB_TOKEN and tagged [skip ci]; GITHUB_TOKEN pushes do not re-trigger
+# workflows, so there is no build loop. On PRs the workflow builds as a check
+# only and does not commit.
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - "frontend/**"
+      - ".github/workflows/frontend.yml"
+  pull_request:
+    branches: [main]
+    paths:
+      - "frontend/**"
+      - ".github/workflows/frontend.yml"
+
+permissions:
+  contents: write
+
+concurrency:
+  group: frontend-${{ github.ref }}
+  # Do not cancel a run that may be mid-commit/push to main.
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: frontend
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        # For a production bundle set VITE_USE_MOCK_API / VITE_BACKEND_URL via
+        # repo variables or secrets; left unset, the build ships mock data.
+        run: npm run build
+
+      - name: Sync build output to flow_atelier/dist
+        working-directory: .
+        run: |
+          rm -rf flow_atelier/dist
+          cp -r frontend/dist flow_atelier/dist
+
+      - name: Commit bundled UI
+        if: >-
+          (github.event_name == 'push' || github.event_name == 'workflow_dispatch')
+          && github.ref == 'refs/heads/main'
+        working-directory: .
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add flow_atelier/dist
+          if git diff --cached --quiet; then
+            echo "No UI changes — nothing to commit."
+          else
+            git commit -m "chore(ui): rebuild bundled frontend [skip ci]"
+            git push
+          fi

flow_atelier-0.1.7/.github/workflows/release.yml

@@ -0,0 +1,123 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  verify-version:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Tag matches pyproject version
+        run: |
+          tag="${GITHUB_REF_NAME#v}"
+          pyver=$(grep -E '^version = ' pyproject.toml | head -1 | cut -d'"' -f2)
+          test "$tag" = "$pyver" || { echo "tag $tag != pyproject $pyver"; exit 1; }
+
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv python install 3.13
+      - run: uv sync --dev
+      - run: uv run ruff check .
+      - run: uv run pytest
+
+  build-wheel:
+    needs: [verify-version, test]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv python install 3.13
+      - run: uv build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+
+  build-binary:
+    needs: [verify-version, test]
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            asset: atelier-linux-x86_64
+            bin: atelier
+          - os: macos-latest
+            asset: atelier-macos-arm64
+            bin: atelier
+          - os: windows-latest
+            asset: atelier-windows-x86_64.exe
+            bin: atelier.exe
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+      - run: uv python install 3.13
+      - run: uv sync --dev
+      - name: Build binary
+        shell: bash
+        run: |
+          uv run pyinstaller scripts/atelier_entry.py \
+            --onefile --name atelier --clean --noconfirm \
+            --copy-metadata flow-atelier \
+            --collect-all uvicorn \
+            --collect-all apscheduler \
+            --collect-all tzdata \
+            --collect-all agent_client_protocol
+      - name: Smoke test the binary
+        shell: bash
+        run: |
+          ./dist/${{ matrix.bin }} --help
+          ./dist/${{ matrix.bin }} --version
+      - name: Rename for upload
+        shell: bash
+        run: mv dist/${{ matrix.bin }} dist/${{ matrix.asset }}
+      - uses: actions/upload-artifact@v4
+        with:
+          name: bin-${{ matrix.os }}
+          path: dist/${{ matrix.asset }}
+
+  publish-pypi:
+    needs: [build-wheel, build-binary]
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    needs: [build-wheel, build-binary]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+      - name: Flatten artifacts
+        run: mkdir -p release && find artifacts -type f -exec cp {} release/ \;
+      - name: Generate SHA256SUMS
+        working-directory: release
+        run: sha256sum * > SHA256SUMS
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: release/*
+          generate_release_notes: true
+          fail_on_unmatched_files: true

flow_atelier-0.1.7/.gitignore

@@ -0,0 +1,32 @@
+.env
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+/dist/
+wheels/
+*.egg-info
+*.spec
+.ruff_cache/
+
+# Virtual environments
+.venv*
+.claude
+.atelier/flows
+.devtool
+claude.md
+.pytest_cache
+.DS_Store
+.opencode
+AGENTS.md
+.agents/
+.atelier/
+
+# Frontend (React/Vite) — tooling & local build artifacts under frontend/.
+# NOTE: flow_atelier/dist/ is intentionally NOT ignored — it is the committed
+frontend/node_modules/
+frontend/dist/
+frontend/coverage/
+frontend/.devtool/
+frontend/.env
+*.tsbuildinfo

flow_atelier-0.1.7/.pre-commit-config.yaml

@@ -0,0 +1,15 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.12
+    hooks:
+      - id: ruff
+        args: [--fix]
+
+  - repo: local
+    hooks:
+      - id: pytest
+        name: pytest (live harness excluded via marker)
+        entry: uv run pytest
+        language: system
+        pass_filenames: false
+        stages: [pre-push]

flow_atelier-0.1.7/.python-version

@@ -0,0 +1 @@
+3.13

flow_atelier-0.1.7/CLA.md

@@ -0,0 +1,121 @@
+# flow-atelier Individual Contributor License Agreement (CLA)
+
+Thank you for your interest in contributing to flow-atelier (the "Project"),
+maintained by Guillermo Angarita (the "Owner").
+
+This Contributor License Agreement ("Agreement") documents the rights granted by
+contributors to the Owner. It protects the Project and its users, and it lets
+the Owner offer the Project under open source and, where applicable, commercial
+terms. By signing this Agreement, you accept and agree to the following terms
+for your present and future Contributions submitted to the Project. Except for
+the licenses granted here to the Owner, you retain all right, title, and
+interest in and to your Contributions.
+
+## 1. Definitions
+
+"You" (or "Your") means the individual who submits a Contribution to the
+Project, or the legal entity on behalf of whom this Agreement is signed.
+
+"Contribution" means any original work of authorship, including any
+modifications or additions to an existing work, that is intentionally submitted
+by You to the Owner for inclusion in, or documentation of, the Project. For the
+purposes of this definition, "submitted" means any form of electronic, verbal,
+or written communication sent to the Owner or its representatives, including but
+not limited to communication on electronic mailing lists, source code control
+systems, and issue tracking systems that are managed by, or on behalf of, the
+Owner, but excluding communication that is conspicuously marked or otherwise
+designated in writing by You as "Not a Contribution."
+
+## 2. Grant of Copyright License
+
+Subject to the terms and conditions of this Agreement, You hereby grant to the
+Owner and to recipients of software distributed by the Owner a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license
+to reproduce, prepare derivative works of, publicly display, publicly perform,
+and distribute Your Contributions and such derivative works.
+
+You further grant the Owner the right to **license and sublicense Your
+Contributions, and derivative works of them, under any license terms**,
+including open source licenses, source-available licenses, and proprietary or
+commercial licenses, and to relicense the Project (including Your Contributions)
+under different terms in the future. This right is what allows the Owner to
+maintain the Project as open source while also offering commercial or
+dual-licensed editions.
+
+## 3. Grant of Patent License
+
+Subject to the terms and conditions of this Agreement, You hereby grant to the
+Owner and to recipients of software distributed by the Owner a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated
+in this section) patent license to make, have made, use, offer to sell, sell,
+import, and otherwise transfer Your Contributions, where such license applies
+only to those patent claims licensable by You that are necessarily infringed by
+Your Contribution(s) alone or by combination of Your Contribution(s) with the
+work to which such Contribution(s) was submitted. If any entity institutes
+patent litigation against You or any other entity (including a cross-claim or
+counterclaim in a lawsuit) alleging that Your Contribution, or the work to which
+You have contributed, constitutes direct or contributory patent infringement,
+then any patent licenses granted to that entity under this Agreement for that
+Contribution or work shall terminate as of the date such litigation is filed.
+
+## 4. Your Representations
+
+You represent that:
+
+(a) You are legally entitled to grant the above licenses. If Your employer(s)
+    have rights to intellectual property that You create that includes Your
+    Contributions, You represent that You have received permission to make
+    Contributions on behalf of that employer, that Your employer has waived such
+    rights for Your Contributions to the Owner, or that Your employer has
+    executed a separate Corporate CLA with the Owner.
+
+(b) Each of Your Contributions is Your original creation (see Section 5 for
+    submissions on behalf of others).
+
+(c) Your Contribution submissions include complete details of any third-party
+    license or other restriction (including, but not limited to, related
+    patents and trademarks) of which You are personally aware and which are
+    associated with any part of Your Contributions.
+
+## 5. Third-Party Works
+
+Should You wish to submit work that is not Your original creation, You may submit
+it to the Owner separately from any Contribution, identifying the complete
+details of its source and of any license or other restriction (including, but
+not limited to, related patents, trademarks, and license agreements) of which
+You are personally aware, and conspicuously marking the work as "Submitted on
+behalf of a third-party: [named here]".
+
+## 6. No Obligation; No Warranty
+
+You are not expected to provide support for Your Contributions, except to the
+extent You desire to provide support. You may provide support for free, for a
+fee, or not at all. Unless required by applicable law or agreed to in writing,
+You provide Your Contributions on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied, including, without
+limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT,
+MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE.
+
+The Owner is not obligated to use, include, or distribute Your Contributions.
+
+## 7. Notification
+
+You agree to notify the Owner of any facts or circumstances of which You become
+aware that would make these representations inaccurate in any respect.
+
+---
+
+## How to sign
+
+You sign this Agreement electronically when you open your first pull request: an
+automated assistant will comment on the PR with instructions. To sign, you post
+a comment on the pull request containing exactly:
+
+> I have read the CLA Document and I hereby sign the CLA
+
+Your GitHub username and the signing event are recorded in
+`signatures/version1/cla.json` in this repository. One signature covers all of
+your present and future Contributions to the Project.
+
+**Corporate contributors:** if you are contributing on behalf of a company,
+contact the Owner to arrange a Corporate CLA before submitting.

flow_atelier-0.1.7/CONTRIBUTING.md

@@ -0,0 +1,50 @@
+# Contributing to flow-atelier
+
+Thanks for your interest in contributing. This document explains how to submit
+changes and the legal terms under which contributions are accepted.
+
+## License of contributions
+
+flow-atelier is open source under the [Apache License, Version 2.0](LICENSE).
+The Project is also developed as an open-core product: some editions or
+companion services may be offered under commercial terms. To keep both models
+possible, contributions are accepted under a Contributor License Agreement.
+
+## Contributor License Agreement (CLA)
+
+Before your contribution can be merged, you must sign the
+[Contributor License Agreement](CLA.md). The CLA confirms you have the right to
+submit your work and grants the Owner the rights needed to distribute it as open
+source and, where applicable, under commercial terms. You keep the copyright to
+your contributions.
+
+Signing is a one-time, automated step:
+
+1. Open your pull request.
+2. The CLA Assistant bot will comment on the PR with a link to the CLA.
+3. Reply on the PR with exactly:
+
+   > I have read the CLA Document and I hereby sign the CLA
+
+4. The bot records your signature in `signatures/version1/cla.json`. One
+   signature covers all your present and future contributions.
+
+If you are contributing on behalf of a company, contact the Owner to arrange a
+Corporate CLA before submitting.
+
+## How to contribute
+
+1. Fork the repository and create a branch from `main`.
+2. Make your change. Keep commits focused and write clear messages.
+3. Run the test suite and linters locally before opening a PR:
+   ```bash
+   uv run pytest
+   uv run ruff check .
+   ```
+4. Open a pull request describing what the change does and why.
+5. Sign the CLA when the bot prompts you (see above).
+
+## Reporting bugs and requesting features
+
+Open an issue on GitHub. For bugs, include the flow-atelier version, your OS,
+the conduit or command you ran, and the full output.