AIWG v2026.3.1 — "Discovery & Durability" Release

Released: 2026-03-03

This release adds artifact discovery (`aiwg index`), forensics agent hardening, crash-resilient agent loops, `.aiwg/` version tracking, and a full documentation accuracy sweep.

Highlights

What changed	Why you care
`aiwg index` subsystem	Agents can now search, query dependencies, and inspect artifact stats across your `.aiwg/` directory — no more blind navigation
Forensics agent gap-fills	6 agents and 3 commands rewritten with full operational detail; 660-line integration test suite validates the framework end-to-end
Color Palette addon	Standalone addon for generating accessible color palettes with WCAG contrast checking and trend analysis
Ralph external crash resilience	SnapshotManager API fixed, state cleanup on loop completion, e2e tests with real process spawning
`.aiwg/` tracked in git	Project artifacts now version-controlled (excluded from npm/edge deploys) — full SDLC history preserved
Documentation accuracy sweep	7 drift items fixed: agent counts, command totals, skill manifest gaps, Copilot path mismatch
`--model` blanket override	`aiwg use sdlc --model sonnet` overrides all agent model selections in a single flag
`--use-dev` testing flag	`aiwg --use-dev` points the CLI at your local repo checkout for framework development

Artifact Discovery (`aiwg index`)

New subsystem for navigating `.aiwg/` artifacts programmatically:

# Build the index
aiwg index build

# Search artifacts by keyword
aiwg index query "authentication" --json

# Show dependency graph for a specific artifact
aiwg index deps .aiwg/requirements/UC-001.md --json

# Index health statistics
aiwg index stats --json

The index supports multi-graph architecture (content types, dependency graphs, incremental builds) and integrates with the `artifact-lookup` skill for natural language queries like "what depends on UC-001?".

New agent rule: `artifact-discovery` — agents must query the index before starting phase work and check dependencies before modifying artifacts.

Forensics Framework Hardening

Phase 1-2 agent and skill gap-fills for the forensics-complete framework (#381-391):

• 6 agents rewritten: acquisition-agent, container-analyst, log-analyst, network-analyst, persistence-hunter, triage-agent — all now have full operational procedures, tool integration, and output format specifications
• 3 commands expanded: forensics-acquire, forensics-investigate, forensics-triage — complete workflow definitions with evidence chain-of-custody
• 3 skills updated: container-forensics, evidence-preservation, log-analysis — detailed detection patterns and analysis procedures
• 660-line integration test suite validating agent structure, manifest integrity, skill completeness, and cross-references

Color Palette Addon

New standalone addon (`agentic/code/addons/color-palette/`) for design-oriented workflows:

• 3 skills: `color-palette` (generation), `color-accessibility` (WCAG contrast), `color-trends` (trend analysis)
• 2 templates: palette report, trend report
• 1 rule: color output format standardization

aiwg use color-palette

Ralph External Improvements

• Fixed: SnapshotManager API mismatch that caused fatal path errors during external loop execution
• Added: State cleanup for completed agent loops — no more stale state files
• Added: End-to-end integration tests using real process spawning (not mocks)
• Added: Stub CLI and provider adapter test fixtures

CLI Enhancements

`--model` Blanket Override

Override all agent model selections when deploying a framework:

# Deploy SDLC with all agents using sonnet
aiwg use sdlc --model sonnet

# Deploy to Copilot with opus everywhere
aiwg use sdlc --provider copilot --model opus

`--use-dev` Local Testing

Point the CLI at your local AIWG repo checkout for development:

aiwg --use-dev         # Use local repo as framework source
aiwg use sdlc          # Deploys from local source, not npm
aiwg --use-stable      # Switch back to npm package

Cleanup Audit Command

New `aiwg cleanup-audit` command with Dead Code Analyzer agent and cleanup-audit skill:

aiwg cleanup-audit --scope src/ --type exports
aiwg cleanup-audit --fix --dry-run

Documentation Accuracy

Full doc-sync audit (code-to-docs) identified and fixed 7 drift items:

• platform-paths.ts: Copilot commands path `.github/commands` → `.github/agents` (matched JS provider)
• cli-reference.md: Agent count 35+ → 90; Ralph category 4 → 7 commands; total 44 → 47
• SDLC README: Agent count 70+ → 90
• CLAUDE.md: Command totals aligned; ralph-external/memory/config added to quick reference
• Skills manifest: 12 missing entries added (code-chunker, decompose-file, issue-driven-ralph, 9 regression-* skills) — 20 → 32
• Skill inventory: SDLC skills listed 12 → 32; total 53 → 75

`.aiwg/` Version Tracking

Project artifacts (`.aiwg/`) are now tracked in git with exclusion gates for npm and edge deployments:

• `.npmignore` excludes `.aiwg/` from published packages
• CI workflows include `.aiwg/` exclusion verification
• Channel manager skips `.aiwg/` during edge deployments
• Integration tests validate exclusion behavior

Install / Update

npm install -g [email protected]

# Or update existing installation
aiwg update

Full Changelog

See Changelog for complete details.