Skip to content

v4.11.0 - Domain-Based SAP Sets + Post-Install Automation

Choose a tag to compare

View all tags
@vlct0rs-github-acct vlct0rs-github-acct released this 07 Nov 00:22
· 217 commits to main since this release
v4.11.0
019e196

🏗️ DOMAIN-BASED SAP SETS + POST-INSTALL AUTOMATION: Intelligent SAP Organization + Level 1 Configuration (75-85% time savings)

Breaking Change: SAP sets architecture migrated from tier-based to domain-based (ecosystem + domain-X)

Time Savings: 75-85% reduction in SAP configuration time (15-30 min → 2-5 min per SAP with --configure)

This release delivers a production-ready domain-based SAP sets architecture with composable installation, comprehensive migration guide, and automated Level 1 configuration for 5 high-automation SAPs. The new architecture scales better, eliminates SAP overlap, and enables technology-specific extensions.

Added

🏗️ Domain-Based SAP Sets Architecture v2.0.0 (Breaking Change)

New composable architecture replaces tier-based sets:

  • ecosystem (20 SAPs) - Universal foundation for any technology stack

    • Meta: SAP-000, SAP-001, SAP-002, SAP-009, SAP-019
    • Infrastructure: SAP-003, SAP-004, SAP-005, SAP-006, SAP-007, SAP-008
    • Advanced: SAP-010, SAP-011, SAP-012, SAP-013, SAP-015, SAP-016
    • Pilot: SAP-027, SAP-028, SAP-029
    • Progressive adoption guide: minimal_quickstart (5 SAPs), production_core (10 SAPs), full_ecosystem (20 SAPs)

  • domain-mcp (1 SAP) - MCP server development

    • SAP-014 (FastMCP patterns)

  • domain-react (7 SAPs) - React/Next.js development

    • SAP-020-026 (Next.js 15, Vitest, ESLint, state, styling, performance, accessibility)

  • domain-chora-compose (2 SAPs) - Content generation

    • SAP-017, SAP-018 (chora-compose integration)

Benefits:

  • Zero overlap: Each SAP belongs to exactly one set (vs. 80% overlap in old architecture)
  • Composable: --set ecosystem --set domain-mcp = complete MCP project (21 SAPs)
  • Scalable: Easy to add domain-python-cli, domain-web-api, etc.
  • Complete coverage: ecosystem includes ALL 20 universal SAPs (vs. old "full" with only 18/29)

🤖 Multi-Set Installation Support

Enhanced install-sap.py with composable set installation:

```bash

Install multiple sets in one command

python scripts/install-sap.py --set ecosystem --set domain-mcp
python scripts/install-sap.py --set ecosystem --set domain-react

Works with all flags

python scripts/install-sap.py --set ecosystem --set domain-mcp --configure --dry-run
```

⚙️ Post-Install Automation (Level 1 Configuration)

New --configure flag automates SAP configuration to Level 1 maturity:

  • 5 High-Automation SAPs with post_install configuration:
    • SAP-006 (quality-gates): Install pre-commit/ruff/mypy, run pre-commit install (5 min, 67-75% savings)
    • SAP-010 (memory-system): Create .chora/memory/ structure, log first event (2 min, 80% savings)
    • SAP-011 (docker-operations): Verify Docker, build test image (3 min, 80% savings)
    • SAP-015 (task-tracking): Install beads CLI, run bd init, create first task (5 min, 75-83% savings)
    • SAP-016 (link-validation): Run link validation script (2 min, 60% savings)

Usage:
```bash

Configure individual SAP

python scripts/install-sap.py SAP-015 --configure

Configure entire ecosystem (5/20 SAPs automated)

python scripts/install-sap.py --set ecosystem --configure
```

📚 SAP Sets Migration Guide

New comprehensive migration documentation (docs/user-docs/SAP_SETS_MIGRATION_GUIDE.md):

  • Migration table for all 6 deprecated sets → new equivalents
  • Detailed migration instructions for each scenario
  • Progressive adoption paths (minimal/core/full)
  • FAQ section (10 common questions)

🔧 Enhanced install-sap.py (316 new lines)

  • configure_sap(): Execute post_install automation
  • run_command(): Safe shell execution with timeout
  • check_dependency(): Verify dependencies with install hints

Changed

📦 sap-catalog.json (v4.9.0 → v5.0.0)

  • sap_sets_version: 1.0.0 → 2.0.0
  • sap_sets_architecture: tier-based → domain-based
  • New post_install section for 5 SAPs

📖 README.md

  • Updated SAP adoption section with domain-based examples
  • New multi-set installation examples

Deprecated

🗑️ Old SAP Sets (Deprecated in v5.0.0)

All tier-based sets are deprecated with migration paths:

  • minimal-entry → ecosystem subset (5 SAPs)
  • recommended → ecosystem subset (10 SAPs)
  • full → ecosystem (20 SAPs, was only 18)
  • testing-focused → cherry-pick from ecosystem
  • mcp-server → ecosystem + domain-mcp
  • react-development → ecosystem + domain-react

Technical Debt Eliminated

  1. ❌ Old "full" set missing 11 SAPs → ✅ New ecosystem includes ALL 20 universal SAPs
  2. ❌ 80% overlap between sets → ✅ Zero overlap
  3. ❌ Manual 15-30 min configuration per SAP → ✅ Automated to 2-5 min (75-85% savings)
  4. ❌ Single --set argument → ✅ Multiple --set arguments for composable installation

Impact

Time Savings:

  • SAP configuration: 15-30 min → 2-5 min per automated SAP (75-85% reduction)
  • Ecosystem set adoption: 75-95 min manual config → 17 min automated (77-82% reduction)

Scalability:

  • Easy to add new domain sets (domain-python-cli, domain-web-api)
  • Zero maintenance for ecosystem when adding domain SAPs

Migration Guide: See SAP_SETS_MIGRATION_GUIDE.md

Full Changelog: https://github.com/liminalcommons/chora-base/blob/main/CHANGELOG.md

Assets 2
Loading