toga-ai 1.0.522 → 1.0.523

package/knowledge/2.0/apps/toga-blox/INDEX.md

@@ -9,4 +9,4 @@
 | [Primary Table templates (server/client, sizing, virtualization)](features/primary-table-templates.md) | `src/templates/PrimaryTable/` is the **production, wired-up table** built on the [Table component](table.md). | toga-blox/src/templates/PrimaryTable/PrimaryTable.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableServerTemplate.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableClientTemplate.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableHeaderCell.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableBodyCell.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableRow.tsx, toga-blox/src/templates/PrimaryTable/PrimaryTableExpandableRow.tsx, toga-blox/src/templates/PrimaryTable/types.ts |
 | [TableRecordModal (record-detail modal shell)](features/table-record-modal.md) | `TableRecordModal` is a **generic, presentational modal shell** for showing a single table record (row) in detail — typically opened from a table row click. | toga-blox/src/components/TableRecordModal/TableRecordModal.tsx, toga-blox/src/components/TableRecordModal/index.ts, toga-blox/src/components/TableRecordModal/tableRecordModal.module.css |
 | [Table component (cells, action cells, filters & sorts, hooks, theming)](features/table.md) | The `Table` component (`src/components/Table/`) is the **TanStack Table v8** building block behind the [Primary Table templates](primary-table-templates.md). | toga-blox/src/components/Table/index.ts, toga-blox/src/components/Table/types.ts, toga-blox/src/components/Table/utils/buildTanstackColumns.tsx, toga-blox/src/components/Table/utils/resolveCellType.tsx, toga-blox/src/components/Table/components/cellTypes, toga-blox/src/components/Table/components/actionCells, toga-blox/src/components/Table/components/columnFiltersAndSorts, toga-blox/src/components/Table/hooks, toga-blox/src/components/Table/themeConfig |
-| [Dynamic npm Publish Pipeline (branch → channel)](workflows/dynamic-publish-pipeline.md) | How `@agilant/toga-blox` (checkout folder `toga-blox-npm`, registry repo key `toga-blox`) publishes a per-environment npm **channel** (dist-tag) from a `_<mode> | toga-blox/.github/workflows/publish.yml, toga-blox/src/utils/getFontAwesomeIcon.tsx |
+| [Dynamic npm Publish Pipeline (branch → channel)](workflows/dynamic-publish-pipeline.md) | How `@agilant/toga-blox` (checkout folder `toga-blox-npm`, registry repo key `toga-blox`) publishes a per-environment npm **channel** (dist-tag) from a `_<mode> | toga-blox/.github/workflows/publish.yml, toga-blox/package.json, toga-blox/src/utils/getFontAwesomeIcon.tsx |

package/knowledge/2.0/apps/toga-blox/workflows/dynamic-publish-pipeline.md

@@ -6,10 +6,11 @@ project: TOGa Blox
 client: shared
 type: workflow
 status: active
-updated: 2026-07-23
+updated: 2026-08-04
 owners: [jcardinal, apeterson]
 files:
   - toga-blox/.github/workflows/publish.yml
+  - toga-blox/package.json
   - toga-blox/src/utils/getFontAwesomeIcon.tsx
 related:
   - ../architecture.md
@@ -99,11 +100,36 @@ environment needs its own maintained `_<mode>` branch in `toga-blox-npm`.
   `React.CSSProperties & Record<\`--${string}\`, string>` — the value type must be `string`
   (**not** `string | number`; `CSSVariables` requires `string`). Runtime and function signature
   are unchanged, so it is safe for the ~40 consumers.
+- **The `_production`/`_beta` build copies only `.scss` — a plain `.css` component
+  stylesheet is silently dropped from the tarball.** On `_production` and `_beta` the
+  `build` script is `tsc && copyfiles -u 1 "src/**/*.scss" dist`: `tsc` compiles a
+  component's `import "./Foo.css"` into the emitted JS, but `copyfiles` never ships the
+  `.css`, so the published package contains JS importing a file that isn't in the tarball.
+  Consumers then fail their Vite/Rollup build with `Could not resolve "./Foo.css"`
+  (seen with `EnvironmentBadge` in `@agilant/toga-blox@beta` 1.0.316-beta.108, breaking
+  `toga2-commerce`). **Convention on the prod/beta build: author component stylesheets as
+  `.scss`, never `.css`** (a flat `.css` file is valid SCSS as-is, so renaming is the
+  zero-risk fix — no build-script change). Note the build description in `architecture.md`
+  (copies `*.scss/*.css/*.module.css`) reflects the in-progress `feature-new-table` branch,
+  **not** the current `_production`/`_beta` build; that feature branch is not to be merged
+  to prod/beta just to pick up the wider copy glob.
+- **Diagnose what a channel actually shipped with `npm pack`.** To see exactly which files a
+  published dist-tag contains, run `npm pack @agilant/toga-blox@<tag>` then
+  `tar tzf <tarball>` — this is how the missing `.css` (JS importing an unshipped stylesheet)
+  was confirmed against the tarball rather than the source tree.
 - **Secret hygiene done right.** `publish.yml` writes a transient `.npmrc` at build time from
   GitHub secrets (`${NODE_AUTH_TOKEN}` / FontAwesome token) — it never commits tokens. This is
   the pattern the consuming apps should follow (see the commerce workflow's secret-hygiene note).
 
 ## Change history
+- 2026-08-04 — Recorded the prod/beta `.scss`-only build gotcha: the `_production`/`_beta`
+  `build` copies only `src/**/*.scss`, so a component shipped with a plain `.css` + matching
+  `import "./X.css"` publishes JS referencing a stylesheet absent from the tarball, breaking
+  consumers' Vite build (`Could not resolve "./EnvironmentBadge.css"`, `@agilant/toga-blox@beta`
+  1.0.316-beta.108 → `toga2-commerce`). Fix was renaming `EnvironmentBadge.css`→`.scss` (no
+  build-script change), republished on `_beta` as 1.0.316-beta.115 and a `fix/env-badge-scss-prod`
+  PR into `_production`; `toga2-commerce` `_beta` bumped to the fixed version. Added the
+  `npm pack`/`tar tzf` tarball-inspection diagnostic. (apeterson)
 - 2026-07-23 — Documented CI version derivation (strip suffix → patch+1 → append `-<mode>.<run>`;
   dev owns only the base version, never the suffix) and the `_sandbox-client` deploy procedure now
   driven by the `deploy-sandbox-client` project skill. Recorded that `publish.yml` has diverged

package/package.json

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