toga-ai 1.0.196 → 1.0.197

package/knowledge/standalone/apps/forward/INDEX.md

@@ -3,6 +3,6 @@
 | Doc | Summary | Files |
 |-----|---------|-------|
 | [Forwarder Architecture](architecture.md) | Forwarder is a tiny **standalone PHP application** that powers TOGA's short, branded redirect domains. | forward/forward.ini, forward/index.php, forward/.htaccess, forward/.platform/httpd/conf.d/rewritemap.conf, forward/.ebextensions/rewritemap.config, forward/design/index.php, forward/composer.json |
-| [Design Demo Admin Tool](features/design-demo-admin.md) | A standalone, dependency-free PHP tool served at `https://demo.togatech.com/design` that lets the **design team** publish self-contained "Claude Design" HTML ex | forward/design/index.php, forward/design/.config.example.php, forward/.gitignore, forward/.htaccess, forward/.ebextensions/php-uploads.config |
+| [Design Demo Admin Tool](features/design-demo-admin.md) | A standalone, dependency-free PHP tool served at `https://demo.togatech.com/design` that lets the **design team** publish self-contained "Claude Design" HTML ex | forward/design/index.php, forward/tabs.json, forward/design/.config.example.php, forward/.gitignore, forward/.htaccess, forward/.ebextensions/php-uploads.config |
 | [Encrypted-Link Handler](features/encrypted-link-handler.md) | A `index.php` feature in [Forwarder](../architecture.md) for redirect domains whose URL path carries an **encrypted token** that must be decoded before redirect | forward/index.php |
 | [Static Demo Hosting](features/static-demo-hosting.md) | A lightweight way to host self-contained static HTML pages (demos, exported designs, download landing pages) on the Forwarder app under a clean URL — e.g. | forward/.htaccess, forward/togadesk/index.html |

package/knowledge/standalone/apps/forward/features/design-demo-admin.md

@@ -6,10 +6,11 @@ project: Forwarder
 client: shared
 type: feature
 status: active
-updated: 2026-06-24
+updated: 2026-06-25
 owners: ["jcardinal"]
 files:
   - forward/design/index.php
+  - forward/tabs.json
   - forward/design/.config.example.php
   - forward/.gitignore
   - forward/.htaccess
@@ -94,9 +95,34 @@ auto-deploy ("live in a few minutes").
   brief "Copied ✓" confirmation.
 - **Copy Claude Design prompt** — one-click copy of the standard self-contained-HTML export
   prompt (the same prompt documented in [static-demo-hosting](static-demo-hosting.md)).
+- **Create a tab** (`apiCreateTab`, action `create-tab`) — appends a named tab to
+  `tabs.json`. Case-insensitive dedupe; name length-capped 40. Commits `tabs.json` only.
+- **Move a project to a tab** (`apiSetProjectTab`, action `set-project-tab`) — sets/clears a
+  project's `tab` field; empty string = Unsorted (the field is `unset`). Commits that
+  project's `project.json` **only** — tab membership does not affect the redirect stub, so
+  **no stub rebuild**. `apiCreateProject` also accepts an optional `tab`.
 
 The full action set is: `list`, `create-project`, `upload`, `adopt`, `set-latest`,
-`toggle-version`, `edit-version`, `toggle-project` (plus `bootstrap`).
+`toggle-version`, `edit-version`, `toggle-project`, `create-tab`, `set-project-tab` (plus
+`bootstrap`). `list` also returns the tab list (`{ projects, tabs }`).
+
+### Tab-based organization
+
+Demo projects can be grouped into named **tabs** (e.g. separate Production / Pipeline /
+Sandbox).
+
+- **`tabs.json`** at the repo root holds the ordered tab list — `{"tabs": ["Production",
+  "Pipeline", "Sandbox"]}`. `loadTabs()` returns those three as **defaults when `tabs.json`
+  does not exist yet** (so tabs appear before any are created); the file is only written on
+  the first tab mutation (`create-tab`).
+- Each `project.json` gains an optional **`tab`** field (string). Missing/absent =
+  **"Unsorted"**.
+- **UI:** a filter chip bar (All / each tab / Unsorted / + New tab) with per-tab project
+  counts; clicking a chip filters the list. Each project card has a **Tab `<select>`** to
+  move the project between tabs (on the select's `change`). The New Project modal has a Tab
+  dropdown defaulting to the currently-viewed tab.
+- The **displayed** tab list is the **union** of `tabs.json` order plus any tab names
+  referenced by projects — so removing a tab from `tabs.json` never orphans a project.
 
 ### Naming & validation
 
@@ -117,7 +143,10 @@ anyone who reaches it can publish or unlist. Do not treat the tool as protected.
 
 ## Data model
 
-`project.json` per managed demo (see Versioning model above). No database.
+`project.json` per managed demo (see Versioning model above), plus an optional `tab` string
+field per project (absent = Unsorted). A single repo-root **`tabs.json`** —
+`{"tabs": [...]}` — holds the ordered tab list (defaults to `["Production", "Pipeline",
+"Sandbox"]` until first written). No database.
 
 ## Client variations
 
@@ -158,6 +187,14 @@ None — internal/shared design-team tool.
   `isValidVersionId` + length caps). Added a **Copy URL** button on each project card
   (`navigator.clipboard` → `https://demo.togatech.com/<project>`). Both additive; no new
   security surface. (jcardinal)
+- 2026-06-25 — Added **tab-based organization**: new repo-root `tabs.json` (ordered tab
+  list, defaults Production/Pipeline/Sandbox until first written via `create-tab`), optional
+  `tab` field on `project.json` (absent = Unsorted), and actions **`create-tab`** /
+  **`set-project-tab`** (`apiCreateProject` accepts an optional `tab`). UI filter chip bar
+  with per-tab counts, per-card Tab select, and a Tab dropdown on the New Project modal. The
+  displayed tab list is the union of `tabs.json` and tabs referenced by projects, so dropping
+  a tab from `tabs.json` never orphans a project. `set-project-tab` commits `project.json`
+  only (no stub rebuild). (jcardinal)
 
 ## Related docs
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toga-ai",
-  "version": "1.0.196",
+  "version": "1.0.197",
   "description": "TOGA Technology Team Claude Knowledge System — shared AI coding harness with skills, knowledge base CLI, and project installer for Claude Code.",
   "keywords": [
     "claude",