streamlit-coco 0.1.0__tar.gz

streamlit_coco-0.1.0/.gitignore

@@ -0,0 +1,20 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+dist/
+*.egg-info/
+.DS_Store
+*.tmp
+tmp/
+
+# Secrets & credentials
+.env
+*.secret
+*.key
+client_*.yaml
+
+# Streamlit agent skills (environment-specific symlinks)
+.agents/skills/developing-with-streamlit
+.claude/skills/developing-with-streamlit

streamlit_coco-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11

streamlit_coco-0.1.0/AGENTS.md

@@ -0,0 +1,43 @@
+# AGENTS.md — streamlit-coco
+
+Guidance for coding agents working in this repository.
+
+## Product
+
+Streamlit library + optional CCv2 component for Snowflake CoCo (Cortex Code Agent SDK). Preferred UX: `panel()` + app-owned `chat_input_bar` / `st.chat_input`.
+
+Canonical SDK docs: https://docs.snowflake.com/en/user-guide/cortex-code-agent-sdk/cortex-code-agent-sdk  
+Pinned rule: `.cursor/rules/coco-sdk-docs.mdc`
+
+## Layout
+
+- `streamlit_coco/` — library (`ui`, `session`, `permissions`, `tool_*`, `bootstrap`, …)
+- `examples/` — chat, approval, structured, headless demos
+- `doc/prd.md`, `doc/api.md`, `doc/roadmap.md`, `doc/features/` — product + API + DSP N1 feature docs/checklists
+- `doc-dev/` — **dev-only** docs (never synced to public `streamlit-coco`)
+- `doc/deployment/publish.md` — dual-repo sync + tag → PyPI (`streamlit-coco`)
+- `CHANGELOG.md` — shipped history (not the roadmap)
+
+**Repos:** develop in `DevoteamSP/streamlit-coco-dev`; publish from `lletourmy/streamlit-coco` (`make sync-release`, then tag `v*`) until DevoteamSP is PyPI-validated.
+
+## Commands
+
+```bash
+make install   # uv sync --extra dev
+make check     # ruff + pytest
+make audit     # pip-audit
+make chat      # Streamlit demo
+```
+
+## Conventions
+
+- Do not default-show raw JSON tool payloads; use meaningful compact tool expanders (`doc/features/tools-display/SPEC.md`).
+- Approval buttons left→right: Approve once · Always allow · Deny.
+- AskUserQuestion / ExitPlanMode always go through pending HITL; never “Always allow”.
+- Update `CHANGELOG.md` `[Unreleased]` for user-visible changes; update feature checklists when UX changes.
+- Prefer small, focused diffs; no drive-by refactors.
+
+## Testing
+
+- Unit/smoke: `tests/`
+- Manual UI: `doc/features/*/test-checklist.md` before release

streamlit_coco-0.1.0/CHANGELOG.md

@@ -0,0 +1,141 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+Versioning: date-based (`YYYY-MM-DD`) until v1.0.0 is cut, then semantic versioning.
+Package version in `pyproject.toml` is `0.1.0` (first PyPI release).
+
+Living plan (what’s next): [`doc/roadmap.md`](doc/roadmap.md).
+
+---
+
+## [Unreleased]
+
+## [0.1.0] — 2026-08-06
+
+First PyPI release of `streamlit-coco` (alpha). Published from temporary Trusted Publisher on [`lletourmy/streamlit-coco`](https://github.com/lletourmy/streamlit-coco).
+
+### Changed
+- **Temporary PyPI release repo** — `make sync-release` / Trusted Publisher gate target [`lletourmy/streamlit-coco`](https://github.com/lletourmy/streamlit-coco) until DevoteamSP is validated on PyPI ([`doc/deployment/publish.md`](doc/deployment/publish.md))
+- **Dependabot** — bump transitive `cryptography` to `50.0.0` (and `pyopenssl` to `26.4.0`); `GitPython` already at `3.1.58`
+
+### Added
+
+#### Examples
+- **Product Backlog Desk** — multipage demo (`examples/backlog_desk/`, `make backlog`): Board / Epic / Ticket / Release with a right-rail Copilot (skills + `panel()`) over local JSON/Markdown (no SQL); navigator-style theme; Edit/Write gated by approvals
+
+### Changed
+- **Compact tool cards** — transcript tools render as collapsed expanders (label: family · status · meta); auto-open on error; CCv2 `<details>` parity ([`doc/features/tools-display/SPEC.md`](doc/features/tools-display/SPEC.md))
+
+#### Dual-repo publish
+- Public release repo (temporary) [`lletourmy/streamlit-coco`](https://github.com/lletourmy/streamlit-coco); `make sync-release` / `scripts/sync_release.sh`; guide [`doc/deployment/publish.md`](doc/deployment/publish.md)
+- Apache-2.0 `LICENSE`; PyPI Trusted Publisher gate in `release.yml` (`github.repository == lletourmy/streamlit-coco` only)
+
+#### Phase 3 — HITL, headless, render flexibility
+- **Headless multi-turn** — `CocoSession.stream()` and `await session.run(prompt)`; `execute_plan()` / `set_permission_mode()`; extended `examples/headless_pipeline.py`
+- **Streamlit-free core imports** — lazy `__getattr__` for UI exports so headless scripts never load Streamlit; smoke test + example assert
+- **Plan mode Execute CTA** — native `render_plan_banner()` in `panel()`; CCv2 banner **Execute plan** trigger
+- **Edit/Write unified diff** — approval + transcript previews via `difflib` (`tool_extract.unified_diff`); Before/After fallback when empty
+- **Pluggable text renderer** — `text_renderer=` on `panel()`, `render_transcript()`, `render_output_field()` (`markdown` / `write` / `text` / … or callable); feature docs under `doc/features/text-renderer/`
+- **App-owned `request_input`** — form + optional multi-field `schema=` (AskUserQuestion remains the in-turn CoCo channel)
+- Headless checklist re-signed (2026-07-27): `query()` + `run()` + `stream()` live path; no Streamlit import
+
+#### Earlier unreleased (pre–Phase 3 on this branch)
+- **Clear tool “running” captions when done** — parse SDK `UserMessage` / NDJSON `user` tool results; finalize leftover `running` tools on turn `result`
+- **CCv2 skill hygiene** — JS cleanup via AbortController; pause `run_every` on pending approval; drop `provide_input`; `isolate_styles=True`; CSS via `--st-yellow-*` / `--st-red-*` / radius tokens
+- **API reference** — [`doc/api.md`](doc/api.md)
+- **Deployment docs (local)** — [`doc/deployment/local.md`](doc/deployment/local.md)
+- **Typed error hierarchy** — `streamlit_coco.errors`; `require_environment()`
+- **NDJSON fixture corpus** — `tests/fixtures/ndjson/` + `tests/test_ndjson_fixtures.py`
+- Feature docs pack + checklist sign-offs (panel, approvals, tools-display, structured-output, chat-ccv2, headless)
+- GitHub CI/CD (ci / security / release + optional PyPI publish on `v*` tags); `make publish`; hatch sdist excludes for agent/IDE dirs
+- Smoke tests: CCv2 register-once; core import does not load Streamlit
+
+### Changed
+- [`doc/prd.md`](doc/prd.md) reconciled with shipped Phase 3; FR-S* / FR-ST* status; FR-S3 superseded by tools-display SPEC (not “collapse cards”)
+- [`doc/roadmap.md`](doc/roadmap.md) — Later: FR-S2, FR-S7, FR-ST4 truncation, Vite/CCv2, e2e; Next: Docker/SPCS docs; PyPI `0.1.0` via temporary Trusted Publisher
+- `doc-dev/` — development-only docs tree; excluded from `make sync-release` and sdist (never published to `streamlit-coco`)
+- Package / README / identity URLs point at the public [`streamlit-coco`](https://github.com/lletourmy/streamlit-coco) repo; development continues on [`streamlit-coco-dev`](https://github.com/DevoteamSP/streamlit-coco-dev)
+- GitHub repository renamed to [`DevoteamSP/streamlit-coco-dev`](https://github.com/DevoteamSP/streamlit-coco-dev) (package name remains `streamlit-coco`)
+- Examples `structured_output.py` / `approval_gate.py`: `get_or_create_session` + eager `start()` for CCv2 transcript across reruns
+- Chat demo sidebar: compact status badges; Settings popover; test prompts behind a toggle
+- CCv2 `chat()` registration cached (`@lru_cache`) so `st.components.v2.component` runs once per process
+- Headless example: separate event loops for `query()` vs `CocoSession` to avoid SDK cancel-scope teardown issues
+
+### Fixed
+- Grep / Glob completed cards: compact summary instead of dumping full result bodies
+- AskUserQuestion: free-form / “Other…” options always last in radio / multiselect
+- Security workflow: free Gitleaks CLI instead of `gitleaks-action@v2` (org license)
+
+---
+
+## [2026-07-24]
+
+### Added
+- **Tools display & user interactions** — full spec + implementation ([`doc/features/tools-display/SPEC.md`](doc/features/tools-display/SPEC.md))
+  - Meaningful bordered tool cards (no default JSON expanders) for Glob, Grep, Read, Write, Edit, Bash, SQL / `sql_execute`, AskUserQuestion, ExitPlanMode, and generic / MCP tools
+  - `streamlit_coco.tool_names`, `tool_extract`, `tool_cards` dispatch; CCv2 frontend parity
+  - AskUserQuestion UI: radio / multiselect, **Other…** free-text, Submit / Cancel; always routed through `can_use_tool`
+  - SQL card: query code block + dataframe / text results; SQL preview on approval
+  - ExitPlanMode: Approve plan / Reject (with optional feedback); never “Always allow”
+  - CoCo debug mode (`STREAMLIT_COCO_DEBUG` / `COCO_DEBUG` / `st.session_state["coco_debug"]`) for collapsed **Raw tool payload**
+- Feature checklist + `display_*` test prompt pack ([`doc/features/tools-display/test-checklist.md`](doc/features/tools-display/test-checklist.md), [`examples/testdata/prompts.json`](examples/testdata/prompts.json) v2 — 50+ prompts)
+- Chat demo: Plan mode toggle, debug checkbox, test-prompt runner by category
+
+### Changed
+- Approval button order (left → right): **Approve once** · **Always allow** · **Deny** (Deny rightmost); AskUser Submit · Cancel; plan Approve · Reject
+- Tool approvals show family-specific previews (path, content, Before/After, command, SQL) instead of raw JSON by default
+
+---
+
+## [2026-07-23]
+
+### Added
+- `streamlit_coco.bootstrap` — `check_environment` / start gate helpers, `get_or_create_session`, `chat_input_bar`, `reset_session`, `stop_session`
+- `streamlit_coco.diagnostics` — `CocoEnvironment` probe (CLI, SDK, Snowflake config) without starting an agent
+- Session readiness lifecycle — `CONNECTING` → `READY` / `ERROR`, `ensure_ready()`, init metadata capture
+- Soft status chrome in `panel()` — Starting / Thinking / tool activity / Needs approval without remount flicker
+- DSP N1 feature test checklists under `doc/features/*/test-checklist.md`
+- `doc/roadmap.md` — Now / Next / Soon / Later plan aligned with `doc/PRD.md`
+- `Makefile` targets for install, test, lint, format, check, build, and example apps
+- Cursor rule pinning Cortex Code Agent SDK docs as source of truth
+
+### Changed
+- Preferred app pattern documented as `panel()` + `chat_input_bar` / `st.chat_input` (legacy `chat()` retained)
+- `doc/PRD.md` and `README.md` synced to the implemented `panel()`-first API and package layout
+- Example `examples/chat_app.py` simplified around bootstrap helpers
+
+### Fixed
+- Avoid double-display of Snowflake connections TOML path in the environment / start gate UI
+- `chat_input_bar` — graceful fallback when Streamlit lacks `submit_mode` (< 1.59)
+- Session status skeleton — fallback placeholder when `st.skeleton` is unavailable (< 1.59)
+
+---
+
+## [2026-07-22] — Alpha baseline (shipped)
+
+Core library and preferred Streamlit UX first landed:
+
+- [x] Pip-installable package + `CocoOptions` / `CocoSession` / `query()`
+- [x] Native UI: `panel()` + app-owned input (`chat_input_bar` / `send_prompt`)
+- [x] Streaming transcript, tool cards, Stop, fragment polling
+- [x] Human-in-the-loop approvals (`require_approval_for`, Deny / Approve once / Always)
+- [x] Structured output (inline JSON or `on_structured_output`)
+- [x] Legacy CCv2 `chat()` (still supported)
+- [x] Examples: chat, approval gate, structured output, headless pipeline
+
+### Added (detail)
+- Initial `streamlit-coco` package (`0.1.0` alpha): Python API + Streamlit embedding for Snowflake CoCo
+- Normalized `CocoEvent` model and unit tests (`tests/test_core.py`)
+- Legacy CCv2 `chat()` component with static frontend assets under `streamlit_coco/frontend/`
+- `doc/PRD.md` and `README.md`
+
+---
+
+<!-- Notes:
+- Link PRs/issues when available: (#42) or (DevoteamSP/streamlit-coco-dev#42)
+- One entry per user-visible change
+- Security fixes always under "Security", never under "Fixed"
+- Update [Unreleased] as you go; rename to a date (or semver after v1.0.0) on release
+-->

streamlit_coco-0.1.0/ID.md

@@ -0,0 +1,64 @@
+# Asset Identity Sheet
+
+| Field | Value |
+|-------|-------|
+| **Name** | `streamlit-coco` |
+| **Display name** | streamlit-coco |
+| **Snow Builders level** | N0 (working toward N1) |
+| **Status** | active |
+| **Asset Owner** |  Laurent Letourmy |
+| **Contributors** | DevoteamSP / streamlit-coco contributors |
+| **Created** | 2026-07 |
+| **Last updated** | 2026-07 |
+| **Confidentiality** | Public |
+
+---
+
+## Domain & Technology
+
+**Domain**: ai_ml / streamlit / analytics
+
+**Snowflake features**: cortex (CoCo / Cortex Code Agent SDK), Streamlit
+
+**Other tech**: Python, uv, hatchling, pytest, ruff
+
+**Industry**: cross_industry
+
+---
+
+## Maturity Justification
+
+**Current level**: N0 → closing alpha toward N1
+
+- Clients where used: 0 (alpha)
+- Consultants trained: —
+- Demo available: yes (`make chat`, examples/)
+- Snowflake Alliance pre-alignment: —
+
+**Next milestone**: N1 — conditions needed:
+
+- [x] Feature golden-path checklists under `doc/features/`
+- [x] CI + PR template
+- [ ] Fill owner / KPIs on this sheet
+- [ ] Run and sign off UI checklists on a live CoCo + Snowflake connection
+- [ ] Security threat model + audit pack (`doc/security/`)
+- [ ] Marketing one-pager (`doc/marketing/`)
+
+---
+
+## Repository
+
+| Role | URL |
+| --- | --- |
+| **Public / PyPI source** | [github.com/lletourmy/streamlit-coco](https://github.com/lletourmy/streamlit-coco) *(temporary until DevoteamSP is PyPI-validated)* |
+| **Development** | [github.com/DevoteamSP/streamlit-coco-dev](https://github.com/DevoteamSP/streamlit-coco-dev) |
+
+Publish procedure: [`doc/deployment/publish.md`](doc/deployment/publish.md)
+
+---
+
+## Security
+
+- IP review done: no
+- Threat model: not yet (`doc/security/` TBD)
+- Last security scan: GitHub Actions Security workflow (Gitleaks CLI, CodeQL, pip-audit)

streamlit_coco-0.1.0/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor 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
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You 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 the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its 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. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 DevoteamSP / streamlit-coco contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

streamlit_coco-0.1.0/Makefile

@@ -0,0 +1,73 @@
+# streamlit-coco — local development
+UV       ?= uv
+PYTHON   ?= $(UV) run
+STREAMLIT = $(PYTHON) streamlit run
+EXAMPLE  ?= examples/chat_app.py
+
+.DEFAULT_GOAL := help
+
+.PHONY: help install sync test lint format check audit \
+	run chat approval structured headless backlog \
+	build publish sync-release clean
+
+# Public release clone (override: make sync-release RELEASE_REPO=/path/to/streamlit-coco)
+# Temporary: personal repo until DevoteamSP is validated on PyPI (see doc/deployment/publish.md).
+RELEASE_REPO ?= $(abspath $(CURDIR)/../streamlit-coco)
+RELEASE_REMOTE ?= https://github.com/lletourmy/streamlit-coco.git
+
+help: ## Show this help
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | \
+		awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-14s\033[0m %s\n", $$1, $$2}'
+
+install: ## Install package + [dev] extras (editable via uv)
+	$(UV) sync --extra dev
+
+sync: install ## Alias for install
+
+test: ## Run pytest
+	$(PYTHON) pytest tests/ -v
+
+lint: ## Lint with ruff
+	$(PYTHON) ruff check .
+
+format: ## Format with ruff
+	$(PYTHON) ruff format .
+	$(PYTHON) ruff check --fix .
+
+audit: ## Dependency vulnerability scan (pip-audit)
+	$(PYTHON) pip-audit
+
+check: lint test ## Lint then test
+
+run: ## Run EXAMPLE (default: examples/chat_app.py)
+	$(STREAMLIT) $(EXAMPLE)
+
+chat: ## Run examples/chat_app.py
+	$(STREAMLIT) examples/chat_app.py
+
+approval: ## Run examples/approval_gate.py
+	$(STREAMLIT) examples/approval_gate.py
+
+structured: ## Run examples/structured_output.py
+	$(STREAMLIT) examples/structured_output.py
+
+headless: ## Run examples/headless_pipeline.py
+	$(PYTHON) examples/headless_pipeline.py
+
+backlog: ## Run Product Backlog Desk demo (examples/backlog_desk)
+	cd examples/backlog_desk && $(UV) run --project ../.. streamlit run streamlit_app.py
+
+build: ## Build sdist + wheel into dist/
+	$(UV) build
+
+publish: build ## Upload dist/ to PyPI (prefer tagging streamlit-coco; see doc/deployment/publish.md)
+	$(UV) publish
+
+sync-release: ## Sync release tree → ../streamlit-coco (DRY_RUN=1 / COMMIT=1 / PUSH=1)
+	RELEASE_REPO="$(RELEASE_REPO)" RELEASE_REMOTE="$(RELEASE_REMOTE)" \
+		DRY_RUN="$(DRY_RUN)" COMMIT="$(COMMIT)" PUSH="$(PUSH)" MESSAGE="$(MESSAGE)" \
+		bash scripts/sync_release.sh
+
+clean: ## Remove caches and build artifacts
+	rm -rf dist/ build/ *.egg-info .pytest_cache .ruff_cache
+	find . -type d -name __pycache__ -not -path './.venv/*' -exec rm -rf {} +