@mindflight/mindbrain-personal-studio 0.6.1 → 0.6.3

package/examples/immeuble/index.md

@@ -0,0 +1,140 @@
+# Immeuble — parcours pas à pas
+
+Analytical walkthrough from raw documents to importable workspace. Each step lists **filesystem artifacts**, **DB tables**, and **verification**.
+
+Cross-reference: [méthode StarterKit](../../docs/explanation/methode-starterkit/README.md) · [CHECKLIST exécutable](CHECKLIST.md) · [ACCEPTANCE.yaml](ACCEPTANCE.yaml)
+
+## Étape 0 — Runtime
+
+| Filesystem | DB | Vérification |
+|------------|-----|--------------|
+| — | — | `ghostcrab_status` → backend OK, workspace routable |
+
+## Étape 1 — Modèle métier
+
+**Input:** [`sources/documents/`](sources/documents/) (corpus markdown syndic)
+
+**Commande:**
+
+```bash
+npm run immeuble:build
+```
+
+| Filesystem | DB | Vérification |
+|------------|-----|--------------|
+| `model/immeuble_model.json` | — | 19+ entity types, `schema_id` prefix `immeuble:` |
+| `reports/01-model.validation.json` | — | `ok: true`, zero prefix violations |
+| `fake_data/*.csv` | — | one CSV per entity type |
+
+## Étape 2 — Ontologie LinkML
+
+**Source:** [`ontologies/immeuble/core.yaml`](../../ontologies/immeuble/core.yaml)
+
+```bash
+node bin/gcp.mjs brain ontology compile \
+  --workspace-id immeuble \
+  --ontology-id immeuble::core \
+  --input ontologies/immeuble/core.yaml \
+  --apply
+```
+
+| Filesystem | DB | Vérification |
+|------------|-----|--------------|
+| compile slice JSON (temp) | `ontologies`, `ontology_*` | `ghostcrab_coverage` |
+
+## Étape 3 — Mapping + dry-run (gates 2–4)
+
+| Filesystem | DB | Vérification |
+|------------|-----|--------------|
+| `contracts/mapping_external_to_canonical.json` | **aucune écriture** | taxonomies dans mapping |
+| `reports/02-mapping.validation.json` | — | facet/edge row counts |
+| `reports/graph_nodes.jsonl`, `graph_edges.jsonl` | — | parseable JSONL |
+| `reports/pipeline_audit.json` | — | all gates `ok` |
+
+```bash
+node examples/immeuble/scripts/run-immeuble-import.mjs \
+  --skip-preflight --skip-provenance-validation
+```
+
+## Étape 4 — Apply import (gates 5–6)
+
+```bash
+npm run immeuble:import
+```
+
+| Filesystem | DB | Vérification |
+|------------|-----|--------------|
+| `import_ready/mfo_facets_import.csv` | `agent_facts` | `schema_id` starts with `immeuble:` |
+| `import_ready/graph_edges_import.csv` | `entities_raw`, `relations_raw` | counts > 0 |
+| `reports/schema-id-prefix-check.json` | — | `ok: true` |
+| `reports/immeuble-import-scenario.json` | — | full scenario evidence |
+
+Expected counts (narrative Tilleuls/Érables): see [`success-criteria.yaml`](success-criteria.yaml).
+
+## Étape 5 — Reindex
+
+| Filesystem | DB | Vérification |
+|------------|-----|--------------|
+| `reports/reindex.json` | `graph_entity`, `graph_relation`, facet postings | `graph_projected > 0` |
+| — | BM25 / facet indexes | `ghostcrab_graph_search` query `appartement` ≥ 13 |
+
+## Étape 6 — Projections
+
+| Filesystem | DB | Vérification |
+|------------|-----|--------------|
+| `contracts/projection_catalog.yaml` | — | 1 analysis_plan + 3 live_answer_view |
+| `contracts/answer_artifacts.seed.jsonl` | `mindbrain_answer_artifacts` (after load) | artifact ids listed |
+| `contracts/business_capabilities.seed.jsonl` | `agent_facts` (`ghostcrab:business-capability`) | router live routes (see below) |
+| `reports/projection_audit_immeuble.json` | — | registry matches catalog + coverage facets/edges/schemas |
+
+```bash
+node examples/immeuble/scripts/starterkit/analyze-projection-candidates.mjs --db "$GHOSTCRAB_SQLITE_PATH" --workspace immeuble --projection-catalog contracts/projection_catalog.yaml --model-contract contracts/model_contract.json --output-dir reports --include-blind-spots --include-jtbd
+node examples/immeuble/scripts/starterkit/audit-ghostcrab-projections.mjs --db "$GHOSTCRAB_SQLITE_PATH" --workspace immeuble --model contracts/model_contract.json --answer-artifacts-seed contracts/answer_artifacts.seed.jsonl --output-dir reports
+gcp brain artifact list --workspace-id immeuble --kind live_answer_view
+gcp brain artifact refresh live_answer_view__annuaire_coproprietes
+```
+
+### Business query router (Option A)
+
+Load registered capabilities so `ghostcrab_business_query_answer` can route immeuble questions in SQLite-only mode (without relying on `mindbrain_answer_artifacts`):
+
+```bash
+node bin/gcp.mjs load examples/immeuble/contracts/business_capabilities.seed.jsonl --workspace immeuble
+# or via reset / live lab:
+node examples/immeuble/scripts/reset-immeuble-workspace.mjs --with-business-capabilities
+examples/immeuble/scripts/run-immeuble-live-lab.sh --with-business-capabilities
+pnpm test:integration -- tests/integration/immeuble-business-query.test.ts
+```
+
+Convention: each record requires `workspace_id`, `availability` (`live_answer_view`), and `activation_status` (`active`) in `facets`. Verification: `tests/integration/immeuble-business-query.test.ts`.
+
+For a future `live_query` path (Option B — core router + model facets), see [plan détaillé](../../docs/plan/2026-06-14-plan-adaptation-demo-immeuble-business-query.md#4-plan-dimplémentation--option-b-suivi-pour-atteindre-live_query).
+
+## Étape 7 — Bundle final
+
+```bash
+export GHOSTCRAB_SQLITE_PATH="$PWD/data/immeuble.sqlite"
+node bin/gcp.mjs load examples/immeuble/bundle/immeuble.bundle.json \
+  --workspace immeuble --reindex all
+```
+
+| Filesystem | DB | Vérification |
+|------------|-----|--------------|
+| `bundle/immeuble.bundle.json` | full workspace reload | same entity counts as step 4 |
+| `reports/consumer_contract.validation.json` | — | consumer workspace = `immeuble` |
+
+## Hybrid engine compare (CI)
+
+```bash
+node examples/immeuble/scripts/run-immeuble-import.mjs \
+  --apply --engine both --skip-preflight --skip-provenance-validation \
+  --compare-output examples/immeuble/reports/hybrid-compare.json
+```
+
+Expect `compare.deltas` = 0 on facet/edge counters.
+
+## Agent path (optional)
+
+Prompts for MCP-driven reconstruction: [`sources/agent-prompts/prompts/`](sources/agent-prompts/prompts/)
+
+Same success thresholds: [`success-criteria.yaml`](success-criteria.yaml)

package/examples/immeuble/model/immeuble_model.json

@@ -0,0 +1,418 @@
+{
+  "workspace_id": "immeuble",
+  "ontology_id": "immeuble::core",
+  "label": "Immeuble syndic reference model",
+  "version": "2026-06-14",
+  "closed_edge_labels": [
+    "CONTAINS",
+    "OWNS",
+    "OCCUPIES",
+    "HOUSEHOLD_MEMBER",
+    "PRIMARY_RESIDENCE_OF",
+    "LEASES",
+    "RENTED_TO",
+    "ASSIGNED_CELLAR",
+    "ASSIGNED_GARAGE",
+    "USES_EXCLUSIVE",
+    "USES_COMMON",
+    "MATCHED_TO",
+    "ALLOCATED_TO",
+    "REQUIRES_REVIEW",
+    "DOCUMENTS",
+    "MEMBER_OF",
+    "HAS_MEMBER",
+    "BILLS_TO",
+    "LINKED_TO",
+    "MANAGES",
+    "REPRESENTS",
+    "RECORDS",
+    "TRIGGERED",
+    "DECIDED_BY",
+    "MANAGES_PROJECT",
+    "DESIGNS_FOR",
+    "HAS_WORK_PACKAGE",
+    "EXECUTES_WORK_PACKAGE",
+    "HAS_MILESTONE",
+    "AUTHORIZED_BY",
+    "BASED_ON_QUOTE",
+    "HAS_BUDGET_LINE",
+    "INVOICED_BY",
+    "AFFECTS_ASSET",
+    "REPORTED_BY",
+    "HAS_RESERVE",
+    "EVIDENCED_BY",
+    "COVERS_ASSET",
+    "PROVIDED_BY",
+    "CONCERNS_ASSET",
+    "HAS_INTERVENTION",
+    "COVERED_BY",
+    "CERTIFIES_ASSET",
+    "MEASURES_ASSET",
+    "RECORDS_READING",
+    "HAS_AGENDA_ITEM",
+    "FLAGS_ENTITY"
+  ],
+  "entity_types": [
+    {
+      "name": "DeltaFinding",
+      "label": "DeltaFinding",
+      "schema_id": "immeuble:core:DeltaFinding",
+      "ontology": "core",
+      "node_type": "DeltaFinding",
+      "record_id_pattern": "DeltaFinding:<stable-key>"
+    },
+    {
+      "name": "ProjectionResult",
+      "label": "ProjectionResult",
+      "schema_id": "immeuble:core:ProjectionResult",
+      "ontology": "core",
+      "node_type": "ProjectionResult",
+      "record_id_pattern": "ProjectionResult:<stable-key>"
+    },
+    {
+      "name": "ag_meeting",
+      "label": "ag_meeting",
+      "schema_id": "immeuble:core:ag_meeting",
+      "ontology": "core",
+      "node_type": "ag_meeting",
+      "record_id_pattern": "ag_meeting:<stable-key>"
+    },
+    {
+      "name": "agenda_item",
+      "label": "agenda_item",
+      "schema_id": "immeuble:core:agenda_item",
+      "ontology": "core",
+      "node_type": "agenda_item",
+      "record_id_pattern": "agenda_item:<stable-key>"
+    },
+    {
+      "name": "architect",
+      "label": "architect",
+      "schema_id": "immeuble:core:architect",
+      "ontology": "core",
+      "node_type": "architect",
+      "record_id_pattern": "architect:<stable-key>"
+    },
+    {
+      "name": "architecture_firm",
+      "label": "architecture_firm",
+      "schema_id": "immeuble:core:architecture_firm",
+      "ontology": "core",
+      "node_type": "architecture_firm",
+      "record_id_pattern": "architecture_firm:<stable-key>"
+    },
+    {
+      "name": "bank_account",
+      "label": "bank_account",
+      "schema_id": "immeuble:core:bank_account",
+      "ontology": "core",
+      "node_type": "bank_account",
+      "record_id_pattern": "bank_account:<stable-key>"
+    },
+    {
+      "name": "billing_group",
+      "label": "billing_group",
+      "schema_id": "immeuble:core:billing_group",
+      "ontology": "core",
+      "node_type": "billing_group",
+      "record_id_pattern": "billing_group:<stable-key>"
+    },
+    {
+      "name": "block",
+      "label": "block",
+      "schema_id": "immeuble:core:block",
+      "ontology": "core",
+      "node_type": "block",
+      "record_id_pattern": "block:<stable-key>"
+    },
+    {
+      "name": "budget_line",
+      "label": "budget_line",
+      "schema_id": "immeuble:core:budget_line",
+      "ontology": "core",
+      "node_type": "budget_line",
+      "record_id_pattern": "budget_line:<stable-key>"
+    },
+    {
+      "name": "building",
+      "label": "building",
+      "schema_id": "immeuble:core:building",
+      "ontology": "core",
+      "node_type": "building",
+      "record_id_pattern": "building:<stable-key>"
+    },
+    {
+      "name": "cellar",
+      "label": "cellar",
+      "schema_id": "immeuble:core:cellar",
+      "ontology": "core",
+      "node_type": "cellar",
+      "record_id_pattern": "cellar:<stable-key>"
+    },
+    {
+      "name": "change_order",
+      "label": "change_order",
+      "schema_id": "immeuble:core:change_order",
+      "ontology": "core",
+      "node_type": "change_order",
+      "record_id_pattern": "change_order:<stable-key>"
+    },
+    {
+      "name": "charge_call",
+      "label": "charge_call",
+      "schema_id": "immeuble:core:charge_call",
+      "ontology": "core",
+      "node_type": "charge_call",
+      "record_id_pattern": "charge_call:<stable-key>"
+    },
+    {
+      "name": "claim",
+      "label": "claim",
+      "schema_id": "immeuble:core:claim",
+      "ontology": "core",
+      "node_type": "claim",
+      "record_id_pattern": "claim:<stable-key>"
+    },
+    {
+      "name": "coda_entry",
+      "label": "coda_entry",
+      "schema_id": "immeuble:core:coda_entry",
+      "ontology": "core",
+      "node_type": "coda_entry",
+      "record_id_pattern": "coda_entry:<stable-key>"
+    },
+    {
+      "name": "compliance_certificate",
+      "label": "compliance_certificate",
+      "schema_id": "immeuble:core:compliance_certificate",
+      "ontology": "core",
+      "node_type": "compliance_certificate",
+      "record_id_pattern": "compliance_certificate:<stable-key>"
+    },
+    {
+      "name": "contractor",
+      "label": "contractor",
+      "schema_id": "immeuble:core:contractor",
+      "ontology": "core",
+      "node_type": "contractor",
+      "record_id_pattern": "contractor:<stable-key>"
+    },
+    {
+      "name": "decision",
+      "label": "decision",
+      "schema_id": "immeuble:core:decision",
+      "ontology": "core",
+      "node_type": "decision",
+      "record_id_pattern": "decision:<stable-key>"
+    },
+    {
+      "name": "defect_reserve",
+      "label": "defect_reserve",
+      "schema_id": "immeuble:core:defect_reserve",
+      "ontology": "core",
+      "node_type": "defect_reserve",
+      "record_id_pattern": "defect_reserve:<stable-key>"
+    },
+    {
+      "name": "household",
+      "label": "household",
+      "schema_id": "immeuble:core:household",
+      "ontology": "core",
+      "node_type": "household",
+      "record_id_pattern": "household:<stable-key>"
+    },
+    {
+      "name": "inspection",
+      "label": "inspection",
+      "schema_id": "immeuble:core:inspection",
+      "ontology": "core",
+      "node_type": "inspection",
+      "record_id_pattern": "inspection:<stable-key>"
+    },
+    {
+      "name": "insurance_policy",
+      "label": "insurance_policy",
+      "schema_id": "immeuble:core:insurance_policy",
+      "ontology": "core",
+      "node_type": "insurance_policy",
+      "record_id_pattern": "insurance_policy:<stable-key>"
+    },
+    {
+      "name": "intervention",
+      "label": "intervention",
+      "schema_id": "immeuble:core:intervention",
+      "ontology": "core",
+      "node_type": "intervention",
+      "record_id_pattern": "intervention:<stable-key>"
+    },
+    {
+      "name": "invoice",
+      "label": "invoice",
+      "schema_id": "immeuble:core:invoice",
+      "ontology": "core",
+      "node_type": "invoice",
+      "record_id_pattern": "invoice:<stable-key>"
+    },
+    {
+      "name": "lease_contract",
+      "label": "lease_contract",
+      "schema_id": "immeuble:core:lease_contract",
+      "ontology": "core",
+      "node_type": "lease_contract",
+      "record_id_pattern": "lease_contract:<stable-key>"
+    },
+    {
+      "name": "maintenance_ticket",
+      "label": "maintenance_ticket",
+      "schema_id": "immeuble:core:maintenance_ticket",
+      "ontology": "core",
+      "node_type": "maintenance_ticket",
+      "record_id_pattern": "maintenance_ticket:<stable-key>"
+    },
+    {
+      "name": "meter",
+      "label": "meter",
+      "schema_id": "immeuble:core:meter",
+      "ontology": "core",
+      "node_type": "meter",
+      "record_id_pattern": "meter:<stable-key>"
+    },
+    {
+      "name": "meter_reading",
+      "label": "meter_reading",
+      "schema_id": "immeuble:core:meter_reading",
+      "ontology": "core",
+      "node_type": "meter_reading",
+      "record_id_pattern": "meter_reading:<stable-key>"
+    },
+    {
+      "name": "milestone",
+      "label": "milestone",
+      "schema_id": "immeuble:core:milestone",
+      "ontology": "core",
+      "node_type": "milestone",
+      "record_id_pattern": "milestone:<stable-key>"
+    },
+    {
+      "name": "organization",
+      "label": "organization",
+      "schema_id": "immeuble:core:organization",
+      "ontology": "core",
+      "node_type": "organization",
+      "record_id_pattern": "organization:<stable-key>"
+    },
+    {
+      "name": "parking_space",
+      "label": "parking_space",
+      "schema_id": "immeuble:core:parking_space",
+      "ontology": "core",
+      "node_type": "parking_space",
+      "record_id_pattern": "parking_space:<stable-key>"
+    },
+    {
+      "name": "permit",
+      "label": "permit",
+      "schema_id": "immeuble:core:permit",
+      "ontology": "core",
+      "node_type": "permit",
+      "record_id_pattern": "permit:<stable-key>"
+    },
+    {
+      "name": "person",
+      "label": "person",
+      "schema_id": "immeuble:core:person",
+      "ontology": "core",
+      "node_type": "person",
+      "record_id_pattern": "person:<stable-key>"
+    },
+    {
+      "name": "private_garden",
+      "label": "private_garden",
+      "schema_id": "immeuble:core:private_garden",
+      "ontology": "core",
+      "node_type": "private_garden",
+      "record_id_pattern": "private_garden:<stable-key>"
+    },
+    {
+      "name": "progress_event",
+      "label": "progress_event",
+      "schema_id": "immeuble:core:progress_event",
+      "ontology": "core",
+      "node_type": "progress_event",
+      "record_id_pattern": "progress_event:<stable-key>"
+    },
+    {
+      "name": "quote",
+      "label": "quote",
+      "schema_id": "immeuble:core:quote",
+      "ontology": "core",
+      "node_type": "quote",
+      "record_id_pattern": "quote:<stable-key>"
+    },
+    {
+      "name": "receipt",
+      "label": "receipt",
+      "schema_id": "immeuble:core:receipt",
+      "ontology": "core",
+      "node_type": "receipt",
+      "record_id_pattern": "receipt:<stable-key>"
+    },
+    {
+      "name": "reminder",
+      "label": "reminder",
+      "schema_id": "immeuble:core:reminder",
+      "ontology": "core",
+      "node_type": "reminder",
+      "record_id_pattern": "reminder:<stable-key>"
+    },
+    {
+      "name": "service_contract",
+      "label": "service_contract",
+      "schema_id": "immeuble:core:service_contract",
+      "ontology": "core",
+      "node_type": "service_contract",
+      "record_id_pattern": "service_contract:<stable-key>"
+    },
+    {
+      "name": "shared_equipment",
+      "label": "shared_equipment",
+      "schema_id": "immeuble:core:shared_equipment",
+      "ontology": "core",
+      "node_type": "shared_equipment",
+      "record_id_pattern": "shared_equipment:<stable-key>"
+    },
+    {
+      "name": "shared_space",
+      "label": "shared_space",
+      "schema_id": "immeuble:core:shared_space",
+      "ontology": "core",
+      "node_type": "shared_space",
+      "record_id_pattern": "shared_space:<stable-key>"
+    },
+    {
+      "name": "unit",
+      "label": "unit",
+      "schema_id": "immeuble:core:unit",
+      "ontology": "core",
+      "node_type": "unit",
+      "record_id_pattern": "unit:<stable-key>"
+    },
+    {
+      "name": "work_package",
+      "label": "work_package",
+      "schema_id": "immeuble:core:work_package",
+      "ontology": "core",
+      "node_type": "work_package",
+      "record_id_pattern": "work_package:<stable-key>"
+    },
+    {
+      "name": "worksite_project",
+      "label": "worksite_project",
+      "schema_id": "immeuble:core:worksite_project",
+      "ontology": "core",
+      "node_type": "worksite_project",
+      "record_id_pattern": "worksite_project:<stable-key>"
+    }
+  ],
+  "contract_relations": []
+}

package/examples/immeuble/reports/01-model.validation.json

@@ -0,0 +1,56 @@
+{
+  "ok": true,
+  "workspace_id": "immeuble",
+  "ontology_id": "immeuble::core",
+  "entity_type_count": 45,
+  "entity_types": [
+    "DeltaFinding",
+    "ProjectionResult",
+    "ag_meeting",
+    "agenda_item",
+    "architect",
+    "architecture_firm",
+    "bank_account",
+    "billing_group",
+    "block",
+    "budget_line",
+    "building",
+    "cellar",
+    "change_order",
+    "charge_call",
+    "claim",
+    "coda_entry",
+    "compliance_certificate",
+    "contractor",
+    "decision",
+    "defect_reserve",
+    "household",
+    "inspection",
+    "insurance_policy",
+    "intervention",
+    "invoice",
+    "lease_contract",
+    "maintenance_ticket",
+    "meter",
+    "meter_reading",
+    "milestone",
+    "organization",
+    "parking_space",
+    "permit",
+    "person",
+    "private_garden",
+    "progress_event",
+    "quote",
+    "receipt",
+    "reminder",
+    "service_contract",
+    "shared_equipment",
+    "shared_space",
+    "unit",
+    "work_package",
+    "worksite_project"
+  ],
+  "schema_id_prefix": "immeuble:",
+  "prefix_violations": 0,
+  "generated_at": "2026-07-02T17:47:41.155Z"
+}

package/examples/immeuble/reports/02-mapping.validation.json

@@ -0,0 +1,9 @@
+{
+  "ok": true,
+  "workspace_id": "immeuble",
+  "mapped_entity_types": 45,
+  "facet_rows": 558,
+  "edge_rows": 847,
+  "all_schema_ids_prefixed": true,
+  "generated_at": "2026-07-02T17:47:41.155Z"
+}