toga-ai 1.0.260 → 1.0.263

package/knowledge/1.0/apps/tools/INDEX.md

@@ -7,5 +7,6 @@
 | [Tools MVC — Routing, CSRF & App_Database Access Patterns](features/mvc-data-access-patterns.md) | The load-bearing 1.0 (`App_`) framework conventions a developer needs when adding a page to the Tools app — URL routing, CSRF, and DB access through `App_Databa | tools/_/app/nav.php, tools/mvc/get.php |
 | [Tools Persona-Gated Navigation (App_Nav)](features/persona-gated-navigation.md) | `App_Nav` is the Tools app's two-level, **persona-gated** navigation. | tools/_/app/nav.php, tools/mvc/get.php |
 | [Tools SAML SSO Consumer & Persona-Gated Auth (App_Auth)](features/saml-sso-auth.md) | `App_Auth` is the Tools app's authentication layer: it consumes the SAML gateway `?saml=` handoff (see the 2.0 SAML downstream integration contract), establishe | tools/_/app/auth.php, tools/mvc/sso/initiate/get.php, tools/mvc/sso/get.php, tools/mvc/login/get.php, tools/mvc/login/post.php, tools/mvc/logout/get.php, tools/mvc/get.php, tools/config.production.ini, tools/config.local.ini |
+| [Talos Knowledge Base Admin UI (KB Documents + Vocabulary)](features/talos-kb-documents-admin.md) | A Tools (1.0) admin UI to browse/fix the Talos knowledge-base documents and manage the transcript-cleanup vocabulary — without a deploy. | tools/mvc/talos/kb-documents/get.php, tools/mvc/talos/kb-documents/post.php, tools/mvc/talos/vocabulary/get.php, tools/mvc/talos/vocabulary/post.php, tools/_/app/talos/s3.php, tools/_/app/worker.php, tools/_/app/nav.php |
 | [Talos Pricing UI (Onboarding, Dashboard, Benchmarks, Cost Factors + Estimator)](features/talos-pricing-ui.md) | The 1.0 (tools app) face of the **Talos Pricing Platform** — a "Talos Pricing" nav folder with four pages plus a client-side estimate engine. | tools/_/app/nav.php, tools/_/app/talos/estimator.php, tools/mvc/talos/onboarding/get.php, tools/mvc/talos/onboarding/post.php, tools/mvc/talos/pricing/get.php, tools/mvc/talos/benchmarks/get.php, tools/mvc/talos/factors/get.php, tools/mvc/talos/factors/post.php, tools/assets/css/style.css |
 | [Deploying Tools to Elastic Beanstalk (PHP 8.5 / Amazon Linux 2023)](workflows/deploy-to-elastic-beanstalk-al2023.md) | How the **Tools** 1.0 app boots on Elastic Beanstalk running `PHP 8.5 on 64bit Amazon Linux 2023/4.13.1 (aarch64)`. | tools/.ebextensions/004_http_to_https.config, tools/.ebextensions/006_mount-s3fs.config, tools/.ebextensions/007_setup_export_cache_folders.config, tools/.ebextensions/008_setup_ldap.config, tools/.ebextensions/009_setup_phpini.config, tools/.ebextensions/020_setup_git_libraries.config, tools/.ebextensions/050_register_instance_to_shared_application_load_balancer.config, tools/ebs/git.json |

package/knowledge/1.0/apps/tools/features/talos-kb-documents-admin.md

@@ -0,0 +1,88 @@
+---
+title: Talos Knowledge Base Admin UI (KB Documents + Vocabulary)
+framework: "1.0"
+repo: tools
+project: Tools
+client: shared
+type: feature
+status: active
+updated: 2026-06-30
+owners: [jcardinal]
+files:
+  - tools/mvc/talos/kb-documents/get.php
+  - tools/mvc/talos/kb-documents/post.php
+  - tools/mvc/talos/vocabulary/get.php
+  - tools/mvc/talos/vocabulary/post.php
+  - tools/_/app/talos/s3.php
+  - tools/_/app/worker.php
+  - tools/_/app/nav.php
+related:
+  - ./mvc-data-access-patterns.md
+  - ./persona-gated-navigation.md
+  - ../architecture.md
+  - ../../../2.0/apps/worker2/features/talos-transcript-ingestion.md
+---
+
+## Summary
+
+A Tools (1.0) admin UI to browse/fix the Talos knowledge-base documents and manage the
+transcript-cleanup vocabulary — without a deploy. It is the human front-end to the worker2
+[Talos Transcript Ingestion](../../../2.0/apps/worker2/features/talos-transcript-ingestion.md)
+pipeline. A new **"Talos Knowledge Base"** nav group (personas *Development Team* / *TOGa
+Technology*) exposes two pages.
+
+## Pages
+
+### `/talos/kb-documents` — approved-doc browser
+- KB list derived from the **actual S3 sub-folders** under `development-team/` (title-cased,
+  e.g. `office-depot` → "Office Depot") — not from `Team.KnowledgeBases`.
+- Lists approved docs excluding `*.metadata.json`; columns Meeting Date (`n/j/y`) / Title /
+  Size / Last modified (`n/j/y g:i A`).
+- Clickable rows open an overlay **modal** with a type-aware preview: text inline; PDF via a
+  presigned S3 URL in an iframe; Office files via the Google Docs viewer (presigned URL; MS
+  Office viewer noted as an alternative); unsupported → download/delete only.
+- Download + delete are icon buttons in the modal. **Delete enqueues the worker `SyncKb`
+  re-sync** so Bedrock reflects the removal.
+
+### `/talos/vocabulary` — cleanup vocabulary manager
+Single tabbed page: Prompt Template, Applications, Clients, People, Business Terms, Examples,
+Replacements. (The old standalone `/talos/replacements` page was folded in here and deleted.)
+Classic view → Edit → Save per tab, with **full-set reconciliation** (transactional, rolls
+back on error), trash-icon row removal, and an auto-dismissing toast. Backs the `Team.*`
+prompt/replacement tables that the worker2 pipeline reads at runtime.
+
+## Helpers
+
+- **`App_Talos_S3`** (`_/app/talos/s3.php`) — S3 client; list KB slugs; list/count approved;
+  presigned URL; get/delete; slug sanitize+lowercase; approved-prefix path guard.
+- **`App_Worker::enqueue()`** (`_/app/worker.php`) — inserts a `Core.WorkerJobs` row and sends
+  the `{"workerJobId": id}` SQS message, so a 1.0 app can enqueue worker2 jobs.
+
+## Deploy prerequisites
+
+- `aws/aws-sdk-php` installed in `tools/vendor` (S3 + SQS).
+- New `tools/config.*.ini` sections (none exist yet): `[database_core2]` (writable 2.0 Core,
+  dbname `Core`), `[worker]` (`queue_url` / `queue_region`), `[aws]` (production).
+- Apply the dbchanges2 `Team/2026-06-30a..e` + `Core/2026-06-30a` migrations in order.
+- Verify the Bedrock KB region / data-source name against the live account (TODOs in code).
+
+## Gotchas
+
+- **KB list is derived from S3, not the DB.** The browse UI enumerates live S3 folders under
+  `development-team/`; `Team.KnowledgeBases` is not the source of truth for what's shown.
+- **Delete is not just an S3 delete** — it also enqueues a worker `SyncKb` job to re-sync the
+  Bedrock data source.
+- No new secret literals introduced; credentials come from the new config sections above.
+
+## Change history
+
+- 2026-06-30 — Built the Talos KB admin UI: `/talos/kb-documents` (S3-derived KB list, approved
+  doc browser with type-aware preview modal, download + delete-with-resync) and `/talos/vocabulary`
+  (tabbed prompt/vocabulary/replacements manager with transactional full-set reconciliation;
+  folded in and deleted the old `/talos/replacements`). Added `App_Talos_S3` and
+  `App_Worker::enqueue()` (1.0 → worker2 SQS) helpers and the "Talos Knowledge Base" nav group. (jcardinal)
+
+## Related docs
+
+- [Talos Transcript Ingestion Pipeline](../../../2.0/apps/worker2/features/talos-transcript-ingestion.md) — the worker2 backend.
+- [Tools MVC — Routing, CSRF & App_Database Access Patterns](./mvc-data-access-patterns.md)

package/knowledge/2.0/apps/worker2/INDEX.md

@@ -21,8 +21,9 @@
 | [Startech Webhook Handler (worker2)](features/startech-webhook-handler.md) | Receives inbound webhook events from Startech (Easeedesk) and creates or updates the corresponding ticket in TOGA 2.0. | worker2/Worker/Startech.php |
 | [Talos (TOGa IQ) Meeting-Notes Integration & Token Auto-Refresh (consumer)](features/talos-meeting-notes-integration.md) | How a **dev tool / agent consumes Talos (TOGa IQ)** to query the team meeting-notes corpus programmatically. | .claude/skills/plan-ticket/scripts/talos.js |
 | [Talos Pricing Automation (worker2 Cron — AWS Actuals, Calibration, Monthly Report)](features/talos-pricing-automation.md) | The worker2 half of the **Talos Pricing Platform** (see the talos `pricing-cogs-model` and tools `talos-pricing-ui` docs for the other halves). | worker2/Worker/Talos/Pricing.php, worker2/Database/TalosPricingCrons.sql |
+| [Talos Transcript Ingestion Pipeline (worker2 → AWS Bedrock KBs)](features/talos-transcript-ingestion.md) | `_Worker_Team_Transcripts` (in addition to the upstream `Export` action — see [Teams Meeting Transcript Export](./teams-transcript-export.md)) now runs a fully | worker2/Worker/Team/Transcripts.php, worker2/bin/reprocess-transcripts.php, worker2/Config/production.ini, dbchanges2/Team/2026-06-30a, dbchanges2/Team/2026-06-30b, dbchanges2/Team/2026-06-30c, dbchanges2/Team/2026-06-30d, dbchanges2/Team/2026-06-30e, dbchanges2/Core/2026-06-30a |
 | [Team Sprint Management & Reporting](features/team-sprint-management.md) | `_Worker_Team_Sprint` (file `Worker/Team/Sprint.php`) is the engine behind TOGA's internal **development-sprint process and reporting**. | worker2/Worker/Team/Sprint.php |
-| [Teams Meeting Transcript Export](features/teams-transcript-export.md) | `_Worker_Team_Transcripts` (action `Team/Transcripts/Export`) polls Microsoft Graph for Teams meeting transcripts produced by a set of organizers, classifies ea | worker2/Worker/Team/Transcripts.php, worker2/Config/production.ini, worker2/Database/TeamsTranscriptExports.sql, dbchanges2/Core/2026-06-18a - Teams Transcript Export schedule.sql |
+| [Teams Meeting Transcript Export](features/teams-transcript-export.md) | `_Worker_Team_Transcripts` (action `Team/Transcripts/Export`) polls Microsoft Graph for Teams meeting transcripts produced by a set of organizers and archives t | worker2/Worker/Team/Transcripts.php, worker2/Config/production.ini, worker2/Database/TeamsTranscriptExports.sql, dbchanges2/Core/2026-06-18a - Teams Transcript Export schedule.sql |
 | [VAPI Webhook Handler (worker2 — AI-BDR end-of-call processing)](features/vapi-webhook-handler.md) | `_Worker_Vapi` ([worker2/Worker/Vapi.php](worker2/Worker/Vapi.php)) is the **PHP side of the AI-BDR call loop** — the webhook that receives VAPI's end-of-call r | worker2/Worker/Vapi.php, worker2/Worker/Ai/Bdr/Vapi.php |
 | [WJE Freshservice Sync (worker2)](features/wje-freshservice-sync.md) | WJE ("WJE IT", helpdesk `wje.freshservice.com`) is a **Freshservice**-based help-desk client whose tickets, contacts, assets, groups, categories, and canned res | worker2/Worker/Wje.php, _underscore/Component/Api/Wje/Wje.php, _underscore/Model/Wje/Ticket.php, _underscore/Model/Wje/TicketNote.php, _underscore/Model/Wje/Contact.php, _underscore/Model/Wje/Unit.php, _underscore/Model/Wje/TicketTeam.php, _underscore/Model/Wje/TicketCategory.php, _underscore/Model/Wje/AssetType.php, _underscore/Model/Wje/PredefinedReply.php, library/app/api/wje.php, worker/crons/toga2/wje/import_supporting_records.php, worker/crons/toga2/wje/sync_togasupply_wje.php, worker/crons/notifications/reports/wje/wje_common.php, library/app/systemmonitor/wje.php, dbchanges2/Client_Wje/2024-10-04 - WjeOnboarding.sql |
 | [Ticket → ClickUp Pseudocode Planning (Talos-grounded)](workflows/ticket-to-pseudocode-planning.md) | A repeatable procedure for turning a ClickUp ticket into a reviewed, formatted implementation plan posted back to the ticket's `📝 Pseudocode` custom field. | test/@dave/clickup_md2delta.js |

package/knowledge/2.0/apps/worker2/features/talos-transcript-ingestion.md

@@ -0,0 +1,158 @@
+---
+title: Talos Transcript Ingestion Pipeline (worker2 → AWS Bedrock KBs)
+framework: "2.0"
+repo: worker2
+project: Worker
+client: shared
+type: feature
+status: active
+updated: 2026-06-30
+owners: [jcardinal]
+files:
+  - worker2/Worker/Team/Transcripts.php
+  - worker2/bin/reprocess-transcripts.php
+  - worker2/Config/production.ini
+  - dbchanges2/Team/2026-06-30a
+  - dbchanges2/Team/2026-06-30b
+  - dbchanges2/Team/2026-06-30c
+  - dbchanges2/Team/2026-06-30d
+  - dbchanges2/Team/2026-06-30e
+  - dbchanges2/Core/2026-06-30a
+related:
+  - ./teams-transcript-export.md
+  - ./creating-worker-actions.md
+  - ../architecture.md
+  - ../../../1.0/apps/tools/features/talos-kb-documents-admin.md
+  - ../../../1.0/apps/test/features/talos-kb-pipeline.md
+---
+
+## Summary
+
+`_Worker_Team_Transcripts` (in addition to the upstream `Export` action —
+see [Teams Meeting Transcript Export](./teams-transcript-export.md)) now runs a fully
+automated, cron-driven pipeline that ingests raw Teams transcripts into the **Talos / TOGa IQ**
+AWS Bedrock knowledge bases. It replaces the old **manual** two-page web tooling
+(`test/team/talos/kb_processor.php` + `kb_processor.ini` — see
+[Talos Knowledge Base Pipeline](../../../1.0/apps/test/features/talos-kb-pipeline.md)); the
+cleanup/classify/approve/archive/sync logic is a port of that script, but driven by cron jobs
+and by **DB-editable** config instead of an `.ini`.
+
+Flow: raw VTT at `s3://toga-private/transcripts/{date}/…` → `Scan` enqueues one `Process` job
+per unprocessed key → `Process` AI-cleans + AI-classifies → approved `.txt` + Bedrock metadata
+sidecar written to `s3://togaiq/development-team/{kb_slug}/approved/` → raw archived → Bedrock
+`startIngestionJob` on that KB's data source.
+
+## Key files / entry points
+
+- `Worker/Team/Transcripts.php` — actions `Scan`, `Process(string $sourceKey)`,
+  `SyncKb(string $kbSlug)` (all alongside the existing `Export`).
+- `bin/reprocess-transcripts.php` — standalone CLI backlog reprocessor.
+- `Config/production.ini` `[talos]` section — S3/Bedrock targets (see Configuration).
+- DB config + ledger tables in the `Team.*` schema (see Data model), authored in dbchanges2
+  under `Team/2026-06-30a..e` + `Core/2026-06-30a`.
+
+## How it works
+
+### `Scan` (cron)
+Lists unprocessed raw transcripts under the `toga-private` `transcripts/` prefix (skips any
+`sourceKey` already in the `Team.TranscriptProcessing` ledger) and enqueues one `Process` job
+each via `_Worker::runTask('Team/Transcripts/Process', ['sourceKey' => …])`. Scheduled by a
+`Core.CronJobs` row (weekday business hours).
+
+### `Process(string $sourceKey)`
+Port of `kb_processor`, per transcript:
+1. Fetch the raw VTT from S3 (`toga-private`, **us-west-2**).
+2. Call the TOGa IQ AI endpoint `https://api.togaiq.com/api/ai/generate`, model
+   `bedrock/us.anthropic.claude-haiku-4-5-20251001-v1:0`, with an **extended** `output_schema`
+   returning **both** `knowledge_doc` **and** `kb_slug` — the AI picks the single best active KB
+   from the supplied list, or `general`. The system prompt is **assembled at runtime** from DB
+   tables: a template body with `{{APPLICATIONS}}`/`{{CLIENTS}}`/`{{PEOPLE}}`/`{{BUSINESS_TERMS}}`/`{{EXAMPLES}}`
+   placeholders filled from `Team.TranscriptPromptTerms`.
+3. Apply DB-driven text replacements from `Team.TranscriptReplacements` (`:c` case-sensitive,
+   `:w` whole-word, `:cw`) via `preg_replace_callback` **so replacement backrefs stay literal**.
+4. Build the approved name `"{YYYY-MM-DD} - {Title Case}.txt"`.
+5. Upload to `s3://togaiq/development-team/{kb_slug}/approved/` (**us-east-1**) plus a
+   `{name}.txt.metadata.json` Bedrock sidecar.
+6. Archive the raw VTT to `…/{kb_slug}/archive/{date}/`, then delete the source.
+7. AWS Bedrock `startIngestionJob` on that KB's data source (retry 5×30s on
+   `ConflictException` / throttling). **If `kb_slug === 'general'`, sync ALL active KBs.**
+
+Idempotency + status are tracked in `Team.TranscriptProcessing`
+(`pending/cleaned/uploaded/archived/synced/failed`).
+
+### `SyncKb(string $kbSlug)`
+On-demand single-KB re-sync (used by the Tools delete flow — see
+[Talos KB Documents Admin](../../../1.0/apps/tools/features/talos-kb-documents-admin.md)).
+
+### `bin/reprocess-transcripts.php` (CLI backlog reprocessor)
+Standalone CLI that bootstraps `_underscore`, lists existing raw transcripts under the
+`toga-private` `transcripts/` prefix, and runs each through `Process()`. Flags
+`--prefix` / `--limit` / `--dry-run`. Tolerates **both** the old `{slug}/{date}/` layout and the
+new `{date}/` layout. Requires the `ENVIRONMENT` env var, e.g.
+`ENVIRONMENT=production php bin/reprocess-transcripts.php --dry-run`.
+
+### Graph download hardening
+The Graph transcript download is hardened against SSRF / token leak: `https`-only, a
+`*.microsoft.com` host allowlist, and `FOLLOWLOCATION` off.
+
+## Data model (`Team.*` schema, DB alias core cluster)
+
+Authored in dbchanges2 (`Team/2026-06-30a..e`, `Core/2026-06-30a`, all dated 2026-06-30). All
+PKs `INT UNSIGNED` to match the existing Talos Team-table family.
+
+- **`Team.TranscriptReplacements`** — `pattern, replacement, isCaseSensitive, isWholeWord, isActive`.
+  Seeded ~109 rules from the old `.ini`.
+- **`Team.TranscriptPromptTerms`** — `category` ENUM (`application/client/person/businessTerm/example`),
+  `term, isActive, dtCreated, dtUpdated`. Seeded from the `.ini` CORRECTIONS lists. PEOPLE are
+  stored as full "First Last" names (only 2 confidently paired; the rest seeded as individual
+  tokens, intended to be reconciled via the Tools vocabulary UI).
+- **`Team.TranscriptPromptTemplate`** — `name, bodyText` (w/ placeholders), `instruction, model,
+  temperature, maxTokens, timeoutSeconds, isActive`. One active row seeded from the `.ini` system prompt.
+- **`Team.KnowledgeBases`** — `slug, name, isGeneral, bedrockKbId, isActive`. Seeded `general` +
+  `office-depot`. NOTE: the Tools browse UI derives the **live** KB list from S3 folders, not this table.
+- **`Team.TranscriptProcessing`** — `sourceKey UNIQUE(255), kbSlug, approvedKey, archiveKey,
+  status` ENUM (`pending/cleaned/uploaded/archived/synced/failed`), `aiModel, failureReason,
+  dtProcessed`. Pipeline ledger + idempotency.
+- **`Core.CronJobs`** INSERT for action `Team/Transcripts/Scan` (weekday business hours);
+  includes `dtCreated = NOW()` since the column has no default, and depends on the
+  `maxExecutionTime` column migration.
+
+## Configuration
+
+`worker2/Config/production.ini` `[talos]`: `s3_bucket=togaiq`, `s3_region=us-east-1`,
+`bedrock_region=us-east-1`, `kb_prefix=development-team-`, `s3_root_path=development-team/`.
+
+## Gotchas / known issues
+
+- **Cross-region S3.** The raw bucket `toga-private` is **us-west-2** while `togaiq` is
+  **us-east-1**. `Process()` uses two S3 clients; the archive step is a **cross-region copy**.
+- **`[talos]` keys were added to `production.ini` only** — the beta/development configs still
+  need them before the pipeline runs in those environments.
+- **`general` KB fans out.** A `Process()` classified as `general` (or a `general` sync) triggers
+  a sync of **all** active KBs, not one.
+- **Replacements must use `preg_replace_callback`** so replacement text with `$`/`\` backrefs is
+  treated literally (a plain `preg_replace` would interpret them).
+- **worker2 had no prior CLI precedent** — the backlog reprocessor bootstraps by
+  `chdir($projectRoot)` then `require vendor/autoload.php` + `_underscore.php`, and requires the
+  `ENVIRONMENT` env var.
+- **Deploy TODOs left in code:** verify the live Bedrock KB region and data-source name against
+  the actual account before first prod run.
+- **Pre-existing plaintext secrets** in `worker2/Config/production.ini` and the reference
+  `kb_processor.ini` (AWS / aegra) should be rotated — not introduced by this work; no new secret
+  literals were added to any new file or migration.
+
+## Change history
+
+- 2026-06-30 — Built the automated cron-driven ingestion pipeline (`Scan`/`Process`/`SyncKb`) +
+  the `bin/reprocess-transcripts.php` backlog CLI, porting the manual `kb_processor.php`. Added
+  the `Team.*` config/ledger schema (DB-editable replacements, prompt terms, prompt template, KB
+  list, processing ledger) and the `Scan` cron. Classification moved from title-based to AI (single
+  best KB, or `general`). Config vocabulary/replacements are now DB-driven and editable via the
+  Tools UI. (jcardinal)
+
+## Related docs
+
+- [Teams Meeting Transcript Export](./teams-transcript-export.md) — the upstream S3 producer.
+- [Talos KB Documents Admin](../../../1.0/apps/tools/features/talos-kb-documents-admin.md) — the Tools UI.
+- [Talos Knowledge Base Pipeline](../../../1.0/apps/test/features/talos-kb-pipeline.md) — the manual script this ports.
+- [Creating Worker Actions](./creating-worker-actions.md)

package/knowledge/2.0/apps/worker2/features/teams-transcript-export.md

@@ -6,8 +6,8 @@ project: Worker
 client: shared
 type: feature
 status: active
-updated: 2026-06-18
-owners: ["ajean"]
+updated: 2026-06-30
+owners: ["ajean", "jcardinal"]
 files:
   - worker2/Worker/Team/Transcripts.php
   - worker2/Config/production.ini
@@ -16,13 +16,18 @@ files:
 related:
   - ../architecture.md
   - ./creating-worker-actions.md
+  - ./talos-transcript-ingestion.md
 ---
 
 ## Summary
 
 `_Worker_Team_Transcripts` (action `Team/Transcripts/Export`) polls Microsoft Graph for
-Teams meeting transcripts produced by a set of organizers, classifies each meeting by
-client (from the meeting title), and archives the raw WebVTT to S3. Scheduled via a single
+Teams meeting transcripts produced by a set of organizers and archives the raw WebVTT to S3.
+As of 2026-06-30 it **no longer classifies by client**: raw transcripts land **flat** at
+`s3://toga-private/transcripts/{YYYY-MM-DD}/{HHMM}_{title-slug}_{shortId}.vtt` (no client
+folder). Classification now happens later, by AI, in the downstream ingestion pipeline — see
+[Talos Transcript Ingestion](./talos-transcript-ingestion.md), which is the consumer of this
+S3 output. Scheduled via a single
 `Core.CronJobs` row firing weekdays at 9:30 / 11:30 / 13:30 / 14:30 / 15:30 / 16:30 / 17:30
 Central (`30 9,11,13,14,15,16,17 * * 1-5`).
 
@@ -69,11 +74,15 @@ date. `createdDateTime` is stamped minutes after the actual occurrence, so it da
 correctly. `getMeeting()` is therefore used only for the subject. `dtExported` uses
 `UTC_TIMESTAMP()` (not `NOW()`) so all three timestamps are UTC.
 
-**Classification:** case-insensitive substring match of the meeting title against active
-`Core.Clients` names + `[teamsClientAliases]`, longest needle wins, min length 3. No match → `general`.
+**Classification: REMOVED (2026-06-30).** The old title-based classification (substring match
+against `Core.Clients` + `[teamsClientAliases]`) was inaccurate and has been deleted
+(`classify()`, `buildClientIndex()`, `loadClientNames()`, `loadClientAliases()`, along with the
+old `Backfill()`/`moveObject()`). Classification is now done by the AI in the downstream
+ingestion `Process()` step, which picks the single best knowledge base (or `general`).
 
-**S3 layout:** `s3://{[teams] s3_bucket}/{s3_prefix}{client-or-general}/{YYYY-MM-DD}/{HHMM}_{title-slug}_{shortId}.vtt`
-(date/time in Central). Currently `toga-private/transcripts/…`.
+**S3 layout (current):** `s3://toga-private/transcripts/{YYYY-MM-DD}/{HHMM}_{title-slug}_{shortId}.vtt`
+— **flat, no client/general folder** (date/time in Central). The old
+`…/{client-or-general}/{date}/…` layout is history; the downstream reprocessor CLI tolerates both.
 
 ## Data model
 
@@ -162,6 +171,12 @@ Policy gap; a `400` only on a UPN means the id was never resolved to a GUID. (A
 
 ## Change history
 
+- 2026-06-30 — **Removed title-based client classification and the client-folder S3 layout.**
+  Raw transcripts now land flat at `transcripts/{date}/…` with no client subfolder; deleted
+  `classify()`/`buildClientIndex()`/`loadClientNames()`/`loadClientAliases()` and the old
+  `Backfill()`/`moveObject()`. Classification moved downstream to the AI in the new
+  [Talos Transcript Ingestion](./talos-transcript-ingestion.md) pipeline, which is now the
+  consumer of this S3 output. (jcardinal)
 - 2026-06-18 — Fixed recurring-meeting date misfiling: archive date + `dtMeeting` now come from
   the transcript `createdDateTime`, not the series-anchor `meeting->startDateTime` (worker2 PR
   #82, merged + deployed). Added `Backfill()` and ran it in prod (61/66 objects re-filed, 0

package/knowledge/INDEX.md

@@ -12,12 +12,12 @@ _Auto-generated by `knowledge.js index`. Do not hand-edit._
 - **walmarttechservices** (Walmart Tech Services) — 1 doc(s) → [1.0/apps/walmarttechservices/INDEX.md](1.0/apps/walmarttechservices/INDEX.md)
 - **test** (Test) — 12 doc(s) → [1.0/apps/test/INDEX.md](1.0/apps/test/INDEX.md)
 - **toga** (TOGa) — 2 doc(s) → [1.0/apps/toga/INDEX.md](1.0/apps/toga/INDEX.md)
-- **tools** (Tools) — 7 doc(s) → [1.0/apps/tools/INDEX.md](1.0/apps/tools/INDEX.md)
+- **tools** (Tools) — 8 doc(s) → [1.0/apps/tools/INDEX.md](1.0/apps/tools/INDEX.md)
 
 ## 2.0 framework
 
 - **_underscore** (_Underscore) _(framework core)_ — 21 doc(s) → [2.0/apps/_underscore/INDEX.md](2.0/apps/_underscore/INDEX.md)
-- **worker2** (Worker) — 24 doc(s) → [2.0/apps/worker2/INDEX.md](2.0/apps/worker2/INDEX.md)
+- **worker2** (Worker) — 25 doc(s) → [2.0/apps/worker2/INDEX.md](2.0/apps/worker2/INDEX.md)
 - **api2** (API) — 7 doc(s) → [2.0/apps/api2/INDEX.md](2.0/apps/api2/INDEX.md)
 - **dbchanges2** (Database Changes) _(framework core)_ — 3 doc(s) → [2.0/apps/dbchanges2/INDEX.md](2.0/apps/dbchanges2/INDEX.md)
 - **toga2-supply** (TOGa Supply) — 3 doc(s) → [2.0/apps/toga2-supply/INDEX.md](2.0/apps/toga2-supply/INDEX.md)

package/package.json

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

package/skills/kickoff/SKILL.md

@@ -246,6 +246,11 @@ valid choice; this skill is opt-in.
 
 Tell the developer concisely:
 - Which framework(s), repo(s), and client are in scope, and the local path of each repo.
+- **Name the framework core(s) explicitly and state the `app → core` dependency** for every
+  chosen app — e.g. "`worker` (1.0) → `library` core", "`api2` (2.0) → `_underscore` core".
+  Every repo depends on its framework's core (1.0 → `library`, 2.0 → `_underscore`); preflight
+  always includes it in `loadSet`. Do **not** bury the core inside a generic "loaded as
+  summaries" list — the developer must see that the core is loaded and which app pulled it in.
 - Which knowledge docs you loaded (by title). Where a repo/standard has **no knowledge yet**,
   say so explicitly: "No knowledge captured yet for X — `capture` will build it as you work."
 - Confirm you're primed and ready for their first task.