stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity

wip: doctor/cli/docs/api to vector db consolidation; api hardening for descriptions, tenant, and scopes; migrations and conversions of all DALs to EF v10

Browse Source
This commit is contained in:
master
2026-02-23 15:30:50 +02:00
parent bd8fee6ed8
commit e746577380
1424 changed files with 81225 additions and 25251 deletions
Download Patch File Download Diff File Expand all files Collapse all files

35
docs/API_CLI_REFERENCE.md
View File

@@ -109,6 +109,10 @@ stella system migrations-run --module all --category release --force
- CLI module coverage is currently defined in `src/Platform/__Libraries/StellaOps.Platform.Database/MigrationModuleRegistry.cs`.
- CLI module coverage is auto-discovered from one migration plug-in per web service (`IMigrationModulePlugin`).
- A service plug-in may flatten multiple migration sources into one service module descriptor (for example Scanner storage + triage sources).
- On empty migration history, CLI/API execution paths run one synthesized per-service consolidated migration (`100_consolidated_<service>.sql`) and then backfill legacy per-file history rows for compatibility with future incremental updates.
- If consolidated history exists but legacy backfill is partial, CLI/API paths automatically backfill missing legacy rows before source-set execution.
- This is a one-per-service bootstrap execution mode, not a permanent single-row migration history model.
- Registry ownership is platform-level so the same module catalog is reused by CLI and Platform migration admin APIs.
- Current registry coverage includes: `AirGap`, `Authority`, `Concelier`, `Excititor`, `Notify`, `Platform`, `Policy`, `Scanner`, `Scheduler`, `TimelineIndexer`.
- Not all migration folders in the repository are currently wired to runtime execution.
@@ -539,3 +543,34 @@ stella advisoryai index rebuild [--json] [--verbose]
stella advisoryai index rebuild
stella advisoryai index rebuild --json
```
## stella advisoryai sources prepare
Generate deterministic AdvisoryAI Knowledge Search (AKS) source artifacts used by index rebuild.
Doctor controls output is enriched from configured seed plus locally discovered Doctor checks (when Doctor engine services are available), providing fallback metadata for AdvisoryAI ingestion.
### Synopsis
```bash
stella advisoryai sources prepare [options]
```
### Options
| Option | Description |
| --- | --- |
| `--repo-root` | Repository root used to resolve source paths. |
| `--docs-allowlist` | JSON allow-list for markdown source folders/files. |
| `--docs-manifest-output` | Output path for resolved docs manifest JSON (with hashes). |
| `--openapi-output` | Output path for aggregated OpenAPI JSON artifact. |
| `--doctor-seed` | Input doctor seed JSON path. |
| `--doctor-controls-output` | Output path for doctor controls projection JSON (controls + fallback metadata). |
| `--overwrite` | Overwrite existing output files. |
| `--json` | Emit stable machine-readable summary. |
### Examples
```bash
stella advisoryai sources prepare --json
stella advisoryai sources prepare --repo-root . --openapi-output devops/compose/openapi_current.json --overwrite
```