Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
20 commits
Select commit Hold shift + click to select a range
74b1b43
Move 11 pure Semantic Kernel samples to deprecated folder
elbruno Feb 23, 2026
4de5d54
Update lesson docs to reference deprecated SK samples
elbruno Feb 23, 2026
cd8ef7a
Remove Semantic Kernel from mixed MEAI projects
elbruno Feb 23, 2026
930580d
Align NuGet package versions and upgrade rc to GA
elbruno Feb 23, 2026
6ce5357
Update Oracle charter to track docs/changelog and notify Niobe
elbruno Feb 23, 2026
a7b39dc
Document SK connector dependencies & update changelog
elbruno Feb 23, 2026
517a368
Scribe: merge decisions and update focus
elbruno Feb 23, 2026
343b6b8
Fix BasicChat-11FoundryClaude build: add explicit Azure.AI.OpenAI dep…
elbruno Feb 23, 2026
11fe522
Fix doc issues: clarify Ollama deprecation wording, remove duplicate …
elbruno Feb 23, 2026
5dc1da4
Squad: Merge PR #491 review decisions and orchestration logs
elbruno Feb 23, 2026
f9f149a
Update documentation and remove SK dependencies in preparation for ME…
elbruno Feb 23, 2026
e36c4d5
Upgrade remaining NuGet packages to latest versions
elbruno Feb 23, 2026
389a583
Update translation files to reference deprecated SK samples
elbruno Feb 23, 2026
d27a5eb
Update changelog: mark follow-up items completed
elbruno Feb 23, 2026
efd88ea
Scribe: merge follow-up session decisions
elbruno Feb 23, 2026
d6dc5fa
.squad: merge decision inbox, add followup session & orchestration logs
elbruno Feb 23, 2026
3a947a3
Replace SK connectors in RAGSimple-02/03/04 with native clients
elbruno Feb 23, 2026
9e62c77
Add prompt for external AgentFx VectorData Sqlite library
elbruno Feb 23, 2026
0c41cd5
Refactor IngestedChunk and IngestedDocument properties to use string.…
elbruno Feb 23, 2026
a087159
Update changelog date to 2029-02-23 for Semantic Kernel deprecation a…
elbruno Feb 23, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .squad/agents/dozer/history.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,3 +7,10 @@
- **Owned scope:** NuGet package upgrades, .NET framework upgrades, build verification across all projects

## Learnings

### NuGet Upgrade Cycle (Feb 2026)
- **Preview-to-GA transitions are high-impact**: Microsoft.Extensions.AI.OpenAI's graduation from preview (10.2.0-preview.1.26063.2) to GA (10.3.0) is a significant reliability milestone. Prioritize these in upgrade cycles.
- **Constraints-driven upgrades require clear documentation**: SK connector packages (InMemory, AzureAISearch, Qdrant, SqliteVec) remain on preview versions because MEAI equivalents don't exist yet. Documenting which packages are constrained and why prevents regressions in future upgrades.
- **Build verification across all projects is non-negotiable**: Spot-checking 2-3 projects misses transitive dependency issues (as discovered in PR #491). Recommend adding a "full build matrix" CI job that touches all non-deprecated projects.
- **Version consistency in Configuration packages simplifies maintenance**: Grouping Microsoft.Extensions.Configuration family upgrades (10.0.1 → 10.0.3) reduces cognitive load and makes future audits easier.
- **Major version bumps should be explicit decisions, not missed opportunities**: VectorData.Abstractions (9.7.0 → 10.0.0 available) was deferred in RAGSimple per constraints, but tracking these "deferred majors" helps prioritize future upgrade sessions.
6 changes: 6 additions & 0 deletions .squad/agents/morpheus/history.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,9 @@
- **User:** Bruno Capuano

## Learnings

### PR #491 Architectural Review (Feb 2026)
- **Build failures are architectural blockers, not cosmetic issues**: BasicChat-11FoundryClaude's missing package is a systemic issue that reveals transitive dependency tracking gaps. Critical issues must block merge; minor issues can be conditional.
- **Phase 1 (Oracle + Tank + Trinity) → Phase 2 (Morpheus synthesis) is effective**: Morpheus's role as orchestrator synthesizing findings from three specialists ensures no single-specialist blind spots. This cascade model should be standard for major PRs.
- **Transitive dependency tracking needs CI enforcement**: Future deprecations should include a CI rule: "All projects with `using Azure.AI.*` must have explicit NuGet references." Prevent the error at source.
- **Documentation gaps are acceptable by design**: Root README.md lacking SK deprecation entry is fine because detailed info is in authoritative `10-WhatsNew/readme.md`. Clear ownership of "what goes where" in docs prevents redundancy.
10 changes: 10 additions & 0 deletions .squad/agents/neo/history.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,13 @@
- **User:** Bruno Capuano

## Learnings
- As of July 2025, no standalone MEAI-native NuGet packages exist for InMemory, AzureAISearch, Qdrant, or SqliteVec vector stores. The SK connector packages remain the only implementations.
- `Microsoft.SemanticKernel.Text.TextChunker` has no MEAI-native replacement. SK Core is still required for text chunking.
- `AddSqliteCollection<>()` extension method is provided by `Microsoft.SemanticKernel.Connectors.SqliteVec` with no MEAI equivalent.
- The Middleware AgentFx project has a pre-existing NU1605 package downgrade error (MEAI 10.2.0 vs 9.10.1) unrelated to connector changes.

### PR #491 Build Fix (Feb 2026)
- **Transitive dependencies must be tracked explicitly**: BasicChat-11FoundryClaude was missing explicit `Azure.AI.OpenAI` reference because SK provided it transitively. When removing SK, explicit references are not added automatically—manual audit required.
- **Verify the pattern, not just the fix**: BasicChat-05AIFoundryModels already had the correct fix applied (Azure.AI.OpenAI 2.8.0-beta.1). Use this as a template when similar issues arise in other projects.
- **Document patterns for future developers**: Created commit message guidance: when removing a major package, check (1) what transitive deps it provides, (2) does code directly reference types from those deps, (3) add explicit refs before removal.
- **Build verification is defensive**: The fix is simple (one line XML), but it protects course users from a build failure on a prominent sample. Defensive QA at this level saves support overhead.
10 changes: 7 additions & 3 deletions .squad/agents/oracle/charter.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,21 @@ Analyze recent repository changes (commits, PRs, new samples) and maintain the W
## Boundaries
- Owns the `✨ What's New` section in the root `README.md`
- Owns `10-WhatsNew/readme.md` with detailed changelog
- Owns `docs/changelog/` — the persistent changelog archive for all major repo changes
- Analyzes git log, recent commits, merged PRs, and new/modified samples
- Writes clear, beginner-friendly changelog entries with emoji and links
- Coordinates with Trinity for content consistency
- Notifies Niobe (What's New / Education Strategist) about significant changes

## Workflow
1. Run `git log` to find recent commits and changes
2. Identify new samples, lessons, features, or significant updates
3. Categorize changes (new sample, improvement, fix, docs update)
4. Update `10-WhatsNew/readme.md` with detailed entries
5. Update the `✨ What's New` section in root `README.md` with highlights
6. Use consistent formatting: emoji prefix, bold title, description, link
4. Record detailed change entries in `docs/changelog/` (one file per major change or upgrade cycle)
5. Update `10-WhatsNew/readme.md` with detailed entries
6. Update the `✨ What's New` section in root `README.md` with highlights
7. Use consistent formatting: emoji prefix, bold title, description, link
8. Notify Niobe about major changes so she can assess educational impact

## Model
Preferred: auto
12 changes: 12 additions & 0 deletions .squad/agents/oracle/history.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,3 +7,15 @@
- **Owned files:** Root README.md (What's New section), 10-WhatsNew/readme.md

## Learnings

### SK Deprecation Cycle (Feb 2026)
- **Big migrations are _multi-phase_**: SK deprecation required 5 phases (move samples → update docs → remove from mixed projects → align NuGet → create changelog archive)
- **Changelog structure matters**: Created `docs/changelog/` to track all major repo changes persistently. Each changelog doc now includes phases, impacts, commits, and follow-up items.
- **Version alignment is tedious but essential**: 74 .csproj files × multiple package upgrades = 288 total changes. Pre-planning file lists by project structure helps.
- **Mixed projects (MEAI + SK) complicate deprecation**: BasicChat-05 and BasicChat-11 needed surgical SK removal while keeping MEAI — plan for these early.
- **Translation lag is normal**: 8 localized docs still reference old paths; this is a follow-up that can be batched later.
- **Key insight for changelog entries**: Include commit SHAs, agent names, and explicit counts (11 samples, 74 files, 288 updates) so future readers understand scope without digging into git.

### PR #491 Review Cycle (Feb 2026)
- **Changelog accuracy 95% is acceptable**: Root README.md "What's New" gap is acceptable by design—detailed entry correctly placed in authoritative `10-WhatsNew/readme.md`. Optional follow-up PR can add brief mention to root README.
- **Multi-agent reviews catch systemic issues**: Oracle's changelog accuracy check alone would have missed Tank's build failure and Trinity's doc ambiguities. Phase 1 (Oracle + Tank + Trinity) + Phase 2 (Morpheus synthesis + Neo/Coordinator fixes) is the right structure.
6 changes: 6 additions & 0 deletions .squad/agents/tank/history.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,9 @@
- **User:** Bruno Capuano

## Learnings

### PR #491 Build Review (Feb 2026)
- **Transitive dependency tracking is critical**: When a major package (SK) is removed, audit all affected projects for direct type usage. BasicChat-11FoundryClaude used `Azure.AI.OpenAI` types but lacked explicit package reference—was relying on transitive from SK.
- **Spot-check builds are insufficient**: Tank checked 6 projects; if only checked 5, build failure would have shipped. Future: CI must build ALL non-deprecated samples, not just a selection.
- **Pattern matching reduces errors**: BasicChat-05AIFoundryModels had the fix applied correctly (Azure.AI.OpenAI 2.8.0-beta.1 added); BasicChat-11 was missed. Pre-review audits of "which projects use Azure.AI.*" would prevent this.
- **NuGet version consistency is strong**: Across 5 projects tested, Microsoft.Extensions.AI 10.2.0 was uniform—version management is solid, just need explicit reference tracking.
12 changes: 12 additions & 0 deletions .squad/agents/trinity/history.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,15 @@
- **User:** Bruno Capuano

## Learnings

### PR #491 Documentation Review (Feb 2026)
- **Ambiguous terminology in beginner docs is high-risk**: "Ollama (deprecated SK samples)" creates confusion for learners—does Ollama deprecate SK, or are SK samples deprecated? Clarifying language is essential in a course that targets beginners.
- **Copy-paste errors in What's New sections reduce trust**: Duplicate lines in high-visibility changelog sections signal carelessness and hurt professional credibility. QA should include a "uniqueness scan" for What's New and changelog entries.
- **Deprecation messaging is well-standardized here**: Strikethrough + "(Deprecated)" + links to deprecated folder + MEAI alternative is a repeatable pattern that works across 8 files. Recommend this pattern for future deprecations.
- **Link integrity is solid**: All 12 verified links functional (deprecated folder, setup guides, alternative samples). The repo's documentation infrastructure is mature and reliable.

### Translation Maintenance Post-Deprecation (Feb 2026)
- **8-language translation updates require a synchronization checklist**: Manual updates across ES, ZH-CN, FR, JA, KO, DE, PT-BR, IT are prone to drift if not tracked methodically. Recommend creating a "translation sync" template for future deprecations.
- **Terminology consistency across languages is more important than literal translation**: "Archived Semantic Kernel RAG examples" works better than locale-specific phrasings because it aligns with English docs and reduces confusion for bilingual learners.
- **Cultural nuance matters for beginners**: Japanese and Korean translations require slightly different deprecation phrasing due to language structure. Always review locale-specific translations with native speakers or established cultural guidelines.
- **15-file updates across 8 languages is a 1-person workload**: Trinity completed this in a single session. Document this scope as a "standard deprecation task size" for planning future translation work.
96 changes: 96 additions & 0 deletions .squad/decisions/decisions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
# Decisions Log

## Decision: SK Connector Packages Cannot Be Replaced Yet

**Author:** Neo | **Date:** 2025-07-17

### Context
Investigated replacing all Semantic Kernel connector NuGet packages with MEAI (Microsoft.Extensions.VectorData) equivalents across 8 projects.

### Decision
**Keep all SK connector packages** and document them with TODO comments. No MEAI-native replacement packages exist on NuGet yet:

| SK Package | MEAI Replacement | Status |
|---|---|---|
| `Microsoft.SemanticKernel.Connectors.InMemory` | `Microsoft.Extensions.VectorData.InMemory` | ❌ Does not exist |
| `Microsoft.SemanticKernel.Connectors.AzureAISearch` | `Microsoft.Extensions.VectorData.AzureAISearch` | ❌ Does not exist |
| `Microsoft.SemanticKernel.Connectors.Qdrant` | `Microsoft.Extensions.VectorData.Qdrant` | ❌ Does not exist |
| `Microsoft.SemanticKernel.Connectors.SqliteVec` | `Microsoft.Extensions.VectorData.SqliteVec` | ❌ Does not exist |
| `Microsoft.SemanticKernel.Core` (TextChunker) | N/A | ❌ No MEAI text chunker |

### What Was Done
- Added XML/code comments to all 8 csproj files and 8 source files marking the SK dependencies with TODOs
- Verified all projects still build (except pre-existing NU1605 in Middleware project)

### Action Items
- Revisit when MEAI vector store provider packages are published to NuGet
- Monitor https://devblogs.microsoft.com/dotnet/ for VectorData provider announcements

---

## Decision: NuGet Package Upgrades (Round 2)

**Author:** Dozer
**Date:** 2025-07-18

### Packages Upgraded

| Package | Old Version | New Version | Files Updated |
|---------|------------|-------------|---------------|
| Microsoft.Extensions.AI | 10.2.0 | 10.3.0 | 41 |
| Microsoft.Extensions.AI.OpenAI | 10.2.0-preview.1.26063.2 | 10.3.0 | 29 |
| Microsoft.Extensions.Configuration | 10.0.1 | 10.0.3 | 9 |
| Microsoft.Extensions.Configuration.Json | 10.0.1 | 10.0.3 | 7 |
| Microsoft.Extensions.Configuration.UserSecrets | 10.0.1 | 10.0.3 | 49 |

**Total:** 79 files changed across 5 packages.

### Packages Left Unchanged (by design)

- **Microsoft.Extensions.AI.AzureAIInference** (10.0.0-preview.1.25559.3) — no GA version available
- **Microsoft.SemanticKernel.Connectors.InMemory** (1.66.0-preview) — SK package in RAGSimple, left as-is per constraints
- **Microsoft.Extensions.VectorData.Abstractions** (9.7.0 → 10.0.0 available) — major version bump in RAGSimple project, left as-is per constraints
- **Microsoft.Agents.AI / Microsoft.Agents.AI.OpenAI** (preview) — no GA available

### Notable

- Microsoft.Extensions.AI.OpenAI moved from preview to GA (10.3.0) — a significant improvement.

### Build Verification

All 5 representative projects built successfully with 0 errors.

---

## PR #491 Review Cycle: SK Deprecation & NuGet Upgrades

**Status:** ✅ FIXES APPLIED (All blockers resolved)

### Phase 1 Findings Summary

**Oracle (Changelog Review):** ✅ 95% accurate changelog. Root README.md "What's New" gap accepted as non-blocking.

**Tank (Build Verification):** 🔴 CRITICAL — BasicChat-11FoundryClaude missing Azure.AI.OpenAI package.

**Trinity (Documentation Review):** 🟡 2 minor issues:
1. Line 59 in `02-retrieval-augmented-generation.md`: Ambiguous "Ollama (deprecated SK samples)" wording
2. Lines 79–80 in `10-WhatsNew/readme.md`: Duplicate lines + jumbled June 2025 section structure

**Morpheus (Architectural Review):** 🔴 BLOCKED — Build failure is critical; doc fixes required before merge.

### Phase 2 Fixes Applied

**Neo (Developer):** ✅ Commit 343b6b8 — Added explicit `Azure.AI.OpenAI` dependency to BasicChat-11FoundryClaude.csproj

**Coordinator (Documentation):** ✅ Commit 11fe522 — Fixed ambiguous Ollama language and removed duplicate lines in What's New section

### Verified Resolution
- BasicChat-11FoundryClaude now builds successfully
- Documentation clarity improved with corrected language and structure
- All 3 blocking issues resolved

### Lessons Learned
1. Transitive dependency tracking is critical when removing major packages (SK)
2. Build verification must include all non-deprecated projects, not spot-checks
3. Documentation reviews should catch copy-paste errors in high-visibility sections
4. CI should enforce: "All projects with `using Azure.AI.*` must have explicit NuGet references"
12 changes: 9 additions & 3 deletions .squad/identity/now.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,15 @@
---
updated_at: 2026-02-23T17:37:00Z
focus_area: Team setup complete
updated_at: 2026-02-24T02:15:00Z
focus_area: SK deprecation + NuGet alignment complete, PR #491 open
active_issues: []
---

# What We're Focused On

Team hired. Oracle is the changelog analyst — responsible for analyzing repo changes and updating What's New sections.
**Completed:**
- SK connector replacement investigation: all 8 projects marked with TODO comments for future MEAI VectorData provider replacements
- NuGet alignment: verified no MEAI alternatives exist for SK packages on NuGet
- Documentation: changelog updated with complete migration record, What's New entry added to 10-WhatsNew/readme.md
- PR #491: open with all changes

**Next:** Monitor for MEAI vector store provider package announcements and revisit when available.
52 changes: 52 additions & 0 deletions .squad/orchestration-log/dozer-2026-02-23-followup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# Orchestration Log: Dozer

**Agent:** Dozer
**Role:** Build & NuGet package manager
**Date:** 2026-02-23
**Session:** Followup (post-PR #491 merge)
**Status:** ✅ Complete

---

## Assignment

Upgrade NuGet packages across the repository:
- Prioritize MEAI and AI.OpenAI (major GA releases)
- Advance Configuration packages to latest stable
- Respect constraints (SK preview packages, major version bumps in RAGSimple)

## Scope

| Package | Old Version | New Version | Files |
|---------|------------|-------------|-------|
| Microsoft.Extensions.AI | 10.2.0 | 10.3.0 | 41 |
| Microsoft.Extensions.AI.OpenAI | 10.2.0-preview.1.26063.2 | 10.3.0 | 29 |
| Microsoft.Extensions.Configuration | 10.0.1 | 10.0.3 | 9 |
| Microsoft.Extensions.Configuration.Json | 10.0.1 | 10.0.3 | 7 |
| Microsoft.Extensions.Configuration.UserSecrets | 10.0.1 | 10.0.3 | 49 |

**Total:** 79 files across 5 packages

## Notable Achievement

Microsoft.Extensions.AI.OpenAI transitioned from preview (10.2.0-preview.1.26063.2) to GA (10.3.0).

## Build Verification

✅ All 5 representative projects built successfully with 0 errors:
- BasicChat-01HelloAI
- BasicChat-05AIFoundryModels
- RAGSimple
- AgentFx-ChatBot
- SpaceAINet.Console

## Packages Intentionally Left Unchanged

- **Microsoft.Extensions.AI.AzureAIInference** (10.0.0-preview.1.25559.3) — no GA available
- **Microsoft.SemanticKernel.Connectors.InMemory** (1.66.0-preview) — per constraints
- **Microsoft.Extensions.VectorData.Abstractions** (9.7.0) — major version bump deferred in RAGSimple
- **Microsoft.Agents.AI / Microsoft.Agents.AI.OpenAI** (preview) — no GA available

## Handoff

NuGet upgrades complete and verified. Changelog entry prepared in decisions.md.
61 changes: 61 additions & 0 deletions .squad/orchestration-log/morpheus-2026-02-23.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
# Orchestration Log: Morpheus

**Agent:** Morpheus
**Role:** Architectural lead & scope gate
**Date:** 2026-02-23
**Status:** 🔴 Decision: BLOCKED (awaiting fixes)

---

## Assignment

Synthesize Phase 1 findings from Oracle, Tank, and Trinity. Issue final architectural verdict on PR #491.

## Phase 1 Summary

| Finding | Source | Status | Severity |
|---------|--------|--------|----------|
| Changelog 95% accurate; root README gap acceptable | Oracle | ✅ APPROVE | Low |
| BasicChat-11FoundryClaude build failure (CS0234) | Tank | 🔴 REJECT | **CRITICAL** |
| Ambiguous Ollama language & duplicate What's New lines | Trinity | 🟡 CONDITIONAL APPROVE | Minor |

## Architectural Decision

**Final Verdict: 🔴 BLOCKED**

### Build Quality: REJECT (Critical Blocker)
- BasicChat-11FoundryClaude cannot build
- Systemic issue from SK deprecation cleanup
- Transitive dependency tracking insufficient
- **Required Action:** Add Azure.AI.OpenAI package reference
- **Risk if released:** Users cannot build/run this sample — unacceptable for course

### Documentation: CONDITIONAL APPROVE
- Fix ambiguous Ollama language (Line 59)
- Remove duplicate & restructure What's New section
- **All other docs excellent**

### Changelog: APPROVE
- 95% accurate overall
- Root README gap acceptable (optional follow-up PR)

## Blocking Conditions

Merge cannot proceed until:
1. ✅ Azure.AI.OpenAI added to BasicChat-11FoundryClaude.csproj
2. ✅ Build verified successful on that project
3. ✅ Ollama language clarified in RAG tutorial
4. ✅ What's New duplicates removed & structure fixed

## Risk Mitigation Strategy

**Prevent Future Occurrences:**
- Add CI rule: All projects with `using Azure.AI.*` must have explicit NuGet references
- Expand build verification to all non-deprecated samples (not spot-checks)
- Document transitive dependencies before package removal

## Handoff

Assignment issued to Neo (build fix) and Coordinator (documentation fixes). Phase 2 verification pending upon completion.

**Status:** ⏸️ AWAITING FIXES — Ready for Phase 2 upon completion
Loading
Loading