floop 1.2.0__tar.gz → 2.0.1__tar.gz

floop-2.0.1/.github/workflows/cicd.yml

@@ -0,0 +1,34 @@
+name: Test & Deploy Docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.12', '3.13']
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[test]"
+
+      - name: Run tests
+        run: python -m pytest tests/ -v

floop-2.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 floop
+
+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.

floop-2.0.1/PKG-INFO

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: floop
+Version: 2.0.1
+Summary: Project/version review loop CLI and agent skill for AI artifacts
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: test
+Requires-Dist: pytest>=8.0; extra == "test"
+Requires-Dist: pytest-cov>=5.0; extra == "test"
+Dynamic: license-file
+
+# floop-client
+
+**floop-client is the CLI for project/version uploads and server comments.**
+
+[![PyPI version](https://img.shields.io/pypi/v/floop?style=for-the-badge)](https://pypi.org/project/floop/)
+[![Python](https://img.shields.io/pypi/pyversions/floop?style=for-the-badge)](https://pypi.org/project/floop/)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
+[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen?style=for-the-badge)](#)
+
+floop-client is intentionally small. It helps agents and users choose the right
+local project/version, upload the right files to floop-server, read server
+comments, and resolve comments after a newer version addresses them.
+
+It does not build artifacts, validate design tokens, generate UI, or decide
+which files belong to another tool. The tool or user that owns the files places
+them in a floop version directory; floop handles the upload and comment loop.
+
+## Core Flow
+
+```text
+Create/select project -> Create/select version -> Add files -> Upload -> Read comments -> Resolve comments
+```
+
+## Installation
+
+```bash
+pip install floop
+```
+
+Verify:
+
+```bash
+floop --version
+```
+
+## Quick Start
+
+```bash
+# 1. Initialize workspace
+cd your-project
+floop init
+
+# 2. Install the floop skill into your AI agent
+floop enable copilot     # or: cursor, claude, trae, qwen-code, opencode, openclaw
+
+# 3. Create and select a local project
+floop projects create my-review
+floop projects use my-review
+
+# 4. Create and select a version
+floop versions create v1 --project my-review --artifact-type custom --entrypoint index.html
+floop versions use v1 --project my-review
+
+# 5. Put uploadable files in .floop/my-review/v1/
+
+# 6. Configure server access and upload
+floop review set --project my-review
+floop review upload --project my-review --version v1 --json-output
+
+# 7. Read server comments and cache them locally
+floop comments --project my-review --version v1 --version-id <server-version-id> --json-output
+
+# 8. Resolve addressed comments after a newer version has been uploaded
+floop resolve <comment-id> --project my-review --version-id <server-version-id> --status resolved
+```
+
+## Workspace
+
+```text
+.floop/
+├─ floop.env              # Server URL + API key only
+├─ projects.csv           # Local projects, server bindings, selected project/version
+└─ <projectid>/
+   └─ <version>/
+      ├─ floop.version.json
+      ├─ floop.upload.json
+      ├─ floop.comments.json
+      └─ ...uploadable files...
+```
+
+`.floop/floop.env` contains secrets. floop-client warns through docs and command
+copy, but it does not create or edit `.floop/.gitignore`; ignore policy belongs
+to the host repository.
+
+Legacy workspaces under `.floop/projects/<project>/versions/<version>/` are
+readable for compatibility. floop-client does not move or delete legacy files
+automatically.
+
+## Commands
+
+### Workspace
+
+```bash
+floop init
+floop preview
+```
+
+### Projects
+
+```bash
+floop projects
+floop projects create <project>
+floop projects use <project>
+```
+
+### Versions
+
+```bash
+floop versions --project <project>
+floop versions create <version> --project <project> --artifact-type <type> --entrypoint index.html
+floop versions use <version> --project <project>
+```
+
+When a project and version are selected, commands that support defaults can use
+the selected values.
+
+### Server
+
+```bash
+floop review set --project <project>
+floop review upload --project <project> --version <version> --json-output
+floop comments --project <project> --version <local-version> --version-id <server-version-id> --json-output
+floop resolve <comment-id> --project <project> --version-id <server-version-id> --status resolved
+```
+
+## Responsibility Boundary
+
+| floop-client owns | Other tools or users own |
+|---|---|
+| `.floop/` workspace | Source files |
+| `projects.csv` project/version selection | File generation |
+| Server project binding | File validation |
+| Version upload | Build systems |
+| Server comments cache | Artifact internals |
+| Comment status updates | Content changes |
+
+## Supported Agents
+
+| Agent | Command |
+|-------|---------|
+| GitHub Copilot | `floop enable copilot` |
+| Cursor | `floop enable cursor` |
+| Claude Code | `floop enable claude` |
+| Trae IDE | `floop enable trae` |
+| Qwen Code | `floop enable qwen-code` |
+| OpenCode | `floop enable opencode` |
+| OpenClaw | `floop enable openclaw` |
+
+## For Contributors
+
+Run the full test gate:
+
+```bash
+PYTHONPATH=src python3 -m pytest --cov=floop --cov-report=term-missing --cov-fail-under=100
+```

floop-2.0.1/README.md

@@ -0,0 +1,155 @@
+# floop-client
+
+**floop-client is the CLI for project/version uploads and server comments.**
+
+[![PyPI version](https://img.shields.io/pypi/v/floop?style=for-the-badge)](https://pypi.org/project/floop/)
+[![Python](https://img.shields.io/pypi/pyversions/floop?style=for-the-badge)](https://pypi.org/project/floop/)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
+[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen?style=for-the-badge)](#)
+
+floop-client is intentionally small. It helps agents and users choose the right
+local project/version, upload the right files to floop-server, read server
+comments, and resolve comments after a newer version addresses them.
+
+It does not build artifacts, validate design tokens, generate UI, or decide
+which files belong to another tool. The tool or user that owns the files places
+them in a floop version directory; floop handles the upload and comment loop.
+
+## Core Flow
+
+```text
+Create/select project -> Create/select version -> Add files -> Upload -> Read comments -> Resolve comments
+```
+
+## Installation
+
+```bash
+pip install floop
+```
+
+Verify:
+
+```bash
+floop --version
+```
+
+## Quick Start
+
+```bash
+# 1. Initialize workspace
+cd your-project
+floop init
+
+# 2. Install the floop skill into your AI agent
+floop enable copilot     # or: cursor, claude, trae, qwen-code, opencode, openclaw
+
+# 3. Create and select a local project
+floop projects create my-review
+floop projects use my-review
+
+# 4. Create and select a version
+floop versions create v1 --project my-review --artifact-type custom --entrypoint index.html
+floop versions use v1 --project my-review
+
+# 5. Put uploadable files in .floop/my-review/v1/
+
+# 6. Configure server access and upload
+floop review set --project my-review
+floop review upload --project my-review --version v1 --json-output
+
+# 7. Read server comments and cache them locally
+floop comments --project my-review --version v1 --version-id <server-version-id> --json-output
+
+# 8. Resolve addressed comments after a newer version has been uploaded
+floop resolve <comment-id> --project my-review --version-id <server-version-id> --status resolved
+```
+
+## Workspace
+
+```text
+.floop/
+├─ floop.env              # Server URL + API key only
+├─ projects.csv           # Local projects, server bindings, selected project/version
+└─ <projectid>/
+   └─ <version>/
+      ├─ floop.version.json
+      ├─ floop.upload.json
+      ├─ floop.comments.json
+      └─ ...uploadable files...
+```
+
+`.floop/floop.env` contains secrets. floop-client warns through docs and command
+copy, but it does not create or edit `.floop/.gitignore`; ignore policy belongs
+to the host repository.
+
+Legacy workspaces under `.floop/projects/<project>/versions/<version>/` are
+readable for compatibility. floop-client does not move or delete legacy files
+automatically.
+
+## Commands
+
+### Workspace
+
+```bash
+floop init
+floop preview
+```
+
+### Projects
+
+```bash
+floop projects
+floop projects create <project>
+floop projects use <project>
+```
+
+### Versions
+
+```bash
+floop versions --project <project>
+floop versions create <version> --project <project> --artifact-type <type> --entrypoint index.html
+floop versions use <version> --project <project>
+```
+
+When a project and version are selected, commands that support defaults can use
+the selected values.
+
+### Server
+
+```bash
+floop review set --project <project>
+floop review upload --project <project> --version <version> --json-output
+floop comments --project <project> --version <local-version> --version-id <server-version-id> --json-output
+floop resolve <comment-id> --project <project> --version-id <server-version-id> --status resolved
+```
+
+## Responsibility Boundary
+
+| floop-client owns | Other tools or users own |
+|---|---|
+| `.floop/` workspace | Source files |
+| `projects.csv` project/version selection | File generation |
+| Server project binding | File validation |
+| Version upload | Build systems |
+| Server comments cache | Artifact internals |
+| Comment status updates | Content changes |
+
+## Supported Agents
+
+| Agent | Command |
+|-------|---------|
+| GitHub Copilot | `floop enable copilot` |
+| Cursor | `floop enable cursor` |
+| Claude Code | `floop enable claude` |
+| Trae IDE | `floop enable trae` |
+| Qwen Code | `floop enable qwen-code` |
+| OpenCode | `floop enable opencode` |
+| OpenClaw | `floop enable openclaw` |
+
+## For Contributors
+
+Run the full test gate:
+
+```bash
+PYTHONPATH=src python3 -m pytest --cov=floop --cov-report=term-missing --cov-fail-under=100
+```

{floop-1.2.0 → floop-2.0.1}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "floop"
 dynamic = ["version"]
-description = "AI-native prototype quality toolkit — Agent Skill + review workflow CLI"
+description = "Project/version review loop CLI and agent skill for AI artifacts"
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.10"

floop-2.0.1/src/floop/__init__.py

@@ -0,0 +1,14 @@
+"""floop-client package metadata."""
+
+from importlib.metadata import PackageNotFoundError, version
+from pathlib import Path
+
+try:
+    __version__ = version("floop")
+except PackageNotFoundError:  # pragma: no cover - source tree fallback depends on install mode.
+    try:
+        from setuptools_scm import get_version
+
+        __version__ = get_version(root=Path(__file__).resolve().parents[2])
+    except Exception:
+        __version__ = "0+unknown"

{floop-1.2.0 → floop-2.0.1}/src/floop/adapters.py

@@ -7,6 +7,7 @@ configuration format and directory structure.
 from __future__ import annotations
 
 import os
+import shutil
 from pathlib import Path
 from typing import Protocol
 
@@ -15,6 +16,9 @@ import click
 from floop.skills import INSTRUCTION, SKILLS
 
 
+LEGACY_SKILL_NAMES = ("floop-feedback", "floop-prototype", "floop-review")
+
+
 class AgentAdapter(Protocol):
     """Interface for agent platform adapters."""
 
@@ -42,8 +46,7 @@ class CopilotAdapter:
         instr_path = instr_dir / "floop.instructions.md"
         instr_path.write_text(
             "---\n"
-            "description: 'This project uses floop for prototype development. "
-            "Follow the floop workflow for design tokens, sitemap, components, and page generation.'\n"
+            "description: 'This project uses floop for projects, versions, uploads, and server comments.'\n"
             "applyTo: '**'\n"
             "---\n\n"
             + INSTRUCTION,
@@ -53,6 +56,7 @@ class CopilotAdapter:
 
         # Write skill files
         skills_dir = project_dir / ".github" / "skills"
+        _remove_legacy_skill_dirs(skills_dir)
 
         for skill in SKILLS.values():
             skill_dir = skills_dir / skill["name"]
@@ -86,12 +90,13 @@ class CursorAdapter:
         created: list[Path] = []
         rules_dir = project_dir / ".cursor" / "rules"
         rules_dir.mkdir(parents=True, exist_ok=True)
+        _remove_legacy_skill_files(rules_dir, ".mdc")
 
         # Write always-on instruction rule
         instr_path = rules_dir / "floop.mdc"
         instr_path.write_text(
             '---\n'
-            'description: "floop prototype workflow — always-on context"\n'
+            'description: "floop project/version upload workflow — always-on context"\n'
             'globs: \n'
             'alwaysApply: true\n'
             '---\n\n'
@@ -135,6 +140,7 @@ class ClaudeAdapter:
 
         # Write individual skill files
         skills_dir = project_dir / ".claude" / "skills"
+        _remove_legacy_skill_dirs(skills_dir)
         for skill in SKILLS.values():
             skill_dir = skills_dir / skill["name"]
             skill_dir.mkdir(parents=True, exist_ok=True)
@@ -180,7 +186,7 @@ class ClaudeAdapter:
 
     @staticmethod
     def _render_claude_md() -> str:
-        lines = ["<!-- floop:skills -->", "## floop Skills\n"]
+        lines = ["<!-- floop:skills -->", "## floop Skill\n"]
         for skill in SKILLS.values():
             lines.append(f'- **{skill["name"]}**: {skill["description"]}')
             lines.append(
@@ -207,7 +213,7 @@ class TraeAdapter:
 
     @staticmethod
     def _render() -> str:
-        lines = ["# floop Workflow Rules\n", INSTRUCTION, "\n## floop Skills\n"]
+        lines = ["# floop Workflow Rules\n", INSTRUCTION, "\n## floop Skill\n"]
         for skill in SKILLS.values():
             lines.append(f'### {skill["name"]}\n')
             lines.append(skill["content"])
@@ -231,6 +237,7 @@ class _AgentsMdAdapter:
 
         if self._skills_subdir:
             skills_dir = project_dir / f".{self._skills_subdir}" / "skills"
+            _remove_legacy_skill_dirs(skills_dir)
             for skill in SKILLS.values():
                 skill_dir = skills_dir / skill["name"]
                 skill_dir.mkdir(parents=True, exist_ok=True)
@@ -279,7 +286,7 @@ class _AgentsMdAdapter:
                 lines.append(f'- **{skill["name"]}**: {skill["description"]}')
                 lines.append(
                     f'  - See `.{self._skills_subdir}/skills/'
-                    f'{skill["name"]}/SKILL.md` for full workflow'
+                    f'{skill["name"]}/SKILL.md` for full rules'
                 )
         lines.append("\n<!-- /floop:skills -->")
         return "\n".join(lines) + "\n"
@@ -318,3 +325,17 @@ ADAPTERS: dict[str, type[AgentAdapter]] = {
 }
 
 SUPPORTED_AGENTS = list(ADAPTERS.keys())
+
+
+def _remove_legacy_skill_dirs(skills_dir: Path) -> None:
+    for name in LEGACY_SKILL_NAMES:
+        path = skills_dir / name
+        if path.exists():
+            shutil.rmtree(path)
+
+
+def _remove_legacy_skill_files(rules_dir: Path, suffix: str) -> None:
+    for name in LEGACY_SKILL_NAMES:
+        path = rules_dir / f"{name}{suffix}"
+        if path.exists():
+            path.unlink()