Release 0.1.6

Author: lletourmy

.gitignore

@@ -21,3 +21,7 @@ client_*.yaml
 
 # Local demo workspaces (uploaded files)
 examples/workspaces/
+
+# tableau_to_semantic generated artifacts
+examples/tableau_to_semantic/out/
+examples/tableau_to_semantic/uv.lock

AGENTS.md

@@ -4,15 +4,16 @@ 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`.
+Streamlit library + optional CCv2 component for Snowflake CoCo (Cortex Code Agent SDK). Preferred UX: `panel()` + app-owned `chat_input_bar` / `st.chat_input`. Multipage / exec demos wrap that in `copilot_rail()`.
 
 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
+- `streamlit_coco/` — library (`ui`, `rail`, `session`, `permissions`, `tool_*`, `bootstrap`, …)
+- `examples/` — chat, approval, structured, headless, backlog desk, Tableau → Semantic
+- `apps/` — **dev-only** full applications (never synced to public `streamlit-coco`)
 - `doc/prd.md`, `doc/api.md`, `doc/roadmap.md`, `doc/features/` — product + API + DSP N1 feature docs/checklists
 - `doc/releases/X.Y.Z/` — public release kit (checklist, screenshots)
 - `doc-dev/` — **dev-only** docs (never synced to public `streamlit-coco`); includes `doc-dev/releases/X.Y.Z/` outreach (LinkedIn, Medium, community)
@@ -30,8 +31,12 @@ make e2e       # Playwright UX vs examples/e2e_ux_harness.py
 make audit     # pip-audit
 make test-all  # check + e2e + audit
 make chat      # Streamlit demo
+make tableau-semantic  # Tableau → Semantic example (copilot rail)
+make adoption-stats  # daily PyPI + GitHub traffic → doc-dev/metrics/
 ```
 
+Adoption KPIs: [`doc-dev/metrics/README.md`](doc-dev/metrics/README.md). Refresh `doc/roadmap.md` Currents only when asked (`make adoption-stats UPDATE_ROADMAP=1`).
+
 Full test process: [`doc/testing.md`](doc/testing.md).
 
 ## Conventions

CHANGELOG.md

@@ -12,8 +12,23 @@ Living plan (what’s next): [`doc/roadmap.md`](doc/roadmap.md).
 
 ## [Unreleased]
 
+## [0.1.6] — 2026-08-13
+
+Alpha follow-up: a reusable Copilot rail, consultant training pack, and a Tableau → Semantic example that uses the rail as a product copilot (not a chat window).
+
+### Added
+- **Copilot rail** (`copilot_rail()`, `transcript_view_pills()`) — generic right-rail Copilot (connection, queued jobs, transcript pills: last messages / first 200 characters). `panel()` / `render_transcript()` gain `preview_chars=`. Feature: [`doc/features/copilot-rail/`](doc/features/copilot-rail/)
+- **Example: Tableau → Semantic** — multipage demo (`examples/tableau_to_semantic`, `make tableau-semantic`) that extracts estate/KPI/access drift from MIT Tableau Server workbooks, arbitrates with `request_input`, Writes a semantic view + row access policy, and generates a Streamlit consumer (**Build with python** or **Build with CoCo** with **Save Brief** → generate; brief reloads from `BRIEF.md`) with **disconnected** (no warehouse) and live `SEMANTIC_VIEW(...)` modes. **Preview** shares the Copilot right-rail slot (inline studio or run-on-the-fly at `:8511`); the split uses `streamlit_extras.resizable_columns`. Screens 2–5 restore `out/*.json` when the session reopens.
+- **Training pack** — consultant enablement under [`doc/training/`](doc/training/) (overview, setup, hands-on lab, demo script, quiz, enablement deck) plus workshop [`W01`](doc/methodology/workshops/w01-setup-architecture-first-app.md)
+
 ### Changed
-- README: document `make cwd-upload`, `make e2e-install` / `make e2e`, and `make test-all`
+- README: document `make cwd-upload`, `make e2e-install` / `make e2e`, `make test-all`, and `make tableau-semantic`
+- **Copilot rail** — transcript pills sit beside Connection (no **Transcript** label / “Showing …” caption); changing them fragment-reruns Copilot only. Long cwd paths in the status caption use `...` in the middle (100-character cap). **Working · thinking…** is a badge on that same row instead of a tall status card. **Cancel job** sits on the title row beside Close and hides when the CoCo turn finishes (`on_job_finished`).
+
+### Fixed
+- **Structured output** — strip `$schema` / `$id` before passing JSON Schema to the CoCo SDK (avoids `no schema with key or ref "https://json-schema.org/draft/2020-12/schema"` when contract files include a draft URI)
+- Replace deprecated `use_container_width` with `width="stretch"` (Streamlit ≥1.57)
+- **Example: Tableau → Semantic** — Generate selectors (step, how-to-build, dashboards, preview mode) keep their values when Copilot opens; a saved `BRIEF.md` is loaded into the CoCo editor from disk; multiple `.md` files are switched with pills.
 
 ## [0.1.5] — 2026-08-09
 

ID.md

@@ -9,7 +9,7 @@
 | **Asset Owner** |  Laurent Letourmy |
 | **Contributors** | DevoteamSP / streamlit-coco contributors |
 | **Created** | 2026-07 |
-| **Last updated** | 2026-07 |
+| **Last updated** | 2026-08-13 |
 | **Confidentiality** | Public |
 
 ---
@@ -32,17 +32,18 @@
 
 - Clients where used: 0 (alpha)
 - Consultants trained: —
-- Demo available: yes (`make chat`, examples/)
+- Demo available: yes (`make chat`, `make backlog`, `make tableau-semantic`, `doc/training/`)
 - Snowflake Alliance pre-alignment: —
 
 **Next milestone**: N1 — conditions needed:
 
 - [x] Feature golden-path checklists under `doc/features/`
 - [x] CI + PR template
+- [x] Consultant enablement pack (`doc/training/`) + workshop W01 (`0.1.6`)
 - [ ] 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-dev/marketing/`)
+- [x] Marketing one-pager (`doc/marketing/one-pager.md`) — refreshed for `0.1.6`
 
 ---
 
@@ -60,5 +61,5 @@ Publish procedure: [`doc/deployment/publish.md`](doc/deployment/publish.md)
 ## Security
 
 - IP review done: no
-- Threat model: not yet (`doc/security/` TBD)
+- Threat model: started (`doc/security/threat-model.md`)
 - Last security scan: GitHub Actions Security workflow (Gitleaks CLI, CodeQL, pip-audit)

Makefile

@@ -10,7 +10,7 @@ EXAMPLE  ?= examples/chat_app.py
 
 .PHONY: help install sync test lint format check audit e2e-install e2e test-all \
 	run chat approval structured headless backlog cwd-upload e2e-harness \
-	build publish sync-release clean
+	build publish sync-release clean adoption-stats
 
 # 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).
@@ -71,9 +71,24 @@ backlog: ## Run Product Backlog Desk demo (examples/backlog_desk)
 cwd-upload: ## Run examples/cwd_upload_chat.py (upload into cwd)
 	$(STREAMLIT) examples/cwd_upload_chat.py
 
+tableau-semantic: ## Run Tableau → Semantic (repo streamlit-coco, not PyPI)
+	cd examples/tableau_to_semantic && $(UV) run --project ../.. --extra dev --with 'streamlit-extras>=1.3.0' python -m streamlit run app.py
+
 e2e-harness: ## Run CoCo-free UX harness used by Playwright
 	$(STREAMLIT) examples/e2e_ux_harness.py
 
+# Adoption metrics (PyPI + GitHub traffic). FORCE=1 overwrites today; UPDATE_ROADMAP=1 refreshes Current KPIs.
+ADOPTION_STATS_FLAGS =
+ifneq ($(FORCE),)
+ADOPTION_STATS_FLAGS += --force
+endif
+ifneq ($(UPDATE_ROADMAP),)
+ADOPTION_STATS_FLAGS += --update-roadmap
+endif
+
+adoption-stats: ## Collect PyPI + GitHub traffic into doc-dev/metrics/
+	$(PYTHON) python scripts/collect_adoption_stats.py $(ADOPTION_STATS_FLAGS)
+
 build: ## Build sdist + wheel into dist/
 	$(UV) build
 

README.md

@@ -1,15 +1,15 @@
 # streamlit-coco
 
-**Bring Snowflake CoCo into Streamlit** — streaming agent UI, tool cards you can actually read, and approval gates that fit governed data apps.
+**Built (with love) by Devoteam Snowflake Partner, brings Snowflake CoCo into Streamlit** — streaming agent UI, tool cards you can actually read, and approval gates that fit governed data apps.
 
 [![CI](https://github.com/lletourmy/streamlit-coco/actions/workflows/ci.yml/badge.svg)](https://github.com/lletourmy/streamlit-coco/actions/workflows/ci.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-You own the page. CoCo owns the session. `panel()` streams the transcript; your app keeps `st.chat_input`, metrics, and forms. Approvals pause Write / Edit / Bash / SQL until someone clicks **Approve once**, **Always allow**, or **Deny**.
+You own the page. CoCo owns the session. `panel()` streams the transcript; `copilot_rail()` wraps that panel as a right-rail Copilot for multipage apps. Your app keeps `st.chat_input`, metrics, and forms. Approvals pause Write / Edit / Bash / SQL until someone clicks **Approve once**, **Always allow**, or **Deny**.
 
 ![CoCo for Streamlit — streaming transcript with a Glob tool card](doc/screenshot.png)
 
-> Alpha `0.1.5` — API may still move. Star / watch the repo if you plan to ship on it.
+> Alpha `0.1.6` — API may still move. Star / watch the repo if you plan to ship on it.
 
 **Repo:** [github.com/lletourmy/streamlit-coco](https://github.com/lletourmy/streamlit-coco) *(temporary PyPI source)* · **Dev:** [streamlit-coco-dev](https://github.com/DevoteamSP/streamlit-coco-dev)  
 **SDK docs:** [Cortex Code Agent SDK](https://docs.snowflake.com/en/user-guide/cortex-code-agent-sdk/cortex-code-agent-sdk)
@@ -98,10 +98,12 @@ make approval      # legacy CCv2 chat
 make structured    # custom structured-output panel
 make headless      # asyncio query() pipeline
 make backlog       # Product Backlog Desk (multipage business demo)
+make tableau-semantic  # Tableau workbooks → semantic view + RAP (screens 1–6)
 ```
 
 Exploratory prompts: [`examples/testdata/prompts.json`](examples/testdata/prompts.json).  
 Backlog desk: [`examples/backlog_desk/README.md`](examples/backlog_desk/README.md).  
+Tableau → Semantic: [`examples/tableau_to_semantic/README.md`](examples/tableau_to_semantic/README.md).  
 File upload: [`doc/features/file-upload/file-upload.md`](doc/features/file-upload/file-upload.md).
 
 ---
@@ -141,6 +143,7 @@ asyncio.run(run())
 | Capability | Entry points |
 | --- | --- |
 | Native panel + approvals | `panel()`, `chat_input_bar()`, `render_approvals()` |
+| Copilot rail (right-column Copilot) | `copilot_rail()`, `transcript_view_pills()` — [`doc/features/copilot-rail/`](doc/features/copilot-rail/) |
 | Tool cards & AskUser / plan UI | see [`doc/features/tools-display/`](doc/features/tools-display/) |
 | Session & options | `CocoSession`, `CocoOptions`, `get_or_create_session` |
 | Headless events | `query()` |
@@ -176,7 +179,7 @@ make help          # all targets
 CI runs lint, tests, and pip-audit on every PR to `main`. Full local gate: `make test-all` ([`doc/testing.md`](doc/testing.md)).  
 **Releases:** develop here (`streamlit-coco-dev`), sync + tag on [`lletourmy/streamlit-coco`](https://github.com/lletourmy/streamlit-coco) → PyPI ([guide](doc/deployment/publish.md)).
 
-**Docs:** [PRD](doc/prd.md) · [API](doc/api.md) · [Roadmap](doc/roadmap.md) · [Deployment](doc/deployment/) · [Changelog](CHANGELOG.md) · [AGENTS.md](AGENTS.md)
+**Docs:** [PRD](doc/prd.md) · [API](doc/api.md) · [Roadmap](doc/roadmap.md) · [Training](doc/training/training-overview.md) · [Deployment](doc/deployment/) · [Changelog](CHANGELOG.md) · [AGENTS.md](AGENTS.md)
 
 ---
 

doc/api.md

@@ -1,7 +1,7 @@
 # API reference — streamlit-coco
 
 Public surface exported from `import streamlit_coco as st_coco`.  
-Alpha `0.1.0` — signatures may still move; prefer this page over the PRD sketch.
+Alpha `0.1.6` — signatures may still move; prefer this page over the PRD sketch.
 
 **Related:** [README quickstart](../README.md) · [Local deployment](deployment/local.md) · [Feature docs](features/README.md) · [SDK docs](https://docs.snowflake.com/en/user-guide/cortex-code-agent-sdk/cortex-code-agent-sdk)
 
@@ -158,11 +158,38 @@ Native transcript / field output + approvals + Stop. App owns input.
 | `text_renderer` | `None` | `"markdown"` (default) / `"write"` / `"text"` / … or callable. Default markdown highlights fenced code blocks via `st.code` |
 | `show_copy` | `True` | Clipboard controls on assistant messages and tool cards |
 | `max_messages` | `None` | Transcript window size; **Load earlier** reveals older items |
+| `preview_chars` | `None` | Cap user/assistant text to the first N characters |
 | `on_structured_output` | `None` | `Callable[[dict, CocoChatResult], None]` |
 | `structured_output_container` | `None` | Container for structured render |
 
 Feature doc: [`features/panel/panel.md`](features/panel/panel.md).
 
+### `copilot_rail(session, *, title="Copilot", …) -> None`
+
+Right-rail Copilot: connection popover with transcript pills beside it, queued job,
+`panel()`, chat input. App-agnostic — callers own session lifecycle and job dicts.
+While CoCo is busy, **Working · thinking…** is a badge on the pills row (not a
+tall status card).
+
+| Param | Default | Notes |
+| --- | --- | --- |
+| `session` | — | `CocoSession` or `None` until connected |
+| `connected` | `True` | Whether Connect has been confirmed |
+| `connections` | `None` | Snowflake connection names for the popover |
+| `on_connect` / `on_disconnect` | `None` | Callbacks; omit to hide the popover |
+| `job` | `None` | `{prompt, label, status, expect_structured, …}` |
+| `on_job_sent` | `None` | Called after a queued prompt is `session.send`'d |
+| `on_job_finished` | `None` | Called when that turn ends (`COMPLETED` / `ERROR` / `CANCELLED`, or `READY` after a run) so the app can drop the job |
+| `show_copy` | `False` | Clipboard controls off for demo rails |
+| `show_transcript_filters` | `True` | Pills: **Last messages** · **First 200 characters** |
+
+### `transcript_view_pills(*, key=…, last_n=8, preview_chars=200) -> tuple[int \| None, int \| None]`
+
+Standalone pills for apps that call `panel()` directly. Returns `(max_messages, preview_chars)`.
+Label is collapsed by default (no **Transcript** heading).
+
+Feature doc: [`features/copilot-rail/copilot-rail.md`](features/copilot-rail/copilot-rail.md).
+
 ### `chat_input_bar(session, *, placeholder=…, connecting_placeholder=…, key=None, accept_file=False, …) -> str | None`
 
 `st.chat_input` wired to connect/run state; sends via `send_prompt` on submit. Disabled only after a failed boot (`ERROR` and not ready).
@@ -340,7 +367,7 @@ Tool card UX: [`features/tools-display/SPEC.md`](features/tools-display/SPEC.md)
 ## Package metadata
 
 ```python
-st_coco.__version__  # e.g. "0.1.0"
+st_coco.__version__  # e.g. "0.1.6"
 ```
 
 Private modules (`bridge`, `tool_cards`, `tool_extract`, …) are implementation details and are not part of the stable public surface.

doc/deployment/publish.md

@@ -50,9 +50,9 @@ cp -R doc-dev/releases/_template/. "doc-dev/releases/${VER}/"
 ```
 
 - Public checklist: [`doc/releases/`](../releases/README.md) → `doc/releases/X.Y.Z/CHECKLIST.md`  
-  (current: [`doc/releases/0.1.5/`](../releases/0.1.5/))
+  (current: [`doc/releases/0.1.6/`](../releases/0.1.6/))
 - Outreach (LinkedIn / Medium / community): [`doc-dev/releases/`](../../doc-dev/releases/README.md)  
-  (current: [`doc-dev/releases/0.1.5/`](../../doc-dev/releases/0.1.5/)) — **never synced** to the public repo
+  (current: [`doc-dev/releases/0.1.6/`](../../doc-dev/releases/0.1.6/)) — **never synced** to the public repo
 
 ```bash
 make test-all
@@ -88,7 +88,7 @@ Default target clone: `../streamlit-coco` (override with `RELEASE_REPO=`).
 Default remote: `https://github.com/lletourmy/streamlit-coco.git` (override with `RELEASE_REMOTE=`).
 
 Excluded from the public tree: `.cursor/`, `.agents/`, `.claude/`, `doc-dev/`,
-local caches, `dist/`, and this sync script.
+`apps/`, local caches, `dist/`, and this sync script.
 
 ### 3. Tag on **lletourmy/streamlit-coco** (PyPI publisher; not `-dev`)
 

doc/features/README.md

@@ -11,6 +11,7 @@ Package API (all public exports): [`../api.md`](../api.md).
 | Feature | Narrative | Checklist | Preferred prompts / app |
 | --- | --- | --- | --- |
 | Panel + chat input | [panel/panel.md](panel/panel.md) | [panel/test-checklist.md](panel/test-checklist.md) | `make chat`; `tools_auto`, `streaming` |
+| Copilot rail | [copilot-rail/copilot-rail.md](copilot-rail/copilot-rail.md) | [copilot-rail/test-checklist.md](copilot-rail/test-checklist.md) | `make tableau-semantic`; `copilot_rail()` |
 | Tool approvals | [approvals/approvals.md](approvals/approvals.md) | [approvals/test-checklist.md](approvals/test-checklist.md) | category `approval` |
 | Tools display + HITL | [tools-display/tools-display.md](tools-display/tools-display.md) ([SPEC](tools-display/SPEC.md)) | [tools-display/test-checklist.md](tools-display/test-checklist.md) | categories `display_*` |
 | Structured output | [structured-output/structured-output.md](structured-output/structured-output.md) | [structured-output/test-checklist.md](structured-output/test-checklist.md) | `make structured`; `structured-json` |
@@ -21,7 +22,7 @@ Package API (all public exports): [`../api.md`](../api.md).
 
 ## Suggested run order (release)
 
-1. **panel** → 2. **approvals** → 3. **tools-display** → 4. **structured-output** → 5. **headless** → 6. **text-renderer** → 7. **chat-ccv2**
+1. **panel** → 2. **copilot-rail** → 3. **approvals** → 4. **tools-display** → 5. **structured-output** → 6. **headless** → 7. **text-renderer** → 8. **chat-ccv2**
 
 Approval / plan button order (left → right): **Approve once** · **Always allow** · **Deny** (Deny rightmost). AskUser: **Submit** · **Cancel**. Plan: **Approve plan** · **Reject**.
 
@@ -39,4 +40,5 @@ Exploratory prompts: [`examples/testdata/`](../../examples/testdata/).
 | UI golden path — tools-display | **Pass (core)** (2026-07-27) | [`tools-display/test-checklist.md`](tools-display/test-checklist.md) — Glob/Grep/Read/Write/Edit live; SQL/AskUser/plan/debug deferred |
 | UI golden path — structured-output | **Pass (core)** (2026-07-27) | [`structured-output/test-checklist.md`](structured-output/test-checklist.md) — `make structured` + `output_schema` live |
 | UI golden path — chat-ccv2 | **Pass** (2026-07-27) | [`chat-ccv2/test-checklist.md`](chat-ccv2/test-checklist.md) — `make approval` live |
+| UI golden path — copilot-rail | **Pending** (`0.1.6`) | [`copilot-rail/test-checklist.md`](copilot-rail/test-checklist.md) — `make tableau-semantic` |