@mindexed/cfact 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Josito
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# CFacT 🏭
+
+An agentic software development framework that translates human ideas into highly structured, matrix-aligned codebases using a multi-agent SDLC pipeline.
+
+CFacT automates software engineering by partitioning the codebase into strict layers, assigning specialized AI subagents (with scoped permissions and tools) to each layer, and checking compliance via automated quality gates.
+
+---
+
+## 📐 The 5-Layer Orthogonal Architecture Matrix
+
+All code developed within this framework must strictly align with one of five architectural layers:
+
+| Layer | Directory | Zone Focus | Key Constraints (Non-Negotiables) |
+| :--- | :--- | :--- | :--- |
+| **1: Presentation** | `app/`, `components/` | UI/UX, forms, API actions | Max 300 lines for components, Max 100 lines for actions/controllers. |
+| **2: Application** | `src/application/` | Use cases, DTOs, orchestration | Pure orchestration. Zero direct DB or infrastructure imports. |
+| **3: Domain** | `src/domain/` | Domain logic, DDD, entities | **Purity Blocker:** Absolutely zero I/O, DB, HTTP, logging, or external imports. |
+| **4: Infrastructure** | `src/infrastructure/` | Repositories, SDK adapters, APIs | Implements Application ports. Zero hardcoded secrets (validated via Zod). |
+| **5: Database** | `supabase/` | Schemas, migrations, RLS | 100% Row-Level Security (RLS) coverage on public tables. |
+
+---
+
+## 🤖 The Software Factory Departments
+
+Development is orchestrated across five specialized agent roles, each with strict directory and tool boundaries:
+
+*   **Architect:** Owns Phase 1 (Planning & Tech Spec). Translates PRD requirements into Layer 2 Application Port interfaces.
+*   **Domain Engineer:** Owns Phase 2a (Domain Layer). Writes pure, side-effect-free business logic. *Explicitly blocked from database or network access.*
+*   **Integration Developer:** Owns Phase 2b (Infrastructure/Database). Builds repositories, adapters, and Supabase migrations.
+*   **Frontend Developer:** Owns Phase 3 (User Experience). Builds React Server Components (RSC) and coordinates client hooks.
+*   **Security/QA:** Owns Phase 4 (Verification & Release). Audits environment schemas, verifies RLS, and executes tests.
+
+---
+
+## 📂 Project Structure
+
+This repo **is** the framework — the pieces a consuming project resolves through its git-ignored `.claude/engine/` symlink live at the root here, not nested inside `.claude/`. Consumers track nothing framework-shaped: the pointer-symlinks are generated locally by `maintainer-hooks/setup-local.sh` (ADR-0047). New device? `bash maintainer-hooks/bootstrap-system.sh` installs the system (framework + the agentic-os dashboard) as siblings under one workspace root. See [`FRAMEWORK.md`](FRAMEWORK.md) for the full contract.
+
+```bash
+├── FRAMEWORK.md               # What this repo is, and how consuming projects install it
+├── CONTRIBUTING.md            # Branch-per-change flow, the eleven self-consistency gates
+├── matrix.json                # The 6-layer / 36-zone Orthogonal Architecture Matrix schema
+├── agents/                    # The five phase-owning subagent definitions
+├── commands/                  # Custom orchestrator prompts (/build-feature, /audit-matrix)
+├── rules/                     # Path-scoped constraints for Layers 1-5
+├── hooks/                     # Quality-gate scripts + PreToolUse/PostToolUse enforcement
+├── scripts/                   # Full-codebase audits (validate-zone.js, sync-env.js)
+├── skills/                    # Reusable agent tools (verify-domain, audit-rls AST parser)
+├── registry/                  # Node declarations for everything that is NOT a markdown file here
+├── maintainer-hooks/          # This repo's own git hooks for syncing consumers
+├── consumers.json             # Path-independent registry (name + repo) of projects that resolve this engine
+├── cfact-docs/                # This repo's own generated project docs (ACTIVE_PRD.md,
+│                                 # TECH_SPEC.md, PROJECT_STATUS.json, sot-templates/) — same
+│                                 # spot any consumer's own generated docs live, see FRAMEWORK.md
+├── .mcp.json                  # Model Context Protocol (MCP) server definitions
+├── .claude/
+│   ├── CLAUDE.md              # Router containing Global Hard Rules & path-scoped rule routes
+│   ├── settings.json          # Automated hooks (PreToolUse/PostSave) and verification scripts
+│   ├── state/                 # Symlink -> ../cfact-docs (compat path every
+│   │                             # command/hook still reads/writes)
+│   ├── rules/, agents/, commands/  # Symlinks back to the root folders above, so Claude Code's
+│   │                                 # `.claude/...`-only autodiscovery picks them up
+│   └── skills/                # Per-skill symlinks back to the root skills/ folder
+└── docs/
+    └── claude-factory/        # In-depth design and framework documentation
+```
+
+---
+
+## ⚡ Verification & Quality Gates
+
+The workspace includes custom verification commands to enforce architectural integrity locally and during CI/CD:
+
+*   `/audit-matrix domain` — Checks that `src/domain/` has no external dependencies or I/O.
+*   `/audit-matrix components` — Identifies UI components exceeding the 300-line SRP limit.
+*   `/audit-matrix controllers` — Audits API routes/actions exceeding the 100-line controller limit.
+*   `/audit-matrix rls` — Scans the Supabase schema to ensure 100% RLS policy coverage.
+
+---
+
+## 🖥️ CFacT Agentic OS
+
+The framework features an interactive **Agentic OS** UI control center that runs entirely on your Portable SSD and dynamically adapts to any open development workspace.
+
+### Key Visual Features:
+*   **30-Zone Grid Visualizer:** A 6x5 matrix displaying the real-time compliance status (file size, boundary violations) of each zone.
+*   **Multi-Project Selector:** Sidebar dropdown dynamically listing all `.claude` projects on the SSD for quick visual switching.
+*   **Phase & Gate Control Panel:** Visually monitor SDLC stages and toggle Phase/HITL locks.
+*   **Config Editor:** Interactive form to edit and sync `variables.local.json` environment settings.
+
+### How to Run:
+Start the local Next.js Visual OS from the framework root:
+```bash
+npm run start-os
+```
+Open **`http://localhost:3099`** in your browser to access the control panel.
+
+---
+
+## 🤝 Contributing
+
+CFacT is consumed from a local clone (a git-ignored `.claude/engine`
+symlink), so a change here reaches every **symlinked** consumer the moment the
+clone is pulled — a **vendored** consumer follows when a maintainer blesses the
+team pin (`rules/engine-promotion.md`). Read [`CONTRIBUTING.md`](CONTRIBUTING.md)
+before opening a PR — it covers the resolution modes, the `fw/<short-desc>`
+branch-per-change flow, and the eleven self-consistency gates that keep
+`matrix.json` and its prose docs from drifting.
+Licensed under [MIT](LICENSE).
+